@viu/emporix-sdk 2.29.0 → 2.31.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { C as ClientContext, b as AuthContext, P as PaginatedItems, T as TokenProvider, n as ResolvedConfig, E as EmporixConfig, j as LogLevel, o as ServiceName, e as CustomerTokenRefresher } from './context-B5rWL6QD.cjs';
-export { A as AnonymousSession, a as AnonymousSessionStore, c as AuthKind, d as CustomerRefreshRegistry, D as DEFAULT_HOST, f as DefaultTokenProvider, H as HttpClient, g as HttpClientOptions, L as LEVEL, h as LevelResolver, i as LogFields, k as Logger, l as LoggerConfig, m as LoggerObjectConfig, R as RequestOptions, S as ServiceCredentials, p as StorefrontCredentials, q as auth, r as createConsoleLogger, s as createNoopLogger, t as iterateAll, u as redact, v as resolveToken, w as validateConfig } from './context-B5rWL6QD.cjs';
+import { p as StoredAnonymousSession, b as AuthContext, C as ClientContext, P as PaginatedItems, T as TokenProvider, n as ResolvedConfig, E as EmporixConfig, j as LogLevel, o as ServiceName, e as CustomerTokenRefresher } from './context-CpLIDl0P.cjs';
+export { A as AnonymousSession, a as AnonymousSessionStore, c as AuthKind, d as CustomerRefreshRegistry, D as DEFAULT_HOST, f as DefaultTokenProvider, H as HttpClient, g as HttpClientOptions, L as LEVEL, h as LevelResolver, i as LogFields, k as Logger, l as LoggerConfig, m as LoggerObjectConfig, R as RequestOptions, S as ServiceCredentials, q as StorefrontCredentials, r as auth, s as createConsoleLogger, t as createNoopLogger, u as iterateAll, v as redact, w as resolveToken, x as validateConfig } from './context-CpLIDl0P.cjs';
 import { CustomerService } from './customer.cjs';
 export { Address, AddressCreateInput, AddressUpdateInput, ChangeEmailInput, ConfirmEmailChangeInput, Customer, CustomerSession, CustomerSignupInput, CustomerUpdateInput, PasswordChangeInput, PasswordResetConfirmInput, PasswordResetRequestInput, ResendActivationInput } from './customer.cjs';
 import { ProductService } from './product.cjs';
@@ -21,7 +21,7 @@ export { Segment, SegmentAssignmentBulkResult, SegmentBulkItem, SegmentBulkResul
 import { CompaniesService } from './companies.cjs';
 import { ContactsService } from './contacts.cjs';
 import { LocationsService } from './locations.cjs';
-import { m as UserResponse, U as UserCreateRequest, l as UserIdResponse, k as UserExtendedResponse, o as UserUpdateRequest, j as GroupsQueryDocument, n as UserScopesResponse, a as AccessControlQueryDocument, G as GroupCreateRequest, h as GroupIdResponse, i as GroupUpdateRequest, c as AssignmentCreateRequest, d as AssignmentIdResponse, b as AccessControlUpsertRequest, A as AccessControlIdResponse, e as CustomScopeQueryDocument, f as CustomScopeUpsertRequest, C as CustomScopeIdResponse, g as CustomerGroupsService } from './customer-groups-_czUdHab.cjs';
+import { m as UserResponse, U as UserCreateRequest, l as UserIdResponse, k as UserExtendedResponse, o as UserUpdateRequest, j as GroupsQueryDocument, n as UserScopesResponse, a as AccessControlQueryDocument, G as GroupCreateRequest, h as GroupIdResponse, i as GroupUpdateRequest, c as AssignmentCreateRequest, d as AssignmentIdResponse, b as AccessControlUpsertRequest, A as AccessControlIdResponse, e as CustomScopeQueryDocument, f as CustomScopeUpsertRequest, C as CustomScopeIdResponse, g as CustomerGroupsService } from './customer-groups-DJVbdrEP.cjs';
 import { OrdersService, SalesOrdersService } from './orders.cjs';
 export { GetOrderOptions, ListLegalEntityOrdersOptions, ListMyOrdersOptions, ListSalesOrdersOptions, Order, OrderEntry, OrderStatus, OrderTransitionOptions, SalesOrder, SalesOrderCalculationInput, SalesOrderCreateInput, SalesOrderCreated, SalesOrderEntriesInput, SalesOrderHistoricalTransitions, SalesOrderPatch, SalesOrderReplaceInput, SalesOrderSearchInput, SalesOrderSplitInput, SalesOrderSplitResult, Transition, UpdateSalesOrderOptions } from './orders.cjs';
 import { AvailabilityService } from './availability.cjs';
@@ -70,6 +70,170 @@ declare class EmporixInsufficientScopeError extends EmporixForbiddenError {
 /** Maps an HTTP status to the matching {@link EmporixError} subclass. */
 declare function errorFromResponse(status: number, message: string, body: unknown): EmporixError;
 
+/**
+ * The persisted session-state contract, shared by every host.
+ *
+ * It lives in the core SDK rather than in `@viu/emporix-sdk-react` because it is
+ * not a React concern: the same eight keys are cookie names in a Next
+ * `proxy.ts`, Web Storage keys in a browser adapter, and record fields in a
+ * server-side session store. Keeping it here is what let
+ * `@viu/emporix-sdk-next` drop its dependency on the React package — it needed
+ * these strings, not React.
+ *
+ * `@viu/emporix-sdk-react` re-exports both from `./storage` and `/ssr`, so
+ * existing imports keep working.
+ */
+/** Keys that participate in {@link EmporixStorage.subscribeAll}. */
+type EmporixStorageKey = "customerToken" | "cartId" | "siteCode" | "language" | "anonymousSession" | "activeLegalEntityId" | "refreshToken" | "saasToken";
+/**
+ * The eight persisted session keys, as the strings each backend actually uses.
+ * Same strings on purpose — a value written by one backend must be readable by
+ * the next, and the cookie set by a Next `proxy.ts` has to be the one
+ * `createCookieStorage` looks for.
+ *
+ * The `satisfies` is the point, not the deduplication: a ninth
+ * {@link EmporixStorageKey} without an entry here is a compile error, and an
+ * entry here without a union member is too. `as const` stays in front of it so
+ * the literal types survive for consumers.
+ */
+declare const STORAGE_KEYS: {
+    readonly customerToken: "emporix.customerToken";
+    readonly cartId: "emporix.cartId";
+    readonly anonymousSession: "emporix.anonymousSession";
+    readonly siteCode: "emporix.siteCode";
+    readonly language: "emporix.language";
+    readonly activeLegalEntityId: "emporix.activeLegalEntityId";
+    readonly refreshToken: "emporix.refreshToken";
+    readonly saasToken: "emporix.saasToken";
+};
+
+/**
+ * The persisted-session layer: the {@link EmporixStorage} contract and the two
+ * framework-free implementations of it that are not browser-specific.
+ *
+ * It lives in the core SDK for the same reason {@link STORAGE_KEYS} does — none
+ * of it is a React concern. A cookie-backed storage fits Next, Remix, SvelteKit,
+ * Nitro or a plain Node handler equally, and `@viu/emporix-sdk-next` needed
+ * exactly this and nothing else from `@viu/emporix-sdk-react`.
+ *
+ * `@viu/emporix-sdk-react` re-exports all of it and keeps the browser backends
+ * (memory, localStorage, sessionStorage, document.cookie), which genuinely belong
+ * there.
+ */
+
+/**
+ * The subset of an anonymous session a browser storage keeps.
+ *
+ * Derived from {@link StoredAnonymousSession} rather than re-declared: a server
+ * store may additionally persist the access token and its expiry, a browser one
+ * deliberately does not (the client is long-lived and holds the token in memory,
+ * so writing it would only expose a bearer token to JavaScript).
+ */
+type PersistedAnonymousSession = Pick<StoredAnonymousSession, "refreshToken" | "sessionId">;
+/** Pluggable persistence for SDK session state. SSR-safe by default (memory). */
+interface EmporixStorage {
+    getCustomerToken(): string | null;
+    setCustomerToken(token: string | null): void;
+    subscribe?(listener: (token: string | null) => void): () => void;
+    getCartId(): string | null;
+    setCartId(id: string | null): void;
+    getAnonymousSession(): PersistedAnonymousSession | null;
+    setAnonymousSession(session: PersistedAnonymousSession | null): void;
+    getSiteCode(): string | null;
+    setSiteCode(code: string | null): void;
+    getLanguage(): string | null;
+    setLanguage(language: string | null): void;
+    getActiveLegalEntityId(): string | null;
+    setActiveLegalEntityId(id: string | null): void;
+    getRefreshToken(): string | null;
+    setRefreshToken(token: string | null): void;
+    getSaasToken?(): string | null;
+    setSaasToken?(token: string | null): void;
+    /**
+     * Subscribe to any storage write. The listener receives the key that
+     * changed. Returns an unsubscribe function. Optional — backends may no-op.
+     * Used by the telemetry layer to emit `storage.write` events.
+     */
+    subscribeAll?(listener: (key: EmporixStorageKey) => void): () => void;
+}
+/** Backward-compat alias. New code should prefer {@link EmporixStorage}. */
+type TokenStorage = EmporixStorage;
+/**
+ * Parses a stored anonymous session (from Web Storage or a cookie) into a
+ * {@link PersistedAnonymousSession}. Returns `null` for absent, malformed or
+ * incomplete values — a half-written session must not become a half-valid one.
+ */
+declare function parseAnonymousSession(raw: string | null): PersistedAnonymousSession | null;
+/** Backend-agnostic cookie accessor. `set` absent means the storage is read-only. */
+interface CookieIo {
+    get(name: string): string | null;
+    /** `null` deletes the cookie. */
+    set?(name: string, value: string | null): void;
+}
+/**
+ * Builds an {@link EmporixStorage} over a cookie accessor. Contains the whole
+ * name-to-accessor mapping so no backend repeats it.
+ *
+ * `opts.notify` is a callback rather than a flag so this module stays free of
+ * listener-set lifetime: the browser backend owns a `createListenerSet`, passes
+ * its `notify` here, and attaches `subscribeAll` to the result itself. This
+ * function never sets `subscribeAll` — the server backend therefore has none,
+ * which is correct: a server render has no lifetime to observe.
+ */
+declare function createCookieBackedStorage(io: CookieIo, opts?: {
+    tokenName?: string;
+    notify?: (key: EmporixStorageKey) => void;
+}): EmporixStorage;
+/**
+ * A synchronous cookie accessor supplied by the caller. Deliberately
+ * synchronous: {@link EmporixStorage} is synchronous throughout, so any
+ * `await` (e.g. Next's `await cookies()`) belongs to the caller.
+ *
+ * Omit `set` for a read-only storage. Next.js forbids cookie writes during a
+ * Server Component render — only Server Actions and Route Handlers may write.
+ */
+interface ServerCookieJar {
+    get(name: string): string | null;
+    /** `null` deletes the cookie. */
+    set?(name: string, value: string | null): void;
+}
+/**
+ * An {@link EmporixStorage} reading (and optionally writing) through a
+ * caller-supplied cookie jar — for RSC, Server Actions, Route Handlers, or any
+ * other server runtime. No framework import: the jar shape fits Next, Remix,
+ * SvelteKit, Nitro or a plain Node handler.
+ *
+ * `subscribe` / `subscribeAll` are absent: a server render has no lifetime over
+ * which to observe changes.
+ *
+ * ```ts
+ * // Next.js Server Component (read-only)
+ * const jar = await cookies();
+ * const storage = createServerStorage({ get: (n) => jar.get(n)?.value ?? null });
+ *
+ * // Next.js Server Action (read-write)
+ * const jar = await cookies();
+ * const storage = createServerStorage({
+ *   get: (n) => jar.get(n)?.value ?? null,
+ *   set: (n, v) =>
+ *     v === null
+ *       ? jar.delete(n)
+ *       : jar.set(n, v, { httpOnly: true, sameSite: "lax", secure: true, path: "/" }),
+ * });
+ * ```
+ */
+declare function createServerStorage(jar: ServerCookieJar): EmporixStorage;
+/**
+ * Resolves the {@link AuthContext} a server-side read should use, mirroring
+ * exactly what the React `useEmporixQuery` resolves on the client: the customer
+ * context when a token is stored, anonymous otherwise.
+ *
+ * Use this rather than hand-rolling it — `authKind` is part of every React-Query
+ * key, so a mismatch here produces a silent cache miss (a second fetch after
+ * hydration, no error).
+ */
+declare function serverAuth(storage: EmporixStorage): AuthContext;
+
 /**
  * Site address.
  */
@@ -1716,6 +1880,17 @@ type SchemaAttribute$1 = {
         [key: string]: unknown;
     };
     type: SchemaAttributeType;
+    /**
+     * Decimal precision for attributes of `DECIMAL` type. Defines the allowed decimal step for attribute values
+     * (for example `0.1`, `0.01`, `0.001`).
+     * Allowed values:
+     * * `-1` – no precision constraint
+     * * a positive decimal step of the form `0.1`, `0.01`, `0.001`, and so on (`10^-n` where `n >= 1`)
+     * This property can only be provided when `type` is `DECIMAL` (or, for arrays, when `arrayType.type` is `DECIMAL`).
+     * If omitted for a `DECIMAL` attribute, the default precision `0.01` is applied.
+     *
+     */
+    precision?: number;
     metadata: SchemaAttributeMetadata;
     /**
      * List of available values for the attribute. Only valid for `ENUM` and `REFERENCE` type.
@@ -10751,4 +10926,4 @@ declare function createEmporixClient<S extends Record<string, ServiceClass<unkno
  */
 declare function productIdFromYrn(yrn: string | undefined): string;
 
-export { type AddedPoints, type AdminCustomer, type AdminCustomerAddress, type AdminCustomerAddressInput, type AdminCustomerAddressList, type AdminCustomerAddressUpdate, type AdminCustomerCreated, type AdminCustomerInput, type AdminCustomerList, type AdminCustomerPatch, type AdminCustomerSearchQuery, type AdminCustomerUpdate, type Agent, type AgentAnalytics, type AgentExecutions, type AgentFromTemplate, type AgentInput, type AgentPatchOp, type AgentRequestLog, type AgentSearchQuery, type AgentSessionLog, type AgentTemplate, type AgenticPatchOp, type AgentsExport, type AgentsExportRequest, type AgentsImport, type AgentsImportRequest, AiService, type AnalyticsQuery, type Approval, type ApprovalCreated, type ApprovalInput, type ApprovalList, type ApprovalPatch, type ApprovalPermittedInput, type ApprovalPermittedResult, ApprovalService, type ApprovalUsersQuery, type ApprovalUsersResult, type Assignee, type Attachment, type AttachmentOptions, AuthContext, AvailabilityService, type BatchNextIdEntry, type Brand, type BrandInput, type BrandList, BrandService, type BrandUpdate, type BulkInstanceResult, type BulkPatchInstanceItem, CartService, type Catalog, type CatalogCreated, type CatalogInput, type CatalogList, type CatalogPatch, CatalogService, type CatalogUpdate, CategoryService, type CgRelation, type CgRelationList, type ChatRequest, type ChatResponse, type ChatStreamOptions, CheckoutService, ClientConfigService, type ClientConfiguration, ClientContext, CloudFunctionsService, type CommerceEvents, CompaniesService, type CompletionMessage, type CompletionRequest, type CompletionResponse, type Configuration$1 as Configuration, type ConfigurationDraft, ContactsService, type Conversation, type ConversationSearchQuery, type ConversionFactorInput, type ConversionFactorResult, type ConvertUnitInput, type ConvertUnitResult, type Country, type CountryList, CountryService, type CountryUpdate, type Coupon$1 as Coupon, type CouponCreated, type CouponInput, type CouponList, CouponService, type CouponUpdate, type Created, type Currency, type CurrencyCreated, type CurrencyInput, type CurrencyList, CurrencyService, type CurrencyUpdate, type CustomEntity, type CustomEntityDraft, type CustomInstance, type CustomInstanceDraft, CustomerAdminService, CustomerGroupsService, CustomerService, type CustomerSummaryBatch, CustomerTokenRefresher, type DeleteAgentOptions, type DeleteConfigOptions, type DeliveryCreated, type DeliveryCycleInput, type DeliverySlot, type DeliverySlotList, type DeliveryTime$1 as DeliveryTime, type DeliveryTimeInput, type DeliveryTimeList, type DeliveryTimeUpdate, type DeliveryWindow$2 as DeliveryWindow, type DeliveryWindowList, type DeliveryWindowValidation, EmporixAuthError, EmporixClient, EmporixConfig, type EmporixCore, EmporixError, EmporixForbiddenError, EmporixInsufficientScopeError, EmporixNetworkError, EmporixNotFoundError, EmporixServerError, EmporixTimeoutError, EmporixValidationError, type ExchangeRate, type ExchangeRateCreated, type ExchangeRateInput, type ExchangeRateList, type ExchangeRateUpdate, type ExecutionsQuery, type Fee$1 as Fee, type FeeDraft, FeeService, type FindSiteInput, type GetOptions, type IamAccessControl, type IamAccessControlCreated, type IamAccessControlUpsert, type IamGroup, type IamGroupCreate, type IamGroupCreated, AssignmentCreateRequest as IamGroupMemberAssignment, type IamGroupMemberCreated, type IamGroupMemberInput, type IamGroupUpdate, type IamScope, type IamScopeCreated, type IamScopeUpsert, IamService, type IamUser, type IamUserCreate, type IamUserCreated, type IamUserDetail, type IamUserScopes, type IamUserUpdate, type ImportCancelResult, type ImportConfig, type ImportErrorRecord, type ImportPage, type ImportPageOptions, type ImportRecordOutcome, type ImportRun, type ImportRunDetail, type ImportRunEvent, type ImportRunInput, type ImportRunMode, type ImportRunStatus, type ImportRunStream, type ImportSchedule, ImportService, type ImportStream, type ImportedRecord, type IndexConfig, type IndexConfigCreated, type IndexPublicConfig, IndexingService, type InstanceSearchBody, type InvoiceJob, type InvoiceJobCreated, type InvoiceJobDraft, InvoiceService, type InvokeCloudFunctionOptions, type ItemFee, type ItemFeeDraft, type ItemFeeSearch, type ItemFeeSearchByProductId, type ItemFeeSearchByProductIds, type Job, type JobIdResponse, type Label, type LabelInput, type LabelList, LabelService, type LabelUpdate, type ListConfigOptions, type ListCustomEntitiesOptions, type ListFeesQuery, type ListInstancesQuery, type ListQuery, type ListQuoteReasonsQuery, type ListQuotesQuery, type ListReindexJobsOptions, type ListSchemaReferencesQuery, type ListSchemasQuery, LocationsService, LogLevel, type McpServer, type McpServerInput, MediaService, type MetadataFilter, type MinimumFee, type MutateOptions, type NewPointsEntry, type NextIdCommandRequest, type NextIdOptions, type NextIdResponse, type NextIdsBatchRequest, type NextIdsBatchResponse, type OAuthConfig, type OAuthInput, type OrderCycleList, type OrderEntryEventCreate, type OrderStatusChange, OrdersService, type PackagingProductsChange, type PackingEvent, type PackingEventList, PaginatedItems, PaymentGatewayService, type PickOrder, type PickOrderList, type PickPackAck, PickPackService, type PointsSummary, PriceService, ProductService, type ProviderModels, QueryFor, type Quote, type QuoteCreated, type QuoteDraft, type QuoteHistory, type QuoteInput, type QuoteReason, type QuoteReasonCreated, type QuoteReasonDraft, type QuoteReasonUpdate, type QuoteResult, QuoteService, type QuoteSlotInput, type QuoteUpdate, RagIndexerService, type RagType, type RecalculationJob, type RecalculationJobCreated, type RecalculationJobInput, type RedeemCouponResult, type RedeemMyPointsInput, type RedeemOption, type RedeemOptionList, type RedeemedPoints, type Redemption, type RedemptionCreated, type RedemptionInput, type ReferralCoupon, type Region, type RegionList, type ReindexEntityType, type ReindexInput, type ReindexJob, type ReindexJobInput, type ReindexJobStatus, ResolvedConfig, type ResourceCreated, type Return, type ReturnCreated, type ReturnInput, type ReturnList, type ReturnPatch, type ReturnUpdate, ReturnsService, RewardPointsService, SalesOrdersService, type Schema, type SchemaAttribute, type SchemaDraft, type SchemaExport, type SchemaImportInput, type SchemaInstanceBulkCreateItem, type SchemaInstanceBulkUpsertItem, type SchemaReference, type SchemaReferenceCreated, type SchemaReferenceInput, type SchemaReferenceUpdateInput, SchemaService, type SchemaTypeName, type SchemaUpdate, type SearchImportedRecordsOptions, type SearchQuery, type SearchStreamRecordsOptions, SegmentService, SepaExportService, type SepaJob, type SepaJobCreated, type SepaJobInput, type SequenceSchema, type SequenceSchemaCreate, SequentialIdService, type ServiceClass, ServiceName, type SessionAttributeInput, type SessionContext, type SessionContextPatch, SessionContextService, type SetItemFeesOptions, type ShippingFee, type ShippingGroup, type ShippingGroupList, type ShippingMethod, type ShippingMethodList, type ShippingPatch, ShippingService, type ShoppingList, type ShoppingListDraft, type ShoppingListItem, ShoppingListService, type Site$1 as Site, type SiteCreated, type SiteInput, type SiteList, type SiteMixin, type SiteMixinCreated, type SiteMixins, SiteService, type TaxCalculationInput, type TaxCalculationRequest, type TaxCalculationResult, type TaxClass, type TaxConfig, type TaxConfigCreated, type TaxCreation as TaxConfigInput, type TaxUpdate as TaxConfigUpdate, type TaxLocation, TaxService, TenantConfigService, type TextRequest, type TextResponse, type Token, type TokenInput, TokenProvider, type Tool, type ToolInput, type Unit, type UnitCreated, UnitHandlingService, type UnitInput, type UnitUpdate, type Vendor, type VendorCreated, type VendorInput, type VendorList, type VendorLocation, type VendorLocationInput, type VendorLocationList, type VendorLocationUpdate, type VendorSearchQuery, VendorService, type VendorUpdate, type WebhookConfig, type WebhookConfigCreated, type WebhookConfigDraft, type WebhookConfigPatch, type WebhookDashboardAccess, WebhookService, type WebhookStatistics, type WebhookStatisticsQuery, type WebhookSubscription, type WebhookSubscriptionUpdateItem, type WebhookSubscriptionUpdateResultItem, type Zone, type ZoneList, createCore, createEmporixClient, errorFromResponse, pickFee, productIdFromYrn, resolveZone };
+export { type AddedPoints, type AdminCustomer, type AdminCustomerAddress, type AdminCustomerAddressInput, type AdminCustomerAddressList, type AdminCustomerAddressUpdate, type AdminCustomerCreated, type AdminCustomerInput, type AdminCustomerList, type AdminCustomerPatch, type AdminCustomerSearchQuery, type AdminCustomerUpdate, type Agent, type AgentAnalytics, type AgentExecutions, type AgentFromTemplate, type AgentInput, type AgentPatchOp, type AgentRequestLog, type AgentSearchQuery, type AgentSessionLog, type AgentTemplate, type AgenticPatchOp, type AgentsExport, type AgentsExportRequest, type AgentsImport, type AgentsImportRequest, AiService, type AnalyticsQuery, type Approval, type ApprovalCreated, type ApprovalInput, type ApprovalList, type ApprovalPatch, type ApprovalPermittedInput, type ApprovalPermittedResult, ApprovalService, type ApprovalUsersQuery, type ApprovalUsersResult, type Assignee, type Attachment, type AttachmentOptions, AuthContext, AvailabilityService, type BatchNextIdEntry, type Brand, type BrandInput, type BrandList, BrandService, type BrandUpdate, type BulkInstanceResult, type BulkPatchInstanceItem, CartService, type Catalog, type CatalogCreated, type CatalogInput, type CatalogList, type CatalogPatch, CatalogService, type CatalogUpdate, CategoryService, type CgRelation, type CgRelationList, type ChatRequest, type ChatResponse, type ChatStreamOptions, CheckoutService, ClientConfigService, type ClientConfiguration, ClientContext, CloudFunctionsService, type CommerceEvents, CompaniesService, type CompletionMessage, type CompletionRequest, type CompletionResponse, type Configuration$1 as Configuration, type ConfigurationDraft, ContactsService, type Conversation, type ConversationSearchQuery, type ConversionFactorInput, type ConversionFactorResult, type ConvertUnitInput, type ConvertUnitResult, type CookieIo, type Country, type CountryList, CountryService, type CountryUpdate, type Coupon$1 as Coupon, type CouponCreated, type CouponInput, type CouponList, CouponService, type CouponUpdate, type Created, type Currency, type CurrencyCreated, type CurrencyInput, type CurrencyList, CurrencyService, type CurrencyUpdate, type CustomEntity, type CustomEntityDraft, type CustomInstance, type CustomInstanceDraft, CustomerAdminService, CustomerGroupsService, CustomerService, type CustomerSummaryBatch, CustomerTokenRefresher, type DeleteAgentOptions, type DeleteConfigOptions, type DeliveryCreated, type DeliveryCycleInput, type DeliverySlot, type DeliverySlotList, type DeliveryTime$1 as DeliveryTime, type DeliveryTimeInput, type DeliveryTimeList, type DeliveryTimeUpdate, type DeliveryWindow$2 as DeliveryWindow, type DeliveryWindowList, type DeliveryWindowValidation, EmporixAuthError, EmporixClient, EmporixConfig, type EmporixCore, EmporixError, EmporixForbiddenError, EmporixInsufficientScopeError, EmporixNetworkError, EmporixNotFoundError, EmporixServerError, type EmporixStorage, type EmporixStorageKey, EmporixTimeoutError, EmporixValidationError, type ExchangeRate, type ExchangeRateCreated, type ExchangeRateInput, type ExchangeRateList, type ExchangeRateUpdate, type ExecutionsQuery, type Fee$1 as Fee, type FeeDraft, FeeService, type FindSiteInput, type GetOptions, type IamAccessControl, type IamAccessControlCreated, type IamAccessControlUpsert, type IamGroup, type IamGroupCreate, type IamGroupCreated, AssignmentCreateRequest as IamGroupMemberAssignment, type IamGroupMemberCreated, type IamGroupMemberInput, type IamGroupUpdate, type IamScope, type IamScopeCreated, type IamScopeUpsert, IamService, type IamUser, type IamUserCreate, type IamUserCreated, type IamUserDetail, type IamUserScopes, type IamUserUpdate, type ImportCancelResult, type ImportConfig, type ImportErrorRecord, type ImportPage, type ImportPageOptions, type ImportRecordOutcome, type ImportRun, type ImportRunDetail, type ImportRunEvent, type ImportRunInput, type ImportRunMode, type ImportRunStatus, type ImportRunStream, type ImportSchedule, ImportService, type ImportStream, type ImportedRecord, type IndexConfig, type IndexConfigCreated, type IndexPublicConfig, IndexingService, type InstanceSearchBody, type InvoiceJob, type InvoiceJobCreated, type InvoiceJobDraft, InvoiceService, type InvokeCloudFunctionOptions, type ItemFee, type ItemFeeDraft, type ItemFeeSearch, type ItemFeeSearchByProductId, type ItemFeeSearchByProductIds, type Job, type JobIdResponse, type Label, type LabelInput, type LabelList, LabelService, type LabelUpdate, type ListConfigOptions, type ListCustomEntitiesOptions, type ListFeesQuery, type ListInstancesQuery, type ListQuery, type ListQuoteReasonsQuery, type ListQuotesQuery, type ListReindexJobsOptions, type ListSchemaReferencesQuery, type ListSchemasQuery, LocationsService, LogLevel, type McpServer, type McpServerInput, MediaService, type MetadataFilter, type MinimumFee, type MutateOptions, type NewPointsEntry, type NextIdCommandRequest, type NextIdOptions, type NextIdResponse, type NextIdsBatchRequest, type NextIdsBatchResponse, type OAuthConfig, type OAuthInput, type OrderCycleList, type OrderEntryEventCreate, type OrderStatusChange, OrdersService, type PackagingProductsChange, type PackingEvent, type PackingEventList, PaginatedItems, PaymentGatewayService, type PersistedAnonymousSession, type PickOrder, type PickOrderList, type PickPackAck, PickPackService, type PointsSummary, PriceService, ProductService, type ProviderModels, QueryFor, type Quote, type QuoteCreated, type QuoteDraft, type QuoteHistory, type QuoteInput, type QuoteReason, type QuoteReasonCreated, type QuoteReasonDraft, type QuoteReasonUpdate, type QuoteResult, QuoteService, type QuoteSlotInput, type QuoteUpdate, RagIndexerService, type RagType, type RecalculationJob, type RecalculationJobCreated, type RecalculationJobInput, type RedeemCouponResult, type RedeemMyPointsInput, type RedeemOption, type RedeemOptionList, type RedeemedPoints, type Redemption, type RedemptionCreated, type RedemptionInput, type ReferralCoupon, type Region, type RegionList, type ReindexEntityType, type ReindexInput, type ReindexJob, type ReindexJobInput, type ReindexJobStatus, ResolvedConfig, type ResourceCreated, type Return, type ReturnCreated, type ReturnInput, type ReturnList, type ReturnPatch, type ReturnUpdate, ReturnsService, RewardPointsService, STORAGE_KEYS, SalesOrdersService, type Schema, type SchemaAttribute, type SchemaDraft, type SchemaExport, type SchemaImportInput, type SchemaInstanceBulkCreateItem, type SchemaInstanceBulkUpsertItem, type SchemaReference, type SchemaReferenceCreated, type SchemaReferenceInput, type SchemaReferenceUpdateInput, SchemaService, type SchemaTypeName, type SchemaUpdate, type SearchImportedRecordsOptions, type SearchQuery, type SearchStreamRecordsOptions, SegmentService, SepaExportService, type SepaJob, type SepaJobCreated, type SepaJobInput, type SequenceSchema, type SequenceSchemaCreate, SequentialIdService, type ServerCookieJar, type ServiceClass, ServiceName, type SessionAttributeInput, type SessionContext, type SessionContextPatch, SessionContextService, type SetItemFeesOptions, type ShippingFee, type ShippingGroup, type ShippingGroupList, type ShippingMethod, type ShippingMethodList, type ShippingPatch, ShippingService, type ShoppingList, type ShoppingListDraft, type ShoppingListItem, ShoppingListService, type Site$1 as Site, type SiteCreated, type SiteInput, type SiteList, type SiteMixin, type SiteMixinCreated, type SiteMixins, SiteService, StoredAnonymousSession, type TaxCalculationInput, type TaxCalculationRequest, type TaxCalculationResult, type TaxClass, type TaxConfig, type TaxConfigCreated, type TaxCreation as TaxConfigInput, type TaxUpdate as TaxConfigUpdate, type TaxLocation, TaxService, TenantConfigService, type TextRequest, type TextResponse, type Token, type TokenInput, TokenProvider, type TokenStorage, type Tool, type ToolInput, type Unit, type UnitCreated, UnitHandlingService, type UnitInput, type UnitUpdate, type Vendor, type VendorCreated, type VendorInput, type VendorList, type VendorLocation, type VendorLocationInput, type VendorLocationList, type VendorLocationUpdate, type VendorSearchQuery, VendorService, type VendorUpdate, type WebhookConfig, type WebhookConfigCreated, type WebhookConfigDraft, type WebhookConfigPatch, type WebhookDashboardAccess, WebhookService, type WebhookStatistics, type WebhookStatisticsQuery, type WebhookSubscription, type WebhookSubscriptionUpdateItem, type WebhookSubscriptionUpdateResultItem, type Zone, type ZoneList, createCookieBackedStorage, createCore, createEmporixClient, createServerStorage, errorFromResponse, parseAnonymousSession, pickFee, productIdFromYrn, resolveZone, serverAuth };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as ClientContext, b as AuthContext, P as PaginatedItems, T as TokenProvider, n as ResolvedConfig, E as EmporixConfig, j as LogLevel, o as ServiceName, e as CustomerTokenRefresher } from './context-B5rWL6QD.js';
-export { A as AnonymousSession, a as AnonymousSessionStore, c as AuthKind, d as CustomerRefreshRegistry, D as DEFAULT_HOST, f as DefaultTokenProvider, H as HttpClient, g as HttpClientOptions, L as LEVEL, h as LevelResolver, i as LogFields, k as Logger, l as LoggerConfig, m as LoggerObjectConfig, R as RequestOptions, S as ServiceCredentials, p as StorefrontCredentials, q as auth, r as createConsoleLogger, s as createNoopLogger, t as iterateAll, u as redact, v as resolveToken, w as validateConfig } from './context-B5rWL6QD.js';
+import { p as StoredAnonymousSession, b as AuthContext, C as ClientContext, P as PaginatedItems, T as TokenProvider, n as ResolvedConfig, E as EmporixConfig, j as LogLevel, o as ServiceName, e as CustomerTokenRefresher } from './context-CpLIDl0P.js';
+export { A as AnonymousSession, a as AnonymousSessionStore, c as AuthKind, d as CustomerRefreshRegistry, D as DEFAULT_HOST, f as DefaultTokenProvider, H as HttpClient, g as HttpClientOptions, L as LEVEL, h as LevelResolver, i as LogFields, k as Logger, l as LoggerConfig, m as LoggerObjectConfig, R as RequestOptions, S as ServiceCredentials, q as StorefrontCredentials, r as auth, s as createConsoleLogger, t as createNoopLogger, u as iterateAll, v as redact, w as resolveToken, x as validateConfig } from './context-CpLIDl0P.js';
 import { CustomerService } from './customer.js';
 export { Address, AddressCreateInput, AddressUpdateInput, ChangeEmailInput, ConfirmEmailChangeInput, Customer, CustomerSession, CustomerSignupInput, CustomerUpdateInput, PasswordChangeInput, PasswordResetConfirmInput, PasswordResetRequestInput, ResendActivationInput } from './customer.js';
 import { ProductService } from './product.js';
@@ -21,7 +21,7 @@ export { Segment, SegmentAssignmentBulkResult, SegmentBulkItem, SegmentBulkResul
 import { CompaniesService } from './companies.js';
 import { ContactsService } from './contacts.js';
 import { LocationsService } from './locations.js';
-import { m as UserResponse, U as UserCreateRequest, l as UserIdResponse, k as UserExtendedResponse, o as UserUpdateRequest, j as GroupsQueryDocument, n as UserScopesResponse, a as AccessControlQueryDocument, G as GroupCreateRequest, h as GroupIdResponse, i as GroupUpdateRequest, c as AssignmentCreateRequest, d as AssignmentIdResponse, b as AccessControlUpsertRequest, A as AccessControlIdResponse, e as CustomScopeQueryDocument, f as CustomScopeUpsertRequest, C as CustomScopeIdResponse, g as CustomerGroupsService } from './customer-groups-BRN6I23C.js';
+import { m as UserResponse, U as UserCreateRequest, l as UserIdResponse, k as UserExtendedResponse, o as UserUpdateRequest, j as GroupsQueryDocument, n as UserScopesResponse, a as AccessControlQueryDocument, G as GroupCreateRequest, h as GroupIdResponse, i as GroupUpdateRequest, c as AssignmentCreateRequest, d as AssignmentIdResponse, b as AccessControlUpsertRequest, A as AccessControlIdResponse, e as CustomScopeQueryDocument, f as CustomScopeUpsertRequest, C as CustomScopeIdResponse, g as CustomerGroupsService } from './customer-groups-DhpCTCTg.js';
 import { OrdersService, SalesOrdersService } from './orders.js';
 export { GetOrderOptions, ListLegalEntityOrdersOptions, ListMyOrdersOptions, ListSalesOrdersOptions, Order, OrderEntry, OrderStatus, OrderTransitionOptions, SalesOrder, SalesOrderCalculationInput, SalesOrderCreateInput, SalesOrderCreated, SalesOrderEntriesInput, SalesOrderHistoricalTransitions, SalesOrderPatch, SalesOrderReplaceInput, SalesOrderSearchInput, SalesOrderSplitInput, SalesOrderSplitResult, Transition, UpdateSalesOrderOptions } from './orders.js';
 import { AvailabilityService } from './availability.js';
@@ -70,6 +70,170 @@ declare class EmporixInsufficientScopeError extends EmporixForbiddenError {
 /** Maps an HTTP status to the matching {@link EmporixError} subclass. */
 declare function errorFromResponse(status: number, message: string, body: unknown): EmporixError;
 
+/**
+ * The persisted session-state contract, shared by every host.
+ *
+ * It lives in the core SDK rather than in `@viu/emporix-sdk-react` because it is
+ * not a React concern: the same eight keys are cookie names in a Next
+ * `proxy.ts`, Web Storage keys in a browser adapter, and record fields in a
+ * server-side session store. Keeping it here is what let
+ * `@viu/emporix-sdk-next` drop its dependency on the React package — it needed
+ * these strings, not React.
+ *
+ * `@viu/emporix-sdk-react` re-exports both from `./storage` and `/ssr`, so
+ * existing imports keep working.
+ */
+/** Keys that participate in {@link EmporixStorage.subscribeAll}. */
+type EmporixStorageKey = "customerToken" | "cartId" | "siteCode" | "language" | "anonymousSession" | "activeLegalEntityId" | "refreshToken" | "saasToken";
+/**
+ * The eight persisted session keys, as the strings each backend actually uses.
+ * Same strings on purpose — a value written by one backend must be readable by
+ * the next, and the cookie set by a Next `proxy.ts` has to be the one
+ * `createCookieStorage` looks for.
+ *
+ * The `satisfies` is the point, not the deduplication: a ninth
+ * {@link EmporixStorageKey} without an entry here is a compile error, and an
+ * entry here without a union member is too. `as const` stays in front of it so
+ * the literal types survive for consumers.
+ */
+declare const STORAGE_KEYS: {
+    readonly customerToken: "emporix.customerToken";
+    readonly cartId: "emporix.cartId";
+    readonly anonymousSession: "emporix.anonymousSession";
+    readonly siteCode: "emporix.siteCode";
+    readonly language: "emporix.language";
+    readonly activeLegalEntityId: "emporix.activeLegalEntityId";
+    readonly refreshToken: "emporix.refreshToken";
+    readonly saasToken: "emporix.saasToken";
+};
+
+/**
+ * The persisted-session layer: the {@link EmporixStorage} contract and the two
+ * framework-free implementations of it that are not browser-specific.
+ *
+ * It lives in the core SDK for the same reason {@link STORAGE_KEYS} does — none
+ * of it is a React concern. A cookie-backed storage fits Next, Remix, SvelteKit,
+ * Nitro or a plain Node handler equally, and `@viu/emporix-sdk-next` needed
+ * exactly this and nothing else from `@viu/emporix-sdk-react`.
+ *
+ * `@viu/emporix-sdk-react` re-exports all of it and keeps the browser backends
+ * (memory, localStorage, sessionStorage, document.cookie), which genuinely belong
+ * there.
+ */
+
+/**
+ * The subset of an anonymous session a browser storage keeps.
+ *
+ * Derived from {@link StoredAnonymousSession} rather than re-declared: a server
+ * store may additionally persist the access token and its expiry, a browser one
+ * deliberately does not (the client is long-lived and holds the token in memory,
+ * so writing it would only expose a bearer token to JavaScript).
+ */
+type PersistedAnonymousSession = Pick<StoredAnonymousSession, "refreshToken" | "sessionId">;
+/** Pluggable persistence for SDK session state. SSR-safe by default (memory). */
+interface EmporixStorage {
+    getCustomerToken(): string | null;
+    setCustomerToken(token: string | null): void;
+    subscribe?(listener: (token: string | null) => void): () => void;
+    getCartId(): string | null;
+    setCartId(id: string | null): void;
+    getAnonymousSession(): PersistedAnonymousSession | null;
+    setAnonymousSession(session: PersistedAnonymousSession | null): void;
+    getSiteCode(): string | null;
+    setSiteCode(code: string | null): void;
+    getLanguage(): string | null;
+    setLanguage(language: string | null): void;
+    getActiveLegalEntityId(): string | null;
+    setActiveLegalEntityId(id: string | null): void;
+    getRefreshToken(): string | null;
+    setRefreshToken(token: string | null): void;
+    getSaasToken?(): string | null;
+    setSaasToken?(token: string | null): void;
+    /**
+     * Subscribe to any storage write. The listener receives the key that
+     * changed. Returns an unsubscribe function. Optional — backends may no-op.
+     * Used by the telemetry layer to emit `storage.write` events.
+     */
+    subscribeAll?(listener: (key: EmporixStorageKey) => void): () => void;
+}
+/** Backward-compat alias. New code should prefer {@link EmporixStorage}. */
+type TokenStorage = EmporixStorage;
+/**
+ * Parses a stored anonymous session (from Web Storage or a cookie) into a
+ * {@link PersistedAnonymousSession}. Returns `null` for absent, malformed or
+ * incomplete values — a half-written session must not become a half-valid one.
+ */
+declare function parseAnonymousSession(raw: string | null): PersistedAnonymousSession | null;
+/** Backend-agnostic cookie accessor. `set` absent means the storage is read-only. */
+interface CookieIo {
+    get(name: string): string | null;
+    /** `null` deletes the cookie. */
+    set?(name: string, value: string | null): void;
+}
+/**
+ * Builds an {@link EmporixStorage} over a cookie accessor. Contains the whole
+ * name-to-accessor mapping so no backend repeats it.
+ *
+ * `opts.notify` is a callback rather than a flag so this module stays free of
+ * listener-set lifetime: the browser backend owns a `createListenerSet`, passes
+ * its `notify` here, and attaches `subscribeAll` to the result itself. This
+ * function never sets `subscribeAll` — the server backend therefore has none,
+ * which is correct: a server render has no lifetime to observe.
+ */
+declare function createCookieBackedStorage(io: CookieIo, opts?: {
+    tokenName?: string;
+    notify?: (key: EmporixStorageKey) => void;
+}): EmporixStorage;
+/**
+ * A synchronous cookie accessor supplied by the caller. Deliberately
+ * synchronous: {@link EmporixStorage} is synchronous throughout, so any
+ * `await` (e.g. Next's `await cookies()`) belongs to the caller.
+ *
+ * Omit `set` for a read-only storage. Next.js forbids cookie writes during a
+ * Server Component render — only Server Actions and Route Handlers may write.
+ */
+interface ServerCookieJar {
+    get(name: string): string | null;
+    /** `null` deletes the cookie. */
+    set?(name: string, value: string | null): void;
+}
+/**
+ * An {@link EmporixStorage} reading (and optionally writing) through a
+ * caller-supplied cookie jar — for RSC, Server Actions, Route Handlers, or any
+ * other server runtime. No framework import: the jar shape fits Next, Remix,
+ * SvelteKit, Nitro or a plain Node handler.
+ *
+ * `subscribe` / `subscribeAll` are absent: a server render has no lifetime over
+ * which to observe changes.
+ *
+ * ```ts
+ * // Next.js Server Component (read-only)
+ * const jar = await cookies();
+ * const storage = createServerStorage({ get: (n) => jar.get(n)?.value ?? null });
+ *
+ * // Next.js Server Action (read-write)
+ * const jar = await cookies();
+ * const storage = createServerStorage({
+ *   get: (n) => jar.get(n)?.value ?? null,
+ *   set: (n, v) =>
+ *     v === null
+ *       ? jar.delete(n)
+ *       : jar.set(n, v, { httpOnly: true, sameSite: "lax", secure: true, path: "/" }),
+ * });
+ * ```
+ */
+declare function createServerStorage(jar: ServerCookieJar): EmporixStorage;
+/**
+ * Resolves the {@link AuthContext} a server-side read should use, mirroring
+ * exactly what the React `useEmporixQuery` resolves on the client: the customer
+ * context when a token is stored, anonymous otherwise.
+ *
+ * Use this rather than hand-rolling it — `authKind` is part of every React-Query
+ * key, so a mismatch here produces a silent cache miss (a second fetch after
+ * hydration, no error).
+ */
+declare function serverAuth(storage: EmporixStorage): AuthContext;
+
 /**
  * Site address.
  */
@@ -1716,6 +1880,17 @@ type SchemaAttribute$1 = {
         [key: string]: unknown;
     };
     type: SchemaAttributeType;
+    /**
+     * Decimal precision for attributes of `DECIMAL` type. Defines the allowed decimal step for attribute values
+     * (for example `0.1`, `0.01`, `0.001`).
+     * Allowed values:
+     * * `-1` – no precision constraint
+     * * a positive decimal step of the form `0.1`, `0.01`, `0.001`, and so on (`10^-n` where `n >= 1`)
+     * This property can only be provided when `type` is `DECIMAL` (or, for arrays, when `arrayType.type` is `DECIMAL`).
+     * If omitted for a `DECIMAL` attribute, the default precision `0.01` is applied.
+     *
+     */
+    precision?: number;
     metadata: SchemaAttributeMetadata;
     /**
      * List of available values for the attribute. Only valid for `ENUM` and `REFERENCE` type.
@@ -10751,4 +10926,4 @@ declare function createEmporixClient<S extends Record<string, ServiceClass<unkno
  */
 declare function productIdFromYrn(yrn: string | undefined): string;
 
-export { type AddedPoints, type AdminCustomer, type AdminCustomerAddress, type AdminCustomerAddressInput, type AdminCustomerAddressList, type AdminCustomerAddressUpdate, type AdminCustomerCreated, type AdminCustomerInput, type AdminCustomerList, type AdminCustomerPatch, type AdminCustomerSearchQuery, type AdminCustomerUpdate, type Agent, type AgentAnalytics, type AgentExecutions, type AgentFromTemplate, type AgentInput, type AgentPatchOp, type AgentRequestLog, type AgentSearchQuery, type AgentSessionLog, type AgentTemplate, type AgenticPatchOp, type AgentsExport, type AgentsExportRequest, type AgentsImport, type AgentsImportRequest, AiService, type AnalyticsQuery, type Approval, type ApprovalCreated, type ApprovalInput, type ApprovalList, type ApprovalPatch, type ApprovalPermittedInput, type ApprovalPermittedResult, ApprovalService, type ApprovalUsersQuery, type ApprovalUsersResult, type Assignee, type Attachment, type AttachmentOptions, AuthContext, AvailabilityService, type BatchNextIdEntry, type Brand, type BrandInput, type BrandList, BrandService, type BrandUpdate, type BulkInstanceResult, type BulkPatchInstanceItem, CartService, type Catalog, type CatalogCreated, type CatalogInput, type CatalogList, type CatalogPatch, CatalogService, type CatalogUpdate, CategoryService, type CgRelation, type CgRelationList, type ChatRequest, type ChatResponse, type ChatStreamOptions, CheckoutService, ClientConfigService, type ClientConfiguration, ClientContext, CloudFunctionsService, type CommerceEvents, CompaniesService, type CompletionMessage, type CompletionRequest, type CompletionResponse, type Configuration$1 as Configuration, type ConfigurationDraft, ContactsService, type Conversation, type ConversationSearchQuery, type ConversionFactorInput, type ConversionFactorResult, type ConvertUnitInput, type ConvertUnitResult, type Country, type CountryList, CountryService, type CountryUpdate, type Coupon$1 as Coupon, type CouponCreated, type CouponInput, type CouponList, CouponService, type CouponUpdate, type Created, type Currency, type CurrencyCreated, type CurrencyInput, type CurrencyList, CurrencyService, type CurrencyUpdate, type CustomEntity, type CustomEntityDraft, type CustomInstance, type CustomInstanceDraft, CustomerAdminService, CustomerGroupsService, CustomerService, type CustomerSummaryBatch, CustomerTokenRefresher, type DeleteAgentOptions, type DeleteConfigOptions, type DeliveryCreated, type DeliveryCycleInput, type DeliverySlot, type DeliverySlotList, type DeliveryTime$1 as DeliveryTime, type DeliveryTimeInput, type DeliveryTimeList, type DeliveryTimeUpdate, type DeliveryWindow$2 as DeliveryWindow, type DeliveryWindowList, type DeliveryWindowValidation, EmporixAuthError, EmporixClient, EmporixConfig, type EmporixCore, EmporixError, EmporixForbiddenError, EmporixInsufficientScopeError, EmporixNetworkError, EmporixNotFoundError, EmporixServerError, EmporixTimeoutError, EmporixValidationError, type ExchangeRate, type ExchangeRateCreated, type ExchangeRateInput, type ExchangeRateList, type ExchangeRateUpdate, type ExecutionsQuery, type Fee$1 as Fee, type FeeDraft, FeeService, type FindSiteInput, type GetOptions, type IamAccessControl, type IamAccessControlCreated, type IamAccessControlUpsert, type IamGroup, type IamGroupCreate, type IamGroupCreated, AssignmentCreateRequest as IamGroupMemberAssignment, type IamGroupMemberCreated, type IamGroupMemberInput, type IamGroupUpdate, type IamScope, type IamScopeCreated, type IamScopeUpsert, IamService, type IamUser, type IamUserCreate, type IamUserCreated, type IamUserDetail, type IamUserScopes, type IamUserUpdate, type ImportCancelResult, type ImportConfig, type ImportErrorRecord, type ImportPage, type ImportPageOptions, type ImportRecordOutcome, type ImportRun, type ImportRunDetail, type ImportRunEvent, type ImportRunInput, type ImportRunMode, type ImportRunStatus, type ImportRunStream, type ImportSchedule, ImportService, type ImportStream, type ImportedRecord, type IndexConfig, type IndexConfigCreated, type IndexPublicConfig, IndexingService, type InstanceSearchBody, type InvoiceJob, type InvoiceJobCreated, type InvoiceJobDraft, InvoiceService, type InvokeCloudFunctionOptions, type ItemFee, type ItemFeeDraft, type ItemFeeSearch, type ItemFeeSearchByProductId, type ItemFeeSearchByProductIds, type Job, type JobIdResponse, type Label, type LabelInput, type LabelList, LabelService, type LabelUpdate, type ListConfigOptions, type ListCustomEntitiesOptions, type ListFeesQuery, type ListInstancesQuery, type ListQuery, type ListQuoteReasonsQuery, type ListQuotesQuery, type ListReindexJobsOptions, type ListSchemaReferencesQuery, type ListSchemasQuery, LocationsService, LogLevel, type McpServer, type McpServerInput, MediaService, type MetadataFilter, type MinimumFee, type MutateOptions, type NewPointsEntry, type NextIdCommandRequest, type NextIdOptions, type NextIdResponse, type NextIdsBatchRequest, type NextIdsBatchResponse, type OAuthConfig, type OAuthInput, type OrderCycleList, type OrderEntryEventCreate, type OrderStatusChange, OrdersService, type PackagingProductsChange, type PackingEvent, type PackingEventList, PaginatedItems, PaymentGatewayService, type PickOrder, type PickOrderList, type PickPackAck, PickPackService, type PointsSummary, PriceService, ProductService, type ProviderModels, QueryFor, type Quote, type QuoteCreated, type QuoteDraft, type QuoteHistory, type QuoteInput, type QuoteReason, type QuoteReasonCreated, type QuoteReasonDraft, type QuoteReasonUpdate, type QuoteResult, QuoteService, type QuoteSlotInput, type QuoteUpdate, RagIndexerService, type RagType, type RecalculationJob, type RecalculationJobCreated, type RecalculationJobInput, type RedeemCouponResult, type RedeemMyPointsInput, type RedeemOption, type RedeemOptionList, type RedeemedPoints, type Redemption, type RedemptionCreated, type RedemptionInput, type ReferralCoupon, type Region, type RegionList, type ReindexEntityType, type ReindexInput, type ReindexJob, type ReindexJobInput, type ReindexJobStatus, ResolvedConfig, type ResourceCreated, type Return, type ReturnCreated, type ReturnInput, type ReturnList, type ReturnPatch, type ReturnUpdate, ReturnsService, RewardPointsService, SalesOrdersService, type Schema, type SchemaAttribute, type SchemaDraft, type SchemaExport, type SchemaImportInput, type SchemaInstanceBulkCreateItem, type SchemaInstanceBulkUpsertItem, type SchemaReference, type SchemaReferenceCreated, type SchemaReferenceInput, type SchemaReferenceUpdateInput, SchemaService, type SchemaTypeName, type SchemaUpdate, type SearchImportedRecordsOptions, type SearchQuery, type SearchStreamRecordsOptions, SegmentService, SepaExportService, type SepaJob, type SepaJobCreated, type SepaJobInput, type SequenceSchema, type SequenceSchemaCreate, SequentialIdService, type ServiceClass, ServiceName, type SessionAttributeInput, type SessionContext, type SessionContextPatch, SessionContextService, type SetItemFeesOptions, type ShippingFee, type ShippingGroup, type ShippingGroupList, type ShippingMethod, type ShippingMethodList, type ShippingPatch, ShippingService, type ShoppingList, type ShoppingListDraft, type ShoppingListItem, ShoppingListService, type Site$1 as Site, type SiteCreated, type SiteInput, type SiteList, type SiteMixin, type SiteMixinCreated, type SiteMixins, SiteService, type TaxCalculationInput, type TaxCalculationRequest, type TaxCalculationResult, type TaxClass, type TaxConfig, type TaxConfigCreated, type TaxCreation as TaxConfigInput, type TaxUpdate as TaxConfigUpdate, type TaxLocation, TaxService, TenantConfigService, type TextRequest, type TextResponse, type Token, type TokenInput, TokenProvider, type Tool, type ToolInput, type Unit, type UnitCreated, UnitHandlingService, type UnitInput, type UnitUpdate, type Vendor, type VendorCreated, type VendorInput, type VendorList, type VendorLocation, type VendorLocationInput, type VendorLocationList, type VendorLocationUpdate, type VendorSearchQuery, VendorService, type VendorUpdate, type WebhookConfig, type WebhookConfigCreated, type WebhookConfigDraft, type WebhookConfigPatch, type WebhookDashboardAccess, WebhookService, type WebhookStatistics, type WebhookStatisticsQuery, type WebhookSubscription, type WebhookSubscriptionUpdateItem, type WebhookSubscriptionUpdateResultItem, type Zone, type ZoneList, createCore, createEmporixClient, errorFromResponse, pickFee, productIdFromYrn, resolveZone };
+export { type AddedPoints, type AdminCustomer, type AdminCustomerAddress, type AdminCustomerAddressInput, type AdminCustomerAddressList, type AdminCustomerAddressUpdate, type AdminCustomerCreated, type AdminCustomerInput, type AdminCustomerList, type AdminCustomerPatch, type AdminCustomerSearchQuery, type AdminCustomerUpdate, type Agent, type AgentAnalytics, type AgentExecutions, type AgentFromTemplate, type AgentInput, type AgentPatchOp, type AgentRequestLog, type AgentSearchQuery, type AgentSessionLog, type AgentTemplate, type AgenticPatchOp, type AgentsExport, type AgentsExportRequest, type AgentsImport, type AgentsImportRequest, AiService, type AnalyticsQuery, type Approval, type ApprovalCreated, type ApprovalInput, type ApprovalList, type ApprovalPatch, type ApprovalPermittedInput, type ApprovalPermittedResult, ApprovalService, type ApprovalUsersQuery, type ApprovalUsersResult, type Assignee, type Attachment, type AttachmentOptions, AuthContext, AvailabilityService, type BatchNextIdEntry, type Brand, type BrandInput, type BrandList, BrandService, type BrandUpdate, type BulkInstanceResult, type BulkPatchInstanceItem, CartService, type Catalog, type CatalogCreated, type CatalogInput, type CatalogList, type CatalogPatch, CatalogService, type CatalogUpdate, CategoryService, type CgRelation, type CgRelationList, type ChatRequest, type ChatResponse, type ChatStreamOptions, CheckoutService, ClientConfigService, type ClientConfiguration, ClientContext, CloudFunctionsService, type CommerceEvents, CompaniesService, type CompletionMessage, type CompletionRequest, type CompletionResponse, type Configuration$1 as Configuration, type ConfigurationDraft, ContactsService, type Conversation, type ConversationSearchQuery, type ConversionFactorInput, type ConversionFactorResult, type ConvertUnitInput, type ConvertUnitResult, type CookieIo, type Country, type CountryList, CountryService, type CountryUpdate, type Coupon$1 as Coupon, type CouponCreated, type CouponInput, type CouponList, CouponService, type CouponUpdate, type Created, type Currency, type CurrencyCreated, type CurrencyInput, type CurrencyList, CurrencyService, type CurrencyUpdate, type CustomEntity, type CustomEntityDraft, type CustomInstance, type CustomInstanceDraft, CustomerAdminService, CustomerGroupsService, CustomerService, type CustomerSummaryBatch, CustomerTokenRefresher, type DeleteAgentOptions, type DeleteConfigOptions, type DeliveryCreated, type DeliveryCycleInput, type DeliverySlot, type DeliverySlotList, type DeliveryTime$1 as DeliveryTime, type DeliveryTimeInput, type DeliveryTimeList, type DeliveryTimeUpdate, type DeliveryWindow$2 as DeliveryWindow, type DeliveryWindowList, type DeliveryWindowValidation, EmporixAuthError, EmporixClient, EmporixConfig, type EmporixCore, EmporixError, EmporixForbiddenError, EmporixInsufficientScopeError, EmporixNetworkError, EmporixNotFoundError, EmporixServerError, type EmporixStorage, type EmporixStorageKey, EmporixTimeoutError, EmporixValidationError, type ExchangeRate, type ExchangeRateCreated, type ExchangeRateInput, type ExchangeRateList, type ExchangeRateUpdate, type ExecutionsQuery, type Fee$1 as Fee, type FeeDraft, FeeService, type FindSiteInput, type GetOptions, type IamAccessControl, type IamAccessControlCreated, type IamAccessControlUpsert, type IamGroup, type IamGroupCreate, type IamGroupCreated, AssignmentCreateRequest as IamGroupMemberAssignment, type IamGroupMemberCreated, type IamGroupMemberInput, type IamGroupUpdate, type IamScope, type IamScopeCreated, type IamScopeUpsert, IamService, type IamUser, type IamUserCreate, type IamUserCreated, type IamUserDetail, type IamUserScopes, type IamUserUpdate, type ImportCancelResult, type ImportConfig, type ImportErrorRecord, type ImportPage, type ImportPageOptions, type ImportRecordOutcome, type ImportRun, type ImportRunDetail, type ImportRunEvent, type ImportRunInput, type ImportRunMode, type ImportRunStatus, type ImportRunStream, type ImportSchedule, ImportService, type ImportStream, type ImportedRecord, type IndexConfig, type IndexConfigCreated, type IndexPublicConfig, IndexingService, type InstanceSearchBody, type InvoiceJob, type InvoiceJobCreated, type InvoiceJobDraft, InvoiceService, type InvokeCloudFunctionOptions, type ItemFee, type ItemFeeDraft, type ItemFeeSearch, type ItemFeeSearchByProductId, type ItemFeeSearchByProductIds, type Job, type JobIdResponse, type Label, type LabelInput, type LabelList, LabelService, type LabelUpdate, type ListConfigOptions, type ListCustomEntitiesOptions, type ListFeesQuery, type ListInstancesQuery, type ListQuery, type ListQuoteReasonsQuery, type ListQuotesQuery, type ListReindexJobsOptions, type ListSchemaReferencesQuery, type ListSchemasQuery, LocationsService, LogLevel, type McpServer, type McpServerInput, MediaService, type MetadataFilter, type MinimumFee, type MutateOptions, type NewPointsEntry, type NextIdCommandRequest, type NextIdOptions, type NextIdResponse, type NextIdsBatchRequest, type NextIdsBatchResponse, type OAuthConfig, type OAuthInput, type OrderCycleList, type OrderEntryEventCreate, type OrderStatusChange, OrdersService, type PackagingProductsChange, type PackingEvent, type PackingEventList, PaginatedItems, PaymentGatewayService, type PersistedAnonymousSession, type PickOrder, type PickOrderList, type PickPackAck, PickPackService, type PointsSummary, PriceService, ProductService, type ProviderModels, QueryFor, type Quote, type QuoteCreated, type QuoteDraft, type QuoteHistory, type QuoteInput, type QuoteReason, type QuoteReasonCreated, type QuoteReasonDraft, type QuoteReasonUpdate, type QuoteResult, QuoteService, type QuoteSlotInput, type QuoteUpdate, RagIndexerService, type RagType, type RecalculationJob, type RecalculationJobCreated, type RecalculationJobInput, type RedeemCouponResult, type RedeemMyPointsInput, type RedeemOption, type RedeemOptionList, type RedeemedPoints, type Redemption, type RedemptionCreated, type RedemptionInput, type ReferralCoupon, type Region, type RegionList, type ReindexEntityType, type ReindexInput, type ReindexJob, type ReindexJobInput, type ReindexJobStatus, ResolvedConfig, type ResourceCreated, type Return, type ReturnCreated, type ReturnInput, type ReturnList, type ReturnPatch, type ReturnUpdate, ReturnsService, RewardPointsService, STORAGE_KEYS, SalesOrdersService, type Schema, type SchemaAttribute, type SchemaDraft, type SchemaExport, type SchemaImportInput, type SchemaInstanceBulkCreateItem, type SchemaInstanceBulkUpsertItem, type SchemaReference, type SchemaReferenceCreated, type SchemaReferenceInput, type SchemaReferenceUpdateInput, SchemaService, type SchemaTypeName, type SchemaUpdate, type SearchImportedRecordsOptions, type SearchQuery, type SearchStreamRecordsOptions, SegmentService, SepaExportService, type SepaJob, type SepaJobCreated, type SepaJobInput, type SequenceSchema, type SequenceSchemaCreate, SequentialIdService, type ServerCookieJar, type ServiceClass, ServiceName, type SessionAttributeInput, type SessionContext, type SessionContextPatch, SessionContextService, type SetItemFeesOptions, type ShippingFee, type ShippingGroup, type ShippingGroupList, type ShippingMethod, type ShippingMethodList, type ShippingPatch, ShippingService, type ShoppingList, type ShoppingListDraft, type ShoppingListItem, ShoppingListService, type Site$1 as Site, type SiteCreated, type SiteInput, type SiteList, type SiteMixin, type SiteMixinCreated, type SiteMixins, SiteService, StoredAnonymousSession, type TaxCalculationInput, type TaxCalculationRequest, type TaxCalculationResult, type TaxClass, type TaxConfig, type TaxConfigCreated, type TaxCreation as TaxConfigInput, type TaxUpdate as TaxConfigUpdate, type TaxLocation, TaxService, TenantConfigService, type TextRequest, type TextResponse, type Token, type TokenInput, TokenProvider, type TokenStorage, type Tool, type ToolInput, type Unit, type UnitCreated, UnitHandlingService, type UnitInput, type UnitUpdate, type Vendor, type VendorCreated, type VendorInput, type VendorList, type VendorLocation, type VendorLocationInput, type VendorLocationList, type VendorLocationUpdate, type VendorSearchQuery, VendorService, type VendorUpdate, type WebhookConfig, type WebhookConfigCreated, type WebhookConfigDraft, type WebhookConfigPatch, type WebhookDashboardAccess, WebhookService, type WebhookStatistics, type WebhookStatisticsQuery, type WebhookSubscription, type WebhookSubscriptionUpdateItem, type WebhookSubscriptionUpdateResultItem, type Zone, type ZoneList, createCookieBackedStorage, createCore, createEmporixClient, createServerStorage, errorFromResponse, parseAnonymousSession, pickFee, productIdFromYrn, resolveZone, serverAuth };

package/dist/index.js

@@ -4,8 +4,8 @@ import { MediaService } from './chunk-OTG2S2L4.js';
 export { MediaService } from './chunk-OTG2S2L4.js';
 import { OrdersService, SalesOrdersService } from './chunk-P7G4LOOV.js';
 export { OrdersService, SalesOrdersService } from './chunk-P7G4LOOV.js';
-import { auth, resolveToken, DefaultTokenProvider, CustomerRefreshRegistry, PaymentGatewayService } from './chunk-6PJFOX3A.js';
-export { CustomerRefreshRegistry, DefaultTokenProvider, PaymentGatewayService, auth, resolveToken } from './chunk-6PJFOX3A.js';
+import { auth, resolveToken, DefaultTokenProvider, CustomerRefreshRegistry, PaymentGatewayService } from './chunk-4VRUMCS2.js';
+export { CustomerRefreshRegistry, DefaultTokenProvider, PaymentGatewayService, auth, resolveToken } from './chunk-4VRUMCS2.js';
 import { PriceService } from './chunk-ZOFGDNSX.js';
 export { PriceService } from './chunk-ZOFGDNSX.js';
 import { ProductService } from './chunk-7W22KLUL.js';
@@ -297,6 +297,78 @@ function createNoopLogger() {
   return new NoopLogger();
 }
 
+// src/core/session-keys.ts
+var STORAGE_KEYS = {
+  customerToken: "emporix.customerToken",
+  cartId: "emporix.cartId",
+  anonymousSession: "emporix.anonymousSession",
+  siteCode: "emporix.siteCode",
+  language: "emporix.language",
+  activeLegalEntityId: "emporix.activeLegalEntityId",
+  refreshToken: "emporix.refreshToken",
+  saasToken: "emporix.saasToken"
+};
+
+// src/core/session-storage.ts
+function parseAnonymousSession(raw) {
+  if (raw === null) return null;
+  try {
+    const parsed = JSON.parse(raw);
+    return typeof parsed.refreshToken === "string" && typeof parsed.sessionId === "string" ? { refreshToken: parsed.refreshToken, sessionId: parsed.sessionId } : null;
+  } catch {
+    return null;
+  }
+}
+function createCookieBackedStorage(io, opts = {}) {
+  const tokenName = opts.tokenName ?? STORAGE_KEYS.customerToken;
+  const notify = opts.notify;
+  const warned = /* @__PURE__ */ new Set();
+  const write = (name, value, key) => {
+    if (io.set === void 0) {
+      if (!warned.has(key)) {
+        warned.add(key);
+        console.warn(
+          `[emporix] storage is read-only; ignoring write to "${key}". Provide a \`set\` accessor to enable writes (e.g. from a Server Action).`
+        );
+      }
+      return;
+    }
+    io.set(name, value);
+    notify?.(key);
+  };
+  return {
+    getCustomerToken: () => io.get(tokenName),
+    setCustomerToken: (t) => write(tokenName, t, "customerToken"),
+    getCartId: () => io.get(STORAGE_KEYS.cartId),
+    setCartId: (id) => write(STORAGE_KEYS.cartId, id, "cartId"),
+    getAnonymousSession: () => parseAnonymousSession(io.get(STORAGE_KEYS.anonymousSession)),
+    setAnonymousSession: (s) => write(
+      STORAGE_KEYS.anonymousSession,
+      s === null ? null : JSON.stringify({ refreshToken: s.refreshToken, sessionId: s.sessionId }),
+      "anonymousSession"
+    ),
+    getSiteCode: () => io.get(STORAGE_KEYS.siteCode),
+    setSiteCode: (code) => write(STORAGE_KEYS.siteCode, code, "siteCode"),
+    getLanguage: () => io.get(STORAGE_KEYS.language),
+    setLanguage: (l) => write(STORAGE_KEYS.language, l, "language"),
+    getActiveLegalEntityId: () => io.get(STORAGE_KEYS.activeLegalEntityId),
+    setActiveLegalEntityId: (id) => write(STORAGE_KEYS.activeLegalEntityId, id, "activeLegalEntityId"),
+    getRefreshToken: () => io.get(STORAGE_KEYS.refreshToken),
+    setRefreshToken: (t) => write(STORAGE_KEYS.refreshToken, t, "refreshToken"),
+    getSaasToken: () => io.get(STORAGE_KEYS.saasToken),
+    setSaasToken: (t) => write(STORAGE_KEYS.saasToken, t, "saasToken")
+  };
+}
+function createServerStorage(jar) {
+  return createCookieBackedStorage(
+    jar.set !== void 0 ? { get: jar.get, set: jar.set } : { get: jar.get }
+  );
+}
+function serverAuth(storage) {
+  const token = storage.getCustomerToken();
+  return token !== null ? auth.customer(token) : auth.anonymous();
+}
+
 // src/core/sse.ts
 function parseFrame(frame) {
   const ev = { data: "" };
@@ -595,7 +667,7 @@ var HttpClient = class {
 };
 
 // package.json
-var version = "2.29.0";
+var version = "2.31.0";
 
 // src/version.ts
 var SDK_VERSION = version;
@@ -4791,6 +4863,6 @@ function productIdFromYrn(yrn) {
   return semi >= 0 ? yrn.slice(semi + 1) : "";
 }
 
-export { AiService, ApprovalService, BrandService, CatalogService, ClientConfigService, CloudFunctionsService, CountryService, CouponService, CurrencyService, CustomerAdminService, DEFAULT_HOST, EmporixClient, FeeService, HttpClient, ImportService, IndexingService, InvoiceService, LEVEL, LabelService, LevelResolver, PickPackService, QuoteService, RagIndexerService, ReturnsService, RewardPointsService, SchemaService, SepaExportService, SequentialIdService, SessionContextService, ShippingService, ShoppingListService, SiteService, TaxService, TenantConfigService, UnitHandlingService, VendorService, WebhookService, createConsoleLogger, createCore, createEmporixClient, createNoopLogger, pickFee, productIdFromYrn, redact, resolveZone, validateConfig };
+export { AiService, ApprovalService, BrandService, CatalogService, ClientConfigService, CloudFunctionsService, CountryService, CouponService, CurrencyService, CustomerAdminService, DEFAULT_HOST, EmporixClient, FeeService, HttpClient, ImportService, IndexingService, InvoiceService, LEVEL, LabelService, LevelResolver, PickPackService, QuoteService, RagIndexerService, ReturnsService, RewardPointsService, STORAGE_KEYS, SchemaService, SepaExportService, SequentialIdService, SessionContextService, ShippingService, ShoppingListService, SiteService, TaxService, TenantConfigService, UnitHandlingService, VendorService, WebhookService, createConsoleLogger, createCookieBackedStorage, createCore, createEmporixClient, createNoopLogger, createServerStorage, parseAnonymousSession, pickFee, productIdFromYrn, redact, resolveZone, serverAuth, validateConfig };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map