@lonca/trendyol 1.1.0 → 1.2.0

package/README.md

@@ -41,7 +41,7 @@ Each entry is a method on the client.
 | `finance`        | `getSettlements({...})`, `getOtherFinancials({...})` — both return typed `FinancialTransaction[]`                                                                                                                                                                                                                                  |
 | `labels`         | `createCommon(trackingNumber, {format: 'ZPL', ...})`, `getCommon(trackingNumber)`                                                                                                                                                                                                                                                  |
 | `testOrders`     | `create({...})`, `updateStatus(id, status, { lines?, params? })`, `setClaimsWaitingInAction()` — **STAGE-only utility**                                                                                                                                                                                                            |
-| `locations`      | `getCountries()`, `getTurkeyCities()`, `getTurkeyDistricts(cityCode)`, `getTurkeyNeighborhoods(cityCode, districtCode)`, `getAzerbaijanCities()`, `getAzerbaijanDistricts(...)`, `getCitiesByCountry/getDistrictsByCity(...)`                                                                                                      |
+| `locations`      | `getCountries()`, `getTurkeyCities()`, `getTurkeyDistricts(cityId)`, `getTurkeyNeighborhoods(cityId, districtId)`, `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                                                                                                                                                                                                                                   |
@@ -377,8 +377,8 @@ const { videoId } = await client.videos.create({ title, videoUrl, productContent
 // locations (no sellerId — utility lookup)
 const countries = await client.locations.getCountries();
 const cities = await client.locations.getTurkeyCities();
-const districts = await client.locations.getTurkeyDistricts(cityCode);
-const neighborhoods = await client.locations.getTurkeyNeighborhoods(cityCode, districtCode);
+const districts = await client.locations.getTurkeyDistricts(city.id); // pass ids, not codes
+const neighborhoods = await client.locations.getTurkeyNeighborhoods(city.id, district.id); // Neighborhood: id, name, postCode
 ```
 
 ## Mutation results

package/dist/{client-Bp0jKEU7.d.cts → client-BhSJFkFo.d.cts}

@@ -160,13 +160,13 @@ interface CategoryAttribute {
      */
     allowMultipleAttributeValues?: boolean;
     /**
-     * Allowed values for this attribute.
+     * Allowed values, only if the response inlines them — normally an empty array.
      *
-     * NOTE: Trendyol's live API often omits this field on the `getCategoryAttributes`
-     * response — the endpoint returns attribute metadata + flags, not the full value
-     * catalog. In that case `values` is an empty array. If `allowCustom` is `true`,
-     * any custom text is accepted; otherwise use `client.categories.getAttributeValues(categoryId, attributeId)`
-     * to fetch the catalog from the dedicated V2 endpoint.
+     * @deprecated Trendyol's `getCategoryAttributes` response carries no value list — neither the
+     * docs nor the prod wire (2026-10-10) have `attributeValues` — so this is normally `[]` (an
+     * inline list from an older response format is still mapped). Fetch the catalog with
+     * `client.categories.getAttributeValues(categoryId, attributeId)` (with `paginate()`); when
+     * `allowCustom` is `true`, any custom text is accepted as well.
      */
     values: CategoryAttributeValue[];
 }
@@ -206,8 +206,8 @@ declare class CategoriesResource {
     /**
      * Fetch the allowed values for a single category attribute (paginated).
      *
-     * `getCategoryAttributes` returns attribute metadata + flags but typically
-     * omits the value catalog. Use this method to fetch the catalog for an
+     * `getCategoryAttributes` returns attribute metadata + flags only, never the
+     * value catalog (docs and prod wire agree). Use this method to fetch the catalog for an
      * attribute when `allowCustom` is `false` and you need to map your data
      * onto Trendyol's accepted values.
      *
@@ -823,16 +823,34 @@ interface City {
 interface District {
     /** Trendyol's internal district id — pass to `getTurkeyNeighborhoods(cityId, district.id)`. */
     id?: string;
+    /** Trendyol's district code (the prod wire's `code`; falls back to the id when a row has none). */
     code: string;
     name?: string;
+    /**
+     * @deprecated Trendyol's district rows carry no city reference — neither the docs nor the prod
+     * wire (2026-10-10) have one — so this is always `undefined`. Keep the city you passed to
+     * `getTurkeyDistricts` / `getAzerbaijanDistricts` / `getDistrictsByCity` instead.
+     */
     cityCode?: string;
     raw: Record<string, unknown>;
 }
 interface Neighborhood {
     /** Trendyol's internal neighborhood id. */
     id?: string;
+    /**
+     * @deprecated Trendyol's neighborhood rows have no code (prod wire 2026-10-10: `id`, `name`,
+     * `postCode`; the docs list `id` and `name`), so this is always the same value as `id` (`''`
+     * when the row has no id). Use `id`.
+     */
     code: string;
     name?: string;
+    /** The neighborhood's postal code (prod wire `postCode`; not in Trendyol's docs). */
+    postCode?: string;
+    /**
+     * @deprecated Trendyol's neighborhood rows carry no district reference — neither the docs nor
+     * the prod wire (2026-10-10) have one — so this is always `undefined`. Keep the district you
+     * passed to `getTurkeyNeighborhoods` instead.
+     */
     districtCode?: string;
     raw: Record<string, unknown>;
 }
@@ -2413,25 +2431,43 @@ type SupplierAddressType = 'SHIPMENT' | 'RETURNING' | 'INVOICE' | 'WAREHOUSE';
  *
  * Used by `createProduct V2` for `shipmentAddressId` / `returningAddressId`.
  *
- * NOTE: The exact field set is best-effort; some optional fields may differ
- * once verified against real STAGE responses. Bumped fields land in a follow-up
- * minor release if needed.
+ * Field set checked against the docs and the prod wire (2026-10-10).
  */
 interface SupplierAddress {
     id: string;
-    /** Free-form label set by the seller. */
+    /**
+     * @deprecated Trendyol's address rows carry no name or label — neither the docs nor the prod
+     * wire (2026-10-10) have one — so this is always `undefined`. Identify an address by `id`,
+     * `addressType` and the role flags; use `fullAddress` / `address` for its text.
+     */
     name?: string;
-    /** Primary role declared by Trendyol. */
+    /**
+     * Primary role declared by Trendyol. The docs spell it `Shipment` / `Invoice` / `Returning`;
+     * the SDK upper-cases it.
+     */
     addressType: SupplierAddressType;
     isShipmentAddress: boolean;
     isReturningAddress: boolean;
     isInvoiceAddress: boolean;
     isDefault: boolean;
-    /** Multi-line address string as registered in the Partner Panel. */
+    /** Street address as registered in the Partner Panel. */
     address?: string;
+    /** The complete address text (Trendyol's `fullAddress`). */
+    fullAddress?: string;
+    /** Country name as Trendyol sends it. */
+    country?: string;
     city?: string;
+    /** Trendyol's city code (stringified from the wire number). */
+    cityCode?: string;
     district?: string;
+    /** Trendyol's district id (stringified from the wire number). */
+    districtId?: string;
     postCode?: string;
+    /**
+     * @deprecated Trendyol's address rows carry no `fullName` — neither the docs nor the prod wire
+     * (2026-10-10) have one — so this is always `undefined`. Use `fullAddress` for the complete
+     * address text.
+     */
     fullName?: string;
 }
 

package/dist/{client-Bp0jKEU7.d.ts → client-BhSJFkFo.d.ts}

@@ -160,13 +160,13 @@ interface CategoryAttribute {
      */
     allowMultipleAttributeValues?: boolean;
     /**
-     * Allowed values for this attribute.
+     * Allowed values, only if the response inlines them — normally an empty array.
      *
-     * NOTE: Trendyol's live API often omits this field on the `getCategoryAttributes`
-     * response — the endpoint returns attribute metadata + flags, not the full value
-     * catalog. In that case `values` is an empty array. If `allowCustom` is `true`,
-     * any custom text is accepted; otherwise use `client.categories.getAttributeValues(categoryId, attributeId)`
-     * to fetch the catalog from the dedicated V2 endpoint.
+     * @deprecated Trendyol's `getCategoryAttributes` response carries no value list — neither the
+     * docs nor the prod wire (2026-10-10) have `attributeValues` — so this is normally `[]` (an
+     * inline list from an older response format is still mapped). Fetch the catalog with
+     * `client.categories.getAttributeValues(categoryId, attributeId)` (with `paginate()`); when
+     * `allowCustom` is `true`, any custom text is accepted as well.
      */
     values: CategoryAttributeValue[];
 }
@@ -206,8 +206,8 @@ declare class CategoriesResource {
     /**
      * Fetch the allowed values for a single category attribute (paginated).
      *
-     * `getCategoryAttributes` returns attribute metadata + flags but typically
-     * omits the value catalog. Use this method to fetch the catalog for an
+     * `getCategoryAttributes` returns attribute metadata + flags only, never the
+     * value catalog (docs and prod wire agree). Use this method to fetch the catalog for an
      * attribute when `allowCustom` is `false` and you need to map your data
      * onto Trendyol's accepted values.
      *
@@ -823,16 +823,34 @@ interface City {
 interface District {
     /** Trendyol's internal district id — pass to `getTurkeyNeighborhoods(cityId, district.id)`. */
     id?: string;
+    /** Trendyol's district code (the prod wire's `code`; falls back to the id when a row has none). */
     code: string;
     name?: string;
+    /**
+     * @deprecated Trendyol's district rows carry no city reference — neither the docs nor the prod
+     * wire (2026-10-10) have one — so this is always `undefined`. Keep the city you passed to
+     * `getTurkeyDistricts` / `getAzerbaijanDistricts` / `getDistrictsByCity` instead.
+     */
     cityCode?: string;
     raw: Record<string, unknown>;
 }
 interface Neighborhood {
     /** Trendyol's internal neighborhood id. */
     id?: string;
+    /**
+     * @deprecated Trendyol's neighborhood rows have no code (prod wire 2026-10-10: `id`, `name`,
+     * `postCode`; the docs list `id` and `name`), so this is always the same value as `id` (`''`
+     * when the row has no id). Use `id`.
+     */
     code: string;
     name?: string;
+    /** The neighborhood's postal code (prod wire `postCode`; not in Trendyol's docs). */
+    postCode?: string;
+    /**
+     * @deprecated Trendyol's neighborhood rows carry no district reference — neither the docs nor
+     * the prod wire (2026-10-10) have one — so this is always `undefined`. Keep the district you
+     * passed to `getTurkeyNeighborhoods` instead.
+     */
     districtCode?: string;
     raw: Record<string, unknown>;
 }
@@ -2413,25 +2431,43 @@ type SupplierAddressType = 'SHIPMENT' | 'RETURNING' | 'INVOICE' | 'WAREHOUSE';
  *
  * Used by `createProduct V2` for `shipmentAddressId` / `returningAddressId`.
  *
- * NOTE: The exact field set is best-effort; some optional fields may differ
- * once verified against real STAGE responses. Bumped fields land in a follow-up
- * minor release if needed.
+ * Field set checked against the docs and the prod wire (2026-10-10).
  */
 interface SupplierAddress {
     id: string;
-    /** Free-form label set by the seller. */
+    /**
+     * @deprecated Trendyol's address rows carry no name or label — neither the docs nor the prod
+     * wire (2026-10-10) have one — so this is always `undefined`. Identify an address by `id`,
+     * `addressType` and the role flags; use `fullAddress` / `address` for its text.
+     */
     name?: string;
-    /** Primary role declared by Trendyol. */
+    /**
+     * Primary role declared by Trendyol. The docs spell it `Shipment` / `Invoice` / `Returning`;
+     * the SDK upper-cases it.
+     */
     addressType: SupplierAddressType;
     isShipmentAddress: boolean;
     isReturningAddress: boolean;
     isInvoiceAddress: boolean;
     isDefault: boolean;
-    /** Multi-line address string as registered in the Partner Panel. */
+    /** Street address as registered in the Partner Panel. */
     address?: string;
+    /** The complete address text (Trendyol's `fullAddress`). */
+    fullAddress?: string;
+    /** Country name as Trendyol sends it. */
+    country?: string;
     city?: string;
+    /** Trendyol's city code (stringified from the wire number). */
+    cityCode?: string;
     district?: string;
+    /** Trendyol's district id (stringified from the wire number). */
+    districtId?: string;
     postCode?: string;
+    /**
+     * @deprecated Trendyol's address rows carry no `fullName` — neither the docs nor the prod wire
+     * (2026-10-10) have one — so this is always `undefined`. Use `fullAddress` for the complete
+     * address text.
+     */
     fullName?: string;
 }
 

package/dist/index.cjs

@@ -84,7 +84,6 @@ function normalizeCategory(node) {
 }
 function normalizeAttribute(node) {
   const attr = node.attribute ?? { id: 0, name: "" };
-  const rawValues = node.attributeValues ?? [];
   const out = {
     id: String(attr.id),
     name: attr.name,
@@ -92,7 +91,8 @@ function normalizeAttribute(node) {
     allowCustom: !!node.allowCustom,
     varianter: !!node.varianter,
     slicer: !!node.slicer,
-    values: rawValues.map((v) => ({ id: String(v.id), name: v.name }))
+    // Deprecated: normally empty — see `attributeValues` on the node above.
+    values: (node.attributeValues ?? []).map((v) => ({ id: String(v.id), name: v.name }))
   };
   if (node.categoryId !== void 0) {
     out.categoryId = String(node.categoryId);
@@ -154,8 +154,8 @@ var CategoriesResource = class {
   /**
    * Fetch the allowed values for a single category attribute (paginated).
    *
-   * `getCategoryAttributes` returns attribute metadata + flags but typically
-   * omits the value catalog. Use this method to fetch the catalog for an
+   * `getCategoryAttributes` returns attribute metadata + flags only, never the
+   * value catalog (docs and prod wire agree). Use this method to fetch the catalog for an
    * attribute when `allowCustom` is `false` and you need to map your data
    * onto Trendyol's accepted values.
    *
@@ -1102,8 +1102,7 @@ var LocationsResource = class {
     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
+      name: node.name
     }));
   }
   async neighborhoods(path) {
@@ -1112,12 +1111,16 @@ var LocationsResource = class {
       path,
       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
-    }));
+    return n(data, (node) => {
+      const id = node.id !== void 0 ? String(node.id) : void 0;
+      return {
+        id,
+        // Neighborhood rows have no code; `code` mirrors the id (as it always did in practice).
+        code: id ?? "",
+        name: node.name,
+        postCode: typeof node.postCode === "string" ? node.postCode : void 0
+      };
+    });
   }
 };
 var MAX_PAGE_SIZE = 200;
@@ -2473,29 +2476,35 @@ var VALID_TYPES = /* @__PURE__ */ new Set([
   "WAREHOUSE"
 ]);
 function normalizeAddressType(raw) {
-  if (raw && VALID_TYPES.has(raw)) {
-    return raw;
+  const upper = typeof raw === "string" ? raw.toUpperCase() : void 0;
+  if (upper && VALID_TYPES.has(upper)) {
+    return upper;
   }
-  const stripped = raw?.replace(/_ADDRESS$/, "");
+  const stripped = upper?.replace(/_ADDRESS$/, "");
   if (stripped && VALID_TYPES.has(stripped)) {
     return stripped;
   }
   return "SHIPMENT";
 }
+function optionalString(value) {
+  return typeof value === "number" || typeof value === "string" ? String(value) : void 0;
+}
 function normalizeAddress2(node) {
   return {
     id: String(node.id),
-    name: node.name,
     addressType: normalizeAddressType(node.addressType),
     isShipmentAddress: node.isShipmentAddress ?? false,
     isReturningAddress: node.isReturningAddress ?? false,
     isInvoiceAddress: node.isInvoiceAddress ?? false,
     isDefault: node.isDefault ?? false,
     address: node.address,
+    fullAddress: node.fullAddress,
+    country: node.country,
     city: node.city,
+    cityCode: optionalString(node.cityCode),
     district: node.district,
-    postCode: node.postCode,
-    fullName: node.fullName
+    districtId: optionalString(node.districtId),
+    postCode: node.postCode
   };
 }
 var DEFAULT_CACHE_TTL_MS = 60 * 60 * 1e3;