@viu/emporix-sdk-react 1.0.0

package/dist/index.js

@@ -0,0 +1,30 @@
+export { useActiveCart, useAddressMutations, useAssignContact, useCancelOrder, useCart, useCartMutations, useCategories, useCategoriesInfinite, useCategory, useCategoryTree, useChangePassword, useCheckout, useCompany, useCompanyContacts, useCompanyGroups, useCompanyLocations, useCompanySwitcher, useCreateCart, useCreateCompany, useCreateLocation, useCustomerAddresses, useCustomerSession, useDefaultSite, useDeleteCompany, useDeleteLocation, useMatchPrices, useMyCompanies, useMyOrders, useMyOrdersInfinite, useMySegmentCategories, useMySegmentCategoriesInfinite, useMySegmentCategoryTree, useMySegmentItems, useMySegmentProducts, useMySegmentProductsInfinite, useMySegments, useOrder, useOrderTransition, usePasswordReset, usePaymentModes, useProduct, useProductByCode, useProductMedia, useProductSearch, useProducts, useProductsInCategory, useProductsInCategoryInfinite, useProductsInfinite, useReorder, useSalesOrder, useSiteContext, useSites, useUnassignContact, useUpdateCompany, useUpdateContactAssignment, useUpdateCustomer, useUpdateLocation, useUpdateSalesOrder } from './chunk-N3VDSKCT.js';
+export { CompanyContextProvider, EmporixCompanyContext, EmporixProvider, useActiveCompany, useEmporix, useEmporixTelemetry } from './chunk-D43CSHK3.js';
+export { createCookieStorage, createLocalStorageStorage, createMemoryStorage } from './chunk-FBQY2N7S.js';
+export { prefetchCart, prefetchOrder, prefetchProduct } from './chunk-TIS4BKHK.js';
+import { Component } from 'react';
+import { EmporixAuthError, EmporixError } from '@viu/emporix-sdk';
+
+var EmporixErrorBoundary = class extends Component {
+  state = { error: null };
+  static getDerivedStateFromError(error) {
+    return { error };
+  }
+  componentDidCatch(error, info) {
+    this.props.onError?.(error, info);
+  }
+  render() {
+    if (this.state.error) return this.props.fallback;
+    return this.props.children;
+  }
+};
+function useEmporixErrorHandler(handlers) {
+  return (error) => {
+    if (error instanceof EmporixAuthError) handlers.onAuthError?.(error);
+    else if (error instanceof EmporixError) handlers.onError?.(error);
+  };
+}
+
+export { EmporixErrorBoundary, useEmporixErrorHandler };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.tsx"],"names":[],"mappings":";;;;;;;AAaO,IAAM,oBAAA,GAAN,cAAmC,SAAA,CAAwB;AAAA,EAChE,KAAA,GAAe,EAAE,KAAA,EAAO,IAAA,EAAK;AAAA,EAE7B,OAAO,yBAAyB,KAAA,EAAqB;AACnD,IAAA,OAAO,EAAE,KAAA,EAAM;AAAA,EACjB;AAAA,EAEA,iBAAA,CAAkB,OAAc,IAAA,EAAuB;AACrD,IAAA,IAAA,CAAK,KAAA,CAAM,OAAA,GAAU,KAAA,EAAO,IAAI,CAAA;AAAA,EAClC;AAAA,EAEA,MAAA,GAAoB;AAClB,IAAA,IAAI,IAAA,CAAK,KAAA,CAAM,KAAA,EAAO,OAAO,KAAK,KAAA,CAAM,QAAA;AACxC,IAAA,OAAO,KAAK,KAAA,CAAM,QAAA;AAAA,EACpB;AACF;AAGO,SAAS,uBAAuB,QAAA,EAGV;AAC3B,EAAA,OAAO,CAAC,KAAA,KAAmB;AACzB,IAAA,IAAI,KAAA,YAAiB,gBAAA,EAAkB,QAAA,CAAS,WAAA,GAAc,KAAK,CAAA;AAAA,SAAA,IAC1D,KAAA,YAAiB,YAAA,EAAc,QAAA,CAAS,OAAA,GAAU,KAAK,CAAA;AAAA,EAClE,CAAA;AACF","file":"index.js","sourcesContent":["import { Component, type ErrorInfo, type ReactNode } from \"react\";\nimport { EmporixError, EmporixAuthError } from \"@viu/emporix-sdk\";\n\ninterface Props {\n  children: ReactNode;\n  fallback: ReactNode;\n  onError?: (error: Error, info: ErrorInfo) => void;\n}\ninterface State {\n  error: Error | null;\n}\n\n/** Catches render errors (including thrown {@link EmporixError}) and shows a fallback. */\nexport class EmporixErrorBoundary extends Component<Props, State> {\n  state: State = { error: null };\n\n  static getDerivedStateFromError(error: Error): State {\n    return { error };\n  }\n\n  componentDidCatch(error: Error, info: ErrorInfo): void {\n    this.props.onError?.(error, info);\n  }\n\n  render(): ReactNode {\n    if (this.state.error) return this.props.fallback;\n    return this.props.children;\n  }\n}\n\n/** Returns a handler that runs `onAuthError` for {@link EmporixAuthError}, else `onError`. */\nexport function useEmporixErrorHandler(handlers: {\n  onAuthError?: (e: EmporixAuthError) => void;\n  onError?: (e: EmporixError) => void;\n}): (error: unknown) => void {\n  return (error: unknown) => {\n    if (error instanceof EmporixAuthError) handlers.onAuthError?.(error);\n    else if (error instanceof EmporixError) handlers.onError?.(error);\n  };\n}\n"]}

package/dist/provider-BhvQWnnh.d.cts

@@ -0,0 +1,133 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { QueryClient } from '@tanstack/react-query';
+import { EmporixClient } from '@viu/emporix-sdk';
+import { EmporixStorage } from './storage.cjs';
+
+/**
+ * All telemetry events emitted through the EmporixProvider's `onTelemetry`
+ * callback. Discriminated by `type` — exhaustive switch is type-safe.
+ *
+ * Consumers can emit their own `{ type: "custom" }` events via
+ * {@link useEmporixTelemetry}. Namespace `name` with an app-specific
+ * prefix (e.g. `"app.checkout-cta-click"`) to avoid collisions with
+ * future SDK event types.
+ */
+type EmporixTelemetryEvent = {
+    type: "cache.hit";
+    queryKey: readonly unknown[];
+    tenant: string;
+} | {
+    type: "cache.miss";
+    queryKey: readonly unknown[];
+    tenant: string;
+    durationMs: number;
+} | {
+    type: "query.refetch";
+    queryKey: readonly unknown[];
+    tenant: string;
+    reason: "invalidate" | "focus" | "stale";
+} | {
+    type: "query.error";
+    queryKey: readonly unknown[];
+    tenant: string;
+    error: unknown;
+} | {
+    type: "mutation.success";
+    mutationKey?: readonly unknown[];
+    tenant: string;
+    durationMs: number;
+} | {
+    type: "mutation.error";
+    mutationKey?: readonly unknown[];
+    tenant: string;
+    error: unknown;
+    durationMs: number;
+} | {
+    type: "auth.refresh";
+    kind: "anonymous" | "customer";
+    tenant: string;
+    success: boolean;
+} | {
+    type: "storage.write";
+    key: "customerToken" | "cartId" | "siteCode" | "anonymousSession" | "activeLegalEntityId" | "refreshToken";
+} | {
+    type: "company:switched";
+    from: string | null;
+    to: string | null;
+    durationMs: number;
+} | {
+    type: "custom";
+    name: string;
+    props?: Record<string, unknown>;
+};
+/**
+ * Hook to emit custom telemetry events through the same channel as SDK
+ * events. Throws when used outside an {@link EmporixProvider}.
+ *
+ * When the provider has no `onTelemetry` callback configured, `emit` is a
+ * no-op — calling it is safe and incurs no overhead.
+ */
+declare function useEmporixTelemetry(): {
+    emit: (event: EmporixTelemetryEvent) => void;
+};
+
+interface EmporixContextValue {
+    client: EmporixClient;
+    storage: EmporixStorage;
+}
+interface SiteContextValue {
+    siteCode: string | null;
+    /** MS-4 populates this from the active site's DTO. */
+    currency: string | null;
+    /** MS-4 populates this from the active site's DTO. */
+    targetLocation: string | null;
+    /**
+     * Asynchronous site switch. Updates local state + storage immediately
+     * (optimistic), then PATCHes `/session-context/{tenant}/me/context` so
+     * the server sees the same site on the next request. When no session
+     * context exists yet (first visit, before any cart), the PATCH is
+     * skipped — local state still flips.
+     *
+     * `isSwitching` is `true` while the PATCH is in flight. `switchError`
+     * surfaces a PATCH failure; the optimistic state is NOT rolled back
+     * (the cache was already invalidated, the UI already moved on).
+     */
+    setSite: (code: string | null) => Promise<void>;
+    isSwitching: boolean;
+    switchError: Error | null;
+}
+declare const EmporixSiteContext: react.Context<SiteContextValue | null>;
+/** Props for {@link EmporixProvider}. */
+interface EmporixProviderProps {
+    client: EmporixClient;
+    queryClient?: QueryClient;
+    storage?: EmporixStorage;
+    initialCustomerToken?: string;
+    /**
+     * Initial site code. Resolution order: this prop → `storage.getSiteCode()` →
+     * `client.config.credentials.storefront.context.siteCode` → `null`.
+     */
+    initialSiteCode?: string;
+    /**
+     * Initial active legal-entity id (B2B). When set, the CompanyContext
+     * provider tries to match it against `companies.listMine()` once the
+     * customer is loaded; mismatches are dropped silently.
+     */
+    initialActiveLegalEntityId?: string | null;
+    /**
+     * Opt-in telemetry callback. Receives a typed event stream covering cache
+     * hit/miss, refetches, errors, mutations, auth refreshes, storage writes,
+     * and consumer-emitted custom events. Wire this to Datadog/Sentry/custom
+     * analytics. The handler is wrapped in try/catch — a throwing handler
+     * never breaks the provider.
+     */
+    onTelemetry?: (event: EmporixTelemetryEvent) => void;
+    children: ReactNode;
+}
+/** Provides the SDK client, token storage, react-query client, and site context to the tree. */
+declare function EmporixProvider({ client, queryClient, storage, initialCustomerToken, initialSiteCode, initialActiveLegalEntityId, onTelemetry, children, }: EmporixProviderProps): React.JSX.Element;
+/** Returns the SDK client and token storage. Throws outside an {@link EmporixProvider}. */
+declare function useEmporix(): EmporixContextValue;
+
+export { EmporixProvider as E, type SiteContextValue as S, type EmporixProviderProps as a, EmporixSiteContext as b, type EmporixTelemetryEvent as c, useEmporixTelemetry as d, useEmporix as u };

package/dist/provider-fvcYdqqX.d.ts

@@ -0,0 +1,133 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { QueryClient } from '@tanstack/react-query';
+import { EmporixClient } from '@viu/emporix-sdk';
+import { EmporixStorage } from './storage.js';
+
+/**
+ * All telemetry events emitted through the EmporixProvider's `onTelemetry`
+ * callback. Discriminated by `type` — exhaustive switch is type-safe.
+ *
+ * Consumers can emit their own `{ type: "custom" }` events via
+ * {@link useEmporixTelemetry}. Namespace `name` with an app-specific
+ * prefix (e.g. `"app.checkout-cta-click"`) to avoid collisions with
+ * future SDK event types.
+ */
+type EmporixTelemetryEvent = {
+    type: "cache.hit";
+    queryKey: readonly unknown[];
+    tenant: string;
+} | {
+    type: "cache.miss";
+    queryKey: readonly unknown[];
+    tenant: string;
+    durationMs: number;
+} | {
+    type: "query.refetch";
+    queryKey: readonly unknown[];
+    tenant: string;
+    reason: "invalidate" | "focus" | "stale";
+} | {
+    type: "query.error";
+    queryKey: readonly unknown[];
+    tenant: string;
+    error: unknown;
+} | {
+    type: "mutation.success";
+    mutationKey?: readonly unknown[];
+    tenant: string;
+    durationMs: number;
+} | {
+    type: "mutation.error";
+    mutationKey?: readonly unknown[];
+    tenant: string;
+    error: unknown;
+    durationMs: number;
+} | {
+    type: "auth.refresh";
+    kind: "anonymous" | "customer";
+    tenant: string;
+    success: boolean;
+} | {
+    type: "storage.write";
+    key: "customerToken" | "cartId" | "siteCode" | "anonymousSession" | "activeLegalEntityId" | "refreshToken";
+} | {
+    type: "company:switched";
+    from: string | null;
+    to: string | null;
+    durationMs: number;
+} | {
+    type: "custom";
+    name: string;
+    props?: Record<string, unknown>;
+};
+/**
+ * Hook to emit custom telemetry events through the same channel as SDK
+ * events. Throws when used outside an {@link EmporixProvider}.
+ *
+ * When the provider has no `onTelemetry` callback configured, `emit` is a
+ * no-op — calling it is safe and incurs no overhead.
+ */
+declare function useEmporixTelemetry(): {
+    emit: (event: EmporixTelemetryEvent) => void;
+};
+
+interface EmporixContextValue {
+    client: EmporixClient;
+    storage: EmporixStorage;
+}
+interface SiteContextValue {
+    siteCode: string | null;
+    /** MS-4 populates this from the active site's DTO. */
+    currency: string | null;
+    /** MS-4 populates this from the active site's DTO. */
+    targetLocation: string | null;
+    /**
+     * Asynchronous site switch. Updates local state + storage immediately
+     * (optimistic), then PATCHes `/session-context/{tenant}/me/context` so
+     * the server sees the same site on the next request. When no session
+     * context exists yet (first visit, before any cart), the PATCH is
+     * skipped — local state still flips.
+     *
+     * `isSwitching` is `true` while the PATCH is in flight. `switchError`
+     * surfaces a PATCH failure; the optimistic state is NOT rolled back
+     * (the cache was already invalidated, the UI already moved on).
+     */
+    setSite: (code: string | null) => Promise<void>;
+    isSwitching: boolean;
+    switchError: Error | null;
+}
+declare const EmporixSiteContext: react.Context<SiteContextValue | null>;
+/** Props for {@link EmporixProvider}. */
+interface EmporixProviderProps {
+    client: EmporixClient;
+    queryClient?: QueryClient;
+    storage?: EmporixStorage;
+    initialCustomerToken?: string;
+    /**
+     * Initial site code. Resolution order: this prop → `storage.getSiteCode()` →
+     * `client.config.credentials.storefront.context.siteCode` → `null`.
+     */
+    initialSiteCode?: string;
+    /**
+     * Initial active legal-entity id (B2B). When set, the CompanyContext
+     * provider tries to match it against `companies.listMine()` once the
+     * customer is loaded; mismatches are dropped silently.
+     */
+    initialActiveLegalEntityId?: string | null;
+    /**
+     * Opt-in telemetry callback. Receives a typed event stream covering cache
+     * hit/miss, refetches, errors, mutations, auth refreshes, storage writes,
+     * and consumer-emitted custom events. Wire this to Datadog/Sentry/custom
+     * analytics. The handler is wrapped in try/catch — a throwing handler
+     * never breaks the provider.
+     */
+    onTelemetry?: (event: EmporixTelemetryEvent) => void;
+    children: ReactNode;
+}
+/** Provides the SDK client, token storage, react-query client, and site context to the tree. */
+declare function EmporixProvider({ client, queryClient, storage, initialCustomerToken, initialSiteCode, initialActiveLegalEntityId, onTelemetry, children, }: EmporixProviderProps): React.JSX.Element;
+/** Returns the SDK client and token storage. Throws outside an {@link EmporixProvider}. */
+declare function useEmporix(): EmporixContextValue;
+
+export { EmporixProvider as E, type SiteContextValue as S, type EmporixProviderProps as a, EmporixSiteContext as b, type EmporixTelemetryEvent as c, useEmporixTelemetry as d, useEmporix as u };