@viu/emporix-sdk 2.10.0 → 2.12.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @viu/emporix-sdk
 
+## 2.12.0
+
+### Minor Changes
+
+- [#116](https://github.com/viuteam/emporix-sdk/pull/116) [`5411502`](https://github.com/viuteam/emporix-sdk/commit/5411502fdde0737ad457812e28a86c505f938282) Thanks [@amnael1](https://github.com/amnael1)! - Add a runtime language switch. `client.setStorefrontContext({ language })` now sets an `Accept-Language` header on every read. React's `useSiteContext()` exposes `language` + `setLanguage(lang)` (modeled on `setCurrency`), persists the choice via `EmporixStorage` (`emporix.language`), mirrors it into the server session context, and keys localized reads (products, categories, segments, cart, shopping lists, orders) by language so the cache never serves stale-language text. A new `initialLanguage` provider prop seeds the active language.
+
+## 2.11.0
+
+### Minor Changes
+
+- [#114](https://github.com/viuteam/emporix-sdk/pull/114) [`ac2b2c8`](https://github.com/viuteam/emporix-sdk/commit/ac2b2c890521da017b3ef44ff15bdf6b16d69bb9) Thanks [@amnael1](https://github.com/amnael1)! - feat: invoke Emporix cloud functions
+
+  Adds `client.cloudFunctions.invoke<TRes, TReq>(functionId, { method?, path?,
+body?, query?, headers? }, auth)` — a generic call to tenant cloud functions
+  (`/cloud-functions/{tenant}/functions/{id}[/sub]`), with GET/POST/PUT/DELETE and
+  service / customer / anonymous / raw auth (default anonymous). Adds the React
+  hooks `useInvokeCloudFunction` (mutation, any method) and `useCloudFunction`
+  (GET-style query with caching), both with auto-auth (customer-if-token-else-
+  anonymous) and an optional override.
+
 ## 2.10.0
 
 ### Minor Changes

package/dist/availability.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-BBKOwNW6.cjs';
+import { C as ClientContext, b as AuthContext } from './context-CD7F_LHT.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-BBKOwNW6.js';
+import { C as ClientContext, b as AuthContext } from './context-CD7F_LHT.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-BBKOwNW6.cjs';
+import { C as ClientContext, b as AuthContext } from './context-CD7F_LHT.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-BBKOwNW6.js';
+import { C as ClientContext, b as AuthContext } from './context-CD7F_LHT.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-BBKOwNW6.cjs';
+import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-CD7F_LHT.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-BBKOwNW6.js';
+import { C as ClientContext, b as AuthContext, P as PaginatedItems } from './context-CD7F_LHT.js';
 import { Product } from './product.js';
 
 /**

package/dist/checkout.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-BBKOwNW6.cjs';
+import { C as ClientContext, b as AuthContext } from './context-CD7F_LHT.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-BBKOwNW6.js';
+import { C as ClientContext, b as AuthContext } from './context-CD7F_LHT.js';
 
 /**
  * Information about the customer's address.

package/dist/companies.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-BBKOwNW6.cjs';
+import { C as ClientContext, b as AuthContext } from './context-CD7F_LHT.cjs';
 import { L as LegalEntity, e as LegalEntityCreate, f as LegalEntityUpdate } from './types.gen-C_wOXYZB.cjs';
 export { A as AccountLimit, d as CustomerGroup, g as LegalInfo } from './types.gen-C_wOXYZB.cjs';
 

package/dist/companies.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-BBKOwNW6.js';
+import { C as ClientContext, b as AuthContext } from './context-CD7F_LHT.js';
 import { L as LegalEntity, e as LegalEntityCreate, f as LegalEntityUpdate } from './types.gen-C_wOXYZB.js';
 export { A as AccountLimit, d as CustomerGroup, g as LegalInfo } from './types.gen-C_wOXYZB.js';
 

package/dist/contacts.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-BBKOwNW6.cjs';
+import { C as ClientContext, b as AuthContext } from './context-CD7F_LHT.cjs';
 import { C as ContactAssignment, a as ContactAssignmentCreate, b as ContactAssignmentUpdate } from './types.gen-C_wOXYZB.cjs';
 
 /**

package/dist/contacts.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-BBKOwNW6.js';
+import { C as ClientContext, b as AuthContext } from './context-CD7F_LHT.js';
 import { C as ContactAssignment, a as ContactAssignmentCreate, b as ContactAssignmentUpdate } from './types.gen-C_wOXYZB.js';
 
 /**

package/dist/{context-BBKOwNW6.d.cts → context-CD7F_LHT.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" | "configuration" | "shopping-list" | "ai-rag-indexer" | "sequential-id" | "fee" | "webhook" | "schema" | "ai" | "tax" | "coupon" | "reward-points" | "brand" | "label" | "country" | "currency" | "shipping" | "returns" | "sepa-export" | "indexing" | "unit-handling" | "catalog" | "vendor" | "pick-pack" | "customer-admin" | "approval" | "http" | "auth";
+type ServiceName = "customer" | "product" | "category" | "cart" | "checkout" | "payment" | "price" | "media" | "segment" | "site" | "session-context" | "customer-management" | "iam" | "orders" | "sales-orders" | "availability" | "configuration" | "shopping-list" | "ai-rag-indexer" | "sequential-id" | "fee" | "webhook" | "schema" | "ai" | "tax" | "coupon" | "reward-points" | "brand" | "label" | "country" | "currency" | "shipping" | "returns" | "sepa-export" | "indexing" | "unit-handling" | "catalog" | "vendor" | "pick-pack" | "customer-admin" | "approval" | "cloud-functions" | "http" | "auth";
 /** Arbitrary structured fields attached to a log line. */
 interface LogFields {
     [key: string]: unknown;
@@ -93,6 +93,7 @@ interface StorefrontCredentials {
         currency?: string;
         siteCode?: string;
         targetLocation?: string;
+        language?: string;
     };
 }
 /** User-supplied SDK configuration. */
@@ -335,12 +336,21 @@ interface HttpClientOptions {
     sleep?: (ms: number) => Promise<void>;
     /** Opt-in customer-token refresher registry (off unless a refresher is set). */
     customerRefresh?: CustomerRefreshRegistry;
+    /**
+     * Shared storefront request context. When `language` is set, every request
+     * carries `Accept-Language: <language>`. Mutated at runtime via
+     * `EmporixClient.setStorefrontContext({ language })`.
+     */
+    requestContext?: {
+        language?: string | undefined;
+    };
 }
 /** Fetch wrapper: auth resolution, JSON parsing, typed error mapping, logging. */
 declare class HttpClient {
     private readonly opts;
     private readonly sleep;
     constructor(opts: HttpClientOptions);
+    private buildHeaders;
     request<T = unknown>(o: RequestOptions): Promise<T>;
     /**
      * Single-shot fetch that returns the raw {@link Response} unparsed. Used by

package/dist/{context-BBKOwNW6.d.ts → context-CD7F_LHT.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" | "configuration" | "shopping-list" | "ai-rag-indexer" | "sequential-id" | "fee" | "webhook" | "schema" | "ai" | "tax" | "coupon" | "reward-points" | "brand" | "label" | "country" | "currency" | "shipping" | "returns" | "sepa-export" | "indexing" | "unit-handling" | "catalog" | "vendor" | "pick-pack" | "customer-admin" | "approval" | "http" | "auth";
+type ServiceName = "customer" | "product" | "category" | "cart" | "checkout" | "payment" | "price" | "media" | "segment" | "site" | "session-context" | "customer-management" | "iam" | "orders" | "sales-orders" | "availability" | "configuration" | "shopping-list" | "ai-rag-indexer" | "sequential-id" | "fee" | "webhook" | "schema" | "ai" | "tax" | "coupon" | "reward-points" | "brand" | "label" | "country" | "currency" | "shipping" | "returns" | "sepa-export" | "indexing" | "unit-handling" | "catalog" | "vendor" | "pick-pack" | "customer-admin" | "approval" | "cloud-functions" | "http" | "auth";
 /** Arbitrary structured fields attached to a log line. */
 interface LogFields {
     [key: string]: unknown;
@@ -93,6 +93,7 @@ interface StorefrontCredentials {
         currency?: string;
         siteCode?: string;
         targetLocation?: string;
+        language?: string;
     };
 }
 /** User-supplied SDK configuration. */
@@ -335,12 +336,21 @@ interface HttpClientOptions {
     sleep?: (ms: number) => Promise<void>;
     /** Opt-in customer-token refresher registry (off unless a refresher is set). */
     customerRefresh?: CustomerRefreshRegistry;
+    /**
+     * Shared storefront request context. When `language` is set, every request
+     * carries `Accept-Language: <language>`. Mutated at runtime via
+     * `EmporixClient.setStorefrontContext({ language })`.
+     */
+    requestContext?: {
+        language?: string | undefined;
+    };
 }
 /** Fetch wrapper: auth resolution, JSON parsing, typed error mapping, logging. */
 declare class HttpClient {
     private readonly opts;
     private readonly sleep;
     constructor(opts: HttpClientOptions);
+    private buildHeaders;
     request<T = unknown>(o: RequestOptions): Promise<T>;
     /**
      * Single-shot fetch that returns the raw {@link Response} unparsed. Used by

package/dist/customer-groups.d.cts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-BBKOwNW6.cjs';
+import { C as ClientContext, b as AuthContext } from './context-CD7F_LHT.cjs';
 
 type AssignmentCreateRequest = {
     /**

package/dist/customer-groups.d.ts

@@ -1,4 +1,4 @@
-import { C as ClientContext, b as AuthContext } from './context-BBKOwNW6.js';
+import { C as ClientContext, b as AuthContext } from './context-CD7F_LHT.js';
 
 type AssignmentCreateRequest = {
     /**

package/dist/customer.d.cts

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

package/dist/customer.d.ts

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

package/dist/index.cjs

@@ -583,6 +583,16 @@ var HttpClient = class {
   }
   opts;
   sleep;
+  buildHeaders(o, token, isFormData) {
+    return {
+      ...this.opts.requestContext?.language ? { "Accept-Language": this.opts.requestContext.language } : {},
+      ...o.headers ?? {},
+      Authorization: `Bearer ${token}`,
+      // JSON bodies: set Content-Type. FormData bodies: let `fetch`
+      // emit `multipart/form-data; boundary=...` itself.
+      ...o.body !== void 0 && !isFormData ? { "Content-Type": "application/json" } : {}
+    };
+  }
   async request(o) {
     const requestId = `req-${++requestSeq}`;
     const log = this.opts.logger.child({ requestId });
@@ -611,13 +621,7 @@ var HttpClient = class {
       const isFormData = typeof FormData !== "undefined" && o.body instanceof FormData;
       const init = {
         method: o.method,
-        headers: {
-          ...o.headers ?? {},
-          Authorization: `Bearer ${token}`,
-          // JSON bodies: set Content-Type. FormData bodies: let `fetch`
-          // emit `multipart/form-data; boundary=...` itself.
-          ...o.body !== void 0 && !isFormData ? { "Content-Type": "application/json" } : {}
-        },
+        headers: this.buildHeaders(o, token, isFormData),
         signal: controller.signal
       };
       if (o.body !== void 0) {
@@ -705,11 +709,7 @@ var HttpClient = class {
     const isFormData = typeof FormData !== "undefined" && o.body instanceof FormData;
     const init = {
       method: o.method,
-      headers: {
-        ...o.headers ?? {},
-        Authorization: `Bearer ${token}`,
-        ...o.body !== void 0 && !isFormData ? { "Content-Type": "application/json" } : {}
-      },
+      headers: this.buildHeaders(o, token, isFormData),
       signal: controller.signal,
       ...extra?.redirect ? { redirect: extra.redirect } : {}
     };
@@ -2902,6 +2902,28 @@ var FeeService = class {
   }
 };
 
+// src/services/cloud-functions.ts
+var CloudFunctionsService = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  ctx;
+  base() {
+    return `/cloud-functions/${this.ctx.tenant}/functions`;
+  }
+  async invoke(functionId, options = {}, authCtx = auth.anonymous()) {
+    const sub = options.path ? `/${options.path.replace(/^\//, "")}` : "";
+    return this.ctx.http.request({
+      method: options.method ?? "POST",
+      path: `${this.base()}/${functionId}${sub}`,
+      auth: authCtx,
+      ...options.body !== void 0 ? { body: options.body } : {},
+      ...options.query ? { query: options.query } : {},
+      ...options.headers ? { headers: options.headers } : {}
+    });
+  }
+};
+
 // src/services/webhook.ts
 var SERVICE8 = { kind: "service" };
 var WebhookService = class {
@@ -5074,7 +5096,7 @@ var ApprovalService = class {
 };
 
 // package.json
-var version = "2.10.0";
+var version = "2.12.0";
 
 // src/version.ts
 var SDK_VERSION = version;
@@ -5105,6 +5127,7 @@ var EmporixClient = class {
   ragIndexer;
   sequentialIds;
   fees;
+  cloudFunctions;
   webhooks;
   schemas;
   ai;
@@ -5142,6 +5165,7 @@ var EmporixClient = class {
   config;
   resolver;
   customerRefresh;
+  requestContext;
   constructor(config) {
     const cfg = validateConfig(config);
     this.tenant = cfg.tenant;
@@ -5165,6 +5189,8 @@ var EmporixClient = class {
     this.tokenProvider = tokenProvider;
     const customerRefresh = new CustomerRefreshRegistry();
     this.customerRefresh = customerRefresh;
+    this.requestContext = { language: cfg.credentials.storefront?.context?.language };
+    const requestContext = this.requestContext;
     const mk = (service) => ({
       tenant: cfg.tenant,
       tokenProvider,
@@ -5175,7 +5201,8 @@ var EmporixClient = class {
         logger: root.child({ service: "http" }),
         retry: cfg.retry,
         timeouts: cfg.timeouts,
-        customerRefresh
+        customerRefresh,
+        requestContext
       })
     });
     this.customers = new CustomerService(mk("customer"));
@@ -5205,6 +5232,7 @@ var EmporixClient = class {
     this.ragIndexer = new RagIndexerService(mk("ai-rag-indexer"));
     this.sequentialIds = new SequentialIdService(mk("sequential-id"));
     this.fees = new FeeService(mk("fee"));
+    this.cloudFunctions = new CloudFunctionsService(mk("cloud-functions"));
     this.webhooks = new WebhookService(mk("webhook"));
     this.schemas = new SchemaService(mk("schema"));
     this.ai = new AiService(mk("ai"));
@@ -5232,9 +5260,18 @@ var EmporixClient = class {
    * next request re-mints a token bound to the new context. Use this to switch
    * currency at runtime. Carts are currency-bound — clear the cart after a
    * currency change (the React `setCurrency` does this for you).
+   *
+   * Also sets the storefront `language` (an `Accept-Language` header on every
+   * read); a language-only change does NOT re-mint the token.
    */
   setStorefrontContext(ctx) {
-    this.tokenProvider.setAnonymousContext?.(ctx);
+    if (ctx.language !== void 0) {
+      this.requestContext.language = ctx.language || void 0;
+    }
+    const { language: _language, ...priceContext } = ctx;
+    if (Object.keys(priceContext).length > 0) {
+      this.tokenProvider.setAnonymousContext?.(priceContext);
+    }
   }
   /** Sets the runtime log level globally or for one service. */
   setLogLevel(level, opts = {}) {
@@ -5271,6 +5308,7 @@ exports.CatalogService = CatalogService;
 exports.CategoryService = CategoryService;
 exports.CheckoutService = CheckoutService;
 exports.ClientConfigService = ClientConfigService;
+exports.CloudFunctionsService = CloudFunctionsService;
 exports.CompaniesService = CompaniesService;
 exports.ContactsService = ContactsService;
 exports.CountryService = CountryService;