@lonca/trendyol 0.6.0 → 0.8.0

package/dist/index.d.cts

@@ -10,7 +10,7 @@ interface TransportConfig {
     apiKey: string;
     apiSecret: string;
     env: TrendyolEnvironment;
-    integratorName?: string;
+    integratorName: string;
     clientIp?: string;
     logger?: Logger;
     /** Request timeout in ms. Default: 30_000. */
@@ -35,6 +35,8 @@ declare class TrendyolTransport {
     private readonly timeoutMs;
     private readonly fetchImpl;
     constructor(config: TransportConfig);
+    /** Seller ID this transport is configured with. Resources read it for path-building. */
+    get sellerId(): number;
     request<T>(opts: RequestOptions): Promise<T>;
     private buildUrl;
     private buildHeaders;
@@ -177,20 +179,8 @@ type ListCategoryAttributeValuesParams = CursorPaginationParams;
  */
 declare class CategoriesResource {
     private readonly transport;
-    /**
-     * Trendyol seller (supplier) ID — required only for the AutoFT-scoped
-     * `getByBarcodes` lookup. Other category endpoints don't need it.
-     * Provided automatically when constructed via `createTrendyolClient`.
-     */
-    private readonly sellerId?;
     private readonly limiter;
-    constructor(transport: TrendyolTransport, limiter?: TokenBucketRateLimiter, 
-    /**
-     * Trendyol seller (supplier) ID — required only for the AutoFT-scoped
-     * `getByBarcodes` lookup. Other category endpoints don't need it.
-     * Provided automatically when constructed via `createTrendyolClient`.
-     */
-    sellerId?: number | undefined);
+    constructor(transport: TrendyolTransport, limiter?: TokenBucketRateLimiter);
     /**
      * Fetch the full Trendyol category tree.
      *
@@ -240,8 +230,6 @@ declare class CategoriesResource {
      *
      * @param barcodes 1–N barcodes to look up.
      * @throws {ValidationError} when `barcodes` is empty.
-     * @throws Error when the client was created without a `sellerId` and this
-     *   method is called directly (use `createTrendyolClient` to wire it).
      */
     getByBarcodes(barcodes: string[]): Promise<BarcodeCategoryLookup>;
 }
@@ -356,9 +344,8 @@ interface ClaimItemAudit {
  */
 declare class ClaimsResource {
     private readonly transport;
-    private readonly sellerId;
     private readonly limiter;
-    constructor(transport: TrendyolTransport, sellerId: number, limiter?: TokenBucketRateLimiter);
+    constructor(transport: TrendyolTransport, limiter?: TokenBucketRateLimiter);
     /**
      * Create a return claim against an order. Use this to file a return on
      * behalf of a customer (e.g. when they called your CS line). For
@@ -582,9 +569,8 @@ interface Neighborhood {
  */
 declare class FinanceResource {
     private readonly transport;
-    private readonly sellerId;
     private readonly limiter;
-    constructor(transport: TrendyolTransport, sellerId: number, limiter?: TokenBucketRateLimiter);
+    constructor(transport: TrendyolTransport, limiter?: TokenBucketRateLimiter);
     getSettlements(params?: ListFinanceParams): Promise<CursorPage<FinancialTransaction>>;
     getOtherFinancials(params?: ListFinanceParams): Promise<CursorPage<FinancialTransaction>>;
     private queryPage;
@@ -625,8 +611,7 @@ interface UpdatePriceInventoryResponse {
  */
 declare class InventoryResource {
     private readonly transport;
-    private readonly sellerId;
-    constructor(transport: TrendyolTransport, sellerId: number);
+    constructor(transport: TrendyolTransport);
     /**
      * Update price and/or stock for one or more SKUs (by barcode).
      *
@@ -651,9 +636,8 @@ declare class InventoryResource {
  */
 declare class InvoicesResource {
     private readonly transport;
-    private readonly sellerId;
     private readonly limiter;
-    constructor(transport: TrendyolTransport, sellerId: number, limiter?: TokenBucketRateLimiter);
+    constructor(transport: TrendyolTransport, limiter?: TokenBucketRateLimiter);
     /**
      * Upload an invoice file for a shipment package. **Multipart**: the
      * SDK builds the FormData internally from the typed input.
@@ -673,9 +657,8 @@ declare class InvoicesResource {
  */
 declare class LabelsResource {
     private readonly transport;
-    private readonly sellerId;
     private readonly limiter;
-    constructor(transport: TrendyolTransport, sellerId: number, limiter?: TokenBucketRateLimiter);
+    constructor(transport: TrendyolTransport, limiter?: TokenBucketRateLimiter);
     /**
      * Request a common ZPL label for a cargo tracking number. After this
      * returns, call `getCommon()` with the same `cargoTrackingNumber` to
@@ -1099,9 +1082,8 @@ declare function normalizeShipmentPackage(rawNode: unknown): ShipmentPackage;
  */
 declare class OrdersResource {
     private readonly transport;
-    private readonly sellerId;
     private readonly limiter;
-    constructor(transport: TrendyolTransport, sellerId: number, limiter?: TokenBucketRateLimiter);
+    constructor(transport: TrendyolTransport, limiter?: TokenBucketRateLimiter);
     /**
      * List shipment packages for the seller.
      *
@@ -1686,13 +1668,12 @@ interface ListUnapprovedProductsParams extends CursorPaginationParams {
  */
 declare class ProductsResource {
     private readonly transport;
-    private readonly sellerId;
     private readonly filterLimiter;
     private readonly batchLimiter;
     private readonly buyboxLimiter;
     private readonly writeLimiter;
     private readonly deleteLimiter;
-    constructor(transport: TrendyolTransport, sellerId: number, options?: {
+    constructor(transport: TrendyolTransport, options?: {
         filterLimiter?: TokenBucketRateLimiter;
         batchLimiter?: TokenBucketRateLimiter;
         buyboxLimiter?: TokenBucketRateLimiter;
@@ -1930,9 +1911,8 @@ interface ListQuestionsParams extends CursorPaginationParams {
  */
 declare class QuestionsResource {
     private readonly transport;
-    private readonly sellerId;
     private readonly limiter;
-    constructor(transport: TrendyolTransport, sellerId: number, limiter?: TokenBucketRateLimiter);
+    constructor(transport: TrendyolTransport, limiter?: TokenBucketRateLimiter);
     /** Fetch a single question by its numeric ID. */
     get(questionId: string | number): Promise<Question>;
     /**
@@ -2001,12 +1981,11 @@ interface SuppliersResourceOptions {
  */
 declare class SuppliersResource {
     private readonly transport;
-    private readonly sellerId;
     private cache;
     private readonly cacheTtlMs;
     private readonly limiter;
     private inflight;
-    constructor(transport: TrendyolTransport, sellerId: number, options?: SuppliersResourceOptions);
+    constructor(transport: TrendyolTransport, options?: SuppliersResourceOptions);
     /**
      * List the seller's registered addresses (shipment, returning, invoice, warehouse).
      *
@@ -2028,9 +2007,8 @@ declare class SuppliersResource {
  */
 declare class TestOrdersResource {
     private readonly transport;
-    private readonly sellerId;
     private readonly limiter;
-    constructor(transport: TrendyolTransport, sellerId: number, limiter?: TokenBucketRateLimiter);
+    constructor(transport: TrendyolTransport, limiter?: TokenBucketRateLimiter);
     /**
      * Create a test order with the given customer / addresses / lines. The
      * SDK forwards the typed payload verbatim — drill into Trendyol's
@@ -2110,9 +2088,8 @@ interface Webhook {
  */
 declare class WebhooksResource {
     private readonly transport;
-    private readonly sellerId;
     private readonly limiter;
-    constructor(transport: TrendyolTransport, sellerId: number, limiter?: TokenBucketRateLimiter);
+    constructor(transport: TrendyolTransport, limiter?: TokenBucketRateLimiter);
     /**
      * Create a new webhook subscription. Trendyol caps subscriptions at 15
      * per seller — the SDK does NOT pre-check (you'd need to call `list()`
@@ -2152,11 +2129,12 @@ interface CreateClientOptions {
     /** 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.
+     * Integrator company name to send in `User-Agent` / `x-agentname`. Required —
+     * Trendyol uses this to attribute API traffic. Use `'SelfIntegration'` if
+     * the seller owns the integration code, otherwise your company / product name.
      * Trendyol caps this at 30 alphanumeric characters.
      */
-    integratorName?: string;
+    integratorName: string;
     /**
      * IPv4 address to send in `x-clientip`.
      * Defaults to `'127.0.0.1'` — Trendyol does not validate this against the

package/dist/index.d.ts

@@ -10,7 +10,7 @@ interface TransportConfig {
     apiKey: string;
     apiSecret: string;
     env: TrendyolEnvironment;
-    integratorName?: string;
+    integratorName: string;
     clientIp?: string;
     logger?: Logger;
     /** Request timeout in ms. Default: 30_000. */
@@ -35,6 +35,8 @@ declare class TrendyolTransport {
     private readonly timeoutMs;
     private readonly fetchImpl;
     constructor(config: TransportConfig);
+    /** Seller ID this transport is configured with. Resources read it for path-building. */
+    get sellerId(): number;
     request<T>(opts: RequestOptions): Promise<T>;
     private buildUrl;
     private buildHeaders;
@@ -177,20 +179,8 @@ type ListCategoryAttributeValuesParams = CursorPaginationParams;
  */
 declare class CategoriesResource {
     private readonly transport;
-    /**
-     * Trendyol seller (supplier) ID — required only for the AutoFT-scoped
-     * `getByBarcodes` lookup. Other category endpoints don't need it.
-     * Provided automatically when constructed via `createTrendyolClient`.
-     */
-    private readonly sellerId?;
     private readonly limiter;
-    constructor(transport: TrendyolTransport, limiter?: TokenBucketRateLimiter, 
-    /**
-     * Trendyol seller (supplier) ID — required only for the AutoFT-scoped
-     * `getByBarcodes` lookup. Other category endpoints don't need it.
-     * Provided automatically when constructed via `createTrendyolClient`.
-     */
-    sellerId?: number | undefined);
+    constructor(transport: TrendyolTransport, limiter?: TokenBucketRateLimiter);
     /**
      * Fetch the full Trendyol category tree.
      *
@@ -240,8 +230,6 @@ declare class CategoriesResource {
      *
      * @param barcodes 1–N barcodes to look up.
      * @throws {ValidationError} when `barcodes` is empty.
-     * @throws Error when the client was created without a `sellerId` and this
-     *   method is called directly (use `createTrendyolClient` to wire it).
      */
     getByBarcodes(barcodes: string[]): Promise<BarcodeCategoryLookup>;
 }
@@ -356,9 +344,8 @@ interface ClaimItemAudit {
  */
 declare class ClaimsResource {
     private readonly transport;
-    private readonly sellerId;
     private readonly limiter;
-    constructor(transport: TrendyolTransport, sellerId: number, limiter?: TokenBucketRateLimiter);
+    constructor(transport: TrendyolTransport, limiter?: TokenBucketRateLimiter);
     /**
      * Create a return claim against an order. Use this to file a return on
      * behalf of a customer (e.g. when they called your CS line). For
@@ -582,9 +569,8 @@ interface Neighborhood {
  */
 declare class FinanceResource {
     private readonly transport;
-    private readonly sellerId;
     private readonly limiter;
-    constructor(transport: TrendyolTransport, sellerId: number, limiter?: TokenBucketRateLimiter);
+    constructor(transport: TrendyolTransport, limiter?: TokenBucketRateLimiter);
     getSettlements(params?: ListFinanceParams): Promise<CursorPage<FinancialTransaction>>;
     getOtherFinancials(params?: ListFinanceParams): Promise<CursorPage<FinancialTransaction>>;
     private queryPage;
@@ -625,8 +611,7 @@ interface UpdatePriceInventoryResponse {
  */
 declare class InventoryResource {
     private readonly transport;
-    private readonly sellerId;
-    constructor(transport: TrendyolTransport, sellerId: number);
+    constructor(transport: TrendyolTransport);
     /**
      * Update price and/or stock for one or more SKUs (by barcode).
      *
@@ -651,9 +636,8 @@ declare class InventoryResource {
  */
 declare class InvoicesResource {
     private readonly transport;
-    private readonly sellerId;
     private readonly limiter;
-    constructor(transport: TrendyolTransport, sellerId: number, limiter?: TokenBucketRateLimiter);
+    constructor(transport: TrendyolTransport, limiter?: TokenBucketRateLimiter);
     /**
      * Upload an invoice file for a shipment package. **Multipart**: the
      * SDK builds the FormData internally from the typed input.
@@ -673,9 +657,8 @@ declare class InvoicesResource {
  */
 declare class LabelsResource {
     private readonly transport;
-    private readonly sellerId;
     private readonly limiter;
-    constructor(transport: TrendyolTransport, sellerId: number, limiter?: TokenBucketRateLimiter);
+    constructor(transport: TrendyolTransport, limiter?: TokenBucketRateLimiter);
     /**
      * Request a common ZPL label for a cargo tracking number. After this
      * returns, call `getCommon()` with the same `cargoTrackingNumber` to
@@ -1099,9 +1082,8 @@ declare function normalizeShipmentPackage(rawNode: unknown): ShipmentPackage;
  */
 declare class OrdersResource {
     private readonly transport;
-    private readonly sellerId;
     private readonly limiter;
-    constructor(transport: TrendyolTransport, sellerId: number, limiter?: TokenBucketRateLimiter);
+    constructor(transport: TrendyolTransport, limiter?: TokenBucketRateLimiter);
     /**
      * List shipment packages for the seller.
      *
@@ -1686,13 +1668,12 @@ interface ListUnapprovedProductsParams extends CursorPaginationParams {
  */
 declare class ProductsResource {
     private readonly transport;
-    private readonly sellerId;
     private readonly filterLimiter;
     private readonly batchLimiter;
     private readonly buyboxLimiter;
     private readonly writeLimiter;
     private readonly deleteLimiter;
-    constructor(transport: TrendyolTransport, sellerId: number, options?: {
+    constructor(transport: TrendyolTransport, options?: {
         filterLimiter?: TokenBucketRateLimiter;
         batchLimiter?: TokenBucketRateLimiter;
         buyboxLimiter?: TokenBucketRateLimiter;
@@ -1930,9 +1911,8 @@ interface ListQuestionsParams extends CursorPaginationParams {
  */
 declare class QuestionsResource {
     private readonly transport;
-    private readonly sellerId;
     private readonly limiter;
-    constructor(transport: TrendyolTransport, sellerId: number, limiter?: TokenBucketRateLimiter);
+    constructor(transport: TrendyolTransport, limiter?: TokenBucketRateLimiter);
     /** Fetch a single question by its numeric ID. */
     get(questionId: string | number): Promise<Question>;
     /**
@@ -2001,12 +1981,11 @@ interface SuppliersResourceOptions {
  */
 declare class SuppliersResource {
     private readonly transport;
-    private readonly sellerId;
     private cache;
     private readonly cacheTtlMs;
     private readonly limiter;
     private inflight;
-    constructor(transport: TrendyolTransport, sellerId: number, options?: SuppliersResourceOptions);
+    constructor(transport: TrendyolTransport, options?: SuppliersResourceOptions);
     /**
      * List the seller's registered addresses (shipment, returning, invoice, warehouse).
      *
@@ -2028,9 +2007,8 @@ declare class SuppliersResource {
  */
 declare class TestOrdersResource {
     private readonly transport;
-    private readonly sellerId;
     private readonly limiter;
-    constructor(transport: TrendyolTransport, sellerId: number, limiter?: TokenBucketRateLimiter);
+    constructor(transport: TrendyolTransport, limiter?: TokenBucketRateLimiter);
     /**
      * Create a test order with the given customer / addresses / lines. The
      * SDK forwards the typed payload verbatim — drill into Trendyol's
@@ -2110,9 +2088,8 @@ interface Webhook {
  */
 declare class WebhooksResource {
     private readonly transport;
-    private readonly sellerId;
     private readonly limiter;
-    constructor(transport: TrendyolTransport, sellerId: number, limiter?: TokenBucketRateLimiter);
+    constructor(transport: TrendyolTransport, limiter?: TokenBucketRateLimiter);
     /**
      * Create a new webhook subscription. Trendyol caps subscriptions at 15
      * per seller — the SDK does NOT pre-check (you'd need to call `list()`
@@ -2152,11 +2129,12 @@ interface CreateClientOptions {
     /** 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.
+     * Integrator company name to send in `User-Agent` / `x-agentname`. Required —
+     * Trendyol uses this to attribute API traffic. Use `'SelfIntegration'` if
+     * the seller owns the integration code, otherwise your company / product name.
      * Trendyol caps this at 30 alphanumeric characters.
      */
-    integratorName?: string;
+    integratorName: string;
     /**
      * IPv4 address to send in `x-clientip`.
      * Defaults to `'127.0.0.1'` — Trendyol does not validate this against the