@viu/emporix-sdk 1.0.0

package/dist/cart.js

@@ -0,0 +1,4 @@
+export { CartService } from './chunk-IEZHGU7F.js';
+import './chunk-KTODT6DV.js';
+//# sourceMappingURL=cart.js.map
+//# sourceMappingURL=cart.js.map

package/dist/cart.js.map

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

package/dist/category.cjs

@@ -0,0 +1,97 @@
+'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/category.ts
+var ANON = { kind: "anonymous" };
+var CategoryService = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  ctx;
+  /** Fetches one category by id. */
+  async get(categoryId, auth = ANON) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `/category/${this.ctx.tenant}/categories/${categoryId}`,
+      auth
+    });
+  }
+  /** One page of categories. */
+  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: `/category/${this.ctx.tenant}/categories`,
+      query: { pageNumber, pageSize },
+      auth
+    });
+    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };
+  }
+  /** Async-iterates every category across pages. */
+  listAll(params = {}, auth = ANON) {
+    const pageSize = params.pageSize ?? 50;
+    return iterateAll((pageNumber) => this.list({ pageNumber, pageSize }, auth));
+  }
+  /** Fetches the category tree, optionally rooted at `rootId`. */
+  async tree(rootId, auth = ANON) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `/category/${this.ctx.tenant}/categories/tree`,
+      query: rootId ? { rootId } : {},
+      auth
+    });
+  }
+  /** One page of products in a category. */
+  async productsIn(categoryId, params = {}, auth = ANON) {
+    const pageNumber = params.pageNumber ?? 1;
+    const pageSize = params.pageSize ?? 50;
+    const items = await this.ctx.http.request({
+      method: "GET",
+      path: `/category/${this.ctx.tenant}/categories/${categoryId}/products`,
+      query: { pageNumber, pageSize },
+      auth
+    });
+    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };
+  }
+  /**
+   * Bulk fetch by id. POSTs `/categories/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: `/category/${this.ctx.tenant}/categories/search`,
+          query: { pageSize: chunk.length },
+          auth,
+          body: { q: `id:(${chunk.join(",")})` }
+        })
+      )
+    );
+    return pages.flat();
+  }
+};
+
+exports.CategoryService = CategoryService;
+//# sourceMappingURL=category.cjs.map
+//# sourceMappingURL=category.cjs.map

package/dist/category.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/context.ts","../src/services/category.ts"],"names":[],"mappings":"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","file":"category.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 { Product } from \"./product\";\nimport type { Category as GeneratedCategory, CategoryTree } from \"../generated/category\";\n\nconst ANON: AuthContext = { kind: \"anonymous\" };\n\n/** A category as returned by the Category service (all generated fields). */\nexport type Category = GeneratedCategory;\n\n/** The category tree as returned by the Category service. */\nexport type CategoryNode = CategoryTree;\n\n/** Category reads. Default auth: anonymous. */\nexport class CategoryService {\n  constructor(private readonly ctx: ClientContext) {}\n\n  /** Fetches one category by id. */\n  async get(categoryId: string, auth: AuthContext = ANON): Promise<Category> {\n    return this.ctx.http.request<Category>({\n      method: \"GET\",\n      path: `/category/${this.ctx.tenant}/categories/${categoryId}`,\n      auth,\n    });\n  }\n\n  /** One page of categories. */\n  async list(\n    params: { pageNumber?: number; pageSize?: number } = {},\n    auth: AuthContext = ANON,\n  ): Promise<PaginatedItems<Category>> {\n    const pageNumber = params.pageNumber ?? 1;\n    const pageSize = params.pageSize ?? 50;\n    const items = await this.ctx.http.request<Category[]>({\n      method: \"GET\",\n      path: `/category/${this.ctx.tenant}/categories`,\n      query: { pageNumber, pageSize },\n      auth,\n    });\n    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };\n  }\n\n  /** Async-iterates every category across pages. */\n  listAll(params: { pageSize?: number } = {}, auth: AuthContext = ANON): AsyncIterable<Category> {\n    const pageSize = params.pageSize ?? 50;\n    return iterateAll<Category>((pageNumber) => this.list({ pageNumber, pageSize }, auth));\n  }\n\n  /** Fetches the category tree, optionally rooted at `rootId`. */\n  async tree(rootId?: string, auth: AuthContext = ANON): Promise<CategoryNode> {\n    return this.ctx.http.request<CategoryNode>({\n      method: \"GET\",\n      path: `/category/${this.ctx.tenant}/categories/tree`,\n      query: rootId ? { rootId } : {},\n      auth,\n    });\n  }\n\n  /** One page of products in a category. */\n  async productsIn(\n    categoryId: 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: `/category/${this.ctx.tenant}/categories/${categoryId}/products`,\n      query: { pageNumber, pageSize },\n      auth,\n    });\n    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };\n  }\n\n  /**\n   * Bulk fetch by id. POSTs `/categories/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<Category[]> {\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<Category[]>({\n          method: \"POST\",\n          path: `/category/${this.ctx.tenant}/categories/search`,\n          query: { pageSize: chunk.length },\n          auth,\n          body: { q: `id:(${chunk.join(\",\")})` },\n        }),\n      ),\n    );\n    return pages.flat();\n  }\n}\n"]}

package/dist/category.d.cts

@@ -0,0 +1,313 @@
+import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-vKgzZ-5f.cjs';
+import { Product } from './product.cjs';
+
+/**
+ * Classification mixin defined for a given category.
+ */
+type OwnClassificationMixin = {
+    /**
+     * Name of the mixin.
+     */
+    name: string;
+    /**
+     * URL of the mixin schema.
+     */
+    schemaUrl: string;
+    /**
+     * Indicates whether the mixin is required.
+     */
+    required?: boolean;
+};
+/**
+ * Classification mixin with source category information.
+ */
+type ClassificationMixin = {
+    /**
+     * Name of the mixin
+     */
+    name: string;
+    /**
+     * The mixins path that should be used when defining attributes on a product. It's built based on the following pattern - `class_<sourceCategory.code>_<name>`.
+     */
+    mixinPath?: string;
+    /**
+     * URL of the mixin schema.
+     */
+    schemaUrl: string;
+    /**
+     * Indicates whether the mixin is required.
+     */
+    required?: boolean;
+    /**
+     * Unique identifier of the category from which the mixin comes from. Can be this category ID or one of the parent categories IDs.
+     */
+    sourceCategoryId?: string;
+};
+/**
+ * Definition of category
+ */
+type Category$1 = {
+    /**
+     * Category unique identifier generated when the category is created.
+     */
+    id: string;
+    /**
+     * Unique identifier of the parent category. No parentId in the body indicates that this is a root category.
+     */
+    parentId?: string | null;
+    /**
+     * Localized category name as a map of translations.
+     */
+    localizedName: {
+        [key: string]: string;
+    };
+    /**
+     * Localized category description as a map of translations.
+     */
+    localizedDescription?: {
+        [key: string]: string;
+    };
+    /**
+     * Provides localized category name or code without diacritics for the URL.
+     */
+    localizedSlug?: {
+        [key: string]: string;
+    };
+    /**
+     * Category name in tenant default language.
+     * @deprecated
+     */
+    name?: string;
+    /**
+     * Description in tenant default language.
+     * @deprecated
+     */
+    description?: string;
+    /**
+     * Unique category identifier defined by the tenant.
+     */
+    code?: string;
+    /**
+     * List of external category numbers (ECNs) unique for each category.
+     */
+    ecn?: Array<string>;
+    validity?: Validity;
+    /**
+     * Category position relative to sibling categories.
+     */
+    position: number;
+    /**
+     * Flag indicating whether the category has been published.
+     */
+    published: boolean;
+    /**
+     * IDs of supercategories.
+     */
+    supercategoriesIds?: Array<string>;
+    /**
+     * List of classification mixins defined for this category.
+     */
+    ownClassificationMixins?: Array<OwnClassificationMixin>;
+    /**
+     * Combined list of classification mixins from parent categories and category's ownClassification mixins.
+     */
+    classificationMixins?: Array<ClassificationMixin>;
+    /**
+     * Custom category attributes included directly in the mixins object.
+     */
+    mixins?: {
+        [key: string]: unknown;
+    };
+    metadata: MetadataResponse;
+    media: Array<Media>;
+};
+/**
+ * Definition of category tree
+ */
+type CategoryTree = {
+    /**
+     * Category unique identifier generated when the category is created.
+     */
+    id: string;
+    /**
+     * Category name in tenant default language.
+     * @deprecated
+     */
+    name: string;
+    /**
+     * Description in tenant default language.
+     * @deprecated
+     */
+    description?: string;
+    /**
+     * Unique category identifier defined by the tenant.
+     * @deprecated
+     */
+    code?: string;
+    /**
+     * Localized category name as a map of translations.
+     */
+    localizedName: {
+        [key: string]: string;
+    };
+    /**
+     * Localized category description as a map of translations.
+     */
+    localizedDescription?: {
+        [key: string]: string;
+    };
+    /**
+     * Provides localized category name or code without diacritics for the URL.
+     */
+    localizedSlug?: {
+        [key: string]: string;
+    };
+    validity?: Validity;
+    /**
+     * Category position in relation to sibling categories.
+     */
+    position: number;
+    /**
+     * Flag indicating whether the category has been published.
+     */
+    published: boolean;
+    /**
+     * List of external category numbers (ECNs) unique for each category.
+     */
+    ecn?: Array<string>;
+    /**
+     * Subcategories of this category.
+     */
+    subcategories?: Array<CategoryTree>;
+};
+type Media = {
+    /**
+     * Unique identifier of media.
+     */
+    id?: string;
+    /**
+     * Url of the file.
+     */
+    url?: string;
+    /**
+     * Content type of the file.
+     */
+    contentType?: string;
+    metadata?: MediaMetadataQueryDocument & unknown;
+    customAttributes?: MediaCustomAttributesQueryDocument & unknown;
+};
+/**
+ * Custom attributes of the file.
+ */
+type MediaCustomAttributesQueryDocument = {
+    /**
+     * Unique identifier of media's custom attributes.
+     */
+    id?: string;
+    /**
+     * Height of the media image.
+     */
+    height?: number;
+    /**
+     * Width of the media image.
+     */
+    width?: number;
+    /**
+     * Size in kilobytes of the file.
+     */
+    sizeKB?: number;
+    /**
+     * Mime type of the file.
+     */
+    type?: string;
+    /**
+     * Name of the file.
+     */
+    name?: string;
+};
+/**
+ * Metadata of the file.
+ */
+type MediaMetadataQueryDocument = {
+    /**
+     * Timestamp indicating when the media was created compliant with the ISO 8601 standard.
+     */
+    createdAt?: string;
+    /**
+     * Timestamp indicating when the media was modified compliant with the ISO 8601 standard.
+     */
+    modifiedAt?: string;
+};
+type MetadataCreate = {
+    /**
+     * A key-value map, where key is a mixin name and value is a link to the mixin schema.
+     */
+    mixins?: {
+        [key: string]: string;
+    };
+};
+type MetadataUpdate = {
+    /**
+     * Category version.
+     */
+    version?: number;
+} & MetadataCreate;
+type MetadataResponse = {
+    /**
+     * Timestamp indicating when the category was created compliant with the ISO 8601 standard.
+     */
+    createdAt?: string;
+    /**
+     * Timestamp indicating when the category was last modified compliant with the ISO 8601 standard.
+     */
+    modifiedAt?: string;
+} & MetadataUpdate;
+type Validity = {
+    /**
+     * Date and time from which the category is valid compliant with the ISO 8601 standard.
+     */
+    from?: string;
+    /**
+     * Date and time to which the category is valid compliant with the ISO 8601 standard.
+     */
+    to?: string;
+};
+
+/** A category as returned by the Category service (all generated fields). */
+type Category = Category$1;
+/** The category tree as returned by the Category service. */
+type CategoryNode = CategoryTree;
+/** Category reads. Default auth: anonymous. */
+declare class CategoryService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    /** Fetches one category by id. */
+    get(categoryId: string, auth?: AuthContext): Promise<Category>;
+    /** One page of categories. */
+    list(params?: {
+        pageNumber?: number;
+        pageSize?: number;
+    }, auth?: AuthContext): Promise<PaginatedItems<Category>>;
+    /** Async-iterates every category across pages. */
+    listAll(params?: {
+        pageSize?: number;
+    }, auth?: AuthContext): AsyncIterable<Category>;
+    /** Fetches the category tree, optionally rooted at `rootId`. */
+    tree(rootId?: string, auth?: AuthContext): Promise<CategoryNode>;
+    /** One page of products in a category. */
+    productsIn(categoryId: string, params?: {
+        pageNumber?: number;
+        pageSize?: number;
+    }, auth?: AuthContext): Promise<PaginatedItems<Product>>;
+    /**
+     * Bulk fetch by id. POSTs `/categories/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.
+     */
+    searchByIds(ids: string[], options?: {
+        chunkSize?: number;
+    }, auth?: AuthContext): Promise<Category[]>;
+}
+
+export { type Category, type CategoryNode, CategoryService };