@viu/emporix-sdk 4.9.4 → 4.11.0

package/dist/index.cjs

@@ -114,6 +114,17 @@ function validateConfig(input) {
     throw new Error("credentials is required (provide at least one of backend/storefront/custom)");
   }
   warnOnMisplacedContext(input);
+  const proxy = input.proxy;
+  if (proxy) {
+    if (input.tokenProvider) {
+      throw new Error("proxy and tokenProvider are mutually exclusive: in proxy mode the SDK requests no tokens");
+    }
+    if (input.credentials.backend || input.credentials.custom) {
+      throw new Error(
+        "credentials.backend and credentials.custom cannot be used in proxy mode: the proxy attaches the token, and service credentials never belong in a browser"
+      );
+    }
+  }
   return {
     tenant: input.tenant,
     host: input.host ?? DEFAULT_HOST,
@@ -130,241 +141,15 @@ function validateConfig(input) {
     },
     logger: input.logger,
     fetch: input.fetch,
-    contentLanguage: input.contentLanguage
+    contentLanguage: input.contentLanguage,
+    proxy: proxy ? {
+      headers: proxy.headers ?? {},
+      credentials: proxy.credentials ?? "same-origin",
+      onUnauthorized: proxy.onUnauthorized
+    } : void 0
   };
 }
 
-// src/core/logger.ts
-var LEVEL = {
-  trace: 10,
-  debug: 20,
-  info: 30,
-  warn: 40,
-  error: 50,
-  silent: 60
-};
-function isValidLevel(v) {
-  return v !== void 0 && v in LEVEL;
-}
-function readEnv(name) {
-  try {
-    return typeof process !== "undefined" && process.env ? process.env[name] : void 0;
-  } catch {
-    return void 0;
-  }
-}
-var LevelResolver = class {
-  constructor(cfg, warn = () => {
-  }) {
-    this.warn = warn;
-    this.cfgLevel = cfg.level ?? "warn";
-    this.cfgServices = { ...cfg.services };
-  }
-  warn;
-  cfgLevel;
-  cfgServices;
-  forcedServices = {};
-  forcedGlobal;
-  warned = false;
-  envFor(svc) {
-    const raw = readEnv(`EMPORIX_LOG_LEVEL_${svc.toUpperCase()}`);
-    if (raw === void 0) return void 0;
-    if (isValidLevel(raw)) return raw;
-    if (!this.warned) {
-      this.warned = true;
-      this.warn(`Invalid EMPORIX_LOG_LEVEL_${svc.toUpperCase()}="${raw}" ignored`);
-    }
-    return void 0;
-  }
-  envGlobal() {
-    const raw = readEnv("EMPORIX_LOG_LEVEL");
-    if (raw === void 0) return void 0;
-    if (isValidLevel(raw)) return raw;
-    if (!this.warned) {
-      this.warned = true;
-      this.warn(`Invalid EMPORIX_LOG_LEVEL="${raw}" ignored`);
-    }
-    return void 0;
-  }
-  /**
-   * Effective level for a service. Forced overrides (from `set(..., force)`)
-   * take precedence over env vars; otherwise env > programmatic config.
-   */
-  get(svc) {
-    return this.forcedServices[svc] ?? this.envFor(svc) ?? this.forcedGlobal ?? this.envGlobal() ?? this.cfgServices[svc] ?? this.cfgLevel ?? "warn";
-  }
-  /** Numeric effective level for a service. */
-  numericLevel(svc) {
-    return LEVEL[this.get(svc)];
-  }
-  /** True if `svc`'s effective level allows emitting at `at`. */
-  isAtLeast(svc, at) {
-    return this.numericLevel(svc) <= LEVEL[at];
-  }
-  /** Mutates programmatic level (global or one service). Env-set levels are sticky unless `force`. */
-  set(level, svc, force = false) {
-    if (svc) {
-      const envBound = readEnv(`EMPORIX_LOG_LEVEL_${svc.toUpperCase()}`) !== void 0;
-      if (envBound && !force) {
-        this.warn(`Level for "${svc}" is env-controlled; pass force to override`);
-        return;
-      }
-      if (force) this.forcedServices[svc] = level;
-      else this.cfgServices[svc] = level;
-    } else {
-      const envBound = readEnv("EMPORIX_LOG_LEVEL") !== void 0;
-      if (envBound && !force) {
-        this.warn("Global level is env-controlled; pass force to override");
-        return;
-      }
-      if (force) this.forcedGlobal = level;
-      else this.cfgLevel = level;
-    }
-  }
-};
-var DEFAULT_REDACT = /* @__PURE__ */ new Set([
-  "authorization",
-  "password",
-  "oldpassword",
-  "newpassword",
-  "clientsecret",
-  "secret",
-  "access_token",
-  "refresh_token",
-  "customertoken",
-  "saastoken",
-  "saas-token",
-  "bearertoken",
-  "apikey",
-  "token"
-]);
-function redact(value, extra = []) {
-  const keys = new Set(DEFAULT_REDACT);
-  for (const k of extra) keys.add(k.toLowerCase());
-  const walk = (v) => {
-    if (Array.isArray(v)) return v.map(walk);
-    if (v && typeof v === "object") {
-      const src = v;
-      if (typeof src.kind === "string" && "token" in src) return { kind: src.kind };
-      const out = {};
-      for (const [k, val] of Object.entries(src)) {
-        if (keys.has(k.toLowerCase())) {
-          out[k] = k.toLowerCase() === "authorization" && typeof val === "string" ? "Bearer ***redacted***" : "***redacted***";
-        } else {
-          out[k] = walk(val);
-        }
-      }
-      return out;
-    }
-    return v;
-  };
-  return walk(value);
-}
-var EMIT = {
-  trace: LEVEL.trace,
-  debug: LEVEL.debug,
-  info: LEVEL.info,
-  warn: LEVEL.warn,
-  error: LEVEL.error
-};
-var BaseLogger = class {
-  constructor(resolver, bindings, extraRedact) {
-    this.resolver = resolver;
-    this.bindings = bindings;
-    this.extraRedact = extraRedact;
-  }
-  resolver;
-  bindings;
-  extraRedact;
-  svc() {
-    return this.bindings.service ?? "http";
-  }
-  get level() {
-    return this.resolver.get(this.svc());
-  }
-  isLevelEnabled(level) {
-    return this.resolver.isAtLeast(this.svc(), level);
-  }
-  at(level, msg, fields) {
-    if (this.resolver.numericLevel(this.svc()) > EMIT[level]) return;
-    const merged = { ...this.bindings, ...fields ?? {} };
-    this.emit(level, msg, redact(merged, this.extraRedact));
-  }
-  trace(m, f) {
-    this.at("trace", m, f);
-  }
-  debug(m, f) {
-    this.at("debug", m, f);
-  }
-  info(m, f) {
-    this.at("info", m, f);
-  }
-  warn(m, f) {
-    this.at("warn", m, f);
-  }
-  error(m, f) {
-    this.at("error", m, f);
-  }
-};
-var ConsoleLogger = class _ConsoleLogger extends BaseLogger {
-  constructor(resolver, bindings, extra, sink, pretty) {
-    super(resolver, bindings, extra);
-    this.sink = sink;
-    this.pretty = pretty;
-  }
-  sink;
-  pretty;
-  emit(level, msg, fields) {
-    if (this.pretty) {
-      const fn = level === "error" ? this.sink.error : level === "warn" ? this.sink.warn : level === "info" ? this.sink.info : this.sink.log;
-      fn(`[${level}] ${msg}`, fields);
-    } else {
-      this.sink.log(JSON.stringify({ ts: (/* @__PURE__ */ new Date()).toISOString(), level, msg, ...fields }));
-    }
-  }
-  child(bindings) {
-    return new _ConsoleLogger(
-      this.resolver,
-      { ...this.bindings, ...bindings },
-      this.extraRedact,
-      this.sink,
-      this.pretty
-    );
-  }
-};
-var NoopLogger = class {
-  level = "silent";
-  isLevelEnabled() {
-    return false;
-  }
-  trace() {
-  }
-  debug() {
-  }
-  info() {
-  }
-  warn() {
-  }
-  error() {
-  }
-  child() {
-    return this;
-  }
-};
-function createConsoleLogger(resolver, bindings = {}, opts = {}) {
-  const pretty = opts.pretty ?? readEnv("NODE_ENV") !== "production";
-  const sink = opts.sink ?? {
-    log: console.log,
-    info: console.info,
-    warn: console.warn,
-    error: console.error
-  };
-  return new ConsoleLogger(resolver, bindings, opts.redact ?? [], sink, pretty);
-}
-function createNoopLogger() {
-  return new NoopLogger();
-}
-
 // src/core/auth.ts
 var auth = {
   /** Service/custom credential set (default `backend`). */
@@ -833,46 +618,343 @@ function createLocalStorage(opts = {}) {
     console.warn("[emporix] localStorage unavailable; falling back to in-memory storage");
     return createMemoryStorage();
   }
-  return fromWebStorage(store, opts);
-}
-var createLocalStorageStorage = createLocalStorage;
-function createSessionStorage(opts = {}) {
-  const store = browser.sessionStorage;
-  if (store === void 0) {
-    console.warn("[emporix] sessionStorage unavailable; falling back to in-memory storage");
-    return createMemoryStorage();
+  return fromWebStorage(store, opts);
+}
+var createLocalStorageStorage = createLocalStorage;
+function createSessionStorage(opts = {}) {
+  const store = browser.sessionStorage;
+  if (store === void 0) {
+    console.warn("[emporix] sessionStorage unavailable; falling back to in-memory storage");
+    return createMemoryStorage();
+  }
+  return fromWebStorage(store, opts);
+}
+function createCookieStorage(opts = {}) {
+  const sameSite = opts.sameSite ?? "lax";
+  const secure = opts.secure ?? browser.location?.protocol === "https:";
+  const doc = browser.document;
+  if (doc === void 0) {
+    console.warn("[emporix] document unavailable; cookie storage falling back to in-memory");
+    return createMemoryStorage();
+  }
+  const attrs = `path=/; SameSite=${sameSite}${secure ? "; Secure" : ""}`;
+  const all = createListenerSet();
+  const storage = createCookieBackedStorage(
+    {
+      get: (name) => {
+        for (const part of doc.cookie.split("; ")) {
+          const [k, ...v] = part.split("=");
+          if (k === name) return decodeURIComponent(v.join("=")) || null;
+        }
+        return null;
+      },
+      set: (name, value) => {
+        doc.cookie = value === null ? `${name}=; expires=Thu, 01 Jan 1970 00:00:00 GMT; ${attrs}` : `${name}=${encodeURIComponent(value)}; ${attrs}`;
+      }
+    },
+    {
+      ...opts.name !== void 0 ? { tokenName: opts.name } : {},
+      notify: (key) => all.notify(key)
+    }
+  );
+  return { ...storage, subscribeAll: (l) => all.add(l) };
+}
+
+// src/core/proxy.ts
+var PROXY_CUSTOMER_TOKEN = "emporix-proxy-session";
+function createProxyModeTokenProvider() {
+  const refuse = () => {
+    throw new EmporixAuthError(
+      "The client runs in proxy mode: the proxy attaches the token, so the SDK requests none"
+    );
+  };
+  return {
+    getToken: async () => refuse(),
+    getAnonymousToken: async () => refuse(),
+    refreshAnonymous: async () => refuse(),
+    setAnonymousContext: () => {
+    }
+  };
+}
+var TOKEN_KEYS = /* @__PURE__ */ new Set([
+  "customerToken",
+  "anonymousSession",
+  "refreshToken",
+  "saasToken"
+]);
+function createProxySessionStorage(base, authenticated) {
+  let current = authenticated;
+  const tokenListeners = createListenerSet();
+  const keyListeners = createListenerSet();
+  const token = () => current ? PROXY_CUSTOMER_TOKEN : null;
+  const drop = () => {
+  };
+  return {
+    getCustomerToken: token,
+    setCustomerToken: drop,
+    subscribe: (listener) => tokenListeners.add(listener),
+    getCartId: () => base.getCartId(),
+    setCartId: (id) => base.setCartId(id),
+    getAnonymousSession: () => null,
+    setAnonymousSession: drop,
+    getSiteCode: () => base.getSiteCode(),
+    setSiteCode: (code) => base.setSiteCode(code),
+    getLanguage: () => base.getLanguage(),
+    setLanguage: (language) => base.setLanguage(language),
+    getActiveLegalEntityId: () => base.getActiveLegalEntityId(),
+    setActiveLegalEntityId: (id) => base.setActiveLegalEntityId(id),
+    getRefreshToken: () => null,
+    setRefreshToken: drop,
+    getSaasToken: () => null,
+    setSaasToken: drop,
+    subscribeAll(listener) {
+      const own = keyListeners.add(listener);
+      const passed = base.subscribeAll?.((key) => {
+        if (!TOKEN_KEYS.has(key)) listener(key);
+      });
+      return () => {
+        own();
+        passed?.();
+      };
+    },
+    setProxyAuthenticated(next) {
+      if (next === current) return;
+      current = next;
+      tokenListeners.notify(token());
+      keyListeners.notify("customerToken");
+    }
+  };
+}
+
+// src/core/logger.ts
+var LEVEL = {
+  trace: 10,
+  debug: 20,
+  info: 30,
+  warn: 40,
+  error: 50,
+  silent: 60
+};
+function isValidLevel(v) {
+  return v !== void 0 && v in LEVEL;
+}
+function readEnv(name) {
+  try {
+    return typeof process !== "undefined" && process.env ? process.env[name] : void 0;
+  } catch {
+    return void 0;
+  }
+}
+var LevelResolver = class {
+  constructor(cfg, warn = () => {
+  }) {
+    this.warn = warn;
+    this.cfgLevel = cfg.level ?? "warn";
+    this.cfgServices = { ...cfg.services };
+  }
+  warn;
+  cfgLevel;
+  cfgServices;
+  forcedServices = {};
+  forcedGlobal;
+  warned = false;
+  envFor(svc) {
+    const raw = readEnv(`EMPORIX_LOG_LEVEL_${svc.toUpperCase()}`);
+    if (raw === void 0) return void 0;
+    if (isValidLevel(raw)) return raw;
+    if (!this.warned) {
+      this.warned = true;
+      this.warn(`Invalid EMPORIX_LOG_LEVEL_${svc.toUpperCase()}="${raw}" ignored`);
+    }
+    return void 0;
+  }
+  envGlobal() {
+    const raw = readEnv("EMPORIX_LOG_LEVEL");
+    if (raw === void 0) return void 0;
+    if (isValidLevel(raw)) return raw;
+    if (!this.warned) {
+      this.warned = true;
+      this.warn(`Invalid EMPORIX_LOG_LEVEL="${raw}" ignored`);
+    }
+    return void 0;
+  }
+  /**
+   * Effective level for a service. Forced overrides (from `set(..., force)`)
+   * take precedence over env vars; otherwise env > programmatic config.
+   */
+  get(svc) {
+    return this.forcedServices[svc] ?? this.envFor(svc) ?? this.forcedGlobal ?? this.envGlobal() ?? this.cfgServices[svc] ?? this.cfgLevel ?? "warn";
+  }
+  /** Numeric effective level for a service. */
+  numericLevel(svc) {
+    return LEVEL[this.get(svc)];
   }
-  return fromWebStorage(store, opts);
-}
-function createCookieStorage(opts = {}) {
-  const sameSite = opts.sameSite ?? "lax";
-  const secure = opts.secure ?? browser.location?.protocol === "https:";
-  const doc = browser.document;
-  if (doc === void 0) {
-    console.warn("[emporix] document unavailable; cookie storage falling back to in-memory");
-    return createMemoryStorage();
+  /** True if `svc`'s effective level allows emitting at `at`. */
+  isAtLeast(svc, at) {
+    return this.numericLevel(svc) <= LEVEL[at];
   }
-  const attrs = `path=/; SameSite=${sameSite}${secure ? "; Secure" : ""}`;
-  const all = createListenerSet();
-  const storage = createCookieBackedStorage(
-    {
-      get: (name) => {
-        for (const part of doc.cookie.split("; ")) {
-          const [k, ...v] = part.split("=");
-          if (k === name) return decodeURIComponent(v.join("=")) || null;
+  /** Mutates programmatic level (global or one service). Env-set levels are sticky unless `force`. */
+  set(level, svc, force = false) {
+    if (svc) {
+      const envBound = readEnv(`EMPORIX_LOG_LEVEL_${svc.toUpperCase()}`) !== void 0;
+      if (envBound && !force) {
+        this.warn(`Level for "${svc}" is env-controlled; pass force to override`);
+        return;
+      }
+      if (force) this.forcedServices[svc] = level;
+      else this.cfgServices[svc] = level;
+    } else {
+      const envBound = readEnv("EMPORIX_LOG_LEVEL") !== void 0;
+      if (envBound && !force) {
+        this.warn("Global level is env-controlled; pass force to override");
+        return;
+      }
+      if (force) this.forcedGlobal = level;
+      else this.cfgLevel = level;
+    }
+  }
+};
+var DEFAULT_REDACT = /* @__PURE__ */ new Set([
+  "authorization",
+  "password",
+  "oldpassword",
+  "newpassword",
+  "clientsecret",
+  "secret",
+  "access_token",
+  "refresh_token",
+  "customertoken",
+  "saastoken",
+  "saas-token",
+  "bearertoken",
+  "apikey",
+  "token"
+]);
+function redact(value, extra = []) {
+  const keys = new Set(DEFAULT_REDACT);
+  for (const k of extra) keys.add(k.toLowerCase());
+  const walk = (v) => {
+    if (Array.isArray(v)) return v.map(walk);
+    if (v && typeof v === "object") {
+      const src = v;
+      if (typeof src.kind === "string" && "token" in src) return { kind: src.kind };
+      const out = {};
+      for (const [k, val] of Object.entries(src)) {
+        if (keys.has(k.toLowerCase())) {
+          out[k] = k.toLowerCase() === "authorization" && typeof val === "string" ? "Bearer ***redacted***" : "***redacted***";
+        } else {
+          out[k] = walk(val);
         }
-        return null;
-      },
-      set: (name, value) => {
-        doc.cookie = value === null ? `${name}=; expires=Thu, 01 Jan 1970 00:00:00 GMT; ${attrs}` : `${name}=${encodeURIComponent(value)}; ${attrs}`;
       }
-    },
-    {
-      ...opts.name !== void 0 ? { tokenName: opts.name } : {},
-      notify: (key) => all.notify(key)
+      return out;
     }
-  );
-  return { ...storage, subscribeAll: (l) => all.add(l) };
+    return v;
+  };
+  return walk(value);
+}
+var EMIT = {
+  trace: LEVEL.trace,
+  debug: LEVEL.debug,
+  info: LEVEL.info,
+  warn: LEVEL.warn,
+  error: LEVEL.error
+};
+var BaseLogger = class {
+  constructor(resolver, bindings, extraRedact) {
+    this.resolver = resolver;
+    this.bindings = bindings;
+    this.extraRedact = extraRedact;
+  }
+  resolver;
+  bindings;
+  extraRedact;
+  svc() {
+    return this.bindings.service ?? "http";
+  }
+  get level() {
+    return this.resolver.get(this.svc());
+  }
+  isLevelEnabled(level) {
+    return this.resolver.isAtLeast(this.svc(), level);
+  }
+  at(level, msg, fields) {
+    if (this.resolver.numericLevel(this.svc()) > EMIT[level]) return;
+    const merged = { ...this.bindings, ...fields ?? {} };
+    this.emit(level, msg, redact(merged, this.extraRedact));
+  }
+  trace(m, f) {
+    this.at("trace", m, f);
+  }
+  debug(m, f) {
+    this.at("debug", m, f);
+  }
+  info(m, f) {
+    this.at("info", m, f);
+  }
+  warn(m, f) {
+    this.at("warn", m, f);
+  }
+  error(m, f) {
+    this.at("error", m, f);
+  }
+};
+var ConsoleLogger = class _ConsoleLogger extends BaseLogger {
+  constructor(resolver, bindings, extra, sink, pretty) {
+    super(resolver, bindings, extra);
+    this.sink = sink;
+    this.pretty = pretty;
+  }
+  sink;
+  pretty;
+  emit(level, msg, fields) {
+    if (this.pretty) {
+      const fn = level === "error" ? this.sink.error : level === "warn" ? this.sink.warn : level === "info" ? this.sink.info : this.sink.log;
+      fn(`[${level}] ${msg}`, fields);
+    } else {
+      this.sink.log(JSON.stringify({ ts: (/* @__PURE__ */ new Date()).toISOString(), level, msg, ...fields }));
+    }
+  }
+  child(bindings) {
+    return new _ConsoleLogger(
+      this.resolver,
+      { ...this.bindings, ...bindings },
+      this.extraRedact,
+      this.sink,
+      this.pretty
+    );
+  }
+};
+var NoopLogger = class {
+  level = "silent";
+  isLevelEnabled() {
+    return false;
+  }
+  trace() {
+  }
+  debug() {
+  }
+  info() {
+  }
+  warn() {
+  }
+  error() {
+  }
+  child() {
+    return this;
+  }
+};
+function createConsoleLogger(resolver, bindings = {}, opts = {}) {
+  const pretty = opts.pretty ?? readEnv("NODE_ENV") !== "production";
+  const sink = opts.sink ?? {
+    log: console.log,
+    info: console.info,
+    warn: console.warn,
+    error: console.error
+  };
+  return new ConsoleLogger(resolver, bindings, opts.redact ?? [], sink, pretty);
+}
+function createNoopLogger() {
+  return new NoopLogger();
 }
 
 // src/core/query-keys.ts
@@ -986,20 +1068,72 @@ var HttpClient = class {
   sleep;
   /** Resolved request fetch. The arrow keeps `globalThis.fetch` correctly bound. */
   doFetch;
+  /**
+   * `null` in proxy mode, where no token is resolved at all — the provider is
+   * never asked, so no token request can happen. A service context is refused
+   * there rather than sent anonymously through the proxy.
+   */
+  async tokenFor(o) {
+    if (!this.opts.proxy) return resolveToken(o.auth, this.opts.provider);
+    if (o.auth.kind === "service") {
+      throw new EmporixAuthError(
+        `${o.method} ${o.path}: auth.service() is not available in proxy mode \u2014 service tokens never belong in a browser. Make this call from your server.`
+      );
+    }
+    return null;
+  }
+  /** `host + path` plus query. A relative host (`/emporix`) resolves against the page origin. */
+  urlFor(o) {
+    const host = this.opts.host;
+    let url;
+    if (host.startsWith("/")) {
+      const origin = globalThis.location?.origin;
+      if (!origin) {
+        throw new EmporixError(
+          `host "${host}" is a path, which needs a page origin to resolve against, and globalThis.location is not available here. Use an absolute host on a server.`
+        );
+      }
+      url = new URL(host + o.path, origin);
+    } else {
+      url = new URL(host + o.path);
+    }
+    for (const [k, v] of Object.entries(o.query ?? {})) {
+      if (v !== void 0) url.searchParams.set(k, String(v));
+    }
+    return url;
+  }
+  /** Proxy mode: report the 401 before it is thrown. A throwing callback must not mask it. */
+  reportUnauthorized(o) {
+    try {
+      this.opts.proxy?.onUnauthorized?.({ method: o.method, path: o.path });
+    } catch {
+    }
+  }
   buildHeaders(o, token, isFormData) {
-    return {
+    const headers = {
       // Before `o.headers` on purpose: a caller may override the tenant for a
       // single request, the way `Accept-Language` and `Content-Language` can be
       // overridden. Only `Authorization` is non-negotiable.
       ...this.opts.tenant !== void 0 ? { "Emporix-Tenant": this.opts.tenant } : {},
       ...this.opts.requestContext?.language ? { "Accept-Language": this.opts.requestContext.language } : {},
       ...this.opts.contentLanguage && o.body !== void 0 ? { "Content-Language": this.opts.contentLanguage } : {},
+      ...this.opts.proxy?.headers ?? {},
       ...o.headers ?? {},
-      Authorization: `Bearer ${token}`,
+      ...token !== null ? { 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" } : {}
     };
+    if (token === null) {
+      for (const k of Object.keys(headers)) {
+        if (k.toLowerCase() === "authorization") delete headers[k];
+      }
+    }
+    return headers;
+  }
+  /** `fetch`'s `credentials` — set only in proxy mode, where the session cookie must go along. */
+  credentialsInit() {
+    return this.opts.proxy ? { credentials: this.opts.proxy.credentials } : {};
   }
   /**
    * Issues a request and returns the parsed body. Retries 5xx/429 on idempotent
@@ -1022,17 +1156,14 @@ var HttpClient = class {
   async send(o) {
     const requestId = `req-${++requestSeq}`;
     const log = this.opts.logger.child({ requestId });
-    const url = new URL(this.opts.host + o.path);
-    for (const [k, v] of Object.entries(o.query ?? {})) {
-      if (v !== void 0) url.searchParams.set(k, String(v));
-    }
+    const url = this.urlFor(o);
     const sdkManaged = o.auth.kind === "service" || o.auth.kind === "anonymous";
     const maxAttempts = this.opts.retry.maxAttempts;
     let reauthed = false;
     let customerToken = o.auth.kind === "customer" ? o.auth.token : void 0;
     let customerReauthed = false;
     for (let attempt = 1; ; attempt++) {
-      const token = customerToken ?? await resolveToken(o.auth, this.opts.provider);
+      const token = !this.opts.proxy && customerToken !== void 0 ? customerToken : await this.tokenFor(o);
       log.debug("http request", {
         authKind: o.auth.kind,
         method: o.method,
@@ -1056,7 +1187,8 @@ var HttpClient = class {
       const init = {
         method: o.method,
         headers: this.buildHeaders(o, token, isFormData),
-        signal: controller.signal
+        signal: controller.signal,
+        ...this.credentialsInit()
       };
       if (o.body !== void 0) {
         init.body = isFormData ? o.body : JSON.stringify(o.body);
@@ -1089,6 +1221,10 @@ var HttpClient = class {
         return { data: parsed, headers: res.headers };
       }
       if (res.status === 401) {
+        if (this.opts.proxy) {
+          this.reportUnauthorized(o);
+          throw errorFromResponse(res.status, `${o.method} ${o.path} \u2192 401`, parsed);
+        }
         if (sdkManaged && !reauthed) {
           reauthed = true;
           if (o.auth.kind === "service") {
@@ -1141,11 +1277,8 @@ var HttpClient = class {
   async requestRaw(o, extra) {
     const requestId = `req-${++requestSeq}`;
     const log = this.opts.logger.child({ requestId });
-    const url = new URL(this.opts.host + o.path);
-    for (const [k, v] of Object.entries(o.query ?? {})) {
-      if (v !== void 0) url.searchParams.set(k, String(v));
-    }
-    const token = await resolveToken(o.auth, this.opts.provider);
+    const url = this.urlFor(o);
+    const token = await this.tokenFor(o);
     log.debug("http requestRaw", {
       authKind: o.auth.kind,
       method: o.method,
@@ -1162,13 +1295,15 @@ var HttpClient = class {
       method: o.method,
       headers: this.buildHeaders(o, token, isFormData),
       signal: controller.signal,
-      ...extra?.redirect ? { redirect: extra.redirect } : {}
+      ...extra?.redirect ? { redirect: extra.redirect } : {},
+      ...this.credentialsInit()
     };
     if (o.body !== void 0) {
       init.body = isFormData ? o.body : JSON.stringify(o.body);
     }
+    let res;
     try {
-      return await this.doFetch(url, init);
+      res = await this.doFetch(url, init);
     } catch (err) {
       if (err.name === "AbortError") {
         throw new EmporixTimeoutError(
@@ -1181,6 +1316,12 @@ var HttpClient = class {
     } finally {
       clearTimeout(timer);
     }
+    if (this.opts.proxy && res.status === 401) {
+      this.reportUnauthorized(o);
+      const text = await res.text().catch(() => "");
+      throw errorFromResponse(401, `${o.method} ${o.path} \u2192 401`, text ? safeJson(text) : void 0);
+    }
+    return res;
   }
   /**
    * Open a Server-Sent Events stream (`text/event-stream`) and yield parsed
@@ -1192,11 +1333,8 @@ var HttpClient = class {
    */
   async *requestStream(o) {
     const log = this.opts.logger.child({ requestId: `req-${++requestSeq}` });
-    const url = new URL(this.opts.host + o.path);
-    for (const [k, v] of Object.entries(o.query ?? {})) {
-      if (v !== void 0) url.searchParams.set(k, String(v));
-    }
-    const token = await resolveToken(o.auth, this.opts.provider);
+    const url = this.urlFor(o);
+    const token = await this.tokenFor(o);
     const controller = new AbortController();
     const connectTimer = setTimeout(() => controller.abort(), this.opts.timeouts.connectMs);
     const headers = this.buildHeaders(o, token, false);
@@ -1207,7 +1345,8 @@ var HttpClient = class {
         method: o.method,
         headers,
         signal: controller.signal,
-        ...o.body !== void 0 ? { body: JSON.stringify(o.body) } : {}
+        ...o.body !== void 0 ? { body: JSON.stringify(o.body) } : {},
+        ...this.credentialsInit()
       });
     } catch (err) {
       clearTimeout(connectTimer);
@@ -1220,6 +1359,7 @@ var HttpClient = class {
     }
     clearTimeout(connectTimer);
     if (!res.ok) {
+      if (this.opts.proxy && res.status === 401) this.reportUnauthorized(o);
       const text = await res.text().catch(() => "");
       throw errorFromResponse(
         res.status,
@@ -1247,7 +1387,7 @@ var HttpClient = class {
 };
 
 // package.json
-var version = "4.9.4";
+var version = "4.11.0";
 
 // src/version.ts
 var SDK_VERSION = version;
@@ -1270,8 +1410,19 @@ function createCore(config) {
     sdkVersion: SDK_VERSION,
     tenant: cfg.tenant
   });
-  const tokenProvider = cfg.tokenProvider ?? new DefaultTokenProvider(cfg);
+  const tokenProvider = cfg.proxy ? createProxyModeTokenProvider() : cfg.tokenProvider ?? new DefaultTokenProvider(cfg);
   const customerRefresh = new CustomerRefreshRegistry();
+  const unauthorized = createListenerSet();
+  const proxy = cfg.proxy && {
+    ...cfg.proxy,
+    onUnauthorized: (info) => {
+      try {
+        cfg.proxy?.onUnauthorized?.(info);
+      } finally {
+        unauthorized.notify(info);
+      }
+    }
+  };
   const requestContext = {
     language: cfg.credentials.storefront?.context?.language
   };
@@ -1291,7 +1442,8 @@ function createCore(config) {
       // exactOptionalPropertyTypes: `{ fetch: undefined }` is a type error
       // against `fetch?: typeof globalThis.fetch`, so spread conditionally.
       ...cfg.fetch !== void 0 ? { fetch: cfg.fetch } : {},
-      ...cfg.contentLanguage !== void 0 ? { contentLanguage: cfg.contentLanguage } : {}
+      ...cfg.contentLanguage !== void 0 ? { contentLanguage: cfg.contentLanguage } : {},
+      ...proxy ? { proxy } : {}
     })
   });
   return {
@@ -1316,6 +1468,9 @@ function createCore(config) {
     },
     setCustomerTokenRefresher(refresher) {
       customerRefresh.set(refresher);
+    },
+    onUnauthorized(listener) {
+      return unauthorized.add(listener);
     }
   };
 }
@@ -8523,13 +8678,18 @@ var SearchService = class {
     return `/search/${this.ctx.tenant}`;
   }
   /**
-   * Search the documents of one custom schema type. Paging, `sort` and
-   * `fields` travel as query parameters, not in the body.
+   * Search the documents of one type — a custom schema type, `customer` or
+   * `legal-entity`. Paging, `sort` and `fields` travel as query parameters, not
+   * in the body.
    *
    * Filter and sort fields must be indexed on the index the search uses —
-   * `exact`, or `text: true` for a `CONTAINS` filter — or the call answers `400`. A saved-search call (`{ searchQueryId, query }`) answers
-   * `404` when no saved search has that id for `type`, and `502` means the
-   * Schema Service could not confirm that `type` is a custom entity.
+   * `exact`, or `text: true` for a `CONTAINS` filter — or the call answers
+   * `400`. A `TEXT` or `PHRASE` query may pick the field's `analyzer` or one of
+   * its `additionalAnalyzers`. Conditions joined by `and` on fields of one
+   * `itemFields` list must match the same list item. A saved-search call
+   * (`{ searchQueryId, query }`) answers `404` when no saved search has that id
+   * for `type`, and `502` means the Schema Service could not confirm that a
+   * custom `type` is a custom entity.
    *
    * @example
    * const hits = await client.search.search("VEHICLE", {
@@ -8554,7 +8714,7 @@ var SearchService = class {
       page
     );
   }
-  /** List saved searches of one custom schema type (`opts.type`), or of every type. */
+  /** List saved searches of one type (`opts.type`), or of every type. */
   async listSavedSearches(opts = {}, auth2 = SERVICE29) {
     const { query, page } = pageQuery(opts);
     const t = opts.type;
@@ -8602,7 +8762,7 @@ var SearchService = class {
       auth: auth2
     });
   }
-  /** List search indexes of one custom schema type (`opts.type`), or of every type. */
+  /** List search indexes of one type (`opts.type`), or of every type. */
   async listIndexes(opts = {}, auth2 = SERVICE29) {
     const { query, page } = pageQuery(opts);
     const t = opts.type;
@@ -8896,6 +9056,11 @@ var ImportService = class {
    * streams. Read it back with {@link getRun}, or follow it with
    * {@link streamRun}, before treating a resolved call as a started import.
    *
+   * A configuration that does not exist answers `404` (since 2026-11-06; it used
+   * to be a `500`). A real run with nothing to import answers `400`: every stream
+   * it starts from reads uploaded files, and none has ever had one. Upload a file
+   * with {@link uploadStreamFile} first. A dry run is not refused for this.
+   *
    * Not retried on a 5xx: a POST that timed out may already have queued a run.
    *
    * @example
@@ -9146,7 +9311,7 @@ var ImportService = class {
    * {@link streamRun} exactly as you would a triggered run. Like one, it comes
    * back `QUEUED`, answers `409` while the configuration has a run `QUEUED`,
    * `RUNNING` or `RESUMABLE`, runs the published mappings and can finish
-   * `ABORTED`.
+   * `ABORTED`. A run that does not exist answers `404`.
    *
    * Not retried on a 5xx, for the same reason {@link triggerRun} is not: a POST
    * that timed out may already have queued the retry.
@@ -9257,6 +9422,29 @@ var ImportService = class {
       auth: auth2
     });
   }
+  /**
+   * Put a `FAILED` file back at the end of the stream's queue, so the next run
+   * reads the content the service already holds — no new upload. Use it after
+   * fixing the cause of the failure, a mapping say. Resolves to the file,
+   * `PENDING` again.
+   *
+   * Only a failed file can be queued again; `409` otherwise. A file imported with
+   * some records failing is `PROCESSED`: retry those records with
+   * {@link retryRun} instead. On a `SNAPSHOT` stream a failed file cannot be
+   * queued again once a newer file arrived, since the older snapshot would be
+   * imported over newer data — upload a corrected current file instead. `409`
+   * also when the stored content is gone, and while the job has a run in flight.
+   *
+   * Not retried on a 5xx: if the first attempt went through, the file is no
+   * longer `FAILED` and a repeat answers `409`.
+   */
+  async requeueStreamFile(streamId, fileId, auth2 = SERVICE30) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: `${this.base()}/streams/${encodeURIComponent(streamId)}/files/${encodeURIComponent(fileId)}/requeue`,
+      auth: auth2
+    });
+  }
 };
 
 // src/services/audit-log.ts
@@ -9989,6 +10177,15 @@ var EmporixClient = class {
   setCustomerTokenRefresher(refresher) {
     this.core.setCustomerTokenRefresher(refresher);
   }
+  /**
+   * Proxy mode (`config.proxy`): subscribes to the 401s the proxy answers, next
+   * to `proxy.onUnauthorized`. Returns the unsubscribe function. The React
+   * `EmporixProvider` uses it for `onCustomerSessionExpired`. Never fires outside
+   * proxy mode — there a 401 is answered by re-authenticating.
+   */
+  onUnauthorized(listener) {
+    return this.core.onUnauthorized(listener);
+  }
 };
 
 // src/create-emporix-client.ts
@@ -10070,6 +10267,7 @@ exports.LevelResolver = LevelResolver;
 exports.LocationsService = LocationsService;
 exports.MediaService = MediaService;
 exports.OrdersService = OrdersService;
+exports.PROXY_CUSTOMER_TOKEN = PROXY_CUSTOMER_TOKEN;
 exports.PaymentGatewayService = PaymentGatewayService;
 exports.PriceService = PriceService;
 exports.ProductService = ProductService;
@@ -10104,6 +10302,8 @@ exports.createLocalStorage = createLocalStorage;
 exports.createLocalStorageStorage = createLocalStorageStorage;
 exports.createMemoryStorage = createMemoryStorage;
 exports.createNoopLogger = createNoopLogger;
+exports.createProxyModeTokenProvider = createProxyModeTokenProvider;
+exports.createProxySessionStorage = createProxySessionStorage;
 exports.createServerStorage = createServerStorage;
 exports.createSessionStorage = createSessionStorage;
 exports.emporixKey = emporixKey;