@viu/emporix-sdk 1.0.0

package/dist/companies.cjs

@@ -0,0 +1,58 @@
+'use strict';
+
+// src/services/companies.ts
+var CompaniesService = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  ctx;
+  base() {
+    return `/customer-management/${this.ctx.tenant}/legal-entities`;
+  }
+  /** Lists the legal entities the calling customer is assigned to. */
+  async listMine(auth) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: this.base(),
+      auth
+    });
+  }
+  /** Fetches a single legal entity by id. */
+  async get(legalEntityId, auth) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/${legalEntityId}`,
+      auth
+    });
+  }
+  /** Creates a legal entity. Requires `customermanagement.legalentity_manage`. */
+  async create(input, auth) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: this.base(),
+      auth,
+      body: input
+    });
+  }
+  /** Patches a legal entity. */
+  async update(legalEntityId, patch, auth) {
+    return this.ctx.http.request({
+      method: "PATCH",
+      path: `${this.base()}/${legalEntityId}`,
+      auth,
+      body: patch
+    });
+  }
+  /** Deletes a legal entity (async cascade on the server). */
+  async delete(legalEntityId, auth) {
+    await this.ctx.http.request({
+      method: "DELETE",
+      path: `${this.base()}/${legalEntityId}`,
+      auth
+    });
+  }
+};
+
+exports.CompaniesService = CompaniesService;
+//# sourceMappingURL=companies.cjs.map
+//# sourceMappingURL=companies.cjs.map

package/dist/companies.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/services/companies.ts"],"names":[],"mappings":";;;AAgBO,IAAM,mBAAN,MAAuB;AAAA,EAC5B,YAA6B,GAAA,EAAoB;AAApB,IAAA,IAAA,CAAA,GAAA,GAAA,GAAA;AAAA,EAAqB;AAAA,EAArB,GAAA;AAAA,EAErB,IAAA,GAAe;AACrB,IAAA,OAAO,CAAA,qBAAA,EAAwB,IAAA,CAAK,GAAA,CAAI,MAAM,CAAA,eAAA,CAAA;AAAA,EAChD;AAAA;AAAA,EAGA,MAAM,SAAS,IAAA,EAA2C;AACxD,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,OAAA,CAAuB;AAAA,MAC1C,MAAA,EAAQ,KAAA;AAAA,MACR,IAAA,EAAM,KAAK,IAAA,EAAK;AAAA,MAChB;AAAA,KACD,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,GAAA,CAAI,aAAA,EAAuB,IAAA,EAAyC;AACxE,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,OAAA,CAAqB;AAAA,MACxC,MAAA,EAAQ,KAAA;AAAA,MACR,MAAM,CAAA,EAAG,IAAA,CAAK,IAAA,EAAM,IAAI,aAAa,CAAA,CAAA;AAAA,MACrC;AAAA,KACD,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,MAAA,CAAO,KAAA,EAA0B,IAAA,EAA4C;AACjF,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,OAAA,CAAwB;AAAA,MAC3C,MAAA,EAAQ,MAAA;AAAA,MACR,IAAA,EAAM,KAAK,IAAA,EAAK;AAAA,MAChB,IAAA;AAAA,MACA,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,MAAA,CACJ,aAAA,EACA,KAAA,EACA,IAAA,EACsB;AACtB,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,OAAA,CAAqB;AAAA,MACxC,MAAA,EAAQ,OAAA;AAAA,MACR,MAAM,CAAA,EAAG,IAAA,CAAK,IAAA,EAAM,IAAI,aAAa,CAAA,CAAA;AAAA,MACrC,IAAA;AAAA,MACA,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,MAAA,CAAO,aAAA,EAAuB,IAAA,EAAkC;AACpE,IAAA,MAAM,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,OAAA,CAAc;AAAA,MAChC,MAAA,EAAQ,QAAA;AAAA,MACR,MAAM,CAAA,EAAG,IAAA,CAAK,IAAA,EAAM,IAAI,aAAa,CAAA,CAAA;AAAA,MACrC;AAAA,KACD,CAAA;AAAA,EACH;AACF","file":"companies.cjs","sourcesContent":["import type { ClientContext } from \"../core/context\";\nimport type { AuthContext } from \"../core/auth\";\nimport type {\n  LegalEntity,\n  LegalEntityCreate,\n  LegalEntityUpdate,\n} from \"../generated/customer-management\";\n\n/**\n * Storefront-customer access to Legal Entities.\n *\n * `listMine`/`get` require `customermanagement.legalentity_read_own` on the\n * customer token. `create`/`update`/`delete` require the corresponding\n * `_manage` scopes — typically only granted to Admin-group customers; a 403\n * surfaces as `EmporixInsufficientScopeError`.\n */\nexport class CompaniesService {\n  constructor(private readonly ctx: ClientContext) {}\n\n  private base(): string {\n    return `/customer-management/${this.ctx.tenant}/legal-entities`;\n  }\n\n  /** Lists the legal entities the calling customer is assigned to. */\n  async listMine(auth: AuthContext): Promise<LegalEntity[]> {\n    return this.ctx.http.request<LegalEntity[]>({\n      method: \"GET\",\n      path: this.base(),\n      auth,\n    });\n  }\n\n  /** Fetches a single legal entity by id. */\n  async get(legalEntityId: string, auth: AuthContext): Promise<LegalEntity> {\n    return this.ctx.http.request<LegalEntity>({\n      method: \"GET\",\n      path: `${this.base()}/${legalEntityId}`,\n      auth,\n    });\n  }\n\n  /** Creates a legal entity. Requires `customermanagement.legalentity_manage`. */\n  async create(input: LegalEntityCreate, auth: AuthContext): Promise<{ id: string }> {\n    return this.ctx.http.request<{ id: string }>({\n      method: \"POST\",\n      path: this.base(),\n      auth,\n      body: input,\n    });\n  }\n\n  /** Patches a legal entity. */\n  async update(\n    legalEntityId: string,\n    patch: LegalEntityUpdate,\n    auth: AuthContext,\n  ): Promise<LegalEntity> {\n    return this.ctx.http.request<LegalEntity>({\n      method: \"PATCH\",\n      path: `${this.base()}/${legalEntityId}`,\n      auth,\n      body: patch,\n    });\n  }\n\n  /** Deletes a legal entity (async cascade on the server). */\n  async delete(legalEntityId: string, auth: AuthContext): Promise<void> {\n    await this.ctx.http.request<void>({\n      method: \"DELETE\",\n      path: `${this.base()}/${legalEntityId}`,\n      auth,\n    });\n  }\n}\n"]}

package/dist/companies.d.cts

@@ -0,0 +1,31 @@
+import { C as ClientContext, b as AuthContext } from './context-vKgzZ-5f.cjs';
+import { L as LegalEntity, f as LegalEntityCreate, h as LegalEntityUpdate } from './types.gen-D1QuqPLs.cjs';
+export { A as AccountLimit, e as CustomerGroupRef, g as LegalEntityType, i as LegalInfo } from './types.gen-D1QuqPLs.cjs';
+
+/**
+ * Storefront-customer access to Legal Entities.
+ *
+ * `listMine`/`get` require `customermanagement.legalentity_read_own` on the
+ * customer token. `create`/`update`/`delete` require the corresponding
+ * `_manage` scopes — typically only granted to Admin-group customers; a 403
+ * surfaces as `EmporixInsufficientScopeError`.
+ */
+declare class CompaniesService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    private base;
+    /** Lists the legal entities the calling customer is assigned to. */
+    listMine(auth: AuthContext): Promise<LegalEntity[]>;
+    /** Fetches a single legal entity by id. */
+    get(legalEntityId: string, auth: AuthContext): Promise<LegalEntity>;
+    /** Creates a legal entity. Requires `customermanagement.legalentity_manage`. */
+    create(input: LegalEntityCreate, auth: AuthContext): Promise<{
+        id: string;
+    }>;
+    /** Patches a legal entity. */
+    update(legalEntityId: string, patch: LegalEntityUpdate, auth: AuthContext): Promise<LegalEntity>;
+    /** Deletes a legal entity (async cascade on the server). */
+    delete(legalEntityId: string, auth: AuthContext): Promise<void>;
+}
+
+export { CompaniesService, LegalEntity, LegalEntityCreate, LegalEntityUpdate };

package/dist/companies.d.ts

@@ -0,0 +1,31 @@
+import { C as ClientContext, b as AuthContext } from './context-vKgzZ-5f.js';
+import { L as LegalEntity, f as LegalEntityCreate, h as LegalEntityUpdate } from './types.gen-D1QuqPLs.js';
+export { A as AccountLimit, e as CustomerGroupRef, g as LegalEntityType, i as LegalInfo } from './types.gen-D1QuqPLs.js';
+
+/**
+ * Storefront-customer access to Legal Entities.
+ *
+ * `listMine`/`get` require `customermanagement.legalentity_read_own` on the
+ * customer token. `create`/`update`/`delete` require the corresponding
+ * `_manage` scopes — typically only granted to Admin-group customers; a 403
+ * surfaces as `EmporixInsufficientScopeError`.
+ */
+declare class CompaniesService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    private base;
+    /** Lists the legal entities the calling customer is assigned to. */
+    listMine(auth: AuthContext): Promise<LegalEntity[]>;
+    /** Fetches a single legal entity by id. */
+    get(legalEntityId: string, auth: AuthContext): Promise<LegalEntity>;
+    /** Creates a legal entity. Requires `customermanagement.legalentity_manage`. */
+    create(input: LegalEntityCreate, auth: AuthContext): Promise<{
+        id: string;
+    }>;
+    /** Patches a legal entity. */
+    update(legalEntityId: string, patch: LegalEntityUpdate, auth: AuthContext): Promise<LegalEntity>;
+    /** Deletes a legal entity (async cascade on the server). */
+    delete(legalEntityId: string, auth: AuthContext): Promise<void>;
+}
+
+export { CompaniesService, LegalEntity, LegalEntityCreate, LegalEntityUpdate };

package/dist/companies.js

@@ -0,0 +1,3 @@
+export { CompaniesService } from './chunk-RXVVFNYN.js';
+//# sourceMappingURL=companies.js.map
+//# sourceMappingURL=companies.js.map

package/dist/companies.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"companies.js"}

package/dist/contacts.cjs

@@ -0,0 +1,51 @@
+'use strict';
+
+// src/services/contacts.ts
+var ContactsService = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+  }
+  ctx;
+  base() {
+    return `/customer-management/${this.ctx.tenant}/contact-assignments`;
+  }
+  /** Lists contact assignments for one legal entity. */
+  async listForCompany(legalEntityId, auth) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: this.base(),
+      query: { legalEntityId },
+      auth
+    });
+  }
+  /** Creates a contact assignment. */
+  async assign(input, auth) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: this.base(),
+      auth,
+      body: input
+    });
+  }
+  /** Patches a contact assignment. */
+  async update(contactAssignmentId, patch, auth) {
+    return this.ctx.http.request({
+      method: "PATCH",
+      path: `${this.base()}/${contactAssignmentId}`,
+      auth,
+      body: patch
+    });
+  }
+  /** Deletes a contact assignment. */
+  async unassign(contactAssignmentId, auth) {
+    await this.ctx.http.request({
+      method: "DELETE",
+      path: `${this.base()}/${contactAssignmentId}`,
+      auth
+    });
+  }
+};
+
+exports.ContactsService = ContactsService;
+//# sourceMappingURL=contacts.cjs.map
+//# sourceMappingURL=contacts.cjs.map

package/dist/contacts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/services/contacts.ts"],"names":[],"mappings":";;;AAeO,IAAM,kBAAN,MAAsB;AAAA,EAC3B,YAA6B,GAAA,EAAoB;AAApB,IAAA,IAAA,CAAA,GAAA,GAAA,GAAA;AAAA,EAAqB;AAAA,EAArB,GAAA;AAAA,EAErB,IAAA,GAAe;AACrB,IAAA,OAAO,CAAA,qBAAA,EAAwB,IAAA,CAAK,GAAA,CAAI,MAAM,CAAA,oBAAA,CAAA;AAAA,EAChD;AAAA;AAAA,EAGA,MAAM,cAAA,CAAe,aAAA,EAAuB,IAAA,EAAiD;AAC3F,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,OAAA,CAA6B;AAAA,MAChD,MAAA,EAAQ,KAAA;AAAA,MACR,IAAA,EAAM,KAAK,IAAA,EAAK;AAAA,MAChB,KAAA,EAAO,EAAE,aAAA,EAAc;AAAA,MACvB;AAAA,KACD,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,MAAA,CAAO,KAAA,EAAgC,IAAA,EAA4C;AACvF,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,OAAA,CAAwB;AAAA,MAC3C,MAAA,EAAQ,MAAA;AAAA,MACR,IAAA,EAAM,KAAK,IAAA,EAAK;AAAA,MAChB,IAAA;AAAA,MACA,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,MAAA,CACJ,mBAAA,EACA,KAAA,EACA,IAAA,EAC4B;AAC5B,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,OAAA,CAA2B;AAAA,MAC9C,MAAA,EAAQ,OAAA;AAAA,MACR,MAAM,CAAA,EAAG,IAAA,CAAK,IAAA,EAAM,IAAI,mBAAmB,CAAA,CAAA;AAAA,MAC3C,IAAA;AAAA,MACA,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,QAAA,CAAS,mBAAA,EAA6B,IAAA,EAAkC;AAC5E,IAAA,MAAM,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,OAAA,CAAc;AAAA,MAChC,MAAA,EAAQ,QAAA;AAAA,MACR,MAAM,CAAA,EAAG,IAAA,CAAK,IAAA,EAAM,IAAI,mBAAmB,CAAA,CAAA;AAAA,MAC3C;AAAA,KACD,CAAA;AAAA,EACH;AACF","file":"contacts.cjs","sourcesContent":["import type { ClientContext } from \"../core/context\";\nimport type { AuthContext } from \"../core/auth\";\nimport type {\n  ContactAssignment,\n  ContactAssignmentCreate,\n  ContactAssignmentUpdate,\n} from \"../generated/customer-management\";\n\n/**\n * Manages contact assignments linking customers to legal entities.\n *\n * `listForCompany` requires `customermanagement.contactassignment_read`;\n * `assign`/`update`/`unassign` require `_manage`. The query param\n * `legalEntityId` scopes the list to one company.\n */\nexport class ContactsService {\n  constructor(private readonly ctx: ClientContext) {}\n\n  private base(): string {\n    return `/customer-management/${this.ctx.tenant}/contact-assignments`;\n  }\n\n  /** Lists contact assignments for one legal entity. */\n  async listForCompany(legalEntityId: string, auth: AuthContext): Promise<ContactAssignment[]> {\n    return this.ctx.http.request<ContactAssignment[]>({\n      method: \"GET\",\n      path: this.base(),\n      query: { legalEntityId },\n      auth,\n    });\n  }\n\n  /** Creates a contact assignment. */\n  async assign(input: ContactAssignmentCreate, auth: AuthContext): Promise<{ id: string }> {\n    return this.ctx.http.request<{ id: string }>({\n      method: \"POST\",\n      path: this.base(),\n      auth,\n      body: input,\n    });\n  }\n\n  /** Patches a contact assignment. */\n  async update(\n    contactAssignmentId: string,\n    patch: ContactAssignmentUpdate,\n    auth: AuthContext,\n  ): Promise<ContactAssignment> {\n    return this.ctx.http.request<ContactAssignment>({\n      method: \"PATCH\",\n      path: `${this.base()}/${contactAssignmentId}`,\n      auth,\n      body: patch,\n    });\n  }\n\n  /** Deletes a contact assignment. */\n  async unassign(contactAssignmentId: string, auth: AuthContext): Promise<void> {\n    await this.ctx.http.request<void>({\n      method: \"DELETE\",\n      path: `${this.base()}/${contactAssignmentId}`,\n      auth,\n    });\n  }\n}\n"]}

package/dist/contacts.d.cts

@@ -0,0 +1,28 @@
+import { C as ClientContext, b as AuthContext } from './context-vKgzZ-5f.cjs';
+import { C as ContactAssignment, a as ContactAssignmentCreate, c as ContactAssignmentUpdate } from './types.gen-D1QuqPLs.cjs';
+export { b as ContactAssignmentType } from './types.gen-D1QuqPLs.cjs';
+
+/**
+ * Manages contact assignments linking customers to legal entities.
+ *
+ * `listForCompany` requires `customermanagement.contactassignment_read`;
+ * `assign`/`update`/`unassign` require `_manage`. The query param
+ * `legalEntityId` scopes the list to one company.
+ */
+declare class ContactsService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    private base;
+    /** Lists contact assignments for one legal entity. */
+    listForCompany(legalEntityId: string, auth: AuthContext): Promise<ContactAssignment[]>;
+    /** Creates a contact assignment. */
+    assign(input: ContactAssignmentCreate, auth: AuthContext): Promise<{
+        id: string;
+    }>;
+    /** Patches a contact assignment. */
+    update(contactAssignmentId: string, patch: ContactAssignmentUpdate, auth: AuthContext): Promise<ContactAssignment>;
+    /** Deletes a contact assignment. */
+    unassign(contactAssignmentId: string, auth: AuthContext): Promise<void>;
+}
+
+export { ContactAssignment, ContactAssignmentCreate, ContactAssignmentUpdate, ContactsService };

package/dist/contacts.d.ts

@@ -0,0 +1,28 @@
+import { C as ClientContext, b as AuthContext } from './context-vKgzZ-5f.js';
+import { C as ContactAssignment, a as ContactAssignmentCreate, c as ContactAssignmentUpdate } from './types.gen-D1QuqPLs.js';
+export { b as ContactAssignmentType } from './types.gen-D1QuqPLs.js';
+
+/**
+ * Manages contact assignments linking customers to legal entities.
+ *
+ * `listForCompany` requires `customermanagement.contactassignment_read`;
+ * `assign`/`update`/`unassign` require `_manage`. The query param
+ * `legalEntityId` scopes the list to one company.
+ */
+declare class ContactsService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    private base;
+    /** Lists contact assignments for one legal entity. */
+    listForCompany(legalEntityId: string, auth: AuthContext): Promise<ContactAssignment[]>;
+    /** Creates a contact assignment. */
+    assign(input: ContactAssignmentCreate, auth: AuthContext): Promise<{
+        id: string;
+    }>;
+    /** Patches a contact assignment. */
+    update(contactAssignmentId: string, patch: ContactAssignmentUpdate, auth: AuthContext): Promise<ContactAssignment>;
+    /** Deletes a contact assignment. */
+    unassign(contactAssignmentId: string, auth: AuthContext): Promise<void>;
+}
+
+export { ContactAssignment, ContactAssignmentCreate, ContactAssignmentUpdate, ContactsService };

package/dist/contacts.js

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

package/dist/contacts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"contacts.js"}

package/dist/context-vKgzZ-5f.d.cts

@@ -0,0 +1,329 @@
+/** Log severity, low → high. */
+type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "silent";
+/** Numeric ordering used for fast comparison. */
+declare const LEVEL: Record<LogLevel, number>;
+/** Services that bind their own logger and are independently level-controllable. */
+type ServiceName = "customer" | "product" | "category" | "cart" | "checkout" | "payment" | "price" | "media" | "segment" | "site" | "session-context" | "customer-management" | "iam" | "orders" | "sales-orders" | "http" | "auth";
+/** Arbitrary structured fields attached to a log line. */
+interface LogFields {
+    [key: string]: unknown;
+}
+/** The logger contract consumers may implement or swap. */
+interface Logger {
+    level: LogLevel;
+    isLevelEnabled(level: LogLevel): boolean;
+    trace(msg: string, fields?: LogFields): void;
+    debug(msg: string, fields?: LogFields): void;
+    info(msg: string, fields?: LogFields): void;
+    warn(msg: string, fields?: LogFields): void;
+    error(msg: string, fields?: LogFields): void;
+    child(bindings: LogFields): Logger;
+}
+/** Object form of logger configuration. */
+interface LoggerObjectConfig {
+    level?: LogLevel;
+    services?: Partial<Record<ServiceName, LogLevel>>;
+    pretty?: boolean;
+    redact?: string[];
+}
+/** `false` → noop logger; `Logger` → user-supplied; object → built-in console logger. */
+type LoggerConfig = false | Logger | LoggerObjectConfig;
+/**
+ * Resolves the effective level per service following:
+ * env per-service > env global > config.services[svc] > config.level > "warn".
+ * Runtime `set()` mutates programmatic levels but never overrides env-set ones
+ * unless `force` is passed.
+ */
+declare class LevelResolver {
+    private readonly warn;
+    private cfgLevel;
+    private cfgServices;
+    private forcedServices;
+    private forcedGlobal;
+    private warned;
+    constructor(cfg: LoggerObjectConfig, warn?: (msg: string) => void);
+    private envFor;
+    private envGlobal;
+    /**
+     * Effective level for a service. Forced overrides (from `set(..., force)`)
+     * take precedence over env vars; otherwise env > programmatic config.
+     */
+    get(svc: ServiceName): LogLevel;
+    /** Numeric effective level for a service. */
+    numericLevel(svc: ServiceName): number;
+    /** True if `svc`'s effective level allows emitting at `at`. */
+    isAtLeast(svc: ServiceName, at: LogLevel): boolean;
+    /** Mutates programmatic level (global or one service). Env-set levels are sticky unless `force`. */
+    set(level: LogLevel, svc?: ServiceName, force?: boolean): void;
+}
+/** Deep-clones `value`, replacing redacted keys with a mask. AuthContext token is stripped. */
+declare function redact(value: unknown, extra?: string[]): unknown;
+interface Sink {
+    log: (...a: unknown[]) => void;
+    info: (...a: unknown[]) => void;
+    warn: (...a: unknown[]) => void;
+    error: (...a: unknown[]) => void;
+}
+/** Creates the built-in console logger. `opts.sink` overrides `console` (used in tests). */
+declare function createConsoleLogger(resolver: LevelResolver, bindings?: LogFields, opts?: {
+    pretty?: boolean;
+    redact?: string[];
+    sink?: Sink;
+}): Logger;
+/** Creates a logger that discards everything. */
+declare function createNoopLogger(): Logger;
+
+/** Default Emporix API host. */
+declare const DEFAULT_HOST = "https://api.emporix.io";
+/** A client-credentials credential set (service / custom). */
+interface ServiceCredentials {
+    clientId: string;
+    secret: string;
+    scope?: string;
+}
+/** Storefront credential — anonymous token needs the client id only, no secret. */
+interface StorefrontCredentials {
+    clientId: string;
+    /**
+     * Session context bound at anonymous-login time. Required for
+     * `prices.matchByContext` to resolve currency/site/country server-side.
+     * `targetLocation` is an ISO country code.
+     */
+    context?: {
+        currency?: string;
+        siteCode?: string;
+        targetLocation?: string;
+    };
+}
+/** User-supplied SDK configuration. */
+interface EmporixConfig {
+    tenant: string;
+    host?: string;
+    credentials: {
+        /**
+         * Service (client-credentials) credentials. Optional: storefront/SPA apps
+         * use only `storefront` (anonymous) + caller-supplied customer tokens and
+         * must never ship a backend secret. Required only when a `service`
+         * AuthContext is actually used — enforced lazily by the TokenProvider.
+         */
+        backend?: ServiceCredentials;
+        storefront?: StorefrontCredentials;
+        custom?: Record<string, ServiceCredentials>;
+    };
+    tokenProvider?: TokenProvider;
+    timeouts?: {
+        connectMs?: number;
+        readMs?: number;
+    };
+    retry?: {
+        maxAttempts?: number;
+    };
+    cache?: {
+        expirationBufferSeconds?: number;
+        maxLifetimeSeconds?: number;
+    };
+    logger?: LoggerConfig;
+}
+/** Fully-resolved configuration with defaults applied. */
+interface ResolvedConfig {
+    tenant: string;
+    host: string;
+    credentials: EmporixConfig["credentials"];
+    tokenProvider: TokenProvider | undefined;
+    timeouts: {
+        connectMs: number;
+        readMs: number;
+    };
+    retry: {
+        maxAttempts: number;
+    };
+    cache: {
+        expirationBufferSeconds: number;
+        maxLifetimeSeconds: number;
+    };
+    logger: LoggerConfig | undefined;
+}
+/** Validates user config and applies defaults. Throws on invalid tenant/credentials. */
+declare function validateConfig(input: EmporixConfig): ResolvedConfig;
+
+/** Which token a call should use. */
+type AuthKind = "service" | "customer" | "anonymous" | "raw";
+/** Caller-supplied, per-call auth selector. Never stored on the client. */
+type AuthContext = {
+    kind: "service";
+    credentials?: string;
+} | {
+    kind: "anonymous";
+} | {
+    kind: "customer";
+    token: string;
+} | {
+    kind: "raw";
+    token: string;
+};
+/** An obtained anonymous storefront session. */
+interface AnonymousSession {
+    accessToken: string;
+    refreshToken: string;
+    sessionId: string;
+    expiresIn: number;
+}
+/**
+ * Persistence callback for anonymous sessions. `read` is called once on the
+ * first need for an anonymous token to bootstrap a possibly-existing session;
+ * `write` is called after every successful login or refresh. `write(null)`
+ * means the SDK is invalidating the stored session.
+ */
+interface AnonymousSessionStore {
+    read(): {
+        refreshToken: string;
+        sessionId: string;
+    } | null;
+    write(session: {
+        refreshToken: string;
+        sessionId: string;
+    } | null): void;
+}
+/** Supplies SDK-managed tokens (service/custom + anonymous). May be user-injected. */
+interface TokenProvider {
+    /** Service/custom client-credentials token for the named credential set. */
+    getToken(credentialSet: string): Promise<string>;
+    /** Cached anonymous storefront session (preserves sessionId across refreshes). */
+    getAnonymousToken(): Promise<AnonymousSession>;
+    /** Refresh the anonymous session, preserving sessionId. */
+    refreshAnonymous?(): Promise<AnonymousSession>;
+    /** Invalidate a cached SDK-managed token so the next call re-auths. */
+    invalidate?(credentialSet: string): void;
+    /** Invalidate the cached anonymous session entirely (next call re-logs in). */
+    invalidateAnonymous?(): void;
+    /**
+     * Mark the anonymous access token stale but keep the refresh token, so the
+     * next {@link getAnonymousToken} refreshes (preserving sessionId) rather
+     * than starting a brand-new session.
+     */
+    expireAnonymous?(): void;
+    /**
+     * Install a persistence adapter for the anonymous session. The host (e.g.
+     * `EmporixProvider`) calls this at construction so the SDK can bootstrap
+     * an existing session and persist refreshes. Idempotent: a later call
+     * replaces the previous adapter.
+     */
+    attachAnonymousStore?(store: AnonymousSessionStore): void;
+    /**
+     * Subscribe to token-refresh events. Optional — implementations may no-op.
+     * Returns an unsubscribe function. `DefaultTokenProvider` emits for the
+     * anonymous-login / anonymous-refresh paths.
+     */
+    onRefresh?(listener: (event: {
+        kind: "anonymous" | "customer";
+        success: boolean;
+    }) => void): () => void;
+}
+/** Tiny constructors for {@link AuthContext}. */
+declare const auth: {
+    /** Service/custom credential set (default `backend`). */
+    service: (credentials?: string) => AuthContext;
+    /** Cached anonymous storefront token. */
+    anonymous: () => AuthContext;
+    /** Caller-owned customer bearer token. */
+    customer: (token: string) => AuthContext;
+    /** Exact token, no transformation (SSO / token-exchange). */
+    raw: (token: string) => AuthContext;
+};
+/** Resolves an {@link AuthContext} to a concrete bearer token. */
+declare function resolveToken(ctx: AuthContext, provider: TokenProvider): Promise<string>;
+/** SDK-owned token provider: client-credentials service tokens + anonymous session. */
+declare class DefaultTokenProvider implements TokenProvider {
+    private readonly cfg;
+    private readonly serviceCache;
+    private readonly serviceLocks;
+    private anon;
+    private anonLock;
+    private anonStore?;
+    private readonly refreshListeners;
+    constructor(cfg: ResolvedConfig);
+    onRefresh(listener: (event: {
+        kind: "anonymous" | "customer";
+        success: boolean;
+    }) => void): () => void;
+    private notifyRefresh;
+    attachAnonymousStore(store: AnonymousSessionStore): void;
+    private creds;
+    private fresh;
+    getToken(set: string): Promise<string>;
+    private requestServiceToken;
+    invalidate(set: string): void;
+    private anonFresh;
+    getAnonymousToken(): Promise<AnonymousSession>;
+    /** Refreshes the anonymous session, preserving its sessionId. */
+    refreshAnonymous(): Promise<AnonymousSession>;
+    invalidateAnonymous(): void;
+    /** Force a stale access token while keeping the refresh token + sessionId. */
+    expireAnonymous(): void;
+    private stripExpiry;
+    private fetchAnonymous;
+}
+
+/** A single HTTP request through the SDK. */
+interface RequestOptions {
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    path: string;
+    auth: AuthContext;
+    query?: Record<string, string | number | undefined>;
+    body?: unknown;
+    /** Extra request headers (merged before auth; cannot override Authorization). */
+    headers?: Record<string, string>;
+    /** Per-request abort timeout override (ms). */
+    timeoutMs?: number;
+}
+/** Construction options for {@link HttpClient}. */
+interface HttpClientOptions {
+    host: string;
+    provider: TokenProvider;
+    logger: Logger;
+    retry: {
+        maxAttempts: number;
+    };
+    timeouts: {
+        connectMs: number;
+        readMs: number;
+    };
+    /** Override the retry backoff delay (ms → Promise). Defaults to a real timer. */
+    sleep?: (ms: number) => Promise<void>;
+}
+/** Fetch wrapper: auth resolution, JSON parsing, typed error mapping, logging. */
+declare class HttpClient {
+    private readonly opts;
+    private readonly sleep;
+    constructor(opts: HttpClientOptions);
+    request<T = unknown>(o: RequestOptions): Promise<T>;
+}
+
+/** Shared dependencies every service facade receives. */
+interface ClientContext {
+    tenant: string;
+    http: HttpClient;
+    tokenProvider: TokenProvider;
+    logger: Logger;
+}
+/**
+ * A cursor-paged collection — `pageNumber`/`pageSize` indexing with a
+ * `hasNextPage` signal driven by the source page being full. Used by all
+ * paginated services and hooks across the SDK.
+ */
+interface PaginatedItems<T> {
+    items: T[];
+    pageNumber: number;
+    pageSize: number;
+    hasNextPage: boolean;
+}
+/**
+ * Async-iterates every item across pages of a `PaginatedItems<T>` source.
+ * Stops when the source reports `hasNextPage: false`.
+ *
+ * @param fetchPage - given a 1-based page number, returns the page.
+ * @param start - first page to fetch (default `1`).
+ */
+declare function iterateAll<T>(fetchPage: (pageNumber: number) => Promise<PaginatedItems<T>>, start?: number): AsyncIterable<T>;
+
+export { type AnonymousSession as A, type ClientContext as C, DEFAULT_HOST as D, type EmporixConfig as E, HttpClient as H, LEVEL as L, type PaginatedItems as P, type RequestOptions as R, type ServiceCredentials as S, type TokenProvider as T, type AnonymousSessionStore as a, type AuthContext as b, type AuthKind as c, DefaultTokenProvider as d, type HttpClientOptions as e, LevelResolver as f, type LogFields as g, type LogLevel as h, type Logger as i, type LoggerConfig as j, type LoggerObjectConfig as k, type ResolvedConfig as l, type ServiceName as m, type StorefrontCredentials as n, auth as o, createConsoleLogger as p, createNoopLogger as q, iterateAll as r, redact as s, resolveToken as t, validateConfig as v };