@viu/emporix-sdk 2.15.0 → 2.18.0

package/dist/chunk-PYLWZZC4.js

@@ -0,0 +1,280 @@
+import { requireCustomer } from './chunk-3BDDYX3V.js';
+import { EmporixAuthError, EmporixTimeoutError, EmporixNetworkError } from './chunk-UWGGF4MC.js';
+
+// src/core/auth.ts
+var auth = {
+  /** Service/custom credential set (default `backend`). */
+  service: (credentials) => credentials === void 0 ? { kind: "service" } : { kind: "service", credentials },
+  /** Cached anonymous storefront token. */
+  anonymous: () => ({ kind: "anonymous" }),
+  /** Caller-owned customer bearer token. */
+  customer: (token) => ({ kind: "customer", token }),
+  /** Exact token, no transformation (SSO / token-exchange). */
+  raw: (token) => ({ kind: "raw", token })
+};
+async function resolveToken(ctx, provider) {
+  switch (ctx.kind) {
+    case "service":
+      return provider.getToken(ctx.credentials ?? "backend");
+    case "anonymous":
+      return (await provider.getAnonymousToken()).accessToken;
+    case "customer":
+    case "raw":
+      return ctx.token;
+  }
+}
+var CustomerRefreshRegistry = class {
+  refresher = null;
+  inflight = null;
+  set(refresher) {
+    this.refresher = refresher;
+  }
+  get enabled() {
+    return this.refresher !== null;
+  }
+  /** Concurrent callers share one in-flight refresh. */
+  refresh(expiredToken) {
+    if (!this.refresher) return Promise.resolve(null);
+    if (this.inflight) return this.inflight;
+    const p = Promise.resolve(this.refresher.refresh(expiredToken)).finally(() => {
+      this.inflight = null;
+    });
+    this.inflight = p;
+    return p;
+  }
+};
+var DefaultTokenProvider = class {
+  constructor(cfg) {
+    this.cfg = cfg;
+  }
+  cfg;
+  serviceCache = /* @__PURE__ */ new Map();
+  serviceLocks = /* @__PURE__ */ new Map();
+  anon;
+  anonLock;
+  anonStore;
+  contextOverride;
+  refreshListeners = /* @__PURE__ */ new Set();
+  onRefresh(listener) {
+    this.refreshListeners.add(listener);
+    return () => {
+      this.refreshListeners.delete(listener);
+    };
+  }
+  notifyRefresh(kind, success) {
+    for (const l of this.refreshListeners) {
+      try {
+        l({ kind, success });
+      } catch {
+      }
+    }
+  }
+  attachAnonymousStore(store) {
+    this.anonStore = store;
+    if (!this.anon) {
+      const persisted = store.read();
+      if (persisted) {
+        this.anon = {
+          accessToken: "",
+          refreshToken: persisted.refreshToken,
+          sessionId: persisted.sessionId,
+          expiresIn: 0,
+          expiresAt: 0
+        };
+      }
+    }
+  }
+  creds(set) {
+    if (set === "backend") {
+      const b = this.cfg.credentials.backend;
+      if (!b?.clientId || !b.secret) {
+        throw new EmporixAuthError(
+          "A 'service' AuthContext was used but credentials.backend is not configured"
+        );
+      }
+      return b;
+    }
+    const c = this.cfg.credentials.custom?.[set];
+    if (!c) throw new Error(`Unknown credential set "${set}"`);
+    return c;
+  }
+  fresh(e) {
+    if (!e) return false;
+    const now = Date.now();
+    if (now - e.obtainedAt >= this.cfg.cache.maxLifetimeSeconds * 1e3) return false;
+    return now < e.expiresAt;
+  }
+  async getToken(set) {
+    this.creds(set);
+    const cached = this.serviceCache.get(set);
+    if (this.fresh(cached)) return cached.token;
+    const inflight = this.serviceLocks.get(set);
+    if (inflight) return inflight;
+    const p = this.requestServiceToken(set).finally(() => this.serviceLocks.delete(set));
+    this.serviceLocks.set(set, p);
+    return p;
+  }
+  /**
+   * fetch with the configured read timeout. Token endpoints sit in front of
+   * single-flight locks — one hung call would otherwise block every request
+   * on this credential set forever.
+   */
+  async boundedFetch(url, init = {}) {
+    const ms = this.cfg.timeouts?.readMs ?? 6e4;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), ms);
+    try {
+      return await fetch(url, { ...init, signal: controller.signal });
+    } catch (err) {
+      if (err.name === "AbortError") {
+        throw new EmporixTimeoutError(`token request timed out after ${ms}ms`);
+      }
+      throw new EmporixNetworkError(`token request network failure: ${err.message}`);
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  async requestServiceToken(set) {
+    const c = this.creds(set);
+    const body = new URLSearchParams({
+      grant_type: "client_credentials",
+      client_id: c.clientId,
+      client_secret: c.secret
+    });
+    if (c.scope) body.set("scope", c.scope);
+    const res = await this.boundedFetch(`${this.cfg.host}/oauth/token`, {
+      method: "POST",
+      headers: { "Content-Type": "application/x-www-form-urlencoded" },
+      body
+    });
+    const json = await res.json().catch(() => ({}));
+    if (!res.ok) {
+      throw new EmporixAuthError(`Token request failed for "${set}"`, res.status, json);
+    }
+    const obtainedAt = Date.now();
+    const ttl = Number(json.expires_in ?? 3600);
+    this.serviceCache.set(set, {
+      token: json.access_token,
+      obtainedAt,
+      expiresAt: obtainedAt + (ttl - this.cfg.cache.expirationBufferSeconds) * 1e3
+    });
+    return this.serviceCache.get(set).token;
+  }
+  invalidate(set) {
+    this.serviceCache.delete(set);
+  }
+  anonFresh() {
+    return !!this.anon && Date.now() < this.anon.expiresAt;
+  }
+  async getAnonymousToken() {
+    if (this.anonFresh()) return this.stripExpiry(this.anon);
+    if (this.anonLock) return this.anonLock;
+    const canRefresh = !!this.anon?.refreshToken;
+    const obtain = canRefresh ? this.fetchAnonymous("refresh").catch(() => this.fetchAnonymous("login")) : this.fetchAnonymous("login");
+    const p = obtain.finally(() => {
+      this.anonLock = void 0;
+    });
+    this.anonLock = p;
+    return p;
+  }
+  /** Refreshes the anonymous session, preserving its sessionId. */
+  async refreshAnonymous() {
+    if (!this.anon) return this.getAnonymousToken();
+    return this.fetchAnonymous("refresh");
+  }
+  invalidateAnonymous() {
+    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 };
+  }
+  stripExpiry(s) {
+    const { expiresAt: _expiresAt, ...rest } = s;
+    return rest;
+  }
+  async fetchAnonymous(mode) {
+    const sf = this.cfg.credentials.storefront;
+    if (!sf?.clientId) {
+      throw new Error("credentials.storefront.clientId is required for anonymous tokens");
+    }
+    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 = 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);
+    if (mode === "refresh" && this.anon) {
+      url.searchParams.set("refresh_token", this.anon.refreshToken);
+    }
+    try {
+      const res = await this.boundedFetch(url, { method: "GET" });
+      const json = await res.json().catch(() => ({}));
+      if (!res.ok) {
+        this.notifyRefresh("anonymous", false);
+        throw new EmporixAuthError(`Anonymous token ${mode} failed`, res.status, json);
+      }
+      const obtainedAt = Date.now();
+      this.anon = {
+        accessToken: json.access_token,
+        refreshToken: json.refresh_token,
+        sessionId: json.sessionId,
+        expiresIn: json.expires_in,
+        expiresAt: obtainedAt + (json.expires_in - this.cfg.cache.expirationBufferSeconds) * 1e3
+      };
+      this.anonStore?.write({
+        refreshToken: this.anon.refreshToken,
+        sessionId: this.anon.sessionId
+      });
+      this.notifyRefresh("anonymous", true);
+      return this.stripExpiry(this.anon);
+    } catch (err) {
+      if (!(err instanceof EmporixAuthError)) {
+        this.notifyRefresh("anonymous", false);
+      }
+      throw err;
+    }
+  }
+};
+
+// src/services/payment.ts
+var ANON = auth.anonymous();
+var PaymentGatewayService = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  ctx;
+  static channel = "payment";
+  /**
+   * Lists configured frontend payment modes. The endpoint requires a bearer
+   * token but no customer scope ("No scope required"), so it defaults to an
+   * anonymous context and works for guests and logged-in customers alike.
+   */
+  async listPaymentModes(authCtx = ANON) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `/payment-gateway/${this.ctx.tenant}/paymentmodes/frontend`,
+      auth: authCtx
+    });
+  }
+  /** Authorizes a post-checkout (deferred) payment for an existing order. */
+  async authorize(input, authCtx) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: `/payment-gateway/${this.ctx.tenant}/payment/frontend/authorize`,
+      auth: requireCustomer(authCtx),
+      body: input
+    });
+  }
+};
+
+export { CustomerRefreshRegistry, DefaultTokenProvider, PaymentGatewayService, auth, resolveToken };
+//# sourceMappingURL=chunk-PYLWZZC4.js.map
+//# sourceMappingURL=chunk-PYLWZZC4.js.map

package/dist/chunk-PYLWZZC4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/auth.ts","../src/services/payment.ts"],"names":[],"mappings":"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","file":"chunk-PYLWZZC4.js","sourcesContent":["import type { ResolvedConfig, ServiceCredentials } from \"./config\";\nimport { EmporixAuthError, EmporixTimeoutError, EmporixNetworkError } from \"./errors\";\n\n/** Which token a call should use. */\nexport type AuthKind = \"service\" | \"customer\" | \"anonymous\" | \"raw\";\n\n/** Caller-supplied, per-call auth selector. Never stored on the client. */\nexport type AuthContext =\n  | { kind: \"service\"; credentials?: string }\n  | { kind: \"anonymous\" }\n  | { kind: \"customer\"; token: string }\n  | { kind: \"raw\"; token: string };\n\n/**\n * Supplies a fresh customer token when a `customer`-kind request 401s. The host\n * (e.g. EmporixProvider) implements this; the SDK never refreshes the\n * caller-owned customer token unless a refresher is registered.\n */\nexport interface CustomerTokenRefresher {\n  /**\n   * Called on a `customer`-kind 401. Receives the token that just failed;\n   * returns a fresh customer token to retry with, or `null` to give up (the\n   * 401 then propagates as EmporixAuthError).\n   */\n  refresh(expiredToken: string): Promise<string | null>;\n}\n\n/** An obtained anonymous storefront session. */\nexport interface AnonymousSession {\n  accessToken: string;\n  refreshToken: string;\n  sessionId: string;\n  expiresIn: number;\n}\n\n/**\n * Persistence callback for anonymous sessions. `read` is called once on the\n * first need for an anonymous token to bootstrap a possibly-existing session;\n * `write` is called after every successful login or refresh. `write(null)`\n * means the SDK is invalidating the stored session.\n */\nexport interface AnonymousSessionStore {\n  read(): { refreshToken: string; sessionId: string } | null;\n  write(session: { refreshToken: string; sessionId: string } | null): void;\n}\n\n/** Supplies SDK-managed tokens (service/custom + anonymous). May be user-injected. */\nexport interface TokenProvider {\n  /** Service/custom client-credentials token for the named credential set. */\n  getToken(credentialSet: string): Promise<string>;\n  /** Cached anonymous storefront session (preserves sessionId across refreshes). */\n  getAnonymousToken(): Promise<AnonymousSession>;\n  /** Refresh the anonymous session, preserving sessionId. */\n  refreshAnonymous?(): Promise<AnonymousSession>;\n  /** Invalidate a cached SDK-managed token so the next call re-auths. */\n  invalidate?(credentialSet: string): void;\n  /** Invalidate the cached anonymous session entirely (next call re-logs in). */\n  invalidateAnonymous?(): void;\n  /**\n   * Mark the anonymous access token stale but keep the refresh token, so the\n   * next {@link getAnonymousToken} refreshes (preserving sessionId) rather\n   * than starting a brand-new session.\n   */\n  expireAnonymous?(): void;\n  /**\n   * Install a persistence adapter for the anonymous session. The host (e.g.\n   * `EmporixProvider`) calls this at construction so the SDK can bootstrap\n   * an existing session and persist refreshes. Idempotent: a later call\n   * replaces the previous adapter.\n   */\n  attachAnonymousStore?(store: AnonymousSessionStore): void;\n  /**\n   * Override the storefront context (currency/site/country) used for the next\n   * anonymous login, then invalidate the current anonymous session so it\n   * re-mints with the new context. No-op for providers without anon support.\n   */\n  setAnonymousContext?(ctx: {\n    currency?: string;\n    siteCode?: string;\n    targetLocation?: string;\n  }): void;\n  /**\n   * Subscribe to token-refresh events. Optional — implementations may no-op.\n   * Returns an unsubscribe function. `DefaultTokenProvider` emits for the\n   * anonymous-login / anonymous-refresh paths.\n   */\n  onRefresh?(\n    listener: (event: { kind: \"anonymous\" | \"customer\"; success: boolean }) => void,\n  ): () => void;\n}\n\n/** Tiny constructors for {@link AuthContext}. */\nexport const auth = {\n  /** Service/custom credential set (default `backend`). */\n  service: (credentials?: string): AuthContext =>\n    credentials === undefined ? { kind: \"service\" } : { kind: \"service\", credentials },\n  /** Cached anonymous storefront token. */\n  anonymous: (): AuthContext => ({ kind: \"anonymous\" }),\n  /** Caller-owned customer bearer token. */\n  customer: (token: string): AuthContext => ({ kind: \"customer\", token }),\n  /** Exact token, no transformation (SSO / token-exchange). */\n  raw: (token: string): AuthContext => ({ kind: \"raw\", token }),\n};\n\n/** Resolves an {@link AuthContext} to a concrete bearer token. */\nexport async function resolveToken(ctx: AuthContext, provider: TokenProvider): Promise<string> {\n  switch (ctx.kind) {\n    case \"service\":\n      return provider.getToken(ctx.credentials ?? \"backend\");\n    case \"anonymous\":\n      return (await provider.getAnonymousToken()).accessToken;\n    case \"customer\":\n    case \"raw\":\n      return ctx.token;\n  }\n}\n\n/**\n * Late-bindable, single-flight holder for an optional\n * {@link CustomerTokenRefresher}. Single-flight is required because Emporix\n * rotates the refresh token on each refresh — concurrent refreshes would\n * invalidate each other. Off (returns `null`) until a refresher is set.\n */\nexport class CustomerRefreshRegistry {\n  private refresher: CustomerTokenRefresher | null = null;\n  private inflight: Promise<string | null> | null = null;\n\n  set(refresher: CustomerTokenRefresher | null): void {\n    this.refresher = refresher;\n  }\n\n  get enabled(): boolean {\n    return this.refresher !== null;\n  }\n\n  /** Concurrent callers share one in-flight refresh. */\n  refresh(expiredToken: string): Promise<string | null> {\n    if (!this.refresher) return Promise.resolve(null);\n    if (this.inflight) return this.inflight;\n    const p = Promise.resolve(this.refresher.refresh(expiredToken)).finally(() => {\n      this.inflight = null;\n    });\n    this.inflight = p;\n    return p;\n  }\n}\n\ninterface CacheEntry {\n  token: string;\n  expiresAt: number;\n  obtainedAt: number;\n}\n\n/** SDK-owned token provider: client-credentials service tokens + anonymous session. */\nexport class DefaultTokenProvider implements TokenProvider {\n  private readonly serviceCache = new Map<string, CacheEntry>();\n  private readonly serviceLocks = new Map<string, Promise<string>>();\n  private anon: (AnonymousSession & { expiresAt: number }) | undefined;\n  private anonLock: Promise<AnonymousSession> | undefined;\n  private anonStore?: AnonymousSessionStore;\n  private contextOverride:\n    | { currency?: string; siteCode?: string; targetLocation?: string }\n    | undefined;\n  private readonly refreshListeners = new Set<\n    (event: { kind: \"anonymous\" | \"customer\"; success: boolean }) => void\n  >();\n\n  constructor(private readonly cfg: ResolvedConfig) {}\n\n  onRefresh(\n    listener: (event: { kind: \"anonymous\" | \"customer\"; success: boolean }) => void,\n  ): () => void {\n    this.refreshListeners.add(listener);\n    return () => {\n      this.refreshListeners.delete(listener);\n    };\n  }\n\n  private notifyRefresh(kind: \"anonymous\" | \"customer\", success: boolean): void {\n    for (const l of this.refreshListeners) {\n      try {\n        l({ kind, success });\n      } catch {\n        // Never let a telemetry listener break the auth path.\n      }\n    }\n  }\n\n  attachAnonymousStore(store: AnonymousSessionStore): void {\n    this.anonStore = store;\n    // Bootstrap `this.anon` from the store if we don't have it yet. The seeded\n    // session has expiresAt = 0 so the next getAnonymousToken triggers a refresh\n    // (which preserves sessionId) instead of a fresh login.\n    if (!this.anon) {\n      const persisted = store.read();\n      if (persisted) {\n        this.anon = {\n          accessToken: \"\",\n          refreshToken: persisted.refreshToken,\n          sessionId: persisted.sessionId,\n          expiresIn: 0,\n          expiresAt: 0,\n        };\n      }\n    }\n  }\n\n  private creds(set: string): ServiceCredentials {\n    if (set === \"backend\") {\n      const b = this.cfg.credentials.backend;\n      if (!b?.clientId || !b.secret) {\n        throw new EmporixAuthError(\n          \"A 'service' AuthContext was used but credentials.backend is not configured\",\n        );\n      }\n      return b;\n    }\n    const c = this.cfg.credentials.custom?.[set];\n    if (!c) throw new Error(`Unknown credential set \"${set}\"`);\n    return c;\n  }\n\n  private fresh(e: CacheEntry | undefined): boolean {\n    if (!e) return false;\n    const now = Date.now();\n    if (now - e.obtainedAt >= this.cfg.cache.maxLifetimeSeconds * 1000) return false;\n    return now < e.expiresAt;\n  }\n\n  async getToken(set: string): Promise<string> {\n    // Surface an unknown credential set before entering the cache/lock path.\n    this.creds(set);\n    const cached = this.serviceCache.get(set);\n    if (this.fresh(cached)) return cached!.token;\n    const inflight = this.serviceLocks.get(set);\n    if (inflight) return inflight;\n    const p = this.requestServiceToken(set).finally(() => this.serviceLocks.delete(set));\n    this.serviceLocks.set(set, p);\n    return p;\n  }\n\n  /**\n   * fetch with the configured read timeout. Token endpoints sit in front of\n   * single-flight locks — one hung call would otherwise block every request\n   * on this credential set forever.\n   */\n  private async boundedFetch(url: string | URL, init: RequestInit = {}): Promise<Response> {\n    const ms = this.cfg.timeouts?.readMs ?? 60_000;\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), ms);\n    try {\n      return await fetch(url, { ...init, signal: controller.signal });\n    } catch (err) {\n      if ((err as Error).name === \"AbortError\") {\n        throw new EmporixTimeoutError(`token request timed out after ${ms}ms`);\n      }\n      throw new EmporixNetworkError(`token request network failure: ${(err as Error).message}`);\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  private async requestServiceToken(set: string): Promise<string> {\n    const c = this.creds(set);\n    const body = new URLSearchParams({\n      grant_type: \"client_credentials\",\n      client_id: c.clientId,\n      client_secret: c.secret,\n    });\n    if (c.scope) body.set(\"scope\", c.scope);\n    const res = await this.boundedFetch(`${this.cfg.host}/oauth/token`, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/x-www-form-urlencoded\" },\n      body,\n    });\n    const json = (await res.json().catch(() => ({}))) as Record<string, unknown>;\n    if (!res.ok) {\n      throw new EmporixAuthError(`Token request failed for \"${set}\"`, res.status, json);\n    }\n    const obtainedAt = Date.now();\n    const ttl = Number((json.expires_in as number | undefined) ?? 3600);\n    this.serviceCache.set(set, {\n      token: json.access_token as string,\n      obtainedAt,\n      expiresAt: obtainedAt + (ttl - this.cfg.cache.expirationBufferSeconds) * 1000,\n    });\n    return this.serviceCache.get(set)!.token;\n  }\n\n  invalidate(set: string): void {\n    this.serviceCache.delete(set);\n  }\n\n  private anonFresh(): boolean {\n    return !!this.anon && Date.now() < this.anon.expiresAt;\n  }\n\n  async getAnonymousToken(): Promise<AnonymousSession> {\n    if (this.anonFresh()) return this.stripExpiry(this.anon!);\n    if (this.anonLock) return this.anonLock;\n    // Token expired but a refresh token survives → refresh to keep the same\n    // sessionId; only fall back to a brand-new login if the refresh fails.\n    const canRefresh = !!this.anon?.refreshToken;\n    const obtain = canRefresh\n      ? this.fetchAnonymous(\"refresh\").catch(() => this.fetchAnonymous(\"login\"))\n      : this.fetchAnonymous(\"login\");\n    const p = obtain.finally(() => {\n      this.anonLock = undefined;\n    });\n    this.anonLock = p;\n    return p;\n  }\n\n  /** Refreshes the anonymous session, preserving its sessionId. */\n  async refreshAnonymous(): Promise<AnonymousSession> {\n    if (!this.anon) return this.getAnonymousToken();\n    return this.fetchAnonymous(\"refresh\");\n  }\n\n  invalidateAnonymous(): void {\n    this.anon = undefined;\n    this.anonStore?.write(null);\n  }\n\n  setAnonymousContext(ctx: {\n    currency?: string;\n    siteCode?: string;\n    targetLocation?: string;\n  }): void {\n    const base = this.contextOverride ?? this.cfg.credentials.storefront?.context ?? {};\n    this.contextOverride = { ...base, ...ctx };\n    this.invalidateAnonymous();\n  }\n\n  /** Force a stale access token while keeping the refresh token + sessionId. */\n  expireAnonymous(): void {\n    if (this.anon) this.anon = { ...this.anon, expiresAt: 0 };\n  }\n\n  private stripExpiry(s: AnonymousSession & { expiresAt: number }): AnonymousSession {\n    const { expiresAt: _expiresAt, ...rest } = s;\n    return rest;\n  }\n\n  private async fetchAnonymous(mode: \"login\" | \"refresh\"): Promise<AnonymousSession> {\n    const sf = this.cfg.credentials.storefront;\n    if (!sf?.clientId) {\n      throw new Error(\"credentials.storefront.clientId is required for anonymous tokens\");\n    }\n    const url = new URL(`${this.cfg.host}/customerlogin/auth/anonymous/${mode}`);\n    url.searchParams.set(\"tenant\", this.cfg.tenant);\n    url.searchParams.set(\"client_id\", sf.clientId);\n    // Context is the runtime override (set via setAnonymousContext) if present,\n    // else the config-fixed context.\n    const c = this.contextOverride ?? sf.context;\n    if (c?.currency) url.searchParams.set(\"currency\", c.currency);\n    if (c?.siteCode) url.searchParams.set(\"siteCode\", c.siteCode);\n    if (c?.targetLocation) url.searchParams.set(\"targetLocation\", c.targetLocation);\n    if (mode === \"refresh\" && this.anon) {\n      url.searchParams.set(\"refresh_token\", this.anon.refreshToken);\n    }\n    try {\n      const res = await this.boundedFetch(url, { method: \"GET\" });\n      const json = (await res.json().catch(() => ({}))) as Record<string, unknown>;\n      if (!res.ok) {\n        this.notifyRefresh(\"anonymous\", false);\n        throw new EmporixAuthError(`Anonymous token ${mode} failed`, res.status, json);\n      }\n      const obtainedAt = Date.now();\n      this.anon = {\n        accessToken: json.access_token as string,\n        refreshToken: json.refresh_token as string,\n        sessionId: json.sessionId as string,\n        expiresIn: json.expires_in as number,\n        expiresAt:\n          obtainedAt +\n          ((json.expires_in as number) - this.cfg.cache.expirationBufferSeconds) * 1000,\n      };\n      this.anonStore?.write({\n        refreshToken: this.anon.refreshToken,\n        sessionId: this.anon.sessionId,\n      });\n      this.notifyRefresh(\"anonymous\", true);\n      return this.stripExpiry(this.anon);\n    } catch (err) {\n      // Re-throw EmporixAuthError as-is; for non-Emporix errors (network), also notify.\n      if (!(err instanceof EmporixAuthError)) {\n        this.notifyRefresh(\"anonymous\", false);\n      }\n      throw err;\n    }\n  }\n}\n// Customer-token refreshes happen via client.customers.refresh() and don't\n// route through this TokenProvider — only the anonymous flow notifies.\n// React-side useCustomerSession.refresh emits its own telemetry event in a\n// follow-up if needed.\n","import type { ClientContext } from \"../core/context\";\nimport { auth, type AuthContext } from \"../core/auth\";\nimport { requireCustomer } from \"../core/require-customer\";\nimport type {\n  PaymentModeFrontendResponse,\n  AuthorizePaymentRequest,\n} from \"../generated/payment\";\n\nconst ANON: AuthContext = auth.anonymous();\n\n/** A frontend payment mode (generated). */\nexport type PaymentMode = PaymentModeFrontendResponse;\n\n/** Post-checkout authorize request (generated; caller sends the exact wire shape). */\nexport type AuthorizePaymentInput = AuthorizePaymentRequest;\n\n/** Post-checkout authorize result. */\nexport interface AuthorizePaymentResult {\n  successful: boolean;\n  paymentTransactionId?: string;\n  authorizationToken?: string;\n  requiresExternalPayment?: boolean;\n  externalPaymentRedirectURL?: string;\n  externalPaymentHttpMethod?: string;\n  [k: string]: unknown;\n}\n\n/** Payment-Gateway: list frontend payment modes, authorize deferred payments. */\nexport class PaymentGatewayService {\n  static readonly channel = \"payment\" as const;\n  constructor(private readonly ctx: ClientContext) {}\n\n  /**\n   * Lists configured frontend payment modes. The endpoint requires a bearer\n   * token but no customer scope (\"No scope required\"), so it defaults to an\n   * anonymous context and works for guests and logged-in customers alike.\n   */\n  async listPaymentModes(authCtx: AuthContext = ANON): Promise<PaymentMode[]> {\n    return this.ctx.http.request<PaymentMode[]>({\n      method: \"GET\",\n      path: `/payment-gateway/${this.ctx.tenant}/paymentmodes/frontend`,\n      auth: authCtx,\n    });\n  }\n\n  /** Authorizes a post-checkout (deferred) payment for an existing order. */\n  async authorize(\n    input: AuthorizePaymentInput,\n    authCtx?: AuthContext,\n  ): Promise<AuthorizePaymentResult> {\n    return this.ctx.http.request<AuthorizePaymentResult>({\n      method: \"POST\",\n      path: `/payment-gateway/${this.ctx.tenant}/payment/frontend/authorize`,\n      auth: requireCustomer(authCtx),\n      body: input,\n    });\n  }\n}\n"]}

package/dist/chunk-S5HEIQDK.js

@@ -0,0 +1,14 @@
+// src/core/query.ts
+function resolveQuery(q, cap) {
+  if (typeof q === "string") return q;
+  if (q.usesCompound === true && !cap.compoundLogicalQuery) {
+    throw new Error(
+      "This filter uses or()/compoundLogicalQuery, which the target service does not support. Combine conditions with and() (space-separated AND) instead."
+    );
+  }
+  return q.toString();
+}
+
+export { resolveQuery };
+//# sourceMappingURL=chunk-S5HEIQDK.js.map
+//# sourceMappingURL=chunk-S5HEIQDK.js.map

package/dist/chunk-S5HEIQDK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/query.ts"],"names":[],"mappings":";AA4BO,SAAS,YAAA,CAAa,GAAa,GAAA,EAA8B;AACtE,EAAA,IAAI,OAAO,CAAA,KAAM,QAAA,EAAU,OAAO,CAAA;AAClC,EAAA,IAAI,CAAA,CAAE,YAAA,KAAiB,IAAA,IAAQ,CAAC,IAAI,oBAAA,EAAsB;AACxD,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KAEF;AAAA,EACF;AACA,EAAA,OAAO,EAAE,QAAA,EAAS;AACpB","file":"chunk-S5HEIQDK.js","sourcesContent":["/**\n * A built query filter — structurally matched, NOT imported, so the SDK stays\n * decoupled from `@viu/emporix-mixins` (which lists the SDK as an optional\n * peer; a real import would be circular). `@viu/emporix-mixins`' `MixinFilter<E>`\n * satisfies this shape.\n */\nexport interface BuiltQuery<E extends string = string> {\n  toString(): string;\n  readonly usesCompound?: boolean;\n  /** Phantom entity tag — gates which service a filter may be passed to. */\n  readonly __entity?: E;\n}\n\n/** A `q` value a service method accepts: a raw DSL string or a built filter for entity `E`. */\nexport type QueryFor<E extends string = string> = string | BuiltQuery<E>;\n\n/** Per-service capability flags consulted by {@link resolveQuery}. */\nexport interface QueryCapability {\n  /** Whether the target service supports the `compoundLogicalQuery` (OR) operator. */\n  compoundLogicalQuery: boolean;\n}\n\n/**\n * Normalizes a `string | BuiltQuery` into a `q` string and enforces the\n * `compoundLogicalQuery` capability gate: an `or()`-built filter passed to a\n * service that does not support it throws rather than silently producing a\n * query the backend cannot execute.\n */\nexport function resolveQuery(q: QueryFor, cap: QueryCapability): string {\n  if (typeof q === \"string\") return q;\n  if (q.usesCompound === true && !cap.compoundLogicalQuery) {\n    throw new Error(\n      \"This filter uses or()/compoundLogicalQuery, which the target service does not support. \" +\n        \"Combine conditions with and() (space-separated AND) instead.\",\n    );\n  }\n  return q.toString();\n}\n"]}

package/dist/index.cjs

@@ -783,7 +783,7 @@ var HttpClient = class {
 };
 
 // package.json
-var version = "2.15.0";
+var version = "2.18.0";
 
 // src/version.ts
 var SDK_VERSION = version;
@@ -1071,6 +1071,17 @@ async function* iterateAll(fetchPage, start = 1) {
   }
 }
 
+// src/core/query.ts
+function resolveQuery(q, cap) {
+  if (typeof q === "string") return q;
+  if (q.usesCompound === true && !cap.compoundLogicalQuery) {
+    throw new Error(
+      "This filter uses or()/compoundLogicalQuery, which the target service does not support. Combine conditions with and() (space-separated AND) instead."
+    );
+  }
+  return q.toString();
+}
+
 // src/services/product.ts
 var ANON = { kind: "anonymous" };
 var ProductService = class {
@@ -1116,14 +1127,19 @@ var ProductService = class {
     const pageSize = params.pageSize ?? 50;
     return iterateAll((pageNumber) => this.list({ pageNumber, pageSize }, auth2));
   }
-  /** Searches products by free-text query. */
+  /**
+   * 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 = {}, auth2 = 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: query, pageNumber, pageSize },
+      query: { q, pageNumber, pageSize },
       auth: auth2
     });
     return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };
@@ -1261,6 +1277,23 @@ var CategoryService = class {
     });
     return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };
   }
+  /**
+   * Searches categories by a `q` filter — a raw Emporix DSL string or a built
+   * filter (e.g. `@viu/emporix-mixins`' `mixinQuery(...)`). Category does not
+   * support `compoundLogicalQuery`, so `or()` filters are rejected.
+   */
+  async search(query, params = {}, auth2 = ANON2) {
+    const q = resolveQuery(query, { compoundLogicalQuery: false });
+    const pageNumber = params.pageNumber ?? 1;
+    const pageSize = params.pageSize ?? 50;
+    const items = await this.ctx.http.request({
+      method: "GET",
+      path: `/category/${this.ctx.tenant}/categories`,
+      query: { q, pageNumber, pageSize },
+      auth: auth2
+    });
+    return { items, pageNumber, pageSize, hasNextPage: items.length === pageSize };
+  }
   /** Async-iterates every category across pages. */
   listAll(params = {}, auth2 = ANON2) {
     const pageSize = params.pageSize ?? 50;
@@ -1585,26 +1618,31 @@ var CheckoutService = class {
 };
 
 // src/services/payment.ts
+var ANON3 = auth.anonymous();
 var PaymentGatewayService = class {
   constructor(ctx) {
     this.ctx = ctx;
   }
   ctx;
   static channel = "payment";
-  /** Lists configured frontend payment modes. */
-  async listPaymentModes(auth2) {
+  /**
+   * Lists configured frontend payment modes. The endpoint requires a bearer
+   * token but no customer scope ("No scope required"), so it defaults to an
+   * anonymous context and works for guests and logged-in customers alike.
+   */
+  async listPaymentModes(authCtx = ANON3) {
     return this.ctx.http.request({
       method: "GET",
       path: `/payment-gateway/${this.ctx.tenant}/paymentmodes/frontend`,
-      auth: requireCustomer(auth2)
+      auth: authCtx
     });
   }
   /** Authorizes a post-checkout (deferred) payment for an existing order. */
-  async authorize(input, auth2) {
+  async authorize(input, authCtx) {
     return this.ctx.http.request({
       method: "POST",
       path: `/payment-gateway/${this.ctx.tenant}/payment/frontend/authorize`,
-      auth: requireCustomer(auth2),
+      auth: requireCustomer(authCtx),
       body: input
     });
   }
@@ -1621,10 +1659,10 @@ function normalizeMatch(raw) {
   };
   return { ...base, itemId, itemRef };
 }
-var ANON3 = { kind: "anonymous" };
+var ANON4 = { kind: "anonymous" };
 var SERVICE = { kind: "service" };
 function requireContextAuth(auth2) {
-  const a = auth2 ?? ANON3;
+  const a = auth2 ?? ANON4;
   if (a.kind === "anonymous" || a.kind === "customer" || a.kind === "raw") return a;
   throw new EmporixAuthError(
     "match-prices-by-context requires an anonymous, customer, or raw AuthContext"
@@ -2096,7 +2134,7 @@ var SegmentService = class {
 };
 
 // src/services/site.ts
-var ANON4 = auth.anonymous();
+var ANON5 = auth.anonymous();
 var SiteService = class {
   constructor(ctx) {
     this.ctx = ctx;
@@ -2104,7 +2142,7 @@ var SiteService = class {
   ctx;
   static channel = "site";
   /** Lists active sites. */
-  async list(authCtx = ANON4) {
+  async list(authCtx = ANON5) {
     return this.ctx.http.request({
       method: "GET",
       path: `/site/${this.ctx.tenant}/sites`,
@@ -2112,7 +2150,7 @@ var SiteService = class {
     });
   }
   /** Retrieves one site by code. */
-  async get(code, authCtx = ANON4) {
+  async get(code, authCtx = ANON5) {
     return this.ctx.http.request({
       method: "GET",
       path: `/site/${this.ctx.tenant}/sites/${code}`,
@@ -2123,7 +2161,7 @@ var SiteService = class {
    * Returns the tenant's default site (the one with `default: true`).
    * Throws if no default is configured — a tenant should always have one.
    */
-  async current(authCtx = ANON4) {
+  async current(authCtx = ANON5) {
     const sites = await this.list(authCtx);
     const def = sites.find((s) => s.default);
     if (!def) {
@@ -2136,7 +2174,7 @@ var SiteService = class {
 };
 
 // src/services/session-context.ts
-var ANON5 = auth.anonymous();
+var ANON6 = auth.anonymous();
 var SessionContextService = class {
   constructor(ctx) {
     this.ctx = ctx;
@@ -2148,7 +2186,7 @@ var SessionContextService = class {
    * 404 (no session exists yet — the session-context is created server-side
    * only after the user creates a cart).
    */
-  async get(authCtx = ANON5) {
+  async get(authCtx = ANON6) {
     try {
       return await this.ctx.http.request({
         method: "GET",
@@ -2166,7 +2204,7 @@ var SessionContextService = class {
    * server returned 404 on the version-lookup GET, so there is nothing to
    * update). Non-404 errors propagate.
    */
-  async patch(input, authCtx = ANON5) {
+  async patch(input, authCtx = ANON6) {
     let version2 = input.version;
     if (version2 === void 0) {
       const current = await this.get(authCtx);
@@ -2431,6 +2469,9 @@ var OrdersService = class {
     setIfDefined2(query, "status", opts.status);
     setIfDefined2(query, "legalEntityId", opts.legalEntityId);
     setIfDefined2(query, "siteCode", opts.siteCode);
+    if (opts.q !== void 0) {
+      setIfDefined2(query, "q", resolveQuery(opts.q, { compoundLogicalQuery: false }));
+    }
     const headers = this.saasHeader(opts.saasToken);
     const items = await this.ctx.http.request({
       method: "GET",
@@ -2501,7 +2542,7 @@ var SalesOrdersService = class {
 };
 
 // src/services/availability.ts
-var ANON6 = { kind: "anonymous" };
+var ANON7 = { kind: "anonymous" };
 var AvailabilityService = class {
   constructor(ctx) {
     this.ctx = ctx;
@@ -2512,7 +2553,7 @@ var AvailabilityService = class {
    * Single product. Resolves the availability record, or — when
    * `opts.defaultAvailableOnNotFound` is set — a default available record on 404.
    */
-  async get(productId, siteCode, auth2 = ANON6, opts = {}) {
+  async get(productId, siteCode, auth2 = ANON7, opts = {}) {
     try {
       return await this.ctx.http.request({
         method: "GET",
@@ -2535,7 +2576,7 @@ var AvailabilityService = class {
    * `opts.defaultAvailableOnNotFound` is set). The result preserves input order
    * and length. An empty `productIds` resolves to `[]` without a request.
    */
-  async getMany(productIds, siteCode, auth2 = ANON6, opts = {}) {
+  async getMany(productIds, siteCode, auth2 = ANON7, opts = {}) {
     if (productIds.length === 0) return [];
     const found = await this.ctx.http.request({
       method: "POST",
@@ -4946,13 +4987,14 @@ var VendorService = class {
       auth: auth2
     });
   }
-  /** Search vendors (`POST /vendors/search`). */
+  /** Search vendors (`POST /vendors/search`). A built filter in `q` is resolved to a string. */
   async searchVendors(query, auth2 = SERVICE24) {
+    const body = query.q !== void 0 ? { ...query, q: resolveQuery(query.q, { compoundLogicalQuery: false }) } : query;
     return this.ctx.http.request({
       method: "POST",
       path: `${this.base()}/vendors/search`,
       auth: auth2,
-      body: query
+      body
     });
   }
   /** Create a vendor. */
@@ -5136,9 +5178,10 @@ var CustomerAdminService = class {
       ...Object.keys(query).length ? { query } : {}
     });
   }
-  /** Search customers (`POST /customers/search`). */
+  /** Search customers (`POST /customers/search`). A built filter in `q` is resolved to a string. */
   async searchCustomers(query, auth2 = SERVICE26) {
-    return this.ctx.http.request({ method: "POST", path: `${this.base()}/search`, auth: auth2, body: query });
+    const body = query.q !== void 0 ? { ...query, q: resolveQuery(query.q, { compoundLogicalQuery: false }) } : query;
+    return this.ctx.http.request({ method: "POST", path: `${this.base()}/search`, auth: auth2, body });
   }
   /** Retrieve a customer profile by number. */
   async getCustomer(customerNumber, auth2 = SERVICE26) {
@@ -5540,6 +5583,7 @@ exports.errorFromResponse = errorFromResponse;
 exports.iterateAll = iterateAll;
 exports.productIdFromYrn = productIdFromYrn;
 exports.redact = redact;
+exports.resolveQuery = resolveQuery;
 exports.resolveToken = resolveToken;
 exports.validateConfig = validateConfig;
 //# sourceMappingURL=index.cjs.map