@stapel/core 0.2.0

package/dist/i18n.js

@@ -0,0 +1,90 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useSyncExternalStore } from "react";
+/** `{param}` interpolation. Unknown params are left as-is. */
+export function interpolate(template, params) {
+    if (!params)
+        return template;
+    return template.replace(/\{([\w.]+)\}/g, (match, name) => Object.prototype.hasOwnProperty.call(params, name)
+        ? String(params[name])
+        : match);
+}
+/**
+ * Minimal i18n engine: dictionaries per locale, `{param}` interpolation,
+ * static bundles + async loader, missing-key fallback to the key itself
+ * (frontend-standard §4.2 — user-facing strings are always keys).
+ */
+export function createI18n(options) {
+    const dictionaries = new Map();
+    const loadedLocales = new Set();
+    const listeners = new Set();
+    let locale = options.locale;
+    let version = 0;
+    if (options.bundles) {
+        for (const [bundleLocale, bundle] of Object.entries(options.bundles)) {
+            dictionaries.set(bundleLocale, { ...bundle });
+        }
+    }
+    function notify() {
+        version += 1;
+        for (const listener of listeners)
+            listener();
+    }
+    async function ensureLoaded(nextLocale) {
+        if (!options.loadLocale || loadedLocales.has(nextLocale))
+            return;
+        loadedLocales.add(nextLocale);
+        const bundle = await options.loadLocale(nextLocale);
+        const existing = dictionaries.get(nextLocale) ?? {};
+        dictionaries.set(nextLocale, { ...existing, ...bundle });
+    }
+    const engine = {
+        get locale() {
+            return locale;
+        },
+        t: (key, params) => {
+            const template = dictionaries.get(locale)?.[key];
+            if (template === undefined)
+                return key;
+            return interpolate(template, params);
+        },
+        setLocale: async (nextLocale) => {
+            await ensureLoaded(nextLocale);
+            locale = nextLocale;
+            notify();
+        },
+        registerBundle: (bundleLocale, bundle) => {
+            const existing = dictionaries.get(bundleLocale) ?? {};
+            dictionaries.set(bundleLocale, { ...existing, ...bundle });
+            notify();
+        },
+        subscribe: (listener) => {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        getVersion: () => version,
+    };
+    return engine;
+}
+const I18nContext = createContext(null);
+export function I18nProvider(props) {
+    return (_jsx(I18nContext.Provider, { value: props.i18n, children: props.children }));
+}
+export function useI18n() {
+    const engine = useContext(I18nContext);
+    if (engine === null) {
+        throw new Error("useI18n must be used within an <I18nProvider>");
+    }
+    return engine;
+}
+/**
+ * Reactive translate function: re-renders on locale switches and bundle
+ * registration.
+ */
+export function useT() {
+    const engine = useI18n();
+    useSyncExternalStore(engine.subscribe, engine.getVersion, engine.getVersion);
+    return engine.t;
+}
+//# sourceMappingURL=i18n.js.map

package/dist/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../src/i18n.tsx"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+export { createStapelClient } from "./client.js";
+export type { StapelClient, StapelClientOptions, StapelRequestOptions, HttpMethod, } from "./client.js";
+export { StapelApiError, parseErrorEnvelope } from "./errors.js";
+export type { StapelErrorEnvelope } from "./errors.js";
+export { extractVerificationChallenge, VERIFICATION_TOKEN_HEADER, } from "./verification.js";
+export type { VerificationChallenge, VerificationOutcome, VerificationChallengeHandler, } from "./verification.js";
+export { StapelConfigProvider, useStapelConfig, useStapelClient, } from "./config.js";
+export type { StapelConfig } from "./config.js";
+export { createStapelQueryClient } from "./query.js";
+export type { StapelQueryRuntime, StapelQueryClientOptions, PersistStorage, } from "./query.js";
+export { createI18n, interpolate, I18nProvider, useI18n, useT } from "./i18n.js";
+export type { I18nEngine, I18nDictionary, LocaleLoader, TranslateFn, CreateI18nOptions, } from "./i18n.js";
+export { createAnalytics } from "./analytics/createAnalytics.js";
+export { consoleProvider, stapelCollectorProvider, } from "./analytics/providers.js";
+export type { StapelCollectorOptions } from "./analytics/providers.js";
+export { trackFlowStep } from "./analytics/flow.js";
+export type { FlowStepPhase } from "./analytics/flow.js";
+export { AnalyticsContext, useAnalytics } from "./analytics/context.js";
+export type { Analytics, AnalyticsEvent, AnalyticsEventKind, AnalyticsProvider, AnalyticsOptions, AnalyticsBatchOptions, ConsentState, PiiGuardMode, } from "./analytics/types.js";
+export { useBreakpoint } from "./useBreakpoint.js";
+export type { Breakpoint } from "@stapel/tokens";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGvD,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,qBAAqB,EACrB,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,YAAY,EACV,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,GACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjF,YAAY,EACV,UAAU,EACV,cAAc,EACd,YAAY,EACZ,WAAW,EACX,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EACL,eAAe,EACf,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACxE,YAAY,EACV,SAAS,EACT,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EACZ,YAAY,GACb,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+// fetch + error envelope
+export { createStapelClient } from "./client.js";
+export { StapelApiError, parseErrorEnvelope } from "./errors.js";
+// verification-403 interception seam
+export { extractVerificationChallenge, VERIFICATION_TOKEN_HEADER, } from "./verification.js";
+// config provider + client injection
+export { StapelConfigProvider, useStapelConfig, useStapelClient, } from "./config.js";
+// query layer + persistence
+export { createStapelQueryClient } from "./query.js";
+// i18n engine
+export { createI18n, interpolate, I18nProvider, useI18n, useT } from "./i18n.js";
+// analytics facade (analytics-standard §2)
+export { createAnalytics } from "./analytics/createAnalytics.js";
+export { consoleProvider, stapelCollectorProvider, } from "./analytics/providers.js";
+export { trackFlowStep } from "./analytics/flow.js";
+export { AnalyticsContext, useAnalytics } from "./analytics/context.js";
+// breakpoints
+export { useBreakpoint } from "./useBreakpoint.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAOjD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGjE,qCAAqC;AACrC,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAO3B,qCAAqC;AACrC,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAC;AAGrB,4BAA4B;AAC5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAOrD,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AASjF,2CAA2C;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EACL,eAAe,EACf,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAYxE,cAAc;AACd,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/query.d.ts

@@ -0,0 +1,42 @@
+import { QueryClient } from "@tanstack/react-query";
+import type { PersistStorage } from "./storage.js";
+export type { PersistStorage } from "./storage.js";
+export interface StapelQueryClientOptions {
+    /** Storage key prefix. Default `"stapel-query"`. */
+    readonly cacheKeyPrefix?: string;
+    /**
+     * Cache buster: persisted state written under a different version is
+     * discarded on restore. Convention: the consuming package's version.
+     */
+    readonly cacheVersion?: string;
+    /** Override the storage backend (tests, custom stores). */
+    readonly storage?: PersistStorage;
+    /** Bring your own QueryClient (defaults applied only when absent). */
+    readonly queryClient?: QueryClient;
+    /** Debounce for persist writes, ms. Default 100. */
+    readonly throttleMs?: number;
+}
+export interface StapelQueryRuntime {
+    readonly queryClient: QueryClient;
+    /**
+     * Switch the persistence namespace to a user (per-user cache scope,
+     * frontend-standard §4.6). Restores that user's persisted state, then
+     * mirrors cache changes back to storage. Pass `null` to stop persisting
+     * (anonymous / logged out).
+     */
+    setPersistUser(userId: string | null): Promise<void>;
+    /** Write any pending state now (also useful in tests). */
+    flushPersist(): Promise<void>;
+    /**
+     * Remove ALL persisted Stapel query state (every user namespace) and
+     * clear the in-memory cache. Call on logout and for GDPR erasure.
+     */
+    purgePersistedCache(): Promise<void>;
+}
+/**
+ * TanStack Query v5 client wrapped with Stapel persistence: per-user
+ * namespaces in IndexedDB (localStorage fallback), version-busted restore,
+ * and a GDPR-grade purge.
+ */
+export declare function createStapelQueryClient(options?: StapelQueryClientOptions): StapelQueryRuntime;
+//# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAsB,MAAM,uBAAuB,CAAC;AAGxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAOnD,MAAM,WAAW,wBAAwB;IACvC,oDAAoD;IACpD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,sEAAsE;IACtE,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC,oDAAoD;IACpD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC;;;;;OAKG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,0DAA0D;IAC1D,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B;;;OAGG;IACH,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,wBAA6B,GACrC,kBAAkB,CAiGpB"}

package/dist/query.js

@@ -0,0 +1,95 @@
+import { QueryClient, dehydrate, hydrate } from "@tanstack/react-query";
+import { defaultPersistStorage } from "./storage.js";
+/**
+ * TanStack Query v5 client wrapped with Stapel persistence: per-user
+ * namespaces in IndexedDB (localStorage fallback), version-busted restore,
+ * and a GDPR-grade purge.
+ */
+export function createStapelQueryClient(options = {}) {
+    const prefix = options.cacheKeyPrefix ?? "stapel-query";
+    const version = options.cacheVersion ?? "0";
+    const storage = options.storage ?? defaultPersistStorage();
+    const throttleMs = options.throttleMs ?? 100;
+    const queryClient = options.queryClient ??
+        new QueryClient({
+            defaultOptions: {
+                queries: {
+                    staleTime: 30_000,
+                    gcTime: 24 * 60 * 60 * 1000,
+                    retry: (failureCount, error) => {
+                        // Do not retry envelope errors the app must handle (4xx).
+                        const status = error.status;
+                        if (status !== undefined && status >= 400 && status < 500) {
+                            return false;
+                        }
+                        return failureCount < 2;
+                    },
+                },
+            },
+        });
+    let currentKey = null;
+    let unsubscribe = null;
+    let timer = null;
+    const keyFor = (userId) => `${prefix}:${userId}`;
+    async function persistNow() {
+        if (currentKey === null)
+            return;
+        const record = {
+            version,
+            state: dehydrate(queryClient),
+        };
+        await storage.set(currentKey, record);
+    }
+    function schedulePersist() {
+        if (currentKey === null || timer !== null)
+            return;
+        timer = setTimeout(() => {
+            timer = null;
+            void persistNow();
+        }, throttleMs);
+    }
+    function stopPersisting() {
+        if (unsubscribe) {
+            unsubscribe();
+            unsubscribe = null;
+        }
+        if (timer !== null) {
+            clearTimeout(timer);
+            timer = null;
+        }
+        currentKey = null;
+    }
+    async function setPersistUser(userId) {
+        if (currentKey !== null)
+            await persistNow();
+        stopPersisting();
+        if (userId === null)
+            return;
+        currentKey = keyFor(userId);
+        const stored = (await storage.get(currentKey));
+        if (stored && stored.version === version) {
+            hydrate(queryClient, stored.state);
+        }
+        else if (stored) {
+            await storage.del(currentKey);
+        }
+        unsubscribe = queryClient.getQueryCache().subscribe(schedulePersist);
+    }
+    async function flushPersist() {
+        if (timer !== null) {
+            clearTimeout(timer);
+            timer = null;
+        }
+        await persistNow();
+    }
+    async function purgePersistedCache() {
+        stopPersisting();
+        const allKeys = await storage.keys();
+        await Promise.all(allKeys
+            .filter((key) => key.startsWith(`${prefix}:`))
+            .map((key) => storage.del(key)));
+        queryClient.clear();
+    }
+    return { queryClient, setPersistUser, flushPersist, purgePersistedCache };
+}
+//# sourceMappingURL=query.js.map

package/dist/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"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"}

package/dist/storage.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Pluggable persistence backend shared by the query persist layer and the
+ * analytics offline queue. Default resolution order:
+ * IndexedDB (idb-keyval) → localStorage → in-memory (no-op across reloads).
+ */
+export interface PersistStorage {
+    get(key: string): Promise<unknown>;
+    set(key: string, value: unknown): Promise<void>;
+    del(key: string): Promise<void>;
+    keys(): Promise<string[]>;
+}
+export declare function idbStorage(): PersistStorage;
+export declare function localStorageAdapter(storageArea: Storage): PersistStorage;
+export declare function memoryStorage(): PersistStorage;
+export declare function defaultPersistStorage(): PersistStorage;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC3B;AAED,wBAAgB,UAAU,IAAI,cAAc,CAO3C;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,OAAO,GAAG,cAAc,CA4BxE;AAED,wBAAgB,aAAa,IAAI,cAAc,CAc9C;AAED,wBAAgB,qBAAqB,IAAI,cAAc,CAMtD"}

package/dist/storage.js

@@ -0,0 +1,65 @@
+import { get as idbGet, set as idbSet, del as idbDel, keys as idbKeys } from "idb-keyval";
+export function idbStorage() {
+    return {
+        get: (key) => idbGet(key),
+        set: (key, value) => idbSet(key, value),
+        del: (key) => idbDel(key),
+        keys: async () => (await idbKeys()).map(String),
+    };
+}
+export function localStorageAdapter(storageArea) {
+    return {
+        get: (key) => {
+            const raw = storageArea.getItem(key);
+            if (raw === null)
+                return Promise.resolve(undefined);
+            try {
+                return Promise.resolve(JSON.parse(raw));
+            }
+            catch {
+                return Promise.resolve(undefined);
+            }
+        },
+        set: (key, value) => {
+            storageArea.setItem(key, JSON.stringify(value));
+            return Promise.resolve();
+        },
+        del: (key) => {
+            storageArea.removeItem(key);
+            return Promise.resolve();
+        },
+        keys: () => {
+            const result = [];
+            for (let i = 0; i < storageArea.length; i += 1) {
+                const key = storageArea.key(i);
+                if (key !== null)
+                    result.push(key);
+            }
+            return Promise.resolve(result);
+        },
+    };
+}
+export function memoryStorage() {
+    const map = new Map();
+    return {
+        get: (key) => Promise.resolve(map.get(key)),
+        set: (key, value) => {
+            map.set(key, value);
+            return Promise.resolve();
+        },
+        del: (key) => {
+            map.delete(key);
+            return Promise.resolve();
+        },
+        keys: () => Promise.resolve([...map.keys()]),
+    };
+}
+export function defaultPersistStorage() {
+    if (typeof indexedDB !== "undefined")
+        return idbStorage();
+    if (typeof localStorage !== "undefined") {
+        return localStorageAdapter(localStorage);
+    }
+    return memoryStorage();
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,IAAI,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,YAAY,CAAC;AAc1F,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC;QACzB,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC;QACvC,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC;QACzB,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;KAChD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,WAAoB;IACtD,OAAO;QACL,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE;YACX,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,GAAG,KAAK,IAAI;gBAAE,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACpD,IAAI,CAAC;gBACH,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC,CAAC;YACrD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QACD,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YAClB,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAChD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QACD,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE;YACX,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YAC5B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QACD,IAAI,EAAE,GAAG,EAAE;YACT,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/C,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC/B,IAAI,GAAG,KAAK,IAAI;oBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrC,CAAC;YACD,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,GAAG,GAAG,IAAI,GAAG,EAAmB,CAAC;IACvC,OAAO;QACL,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3C,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YAClB,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACpB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QACD,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE;YACX,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QACD,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;KAC7C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,IAAI,OAAO,SAAS,KAAK,WAAW;QAAE,OAAO,UAAU,EAAE,CAAC;IAC1D,IAAI,OAAO,YAAY,KAAK,WAAW,EAAE,CAAC;QACxC,OAAO,mBAAmB,CAAC,YAAY,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,aAAa,EAAE,CAAC;AACzB,CAAC"}

package/dist/useBreakpoint.d.ts

@@ -0,0 +1,8 @@
+import type { Breakpoint } from "@stapel/tokens";
+/**
+ * Current viewport breakpoint from the three `@stapel/tokens` breakpoints
+ * (phone / tablet / desktop). SSR-safe: returns `undefined` until mounted,
+ * so server and first client render agree.
+ */
+export declare function useBreakpoint(): Breakpoint | undefined;
+//# sourceMappingURL=useBreakpoint.d.ts.map

package/dist/useBreakpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBreakpoint.d.ts","sourceRoot":"","sources":["../src/useBreakpoint.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,UAAU,GAAG,SAAS,CAiBtD"}

package/dist/useBreakpoint.js

@@ -0,0 +1,22 @@
+import { useEffect, useState } from "react";
+import { breakpointForWidth } from "@stapel/tokens";
+/**
+ * Current viewport breakpoint from the three `@stapel/tokens` breakpoints
+ * (phone / tablet / desktop). SSR-safe: returns `undefined` until mounted,
+ * so server and first client render agree.
+ */
+export function useBreakpoint() {
+    const [breakpoint, setBreakpoint] = useState(undefined);
+    useEffect(() => {
+        const update = () => {
+            setBreakpoint(breakpointForWidth(window.innerWidth));
+        };
+        update();
+        window.addEventListener("resize", update);
+        return () => {
+            window.removeEventListener("resize", update);
+        };
+    }, []);
+    return breakpoint;
+}
+//# sourceMappingURL=useBreakpoint.js.map

package/dist/useBreakpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBreakpoint.js","sourceRoot":"","sources":["../src/useBreakpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGpD;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAC1C,SAAS,CACV,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,MAAM,GAAG,GAAS,EAAE;YACxB,aAAa,CAAC,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;QACvD,CAAC,CAAC;QACF,MAAM,EAAE,CAAC;QACT,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC1C,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC/C,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/verification.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Step-up verification (the flagship cross-module flow, frontend-standard §2):
+ * a 403 whose body carries a `verification` object is a challenge, not a
+ * terminal error. `@stapel/core` hands the challenge to a configurable
+ * handler (implemented by `@stapel/auth-react`'s factor machines or the
+ * host) and retries the original request once on success.
+ */
+export interface VerificationChallenge {
+    readonly challenge_id: string;
+    /** What the challenge protects, e.g. `"billing.payout"`. */
+    readonly scope?: string;
+    /** Factors the user may satisfy, e.g. `["totp", "webauthn"]`. */
+    readonly factors?: readonly string[];
+    /** Backends may attach extra fields; kept for forward-compat. */
+    readonly [extra: string]: unknown;
+}
+export interface VerificationOutcome {
+    /** Retry the original request? */
+    readonly retry: boolean;
+    /** Sent as `X-Verification-Token` on the retry when present. */
+    readonly token?: string;
+}
+export type VerificationChallengeHandler = (challenge: VerificationChallenge) => Promise<VerificationOutcome>;
+/** Header carrying the verification proof on retried requests. */
+export declare const VERIFICATION_TOKEN_HEADER = "X-Verification-Token";
+/**
+ * Extract a verification challenge from a 403 response body, or `null` when
+ * the body is a plain error envelope.
+ */
+export declare function extractVerificationChallenge(body: unknown): VerificationChallenge | null;
+//# sourceMappingURL=verification.d.ts.map

package/dist/verification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification.d.ts","sourceRoot":"","sources":["../src/verification.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,iEAAiE;IACjE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,gEAAgE;IAChE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,4BAA4B,GAAG,CACzC,SAAS,EAAE,qBAAqB,KAC7B,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAElC,kEAAkE;AAClE,eAAO,MAAM,yBAAyB,yBAAyB,CAAC;AAMhE;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,OAAO,GACZ,qBAAqB,GAAG,IAAI,CAM9B"}

package/dist/verification.js

@@ -0,0 +1,20 @@
+/** Header carrying the verification proof on retried requests. */
+export const VERIFICATION_TOKEN_HEADER = "X-Verification-Token";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Extract a verification challenge from a 403 response body, or `null` when
+ * the body is a plain error envelope.
+ */
+export function extractVerificationChallenge(body) {
+    if (!isRecord(body))
+        return null;
+    const verification = body["verification"];
+    if (!isRecord(verification))
+        return null;
+    if (typeof verification["challenge_id"] !== "string")
+        return null;
+    return verification;
+}
+//# sourceMappingURL=verification.js.map

package/dist/verification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification.js","sourceRoot":"","sources":["../src/verification.ts"],"names":[],"mappings":"AA4BA,kEAAkE;AAClE,MAAM,CAAC,MAAM,yBAAyB,GAAG,sBAAsB,CAAC;AAEhE,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAC1C,IAAa;IAEb,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;IAC1C,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,OAAO,YAAY,CAAC,cAAc,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAClE,OAAO,YAAgD,CAAC;AAC1D,CAAC"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@stapel/core",
+  "version": "0.2.0",
+  "description": "Stapel frontend runtime (L0): typed fetch with the Stapel error envelope, auth token/refresh seams, verification-403 interception, TanStack Query layer with per-user persistence, i18n engine, config provider, breakpoints hook.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/usestapel/stapel-react.git",
+    "directory": "packages/core"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "tsconfig.json",
+    "README.md"
+  ],
+  "size-limit": [
+    {
+      "path": "dist/index.js",
+      "limit": "12 KB"
+    }
+  ],
+  "peerDependencies": {
+    "@tanstack/react-query": "^5.0.0",
+    "react": ">=19"
+  },
+  "dependencies": {
+    "idb-keyval": "^6.2.2",
+    "@stapel/tokens": "^0.1.0"
+  },
+  "devDependencies": {
+    "@size-limit/preset-small-lib": "^11.2.0",
+    "@tanstack/react-query": "^5.81.0",
+    "@testing-library/react": "^16.3.0",
+    "@types/react": "^19.1.0",
+    "@types/react-dom": "^19.1.0",
+    "jsdom": "^26.1.0",
+    "msw": "^2.10.2",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "size-limit": "^11.2.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "lint": "eslint .",
+    "size": "size-limit"
+  }
+}

package/src/analytics/context.ts

@@ -0,0 +1,20 @@
+import { createContext, useContext } from "react";
+import type { Context } from "react";
+import type { Analytics } from "./types.js";
+
+/**
+ * Provided by `<StapelConfigProvider analytics={...}>` (or directly via
+ * `AnalyticsContext.Provider`).
+ */
+export const AnalyticsContext: Context<Analytics | null> =
+  createContext<Analytics | null>(null);
+
+export function useAnalytics(): Analytics {
+  const analytics = useContext(AnalyticsContext);
+  if (analytics === null) {
+    throw new Error(
+      "useAnalytics requires an analytics instance — pass it to <StapelConfigProvider analytics={...}>"
+    );
+  }
+  return analytics;
+}