@viu/emporix-sdk 2.22.0 → 2.23.0

package/CHANGELOG.md

@@ -1,5 +1,127 @@
 # @viu/emporix-sdk
 
+## 2.23.0
+
+### Minor Changes
+
+- [#172](https://github.com/viuteam/emporix-sdk/pull/172) [`3761f0f`](https://github.com/viuteam/emporix-sdk/commit/3761f0fd7f0eace3dd0dfa30fb76811c484dd7ee) Thanks [@amnael1](https://github.com/amnael1)! - Add availability admin operations to `client.availability`: `listForSite`
+  (paginated per-site listing), per-product `create`/`update`/`delete`, and
+  `bulkCreate`/`bulkUpdate`/`bulkDelete` (207 Multi-Status — inspect each entry;
+  the bulk delete carries a body). Writes default to service auth. The bulk
+  methods accept `{ vendorId }`, sent as the `vendor-id` header — note the OpenAPI
+  schema spells it `venodr-id`, an apparent upstream typo, and the corrected name
+  is not yet verified against the live API. The deprecated location-management
+  endpoints remain unwrapped, and the existing reads are unchanged.
+
+- [#176](https://github.com/viuteam/emporix-sdk/pull/176) [`6f3b296`](https://github.com/viuteam/emporix-sdk/commit/6f3b296ca3c4e81a62459fab82fbd33af6feb7a3) Thanks [@amnael1](https://github.com/amnael1)! - Fix `carts.setShippingAddress` and `carts.setBillingAddress`, which called
+  `/carts/{id}/shipping-address` and `/carts/{id}/billing-address` — paths that do
+  not exist and returned 404 on every call (verified against a live tenant). Cart
+  addresses are set through `PUT /carts/{id}` with an `addresses` array. Because
+  that array is a full replace — sending one type leaves the other as an empty
+  stub — both methods now read the cart, merge in the new address, write, and
+  return the re-fetched cart. Their signatures are unchanged.
+
+  Adds `carts.setAddresses(cartId, { shipping, billing }, auth)` for setting both
+  in a single request, skipping the read. Note it **replaces** the address set: an
+  omitted type is cleared.
+
+- [#167](https://github.com/viuteam/emporix-sdk/pull/167) [`3b7f63a`](https://github.com/viuteam/emporix-sdk/commit/3b7f63afe0264adcf0655694440732fc923b63db) Thanks [@amnael1](https://github.com/amnael1)! - Add the remaining cart operations to `client.carts`: backend `search` (POST
+  `/carts/search`), `delete`, and `update` (which take an unguarded auth so a
+  service token can manage any cart), plus storefront `getItem`, `listDiscounts`,
+  `removeAllDiscounts`, `removeDiscountByIndex`, and `getDeliveryRestrictions`
+  (which keep the customer/anonymous guard). Mutating ops re-fetch and return the
+  updated `Cart` (`delete` returns void). Existing cart methods are unchanged.
+
+- [#166](https://github.com/viuteam/emporix-sdk/pull/166) [`3c058d0`](https://github.com/viuteam/emporix-sdk/commit/3c058d0786132b0ff6281ab39d5f584943c6bf70) Thanks [@amnael1](https://github.com/amnael1)! - Add category admin CRUD to `client.categories`: core writes
+  (`create`/`update`/`patch`/`delete`), POST-body search (`searchByQuery`,
+  `searchTrees`), and a `categories.assignments` sub-resource — `list`,
+  `create`, `bulkCreate`, `remove`, `removeAll`, reference-based
+  `upsertByReference`/`removeByReference`/`bulkUpsertByReference`, and
+  tenant-wide `listCategoriesByReference`/`removeAllByReference`. Writes default
+  to service auth (overridable). The existing storefront reads are unchanged.
+
+- [#162](https://github.com/viuteam/emporix-sdk/pull/162) [`7a4b4a5`](https://github.com/viuteam/emporix-sdk/commit/7a4b4a552ad3c49c08b1b3b9dc057f6d57ef7fb2) Thanks [@amnael1](https://github.com/amnael1)! - Add `client.iam` — a CRUD facade for the current IAM admin surface: `iam.users`
+  (list/create/get/getMe/update/delete + group/scope/access-control reads),
+  `iam.groups` (CRUD + membership + access-controls), `iam.accessControls`
+  (list/get/upsert/delete), `iam.scopes` (list/get/upsertCustom/deleteCustom).
+  Every method takes a required `auth`. `client.customerGroups` now delegates its
+  list/add operations to `iam.groups` (public API unchanged). The deprecated
+  legacy-RBAC model (roles/permissions/resources/templates) is not wrapped.
+
+- [#168](https://github.com/viuteam/emporix-sdk/pull/168) [`81a9b82`](https://github.com/viuteam/emporix-sdk/commit/81a9b826ffad4bdc1fe2b5a8a008e33d77873df2) Thanks [@amnael1](https://github.com/amnael1)! - Complete the order-v2 admin surface. `client.salesOrders` gains `list`,
+  `search`, `create`, `replace` (PUT full-replace, alongside the existing `update`
+  PATCH), `delete`, `listTransitions`, `transition`, `listHistoricalTransitions`,
+  `calculate`, `updateEntries`, and `split`. `client.orders` gains the B2B reads
+  `listForLegalEntity` and `getForLegalEntity`. All sales-order admin methods take
+  a required (service-token) auth; the legal-entity reads take a required customer
+  auth. Existing order methods are unchanged.
+
+- [#171](https://github.com/viuteam/emporix-sdk/pull/171) [`e10181b`](https://github.com/viuteam/emporix-sdk/commit/e10181b9839c4129b6f5ae782de6093e76958772) Thanks [@amnael1](https://github.com/amnael1)! - Add the payment admin surface to `client.payments`. New `payments.modes`
+  sub-resource for payment-mode configuration (`list`/`get`/`create`/`update`/`delete`
+  against `/paymentmodes/config`), and new `payments.transactions` sub-resource for
+  the backend lifecycle: `list`, `get`, `authorize` (backend counterpart of the
+  storefront `authorize`), `capture`, `refund`, and `cancel`. All new methods
+  default to service auth. Note that these endpoints report business failures in
+  the 200 response body (`successful: false`), not as HTTP errors. The existing
+  storefront methods are unchanged.
+
+- [#164](https://github.com/viuteam/emporix-sdk/pull/164) [`ac816f4`](https://github.com/viuteam/emporix-sdk/commit/ac816f431d33433e2d974325e258ded1078fb4bf) Thanks [@amnael1](https://github.com/amnael1)! - Add price admin CRUD to `client.prices`: flat prices
+  (`create`/`list`/`get`/`upsert`/`delete`/`search`/`bulkCreate`/`bulkUpsert`),
+  `prices.models` (price models CRUD), and `prices.lists` (price-list CRUD +
+  search + nested price-list prices incl. bulk create/upsert/delete). Every admin
+  method defaults to `service` auth (override allowed). The existing `match*`
+  methods are unchanged.
+
+- [#170](https://github.com/viuteam/emporix-sdk/pull/170) [`ea68a89`](https://github.com/viuteam/emporix-sdk/commit/ea68a89e4bff3f7c5cd713b9b7804b1714a548c0) Thanks [@amnael1](https://github.com/amnael1)! - Add product admin writes to `client.products`: `create`, `update` (PATCH),
+  `replace` (PUT, with an optional `partial` flag), `delete` (with `force`),
+  `bulkCreate`/`bulkUpdate` (207 Multi-Status — inspect each entry), the
+  dynamic-variant recalculation group (`recalculate`, `listRecalculationJobs`,
+  `getRecalculationJob`), and a `products.templates` sub-resource
+  (`list`/`get`/`create`/`update`/`delete`). Writes default to service auth and
+  expose the endpoints' query flags (`skipVariantGeneration`, `doIndex`,
+  `skipRelatedItemsValidation`); the existing catalog reads are unchanged.
+
+- [#175](https://github.com/viuteam/emporix-sdk/pull/175) [`9cb253b`](https://github.com/viuteam/emporix-sdk/commit/9cb253b2ffea1709cfedbc24e749f964f65b9cc3) Thanks [@amnael1](https://github.com/amnael1)! - Close the last API-coverage gaps. `client.companies` gains `search` (POST
+  `/legal-entities/search`) and `parentHierarchy`; `client.contacts` gains `get`.
+  `client.fees` gains `deleteProductFee` (removing a single fee from a product,
+  next to the existing `deleteProductFees` which clears all) plus
+  `searchItemFeesByProductId` and `searchItemFeesByProductIds` — note these two
+  search bodies are asymmetric upstream (`siteCodes: string[]` vs a single
+  `siteCode`, and `productIds` as a comma-separated string), which the SDK mirrors
+  verbatim. `client.tenantConfig` gains `listGlobal` and `client.clientConfig`
+  gains `listClients`. Every service keeps its existing auth convention.
+
+- [#174](https://github.com/viuteam/emporix-sdk/pull/174) [`58243bb`](https://github.com/viuteam/emporix-sdk/commit/58243bb31e4aca4110d57225c91e1b221d6f29bd) Thanks [@amnael1](https://github.com/amnael1)! - Complete the schema-service coverage in `client.schema`. New `schema.references`
+  sub-resource (`list`/`get`/`create`/`update`/`delete`) — create and update are
+  `multipart/form-data` uploads whose `file` part accepts a `Blob` or a plain
+  object (serialized to JSON). New instance bulk methods `bulkCreateInstances`,
+  `bulkUpsertInstances` and `bulkDeleteInstances` alongside the existing
+  `bulkPatchInstances`, plus `exportCustomEntities` / `importCustomEntities`.
+  Note: the OpenAPI schema declares no request body for the bulk delete, but its
+  description mandates an array of ids — the SDK follows the description and sends
+  one. All methods keep the service's service-token default.
+
+- [#165](https://github.com/viuteam/emporix-sdk/pull/165) [`3a3c611`](https://github.com/viuteam/emporix-sdk/commit/3a3c61123674a523f30982b944b1f04b80d2cc58) Thanks [@amnael1](https://github.com/amnael1)! - Add customer-segment admin CRUD to `client.segments`: segment core
+  (`create`/`search`/`update`/`patch`/`delete`/`match` + `bulkCreate`/`bulkUpdate`/`bulkDelete`),
+  `segments.customers` (list/search + B2C & B2B assign/remove + bulk), and
+  `segments.items` (search + assign/remove per PRODUCT/CATEGORY + bulk). Every
+  admin method defaults to `service` auth (override allowed). The existing
+  storefront read methods are unchanged.
+
+- [#173](https://github.com/viuteam/emporix-sdk/pull/173) [`9a2ddfe`](https://github.com/viuteam/emporix-sdk/commit/9a2ddfe7d66b2eabdb056c99b81f4dad412a9082) Thanks [@amnael1](https://github.com/amnael1)! - Add site-settings admin operations to `client.sites`: `create`, `update`
+  (PATCH), `replace` (PUT, with an optional `expand` query), `delete`,
+  `listCodes` (GET `/siteslist`), and a `sites.mixins` sub-resource
+  (`list`/`get`/`create`/`update`/`replace`/`delete`). Writes default to service
+  auth. `update`/`replace` return nothing — those endpoints respond 200 without a
+  defined body, so re-read with `get(siteCode)` when the updated site is needed.
+  The existing reads are unchanged.
+
+### Patch Changes
+
+- [#169](https://github.com/viuteam/emporix-sdk/pull/169) [`130811b`](https://github.com/viuteam/emporix-sdk/commit/130811b688bd93525964e680224528548af03644) Thanks [@viu-release-bot](https://github.com/apps/viu-release-bot)! - chore(sdk): sync generated types with upstream Emporix API specs
+
+  Updated services: schema
+
 ## 2.22.0
 
 ### Minor Changes

package/dist/availability.cjs

@@ -43,6 +43,7 @@ var EmporixNotFoundError = class extends EmporixError {
 
 // src/services/availability.ts
 var ANON = { kind: "anonymous" };
+var SERVICE = { kind: "service" };
 var AvailabilityService = class {
   constructor(ctx) {
     this.ctx = ctx;
@@ -97,6 +98,123 @@ var AvailabilityService = class {
       }
     );
   }
+  /**
+   * Lists every availability record for a site (`GET /availability/site/{site}`),
+   * wrapped into `PaginatedItems`. Default auth: anonymous.
+   */
+  async listForSite(siteCode, params = {}, auth = ANON) {
+    const pageNumber = params.pageNumber ?? 1;
+    const pageSize = params.pageSize ?? 50;
+    const items = await this.ctx.http.request({
+      method: "GET",
+      path: `/availability/${this.ctx.tenant}/availability/site/${encodeURIComponent(siteCode)}`,
+      query: {
+        pageNumber,
+        pageSize,
+        ...params.q === void 0 ? {} : { q: params.q },
+        ...params.sort === void 0 ? {} : { sort: params.sort }
+      },
+      auth
+    });
+    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };
+  }
+  // --- Admin writes. Default auth: service. ---
+  /**
+   * Creates an availability record for a product on a site
+   * (`POST /availability/{productId}/{site}`). Responds 409 when the record
+   * already exists — use {@link update} to upsert. Default auth: service.
+   */
+  async create(productId, siteCode, input, auth = SERVICE) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: `/availability/${this.ctx.tenant}/availability/${encodeURIComponent(
+        productId
+      )}/${encodeURIComponent(siteCode)}`,
+      body: input,
+      auth
+    });
+  }
+  /**
+   * Upserts a product's availability on a site
+   * (`PUT /availability/{productId}/{site}`). Returns the created record's id
+   * on 201 and nothing on 204. This endpoint has no PATCH counterpart.
+   * Default auth: service.
+   */
+  async update(productId, siteCode, input, auth = SERVICE) {
+    return this.ctx.http.request({
+      method: "PUT",
+      path: `/availability/${this.ctx.tenant}/availability/${encodeURIComponent(
+        productId
+      )}/${encodeURIComponent(siteCode)}`,
+      body: input,
+      auth
+    });
+  }
+  /**
+   * Deletes a product's availability on a site
+   * (`DELETE /availability/{productId}/{site}`). Default auth: service.
+   */
+  async delete(productId, siteCode, auth = SERVICE) {
+    await this.ctx.http.request({
+      method: "DELETE",
+      path: `/availability/${this.ctx.tenant}/availability/${encodeURIComponent(
+        productId
+      )}/${encodeURIComponent(siteCode)}`,
+      auth
+    });
+  }
+  /**
+   * Bulk-creates availability records (`POST /availability/bulk`). Responds 207
+   * Multi-Status: partial failures do **not** throw — inspect each entry.
+   *
+   * `options.vendorId` limits the operation to a vendor's products. It is sent
+   * as the `vendor-id` header. **Note:** the OpenAPI schema spells this header
+   * `venodr-id`, which is an evident upstream typo (the body field is
+   * `vendorId`); the SDK sends the corrected name. Unverified against the live
+   * API — if the service really expects the misspelling, the filter silently
+   * has no effect.
+   *
+   * Default auth: service.
+   */
+  async bulkCreate(input, options = {}, auth = SERVICE) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: `/availability/${this.ctx.tenant}/availability/bulk`,
+      ...options.vendorId === void 0 ? {} : { headers: { "vendor-id": options.vendorId } },
+      body: input,
+      auth
+    });
+  }
+  /**
+   * Bulk-updates availability records (`PUT /availability/bulk`). Responds 207
+   * Multi-Status: partial failures do **not** throw — inspect each entry. See
+   * {@link bulkCreate} for the `vendorId` header caveat. Default auth: service.
+   */
+  async bulkUpdate(input, options = {}, auth = SERVICE) {
+    return this.ctx.http.request({
+      method: "PUT",
+      path: `/availability/${this.ctx.tenant}/availability/bulk`,
+      ...options.vendorId === void 0 ? {} : { headers: { "vendor-id": options.vendorId } },
+      body: input,
+      auth
+    });
+  }
+  /**
+   * Bulk-deletes availability records (`DELETE /availability/bulk`). Unusually
+   * for a DELETE, this endpoint takes a body listing the records to remove.
+   * Responds 207 Multi-Status: partial failures do **not** throw — inspect each
+   * entry. See {@link bulkCreate} for the `vendorId` header caveat. Default
+   * auth: service.
+   */
+  async bulkDelete(input, options = {}, auth = SERVICE) {
+    return this.ctx.http.request({
+      method: "DELETE",
+      path: `/availability/${this.ctx.tenant}/availability/bulk`,
+      ...options.vendorId === void 0 ? {} : { headers: { "vendor-id": options.vendorId } },
+      body: input,
+      auth
+    });
+  }
 };
 
 exports.AvailabilityService = AvailabilityService;

package/dist/availability.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/errors.ts","../src/services/availability.ts"],"names":[],"mappings":"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","file":"availability.cjs","sourcesContent":["/** Keys whose values are stripped from any serialised error body. */\nconst REDACTED_BODY_KEYS = new Set([\n  \"access_token\", \"refresh_token\", \"token\", \"customertoken\", \"saastoken\",\n  \"secret\", \"client_secret\", \"authorization\", \"password\",\n]);\n\nfunction scrub(body: unknown): unknown {\n  if (Array.isArray(body)) return body.map(scrub);\n  if (body && typeof body === \"object\") {\n    const out: Record<string, unknown> = {};\n    for (const [k, v] of Object.entries(body as Record<string, unknown>)) {\n      out[k] = REDACTED_BODY_KEYS.has(k.toLowerCase()) ? \"***redacted***\" : scrub(v);\n    }\n    return out;\n  }\n  return body;\n}\n\n/** Base class for every error thrown by the SDK. */\nexport class EmporixError extends Error {\n  readonly status: number | undefined;\n  readonly body: unknown;\n  constructor(message: string, status?: number, body?: unknown) {\n    super(message);\n    this.name = new.target.name;\n    this.status = status;\n    this.body = body;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n  /** Safe serialisation — token-like body fields are redacted. */\n  toJSON(): Record<string, unknown> {\n    return { name: this.name, message: this.message, status: this.status, body: scrub(this.body) };\n  }\n}\n\n/** 401 — authentication failed or token expired. */\nexport class EmporixAuthError extends EmporixError {}\n/** 403 — authenticated but not permitted. */\nexport class EmporixForbiddenError extends EmporixError {}\n/** 404 — resource not found. */\nexport class EmporixNotFoundError extends EmporixError {}\n/** 400/422 — request validation failed. */\nexport class EmporixValidationError extends EmporixError {}\n/** 5xx — server-side failure. */\nexport class EmporixServerError extends EmporixError {}\n/** Request aborted by the configured connect/read timeout. No HTTP status. */\nexport class EmporixTimeoutError extends EmporixError {}\n/** DNS/TLS/connection-level failure before or during the exchange. No HTTP status. */\nexport class EmporixNetworkError extends EmporixError {}\n\n/**\n * 403 with a `missing scope: <name>` hint in the body's `details` array.\n * Subclasses {@link EmporixForbiddenError} so existing 403 catches still work.\n */\nexport class EmporixInsufficientScopeError extends EmporixForbiddenError {\n  readonly requiredScope: string | undefined;\n  constructor(message: string, status: number, body: unknown, requiredScope?: string) {\n    super(message, status, body);\n    this.requiredScope = requiredScope;\n  }\n}\n\nconst SCOPE_HINT_RE = /missing scope[: ]+([a-z0-9._-]+)/i;\n\nfunction extractRequiredScope(body: unknown): string | undefined {\n  if (body && typeof body === \"object\" && \"details\" in body) {\n    const details = (body as { details?: unknown }).details;\n    if (Array.isArray(details)) {\n      for (const d of details) {\n        if (typeof d === \"string\") {\n          const m = d.match(SCOPE_HINT_RE);\n          if (m) return m[1];\n        }\n      }\n    }\n  }\n  return undefined;\n}\n\n/** Maps an HTTP status to the matching {@link EmporixError} subclass. */\nexport function errorFromResponse(status: number, message: string, body: unknown): EmporixError {\n  if (status === 401) return new EmporixAuthError(message, status, body);\n  if (status === 403) {\n    const scope = extractRequiredScope(body);\n    if (scope) return new EmporixInsufficientScopeError(message, status, body, scope);\n    return new EmporixForbiddenError(message, status, body);\n  }\n  if (status === 404) return new EmporixNotFoundError(message, status, body);\n  if (status === 400 || status === 422) return new EmporixValidationError(message, status, body);\n  if (status >= 500) return new EmporixServerError(message, status, body);\n  return new EmporixError(message, status, body);\n}\n","import type { ClientContext } from \"../core/context\";\nimport type { AuthContext } from \"../core/auth\";\nimport { EmporixNotFoundError } from \"../core/errors\";\nimport type { Availability } from \"./availability-types\";\n\nexport type { Availability } from \"./availability-types\";\n\n/** Shared options for {@link AvailabilityService} reads. */\nexport interface AvailabilityOptions {\n  /**\n   * When `true`, a product with no availability record resolves to a default\n   * `{ available: true }` instead of throwing (single `get`) / being marked\n   * unavailable (`getMany`). Off by default — opt in for tenants that sell\n   * without stock management.\n   */\n  defaultAvailableOnNotFound?: boolean;\n}\n\nconst ANON: AuthContext = { kind: \"anonymous\" };\n\n/**\n * Reads product availability per site. Default auth is anonymous (like\n * `PriceService.matchByContext`); pass a customer/raw/service context to use a\n * different token. Requires the `availability.availability_view` scope on\n * whichever token is used.\n */\nexport class AvailabilityService {\n  static readonly channel = \"availability\" as const;\n  constructor(private readonly ctx: ClientContext) {}\n\n  /**\n   * Single product. Resolves the availability record, or — when\n   * `opts.defaultAvailableOnNotFound` is set — a default available record on 404.\n   */\n  async get(\n    productId: string,\n    siteCode: string,\n    auth: AuthContext = ANON,\n    opts: AvailabilityOptions = {},\n  ): Promise<Availability> {\n    try {\n      return await this.ctx.http.request<Availability>({\n        method: \"GET\",\n        path: `/availability/${this.ctx.tenant}/availability/${encodeURIComponent(\n          productId,\n        )}/${encodeURIComponent(siteCode)}`,\n        auth,\n      });\n    } catch (err) {\n      if (err instanceof EmporixNotFoundError && opts.defaultAvailableOnNotFound) {\n        return { productId, site: siteCode, available: true };\n      }\n      throw err;\n    }\n  }\n\n  /**\n   * Batch read via `POST .../availability/search` (one request). Products with\n   * no availability record are absent from the response; each is synthesized as\n   * `{ available: false }` (or `{ available: true }` when\n   * `opts.defaultAvailableOnNotFound` is set). The result preserves input order\n   * and length. An empty `productIds` resolves to `[]` without a request.\n   */\n  async getMany(\n    productIds: string[],\n    siteCode: string,\n    auth: AuthContext = ANON,\n    opts: AvailabilityOptions = {},\n  ): Promise<Availability[]> {\n    if (productIds.length === 0) return [];\n    const found = await this.ctx.http.request<Availability[]>({\n      method: \"POST\",\n      path: `/availability/${this.ctx.tenant}/availability/search`,\n      auth,\n      query: { site: siteCode, pageSize: productIds.length },\n      body: productIds,\n      idempotent: true, // pure read over POST — safe to replay on 5xx/429\n    });\n    const byId = new Map<string, Availability>();\n    for (const a of found) if (a.productId) byId.set(a.productId, a);\n    return productIds.map(\n      (id) =>\n        byId.get(id) ?? {\n          productId: id,\n          site: siteCode,\n          available: Boolean(opts.defaultAvailableOnNotFound),\n        },\n    );\n  }\n}\n"]}
+{"version":3,"sources":["../src/core/errors.ts","../src/services/availability.ts"],"names":[],"mappings":"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","file":"availability.cjs","sourcesContent":["/** Keys whose values are stripped from any serialised error body. */\nconst REDACTED_BODY_KEYS = new Set([\n  \"access_token\", \"refresh_token\", \"token\", \"customertoken\", \"saastoken\",\n  \"secret\", \"client_secret\", \"authorization\", \"password\",\n]);\n\nfunction scrub(body: unknown): unknown {\n  if (Array.isArray(body)) return body.map(scrub);\n  if (body && typeof body === \"object\") {\n    const out: Record<string, unknown> = {};\n    for (const [k, v] of Object.entries(body as Record<string, unknown>)) {\n      out[k] = REDACTED_BODY_KEYS.has(k.toLowerCase()) ? \"***redacted***\" : scrub(v);\n    }\n    return out;\n  }\n  return body;\n}\n\n/** Base class for every error thrown by the SDK. */\nexport class EmporixError extends Error {\n  readonly status: number | undefined;\n  readonly body: unknown;\n  constructor(message: string, status?: number, body?: unknown) {\n    super(message);\n    this.name = new.target.name;\n    this.status = status;\n    this.body = body;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n  /** Safe serialisation — token-like body fields are redacted. */\n  toJSON(): Record<string, unknown> {\n    return { name: this.name, message: this.message, status: this.status, body: scrub(this.body) };\n  }\n}\n\n/** 401 — authentication failed or token expired. */\nexport class EmporixAuthError extends EmporixError {}\n/** 403 — authenticated but not permitted. */\nexport class EmporixForbiddenError extends EmporixError {}\n/** 404 — resource not found. */\nexport class EmporixNotFoundError extends EmporixError {}\n/** 400/422 — request validation failed. */\nexport class EmporixValidationError extends EmporixError {}\n/** 5xx — server-side failure. */\nexport class EmporixServerError extends EmporixError {}\n/** Request aborted by the configured connect/read timeout. No HTTP status. */\nexport class EmporixTimeoutError extends EmporixError {}\n/** DNS/TLS/connection-level failure before or during the exchange. No HTTP status. */\nexport class EmporixNetworkError extends EmporixError {}\n\n/**\n * 403 with a `missing scope: <name>` hint in the body's `details` array.\n * Subclasses {@link EmporixForbiddenError} so existing 403 catches still work.\n */\nexport class EmporixInsufficientScopeError extends EmporixForbiddenError {\n  readonly requiredScope: string | undefined;\n  constructor(message: string, status: number, body: unknown, requiredScope?: string) {\n    super(message, status, body);\n    this.requiredScope = requiredScope;\n  }\n}\n\nconst SCOPE_HINT_RE = /missing scope[: ]+([a-z0-9._-]+)/i;\n\nfunction extractRequiredScope(body: unknown): string | undefined {\n  if (body && typeof body === \"object\" && \"details\" in body) {\n    const details = (body as { details?: unknown }).details;\n    if (Array.isArray(details)) {\n      for (const d of details) {\n        if (typeof d === \"string\") {\n          const m = d.match(SCOPE_HINT_RE);\n          if (m) return m[1];\n        }\n      }\n    }\n  }\n  return undefined;\n}\n\n/** Maps an HTTP status to the matching {@link EmporixError} subclass. */\nexport function errorFromResponse(status: number, message: string, body: unknown): EmporixError {\n  if (status === 401) return new EmporixAuthError(message, status, body);\n  if (status === 403) {\n    const scope = extractRequiredScope(body);\n    if (scope) return new EmporixInsufficientScopeError(message, status, body, scope);\n    return new EmporixForbiddenError(message, status, body);\n  }\n  if (status === 404) return new EmporixNotFoundError(message, status, body);\n  if (status === 400 || status === 422) return new EmporixValidationError(message, status, body);\n  if (status >= 500) return new EmporixServerError(message, status, body);\n  return new EmporixError(message, status, body);\n}\n","import type { ClientContext, PaginatedItems } from \"../core/context\";\nimport type { AuthContext } from \"../core/auth\";\nimport { EmporixNotFoundError } from \"../core/errors\";\nimport type {\n  Availability,\n  AvailabilityInput,\n  AvailabilityCreated,\n  AvailabilityBulkInput,\n  AvailabilityBulkDeleteInput,\n  AvailabilityBulkResult,\n} from \"./availability-types\";\n\nexport type {\n  Availability,\n  AvailabilityInput,\n  AvailabilityCreated,\n  AvailabilityBulkInput,\n  AvailabilityBulkDeleteInput,\n  AvailabilityBulkResult,\n} from \"./availability-types\";\n\n/** Shared options for {@link AvailabilityService} reads. */\nexport interface AvailabilityOptions {\n  /**\n   * When `true`, a product with no availability record resolves to a default\n   * `{ available: true }` instead of throwing (single `get`) / being marked\n   * unavailable (`getMany`). Off by default — opt in for tenants that sell\n   * without stock management.\n   */\n  defaultAvailableOnNotFound?: boolean;\n}\n\nconst ANON: AuthContext = { kind: \"anonymous\" };\nconst SERVICE: AuthContext = { kind: \"service\" };\n\n/**\n * Reads product availability per site. Default auth is anonymous (like\n * `PriceService.matchByContext`); pass a customer/raw/service context to use a\n * different token. Requires the `availability.availability_view` scope on\n * whichever token is used.\n */\nexport class AvailabilityService {\n  static readonly channel = \"availability\" as const;\n  constructor(private readonly ctx: ClientContext) {}\n\n  /**\n   * Single product. Resolves the availability record, or — when\n   * `opts.defaultAvailableOnNotFound` is set — a default available record on 404.\n   */\n  async get(\n    productId: string,\n    siteCode: string,\n    auth: AuthContext = ANON,\n    opts: AvailabilityOptions = {},\n  ): Promise<Availability> {\n    try {\n      return await this.ctx.http.request<Availability>({\n        method: \"GET\",\n        path: `/availability/${this.ctx.tenant}/availability/${encodeURIComponent(\n          productId,\n        )}/${encodeURIComponent(siteCode)}`,\n        auth,\n      });\n    } catch (err) {\n      if (err instanceof EmporixNotFoundError && opts.defaultAvailableOnNotFound) {\n        return { productId, site: siteCode, available: true };\n      }\n      throw err;\n    }\n  }\n\n  /**\n   * Batch read via `POST .../availability/search` (one request). Products with\n   * no availability record are absent from the response; each is synthesized as\n   * `{ available: false }` (or `{ available: true }` when\n   * `opts.defaultAvailableOnNotFound` is set). The result preserves input order\n   * and length. An empty `productIds` resolves to `[]` without a request.\n   */\n  async getMany(\n    productIds: string[],\n    siteCode: string,\n    auth: AuthContext = ANON,\n    opts: AvailabilityOptions = {},\n  ): Promise<Availability[]> {\n    if (productIds.length === 0) return [];\n    const found = await this.ctx.http.request<Availability[]>({\n      method: \"POST\",\n      path: `/availability/${this.ctx.tenant}/availability/search`,\n      auth,\n      query: { site: siteCode, pageSize: productIds.length },\n      body: productIds,\n      idempotent: true, // pure read over POST — safe to replay on 5xx/429\n    });\n    const byId = new Map<string, Availability>();\n    for (const a of found) if (a.productId) byId.set(a.productId, a);\n    return productIds.map(\n      (id) =>\n        byId.get(id) ?? {\n          productId: id,\n          site: siteCode,\n          available: Boolean(opts.defaultAvailableOnNotFound),\n        },\n    );\n  }\n\n  /**\n   * Lists every availability record for a site (`GET /availability/site/{site}`),\n   * wrapped into `PaginatedItems`. Default auth: anonymous.\n   */\n  async listForSite(\n    siteCode: string,\n    params: { pageNumber?: number; pageSize?: number; q?: string; sort?: string } = {},\n    auth: AuthContext = ANON,\n  ): Promise<PaginatedItems<Availability>> {\n    const pageNumber = params.pageNumber ?? 1;\n    const pageSize = params.pageSize ?? 50;\n    const items = await this.ctx.http.request<Availability[]>({\n      method: \"GET\",\n      path: `/availability/${this.ctx.tenant}/availability/site/${encodeURIComponent(siteCode)}`,\n      query: {\n        pageNumber,\n        pageSize,\n        ...(params.q === undefined ? {} : { q: params.q }),\n        ...(params.sort === undefined ? {} : { sort: params.sort }),\n      },\n      auth,\n    });\n    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };\n  }\n\n  // --- Admin writes. Default auth: service. ---\n\n  /**\n   * Creates an availability record for a product on a site\n   * (`POST /availability/{productId}/{site}`). Responds 409 when the record\n   * already exists — use {@link update} to upsert. Default auth: service.\n   */\n  async create(\n    productId: string,\n    siteCode: string,\n    input: AvailabilityInput,\n    auth: AuthContext = SERVICE,\n  ): Promise<AvailabilityCreated> {\n    return this.ctx.http.request<AvailabilityCreated>({\n      method: \"POST\",\n      path: `/availability/${this.ctx.tenant}/availability/${encodeURIComponent(\n        productId,\n      )}/${encodeURIComponent(siteCode)}`,\n      body: input,\n      auth,\n    });\n  }\n\n  /**\n   * Upserts a product's availability on a site\n   * (`PUT /availability/{productId}/{site}`). Returns the created record's id\n   * on 201 and nothing on 204. This endpoint has no PATCH counterpart.\n   * Default auth: service.\n   */\n  async update(\n    productId: string,\n    siteCode: string,\n    input: AvailabilityInput,\n    auth: AuthContext = SERVICE,\n  ): Promise<AvailabilityCreated | void> {\n    return this.ctx.http.request<AvailabilityCreated | void>({\n      method: \"PUT\",\n      path: `/availability/${this.ctx.tenant}/availability/${encodeURIComponent(\n        productId,\n      )}/${encodeURIComponent(siteCode)}`,\n      body: input,\n      auth,\n    });\n  }\n\n  /**\n   * Deletes a product's availability on a site\n   * (`DELETE /availability/{productId}/{site}`). Default auth: service.\n   */\n  async delete(productId: string, siteCode: string, auth: AuthContext = SERVICE): Promise<void> {\n    await this.ctx.http.request<void>({\n      method: \"DELETE\",\n      path: `/availability/${this.ctx.tenant}/availability/${encodeURIComponent(\n        productId,\n      )}/${encodeURIComponent(siteCode)}`,\n      auth,\n    });\n  }\n\n  /**\n   * Bulk-creates availability records (`POST /availability/bulk`). Responds 207\n   * Multi-Status: partial failures do **not** throw — inspect each entry.\n   *\n   * `options.vendorId` limits the operation to a vendor's products. It is sent\n   * as the `vendor-id` header. **Note:** the OpenAPI schema spells this header\n   * `venodr-id`, which is an evident upstream typo (the body field is\n   * `vendorId`); the SDK sends the corrected name. Unverified against the live\n   * API — if the service really expects the misspelling, the filter silently\n   * has no effect.\n   *\n   * Default auth: service.\n   */\n  async bulkCreate(\n    input: AvailabilityBulkInput[],\n    options: { vendorId?: string } = {},\n    auth: AuthContext = SERVICE,\n  ): Promise<AvailabilityBulkResult[]> {\n    return this.ctx.http.request<AvailabilityBulkResult[]>({\n      method: \"POST\",\n      path: `/availability/${this.ctx.tenant}/availability/bulk`,\n      ...(options.vendorId === undefined ? {} : { headers: { \"vendor-id\": options.vendorId } }),\n      body: input,\n      auth,\n    });\n  }\n\n  /**\n   * Bulk-updates availability records (`PUT /availability/bulk`). Responds 207\n   * Multi-Status: partial failures do **not** throw — inspect each entry. See\n   * {@link bulkCreate} for the `vendorId` header caveat. Default auth: service.\n   */\n  async bulkUpdate(\n    input: AvailabilityBulkInput[],\n    options: { vendorId?: string } = {},\n    auth: AuthContext = SERVICE,\n  ): Promise<AvailabilityBulkResult[]> {\n    return this.ctx.http.request<AvailabilityBulkResult[]>({\n      method: \"PUT\",\n      path: `/availability/${this.ctx.tenant}/availability/bulk`,\n      ...(options.vendorId === undefined ? {} : { headers: { \"vendor-id\": options.vendorId } }),\n      body: input,\n      auth,\n    });\n  }\n\n  /**\n   * Bulk-deletes availability records (`DELETE /availability/bulk`). Unusually\n   * for a DELETE, this endpoint takes a body listing the records to remove.\n   * Responds 207 Multi-Status: partial failures do **not** throw — inspect each\n   * entry. See {@link bulkCreate} for the `vendorId` header caveat. Default\n   * auth: service.\n   */\n  async bulkDelete(\n    input: AvailabilityBulkDeleteInput[],\n    options: { vendorId?: string } = {},\n    auth: AuthContext = SERVICE,\n  ): Promise<AvailabilityBulkResult[]> {\n    return this.ctx.http.request<AvailabilityBulkResult[]>({\n      method: \"DELETE\",\n      path: `/availability/${this.ctx.tenant}/availability/bulk`,\n      ...(options.vendorId === undefined ? {} : { headers: { \"vendor-id\": options.vendorId } }),\n      body: input,\n      auth,\n    });\n  }\n}\n"]}

package/dist/availability.d.cts

@@ -1,5 +1,81 @@
-import { C as ClientContext, b as AuthContext } from './context-CfXJcYKP.cjs';
+import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-CfXJcYKP.cjs';
 
+type AvailabilityDto = {
+    /**
+     * Stock level of the product, expressed as a number.
+     */
+    stockLevel?: number;
+    /**
+     * Flag indicating whether the product is available.
+     */
+    available?: boolean;
+    /**
+     * Popularity of the product, expressed as a number.
+     */
+    popularity?: number;
+    distributionChannel?: DistributionChannel;
+    /**
+     * The field contains mixins values.
+     */
+    mixins?: {
+        [key: string]: unknown;
+    };
+    metadata?: {
+        /**
+         * Links to the mixin schemas.
+         */
+        mixins?: {
+            [key: string]: string;
+        };
+    };
+};
+type AvailabilityBulkDto = {
+    /**
+     * Unique identifier of the product.
+     */
+    productId?: string;
+    /**
+     * Unique identifier of the site.
+     */
+    site?: string;
+    /**
+     * Stock level of the product, expressed as a number.
+     */
+    stockLevel?: number;
+    /**
+     * Flag indicating whether the product is available.
+     */
+    available?: boolean;
+    /**
+     * Popularity of the product, expressed as a number.
+     */
+    popularity?: number;
+    distributionChannel?: DistributionChannel;
+    /**
+     * The field contains mixins values.
+     */
+    mixins?: {
+        [key: string]: unknown;
+    };
+    metadata?: {
+        /**
+         * Links to the mixin schemas.
+         */
+        mixins?: {
+            [key: string]: string;
+        };
+    };
+};
+type AvailabilityDeleteBulkDto = {
+    /**
+     * Unique identifier of the product.
+     */
+    productId?: string;
+    /**
+     * Unique identifier of the site.
+     */
+    site?: string;
+};
 /**
  * Availability details.
  */
@@ -118,10 +194,38 @@ type AvailabilityWithBundle = {
     };
 };
 type AvailabilityList = Array<Availability$1>;
+type BulkResponse = {
+    /**
+     * ID of the affected availability (in the format <site>:&lt;<productId>).
+     */
+    id?: string;
+    /**
+     * Index of the processed item, matching the item position in request body.
+     */
+    index?: number;
+    /**
+     * HTTP Status Code.
+     */
+    code?: number;
+    /**
+     * HTTP Status description.
+     */
+    status?: string;
+    /**
+     * Error message. Present only when an error occurs (HTTP status code from groups `4xx` or `5xx`)
+     */
+    message?: string;
+};
 /**
  * Name of the product distribution channel.
  */
 type DistributionChannel = 'ASSORTMENT' | 'HOME_DELIVERY' | 'PICKUP';
+type IdResponse = {
+    /**
+     * ID of the created resource.
+     */
+    id?: string;
+};
 
 /**
  * Public types for the Availability Service — stable names aliased over the
@@ -135,6 +239,16 @@ type DistributionChannel = 'ASSORTMENT' | 'HOME_DELIVERY' | 'PICKUP';
 
 /** A product's availability record (bundle-aware). */
 type Availability = AvailabilityWithBundle;
+/** Body for creating or updating a single product's availability. */
+type AvailabilityInput = AvailabilityDto;
+/** Id envelope returned when an availability record is created. */
+type AvailabilityCreated = IdResponse;
+/** One entry of a bulk create/update request. */
+type AvailabilityBulkInput = AvailabilityBulkDto;
+/** One entry of a bulk delete request. */
+type AvailabilityBulkDeleteInput = AvailabilityDeleteBulkDto;
+/** Per-entry result of a bulk availability operation (207 Multi-Status). */
+type AvailabilityBulkResult = BulkResponse;
 
 /** Shared options for {@link AvailabilityService} reads. */
 interface AvailabilityOptions {
@@ -169,6 +283,68 @@ declare class AvailabilityService {
      * and length. An empty `productIds` resolves to `[]` without a request.
      */
     getMany(productIds: string[], siteCode: string, auth?: AuthContext, opts?: AvailabilityOptions): Promise<Availability[]>;
+    /**
+     * Lists every availability record for a site (`GET /availability/site/{site}`),
+     * wrapped into `PaginatedItems`. Default auth: anonymous.
+     */
+    listForSite(siteCode: string, params?: {
+        pageNumber?: number;
+        pageSize?: number;
+        q?: string;
+        sort?: string;
+    }, auth?: AuthContext): Promise<PaginatedItems<Availability>>;
+    /**
+     * Creates an availability record for a product on a site
+     * (`POST /availability/{productId}/{site}`). Responds 409 when the record
+     * already exists — use {@link update} to upsert. Default auth: service.
+     */
+    create(productId: string, siteCode: string, input: AvailabilityInput, auth?: AuthContext): Promise<AvailabilityCreated>;
+    /**
+     * Upserts a product's availability on a site
+     * (`PUT /availability/{productId}/{site}`). Returns the created record's id
+     * on 201 and nothing on 204. This endpoint has no PATCH counterpart.
+     * Default auth: service.
+     */
+    update(productId: string, siteCode: string, input: AvailabilityInput, auth?: AuthContext): Promise<AvailabilityCreated | void>;
+    /**
+     * Deletes a product's availability on a site
+     * (`DELETE /availability/{productId}/{site}`). Default auth: service.
+     */
+    delete(productId: string, siteCode: string, auth?: AuthContext): Promise<void>;
+    /**
+     * Bulk-creates availability records (`POST /availability/bulk`). Responds 207
+     * Multi-Status: partial failures do **not** throw — inspect each entry.
+     *
+     * `options.vendorId` limits the operation to a vendor's products. It is sent
+     * as the `vendor-id` header. **Note:** the OpenAPI schema spells this header
+     * `venodr-id`, which is an evident upstream typo (the body field is
+     * `vendorId`); the SDK sends the corrected name. Unverified against the live
+     * API — if the service really expects the misspelling, the filter silently
+     * has no effect.
+     *
+     * Default auth: service.
+     */
+    bulkCreate(input: AvailabilityBulkInput[], options?: {
+        vendorId?: string;
+    }, auth?: AuthContext): Promise<AvailabilityBulkResult[]>;
+    /**
+     * Bulk-updates availability records (`PUT /availability/bulk`). Responds 207
+     * Multi-Status: partial failures do **not** throw — inspect each entry. See
+     * {@link bulkCreate} for the `vendorId` header caveat. Default auth: service.
+     */
+    bulkUpdate(input: AvailabilityBulkInput[], options?: {
+        vendorId?: string;
+    }, auth?: AuthContext): Promise<AvailabilityBulkResult[]>;
+    /**
+     * Bulk-deletes availability records (`DELETE /availability/bulk`). Unusually
+     * for a DELETE, this endpoint takes a body listing the records to remove.
+     * Responds 207 Multi-Status: partial failures do **not** throw — inspect each
+     * entry. See {@link bulkCreate} for the `vendorId` header caveat. Default
+     * auth: service.
+     */
+    bulkDelete(input: AvailabilityBulkDeleteInput[], options?: {
+        vendorId?: string;
+    }, auth?: AuthContext): Promise<AvailabilityBulkResult[]>;
 }
 
-export { type Availability, type AvailabilityOptions, AvailabilityService };
+export { type Availability, type AvailabilityBulkDeleteInput, type AvailabilityBulkInput, type AvailabilityBulkResult, type AvailabilityCreated, type AvailabilityInput, type AvailabilityOptions, AvailabilityService };