@viu/emporix-sdk 2.13.1 → 2.15.0

package/dist/index.cjs

@@ -48,6 +48,10 @@ var EmporixValidationError = class extends EmporixError {
 };
 var EmporixServerError = class extends EmporixError {
 };
+var EmporixTimeoutError = class extends EmporixError {
+};
+var EmporixNetworkError = class extends EmporixError {
+};
 var EmporixInsufficientScopeError = class extends EmporixForbiddenError {
   requiredScope;
   constructor(message, status, body, requiredScope) {
@@ -457,6 +461,26 @@ var DefaultTokenProvider = class {
     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({
@@ -465,7 +489,7 @@ var DefaultTokenProvider = class {
       client_secret: c.secret
     });
     if (c.scope) body.set("scope", c.scope);
-    const res = await fetch(`${this.cfg.host}/oauth/token`, {
+    const res = await this.boundedFetch(`${this.cfg.host}/oauth/token`, {
       method: "POST",
       headers: { "Content-Type": "application/x-www-form-urlencoded" },
       body
@@ -538,7 +562,7 @@ var DefaultTokenProvider = class {
       url.searchParams.set("refresh_token", this.anon.refreshToken);
     }
     try {
-      const res = await fetch(url, { method: "GET" });
+      const res = await this.boundedFetch(url, { method: "GET" });
       const json = await res.json().catch(() => ({}));
       if (!res.ok) {
         this.notifyRefresh("anonymous", false);
@@ -614,10 +638,18 @@ var HttpClient = class {
         attempt
       });
       const controller = new AbortController();
-      const timer = setTimeout(
-        () => controller.abort(),
-        o.timeoutMs ?? this.opts.timeouts.readMs
-      );
+      const overallMs = o.timeoutMs ?? this.opts.timeouts.readMs;
+      const connectMs = Math.min(this.opts.timeouts.connectMs, overallMs);
+      const timeoutMsg = `${o.method} ${o.path} timed out after ${overallMs}ms (connect budget ${connectMs}ms)`;
+      let connectTimer;
+      let overallTimer;
+      const overallBudget = new Promise((_, reject) => {
+        overallTimer = setTimeout(() => {
+          controller.abort();
+          reject(new EmporixTimeoutError(timeoutMsg));
+        }, overallMs);
+      });
+      connectTimer = setTimeout(() => controller.abort(), connectMs);
       const isFormData = typeof FormData !== "undefined" && o.body instanceof FormData;
       const init = {
         method: o.method,
@@ -628,12 +660,27 @@ var HttpClient = class {
         init.body = isFormData ? o.body : JSON.stringify(o.body);
       }
       let res;
+      let text;
       try {
-        res = await fetch(url, init);
+        res = await Promise.race([fetch(url, init), overallBudget]);
+        clearTimeout(connectTimer);
+        connectTimer = void 0;
+        const body = res.text();
+        body.catch(() => {
+        });
+        text = await Promise.race([body, overallBudget]);
+      } catch (err) {
+        if (err instanceof EmporixTimeoutError) throw err;
+        if (err.name === "AbortError") {
+          throw new EmporixTimeoutError(timeoutMsg);
+        }
+        throw new EmporixNetworkError(
+          `${o.method} ${o.path} network failure: ${err.message}`
+        );
       } finally {
-        clearTimeout(timer);
+        if (connectTimer !== void 0) clearTimeout(connectTimer);
+        if (overallTimer !== void 0) clearTimeout(overallTimer);
       }
-      const text = await res.text();
       const parsed = text ? safeJson(text) : void 0;
       if (res.ok) {
         log.debug("http ok", { status: res.status });
@@ -663,10 +710,12 @@ var HttpClient = class {
         }
         throw errorFromResponse(res.status, `${o.method} ${o.path} \u2192 401`, parsed);
       }
-      const retryable = res.status >= 500 || res.status === 429;
+      const idempotent = o.method === "GET" || o.method === "PUT" || o.method === "DELETE" || o.idempotent === true;
+      const retryable = idempotent && (res.status >= 500 || res.status === 429);
       if (retryable && attempt < maxAttempts) {
-        const retryAfter = Number(res.headers.get("Retry-After"));
-        const backoff = Number.isFinite(retryAfter) && retryAfter >= 0 ? retryAfter * 1e3 : Math.min(1e3 * 2 ** (attempt - 1), 8e3) + Math.random() * 100;
+        const retryAfterHeader = res.headers.get("Retry-After");
+        const retryAfter = retryAfterHeader ? Number(retryAfterHeader) : Number.NaN;
+        const backoff = Number.isFinite(retryAfter) && retryAfter >= 0 ? Math.min(retryAfter * 1e3, 8e3) : Math.min(1e3 * 2 ** (attempt - 1), 8e3) + Math.random() * 100;
         log.warn("retryable failure", { status: res.status, attempt, backoffMs: backoff });
         await this.sleep(backoff);
         continue;
@@ -718,12 +767,90 @@ var HttpClient = class {
     }
     try {
       return await fetch(url, init);
+    } catch (err) {
+      if (err.name === "AbortError") {
+        throw new EmporixTimeoutError(
+          `${o.method} ${o.path} timed out after ${o.timeoutMs ?? this.opts.timeouts.readMs}ms`
+        );
+      }
+      throw new EmporixNetworkError(
+        `${o.method} ${o.path} network failure: ${err.message}`
+      );
     } finally {
       clearTimeout(timer);
     }
   }
 };
 
+// package.json
+var version = "2.15.0";
+
+// src/version.ts
+var SDK_VERSION = version;
+
+// src/core/create-core.ts
+function createCore(config) {
+  const cfg = validateConfig(config);
+  let loggerObj = {};
+  let baseLogger;
+  if (cfg.logger === false) {
+    baseLogger = createNoopLogger();
+  } else if (cfg.logger && typeof cfg.logger.child === "function") {
+    baseLogger = cfg.logger;
+  } else if (cfg.logger) {
+    loggerObj = cfg.logger;
+  }
+  const resolver = new LevelResolver(loggerObj);
+  const root = baseLogger ?? createConsoleLogger(resolver, {
+    sdk: "emporix",
+    sdkVersion: SDK_VERSION,
+    tenant: cfg.tenant
+  });
+  const tokenProvider = cfg.tokenProvider ?? new DefaultTokenProvider(cfg);
+  const customerRefresh = new CustomerRefreshRegistry();
+  const requestContext = {
+    language: cfg.credentials.storefront?.context?.language
+  };
+  const mk = (service) => ({
+    tenant: cfg.tenant,
+    tokenProvider,
+    logger: root.child({ service }),
+    http: new HttpClient({
+      host: cfg.host,
+      provider: tokenProvider,
+      logger: root.child({ service: "http" }),
+      retry: cfg.retry,
+      timeouts: cfg.timeouts,
+      customerRefresh,
+      requestContext
+    })
+  });
+  return {
+    tenant: cfg.tenant,
+    config: cfg,
+    tokenProvider,
+    mk,
+    setStorefrontContext(ctx) {
+      if (ctx.language !== void 0) {
+        requestContext.language = ctx.language || void 0;
+      }
+      const { language: _language, ...priceContext } = ctx;
+      if (Object.keys(priceContext).length > 0) {
+        tokenProvider.setAnonymousContext?.(priceContext);
+      }
+    },
+    setLogLevel(level, opts = {}) {
+      resolver.set(level, opts.service, opts.force ?? false);
+    },
+    getLogLevel(service) {
+      return resolver.get(service);
+    },
+    setCustomerTokenRefresher(refresher) {
+      customerRefresh.set(refresher);
+    }
+  };
+}
+
 // src/core/require-customer.ts
 function requireCustomer(auth2) {
   if (auth2 && (auth2.kind === "customer" || auth2.kind === "raw")) return auth2;
@@ -731,11 +858,27 @@ function requireCustomer(auth2) {
 }
 
 // src/services/customer.ts
+function toSession(endpoint, wire, opts = {}) {
+  const customerToken = wire.access_token ?? wire.accessToken;
+  if (!customerToken) {
+    throw new EmporixAuthError(`${endpoint}: response missing access_token`, void 0, wire);
+  }
+  return {
+    customerToken,
+    saasToken: wire.saas_token ?? wire.saasToken ?? opts.carrySaasToken ?? "",
+    refreshToken: wire.refresh_token ?? wire.refreshToken ?? "",
+    sessionId: wire.session_id,
+    expiresIn: wire.expires_in != null ? Number(wire.expires_in) : void 0,
+    ...wire.social_access_token ? { socialAccessToken: wire.social_access_token } : {},
+    ...wire.social_id_token ? { socialIdToken: wire.social_id_token } : {}
+  };
+}
 var CustomerService = class {
   constructor(ctx) {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "customer";
   /** Obtains an anonymous storefront session (accessToken + sessionId + refreshToken). */
   async anonymous() {
     return this.ctx.tokenProvider.getAnonymousToken();
@@ -762,13 +905,7 @@ var CustomerService = class {
       auth: effective,
       body: creds
     });
-    return {
-      customerToken: wire.access_token ?? wire.accessToken ?? "",
-      saasToken: wire.saas_token ?? wire.saasToken ?? "",
-      refreshToken: wire.refresh_token ?? wire.refreshToken ?? "",
-      sessionId: wire.session_id,
-      expiresIn: wire.expires_in
-    };
+    return toSession("login", wire);
   }
   /**
    * Refreshes an authenticated customer session via its refresh token,
@@ -788,14 +925,11 @@ var CustomerService = class {
       query,
       auth: auth2
     });
-    return {
-      customerToken: wire.access_token ?? wire.accessToken ?? "",
-      // Refresh does not return a saas_token — carry the original forward.
-      saasToken: input.saasToken ?? "",
-      refreshToken: wire.refresh_token ?? wire.refreshToken ?? "",
-      sessionId: wire.session_id,
-      expiresIn: wire.expires_in
-    };
+    return toSession(
+      "refresh",
+      wire,
+      input.saasToken !== void 0 ? { carrySaasToken: input.saasToken } : {}
+    );
   }
   /**
    * Logs the customer out server-side: `GET /customer/{tenant}/logout?
@@ -834,15 +968,7 @@ var CustomerService = class {
       auth: auth2,
       ...input.sessionId ? { headers: { "session-id": input.sessionId } } : {}
     });
-    return {
-      customerToken: wire.access_token ?? wire.accessToken ?? "",
-      saasToken: wire.saas_token ?? wire.saasToken ?? "",
-      refreshToken: wire.refresh_token ?? wire.refreshToken ?? "",
-      sessionId: wire.session_id,
-      expiresIn: wire.expires_in != null ? Number(wire.expires_in) : void 0,
-      ...wire.social_access_token ? { socialAccessToken: wire.social_access_token } : {},
-      ...wire.social_id_token ? { socialIdToken: wire.social_id_token } : {}
-    };
+    return toSession("socialLogin", wire);
   }
   /**
    * RFC 8693 token exchange: exchanges an external IdP JWT for an Emporix
@@ -861,13 +987,7 @@ var CustomerService = class {
       query,
       auth: auth2
     });
-    return {
-      customerToken: wire.access_token ?? wire.accessToken ?? "",
-      saasToken: wire.saas_token ?? wire.saasToken ?? "",
-      refreshToken: wire.refresh_token ?? wire.refreshToken ?? "",
-      sessionId: wire.session_id,
-      expiresIn: wire.expires_in != null ? Number(wire.expires_in) : void 0
-    };
+    return toSession("exchangeToken", wire);
   }
   /** Returns the authenticated customer. Requires customer/raw auth. */
   async me(auth2) {
@@ -958,6 +1078,7 @@ var ProductService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "product";
   /** Fetches one product by id. */
   async get(productId, _opts, auth2 = ANON) {
     return this.ctx.http.request({
@@ -1037,7 +1158,9 @@ var ProductService = class {
           path: `/product/${this.ctx.tenant}/products/search`,
           query: { pageSize: chunk.length },
           auth: auth2,
-          body: { q: `id:(${chunk.join(",")})` }
+          body: { q: `id:(${chunk.join(",")})` },
+          idempotent: true
+          // pure read over POST — safe to replay on 5xx/429
         })
       )
     );
@@ -1077,7 +1200,9 @@ var ProductService = class {
           path: `/product/${this.ctx.tenant}/products/search`,
           query: { pageSize: chunk.length },
           auth: auth2,
-          body: { q: `code:(${chunk.join(",")})` }
+          body: { q: `code:(${chunk.join(",")})` },
+          idempotent: true
+          // pure read over POST — safe to replay on 5xx/429
         })
       )
     );
@@ -1115,6 +1240,7 @@ var CategoryService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "category";
   /** Fetches one category by id. */
   async get(categoryId, auth2 = ANON2) {
     return this.ctx.http.request({
@@ -1198,7 +1324,9 @@ var CategoryService = class {
       path: `/product/${this.ctx.tenant}/products/search`,
       query: { pageSize: productIds.length },
       auth: auth2,
-      body: { q: `id:(${productIds.join(",")})` }
+      body: { q: `id:(${productIds.join(",")})` },
+      idempotent: true
+      // pure read over POST — safe to replay on 5xx/429
     });
     return { items, pageNumber, pageSize, hasNextPage };
   }
@@ -1246,6 +1374,7 @@ var CartService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "cart";
   base() {
     return `/cart/${this.ctx.tenant}/carts`;
   }
@@ -1418,6 +1547,7 @@ var CheckoutService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "checkout";
   headers(opts, guest) {
     if (guest || !opts.saasToken) return void 0;
     return { "saas-token": opts.saasToken };
@@ -1460,6 +1590,7 @@ var PaymentGatewayService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "payment";
   /** Lists configured frontend payment modes. */
   async listPaymentModes(auth2) {
     return this.ctx.http.request({
@@ -1504,6 +1635,7 @@ var PriceService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "price";
   /**
    * Resolves prices using the session context bound to the bearer token
    * (currency/site/country were set at anonymous-login time). Default auth:
@@ -1514,7 +1646,9 @@ var PriceService = class {
       method: "POST",
       path: `/price/${this.ctx.tenant}/match-prices-by-context`,
       auth: requireContextAuth(auth2),
-      body: input
+      body: input,
+      idempotent: true
+      // pure read over POST — safe to replay on 5xx/429
     });
     return rows.map(normalizeMatch);
   }
@@ -1527,7 +1661,9 @@ var PriceService = class {
       method: "POST",
       path: `/price/${this.ctx.tenant}/match-prices`,
       auth: auth2,
-      body: input
+      body: input,
+      idempotent: true
+      // pure read over POST — safe to replay on 5xx/429
     });
     return rows.map(normalizeMatch);
   }
@@ -1587,6 +1723,7 @@ var MediaService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "media";
   base() {
     return `/media/${this.ctx.tenant}/assets`;
   }
@@ -1832,6 +1969,8 @@ var SegmentService = class {
   }
   ctx;
   deps;
+  static channel = "segment";
+  static deps = ["products", "categories"];
   base() {
     return `/customer-segment/${this.ctx.tenant}/segments`;
   }
@@ -1963,6 +2102,7 @@ var SiteService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "site";
   /** Lists active sites. */
   async list(authCtx = ANON4) {
     return this.ctx.http.request({
@@ -2002,6 +2142,7 @@ var SessionContextService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "session-context";
   /**
    * Retrieves the current session context, or `null` when the server returns
    * 404 (no session exists yet — the session-context is created server-side
@@ -2064,6 +2205,7 @@ var CompaniesService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "customer-management";
   base() {
     return `/customer-management/${this.ctx.tenant}/legal-entities`;
   }
@@ -2120,6 +2262,7 @@ var ContactsService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "customer-management";
   base() {
     return `/customer-management/${this.ctx.tenant}/contact-assignments`;
   }
@@ -2169,6 +2312,7 @@ var LocationsService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "customer-management";
   base() {
     return `/customer-management/${this.ctx.tenant}/locations`;
   }
@@ -2226,6 +2370,7 @@ var CustomerGroupsService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "iam";
   base() {
     return `/iam/${this.ctx.tenant}/groups`;
   }
@@ -2268,6 +2413,7 @@ var OrdersService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "orders";
   base() {
     return `/order-v2/${this.ctx.tenant}/orders`;
   }
@@ -2328,6 +2474,7 @@ var SalesOrdersService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "sales-orders";
   base() {
     return `/order-v2/${this.ctx.tenant}/salesorders`;
   }
@@ -2360,6 +2507,7 @@ var AvailabilityService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "availability";
   /**
    * Single product. Resolves the availability record, or — when
    * `opts.defaultAvailableOnNotFound` is set — a default available record on 404.
@@ -2394,7 +2542,9 @@ var AvailabilityService = class {
       path: `/availability/${this.ctx.tenant}/availability/search`,
       auth: auth2,
       query: { site: siteCode, pageSize: productIds.length },
-      body: productIds
+      body: productIds,
+      idempotent: true
+      // pure read over POST — safe to replay on 5xx/429
     });
     const byId = /* @__PURE__ */ new Map();
     for (const a of found) if (a.productId) byId.set(a.productId, a);
@@ -2415,6 +2565,7 @@ var TenantConfigService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "configuration";
   base() {
     return `/configuration/${this.ctx.tenant}/configurations`;
   }
@@ -2471,6 +2622,7 @@ var ClientConfigService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "configuration";
   base(client) {
     return `/configuration/${this.ctx.tenant}/clients/${encodeURIComponent(client)}/configurations`;
   }
@@ -2528,6 +2680,7 @@ var ShoppingListService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "shopping-list";
   base() {
     return `/shoppinglist/${this.ctx.tenant}/shopping-lists`;
   }
@@ -2624,6 +2777,7 @@ var RagIndexerService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "ai-rag-indexer";
   base(type) {
     return `/ai-rag-indexer/${this.ctx.tenant}/${encodeURIComponent(type)}`;
   }
@@ -2664,6 +2818,7 @@ var SequentialIdService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "sequential-id";
   base() {
     return `/sequential-id/${this.ctx.tenant}/schemas`;
   }
@@ -2753,6 +2908,7 @@ var FeeService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "fee";
   feesBase() {
     return `/fee/${this.ctx.tenant}/fees`;
   }
@@ -2912,6 +3068,7 @@ var CloudFunctionsService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "cloud-functions";
   base() {
     return `/cloud-functions/${this.ctx.tenant}/functions`;
   }
@@ -2935,6 +3092,7 @@ var WebhookService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "webhook";
   base() {
     return `/webhook/${this.ctx.tenant}`;
   }
@@ -3047,6 +3205,7 @@ var SchemaService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "schema";
   schemasBase() {
     return `/schema/${this.ctx.tenant}/schemas`;
   }
@@ -3274,6 +3433,7 @@ var AiService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "ai";
   base() {
     return `/ai-service/${this.ctx.tenant}`;
   }
@@ -3387,6 +3547,7 @@ var TaxService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "tax";
   base() {
     return `/tax/${this.ctx.tenant}`;
   }
@@ -3456,6 +3617,7 @@ var CouponService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "coupon";
   base() {
     return `/coupon/${this.ctx.tenant}`;
   }
@@ -3582,6 +3744,7 @@ var RewardPointsService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "reward-points";
   /** Base without tenant (customer / public / batch endpoints). */
   base() {
     return `/reward-points`;
@@ -3736,6 +3899,7 @@ var BrandService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "brand";
   base() {
     return `/brand/brands`;
   }
@@ -3800,6 +3964,7 @@ var LabelService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "label";
   base() {
     return `/label/labels`;
   }
@@ -3864,6 +4029,7 @@ var CountryService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "country";
   base() {
     return `/country/${this.ctx.tenant}`;
   }
@@ -3919,6 +4085,7 @@ var CurrencyService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "currency";
   base() {
     return `/currency/${this.ctx.tenant}`;
   }
@@ -4019,6 +4186,7 @@ var ShippingService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "shipping";
   base() {
     return `/shipping/${this.ctx.tenant}`;
   }
@@ -4433,6 +4601,7 @@ var ReturnsService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "returns";
   base() {
     return `/return/${this.ctx.tenant}/returns`;
   }
@@ -4497,6 +4666,7 @@ var SepaExportService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "sepa-export";
   base() {
     return `/sepa-export/${this.ctx.tenant}`;
   }
@@ -4537,6 +4707,7 @@ var IndexingService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "indexing";
   base() {
     return `/indexing/${this.ctx.tenant}`;
   }
@@ -4603,6 +4774,7 @@ var UnitHandlingService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "unit-handling";
   base() {
     return `/unit-handling/${this.ctx.tenant}`;
   }
@@ -4684,6 +4856,7 @@ var CatalogService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "catalog";
   base() {
     return `/catalog/${this.ctx.tenant}/catalogs`;
   }
@@ -4751,6 +4924,7 @@ var VendorService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "vendor";
   base() {
     return `/vendor/${this.ctx.tenant}`;
   }
@@ -4850,6 +5024,7 @@ var PickPackService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "pick-pack";
   base() {
     return `/pick-pack/${this.ctx.tenant}`;
   }
@@ -4941,6 +5116,7 @@ var CustomerAdminService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "customer-admin";
   base() {
     return `/customer/${this.ctx.tenant}/customers`;
   }
@@ -5045,6 +5221,7 @@ var ApprovalService = class {
     this.ctx = ctx;
   }
   ctx;
+  static channel = "approval";
   base() {
     return `/approval/${this.ctx.tenant}`;
   }
@@ -5111,12 +5288,6 @@ var ApprovalService = class {
   }
 };
 
-// package.json
-var version = "2.13.1";
-
-// src/version.ts
-var SDK_VERSION = version;
-
 // src/client.ts
 var EmporixClient = class {
   customers;
@@ -5179,96 +5350,62 @@ var EmporixClient = class {
    * Provider tree. Treat as read-only.
    */
   config;
-  resolver;
-  customerRefresh;
-  requestContext;
+  core;
   constructor(config) {
-    const cfg = validateConfig(config);
-    this.tenant = cfg.tenant;
-    this.config = cfg;
-    let loggerObj = {};
-    let baseLogger;
-    if (cfg.logger === false) {
-      baseLogger = createNoopLogger();
-    } else if (cfg.logger && typeof cfg.logger.child === "function") {
-      baseLogger = cfg.logger;
-    } else if (cfg.logger) {
-      loggerObj = cfg.logger;
-    }
-    this.resolver = new LevelResolver(loggerObj);
-    const root = baseLogger ?? createConsoleLogger(this.resolver, {
-      sdk: "emporix",
-      sdkVersion: SDK_VERSION,
-      tenant: cfg.tenant
-    });
-    const tokenProvider = cfg.tokenProvider ?? new DefaultTokenProvider(cfg);
-    this.tokenProvider = tokenProvider;
-    const customerRefresh = new CustomerRefreshRegistry();
-    this.customerRefresh = customerRefresh;
-    this.requestContext = { language: cfg.credentials.storefront?.context?.language };
-    const requestContext = this.requestContext;
-    const mk = (service) => ({
-      tenant: cfg.tenant,
-      tokenProvider,
-      logger: root.child({ service }),
-      http: new HttpClient({
-        host: cfg.host,
-        provider: tokenProvider,
-        logger: root.child({ service: "http" }),
-        retry: cfg.retry,
-        timeouts: cfg.timeouts,
-        customerRefresh,
-        requestContext
-      })
-    });
-    this.customers = new CustomerService(mk("customer"));
-    this.products = new ProductService(mk("product"));
-    this.categories = new CategoryService(mk("category"));
-    this.carts = new CartService(mk("cart"));
-    this.checkout = new CheckoutService(mk("checkout"));
-    this.payments = new PaymentGatewayService(mk("payment"));
-    this.prices = new PriceService(mk("price"));
-    this.media = new MediaService(mk("media"));
-    this.segments = new SegmentService(mk("segment"), {
+    const core = createCore(config);
+    this.core = core;
+    this.tenant = core.tenant;
+    this.config = core.config;
+    this.tokenProvider = core.tokenProvider;
+    const mk = core.mk;
+    this.customers = new CustomerService(mk(CustomerService.channel));
+    this.products = new ProductService(mk(ProductService.channel));
+    this.categories = new CategoryService(mk(CategoryService.channel));
+    this.carts = new CartService(mk(CartService.channel));
+    this.checkout = new CheckoutService(mk(CheckoutService.channel));
+    this.payments = new PaymentGatewayService(mk(PaymentGatewayService.channel));
+    this.prices = new PriceService(mk(PriceService.channel));
+    this.media = new MediaService(mk(MediaService.channel));
+    this.segments = new SegmentService(mk(SegmentService.channel), {
       products: this.products,
       categories: this.categories
     });
-    this.sites = new SiteService(mk("site"));
-    this.sessionContext = new SessionContextService(mk("session-context"));
-    this.companies = new CompaniesService(mk("customer-management"));
-    this.contacts = new ContactsService(mk("customer-management"));
-    this.locations = new LocationsService(mk("customer-management"));
-    this.customerGroups = new CustomerGroupsService(mk("iam"));
-    this.orders = new OrdersService(mk("orders"));
-    this.salesOrders = new SalesOrdersService(mk("sales-orders"));
-    this.availability = new AvailabilityService(mk("availability"));
-    this.tenantConfig = new TenantConfigService(mk("configuration"));
-    this.clientConfig = new ClientConfigService(mk("configuration"));
-    this.shoppingLists = new ShoppingListService(mk("shopping-list"));
-    this.ragIndexer = new RagIndexerService(mk("ai-rag-indexer"));
-    this.sequentialIds = new SequentialIdService(mk("sequential-id"));
-    this.fees = new FeeService(mk("fee"));
-    this.cloudFunctions = new CloudFunctionsService(mk("cloud-functions"));
-    this.webhooks = new WebhookService(mk("webhook"));
-    this.schemas = new SchemaService(mk("schema"));
-    this.ai = new AiService(mk("ai"));
-    this.taxes = new TaxService(mk("tax"));
-    this.coupons = new CouponService(mk("coupon"));
-    this.rewardPoints = new RewardPointsService(mk("reward-points"));
-    this.brands = new BrandService(mk("brand"));
-    this.labels = new LabelService(mk("label"));
-    this.countries = new CountryService(mk("country"));
-    this.currencies = new CurrencyService(mk("currency"));
-    this.shipping = new ShippingService(mk("shipping"));
-    this.returns = new ReturnsService(mk("returns"));
-    this.sepaExport = new SepaExportService(mk("sepa-export"));
-    this.indexing = new IndexingService(mk("indexing"));
-    this.units = new UnitHandlingService(mk("unit-handling"));
-    this.catalogs = new CatalogService(mk("catalog"));
-    this.vendors = new VendorService(mk("vendor"));
-    this.pickPack = new PickPackService(mk("pick-pack"));
-    this.customerAdmin = new CustomerAdminService(mk("customer-admin"));
-    this.approvals = new ApprovalService(mk("approval"));
+    this.sites = new SiteService(mk(SiteService.channel));
+    this.sessionContext = new SessionContextService(mk(SessionContextService.channel));
+    this.companies = new CompaniesService(mk(CompaniesService.channel));
+    this.contacts = new ContactsService(mk(ContactsService.channel));
+    this.locations = new LocationsService(mk(LocationsService.channel));
+    this.customerGroups = new CustomerGroupsService(mk(CustomerGroupsService.channel));
+    this.orders = new OrdersService(mk(OrdersService.channel));
+    this.salesOrders = new SalesOrdersService(mk(SalesOrdersService.channel));
+    this.availability = new AvailabilityService(mk(AvailabilityService.channel));
+    this.tenantConfig = new TenantConfigService(mk(TenantConfigService.channel));
+    this.clientConfig = new ClientConfigService(mk(ClientConfigService.channel));
+    this.shoppingLists = new ShoppingListService(mk(ShoppingListService.channel));
+    this.ragIndexer = new RagIndexerService(mk(RagIndexerService.channel));
+    this.sequentialIds = new SequentialIdService(mk(SequentialIdService.channel));
+    this.fees = new FeeService(mk(FeeService.channel));
+    this.cloudFunctions = new CloudFunctionsService(mk(CloudFunctionsService.channel));
+    this.webhooks = new WebhookService(mk(WebhookService.channel));
+    this.schemas = new SchemaService(mk(SchemaService.channel));
+    this.ai = new AiService(mk(AiService.channel));
+    this.taxes = new TaxService(mk(TaxService.channel));
+    this.coupons = new CouponService(mk(CouponService.channel));
+    this.rewardPoints = new RewardPointsService(mk(RewardPointsService.channel));
+    this.brands = new BrandService(mk(BrandService.channel));
+    this.labels = new LabelService(mk(LabelService.channel));
+    this.countries = new CountryService(mk(CountryService.channel));
+    this.currencies = new CurrencyService(mk(CurrencyService.channel));
+    this.shipping = new ShippingService(mk(ShippingService.channel));
+    this.returns = new ReturnsService(mk(ReturnsService.channel));
+    this.sepaExport = new SepaExportService(mk(SepaExportService.channel));
+    this.indexing = new IndexingService(mk(IndexingService.channel));
+    this.units = new UnitHandlingService(mk(UnitHandlingService.channel));
+    this.catalogs = new CatalogService(mk(CatalogService.channel));
+    this.vendors = new VendorService(mk(VendorService.channel));
+    this.pickPack = new PickPackService(mk(PickPackService.channel));
+    this.customerAdmin = new CustomerAdminService(mk(CustomerAdminService.channel));
+    this.approvals = new ApprovalService(mk(ApprovalService.channel));
   }
   /**
    * Re-binds the storefront price context (currency / siteCode / targetLocation)
@@ -5281,21 +5418,15 @@ var EmporixClient = class {
    * read); a language-only change does NOT re-mint the token.
    */
   setStorefrontContext(ctx) {
-    if (ctx.language !== void 0) {
-      this.requestContext.language = ctx.language || void 0;
-    }
-    const { language: _language, ...priceContext } = ctx;
-    if (Object.keys(priceContext).length > 0) {
-      this.tokenProvider.setAnonymousContext?.(priceContext);
-    }
+    this.core.setStorefrontContext(ctx);
   }
   /** Sets the runtime log level globally or for one service. */
   setLogLevel(level, opts = {}) {
-    this.resolver.set(level, opts.service, opts.force ?? false);
+    this.core.setLogLevel(level, opts);
   }
   /** Returns the effective log level for a service. */
   getLogLevel(service) {
-    return this.resolver.get(service);
+    return this.core.getLogLevel(service);
   }
   /**
    * Registers (or clears with `null`) a customer-token refresher. When set, a
@@ -5304,10 +5435,34 @@ var EmporixClient = class {
    * automatically via `autoRefreshCustomerToken`.
    */
   setCustomerTokenRefresher(refresher) {
-    this.customerRefresh.set(refresher);
+    this.core.setCustomerTokenRefresher(refresher);
   }
 };
 
+// src/create-emporix-client.ts
+function createEmporixClient(config, services) {
+  const { mk, ...core } = createCore(config);
+  const built = {};
+  const entries = Object.entries(services);
+  for (const [key, Svc] of entries) {
+    if (!Svc.deps?.length) built[key] = new Svc(mk(Svc.channel));
+  }
+  for (const [key, Svc] of entries) {
+    if (!Svc.deps?.length) continue;
+    const deps = {};
+    for (const dep of Svc.deps) {
+      if (!(dep in built)) {
+        throw new EmporixError(
+          `createEmporixClient: "${key}" requires "${dep}" in the services map`
+        );
+      }
+      deps[dep] = built[dep];
+    }
+    built[key] = new Svc(mk(Svc.channel), deps);
+  }
+  return { ...core, ...built };
+}
+
 // src/core/yrn.ts
 function productIdFromYrn(yrn) {
   if (!yrn) return "";
@@ -5341,8 +5496,10 @@ exports.EmporixClient = EmporixClient;
 exports.EmporixError = EmporixError;
 exports.EmporixForbiddenError = EmporixForbiddenError;
 exports.EmporixInsufficientScopeError = EmporixInsufficientScopeError;
+exports.EmporixNetworkError = EmporixNetworkError;
 exports.EmporixNotFoundError = EmporixNotFoundError;
 exports.EmporixServerError = EmporixServerError;
+exports.EmporixTimeoutError = EmporixTimeoutError;
 exports.EmporixValidationError = EmporixValidationError;
 exports.FeeService = FeeService;
 exports.HttpClient = HttpClient;
@@ -5376,6 +5533,8 @@ exports.VendorService = VendorService;
 exports.WebhookService = WebhookService;
 exports.auth = auth;
 exports.createConsoleLogger = createConsoleLogger;
+exports.createCore = createCore;
+exports.createEmporixClient = createEmporixClient;
 exports.createNoopLogger = createNoopLogger;
 exports.errorFromResponse = errorFromResponse;
 exports.iterateAll = iterateAll;