@multiplayer-app/sandbox 0.0.11 → 0.0.14

package/dist/lib/notebooks/notebook-sql-schema.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listNotebookSqlTables = listNotebookSqlTables;
+exports.getNotebookSqlTableSchema = getNotebookSqlTableSchema;
+const notebook_sql_client_1 = require("./notebook-sql-client");
+const LIST_COLUMNS_SQL = `
+SELECT
+  c.table_schema,
+  c.table_name,
+  c.column_name,
+  c.data_type,
+  c.is_nullable,
+  c.column_default,
+  c.ordinal_position
+FROM information_schema.columns c
+INNER JOIN information_schema.tables t
+  ON t.table_schema = c.table_schema
+  AND t.table_name = c.table_name
+WHERE c.table_schema = 'public'
+  AND t.table_type = 'BASE TABLE'
+ORDER BY c.table_name, c.ordinal_position
+`;
+const LIST_PRIMARY_KEYS_SQL = `
+SELECT
+  tc.table_schema,
+  tc.table_name,
+  kcu.column_name
+FROM information_schema.table_constraints tc
+INNER JOIN information_schema.key_column_usage kcu
+  ON tc.constraint_name = kcu.constraint_name
+  AND tc.table_schema = kcu.table_schema
+  AND tc.table_name = kcu.table_name
+WHERE tc.constraint_type = 'PRIMARY KEY'
+  AND tc.table_schema = 'public'
+`;
+function buildPrimaryKeySet(rows) {
+    return new Set(rows.map(row => `${row.table_schema}.${row.table_name}.${row.column_name}`));
+}
+function groupColumnsByTable(columnRows, primaryKeys) {
+    const tables = new Map();
+    for (const row of columnRows) {
+        const key = `${row.table_schema}.${row.table_name}`;
+        let table = tables.get(key);
+        if (!table) {
+            table = {
+                schema: row.table_schema,
+                name: row.table_name,
+                columns: [],
+            };
+            tables.set(key, table);
+        }
+        table.columns.push({
+            name: row.column_name,
+            dataType: row.data_type,
+            isNullable: row.is_nullable === 'YES',
+            defaultValue: row.column_default,
+            isPrimaryKey: primaryKeys.has(`${row.table_schema}.${row.table_name}.${row.column_name}`),
+            ordinalPosition: row.ordinal_position,
+        });
+    }
+    return Array.from(tables.values());
+}
+async function listNotebookSqlTables() {
+    return (0, notebook_sql_client_1.withNotebookSqlClient)(async (client) => {
+        const [columnsResult, primaryKeysResult] = await Promise.all([
+            client.query(LIST_COLUMNS_SQL),
+            client.query(LIST_PRIMARY_KEYS_SQL),
+        ]);
+        return groupColumnsByTable(columnsResult.rows, buildPrimaryKeySet(primaryKeysResult.rows));
+    });
+}
+async function getNotebookSqlTableSchema(tableName) {
+    const trimmed = tableName.trim();
+    if (!trimmed) {
+        throw new Error('Table name is required');
+    }
+    return (0, notebook_sql_client_1.withNotebookSqlClient)(async (client) => {
+        var _a;
+        const columnsResult = await client.query(`
+      SELECT
+        c.table_schema,
+        c.table_name,
+        c.column_name,
+        c.data_type,
+        c.is_nullable,
+        c.column_default,
+        c.ordinal_position
+      FROM information_schema.columns c
+      INNER JOIN information_schema.tables t
+        ON t.table_schema = c.table_schema
+        AND t.table_name = c.table_name
+      WHERE c.table_schema = 'public'
+        AND t.table_type = 'BASE TABLE'
+        AND c.table_name = $1
+      ORDER BY c.ordinal_position
+      `, [trimmed]);
+        if (columnsResult.rows.length === 0) {
+            return null;
+        }
+        const primaryKeysResult = await client.query(`
+      SELECT
+        tc.table_schema,
+        tc.table_name,
+        kcu.column_name
+      FROM information_schema.table_constraints tc
+      INNER JOIN information_schema.key_column_usage kcu
+        ON tc.constraint_name = kcu.constraint_name
+        AND tc.table_schema = kcu.table_schema
+        AND tc.table_name = kcu.table_name
+      WHERE tc.constraint_type = 'PRIMARY KEY'
+        AND tc.table_schema = 'public'
+        AND tc.table_name = $1
+      `, [trimmed]);
+        return (_a = groupColumnsByTable(columnsResult.rows, buildPrimaryKeySet(primaryKeysResult.rows))[0]) !== null && _a !== void 0 ? _a : null;
+    });
+}
+//# sourceMappingURL=notebook-sql-schema.js.map

package/dist/lib/notebooks/notebook-sql-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notebook-sql-schema.js","sourceRoot":"","sources":["../../../src/lib/notebooks/notebook-sql-schema.ts"],"names":[],"mappings":"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"}

package/dist/lib/notebooks/notebook-sql.d.ts

@@ -0,0 +1,9 @@
+export interface SqlQueryResult {
+    columns: string[];
+    rows: Record<string, unknown>[];
+    rowCount: number;
+    durationMs: number;
+}
+export declare function executeNotebookSqlQuery(query: string): Promise<SqlQueryResult>;
+export { closeNotebookSqlPool } from './notebook-sql-client';
+//# sourceMappingURL=notebook-sql.d.ts.map

package/dist/lib/notebooks/notebook-sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notebook-sql.d.ts","sourceRoot":"","sources":["../../../src/lib/notebooks/notebook-sql.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB;AAYD,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAsBpF;AAED,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/lib/notebooks/notebook-sql.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.closeNotebookSqlPool = void 0;
+exports.executeNotebookSqlQuery = executeNotebookSqlQuery;
+const notebook_sql_client_1 = require("./notebook-sql-client");
+function rowsToResult(rows, rowCount, durationMs) {
+    const columns = rows.length > 0 ? Object.keys(rows[0]) : [];
+    return {
+        columns,
+        rows,
+        rowCount,
+        durationMs,
+    };
+}
+async function executeNotebookSqlQuery(query) {
+    const trimmed = query.trim();
+    if (!trimmed) {
+        throw new Error('Query is empty');
+    }
+    const start = performance.now();
+    try {
+        return await (0, notebook_sql_client_1.withNotebookSqlClient)(async (client) => {
+            var _a;
+            const result = await client.query(trimmed);
+            const durationMs = Math.round(performance.now() - start);
+            return rowsToResult(result.rows, (_a = result.rowCount) !== null && _a !== void 0 ? _a : result.rows.length, durationMs);
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(message);
+    }
+}
+var notebook_sql_client_2 = require("./notebook-sql-client");
+Object.defineProperty(exports, "closeNotebookSqlPool", { enumerable: true, get: function () { return notebook_sql_client_2.closeNotebookSqlPool; } });
+//# sourceMappingURL=notebook-sql.js.map

package/dist/lib/notebooks/notebook-sql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notebook-sql.js","sourceRoot":"","sources":["../../../src/lib/notebooks/notebook-sql.ts"],"names":[],"mappings":";;;AAmBA,0DAsBC;AAzCD,+DAA6D;AAS7D,SAAS,YAAY,CAAC,IAA+B,EAAE,QAAgB,EAAE,UAAkB;IACzF,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC3D,OAAO;QACL,OAAO;QACP,IAAI;QACJ,QAAQ;QACR,UAAU;KACX,CAAA;AACH,CAAC;AAEM,KAAK,UAAU,uBAAuB,CAAC,KAAa;IACzD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAA;IACnC,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;IAE/B,IAAI,CAAC;QACH,OAAO,MAAM,IAAA,2CAAqB,EAAC,KAAK,EAAC,MAAM,EAAC,EAAE;;YAChD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAA;YACxD,OAAO,YAAY,CACjB,MAAM,CAAC,IAAiC,EACxC,MAAA,MAAM,CAAC,QAAQ,mCAAI,MAAM,CAAC,IAAI,CAAC,MAAM,EACrC,UAAU,CACX,CAAA;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACtE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAA;IAC1B,CAAC;AACH,CAAC;AAED,6DAA4D;AAAnD,2HAAA,oBAAoB,OAAA"}

package/dist/lib/sql-schema.d.ts

@@ -0,0 +1,23 @@
+export interface SqlTableColumn {
+    name: string;
+    dataType: string;
+    isNullable: boolean;
+    defaultValue: string | null;
+    isPrimaryKey: boolean;
+    ordinalPosition: number;
+}
+export interface SqlTableSchema {
+    schema: string;
+    name: string;
+    columns: SqlTableColumn[];
+}
+export interface SqlSchemaProvider {
+    listTables(): Promise<SqlTableSchema[]>;
+}
+export interface SqlQueryResult {
+    columns: string[];
+    rows: Record<string, unknown>[];
+    rowCount: number;
+    durationMs: number;
+}
+//# sourceMappingURL=sql-schema.d.ts.map

package/dist/lib/sql-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-schema.d.ts","sourceRoot":"","sources":["../../src/lib/sql-schema.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,YAAY,EAAE,OAAO,CAAA;IACrB,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,cAAc,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;CACxC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB"}

package/dist/lib/sql-schema.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=sql-schema.js.map

package/dist/lib/sql-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-schema.js","sourceRoot":"","sources":["../../src/lib/sql-schema.ts"],"names":[],"mappings":""}

package/dist/realtime/init-realtime.d.ts

@@ -1,11 +1,11 @@
 import type { Server as HttpServer } from 'node:http';
 import { type RedisClientType } from 'redis';
-import { type RealtimeServer } from '@multiplayer-app/realtime-server';
+import { type Middleware, type RealtimeServer } from '@multiplayer-app/realtime-server';
 import type { BuilderApiConfig } from '../builder-api-config';
 export interface RealtimeServices {
     realtimeServer: RealtimeServer;
     redisClient: RedisClientType;
     close: () => Promise<void>;
 }
-export declare function initRealtime(httpServer: HttpServer, config: BuilderApiConfig, redisUrl?: string): Promise<RealtimeServices | null>;
+export declare function initRealtime(httpServer: HttpServer, config: BuilderApiConfig, redisUrl?: string, socketAuth?: Middleware): Promise<RealtimeServices | null>;
 //# sourceMappingURL=init-realtime.d.ts.map

package/dist/realtime/init-realtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-realtime.d.ts","sourceRoot":"","sources":["../../src/realtime/init-realtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,OAAO,CAAA;AAC1D,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,kCAAkC,CAAA;AAE5F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAM7D,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,cAAc,CAAA;IAC9B,WAAW,EAAE,eAAe,CAAA;IAC5B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B;AAQD,wBAAsB,YAAY,CAChC,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,gBAAgB,EACxB,QAAQ,SAAoD,GAC3D,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAoClC"}
+{"version":3,"file":"init-realtime.d.ts","sourceRoot":"","sources":["../../src/realtime/init-realtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,OAAO,CAAA;AAC1D,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,kCAAkC,CAAA;AAEzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAK7D,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,cAAc,CAAA;IAC9B,WAAW,EAAE,eAAe,CAAA;IAC5B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B;AAQD,wBAAsB,YAAY,CAChC,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,gBAAgB,EACxB,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAwDlC"}

package/dist/realtime/init-realtime.js

@@ -5,8 +5,7 @@ const redis_1 = require("redis");
 const realtime_server_1 = require("@multiplayer-app/realtime-server");
 const logger_1 = require("../logger");
 const session_artifact_y_socket_io_1 = require("./session-artifact-y-socket-io");
-const YJS_NAMESPACE = '/yjs';
-const REALTIME_NAMESPACE = '/';
+const ACCOUNT_NAMESPACE = /^\/[^/]+$/;
 function resolveCorsOrigin(corsOrigin) {
     if (corsOrigin === true)
         return '*';
@@ -14,31 +13,51 @@ function resolveCorsOrigin(corsOrigin) {
         return corsOrigin.join(',');
     return String(corsOrigin);
 }
-async function initRealtime(httpServer, config, redisUrl) {
-    var _a;
-    if (redisUrl === void 0) { redisUrl = (_a = process.env.REDIS_URL) !== null && _a !== void 0 ? _a : 'redis://127.0.0.1:6379'; }
+async function initRealtime(httpServer, config, redisUrl, socketAuth) {
+    const resolvedUrl = redisUrl !== null && redisUrl !== void 0 ? redisUrl : process.env.REDIS_URL;
+    if (!resolvedUrl) {
+        (0, logger_1.getBuilderApiLogger)().warn('REDIS_URL not set — collaborative file editing disabled.');
+        return null;
+    }
     let redisClient;
     try {
-        redisClient = (0, redis_1.createClient)({ url: redisUrl });
+        redisClient = (0, redis_1.createClient)({ url: resolvedUrl });
         await redisClient.connect();
     }
     catch (error) {
-        (0, logger_1.getBuilderApiLogger)().warn({ err: error, redisUrl }, 'Redis unavailable — collaborative file editing disabled. Start redis or set REDIS_URL.');
+        (0, logger_1.getBuilderApiLogger)().warn({ err: error, redisUrl: resolvedUrl }, 'Redis unavailable — collaborative file editing disabled. Start redis or set REDIS_URL.');
         return null;
     }
     const realtimeServer = await (0, realtime_server_1.createRealtimeServer)({
         httpServer,
         corsOrigin: resolveCorsOrigin(config.corsOrigin),
-        namespace: REALTIME_NAMESPACE,
+        namespace: ACCOUNT_NAMESPACE,
         pubClient: redisClient,
         subClient: redisClient.duplicate(),
         path: config.realtimeSocketPath,
-        authMiddleware: config.realtimeAuthMiddleware,
+        authMiddleware: socketAuth,
+        getUserInfo: config.getUserInfo,
+    });
+    realtimeServer.namespace.use(async (socket, next) => {
+        var _a;
+        try {
+            const namespaceAccountId = socket.nsp.name.slice(1).trim();
+            const requestAccountId = String((_a = socket.request.accountId) !== null && _a !== void 0 ? _a : '').trim();
+            if (!namespaceAccountId || !requestAccountId || namespaceAccountId !== requestAccountId) {
+                return next(new realtime_server_1.SocketIOError('Invalid account namespace', 403));
+            }
+            socket.data.allowEdit = true;
+            next();
+        }
+        catch (err) {
+            if (err instanceof realtime_server_1.SocketIOError) {
+                return next(err);
+            }
+            return next(new realtime_server_1.SocketIOError('Cannot init user data', 500));
+        }
     });
-    const yjsNamespace = realtimeServer.io.of(YJS_NAMESPACE);
-    const yjsServer = new session_artifact_y_socket_io_1.SessionArtifactYSocketIO(yjsNamespace);
+    const yjsServer = new session_artifact_y_socket_io_1.SessionArtifactYSocketIO(realtimeServer.namespace);
     yjsServer.initialize();
-    (0, logger_1.getBuilderApiLogger)().info({ yjsNamespace: YJS_NAMESPACE }, 'Realtime Yjs server initialized');
     return {
         realtimeServer,
         redisClient,

package/dist/realtime/init-realtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"init-realtime.js","sourceRoot":"","sources":["../../src/realtime/init-realtime.ts"],"names":[],"mappings":";;AAsBA,oCAwCC;AA7DD,iCAA0D;AAC1D,sEAA4F;AAC5F,sCAA+C;AAE/C,iFAAyE;AAEzE,MAAM,aAAa,GAAG,MAAM,CAAA;AAC5B,MAAM,kBAAkB,GAAG,GAAG,CAAA;AAQ9B,SAAS,iBAAiB,CAAC,UAA0C;IACnE,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,GAAG,CAAA;IACnC,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC1D,OAAO,MAAM,CAAC,UAAU,CAAC,CAAA;AAC3B,CAAC;AAEM,KAAK,UAAU,YAAY,CAChC,UAAsB,EACtB,MAAwB,EACxB,QAA4D;;6BAA5D,EAAA,iBAAW,OAAO,CAAC,GAAG,CAAC,SAAS,mCAAI,wBAAwB;IAE5D,IAAI,WAA4B,CAAA;IAChC,IAAI,CAAC;QACH,WAAW,GAAG,IAAA,oBAAY,EAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAoB,CAAA;QAChE,MAAM,WAAW,CAAC,OAAO,EAAE,CAAA;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAA,4BAAmB,GAAE,CAAC,IAAI,CACxB,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,EACxB,wFAAwF,CACzF,CAAA;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,IAAA,sCAAoB,EAAC;QAChD,UAAU;QACV,UAAU,EAAE,iBAAiB,CAAC,MAAM,CAAC,UAAU,CAAC;QAChD,SAAS,EAAE,kBAAkB;QAC7B,SAAS,EAAE,WAAW;QACtB,SAAS,EAAE,WAAW,CAAC,SAAS,EAAE;QAClC,IAAI,EAAE,MAAM,CAAC,kBAAkB;QAC/B,cAAc,EAAE,MAAM,CAAC,sBAAsB;KAC9C,CAAC,CAAA;IAEF,MAAM,YAAY,GAAG,cAAc,CAAC,EAAE,CAAC,EAAE,CAAC,aAAa,CAAC,CAAA;IACxD,MAAM,SAAS,GAAG,IAAI,uDAAwB,CAAC,YAAY,CAAC,CAAA;IAC5D,SAAS,CAAC,UAAU,EAAE,CAAA;IAEtB,IAAA,4BAAmB,GAAE,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,aAAa,EAAE,EAAE,iCAAiC,CAAC,CAAA;IAE9F,OAAO;QACL,cAAc;QACd,WAAW;QACX,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QACxE,CAAC;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"init-realtime.js","sourceRoot":"","sources":["../../src/realtime/init-realtime.ts"],"names":[],"mappings":"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"}

package/dist/realtime/notebook-document-id.d.ts

@@ -0,0 +1,6 @@
+export declare function buildNotebookDocumentId(accountId: string, notebookId: string): string;
+export declare function parseNotebookDocumentId(documentIdentifier: string): {
+    accountId: string;
+    notebookId: string;
+} | null;
+//# sourceMappingURL=notebook-document-id.d.ts.map

package/dist/realtime/notebook-document-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notebook-document-id.d.ts","sourceRoot":"","sources":["../../src/realtime/notebook-document-id.ts"],"names":[],"mappings":"AAEA,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAOrF;AAED,wBAAgB,uBAAuB,CACrC,kBAAkB,EAAE,MAAM,GACzB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkBlD"}

package/dist/realtime/notebook-document-id.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildNotebookDocumentId = buildNotebookDocumentId;
+exports.parseNotebookDocumentId = parseNotebookDocumentId;
+const NOTEBOOK_DOCUMENT_ID_PREFIX = 'notebook:';
+function buildNotebookDocumentId(accountId, notebookId) {
+    const normalizedAccountId = accountId.trim();
+    const normalizedNotebookId = notebookId.trim();
+    if (!normalizedAccountId || !normalizedNotebookId) {
+        throw new Error('Invalid notebook document id parts');
+    }
+    return `${NOTEBOOK_DOCUMENT_ID_PREFIX}${normalizedAccountId}:${normalizedNotebookId}`;
+}
+function parseNotebookDocumentId(documentIdentifier) {
+    if (!documentIdentifier.startsWith(NOTEBOOK_DOCUMENT_ID_PREFIX)) {
+        return null;
+    }
+    const rest = documentIdentifier.slice(NOTEBOOK_DOCUMENT_ID_PREFIX.length);
+    const separator = rest.indexOf(':');
+    if (separator <= 0) {
+        return null;
+    }
+    const accountId = rest.slice(0, separator).trim();
+    const notebookId = rest.slice(separator + 1).trim();
+    if (!accountId || !notebookId) {
+        return null;
+    }
+    return { accountId, notebookId };
+}
+//# sourceMappingURL=notebook-document-id.js.map

package/dist/realtime/notebook-document-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notebook-document-id.js","sourceRoot":"","sources":["../../src/realtime/notebook-document-id.ts"],"names":[],"mappings":";;AAEA,0DAOC;AAED,0DAoBC;AA/BD,MAAM,2BAA2B,GAAG,WAAW,CAAA;AAE/C,SAAgB,uBAAuB,CAAC,SAAiB,EAAE,UAAkB;IAC3E,MAAM,mBAAmB,GAAG,SAAS,CAAC,IAAI,EAAE,CAAA;IAC5C,MAAM,oBAAoB,GAAG,UAAU,CAAC,IAAI,EAAE,CAAA;IAC9C,IAAI,CAAC,mBAAmB,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;IACvD,CAAC;IACD,OAAO,GAAG,2BAA2B,GAAG,mBAAmB,IAAI,oBAAoB,EAAE,CAAA;AACvF,CAAC;AAED,SAAgB,uBAAuB,CACrC,kBAA0B;IAE1B,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,2BAA2B,CAAC,EAAE,CAAC;QAChE,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,CAAC,2BAA2B,CAAC,MAAM,CAAC,CAAA;IACzE,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACnC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACnB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE,CAAA;IACjD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IACnD,IAAI,CAAC,SAAS,IAAI,CAAC,UAAU,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,CAAA;AAClC,CAAC"}

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

@@ -0,0 +1,12 @@
+import type { AuthenticatedPresentUser } from '@multiplayer-app/realtime-types';
+import type { Middleware } from '@multiplayer-app/realtime-server';
+export type RealtimeDocumentAuthHandler = (request: unknown) => Promise<{
+    name: string;
+    id: string;
+    color: string;
+}>;
+export declare function toRealtimeAuthMiddleware(handler: RealtimeDocumentAuthHandler): Middleware;
+export declare function getSocketPresentUser(socket: {
+    request: unknown;
+}): AuthenticatedPresentUser | null;
+//# sourceMappingURL=realtime-auth.d.ts.map

package/dist/realtime/realtime-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-auth.d.ts","sourceRoot":"","sources":["../../src/realtime/realtime-auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAA;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAA;AAElE,MAAM,MAAM,2BAA2B,GAAG,CACxC,OAAO,EAAE,OAAO,KACb,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAQzD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,2BAA2B,GAAG,UAAU,CAazF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,wBAAwB,GAAG,IAAI,CAGlG"}

package/dist/realtime/realtime-auth.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toRealtimeAuthMiddleware = toRealtimeAuthMiddleware;
+exports.getSocketPresentUser = getSocketPresentUser;
+function toRealtimeAuthMiddleware(handler) {
+    return async (request, _response, next) => {
+        try {
+            const presentUser = await handler(request);
+            const req = request;
+            req.presentUser = presentUser;
+            req.userId = presentUser.id;
+            next();
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            next(err);
+        }
+    };
+}
+function getSocketPresentUser(socket) {
+    var _a;
+    const req = socket.request;
+    return (_a = req.presentUser) !== null && _a !== void 0 ? _a : null;
+}
+//# sourceMappingURL=realtime-auth.js.map

package/dist/realtime/realtime-auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-auth.js","sourceRoot":"","sources":["../../src/realtime/realtime-auth.ts"],"names":[],"mappings":";;AAaA,4DAaC;AAED,oDAGC;AAlBD,SAAgB,wBAAwB,CAAC,OAAoC;IAC3E,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE;QACxC,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;YAC1C,MAAM,GAAG,GAAG,OAAsB,CAAA;YAClC,GAAG,CAAC,WAAW,GAAG,WAAW,CAAA;YAC7B,GAAG,CAAC,MAAM,GAAG,WAAW,CAAC,EAAE,CAAA;YAC3B,IAAI,EAAE,CAAA;QACR,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;YACrE,IAAI,CAAC,GAAG,CAAC,CAAA;QACX,CAAC;IACH,CAAC,CAAA;AACH,CAAC;AAED,SAAgB,oBAAoB,CAAC,MAA4B;;IAC/D,MAAM,GAAG,GAAG,MAAM,CAAC,OAAsB,CAAA;IACzC,OAAO,MAAA,GAAG,CAAC,WAAW,mCAAI,IAAI,CAAA;AAChC,CAAC"}

package/dist/realtime/session-artifact-y-socket-io.d.ts

@@ -1,18 +1,11 @@
-import { GenericYSocketIO, type GenericYjsSocketData } from '@multiplayer-app/realtime-server';
-interface PersistedUpdateRow {
-    _id: {
-        toString(): string;
-    };
-    update?: Buffer | Uint8Array;
-}
+import { PersistedYSocketIO, type GenericYSocketConnection } from '@multiplayer-app/realtime-server';
 /**
  * Yjs relay for session artifact files. Loads initial state from disk and persists edits back.
  */
-export declare class SessionArtifactYSocketIO extends GenericYSocketIO {
+export declare class SessionArtifactYSocketIO extends PersistedYSocketIO {
     private readonly store;
+    constructor(namespace: GenericYSocketConnection);
     initialize(): void;
-    protected getNonCommittedUpdates(_socketData: GenericYjsSocketData, documentIdentifier: string): Promise<PersistedUpdateRow[] | undefined>;
-    protected storeUpdate(_data: GenericYjsSocketData, update: Uint8Array, documentIdentifier: string): Promise<void>;
+    private relayDocCache;
 }
-export {};
 //# sourceMappingURL=session-artifact-y-socket-io.d.ts.map

package/dist/realtime/session-artifact-y-socket-io.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-artifact-y-socket-io.d.ts","sourceRoot":"","sources":["../../src/realtime/session-artifact-y-socket-io.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAEhB,KAAK,oBAAoB,EAC1B,MAAM,kCAAkC,CAAA;AAKzC,UAAU,kBAAkB;IAC1B,GAAG,EAAE;QAAE,QAAQ,IAAI,MAAM,CAAA;KAAE,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAAA;CAC7B;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,gBAAgB;IAC5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IAErD,UAAU,IAAI,IAAI;cAiBO,sBAAsB,CAC7C,WAAW,EAAE,oBAAoB,EACjC,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,kBAAkB,EAAE,GAAG,SAAS,CAAC;cAoBnB,WAAW,CAClC,KAAK,EAAE,oBAAoB,EAC3B,MAAM,EAAE,UAAU,EAClB,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,IAAI,CAAC;CAejB"}
+{"version":3,"file":"session-artifact-y-socket-io.d.ts","sourceRoot":"","sources":["../../src/realtime/session-artifact-y-socket-io.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAElB,KAAK,wBAAwB,EAE9B,MAAM,kCAAkC,CAAA;AAOzC;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,kBAAkB;IAC9D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;gBAEzC,SAAS,EAAE,wBAAwB;IA6BtC,UAAU,IAAI,IAAI;IAoB3B,OAAO,CAAC,aAAa;CAGtB"}

package/dist/realtime/session-artifact-y-socket-io.js

@@ -41,9 +41,32 @@ const session_artifact_yjs_store_1 = require("./session-artifact-yjs-store");
 /**
  * Yjs relay for session artifact files. Loads initial state from disk and persists edits back.
  */
-class SessionArtifactYSocketIO extends realtime_server_1.GenericYSocketIO {
-    constructor() {
-        super(...arguments);
+class SessionArtifactYSocketIO extends realtime_server_1.PersistedYSocketIO {
+    constructor(namespace) {
+        const store = (0, session_artifact_yjs_store_1.getSessionArtifactYjsStore)();
+        const storageAdapter = {
+            async getDocumentStateRecord(documentIdentifier) {
+                var _a;
+                const persisted = await store.getPersistedStateRecord(documentIdentifier);
+                if ((_a = persisted === null || persisted === void 0 ? void 0 : persisted.state) === null || _a === void 0 ? void 0 : _a.byteLength) {
+                    return persisted;
+                }
+                // Artifact may exist as UTF-8 on disk without a `.yjs` state file yet.
+                const doc = await store.getOrLoadDoc(documentIdentifier);
+                if (!doc) {
+                    return undefined;
+                }
+                const state = Y.encodeStateAsUpdate(doc);
+                if (!state.byteLength) {
+                    return undefined;
+                }
+                return { id: { toString: () => documentIdentifier }, state };
+            },
+            async saveDocumentState(documentIdentifier, state) {
+                await store.persistBinaryState(documentIdentifier, state);
+            },
+        };
+        super(namespace, storageAdapter);
         this.store = (0, session_artifact_yjs_store_1.getSessionArtifactYjsStore)();
     }
     initialize() {
@@ -51,6 +74,8 @@ class SessionArtifactYSocketIO extends realtime_server_1.GenericYSocketIO {
             if (!update.byteLength || !(0, realtime_server_1.isValidYjsUpdate)(update)) {
                 return;
             }
+            // Agent/tooling writes go through SessionArtifactYjsStore; drop stale relay cache.
+            this.relayDocCache().delete(documentIdentifier);
             this.io
                 .to(this.getDocumentRoom(documentIdentifier))
                 .emit(realtime_types_1.YjsEvents.SYNC_UPDATE, {
@@ -60,35 +85,8 @@ class SessionArtifactYSocketIO extends realtime_server_1.GenericYSocketIO {
         });
         super.initialize();
     }
-    async getNonCommittedUpdates(_socketData, documentIdentifier) {
-        const doc = await this.store.getOrLoadDoc(documentIdentifier);
-        if (!doc) {
-            return undefined;
-        }
-        const state = Y.encodeStateAsUpdate(doc);
-        if (!state.byteLength) {
-            return undefined;
-        }
-        return [
-            {
-                _id: { toString: () => documentIdentifier },
-                update: Buffer.from(state),
-            },
-        ];
-    }
-    async storeUpdate(_data, update, documentIdentifier) {
-        const doc = await this.store.getOrLoadDoc(documentIdentifier);
-        if (!doc) {
-            return;
-        }
-        try {
-            Y.applyUpdate(doc, update);
-        }
-        catch (error) {
-            console.warn(`Ignoring invalid Yjs update for ${documentIdentifier}:`, error);
-            return;
-        }
-        this.store.schedulePersist(documentIdentifier, doc);
+    relayDocCache() {
+        return this.docCache;
     }
 }
 exports.SessionArtifactYSocketIO = SessionArtifactYSocketIO;

package/dist/realtime/session-artifact-y-socket-io.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-artifact-y-socket-io.js","sourceRoot":"","sources":["../../src/realtime/session-artifact-y-socket-io.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,sEAIyC;AACzC,oEAAoF;AACpF,uCAAwB;AACxB,6EAAyE;AAOzE;;GAEG;AACH,MAAa,wBAAyB,SAAQ,kCAAgB;IAA9D;;QACmB,UAAK,GAAG,IAAA,uDAA0B,GAAE,CAAA;IA6DvD,CAAC;IA3DC,UAAU;QACR,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,kBAAkB,EAAE,MAAM,EAAE,EAAE;YAC1D,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,IAAA,kCAAgB,EAAC,MAAM,CAAC,EAAE,CAAC;gBACpD,OAAM;YACR,CAAC;YAED,IAAI,CAAC,EAAE;iBACJ,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC;iBAC5C,IAAI,CAAC,0BAAS,CAAC,WAAW,EAAE;gBAC3B,kBAAkB;gBAClB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;aAC5B,CAAC,CAAA;QACN,CAAC,CAAC,CAAA;QAEF,KAAK,CAAC,UAAU,EAAE,CAAA;IACpB,CAAC;IAEkB,KAAK,CAAC,sBAAsB,CAC7C,WAAiC,EACjC,kBAA0B;QAG1B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAA;QAC7D,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,SAAS,CAAA;QAClB,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAA;QACxC,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;YACtB,OAAO,SAAS,CAAA;QAClB,CAAC;QAED,OAAO;YACL;gBACE,GAAG,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,kBAAkB,EAAE;gBAC3C,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;aAC3B;SACF,CAAA;IACH,CAAC;IAEkB,KAAK,CAAC,WAAW,CAClC,KAA2B,EAC3B,MAAkB,EAClB,kBAA0B;QAE1B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAA;QAC7D,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAM;QACR,CAAC;QAED,IAAI,CAAC;YACH,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,mCAAmC,kBAAkB,GAAG,EAAE,KAAK,CAAC,CAAA;YAC7E,OAAM;QACR,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAA;IACrD,CAAC;CACF;AA9DD,4DA8DC"}
+{"version":3,"file":"session-artifact-y-socket-io.js","sourceRoot":"","sources":["../../src/realtime/session-artifact-y-socket-io.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,sEAKyC;AACzC,oEAA2D;AAC3D,uCAAwB;AACxB,6EAAyE;AAIzE;;GAEG;AACH,MAAa,wBAAyB,SAAQ,oCAAkB;IAG9D,YAAY,SAAmC;QAC7C,MAAM,KAAK,GAAG,IAAA,uDAA0B,GAAE,CAAA;QAC1C,MAAM,cAAc,GAA+B;YACjD,KAAK,CAAC,sBAAsB,CAAC,kBAA0B;;gBACrD,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,uBAAuB,CAAC,kBAAkB,CAAC,CAAA;gBACzE,IAAI,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,KAAK,0CAAE,UAAU,EAAE,CAAC;oBACjC,OAAO,SAAS,CAAA;gBAClB,CAAC;gBAED,uEAAuE;gBACvE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAA;gBACxD,IAAI,CAAC,GAAG,EAAE,CAAC;oBACT,OAAO,SAAS,CAAA;gBAClB,CAAC;gBAED,MAAM,KAAK,GAAG,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAA;gBACxC,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;oBACtB,OAAO,SAAS,CAAA;gBAClB,CAAC;gBAED,OAAO,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,CAAA;YAC9D,CAAC;YACD,KAAK,CAAC,iBAAiB,CAAC,kBAA0B,EAAE,KAAiB;gBACnE,MAAM,KAAK,CAAC,kBAAkB,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAA;YAC3D,CAAC;SACF,CAAA;QACD,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC,CAAA;QA5BjB,UAAK,GAAG,IAAA,uDAA0B,GAAE,CAAA;IA6BrD,CAAC;IAEQ,UAAU;QACjB,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,kBAAkB,EAAE,MAAM,EAAE,EAAE;YAC1D,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,IAAA,kCAAgB,EAAC,MAAM,CAAC,EAAE,CAAC;gBACpD,OAAM;YACR,CAAC;YAED,mFAAmF;YACnF,IAAI,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAA;YAE/C,IAAI,CAAC,EAAE;iBACJ,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC;iBAC5C,IAAI,CAAC,0BAAS,CAAC,WAAW,EAAE;gBAC3B,kBAAkB;gBAClB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;aAC5B,CAAC,CAAA;QACN,CAAC,CAAC,CAAA;QAEF,KAAK,CAAC,UAAU,EAAE,CAAA;IACpB,CAAC;IAEO,aAAa;QACnB,OAAQ,IAA+C,CAAC,QAAQ,CAAA;IAClE,CAAC;CACF;AAvDD,4DAuDC"}

package/dist/realtime/session-artifact-yjs-store.d.ts

@@ -29,10 +29,19 @@ export declare class SessionArtifactYjsStore {
     evictDocument(sessionId: string, artifactPath: string): void;
     resetFromFileContent(sessionId: string, artifactPath: string): Promise<void>;
     schedulePersist(documentIdentifier: string, doc: Y.Doc): void;
+    getPersistedStateRecord(documentIdentifier: string): Promise<{
+        id: {
+            toString(): string;
+        };
+        state?: Uint8Array;
+    } | undefined>;
+    persistBinaryState(documentIdentifier: string, state: Uint8Array): Promise<void>;
     private persistToDisk;
     private scheduleNamedSnapshot;
     private clearPersistTimer;
     private clearTimers;
+    private parseDocumentTarget;
+    private getNotebookRepository;
 }
 export declare function getSessionArtifactYjsStore(): SessionArtifactYjsStore;
 export {};

package/dist/realtime/session-artifact-yjs-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-artifact-yjs-store.d.ts","sourceRoot":"","sources":["../../src/realtime/session-artifact-yjs-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAoBxB,KAAK,eAAe,GAAG,CAAC,kBAAkB,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,IAAI,CAAA;AAM/E,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAmD;IACjF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmD;IAClF,OAAO,CAAC,eAAe,CAA+B;IAEtD,iBAAiB,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI;IAItC,YAAY,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC;IAiBrE,8FAA8F;YAChF,yBAAyB;IAmBjC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW7E;;;OAGG;IACG,qBAAqB,CACzB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAAC;IAqCvE;;;OAGG;IACG,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;KAAE,CAAC;IAyB7B,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAYtD,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlF,eAAe,CAAC,kBAAkB,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,IAAI;YAe/C,aAAa;IAe3B,OAAO,CAAC,qBAAqB;IA0B7B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,WAAW;CASpB;AAID,wBAAgB,0BAA0B,IAAI,uBAAuB,CAKpE"}
+{"version":3,"file":"session-artifact-yjs-store.d.ts","sourceRoot":"","sources":["../../src/realtime/session-artifact-yjs-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAsBxB,KAAK,eAAe,GAAG,CAAC,kBAAkB,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,IAAI,CAAA;AAS/E,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAmD;IACjF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmD;IAClF,OAAO,CAAC,eAAe,CAA+B;IAEtD,iBAAiB,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI;IAItC,YAAY,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC;IAwBrE,8FAA8F;YAChF,yBAAyB;IAiCjC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW7E;;;OAGG;IACG,qBAAqB,CACzB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAAC;IAqCvE;;;OAGG;IACG,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;KAAE,CAAC;IAyB7B,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAYtD,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlF,eAAe,CAAC,kBAAkB,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,IAAI;IAevD,uBAAuB,CAC3B,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC;QAAE,EAAE,EAAE;YAAE,QAAQ,IAAI,MAAM,CAAA;SAAE,CAAC;QAAC,KAAK,CAAC,EAAE,UAAU,CAAA;KAAE,GAAG,SAAS,CAAC;IAqBpE,kBAAkB,CAAC,kBAAkB,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;YAwBxE,aAAa;IAuB3B,OAAO,CAAC,qBAAqB;IA0B7B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,mBAAmB;IAsB3B,OAAO,CAAC,qBAAqB;CAO9B;AAID,wBAAgB,0BAA0B,IAAI,uBAAuB,CAKpE"}