@ttt-productions/query-core 0.14.30 → 0.14.31

package/dist/react/app-config/create-app-config.d.ts

@@ -0,0 +1,38 @@
+import { type ReactNode } from 'react';
+export type AppConfigStatus = 'loading' | 'ready' | 'missing' | 'unavailable';
+export type StoredAppConfig = Readonly<Record<string, unknown>>;
+export type AppConfigLeverOf<TLevers extends object> = keyof TLevers & string;
+export type AppConfigSnapshotState<TLevers extends object, TExtra extends object> = {
+    status: AppConfigStatus;
+    levers: TLevers;
+    refusedLevers: readonly AppConfigLeverOf<TLevers>[];
+} & TExtra;
+export type AppConfigState<TLevers extends object, TExtra extends object> = AppConfigSnapshotState<TLevers, TExtra> & {
+    retry: () => void;
+    retrying: boolean;
+};
+export interface AppConfigDefinition<TLevers extends object, TExtra extends object> {
+    path: string;
+    defaults: TLevers;
+    readLevers: (stored: StoredAppConfig) => TLevers;
+    isLeverRefused: (stored: StoredAppConfig, lever: AppConfigLeverOf<TLevers>) => boolean;
+    extra: {
+        read: (stored: StoredAppConfig | null) => TExtra;
+        whileUnknown: TExtra;
+    };
+    onLeverRefused?: (lever: AppConfigLeverOf<TLevers>, value: unknown) => void;
+    onUnavailable?: (error: unknown, attempts: number) => void;
+}
+export interface AppConfig<TLevers extends object, TExtra extends object> {
+    AppConfigProvider: (props: {
+        children: ReactNode;
+    }) => ReactNode;
+    useAppConfig: () => AppConfigState<TLevers, TExtra>;
+    readAppConfigSnapshot: (stored: StoredAppConfig | null) => AppConfigSnapshotState<TLevers, TExtra>;
+    LOADING_APP_CONFIG: AppConfigSnapshotState<TLevers, TExtra>;
+    UNAVAILABLE_APP_CONFIG: AppConfigSnapshotState<TLevers, TExtra>;
+}
+export declare const APP_CONFIG_MAX_QUICK_ATTEMPTS = 6;
+export declare const APP_CONFIG_BACKGROUND_RETRY_MS = 60000;
+export declare function createAppConfig<TLevers extends object, TExtra extends object>(definition: AppConfigDefinition<TLevers, TExtra>): AppConfig<TLevers, TExtra>;
+//# sourceMappingURL=create-app-config.d.ts.map

package/dist/react/app-config/create-app-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-app-config.d.ts","sourceRoot":"","sources":["../../../src/react/app-config/create-app-config.tsx"],"names":[],"mappings":"AAEA,OAAO,EAQL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAIf,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,aAAa,CAAC;AAE9E,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEhE,MAAM,MAAM,gBAAgB,CAAC,OAAO,SAAS,MAAM,IAAI,MAAM,OAAO,GAAG,MAAM,CAAC;AAE9E,MAAM,MAAM,sBAAsB,CAAC,OAAO,SAAS,MAAM,EAAE,MAAM,SAAS,MAAM,IAAI;IAClF,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,SAAS,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;CACrD,GAAG,MAAM,CAAC;AAEX,MAAM,MAAM,cAAc,CAAC,OAAO,SAAS,MAAM,EAAE,MAAM,SAAS,MAAM,IAAI,sBAAsB,CAChG,OAAO,EACP,MAAM,CACP,GAAG;IACF,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,mBAAmB,CAAC,OAAO,SAAS,MAAM,EAAE,MAAM,SAAS,MAAM;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC;IACjD,cAAc,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC;IACvF,KAAK,EAAE;QACL,IAAI,EAAE,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,KAAK,MAAM,CAAC;QACjD,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5E,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5D;AAED,MAAM,WAAW,SAAS,CAAC,OAAO,SAAS,MAAM,EAAE,MAAM,SAAS,MAAM;IACtE,iBAAiB,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,SAAS,CAAA;KAAE,KAAK,SAAS,CAAC;IACjE,YAAY,EAAE,MAAM,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACpD,qBAAqB,EAAE,CACrB,MAAM,EAAE,eAAe,GAAG,IAAI,KAC3B,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7C,kBAAkB,EAAE,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5D,sBAAsB,EAAE,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;CACjE;AAKD,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,eAAO,MAAM,8BAA8B,QAAS,CAAC;AAMrD,wBAAgB,eAAe,CAAC,OAAO,SAAS,MAAM,EAAE,MAAM,SAAS,MAAM,EAC3E,UAAU,EAAE,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,GAC/C,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAyH5B"}

package/dist/react/app-config/create-app-config.js

@@ -0,0 +1,115 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, } from 'react';
+import { doc, onSnapshot } from 'firebase/firestore';
+import { useFirestoreDb } from '../firestore/context.js';
+// A permission-denied error ends a Firestore listener for good, and the first listen can lose a race
+// with the first App Check token, so the listener re-subscribes on its own: a short backoff, then
+// about once a minute for as long as the page is open.
+export const APP_CONFIG_MAX_QUICK_ATTEMPTS = 6;
+export const APP_CONFIG_BACKGROUND_RETRY_MS = 60_000;
+function quickRetryDelayMs(attempt) {
+    return Math.min(1000 * 2 ** (attempt - 1), 10_000);
+}
+export function createAppConfig(definition) {
+    const leverKeys = Object.keys(definition.defaults);
+    const LOADING_APP_CONFIG = {
+        ...definition.extra.whileUnknown,
+        status: 'loading',
+        levers: definition.defaults,
+        refusedLevers: [],
+    };
+    const UNAVAILABLE_APP_CONFIG = {
+        ...LOADING_APP_CONFIG,
+        status: 'unavailable',
+    };
+    function readAppConfigSnapshot(stored) {
+        const extra = definition.extra.read(stored);
+        if (stored === null) {
+            return { ...extra, status: 'missing', levers: definition.defaults, refusedLevers: [] };
+        }
+        return {
+            ...extra,
+            status: 'ready',
+            levers: definition.readLevers(stored),
+            refusedLevers: leverKeys.filter((lever) => definition.isLeverRefused(stored, lever)),
+        };
+    }
+    const AppConfigContext = createContext({
+        ...LOADING_APP_CONFIG,
+        retry: () => { },
+        retrying: false,
+    });
+    function AppConfigProvider({ children }) {
+        const db = useFirestoreDb();
+        const [snapshot, setSnapshot] = useState(LOADING_APP_CONFIG);
+        const [subscription, setSubscription] = useState(0);
+        const [retrying, setRetrying] = useState(false);
+        const reportedRefusals = useRef(new Set());
+        useEffect(() => {
+            const ref = doc(db, definition.path);
+            let attempt = 0;
+            let retryTimer;
+            let unsubscribe;
+            let disposed = false;
+            const subscribe = () => {
+                if (disposed)
+                    return;
+                unsubscribe = onSnapshot(ref, (snap) => {
+                    attempt = 0;
+                    const stored = snap.exists() ? snap.data() : null;
+                    const next = readAppConfigSnapshot(stored);
+                    for (const lever of next.refusedLevers) {
+                        const value = stored?.[lever];
+                        const key = `${lever}:${typeof value}:${JSON.stringify(value)}`;
+                        if (reportedRefusals.current.has(key))
+                            continue;
+                        reportedRefusals.current.add(key);
+                        definition.onLeverRefused?.(lever, value);
+                    }
+                    setSnapshot(next);
+                    setRetrying(false);
+                }, (error) => {
+                    unsubscribe?.();
+                    unsubscribe = undefined;
+                    attempt += 1;
+                    if (attempt < APP_CONFIG_MAX_QUICK_ATTEMPTS) {
+                        retryTimer = setTimeout(subscribe, quickRetryDelayMs(attempt));
+                        return;
+                    }
+                    if (attempt === APP_CONFIG_MAX_QUICK_ATTEMPTS) {
+                        definition.onUnavailable?.(error, attempt);
+                        // A snapshot already read stays the best knowledge there is.
+                        setSnapshot((current) => current.status === 'loading' ? UNAVAILABLE_APP_CONFIG : current);
+                        setRetrying(false);
+                    }
+                    retryTimer = setTimeout(subscribe, APP_CONFIG_BACKGROUND_RETRY_MS);
+                });
+            };
+            subscribe();
+            return () => {
+                disposed = true;
+                if (retryTimer !== undefined)
+                    clearTimeout(retryTimer);
+                unsubscribe?.();
+            };
+        }, [db, subscription]);
+        const retry = useCallback(() => {
+            setRetrying(true);
+            setSubscription((count) => count + 1);
+        }, []);
+        const value = useMemo(() => ({ ...snapshot, retry, retrying }), [snapshot, retry, retrying]);
+        return _jsx(AppConfigContext.Provider, { value: value, children: children });
+    }
+    function useAppConfig() {
+        return useContext(AppConfigContext);
+    }
+    return {
+        AppConfigProvider,
+        useAppConfig,
+        readAppConfigSnapshot,
+        LOADING_APP_CONFIG,
+        UNAVAILABLE_APP_CONFIG,
+    };
+}
+//# sourceMappingURL=create-app-config.js.map

package/dist/react/app-config/create-app-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-app-config.js","sourceRoot":"","sources":["../../../src/react/app-config/create-app-config.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EACL,aAAa,EACb,WAAW,EACX,UAAU,EACV,SAAS,EACT,OAAO,EACP,MAAM,EACN,QAAQ,GAET,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AA6CzD,qGAAqG;AACrG,kGAAkG;AAClG,uDAAuD;AACvD,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC;AAC/C,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAM,CAAC;AAErD,SAAS,iBAAiB,CAAC,OAAe;IACxC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,UAAgD;IAEhD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAgC,CAAC;IAElF,MAAM,kBAAkB,GAA4C;QAClE,GAAG,UAAU,CAAC,KAAK,CAAC,YAAY;QAChC,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,UAAU,CAAC,QAAQ;QAC3B,aAAa,EAAE,EAAE;KAClB,CAAC;IACF,MAAM,sBAAsB,GAA4C;QACtE,GAAG,kBAAkB;QACrB,MAAM,EAAE,aAAa;KACtB,CAAC;IAEF,SAAS,qBAAqB,CAC5B,MAA8B;QAE9B,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;QACzF,CAAC;QACD,OAAO;YACL,GAAG,KAAK;YACR,MAAM,EAAE,OAAO;YACf,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC;YACrC,aAAa,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;SACrF,CAAC;IACJ,CAAC;IAED,MAAM,gBAAgB,GAAG,aAAa,CAAkC;QACtE,GAAG,kBAAkB;QACrB,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;QACf,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IAEH,SAAS,iBAAiB,CAAC,EAAE,QAAQ,EAA2B;QAC9D,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;QAC5B,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAC3B,QAAQ,CAA0C,kBAAkB,CAAC,CAAC;QACxE,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,GAAG,EAAU,CAAC,CAAC;QAEnD,SAAS,CAAC,GAAG,EAAE;YACb,MAAM,GAAG,GAAG,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,IAAI,UAAqD,CAAC;YAC1D,IAAI,WAAqC,CAAC;YAC1C,IAAI,QAAQ,GAAG,KAAK,CAAC;YAErB,MAAM,SAAS,GAAG,GAAG,EAAE;gBACrB,IAAI,QAAQ;oBAAE,OAAO;gBACrB,WAAW,GAAG,UAAU,CACtB,GAAG,EACH,CAAC,IAAI,EAAE,EAAE;oBACP,OAAO,GAAG,CAAC,CAAC;oBACZ,MAAM,MAAM,GAA2B,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;oBAC1E,MAAM,IAAI,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;oBAC3C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;wBACvC,MAAM,KAAK,GAAY,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;wBACvC,MAAM,GAAG,GAAG,GAAG,KAAK,IAAI,OAAO,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;wBAChE,IAAI,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;4BAAE,SAAS;wBAChD,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;wBAClC,UAAU,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;oBAC5C,CAAC;oBACD,WAAW,CAAC,IAAI,CAAC,CAAC;oBAClB,WAAW,CAAC,KAAK,CAAC,CAAC;gBACrB,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;oBACR,WAAW,EAAE,EAAE,CAAC;oBAChB,WAAW,GAAG,SAAS,CAAC;oBACxB,OAAO,IAAI,CAAC,CAAC;oBACb,IAAI,OAAO,GAAG,6BAA6B,EAAE,CAAC;wBAC5C,UAAU,GAAG,UAAU,CAAC,SAAS,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;wBAC/D,OAAO;oBACT,CAAC;oBACD,IAAI,OAAO,KAAK,6BAA6B,EAAE,CAAC;wBAC9C,UAAU,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;wBAC3C,6DAA6D;wBAC7D,WAAW,CAAC,CAAC,OAAO,EAAE,EAAE,CACtB,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,OAAO,CAChE,CAAC;wBACF,WAAW,CAAC,KAAK,CAAC,CAAC;oBACrB,CAAC;oBACD,UAAU,GAAG,UAAU,CAAC,SAAS,EAAE,8BAA8B,CAAC,CAAC;gBACrE,CAAC,CACF,CAAC;YACJ,CAAC,CAAC;YAEF,SAAS,EAAE,CAAC;YACZ,OAAO,GAAG,EAAE;gBACV,QAAQ,GAAG,IAAI,CAAC;gBAChB,IAAI,UAAU,KAAK,SAAS;oBAAE,YAAY,CAAC,UAAU,CAAC,CAAC;gBACvD,WAAW,EAAE,EAAE,CAAC;YAClB,CAAC,CAAC;QACJ,CAAC,EAAE,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;QAEvB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YAC7B,WAAW,CAAC,IAAI,CAAC,CAAC;YAClB,eAAe,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACxC,CAAC,EAAE,EAAE,CAAC,CAAC;QAEP,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EACxC,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,CAC5B,CAAC;QAEF,OAAO,KAAC,gBAAgB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAA6B,CAAC;IACzF,CAAC;IAED,SAAS,YAAY;QACnB,OAAO,UAAU,CAAC,gBAAgB,CAAC,CAAC;IACtC,CAAC;IAED,OAAO;QACL,iBAAiB;QACjB,YAAY;QACZ,qBAAqB;QACrB,kBAAkB;QAClB,sBAAsB;KACvB,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n} from 'react';\nimport { doc, onSnapshot } from 'firebase/firestore';\nimport { useFirestoreDb } from '../firestore/context.js';\n\nexport type AppConfigStatus = 'loading' | 'ready' | 'missing' | 'unavailable';\n\nexport type StoredAppConfig = Readonly<Record<string, unknown>>;\n\nexport type AppConfigLeverOf<TLevers extends object> = keyof TLevers & string;\n\nexport type AppConfigSnapshotState<TLevers extends object, TExtra extends object> = {\n  status: AppConfigStatus;\n  levers: TLevers;\n  refusedLevers: readonly AppConfigLeverOf<TLevers>[];\n} & TExtra;\n\nexport type AppConfigState<TLevers extends object, TExtra extends object> = AppConfigSnapshotState<\n  TLevers,\n  TExtra\n> & {\n  retry: () => void;\n  retrying: boolean;\n};\n\nexport interface AppConfigDefinition<TLevers extends object, TExtra extends object> {\n  path: string;\n  defaults: TLevers;\n  readLevers: (stored: StoredAppConfig) => TLevers;\n  isLeverRefused: (stored: StoredAppConfig, lever: AppConfigLeverOf<TLevers>) => boolean;\n  extra: {\n    read: (stored: StoredAppConfig | null) => TExtra;\n    whileUnknown: TExtra;\n  };\n  onLeverRefused?: (lever: AppConfigLeverOf<TLevers>, value: unknown) => void;\n  onUnavailable?: (error: unknown, attempts: number) => void;\n}\n\nexport interface AppConfig<TLevers extends object, TExtra extends object> {\n  AppConfigProvider: (props: { children: ReactNode }) => ReactNode;\n  useAppConfig: () => AppConfigState<TLevers, TExtra>;\n  readAppConfigSnapshot: (\n    stored: StoredAppConfig | null,\n  ) => AppConfigSnapshotState<TLevers, TExtra>;\n  LOADING_APP_CONFIG: AppConfigSnapshotState<TLevers, TExtra>;\n  UNAVAILABLE_APP_CONFIG: AppConfigSnapshotState<TLevers, TExtra>;\n}\n\n// A permission-denied error ends a Firestore listener for good, and the first listen can lose a race\n// with the first App Check token, so the listener re-subscribes on its own: a short backoff, then\n// about once a minute for as long as the page is open.\nexport const APP_CONFIG_MAX_QUICK_ATTEMPTS = 6;\nexport const APP_CONFIG_BACKGROUND_RETRY_MS = 60_000;\n\nfunction quickRetryDelayMs(attempt: number): number {\n  return Math.min(1000 * 2 ** (attempt - 1), 10_000);\n}\n\nexport function createAppConfig<TLevers extends object, TExtra extends object>(\n  definition: AppConfigDefinition<TLevers, TExtra>,\n): AppConfig<TLevers, TExtra> {\n  const leverKeys = Object.keys(definition.defaults) as AppConfigLeverOf<TLevers>[];\n\n  const LOADING_APP_CONFIG: AppConfigSnapshotState<TLevers, TExtra> = {\n    ...definition.extra.whileUnknown,\n    status: 'loading',\n    levers: definition.defaults,\n    refusedLevers: [],\n  };\n  const UNAVAILABLE_APP_CONFIG: AppConfigSnapshotState<TLevers, TExtra> = {\n    ...LOADING_APP_CONFIG,\n    status: 'unavailable',\n  };\n\n  function readAppConfigSnapshot(\n    stored: StoredAppConfig | null,\n  ): AppConfigSnapshotState<TLevers, TExtra> {\n    const extra = definition.extra.read(stored);\n    if (stored === null) {\n      return { ...extra, status: 'missing', levers: definition.defaults, refusedLevers: [] };\n    }\n    return {\n      ...extra,\n      status: 'ready',\n      levers: definition.readLevers(stored),\n      refusedLevers: leverKeys.filter((lever) => definition.isLeverRefused(stored, lever)),\n    };\n  }\n\n  const AppConfigContext = createContext<AppConfigState<TLevers, TExtra>>({\n    ...LOADING_APP_CONFIG,\n    retry: () => {},\n    retrying: false,\n  });\n\n  function AppConfigProvider({ children }: { children: ReactNode }) {\n    const db = useFirestoreDb();\n    const [snapshot, setSnapshot] =\n      useState<AppConfigSnapshotState<TLevers, TExtra>>(LOADING_APP_CONFIG);\n    const [subscription, setSubscription] = useState(0);\n    const [retrying, setRetrying] = useState(false);\n    const reportedRefusals = useRef(new Set<string>());\n\n    useEffect(() => {\n      const ref = doc(db, definition.path);\n      let attempt = 0;\n      let retryTimer: ReturnType<typeof setTimeout> | undefined;\n      let unsubscribe: (() => void) | undefined;\n      let disposed = false;\n\n      const subscribe = () => {\n        if (disposed) return;\n        unsubscribe = onSnapshot(\n          ref,\n          (snap) => {\n            attempt = 0;\n            const stored: StoredAppConfig | null = snap.exists() ? snap.data() : null;\n            const next = readAppConfigSnapshot(stored);\n            for (const lever of next.refusedLevers) {\n              const value: unknown = stored?.[lever];\n              const key = `${lever}:${typeof value}:${JSON.stringify(value)}`;\n              if (reportedRefusals.current.has(key)) continue;\n              reportedRefusals.current.add(key);\n              definition.onLeverRefused?.(lever, value);\n            }\n            setSnapshot(next);\n            setRetrying(false);\n          },\n          (error) => {\n            unsubscribe?.();\n            unsubscribe = undefined;\n            attempt += 1;\n            if (attempt < APP_CONFIG_MAX_QUICK_ATTEMPTS) {\n              retryTimer = setTimeout(subscribe, quickRetryDelayMs(attempt));\n              return;\n            }\n            if (attempt === APP_CONFIG_MAX_QUICK_ATTEMPTS) {\n              definition.onUnavailable?.(error, attempt);\n              // A snapshot already read stays the best knowledge there is.\n              setSnapshot((current) =>\n                current.status === 'loading' ? UNAVAILABLE_APP_CONFIG : current,\n              );\n              setRetrying(false);\n            }\n            retryTimer = setTimeout(subscribe, APP_CONFIG_BACKGROUND_RETRY_MS);\n          },\n        );\n      };\n\n      subscribe();\n      return () => {\n        disposed = true;\n        if (retryTimer !== undefined) clearTimeout(retryTimer);\n        unsubscribe?.();\n      };\n    }, [db, subscription]);\n\n    const retry = useCallback(() => {\n      setRetrying(true);\n      setSubscription((count) => count + 1);\n    }, []);\n\n    const value = useMemo<AppConfigState<TLevers, TExtra>>(\n      () => ({ ...snapshot, retry, retrying }),\n      [snapshot, retry, retrying],\n    );\n\n    return <AppConfigContext.Provider value={value}>{children}</AppConfigContext.Provider>;\n  }\n\n  function useAppConfig(): AppConfigState<TLevers, TExtra> {\n    return useContext(AppConfigContext);\n  }\n\n  return {\n    AppConfigProvider,\n    useAppConfig,\n    readAppConfigSnapshot,\n    LOADING_APP_CONFIG,\n    UNAVAILABLE_APP_CONFIG,\n  };\n}\n"]}

package/dist/react/index.d.ts

@@ -35,4 +35,6 @@ export type { MutationSession, MutationSessionProviderProps, SessionMutateOption
 export { createCallables, MAX_RESUMABLE_CALLS } from './callables/create-callables.js';
 export type { CallableCaptureContext, CallableDeclaration, CallableErrorRouting, CallableMutationOptions, CallablePolicy, Callables, ResumableOutcome, } from './callables/create-callables.js';
 export { usePendingMutationVariables, pendingMutationVariables, usePendingMutationTargets, hasPendingMutation, duplicateSubmissionError, useDuplicateGuardedMutation, } from './pending-mutations.js';
+export { APP_CONFIG_BACKGROUND_RETRY_MS, APP_CONFIG_MAX_QUICK_ATTEMPTS, createAppConfig, } from './app-config/create-app-config.js';
+export type { AppConfig, AppConfigDefinition, AppConfigLeverOf, AppConfigSnapshotState, AppConfigState, AppConfigStatus, StoredAppConfig, } from './app-config/create-app-config.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

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

package/dist/react/index.js

@@ -21,4 +21,5 @@ export { useReadRetryState, useReadRetryStates } from './use-read-retry-state.js
 export { MutationSessionProvider, MutationSessionEndedError, useSessionMutation, } from './session-mutation.js';
 export { createCallables, MAX_RESUMABLE_CALLS } from './callables/create-callables.js';
 export { usePendingMutationVariables, pendingMutationVariables, usePendingMutationTargets, hasPendingMutation, duplicateSubmissionError, useDuplicateGuardedMutation, } from './pending-mutations.js';
+export { APP_CONFIG_BACKGROUND_RETRY_MS, APP_CONFIG_MAX_QUICK_ATTEMPTS, createAppConfig, } from './app-config/create-app-config.js';
 //# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9C,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG3E,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAE/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AAGtF,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAM7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,4BAA4B,EAAE,MAAM,oDAAoD,CAAC;AAClG,OAAO,EACL,KAAK,EACL,MAAM,EACN,SAAS,EACT,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,uCAAuC,CAAC;AAW/C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAYjD,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAG5F,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAIlF,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAW/B,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAWvF,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC","sourcesContent":["'use client';\n\nexport { createQueryClient } from './query-client.js';\nexport type { CreateQueryClientOptions } from './query-client.js';\n\nexport { QueryProvider } from './provider.js';\nexport type { QueryProviderProps } from './provider.js';\n\nexport { FirestoreProvider, useFirestoreDb } from './firestore/context.js';\nexport type { FirestoreProviderProps } from './firestore/context.js';\n\nexport { useFirestoreDoc } from './firestore/use-firestore-doc.js';\nexport { useFirestoreCollection } from './firestore/use-firestore-collection.js';\nexport { useFirestoreInfinite } from './firestore/use-firestore-infinite.js';\nexport { useFirestorePaginated } from './firestore/use-firestore-paginated.js';\nexport type { UseFirestorePaginatedResult } from './firestore/use-firestore-paginated.js';\nexport { useFirestoreCount } from './firestore/use-firestore-count.js';\nexport { useFirestoreLiveInfinite } from './firestore/use-firestore-live-infinite.js';\nexport type { FirestoreLiveInfiniteResult } from './firestore/use-firestore-live-infinite.js';\n\nexport {\n  useFirestoreSet,\n  useFirestoreUpdate,\n  useFirestoreDelete,\n  useFirestoreBatch,\n} from './firestore/use-firestore-mutations.js';\n\nexport { useBatchFirestoreDocs } from './firestore/useBatchFirestoreDocs.js';\nexport type {\n  BatchFirestoreDocsOptions,\n  BatchFirestoreDocsResult,\n  BatchFirestoreDocsTransport,\n} from './firestore/useBatchFirestoreDocs.js';\nexport { ABSENT_RETRY_DELAYS_MS } from './firestore/absence-scheduler.js';\n\nexport { useFirestoreSearch } from './search/use-firestore-search.js';\n\nexport {\n  invalidateByPrefix,\n  removeByPrefix,\n  updateQueryData,\n  paginatedPageKey,\n  mapPaginatedItems,\n  prependToFirstPaginatedPage,\n  placeRowInPages,\n} from './cache-helpers.js';\nexport type { PagedRows } from './cache-helpers.js';\n\nexport { createDomainEventInvalidator } from './domain-events/create-domain-event-invalidator.js';\nexport {\n  exact,\n  prefix,\n  predicate,\n  serializeInvalidation,\n  applyInvalidations,\n} from './domain-events/cache-invalidation.js';\nexport type {\n  DomainEventInvalidator,\n  DomainEventInvalidationRegistry,\n} from './domain-events/create-domain-event-invalidator.js';\nexport type {\n  CacheAction,\n  CacheInvalidation,\n  RefetchType,\n} from './domain-events/cache-invalidation.js';\n\nexport { docWithId } from './firestore/types.js';\nexport type {\n  FirestoreDocOptions,\n  FirestoreCollectionOptions,\n  FirestoreInfiniteOptions,\n  FirestorePaginatedOptions,\n  FirestoreCountOptions,\n  FirestoreLiveInfiniteOptions,\n  InfinitePage,\n  PaginatedPage,\n  MutationOperation,\n} from './firestore/types.js';\nexport { flattenInfiniteData, getInfiniteDataCount } from './firestore/infinite-helpers.js';\nexport type { FirestoreSearchOptions } from './search/types.js';\n\nexport { useReadRetryState, useReadRetryStates } from './use-read-retry-state.js';\nexport type { ReadRetryEntry } from './use-read-retry-state.js';\nexport type { ReadRetrySource, ReadRetryState } from './read-retry-derivation.js';\n\nexport {\n  MutationSessionProvider,\n  MutationSessionEndedError,\n  useSessionMutation,\n} from './session-mutation.js';\nexport type {\n  MutationSession,\n  MutationSessionProviderProps,\n  SessionMutateOptions,\n  SessionMutationFunctionContext,\n  SessionMutationOptions,\n  SessionMutationResult,\n  UnknownOutcomePolicy,\n} from './session-mutation.js';\n\nexport { createCallables, MAX_RESUMABLE_CALLS } from './callables/create-callables.js';\nexport type {\n  CallableCaptureContext,\n  CallableDeclaration,\n  CallableErrorRouting,\n  CallableMutationOptions,\n  CallablePolicy,\n  Callables,\n  ResumableOutcome,\n} from './callables/create-callables.js';\n\nexport {\n  usePendingMutationVariables,\n  pendingMutationVariables,\n  usePendingMutationTargets,\n  hasPendingMutation,\n  duplicateSubmissionError,\n  useDuplicateGuardedMutation,\n} from './pending-mutations.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9C,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG3E,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAE/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AAGtF,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAM7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,4BAA4B,EAAE,MAAM,oDAAoD,CAAC;AAClG,OAAO,EACL,KAAK,EACL,MAAM,EACN,SAAS,EACT,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,uCAAuC,CAAC;AAW/C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAYjD,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAG5F,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAIlF,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAW/B,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAWvF,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,8BAA8B,EAC9B,6BAA6B,EAC7B,eAAe,GAChB,MAAM,mCAAmC,CAAC","sourcesContent":["'use client';\n\nexport { createQueryClient } from './query-client.js';\nexport type { CreateQueryClientOptions } from './query-client.js';\n\nexport { QueryProvider } from './provider.js';\nexport type { QueryProviderProps } from './provider.js';\n\nexport { FirestoreProvider, useFirestoreDb } from './firestore/context.js';\nexport type { FirestoreProviderProps } from './firestore/context.js';\n\nexport { useFirestoreDoc } from './firestore/use-firestore-doc.js';\nexport { useFirestoreCollection } from './firestore/use-firestore-collection.js';\nexport { useFirestoreInfinite } from './firestore/use-firestore-infinite.js';\nexport { useFirestorePaginated } from './firestore/use-firestore-paginated.js';\nexport type { UseFirestorePaginatedResult } from './firestore/use-firestore-paginated.js';\nexport { useFirestoreCount } from './firestore/use-firestore-count.js';\nexport { useFirestoreLiveInfinite } from './firestore/use-firestore-live-infinite.js';\nexport type { FirestoreLiveInfiniteResult } from './firestore/use-firestore-live-infinite.js';\n\nexport {\n  useFirestoreSet,\n  useFirestoreUpdate,\n  useFirestoreDelete,\n  useFirestoreBatch,\n} from './firestore/use-firestore-mutations.js';\n\nexport { useBatchFirestoreDocs } from './firestore/useBatchFirestoreDocs.js';\nexport type {\n  BatchFirestoreDocsOptions,\n  BatchFirestoreDocsResult,\n  BatchFirestoreDocsTransport,\n} from './firestore/useBatchFirestoreDocs.js';\nexport { ABSENT_RETRY_DELAYS_MS } from './firestore/absence-scheduler.js';\n\nexport { useFirestoreSearch } from './search/use-firestore-search.js';\n\nexport {\n  invalidateByPrefix,\n  removeByPrefix,\n  updateQueryData,\n  paginatedPageKey,\n  mapPaginatedItems,\n  prependToFirstPaginatedPage,\n  placeRowInPages,\n} from './cache-helpers.js';\nexport type { PagedRows } from './cache-helpers.js';\n\nexport { createDomainEventInvalidator } from './domain-events/create-domain-event-invalidator.js';\nexport {\n  exact,\n  prefix,\n  predicate,\n  serializeInvalidation,\n  applyInvalidations,\n} from './domain-events/cache-invalidation.js';\nexport type {\n  DomainEventInvalidator,\n  DomainEventInvalidationRegistry,\n} from './domain-events/create-domain-event-invalidator.js';\nexport type {\n  CacheAction,\n  CacheInvalidation,\n  RefetchType,\n} from './domain-events/cache-invalidation.js';\n\nexport { docWithId } from './firestore/types.js';\nexport type {\n  FirestoreDocOptions,\n  FirestoreCollectionOptions,\n  FirestoreInfiniteOptions,\n  FirestorePaginatedOptions,\n  FirestoreCountOptions,\n  FirestoreLiveInfiniteOptions,\n  InfinitePage,\n  PaginatedPage,\n  MutationOperation,\n} from './firestore/types.js';\nexport { flattenInfiniteData, getInfiniteDataCount } from './firestore/infinite-helpers.js';\nexport type { FirestoreSearchOptions } from './search/types.js';\n\nexport { useReadRetryState, useReadRetryStates } from './use-read-retry-state.js';\nexport type { ReadRetryEntry } from './use-read-retry-state.js';\nexport type { ReadRetrySource, ReadRetryState } from './read-retry-derivation.js';\n\nexport {\n  MutationSessionProvider,\n  MutationSessionEndedError,\n  useSessionMutation,\n} from './session-mutation.js';\nexport type {\n  MutationSession,\n  MutationSessionProviderProps,\n  SessionMutateOptions,\n  SessionMutationFunctionContext,\n  SessionMutationOptions,\n  SessionMutationResult,\n  UnknownOutcomePolicy,\n} from './session-mutation.js';\n\nexport { createCallables, MAX_RESUMABLE_CALLS } from './callables/create-callables.js';\nexport type {\n  CallableCaptureContext,\n  CallableDeclaration,\n  CallableErrorRouting,\n  CallableMutationOptions,\n  CallablePolicy,\n  Callables,\n  ResumableOutcome,\n} from './callables/create-callables.js';\n\nexport {\n  usePendingMutationVariables,\n  pendingMutationVariables,\n  usePendingMutationTargets,\n  hasPendingMutation,\n  duplicateSubmissionError,\n  useDuplicateGuardedMutation,\n} from './pending-mutations.js';\n\nexport {\n  APP_CONFIG_BACKGROUND_RETRY_MS,\n  APP_CONFIG_MAX_QUICK_ATTEMPTS,\n  createAppConfig,\n} from './app-config/create-app-config.js';\nexport type {\n  AppConfig,\n  AppConfigDefinition,\n  AppConfigLeverOf,\n  AppConfigSnapshotState,\n  AppConfigState,\n  AppConfigStatus,\n  StoredAppConfig,\n} from './app-config/create-app-config.js';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttt-productions/query-core",
-  "version": "0.14.30",
+  "version": "0.14.31",
   "description": "Shared TanStack Query (React Query) client defaults, query key helpers, and Firestore integration hooks for TTT Productions apps",
   "repository": {
     "type": "git",
@@ -64,7 +64,7 @@
     }
   },
   "dependencies": {
-    "@ttt-productions/firebase-helpers": "^0.12.22"
+    "@ttt-productions/firebase-helpers": "^0.12.23"
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.90.0",