@terreno/rtk 0.13.3 → 0.14.0

package/dist/sync.js

@@ -0,0 +1,205 @@
+import { DateTime } from "luxon";
+import { useEffect, useRef } from "react";
+import { useDispatch, useStore } from "react-redux";
+import { isWebsocketsDebugEnabled, logSocket } from "./constants";
+/**
+ * Hook that connects WebSocket sync events to RTK Query's cache.
+ *
+ * For **create** events: invalidates cache tags to trigger refetch of list queries.
+ * For **update** events: patches entities in-place in cached queries, falling back to tag invalidation.
+ * For **delete** events: removes entities from cached list queries, falling back to tag invalidation.
+ *
+ * Automatically subscribes to model rooms for each tagType when the socket connects,
+ * so models using `roomStrategy: "model"` will work without additional setup.
+ *
+ * @example
+ * ```typescript
+ * const { socket } = useSocketConnection({ ... });
+ *
+ * useSyncConnection({
+ *   socket,
+ *   api: terrenoApi,
+ *   tagTypes: ['todos', 'users'],
+ * });
+ * ```
+ */
+export const useSyncConnection = ({ socket, api, tagTypes, debug = false, }) => {
+    const dispatch = useDispatch();
+    const store = useStore();
+    const tagTypesRef = useRef(tagTypes);
+    const apiRef = useRef(api);
+    tagTypesRef.current = tagTypes;
+    apiRef.current = api;
+    // Auto-subscribe to model rooms for each tagType when socket connects
+    useEffect(() => {
+        if (!socket) {
+            return;
+        }
+        const subscribeToModels = () => {
+            for (const tag of tagTypesRef.current) {
+                socket.emit("subscribe:model", tag);
+            }
+        };
+        // Subscribe on connect and when already connected
+        if (socket.connected) {
+            subscribeToModels();
+        }
+        socket.on("connect", subscribeToModels);
+        return () => {
+            socket.off("connect", subscribeToModels);
+            // Unsubscribe from model rooms on cleanup
+            if (socket.connected) {
+                for (const tag of tagTypesRef.current) {
+                    socket.emit("unsubscribe:model", tag);
+                }
+            }
+        };
+    }, [socket]);
+    // Listen for sync events and update RTK Query cache
+    useEffect(() => {
+        if (!socket) {
+            return;
+        }
+        const log = (message) => {
+            if (isDebug) {
+                logSocket(true, message);
+            }
+        };
+        const logEvent = (event) => {
+            if (!isDebug) {
+                return;
+            }
+            logSocket(true, `sync event: ${JSON.stringify(event)}`);
+        };
+        const isDebug = debug ?? isWebsocketsDebugEnabled();
+        const getApiQueries = () => {
+            try {
+                const state = store.getState();
+                return state?.[apiRef.current.reducerPath]?.queries ?? null;
+            }
+            catch {
+                return null;
+            }
+        };
+        const handleSync = (event) => {
+            const { collection, method, id, data } = event;
+            const currentApi = apiRef.current;
+            // Only process events for collections we care about
+            if (!tagTypesRef.current.includes(collection)) {
+                log(`Ignoring event for collection: ${collection}`);
+                return;
+            }
+            log(`Received ${method} event for ${collection}/${id}`);
+            logEvent(event);
+            switch (method) {
+                case "update": {
+                    if (!data) {
+                        dispatch(currentApi.util.invalidateTags([collection]));
+                        break;
+                    }
+                    const queries = getApiQueries();
+                    if (!queries) {
+                        dispatch(currentApi.util.invalidateTags([collection]));
+                        break;
+                    }
+                    let patched = false;
+                    for (const [_cacheKey, queryEntry] of Object.entries(queries)) {
+                        const entry = queryEntry;
+                        if (entry?.status !== "fulfilled" || !entry?.data) {
+                            continue;
+                        }
+                        const { endpointName, originalArgs } = entry;
+                        // List response: {data: [...], total, page, more}
+                        if (entry.data?.data && Array.isArray(entry.data.data)) {
+                            const hasEntity = entry.data.data.some((item) => item._id === id || item.id === id);
+                            if (hasEntity) {
+                                dispatch(currentApi.util.updateQueryData(endpointName, originalArgs, (draft) => {
+                                    if (draft?.data && Array.isArray(draft.data)) {
+                                        const index = draft.data.findIndex((item) => item._id === id || item.id === id);
+                                        if (index !== -1) {
+                                            // Stale event check via updated timestamp
+                                            const cachedUpdated = draft.data[index].updated;
+                                            if (cachedUpdated &&
+                                                data.updated &&
+                                                DateTime.fromISO(cachedUpdated) > DateTime.fromISO(data.updated)) {
+                                                log(`Skipping stale update for ${collection}/${id}`);
+                                                return;
+                                            }
+                                            Object.assign(draft.data[index], data);
+                                        }
+                                    }
+                                }));
+                                patched = true;
+                            }
+                        }
+                        // Single entity response: {_id, ...fields}
+                        else if (entry.data?._id === id || entry.data?.id === id) {
+                            const cachedUpdated = entry.data.updated;
+                            if (cachedUpdated &&
+                                data.updated &&
+                                DateTime.fromISO(cachedUpdated) > DateTime.fromISO(data.updated)) {
+                                log(`Skipping stale update for ${collection}/${id}`);
+                                continue;
+                            }
+                            dispatch(currentApi.util.updateQueryData(endpointName, originalArgs, (draft) => {
+                                Object.assign(draft, data);
+                            }));
+                            patched = true;
+                        }
+                    }
+                    if (!patched) {
+                        dispatch(currentApi.util.invalidateTags([collection]));
+                    }
+                    break;
+                }
+                case "delete": {
+                    const queries = getApiQueries();
+                    if (!queries) {
+                        dispatch(currentApi.util.invalidateTags([collection]));
+                        break;
+                    }
+                    let patched = false;
+                    for (const [_cacheKey, queryEntry] of Object.entries(queries)) {
+                        const entry = queryEntry;
+                        if (entry?.status !== "fulfilled" || !entry?.data) {
+                            continue;
+                        }
+                        const { endpointName, originalArgs } = entry;
+                        // List response with data array
+                        if (entry.data?.data && Array.isArray(entry.data.data)) {
+                            const hasEntity = entry.data.data.some((item) => item._id === id || item.id === id);
+                            if (hasEntity) {
+                                dispatch(currentApi.util.updateQueryData(endpointName, originalArgs, (draft) => {
+                                    if (draft?.data && Array.isArray(draft.data)) {
+                                        draft.data = draft.data.filter((item) => item._id !== id && item.id !== id);
+                                        if (typeof draft.total === "number") {
+                                            draft.total = Math.max(0, draft.total - 1);
+                                        }
+                                    }
+                                }));
+                                patched = true;
+                            }
+                        }
+                    }
+                    if (!patched) {
+                        dispatch(currentApi.util.invalidateTags([collection]));
+                    }
+                    break;
+                }
+                case "create": {
+                    // For creates, we can't determine filter match client-side,
+                    // so invalidate tags to trigger refetch of list queries
+                    dispatch(currentApi.util.invalidateTags([collection]));
+                    break;
+                }
+            }
+        };
+        socket.on("sync", handleSync);
+        log("Listening for sync events");
+        return () => {
+            socket.off("sync", handleSync);
+            log("Stopped listening for sync events");
+        };
+    }, [socket, dispatch, store, debug]);
+};
+//# sourceMappingURL=sync.js.map

package/dist/sync.js.map

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

package/dist/tagGenerator.d.ts

@@ -1,2 +1,21 @@
-export declare const generateTags: (api: any, tagTypes: string[]) => any;
+interface TagProviderResult {
+    data?: Array<{
+        _id: string;
+    }>;
+    _id?: string;
+}
+type TagEntry = string | {
+    type: string;
+    id?: string;
+};
+type TagProviderFn = (result: TagProviderResult | null | undefined) => TagEntry[];
+interface EndpointTagConfig {
+    providesTags: TagProviderFn;
+    invalidatesTags: TagProviderFn;
+}
+interface ApiWithEndpoints {
+    endpoints: Record<string, unknown>;
+}
+export declare const generateTags: (api: ApiWithEndpoints, tagTypes: string[]) => Record<string, EndpointTagConfig>;
+export {};
 //# sourceMappingURL=tagGenerator.d.ts.map

package/dist/tagGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tagGenerator.d.ts","sourceRoot":"","sources":["../src/tagGenerator.ts"],"names":[],"mappings":"AAmCA,eAAO,MAAM,YAAY,GAAI,KAAK,GAAG,EAAE,UAAU,MAAM,EAAE,KAAG,GA4C3D,CAAC"}
+{"version":3,"file":"tagGenerator.d.ts","sourceRoot":"","sources":["../src/tagGenerator.ts"],"names":[],"mappings":"AAGA,UAAU,iBAAiB;IACzB,IAAI,CAAC,EAAE,KAAK,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,KAAK,QAAQ,GAAG,MAAM,GAAG;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAC,CAAC;AACrD,KAAK,aAAa,GAAG,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,KAAK,QAAQ,EAAE,CAAC;AAElF,UAAU,iBAAiB;IACzB,YAAY,EAAE,aAAa,CAAC;IAC5B,eAAe,EAAE,aAAa,CAAC;CAChC;AAED,UAAU,gBAAgB;IACxB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAgCD,eAAO,MAAM,YAAY,GACvB,KAAK,gBAAgB,EACrB,UAAU,MAAM,EAAE,KACjB,MAAM,CAAC,MAAM,EAAE,iBAAiB,CA4ClC,CAAC"}

package/dist/tagGenerator.js

@@ -1,4 +1,3 @@
-// biome-ignore-all lint/suspicious/noExplicitAny: Generics
 // use this with enhanceEndpoints since the code generator doesn't invalidate by individual ids,
 // only at the full collection level
 const providesIdTags = (path) => (result) => result ? [...(result?.data?.map(({ _id }) => ({ id: _id, type: path })) ?? []), path] : [path];
@@ -24,7 +23,7 @@ export const generateTags = (api, tagTypes) => {
     const tags = {};
     Object.keys(endpoints).forEach((endpoint) => {
         if (endpoint === "getConversations") {
-            tags[endpoint] = { invalidatesTags: ["conversations", "messages"] };
+            tags[endpoint] = { invalidatesTags: () => ["conversations", "messages"] };
         }
         if (endpoint.toLowerCase().includes("get")) {
             // List endpoints

package/dist/tagGenerator.js.map

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

package/dist/useOfflineStatus.d.ts

@@ -0,0 +1,33 @@
+import { type ConflictRecord } from "./offlineSlice";
+export interface OfflineStatus {
+    /** Whether the device currently has network connectivity */
+    isOnline: boolean;
+    /** Number of mutations waiting to be synced */
+    queueLength: number;
+    /** Whether mutations are currently being replayed to the server */
+    isSyncing: boolean;
+    /** All conflict records (including dismissed) */
+    conflicts: ConflictRecord[];
+    /** Conflict records the user hasn't dismissed yet */
+    undismissedConflicts: ConflictRecord[];
+    /** Dismiss a single conflict notification by ID */
+    dismissConflict: (id: string) => void;
+    /** Clear all conflict records */
+    clearConflicts: () => void;
+    /** Returns true if the item exists only locally (not yet synced to server) */
+    isLocalOnly: (id: string) => boolean;
+}
+/**
+ * Hook for consuming offline state, sync status, and conflict notifications.
+ *
+ * Usage:
+ * ```typescript
+ * const {isOnline, queueLength, isSyncing, undismissedConflicts, dismissConflict} = useOfflineStatus();
+ *
+ * if (!isOnline) {
+ *   return <Banner text={`Offline. ${queueLength} changes pending.`} />;
+ * }
+ * ```
+ */
+export declare const useOfflineStatus: () => OfflineStatus;
+//# sourceMappingURL=useOfflineStatus.d.ts.map

package/dist/useOfflineStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOfflineStatus.d.ts","sourceRoot":"","sources":["../src/useOfflineStatus.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,cAAc,EASpB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,QAAQ,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,SAAS,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,qDAAqD;IACrD,oBAAoB,EAAE,cAAc,EAAE,CAAC;IACvC,mDAAmD;IACnD,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,iCAAiC;IACjC,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,8EAA8E;IAC9E,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;CACtC;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,QAAO,aAmCnC,CAAC"}

package/dist/useOfflineStatus.js

@@ -0,0 +1,43 @@
+import { useCallback } from "react";
+import { useDispatch, useSelector } from "react-redux";
+import { clearConflicts, dismissConflict, selectConflicts, selectIsOnline, selectIsSyncing, selectQueueLength, selectUndismissedConflicts, } from "./offlineSlice";
+/**
+ * Hook for consuming offline state, sync status, and conflict notifications.
+ *
+ * Usage:
+ * ```typescript
+ * const {isOnline, queueLength, isSyncing, undismissedConflicts, dismissConflict} = useOfflineStatus();
+ *
+ * if (!isOnline) {
+ *   return <Banner text={`Offline. ${queueLength} changes pending.`} />;
+ * }
+ * ```
+ */
+export const useOfflineStatus = () => {
+    const dispatch = useDispatch();
+    const isOnline = useSelector((state) => selectIsOnline(state));
+    const queueLength = useSelector((state) => selectQueueLength(state));
+    const isSyncing = useSelector((state) => selectIsSyncing(state));
+    const conflicts = useSelector((state) => selectConflicts(state));
+    const undismissedConflicts = useSelector((state) => selectUndismissedConflicts(state));
+    const handleDismissConflict = useCallback((id) => {
+        dispatch(dismissConflict(id));
+    }, [dispatch]);
+    const handleClearConflicts = useCallback(() => {
+        dispatch(clearConflicts());
+    }, [dispatch]);
+    const isLocalOnly = useCallback((id) => {
+        return typeof id === "string" && id.startsWith("temp-");
+    }, []);
+    return {
+        clearConflicts: handleClearConflicts,
+        conflicts,
+        dismissConflict: handleDismissConflict,
+        isLocalOnly,
+        isOnline,
+        isSyncing,
+        queueLength,
+        undismissedConflicts,
+    };
+};
+//# sourceMappingURL=useOfflineStatus.js.map

package/dist/useOfflineStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOfflineStatus.js","sourceRoot":"","sources":["../src/useOfflineStatus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,OAAO,CAAC;AAClC,OAAO,EAAC,WAAW,EAAE,WAAW,EAAC,MAAM,aAAa,CAAC;AAErD,OAAO,EAEL,cAAc,EACd,eAAe,EAEf,eAAe,EACf,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAqBxB;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAkB,EAAE;IAClD,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,KAA8B,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;IACxF,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,KAA8B,EAAE,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9F,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,KAA8B,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1F,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,KAA8B,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1F,MAAM,oBAAoB,GAAG,WAAW,CAAC,CAAC,KAA8B,EAAE,EAAE,CAC1E,0BAA0B,CAAC,KAAK,CAAC,CAClC,CAAC;IAEF,MAAM,qBAAqB,GAAG,WAAW,CACvC,CAAC,EAAU,EAAE,EAAE;QACb,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC;IAChC,CAAC,EACD,CAAC,QAAQ,CAAC,CACX,CAAC;IAEF,MAAM,oBAAoB,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5C,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC;IAC7B,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,EAAU,EAAW,EAAE;QACtD,OAAO,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO;QACL,cAAc,EAAE,oBAAoB;QACpC,SAAS;QACT,eAAe,EAAE,qBAAqB;QACtC,WAAW;QACX,QAAQ;QACR,SAAS;QACT,WAAW;QACX,oBAAoB;KACrB,CAAC;AACJ,CAAC,CAAC"}

package/dist/useOfflineStatus.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useOfflineStatus.test.d.ts.map

package/dist/useOfflineStatus.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOfflineStatus.test.d.ts","sourceRoot":"","sources":["../src/useOfflineStatus.test.ts"],"names":[],"mappings":""}

package/dist/useOfflineStatus.test.js

@@ -0,0 +1,119 @@
+import { beforeEach, describe, expect, it } from "bun:test";
+import { configureStore } from "@reduxjs/toolkit";
+import { act, renderHook } from "@testing-library/react-native";
+import React from "react";
+import { Provider } from "react-redux";
+import { addConflict, enqueue, offlineReducer, setOnlineStatus, setSyncing, } from "./offlineSlice";
+import { useOfflineStatus } from "./useOfflineStatus";
+const createTestStore = () => configureStore({
+    reducer: { offline: offlineReducer },
+});
+const createWrapper = (store) => {
+    const Wrapper = ({ children }) => React.createElement(Provider, { children, store });
+    return Wrapper;
+};
+describe("useOfflineStatus", () => {
+    let store;
+    beforeEach(() => {
+        store = createTestStore();
+    });
+    it("returns initial online state", () => {
+        const { result } = renderHook(() => useOfflineStatus(), {
+            wrapper: createWrapper(store),
+        });
+        expect(result.current.isOnline).toBe(true);
+        expect(result.current.queueLength).toBe(0);
+        expect(result.current.isSyncing).toBe(false);
+        expect(result.current.conflicts).toEqual([]);
+        expect(result.current.undismissedConflicts).toEqual([]);
+    });
+    it("reflects offline state", () => {
+        store.dispatch(setOnlineStatus(false));
+        const { result } = renderHook(() => useOfflineStatus(), {
+            wrapper: createWrapper(store),
+        });
+        expect(result.current.isOnline).toBe(false);
+    });
+    it("reports queue length", () => {
+        const mutation = {
+            args: { body: { title: "Test" } },
+            endpointName: "postTodos",
+            id: "test-1",
+            timestamp: "2026-01-01T00:00:00.000Z",
+            type: "create",
+        };
+        store.dispatch(enqueue(mutation));
+        const { result } = renderHook(() => useOfflineStatus(), {
+            wrapper: createWrapper(store),
+        });
+        expect(result.current.queueLength).toBe(1);
+    });
+    it("reports syncing state", () => {
+        store.dispatch(setSyncing(true));
+        const { result } = renderHook(() => useOfflineStatus(), {
+            wrapper: createWrapper(store),
+        });
+        expect(result.current.isSyncing).toBe(true);
+    });
+    it("filters undismissed conflicts", () => {
+        const conflict = {
+            args: { id: "abc" },
+            dismissed: false,
+            endpointName: "patchTodosById",
+            id: "conflict-1",
+            serverDocument: { title: "Server" },
+            timestamp: "2026-01-01T00:00:00.000Z",
+        };
+        store.dispatch(addConflict(conflict));
+        const { result } = renderHook(() => useOfflineStatus(), {
+            wrapper: createWrapper(store),
+        });
+        expect(result.current.conflicts).toHaveLength(1);
+        expect(result.current.undismissedConflicts).toHaveLength(1);
+    });
+    it("dismissConflict dispatches the action", () => {
+        const conflict = {
+            args: { id: "abc" },
+            dismissed: false,
+            endpointName: "patchTodosById",
+            id: "conflict-to-dismiss",
+            serverDocument: { title: "Server" },
+            timestamp: "2026-01-01T00:00:00.000Z",
+        };
+        store.dispatch(addConflict(conflict));
+        const { result } = renderHook(() => useOfflineStatus(), {
+            wrapper: createWrapper(store),
+        });
+        act(() => {
+            result.current.dismissConflict("conflict-to-dismiss");
+        });
+        expect(result.current.undismissedConflicts).toHaveLength(0);
+        expect(result.current.conflicts[0].dismissed).toBe(true);
+    });
+    it("clearConflicts removes all conflicts", () => {
+        const conflict = {
+            args: { id: "abc" },
+            dismissed: false,
+            endpointName: "patchTodosById",
+            id: "conflict-clear",
+            serverDocument: { title: "Server" },
+            timestamp: "2026-01-01T00:00:00.000Z",
+        };
+        store.dispatch(addConflict(conflict));
+        const { result } = renderHook(() => useOfflineStatus(), {
+            wrapper: createWrapper(store),
+        });
+        act(() => {
+            result.current.clearConflicts();
+        });
+        expect(result.current.conflicts).toHaveLength(0);
+    });
+    it("isLocalOnly returns true for temp-prefixed IDs", () => {
+        const { result } = renderHook(() => useOfflineStatus(), {
+            wrapper: createWrapper(store),
+        });
+        expect(result.current.isLocalOnly("temp-abc123")).toBe(true);
+        expect(result.current.isLocalOnly("507f1f77bcf86cd799439011")).toBe(false);
+    });
+});
+//# sourceMappingURL=useOfflineStatus.test.js.map

package/dist/useOfflineStatus.test.js.map

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

package/dist/useRealtimeDebug.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Syncs websocket debug logging with the backend RealtimeApp debug flag.
+ * Also respects WEBSOCKETS_DEBUG from app config via isWebsocketsDebugEnabled().
+ */
+export declare const useRealtimeDebug: (baseUrl: string, refreshKey?: unknown) => boolean;
+//# sourceMappingURL=useRealtimeDebug.d.ts.map

package/dist/useRealtimeDebug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRealtimeDebug.d.ts","sourceRoot":"","sources":["../src/useRealtimeDebug.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,EAAE,aAAa,OAAO,KAAG,OAoCxE,CAAC"}

package/dist/useRealtimeDebug.js

@@ -0,0 +1,41 @@
+import { useEffect, useState } from "react";
+import { useSelector } from "react-redux";
+import { isWebsocketsDebugEnabled, setRealtimeDebug } from "./constants";
+import { selectIsOnlineSafe } from "./offlineSlice";
+/**
+ * Syncs websocket debug logging with the backend RealtimeApp debug flag.
+ * Also respects WEBSOCKETS_DEBUG from app config via isWebsocketsDebugEnabled().
+ */
+export const useRealtimeDebug = (baseUrl, refreshKey) => {
+    const [debugEnabled, setDebugEnabled] = useState(isWebsocketsDebugEnabled);
+    const isOnline = useSelector(selectIsOnlineSafe);
+    useEffect(() => {
+        if (!isOnline) {
+            return;
+        }
+        let cancelled = false;
+        const loadDebugFlag = async () => {
+            try {
+                const response = await fetch(`${baseUrl}/realtime/health`);
+                if (!response.ok) {
+                    return;
+                }
+                const data = (await response.json());
+                if (cancelled) {
+                    return;
+                }
+                setRealtimeDebug(data.debug === true);
+                setDebugEnabled(isWebsocketsDebugEnabled());
+            }
+            catch {
+                // Health endpoint unavailable — keep env-based debug only
+            }
+        };
+        void loadDebugFlag();
+        return () => {
+            cancelled = true;
+        };
+    }, [baseUrl, refreshKey, isOnline]);
+    return debugEnabled;
+};
+//# sourceMappingURL=useRealtimeDebug.js.map

package/dist/useRealtimeDebug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRealtimeDebug.js","sourceRoot":"","sources":["../src/useRealtimeDebug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAE,QAAQ,EAAC,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAC,WAAW,EAAC,MAAM,aAAa,CAAC;AAExC,OAAO,EAAC,wBAAwB,EAAE,gBAAgB,EAAC,MAAM,aAAa,CAAC;AACvE,OAAO,EAAC,kBAAkB,EAAC,MAAM,gBAAgB,CAAC;AAMlD;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAe,EAAE,UAAoB,EAAW,EAAE;IACjF,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,wBAAwB,CAAC,CAAC;IAC3E,MAAM,QAAQ,GAAG,WAAW,CAAC,kBAAkB,CAAC,CAAC;IAEjD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAC;QAEtB,MAAM,aAAa,GAAG,KAAK,IAAmB,EAAE;YAC9C,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,kBAAkB,CAAC,CAAC;gBAC3D,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,OAAO;gBACT,CAAC;gBACD,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA2B,CAAC;gBAC/D,IAAI,SAAS,EAAE,CAAC;oBACd,OAAO;gBACT,CAAC;gBACD,gBAAgB,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;gBACtC,eAAe,CAAC,wBAAwB,EAAE,CAAC,CAAC;YAC9C,CAAC;YAAC,MAAM,CAAC;gBACP,0DAA0D;YAC5D,CAAC;QACH,CAAC,CAAC;QAEF,KAAK,aAAa,EAAE,CAAC;QAErB,OAAO,GAAS,EAAE;YAChB,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEpC,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC"}

package/dist/useServerStatus.d.ts

@@ -0,0 +1,29 @@
+import { type OfflineStatus } from "./useOfflineStatus";
+export interface ServerStatusOptions {
+    /** URL to poll for server health. Defaults to `${baseUrl}/health`. */
+    healthUrl?: string;
+    /** Polling interval in ms while online. Default 5000. */
+    pollIntervalMs?: number;
+    /** Polling interval in ms while offline. Default 3000. */
+    offlinePollIntervalMs?: number;
+    /** Skip polling entirely (e.g. when not authenticated). */
+    skip?: boolean;
+}
+export type ServerStatus = OfflineStatus;
+/**
+ * Polls the API server health endpoint to determine actual server reachability.
+ * Dispatches setOnlineStatus(true/false) into the offline slice so the rest
+ * of the offline middleware (queue, optimistic updates, replay) reacts.
+ *
+ * Use this instead of useOfflineStatus when you want real server-connectivity
+ * detection rather than just browser navigator.onLine.
+ *
+ * @example
+ * ```typescript
+ * const {isOnline, queueLength, isSyncing, isLocalOnly} = useServerStatus({
+ *   skip: !userId,
+ * });
+ * ```
+ */
+export declare const useServerStatus: (options?: ServerStatusOptions) => ServerStatus;
+//# sourceMappingURL=useServerStatus.d.ts.map

package/dist/useServerStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useServerStatus.d.ts","sourceRoot":"","sources":["../src/useServerStatus.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,KAAK,aAAa,EAAmB,MAAM,oBAAoB,CAAC;AAKxE,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,2DAA2D;IAC3D,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,YAAY,GAAG,aAAa,CAAC;AAEzC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,eAAe,GAAI,UAAS,mBAAwB,KAAG,YAmFnE,CAAC"}