@lonca/trendyol 0.3.0 → 0.5.0

package/dist/index.js

@@ -232,6 +232,217 @@ function extractAttributeList(data) {
   }
   return null;
 }
+function toIso(epochMs) {
+  if (typeof epochMs !== "number" || !Number.isFinite(epochMs) || epochMs === 0) {
+    return void 0;
+  }
+  return new Date(epochMs).toISOString();
+}
+function normalizeClaim(node) {
+  const out = {
+    id: node.id ?? node.claimId ?? "",
+    orderNumber: node.orderNumber ?? "",
+    raw: node
+  };
+  const orderDate = toIso(node.orderDate);
+  if (orderDate) out.orderDate = orderDate;
+  const claimDate = toIso(node.claimDate);
+  if (claimDate) out.claimDate = claimDate;
+  if (node.customerFirstName !== void 0) out.customerFirstName = node.customerFirstName;
+  if (node.customerLastName !== void 0) out.customerLastName = node.customerLastName;
+  return out;
+}
+var ClaimsResource = class {
+  constructor(transport, sellerId, limiter) {
+    this.transport = transport;
+    this.sellerId = sellerId;
+    this.limiter = limiter ?? new TokenBucketRateLimiter({ capacity: 1e3, intervalMs: 6e4 });
+  }
+  transport;
+  sellerId;
+  limiter;
+  /**
+   * 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
+   * customer-initiated returns coming from trendyol.com, you receive them
+   * via `claims.list()` — no need to call `create`.
+   *
+   * Returns whatever Trendyol returns (typically the new claim's identifier).
+   *
+   * @throws {ValidationError} when `claimItems` is empty.
+   */
+  async create(input) {
+    if (!Array.isArray(input?.claimItems) || input.claimItems.length === 0) {
+      throw new ValidationError({ message: "claims.create: claimItems must not be empty" });
+    }
+    return this.transport.request({
+      method: "POST",
+      path: `/integration/order/sellers/${this.sellerId}/claims/create`,
+      body: input,
+      rateLimiter: this.limiter
+    });
+  }
+  /**
+   * File a seller-side rejection ("ret talebi") against a customer claim.
+   *
+   * **Wire format: `multipart/form-data`** — the SDK builds the FormData
+   * internally from the typed input. `claimItemIdList` is joined with
+   * commas (Trendyol expects a single comma-separated string field).
+   * Attach supporting docs (PDF / JPEG) via `files: [Blob, ...]`.
+   */
+  async createIssue(claimId, input) {
+    if (!Array.isArray(input?.claimItemIdList) || input.claimItemIdList.length === 0) {
+      throw new ValidationError({
+        message: "claims.createIssue: claimItemIdList must not be empty"
+      });
+    }
+    if (typeof input.description !== "string" || input.description.length === 0) {
+      throw new ValidationError({ message: "claims.createIssue: description is required" });
+    }
+    if (input.description.length > 500) {
+      throw new ValidationError({
+        message: `claims.createIssue: description must be \u2264500 chars (got ${input.description.length})`
+      });
+    }
+    const form = new FormData();
+    form.append("claimIssueReasonId", String(input.claimIssueReasonId));
+    form.append("claimItemIdList", input.claimItemIdList.join(","));
+    form.append("description", input.description);
+    if (input.files) {
+      for (const file of input.files) {
+        form.append("files", file);
+      }
+    }
+    return this.transport.request({
+      method: "POST",
+      path: `/integration/order/sellers/${this.sellerId}/claims/${encodeURIComponent(claimId)}/issue`,
+      body: form,
+      rateLimiter: this.limiter
+    });
+  }
+  /**
+   * Approve specific claim line items. After approval, Trendyol moves
+   * those line items into the post-approval refund / return-shipping flow.
+   *
+   * @throws {ValidationError} when `claimLineItemIdList` is empty.
+   */
+  async approveLineItems(claimId, input) {
+    if (!Array.isArray(input?.claimLineItemIdList) || input.claimLineItemIdList.length === 0) {
+      throw new ValidationError({
+        message: "claims.approveLineItems: claimLineItemIdList must not be empty"
+      });
+    }
+    return this.transport.request({
+      method: "PUT",
+      path: `/integration/order/sellers/${this.sellerId}/claims/${encodeURIComponent(claimId)}/items/approve`,
+      body: input,
+      rateLimiter: this.limiter
+    });
+  }
+  /**
+   * List claims (page-based; SDK exposes opaque cursor convention).
+   *
+   * @example
+   * ```ts
+   * import { paginate } from '@lonca/core';
+   * for await (const c of paginate((p) =>
+   *   client.claims.list({ ...p, claimItemStatus: 'WaitingInAction' }),
+   * )) {
+   *   console.log(c.id, c.orderNumber, c.claimDate);
+   * }
+   * ```
+   */
+  async list(params = {}) {
+    const size = Math.min(params.limit ?? 50, 200);
+    const page = params.cursor ? Number.parseInt(params.cursor, 10) : 0;
+    const query = { page, size };
+    if (params.startDate) query.startDate = params.startDate.getTime();
+    if (params.endDate) query.endDate = params.endDate.getTime();
+    if (params.claimItemStatus) query.claimItemStatus = params.claimItemStatus;
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/order/sellers/${this.sellerId}/claims`,
+      query,
+      rateLimiter: this.limiter
+    });
+    const items = (data.content ?? []).map(normalizeClaim);
+    const result = { items };
+    const totalPages = typeof data.totalPages === "number" ? data.totalPages : 0;
+    if (page + 1 < totalPages) {
+      result.nextCursor = String(page + 1);
+    }
+    return result;
+  }
+  /**
+   * Fetch the catalog of rejection-reason IDs the seller can use on
+   * `claims.createIssue()`. Cache the result — it changes rarely.
+   *
+   * Note: this endpoint is **not seller-scoped** (no `sellerId` in path).
+   */
+  async getIssueReasons() {
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/order/claim-issue-reasons`,
+      rateLimiter: this.limiter
+    });
+    return (data ?? []).map((r) => ({
+      id: typeof r.id === "number" ? r.id : 0,
+      name: r.name ?? ""
+    }));
+  }
+  /**
+   * Fetch the audit log for a single claim item (state transitions,
+   * actor, timestamp). Trendyol's response shape varies — the SDK
+   * surfaces each row as `{ raw }` and leaves field extraction to the
+   * caller until we observe a stable shape on the wire.
+   */
+  async getItemAudits(claimItemId) {
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/order/sellers/${this.sellerId}/claims/items/${encodeURIComponent(claimItemId)}/audit`,
+      rateLimiter: this.limiter
+    });
+    const rows = Array.isArray(data) ? data : Array.isArray(data?.content) ? data.content : [];
+    return rows.map((row) => ({ raw: row }));
+  }
+};
+var FinanceResource = class {
+  constructor(transport, sellerId, limiter) {
+    this.transport = transport;
+    this.sellerId = sellerId;
+    this.limiter = limiter ?? new TokenBucketRateLimiter({ capacity: 100, intervalMs: 6e4 });
+  }
+  transport;
+  sellerId;
+  limiter;
+  async getSettlements(params = {}) {
+    return this.queryPage(`/integration/sellers/${this.sellerId}/settlements`, params);
+  }
+  async getOtherFinancials(params = {}) {
+    return this.queryPage(`/integration/sellers/${this.sellerId}/otherfinancials`, params);
+  }
+  async queryPage(path, params) {
+    const size = Math.min(params.limit ?? 50, 200);
+    const page = params.cursor ? Number.parseInt(params.cursor, 10) : 0;
+    const query = { page, size };
+    if (params.startDate) query.startDate = params.startDate.getTime();
+    if (params.endDate) query.endDate = params.endDate.getTime();
+    if (params.transactionType) query.transactionType = params.transactionType;
+    const data = await this.transport.request({
+      method: "GET",
+      path,
+      query,
+      rateLimiter: this.limiter
+    });
+    const items = (data.content ?? []).map((row) => ({ raw: row }));
+    const result = { items };
+    const totalPages = typeof data.totalPages === "number" ? data.totalPages : 0;
+    if (page + 1 < totalPages) {
+      result.nextCursor = String(page + 1);
+    }
+    return result;
+  }
+};
 var MAX_ITEMS_PER_REQUEST = 1e3;
 var InventoryResource = class {
   constructor(transport, sellerId) {
@@ -271,9 +482,201 @@ var InventoryResource = class {
     return { batchRequestId: data.batchRequestId ?? "" };
   }
 };
+var InvoicesResource = class {
+  constructor(transport, sellerId, limiter) {
+    this.transport = transport;
+    this.sellerId = sellerId;
+    this.limiter = limiter ?? new TokenBucketRateLimiter({ capacity: 500, intervalMs: 6e4 });
+  }
+  transport;
+  sellerId;
+  limiter;
+  /**
+   * Upload an invoice file for a shipment package. **Multipart**: the
+   * SDK builds the FormData internally from the typed input.
+   *
+   * Max 10 MB. Accepted formats: PDF, JPEG, PNG.
+   */
+  async uploadFile(input) {
+    if (!input?.file) {
+      throw new ValidationError({ message: "invoices.uploadFile: file is required" });
+    }
+    if (!input.shipmentPackageId) {
+      throw new ValidationError({ message: "invoices.uploadFile: shipmentPackageId is required" });
+    }
+    const form = new FormData();
+    form.append("shipmentPackageId", String(input.shipmentPackageId));
+    form.append("file", input.file);
+    if (input.invoiceDateTime !== void 0) {
+      form.append("invoiceDateTime", String(input.invoiceDateTime));
+    }
+    if (input.invoiceNumber !== void 0) {
+      form.append("invoiceNumber", input.invoiceNumber);
+    }
+    return this.transport.request({
+      method: "POST",
+      path: `/integration/sellers/${this.sellerId}/seller-invoice-file`,
+      body: form,
+      rateLimiter: this.limiter
+    });
+  }
+  /** Register an invoice URL with Trendyol (alternative to uploading the file). */
+  async sendLink(input) {
+    if (!input?.invoiceLink) {
+      throw new ValidationError({ message: "invoices.sendLink: invoiceLink is required" });
+    }
+    return this.transport.request({
+      method: "POST",
+      path: `/integration/sellers/${this.sellerId}/seller-invoice-links`,
+      body: input,
+      rateLimiter: this.limiter
+    });
+  }
+  /** Remove a previously-registered invoice link. */
+  async deleteLink(input) {
+    return this.transport.request({
+      method: "POST",
+      path: `/integration/sellers/${this.sellerId}/seller-invoice-links/delete`,
+      body: input,
+      rateLimiter: this.limiter
+    });
+  }
+};
+var LabelsResource = class {
+  constructor(transport, sellerId, limiter) {
+    this.transport = transport;
+    this.sellerId = sellerId;
+    this.limiter = limiter ?? new TokenBucketRateLimiter({ capacity: 100, intervalMs: 6e4 });
+  }
+  transport;
+  sellerId;
+  limiter;
+  /**
+   * Request a common ZPL label for a cargo tracking number. After this
+   * returns, call `getCommon()` with the same `cargoTrackingNumber` to
+   * retrieve the generated label.
+   *
+   * @throws {ValidationError} when `format` is missing.
+   */
+  async createCommon(cargoTrackingNumber, input) {
+    if (!input?.format) {
+      throw new ValidationError({ message: "labels.createCommon: format is required" });
+    }
+    return this.transport.request({
+      method: "POST",
+      path: `/integration/sellers/${this.sellerId}/common-label/${encodeURIComponent(String(cargoTrackingNumber))}`,
+      body: input,
+      rateLimiter: this.limiter
+    });
+  }
+  /** Retrieve the previously-created common label. */
+  async getCommon(cargoTrackingNumber) {
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/sellers/${this.sellerId}/common-label/${encodeURIComponent(String(cargoTrackingNumber))}`,
+      rateLimiter: this.limiter
+    });
+    return { raw: data ?? {} };
+  }
+};
+function n(rows, extract) {
+  const list = Array.isArray(rows) ? rows : [];
+  return list.map((r) => {
+    const node = r;
+    return { ...extract(node), raw: node };
+  });
+}
+var LocationsResource = class {
+  constructor(transport, limiter) {
+    this.transport = transport;
+    this.limiter = limiter ?? new TokenBucketRateLimiter({ capacity: 60, intervalMs: 6e4 });
+  }
+  transport;
+  limiter;
+  /** List all supported countries (Türkiye + AZ + GULF + CEE). */
+  async getCountries() {
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/member/countries`,
+      rateLimiter: this.limiter
+    });
+    return n(data, (node) => ({
+      code: String(node.code ?? node.id ?? ""),
+      name: node.name
+    }));
+  }
+  // ─── Domestic (TR / AZ) ───────────────────────────────────────────────
+  async getTurkeyCities() {
+    return this.cities(`/integration/member/countries/domestic/TR/cities`);
+  }
+  async getTurkeyDistricts(cityCode) {
+    return this.districts(
+      `/integration/member/countries/domestic/TR/cities/${encodeURIComponent(String(cityCode))}/districts`
+    );
+  }
+  async getTurkeyNeighborhoods(cityCode, districtCode) {
+    return this.neighborhoods(
+      `/integration/member/countries/domestic/TR/cities/${encodeURIComponent(String(cityCode))}/districts/${encodeURIComponent(String(districtCode))}/neighborhoods`
+    );
+  }
+  async getAzerbaijanCities() {
+    return this.cities(`/integration/member/countries/domestic/AZ/cities`);
+  }
+  async getAzerbaijanDistricts(cityCode) {
+    return this.districts(
+      `/integration/member/countries/domestic/AZ/cities/${encodeURIComponent(String(cityCode))}/districts`
+    );
+  }
+  // ─── International (GULF / CEE) ───────────────────────────────────────
+  async getCitiesByCountry(countryCode) {
+    return this.cities(`/integration/member/countries/${encodeURIComponent(countryCode)}/cities`);
+  }
+  async getDistrictsByCity(countryCode, cityId) {
+    return this.districts(
+      `/integration/member/countries/${encodeURIComponent(countryCode)}/cities/${encodeURIComponent(String(cityId))}/districts`
+    );
+  }
+  // ─── Shared paginators ────────────────────────────────────────────────
+  async cities(path) {
+    const data = await this.transport.request({
+      method: "GET",
+      path,
+      rateLimiter: this.limiter
+    });
+    return n(data, (node) => ({
+      code: String(node.code ?? node.id ?? ""),
+      name: node.name,
+      countryCode: node.countryCode
+    }));
+  }
+  async districts(path) {
+    const data = await this.transport.request({
+      method: "GET",
+      path,
+      rateLimiter: this.limiter
+    });
+    return n(data, (node) => ({
+      code: String(node.code ?? node.id ?? ""),
+      name: node.name,
+      cityCode: node.cityCode !== void 0 ? String(node.cityCode) : void 0
+    }));
+  }
+  async neighborhoods(path) {
+    const data = await this.transport.request({
+      method: "GET",
+      path,
+      rateLimiter: this.limiter
+    });
+    return n(data, (node) => ({
+      code: String(node.code ?? node.id ?? ""),
+      name: node.name,
+      districtCode: node.districtCode !== void 0 ? String(node.districtCode) : void 0
+    }));
+  }
+};
 var MAX_PAGE_SIZE = 200;
 var DEFAULT_PAGE_SIZE2 = 50;
-function toIso(epochMs) {
+function toIso2(epochMs) {
   if (typeof epochMs !== "number" || !Number.isFinite(epochMs) || epochMs === 0) {
     return void 0;
   }
@@ -341,7 +744,7 @@ function normalizeLine(node) {
 function normalizeHistory(node) {
   const out = { raw: node };
   if (node.status !== void 0) out.status = node.status;
-  const createdAt = toIso(node.createdDate);
+  const createdAt = toIso2(node.createdDate);
   if (createdAt) out.createdAt = createdAt;
   return out;
 }
@@ -357,13 +760,14 @@ function normalizeCustomer(node) {
   return out;
 }
 function normalizePackage(node) {
+  const pkgId = node.shipmentPackageId ?? node.id;
   const out = {
-    id: node.shipmentPackageId !== void 0 ? String(node.shipmentPackageId) : "",
+    id: pkgId !== void 0 ? String(pkgId) : "",
     orderNumber: node.orderNumber ?? "",
     status: node.status ?? "",
     customer: normalizeCustomer(node),
-    orderDate: toIso(node.orderDate) ?? "",
-    lastModifiedDate: toIso(node.lastModifiedDate) ?? "",
+    orderDate: toIso2(node.orderDate) ?? "",
+    lastModifiedDate: toIso2(node.lastModifiedDate) ?? "",
     currencyCode: node.currencyCode ?? "",
     packageTotalPrice: typeof node.packageTotalPrice === "number" ? node.packageTotalPrice : 0,
     packageGrossAmount: typeof node.packageGrossAmount === "number" ? node.packageGrossAmount : 0,
@@ -383,13 +787,13 @@ function normalizePackage(node) {
   if (node.shipmentPackageStatus !== void 0) {
     out.shipmentPackageStatus = node.shipmentPackageStatus;
   }
-  const agreed = toIso(node.agreedDeliveryDate);
+  const agreed = toIso2(node.agreedDeliveryDate);
   if (agreed) out.agreedDeliveryDate = agreed;
-  const estStart = toIso(node.estimatedDeliveryStartDate);
+  const estStart = toIso2(node.estimatedDeliveryStartDate);
   if (estStart) out.estimatedDeliveryStartDate = estStart;
-  const estEnd = toIso(node.estimatedDeliveryEndDate);
+  const estEnd = toIso2(node.estimatedDeliveryEndDate);
   if (estEnd) out.estimatedDeliveryEndDate = estEnd;
-  const origin = toIso(node.originShipmentDate);
+  const origin = toIso2(node.originShipmentDate);
   if (origin) out.originShipmentDate = origin;
   const invoice = normalizeAddress(node.invoiceAddress);
   if (invoice) out.invoiceAddress = invoice;
@@ -415,50 +819,383 @@ function normalizePackage(node) {
   if (typeof node["3pByTrendyol"] === "boolean") {
     out.threePByTrendyol = node["3pByTrendyol"];
   }
-  if (typeof node.containsDangerousProduct === "boolean") {
-    out.containsDangerousProduct = node.containsDangerousProduct;
+  if (typeof node.containsDangerousProduct === "boolean") {
+    out.containsDangerousProduct = node.containsDangerousProduct;
+  }
+  if (typeof node.isCod === "boolean") out.isCod = node.isCod;
+  if (typeof node.is4P === "boolean") out.is4P = node.is4P;
+  if (node.invoiceLink !== void 0) out.invoiceLink = node.invoiceLink;
+  if (node.createdBy !== void 0) out.createdBy = node.createdBy;
+  return out;
+}
+var OrdersResource = class {
+  constructor(transport, sellerId, limiter) {
+    this.transport = transport;
+    this.sellerId = sellerId;
+    this.limiter = limiter ?? new TokenBucketRateLimiter({ capacity: 1e3, intervalMs: 6e4 });
+  }
+  transport;
+  sellerId;
+  limiter;
+  /**
+   * List shipment packages for the seller.
+   *
+   * @example
+   * ```ts
+   * import { paginate } from '@lonca/core';
+   * for await (const pkg of paginate((p) => client.orders.list({ ...p, status: 'Created' }))) {
+   *   console.log(pkg.id, pkg.status, pkg.customer.firstName);
+   * }
+   * ```
+   */
+  async list(params = {}) {
+    const size = Math.min(params.limit ?? DEFAULT_PAGE_SIZE2, MAX_PAGE_SIZE);
+    const page = params.cursor ? Number.parseInt(params.cursor, 10) : 0;
+    const query = { page, size };
+    if (params.status) query.status = params.status;
+    if (params.orderNumber) query.orderNumber = params.orderNumber;
+    if (params.startDate) query.startDate = params.startDate.getTime();
+    if (params.endDate) query.endDate = params.endDate.getTime();
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/order/sellers/${this.sellerId}/orders`,
+      query,
+      rateLimiter: this.limiter
+    });
+    const items = (data.content ?? []).map(normalizePackage);
+    const totalPages = typeof data.totalPages === "number" ? data.totalPages : 0;
+    const result = { items };
+    if (page + 1 < totalPages) {
+      result.nextCursor = String(page + 1);
+    }
+    return result;
+  }
+  /**
+   * Push a shipment-package status update.
+   *
+   * Trendyol restricts the seller-side push to two transitions:
+   * - `Picking`  — order picked up from the shelf / being prepared
+   * - `Invoiced` — invoice issued, ready for cargo handoff
+   *
+   * Other transitions (`Shipped`, `Delivered`, etc.) are driven by Trendyol
+   * or the cargo provider — call `processAlternativeDelivery` or
+   * `manualDeliverByPackageId` if you ship outside Trendyol's cargo
+   * network.
+   *
+   * Returns void; Trendyol responds with 200 + empty body on success.
+   */
+  async updatePackageStatus(packageId, input) {
+    await this.transport.request({
+      method: "PUT",
+      path: this.packagePath(packageId),
+      body: input,
+      rateLimiter: this.limiter
+    });
+  }
+  /**
+   * Notify Trendyol that one or more line items cannot be supplied
+   * ("Tedarik Edememe Bildirimi"). Marks the listed line IDs as
+   * `UnSupplied`. Trendyol cancels those quantities and notifies the
+   * customer.
+   *
+   * `reasonId` is a numeric code Trendyol publishes separately — consult
+   * the seller panel or the "Tedarik Edememe" docs for current values.
+   *
+   * Returns void; Trendyol responds with 200 + empty body on success.
+   */
+  async cancelPackageItem(packageId, input) {
+    if (!Array.isArray(input?.lines) || input.lines.length === 0) {
+      throw new ValidationError({ message: "cancelPackageItem: lines must not be empty" });
+    }
+    await this.transport.request({
+      method: "PUT",
+      path: `${this.packagePath(packageId)}/items/unsupplied`,
+      body: input,
+      rateLimiter: this.limiter
+    });
+  }
+  /**
+   * Extend the agreed delivery date for a shipment package by 1, 2, or 3 days.
+   * Trendyol enforces the [1, 3] range server-side; the SDK validates client-side
+   * to fail fast.
+   *
+   * Returns void; Trendyol responds with 200 + empty body on success.
+   */
+  async extendDeliveryDate(packageId, extendedDayCount) {
+    if (![1, 2, 3].includes(extendedDayCount)) {
+      throw new ValidationError({
+        message: `extendDeliveryDate: extendedDayCount must be 1, 2, or 3 (got ${extendedDayCount})`
+      });
+    }
+    await this.transport.request({
+      method: "PUT",
+      path: `${this.packagePath(packageId)}/extended-agreed-delivery-date`,
+      body: { extendedDayCount },
+      rateLimiter: this.limiter
+    });
+  }
+  /**
+   * Notify Trendyol of an alternative delivery channel — used when the
+   * seller is shipping via a non-Trendyol cargo provider. Trendyol then
+   * either SMSes the customer the tracking link (when `isPhoneNumber` is
+   * `true`) or stores the tracking URL on the package directly.
+   *
+   * Returns void; Trendyol responds with 200 + empty body on success.
+   */
+  async processAlternativeDelivery(packageId, input) {
+    await this.transport.request({
+      method: "PUT",
+      path: `${this.packagePath(packageId)}/alternative-delivery`,
+      body: input,
+      rateLimiter: this.limiter
+    });
+  }
+  /**
+   * Split a shipment package by moving a set of line IDs into a new
+   * package. The original package keeps the remaining lines.
+   *
+   * @param packageId    The package to split.
+   * @param orderLineIds Line IDs to move into the new package (1+).
+   * @throws {ValidationError} when `orderLineIds` is empty.
+   */
+  async splitPackage(packageId, orderLineIds) {
+    if (!Array.isArray(orderLineIds) || orderLineIds.length === 0) {
+      throw new ValidationError({ message: "splitPackage: orderLineIds must not be empty" });
+    }
+    await this.transport.request({
+      method: "POST",
+      path: `${this.packagePath(packageId)}/split`,
+      body: { orderLineIds },
+      rateLimiter: this.limiter
+    });
+  }
+  /**
+   * Split a shipment package by quantity. Each `QuantitySplit` entry
+   * carves a single line into multiple packages — e.g. `{ orderLineId: 100,
+   * quantities: [2, 2, 1] }` splits 5 units of line 100 into three packages
+   * of 2 + 2 + 1.
+   *
+   * @throws {ValidationError} when `quantitySplit` is empty.
+   */
+  async splitPackageByQuantity(packageId, quantitySplit) {
+    if (!Array.isArray(quantitySplit) || quantitySplit.length === 0) {
+      throw new ValidationError({
+        message: "splitPackageByQuantity: quantitySplit must not be empty"
+      });
+    }
+    await this.transport.request({
+      method: "POST",
+      path: `${this.packagePath(packageId)}/quantity-split`,
+      body: { quantitySplit },
+      rateLimiter: this.limiter
+    });
+  }
+  /**
+   * Split a shipment package into multiple new packages by grouping line
+   * IDs. Each `SplitGroup` becomes one new package containing the listed
+   * line IDs.
+   *
+   * @throws {ValidationError} when `splitGroups` is empty.
+   */
+  async multiSplitPackage(packageId, splitGroups) {
+    if (!Array.isArray(splitGroups) || splitGroups.length === 0) {
+      throw new ValidationError({ message: "multiSplitPackage: splitGroups must not be empty" });
+    }
+    await this.transport.request({
+      method: "POST",
+      path: `${this.packagePath(packageId)}/multi-split`,
+      body: { splitGroups },
+      rateLimiter: this.limiter
+    });
+  }
+  /**
+   * Split a shipment package into multiple new packages, each containing a
+   * mix of line items at specific quantities. This is the most expressive
+   * split — use it when you need fine-grained control over which line IDs
+   * and how many of each end up in each new package.
+   *
+   * @throws {ValidationError} when `splitPackages` is empty.
+   */
+  async splitMultiPackagesByQuantity(packageId, splitPackages) {
+    if (!Array.isArray(splitPackages) || splitPackages.length === 0) {
+      throw new ValidationError({
+        message: "splitMultiPackagesByQuantity: splitPackages must not be empty"
+      });
+    }
+    await this.transport.request({
+      method: "POST",
+      path: `${this.packagePath(packageId)}/split-packages`,
+      body: { splitPackages },
+      rateLimiter: this.limiter
+    });
+  }
+  /**
+   * Change the cargo provider on an existing shipment package. Use one of
+   * Trendyol's documented marketplace cargo codes (`'YKMP'`, `'ARASMP'`,
+   * `'SURATMP'`, etc.) — see `TrendyolCargoProvider` for the full list.
+   */
+  async changeCargoProvider(packageId, cargoProvider) {
+    await this.transport.request({
+      method: "PUT",
+      path: `${this.packagePath(packageId)}/cargo-providers`,
+      body: { cargoProvider },
+      rateLimiter: this.limiter
+    });
+  }
+  /**
+   * Mark a shipment package as manually delivered via its package ID.
+   * Used when the seller delivered the order outside Trendyol's cargo
+   * network and needs to flip the package to `Delivered` after handover.
+   *
+   * No request body; Trendyol responds with 200 + empty body on success.
+   */
+  async manualDeliverByPackageId(packageId) {
+    await this.transport.request({
+      method: "PUT",
+      path: `${this.packagePath(packageId)}/manual-invoice-delivery`,
+      rateLimiter: this.limiter
+    });
+  }
+  /**
+   * Manual-deliver variant that takes the cargo tracking number instead
+   * of the package ID. Useful when you only have the tracking number on
+   * hand (e.g., from a cargo provider webhook).
+   *
+   * Note the path structure: tracking number sits at a sibling location,
+   * not under `/shipment-packages/{id}/...`.
+   */
+  async manualDeliverByTrackingNumber(cargoTrackingNumber) {
+    await this.transport.request({
+      method: "PUT",
+      path: `/integration/order/sellers/${this.sellerId}/shipment-packages/manual-invoice-delivery-by-tracking-number/${encodeURIComponent(String(cargoTrackingNumber))}`,
+      rateLimiter: this.limiter
+    });
+  }
+  /**
+   * Mark a package as delivered through an authorized service ("yetkili
+   * servis"). For appliance / installation-required products that are
+   * delivered + installed by a third-party service partner.
+   */
+  async markDeliveredByService(packageId) {
+    await this.transport.request({
+      method: "PUT",
+      path: `${this.packagePath(packageId)}/delivered-by-service`,
+      rateLimiter: this.limiter
+    });
+  }
+  /**
+   * Update box / packaging metadata on a shipment package (desi value
+   * and/or number of boxes). Either field can be sent alone.
+   */
+  async updateBoxInfo(packageId, input) {
+    await this.transport.request({
+      method: "PUT",
+      path: `${this.packagePath(packageId)}/box-info`,
+      body: input,
+      rateLimiter: this.limiter
+    });
   }
-  if (typeof node.isCod === "boolean") out.isCod = node.isCod;
-  if (typeof node.is4P === "boolean") out.is4P = node.is4P;
-  if (node.invoiceLink !== void 0) out.invoiceLink = node.invoiceLink;
-  if (node.createdBy !== void 0) out.createdBy = node.createdBy;
-  return out;
-}
-var OrdersResource = class {
-  constructor(transport, sellerId, limiter) {
-    this.transport = transport;
-    this.sellerId = sellerId;
-    this.limiter = limiter ?? new TokenBucketRateLimiter({ capacity: 1e3, intervalMs: 6e4 });
+  /**
+   * Update labor costs for one or more order lines.
+   *
+   * **Wire note:** Trendyol's request body is a raw array (no envelope),
+   * not `{ items: [...] }`. The SDK forwards `items` verbatim.
+   *
+   * @throws {ValidationError} when `items` is empty.
+   */
+  async updateLaborCosts(packageId, items) {
+    if (!Array.isArray(items) || items.length === 0) {
+      throw new ValidationError({ message: "updateLaborCosts: items must not be empty" });
+    }
+    await this.transport.request({
+      method: "PUT",
+      path: `${this.packagePath(packageId)}/labor-costs`,
+      body: items,
+      rateLimiter: this.limiter
+    });
   }
-  transport;
-  sellerId;
-  limiter;
   /**
-   * List shipment packages for the seller.
+   * Reassign a shipment package to a different warehouse. `warehouseId`
+   * comes from `client.suppliers.getAddresses()` (filter by `isShipmentAddress`).
+   */
+  async updateWarehouse(packageId, warehouseId) {
+    await this.transport.request({
+      method: "PUT",
+      path: `${this.packagePath(packageId)}/warehouse`,
+      body: { warehouseId },
+      rateLimiter: this.limiter
+    });
+  }
+  /**
+   * Stream variant of `list()`. Trendyol's `getShipmentPackagesStream`
+   * returns the same `ShipmentPackage` shape but paginates with an opaque
+   * cursor — useful when the dataset is large and page-based pagination
+   * would hit the 10 000-record cap.
    *
    * @example
    * ```ts
    * import { paginate } from '@lonca/core';
-   * for await (const pkg of paginate((p) => client.orders.list({ ...p, status: 'Created' }))) {
-   *   console.log(pkg.id, pkg.status, pkg.customer.firstName);
+   * for await (const pkg of paginate((p) =>
+   *   client.orders.listStream({ ...p, packageItemStatuses: 'Created,Picking' }),
+   * )) {
+   *   console.log(pkg.id, pkg.status);
    * }
    * ```
    */
-  async list(params = {}) {
+  async listStream(params = {}) {
     const size = Math.min(params.limit ?? DEFAULT_PAGE_SIZE2, MAX_PAGE_SIZE);
-    const page = params.cursor ? Number.parseInt(params.cursor, 10) : 0;
-    const query = { page, size };
-    if (params.status) query.status = params.status;
-    if (params.orderNumber) query.orderNumber = params.orderNumber;
-    if (params.startDate) query.startDate = params.startDate.getTime();
-    if (params.endDate) query.endDate = params.endDate.getTime();
+    const query = { size };
+    if (params.cursor) query.nextCursor = params.cursor;
+    if (params.packageItemStatuses) query.packageItemStatuses = params.packageItemStatuses;
+    if (params.lastModifiedStartDate) {
+      query.lastModifiedStartDate = params.lastModifiedStartDate.getTime();
+    }
+    if (params.lastModifiedEndDate) {
+      query.lastModifiedEndDate = params.lastModifiedEndDate.getTime();
+    }
     const data = await this.transport.request({
       method: "GET",
-      path: `/integration/order/sellers/${this.sellerId}/orders`,
+      path: `/integration/order/sellers/${this.sellerId}/orders/stream`,
       query,
       rateLimiter: this.limiter
     });
     const items = (data.content ?? []).map(normalizePackage);
+    const result = { items };
+    if (data.hasMore && data.nextCursor) {
+      result.nextCursor = data.nextCursor;
+    }
+    return result;
+  }
+  /**
+   * Fetch the per-parcel cargo-fee breakdown for a single cargo invoice
+   * (Trendyol's `getCargoInvoiceItems`). Useful for reconciling Trendyol's
+   * cargo deductions against your shipped packages.
+   *
+   * `invoiceSerialNumber` is sourced from the Current Account Statement
+   * ("Cari Hesap Ekstresi") with `transactionType=DeductionInvoices`.
+   *
+   * Page-based pagination internally (cursor encodes the page index).
+   */
+  async getCargoInvoiceItems(invoiceSerialNumber, params = {}) {
+    const size = Math.min(params.limit ?? 500, 500);
+    const page = params.cursor ? Number.parseInt(params.cursor, 10) : 0;
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/finance/che/sellers/${this.sellerId}/cargo-invoice/${encodeURIComponent(invoiceSerialNumber)}/items`,
+      query: { page, size },
+      rateLimiter: this.limiter
+    });
+    const items = (data.content ?? []).map((row) => {
+      const out = { raw: row };
+      if (row.shipmentPackageType !== void 0) out.shipmentPackageType = row.shipmentPackageType;
+      if (row.parcelUniqueId !== void 0) {
+        out.parcelUniqueId = typeof row.parcelUniqueId === "string" ? row.parcelUniqueId : String(row.parcelUniqueId);
+      }
+      if (row.orderNumber !== void 0) out.orderNumber = row.orderNumber;
+      if (typeof row.amount === "number") out.amount = row.amount;
+      if (typeof row.desi === "number") out.desi = row.desi;
+      return out;
+    });
     const totalPages = typeof data.totalPages === "number" ? data.totalPages : 0;
     const result = { items };
     if (page + 1 < totalPages) {
@@ -466,6 +1203,104 @@ var OrdersResource = class {
     }
     return result;
   }
+  /**
+   * Notify Trendyol that a shipped package was returned to you (manual
+   * return flow, e.g. customer dropped it at your address or you got the
+   * package back without going through Trendyol's return cargo).
+   *
+   * No body; Trendyol responds with 200 + empty body on success.
+   */
+  async manualReturnByPackageId(packageId) {
+    await this.transport.request({
+      method: "PUT",
+      path: `${this.packagePath(packageId)}/manual-return`,
+      rateLimiter: this.limiter
+    });
+  }
+  /**
+   * Manual-return variant that takes the cargo tracking number instead of
+   * the package ID. Useful when the cargo provider's webhook only carries
+   * the tracking number.
+   *
+   * Sibling path (not under `/{packageId}/...`).
+   */
+  async manualReturnByTrackingNumber(cargoTrackingNumber) {
+    await this.transport.request({
+      method: "PUT",
+      path: `/integration/order/sellers/${this.sellerId}/shipment-packages/manual-return-by-tracking-number/${encodeURIComponent(String(cargoTrackingNumber))}`,
+      rateLimiter: this.limiter
+    });
+  }
+  /**
+   * Fetch Trendyol Express compensation tickets (claims filed when a
+   * shipment is lost or damaged in transit). Page-based pagination
+   * internally; the SDK exposes the cursor convention.
+   *
+   * Note the different base path — `/integration/tex/compensation/...`,
+   * not the regular `/integration/order/...`.
+   *
+   * @example
+   * ```ts
+   * import { paginate } from '@lonca/core';
+   * const tickets = await client.orders.getCompensationTickets({
+   *   startDate: new Date('2026-01-01'),
+   *   endDate: new Date('2026-02-01'),
+   * });
+   * for (const t of tickets.items) {
+   *   console.log(t.orderNumber, t.currentState, t.stateMessage);
+   * }
+   * ```
+   */
+  async getCompensationTickets(params = {}) {
+    const size = Math.min(params.limit ?? 200, 200);
+    const page = params.cursor ? Number.parseInt(params.cursor, 10) : 0;
+    const query = { page, size };
+    if (params.startDate) query.startDate = params.startDate.getTime();
+    if (params.endDate) query.endDate = params.endDate.getTime();
+    const res = await this.transport.request({
+      method: "GET",
+      path: `/integration/tex/compensation/sellers/${this.sellerId}/tickets`,
+      query,
+      rateLimiter: this.limiter
+    });
+    const tickets = Array.isArray(res.data) ? res.data : res.data?.items ?? res.data?.content ?? res.content ?? [];
+    const items = tickets.map((t) => {
+      const itemDetails = (t.itemDetails ?? []).map((d) => {
+        const out2 = {};
+        if (typeof d.itemAmount === "number") out2.itemAmount = d.itemAmount;
+        if (d.itemCode !== void 0) out2.itemCode = d.itemCode;
+        if (typeof d.itemCount === "number") out2.itemCount = d.itemCount;
+        if (d.itemName !== void 0) out2.itemName = d.itemName;
+        return out2;
+      });
+      const out = {
+        itemDetails,
+        raw: t
+      };
+      if (t.cargoProvider !== void 0) out.cargoProvider = t.cargoProvider;
+      if (t.compensateReason !== void 0) out.compensateReason = t.compensateReason;
+      const createdAt = toIso2(t.createDate);
+      if (createdAt) out.createdAt = createdAt;
+      if (t.currentState !== void 0) {
+        out.currentState = t.currentState;
+      }
+      if (t.deliveryNumber !== void 0) out.deliveryNumber = t.deliveryNumber;
+      if (t.orderNumber !== void 0) out.orderNumber = t.orderNumber;
+      if (t.requestedBy !== void 0) out.requestedBy = t.requestedBy;
+      if (t.stateMessage !== void 0) out.stateMessage = t.stateMessage;
+      if (t.totalItemsAmount !== void 0) out.totalItemsAmount = t.totalItemsAmount;
+      return out;
+    });
+    const result = { items };
+    const total = typeof res.totalCount === "number" ? res.totalCount : 0;
+    if ((page + 1) * size < total) {
+      result.nextCursor = String(page + 1);
+    }
+    return result;
+  }
+  packagePath(packageId) {
+    return `/integration/order/sellers/${this.sellerId}/shipment-packages/${encodeURIComponent(String(packageId))}`;
+  }
 };
 var DEFAULT_PAGE_SIZE3 = 50;
 var MAX_PAGE_SIZE2 = 1e3;
@@ -512,7 +1347,7 @@ function normalizeVariant(variant) {
   if (stock !== void 0) out.stock = stock;
   return out;
 }
-function toIso2(epochMs) {
+function toIso3(epochMs) {
   if (typeof epochMs !== "number" || !Number.isFinite(epochMs)) return void 0;
   return new Date(epochMs).toISOString();
 }
@@ -526,8 +1361,8 @@ function normalizeProduct(node) {
     images: normalizeImages(node.images),
     attributes: (node.attributes ?? []).map(normalizeAttribute2),
     variants: (node.variants ?? []).map(normalizeVariant),
-    createdAt: toIso2(node.creationDate) ?? "",
-    updatedAt: toIso2(node.lastModifiedDate) ?? "",
+    createdAt: toIso3(node.creationDate) ?? "",
+    updatedAt: toIso3(node.lastModifiedDate) ?? "",
     raw: node
   };
   if (node.description !== void 0) out.description = node.description;
@@ -573,13 +1408,13 @@ function normalizeUnapproved(node) {
     out.specialConsumptionTax = node.specialConsumptionTax;
   }
   if (node.sgrPrice !== void 0) out.sgrPrice = node.sgrPrice;
-  const createdAt = toIso2(node.createDateTime);
+  const createdAt = toIso3(node.createDateTime);
   if (createdAt) out.createdAt = createdAt;
-  const updatedAt = toIso2(node.lastUpdateDate);
+  const updatedAt = toIso3(node.lastUpdateDate);
   if (updatedAt) out.updatedAt = updatedAt;
-  const priceChanged = toIso2(node.lastPriceChangeDate);
+  const priceChanged = toIso3(node.lastPriceChangeDate);
   if (priceChanged) out.lastPriceChangedAt = priceChanged;
-  const stockChanged = toIso2(node.lastStockChangeDate);
+  const stockChanged = toIso3(node.lastStockChangeDate);
   if (stockChanged) out.lastStockChangedAt = stockChanged;
   return out;
 }
@@ -604,7 +1439,7 @@ function normalizeProductBase(data) {
     archived: !!data.archived,
     raw: data
   };
-  const approvedAt = toIso2(data.approvedDate);
+  const approvedAt = toIso3(data.approvedDate);
   if (approvedAt) out.approvedAt = approvedAt;
   if (data.listingId !== void 0) out.listingId = data.listingId;
   if (data.contentId !== void 0) out.contentId = String(data.contentId);
@@ -626,9 +1461,9 @@ function normalizeBatchResult(data) {
   };
   if (typeof data.itemCount === "number") out.itemCount = data.itemCount;
   if (typeof data.failedItemCount === "number") out.failedItemCount = data.failedItemCount;
-  const createdAt = toIso2(data.creationDate);
+  const createdAt = toIso3(data.creationDate);
   if (createdAt) out.createdAt = createdAt;
-  const lastModifiedAt = toIso2(data.lastModification);
+  const lastModifiedAt = toIso3(data.lastModification);
   if (lastModifiedAt) out.lastModifiedAt = lastModifiedAt;
   if (data.sourceType !== void 0) out.sourceType = data.sourceType;
   if (data.batchRequestType !== void 0) out.batchRequestType = data.batchRequestType;
@@ -974,6 +1809,120 @@ var ProductsResource = class {
     return { batchRequestId: data?.batchRequestId ?? "" };
   }
 };
+function toIso4(epochMs) {
+  if (typeof epochMs !== "number" || !Number.isFinite(epochMs) || epochMs === 0) {
+    return void 0;
+  }
+  return new Date(epochMs).toISOString();
+}
+function normalizeAnswer(a) {
+  if (!a) return void 0;
+  const out = {};
+  if (a.text !== void 0) out.text = a.text;
+  const createdAt = toIso4(a.creationDate);
+  if (createdAt) out.createdAt = createdAt;
+  if (a.status !== void 0) out.status = a.status;
+  return out;
+}
+function normalizeQuestion(node) {
+  const out = {
+    id: node.id !== void 0 ? String(node.id) : "",
+    raw: node
+  };
+  if (node.text !== void 0) out.text = node.text;
+  if (node.customerId !== void 0) out.customerId = String(node.customerId);
+  if (node.userName !== void 0) out.userName = node.userName;
+  if (typeof node.showUserName === "boolean") out.showUserName = node.showUserName;
+  if (node.status !== void 0) out.status = node.status;
+  if (typeof node.public === "boolean") out.public = node.public;
+  if (node.productMainId !== void 0) out.productMainId = node.productMainId;
+  if (node.productName !== void 0) out.productName = node.productName;
+  if (node.imageUrl !== void 0) out.imageUrl = node.imageUrl;
+  if (node.webUrl !== void 0) out.webUrl = node.webUrl;
+  const createdAt = toIso4(node.creationDate);
+  if (createdAt) out.createdAt = createdAt;
+  if (node.answeredDateMessage !== void 0) out.answeredDateMessage = node.answeredDateMessage;
+  const answer = normalizeAnswer(node.answer);
+  if (answer) out.answer = answer;
+  const rejectedAnswer = normalizeAnswer(node.rejectedAnswer);
+  if (rejectedAnswer) out.rejectedAnswer = rejectedAnswer;
+  const rejectedAt = toIso4(node.rejectedDate);
+  if (rejectedAt) out.rejectedAt = rejectedAt;
+  if (node.reason !== void 0) out.reason = node.reason;
+  if (node.reportReason !== void 0) out.reportReason = node.reportReason;
+  const reportedAt = toIso4(node.reportedDate);
+  if (reportedAt) out.reportedAt = reportedAt;
+  return out;
+}
+var QuestionsResource = class {
+  constructor(transport, sellerId, limiter) {
+    this.transport = transport;
+    this.sellerId = sellerId;
+    this.limiter = limiter ?? new TokenBucketRateLimiter({ capacity: 500, intervalMs: 6e4 });
+  }
+  transport;
+  sellerId;
+  limiter;
+  /** Fetch a single question by its numeric ID. */
+  async get(questionId) {
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/qna/sellers/${this.sellerId}/questions/${encodeURIComponent(String(questionId))}`,
+      rateLimiter: this.limiter
+    });
+    return normalizeQuestion(data);
+  }
+  /**
+   * Filter questions by barcode / date range / status. Page-based
+   * pagination internally; SDK exposes the opaque-cursor convention.
+   */
+  async list(params = {}) {
+    const size = Math.min(params.limit ?? 50, 200);
+    const page = params.cursor ? Number.parseInt(params.cursor, 10) : 0;
+    const query = { page, size };
+    if (params.barcode) query.barcode = params.barcode;
+    if (params.startDate) query.startDate = params.startDate.getTime();
+    if (params.endDate) query.endDate = params.endDate.getTime();
+    if (params.status) query.status = params.status;
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/qna/sellers/${this.sellerId}/questions/filter`,
+      query,
+      rateLimiter: this.limiter
+    });
+    const items = (data.content ?? []).map(normalizeQuestion);
+    const result = { items };
+    const totalPages = typeof data.totalPages === "number" ? data.totalPages : 0;
+    if (page + 1 < totalPages) {
+      result.nextCursor = String(page + 1);
+    }
+    return result;
+  }
+  /**
+   * Reply to a question. Trendyol enforces 10–2000 characters on the
+   * answer text; the SDK pre-validates client-side.
+   *
+   * @throws {ValidationError} when `text` is outside the 10–2000 char range.
+   */
+  async answer(questionId, text) {
+    if (typeof text !== "string" || text.length < 10) {
+      throw new ValidationError({
+        message: `questions.answer: text must be at least 10 chars (got ${text?.length ?? 0})`
+      });
+    }
+    if (text.length > 2e3) {
+      throw new ValidationError({
+        message: `questions.answer: text must be at most 2000 chars (got ${text.length})`
+      });
+    }
+    return this.transport.request({
+      method: "POST",
+      path: `/integration/qna/sellers/${this.sellerId}/questions/${encodeURIComponent(String(questionId))}/answers`,
+      body: { text },
+      rateLimiter: this.limiter
+    });
+  }
+};
 var VALID_TYPES = /* @__PURE__ */ new Set([
   "SHIPMENT",
   "RETURNING",
@@ -1054,6 +2003,170 @@ var SuppliersResource = class {
     return items;
   }
 };
+var TestOrdersResource = class {
+  constructor(transport, sellerId, limiter) {
+    this.transport = transport;
+    this.sellerId = sellerId;
+    this.limiter = limiter ?? new TokenBucketRateLimiter({ capacity: 60, intervalMs: 6e4 });
+  }
+  transport;
+  sellerId;
+  limiter;
+  /**
+   * Create a test order with the given customer / addresses / lines. The
+   * SDK forwards the typed payload verbatim — drill into Trendyol's
+   * `createTestOrder` doc for inner field rules.
+   *
+   * @throws {ValidationError} when required top-level fields are missing.
+   */
+  async create(input) {
+    for (const k of ["customer", "invoiceAddress", "shippingAddress", "seller", "lines"]) {
+      if (!input?.[k]) {
+        throw new ValidationError({ message: `testOrders.create: ${k} is required` });
+      }
+    }
+    return this.transport.request({
+      method: "POST",
+      path: `/integration/test/order/orders/core`,
+      body: input,
+      rateLimiter: this.limiter
+    });
+  }
+  /** Push a test shipment package to the given status. */
+  async updateStatus(packageId, status) {
+    return this.transport.request({
+      method: "PUT",
+      path: `/integration/test/order/sellers/${this.sellerId}/shipment-packages/${encodeURIComponent(String(packageId))}/status`,
+      body: { status },
+      rateLimiter: this.limiter
+    });
+  }
+  /** Move test claims to the `WaitingInAction` state. */
+  async setClaimsWaitingInAction() {
+    return this.transport.request({
+      method: "PUT",
+      path: `/integration/test/order/sellers/${this.sellerId}/claims/waiting-in-action`,
+      rateLimiter: this.limiter
+    });
+  }
+};
+function normalizeWebhook(node) {
+  const out = {
+    id: node.id !== void 0 ? String(node.id) : "",
+    raw: node
+  };
+  if (node.url !== void 0) out.url = node.url;
+  if (node.authenticationType !== void 0) out.authenticationType = node.authenticationType;
+  if (node.username !== void 0) out.username = node.username;
+  if (node.apiKey !== void 0) out.apiKey = node.apiKey;
+  if (node.subscribedStatuses !== void 0) out.subscribedStatuses = node.subscribedStatuses;
+  if (typeof node.active === "boolean") out.active = node.active;
+  else if (typeof node.isActive === "boolean") out.active = node.isActive;
+  else if (typeof node.status === "string") out.active = node.status.toUpperCase() === "ACTIVE";
+  return out;
+}
+var WebhooksResource = class {
+  constructor(transport, sellerId, limiter) {
+    this.transport = transport;
+    this.sellerId = sellerId;
+    this.limiter = limiter ?? new TokenBucketRateLimiter({ capacity: 50, intervalMs: 6e4 });
+  }
+  transport;
+  sellerId;
+  limiter;
+  /**
+   * Create a new webhook subscription. Trendyol caps subscriptions at 15
+   * per seller — the SDK does NOT pre-check (you'd need to call `list()`
+   * first), but Trendyol returns 400 when the cap is exceeded.
+   *
+   * @throws {ValidationError} when `url` or `authenticationType` is missing.
+   */
+  async create(input) {
+    this.validateInput(input, "create");
+    return this.transport.request({
+      method: "POST",
+      path: `/integration/sellers/${this.sellerId}/webhooks`,
+      body: input,
+      rateLimiter: this.limiter
+    });
+  }
+  /** List all registered webhook subscriptions. */
+  async list() {
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/sellers/${this.sellerId}/webhooks`,
+      rateLimiter: this.limiter
+    });
+    const rows = Array.isArray(data) ? data : Array.isArray(data?.webhooks) ? data.webhooks : Array.isArray(data?.content) ? data.content : [];
+    return rows.map((r) => normalizeWebhook(r));
+  }
+  /**
+   * Update a webhook subscription. Same input shape as `create`; replaces
+   * the whole subscription (Trendyol does NOT partially update).
+   */
+  async update(webhookId, input) {
+    this.validateInput(input, "update");
+    return this.transport.request({
+      method: "PUT",
+      path: this.webhookPath(webhookId),
+      body: input,
+      rateLimiter: this.limiter
+    });
+  }
+  /** Permanently delete a webhook subscription. */
+  async delete(webhookId) {
+    return this.transport.request({
+      method: "DELETE",
+      path: this.webhookPath(webhookId),
+      rateLimiter: this.limiter
+    });
+  }
+  /** Re-activate a previously-deactivated webhook subscription. */
+  async activate(webhookId) {
+    return this.transport.request({
+      method: "PUT",
+      path: `${this.webhookPath(webhookId)}/activate`,
+      rateLimiter: this.limiter
+    });
+  }
+  /**
+   * Deactivate a webhook subscription. Trendyol automatically deactivates
+   * a subscription after persistent delivery failures (and sends 2 emails);
+   * use `activate()` to bring it back online once your endpoint is healthy.
+   */
+  async deactivate(webhookId) {
+    return this.transport.request({
+      method: "PUT",
+      path: `${this.webhookPath(webhookId)}/deactivate`,
+      rateLimiter: this.limiter
+    });
+  }
+  validateInput(input, method) {
+    if (!input?.url || typeof input.url !== "string") {
+      throw new ValidationError({ message: `webhooks.${method}: url is required` });
+    }
+    if (input.authenticationType !== "BASIC_AUTHENTICATION" && input.authenticationType !== "API_KEY") {
+      throw new ValidationError({
+        message: `webhooks.${method}: authenticationType must be 'BASIC_AUTHENTICATION' or 'API_KEY'`
+      });
+    }
+    if (input.authenticationType === "BASIC_AUTHENTICATION") {
+      if (!input.username || !input.password) {
+        throw new ValidationError({
+          message: `webhooks.${method}: BASIC_AUTHENTICATION requires username + password`
+        });
+      }
+    } else if (!input.apiKey) {
+      throw new ValidationError({
+        message: `webhooks.${method}: API_KEY requires apiKey`
+      });
+    }
+    if (input.subscribedStatuses && input.subscribedStatuses.length === 0) ;
+  }
+  webhookPath(webhookId) {
+    return `/integration/sellers/${this.sellerId}/webhooks/${encodeURIComponent(String(webhookId))}`;
+  }
+};
 
 // src/auth.ts
 function buildAuthHeader(apiKey, apiSecret) {
@@ -1146,7 +2259,12 @@ var TrendyolTransport = class {
           signal: this.composeSignal(opts.signal)
         };
         if (opts.body !== void 0 && opts.method !== "GET") {
-          init.body = JSON.stringify(opts.body);
+          if (opts.body instanceof FormData) {
+            init.body = opts.body;
+            delete headers["Content-Type"];
+          } else {
+            init.body = JSON.stringify(opts.body);
+          }
         }
         this.logger.debug("trendyol.request", {
           method: opts.method,
@@ -1261,10 +2379,18 @@ function createTrendyolClient(opts) {
     suppliers: new SuppliersResource(transport, opts.sellerId),
     products: new ProductsResource(transport, opts.sellerId),
     inventory: new InventoryResource(transport, opts.sellerId),
-    orders: new OrdersResource(transport, opts.sellerId)
+    orders: new OrdersResource(transport, opts.sellerId),
+    claims: new ClaimsResource(transport, opts.sellerId),
+    webhooks: new WebhooksResource(transport, opts.sellerId),
+    questions: new QuestionsResource(transport, opts.sellerId),
+    invoices: new InvoicesResource(transport, opts.sellerId),
+    finance: new FinanceResource(transport, opts.sellerId),
+    labels: new LabelsResource(transport, opts.sellerId),
+    testOrders: new TestOrdersResource(transport, opts.sellerId),
+    locations: new LocationsResource(transport)
   };
 }
 
-export { BrandsResource, CategoriesResource, InventoryResource, OrdersResource, ProductsResource, SuppliersResource, createTrendyolClient };
+export { BrandsResource, CategoriesResource, ClaimsResource, FinanceResource, InventoryResource, InvoicesResource, LabelsResource, LocationsResource, OrdersResource, ProductsResource, QuestionsResource, SuppliersResource, TestOrdersResource, WebhooksResource, createTrendyolClient };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map