pi-kiosk-shared 2.1.86 → 2.1.88

package/dist/hooks/useDatabaseHealth.js

@@ -1,156 +1,35 @@
 /**
  * Database Health Check Hook
  *
- * Polls backend health endpoint to determine database availability.
- * Features:
- * - At most one request in flight at a time (prevents duplicate/burst requests)
- * - Minimum 15s between automatic checks when unhealthy (prevents rapid retry storm)
- * - Poll interval when healthy: 60s default (1 request/min)
- * - User-triggered retry is not throttled (only automatic checks use the 15s minimum interval)
+ * Delegates to a singleton coordinator (one poll schedule per /health endpoint).
+ * See databaseHealthCoordinator.ts for cross-tab, visibility, and 429 handling.
  */
 import { useState, useEffect, useCallback, useRef } from 'react';
-const MIN_AUTO_INTERVAL_MS = 15000; // Minimum 15s between automatic checks to avoid hammering /health
+import { requestDatabaseHealthCheck, resolveDatabaseHealthEndpoint, subscribeDatabaseHealth, } from './databaseHealthCoordinator.js';
 export function useDatabaseHealth(options = {}) {
-    const { pollInterval = 60000, maxRetries = 5, retryDelay = 1000, enabled = true, } = options;
-    const [isDatabaseAvailable, setIsDatabaseAvailable] = useState(true);
-    const [isChecking, setIsChecking] = useState(false);
-    const [retryCount, setRetryCount] = useState(0);
-    const [nextRetryDelay, setNextRetryDelay] = useState(0);
-    const [error, setError] = useState(null);
-    const [healthEndpoint] = useState(() => {
-        if (typeof window === 'undefined') {
-            return 'http://localhost:3015/health';
-        }
-        const pageOrigin = window.location.origin;
-        const windowConfig = window.__RUNTIME_CONFIG__;
-        const apiUrl = windowConfig?.apiUrl?.trim();
-        if (apiUrl) {
-            try {
-                return `${new URL(apiUrl).origin}/health`;
-            }
-            catch {
-                return `${apiUrl.replace(/\/+$/, '')}/health`;
-            }
-        }
-        return `${pageOrigin}/health`;
+    const { pollInterval = 120_000, maxRetries = 5, enabled = true, } = options;
+    const endpointRef = useRef(resolveDatabaseHealthEndpoint());
+    const [snapshot, setSnapshot] = useState({
+        isDatabaseAvailable: true,
+        isChecking: false,
+        retryCount: 0,
+        nextRetryDelay: 0,
+        error: null,
     });
-    const retryCountRef = useRef(0);
-    const currentDelayRef = useRef(retryDelay);
-    const pollTimeoutRef = useRef(null);
-    const retryTimeoutRef = useRef(null);
-    const checkHealthRef = useRef(null);
-    const isCheckingRef = useRef(false);
-    const lastCheckTimeRef = useRef(0);
-    const checkHealth = useCallback(async () => {
-        if (!enabled) {
-            return;
-        }
-        // Prevent overlapping requests (e.g. Strict Mode double-mount or poll + retry at once)
-        if (isCheckingRef.current) {
-            return;
-        }
-        isCheckingRef.current = true;
-        setIsChecking(true);
-        setError(null);
-        try {
-            const response = await fetch(healthEndpoint, {
-                method: 'GET',
-                headers: { 'Content-Type': 'application/json' },
-                cache: 'no-cache',
-            });
-            if (!response.ok) {
-                throw new Error(`Health check failed: ${response.status} ${response.statusText}`);
-            }
-            const contentType = response.headers.get('content-type');
-            if (!contentType?.includes('application/json')) {
-                throw new Error(`Invalid response: expected JSON, got ${contentType}`);
-            }
-            const data = (await response.json());
-            if (data.success === true) {
-                setIsDatabaseAvailable(true);
-                setRetryCount(0);
-                setNextRetryDelay(0);
-                retryCountRef.current = 0;
-                currentDelayRef.current = retryDelay;
-            }
-            else {
-                throw new Error('Database reported unhealthy status');
-            }
-        }
-        catch (err) {
-            const e = err instanceof Error ? err : new Error('Health check failed');
-            setError(e);
-            setIsDatabaseAvailable(false);
-            const newRetryCount = retryCountRef.current + 1;
-            retryCountRef.current = newRetryCount;
-            setRetryCount(newRetryCount);
-            const nextDelay = Math.min(currentDelayRef.current * 2, retryDelay * 30);
-            currentDelayRef.current = nextDelay;
-            const delayMs = Math.max(nextDelay, MIN_AUTO_INTERVAL_MS);
-            setNextRetryDelay(delayMs);
-            if (newRetryCount < maxRetries) {
-                retryTimeoutRef.current = setTimeout(() => {
-                    void checkHealthRef.current?.();
-                }, delayMs);
-            }
-            else {
-                retryTimeoutRef.current = setTimeout(() => {
-                    void checkHealthRef.current?.();
-                }, Math.max(pollInterval, MIN_AUTO_INTERVAL_MS));
-            }
-        }
-        finally {
-            lastCheckTimeRef.current = Date.now();
-            isCheckingRef.current = false;
-            setIsChecking(false);
-        }
-    }, [enabled, healthEndpoint, maxRetries, retryDelay, pollInterval]);
-    checkHealthRef.current = checkHealth;
     useEffect(() => {
-        if (!enabled) {
-            return;
-        }
-        const doCheck = () => {
-            const now = Date.now();
-            if (now - lastCheckTimeRef.current < MIN_AUTO_INTERVAL_MS) {
-                return;
-            }
-            if (checkHealthRef.current) {
-                void checkHealthRef.current();
-            }
-        };
-        const startPolling = () => {
-            if (pollTimeoutRef.current) {
-                clearTimeout(pollTimeoutRef.current);
-            }
-            pollTimeoutRef.current = setTimeout(() => {
-                doCheck();
-                startPolling();
-            }, pollInterval);
-        };
-        doCheck();
-        startPolling();
-        return () => {
-            if (pollTimeoutRef.current) {
-                clearTimeout(pollTimeoutRef.current);
-                pollTimeoutRef.current = null;
-            }
-            if (retryTimeoutRef.current) {
-                clearTimeout(retryTimeoutRef.current);
-                retryTimeoutRef.current = null;
-            }
-        };
-    }, [enabled, healthEndpoint, pollInterval]);
-    const checkHealthPublic = useCallback(() => {
-        return checkHealthRef.current?.() ?? Promise.resolve();
+        const endpoint = endpointRef.current;
+        return subscribeDatabaseHealth({ endpoint, enabled, pollInterval, maxRetries }, setSnapshot);
+    }, [enabled, pollInterval, maxRetries]);
+    const checkHealth = useCallback(async () => {
+        await requestDatabaseHealthCheck(endpointRef.current, { force: true });
     }, []);
     return {
-        isDatabaseAvailable,
-        isChecking,
-        retryCount,
-        nextRetryDelay,
-        error,
-        checkHealth: checkHealthPublic,
+        isDatabaseAvailable: snapshot.isDatabaseAvailable,
+        isChecking: snapshot.isChecking,
+        retryCount: snapshot.retryCount,
+        nextRetryDelay: snapshot.nextRetryDelay,
+        error: snapshot.error,
+        checkHealth,
     };
 }
 //# sourceMappingURL=useDatabaseHealth.js.map

package/dist/hooks/useDatabaseHealth.js.map

@@ -1 +1 @@
-{"version":3,"file":"useDatabaseHealth.js","sourceRoot":"","sources":["../../src/hooks/useDatabaseHealth.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useDatabaseHealth.js","sourceRoot":"","sources":["../../src/hooks/useDatabaseHealth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EAEL,0BAA0B,EAC1B,6BAA6B,EAC7B,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AAkBxC,MAAM,UAAU,iBAAiB,CAC/B,UAAoC,EAAE;IAEtC,MAAM,EACJ,YAAY,GAAG,OAAO,EACtB,UAAU,GAAG,CAAC,EACd,OAAO,GAAG,IAAI,GACf,GAAG,OAAO,CAAC;IAEZ,MAAM,WAAW,GAAG,MAAM,CAAC,6BAA6B,EAAE,CAAC,CAAC;IAC5D,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAA4B;QAClE,mBAAmB,EAAE,IAAI;QACzB,UAAU,EAAE,KAAK;QACjB,UAAU,EAAE,CAAC;QACb,cAAc,EAAE,CAAC;QACjB,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC;QACrC,OAAO,uBAAuB,CAC5B,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,EAC/C,WAAW,CACZ,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IAExC,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,IAAmB,EAAE;QACxD,MAAM,0BAA0B,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzE,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO;QACL,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB;QACjD,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/hooks/useSubmitCooldown.d.ts

@@ -0,0 +1,11 @@
+export interface UseSubmitCooldownResult {
+    readonly isCoolingDown: boolean;
+    readonly remainingSeconds: number;
+    readonly startCooldown: (durationMs: number) => void;
+    readonly clearCooldown: () => void;
+}
+/**
+ * Prevents double-tab / rapid repeat submits after rate-limit or mutation errors.
+ */
+export declare function useSubmitCooldown(): UseSubmitCooldownResult;
+//# sourceMappingURL=useSubmitCooldown.d.ts.map

package/dist/hooks/useSubmitCooldown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSubmitCooldown.d.ts","sourceRoot":"","sources":["../../src/hooks/useSubmitCooldown.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,QAAQ,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,uBAAuB,CA8C3D"}

package/dist/hooks/useSubmitCooldown.js

@@ -0,0 +1,46 @@
+import { useCallback, useEffect, useState } from 'react';
+/**
+ * Prevents double-tab / rapid repeat submits after rate-limit or mutation errors.
+ */
+export function useSubmitCooldown() {
+    const [cooldownUntil, setCooldownUntil] = useState(null);
+    const [remainingSeconds, setRemainingSeconds] = useState(0);
+    useEffect(() => {
+        if (cooldownUntil === null) {
+            setRemainingSeconds(0);
+            return;
+        }
+        const tick = () => {
+            const remainingMs = cooldownUntil - Date.now();
+            if (remainingMs <= 0) {
+                setCooldownUntil(null);
+                setRemainingSeconds(0);
+                return;
+            }
+            setRemainingSeconds(Math.ceil(remainingMs / 1000));
+        };
+        tick();
+        const intervalId = setInterval(tick, 250);
+        return () => {
+            clearInterval(intervalId);
+        };
+    }, [cooldownUntil]);
+    const startCooldown = useCallback((durationMs) => {
+        const safeMs = Math.max(durationMs, 0);
+        if (safeMs === 0) {
+            return;
+        }
+        setCooldownUntil(Date.now() + safeMs);
+    }, []);
+    const clearCooldown = useCallback(() => {
+        setCooldownUntil(null);
+        setRemainingSeconds(0);
+    }, []);
+    return {
+        isCoolingDown: cooldownUntil !== null && Date.now() < cooldownUntil,
+        remainingSeconds,
+        startCooldown,
+        clearCooldown,
+    };
+}
+//# sourceMappingURL=useSubmitCooldown.js.map

package/dist/hooks/useSubmitCooldown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSubmitCooldown.js","sourceRoot":"","sources":["../../src/hooks/useSubmitCooldown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AASzD;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IACxE,MAAM,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE5D,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;YAC3B,mBAAmB,CAAC,CAAC,CAAC,CAAC;YACvB,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAG,GAAS,EAAE;YACtB,MAAM,WAAW,GAAG,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC/C,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;gBACrB,gBAAgB,CAAC,IAAI,CAAC,CAAC;gBACvB,mBAAmB,CAAC,CAAC,CAAC,CAAC;gBACvB,OAAO;YACT,CAAC;YACD,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC;QACrD,CAAC,CAAC;QAEF,IAAI,EAAE,CAAC;QACP,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC1C,OAAO,GAAG,EAAE;YACV,aAAa,CAAC,UAAU,CAAC,CAAC;QAC5B,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;IAEpB,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,UAAkB,EAAQ,EAAE;QAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QACvC,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QACD,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC;IACxC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,aAAa,GAAG,WAAW,CAAC,GAAS,EAAE;QAC3C,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvB,mBAAmB,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO;QACL,aAAa,EAAE,aAAa,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa;QACnE,gBAAgB;QAChB,aAAa;QACb,aAAa;KACd,CAAC;AACJ,CAAC"}

package/dist/http/rateLimitError.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Detect HTTP 429 rate-limit errors across admin, customer, kiosk, and pickup ApiError shapes.
+ */
+export declare function isRateLimitError(error: unknown): boolean;
+/**
+ * Extract retry delay in milliseconds from a rate-limit error or response envelope.
+ */
+export declare function getRetryAfterMs(error: unknown, fallbackMs?: number): number;
+//# sourceMappingURL=rateLimitError.d.ts.map

package/dist/http/rateLimitError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimitError.d.ts","sourceRoot":"","sources":["../../src/http/rateLimitError.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAcxD;AAyED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,SAAS,GAAG,MAAM,CAsB3E"}

package/dist/http/rateLimitError.js

@@ -0,0 +1,97 @@
+/**
+ * Detect HTTP 429 rate-limit errors across admin, customer, kiosk, and pickup ApiError shapes.
+ */
+export function isRateLimitError(error) {
+    if (typeof error !== 'object' || error === null) {
+        return false;
+    }
+    if ('statusCode' in error && typeof error.statusCode === 'number' && error.statusCode === 429) {
+        return true;
+    }
+    if ('status' in error && typeof error.status === 'number' && error.status === 429) {
+        return true;
+    }
+    return false;
+}
+function parseRetryAfterHeaderValue(value) {
+    const seconds = Number(value);
+    if (Number.isFinite(seconds) && seconds >= 0) {
+        return Math.max(seconds * 1000, 0);
+    }
+    const dateMs = Date.parse(value);
+    if (!Number.isNaN(dateMs)) {
+        return Math.max(dateMs - Date.now(), 0);
+    }
+    return null;
+}
+function readHeader(headers, name) {
+    if (headers === null || headers === undefined) {
+        return null;
+    }
+    if (headers instanceof Headers) {
+        return headers.get(name);
+    }
+    if (typeof headers === 'object') {
+        const record = headers;
+        const direct = record[name] ?? record[name.toLowerCase()];
+        if (typeof direct === 'string') {
+            return direct;
+        }
+        if (Array.isArray(direct) && direct.length > 0) {
+            return direct[0] ?? null;
+        }
+    }
+    return null;
+}
+function retryAfterFromResponse(response) {
+    if (typeof response !== 'object' || response === null) {
+        return null;
+    }
+    if ('headers' in response) {
+        const retryAfter = readHeader(response.headers, 'retry-after');
+        if (retryAfter !== null) {
+            const parsed = parseRetryAfterHeaderValue(retryAfter);
+            if (parsed !== null) {
+                return parsed;
+            }
+        }
+        const reset = readHeader(response.headers, 'ratelimit-reset');
+        if (reset !== null) {
+            const resetSeconds = Number(reset);
+            if (Number.isFinite(resetSeconds) && resetSeconds >= 0) {
+                return Math.max(resetSeconds * 1000, 0);
+            }
+        }
+    }
+    if ('retryAfterMs' in response && typeof response.retryAfterMs === 'number') {
+        return Math.max(response.retryAfterMs, 0);
+    }
+    if ('retryAfter' in response && typeof response.retryAfter === 'number') {
+        return Math.max(response.retryAfter * 1000, 0);
+    }
+    return null;
+}
+/**
+ * Extract retry delay in milliseconds from a rate-limit error or response envelope.
+ */
+export function getRetryAfterMs(error, fallbackMs = 60_000) {
+    if (typeof error === 'object' && error !== null) {
+        if ('retryAfterMs' in error && typeof error.retryAfterMs === 'number') {
+            return Math.max(error.retryAfterMs, 0);
+        }
+        if ('response' in error) {
+            const fromResponse = retryAfterFromResponse(error.response);
+            if (fromResponse !== null) {
+                return fromResponse;
+            }
+        }
+        if ('data' in error) {
+            const fromData = retryAfterFromResponse(error.data);
+            if (fromData !== null) {
+                return fromData;
+            }
+        }
+    }
+    return fallbackMs;
+}
+//# sourceMappingURL=rateLimitError.js.map

package/dist/http/rateLimitError.js.map

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

package/dist/index.d.ts

@@ -19,6 +19,7 @@ export * from './api.js';
 export * from './errors.js';
 export * from './components/DatabaseUnavailable.js';
 export * from './hooks/useDatabaseHealth.js';
+export { useSubmitCooldown, type UseSubmitCooldownResult } from './hooks/useSubmitCooldown.js';
 export * from './analyticsEvents.js';
 export * from './analyticsEmitterManifest.js';
 export * from './analyticsCatalogV2.js';
@@ -58,4 +59,9 @@ export { expandCapabilitiesForClientCheck, grantImpliesTarget, hasEffectiveCapab
 export type { PermissionLevel } from './permissions/permissionLabels.js';
 export { TURNSTILE_PUBLIC_CONFIG_PATH, fetchTurnstileConfig, appendTurnstileToken, } from './auth/turnstileTypes.js';
 export type { TurnstileConfigData, TurnstileAuthBodyFields, AdminLoginRequest, ExchangeSuperAdminInviteSessionRequest, CompleteSuperAdminInviteRequest, PickupStaffLoginRequest, CustomerAuthTurnstileBody, } from './auth/turnstileTypes.js';
+export { isRateLimitError, getRetryAfterMs } from './http/rateLimitError.js';
+export { formatRateLimitMessage } from './errors/formatRateLimitMessage.js';
+export { createCoalescedRefetchScheduler, type CoalescedRefetchScheduler, } from './catalog/createCoalescedRefetchScheduler.js';
+export { resolvePickupHandoffModeForCheckout } from './checkout/resolvePickupHandoffModeForCheckout.js';
+export * from './tenant-entitlements/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yCAAyC,CAAC;AACxD,OAAO,EACL,wCAAwC,EACxC,yCAAyC,GAC1C,MAAM,yCAAyC,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,oCAAoC,CAAC;AACnD,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uCAAuC,CAAC;AACtD,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,gCAAgC,EAChC,kBAAkB,EAClB,sBAAsB,EACtB,yBAAyB,EACzB,iCAAiC,EACjC,iCAAiC,EACjC,4BAA4B,EAC5B,sCAAsC,GACvC,MAAM,wCAAwC,CAAC;AAChD,YAAY,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,sCAAsC,EACtC,+BAA+B,EAC/B,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yCAAyC,CAAC;AACxD,OAAO,EACL,wCAAwC,EACxC,yCAAyC,GAC1C,MAAM,yCAAyC,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,oCAAoC,CAAC;AACnD,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC/F,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uCAAuC,CAAC;AACtD,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,gCAAgC,EAChC,kBAAkB,EAClB,sBAAsB,EACtB,yBAAyB,EACzB,iCAAiC,EACjC,iCAAiC,EACjC,4BAA4B,EAC5B,sCAAsC,GACvC,MAAM,wCAAwC,CAAC;AAChD,YAAY,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,sCAAsC,EACtC,+BAA+B,EAC/B,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EACL,+BAA+B,EAC/B,KAAK,yBAAyB,GAC/B,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAAE,mCAAmC,EAAE,MAAM,mDAAmD,CAAC;AACxG,cAAc,gCAAgC,CAAC"}

package/dist/index.js

@@ -19,6 +19,7 @@ export * from './api.js';
 export * from './errors.js';
 export * from './components/DatabaseUnavailable.js';
 export * from './hooks/useDatabaseHealth.js';
+export { useSubmitCooldown } from './hooks/useSubmitCooldown.js';
 export * from './analyticsEvents.js';
 export * from './analyticsEmitterManifest.js';
 export * from './analyticsCatalogV2.js';
@@ -56,4 +57,9 @@ export * from './tenant/tenantPathResolution.js';
 export { PERMISSION_DOMAIN_LABELS, PERMISSION_LEVEL_LABELS, getPermissionDomainLabel, getPermissionLevelLabel, } from './permissions/permissionLabels.js';
 export { expandCapabilitiesForClientCheck, grantImpliesTarget, hasEffectiveCapability, hasAnyEffectiveCapability, ADMIN_USERS_MANAGE_BRIDGE_SOURCES, ADMIN_USERS_MANAGE_BRIDGE_TARGETS, BRIDGE_PARITY_FIXTURE_GRANTS, BRIDGE_PARITY_FIXTURE_EXPECTED_TARGETS, } from './permissions/effectiveCapabilities.js';
 export { TURNSTILE_PUBLIC_CONFIG_PATH, fetchTurnstileConfig, appendTurnstileToken, } from './auth/turnstileTypes.js';
+export { isRateLimitError, getRetryAfterMs } from './http/rateLimitError.js';
+export { formatRateLimitMessage } from './errors/formatRateLimitMessage.js';
+export { createCoalescedRefetchScheduler, } from './catalog/createCoalescedRefetchScheduler.js';
+export { resolvePickupHandoffModeForCheckout } from './checkout/resolvePickupHandoffModeForCheckout.js';
+export * from './tenant-entitlements/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yCAAyC,CAAC;AACxD,OAAO,EACL,wCAAwC,EACxC,yCAAyC,GAC1C,MAAM,yCAAyC,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,oCAAoC,CAAC;AACnD,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uCAAuC,CAAC;AACtD,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,gCAAgC,EAChC,kBAAkB,EAClB,sBAAsB,EACtB,yBAAyB,EACzB,iCAAiC,EACjC,iCAAiC,EACjC,4BAA4B,EAC5B,sCAAsC,GACvC,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yCAAyC,CAAC;AACxD,OAAO,EACL,wCAAwC,EACxC,yCAAyC,GAC1C,MAAM,yCAAyC,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,oCAAoC,CAAC;AACnD,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAgC,MAAM,8BAA8B,CAAC;AAC/F,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uCAAuC,CAAC;AACtD,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,gCAAgC,EAChC,kBAAkB,EAClB,sBAAsB,EACtB,yBAAyB,EACzB,iCAAiC,EACjC,iCAAiC,EACjC,4BAA4B,EAC5B,sCAAsC,GACvC,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAUlC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EACL,+BAA+B,GAEhC,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAAE,mCAAmC,EAAE,MAAM,mDAAmD,CAAC;AACxG,cAAc,gCAAgC,CAAC"}

package/dist/sales-point/salesPointPublicConfig.d.ts

@@ -75,6 +75,24 @@ export interface SalesPointPublicLoyaltyCapability {
     readonly enabled: boolean;
     readonly previewRequired: false;
 }
+/** Per-block posture on device public-config (ENT-PR-17 ceiling). */
+export interface SalesPointPublicEntitlementBlockPosture {
+    readonly entitled: boolean;
+    readonly allowReads: boolean;
+    readonly allowWrites: boolean;
+}
+/** Tenant entitlement ceiling emitted on sales-point public-config (§4, §16.1). */
+export interface SalesPointPublicEntitlementCeiling {
+    readonly revision: number;
+    readonly surfaceKiosk: SalesPointPublicEntitlementBlockPosture;
+    readonly realtimeDeviceTransport: SalesPointPublicEntitlementBlockPosture;
+    /** Sales point acts as implicit pickup point (ENT-PR-12 mirror mode). */
+    readonly pickupMirrorMode: boolean;
+}
+/** WS/SSE disconnect reason when surface or transport block is off (§12.3). */
+export declare const ENTITLEMENT_SURFACE_DISABLED_CODE: "ENTITLEMENT_SURFACE_DISABLED";
+export declare const DEFAULT_ENTITLED_PUBLIC_POSTURE: SalesPointPublicEntitlementBlockPosture;
+export declare function resolveSalesPointEntitlementCeiling(config: Pick<SalesPointPublicConfigV1, 'entitlementCeiling'>): SalesPointPublicEntitlementCeiling;
 export type SalesPointPublicConfigV1 = ({
     readonly configVersion: number;
     readonly salesPointOperationalMode: 'PRODUCTS';
@@ -84,6 +102,7 @@ export type SalesPointPublicConfigV1 = ({
     readonly catalogMedia?: SalesPointPublicCatalogMedia;
     readonly outboxObligationsEnabled: boolean;
     readonly loyalty?: SalesPointPublicLoyaltyCapability;
+    readonly entitlementCeiling?: SalesPointPublicEntitlementCeiling;
     readonly warnings?: ReadonlyArray<PublicConfigWarningCode>;
 } & SalesPointPublicConfigLocationFields) | ({
     readonly configVersion: number;
@@ -95,6 +114,7 @@ export type SalesPointPublicConfigV1 = ({
     readonly catalogMedia?: SalesPointPublicCatalogMedia;
     readonly outboxObligationsEnabled: boolean;
     readonly loyalty?: SalesPointPublicLoyaltyCapability;
+    readonly entitlementCeiling?: SalesPointPublicEntitlementCeiling;
     readonly warnings?: ReadonlyArray<PublicConfigWarningCode>;
 } & SalesPointPublicConfigLocationFields);
 /** Current contract version emitted by the backend. */

package/dist/sales-point/salesPointPublicConfig.d.ts.map

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

package/dist/sales-point/salesPointPublicConfig.js

@@ -43,6 +43,24 @@ export function parsePaymentRailsMobileFromCommerceConfig(commerceConfigJson) {
         gateway: rails.gateway === true,
     };
 }
+/** WS/SSE disconnect reason when surface or transport block is off (§12.3). */
+export const ENTITLEMENT_SURFACE_DISABLED_CODE = 'ENTITLEMENT_SURFACE_DISABLED';
+export const DEFAULT_ENTITLED_PUBLIC_POSTURE = {
+    entitled: true,
+    allowReads: true,
+    allowWrites: true,
+};
+export function resolveSalesPointEntitlementCeiling(config) {
+    if (config.entitlementCeiling !== undefined) {
+        return config.entitlementCeiling;
+    }
+    return {
+        revision: 0,
+        surfaceKiosk: DEFAULT_ENTITLED_PUBLIC_POSTURE,
+        realtimeDeviceTransport: DEFAULT_ENTITLED_PUBLIC_POSTURE,
+        pickupMirrorMode: false,
+    };
+}
 /** Current contract version emitted by the backend. */
 export const SALES_POINT_PUBLIC_CONFIG_VERSION = 5;
 //# sourceMappingURL=salesPointPublicConfig.js.map

package/dist/sales-point/salesPointPublicConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"salesPointPublicConfig.js","sourceRoot":"","sources":["../../src/sales-point/salesPointPublicConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAsEH,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,wCAAwC,CACtD,kBAAqE;IAErE,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,kBAAkB,CAAC,iBAAiB,CAAC;IACnD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,IAAI;QACzB,YAAY,EAAE,KAAK,CAAC,YAAY,KAAK,IAAI;QACzC,WAAW,EAAE,KAAK,CAAC,WAAW,KAAK,IAAI;QACvC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,KAAK,IAAI;QACnD,cAAc,EAAE,KAAK,CAAC,cAAc,KAAK,IAAI;KAC9C,CAAC;AACJ,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,yCAAyC,CACvD,kBAAqE;IAErE,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,kBAAkB,CAAC,kBAAkB,CAAC;IACpD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,YAAY,EAAE,KAAK,CAAC,YAAY,KAAK,IAAI;QACzC,OAAO,EAAE,KAAK,CAAC,OAAO,KAAK,IAAI;KAChC,CAAC;AACJ,CAAC;AA6CD,uDAAuD;AACvD,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC"}
+{"version":3,"file":"salesPointPublicConfig.js","sourceRoot":"","sources":["../../src/sales-point/salesPointPublicConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAsEH,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,wCAAwC,CACtD,kBAAqE;IAErE,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,kBAAkB,CAAC,iBAAiB,CAAC;IACnD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,IAAI;QACzB,YAAY,EAAE,KAAK,CAAC,YAAY,KAAK,IAAI;QACzC,WAAW,EAAE,KAAK,CAAC,WAAW,KAAK,IAAI;QACvC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,KAAK,IAAI;QACnD,cAAc,EAAE,KAAK,CAAC,cAAc,KAAK,IAAI;KAC9C,CAAC;AACJ,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,yCAAyC,CACvD,kBAAqE;IAErE,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,kBAAkB,CAAC,kBAAkB,CAAC;IACpD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,YAAY,EAAE,KAAK,CAAC,YAAY,KAAK,IAAI;QACzC,OAAO,EAAE,KAAK,CAAC,OAAO,KAAK,IAAI;KAChC,CAAC;AACJ,CAAC;AAoCD,+EAA+E;AAC/E,MAAM,CAAC,MAAM,iCAAiC,GAAG,8BAAuC,CAAC;AAEzF,MAAM,CAAC,MAAM,+BAA+B,GAA4C;IACtF,QAAQ,EAAE,IAAI;IACd,UAAU,EAAE,IAAI;IAChB,WAAW,EAAE,IAAI;CAClB,CAAC;AAEF,MAAM,UAAU,mCAAmC,CACjD,MAA4D;IAE5D,IAAI,MAAM,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;QAC5C,OAAO,MAAM,CAAC,kBAAkB,CAAC;IACnC,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,CAAC;QACX,YAAY,EAAE,+BAA+B;QAC7C,uBAAuB,EAAE,+BAA+B;QACxD,gBAAgB,EAAE,KAAK;KACxB,CAAC;AACJ,CAAC;AA6BD,uDAAuD;AACvD,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC"}

package/dist/sentry/captureRateLimitBreadcrumb.d.ts

@@ -0,0 +1,12 @@
+import type { SentryAppName } from './initSentry.js';
+export interface RateLimitBreadcrumbContext {
+    readonly app: SentryAppName;
+    readonly path?: string;
+    readonly method?: string;
+    readonly retryAfterMs?: number;
+}
+/**
+ * Records a Sentry breadcrumb when a client observes HTTP 429 / rate limiting.
+ */
+export declare function captureRateLimitBreadcrumb(context: RateLimitBreadcrumbContext): void;
+//# sourceMappingURL=captureRateLimitBreadcrumb.d.ts.map

package/dist/sentry/captureRateLimitBreadcrumb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"captureRateLimitBreadcrumb.d.ts","sourceRoot":"","sources":["../../src/sentry/captureRateLimitBreadcrumb.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAgBpF"}

package/dist/sentry/captureRateLimitBreadcrumb.js

@@ -0,0 +1,23 @@
+import * as Sentry from '@sentry/react';
+/**
+ * Records a Sentry breadcrumb when a client observes HTTP 429 / rate limiting.
+ */
+export function captureRateLimitBreadcrumb(context) {
+    try {
+        Sentry.addBreadcrumb({
+            category: 'rate_limit',
+            message: context.path !== undefined ? `HTTP 429 ${context.method ?? 'GET'} ${context.path}` : 'HTTP 429',
+            level: 'warning',
+            data: {
+                app: context.app,
+                path: context.path,
+                method: context.method,
+                retryAfterMs: context.retryAfterMs,
+            },
+        });
+    }
+    catch {
+        // Sentry optional in dev / when DSN unset
+    }
+}
+//# sourceMappingURL=captureRateLimitBreadcrumb.js.map

package/dist/sentry/captureRateLimitBreadcrumb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"captureRateLimitBreadcrumb.js","sourceRoot":"","sources":["../../src/sentry/captureRateLimitBreadcrumb.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAWxC;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAAmC;IAC5E,IAAI,CAAC;QACH,MAAM,CAAC,aAAa,CAAC;YACnB,QAAQ,EAAE,YAAY;YACtB,OAAO,EAAE,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,OAAO,CAAC,MAAM,IAAI,KAAK,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,UAAU;YACxG,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE;gBACJ,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,YAAY,EAAE,OAAO,CAAC,YAAY;aACnC;SACF,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;IAC5C,CAAC;AACH,CAAC"}

package/dist/sentry/initSentry.d.ts

@@ -1,5 +1,5 @@
 import type { ErrorInfo } from 'react';
-export type SentryAppName = 'admin' | 'kiosk' | 'customer';
+export type SentryAppName = 'admin' | 'kiosk' | 'customer' | 'pickup';
 export interface InitSentryOptions {
     readonly dsn?: string;
     readonly environment?: string;

package/dist/sentry/initSentry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initSentry.d.ts","sourceRoot":"","sources":["../../src/sentry/initSentry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAsBD,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CA0B3D;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CASN;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAgB7E"}
+{"version":3,"file":"initSentry.d.ts","sourceRoot":"","sources":["../../src/sentry/initSentry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAsBD,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CA0B3D;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CASN;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAgB7E"}

package/dist/tenant-entitlements/catalog.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Authoritative tenant entitlement block catalog — 44 blocks (§6.3).
+ * Code catalogVersion must stay in sync with DB seed (ENT-PR-01).
+ */
+import type { EntitlementBlockCatalogEntry, EntitlementBlockKey } from './types.js';
+import { ENTITLEMENT_BLOCK_KEYS, TENANT_ENTITLEMENT_BLOCK_COUNT, TENANT_ENTITLEMENT_CATALOG_VERSION } from './types.js';
+export declare const TENANT_ENTITLEMENT_BLOCK_CATALOG: readonly EntitlementBlockCatalogEntry[];
+export declare function isEntitlementBlockKey(value: string): value is EntitlementBlockKey;
+export declare function getEntitlementBlockCatalogEntry(blockKey: EntitlementBlockKey): EntitlementBlockCatalogEntry;
+export { TENANT_ENTITLEMENT_CATALOG_VERSION, TENANT_ENTITLEMENT_BLOCK_COUNT, ENTITLEMENT_BLOCK_KEYS, };
+//# sourceMappingURL=catalog.d.ts.map

package/dist/tenant-entitlements/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/tenant-entitlements/catalog.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EACV,4BAA4B,EAC5B,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,sBAAsB,EACtB,8BAA8B,EAC9B,kCAAkC,EACnC,MAAM,YAAY,CAAC;AAYpB,eAAO,MAAM,gCAAgC,EAAE,SAAS,4BAA4B,EA8T1E,CAAC;AAmBX,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,mBAAmB,CAEjF;AAED,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,mBAAmB,GAC5B,4BAA4B,CAM9B;AAED,OAAO,EACL,kCAAkC,EAClC,8BAA8B,EAC9B,sBAAsB,GACvB,CAAC"}