@hubcommerce/trendyol 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,47 @@
+# Changelog
+
+Bu proje [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) formatını izler.
+Sürümleme [Semantic Versioning](https://semver.org/spec/v2.0.0.html) uyumludur.
+
+## [1.0.0] - 2026-08-27
+
+### Added
+
+- TR Marketplace Integration API tam kapsam (~77 REST metodu)
+- Sipariş: stream/cursor, v2, 14 mutasyon, 4 split varyantı, lookback buffer
+- Fatura: link, dosya upload, silme; CONFORMANCE re-upload notları
+- Stok/fiyat: `updatePriceAndInventory` (max 1000 SKU)
+- Referans: marka, kategori, attribute, adres (TTL cache), geo, kargo sağlayıcıları
+- Ürün V2: CRUD, bulk update, buybox, batch poll + partial fail raporu
+- Video API + `waitForVideoReady` poll
+- Garanti belgesi upload
+- İade (Claims): liste, oluşturma, onay, issue multipart
+- Webhook CRUD + inbound parse/verify (`parseWebhookPayload`, `verifyWebhookApiKey`)
+- Finans: payment-order, settlements, otherfinancials, kargo faturası, settlement helper
+- QnA: soru listesi, cevap
+- Ortak etiket: ZPL + AB ihracat varyantı; `isCommonLabelNotAllowed`
+- TEX tazmin ticket listesi
+- `@hubcommerce/trendyol/testing` subpath: stage helpers, fixture export, production guard
+- Statik sabitler: `CLAIM_REASONS`, `ORIGIN_COUNTRIES`, `TRENDYOL_ERROR_CODES`, `PACKAGE_STATUSES`
+- HTTP lifecycle: `combineAbortSignals`, HTML gateway retry, transport errors
+- Query serialization: Date ms, array CSV
+- Client-side rate limit governor (opsiyonel, varsayılan kapalı)
+- `qa:smoke` — getting-started 5 sütun checklist
+- Tam dokümantasyon: `CONFORMANCE`, `QA`, `MIGRATION`, `ADAPTER-CONTRACT`, `DOC-SOURCES`
+
+### Notes
+
+- npm paket adı: `@hubcommerce/trendyol` (org `@commerce` npm'de alinmis)
+- V1 ürün/sipariş endpoint'leri export edilmez
+- sapigw host kullanılmaz
+- Bilinçli hariç: AutoFT, International, E-Faturam
+
+## [0.1.0] - 2026-08-27
+
+### Added
+
+- Faz 0 iskelet: HTTP lifecycle, multipart, batch partial report, stream lookback, fixture export
+- CONFORMANCE / ADAPTER-CONTRACT iskelet
+
+[1.0.0]: https://github.com/commerce-packages/trendyol/compare/v0.1.0...v1.0.0
+[0.1.0]: https://github.com/commerce-packages/trendyol/releases/tag/v0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,257 @@
+# @hubcommerce/trendyol
+
+Trendyol TR Marketplace Integration API SDK.
+
+> **Yalnızca server-side kullanın.** API key/secret tarayıcıda, mobil uygulamada veya public repo'da **asla** bulunmamalı.
+
+- Node `>=20.10.0` · ESM-only (`"type": "module"`) · sıfır runtime dependency
+- `TrendyolResult<T>` — throw yerine `ok` / `error`
+- ~77 documented REST metodu + batch poll, stream, webhook inbound
+
+Detay: [`docs/CONFORMANCE.md`](./docs/CONFORMANCE.md) · [`docs/QA.md`](./docs/QA.md) · [`docs/MIGRATION.md`](./docs/MIGRATION.md)
+
+---
+
+## Kurulum
+
+```powershell
+npm install @hubcommerce/trendyol
+```
+
+Monorepo yerel:
+
+```powershell
+npm install file:../commerce-packages/marketplace/trendyol
+```
+
+---
+
+## Yapılandırma
+
+`.env.example` dosyasını kopyalayın:
+
+```powershell
+copy marketplace\trendyol\.env.example .env
+```
+
+| Değişken | Açıklama |
+|----------|----------|
+| `TRENDYOL_ENV` | `stage` veya `production` |
+| `TRENDYOL_SELLER_ID` | Satıcı ID |
+| `TRENDYOL_API_KEY` | API key |
+| `TRENDYOL_API_SECRET` | API secret |
+| `TRENDYOL_INTEGRATOR_NAME` | Varsayılan `SelfIntegration` |
+| `TRENDYOL_STORE_FRONT_CODE` | Varsayılan `TR` |
+
+### Gateway URL matrisi
+
+| Ortam | Gateway |
+|-------|---------|
+| Production | `https://apigw.trendyol.com` |
+| Stage | `https://stageapigw.trendyol.com` |
+
+Eski `api.trendyol.com/sapigw` **kullanılmaz**.
+
+Stage IP whitelist gerekir — değişiklik ~24 saat gecikebilir ([QA.md](./docs/QA.md)).
+
+---
+
+## Hızlı başlangıç
+
+```typescript
+import { createTrendyolClient } from "@hubcommerce/trendyol";
+
+const client = createTrendyolClient({
+  sellerId: process.env.TRENDYOL_SELLER_ID!,
+  apiKey: process.env.TRENDYOL_API_KEY!,
+  apiSecret: process.env.TRENDYOL_API_SECRET!,
+  env: "stage",
+});
+
+const conn = await client.testConnection();
+if (!conn.ok) {
+  console.error(conn.error.message);
+}
+```
+
+---
+
+## Modül örnekleri
+
+### Sipariş stream (birincil senkron)
+
+Trendyol önerisi: **webhook + periyodik stream/poll** birlikte kullanın.
+
+```typescript
+import { createTrendyolClient } from "@hubcommerce/trendyol";
+
+const client = createTrendyolClient();
+
+for await (const page of client.orders.streamPackages({
+  lookbackMs: 300_000, // varsayılan 5 dk — saat kayması için
+  size: 50,
+  onCursorSave: (cursor) => {
+    // adapter: cursor'u DB'ye persist et
+  },
+})) {
+  for (const pkg of page.content ?? []) {
+    console.log(pkg.id, pkg.status);
+  }
+}
+```
+
+### Stok / fiyat
+
+```typescript
+const result = await client.inventory.updatePriceAndInventory([
+  { barcode: "8683772071724", quantity: 10, salePrice: 99.9, listPrice: 129.9 },
+]);
+
+// quantity: 0 → satış durabilir (JSDoc uyarısı)
+```
+
+### Ürün oluşturma + batch poll
+
+```typescript
+import { validateEan13 } from "@hubcommerce/trendyol";
+
+if (!validateEan13("8683772071724")) throw new Error("Geçersiz barkod");
+
+const submit = await client.products.createProducts([/* ProductCreateItem[] */]);
+if (!submit.ok) throw submit.error;
+
+const batch = await client.batch.waitForResult(submit.data.batchRequestId, {
+  intervalMs: 2000,
+  timeoutMs: 120_000,
+});
+
+if (batch.ok && batch.data.failedItemCount > 0) {
+  // partial fail — adapter başarısız barkodları işler
+  console.log(batch.data.items?.filter((i) => i.status === "FAILED"));
+}
+```
+
+### Webhook inbound
+
+```typescript
+import {
+  parseWebhookPayload,
+  verifyWebhookApiKey,
+} from "@hubcommerce/trendyol";
+
+// HTTP handler (adapter katmanında)
+if (!verifyWebhookApiKey(req.headers, process.env.WEBHOOK_API_KEY!)) {
+  return res.status(401).end();
+}
+
+const parsed = parseWebhookPayload(req.body);
+if (!parsed.ok) {
+  return res.status(400).json({ error: parsed.error });
+}
+
+// adapter: dedup + iş kuyruğu
+const pkg = parsed.data;
+```
+
+### Fatura
+
+```typescript
+// Invoiced statü ≠ fatura gönderimi — iki ayrı adım
+await client.orders.updatePackageStatus(packageId, { status: "Invoiced", lines: [...] });
+
+await client.invoices.sendInvoiceLink({
+  shipmentPackageId: packageId,
+  invoiceLink: "https://...",
+  invoiceNumber: "INV-2026-001",
+});
+```
+
+### Finans
+
+```typescript
+const orders = await client.finance.getPaymentOrders({ size: 10 });
+if (orders.ok && orders.data.content?.[0]) {
+  const paymentOrderId = orders.data.content[0].paymentOrderId;
+  const details = await client.finance.getSettlementDetails(paymentOrderId);
+}
+```
+
+### Ortak etiket (TEX / Aras, Trendyol öder)
+
+```typescript
+import { isCommonLabelNotAllowed } from "@hubcommerce/trendyol";
+
+const created = await client.labels.createCommonLabel(cargoTrackingNumber);
+if (!created.ok && isCommonLabelNotAllowed(created)) {
+  // capability yok — alternatif kargo akışı
+}
+
+const label = await client.labels.getCommonLabel(cargoTrackingNumber);
+
+// AB ihracat varyantı
+await client.labels.getCommonLabelWithAbProduct(cargoTrackingNumber, {
+  productLabelType: "ZPL",
+});
+```
+
+---
+
+## Stage test helpers
+
+```typescript
+import { createTestOrder, SHIPMENT_PACKAGE_FIXTURE } from "@hubcommerce/trendyol/testing";
+```
+
+**Yalnızca stage** — production config ile runtime guard throw eder.
+
+---
+
+## Geliştirme
+
+```powershell
+npm run build --workspace=@hubcommerce/trendyol
+npm test --workspace=@hubcommerce/trendyol
+npm run test:exports --workspace=@hubcommerce/trendyol
+npm run qa:smoke --workspace=@hubcommerce/trendyol
+```
+
+---
+
+## Public API yüzeyi
+
+Facade client domain modülleri:
+
+| Modül | Açıklama |
+|-------|----------|
+| `client.orders` | Stream, mutasyon, split |
+| `client.invoices` | Link, dosya, silme |
+| `client.inventory` | Fiyat/stok toplu |
+| `client.reference` | Marka, kategori, adres, geo |
+| `client.products` | V2 CRUD, filter, buybox |
+| `client.batch` | `waitForResult` poll |
+| `client.video` | Video upload + poll |
+| `client.warranty` | Garanti belgesi |
+| `client.claims` | İade |
+| `client.webhooks` | CRUD |
+| `client.finance` | Hakedis, settlements |
+| `client.qna` | Müşteri soruları |
+| `client.labels` | Ortak etiket ZPL |
+| `client.compensation` | TEX tazmin |
+| `client.testConnection()` | Canonical bağlantı testi |
+
+Root export helper'lar: `parseWebhookPayload`, `verifyWebhookApiKey`, `validateEan13`, `buildProductCreatePayload`, statik sabitler (`CLAIM_REASONS`, `ORIGIN_COUNTRIES`, …).
+
+---
+
+## Migration
+
+- Ürün V1 kapanış: **15 Eylül 2026**
+- Sipariş V1 kapanış: **15 Ekim 2026**
+
+Detay: [`docs/MIGRATION.md`](./docs/MIGRATION.md)
+
+---
+
+## Lisans
+
+MIT — [`LICENSE`](./LICENSE)

package/dist/batch/poller.d.ts

@@ -0,0 +1,23 @@
+import { parseBatchRequestReport, type BatchRequestReport } from "./report.js";
+import type { TrendyolHooks, TrendyolResult } from "../types.js";
+export type WaitForBatchOptions = {
+    intervalMs?: number;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+};
+export type BatchResultFetcher = (batchRequestId: string, signal?: AbortSignal) => Promise<TrendyolResult<BatchRequestReport>>;
+/**
+ * Product batch async poll — sonuc TTL ~4 saat.
+ *
+ * Ayni batchRequestId ile eszamanli poll → client instance'ta paylasilan in-flight promise.
+ */
+export declare class BatchPoller {
+    private readonly fetchResult;
+    private readonly getHooks;
+    private readonly inFlight;
+    constructor(fetchResult: BatchResultFetcher, getHooks: () => TrendyolHooks);
+    waitForResult(batchRequestId: string, options?: WaitForBatchOptions): Promise<TrendyolResult<BatchRequestReport>>;
+    private pollUntilTerminal;
+}
+export { parseBatchRequestReport };
+//# sourceMappingURL=poller.d.ts.map

package/dist/batch/poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poller.d.ts","sourceRoot":"","sources":["../../src/batch/poller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEjE,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAYF,MAAM,MAAM,kBAAkB,GAAG,CAC/B,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC,CAAC;AAEjD;;;;GAIG;AACH,qBAAa,WAAW;IAOpB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAP3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAGrB;gBAGe,WAAW,EAAE,kBAAkB,EAC/B,QAAQ,EAAE,MAAM,aAAa;IAGhD,aAAa,CACX,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;YAchC,iBAAiB;CA6ChC;AAiBD,OAAO,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/batch/poller.js

@@ -0,0 +1,85 @@
+import { parseBatchRequestReport } from "./report.js";
+const DEFAULT_INTERVAL_MS = 2_000;
+const DEFAULT_TIMEOUT_MS = 120_000;
+const TERMINAL_BATCH_STATUSES = new Set([
+    "COMPLETED",
+    "FAILED",
+    "CANCELLED",
+    "CANCELED",
+]);
+/**
+ * Product batch async poll — sonuc TTL ~4 saat.
+ *
+ * Ayni batchRequestId ile eszamanli poll → client instance'ta paylasilan in-flight promise.
+ */
+export class BatchPoller {
+    fetchResult;
+    getHooks;
+    inFlight = new Map();
+    constructor(fetchResult, getHooks) {
+        this.fetchResult = fetchResult;
+        this.getHooks = getHooks;
+    }
+    waitForResult(batchRequestId, options) {
+        const existing = this.inFlight.get(batchRequestId);
+        if (existing) {
+            return existing;
+        }
+        const promise = this.pollUntilTerminal(batchRequestId, options);
+        this.inFlight.set(batchRequestId, promise);
+        void promise.finally(() => {
+            this.inFlight.delete(batchRequestId);
+        });
+        return promise;
+    }
+    async pollUntilTerminal(batchRequestId, options) {
+        const intervalMs = options?.intervalMs ?? DEFAULT_INTERVAL_MS;
+        const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        const deadline = Date.now() + timeoutMs;
+        let attempt = 0;
+        while (Date.now() < deadline) {
+            if (options?.signal?.aborted) {
+                return { ok: false, reason: "Batch poll iptal edildi.", code: "ABORTED" };
+            }
+            this.getHooks().onBatchPoll?.({ batchRequestId, attempt });
+            attempt += 1;
+            const result = await this.fetchResult(batchRequestId, options?.signal);
+            if (!result.ok) {
+                return result;
+            }
+            const report = result.data;
+            const status = report.status?.toUpperCase();
+            if (status && TERMINAL_BATCH_STATUSES.has(status)) {
+                return { ok: true, data: report };
+            }
+            try {
+                await sleep(intervalMs, options?.signal);
+            }
+            catch (error) {
+                if (error instanceof DOMException && error.name === "AbortError") {
+                    return { ok: false, reason: "Batch poll iptal edildi.", code: "ABORTED" };
+                }
+                throw error;
+            }
+        }
+        return {
+            ok: false,
+            reason: `Batch poll zaman asimi (${timeoutMs}ms): ${batchRequestId}`,
+            code: "BATCH_POLL_TIMEOUT",
+        };
+    }
+}
+async function sleep(ms, signal) {
+    if (signal?.aborted) {
+        throw new DOMException("Aborted", "AbortError");
+    }
+    await new Promise((resolve, reject) => {
+        const timer = setTimeout(resolve, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(new DOMException("Aborted", "AbortError"));
+        };
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+export { parseBatchRequestReport };

package/dist/batch/report.d.ts

@@ -0,0 +1,15 @@
+export type BatchItemResult = {
+    barcode?: string;
+    status?: string;
+    failureReasons?: string[];
+};
+export type BatchRequestReport = {
+    status?: string;
+    itemCount?: number;
+    failedItemCount?: number;
+    items?: BatchItemResult[];
+};
+export declare function parseBatchRequestReport(raw: unknown): BatchRequestReport;
+export declare function hasPartialBatchFailures(report: BatchRequestReport): boolean;
+export declare function collectBatchFailureReasons(report: BatchRequestReport): string[];
+//# sourceMappingURL=report.d.ts.map

package/dist/batch/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/batch/report.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,eAAe,EAAE,CAAC;CAC3B,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CAgBxE;AAkBD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAE3E;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAQ/E"}

package/dist/batch/report.js

@@ -0,0 +1,41 @@
+export function parseBatchRequestReport(raw) {
+    if (!raw || typeof raw !== "object") {
+        return {};
+    }
+    const record = raw;
+    const items = Array.isArray(record.items)
+        ? record.items.map(parseBatchItem)
+        : undefined;
+    return {
+        status: typeof record.status === "string" ? record.status : undefined,
+        itemCount: typeof record.itemCount === "number" ? record.itemCount : undefined,
+        failedItemCount: typeof record.failedItemCount === "number" ? record.failedItemCount : undefined,
+        items,
+    };
+}
+function parseBatchItem(raw) {
+    if (!raw || typeof raw !== "object") {
+        return {};
+    }
+    const record = raw;
+    const failureReasons = Array.isArray(record.failureReasons)
+        ? record.failureReasons.filter((r) => typeof r === "string")
+        : undefined;
+    return {
+        barcode: typeof record.barcode === "string" ? record.barcode : undefined,
+        status: typeof record.status === "string" ? record.status : undefined,
+        failureReasons,
+    };
+}
+export function hasPartialBatchFailures(report) {
+    return (report.failedItemCount ?? 0) > 0;
+}
+export function collectBatchFailureReasons(report) {
+    const reasons = [];
+    for (const item of report.items ?? []) {
+        for (const reason of item.failureReasons ?? []) {
+            reasons.push(reason);
+        }
+    }
+    return reasons;
+}

package/dist/batch/types.d.ts

@@ -0,0 +1,4 @@
+export type { BatchItemResult, BatchRequestReport } from "./report.js";
+export { collectBatchFailureReasons, hasPartialBatchFailures, parseBatchRequestReport, } from "./report.js";
+export { BatchPoller, type WaitForBatchOptions } from "./poller.js";
+//# sourceMappingURL=types.d.ts.map

package/dist/batch/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/batch/types.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/batch/types.js

@@ -0,0 +1,2 @@
+export { collectBatchFailureReasons, hasPartialBatchFailures, parseBatchRequestReport, } from "./report.js";
+export { BatchPoller } from "./poller.js";

package/dist/claims/api.d.ts

@@ -0,0 +1,48 @@
+import type { TrendyolHttpClient } from "../http.js";
+import type { TrendyolConfig, TrendyolResult } from "../types.js";
+import type { ApproveClaimLineItemsBody, ClaimIssueReason, ClaimItemAudit, ClaimsListResponse, CreateClaimBody, CreateClaimIssueFields, CreateClaimResponse, GetClaimsParams } from "../types/claims.js";
+type ClaimOptions = {
+    signal?: AbortSignal;
+};
+/**
+ * Iade (claims) domain API.
+ */
+export declare class ClaimsApi {
+    private readonly http;
+    private readonly config;
+    constructor(http: TrendyolHttpClient, config: TrendyolConfig);
+    /**
+     * Iade edilen siparisleri sayfali listeler.
+     * GET /integration/order/sellers/{sellerId}/claims
+     */
+    getClaims(params?: GetClaimsParams): Promise<TrendyolResult<ClaimsListResponse>>;
+    /**
+     * Iade kodu olmadan gelen paketler icin iade talebi olusturur.
+     * POST .../claims/create
+     */
+    createClaim(body: CreateClaimBody, options?: ClaimOptions): Promise<TrendyolResult<CreateClaimResponse>>;
+    /**
+     * Depoya iade edilen siparisleri onaylar.
+     * PUT .../claims/{claimId}/items/approve
+     *
+     * Rate limit: 5 istek/dk (Trendyol dokumani).
+     */
+    approveClaimLineItems(claimId: string, body: ApproveClaimLineItemsBody, options?: ClaimOptions): Promise<TrendyolResult<unknown>>;
+    /**
+     * Iade ret talebi olusturur — multipart/form-data.
+     * POST .../claims/{claimId}/issue
+     */
+    createClaimIssue(claimId: string, fields: CreateClaimIssueFields, options?: ClaimOptions): Promise<TrendyolResult<unknown>>;
+    /**
+     * Iade red sebeplerini listeler (global endpoint).
+     * GET /integration/order/claim-issue-reasons
+     */
+    getClaimIssueReasons(options?: ClaimOptions): Promise<TrendyolResult<ClaimIssueReason[]>>;
+    /**
+     * Iade kalemi audit gecmisini getirir.
+     * GET .../claims/items/{claimItemsId}/audit
+     */
+    getClaimItemAudits(claimItemsId: string, options?: ClaimOptions): Promise<TrendyolResult<ClaimItemAudit[]>>;
+}
+export {};
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/claims/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,yBAAyB,EACzB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAK5B,KAAK,YAAY,GAAG;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAgB7C;;GAEG;AACH,qBAAa,SAAS;IAElB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,cAAc;IAGzC;;;OAGG;IACH,SAAS,CACP,MAAM,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;IAgB9C;;;OAGG;IACH,WAAW,CACT,IAAI,EAAE,eAAe,EACrB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC;IAU/C;;;;;OAKG;IACH,qBAAqB,CACnB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,yBAAyB,EAC/B,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAUnC;;;OAGG;IACH,gBAAgB,CACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAUnC;;;OAGG;IACH,oBAAoB,CAClB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,cAAc,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAS9C;;;OAGG;IACH,kBAAkB,CAChB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,cAAc,CAAC,cAAc,EAAE,CAAC,CAAC;CAQ7C"}

package/dist/claims/api.js

@@ -0,0 +1,116 @@
+import { validatePageSize } from "../validate.js";
+import { buildClaimIssueFormData } from "./form.js";
+import { claimIssueReasonsPath, claimsBase } from "./paths.js";
+function buildClaimsQuery(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;
+    if (params.claimItemStatus !== undefined) {
+        query.claimItemStatus = params.claimItemStatus;
+    }
+    if (params.orderNumber !== undefined)
+        query.orderNumber = params.orderNumber;
+    if (params.claimIds !== undefined)
+        query.claimIds = params.claimIds;
+    return query;
+}
+/**
+ * Iade (claims) domain API.
+ */
+export class ClaimsApi {
+    http;
+    config;
+    constructor(http, config) {
+        this.http = http;
+        this.config = config;
+    }
+    /**
+     * Iade edilen siparisleri sayfali listeler.
+     * GET /integration/order/sellers/{sellerId}/claims
+     */
+    getClaims(params) {
+        const size = params?.size ?? 50;
+        const pageValidation = validatePageSize("claims", size);
+        if (!pageValidation.ok) {
+            return Promise.resolve(pageValidation);
+        }
+        return this.http.requestJson({
+            method: "GET",
+            path: claimsBase(this.config.sellerId),
+            query: buildClaimsQuery({ ...params, size }),
+            retryPolicy: "safe",
+            signal: params?.signal,
+        });
+    }
+    /**
+     * Iade kodu olmadan gelen paketler icin iade talebi olusturur.
+     * POST .../claims/create
+     */
+    createClaim(body, options) {
+        return this.http.requestJson({
+            method: "POST",
+            path: `${claimsBase(this.config.sellerId)}/create`,
+            body,
+            retryPolicy: "none",
+            signal: options?.signal,
+        });
+    }
+    /**
+     * Depoya iade edilen siparisleri onaylar.
+     * PUT .../claims/{claimId}/items/approve
+     *
+     * Rate limit: 5 istek/dk (Trendyol dokumani).
+     */
+    approveClaimLineItems(claimId, body, options) {
+        return this.http.requestJson({
+            method: "PUT",
+            path: `${claimsBase(this.config.sellerId)}/${claimId}/items/approve`,
+            body,
+            retryPolicy: "none",
+            signal: options?.signal,
+        });
+    }
+    /**
+     * Iade ret talebi olusturur — multipart/form-data.
+     * POST .../claims/{claimId}/issue
+     */
+    createClaimIssue(claimId, fields, options) {
+        return this.http.requestMultipart({
+            method: "POST",
+            path: `${claimsBase(this.config.sellerId)}/${claimId}/issue`,
+            formData: buildClaimIssueFormData(fields),
+            retryPolicy: "none",
+            signal: options?.signal,
+        });
+    }
+    /**
+     * Iade red sebeplerini listeler (global endpoint).
+     * GET /integration/order/claim-issue-reasons
+     */
+    getClaimIssueReasons(options) {
+        return this.http.requestJson({
+            method: "GET",
+            path: claimIssueReasonsPath(),
+            retryPolicy: "safe",
+            signal: options?.signal,
+        });
+    }
+    /**
+     * Iade kalemi audit gecmisini getirir.
+     * GET .../claims/items/{claimItemsId}/audit
+     */
+    getClaimItemAudits(claimItemsId, options) {
+        return this.http.requestJson({
+            method: "GET",
+            path: `${claimsBase(this.config.sellerId)}/items/${claimItemsId}/audit`,
+            retryPolicy: "safe",
+            signal: options?.signal,
+        });
+    }
+}