tempest-react-sdk 0.21.0 → 0.23.0

package/dist/oauth/GoogleSignIn.js

@@ -0,0 +1,50 @@
+import { jsx as f } from "react/jsx-runtime";
+function v({
+  component: r,
+  onSuccess: n,
+  onError: o,
+  locale: i,
+  theme: g,
+  text: l,
+  shape: d,
+  size: t,
+  disableOneTap: a,
+  width: c,
+  className: u,
+  style: m
+}) {
+  return /* @__PURE__ */ f("div", { className: u, style: m, children: r({
+    onSuccess: (e) => {
+      if (!e.credential) {
+        o?.({
+          provider: "google",
+          message: "Google returned no credential",
+          raw: e
+        });
+        return;
+      }
+      return n({
+        idToken: e.credential,
+        provider: "google",
+        raw: e
+      });
+    },
+    onError: () => {
+      o?.({
+        provider: "google",
+        message: "Google login failed"
+      });
+    },
+    locale: i,
+    theme: g,
+    text: l,
+    shape: d,
+    size: t,
+    useOneTap: !a,
+    width: c
+  }) });
+}
+export {
+  v as GoogleSignIn
+};
+//# sourceMappingURL=GoogleSignIn.js.map

package/dist/oauth/GoogleSignIn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleSignIn.js","sources":["../../src/oauth/GoogleSignIn.tsx"],"sourcesContent":["import type { CSSProperties, ReactNode } from \"react\";\nimport type { OAuthCredential, OAuthError } from \"./types\";\n\nexport type GoogleSignInTheme = \"filled_blue\" | \"filled_black\" | \"outline\";\nexport type GoogleSignInText = \"signin_with\" | \"signup_with\" | \"continue_with\" | \"signin\";\nexport type GoogleSignInShape = \"rectangular\" | \"pill\" | \"circle\" | \"square\";\nexport type GoogleSignInSize = \"large\" | \"medium\" | \"small\";\n\nexport interface GoogleSignInProps {\n    /**\n     * `GoogleLogin` component from `@react-oauth/google`. The caller imports\n     * it and passes it through so the SDK doesn't take `@react-oauth/google`\n     * as a peer dep.\n     */\n    component: (props: Record<string, unknown>) => ReactNode;\n    /** Fired with the validated credential on success. */\n    onSuccess: (credential: OAuthCredential) => void | Promise<void>;\n    /** Fired with a normalised error on failure. */\n    onError?: (error: OAuthError) => void;\n    /** Optional locale override (e.g. `\"pt-BR\"`). Falls back to browser locale. */\n    locale?: string;\n    /** Visual theme — passed through to `<GoogleLogin>`. */\n    theme?: GoogleSignInTheme;\n    /** Button text variant. */\n    text?: GoogleSignInText;\n    /** Button shape. */\n    shape?: GoogleSignInShape;\n    /** Button size. */\n    size?: GoogleSignInSize;\n    /** Disable Google's \"One Tap\" auto-prompt. Default `false`. */\n    disableOneTap?: boolean;\n    /** Optional `width` override (px) — Google's button is fixed-width. */\n    width?: number;\n    /** Optional className applied to the wrapper. */\n    className?: string;\n    /** Optional inline style applied to the wrapper. */\n    style?: CSSProperties;\n}\n\n/**\n * Thin wrapper over `@react-oauth/google`'s `<GoogleLogin>` that:\n *\n * 1. Normalises the success payload into [[OAuthCredential]] (`idToken`,\n *    `provider: \"google\"`, `raw`).\n * 2. Normalises errors into [[OAuthError]].\n * 3. Lets you pass `GoogleLogin` via the `component` prop, so the SDK does\n *    not declare `@react-oauth/google` as a peer dep — apps that don't use\n *    Google never pay for it.\n *\n * @example\n * import { GoogleLogin, GoogleOAuthProvider } from \"@react-oauth/google\";\n * import { GoogleSignIn } from \"tempest-react-sdk\";\n *\n * <GoogleOAuthProvider clientId={import.meta.env.VITE_GOOGLE_CLIENT_ID}>\n *     <GoogleSignIn\n *         component={GoogleLogin}\n *         onSuccess={async ({ idToken }) => {\n *             await api.post(\"/auth/google\", { body: { id_token: idToken } });\n *         }}\n *         onError={(err) => toast.error(err.message)}\n *     />\n * </GoogleOAuthProvider>\n */\nexport function GoogleSignIn({\n    component: Component,\n    onSuccess,\n    onError,\n    locale,\n    theme,\n    text,\n    shape,\n    size,\n    disableOneTap,\n    width,\n    className,\n    style,\n}: GoogleSignInProps) {\n    return (\n        <div className={className} style={style}>\n            {Component({\n                onSuccess: (response: { credential?: string }) => {\n                    if (!response.credential) {\n                        onError?.({\n                            provider: \"google\",\n                            message: \"Google returned no credential\",\n                            raw: response,\n                        });\n                        return;\n                    }\n                    return onSuccess({\n                        idToken: response.credential,\n                        provider: \"google\",\n                        raw: response,\n                    });\n                },\n                onError: () => {\n                    onError?.({\n                        provider: \"google\",\n                        message: \"Google login failed\",\n                    });\n                },\n                locale,\n                theme,\n                text,\n                shape,\n                size,\n                useOneTap: !disableOneTap,\n                width,\n            })}\n        </div>\n    );\n}\n"],"names":["GoogleSignIn","Component","onSuccess","onError","locale","theme","text","shape","size","disableOneTap","width","className","style","jsx","response"],"mappings":";AA+DO,SAASA,EAAa;AAAA,EACzB,WAAWC;AAAA,EACX,WAAAC;AAAA,EACA,SAAAC;AAAA,EACA,QAAAC;AAAA,EACA,OAAAC;AAAA,EACA,MAAAC;AAAA,EACA,OAAAC;AAAA,EACA,MAAAC;AAAA,EACA,eAAAC;AAAA,EACA,OAAAC;AAAA,EACA,WAAAC;AAAA,EACA,OAAAC;AACJ,GAAsB;AAClB,SACI,gBAAAC,EAAC,OAAA,EAAI,WAAAF,GAAsB,OAAAC,GACtB,UAAAX,EAAU;AAAA,IACP,WAAW,CAACa,MAAsC;AAC9C,UAAI,CAACA,EAAS,YAAY;AACtB,QAAAX,IAAU;AAAA,UACN,UAAU;AAAA,UACV,SAAS;AAAA,UACT,KAAKW;AAAA,QAAA,CACR;AACD;AAAA,MACJ;AACA,aAAOZ,EAAU;AAAA,QACb,SAASY,EAAS;AAAA,QAClB,UAAU;AAAA,QACV,KAAKA;AAAA,MAAA,CACR;AAAA,IACL;AAAA,IACA,SAAS,MAAM;AACX,MAAAX,IAAU;AAAA,QACN,UAAU;AAAA,QACV,SAAS;AAAA,MAAA,CACZ;AAAA,IACL;AAAA,IACA,QAAAC;AAAA,IACA,OAAAC;AAAA,IACA,MAAAC;AAAA,IACA,OAAAC;AAAA,IACA,MAAAC;AAAA,IACA,WAAW,CAACC;AAAA,IACZ,OAAAC;AAAA,EAAA,CACH,GACL;AAER;"}

package/dist/oauth/use-oauth-callback.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("react");function g(l){const{exchange:n,onSuccess:u,onError:s}=l,[f,i]=t.useState(null),[d,S]=t.useState(null),[c,a]=t.useState("pending"),o=t.useRef(!1);return t.useEffect(()=>{if(o.current)return;o.current=!0;let r=!1;return n().then(e=>{if(!r)return i(e),a("success"),u?.(e)}).catch(e=>{r||(S(e),a("error"),s?.(e))}),()=>{r=!0}},[n,u,s]),{loading:c==="pending",data:f,error:d,status:c}}exports.useOAuthCallback=g;
+//# sourceMappingURL=use-oauth-callback.cjs.map

package/dist/oauth/use-oauth-callback.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-oauth-callback.cjs","sources":["../../src/oauth/use-oauth-callback.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\n\nexport interface UseOAuthCallbackOptions<T> {\n    /** Function that exchanges the provider response for an app session. Called once on mount. */\n    exchange: () => Promise<T>;\n    /** Fired with the result on success. Receives the value resolved by `exchange`. */\n    onSuccess?: (result: T) => void | Promise<void>;\n    /** Fired when `exchange` throws or rejects. */\n    onError?: (error: unknown) => void;\n}\n\nexport interface UseOAuthCallbackResult<T> {\n    /** `true` while the exchange promise is pending. */\n    loading: boolean;\n    /** Last resolved value, when `status === \"success\"`. */\n    data: T | null;\n    /** Last rejection reason, when `status === \"error\"`. */\n    error: unknown;\n    /** Aggregated state — `\"pending\"`, `\"success\"`, or `\"error\"`. */\n    status: \"pending\" | \"success\" | \"error\";\n}\n\n/**\n * Run an OAuth-callback \"exchange\" exactly once on mount. Designed for\n * `/callback` routes that receive provider redirects and need to swap a\n * code/token for an app session via the backend.\n *\n * Survives React StrictMode double-mounting in dev — uses a ref guard to\n * ensure `exchange` runs once.\n *\n * @example\n * function OAuthCallback() {\n *     const { loading, error } = useOAuthCallback({\n *         exchange: async () => {\n *             const code = new URLSearchParams(location.search).get(\"code\")!;\n *             return api.post(\"/auth/google/exchange\", { body: { code } });\n *         },\n *         onSuccess: ({ token, user }) => {\n *             useAuthStore.getState().setSession({ user, token });\n *             navigate(\"/dashboard\", { replace: true });\n *         },\n *         onError: () => navigate(\"/login?error=oauth\", { replace: true }),\n *     });\n *\n *     if (loading) return <Spinner />;\n *     if (error) return <ErrorState description=\"OAuth falhou\" />;\n *     return null;\n * }\n */\nexport function useOAuthCallback<T>(\n    options: UseOAuthCallbackOptions<T>,\n): UseOAuthCallbackResult<T> {\n    const { exchange, onSuccess, onError } = options;\n    const [data, setData] = useState<T | null>(null);\n    const [error, setError] = useState<unknown>(null);\n    const [status, setStatus] = useState<\"pending\" | \"success\" | \"error\">(\"pending\");\n    const ranRef = useRef<boolean>(false);\n\n    useEffect(() => {\n        if (ranRef.current) return;\n        ranRef.current = true;\n        let cancelled = false;\n        exchange()\n            .then((result) => {\n                if (cancelled) return;\n                setData(result);\n                setStatus(\"success\");\n                return onSuccess?.(result);\n            })\n            .catch((err) => {\n                if (cancelled) return;\n                setError(err);\n                setStatus(\"error\");\n                onError?.(err);\n            });\n        return () => {\n            cancelled = true;\n        };\n    }, [exchange, onSuccess, onError]);\n\n    return { loading: status === \"pending\", data, error, status };\n}\n"],"names":["useOAuthCallback","options","exchange","onSuccess","onError","data","setData","useState","error","setError","status","setStatus","ranRef","useRef","useEffect","cancelled","result","err"],"mappings":"yGAiDO,SAASA,EACZC,EACyB,CACzB,KAAM,CAAE,SAAAC,EAAU,UAAAC,EAAW,QAAAC,CAAA,EAAYH,EACnC,CAACI,EAAMC,CAAO,EAAIC,EAAAA,SAAmB,IAAI,EACzC,CAACC,EAAOC,CAAQ,EAAIF,EAAAA,SAAkB,IAAI,EAC1C,CAACG,EAAQC,CAAS,EAAIJ,EAAAA,SAA0C,SAAS,EACzEK,EAASC,EAAAA,OAAgB,EAAK,EAEpCC,OAAAA,EAAAA,UAAU,IAAM,CACZ,GAAIF,EAAO,QAAS,OACpBA,EAAO,QAAU,GACjB,IAAIG,EAAY,GAChB,OAAAb,EAAA,EACK,KAAMc,GAAW,CACd,GAAI,CAAAD,EACJ,OAAAT,EAAQU,CAAM,EACdL,EAAU,SAAS,EACZR,IAAYa,CAAM,CAC7B,CAAC,EACA,MAAOC,GAAQ,CACRF,IACJN,EAASQ,CAAG,EACZN,EAAU,OAAO,EACjBP,IAAUa,CAAG,EACjB,CAAC,EACE,IAAM,CACTF,EAAY,EAChB,CACJ,EAAG,CAACb,EAAUC,EAAWC,CAAO,CAAC,EAE1B,CAAE,QAASM,IAAW,UAAW,KAAAL,EAAM,MAAAG,EAAO,OAAAE,CAAA,CACzD"}

package/dist/oauth/use-oauth-callback.js

@@ -0,0 +1,21 @@
+import { useState as r, useRef as h, useEffect as p } from "react";
+function S(f) {
+  const { exchange: n, onSuccess: s, onError: u } = f, [l, i] = r(null), [d, g] = r(null), [c, a] = r("pending"), o = h(!1);
+  return p(() => {
+    if (o.current) return;
+    o.current = !0;
+    let t = !1;
+    return n().then((e) => {
+      if (!t)
+        return i(e), a("success"), s?.(e);
+    }).catch((e) => {
+      t || (g(e), a("error"), u?.(e));
+    }), () => {
+      t = !0;
+    };
+  }, [n, s, u]), { loading: c === "pending", data: l, error: d, status: c };
+}
+export {
+  S as useOAuthCallback
+};
+//# sourceMappingURL=use-oauth-callback.js.map

package/dist/oauth/use-oauth-callback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-oauth-callback.js","sources":["../../src/oauth/use-oauth-callback.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\n\nexport interface UseOAuthCallbackOptions<T> {\n    /** Function that exchanges the provider response for an app session. Called once on mount. */\n    exchange: () => Promise<T>;\n    /** Fired with the result on success. Receives the value resolved by `exchange`. */\n    onSuccess?: (result: T) => void | Promise<void>;\n    /** Fired when `exchange` throws or rejects. */\n    onError?: (error: unknown) => void;\n}\n\nexport interface UseOAuthCallbackResult<T> {\n    /** `true` while the exchange promise is pending. */\n    loading: boolean;\n    /** Last resolved value, when `status === \"success\"`. */\n    data: T | null;\n    /** Last rejection reason, when `status === \"error\"`. */\n    error: unknown;\n    /** Aggregated state — `\"pending\"`, `\"success\"`, or `\"error\"`. */\n    status: \"pending\" | \"success\" | \"error\";\n}\n\n/**\n * Run an OAuth-callback \"exchange\" exactly once on mount. Designed for\n * `/callback` routes that receive provider redirects and need to swap a\n * code/token for an app session via the backend.\n *\n * Survives React StrictMode double-mounting in dev — uses a ref guard to\n * ensure `exchange` runs once.\n *\n * @example\n * function OAuthCallback() {\n *     const { loading, error } = useOAuthCallback({\n *         exchange: async () => {\n *             const code = new URLSearchParams(location.search).get(\"code\")!;\n *             return api.post(\"/auth/google/exchange\", { body: { code } });\n *         },\n *         onSuccess: ({ token, user }) => {\n *             useAuthStore.getState().setSession({ user, token });\n *             navigate(\"/dashboard\", { replace: true });\n *         },\n *         onError: () => navigate(\"/login?error=oauth\", { replace: true }),\n *     });\n *\n *     if (loading) return <Spinner />;\n *     if (error) return <ErrorState description=\"OAuth falhou\" />;\n *     return null;\n * }\n */\nexport function useOAuthCallback<T>(\n    options: UseOAuthCallbackOptions<T>,\n): UseOAuthCallbackResult<T> {\n    const { exchange, onSuccess, onError } = options;\n    const [data, setData] = useState<T | null>(null);\n    const [error, setError] = useState<unknown>(null);\n    const [status, setStatus] = useState<\"pending\" | \"success\" | \"error\">(\"pending\");\n    const ranRef = useRef<boolean>(false);\n\n    useEffect(() => {\n        if (ranRef.current) return;\n        ranRef.current = true;\n        let cancelled = false;\n        exchange()\n            .then((result) => {\n                if (cancelled) return;\n                setData(result);\n                setStatus(\"success\");\n                return onSuccess?.(result);\n            })\n            .catch((err) => {\n                if (cancelled) return;\n                setError(err);\n                setStatus(\"error\");\n                onError?.(err);\n            });\n        return () => {\n            cancelled = true;\n        };\n    }, [exchange, onSuccess, onError]);\n\n    return { loading: status === \"pending\", data, error, status };\n}\n"],"names":["useOAuthCallback","options","exchange","onSuccess","onError","data","setData","useState","error","setError","status","setStatus","ranRef","useRef","useEffect","cancelled","result","err"],"mappings":";AAiDO,SAASA,EACZC,GACyB;AACzB,QAAM,EAAE,UAAAC,GAAU,WAAAC,GAAW,SAAAC,EAAA,IAAYH,GACnC,CAACI,GAAMC,CAAO,IAAIC,EAAmB,IAAI,GACzC,CAACC,GAAOC,CAAQ,IAAIF,EAAkB,IAAI,GAC1C,CAACG,GAAQC,CAAS,IAAIJ,EAA0C,SAAS,GACzEK,IAASC,EAAgB,EAAK;AAEpC,SAAAC,EAAU,MAAM;AACZ,QAAIF,EAAO,QAAS;AACpB,IAAAA,EAAO,UAAU;AACjB,QAAIG,IAAY;AAChB,WAAAb,EAAA,EACK,KAAK,CAACc,MAAW;AACd,UAAI,CAAAD;AACJ,eAAAT,EAAQU,CAAM,GACdL,EAAU,SAAS,GACZR,IAAYa,CAAM;AAAA,IAC7B,CAAC,EACA,MAAM,CAACC,MAAQ;AACZ,MAAIF,MACJN,EAASQ,CAAG,GACZN,EAAU,OAAO,GACjBP,IAAUa,CAAG;AAAA,IACjB,CAAC,GACE,MAAM;AACT,MAAAF,IAAY;AAAA,IAChB;AAAA,EACJ,GAAG,CAACb,GAAUC,GAAWC,CAAO,CAAC,GAE1B,EAAE,SAASM,MAAW,WAAW,MAAAL,GAAM,OAAAG,GAAO,QAAAE,EAAA;AACzD;"}

package/dist/offline/conflict.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function t(i){if(i instanceof Date)return i.getTime();if(typeof i=="number")return i;const n=Date.parse(i);return Number.isNaN(n)?0:n}function e(i,n,r){return i===void 0||t(r(n))>=t(r(i))?n:i}function s(i,n,r){return i===void 0||r(n)>=r(i)?n:i}exports.higherVersionWins=s;exports.lastWriteWins=e;
+//# sourceMappingURL=conflict.cjs.map

package/dist/offline/conflict.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict.cjs","sources":["../../src/offline/conflict.ts"],"sourcesContent":["/**\n * Conflict-resolution helpers for the `applyRemote` callback of\n * {@link createOfflineSync}. Each takes the current local record (or\n * `undefined` when the record is new locally) and the incoming remote record,\n * and returns the winner. Ties resolve to the remote copy, treating the server\n * as authoritative.\n */\n\n/** Normalise a timestamp-ish value to epoch milliseconds. */\nfunction toMillis(value: number | string | Date): number {\n    if (value instanceof Date) return value.getTime();\n    if (typeof value === \"number\") return value;\n    const parsed = Date.parse(value);\n    return Number.isNaN(parsed) ? 0 : parsed;\n}\n\n/**\n * Resolve a conflict by keeping whichever record was written last, comparing a\n * timestamp field. The remote record wins ties.\n *\n * @typeParam T - The record shape.\n * @param local - The current local record, or `undefined` when new.\n * @param remote - The incoming remote record.\n * @param getTimestamp - Reads the comparison timestamp (epoch ms, ISO string or `Date`).\n * @returns The winning record.\n *\n * @example\n * applyRemote: async (dto) => {\n *     const local = await store.get(dto.id);\n *     await store.save(lastWriteWins(local, dto, (r) => r.updatedAt));\n * }\n */\nexport function lastWriteWins<T>(\n    local: T | undefined,\n    remote: T,\n    getTimestamp: (record: T) => number | string | Date,\n): T {\n    if (local === undefined) return remote;\n    return toMillis(getTimestamp(remote)) >= toMillis(getTimestamp(local)) ? remote : local;\n}\n\n/**\n * Resolve a conflict by keeping whichever record carries the higher version\n * number (monotonic counter / row version). The remote record wins ties.\n *\n * @typeParam T - The record shape.\n * @param local - The current local record, or `undefined` when new.\n * @param remote - The incoming remote record.\n * @param getVersion - Reads the monotonic version number.\n * @returns The winning record.\n *\n * @example\n * applyRemote: async (dto) => {\n *     const local = await store.get(dto.id);\n *     await store.save(higherVersionWins(local, dto, (r) => r.version));\n * }\n */\nexport function higherVersionWins<T>(\n    local: T | undefined,\n    remote: T,\n    getVersion: (record: T) => number,\n): T {\n    if (local === undefined) return remote;\n    return getVersion(remote) >= getVersion(local) ? remote : local;\n}\n"],"names":["toMillis","value","parsed","lastWriteWins","local","remote","getTimestamp","higherVersionWins","getVersion"],"mappings":"gFASA,SAASA,EAASC,EAAuC,CACrD,GAAIA,aAAiB,KAAM,OAAOA,EAAM,QAAA,EACxC,GAAI,OAAOA,GAAU,SAAU,OAAOA,EACtC,MAAMC,EAAS,KAAK,MAAMD,CAAK,EAC/B,OAAO,OAAO,MAAMC,CAAM,EAAI,EAAIA,CACtC,CAkBO,SAASC,EACZC,EACAC,EACAC,EACC,CACD,OAAIF,IAAU,QACPJ,EAASM,EAAaD,CAAM,CAAC,GAAKL,EAASM,EAAaF,CAAK,CAAC,EADrCC,EACkDD,CACtF,CAkBO,SAASG,EACZH,EACAC,EACAG,EACC,CACD,OAAIJ,IAAU,QACPI,EAAWH,CAAM,GAAKG,EAAWJ,CAAK,EADbC,EAC0BD,CAC9D"}

package/dist/offline/conflict.js

@@ -0,0 +1,17 @@
+function t(n) {
+  if (n instanceof Date) return n.getTime();
+  if (typeof n == "number") return n;
+  const i = Date.parse(n);
+  return Number.isNaN(i) ? 0 : i;
+}
+function f(n, i, r) {
+  return n === void 0 || t(r(i)) >= t(r(n)) ? i : n;
+}
+function s(n, i, r) {
+  return n === void 0 || r(i) >= r(n) ? i : n;
+}
+export {
+  s as higherVersionWins,
+  f as lastWriteWins
+};
+//# sourceMappingURL=conflict.js.map

package/dist/offline/conflict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict.js","sources":["../../src/offline/conflict.ts"],"sourcesContent":["/**\n * Conflict-resolution helpers for the `applyRemote` callback of\n * {@link createOfflineSync}. Each takes the current local record (or\n * `undefined` when the record is new locally) and the incoming remote record,\n * and returns the winner. Ties resolve to the remote copy, treating the server\n * as authoritative.\n */\n\n/** Normalise a timestamp-ish value to epoch milliseconds. */\nfunction toMillis(value: number | string | Date): number {\n    if (value instanceof Date) return value.getTime();\n    if (typeof value === \"number\") return value;\n    const parsed = Date.parse(value);\n    return Number.isNaN(parsed) ? 0 : parsed;\n}\n\n/**\n * Resolve a conflict by keeping whichever record was written last, comparing a\n * timestamp field. The remote record wins ties.\n *\n * @typeParam T - The record shape.\n * @param local - The current local record, or `undefined` when new.\n * @param remote - The incoming remote record.\n * @param getTimestamp - Reads the comparison timestamp (epoch ms, ISO string or `Date`).\n * @returns The winning record.\n *\n * @example\n * applyRemote: async (dto) => {\n *     const local = await store.get(dto.id);\n *     await store.save(lastWriteWins(local, dto, (r) => r.updatedAt));\n * }\n */\nexport function lastWriteWins<T>(\n    local: T | undefined,\n    remote: T,\n    getTimestamp: (record: T) => number | string | Date,\n): T {\n    if (local === undefined) return remote;\n    return toMillis(getTimestamp(remote)) >= toMillis(getTimestamp(local)) ? remote : local;\n}\n\n/**\n * Resolve a conflict by keeping whichever record carries the higher version\n * number (monotonic counter / row version). The remote record wins ties.\n *\n * @typeParam T - The record shape.\n * @param local - The current local record, or `undefined` when new.\n * @param remote - The incoming remote record.\n * @param getVersion - Reads the monotonic version number.\n * @returns The winning record.\n *\n * @example\n * applyRemote: async (dto) => {\n *     const local = await store.get(dto.id);\n *     await store.save(higherVersionWins(local, dto, (r) => r.version));\n * }\n */\nexport function higherVersionWins<T>(\n    local: T | undefined,\n    remote: T,\n    getVersion: (record: T) => number,\n): T {\n    if (local === undefined) return remote;\n    return getVersion(remote) >= getVersion(local) ? remote : local;\n}\n"],"names":["toMillis","value","parsed","lastWriteWins","local","remote","getTimestamp","higherVersionWins","getVersion"],"mappings":"AASA,SAASA,EAASC,GAAuC;AACrD,MAAIA,aAAiB,KAAM,QAAOA,EAAM,QAAA;AACxC,MAAI,OAAOA,KAAU,SAAU,QAAOA;AACtC,QAAMC,IAAS,KAAK,MAAMD,CAAK;AAC/B,SAAO,OAAO,MAAMC,CAAM,IAAI,IAAIA;AACtC;AAkBO,SAASC,EACZC,GACAC,GACAC,GACC;AACD,SAAIF,MAAU,UACPJ,EAASM,EAAaD,CAAM,CAAC,KAAKL,EAASM,EAAaF,CAAK,CAAC,IADrCC,IACkDD;AACtF;AAkBO,SAASG,EACZH,GACAC,GACAG,GACC;AACD,SAAIJ,MAAU,UACPI,EAAWH,CAAM,KAAKG,EAAWJ,CAAK,IADbC,IAC0BD;AAC9D;"}

package/dist/offline/create-offline-store.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const v=require("dexie");class g extends v{store;constructor(l,u,a,c){super(l),this.version(u).stores({[a]:c}),this.store=this.table(a)}}function O(f){const{databaseName:l,version:u,tableName:a,indexes:c,keyPath:d="id",ownerField:i}=f,y=new g(l,u,a,c),t=y.store;function b(e,r){return!i||!r?e:{...e,[i]:r}}async function m(e,r={}){const{orderBy:s=d,reverse:q=!1,limit:p,offset:h,filter:w}=r;let o=i&&e?t.where(i).equals(e):t.toCollection();w&&(o=o.filter(w));let n=s===d?await o.toArray():await o.sortBy(s);return q&&(n=n.reverse()),h&&(n=n.slice(h)),typeof p=="number"&&(n=n.slice(0,p)),n}return{put:(e,r)=>t.put(b(e,r)),bulkPut:(e,r)=>t.bulkPut(e.map(s=>b(s,r))),get:e=>t.get(e),list:m,update:(e,r)=>t.update(e,r),updateMany:async(e,r)=>{const s=r;return i&&e?t.where(i).equals(e).modify(s):t.toCollection().modify(s)},delete:e=>t.delete(e),clear:async e=>{if(i&&e){await t.where(i).equals(e).delete();return}await t.clear()},count:e=>i&&e?t.where(i).equals(e).count():t.count(),raw:t,db:y}}exports.createOfflineStore=O;
+//# sourceMappingURL=create-offline-store.cjs.map

package/dist/offline/create-offline-store.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-offline-store.cjs","sources":["../../src/offline/create-offline-store.ts"],"sourcesContent":["import Dexie, { type Table, type UpdateSpec } from \"dexie\";\n\nexport interface OfflineStoreConfig<TItem> {\n    /** IndexedDB database name. */\n    databaseName: string;\n    /** Schema version. Bump when changing indexes; pair with a migration if needed. */\n    version: number;\n    /** Object-store name. */\n    tableName: string;\n    /**\n     * Dexie index definition for the table. Use `&` for the primary key\n     * (unique), e.g. `\"&id, owner_id, created_at\"`. See Dexie docs for the\n     * full syntax.\n     */\n    indexes: string;\n    /** Property used as the primary key (default: `\"id\"`). */\n    keyPath?: keyof TItem & string;\n    /**\n     * Optional owner scoping. When set, every read/write method honors the\n     * `owner` argument and persists it on each record (e.g. multi-tenant\n     * notifications keyed by `user_id`).\n     */\n    ownerField?: keyof TItem & string;\n}\n\nexport interface ListOptions<TItem> {\n    /** Property to order by. Default: `keyPath`. */\n    orderBy?: keyof TItem & string;\n    /** Reverse the ordering. Default: false. */\n    reverse?: boolean;\n    /** Maximum number of items to return. */\n    limit?: number;\n    /** Skip this many items from the start of the result set. */\n    offset?: number;\n    /** Custom predicate applied after the index query. */\n    filter?: (item: TItem) => boolean;\n}\n\nexport interface OfflineStore<TItem, TKey extends string | number> {\n    /** Insert or replace a record. */\n    put: (item: TItem, owner?: string) => Promise<TKey>;\n    /** Insert or replace multiple records in a single transaction. */\n    bulkPut: (items: TItem[], owner?: string) => Promise<TKey>;\n    /** Fetch one record by its primary key. */\n    get: (key: TKey) => Promise<TItem | undefined>;\n    /** List records, optionally scoped to `owner` when `ownerField` is configured. */\n    list: (owner?: string, options?: ListOptions<TItem>) => Promise<TItem[]>;\n    /** Partial update by primary key. Returns the number of records changed. */\n    update: (key: TKey, changes: Partial<TItem>) => Promise<number>;\n    /** Apply a modification to every record matching `owner`. */\n    updateMany: (owner: string | undefined, changes: Partial<TItem>) => Promise<number>;\n    /** Delete one record by primary key. */\n    delete: (key: TKey) => Promise<void>;\n    /** Delete every record matching `owner` (or the entire table when no scope is set). */\n    clear: (owner?: string) => Promise<void>;\n    /** Count records, optionally scoped to `owner`. */\n    count: (owner?: string) => Promise<number>;\n    /** Raw Dexie table for advanced queries. */\n    raw: Table<TItem, TKey>;\n    /** Underlying Dexie instance. */\n    db: Dexie;\n}\n\nclass GenericDb<TItem, TKey extends string | number> extends Dexie {\n    store!: Table<TItem, TKey>;\n\n    constructor(name: string, version: number, tableName: string, indexes: string) {\n        super(name);\n        this.version(version).stores({ [tableName]: indexes });\n        this.store = this.table<TItem, TKey>(tableName);\n    }\n}\n\n/**\n * Build a typed IndexedDB-backed store using Dexie. Optionally scope every\n * operation by an `ownerField` (useful for multi-user SSE history, drafts,\n * cache per workspace, etc.).\n *\n * Dexie is an **optional peer dependency** — install it (`npm i dexie`) only\n * when your app needs offline storage.\n *\n * @example\n * type Note = { id: string; owner_id: string; text: string; created_at: string };\n * const notes = createOfflineStore<Note, string>({\n *     databaseName: \"TempestNotes\",\n *     version: 1,\n *     tableName: \"notes\",\n *     indexes: \"&id, owner_id, created_at\",\n *     ownerField: \"owner_id\",\n * });\n * await notes.put({ id: \"n1\", owner_id: \"u1\", text: \"hi\", created_at: ... }, \"u1\");\n * const mine = await notes.list(\"u1\", { orderBy: \"created_at\", reverse: true });\n */\nexport function createOfflineStore<TItem, TKey extends string | number = string>(\n    config: OfflineStoreConfig<TItem>,\n): OfflineStore<TItem, TKey> {\n    const { databaseName, version, tableName, indexes, keyPath = \"id\", ownerField } = config;\n\n    const db = new GenericDb<TItem, TKey>(databaseName, version, tableName, indexes);\n    const table = db.store;\n\n    function withOwner(item: TItem, owner?: string): TItem {\n        if (!ownerField || !owner) return item;\n        return { ...item, [ownerField]: owner } as TItem;\n    }\n\n    async function list(owner?: string, options: ListOptions<TItem> = {}): Promise<TItem[]> {\n        const { orderBy = keyPath, reverse = false, limit, offset, filter } = options;\n\n        let collection =\n            ownerField && owner ? table.where(ownerField).equals(owner) : table.toCollection();\n\n        if (filter) collection = collection.filter(filter);\n\n        let items =\n            orderBy === keyPath ? await collection.toArray() : await collection.sortBy(orderBy);\n\n        if (reverse) items = items.reverse();\n        if (offset) items = items.slice(offset);\n        if (typeof limit === \"number\") items = items.slice(0, limit);\n        return items;\n    }\n\n    return {\n        put: (item, owner) => table.put(withOwner(item, owner)) as Promise<TKey>,\n        bulkPut: (items, owner) =>\n            table.bulkPut(items.map((item) => withOwner(item, owner))) as Promise<TKey>,\n        get: (key) => table.get(key),\n        list,\n        update: (key, changes) => table.update(key, changes as UpdateSpec<TItem>),\n        updateMany: async (owner, changes) => {\n            const spec = changes as UpdateSpec<TItem>;\n            if (ownerField && owner) {\n                return table.where(ownerField).equals(owner).modify(spec);\n            }\n            return table.toCollection().modify(spec);\n        },\n        delete: (key) => table.delete(key),\n        clear: async (owner) => {\n            if (ownerField && owner) {\n                await table.where(ownerField).equals(owner).delete();\n                return;\n            }\n            await table.clear();\n        },\n        count: (owner) => {\n            if (ownerField && owner) {\n                return table.where(ownerField).equals(owner).count();\n            }\n            return table.count();\n        },\n        raw: table,\n        db,\n    };\n}\n"],"names":["GenericDb","Dexie","name","version","tableName","indexes","createOfflineStore","config","databaseName","keyPath","ownerField","db","table","withOwner","item","owner","list","options","orderBy","reverse","limit","offset","filter","collection","items","key","changes","spec"],"mappings":"yGA+DA,MAAMA,UAAuDC,CAAM,CAC/D,MAEA,YAAYC,EAAcC,EAAiBC,EAAmBC,EAAiB,CAC3E,MAAMH,CAAI,EACV,KAAK,QAAQC,CAAO,EAAE,OAAO,CAAE,CAACC,CAAS,EAAGC,EAAS,EACrD,KAAK,MAAQ,KAAK,MAAmBD,CAAS,CAClD,CACJ,CAsBO,SAASE,EACZC,EACyB,CACzB,KAAM,CAAE,aAAAC,EAAc,QAAAL,EAAS,UAAAC,EAAW,QAAAC,EAAS,QAAAI,EAAU,KAAM,WAAAC,GAAeH,EAE5EI,EAAK,IAAIX,EAAuBQ,EAAcL,EAASC,EAAWC,CAAO,EACzEO,EAAQD,EAAG,MAEjB,SAASE,EAAUC,EAAaC,EAAuB,CACnD,MAAI,CAACL,GAAc,CAACK,EAAcD,EAC3B,CAAE,GAAGA,EAAM,CAACJ,CAAU,EAAGK,CAAA,CACpC,CAEA,eAAeC,EAAKD,EAAgBE,EAA8B,GAAsB,CACpF,KAAM,CAAE,QAAAC,EAAUT,EAAS,QAAAU,EAAU,GAAO,MAAAC,EAAO,OAAAC,EAAQ,OAAAC,GAAWL,EAEtE,IAAIM,EACAb,GAAcK,EAAQH,EAAM,MAAMF,CAAU,EAAE,OAAOK,CAAK,EAAIH,EAAM,aAAA,EAEpEU,IAAQC,EAAaA,EAAW,OAAOD,CAAM,GAEjD,IAAIE,EACAN,IAAYT,EAAU,MAAMc,EAAW,UAAY,MAAMA,EAAW,OAAOL,CAAO,EAEtF,OAAIC,IAASK,EAAQA,EAAM,QAAA,GACvBH,IAAQG,EAAQA,EAAM,MAAMH,CAAM,GAClC,OAAOD,GAAU,aAAkBI,EAAM,MAAM,EAAGJ,CAAK,GACpDI,CACX,CAEA,MAAO,CACH,IAAK,CAACV,EAAMC,IAAUH,EAAM,IAAIC,EAAUC,EAAMC,CAAK,CAAC,EACtD,QAAS,CAACS,EAAOT,IACbH,EAAM,QAAQY,EAAM,IAAKV,GAASD,EAAUC,EAAMC,CAAK,CAAC,CAAC,EAC7D,IAAMU,GAAQb,EAAM,IAAIa,CAAG,EAC3B,KAAAT,EACA,OAAQ,CAACS,EAAKC,IAAYd,EAAM,OAAOa,EAAKC,CAA4B,EACxE,WAAY,MAAOX,EAAOW,IAAY,CAClC,MAAMC,EAAOD,EACb,OAAIhB,GAAcK,EACPH,EAAM,MAAMF,CAAU,EAAE,OAAOK,CAAK,EAAE,OAAOY,CAAI,EAErDf,EAAM,eAAe,OAAOe,CAAI,CAC3C,EACA,OAASF,GAAQb,EAAM,OAAOa,CAAG,EACjC,MAAO,MAAOV,GAAU,CACpB,GAAIL,GAAcK,EAAO,CACrB,MAAMH,EAAM,MAAMF,CAAU,EAAE,OAAOK,CAAK,EAAE,OAAA,EAC5C,MACJ,CACA,MAAMH,EAAM,MAAA,CAChB,EACA,MAAQG,GACAL,GAAcK,EACPH,EAAM,MAAMF,CAAU,EAAE,OAAOK,CAAK,EAAE,MAAA,EAE1CH,EAAM,MAAA,EAEjB,IAAKA,EACL,GAAAD,CAAA,CAER"}

package/dist/offline/create-offline-store.js

@@ -0,0 +1,46 @@
+import v from "dexie";
+class x extends v {
+  store;
+  constructor(l, u, a, c) {
+    super(l), this.version(u).stores({ [a]: c }), this.store = this.table(a);
+  }
+}
+function P(f) {
+  const { databaseName: l, version: u, tableName: a, indexes: c, keyPath: d = "id", ownerField: i } = f, p = new x(l, u, a, c), t = p.store;
+  function y(e, r) {
+    return !i || !r ? e : { ...e, [i]: r };
+  }
+  async function w(e, r = {}) {
+    const { orderBy: s = d, reverse: q = !1, limit: h, offset: b, filter: m } = r;
+    let o = i && e ? t.where(i).equals(e) : t.toCollection();
+    m && (o = o.filter(m));
+    let n = s === d ? await o.toArray() : await o.sortBy(s);
+    return q && (n = n.reverse()), b && (n = n.slice(b)), typeof h == "number" && (n = n.slice(0, h)), n;
+  }
+  return {
+    put: (e, r) => t.put(y(e, r)),
+    bulkPut: (e, r) => t.bulkPut(e.map((s) => y(s, r))),
+    get: (e) => t.get(e),
+    list: w,
+    update: (e, r) => t.update(e, r),
+    updateMany: async (e, r) => {
+      const s = r;
+      return i && e ? t.where(i).equals(e).modify(s) : t.toCollection().modify(s);
+    },
+    delete: (e) => t.delete(e),
+    clear: async (e) => {
+      if (i && e) {
+        await t.where(i).equals(e).delete();
+        return;
+      }
+      await t.clear();
+    },
+    count: (e) => i && e ? t.where(i).equals(e).count() : t.count(),
+    raw: t,
+    db: p
+  };
+}
+export {
+  P as createOfflineStore
+};
+//# sourceMappingURL=create-offline-store.js.map

package/dist/offline/create-offline-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-offline-store.js","sources":["../../src/offline/create-offline-store.ts"],"sourcesContent":["import Dexie, { type Table, type UpdateSpec } from \"dexie\";\n\nexport interface OfflineStoreConfig<TItem> {\n    /** IndexedDB database name. */\n    databaseName: string;\n    /** Schema version. Bump when changing indexes; pair with a migration if needed. */\n    version: number;\n    /** Object-store name. */\n    tableName: string;\n    /**\n     * Dexie index definition for the table. Use `&` for the primary key\n     * (unique), e.g. `\"&id, owner_id, created_at\"`. See Dexie docs for the\n     * full syntax.\n     */\n    indexes: string;\n    /** Property used as the primary key (default: `\"id\"`). */\n    keyPath?: keyof TItem & string;\n    /**\n     * Optional owner scoping. When set, every read/write method honors the\n     * `owner` argument and persists it on each record (e.g. multi-tenant\n     * notifications keyed by `user_id`).\n     */\n    ownerField?: keyof TItem & string;\n}\n\nexport interface ListOptions<TItem> {\n    /** Property to order by. Default: `keyPath`. */\n    orderBy?: keyof TItem & string;\n    /** Reverse the ordering. Default: false. */\n    reverse?: boolean;\n    /** Maximum number of items to return. */\n    limit?: number;\n    /** Skip this many items from the start of the result set. */\n    offset?: number;\n    /** Custom predicate applied after the index query. */\n    filter?: (item: TItem) => boolean;\n}\n\nexport interface OfflineStore<TItem, TKey extends string | number> {\n    /** Insert or replace a record. */\n    put: (item: TItem, owner?: string) => Promise<TKey>;\n    /** Insert or replace multiple records in a single transaction. */\n    bulkPut: (items: TItem[], owner?: string) => Promise<TKey>;\n    /** Fetch one record by its primary key. */\n    get: (key: TKey) => Promise<TItem | undefined>;\n    /** List records, optionally scoped to `owner` when `ownerField` is configured. */\n    list: (owner?: string, options?: ListOptions<TItem>) => Promise<TItem[]>;\n    /** Partial update by primary key. Returns the number of records changed. */\n    update: (key: TKey, changes: Partial<TItem>) => Promise<number>;\n    /** Apply a modification to every record matching `owner`. */\n    updateMany: (owner: string | undefined, changes: Partial<TItem>) => Promise<number>;\n    /** Delete one record by primary key. */\n    delete: (key: TKey) => Promise<void>;\n    /** Delete every record matching `owner` (or the entire table when no scope is set). */\n    clear: (owner?: string) => Promise<void>;\n    /** Count records, optionally scoped to `owner`. */\n    count: (owner?: string) => Promise<number>;\n    /** Raw Dexie table for advanced queries. */\n    raw: Table<TItem, TKey>;\n    /** Underlying Dexie instance. */\n    db: Dexie;\n}\n\nclass GenericDb<TItem, TKey extends string | number> extends Dexie {\n    store!: Table<TItem, TKey>;\n\n    constructor(name: string, version: number, tableName: string, indexes: string) {\n        super(name);\n        this.version(version).stores({ [tableName]: indexes });\n        this.store = this.table<TItem, TKey>(tableName);\n    }\n}\n\n/**\n * Build a typed IndexedDB-backed store using Dexie. Optionally scope every\n * operation by an `ownerField` (useful for multi-user SSE history, drafts,\n * cache per workspace, etc.).\n *\n * Dexie is an **optional peer dependency** — install it (`npm i dexie`) only\n * when your app needs offline storage.\n *\n * @example\n * type Note = { id: string; owner_id: string; text: string; created_at: string };\n * const notes = createOfflineStore<Note, string>({\n *     databaseName: \"TempestNotes\",\n *     version: 1,\n *     tableName: \"notes\",\n *     indexes: \"&id, owner_id, created_at\",\n *     ownerField: \"owner_id\",\n * });\n * await notes.put({ id: \"n1\", owner_id: \"u1\", text: \"hi\", created_at: ... }, \"u1\");\n * const mine = await notes.list(\"u1\", { orderBy: \"created_at\", reverse: true });\n */\nexport function createOfflineStore<TItem, TKey extends string | number = string>(\n    config: OfflineStoreConfig<TItem>,\n): OfflineStore<TItem, TKey> {\n    const { databaseName, version, tableName, indexes, keyPath = \"id\", ownerField } = config;\n\n    const db = new GenericDb<TItem, TKey>(databaseName, version, tableName, indexes);\n    const table = db.store;\n\n    function withOwner(item: TItem, owner?: string): TItem {\n        if (!ownerField || !owner) return item;\n        return { ...item, [ownerField]: owner } as TItem;\n    }\n\n    async function list(owner?: string, options: ListOptions<TItem> = {}): Promise<TItem[]> {\n        const { orderBy = keyPath, reverse = false, limit, offset, filter } = options;\n\n        let collection =\n            ownerField && owner ? table.where(ownerField).equals(owner) : table.toCollection();\n\n        if (filter) collection = collection.filter(filter);\n\n        let items =\n            orderBy === keyPath ? await collection.toArray() : await collection.sortBy(orderBy);\n\n        if (reverse) items = items.reverse();\n        if (offset) items = items.slice(offset);\n        if (typeof limit === \"number\") items = items.slice(0, limit);\n        return items;\n    }\n\n    return {\n        put: (item, owner) => table.put(withOwner(item, owner)) as Promise<TKey>,\n        bulkPut: (items, owner) =>\n            table.bulkPut(items.map((item) => withOwner(item, owner))) as Promise<TKey>,\n        get: (key) => table.get(key),\n        list,\n        update: (key, changes) => table.update(key, changes as UpdateSpec<TItem>),\n        updateMany: async (owner, changes) => {\n            const spec = changes as UpdateSpec<TItem>;\n            if (ownerField && owner) {\n                return table.where(ownerField).equals(owner).modify(spec);\n            }\n            return table.toCollection().modify(spec);\n        },\n        delete: (key) => table.delete(key),\n        clear: async (owner) => {\n            if (ownerField && owner) {\n                await table.where(ownerField).equals(owner).delete();\n                return;\n            }\n            await table.clear();\n        },\n        count: (owner) => {\n            if (ownerField && owner) {\n                return table.where(ownerField).equals(owner).count();\n            }\n            return table.count();\n        },\n        raw: table,\n        db,\n    };\n}\n"],"names":["GenericDb","Dexie","name","version","tableName","indexes","createOfflineStore","config","databaseName","keyPath","ownerField","db","table","withOwner","item","owner","list","options","orderBy","reverse","limit","offset","filter","collection","items","key","changes","spec"],"mappings":";AA+DA,MAAMA,UAAuDC,EAAM;AAAA,EAC/D;AAAA,EAEA,YAAYC,GAAcC,GAAiBC,GAAmBC,GAAiB;AAC3E,UAAMH,CAAI,GACV,KAAK,QAAQC,CAAO,EAAE,OAAO,EAAE,CAACC,CAAS,GAAGC,GAAS,GACrD,KAAK,QAAQ,KAAK,MAAmBD,CAAS;AAAA,EAClD;AACJ;AAsBO,SAASE,EACZC,GACyB;AACzB,QAAM,EAAE,cAAAC,GAAc,SAAAL,GAAS,WAAAC,GAAW,SAAAC,GAAS,SAAAI,IAAU,MAAM,YAAAC,MAAeH,GAE5EI,IAAK,IAAIX,EAAuBQ,GAAcL,GAASC,GAAWC,CAAO,GACzEO,IAAQD,EAAG;AAEjB,WAASE,EAAUC,GAAaC,GAAuB;AACnD,WAAI,CAACL,KAAc,CAACK,IAAcD,IAC3B,EAAE,GAAGA,GAAM,CAACJ,CAAU,GAAGK,EAAA;AAAA,EACpC;AAEA,iBAAeC,EAAKD,GAAgBE,IAA8B,IAAsB;AACpF,UAAM,EAAE,SAAAC,IAAUT,GAAS,SAAAU,IAAU,IAAO,OAAAC,GAAO,QAAAC,GAAQ,QAAAC,MAAWL;AAEtE,QAAIM,IACAb,KAAcK,IAAQH,EAAM,MAAMF,CAAU,EAAE,OAAOK,CAAK,IAAIH,EAAM,aAAA;AAExE,IAAIU,MAAQC,IAAaA,EAAW,OAAOD,CAAM;AAEjD,QAAIE,IACAN,MAAYT,IAAU,MAAMc,EAAW,YAAY,MAAMA,EAAW,OAAOL,CAAO;AAEtF,WAAIC,MAASK,IAAQA,EAAM,QAAA,IACvBH,MAAQG,IAAQA,EAAM,MAAMH,CAAM,IAClC,OAAOD,KAAU,iBAAkBI,EAAM,MAAM,GAAGJ,CAAK,IACpDI;AAAA,EACX;AAEA,SAAO;AAAA,IACH,KAAK,CAACV,GAAMC,MAAUH,EAAM,IAAIC,EAAUC,GAAMC,CAAK,CAAC;AAAA,IACtD,SAAS,CAACS,GAAOT,MACbH,EAAM,QAAQY,EAAM,IAAI,CAACV,MAASD,EAAUC,GAAMC,CAAK,CAAC,CAAC;AAAA,IAC7D,KAAK,CAACU,MAAQb,EAAM,IAAIa,CAAG;AAAA,IAC3B,MAAAT;AAAA,IACA,QAAQ,CAACS,GAAKC,MAAYd,EAAM,OAAOa,GAAKC,CAA4B;AAAA,IACxE,YAAY,OAAOX,GAAOW,MAAY;AAClC,YAAMC,IAAOD;AACb,aAAIhB,KAAcK,IACPH,EAAM,MAAMF,CAAU,EAAE,OAAOK,CAAK,EAAE,OAAOY,CAAI,IAErDf,EAAM,eAAe,OAAOe,CAAI;AAAA,IAC3C;AAAA,IACA,QAAQ,CAACF,MAAQb,EAAM,OAAOa,CAAG;AAAA,IACjC,OAAO,OAAOV,MAAU;AACpB,UAAIL,KAAcK,GAAO;AACrB,cAAMH,EAAM,MAAMF,CAAU,EAAE,OAAOK,CAAK,EAAE,OAAA;AAC5C;AAAA,MACJ;AACA,YAAMH,EAAM,MAAA;AAAA,IAChB;AAAA,IACA,OAAO,CAACG,MACAL,KAAcK,IACPH,EAAM,MAAMF,CAAU,EAAE,OAAOK,CAAK,EAAE,MAAA,IAE1CH,EAAM,MAAA;AAAA,IAEjB,KAAKA;AAAA,IACL,IAAAD;AAAA,EAAA;AAER;"}

package/dist/offline/create-offline-sync.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const A=require("../utils/ids.cjs"),O=require("./create-offline-store.cjs");function q(t){const r=typeof localStorage<"u";return{get:()=>r?localStorage.getItem(t):null,set:o=>{r&&localStorage.setItem(t,o)},clear:()=>{r&&localStorage.removeItem(t)}}}function x(t){const r=O.createOfflineStore({databaseName:t.databaseName,version:t.version??1,tableName:t.tableName??"outbox",indexes:"&id, recordId, enqueuedAt",keyPath:"id"}),o="get"in t.watermark?t.watermark:q(t.watermark.storageKey),b=t.idPrefix??"outbox",h=t.isOnline??(()=>typeof navigator<"u"?navigator.onLine:!0);let d=null;const f=new Set;let l={phase:"idle",pending:0,lastSummary:null,lastError:null,lastSyncedAt:null};const y=t.crossTab===!0,m=t.broadcastChannelName??`tempest-sync:${t.databaseName}`,i=y&&typeof BroadcastChannel<"u"?new BroadcastChannel(m):null;let p=!1;function v(){for(const e of f)e(l)}function w(e){l={...l,...e},v(),i&&!p&&i.postMessage(l)}i&&(i.onmessage=e=>{p||(l=e.data,v())});async function u(){w({pending:await r.count()})}async function k(e){const a=await r.list(void 0,{orderBy:"enqueuedAt"});for(const n of a)try{await t.deliver(n),await r.delete(n.id),await t.onEntryDelivered?.(n),e.succeeded+=1}catch(s){const c=s instanceof Error?s.message:"delivery failed";await r.update(n.id,{attempts:n.attempts+1,lastError:c}),await t.onEntryFailed?.(n,s),e.failed+=1,e.lastError=c}}async function g(){const e=o.get();let a=null,n=e;do{const s=await t.pullPage(e,a);for(const c of s.items)await t.applyRemote(c);a=s.nextCursor,n=s.serverTime}while(a);n&&o.set(n)}async function S(e){const a=Date.now(),n={trigger:e,succeeded:0,failed:0,durationMs:0,skipped:!1,lastError:null};return h()?(await k(n),await g(),n.durationMs=Date.now()-a,n):(n.skipped=!0,n.durationMs=Date.now()-a,n)}async function E(e){const a=typeof navigator<"u"?navigator.locks:void 0;return!y||!a?S(e):await a.request(`${m}:flush`,{ifAvailable:!0},async s=>s?S(e):null)??{trigger:e,succeeded:0,failed:0,durationMs:0,skipped:!1,lastError:null}}return u(),{async enqueue(e,a,n){const s={id:A.randomId(b),op:e,recordId:a,enqueuedAt:Date.now(),attempts:0,payload:n};return await r.put(s),await u(),s.id},flush(e="manual"){return d||(w({phase:"syncing"}),d=E(e).then(async a=>(await u(),w({phase:a.skipped?"offline":a.failed>0?"error":"idle",lastSummary:a,lastError:a.lastError,lastSyncedAt:a.skipped?l.lastSyncedAt:Date.now()}),a)).finally(()=>{d=null})),d},pendingCount(){return r.count()},listPending(){return r.list(void 0,{orderBy:"enqueuedAt"})},async clearOutbox(){await r.clear(),await u()},resetWatermark(){o.clear()},getState(){return l},subscribe(e){return f.add(e),()=>{f.delete(e)}},dispose(){p=!0,i?.close()}}}exports.createOfflineSync=x;
+//# sourceMappingURL=create-offline-sync.cjs.map

package/dist/offline/create-offline-sync.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-offline-sync.cjs","sources":["../../src/offline/create-offline-sync.ts"],"sourcesContent":["import { randomId } from \"../utils/ids\";\nimport { createOfflineStore } from \"./create-offline-store\";\n\n/**\n * Mutation kinds queued in the outbox.\n *\n * `create`/`update` carry a snapshot of the record; `delete` needs only the\n * record id. The distinction between `create` and `update` is advisory — the\n * engine treats both as \"deliver this record\" and leaves the create-vs-update\n * decision to the app's `deliver` callback (a `PUT` upsert usually ignores it).\n */\nexport type OutboxOp = \"create\" | \"update\" | \"delete\";\n\n/**\n * A single queued mutation.\n *\n * @typeParam TPayload - The record snapshot shape carried by\n *   `create`/`update` entries (omitted for `delete`).\n */\nexport interface OutboxEntry<TPayload = unknown> {\n    /** Stable per-entry id (generated with {@link randomId}). */\n    id: string;\n    /** The mutation kind. */\n    op: OutboxOp;\n    /** Primary key of the record the mutation targets. */\n    recordId: string;\n    /** Epoch milliseconds when the mutation was queued. */\n    enqueuedAt: number;\n    /** How many delivery attempts have been made so far. */\n    attempts: number;\n    /** Last delivery error message, kept for UI/debug. */\n    lastError?: string;\n    /** Record snapshot for `create`/`update`. Omitted for `delete`. */\n    payload?: TPayload;\n}\n\n/**\n * Why a sync run was triggered. The listed values are the common ones; any\n * string is accepted so apps can add their own telemetry labels.\n */\nexport type SyncTrigger =\n    | \"boot\"\n    | \"online-event\"\n    | \"after-mutation\"\n    | \"manual\"\n    | \"interval\"\n    | (string & {});\n\n/**\n * One page of the server delta pull.\n *\n * @typeParam TRemote - The server-side item shape.\n */\nexport interface PullPage<TRemote> {\n    /** Items changed since the watermark, in this page. */\n    items: TRemote[];\n    /** Cursor for the next page, or `null` when this is the last page. */\n    nextCursor: string | null;\n    /**\n     * Server clock to persist as the next watermark once the whole delta is\n     * applied. `null` leaves the watermark unchanged.\n     */\n    serverTime: string | null;\n}\n\n/** Outcome of a single {@link OfflineSync.flush} run. */\nexport interface SyncRunSummary {\n    /** The trigger passed to `flush`. */\n    trigger: SyncTrigger;\n    /** Entries delivered to the server this run. */\n    succeeded: number;\n    /** Entries that failed and stay queued for the next run. */\n    failed: number;\n    /** Total wall-clock milliseconds the run took. */\n    durationMs: number;\n    /** `true` when the run was skipped because the device was offline. */\n    skipped: boolean;\n    /** Last delivery error message seen this run, or `null` when none failed. */\n    lastError: string | null;\n}\n\n/**\n * Coarse lifecycle phase of the sync engine, surfaced through\n * {@link OfflineSync.getState} / {@link OfflineSync.subscribe} for reactive UI.\n *\n * - `\"idle\"` — nothing in flight and the last run (if any) fully succeeded.\n * - `\"syncing\"` — a `flush` run is currently in progress.\n * - `\"offline\"` — the last run was skipped because the device was offline.\n * - `\"error\"` — the last run left at least one entry queued after a failure.\n */\nexport type SyncPhase = \"idle\" | \"syncing\" | \"offline\" | \"error\";\n\n/**\n * Immutable snapshot of the engine's reactive state. A fresh object is emitted\n * to subscribers on every change, so it is safe to use as a\n * `useSyncExternalStore` snapshot (reference equality signals \"no change\").\n */\nexport interface SyncState {\n    /** Current lifecycle phase. */\n    phase: SyncPhase;\n    /** Number of mutations still queued in the outbox. */\n    pending: number;\n    /** Summary of the most recent `flush` run, or `null` before the first. */\n    lastSummary: SyncRunSummary | null;\n    /** Message of the most recent delivery failure, or `null`. */\n    lastError: string | null;\n    /** Epoch ms of the last non-skipped run, or `null` before the first. */\n    lastSyncedAt: number | null;\n}\n\n/**\n * Pluggable persistence for the pull watermark (the \"changed since\" cursor).\n * Pass an object with a `storageKey` to use a `localStorage`-backed default.\n */\nexport interface WatermarkStore {\n    /** Read the current watermark, or `null` when none is stored. */\n    get: () => string | null;\n    /** Persist a new watermark. */\n    set: (value: string) => void;\n    /** Drop the watermark (e.g. on logout / account switch). */\n    clear: () => void;\n}\n\n/**\n * Configuration for {@link createOfflineSync}.\n *\n * The engine owns the outbox, the single-flight flush, the offline guard, the\n * paginated pull loop and the watermark; the three transport callbacks\n * (`deliver`, `pullPage`, `applyRemote`) are where the app plugs in its own\n * endpoints, record shape and conflict resolution.\n *\n * @typeParam TPayload - Record snapshot carried by outbox entries.\n * @typeParam TRemote - Server item shape returned by `pullPage`.\n */\nexport interface OfflineSyncConfig<TPayload, TRemote> {\n    /** IndexedDB database name for the outbox (kept separate per queue). */\n    databaseName: string;\n    /** Outbox object-store name. Default `\"outbox\"`. */\n    tableName?: string;\n    /** Outbox schema version. Default `1`. */\n    version?: number;\n    /** Prefix for generated entry ids. Default `\"outbox\"`. */\n    idPrefix?: string;\n    /**\n     * Deliver one queued mutation to the server. Throwing keeps the entry\n     * queued (its `attempts`/`lastError` are bumped) for the next run.\n     */\n    deliver: (entry: OutboxEntry<TPayload>) => Promise<void>;\n    /** Fetch one page of the server delta since `since`, from `cursor`. */\n    pullPage: (since: string | null, cursor: string | null) => Promise<PullPage<TRemote>>;\n    /**\n     * Merge one pulled item into the local store. The app owns conflict\n     * resolution here (e.g. last-write-wins, keeping newer local pending\n     * edits, resolving tombstones and downloading blobs).\n     */\n    applyRemote: (item: TRemote) => Promise<void>;\n    /** Watermark persistence, or `{ storageKey }` for a `localStorage` default. */\n    watermark: WatermarkStore | { storageKey: string };\n    /** Called after an entry is delivered and acked. */\n    onEntryDelivered?: (entry: OutboxEntry<TPayload>) => void | Promise<void>;\n    /** Called after an entry fails delivery (it stays queued). */\n    onEntryFailed?: (entry: OutboxEntry<TPayload>, error: unknown) => void | Promise<void>;\n    /**\n     * Connectivity check. Default reads `navigator.onLine` (always online in\n     * non-browser environments). When it returns `false`, `flush` is skipped.\n     */\n    isOnline?: () => boolean;\n    /**\n     * Broadcast {@link SyncState} across browser tabs of the same origin via a\n     * `BroadcastChannel`, so every tab shows a coherent pending count / phase\n     * (e.g. one tab flushing drops the badge to zero everywhere). The outbox is\n     * already a shared IndexedDB; this only shares the in-memory state. Silently\n     * ignored where `BroadcastChannel` is unavailable. Default `false`.\n     *\n     * When the Web Locks API is available, `flush` is additionally coordinated\n     * *across* tabs: only one tab runs at a time and others skip while the lock\n     * is held (they pick up the result via the broadcast). Delivery should still\n     * be idempotent (upsert by client id). Without Web Locks, `flush` falls back\n     * to per-tab single-flight.\n     */\n    crossTab?: boolean;\n    /** Channel name when `crossTab` is on. Default `tempest-sync:${databaseName}`. */\n    broadcastChannelName?: string;\n}\n\n/**\n * Offline-first sync engine: a durable outbox plus a paginated delta pull.\n *\n * @typeParam TPayload - Record snapshot carried by outbox entries.\n */\nexport interface OfflineSync<TPayload> {\n    /**\n     * Queue a mutation. Returns the generated entry id.\n     *\n     * @param op - The mutation kind.\n     * @param recordId - Primary key of the affected record.\n     * @param payload - Record snapshot (for `create`/`update`).\n     */\n    enqueue: (op: OutboxOp, recordId: string, payload?: TPayload) => Promise<string>;\n    /**\n     * Run a full sync (drain the outbox, then pull the delta). Concurrent\n     * calls share one in-flight promise, so triggers never overlap.\n     *\n     * @param trigger - Label for why the run happened. Default `\"manual\"`.\n     */\n    flush: (trigger?: SyncTrigger) => Promise<SyncRunSummary>;\n    /** Number of mutations still queued. */\n    pendingCount: () => Promise<number>;\n    /** The queued mutations in FIFO order. */\n    listPending: () => Promise<OutboxEntry<TPayload>[]>;\n    /** Drop every queued mutation (e.g. on logout). */\n    clearOutbox: () => Promise<void>;\n    /** Reset the pull watermark (e.g. on logout / account switch). */\n    resetWatermark: () => void;\n    /** Read the current reactive {@link SyncState} snapshot synchronously. */\n    getState: () => SyncState;\n    /**\n     * Subscribe to {@link SyncState} changes. The listener fires on every\n     * enqueue, flush transition and outbox clear.\n     *\n     * @param listener - Called with the new snapshot on each change.\n     * @returns An unsubscribe function.\n     */\n    subscribe: (listener: (state: SyncState) => void) => () => void;\n    /**\n     * Release resources held by the engine — currently the cross-tab\n     * `BroadcastChannel` when `crossTab` is enabled. Safe to call when none was\n     * opened. Optional in long-lived apps (the channel is reclaimed on tab\n     * close); call it in tests and on teardown.\n     */\n    dispose: () => void;\n}\n\n/**\n * Build a `localStorage`-backed {@link WatermarkStore}. Reads/writes are no-ops\n * when `localStorage` is unavailable (SSR / non-browser).\n *\n * @param key - The `localStorage` key.\n * @returns A watermark store persisting to `localStorage`.\n */\nfunction localStorageWatermark(key: string): WatermarkStore {\n    const available = typeof localStorage !== \"undefined\";\n    return {\n        get: () => (available ? localStorage.getItem(key) : null),\n        set: (value: string) => {\n            if (available) localStorage.setItem(key, value);\n        },\n        clear: () => {\n            if (available) localStorage.removeItem(key);\n        },\n    };\n}\n\n/**\n * Create an offline-first sync engine over an IndexedDB outbox.\n *\n * The engine drains queued mutations to the server (`deliver`) and pulls the\n * server delta back (`pullPage` + `applyRemote`), advancing a watermark so each\n * run only fetches what changed. `flush` is single-flight and skips cleanly\n * while offline; failed deliveries stay queued with their attempt count bumped.\n *\n * Dexie is an **optional peer dependency** (via {@link createOfflineStore}) —\n * install it (`npm i dexie`) when you use this engine.\n *\n * @typeParam TPayload - Record snapshot carried by outbox entries.\n * @typeParam TRemote - Server item shape returned by `pullPage`.\n * @param config - Transport callbacks + outbox/watermark configuration.\n * @returns The sync handle (`enqueue`, `flush`, `pendingCount`, …).\n *\n * @example\n * const sync = createOfflineSync<Note, NoteDto>({\n *     databaseName: \"NotesOutbox\",\n *     watermark: { storageKey: \"notes.watermark\" },\n *     deliver: async (entry) => {\n *         if (entry.op === \"delete\") return api.remove(entry.recordId);\n *         await api.upsert(entry.recordId, entry.payload!);\n *     },\n *     pullPage: async (since, cursor) => {\n *         const page = await api.changes(since, cursor);\n *         return { items: page.items, nextCursor: page.next, serverTime: page.now };\n *     },\n *     applyRemote: async (dto) => {\n *         if (dto.deleted) return localStore.remove(dto.id);\n *         await localStore.save(fromDto(dto));\n *     },\n * });\n * await sync.enqueue(\"create\", note.id, note);\n * await sync.flush(\"after-mutation\");\n */\nexport function createOfflineSync<TPayload = unknown, TRemote = unknown>(\n    config: OfflineSyncConfig<TPayload, TRemote>,\n): OfflineSync<TPayload> {\n    const outbox = createOfflineStore<OutboxEntry<TPayload>, string>({\n        databaseName: config.databaseName,\n        version: config.version ?? 1,\n        tableName: config.tableName ?? \"outbox\",\n        indexes: \"&id, recordId, enqueuedAt\",\n        keyPath: \"id\",\n    });\n\n    const watermark: WatermarkStore =\n        \"get\" in config.watermark\n            ? config.watermark\n            : localStorageWatermark(config.watermark.storageKey);\n\n    const idPrefix = config.idPrefix ?? \"outbox\";\n    const isOnline =\n        config.isOnline ?? (() => (typeof navigator !== \"undefined\" ? navigator.onLine : true));\n\n    let inflight: Promise<SyncRunSummary> | null = null;\n\n    const listeners = new Set<(state: SyncState) => void>();\n    let state: SyncState = {\n        phase: \"idle\",\n        pending: 0,\n        lastSummary: null,\n        lastError: null,\n        lastSyncedAt: null,\n    };\n\n    const crossTab = config.crossTab === true;\n    const channelName = config.broadcastChannelName ?? `tempest-sync:${config.databaseName}`;\n    const channel: BroadcastChannel | null =\n        crossTab && typeof BroadcastChannel !== \"undefined\"\n            ? new BroadcastChannel(channelName)\n            : null;\n    let closed = false;\n\n    function notify(): void {\n        for (const listener of listeners) listener(state);\n    }\n\n    function setState(patch: Partial<SyncState>): void {\n        state = { ...state, ...patch };\n        notify();\n        if (channel && !closed) channel.postMessage(state);\n    }\n\n    if (channel) {\n        channel.onmessage = (event: MessageEvent<SyncState>) => {\n            if (closed) return;\n            state = event.data;\n            notify();\n        };\n    }\n\n    async function refreshPending(): Promise<void> {\n        setState({ pending: await outbox.count() });\n    }\n\n    async function push(summary: SyncRunSummary): Promise<void> {\n        const entries = await outbox.list(undefined, { orderBy: \"enqueuedAt\" });\n        for (const entry of entries) {\n            try {\n                await config.deliver(entry);\n                await outbox.delete(entry.id);\n                await config.onEntryDelivered?.(entry);\n                summary.succeeded += 1;\n            } catch (cause) {\n                const message = cause instanceof Error ? cause.message : \"delivery failed\";\n                await outbox.update(entry.id, {\n                    attempts: entry.attempts + 1,\n                    lastError: message,\n                } as Partial<OutboxEntry<TPayload>>);\n                await config.onEntryFailed?.(entry, cause);\n                summary.failed += 1;\n                summary.lastError = message;\n            }\n        }\n    }\n\n    async function pull(): Promise<void> {\n        const since = watermark.get();\n        let cursor: string | null = null;\n        let serverTime: string | null = since;\n        do {\n            const page = await config.pullPage(since, cursor);\n            for (const item of page.items) {\n                await config.applyRemote(item);\n            }\n            cursor = page.nextCursor;\n            serverTime = page.serverTime;\n        } while (cursor);\n        if (serverTime) watermark.set(serverTime);\n    }\n\n    async function runOnce(trigger: SyncTrigger): Promise<SyncRunSummary> {\n        const startedAt = Date.now();\n        const summary: SyncRunSummary = {\n            trigger,\n            succeeded: 0,\n            failed: 0,\n            durationMs: 0,\n            skipped: false,\n            lastError: null,\n        };\n        if (!isOnline()) {\n            summary.skipped = true;\n            summary.durationMs = Date.now() - startedAt;\n            return summary;\n        }\n        await push(summary);\n        await pull();\n        summary.durationMs = Date.now() - startedAt;\n        return summary;\n    }\n\n    /**\n     * Run one sync pass, serialized across tabs when possible.\n     *\n     * With `crossTab` on and the Web Locks API available, the pass is wrapped in\n     * an `ifAvailable` lock request: whichever tab holds the lock runs, and the\n     * others get `null` back instead of duplicating the work — their `SyncState`\n     * catches up through the `BroadcastChannel`. The no-op summary keeps\n     * `skipped: false` on purpose: `skipped` means \"device offline\" (it maps to\n     * `phase: \"offline\"`), which is not what happened here. Falls back to a plain\n     * per-tab run when `crossTab` is off or Web Locks is missing.\n     *\n     * @param trigger - What asked for this run, carried into the summary.\n     * @returns The run summary, or an empty summary when another tab held the lock.\n     */\n    async function runGuarded(trigger: SyncTrigger): Promise<SyncRunSummary> {\n        const locks = typeof navigator !== \"undefined\" ? navigator.locks : undefined;\n        if (!crossTab || !locks) return runOnce(trigger);\n        const result = await locks.request(\n            `${channelName}:flush`,\n            { ifAvailable: true },\n            async (lock) => (lock ? runOnce(trigger) : null),\n        );\n        return (\n            result ?? {\n                trigger,\n                succeeded: 0,\n                failed: 0,\n                durationMs: 0,\n                skipped: false,\n                lastError: null,\n            }\n        );\n    }\n\n    void refreshPending();\n\n    return {\n        async enqueue(op, recordId, payload) {\n            const entry: OutboxEntry<TPayload> = {\n                id: randomId(idPrefix),\n                op,\n                recordId,\n                enqueuedAt: Date.now(),\n                attempts: 0,\n                payload,\n            };\n            await outbox.put(entry);\n            await refreshPending();\n            return entry.id;\n        },\n        flush(trigger: SyncTrigger = \"manual\") {\n            if (!inflight) {\n                setState({ phase: \"syncing\" });\n                inflight = runGuarded(trigger)\n                    .then(async (summary) => {\n                        await refreshPending();\n                        setState({\n                            phase: summary.skipped\n                                ? \"offline\"\n                                : summary.failed > 0\n                                  ? \"error\"\n                                  : \"idle\",\n                            lastSummary: summary,\n                            lastError: summary.lastError,\n                            lastSyncedAt: summary.skipped ? state.lastSyncedAt : Date.now(),\n                        });\n                        return summary;\n                    })\n                    .finally(() => {\n                        inflight = null;\n                    });\n            }\n            return inflight;\n        },\n        pendingCount() {\n            return outbox.count();\n        },\n        listPending() {\n            return outbox.list(undefined, { orderBy: \"enqueuedAt\" });\n        },\n        async clearOutbox() {\n            await outbox.clear();\n            await refreshPending();\n        },\n        resetWatermark() {\n            watermark.clear();\n        },\n        getState() {\n            return state;\n        },\n        subscribe(listener) {\n            listeners.add(listener);\n            return () => {\n                listeners.delete(listener);\n            };\n        },\n        dispose() {\n            closed = true;\n            channel?.close();\n        },\n    };\n}\n"],"names":["localStorageWatermark","key","available","value","createOfflineSync","config","outbox","createOfflineStore","watermark","idPrefix","isOnline","inflight","listeners","state","crossTab","channelName","channel","closed","notify","listener","setState","patch","event","refreshPending","push","summary","entries","entry","cause","message","pull","since","cursor","serverTime","page","item","runOnce","trigger","startedAt","runGuarded","locks","lock","op","recordId","payload","randomId"],"mappings":"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"}

package/dist/offline/create-offline-sync.js

@@ -0,0 +1,146 @@
+import { randomId as x } from "../utils/ids.js";
+import { createOfflineStore as A } from "./create-offline-store.js";
+function N(t) {
+  const r = typeof localStorage < "u";
+  return {
+    get: () => r ? localStorage.getItem(t) : null,
+    set: (o) => {
+      r && localStorage.setItem(t, o);
+    },
+    clear: () => {
+      r && localStorage.removeItem(t);
+    }
+  };
+}
+function O(t) {
+  const r = A({
+    databaseName: t.databaseName,
+    version: t.version ?? 1,
+    tableName: t.tableName ?? "outbox",
+    indexes: "&id, recordId, enqueuedAt",
+    keyPath: "id"
+  }), o = "get" in t.watermark ? t.watermark : N(t.watermark.storageKey), b = t.idPrefix ?? "outbox", S = t.isOnline ?? (() => typeof navigator < "u" ? navigator.onLine : !0);
+  let d = null;
+  const f = /* @__PURE__ */ new Set();
+  let l = {
+    phase: "idle",
+    pending: 0,
+    lastSummary: null,
+    lastError: null,
+    lastSyncedAt: null
+  };
+  const m = t.crossTab === !0, y = t.broadcastChannelName ?? `tempest-sync:${t.databaseName}`, i = m && typeof BroadcastChannel < "u" ? new BroadcastChannel(y) : null;
+  let p = !1;
+  function v() {
+    for (const e of f) e(l);
+  }
+  function w(e) {
+    l = { ...l, ...e }, v(), i && !p && i.postMessage(l);
+  }
+  i && (i.onmessage = (e) => {
+    p || (l = e.data, v());
+  });
+  async function u() {
+    w({ pending: await r.count() });
+  }
+  async function k(e) {
+    const a = await r.list(void 0, { orderBy: "enqueuedAt" });
+    for (const n of a)
+      try {
+        await t.deliver(n), await r.delete(n.id), await t.onEntryDelivered?.(n), e.succeeded += 1;
+      } catch (s) {
+        const c = s instanceof Error ? s.message : "delivery failed";
+        await r.update(n.id, {
+          attempts: n.attempts + 1,
+          lastError: c
+        }), await t.onEntryFailed?.(n, s), e.failed += 1, e.lastError = c;
+      }
+  }
+  async function E() {
+    const e = o.get();
+    let a = null, n = e;
+    do {
+      const s = await t.pullPage(e, a);
+      for (const c of s.items)
+        await t.applyRemote(c);
+      a = s.nextCursor, n = s.serverTime;
+    } while (a);
+    n && o.set(n);
+  }
+  async function h(e) {
+    const a = Date.now(), n = {
+      trigger: e,
+      succeeded: 0,
+      failed: 0,
+      durationMs: 0,
+      skipped: !1,
+      lastError: null
+    };
+    return S() ? (await k(n), await E(), n.durationMs = Date.now() - a, n) : (n.skipped = !0, n.durationMs = Date.now() - a, n);
+  }
+  async function g(e) {
+    const a = typeof navigator < "u" ? navigator.locks : void 0;
+    return !m || !a ? h(e) : await a.request(
+      `${y}:flush`,
+      { ifAvailable: !0 },
+      async (s) => s ? h(e) : null
+    ) ?? {
+      trigger: e,
+      succeeded: 0,
+      failed: 0,
+      durationMs: 0,
+      skipped: !1,
+      lastError: null
+    };
+  }
+  return u(), {
+    async enqueue(e, a, n) {
+      const s = {
+        id: x(b),
+        op: e,
+        recordId: a,
+        enqueuedAt: Date.now(),
+        attempts: 0,
+        payload: n
+      };
+      return await r.put(s), await u(), s.id;
+    },
+    flush(e = "manual") {
+      return d || (w({ phase: "syncing" }), d = g(e).then(async (a) => (await u(), w({
+        phase: a.skipped ? "offline" : a.failed > 0 ? "error" : "idle",
+        lastSummary: a,
+        lastError: a.lastError,
+        lastSyncedAt: a.skipped ? l.lastSyncedAt : Date.now()
+      }), a)).finally(() => {
+        d = null;
+      })), d;
+    },
+    pendingCount() {
+      return r.count();
+    },
+    listPending() {
+      return r.list(void 0, { orderBy: "enqueuedAt" });
+    },
+    async clearOutbox() {
+      await r.clear(), await u();
+    },
+    resetWatermark() {
+      o.clear();
+    },
+    getState() {
+      return l;
+    },
+    subscribe(e) {
+      return f.add(e), () => {
+        f.delete(e);
+      };
+    },
+    dispose() {
+      p = !0, i?.close();
+    }
+  };
+}
+export {
+  O as createOfflineSync
+};
+//# sourceMappingURL=create-offline-sync.js.map

package/dist/offline/create-offline-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-offline-sync.js","sources":["../../src/offline/create-offline-sync.ts"],"sourcesContent":["import { randomId } from \"../utils/ids\";\nimport { createOfflineStore } from \"./create-offline-store\";\n\n/**\n * Mutation kinds queued in the outbox.\n *\n * `create`/`update` carry a snapshot of the record; `delete` needs only the\n * record id. The distinction between `create` and `update` is advisory — the\n * engine treats both as \"deliver this record\" and leaves the create-vs-update\n * decision to the app's `deliver` callback (a `PUT` upsert usually ignores it).\n */\nexport type OutboxOp = \"create\" | \"update\" | \"delete\";\n\n/**\n * A single queued mutation.\n *\n * @typeParam TPayload - The record snapshot shape carried by\n *   `create`/`update` entries (omitted for `delete`).\n */\nexport interface OutboxEntry<TPayload = unknown> {\n    /** Stable per-entry id (generated with {@link randomId}). */\n    id: string;\n    /** The mutation kind. */\n    op: OutboxOp;\n    /** Primary key of the record the mutation targets. */\n    recordId: string;\n    /** Epoch milliseconds when the mutation was queued. */\n    enqueuedAt: number;\n    /** How many delivery attempts have been made so far. */\n    attempts: number;\n    /** Last delivery error message, kept for UI/debug. */\n    lastError?: string;\n    /** Record snapshot for `create`/`update`. Omitted for `delete`. */\n    payload?: TPayload;\n}\n\n/**\n * Why a sync run was triggered. The listed values are the common ones; any\n * string is accepted so apps can add their own telemetry labels.\n */\nexport type SyncTrigger =\n    | \"boot\"\n    | \"online-event\"\n    | \"after-mutation\"\n    | \"manual\"\n    | \"interval\"\n    | (string & {});\n\n/**\n * One page of the server delta pull.\n *\n * @typeParam TRemote - The server-side item shape.\n */\nexport interface PullPage<TRemote> {\n    /** Items changed since the watermark, in this page. */\n    items: TRemote[];\n    /** Cursor for the next page, or `null` when this is the last page. */\n    nextCursor: string | null;\n    /**\n     * Server clock to persist as the next watermark once the whole delta is\n     * applied. `null` leaves the watermark unchanged.\n     */\n    serverTime: string | null;\n}\n\n/** Outcome of a single {@link OfflineSync.flush} run. */\nexport interface SyncRunSummary {\n    /** The trigger passed to `flush`. */\n    trigger: SyncTrigger;\n    /** Entries delivered to the server this run. */\n    succeeded: number;\n    /** Entries that failed and stay queued for the next run. */\n    failed: number;\n    /** Total wall-clock milliseconds the run took. */\n    durationMs: number;\n    /** `true` when the run was skipped because the device was offline. */\n    skipped: boolean;\n    /** Last delivery error message seen this run, or `null` when none failed. */\n    lastError: string | null;\n}\n\n/**\n * Coarse lifecycle phase of the sync engine, surfaced through\n * {@link OfflineSync.getState} / {@link OfflineSync.subscribe} for reactive UI.\n *\n * - `\"idle\"` — nothing in flight and the last run (if any) fully succeeded.\n * - `\"syncing\"` — a `flush` run is currently in progress.\n * - `\"offline\"` — the last run was skipped because the device was offline.\n * - `\"error\"` — the last run left at least one entry queued after a failure.\n */\nexport type SyncPhase = \"idle\" | \"syncing\" | \"offline\" | \"error\";\n\n/**\n * Immutable snapshot of the engine's reactive state. A fresh object is emitted\n * to subscribers on every change, so it is safe to use as a\n * `useSyncExternalStore` snapshot (reference equality signals \"no change\").\n */\nexport interface SyncState {\n    /** Current lifecycle phase. */\n    phase: SyncPhase;\n    /** Number of mutations still queued in the outbox. */\n    pending: number;\n    /** Summary of the most recent `flush` run, or `null` before the first. */\n    lastSummary: SyncRunSummary | null;\n    /** Message of the most recent delivery failure, or `null`. */\n    lastError: string | null;\n    /** Epoch ms of the last non-skipped run, or `null` before the first. */\n    lastSyncedAt: number | null;\n}\n\n/**\n * Pluggable persistence for the pull watermark (the \"changed since\" cursor).\n * Pass an object with a `storageKey` to use a `localStorage`-backed default.\n */\nexport interface WatermarkStore {\n    /** Read the current watermark, or `null` when none is stored. */\n    get: () => string | null;\n    /** Persist a new watermark. */\n    set: (value: string) => void;\n    /** Drop the watermark (e.g. on logout / account switch). */\n    clear: () => void;\n}\n\n/**\n * Configuration for {@link createOfflineSync}.\n *\n * The engine owns the outbox, the single-flight flush, the offline guard, the\n * paginated pull loop and the watermark; the three transport callbacks\n * (`deliver`, `pullPage`, `applyRemote`) are where the app plugs in its own\n * endpoints, record shape and conflict resolution.\n *\n * @typeParam TPayload - Record snapshot carried by outbox entries.\n * @typeParam TRemote - Server item shape returned by `pullPage`.\n */\nexport interface OfflineSyncConfig<TPayload, TRemote> {\n    /** IndexedDB database name for the outbox (kept separate per queue). */\n    databaseName: string;\n    /** Outbox object-store name. Default `\"outbox\"`. */\n    tableName?: string;\n    /** Outbox schema version. Default `1`. */\n    version?: number;\n    /** Prefix for generated entry ids. Default `\"outbox\"`. */\n    idPrefix?: string;\n    /**\n     * Deliver one queued mutation to the server. Throwing keeps the entry\n     * queued (its `attempts`/`lastError` are bumped) for the next run.\n     */\n    deliver: (entry: OutboxEntry<TPayload>) => Promise<void>;\n    /** Fetch one page of the server delta since `since`, from `cursor`. */\n    pullPage: (since: string | null, cursor: string | null) => Promise<PullPage<TRemote>>;\n    /**\n     * Merge one pulled item into the local store. The app owns conflict\n     * resolution here (e.g. last-write-wins, keeping newer local pending\n     * edits, resolving tombstones and downloading blobs).\n     */\n    applyRemote: (item: TRemote) => Promise<void>;\n    /** Watermark persistence, or `{ storageKey }` for a `localStorage` default. */\n    watermark: WatermarkStore | { storageKey: string };\n    /** Called after an entry is delivered and acked. */\n    onEntryDelivered?: (entry: OutboxEntry<TPayload>) => void | Promise<void>;\n    /** Called after an entry fails delivery (it stays queued). */\n    onEntryFailed?: (entry: OutboxEntry<TPayload>, error: unknown) => void | Promise<void>;\n    /**\n     * Connectivity check. Default reads `navigator.onLine` (always online in\n     * non-browser environments). When it returns `false`, `flush` is skipped.\n     */\n    isOnline?: () => boolean;\n    /**\n     * Broadcast {@link SyncState} across browser tabs of the same origin via a\n     * `BroadcastChannel`, so every tab shows a coherent pending count / phase\n     * (e.g. one tab flushing drops the badge to zero everywhere). The outbox is\n     * already a shared IndexedDB; this only shares the in-memory state. Silently\n     * ignored where `BroadcastChannel` is unavailable. Default `false`.\n     *\n     * When the Web Locks API is available, `flush` is additionally coordinated\n     * *across* tabs: only one tab runs at a time and others skip while the lock\n     * is held (they pick up the result via the broadcast). Delivery should still\n     * be idempotent (upsert by client id). Without Web Locks, `flush` falls back\n     * to per-tab single-flight.\n     */\n    crossTab?: boolean;\n    /** Channel name when `crossTab` is on. Default `tempest-sync:${databaseName}`. */\n    broadcastChannelName?: string;\n}\n\n/**\n * Offline-first sync engine: a durable outbox plus a paginated delta pull.\n *\n * @typeParam TPayload - Record snapshot carried by outbox entries.\n */\nexport interface OfflineSync<TPayload> {\n    /**\n     * Queue a mutation. Returns the generated entry id.\n     *\n     * @param op - The mutation kind.\n     * @param recordId - Primary key of the affected record.\n     * @param payload - Record snapshot (for `create`/`update`).\n     */\n    enqueue: (op: OutboxOp, recordId: string, payload?: TPayload) => Promise<string>;\n    /**\n     * Run a full sync (drain the outbox, then pull the delta). Concurrent\n     * calls share one in-flight promise, so triggers never overlap.\n     *\n     * @param trigger - Label for why the run happened. Default `\"manual\"`.\n     */\n    flush: (trigger?: SyncTrigger) => Promise<SyncRunSummary>;\n    /** Number of mutations still queued. */\n    pendingCount: () => Promise<number>;\n    /** The queued mutations in FIFO order. */\n    listPending: () => Promise<OutboxEntry<TPayload>[]>;\n    /** Drop every queued mutation (e.g. on logout). */\n    clearOutbox: () => Promise<void>;\n    /** Reset the pull watermark (e.g. on logout / account switch). */\n    resetWatermark: () => void;\n    /** Read the current reactive {@link SyncState} snapshot synchronously. */\n    getState: () => SyncState;\n    /**\n     * Subscribe to {@link SyncState} changes. The listener fires on every\n     * enqueue, flush transition and outbox clear.\n     *\n     * @param listener - Called with the new snapshot on each change.\n     * @returns An unsubscribe function.\n     */\n    subscribe: (listener: (state: SyncState) => void) => () => void;\n    /**\n     * Release resources held by the engine — currently the cross-tab\n     * `BroadcastChannel` when `crossTab` is enabled. Safe to call when none was\n     * opened. Optional in long-lived apps (the channel is reclaimed on tab\n     * close); call it in tests and on teardown.\n     */\n    dispose: () => void;\n}\n\n/**\n * Build a `localStorage`-backed {@link WatermarkStore}. Reads/writes are no-ops\n * when `localStorage` is unavailable (SSR / non-browser).\n *\n * @param key - The `localStorage` key.\n * @returns A watermark store persisting to `localStorage`.\n */\nfunction localStorageWatermark(key: string): WatermarkStore {\n    const available = typeof localStorage !== \"undefined\";\n    return {\n        get: () => (available ? localStorage.getItem(key) : null),\n        set: (value: string) => {\n            if (available) localStorage.setItem(key, value);\n        },\n        clear: () => {\n            if (available) localStorage.removeItem(key);\n        },\n    };\n}\n\n/**\n * Create an offline-first sync engine over an IndexedDB outbox.\n *\n * The engine drains queued mutations to the server (`deliver`) and pulls the\n * server delta back (`pullPage` + `applyRemote`), advancing a watermark so each\n * run only fetches what changed. `flush` is single-flight and skips cleanly\n * while offline; failed deliveries stay queued with their attempt count bumped.\n *\n * Dexie is an **optional peer dependency** (via {@link createOfflineStore}) —\n * install it (`npm i dexie`) when you use this engine.\n *\n * @typeParam TPayload - Record snapshot carried by outbox entries.\n * @typeParam TRemote - Server item shape returned by `pullPage`.\n * @param config - Transport callbacks + outbox/watermark configuration.\n * @returns The sync handle (`enqueue`, `flush`, `pendingCount`, …).\n *\n * @example\n * const sync = createOfflineSync<Note, NoteDto>({\n *     databaseName: \"NotesOutbox\",\n *     watermark: { storageKey: \"notes.watermark\" },\n *     deliver: async (entry) => {\n *         if (entry.op === \"delete\") return api.remove(entry.recordId);\n *         await api.upsert(entry.recordId, entry.payload!);\n *     },\n *     pullPage: async (since, cursor) => {\n *         const page = await api.changes(since, cursor);\n *         return { items: page.items, nextCursor: page.next, serverTime: page.now };\n *     },\n *     applyRemote: async (dto) => {\n *         if (dto.deleted) return localStore.remove(dto.id);\n *         await localStore.save(fromDto(dto));\n *     },\n * });\n * await sync.enqueue(\"create\", note.id, note);\n * await sync.flush(\"after-mutation\");\n */\nexport function createOfflineSync<TPayload = unknown, TRemote = unknown>(\n    config: OfflineSyncConfig<TPayload, TRemote>,\n): OfflineSync<TPayload> {\n    const outbox = createOfflineStore<OutboxEntry<TPayload>, string>({\n        databaseName: config.databaseName,\n        version: config.version ?? 1,\n        tableName: config.tableName ?? \"outbox\",\n        indexes: \"&id, recordId, enqueuedAt\",\n        keyPath: \"id\",\n    });\n\n    const watermark: WatermarkStore =\n        \"get\" in config.watermark\n            ? config.watermark\n            : localStorageWatermark(config.watermark.storageKey);\n\n    const idPrefix = config.idPrefix ?? \"outbox\";\n    const isOnline =\n        config.isOnline ?? (() => (typeof navigator !== \"undefined\" ? navigator.onLine : true));\n\n    let inflight: Promise<SyncRunSummary> | null = null;\n\n    const listeners = new Set<(state: SyncState) => void>();\n    let state: SyncState = {\n        phase: \"idle\",\n        pending: 0,\n        lastSummary: null,\n        lastError: null,\n        lastSyncedAt: null,\n    };\n\n    const crossTab = config.crossTab === true;\n    const channelName = config.broadcastChannelName ?? `tempest-sync:${config.databaseName}`;\n    const channel: BroadcastChannel | null =\n        crossTab && typeof BroadcastChannel !== \"undefined\"\n            ? new BroadcastChannel(channelName)\n            : null;\n    let closed = false;\n\n    function notify(): void {\n        for (const listener of listeners) listener(state);\n    }\n\n    function setState(patch: Partial<SyncState>): void {\n        state = { ...state, ...patch };\n        notify();\n        if (channel && !closed) channel.postMessage(state);\n    }\n\n    if (channel) {\n        channel.onmessage = (event: MessageEvent<SyncState>) => {\n            if (closed) return;\n            state = event.data;\n            notify();\n        };\n    }\n\n    async function refreshPending(): Promise<void> {\n        setState({ pending: await outbox.count() });\n    }\n\n    async function push(summary: SyncRunSummary): Promise<void> {\n        const entries = await outbox.list(undefined, { orderBy: \"enqueuedAt\" });\n        for (const entry of entries) {\n            try {\n                await config.deliver(entry);\n                await outbox.delete(entry.id);\n                await config.onEntryDelivered?.(entry);\n                summary.succeeded += 1;\n            } catch (cause) {\n                const message = cause instanceof Error ? cause.message : \"delivery failed\";\n                await outbox.update(entry.id, {\n                    attempts: entry.attempts + 1,\n                    lastError: message,\n                } as Partial<OutboxEntry<TPayload>>);\n                await config.onEntryFailed?.(entry, cause);\n                summary.failed += 1;\n                summary.lastError = message;\n            }\n        }\n    }\n\n    async function pull(): Promise<void> {\n        const since = watermark.get();\n        let cursor: string | null = null;\n        let serverTime: string | null = since;\n        do {\n            const page = await config.pullPage(since, cursor);\n            for (const item of page.items) {\n                await config.applyRemote(item);\n            }\n            cursor = page.nextCursor;\n            serverTime = page.serverTime;\n        } while (cursor);\n        if (serverTime) watermark.set(serverTime);\n    }\n\n    async function runOnce(trigger: SyncTrigger): Promise<SyncRunSummary> {\n        const startedAt = Date.now();\n        const summary: SyncRunSummary = {\n            trigger,\n            succeeded: 0,\n            failed: 0,\n            durationMs: 0,\n            skipped: false,\n            lastError: null,\n        };\n        if (!isOnline()) {\n            summary.skipped = true;\n            summary.durationMs = Date.now() - startedAt;\n            return summary;\n        }\n        await push(summary);\n        await pull();\n        summary.durationMs = Date.now() - startedAt;\n        return summary;\n    }\n\n    /**\n     * Run one sync pass, serialized across tabs when possible.\n     *\n     * With `crossTab` on and the Web Locks API available, the pass is wrapped in\n     * an `ifAvailable` lock request: whichever tab holds the lock runs, and the\n     * others get `null` back instead of duplicating the work — their `SyncState`\n     * catches up through the `BroadcastChannel`. The no-op summary keeps\n     * `skipped: false` on purpose: `skipped` means \"device offline\" (it maps to\n     * `phase: \"offline\"`), which is not what happened here. Falls back to a plain\n     * per-tab run when `crossTab` is off or Web Locks is missing.\n     *\n     * @param trigger - What asked for this run, carried into the summary.\n     * @returns The run summary, or an empty summary when another tab held the lock.\n     */\n    async function runGuarded(trigger: SyncTrigger): Promise<SyncRunSummary> {\n        const locks = typeof navigator !== \"undefined\" ? navigator.locks : undefined;\n        if (!crossTab || !locks) return runOnce(trigger);\n        const result = await locks.request(\n            `${channelName}:flush`,\n            { ifAvailable: true },\n            async (lock) => (lock ? runOnce(trigger) : null),\n        );\n        return (\n            result ?? {\n                trigger,\n                succeeded: 0,\n                failed: 0,\n                durationMs: 0,\n                skipped: false,\n                lastError: null,\n            }\n        );\n    }\n\n    void refreshPending();\n\n    return {\n        async enqueue(op, recordId, payload) {\n            const entry: OutboxEntry<TPayload> = {\n                id: randomId(idPrefix),\n                op,\n                recordId,\n                enqueuedAt: Date.now(),\n                attempts: 0,\n                payload,\n            };\n            await outbox.put(entry);\n            await refreshPending();\n            return entry.id;\n        },\n        flush(trigger: SyncTrigger = \"manual\") {\n            if (!inflight) {\n                setState({ phase: \"syncing\" });\n                inflight = runGuarded(trigger)\n                    .then(async (summary) => {\n                        await refreshPending();\n                        setState({\n                            phase: summary.skipped\n                                ? \"offline\"\n                                : summary.failed > 0\n                                  ? \"error\"\n                                  : \"idle\",\n                            lastSummary: summary,\n                            lastError: summary.lastError,\n                            lastSyncedAt: summary.skipped ? state.lastSyncedAt : Date.now(),\n                        });\n                        return summary;\n                    })\n                    .finally(() => {\n                        inflight = null;\n                    });\n            }\n            return inflight;\n        },\n        pendingCount() {\n            return outbox.count();\n        },\n        listPending() {\n            return outbox.list(undefined, { orderBy: \"enqueuedAt\" });\n        },\n        async clearOutbox() {\n            await outbox.clear();\n            await refreshPending();\n        },\n        resetWatermark() {\n            watermark.clear();\n        },\n        getState() {\n            return state;\n        },\n        subscribe(listener) {\n            listeners.add(listener);\n            return () => {\n                listeners.delete(listener);\n            };\n        },\n        dispose() {\n            closed = true;\n            channel?.close();\n        },\n    };\n}\n"],"names":["localStorageWatermark","key","available","value","createOfflineSync","config","outbox","createOfflineStore","watermark","idPrefix","isOnline","inflight","listeners","state","crossTab","channelName","channel","closed","notify","listener","setState","patch","event","refreshPending","push","summary","entries","entry","cause","message","pull","since","cursor","serverTime","page","item","runOnce","trigger","startedAt","runGuarded","locks","lock","op","recordId","payload","randomId"],"mappings":"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"}

package/dist/offline/use-offline-sync.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("react");function l(e,n={}){const{flushOnMount:o=!1,flushOnOnline:f=!0,intervalMs:u=0}=n,s=t.useSyncExternalStore(e.subscribe,e.getState,e.getState),r=t.useRef(e.flush);return r.current=e.flush,t.useEffect(()=>{o&&r.current("boot")},[o]),t.useEffect(()=>{if(!f||typeof window>"u")return;const i=()=>{r.current("online-event")};return window.addEventListener("online",i),()=>window.removeEventListener("online",i)},[f]),t.useEffect(()=>{if(u<=0||typeof window>"u")return;const i=window.setInterval(()=>{r.current("interval")},u);return()=>window.clearInterval(i)},[u]),{...s,syncing:s.phase==="syncing",enqueue:e.enqueue,flush:e.flush}}function a(e){return e.phase==="syncing"?"syncing":e.phase==="offline"?"offline":e.phase==="error"?"error":e.pending>0?"pending":"idle"}function c(e){const n=t.useSyncExternalStore(e.subscribe,e.getState,e.getState);return{tone:a(n),pending:n.pending,syncing:n.phase==="syncing",offline:n.phase==="offline",lastError:n.lastError}}exports.useOfflineSync=l;exports.useSyncStatus=c;
+//# sourceMappingURL=use-offline-sync.cjs.map

package/dist/offline/use-offline-sync.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-offline-sync.cjs","sources":["../../src/offline/use-offline-sync.ts"],"sourcesContent":["import { useEffect, useRef, useSyncExternalStore } from \"react\";\nimport type {\n    OfflineSync,\n    OutboxOp,\n    SyncRunSummary,\n    SyncState,\n    SyncTrigger,\n} from \"./create-offline-sync\";\n\n/**\n * Options for {@link useOfflineSync}. All auto-flush triggers are opt-in except\n * `flushOnOnline`, which defaults to `true` so the app catches up the moment\n * connectivity returns.\n */\nexport interface UseOfflineSyncOptions {\n    /** Flush once when the component mounts (trigger `\"boot\"`). Default `false`. */\n    flushOnMount?: boolean;\n    /**\n     * Flush when the browser fires the `online` event (trigger\n     * `\"online-event\"`). Default `true`.\n     */\n    flushOnOnline?: boolean;\n    /**\n     * Flush on this interval in milliseconds (trigger `\"interval\"`). `0`\n     * disables the timer. Default `0`.\n     */\n    intervalMs?: number;\n}\n\n/**\n * Reactive view of an {@link OfflineSync} engine, plus its imperative actions.\n * Extends {@link SyncState} so `phase`, `pending`, `lastSummary`, `lastError`\n * and `lastSyncedAt` are read directly off the result.\n *\n * @typeParam TPayload - Record snapshot carried by outbox entries.\n */\nexport interface UseOfflineSyncResult<TPayload> extends SyncState {\n    /** `true` while a flush run is in progress (`phase === \"syncing\"`). */\n    syncing: boolean;\n    /** Queue a mutation. Mirrors {@link OfflineSync.enqueue}. */\n    enqueue: (op: OutboxOp, recordId: string, payload?: TPayload) => Promise<string>;\n    /** Trigger a flush run. Mirrors {@link OfflineSync.flush}. */\n    flush: (trigger?: SyncTrigger) => Promise<SyncRunSummary>;\n}\n\n/**\n * Subscribe a React component to an {@link OfflineSync} engine.\n *\n * Re-renders whenever the engine's {@link SyncState} changes (enqueue, flush\n * transition, outbox clear) via `useSyncExternalStore`, and optionally wires\n * auto-flush on mount, on the `online` event and on an interval. The engine\n * itself is created once by the app and passed in — the hook never owns it, so\n * multiple components can observe the same queue.\n *\n * @typeParam TPayload - Record snapshot carried by outbox entries.\n * @param sync - The engine returned by `createOfflineSync`.\n * @param options - Auto-flush triggers.\n * @returns The reactive state merged with `enqueue`/`flush` actions.\n *\n * @example\n * const { pending, syncing, phase, flush } = useOfflineSync(notesSync, {\n *     flushOnMount: true,\n *     intervalMs: 30_000,\n * });\n * return <SyncStatusBadge pending={pending} syncing={syncing} phase={phase} />;\n */\nexport function useOfflineSync<TPayload>(\n    sync: OfflineSync<TPayload>,\n    options: UseOfflineSyncOptions = {},\n): UseOfflineSyncResult<TPayload> {\n    const { flushOnMount = false, flushOnOnline = true, intervalMs = 0 } = options;\n\n    const state = useSyncExternalStore(sync.subscribe, sync.getState, sync.getState);\n\n    const flushRef = useRef(sync.flush);\n    flushRef.current = sync.flush;\n\n    useEffect(() => {\n        if (flushOnMount) void flushRef.current(\"boot\");\n    }, [flushOnMount]);\n\n    useEffect(() => {\n        if (!flushOnOnline || typeof window === \"undefined\") return;\n        const handleOnline = (): void => {\n            void flushRef.current(\"online-event\");\n        };\n        window.addEventListener(\"online\", handleOnline);\n        return () => window.removeEventListener(\"online\", handleOnline);\n    }, [flushOnOnline]);\n\n    useEffect(() => {\n        if (intervalMs <= 0 || typeof window === \"undefined\") return;\n        const id = window.setInterval(() => {\n            void flushRef.current(\"interval\");\n        }, intervalMs);\n        return () => window.clearInterval(id);\n    }, [intervalMs]);\n\n    return {\n        ...state,\n        syncing: state.phase === \"syncing\",\n        enqueue: sync.enqueue,\n        flush: sync.flush,\n    };\n}\n\n/**\n * Presentation-ready tone for a sync status indicator. Collapses the engine's\n * {@link SyncState} into the single most relevant signal for a badge/pill.\n */\nexport type SyncTone = \"idle\" | \"syncing\" | \"pending\" | \"offline\" | \"error\";\n\n/**\n * Compact status snapshot for a status badge/pill. Prefer this over\n * {@link useOfflineSync} when a component only needs to *display* status and\n * does not trigger flushes itself.\n */\nexport interface SyncStatus {\n    /** The dominant tone to render. */\n    tone: SyncTone;\n    /** Number of mutations still queued. */\n    pending: number;\n    /** `true` while a flush run is in progress. */\n    syncing: boolean;\n    /** `true` when the last run was skipped for being offline. */\n    offline: boolean;\n    /** Message of the most recent delivery failure, or `null`. */\n    lastError: string | null;\n}\n\n/**\n * Derive the dominant {@link SyncTone} from an engine snapshot.\n *\n * Precedence: syncing → offline → error → pending → idle. `syncing` wins so an\n * in-flight run always reads as active even while entries remain queued.\n *\n * @param state - The engine {@link SyncState}.\n * @returns The tone to render.\n */\nfunction toneFromState(state: SyncState): SyncTone {\n    if (state.phase === \"syncing\") return \"syncing\";\n    if (state.phase === \"offline\") return \"offline\";\n    if (state.phase === \"error\") return \"error\";\n    if (state.pending > 0) return \"pending\";\n    return \"idle\";\n}\n\n/**\n * Subscribe to an {@link OfflineSync} engine and return a display-only\n * {@link SyncStatus}. A thin read-only companion to {@link useOfflineSync},\n * intended to feed a `<SyncStatusBadge>` without exposing flush actions.\n *\n * @typeParam TPayload - Record snapshot carried by outbox entries.\n * @param sync - The engine returned by `createOfflineSync`.\n * @returns The compact status snapshot.\n */\nexport function useSyncStatus<TPayload>(sync: OfflineSync<TPayload>): SyncStatus {\n    const state = useSyncExternalStore(sync.subscribe, sync.getState, sync.getState);\n    return {\n        tone: toneFromState(state),\n        pending: state.pending,\n        syncing: state.phase === \"syncing\",\n        offline: state.phase === \"offline\",\n        lastError: state.lastError,\n    };\n}\n"],"names":["useOfflineSync","sync","options","flushOnMount","flushOnOnline","intervalMs","state","useSyncExternalStore","flushRef","useRef","useEffect","handleOnline","id","toneFromState","useSyncStatus"],"mappings":"yGAkEO,SAASA,EACZC,EACAC,EAAiC,GACH,CAC9B,KAAM,CAAE,aAAAC,EAAe,GAAO,cAAAC,EAAgB,GAAM,WAAAC,EAAa,GAAMH,EAEjEI,EAAQC,EAAAA,qBAAqBN,EAAK,UAAWA,EAAK,SAAUA,EAAK,QAAQ,EAEzEO,EAAWC,EAAAA,OAAOR,EAAK,KAAK,EAClC,OAAAO,EAAS,QAAUP,EAAK,MAExBS,EAAAA,UAAU,IAAM,CACRP,GAAmBK,EAAS,QAAQ,MAAM,CAClD,EAAG,CAACL,CAAY,CAAC,EAEjBO,EAAAA,UAAU,IAAM,CACZ,GAAI,CAACN,GAAiB,OAAO,OAAW,IAAa,OACrD,MAAMO,EAAe,IAAY,CACxBH,EAAS,QAAQ,cAAc,CACxC,EACA,cAAO,iBAAiB,SAAUG,CAAY,EACvC,IAAM,OAAO,oBAAoB,SAAUA,CAAY,CAClE,EAAG,CAACP,CAAa,CAAC,EAElBM,EAAAA,UAAU,IAAM,CACZ,GAAIL,GAAc,GAAK,OAAO,OAAW,IAAa,OACtD,MAAMO,EAAK,OAAO,YAAY,IAAM,CAC3BJ,EAAS,QAAQ,UAAU,CACpC,EAAGH,CAAU,EACb,MAAO,IAAM,OAAO,cAAcO,CAAE,CACxC,EAAG,CAACP,CAAU,CAAC,EAER,CACH,GAAGC,EACH,QAASA,EAAM,QAAU,UACzB,QAASL,EAAK,QACd,MAAOA,EAAK,KAAA,CAEpB,CAmCA,SAASY,EAAcP,EAA4B,CAC/C,OAAIA,EAAM,QAAU,UAAkB,UAClCA,EAAM,QAAU,UAAkB,UAClCA,EAAM,QAAU,QAAgB,QAChCA,EAAM,QAAU,EAAU,UACvB,MACX,CAWO,SAASQ,EAAwBb,EAAyC,CAC7E,MAAMK,EAAQC,EAAAA,qBAAqBN,EAAK,UAAWA,EAAK,SAAUA,EAAK,QAAQ,EAC/E,MAAO,CACH,KAAMY,EAAcP,CAAK,EACzB,QAASA,EAAM,QACf,QAASA,EAAM,QAAU,UACzB,QAASA,EAAM,QAAU,UACzB,UAAWA,EAAM,SAAA,CAEzB"}

package/dist/offline/use-offline-sync.js

@@ -0,0 +1,42 @@
+import { useSyncExternalStore as l, useRef as a, useEffect as o } from "react";
+function g(e, n = {}) {
+  const { flushOnMount: u = !1, flushOnOnline: f = !0, intervalMs: i = 0 } = n, s = l(e.subscribe, e.getState, e.getState), t = a(e.flush);
+  return t.current = e.flush, o(() => {
+    u && t.current("boot");
+  }, [u]), o(() => {
+    if (!f || typeof window > "u") return;
+    const r = () => {
+      t.current("online-event");
+    };
+    return window.addEventListener("online", r), () => window.removeEventListener("online", r);
+  }, [f]), o(() => {
+    if (i <= 0 || typeof window > "u") return;
+    const r = window.setInterval(() => {
+      t.current("interval");
+    }, i);
+    return () => window.clearInterval(r);
+  }, [i]), {
+    ...s,
+    syncing: s.phase === "syncing",
+    enqueue: e.enqueue,
+    flush: e.flush
+  };
+}
+function d(e) {
+  return e.phase === "syncing" ? "syncing" : e.phase === "offline" ? "offline" : e.phase === "error" ? "error" : e.pending > 0 ? "pending" : "idle";
+}
+function h(e) {
+  const n = l(e.subscribe, e.getState, e.getState);
+  return {
+    tone: d(n),
+    pending: n.pending,
+    syncing: n.phase === "syncing",
+    offline: n.phase === "offline",
+    lastError: n.lastError
+  };
+}
+export {
+  g as useOfflineSync,
+  h as useSyncStatus
+};
+//# sourceMappingURL=use-offline-sync.js.map