@viu/emporix-sdk 1.0.0

package/dist/product.d.ts

@@ -0,0 +1,400 @@
+import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-vKgzZ-5f.js';
+
+/**
+ * Localized value which can have different structure which depends on provided `Content-Language` header.
+ */
+type LocalizedValue = string | {
+    [key: string]: string;
+};
+/**
+ * Indicates the product type, which is immutable. Once the product type is set, it cannot be updated.
+ *
+ */
+type ProductType = 'BASIC' | 'BUNDLE' | 'PARENT_VARIANT' | 'VARIANT' | 'DYNAMIC_VARIANT';
+/**
+ * Indicates the product type, which is immutable. This property is taken into account only for insert operations.
+ *
+ */
+type ProductTypeUpdate = 'BASIC' | 'BUNDLE' | 'PARENT_VARIANT' | 'VARIANT' | 'DYNAMIC_VARIANT';
+/**
+ * Indicates the template that has been used during the product creation. After assigning a template to the product, the new attributes can be defined under the `productTemplateAttributes` key in the `mixins` field. In case of variant attributes, the attributes should be defined under `productVariantAttributes`. The attributes are then validated in accordance with their definition in the template.
+ *
+ * **Note:** The template with defined variant attributes can be used only in PARENT_VARIANT and VARIANT types of product.
+ *
+ */
+type Template = {
+    /**
+     * Identifier of the product template.
+     */
+    id: string;
+    /**
+     * Product template version.
+     */
+    version: string;
+};
+/**
+ * List of bundled products
+ */
+type BundledProducts = Array<{
+    /**
+     * Identifier of the bundled product.
+     */
+    productId: string;
+    /**
+     * Amount of bundled products. Must be a positive number.
+     */
+    amount: number;
+}>;
+type Value = {
+    key?: string | number | boolean;
+};
+type Values = Array<Value>;
+/**
+ * This field contains all information about attributes and their values that are used for creating variants. It is presented in the form of a map, where 'key' is the name of the attribute and 'value' is the list of values of that attribute. The attributes and their values are based on their definitions in the `template` element assigned to the parent variant. Each attribute defined in the product template is flagged as a `variantAttribute`. Only the attributes that have this flag set as `true` can be used in the `variantAttributes` field.
+ */
+type VariantAttributes = {
+    [key: string]: Values;
+};
+/**
+ * In YaaS, a global resource identifier is a Uniform Resource Name (URN) with a custom YaaS schema and is called a YaaS Resource Name, or YRN.
+ *
+ * It is a unique identifier, which stores information about a resource, such as its type, ID or name of the tenant.
+ */
+type Yrn = string;
+/**
+ * Map of key-value pairs that associates tax classes with locations (countries). The key of the map should be specified as the existing location/country identifier (see the country-service). The value of the map entry should contain a tax class code (see the tax-service).
+ * Information about the association is required for price matching mechanism (see the price-service#MatchPrice).
+ */
+type TaxClasses = {
+    [key: string]: string;
+};
+/**
+ * Flag indicating whether the product has been published or not.
+ */
+type Published = boolean;
+/**
+ * Mixins request.
+ */
+type ProductMixins = {
+    [key: string]: unknown;
+};
+/**
+ * Metadata request.
+ */
+type ProductMetadataCore = {
+    /**
+     * Links to the mixin schemas.
+     */
+    mixins?: {
+        [key: string]: unknown;
+    };
+};
+/**
+ * Metadata with the version information.
+ */
+type ProductMetadataWithVersion = ProductMetadataCore & {
+    /**
+     * Version of the document
+     */
+    version?: number;
+};
+/**
+ * Metadata for GET requests.
+ */
+type ProductMetadataGet = ProductMetadataWithVersion & {
+    /**
+     * List of mixin schemas used for classification.
+     */
+    classificationMixins?: Array<{
+        /**
+         * 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 defined on the category level.
+         */
+        schemaUrl?: string;
+        /**
+         * If given mixin has been already used in the product, then this field contains the URL of the used mixin schema.
+         */
+        usedSchemaUrl?: string;
+        /**
+         * Indicates whether the used mixin schema is obsolete - `usedSchemaUrl` differs from `schemaUrl`.
+         */
+        obsoleteSchemaUrlUsed?: boolean;
+        /**
+         * 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;
+    }>;
+    /**
+     * Creation date in the ISO 8601 standard.
+     */
+    createdAt?: string;
+    /**
+     * Modification date in the ISO 8601 standard.
+     */
+    modifiedAt?: string;
+};
+/**
+ * Unique resource identifier.
+ */
+type Id = string;
+/**
+ * Media files attached to the product.
+ */
+type ProductMedia = Array<{
+    id?: string;
+    yrn?: Yrn;
+    contentType?: string;
+    createdAt?: string;
+    uploadLink?: string;
+    url?: string;
+    cloudinaryUrl?: string;
+    uncommittedMedia?: boolean;
+    tags?: Array<string>;
+    customAttributes?: {
+        [key: string]: unknown;
+    };
+}>;
+type ProductCore = {
+    name?: LocalizedValue;
+    /**
+     * Unique product identifier, defined by the user.
+     */
+    code?: string;
+    description?: LocalizedValue;
+    vendor?: Vendor;
+    taxClasses?: TaxClasses;
+    published?: Published;
+    /**
+     * Mark the product as weight-dependent if the line item price could change after packaging, as this is necessary to ensure that credit card payments can be authorized.
+     */
+    weightDependent?: boolean;
+    mixins?: ProductMixins;
+    /**
+     * List of items in a relationship with the main product. Assuming that in the system the following relation types are defined: `ACCESSORY` and `CONSUMABLE`, the two products: `Printer` and `Ink` exist, then the `Ink` product can be used as a related item with type `CONSUMABLE` for the Printer product.
+     * In order to find all printers for which the ink is defined as a `CONSUMABLE` then `q-param` can be used:
+     * `products?q=relatedItems.type:CONSUMABLE relatedItems.refId:Ink_Id`
+     *
+     */
+    relatedItems?: Array<RelatedItem>;
+    /**
+     * ID of brand.
+     */
+    brandId?: string;
+    brand?: Brand;
+    /**
+     * Collection of label IDs.
+     */
+    labelIds?: Array<string>;
+    labels?: Array<Label>;
+};
+/**
+ * Brand data expanded from `brandId`.
+ */
+type Brand = {
+    id?: string;
+    name?: string;
+    description?: string;
+    localizedName?: {
+        [key: string]: string;
+    };
+    localizedDescription?: {
+        [key: string]: string;
+    };
+    image?: string;
+    cloudinaryUrl?: string;
+    mediaId?: string;
+};
+/**
+ * Overlay metadata for a label.
+ */
+type LabelOverlay = {
+    isTrue?: boolean;
+    position?: number;
+};
+/**
+ * Label data expanded from `labelIds`.
+ */
+type Label = {
+    id?: string;
+    name?: string;
+    description?: LocalizedValue;
+    image?: string;
+    cloudinaryUrl?: string;
+    mediaId?: string;
+    overlay?: LabelOverlay;
+};
+/**
+ * Products of the BASIC type.
+ */
+type BasicProduct = ProductCore & {
+    metadata?: ProductMetadataCore;
+    template?: Template;
+};
+/**
+ * Creating products of the BASIC type.
+ */
+type BasicProductCreation = BasicProduct & {
+    /**
+     * Custom product identifier. If not provided, it is automatically generated.
+     */
+    id?: string;
+    productType?: ProductType;
+};
+/**
+ * Products of the BASIC type.
+ */
+type BasicProductWithId = BasicProductCreation & {
+    id?: Id;
+    yrn?: Yrn;
+    media?: ProductMedia;
+    metadata?: ProductMetadataGet;
+    /**
+     * Customer segment IDs assigned to the product.
+     */
+    customerSegmentIds?: Array<string>;
+    /**
+     * Category IDs assigned to the product.
+     */
+    categoryIds?: Array<string>;
+};
+/**
+ * Products of the BUNDLE type.
+ */
+type BundleProduct = ProductCore & {
+    metadata?: ProductMetadataCore;
+    template?: Template;
+    bundledProducts: BundledProducts;
+    productType: ProductTypeUpdate;
+};
+/**
+ * Creating products of the BUNDLE type.
+ */
+type BundleProductCreation = BundleProduct & {
+    /**
+     * Custom product identifier. If not provided, it is automatically generated.
+     */
+    id?: string;
+    productType?: ProductType;
+};
+/**
+ * Products of the BUNDLE type.
+ */
+type BundleProductWithId = BundleProductCreation & {
+    id?: Id;
+    yrn?: Yrn;
+    media?: ProductMedia;
+    metadata?: ProductMetadataGet;
+    /**
+     * Customer segment IDs assigned to the product.
+     */
+    customerSegmentIds?: Array<string>;
+    /**
+     * Category IDs assigned to the product.
+     */
+    categoryIds?: Array<string>;
+};
+/**
+ * Products of the PARENT_VARIANT type.
+ */
+type ParentVariantProduct = ProductCore & {
+    metadata?: ProductMetadataCore;
+    template: Template;
+    variantAttributes: VariantAttributes;
+};
+/**
+ * Creating products of the PARENT_VARIANT type.
+ */
+type ParentVariantProductCreation = ParentVariantProduct & {
+    /**
+     * Custom product identifier. If not provided, it is automatically generated.
+     */
+    id?: string;
+    productType?: ProductType;
+};
+/**
+ * Products of the PARENT_VARIANT type.
+ */
+type ParentVariantProductWithId = ParentVariantProductCreation & {
+    id?: Id;
+    yrn?: Yrn;
+    media?: ProductMedia;
+    metadata?: ProductMetadataGet;
+    /**
+     * Customer segment IDs assigned to the product.
+     */
+    customerSegmentIds?: Array<string>;
+    /**
+     * Category IDs assigned to the product.
+     */
+    categoryIds?: Array<string>;
+};
+type Vendor = {
+    /**
+     * An identifier of a vendor to whom the product belongs.
+     */
+    id: string;
+    /**
+     * Vendor name.
+     */
+    name?: string;
+};
+type RelatedItem = {
+    /**
+     * Identifier of a product which is in the relationship with the main product. The product identifier has to exist.
+     */
+    refId: string;
+    /**
+     * A relation type. The type has to exist in the system. All relation types are defined in configuration service under `relation_types` key.
+     */
+    type: string;
+};
+
+/** A product as returned by the Product service (all generated fields). */
+type Product = BasicProductWithId | BundleProductWithId | ParentVariantProductWithId;
+/** A single product media entry (generated; `ProductMedia` is the list type). */
+type Media = ProductMedia[number];
+/** Catalog reads. Default auth: anonymous; pass customer for personalized pricing. */
+declare class ProductService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    /** Fetches one product by id. */
+    get(productId: string, _opts?: Record<string, never>, auth?: AuthContext): Promise<Product>;
+    /** Fetches one product by its code. */
+    getByCode(code: string, auth?: AuthContext): Promise<Product>;
+    /** One page of products. */
+    list(params?: {
+        pageNumber?: number;
+        pageSize?: number;
+    }, auth?: AuthContext): Promise<PaginatedItems<Product>>;
+    /** Async-iterates every product across pages. */
+    listAll(params?: {
+        pageSize?: number;
+    }, auth?: AuthContext): AsyncIterable<Product>;
+    /** Searches products by free-text query. */
+    search(query: string, params?: {
+        pageNumber?: number;
+        pageSize?: number;
+    }, auth?: AuthContext): Promise<PaginatedItems<Product>>;
+    /**
+     * 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.
+     */
+    searchByIds(ids: string[], options?: {
+        chunkSize?: number;
+    }, auth?: AuthContext): Promise<Product[]>;
+}
+
+export { type Media, type Product, ProductService };

package/dist/product.js

@@ -0,0 +1,4 @@
+export { ProductService } from './chunk-QDABAMVN.js';
+import './chunk-GWJ2U2CP.js';
+//# sourceMappingURL=product.js.map
+//# sourceMappingURL=product.js.map

package/dist/product.js.map

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

package/dist/segment.cjs

@@ -0,0 +1,189 @@
+'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/core/require-customer.ts
+function requireCustomer(auth) {
+  if (auth && (auth.kind === "customer" || auth.kind === "raw")) return auth;
+  throw new EmporixAuthError("This operation requires a customer or raw AuthContext");
+}
+
+// src/services/segment.ts
+function setIfDefined(q, key, value) {
+  if (value !== void 0 && value !== "") {
+    q[key] = value;
+  }
+}
+var SegmentService = class {
+  constructor(ctx, deps) {
+    this.ctx = ctx;
+    this.deps = deps;
+  }
+  ctx;
+  deps;
+  base() {
+    return `/customer-segment/${this.ctx.tenant}/segments`;
+  }
+  /** Lists segments the caller belongs to (with `segment_read_own`). */
+  async list(query = {}, auth) {
+    const q = {};
+    setIfDefined(q, "q", query.q);
+    setIfDefined(q, "pageNumber", query.pageNumber);
+    setIfDefined(q, "pageSize", query.pageSize);
+    return this.ctx.http.request({
+      method: "GET",
+      path: this.base(),
+      auth: requireCustomer(auth),
+      ...Object.keys(q).length ? { query: q } : {}
+    });
+  }
+  /** Fetches a single segment by id. */
+  async get(segmentId, auth) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/${segmentId}`,
+      auth: requireCustomer(auth)
+    });
+  }
+  /** Item assignments (PRODUCT + CATEGORY) across all the caller's active segments. */
+  async listItems(query = {}, auth) {
+    const q = {};
+    setIfDefined(q, "q", query.q);
+    setIfDefined(q, "siteCode", query.siteCode);
+    setIfDefined(q, "legalEntityId", query.legalEntityId);
+    setIfDefined(q, "pageNumber", query.pageNumber);
+    setIfDefined(q, "pageSize", query.pageSize);
+    if (query.onlyActive !== void 0) q.onlyActive = String(query.onlyActive);
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/items`,
+      auth: requireCustomer(auth),
+      ...Object.keys(q).length ? { query: q } : {}
+    });
+  }
+  /** Item assignments of one specific segment. */
+  async listSegmentItems(segmentId, query = {}, auth) {
+    const q = {};
+    setIfDefined(q, "q", query.q);
+    setIfDefined(q, "legalEntityId", query.legalEntityId);
+    setIfDefined(q, "pageNumber", query.pageNumber);
+    setIfDefined(q, "pageSize", query.pageSize);
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/${segmentId}/items`,
+      auth: requireCustomer(auth),
+      ...Object.keys(q).length ? { query: q } : {}
+    });
+  }
+  /** Category tree built only from the caller's active segments. */
+  async getCategoryTree(query = {}, auth) {
+    const q = {};
+    setIfDefined(q, "siteCode", query.siteCode);
+    setIfDefined(q, "legalEntityId", query.legalEntityId);
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/items/category-trees`,
+      auth: requireCustomer(auth),
+      ...Object.keys(q).length ? { query: q } : {}
+    });
+  }
+  async pickItemIds(kind, query, auth) {
+    const rows = await this.listItems(query, auth);
+    const ids = [];
+    for (const r of rows) {
+      const id = r.item?.id;
+      if (r.type === kind && typeof id === "string") ids.push(id);
+    }
+    return ids;
+  }
+  /** Product ids assigned to the caller's active segments. */
+  async listMyProductIds(query, auth) {
+    return this.pickItemIds("PRODUCT", query ?? {}, auth);
+  }
+  /** Category ids assigned to the caller's active segments. */
+  async listMyCategoryIds(query, auth) {
+    return this.pickItemIds("CATEGORY", query ?? {}, auth);
+  }
+  /**
+   * Hydrates `listMyProductIds` via `ProductService.get` in parallel.
+   * Resolves in the same order as the id list. Any single failure rejects
+   * the whole batch (`Promise.all`); use the id-list method + your own
+   * tolerance strategy if partial success matters.
+   */
+  async listMyProducts(query, auth) {
+    const pageNumber = query?.pageNumber ?? 1;
+    const pageSize = query?.pageSize ?? 20;
+    const sourceItems = await this.listItems(
+      { ...query ?? {}, pageNumber, pageSize },
+      auth
+    );
+    const ids = [];
+    for (const r of sourceItems) {
+      if (r.type === "PRODUCT" && typeof r.item?.id === "string") ids.push(r.item.id);
+    }
+    const items = await this.deps.products.searchByIds(ids, void 0, auth);
+    return { items, pageNumber, pageSize, hasNextPage: sourceItems.length === pageSize };
+  }
+  /**
+   * Hydrates a page of the caller's segment CATEGORY assignments into
+   * real categories via one bulk `categories.searchByIds` call. Same
+   * `hasNextPage` semantic as `listMyProducts`.
+   */
+  async listMyCategories(query, auth) {
+    const pageNumber = query?.pageNumber ?? 1;
+    const pageSize = query?.pageSize ?? 20;
+    const sourceItems = await this.listItems(
+      { ...query ?? {}, pageNumber, pageSize },
+      auth
+    );
+    const ids = [];
+    for (const r of sourceItems) {
+      if (r.type === "CATEGORY" && typeof r.item?.id === "string") ids.push(r.item.id);
+    }
+    const items = await this.deps.categories.searchByIds(ids, void 0, auth);
+    return { items, pageNumber, pageSize, hasNextPage: sourceItems.length === pageSize };
+  }
+};
+
+exports.SegmentService = SegmentService;
+//# sourceMappingURL=segment.cjs.map
+//# sourceMappingURL=segment.cjs.map

package/dist/segment.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/errors.ts","../src/core/require-customer.ts","../src/services/segment.ts"],"names":[],"mappings":"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","file":"segment.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 { AuthContext } from \"./auth\";\nimport { EmporixAuthError } from \"./errors\";\n\n/**\n * Enforces a caller-owned customer or raw token. Throws `EmporixAuthError`\n * for any other `AuthContext` kind (or when `auth` is missing). Shared by\n * services whose endpoints require a customer scope (`/me`, payments,\n * customer-segments…).\n */\nexport function requireCustomer(auth: AuthContext | undefined): AuthContext {\n  if (auth && (auth.kind === \"customer\" || auth.kind === \"raw\")) return auth;\n  throw new EmporixAuthError(\"This operation requires a customer or raw AuthContext\");\n}\n","import type { ClientContext, PaginatedItems } from \"../core/context\";\nimport type { AuthContext } from \"../core/auth\";\nimport { requireCustomer } from \"../core/require-customer\";\nimport type { ProductService } from \"./product\";\nimport type { CategoryService } from \"./category\";\nimport type {\n  SegmentResponse,\n  ItemAssignmentResponse,\n  CategoryTreeResponse,\n} from \"../generated/customer-segment\";\n\n/** Generated segment types (read shapes — storefront `segment_read_own`). */\nexport type Segment = SegmentResponse;\nexport type SegmentItem = ItemAssignmentResponse;\nexport type SegmentCategoryTree = CategoryTreeResponse;\nexport type SegmentCategoryTreeNode = CategoryTreeResponse[number];\n\n/** Cross-service hydrate dependencies, injected from `EmporixClient`. */\nexport interface SegmentServiceDeps {\n  products: ProductService;\n  categories: CategoryService;\n}\n\nfunction setIfDefined<V>(\n  q: Record<string, string | number | undefined>,\n  key: string,\n  value: V | undefined,\n): void {\n  if (value !== undefined && value !== \"\") {\n    q[key] = value as unknown as string | number;\n  }\n}\n\n/**\n * Customer-segment reads. Every method requires a customer/raw\n * `AuthContext` — the `segment_read_own` scope is on the customer token.\n * The standard product/category endpoints do **not** auto-filter by\n * segment; the storefront uses these reads to discover what to fetch.\n */\nexport class SegmentService {\n  constructor(\n    private readonly ctx: ClientContext,\n    private readonly deps: SegmentServiceDeps,\n  ) {}\n\n  private base(): string {\n    return `/customer-segment/${this.ctx.tenant}/segments`;\n  }\n\n  /** Lists segments the caller belongs to (with `segment_read_own`). */\n  async list(\n    query: { q?: string; pageNumber?: number; pageSize?: number } = {},\n    auth?: AuthContext,\n  ): Promise<Segment[]> {\n    const q: Record<string, string | number | undefined> = {};\n    setIfDefined(q, \"q\", query.q);\n    setIfDefined(q, \"pageNumber\", query.pageNumber);\n    setIfDefined(q, \"pageSize\", query.pageSize);\n    return this.ctx.http.request<Segment[]>({\n      method: \"GET\",\n      path: this.base(),\n      auth: requireCustomer(auth),\n      ...(Object.keys(q).length ? { query: q } : {}),\n    });\n  }\n\n  /** Fetches a single segment by id. */\n  async get(segmentId: string, auth?: AuthContext): Promise<Segment> {\n    return this.ctx.http.request<Segment>({\n      method: \"GET\",\n      path: `${this.base()}/${segmentId}`,\n      auth: requireCustomer(auth),\n    });\n  }\n\n  /** Item assignments (PRODUCT + CATEGORY) across all the caller's active segments. */\n  async listItems(\n    query: {\n      q?: string;\n      siteCode?: string;\n      legalEntityId?: string;\n      onlyActive?: boolean;\n      pageNumber?: number;\n      pageSize?: number;\n    } = {},\n    auth?: AuthContext,\n  ): Promise<SegmentItem[]> {\n    const q: Record<string, string | number | undefined> = {};\n    setIfDefined(q, \"q\", query.q);\n    setIfDefined(q, \"siteCode\", query.siteCode);\n    setIfDefined(q, \"legalEntityId\", query.legalEntityId);\n    setIfDefined(q, \"pageNumber\", query.pageNumber);\n    setIfDefined(q, \"pageSize\", query.pageSize);\n    if (query.onlyActive !== undefined) q.onlyActive = String(query.onlyActive);\n    return this.ctx.http.request<SegmentItem[]>({\n      method: \"GET\",\n      path: `${this.base()}/items`,\n      auth: requireCustomer(auth),\n      ...(Object.keys(q).length ? { query: q } : {}),\n    });\n  }\n\n  /** Item assignments of one specific segment. */\n  async listSegmentItems(\n    segmentId: string,\n    query: {\n      q?: string;\n      legalEntityId?: string;\n      pageNumber?: number;\n      pageSize?: number;\n    } = {},\n    auth?: AuthContext,\n  ): Promise<SegmentItem[]> {\n    const q: Record<string, string | number | undefined> = {};\n    setIfDefined(q, \"q\", query.q);\n    setIfDefined(q, \"legalEntityId\", query.legalEntityId);\n    setIfDefined(q, \"pageNumber\", query.pageNumber);\n    setIfDefined(q, \"pageSize\", query.pageSize);\n    return this.ctx.http.request<SegmentItem[]>({\n      method: \"GET\",\n      path: `${this.base()}/${segmentId}/items`,\n      auth: requireCustomer(auth),\n      ...(Object.keys(q).length ? { query: q } : {}),\n    });\n  }\n\n  /** Category tree built only from the caller's active segments. */\n  async getCategoryTree(\n    query: { siteCode?: string; legalEntityId?: string } = {},\n    auth?: AuthContext,\n  ): Promise<SegmentCategoryTree> {\n    const q: Record<string, string | number | undefined> = {};\n    setIfDefined(q, \"siteCode\", query.siteCode);\n    setIfDefined(q, \"legalEntityId\", query.legalEntityId);\n    return this.ctx.http.request<SegmentCategoryTree>({\n      method: \"GET\",\n      path: `${this.base()}/items/category-trees`,\n      auth: requireCustomer(auth),\n      ...(Object.keys(q).length ? { query: q } : {}),\n    });\n  }\n\n  private async pickItemIds(\n    kind: \"PRODUCT\" | \"CATEGORY\",\n    query: Parameters<SegmentService[\"listItems\"]>[0],\n    auth: AuthContext | undefined,\n  ): Promise<string[]> {\n    const rows = await this.listItems(query, auth);\n    const ids: string[] = [];\n    for (const r of rows) {\n      const id = r.item?.id;\n      if (r.type === kind && typeof id === \"string\") ids.push(id);\n    }\n    return ids;\n  }\n\n  /** Product ids assigned to the caller's active segments. */\n  async listMyProductIds(\n    query?: Parameters<SegmentService[\"listItems\"]>[0],\n    auth?: AuthContext,\n  ): Promise<string[]> {\n    return this.pickItemIds(\"PRODUCT\", query ?? {}, auth);\n  }\n\n  /** Category ids assigned to the caller's active segments. */\n  async listMyCategoryIds(\n    query?: Parameters<SegmentService[\"listItems\"]>[0],\n    auth?: AuthContext,\n  ): Promise<string[]> {\n    return this.pickItemIds(\"CATEGORY\", query ?? {}, auth);\n  }\n\n  /**\n   * Hydrates `listMyProductIds` via `ProductService.get` in parallel.\n   * Resolves in the same order as the id list. Any single failure rejects\n   * the whole batch (`Promise.all`); use the id-list method + your own\n   * tolerance strategy if partial success matters.\n   */\n  async listMyProducts(\n    query?: Parameters<SegmentService[\"listItems\"]>[0],\n    auth?: AuthContext,\n  ): Promise<PaginatedItems<Awaited<ReturnType<ProductService[\"get\"]>>>> {\n    const pageNumber = query?.pageNumber ?? 1;\n    const pageSize = query?.pageSize ?? 20;\n    const sourceItems = await this.listItems(\n      { ...(query ?? {}), pageNumber, pageSize },\n      auth,\n    );\n    const ids: string[] = [];\n    for (const r of sourceItems) {\n      if (r.type === \"PRODUCT\" && typeof r.item?.id === \"string\") ids.push(r.item.id);\n    }\n    const items = await this.deps.products.searchByIds(ids, undefined, auth);\n    return { items, pageNumber, pageSize, hasNextPage: sourceItems.length === pageSize };\n  }\n\n  /**\n   * Hydrates a page of the caller's segment CATEGORY assignments into\n   * real categories via one bulk `categories.searchByIds` call. Same\n   * `hasNextPage` semantic as `listMyProducts`.\n   */\n  async listMyCategories(\n    query?: Parameters<SegmentService[\"listItems\"]>[0],\n    auth?: AuthContext,\n  ): Promise<PaginatedItems<Awaited<ReturnType<CategoryService[\"get\"]>>>> {\n    const pageNumber = query?.pageNumber ?? 1;\n    const pageSize = query?.pageSize ?? 20;\n    const sourceItems = await this.listItems(\n      { ...(query ?? {}), pageNumber, pageSize },\n      auth,\n    );\n    const ids: string[] = [];\n    for (const r of sourceItems) {\n      if (r.type === \"CATEGORY\" && typeof r.item?.id === \"string\") ids.push(r.item.id);\n    }\n    const items = await this.deps.categories.searchByIds(ids, undefined, auth);\n    return { items, pageNumber, pageSize, hasNextPage: sourceItems.length === pageSize };\n  }\n}\n"]}