@viu/emporix-sdk 2.1.0 → 2.2.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @viu/emporix-sdk
 
+## 2.2.0
+
+### Minor Changes
+
+- [#61](https://github.com/viuteam/emporix-sdk/pull/61) [`4a869c9`](https://github.com/viuteam/emporix-sdk/commit/4a869c9aa60cce99b79b41b8470af367e1b4e249) Thanks [@amnael1](https://github.com/amnael1)! - Add Configuration Service bindings: `client.tenantConfig` and
+  `client.clientConfig` provide full CRUD (`list`/`get`/`create`/`update`/`delete`)
+  over tenant-wide and per-client configuration. Server-side only — these use the
+  service (clientCredentials) token and must not be called from a browser.
+
+- [#63](https://github.com/viuteam/emporix-sdk/pull/63) [`bb2ce4f`](https://github.com/viuteam/emporix-sdk/commit/bb2ce4f891e50e07cee02e03340d2abe1133fdc0) Thanks [@amnael1](https://github.com/amnael1)! - Add `products.searchByCodes(codes, { chunkSize? })` — bulk-fetch products by
+  `code` via `POST /products/search` (`q="code:(…)"`), chunked at 100, analogous
+  to `searchByIds`. Codes with query-delimiter characters are dropped with a
+  warning. Adds the `useProductsByCodes` React hook (30s stale-time).
+
+### Patch Changes
+
+- [#62](https://github.com/viuteam/emporix-sdk/pull/62) [`9747445`](https://github.com/viuteam/emporix-sdk/commit/9747445c13a27319462755c5333c9ae0a4741e68) Thanks [@amnael1](https://github.com/amnael1)! - Report the real package version as `sdkVersion` on every log line instead of the
+  hardcoded `0.0.0` placeholder. The version is now read from `package.json` and
+  inlined at build time (browser-safe, no runtime filesystem access).
+
 ## 2.1.0
 
 ### Minor Changes

package/dist/availability.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CGuxSb56.cjs';
+import { C as ClientContext, b as AuthContext } from './context-Bs5ZSwds.cjs';
 
 type DistributionChannel = 'ASSORTMENT' | 'HOME_DELIVERY' | 'PICKUP';
 type Availability$1 = {

package/dist/availability.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CGuxSb56.js';
+import { C as ClientContext, b as AuthContext } from './context-Bs5ZSwds.js';
 
 type DistributionChannel = 'ASSORTMENT' | 'HOME_DELIVERY' | 'PICKUP';
 type Availability$1 = {

package/dist/cart.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CGuxSb56.cjs';
+import { C as ClientContext, b as AuthContext } from './context-Bs5ZSwds.cjs';
 
 /**
  * Access control identifier that determines who can view or manage the cart.

package/dist/cart.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CGuxSb56.js';
+import { C as ClientContext, b as AuthContext } from './context-Bs5ZSwds.js';
 
 /**
  * Access control identifier that determines who can view or manage the cart.

package/dist/category.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-CGuxSb56.cjs';
+import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-Bs5ZSwds.cjs';
 import { Product } from './product.cjs';
 
 /**

package/dist/category.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-CGuxSb56.js';
+import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-Bs5ZSwds.js';
 import { Product } from './product.js';
 
 /**

package/dist/checkout.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CGuxSb56.cjs';
+import { C as ClientContext, b as AuthContext } from './context-Bs5ZSwds.cjs';
 
 /**
  * Information about the customer's address.

package/dist/checkout.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CGuxSb56.js';
+import { C as ClientContext, b as AuthContext } from './context-Bs5ZSwds.js';
 
 /**
  * Information about the customer's address.

package/dist/{chunk-JTJV7WUW.js → chunk-5JHTZBOC.js}

@@ -82,6 +82,46 @@ var ProductService = class {
     );
     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(",")})` }
+        })
+      )
+    );
+    return pages.flat();
+  }
   /**
    * Streams the VARIANT children of a PARENT_VARIANT product, page by page,
    * via the search query `productType:VARIANT parentVariantId:<id>`. Default
@@ -108,5 +148,5 @@ var ProductService = class {
 };
 
 export { ProductService };
-//# sourceMappingURL=chunk-JTJV7WUW.js.map
-//# sourceMappingURL=chunk-JTJV7WUW.js.map
+//# sourceMappingURL=chunk-5JHTZBOC.js.map
+//# sourceMappingURL=chunk-5JHTZBOC.js.map

package/dist/chunk-5JHTZBOC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/services/product.ts"],"names":[],"mappings":"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","file":"chunk-5JHTZBOC.js","sourcesContent":["import type { ClientContext, PaginatedItems } from \"../core/context\";\nimport { iterateAll } from \"../core/context\";\nimport type { AuthContext } from \"../core/auth\";\nimport type {\n  BasicProductWithId,\n  BundleProductWithId,\n  ParentVariantProductWithId,\n  ProductMedia,\n} from \"../generated/product\";\n\nconst ANON: AuthContext = { kind: \"anonymous\" };\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/** Catalog reads. Default auth: anonymous; pass customer for personalized pricing. */\nexport class ProductService {\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  /** Searches products by free-text query. */\n  async search(\n    query: string,\n    params: { pageNumber?: number; pageSize?: number } = {},\n    auth: AuthContext = ANON,\n  ): Promise<PaginatedItems<Product>> {\n    const pageNumber = params.pageNumber ?? 1;\n    const pageSize = params.pageSize ?? 50;\n    const items = await this.ctx.http.request<Product[]>({\n      method: \"GET\",\n      path: `/product/${this.ctx.tenant}/products`,\n      query: { q: query, pageNumber, pageSize },\n      auth,\n    });\n    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };\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        }),\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        }),\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"]}

package/dist/companies.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CGuxSb56.cjs';
+import { C as ClientContext, b as AuthContext } from './context-Bs5ZSwds.cjs';
 import { L as LegalEntity, f as LegalEntityCreate, h as LegalEntityUpdate } from './types.gen-D1QuqPLs.cjs';
 export { A as AccountLimit, e as CustomerGroupRef, g as LegalEntityType, i as LegalInfo } from './types.gen-D1QuqPLs.cjs';
 

package/dist/companies.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CGuxSb56.js';
+import { C as ClientContext, b as AuthContext } from './context-Bs5ZSwds.js';
 import { L as LegalEntity, f as LegalEntityCreate, h as LegalEntityUpdate } from './types.gen-D1QuqPLs.js';
 export { A as AccountLimit, e as CustomerGroupRef, g as LegalEntityType, i as LegalInfo } from './types.gen-D1QuqPLs.js';
 

package/dist/contacts.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CGuxSb56.cjs';
+import { C as ClientContext, b as AuthContext } from './context-Bs5ZSwds.cjs';
 import { C as ContactAssignment, a as ContactAssignmentCreate, c as ContactAssignmentUpdate } from './types.gen-D1QuqPLs.cjs';
 export { b as ContactAssignmentType } from './types.gen-D1QuqPLs.cjs';
 

package/dist/contacts.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CGuxSb56.js';
+import { C as ClientContext, b as AuthContext } from './context-Bs5ZSwds.js';
 import { C as ContactAssignment, a as ContactAssignmentCreate, c as ContactAssignmentUpdate } from './types.gen-D1QuqPLs.js';
 export { b as ContactAssignmentType } from './types.gen-D1QuqPLs.js';
 

package/dist/{context-CGuxSb56.d.cts → context-Bs5ZSwds.d.cts}

@@ -3,7 +3,7 @@ type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "silent";
 /** Numeric ordering used for fast comparison. */
 declare const LEVEL: Record<LogLevel, number>;
 /** Services that bind their own logger and are independently level-controllable. */
-type ServiceName = "customer" | "product" | "category" | "cart" | "checkout" | "payment" | "price" | "media" | "segment" | "site" | "session-context" | "customer-management" | "iam" | "orders" | "sales-orders" | "availability" | "http" | "auth";
+type ServiceName = "customer" | "product" | "category" | "cart" | "checkout" | "payment" | "price" | "media" | "segment" | "site" | "session-context" | "customer-management" | "iam" | "orders" | "sales-orders" | "availability" | "configuration" | "http" | "auth";
 /** Arbitrary structured fields attached to a log line. */
 interface LogFields {
     [key: string]: unknown;

package/dist/{context-CGuxSb56.d.ts → context-Bs5ZSwds.d.ts}

@@ -3,7 +3,7 @@ type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "silent";
 /** Numeric ordering used for fast comparison. */
 declare const LEVEL: Record<LogLevel, number>;
 /** Services that bind their own logger and are independently level-controllable. */
-type ServiceName = "customer" | "product" | "category" | "cart" | "checkout" | "payment" | "price" | "media" | "segment" | "site" | "session-context" | "customer-management" | "iam" | "orders" | "sales-orders" | "availability" | "http" | "auth";
+type ServiceName = "customer" | "product" | "category" | "cart" | "checkout" | "payment" | "price" | "media" | "segment" | "site" | "session-context" | "customer-management" | "iam" | "orders" | "sales-orders" | "availability" | "configuration" | "http" | "auth";
 /** Arbitrary structured fields attached to a log line. */
 interface LogFields {
     [key: string]: unknown;

package/dist/customer-groups.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CGuxSb56.cjs';
+import { C as ClientContext, b as AuthContext } from './context-Bs5ZSwds.cjs';
 
 /**
  * Hand-written mirror of the minimal IAM Service group shape needed for

package/dist/customer-groups.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-CGuxSb56.js';
+import { C as ClientContext, b as AuthContext } from './context-Bs5ZSwds.js';
 
 /**
  * Hand-written mirror of the minimal IAM Service group shape needed for

package/dist/customer.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, A as AnonymousSession, b as AuthContext } from './context-CGuxSb56.cjs';
+import { C as ClientContext, A as AnonymousSession, b as AuthContext } from './context-Bs5ZSwds.cjs';
 
 type AccountId = {
     /**

package/dist/customer.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientContext, A as AnonymousSession, b as AuthContext } from './context-CGuxSb56.js';
+import { C as ClientContext, A as AnonymousSession, b as AuthContext } from './context-Bs5ZSwds.js';
 
 type AccountId = {
     /**

package/dist/index.cjs

@@ -996,6 +996,46 @@ var ProductService = class {
     );
     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 = {}, auth2 = 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: auth2,
+          body: { q: `code:(${chunk.join(",")})` }
+        })
+      )
+    );
+    return pages.flat();
+  }
   /**
    * Streams the VARIANT children of a PARENT_VARIANT product, page by page,
    * via the search query `productType:VARIANT parentVariantId:<id>`. Default
@@ -1880,12 +1920,12 @@ var SessionContextService = class {
    * update). Non-404 errors propagate.
    */
   async patch(input, authCtx = ANON5) {
-    let version = input.version;
-    if (version === void 0) {
+    let version2 = input.version;
+    if (version2 === void 0) {
       const current = await this.get(authCtx);
       if (current === null) return false;
-      version = current.metadata?.version;
-      if (version === void 0) {
+      version2 = current.metadata?.version;
+      if (version2 === void 0) {
         throw new Error(
           "SessionContextService.patch: no metadata.version in server response"
         );
@@ -1897,7 +1937,7 @@ var SessionContextService = class {
       path: `/session-context/${this.ctx.tenant}/me/context`,
       body: {
         ...fields,
-        metadata: { version }
+        metadata: { version: version2 }
       },
       auth: authCtx
     });
@@ -2232,8 +2272,126 @@ var AvailabilityService = class {
   }
 };
 
+// src/services/tenant-config.ts
+var SERVICE3 = { kind: "service" };
+var TenantConfigService = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  ctx;
+  base() {
+    return `/configuration/${this.ctx.tenant}/configurations`;
+  }
+  /** List tenant configurations, optionally filtered by `keys`. */
+  async list(opts = {}, auth2 = SERVICE3) {
+    const query = opts.keys && opts.keys.length > 0 ? { keys: opts.keys.join(",") } : void 0;
+    return this.ctx.http.request({
+      method: "GET",
+      path: this.base(),
+      auth: auth2,
+      ...query ? { query } : {}
+    });
+  }
+  /** Retrieve one tenant configuration by key. */
+  async get(key, auth2 = SERVICE3) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/${encodeURIComponent(key)}`,
+      auth: auth2
+    });
+  }
+  /** Create one or more tenant configurations (array in, array out). */
+  async create(drafts, auth2 = SERVICE3) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: this.base(),
+      auth: auth2,
+      body: drafts
+    });
+  }
+  /** Update one tenant configuration by key. */
+  async update(key, draft, auth2 = SERVICE3) {
+    return this.ctx.http.request({
+      method: "PUT",
+      path: `${this.base()}/${encodeURIComponent(key)}`,
+      auth: auth2,
+      body: draft
+    });
+  }
+  /** Delete one tenant configuration by key. */
+  async delete(key, auth2 = SERVICE3) {
+    await this.ctx.http.request({
+      method: "DELETE",
+      path: `${this.base()}/${encodeURIComponent(key)}`,
+      auth: auth2
+    });
+  }
+};
+
+// src/services/client-config.ts
+var SERVICE4 = { kind: "service" };
+var ClientConfigService = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  ctx;
+  base(client) {
+    return `/configuration/${this.ctx.tenant}/clients/${encodeURIComponent(client)}/configurations`;
+  }
+  /** List a client's configurations, optionally filtered by `keys`. */
+  async list(client, opts = {}, auth2 = SERVICE4) {
+    const query = opts.keys && opts.keys.length > 0 ? { keys: opts.keys.join(",") } : void 0;
+    return this.ctx.http.request({
+      method: "GET",
+      path: this.base(client),
+      auth: auth2,
+      ...query ? { query } : {}
+    });
+  }
+  /** Retrieve one client configuration by key. */
+  async get(client, key, auth2 = SERVICE4) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base(client)}/${encodeURIComponent(key)}`,
+      auth: auth2
+    });
+  }
+  /** Create one or more client configurations. Injects `client` into each item. */
+  async create(client, drafts, auth2 = SERVICE4) {
+    const body = drafts.map((d) => ({ ...d, client }));
+    return this.ctx.http.request({
+      method: "POST",
+      path: this.base(client),
+      auth: auth2,
+      body
+    });
+  }
+  /** Update one client configuration by key. Injects `client` into the body. */
+  async update(client, key, draft, auth2 = SERVICE4) {
+    return this.ctx.http.request({
+      method: "PUT",
+      path: `${this.base(client)}/${encodeURIComponent(key)}`,
+      auth: auth2,
+      body: { ...draft, client }
+    });
+  }
+  /** Delete one client configuration by key. */
+  async delete(client, key, auth2 = SERVICE4) {
+    await this.ctx.http.request({
+      method: "DELETE",
+      path: `${this.base(client)}/${encodeURIComponent(key)}`,
+      auth: auth2
+    });
+  }
+};
+
+// package.json
+var version = "2.2.0";
+
+// src/version.ts
+var SDK_VERSION = version;
+
 // src/client.ts
-var SDK_VERSION = "0.0.0";
 var EmporixClient = class {
   customers;
   products;
@@ -2253,6 +2411,8 @@ var EmporixClient = class {
   orders;
   salesOrders;
   availability;
+  tenantConfig;
+  clientConfig;
   /** The validated tenant this client is bound to. */
   tenant;
   /**
@@ -2323,6 +2483,8 @@ var EmporixClient = class {
     this.orders = new OrdersService(mk("orders"));
     this.salesOrders = new SalesOrdersService(mk("sales-orders"));
     this.availability = new AvailabilityService(mk("availability"));
+    this.tenantConfig = new TenantConfigService(mk("configuration"));
+    this.clientConfig = new ClientConfigService(mk("configuration"));
   }
   /** Sets the runtime log level globally or for one service. */
   setLogLevel(level, opts = {}) {
@@ -2338,6 +2500,7 @@ exports.AvailabilityService = AvailabilityService;
 exports.CartService = CartService;
 exports.CategoryService = CategoryService;
 exports.CheckoutService = CheckoutService;
+exports.ClientConfigService = ClientConfigService;
 exports.CompaniesService = CompaniesService;
 exports.ContactsService = ContactsService;
 exports.CustomerGroupsService = CustomerGroupsService;
@@ -2365,6 +2528,7 @@ exports.SalesOrdersService = SalesOrdersService;
 exports.SegmentService = SegmentService;
 exports.SessionContextService = SessionContextService;
 exports.SiteService = SiteService;
+exports.TenantConfigService = TenantConfigService;
 exports.auth = auth;
 exports.createConsoleLogger = createConsoleLogger;
 exports.createNoopLogger = createNoopLogger;