{"_id":"@afilimax/aliexpress-provider","name":"@afilimax/aliexpress-provider","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@afilimax/aliexpress-provider","version":"0.1.0","type":"commonjs","repository":{"type":"git","url":"git+https://github.com/Afilimax/aliexpress-provider.git"},"homepage":"https://github.com/Afilimax/aliexpress-provider#readme","bugs":{"url":"https://github.com/Afilimax/aliexpress-provider/issues"},"main":"./dist/index.js","module":"./dist/index.js","types":"./dist/index.d.ts","scripts":{"build":"tsc","dev":"ts-node ./src/index.ts","format":"prettier --write \"src/**/*.ts\"","lint":"eslint \"src/**/*.ts\" --fix","test":"vitest","test:cov":"vitest run --coverage"},"publishConfig":{"access":"public"},"keywords":["marcuth"],"author":{"name":"Marcuth"},"license":"MIT","devDependencies":{"@types/node":"^25.5.0","@vitest/coverage-v8":"^4.1.0","eslint":"^10.0.3","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.5","eslint-plugin-unused-imports":"^4.4.1","prettier":"^3.8.1","prettier-plugin-sort-imports":"^1.8.11","ts-node":"^10.9.2","typescript":"^5.9.3","vitest":"^4.1.0"},"peerDependencies":{"@afilimax/core":"^0.4.1"},"gitHead":"da23044babdba25055fd3e1a0334580de7ff488c","_id":"@afilimax/aliexpress-provider@0.1.0","description":"Provedor de links de afiliados para o AliExpress, integrado ao ecossistema Afilimax. Este pacote permite converter URLs de produtos do AliExpress em links de afiliados utilizando a API oficial Open Platform do AliExpress.","_nodeVersion":"24.13.0","_npmVersion":"11.8.0","dist":{"integrity":"sha512-euUXKWmokja2H3UbMXZZjXoludIzTKok31Q2YeaJtu6CRf2WbYnqQf/lQgFzDNDE5wO3Uf2sG2PZSCEPe1kHNg==","shasum":"aa41b99a99b16a65550e7b02a9a093dd05aa51a8","tarball":"https://registry.npmjs.org/@afilimax/aliexpress-provider/-/aliexpress-provider-0.1.0.tgz","fileCount":5,"unpackedSize":8775,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDImzciQ4uO0ybd/yVYiTzfyKzK8PUS6V3tM7Inv7kWwgIhAMCnQcoASObLwtRquPPnVTzHcgB1nZCXdZliMgP5Q/+A"}]},"_npmUser":{"name":"marcuth","email":"marcuth2006@gmail.com"},"directories":{},"maintainers":[{"name":"marcuth","email":"marcuth2006@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/aliexpress-provider_0.1.0_1773556493357_0.26619835123594604"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-15T06:34:53.241Z","0.1.0":"2026-03-15T06:34:53.511Z","modified":"2026-03-15T06:34:53.786Z"},"maintainers":[{"name":"marcuth","email":"marcuth2006@gmail.com"}],"description":"Provedor de links de afiliados para o AliExpress, integrado ao ecossistema Afilimax. Este pacote permite converter URLs de produtos do AliExpress em links de afiliados utilizando a API oficial Open Platform do AliExpress.","homepage":"https://github.com/Afilimax/aliexpress-provider#readme","keywords":["marcuth"],"repository":{"type":"git","url":"git+https://github.com/Afilimax/aliexpress-provider.git"},"author":{"name":"Marcuth"},"bugs":{"url":"https://github.com/Afilimax/aliexpress-provider/issues"},"license":"MIT","readme":"# @afilimax/aliexpress-provider\n\nProvedor de links de afiliados para o AliExpress, integrado ao ecossistema Afilimax. Este pacote permite converter URLs de produtos do AliExpress em links de afiliados utilizando a API oficial Open Platform do AliExpress.\n\n## Instalação\n\n```bash\nnpm install @afilimax/aliexpress-provider\n```\n\n> [!IMPORTANT]\n> Este pacote requer `@afilimax/core` como dependência de par (peer dependency).\n\n## Como usar\n\nO `AliExpressProvider` utiliza autenticação baseada em `appKey`, `appSecret` e `trackingId` fornecidos pelo portal de desenvolvedores do AliExpress.\n\n```typescript\nimport { AliExpressProvider } from \"@afilimax/aliexpress-provider\";\n\nconst provider = new AliExpressProvider({\n    appKey: \"seu_app_key\",\n    appSecret: \"seu_app_secret\",\n    trackingId: \"seu_tracking_id\"\n});\n\nasync function run() {\n    const originalUrl = \"https://pt.aliexpress.com/item/1005003430339815.html\";\n    \n    try {\n        const affiliateUrl = await provider.createAffiliateUrl(originalUrl);\n        console.log(\"Link de Afiliado:\", affiliateUrl); // Retorna o link s.click.aliexpress.com\n    } catch (error) {\n        console.error(\"Erro ao gerar link:\", error.message);\n    }\n}\n\nrun();\n```\n\n## Configurações\n\nA interface `AliExpressProviderOptions` aceita as seguintes propriedades:\n\n| Propriedade | Tipo | Descrição |\n| :--- | :--- | :--- |\n| `appKey` | `string` | Sua App Key obtida no portal AliExpress Open Platform. |\n| `appSecret` | `string` | Sua App Secret correspondente para assinatura de requisições (HMAC-SHA256). |\n| `trackingId` | `string` | Seu Tracking ID para rastreamento de vendas no portal de afiliados. |\n\n## Domínios Suportados\n\nO provedor identifica automaticamente URLs dos seguintes domínios:\n- `aliexpress.com` (e subdomínios como `pt.aliexpress.com`)\n\n## Desenvolvimento\n\n### Scripts Disponíveis\n\n- `npm run build`: Compila o projeto para o diretório `dist`.\n- `npm run test`: Executa os testes unitários e o teste prático (integração) com Vitest.\n- `npm run lint`: Verifica e corrige problemas de estilo de código.\n- `npm run format`: Formata o código fonte usando Prettier.\n\n### Testes Práticos\n\nPara rodar o teste prático de integração, crie um arquivo `__tests__/auth.json` com suas credenciais reais:\n\n```json\n{\n    \"appKey\": \"SUA_KEY\",\n    \"appSecret\": \"SEU_SECRET\",\n    \"trackingId\": \"SEU_TRACKING_ID\"\n}\n```\n\n---\n\nProduzido com ❤️ pela equipe **Afilimax**.","readmeFilename":"README.md","_rev":"1-261b05a6c6e319297d97e77d9c5ada40"}