@lonca/trendyol 0.10.0 → 0.11.1

package/dist/index.cjs

@@ -1,7 +1,6 @@
 'use strict';
 
 var core = require('@lonca/core');
-var crypto = require('crypto');
 
 // src/resources/brands.ts
 var DEFAULT_PAGE_SIZE = 1e3;
@@ -41,7 +40,7 @@ var BrandsResource = class {
    * `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`.
@@ -1066,6 +1065,7 @@ var LocationsResource = class {
 };
 var MAX_PAGE_SIZE = 200;
 var DEFAULT_PAGE_SIZE2 = 50;
+var MAX_OFFSET_RECORDS = 1e4;
 function toIso3(epochMs) {
   if (typeof epochMs !== "number" || !Number.isFinite(epochMs) || epochMs === 0) {
     return void 0;
@@ -1242,6 +1242,11 @@ var OrdersResource = class {
   async list(params = {}) {
     const size = Math.min(params.limit ?? DEFAULT_PAGE_SIZE2, MAX_PAGE_SIZE);
     const page = params.cursor ? Number.parseInt(params.cursor, 10) : 0;
+    if ((page + 1) * size > MAX_OFFSET_RECORDS) {
+      throw new core.ValidationError({
+        message: `getShipmentPackages can reach at most ${MAX_OFFSET_RECORDS} records (page ${page} \xD7 size ${size} exceeds it); use listStream() for full scans`
+      });
+    }
     const query = { page, size };
     if (params.status) query.status = params.status;
     if (params.orderNumber) query.orderNumber = params.orderNumber;
@@ -1256,7 +1261,8 @@ var OrdersResource = class {
     const items = (data.content ?? []).map(normalizePackage2);
     const totalPages = typeof data.totalPages === "number" ? data.totalPages : 0;
     const result = { items };
-    if (page + 1 < totalPages) {
+    const nextPageWithinCap = (page + 2) * size <= MAX_OFFSET_RECORDS;
+    if (page + 1 < totalPages && nextPageWithinCap) {
       result.nextCursor = String(page + 1);
     }
     return result;
@@ -1695,6 +1701,7 @@ var OrdersResource = class {
 };
 var DEFAULT_PAGE_SIZE3 = 50;
 var MAX_PAGE_SIZE2 = 1e3;
+var MAX_INVENTORY_PAGE_SIZE = 100;
 var MAX_BUYBOX_BARCODES = 10;
 function normalizeRef(ref) {
   return {
@@ -1760,6 +1767,30 @@ function normalizeProduct(node) {
   if (node.lastModifiedBy !== void 0) out.lastModifiedBy = node.lastModifiedBy;
   return out;
 }
+function normalizeStockPriceVariant(node) {
+  const out = {
+    variantId: node.variantId !== void 0 ? String(node.variantId) : "",
+    barcode: node.barcode ?? "",
+    raw: node
+  };
+  if (typeof node.salePrice === "number") out.salePrice = node.salePrice;
+  if (typeof node.listPrice === "number") out.listPrice = node.listPrice;
+  if (typeof node.quantity === "number") out.quantity = node.quantity;
+  if (node.stockCode !== void 0) out.stockCode = node.stockCode;
+  if (node.stockLastModifiedDate !== void 0 && node.stockLastModifiedDate !== null) {
+    const iso = toIso4(node.stockLastModifiedDate);
+    if (iso) out.stockLastModifiedAt = iso;
+  }
+  return out;
+}
+function normalizeStockPrice(node) {
+  return {
+    contentId: node.contentId !== void 0 ? String(node.contentId) : "",
+    productMainId: node.productMainId ?? "",
+    variants: (node.variants ?? []).map(normalizeStockPriceVariant),
+    raw: node
+  };
+}
 function normalizeUnapprovedRejectReason(r) {
   const out = {};
   if (r.rejectReason !== void 0) out.rejectReason = r.rejectReason;
@@ -1950,6 +1981,63 @@ var ProductsResource = class {
     }
     return page;
   }
+  /**
+   * 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);
+   *   }
+   * }
+   * ```
+   */
+  async listInventoryAndPrice(params = {}) {
+    const size = Math.min(params.limit ?? DEFAULT_PAGE_SIZE3, MAX_INVENTORY_PAGE_SIZE);
+    const query = { size };
+    if (params.cursor) {
+      query.nextPageToken = params.cursor;
+    } else {
+      query.page = 0;
+    }
+    if (params.barcode) query.barcode = params.barcode;
+    if (params.contentId) query.contentId = params.contentId;
+    if (params.stockCode) query.stockCode = params.stockCode;
+    if (params.productMainId) query.productMainId = params.productMainId;
+    if (params.status) query.status = params.status;
+    if (params.orderByDirection) query.orderByDirection = params.orderByDirection;
+    const headers = params.storeFrontCode ? { storeFrontCode: params.storeFrontCode } : void 0;
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/product/sellers/${this.transport.sellerId}/products/approved/inventory-and-price`,
+      query,
+      headers,
+      rateLimiter: this.filterLimiter
+    });
+    const items = (data.content ?? []).map(normalizeStockPrice);
+    const page = { items };
+    if (data.nextPageToken) {
+      page.nextCursor = data.nextPageToken;
+    }
+    return page;
+  }
   /**
    * Poll a batch request returned by an async write (e.g. `createProducts`,
    * `updatePriceAndInventory`).
@@ -2696,14 +2784,6 @@ function extractErrorsArray(body) {
   }
   return void 0;
 }
-function parseRetryAfter(header) {
-  if (!header) return void 0;
-  const seconds = Number(header);
-  if (!Number.isNaN(seconds)) return Math.max(0, seconds * 1e3);
-  const epoch = Date.parse(header);
-  if (!Number.isNaN(epoch)) return Math.max(0, epoch - Date.now());
-  return void 0;
-}
 
 // src/transport.ts
 var BASE_URLS = {
@@ -2714,95 +2794,26 @@ var TrendyolTransport = class {
   constructor(config) {
     this.config = config;
     this.baseUrl = BASE_URLS[config.env];
-    this.logger = config.logger ?? core.noopLogger;
-    this.timeoutMs = config.timeoutMs ?? 3e4;
-    this.fetchImpl = config.fetch ?? fetch;
+    this.requester = core.createRequester({
+      fetch: config.fetch ?? fetch,
+      logger: config.logger,
+      timeoutMs: config.timeoutMs ?? 3e4,
+      label: "Trendyol",
+      logPrefix: "trendyol",
+      buildUrl: (opts) => this.buildUrl(opts.path, opts.query),
+      buildHeaders: (correlationId) => this.buildHeaders(correlationId),
+      mapHttpError
+    });
   }
   config;
   baseUrl;
-  logger;
-  timeoutMs;
-  fetchImpl;
+  requester;
   /** Seller ID this transport is configured with. Resources read it for path-building. */
   get sellerId() {
     return this.config.sellerId;
   }
-  async request(opts) {
-    return core.retry(
-      async (attempt) => {
-        if (opts.rateLimiter) await opts.rateLimiter.acquire(opts.signal);
-        const url = this.buildUrl(opts.path, opts.query);
-        const correlationId = crypto.randomUUID();
-        const headers = this.buildHeaders(correlationId);
-        const init = {
-          method: opts.method,
-          headers,
-          signal: this.composeSignal(opts.signal)
-        };
-        if (opts.body !== void 0 && opts.method !== "GET") {
-          if (opts.body instanceof FormData) {
-            init.body = opts.body;
-            delete headers["Content-Type"];
-          } else {
-            init.body = JSON.stringify(opts.body);
-          }
-        }
-        this.logger.debug("trendyol.request", {
-          method: opts.method,
-          url,
-          correlationId,
-          attempt
-        });
-        let response;
-        try {
-          response = await this.fetchImpl(url, init);
-        } catch (err) {
-          if (err instanceof Error && err.name === "AbortError") {
-            throw new core.TimeoutError({
-              message: `Trendyol request timed out after ${this.timeoutMs}ms`,
-              cause: err
-            });
-          }
-          throw new core.NetworkError({
-            message: "Trendyol network failure",
-            cause: err
-          });
-        }
-        if (!response.ok) {
-          const body = await safeJson(response);
-          const retryAfterMs = parseRetryAfter(response.headers.get("retry-after"));
-          const error = mapHttpError(response.status, body, retryAfterMs);
-          this.logger.warn("trendyol.error", {
-            method: opts.method,
-            url,
-            correlationId,
-            status: response.status,
-            code: error.code,
-            retryable: error.retryable
-          });
-          throw error;
-        }
-        this.logger.debug("trendyol.response", {
-          correlationId,
-          status: response.status
-        });
-        if (response.status === 204) return void 0;
-        return await safeJson(response);
-      },
-      {
-        signal: opts.signal,
-        onRetry: (err, attempt, delay2) => {
-          if (err instanceof core.LoncaError) {
-            this.logger.warn("trendyol.retry", {
-              attempt,
-              delayMs: delay2,
-              code: err.code,
-              status: err.status
-            });
-          }
-        }
-      }
-    );
+  request(opts) {
+    return this.requester(opts);
   }
   buildUrl(path, query) {
     const url = new URL(path, this.baseUrl);
@@ -2825,21 +2836,7 @@ var TrendyolTransport = class {
       Accept: "application/json"
     };
   }
-  composeSignal(external) {
-    const timeoutSignal = AbortSignal.timeout(this.timeoutMs);
-    if (!external) return timeoutSignal;
-    return AbortSignal.any([external, timeoutSignal]);
-  }
 };
-async function safeJson(response) {
-  const text = await response.text();
-  if (!text) return void 0;
-  try {
-    return JSON.parse(text);
-  } catch {
-    return text;
-  }
-}
 
 // src/client.ts
 function createTrendyolClient(opts) {