@viu/emporix-sdk 2.21.0 → 2.23.0

package/dist/chunk-V3275BA7.js

@@ -0,0 +1,181 @@
+import { EmporixNotFoundError } from './chunk-UWGGF4MC.js';
+
+// src/services/availability.ts
+var ANON = { kind: "anonymous" };
+var SERVICE = { kind: "service" };
+var AvailabilityService = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  ctx;
+  static channel = "availability";
+  /**
+   * Single product. Resolves the availability record, or — when
+   * `opts.defaultAvailableOnNotFound` is set — a default available record on 404.
+   */
+  async get(productId, siteCode, auth = ANON, opts = {}) {
+    try {
+      return await this.ctx.http.request({
+        method: "GET",
+        path: `/availability/${this.ctx.tenant}/availability/${encodeURIComponent(
+          productId
+        )}/${encodeURIComponent(siteCode)}`,
+        auth
+      });
+    } catch (err) {
+      if (err instanceof EmporixNotFoundError && opts.defaultAvailableOnNotFound) {
+        return { productId, site: siteCode, available: true };
+      }
+      throw err;
+    }
+  }
+  /**
+   * Batch read via `POST .../availability/search` (one request). Products with
+   * no availability record are absent from the response; each is synthesized as
+   * `{ available: false }` (or `{ available: true }` when
+   * `opts.defaultAvailableOnNotFound` is set). The result preserves input order
+   * and length. An empty `productIds` resolves to `[]` without a request.
+   */
+  async getMany(productIds, siteCode, auth = ANON, opts = {}) {
+    if (productIds.length === 0) return [];
+    const found = await this.ctx.http.request({
+      method: "POST",
+      path: `/availability/${this.ctx.tenant}/availability/search`,
+      auth,
+      query: { site: siteCode, pageSize: productIds.length },
+      body: productIds,
+      idempotent: true
+      // pure read over POST — safe to replay on 5xx/429
+    });
+    const byId = /* @__PURE__ */ new Map();
+    for (const a of found) if (a.productId) byId.set(a.productId, a);
+    return productIds.map(
+      (id) => byId.get(id) ?? {
+        productId: id,
+        site: siteCode,
+        available: Boolean(opts.defaultAvailableOnNotFound)
+      }
+    );
+  }
+  /**
+   * Lists every availability record for a site (`GET /availability/site/{site}`),
+   * wrapped into `PaginatedItems`. Default auth: anonymous.
+   */
+  async listForSite(siteCode, params = {}, auth = ANON) {
+    const pageNumber = params.pageNumber ?? 1;
+    const pageSize = params.pageSize ?? 50;
+    const items = await this.ctx.http.request({
+      method: "GET",
+      path: `/availability/${this.ctx.tenant}/availability/site/${encodeURIComponent(siteCode)}`,
+      query: {
+        pageNumber,
+        pageSize,
+        ...params.q === void 0 ? {} : { q: params.q },
+        ...params.sort === void 0 ? {} : { sort: params.sort }
+      },
+      auth
+    });
+    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };
+  }
+  // --- Admin writes. Default auth: service. ---
+  /**
+   * Creates an availability record for a product on a site
+   * (`POST /availability/{productId}/{site}`). Responds 409 when the record
+   * already exists — use {@link update} to upsert. Default auth: service.
+   */
+  async create(productId, siteCode, input, auth = SERVICE) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: `/availability/${this.ctx.tenant}/availability/${encodeURIComponent(
+        productId
+      )}/${encodeURIComponent(siteCode)}`,
+      body: input,
+      auth
+    });
+  }
+  /**
+   * Upserts a product's availability on a site
+   * (`PUT /availability/{productId}/{site}`). Returns the created record's id
+   * on 201 and nothing on 204. This endpoint has no PATCH counterpart.
+   * Default auth: service.
+   */
+  async update(productId, siteCode, input, auth = SERVICE) {
+    return this.ctx.http.request({
+      method: "PUT",
+      path: `/availability/${this.ctx.tenant}/availability/${encodeURIComponent(
+        productId
+      )}/${encodeURIComponent(siteCode)}`,
+      body: input,
+      auth
+    });
+  }
+  /**
+   * Deletes a product's availability on a site
+   * (`DELETE /availability/{productId}/{site}`). Default auth: service.
+   */
+  async delete(productId, siteCode, auth = SERVICE) {
+    await this.ctx.http.request({
+      method: "DELETE",
+      path: `/availability/${this.ctx.tenant}/availability/${encodeURIComponent(
+        productId
+      )}/${encodeURIComponent(siteCode)}`,
+      auth
+    });
+  }
+  /**
+   * Bulk-creates availability records (`POST /availability/bulk`). Responds 207
+   * Multi-Status: partial failures do **not** throw — inspect each entry.
+   *
+   * `options.vendorId` limits the operation to a vendor's products. It is sent
+   * as the `vendor-id` header. **Note:** the OpenAPI schema spells this header
+   * `venodr-id`, which is an evident upstream typo (the body field is
+   * `vendorId`); the SDK sends the corrected name. Unverified against the live
+   * API — if the service really expects the misspelling, the filter silently
+   * has no effect.
+   *
+   * Default auth: service.
+   */
+  async bulkCreate(input, options = {}, auth = SERVICE) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: `/availability/${this.ctx.tenant}/availability/bulk`,
+      ...options.vendorId === void 0 ? {} : { headers: { "vendor-id": options.vendorId } },
+      body: input,
+      auth
+    });
+  }
+  /**
+   * Bulk-updates availability records (`PUT /availability/bulk`). Responds 207
+   * Multi-Status: partial failures do **not** throw — inspect each entry. See
+   * {@link bulkCreate} for the `vendorId` header caveat. Default auth: service.
+   */
+  async bulkUpdate(input, options = {}, auth = SERVICE) {
+    return this.ctx.http.request({
+      method: "PUT",
+      path: `/availability/${this.ctx.tenant}/availability/bulk`,
+      ...options.vendorId === void 0 ? {} : { headers: { "vendor-id": options.vendorId } },
+      body: input,
+      auth
+    });
+  }
+  /**
+   * Bulk-deletes availability records (`DELETE /availability/bulk`). Unusually
+   * for a DELETE, this endpoint takes a body listing the records to remove.
+   * Responds 207 Multi-Status: partial failures do **not** throw — inspect each
+   * entry. See {@link bulkCreate} for the `vendorId` header caveat. Default
+   * auth: service.
+   */
+  async bulkDelete(input, options = {}, auth = SERVICE) {
+    return this.ctx.http.request({
+      method: "DELETE",
+      path: `/availability/${this.ctx.tenant}/availability/bulk`,
+      ...options.vendorId === void 0 ? {} : { headers: { "vendor-id": options.vendorId } },
+      body: input,
+      auth
+    });
+  }
+};
+
+export { AvailabilityService };
+//# sourceMappingURL=chunk-V3275BA7.js.map
+//# sourceMappingURL=chunk-V3275BA7.js.map

package/dist/chunk-V3275BA7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/services/availability.ts"],"names":[],"mappings":"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","file":"chunk-V3275BA7.js","sourcesContent":["import type { ClientContext, PaginatedItems } from \"../core/context\";\nimport type { AuthContext } from \"../core/auth\";\nimport { EmporixNotFoundError } from \"../core/errors\";\nimport type {\n  Availability,\n  AvailabilityInput,\n  AvailabilityCreated,\n  AvailabilityBulkInput,\n  AvailabilityBulkDeleteInput,\n  AvailabilityBulkResult,\n} from \"./availability-types\";\n\nexport type {\n  Availability,\n  AvailabilityInput,\n  AvailabilityCreated,\n  AvailabilityBulkInput,\n  AvailabilityBulkDeleteInput,\n  AvailabilityBulkResult,\n} from \"./availability-types\";\n\n/** Shared options for {@link AvailabilityService} reads. */\nexport interface AvailabilityOptions {\n  /**\n   * When `true`, a product with no availability record resolves to a default\n   * `{ available: true }` instead of throwing (single `get`) / being marked\n   * unavailable (`getMany`). Off by default — opt in for tenants that sell\n   * without stock management.\n   */\n  defaultAvailableOnNotFound?: boolean;\n}\n\nconst ANON: AuthContext = { kind: \"anonymous\" };\nconst SERVICE: AuthContext = { kind: \"service\" };\n\n/**\n * Reads product availability per site. Default auth is anonymous (like\n * `PriceService.matchByContext`); pass a customer/raw/service context to use a\n * different token. Requires the `availability.availability_view` scope on\n * whichever token is used.\n */\nexport class AvailabilityService {\n  static readonly channel = \"availability\" as const;\n  constructor(private readonly ctx: ClientContext) {}\n\n  /**\n   * Single product. Resolves the availability record, or — when\n   * `opts.defaultAvailableOnNotFound` is set — a default available record on 404.\n   */\n  async get(\n    productId: string,\n    siteCode: string,\n    auth: AuthContext = ANON,\n    opts: AvailabilityOptions = {},\n  ): Promise<Availability> {\n    try {\n      return await this.ctx.http.request<Availability>({\n        method: \"GET\",\n        path: `/availability/${this.ctx.tenant}/availability/${encodeURIComponent(\n          productId,\n        )}/${encodeURIComponent(siteCode)}`,\n        auth,\n      });\n    } catch (err) {\n      if (err instanceof EmporixNotFoundError && opts.defaultAvailableOnNotFound) {\n        return { productId, site: siteCode, available: true };\n      }\n      throw err;\n    }\n  }\n\n  /**\n   * Batch read via `POST .../availability/search` (one request). Products with\n   * no availability record are absent from the response; each is synthesized as\n   * `{ available: false }` (or `{ available: true }` when\n   * `opts.defaultAvailableOnNotFound` is set). The result preserves input order\n   * and length. An empty `productIds` resolves to `[]` without a request.\n   */\n  async getMany(\n    productIds: string[],\n    siteCode: string,\n    auth: AuthContext = ANON,\n    opts: AvailabilityOptions = {},\n  ): Promise<Availability[]> {\n    if (productIds.length === 0) return [];\n    const found = await this.ctx.http.request<Availability[]>({\n      method: \"POST\",\n      path: `/availability/${this.ctx.tenant}/availability/search`,\n      auth,\n      query: { site: siteCode, pageSize: productIds.length },\n      body: productIds,\n      idempotent: true, // pure read over POST — safe to replay on 5xx/429\n    });\n    const byId = new Map<string, Availability>();\n    for (const a of found) if (a.productId) byId.set(a.productId, a);\n    return productIds.map(\n      (id) =>\n        byId.get(id) ?? {\n          productId: id,\n          site: siteCode,\n          available: Boolean(opts.defaultAvailableOnNotFound),\n        },\n    );\n  }\n\n  /**\n   * Lists every availability record for a site (`GET /availability/site/{site}`),\n   * wrapped into `PaginatedItems`. Default auth: anonymous.\n   */\n  async listForSite(\n    siteCode: string,\n    params: { pageNumber?: number; pageSize?: number; q?: string; sort?: string } = {},\n    auth: AuthContext = ANON,\n  ): Promise<PaginatedItems<Availability>> {\n    const pageNumber = params.pageNumber ?? 1;\n    const pageSize = params.pageSize ?? 50;\n    const items = await this.ctx.http.request<Availability[]>({\n      method: \"GET\",\n      path: `/availability/${this.ctx.tenant}/availability/site/${encodeURIComponent(siteCode)}`,\n      query: {\n        pageNumber,\n        pageSize,\n        ...(params.q === undefined ? {} : { q: params.q }),\n        ...(params.sort === undefined ? {} : { sort: params.sort }),\n      },\n      auth,\n    });\n    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };\n  }\n\n  // --- Admin writes. Default auth: service. ---\n\n  /**\n   * Creates an availability record for a product on a site\n   * (`POST /availability/{productId}/{site}`). Responds 409 when the record\n   * already exists — use {@link update} to upsert. Default auth: service.\n   */\n  async create(\n    productId: string,\n    siteCode: string,\n    input: AvailabilityInput,\n    auth: AuthContext = SERVICE,\n  ): Promise<AvailabilityCreated> {\n    return this.ctx.http.request<AvailabilityCreated>({\n      method: \"POST\",\n      path: `/availability/${this.ctx.tenant}/availability/${encodeURIComponent(\n        productId,\n      )}/${encodeURIComponent(siteCode)}`,\n      body: input,\n      auth,\n    });\n  }\n\n  /**\n   * Upserts a product's availability on a site\n   * (`PUT /availability/{productId}/{site}`). Returns the created record's id\n   * on 201 and nothing on 204. This endpoint has no PATCH counterpart.\n   * Default auth: service.\n   */\n  async update(\n    productId: string,\n    siteCode: string,\n    input: AvailabilityInput,\n    auth: AuthContext = SERVICE,\n  ): Promise<AvailabilityCreated | void> {\n    return this.ctx.http.request<AvailabilityCreated | void>({\n      method: \"PUT\",\n      path: `/availability/${this.ctx.tenant}/availability/${encodeURIComponent(\n        productId,\n      )}/${encodeURIComponent(siteCode)}`,\n      body: input,\n      auth,\n    });\n  }\n\n  /**\n   * Deletes a product's availability on a site\n   * (`DELETE /availability/{productId}/{site}`). Default auth: service.\n   */\n  async delete(productId: string, siteCode: string, auth: AuthContext = SERVICE): Promise<void> {\n    await this.ctx.http.request<void>({\n      method: \"DELETE\",\n      path: `/availability/${this.ctx.tenant}/availability/${encodeURIComponent(\n        productId,\n      )}/${encodeURIComponent(siteCode)}`,\n      auth,\n    });\n  }\n\n  /**\n   * Bulk-creates availability records (`POST /availability/bulk`). Responds 207\n   * Multi-Status: partial failures do **not** throw — inspect each entry.\n   *\n   * `options.vendorId` limits the operation to a vendor's products. It is sent\n   * as the `vendor-id` header. **Note:** the OpenAPI schema spells this header\n   * `venodr-id`, which is an evident upstream typo (the body field is\n   * `vendorId`); the SDK sends the corrected name. Unverified against the live\n   * API — if the service really expects the misspelling, the filter silently\n   * has no effect.\n   *\n   * Default auth: service.\n   */\n  async bulkCreate(\n    input: AvailabilityBulkInput[],\n    options: { vendorId?: string } = {},\n    auth: AuthContext = SERVICE,\n  ): Promise<AvailabilityBulkResult[]> {\n    return this.ctx.http.request<AvailabilityBulkResult[]>({\n      method: \"POST\",\n      path: `/availability/${this.ctx.tenant}/availability/bulk`,\n      ...(options.vendorId === undefined ? {} : { headers: { \"vendor-id\": options.vendorId } }),\n      body: input,\n      auth,\n    });\n  }\n\n  /**\n   * Bulk-updates availability records (`PUT /availability/bulk`). Responds 207\n   * Multi-Status: partial failures do **not** throw — inspect each entry. See\n   * {@link bulkCreate} for the `vendorId` header caveat. Default auth: service.\n   */\n  async bulkUpdate(\n    input: AvailabilityBulkInput[],\n    options: { vendorId?: string } = {},\n    auth: AuthContext = SERVICE,\n  ): Promise<AvailabilityBulkResult[]> {\n    return this.ctx.http.request<AvailabilityBulkResult[]>({\n      method: \"PUT\",\n      path: `/availability/${this.ctx.tenant}/availability/bulk`,\n      ...(options.vendorId === undefined ? {} : { headers: { \"vendor-id\": options.vendorId } }),\n      body: input,\n      auth,\n    });\n  }\n\n  /**\n   * Bulk-deletes availability records (`DELETE /availability/bulk`). Unusually\n   * for a DELETE, this endpoint takes a body listing the records to remove.\n   * Responds 207 Multi-Status: partial failures do **not** throw — inspect each\n   * entry. See {@link bulkCreate} for the `vendorId` header caveat. Default\n   * auth: service.\n   */\n  async bulkDelete(\n    input: AvailabilityBulkDeleteInput[],\n    options: { vendorId?: string } = {},\n    auth: AuthContext = SERVICE,\n  ): Promise<AvailabilityBulkResult[]> {\n    return this.ctx.http.request<AvailabilityBulkResult[]>({\n      method: \"DELETE\",\n      path: `/availability/${this.ctx.tenant}/availability/bulk`,\n      ...(options.vendorId === undefined ? {} : { headers: { \"vendor-id\": options.vendorId } }),\n      body: input,\n      auth,\n    });\n  }\n}\n"]}

package/dist/chunk-W2KBVWJ2.js

@@ -0,0 +1,323 @@
+import { requireCustomer } from './chunk-3BDDYX3V.js';
+
+// src/services/segment.ts
+function setIfDefined(q, key, value) {
+  if (value !== void 0 && value !== "") {
+    q[key] = value;
+  }
+}
+var SERVICE = { kind: "service" };
+var SegmentService = class {
+  constructor(ctx, deps) {
+    this.ctx = ctx;
+    this.deps = deps;
+  }
+  ctx;
+  deps;
+  static channel = "segment";
+  static deps = ["products", "categories"];
+  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 };
+  }
+  // --- Admin CRUD (segment_manage). Default auth: service. ---
+  /** Creates a segment. Default auth: service. */
+  async create(input, authCtx = SERVICE) {
+    return this.ctx.http.request({ method: "POST", path: this.base(), auth: authCtx, body: input });
+  }
+  /** Searches segments (POST body). Default auth: service. */
+  async search(query, authCtx = SERVICE) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: `${this.base()}/search`,
+      auth: authCtx,
+      body: query
+    });
+  }
+  /** Full-replaces a segment (PUT). Default auth: service. */
+  async update(segmentId, input, authCtx = SERVICE) {
+    return this.ctx.http.request({
+      method: "PUT",
+      path: `${this.base()}/${segmentId}`,
+      auth: authCtx,
+      body: input
+    });
+  }
+  /** Partially updates a segment (PATCH). Default auth: service. */
+  async patch(segmentId, input, authCtx = SERVICE) {
+    return this.ctx.http.request({
+      method: "PATCH",
+      path: `${this.base()}/${segmentId}`,
+      auth: authCtx,
+      body: input
+    });
+  }
+  /** Deletes a segment. Default auth: service. */
+  async delete(segmentId, authCtx = SERVICE) {
+    await this.ctx.http.request({
+      method: "DELETE",
+      path: `${this.base()}/${segmentId}`,
+      auth: authCtx
+    });
+  }
+  /** Checks which segments the given items/customers match. Default auth: service. */
+  async match(input, authCtx = SERVICE) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: `${this.base()}/match`,
+      auth: authCtx,
+      body: input
+    });
+  }
+  /** Creates multiple segments. Default auth: service. */
+  async bulkCreate(inputs, authCtx = SERVICE) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: `${this.base()}/bulk`,
+      auth: authCtx,
+      body: inputs
+    });
+  }
+  /** Upserts multiple segments (PUT). Default auth: service. */
+  async bulkUpdate(inputs, authCtx = SERVICE) {
+    return this.ctx.http.request({
+      method: "PUT",
+      path: `${this.base()}/bulk`,
+      auth: authCtx,
+      body: inputs
+    });
+  }
+  /** Deletes multiple segments (DELETE with a body of ids). Default auth: service. */
+  async bulkDelete(body, authCtx = SERVICE) {
+    return this.ctx.http.request({
+      method: "DELETE",
+      path: `${this.base()}/bulk`,
+      auth: authCtx,
+      body
+    });
+  }
+  /** Customer→segment assignments (`segment_manage`). Default auth: service. */
+  customers = {
+    list: async (segmentId, query, authCtx = SERVICE) => this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/${segmentId}/customers`,
+      auth: authCtx,
+      ...query ? { query } : {}
+    }),
+    search: async (segmentId, query, authCtx = SERVICE) => this.ctx.http.request({
+      method: "POST",
+      path: `${this.base()}/${segmentId}/customers/search`,
+      auth: authCtx,
+      body: query
+    }),
+    get: async (segmentId, customerId, authCtx = SERVICE) => this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/${segmentId}/customers/${customerId}`,
+      auth: authCtx
+    }),
+    assign: async (segmentId, customerId, input, authCtx = SERVICE) => this.ctx.http.request({
+      method: "PUT",
+      path: `${this.base()}/${segmentId}/customers/${customerId}`,
+      auth: authCtx,
+      body: input
+    }),
+    remove: async (segmentId, customerId, authCtx = SERVICE) => {
+      await this.ctx.http.request({
+        method: "DELETE",
+        path: `${this.base()}/${segmentId}/customers/${customerId}`,
+        auth: authCtx
+      });
+    },
+    getForEntity: async (segmentId, customerId, legalEntityId, authCtx = SERVICE) => this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/${segmentId}/customers/${customerId}/${legalEntityId}`,
+      auth: authCtx
+    }),
+    assignForEntity: async (segmentId, customerId, legalEntityId, input, authCtx = SERVICE) => this.ctx.http.request({
+      method: "PUT",
+      path: `${this.base()}/${segmentId}/customers/${customerId}/${legalEntityId}`,
+      auth: authCtx,
+      body: input
+    }),
+    removeForEntity: async (segmentId, customerId, legalEntityId, authCtx = SERVICE) => {
+      await this.ctx.http.request({
+        method: "DELETE",
+        path: `${this.base()}/${segmentId}/customers/${customerId}/${legalEntityId}`,
+        auth: authCtx
+      });
+    },
+    bulkAssign: async (segmentId, inputs, authCtx = SERVICE) => this.ctx.http.request({
+      method: "PUT",
+      path: `${this.base()}/${segmentId}/customers/bulk`,
+      auth: authCtx,
+      body: inputs
+    }),
+    bulkRemove: async (segmentId, body, authCtx = SERVICE) => this.ctx.http.request({
+      method: "DELETE",
+      path: `${this.base()}/${segmentId}/customers/bulk`,
+      auth: authCtx,
+      body
+    })
+  };
+  /** Item→segment assignments (`type` = PRODUCT | CATEGORY). Default auth: service. */
+  items = {
+    search: async (segmentId, query, authCtx = SERVICE) => this.ctx.http.request({
+      method: "POST",
+      path: `${this.base()}/${segmentId}/items/search`,
+      auth: authCtx,
+      body: query
+    }),
+    get: async (segmentId, type, itemId, authCtx = SERVICE) => this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/${segmentId}/items/${type}/${itemId}`,
+      auth: authCtx
+    }),
+    assign: async (segmentId, type, itemId, input, authCtx = SERVICE) => this.ctx.http.request({
+      method: "PUT",
+      path: `${this.base()}/${segmentId}/items/${type}/${itemId}`,
+      auth: authCtx,
+      body: input
+    }),
+    remove: async (segmentId, type, itemId, authCtx = SERVICE) => {
+      await this.ctx.http.request({
+        method: "DELETE",
+        path: `${this.base()}/${segmentId}/items/${type}/${itemId}`,
+        auth: authCtx
+      });
+    },
+    bulkAssign: async (segmentId, type, inputs, authCtx = SERVICE) => this.ctx.http.request({
+      method: "PUT",
+      path: `${this.base()}/${segmentId}/items/${type}/bulk`,
+      auth: authCtx,
+      body: inputs
+    }),
+    bulkRemove: async (segmentId, type, body, authCtx = SERVICE) => this.ctx.http.request({
+      method: "DELETE",
+      path: `${this.base()}/${segmentId}/items/${type}/bulk`,
+      auth: authCtx,
+      body
+    })
+  };
+};
+
+export { SegmentService };
+//# sourceMappingURL=chunk-W2KBVWJ2.js.map
+//# sourceMappingURL=chunk-W2KBVWJ2.js.map

package/dist/chunk-W2KBVWJ2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/services/segment.ts"],"names":[],"mappings":"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","file":"chunk-W2KBVWJ2.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  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  // --- 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"]}