@terreno/api 0.14.0 → 0.14.1

package/dist/realtime/realtime.test.js

@@ -2140,6 +2140,914 @@ var createMockSocket = function (decodedToken) {
 // ─────────────────────────────────────────────────────────────────────────────
 // redactCredentials — Redis URL logging
 // ─────────────────────────────────────────────────────────────────────────────
+// ─────────────────────────────────────────────────────────────────────────────
+// ensureApiId
+// ─────────────────────────────────────────────────────────────────────────────
+(0, bun_test_1.describe)("ensureApiId", function () {
+    (0, bun_test_1.it)("returns null as-is", function () {
+        (0, bun_test_1.expect)((0, changeStreamWatcher_1.ensureApiId)(null)).toBeNull();
+    });
+    (0, bun_test_1.it)("returns undefined as-is", function () {
+        (0, bun_test_1.expect)((0, changeStreamWatcher_1.ensureApiId)(undefined)).toBeUndefined();
+    });
+    (0, bun_test_1.it)("returns arrays as-is", function () {
+        var arr = [1, 2, 3];
+        (0, bun_test_1.expect)((0, changeStreamWatcher_1.ensureApiId)(arr)).toBe(arr);
+    });
+    (0, bun_test_1.it)("returns primitive values as-is (non-object)", function () {
+        (0, bun_test_1.expect)((0, changeStreamWatcher_1.ensureApiId)("string")).toBe("string");
+    });
+    (0, bun_test_1.it)("adds id from _id when id is missing", function () {
+        (0, bun_test_1.expect)((0, changeStreamWatcher_1.ensureApiId)({ _id: "abc" })).toEqual({ _id: "abc", id: "abc" });
+    });
+    (0, bun_test_1.it)("does not overwrite existing id", function () {
+        (0, bun_test_1.expect)((0, changeStreamWatcher_1.ensureApiId)({ _id: "abc", id: "existing" })).toEqual({ _id: "abc", id: "existing" });
+    });
+    (0, bun_test_1.it)("returns object without _id unchanged", function () {
+        var obj = { name: "test" };
+        (0, bun_test_1.expect)((0, changeStreamWatcher_1.ensureApiId)(obj)).toBe(obj);
+    });
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// startChangeStreamWatcher & stopChangeStreamWatcher
+// ─────────────────────────────────────────────────────────────────────────────
+(0, bun_test_1.describe)("startChangeStreamWatcher & stopChangeStreamWatcher", function () {
+    var makeMockIo = function () {
+        var emissions = [];
+        var rooms = new Map();
+        var sockets = new Map();
+        return {
+            emissions: emissions,
+            sockets: {
+                adapter: { rooms: rooms },
+                sockets: sockets,
+            },
+            to: function (_room) { return ({
+                emit: function () { },
+            }); },
+        };
+    };
+    (0, bun_test_1.afterEach)(function () { return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, (0, changeStreamWatcher_1.stopChangeStreamWatcher)()];
+                case 1:
+                    _a.sent();
+                    (0, registry_1.clearRealtimeRegistry)();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.it)("starts and stops without error when MongoDB is connected", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var io;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    io = makeMockIo();
+                    (0, bun_test_1.expect)(function () { return (0, changeStreamWatcher_1.startChangeStreamWatcher)(io, {}, false); }).not.toThrow();
+                    return [4 /*yield*/, (0, changeStreamWatcher_1.stopChangeStreamWatcher)()];
+                case 1:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.it)("starts with debug mode enabled", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var io;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    io = makeMockIo();
+                    (0, bun_test_1.expect)(function () { return (0, changeStreamWatcher_1.startChangeStreamWatcher)(io, {}, true); }).not.toThrow();
+                    return [4 /*yield*/, (0, changeStreamWatcher_1.stopChangeStreamWatcher)()];
+                case 1:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.it)("starts with custom config options", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var io;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    io = makeMockIo();
+                    (0, bun_test_1.expect)(function () {
+                        return (0, changeStreamWatcher_1.startChangeStreamWatcher)(io, {
+                            batchSize: 10,
+                            fullDocument: "whenAvailable",
+                            ignoredCollections: ["logs"],
+                            ignoredOperations: ["delete"],
+                        }, false);
+                    }).not.toThrow();
+                    return [4 /*yield*/, (0, changeStreamWatcher_1.stopChangeStreamWatcher)()];
+                case 1:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.it)("stopChangeStreamWatcher is safe to call when no watcher is active", function () { return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, (0, bun_test_1.expect)((0, changeStreamWatcher_1.stopChangeStreamWatcher)()).resolves.toBeUndefined()];
+                case 1:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.it)("stopChangeStreamWatcher can be called multiple times", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var io;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    io = makeMockIo();
+                    (0, changeStreamWatcher_1.startChangeStreamWatcher)(io, {}, false);
+                    return [4 /*yield*/, (0, changeStreamWatcher_1.stopChangeStreamWatcher)()];
+                case 1:
+                    _a.sent();
+                    return [4 /*yield*/, (0, changeStreamWatcher_1.stopChangeStreamWatcher)()];
+                case 2:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+});
+// Change streams require a MongoDB replica set. CI (api-ci.yml) runs standalone MongoDB,
+// so these tests are skipped when replica sets are not available.
+var hasReplicaSet = function () { return __awaiter(void 0, void 0, void 0, function () {
+    var mongoose, admin, status_1, _a;
+    return __generator(this, function (_b) {
+        switch (_b.label) {
+            case 0:
+                _b.trys.push([0, 2, , 3]);
+                mongoose = require("mongoose");
+                admin = mongoose.connection.db.admin();
+                return [4 /*yield*/, admin.command({ replSetGetStatus: 1 })];
+            case 1:
+                status_1 = _b.sent();
+                return [2 /*return*/, !!status_1.ok];
+            case 2:
+                _a = _b.sent();
+                return [2 /*return*/, false];
+            case 3: return [2 /*return*/];
+        }
+    });
+}); };
+(0, bun_test_1.describe)("startChangeStreamWatcher — change event integration", function () {
+    var mongoose = require("mongoose");
+    var replicaSetAvailable = false;
+    var realtimeTestSchema = new mongoose.Schema({
+        deleted: { default: false, type: Boolean },
+        name: { type: String },
+        ownerId: { type: String },
+    }, { collection: "realtimetests", strict: "throw" });
+    var RealtimeTestModel;
+    try {
+        RealtimeTestModel = mongoose.model("RealtimeTest");
+    }
+    catch (_a) {
+        RealtimeTestModel = mongoose.model("RealtimeTest", realtimeTestSchema);
+    }
+    var makeTrackedIo = function () {
+        var emissions = [];
+        var rooms = new Map();
+        var sockets = new Map();
+        var addSocketToRoom = function (room, decodedToken) {
+            var _a;
+            if (decodedToken === void 0) { decodedToken = { admin: true, id: "admin" }; }
+            var socketId = "socket-".concat(Math.random().toString(36).slice(2, 9));
+            if (!rooms.has(room)) {
+                rooms.set(room, new Set());
+            }
+            (_a = rooms.get(room)) === null || _a === void 0 ? void 0 : _a.add(socketId);
+            sockets.set(socketId, {
+                decodedToken: decodedToken,
+                emit: function (event, payload) {
+                    emissions.push({ event: event, payload: payload, room: room, socketId: socketId });
+                },
+                id: socketId,
+            });
+        };
+        return {
+            addSocketToRoom: addSocketToRoom,
+            emissions: emissions,
+            sockets: {
+                adapter: { rooms: rooms },
+                sockets: sockets,
+            },
+            to: function (room) { return ({
+                emit: function (event, payload) {
+                    emissions.push({ event: event, payload: payload, room: room });
+                },
+            }); },
+        };
+    };
+    (0, bun_test_1.beforeAll)(function () { return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, hasReplicaSet()];
+                case 1:
+                    replicaSetAvailable = _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.beforeEach)(function () { return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    (0, registry_1.clearRealtimeRegistry)();
+                    (0, queryStore_1.clearQueryStore)();
+                    return [4 /*yield*/, RealtimeTestModel.deleteMany({})];
+                case 1:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.afterEach)(function () { return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, (0, changeStreamWatcher_1.stopChangeStreamWatcher)()];
+                case 1:
+                    _a.sent();
+                    (0, registry_1.clearRealtimeRegistry)();
+                    (0, queryStore_1.clearQueryStore)();
+                    return [4 /*yield*/, RealtimeTestModel.deleteMany({})];
+                case 2:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.it)("processes insert events from MongoDB change stream", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var io, createEmissions;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    if (!replicaSetAvailable) {
+                        return [2 /*return*/];
+                    }
+                    (0, registry_1.registerRealtime)({
+                        collectionName: "realtimetests",
+                        config: { methods: ["create", "update", "delete"], roomStrategy: "model" },
+                        modelName: "RealtimeTest",
+                        options: {
+                            permissions: {
+                                create: [function () { return true; }],
+                                delete: [function () { return true; }],
+                                list: [function () { return true; }],
+                                read: [function () { return true; }],
+                                update: [function () { return true; }],
+                            },
+                        },
+                        routePath: "/realtimetests",
+                    });
+                    io = makeTrackedIo();
+                    io.addSocketToRoom("model:realtimetests");
+                    (0, changeStreamWatcher_1.startChangeStreamWatcher)(io, {}, true);
+                    return [4 /*yield*/, RealtimeTestModel.create({ name: "test-item", ownerId: "user-1" })];
+                case 1:
+                    _a.sent();
+                    // Wait for the change stream event to be processed
+                    return [4 /*yield*/, new Promise(function (resolve) { return setTimeout(resolve, 1500); })];
+                case 2:
+                    // Wait for the change stream event to be processed
+                    _a.sent();
+                    createEmissions = io.emissions.filter(function (e) { var _a; return e.event === "sync" && ((_a = e.payload) === null || _a === void 0 ? void 0 : _a.method) === "create"; });
+                    (0, bun_test_1.expect)(createEmissions.length).toBeGreaterThanOrEqual(1);
+                    return [4 /*yield*/, (0, changeStreamWatcher_1.stopChangeStreamWatcher)()];
+                case 3:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.it)("processes update events from MongoDB change stream", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var doc, io, updateEmissions;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    if (!replicaSetAvailable) {
+                        return [2 /*return*/];
+                    }
+                    (0, registry_1.registerRealtime)({
+                        collectionName: "realtimetests",
+                        config: { methods: ["create", "update", "delete"], roomStrategy: "model" },
+                        modelName: "RealtimeTest",
+                        options: {
+                            permissions: {
+                                create: [function () { return true; }],
+                                delete: [function () { return true; }],
+                                list: [function () { return true; }],
+                                read: [function () { return true; }],
+                                update: [function () { return true; }],
+                            },
+                        },
+                        routePath: "/realtimetests",
+                    });
+                    return [4 /*yield*/, RealtimeTestModel.create({ name: "item-to-update", ownerId: "user-1" })];
+                case 1:
+                    doc = _a.sent();
+                    io = makeTrackedIo();
+                    io.addSocketToRoom("model:realtimetests");
+                    (0, changeStreamWatcher_1.startChangeStreamWatcher)(io, {}, true);
+                    return [4 /*yield*/, RealtimeTestModel.updateOne({ _id: doc._id }, { $set: { name: "updated-item" } })];
+                case 2:
+                    _a.sent();
+                    return [4 /*yield*/, new Promise(function (resolve) { return setTimeout(resolve, 1500); })];
+                case 3:
+                    _a.sent();
+                    updateEmissions = io.emissions.filter(function (e) { var _a; return e.event === "sync" && ((_a = e.payload) === null || _a === void 0 ? void 0 : _a.method) === "update"; });
+                    (0, bun_test_1.expect)(updateEmissions.length).toBeGreaterThanOrEqual(1);
+                    return [4 /*yield*/, (0, changeStreamWatcher_1.stopChangeStreamWatcher)()];
+                case 4:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.it)("processes hard delete events from MongoDB change stream", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var doc, io, deleteEmissions;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    if (!replicaSetAvailable) {
+                        return [2 /*return*/];
+                    }
+                    (0, registry_1.registerRealtime)({
+                        collectionName: "realtimetests",
+                        config: { methods: ["create", "update", "delete"], roomStrategy: "model" },
+                        modelName: "RealtimeTest",
+                        options: {
+                            permissions: {
+                                create: [function () { return true; }],
+                                delete: [function () { return true; }],
+                                list: [function () { return true; }],
+                                read: [function () { return true; }],
+                                update: [function () { return true; }],
+                            },
+                        },
+                        routePath: "/realtimetests",
+                    });
+                    return [4 /*yield*/, RealtimeTestModel.create({ name: "item-to-delete" })];
+                case 1:
+                    doc = _a.sent();
+                    io = makeTrackedIo();
+                    io.addSocketToRoom("model:realtimetests");
+                    (0, changeStreamWatcher_1.startChangeStreamWatcher)(io, {}, true);
+                    return [4 /*yield*/, RealtimeTestModel.deleteOne({ _id: doc._id })];
+                case 2:
+                    _a.sent();
+                    return [4 /*yield*/, new Promise(function (resolve) { return setTimeout(resolve, 1500); })];
+                case 3:
+                    _a.sent();
+                    deleteEmissions = io.emissions.filter(function (e) { var _a; return e.event === "sync" && ((_a = e.payload) === null || _a === void 0 ? void 0 : _a.method) === "delete"; });
+                    (0, bun_test_1.expect)(deleteEmissions.length).toBeGreaterThanOrEqual(1);
+                    return [4 /*yield*/, (0, changeStreamWatcher_1.stopChangeStreamWatcher)()];
+                case 4:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.it)("processes soft delete events from MongoDB change stream", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var doc, io, deleteEmissions;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    if (!replicaSetAvailable) {
+                        return [2 /*return*/];
+                    }
+                    (0, registry_1.registerRealtime)({
+                        collectionName: "realtimetests",
+                        config: { methods: ["create", "update", "delete"], roomStrategy: "model" },
+                        modelName: "RealtimeTest",
+                        options: {
+                            permissions: {
+                                create: [function () { return true; }],
+                                delete: [function () { return true; }],
+                                list: [function () { return true; }],
+                                read: [function () { return true; }],
+                                update: [function () { return true; }],
+                            },
+                        },
+                        routePath: "/realtimetests",
+                    });
+                    return [4 /*yield*/, RealtimeTestModel.create({ name: "item-to-soft-delete" })];
+                case 1:
+                    doc = _a.sent();
+                    io = makeTrackedIo();
+                    io.addSocketToRoom("model:realtimetests");
+                    (0, changeStreamWatcher_1.startChangeStreamWatcher)(io, {}, true);
+                    return [4 /*yield*/, RealtimeTestModel.updateOne({ _id: doc._id }, { $set: { deleted: true } })];
+                case 2:
+                    _a.sent();
+                    return [4 /*yield*/, new Promise(function (resolve) { return setTimeout(resolve, 1500); })];
+                case 3:
+                    _a.sent();
+                    deleteEmissions = io.emissions.filter(function (e) { var _a; return e.event === "sync" && ((_a = e.payload) === null || _a === void 0 ? void 0 : _a.method) === "delete"; });
+                    (0, bun_test_1.expect)(deleteEmissions.length).toBeGreaterThanOrEqual(1);
+                    return [4 /*yield*/, (0, changeStreamWatcher_1.stopChangeStreamWatcher)()];
+                case 4:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.it)("includes updatedFields and emits to document rooms", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var doc, docId, io, updateEmissions;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    if (!replicaSetAvailable) {
+                        return [2 /*return*/];
+                    }
+                    (0, registry_1.registerRealtime)({
+                        collectionName: "realtimetests",
+                        config: { methods: ["create", "update", "delete"], roomStrategy: "model" },
+                        modelName: "RealtimeTest",
+                        options: {
+                            permissions: {
+                                create: [function () { return true; }],
+                                delete: [function () { return true; }],
+                                list: [function () { return true; }],
+                                read: [function () { return true; }],
+                                update: [function () { return true; }],
+                            },
+                        },
+                        routePath: "/realtimetests",
+                    });
+                    return [4 /*yield*/, RealtimeTestModel.create({ name: "fields-test" })];
+                case 1:
+                    doc = _a.sent();
+                    docId = doc._id.toString();
+                    io = makeTrackedIo();
+                    io.addSocketToRoom("model:realtimetests");
+                    io.addSocketToRoom("document:realtimetests:".concat(docId));
+                    (0, changeStreamWatcher_1.startChangeStreamWatcher)(io, {}, true);
+                    return [4 /*yield*/, RealtimeTestModel.updateOne({ _id: doc._id }, { $set: { name: "fields-updated" } })];
+                case 2:
+                    _a.sent();
+                    return [4 /*yield*/, new Promise(function (resolve) { return setTimeout(resolve, 1500); })];
+                case 3:
+                    _a.sent();
+                    updateEmissions = io.emissions.filter(function (e) { var _a; return e.event === "sync" && ((_a = e.payload) === null || _a === void 0 ? void 0 : _a.method) === "update"; });
+                    (0, bun_test_1.expect)(updateEmissions.length).toBeGreaterThanOrEqual(1);
+                    if (updateEmissions.length > 0) {
+                        (0, bun_test_1.expect)(updateEmissions[0].payload.updatedFields).toBeDefined();
+                        (0, bun_test_1.expect)(updateEmissions[0].payload.updatedFields).toContain("name");
+                    }
+                    return [4 /*yield*/, (0, changeStreamWatcher_1.stopChangeStreamWatcher)()];
+                case 4:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// emitToDocumentAndQueryRooms — no-entry path
+// ─────────────────────────────────────────────────────────────────────────────
+(0, bun_test_1.describe)("emitToDocumentAndQueryRooms — no registry entry", function () {
+    var makeIoSimple = function () {
+        var emissions = [];
+        return {
+            emissions: emissions,
+            sockets: {
+                adapter: { rooms: new Map() },
+                sockets: new Map(),
+            },
+            to: function (room) { return ({
+                emit: function (event, payload) {
+                    emissions.push({ event: event, payload: payload, room: room });
+                },
+            }); },
+        };
+    };
+    (0, bun_test_1.beforeEach)(function () {
+        (0, queryStore_1.clearQueryStore)();
+    });
+    (0, bun_test_1.afterEach)(function () {
+        (0, queryStore_1.clearQueryStore)();
+    });
+    (0, bun_test_1.it)("emits to document room via io.to when no entry is provided", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var io, event;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    io = makeIoSimple();
+                    event = {
+                        collection: "items",
+                        id: "doc-1",
+                        method: "update",
+                        model: "Item",
+                        timestamp: 1,
+                    };
+                    return [4 /*yield*/, (0, changeStreamWatcher_1.emitToDocumentAndQueryRooms)(io, "items", event, {}, function () { })];
+                case 1:
+                    _a.sent();
+                    (0, bun_test_1.expect)(io.emissions.some(function (e) { return e.room === "document:items:doc-1"; })).toBe(true);
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.it)("emits hard deletes to query rooms via io.to when no entry", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var queryId, io, event;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    queryId = (0, queryStore_1.computeQueryId)("items", { status: "active" });
+                    (0, queryStore_1.addQuerySubscription)("socket-a", "items", { status: "active" }, queryId);
+                    io = makeIoSimple();
+                    event = {
+                        collection: "items",
+                        id: "doc-1",
+                        method: "delete",
+                        model: "Item",
+                        timestamp: 1,
+                    };
+                    return [4 /*yield*/, (0, changeStreamWatcher_1.emitToDocumentAndQueryRooms)(io, "items", event, undefined, function () { })];
+                case 1:
+                    _a.sent();
+                    (0, bun_test_1.expect)(io.emissions.some(function (e) { return e.room === "query:".concat(queryId); })).toBe(true);
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.it)("emits soft delete to query rooms via io.to when no entry and doc matches", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var queryId, io, event;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    queryId = (0, queryStore_1.computeQueryId)("items", { status: "active" });
+                    (0, queryStore_1.addQuerySubscription)("socket-a", "items", { status: "active" }, queryId);
+                    io = makeIoSimple();
+                    event = {
+                        collection: "items",
+                        id: "doc-1",
+                        method: "delete",
+                        model: "Item",
+                        timestamp: 1,
+                    };
+                    return [4 /*yield*/, (0, changeStreamWatcher_1.emitToDocumentAndQueryRooms)(io, "items", event, { status: "active" }, function () { })];
+                case 1:
+                    _a.sent();
+                    (0, bun_test_1.expect)(io.emissions.some(function (e) { return e.room === "query:".concat(queryId); })).toBe(true);
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.it)("emits create events to query rooms via io.to when no entry and doc matches", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var queryId, io, event;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    queryId = (0, queryStore_1.computeQueryId)("items", { status: "active" });
+                    (0, queryStore_1.addQuerySubscription)("socket-a", "items", { status: "active" }, queryId);
+                    io = makeIoSimple();
+                    event = {
+                        collection: "items",
+                        id: "doc-1",
+                        method: "create",
+                        model: "Item",
+                        timestamp: 1,
+                    };
+                    return [4 /*yield*/, (0, changeStreamWatcher_1.emitToDocumentAndQueryRooms)(io, "items", event, { status: "active" }, function () { })];
+                case 1:
+                    _a.sent();
+                    (0, bun_test_1.expect)(io.emissions.some(function (e) { return e.room === "query:".concat(queryId); })).toBe(true);
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.it)("emits update events to query rooms via io.to when no entry and doc matches", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var queryId, io, event;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    queryId = (0, queryStore_1.computeQueryId)("items", { status: "active" });
+                    (0, queryStore_1.addQuerySubscription)("socket-a", "items", { status: "active" }, queryId);
+                    io = makeIoSimple();
+                    event = {
+                        collection: "items",
+                        id: "doc-1",
+                        method: "update",
+                        model: "Item",
+                        timestamp: 1,
+                    };
+                    return [4 /*yield*/, (0, changeStreamWatcher_1.emitToDocumentAndQueryRooms)(io, "items", event, { status: "active" }, function () { })];
+                case 1:
+                    _a.sent();
+                    (0, bun_test_1.expect)(io.emissions.some(function (e) { return e.room === "query:".concat(queryId); })).toBe(true);
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.it)("emits delete to query rooms via io.to when update no longer matches and no entry", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var queryId, io, event, queryEmissions;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    queryId = (0, queryStore_1.computeQueryId)("items", { status: "active" });
+                    (0, queryStore_1.addQuerySubscription)("socket-a", "items", { status: "active" }, queryId);
+                    io = makeIoSimple();
+                    event = {
+                        collection: "items",
+                        id: "doc-1",
+                        method: "update",
+                        model: "Item",
+                        timestamp: 1,
+                    };
+                    return [4 /*yield*/, (0, changeStreamWatcher_1.emitToDocumentAndQueryRooms)(io, "items", event, { status: "inactive" }, function () { })];
+                case 1:
+                    _a.sent();
+                    queryEmissions = io.emissions.filter(function (e) { return e.room === "query:".concat(queryId); });
+                    (0, bun_test_1.expect)(queryEmissions.length).toBe(1);
+                    (0, bun_test_1.expect)(queryEmissions[0].payload).toMatchObject({ method: "delete" });
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// RealtimeApp — onServerCreated, setupAdapter, close
+// ─────────────────────────────────────────────────────────────────────────────
+(0, bun_test_1.describe)("RealtimeApp — onServerCreated and setupAdapter", function () {
+    var originalEnv = process.env;
+    (0, bun_test_1.beforeEach)(function () {
+        process.env = __assign(__assign({}, originalEnv), { TOKEN_SECRET: "test-secret" });
+    });
+    (0, bun_test_1.afterEach)(function () { return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            process.env = originalEnv;
+            (0, registry_1.clearRealtimeRegistry)();
+            return [2 /*return*/];
+        });
+    }); });
+    (0, bun_test_1.it)("register adds /realtime/health endpoint with debug flag", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var expressApp, app, supertest, st, res;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    expressApp = (0, express_1.default)();
+                    app = new realtimeApp_1.RealtimeApp({ debug: true });
+                    app.register(expressApp);
+                    return [4 /*yield*/, Promise.resolve().then(function () { return __importStar(require("supertest")); })];
+                case 1:
+                    supertest = _a.sent();
+                    st = supertest.default(expressApp);
+                    return [4 /*yield*/, st.get("/realtime/health").expect(200)];
+                case 2:
+                    res = _a.sent();
+                    (0, bun_test_1.expect)(res.body.status).toBe("not_started");
+                    (0, bun_test_1.expect)(res.body.debug).toBe(true);
+                    (0, bun_test_1.expect)(res.body.clients).toBe(0);
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.it)("onServerCreated sets up Socket.io with JWT auth", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var http, app, expressApp, server;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, Promise.resolve().then(function () { return __importStar(require("node:http")); })];
+                case 1:
+                    http = _a.sent();
+                    app = new realtimeApp_1.RealtimeApp({ debug: true, tokenSecret: "test-secret" });
+                    expressApp = (0, express_1.default)();
+                    app.register(expressApp);
+                    server = http.createServer(expressApp);
+                    app.onServerCreated(server);
+                    (0, bun_test_1.expect)(app.getIo()).not.toBeNull();
+                    return [4 /*yield*/, app.close()];
+                case 2:
+                    _a.sent();
+                    server.close();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.it)("onServerCreated throws when TOKEN_SECRET is missing", function () {
+        var http = require("node:http");
+        var origSecret = process.env.TOKEN_SECRET;
+        process.env.TOKEN_SECRET = "";
+        var app = new realtimeApp_1.RealtimeApp({});
+        var expressApp = (0, express_1.default)();
+        app.register(expressApp);
+        var server = http.createServer(expressApp);
+        (0, bun_test_1.expect)(function () { return app.onServerCreated(server); }).toThrow("TOKEN_SECRET is required");
+        process.env.TOKEN_SECRET = origSecret;
+        server.close();
+    });
+    (0, bun_test_1.it)("onServerCreated uses default TOKEN_SECRET from env", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var http, app, expressApp, server;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, Promise.resolve().then(function () { return __importStar(require("node:http")); })];
+                case 1:
+                    http = _a.sent();
+                    process.env.TOKEN_SECRET = "env-secret";
+                    app = new realtimeApp_1.RealtimeApp({ debug: false });
+                    expressApp = (0, express_1.default)();
+                    app.register(expressApp);
+                    server = http.createServer(expressApp);
+                    app.onServerCreated(server);
+                    (0, bun_test_1.expect)(app.getIo()).not.toBeNull();
+                    return [4 /*yield*/, app.close()];
+                case 2:
+                    _a.sent();
+                    server.close();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.it)("setupAdapter logs info for redis adapter with URL", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var http, app, expressApp, server;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, Promise.resolve().then(function () { return __importStar(require("node:http")); })];
+                case 1:
+                    http = _a.sent();
+                    app = new realtimeApp_1.RealtimeApp({
+                        adapter: "redis",
+                        debug: true,
+                        redisUrl: "redis://user:pass@localhost:6379",
+                        tokenSecret: "test-secret",
+                    });
+                    expressApp = (0, express_1.default)();
+                    app.register(expressApp);
+                    server = http.createServer(expressApp);
+                    app.onServerCreated(server);
+                    (0, bun_test_1.expect)(app.getIo()).not.toBeNull();
+                    return [4 /*yield*/, app.close()];
+                case 2:
+                    _a.sent();
+                    server.close();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.it)("setupAdapter warns when redis adapter has no URL", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var http, origValkey, origRedis, app, expressApp, server;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, Promise.resolve().then(function () { return __importStar(require("node:http")); })];
+                case 1:
+                    http = _a.sent();
+                    origValkey = process.env.VALKEY_URL;
+                    origRedis = process.env.REDIS_URL;
+                    delete process.env.VALKEY_URL;
+                    delete process.env.REDIS_URL;
+                    app = new realtimeApp_1.RealtimeApp({
+                        adapter: "redis",
+                        debug: true,
+                        tokenSecret: "test-secret",
+                    });
+                    expressApp = (0, express_1.default)();
+                    app.register(expressApp);
+                    server = http.createServer(expressApp);
+                    app.onServerCreated(server);
+                    (0, bun_test_1.expect)(app.getIo()).not.toBeNull();
+                    return [4 /*yield*/, app.close()];
+                case 2:
+                    _a.sent();
+                    server.close();
+                    process.env.VALKEY_URL = origValkey;
+                    process.env.REDIS_URL = origRedis;
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.it)("setupAdapter with none adapter does nothing extra", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var http, app, expressApp, server;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, Promise.resolve().then(function () { return __importStar(require("node:http")); })];
+                case 1:
+                    http = _a.sent();
+                    app = new realtimeApp_1.RealtimeApp({
+                        adapter: "none",
+                        debug: true,
+                        tokenSecret: "test-secret",
+                    });
+                    expressApp = (0, express_1.default)();
+                    app.register(expressApp);
+                    server = http.createServer(expressApp);
+                    app.onServerCreated(server);
+                    (0, bun_test_1.expect)(app.getIo()).not.toBeNull();
+                    return [4 /*yield*/, app.close()];
+                case 2:
+                    _a.sent();
+                    server.close();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.it)("close is safe after onServerCreated", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var http, app, expressApp, server;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, Promise.resolve().then(function () { return __importStar(require("node:http")); })];
+                case 1:
+                    http = _a.sent();
+                    app = new realtimeApp_1.RealtimeApp({ tokenSecret: "test-secret" });
+                    expressApp = (0, express_1.default)();
+                    app.register(expressApp);
+                    server = http.createServer(expressApp);
+                    app.onServerCreated(server);
+                    return [4 /*yield*/, app.close()];
+                case 2:
+                    _a.sent();
+                    (0, bun_test_1.expect)(app.getIo()).toBeNull();
+                    server.close();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.it)("health endpoint reports running after onServerCreated", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var http, app, expressApp, server, supertest, st, res;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, Promise.resolve().then(function () { return __importStar(require("node:http")); })];
+                case 1:
+                    http = _a.sent();
+                    app = new realtimeApp_1.RealtimeApp({ tokenSecret: "test-secret" });
+                    expressApp = (0, express_1.default)();
+                    app.register(expressApp);
+                    server = http.createServer(expressApp);
+                    app.onServerCreated(server);
+                    return [4 /*yield*/, Promise.resolve().then(function () { return __importStar(require("supertest")); })];
+                case 2:
+                    supertest = _a.sent();
+                    st = supertest.default(expressApp);
+                    return [4 /*yield*/, st.get("/realtime/health").expect(200)];
+                case 3:
+                    res = _a.sent();
+                    (0, bun_test_1.expect)(res.body.status).toBe("running");
+                    return [4 /*yield*/, app.close()];
+                case 4:
+                    _a.sent();
+                    server.close();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.it)("onServerCreated with custom cors option", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var http, app, expressApp, server;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, Promise.resolve().then(function () { return __importStar(require("node:http")); })];
+                case 1:
+                    http = _a.sent();
+                    app = new realtimeApp_1.RealtimeApp({
+                        cors: { methods: ["GET"], origin: "https://example.com" },
+                        tokenSecret: "test-secret",
+                    });
+                    expressApp = (0, express_1.default)();
+                    app.register(expressApp);
+                    server = http.createServer(expressApp);
+                    app.onServerCreated(server);
+                    (0, bun_test_1.expect)(app.getIo()).not.toBeNull();
+                    return [4 /*yield*/, app.close()];
+                case 2:
+                    _a.sent();
+                    server.close();
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    (0, bun_test_1.it)("setupAdapter uses VALKEY_URL when redisUrl not provided", function () { return __awaiter(void 0, void 0, void 0, function () {
+        var http, app, expressApp, server;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, Promise.resolve().then(function () { return __importStar(require("node:http")); })];
+                case 1:
+                    http = _a.sent();
+                    process.env.VALKEY_URL = "redis://localhost:6379";
+                    app = new realtimeApp_1.RealtimeApp({
+                        adapter: "redis",
+                        debug: true,
+                        tokenSecret: "test-secret",
+                    });
+                    expressApp = (0, express_1.default)();
+                    app.register(expressApp);
+                    server = http.createServer(expressApp);
+                    app.onServerCreated(server);
+                    (0, bun_test_1.expect)(app.getIo()).not.toBeNull();
+                    return [4 /*yield*/, app.close()];
+                case 2:
+                    _a.sent();
+                    server.close();
+                    delete process.env.VALKEY_URL;
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+});
 (0, bun_test_1.describe)("redactCredentials", function () {
     (0, bun_test_1.it)("redacts user:password@ in a redis URL", function () {
         (0, bun_test_1.expect)((0, realtimeApp_1.redactCredentials)("redis://user:secret@host:6379/0")).toBe("redis://***@host:6379/0");