@viu/emporix-sdk 2.21.0 → 2.23.0

package/dist/chunk-PRN3T6TY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/services/customer.ts"],"names":[],"mappings":"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","file":"chunk-PRN3T6TY.js","sourcesContent":["import type { ClientContext } from \"../core/context\";\nimport type { AuthContext, AnonymousSession } from \"../core/auth\";\nimport { EmporixAuthError } from \"../core/errors\";\nimport { requireCustomer } from \"../core/require-customer\";\nimport type {\n  Customer as GeneratedCustomer,\n  Address as GeneratedAddress,\n  CustomerSignup,\n  CustomerUpdateDto,\n  PasswordChangeDto,\n  PasswordResetRequestDto,\n  PasswordUpdate,\n  AddressCreateDto,\n  AddressUpdateDto,\n  ChangeEmailRequestDto,\n  UpdateEmail,\n  RefreshToken,\n} from \"../generated/customer\";\n\n/**\n * Caller-owned customer session. Maps the Emporix `CustomerToken` wire shape to\n * idiomatic names: `access_token` → `customerToken`, `saas_token` →\n * `saasToken`. `saasToken` is a JWT required for the checkout (`saas-token`\n * header). The wire's `*_token` (snake_case) fields are canonical; the\n * camelCase variants are deprecated in the Emporix spec.\n */\nexport interface CustomerSession {\n  customerToken: string;\n  /** JWT required for completing checkout (sent as the `saas-token` header). */\n  saasToken: string;\n  refreshToken: string;\n  /** Same session as the anonymous token — preserves the cart across login. */\n  sessionId: string | undefined;\n  /** Customer access-token lifetime in seconds. */\n  expiresIn: number | undefined;\n  /** Only set by `socialLogin`: the IdP access token echoed by Emporix. */\n  socialAccessToken?: string;\n  /** Only set by `socialLogin`: the IdP ID token echoed by Emporix. */\n  socialIdToken?: string;\n}\n\n/** Customer profile as returned by the Customer service (all generated fields). */\nexport type Customer = GeneratedCustomer;\n\n/** A customer address as returned by the Customer service (all generated fields). */\nexport type Address = GeneratedAddress;\n\n/** Generated request bodies (caller sends the exact wire shape). */\nexport type CustomerSignupInput = CustomerSignup;\nexport type CustomerUpdateInput = CustomerUpdateDto;\nexport type PasswordChangeInput = PasswordChangeDto;\nexport type PasswordResetRequestInput = PasswordResetRequestDto;\nexport type PasswordResetConfirmInput = PasswordUpdate;\nexport type AddressCreateInput = AddressCreateDto;\nexport type AddressUpdateInput = AddressUpdateDto;\nexport type ChangeEmailInput = ChangeEmailRequestDto;\nexport type ConfirmEmailChangeInput = UpdateEmail;\nexport type ResendActivationInput = RefreshToken;\n\n/** Union of the wire shapes the four session endpoints return. snake_case is\n * canonical; camelCase is the deprecated fallback (vendored spec, design §2). */\ninterface WireSession {\n  access_token?: string;\n  saas_token?: string;\n  refresh_token?: string;\n  session_id?: string;\n  expires_in?: string | number;\n  accessToken?: string;\n  saasToken?: string;\n  refreshToken?: string;\n  social_access_token?: string;\n  social_id_token?: string;\n}\n\n/** Wire→facade mapping shared by login/refresh/socialLogin/exchangeToken.\n * Throws instead of fabricating an empty session: `customerToken: \"\"` would\n * read as authenticated downstream and 401-loop every subsequent call. */\nfunction toSession(\n  endpoint: string,\n  wire: WireSession,\n  opts: { carrySaasToken?: string } = {},\n): CustomerSession {\n  const customerToken = wire.access_token ?? wire.accessToken;\n  if (!customerToken) {\n    throw new EmporixAuthError(`${endpoint}: response missing access_token`, undefined, wire);\n  }\n  return {\n    customerToken,\n    saasToken: wire.saas_token ?? wire.saasToken ?? opts.carrySaasToken ?? \"\",\n    refreshToken: wire.refresh_token ?? wire.refreshToken ?? \"\",\n    sessionId: wire.session_id,\n    expiresIn: wire.expires_in != null ? Number(wire.expires_in) : undefined,\n    ...(wire.social_access_token ? { socialAccessToken: wire.social_access_token } : {}),\n    ...(wire.social_id_token ? { socialIdToken: wire.social_id_token } : {}),\n  };\n}\n\n/** Customer signup, session, profile and addresses. */\nexport class CustomerService {\n  static readonly channel = \"customer\" as const;\n  constructor(private readonly ctx: ClientContext) {}\n\n  /** Obtains an anonymous storefront session (accessToken + sessionId + refreshToken). */\n  async anonymous(): Promise<AnonymousSession> {\n    return this.ctx.tokenProvider.getAnonymousToken();\n  }\n\n  /** Registers a customer. Default auth: anonymous. */\n  async signup(\n    input: CustomerSignupInput,\n    auth: AuthContext = { kind: \"anonymous\" },\n  ): Promise<Customer> {\n    return this.ctx.http.request<Customer>({\n      method: \"POST\",\n      path: `/customer/${this.ctx.tenant}/signup`,\n      auth,\n      body: input,\n    });\n  }\n\n  /**\n   * Logs a customer in. Threads the anonymous token so the session (and its\n   * cart) survives — losing it silently creates a new session per Emporix docs.\n   * Wire `accessToken` is mapped to `customerToken`.\n   */\n  async login(\n    creds: { email: string; password: string },\n    opts: { anonymousToken?: string } = {},\n    auth: AuthContext = { kind: \"anonymous\" },\n  ): Promise<CustomerSession> {\n    const effective: AuthContext = opts.anonymousToken\n      ? { kind: \"raw\", token: opts.anonymousToken }\n      : auth;\n    const wire = await this.ctx.http.request<WireSession>({\n      method: \"POST\",\n      path: `/customer/${this.ctx.tenant}/login`,\n      auth: effective,\n      body: creds,\n    });\n    return toSession(\"login\", wire);\n  }\n\n  /**\n   * Refreshes an authenticated customer session via its refresh token,\n   * preserving the same `sessionId`. Calls\n   * `GET /customer/{tenant}/refreshauthtoken?refreshToken=…`, which **must be\n   * authorized with an anonymous token** (default auth: anonymous) — not the\n   * expired customer token. The refresh response does **not** include a\n   * `saas_token`; pass the original `saasToken` to carry it forward (it has\n   * its own, independent lifetime).\n   */\n  async refresh(\n    input: { refreshToken: string; saasToken?: string; legalEntityId?: string },\n    auth: AuthContext = { kind: \"anonymous\" },\n  ): Promise<CustomerSession> {\n    const query: Record<string, string> = { refreshToken: input.refreshToken };\n    if (input.legalEntityId) query.legalEntityId = input.legalEntityId;\n    const wire = await this.ctx.http.request<WireSession>({\n      method: \"GET\",\n      path: `/customer/${this.ctx.tenant}/refreshauthtoken`,\n      query,\n      auth,\n    });\n    // Refresh does not return a saas_token — carry the original forward.\n    return toSession(\n      \"refresh\",\n      wire,\n      input.saasToken !== undefined ? { carrySaasToken: input.saasToken } : {},\n    );\n  }\n\n  /**\n   * Logs the customer out server-side: `GET /customer/{tenant}/logout?\n   * accessToken=…` authorized with the customer token. Invalidates the\n   * access token (204 No Content). Requires customer/raw auth — the token is\n   * sent both as the bearer and the `accessToken` query param (per Emporix).\n   */\n  async logout(auth?: AuthContext): Promise<void> {\n    const ctx = requireCustomer(auth);\n    const token = (ctx as { token: string }).token;\n    await this.ctx.http.request<void>({\n      method: \"GET\",\n      path: `/customer/${this.ctx.tenant}/logout`,\n      query: { accessToken: token },\n      auth: ctx,\n    });\n  }\n\n  /**\n   * Authorization-Code SSO: exchanges the IdP `code` for an Emporix customer\n   * session via `POST /customer/{tenant}/socialLogin`. The browser performs\n   * the IdP redirect itself; the SDK only does this Emporix exchange.\n   * Default auth: anonymous (Emporix requires an anonymous Bearer). The\n   * response has no `session_id` and returns `expires_in` as a string —\n   * normalized to a number here.\n   */\n  async socialLogin(\n    input: { code: string; redirectUri: string; codeVerifier?: string; sessionId?: string },\n    auth: AuthContext = { kind: \"anonymous\" },\n  ): Promise<CustomerSession> {\n    const query: Record<string, string> = {\n      code: input.code,\n      redirect_uri: input.redirectUri,\n    };\n    if (input.codeVerifier) query.code_verifier = input.codeVerifier;\n    const wire = await this.ctx.http.request<WireSession>({\n      method: \"POST\",\n      path: `/customer/${this.ctx.tenant}/socialLogin`,\n      query,\n      auth,\n      ...(input.sessionId ? { headers: { \"session-id\": input.sessionId } } : {}),\n    });\n    return toSession(\"socialLogin\", wire);\n  }\n\n  /**\n   * RFC 8693 token exchange: exchanges an external IdP JWT for an Emporix\n   * customer session via `POST /customer/{tenant}/exchangeauthtoken`.\n   * Emporix uses a proprietary query-param wire (not the RFC form body).\n   * Default auth: anonymous. `config` selects a site-specific IdP config\n   * (multi-site); omit for the tenant default. Returns `session_id` and a\n   * fresh `saas_token`; `expires_in` is an integer (normalized anyway).\n   */\n  async exchangeToken(\n    input: { subjectToken: string; config?: string },\n    auth: AuthContext = { kind: \"anonymous\" },\n  ): Promise<CustomerSession> {\n    const query: Record<string, string> = { subjectAccessToken: input.subjectToken };\n    if (input.config) query.config = input.config;\n    const wire = await this.ctx.http.request<WireSession>({\n      method: \"POST\",\n      path: `/customer/${this.ctx.tenant}/exchangeauthtoken`,\n      query,\n      auth,\n    });\n    return toSession(\"exchangeToken\", wire);\n  }\n\n  /** Returns the authenticated customer. Requires customer/raw auth. */\n  async me(auth?: AuthContext): Promise<Customer> {\n    return this.ctx.http.request<Customer>({\n      method: \"GET\",\n      path: `/customer/${this.ctx.tenant}/me`,\n      auth: requireCustomer(auth),\n    });\n  }\n\n  /** Updates the authenticated customer. Requires customer/raw auth. */\n  async update(patch: CustomerUpdateInput, auth?: AuthContext): Promise<Customer> {\n    return this.ctx.http.request<Customer>({\n      method: \"PUT\",\n      path: `/customer/${this.ctx.tenant}/me`,\n      auth: requireCustomer(auth),\n      body: patch,\n    });\n  }\n\n  /** Changes the password. Requires customer/raw auth. */\n  async changePassword(input: PasswordChangeInput, auth?: AuthContext): Promise<void> {\n    await this.ctx.http.request<void>({\n      method: \"POST\",\n      path: `/customer/${this.ctx.tenant}/password/change`,\n      auth: requireCustomer(auth),\n      body: input,\n    });\n  }\n\n  /** Requests a password reset email. Default auth: anonymous. */\n  async requestPasswordReset(\n    input: PasswordResetRequestInput,\n    auth: AuthContext = { kind: \"anonymous\" },\n  ): Promise<void> {\n    await this.ctx.http.request<void>({\n      method: \"POST\",\n      path: `/customer/${this.ctx.tenant}/password/reset`,\n      auth,\n      body: input,\n    });\n  }\n\n  /** Confirms a password reset. Default auth: anonymous. */\n  async confirmPasswordReset(\n    input: PasswordResetConfirmInput,\n    auth: AuthContext = { kind: \"anonymous\" },\n  ): Promise<void> {\n    await this.ctx.http.request<void>({\n      method: \"POST\",\n      path: `/customer/${this.ctx.tenant}/password/reset/update`,\n      auth,\n      body: input,\n    });\n  }\n\n  /**\n   * Completes double opt-in signup with the emailed token, creating the account\n   * and returning a logged-in {@link CustomerSession}. Default auth: anonymous.\n   */\n  async confirmSignup(\n    token: string,\n    auth: AuthContext = { kind: \"anonymous\" },\n  ): Promise<CustomerSession> {\n    const wire = await this.ctx.http.request<WireSession>({\n      method: \"GET\",\n      path: `/customer/${this.ctx.tenant}/signup/optin/${encodeURIComponent(token)}`,\n      auth,\n    });\n    return toSession(\"confirmSignup\", wire);\n  }\n\n  /** Resends the double opt-in activation link. Default auth: anonymous. */\n  async resendActivation(\n    input: ResendActivationInput,\n    auth: AuthContext = { kind: \"anonymous\" },\n  ): Promise<void> {\n    await this.ctx.http.request<void>({\n      method: \"POST\",\n      path: `/customer/${this.ctx.tenant}/signup/optin/refresh_token`,\n      auth,\n      body: input,\n    });\n  }\n\n  /** Requests a login-email change (emails a confirmation token). Requires customer/raw auth. */\n  async changeEmail(input: ChangeEmailInput, auth?: AuthContext): Promise<void> {\n    await this.ctx.http.request<void>({\n      method: \"POST\",\n      path: `/customer/${this.ctx.tenant}/me/accounts/internal/email/change`,\n      auth: requireCustomer(auth),\n      body: input,\n    });\n  }\n\n  /** Confirms a login-email change with the emailed token. Default auth: anonymous. */\n  async confirmEmailChange(\n    input: ConfirmEmailChangeInput,\n    auth: AuthContext = { kind: \"anonymous\" },\n  ): Promise<void> {\n    await this.ctx.http.request<void>({\n      method: \"POST\",\n      path: `/customer/${this.ctx.tenant}/me/accounts/internal/email/change/confirm`,\n      auth,\n      body: input,\n    });\n  }\n\n  /** Address sub-resource. All operations require customer/raw auth. */\n  readonly addresses = {\n    list: async (auth?: AuthContext): Promise<Address[]> =>\n      this.ctx.http.request<Address[]>({\n        method: \"GET\",\n        path: `/customer/${this.ctx.tenant}/me/addresses`,\n        auth: requireCustomer(auth),\n      }),\n    add: async (address: AddressCreateInput, auth?: AuthContext): Promise<Address> =>\n      this.ctx.http.request<Address>({\n        method: \"POST\",\n        path: `/customer/${this.ctx.tenant}/me/addresses`,\n        auth: requireCustomer(auth),\n        body: address,\n      }),\n    update: async (id: string, patch: AddressUpdateInput, auth?: AuthContext): Promise<Address> =>\n      this.ctx.http.request<Address>({\n        method: \"PUT\",\n        path: `/customer/${this.ctx.tenant}/me/addresses/${id}`,\n        auth: requireCustomer(auth),\n        body: patch,\n      }),\n    remove: async (id: string, auth?: AuthContext): Promise<void> =>\n      this.ctx.http.request<void>({\n        method: \"DELETE\",\n        path: `/customer/${this.ctx.tenant}/me/addresses/${id}`,\n        auth: requireCustomer(auth),\n      }),\n    get: async (id: string, auth?: AuthContext): Promise<Address> =>\n      this.ctx.http.request<Address>({\n        method: \"GET\",\n        path: `/customer/${this.ctx.tenant}/me/addresses/${id}`,\n        auth: requireCustomer(auth),\n      }),\n    addTags: async (id: string, tags: string[], auth?: AuthContext): Promise<void> => {\n      await this.ctx.http.request<void>({\n        method: \"POST\",\n        path: `/customer/${this.ctx.tenant}/me/addresses/${id}/tags`,\n        query: { tags: tags.join(\",\") },\n        auth: requireCustomer(auth),\n      });\n    },\n    removeTags: async (id: string, tags: string[], auth?: AuthContext): Promise<void> => {\n      await this.ctx.http.request<void>({\n        method: \"DELETE\",\n        path: `/customer/${this.ctx.tenant}/me/addresses/${id}/tags`,\n        query: { tags: tags.join(\",\") },\n        auth: requireCustomer(auth),\n      });\n    },\n  };\n}\n"]}

package/dist/{chunk-44F52KRE.js → chunk-QQMLN76U.js}

@@ -55,8 +55,33 @@ var CompaniesService = class {
       auth
     });
   }
+  /**
+   * Searches legal entities via `POST /legal-entities/search` with an Emporix
+   * `q`-syntax filter body. Requires the same read scope as {@link listMine}.
+   */
+  async search(query, auth) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: `${this.base()}/search`,
+      auth,
+      body: query,
+      idempotent: true
+      // pure read over POST — safe to replay on 5xx/429
+    });
+  }
+  /**
+   * Retrieves a legal entity's chain of parent entities
+   * (`GET /legal-entities/{id}/parent-hierarchy`).
+   */
+  async parentHierarchy(legalEntityId, auth) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/${legalEntityId}/parent-hierarchy`,
+      auth
+    });
+  }
 };
 
 export { CompaniesService };
-//# sourceMappingURL=chunk-44F52KRE.js.map
-//# sourceMappingURL=chunk-44F52KRE.js.map
+//# sourceMappingURL=chunk-QQMLN76U.js.map
+//# sourceMappingURL=chunk-QQMLN76U.js.map

package/dist/chunk-QQMLN76U.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/services/companies.ts"],"names":[],"mappings":"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","file":"chunk-QQMLN76U.js","sourcesContent":["import type { ClientContext } from \"../core/context\";\nimport type { AuthContext } from \"../core/auth\";\nimport type {\n  LegalEntity,\n  LegalEntityCreate,\n  LegalEntityUpdate,\n} from \"../generated/customer-management\";\n\n/** Body for `companies.search` — an Emporix `q`-syntax filter. */\nexport type LegalEntitySearchInput = { q?: string };\n\n/**\n * Storefront-customer access to Legal Entities.\n *\n * `listMine`/`get` require `customermanagement.legalentity_read_own` on the\n * customer token. `create`/`update`/`delete` require the corresponding\n * `_manage` scopes — typically only granted to Admin-group customers; a 403\n * surfaces as `EmporixInsufficientScopeError`.\n */\nexport class CompaniesService {\n  static readonly channel = \"customer-management\" as const;\n  constructor(private readonly ctx: ClientContext) {}\n\n  private base(): string {\n    return `/customer-management/${this.ctx.tenant}/legal-entities`;\n  }\n\n  /** Lists the legal entities the calling customer is assigned to. */\n  async listMine(auth: AuthContext): Promise<LegalEntity[]> {\n    return this.ctx.http.request<LegalEntity[]>({\n      method: \"GET\",\n      path: this.base(),\n      auth,\n    });\n  }\n\n  /** Fetches a single legal entity by id. */\n  async get(legalEntityId: string, auth: AuthContext): Promise<LegalEntity> {\n    return this.ctx.http.request<LegalEntity>({\n      method: \"GET\",\n      path: `${this.base()}/${legalEntityId}`,\n      auth,\n    });\n  }\n\n  /** Creates a legal entity. Requires `customermanagement.legalentity_manage`. */\n  async create(input: LegalEntityCreate, auth: AuthContext): Promise<{ id: string }> {\n    return this.ctx.http.request<{ id: string }>({\n      method: \"POST\",\n      path: this.base(),\n      auth,\n      body: input,\n    });\n  }\n\n  /**\n   * Updates a legal entity via `PUT …/legal-entities/{id}` (upsert / full\n   * replace). The live API rejects `PATCH` on this path with 405; send the\n   * complete entity, as the server replaces the resource. The body stays typed\n   * as a partial of `LegalEntityUpdate` for backward compatibility.\n   */\n  async update(\n    legalEntityId: string,\n    patch: Partial<LegalEntityUpdate>,\n    auth: AuthContext,\n  ): Promise<LegalEntity> {\n    return this.ctx.http.request<LegalEntity>({\n      method: \"PUT\",\n      path: `${this.base()}/${legalEntityId}`,\n      auth,\n      body: patch,\n    });\n  }\n\n  /** Deletes a legal entity (async cascade on the server). */\n  async delete(legalEntityId: string, auth: AuthContext): Promise<void> {\n    await this.ctx.http.request<void>({\n      method: \"DELETE\",\n      path: `${this.base()}/${legalEntityId}`,\n      auth,\n    });\n  }\n\n  /**\n   * Searches legal entities via `POST /legal-entities/search` with an Emporix\n   * `q`-syntax filter body. Requires the same read scope as {@link listMine}.\n   */\n  async search(query: LegalEntitySearchInput, auth: AuthContext): Promise<LegalEntity[]> {\n    return this.ctx.http.request<LegalEntity[]>({\n      method: \"POST\",\n      path: `${this.base()}/search`,\n      auth,\n      body: query,\n      idempotent: true, // pure read over POST — safe to replay on 5xx/429\n    });\n  }\n\n  /**\n   * Retrieves a legal entity's chain of parent entities\n   * (`GET /legal-entities/{id}/parent-hierarchy`).\n   */\n  async parentHierarchy(legalEntityId: string, auth: AuthContext): Promise<LegalEntity[]> {\n    return this.ctx.http.request<LegalEntity[]>({\n      method: \"GET\",\n      path: `${this.base()}/${legalEntityId}/parent-hierarchy`,\n      auth,\n    });\n  }\n}\n"]}

package/dist/chunk-UNW6SFSB.js

@@ -0,0 +1,363 @@
+import { iterateAll } from './chunk-GWJ2U2CP.js';
+import { resolveQuery } from './chunk-S5HEIQDK.js';
+
+// src/services/product.ts
+var ANON = { kind: "anonymous" };
+var SERVICE = { kind: "service" };
+var ProductService = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  ctx;
+  static channel = "product";
+  /** Fetches one product by id. */
+  async get(productId, _opts, auth = ANON) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `/product/${this.ctx.tenant}/products/${productId}`,
+      auth
+    });
+  }
+  /** Fetches one product by its code. */
+  async getByCode(code, auth = ANON) {
+    const rows = await this.ctx.http.request({
+      method: "GET",
+      path: `/product/${this.ctx.tenant}/products`,
+      query: { q: `code:${code}` },
+      auth
+    });
+    const first = rows[0];
+    if (!first) throw new Error(`No product with code "${code}"`);
+    return first;
+  }
+  /** One page of products. */
+  async list(params = {}, auth = ANON) {
+    const pageNumber = params.pageNumber ?? 1;
+    const pageSize = params.pageSize ?? 50;
+    const items = await this.ctx.http.request({
+      method: "GET",
+      path: `/product/${this.ctx.tenant}/products`,
+      query: { pageNumber, pageSize },
+      auth
+    });
+    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };
+  }
+  /** Async-iterates every product across pages. */
+  listAll(params = {}, auth = ANON) {
+    const pageSize = params.pageSize ?? 50;
+    return iterateAll((pageNumber) => this.list({ pageNumber, pageSize }, auth));
+  }
+  /**
+   * Searches products by a `q` filter — a raw Emporix DSL string or a built
+   * filter (e.g. `@viu/emporix-mixins`' `mixinQuery(...)`). Product supports
+   * `compoundLogicalQuery`, so `or()` filters are allowed.
+   */
+  async search(query, params = {}, auth = ANON) {
+    const q = resolveQuery(query, { compoundLogicalQuery: true });
+    const pageNumber = params.pageNumber ?? 1;
+    const pageSize = params.pageSize ?? 50;
+    const items = await this.ctx.http.request({
+      method: "GET",
+      path: `/product/${this.ctx.tenant}/products`,
+      query: { q, pageNumber, pageSize },
+      auth
+    });
+    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };
+  }
+  /**
+   * Free-text product search by name. The product `q` is a `field:value` DSL,
+   * so a bare term (e.g. "in time") 400s with "No value for key …". This builds
+   * a `name:(~<term>)` regex filter (regex metacharacters escaped) and delegates
+   * to {@link search}.
+   */
+  async searchByName(query, params = {}, auth = ANON) {
+    const escaped = query.trim().replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    return this.search(`name:(~${escaped})`, params, auth);
+  }
+  /**
+   * Bulk fetch by id. POSTs `/products/search` with `q="id:(id1,id2,…)"`,
+   * chunking when the list is larger than `options.chunkSize` (default
+   * 100). An empty list short-circuits with no HTTP call. **Order is not
+   * guaranteed** across chunks — re-index by `id` if order matters.
+   */
+  async searchByIds(ids, options = {}, auth = ANON) {
+    if (ids.length === 0) return [];
+    const chunkSize = options.chunkSize ?? 100;
+    const chunks = [];
+    for (let i = 0; i < ids.length; i += chunkSize) {
+      chunks.push(ids.slice(i, i + chunkSize));
+    }
+    const pages = await Promise.all(
+      chunks.map(
+        (chunk) => this.ctx.http.request({
+          method: "POST",
+          path: `/product/${this.ctx.tenant}/products/search`,
+          query: { pageSize: chunk.length },
+          auth,
+          body: { q: `id:(${chunk.join(",")})` },
+          idempotent: true
+          // pure read over POST — safe to replay on 5xx/429
+        })
+      )
+    );
+    return pages.flat();
+  }
+  /**
+   * Bulk fetch by code. POSTs `/products/search` with `q="code:(c1,c2,…)"`,
+   * chunking when the list is larger than `options.chunkSize` (default 100).
+   * Duplicate codes are de-duplicated. Codes containing query-delimiter
+   * characters (`(`, `)`, `,`, whitespace, `"`) are dropped with a logged
+   * warning, because the Emporix `q` syntax uses them as delimiters and does
+   * not support escaping them in a plain IN-list. An empty list — or one with
+   * no safe codes — short-circuits with no HTTP call. **Order is not
+   * guaranteed** across chunks — re-index by `code` if order matters.
+   */
+  async searchByCodes(codes, options = {}, auth = ANON) {
+    const unique = [...new Set(codes)];
+    const unsafe = /[(),"\s]/;
+    const safe = unique.filter((c) => !unsafe.test(c));
+    const dropped = unique.filter((c) => unsafe.test(c));
+    if (dropped.length > 0) {
+      this.ctx.logger.warn(
+        "products.searchByCodes: dropped codes containing query-delimiter characters",
+        { dropped }
+      );
+    }
+    if (safe.length === 0) return [];
+    const chunkSize = options.chunkSize ?? 100;
+    const chunks = [];
+    for (let i = 0; i < safe.length; i += chunkSize) {
+      chunks.push(safe.slice(i, i + chunkSize));
+    }
+    const pages = await Promise.all(
+      chunks.map(
+        (chunk) => this.ctx.http.request({
+          method: "POST",
+          path: `/product/${this.ctx.tenant}/products/search`,
+          query: { pageSize: chunk.length },
+          auth,
+          body: { q: `code:(${chunk.join(",")})` },
+          idempotent: true
+          // pure read over POST — safe to replay on 5xx/429
+        })
+      )
+    );
+    return pages.flat();
+  }
+  /**
+   * Streams the VARIANT children of a PARENT_VARIANT product, page by page,
+   * via the search query `productType:VARIANT parentVariantId:<id>`. Default
+   * pageSize 200. The query syntax (space-separated fields = implicit AND) is
+   * encapsulated here so consumers don't build it themselves.
+   */
+  listVariantChildrenAll(parentVariantId, params = {}, auth = ANON) {
+    const pageSize = params.pageSize ?? 200;
+    const q = `productType:VARIANT parentVariantId:${parentVariantId}`;
+    return iterateAll((pageNumber) => this.search(q, { pageNumber, pageSize }, auth));
+  }
+  /**
+   * Resolves ALL VARIANT children of a PARENT_VARIANT product into a flat
+   * array (loads every page). Default pageSize 200. Returns `[]` when there are
+   * no children — never throws.
+   */
+  async listVariantChildren(parentVariantId, params = {}, auth = ANON) {
+    const out = [];
+    for await (const child of this.listVariantChildrenAll(parentVariantId, params, auth)) {
+      out.push(child);
+    }
+    return out;
+  }
+  // --- Admin writes. Default auth: service. ---
+  /**
+   * Creates a product (`POST /products`). Default auth: service. Accepts any of
+   * the five product shapes (basic, bundle, parent-variant, variant,
+   * dynamic-variant).
+   */
+  async create(input, options = {}, auth = SERVICE) {
+    const query = {
+      ...options.skipVariantGeneration === void 0 ? {} : { skipVariantGeneration: String(options.skipVariantGeneration) },
+      ...options.doIndex === void 0 ? {} : { doIndex: String(options.doIndex) },
+      ...options.skipRelatedItemsValidation === void 0 ? {} : { skipRelatedItemsValidation: String(options.skipRelatedItemsValidation) }
+    };
+    return this.ctx.http.request({
+      method: "POST",
+      path: `/product/${this.ctx.tenant}/products`,
+      ...Object.keys(query).length > 0 ? { query } : {},
+      body: input,
+      auth
+    });
+  }
+  /**
+   * Partially updates a product (`PATCH /products/{productId}`). Default auth:
+   * service. Use {@link replace} for a full replace (PUT).
+   */
+  async update(productId, input, options = {}, auth = SERVICE) {
+    const query = {
+      ...options.skipVariantGeneration === void 0 ? {} : { skipVariantGeneration: String(options.skipVariantGeneration) },
+      ...options.doIndex === void 0 ? {} : { doIndex: String(options.doIndex) },
+      ...options.skipRelatedItemsValidation === void 0 ? {} : { skipRelatedItemsValidation: String(options.skipRelatedItemsValidation) }
+    };
+    await this.ctx.http.request({
+      method: "PATCH",
+      path: `/product/${this.ctx.tenant}/products/${productId}`,
+      ...Object.keys(query).length > 0 ? { query } : {},
+      body: input,
+      auth
+    });
+  }
+  /**
+   * Full-replaces a product (`PUT /products/{productId}`). Returns the created
+   * resource on 201 (upsert) and nothing on 204. `options.partial` sends
+   * `?partial=true` for a merge-style replace. Default auth: service.
+   */
+  async replace(productId, input, options = {}, auth = SERVICE) {
+    const query = {
+      ...options.partial === void 0 ? {} : { partial: String(options.partial) },
+      ...options.skipVariantGeneration === void 0 ? {} : { skipVariantGeneration: String(options.skipVariantGeneration) },
+      ...options.doIndex === void 0 ? {} : { doIndex: String(options.doIndex) },
+      ...options.skipRelatedItemsValidation === void 0 ? {} : { skipRelatedItemsValidation: String(options.skipRelatedItemsValidation) }
+    };
+    return this.ctx.http.request({
+      method: "PUT",
+      path: `/product/${this.ctx.tenant}/products/${productId}`,
+      ...Object.keys(query).length > 0 ? { query } : {},
+      body: input,
+      auth
+    });
+  }
+  /**
+   * Deletes a product (`DELETE /products/{productId}`). `options.force` deletes
+   * even when the product is referenced. Default auth: service.
+   */
+  async delete(productId, options = {}, auth = SERVICE) {
+    const query = {
+      ...options.force === void 0 ? {} : { force: String(options.force) },
+      ...options.doIndex === void 0 ? {} : { doIndex: String(options.doIndex) }
+    };
+    await this.ctx.http.request({
+      method: "DELETE",
+      path: `/product/${this.ctx.tenant}/products/${productId}`,
+      ...Object.keys(query).length > 0 ? { query } : {},
+      auth
+    });
+  }
+  /**
+   * Bulk-creates products (`POST /products/bulk`). Responds 207 Multi-Status:
+   * partial failures do **not** throw — inspect each entry. Default auth: service.
+   */
+  async bulkCreate(input, options = {}, auth = SERVICE) {
+    const query = {
+      ...options.skipVariantGeneration === void 0 ? {} : { skipVariantGeneration: String(options.skipVariantGeneration) },
+      ...options.doIndex === void 0 ? {} : { doIndex: String(options.doIndex) },
+      ...options.skipRelatedItemsValidation === void 0 ? {} : { skipRelatedItemsValidation: String(options.skipRelatedItemsValidation) }
+    };
+    return this.ctx.http.request({
+      method: "POST",
+      path: `/product/${this.ctx.tenant}/products/bulk`,
+      ...Object.keys(query).length > 0 ? { query } : {},
+      body: input,
+      auth
+    });
+  }
+  /**
+   * Bulk-updates products (`PUT /products/bulk`). Responds 207 Multi-Status:
+   * partial failures do **not** throw — inspect each entry. Default auth: service.
+   */
+  async bulkUpdate(input, options = {}, auth = SERVICE) {
+    const query = {
+      ...options.skipVariantGeneration === void 0 ? {} : { skipVariantGeneration: String(options.skipVariantGeneration) },
+      ...options.doIndex === void 0 ? {} : { doIndex: String(options.doIndex) },
+      ...options.skipRelatedItemsValidation === void 0 ? {} : { skipRelatedItemsValidation: String(options.skipRelatedItemsValidation) }
+    };
+    return this.ctx.http.request({
+      method: "PUT",
+      path: `/product/${this.ctx.tenant}/products/bulk`,
+      ...Object.keys(query).length > 0 ? { query } : {},
+      body: input,
+      auth
+    });
+  }
+  /**
+   * Triggers a dynamic-variant recalculation for the given product ids
+   * (`POST /products/recalculate`, 202). The result carries the created or
+   * already-referenced `jobs` plus `skippedProductIds` — products whose root
+   * already has a PENDING/PROCESSING job. Default auth: service.
+   */
+  async recalculate(input, auth = SERVICE) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: `/product/${this.ctx.tenant}/products/recalculate`,
+      body: input,
+      auth
+    });
+  }
+  /** Lists dynamic-variant recalculation jobs, optionally filtered by status. Default auth: anonymous. */
+  async listRecalculationJobs(params = {}, auth = ANON) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `/product/${this.ctx.tenant}/products/recalculate/jobs`,
+      ...params.status === void 0 ? {} : { query: { status: params.status } },
+      auth
+    });
+  }
+  /** Fetches one dynamic-variant recalculation job by id. Default auth: anonymous. */
+  async getRecalculationJob(jobId, auth = ANON) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `/product/${this.ctx.tenant}/products/recalculate/jobs/${jobId}`,
+      auth
+    });
+  }
+  /**
+   * Product templates (`/product-templates`). Reads default to anonymous,
+   * writes to service auth.
+   */
+  templates = {
+    /** One page of product templates. Default auth: anonymous. */
+    list: async (params = {}, auth = ANON) => this.ctx.http.request({
+      method: "GET",
+      path: `/product/${this.ctx.tenant}/product-templates`,
+      query: {
+        ...params.pageNumber === void 0 ? {} : { pageNumber: params.pageNumber },
+        ...params.pageSize === void 0 ? {} : { pageSize: params.pageSize },
+        ...params.sort === void 0 ? {} : { sort: params.sort },
+        ...params.q === void 0 ? {} : { q: params.q }
+      },
+      auth
+    }),
+    /** Fetches one product template by id. Default auth: anonymous. */
+    get: async (templateId, auth = ANON) => this.ctx.http.request({
+      method: "GET",
+      path: `/product/${this.ctx.tenant}/product-templates/${templateId}`,
+      auth
+    }),
+    /** Creates a product template. Default auth: service. */
+    create: async (input, auth = SERVICE) => this.ctx.http.request({
+      method: "POST",
+      path: `/product/${this.ctx.tenant}/product-templates`,
+      body: input,
+      auth
+    }),
+    /** Full-replaces a product template (`PUT`). Default auth: service. */
+    update: async (templateId, input, auth = SERVICE) => {
+      await this.ctx.http.request({
+        method: "PUT",
+        path: `/product/${this.ctx.tenant}/product-templates/${templateId}`,
+        body: input,
+        auth
+      });
+    },
+    /** Deletes a product template. Default auth: service. */
+    delete: async (templateId, auth = SERVICE) => {
+      await this.ctx.http.request({
+        method: "DELETE",
+        path: `/product/${this.ctx.tenant}/product-templates/${templateId}`,
+        auth
+      });
+    }
+  };
+};
+
+export { ProductService };
+//# sourceMappingURL=chunk-UNW6SFSB.js.map
+//# sourceMappingURL=chunk-UNW6SFSB.js.map

package/dist/chunk-UNW6SFSB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/services/product.ts"],"names":[],"mappings":"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","file":"chunk-UNW6SFSB.js","sourcesContent":["import type { ClientContext, PaginatedItems } from \"../core/context\";\nimport { iterateAll } from \"../core/context\";\nimport type { AuthContext } from \"../core/auth\";\nimport { resolveQuery, type QueryFor } from \"../core/query\";\nimport type {\n  BasicProductWithId,\n  BundleProductWithId,\n  ParentVariantProductWithId,\n  ProductMedia,\n  ProductCreateBody,\n  ProductUpdateBody,\n  ProductPartialUpdateBody,\n  ProductBulkCreateBody,\n  ProductBulkUpdateBody,\n  BulkResponse,\n  ResourceLocation,\n  DynamicVariantRecalculationRequest,\n  DynamicVariantRecalculationResponse,\n  DynamicVariantRecalculationJobResponse,\n  DynamicVariantRecalculationJobStatus,\n  ProductTemplateResponse,\n  ProductTemplateCreation,\n  ProductTemplateUpdate,\n} from \"../generated/product\";\n\nconst ANON: AuthContext = { kind: \"anonymous\" };\nconst SERVICE: AuthContext = { kind: \"service\" };\n\n/** A product as returned by the Product service (all generated fields). */\nexport type Product = BasicProductWithId | BundleProductWithId | ParentVariantProductWithId;\n\n/** A single product media entry (generated; `ProductMedia` is the list type). */\nexport type Media = ProductMedia[number];\n\n/** Body for creating a product (`POST /products`) — any of the 5 product shapes. */\nexport type ProductCreateInput = ProductCreateBody;\n\n/** Body for a full product replace (`PUT /products/{id}`). */\nexport type ProductUpdateInput = ProductUpdateBody;\n\n/** Body for a partial product update (`PATCH /products/{id}`). */\nexport type ProductPatchInput = ProductPartialUpdateBody;\n\n/** Id/location envelope returned when a product is created. */\nexport type ProductCreated = ResourceLocation;\n\n/** Body for bulk-creating products (`POST /products/bulk`). */\nexport type ProductBulkCreateInput = ProductBulkCreateBody;\n\n/** Body for bulk-updating products (`PUT /products/bulk`). */\nexport type ProductBulkUpdateInput = ProductBulkUpdateBody;\n\n/** Per-entry result of a bulk product operation (207 Multi-Status). */\nexport type ProductBulkResult = BulkResponse;\n\n/** Body for triggering a dynamic-variant recalculation. */\nexport type ProductRecalculationInput = DynamicVariantRecalculationRequest;\n\n/** Result of triggering a recalculation — created jobs plus skipped product ids. */\nexport type ProductRecalculationResult = DynamicVariantRecalculationResponse;\n\n/** A dynamic-variant recalculation job. */\nexport type ProductRecalculationJob = DynamicVariantRecalculationJobResponse;\n\n/** Status of a recalculation job. */\nexport type ProductRecalculationJobStatus = DynamicVariantRecalculationJobStatus;\n\n/** A product template as returned by the Product service. */\nexport type ProductTemplate = ProductTemplateResponse;\n\n/** Body for creating a product template. */\nexport type ProductTemplateCreateInput = ProductTemplateCreation;\n\n/** Body for updating a product template (`PUT`, full replace). */\nexport type ProductTemplateUpdateInput = ProductTemplateUpdate;\n\n/** Id envelope returned when a product template is created. */\nexport type ProductTemplateCreated = { id?: string };\n\n/** Query flags shared by the product write endpoints. */\nexport interface ProductWriteOptions {\n  skipVariantGeneration?: boolean;\n  doIndex?: boolean;\n  skipRelatedItemsValidation?: boolean;\n}\n\n/** Catalog reads. Default auth: anonymous; pass customer for personalized pricing. */\nexport class ProductService {\n  static readonly channel = \"product\" as const;\n  constructor(private readonly ctx: ClientContext) {}\n\n  /** Fetches one product by id. */\n  async get(\n    productId: string,\n    _opts?: Record<string, never>,\n    auth: AuthContext = ANON,\n  ): Promise<Product> {\n    return this.ctx.http.request<Product>({\n      method: \"GET\",\n      path: `/product/${this.ctx.tenant}/products/${productId}`,\n      auth,\n    });\n  }\n\n  /** Fetches one product by its code. */\n  async getByCode(code: string, auth: AuthContext = ANON): Promise<Product> {\n    const rows = await this.ctx.http.request<Product[]>({\n      method: \"GET\",\n      path: `/product/${this.ctx.tenant}/products`,\n      query: { q: `code:${code}` },\n      auth,\n    });\n    const first = rows[0];\n    if (!first) throw new Error(`No product with code \"${code}\"`);\n    return first;\n  }\n\n  /** One page of products. */\n  async list(\n    params: { pageNumber?: number; pageSize?: number } = {},\n    auth: AuthContext = ANON,\n  ): Promise<PaginatedItems<Product>> {\n    const pageNumber = params.pageNumber ?? 1;\n    const pageSize = params.pageSize ?? 50;\n    const items = await this.ctx.http.request<Product[]>({\n      method: \"GET\",\n      path: `/product/${this.ctx.tenant}/products`,\n      query: { pageNumber, pageSize },\n      auth,\n    });\n    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };\n  }\n\n  /** Async-iterates every product across pages. */\n  listAll(params: { pageSize?: number } = {}, auth: AuthContext = ANON): AsyncIterable<Product> {\n    const pageSize = params.pageSize ?? 50;\n    return iterateAll<Product>((pageNumber) => this.list({ pageNumber, pageSize }, auth));\n  }\n\n  /**\n   * Searches products by a `q` filter — a raw Emporix DSL string or a built\n   * filter (e.g. `@viu/emporix-mixins`' `mixinQuery(...)`). Product supports\n   * `compoundLogicalQuery`, so `or()` filters are allowed.\n   */\n  async search(\n    query: QueryFor<\"PRODUCT\">,\n    params: { pageNumber?: number; pageSize?: number } = {},\n    auth: AuthContext = ANON,\n  ): Promise<PaginatedItems<Product>> {\n    const q = resolveQuery(query, { compoundLogicalQuery: true });\n    const pageNumber = params.pageNumber ?? 1;\n    const pageSize = params.pageSize ?? 50;\n    const items = await this.ctx.http.request<Product[]>({\n      method: \"GET\",\n      path: `/product/${this.ctx.tenant}/products`,\n      query: { q, pageNumber, pageSize },\n      auth,\n    });\n    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };\n  }\n\n  /**\n   * Free-text product search by name. The product `q` is a `field:value` DSL,\n   * so a bare term (e.g. \"in time\") 400s with \"No value for key …\". This builds\n   * a `name:(~<term>)` regex filter (regex metacharacters escaped) and delegates\n   * to {@link search}.\n   */\n  async searchByName(\n    query: string,\n    params: { pageNumber?: number; pageSize?: number } = {},\n    auth: AuthContext = ANON,\n  ): Promise<PaginatedItems<Product>> {\n    const escaped = query.trim().replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n    return this.search(`name:(~${escaped})`, params, auth);\n  }\n\n  /**\n   * Bulk fetch by id. POSTs `/products/search` with `q=\"id:(id1,id2,…)\"`,\n   * chunking when the list is larger than `options.chunkSize` (default\n   * 100). An empty list short-circuits with no HTTP call. **Order is not\n   * guaranteed** across chunks — re-index by `id` if order matters.\n   */\n  async searchByIds(\n    ids: string[],\n    options: { chunkSize?: number } = {},\n    auth: AuthContext = ANON,\n  ): Promise<Product[]> {\n    if (ids.length === 0) return [];\n    const chunkSize = options.chunkSize ?? 100;\n    const chunks: string[][] = [];\n    for (let i = 0; i < ids.length; i += chunkSize) {\n      chunks.push(ids.slice(i, i + chunkSize));\n    }\n    const pages = await Promise.all(\n      chunks.map((chunk) =>\n        this.ctx.http.request<Product[]>({\n          method: \"POST\",\n          path: `/product/${this.ctx.tenant}/products/search`,\n          query: { pageSize: chunk.length },\n          auth,\n          body: { q: `id:(${chunk.join(\",\")})` },\n          idempotent: true, // pure read over POST — safe to replay on 5xx/429\n        }),\n      ),\n    );\n    return pages.flat();\n  }\n\n  /**\n   * Bulk fetch by code. POSTs `/products/search` with `q=\"code:(c1,c2,…)\"`,\n   * chunking when the list is larger than `options.chunkSize` (default 100).\n   * Duplicate codes are de-duplicated. Codes containing query-delimiter\n   * characters (`(`, `)`, `,`, whitespace, `\"`) are dropped with a logged\n   * warning, because the Emporix `q` syntax uses them as delimiters and does\n   * not support escaping them in a plain IN-list. An empty list — or one with\n   * no safe codes — short-circuits with no HTTP call. **Order is not\n   * guaranteed** across chunks — re-index by `code` if order matters.\n   */\n  async searchByCodes(\n    codes: string[],\n    options: { chunkSize?: number } = {},\n    auth: AuthContext = ANON,\n  ): Promise<Product[]> {\n    const unique = [...new Set(codes)];\n    const unsafe = /[(),\"\\s]/;\n    const safe = unique.filter((c) => !unsafe.test(c));\n    const dropped = unique.filter((c) => unsafe.test(c));\n    if (dropped.length > 0) {\n      this.ctx.logger.warn(\n        \"products.searchByCodes: dropped codes containing query-delimiter characters\",\n        { dropped },\n      );\n    }\n    if (safe.length === 0) return [];\n    const chunkSize = options.chunkSize ?? 100;\n    const chunks: string[][] = [];\n    for (let i = 0; i < safe.length; i += chunkSize) {\n      chunks.push(safe.slice(i, i + chunkSize));\n    }\n    const pages = await Promise.all(\n      chunks.map((chunk) =>\n        this.ctx.http.request<Product[]>({\n          method: \"POST\",\n          path: `/product/${this.ctx.tenant}/products/search`,\n          query: { pageSize: chunk.length },\n          auth,\n          body: { q: `code:(${chunk.join(\",\")})` },\n          idempotent: true, // pure read over POST — safe to replay on 5xx/429\n        }),\n      ),\n    );\n    return pages.flat();\n  }\n\n  /**\n   * Streams the VARIANT children of a PARENT_VARIANT product, page by page,\n   * via the search query `productType:VARIANT parentVariantId:<id>`. Default\n   * pageSize 200. The query syntax (space-separated fields = implicit AND) is\n   * encapsulated here so consumers don't build it themselves.\n   */\n  listVariantChildrenAll(\n    parentVariantId: string,\n    params: { pageSize?: number } = {},\n    auth: AuthContext = ANON,\n  ): AsyncIterable<Product> {\n    const pageSize = params.pageSize ?? 200;\n    const q = `productType:VARIANT parentVariantId:${parentVariantId}`;\n    return iterateAll<Product>((pageNumber) => this.search(q, { pageNumber, pageSize }, auth));\n  }\n\n  /**\n   * Resolves ALL VARIANT children of a PARENT_VARIANT product into a flat\n   * array (loads every page). Default pageSize 200. Returns `[]` when there are\n   * no children — never throws.\n   */\n  async listVariantChildren(\n    parentVariantId: string,\n    params: { pageSize?: number } = {},\n    auth: AuthContext = ANON,\n  ): Promise<Product[]> {\n    const out: Product[] = [];\n    for await (const child of this.listVariantChildrenAll(parentVariantId, params, auth)) {\n      out.push(child);\n    }\n    return out;\n  }\n\n  // --- Admin writes. Default auth: service. ---\n\n  /**\n   * Creates a product (`POST /products`). Default auth: service. Accepts any of\n   * the five product shapes (basic, bundle, parent-variant, variant,\n   * dynamic-variant).\n   */\n  async create(\n    input: ProductCreateInput,\n    options: ProductWriteOptions = {},\n    auth: AuthContext = SERVICE,\n  ): Promise<ProductCreated> {\n    const query = {\n      ...(options.skipVariantGeneration === undefined ? {} : { skipVariantGeneration: String(options.skipVariantGeneration) }),\n      ...(options.doIndex === undefined ? {} : { doIndex: String(options.doIndex) }),\n      ...(options.skipRelatedItemsValidation === undefined ? {} : { skipRelatedItemsValidation: String(options.skipRelatedItemsValidation) }),\n    };\n    return this.ctx.http.request<ProductCreated>({\n      method: \"POST\",\n      path: `/product/${this.ctx.tenant}/products`,\n      ...(Object.keys(query).length > 0 ? { query } : {}),\n      body: input,\n      auth,\n    });\n  }\n\n  /**\n   * Partially updates a product (`PATCH /products/{productId}`). Default auth:\n   * service. Use {@link replace} for a full replace (PUT).\n   */\n  async update(\n    productId: string,\n    input: ProductPatchInput,\n    options: ProductWriteOptions = {},\n    auth: AuthContext = SERVICE,\n  ): Promise<void> {\n    const query = {\n      ...(options.skipVariantGeneration === undefined ? {} : { skipVariantGeneration: String(options.skipVariantGeneration) }),\n      ...(options.doIndex === undefined ? {} : { doIndex: String(options.doIndex) }),\n      ...(options.skipRelatedItemsValidation === undefined ? {} : { skipRelatedItemsValidation: String(options.skipRelatedItemsValidation) }),\n    };\n    await this.ctx.http.request<void>({\n      method: \"PATCH\",\n      path: `/product/${this.ctx.tenant}/products/${productId}`,\n      ...(Object.keys(query).length > 0 ? { query } : {}),\n      body: input,\n      auth,\n    });\n  }\n\n  /**\n   * Full-replaces a product (`PUT /products/{productId}`). Returns the created\n   * resource on 201 (upsert) and nothing on 204. `options.partial` sends\n   * `?partial=true` for a merge-style replace. Default auth: service.\n   */\n  async replace(\n    productId: string,\n    input: ProductUpdateInput,\n    options: ProductWriteOptions & { partial?: boolean } = {},\n    auth: AuthContext = SERVICE,\n  ): Promise<ProductCreated | void> {\n    const query = {\n      ...(options.partial === undefined ? {} : { partial: String(options.partial) }),\n      ...(options.skipVariantGeneration === undefined ? {} : { skipVariantGeneration: String(options.skipVariantGeneration) }),\n      ...(options.doIndex === undefined ? {} : { doIndex: String(options.doIndex) }),\n      ...(options.skipRelatedItemsValidation === undefined ? {} : { skipRelatedItemsValidation: String(options.skipRelatedItemsValidation) }),\n    };\n    return this.ctx.http.request<ProductCreated | void>({\n      method: \"PUT\",\n      path: `/product/${this.ctx.tenant}/products/${productId}`,\n      ...(Object.keys(query).length > 0 ? { query } : {}),\n      body: input,\n      auth,\n    });\n  }\n\n  /**\n   * Deletes a product (`DELETE /products/{productId}`). `options.force` deletes\n   * even when the product is referenced. Default auth: service.\n   */\n  async delete(\n    productId: string,\n    options: { force?: boolean; doIndex?: boolean } = {},\n    auth: AuthContext = SERVICE,\n  ): Promise<void> {\n    const query = {\n      ...(options.force === undefined ? {} : { force: String(options.force) }),\n      ...(options.doIndex === undefined ? {} : { doIndex: String(options.doIndex) }),\n    };\n    await this.ctx.http.request<void>({\n      method: \"DELETE\",\n      path: `/product/${this.ctx.tenant}/products/${productId}`,\n      ...(Object.keys(query).length > 0 ? { query } : {}),\n      auth,\n    });\n  }\n\n  /**\n   * Bulk-creates products (`POST /products/bulk`). Responds 207 Multi-Status:\n   * partial failures do **not** throw — inspect each entry. Default auth: service.\n   */\n  async bulkCreate(\n    input: ProductBulkCreateInput,\n    options: ProductWriteOptions = {},\n    auth: AuthContext = SERVICE,\n  ): Promise<ProductBulkResult[]> {\n    const query = {\n      ...(options.skipVariantGeneration === undefined ? {} : { skipVariantGeneration: String(options.skipVariantGeneration) }),\n      ...(options.doIndex === undefined ? {} : { doIndex: String(options.doIndex) }),\n      ...(options.skipRelatedItemsValidation === undefined ? {} : { skipRelatedItemsValidation: String(options.skipRelatedItemsValidation) }),\n    };\n    return this.ctx.http.request<ProductBulkResult[]>({\n      method: \"POST\",\n      path: `/product/${this.ctx.tenant}/products/bulk`,\n      ...(Object.keys(query).length > 0 ? { query } : {}),\n      body: input,\n      auth,\n    });\n  }\n\n  /**\n   * Bulk-updates products (`PUT /products/bulk`). Responds 207 Multi-Status:\n   * partial failures do **not** throw — inspect each entry. Default auth: service.\n   */\n  async bulkUpdate(\n    input: ProductBulkUpdateInput,\n    options: ProductWriteOptions = {},\n    auth: AuthContext = SERVICE,\n  ): Promise<ProductBulkResult[]> {\n    const query = {\n      ...(options.skipVariantGeneration === undefined ? {} : { skipVariantGeneration: String(options.skipVariantGeneration) }),\n      ...(options.doIndex === undefined ? {} : { doIndex: String(options.doIndex) }),\n      ...(options.skipRelatedItemsValidation === undefined ? {} : { skipRelatedItemsValidation: String(options.skipRelatedItemsValidation) }),\n    };\n    return this.ctx.http.request<ProductBulkResult[]>({\n      method: \"PUT\",\n      path: `/product/${this.ctx.tenant}/products/bulk`,\n      ...(Object.keys(query).length > 0 ? { query } : {}),\n      body: input,\n      auth,\n    });\n  }\n\n  /**\n   * Triggers a dynamic-variant recalculation for the given product ids\n   * (`POST /products/recalculate`, 202). The result carries the created or\n   * already-referenced `jobs` plus `skippedProductIds` — products whose root\n   * already has a PENDING/PROCESSING job. Default auth: service.\n   */\n  async recalculate(\n    input: ProductRecalculationInput,\n    auth: AuthContext = SERVICE,\n  ): Promise<ProductRecalculationResult> {\n    return this.ctx.http.request<ProductRecalculationResult>({\n      method: \"POST\",\n      path: `/product/${this.ctx.tenant}/products/recalculate`,\n      body: input,\n      auth,\n    });\n  }\n\n  /** Lists dynamic-variant recalculation jobs, optionally filtered by status. Default auth: anonymous. */\n  async listRecalculationJobs(\n    params: { status?: ProductRecalculationJobStatus } = {},\n    auth: AuthContext = ANON,\n  ): Promise<ProductRecalculationJob[]> {\n    return this.ctx.http.request<ProductRecalculationJob[]>({\n      method: \"GET\",\n      path: `/product/${this.ctx.tenant}/products/recalculate/jobs`,\n      ...(params.status === undefined ? {} : { query: { status: params.status } }),\n      auth,\n    });\n  }\n\n  /** Fetches one dynamic-variant recalculation job by id. Default auth: anonymous. */\n  async getRecalculationJob(jobId: string, auth: AuthContext = ANON): Promise<ProductRecalculationJob> {\n    return this.ctx.http.request<ProductRecalculationJob>({\n      method: \"GET\",\n      path: `/product/${this.ctx.tenant}/products/recalculate/jobs/${jobId}`,\n      auth,\n    });\n  }\n\n  /**\n   * Product templates (`/product-templates`). Reads default to anonymous,\n   * writes to service auth.\n   */\n  readonly templates = {\n    /** One page of product templates. Default auth: anonymous. */\n    list: async (\n      params: { pageNumber?: number; pageSize?: number; sort?: string; q?: string } = {},\n      auth: AuthContext = ANON,\n    ): Promise<ProductTemplate[]> =>\n      this.ctx.http.request<ProductTemplate[]>({\n        method: \"GET\",\n        path: `/product/${this.ctx.tenant}/product-templates`,\n        query: {\n          ...(params.pageNumber === undefined ? {} : { pageNumber: params.pageNumber }),\n          ...(params.pageSize === undefined ? {} : { pageSize: params.pageSize }),\n          ...(params.sort === undefined ? {} : { sort: params.sort }),\n          ...(params.q === undefined ? {} : { q: params.q }),\n        },\n        auth,\n      }),\n\n    /** Fetches one product template by id. Default auth: anonymous. */\n    get: async (templateId: string, auth: AuthContext = ANON): Promise<ProductTemplate> =>\n      this.ctx.http.request<ProductTemplate>({\n        method: \"GET\",\n        path: `/product/${this.ctx.tenant}/product-templates/${templateId}`,\n        auth,\n      }),\n\n    /** Creates a product template. Default auth: service. */\n    create: async (\n      input: ProductTemplateCreateInput,\n      auth: AuthContext = SERVICE,\n    ): Promise<ProductTemplateCreated> =>\n      this.ctx.http.request<ProductTemplateCreated>({\n        method: \"POST\",\n        path: `/product/${this.ctx.tenant}/product-templates`,\n        body: input,\n        auth,\n      }),\n\n    /** Full-replaces a product template (`PUT`). Default auth: service. */\n    update: async (\n      templateId: string,\n      input: ProductTemplateUpdateInput,\n      auth: AuthContext = SERVICE,\n    ): Promise<void> => {\n      await this.ctx.http.request<void>({\n        method: \"PUT\",\n        path: `/product/${this.ctx.tenant}/product-templates/${templateId}`,\n        body: input,\n        auth,\n      });\n    },\n\n    /** Deletes a product template. Default auth: service. */\n    delete: async (templateId: string, auth: AuthContext = SERVICE): Promise<void> => {\n      await this.ctx.http.request<void>({\n        method: \"DELETE\",\n        path: `/product/${this.ctx.tenant}/product-templates/${templateId}`,\n        auth,\n      });\n    },\n  };\n}\n"]}