@hubcommerce/trendyol 1.0.0

package/dist/products/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/products/paths.ts"],"names":[],"mappings":"AAIA,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAErF"}

package/dist/products/paths.js

@@ -0,0 +1,20 @@
+import { TRENDYOL_INTEGRATION_PREFIX } from "../constants.js";
+const PRODUCT_SELLER_PREFIX = `${TRENDYOL_INTEGRATION_PREFIX}/product/sellers`;
+export function productSellerBase(sellerId) {
+    return `${PRODUCT_SELLER_PREFIX}/${sellerId}`;
+}
+export function productV2Path(sellerId) {
+    return `${productSellerBase(sellerId)}/v2/products`;
+}
+export function productsBase(sellerId) {
+    return `${productSellerBase(sellerId)}/products`;
+}
+export function productByBarcodePath(sellerId, barcode) {
+    return `${productSellerBase(sellerId)}/product/${encodeURIComponent(barcode)}`;
+}
+export function batchRequestPath(sellerId, batchRequestId) {
+    return `${productsBase(sellerId)}/batch-requests/${encodeURIComponent(batchRequestId)}`;
+}
+export function updateAuditsPath(sellerId, contentId) {
+    return `${productsBase(sellerId)}/${contentId}/update-audits`;
+}

package/dist/qna/api.d.ts

@@ -0,0 +1,32 @@
+import type { TrendyolHttpClient } from "../http.js";
+import type { TrendyolConfig, TrendyolResult } from "../types.js";
+import type { AnswerQuestionBody, GetQuestionsParams, Question, QuestionsListResponse } from "../types/qna.js";
+type QnaOptions = {
+    signal?: AbortSignal;
+};
+/**
+ * Musteri soru-cevap (QnA) API.
+ * Base: /integration/qna/sellers/{sellerId}
+ */
+export declare class QnaApi {
+    private readonly http;
+    private readonly config;
+    constructor(http: TrendyolHttpClient, config: TrendyolConfig);
+    /**
+     * Sorulari filtreler ve sayfali listeler (size max 50).
+     * GET .../questions/filter
+     */
+    getQuestions(params?: GetQuestionsParams): Promise<TrendyolResult<QuestionsListResponse>>;
+    /**
+     * Tek soru detayi.
+     * GET .../questions/{id}
+     */
+    getQuestion(questionId: number | string, options?: QnaOptions): Promise<TrendyolResult<Question>>;
+    /**
+     * Soruyu cevaplar (mutasyon — blind retry yok).
+     * POST .../questions/{id}/answers
+     */
+    answerQuestion(questionId: number | string, body: AnswerQuestionBody, options?: QnaOptions): Promise<TrendyolResult<string>>;
+}
+export {};
+//# sourceMappingURL=api.d.ts.map

package/dist/qna/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/qna/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,QAAQ,EACR,qBAAqB,EACtB,MAAM,iBAAiB,CAAC;AAQzB,KAAK,UAAU,GAAG;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAiB3C;;;GAGG;AACH,qBAAa,MAAM;IAEf,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,cAAc;IAGzC;;;OAGG;IACH,YAAY,CACV,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC;IAkBjD;;;OAGG;IACH,WAAW,CACT,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IASpC;;;OAGG;IACH,cAAc,CACZ,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,IAAI,EAAE,kBAAkB,EACxB,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;CASnC"}

package/dist/qna/api.js

@@ -0,0 +1,78 @@
+import { validatePageSize } from "../validate.js";
+import { questionAnswersPath, questionByIdPath, questionsFilterPath, } from "./paths.js";
+function buildQuestionsQuery(params) {
+    const query = {};
+    if (params.barcode !== undefined)
+        query.barcode = params.barcode;
+    if (params.startDate !== undefined)
+        query.startDate = params.startDate;
+    if (params.endDate !== undefined)
+        query.endDate = params.endDate;
+    if (params.status !== undefined)
+        query.status = params.status;
+    if (params.orderByField !== undefined)
+        query.orderByField = params.orderByField;
+    if (params.orderByDirection !== undefined) {
+        query.orderByDirection = params.orderByDirection;
+    }
+    if (params.page !== undefined)
+        query.page = params.page;
+    if (params.size !== undefined)
+        query.size = params.size;
+    return query;
+}
+/**
+ * Musteri soru-cevap (QnA) API.
+ * Base: /integration/qna/sellers/{sellerId}
+ */
+export class QnaApi {
+    http;
+    config;
+    constructor(http, config) {
+        this.http = http;
+        this.config = config;
+    }
+    /**
+     * Sorulari filtreler ve sayfali listeler (size max 50).
+     * GET .../questions/filter
+     */
+    getQuestions(params) {
+        const size = params?.size ?? 10;
+        const pageValidation = validatePageSize("qna", size);
+        if (!pageValidation.ok) {
+            return Promise.resolve(pageValidation);
+        }
+        return this.http.requestJson({
+            method: "GET",
+            path: questionsFilterPath(this.config.sellerId),
+            query: buildQuestionsQuery({ ...params, size }),
+            retryPolicy: "safe",
+            signal: params?.signal,
+        });
+    }
+    /**
+     * Tek soru detayi.
+     * GET .../questions/{id}
+     */
+    getQuestion(questionId, options) {
+        return this.http.requestJson({
+            method: "GET",
+            path: questionByIdPath(this.config.sellerId, questionId),
+            retryPolicy: "safe",
+            signal: options?.signal,
+        });
+    }
+    /**
+     * Soruyu cevaplar (mutasyon — blind retry yok).
+     * POST .../questions/{id}/answers
+     */
+    answerQuestion(questionId, body, options) {
+        return this.http.requestJson({
+            method: "POST",
+            path: questionAnswersPath(this.config.sellerId, questionId),
+            body,
+            retryPolicy: "none",
+            signal: options?.signal,
+        });
+    }
+}

package/dist/qna/paths.d.ts

@@ -0,0 +1,5 @@
+export declare function qnaSellerBase(sellerId: string): string;
+export declare function questionsFilterPath(sellerId: string): string;
+export declare function questionByIdPath(sellerId: string, questionId: number | string): string;
+export declare function questionAnswersPath(sellerId: string, questionId: number | string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/qna/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/qna/paths.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEtF;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GAAG,MAAM,GAC1B,MAAM,CAER"}

package/dist/qna/paths.js

@@ -0,0 +1,13 @@
+import { TRENDYOL_INTEGRATION_PREFIX } from "../constants.js";
+export function qnaSellerBase(sellerId) {
+    return `${TRENDYOL_INTEGRATION_PREFIX}/qna/sellers/${sellerId}`;
+}
+export function questionsFilterPath(sellerId) {
+    return `${qnaSellerBase(sellerId)}/questions/filter`;
+}
+export function questionByIdPath(sellerId, questionId) {
+    return `${qnaSellerBase(sellerId)}/questions/${questionId}`;
+}
+export function questionAnswersPath(sellerId, questionId) {
+    return `${questionByIdPath(sellerId, questionId)}/answers`;
+}

package/dist/rate-limit/governor.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Opsiyonel client-side throttle — varsayilan kapali (enableClientSideLimiter: false).
+ * SDK istekleri reddetmez; proaktif gecikme uygular.
+ */
+export declare class RateLimitGovernor {
+    private readonly minIntervalMs;
+    private readonly lastRequestAt;
+    constructor(minIntervalMs?: number);
+    acquire(path: string): Promise<void>;
+}
+//# sourceMappingURL=governor.d.ts.map

package/dist/rate-limit/governor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governor.d.ts","sourceRoot":"","sources":["../../src/rate-limit/governor.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,iBAAiB;IAGhB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAF1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;gBAE9B,aAAa,SAAI;IAExC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAY3C"}

package/dist/rate-limit/governor.js

@@ -0,0 +1,25 @@
+import { resolveRateLimitGroup } from "./groups.js";
+/**
+ * Opsiyonel client-side throttle — varsayilan kapali (enableClientSideLimiter: false).
+ * SDK istekleri reddetmez; proaktif gecikme uygular.
+ */
+export class RateLimitGovernor {
+    minIntervalMs;
+    lastRequestAt = new Map();
+    constructor(minIntervalMs = 0) {
+        this.minIntervalMs = minIntervalMs;
+    }
+    async acquire(path) {
+        if (this.minIntervalMs <= 0)
+            return;
+        const group = resolveRateLimitGroup(path);
+        const key = group;
+        const now = Date.now();
+        const last = this.lastRequestAt.get(key) ?? 0;
+        const wait = this.minIntervalMs - (now - last);
+        if (wait > 0) {
+            await new Promise((resolve) => setTimeout(resolve, wait));
+        }
+        this.lastRequestAt.set(key, Date.now());
+    }
+}

package/dist/rate-limit/groups.d.ts

@@ -0,0 +1,15 @@
+/** Eyl 2026 grup profilleri — config ile override edilir (Faz 0 iskelet). */
+export declare const RATE_LIMIT_GROUPS: {
+    readonly product: {
+        readonly burstPer10s: 50;
+    };
+    readonly order: {
+        readonly burstPer10s: 50;
+    };
+    readonly inventory: {
+        readonly burstPer10s: 50;
+    };
+};
+export type RateLimitGroup = keyof typeof RATE_LIMIT_GROUPS;
+export declare function resolveRateLimitGroup(path: string): RateLimitGroup;
+//# sourceMappingURL=groups.d.ts.map

package/dist/rate-limit/groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groups.d.ts","sourceRoot":"","sources":["../../src/rate-limit/groups.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB;;;;;;;;;;CAIpB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAE5D,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAMlE"}

package/dist/rate-limit/groups.js

@@ -0,0 +1,14 @@
+/** Eyl 2026 grup profilleri — config ile override edilir (Faz 0 iskelet). */
+export const RATE_LIMIT_GROUPS = {
+    product: { burstPer10s: 50 },
+    order: { burstPer10s: 50 },
+    inventory: { burstPer10s: 50 },
+};
+export function resolveRateLimitGroup(path) {
+    if (path.includes("/order"))
+        return "order";
+    if (path.includes("/inventory") || path.includes("/price-and-inventory")) {
+        return "inventory";
+    }
+    return "product";
+}

package/dist/reference/addresses-cache.d.ts

@@ -0,0 +1,13 @@
+/** Resmi limit: 1 istek/saat — instance-scoped TTL cache. */
+export declare const SUPPLIER_ADDRESSES_CACHE_TTL_MS = 3600000;
+/**
+ * Satıcı adres cache — yalnizca TrendyolClient instance icinde.
+ * Modul-level singleton yasak (coklu satıcı veri sizintisi onlemi).
+ */
+export declare class SupplierAddressesCache {
+    private readonly entries;
+    get<T>(sellerId: string): T | undefined;
+    set<T>(sellerId: string, data: T): void;
+    clear(sellerId?: string): void;
+}
+//# sourceMappingURL=addresses-cache.d.ts.map

package/dist/reference/addresses-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addresses-cache.d.ts","sourceRoot":"","sources":["../../src/reference/addresses-cache.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,eAAO,MAAM,+BAA+B,UAAY,CAAC;AAOzD;;;GAGG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAElE,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAYvC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAOvC,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;CAO/B"}

package/dist/reference/addresses-cache.js

@@ -0,0 +1,33 @@
+/** Resmi limit: 1 istek/saat — instance-scoped TTL cache. */
+export const SUPPLIER_ADDRESSES_CACHE_TTL_MS = 3_600_000;
+/**
+ * Satıcı adres cache — yalnizca TrendyolClient instance icinde.
+ * Modul-level singleton yasak (coklu satıcı veri sizintisi onlemi).
+ */
+export class SupplierAddressesCache {
+    entries = new Map();
+    get(sellerId) {
+        const entry = this.entries.get(sellerId);
+        if (!entry) {
+            return undefined;
+        }
+        if (Date.now() > entry.expiresAt) {
+            this.entries.delete(sellerId);
+            return undefined;
+        }
+        return entry.data;
+    }
+    set(sellerId, data) {
+        this.entries.set(sellerId, {
+            data,
+            expiresAt: Date.now() + SUPPLIER_ADDRESSES_CACHE_TTL_MS,
+        });
+    }
+    clear(sellerId) {
+        if (sellerId === undefined) {
+            this.entries.clear();
+            return;
+        }
+        this.entries.delete(sellerId);
+    }
+}

package/dist/reference/api.d.ts

@@ -0,0 +1,48 @@
+import type { TrendyolHttpClient } from "../http.js";
+import type { TrendyolConfig, CategoryTreeResponse, TrendyolResult } from "../types.js";
+import type { BrandsListResponse, CargoProvider, CategoryAttributeValuesResponse, CategoryAttributesResponse, CreateBrandParams, GeoItem, GetBrandsByNameParams, GetBrandsParams, SupplierAddress } from "../types/reference.js";
+type ReferenceOptions = {
+    signal?: AbortSignal;
+};
+type GetSuppliersAddressesOptions = ReferenceOptions & {
+    /** Cache'i atla ve API'den taze cek. */
+    bypassCache?: boolean;
+};
+/**
+ * Referans API — marka, kategori, adres, kargo, geo.
+ */
+export declare class ReferenceApi {
+    private readonly http;
+    private readonly config;
+    private readonly addressesCache;
+    constructor(http: TrendyolHttpClient, config: TrendyolConfig);
+    /** GET /product/brands — min 1000/sayfa onerilir. */
+    getBrands(params?: GetBrandsParams, options?: ReferenceOptions): Promise<TrendyolResult<BrandsListResponse>>;
+    /** GET /product/brands/by-name — case-sensitive arama. */
+    getBrandsByName(params: GetBrandsByNameParams, options?: ReferenceOptions): Promise<TrendyolResult<BrandsListResponse>>;
+    /** POST /product/sellers/{sellerId}/brands — multipart: name + 1–3 gorsel. */
+    createBrand(params: CreateBrandParams, options?: ReferenceOptions): Promise<TrendyolResult<unknown>>;
+    /** GET /product/product-categories — testConnection canonical endpoint. */
+    getCategoryTree(options?: ReferenceOptions): Promise<TrendyolResult<CategoryTreeResponse>>;
+    getCategoryAttributes(categoryId: number | string, options?: ReferenceOptions): Promise<TrendyolResult<CategoryAttributesResponse>>;
+    getCategoryAttributeValues(categoryId: number | string, attributeId: number | string, options?: ReferenceOptions): Promise<TrendyolResult<CategoryAttributeValuesResponse>>;
+    /**
+     * GET /sellers/{sellerId}/addresses
+     *
+     * Resmi limit 1 req/saat — instance-scoped TTL cache (1 saat).
+     */
+    getSuppliersAddresses(options?: GetSuppliersAddressesOptions): Promise<TrendyolResult<SupplierAddress[]>>;
+    /** GET /product/lookup/cargo-providers — storeFrontCode header (config varsayilan TR). */
+    getCargoProviders(options?: ReferenceOptions): Promise<TrendyolResult<CargoProvider[]>>;
+    /**
+     * @deprecated V1 dokuman alias — {@link getCargoProviders} tercih edin.
+     */
+    getProviders(options?: ReferenceOptions): Promise<TrendyolResult<CargoProvider[]>>;
+    getTurkeyCities(options?: ReferenceOptions): Promise<TrendyolResult<GeoItem[]>>;
+    getTurkeyDistricts(cityId: number | string, options?: ReferenceOptions): Promise<TrendyolResult<GeoItem[]>>;
+    getTurkeyNeighborhoods(districtId: number | string, options?: ReferenceOptions): Promise<TrendyolResult<GeoItem[]>>;
+    /** Test ve diagnostik — cache instance'a ozel. */
+    clearAddressesCache(sellerId?: string): void;
+}
+export {};
+//# sourceMappingURL=api.d.ts.map

package/dist/reference/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/reference/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,KAAK,EAEV,kBAAkB,EAClB,aAAa,EAEb,+BAA+B,EAC/B,0BAA0B,EAC1B,iBAAiB,EACjB,OAAO,EAEP,qBAAqB,EACrB,eAAe,EACf,eAAe,EAEhB,MAAM,uBAAuB,CAAC;AAiB/B,KAAK,gBAAgB,GAAG;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAEjD,KAAK,4BAA4B,GAAG,gBAAgB,GAAG;IACrD,wCAAwC;IACxC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AA2BF;;GAEG;AACH,qBAAa,YAAY;IAIrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgC;gBAG5C,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,cAAc;IAGzC,qDAAqD;IACrD,SAAS,CACP,MAAM,CAAC,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;IAsB9C,0DAA0D;IAC1D,eAAe,CACb,MAAM,EAAE,qBAAqB,EAC7B,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;IAc9C,8EAA8E;IAC9E,WAAW,CACT,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IA0BnC,2EAA2E;IAC3E,eAAe,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC;IAS1F,qBAAqB,CACnB,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,cAAc,CAAC,0BAA0B,CAAC,CAAC;IAStD,0BAA0B,CACxB,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,WAAW,EAAE,MAAM,GAAG,MAAM,EAC5B,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,cAAc,CAAC,+BAA+B,CAAC,CAAC;IAS3D;;;;OAIG;IACG,qBAAqB,CACzB,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC,CAAC;IA0B7C,0FAA0F;IAC1F,iBAAiB,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,aAAa,EAAE,CAAC,CAAC;IAgBvF;;OAEG;IACH,YAAY,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,aAAa,EAAE,CAAC,CAAC;IAIlF,eAAe,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC;IAgB/E,kBAAkB,CAChB,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC;IAgBrC,sBAAsB,CACpB,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC;IAgBrC,kDAAkD;IAClD,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;CAG7C"}

package/dist/reference/api.js

@@ -0,0 +1,215 @@
+import { validatePageSize } from "../validate.js";
+import { SupplierAddressesCache } from "./addresses-cache.js";
+import { cargoProvidersPath, categoryAttributeValuesPath, categoryAttributesPath, PRODUCT_CATEGORIES_PATH, productBrandsByNamePath, productBrandsPath, sellerAddressesPath, sellerBrandsPath, turkeyCitiesPath, turkeyDistrictsPath, turkeyNeighborhoodsPath, } from "./paths.js";
+function normalizeBrands(response) {
+    return response.brands ?? response.content ?? [];
+}
+function normalizeAddresses(response) {
+    if (Array.isArray(response)) {
+        return response;
+    }
+    return response.addresses ?? [];
+}
+function normalizeCargoProviders(response) {
+    if (Array.isArray(response)) {
+        return response;
+    }
+    return response.cargoProviders ?? [];
+}
+function normalizeGeoList(response) {
+    if (Array.isArray(response)) {
+        return response;
+    }
+    return response.content ?? [];
+}
+/**
+ * Referans API — marka, kategori, adres, kargo, geo.
+ */
+export class ReferenceApi {
+    http;
+    config;
+    addressesCache = new SupplierAddressesCache();
+    constructor(http, config) {
+        this.http = http;
+        this.config = config;
+    }
+    /** GET /product/brands — min 1000/sayfa onerilir. */
+    getBrands(params, options) {
+        const size = params?.size ?? 1000;
+        const pageValidation = validatePageSize("brands", size);
+        if (!pageValidation.ok) {
+            return Promise.resolve(pageValidation);
+        }
+        const query = {};
+        if (params?.page !== undefined) {
+            query.page = params.page;
+        }
+        query.size = size;
+        return this.http.requestJson({
+            method: "GET",
+            path: productBrandsPath(),
+            query,
+            retryPolicy: "safe",
+            signal: options?.signal,
+        });
+    }
+    /** GET /product/brands/by-name — case-sensitive arama. */
+    getBrandsByName(params, options) {
+        if (!params.name.trim()) {
+            return Promise.resolve({ ok: false, reason: "name bos olamaz." });
+        }
+        return this.http.requestJson({
+            method: "GET",
+            path: productBrandsByNamePath(),
+            query: { name: params.name },
+            retryPolicy: "safe",
+            signal: options?.signal,
+        });
+    }
+    /** POST /product/sellers/{sellerId}/brands — multipart: name + 1–3 gorsel. */
+    createBrand(params, options) {
+        if (!params.name.trim()) {
+            return Promise.resolve({ ok: false, reason: "name bos olamaz." });
+        }
+        if (params.images.length < 1 || params.images.length > 3) {
+            return Promise.resolve({
+                ok: false,
+                reason: "createBrand icin 1 ile 3 arasi gorsel gerekir.",
+            });
+        }
+        const form = new FormData();
+        form.append("name", params.name);
+        for (const [index, image] of params.images.entries()) {
+            form.append("images", image, `brand-${index}.jpg`);
+        }
+        return this.http.requestMultipart({
+            method: "POST",
+            path: sellerBrandsPath(this.config.sellerId),
+            formData: form,
+            retryPolicy: "none",
+            signal: options?.signal,
+        });
+    }
+    /** GET /product/product-categories — testConnection canonical endpoint. */
+    getCategoryTree(options) {
+        return this.http.requestJson({
+            method: "GET",
+            path: PRODUCT_CATEGORIES_PATH,
+            retryPolicy: "safe",
+            signal: options?.signal,
+        });
+    }
+    getCategoryAttributes(categoryId, options) {
+        return this.http.requestJson({
+            method: "GET",
+            path: categoryAttributesPath(categoryId),
+            retryPolicy: "safe",
+            signal: options?.signal,
+        });
+    }
+    getCategoryAttributeValues(categoryId, attributeId, options) {
+        return this.http.requestJson({
+            method: "GET",
+            path: categoryAttributeValuesPath(categoryId, attributeId),
+            retryPolicy: "safe",
+            signal: options?.signal,
+        });
+    }
+    /**
+     * GET /sellers/{sellerId}/addresses
+     *
+     * Resmi limit 1 req/saat — instance-scoped TTL cache (1 saat).
+     */
+    async getSuppliersAddresses(options) {
+        const sellerId = this.config.sellerId;
+        if (!options?.bypassCache) {
+            const cached = this.addressesCache.get(sellerId);
+            if (cached) {
+                return { ok: true, data: cached };
+            }
+        }
+        const result = await this.http.requestJson({
+            method: "GET",
+            path: sellerAddressesPath(sellerId),
+            retryPolicy: "safe",
+            signal: options?.signal,
+        });
+        if (!result.ok) {
+            return result;
+        }
+        const addresses = normalizeAddresses(result.data);
+        this.addressesCache.set(sellerId, addresses);
+        return { ok: true, data: addresses };
+    }
+    /** GET /product/lookup/cargo-providers — storeFrontCode header (config varsayilan TR). */
+    getCargoProviders(options) {
+        return this.http
+            .requestJson({
+            method: "GET",
+            path: cargoProvidersPath(),
+            retryPolicy: "safe",
+            signal: options?.signal,
+        })
+            .then((result) => {
+            if (!result.ok) {
+                return result;
+            }
+            return { ok: true, data: normalizeCargoProviders(result.data) };
+        });
+    }
+    /**
+     * @deprecated V1 dokuman alias — {@link getCargoProviders} tercih edin.
+     */
+    getProviders(options) {
+        return this.getCargoProviders(options);
+    }
+    getTurkeyCities(options) {
+        return this.http
+            .requestJson({
+            method: "GET",
+            path: turkeyCitiesPath(),
+            retryPolicy: "safe",
+            signal: options?.signal,
+        })
+            .then((result) => {
+            if (!result.ok) {
+                return result;
+            }
+            return { ok: true, data: normalizeGeoList(result.data) };
+        });
+    }
+    getTurkeyDistricts(cityId, options) {
+        return this.http
+            .requestJson({
+            method: "GET",
+            path: turkeyDistrictsPath(cityId),
+            retryPolicy: "safe",
+            signal: options?.signal,
+        })
+            .then((result) => {
+            if (!result.ok) {
+                return result;
+            }
+            return { ok: true, data: normalizeGeoList(result.data) };
+        });
+    }
+    getTurkeyNeighborhoods(districtId, options) {
+        return this.http
+            .requestJson({
+            method: "GET",
+            path: turkeyNeighborhoodsPath(districtId),
+            retryPolicy: "safe",
+            signal: options?.signal,
+        })
+            .then((result) => {
+            if (!result.ok) {
+                return result;
+            }
+            return { ok: true, data: normalizeGeoList(result.data) };
+        });
+    }
+    /** Test ve diagnostik — cache instance'a ozel. */
+    clearAddressesCache(sellerId) {
+        this.addressesCache.clear(sellerId);
+    }
+}

package/dist/reference/paths.d.ts

@@ -0,0 +1,12 @@
+export declare const PRODUCT_CATEGORIES_PATH = "/integration/product/product-categories";
+export declare function productBrandsPath(): string;
+export declare function productBrandsByNamePath(): string;
+export declare function sellerBrandsPath(sellerId: string): string;
+export declare function categoryAttributesPath(categoryId: number | string): string;
+export declare function categoryAttributeValuesPath(categoryId: number | string, attributeId: number | string): string;
+export declare function sellerAddressesPath(sellerId: string): string;
+export declare function cargoProvidersPath(): string;
+export declare function turkeyCitiesPath(): string;
+export declare function turkeyDistrictsPath(cityId: number | string): string;
+export declare function turkeyNeighborhoodsPath(districtId: number | string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/reference/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/reference/paths.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,uBAAuB,4CAAyC,CAAC;AAE9E,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAE1E;AAED,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,MAAM,CAER;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAE3E"}

package/dist/reference/paths.js

@@ -0,0 +1,34 @@
+import { TRENDYOL_INTEGRATION_PREFIX } from "../constants.js";
+const PRODUCT_PREFIX = `${TRENDYOL_INTEGRATION_PREFIX}/product`;
+const REFERENCE_PREFIX = `${TRENDYOL_INTEGRATION_PREFIX}/reference`;
+export const PRODUCT_CATEGORIES_PATH = `${PRODUCT_PREFIX}/product-categories`;
+export function productBrandsPath() {
+    return `${PRODUCT_PREFIX}/brands`;
+}
+export function productBrandsByNamePath() {
+    return `${PRODUCT_PREFIX}/brands/by-name`;
+}
+export function sellerBrandsPath(sellerId) {
+    return `${PRODUCT_PREFIX}/sellers/${sellerId}/brands`;
+}
+export function categoryAttributesPath(categoryId) {
+    return `${PRODUCT_PREFIX}/categories/${categoryId}/attributes`;
+}
+export function categoryAttributeValuesPath(categoryId, attributeId) {
+    return `${PRODUCT_PREFIX}/categories/${categoryId}/attributes/${attributeId}/values`;
+}
+export function sellerAddressesPath(sellerId) {
+    return `${TRENDYOL_INTEGRATION_PREFIX}/sellers/${sellerId}/addresses`;
+}
+export function cargoProvidersPath() {
+    return `${PRODUCT_PREFIX}/lookup/cargo-providers`;
+}
+export function turkeyCitiesPath() {
+    return `${REFERENCE_PREFIX}/countries/TR/cities`;
+}
+export function turkeyDistrictsPath(cityId) {
+    return `${REFERENCE_PREFIX}/countries/TR/cities/${cityId}/districts`;
+}
+export function turkeyNeighborhoodsPath(districtId) {
+    return `${REFERENCE_PREFIX}/countries/TR/districts/${districtId}/neighborhoods`;
+}

package/dist/retry.d.ts

@@ -0,0 +1,6 @@
+import type { TrendyolConfig } from "./types.js";
+export declare function computeRetryDelayMs(config: TrendyolConfig, attempt: number, retryAfterHeader?: string | null, rateLimitResetHeader?: string | null): number;
+export declare function sleep(ms: number): Promise<void>;
+export declare function shouldRetryStatus(status: number, retryPolicy: "safe" | "none"): boolean;
+export declare function shouldRetryError(error: unknown, retryPolicy: "safe" | "none"): boolean;
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,MAAM,EACf,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,EAChC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,GACnC,MAAM,CAoBR;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/C;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,OAAO,CAKT;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,OAAO,CAKT"}