doover-js 0.11.0 → 0.13.0

package/dist/test/multiplex-writes.test.d.ts

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

package/dist/test/multiplex-writes.test.js

@@ -1,93 +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;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-// src/test/multiplex-writes.test.ts
-const chai_1 = require("chai");
-const chai_as_promised_1 = __importDefault(require("chai-as-promised"));
-const chai = __importStar(require("chai"));
-const mocha_1 = require("mocha");
-const multiplex_client_1 = require("../client/multiplex-client");
-const errors_1 = require("../client/errors");
-chai.use(chai_as_promised_1.default);
-const { expect: xp } = chai;
-function writeMember(id, scope, caps, sink) {
-    const noop = new Proxy({}, { get: () => () => Promise.resolve(undefined) });
-    const post = async (agentId) => { sink.push(`${id}:${agentId}`); return { id: "m", data: {}, attachments: [], author_id: "a", channel: { agent_id: agentId, name: "c" } }; };
-    return {
-        agents: noop, channels: noop,
-        messages: { postMessage: (a) => post(a) },
-        aggregates: { putAggregate: async (a) => { sink.push(`${id}:put:${a}`); return { data: {}, attachments: [] }; } },
-        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(caps), supports: (c) => caps.includes(c),
-        isConnected: () => false, getStatus: () => ({ clientId: id, connected: false, state: "disconnected", agentScope: scope, at: Date.now() }),
-        onStatusChange: () => () => { },
-        getAgentScope: async () => scope, getKnownAgentScope: () => scope,
-    };
-}
-(0, mocha_1.describe)("MultiplexClient writes", () => {
-    function mk(members) {
-        const factory = (d) => members[d.id];
-        return new multiplex_client_1.MultiplexClient({ factory, register: Object.keys(members).map((id) => ({ id, kind: id.startsWith("local") ? "local" : "cloud" })), enableAll: true });
-    }
-    (0, mocha_1.it)("routes to the single member that owns the agent and has the write cap", async () => {
-        const sink = [];
-        const mux = mk({
-            cloud: writeMember("cloud", { mode: "all" }, ["messages.post"], sink),
-            "local:7": writeMember("local:7", { mode: "list", agentIds: ["dev7"] }, ["messages.post"], sink),
-        });
-        // dev99 only owned by cloud (local:7 owns dev7) → routes to cloud
-        await mux.messages.postMessage("dev99", "c", { x: 1 });
-        (0, chai_1.expect)(sink).to.deep.equal(["cloud:dev99"]);
-    });
-    (0, mocha_1.it)("ambiguous when 2+ members own the agent and have the cap → AmbiguousWriteError", async () => {
-        const sink = [];
-        const mux = mk({
-            cloud: writeMember("cloud", { mode: "all" }, ["messages.post"], sink),
-            "local:7": writeMember("local:7", { mode: "list", agentIds: ["dev7"] }, ["messages.post"], sink),
-        });
-        await xp(mux.messages.postMessage("dev7", "c", { x: 1 })).to.be.rejectedWith(errors_1.AmbiguousWriteError);
-        // …unless scoped to one:
-        await mux.messages.postMessage("dev7", "c", { x: 1 }, { sources: ["local:7"] });
-        (0, chai_1.expect)(sink).to.deep.equal(["local:7:dev7"]);
-    });
-    (0, mocha_1.it)("no member with the cap → UnsupportedCapabilityError", async () => {
-        const mux = mk({ cloud: writeMember("cloud", { mode: "all" }, ["messages.list"], []) });
-        await xp(mux.messages.postMessage("dev7", "c", {})).to.be.rejectedWith(errors_1.UnsupportedCapabilityError);
-    });
-});

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

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

package/dist/test/offline-cache.test.js

@@ -1,289 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const chai_1 = require("chai");
-const mocha_1 = require("mocha");
-const doover_client_1 = require("../client/doover-client");
-const offline_cache_1 = require("../client/offline-cache");
-const request_options_1 = require("../client/request-options");
-const errors_1 = require("../client/errors");
-const snowflake_1 = require("../utils/snowflake");
-const helpers_1 = require("./helpers");
-function makeOnlineClient(fetchImpl) {
-    return new doover_client_1.DooverClient({
-        dataRestUrl: "https://api.example.com",
-        controlApiUrl: "https://control.example.com",
-        dataWssUrl: "wss://ws.example.com",
-        fetchImpl,
-        webSocketImpl: helpers_1.MockWebSocket,
-        disableBrowserLifecycleHooks: true,
-    });
-}
-(0, mocha_1.describe)("requestOptions", () => {
-    (0, mocha_1.it)("marks a request-options bag explicitly", () => {
-        const options = (0, request_options_1.requestOptions)({
-            sources: ["cloud"],
-            cache: { policy: "tag-values-history" },
-        });
-        (0, chai_1.expect)(options[request_options_1.REQUEST_OPTIONS_SYMBOL]).to.equal(true);
-        (0, chai_1.expect)(options.sources).to.deep.equal(["cloud"]);
-    });
-});
-(0, mocha_1.describe)("OfflineDataClient", () => {
-    (0, mocha_1.it)("caches reads covered by a stored channel policy and serves them offline", async () => {
-        let online = true;
-        const messageId = (0, snowflake_1.generateSnowflakeIdAtTime)(new Date("2026-06-10T00:00:00Z"));
-        const fetchMock = (0, helpers_1.createFetchMock)((url) => {
-            if (url.includes("/agents/a1/channels/tag_values/messages")) {
-                return (0, helpers_1.createJsonResponse)([
-                    {
-                        id: messageId,
-                        data: { value: 42 },
-                        attachments: [],
-                        author_id: "u1",
-                        channel: { agent_id: "a1", name: "tag_values" },
-                    },
-                ]);
-            }
-            return (0, helpers_1.createJsonResponse)({ ok: true });
-        });
-        const storage = new offline_cache_1.MemoryOfflineStorageAdapter();
-        const client = new offline_cache_1.OfflineDataClient({
-            client: makeOnlineClient(fetchMock),
-            storage,
-            scope: { userId: "u1", organisationId: "org1", sourceId: "cloud" },
-            isOnline: () => online,
-        });
-        client.setChannelPolicy({
-            id: "tag-values-history",
-            channel: { agentId: "a1", channelName: "tag_values" },
-            messages: { mode: "latest", count: 100 },
-        });
-        const onlineMessages = await client.messages.listMessages({ agentId: "a1", channelName: "tag_values" }, { limit: 100, order: "asc" });
-        (0, chai_1.expect)(onlineMessages.map((message) => message.data)).to.deep.equal([{ value: 42 }]);
-        online = false;
-        const offlineMessages = await client.messages.listMessages({ agentId: "a1", channelName: "tag_values" }, { limit: 100, order: "asc" });
-        (0, chai_1.expect)(offlineMessages).to.deep.equal(onlineMessages);
-        (0, chai_1.expect)(fetchMock.callCount).to.equal(1);
-    });
-    (0, mocha_1.it)("supports per-call cache opt-in for discovery reads", async () => {
-        let online = true;
-        const fetchMock = (0, helpers_1.createFetchMock)((url) => {
-            if (url.includes("/agents/")) {
-                return (0, helpers_1.createJsonResponse)({
-                    agents: [
-                        {
-                            id: "a1",
-                            organisation: "org1",
-                            name: "pump",
-                            display_name: "Pump",
-                            archived: false,
-                            group: "",
-                            type: "device",
-                            fixed_location: { latitude: 0, longitude: 0 },
-                            extra_config: {},
-                        },
-                    ],
-                    count: 1,
-                });
-            }
-            return (0, helpers_1.createJsonResponse)({ ok: true });
-        });
-        const client = new offline_cache_1.OfflineDataClient({
-            client: makeOnlineClient(fetchMock),
-            storage: new offline_cache_1.MemoryOfflineStorageAdapter(),
-            scope: { userId: "u1", organisationId: "org1", sourceId: "cloud" },
-            isOnline: () => online,
-        });
-        const onlineAgents = await client.agents.listAgents((0, request_options_1.requestOptions)({ cache: { mode: "read-through", policy: "agents" } }));
-        (0, chai_1.expect)((onlineAgents.agents ?? []).map((agent) => agent.id)).to.deep.equal(["a1"]);
-        online = false;
-        const offlineAgents = await client.agents.listAgents((0, request_options_1.requestOptions)({ cache: { mode: "read-through", policy: "agents" } }));
-        (0, chai_1.expect)(offlineAgents).to.deep.equal(onlineAgents);
-        (0, chai_1.expect)(fetchMock.callCount).to.equal(1);
-    });
-    (0, mocha_1.it)("fails writes immediately while offline", async () => {
-        const fetchMock = (0, helpers_1.createFetchMock)();
-        const client = new offline_cache_1.OfflineDataClient({
-            client: makeOnlineClient(fetchMock),
-            storage: new offline_cache_1.MemoryOfflineStorageAdapter(),
-            scope: { userId: "u1", organisationId: "org1", sourceId: "cloud" },
-            isOnline: () => false,
-        });
-        let error;
-        try {
-            await client.messages.postMessage({ agentId: "a1", channelName: "commands" }, { data: { run: true } });
-        }
-        catch (err) {
-            error = err;
-        }
-        (0, chai_1.expect)(error).to.be.instanceOf(errors_1.DooverOfflineError);
-        (0, chai_1.expect)(fetchMock.callCount).to.equal(0);
-    });
-    (0, mocha_1.it)("honours cache: false even when a stored policy exists", async () => {
-        let online = true;
-        const fetchMock = (0, helpers_1.createFetchMock)((url) => {
-            if (url.includes("/agents/a1/channels/tag_values/messages")) {
-                return (0, helpers_1.createJsonResponse)([
-                    {
-                        id: (0, snowflake_1.generateSnowflakeIdAtTime)(new Date("2026-06-10T00:00:00Z")),
-                        data: { value: 1 },
-                        attachments: [],
-                        author_id: "u1",
-                        channel: { agent_id: "a1", name: "tag_values" },
-                    },
-                ]);
-            }
-            return (0, helpers_1.createJsonResponse)({ ok: true });
-        });
-        const client = new offline_cache_1.OfflineDataClient({
-            client: makeOnlineClient(fetchMock),
-            storage: new offline_cache_1.MemoryOfflineStorageAdapter(),
-            scope: { userId: "u1", organisationId: "org1", sourceId: "cloud" },
-            isOnline: () => online,
-        });
-        client.setChannelPolicy({
-            id: "tag-values-history",
-            channel: { agentId: "a1", channelName: "tag_values" },
-            messages: { mode: "latest", count: 100 },
-        });
-        await client.messages.listMessages({ agentId: "a1", channelName: "tag_values" }, { limit: 100, order: "asc" }, (0, request_options_1.requestOptions)({ cache: false }));
-        online = false;
-        let error;
-        try {
-            await client.messages.listMessages({ agentId: "a1", channelName: "tag_values" }, { limit: 100, order: "asc" }, (0, request_options_1.requestOptions)({ cache: false }));
-        }
-        catch (err) {
-            error = err;
-        }
-        (0, chai_1.expect)(error).to.be.instanceOf(errors_1.DooverOfflineError);
-    });
-    (0, mocha_1.it)("tracks expired cached records and requires allowExpired to read them", async () => {
-        let online = true;
-        const fetchMock = (0, helpers_1.createFetchMock)((url) => {
-            if (url.includes("/agents/"))
-                return (0, helpers_1.createJsonResponse)({ agents: [], count: 0 });
-            return (0, helpers_1.createJsonResponse)({ ok: true });
-        });
-        const client = new offline_cache_1.OfflineDataClient({
-            client: makeOnlineClient(fetchMock),
-            storage: new offline_cache_1.MemoryOfflineStorageAdapter(),
-            scope: { userId: "u1", organisationId: "org1", sourceId: "cloud" },
-            isOnline: () => online,
-        });
-        await client.agents.listAgents((0, request_options_1.requestOptions)({ cache: { mode: "read-through", retentionMs: 1 } }));
-        await new Promise((resolve) => setTimeout(resolve, 5));
-        online = false;
-        let error;
-        try {
-            await client.agents.listAgents((0, request_options_1.requestOptions)({ cache: { mode: "read-through" } }));
-        }
-        catch (err) {
-            error = err;
-        }
-        (0, chai_1.expect)(error).to.be.instanceOf(errors_1.DooverOfflineError);
-        (0, chai_1.expect)(client.getOfflineStatus().state).to.equal("cache-miss");
-        const expired = await client.agents.listAgents((0, request_options_1.requestOptions)({ cache: { mode: "read-through", allowExpired: true } }));
-        (0, chai_1.expect)(expired.agents).to.deep.equal([]);
-        (0, chai_1.expect)(client.getOfflineStatus().isExpired).to.equal(true);
-    });
-    (0, mocha_1.it)("persists gateway messages into latest-N cache according to channel policy", async () => {
-        let online = true;
-        const fetchMock = (0, helpers_1.createFetchMock)();
-        const client = new offline_cache_1.OfflineDataClient({
-            client: makeOnlineClient(fetchMock),
-            storage: new offline_cache_1.MemoryOfflineStorageAdapter(),
-            scope: { userId: "u1", organisationId: "org1", sourceId: "cloud" },
-            isOnline: () => online,
-        });
-        client.setChannelPolicy({
-            id: "camera-latest",
-            channel: { agentId: "a1", channelName: "camera" },
-            messages: { mode: "latest", count: 2 },
-        });
-        client.gateway.subscribeToChannel({ agent_id: "a1", name: "camera" }, {});
-        await new Promise((resolve) => setTimeout(resolve, 0));
-        const ws = helpers_1.MockWebSocket.instances[helpers_1.MockWebSocket.instances.length - 1];
-        ws.open();
-        ws.receive({ op: 0, t: "Hello", d: {} });
-        ws.receive({
-            op: 0,
-            t: "Ready",
-            d: { session_id: "s1", session_token: "t1", subscriptions: [] },
-        });
-        for (const [idx, iso] of [
-            "2026-06-10T00:00:00Z",
-            "2026-06-10T00:01:00Z",
-            "2026-06-10T00:02:00Z",
-        ].entries()) {
-            ws.receive({
-                op: 0,
-                t: "MessageCreate",
-                d: {
-                    id: (0, snowflake_1.generateSnowflakeIdAtTime)(new Date(iso)),
-                    data: { idx },
-                    attachments: [],
-                    author_id: "u1",
-                    channel: { agent_id: "a1", name: "camera" },
-                },
-            });
-        }
-        await new Promise((resolve) => setTimeout(resolve, 0));
-        online = false;
-        const messages = await client.messages.listMessages({ agentId: "a1", channelName: "camera" }, { limit: 10, order: "asc" });
-        (0, chai_1.expect)(messages.map((message) => message.data)).to.deep.equal([
-            { idx: 1 },
-            { idx: 2 },
-        ]);
-        (0, chai_1.expect)(client.getOfflineStatus().state).to.equal("cache-fallback");
-    });
-    (0, mocha_1.it)("notifies offline status listeners when cached data is used", async () => {
-        let online = true;
-        const fetchMock = (0, helpers_1.createFetchMock)((url) => {
-            if (url.includes("/agents/"))
-                return (0, helpers_1.createJsonResponse)({ agents: [], count: 0 });
-            return (0, helpers_1.createJsonResponse)({ ok: true });
-        });
-        const client = new offline_cache_1.OfflineDataClient({
-            client: makeOnlineClient(fetchMock),
-            storage: new offline_cache_1.MemoryOfflineStorageAdapter(),
-            scope: { userId: "u1", organisationId: "org1", sourceId: "cloud" },
-            isOnline: () => online,
-        });
-        const seen = [];
-        const off = client.onOfflineStatusChange((status) => seen.push(status.state));
-        await client.agents.listAgents((0, request_options_1.requestOptions)({ cache: { mode: "read-through" } }));
-        online = false;
-        await client.agents.listAgents((0, request_options_1.requestOptions)({ cache: { mode: "read-through" } }));
-        off();
-        (0, chai_1.expect)(seen).to.include("online");
-        (0, chai_1.expect)(seen).to.include("cache-fallback");
-    });
-    (0, mocha_1.it)("caches selected attachment blobs through the blob storage adapter", async () => {
-        let online = true;
-        const fetchMock = (0, helpers_1.createFetchMock)((url) => {
-            if (url.includes("/attachments/thumb1")) {
-                return (0, helpers_1.createBlobResponse)("thumbnail-bytes", {
-                    headers: { "content-type": "image/jpeg" },
-                });
-            }
-            return (0, helpers_1.createJsonResponse)({ ok: true });
-        });
-        const client = new offline_cache_1.OfflineDataClient({
-            client: makeOnlineClient(fetchMock),
-            storage: new offline_cache_1.MemoryOfflineStorageAdapter(),
-            scope: { userId: "u1", organisationId: "org1", sourceId: "cloud" },
-            isOnline: () => online,
-        });
-        client.setChannelPolicy({
-            id: "camera-thumbnails",
-            channel: { agentId: "a1", channelName: "camera" },
-            messageAttachments: { include: "metadata-and-selected-blobs" },
-        });
-        const onlineBlob = await client.messages.getMessageAttachment({ agentId: "a1", channelName: "camera" }, "m1", "thumb1");
-        (0, chai_1.expect)(await onlineBlob.text()).to.equal("thumbnail-bytes");
-        online = false;
-        const offlineBlob = await client.messages.getMessageAttachment({ agentId: "a1", channelName: "camera" }, "m1", "thumb1");
-        (0, chai_1.expect)(await offlineBlob.text()).to.equal("thumbnail-bytes");
-        (0, chai_1.expect)(fetchMock.callCount).to.equal(1);
-    });
-});

package/dist/test/provenance-regression.test.d.ts

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

package/dist/test/provenance-regression.test.js

@@ -1,45 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const chai_1 = require("chai");
-const mocha_1 = require("mocha");
-const doover_client_1 = require("../client/doover-client");
-const helpers_1 = require("./helpers");
-function stripSource(v) {
-    return JSON.parse(JSON.stringify(v, (k, val) => (k === "__source" ? undefined : val)));
-}
-(0, mocha_1.describe)("provenance is additive only", () => {
-    (0, mocha_1.it)("REST payloads equal the wire body once __source is stripped", async () => {
-        const wire = { name: "c1", is_private: false, owner_id: "o", id: "ch1" };
-        const client = new doover_client_1.DooverClient({
-            dataRestUrl: "https://api.example.com",
-            controlApiUrl: "https://control.example.com",
-            dataWssUrl: "wss://ws.example.com",
-            fetchImpl: (0, helpers_1.createFetchMock)(() => (0, helpers_1.createJsonResponse)(wire)),
-            webSocketImpl: helpers_1.MockWebSocket,
-            disableBrowserLifecycleHooks: true,
-        });
-        const channel = await client.channels.getChannel("a1", "c1");
-        (0, chai_1.expect)(channel.__source).to.exist; // it IS stamped
-        (0, chai_1.expect)(stripSource(channel)).to.deep.equal(wire); // …but otherwise byte-identical
-    });
-    (0, mocha_1.it)("listMessages stamps each element, leaving the array shape intact", async () => {
-        const wire = [
-            { id: "2", data: { v: 2 }, attachments: [], author_id: "a", channel: { agent_id: "a1", name: "c1" } },
-            { id: "1", data: { v: 1 }, attachments: [], author_id: "a", channel: { agent_id: "a1", name: "c1" } },
-        ];
-        const client = new doover_client_1.DooverClient({
-            dataRestUrl: "https://api.example.com",
-            controlApiUrl: "https://control.example.com",
-            dataWssUrl: "wss://ws.example.com",
-            fetchImpl: (0, helpers_1.createFetchMock)(() => (0, helpers_1.createJsonResponse)(wire)),
-            webSocketImpl: helpers_1.MockWebSocket,
-            disableBrowserLifecycleHooks: true,
-        });
-        const msgs = await client.messages.listMessages("a1", "c1", { limit: 2 });
-        (0, chai_1.expect)(msgs).to.have.length(2);
-        (0, chai_1.expect)(msgs[0].__source?.via).to.include({ method: "messages.listMessages" });
-        // shape minus __source and the client-added `timestamp` matches the wire item
-        const { __source: _s, timestamp: _t, ...rest } = msgs[0];
-        (0, chai_1.expect)(rest).to.deep.equal(wire[0]);
-    });
-});

package/dist/test/provenance-stamper.test.d.ts

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

package/dist/test/provenance-stamper.test.js

@@ -1,41 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const chai_1 = require("chai");
-const mocha_1 = require("mocha");
-const provenance_1 = require("../client/provenance");
-(0, mocha_1.describe)("ProvenanceStamper", () => {
-    const stamper = new provenance_1.ProvenanceStamper({ id: "cloud", kind: "cloud", meta: { x: 1 } });
-    (0, mocha_1.it)("stamps a plain object top-level", () => {
-        const out = stamper.stampRest({ a: 1 }, { method: "x.y", request: { z: 2 }, startedAt: 0, durationMs: 5, status: 200 });
-        (0, chai_1.expect)(out).to.include({ a: 1 });
-        (0, chai_1.expect)(out.__source?.client.id).to.equal("cloud");
-        (0, chai_1.expect)(out.__source?.via).to.deep.include({ transport: "rest", method: "x.y", durationMs: 5, status: 200 });
-    });
-    (0, mocha_1.it)("stamps each element of an array", () => {
-        const out = stamper.stampRest([{ a: 1 }, { a: 2 }], { method: "x.list", request: {}, startedAt: 0, durationMs: 1 });
-        (0, chai_1.expect)(out[0].__source?.client.kind).to.equal("cloud");
-        (0, chai_1.expect)(out[1].__source?.client.kind).to.equal("cloud");
-    });
-    (0, mocha_1.it)("stamps array-valued props one level deep (e.g. { results: [...] })", () => {
-        const out = stamper.stampRest({ results: [{ a: 1 }], count: 1 }, { method: "x.batch", request: {}, startedAt: 0, durationMs: 1 });
-        (0, chai_1.expect)(out.__source?.client.id).to.equal("cloud");
-        (0, chai_1.expect)(out.results[0].__source?.client.id).to.equal("cloud");
-    });
-    (0, mocha_1.it)("leaves Blobs and primitives untouched", () => {
-        const blob = new Blob(["x"]);
-        (0, chai_1.expect)(stamper.stampRest(blob, { method: "m", request: {}, startedAt: 0, durationMs: 1 })).to.equal(blob);
-        (0, chai_1.expect)(stamper.stampRest(undefined, { method: "m", request: {}, startedAt: 0, durationMs: 1 })).to.equal(undefined);
-    });
-    (0, mocha_1.it)("wrapSubclient stamps awaited results with subclient.method", async () => {
-        const api = { thing: async () => ({ a: 1 }), sync: () => 42 };
-        const wrapped = (0, provenance_1.wrapSubclient)(api, "channels", stamper);
-        const r = await wrapped.thing();
-        (0, chai_1.expect)(r.__source?.via).to.include({ method: "channels.thing", transport: "rest" });
-        (0, chai_1.expect)(wrapped.sync()).to.equal(42); // sync passthrough
-    });
-    (0, mocha_1.it)("stampGatewayEvent stamps payload + nested aggregate/message", () => {
-        const out = stamper.stampGatewayEvent({ author_id: "a", channel: { agent_id: "x", name: "c" }, aggregate: { data: {}, attachments: [] } }, { event: "aggregateUpdate", sessionId: "s1" });
-        (0, chai_1.expect)(out.__source?.via).to.deep.include({ transport: "gateway", event: "aggregateUpdate", sessionId: "s1" });
-        (0, chai_1.expect)(out.aggregate.__source?.via).to.deep.include({ transport: "gateway", event: "aggregateUpdate" });
-    });
-});

package/dist/test/provenance-type.test.d.ts

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

package/dist/test/provenance-type.test.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const chai_1 = require("chai");
-const mocha_1 = require("mocha");
-(0, mocha_1.describe)("SourceProvenance", () => {
-    (0, mocha_1.it)("is structurally usable on existing data shapes (compile-time)", () => {
-        const prov = {
-            client: { id: "cloud", kind: "cloud" },
-            retrievedAt: Date.now(),
-            via: { transport: "rest", method: "aggregates.getAggregate", request: {}, startedAt: 0, durationMs: 1 },
-        };
-        const agg = { data: {}, attachments: [], __source: prov };
-        (0, chai_1.expect)(agg.__source?.client.kind).to.equal("cloud");
-    });
-});

package/dist/test/react-channel-messages-forward.test.d.ts

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

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

@@ -1,139 +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();
-/** `COUNT` messages, one per minute, ascending by id (index 0 = oldest). */
-const COUNT = 60;
-const ALL = Array.from({ length: COUNT }, (_, i) => {
-    const at = new Date(NOW - (COUNT - 1 - i) * 60000);
-    return {
-        id: (0, snowflake_1.generateSnowflakeIdAtTime)(at),
-        data: { i },
-        attachments: [],
-        author_id: "author",
-        channel: { agent_id: AGENT, name: CHANNEL },
-    };
-}).sort((a, b) => (BigInt(a.id) < BigInt(b.id) ? -1 : 1));
-/**
- * Emulates the REST route's *native* ordering, which the SDK client then
- * reverses per `order`: `before` returns the newest N below the cursor,
- * newest-first; a bare `after` returns the oldest N above it, oldest-first.
- */
-function serveNative(query) {
-    const before = query.get("before");
-    const after = query.get("after");
-    const limit = Number(query.get("limit") ?? "10");
-    if (before && !after) {
-        const below = ALL.filter((m) => BigInt(m.id) < BigInt(before));
-        return below.slice(Math.max(0, below.length - limit)).reverse(); // newest-first
-    }
-    if (after && !before) {
-        const above = ALL.filter((m) => BigInt(m.id) > BigInt(after));
-        return above.slice(0, limit); // oldest-first
-    }
-    // both bounds: newest-first within (after, before]
-    const within = ALL.filter((m) => BigInt(m.id) < BigInt(before) && BigInt(m.id) > BigInt(after));
-    return within.slice(Math.max(0, within.length - limit)).reverse();
-}
-function makeClient() {
-    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 q = new URL(url).searchParams;
-            calls.push(q);
-            return (0, helpers_1.createJsonResponse)(serveNative(q));
-        }
-        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, 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 } } });
-const idAtIndex = (i) => ALL[i].id;
-const timeOfIndex = (i) => NOW - (COUNT - 1 - i) * 60000;
-/** A snowflake landing strictly between messages i and i+1 (30s after i). */
-const anchorAfter = (i) => (0, snowflake_1.generateSnowflakeIdAtTime)(new Date(timeOfIndex(i) + 30000));
-(0, mocha_1.describe)("useChannelMessages forward pagination", () => {
-    (0, mocha_1.beforeEach)(() => {
-        (0, helpers_1.installSessionStorageMock)();
-        (0, messageRangeStore_1.resetChannelRangeStores)();
-    });
-    (0, mocha_1.afterEach)(() => {
-        sinon_1.default.restore();
-    });
-    (0, mocha_1.it)("pages forward from an anchor into newer messages", async () => {
-        const { client } = makeClient();
-        const qc = newQueryClient();
-        // Anchor between index 29 and 30 — half the history is newer than it.
-        const anchor = anchorAfter(29);
-        const { result } = (0, react_1.renderHook)(() => (0, react_2.useChannelMessages)({ agentId: AGENT, channelName: CHANNEL }, { limit: 10, anchor }), { wrapper: wrapper(client, qc) });
-        await (0, react_1.waitFor)(() => (0, chai_1.expect)(result.current.messages).to.have.length(10));
-        // The anchored page is the 10 newest *below* the anchor: indices 20..29.
-        (0, chai_1.expect)(result.current.messages.every((m) => BigInt(m.id) < BigInt(anchor))).to.equal(true);
-        (0, chai_1.expect)(result.current.hasPreviousPage).to.equal(true);
-        await (0, react_1.act)(async () => {
-            await result.current.fetchPreviousPage();
-        });
-        await (0, react_1.waitFor)(() => (0, chai_1.expect)(result.current.messages.some((m) => BigInt(m.id) > BigInt(anchor))).to.equal(true));
-        // Forward page brought in the messages immediately above the anchor (index 30+).
-        (0, chai_1.expect)(result.current.messages.map((m) => m.data).some((d) => d.i >= 30)).to.equal(true);
-    });
-    (0, mocha_1.it)("exposes no previous page for an unanchored (live) window", async () => {
-        const { client } = makeClient();
-        const qc = newQueryClient();
-        const { result } = (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)(result.current.messages).to.have.length(10));
-        (0, chai_1.expect)(result.current.hasPreviousPage).to.equal(false);
-    });
-    (0, mocha_1.it)("recovers messages above an anchor that has nothing below it, and terminates", async () => {
-        const { client } = makeClient();
-        const qc = newQueryClient();
-        // Anchor older than every message: the initial before=anchor page is empty.
-        const anchor = (0, snowflake_1.generateSnowflakeIdAtTime)(new Date(NOW - COUNT * 10 * 60000));
-        const { result } = (0, react_1.renderHook)(() => (0, react_2.useChannelMessages)({ agentId: AGENT, channelName: CHANNEL }, { limit: 10, anchor }), { wrapper: wrapper(client, qc) });
-        await (0, react_1.waitFor)(() => (0, chai_1.expect)(result.current.isLoading).to.equal(false));
-        (0, chai_1.expect)(result.current.messages).to.have.length(0);
-        // Empty below, but the walk still seeds from the anchor itself.
-        (0, chai_1.expect)(result.current.hasPreviousPage).to.equal(true);
-        // Drain forward until exhausted — must terminate, never loop.
-        for (let guard = 0; guard < 20 && result.current.hasPreviousPage; guard++) {
-            await (0, react_1.act)(async () => {
-                await result.current.fetchPreviousPage();
-            });
-        }
-        (0, chai_1.expect)(result.current.hasPreviousPage).to.equal(false);
-        // Every message above the anchor is recovered (order is the consumer's job).
-        const ids = result.current.messages.map((m) => m.id);
-        (0, chai_1.expect)(ids).to.have.length(COUNT);
-        (0, chai_1.expect)(ids).to.include(idAtIndex(0));
-        (0, chai_1.expect)(ids).to.include(idAtIndex(COUNT - 1));
-    });
-});

package/dist/test/react-channel-messages-range.test.d.ts

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