@viu/emporix-sdk 1.0.0

package/dist/price.d.ts

@@ -0,0 +1,445 @@
+import { C as ClientContext, b as AuthContext } from './context-vKgzZ-5f.js';
+
+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 };

package/dist/price.js

@@ -0,0 +1,4 @@
+export { PriceService } from './chunk-HEO34WLO.js';
+import './chunk-KTODT6DV.js';
+//# sourceMappingURL=price.js.map
+//# sourceMappingURL=price.js.map

package/dist/price.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"price.js"}

package/dist/product.cjs

@@ -0,0 +1,100 @@
+'use strict';
+
+// src/core/context.ts
+async function* iterateAll(fetchPage, start = 1) {
+  let p = start;
+  for (; ; ) {
+    const page = await fetchPage(p);
+    for (const it of page.items) yield it;
+    if (!page.hasNextPage) return;
+    p += 1;
+  }
+}
+
+// src/services/product.ts
+var ANON = { kind: "anonymous" };
+var ProductService = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  ctx;
+  /** Fetches one product by id. */
+  async get(productId, _opts, auth = ANON) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `/product/${this.ctx.tenant}/products/${productId}`,
+      auth
+    });
+  }
+  /** Fetches one product by its code. */
+  async getByCode(code, auth = ANON) {
+    const rows = await this.ctx.http.request({
+      method: "GET",
+      path: `/product/${this.ctx.tenant}/products`,
+      query: { q: `code:${code}` },
+      auth
+    });
+    const first = rows[0];
+    if (!first) throw new Error(`No product with code "${code}"`);
+    return first;
+  }
+  /** One page of products. */
+  async list(params = {}, auth = ANON) {
+    const pageNumber = params.pageNumber ?? 1;
+    const pageSize = params.pageSize ?? 50;
+    const items = await this.ctx.http.request({
+      method: "GET",
+      path: `/product/${this.ctx.tenant}/products`,
+      query: { pageNumber, pageSize },
+      auth
+    });
+    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };
+  }
+  /** Async-iterates every product across pages. */
+  listAll(params = {}, auth = ANON) {
+    const pageSize = params.pageSize ?? 50;
+    return iterateAll((pageNumber) => this.list({ pageNumber, pageSize }, auth));
+  }
+  /** Searches products by free-text query. */
+  async search(query, params = {}, auth = ANON) {
+    const pageNumber = params.pageNumber ?? 1;
+    const pageSize = params.pageSize ?? 50;
+    const items = await this.ctx.http.request({
+      method: "GET",
+      path: `/product/${this.ctx.tenant}/products`,
+      query: { q: query, pageNumber, pageSize },
+      auth
+    });
+    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };
+  }
+  /**
+   * Bulk fetch by id. POSTs `/products/search` with `q="id:(id1,id2,…)"`,
+   * chunking when the list is larger than `options.chunkSize` (default
+   * 100). An empty list short-circuits with no HTTP call. **Order is not
+   * guaranteed** across chunks — re-index by `id` if order matters.
+   */
+  async searchByIds(ids, options = {}, auth = ANON) {
+    if (ids.length === 0) return [];
+    const chunkSize = options.chunkSize ?? 100;
+    const chunks = [];
+    for (let i = 0; i < ids.length; i += chunkSize) {
+      chunks.push(ids.slice(i, i + chunkSize));
+    }
+    const pages = await Promise.all(
+      chunks.map(
+        (chunk) => this.ctx.http.request({
+          method: "POST",
+          path: `/product/${this.ctx.tenant}/products/search`,
+          query: { pageSize: chunk.length },
+          auth,
+          body: { q: `id:(${chunk.join(",")})` }
+        })
+      )
+    );
+    return pages.flat();
+  }
+};
+
+exports.ProductService = ProductService;
+//# sourceMappingURL=product.cjs.map
+//# sourceMappingURL=product.cjs.map

package/dist/product.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/context.ts","../src/services/product.ts"],"names":[],"mappings":"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","file":"product.cjs","sourcesContent":["import type { HttpClient } from \"./http\";\nimport type { TokenProvider, AuthContext } from \"./auth\";\nimport type { Logger } from \"./logger\";\n\n/** Shared dependencies every service facade receives. */\nexport interface ClientContext {\n  tenant: string;\n  http: HttpClient;\n  tokenProvider: TokenProvider;\n  logger: Logger;\n}\n\n/**\n * A cursor-paged collection — `pageNumber`/`pageSize` indexing with a\n * `hasNextPage` signal driven by the source page being full. Used by all\n * paginated services and hooks across the SDK.\n */\nexport interface PaginatedItems<T> {\n  items: T[];\n  pageNumber: number;\n  pageSize: number;\n  hasNextPage: boolean;\n}\n\n/** Default `AuthContext` applied by a service when the caller passes none. */\nexport type DefaultAuth = AuthContext | undefined;\n\n/**\n * Async-iterates every item across pages of a `PaginatedItems<T>` source.\n * Stops when the source reports `hasNextPage: false`.\n *\n * @param fetchPage - given a 1-based page number, returns the page.\n * @param start - first page to fetch (default `1`).\n */\nexport async function* iterateAll<T>(\n  fetchPage: (pageNumber: number) => Promise<PaginatedItems<T>>,\n  start = 1,\n): AsyncIterable<T> {\n  let p = start;\n  for (;;) {\n    const page = await fetchPage(p);\n    for (const it of page.items) yield it;\n    if (!page.hasNextPage) return;\n    p += 1;\n  }\n}\n\n","import type { ClientContext, PaginatedItems } from \"../core/context\";\nimport { iterateAll } from \"../core/context\";\nimport type { AuthContext } from \"../core/auth\";\nimport type {\n  BasicProductWithId,\n  BundleProductWithId,\n  ParentVariantProductWithId,\n  ProductMedia,\n} from \"../generated/product\";\n\nconst ANON: AuthContext = { kind: \"anonymous\" };\n\n/** A product as returned by the Product service (all generated fields). */\nexport type Product = BasicProductWithId | BundleProductWithId | ParentVariantProductWithId;\n\n/** A single product media entry (generated; `ProductMedia` is the list type). */\nexport type Media = ProductMedia[number];\n\n/** Catalog reads. Default auth: anonymous; pass customer for personalized pricing. */\nexport class ProductService {\n  constructor(private readonly ctx: ClientContext) {}\n\n  /** Fetches one product by id. */\n  async get(\n    productId: string,\n    _opts?: Record<string, never>,\n    auth: AuthContext = ANON,\n  ): Promise<Product> {\n    return this.ctx.http.request<Product>({\n      method: \"GET\",\n      path: `/product/${this.ctx.tenant}/products/${productId}`,\n      auth,\n    });\n  }\n\n  /** Fetches one product by its code. */\n  async getByCode(code: string, auth: AuthContext = ANON): Promise<Product> {\n    const rows = await this.ctx.http.request<Product[]>({\n      method: \"GET\",\n      path: `/product/${this.ctx.tenant}/products`,\n      query: { q: `code:${code}` },\n      auth,\n    });\n    const first = rows[0];\n    if (!first) throw new Error(`No product with code \"${code}\"`);\n    return first;\n  }\n\n  /** One page of products. */\n  async list(\n    params: { pageNumber?: number; pageSize?: number } = {},\n    auth: AuthContext = ANON,\n  ): Promise<PaginatedItems<Product>> {\n    const pageNumber = params.pageNumber ?? 1;\n    const pageSize = params.pageSize ?? 50;\n    const items = await this.ctx.http.request<Product[]>({\n      method: \"GET\",\n      path: `/product/${this.ctx.tenant}/products`,\n      query: { pageNumber, pageSize },\n      auth,\n    });\n    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };\n  }\n\n  /** Async-iterates every product across pages. */\n  listAll(params: { pageSize?: number } = {}, auth: AuthContext = ANON): AsyncIterable<Product> {\n    const pageSize = params.pageSize ?? 50;\n    return iterateAll<Product>((pageNumber) => this.list({ pageNumber, pageSize }, auth));\n  }\n\n  /** Searches products by free-text query. */\n  async search(\n    query: string,\n    params: { pageNumber?: number; pageSize?: number } = {},\n    auth: AuthContext = ANON,\n  ): Promise<PaginatedItems<Product>> {\n    const pageNumber = params.pageNumber ?? 1;\n    const pageSize = params.pageSize ?? 50;\n    const items = await this.ctx.http.request<Product[]>({\n      method: \"GET\",\n      path: `/product/${this.ctx.tenant}/products`,\n      query: { q: query, pageNumber, pageSize },\n      auth,\n    });\n    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };\n  }\n\n  /**\n   * Bulk fetch by id. POSTs `/products/search` with `q=\"id:(id1,id2,…)\"`,\n   * chunking when the list is larger than `options.chunkSize` (default\n   * 100). An empty list short-circuits with no HTTP call. **Order is not\n   * guaranteed** across chunks — re-index by `id` if order matters.\n   */\n  async searchByIds(\n    ids: string[],\n    options: { chunkSize?: number } = {},\n    auth: AuthContext = ANON,\n  ): Promise<Product[]> {\n    if (ids.length === 0) return [];\n    const chunkSize = options.chunkSize ?? 100;\n    const chunks: string[][] = [];\n    for (let i = 0; i < ids.length; i += chunkSize) {\n      chunks.push(ids.slice(i, i + chunkSize));\n    }\n    const pages = await Promise.all(\n      chunks.map((chunk) =>\n        this.ctx.http.request<Product[]>({\n          method: \"POST\",\n          path: `/product/${this.ctx.tenant}/products/search`,\n          query: { pageSize: chunk.length },\n          auth,\n          body: { q: `id:(${chunk.join(\",\")})` },\n        }),\n      ),\n    );\n    return pages.flat();\n  }\n\n}\n"]}