@viu/emporix-sdk 3.6.0 → 4.0.1

package/dist/segment.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-CZdtWgQO.cjs';
+import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-5lt8Q0MT.cjs';
 import { ProductService } from './product.cjs';
 import { CategoryService } from './category.cjs';
 import './query-mLQs2WFr.cjs';
@@ -107,6 +107,48 @@ type CustomerAssignmentB2cResponse = {
 type CustomerAssignmentResponse = {
     legalEntity?: LegalEntity;
 } & CustomerAssignmentB2cResponse;
+/**
+ * Request body for creating or updating an IAM group assignment.
+ *
+ */
+type GroupAssignmentUpsert = {
+    /**
+     * A key-value map of additional attributes.
+     */
+    mixins?: {
+        [key: string]: unknown;
+    };
+    metadata?: MetadataUpdate;
+};
+/**
+ * IAM group assigned to the customer segment.
+ */
+type Group = {
+    /**
+     * Unique identifier of an existing IAM group, generated when the group is created through the IAM Service.
+     */
+    id?: string;
+    /**
+     * Localized name of the group.
+     */
+    name?: {
+        [key: string]: string;
+    };
+};
+type GroupAssignmentResponse = {
+    /**
+     * Unique identifier of the customer segment.
+     */
+    segmentId?: string;
+    group?: Group;
+    /**
+     * A key-value map of additional attributes.
+     */
+    mixins?: {
+        [key: string]: unknown;
+    };
+    metadata?: MetadataResponse;
+};
 type ItemAssignmentUpsert = {
     /**
      * A key-value map of additional attributes.
@@ -308,6 +350,10 @@ type SegmentCustomerInput = CustomerAssignmentUpsert;
 type SegmentCustomerBulkInput = CustomerAssignmentUpsertBulk;
 /** A customer→segment assignment (read). */
 type SegmentCustomer = CustomerAssignmentResponse;
+/** IAM group→segment assignment body (generated). The group id is in the path. */
+type SegmentGroupInput = GroupAssignmentUpsert;
+/** An IAM group→segment assignment (read). */
+type SegmentGroup = GroupAssignmentResponse;
 /** Item→segment assignment body (generated). */
 type SegmentItemInput = ItemAssignmentUpsert;
 /** One entry of an item-assignment bulk request (generated). */
@@ -332,12 +378,30 @@ declare class SegmentService {
     static readonly deps: readonly ["products", "categories"];
     constructor(ctx: ClientContext, deps: SegmentServiceDeps);
     private base;
-    /** Lists segments the caller belongs to (with `segment_read_own`). */
+    /**
+     * Lists segments via the generic `GET /segments` (with `segment_read_own`).
+     * Its documentation does not say whether segments inherited through IAM
+     * groups are included — for "which segments is this customer in", use
+     * {@link listMine}, which is documented to include them.
+     */
     list(query?: {
         q?: string;
         pageNumber?: number;
         pageSize?: number;
     }, auth?: AuthContext): Promise<Segment[]>;
+    /**
+     * The authenticated customer's **active** segments (`GET /segments/me`,
+     * `segment_read_own`): assigned directly, and inherited through the
+     * customer's IAM groups — groups not bound to a legal entity, plus groups
+     * bound to the customer's *current* legal entity. Switching the active company
+     * can therefore change the result.
+     */
+    listMine(query?: {
+        q?: string;
+        pageNumber?: number;
+        pageSize?: number;
+        sort?: string;
+    }, auth?: AuthContext): Promise<Segment[]>;
     /** Fetches a single segment by id. */
     get(segmentId: string, auth?: AuthContext): Promise<Segment>;
     /** Item assignments (PRODUCT + CATEGORY) across all the caller's active segments. */
@@ -410,6 +474,29 @@ declare class SegmentService {
         bulkAssign: (segmentId: string, inputs: SegmentCustomerBulkInput[], authCtx?: AuthContext) => Promise<SegmentAssignmentBulkResult[]>;
         bulkRemove: (segmentId: string, body: Record<string, unknown>, authCtx?: AuthContext) => Promise<SegmentAssignmentBulkResult[]>;
     };
+    /**
+     * IAM group→segment assignments (`segment_read` / `segment_manage`). Customers
+     * inherit a segment through their groups, on top of direct assignment — see
+     * {@link listMine}. Only groups with `userType: "CUSTOMER"` can be assigned;
+     * anything else is a `400`. Default auth: service.
+     */
+    readonly groups: {
+        list: (segmentId: string, query?: {
+            q?: string;
+            pageNumber?: number;
+            pageSize?: number;
+            sort?: string;
+        }, authCtx?: AuthContext) => Promise<SegmentGroup[]>;
+        search: (segmentId: string, query: SegmentSearchQuery, authCtx?: AuthContext) => Promise<SegmentGroup[]>;
+        get: (segmentId: string, groupId: string, authCtx?: AuthContext) => Promise<SegmentGroup>;
+        /**
+         * Upsert: `201` when the assignment is created, `204` when it is updated —
+         * **neither returns a body**, so this resolves to nothing. Fetch it with
+         * {@link get} if you need the stored assignment.
+         */
+        assign: (segmentId: string, groupId: string, input?: SegmentGroupInput, authCtx?: AuthContext) => Promise<void>;
+        remove: (segmentId: string, groupId: string, authCtx?: AuthContext) => Promise<void>;
+    };
     /** Item→segment assignments (`type` = PRODUCT | CATEGORY). Default auth: service. */
     readonly items: {
         search: (segmentId: string, query: Record<string, unknown>, authCtx?: AuthContext) => Promise<SegmentItem[]>;
@@ -421,4 +508,4 @@ declare class SegmentService {
     };
 }
 
-export { type Segment, type SegmentAssignmentBulkResult, type SegmentBulkItem, type SegmentBulkResult, type SegmentCategoryTree, type SegmentCategoryTreeNode, type SegmentCustomer, type SegmentCustomerBulkInput, type SegmentCustomerInput, type SegmentInput, type SegmentItem, type SegmentItemBulkInput, type SegmentItemInput, type SegmentMatchInput, type SegmentPatchInput, type SegmentSearchQuery, SegmentService, type SegmentServiceDeps, type SegmentUpdateInput };
+export { type Segment, type SegmentAssignmentBulkResult, type SegmentBulkItem, type SegmentBulkResult, type SegmentCategoryTree, type SegmentCategoryTreeNode, type SegmentCustomer, type SegmentCustomerBulkInput, type SegmentCustomerInput, type SegmentGroup, type SegmentGroupInput, type SegmentInput, type SegmentItem, type SegmentItemBulkInput, type SegmentItemInput, type SegmentMatchInput, type SegmentPatchInput, type SegmentSearchQuery, SegmentService, type SegmentServiceDeps, type SegmentUpdateInput };

package/dist/segment.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-CZdtWgQO.js';
+import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-5lt8Q0MT.js';
 import { ProductService } from './product.js';
 import { CategoryService } from './category.js';
 import './query-mLQs2WFr.js';
@@ -107,6 +107,48 @@ type CustomerAssignmentB2cResponse = {
 type CustomerAssignmentResponse = {
     legalEntity?: LegalEntity;
 } & CustomerAssignmentB2cResponse;
+/**
+ * Request body for creating or updating an IAM group assignment.
+ *
+ */
+type GroupAssignmentUpsert = {
+    /**
+     * A key-value map of additional attributes.
+     */
+    mixins?: {
+        [key: string]: unknown;
+    };
+    metadata?: MetadataUpdate;
+};
+/**
+ * IAM group assigned to the customer segment.
+ */
+type Group = {
+    /**
+     * Unique identifier of an existing IAM group, generated when the group is created through the IAM Service.
+     */
+    id?: string;
+    /**
+     * Localized name of the group.
+     */
+    name?: {
+        [key: string]: string;
+    };
+};
+type GroupAssignmentResponse = {
+    /**
+     * Unique identifier of the customer segment.
+     */
+    segmentId?: string;
+    group?: Group;
+    /**
+     * A key-value map of additional attributes.
+     */
+    mixins?: {
+        [key: string]: unknown;
+    };
+    metadata?: MetadataResponse;
+};
 type ItemAssignmentUpsert = {
     /**
      * A key-value map of additional attributes.
@@ -308,6 +350,10 @@ type SegmentCustomerInput = CustomerAssignmentUpsert;
 type SegmentCustomerBulkInput = CustomerAssignmentUpsertBulk;
 /** A customer→segment assignment (read). */
 type SegmentCustomer = CustomerAssignmentResponse;
+/** IAM group→segment assignment body (generated). The group id is in the path. */
+type SegmentGroupInput = GroupAssignmentUpsert;
+/** An IAM group→segment assignment (read). */
+type SegmentGroup = GroupAssignmentResponse;
 /** Item→segment assignment body (generated). */
 type SegmentItemInput = ItemAssignmentUpsert;
 /** One entry of an item-assignment bulk request (generated). */
@@ -332,12 +378,30 @@ declare class SegmentService {
     static readonly deps: readonly ["products", "categories"];
     constructor(ctx: ClientContext, deps: SegmentServiceDeps);
     private base;
-    /** Lists segments the caller belongs to (with `segment_read_own`). */
+    /**
+     * Lists segments via the generic `GET /segments` (with `segment_read_own`).
+     * Its documentation does not say whether segments inherited through IAM
+     * groups are included — for "which segments is this customer in", use
+     * {@link listMine}, which is documented to include them.
+     */
     list(query?: {
         q?: string;
         pageNumber?: number;
         pageSize?: number;
     }, auth?: AuthContext): Promise<Segment[]>;
+    /**
+     * The authenticated customer's **active** segments (`GET /segments/me`,
+     * `segment_read_own`): assigned directly, and inherited through the
+     * customer's IAM groups — groups not bound to a legal entity, plus groups
+     * bound to the customer's *current* legal entity. Switching the active company
+     * can therefore change the result.
+     */
+    listMine(query?: {
+        q?: string;
+        pageNumber?: number;
+        pageSize?: number;
+        sort?: string;
+    }, auth?: AuthContext): Promise<Segment[]>;
     /** Fetches a single segment by id. */
     get(segmentId: string, auth?: AuthContext): Promise<Segment>;
     /** Item assignments (PRODUCT + CATEGORY) across all the caller's active segments. */
@@ -410,6 +474,29 @@ declare class SegmentService {
         bulkAssign: (segmentId: string, inputs: SegmentCustomerBulkInput[], authCtx?: AuthContext) => Promise<SegmentAssignmentBulkResult[]>;
         bulkRemove: (segmentId: string, body: Record<string, unknown>, authCtx?: AuthContext) => Promise<SegmentAssignmentBulkResult[]>;
     };
+    /**
+     * IAM group→segment assignments (`segment_read` / `segment_manage`). Customers
+     * inherit a segment through their groups, on top of direct assignment — see
+     * {@link listMine}. Only groups with `userType: "CUSTOMER"` can be assigned;
+     * anything else is a `400`. Default auth: service.
+     */
+    readonly groups: {
+        list: (segmentId: string, query?: {
+            q?: string;
+            pageNumber?: number;
+            pageSize?: number;
+            sort?: string;
+        }, authCtx?: AuthContext) => Promise<SegmentGroup[]>;
+        search: (segmentId: string, query: SegmentSearchQuery, authCtx?: AuthContext) => Promise<SegmentGroup[]>;
+        get: (segmentId: string, groupId: string, authCtx?: AuthContext) => Promise<SegmentGroup>;
+        /**
+         * Upsert: `201` when the assignment is created, `204` when it is updated —
+         * **neither returns a body**, so this resolves to nothing. Fetch it with
+         * {@link get} if you need the stored assignment.
+         */
+        assign: (segmentId: string, groupId: string, input?: SegmentGroupInput, authCtx?: AuthContext) => Promise<void>;
+        remove: (segmentId: string, groupId: string, authCtx?: AuthContext) => Promise<void>;
+    };
     /** Item→segment assignments (`type` = PRODUCT | CATEGORY). Default auth: service. */
     readonly items: {
         search: (segmentId: string, query: Record<string, unknown>, authCtx?: AuthContext) => Promise<SegmentItem[]>;
@@ -421,4 +508,4 @@ declare class SegmentService {
     };
 }
 
-export { type Segment, type SegmentAssignmentBulkResult, type SegmentBulkItem, type SegmentBulkResult, type SegmentCategoryTree, type SegmentCategoryTreeNode, type SegmentCustomer, type SegmentCustomerBulkInput, type SegmentCustomerInput, type SegmentInput, type SegmentItem, type SegmentItemBulkInput, type SegmentItemInput, type SegmentMatchInput, type SegmentPatchInput, type SegmentSearchQuery, SegmentService, type SegmentServiceDeps, type SegmentUpdateInput };
+export { type Segment, type SegmentAssignmentBulkResult, type SegmentBulkItem, type SegmentBulkResult, type SegmentCategoryTree, type SegmentCategoryTreeNode, type SegmentCustomer, type SegmentCustomerBulkInput, type SegmentCustomerInput, type SegmentGroup, type SegmentGroupInput, type SegmentInput, type SegmentItem, type SegmentItemBulkInput, type SegmentItemInput, type SegmentMatchInput, type SegmentPatchInput, type SegmentSearchQuery, SegmentService, type SegmentServiceDeps, type SegmentUpdateInput };

package/dist/segment.js

@@ -1,4 +1,4 @@
-export { SegmentService } from './chunk-3G5KROEC.js';
+export { SegmentService } from './chunk-XJJDCK2Z.js';
 import './chunk-3BDDYX3V.js';
 import './chunk-UWGGF4MC.js';
 //# sourceMappingURL=segment.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@viu/emporix-sdk",
-  "version": "3.6.0",
+  "version": "4.0.1",
   "description": "TypeScript SDK for the Emporix Commerce Engine",
   "license": "MIT",
   "author": {

package/dist/chunk-3G5KROEC.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/services/segment.ts"],"names":[],"mappings":"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","file":"chunk-3G5KROEC.js","sourcesContent":["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  SegmentCreation,\n  SegmentUpdate,\n  SegmentsSearch,\n  SegmentUpdateBulk,\n  Match,\n  CustomerAssignmentUpsert,\n  CustomerAssignmentUpsertBulk,\n  CustomerAssignmentResponse,\n  ItemAssignmentUpsert,\n  ItemAssignmentUpsertBulk,\n  BulkResponse,\n  BulkAssignmentResponse,\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/** Create body for a segment (generated). */\nexport type SegmentInput = SegmentCreation;\n/** Full-replace (PUT) body for a segment (generated). */\nexport type SegmentUpdateInput = SegmentUpdate;\n/** Partial (PATCH) body for a segment. */\nexport type SegmentPatchInput = Partial<SegmentUpdate>;\n/** Search body for segments (generated). */\nexport type SegmentSearchQuery = SegmentsSearch;\n/** Body for a segment match check (generated). */\nexport type SegmentMatchInput = Match;\n/** One entry of a segment bulk request (generated). */\nexport type SegmentBulkItem = SegmentUpdateBulk;\n/** Per-entry result of a segment bulk operation (generated). */\nexport type SegmentBulkResult = BulkResponse;\n/** Customer→segment assignment body (generated). */\nexport type SegmentCustomerInput = CustomerAssignmentUpsert;\n/** One entry of a customer-assignment bulk request (generated). */\nexport type SegmentCustomerBulkInput = CustomerAssignmentUpsertBulk;\n/** A customer→segment assignment (read). */\nexport type SegmentCustomer = CustomerAssignmentResponse;\n/** Item→segment assignment body (generated). */\nexport type SegmentItemInput = ItemAssignmentUpsert;\n/** One entry of an item-assignment bulk request (generated). */\nexport type SegmentItemBulkInput = ItemAssignmentUpsertBulk;\n/** Per-entry result of an assignment bulk operation (generated). */\nexport type SegmentAssignmentBulkResult = BulkAssignmentResponse;\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/** Admin default: segment-manage operations use a service token. */\nconst SERVICE: AuthContext = { kind: \"service\" };\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  static readonly channel = \"segment\" as const;\n  static readonly deps = [\"products\", \"categories\"] as const;\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  // No `totalCount` opt-in, deliberately. This pages over the segment's\n  // ASSIGNMENTS and hydrates the hits in a second call, so `X-Total-Count` would\n  // count assignments — including the CATEGORY entries filtered out below — not\n  // the products returned. A number that is wrong in the way that is hardest to\n  // notice. Same reason `categories.productsIn` stays on the guess.\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  // No `totalCount` opt-in — see the note on {@link listMyProducts}.\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  // --- Admin CRUD (segment_manage). Default auth: service. ---\n\n  /** Creates a segment. Default auth: service. */\n  async create(input: SegmentInput, authCtx: AuthContext = SERVICE): Promise<Segment> {\n    return this.ctx.http.request<Segment>({ method: \"POST\", path: this.base(), auth: authCtx, body: input });\n  }\n\n  /** Searches segments (POST body). Default auth: service. */\n  async search(query: SegmentSearchQuery, authCtx: AuthContext = SERVICE): Promise<Segment[]> {\n    return this.ctx.http.request<Segment[]>({\n      method: \"POST\",\n      path: `${this.base()}/search`,\n      auth: authCtx,\n      body: query,\n    });\n  }\n\n  /** Full-replaces a segment (PUT). Default auth: service. */\n  async update(segmentId: string, input: SegmentUpdateInput, authCtx: AuthContext = SERVICE): Promise<Segment> {\n    return this.ctx.http.request<Segment>({\n      method: \"PUT\",\n      path: `${this.base()}/${segmentId}`,\n      auth: authCtx,\n      body: input,\n    });\n  }\n\n  /** Partially updates a segment (PATCH). Default auth: service. */\n  async patch(segmentId: string, input: SegmentPatchInput, authCtx: AuthContext = SERVICE): Promise<Segment> {\n    return this.ctx.http.request<Segment>({\n      method: \"PATCH\",\n      path: `${this.base()}/${segmentId}`,\n      auth: authCtx,\n      body: input,\n    });\n  }\n\n  /** Deletes a segment. Default auth: service. */\n  async delete(segmentId: string, authCtx: AuthContext = SERVICE): Promise<void> {\n    await this.ctx.http.request<void>({\n      method: \"DELETE\",\n      path: `${this.base()}/${segmentId}`,\n      auth: authCtx,\n    });\n  }\n\n  /** Checks which segments the given items/customers match. Default auth: service. */\n  async match(input: SegmentMatchInput, authCtx: AuthContext = SERVICE): Promise<Segment[]> {\n    return this.ctx.http.request<Segment[]>({\n      method: \"POST\",\n      path: `${this.base()}/match`,\n      auth: authCtx,\n      body: input,\n    });\n  }\n\n  /** Creates multiple segments. Default auth: service. */\n  async bulkCreate(inputs: SegmentBulkItem[], authCtx: AuthContext = SERVICE): Promise<SegmentBulkResult[]> {\n    return this.ctx.http.request<SegmentBulkResult[]>({\n      method: \"POST\",\n      path: `${this.base()}/bulk`,\n      auth: authCtx,\n      body: inputs,\n    });\n  }\n\n  /** Upserts multiple segments (PUT). Default auth: service. */\n  async bulkUpdate(inputs: SegmentBulkItem[], authCtx: AuthContext = SERVICE): Promise<SegmentBulkResult[]> {\n    return this.ctx.http.request<SegmentBulkResult[]>({\n      method: \"PUT\",\n      path: `${this.base()}/bulk`,\n      auth: authCtx,\n      body: inputs,\n    });\n  }\n\n  /** Deletes multiple segments (DELETE with a body of ids). Default auth: service. */\n  async bulkDelete(body: Record<string, unknown>, authCtx: AuthContext = SERVICE): Promise<SegmentBulkResult[]> {\n    return this.ctx.http.request<SegmentBulkResult[]>({\n      method: \"DELETE\",\n      path: `${this.base()}/bulk`,\n      auth: authCtx,\n      body,\n    });\n  }\n\n  /** Customer→segment assignments (`segment_manage`). Default auth: service. */\n  readonly customers = {\n    list: async (segmentId: string, query?: Record<string, string | number>, authCtx: AuthContext = SERVICE): Promise<SegmentCustomer[]> =>\n      this.ctx.http.request<SegmentCustomer[]>({\n        method: \"GET\",\n        path: `${this.base()}/${segmentId}/customers`,\n        auth: authCtx,\n        ...(query ? { query } : {}),\n      }),\n    search: async (segmentId: string, query: Record<string, unknown>, authCtx: AuthContext = SERVICE): Promise<SegmentCustomer[]> =>\n      this.ctx.http.request<SegmentCustomer[]>({\n        method: \"POST\",\n        path: `${this.base()}/${segmentId}/customers/search`,\n        auth: authCtx,\n        body: query,\n      }),\n    get: async (segmentId: string, customerId: string, authCtx: AuthContext = SERVICE): Promise<SegmentCustomer> =>\n      this.ctx.http.request<SegmentCustomer>({\n        method: \"GET\",\n        path: `${this.base()}/${segmentId}/customers/${customerId}`,\n        auth: authCtx,\n      }),\n    assign: async (segmentId: string, customerId: string, input: SegmentCustomerInput, authCtx: AuthContext = SERVICE): Promise<SegmentCustomer> =>\n      this.ctx.http.request<SegmentCustomer>({\n        method: \"PUT\",\n        path: `${this.base()}/${segmentId}/customers/${customerId}`,\n        auth: authCtx,\n        body: input,\n      }),\n    remove: async (segmentId: string, customerId: string, authCtx: AuthContext = SERVICE): Promise<void> => {\n      await this.ctx.http.request<void>({\n        method: \"DELETE\",\n        path: `${this.base()}/${segmentId}/customers/${customerId}`,\n        auth: authCtx,\n      });\n    },\n    getForEntity: async (segmentId: string, customerId: string, legalEntityId: string, authCtx: AuthContext = SERVICE): Promise<SegmentCustomer> =>\n      this.ctx.http.request<SegmentCustomer>({\n        method: \"GET\",\n        path: `${this.base()}/${segmentId}/customers/${customerId}/${legalEntityId}`,\n        auth: authCtx,\n      }),\n    assignForEntity: async (segmentId: string, customerId: string, legalEntityId: string, input: SegmentCustomerInput, authCtx: AuthContext = SERVICE): Promise<SegmentCustomer> =>\n      this.ctx.http.request<SegmentCustomer>({\n        method: \"PUT\",\n        path: `${this.base()}/${segmentId}/customers/${customerId}/${legalEntityId}`,\n        auth: authCtx,\n        body: input,\n      }),\n    removeForEntity: async (segmentId: string, customerId: string, legalEntityId: string, authCtx: AuthContext = SERVICE): Promise<void> => {\n      await this.ctx.http.request<void>({\n        method: \"DELETE\",\n        path: `${this.base()}/${segmentId}/customers/${customerId}/${legalEntityId}`,\n        auth: authCtx,\n      });\n    },\n    bulkAssign: async (segmentId: string, inputs: SegmentCustomerBulkInput[], authCtx: AuthContext = SERVICE): Promise<SegmentAssignmentBulkResult[]> =>\n      this.ctx.http.request<SegmentAssignmentBulkResult[]>({\n        method: \"PUT\",\n        path: `${this.base()}/${segmentId}/customers/bulk`,\n        auth: authCtx,\n        body: inputs,\n      }),\n    bulkRemove: async (segmentId: string, body: Record<string, unknown>, authCtx: AuthContext = SERVICE): Promise<SegmentAssignmentBulkResult[]> =>\n      this.ctx.http.request<SegmentAssignmentBulkResult[]>({\n        method: \"DELETE\",\n        path: `${this.base()}/${segmentId}/customers/bulk`,\n        auth: authCtx,\n        body,\n      }),\n  };\n\n  /** Item→segment assignments (`type` = PRODUCT | CATEGORY). Default auth: service. */\n  readonly items = {\n    search: async (segmentId: string, query: Record<string, unknown>, authCtx: AuthContext = SERVICE): Promise<SegmentItem[]> =>\n      this.ctx.http.request<SegmentItem[]>({\n        method: \"POST\",\n        path: `${this.base()}/${segmentId}/items/search`,\n        auth: authCtx,\n        body: query,\n      }),\n    get: async (segmentId: string, type: string, itemId: string, authCtx: AuthContext = SERVICE): Promise<SegmentItem> =>\n      this.ctx.http.request<SegmentItem>({\n        method: \"GET\",\n        path: `${this.base()}/${segmentId}/items/${type}/${itemId}`,\n        auth: authCtx,\n      }),\n    assign: async (segmentId: string, type: string, itemId: string, input: SegmentItemInput, authCtx: AuthContext = SERVICE): Promise<SegmentItem> =>\n      this.ctx.http.request<SegmentItem>({\n        method: \"PUT\",\n        path: `${this.base()}/${segmentId}/items/${type}/${itemId}`,\n        auth: authCtx,\n        body: input,\n      }),\n    remove: async (segmentId: string, type: string, itemId: string, authCtx: AuthContext = SERVICE): Promise<void> => {\n      await this.ctx.http.request<void>({\n        method: \"DELETE\",\n        path: `${this.base()}/${segmentId}/items/${type}/${itemId}`,\n        auth: authCtx,\n      });\n    },\n    bulkAssign: async (segmentId: string, type: string, inputs: SegmentItemBulkInput[], authCtx: AuthContext = SERVICE): Promise<SegmentAssignmentBulkResult[]> =>\n      this.ctx.http.request<SegmentAssignmentBulkResult[]>({\n        method: \"PUT\",\n        path: `${this.base()}/${segmentId}/items/${type}/bulk`,\n        auth: authCtx,\n        body: inputs,\n      }),\n    bulkRemove: async (segmentId: string, type: string, body: Record<string, unknown>, authCtx: AuthContext = SERVICE): Promise<SegmentAssignmentBulkResult[]> =>\n      this.ctx.http.request<SegmentAssignmentBulkResult[]>({\n        method: \"DELETE\",\n        path: `${this.base()}/${segmentId}/items/${type}/bulk`,\n        auth: authCtx,\n        body,\n      }),\n  };\n}\n"]}