doover-js 0.12.1 → 0.13.1

package/dist/esm/client/offline-cache.d.ts

@@ -1,3 +1,5 @@
+import type { ServiceReachabilitySource } from "./service-reachability.js";
+import { type NetworkStatusSource } from "./network-status.js";
 import type { AgentScope, AgentsApiLike, AggregatesApiLike, AlarmsApiLike, ChannelsApiLike, ConnectionsApiLike, DataClient, DataClientStatus, GatewayClientLike, MessagesApiLike, NotificationsApiLike, PermissionsApiLike, ProcessorsApiLike, RpcDispatcherLike, TurnApiLike, UsersApiLike } from "./data-client.js";
 import type { Capability } from "./capabilities.js";
 export declare const DEFAULT_OFFLINE_RETENTION_MS: number;
@@ -83,18 +85,23 @@ export declare class MemoryOfflineStorageAdapter implements OfflineStorageAdapte
     deleteBlob(key: string): Promise<void>;
 }
 export interface OfflineDataClientOptions {
+    /** Reactive platform signal; defaults to the wrapped client's source. */
+    networkStatus?: NetworkStatusSource;
     client: DataClient;
     storage: OfflineStorageAdapter;
     scope: OfflineCacheScope;
     policies?: OfflineChannelPolicy[];
     defaultRetentionMs?: number;
     /**
-     * Apps may provide their own reachability signal. When omitted, the wrapper
-     * uses `navigator.onLine` when present and otherwise assumes online.
+     * Legacy pull-only override. Prefer networkStatus for reactive updates
+     * between requests. When omitted, the wrapper reads its network source.
      */
     isOnline?: () => boolean;
 }
 export declare class OfflineDataClient implements DataClient {
+    readonly networkStatus: NetworkStatusSource;
+    readonly reachability: ServiceReachabilitySource | undefined;
+    private unsubscribeNetwork?;
     readonly agents: AgentsApiLike;
     readonly channels: ChannelsApiLike;
     readonly messages: MessagesApiLike;

package/dist/esm/client/offline-cache.js

@@ -1,3 +1,4 @@
+import { browserNetworkStatus } from "./network-status.js";
 import { DooverOfflineError } from "./errors.js";
 import { delegateRequestOptions, splitRequestOptions, } from "./request-options.js";
 export const DEFAULT_OFFLINE_RETENTION_MS = 7 * 24 * 60 * 60 * 1000;
@@ -53,6 +54,8 @@ export class OfflineDataClient {
         this.offlineStatus = INITIAL_OFFLINE_STATUS;
         this.persistQueue = Promise.resolve();
         this.client = options.client;
+        this.reachability = options.client.reachability;
+        this.networkStatus = options.networkStatus ?? options.client.networkStatus ?? browserNetworkStatus;
         this.storage = options.storage;
         this.scope = options.scope;
         this.defaultRetentionMs = options.defaultRetentionMs ?? DEFAULT_OFFLINE_RETENTION_MS;
@@ -86,19 +89,30 @@ export class OfflineDataClient {
         return this.policies;
     }
     getOfflineStatus() {
-        return {
-            ...this.offlineStatus,
-            online: this.isOnline(),
-        };
+        const online = this.isOnline();
+        if (online !== this.offlineStatus.online) {
+            this.offlineStatus = { ...this.offlineStatus, online, at: Date.now() };
+        }
+        return this.offlineStatus;
     }
     onOfflineStatusChange(listener) {
         this.offlineStatusListeners.add(listener);
+        if (!this.unsubscribeNetwork) {
+            this.unsubscribeNetwork = this.networkStatus.subscribe(() => {
+                const status = this.getOfflineStatus();
+                this.offlineStatusListeners.forEach((callback) => callback(status));
+            });
+        }
         let active = true;
         return () => {
             if (!active)
                 return;
             active = false;
             this.offlineStatusListeners.delete(listener);
+            if (!this.offlineStatusListeners.size) {
+                this.unsubscribeNetwork?.();
+                this.unsubscribeNetwork = undefined;
+            }
         };
     }
     async clearScope(scope = this.scope) {
@@ -678,8 +692,7 @@ export class OfflineDataClient {
     isOnline() {
         if (this.isOnlineFn)
             return this.isOnlineFn();
-        const nav = globalThis.navigator;
-        return nav?.onLine ?? true;
+        return this.networkStatus.getSnapshot().online;
     }
     setOfflineStatus(status) {
         this.offlineStatus = {

package/dist/esm/client/service-reachability.d.ts

@@ -0,0 +1,36 @@
+import type { NetworkStatusSource } from "./network-status.js";
+/** Reachability of the data API, independent of browser and gateway status. */
+export type ServiceReachability = "unknown" | "reachable" | "unreachable";
+export interface ServiceReachabilitySource {
+    getSnapshot(): ServiceReachability;
+    subscribe(listener: () => void): () => void;
+}
+export interface ReachabilityOptions {
+    /** A CORS-enabled, read-only URL on the data service. Defaults to dataRestUrl.
+     * Any HTTP response proves reachability, including authentication/server errors.
+     * HEAD requests omit credentials and bypass the browser cache. */
+    probeUrl?: string;
+}
+/** One polling loop per observed client. No requests or timers until subscribed. */
+export declare class ServiceReachabilityMonitor implements ServiceReachabilitySource {
+    private readonly url;
+    private readonly network;
+    private readonly fetchImpl;
+    private status;
+    private listeners;
+    private timer;
+    private controller;
+    private unsubscribeNetwork;
+    private lastCheck;
+    constructor(url: string, network: NetworkStatusSource, fetchImpl: typeof fetch);
+    getSnapshot(): ServiceReachability;
+    subscribe(listener: () => void): () => void;
+    /** Transport failures trigger a probe; they never retry the failed request.
+     * Coalesce failures and cap probes at one per second during request bursts. */
+    requestFailed(): void;
+    private setStatus;
+    private cancel;
+    private networkChanged;
+    private schedule;
+    private check;
+}

package/dist/esm/client/service-reachability.js

@@ -0,0 +1,103 @@
+/** One polling loop per observed client. No requests or timers until subscribed. */
+export class ServiceReachabilityMonitor {
+    constructor(url, network, fetchImpl) {
+        this.url = url;
+        this.network = network;
+        this.fetchImpl = fetchImpl;
+        this.status = "unknown";
+        this.listeners = new Set();
+        this.lastCheck = -Infinity;
+    }
+    getSnapshot() { return this.status; }
+    subscribe(listener) {
+        const notify = () => listener();
+        this.listeners.add(notify);
+        if (this.listeners.size === 1) {
+            this.unsubscribeNetwork = this.network.subscribe(() => this.networkChanged());
+            this.networkChanged();
+        }
+        return () => {
+            this.listeners.delete(notify);
+            if (!this.listeners.size) {
+                this.unsubscribeNetwork?.();
+                this.unsubscribeNetwork = undefined;
+                this.cancel();
+            }
+        };
+    }
+    /** Transport failures trigger a probe; they never retry the failed request.
+     * Coalesce failures and cap probes at one per second during request bursts. */
+    requestFailed() {
+        if (!this.listeners.size || this.controller || !this.network.getSnapshot().online)
+            return;
+        this.schedule(Math.max(0, 1000 - (Date.now() - this.lastCheck)));
+    }
+    setStatus(status) {
+        if (status === this.status)
+            return;
+        this.status = status;
+        this.listeners.forEach((listener) => listener());
+    }
+    cancel() {
+        clearTimeout(this.timer);
+        this.timer = undefined;
+        const previous = this.controller;
+        this.controller = undefined;
+        previous?.abort();
+    }
+    networkChanged() {
+        if (!this.network.getSnapshot().online) {
+            this.cancel();
+            this.setStatus("unreachable");
+        }
+        else if (!this.controller) {
+            void this.check();
+        }
+    }
+    schedule(delay) {
+        clearTimeout(this.timer);
+        this.timer = setTimeout(() => { void this.check(); }, delay);
+    }
+    async check() {
+        if (!this.listeners.size || this.controller || !this.network.getSnapshot().online)
+            return;
+        clearTimeout(this.timer);
+        this.timer = undefined;
+        const controller = new AbortController();
+        this.controller = controller;
+        this.lastCheck = Date.now();
+        // The explicit race also bounds native/custom fetch implementations that
+        // ignore AbortSignal. Late responses cannot overwrite a newer observation.
+        let rejectAbort = () => { };
+        const aborted = new Promise((_resolve, reject) => {
+            rejectAbort = () => reject(new Error("Reachability check cancelled or timed out"));
+            controller.signal.addEventListener("abort", rejectAbort, { once: true });
+        });
+        const timeout = setTimeout(() => controller.abort(), 5000);
+        try {
+            const response = await Promise.race([
+                Promise.resolve().then(() => this.fetchImpl(this.url, {
+                    method: "HEAD", cache: "no-store", credentials: "omit",
+                    signal: controller.signal,
+                })),
+                aborted,
+            ]);
+            if (this.controller === controller) {
+                this.setStatus(response.status > 0 ? "reachable" : "unreachable");
+            }
+        }
+        catch {
+            if (this.controller === controller)
+                this.setStatus("unreachable");
+        }
+        finally {
+            clearTimeout(timeout);
+            controller.signal.removeEventListener("abort", rejectAbort);
+            if (this.controller === controller) {
+                this.controller = undefined;
+                if (this.listeners.size)
+                    this.schedule(this.status === "reachable" ? 30000 : 5000);
+            }
+        }
+    }
+}

package/dist/esm/http/rest-client.d.ts

@@ -1,7 +1,12 @@
+import type { ReachabilityOptions } from "../client/service-reachability.js";
+import type { NetworkStatusSource } from "../client/network-status.js";
 import type { AuthConfig } from "../auth/build-auth.js";
 import type { DooverAuth } from "../auth/doover-auth.js";
 import type { DooverStatsCollector } from "../client/stats.js";
 export interface DooverClientConfig extends AuthConfig {
+    networkStatus?: NetworkStatusSource;
+    /** Data API reachability checks while reachability is observed. Set false to disable. */
+    reachability?: ReachabilityOptions | false;
     dataRestUrl: string;
     controlApiUrl: string;
     dataWssUrl: string;
@@ -38,10 +43,11 @@ export interface RequestOptions {
 type QueryValue = string | number | boolean | null | undefined | Array<string | number | boolean>;
 type QueryParams = Record<string, QueryValue> | object;
 export declare class RestClient {
+    private readonly onTransportFailure?;
     readonly config: Required<Pick<DooverClientConfig, "dataRestUrl" | "controlApiUrl" | "dataWssUrl" | "sharing" | "impersonateUserStorageKey">> & Pick<DooverClientConfig, "organisationId" | "fetchImpl" | "webSocketImpl" | "webSocketFactory">;
     readonly auth: DooverAuth | null;
     private stats;
-    constructor(config: DooverClientConfig, auth?: DooverAuth);
+    constructor(config: DooverClientConfig, auth?: DooverAuth, onTransportFailure?: (() => void) | undefined);
     /** Attach a stats collector. Call with `null` to detach. */
     setStats(stats: DooverStatsCollector | null): void;
     request<T>(options: RequestOptions): Promise<T>;

package/dist/esm/http/rest-client.js

@@ -1,6 +1,7 @@
 import { DooverApiError } from "./errors.js";
 export class RestClient {
-    constructor(config, auth) {
+    constructor(config, auth, onTransportFailure) {
+        this.onTransportFailure = onTransportFailure;
         this.stats = null;
         this.config = {
             ...config,
@@ -91,12 +92,19 @@ export class RestClient {
             }
         }
         const fetchImpl = this.config.fetchImpl ?? fetch;
-        return fetchImpl(request.url, {
-            method: request.method,
-            headers: request.headers,
-            body: request.body,
-            credentials: request.credentials,
-        });
+        try {
+            return await fetchImpl(request.url, {
+                method: request.method,
+                headers: request.headers,
+                body: request.body,
+                credentials: request.credentials,
+            });
+        }
+        catch (error) {
+            // Auth preparation, HTTP errors and JSON parsing are outside this boundary.
+            this.onTransportFailure?.();
+            throw error;
+        }
     }
     get(path, query, baseUrl) {
         return this.request({ path, query, baseUrl });

package/dist/esm/index.d.ts

@@ -60,3 +60,6 @@ export type * from "./types/viewer.js";
 export type * from "./types/audit.js";
 export { DV_AUDIT_CHANNEL } from "./types/audit.js";
 export { addTimestampToMessage, extractSnowflakeId, generateSnowflakeIdAtTime, } from "./utils/snowflake.js";
+export { browserNetworkStatus, createNetworkStatusStore } from "./client/network-status.js";
+export type { NetworkStatusSource, NetworkStatusSnapshot } from "./client/network-status.js";
+export type { ServiceReachability, ServiceReachabilitySource, ReachabilityOptions } from "./client/service-reachability.js";

package/dist/esm/index.js

@@ -35,3 +35,4 @@ export { DooverDataProvider } from "./viewer/doover-data-provider.js";
 export { getIdentifierFromPath } from "./viewer/path-parsing.js";
 export { DV_AUDIT_CHANNEL } from "./types/audit.js";
 export { addTimestampToMessage, extractSnowflakeId, generateSnowflakeIdAtTime, } from "./utils/snowflake.js";
+export { browserNetworkStatus, createNetworkStatusStore } from "./client/network-status.js";

package/dist/esm/package.json

@@ -1 +1 @@
-{"type":"module","sideEffects":false}
+{"name":"doover-js","version":"0.13.1","type":"module","sideEffects":false}

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

@@ -36,3 +36,4 @@ export { useTurnCredentials } from "./useTurnCredentials.js";
 export { useAgentTokenState, useSetAgentTokenPolicy, useSetAgentAuthLock, useRevokeAgentTokens, useSetRevocationFloor, useCreateAdhocToken, useCreateDeviceToken, agentTokenStateQueryKey, } from "./useAgentTokenState.js";
 export type { UseAgentTokenStateOptions } from "./useAgentTokenState.js";
 export { getSharedQueryClient, resetSharedQueryClient, } from "./sharedQueryClient.js";
+export { useServiceReachability } from "./useServiceReachability.js";

package/dist/esm/react/index.js

@@ -19,3 +19,4 @@ export { useDeviceMap } from "./useDeviceMap.js";
 export { useTurnCredentials } from "./useTurnCredentials.js";
 export { useAgentTokenState, useSetAgentTokenPolicy, useSetAgentAuthLock, useRevokeAgentTokens, useSetRevocationFloor, useCreateAdhocToken, useCreateDeviceToken, agentTokenStateQueryKey, } from "./useAgentTokenState.js";
 export { getSharedQueryClient, resetSharedQueryClient, } from "./sharedQueryClient.js";
+export { useServiceReachability } from "./useServiceReachability.js";

package/dist/esm/react/useOfflineStatus.js

@@ -1,23 +1,37 @@
-import { useSyncExternalStore } from "react";
+import { useMemo, useSyncExternalStore } from "react";
+import { browserNetworkStatus } from "../client/network-status.js";
 import { useDooverClient } from "./context.js";
 export function hasOfflineStatus(client) {
-    return (!!client &&
-        typeof client === "object" &&
-        typeof client.getOfflineStatus === "function" &&
-        typeof client.onOfflineStatusChange === "function");
+    return !!client && typeof client === "object" &&
+        "getOfflineStatus" in client && typeof client.getOfflineStatus === "function" &&
+        "onOfflineStatusChange" in client && typeof client.onOfflineStatusChange === "function";
 }
-const UNAVAILABLE_OFFLINE_STATUS = {
-    online: true,
-    state: "online",
-    isOfflineFallback: false,
-    isExpired: false,
-    at: 0,
+const SERVER_OFFLINE_STATUS = {
+    online: true, state: "online", isOfflineFallback: false, isExpired: false, at: 0,
 };
 export function useOfflineStatus() {
     const client = useDooverClient();
-    return useSyncExternalStore((listener) => hasOfflineStatus(client)
-        ? client.onOfflineStatusChange(listener)
-        : () => undefined, () => hasOfflineStatus(client)
-        ? client.getOfflineStatus()
-        : UNAVAILABLE_OFFLINE_STATUS, () => UNAVAILABLE_OFFLINE_STATUS);
+    const store = useMemo(() => {
+        if (hasOfflineStatus(client)) {
+            return {
+                subscribe: (listener) => client.onOfflineStatusChange(listener),
+                getSnapshot: () => client.getOfflineStatus(),
+            };
+        }
+        const network = client.networkStatus ?? browserNetworkStatus;
+        let previous = network.getSnapshot();
+        let snapshot = { ...SERVER_OFFLINE_STATUS, ...previous };
+        return {
+            subscribe: (listener) => network.subscribe(listener),
+            getSnapshot: () => {
+                const next = network.getSnapshot();
+                if (next !== previous) {
+                    previous = next;
+                    snapshot = { ...SERVER_OFFLINE_STATUS, ...next };
+                }
+                return snapshot;
+            },
+        };
+    }, [client]);
+    return useSyncExternalStore(store.subscribe, store.getSnapshot, () => SERVER_OFFLINE_STATUS);
 }

package/dist/esm/react/useServiceReachability.d.ts

@@ -0,0 +1,5 @@
+import type { ServiceReachability } from "../client/service-reachability.js";
+/** Observe data API reachability even when the browser incorrectly reports online.
+ * Shares one polling loop per client; the final unmount stops checks.
+ * Clients without a reachability source return unknown and make no requests. */
+export declare function useServiceReachability(): ServiceReachability;

package/dist/esm/react/useServiceReachability.js

@@ -0,0 +1,13 @@
+import { useCallback, useSyncExternalStore } from "react";
+import { useDooverClient } from "./context.js";
+const unknownSnapshot = () => "unknown";
+const noop = () => { };
+/** Observe data API reachability even when the browser incorrectly reports online.
+ * Shares one polling loop per client; the final unmount stops checks.
+ * Clients without a reachability source return unknown and make no requests. */
+export function useServiceReachability() {
+    const source = useDooverClient().reachability;
+    const subscribe = useCallback((listener) => source?.subscribe(listener) ?? noop, [source]);
+    const getSnapshot = useCallback(() => source?.getSnapshot() ?? "unknown", [source]);
+    return useSyncExternalStore(subscribe, getSnapshot, unknownSnapshot);
+}

package/dist/http/rest-client.d.ts

@@ -1,7 +1,12 @@
+import type { ReachabilityOptions } from "../client/service-reachability.js";
+import type { NetworkStatusSource } from "../client/network-status.js";
 import type { AuthConfig } from "../auth/build-auth.js";
 import type { DooverAuth } from "../auth/doover-auth.js";
 import type { DooverStatsCollector } from "../client/stats.js";
 export interface DooverClientConfig extends AuthConfig {
+    networkStatus?: NetworkStatusSource;
+    /** Data API reachability checks while reachability is observed. Set false to disable. */
+    reachability?: ReachabilityOptions | false;
     dataRestUrl: string;
     controlApiUrl: string;
     dataWssUrl: string;
@@ -38,10 +43,11 @@ export interface RequestOptions {
 type QueryValue = string | number | boolean | null | undefined | Array<string | number | boolean>;
 type QueryParams = Record<string, QueryValue> | object;
 export declare class RestClient {
+    private readonly onTransportFailure?;
     readonly config: Required<Pick<DooverClientConfig, "dataRestUrl" | "controlApiUrl" | "dataWssUrl" | "sharing" | "impersonateUserStorageKey">> & Pick<DooverClientConfig, "organisationId" | "fetchImpl" | "webSocketImpl" | "webSocketFactory">;
     readonly auth: DooverAuth | null;
     private stats;
-    constructor(config: DooverClientConfig, auth?: DooverAuth);
+    constructor(config: DooverClientConfig, auth?: DooverAuth, onTransportFailure?: (() => void) | undefined);
     /** Attach a stats collector. Call with `null` to detach. */
     setStats(stats: DooverStatsCollector | null): void;
     request<T>(options: RequestOptions): Promise<T>;

package/dist/http/rest-client.js

@@ -3,7 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.RestClient = void 0;
 const errors_js_1 = require("./errors.js");
 class RestClient {
-    constructor(config, auth) {
+    constructor(config, auth, onTransportFailure) {
+        this.onTransportFailure = onTransportFailure;
         this.stats = null;
         this.config = {
             ...config,
@@ -94,12 +95,19 @@ class RestClient {
             }
         }
         const fetchImpl = this.config.fetchImpl ?? fetch;
-        return fetchImpl(request.url, {
-            method: request.method,
-            headers: request.headers,
-            body: request.body,
-            credentials: request.credentials,
-        });
+        try {
+            return await fetchImpl(request.url, {
+                method: request.method,
+                headers: request.headers,
+                body: request.body,
+                credentials: request.credentials,
+            });
+        }
+        catch (error) {
+            // Auth preparation, HTTP errors and JSON parsing are outside this boundary.
+            this.onTransportFailure?.();
+            throw error;
+        }
     }
     get(path, query, baseUrl) {
         return this.request({ path, query, baseUrl });

package/dist/index.d.ts

@@ -60,3 +60,6 @@ export type * from "./types/viewer.js";
 export type * from "./types/audit.js";
 export { DV_AUDIT_CHANNEL } from "./types/audit.js";
 export { addTimestampToMessage, extractSnowflakeId, generateSnowflakeIdAtTime, } from "./utils/snowflake.js";
+export { browserNetworkStatus, createNetworkStatusStore } from "./client/network-status.js";
+export type { NetworkStatusSource, NetworkStatusSnapshot } from "./client/network-status.js";
+export type { ServiceReachability, ServiceReachabilitySource, ReachabilityOptions } from "./client/service-reachability.js";

package/dist/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.extractSnowflakeId = exports.addTimestampToMessage = exports.DV_AUDIT_CHANNEL = exports.getIdentifierFromPath = exports.DooverDataProvider = exports.DooverValidationError = exports.DooverGatewayError = exports.DooverApiError = exports.RestClient = exports.GatewayClient = exports.buildAuth = exports.DooverAuthError = exports.AuthProfile = exports.DooverTokenAuth = exports.CookieAuth = exports.DooverAuth = exports.mergeBatchResponses = exports.chunkBatchItems = exports.MAX_BATCH_ITEMS = exports.splitRequestOptions = exports.isDooverRequestOptions = exports.requestOptions = exports.DEFAULT_OFFLINE_RETENTION_MS = exports.MemoryOfflineStorageAdapter = exports.OfflineDataClient = exports.DooverOfflineError = exports.AmbiguousWriteError = exports.UnsupportedCapabilityError = exports.ALL_CAPABILITIES = exports.DooverRpcError = exports.RpcDispatcher = exports.UsersApi = exports.TurnApi = exports.ProcessorsApi = exports.PermissionsApi = exports.OrganisationsApi = exports.NotificationsApi = exports.MessagesApi = exports.ConnectionsApi = exports.ChannelsApi = exports.AlarmsApi = exports.AggregatesApi = exports.AgentsApi = exports.DooverStatsCollector = exports.resetDooverClient = exports.peekDooverClient = exports.getDooverClient = exports.MultiplexClient = exports.LocalAgentClient = exports.DooverClient = void 0;
-exports.generateSnowflakeIdAtTime = void 0;
+exports.createNetworkStatusStore = exports.browserNetworkStatus = exports.generateSnowflakeIdAtTime = void 0;
 var doover_client_js_1 = require("./client/doover-client.js");
 Object.defineProperty(exports, "DooverClient", { enumerable: true, get: function () { return doover_client_js_1.DooverClient; } });
 var local_agent_client_js_1 = require("./client/local-agent-client.js");
@@ -90,3 +90,6 @@ var snowflake_js_1 = require("./utils/snowflake.js");
 Object.defineProperty(exports, "addTimestampToMessage", { enumerable: true, get: function () { return snowflake_js_1.addTimestampToMessage; } });
 Object.defineProperty(exports, "extractSnowflakeId", { enumerable: true, get: function () { return snowflake_js_1.extractSnowflakeId; } });
 Object.defineProperty(exports, "generateSnowflakeIdAtTime", { enumerable: true, get: function () { return snowflake_js_1.generateSnowflakeIdAtTime; } });
+var network_status_js_1 = require("./client/network-status.js");
+Object.defineProperty(exports, "browserNetworkStatus", { enumerable: true, get: function () { return network_status_js_1.browserNetworkStatus; } });
+Object.defineProperty(exports, "createNetworkStatusStore", { enumerable: true, get: function () { return network_status_js_1.createNetworkStatusStore; } });

package/dist/react/index.d.ts

@@ -36,3 +36,4 @@ export { useTurnCredentials } from "./useTurnCredentials.js";
 export { useAgentTokenState, useSetAgentTokenPolicy, useSetAgentAuthLock, useRevokeAgentTokens, useSetRevocationFloor, useCreateAdhocToken, useCreateDeviceToken, agentTokenStateQueryKey, } from "./useAgentTokenState.js";
 export type { UseAgentTokenStateOptions } from "./useAgentTokenState.js";
 export { getSharedQueryClient, resetSharedQueryClient, } from "./sharedQueryClient.js";
+export { useServiceReachability } from "./useServiceReachability.js";

package/dist/react/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resetSharedQueryClient = exports.getSharedQueryClient = exports.agentTokenStateQueryKey = exports.useCreateDeviceToken = exports.useCreateAdhocToken = exports.useSetRevocationFloor = exports.useRevokeAgentTokens = exports.useSetAgentAuthLock = exports.useSetAgentTokenPolicy = exports.useAgentTokenState = exports.useTurnCredentials = exports.useDeviceMap = exports.multiAgentChannelMessagesQueryKey = exports.useMultiAgentChannelMessages = exports.multiAgentAggregatesQueryKey = exports.useMultiAgentAggregates = exports.useSendRpc = exports.invocationLogsQueryKey = exports.useInvocationLogs = exports.channelMessageQueryKey = exports.useChannelMessage = exports.channelMessagesQueryKey = exports.useChannelMessages = exports.useUpdateMessage = exports.useUpdateAggregate = exports.useSendMessage = exports.useAgentChannel = exports.channelAggregateQueryKey = exports.useChannelAggregate = exports.useChannelSubscription = exports.agentConnectionsQueryKey = exports.useAgentConnections = exports.useConnectionState = exports.hasOfflineStatus = exports.useOfflineStatus = exports.useClientStatus = exports.useDooverClient = exports.DooverProvider = void 0;
+exports.useServiceReachability = exports.resetSharedQueryClient = exports.getSharedQueryClient = exports.agentTokenStateQueryKey = exports.useCreateDeviceToken = exports.useCreateAdhocToken = exports.useSetRevocationFloor = exports.useRevokeAgentTokens = exports.useSetAgentAuthLock = exports.useSetAgentTokenPolicy = exports.useAgentTokenState = exports.useTurnCredentials = exports.useDeviceMap = exports.multiAgentChannelMessagesQueryKey = exports.useMultiAgentChannelMessages = exports.multiAgentAggregatesQueryKey = exports.useMultiAgentAggregates = exports.useSendRpc = exports.invocationLogsQueryKey = exports.useInvocationLogs = exports.channelMessageQueryKey = exports.useChannelMessage = exports.channelMessagesQueryKey = exports.useChannelMessages = exports.useUpdateMessage = exports.useUpdateAggregate = exports.useSendMessage = exports.useAgentChannel = exports.channelAggregateQueryKey = exports.useChannelAggregate = exports.useChannelSubscription = exports.agentConnectionsQueryKey = exports.useAgentConnections = exports.useConnectionState = exports.hasOfflineStatus = exports.useOfflineStatus = exports.useClientStatus = exports.useDooverClient = exports.DooverProvider = void 0;
 var context_js_1 = require("./context.js");
 Object.defineProperty(exports, "DooverProvider", { enumerable: true, get: function () { return context_js_1.DooverProvider; } });
 Object.defineProperty(exports, "useDooverClient", { enumerable: true, get: function () { return context_js_1.useDooverClient; } });
@@ -60,3 +60,5 @@ Object.defineProperty(exports, "agentTokenStateQueryKey", { enumerable: true, ge
 var sharedQueryClient_js_1 = require("./sharedQueryClient.js");
 Object.defineProperty(exports, "getSharedQueryClient", { enumerable: true, get: function () { return sharedQueryClient_js_1.getSharedQueryClient; } });
 Object.defineProperty(exports, "resetSharedQueryClient", { enumerable: true, get: function () { return sharedQueryClient_js_1.resetSharedQueryClient; } });
+var useServiceReachability_js_1 = require("./useServiceReachability.js");
+Object.defineProperty(exports, "useServiceReachability", { enumerable: true, get: function () { return useServiceReachability_js_1.useServiceReachability; } });

package/dist/react/useOfflineStatus.js

@@ -3,25 +3,39 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.hasOfflineStatus = hasOfflineStatus;
 exports.useOfflineStatus = useOfflineStatus;
 const react_1 = require("react");
+const network_status_js_1 = require("../client/network-status.js");
 const context_js_1 = require("./context.js");
 function hasOfflineStatus(client) {
-    return (!!client &&
-        typeof client === "object" &&
-        typeof client.getOfflineStatus === "function" &&
-        typeof client.onOfflineStatusChange === "function");
+    return !!client && typeof client === "object" &&
+        "getOfflineStatus" in client && typeof client.getOfflineStatus === "function" &&
+        "onOfflineStatusChange" in client && typeof client.onOfflineStatusChange === "function";
 }
-const UNAVAILABLE_OFFLINE_STATUS = {
-    online: true,
-    state: "online",
-    isOfflineFallback: false,
-    isExpired: false,
-    at: 0,
+const SERVER_OFFLINE_STATUS = {
+    online: true, state: "online", isOfflineFallback: false, isExpired: false, at: 0,
 };
 function useOfflineStatus() {
     const client = (0, context_js_1.useDooverClient)();
-    return (0, react_1.useSyncExternalStore)((listener) => hasOfflineStatus(client)
-        ? client.onOfflineStatusChange(listener)
-        : () => undefined, () => hasOfflineStatus(client)
-        ? client.getOfflineStatus()
-        : UNAVAILABLE_OFFLINE_STATUS, () => UNAVAILABLE_OFFLINE_STATUS);
+    const store = (0, react_1.useMemo)(() => {
+        if (hasOfflineStatus(client)) {
+            return {
+                subscribe: (listener) => client.onOfflineStatusChange(listener),
+                getSnapshot: () => client.getOfflineStatus(),
+            };
+        }
+        const network = client.networkStatus ?? network_status_js_1.browserNetworkStatus;
+        let previous = network.getSnapshot();
+        let snapshot = { ...SERVER_OFFLINE_STATUS, ...previous };
+        return {
+            subscribe: (listener) => network.subscribe(listener),
+            getSnapshot: () => {
+                const next = network.getSnapshot();
+                if (next !== previous) {
+                    previous = next;
+                    snapshot = { ...SERVER_OFFLINE_STATUS, ...next };
+                }
+                return snapshot;
+            },
+        };
+    }, [client]);
+    return (0, react_1.useSyncExternalStore)(store.subscribe, store.getSnapshot, () => SERVER_OFFLINE_STATUS);
 }

package/dist/react/useServiceReachability.d.ts

@@ -0,0 +1,5 @@
+import type { ServiceReachability } from "../client/service-reachability.js";
+/** Observe data API reachability even when the browser incorrectly reports online.
+ * Shares one polling loop per client; the final unmount stops checks.
+ * Clients without a reachability source return unknown and make no requests. */
+export declare function useServiceReachability(): ServiceReachability;

package/dist/react/useServiceReachability.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useServiceReachability = useServiceReachability;
+const react_1 = require("react");
+const context_js_1 = require("./context.js");
+const unknownSnapshot = () => "unknown";
+const noop = () => { };
+/** Observe data API reachability even when the browser incorrectly reports online.
+ * Shares one polling loop per client; the final unmount stops checks.
+ * Clients without a reachability source return unknown and make no requests. */
+function useServiceReachability() {
+    const source = (0, context_js_1.useDooverClient)().reachability;
+    const subscribe = (0, react_1.useCallback)((listener) => source?.subscribe(listener) ?? noop, [source]);
+    const getSnapshot = (0, react_1.useCallback)(() => source?.getSnapshot() ?? "unknown", [source]);
+    return (0, react_1.useSyncExternalStore)(subscribe, getSnapshot, unknownSnapshot);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "doover-js",
-  "version": "0.12.1",
+  "version": "0.13.1",
   "description": "TypeScript client for Doover.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -641,7 +641,19 @@
       },
       "default": "./dist/react/useUpdateMessage.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./react/useServiceReachability": {
+      "module": "./dist/esm/react/useServiceReachability.js",
+      "import": {
+        "types": "./dist/esm/react/useServiceReachability.d.ts",
+        "default": "./dist/esm/react/useServiceReachability.js"
+      },
+      "require": {
+        "types": "./dist/react/useServiceReachability.d.ts",
+        "default": "./dist/react/useServiceReachability.js"
+      },
+      "default": "./dist/react/useServiceReachability.js"
+    }
   },
   "repository": {
     "type": "git",
@@ -866,6 +878,9 @@
       ],
       "react/useUpdateMessage": [
         "dist/react/useUpdateMessage.d.ts"
+      ],
+      "react/useServiceReachability": [
+        "dist/react/useServiceReachability.d.ts"
       ]
     }
   }