@webiny/api-websockets-sql 0.0.0-unstable.0156a4c312

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Webiny
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,11 @@
+# @webiny/api-websockets-sql
+
+> [!NOTE]
+> This package is part of the [Webiny](https://www.webiny.com) monorepo.
+> It’s **included in every Webiny project by default** and is not meant to be used as a standalone package.
+
+📘 **Documentation:** [https://www.webiny.com/docs](https://www.webiny.com/docs)
+
+---
+
+_This README file is automatically generated during the publish process._

package/TableName/TableName.d.ts

@@ -0,0 +1,6 @@
+import { TableName as TableNameAbstraction } from "../TableName/abstractions.js";
+export declare class TableName implements TableNameAbstraction.Interface {
+    private readonly prefix;
+    constructor(prefix?: string);
+    resolve(name: string): string;
+}

package/TableName/TableName.js

@@ -0,0 +1,12 @@
+class TableName {
+    constructor(prefix){
+        this.prefix = prefix;
+    }
+    resolve(name) {
+        if (!this.prefix) return name;
+        return `${this.prefix}_${name}`;
+    }
+}
+export { TableName };
+
+//# sourceMappingURL=TableName.js.map

package/TableName/TableName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableName/TableName.js","sources":["../../src/TableName/TableName.ts"],"sourcesContent":["import { TableName as TableNameAbstraction } from \"~/TableName/abstractions.js\";\n\nexport class TableName implements TableNameAbstraction.Interface {\n    private readonly prefix;\n\n    public constructor(prefix?: string) {\n        this.prefix = prefix;\n    }\n\n    public resolve(name: string): string {\n        if (!this.prefix) {\n            return name;\n        }\n        return `${this.prefix}_${name}`;\n    }\n}\n"],"names":["TableName","prefix","name"],"mappings":"AAEO,MAAMA;IAGT,YAAmBC,MAAe,CAAE;QAChC,IAAI,CAAC,MAAM,GAAGA;IAClB;IAEO,QAAQC,IAAY,EAAU;QACjC,IAAI,CAAC,IAAI,CAAC,MAAM,EACZ,OAAOA;QAEX,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,EAAEA,MAAM;IACnC;AACJ"}

package/TableName/abstractions.d.ts

@@ -0,0 +1,7 @@
+export interface ITableName {
+    resolve(name: string): string;
+}
+export declare const TableName: import("@webiny/di").Abstraction<ITableName>;
+export declare namespace TableName {
+    type Interface = ITableName;
+}

package/TableName/abstractions.js

@@ -0,0 +1,5 @@
+import { createAbstraction } from "@webiny/feature/exports/api.js";
+const TableName = createAbstraction("Websockets/Sql/TableName");
+export { TableName };
+
+//# sourceMappingURL=abstractions.js.map

package/TableName/abstractions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableName/abstractions.js","sources":["../../src/TableName/abstractions.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/exports/api.js\";\n\nexport interface ITableName {\n    resolve(name: string): string;\n}\n\nexport const TableName = createAbstraction<ITableName>(\"Websockets/Sql/TableName\");\n\nexport namespace TableName {\n    export type Interface = ITableName;\n}\n"],"names":["TableName","createAbstraction"],"mappings":";AAMO,MAAMA,YAAYC,kBAA8B"}

package/WebsocketsConnectionRegistry.d.ts

@@ -0,0 +1,27 @@
+import { KnexClient } from "@webiny/api-core-sql";
+import { ConnectionRegistry } from "@webiny/api-websockets/exports/api.js";
+import { TableName } from "./TableName/abstractions.js";
+declare class WebsocketsConnectionRegistryImpl implements ConnectionRegistry.Interface {
+    private readonly knex;
+    private readonly tableName;
+    constructor(knex: KnexClient.Interface, tableName: TableName.Interface);
+    register(event: ConnectionRegistry.RegisterParams): Promise<ConnectionRegistry.Data>;
+    unregister(event: ConnectionRegistry.UnregisterParams): Promise<void>;
+    listViaConnections(connections: string[]): Promise<ConnectionRegistry.Data[]>;
+    listViaIdentity(identity: string): Promise<ConnectionRegistry.Data[]>;
+    listViaTenant(tenant: string): Promise<ConnectionRegistry.Data[]>;
+    listAll(): Promise<ConnectionRegistry.Data[]>;
+    updateLastSeen(connectionId: string): Promise<void>;
+    listStale(olderThan: Date): Promise<ConnectionRegistry.Data[]>;
+    private prepareTable;
+    private ensureTable;
+    private createTable;
+    private migrateTable;
+    private migrateLastSeen;
+    private migrateOwner;
+    private toData;
+}
+export declare const WebsocketsConnectionRegistry: typeof WebsocketsConnectionRegistryImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("@webiny/api-websockets/features/ConnectionRegistry/abstractions").IWebsocketsConnectionRegistry>;
+};
+export {};

package/WebsocketsConnectionRegistry.js

@@ -0,0 +1,235 @@
+import { WebinyError } from "@webiny/error";
+import { KnexClient } from "@webiny/api-core-sql";
+import { ConnectionRegistry } from "@webiny/api-websockets/exports/api.js";
+import { TableName } from "./TableName/abstractions.js";
+import { toIsoString } from "./toIsoString.js";
+const BASE_TABLE_NAME = "WebsocketsConnections";
+const applyOnce = async (isDone, change)=>{
+    const done = await isDone();
+    if (done) return;
+    try {
+        await change();
+    } catch (error) {
+        const doneByAnotherCall = await isDone();
+        if (doneByAnotherCall) return;
+        throw error;
+    }
+};
+class WebsocketsConnectionRegistryImpl {
+    constructor(knex, tableName){
+        this.knex = knex;
+        this.tableName = tableName.resolve(BASE_TABLE_NAME);
+    }
+    async register(event) {
+        try {
+            await this.prepareTable();
+            const row = {
+                connectionId: event.connectionId,
+                identityId: event.identity.id,
+                identityDisplayName: event.identity.displayName,
+                identityType: event.identity.type,
+                tenant: event.tenant,
+                endpoint: event.endpoint,
+                connectedOn: event.connectedOn,
+                lastSeen: new Date().toISOString(),
+                owner: event.owner ?? null
+            };
+            await this.knex.client(this.tableName).insert(row);
+            return this.toData(row);
+        } catch (err) {
+            throw WebinyError.from(err, {
+                message: "Could not register websockets connection.",
+                code: "REGISTER_CONNECTION_ERROR",
+                data: {
+                    event
+                }
+            });
+        }
+    }
+    async unregister(event) {
+        try {
+            await this.prepareTable();
+            const existing = await this.knex.client(this.tableName).where("connectionId", event.connectionId).first();
+            if (!existing) throw new WebinyError(`Connection "${event.connectionId}" does not exist.`, "CONNECTION_NOT_FOUND", {
+                connectionId: event.connectionId
+            });
+            await this.knex.client(this.tableName).where("connectionId", event.connectionId).delete();
+        } catch (err) {
+            throw WebinyError.from(err, {
+                message: "Could not unregister websockets connection.",
+                code: "UNREGISTER_CONNECTION_ERROR",
+                data: {
+                    event
+                }
+            });
+        }
+    }
+    async listViaConnections(connections) {
+        try {
+            await this.prepareTable();
+            const rows = await this.knex.client(this.tableName).whereIn("connectionId", connections);
+            return rows.map((row)=>this.toData(row));
+        } catch (err) {
+            throw WebinyError.from(err, {
+                message: "Could not list websockets connections by connection IDs.",
+                code: "LIST_VIA_CONNECTIONS_ERROR",
+                data: {
+                    connections
+                }
+            });
+        }
+    }
+    async listViaIdentity(identity) {
+        try {
+            await this.prepareTable();
+            const rows = await this.knex.client(this.tableName).where("identityId", identity);
+            return rows.map((row)=>this.toData(row));
+        } catch (err) {
+            throw WebinyError.from(err, {
+                message: "Could not list websockets connections by identity.",
+                code: "LIST_VIA_IDENTITY_ERROR",
+                data: {
+                    identity
+                }
+            });
+        }
+    }
+    async listViaTenant(tenant) {
+        try {
+            await this.prepareTable();
+            const rows = await this.knex.client(this.tableName).where("tenant", tenant);
+            return rows.map((row)=>this.toData(row));
+        } catch (err) {
+            throw WebinyError.from(err, {
+                message: "Could not list websockets connections by tenant.",
+                code: "LIST_VIA_TENANT_ERROR",
+                data: {
+                    tenant
+                }
+            });
+        }
+    }
+    async listAll() {
+        try {
+            await this.prepareTable();
+            const rows = await this.knex.client(this.tableName).select("*");
+            return rows.map((row)=>this.toData(row));
+        } catch (err) {
+            throw WebinyError.from(err, {
+                message: "Could not list all websockets connections.",
+                code: "LIST_ALL_CONNECTIONS_ERROR"
+            });
+        }
+    }
+    async updateLastSeen(connectionId) {
+        try {
+            await this.prepareTable();
+            await this.knex.client(this.tableName).where("connectionId", connectionId).update({
+                lastSeen: new Date().toISOString()
+            });
+        } catch (err) {
+            throw WebinyError.from(err, {
+                message: "Could not update lastSeen for websockets connection.",
+                code: "UPDATE_LAST_SEEN_ERROR",
+                data: {
+                    connectionId
+                }
+            });
+        }
+    }
+    async listStale(olderThan) {
+        try {
+            await this.prepareTable();
+            const threshold = olderThan.toISOString();
+            const rows = await this.knex.client(this.tableName).where((qb)=>{
+                qb.where("lastSeen", "<", threshold).orWhereNull("lastSeen");
+            });
+            return rows.map((row)=>this.toData(row));
+        } catch (err) {
+            throw WebinyError.from(err, {
+                message: "Could not list stale websockets connections.",
+                code: "LIST_STALE_CONNECTIONS_ERROR",
+                data: {
+                    olderThan
+                }
+            });
+        }
+    }
+    async prepareTable() {
+        await this.ensureTable();
+        await this.migrateTable();
+        await this.migrateLastSeen();
+        await this.migrateOwner();
+    }
+    async ensureTable() {
+        await applyOnce(()=>this.knex.client.schema.hasTable(this.tableName), ()=>this.createTable());
+    }
+    async createTable() {
+        await this.knex.client.schema.createTable(this.tableName, (table)=>{
+            table.text("connectionId").notNullable().primary();
+            table.text("identityId").notNullable();
+            table.text("identityDisplayName").notNullable();
+            table.text("identityType").notNullable();
+            table.text("tenant").notNullable();
+            table.text("endpoint").notNullable();
+            table.datetime("connectedOn").notNullable();
+            table.datetime("lastSeen").nullable();
+            table.text("owner").nullable();
+            table.index([
+                "identityId"
+            ]);
+            table.index([
+                "tenant"
+            ]);
+        });
+    }
+    async migrateTable() {
+        const hasEndpoint = await this.knex.client.schema.hasColumn(this.tableName, "endpoint");
+        if (hasEndpoint) return;
+        await this.knex.client.schema.alterTable(this.tableName, (table)=>{
+            table.text("endpoint").nullable();
+        });
+        await this.knex.client(this.tableName).update({
+            endpoint: this.knex.client.raw("'https://' || \"domainName\" || '/' || \"stage\"")
+        });
+        await this.knex.client.schema.alterTable(this.tableName, (table)=>{
+            table.text("endpoint").notNullable().alter();
+            table.dropColumn("domainName");
+            table.dropColumn("stage");
+        });
+    }
+    async migrateLastSeen() {
+        await applyOnce(()=>this.knex.client.schema.hasColumn(this.tableName, "lastSeen"), ()=>this.knex.client.schema.alterTable(this.tableName, (table)=>{
+                table.datetime("lastSeen").nullable();
+            }));
+    }
+    async migrateOwner() {
+        await applyOnce(()=>this.knex.client.schema.hasColumn(this.tableName, "owner"), ()=>this.knex.client.schema.alterTable(this.tableName, (table)=>{
+                table.text("owner").nullable();
+            }));
+    }
+    toData(row) {
+        return {
+            connectionId: row.connectionId,
+            identity: {
+                id: row.identityId,
+                displayName: row.identityDisplayName,
+                type: row.identityType
+            },
+            tenant: row.tenant,
+            endpoint: row.endpoint,
+            connectedOn: toIsoString(row.connectedOn),
+            owner: row.owner ?? void 0
+        };
+    }
+}
+const WebsocketsConnectionRegistry = ConnectionRegistry.createImplementation({
+    implementation: WebsocketsConnectionRegistryImpl,
+    dependencies: [
+        KnexClient,
+        TableName
+    ]
+});
+export { WebsocketsConnectionRegistry };
+
+//# sourceMappingURL=WebsocketsConnectionRegistry.js.map

package/WebsocketsConnectionRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebsocketsConnectionRegistry.js","sources":["../src/WebsocketsConnectionRegistry.ts"],"sourcesContent":["import { WebinyError } from \"@webiny/error\";\nimport { KnexClient } from \"@webiny/api-core-sql\";\nimport { ConnectionRegistry } from \"@webiny/api-websockets/exports/api.js\";\nimport { TableName } from \"~/TableName/abstractions.js\";\nimport { toIsoString } from \"~/toIsoString.js\";\n\ninterface ConnectionRow {\n    connectionId: string;\n    identityId: string;\n    identityDisplayName: string;\n    identityType: string;\n    tenant: string;\n    endpoint: string;\n    connectedOn: string;\n    lastSeen: string | null;\n    owner: string | null;\n}\n\nconst BASE_TABLE_NAME = \"WebsocketsConnections\";\n\n/*\n * Runs `change` unless `isDone` already holds. After an upgrade every browser reconnects at once, so\n * several calls, in one process or in several, can find the same table or column missing; all but\n * the first then fail because it exists by now. A failure after which `isDone` holds was one of\n * those and is not an error.\n */\nconst applyOnce = async (\n    isDone: () => Promise<boolean>,\n    change: () => Promise<unknown>\n): Promise<void> => {\n    const done = await isDone();\n    if (done) {\n        return;\n    }\n    try {\n        await change();\n    } catch (error) {\n        const doneByAnotherCall = await isDone();\n        if (doneByAnotherCall) {\n            return;\n        }\n        throw error;\n    }\n};\n\nclass WebsocketsConnectionRegistryImpl implements ConnectionRegistry.Interface {\n    private readonly knex;\n    private readonly tableName;\n\n    public constructor(knex: KnexClient.Interface, tableName: TableName.Interface) {\n        this.knex = knex;\n        this.tableName = tableName.resolve(BASE_TABLE_NAME);\n    }\n\n    public async register(\n        event: ConnectionRegistry.RegisterParams\n    ): Promise<ConnectionRegistry.Data> {\n        try {\n            await this.prepareTable();\n\n            const row: ConnectionRow = {\n                connectionId: event.connectionId,\n                identityId: event.identity.id,\n                identityDisplayName: event.identity.displayName,\n                identityType: event.identity.type,\n                tenant: event.tenant,\n                endpoint: event.endpoint,\n                connectedOn: event.connectedOn,\n                lastSeen: new Date().toISOString(),\n                owner: event.owner ?? null\n            };\n\n            await this.knex.client<ConnectionRow>(this.tableName).insert(row);\n\n            return this.toData(row);\n        } catch (err) {\n            throw WebinyError.from(err, {\n                message: \"Could not register websockets connection.\",\n                code: \"REGISTER_CONNECTION_ERROR\",\n                data: { event }\n            });\n        }\n    }\n\n    public async unregister(event: ConnectionRegistry.UnregisterParams): Promise<void> {\n        try {\n            await this.prepareTable();\n\n            const existing = await this.knex\n                .client<ConnectionRow>(this.tableName)\n                .where(\"connectionId\", event.connectionId)\n                .first();\n\n            if (!existing) {\n                throw new WebinyError(\n                    `Connection \"${event.connectionId}\" does not exist.`,\n                    \"CONNECTION_NOT_FOUND\",\n                    { connectionId: event.connectionId }\n                );\n            }\n\n            await this.knex\n                .client<ConnectionRow>(this.tableName)\n                .where(\"connectionId\", event.connectionId)\n                .delete();\n        } catch (err) {\n            throw WebinyError.from(err, {\n                message: \"Could not unregister websockets connection.\",\n                code: \"UNREGISTER_CONNECTION_ERROR\",\n                data: { event }\n            });\n        }\n    }\n\n    public async listViaConnections(connections: string[]): Promise<ConnectionRegistry.Data[]> {\n        try {\n            await this.prepareTable();\n\n            const rows = await this.knex\n                .client<ConnectionRow>(this.tableName)\n                .whereIn(\"connectionId\", connections);\n\n            return rows.map(row => this.toData(row));\n        } catch (err) {\n            throw WebinyError.from(err, {\n                message: \"Could not list websockets connections by connection IDs.\",\n                code: \"LIST_VIA_CONNECTIONS_ERROR\",\n                data: { connections }\n            });\n        }\n    }\n\n    public async listViaIdentity(identity: string): Promise<ConnectionRegistry.Data[]> {\n        try {\n            await this.prepareTable();\n\n            const rows = await this.knex\n                .client<ConnectionRow>(this.tableName)\n                .where(\"identityId\", identity);\n\n            return rows.map(row => this.toData(row));\n        } catch (err) {\n            throw WebinyError.from(err, {\n                message: \"Could not list websockets connections by identity.\",\n                code: \"LIST_VIA_IDENTITY_ERROR\",\n                data: { identity }\n            });\n        }\n    }\n\n    public async listViaTenant(tenant: string): Promise<ConnectionRegistry.Data[]> {\n        try {\n            await this.prepareTable();\n\n            const rows = await this.knex\n                .client<ConnectionRow>(this.tableName)\n                .where(\"tenant\", tenant);\n\n            return rows.map(row => this.toData(row));\n        } catch (err) {\n            throw WebinyError.from(err, {\n                message: \"Could not list websockets connections by tenant.\",\n                code: \"LIST_VIA_TENANT_ERROR\",\n                data: { tenant }\n            });\n        }\n    }\n\n    public async listAll(): Promise<ConnectionRegistry.Data[]> {\n        try {\n            await this.prepareTable();\n\n            const rows = await this.knex.client<ConnectionRow>(this.tableName).select(\"*\");\n\n            return rows.map(row => this.toData(row));\n        } catch (err) {\n            throw WebinyError.from(err, {\n                message: \"Could not list all websockets connections.\",\n                code: \"LIST_ALL_CONNECTIONS_ERROR\"\n            });\n        }\n    }\n\n    public async updateLastSeen(connectionId: string): Promise<void> {\n        try {\n            await this.prepareTable();\n\n            await this.knex\n                .client<ConnectionRow>(this.tableName)\n                .where(\"connectionId\", connectionId)\n                .update({ lastSeen: new Date().toISOString() });\n        } catch (err) {\n            throw WebinyError.from(err, {\n                message: \"Could not update lastSeen for websockets connection.\",\n                code: \"UPDATE_LAST_SEEN_ERROR\",\n                data: { connectionId }\n            });\n        }\n    }\n\n    public async listStale(olderThan: Date): Promise<ConnectionRegistry.Data[]> {\n        try {\n            await this.prepareTable();\n\n            const threshold = olderThan.toISOString();\n\n            const rows = await this.knex.client<ConnectionRow>(this.tableName).where(qb => {\n                qb.where(\"lastSeen\", \"<\", threshold).orWhereNull(\"lastSeen\");\n            });\n\n            return rows.map(row => this.toData(row));\n        } catch (err) {\n            throw WebinyError.from(err, {\n                message: \"Could not list stale websockets connections.\",\n                code: \"LIST_STALE_CONNECTIONS_ERROR\",\n                data: { olderThan }\n            });\n        }\n    }\n\n    private async prepareTable(): Promise<void> {\n        await this.ensureTable();\n        await this.migrateTable();\n        await this.migrateLastSeen();\n        await this.migrateOwner();\n    }\n\n    /*\n     * `schema` is read fresh in each call below: it is a new builder on every read, and one builder\n     * reused would run the statements queued on it before.\n     */\n    private async ensureTable(): Promise<void> {\n        await applyOnce(\n            () => this.knex.client.schema.hasTable(this.tableName),\n            () => this.createTable()\n        );\n    }\n\n    private async createTable(): Promise<void> {\n        await this.knex.client.schema.createTable(this.tableName, table => {\n            table.text(\"connectionId\").notNullable().primary();\n            table.text(\"identityId\").notNullable();\n            table.text(\"identityDisplayName\").notNullable();\n            table.text(\"identityType\").notNullable();\n            table.text(\"tenant\").notNullable();\n            table.text(\"endpoint\").notNullable();\n            table.datetime(\"connectedOn\").notNullable();\n            table.datetime(\"lastSeen\").nullable();\n            table.text(\"owner\").nullable();\n            table.index([\"identityId\"]);\n            table.index([\"tenant\"]);\n        });\n    }\n\n    private async migrateTable(): Promise<void> {\n        const hasEndpoint = await this.knex.client.schema.hasColumn(this.tableName, \"endpoint\");\n        if (hasEndpoint) {\n            return;\n        }\n\n        await this.knex.client.schema.alterTable(this.tableName, table => {\n            table.text(\"endpoint\").nullable();\n        });\n\n        await this.knex.client(this.tableName).update({\n            endpoint: this.knex.client.raw(\"'https://' || \\\"domainName\\\" || '/' || \\\"stage\\\"\")\n        });\n\n        await this.knex.client.schema.alterTable(this.tableName, table => {\n            table.text(\"endpoint\").notNullable().alter();\n            table.dropColumn(\"domainName\");\n            table.dropColumn(\"stage\");\n        });\n    }\n\n    private async migrateLastSeen(): Promise<void> {\n        await applyOnce(\n            () => this.knex.client.schema.hasColumn(this.tableName, \"lastSeen\"),\n            () => {\n                return this.knex.client.schema.alterTable(this.tableName, table => {\n                    table.datetime(\"lastSeen\").nullable();\n                });\n            }\n        );\n    }\n\n    private async migrateOwner(): Promise<void> {\n        await applyOnce(\n            () => this.knex.client.schema.hasColumn(this.tableName, \"owner\"),\n            () => {\n                return this.knex.client.schema.alterTable(this.tableName, table => {\n                    table.text(\"owner\").nullable();\n                });\n            }\n        );\n    }\n\n    private toData(row: ConnectionRow): ConnectionRegistry.Data {\n        return {\n            connectionId: row.connectionId,\n            identity: {\n                id: row.identityId,\n                displayName: row.identityDisplayName,\n                type: row.identityType\n            },\n            tenant: row.tenant,\n            endpoint: row.endpoint,\n            connectedOn: toIsoString(row.connectedOn),\n            owner: row.owner ?? undefined\n        };\n    }\n}\n\nexport const WebsocketsConnectionRegistry = ConnectionRegistry.createImplementation({\n    implementation: WebsocketsConnectionRegistryImpl,\n    dependencies: [KnexClient, TableName]\n});\n"],"names":["BASE_TABLE_NAME","applyOnce","isDone","change","done","error","doneByAnotherCall","WebsocketsConnectionRegistryImpl","knex","tableName","event","row","Date","err","WebinyError","existing","connections","rows","identity","tenant","connectionId","olderThan","threshold","qb","table","hasEndpoint","toIsoString","undefined","WebsocketsConnectionRegistry","ConnectionRegistry","KnexClient","TableName"],"mappings":"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"}

package/WebsocketsSqlFeature.d.ts

@@ -0,0 +1,8 @@
+import { type Container } from "@webiny/feature/api";
+export interface WebsocketsSqlConfig {
+    tableNamePrefix?: string;
+}
+export declare const WebsocketsSqlFeature: {
+    name: string;
+    register(container: Container, context?: WebsocketsSqlConfig | undefined): void;
+};

package/WebsocketsSqlFeature.js

@@ -0,0 +1,14 @@
+import { createFeature } from "@webiny/feature/api";
+import { TableName } from "./TableName/abstractions.js";
+import { TableName as TableName_js_TableName } from "./TableName/TableName.js";
+import { WebsocketsConnectionRegistry } from "./WebsocketsConnectionRegistry.js";
+const WebsocketsSqlFeature = createFeature({
+    name: "WebsocketsSql",
+    register (container, config) {
+        container.registerInstance(TableName, new TableName_js_TableName(config?.tableNamePrefix));
+        container.register(WebsocketsConnectionRegistry);
+    }
+});
+export { WebsocketsSqlFeature };
+
+//# sourceMappingURL=WebsocketsSqlFeature.js.map

package/WebsocketsSqlFeature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebsocketsSqlFeature.js","sources":["../src/WebsocketsSqlFeature.ts"],"sourcesContent":["import { type Container, createFeature } from \"@webiny/feature/api\";\nimport { TableName as TableNameAbstraction } from \"~/TableName/abstractions.js\";\nimport { TableName } from \"~/TableName/TableName.js\";\nimport { WebsocketsConnectionRegistry } from \"./WebsocketsConnectionRegistry.js\";\n\nexport interface WebsocketsSqlConfig {\n    tableNamePrefix?: string;\n}\n\nexport const WebsocketsSqlFeature = createFeature<WebsocketsSqlConfig | undefined>({\n    name: \"WebsocketsSql\",\n    register(container: Container, config?) {\n        container.registerInstance(TableNameAbstraction, new TableName(config?.tableNamePrefix));\n        container.register(WebsocketsConnectionRegistry);\n    }\n});\n"],"names":["WebsocketsSqlFeature","createFeature","container","config","TableNameAbstraction","TableName","WebsocketsConnectionRegistry"],"mappings":";;;;AASO,MAAMA,uBAAuBC,cAA+C;IAC/E,MAAM;IACN,UAASC,SAAoB,EAAEC,MAAO;QAClCD,UAAU,gBAAgB,CAACE,WAAsB,IAAIC,uBAAUF,QAAQ;QACvED,UAAU,QAAQ,CAACI;IACvB;AACJ"}

package/index.d.ts

@@ -0,0 +1,3 @@
+export { WebsocketsConnectionRegistry } from "./WebsocketsConnectionRegistry.js";
+export { WebsocketsSqlFeature } from "./WebsocketsSqlFeature.js";
+export type { WebsocketsSqlConfig } from "./WebsocketsSqlFeature.js";

package/index.js

@@ -0,0 +1,2 @@
+export { WebsocketsConnectionRegistry } from "./WebsocketsConnectionRegistry.js";
+export { WebsocketsSqlFeature } from "./WebsocketsSqlFeature.js";

package/package.json

@@ -0,0 +1,44 @@
+{
+	"name": "@webiny/api-websockets-sql",
+	"version": "0.0.0-unstable.0156a4c312",
+	"type": "module",
+	"keywords": [
+		"@webiny/api-websockets",
+		"storage-operations",
+		"sql",
+		"sau:sql"
+	],
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/webiny/webiny-js.git"
+	},
+	"description": "SQL storage operations for @webiny/api-websockets.",
+	"author": "Webiny Ltd.",
+	"license": "MIT",
+	"exports": {
+		".": "./index.js",
+		"./*": "./*"
+	},
+	"dependencies": {
+		"@webiny/api-core-sql": "0.0.0-unstable.0156a4c312",
+		"@webiny/api-websockets": "0.0.0-unstable.0156a4c312",
+		"@webiny/error": "0.0.0-unstable.0156a4c312",
+		"@webiny/feature": "0.0.0-unstable.0156a4c312",
+		"knex": "3.3.0"
+	},
+	"devDependencies": {
+		"@webiny/api-core": "0.0.0-unstable.0156a4c312",
+		"@webiny/build-tools": "0.0.0-unstable.0156a4c312",
+		"@webiny/di": "2.0.0",
+		"better-sqlite3": "13.0.3",
+		"rimraf": "6.1.3",
+		"typescript": "7.0.2",
+		"vitest": "5.0.5"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"webiny": {
+		"publishFrom": "dist"
+	}
+}

package/toIsoString.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Normalize a timestamp read out of a `datetime` column to a UTC ISO string.
+ *
+ * We always write ISO strings, but the column's read shape is the driver's decision: node-postgres
+ * and mysql2 parse it into a `Date`, better-sqlite3 hands back the text it was given, and some
+ * configurations return "2026-08-04 17:02:06" with no `T` and no zone. That wall-clock is UTC,
+ * because that is how it was written, so the space form is read back as UTC.
+ *
+ * Taking `unknown` keeps the variance out of the row type, so the rest of the registry can treat a
+ * timestamp as the `string` it is declared to be. Anything unparseable throws rather than being
+ * stringified: these values are compared against a cutoff to decide which connections are still
+ * live, and a quietly malformed one drops a user's connections with no error to show for it.
+ */
+export declare const toIsoString: (value: unknown) => string;

package/toIsoString.js

@@ -0,0 +1,15 @@
+import { WebinyError } from "@webiny/error";
+const toIsoString = (value)=>{
+    if (value instanceof Date) return value.toISOString();
+    if ("string" == typeof value) {
+        const normalized = value.includes(" ") && !value.includes("T") ? `${value.replace(" ", "T")}Z` : value;
+        const parsed = new Date(normalized);
+        if (!Number.isNaN(parsed.getTime())) return parsed.toISOString();
+    }
+    throw new WebinyError("Could not read a websockets connection timestamp.", "INVALID_CONNECTION_TIMESTAMP", {
+        value
+    });
+};
+export { toIsoString };
+
+//# sourceMappingURL=toIsoString.js.map

package/toIsoString.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toIsoString.js","sources":["../src/toIsoString.ts"],"sourcesContent":["import { WebinyError } from \"@webiny/error\";\n\n/**\n * Normalize a timestamp read out of a `datetime` column to a UTC ISO string.\n *\n * We always write ISO strings, but the column's read shape is the driver's decision: node-postgres\n * and mysql2 parse it into a `Date`, better-sqlite3 hands back the text it was given, and some\n * configurations return \"2026-08-04 17:02:06\" with no `T` and no zone. That wall-clock is UTC,\n * because that is how it was written, so the space form is read back as UTC.\n *\n * Taking `unknown` keeps the variance out of the row type, so the rest of the registry can treat a\n * timestamp as the `string` it is declared to be. Anything unparseable throws rather than being\n * stringified: these values are compared against a cutoff to decide which connections are still\n * live, and a quietly malformed one drops a user's connections with no error to show for it.\n */\nexport const toIsoString = (value: unknown): string => {\n    if (value instanceof Date) {\n        return value.toISOString();\n    }\n\n    if (typeof value === \"string\") {\n        const normalized =\n            value.includes(\" \") && !value.includes(\"T\") ? `${value.replace(\" \", \"T\")}Z` : value;\n\n        const parsed = new Date(normalized);\n        if (!Number.isNaN(parsed.getTime())) {\n            return parsed.toISOString();\n        }\n    }\n\n    throw new WebinyError(\n        \"Could not read a websockets connection timestamp.\",\n        \"INVALID_CONNECTION_TIMESTAMP\",\n        { value }\n    );\n};\n"],"names":["toIsoString","value","Date","normalized","parsed","Number","WebinyError"],"mappings":";AAeO,MAAMA,cAAc,CAACC;IACxB,IAAIA,iBAAiBC,MACjB,OAAOD,MAAM,WAAW;IAG5B,IAAI,AAAiB,YAAjB,OAAOA,OAAoB;QAC3B,MAAME,aACFF,MAAM,QAAQ,CAAC,QAAQ,CAACA,MAAM,QAAQ,CAAC,OAAO,GAAGA,MAAM,OAAO,CAAC,KAAK,KAAK,CAAC,CAAC,GAAGA;QAElF,MAAMG,SAAS,IAAIF,KAAKC;QACxB,IAAI,CAACE,OAAO,KAAK,CAACD,OAAO,OAAO,KAC5B,OAAOA,OAAO,WAAW;IAEjC;IAEA,MAAM,IAAIE,YACN,qDACA,gCACA;QAAEL;IAAM;AAEhB"}