@viu/emporix-sdk 2.8.0 → 2.10.0

package/dist/contacts.d.cts

@@ -1,6 +1,5 @@
-import { C as ClientContext, b as AuthContext } from './context-DJDTlhLW.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';
+import { C as ClientContext, b as AuthContext } from './context-BBKOwNW6.cjs';
+import { C as ContactAssignment, a as ContactAssignmentCreate, b as ContactAssignmentUpdate } from './types.gen-C_wOXYZB.cjs';
 
 /**
  * Manages contact assignments linking customers to legal entities.
@@ -19,8 +18,11 @@ declare class ContactsService {
     assign(input: ContactAssignmentCreate, auth: AuthContext): Promise<{
         id: string;
     }>;
-    /** Patches a contact assignment. */
-    update(contactAssignmentId: string, patch: ContactAssignmentUpdate, auth: AuthContext): Promise<ContactAssignment>;
+    /**
+     * Patches a contact assignment. PATCH endpoint, so the body is a partial of
+     * the generated `ContactAssignmentUpdate` shape.
+     */
+    update(contactAssignmentId: string, patch: Partial<ContactAssignmentUpdate>, auth: AuthContext): Promise<ContactAssignment>;
     /** Deletes a contact assignment. */
     unassign(contactAssignmentId: string, auth: AuthContext): Promise<void>;
 }

package/dist/contacts.d.ts

@@ -1,6 +1,5 @@
-import { C as ClientContext, b as AuthContext } from './context-DJDTlhLW.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';
+import { C as ClientContext, b as AuthContext } from './context-BBKOwNW6.js';
+import { C as ContactAssignment, a as ContactAssignmentCreate, b as ContactAssignmentUpdate } from './types.gen-C_wOXYZB.js';
 
 /**
  * Manages contact assignments linking customers to legal entities.
@@ -19,8 +18,11 @@ declare class ContactsService {
     assign(input: ContactAssignmentCreate, auth: AuthContext): Promise<{
         id: string;
     }>;
-    /** Patches a contact assignment. */
-    update(contactAssignmentId: string, patch: ContactAssignmentUpdate, auth: AuthContext): Promise<ContactAssignment>;
+    /**
+     * Patches a contact assignment. PATCH endpoint, so the body is a partial of
+     * the generated `ContactAssignmentUpdate` shape.
+     */
+    update(contactAssignmentId: string, patch: Partial<ContactAssignmentUpdate>, auth: AuthContext): Promise<ContactAssignment>;
     /** Deletes a contact assignment. */
     unassign(contactAssignmentId: string, auth: AuthContext): Promise<void>;
 }

package/dist/contacts.js

@@ -1,3 +1,3 @@
-export { ContactsService } from './chunk-B56JZNI7.js';
+export { ContactsService } from './chunk-HAEVK6IS.js';
 //# sourceMappingURL=contacts.js.map
 //# sourceMappingURL=contacts.js.map

package/dist/{context-DJDTlhLW.d.cts → context-BBKOwNW6.d.cts}

@@ -222,6 +222,16 @@ interface TokenProvider {
      * replaces the previous adapter.
      */
     attachAnonymousStore?(store: AnonymousSessionStore): void;
+    /**
+     * Override the storefront context (currency/site/country) used for the next
+     * anonymous login, then invalidate the current anonymous session so it
+     * re-mints with the new context. No-op for providers without anon support.
+     */
+    setAnonymousContext?(ctx: {
+        currency?: string;
+        siteCode?: string;
+        targetLocation?: string;
+    }): void;
     /**
      * Subscribe to token-refresh events. Optional — implementations may no-op.
      * Returns an unsubscribe function. `DefaultTokenProvider` emits for the
@@ -267,6 +277,7 @@ declare class DefaultTokenProvider implements TokenProvider {
     private anon;
     private anonLock;
     private anonStore?;
+    private contextOverride;
     private readonly refreshListeners;
     constructor(cfg: ResolvedConfig);
     onRefresh(listener: (event: {
@@ -285,6 +296,11 @@ declare class DefaultTokenProvider implements TokenProvider {
     /** Refreshes the anonymous session, preserving its sessionId. */
     refreshAnonymous(): Promise<AnonymousSession>;
     invalidateAnonymous(): void;
+    setAnonymousContext(ctx: {
+        currency?: string;
+        siteCode?: string;
+        targetLocation?: string;
+    }): void;
     /** Force a stale access token while keeping the refresh token + sessionId. */
     expireAnonymous(): void;
     private stripExpiry;

package/dist/{context-DJDTlhLW.d.ts → context-BBKOwNW6.d.ts}

@@ -222,6 +222,16 @@ interface TokenProvider {
      * replaces the previous adapter.
      */
     attachAnonymousStore?(store: AnonymousSessionStore): void;
+    /**
+     * Override the storefront context (currency/site/country) used for the next
+     * anonymous login, then invalidate the current anonymous session so it
+     * re-mints with the new context. No-op for providers without anon support.
+     */
+    setAnonymousContext?(ctx: {
+        currency?: string;
+        siteCode?: string;
+        targetLocation?: string;
+    }): void;
     /**
      * Subscribe to token-refresh events. Optional — implementations may no-op.
      * Returns an unsubscribe function. `DefaultTokenProvider` emits for the
@@ -267,6 +277,7 @@ declare class DefaultTokenProvider implements TokenProvider {
     private anon;
     private anonLock;
     private anonStore?;
+    private contextOverride;
     private readonly refreshListeners;
     constructor(cfg: ResolvedConfig);
     onRefresh(listener: (event: {
@@ -285,6 +296,11 @@ declare class DefaultTokenProvider implements TokenProvider {
     /** Refreshes the anonymous session, preserving its sessionId. */
     refreshAnonymous(): Promise<AnonymousSession>;
     invalidateAnonymous(): void;
+    setAnonymousContext(ctx: {
+        currency?: string;
+        siteCode?: string;
+        targetLocation?: string;
+    }): void;
     /** Force a stale access token while keeping the refresh token + sessionId. */
     expireAnonymous(): void;
     private stripExpiry;

package/dist/customer-groups.cjs

@@ -18,6 +18,23 @@ var CustomerGroupsService = class {
       auth
     });
   }
+  /** Adds a user (customer or employee) to a group. */
+  async addMember(groupId, member, auth) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: `${this.base()}/${groupId}/users`,
+      auth,
+      body: member
+    });
+  }
+  /** Removes a user from a group. */
+  async removeMember(groupId, userId, auth) {
+    await this.ctx.http.request({
+      method: "DELETE",
+      path: `${this.base()}/${groupId}/users/${userId}`,
+      auth
+    });
+  }
 };
 
 exports.CustomerGroupsService = CustomerGroupsService;

package/dist/customer-groups.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/services/customer-groups.ts"],"names":[],"mappings":";;;AAWO,IAAM,wBAAN,MAA4B;AAAA,EACjC,YAA6B,GAAA,EAAoB;AAApB,IAAA,IAAA,CAAA,GAAA,GAAA,GAAA;AAAA,EAAqB;AAAA,EAArB,GAAA;AAAA,EAErB,IAAA,GAAe;AACrB,IAAA,OAAO,CAAA,KAAA,EAAQ,IAAA,CAAK,GAAA,CAAI,MAAM,CAAA,OAAA,CAAA;AAAA,EAChC;AAAA;AAAA,EAGA,MAAM,cAAA,CAAe,aAAA,EAAuB,IAAA,EAAwC;AAClF,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,OAAA,CAAoB;AAAA,MACvC,MAAA,EAAQ,KAAA;AAAA,MACR,IAAA,EAAM,KAAK,IAAA,EAAK;AAAA,MAChB,KAAA,EAAO,EAAE,mBAAA,EAAqB,aAAA,EAAc;AAAA,MAC5C;AAAA,KACD,CAAA;AAAA,EACH;AACF","file":"customer-groups.cjs","sourcesContent":["import type { ClientContext } from \"../core/context\";\nimport type { AuthContext } from \"../core/auth\";\nimport type { IamGroup } from \"../generated/iam\";\n\n/**\n * Read-only access to IAM customer groups for a legal entity.\n *\n * Member-management endpoints (`addMember`/`removeMember`) are deferred —\n * the exact IAM path/body shape isn't in the SDK input set yet. They will\n * land in a small follow-up plan once the API reference is confirmed.\n */\nexport class CustomerGroupsService {\n  constructor(private readonly ctx: ClientContext) {}\n\n  private base(): string {\n    return `/iam/${this.ctx.tenant}/groups`;\n  }\n\n  /** Lists customer groups belonging to one legal entity. */\n  async listForCompany(legalEntityId: string, auth: AuthContext): Promise<IamGroup[]> {\n    return this.ctx.http.request<IamGroup[]>({\n      method: \"GET\",\n      path: this.base(),\n      query: { \"b2b.legalEntityId\": legalEntityId },\n      auth,\n    });\n  }\n}\n"]}
+{"version":3,"sources":["../src/services/customer-groups.ts"],"names":[],"mappings":";;;AAeO,IAAM,wBAAN,MAA4B;AAAA,EACjC,YAA6B,GAAA,EAAoB;AAApB,IAAA,IAAA,CAAA,GAAA,GAAA,GAAA;AAAA,EAAqB;AAAA,EAArB,GAAA;AAAA,EAErB,IAAA,GAAe;AACrB,IAAA,OAAO,CAAA,KAAA,EAAQ,IAAA,CAAK,GAAA,CAAI,MAAM,CAAA,OAAA,CAAA;AAAA,EAChC;AAAA;AAAA,EAGA,MAAM,cAAA,CAAe,aAAA,EAAuB,IAAA,EAAmD;AAC7F,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,OAAA,CAA+B;AAAA,MAClD,MAAA,EAAQ,KAAA;AAAA,MACR,IAAA,EAAM,KAAK,IAAA,EAAK;AAAA,MAChB,KAAA,EAAO,EAAE,mBAAA,EAAqB,aAAA,EAAc;AAAA,MAC5C;AAAA,KACD,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,SAAA,CACJ,OAAA,EACA,MAAA,EACA,IAAA,EACyB;AACzB,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,OAAA,CAAwB;AAAA,MAC3C,MAAA,EAAQ,MAAA;AAAA,MACR,MAAM,CAAA,EAAG,IAAA,CAAK,IAAA,EAAM,IAAI,OAAO,CAAA,MAAA,CAAA;AAAA,MAC/B,IAAA;AAAA,MACA,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,YAAA,CAAa,OAAA,EAAiB,MAAA,EAAgB,IAAA,EAAkC;AACpF,IAAA,MAAM,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,OAAA,CAAc;AAAA,MAChC,MAAA,EAAQ,QAAA;AAAA,MACR,IAAA,EAAM,GAAG,IAAA,CAAK,IAAA,EAAM,CAAA,CAAA,EAAI,OAAO,UAAU,MAAM,CAAA,CAAA;AAAA,MAC/C;AAAA,KACD,CAAA;AAAA,EACH;AACF","file":"customer-groups.cjs","sourcesContent":["import type { ClientContext } from \"../core/context\";\nimport type { AuthContext } from \"../core/auth\";\nimport type {\n  GroupsQueryDocument,\n  AssignmentCreateRequest,\n} from \"../generated/iam\";\n\n/**\n * Access to IAM customer groups for a legal entity.\n *\n * `listForCompany` requires `iam.group_read`; the member mutations\n * (`addMember`/`removeMember`) require `iam.group_manage` — typically only\n * granted to Admin-group customers; a 403 surfaces as\n * `EmporixInsufficientScopeError`.\n */\nexport class CustomerGroupsService {\n  constructor(private readonly ctx: ClientContext) {}\n\n  private base(): string {\n    return `/iam/${this.ctx.tenant}/groups`;\n  }\n\n  /** Lists customer groups belonging to one legal entity. */\n  async listForCompany(legalEntityId: string, auth: AuthContext): Promise<GroupsQueryDocument[]> {\n    return this.ctx.http.request<GroupsQueryDocument[]>({\n      method: \"GET\",\n      path: this.base(),\n      query: { \"b2b.legalEntityId\": legalEntityId },\n      auth,\n    });\n  }\n\n  /** Adds a user (customer or employee) to a group. */\n  async addMember(\n    groupId: string,\n    member: AssignmentCreateRequest,\n    auth: AuthContext,\n  ): Promise<{ id: string }> {\n    return this.ctx.http.request<{ id: string }>({\n      method: \"POST\",\n      path: `${this.base()}/${groupId}/users`,\n      auth,\n      body: member,\n    });\n  }\n\n  /** Removes a user from a group. */\n  async removeMember(groupId: string, userId: string, auth: AuthContext): Promise<void> {\n    await this.ctx.http.request<void>({\n      method: \"DELETE\",\n      path: `${this.base()}/${groupId}/users/${userId}`,\n      auth,\n    });\n  }\n}\n"]}

package/dist/customer-groups.d.cts

@@ -1,36 +1,109 @@
-import { C as ClientContext, b as AuthContext } from './context-DJDTlhLW.cjs';
+import { C as ClientContext, b as AuthContext } from './context-BBKOwNW6.cjs';
 
+type AssignmentCreateRequest = {
+    /**
+     * User unique identifier generated when the user is created. Might be customer ID or Management Dashboard user ID.
+     */
+    userId: string;
+    /**
+     * Assignment type, possible values: CUSTOMER, EMPLOYEE
+     */
+    userType?: 'CUSTOMER' | 'EMPLOYEE';
+};
 /**
- * Hand-written mirror of the minimal IAM Service group shape needed for
- * B2B foundation reads. The Emporix IAM API exposes groups keyed by
- * `b2b.legalEntityId`. Membership-mutation endpoints exist on the server
- * but their exact path/body shape is not in the current SDK input set —
- * `customer-groups.ts` ships read-only here; mutations follow in a small
- * follow-up plan once the API reference is confirmed.
+ * Group metadata.
  */
-interface IamGroupB2B {
-    legalEntityId?: string;
-}
-interface IamGroup {
-    id: string;
-    name?: Record<string, string>;
-    role?: string;
-    b2b?: IamGroupB2B;
-}
+type GroupsMetadataQueryDocument = {
+    /**
+     * Group document version.
+     */
+    version: number;
+    /**
+     * Timestamp indicating when the group was created.
+     */
+    createdAt: string;
+    /**
+     * Timestamp indicating when the group was last modified.
+     */
+    modifiedAt?: string;
+};
+/**
+ * Definition of groups
+ */
+type GroupsQueryDocument = {
+    /**
+     * Group unique identifier generated when the group is created.
+     */
+    id?: string;
+    /**
+     * Localized group name in the form of a map of translations.
+     */
+    name?: {
+        [key: string]: string;
+    };
+    /**
+     * Localized group description in the form of a map of translations.
+     */
+    description?: {
+        [key: string]: string;
+    };
+    /**
+     * An identifier of a vendor to whom the group belongs. Can only be set during creation and is immutable thereafter. A group with vendorId can only be assigned to users of type `EMPLOYEE`
+     */
+    readonly vendorId?: string;
+    /**
+     * Access control unique identifiers associated with this group.
+     */
+    accessControls?: Array<string>;
+    /**
+     * Template unique identifiers associated with this group.
+     */
+    templates?: Array<string>;
+    code?: string;
+    /**
+     * The group type determines if the group can consist of users of the `CUSTOMER` or the `EMPLOYEE` type.
+     */
+    userType?: string;
+    /**
+     * additional properties for B2B
+     */
+    b2b?: {
+        /**
+         * identifier of the assigned legal entity
+         */
+        legalEntityId?: string;
+    };
+    restrictions?: Restrictions;
+    /**
+     * Custom group attributes that need to be included directly in the `mixins` object.
+     */
+    mixins?: {
+        [key: string]: string;
+    };
+    metadata?: GroupsMetadataQueryDocument;
+};
+type Restrictions = Array<string>;
 
 /**
- * Read-only access to IAM customer groups for a legal entity.
+ * Access to IAM customer groups for a legal entity.
  *
- * Member-management endpoints (`addMember`/`removeMember`) are deferred —
- * the exact IAM path/body shape isn't in the SDK input set yet. They will
- * land in a small follow-up plan once the API reference is confirmed.
+ * `listForCompany` requires `iam.group_read`; the member mutations
+ * (`addMember`/`removeMember`) require `iam.group_manage` — typically only
+ * granted to Admin-group customers; a 403 surfaces as
+ * `EmporixInsufficientScopeError`.
  */
 declare class CustomerGroupsService {
     private readonly ctx;
     constructor(ctx: ClientContext);
     private base;
     /** Lists customer groups belonging to one legal entity. */
-    listForCompany(legalEntityId: string, auth: AuthContext): Promise<IamGroup[]>;
+    listForCompany(legalEntityId: string, auth: AuthContext): Promise<GroupsQueryDocument[]>;
+    /** Adds a user (customer or employee) to a group. */
+    addMember(groupId: string, member: AssignmentCreateRequest, auth: AuthContext): Promise<{
+        id: string;
+    }>;
+    /** Removes a user from a group. */
+    removeMember(groupId: string, userId: string, auth: AuthContext): Promise<void>;
 }
 
-export { CustomerGroupsService, type IamGroup, type IamGroupB2B };
+export { CustomerGroupsService, type GroupsQueryDocument as IamGroup, type AssignmentCreateRequest as IamGroupMemberAssignment };

package/dist/customer-groups.d.ts

@@ -1,36 +1,109 @@
-import { C as ClientContext, b as AuthContext } from './context-DJDTlhLW.js';
+import { C as ClientContext, b as AuthContext } from './context-BBKOwNW6.js';
 
+type AssignmentCreateRequest = {
+    /**
+     * User unique identifier generated when the user is created. Might be customer ID or Management Dashboard user ID.
+     */
+    userId: string;
+    /**
+     * Assignment type, possible values: CUSTOMER, EMPLOYEE
+     */
+    userType?: 'CUSTOMER' | 'EMPLOYEE';
+};
 /**
- * Hand-written mirror of the minimal IAM Service group shape needed for
- * B2B foundation reads. The Emporix IAM API exposes groups keyed by
- * `b2b.legalEntityId`. Membership-mutation endpoints exist on the server
- * but their exact path/body shape is not in the current SDK input set —
- * `customer-groups.ts` ships read-only here; mutations follow in a small
- * follow-up plan once the API reference is confirmed.
+ * Group metadata.
  */
-interface IamGroupB2B {
-    legalEntityId?: string;
-}
-interface IamGroup {
-    id: string;
-    name?: Record<string, string>;
-    role?: string;
-    b2b?: IamGroupB2B;
-}
+type GroupsMetadataQueryDocument = {
+    /**
+     * Group document version.
+     */
+    version: number;
+    /**
+     * Timestamp indicating when the group was created.
+     */
+    createdAt: string;
+    /**
+     * Timestamp indicating when the group was last modified.
+     */
+    modifiedAt?: string;
+};
+/**
+ * Definition of groups
+ */
+type GroupsQueryDocument = {
+    /**
+     * Group unique identifier generated when the group is created.
+     */
+    id?: string;
+    /**
+     * Localized group name in the form of a map of translations.
+     */
+    name?: {
+        [key: string]: string;
+    };
+    /**
+     * Localized group description in the form of a map of translations.
+     */
+    description?: {
+        [key: string]: string;
+    };
+    /**
+     * An identifier of a vendor to whom the group belongs. Can only be set during creation and is immutable thereafter. A group with vendorId can only be assigned to users of type `EMPLOYEE`
+     */
+    readonly vendorId?: string;
+    /**
+     * Access control unique identifiers associated with this group.
+     */
+    accessControls?: Array<string>;
+    /**
+     * Template unique identifiers associated with this group.
+     */
+    templates?: Array<string>;
+    code?: string;
+    /**
+     * The group type determines if the group can consist of users of the `CUSTOMER` or the `EMPLOYEE` type.
+     */
+    userType?: string;
+    /**
+     * additional properties for B2B
+     */
+    b2b?: {
+        /**
+         * identifier of the assigned legal entity
+         */
+        legalEntityId?: string;
+    };
+    restrictions?: Restrictions;
+    /**
+     * Custom group attributes that need to be included directly in the `mixins` object.
+     */
+    mixins?: {
+        [key: string]: string;
+    };
+    metadata?: GroupsMetadataQueryDocument;
+};
+type Restrictions = Array<string>;
 
 /**
- * Read-only access to IAM customer groups for a legal entity.
+ * Access to IAM customer groups for a legal entity.
  *
- * Member-management endpoints (`addMember`/`removeMember`) are deferred —
- * the exact IAM path/body shape isn't in the SDK input set yet. They will
- * land in a small follow-up plan once the API reference is confirmed.
+ * `listForCompany` requires `iam.group_read`; the member mutations
+ * (`addMember`/`removeMember`) require `iam.group_manage` — typically only
+ * granted to Admin-group customers; a 403 surfaces as
+ * `EmporixInsufficientScopeError`.
  */
 declare class CustomerGroupsService {
     private readonly ctx;
     constructor(ctx: ClientContext);
     private base;
     /** Lists customer groups belonging to one legal entity. */
-    listForCompany(legalEntityId: string, auth: AuthContext): Promise<IamGroup[]>;
+    listForCompany(legalEntityId: string, auth: AuthContext): Promise<GroupsQueryDocument[]>;
+    /** Adds a user (customer or employee) to a group. */
+    addMember(groupId: string, member: AssignmentCreateRequest, auth: AuthContext): Promise<{
+        id: string;
+    }>;
+    /** Removes a user from a group. */
+    removeMember(groupId: string, userId: string, auth: AuthContext): Promise<void>;
 }
 
-export { CustomerGroupsService, type IamGroup, type IamGroupB2B };
+export { CustomerGroupsService, type GroupsQueryDocument as IamGroup, type AssignmentCreateRequest as IamGroupMemberAssignment };

package/dist/customer-groups.js

@@ -1,3 +1,3 @@
-export { CustomerGroupsService } from './chunk-SKX7KCMH.js';
+export { CustomerGroupsService } from './chunk-LGOC5XOI.js';
 //# sourceMappingURL=customer-groups.js.map
 //# sourceMappingURL=customer-groups.js.map

package/dist/customer.d.cts

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

package/dist/customer.d.ts

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

package/dist/index.cjs

@@ -396,6 +396,7 @@ var DefaultTokenProvider = class {
   anon;
   anonLock;
   anonStore;
+  contextOverride;
   refreshListeners = /* @__PURE__ */ new Set();
   onRefresh(listener) {
     this.refreshListeners.add(listener);
@@ -508,6 +509,11 @@ var DefaultTokenProvider = class {
     this.anon = void 0;
     this.anonStore?.write(null);
   }
+  setAnonymousContext(ctx) {
+    const base = this.contextOverride ?? this.cfg.credentials.storefront?.context ?? {};
+    this.contextOverride = { ...base, ...ctx };
+    this.invalidateAnonymous();
+  }
   /** Force a stale access token while keeping the refresh token + sessionId. */
   expireAnonymous() {
     if (this.anon) this.anon = { ...this.anon, expiresAt: 0 };
@@ -524,7 +530,7 @@ var DefaultTokenProvider = class {
     const url = new URL(`${this.cfg.host}/customerlogin/auth/anonymous/${mode}`);
     url.searchParams.set("tenant", this.cfg.tenant);
     url.searchParams.set("client_id", sf.clientId);
-    const c = sf.context;
+    const c = this.contextOverride ?? sf.context;
     if (c?.currency) url.searchParams.set("currency", c.currency);
     if (c?.siteCode) url.searchParams.set("siteCode", c.siteCode);
     if (c?.targetLocation) url.searchParams.set("targetLocation", c.targetLocation);
@@ -1001,6 +1007,16 @@ var ProductService = class {
     });
     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 = {}, auth2 = ANON) {
+    const escaped = query.trim().replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    return this.search(`name:(~${escaped})`, params, auth2);
+  }
   /**
    * Bulk fetch by id. POSTs `/products/search` with `q="id:(id1,id2,…)"`,
    * chunking when the list is larger than `options.chunkSize` (default
@@ -1464,6 +1480,16 @@ var PaymentGatewayService = class {
 };
 
 // src/services/price.ts
+function normalizeMatch(raw) {
+  const itemId = raw.itemId ?? raw.itemRef;
+  const base = raw;
+  if (!itemId) return base;
+  const itemRef = {
+    ...itemId.itemType !== void 0 ? { itemType: itemId.itemType } : {},
+    ...itemId.id !== void 0 ? { id: itemId.id } : {}
+  };
+  return { ...base, itemId, itemRef };
+}
 var ANON3 = { kind: "anonymous" };
 var SERVICE = { kind: "service" };
 function requireContextAuth(auth2) {
@@ -1484,24 +1510,26 @@ var PriceService = class {
    * anonymous; pass a customer/raw context for personalized pricing.
    */
   async matchByContext(input, auth2) {
-    return this.ctx.http.request({
+    const rows = await this.ctx.http.request({
       method: "POST",
       path: `/price/${this.ctx.tenant}/match-prices-by-context`,
       auth: requireContextAuth(auth2),
       body: input
     });
+    return rows.map(normalizeMatch);
   }
   /**
    * Resolves prices from an explicit context. Default auth: service
    * (requires `price.price_read` / `price.price_manage`).
    */
   async match(input, auth2 = SERVICE) {
-    return this.ctx.http.request({
+    const rows = await this.ctx.http.request({
       method: "POST",
       path: `/price/${this.ctx.tenant}/match-prices`,
       auth: auth2,
       body: input
     });
+    return rows.map(normalizeMatch);
   }
   /**
    * Chunked variant of {@link matchByContext} for large `items` arrays. The
@@ -1514,7 +1542,7 @@ var PriceService = class {
    * `throwOnAnyChunkError: true` to reject on the first failure instead.
    *
    * **Result order is not guaranteed** — match entries back to your items by
-   * `priceId` / `itemRef.id`.
+   * `priceId` / `itemId.id`.
    */
   async matchByContextChunked(input, opts = {}, auth2) {
     const chunkSize = opts.chunkSize ?? 50;
@@ -2064,7 +2092,10 @@ var CompaniesService = class {
       body: input
     });
   }
-  /** Patches a legal entity. */
+  /**
+   * Patches a legal entity. The endpoint is a PATCH, so the body is a partial
+   * of the generated `LegalEntityUpdate` (full-replace) shape.
+   */
   async update(legalEntityId, patch, auth2) {
     return this.ctx.http.request({
       method: "PATCH",
@@ -2110,7 +2141,10 @@ var ContactsService = class {
       body: input
     });
   }
-  /** Patches a contact assignment. */
+  /**
+   * Patches a contact assignment. PATCH endpoint, so the body is a partial of
+   * the generated `ContactAssignmentUpdate` shape.
+   */
   async update(contactAssignmentId, patch, auth2) {
     return this.ctx.http.request({
       method: "PATCH",
@@ -2164,7 +2198,10 @@ var LocationsService = class {
       body: input
     });
   }
-  /** Patches a location. */
+  /**
+   * Patches a location. PATCH endpoint, so the body is a partial of the
+   * generated `LocationUpdate` shape.
+   */
   async update(locationId, patch, auth2) {
     return this.ctx.http.request({
       method: "PATCH",
@@ -2201,6 +2238,23 @@ var CustomerGroupsService = class {
       auth: auth2
     });
   }
+  /** Adds a user (customer or employee) to a group. */
+  async addMember(groupId, member, auth2) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: `${this.base()}/${groupId}/users`,
+      auth: auth2,
+      body: member
+    });
+  }
+  /** Removes a user from a group. */
+  async removeMember(groupId, userId, auth2) {
+    await this.ctx.http.request({
+      method: "DELETE",
+      path: `${this.base()}/${groupId}/users/${userId}`,
+      auth: auth2
+    });
+  }
 };
 
 // src/services/orders.ts
@@ -5020,7 +5074,7 @@ var ApprovalService = class {
 };
 
 // package.json
-var version = "2.8.0";
+var version = "2.10.0";
 
 // src/version.ts
 var SDK_VERSION = version;
@@ -5172,6 +5226,16 @@ var EmporixClient = class {
     this.customerAdmin = new CustomerAdminService(mk("customer-admin"));
     this.approvals = new ApprovalService(mk("approval"));
   }
+  /**
+   * Re-binds the storefront price context (currency / siteCode / targetLocation)
+   * for anonymous pricing and invalidates the current anonymous session, so the
+   * 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).
+   */
+  setStorefrontContext(ctx) {
+    this.tokenProvider.setAnonymousContext?.(ctx);
+  }
   /** Sets the runtime log level globally or for one service. */
   setLogLevel(level, opts = {}) {
     this.resolver.set(level, opts.service, opts.force ?? false);
@@ -5191,6 +5255,13 @@ var EmporixClient = class {
   }
 };
 
+// src/core/yrn.ts
+function productIdFromYrn(yrn) {
+  if (!yrn) return "";
+  const semi = yrn.lastIndexOf(";");
+  return semi >= 0 ? yrn.slice(semi + 1) : "";
+}
+
 exports.AiService = AiService;
 exports.ApprovalService = ApprovalService;
 exports.AvailabilityService = AvailabilityService;
@@ -5254,6 +5325,7 @@ exports.createConsoleLogger = createConsoleLogger;
 exports.createNoopLogger = createNoopLogger;
 exports.errorFromResponse = errorFromResponse;
 exports.iterateAll = iterateAll;
+exports.productIdFromYrn = productIdFromYrn;
 exports.redact = redact;
 exports.resolveToken = resolveToken;
 exports.validateConfig = validateConfig;