@lonca/trendyol 0.12.0 → 0.14.0

package/dist/index.cjs

@@ -265,12 +265,14 @@ var ClaimsResource = class {
     if (!Array.isArray(input?.claimItems) || input.claimItems.length === 0) {
       throw new core.ValidationError({ message: "claims.create: claimItems must not be empty" });
     }
-    return this.transport.request({
-      method: "POST",
-      path: `/integration/order/sellers/${this.transport.sellerId}/claims/create`,
-      body: input,
-      rateLimiter: this.limiter
-    });
+    return {
+      raw: await this.transport.request({
+        method: "POST",
+        path: `/integration/order/sellers/${this.transport.sellerId}/claims/create`,
+        body: input,
+        rateLimiter: this.limiter
+      })
+    };
   }
   /**
    * File a seller-side rejection ("ret talebi") against a customer claim.
@@ -303,12 +305,14 @@ var ClaimsResource = class {
         form.append("files", file);
       }
     }
-    return this.transport.request({
-      method: "POST",
-      path: `/integration/order/sellers/${this.transport.sellerId}/claims/${encodeURIComponent(claimId)}/issue`,
-      body: form,
-      rateLimiter: this.limiter
-    });
+    return {
+      raw: await this.transport.request({
+        method: "POST",
+        path: `/integration/order/sellers/${this.transport.sellerId}/claims/${encodeURIComponent(claimId)}/issue`,
+        body: form,
+        rateLimiter: this.limiter
+      })
+    };
   }
   /**
    * Approve specific claim line items. After approval, Trendyol moves
@@ -322,12 +326,14 @@ var ClaimsResource = class {
         message: "claims.approveLineItems: claimLineItemIdList must not be empty"
       });
     }
-    return this.transport.request({
-      method: "PUT",
-      path: `/integration/order/sellers/${this.transport.sellerId}/claims/${encodeURIComponent(claimId)}/items/approve`,
-      body: input,
-      rateLimiter: this.limiter
-    });
+    return {
+      raw: await this.transport.request({
+        method: "PUT",
+        path: `/integration/order/sellers/${this.transport.sellerId}/claims/${encodeURIComponent(claimId)}/items/approve`,
+        body: input,
+        rateLimiter: this.limiter
+      })
+    };
   }
   /**
    * List claims (page-based; SDK exposes opaque cursor convention).
@@ -716,12 +722,20 @@ var FinanceResource = class {
     );
   }
   async queryPage(path, params) {
-    const size = Math.min(params.limit ?? 50, 200);
+    if (!params.transactionType) {
+      throw new core.ValidationError({
+        message: "finance: transactionType is required (Trendyol returns 500 without it) \u2014 pass e.g. { transactionType: 'Sale' }."
+      });
+    }
+    const size = (params.limit ?? 500) > 500 ? 1e3 : 500;
     const page = params.cursor ? Number.parseInt(params.cursor, 10) : 0;
-    const query = { page, size };
+    const query = {
+      page,
+      size,
+      transactionType: params.transactionType
+    };
     if (params.startDate) query.startDate = params.startDate.getTime();
     if (params.endDate) query.endDate = params.endDate.getTime();
-    if (params.transactionType) query.transactionType = params.transactionType;
     const data = await this.transport.request({
       method: "GET",
       path,
@@ -893,33 +907,39 @@ var InvoicesResource = class {
     if (input.invoiceNumber !== void 0) {
       form.append("invoiceNumber", input.invoiceNumber);
     }
-    return this.transport.request({
-      method: "POST",
-      path: `/integration/sellers/${this.transport.sellerId}/seller-invoice-file`,
-      body: form,
-      rateLimiter: this.limiter
-    });
+    return {
+      raw: await this.transport.request({
+        method: "POST",
+        path: `/integration/sellers/${this.transport.sellerId}/seller-invoice-file`,
+        body: form,
+        rateLimiter: this.limiter
+      })
+    };
   }
   /** Register an invoice URL with Trendyol (alternative to uploading the file). */
   async sendLink(input) {
     if (!input?.invoiceLink) {
       throw new core.ValidationError({ message: "invoices.sendLink: invoiceLink is required" });
     }
-    return this.transport.request({
-      method: "POST",
-      path: `/integration/sellers/${this.transport.sellerId}/seller-invoice-links`,
-      body: input,
-      rateLimiter: this.limiter
-    });
+    return {
+      raw: await this.transport.request({
+        method: "POST",
+        path: `/integration/sellers/${this.transport.sellerId}/seller-invoice-links`,
+        body: input,
+        rateLimiter: this.limiter
+      })
+    };
   }
   /** Remove a previously-registered invoice link. */
   async deleteLink(input) {
-    return this.transport.request({
-      method: "POST",
-      path: `/integration/sellers/${this.transport.sellerId}/seller-invoice-links/delete`,
-      body: input,
-      rateLimiter: this.limiter
-    });
+    return {
+      raw: await this.transport.request({
+        method: "POST",
+        path: `/integration/sellers/${this.transport.sellerId}/seller-invoice-links/delete`,
+        body: input,
+        rateLimiter: this.limiter
+      })
+    };
   }
 };
 var LabelsResource = class {
@@ -998,22 +1018,32 @@ var LocationsResource = class {
   async getTurkeyCities() {
     return this.cities(`/integration/member/countries/domestic/TR/cities`);
   }
-  async getTurkeyDistricts(cityCode) {
+  /**
+   * List districts for a Turkish city. **Pass the city `id`** (`City.id`) — the
+   * nested endpoint keys off Trendyol's internal id, not the display `code`, and
+   * returns 500 for the code. Verified live.
+   */
+  async getTurkeyDistricts(cityId) {
     return this.districts(
-      `/integration/member/countries/domestic/TR/cities/${encodeURIComponent(String(cityCode))}/districts`
+      `/integration/member/countries/domestic/TR/cities/${encodeURIComponent(String(cityId))}/districts`
     );
   }
-  async getTurkeyNeighborhoods(cityCode, districtCode) {
+  /**
+   * List neighborhoods for a Turkish district. **Pass the ids** (`City.id`,
+   * `District.id`) — not the display codes (those 500).
+   */
+  async getTurkeyNeighborhoods(cityId, districtId) {
     return this.neighborhoods(
-      `/integration/member/countries/domestic/TR/cities/${encodeURIComponent(String(cityCode))}/districts/${encodeURIComponent(String(districtCode))}/neighborhoods`
+      `/integration/member/countries/domestic/TR/cities/${encodeURIComponent(String(cityId))}/districts/${encodeURIComponent(String(districtId))}/neighborhoods`
     );
   }
   async getAzerbaijanCities() {
     return this.cities(`/integration/member/countries/domestic/AZ/cities`);
   }
-  async getAzerbaijanDistricts(cityCode) {
+  /** List districts for an Azerbaijani city. **Pass the city `id`** (`City.id`), not `code`. */
+  async getAzerbaijanDistricts(cityId) {
     return this.districts(
-      `/integration/member/countries/domestic/AZ/cities/${encodeURIComponent(String(cityCode))}/districts`
+      `/integration/member/countries/domestic/AZ/cities/${encodeURIComponent(String(cityId))}/districts`
     );
   }
   // ─── International (GULF / CEE) ───────────────────────────────────────
@@ -1033,6 +1063,7 @@ var LocationsResource = class {
       rateLimiter: this.limiter
     });
     return n(data, (node) => ({
+      id: node.id !== void 0 ? String(node.id) : void 0,
       code: String(node.code ?? node.id ?? ""),
       name: node.name,
       countryCode: node.countryCode
@@ -1045,6 +1076,7 @@ var LocationsResource = class {
       rateLimiter: this.limiter
     });
     return n(data, (node) => ({
+      id: node.id !== void 0 ? String(node.id) : void 0,
       code: String(node.code ?? node.id ?? ""),
       name: node.name,
       cityCode: node.cityCode !== void 0 ? String(node.cityCode) : void 0
@@ -1057,6 +1089,7 @@ var LocationsResource = class {
       rateLimiter: this.limiter
     });
     return n(data, (node) => ({
+      id: node.id !== void 0 ? String(node.id) : void 0,
       code: String(node.code ?? node.id ?? ""),
       name: node.name,
       districtCode: node.districtCode !== void 0 ? String(node.districtCode) : void 0
@@ -1942,6 +1975,11 @@ var ProductsResource = class {
    * List approved products. Use `paginate()` from `@lonca/core` to iterate
    * lazily across pages.
    *
+   * **Approved only:** this endpoint silently excludes products still in review
+   * or rejected — use {@link listUnapproved} for those. Date fields on the
+   * returned {@link Product} (`createdAt` / `updatedAt`) are ISO 8601 UTC
+   * **strings**, not `Date` objects.
+   *
    * Trendyol exposes both page-based and `nextPageToken`-based pagination
    * (the latter required when the dataset exceeds 10,000 items). The SDK
    * picks the right strategy automatically — pass our opaque `cursor` from