@lonca/trendyol 0.1.0

package/README.md

@@ -0,0 +1,59 @@
+# @lonca/trendyol
+
+Type-safe TypeScript SDK for the [Trendyol Marketplace API](https://developers.trendyol.com).
+
+> ⚠️ **Alpha** — Only the `brands` resource is implemented in this initial scaffold. More endpoints (orders, products, inventory, webhooks) land in follow-up releases.
+
+## Install
+
+```bash
+pnpm add @lonca/trendyol
+```
+
+## Quick start
+
+```ts
+import { createTrendyolClient } from '@lonca/trendyol';
+import { paginate } from '@lonca/core';
+
+const client = createTrendyolClient({
+  sellerId: 12345,
+  apiKey: process.env.TRENDYOL_API_KEY!,
+  apiSecret: process.env.TRENDYOL_API_SECRET!,
+  env: 'stage', // or 'prod'
+  integratorName: 'MyCompany', // optional; defaults to 'SelfIntegration'
+});
+
+for await (const brand of paginate((p) => client.brands.list(p))) {
+  console.log(brand.id, brand.name);
+}
+```
+
+## Authentication
+
+Trendyol uses HTTP Basic Auth. Get your `sellerId`, `apiKey`, and `apiSecret` from the [Trendyol Partner Panel → Account Info → Integration Information](https://partner.trendyol.com/account/info?tab=integrationInformation) (master-user only).
+
+**Production vs Stage** have different credentials. Stage also requires IP whitelisting — register your CI/server IP with Trendyol support.
+
+## Built-in robustness
+
+- **Retry with exponential backoff** on 429 (respects `Retry-After`) and 5xx
+- **Per-endpoint rate limiting** (token bucket) sized to Trendyol's documented limits
+- **Structured errors** via `@lonca/core` (`AuthError`, `RateLimitError`, `NotFoundError`, `ServerError`, `ValidationError`, `NetworkError`, `TimeoutError`)
+- **Correlation ID** auto-generated per request (`x-correlationid` header) for Trendyol-side log tracing
+- **`AbortSignal` support** for cancellation throughout
+
+## Environments
+
+| Env     | Base URL                          | Notes                                         |
+| ------- | --------------------------------- | --------------------------------------------- |
+| `prod`  | `https://apigw.trendyol.com`      | No IP whitelist                               |
+| `stage` | `https://stageapigw.trendyol.com` | IP whitelist required — call Trendyol support |
+
+## Stability
+
+`0.x` — alpha. Public APIs may change between minor versions until `1.0.0`.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,249 @@
+'use strict';
+
+var core = require('@lonca/core');
+var crypto = require('crypto');
+
+// src/resources/brands.ts
+var DEFAULT_PAGE_SIZE = 1e3;
+var BrandsResource = class {
+  constructor(transport, limiter) {
+    this.transport = transport;
+    this.limiter = limiter ?? new core.TokenBucketRateLimiter({ capacity: 50, intervalMs: 6e4 });
+  }
+  transport;
+  limiter;
+  /**
+   * List Trendyol brands, one page at a time.
+   *
+   * @example
+   * ```ts
+   * import { paginate } from '@lonca/core';
+   * for await (const brand of paginate((p) => client.brands.list(p))) {
+   *   console.log(brand.id, brand.name);
+   * }
+   * ```
+   */
+  async list(params = {}) {
+    const page = params.cursor ? Number.parseInt(params.cursor, 10) : 0;
+    const size = params.limit ?? DEFAULT_PAGE_SIZE;
+    const data = await this.transport.request({
+      method: "GET",
+      path: "/sapigw/brands",
+      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;
+    return nextCursor !== void 0 ? { items, nextCursor } : { items };
+  }
+};
+
+// src/auth.ts
+function buildAuthHeader(apiKey, apiSecret) {
+  const token = Buffer.from(`${apiKey}:${apiSecret}`, "utf8").toString("base64");
+  return `Basic ${token}`;
+}
+function buildUserAgent(sellerId, integratorName = "SelfIntegration") {
+  return `${sellerId} - ${integratorName}`;
+}
+function mapHttpError(status, body, retryAfterMs) {
+  const data = { body };
+  switch (status) {
+    case 401:
+      return new core.AuthError({
+        message: "Trendyol authentication failed (check apiKey / apiSecret)",
+        status,
+        data
+      });
+    case 403:
+      return new core.ValidationError({
+        message: "Trendyol forbidden (check User-Agent header or endpoint path)",
+        status,
+        data
+      });
+    case 404:
+      return new core.NotFoundError({ message: "Trendyol resource not found", status, data });
+    case 429:
+      return new core.RateLimitError({
+        message: "Trendyol rate limit exceeded",
+        status,
+        retryAfterMs,
+        data
+      });
+    case 500:
+    case 502:
+    case 503:
+    case 504:
+      return new core.ServerError({
+        message: `Trendyol server error (${status})`,
+        status,
+        data
+      });
+    default:
+      return new core.LoncaError({
+        code: "UNKNOWN",
+        message: `Trendyol unexpected response (${status})`,
+        status,
+        data,
+        retryable: false
+      });
+  }
+}
+function parseRetryAfter(header) {
+  if (!header) return void 0;
+  const seconds = Number(header);
+  if (!Number.isNaN(seconds)) return Math.max(0, seconds * 1e3);
+  const epoch = Date.parse(header);
+  if (!Number.isNaN(epoch)) return Math.max(0, epoch - Date.now());
+  return void 0;
+}
+
+// src/transport.ts
+var BASE_URLS = {
+  prod: "https://apigw.trendyol.com",
+  stage: "https://stageapigw.trendyol.com"
+};
+var TrendyolTransport = class {
+  constructor(config) {
+    this.config = config;
+    this.baseUrl = BASE_URLS[config.env];
+    this.logger = config.logger ?? core.noopLogger;
+    this.timeoutMs = config.timeoutMs ?? 3e4;
+    this.fetchImpl = config.fetch ?? fetch;
+  }
+  config;
+  baseUrl;
+  logger;
+  timeoutMs;
+  fetchImpl;
+  async request(opts) {
+    return core.retry(
+      async (attempt) => {
+        if (opts.rateLimiter) await opts.rateLimiter.acquire(opts.signal);
+        const url = this.buildUrl(opts.path, opts.query);
+        const correlationId = crypto.randomUUID();
+        const headers = this.buildHeaders(correlationId);
+        const init = {
+          method: opts.method,
+          headers,
+          signal: this.composeSignal(opts.signal)
+        };
+        if (opts.body !== void 0 && opts.method !== "GET") {
+          init.body = JSON.stringify(opts.body);
+        }
+        this.logger.debug("trendyol.request", {
+          method: opts.method,
+          url,
+          correlationId,
+          attempt
+        });
+        let response;
+        try {
+          response = await this.fetchImpl(url, init);
+        } catch (err) {
+          if (err instanceof Error && err.name === "AbortError") {
+            throw new core.TimeoutError({
+              message: `Trendyol request timed out after ${this.timeoutMs}ms`,
+              cause: err
+            });
+          }
+          throw new core.NetworkError({
+            message: "Trendyol network failure",
+            cause: err
+          });
+        }
+        if (!response.ok) {
+          const body = await safeJson(response);
+          const retryAfterMs = parseRetryAfter(response.headers.get("retry-after"));
+          const error = mapHttpError(response.status, body, retryAfterMs);
+          this.logger.warn("trendyol.error", {
+            method: opts.method,
+            url,
+            correlationId,
+            status: response.status,
+            code: error.code,
+            retryable: error.retryable
+          });
+          throw error;
+        }
+        this.logger.debug("trendyol.response", {
+          correlationId,
+          status: response.status
+        });
+        if (response.status === 204) return void 0;
+        return await safeJson(response);
+      },
+      {
+        signal: opts.signal,
+        onRetry: (err, attempt, delay) => {
+          if (err instanceof core.LoncaError) {
+            this.logger.warn("trendyol.retry", {
+              attempt,
+              delayMs: delay,
+              code: err.code,
+              status: err.status
+            });
+          }
+        }
+      }
+    );
+  }
+  buildUrl(path, query) {
+    const url = new URL(path, this.baseUrl);
+    if (query) {
+      for (const [key, value] of Object.entries(query)) {
+        if (value === void 0) continue;
+        url.searchParams.set(key, String(value));
+      }
+    }
+    return url.toString();
+  }
+  buildHeaders(correlationId) {
+    const integratorName = this.config.integratorName ?? "SelfIntegration";
+    return {
+      Authorization: buildAuthHeader(this.config.apiKey, this.config.apiSecret),
+      "x-clientip": this.config.clientIp ?? "127.0.0.1",
+      "x-correlationid": correlationId,
+      "x-agentname": integratorName,
+      "User-Agent": buildUserAgent(this.config.sellerId, integratorName),
+      "Content-Type": "application/json",
+      Accept: "application/json"
+    };
+  }
+  composeSignal(external) {
+    const timeoutSignal = AbortSignal.timeout(this.timeoutMs);
+    if (!external) return timeoutSignal;
+    return AbortSignal.any([external, timeoutSignal]);
+  }
+};
+async function safeJson(response) {
+  const text = await response.text();
+  if (!text) return void 0;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+
+// src/client.ts
+function createTrendyolClient(opts) {
+  const transport = new TrendyolTransport({
+    sellerId: opts.sellerId,
+    apiKey: opts.apiKey,
+    apiSecret: opts.apiSecret,
+    env: opts.env,
+    integratorName: opts.integratorName,
+    clientIp: opts.clientIp,
+    logger: opts.logger,
+    timeoutMs: opts.timeoutMs
+  });
+  return {
+    brands: new BrandsResource(transport)
+  };
+}
+
+exports.BrandsResource = BrandsResource;
+exports.createTrendyolClient = createTrendyolClient;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/brands.ts","../src/auth.ts","../src/errors.ts","../src/transport.ts","../src/client.ts"],"names":["TokenBucketRateLimiter","AuthError","ValidationError","NotFoundError","RateLimitError","ServerError","LoncaError","noopLogger","retry","randomUUID","TimeoutError","NetworkError"],"mappings":"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","file":"index.cjs","sourcesContent":["import { TokenBucketRateLimiter, type CursorPage, type CursorPaginationParams } from '@lonca/core';\nimport type { TrendyolTransport } from '../transport.js';\nimport type { Brand } from '../types/brand.js';\n\n/** Default page size when callers don't specify `limit`. Trendyol allows up to 1000. */\nconst DEFAULT_PAGE_SIZE = 1000;\n\ninterface TrendyolBrandListResponse {\n  brands: Array<{ id: number; name: string }>;\n  totalPages: number;\n  totalElements: number;\n}\n\n/**\n * Trendyol brand-list endpoint group.\n *\n * Rate limit: 50 req/min (per Trendyol service limits).\n *\n * Trendyol uses page-based pagination internally; we expose the cursor-based\n * `CursorPage` shape from `@lonca/core` so callers can drive everything with\n * `paginate()` and stay consistent across Lonca SDKs.\n */\nexport class BrandsResource {\n  private readonly limiter: TokenBucketRateLimiter;\n\n  constructor(\n    private readonly transport: TrendyolTransport,\n    limiter?: TokenBucketRateLimiter,\n  ) {\n    this.limiter = limiter ?? new TokenBucketRateLimiter({ capacity: 50, intervalMs: 60_000 });\n  }\n\n  /**\n   * List Trendyol brands, one page at a time.\n   *\n   * @example\n   * ```ts\n   * import { paginate } from '@lonca/core';\n   * for await (const brand of paginate((p) => client.brands.list(p))) {\n   *   console.log(brand.id, brand.name);\n   * }\n   * ```\n   */\n  async list(params: CursorPaginationParams = {}): Promise<CursorPage<Brand>> {\n    const page = params.cursor ? Number.parseInt(params.cursor, 10) : 0;\n    const size = params.limit ?? DEFAULT_PAGE_SIZE;\n\n    const data = await this.transport.request<TrendyolBrandListResponse>({\n      method: 'GET',\n      path: '/sapigw/brands',\n      query: { page, size },\n      rateLimiter: this.limiter,\n    });\n\n    const items: Brand[] = data.brands.map((b) => ({ id: String(b.id), name: b.name }));\n    const nextCursor = page + 1 < data.totalPages ? String(page + 1) : undefined;\n\n    return nextCursor !== undefined ? { items, nextCursor } : { items };\n  }\n}\n","/** Build the HTTP Basic auth header value from Trendyol credentials. */\nexport function buildAuthHeader(apiKey: string, apiSecret: string): string {\n  const token = Buffer.from(`${apiKey}:${apiSecret}`, 'utf8').toString('base64');\n  return `Basic ${token}`;\n}\n\n/**\n * Build the `User-Agent` header value Trendyol expects.\n *\n * Per Trendyol's docs:\n * - Solo integrators: `\"<sellerId> - SelfIntegration\"`\n * - Integrator companies: `\"<sellerId> - <CompanyName>\"` (alphanumeric, max 30 chars)\n *\n * A missing or malformed `User-Agent` triggers HTTP 403.\n */\nexport function buildUserAgent(sellerId: number, integratorName = 'SelfIntegration'): string {\n  return `${sellerId} - ${integratorName}`;\n}\n","import {\n  AuthError,\n  LoncaError,\n  NotFoundError,\n  RateLimitError,\n  ServerError,\n  ValidationError,\n} from '@lonca/core';\n\n/**\n * Map a Trendyol HTTP response status to a `@lonca/core` error.\n *\n * - `401` → `AuthError` (bad credentials)\n * - `403` → `ValidationError` (usually missing/malformed `User-Agent` header, or wrong endpoint path)\n * - `404` → `NotFoundError`\n * - `429` → `RateLimitError` (carries `retryAfterMs` if the server provided `Retry-After`)\n * - `5xx` → `ServerError` (retryable)\n * - other → `LoncaError` with code `UNKNOWN` (non-retryable)\n */\nexport function mapHttpError(status: number, body: unknown, retryAfterMs?: number): LoncaError {\n  const data = { body } as Record<string, unknown>;\n  switch (status) {\n    case 401:\n      return new AuthError({\n        message: 'Trendyol authentication failed (check apiKey / apiSecret)',\n        status,\n        data,\n      });\n    case 403:\n      return new ValidationError({\n        message: 'Trendyol forbidden (check User-Agent header or endpoint path)',\n        status,\n        data,\n      });\n    case 404:\n      return new NotFoundError({ message: 'Trendyol resource not found', status, data });\n    case 429:\n      return new RateLimitError({\n        message: 'Trendyol rate limit exceeded',\n        status,\n        retryAfterMs,\n        data,\n      });\n    case 500:\n    case 502:\n    case 503:\n    case 504:\n      return new ServerError({\n        message: `Trendyol server error (${status})`,\n        status,\n        data,\n      });\n    default:\n      return new LoncaError({\n        code: 'UNKNOWN',\n        message: `Trendyol unexpected response (${status})`,\n        status,\n        data,\n        retryable: false,\n      });\n  }\n}\n\n/** Parse a `Retry-After` header value (seconds OR HTTP-date) into milliseconds. */\nexport function parseRetryAfter(header: string | null): number | undefined {\n  if (!header) return undefined;\n  const seconds = Number(header);\n  if (!Number.isNaN(seconds)) return Math.max(0, seconds * 1000);\n  const epoch = Date.parse(header);\n  if (!Number.isNaN(epoch)) return Math.max(0, epoch - Date.now());\n  return undefined;\n}\n","import { randomUUID } from 'node:crypto';\nimport {\n  LoncaError,\n  NetworkError,\n  TimeoutError,\n  retry,\n  noopLogger,\n  type Logger,\n  type TokenBucketRateLimiter,\n} from '@lonca/core';\nimport { buildAuthHeader, buildUserAgent } from './auth.js';\nimport { mapHttpError, parseRetryAfter } from './errors.js';\n\nconst BASE_URLS = {\n  prod: 'https://apigw.trendyol.com',\n  stage: 'https://stageapigw.trendyol.com',\n} as const;\n\nexport type TrendyolEnvironment = keyof typeof BASE_URLS;\n\nexport interface TransportConfig {\n  sellerId: number;\n  apiKey: string;\n  apiSecret: string;\n  env: TrendyolEnvironment;\n  integratorName?: string;\n  clientIp?: string;\n  logger?: Logger;\n  /** Request timeout in ms. Default: 30_000. */\n  timeoutMs?: number;\n  /** Override the underlying `fetch` (tests inject a mock). */\n  fetch?: typeof fetch;\n}\n\nexport interface RequestOptions {\n  method: 'GET' | 'POST' | 'PUT' | 'DELETE';\n  /** Path beginning with `/` (e.g., `/sapigw/brands`). */\n  path: string;\n  query?: Record<string, string | number | boolean | undefined>;\n  body?: unknown;\n  signal?: AbortSignal;\n  /** Per-endpoint rate limiter; acquire one token before each attempt. */\n  rateLimiter?: TokenBucketRateLimiter;\n}\n\nexport class TrendyolTransport {\n  private readonly baseUrl: string;\n  private readonly logger: Logger;\n  private readonly timeoutMs: number;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(private readonly config: TransportConfig) {\n    this.baseUrl = BASE_URLS[config.env];\n    this.logger = config.logger ?? noopLogger;\n    this.timeoutMs = config.timeoutMs ?? 30_000;\n    this.fetchImpl = config.fetch ?? fetch;\n  }\n\n  async request<T>(opts: RequestOptions): Promise<T> {\n    return retry(\n      async (attempt) => {\n        if (opts.rateLimiter) await opts.rateLimiter.acquire(opts.signal);\n\n        const url = this.buildUrl(opts.path, opts.query);\n        const correlationId = randomUUID();\n        const headers = this.buildHeaders(correlationId);\n        const init: RequestInit = {\n          method: opts.method,\n          headers,\n          signal: this.composeSignal(opts.signal),\n        };\n        if (opts.body !== undefined && opts.method !== 'GET') {\n          init.body = JSON.stringify(opts.body);\n        }\n\n        this.logger.debug('trendyol.request', {\n          method: opts.method,\n          url,\n          correlationId,\n          attempt,\n        });\n\n        let response: Response;\n        try {\n          response = await this.fetchImpl(url, init);\n        } catch (err) {\n          if (err instanceof Error && err.name === 'AbortError') {\n            throw new TimeoutError({\n              message: `Trendyol request timed out after ${this.timeoutMs}ms`,\n              cause: err,\n            });\n          }\n          throw new NetworkError({\n            message: 'Trendyol network failure',\n            cause: err,\n          });\n        }\n\n        if (!response.ok) {\n          const body = await safeJson(response);\n          const retryAfterMs = parseRetryAfter(response.headers.get('retry-after'));\n          const error = mapHttpError(response.status, body, retryAfterMs);\n          this.logger.warn('trendyol.error', {\n            method: opts.method,\n            url,\n            correlationId,\n            status: response.status,\n            code: error.code,\n            retryable: error.retryable,\n          });\n          throw error;\n        }\n\n        this.logger.debug('trendyol.response', {\n          correlationId,\n          status: response.status,\n        });\n\n        if (response.status === 204) return undefined as T;\n        return (await safeJson(response)) as T;\n      },\n      {\n        signal: opts.signal,\n        onRetry: (err, attempt, delay) => {\n          if (err instanceof LoncaError) {\n            this.logger.warn('trendyol.retry', {\n              attempt,\n              delayMs: delay,\n              code: err.code,\n              status: err.status,\n            });\n          }\n        },\n      },\n    );\n  }\n\n  private buildUrl(path: string, query?: RequestOptions['query']): string {\n    const url = new URL(path, this.baseUrl);\n    if (query) {\n      for (const [key, value] of Object.entries(query)) {\n        if (value === undefined) continue;\n        url.searchParams.set(key, String(value));\n      }\n    }\n    return url.toString();\n  }\n\n  private buildHeaders(correlationId: string): Record<string, string> {\n    const integratorName = this.config.integratorName ?? 'SelfIntegration';\n    return {\n      Authorization: buildAuthHeader(this.config.apiKey, this.config.apiSecret),\n      'x-clientip': this.config.clientIp ?? '127.0.0.1',\n      'x-correlationid': correlationId,\n      'x-agentname': integratorName,\n      'User-Agent': buildUserAgent(this.config.sellerId, integratorName),\n      'Content-Type': 'application/json',\n      Accept: 'application/json',\n    };\n  }\n\n  private composeSignal(external?: AbortSignal): AbortSignal {\n    const timeoutSignal = AbortSignal.timeout(this.timeoutMs);\n    if (!external) return timeoutSignal;\n    return AbortSignal.any([external, timeoutSignal]);\n  }\n}\n\nasync function safeJson(response: Response): Promise<unknown> {\n  const text = await response.text();\n  if (!text) return undefined;\n  try {\n    return JSON.parse(text);\n  } catch {\n    return text;\n  }\n}\n","import type { Logger } from '@lonca/core';\nimport { BrandsResource } from './resources/brands.js';\nimport { TrendyolTransport, type TrendyolEnvironment } from './transport.js';\n\nexport interface CreateClientOptions {\n  /** Trendyol seller (supplier) ID — visible in Partner Panel → Account Info. */\n  sellerId: number;\n  /** Trendyol API key. */\n  apiKey: string;\n  /** Trendyol API secret. */\n  apiSecret: string;\n  /** Which Trendyol environment to target. */\n  env: TrendyolEnvironment;\n  /**\n   * Integrator company name to send in `User-Agent` / `x-agentname`.\n   * Defaults to `'SelfIntegration'` if the seller owns the integration code.\n   * Trendyol caps this at 30 alphanumeric characters.\n   */\n  integratorName?: string;\n  /**\n   * IPv4 address to send in `x-clientip`.\n   * Defaults to `'127.0.0.1'` — Trendyol does not validate this against the\n   * request origin, the header just has to be present and IPv4-shaped.\n   */\n  clientIp?: string;\n  /** Optional structured logger (`@lonca/core` `Logger`). Defaults to no-op. */\n  logger?: Logger;\n  /** Request timeout in ms. Default: 30_000. */\n  timeoutMs?: number;\n}\n\nexport interface TrendyolClient {\n  brands: BrandsResource;\n}\n\n/**\n * Create a Trendyol Marketplace SDK client.\n *\n * @example\n * ```ts\n * import { createTrendyolClient } from '@lonca/trendyol';\n *\n * const client = createTrendyolClient({\n *   sellerId: 12345,\n *   apiKey: process.env.TRENDYOL_API_KEY!,\n *   apiSecret: process.env.TRENDYOL_API_SECRET!,\n *   env: 'stage',\n * });\n *\n * const page = await client.brands.list({ limit: 100 });\n * ```\n */\nexport function createTrendyolClient(opts: CreateClientOptions): TrendyolClient {\n  const transport = new TrendyolTransport({\n    sellerId: opts.sellerId,\n    apiKey: opts.apiKey,\n    apiSecret: opts.apiSecret,\n    env: opts.env,\n    integratorName: opts.integratorName,\n    clientIp: opts.clientIp,\n    logger: opts.logger,\n    timeoutMs: opts.timeoutMs,\n  });\n\n  return {\n    brands: new BrandsResource(transport),\n  };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,130 @@
+import { Logger, TokenBucketRateLimiter, CursorPaginationParams, CursorPage } from '@lonca/core';
+
+declare const BASE_URLS: {
+    readonly prod: "https://apigw.trendyol.com";
+    readonly stage: "https://stageapigw.trendyol.com";
+};
+type TrendyolEnvironment = keyof typeof BASE_URLS;
+interface TransportConfig {
+    sellerId: number;
+    apiKey: string;
+    apiSecret: string;
+    env: TrendyolEnvironment;
+    integratorName?: string;
+    clientIp?: string;
+    logger?: Logger;
+    /** Request timeout in ms. Default: 30_000. */
+    timeoutMs?: number;
+    /** Override the underlying `fetch` (tests inject a mock). */
+    fetch?: typeof fetch;
+}
+interface RequestOptions {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    /** Path beginning with `/` (e.g., `/sapigw/brands`). */
+    path: string;
+    query?: Record<string, string | number | boolean | undefined>;
+    body?: unknown;
+    signal?: AbortSignal;
+    /** Per-endpoint rate limiter; acquire one token before each attempt. */
+    rateLimiter?: TokenBucketRateLimiter;
+}
+declare class TrendyolTransport {
+    private readonly config;
+    private readonly baseUrl;
+    private readonly logger;
+    private readonly timeoutMs;
+    private readonly fetchImpl;
+    constructor(config: TransportConfig);
+    request<T>(opts: RequestOptions): Promise<T>;
+    private buildUrl;
+    private buildHeaders;
+    private composeSignal;
+}
+
+/**
+ * A Trendyol marketplace brand.
+ *
+ * Trendyol returns numeric IDs; we normalize to `string` to match the
+ * `@lonca/core` convention (string IDs across all Lonca SDKs).
+ */
+interface Brand {
+    id: string;
+    name: string;
+}
+
+/**
+ * Trendyol brand-list endpoint group.
+ *
+ * Rate limit: 50 req/min (per Trendyol service limits).
+ *
+ * Trendyol uses page-based pagination internally; we expose the cursor-based
+ * `CursorPage` shape from `@lonca/core` so callers can drive everything with
+ * `paginate()` and stay consistent across Lonca SDKs.
+ */
+declare class BrandsResource {
+    private readonly transport;
+    private readonly limiter;
+    constructor(transport: TrendyolTransport, limiter?: TokenBucketRateLimiter);
+    /**
+     * List Trendyol brands, one page at a time.
+     *
+     * @example
+     * ```ts
+     * import { paginate } from '@lonca/core';
+     * for await (const brand of paginate((p) => client.brands.list(p))) {
+     *   console.log(brand.id, brand.name);
+     * }
+     * ```
+     */
+    list(params?: CursorPaginationParams): Promise<CursorPage<Brand>>;
+}
+
+interface CreateClientOptions {
+    /** Trendyol seller (supplier) ID — visible in Partner Panel → Account Info. */
+    sellerId: number;
+    /** Trendyol API key. */
+    apiKey: string;
+    /** Trendyol API secret. */
+    apiSecret: string;
+    /** Which Trendyol environment to target. */
+    env: TrendyolEnvironment;
+    /**
+     * Integrator company name to send in `User-Agent` / `x-agentname`.
+     * Defaults to `'SelfIntegration'` if the seller owns the integration code.
+     * Trendyol caps this at 30 alphanumeric characters.
+     */
+    integratorName?: string;
+    /**
+     * IPv4 address to send in `x-clientip`.
+     * Defaults to `'127.0.0.1'` — Trendyol does not validate this against the
+     * request origin, the header just has to be present and IPv4-shaped.
+     */
+    clientIp?: string;
+    /** Optional structured logger (`@lonca/core` `Logger`). Defaults to no-op. */
+    logger?: Logger;
+    /** Request timeout in ms. Default: 30_000. */
+    timeoutMs?: number;
+}
+interface TrendyolClient {
+    brands: BrandsResource;
+}
+/**
+ * Create a Trendyol Marketplace SDK client.
+ *
+ * @example
+ * ```ts
+ * import { createTrendyolClient } from '@lonca/trendyol';
+ *
+ * const client = createTrendyolClient({
+ *   sellerId: 12345,
+ *   apiKey: process.env.TRENDYOL_API_KEY!,
+ *   apiSecret: process.env.TRENDYOL_API_SECRET!,
+ *   env: 'stage',
+ * });
+ *
+ * const page = await client.brands.list({ limit: 100 });
+ * ```
+ */
+declare function createTrendyolClient(opts: CreateClientOptions): TrendyolClient;
+
+export { type Brand, BrandsResource, type CreateClientOptions, type TrendyolClient, type TrendyolEnvironment, createTrendyolClient };

package/dist/index.d.ts

@@ -0,0 +1,130 @@
+import { Logger, TokenBucketRateLimiter, CursorPaginationParams, CursorPage } from '@lonca/core';
+
+declare const BASE_URLS: {
+    readonly prod: "https://apigw.trendyol.com";
+    readonly stage: "https://stageapigw.trendyol.com";
+};
+type TrendyolEnvironment = keyof typeof BASE_URLS;
+interface TransportConfig {
+    sellerId: number;
+    apiKey: string;
+    apiSecret: string;
+    env: TrendyolEnvironment;
+    integratorName?: string;
+    clientIp?: string;
+    logger?: Logger;
+    /** Request timeout in ms. Default: 30_000. */
+    timeoutMs?: number;
+    /** Override the underlying `fetch` (tests inject a mock). */
+    fetch?: typeof fetch;
+}
+interface RequestOptions {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    /** Path beginning with `/` (e.g., `/sapigw/brands`). */
+    path: string;
+    query?: Record<string, string | number | boolean | undefined>;
+    body?: unknown;
+    signal?: AbortSignal;
+    /** Per-endpoint rate limiter; acquire one token before each attempt. */
+    rateLimiter?: TokenBucketRateLimiter;
+}
+declare class TrendyolTransport {
+    private readonly config;
+    private readonly baseUrl;
+    private readonly logger;
+    private readonly timeoutMs;
+    private readonly fetchImpl;
+    constructor(config: TransportConfig);
+    request<T>(opts: RequestOptions): Promise<T>;
+    private buildUrl;
+    private buildHeaders;
+    private composeSignal;
+}
+
+/**
+ * A Trendyol marketplace brand.
+ *
+ * Trendyol returns numeric IDs; we normalize to `string` to match the
+ * `@lonca/core` convention (string IDs across all Lonca SDKs).
+ */
+interface Brand {
+    id: string;
+    name: string;
+}
+
+/**
+ * Trendyol brand-list endpoint group.
+ *
+ * Rate limit: 50 req/min (per Trendyol service limits).
+ *
+ * Trendyol uses page-based pagination internally; we expose the cursor-based
+ * `CursorPage` shape from `@lonca/core` so callers can drive everything with
+ * `paginate()` and stay consistent across Lonca SDKs.
+ */
+declare class BrandsResource {
+    private readonly transport;
+    private readonly limiter;
+    constructor(transport: TrendyolTransport, limiter?: TokenBucketRateLimiter);
+    /**
+     * List Trendyol brands, one page at a time.
+     *
+     * @example
+     * ```ts
+     * import { paginate } from '@lonca/core';
+     * for await (const brand of paginate((p) => client.brands.list(p))) {
+     *   console.log(brand.id, brand.name);
+     * }
+     * ```
+     */
+    list(params?: CursorPaginationParams): Promise<CursorPage<Brand>>;
+}
+
+interface CreateClientOptions {
+    /** Trendyol seller (supplier) ID — visible in Partner Panel → Account Info. */
+    sellerId: number;
+    /** Trendyol API key. */
+    apiKey: string;
+    /** Trendyol API secret. */
+    apiSecret: string;
+    /** Which Trendyol environment to target. */
+    env: TrendyolEnvironment;
+    /**
+     * Integrator company name to send in `User-Agent` / `x-agentname`.
+     * Defaults to `'SelfIntegration'` if the seller owns the integration code.
+     * Trendyol caps this at 30 alphanumeric characters.
+     */
+    integratorName?: string;
+    /**
+     * IPv4 address to send in `x-clientip`.
+     * Defaults to `'127.0.0.1'` — Trendyol does not validate this against the
+     * request origin, the header just has to be present and IPv4-shaped.
+     */
+    clientIp?: string;
+    /** Optional structured logger (`@lonca/core` `Logger`). Defaults to no-op. */
+    logger?: Logger;
+    /** Request timeout in ms. Default: 30_000. */
+    timeoutMs?: number;
+}
+interface TrendyolClient {
+    brands: BrandsResource;
+}
+/**
+ * Create a Trendyol Marketplace SDK client.
+ *
+ * @example
+ * ```ts
+ * import { createTrendyolClient } from '@lonca/trendyol';
+ *
+ * const client = createTrendyolClient({
+ *   sellerId: 12345,
+ *   apiKey: process.env.TRENDYOL_API_KEY!,
+ *   apiSecret: process.env.TRENDYOL_API_SECRET!,
+ *   env: 'stage',
+ * });
+ *
+ * const page = await client.brands.list({ limit: 100 });
+ * ```
+ */
+declare function createTrendyolClient(opts: CreateClientOptions): TrendyolClient;
+
+export { type Brand, BrandsResource, type CreateClientOptions, type TrendyolClient, type TrendyolEnvironment, createTrendyolClient };

package/dist/index.js

@@ -0,0 +1,246 @@
+import { TokenBucketRateLimiter, noopLogger, retry, TimeoutError, NetworkError, LoncaError, ServerError, RateLimitError, NotFoundError, ValidationError, AuthError } from '@lonca/core';
+import { randomUUID } from 'crypto';
+
+// src/resources/brands.ts
+var DEFAULT_PAGE_SIZE = 1e3;
+var BrandsResource = class {
+  constructor(transport, limiter) {
+    this.transport = transport;
+    this.limiter = limiter ?? new TokenBucketRateLimiter({ capacity: 50, intervalMs: 6e4 });
+  }
+  transport;
+  limiter;
+  /**
+   * List Trendyol brands, one page at a time.
+   *
+   * @example
+   * ```ts
+   * import { paginate } from '@lonca/core';
+   * for await (const brand of paginate((p) => client.brands.list(p))) {
+   *   console.log(brand.id, brand.name);
+   * }
+   * ```
+   */
+  async list(params = {}) {
+    const page = params.cursor ? Number.parseInt(params.cursor, 10) : 0;
+    const size = params.limit ?? DEFAULT_PAGE_SIZE;
+    const data = await this.transport.request({
+      method: "GET",
+      path: "/sapigw/brands",
+      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;
+    return nextCursor !== void 0 ? { items, nextCursor } : { items };
+  }
+};
+
+// src/auth.ts
+function buildAuthHeader(apiKey, apiSecret) {
+  const token = Buffer.from(`${apiKey}:${apiSecret}`, "utf8").toString("base64");
+  return `Basic ${token}`;
+}
+function buildUserAgent(sellerId, integratorName = "SelfIntegration") {
+  return `${sellerId} - ${integratorName}`;
+}
+function mapHttpError(status, body, retryAfterMs) {
+  const data = { body };
+  switch (status) {
+    case 401:
+      return new AuthError({
+        message: "Trendyol authentication failed (check apiKey / apiSecret)",
+        status,
+        data
+      });
+    case 403:
+      return new ValidationError({
+        message: "Trendyol forbidden (check User-Agent header or endpoint path)",
+        status,
+        data
+      });
+    case 404:
+      return new NotFoundError({ message: "Trendyol resource not found", status, data });
+    case 429:
+      return new RateLimitError({
+        message: "Trendyol rate limit exceeded",
+        status,
+        retryAfterMs,
+        data
+      });
+    case 500:
+    case 502:
+    case 503:
+    case 504:
+      return new ServerError({
+        message: `Trendyol server error (${status})`,
+        status,
+        data
+      });
+    default:
+      return new LoncaError({
+        code: "UNKNOWN",
+        message: `Trendyol unexpected response (${status})`,
+        status,
+        data,
+        retryable: false
+      });
+  }
+}
+function parseRetryAfter(header) {
+  if (!header) return void 0;
+  const seconds = Number(header);
+  if (!Number.isNaN(seconds)) return Math.max(0, seconds * 1e3);
+  const epoch = Date.parse(header);
+  if (!Number.isNaN(epoch)) return Math.max(0, epoch - Date.now());
+  return void 0;
+}
+
+// src/transport.ts
+var BASE_URLS = {
+  prod: "https://apigw.trendyol.com",
+  stage: "https://stageapigw.trendyol.com"
+};
+var TrendyolTransport = class {
+  constructor(config) {
+    this.config = config;
+    this.baseUrl = BASE_URLS[config.env];
+    this.logger = config.logger ?? noopLogger;
+    this.timeoutMs = config.timeoutMs ?? 3e4;
+    this.fetchImpl = config.fetch ?? fetch;
+  }
+  config;
+  baseUrl;
+  logger;
+  timeoutMs;
+  fetchImpl;
+  async request(opts) {
+    return retry(
+      async (attempt) => {
+        if (opts.rateLimiter) await opts.rateLimiter.acquire(opts.signal);
+        const url = this.buildUrl(opts.path, opts.query);
+        const correlationId = randomUUID();
+        const headers = this.buildHeaders(correlationId);
+        const init = {
+          method: opts.method,
+          headers,
+          signal: this.composeSignal(opts.signal)
+        };
+        if (opts.body !== void 0 && opts.method !== "GET") {
+          init.body = JSON.stringify(opts.body);
+        }
+        this.logger.debug("trendyol.request", {
+          method: opts.method,
+          url,
+          correlationId,
+          attempt
+        });
+        let response;
+        try {
+          response = await this.fetchImpl(url, init);
+        } catch (err) {
+          if (err instanceof Error && err.name === "AbortError") {
+            throw new TimeoutError({
+              message: `Trendyol request timed out after ${this.timeoutMs}ms`,
+              cause: err
+            });
+          }
+          throw new NetworkError({
+            message: "Trendyol network failure",
+            cause: err
+          });
+        }
+        if (!response.ok) {
+          const body = await safeJson(response);
+          const retryAfterMs = parseRetryAfter(response.headers.get("retry-after"));
+          const error = mapHttpError(response.status, body, retryAfterMs);
+          this.logger.warn("trendyol.error", {
+            method: opts.method,
+            url,
+            correlationId,
+            status: response.status,
+            code: error.code,
+            retryable: error.retryable
+          });
+          throw error;
+        }
+        this.logger.debug("trendyol.response", {
+          correlationId,
+          status: response.status
+        });
+        if (response.status === 204) return void 0;
+        return await safeJson(response);
+      },
+      {
+        signal: opts.signal,
+        onRetry: (err, attempt, delay) => {
+          if (err instanceof LoncaError) {
+            this.logger.warn("trendyol.retry", {
+              attempt,
+              delayMs: delay,
+              code: err.code,
+              status: err.status
+            });
+          }
+        }
+      }
+    );
+  }
+  buildUrl(path, query) {
+    const url = new URL(path, this.baseUrl);
+    if (query) {
+      for (const [key, value] of Object.entries(query)) {
+        if (value === void 0) continue;
+        url.searchParams.set(key, String(value));
+      }
+    }
+    return url.toString();
+  }
+  buildHeaders(correlationId) {
+    const integratorName = this.config.integratorName ?? "SelfIntegration";
+    return {
+      Authorization: buildAuthHeader(this.config.apiKey, this.config.apiSecret),
+      "x-clientip": this.config.clientIp ?? "127.0.0.1",
+      "x-correlationid": correlationId,
+      "x-agentname": integratorName,
+      "User-Agent": buildUserAgent(this.config.sellerId, integratorName),
+      "Content-Type": "application/json",
+      Accept: "application/json"
+    };
+  }
+  composeSignal(external) {
+    const timeoutSignal = AbortSignal.timeout(this.timeoutMs);
+    if (!external) return timeoutSignal;
+    return AbortSignal.any([external, timeoutSignal]);
+  }
+};
+async function safeJson(response) {
+  const text = await response.text();
+  if (!text) return void 0;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+
+// src/client.ts
+function createTrendyolClient(opts) {
+  const transport = new TrendyolTransport({
+    sellerId: opts.sellerId,
+    apiKey: opts.apiKey,
+    apiSecret: opts.apiSecret,
+    env: opts.env,
+    integratorName: opts.integratorName,
+    clientIp: opts.clientIp,
+    logger: opts.logger,
+    timeoutMs: opts.timeoutMs
+  });
+  return {
+    brands: new BrandsResource(transport)
+  };
+}
+
+export { BrandsResource, createTrendyolClient };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/brands.ts","../src/auth.ts","../src/errors.ts","../src/transport.ts","../src/client.ts"],"names":["LoncaError"],"mappings":"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","file":"index.js","sourcesContent":["import { TokenBucketRateLimiter, type CursorPage, type CursorPaginationParams } from '@lonca/core';\nimport type { TrendyolTransport } from '../transport.js';\nimport type { Brand } from '../types/brand.js';\n\n/** Default page size when callers don't specify `limit`. Trendyol allows up to 1000. */\nconst DEFAULT_PAGE_SIZE = 1000;\n\ninterface TrendyolBrandListResponse {\n  brands: Array<{ id: number; name: string }>;\n  totalPages: number;\n  totalElements: number;\n}\n\n/**\n * Trendyol brand-list endpoint group.\n *\n * Rate limit: 50 req/min (per Trendyol service limits).\n *\n * Trendyol uses page-based pagination internally; we expose the cursor-based\n * `CursorPage` shape from `@lonca/core` so callers can drive everything with\n * `paginate()` and stay consistent across Lonca SDKs.\n */\nexport class BrandsResource {\n  private readonly limiter: TokenBucketRateLimiter;\n\n  constructor(\n    private readonly transport: TrendyolTransport,\n    limiter?: TokenBucketRateLimiter,\n  ) {\n    this.limiter = limiter ?? new TokenBucketRateLimiter({ capacity: 50, intervalMs: 60_000 });\n  }\n\n  /**\n   * List Trendyol brands, one page at a time.\n   *\n   * @example\n   * ```ts\n   * import { paginate } from '@lonca/core';\n   * for await (const brand of paginate((p) => client.brands.list(p))) {\n   *   console.log(brand.id, brand.name);\n   * }\n   * ```\n   */\n  async list(params: CursorPaginationParams = {}): Promise<CursorPage<Brand>> {\n    const page = params.cursor ? Number.parseInt(params.cursor, 10) : 0;\n    const size = params.limit ?? DEFAULT_PAGE_SIZE;\n\n    const data = await this.transport.request<TrendyolBrandListResponse>({\n      method: 'GET',\n      path: '/sapigw/brands',\n      query: { page, size },\n      rateLimiter: this.limiter,\n    });\n\n    const items: Brand[] = data.brands.map((b) => ({ id: String(b.id), name: b.name }));\n    const nextCursor = page + 1 < data.totalPages ? String(page + 1) : undefined;\n\n    return nextCursor !== undefined ? { items, nextCursor } : { items };\n  }\n}\n","/** Build the HTTP Basic auth header value from Trendyol credentials. */\nexport function buildAuthHeader(apiKey: string, apiSecret: string): string {\n  const token = Buffer.from(`${apiKey}:${apiSecret}`, 'utf8').toString('base64');\n  return `Basic ${token}`;\n}\n\n/**\n * Build the `User-Agent` header value Trendyol expects.\n *\n * Per Trendyol's docs:\n * - Solo integrators: `\"<sellerId> - SelfIntegration\"`\n * - Integrator companies: `\"<sellerId> - <CompanyName>\"` (alphanumeric, max 30 chars)\n *\n * A missing or malformed `User-Agent` triggers HTTP 403.\n */\nexport function buildUserAgent(sellerId: number, integratorName = 'SelfIntegration'): string {\n  return `${sellerId} - ${integratorName}`;\n}\n","import {\n  AuthError,\n  LoncaError,\n  NotFoundError,\n  RateLimitError,\n  ServerError,\n  ValidationError,\n} from '@lonca/core';\n\n/**\n * Map a Trendyol HTTP response status to a `@lonca/core` error.\n *\n * - `401` → `AuthError` (bad credentials)\n * - `403` → `ValidationError` (usually missing/malformed `User-Agent` header, or wrong endpoint path)\n * - `404` → `NotFoundError`\n * - `429` → `RateLimitError` (carries `retryAfterMs` if the server provided `Retry-After`)\n * - `5xx` → `ServerError` (retryable)\n * - other → `LoncaError` with code `UNKNOWN` (non-retryable)\n */\nexport function mapHttpError(status: number, body: unknown, retryAfterMs?: number): LoncaError {\n  const data = { body } as Record<string, unknown>;\n  switch (status) {\n    case 401:\n      return new AuthError({\n        message: 'Trendyol authentication failed (check apiKey / apiSecret)',\n        status,\n        data,\n      });\n    case 403:\n      return new ValidationError({\n        message: 'Trendyol forbidden (check User-Agent header or endpoint path)',\n        status,\n        data,\n      });\n    case 404:\n      return new NotFoundError({ message: 'Trendyol resource not found', status, data });\n    case 429:\n      return new RateLimitError({\n        message: 'Trendyol rate limit exceeded',\n        status,\n        retryAfterMs,\n        data,\n      });\n    case 500:\n    case 502:\n    case 503:\n    case 504:\n      return new ServerError({\n        message: `Trendyol server error (${status})`,\n        status,\n        data,\n      });\n    default:\n      return new LoncaError({\n        code: 'UNKNOWN',\n        message: `Trendyol unexpected response (${status})`,\n        status,\n        data,\n        retryable: false,\n      });\n  }\n}\n\n/** Parse a `Retry-After` header value (seconds OR HTTP-date) into milliseconds. */\nexport function parseRetryAfter(header: string | null): number | undefined {\n  if (!header) return undefined;\n  const seconds = Number(header);\n  if (!Number.isNaN(seconds)) return Math.max(0, seconds * 1000);\n  const epoch = Date.parse(header);\n  if (!Number.isNaN(epoch)) return Math.max(0, epoch - Date.now());\n  return undefined;\n}\n","import { randomUUID } from 'node:crypto';\nimport {\n  LoncaError,\n  NetworkError,\n  TimeoutError,\n  retry,\n  noopLogger,\n  type Logger,\n  type TokenBucketRateLimiter,\n} from '@lonca/core';\nimport { buildAuthHeader, buildUserAgent } from './auth.js';\nimport { mapHttpError, parseRetryAfter } from './errors.js';\n\nconst BASE_URLS = {\n  prod: 'https://apigw.trendyol.com',\n  stage: 'https://stageapigw.trendyol.com',\n} as const;\n\nexport type TrendyolEnvironment = keyof typeof BASE_URLS;\n\nexport interface TransportConfig {\n  sellerId: number;\n  apiKey: string;\n  apiSecret: string;\n  env: TrendyolEnvironment;\n  integratorName?: string;\n  clientIp?: string;\n  logger?: Logger;\n  /** Request timeout in ms. Default: 30_000. */\n  timeoutMs?: number;\n  /** Override the underlying `fetch` (tests inject a mock). */\n  fetch?: typeof fetch;\n}\n\nexport interface RequestOptions {\n  method: 'GET' | 'POST' | 'PUT' | 'DELETE';\n  /** Path beginning with `/` (e.g., `/sapigw/brands`). */\n  path: string;\n  query?: Record<string, string | number | boolean | undefined>;\n  body?: unknown;\n  signal?: AbortSignal;\n  /** Per-endpoint rate limiter; acquire one token before each attempt. */\n  rateLimiter?: TokenBucketRateLimiter;\n}\n\nexport class TrendyolTransport {\n  private readonly baseUrl: string;\n  private readonly logger: Logger;\n  private readonly timeoutMs: number;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(private readonly config: TransportConfig) {\n    this.baseUrl = BASE_URLS[config.env];\n    this.logger = config.logger ?? noopLogger;\n    this.timeoutMs = config.timeoutMs ?? 30_000;\n    this.fetchImpl = config.fetch ?? fetch;\n  }\n\n  async request<T>(opts: RequestOptions): Promise<T> {\n    return retry(\n      async (attempt) => {\n        if (opts.rateLimiter) await opts.rateLimiter.acquire(opts.signal);\n\n        const url = this.buildUrl(opts.path, opts.query);\n        const correlationId = randomUUID();\n        const headers = this.buildHeaders(correlationId);\n        const init: RequestInit = {\n          method: opts.method,\n          headers,\n          signal: this.composeSignal(opts.signal),\n        };\n        if (opts.body !== undefined && opts.method !== 'GET') {\n          init.body = JSON.stringify(opts.body);\n        }\n\n        this.logger.debug('trendyol.request', {\n          method: opts.method,\n          url,\n          correlationId,\n          attempt,\n        });\n\n        let response: Response;\n        try {\n          response = await this.fetchImpl(url, init);\n        } catch (err) {\n          if (err instanceof Error && err.name === 'AbortError') {\n            throw new TimeoutError({\n              message: `Trendyol request timed out after ${this.timeoutMs}ms`,\n              cause: err,\n            });\n          }\n          throw new NetworkError({\n            message: 'Trendyol network failure',\n            cause: err,\n          });\n        }\n\n        if (!response.ok) {\n          const body = await safeJson(response);\n          const retryAfterMs = parseRetryAfter(response.headers.get('retry-after'));\n          const error = mapHttpError(response.status, body, retryAfterMs);\n          this.logger.warn('trendyol.error', {\n            method: opts.method,\n            url,\n            correlationId,\n            status: response.status,\n            code: error.code,\n            retryable: error.retryable,\n          });\n          throw error;\n        }\n\n        this.logger.debug('trendyol.response', {\n          correlationId,\n          status: response.status,\n        });\n\n        if (response.status === 204) return undefined as T;\n        return (await safeJson(response)) as T;\n      },\n      {\n        signal: opts.signal,\n        onRetry: (err, attempt, delay) => {\n          if (err instanceof LoncaError) {\n            this.logger.warn('trendyol.retry', {\n              attempt,\n              delayMs: delay,\n              code: err.code,\n              status: err.status,\n            });\n          }\n        },\n      },\n    );\n  }\n\n  private buildUrl(path: string, query?: RequestOptions['query']): string {\n    const url = new URL(path, this.baseUrl);\n    if (query) {\n      for (const [key, value] of Object.entries(query)) {\n        if (value === undefined) continue;\n        url.searchParams.set(key, String(value));\n      }\n    }\n    return url.toString();\n  }\n\n  private buildHeaders(correlationId: string): Record<string, string> {\n    const integratorName = this.config.integratorName ?? 'SelfIntegration';\n    return {\n      Authorization: buildAuthHeader(this.config.apiKey, this.config.apiSecret),\n      'x-clientip': this.config.clientIp ?? '127.0.0.1',\n      'x-correlationid': correlationId,\n      'x-agentname': integratorName,\n      'User-Agent': buildUserAgent(this.config.sellerId, integratorName),\n      'Content-Type': 'application/json',\n      Accept: 'application/json',\n    };\n  }\n\n  private composeSignal(external?: AbortSignal): AbortSignal {\n    const timeoutSignal = AbortSignal.timeout(this.timeoutMs);\n    if (!external) return timeoutSignal;\n    return AbortSignal.any([external, timeoutSignal]);\n  }\n}\n\nasync function safeJson(response: Response): Promise<unknown> {\n  const text = await response.text();\n  if (!text) return undefined;\n  try {\n    return JSON.parse(text);\n  } catch {\n    return text;\n  }\n}\n","import type { Logger } from '@lonca/core';\nimport { BrandsResource } from './resources/brands.js';\nimport { TrendyolTransport, type TrendyolEnvironment } from './transport.js';\n\nexport interface CreateClientOptions {\n  /** Trendyol seller (supplier) ID — visible in Partner Panel → Account Info. */\n  sellerId: number;\n  /** Trendyol API key. */\n  apiKey: string;\n  /** Trendyol API secret. */\n  apiSecret: string;\n  /** Which Trendyol environment to target. */\n  env: TrendyolEnvironment;\n  /**\n   * Integrator company name to send in `User-Agent` / `x-agentname`.\n   * Defaults to `'SelfIntegration'` if the seller owns the integration code.\n   * Trendyol caps this at 30 alphanumeric characters.\n   */\n  integratorName?: string;\n  /**\n   * IPv4 address to send in `x-clientip`.\n   * Defaults to `'127.0.0.1'` — Trendyol does not validate this against the\n   * request origin, the header just has to be present and IPv4-shaped.\n   */\n  clientIp?: string;\n  /** Optional structured logger (`@lonca/core` `Logger`). Defaults to no-op. */\n  logger?: Logger;\n  /** Request timeout in ms. Default: 30_000. */\n  timeoutMs?: number;\n}\n\nexport interface TrendyolClient {\n  brands: BrandsResource;\n}\n\n/**\n * Create a Trendyol Marketplace SDK client.\n *\n * @example\n * ```ts\n * import { createTrendyolClient } from '@lonca/trendyol';\n *\n * const client = createTrendyolClient({\n *   sellerId: 12345,\n *   apiKey: process.env.TRENDYOL_API_KEY!,\n *   apiSecret: process.env.TRENDYOL_API_SECRET!,\n *   env: 'stage',\n * });\n *\n * const page = await client.brands.list({ limit: 100 });\n * ```\n */\nexport function createTrendyolClient(opts: CreateClientOptions): TrendyolClient {\n  const transport = new TrendyolTransport({\n    sellerId: opts.sellerId,\n    apiKey: opts.apiKey,\n    apiSecret: opts.apiSecret,\n    env: opts.env,\n    integratorName: opts.integratorName,\n    clientIp: opts.clientIp,\n    logger: opts.logger,\n    timeoutMs: opts.timeoutMs,\n  });\n\n  return {\n    brands: new BrandsResource(transport),\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@lonca/trendyol",
+  "version": "0.1.0",
+  "description": "Type-safe TypeScript SDK for the Trendyol Marketplace API",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/loncadev/lonca.git",
+    "directory": "sdks/trendyol"
+  },
+  "homepage": "https://github.com/loncadev/lonca/tree/main/sdks/trendyol#readme",
+  "bugs": "https://github.com/loncadev/lonca/issues",
+  "keywords": [
+    "trendyol",
+    "marketplace",
+    "e-commerce",
+    "turkey",
+    "sdk",
+    "api"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true});require('fs').rmSync('.turbo',{recursive:true,force:true})\""
+  },
+  "dependencies": {
+    "@lonca/core": "workspace:^"
+  },
+  "devDependencies": {
+    "@types/node": "catalog:",
+    "tsup": "catalog:",
+    "typescript": "catalog:",
+    "vitest": "catalog:"
+  }
+}