@viu/emporix-sdk 1.0.0

package/dist/price.cjs

@@ -0,0 +1,88 @@
+'use strict';
+
+// src/core/errors.ts
+var REDACTED_BODY_KEYS = /* @__PURE__ */ new Set([
+  "access_token",
+  "refresh_token",
+  "token",
+  "customertoken",
+  "saastoken",
+  "secret",
+  "client_secret",
+  "authorization",
+  "password"
+]);
+function scrub(body) {
+  if (Array.isArray(body)) return body.map(scrub);
+  if (body && typeof body === "object") {
+    const out = {};
+    for (const [k, v] of Object.entries(body)) {
+      out[k] = REDACTED_BODY_KEYS.has(k.toLowerCase()) ? "***redacted***" : scrub(v);
+    }
+    return out;
+  }
+  return body;
+}
+var EmporixError = class extends Error {
+  status;
+  body;
+  constructor(message, status, body) {
+    super(message);
+    this.name = new.target.name;
+    this.status = status;
+    this.body = body;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+  /** Safe serialisation — token-like body fields are redacted. */
+  toJSON() {
+    return { name: this.name, message: this.message, status: this.status, body: scrub(this.body) };
+  }
+};
+var EmporixAuthError = class extends EmporixError {
+};
+
+// src/services/price.ts
+var ANON = { kind: "anonymous" };
+var SERVICE = { kind: "service" };
+function requireContextAuth(auth) {
+  const a = auth ?? ANON;
+  if (a.kind === "anonymous" || a.kind === "customer" || a.kind === "raw") return a;
+  throw new EmporixAuthError(
+    "match-prices-by-context requires an anonymous, customer, or raw AuthContext"
+  );
+}
+var PriceService = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  ctx;
+  /**
+   * Resolves prices using the session context bound to the bearer token
+   * (currency/site/country were set at anonymous-login time). Default auth:
+   * anonymous; pass a customer/raw context for personalized pricing.
+   */
+  async matchByContext(input, auth) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: `/price/${this.ctx.tenant}/match-prices-by-context`,
+      auth: requireContextAuth(auth),
+      body: input
+    });
+  }
+  /**
+   * Resolves prices from an explicit context. Default auth: service
+   * (requires `price.price_read` / `price.price_manage`).
+   */
+  async match(input, auth = SERVICE) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: `/price/${this.ctx.tenant}/match-prices`,
+      auth,
+      body: input
+    });
+  }
+};
+
+exports.PriceService = PriceService;
+//# sourceMappingURL=price.cjs.map
+//# sourceMappingURL=price.cjs.map

package/dist/price.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/errors.ts","../src/services/price.ts"],"names":[],"mappings":"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","file":"price.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\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 { EmporixAuthError } from \"../core/errors\";\nimport type { Match, MatchByContext, MatchResponse } from \"../generated/price\";\n\n/** Session-context match request body (generated). */\nexport type PriceMatchByContextInput = MatchByContext;\n\n/** Explicit-context match request body (generated). */\nexport type PriceMatchInput = Match;\n\n/** A resolved price (full generated match-response schema). */\nexport type PriceMatch = MatchResponse;\n\nconst ANON: AuthContext = { kind: \"anonymous\" };\nconst SERVICE: AuthContext = { kind: \"service\" };\n\nfunction requireContextAuth(auth: AuthContext | undefined): AuthContext {\n  const a = auth ?? ANON;\n  if (a.kind === \"anonymous\" || a.kind === \"customer\" || a.kind === \"raw\") return a;\n  throw new EmporixAuthError(\n    \"match-prices-by-context requires an anonymous, customer, or raw AuthContext\",\n  );\n}\n\n/**\n * Price matching. The Cart service does not resolve prices — call this\n * explicitly before rendering money and again right before placing an order.\n * The SDK is stateless: it never caches or revalidates prices.\n */\nexport class PriceService {\n  constructor(private readonly ctx: ClientContext) {}\n\n  /**\n   * Resolves prices using the session context bound to the bearer token\n   * (currency/site/country were set at anonymous-login time). Default auth:\n   * anonymous; pass a customer/raw context for personalized pricing.\n   */\n  async matchByContext(\n    input: PriceMatchByContextInput,\n    auth?: AuthContext,\n  ): Promise<PriceMatch[]> {\n    return this.ctx.http.request<PriceMatch[]>({\n      method: \"POST\",\n      path: `/price/${this.ctx.tenant}/match-prices-by-context`,\n      auth: requireContextAuth(auth),\n      body: input,\n    });\n  }\n\n  /**\n   * Resolves prices from an explicit context. Default auth: service\n   * (requires `price.price_read` / `price.price_manage`).\n   */\n  async match(input: PriceMatchInput, auth: AuthContext = SERVICE): Promise<PriceMatch[]> {\n    return this.ctx.http.request<PriceMatch[]>({\n      method: \"POST\",\n      path: `/price/${this.ctx.tenant}/match-prices`,\n      auth,\n      body: input,\n    });\n  }\n}\n"]}

package/dist/price.d.cts

@@ -0,0 +1,445 @@
+import { C as ClientContext, b as AuthContext } from './context-vKgzZ-5f.cjs';
+
+type Metadata = {
+    /**
+     * Date and time when the price was created.
+     */
+    createdAt?: string;
+    /**
+     * Date and time when the price was last modified.
+     */
+    modifiedAt?: string;
+    /**
+     * Version of the price object. If provided optimistic locking will be enabled and it has to match version in the database
+     */
+    version?: number;
+};
+/**
+ * Measurement unit for which the price is defined.
+ */
+type MeasurementUnit = {
+    /**
+     * Quantity of the measurement unit.
+     */
+    quantity: number;
+    /**
+     * Code of the measurement unit.
+     */
+    unitCode: 'kg' | 'g' | 'mg' | 'l' | 'ml' | 'lb' | 'qt' | 'qtr' | 'gal' | 'pt' | 'oz' | 'MTR' | 'XRO' | 'MLT' | 'LTR' | 'H87' | 'KGM' | 'GRM' | 'HLT' | 'DL' | 'DAG' | 'RO';
+};
+/**
+ * Measurement unit for which the price is defined.
+ */
+type MeasurementUnitV2 = {
+    /**
+     * Quantity of the measurement unit.
+     */
+    quantity: number;
+    /**
+     * Code of the measurement unit, as defined in the Unit Handling Service.
+     */
+    unitCode: string;
+};
+/**
+ * Measurement unit for which the price is defined.
+ */
+type MatchMeasurementUnitV2 = {
+    /**
+     * Quantity of the measurement unit.
+     */
+    quantity: number;
+    /**
+     * Code of the measurement unit, as defined in the Unit Handling Service. This attribute is optional, if not provided the price model unit will be used.
+     */
+    unitCode?: string;
+};
+type SalePrice = {
+    /**
+     * Discount expressed as a fixed amount.
+     */
+    discountAmount?: number;
+    /**
+     * Discount expressed as a percentage of the original price.
+     */
+    discountRate?: number;
+    /**
+     * Additional information about the discount.
+     */
+    description?: string;
+};
+type MatchByContext = {
+    /**
+     * List of items (products or prices) for which the prices should be matched.
+     */
+    items?: Array<{
+        /**
+         * Product or price for which a price should be matched.
+         */
+        itemId?: {
+            /**
+             * Type of the referenced item. Possible values:
+             * * `PRODUCT`
+             * * `PRICE`
+             * * `SKU`
+             *
+             * **Note**: The `SKU` value is a `preview` value - the system does not fully operate on the SKU concept yet.
+             */
+            itemType?: string;
+            /**
+             * Item's unique identifier, generated when the item is created.
+             */
+            id?: string;
+        };
+        quantity?: MatchMeasurementUnitV2;
+    }>;
+};
+type Match = {
+    /**
+     * Code of the currency in which the prices should be matched, as defined in the Currency Service.
+     *
+     * **Note**: If the matched price is defined in another currency, a currency exchange algorithm will be used, but only if exchange rates between the two currencies have been defined.
+     */
+    targetCurrency: string;
+    /**
+     * Code of the site to which the matched prices should apply.
+     */
+    siteCode: string;
+    targetLocation: {
+        /**
+         * Code of the country for which the prices should be matched, as defined in the Country Service.
+         *
+         * **Note**: If the matched price is defined for another country, a tax calculation algorithm will be used, but only if tax classes for the two countries have been defined for relevant products.
+         */
+        countryCode: string;
+    };
+    /**
+     * List of items (products or prices) for which the prices should be matched.
+     */
+    items: Array<{
+        /**
+         * Product or price for which a price should be matched.
+         */
+        itemId?: {
+            /**
+             * Type of the referenced item. Possible values:
+             * * `PRODUCT`
+             * * `PRICE`
+             * * `SKU`
+             *
+             * **Note**: The `SKU` value is a `preview` value - the system does not fully operate on the SKU concept yet.
+             */
+            itemType: string;
+            /**
+             * Item's unique identifier, generated when the item is created.
+             */
+            id: string;
+        };
+        /**
+         * Quantity of the product for which a matched price should be calculated.
+         */
+        quantity: {
+            /**
+             * Quantity of the product, expressed as a number.
+             */
+            quantity: number;
+            /**
+             * Code of the measurement unit, as defined in the Unit Handling Service. This atribute is optional, if not provided the price model unit will be used.
+             */
+            unitCode?: string;
+        };
+    }>;
+    /**
+     * Customer or customer group for whom the matched prices should be valid.
+     */
+    principal?: {
+        /**
+         * Unique identifier of the customer or customer group.
+         */
+        id?: string;
+        /**
+         * Customer or customer group for whom the matched should be valid. Possible values:
+         * * `CUSTOMER`
+         * * `GROUP`
+         *
+         * **Note**: The `GROUP` value is a `preview` value - the system does not fully operate on the customer groups concept yet.
+         */
+        type?: string;
+    };
+    /**
+     * If no price that matches the criteria is found for the specified site, the price matching functionality will try to find the best price for the `main` site. To enable this option, this field needs to be set to `true`.
+     *
+     * **Note**: Using the fallback mechanism may impact the performance as the price matching has to run a second time. If the fallback mechanism is used, the response's `siteCode` field will be set to `main`.
+     */
+    useFallback?: boolean;
+    /**
+     * Legal entity for which price lists are included in the price match.
+     * **Note**: Price lists for the entity's parent legal entities are also included.
+     */
+    legalEntityId?: string;
+};
+/**
+ * Price model holds additional attributes that are extending price. For example it's possible to define a price which will be specific for a given customer or customer group.
+ *
+ */
+type PriceModelRetrieval = {
+    /**
+     * Price model's unique identifier, generated when the price model is created.
+     *
+     */
+    id?: string;
+    name?: {
+        [key: string]: unknown;
+    } | string;
+    description?: {
+        [key: string]: unknown;
+    } | string;
+    /**
+     * Flag indicating whether prices assigned to the price model are expressed as net or gross.
+     *
+     * | Value | Description |
+     * | --- | --- |
+     * | `true` | Prices are expressed as gross values. |
+     * | `false` | Prices are expressed as net values. |
+     *
+     */
+    includesTax?: boolean;
+    /**
+     * Flag indicating whether prices assigned to the price model include markup.
+     *
+     * **Note**: This is a **preview** field.
+     *
+     */
+    includesMarkup?: boolean;
+    measurementUnit?: MeasurementUnitV2;
+    tierDefinition?: {
+        /**
+         * If the price is created based on a price model (the `priceModelId` is provided, the field should stay null. Otherwise the provided value will override a value from price model.
+         *
+         * Possible values:
+         * * `BASIC`
+         * * `VOLUME`
+         * * `TIERED`
+         *
+         * `BASIC`: Used to offer the same price per unit, regardless of the ordered quantity.
+         *
+         * **Note**: When using basic pricing, you need to define a single tier and set its `minQuantity` field to `0`.
+         *
+         * `VOLUME`: Used to offer a lower price per unit depending on the total ordered quantity.
+         *
+         * `TIERED`: Used to offer a lower price per unit based on the tiers that the total ordered quantity falls into.
+         *
+         * **Example**: You defined three tiers, starting at 5, 10, and 15 pieces respectively. A customer orders 16 pieces. In this pricing model, the first 5 pieces will be priced according to the first tier, the next 5 according to the second tier, and the 16th piece will be priced according to the third tier.
+         */
+        tierType?: string;
+        tiers?: Array<{
+            minQuantity?: MeasurementUnit;
+            /**
+             * Identifier of a given tier.
+             */
+            id?: string;
+        }>;
+    };
+    /**
+     * Indicates if the price model is a default price model.
+     */
+    isDefault?: boolean;
+    metadata?: Metadata;
+};
+type MatchResponse = {
+    /**
+     * Price's unique identifier, generated when the price is created.
+     *
+     */
+    priceId?: string;
+    /**
+     * Price list's unique identifier. The property is populated only in case when the return price belongs to any price list.
+     *
+     */
+    priceListId?: string;
+    /**
+     * Item (product or price) for which the price was matched.
+     */
+    itemRef?: {
+        /**
+         * Type of the retrieved item. Possible values:
+         * * `PRODUCT`
+         * * `SKU`
+         *
+         * **Note**: The `SKU` value is a `preview` value - the system does not fully operate on the SKU concept yet.
+         */
+        itemType?: string;
+        /**
+         * Item's unique identifier, generated when the item is created.
+         *
+         */
+        id?: string;
+    };
+    /**
+     * Site to which the matched price applies.
+     */
+    site?: {
+        /**
+         * Code of the site to which the matched price applies.
+         */
+        code?: string;
+        /**
+         * Flag indicating whether prices assigned to the site are expressed as net or gross.
+         *
+         * | Value | Description |
+         * | --- | --- |
+         * | `true` | Prices are expressed as gross values. |
+         * | `false` | Prices are expressed as net values. |
+         *
+         * **Note**: If not specified, the retrieved price is net or gross depending on the `includesTax` field in the price's model.
+         */
+        includesTax?: boolean;
+    };
+    /**
+     * Currency related to the price.
+     */
+    currency?: string;
+    /**
+     * Location for which the matched price is defined.
+     */
+    location?: {
+        /**
+         * Code of the country to which the matched price applies.
+         */
+        countryCode?: string;
+    };
+    /**
+     * Represents an original value without any discounts for a single unit of the requested item (PRODUCT or SKU). The value is a gross price (if includesTax is true) or net price (if includesTax is false).
+     *
+     * It's worth to mention that the cent part is not limited just to two digits. For example, if the price is for one piece of screw, it could look like this: 0.0000317
+     */
+    originalValue?: number;
+    /**
+     * Represents a value with a discount (if applicable) for a single unit of the requested item (PRODUCT or SKU). The value is a gross price (if includesTax is true) or net price (if includesTax is false).
+     *
+     * It's worth to mention that the cent part is not limited just to two digits. For example, if the price is for one piece of screw, it could look like this: 0.0000317
+     */
+    effectiveValue?: number;
+    /**
+     * Represents a total value with a discount (if applicable) for all units of the requested item (PRODUCT or SKU). The value is a gross price (if includesTax is true) or net price (if includesTax is false).
+     *
+     * It's worth to mention that the cent part is not limited just to two digits. For example, if the price is for one piece of screw, it could look like this: 0.0000317
+     */
+    totalValue?: number;
+    quantity?: MeasurementUnitV2;
+    salePrice?: SalePrice;
+    /**
+     * Flag indicating whether prices assigned to the price model are expressed as net or gross.
+     *
+     * | Value | Description |
+     * | --- | --- |
+     * | `true` | Prices are expressed as gross values. |
+     * | `false` | Prices are expressed as net values. |
+     */
+    includesTax?: boolean;
+    priceModel?: PriceModelRetrieval;
+    /**
+     * Sales tax applicable to the product.
+     */
+    tax?: {
+        /**
+         * Tax class's code, as defined in the Tax Service.
+         *
+         */
+        taxClass?: string;
+        /**
+         * Tax rate expressed as a number.
+         */
+        taxRate?: number;
+        /**
+         * Tax details containing all prices with tax.
+         */
+        prices?: {
+            /**
+             * Original price with taxes.
+             */
+            originalValue?: {
+                netValue?: number;
+                grossValue?: number;
+                taxValue?: number;
+            };
+            /**
+             * Effective price with taxes.
+             */
+            effectiveValue?: {
+                netValue?: number;
+                grossValue?: number;
+                taxValue?: number;
+            };
+            /**
+             * Total price with taxes.
+             */
+            totalValue?: {
+                netValue?: number;
+                grossValue?: number;
+                taxValue?: number;
+            };
+        };
+    };
+    /**
+     * Custom price attributes.
+     */
+    mixins?: {
+        [key: string]: unknown;
+    };
+    metadata?: {
+        /**
+         * Version of the price object.
+         */
+        version?: string;
+        /**
+         * Date and time when the matched price was created.
+         */
+        createdAt?: string;
+        /**
+         * Date and time when the matched price was last modified.
+         */
+        modifiedAt?: string;
+    };
+    /**
+     * A price tiers values for a matched price
+     */
+    tierValues?: Array<{
+        /**
+         * Identifier of a tier
+         */
+        id?: string;
+        /**
+         * A price value for a particular tier
+         */
+        priceValue?: number;
+    }>;
+};
+
+/** Session-context match request body (generated). */
+type PriceMatchByContextInput = MatchByContext;
+/** Explicit-context match request body (generated). */
+type PriceMatchInput = Match;
+/** A resolved price (full generated match-response schema). */
+type PriceMatch = MatchResponse;
+/**
+ * Price matching. The Cart service does not resolve prices — call this
+ * explicitly before rendering money and again right before placing an order.
+ * The SDK is stateless: it never caches or revalidates prices.
+ */
+declare class PriceService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    /**
+     * Resolves prices using the session context bound to the bearer token
+     * (currency/site/country were set at anonymous-login time). Default auth:
+     * anonymous; pass a customer/raw context for personalized pricing.
+     */
+    matchByContext(input: PriceMatchByContextInput, auth?: AuthContext): Promise<PriceMatch[]>;
+    /**
+     * Resolves prices from an explicit context. Default auth: service
+     * (requires `price.price_read` / `price.price_manage`).
+     */
+    match(input: PriceMatchInput, auth?: AuthContext): Promise<PriceMatch[]>;
+}
+
+export { type PriceMatch, type PriceMatchByContextInput, type PriceMatchInput, PriceService };