doover-js 0.11.0 → 0.13.0

package/dist/test/react-channel-messages-range.test.js

@@ -1,109 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const jsx_runtime_1 = require("react/jsx-runtime");
-const chai_1 = require("chai");
-const mocha_1 = require("mocha");
-const react_1 = require("@testing-library/react");
-const react_query_1 = require("@tanstack/react-query");
-const sinon_1 = __importDefault(require("sinon"));
-const doover_client_1 = require("../client/doover-client");
-const react_2 = require("../react");
-const messageRangeStore_1 = require("../react/messageRangeStore");
-const snowflake_1 = require("../utils/snowflake");
-const helpers_1 = require("./helpers");
-const AGENT = "agent-1";
-const CHANNEL = "camera_1";
-const NOW = Date.now();
-/** Newest-first, as the bare REST route returns it. */
-function messagesDesc(count, startMinutesAgo) {
-    return Array.from({ length: count }, (_, i) => {
-        const at = new Date(NOW - (startMinutesAgo + i) * 60000);
-        return {
-            id: (0, snowflake_1.generateSnowflakeIdAtTime)(at),
-            data: { i },
-            attachments: [],
-            author_id: "author",
-            channel: { agent_id: AGENT, name: CHANNEL },
-        };
-    });
-}
-function makeClient(page) {
-    const calls = [];
-    const fetchMock = sinon_1.default.stub().callsFake(async (input) => {
-        const url = typeof input === "string" ? input : input instanceof URL ? input.toString() : input.url;
-        if (url.includes("/messages")) {
-            const parsed = new URL(url);
-            calls.push({
-                before: parsed.searchParams.get("before"),
-                limit: parsed.searchParams.get("limit"),
-            });
-            return (0, helpers_1.createJsonResponse)(page);
-        }
-        return (0, helpers_1.createJsonResponse)({});
-    });
-    const client = new doover_client_1.DooverClient({
-        dataRestUrl: "https://api.example.com",
-        controlApiUrl: "https://control.example.com",
-        dataWssUrl: "wss://ws.example.com",
-        fetchImpl: fetchMock,
-        webSocketImpl: helpers_1.MockWebSocket,
-        disableBrowserLifecycleHooks: true,
-    });
-    return { client, calls };
-}
-/** One QueryClient per test, shared by both hooks, as a real app would have. */
-function wrapper(client, queryClient) {
-    return function Wrapper({ children }) {
-        return ((0, jsx_runtime_1.jsx)(react_query_1.QueryClientProvider, { client: queryClient, children: (0, jsx_runtime_1.jsx)(react_2.DooverProvider, { client: client, children: children }) }));
-    };
-}
-const newQueryClient = () => new react_query_1.QueryClient({ defaultOptions: { queries: { retry: false } } });
-(0, mocha_1.describe)("useChannelMessages range cache", () => {
-    (0, mocha_1.beforeEach)(() => {
-        (0, helpers_1.installSessionStorageMock)();
-        (0, messageRangeStore_1.resetChannelRangeStores)();
-    });
-    (0, mocha_1.afterEach)(() => {
-        sinon_1.default.restore();
-    });
-    (0, mocha_1.it)("serves an anchored window from history already fetched, without refetching", async () => {
-        const page = messagesDesc(30, 1); // 1..30 minutes ago
-        const { client, calls } = makeClient(page);
-        const qc = newQueryClient();
-        const live = (0, react_1.renderHook)(() => (0, react_2.useChannelMessages)({ agentId: AGENT, channelName: CHANNEL }, { limit: 30 }), { wrapper: wrapper(client, qc) });
-        await (0, react_1.waitFor)(() => (0, chai_1.expect)(live.result.current.messages).to.have.length(30));
-        (0, chai_1.expect)(calls).to.have.length(1);
-        // Anchor inside the range just proven — a different chain, same store
-        const anchor = (0, snowflake_1.generateSnowflakeIdAtTime)(new Date(NOW - 10 * 60000));
-        const anchored = (0, react_1.renderHook)(() => (0, react_2.useChannelMessages)({ agentId: AGENT, channelName: CHANNEL }, { limit: 5, anchor }), { wrapper: wrapper(client, qc) });
-        await (0, react_1.waitFor)(() => (0, chai_1.expect)(anchored.result.current.messages).to.have.length(5));
-        (0, chai_1.expect)(calls, "anchoring over covered history should not hit the network").to.have.length(1);
-        (0, chai_1.expect)(anchored.result.current.messages.every((m) => BigInt(m.id) < BigInt(anchor))).to.equal(true);
-    });
-    (0, mocha_1.it)("fetches when the anchor lands outside anything proven", async () => {
-        const page = messagesDesc(30, 1);
-        const { client, calls } = makeClient(page);
-        const qc = newQueryClient();
-        const live = (0, react_1.renderHook)(() => (0, react_2.useChannelMessages)({ agentId: AGENT, channelName: CHANNEL }, { limit: 30 }), { wrapper: wrapper(client, qc) });
-        await (0, react_1.waitFor)(() => (0, chai_1.expect)(live.result.current.messages).to.have.length(30));
-        // A year back is nowhere near the covered range
-        const anchor = (0, snowflake_1.generateSnowflakeIdAtTime)(new Date(NOW - 365 * 24 * 60 * 60000));
-        (0, react_1.renderHook)(() => (0, react_2.useChannelMessages)({ agentId: AGENT, channelName: CHANNEL }, { limit: 5, anchor }), { wrapper: wrapper(client, qc) });
-        await (0, react_1.waitFor)(() => (0, chai_1.expect)(calls).to.have.length(2));
-        (0, chai_1.expect)(calls[1].before).to.equal(anchor);
-    });
-    (0, mocha_1.it)("keeps the unanchored key untouched, so existing consumers are unaffected", async () => {
-        const page = messagesDesc(10, 1);
-        const { client, calls } = makeClient(page);
-        const qc = newQueryClient();
-        const first = (0, react_1.renderHook)(() => (0, react_2.useChannelMessages)({ agentId: AGENT, channelName: CHANNEL }, { limit: 10 }), { wrapper: wrapper(client, qc) });
-        await (0, react_1.waitFor)(() => (0, chai_1.expect)(first.result.current.messages).to.have.length(10));
-        // Same options => same query key => React Query serves it, no second request
-        const second = (0, react_1.renderHook)(() => (0, react_2.useChannelMessages)({ agentId: AGENT, channelName: CHANNEL }, { limit: 10 }), { wrapper: wrapper(client, qc) });
-        await (0, react_1.waitFor)(() => (0, chai_1.expect)(second.result.current.messages).to.have.length(10));
-        (0, chai_1.expect)(calls).to.have.length(1);
-    });
-});

package/dist/test/react-client-status.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/test/react-client-status.test.js

@@ -1,35 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const jsx_runtime_1 = require("react/jsx-runtime");
-const chai_1 = require("chai");
-const mocha_1 = require("mocha");
-const react_1 = require("@testing-library/react");
-const react_2 = require("../react");
-function controllableClient() {
-    let status = { clientId: "x", connected: false, state: "disconnected", agentScope: "unknown", at: Date.now() };
-    const listeners = new Set();
-    const noop = new Proxy({}, { get: () => () => Promise.resolve(undefined) });
-    return {
-        client: {
-            agents: noop, channels: noop, messages: noop, aggregates: noop, alarms: noop, connections: noop, notifications: noop, permissions: noop, processors: noop, turn: noop, users: noop, rpc: noop,
-            gateway: { connect: async () => { }, disconnect: () => { }, reconnect: async () => { }, on: () => { }, off: () => { }, subscribe: () => { }, unsubscribe: () => { }, subscribeToChannel: () => () => { }, syncChannel: () => { }, sendOneShotMessage: () => { }, getSession: () => null, isConnected: () => false, getSubscriptionCount: () => 0, getSubscriptions: () => [], setStats: () => { } },
-            getCapabilities: () => new Set(), supports: () => false,
-            isConnected: () => status.connected, getStatus: () => status,
-            onStatusChange: (l) => { listeners.add(l); return () => listeners.delete(l); },
-            getAgentScope: async () => ({ mode: "all" }), getKnownAgentScope: () => "unknown",
-        },
-        push(s) { status = { ...status, ...s, at: Date.now() }; listeners.forEach((l) => l(status)); },
-    };
-}
-(0, mocha_1.describe)("useClientStatus", () => {
-    (0, mocha_1.it)("seeds with getStatus() and re-renders on onStatusChange", () => {
-        const { client, push } = controllableClient();
-        const { result } = (0, react_1.renderHook)(() => (0, react_2.useClientStatus)(), {
-            wrapper: ({ children }) => (0, jsx_runtime_1.jsx)(react_2.DooverProvider, { client: client, children: children }),
-        });
-        (0, chai_1.expect)(result.current.state).to.equal("disconnected");
-        (0, react_1.act)(() => push({ connected: true, state: "connected" }));
-        (0, chai_1.expect)(result.current.state).to.equal("connected");
-        (0, chai_1.expect)(result.current.connected).to.equal(true);
-    });
-});

package/dist/test/react-dataclient.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/test/react-dataclient.test.js

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const jsx_runtime_1 = require("react/jsx-runtime");
-const chai_1 = require("chai");
-const mocha_1 = require("mocha");
-const react_1 = require("@testing-library/react");
-const react_2 = require("../react");
-const multiplex_client_1 = require("../client/multiplex-client");
-function stubMember(id) {
-    const noop = new Proxy({}, { get: () => () => Promise.resolve(undefined) });
-    return {
-        agents: noop, channels: noop, messages: noop, aggregates: noop, alarms: noop, connections: noop, notifications: noop, permissions: noop, processors: noop, turn: noop, users: noop, rpc: noop,
-        gateway: { connect: async () => { }, disconnect: () => { }, reconnect: async () => { }, on: () => { }, off: () => { }, subscribe: () => { }, unsubscribe: () => { }, subscribeToChannel: () => () => { }, syncChannel: () => { }, sendOneShotMessage: () => { }, getSession: () => null, isConnected: () => false, getSubscriptionCount: () => 0, getSubscriptions: () => [], setStats: () => { } },
-        getCapabilities: () => new Set(["channels.list"]), supports: () => true,
-        isConnected: () => false, getStatus: () => ({ clientId: id, connected: false, state: "disconnected", agentScope: "unknown", at: Date.now() }),
-        onStatusChange: () => () => { }, getAgentScope: async () => ({ mode: "list", agentIds: [] }), getKnownAgentScope: () => "unknown",
-    };
-}
-(0, mocha_1.describe)("DooverProvider with a DataClient", () => {
-    (0, mocha_1.it)("accepts a MultiplexClient and useDooverClient returns it", () => {
-        const factory = (d) => stubMember(d.id);
-        const mux = new multiplex_client_1.MultiplexClient({ factory, register: [{ id: "cloud", kind: "cloud" }], enable: ["cloud"] });
-        const { result } = (0, react_1.renderHook)(() => (0, react_2.useDooverClient)(), {
-            wrapper: ({ children }) => (0, jsx_runtime_1.jsx)(react_2.DooverProvider, { client: mux, children: children }),
-        });
-        (0, chai_1.expect)(result.current).to.equal(mux);
-    });
-});

package/dist/test/react-exports.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/test/react-exports.test.js

@@ -1,46 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-const chai_1 = require("chai");
-const mocha_1 = require("mocha");
-const r = __importStar(require("../react"));
-(0, mocha_1.describe)("react exports", () => {
-    (0, mocha_1.it)("exports useClientStatus and the key helpers", () => {
-        (0, chai_1.expect)(r.useClientStatus).to.be.a("function");
-        (0, chai_1.expect)(r.useOfflineStatus).to.be.a("function");
-        (0, chai_1.expect)(r.channelAggregateQueryKey).to.be.a("function");
-        (0, chai_1.expect)(r.useConnectionState).to.be.a("function"); // still exported (soft-deprecated)
-    });
-});

package/dist/test/react-multiagent-messages.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/test/react-multiagent-messages.test.js

@@ -1,113 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const jsx_runtime_1 = require("react/jsx-runtime");
-const chai_1 = require("chai");
-const mocha_1 = require("mocha");
-const react_1 = require("@testing-library/react");
-const react_query_1 = require("@tanstack/react-query");
-const doover_client_1 = require("../client/doover-client");
-const react_2 = require("../react");
-const helpers_1 = require("./helpers");
-const sinon_1 = __importDefault(require("sinon"));
-/**
- * Fetch mock for the multi-agent messages endpoint. `pagesByRound` supplies
- * one canned response per call, in order, so a test can hand back
- * `next_cursors` on early rounds and drain on the last one.
- */
-function makeClient(pagesByRound) {
-    let round = 0;
-    const calls = [];
-    const fetchMock = sinon_1.default.stub().callsFake(async (input) => {
-        const url = typeof input === "string" ? input : input instanceof URL ? input.toString() : input.url;
-        if (url.includes("/messages")) {
-            const parsed = new URL(url);
-            calls.push({
-                agent_id: parsed.searchParams.getAll("agent_id"),
-                agent_before: parsed.searchParams.getAll("agent_before"),
-            });
-            const page = pagesByRound[Math.min(round, pagesByRound.length - 1)];
-            round += 1;
-            return (0, helpers_1.createJsonResponse)(page);
-        }
-        return (0, helpers_1.createJsonResponse)({});
-    });
-    const client = new doover_client_1.DooverClient({
-        dataRestUrl: "https://api.example.com",
-        controlApiUrl: "https://control.example.com",
-        dataWssUrl: "wss://ws.example.com",
-        fetchImpl: fetchMock,
-        webSocketImpl: helpers_1.MockWebSocket,
-        disableBrowserLifecycleHooks: true,
-    });
-    return { client, calls };
-}
-function wrapper(client) {
-    const queryClient = new react_query_1.QueryClient({ defaultOptions: { queries: { retry: false } } });
-    return function Wrapper({ children }) {
-        return ((0, jsx_runtime_1.jsx)(react_query_1.QueryClientProvider, { client: queryClient, children: (0, jsx_runtime_1.jsx)(react_2.DooverProvider, { client: client, children: children }) }));
-    };
-}
-function msg(id, agentId) {
-    return { id, channel: { agent_id: agentId, name: "tag_values" }, data: {} };
-}
-(0, mocha_1.describe)("useMultiAgentChannelMessages autoPaginate", () => {
-    (0, mocha_1.beforeEach)(() => {
-        (0, helpers_1.installSessionStorageMock)();
-        helpers_1.MockWebSocket.reset();
-    });
-    (0, mocha_1.afterEach)(() => {
-        sinon_1.default.restore();
-    });
-    (0, mocha_1.it)("walks back per-agent via next_cursors until the window drains", async () => {
-        const { client, calls } = makeClient([
-            // round 1: a1 hit its limit (cursor returned), a2 drained already
-            { results: [msg("100", "a1"), msg("99", "a2")], next_cursors: { a1: "90" } },
-            // round 2: a1 drains
-            { results: [msg("89", "a1")], next_cursors: {} },
-        ]);
-        const { result } = (0, react_1.renderHook)(() => (0, react_2.useMultiAgentChannelMessages)("tag_values", ["a1", "a2"], {
-            after: "1",
-            agentMessageLimit: 2,
-            autoPaginate: true,
-            liveUpdates: false,
-        }), { wrapper: wrapper(client) });
-        await (0, react_1.waitFor)(() => (0, chai_1.expect)(result.current.messages).to.have.length(3));
-        (0, chai_1.expect)(result.current.hasNextPage).to.equal(false);
-        // Second request must resume ONLY a1, using its own cursor as agent_before.
-        (0, chai_1.expect)(calls).to.have.length(2);
-        (0, chai_1.expect)(calls[1].agent_id).to.deep.equal(["a1"]);
-        (0, chai_1.expect)(calls[1].agent_before).to.deep.equal(["90"]);
-    });
-    (0, mocha_1.it)("does not paginate when autoPaginate is off", async () => {
-        const { client, calls } = makeClient([
-            { results: [msg("100", "a1")], next_cursors: { a1: "90" } },
-        ]);
-        const { result } = (0, react_1.renderHook)(() => (0, react_2.useMultiAgentChannelMessages)("tag_values", ["a1"], {
-            agentMessageLimit: 1,
-            liveUpdates: false,
-        }), { wrapper: wrapper(client) });
-        await (0, react_1.waitFor)(() => (0, chai_1.expect)(result.current.messages).to.have.length(1));
-        // hasNextPage is exposed, but nothing auto-fetches the second page.
-        (0, chai_1.expect)(result.current.hasNextPage).to.equal(true);
-        (0, chai_1.expect)(calls).to.have.length(1);
-    });
-    (0, mocha_1.it)("dedupes messages that repeat across pages", async () => {
-        const { client } = makeClient([
-            { results: [msg("100", "a1")], next_cursors: { a1: "100" } },
-            // overlaps the previous page's id 100 (legacy-style re-return)
-            { results: [msg("100", "a1"), msg("90", "a1")], next_cursors: {} },
-        ]);
-        const { result } = (0, react_1.renderHook)(() => (0, react_2.useMultiAgentChannelMessages)("tag_values", ["a1"], {
-            after: "1",
-            agentMessageLimit: 1,
-            autoPaginate: true,
-            liveUpdates: false,
-        }), { wrapper: wrapper(client) });
-        await (0, react_1.waitFor)(() => (0, chai_1.expect)(result.current.messages).to.have.length(2));
-        (0, chai_1.expect)(result.current.hasNextPage).to.equal(false);
-        (0, chai_1.expect)(result.current.messages.map((m) => m.id)).to.deep.equal(["100", "90"]);
-    });
-});

package/dist/test/react-sources-option.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/test/react-sources-option.test.js

@@ -1,41 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const jsx_runtime_1 = require("react/jsx-runtime");
-const chai_1 = require("chai");
-const mocha_1 = require("mocha");
-const react_1 = require("@testing-library/react");
-const react_query_1 = require("@tanstack/react-query");
-const react_2 = require("../react");
-const multiplex_client_1 = require("../client/multiplex-client");
-function aggMember(id, value) {
-    const src = { client: { id, kind: id.startsWith("local") ? "local" : "cloud" }, retrievedAt: 0, via: { transport: "rest", method: "aggregates.getAggregate", request: {}, startedAt: 0, durationMs: 0 } };
-    const noop = new Proxy({}, { get: () => () => Promise.resolve(undefined) });
-    return {
-        agents: noop,
-        channels: { getChannel: async () => ({ name: "c", owner_id: id, is_private: false }) },
-        messages: noop,
-        aggregates: { getAggregate: async () => ({ ...value, __source: src }) },
-        alarms: noop, connections: noop, notifications: noop, permissions: noop, processors: noop, turn: noop, users: noop, rpc: noop,
-        gateway: { connect: async () => { }, disconnect: () => { }, reconnect: async () => { }, on: () => { }, off: () => { }, subscribe: () => { }, unsubscribe: () => { }, subscribeToChannel: () => () => { }, syncChannel: () => { }, sendOneShotMessage: () => { }, getSession: () => null, isConnected: () => false, getSubscriptionCount: () => 0, getSubscriptions: () => [], setStats: () => { } },
-        getCapabilities: () => new Set(["aggregates.get", "channels.get", "gateway.subscribe"]),
-        supports: (c) => ["aggregates.get", "channels.get", "gateway.subscribe"].includes(c),
-        isConnected: () => false, getStatus: () => ({ clientId: id, connected: false, state: "disconnected", agentScope: { mode: "all" }, at: 0 }),
-        onStatusChange: () => () => { }, getAgentScope: async () => ({ mode: "all" }), getKnownAgentScope: () => ({ mode: "all" }),
-    };
-}
-(0, mocha_1.describe)("hooks: sources option + source-dimensioned keys", () => {
-    (0, mocha_1.it)("useChannelAggregate forwards sources and uses a source-dimensioned key; unscoped uses '*'", async () => {
-        const factory = (d) => d.id === "cloud"
-            ? aggMember("cloud", { data: { v: 1 }, attachments: [] })
-            : aggMember("local:7", { data: { v: 2 }, attachments: [] });
-        const mux = new multiplex_client_1.MultiplexClient({ factory, register: [{ id: "cloud", kind: "cloud" }, { id: "local:7", kind: "local" }], enableAll: true });
-        const queryClient = new react_query_1.QueryClient({ defaultOptions: { queries: { retry: false } } });
-        const wrapper = ({ children }) => ((0, jsx_runtime_1.jsx)(react_query_1.QueryClientProvider, { client: queryClient, children: (0, jsx_runtime_1.jsx)(react_2.DooverProvider, { client: mux, children: children }) }));
-        const scoped = (0, react_1.renderHook)(() => (0, react_2.useChannelAggregate)({ agentId: "dev7", channelName: "c" }, { sources: ["local:7"] }), { wrapper });
-        await (0, react_1.waitFor)(() => (0, chai_1.expect)(scoped.result.current.data).to.deep.equal({ v: 2 }));
-        // its cache entry lives under the source-dimensioned key:
-        (0, chai_1.expect)(queryClient.getQueryData((0, react_2.channelAggregateQueryKey)("dev7", "c", ["local:7"]))).to.exist;
-        // an unscoped hook for the same channel uses the "*" key — distinct entry:
-        (0, chai_1.expect)((0, react_2.channelAggregateQueryKey)("dev7", "c")).to.deep.equal(["doover", "agent", "dev7", "channel", "c", "src", "*"]);
-    });
-});

package/dist/test/react.test.d.ts

@@ -1 +0,0 @@
-export {};