@lonca/trendyol 0.10.0 → 0.11.1

package/README.md

@@ -8,35 +8,38 @@
 
 Type-safe TypeScript SDK for the [Trendyol Marketplace API](https://developers.trendyol.com).
 
-> **`0.6.0` — Trendyol surface complete.** 14 resources, ~70 typed methods, plus a `parseWebhookEvent` helper for inbound event handling. Every endpoint a non-AutoFT non-V1 seller can hit is covered.
+> [!IMPORTANT]
+> **Unofficial.** This is an independent, community-maintained SDK. It is not affiliated with, endorsed by, or supported by Trendyol. "Trendyol" and related names are trademarks of their respective owners.
+
+> **Trendyol surface complete.** 16 resources spanning catalog, orders, claims, finance, webhooks, and Export Center, plus a `parseWebhookEvent` helper for inbound event handling. Every endpoint a non-AutoFT non-V1 seller can hit is covered. See the [npm badge](https://www.npmjs.com/package/@lonca/trendyol) above for the current release.
 
 ## Coverage
 
-Each entry is a method on the client. Endpoints marked `★` are discovery-first wire-verified against live Trendyol STAGE — the SDK normalizes any spec/wire mismatch.
+Each entry is a method on the client.
 
 | Resource         | Methods                                                                                                                                                                                                                                                                                                                            |
 | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `brands`         | `list()`, `search(name)` ★                                                                                                                                                                                                                                                                                                         |
-| `categories`     | `list()`, `getAttributes(id)`, `getAttributeValues(catId, attrId)` ★, `getByBarcodes(barcodes)` (AutoFT)                                                                                                                                                                                                                           |
+| `brands`         | `list()`, `search(name)`                                                                                                                                                                                                                                                                                                           |
+| `categories`     | `list()`, `getAttributes(id)`, `getAttributeValues(catId, attrId)`, `getByBarcodes(barcodes)` (AutoFT)                                                                                                                                                                                                                             |
 | `suppliers`      | `getAddresses({forceRefresh?})` (1-hour cache; rate-limited 1 req/hour on Trendyol)                                                                                                                                                                                                                                                |
-| `products` read  | `list({...})` ★, `listUnapproved({...})` ★, `getBase(barcode)` ★, `getBuyboxInfo(barcodes)` ★, `getBatchStatus(id)` ★                                                                                                                                                                                                              |
-| `products` write | `create(items)`, `updateContent(items)`, `updateVariants(items)`, `updateUnapproved(items)` ★, `updateDeliveryInfo(items)`                                                                                                                                                                                                         |
+| `products` read  | `list({...})`, `listInventoryAndPrice({...})` (lightweight stock + price), `listUnapproved({...})`, `getBase(barcode)`, `getBuyboxInfo(barcodes)`, `getBatchStatus(id)`                                                                                                                                                            |
+| `products` write | `create(items)`, `updateContent(items)`, `updateVariants(items)`, `updateUnapproved(items)`, `updateDeliveryInfo(items)`                                                                                                                                                                                                           |
 | `products` life  | `delete(barcodes)`, `archive(barcodes)`, `unarchive(barcodes)`, `unlock(barcodes)`                                                                                                                                                                                                                                                 |
-| `inventory`      | `update(items)` ★ (stock + price, async batch)                                                                                                                                                                                                                                                                                     |
-| `orders` read    | `list({...})` ★, `listStream({...})` ★ (opaque cursor for >10K), `getCargoInvoiceItems(serial, {...})`                                                                                                                                                                                                                             |
+| `inventory`      | `update(items)` (stock + price, async batch)                                                                                                                                                                                                                                                                                       |
+| `orders` read    | `list({...})`, `listStream({...})` (opaque cursor for >10K), `getCargoInvoiceItems(serial, {...})`                                                                                                                                                                                                                                 |
 | `orders` write   | `updatePackageStatus(id, {...})`, `cancelPackageItem(id, {...})`, `extendDeliveryDate(id, 1\|2\|3)`, `processAlternativeDelivery(id, {...})`                                                                                                                                                                                       |
 | `orders` split   | `splitPackage`, `splitPackageByQuantity`, `multiSplitPackage`, `splitMultiPackagesByQuantity` (4 variants)                                                                                                                                                                                                                         |
 | `orders` cargo   | `changeCargoProvider(id, code)`, `manualDeliverByPackageId(id)`, `manualDeliverByTrackingNumber(trk)`, `markDeliveredByService(id)`                                                                                                                                                                                                |
 | `orders` ops     | `updateBoxInfo(id, {...})`, `updateLaborCosts(id, items)`, `updateWarehouse(id, warehouseId)`                                                                                                                                                                                                                                      |
 | `orders` returns | `manualReturnByPackageId(id)`, `manualReturnByTrackingNumber(trk)`, `getCompensationTickets({...})` (TEX)                                                                                                                                                                                                                          |
-| `claims`         | `create({...})`, `createIssue(id, {...})` (multipart), `approveLineItems(id, {...})`, `list({...})`, `getIssueReasons()` ★, `getItemAudits(itemId)` ★                                                                                                                                                                              |
+| `claims`         | `create({...})`, `createIssue(id, {...})` (multipart), `approveLineItems(id, {...})`, `list({...})`, `getIssueReasons()`, `getItemAudits(itemId)`                                                                                                                                                                                  |
 | `webhooks`       | `create({...})`, `list()`, `update(id, {...})`, `delete(id)`, `activate(id)`, `deactivate(id)`                                                                                                                                                                                                                                     |
-| `questions`      | `get(id)`, `list({...})` ★, `answer(id, text)`                                                                                                                                                                                                                                                                                     |
+| `questions`      | `get(id)`, `list({...})`, `answer(id, text)`                                                                                                                                                                                                                                                                                       |
 | `invoices`       | `uploadFile({shipmentPackageId, file, ...})` (multipart), `sendLink({...})`, `deleteLink({...})`                                                                                                                                                                                                                                   |
-| `finance`        | `getSettlements({...})`, `getOtherFinancials({...})` — both return typed `FinancialTransaction[]` ★                                                                                                                                                                                                                                |
-| `labels`         | `createCommon(trackingNumber, {format: 'ZPL', ...})`, `getCommon(trackingNumber)` ★                                                                                                                                                                                                                                                |
+| `finance`        | `getSettlements({...})`, `getOtherFinancials({...})` — both return typed `FinancialTransaction[]`                                                                                                                                                                                                                                  |
+| `labels`         | `createCommon(trackingNumber, {format: 'ZPL', ...})`, `getCommon(trackingNumber)`                                                                                                                                                                                                                                                  |
 | `testOrders`     | `create({...})`, `updateStatus(id, status)`, `setClaimsWaitingInAction()` — **STAGE-only utility**                                                                                                                                                                                                                                 |
-| `locations`      | `getCountries()` ★, `getTurkeyCities()` ★, `getTurkeyDistricts(cityCode)`, `getTurkeyNeighborhoods(cityCode, districtCode)`, `getAzerbaijanCities()`, `getAzerbaijanDistricts(...)`, `getCitiesByCountry/getDistrictsByCity(...)`                                                                                                  |
+| `locations`      | `getCountries()`, `getTurkeyCities()`, `getTurkeyDistricts(cityCode)`, `getTurkeyNeighborhoods(cityCode, districtCode)`, `getAzerbaijanCities()`, `getAzerbaijanDistricts(...)`, `getCitiesByCountry/getDistrictsByCity(...)`                                                                                                      |
 | `exportCenter`   | `listProducts({...})`, `createProducts(items)`, `updatePrices(items)`, `updateStocks(items)`, `getBatchStatus(batchId)`, `listPackagesV2/V3({...})`, `getPackageItems({packageId, ...})`, `getCategoryAttributes(id)`, `getCareInstructions()`, `getCompositions()`, `getOrigins()` — **Trendyol Export Center / İhracat Merkezi** |
 | `videos`         | `create({contentId, url, ...})`, `list({id?, sellerIntegrationStatus?, ...})` — product-page video upload + status                                                                                                                                                                                                                 |
 | **top-level**    | `parseWebhookEvent(rawBody)`, `normalizeShipmentPackage(rawNode)` — for inbound webhook handlers                                                                                                                                                                                                                                   |
@@ -238,6 +241,7 @@ await client.suppliers.getAddresses({ forceRefresh: true });
 
 // products — read
 await client.products.list({ barcode: 'BC1' });
+await client.products.listInventoryAndPrice({ status: 'onSale', limit: 100 }); // stock + price only
 await client.products.listUnapproved({ limit: 50 });
 await client.products.getBase('BC1');
 await client.products.getBuyboxInfo(['BC1', 'BC2']); // max 10 per call
@@ -379,25 +383,6 @@ const status = await client.products.getBatchStatus(batchRequestId);
 
 **Important:** Trendyol's overall batch `status` can lag at `PROCESSING` even after each `items[].status` has settled. Trust the per-item status, or re-read the affected products via `list({ barcode })` / `getBase(barcode)` to verify the change landed. Batch results are retained for **4 hours** on Trendyol's side.
 
-## Discovery-first wire fixes
-
-`@lonca/trendyol` was built by hitting the live Trendyol STAGE for every endpoint before writing types. Places where the official OpenAPI spec disagrees with the live wire are normalized automatically:
-
-- `categories.getAttributeValues`: spec says `attributeValueName`, wire returns `attributeValue` → SDK normalizes to `{ id, name }`
-- `products.listUnapproved`: spec says `media: [{url}]`, wire returns `images: [{url}]` → SDK exposes `images: string[]`
-- `products.getBuyboxInfo`: wire returns extra `secondBuyboxPrice` / `thirdBuyboxPrice` fields beyond spec → both surfaced
-- `products.updateUnapproved`: spec marks only `barcode` required, but live endpoint returns HTTP 500 (`TypeError`) when too many optional fields are omitted → documented in JSDoc
-- `brands.search`: docs claim case-sensitive exact match, live is substring + case-insensitive → documented in JSDoc
-- `getBatchRequestResult`: returns `PROCESSING + empty items` for unknown batch IDs (not 404)
-- `orders.listStream` returns package ID as `id`, regular `orders.list` returns it as `shipmentPackageId` → normalizer accepts both
-- `orders.updateLaborCosts`: body is a **raw array** (no `{ items: [...] }` envelope) — only endpoint in the surface that does this
-- `getCompensationTickets`: spec says `{ data: { items: [] } }`, but SDK also accepts `{ data: [] }` and `{ content: [] }` defensively
-- `labels.getCommon`: response is `{ data: [{ label, format }] }` → SDK surfaces `labels[]` for ergonomic access
-- `finance.*`: both `getSettlements` and `getOtherFinancials` share the same `FinancialTransaction` wire schema → unified typed surface
-- `webhooks.list`: SDK accepts 3 envelope shapes (`[]` raw, `{ webhooks: [] }`, `{ content: [] }`) and 3 active-flag spellings (`active`, `isActive`, `status: 'ACTIVE'`)
-
-Each fix is pinned by a regression mock test using the exact STAGE shape.
-
 ## Authentication
 
 Trendyol uses HTTP Basic Auth. Get your `sellerId`, `apiKey`, and `apiSecret` from the [Trendyol Partner Panel → Account Info → Integration Information](https://partner.trendyol.com/account/info?tab=integrationInformation) (master-user only).
@@ -413,7 +398,7 @@ Trendyol uses HTTP Basic Auth. Get your `sellerId`, `apiKey`, and `apiSecret` fr
 
 ## Built-in robustness
 
-- **Retry with exponential backoff** on 429 (respects `Retry-After`) and 5xx
+- **Idempotency-aware retry with exponential backoff** — reads (`GET`) retry on 429 (honoring `Retry-After`), 5xx, and network/timeout errors. Writes (`POST`/`PUT`/`DELETE`) retry **only** on 429, which the server rejects before processing; ambiguous 5xx/network/timeout failures on a write are not replayed, so a transient error can't duplicate an order action or stock/price push. A `Retry-After: 0` no longer collapses backoff to an immediate retry.
 - **Per-endpoint rate limiting** (token bucket) sized to Trendyol's documented limits — see defaults below; override per resource
 - **Per-request correlation ID** — every call gets a UUID surfaced in log messages and the `x-correlationid` header for Trendyol-side log tracing
 - **Structured errors** via `@lonca/core` (`AuthError`, `RateLimitError`, `NotFoundError`, `ServerError`, `ValidationError`, `NetworkError`, `TimeoutError`)

package/dist/{client-0omWgpd_.d.cts → client-CCA1P7sb.d.cts}

@@ -1,4 +1,4 @@
-import { Logger, TokenBucketRateLimiter, CursorPaginationParams, CursorPage, OffsetPaginationParams } from '@lonca/core';
+import { Logger, BaseRequestOptions, TokenBucketRateLimiter, CursorPaginationParams, CursorPage, OffsetPaginationParams } from '@lonca/core';
 
 declare const BASE_URLS: {
     readonly prod: "https://apigw.trendyol.com";
@@ -18,29 +18,22 @@ interface TransportConfig {
     /** Override the underlying `fetch` (tests inject a mock). */
     fetch?: typeof fetch;
 }
-interface RequestOptions {
+interface RequestOptions extends BaseRequestOptions {
     method: 'GET' | 'POST' | 'PUT' | 'DELETE';
     /** Path beginning with `/` (e.g., `/sapigw/brands`). */
     path: string;
     query?: Record<string, string | number | boolean | undefined>;
-    body?: unknown;
-    signal?: AbortSignal;
-    /** Per-endpoint rate limiter; acquire one token before each attempt. */
-    rateLimiter?: TokenBucketRateLimiter;
 }
 declare class TrendyolTransport {
     private readonly config;
     private readonly baseUrl;
-    private readonly logger;
-    private readonly timeoutMs;
-    private readonly fetchImpl;
+    private readonly requester;
     constructor(config: TransportConfig);
     /** Seller ID this transport is configured with. Resources read it for path-building. */
     get sellerId(): number;
     request<T>(opts: RequestOptions): Promise<T>;
     private buildUrl;
     private buildHeaders;
-    private composeSignal;
 }
 
 /**
@@ -84,7 +77,7 @@ declare class BrandsResource {
      * `createProducts` and don't want to page through the full `list()`
      * (1000 brands per page).
      *
-     * **Discovery-first wire fact (verified STAGE 2026-05-25):** Trendyol's
+     * **Wire fact (verified STAGE 2026-05-25):** Trendyol's
      * doc claims this is a case-sensitive *exact* match, but live behaviour
      * is **substring + case-insensitive** — `search('Trendyol')` returns
      * 17 hits including `TRENDYOLMILLA`, `trendyol vavist`, `Trendyol Üyelik`.
@@ -937,6 +930,51 @@ interface UnapprovedProduct {
     /** Untouched raw response. */
     raw: Record<string, unknown>;
 }
+/**
+ * Listing-status filter accepted by `filterProducts` inventory-and-price.
+ *
+ * Trendyol documents `archived`, `blacklisted`, `locked`, `onSale`, and
+ * `notOnSale`. Open (`string & {}`) so a value Trendyol adds later still
+ * type-checks.
+ */
+type ApprovedProductStatus = 'archived' | 'blacklisted' | 'locked' | 'onSale' | 'notOnSale' | (string & {});
+/**
+ * A single variant's stock + price, returned by
+ * `products.listInventoryAndPrice` (Trendyol's lightweight
+ * `inventory-and-price` filter). Intentionally narrow: this endpoint returns
+ * only pricing + stock, not the full product/variant shape exposed by
+ * {@link ProductVariant}.
+ */
+interface ProductStockPriceVariant {
+    variantId: string;
+    barcode: string;
+    /** Sale price (price the customer pays). */
+    salePrice?: number;
+    /** List price (pre-discount reference price). */
+    listPrice?: number;
+    /** Stock quantity. */
+    quantity?: number;
+    stockCode?: string;
+    /**
+     * ISO 8601 UTC string (from `stockLastModifiedDate` ms-epoch). Absent when
+     * the variant's stock has never been updated (Trendyol returns `null`).
+     */
+    stockLastModifiedAt?: string;
+    /** Untouched raw response. */
+    raw: Record<string, unknown>;
+}
+/**
+ * An approved product's stock + price, returned by
+ * `products.listInventoryAndPrice`. Slimmer than {@link Product} — it carries
+ * only the identifiers and the per-variant stock/price.
+ */
+interface ProductStockPrice {
+    contentId: string;
+    productMainId: string;
+    variants: ProductStockPriceVariant[];
+    /** Untouched raw response. */
+    raw: Record<string, unknown>;
+}
 /**
  * Basic lifecycle info for a single product, returned by `getProductBase`.
  *
@@ -1541,13 +1579,19 @@ declare function normalizeShipmentPackage(rawNode: unknown): ShipmentPackage;
 /**
  * Trendyol order (shipment-package) endpoints.
  *
- * Rate limit (per Trendyol service limits): scheduled to tighten on 2026-05-15;
- * for now we set a generous default that the user can tune via the constructor.
+ * Rate limit (per Trendyol service limits): tunable via the constructor with a
+ * generous default.
+ *
+ * Pagination: `getShipmentPackages` (`list`) uses page-based pagination (not
+ * nextPageToken). The SDK exposes `CursorPage<ShipmentPackage>` so the caller
+ * can iterate with `paginate()` from `@lonca/core`; the opaque cursor encodes
+ * the page index.
  *
- * Pagination: Trendyol uses page-based pagination here (not nextPageToken).
- * The SDK still exposes `CursorPage<ShipmentPackage>` so the caller can
- * iterate with `paginate()` from `@lonca/core`; the opaque cursor encodes the
- * page index.
+ * **2026-06-08 limit:** `getShipmentPackages` reaches at most 10,000 records —
+ * requests past that offset return HTTP 429. For full scans, periodic syncs, or
+ * exports use {@link OrdersResource.listStream} (`getShipmentPackagesStream`),
+ * which paginates with an opaque cursor and is not subject to the cap. Note the
+ * stream endpoint exposes only the last 3 months of orders.
  */
 declare class OrdersResource {
     private readonly transport;
@@ -1902,6 +1946,32 @@ interface ListProductsParams extends CursorPaginationParams {
     /** Filter products updated on or before this date. */
     endDate?: Date;
 }
+/**
+ * Filters for `products.listInventoryAndPrice` (Trendyol's lightweight
+ * `inventory-and-price` approved-product filter). All filters are optional;
+ * pass none to page through every approved product's stock + price.
+ */
+interface ListInventoryAndPriceParams extends CursorPaginationParams {
+    /** Filter by a single barcode. */
+    barcode?: string;
+    /** Filter by a single contentId. */
+    contentId?: string;
+    /** Filter by the seller's stock code. */
+    stockCode?: string;
+    /** Filter by the seller's productMainId. */
+    productMainId?: string;
+    /** Filter by listing status (archived / blacklisted / locked / onSale / notOnSale). */
+    status?: ApprovedProductStatus;
+    /**
+     * Sort by `SellerCreatedDate`. `ASC` = oldest→newest, `DESC` = newest→oldest.
+     */
+    orderByDirection?: 'ASC' | 'DESC';
+    /**
+     * Storefront code sent as the `storeFrontCode` header. Required on the
+     * International marketplace; optional on the Türkiye marketplace.
+     */
+    storeFrontCode?: string;
+}
 /** Date field to filter against on `listUnapproved` (default: server choice). */
 type UnapprovedDateQueryType = 'CREATED_DATE' | 'LAST_MODIFIED_DATE';
 interface ListUnapprovedProductsParams extends CursorPaginationParams {
@@ -1962,6 +2032,35 @@ declare class ProductsResource {
      * ```
      */
     list(params?: ListProductsParams): Promise<CursorPage<Product>>;
+    /**
+     * List **stock and price** for approved products — Trendyol's lightweight
+     * `inventory-and-price` filter. A slim alternative to {@link list} when you
+     * only need pricing + stock: the response carries `contentId`,
+     * `productMainId`, and a `variants[]` array with `barcode`, `salePrice`,
+     * `listPrice`, `quantity`, `stockCode`, and `stockLastModifiedAt` — nothing
+     * else.
+     *
+     * Filter by `barcode`, `contentId`, `stockCode`, `productMainId`, or listing
+     * `status`. Sort with `orderByDirection` (`SellerCreatedDate`). `size` caps
+     * at **100** here (tighter than `list`'s 1000).
+     *
+     * Pagination follows the same convention as {@link list}: pass our opaque
+     * `cursor` from the previous response and we forward it as `nextPageToken`
+     * (required once the dataset exceeds 10,000 items).
+     *
+     * @example
+     * ```ts
+     * import { paginate } from '@lonca/core';
+     * for await (const p of paginate((q) =>
+     *   client.products.listInventoryAndPrice({ ...q, status: 'onSale' }),
+     * )) {
+     *   for (const v of p.variants) {
+     *     console.log(v.barcode, v.quantity, v.salePrice);
+     *   }
+     * }
+     * ```
+     */
+    listInventoryAndPrice(params?: ListInventoryAndPriceParams): Promise<CursorPage<ProductStockPrice>>;
     /**
      * Poll a batch request returned by an async write (e.g. `createProducts`,
      * `updatePriceAndInventory`).
@@ -2523,4 +2622,4 @@ interface TrendyolClient {
  */
 declare function createTrendyolClient(opts: CreateClientOptions): TrendyolClient;
 
-export { type GetExportPackageItemsParams as $, type ApproveClaimLineItemsInput as A, type BarcodeCategoryLookup as B, type CancelPackageItemInput as C, type CreateClaimInput as D, type CreateClaimIssueInput as E, type CreateClaimItemInput as F, type CreateClientOptions as G, type CreateCommonLabelInput as H, type CreateProductV2Input as I, type CreateTestOrderInput as J, type CreateVideoInput as K, type DeleteInvoiceLinkInput as L, type DeliveryOptionInput as M, type District as N, type ExportBatchAcceptedResponse as O, type ExportBatchStatus as P, type ExportCategoryAttribute as Q, ExportCenterResource as R, type ExportPackage as S, type ExportPackageItem as T, type ExportPackageStatus as U, type ExportPriceUpdateInput as V, type ExportProduct as W, type ExportProductInput as X, type ExportStockUpdateInput as Y, FinanceResource as Z, type FinancialTransaction as _, type BatchAcceptedResponse as a, type TrendyolClient as a$, InventoryResource as a0, InvoicesResource as a1, type KnownShipmentPackageStatus as a2, LabelsResource as a3, type LaborCostInput as a4, type ListCategoryAttributeValuesParams as a5, type ListClaimsParams as a6, type ListCompensationTicketsParams as a7, type ListExportPackagesV2Params as a8, type ListExportPackagesV3Params as a9, type ProductBase as aA, type ProductComposition as aB, type ProductImageInput as aC, type ProductOrigin as aD, type ProductVariant as aE, ProductsResource as aF, type QuantitySplit as aG, type Question as aH, type QuestionAnswer as aI, type QuestionStatus as aJ, QuestionsResource as aK, type SellerIntegrationStatus as aL, type SellerVideo as aM, type SendInvoiceLinkInput as aN, type SettlementRow as aO, type ShipmentPackage as aP, type ShipmentPackageStatus as aQ, type SplitGroup as aR, type SplitPackagePlan as aS, type SupplierAddress as aT, type SupplierAddressType as aU, SuppliersResource as aV, type SuppliersResourceOptions as aW, type TestOrderStatus as aX, TestOrdersResource as aY, type TrendyolCapabilities as aZ, type TrendyolCargoProvider as a_, type ListExportProductsParams as aa, type ListFinanceParams as ab, type ListOrdersParams as ac, type ListOrdersStreamParams as ad, type ListProductsParams as ae, type ListQuestionsParams as af, type ListUnapprovedProductsParams as ag, type ListVideosParams as ah, LocationsResource as ai, type NamedRef as aj, type Neighborhood as ak, type OrderAddress as al, type OrderAddressLines as am, type OrderCustomer as an, type OrderLine as ao, type OrderLineDiscountDetail as ap, OrdersResource as aq, type OtherFinancialRow as ar, type PackageDetail as as, type PackageHistoryEntry as at, type PackageLineUpdate as au, type PriceInventoryUpdate as av, type ProcessAlternativeDeliveryInput as aw, type Product as ax, type ProductAttribute as ay, type ProductAttributeV2Input as az, type BatchPollOptions as b, type TrendyolEnvironment as b0, type UnapprovedDateQueryType as b1, type UnapprovedProduct as b2, type UnapprovedProductRejectReason as b3, type UnapprovedProductStatus as b4, type UpdateBoxInfoInput as b5, type UpdateContentInput as b6, type UpdateDeliveryInfoInput as b7, type UpdatePackageStatusInput as b8, type UpdatePriceInventoryResponse as b9, type UpdateUnapprovedInput as ba, type UpdateVariantInput as bb, type UploadInvoiceFileInput as bc, VideosResource as bd, type Webhook as be, type WebhookAuthenticationType as bf, type WebhookInput as bg, WebhooksResource as bh, createTrendyolClient as bi, normalizeShipmentPackage as bj, pollBatchStatus as bk, trendyolCapabilities as bl, type BatchRequestItemResult as c, type BatchRequestResult as d, type BatchRequestStatus as e, type Brand as f, BrandsResource as g, type BuyboxInfo as h, type CareInstruction as i, type CargoInvoiceItem as j, CategoriesResource as k, type Category as l, type CategoryAttribute as m, type CategoryAttributeValue as n, type City as o, type Claim as p, type ClaimIssueReason as q, type ClaimItemAudit as r, type ClaimItemStatus as s, ClaimsResource as t, type CommonLabel as u, type CommonLabelEntry as v, type CompensationItemDetail as w, type CompensationTicket as x, type CompensationTicketState as y, type Country as z };
+export { type FinancialTransaction as $, type ApproveClaimLineItemsInput as A, type BarcodeCategoryLookup as B, type CancelPackageItemInput as C, type Country as D, type CreateClaimInput as E, type CreateClaimIssueInput as F, type CreateClaimItemInput as G, type CreateClientOptions as H, type CreateCommonLabelInput as I, type CreateProductV2Input as J, type CreateTestOrderInput as K, type CreateVideoInput as L, type DeleteInvoiceLinkInput as M, type DeliveryOptionInput as N, type District as O, type ExportBatchAcceptedResponse as P, type ExportBatchStatus as Q, type ExportCategoryAttribute as R, ExportCenterResource as S, type ExportPackage as T, type ExportPackageItem as U, type ExportPackageStatus as V, type ExportPriceUpdateInput as W, type ExportProduct as X, type ExportProductInput as Y, type ExportStockUpdateInput as Z, FinanceResource as _, type ApprovedProductStatus as a, type TestOrderStatus as a$, type GetExportPackageItemsParams as a0, InventoryResource as a1, InvoicesResource as a2, type KnownShipmentPackageStatus as a3, LabelsResource as a4, type LaborCostInput as a5, type ListCategoryAttributeValuesParams as a6, type ListClaimsParams as a7, type ListCompensationTicketsParams as a8, type ListExportPackagesV2Params as a9, type ProductAttribute as aA, type ProductAttributeV2Input as aB, type ProductBase as aC, type ProductComposition as aD, type ProductImageInput as aE, type ProductOrigin as aF, type ProductStockPrice as aG, type ProductStockPriceVariant as aH, type ProductVariant as aI, ProductsResource as aJ, type QuantitySplit as aK, type Question as aL, type QuestionAnswer as aM, type QuestionStatus as aN, QuestionsResource as aO, type SellerIntegrationStatus as aP, type SellerVideo as aQ, type SendInvoiceLinkInput as aR, type SettlementRow as aS, type ShipmentPackage as aT, type ShipmentPackageStatus as aU, type SplitGroup as aV, type SplitPackagePlan as aW, type SupplierAddress as aX, type SupplierAddressType as aY, SuppliersResource as aZ, type SuppliersResourceOptions as a_, type ListExportPackagesV3Params as aa, type ListExportProductsParams as ab, type ListFinanceParams as ac, type ListInventoryAndPriceParams as ad, type ListOrdersParams as ae, type ListOrdersStreamParams as af, type ListProductsParams as ag, type ListQuestionsParams as ah, type ListUnapprovedProductsParams as ai, type ListVideosParams as aj, LocationsResource as ak, type NamedRef as al, type Neighborhood as am, type OrderAddress as an, type OrderAddressLines as ao, type OrderCustomer as ap, type OrderLine as aq, type OrderLineDiscountDetail as ar, OrdersResource as as, type OtherFinancialRow as at, type PackageDetail as au, type PackageHistoryEntry as av, type PackageLineUpdate as aw, type PriceInventoryUpdate as ax, type ProcessAlternativeDeliveryInput as ay, type Product as az, type BatchAcceptedResponse as b, TestOrdersResource as b0, type TrendyolCapabilities as b1, type TrendyolCargoProvider as b2, type TrendyolClient as b3, type TrendyolEnvironment as b4, type UnapprovedDateQueryType as b5, type UnapprovedProduct as b6, type UnapprovedProductRejectReason as b7, type UnapprovedProductStatus as b8, type UpdateBoxInfoInput as b9, type UpdateContentInput as ba, type UpdateDeliveryInfoInput as bb, type UpdatePackageStatusInput as bc, type UpdatePriceInventoryResponse as bd, type UpdateUnapprovedInput as be, type UpdateVariantInput as bf, type UploadInvoiceFileInput as bg, VideosResource as bh, type Webhook as bi, type WebhookAuthenticationType as bj, type WebhookInput as bk, WebhooksResource as bl, createTrendyolClient as bm, normalizeShipmentPackage as bn, pollBatchStatus as bo, trendyolCapabilities as bp, type BatchPollOptions as c, type BatchRequestItemResult as d, type BatchRequestResult as e, type BatchRequestStatus as f, type Brand as g, BrandsResource as h, type BuyboxInfo as i, type CareInstruction as j, type CargoInvoiceItem as k, CategoriesResource as l, type Category as m, type CategoryAttribute as n, type CategoryAttributeValue as o, type City as p, type Claim as q, type ClaimIssueReason as r, type ClaimItemAudit as s, type ClaimItemStatus as t, ClaimsResource as u, type CommonLabel as v, type CommonLabelEntry as w, type CompensationItemDetail as x, type CompensationTicket as y, type CompensationTicketState as z };

package/dist/{client-0omWgpd_.d.ts → client-CCA1P7sb.d.ts}

@@ -1,4 +1,4 @@
-import { Logger, TokenBucketRateLimiter, CursorPaginationParams, CursorPage, OffsetPaginationParams } from '@lonca/core';
+import { Logger, BaseRequestOptions, TokenBucketRateLimiter, CursorPaginationParams, CursorPage, OffsetPaginationParams } from '@lonca/core';
 
 declare const BASE_URLS: {
     readonly prod: "https://apigw.trendyol.com";
@@ -18,29 +18,22 @@ interface TransportConfig {
     /** Override the underlying `fetch` (tests inject a mock). */
     fetch?: typeof fetch;
 }
-interface RequestOptions {
+interface RequestOptions extends BaseRequestOptions {
     method: 'GET' | 'POST' | 'PUT' | 'DELETE';
     /** Path beginning with `/` (e.g., `/sapigw/brands`). */
     path: string;
     query?: Record<string, string | number | boolean | undefined>;
-    body?: unknown;
-    signal?: AbortSignal;
-    /** Per-endpoint rate limiter; acquire one token before each attempt. */
-    rateLimiter?: TokenBucketRateLimiter;
 }
 declare class TrendyolTransport {
     private readonly config;
     private readonly baseUrl;
-    private readonly logger;
-    private readonly timeoutMs;
-    private readonly fetchImpl;
+    private readonly requester;
     constructor(config: TransportConfig);
     /** Seller ID this transport is configured with. Resources read it for path-building. */
     get sellerId(): number;
     request<T>(opts: RequestOptions): Promise<T>;
     private buildUrl;
     private buildHeaders;
-    private composeSignal;
 }
 
 /**
@@ -84,7 +77,7 @@ declare class BrandsResource {
      * `createProducts` and don't want to page through the full `list()`
      * (1000 brands per page).
      *
-     * **Discovery-first wire fact (verified STAGE 2026-05-25):** Trendyol's
+     * **Wire fact (verified STAGE 2026-05-25):** Trendyol's
      * doc claims this is a case-sensitive *exact* match, but live behaviour
      * is **substring + case-insensitive** — `search('Trendyol')` returns
      * 17 hits including `TRENDYOLMILLA`, `trendyol vavist`, `Trendyol Üyelik`.
@@ -937,6 +930,51 @@ interface UnapprovedProduct {
     /** Untouched raw response. */
     raw: Record<string, unknown>;
 }
+/**
+ * Listing-status filter accepted by `filterProducts` inventory-and-price.
+ *
+ * Trendyol documents `archived`, `blacklisted`, `locked`, `onSale`, and
+ * `notOnSale`. Open (`string & {}`) so a value Trendyol adds later still
+ * type-checks.
+ */
+type ApprovedProductStatus = 'archived' | 'blacklisted' | 'locked' | 'onSale' | 'notOnSale' | (string & {});
+/**
+ * A single variant's stock + price, returned by
+ * `products.listInventoryAndPrice` (Trendyol's lightweight
+ * `inventory-and-price` filter). Intentionally narrow: this endpoint returns
+ * only pricing + stock, not the full product/variant shape exposed by
+ * {@link ProductVariant}.
+ */
+interface ProductStockPriceVariant {
+    variantId: string;
+    barcode: string;
+    /** Sale price (price the customer pays). */
+    salePrice?: number;
+    /** List price (pre-discount reference price). */
+    listPrice?: number;
+    /** Stock quantity. */
+    quantity?: number;
+    stockCode?: string;
+    /**
+     * ISO 8601 UTC string (from `stockLastModifiedDate` ms-epoch). Absent when
+     * the variant's stock has never been updated (Trendyol returns `null`).
+     */
+    stockLastModifiedAt?: string;
+    /** Untouched raw response. */
+    raw: Record<string, unknown>;
+}
+/**
+ * An approved product's stock + price, returned by
+ * `products.listInventoryAndPrice`. Slimmer than {@link Product} — it carries
+ * only the identifiers and the per-variant stock/price.
+ */
+interface ProductStockPrice {
+    contentId: string;
+    productMainId: string;
+    variants: ProductStockPriceVariant[];
+    /** Untouched raw response. */
+    raw: Record<string, unknown>;
+}
 /**
  * Basic lifecycle info for a single product, returned by `getProductBase`.
  *
@@ -1541,13 +1579,19 @@ declare function normalizeShipmentPackage(rawNode: unknown): ShipmentPackage;
 /**
  * Trendyol order (shipment-package) endpoints.
  *
- * Rate limit (per Trendyol service limits): scheduled to tighten on 2026-05-15;
- * for now we set a generous default that the user can tune via the constructor.
+ * Rate limit (per Trendyol service limits): tunable via the constructor with a
+ * generous default.
+ *
+ * Pagination: `getShipmentPackages` (`list`) uses page-based pagination (not
+ * nextPageToken). The SDK exposes `CursorPage<ShipmentPackage>` so the caller
+ * can iterate with `paginate()` from `@lonca/core`; the opaque cursor encodes
+ * the page index.
  *
- * Pagination: Trendyol uses page-based pagination here (not nextPageToken).
- * The SDK still exposes `CursorPage<ShipmentPackage>` so the caller can
- * iterate with `paginate()` from `@lonca/core`; the opaque cursor encodes the
- * page index.
+ * **2026-06-08 limit:** `getShipmentPackages` reaches at most 10,000 records —
+ * requests past that offset return HTTP 429. For full scans, periodic syncs, or
+ * exports use {@link OrdersResource.listStream} (`getShipmentPackagesStream`),
+ * which paginates with an opaque cursor and is not subject to the cap. Note the
+ * stream endpoint exposes only the last 3 months of orders.
  */
 declare class OrdersResource {
     private readonly transport;
@@ -1902,6 +1946,32 @@ interface ListProductsParams extends CursorPaginationParams {
     /** Filter products updated on or before this date. */
     endDate?: Date;
 }
+/**
+ * Filters for `products.listInventoryAndPrice` (Trendyol's lightweight
+ * `inventory-and-price` approved-product filter). All filters are optional;
+ * pass none to page through every approved product's stock + price.
+ */
+interface ListInventoryAndPriceParams extends CursorPaginationParams {
+    /** Filter by a single barcode. */
+    barcode?: string;
+    /** Filter by a single contentId. */
+    contentId?: string;
+    /** Filter by the seller's stock code. */
+    stockCode?: string;
+    /** Filter by the seller's productMainId. */
+    productMainId?: string;
+    /** Filter by listing status (archived / blacklisted / locked / onSale / notOnSale). */
+    status?: ApprovedProductStatus;
+    /**
+     * Sort by `SellerCreatedDate`. `ASC` = oldest→newest, `DESC` = newest→oldest.
+     */
+    orderByDirection?: 'ASC' | 'DESC';
+    /**
+     * Storefront code sent as the `storeFrontCode` header. Required on the
+     * International marketplace; optional on the Türkiye marketplace.
+     */
+    storeFrontCode?: string;
+}
 /** Date field to filter against on `listUnapproved` (default: server choice). */
 type UnapprovedDateQueryType = 'CREATED_DATE' | 'LAST_MODIFIED_DATE';
 interface ListUnapprovedProductsParams extends CursorPaginationParams {
@@ -1962,6 +2032,35 @@ declare class ProductsResource {
      * ```
      */
     list(params?: ListProductsParams): Promise<CursorPage<Product>>;
+    /**
+     * List **stock and price** for approved products — Trendyol's lightweight
+     * `inventory-and-price` filter. A slim alternative to {@link list} when you
+     * only need pricing + stock: the response carries `contentId`,
+     * `productMainId`, and a `variants[]` array with `barcode`, `salePrice`,
+     * `listPrice`, `quantity`, `stockCode`, and `stockLastModifiedAt` — nothing
+     * else.
+     *
+     * Filter by `barcode`, `contentId`, `stockCode`, `productMainId`, or listing
+     * `status`. Sort with `orderByDirection` (`SellerCreatedDate`). `size` caps
+     * at **100** here (tighter than `list`'s 1000).
+     *
+     * Pagination follows the same convention as {@link list}: pass our opaque
+     * `cursor` from the previous response and we forward it as `nextPageToken`
+     * (required once the dataset exceeds 10,000 items).
+     *
+     * @example
+     * ```ts
+     * import { paginate } from '@lonca/core';
+     * for await (const p of paginate((q) =>
+     *   client.products.listInventoryAndPrice({ ...q, status: 'onSale' }),
+     * )) {
+     *   for (const v of p.variants) {
+     *     console.log(v.barcode, v.quantity, v.salePrice);
+     *   }
+     * }
+     * ```
+     */
+    listInventoryAndPrice(params?: ListInventoryAndPriceParams): Promise<CursorPage<ProductStockPrice>>;
     /**
      * Poll a batch request returned by an async write (e.g. `createProducts`,
      * `updatePriceAndInventory`).
@@ -2523,4 +2622,4 @@ interface TrendyolClient {
  */
 declare function createTrendyolClient(opts: CreateClientOptions): TrendyolClient;
 
-export { type GetExportPackageItemsParams as $, type ApproveClaimLineItemsInput as A, type BarcodeCategoryLookup as B, type CancelPackageItemInput as C, type CreateClaimInput as D, type CreateClaimIssueInput as E, type CreateClaimItemInput as F, type CreateClientOptions as G, type CreateCommonLabelInput as H, type CreateProductV2Input as I, type CreateTestOrderInput as J, type CreateVideoInput as K, type DeleteInvoiceLinkInput as L, type DeliveryOptionInput as M, type District as N, type ExportBatchAcceptedResponse as O, type ExportBatchStatus as P, type ExportCategoryAttribute as Q, ExportCenterResource as R, type ExportPackage as S, type ExportPackageItem as T, type ExportPackageStatus as U, type ExportPriceUpdateInput as V, type ExportProduct as W, type ExportProductInput as X, type ExportStockUpdateInput as Y, FinanceResource as Z, type FinancialTransaction as _, type BatchAcceptedResponse as a, type TrendyolClient as a$, InventoryResource as a0, InvoicesResource as a1, type KnownShipmentPackageStatus as a2, LabelsResource as a3, type LaborCostInput as a4, type ListCategoryAttributeValuesParams as a5, type ListClaimsParams as a6, type ListCompensationTicketsParams as a7, type ListExportPackagesV2Params as a8, type ListExportPackagesV3Params as a9, type ProductBase as aA, type ProductComposition as aB, type ProductImageInput as aC, type ProductOrigin as aD, type ProductVariant as aE, ProductsResource as aF, type QuantitySplit as aG, type Question as aH, type QuestionAnswer as aI, type QuestionStatus as aJ, QuestionsResource as aK, type SellerIntegrationStatus as aL, type SellerVideo as aM, type SendInvoiceLinkInput as aN, type SettlementRow as aO, type ShipmentPackage as aP, type ShipmentPackageStatus as aQ, type SplitGroup as aR, type SplitPackagePlan as aS, type SupplierAddress as aT, type SupplierAddressType as aU, SuppliersResource as aV, type SuppliersResourceOptions as aW, type TestOrderStatus as aX, TestOrdersResource as aY, type TrendyolCapabilities as aZ, type TrendyolCargoProvider as a_, type ListExportProductsParams as aa, type ListFinanceParams as ab, type ListOrdersParams as ac, type ListOrdersStreamParams as ad, type ListProductsParams as ae, type ListQuestionsParams as af, type ListUnapprovedProductsParams as ag, type ListVideosParams as ah, LocationsResource as ai, type NamedRef as aj, type Neighborhood as ak, type OrderAddress as al, type OrderAddressLines as am, type OrderCustomer as an, type OrderLine as ao, type OrderLineDiscountDetail as ap, OrdersResource as aq, type OtherFinancialRow as ar, type PackageDetail as as, type PackageHistoryEntry as at, type PackageLineUpdate as au, type PriceInventoryUpdate as av, type ProcessAlternativeDeliveryInput as aw, type Product as ax, type ProductAttribute as ay, type ProductAttributeV2Input as az, type BatchPollOptions as b, type TrendyolEnvironment as b0, type UnapprovedDateQueryType as b1, type UnapprovedProduct as b2, type UnapprovedProductRejectReason as b3, type UnapprovedProductStatus as b4, type UpdateBoxInfoInput as b5, type UpdateContentInput as b6, type UpdateDeliveryInfoInput as b7, type UpdatePackageStatusInput as b8, type UpdatePriceInventoryResponse as b9, type UpdateUnapprovedInput as ba, type UpdateVariantInput as bb, type UploadInvoiceFileInput as bc, VideosResource as bd, type Webhook as be, type WebhookAuthenticationType as bf, type WebhookInput as bg, WebhooksResource as bh, createTrendyolClient as bi, normalizeShipmentPackage as bj, pollBatchStatus as bk, trendyolCapabilities as bl, type BatchRequestItemResult as c, type BatchRequestResult as d, type BatchRequestStatus as e, type Brand as f, BrandsResource as g, type BuyboxInfo as h, type CareInstruction as i, type CargoInvoiceItem as j, CategoriesResource as k, type Category as l, type CategoryAttribute as m, type CategoryAttributeValue as n, type City as o, type Claim as p, type ClaimIssueReason as q, type ClaimItemAudit as r, type ClaimItemStatus as s, ClaimsResource as t, type CommonLabel as u, type CommonLabelEntry as v, type CompensationItemDetail as w, type CompensationTicket as x, type CompensationTicketState as y, type Country as z };
+export { type FinancialTransaction as $, type ApproveClaimLineItemsInput as A, type BarcodeCategoryLookup as B, type CancelPackageItemInput as C, type Country as D, type CreateClaimInput as E, type CreateClaimIssueInput as F, type CreateClaimItemInput as G, type CreateClientOptions as H, type CreateCommonLabelInput as I, type CreateProductV2Input as J, type CreateTestOrderInput as K, type CreateVideoInput as L, type DeleteInvoiceLinkInput as M, type DeliveryOptionInput as N, type District as O, type ExportBatchAcceptedResponse as P, type ExportBatchStatus as Q, type ExportCategoryAttribute as R, ExportCenterResource as S, type ExportPackage as T, type ExportPackageItem as U, type ExportPackageStatus as V, type ExportPriceUpdateInput as W, type ExportProduct as X, type ExportProductInput as Y, type ExportStockUpdateInput as Z, FinanceResource as _, type ApprovedProductStatus as a, type TestOrderStatus as a$, type GetExportPackageItemsParams as a0, InventoryResource as a1, InvoicesResource as a2, type KnownShipmentPackageStatus as a3, LabelsResource as a4, type LaborCostInput as a5, type ListCategoryAttributeValuesParams as a6, type ListClaimsParams as a7, type ListCompensationTicketsParams as a8, type ListExportPackagesV2Params as a9, type ProductAttribute as aA, type ProductAttributeV2Input as aB, type ProductBase as aC, type ProductComposition as aD, type ProductImageInput as aE, type ProductOrigin as aF, type ProductStockPrice as aG, type ProductStockPriceVariant as aH, type ProductVariant as aI, ProductsResource as aJ, type QuantitySplit as aK, type Question as aL, type QuestionAnswer as aM, type QuestionStatus as aN, QuestionsResource as aO, type SellerIntegrationStatus as aP, type SellerVideo as aQ, type SendInvoiceLinkInput as aR, type SettlementRow as aS, type ShipmentPackage as aT, type ShipmentPackageStatus as aU, type SplitGroup as aV, type SplitPackagePlan as aW, type SupplierAddress as aX, type SupplierAddressType as aY, SuppliersResource as aZ, type SuppliersResourceOptions as a_, type ListExportPackagesV3Params as aa, type ListExportProductsParams as ab, type ListFinanceParams as ac, type ListInventoryAndPriceParams as ad, type ListOrdersParams as ae, type ListOrdersStreamParams as af, type ListProductsParams as ag, type ListQuestionsParams as ah, type ListUnapprovedProductsParams as ai, type ListVideosParams as aj, LocationsResource as ak, type NamedRef as al, type Neighborhood as am, type OrderAddress as an, type OrderAddressLines as ao, type OrderCustomer as ap, type OrderLine as aq, type OrderLineDiscountDetail as ar, OrdersResource as as, type OtherFinancialRow as at, type PackageDetail as au, type PackageHistoryEntry as av, type PackageLineUpdate as aw, type PriceInventoryUpdate as ax, type ProcessAlternativeDeliveryInput as ay, type Product as az, type BatchAcceptedResponse as b, TestOrdersResource as b0, type TrendyolCapabilities as b1, type TrendyolCargoProvider as b2, type TrendyolClient as b3, type TrendyolEnvironment as b4, type UnapprovedDateQueryType as b5, type UnapprovedProduct as b6, type UnapprovedProductRejectReason as b7, type UnapprovedProductStatus as b8, type UpdateBoxInfoInput as b9, type UpdateContentInput as ba, type UpdateDeliveryInfoInput as bb, type UpdatePackageStatusInput as bc, type UpdatePriceInventoryResponse as bd, type UpdateUnapprovedInput as be, type UpdateVariantInput as bf, type UploadInvoiceFileInput as bg, VideosResource as bh, type Webhook as bi, type WebhookAuthenticationType as bj, type WebhookInput as bk, WebhooksResource as bl, createTrendyolClient as bm, normalizeShipmentPackage as bn, pollBatchStatus as bo, trendyolCapabilities as bp, type BatchPollOptions as c, type BatchRequestItemResult as d, type BatchRequestResult as e, type BatchRequestStatus as f, type Brand as g, BrandsResource as h, type BuyboxInfo as i, type CareInstruction as j, type CargoInvoiceItem as k, CategoriesResource as l, type Category as m, type CategoryAttribute as n, type CategoryAttributeValue as o, type City as p, type Claim as q, type ClaimIssueReason as r, type ClaimItemAudit as s, type ClaimItemStatus as t, ClaimsResource as u, type CommonLabel as v, type CommonLabelEntry as w, type CompensationItemDetail as x, type CompensationTicket as y, type CompensationTicketState as z };