@lonca/trendyol 0.1.0 → 0.3.0

package/dist/index.cjs

@@ -28,7 +28,7 @@ var BrandsResource = class {
     const size = params.limit ?? DEFAULT_PAGE_SIZE;
     const data = await this.transport.request({
       method: "GET",
-      path: "/sapigw/brands",
+      path: "/integration/product/brands",
       query: { page, size },
       rateLimiter: this.limiter
     });
@@ -36,6 +36,1025 @@ var BrandsResource = class {
     const nextCursor = page + 1 < data.totalPages ? String(page + 1) : void 0;
     return nextCursor !== void 0 ? { items, nextCursor } : { items };
   }
+  /**
+   * Search brands by name. Useful when you need a brand's numeric ID for
+   * `createProducts` and don't want to page through the full `list()`
+   * (1000 brands per page).
+   *
+   * **Discovery-first wire fact (verified STAGE 2026-05-25):** Trendyol's
+   * doc claims this is a case-sensitive *exact* match, but live behaviour
+   * is **substring + case-insensitive** — `search('Trendyol')` returns
+   * 17 hits including `TRENDYOLMILLA`, `trendyol vavist`, `Trendyol Üyelik`.
+   * Plan for ranking your results client-side if you need an exact match.
+   * The endpoint returns an empty array when nothing matches (no 404).
+   *
+   * @param name The brand name to search for.
+   */
+  async search(name) {
+    const data = await this.transport.request({
+      method: "GET",
+      path: "/integration/product/brands/by-name",
+      query: { name },
+      rateLimiter: this.limiter
+    });
+    return (data ?? []).map((b) => ({ id: String(b.id), name: b.name }));
+  }
+};
+function normalizeCategory(node) {
+  return {
+    id: String(node.id),
+    name: node.name,
+    parentId: node.parentId === null || node.parentId === void 0 ? null : String(node.parentId),
+    subCategories: (node.subCategories ?? []).map(normalizeCategory)
+  };
+}
+function normalizeAttribute(node) {
+  const attr = node.attribute ?? { id: 0, name: "" };
+  const rawValues = node.attributeValues ?? [];
+  const out = {
+    id: String(attr.id),
+    name: attr.name,
+    required: !!node.required,
+    allowCustom: !!node.allowCustom,
+    varianter: !!node.varianter,
+    slicer: !!node.slicer,
+    values: rawValues.map((v) => ({ id: String(v.id), name: v.name }))
+  };
+  if (node.categoryId !== void 0) {
+    out.categoryId = String(node.categoryId);
+  }
+  if (node.allowMultipleAttributeValues !== void 0) {
+    out.allowMultipleAttributeValues = node.allowMultipleAttributeValues;
+  }
+  return out;
+}
+var MAX_ATTR_VALUES_PAGE_SIZE = 1e3;
+var DEFAULT_ATTR_VALUES_PAGE_SIZE = 100;
+var CategoriesResource = class {
+  constructor(transport, limiter, sellerId) {
+    this.transport = transport;
+    this.sellerId = sellerId;
+    this.limiter = limiter ?? new core.TokenBucketRateLimiter({ capacity: 50, intervalMs: 6e4 });
+  }
+  transport;
+  sellerId;
+  limiter;
+  /**
+   * Fetch the full Trendyol category tree.
+   *
+   * Trendyol returns the entire tree in one response — there is no pagination.
+   * Cache the result aggressively in your application; the tree changes rarely.
+   */
+  async list() {
+    const data = await this.transport.request({
+      method: "GET",
+      path: "/integration/product/product-categories",
+      rateLimiter: this.limiter
+    });
+    const list = Array.isArray(data) ? data : data.categories;
+    return list.map(normalizeCategory);
+  }
+  /**
+   * Fetch the attributes (required and optional) for a single category.
+   *
+   * Call this before `createProduct V2` so you know which attributes are
+   * mandatory — the API rejects products that omit any `required` attribute.
+   *
+   * @param categoryId Trendyol numeric category ID; accepts `string` or `number`.
+   */
+  async getAttributes(categoryId) {
+    const id = encodeURIComponent(String(categoryId));
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/product/categories/${id}/attributes`,
+      rateLimiter: this.limiter
+    });
+    const list = extractAttributeList(data);
+    if (!list) {
+      console.error(
+        "[@lonca/trendyol] getCategoryAttributes: unexpected response shape:",
+        JSON.stringify(data).slice(0, 800)
+      );
+      return [];
+    }
+    return list.map(normalizeAttribute);
+  }
+  /**
+   * Fetch the allowed values for a single category attribute (paginated).
+   *
+   * `getCategoryAttributes` returns attribute metadata + flags but typically
+   * omits the value catalog. Use this method to fetch the catalog for an
+   * attribute when `allowCustom` is `false` and you need to map your data
+   * onto Trendyol's accepted values.
+   *
+   * @param categoryId  Trendyol numeric category ID; accepts `string` or `number`.
+   * @param attributeId Attribute ID returned by `getAttributes`.
+   * @param params      Cursor pagination (max page size 1000; default 100).
+   *
+   * @example
+   * ```ts
+   * import { paginate } from '@lonca/core';
+   * for await (const value of paginate((p) =>
+   *   client.categories.getAttributeValues(catId, attrId, p),
+   * )) {
+   *   console.log(value.id, value.name);
+   * }
+   * ```
+   */
+  async getAttributeValues(categoryId, attributeId, params = {}) {
+    const catId = encodeURIComponent(String(categoryId));
+    const attrId = encodeURIComponent(String(attributeId));
+    const size = Math.min(params.limit ?? DEFAULT_ATTR_VALUES_PAGE_SIZE, MAX_ATTR_VALUES_PAGE_SIZE);
+    const page = params.cursor ? Number.parseInt(params.cursor, 10) : 0;
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/product/categories/${catId}/attributes/${attrId}/values`,
+      query: { page, size },
+      rateLimiter: this.limiter
+    });
+    const items = (data.content ?? []).map((item) => ({
+      id: item.attributeValueId !== void 0 ? String(item.attributeValueId) : "",
+      name: item.attributeValue ?? item.attributeValueName ?? ""
+    }));
+    const result = { items };
+    const totalPages = typeof data.totalPages === "number" ? data.totalPages : 0;
+    if (page + 1 < totalPages) {
+      result.nextCursor = String(page + 1);
+    }
+    return result;
+  }
+  /**
+   * Look up category info for a list of barcodes (Trendyol Export Center
+   * / AutoFT endpoint).
+   *
+   * **Requires Export Center enrollment.** Sellers who have not joined
+   * Trendyol's "İhracat Merkezi" program will get an auth error on this
+   * endpoint even though their regular Marketplace credentials are valid.
+   *
+   * @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).
+   */
+  async getByBarcodes(barcodes) {
+    if (!Array.isArray(barcodes) || barcodes.length === 0) {
+      throw new core.ValidationError({ message: "getByBarcodes: barcodes must not be empty" });
+    }
+    if (this.sellerId === void 0) {
+      throw new Error(
+        "CategoriesResource.getByBarcodes requires a sellerId; instantiate via createTrendyolClient"
+      );
+    }
+    const data = await this.transport.request({
+      method: "POST",
+      path: `/integration/ecgw/v1/${this.sellerId}/lookup/product-categories/by-barcodes`,
+      body: { barcodes },
+      rateLimiter: this.limiter
+    });
+    const matches = Object.entries(data.barcodeCategories ?? {}).map(([barcode, cat]) => ({
+      barcode,
+      category: {
+        id: cat.id !== void 0 ? String(cat.id) : "",
+        name: cat.displayName ?? ""
+      }
+    }));
+    return { matches, notFound: data.notFound ?? [] };
+  }
+};
+function extractAttributeList(data) {
+  if (Array.isArray(data)) return data;
+  if (data && typeof data === "object") {
+    const obj = data;
+    if (Array.isArray(obj.categoryAttributes)) {
+      return obj.categoryAttributes;
+    }
+    if (Array.isArray(obj.attributes)) {
+      return obj.attributes;
+    }
+  }
+  return null;
+}
+var MAX_ITEMS_PER_REQUEST = 1e3;
+var InventoryResource = class {
+  constructor(transport, sellerId) {
+    this.transport = transport;
+    this.sellerId = sellerId;
+  }
+  transport;
+  sellerId;
+  /**
+   * Update price and/or stock for one or more SKUs (by barcode).
+   *
+   * @example
+   * ```ts
+   * const { batchRequestId } = await client.inventory.update([
+   *   { barcode: 'ABC123', quantity: 42, salePrice: 199.9, listPrice: 249.9 },
+   *   { barcode: 'XYZ789', quantity: 0 },
+   * ]);
+   * const status = await client.products.getBatchStatus(batchRequestId);
+   * ```
+   *
+   * @throws {ValidationError} when `items` is empty or longer than 1000.
+   */
+  async update(items) {
+    if (items.length === 0) {
+      throw new core.ValidationError({ message: "updatePriceAndInventory: items must not be empty" });
+    }
+    if (items.length > MAX_ITEMS_PER_REQUEST) {
+      throw new core.ValidationError({
+        message: `updatePriceAndInventory: max ${MAX_ITEMS_PER_REQUEST} items per request, got ${items.length}`
+      });
+    }
+    const data = await this.transport.request({
+      method: "POST",
+      path: `/integration/inventory/sellers/${this.sellerId}/products/price-and-inventory`,
+      body: { items }
+    });
+    return { batchRequestId: data.batchRequestId ?? "" };
+  }
+};
+var MAX_PAGE_SIZE = 200;
+var DEFAULT_PAGE_SIZE2 = 50;
+function toIso(epochMs) {
+  if (typeof epochMs !== "number" || !Number.isFinite(epochMs) || epochMs === 0) {
+    return void 0;
+  }
+  return new Date(epochMs).toISOString();
+}
+function normalizeAddress(node) {
+  if (!node) return void 0;
+  const out = {};
+  if (node.id !== void 0) out.id = String(node.id);
+  if (node.firstName !== void 0) out.firstName = node.firstName;
+  if (node.lastName !== void 0) out.lastName = node.lastName;
+  if (node.fullName !== void 0) out.fullName = node.fullName;
+  if (node.company !== void 0) out.company = node.company;
+  if (node.address1 !== void 0) out.address1 = node.address1;
+  if (node.address2 !== void 0) out.address2 = node.address2;
+  if (node.fullAddress !== void 0) out.fullAddress = node.fullAddress;
+  if (node.shortAddress !== void 0) out.shortAddress = node.shortAddress;
+  if (node.city !== void 0) out.city = node.city;
+  if (node.cityCode !== void 0) out.cityCode = node.cityCode;
+  if (node.district !== void 0) out.district = node.district;
+  if (node.districtId !== void 0) out.districtId = node.districtId;
+  if (node.neighborhoodId !== void 0) out.neighborhoodId = node.neighborhoodId;
+  if (node.countyId !== void 0) out.countyId = node.countyId;
+  if (node.countyName !== void 0) out.countyName = node.countyName;
+  if (node.stateName !== void 0) out.stateName = node.stateName;
+  if (node.postalCode !== void 0) out.postalCode = node.postalCode;
+  if (node.countryCode !== void 0) out.countryCode = node.countryCode;
+  if (node.phone !== void 0) out.phone = node.phone;
+  if (node.addressLines !== void 0) out.addressLines = node.addressLines;
+  return out;
+}
+function normalizeLine(node) {
+  const out = {
+    id: node.lineId !== void 0 ? String(node.lineId) : "",
+    quantity: typeof node.quantity === "number" ? node.quantity : 0,
+    productName: node.productName ?? "",
+    barcode: node.barcode ?? "",
+    lineUnitPrice: typeof node.lineUnitPrice === "number" ? node.lineUnitPrice : 0,
+    lineGrossAmount: typeof node.lineGrossAmount === "number" ? node.lineGrossAmount : 0,
+    raw: node
+  };
+  if (node.productSize !== void 0) out.productSize = node.productSize;
+  if (node.productColor !== void 0) out.productColor = node.productColor;
+  if (node.stockCode !== void 0) out.stockCode = node.stockCode;
+  if (node.contentId !== void 0) out.contentId = String(node.contentId);
+  if (node.sellerId !== void 0) out.sellerId = String(node.sellerId);
+  if (node.productCategoryId !== void 0) out.productCategoryId = String(node.productCategoryId);
+  if (node.salesCampaignId !== void 0) out.salesCampaignId = String(node.salesCampaignId);
+  if (node.currencyCode !== void 0) out.currencyCode = node.currencyCode;
+  if (node.lineSellerDiscount !== void 0) out.lineSellerDiscount = node.lineSellerDiscount;
+  if (node.lineTyDiscount !== void 0) out.lineTyDiscount = node.lineTyDiscount;
+  if (node.lineTotalDiscount !== void 0) out.lineTotalDiscount = node.lineTotalDiscount;
+  if (node.vatRate !== void 0) out.vatRate = node.vatRate;
+  if (node.commission !== void 0) out.commission = node.commission;
+  if (node.orderLineItemStatusName !== void 0) {
+    out.orderLineItemStatusName = node.orderLineItemStatusName;
+  }
+  if (node.businessUnit !== void 0) out.businessUnit = node.businessUnit;
+  if (Array.isArray(node.fastDeliveryOptions)) out.fastDeliveryOptions = node.fastDeliveryOptions;
+  if (Array.isArray(node.discountDetails)) {
+    out.discountDetails = node.discountDetails;
+  }
+  return out;
+}
+function normalizeHistory(node) {
+  const out = { raw: node };
+  if (node.status !== void 0) out.status = node.status;
+  const createdAt = toIso(node.createdDate);
+  if (createdAt) out.createdAt = createdAt;
+  return out;
+}
+function normalizeCustomer(node) {
+  const out = {
+    firstName: node.customerFirstName ?? "",
+    lastName: node.customerLastName ?? ""
+  };
+  if (node.customerId !== void 0) out.id = String(node.customerId);
+  if (node.customerEmail !== void 0) out.email = node.customerEmail;
+  if (node.taxNumber !== void 0 && node.taxNumber !== null) out.taxNumber = node.taxNumber;
+  if (node.identityNumber !== void 0) out.identityNumber = node.identityNumber;
+  return out;
+}
+function normalizePackage(node) {
+  const out = {
+    id: node.shipmentPackageId !== void 0 ? String(node.shipmentPackageId) : "",
+    orderNumber: node.orderNumber ?? "",
+    status: node.status ?? "",
+    customer: normalizeCustomer(node),
+    orderDate: toIso(node.orderDate) ?? "",
+    lastModifiedDate: toIso(node.lastModifiedDate) ?? "",
+    currencyCode: node.currencyCode ?? "",
+    packageTotalPrice: typeof node.packageTotalPrice === "number" ? node.packageTotalPrice : 0,
+    packageGrossAmount: typeof node.packageGrossAmount === "number" ? node.packageGrossAmount : 0,
+    packageSellerDiscount: typeof node.packageSellerDiscount === "number" ? node.packageSellerDiscount : 0,
+    packageTyDiscount: typeof node.packageTyDiscount === "number" ? node.packageTyDiscount : 0,
+    packageTotalDiscount: typeof node.packageTotalDiscount === "number" ? node.packageTotalDiscount : 0,
+    lines: (node.lines ?? []).map(normalizeLine),
+    packageHistories: (node.packageHistories ?? []).map(normalizeHistory),
+    raw: node
+  };
+  if (node.shipmentNumber !== void 0) out.shipmentNumber = String(node.shipmentNumber);
+  if (node.originPackageIds !== void 0 && node.originPackageIds !== null) {
+    out.originPackageIds = node.originPackageIds.map((id) => String(id));
+  }
+  if (node.warehouseId !== void 0) out.warehouseId = String(node.warehouseId);
+  if (node.supplierId !== void 0) out.supplierId = String(node.supplierId);
+  if (node.shipmentPackageStatus !== void 0) {
+    out.shipmentPackageStatus = node.shipmentPackageStatus;
+  }
+  const agreed = toIso(node.agreedDeliveryDate);
+  if (agreed) out.agreedDeliveryDate = agreed;
+  const estStart = toIso(node.estimatedDeliveryStartDate);
+  if (estStart) out.estimatedDeliveryStartDate = estStart;
+  const estEnd = toIso(node.estimatedDeliveryEndDate);
+  if (estEnd) out.estimatedDeliveryEndDate = estEnd;
+  const origin = toIso(node.originShipmentDate);
+  if (origin) out.originShipmentDate = origin;
+  const invoice = normalizeAddress(node.invoiceAddress);
+  if (invoice) out.invoiceAddress = invoice;
+  const shipment = normalizeAddress(node.shipmentAddress);
+  if (shipment) out.shipmentAddress = shipment;
+  if (node.deliveryAddressType !== void 0) out.deliveryAddressType = node.deliveryAddressType;
+  if (node.cargoTrackingNumber !== void 0) {
+    out.cargoTrackingNumber = String(node.cargoTrackingNumber);
+  }
+  if (node.cargoProviderName !== void 0) out.cargoProviderName = node.cargoProviderName;
+  if (node.cargoProviderId !== void 0) out.cargoProviderId = String(node.cargoProviderId);
+  if (node.cargoSenderNumber !== void 0) out.cargoSenderNumber = node.cargoSenderNumber;
+  if (node.deliveryType !== void 0) out.deliveryType = node.deliveryType;
+  if (node.whoPays !== void 0) out.whoPays = node.whoPays;
+  if (node.timeSlotId !== void 0) out.timeSlotId = node.timeSlotId;
+  if (typeof node.fastDelivery === "boolean") out.fastDelivery = node.fastDelivery;
+  if (node.fastDeliveryType !== void 0) out.fastDeliveryType = node.fastDeliveryType;
+  if (typeof node.deliveredByService === "boolean")
+    out.deliveredByService = node.deliveredByService;
+  if (typeof node.commercial === "boolean") out.commercial = node.commercial;
+  if (typeof node.micro === "boolean") out.micro = node.micro;
+  if (typeof node.giftBoxRequested === "boolean") out.giftBoxRequested = node.giftBoxRequested;
+  if (typeof node["3pByTrendyol"] === "boolean") {
+    out.threePByTrendyol = node["3pByTrendyol"];
+  }
+  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 core.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;
+  }
+};
+var DEFAULT_PAGE_SIZE3 = 50;
+var MAX_PAGE_SIZE2 = 1e3;
+var MAX_BUYBOX_BARCODES = 10;
+function normalizeRef(ref) {
+  return {
+    id: ref?.id !== void 0 ? String(ref.id) : "",
+    name: ref?.name ?? ""
+  };
+}
+function normalizeAttribute2(attr) {
+  const out = {
+    attributeId: attr.attributeId !== void 0 ? String(attr.attributeId) : ""
+  };
+  if (attr.attributeName !== void 0) out.attributeName = attr.attributeName;
+  if (attr.attributeValueId !== void 0) {
+    out.attributeValueId = String(attr.attributeValueId);
+  }
+  if (attr.attributeValue !== void 0) out.attributeValue = attr.attributeValue;
+  return out;
+}
+function normalizeImages(images) {
+  if (!images) return [];
+  return images.map((img) => typeof img === "string" ? img : img?.url).filter((u) => typeof u === "string" && u.length > 0);
+}
+function normalizeStock(stock) {
+  if (typeof stock === "number") return stock;
+  if (stock && typeof stock === "object" && typeof stock.quantity === "number") {
+    return stock.quantity;
+  }
+  return void 0;
+}
+function normalizeVariant(variant) {
+  const out = {
+    variantId: variant.variantId !== void 0 ? String(variant.variantId) : "",
+    barcode: variant.barcode ?? "",
+    attributes: (variant.attributes ?? []).map(normalizeAttribute2),
+    raw: variant
+  };
+  if (typeof variant.commission === "number") out.commission = variant.commission;
+  if (variant.productUrl !== void 0) out.productUrl = variant.productUrl;
+  if (typeof variant.onSale === "boolean") out.onSale = variant.onSale;
+  const stock = normalizeStock(variant.stock);
+  if (stock !== void 0) out.stock = stock;
+  return out;
+}
+function toIso2(epochMs) {
+  if (typeof epochMs !== "number" || !Number.isFinite(epochMs)) return void 0;
+  return new Date(epochMs).toISOString();
+}
+function normalizeProduct(node) {
+  const out = {
+    contentId: node.contentId !== void 0 ? String(node.contentId) : "",
+    productMainId: node.productMainId ?? "",
+    title: node.title ?? "",
+    brand: normalizeRef(node.brand),
+    category: normalizeRef(node.category),
+    images: normalizeImages(node.images),
+    attributes: (node.attributes ?? []).map(normalizeAttribute2),
+    variants: (node.variants ?? []).map(normalizeVariant),
+    createdAt: toIso2(node.creationDate) ?? "",
+    updatedAt: toIso2(node.lastModifiedDate) ?? "",
+    raw: node
+  };
+  if (node.description !== void 0) out.description = node.description;
+  if (node.lastModifiedBy !== void 0) out.lastModifiedBy = node.lastModifiedBy;
+  return out;
+}
+function normalizeUnapprovedRejectReason(r) {
+  const out = {};
+  if (r.rejectReason !== void 0) out.rejectReason = r.rejectReason;
+  if (r.rejectReasonDetail !== void 0) out.rejectReasonDetail = r.rejectReasonDetail;
+  return out;
+}
+function normalizeUnapproved(node) {
+  const imagesSource = node.images ?? node.media;
+  const out = {
+    productMainId: node.productMainId ?? "",
+    brand: normalizeRef(node.brand),
+    category: normalizeRef(node.category),
+    barcode: node.barcode ?? "",
+    title: node.title ?? "",
+    images: normalizeImages(imagesSource),
+    attributes: (node.attributes ?? []).map(normalizeAttribute2),
+    rejectReasonDetails: (node.rejectReasonDetails ?? []).map(normalizeUnapprovedRejectReason),
+    raw: node
+  };
+  if (node.supplierId !== void 0) out.supplierId = String(node.supplierId);
+  if (node.status !== void 0) out.status = node.status;
+  if (node.description !== void 0) out.description = node.description;
+  if (typeof node.quantity === "number") out.quantity = node.quantity;
+  if (typeof node.listPrice === "number") out.listPrice = node.listPrice;
+  if (typeof node.salePrice === "number") out.salePrice = node.salePrice;
+  if (typeof node.vatRate === "number") out.vatRate = node.vatRate;
+  if (node.dimensionalWeight !== void 0 && node.dimensionalWeight !== null) {
+    out.dimensionalWeight = node.dimensionalWeight;
+  }
+  if (node.stockCode !== void 0) out.stockCode = node.stockCode;
+  if (node.origin !== void 0) out.origin = node.origin;
+  if (node.locationBasedDelivery !== void 0) {
+    out.locationBasedDelivery = node.locationBasedDelivery;
+  }
+  if (node.lotNumber !== void 0) out.lotNumber = node.lotNumber;
+  if (node.specialConsumptionTax !== void 0) {
+    out.specialConsumptionTax = node.specialConsumptionTax;
+  }
+  if (node.sgrPrice !== void 0) out.sgrPrice = node.sgrPrice;
+  const createdAt = toIso2(node.createDateTime);
+  if (createdAt) out.createdAt = createdAt;
+  const updatedAt = toIso2(node.lastUpdateDate);
+  if (updatedAt) out.updatedAt = updatedAt;
+  const priceChanged = toIso2(node.lastPriceChangeDate);
+  if (priceChanged) out.lastPriceChangedAt = priceChanged;
+  const stockChanged = toIso2(node.lastStockChangeDate);
+  if (stockChanged) out.lastStockChangedAt = stockChanged;
+  return out;
+}
+function normalizeBuyboxInfo(node) {
+  const out = {
+    barcode: node.barcode ?? "",
+    raw: node
+  };
+  if (typeof node.buyboxOrder === "number") out.buyboxOrder = node.buyboxOrder;
+  if (typeof node.buyboxPrice === "number") out.buyboxPrice = node.buyboxPrice;
+  if (typeof node.hasMultipleSeller === "boolean") {
+    out.hasMultipleSeller = node.hasMultipleSeller;
+  }
+  if (node.secondBuyboxPrice !== void 0) out.secondBuyboxPrice = node.secondBuyboxPrice;
+  if (node.thirdBuyboxPrice !== void 0) out.thirdBuyboxPrice = node.thirdBuyboxPrice;
+  return out;
+}
+function normalizeProductBase(data) {
+  const out = {
+    barcode: data.barcode ?? "",
+    approved: !!data.approved,
+    archived: !!data.archived,
+    raw: data
+  };
+  const approvedAt = toIso2(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);
+  return out;
+}
+function normalizeBatchResult(data) {
+  const items = (data.items ?? []).map((item) => {
+    const result = {};
+    if (item.requestItem !== void 0) result.requestItem = item.requestItem;
+    if (item.status !== void 0) result.status = item.status;
+    if (item.failureReasons !== void 0) result.failureReasons = item.failureReasons;
+    return result;
+  });
+  const out = {
+    batchRequestId: typeof data.batchRequestId === "string" ? data.batchRequestId : "",
+    status: data.status ?? "PROCESSING",
+    items,
+    raw: data
+  };
+  if (typeof data.itemCount === "number") out.itemCount = data.itemCount;
+  if (typeof data.failedItemCount === "number") out.failedItemCount = data.failedItemCount;
+  const createdAt = toIso2(data.creationDate);
+  if (createdAt) out.createdAt = createdAt;
+  const lastModifiedAt = toIso2(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;
+  if (data.notes !== void 0) out.notes = data.notes;
+  if (data.objectKey !== void 0) out.objectKey = data.objectKey;
+  if (data.storeFrontCode !== void 0) out.storeFrontCode = data.storeFrontCode;
+  return out;
+}
+var MAX_WRITE_ITEMS = 1e3;
+var DELETE_RATE_PER_MIN = 100;
+var ProductsResource = class {
+  constructor(transport, sellerId, options = {}) {
+    this.transport = transport;
+    this.sellerId = sellerId;
+    this.filterLimiter = options.filterLimiter ?? new core.TokenBucketRateLimiter({ capacity: 2e3, intervalMs: 6e4 });
+    this.batchLimiter = options.batchLimiter ?? new core.TokenBucketRateLimiter({ capacity: 1e3, intervalMs: 6e4 });
+    this.buyboxLimiter = options.buyboxLimiter ?? new core.TokenBucketRateLimiter({ capacity: 1e3, intervalMs: 6e4 });
+    this.writeLimiter = options.writeLimiter ?? new core.TokenBucketRateLimiter({ capacity: 1e3, intervalMs: 6e4 });
+    this.deleteLimiter = options.deleteLimiter ?? new core.TokenBucketRateLimiter({ capacity: DELETE_RATE_PER_MIN, intervalMs: 6e4 });
+  }
+  transport;
+  sellerId;
+  filterLimiter;
+  batchLimiter;
+  buyboxLimiter;
+  writeLimiter;
+  deleteLimiter;
+  validateBarcodes(barcodes, methodLabel) {
+    if (!Array.isArray(barcodes) || barcodes.length === 0) {
+      throw new core.ValidationError({ message: `${methodLabel}: barcodes must not be empty` });
+    }
+    if (barcodes.length > MAX_WRITE_ITEMS) {
+      throw new core.ValidationError({
+        message: `${methodLabel}: max ${MAX_WRITE_ITEMS} barcodes per call (got ${barcodes.length})`
+      });
+    }
+  }
+  async submitWrite(endpoint, items, methodLabel) {
+    if (!Array.isArray(items) || items.length === 0) {
+      throw new core.ValidationError({ message: `${methodLabel}: items must not be empty` });
+    }
+    if (items.length > MAX_WRITE_ITEMS) {
+      throw new core.ValidationError({
+        message: `${methodLabel}: max ${MAX_WRITE_ITEMS} items per call (got ${items.length})`
+      });
+    }
+    const data = await this.transport.request({
+      method: "POST",
+      path: `/integration/product/sellers/${this.sellerId}${endpoint}`,
+      body: { items },
+      rateLimiter: this.writeLimiter
+    });
+    return { batchRequestId: data?.batchRequestId ?? "" };
+  }
+  /**
+   * List approved products. Use `paginate()` from `@lonca/core` to iterate
+   * lazily across pages.
+   *
+   * Trendyol exposes both page-based and `nextPageToken`-based pagination
+   * (the latter required when the dataset exceeds 10,000 items). The SDK
+   * picks the right strategy automatically — pass our opaque `cursor` from
+   * the previous response and we forward it as `nextPageToken`.
+   *
+   * @example
+   * ```ts
+   * import { paginate } from '@lonca/core';
+   * for await (const product of paginate((p) => client.products.list(p))) {
+   *   for (const variant of product.variants) {
+   *     console.log(variant.barcode, product.title);
+   *   }
+   * }
+   * ```
+   */
+  async list(params = {}) {
+    const size = Math.min(params.limit ?? DEFAULT_PAGE_SIZE3, MAX_PAGE_SIZE2);
+    const query = { size };
+    if (params.cursor) {
+      query.nextPageToken = params.cursor;
+    } else {
+      query.page = 0;
+    }
+    if (params.barcode) query.barcode = params.barcode;
+    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/product/sellers/${this.sellerId}/products/approved`,
+      query,
+      rateLimiter: this.filterLimiter
+    });
+    const items = (data.content ?? []).map(normalizeProduct);
+    const page = { items };
+    if (data.nextPageToken) {
+      page.nextCursor = data.nextPageToken;
+    }
+    return page;
+  }
+  /**
+   * Poll a batch request returned by an async write (e.g. `createProducts`,
+   * `updatePriceAndInventory`).
+   *
+   * Trendyol retains batch results for **4 hours** after the originating
+   * request — poll within that window.
+   *
+   * @param batchRequestId The opaque ID returned by the originating call.
+   */
+  async getBatchStatus(batchRequestId) {
+    const id = encodeURIComponent(batchRequestId);
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/product/sellers/${this.sellerId}/products/batch-requests/${id}`,
+      rateLimiter: this.batchLimiter
+    });
+    return normalizeBatchResult(data);
+  }
+  /**
+   * List **unapproved** (draft / rejected / pending-review) products.
+   *
+   * Wire shape is intentionally flatter than the approved-product shape:
+   * each barcode is one top-level item with `barcode`, `quantity`, `salePrice`
+   * etc. at the root. Rejected drafts carry `rejectReasonDetails` so you can
+   * surface why Trendyol's content team turned them down.
+   *
+   * Pagination follows the same convention as `list()`: `cursor` from the
+   * previous response forwards as `nextPageToken`.
+   *
+   * @example
+   * ```ts
+   * const page = await client.products.listUnapproved({ limit: 50 });
+   * for (const draft of page.items) {
+   *   if (draft.status === 'rejected') {
+   *     console.warn(draft.barcode, draft.rejectReasonDetails);
+   *   }
+   * }
+   * ```
+   */
+  async listUnapproved(params = {}) {
+    const size = Math.min(params.limit ?? DEFAULT_PAGE_SIZE3, MAX_PAGE_SIZE2);
+    const query = { size };
+    if (params.cursor) {
+      query.nextPageToken = params.cursor;
+    } else {
+      query.page = 0;
+    }
+    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.dateQueryType) query.dateQueryType = params.dateQueryType;
+    if (params.supplierId !== void 0) query.supplierId = params.supplierId;
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/product/sellers/${this.sellerId}/products/unapproved`,
+      query,
+      rateLimiter: this.filterLimiter
+    });
+    const items = (data.content ?? []).map(normalizeUnapproved);
+    const page = { items };
+    if (data.nextPageToken) {
+      page.nextCursor = data.nextPageToken;
+    }
+    return page;
+  }
+  /**
+   * Fetch the basic lifecycle status of a single product by barcode.
+   *
+   * Cheap and useful as a polling primitive after `createProducts`: poll
+   * this endpoint until `approved` flips to `true` (or use
+   * `client.products.getBatchStatus()` to track the originating batch).
+   *
+   * @param barcode The product barcode to look up.
+   */
+  async getBase(barcode) {
+    const code = encodeURIComponent(barcode);
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/product/sellers/${this.sellerId}/product/${code}`,
+      rateLimiter: this.filterLimiter
+    });
+    return normalizeProductBase(data);
+  }
+  /**
+   * Fetch buybox information for up to 10 barcodes in one call.
+   *
+   * Returns rank (`buyboxOrder === 1` means you hold the buybox), the
+   * current buybox price, and — beyond the spec — the second and third
+   * competing prices when other sellers are present.
+   *
+   * @param barcodes 1–10 product barcodes.
+   * @throws {ValidationError} when `barcodes` is empty or longer than 10.
+   */
+  async getBuyboxInfo(barcodes) {
+    if (!Array.isArray(barcodes) || barcodes.length === 0) {
+      throw new core.ValidationError({
+        message: "getBuyboxInfo: barcodes must be a non-empty array"
+      });
+    }
+    if (barcodes.length > MAX_BUYBOX_BARCODES) {
+      throw new core.ValidationError({
+        message: `getBuyboxInfo: max ${MAX_BUYBOX_BARCODES} barcodes per call (got ${barcodes.length})`
+      });
+    }
+    const data = await this.transport.request({
+      method: "POST",
+      path: `/integration/product/sellers/${this.sellerId}/products/buybox-information`,
+      body: { barcodes },
+      rateLimiter: this.buyboxLimiter
+    });
+    const list = data.buyboxInfo ?? data.content ?? [];
+    return list.map(normalizeBuyboxInfo);
+  }
+  /**
+   * Create products (V2). Async batch — returns a `batchRequestId` you can
+   * poll with `getBatchStatus`. Max 1000 items per call.
+   *
+   * Trendyol requires the full V2 attribute payload — fetch via
+   * `categories.getAttributes` (and `categories.getAttributeValues` for
+   * values when `allowCustom === false`). Shipment / returning warehouse
+   * IDs come from `suppliers.getAddresses`.
+   *
+   * @throws {ValidationError} when `items` is empty or longer than 1000.
+   */
+  async create(items) {
+    return this.submitWrite("/v2/products", items, "createProducts");
+  }
+  /**
+   * Update **content** of approved products (title, description, images,
+   * attributes). Identified by `contentId`. Partial update is supported
+   * except for attributes — if you update ANY attribute, send ALL of them.
+   *
+   * @throws {ValidationError} when `items` is empty or longer than 1000.
+   */
+  async updateContent(items) {
+    return this.submitWrite("/products/content-bulk-update", items, "updateContent");
+  }
+  /**
+   * Update **variant** fields of approved products (stockCode, vatRate,
+   * dimensionalWeight, warehouse IDs, location-based delivery, lot). Identified
+   * by `barcode`. The barcode itself cannot be changed via this endpoint.
+   *
+   * @throws {ValidationError} when `items` is empty or longer than 1000.
+   */
+  async updateVariants(items) {
+    return this.submitWrite("/products/variant-bulk-update", items, "updateVariants");
+  }
+  /**
+   * Update **unapproved** (draft) products. Identified by `barcode`. All
+   * other fields are optional partial updates. Use this to fix drafts that
+   * Trendyol rejected — `client.products.listUnapproved` surfaces the
+   * `rejectReasonDetails` you need to act on.
+   *
+   * **Gotcha (verified live STAGE 2026-05-25):** Trendyol's V2 spec claims
+   * only `barcode` is required, but the endpoint returns HTTP 500
+   * (`TrendyolSystemException` / `TypeError`) when too many optional fields
+   * are omitted. In practice, send at least `title`, `description`,
+   * `productMainId`, `brandId`, `categoryId`, `stockCode`,
+   * `dimensionalWeight`, `vatRate`, `images[]`, and `attributes[]` (an
+   * empty array is OK for the latter). The SDK forwards your payload
+   * as-is; trim fields only if you have verified the server accepts it.
+   *
+   * @throws {ValidationError} when `items` is empty or longer than 1000.
+   */
+  async updateUnapproved(items) {
+    return this.submitWrite("/products/unapproved-bulk-update", items, "updateUnapproved");
+  }
+  /**
+   * Update product **delivery information** (deliveryDuration,
+   * fastDeliveryType). Identified by `barcode`.
+   *
+   * @throws {ValidationError} when `items` is empty or longer than 1000.
+   */
+  async updateDeliveryInfo(items) {
+    return this.submitWrite("/products/delivery-info-bulk-update", items, "updateDeliveryInfo");
+  }
+  /**
+   * Delete products by barcode. Trendyol allows deletion of unapproved
+   * products and approved products that have been archived for more than a
+   * day (and have not been sales-stopped by Trendyol).
+   *
+   * Async batch — returns `{ batchRequestId }` to poll via `getBatchStatus`.
+   * Separately rate-limited at **100 req/min** (much tighter than create/update).
+   *
+   * @param barcodes 1–1000 barcodes.
+   * @throws {ValidationError} when `barcodes` is empty or longer than 1000.
+   */
+  async delete(barcodes) {
+    this.validateBarcodes(barcodes, "delete");
+    const data = await this.transport.request({
+      method: "DELETE",
+      path: `/integration/product/sellers/${this.sellerId}/products`,
+      body: { items: barcodes.map((barcode) => ({ barcode })) },
+      rateLimiter: this.deleteLimiter
+    });
+    return { batchRequestId: data?.batchRequestId ?? "" };
+  }
+  /**
+   * Archive products by barcode (Trendyol's `archived=true` state).
+   * Archived products are not visible to customers; pair with `delete`
+   * after the 24-hour archive cool-down to remove them entirely.
+   *
+   * Async batch — returns `{ batchRequestId }`.
+   *
+   * @throws {ValidationError} when `barcodes` is empty or longer than 1000.
+   */
+  async archive(barcodes) {
+    return this.setArchivedState(barcodes, true, "archive");
+  }
+  /**
+   * Unarchive products by barcode (Trendyol's `archived=false` state).
+   * Restores visibility for previously-archived products.
+   *
+   * @throws {ValidationError} when `barcodes` is empty or longer than 1000.
+   */
+  async unarchive(barcodes) {
+    return this.setArchivedState(barcodes, false, "unarchive");
+  }
+  async setArchivedState(barcodes, archived, methodLabel) {
+    this.validateBarcodes(barcodes, methodLabel);
+    const data = await this.transport.request({
+      method: "PUT",
+      path: `/integration/product/sellers/${this.sellerId}/products/archive-state`,
+      body: { items: barcodes.map((barcode) => ({ barcode, archived })) },
+      rateLimiter: this.writeLimiter
+    });
+    return { batchRequestId: data?.batchRequestId ?? "" };
+  }
+  /**
+   * Unlock products whose sale was paused by Trendyol due to pricing
+   * issues (under/over-pricing, critical price error, supplier issues).
+   * Restores selling status for the listed barcodes.
+   *
+   * Async batch — returns `{ batchRequestId }`.
+   *
+   * @throws {ValidationError} when `barcodes` is empty or longer than 1000.
+   */
+  async unlock(barcodes) {
+    this.validateBarcodes(barcodes, "unlock");
+    const data = await this.transport.request({
+      method: "PUT",
+      path: `/integration/product/sellers/${this.sellerId}/products/unlock`,
+      body: { items: barcodes.map((barcode) => ({ barcode })) },
+      rateLimiter: this.writeLimiter
+    });
+    return { batchRequestId: data?.batchRequestId ?? "" };
+  }
+};
+var VALID_TYPES = /* @__PURE__ */ new Set([
+  "SHIPMENT",
+  "RETURNING",
+  "INVOICE",
+  "WAREHOUSE"
+]);
+function normalizeAddressType(raw) {
+  if (raw && VALID_TYPES.has(raw)) {
+    return raw;
+  }
+  const stripped = raw?.replace(/_ADDRESS$/, "");
+  if (stripped && VALID_TYPES.has(stripped)) {
+    return stripped;
+  }
+  return "SHIPMENT";
+}
+function normalizeAddress2(node) {
+  return {
+    id: String(node.id),
+    name: node.name,
+    addressType: normalizeAddressType(node.addressType),
+    isShipmentAddress: node.isShipmentAddress ?? false,
+    isReturningAddress: node.isReturningAddress ?? false,
+    isInvoiceAddress: node.isInvoiceAddress ?? false,
+    isDefault: node.isDefault ?? false,
+    address: node.address,
+    city: node.city,
+    district: node.district,
+    postCode: node.postCode,
+    fullName: node.fullName
+  };
+}
+var DEFAULT_CACHE_TTL_MS = 60 * 60 * 1e3;
+var SuppliersResource = class {
+  constructor(transport, sellerId, options = {}) {
+    this.transport = transport;
+    this.sellerId = sellerId;
+    this.cacheTtlMs = options.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS;
+    this.limiter = new core.TokenBucketRateLimiter({
+      capacity: 1,
+      intervalMs: DEFAULT_CACHE_TTL_MS
+    });
+  }
+  transport;
+  sellerId;
+  cache = null;
+  cacheTtlMs;
+  limiter;
+  inflight = null;
+  /**
+   * List the seller's registered addresses (shipment, returning, invoice, warehouse).
+   *
+   * Returns the cached value if it is still fresh. Concurrent calls share a
+   * single in-flight request.
+   */
+  async getAddresses(options = {}) {
+    if (!options.forceRefresh && this.cache && this.cache.expiresAt > Date.now()) {
+      return this.cache.value;
+    }
+    if (this.inflight) return this.inflight;
+    this.inflight = this.fetchFresh().finally(() => {
+      this.inflight = null;
+    });
+    return this.inflight;
+  }
+  /** Drop the cache; the next `getAddresses()` call hits the API. */
+  invalidateCache() {
+    this.cache = null;
+  }
+  async fetchFresh() {
+    const data = await this.transport.request({
+      method: "GET",
+      path: `/integration/sellers/${this.sellerId}/addresses`,
+      rateLimiter: this.limiter
+    });
+    const items = data.supplierAddresses.map(normalizeAddress2);
+    this.cache = { value: items, expiresAt: Date.now() + this.cacheTtlMs };
+    return items;
+  }
 };
 
 // src/auth.ts
@@ -239,11 +1258,21 @@ function createTrendyolClient(opts) {
     timeoutMs: opts.timeoutMs
   });
   return {
-    brands: new BrandsResource(transport)
+    brands: new BrandsResource(transport),
+    categories: new CategoriesResource(transport, void 0, opts.sellerId),
+    suppliers: new SuppliersResource(transport, opts.sellerId),
+    products: new ProductsResource(transport, opts.sellerId),
+    inventory: new InventoryResource(transport, opts.sellerId),
+    orders: new OrdersResource(transport, opts.sellerId)
   };
 }
 
 exports.BrandsResource = BrandsResource;
+exports.CategoriesResource = CategoriesResource;
+exports.InventoryResource = InventoryResource;
+exports.OrdersResource = OrdersResource;
+exports.ProductsResource = ProductsResource;
+exports.SuppliersResource = SuppliersResource;
 exports.createTrendyolClient = createTrendyolClient;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map