@volter/supercode-teams 0.3.185 → 0.3.187

package/mail/upgrade-state.mjs

@@ -0,0 +1,78 @@
+import { connect } from 'node:net';
+import { copyFile, lstat, mkdir, readFile, readdir, rename, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+
+const json = async path => { try { return JSON.parse(await readFile(path, 'utf8')); } catch (error) { if (error.code === 'ENOENT') return null; throw error; } };
+const present = async path => { try { return await lstat(path); } catch (error) { if (error.code === 'ENOENT') return null; throw error; } };
+const answers = socket => new Promise(done => {
+  if (typeof socket !== 'string') return done(false);
+  const probe = connect(socket), timer = setTimeout(() => { probe.destroy(); done(false); }, 200);
+  probe.once('connect', () => { clearTimeout(timer); probe.destroy(); done(true); });
+  probe.once('error', () => { clearTimeout(timer); done(false); });
+});
+
+export async function checkpoint(home, directory) {
+  const path = join(home, 'mail.sqlite');
+  let database = false;
+  if (await present(path)) {
+    const { DatabaseSync } = await import('node:sqlite');
+    const reader = new DatabaseSync(path, { readOnly: true });
+    try { reader.prepare('VACUUM INTO ?').run(join(directory, 'mail.sqlite')); database = true; }
+    finally { reader.close(); }
+  }
+  const legacy = await present(join(home, 'mail'));
+  if (legacy && !legacy.isDirectory()) throw new Error('startup checkpoint requires a regular original Maildir');
+  const before = { database, legacy: legacy ? { device: legacy.dev, inode: legacy.ino } : null };
+  await writeFile(join(directory, 'before.json'), JSON.stringify(before) + '\n', { mode: 0o600 });
+  return before;
+}
+
+async function mergeLegacy(source, target) {
+  // Older writers can recreate the path during startup. Merge only records
+  // that do not conflict; keep both complete trees if a choice is required.
+  for (const item of await readdir(source, { withFileTypes: true })) {
+    const from = join(source, item.name), to = join(target, item.name), saved = await present(to);
+    if (item.isDirectory()) {
+      if (saved && !saved.isDirectory()) throw new Error('startup recovery found conflicting legacy record types');
+      if (!saved) await mkdir(to, { mode: 0o700 });
+      await mergeLegacy(from, to);
+    } else if (item.isFile()) {
+      if (!saved) await copyFile(from, to);
+      else if (!saved.isFile() || !(await readFile(from)).equals(await readFile(to))) throw new Error('startup recovery found conflicting legacy record bytes; both originals are retained');
+    } else throw new Error('startup recovery found a non-regular legacy record');
+  }
+}
+
+export async function restore(home, directory, before, teamsHome) {
+  const serving = await json(join(teamsHome, 'machine.json'));
+  if (serving && await answers(serving.socket)) throw new Error('startup recovery refused: another daemon is serving this home');
+  const path = join(home, 'mail.sqlite');
+  if (before.legacy) {
+    const root = join(home, 'mail'), current = await present(root);
+    const original = item => item?.isDirectory() && item.dev === before.legacy.device && item.ino === before.legacy.inode;
+    if (!original(current)) {
+      const archives = join(home, 'mail-retired');
+      let matches = [];
+      if (await present(archives)) for (const name of await readdir(archives)) {
+        const path = join(archives, name);
+        if (original(await present(path))) matches.push(path);
+      }
+      // Locate the pre-start inode even if a failed candidate's database cannot
+      // be opened or its metadata transaction never committed.
+      if (matches.length !== 1) throw new Error('startup recovery cannot locate its retained original Maildir');
+      if (current) {
+        if (!current.isDirectory()) throw new Error('startup recovery found a replaced Maildir path');
+        await mergeLegacy(root, matches[0]);
+        await rename(root, join(directory, 'recreated-mail'));
+      }
+      await rename(matches[0], root);
+    }
+  }
+  // Startup failure never served a caller. Preserve the failed candidate's
+  // database bytes for diagnosis before restoring the previous schema snapshot.
+  for (const suffix of ['', '-wal', '-shm']) {
+    if (await present(path + suffix)) await rename(path + suffix, join(directory, 'failed-mail.sqlite' + suffix));
+  }
+  if (before.database) await copyFile(join(directory, 'mail.sqlite'), path);
+}
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/supercode-teams",
-  "version": "0.3.185",
+  "version": "0.3.187",
   "type": "module",
   "description": "A machine daemon serving this machine's doors, and a local or remote Teams server for shared session discovery, OpenTelemetry ingestion and access to enrolled machines.",
   "license": "MIT",