@afilimax/core 0.2.2 → 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/enums/marketplace.enum.d.ts

@@ -7,5 +7,6 @@ export declare enum Marketplace {
     Americanas = "americanas",
     TerabyteShop = "terabyte_shop",
     Kabum = "kabum",
-    Pichau = "pichau"
+    Pichau = "pichau",
+    MagazineLuiza = "magazine_luiza"
 }

package/dist/enums/marketplace.enum.js

@@ -12,4 +12,5 @@ var Marketplace;
     Marketplace["TerabyteShop"] = "terabyte_shop";
     Marketplace["Kabum"] = "kabum";
     Marketplace["Pichau"] = "pichau";
+    Marketplace["MagazineLuiza"] = "magazine_luiza";
 })(Marketplace || (exports.Marketplace = Marketplace = {}));

package/dist/helpers/config.helper.d.ts

@@ -0,0 +1,14 @@
+export declare const configHelper: {
+    domains: {
+        amazon: string[];
+        mercado_livre: string[];
+        shopee: string[];
+        aliexpress: string[];
+        magazine_luiza: string[];
+        kabum: string[];
+        terabyte_shop: string[];
+        pichau: string[];
+        americanas: string[];
+        temu: string[];
+    };
+};

package/dist/helpers/config.helper.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configHelper = void 0;
+const enums_1 = require("../enums");
+exports.configHelper = {
+    domains: {
+        [enums_1.Marketplace.Amazon]: ["amazon.com", "amazon.com.br", "amzn.to", "a.co"],
+        [enums_1.Marketplace.MercadoLivre]: ["mercadolivre.com.br", "mercadolivre.com"],
+        [enums_1.Marketplace.Shopee]: ["shopee.com.br", "shopee.com"],
+        [enums_1.Marketplace.AliExpress]: ["aliexpress.com"],
+        [enums_1.Marketplace.MagazineLuiza]: ["magazineluiza.com.br", "magazinevoce.com.br", "magazineluiza.onelink.me"],
+        [enums_1.Marketplace.Kabum]: ["kabum.com.br"],
+        [enums_1.Marketplace.TerabyteShop]: ["terabyteshop.com.br"],
+        [enums_1.Marketplace.Pichau]: ["pichau.com.br"],
+        [enums_1.Marketplace.Americanas]: ["americanas.com.br"],
+        [enums_1.Marketplace.Temu]: ["temu.com"],
+    },
+};

package/dist/index.d.ts

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

package/dist/index.js

@@ -17,3 +17,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __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/dist/utils/index.d.ts

@@ -0,0 +1 @@
+export * from "./url-validators";

package/dist/utils/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./url-validators"), exports);

package/dist/utils/url-validators/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./is-amazon-product-url.util";
+export * from "./is-aliexpress-product-url.util";
+export * from "./is-shopee-product-url.util";
+export * from "./is-terabyte-shop-product-url.util";
+export * from "./is-kabum-product-url.util";
+export * from "./is-pichau-product-url.util";
+export * from "./is-temu-product-url.util";
+export * from "./is-magazine-luiza-product-url.util";
+export * from "./is-americanas-product-url.util";
+export declare function isValidProductUrl(url: string): boolean;

package/dist/utils/url-validators/index.js

@@ -0,0 +1,46 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidProductUrl = isValidProductUrl;
+const is_magazine_luiza_product_url_util_1 = require("./is-magazine-luiza-product-url.util");
+const is_terabyte_shop_product_url_util_1 = require("./is-terabyte-shop-product-url.util");
+const is_americanas_product_url_util_1 = require("./is-americanas-product-url.util");
+const is_aliexpress_product_url_util_1 = require("./is-aliexpress-product-url.util");
+const is_shopee_product_url_util_1 = require("./is-shopee-product-url.util");
+const is_pichau_product_url_util_1 = require("./is-pichau-product-url.util");
+const is_amazon_product_url_util_1 = require("./is-amazon-product-url.util");
+const is_kabum_product_url_util_1 = require("./is-kabum-product-url.util");
+const is_temu_product_url_util_1 = require("./is-temu-product-url.util");
+__exportStar(require("./is-amazon-product-url.util"), exports);
+__exportStar(require("./is-aliexpress-product-url.util"), exports);
+__exportStar(require("./is-shopee-product-url.util"), exports);
+__exportStar(require("./is-terabyte-shop-product-url.util"), exports);
+__exportStar(require("./is-kabum-product-url.util"), exports);
+__exportStar(require("./is-pichau-product-url.util"), exports);
+__exportStar(require("./is-temu-product-url.util"), exports);
+__exportStar(require("./is-magazine-luiza-product-url.util"), exports);
+__exportStar(require("./is-americanas-product-url.util"), exports);
+function isValidProductUrl(url) {
+    return ((0, is_amazon_product_url_util_1.isAmazonProductUrl)(url) ||
+        (0, is_aliexpress_product_url_util_1.isAliExpressProductUrl)(url) ||
+        (0, is_shopee_product_url_util_1.isShopeeProductUrl)(url) ||
+        (0, is_terabyte_shop_product_url_util_1.isTerabyteShopProductUrl)(url) ||
+        (0, is_kabum_product_url_util_1.isKabumProductUrl)(url) ||
+        (0, is_pichau_product_url_util_1.isPichauProductUrl)(url) ||
+        (0, is_temu_product_url_util_1.isTemuProductUrl)(url) ||
+        (0, is_magazine_luiza_product_url_util_1.isMagazineLuizaProductUrl)(url) ||
+        (0, is_americanas_product_url_util_1.isAmericanasProductUrl)(url));
+}

package/dist/utils/url-validators/is-aliexpress-product-url.util.d.ts

@@ -0,0 +1 @@
+export declare function isAliExpressProductUrl(url: string): boolean;

package/dist/utils/url-validators/is-aliexpress-product-url.util.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAliExpressProductUrl = isAliExpressProductUrl;
+const config_helper_1 = require("../../helpers/config.helper");
+function isAliExpressProductUrl(url) {
+    return config_helper_1.configHelper.domains.aliexpress.some((domain) => url.includes(domain));
+}

package/dist/utils/url-validators/is-amazon-product-url.util.d.ts

@@ -0,0 +1 @@
+export declare function isAmazonProductUrl(url: string): boolean;

package/dist/utils/url-validators/is-amazon-product-url.util.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAmazonProductUrl = isAmazonProductUrl;
+const config_helper_1 = require("../../helpers/config.helper");
+function isAmazonProductUrl(url) {
+    const domainPattern = config_helper_1.configHelper.domains.amazon.join("|");
+    const amazonProductRegex = new RegExp(`https?://(?:www\\.)?(?:${domainPattern})/(?:.+/)?(?:gp/product|dp|exec/obidos/tg/detail|gp/aw/d|gp/offer-listing|d)/[\\w\\d]+|https://amzn\\.to/[\\w\\d]+`, "i");
+    return amazonProductRegex.test(url);
+}

package/dist/utils/url-validators/is-americanas-product-url.util.d.ts

@@ -0,0 +1 @@
+export declare function isAmericanasProductUrl(url: string): boolean;

package/dist/utils/url-validators/is-americanas-product-url.util.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAmericanasProductUrl = isAmericanasProductUrl;
+const config_helper_1 = require("../../helpers/config.helper");
+function isAmericanasProductUrl(url) {
+    return config_helper_1.configHelper.domains.americanas.some((domain) => url.includes(domain));
+}

package/dist/utils/url-validators/is-kabum-product-url.util.d.ts

@@ -0,0 +1 @@
+export declare function isKabumProductUrl(url: string): boolean;

package/dist/utils/url-validators/is-kabum-product-url.util.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isKabumProductUrl = isKabumProductUrl;
+const config_helper_1 = require("../../helpers/config.helper");
+function isKabumProductUrl(url) {
+    return config_helper_1.configHelper.domains.kabum.some((domain) => url.includes(domain));
+}

package/dist/utils/url-validators/is-magazine-luiza-product-url.util.d.ts

@@ -0,0 +1 @@
+export declare function isMagazineLuizaProductUrl(url: string): boolean;

package/dist/utils/url-validators/is-magazine-luiza-product-url.util.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMagazineLuizaProductUrl = isMagazineLuizaProductUrl;
+const config_helper_1 = require("../../helpers/config.helper");
+function isMagazineLuizaProductUrl(url) {
+    const domainPattern = config_helper_1.configHelper.domains.magazine_luiza.join("|");
+    const magazineLuizaRegex = new RegExp(`^https?://(?:www\\.)?(?:${domainPattern})/(?:.+)?`, "i");
+    return magazineLuizaRegex.test(url);
+}

package/dist/utils/url-validators/is-mercado-livre-product-url.util.d.ts

@@ -0,0 +1 @@
+export declare function isMercadoLivreProductUrl(url: string): boolean;

package/dist/utils/url-validators/is-mercado-livre-product-url.util.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMercadoLivreProductUrl = isMercadoLivreProductUrl;
+const config_helper_1 = require("../../helpers/config.helper");
+function isMercadoLivreProductUrl(url) {
+    const domainPattern = config_helper_1.configHelper.domains.mercado_livre.join("|");
+    const mercadoLivreProductRegex = new RegExp(`^https?://(?:www\\.|lista\\.|produto\\.)?(?:${domainPattern})/(?:[^/]+/)?(ML[AB]-?\\d{7,}|p/[\\w\\d]+|sec/[\\w\\d]+)`, "i");
+    return mercadoLivreProductRegex.test(url);
+}

package/dist/utils/url-validators/is-pichau-product-url.util.d.ts

@@ -0,0 +1 @@
+export declare function isPichauProductUrl(url: string): boolean;

package/dist/utils/url-validators/is-pichau-product-url.util.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPichauProductUrl = isPichauProductUrl;
+const config_helper_1 = require("../../helpers/config.helper");
+function isPichauProductUrl(url) {
+    return config_helper_1.configHelper.domains.pichau.some((domain) => url.includes(domain));
+}

package/dist/utils/url-validators/is-shopee-product-url.util.d.ts

@@ -0,0 +1 @@
+export declare function isShopeeProductUrl(url: string): boolean;

package/dist/utils/url-validators/is-shopee-product-url.util.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isShopeeProductUrl = isShopeeProductUrl;
+const config_helper_1 = require("../../helpers/config.helper");
+function isShopeeProductUrl(url) {
+    const domainPattern = config_helper_1.configHelper.domains.shopee.join("|");
+    const shopeeRegex = new RegExp(`^https?://(?:www\\.|s\\.)?(?:${domainPattern})/(?:.+-)?i\\.\\d+\\.\\d+|^https://shp\\.ee/[\\w\\d]+`, "i");
+    return shopeeRegex.test(url);
+}

package/dist/utils/url-validators/is-temu-product-url.util.d.ts

@@ -0,0 +1 @@
+export declare function isTemuProductUrl(url: string): boolean;

package/dist/utils/url-validators/is-temu-product-url.util.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTemuProductUrl = isTemuProductUrl;
+const config_helper_1 = require("../../helpers/config.helper");
+function isTemuProductUrl(url) {
+    return config_helper_1.configHelper.domains.temu.some((domain) => url.includes(domain));
+}

package/dist/utils/url-validators/is-terabyte-shop-product-url.util.d.ts

@@ -0,0 +1 @@
+export declare function isTerabyteShopProductUrl(url: string): boolean;

package/dist/utils/url-validators/is-terabyte-shop-product-url.util.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTerabyteShopProductUrl = isTerabyteShopProductUrl;
+const config_helper_1 = require("../../helpers/config.helper");
+function isTerabyteShopProductUrl(url) {
+    return config_helper_1.configHelper.domains.terabyte_shop.some((domain) => url.includes(domain));
+}

package/package.json

@@ -1,40 +1,40 @@
-{
-  "name": "@afilimax/core",
-  "version": "0.2.2",
-  "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"
+  }
+}