@lonca/trendyol 1.0.1 → 1.1.0

package/dist/{client-CnDyop_o.d.cts → client-Bp0jKEU7.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';
@@ -797,6 +810,13 @@ 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>;
 }
@@ -1273,6 +1293,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;
@@ -2749,6 +2770,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-Bp0jKEU7.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';
@@ -797,6 +810,13 @@ 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>;
 }
@@ -1273,6 +1293,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;
@@ -2749,6 +2770,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) {
@@ -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) {
@@ -2943,7 +2962,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);
 }