doover-js 0.11.0 → 0.13.0

package/dist/client/multiplex-client.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MultiplexClient = void 0;
-const multiplex_merge_1 = require("./multiplex-merge");
-const batch_1 = require("../types/batch");
-const errors_1 = require("./errors");
-const snowflake_1 = require("../utils/snowflake");
-const multiplex_gateway_1 = require("./multiplex-gateway");
+const multiplex_merge_js_1 = require("./multiplex-merge.js");
+const batch_js_1 = require("../types/batch.js");
+const errors_js_1 = require("./errors.js");
+const snowflake_js_1 = require("../utils/snowflake.js");
+const multiplex_gateway_js_1 = require("./multiplex-gateway.js");
 /** "<subclient>.<method>" → spec. Drives the generic non-core facades. */
 const NONCORE_METHODS = {
     // alarms
@@ -246,7 +246,7 @@ class MultiplexClient {
             gatewayMembersForAgent: (agentId) => this.membersForAgentWithCapability(agentId, "gateway.subscribe")
                 .map(({ id, client }) => ({ id, gateway: client.gateway })),
         };
-        return new multiplex_gateway_1.MultiplexGateway(host);
+        return new multiplex_gateway_js_1.MultiplexGateway(host);
     }
     // ===== helpers =====
     /** Resolve the optional `{ sources?: string[] }` bag from a method's trailing
@@ -275,7 +275,7 @@ class MultiplexClient {
     /** Throw if no enabled member supports `cap` at all (regardless of agent). */
     assertSomeMemberSupports(cap) {
         if (!this.enabledClients().some(({ client }) => client.supports(cap))) {
-            throw new errors_1.UnsupportedCapabilityError(cap, this.clientId);
+            throw new errors_js_1.UnsupportedCapabilityError(cap, this.clientId);
         }
     }
     isNotFound(err) {
@@ -286,7 +286,7 @@ class MultiplexClient {
             return "messages.listHistorical";
         if (params?.before) {
             try {
-                const { timestamp: ts } = (0, snowflake_1.extractSnowflakeId)(params.before);
+                const { timestamp: ts } = (0, snowflake_js_1.extractSnowflakeId)(params.before);
                 if (typeof ts === "number" && ts < Date.now() - 24 * 60 * 60 * 1000)
                     return "messages.listHistorical";
             }
@@ -295,7 +295,7 @@ class MultiplexClient {
         return "messages.list";
     }
     unsupportedMethod(_method, cap) {
-        return () => Promise.reject(new errors_1.UnsupportedCapabilityError(cap, this.clientId));
+        return () => Promise.reject(new errors_js_1.UnsupportedCapabilityError(cap, this.clientId));
     }
     /**
      * Route a cross-agent batch mutation.
@@ -324,13 +324,13 @@ class MultiplexClient {
                 if (sources && sources.length === 1) {
                     const only = members.find((m) => m.id === sources[0]);
                     if (!only)
-                        throw new errors_1.UnsupportedCapabilityError(cap, sources[0]);
+                        throw new errors_js_1.UnsupportedCapabilityError(cap, sources[0]);
                     members = [only];
                 }
                 if (members.length === 0)
-                    throw new errors_1.UnsupportedCapabilityError(cap, self.clientId);
+                    throw new errors_js_1.UnsupportedCapabilityError(cap, self.clientId);
                 if (members.length > 1) {
-                    throw new errors_1.AmbiguousWriteError(cap, members.map((m) => m.id));
+                    throw new errors_js_1.AmbiguousWriteError(cap, members.map((m) => m.id));
                 }
                 const target = members[0];
                 const group = groups.get(target.id) ?? {
@@ -362,7 +362,7 @@ class MultiplexClient {
                     };
                 });
             }
-            return (0, batch_1.mergeBatchResponses)([
+            return (0, batch_js_1.mergeBatchResponses)([
                 { items: results, count: results.length, succeeded: 0, failed: 0 },
             ]);
         };
@@ -409,13 +409,13 @@ class MultiplexClient {
             if (sources && sources.length === 1) {
                 const only = members.find((m) => m.id === sources[0]);
                 if (!only)
-                    throw new errors_1.UnsupportedCapabilityError(cap, sources[0]);
+                    throw new errors_js_1.UnsupportedCapabilityError(cap, sources[0]);
                 members = [only];
             }
             if (members.length === 0)
-                throw new errors_1.UnsupportedCapabilityError(cap, self.clientId);
+                throw new errors_js_1.UnsupportedCapabilityError(cap, self.clientId);
             if (members.length > 1)
-                throw new errors_1.AmbiguousWriteError(cap, members.map((m) => m.id));
+                throw new errors_js_1.AmbiguousWriteError(cap, members.map((m) => m.id));
             const target = members[0];
             const subclient = method.split(".")[0];
             const fnName = method.split(".")[1];
@@ -432,7 +432,7 @@ class MultiplexClient {
             const agentId = self.extractAgentId(args);
             const members = self.candidates(agentId, cap, sources);
             if (members.length === 0)
-                throw new errors_1.UnsupportedCapabilityError(cap, self.clientId);
+                throw new errors_js_1.UnsupportedCapabilityError(cap, self.clientId);
             const subclient = method.split(".")[0];
             const fnName = method.split(".")[1];
             let lastErr;
@@ -458,7 +458,7 @@ class MultiplexClient {
             const agentId = self.extractAgentId(args);
             const members = self.candidates(agentId, cap, sources);
             if (members.length === 0)
-                throw new errors_1.UnsupportedCapabilityError(cap, self.clientId);
+                throw new errors_js_1.UnsupportedCapabilityError(cap, self.clientId);
             const subclient = method.split(".")[0];
             const fnName = method.split(".")[1];
             let lastErr;
@@ -485,7 +485,7 @@ class MultiplexClient {
                 self.assertSomeMemberSupports("channels.list");
                 const members = self.candidates(agentId, "channels.list", sources);
                 const perMember = await Promise.all(members.map((m) => m.client.channels.listChannels(...args)));
-                return (0, multiplex_merge_1.dedupeBy)([].concat(...perMember), (c) => c.name);
+                return (0, multiplex_merge_js_1.dedupeBy)([].concat(...perMember), (c) => c.name);
             },
             async getChannel(agentIdOrId, ...rest) {
                 const { args, sources } = self.splitSourcesOption([agentIdOrId, ...rest]);
@@ -566,7 +566,7 @@ class MultiplexClient {
                 self.assertSomeMemberSupports(implied);
                 const members = self.candidates(agentId, implied, sources);
                 const perMember = await Promise.all(members.map((m) => m.client.messages.listMessages(...args)));
-                return (0, multiplex_merge_1.mergeMessages)(perMember, { order: params?.order ?? "desc", limit: params?.limit });
+                return (0, multiplex_merge_js_1.mergeMessages)(perMember, { order: params?.order ?? "desc", limit: params?.limit });
             },
             async getMessage(agentIdOrId, ...rest) {
                 const { args, sources } = self.splitSourcesOption([agentIdOrId, ...rest]);
@@ -620,7 +620,7 @@ class MultiplexClient {
                     members = members.filter((m) => allow.has(m.id));
                 }
                 const responses = await Promise.all(members.map((m) => m.client.agents.listAgents(...args)));
-                const merged = (0, multiplex_merge_1.dedupeBy)([].concat(...responses.map((r) => (r.agents ?? r.results ?? []))), (a) => a.id);
+                const merged = (0, multiplex_merge_js_1.dedupeBy)([].concat(...responses.map((r) => (r.agents ?? r.results ?? []))), (a) => a.id);
                 return { agents: merged, results: merged, count: merged.length };
             },
             async getMultiAgentMessages(channelName, ...rest) {
@@ -632,7 +632,7 @@ class MultiplexClient {
                     members = members.filter((m) => allow.has(m.id));
                 }
                 const responses = await Promise.all(members.map((m) => m.client.agents.getMultiAgentMessages(...args)));
-                const merged = (0, multiplex_merge_1.mergeMessages)(responses.map((r) => r.results), { order: "desc" });
+                const merged = (0, multiplex_merge_js_1.mergeMessages)(responses.map((r) => r.results), { order: "desc" });
                 // Union each member's per-agent resume cursors so a paginating caller
                 // keeps walking. If one agent lives in two members with different
                 // cursors, keep the lexically-highest (newest) — resuming from the
@@ -660,7 +660,7 @@ class MultiplexClient {
                     members = members.filter((m) => allow.has(m.id));
                 }
                 const responses = await Promise.all(members.map((m) => m.client.agents.getMultiAgentAggregates(...args)));
-                const merged = (0, multiplex_merge_1.dedupeBy)([].concat(...responses.map((r) => r.results)), (a) => a.agent_id);
+                const merged = (0, multiplex_merge_js_1.dedupeBy)([].concat(...responses.map((r) => r.results)), (a) => a.agent_id);
                 return { results: merged, count: merged.length };
             },
             getTokenState: self.makeFanoutFirst("agents.getTokenState", "agents.tokenRead"),
@@ -683,7 +683,7 @@ class MultiplexClient {
                 const spec = NONCORE_METHODS[key];
                 if (!spec) {
                     // Unknown method on a non-core subclient — treat as unsupported (read).
-                    return () => Promise.reject(new errors_1.UnsupportedCapabilityError(self.guessNonCoreCap(subclientName), self.clientId));
+                    return () => Promise.reject(new errors_js_1.UnsupportedCapabilityError(self.guessNonCoreCap(subclientName), self.clientId));
                 }
                 if (spec.kind === "write-route") {
                     return self.routedWrite(key, spec.cap);
@@ -694,7 +694,7 @@ class MultiplexClient {
                     const agentId = !spec.agentScoped ? undefined : self.extractAgentId(args);
                     let members = self.candidates(agentId, spec.cap, sources);
                     if (members.length === 0)
-                        throw new errors_1.UnsupportedCapabilityError(spec.cap, self.clientId);
+                        throw new errors_js_1.UnsupportedCapabilityError(spec.cap, self.clientId);
                     let lastErr;
                     for (const m of members) {
                         try {

package/dist/client/multiplex-gateway.d.ts

@@ -1,6 +1,6 @@
-import type { GatewayClientLike } from "./data-client";
-import type { ChannelRef } from "../types/common";
-import type { WebSocketSession } from "../gateway/types";
+import type { GatewayClientLike } from "./data-client.js";
+import type { ChannelRef } from "../types/common.js";
+import type { WebSocketSession } from "../gateway/types.js";
 /** Minimal view of what MultiplexGateway needs from the owning multiplex. */
 export interface MultiplexGatewayHost {
     /** Enabled members with `gateway.subscribe`. */

package/dist/client/multiplex-merge.d.ts

@@ -1,4 +1,4 @@
-import type { MessageStructure } from "../types/common";
+import type { MessageStructure } from "../types/common.js";
 /** Keep the first item for each key; preserve input order otherwise. */
 export declare function dedupeBy<T>(items: T[], keyOf: (item: T) => string): T[];
 /**

package/dist/client/network-status.d.ts

@@ -0,0 +1,17 @@
+/** Network availability is independent of the Doover gateway connection. */
+export interface NetworkStatusSnapshot {
+    readonly online: boolean;
+    readonly at: number;
+}
+/** Snapshots must retain their identity until the status changes. */
+export interface NetworkStatusSource {
+    getSnapshot(): NetworkStatusSnapshot;
+    subscribe(listener: () => void): () => void;
+}
+/** A source that native network callbacks can update. */
+export declare function createNetworkStatusStore(initialOnline: boolean): {
+    getSnapshot: () => NetworkStatusSnapshot;
+    subscribe(listener: () => void): () => void;
+    setOnline(online: boolean): void;
+};
+export declare const browserNetworkStatus: NetworkStatusSource;

package/dist/client/network-status.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.browserNetworkStatus = void 0;
+exports.createNetworkStatusStore = createNetworkStatusStore;
+/** A source that native network callbacks can update. */
+function createNetworkStatusStore(initialOnline) {
+    let snapshot = { online: initialOnline, at: Date.now() };
+    const listeners = new Set();
+    return {
+        getSnapshot: () => snapshot,
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => { listeners.delete(listener); };
+        },
+        setOnline(online) {
+            if (online === snapshot.online)
+                return;
+            snapshot = { online, at: Date.now() };
+            listeners.forEach((listener) => listener());
+        },
+    };
+}
+function readBrowserOnline() {
+    const nav = typeof window !== "undefined" ? window.navigator
+        : typeof navigator !== "undefined" ? navigator : undefined;
+    return typeof nav?.onLine === "boolean" ? nav.onLine : true;
+}
+// Listen only while observed. getSnapshot also refreshes after periods with
+// no subscribers, including initial offline loads. No browser globals at import.
+function createBrowserNetworkStatus() {
+    let snapshot = { online: true, at: 0 };
+    const listeners = new Set();
+    let detach;
+    const getSnapshot = () => {
+        const online = readBrowserOnline();
+        if (online !== snapshot.online)
+            snapshot = { online, at: Date.now() };
+        return snapshot;
+    };
+    const refresh = () => {
+        getSnapshot();
+        // A request may already have read the new snapshot before this event.
+        // Still notify mounted consumers; React ignores an unchanged snapshot.
+        listeners.forEach((listener) => listener());
+    };
+    return {
+        getSnapshot,
+        subscribe(listener) {
+            listeners.add(listener);
+            if (!detach && typeof window !== "undefined") {
+                const target = window;
+                target.addEventListener("online", refresh);
+                target.addEventListener("offline", refresh);
+                detach = () => {
+                    target.removeEventListener("online", refresh);
+                    target.removeEventListener("offline", refresh);
+                };
+            }
+            refresh();
+            return () => {
+                listeners.delete(listener);
+                if (!listeners.size) {
+                    detach?.();
+                    detach = undefined;
+                }
+            };
+        },
+    };
+}
+exports.browserNetworkStatus = createBrowserNetworkStatus();

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

@@ -1,5 +1,6 @@
-import type { AgentScope, AgentsApiLike, AggregatesApiLike, AlarmsApiLike, ChannelsApiLike, ConnectionsApiLike, DataClient, DataClientStatus, GatewayClientLike, MessagesApiLike, NotificationsApiLike, PermissionsApiLike, ProcessorsApiLike, RpcDispatcherLike, TurnApiLike, UsersApiLike } from "./data-client";
-import type { Capability } from "./capabilities";
+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;
 export type OfflineCacheMode = "read-through" | "network-first" | "cache-first" | "cache-only";
 export interface OfflineReadCacheOptions {
@@ -83,18 +84,22 @@ 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;
+    private unsubscribeNetwork?;
     readonly agents: AgentsApiLike;
     readonly channels: ChannelsApiLike;
     readonly messages: MessagesApiLike;

package/dist/client/offline-cache.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OfflineDataClient = exports.MemoryOfflineStorageAdapter = exports.DEFAULT_OFFLINE_RETENTION_MS = void 0;
-const errors_1 = require("./errors");
-const request_options_1 = require("./request-options");
+const network_status_js_1 = require("./network-status.js");
+const errors_js_1 = require("./errors.js");
+const request_options_js_1 = require("./request-options.js");
 exports.DEFAULT_OFFLINE_RETENTION_MS = 7 * 24 * 60 * 60 * 1000;
 class MemoryOfflineStorageAdapter {
     constructor() {
@@ -57,6 +58,7 @@ class OfflineDataClient {
         this.offlineStatus = INITIAL_OFFLINE_STATUS;
         this.persistQueue = Promise.resolve();
         this.client = options.client;
+        this.networkStatus = options.networkStatus ?? options.client.networkStatus ?? network_status_js_1.browserNetworkStatus;
         this.storage = options.storage;
         this.scope = options.scope;
         this.defaultRetentionMs = options.defaultRetentionMs ?? exports.DEFAULT_OFFLINE_RETENTION_MS;
@@ -90,19 +92,30 @@ 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) {
@@ -128,7 +141,7 @@ class OfflineDataClient {
         const target = this.client.agents;
         return {
             listAgents: ((...rawArgs) => {
-                const { args, request } = (0, request_options_1.splitRequestOptions)(rawArgs);
+                const { args, request } = (0, request_options_js_1.splitRequestOptions)(rawArgs);
                 return this.readCached(() => target.listAgents(...this.withDelegateOptions(args, request)), {
                     operation: "agents.listAgents",
                     kind: "agents.list",
@@ -137,7 +150,7 @@ class OfflineDataClient {
                 });
             }),
             getMultiAgentMessages: ((channelName, ...rest) => {
-                const { args, request } = (0, request_options_1.splitRequestOptions)([channelName, ...rest]);
+                const { args, request } = (0, request_options_js_1.splitRequestOptions)([channelName, ...rest]);
                 const params = args[1];
                 return this.readCached(() => target.getMultiAgentMessages(...this.withDelegateOptions(args, request)), {
                     operation: "agents.getMultiAgentMessages",
@@ -149,7 +162,7 @@ class OfflineDataClient {
                 });
             }),
             getMultiAgentAggregates: ((channelName, ...rest) => {
-                const { args, request } = (0, request_options_1.splitRequestOptions)([channelName, ...rest]);
+                const { args, request } = (0, request_options_js_1.splitRequestOptions)([channelName, ...rest]);
                 const params = args[1];
                 return this.readCached(() => target.getMultiAgentAggregates(...this.withDelegateOptions(args, request)), {
                     operation: "agents.getMultiAgentAggregates",
@@ -166,7 +179,7 @@ class OfflineDataClient {
         const target = this.client.channels;
         return {
             listChannels: ((...rawArgs) => {
-                const { args, request } = (0, request_options_1.splitRequestOptions)(rawArgs);
+                const { args, request } = (0, request_options_js_1.splitRequestOptions)(rawArgs);
                 const agentId = extractAgentId(args);
                 return this.readCached(() => target.listChannels(...this.withDelegateOptions(args, request)), {
                     operation: "channels.listChannels",
@@ -177,7 +190,7 @@ class OfflineDataClient {
                 });
             }),
             getChannel: ((...rawArgs) => {
-                const { args, request } = (0, request_options_1.splitRequestOptions)(rawArgs);
+                const { args, request } = (0, request_options_js_1.splitRequestOptions)(rawArgs);
                 const { agentId, channelName } = extractChannelId(args);
                 return this.readCached(() => target.getChannel(...this.withDelegateOptions(args, request)), {
                     operation: "channels.getChannel",
@@ -199,7 +212,7 @@ class OfflineDataClient {
         const target = this.client.aggregates;
         return {
             getAggregate: ((...rawArgs) => {
-                const { args, request } = (0, request_options_1.splitRequestOptions)(rawArgs);
+                const { args, request } = (0, request_options_js_1.splitRequestOptions)(rawArgs);
                 const { agentId, channelName } = extractChannelId(args);
                 return this.readCached(() => target.getAggregate(...this.withDelegateOptions(args, request)), {
                     operation: "aggregates.getAggregate",
@@ -217,7 +230,7 @@ class OfflineDataClient {
             patchAggregate: this.offlineGuard("aggregates.patchAggregate", target.patchAggregate.bind(target)),
             batchPatchAggregates: this.offlineGuard("aggregates.batchPatchAggregates", target.batchPatchAggregates.bind(target)),
             getAggregateAttachment: ((...rawArgs) => {
-                const { args, request } = (0, request_options_1.splitRequestOptions)(rawArgs);
+                const { args, request } = (0, request_options_js_1.splitRequestOptions)(rawArgs);
                 const { agentId, channelName } = extractChannelId(args);
                 const attachmentId = String(args[2] ?? args[1] ?? "");
                 return this.readBlobCached(() => target.getAggregateAttachment(...this.withDelegateOptions(args, request)), {
@@ -235,7 +248,7 @@ class OfflineDataClient {
         const target = this.client.messages;
         return {
             listMessages: ((...rawArgs) => {
-                const { args, request } = (0, request_options_1.splitRequestOptions)(rawArgs);
+                const { args, request } = (0, request_options_js_1.splitRequestOptions)(rawArgs);
                 const { agentId, channelName } = extractChannelId(args);
                 return this.readCached(() => target.listMessages(...this.withDelegateOptions(args, request)), {
                     operation: "messages.listMessages",
@@ -249,7 +262,7 @@ class OfflineDataClient {
                 });
             }),
             getMessage: ((...rawArgs) => {
-                const { args, request } = (0, request_options_1.splitRequestOptions)(rawArgs);
+                const { args, request } = (0, request_options_js_1.splitRequestOptions)(rawArgs);
                 const { agentId, channelName } = extractChannelId(args);
                 const messageId = String(args[2] ?? args[1] ?? "");
                 return this.readCached(() => target.getMessage(...this.withDelegateOptions(args, request)), {
@@ -274,7 +287,7 @@ class OfflineDataClient {
             batchDeleteMessages: this.offlineGuard("messages.batchDeleteMessages", target.batchDeleteMessages.bind(target)),
             getTimeseries: ((...args) => target.getTimeseries(...args)),
             getMessageAttachment: ((...rawArgs) => {
-                const { args, request } = (0, request_options_1.splitRequestOptions)(rawArgs);
+                const { args, request } = (0, request_options_js_1.splitRequestOptions)(rawArgs);
                 const { agentId, channelName } = extractChannelId(args);
                 const messageId = String(args[2] ?? args[1] ?? "");
                 const attachmentId = String(args[3] ?? args[2] ?? "");
@@ -351,7 +364,7 @@ class OfflineDataClient {
     offlineGuard(operation, fn) {
         return ((...args) => {
             if (!this.isOnline())
-                throw new errors_1.DooverOfflineError(operation);
+                throw new errors_js_1.DooverOfflineError(operation);
             return fn(...args);
         });
     }
@@ -416,7 +429,7 @@ class OfflineDataClient {
                 isOfflineFallback: !this.isOnline(),
                 isExpired: false,
             });
-            throw new errors_1.DooverOfflineError(descriptor.operation, `No cached attachment is available for "${descriptor.operation}" while offline.`, key);
+            throw new errors_js_1.DooverOfflineError(descriptor.operation, `No cached attachment is available for "${descriptor.operation}" while offline.`, key);
         }
         if (effective.mode === "cache-first") {
             const cached = await this.storage.getBlob?.(key);
@@ -468,7 +481,7 @@ class OfflineDataClient {
             isOfflineFallback: !this.isOnline(),
             isExpired: false,
         });
-        throw new errors_1.DooverOfflineError(operation, `No cached data is available for "${operation}" while offline.`, key);
+        throw new errors_js_1.DooverOfflineError(operation, `No cached data is available for "${operation}" while offline.`, key);
     }
     async tryReadRecord(key, allowExpired) {
         const record = await this.storage.getJson(key);
@@ -657,7 +670,7 @@ class OfflineDataClient {
         return false;
     }
     withDelegateOptions(args, request) {
-        const delegate = (0, request_options_1.delegateRequestOptions)(request);
+        const delegate = (0, request_options_js_1.delegateRequestOptions)(request);
         return delegate ? [...args, delegate] : args;
     }
     cacheKey(descriptor) {
@@ -682,8 +695,7 @@ 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/client/provenance.d.ts

@@ -1,4 +1,4 @@
-import type { SourceProvenance } from "../types/provenance";
+import type { SourceProvenance } from "../types/provenance.js";
 /** A stamped value: adds `__source` to plain objects and their array elements.
  *  For object values, also adds `__source` to any known nested-object props
  *  (aggregate, message) and stamps elements of array-valued props. */

package/dist/client/request-options.d.ts

@@ -1,4 +1,4 @@
-import type { OfflineReadCacheOptions } from "./offline-cache";
+import type { OfflineReadCacheOptions } from "./offline-cache.js";
 export declare const REQUEST_OPTIONS_SYMBOL: unique symbol;
 export interface DooverRequestOptions {
     /**

package/dist/client/singleton.d.ts

@@ -1,5 +1,5 @@
-import type { DooverClientConfig } from "../http/rest-client";
-import { DooverClient } from "./doover-client";
+import type { DooverClientConfig } from "../http/rest-client.js";
+import { DooverClient } from "./doover-client.js";
 /**
  * Get the process-wide `DooverClient` instance, creating it on first call.
  *

package/dist/client/singleton.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getDooverClient = getDooverClient;
 exports.peekDooverClient = peekDooverClient;
 exports.resetDooverClient = resetDooverClient;
-const doover_client_1 = require("./doover-client");
+const doover_client_js_1 = require("./doover-client.js");
 const GLOBAL_KEY = "__doover_js_client__";
 function globalBag() {
     return globalThis;
@@ -32,7 +32,7 @@ function getDooverClient(config) {
         }
         return existing;
     }
-    const client = new doover_client_1.DooverClient(config);
+    const client = new doover_client_js_1.DooverClient(config);
     bag[GLOBAL_KEY] = client;
     return client;
 }

package/dist/client/status-tracker.d.ts

@@ -1,4 +1,4 @@
-import type { AgentScope, DataClientStatus, GatewayClientLike } from "./data-client";
+import type { AgentScope, DataClientStatus, GatewayClientLike } from "./data-client.js";
 /**
  * Tracks a `DataClient`'s realtime status by subscribing to its gateway's
  * `open` / `ready` / `close` / `wssError` events. Emits a fresh

package/dist/esm/apis/_args.d.ts

@@ -0,0 +1,16 @@
+export interface ChannelIdentifierLike {
+    agentId: string;
+    channelName: string;
+}
+export interface AgentIdentifierLike {
+    agentId: string;
+}
+export declare function resolveChannelArgs<TOptions>(args: unknown[]): {
+    agentId: string;
+    channelName: string;
+    options?: TOptions;
+};
+export declare function resolveAgentArgs<TOptions>(args: unknown[]): {
+    agentId: string;
+    options?: TOptions;
+};

package/dist/esm/apis/_args.js

@@ -0,0 +1,27 @@
+import { isDooverRequestOptions } from "../client/request-options.js";
+export function resolveChannelArgs(args) {
+    if (typeof args[0] === "string") {
+        const options = isDooverRequestOptions(args[2]) ? undefined : args[2];
+        return {
+            agentId: args[0],
+            channelName: args[1],
+            options: options,
+        };
+    }
+    const id = args[0];
+    const options = isDooverRequestOptions(args[1]) ? undefined : args[1];
+    return {
+        agentId: id.agentId,
+        channelName: id.channelName,
+        options: options,
+    };
+}
+export function resolveAgentArgs(args) {
+    if (typeof args[0] === "string") {
+        const options = isDooverRequestOptions(args[1]) ? undefined : args[1];
+        return { agentId: args[0], options: options };
+    }
+    const id = args[0];
+    const options = isDooverRequestOptions(args[1]) ? undefined : args[1];
+    return { agentId: id.agentId, options: options };
+}