@maudecode/talaria-web 1.18.0 → 1.20.0

package/dist/sessions/storage/json-documents.js

@@ -0,0 +1,277 @@
+/* eslint-disable @typescript-eslint/require-await -- Each JSON transaction completes synchronously before its promise resolves. */
+import { normalizeDraftVersion } from '../drafts.js';
+import { createHash } from 'node:crypto';
+import { chmodSync, closeSync, fstatSync, mkdirSync, openSync, readdirSync, readFileSync, renameSync, unlinkSync } from 'node:fs';
+import { dirname, join, relative } from 'node:path';
+import { writeAtomic } from './json-files.js';
+import { atomicWriteText, atomicWriteTextAsync } from '../../fs/atomic.js';
+import { fileStatKey } from '../../fs/stat.js';
+import { InvalidDocument, RevisionConflict } from './backend.js';
+const formats = {
+    drafts: { directory: 'sessions/_drafts' },
+    shares: { directory: 'shares', indent: 2, secret: true },
+    'held-wakeups': { files: { held: 'sessions/_wakeup_held.json' } },
+    projects: { files: { projects: 'projects.json' }, indent: 2 },
+    settings: { files: { settings: 'settings.json' }, indent: 2 },
+    auth: { files: { sessions: '.sessions.json', 'login-attempts': '.login_attempts.json', 'pbkdf2-key': '.pbkdf2_key', 'signing-key': '.signing_key' }, secret: true },
+    passkeys: { files: { passkeys: 'passkeys.json', '.passkey_challenges': '.passkey_challenges.json' }, indent: 2, sorted: true, secret: true },
+    'update-notifications': { files: { 'update-notifications': 'update-notifications.json' }, secret: true },
+    profiles: { files: { deleted: 'deleted-profiles.json' } },
+    extensions: { files: { overrides: 'extension-overrides.json', 'install-manifest': 'extension-install-manifest.json' }, indent: 2 },
+    background: { directory: 'sessions/_background' },
+    catalog: { files: { 'quota-scope': '.quota_scope_id' }, text: true },
+    'relay-keys': { text: true, secret: true },
+    'relay-identities': { text: true, secret: true },
+    recovery: { files: { 'stamping-since': 'recovery_stamping_since' }, text: true },
+};
+const sortedReplacer = (_key, value) => value && typeof value === 'object' && !Array.isArray(value)
+    ? Object.fromEntries(Object.keys(value).sort().map((key) => [key, value[key]])) : value;
+const documentWrites = new Map();
+export class JsonDocuments {
+    stateDir;
+    profileHome;
+    sessionDirectory;
+    closed = false;
+    constructor(stateDir, profileHome = (profile) => profile === 'default' ? stateDir : join(stateDir, 'profiles', profile), sessionDirectory = join(stateDir, 'sessions')) {
+        this.stateDir = stateDir;
+        this.profileHome = profileHome;
+        this.sessionDirectory = sessionDirectory;
+    }
+    pending = new Set();
+    cache = new Map();
+    serialize(path, operation) {
+        const result = (documentWrites.get(path) ?? Promise.resolve()).catch(() => undefined).then(operation);
+        const settled = result.then(() => { }, () => { });
+        documentWrites.set(path, settled);
+        this.pending.add(result);
+        void settled.then(() => { this.pending.delete(result); if (documentWrites.get(path) === settled)
+            documentWrites.delete(path); });
+        return result;
+    }
+    async close() {
+        while (this.pending.size)
+            await Promise.allSettled([...this.pending]);
+        this.closed = true;
+        this.cache.clear();
+    }
+    format(namespace, key) {
+        if (this.closed)
+            throw new Error('Storage is closed');
+        if (namespace === 'workspaces')
+            return key?.endsWith('.last') ? { text: true } : { indent: 2 };
+        if (namespace === 'relay')
+            return key === 'revision' ? { text: true } : { files: { config: 'talaria-relay.json', started: 'talaria-relay-started.json', deleted: 'talaria-relay-deleted.json' }, ...(key === 'config' ? { indent: 2 } : {}), newline: true, secret: key === 'deleted' };
+        const format = Object.hasOwn(formats, namespace) ? formats[namespace] : undefined;
+        if (!format)
+            throw new Error(`Unknown document namespace ${namespace}`);
+        return format;
+    }
+    path(namespace, key) {
+        const format = this.format(namespace, key);
+        if ((!Object.hasOwn(format.files ?? {}, key) && !/^[A-Za-z0-9_-][A-Za-z0-9_.-]*$/.test(key)) || key === '.' || key === '..')
+            throw new Error('Unsafe document key');
+        if (namespace === 'drafts' || namespace === 'background')
+            return join(this.sessionDirectory, namespace === 'drafts' ? '_drafts' : '_background', `${key}.json`);
+        if (namespace === 'held-wakeups' && key === 'held')
+            return join(this.sessionDirectory, '_wakeup_held.json');
+        if (namespace === 'workspaces') {
+            const match = /^([a-z0-9][a-z0-9_-]{0,63})\.(registry|last)$/.exec(key);
+            if (!match)
+                throw new Error('Unsafe workspace document key');
+            const directory = match[1] === 'default' ? this.stateDir : join(this.profileHome(match[1]), 'webui_state');
+            return join(directory, match[2] === 'registry' ? 'workspaces.json' : 'last_workspace.txt');
+        }
+        if (namespace === 'relay-identities') {
+            if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(key))
+                throw new Error('Unsafe profile identity key');
+            return join(this.profileHome(key), '.talaria-relay-profile-id');
+        }
+        if (namespace === 'relay-keys') {
+            if (!/^[a-f0-9]{16}$/.test(key))
+                throw new Error('Unsafe relay key');
+            return join(this.stateDir, `talaria-relay-publisher-${key}.pem`);
+        }
+        if (namespace === 'relay' && (key === 'revision' || key === 'started')) {
+            let directory = this.stateDir;
+            try {
+                const config = JSON.parse(readFileSync(join(this.stateDir, 'talaria-relay.json'), 'utf8'));
+                if (typeof config.private_key_path === 'string' && config.private_key_path)
+                    directory = dirname(config.private_key_path);
+            }
+            catch { /* unconfigured */ }
+            return join(directory, key === 'revision' ? 'talaria-relay-revision' : 'talaria-relay-started.json');
+        }
+        const path = format.files?.[key] ?? (format.directory ? `${format.directory}/${key}.json` : null);
+        if (!path)
+            throw new Error(`Unknown document key ${namespace}/${key}`);
+        return join(this.stateDir, path);
+    }
+    remember(namespace, path, text, signature) {
+        const entry = { text, signature, revision: createHash('sha256').update(text).digest('hex') };
+        if (namespace === 'drafts') {
+            try {
+                const value = JSON.parse(text);
+                entry.parsed = { value };
+                const version = normalizeDraftVersion(value?._draft_version);
+                if (version !== null)
+                    entry.revision = version;
+            }
+            catch { /* hash malformed bytes */ }
+        }
+        this.cache.delete(path);
+        this.cache.set(path, entry);
+        if (this.cache.size > 256)
+            this.cache.delete(this.cache.keys().next().value);
+        return entry;
+    }
+    raw(namespace, key) {
+        const path = this.path(namespace, key);
+        try {
+            const signature = fileStatKey(path);
+            const hit = this.cache.get(path);
+            if (hit?.signature === signature) {
+                this.cache.delete(path);
+                this.cache.set(path, hit);
+                return hit;
+            }
+            // Bind bytes to the pre-read identity, never to a replacement arriving during the read.
+            const text = readFileSync(path, namespace === 'auth' && key.endsWith('-key') ? 'latin1' : 'utf8');
+            return this.remember(namespace, path, text, signature);
+        }
+        catch (error) {
+            this.cache.delete(path);
+            if (error.code === 'ENOENT')
+                return null;
+            throw error;
+        }
+    }
+    async get(namespace, key, opts = {}) {
+        const raw = this.raw(namespace, key);
+        if (!raw)
+            return null;
+        if (opts.maxBytes !== undefined && Buffer.byteLength(raw.text) > opts.maxBytes)
+            throw new InvalidDocument(raw.revision, new Error('Document byte limit exceeded'), 'too-large');
+        try {
+            raw.parsed ??= { value: namespace === 'auth' && key.endsWith('-key') ? Buffer.from(raw.text, 'latin1').toString('base64') : this.format(namespace, key).text ? raw.text : JSON.parse(raw.text) };
+            const value = structuredClone(raw.parsed.value);
+            if (namespace === 'relay' && key === 'config' && value && typeof value === 'object') {
+                const config = value;
+                if (typeof config.private_key_path === 'string') {
+                    const name = relative(this.stateDir, config.private_key_path);
+                    const match = /^talaria-relay-publisher-([a-f0-9]{16})\.pem$/.exec(name);
+                    if (match)
+                        config.private_key_document = match[1];
+                }
+            }
+            return { value, revision: raw.revision };
+        }
+        catch (error) {
+            throw new InvalidDocument(raw.revision, error);
+        }
+    }
+    async put(namespace, key, value, expected) {
+        const path = this.path(namespace, key);
+        if ((this.raw(namespace, key)?.revision ?? null) !== expected)
+            throw new RevisionConflict(`${namespace}/${key}`);
+        const format = this.format(namespace, key);
+        if (namespace === 'relay' && key === 'config' && value && typeof value === 'object') {
+            const config = { ...value };
+            if (typeof config.private_key_document === 'string')
+                config.private_key_path = this.path('relay-keys', config.private_key_document);
+            delete config.private_key_document;
+            value = config;
+        }
+        const serialized = format.text ? String(value) : JSON.stringify(value, format.sorted ? sortedReplacer : undefined, format.indent);
+        if (serialized === undefined)
+            throw new Error('Document must be serializable');
+        const text = serialized + (format.newline ? '\n' : '');
+        const binary = namespace === 'auth' && key.endsWith('-key') ? Buffer.from(String(value), 'base64') : null;
+        const storedText = binary ? binary.toString('latin1') : text;
+        let revision;
+        const publish = (staged, target) => {
+            // Hold the written inode across rename; a later path lookup could describe an external replacement.
+            const fd = openSync(staged, 'r');
+            try {
+                const before = fstatSync(fd, { bigint: true });
+                renameSync(staged, target);
+                if (format.secret && format.sorted) {
+                    try {
+                        chmodSync(target, 0o600);
+                    }
+                    catch { /* legacy best effort */ }
+                }
+                const after = fstatSync(fd, { bigint: true });
+                // An in-place edit during publication must also miss the next cache lookup.
+                const identity = before.mtimeNs === after.mtimeNs && before.size === after.size ? after : before;
+                revision = this.remember(namespace, path, storedText, fileStatKey(path, identity)).revision;
+            }
+            finally {
+                closeSync(fd);
+            }
+        };
+        if (namespace !== 'relay-identities')
+            mkdirSync(dirname(path), { recursive: true });
+        if (binary)
+            writeAtomic(path, binary, 0o600, publish);
+        else if (namespace === 'auth') {
+            return this.serialize(path, async () => {
+                // Stage and fsync off the event loop; compare and publish together without another asynchronous gap.
+                const assertCurrent = () => { if ((this.raw(namespace, key)?.revision ?? null) !== expected)
+                    throw new RevisionConflict(`${namespace}/${key}`); };
+                assertCurrent();
+                await atomicWriteTextAsync(path, text, { mode: 0o600, commit: (staged, target) => {
+                        assertCurrent();
+                        publish(staged, target);
+                    } });
+                return revision;
+            });
+        }
+        else
+            atomicWriteText(path, text, { ...(format.secret ? { mode: 0o600 } : {}), commit: publish });
+        return revision;
+    }
+    async delete(namespace, key, expected) {
+        const path = this.path(namespace, key);
+        return this.serialize(path, () => {
+            const current = this.raw(namespace, key);
+            if (expected !== undefined && (current?.revision ?? null) !== expected)
+                throw new RevisionConflict(`${namespace}/${key}`);
+            if (!current)
+                return Promise.resolve(false);
+            unlinkSync(path);
+            this.cache.delete(path);
+            return Promise.resolve(true);
+        });
+    }
+    async list(namespace) {
+        const format = this.format(namespace);
+        let keys = Object.keys(format.files ?? {});
+        if (namespace === 'relay')
+            keys = ['config', 'deleted', 'started', 'revision'];
+        if (namespace === 'workspaces' || namespace === 'relay-identities') {
+            const profiles = ['default'];
+            try {
+                profiles.push(...readdirSync(join(this.profileHome('default'), 'profiles')).filter((name) => /^[a-z0-9][a-z0-9_-]{0,63}$/.test(name)));
+            }
+            catch { /* no named profiles */ }
+            keys = namespace === 'workspaces' ? profiles.flatMap((profile) => [`${profile}.registry`, `${profile}.last`]) : profiles;
+        }
+        if (namespace === 'relay-keys') {
+            try {
+                keys = readdirSync(this.stateDir).flatMap((name) => { const match = /^talaria-relay-publisher-([a-f0-9]{16})\.pem$/.exec(name); return match ? [match[1]] : []; });
+            }
+            catch { /* no keys */ }
+        }
+        if (format.directory) {
+            try {
+                keys = readdirSync(namespace === 'drafts' || namespace === 'background' ? join(this.sessionDirectory, namespace === 'drafts' ? '_drafts' : '_background') : join(this.stateDir, format.directory)).filter((name) => name.endsWith('.json')).map((name) => name.slice(0, -5));
+            }
+            catch (error) {
+                if (error.code !== 'ENOENT')
+                    throw error;
+            }
+        }
+        return keys.sort().flatMap((key) => { const raw = this.raw(namespace, key); return raw ? [{ key, revision: raw.revision }] : []; });
+    }
+}
+//# sourceMappingURL=json-documents.js.map

package/dist/sessions/storage/json-documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-documents.js","sourceRoot":"","sources":["../../../src/sessions/storage/json-documents.ts"],"names":[],"mappings":"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"}

package/dist/sessions/storage/json-files.d.ts

@@ -0,0 +1,23 @@
+export declare function writeAtomic(path: string, text: string | Uint8Array, mode?: number, commit?: (staged: string, target: string) => void): void;
+/** `writeAtomic`'s staging half off the event loop: the fsynced temp sibling of `path` for the caller to publish or remove. */
+export declare function stageAtomic(path: string, text: string): Promise<string>;
+export { statSignature, statSignatureAsync } from '../../fs/stat.js';
+/**
+ * The metadata prefix together with the signature of the inode it was read from (fstat of the open descriptor), so a
+ * file atomically replaced during the read is never cached under the replacement's identity.
+ */
+export declare function readMetadataJsonPrefixWithSignature(path: string, maxBytes?: number): {
+    prefix: string | null;
+    signature: string;
+};
+/**
+ * TAL-1212: the first `limit` rows of a session document's top-level `messages` array and the signature of the inode they
+ * were read from. Reads the descriptor incrementally and parses only those rows; a document the scan cannot follow (no
+ * `messages` array, a non-object row, a truncated file) falls back to one full parse of the same descriptor.
+ */
+export declare function readJsonMessagePrefix(path: string, limit: number, chunkBytes?: number): Promise<{
+    rows: unknown[];
+    signature: string;
+}>;
+/** Offset of `"key":` at JSON nesting depth 1, or null. */
+export declare function findTopLevelJsonKey(text: string, key: string): number | null;

package/dist/sessions/storage/json-files.js

@@ -0,0 +1,244 @@
+import { chmodSync, closeSync, fstatSync, fsyncSync, openSync, renameSync, unlinkSync } from 'node:fs';
+import { open } from 'node:fs/promises';
+import { StringDecoder } from 'node:string_decoder';
+import { stageFileAsync, writeFully } from '../../fs/atomic.js';
+import { signatureOf } from '../../fs/stat.js';
+let tmpCounter = 0;
+function tmpName(path) {
+    return `${path}.tmp.${process.pid}.${++tmpCounter}`;
+}
+export function writeAtomic(path, text, mode, commit) {
+    const tmp = tmpName(path);
+    const fd = openSync(tmp, 'w', mode);
+    try {
+        writeFully(fd, text);
+        fsyncSync(fd);
+        closeSync(fd);
+        if (mode !== undefined)
+            chmodSync(tmp, mode);
+        if (commit)
+            commit(tmp, path);
+        else
+            renameSync(tmp, path);
+    }
+    catch (error) {
+        try {
+            closeSync(fd);
+        }
+        catch { /* closed */ }
+        try {
+            unlinkSync(tmp);
+        }
+        catch { /* gone */ }
+        throw error;
+    }
+}
+/** `writeAtomic`'s staging half off the event loop: the fsynced temp sibling of `path` for the caller to publish or remove. */
+export async function stageAtomic(path, text) {
+    const tmp = tmpName(path);
+    await stageFileAsync(tmp, text);
+    return tmp;
+}
+export { statSignature, statSignatureAsync } from '../../fs/stat.js';
+/**
+ * The metadata prefix together with the signature of the inode it was read from (fstat of the open descriptor), so a
+ * file atomically replaced during the read is never cached under the replacement's identity.
+ */
+export function readMetadataJsonPrefixWithSignature(path, maxBytes = 1024 * 1024) {
+    const fd = openSync(path, 'r');
+    try {
+        const signature = signatureOf(path, fstatSync(fd, { bigint: true }));
+        return { prefix: readPrefixFromFd(fd, maxBytes, Math.min(64 * 1024, maxBytes)), signature };
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+function readPrefixFromFd(fd, maxBytes, initialStage) {
+    let stage = initialStage;
+    {
+        let raw = Buffer.alloc(0);
+        let text = '';
+        let stopPos = null;
+        while (raw.length < maxBytes) {
+            const chunk = Buffer.alloc(Math.min(stage, maxBytes - raw.length));
+            const n = readSyncFully(fd, chunk);
+            if (n === 0)
+                return null;
+            raw = Buffer.concat([raw, chunk.subarray(0, n)]);
+            text = raw.toString('utf8');
+            const messagesPos = findTopLevelJsonKey(text, 'messages');
+            const scenesPos = findTopLevelJsonKey(text, 'anchor_activity_scenes');
+            stopPos = messagesPos;
+            if (scenesPos !== null && (stopPos === null || scenesPos < stopPos))
+                stopPos = scenesPos;
+            if (stopPos !== null)
+                break;
+            stage *= 2;
+        }
+        if (stopPos === null)
+            return null;
+        let prefix = text.slice(0, stopPos).trimEnd();
+        if (prefix.endsWith(','))
+            prefix = prefix.slice(0, -1).trimEnd();
+        return `${prefix}\n}`;
+    }
+}
+/**
+ * TAL-1212: the first `limit` rows of a session document's top-level `messages` array and the signature of the inode they
+ * were read from. Reads the descriptor incrementally and parses only those rows; a document the scan cannot follow (no
+ * `messages` array, a non-object row, a truncated file) falls back to one full parse of the same descriptor.
+ */
+export async function readJsonMessagePrefix(path, limit, chunkBytes = 64 * 1024) {
+    const handle = await open(path, 'r');
+    try {
+        const signature = signatureOf(path, await handle.stat({ bigint: true }));
+        const decoder = new StringDecoder('utf8');
+        let chunk = Buffer.alloc(chunkBytes);
+        const scan = messagePrefixScanner(limit);
+        let text = '';
+        let rows;
+        let eof = false;
+        while (!eof) {
+            const { bytesRead } = await handle.read(chunk, 0, chunk.length, null);
+            eof = bytesRead === 0;
+            text += eof ? decoder.end() : decoder.write(chunk.subarray(0, bytesRead));
+            if (rows === undefined)
+                rows = scan(text);
+            if (rows)
+                return { rows, signature };
+            // Doubling keeps re-flattening the growing text linear in the bytes read.
+            if (!eof && chunk.length < 16 * 1024 * 1024)
+                chunk = Buffer.alloc(chunk.length * 2);
+        }
+        const doc = JSON.parse(text);
+        return { rows: Array.isArray(doc?.messages) ? doc.messages.slice(0, limit) : [], signature };
+    }
+    finally {
+        await handle.close();
+    }
+}
+/**
+ * Feed the growing document text; returns the parsed rows once `limit` rows or the array's end are scanned, null when
+ * the document needs a full parse, and undefined while more text is needed.
+ */
+function messagePrefixScanner(limit) {
+    const rows = [];
+    let phase = 'key';
+    let i = 0;
+    let depth = 0;
+    let inString = false;
+    let escape = false;
+    let stringStart = 0;
+    let key = null;
+    let rowStart = null;
+    return (text) => {
+        for (; i < text.length; i += 1) {
+            const ch = text[i];
+            if (inString) {
+                if (escape)
+                    escape = false;
+                else if (ch === '\\')
+                    escape = true;
+                else if (ch === '"') {
+                    inString = false;
+                    if (phase === 'key' && depth === 1)
+                        key = text.slice(stringStart + 1, i);
+                }
+                continue;
+            }
+            const space = ch === ' ' || ch === '\n' || ch === '\r' || ch === '\t';
+            if (phase === 'value') {
+                if (space)
+                    continue;
+                if (ch !== '[')
+                    return null;
+                phase = 'array';
+                depth = 2;
+                continue;
+            }
+            if (phase === 'array' && rowStart === null) {
+                if (space || ch === ',')
+                    continue;
+                if (ch === ']')
+                    return rows;
+                if (ch !== '{')
+                    return null;
+                rowStart = i;
+            }
+            if (ch === '"') {
+                inString = true;
+                stringStart = i;
+                continue;
+            }
+            if (ch === '{' || ch === '[')
+                depth += 1;
+            else if (ch === '}' || ch === ']') {
+                depth -= 1;
+                if (phase === 'array' && depth === 2) {
+                    rows.push(JSON.parse(text.slice(rowStart, i + 1)));
+                    rowStart = null;
+                    if (rows.length >= limit)
+                        return rows;
+                }
+                continue;
+            }
+            if (phase === 'key' && depth === 1 && !space) {
+                if (ch === ':' && key === 'messages')
+                    phase = 'value';
+                else
+                    key = null;
+            }
+        }
+        return undefined;
+    };
+}
+import { readSync } from 'node:fs';
+function readSyncFully(fd, buf) {
+    let total = 0;
+    while (total < buf.length) {
+        const n = readSync(fd, buf, total, buf.length - total, null);
+        if (n === 0)
+            break;
+        total += n;
+    }
+    return total;
+}
+/** Offset of `"key":` at JSON nesting depth 1, or null. */
+export function findTopLevelJsonKey(text, key) {
+    let depth = 0;
+    let inString = false;
+    let escape = false;
+    let stringStart = -1;
+    for (let i = 0; i < text.length; i += 1) {
+        const ch = text[i];
+        if (inString) {
+            if (escape)
+                escape = false;
+            else if (ch === '\\')
+                escape = true;
+            else if (ch === '"') {
+                inString = false;
+                if (depth === 1 && text.slice(stringStart + 1, i) === key) {
+                    let j = i + 1;
+                    while (j < text.length && /\s/.test(text[j] ?? ''))
+                        j += 1;
+                    if (text[j] === ':')
+                        return stringStart;
+                }
+            }
+            continue;
+        }
+        if (ch === '"') {
+            inString = true;
+            stringStart = i;
+            continue;
+        }
+        if (ch === '{' || ch === '[')
+            depth += 1;
+        else if (ch === '}' || ch === ']')
+            depth -= 1;
+    }
+    return null;
+}
+//# sourceMappingURL=json-files.js.map

package/dist/sessions/storage/json-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-files.js","sourceRoot":"","sources":["../../../src/sessions/storage/json-files.ts"],"names":[],"mappings":"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"}

package/dist/sessions/storage/json-installation.d.ts

@@ -0,0 +1,3 @@
+export declare const CHANNEL_SWITCH_BACKUPS = 5;
+/** Copy the persisted stores to `<stateDir>/backups/channel-switch-<UTC timestamp>/`, keeping the newest few; throws on failure. */
+export declare function backupPersistedStores(stateDir: string, now?: Date, keep?: number): string;

package/dist/sessions/storage/json-installation.js

@@ -0,0 +1,31 @@
+import { copyFileSync, existsSync, mkdirSync, mkdtempSync, readdirSync, renameSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+export const CHANNEL_SWITCH_BACKUPS = 5;
+/** Web's persisted stores (`settings.json`, the project store, the workspace store) as seen from the state dir. */
+const PERSISTED_STORES = ['settings.json', 'projects.json', 'workspaces.json', 'last_workspace.txt'];
+/** Copy the persisted stores to `<stateDir>/backups/channel-switch-<UTC timestamp>/`, keeping the newest few; throws on failure. */
+export function backupPersistedStores(stateDir, now = new Date(), keep = CHANNEL_SWITCH_BACKUPS) {
+    const root = join(stateDir, 'backups');
+    mkdirSync(root, { recursive: true });
+    const name = `channel-switch-${now.toISOString().replace(/[:.]/g, '-')}`;
+    const target = join(root, name);
+    if (existsSync(target))
+        throw new Error(`${name} already exists`);
+    // Only a complete copy is published under the name that counts toward the retained backups.
+    const partial = mkdtempSync(join(root, `.${name}-`));
+    try {
+        for (const store of PERSISTED_STORES)
+            if (existsSync(join(stateDir, store)))
+                copyFileSync(join(stateDir, store), join(partial, store));
+        renameSync(partial, target);
+    }
+    catch (error) {
+        rmSync(partial, { recursive: true, force: true });
+        throw error;
+    }
+    const backups = readdirSync(root).filter((name) => name.startsWith('channel-switch-')).sort();
+    for (const old of backups.slice(0, Math.max(0, backups.length - keep)))
+        rmSync(join(root, old), { recursive: true, force: true });
+    return target;
+}
+//# sourceMappingURL=json-installation.js.map

package/dist/sessions/storage/json-installation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-installation.js","sourceRoot":"","sources":["../../../src/sessions/storage/json-installation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAC3G,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAA;AACvC,mHAAmH;AACnH,MAAM,gBAAgB,GAAG,CAAC,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,oBAAoB,CAAC,CAAA;AAEpG,oIAAoI;AACpI,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,MAAY,IAAI,IAAI,EAAE,EAAE,IAAI,GAAG,sBAAsB;IAC3G,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;IACtC,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACpC,MAAM,IAAI,GAAG,kBAAkB,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAA;IACxE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IAC/B,IAAI,UAAU,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,iBAAiB,CAAC,CAAA;IACjE,4FAA4F;IAC5F,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,GAAG,CAAC,CAAC,CAAA;IACpD,IAAI,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,gBAAgB;YAAE,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;gBAAE,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;QACtI,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QACjD,MAAM,KAAK,CAAA;IACb,CAAC;IACD,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAC7F,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACjI,OAAO,MAAM,CAAA;AACf,CAAC"}