@serfab/cadre-host 0.9.0 → 0.11.0

package/src/installer/__tests__/paths.test.ts

@@ -1,47 +1,47 @@
-import { describe, expect, it } from 'vitest';
-
-import { defaultDataDir, serviceInstallPath } from '../paths.js';
-
-describe('defaultDataDir', () => {
-  it('honors XDG_DATA_HOME on linux', () => {
-    expect(defaultDataDir('linux', { XDG_DATA_HOME: '/tmp/xdg', HOME: '/home/me' }, '/home/me'))
-      .toBe('/tmp/xdg/cadre-host');
-  });
-
-  it('falls back to ~/.local/share on linux', () => {
-    expect(defaultDataDir('linux', { HOME: '/home/me' }, '/home/me'))
-      .toBe('/home/me/.local/share/cadre-host');
-  });
-
-  it('uses Application Support on darwin', () => {
-    expect(defaultDataDir('darwin', { HOME: '/Users/me' }, '/Users/me'))
-      .toBe('/Users/me/Library/Application Support/CadreHost');
-  });
-
-  it('uses LocalAppData on win32', () => {
-    expect(defaultDataDir('win32', { LocalAppData: 'C:\\Users\\me\\AppData\\Local' }, 'C:\\Users\\me'))
-      .toBe('C:\\Users\\me\\AppData\\Local\\CadreHost');
-  });
-
-  it('falls back to ~/AppData/Local on win32 without LocalAppData', () => {
-    expect(defaultDataDir('win32', {}, 'C:\\Users\\me'))
-      .toBe('C:\\Users\\me\\AppData\\Local\\CadreHost');
-  });
-});
-
-describe('serviceInstallPath', () => {
-  it('honors XDG_CONFIG_HOME on linux', () => {
-    expect(serviceInstallPath('linux', { XDG_CONFIG_HOME: '/tmp/cfg', HOME: '/home/me' }, '/home/me'))
-      .toBe('/tmp/cfg/systemd/user/cadre-host.service');
-  });
-
-  it('uses LaunchAgents on darwin', () => {
-    expect(serviceInstallPath('darwin', { HOME: '/Users/me' }, '/Users/me'))
-      .toBe('/Users/me/Library/LaunchAgents/com.serfab.cadre-host.plist');
-  });
-
-  it('returns a registry-style path on win32 (for logging only)', () => {
-    expect(serviceInstallPath('win32', {}, 'C:\\Users\\me'))
-      .toMatch(/CadreHost/);
-  });
-});
+import { describe, expect, it } from 'vitest';
+
+import { defaultDataDir, serviceInstallPath } from '../paths.js';
+
+describe('defaultDataDir', () => {
+  it('honors XDG_DATA_HOME on linux', () => {
+    expect(defaultDataDir('linux', { XDG_DATA_HOME: '/tmp/xdg', HOME: '/home/me' }, '/home/me'))
+      .toBe('/tmp/xdg/cadre-host');
+  });
+
+  it('falls back to ~/.local/share on linux', () => {
+    expect(defaultDataDir('linux', { HOME: '/home/me' }, '/home/me'))
+      .toBe('/home/me/.local/share/cadre-host');
+  });
+
+  it('uses Application Support on darwin', () => {
+    expect(defaultDataDir('darwin', { HOME: '/Users/me' }, '/Users/me'))
+      .toBe('/Users/me/Library/Application Support/CadreHost');
+  });
+
+  it('uses LocalAppData on win32', () => {
+    expect(defaultDataDir('win32', { LocalAppData: 'C:\\Users\\me\\AppData\\Local' }, 'C:\\Users\\me'))
+      .toBe('C:\\Users\\me\\AppData\\Local\\CadreHost');
+  });
+
+  it('falls back to ~/AppData/Local on win32 without LocalAppData', () => {
+    expect(defaultDataDir('win32', {}, 'C:\\Users\\me'))
+      .toBe('C:\\Users\\me\\AppData\\Local\\CadreHost');
+  });
+});
+
+describe('serviceInstallPath', () => {
+  it('honors XDG_CONFIG_HOME on linux', () => {
+    expect(serviceInstallPath('linux', { XDG_CONFIG_HOME: '/tmp/cfg', HOME: '/home/me' }, '/home/me'))
+      .toBe('/tmp/cfg/systemd/user/cadre-host.service');
+  });
+
+  it('uses LaunchAgents on darwin', () => {
+    expect(serviceInstallPath('darwin', { HOME: '/Users/me' }, '/Users/me'))
+      .toBe('/Users/me/Library/LaunchAgents/com.serfab.cadre-host.plist');
+  });
+
+  it('returns a registry-style path on win32 (for logging only)', () => {
+    expect(serviceInstallPath('win32', {}, 'C:\\Users\\me'))
+      .toMatch(/CadreHost/);
+  });
+});

package/src/installer/__tests__/service-host.test.ts

@@ -1,62 +1,62 @@
-import { describe, expect, it } from 'vitest';
-import { resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-import { LaunchdServiceHost } from '../service-host/launchd.js';
-import { SystemdServiceHost } from '../service-host/systemd.js';
-import { NssmServiceHost } from '../service-host/nssm.js';
-import { renderTemplate } from '../service-host/template.js';
-import type { ServiceHostContext } from '../service-host/types.js';
-
-const here = fileURLToPath(new URL('.', import.meta.url));
-const serviceDir = resolve(here, '..', '..', '..', 'service');
-
-function ctx(): ServiceHostContext {
-  return {
-    nodePath: '/usr/local/bin/node',
-    hostJs: '/opt/cadre-host/dist/bin/host.js',
-    dataDir: '/var/data/cadre-host',
-    serviceDir,
-  };
-}
-
-describe('renderTemplate', () => {
-  it('substitutes @TOKEN@ values', () => {
-    expect(renderTemplate('@A@ x @B@', { A: 'foo', B: 'bar' })).toBe('foo x bar');
-  });
-
-  it('throws on unknown tokens', () => {
-    expect(() => renderTemplate('@A@ @MISSING@', { A: 'foo' })).toThrow(/missing value for token @MISSING@/);
-  });
-});
-
-describe('SystemdServiceHost.renderUnit', () => {
-  it('produces an enable-able [Install] section and substitutes ExecStart', () => {
-    const unit = new SystemdServiceHost().renderUnit(ctx());
-    expect(unit).toContain('[Install]');
-    expect(unit).toContain('WantedBy=default.target');
-    expect(unit).toContain('ExecStart=/usr/local/bin/node /opt/cadre-host/dist/bin/host.js start --no-tui --data-dir /var/data/cadre-host');
-    expect(unit).toContain('RestartPreventExitStatus=0');
-  });
-});
-
-describe('LaunchdServiceHost.renderUnit', () => {
-  it('produces a plist with the substituted ProgramArguments', () => {
-    const unit = new LaunchdServiceHost().renderUnit(ctx());
-    expect(unit).toContain('<key>Label</key>');
-    expect(unit).toContain('<string>com.serfab.cadre-host</string>');
-    expect(unit).toContain('<string>/usr/local/bin/node</string>');
-    expect(unit).toContain('<string>/opt/cadre-host/dist/bin/host.js</string>');
-    expect(unit).toContain('<string>--data-dir</string>');
-    expect(unit).toContain('<string>/var/data/cadre-host</string>');
-    expect(unit).toContain('<key>KeepAlive</key>');
-    expect(unit).toContain('<key>SuccessfulExit</key>');
-    expect(unit).toContain('<key>Crashed</key>');
-  });
-});
-
-describe('NssmServiceHost', () => {
-  it('returns null from renderUnit (NSSM stores config in the registry)', () => {
-    expect(new NssmServiceHost().renderUnit(ctx())).toBeNull();
-  });
-});
+import { describe, expect, it } from 'vitest';
+import { resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { LaunchdServiceHost } from '../service-host/launchd.js';
+import { SystemdServiceHost } from '../service-host/systemd.js';
+import { NssmServiceHost } from '../service-host/nssm.js';
+import { renderTemplate } from '../service-host/template.js';
+import type { ServiceHostContext } from '../service-host/types.js';
+
+const here = fileURLToPath(new URL('.', import.meta.url));
+const serviceDir = resolve(here, '..', '..', '..', 'service');
+
+function ctx(): ServiceHostContext {
+  return {
+    nodePath: '/usr/local/bin/node',
+    hostJs: '/opt/cadre-host/dist/bin/host.js',
+    dataDir: '/var/data/cadre-host',
+    serviceDir,
+  };
+}
+
+describe('renderTemplate', () => {
+  it('substitutes @TOKEN@ values', () => {
+    expect(renderTemplate('@A@ x @B@', { A: 'foo', B: 'bar' })).toBe('foo x bar');
+  });
+
+  it('throws on unknown tokens', () => {
+    expect(() => renderTemplate('@A@ @MISSING@', { A: 'foo' })).toThrow(/missing value for token @MISSING@/);
+  });
+});
+
+describe('SystemdServiceHost.renderUnit', () => {
+  it('produces an enable-able [Install] section and substitutes ExecStart', () => {
+    const unit = new SystemdServiceHost().renderUnit(ctx());
+    expect(unit).toContain('[Install]');
+    expect(unit).toContain('WantedBy=default.target');
+    expect(unit).toContain('ExecStart=/usr/local/bin/node /opt/cadre-host/dist/bin/host.js start --no-tui --data-dir /var/data/cadre-host');
+    expect(unit).toContain('RestartPreventExitStatus=0');
+  });
+});
+
+describe('LaunchdServiceHost.renderUnit', () => {
+  it('produces a plist with the substituted ProgramArguments', () => {
+    const unit = new LaunchdServiceHost().renderUnit(ctx());
+    expect(unit).toContain('<key>Label</key>');
+    expect(unit).toContain('<string>com.serfab.cadre-host</string>');
+    expect(unit).toContain('<string>/usr/local/bin/node</string>');
+    expect(unit).toContain('<string>/opt/cadre-host/dist/bin/host.js</string>');
+    expect(unit).toContain('<string>--data-dir</string>');
+    expect(unit).toContain('<string>/var/data/cadre-host</string>');
+    expect(unit).toContain('<key>KeepAlive</key>');
+    expect(unit).toContain('<key>SuccessfulExit</key>');
+    expect(unit).toContain('<key>Crashed</key>');
+  });
+});
+
+describe('NssmServiceHost', () => {
+  it('returns null from renderUnit (NSSM stores config in the registry)', () => {
+    expect(new NssmServiceHost().renderUnit(ctx())).toBeNull();
+  });
+});

package/src/installer/__tests__/wizard.test.ts

@@ -1,64 +1,64 @@
-import { describe, expect, it } from 'vitest';
-
-import { runWizardWith, type WizardDefaults } from '../wizard.js';
-
-const defaults: WizardDefaults = {
-  dataDir: '/data/cadre-host',
-  uiPort: 8765,
-  libp2pPort: 4001,
-  upnpEnabled: true,
-  ownCadre: false,
-};
-
-function scripted(answers: ReadonlyArray<string>): (label: string, fallback: string) => Promise<string> {
-  let i = 0;
-  return async (_label, _fallback) => {
-    if (i >= answers.length) throw new Error(`wizard asked more questions than scripted (i=${i})`);
-    return answers[i++]!;
-  };
-}
-
-describe('runWizardWith', () => {
-  it('returns the defaults when every answer is blank', async () => {
-    const out = await runWizardWith(defaults, scripted(['', '', '', '', '', '']));
-    expect(out).toEqual({
-      dataDir: '/data/cadre-host',
-      uiPort: 8765,
-      libp2pPort: 4001,
-      upnpEnabled: true,
-      configureDdns: false,
-      ownCadre: false,
-    });
-  });
-
-  it('respects overrides', async () => {
-    const out = await runWizardWith(defaults, scripted([
-      '/srv/host',
-      '9000',
-      '5000',
-      'n',
-      'y',
-      'y',
-    ]));
-    expect(out).toEqual({
-      dataDir: '/srv/host',
-      uiPort: 9000,
-      libp2pPort: 5000,
-      upnpEnabled: false,
-      configureDdns: true,
-      ownCadre: true,
-    });
-  });
-
-  it('rejects invalid port input', async () => {
-    await expect(
-      runWizardWith(defaults, scripted(['', 'banana', '', '', ''])),
-    ).rejects.toThrow(/Invalid port/);
-  });
-
-  it('rejects unrecognized yes/no answers', async () => {
-    await expect(
-      runWizardWith(defaults, scripted(['', '', '', 'maybe', ''])),
-    ).rejects.toThrow(/Invalid yes\/no/);
-  });
-});
+import { describe, expect, it } from 'vitest';
+
+import { runWizardWith, type WizardDefaults } from '../wizard.js';
+
+const defaults: WizardDefaults = {
+  dataDir: '/data/cadre-host',
+  uiPort: 8765,
+  libp2pPort: 4001,
+  upnpEnabled: true,
+  ownCadre: false,
+};
+
+function scripted(answers: ReadonlyArray<string>): (label: string, fallback: string) => Promise<string> {
+  let i = 0;
+  return async (_label, _fallback) => {
+    if (i >= answers.length) throw new Error(`wizard asked more questions than scripted (i=${i})`);
+    return answers[i++]!;
+  };
+}
+
+describe('runWizardWith', () => {
+  it('returns the defaults when every answer is blank', async () => {
+    const out = await runWizardWith(defaults, scripted(['', '', '', '', '', '']));
+    expect(out).toEqual({
+      dataDir: '/data/cadre-host',
+      uiPort: 8765,
+      libp2pPort: 4001,
+      upnpEnabled: true,
+      configureDdns: false,
+      ownCadre: false,
+    });
+  });
+
+  it('respects overrides', async () => {
+    const out = await runWizardWith(defaults, scripted([
+      '/srv/host',
+      '9000',
+      '5000',
+      'n',
+      'y',
+      'y',
+    ]));
+    expect(out).toEqual({
+      dataDir: '/srv/host',
+      uiPort: 9000,
+      libp2pPort: 5000,
+      upnpEnabled: false,
+      configureDdns: true,
+      ownCadre: true,
+    });
+  });
+
+  it('rejects invalid port input', async () => {
+    await expect(
+      runWizardWith(defaults, scripted(['', 'banana', '', '', ''])),
+    ).rejects.toThrow(/Invalid port/);
+  });
+
+  it('rejects unrecognized yes/no answers', async () => {
+    await expect(
+      runWizardWith(defaults, scripted(['', '', '', 'maybe', ''])),
+    ).rejects.toThrow(/Invalid yes\/no/);
+  });
+});

package/src/installer/identity.ts

@@ -1,49 +1,49 @@
-/**
- * Identity persistence for cadre-host.
- *
- * The host's libp2p peer identity is an Ed25519 keypair generated at
- * install time. The protobuf-encoded private key is written to
- * `<dataDir>/identity.key` with mode 0600 on POSIX. `cadre-host start`
- * later loads it with `privateKeyFromProtobuf`.
- *
- * We persist the protobuf form (not raw bytes) because that's the format
- * libp2p's `privateKeyFromProtobuf` consumes directly and it preserves the
- * key type tag — future migrations to a different key algorithm don't
- * require a schema change here.
- */
-
-import { chmodSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { dirname } from 'node:path';
-import {
-  generateKeyPair,
-  privateKeyFromProtobuf,
-  privateKeyToProtobuf,
-} from '@libp2p/crypto/keys';
-import { peerIdFromPrivateKey } from '@libp2p/peer-id';
-import type { PrivateKey } from '@libp2p/interface';
-
-export interface IdentityRecord {
-  privateKey: PrivateKey;
-  /** Stringified libp2p peer ID (`12D3Koo…`). */
-  peerId: string;
-}
-
-/** Generate a fresh Ed25519 identity and persist it. Returns the in-memory record. */
-export async function generateIdentity(filePath: string): Promise<IdentityRecord> {
-  const privateKey = await generateKeyPair('Ed25519');
-  const bytes = privateKeyToProtobuf(privateKey);
-  mkdirSync(dirname(filePath), { recursive: true });
-  writeFileSync(filePath, bytes);
-  // 0600 — owner read/write only. No-op on Windows.
-  if (process.platform !== 'win32') {
-    chmodSync(filePath, 0o600);
-  }
-  return { privateKey, peerId: peerIdFromPrivateKey(privateKey).toString() };
-}
-
-/** Load an existing identity file. Throws if it doesn't decode. */
-export function loadIdentity(filePath: string): IdentityRecord {
-  const bytes = readFileSync(filePath);
-  const privateKey = privateKeyFromProtobuf(new Uint8Array(bytes));
-  return { privateKey, peerId: peerIdFromPrivateKey(privateKey).toString() };
-}
+/**
+ * Identity persistence for cadre-host.
+ *
+ * The host's libp2p peer identity is an Ed25519 keypair generated at
+ * install time. The protobuf-encoded private key is written to
+ * `<dataDir>/identity.key` with mode 0600 on POSIX. `cadre-host start`
+ * later loads it with `privateKeyFromProtobuf`.
+ *
+ * We persist the protobuf form (not raw bytes) because that's the format
+ * libp2p's `privateKeyFromProtobuf` consumes directly and it preserves the
+ * key type tag — future migrations to a different key algorithm don't
+ * require a schema change here.
+ */
+
+import { chmodSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import {
+  generateKeyPair,
+  privateKeyFromProtobuf,
+  privateKeyToProtobuf,
+} from '@libp2p/crypto/keys';
+import { peerIdFromPrivateKey } from '@libp2p/peer-id';
+import type { PrivateKey } from '@libp2p/interface';
+
+export interface IdentityRecord {
+  privateKey: PrivateKey;
+  /** Stringified libp2p peer ID (`12D3Koo…`). */
+  peerId: string;
+}
+
+/** Generate a fresh Ed25519 identity and persist it. Returns the in-memory record. */
+export async function generateIdentity(filePath: string): Promise<IdentityRecord> {
+  const privateKey = await generateKeyPair('Ed25519');
+  const bytes = privateKeyToProtobuf(privateKey);
+  mkdirSync(dirname(filePath), { recursive: true });
+  writeFileSync(filePath, bytes);
+  // 0600 — owner read/write only. No-op on Windows.
+  if (process.platform !== 'win32') {
+    chmodSync(filePath, 0o600);
+  }
+  return { privateKey, peerId: peerIdFromPrivateKey(privateKey).toString() };
+}
+
+/** Load an existing identity file. Throws if it doesn't decode. */
+export function loadIdentity(filePath: string): IdentityRecord {
+  const bytes = readFileSync(filePath);
+  const privateKey = privateKeyFromProtobuf(new Uint8Array(bytes));
+  return { privateKey, peerId: peerIdFromPrivateKey(privateKey).toString() };
+}