@lonca/trendyol 1.0.1 → 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-CnDyop_o.d.cts → client-BhSJFkFo.d.cts}

@@ -45,6 +45,11 @@ declare class TrendyolTransport {
 interface Brand {
     id: string;
     name: string;
+    /**
+     * Whether Trendyol flags the brand as a luxury brand. Undocumented by Trendyol but sent on
+     * every brand of the prod `brands.list` response; omitted when the response lacks it.
+     */
+    luxe?: boolean;
 }
 
 /**
@@ -63,6 +68,14 @@ declare class BrandsResource {
     /**
      * List Trendyol brands, one page at a time.
      *
+     * **Next-page heuristic.** Trendyol's brand list carries no page count (neither the docs
+     * nor the prod wire have `totalPages` / `totalElements` — the response is just
+     * `{ brands: [...] }`). So when `totalPages` is absent, a **full page** (at least `limit`
+     * brands — Trendyol may send ~1000 even for a smaller `limit`) means "there may be more"
+     * and sets `nextCursor`; a short page is the last one. When the
+     * total is an exact multiple of the page size, `paginate()` makes one extra request that
+     * comes back empty and stops there. If Trendyol ever sends `totalPages`, it wins.
+     *
      * @example
      * ```ts
      * import { paginate } from '@lonca/core';
@@ -147,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[];
 }
@@ -193,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.
      *
@@ -797,22 +810,47 @@ interface City {
     id?: string;
     code: string;
     name?: string;
+    /**
+     * The country the city belongs to — the country code of the lookup that returned it
+     * (`'TR'` for `getTurkeyCities`, `'AZ'` for `getAzerbaijanCities`, the argument of
+     * `getCitiesByCountry`). Trendyol's city rows carry no country field (neither the docs nor
+     * the prod wire), so the SDK fills it from the request; earlier versions read a wire field
+     * that never arrives and always left it `undefined`.
+     */
     countryCode?: string;
     raw: Record<string, unknown>;
 }
 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>;
 }
@@ -1273,6 +1311,7 @@ declare class LocationsResource {
     getAzerbaijanDistricts(cityId: string | number): Promise<District[]>;
     getCitiesByCountry(countryCode: string): Promise<City[]>;
     getDistrictsByCity(countryCode: string, cityId: string | number): Promise<District[]>;
+    /** `countryCode` is the lookup's country — city rows do not carry one on the wire. */
     private cities;
     private districts;
     private neighborhoods;
@@ -2392,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;
 }
 
@@ -2749,6 +2806,11 @@ interface CreateClientOptions {
     logger?: Logger;
     /** Request timeout in ms. Default: 30_000. */
     timeoutMs?: number;
+    /**
+     * Custom `fetch` implementation (e.g. to add a proxy agent, record or mock
+     * traffic). Defaults to the global `fetch`.
+     */
+    fetch?: typeof fetch;
 }
 interface TrendyolClient {
     brands: BrandsResource;

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

@@ -45,6 +45,11 @@ declare class TrendyolTransport {
 interface Brand {
     id: string;
     name: string;
+    /**
+     * Whether Trendyol flags the brand as a luxury brand. Undocumented by Trendyol but sent on
+     * every brand of the prod `brands.list` response; omitted when the response lacks it.
+     */
+    luxe?: boolean;
 }
 
 /**
@@ -63,6 +68,14 @@ declare class BrandsResource {
     /**
      * List Trendyol brands, one page at a time.
      *
+     * **Next-page heuristic.** Trendyol's brand list carries no page count (neither the docs
+     * nor the prod wire have `totalPages` / `totalElements` — the response is just
+     * `{ brands: [...] }`). So when `totalPages` is absent, a **full page** (at least `limit`
+     * brands — Trendyol may send ~1000 even for a smaller `limit`) means "there may be more"
+     * and sets `nextCursor`; a short page is the last one. When the
+     * total is an exact multiple of the page size, `paginate()` makes one extra request that
+     * comes back empty and stops there. If Trendyol ever sends `totalPages`, it wins.
+     *
      * @example
      * ```ts
      * import { paginate } from '@lonca/core';
@@ -147,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[];
 }
@@ -193,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.
      *
@@ -797,22 +810,47 @@ interface City {
     id?: string;
     code: string;
     name?: string;
+    /**
+     * The country the city belongs to — the country code of the lookup that returned it
+     * (`'TR'` for `getTurkeyCities`, `'AZ'` for `getAzerbaijanCities`, the argument of
+     * `getCitiesByCountry`). Trendyol's city rows carry no country field (neither the docs nor
+     * the prod wire), so the SDK fills it from the request; earlier versions read a wire field
+     * that never arrives and always left it `undefined`.
+     */
     countryCode?: string;
     raw: Record<string, unknown>;
 }
 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>;
 }
@@ -1273,6 +1311,7 @@ declare class LocationsResource {
     getAzerbaijanDistricts(cityId: string | number): Promise<District[]>;
     getCitiesByCountry(countryCode: string): Promise<City[]>;
     getDistrictsByCity(countryCode: string, cityId: string | number): Promise<District[]>;
+    /** `countryCode` is the lookup's country — city rows do not carry one on the wire. */
     private cities;
     private districts;
     private neighborhoods;
@@ -2392,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;
 }
 
@@ -2749,6 +2806,11 @@ interface CreateClientOptions {
     logger?: Logger;
     /** Request timeout in ms. Default: 30_000. */
     timeoutMs?: number;
+    /**
+     * Custom `fetch` implementation (e.g. to add a proxy agent, record or mock
+     * traffic). Defaults to the global `fetch`.
+     */
+    fetch?: typeof fetch;
 }
 interface TrendyolClient {
     brands: BrandsResource;

package/dist/index.cjs

@@ -4,6 +4,11 @@ var core = require('@lonca/core');
 
 // src/resources/brands.ts
 var DEFAULT_PAGE_SIZE = 1e3;
+function toBrand(node) {
+  const brand = { id: String(node.id), name: node.name };
+  if (typeof node.luxe === "boolean") brand.luxe = node.luxe;
+  return brand;
+}
 var BrandsResource = class {
   constructor(transport, limiter) {
     this.transport = transport;
@@ -14,6 +19,14 @@ var BrandsResource = class {
   /**
    * List Trendyol brands, one page at a time.
    *
+   * **Next-page heuristic.** Trendyol's brand list carries no page count (neither the docs
+   * nor the prod wire have `totalPages` / `totalElements` — the response is just
+   * `{ brands: [...] }`). So when `totalPages` is absent, a **full page** (at least `limit`
+   * brands — Trendyol may send ~1000 even for a smaller `limit`) means "there may be more"
+   * and sets `nextCursor`; a short page is the last one. When the
+   * total is an exact multiple of the page size, `paginate()` makes one extra request that
+   * comes back empty and stops there. If Trendyol ever sends `totalPages`, it wins.
+   *
    * @example
    * ```ts
    * import { paginate } from '@lonca/core';
@@ -31,8 +44,10 @@ var BrandsResource = class {
       query: { page, size },
       rateLimiter: this.limiter
     });
-    const items = data.brands.map((b) => ({ id: String(b.id), name: b.name }));
-    const nextCursor = page + 1 < data.totalPages ? String(page + 1) : void 0;
+    const brands = data?.brands ?? [];
+    const items = brands.map(toBrand);
+    const hasMore = typeof data?.totalPages === "number" ? page + 1 < data.totalPages : size > 0 && brands.length >= size;
+    const nextCursor = hasMore ? String(page + 1) : void 0;
     return nextCursor !== void 0 ? { items, nextCursor } : { items };
   }
   /**
@@ -56,7 +71,7 @@ var BrandsResource = class {
       query: { name },
       rateLimiter: this.limiter
     });
-    return (data ?? []).map((b) => ({ id: String(b.id), name: b.name }));
+    return (data ?? []).map(toBrand);
   }
 };
 function normalizeCategory(node) {
@@ -69,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,
@@ -77,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);
@@ -139,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.
    *
@@ -1021,7 +1036,7 @@ var LocationsResource = class {
   }
   // ─── Domestic (TR / AZ) ───────────────────────────────────────────────
   async getTurkeyCities() {
-    return this.cities(`/integration/member/countries/domestic/TR/cities`);
+    return this.cities(`/integration/member/countries/domestic/TR/cities`, "TR");
   }
   /**
    * List districts for a Turkish city. **Pass the city `id`** (`City.id`) — the
@@ -1043,7 +1058,7 @@ var LocationsResource = class {
     );
   }
   async getAzerbaijanCities() {
-    return this.cities(`/integration/member/countries/domestic/AZ/cities`);
+    return this.cities(`/integration/member/countries/domestic/AZ/cities`, "AZ");
   }
   /** List districts for an Azerbaijani city. **Pass the city `id`** (`City.id`), not `code`. */
   async getAzerbaijanDistricts(cityId) {
@@ -1053,7 +1068,10 @@ var LocationsResource = class {
   }
   // ─── International (GULF / CEE) ───────────────────────────────────────
   async getCitiesByCountry(countryCode) {
-    return this.cities(`/integration/member/countries/${encodeURIComponent(countryCode)}/cities`);
+    return this.cities(
+      `/integration/member/countries/${encodeURIComponent(countryCode)}/cities`,
+      countryCode
+    );
   }
   async getDistrictsByCity(countryCode, cityId) {
     return this.districts(
@@ -1061,7 +1079,8 @@ var LocationsResource = class {
     );
   }
   // ─── Shared paginators ────────────────────────────────────────────────
-  async cities(path) {
+  /** `countryCode` is the lookup's country — city rows do not carry one on the wire. */
+  async cities(path, countryCode) {
     const data = await this.transport.request({
       method: "GET",
       path,
@@ -1071,7 +1090,7 @@ var LocationsResource = class {
       id: node.id !== void 0 ? String(node.id) : void 0,
       code: String(node.code ?? node.id ?? ""),
       name: node.name,
-      countryCode: node.countryCode
+      countryCode
     }));
   }
   async districts(path) {
@@ -1083,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) {
@@ -1093,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;
@@ -2454,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;
@@ -2943,7 +2971,8 @@ function createTrendyolClient(opts) {
     integratorName: opts.integratorName,
     clientIp: opts.clientIp,
     logger: opts.logger,
-    timeoutMs: opts.timeoutMs
+    timeoutMs: opts.timeoutMs,
+    fetch: opts.fetch
   });
   return buildClient(transport);
 }