@lonca/trendyol 0.8.0 → 0.9.0

package/dist/index.js

@@ -395,6 +395,269 @@ var ClaimsResource = class {
     return rows.map((row) => ({ raw: row }));
   }
 };
+var MAX_BATCH_ITEMS = 5e3;
+var ExportCenterResource = class {
+  constructor(transport, limiter) {
+    this.transport = transport;
+    this.limiter = limiter ?? new TokenBucketRateLimiter({ capacity: 1e3, intervalMs: 6e4 });
+  }
+  transport;
+  limiter;
+  // ─── Products ────────────────────────────────────────────────────────────
+  /**
+   * List Export Center-approved products. Uses Trendyol's `pageKey`
+   * pagination — the first call leaves `pageKey` empty; subsequent
+   * calls pass the `x-paging-key` value from the previous response.
+   */
+  async listProducts(params = {}) {
+    const query = {};
+    if (params.barcodes && params.barcodes.length > 0) query.barcodes = params.barcodes.join(",");
+    if (params.pageKey) query.pageKey = params.pageKey;
+    if (params.size !== void 0) query.size = params.size;
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/ecgw/v2/${this.transport.sellerId}/products`,
+      query: Object.keys(query).length ? query : void 0,
+      rateLimiter: this.limiter
+    });
+    const rows = pickArray(data);
+    return rows.map((r) => ({ raw: r ?? {} }));
+  }
+  /**
+   * Create Export Center products. Maximum 5000 per call. Returns a
+   * `batchId` you can poll via `getBatchStatus(batchId)`.
+   *
+   * @throws {ValidationError} when `products` is empty / oversized.
+   */
+  async createProducts(products) {
+    this.assertBatch(products, "createProducts");
+    const data = await this.transport.request({
+      method: "POST",
+      path: `/integration/ecgw/v2/${this.transport.sellerId}/products`,
+      body: { products },
+      rateLimiter: this.limiter
+    });
+    return normalizeBatchResponse(data);
+  }
+  /**
+   * Update Export Center prices. **Trendyol allows one price update per
+   * barcode per day.** Returns a `batchId`.
+   *
+   * @throws {ValidationError} when `priceInfos` is empty / oversized.
+   */
+  async updatePrices(priceInfos) {
+    this.assertBatch(priceInfos, "updatePrices");
+    const data = await this.transport.request({
+      method: "POST",
+      path: `/integration/ecgw/v1/${this.transport.sellerId}/prices`,
+      body: { priceInfos },
+      rateLimiter: this.limiter
+    });
+    return normalizeBatchResponse(data);
+  }
+  /**
+   * Update Export Center stocks. Returns a `batchId`. Sellers using
+   * Trendyol's shared inventory cannot use this endpoint (per portal docs).
+   *
+   * @throws {ValidationError} when `items` is empty / oversized.
+   */
+  async updateStocks(items) {
+    this.assertBatch(items, "updateStocks");
+    const data = await this.transport.request({
+      method: "POST",
+      path: `/integration/ecgw/v1/${this.transport.sellerId}/stocks`,
+      body: { items },
+      rateLimiter: this.limiter
+    });
+    return normalizeBatchResponse(data);
+  }
+  // ─── Batch status ────────────────────────────────────────────────────────
+  /**
+   * Look up the status of a previously-submitted batch. Trendyol retains
+   * batch records for **24 hours** only — older `batchId`s return `404`.
+   */
+  async getBatchStatus(batchId) {
+    if (!batchId) {
+      throw new ValidationError({ message: "exportCenter.getBatchStatus: batchId is required" });
+    }
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/ecgw/v1/${this.transport.sellerId}/check-status`,
+      query: { batchId },
+      rateLimiter: this.limiter
+    });
+    return normalizeBatchStatus(data);
+  }
+  // ─── Packages ────────────────────────────────────────────────────────────
+  /** List daily Export Center packages (V2 — query-based filters). */
+  async listPackagesV2(params = {}) {
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/ecgw/v2/${this.transport.sellerId}/packages`,
+      query: {
+        trackingNumber: params.trackingNumber,
+        status: params.status,
+        creationStartDate: params.creationStartDate,
+        creationEndDate: params.creationEndDate,
+        size: params.size,
+        boutiqueId: params.boutiqueId
+      },
+      rateLimiter: this.limiter
+    });
+    return pickArray(data).map(normalizePackage);
+  }
+  /** List Export Center packages (V3 — consolidated, page-based). */
+  async listPackagesV3(params = {}) {
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/ecgw/v3/${this.transport.sellerId}/packages`,
+      query: {
+        status: params.status,
+        page: params.offset !== void 0 ? params.offset : void 0,
+        size: params.limit,
+        creationStartDate: params.creationStartDate,
+        creationEndDate: params.creationEndDate
+      },
+      rateLimiter: this.limiter
+    });
+    return pickArray(data).map(normalizePackage);
+  }
+  /** Get the line items inside an Export Center package. */
+  async getPackageItems(params) {
+    if (!params || !params.packageId) {
+      throw new ValidationError({
+        message: "exportCenter.getPackageItems: packageId is required"
+      });
+    }
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/ecgw/v2/${this.transport.sellerId}/packages/items`,
+      query: {
+        packageId: params.packageId,
+        status: params.status,
+        page: params.offset,
+        size: params.limit
+      },
+      rateLimiter: this.limiter
+    });
+    return pickArray(data).map((r) => ({ raw: r ?? {} }));
+  }
+  // ─── Lookup ──────────────────────────────────────────────────────────────
+  /** Get the required attributes for an Export Center category. */
+  async getCategoryAttributes(categoryId) {
+    if (categoryId === void 0 || categoryId === null || categoryId === "") {
+      throw new ValidationError({
+        message: "exportCenter.getCategoryAttributes: categoryId is required"
+      });
+    }
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/ecgw/v1/${this.transport.sellerId}/lookup/product-categories/${encodeURIComponent(String(categoryId))}/attributes`,
+      rateLimiter: this.limiter
+    });
+    return pickArray(data).map((r) => {
+      const row = r ?? {};
+      const out = { raw: row };
+      if (typeof row.attributeId === "number" || typeof row.attributeId === "string") {
+        out.attributeId = row.attributeId;
+      }
+      if (typeof row.attributeName === "string") out.attributeName = row.attributeName;
+      if (typeof row.required === "boolean") out.required = row.required;
+      if (Array.isArray(row.values)) out.values = row.values;
+      return out;
+    });
+  }
+  /** Get the care-instruction lookup values used by `createProducts`. */
+  async getCareInstructions() {
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/ecgw/v1/${this.transport.sellerId}/lookup/care-instructions`,
+      rateLimiter: this.limiter
+    });
+    return pickArray(data).map(normalizeNamedRef);
+  }
+  /** Get the material-composition lookup values used by `createProducts`. */
+  async getCompositions() {
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/ecgw/v1/${this.transport.sellerId}/lookup/compositions`,
+      rateLimiter: this.limiter
+    });
+    return pickArray(data).map(normalizeNamedRef);
+  }
+  /** Get the country-of-origin lookup values used by `createProducts`. */
+  async getOrigins() {
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/ecgw/v1/${this.transport.sellerId}/lookup/origins`,
+      rateLimiter: this.limiter
+    });
+    return pickArray(data).map((r) => {
+      const row = r ?? {};
+      const out = { raw: row };
+      if (typeof row.id === "number" || typeof row.id === "string") out.id = row.id;
+      if (typeof row.name === "string") out.name = row.name;
+      if (typeof row.countryCode === "string") out.countryCode = row.countryCode;
+      return out;
+    });
+  }
+  // ─── Helpers ─────────────────────────────────────────────────────────────
+  assertBatch(items, methodLabel) {
+    if (!Array.isArray(items) || items.length === 0) {
+      throw new ValidationError({
+        message: `exportCenter.${methodLabel}: items must not be empty`
+      });
+    }
+    if (items.length > MAX_BATCH_ITEMS) {
+      throw new ValidationError({
+        message: `exportCenter.${methodLabel}: max ${MAX_BATCH_ITEMS} items per call (got ${items.length})`
+      });
+    }
+  }
+};
+function pickArray(data) {
+  if (Array.isArray(data)) return data;
+  if (data && typeof data === "object") {
+    const obj = data;
+    if (Array.isArray(obj.content)) return obj.content;
+    if (Array.isArray(obj.items)) return obj.items;
+    if (Array.isArray(obj.data)) return obj.data;
+    if (Array.isArray(obj.products)) return obj.products;
+    if (Array.isArray(obj.packages)) return obj.packages;
+  }
+  return [];
+}
+function normalizeBatchResponse(data) {
+  const obj = data && typeof data === "object" ? data : {};
+  return {
+    batchId: String(obj.batchId ?? obj.batchRequestId ?? obj.id ?? ""),
+    raw: obj
+  };
+}
+function normalizeBatchStatus(data) {
+  const obj = data && typeof data === "object" ? data : {};
+  const out = { raw: obj };
+  if (typeof obj.batchId === "string") out.batchId = obj.batchId;
+  if (typeof obj.status === "string") out.status = obj.status;
+  if (typeof obj.itemCount === "number") out.itemCount = obj.itemCount;
+  if (typeof obj.failedItemCount === "number") out.failedItemCount = obj.failedItemCount;
+  if (Array.isArray(obj.items)) out.items = obj.items;
+  return out;
+}
+function normalizePackage(row) {
+  const r = row ?? {};
+  const out = { raw: r };
+  if (typeof r.packageNumber === "string") out.packageNumber = r.packageNumber;
+  if (typeof r.status === "string") out.status = r.status;
+  return out;
+}
+function normalizeNamedRef(row) {
+  const r = row ?? {};
+  const out = { raw: r };
+  if (typeof r.id === "number" || typeof r.id === "string") out.id = r.id;
+  if (typeof r.name === "string") out.name = r.name;
+  return out;
+}
 function toIso2(epochMs) {
   if (typeof epochMs !== "number" || !Number.isFinite(epochMs) || epochMs === 0) {
     return void 0;
@@ -440,11 +703,14 @@ var FinanceResource = class {
   transport;
   limiter;
   async getSettlements(params = {}) {
-    return this.queryPage(`/integration/sellers/${this.transport.sellerId}/settlements`, params);
+    return this.queryPage(
+      `/integration/finance/che/sellers/${this.transport.sellerId}/settlements`,
+      params
+    );
   }
   async getOtherFinancials(params = {}) {
     return this.queryPage(
-      `/integration/sellers/${this.transport.sellerId}/otherfinancials`,
+      `/integration/finance/che/sellers/${this.transport.sellerId}/otherfinancials`,
       params
     );
   }
@@ -792,9 +1058,9 @@ function normalizeCustomer(node) {
   return out;
 }
 function normalizeShipmentPackage(rawNode) {
-  return normalizePackage(rawNode ?? {});
+  return normalizePackage2(rawNode ?? {});
 }
-function normalizePackage(node) {
+function normalizePackage2(node) {
   const pkgId = node.shipmentPackageId ?? node.id;
   const out = {
     id: pkgId !== void 0 ? String(pkgId) : "",
@@ -895,7 +1161,7 @@ var OrdersResource = class {
       query,
       rateLimiter: this.limiter
     });
-    const items = (data.content ?? []).map(normalizePackage);
+    const items = (data.content ?? []).map(normalizePackage2);
     const totalPages = typeof data.totalPages === "number" ? data.totalPages : 0;
     const result = { items };
     if (page + 1 < totalPages) {
@@ -1192,7 +1458,7 @@ var OrdersResource = class {
       query,
       rateLimiter: this.limiter
     });
-    const items = (data.content ?? []).map(normalizePackage);
+    const items = (data.content ?? []).map(normalizePackage2);
     const result = { items };
     if (data.hasMore && data.nextCursor) {
       result.nextCursor = data.nextCursor;
@@ -2075,6 +2341,55 @@ var TestOrdersResource = class {
     });
   }
 };
+var VideosResource = class {
+  constructor(transport, options = {}) {
+    this.transport = transport;
+    this.createLimiter = options.createLimiter ?? new TokenBucketRateLimiter({ capacity: 200, intervalMs: 6e4 });
+    this.listLimiter = options.listLimiter ?? new TokenBucketRateLimiter({ capacity: 1e3, intervalMs: 6e4 });
+  }
+  transport;
+  createLimiter;
+  listLimiter;
+  /**
+   * Queue a video for upload. Trendyol downloads from the URL in the
+   * body asynchronously; poll `list()` (filtered by id) for status.
+   *
+   * @throws {ValidationError} when `input` is empty / not an object.
+   */
+  async create(input) {
+    if (!input || typeof input !== "object") {
+      throw new ValidationError({ message: "videos.create: input is required" });
+    }
+    return this.transport.request({
+      method: "POST",
+      path: `/integration/video/sellers/${this.transport.sellerId}/videos`,
+      body: input,
+      rateLimiter: this.createLimiter
+    });
+  }
+  /** List the seller's integration videos (optionally filtered by id / status). */
+  async list(params = {}) {
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/video/sellers/${this.transport.sellerId}/videos`,
+      query: {
+        id: params.id,
+        sellerIntegrationStatus: params.sellerIntegrationStatus,
+        page: params.offset,
+        size: params.limit
+      },
+      rateLimiter: this.listLimiter
+    });
+    const rows = Array.isArray(data) ? data : Array.isArray(data?.content) ? data.content : Array.isArray(data?.items) ? data.items : [];
+    return rows.map((r) => {
+      const row = r ?? {};
+      const out = { raw: row };
+      if (typeof row.id === "string") out.id = row.id;
+      if (typeof row.status === "string") out.status = row.status;
+      return out;
+    });
+  }
+};
 function normalizeWebhook(node) {
   const out = {
     id: node.id !== void 0 ? String(node.id) : "",
@@ -2413,7 +2728,9 @@ function createTrendyolClient(opts) {
     finance: new FinanceResource(transport),
     labels: new LabelsResource(transport),
     testOrders: new TestOrdersResource(transport),
-    locations: new LocationsResource(transport)
+    locations: new LocationsResource(transport),
+    exportCenter: new ExportCenterResource(transport),
+    videos: new VideosResource(transport)
   };
 }
 function parseWebhookEvent(rawBody) {
@@ -2451,6 +2768,6 @@ function parseWebhookEvent(rawBody) {
   };
 }
 
-export { BrandsResource, CategoriesResource, ClaimsResource, FinanceResource, InventoryResource, InvoicesResource, LabelsResource, LocationsResource, OrdersResource, ProductsResource, QuestionsResource, SuppliersResource, TestOrdersResource, WebhooksResource, createTrendyolClient, normalizeShipmentPackage, parseWebhookEvent };
+export { BrandsResource, CategoriesResource, ClaimsResource, ExportCenterResource, FinanceResource, InventoryResource, InvoicesResource, LabelsResource, LocationsResource, OrdersResource, ProductsResource, QuestionsResource, SuppliersResource, TestOrdersResource, VideosResource, WebhooksResource, createTrendyolClient, normalizeShipmentPackage, parseWebhookEvent };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map