doover-js 0.11.0 → 0.13.0

package/dist/auth/build-auth.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildAuth = buildAuth;
-const cookie_auth_1 = require("./cookie-auth");
-const doover_token_auth_1 = require("./doover-token-auth");
-const errors_1 = require("./errors");
+const cookie_auth_js_1 = require("./cookie-auth.js");
+const doover_token_auth_js_1 = require("./doover-token-auth.js");
+const errors_js_1 = require("./errors.js");
 const TOKEN_FIELDS = [
     "token",
     "tokenExpires",
@@ -43,7 +43,7 @@ function buildAuth(options) {
         // Validate mutual exclusivity.
         const hasRaw = TOKEN_FIELDS.some((k) => options[k] !== undefined);
         if (hasRaw || options.profile !== undefined || options.configManager !== undefined) {
-            throw new errors_1.DooverAuthError("Cannot combine 'auth' with raw auth config fields (token, profile, configManager, etc.)");
+            throw new errors_js_1.DooverAuthError("Cannot combine 'auth' with raw auth config fields (token, profile, configManager, etc.)");
         }
         return options.auth;
     }
@@ -51,12 +51,12 @@ function buildAuth(options) {
     let resolvedProfile = null;
     if (typeof options.profile === "string") {
         if (!options.configManager) {
-            throw new errors_1.DooverAuthError("A 'configManager' (AuthProfileStore) is required when 'profile' is a string. " +
+            throw new errors_js_1.DooverAuthError("A 'configManager' (AuthProfileStore) is required when 'profile' is a string. " +
                 "Use the doover-js/node subpath to import ConfigManager, or provide an AuthProfile directly.");
         }
         resolvedProfile = options.configManager.get(options.profile) ?? null;
         if (!resolvedProfile) {
-            throw new errors_1.DooverAuthError(`Profile '${options.profile}' not found in the config manager`);
+            throw new errors_js_1.DooverAuthError(`Profile '${options.profile}' not found in the config manager`);
         }
     }
     else if (options.profile instanceof Object && "profile" in options.profile) {
@@ -69,7 +69,7 @@ function buildAuth(options) {
     if (!hasTokenInput && !profileHasToken) {
         // No token data at all — fall back to cookie auth, which can still renew
         // the session when the app has told us where its auth server lives.
-        const auth = new cookie_auth_1.CookieAuth({
+        const auth = new cookie_auth_js_1.CookieAuth({
             authServerUrl: options.authServerUrl ?? resolvedProfile?.authServerUrl ?? null,
             fetchImpl: options.fetchImpl,
         });
@@ -79,7 +79,7 @@ function buildAuth(options) {
         return auth;
     }
     // Build DooverTokenAuth with explicit fields overriding profile values.
-    const auth = new doover_token_auth_1.DooverTokenAuth({
+    const auth = new doover_token_auth_js_1.DooverTokenAuth({
         token: options.token ?? undefined,
         tokenExpires: options.tokenExpires ?? undefined,
         refreshToken: options.refreshToken ?? undefined,

package/dist/auth/cookie-auth.d.ts

@@ -1,4 +1,4 @@
-import { DooverAuth } from "./doover-auth";
+import { DooverAuth } from "./doover-auth.js";
 export interface CookieAuthOptions {
     /**
      * Base URL of the auth server that serves the hosted-backend refresh

package/dist/auth/cookie-auth.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CookieAuth = void 0;
-const doover_auth_1 = require("./doover-auth");
+const doover_auth_js_1 = require("./doover-auth.js");
 /** Default FusionAuth hosted-backend refresh endpoint. */
 const DEFAULT_REFRESH_PATH = "/app/refresh/";
 /** Default name of the cookie holding the access token's expiry (Unix seconds). */
@@ -33,7 +33,7 @@ const ATTEMPT_TTL_MS = 5000;
  * reconnects, since `GatewayClient` awaits it before opening a socket), and
  * `handleUnauthorized` lets `RestClient` replay a 401 once after a renewal.
  */
-class CookieAuth extends doover_auth_1.DooverAuth {
+class CookieAuth extends doover_auth_js_1.DooverAuth {
     constructor(options = {}) {
         super();
         this.refreshInFlight = null;

package/dist/auth/doover-auth.d.ts

@@ -1,5 +1,5 @@
-import type { AuthProfile } from "./auth-profile";
-import type { AuthProfileStore } from "./auth-store";
+import type { AuthProfile } from "./auth-profile.js";
+import type { AuthProfileStore } from "./auth-store.js";
 /**
  * Abstract base class shared by cookie and token auth strategies.
  *

package/dist/auth/doover-token-auth.d.ts

@@ -1,6 +1,6 @@
-import { DooverAuth } from "./doover-auth";
-import type { AuthProfile } from "./auth-profile";
-import type { AuthProfileStore } from "./auth-store";
+import { DooverAuth } from "./doover-auth.js";
+import type { AuthProfile } from "./auth-profile.js";
+import type { AuthProfileStore } from "./auth-store.js";
 export declare class DooverTokenAuth extends DooverAuth {
     private token;
     private tokenExpires;

package/dist/auth/doover-token-auth.js

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DooverTokenAuth = void 0;
-const doover_auth_1 = require("./doover-auth");
-const errors_1 = require("./errors");
-const jwt_1 = require("./jwt");
+const doover_auth_js_1 = require("./doover-auth.js");
+const errors_js_1 = require("./errors.js");
+const jwt_js_1 = require("./jwt.js");
 /** Buffer in milliseconds before expiry at which we trigger a refresh (30 s). */
 const REFRESH_BUFFER_MS = 30000;
-class DooverTokenAuth extends doover_auth_1.DooverAuth {
+class DooverTokenAuth extends doover_auth_js_1.DooverAuth {
     constructor(options) {
         super();
         this.refreshInFlight = null;
@@ -63,7 +63,7 @@ class DooverTokenAuth extends doover_auth_1.DooverAuth {
     }
     async ensureReady() {
         if (this.authInvalid) {
-            throw new errors_1.DooverAuthError("Authentication is invalid; sign in again");
+            throw new errors_js_1.DooverAuthError("Authentication is invalid; sign in again");
         }
         if (!this.needsRefresh()) {
             return;
@@ -106,7 +106,7 @@ class DooverTokenAuth extends doover_auth_1.DooverAuth {
             this.tokenExpires = new Date(profile.tokenExpires);
         }
         if (!this.tokenExpires && this.token) {
-            this.tokenExpires = (0, jwt_1.decodeTokenExpiry)(this.token);
+            this.tokenExpires = (0, jwt_js_1.decodeTokenExpiry)(this.token);
         }
         if (!this.refreshToken && profile.refreshToken) {
             this.refreshToken = profile.refreshToken;
@@ -138,7 +138,7 @@ class DooverTokenAuth extends doover_auth_1.DooverAuth {
             !this.refreshToken ||
             !this.authServerClientId) {
             this.markAuthInvalid();
-            throw new errors_1.DooverAuthError("Cannot refresh token: missing authServerUrl, refreshToken, or authServerClientId");
+            throw new errors_js_1.DooverAuthError("Cannot refresh token: missing authServerUrl, refreshToken, or authServerClientId");
         }
         const url = new URL(`${this.authServerUrl}/oauth2/token`);
         url.searchParams.set("grant_type", "refresh_token");
@@ -154,25 +154,25 @@ class DooverTokenAuth extends doover_auth_1.DooverAuth {
             });
         }
         catch (err) {
-            throw new errors_1.DooverAuthError(`Token refresh request failed: ${err instanceof Error ? err.message : String(err)}`);
+            throw new errors_js_1.DooverAuthError(`Token refresh request failed: ${err instanceof Error ? err.message : String(err)}`);
         }
         if (!response.ok) {
             if (response.status >= 400 && response.status < 500) {
                 this.markAuthInvalid();
             }
-            throw new errors_1.DooverAuthError(`Token refresh failed with status ${response.status}`);
+            throw new errors_js_1.DooverAuthError(`Token refresh failed with status ${response.status}`);
         }
         const body = (await response.json());
         if (!body.access_token) {
             this.markAuthInvalid();
-            throw new errors_1.DooverAuthError("Token refresh response did not contain an access_token");
+            throw new errors_js_1.DooverAuthError("Token refresh response did not contain an access_token");
         }
         this.authInvalid = false;
         this.token = body.access_token;
         this.tokenExpires =
             typeof body.expires_in === "number"
                 ? new Date(Date.now() + body.expires_in * 1000)
-                : (0, jwt_1.decodeTokenExpiry)(body.access_token);
+                : (0, jwt_js_1.decodeTokenExpiry)(body.access_token);
         if (body.refresh_token) {
             this.refreshToken = body.refresh_token;
         }
@@ -194,7 +194,7 @@ class DooverTokenAuth extends doover_auth_1.DooverAuth {
                 this.configManager.write();
             }
             catch (err) {
-                throw new errors_1.DooverAuthError(`Failed to persist refreshed token: ${err instanceof Error ? err.message : String(err)}`);
+                throw new errors_js_1.DooverAuthError(`Failed to persist refreshed token: ${err instanceof Error ? err.message : String(err)}`);
             }
         }
     }
@@ -213,7 +213,7 @@ class DooverTokenAuth extends doover_auth_1.DooverAuth {
             return new Date(explicit);
         }
         if (token) {
-            return (0, jwt_1.decodeTokenExpiry)(token);
+            return (0, jwt_js_1.decodeTokenExpiry)(token);
         }
         return null;
     }

package/dist/auth/index.d.ts

@@ -0,0 +1,10 @@
+export { DooverAuth } from "./doover-auth.js";
+export { CookieAuth } from "./cookie-auth.js";
+export type { CookieAuthOptions } from "./cookie-auth.js";
+export { DooverTokenAuth } from "./doover-token-auth.js";
+export { AuthProfile } from "./auth-profile.js";
+export type { AuthProfileData } from "./auth-profile.js";
+export type { AuthProfileStore } from "./auth-store.js";
+export { DooverAuthError } from "./errors.js";
+export { buildAuth } from "./build-auth.js";
+export type { AuthConfig } from "./build-auth.js";

package/dist/auth/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAuth = exports.DooverAuthError = exports.AuthProfile = exports.DooverTokenAuth = exports.CookieAuth = exports.DooverAuth = void 0;
+var doover_auth_js_1 = require("./doover-auth.js");
+Object.defineProperty(exports, "DooverAuth", { enumerable: true, get: function () { return doover_auth_js_1.DooverAuth; } });
+var cookie_auth_js_1 = require("./cookie-auth.js");
+Object.defineProperty(exports, "CookieAuth", { enumerable: true, get: function () { return cookie_auth_js_1.CookieAuth; } });
+var doover_token_auth_js_1 = require("./doover-token-auth.js");
+Object.defineProperty(exports, "DooverTokenAuth", { enumerable: true, get: function () { return doover_token_auth_js_1.DooverTokenAuth; } });
+var auth_profile_js_1 = require("./auth-profile.js");
+Object.defineProperty(exports, "AuthProfile", { enumerable: true, get: function () { return auth_profile_js_1.AuthProfile; } });
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "DooverAuthError", { enumerable: true, get: function () { return errors_js_1.DooverAuthError; } });
+var build_auth_js_1 = require("./build-auth.js");
+Object.defineProperty(exports, "buildAuth", { enumerable: true, get: function () { return build_auth_js_1.buildAuth; } });

package/dist/client/data-client.d.ts

@@ -1,17 +1,18 @@
-import type { AgentsApi } from "../apis/agents-api";
-import type { AggregatesApi } from "../apis/aggregates-api";
-import type { AlarmsApi } from "../apis/alarms-api";
-import type { ChannelsApi } from "../apis/channels-api";
-import type { ConnectionsApi } from "../apis/connections-api";
-import type { MessagesApi } from "../apis/messages-api";
-import type { NotificationsApi } from "../apis/notifications-api";
-import type { PermissionsApi } from "../apis/permissions-api";
-import type { ProcessorsApi } from "../apis/processors-api";
-import type { TurnApi } from "../apis/turn-api";
-import type { UsersApi } from "../apis/users-api";
-import type { GatewayClient } from "../gateway/gateway-client";
-import type { RpcDispatcher } from "../rpc/rpc-dispatcher";
-import type { Capability } from "./capabilities";
+import type { NetworkStatusSource } from "./network-status.js";
+import type { AgentsApi } from "../apis/agents-api.js";
+import type { AggregatesApi } from "../apis/aggregates-api.js";
+import type { AlarmsApi } from "../apis/alarms-api.js";
+import type { ChannelsApi } from "../apis/channels-api.js";
+import type { ConnectionsApi } from "../apis/connections-api.js";
+import type { MessagesApi } from "../apis/messages-api.js";
+import type { NotificationsApi } from "../apis/notifications-api.js";
+import type { PermissionsApi } from "../apis/permissions-api.js";
+import type { ProcessorsApi } from "../apis/processors-api.js";
+import type { TurnApi } from "../apis/turn-api.js";
+import type { UsersApi } from "../apis/users-api.js";
+import type { GatewayClient } from "../gateway/gateway-client.js";
+import type { RpcDispatcher } from "../rpc/rpc-dispatcher.js";
+import type { Capability } from "./capabilities.js";
 /**
  * Public structural shape of each concrete subclient — `Pick<Class, keyof Class>`
  * yields just the public members as a plain object type (no nominal/private-member
@@ -76,6 +77,8 @@ export interface DataClientStatus {
  * later; the invariant is that `DooverClient` always satisfies it.
  */
 export interface DataClient {
+    /** Optional platform source; React hooks otherwise use browser network status. */
+    readonly networkStatus?: NetworkStatusSource;
     readonly agents: AgentsApiLike;
     readonly channels: ChannelsApiLike;
     readonly messages: MessagesApiLike;

package/dist/client/doover-client.d.ts

@@ -1,11 +1,13 @@
-import { OrganisationsApi } from "../apis/organisations-api";
-import type { DooverAuth } from "../auth/doover-auth";
-import { RestClient, type DooverClientConfig } from "../http/rest-client";
-import { DooverDataProvider } from "../viewer/doover-data-provider";
-import { type Capability } from "./capabilities";
-import type { AgentsApiLike, AggregatesApiLike, AlarmsApiLike, ChannelsApiLike, ConnectionsApiLike, DataClient, DataClientStatus, AgentScope, GatewayClientLike, MessagesApiLike, NotificationsApiLike, PermissionsApiLike, ProcessorsApiLike, RpcDispatcherLike, TurnApiLike, UsersApiLike } from "./data-client";
-import { DooverStatsCollector, type DooverStatsSnapshot } from "./stats";
+import { type NetworkStatusSource } from "./network-status.js";
+import { OrganisationsApi } from "../apis/organisations-api.js";
+import type { DooverAuth } from "../auth/doover-auth.js";
+import { RestClient, type DooverClientConfig } from "../http/rest-client.js";
+import { DooverDataProvider } from "../viewer/doover-data-provider.js";
+import { type Capability } from "./capabilities.js";
+import type { AgentsApiLike, AggregatesApiLike, AlarmsApiLike, ChannelsApiLike, ConnectionsApiLike, DataClient, DataClientStatus, AgentScope, GatewayClientLike, MessagesApiLike, NotificationsApiLike, PermissionsApiLike, ProcessorsApiLike, RpcDispatcherLike, TurnApiLike, UsersApiLike } from "./data-client.js";
+import { DooverStatsCollector, type DooverStatsSnapshot } from "./stats.js";
 export declare class DooverClient implements DataClient {
+    readonly networkStatus: NetworkStatusSource;
     readonly auth: DooverAuth;
     readonly rest: RestClient;
     readonly viewer: DooverDataProvider;

package/dist/client/doover-client.js

@@ -1,31 +1,33 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DooverClient = void 0;
-const agents_api_1 = require("../apis/agents-api");
-const aggregates_api_1 = require("../apis/aggregates-api");
-const alarms_api_1 = require("../apis/alarms-api");
-const channels_api_1 = require("../apis/channels-api");
-const connections_api_1 = require("../apis/connections-api");
-const messages_api_1 = require("../apis/messages-api");
-const notifications_api_1 = require("../apis/notifications-api");
-const organisations_api_1 = require("../apis/organisations-api");
-const permissions_api_1 = require("../apis/permissions-api");
-const processors_api_1 = require("../apis/processors-api");
-const turn_api_1 = require("../apis/turn-api");
-const users_api_1 = require("../apis/users-api");
-const build_auth_1 = require("../auth/build-auth");
-const gateway_client_1 = require("../gateway/gateway-client");
-const rest_client_1 = require("../http/rest-client");
-const rpc_dispatcher_1 = require("../rpc/rpc-dispatcher");
-const doover_data_provider_1 = require("../viewer/doover-data-provider");
-const capabilities_1 = require("./capabilities");
-const provenance_1 = require("./provenance");
-const status_tracker_1 = require("./status-tracker");
-const stats_1 = require("./stats");
-const ALL_CAPS_SET = new Set(capabilities_1.ALL_CAPABILITIES);
+const network_status_js_1 = require("./network-status.js");
+const agents_api_js_1 = require("../apis/agents-api.js");
+const aggregates_api_js_1 = require("../apis/aggregates-api.js");
+const alarms_api_js_1 = require("../apis/alarms-api.js");
+const channels_api_js_1 = require("../apis/channels-api.js");
+const connections_api_js_1 = require("../apis/connections-api.js");
+const messages_api_js_1 = require("../apis/messages-api.js");
+const notifications_api_js_1 = require("../apis/notifications-api.js");
+const organisations_api_js_1 = require("../apis/organisations-api.js");
+const permissions_api_js_1 = require("../apis/permissions-api.js");
+const processors_api_js_1 = require("../apis/processors-api.js");
+const turn_api_js_1 = require("../apis/turn-api.js");
+const users_api_js_1 = require("../apis/users-api.js");
+const build_auth_js_1 = require("../auth/build-auth.js");
+const gateway_client_js_1 = require("../gateway/gateway-client.js");
+const rest_client_js_1 = require("../http/rest-client.js");
+const rpc_dispatcher_js_1 = require("../rpc/rpc-dispatcher.js");
+const doover_data_provider_js_1 = require("../viewer/doover-data-provider.js");
+const capabilities_js_1 = require("./capabilities.js");
+const provenance_js_1 = require("./provenance.js");
+const status_tracker_js_1 = require("./status-tracker.js");
+const stats_js_1 = require("./stats.js");
+const ALL_CAPS_SET = new Set(capabilities_js_1.ALL_CAPABILITIES);
 class DooverClient {
     constructor(config) {
-        this.auth = (0, build_auth_1.buildAuth)({
+        this.networkStatus = config.networkStatus ?? network_status_js_1.browserNetworkStatus;
+        this.auth = (0, build_auth_js_1.buildAuth)({
             auth: config.auth,
             profile: config.profile,
             configManager: config.configManager,
@@ -47,37 +49,37 @@ class DooverClient {
                 ...(config.organisationId ? { organisationId: config.organisationId } : {}),
             },
         };
-        const stamper = new provenance_1.ProvenanceStamper(this.identity);
-        this.rest = new rest_client_1.RestClient(config, this.auth);
-        this.gatewayImpl = new gateway_client_1.GatewayClient(config, this.auth);
+        const stamper = new provenance_js_1.ProvenanceStamper(this.identity);
+        this.rest = new rest_client_js_1.RestClient(config, this.auth);
+        this.gatewayImpl = new gateway_client_js_1.GatewayClient(config, this.auth);
         this.gatewayImpl.setProvenanceHook((value, ctx) => stamper.stampGatewayEvent(value, ctx));
         this.gateway = this.gatewayImpl;
-        this.viewer = new doover_data_provider_1.DooverDataProvider({
+        this.viewer = new doover_data_provider_js_1.DooverDataProvider({
             rest: this.rest,
             gateway: this.gatewayImpl,
             controlApiUrl: config.controlApiUrl,
         });
-        this.users = (0, provenance_1.wrapSubclient)(new users_api_1.UsersApi(this.rest, config.controlApiUrl), "users", stamper);
-        this.channels = (0, provenance_1.wrapSubclient)(new channels_api_1.ChannelsApi(this.rest), "channels", stamper);
-        this.messages = (0, provenance_1.wrapSubclient)(new messages_api_1.MessagesApi(this.rest), "messages", stamper);
-        this.aggregates = (0, provenance_1.wrapSubclient)(new aggregates_api_1.AggregatesApi(this.rest), "aggregates", stamper);
-        this.alarms = (0, provenance_1.wrapSubclient)(new alarms_api_1.AlarmsApi(this.rest), "alarms", stamper);
-        this.connections = (0, provenance_1.wrapSubclient)(new connections_api_1.ConnectionsApi(this.rest), "connections", stamper);
-        this.notifications = (0, provenance_1.wrapSubclient)(new notifications_api_1.NotificationsApi(this.rest), "notifications", stamper);
-        this.organisations = (0, provenance_1.wrapSubclient)(new organisations_api_1.OrganisationsApi(this.rest, config.controlApiUrl), "organisations", stamper);
-        this.permissions = (0, provenance_1.wrapSubclient)(new permissions_api_1.PermissionsApi(this.rest), "permissions", stamper);
-        this.processors = (0, provenance_1.wrapSubclient)(new processors_api_1.ProcessorsApi(this.rest), "processors", stamper);
-        this.turn = (0, provenance_1.wrapSubclient)(new turn_api_1.TurnApi(this.rest), "turn", stamper);
-        this.agents = (0, provenance_1.wrapSubclient)(new agents_api_1.AgentsApi(this.rest, config.controlApiUrl), "agents", stamper);
+        this.users = (0, provenance_js_1.wrapSubclient)(new users_api_js_1.UsersApi(this.rest, config.controlApiUrl), "users", stamper);
+        this.channels = (0, provenance_js_1.wrapSubclient)(new channels_api_js_1.ChannelsApi(this.rest), "channels", stamper);
+        this.messages = (0, provenance_js_1.wrapSubclient)(new messages_api_js_1.MessagesApi(this.rest), "messages", stamper);
+        this.aggregates = (0, provenance_js_1.wrapSubclient)(new aggregates_api_js_1.AggregatesApi(this.rest), "aggregates", stamper);
+        this.alarms = (0, provenance_js_1.wrapSubclient)(new alarms_api_js_1.AlarmsApi(this.rest), "alarms", stamper);
+        this.connections = (0, provenance_js_1.wrapSubclient)(new connections_api_js_1.ConnectionsApi(this.rest), "connections", stamper);
+        this.notifications = (0, provenance_js_1.wrapSubclient)(new notifications_api_js_1.NotificationsApi(this.rest), "notifications", stamper);
+        this.organisations = (0, provenance_js_1.wrapSubclient)(new organisations_api_js_1.OrganisationsApi(this.rest, config.controlApiUrl), "organisations", stamper);
+        this.permissions = (0, provenance_js_1.wrapSubclient)(new permissions_api_js_1.PermissionsApi(this.rest), "permissions", stamper);
+        this.processors = (0, provenance_js_1.wrapSubclient)(new processors_api_js_1.ProcessorsApi(this.rest), "processors", stamper);
+        this.turn = (0, provenance_js_1.wrapSubclient)(new turn_api_js_1.TurnApi(this.rest), "turn", stamper);
+        this.agents = (0, provenance_js_1.wrapSubclient)(new agents_api_js_1.AgentsApi(this.rest, config.controlApiUrl), "agents", stamper);
         // RpcDispatcher needs the concrete MessagesApi (it calls postMessage internally);
         // give it an *unwrapped* one so stamping happens once at the public boundary.
-        this.rpcImpl = new rpc_dispatcher_1.RpcDispatcher(this.gatewayImpl, new messages_api_1.MessagesApi(this.rest));
+        this.rpcImpl = new rpc_dispatcher_js_1.RpcDispatcher(this.gatewayImpl, new messages_api_js_1.MessagesApi(this.rest));
         this.rpc = this.rpcImpl;
-        this.stats = new stats_1.DooverStatsCollector();
+        this.stats = new stats_js_1.DooverStatsCollector();
         this.rest.setStats(this.stats);
         this.gatewayImpl.setStats(this.stats);
         this.rpcImpl.setStats(this.stats);
-        this.statusTracker = new status_tracker_1.ClientStatusTracker(this.identity.id, this.gateway, () => this.getKnownAgentScope());
+        this.statusTracker = new status_tracker_js_1.ClientStatusTracker(this.identity.id, this.gateway, () => this.getKnownAgentScope());
     }
     enableStats() { this.stats.setEnabled(true); }
     disableStats() { this.stats.setEnabled(false); }

package/dist/client/errors.d.ts

@@ -1,5 +1,5 @@
-import type { Capability } from "./capabilities";
-import { DooverApiError } from "../http/errors";
+import type { Capability } from "./capabilities.js";
+import { DooverApiError } from "../http/errors.js";
 /**
  * Thrown when a `DataClient` method is called whose backing capability the
  * client does not advertise. Extends `DooverApiError` so existing

package/dist/client/errors.js

@@ -1,14 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DooverOfflineError = exports.AmbiguousWriteError = exports.UnsupportedCapabilityError = void 0;
-const errors_1 = require("../http/errors");
+const errors_js_1 = require("../http/errors.js");
 /**
  * Thrown when a `DataClient` method is called whose backing capability the
  * client does not advertise. Extends `DooverApiError` so existing
  * `instanceof DooverApiError` error handling catches it; the HTTP-ish fields
  * are placeholders since no request was made.
  */
-class UnsupportedCapabilityError extends errors_1.DooverApiError {
+class UnsupportedCapabilityError extends errors_js_1.DooverApiError {
     constructor(capability, clientId) {
         super({
             status: 0,
@@ -30,7 +30,7 @@ exports.UnsupportedCapabilityError = UnsupportedCapabilityError;
  * member — more than one enabled member owns the targeted agent and has the
  * write capability, and the call was not `sources`-scoped to one of them.
  */
-class AmbiguousWriteError extends errors_1.DooverApiError {
+class AmbiguousWriteError extends errors_js_1.DooverApiError {
     constructor(capability, candidateSourceIds) {
         super({
             status: 0,
@@ -52,7 +52,7 @@ exports.AmbiguousWriteError = AmbiguousWriteError;
  * Thrown by offline-aware clients when a network-only operation is attempted
  * while offline, or when an offline read has no usable cached value.
  */
-class DooverOfflineError extends errors_1.DooverApiError {
+class DooverOfflineError extends errors_js_1.DooverApiError {
     constructor(operation, message, cacheKey) {
         super({
             status: 0,

package/dist/client/index.d.ts

@@ -0,0 +1,6 @@
+export { DooverClient } from "./doover-client.js";
+export { getDooverClient, peekDooverClient, resetDooverClient } from "./singleton.js";
+export type { DooverClientConfig } from "../http/rest-client.js";
+export type * from "./data-client.js";
+export { browserNetworkStatus, createNetworkStatusStore } from "./network-status.js";
+export type { NetworkStatusSource, NetworkStatusSnapshot } from "./network-status.js";

package/dist/client/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNetworkStatusStore = exports.browserNetworkStatus = exports.resetDooverClient = exports.peekDooverClient = exports.getDooverClient = exports.DooverClient = void 0;
+var doover_client_js_1 = require("./doover-client.js");
+Object.defineProperty(exports, "DooverClient", { enumerable: true, get: function () { return doover_client_js_1.DooverClient; } });
+var singleton_js_1 = require("./singleton.js");
+Object.defineProperty(exports, "getDooverClient", { enumerable: true, get: function () { return singleton_js_1.getDooverClient; } });
+Object.defineProperty(exports, "peekDooverClient", { enumerable: true, get: function () { return singleton_js_1.peekDooverClient; } });
+Object.defineProperty(exports, "resetDooverClient", { enumerable: true, get: function () { return singleton_js_1.resetDooverClient; } });
+var network_status_js_1 = require("./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/client/local-agent-client.d.ts

@@ -1,6 +1,6 @@
-import { type DooverClientConfig } from "../http/rest-client";
-import type { Capability } from "./capabilities";
-import type { AgentScope, AgentsApiLike, AggregatesApiLike, AlarmsApiLike, ChannelsApiLike, ConnectionsApiLike, DataClient, DataClientStatus, GatewayClientLike, MessagesApiLike, NotificationsApiLike, PermissionsApiLike, ProcessorsApiLike, RpcDispatcherLike, TurnApiLike, UsersApiLike } from "./data-client";
+import { type DooverClientConfig } from "../http/rest-client.js";
+import type { Capability } from "./capabilities.js";
+import type { AgentScope, AgentsApiLike, AggregatesApiLike, AlarmsApiLike, ChannelsApiLike, ConnectionsApiLike, DataClient, DataClientStatus, GatewayClientLike, MessagesApiLike, NotificationsApiLike, PermissionsApiLike, ProcessorsApiLike, RpcDispatcherLike, TurnApiLike, UsersApiLike } from "./data-client.js";
 export interface LocalAgentClientConfig {
     /** Base URL of the local agent's REST API, e.g. "http://192.168.0.7:49100". */
     baseUrl: string;

package/dist/client/local-agent-client.js

@@ -1,15 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LocalAgentClient = void 0;
-const agents_api_1 = require("../apis/agents-api");
-const aggregates_api_1 = require("../apis/aggregates-api");
-const channels_api_1 = require("../apis/channels-api");
-const messages_api_1 = require("../apis/messages-api");
-const gateway_client_1 = require("../gateway/gateway-client");
-const rest_client_1 = require("../http/rest-client");
-const errors_1 = require("./errors");
-const provenance_1 = require("./provenance");
-const status_tracker_1 = require("./status-tracker");
+const agents_api_js_1 = require("../apis/agents-api.js");
+const aggregates_api_js_1 = require("../apis/aggregates-api.js");
+const channels_api_js_1 = require("../apis/channels-api.js");
+const messages_api_js_1 = require("../apis/messages-api.js");
+const gateway_client_js_1 = require("../gateway/gateway-client.js");
+const rest_client_js_1 = require("../http/rest-client.js");
+const errors_js_1 = require("./errors.js");
+const provenance_js_1 = require("./provenance.js");
+const status_tracker_js_1 = require("./status-tracker.js");
 const LOCAL_CAPABILITIES = [
     "agents.list",
     "channels.list",
@@ -49,7 +49,7 @@ class LocalAgentClient {
             meta: { baseUrl: config.baseUrl },
         };
         this.capSet = new Set(LOCAL_CAPABILITIES);
-        const stamper = new provenance_1.ProvenanceStamper(this.identity);
+        const stamper = new provenance_js_1.ProvenanceStamper(this.identity);
         // RestClient / GatewayClient expect a DooverClientConfig — give them one
         // with the local URLs, no auth, no org/sharing headers.
         const restConfig = {
@@ -63,16 +63,16 @@ class LocalAgentClient {
             webSocketFactory: config.webSocketFactory,
             disableBrowserLifecycleHooks: config.disableBrowserLifecycleHooks,
         };
-        this.rest = new rest_client_1.RestClient(restConfig); // no auth arg
-        this.gatewayImpl = new gateway_client_1.GatewayClient(restConfig); // no auth arg
+        this.rest = new rest_client_js_1.RestClient(restConfig); // no auth arg
+        this.gatewayImpl = new gateway_client_js_1.GatewayClient(restConfig); // no auth arg
         this.gatewayImpl.setProvenanceHook((value, ctx) => stamper.stampGatewayEvent(value, ctx));
         this.gateway = this.gatewayImpl;
         // Real subclients for advertised methods, gated so only allowed methods pass;
         // all others throw UnsupportedCapabilityError.
-        const realAgents = (0, provenance_1.wrapSubclient)(new agents_api_1.AgentsApi(this.rest, config.baseUrl), "agents", stamper);
-        const realChannels = (0, provenance_1.wrapSubclient)(new channels_api_1.ChannelsApi(this.rest), "channels", stamper);
-        const realMessages = (0, provenance_1.wrapSubclient)(new messages_api_1.MessagesApi(this.rest), "messages", stamper);
-        const realAggregates = (0, provenance_1.wrapSubclient)(new aggregates_api_1.AggregatesApi(this.rest), "aggregates", stamper);
+        const realAgents = (0, provenance_js_1.wrapSubclient)(new agents_api_js_1.AgentsApi(this.rest, config.baseUrl), "agents", stamper);
+        const realChannels = (0, provenance_js_1.wrapSubclient)(new channels_api_js_1.ChannelsApi(this.rest), "channels", stamper);
+        const realMessages = (0, provenance_js_1.wrapSubclient)(new messages_api_js_1.MessagesApi(this.rest), "messages", stamper);
+        const realAggregates = (0, provenance_js_1.wrapSubclient)(new aggregates_api_js_1.AggregatesApi(this.rest), "aggregates", stamper);
         this.agents = this.gatedSubclient("agents", realAgents, ["listAgents"]);
         this.channels = this.gatedSubclient("channels", realChannels, ["listChannels", "getChannel"]);
         this.aggregates = this.gatedSubclient("aggregates", realAggregates, ["getAggregate", "putAggregate", "patchAggregate"]);
@@ -86,7 +86,7 @@ class LocalAgentClient {
         this.turn = this.unsupportedSubclient("turn");
         this.users = this.unsupportedSubclient("users");
         this.rpc = this.unsupportedSubclient("rpc");
-        this.statusTracker = new status_tracker_1.ClientStatusTracker(this.identity.id, this.gateway, () => this.getKnownAgentScope());
+        this.statusTracker = new status_tracker_js_1.ClientStatusTracker(this.identity.id, this.gateway, () => this.getKnownAgentScope());
         // Resolve the device id on (re)connect so routing is precise before the
         // first agent-scoped request; invalidate the cache on each new session.
         this.gatewayImpl.on("ready", () => {
@@ -154,7 +154,7 @@ class LocalAgentClient {
                     return Reflect.get(target, prop, receiver);
                 return () => {
                     const cap = METHOD_TO_CAPABILITY[`${name}.${prop}`] ?? guessCapability(name);
-                    return Promise.reject(new errors_1.UnsupportedCapabilityError(cap, clientId));
+                    return Promise.reject(new errors_js_1.UnsupportedCapabilityError(cap, clientId));
                 };
             },
         });
@@ -172,7 +172,7 @@ class LocalAgentClient {
                     return undefined;
                 return () => {
                     const cap = METHOD_TO_CAPABILITY[`${name}.${prop}`] ?? guessCapability(name);
-                    return Promise.reject(new errors_1.UnsupportedCapabilityError(cap, clientId));
+                    return Promise.reject(new errors_js_1.UnsupportedCapabilityError(cap, clientId));
                 };
             },
         });

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

@@ -1,8 +1,8 @@
-import type { Capability } from "./capabilities";
-import type { AgentScope, AgentsApiLike, AggregatesApiLike, AlarmsApiLike, ChannelsApiLike, ConnectionsApiLike, DataClient, DataClientStatus, GatewayClientLike, MessagesApiLike, NotificationsApiLike, PermissionsApiLike, ProcessorsApiLike, RpcDispatcherLike, TurnApiLike, UsersApiLike } from "./data-client";
-export type { DataClient } from "./data-client";
-export type { AgentScope } from "./data-client";
-export type { DataClientStatus } from "./data-client";
+import type { Capability } from "./capabilities.js";
+import type { AgentScope, AgentsApiLike, AggregatesApiLike, AlarmsApiLike, ChannelsApiLike, ConnectionsApiLike, DataClient, DataClientStatus, GatewayClientLike, MessagesApiLike, NotificationsApiLike, PermissionsApiLike, ProcessorsApiLike, RpcDispatcherLike, TurnApiLike, UsersApiLike } from "./data-client.js";
+export type { DataClient } from "./data-client.js";
+export type { AgentScope } from "./data-client.js";
+export type { DataClientStatus } from "./data-client.js";
 export interface MultiplexConflict {
     method: string;
     agentId: string;