@afilimax/core 0.3.0 → 0.4.0

package/README.md

@@ -86,6 +86,62 @@ const product = scrapedProductSchema.parse({
 })
 ```
 
+### Provedores de Afiliados
+
+O `AffiliateProvider` é uma classe abstrata fundamental para estender as capacidades de afiliação do ecossistema Afilimax.
+
+```typescript
+import { AffiliateProvider } from "@afilimax/core"
+
+interface CustomOptions {
+    trackingId: string
+}
+
+class MyProvider extends AffiliateProvider<CustomOptions> {
+    name = "Meu Provedor"
+    domains = ["loja-exemplo.com.br"]
+
+    // Implementação obrigatória para gerar o link
+    createAffiliateUrl = async (url: string) => {
+        return `https://link-afiliado.com?id=${this.options.trackingId}&url=${url}`
+    }
+}
+
+const provider = new MyProvider({ trackingId: "user-123" })
+
+// Verifica se uma URL pertence ao provedor
+if (provider.supportsUrl("https://loja-exemplo.com.br/item")) {
+    const affiliateUrl = await provider.createAffiliateUrl("https://loja-exemplo.com.br/item")
+    console.log(affiliateUrl)
+}
+```
+
+### Gerenciamento de Provedores (Encadeamento)
+
+O `AffiliateManager` permite agrupar múltiplos provedores e encontrar automaticamente o correto para uma determinada URL.
+
+```typescript
+import { AffiliateManager } from "@afilimax/core"
+
+const manager = new AffiliateManager([
+    new AmazonProvider(options),
+    new ShopeeProvider(options),
+    new MagaluProvider(options)
+])
+
+// O manager encontrará o provedor correto baseado nos domínios suportados.
+// Caso nenhum provedor suporte a URL, retornará null.
+const url = "https://www.amazon.com.br/dp/B088GHHR6K"
+const affiliateUrl = await manager.createAffiliateUrl(url)
+
+if (affiliateUrl) {
+    console.log("URL de afiliado:", affiliateUrl)
+}
+
+// Você também pode adicionar novos provedores dinamicamente
+manager.use(new CustomProvider())
+```
+
 ## Licença
 
 Este projeto está sob a licença MIT.

package/dist/affiliate-manager.d.ts

@@ -0,0 +1,18 @@
+import { AffiliateProvider } from "./interfaces/affiliate-provider.interface";
+export declare class AffiliateManager {
+    private readonly providers;
+    constructor(providers: AffiliateProvider<any>[]);
+    /**
+     * Encontra o primeiro provedor que suporta a URL fornecida.
+     */
+    findProvider(url: string): AffiliateProvider<any> | undefined;
+    /**
+     * Cria uma URL de afiliado usando o primeiro provedor compatível encontrado.
+     * Caso nenhum provedor seja encontrado, retorna null.
+     */
+    createAffiliateUrl(url: string): Promise<string | null>;
+    /**
+     * Adiciona um provedor ao início da cadeia.
+     */
+    use(provider: AffiliateProvider<any>): this;
+}

package/dist/affiliate-manager.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AffiliateManager = void 0;
+class AffiliateManager {
+    constructor(providers) {
+        this.providers = providers;
+    }
+    /**
+     * Encontra o primeiro provedor que suporta a URL fornecida.
+     */
+    findProvider(url) {
+        return this.providers.find(provider => provider.supportsUrl(url));
+    }
+    /**
+     * Cria uma URL de afiliado usando o primeiro provedor compatível encontrado.
+     * Caso nenhum provedor seja encontrado, retorna null.
+     */
+    async createAffiliateUrl(url) {
+        const provider = this.findProvider(url);
+        if (!provider) {
+            return null;
+        }
+        return provider.createAffiliateUrl(url);
+    }
+    /**
+     * Adiciona um provedor ao início da cadeia.
+     */
+    use(provider) {
+        this.providers.unshift(provider);
+        return this;
+    }
+}
+exports.AffiliateManager = AffiliateManager;

package/dist/index.d.ts

@@ -2,3 +2,4 @@ export * from "./interfaces";
 export * from "./schemas";
 export * from "./enums";
 export * from "./utils";
+export * from "./affiliate-manager";

package/dist/index.js

@@ -18,3 +18,4 @@ __exportStar(require("./interfaces"), exports);
 __exportStar(require("./schemas"), exports);
 __exportStar(require("./enums"), exports);
 __exportStar(require("./utils"), exports);
+__exportStar(require("./affiliate-manager"), exports);

package/dist/interfaces/affiliate-provider.interface.d.ts

@@ -0,0 +1,8 @@
+export declare abstract class AffiliateProvider<TOptions> {
+    protected readonly options: TOptions;
+    abstract domains: string[];
+    constructor(options: TOptions);
+    abstract name: string;
+    supportsUrl(url: string): boolean;
+    abstract createAffiliateUrl: (url: string) => Promise<string>;
+}

package/dist/interfaces/affiliate-provider.interface.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AffiliateProvider = void 0;
+class AffiliateProvider {
+    constructor(options) {
+        this.options = options;
+    }
+    supportsUrl(url) {
+        const hostname = new URL(url).hostname;
+        return this.domains.some(domain => hostname === domain || hostname.endsWith(`.${domain}`));
+    }
+}
+exports.AffiliateProvider = AffiliateProvider;

package/dist/interfaces/index.d.ts

@@ -2,3 +2,4 @@ export * from "./price.interface";
 export * from "./product.interface";
 export * from "./shipping.interface";
 export * from "./coupon.interface";
+export * from "./affiliate-provider.interface";

package/dist/interfaces/index.js

@@ -18,3 +18,4 @@ __exportStar(require("./price.interface"), exports);
 __exportStar(require("./product.interface"), exports);
 __exportStar(require("./shipping.interface"), exports);
 __exportStar(require("./coupon.interface"), exports);
+__exportStar(require("./affiliate-provider.interface"), exports);

package/package.json

@@ -1,40 +1,40 @@
-{
-  "name": "@afilimax/core",
-  "version": "0.3.0",
-  "type": "commonjs",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "files": [
-    "dist/*",
-    "!/**/__tests__"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "dev": "ts-node ./src/index.ts",
-    "format": "prettier --write \"src/**/*.ts\""
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "keywords": [
-    "afilimax",
-    "brazilian marketplaces scraper",
-    "brazilian afiliate marketing"
-  ],
-  "author": "Marcuth",
-  "license": "MIT",
-  "devDependencies": {
-    "@types/node": "^25.2.3",
-    "eslint": "^10.0.0",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.5",
-    "prettier": "^3.8.1",
-    "prettier-plugin-sort-imports": "^1.8.10",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.9.3"
-  },
-  "dependencies": {
-    "zod": "^4.3.6"
-  }
-}
+{
+  "name": "@afilimax/core",
+  "version": "0.4.0",
+  "type": "commonjs",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/*",
+    "!/**/__tests__"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node ./src/index.ts",
+    "format": "prettier --write \"src/**/*.ts\""
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "afilimax",
+    "brazilian marketplaces scraper",
+    "brazilian afiliate marketing"
+  ],
+  "author": "Marcuth",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^25.3.2",
+    "eslint": "^10.0.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.5",
+    "prettier": "^3.8.1",
+    "prettier-plugin-sort-imports": "^1.8.11",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "zod": "^4.3.6"
+  }
+}