@viu/emporix-sdk 2.18.0 → 2.19.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @viu/emporix-sdk
 
+## 2.19.0
+
+### Minor Changes
+
+- [#139](https://github.com/viuteam/emporix-sdk/pull/139) [`1b17743`](https://github.com/viuteam/emporix-sdk/commit/1b17743719e03146c1a66a8ebd3f02c25dd48590) Thanks [@amnael1](https://github.com/amnael1)! - Sync with the Emporix changelog (2026-06-18). New indexing reindex-jobs API:
+  `indexing.createReindexJob`, `indexing.listReindexJobs`, `indexing.getReindexJob`
+  (replacing the now-deprecated `indexing.reindex`). Deprecated `ragIndexer.reindex`
+  (use `indexing.createReindexJob({ entityType: "PRODUCT", rag: true })`), the whole
+  `SepaExportService` and `PickPackService`, and the deprecated approval price fields.
+  Availability is now fetched + vendored through the codegen pipeline. Adds upstream
+  version tracking: `specs/.sync-manifest.json` (written by `fetch-specs`) plus
+  `docs/emporix-upstream-changelog.md`.
+
 ## 2.18.0
 
 ### Minor Changes

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 { AvailabilityWithBundle } from \"../generated/availability\";\n\n/**\n * Site-aware product availability. Mirrors the Emporix Availability Service\n * `AvailabilityWithBundle` shape (the single-product GET and the batch search\n * both return the bundle-aware variant). There is no restock-date field.\n */\nexport type Availability = AvailabilityWithBundle;\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 } 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"]}

package/dist/availability.d.cts

@@ -1,55 +1,141 @@
 import { C as ClientContext, b as AuthContext } from './context-DhoFgoKf.cjs';
 
-type DistributionChannel = 'ASSORTMENT' | 'HOME_DELIVERY' | 'PICKUP';
+/**
+ * Availability details.
+ */
 type Availability$1 = {
+    /**
+     * Unique identifier of the availability.
+     *
+     * **Note**: The value should be provided in the `site`:`productId` format.
+     */
     id?: string;
+    /**
+     * Site code, defined when the site is created. The value should match the `site` query/path parameter value.
+     */
     site?: string;
+    /**
+     * Stock level of the product, expressed as a number.
+     */
     stockLevel?: number;
+    /**
+     * Flag indicating whether the product is available.
+     */
     available?: boolean;
+    /**
+     * Unique identifier of the product, generated when the product is created through the Product Service.
+     */
     productId?: string;
+    /**
+     * Id of a vendor to which the availability belongs.
+     */
     vendorId?: string;
+    /**
+     * Popularity of the product, expressed as a number.
+     */
     popularity?: number;
     distributionChannel?: DistributionChannel;
+    /**
+     * The field contains mixins values.
+     */
     mixins?: {
         [key: string]: unknown;
     };
     metadata?: {
-        createdAt?: string;
-        modifiedAt?: string;
+        /**
+         * Links to the mixin schemas.
+         */
         mixins?: {
             [key: string]: string;
         };
+        /**
+         * Date and time when the availability was created.
+         */
+        createdAt?: string;
+        /**
+         * Date and time when the availability was last updated.
+         */
+        modifiedAt?: string;
     };
 };
+/**
+ * Availability details.
+ */
 type AvailabilityWithBundle = {
+    /**
+     * Unique identifier of the availability.
+     *
+     * **Note**: The value should be provided in the `site`:`productId` format.
+     */
     id?: string;
+    /**
+     * Site code, defined when the site is created. The value should match the `site` query/path parameter value.
+     */
     site?: string;
+    /**
+     * Stock level of the product, expressed as a number.
+     */
     stockLevel?: number;
+    /**
+     * Flag indicating whether the product is available.
+     */
     available?: boolean;
+    /**
+     * Unique identifier of the product, generated when the product is created through the Product Service.
+     */
     productId?: string;
+    /**
+     * Id of a vendor to which the availability belongs.
+     */
     vendorId?: string;
+    /**
+     * Popularity of the product, expressed as a number.
+     */
     popularity?: number;
     distributionChannel?: DistributionChannel;
     bundleAvailabilities?: AvailabilityList;
+    /**
+     * The field contains mixins values.
+     */
     mixins?: {
         [key: string]: unknown;
     };
     metadata?: {
-        createdAt?: string;
-        modifiedAt?: string;
+        /**
+         * Links to the mixin schemas.
+         */
         mixins?: {
             [key: string]: string;
         };
+        /**
+         * Date and time when the availability was created.
+         */
+        createdAt?: string;
+        /**
+         * Date and time when the availability was last updated.
+         */
+        modifiedAt?: string;
     };
 };
 type AvailabilityList = Array<Availability$1>;
+/**
+ * Name of the product distribution channel.
+ */
+type DistributionChannel = 'ASSORTMENT' | 'HOME_DELIVERY' | 'PICKUP';
 
 /**
- * Site-aware product availability. Mirrors the Emporix Availability Service
- * `AvailabilityWithBundle` shape (the single-product GET and the batch search
- * both return the bundle-aware variant). There is no restock-date field.
+ * Public types for the Availability Service — stable names aliased over the
+ * generated `availability` types. The single-product GET and the batch search
+ * both return the bundle-aware variant; there is no restock-date field.
+ *
+ * Note: only the availability *location-management* endpoints are deprecated
+ * upstream (removal 2026-09-01); the SDK does not wrap those. The product
+ * availability endpoints used here are current.
  */
+
+/** A product's availability record (bundle-aware). */
 type Availability = AvailabilityWithBundle;
+
 /** Shared options for {@link AvailabilityService} reads. */
 interface AvailabilityOptions {
     /**

package/dist/availability.d.ts

@@ -1,55 +1,141 @@
 import { C as ClientContext, b as AuthContext } from './context-DhoFgoKf.js';
 
-type DistributionChannel = 'ASSORTMENT' | 'HOME_DELIVERY' | 'PICKUP';
+/**
+ * Availability details.
+ */
 type Availability$1 = {
+    /**
+     * Unique identifier of the availability.
+     *
+     * **Note**: The value should be provided in the `site`:`productId` format.
+     */
     id?: string;
+    /**
+     * Site code, defined when the site is created. The value should match the `site` query/path parameter value.
+     */
     site?: string;
+    /**
+     * Stock level of the product, expressed as a number.
+     */
     stockLevel?: number;
+    /**
+     * Flag indicating whether the product is available.
+     */
     available?: boolean;
+    /**
+     * Unique identifier of the product, generated when the product is created through the Product Service.
+     */
     productId?: string;
+    /**
+     * Id of a vendor to which the availability belongs.
+     */
     vendorId?: string;
+    /**
+     * Popularity of the product, expressed as a number.
+     */
     popularity?: number;
     distributionChannel?: DistributionChannel;
+    /**
+     * The field contains mixins values.
+     */
     mixins?: {
         [key: string]: unknown;
     };
     metadata?: {
-        createdAt?: string;
-        modifiedAt?: string;
+        /**
+         * Links to the mixin schemas.
+         */
         mixins?: {
             [key: string]: string;
         };
+        /**
+         * Date and time when the availability was created.
+         */
+        createdAt?: string;
+        /**
+         * Date and time when the availability was last updated.
+         */
+        modifiedAt?: string;
     };
 };
+/**
+ * Availability details.
+ */
 type AvailabilityWithBundle = {
+    /**
+     * Unique identifier of the availability.
+     *
+     * **Note**: The value should be provided in the `site`:`productId` format.
+     */
     id?: string;
+    /**
+     * Site code, defined when the site is created. The value should match the `site` query/path parameter value.
+     */
     site?: string;
+    /**
+     * Stock level of the product, expressed as a number.
+     */
     stockLevel?: number;
+    /**
+     * Flag indicating whether the product is available.
+     */
     available?: boolean;
+    /**
+     * Unique identifier of the product, generated when the product is created through the Product Service.
+     */
     productId?: string;
+    /**
+     * Id of a vendor to which the availability belongs.
+     */
     vendorId?: string;
+    /**
+     * Popularity of the product, expressed as a number.
+     */
     popularity?: number;
     distributionChannel?: DistributionChannel;
     bundleAvailabilities?: AvailabilityList;
+    /**
+     * The field contains mixins values.
+     */
     mixins?: {
         [key: string]: unknown;
     };
     metadata?: {
-        createdAt?: string;
-        modifiedAt?: string;
+        /**
+         * Links to the mixin schemas.
+         */
         mixins?: {
             [key: string]: string;
         };
+        /**
+         * Date and time when the availability was created.
+         */
+        createdAt?: string;
+        /**
+         * Date and time when the availability was last updated.
+         */
+        modifiedAt?: string;
     };
 };
 type AvailabilityList = Array<Availability$1>;
+/**
+ * Name of the product distribution channel.
+ */
+type DistributionChannel = 'ASSORTMENT' | 'HOME_DELIVERY' | 'PICKUP';
 
 /**
- * Site-aware product availability. Mirrors the Emporix Availability Service
- * `AvailabilityWithBundle` shape (the single-product GET and the batch search
- * both return the bundle-aware variant). There is no restock-date field.
+ * Public types for the Availability Service — stable names aliased over the
+ * generated `availability` types. The single-product GET and the batch search
+ * both return the bundle-aware variant; there is no restock-date field.
+ *
+ * Note: only the availability *location-management* endpoints are deprecated
+ * upstream (removal 2026-09-01); the SDK does not wrap those. The product
+ * availability endpoints used here are current.
  */
+
+/** A product's availability record (bundle-aware). */
 type Availability = AvailabilityWithBundle;
+
 /** Shared options for {@link AvailabilityService} reads. */
 interface AvailabilityOptions {
     /**

package/dist/availability.js

@@ -1,4 +1,4 @@
-export { AvailabilityService } from './chunk-K3VQLW3P.js';
+export { AvailabilityService } from './chunk-IVCCGJN5.js';
 import './chunk-UWGGF4MC.js';
 //# sourceMappingURL=availability.js.map
 //# sourceMappingURL=availability.js.map

package/dist/{chunk-K3VQLW3P.js → chunk-IVCCGJN5.js}

@@ -59,5 +59,5 @@ var AvailabilityService = class {
 };
 
 export { AvailabilityService };
-//# sourceMappingURL=chunk-K3VQLW3P.js.map
-//# sourceMappingURL=chunk-K3VQLW3P.js.map
+//# sourceMappingURL=chunk-IVCCGJN5.js.map
+//# sourceMappingURL=chunk-IVCCGJN5.js.map

package/dist/chunk-IVCCGJN5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/services/availability.ts"],"names":[],"mappings":";;;AAkBA,IAAM,IAAA,GAAoB,EAAE,IAAA,EAAM,WAAA,EAAY;AAQvC,IAAM,sBAAN,MAA0B;AAAA,EAE/B,YAA6B,GAAA,EAAoB;AAApB,IAAA,IAAA,CAAA,GAAA,GAAA,GAAA;AAAA,EAAqB;AAAA,EAArB,GAAA;AAAA,EAD7B,OAAgB,OAAA,GAAU,cAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO1B,MAAM,IACJ,SAAA,EACA,QAAA,EACA,OAAoB,IAAA,EACpB,IAAA,GAA4B,EAAC,EACN;AACvB,IAAA,IAAI;AACF,MAAA,OAAO,MAAM,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,OAAA,CAAsB;AAAA,QAC/C,MAAA,EAAQ,KAAA;AAAA,QACR,IAAA,EAAM,CAAA,cAAA,EAAiB,IAAA,CAAK,GAAA,CAAI,MAAM,CAAA,cAAA,EAAiB,kBAAA;AAAA,UACrD;AAAA,SACD,CAAA,CAAA,EAAI,kBAAA,CAAmB,QAAQ,CAAC,CAAA,CAAA;AAAA,QACjC;AAAA,OACD,CAAA;AAAA,IACH,SAAS,GAAA,EAAK;AACZ,MAAA,IAAI,GAAA,YAAe,oBAAA,IAAwB,IAAA,CAAK,0BAAA,EAA4B;AAC1E,QAAA,OAAO,EAAE,SAAA,EAAW,IAAA,EAAM,QAAA,EAAU,WAAW,IAAA,EAAK;AAAA,MACtD;AACA,MAAA,MAAM,GAAA;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,QACJ,UAAA,EACA,QAAA,EACA,OAAoB,IAAA,EACpB,IAAA,GAA4B,EAAC,EACJ;AACzB,IAAA,IAAI,UAAA,CAAW,MAAA,KAAW,CAAA,EAAG,OAAO,EAAC;AACrC,IAAA,MAAM,KAAA,GAAQ,MAAM,IAAA,CAAK,GAAA,CAAI,KAAK,OAAA,CAAwB;AAAA,MACxD,MAAA,EAAQ,MAAA;AAAA,MACR,IAAA,EAAM,CAAA,cAAA,EAAiB,IAAA,CAAK,GAAA,CAAI,MAAM,CAAA,oBAAA,CAAA;AAAA,MACtC,IAAA;AAAA,MACA,OAAO,EAAE,IAAA,EAAM,QAAA,EAAU,QAAA,EAAU,WAAW,MAAA,EAAO;AAAA,MACrD,IAAA,EAAM,UAAA;AAAA,MACN,UAAA,EAAY;AAAA;AAAA,KACb,CAAA;AACD,IAAA,MAAM,IAAA,uBAAW,GAAA,EAA0B;AAC3C,IAAA,KAAA,MAAW,CAAA,IAAK,OAAO,IAAI,CAAA,CAAE,WAAW,IAAA,CAAK,GAAA,CAAI,CAAA,CAAE,SAAA,EAAW,CAAC,CAAA;AAC/D,IAAA,OAAO,UAAA,CAAW,GAAA;AAAA,MAChB,CAAC,EAAA,KACC,IAAA,CAAK,GAAA,CAAI,EAAE,CAAA,IAAK;AAAA,QACd,SAAA,EAAW,EAAA;AAAA,QACX,IAAA,EAAM,QAAA;AAAA,QACN,SAAA,EAAW,OAAA,CAAQ,IAAA,CAAK,0BAA0B;AAAA;AACpD,KACJ;AAAA,EACF;AACF","file":"chunk-IVCCGJN5.js","sourcesContent":["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"]}

package/dist/index.cjs

@@ -783,7 +783,7 @@ var HttpClient = class {
 };
 
 // package.json
-var version = "2.18.0";
+var version = "2.19.0";
 
 // src/version.ts
 var SDK_VERSION = version;
@@ -2842,6 +2842,8 @@ var RagIndexerService = class {
    * Schedule a full asynchronous re-index for `type` (default `"PRODUCT"`).
    * Resolves once the rebuild is *scheduled* (HTTP 204); there is no progress
    * to await or poll. Costly — avoid calling on a hot path.
+   * @deprecated since 2026-06-18, removal 2026-12-01 — use the indexing service:
+   * `client.indexing.createReindexJob({ entityType: "PRODUCT", rag: true })`.
    */
   async reindex(type = "PRODUCT", auth2 = SERVICE5) {
     await this.ctx.http.request({
@@ -4802,7 +4804,47 @@ var IndexingService = class {
       auth: auth2
     });
   }
-  /** Trigger a reindex. */
+  /**
+   * Create a reindex job (replaces {@link reindex}). A `FULL` reindex of the
+   * given `entityType`; set `rag: true` to also rebuild the RAG vector index
+   * (PRODUCT only). Resolves to the created job (`201`) or, when a job for that
+   * `entityType` is already `IN_PROGRESS`, that running job (`200`).
+   */
+  async createReindexJob(input, auth2 = SERVICE21) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: `${this.base()}/reindex-jobs`,
+      auth: auth2,
+      body: input
+    });
+  }
+  /** List reindex jobs (paginated). */
+  async listReindexJobs(opts = {}, auth2 = SERVICE21) {
+    const pageNumber = opts.pageNumber ?? 1;
+    const pageSize = opts.pageSize ?? 50;
+    const query = { pageNumber, pageSize };
+    if (opts.q !== void 0) query.q = opts.q;
+    const items = await this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/reindex-jobs`,
+      query,
+      auth: auth2
+    });
+    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };
+  }
+  /** Fetch one reindex job by id. */
+  async getReindexJob(reindexJobId, auth2 = SERVICE21) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/reindex-jobs/${encodeURIComponent(reindexJobId)}`,
+      auth: auth2
+    });
+  }
+  /**
+   * Trigger a reindex.
+   * @deprecated since 2026-06-18, removal 2026-12-01 — use {@link createReindexJob}
+   * (`createReindexJob({ entityType: "PRODUCT" })`), which returns a trackable job.
+   */
   async reindex(input, auth2 = SERVICE21) {
     await this.ctx.http.request({ method: "POST", path: `${this.base()}/reindex`, auth: auth2, body: input });
   }