@hubcommerce/trendyol 1.0.0

package/dist/claims/form.d.ts

@@ -0,0 +1,9 @@
+import type { CreateClaimIssueFields } from "../types/claims.js";
+export type BuildClaimIssueFormDataInput = CreateClaimIssueFields;
+/**
+ * createClaimIssue icin multipart FormData olusturur.
+ *
+ * claimItemIdList API'de virgulle ayrilmis string bekler.
+ */
+export declare function buildClaimIssueFormData(input: BuildClaimIssueFormDataInput): FormData;
+//# sourceMappingURL=form.d.ts.map

package/dist/claims/form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../src/claims/form.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,MAAM,MAAM,4BAA4B,GAAG,sBAAsB,CAAC;AAElE;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,4BAA4B,GAClC,QAAQ,CAqBV"}

package/dist/claims/form.js

@@ -0,0 +1,20 @@
+/**
+ * createClaimIssue icin multipart FormData olusturur.
+ *
+ * claimItemIdList API'de virgulle ayrilmis string bekler.
+ */
+export function buildClaimIssueFormData(input) {
+    const form = new FormData();
+    form.append("claimIssueReasonId", String(input.claimIssueReasonId));
+    const itemList = Array.isArray(input.claimItemIdList)
+        ? input.claimItemIdList.join(",")
+        : input.claimItemIdList;
+    form.append("claimItemIdList", itemList);
+    form.append("description", input.description);
+    if (input.files) {
+        for (const [index, file] of input.files.entries()) {
+            form.append("files", file.blob, file.fileName ?? `attachment-${index + 1}`);
+        }
+    }
+    return form;
+}

package/dist/claims/paths.d.ts

@@ -0,0 +1,3 @@
+export declare function claimsBase(sellerId: string): string;
+export declare function claimIssueReasonsPath(): string;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/claims/paths.ts"],"names":[],"mappings":"AAGA,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C"}

package/dist/claims/paths.js

@@ -0,0 +1,8 @@
+import { TRENDYOL_INTEGRATION_PREFIX } from "../constants.js";
+import { orderSellerBase } from "../orders/paths.js";
+export function claimsBase(sellerId) {
+    return `${orderSellerBase(sellerId)}/claims`;
+}
+export function claimIssueReasonsPath() {
+    return `${TRENDYOL_INTEGRATION_PREFIX}/order/claim-issue-reasons`;
+}

package/dist/client.d.ts

@@ -0,0 +1,39 @@
+import { BatchPoller } from "./batch/poller.js";
+import { ClaimsApi } from "./claims/api.js";
+import { CompensationApi } from "./compensation/api.js";
+import { FinanceApi } from "./finance/api.js";
+import { InventoryApi } from "./inventory/api.js";
+import { InvoicesApi } from "./invoices/api.js";
+import { TrendyolHttpClient } from "./http.js";
+import { LabelsApi } from "./labels/api.js";
+import { WarrantyApi } from "./orders/warranty.js";
+import { OrdersApi } from "./orders/api.js";
+import { ProductsApi } from "./products/api.js";
+import { QnaApi } from "./qna/api.js";
+import { ReferenceApi } from "./reference/api.js";
+import { VideoApi } from "./video/api.js";
+import { WebhooksApi } from "./webhooks/management.js";
+import type { CategoryTreeResponse, TrendyolConfig, TrendyolResult } from "./types.js";
+export declare class TrendyolClient {
+    readonly config: TrendyolConfig;
+    readonly orders: OrdersApi;
+    readonly claims: ClaimsApi;
+    readonly invoices: InvoicesApi;
+    readonly inventory: InventoryApi;
+    readonly reference: ReferenceApi;
+    readonly products: ProductsApi;
+    readonly batch: BatchPoller;
+    readonly video: VideoApi;
+    readonly warranty: WarrantyApi;
+    readonly webhooks: WebhooksApi;
+    readonly finance: FinanceApi;
+    readonly qna: QnaApi;
+    readonly labels: LabelsApi;
+    readonly compensation: CompensationApi;
+    private readonly http;
+    constructor(config?: Partial<TrendyolConfig>);
+    getHttpClient(): TrendyolHttpClient;
+    testConnection(): Promise<TrendyolResult<CategoryTreeResponse>>;
+}
+export declare function createTrendyolClient(config?: Partial<TrendyolConfig>): TrendyolClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEvF,qBAAa,cAAc;IACzB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;gBAE9B,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IA0B5C,aAAa,IAAI,kBAAkB;IAInC,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC;CAGhE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAErF"}

package/dist/client.js

@@ -0,0 +1,66 @@
+import { BatchPoller } from "./batch/poller.js";
+import { ClaimsApi } from "./claims/api.js";
+import { CompensationApi } from "./compensation/api.js";
+import { getTrendyolConfig } from "./config.js";
+import { testConnection as testConnectionImpl } from "./connection.js";
+import { FinanceApi } from "./finance/api.js";
+import { InventoryApi } from "./inventory/api.js";
+import { InvoicesApi } from "./invoices/api.js";
+import { TrendyolHttpClient } from "./http.js";
+import { LabelsApi } from "./labels/api.js";
+import { WarrantyApi } from "./orders/warranty.js";
+import { OrdersApi } from "./orders/api.js";
+import { ProductsApi } from "./products/api.js";
+import { QnaApi } from "./qna/api.js";
+import { ReferenceApi } from "./reference/api.js";
+import { RateLimitGovernor } from "./rate-limit/governor.js";
+import { VideoApi } from "./video/api.js";
+import { WebhooksApi } from "./webhooks/management.js";
+export class TrendyolClient {
+    config;
+    orders;
+    claims;
+    invoices;
+    inventory;
+    reference;
+    products;
+    batch;
+    video;
+    warranty;
+    webhooks;
+    finance;
+    qna;
+    labels;
+    compensation;
+    http;
+    constructor(config) {
+        this.config = getTrendyolConfig(config);
+        const governor = this.config.enableClientSideLimiter
+            ? new RateLimitGovernor()
+            : undefined;
+        this.http = new TrendyolHttpClient(this.config, governor);
+        this.orders = new OrdersApi(this.http, this.config);
+        this.claims = new ClaimsApi(this.http, this.config);
+        this.invoices = new InvoicesApi(this.http, this.config);
+        this.inventory = new InventoryApi(this.http, this.config);
+        this.reference = new ReferenceApi(this.http, this.config);
+        this.products = new ProductsApi(this.http, this.config);
+        this.batch = new BatchPoller((batchRequestId, signal) => this.products.getBatchRequestResult(batchRequestId, { signal }), () => this.http.getHooks());
+        this.video = new VideoApi(this.http, this.config);
+        this.warranty = new WarrantyApi(this.http, this.config);
+        this.webhooks = new WebhooksApi(this.http, this.config);
+        this.finance = new FinanceApi(this.http, this.config);
+        this.qna = new QnaApi(this.http, this.config);
+        this.labels = new LabelsApi(this.http, this.config);
+        this.compensation = new CompensationApi(this.http, this.config);
+    }
+    getHttpClient() {
+        return this.http;
+    }
+    testConnection() {
+        return testConnectionImpl(this.http);
+    }
+}
+export function createTrendyolClient(config) {
+    return new TrendyolClient(config);
+}

package/dist/compensation/api.d.ts

@@ -0,0 +1,17 @@
+import type { TrendyolHttpClient } from "../http.js";
+import type { TrendyolConfig, TrendyolResult } from "../types.js";
+import type { CompensationTicketsResponse, GetCompensationTicketsParams } from "../types/compensation.js";
+/**
+ * Trendyol Express tazmin (TEX) API.
+ */
+export declare class CompensationApi {
+    private readonly http;
+    private readonly config;
+    constructor(http: TrendyolHttpClient, config: TrendyolConfig);
+    /**
+     * Tazmin taleplerini listeler.
+     * GET /integration/tex/compensation/sellers/{sellerId}/tickets
+     */
+    getCompensationTickets(params?: GetCompensationTicketsParams): Promise<TrendyolResult<CompensationTicketsResponse>>;
+}
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/compensation/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,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,0BAA0B,CAAC;AAclC;;GAEG;AACH,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,cAAc;IAGzC;;;OAGG;IACH,sBAAsB,CACpB,MAAM,CAAC,EAAE,4BAA4B,GACpC,OAAO,CAAC,cAAc,CAAC,2BAA2B,CAAC,CAAC;CASxD"}

package/dist/compensation/api.js

@@ -0,0 +1,37 @@
+import { compensationTicketsPath } from "./paths.js";
+function buildCompensationQuery(params) {
+    const query = {};
+    if (params?.startDate !== undefined)
+        query.startDate = params.startDate;
+    if (params?.endDate !== undefined)
+        query.endDate = params.endDate;
+    if (params?.page !== undefined)
+        query.page = params.page;
+    if (params?.size !== undefined)
+        query.size = params.size;
+    return query;
+}
+/**
+ * Trendyol Express tazmin (TEX) API.
+ */
+export class CompensationApi {
+    http;
+    config;
+    constructor(http, config) {
+        this.http = http;
+        this.config = config;
+    }
+    /**
+     * Tazmin taleplerini listeler.
+     * GET /integration/tex/compensation/sellers/{sellerId}/tickets
+     */
+    getCompensationTickets(params) {
+        return this.http.requestJson({
+            method: "GET",
+            path: compensationTicketsPath(this.config.sellerId),
+            query: buildCompensationQuery(params),
+            retryPolicy: "safe",
+            signal: params?.signal,
+        });
+    }
+}

package/dist/compensation/paths.d.ts

@@ -0,0 +1,2 @@
+export declare function compensationTicketsPath(sellerId: string): string;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/compensation/paths.ts"],"names":[],"mappings":"AAEA,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/dist/compensation/paths.js

@@ -0,0 +1,4 @@
+import { TRENDYOL_INTEGRATION_PREFIX } from "../constants.js";
+export function compensationTicketsPath(sellerId) {
+    return `${TRENDYOL_INTEGRATION_PREFIX}/tex/compensation/sellers/${sellerId}/tickets`;
+}

package/dist/config.d.ts

@@ -0,0 +1,10 @@
+import type { TrendyolConfig } from "./types.js";
+export declare class TrendyolConfigError extends Error {
+    constructor(message: string);
+}
+export declare function getTrendyolConfig(overrides?: Partial<TrendyolConfig>): TrendyolConfig;
+export declare function isTrendyolConfigured(): boolean;
+export declare function buildBasicAuthHeader(apiKey: string, apiSecret: string): string;
+export declare function buildUserAgent(integratorName: string, sellerId: string): string;
+export declare function resolveGatewayUrl(config: TrendyolConfig, path: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,YAAY,CAAC;AAE9D,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAsBD,wBAAgB,iBAAiB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAyDrF;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAO9C;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG9E;AAED,wBAAgB,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9E"}

package/dist/config.js

@@ -0,0 +1,78 @@
+import { TRENDYOL_DEFAULT_INTEGRATOR, TRENDYOL_DEFAULT_MAX_RETRIES, TRENDYOL_DEFAULT_MAX_WEBHOOK_BYTES, TRENDYOL_DEFAULT_RETRY_BASE_MS, TRENDYOL_DEFAULT_STORE_FRONT, TRENDYOL_DEFAULT_TIMEOUT_MS, TRENDYOL_PROD_GATEWAY, TRENDYOL_STAGE_GATEWAY, } from "./constants.js";
+export class TrendyolConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "TrendyolConfigError";
+    }
+}
+function parseEnv() {
+    const value = process.env.TRENDYOL_ENV?.trim().toLowerCase();
+    return value === "production" ? "production" : "stage";
+}
+function defaultGateway(env) {
+    return env === "production" ? TRENDYOL_PROD_GATEWAY : TRENDYOL_STAGE_GATEWAY;
+}
+function parsePositiveInt(value, fallback) {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+function parseBoolean(value, fallback = false) {
+    if (value === undefined)
+        return fallback;
+    const normalized = value.trim().toLowerCase();
+    return normalized === "1" || normalized === "true" || normalized === "yes";
+}
+export function getTrendyolConfig(overrides) {
+    const env = overrides?.env ?? parseEnv();
+    const gatewayBase = overrides?.gatewayBase ??
+        process.env.TRENDYOL_GATEWAY_BASE?.trim() ??
+        defaultGateway(env);
+    const sellerId = overrides?.sellerId ?? process.env.TRENDYOL_SELLER_ID?.trim() ?? "";
+    const apiKey = overrides?.apiKey ?? process.env.TRENDYOL_API_KEY?.trim() ?? "";
+    const apiSecret = overrides?.apiSecret ?? process.env.TRENDYOL_API_SECRET?.trim() ?? "";
+    if (!sellerId || !apiKey || !apiSecret) {
+        throw new TrendyolConfigError("Trendyol bilgileri eksik. TRENDYOL_SELLER_ID, TRENDYOL_API_KEY ve TRENDYOL_API_SECRET tanimlanmalidir.");
+    }
+    return {
+        sellerId,
+        apiKey,
+        apiSecret,
+        env,
+        integratorName: overrides?.integratorName ??
+            process.env.TRENDYOL_INTEGRATOR_NAME?.trim() ??
+            TRENDYOL_DEFAULT_INTEGRATOR,
+        storeFrontCode: overrides?.storeFrontCode ??
+            process.env.TRENDYOL_STORE_FRONT_CODE?.trim() ??
+            TRENDYOL_DEFAULT_STORE_FRONT,
+        gatewayBase: gatewayBase.replace(/\/$/, ""),
+        requestTimeoutMs: parsePositiveInt(overrides?.requestTimeoutMs?.toString() ??
+            process.env.TRENDYOL_REQUEST_TIMEOUT_MS, TRENDYOL_DEFAULT_TIMEOUT_MS),
+        debug: overrides?.debug ?? parseBoolean(process.env.TRENDYOL_DEBUG),
+        maxRetries: parsePositiveInt(overrides?.maxRetries?.toString() ?? process.env.TRENDYOL_MAX_RETRIES, TRENDYOL_DEFAULT_MAX_RETRIES),
+        retryBaseMs: parsePositiveInt(overrides?.retryBaseMs?.toString() ?? process.env.TRENDYOL_RETRY_BASE_MS, TRENDYOL_DEFAULT_RETRY_BASE_MS),
+        enableClientSideLimiter: overrides?.enableClientSideLimiter ??
+            parseBoolean(process.env.TRENDYOL_ENABLE_CLIENT_LIMITER),
+        maxWebhookBodyBytes: parsePositiveInt(overrides?.maxWebhookBodyBytes?.toString() ??
+            process.env.TRENDYOL_MAX_WEBHOOK_BYTES, TRENDYOL_DEFAULT_MAX_WEBHOOK_BYTES),
+    };
+}
+export function isTrendyolConfigured() {
+    try {
+        getTrendyolConfig();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function buildBasicAuthHeader(apiKey, apiSecret) {
+    const token = Buffer.from(`${apiKey}:${apiSecret}`, "utf8").toString("base64");
+    return `Basic ${token}`;
+}
+export function buildUserAgent(integratorName, sellerId) {
+    return `${integratorName} - ${sellerId}`;
+}
+export function resolveGatewayUrl(config, path) {
+    const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+    return `${config.gatewayBase}${normalizedPath}`;
+}

package/dist/connection.d.ts

@@ -0,0 +1,4 @@
+import type { TrendyolHttpClient } from "./http.js";
+import type { CategoryTreeResponse, TrendyolResult } from "./types.js";
+export declare function testConnection(http: TrendyolHttpClient): Promise<TrendyolResult<CategoryTreeResponse>>;
+//# sourceMappingURL=connection.d.ts.map

package/dist/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEvE,wBAAsB,cAAc,CAClC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC,CAM/C"}

package/dist/connection.js

@@ -0,0 +1,8 @@
+import { TRENDYOL_TEST_CONNECTION_PATH } from "./constants.js";
+export async function testConnection(http) {
+    return http.requestJson({
+        method: "GET",
+        path: TRENDYOL_TEST_CONNECTION_PATH,
+        retryPolicy: "safe",
+    });
+}

package/dist/constants/claim-reasons.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Iade sebepleri — resmi liste (developers.trendyol.com/docs/iade-sebepleri).
+ * getClaims response icindeki customerClaimItemReason / trendyolClaimItemReason
+ * externalReasonId ile eslesir.
+ */
+export declare const CLAIM_REASONS: ReadonlyArray<{
+    id: number;
+    name: string;
+}>;
+//# sourceMappingURL=claim-reasons.d.ts.map

package/dist/constants/claim-reasons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-reasons.d.ts","sourceRoot":"","sources":["../../src/constants/claim-reasons.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAqC5D,CAAC"}

package/dist/constants/claim-reasons.js

@@ -0,0 +1,43 @@
+/**
+ * Iade sebepleri — resmi liste (developers.trendyol.com/docs/iade-sebepleri).
+ * getClaims response icindeki customerClaimItemReason / trendyolClaimItemReason
+ * externalReasonId ile eslesir.
+ */
+export const CLAIM_REASONS = [
+    { id: 51, name: "Sebep Yok" },
+    { id: 101, name: "Depo Kayip" },
+    { id: 151, name: "Capraz Hatali" },
+    { id: 201, name: "Musteri Iade Kayip" },
+    { id: 251, name: "Modelini begenmedim" },
+    { id: 301, name: "Kusurlu urun gonderildi" },
+    { id: 351, name: "Yanlis urun gonderildi" },
+    { id: 401, name: "Vazgecdim" },
+    { id: 451, name: "Diger" },
+    { id: 501, name: "Bedeni kucuk geldi" },
+    { id: 551, name: "Bedeni buyuk geldi" },
+    { id: 651, name: "Urun belirtilen ozelliklere sahip degil" },
+    { id: 701, name: "Yanlis siparis verdim" },
+    { id: 751, name: "Diger - Fraud Kaynakli" },
+    { id: 1651, name: "Kalitesini begenmedim" },
+    { id: 1701, name: "Kargo Teslimati Gecikmesi" },
+    { id: 2000, name: "Cezali Onay" },
+    { id: 2001, name: "Cezasiz Onay" },
+    { id: 2002, name: "Teknik Servis Destegi Gerekiyor" },
+    { id: 2003, name: "Kullanilmis Urun Sebepli Red" },
+    { id: 2004, name: "Hijyenik Sebepli Red" },
+    { id: 2005, name: "Analiz sonucu uretimden kaynakli sorun yok" },
+    { id: 2006, name: "Analiz Degisim" },
+    { id: 2007, name: "Analiz Tamirat" },
+    { id: 2008, name: "Urunde adet/aksesuar eksigi" },
+    { id: 2009, name: "Firmaya ait olmayan urun" },
+    { id: 2010, name: "Tekrar Sevk" },
+    { id: 2011, name: "Satici Tarafindan Aksiyona Cekilen" },
+    { id: 2012, name: "Iade Suresi Gecmis" },
+    { id: 2013, name: "Urun Musteride" },
+    { id: 2014, name: "Analize Gonder" },
+    { id: 2015, name: "Teslim edilemeyen gonderi" },
+    { id: 2017, name: "Tazmin" },
+    { id: 2030, name: "Daha iyi bir fiyat mevcut" },
+    { id: 2042, name: "Begenmedim" },
+    { id: 2043, name: "Urunumun parcasi/aksesuari eksik gonderildi" },
+];

package/dist/constants/error-codes.d.ts

@@ -0,0 +1,3 @@
+export declare const TRENDYOL_ERROR_CODES: Record<string, string>;
+export declare function lookupErrorMessage(code: string | number | undefined): string | undefined;
+//# sourceMappingURL=error-codes.d.ts.map

package/dist/constants/error-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/constants/error-codes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAIvD,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGxF"}

package/dist/constants/error-codes.js

@@ -0,0 +1,9 @@
+export const TRENDYOL_ERROR_CODES = {
+    COMMON_LABEL_NOT_ALLOWED: "Ortak etiket bu paket için kullanılamaz.",
+    INVOICE_NUMBER_ALREADY_EXISTS: "Ayni fatura numarasi daha once kullanilmis; yeni numara gerekir.",
+};
+export function lookupErrorMessage(code) {
+    if (code === undefined)
+        return undefined;
+    return TRENDYOL_ERROR_CODES[String(code)];
+}

package/dist/constants/origins.d.ts

@@ -0,0 +1,6 @@
+/** Statik menşei ISO-2 tablosu — resmi dokümandan genişletilir. */
+export declare const ORIGIN_COUNTRIES: ReadonlyArray<{
+    code: string;
+    name: string;
+}>;
+//# sourceMappingURL=origins.d.ts.map

package/dist/constants/origins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"origins.d.ts","sourceRoot":"","sources":["../../src/constants/origins.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAIjE,CAAC"}

package/dist/constants/origins.js

@@ -0,0 +1,6 @@
+/** Statik menşei ISO-2 tablosu — resmi dokümandan genişletilir. */
+export const ORIGIN_COUNTRIES = [
+    { code: "TR", name: "Türkiye" },
+    { code: "DE", name: "Almanya" },
+    { code: "CN", name: "Çin" },
+];

package/dist/constants/package-status.d.ts

@@ -0,0 +1,3 @@
+export declare const PACKAGE_STATUSES: readonly ["Created", "Picking", "Invoiced", "Shipped", "Cancelled", "Delivered", "UnDelivered", "Returned", "UnSupplied", "AtCollectionPoint", "UnPacked", "Awaiting", "Verified"];
+export type PackageStatus = (typeof PACKAGE_STATUSES)[number];
+//# sourceMappingURL=package-status.d.ts.map

package/dist/constants/package-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-status.d.ts","sourceRoot":"","sources":["../../src/constants/package-status.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,oLAcnB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/constants/package-status.js

@@ -0,0 +1,15 @@
+export const PACKAGE_STATUSES = [
+    "Created",
+    "Picking",
+    "Invoiced",
+    "Shipped",
+    "Cancelled",
+    "Delivered",
+    "UnDelivered",
+    "Returned",
+    "UnSupplied",
+    "AtCollectionPoint",
+    "UnPacked",
+    "Awaiting",
+    "Verified",
+];

package/dist/constants/page-limits.d.ts

@@ -0,0 +1,3 @@
+export type PageLimitEndpoint = "orders" | "products" | "claims" | "qna" | "finance.paymentOrder" | "brands" | "default";
+export declare const MAX_PAGE_SIZE: Record<PageLimitEndpoint, number>;
+//# sourceMappingURL=page-limits.d.ts.map

package/dist/constants/page-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-limits.d.ts","sourceRoot":"","sources":["../../src/constants/page-limits.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,KAAK,GACL,sBAAsB,GACtB,QAAQ,GACR,SAAS,CAAC;AAEd,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAQ3D,CAAC"}

package/dist/constants/page-limits.js

@@ -0,0 +1,9 @@
+export const MAX_PAGE_SIZE = {
+    orders: 200,
+    products: 200,
+    claims: 200,
+    qna: 50,
+    "finance.paymentOrder": 10,
+    brands: 1000,
+    default: 100,
+};

package/dist/constants.d.ts

@@ -0,0 +1,18 @@
+export declare const TRENDYOL_PROD_GATEWAY = "https://apigw.trendyol.com";
+export declare const TRENDYOL_STAGE_GATEWAY = "https://stageapigw.trendyol.com";
+export declare const TRENDYOL_INTEGRATION_PREFIX = "/integration";
+export declare const TRENDYOL_WEBHOOK_PREFIX = "/integration/webhook";
+export declare const TRENDYOL_FINANCE_PREFIX = "/integration/finance/che";
+export declare const TRENDYOL_VIDEO_PREFIX = "/integration/video";
+export declare const TRENDYOL_DEFAULT_INTEGRATOR = "SelfIntegration";
+export declare const TRENDYOL_DEFAULT_STORE_FRONT = "TR";
+export declare const TRENDYOL_DEFAULT_TIMEOUT_MS = 30000;
+export declare const TRENDYOL_DEFAULT_MAX_RETRIES = 3;
+export declare const TRENDYOL_DEFAULT_RETRY_BASE_MS = 500;
+export declare const TRENDYOL_RETRY_DELAY_CAP_MS = 30000;
+export declare const TRENDYOL_DEFAULT_MAX_WEBHOOK_BYTES: number;
+/** Canonical testConnection path (side-effect free). */
+export declare const TRENDYOL_TEST_CONNECTION_PATH = "/integration/product/product-categories";
+/** @deprecated sapigw host — kullanilmaz. */
+export declare const TRENDYOL_DEPRECATED_SAPIGW_HOST = "api.trendyol.com";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,+BAA+B,CAAC;AAClE,eAAO,MAAM,sBAAsB,oCAAoC,CAAC;AAExE,eAAO,MAAM,2BAA2B,iBAAiB,CAAC;AAC1D,eAAO,MAAM,uBAAuB,yBAAyB,CAAC;AAC9D,eAAO,MAAM,uBAAuB,6BAA6B,CAAC;AAClE,eAAO,MAAM,qBAAqB,uBAAuB,CAAC;AAE1D,eAAO,MAAM,2BAA2B,oBAAoB,CAAC;AAC7D,eAAO,MAAM,4BAA4B,OAAO,CAAC;AAEjD,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAClD,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAClD,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAElD,eAAO,MAAM,kCAAkC,QAAkB,CAAC;AAElE,wDAAwD;AACxD,eAAO,MAAM,6BAA6B,4CAA4C,CAAC;AAEvF,6CAA6C;AAC7C,eAAO,MAAM,+BAA+B,qBAAqB,CAAC"}

package/dist/constants.js

@@ -0,0 +1,17 @@
+export const TRENDYOL_PROD_GATEWAY = "https://apigw.trendyol.com";
+export const TRENDYOL_STAGE_GATEWAY = "https://stageapigw.trendyol.com";
+export const TRENDYOL_INTEGRATION_PREFIX = "/integration";
+export const TRENDYOL_WEBHOOK_PREFIX = "/integration/webhook";
+export const TRENDYOL_FINANCE_PREFIX = "/integration/finance/che";
+export const TRENDYOL_VIDEO_PREFIX = "/integration/video";
+export const TRENDYOL_DEFAULT_INTEGRATOR = "SelfIntegration";
+export const TRENDYOL_DEFAULT_STORE_FRONT = "TR";
+export const TRENDYOL_DEFAULT_TIMEOUT_MS = 30_000;
+export const TRENDYOL_DEFAULT_MAX_RETRIES = 3;
+export const TRENDYOL_DEFAULT_RETRY_BASE_MS = 500;
+export const TRENDYOL_RETRY_DELAY_CAP_MS = 30_000;
+export const TRENDYOL_DEFAULT_MAX_WEBHOOK_BYTES = 2 * 1024 * 1024;
+/** Canonical testConnection path (side-effect free). */
+export const TRENDYOL_TEST_CONNECTION_PATH = "/integration/product/product-categories";
+/** @deprecated sapigw host — kullanilmaz. */
+export const TRENDYOL_DEPRECATED_SAPIGW_HOST = "api.trendyol.com";

package/dist/errors.d.ts

@@ -0,0 +1,27 @@
+import type { TrendyolResult } from "./types.js";
+export declare class TrendyolApiError extends Error {
+    code?: string | number;
+    status: number;
+    raw?: unknown;
+    retryable: boolean;
+    constructor(message: string, options: {
+        status: number;
+        code?: string | number;
+        raw?: unknown;
+        retryable?: boolean;
+    });
+}
+export declare class TrendyolTransportError extends Error {
+    retryable: boolean;
+    constructor(message: string, options?: {
+        retryable?: boolean;
+    });
+}
+export declare function isHtmlErrorBody(body: unknown): boolean;
+export declare function isHtmlGatewayError(error: unknown): boolean;
+export declare function isTransientGatewayError(error: unknown): boolean;
+export declare function parseApiError(status: number, body: unknown, headers?: Headers): TrendyolApiError;
+export declare function isRetryableStatus(status: number): boolean;
+export declare function isRetryableError(error: unknown): boolean;
+export declare function toFailure<T>(error: unknown, fallbackReason?: string): TrendyolResult<T>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;gBAGjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACvB,GAAG,CAAC,EAAE,OAAO,CAAC;QACd,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB;CASJ;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,SAAS,EAAE,OAAO,CAAC;gBAEP,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE;CAK/D;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAItD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAU1D;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK/D;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,OAAO,GAChB,gBAAgB,CAyBlB;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAiBxD;AAED,wBAAgB,SAAS,CAAC,CAAC,EACzB,KAAK,EAAE,OAAO,EACd,cAAc,SAA+B,GAC5C,cAAc,CAAC,CAAC,CAAC,CA6BnB"}