@lonca/trendyol 0.12.0 → 0.14.0

package/dist/index.d.cts

@@ -1,8 +1,8 @@
-import { aT as ShipmentPackage, a3 as KnownShipmentPackageStatus } from './client-BJjLOn4v.cjs';
-export { A as ApproveClaimLineItemsInput, a as ApprovedProductStatus, B as BarcodeCategoryLookup, b as BatchAcceptedResponse, c as BatchPollOptions, d as BatchRequestItemResult, e as BatchRequestResult, f as BatchRequestStatus, g as Brand, h as BrandsResource, i as BuyboxInfo, C as CancelPackageItemInput, j as CareInstruction, k as CargoInvoiceItem, l as CategoriesResource, m as Category, n as CategoryAttribute, o as CategoryAttributeValue, p as City, q as Claim, r as ClaimIssueReason, s as ClaimItemAudit, t as ClaimItemStatus, u as ClaimsResource, v as CommonLabel, w as CommonLabelEntry, x as CompensationItemDetail, y as CompensationTicket, z as CompensationTicketState, D as Country, E as CreateClaimInput, F as CreateClaimIssueInput, G as CreateClaimItemInput, H as CreateClientOptions, I as CreateCommonLabelInput, J as CreateProductV2Input, K as CreateTestOrderInput, L as CreateVideoInput, M as DeleteInvoiceLinkInput, N as DeliveryOptionInput, O as District, P as ExportBatchAcceptedResponse, Q as ExportBatchStatus, R as ExportCategoryAttribute, S as ExportCenterResource, T as ExportPackage, U as ExportPackageItem, V as ExportPackageStatus, W as ExportPriceUpdateInput, X as ExportProduct, Y as ExportProductInput, Z as ExportStockUpdateInput, _ as FinanceResource, $ as FinancialTransaction, a0 as GetExportPackageItemsParams, a1 as InventoryResource, a2 as InvoicesResource, a4 as LabelsResource, a5 as LaborCostInput, a6 as ListCategoryAttributeValuesParams, a7 as ListClaimsParams, a8 as ListCompensationTicketsParams, a9 as ListExportPackagesV2Params, aa as ListExportPackagesV3Params, ab as ListExportProductsParams, ac as ListFinanceParams, ad as ListInventoryAndPriceParams, ae as ListOrdersParams, af as ListOrdersStreamParams, ag as ListProductsParams, ah as ListQuestionsParams, ai as ListUnapprovedProductsParams, aj as ListVideosParams, ak as LocationsResource, al as NamedRef, am as Neighborhood, an as OrderAddress, ao as OrderAddressLines, ap as OrderCustomer, aq as OrderLine, ar as OrderLineDiscountDetail, as as OrdersResource, at as OtherFinancialRow, au as PackageDetail, av as PackageHistoryEntry, aw as PackageLineUpdate, ax as PriceInventoryUpdate, ay as ProcessAlternativeDeliveryInput, az as Product, aA as ProductAttribute, aB as ProductAttributeV2Input, aC as ProductBase, aD as ProductComposition, aE as ProductImageInput, aF as ProductOrigin, aG as ProductStockPrice, aH as ProductStockPriceVariant, aI as ProductVariant, aJ as ProductsResource, aK as QuantitySplit, aL as Question, aM as QuestionAnswer, aN as QuestionStatus, aO as QuestionsResource, aP as SellerIntegrationStatus, aQ as SellerVideo, aR as SendInvoiceLinkInput, aS as SettlementRow, aU as ShipmentPackageStatus, aV as SplitGroup, aW as SplitPackagePlan, aX as SupplierAddress, aY as SupplierAddressType, aZ as SuppliersResource, a_ as SuppliersResourceOptions, a$ as TestOrderStatus, b0 as TestOrdersResource, b1 as TrendyolCapabilities, b2 as TrendyolCargoProvider, b3 as TrendyolClient, b4 as TrendyolEnvironment, b5 as UnapprovedDateQueryType, b6 as UnapprovedProduct, b7 as UnapprovedProductRejectReason, b8 as UnapprovedProductStatus, b9 as UpdateBoxInfoInput, ba as UpdateContentInput, bb as UpdateDeliveryInfoInput, bc as UpdatePackageStatusInput, bd as UpdatePriceInventoryResponse, be as UpdateUnapprovedInput, bf as UpdateVariantInput, bg as UploadInvoiceFileInput, bh as VideosResource, bi as Webhook, bj as WebhookAuthenticationType, bk as WebhookInput, bl as WebhooksResource, bm as createTrendyolClient, bn as normalizeShipmentPackage, bo as pollBatchStatus, bp as trendyolCapabilities } from './client-BJjLOn4v.cjs';
+import { aU as ShipmentPackage, a3 as KnownShipmentPackageStatus } from './client-CtygosAW.cjs';
+export { A as ApproveClaimLineItemsInput, a as ApprovedProductStatus, B as BarcodeCategoryLookup, b as BatchAcceptedResponse, c as BatchPollOptions, d as BatchRequestItemResult, e as BatchRequestResult, f as BatchRequestStatus, g as Brand, h as BrandsResource, i as BuyboxInfo, C as CancelPackageItemInput, j as CareInstruction, k as CargoInvoiceItem, l as CategoriesResource, m as Category, n as CategoryAttribute, o as CategoryAttributeValue, p as City, q as Claim, r as ClaimIssueReason, s as ClaimItemAudit, t as ClaimItemStatus, u as ClaimsResource, v as CommonLabel, w as CommonLabelEntry, x as CompensationItemDetail, y as CompensationTicket, z as CompensationTicketState, D as Country, E as CreateClaimInput, F as CreateClaimIssueInput, G as CreateClaimItemInput, H as CreateClientOptions, I as CreateCommonLabelInput, J as CreateProductV2Input, K as CreateTestOrderInput, L as CreateVideoInput, M as DeleteInvoiceLinkInput, N as DeliveryOptionInput, O as District, P as ExportBatchAcceptedResponse, Q as ExportBatchStatus, R as ExportCategoryAttribute, S as ExportCenterResource, T as ExportPackage, U as ExportPackageItem, V as ExportPackageStatus, W as ExportPriceUpdateInput, X as ExportProduct, Y as ExportProductInput, Z as ExportStockUpdateInput, _ as FinanceResource, $ as FinancialTransaction, a0 as GetExportPackageItemsParams, a1 as InventoryResource, a2 as InvoicesResource, a4 as LabelsResource, a5 as LaborCostInput, a6 as ListCategoryAttributeValuesParams, a7 as ListClaimsParams, a8 as ListCompensationTicketsParams, a9 as ListExportPackagesV2Params, aa as ListExportPackagesV3Params, ab as ListExportProductsParams, ac as ListFinanceParams, ad as ListInventoryAndPriceParams, ae as ListOrdersParams, af as ListOrdersStreamParams, ag as ListProductsParams, ah as ListQuestionsParams, ai as ListUnapprovedProductsParams, aj as ListVideosParams, ak as LocationsResource, al as NamedRef, am as Neighborhood, an as OrderAddress, ao as OrderAddressLines, ap as OrderCustomer, aq as OrderLine, ar as OrderLineDiscountDetail, as as OrdersResource, at as OtherFinancialRow, au as PackageDetail, av as PackageHistoryEntry, aw as PackageLineUpdate, ax as PriceInventoryUpdate, ay as ProcessAlternativeDeliveryInput, az as Product, aA as ProductAttribute, aB as ProductAttributeV2Input, aC as ProductBase, aD as ProductComposition, aE as ProductContentBase, aF as ProductImageInput, aG as ProductOrigin, aH as ProductStockPrice, aI as ProductStockPriceVariant, aJ as ProductVariant, aK as ProductsResource, aL as QuantitySplit, aM as Question, aN as QuestionAnswer, aO as QuestionStatus, aP as QuestionsResource, aQ as SellerIntegrationStatus, aR as SellerVideo, aS as SendInvoiceLinkInput, aT as SettlementRow, aV as ShipmentPackageStatus, aW as SplitGroup, aX as SplitPackagePlan, aY as SupplierAddress, aZ as SupplierAddressType, a_ as SuppliersResource, a$ as SuppliersResourceOptions, b0 as TestOrderStatus, b1 as TestOrdersResource, b2 as TrendyolCapabilities, b3 as TrendyolCargoProvider, b4 as TrendyolClient, b5 as TrendyolEnvironment, b6 as UnapprovedDateQueryType, b7 as UnapprovedProduct, b8 as UnapprovedProductRejectReason, b9 as UnapprovedProductStatus, ba as UpdateBoxInfoInput, bb as UpdateContentInput, bc as UpdateDeliveryInfoInput, bd as UpdatePackageStatusInput, be as UpdatePriceInventoryResponse, bf as UpdateUnapprovedInput, bg as UpdateVariantInput, bh as UploadInvoiceFileInput, bi as VideosResource, bj as Webhook, bk as WebhookAuthenticationType, bl as WebhookInput, bm as WebhooksResource, bn as createTrendyolClient, bo as normalizeShipmentPackage, bp as pollBatchStatus, bq as trendyolCapabilities } from './client-CtygosAW.cjs';
 import * as _lonca_core from '@lonca/core';
 import { NormalizedOrderStatus } from '@lonca/core';
-export { CursorPage, CursorPaginationParams, OffsetPage, OffsetPaginationParams, paginate, paginateOffset } from '@lonca/core';
+export { CursorPage, CursorPaginationParams, MutationResult, OffsetPage, OffsetPaginationParams, paginate, paginateOffset } from '@lonca/core';
 
 /**
  * Inbound webhook event payloads — what Trendyol POSTs to YOUR endpoint

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { aT as ShipmentPackage, a3 as KnownShipmentPackageStatus } from './client-BJjLOn4v.js';
-export { A as ApproveClaimLineItemsInput, a as ApprovedProductStatus, B as BarcodeCategoryLookup, b as BatchAcceptedResponse, c as BatchPollOptions, d as BatchRequestItemResult, e as BatchRequestResult, f as BatchRequestStatus, g as Brand, h as BrandsResource, i as BuyboxInfo, C as CancelPackageItemInput, j as CareInstruction, k as CargoInvoiceItem, l as CategoriesResource, m as Category, n as CategoryAttribute, o as CategoryAttributeValue, p as City, q as Claim, r as ClaimIssueReason, s as ClaimItemAudit, t as ClaimItemStatus, u as ClaimsResource, v as CommonLabel, w as CommonLabelEntry, x as CompensationItemDetail, y as CompensationTicket, z as CompensationTicketState, D as Country, E as CreateClaimInput, F as CreateClaimIssueInput, G as CreateClaimItemInput, H as CreateClientOptions, I as CreateCommonLabelInput, J as CreateProductV2Input, K as CreateTestOrderInput, L as CreateVideoInput, M as DeleteInvoiceLinkInput, N as DeliveryOptionInput, O as District, P as ExportBatchAcceptedResponse, Q as ExportBatchStatus, R as ExportCategoryAttribute, S as ExportCenterResource, T as ExportPackage, U as ExportPackageItem, V as ExportPackageStatus, W as ExportPriceUpdateInput, X as ExportProduct, Y as ExportProductInput, Z as ExportStockUpdateInput, _ as FinanceResource, $ as FinancialTransaction, a0 as GetExportPackageItemsParams, a1 as InventoryResource, a2 as InvoicesResource, a4 as LabelsResource, a5 as LaborCostInput, a6 as ListCategoryAttributeValuesParams, a7 as ListClaimsParams, a8 as ListCompensationTicketsParams, a9 as ListExportPackagesV2Params, aa as ListExportPackagesV3Params, ab as ListExportProductsParams, ac as ListFinanceParams, ad as ListInventoryAndPriceParams, ae as ListOrdersParams, af as ListOrdersStreamParams, ag as ListProductsParams, ah as ListQuestionsParams, ai as ListUnapprovedProductsParams, aj as ListVideosParams, ak as LocationsResource, al as NamedRef, am as Neighborhood, an as OrderAddress, ao as OrderAddressLines, ap as OrderCustomer, aq as OrderLine, ar as OrderLineDiscountDetail, as as OrdersResource, at as OtherFinancialRow, au as PackageDetail, av as PackageHistoryEntry, aw as PackageLineUpdate, ax as PriceInventoryUpdate, ay as ProcessAlternativeDeliveryInput, az as Product, aA as ProductAttribute, aB as ProductAttributeV2Input, aC as ProductBase, aD as ProductComposition, aE as ProductImageInput, aF as ProductOrigin, aG as ProductStockPrice, aH as ProductStockPriceVariant, aI as ProductVariant, aJ as ProductsResource, aK as QuantitySplit, aL as Question, aM as QuestionAnswer, aN as QuestionStatus, aO as QuestionsResource, aP as SellerIntegrationStatus, aQ as SellerVideo, aR as SendInvoiceLinkInput, aS as SettlementRow, aU as ShipmentPackageStatus, aV as SplitGroup, aW as SplitPackagePlan, aX as SupplierAddress, aY as SupplierAddressType, aZ as SuppliersResource, a_ as SuppliersResourceOptions, a$ as TestOrderStatus, b0 as TestOrdersResource, b1 as TrendyolCapabilities, b2 as TrendyolCargoProvider, b3 as TrendyolClient, b4 as TrendyolEnvironment, b5 as UnapprovedDateQueryType, b6 as UnapprovedProduct, b7 as UnapprovedProductRejectReason, b8 as UnapprovedProductStatus, b9 as UpdateBoxInfoInput, ba as UpdateContentInput, bb as UpdateDeliveryInfoInput, bc as UpdatePackageStatusInput, bd as UpdatePriceInventoryResponse, be as UpdateUnapprovedInput, bf as UpdateVariantInput, bg as UploadInvoiceFileInput, bh as VideosResource, bi as Webhook, bj as WebhookAuthenticationType, bk as WebhookInput, bl as WebhooksResource, bm as createTrendyolClient, bn as normalizeShipmentPackage, bo as pollBatchStatus, bp as trendyolCapabilities } from './client-BJjLOn4v.js';
+import { aU as ShipmentPackage, a3 as KnownShipmentPackageStatus } from './client-CtygosAW.js';
+export { A as ApproveClaimLineItemsInput, a as ApprovedProductStatus, B as BarcodeCategoryLookup, b as BatchAcceptedResponse, c as BatchPollOptions, d as BatchRequestItemResult, e as BatchRequestResult, f as BatchRequestStatus, g as Brand, h as BrandsResource, i as BuyboxInfo, C as CancelPackageItemInput, j as CareInstruction, k as CargoInvoiceItem, l as CategoriesResource, m as Category, n as CategoryAttribute, o as CategoryAttributeValue, p as City, q as Claim, r as ClaimIssueReason, s as ClaimItemAudit, t as ClaimItemStatus, u as ClaimsResource, v as CommonLabel, w as CommonLabelEntry, x as CompensationItemDetail, y as CompensationTicket, z as CompensationTicketState, D as Country, E as CreateClaimInput, F as CreateClaimIssueInput, G as CreateClaimItemInput, H as CreateClientOptions, I as CreateCommonLabelInput, J as CreateProductV2Input, K as CreateTestOrderInput, L as CreateVideoInput, M as DeleteInvoiceLinkInput, N as DeliveryOptionInput, O as District, P as ExportBatchAcceptedResponse, Q as ExportBatchStatus, R as ExportCategoryAttribute, S as ExportCenterResource, T as ExportPackage, U as ExportPackageItem, V as ExportPackageStatus, W as ExportPriceUpdateInput, X as ExportProduct, Y as ExportProductInput, Z as ExportStockUpdateInput, _ as FinanceResource, $ as FinancialTransaction, a0 as GetExportPackageItemsParams, a1 as InventoryResource, a2 as InvoicesResource, a4 as LabelsResource, a5 as LaborCostInput, a6 as ListCategoryAttributeValuesParams, a7 as ListClaimsParams, a8 as ListCompensationTicketsParams, a9 as ListExportPackagesV2Params, aa as ListExportPackagesV3Params, ab as ListExportProductsParams, ac as ListFinanceParams, ad as ListInventoryAndPriceParams, ae as ListOrdersParams, af as ListOrdersStreamParams, ag as ListProductsParams, ah as ListQuestionsParams, ai as ListUnapprovedProductsParams, aj as ListVideosParams, ak as LocationsResource, al as NamedRef, am as Neighborhood, an as OrderAddress, ao as OrderAddressLines, ap as OrderCustomer, aq as OrderLine, ar as OrderLineDiscountDetail, as as OrdersResource, at as OtherFinancialRow, au as PackageDetail, av as PackageHistoryEntry, aw as PackageLineUpdate, ax as PriceInventoryUpdate, ay as ProcessAlternativeDeliveryInput, az as Product, aA as ProductAttribute, aB as ProductAttributeV2Input, aC as ProductBase, aD as ProductComposition, aE as ProductContentBase, aF as ProductImageInput, aG as ProductOrigin, aH as ProductStockPrice, aI as ProductStockPriceVariant, aJ as ProductVariant, aK as ProductsResource, aL as QuantitySplit, aM as Question, aN as QuestionAnswer, aO as QuestionStatus, aP as QuestionsResource, aQ as SellerIntegrationStatus, aR as SellerVideo, aS as SendInvoiceLinkInput, aT as SettlementRow, aV as ShipmentPackageStatus, aW as SplitGroup, aX as SplitPackagePlan, aY as SupplierAddress, aZ as SupplierAddressType, a_ as SuppliersResource, a$ as SuppliersResourceOptions, b0 as TestOrderStatus, b1 as TestOrdersResource, b2 as TrendyolCapabilities, b3 as TrendyolCargoProvider, b4 as TrendyolClient, b5 as TrendyolEnvironment, b6 as UnapprovedDateQueryType, b7 as UnapprovedProduct, b8 as UnapprovedProductRejectReason, b9 as UnapprovedProductStatus, ba as UpdateBoxInfoInput, bb as UpdateContentInput, bc as UpdateDeliveryInfoInput, bd as UpdatePackageStatusInput, be as UpdatePriceInventoryResponse, bf as UpdateUnapprovedInput, bg as UpdateVariantInput, bh as UploadInvoiceFileInput, bi as VideosResource, bj as Webhook, bk as WebhookAuthenticationType, bl as WebhookInput, bm as WebhooksResource, bn as createTrendyolClient, bo as normalizeShipmentPackage, bp as pollBatchStatus, bq as trendyolCapabilities } from './client-CtygosAW.js';
 import * as _lonca_core from '@lonca/core';
 import { NormalizedOrderStatus } from '@lonca/core';
-export { CursorPage, CursorPaginationParams, OffsetPage, OffsetPaginationParams, paginate, paginateOffset } from '@lonca/core';
+export { CursorPage, CursorPaginationParams, MutationResult, OffsetPage, OffsetPaginationParams, paginate, paginateOffset } from '@lonca/core';
 
 /**
  * Inbound webhook event payloads — what Trendyol POSTs to YOUR endpoint

package/dist/index.js

@@ -264,12 +264,14 @@ var ClaimsResource = class {
     if (!Array.isArray(input?.claimItems) || input.claimItems.length === 0) {
       throw new 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.
@@ -302,12 +304,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
@@ -321,12 +325,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).
@@ -715,12 +721,20 @@ var FinanceResource = class {
     );
   }
   async queryPage(path, params) {
-    const size = Math.min(params.limit ?? 50, 200);
+    if (!params.transactionType) {
+      throw new 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,
@@ -892,33 +906,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 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 {
@@ -997,22 +1017,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) ───────────────────────────────────────
@@ -1032,6 +1062,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
@@ -1044,6 +1075,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
@@ -1056,6 +1088,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
@@ -1941,6 +1974,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