@noy-db/cli 0.1.0-pre.3

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/commands/inspect.ts","../src/commands/verify.ts","../src/commands/config.ts","../src/commands/monitor.ts"],"sourcesContent":["/**\n * **@noy-db/cli** — programmatic API for the `noydb` CLI.\n *\n * The CLI is primarily used via the `noydb` executable (installed as\n * a bin when this package is installed), but every subcommand is\n * also exposed as a function for programmatic use inside tests,\n * scripts, or custom wrappers.\n *\n * ```ts\n * import { inspect, verify, validateOptions, scaffold } from '@noy-db/cli'\n *\n * const header  = await inspect('backup.noydb')\n * const report  = await verify('backup.noydb')\n * const issues  = validateOptions(myNoydbOptions)\n * const profile = scaffold('C')\n * ```\n *\n * @packageDocumentation\n */\n\nexport { inspect, runInspect } from './commands/inspect.js'\nexport type { InspectResult } from './commands/inspect.js'\n\nexport { verify, runVerify } from './commands/verify.js'\nexport type { VerifyReport } from './commands/verify.js'\n\nexport {\n  validateOptions,\n  loadOptionsFromFile,\n  scaffold,\n  runConfigValidate,\n  runConfigScaffold,\n} from './commands/config.js'\nexport type {\n  ValidationIssue,\n  ValidationReport,\n  ScaffoldResult,\n  Profile,\n} from './commands/config.js'\n\nexport { runMonitor, formatSnapshot } from './commands/monitor.js'\nexport type { MonitorOptions } from './commands/monitor.js'\n","/**\n * `noydb inspect <file.noydb>` — print the unencrypted header.\n *\n * This command is the security-sensitive one in the CLI: it must\n * never prompt for a passphrase and never decrypt anything. It reads\n * exactly the unencrypted header bytes (magic + flags + header\n * length prefix + JSON header) and returns structured metadata.\n *\n * What the header reveals:\n *   - `formatVersion` — container format version\n *   - `handle`        — ULID identifier\n *   - `bodyBytes`     — compressed body size\n *   - `bodySha256`    — body integrity hash\n *\n * What it does **not** reveal: record counts, collection names,\n * ciphertext, keyring, timestamps inside records. Those live past\n * the decryption boundary.\n *\n * @module\n */\nimport { readNoydbBundleHeader } from '@noy-db/hub'\nimport { readFile } from 'node:fs/promises'\n\nexport interface InspectResult {\n  formatVersion: number\n  handle: string\n  bodyBytes: number\n  bodySha256: string\n}\n\nexport async function inspect(filePath: string): Promise<InspectResult> {\n  const bytes = await readFile(filePath)\n  const header = readNoydbBundleHeader(new Uint8Array(bytes))\n  return {\n    formatVersion: header.formatVersion,\n    handle: header.handle,\n    bodyBytes: header.bodyBytes,\n    bodySha256: header.bodySha256,\n  }\n}\n\nexport async function runInspect(argv: readonly string[]): Promise<number> {\n  const file = argv[0]\n  if (!file) {\n    process.stderr.write('usage: noydb inspect <file.noydb>\\n')\n    return 2\n  }\n  try {\n    const info = await inspect(file)\n    process.stdout.write(JSON.stringify(info, null, 2) + '\\n')\n    return 0\n  } catch (err) {\n    process.stderr.write(`inspect failed: ${(err as Error).message}\\n`)\n    return 1\n  }\n}\n","/**\n * `noydb verify <file.noydb>` — integrity check.\n *\n * Validates the three integrity properties of a bundle that can be\n * verified **without the passphrase**:\n *\n *   1. Magic prefix + format version match what this CLI supports.\n *   2. Header parses as JSON with the minimum-disclosure key set.\n *   3. Compressed body SHA-256 matches `header.bodySha256`.\n *\n * Ledger-head verification (which does need the passphrase) is not\n * covered here — that's a future enhancement when an `open` subcommand\n * lands. For now, `verify` answers \"was this file transmitted intact?\"\n * without involving keys.\n *\n * @module\n */\nimport { readNoydbBundle, readNoydbBundleHeader } from '@noy-db/hub'\nimport { readFile } from 'node:fs/promises'\n\nexport interface VerifyReport {\n  ok: boolean\n  file: string\n  handle: string\n  bodyBytes: number\n  checks: { magic: boolean; header: boolean; bodyHash: boolean }\n  error?: string\n}\n\nexport async function verify(filePath: string): Promise<VerifyReport> {\n  const bytes = new Uint8Array(await readFile(filePath))\n  const checks = { magic: false, header: false, bodyHash: false }\n\n  let handle = ''\n  let bodyBytes = 0\n\n  try {\n    const header = readNoydbBundleHeader(bytes)\n    checks.magic = true\n    checks.header = true\n    handle = header.handle\n    bodyBytes = header.bodyBytes\n\n    // readNoydbBundle() verifies bodySha256 internally — if it doesn't\n    // throw, the body hash matched.\n    await readNoydbBundle(bytes)\n    checks.bodyHash = true\n\n    return { ok: true, file: filePath, handle, bodyBytes, checks }\n  } catch (err) {\n    return {\n      ok: false, file: filePath, handle, bodyBytes, checks,\n      error: (err as Error).message,\n    }\n  }\n}\n\nexport async function runVerify(argv: readonly string[]): Promise<number> {\n  const file = argv[0]\n  if (!file) {\n    process.stderr.write('usage: noydb verify <file.noydb>\\n')\n    return 2\n  }\n  const report = await verify(file)\n  process.stdout.write(JSON.stringify(report, null, 2) + '\\n')\n  return report.ok ? 0 : 1\n}\n","/**\n * `noydb config validate` and `noydb config scaffold`.\n *\n * **validate** — sanity-check a `NoydbOptions` value at runtime. The\n * input file is expected to default-export a `NoydbOptions` object\n * (or a factory returning one). We dynamically import it and check:\n *\n *   - `store` is present and exposes the 6-method `NoydbStore` shape.\n *   - Sync targets have role ∈ {sync-peer, backup, archive} and a store.\n *   - `archive` targets don't carry a pull policy (archive is push-only).\n *   - `syncPolicy` pairs with at least one sync target.\n *   - `blob` routes (if present) sit on a bundle-capable store.\n *\n * **scaffold** — emit a working skeleton for one of the topology\n * profiles from `docs/guides/topology-matrix.md`. Output goes to stdout\n * (pipe to a file yourself) and is a ready-to-edit `.ts` + `.env`\n * pair, concatenated so the consumer can split them.\n *\n * @module\n */\nimport { pathToFileURL } from 'node:url'\nimport { resolve } from 'node:path'\n\nexport interface ValidationIssue {\n  severity: 'warn' | 'error'\n  code: string\n  path: string\n  message: string\n}\n\nexport interface ValidationReport {\n  ok: boolean\n  issues: ValidationIssue[]\n}\n\n/**\n * Validate a NoydbOptions-shaped object (not a file path — this is\n * the programmatic API). Conservative: if a check can't be made\n * confidently, it's skipped rather than warned, to avoid nagging.\n */\n/** Coerces arbitrary values to a human-readable string without triggering\n *  `[object Object]` — used by the config validator to report bad field types. */\nfunction safeStringify(v: unknown): string {\n  if (typeof v === 'string') return v\n  if (typeof v === 'number' || typeof v === 'boolean' || v === null || v === undefined) {\n    return String(v)\n  }\n  try { return JSON.stringify(v) } catch { return '<unserializable>' }\n}\n\nexport function validateOptions(opts: unknown): ValidationReport {\n  const issues: ValidationIssue[] = []\n\n  if (!isRecord(opts)) {\n    issues.push({ severity: 'error', code: 'not-object', path: '<root>',\n      message: 'NoydbOptions must be an object' })\n    return { ok: false, issues }\n  }\n\n  // Required: store\n  if (!opts.store) {\n    issues.push({ severity: 'error', code: 'missing-store', path: 'store',\n      message: '`store` is required' })\n  } else if (!isStoreShape(opts.store)) {\n    issues.push({ severity: 'error', code: 'bad-store-shape', path: 'store',\n      message: '`store` does not expose the 6-method NoydbStore contract' })\n  }\n\n  // sync — accept single store, SyncTarget, or SyncTarget[]\n  if (opts.sync !== undefined) {\n    const targets = normalizeSync(opts.sync)\n    targets.forEach((t, i) => validateTarget(t, `sync[${i}]`, issues))\n  }\n\n  // syncPolicy requires at least one sync target\n  if (opts.syncPolicy !== undefined && opts.sync === undefined) {\n    issues.push({ severity: 'warn', code: 'policy-without-sync', path: 'syncPolicy',\n      message: '`syncPolicy` has no effect without a `sync` target' })\n  }\n\n  // user is recommended\n  if (typeof opts.user !== 'string' || !opts.user) {\n    issues.push({ severity: 'warn', code: 'missing-user', path: 'user',\n      message: '`user` identifier is recommended — audit entries default to \"anonymous\" without it' })\n  }\n\n  // passphrase-or-encryption check\n  if (opts.secret === undefined && opts.passphrase === undefined && opts.encrypt !== false) {\n    issues.push({ severity: 'warn', code: 'no-secret', path: 'secret',\n      message: '`secret` / `passphrase` missing and `encrypt` not explicitly false — vault open will fail' })\n  }\n\n  const hasError = issues.some((i) => i.severity === 'error')\n  return { ok: !hasError, issues }\n}\n\n/** Dynamically import a JS/MJS/CJS config file and pull the NoydbOptions\n *  out of it. Accepts a default export that is either the options\n *  object or a zero-arg function (sync or async) returning the options.\n *\n *  **TypeScript note.** Node cannot `import()` a bare `.ts` file without\n *  a loader. If the adopter's config is TypeScript, they should either\n *  compile it first (`tsc foo.ts`) or run the CLI under a TS-capable\n *  runtime (e.g. `tsx $(which noydb) config validate foo.ts`). The\n *  function throws a human-readable error for `.ts` input rather than\n *  propagating Node's cryptic `Unknown file extension` message. */\nexport async function loadOptionsFromFile(filePath: string): Promise<unknown> {\n  const abs = resolve(filePath)\n  if (abs.endsWith('.ts') || abs.endsWith('.mts') || abs.endsWith('.cts')) {\n    throw new Error(\n      `TypeScript config files are not directly loadable — Node has no native .ts loader.\\n` +\n      `  Options:\\n` +\n      `    (a) compile first:  tsc ${filePath} && noydb config validate ${filePath.replace(/\\.[mc]?ts$/, '.js')}\\n` +\n      `    (b) run via tsx:    npx tsx $(which noydb) config validate ${filePath}\\n` +\n      `    (c) rename to .mjs/.js if your config has no TS-only syntax`,\n    )\n  }\n  const mod = await import(pathToFileURL(abs).href) as { default?: unknown }\n  const value = mod.default ?? mod\n  if (typeof value === 'function') {\n    return await (value as () => Promise<unknown>)()\n  }\n  return value\n}\n\nexport async function runConfigValidate(argv: readonly string[]): Promise<number> {\n  const file = argv[0]\n  if (!file) {\n    process.stderr.write('usage: noydb config validate <file.ts|js>\\n')\n    return 2\n  }\n  let opts: unknown\n  try {\n    opts = await loadOptionsFromFile(file)\n  } catch (err) {\n    process.stderr.write(`failed to load ${file}: ${(err as Error).message}\\n`)\n    return 1\n  }\n\n  const report = validateOptions(opts)\n  process.stdout.write(JSON.stringify(report, null, 2) + '\\n')\n  return report.ok ? 0 : 1\n}\n\n// ── Scaffold ────────────────────────────────────────────────────────────\n\n/** Profiles match `docs/guides/topology-matrix.md` § View 3. */\nexport type Profile = 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J'\n\nexport interface ScaffoldResult {\n  profile: Profile\n  code: string\n  env: string\n  notes: string\n}\n\nexport function scaffold(profile: Profile): ScaffoldResult {\n  switch (profile) {\n    case 'A': return {\n      profile, notes: 'Local-only single-user. No cloud.',\n      code: [\n        `import { createNoydb } from '@noy-db/hub'`,\n        `import { jsonFile } from '@noy-db/to-file'`,\n        ``,\n        `export default {`,\n        `  store:  jsonFile({ dir: process.env.NOYDB_DATA_DIR ?? './data' }),`,\n        `  user:   process.env.NOYDB_USER ?? 'owner',`,\n        `  secret: process.env.NOYDB_SECRET,`,\n        `}`,\n      ].join('\\n'),\n      env: `NOYDB_USER=owner\\nNOYDB_SECRET=\\nNOYDB_DATA_DIR=./data\\n`,\n    }\n    case 'B': return {\n      profile, notes: 'Offline-first + cloud mirror. Local authoritative, sync opportunistically.',\n      code: [\n        `import { createNoydb, INDEXED_STORE_POLICY } from '@noy-db/hub'`,\n        `import { browserIdbStore } from '@noy-db/to-browser-idb'`,\n        `import { awsDynamoStore } from '@noy-db/to-aws-dynamo'`,\n        ``,\n        `export default {`,\n        `  store: browserIdbStore({ prefix: process.env.NOYDB_APP ?? 'myapp' }),`,\n        `  sync: [{`,\n        `    store: awsDynamoStore({`,\n        `      table:  process.env.NOYDB_DYNAMO_TABLE!,`,\n        `      region: process.env.AWS_REGION ?? 'us-east-1',`,\n        `    }),`,\n        `    role:  'sync-peer',`,\n        `    label: 'dynamo-live',`,\n        `  }],`,\n        `  syncPolicy: INDEXED_STORE_POLICY,`,\n        `  user:   process.env.NOYDB_USER ?? 'owner',`,\n        `  secret: process.env.NOYDB_SECRET,`,\n        `}`,\n      ].join('\\n'),\n      env: `NOYDB_USER=owner\\nNOYDB_SECRET=\\nNOYDB_APP=myapp\\nNOYDB_DYNAMO_TABLE=myapp-live\\nAWS_REGION=us-east-1\\n`,\n    }\n    case 'C': return {\n      profile, notes: 'Records + blobs split (routeStore). Dynamo for records, S3 for blobs.',\n      code: [\n        `import { createNoydb, routeStore } from '@noy-db/hub'`,\n        `import { awsDynamoStore } from '@noy-db/to-aws-dynamo'`,\n        `import { awsS3Store } from '@noy-db/to-aws-s3'`,\n        ``,\n        `export default {`,\n        `  store: routeStore({`,\n        `    default: awsDynamoStore({`,\n        `      table:  process.env.NOYDB_DYNAMO_TABLE!,`,\n        `      region: process.env.AWS_REGION ?? 'us-east-1',`,\n        `    }),`,\n        `    blobs:   awsS3Store({`,\n        `      bucket: process.env.NOYDB_S3_BUCKET!,`,\n        `      region: process.env.AWS_REGION ?? 'us-east-1',`,\n        `    }),`,\n        `  }),`,\n        `  user:   process.env.NOYDB_USER ?? 'owner',`,\n        `  secret: process.env.NOYDB_SECRET,`,\n        `}`,\n      ].join('\\n'),\n      env: `NOYDB_USER=owner\\nNOYDB_SECRET=\\nNOYDB_DYNAMO_TABLE=myapp-records\\nNOYDB_S3_BUCKET=myapp-blobs\\nAWS_REGION=us-east-1\\n`,\n    }\n    case 'G': return {\n      profile, notes: 'Middleware-hardened production: retry + breaker + cache + metrics.',\n      code: [\n        `import { createNoydb, wrapStore, withRetry, withCircuitBreaker, withCache, withHealthCheck, withMetrics } from '@noy-db/hub'`,\n        `import { awsDynamoStore } from '@noy-db/to-aws-dynamo'`,\n        ``,\n        `export default {`,\n        `  store: wrapStore(`,\n        `    awsDynamoStore({ table: process.env.NOYDB_DYNAMO_TABLE! }),`,\n        `    withRetry({ maxRetries: 3 }),`,\n        `    withCircuitBreaker({ failureThreshold: 5, resetTimeoutMs: 30_000 }),`,\n        `    withCache({ ttlMs: 60_000 }),`,\n        `    withHealthCheck(),`,\n        `    withMetrics({ onOperation: op => console.log(op) }),`,\n        `  ),`,\n        `  user:   process.env.NOYDB_USER ?? 'owner',`,\n        `  secret: process.env.NOYDB_SECRET,`,\n        `}`,\n      ].join('\\n'),\n      env: `NOYDB_USER=owner\\nNOYDB_SECRET=\\nNOYDB_DYNAMO_TABLE=myapp-prod\\n`,\n    }\n    case 'D': return {\n      profile, notes: 'Hot + cold tiered. Records age out to archive after N days.',\n      code: [\n        `import { createNoydb, routeStore } from '@noy-db/hub'`,\n        `import { awsDynamoStore } from '@noy-db/to-aws-dynamo'`,\n        `import { awsS3Store } from '@noy-db/to-aws-s3'`,\n        ``,\n        `export default {`,\n        `  store: routeStore({`,\n        `    default: awsDynamoStore({ table: process.env.NOYDB_DYNAMO_TABLE! }),`,\n        `    age: {`,\n        `      cold:          awsS3Store({ bucket: process.env.NOYDB_S3_COLD! }),`,\n        `      coldAfterDays: Number(process.env.NOYDB_COLD_AFTER_DAYS ?? '90'),`,\n        `    },`,\n        `  }),`,\n        `  user:   process.env.NOYDB_USER ?? 'owner',`,\n        `  secret: process.env.NOYDB_SECRET,`,\n        `}`,\n      ].join('\\n'),\n      env: `NOYDB_USER=owner\\nNOYDB_SECRET=\\nNOYDB_DYNAMO_TABLE=myapp-hot\\nNOYDB_S3_COLD=myapp-archive\\nNOYDB_COLD_AFTER_DAYS=90\\n`,\n    }\n    case 'E': return {\n      profile, notes: 'Multi-peer team sync. Primary + peer + backup + archive.',\n      code: [\n        `import { createNoydb } from '@noy-db/hub'`,\n        `import { browserIdbStore } from '@noy-db/to-browser-idb'`,\n        `import { awsDynamoStore } from '@noy-db/to-aws-dynamo'`,\n        `import { awsS3Store } from '@noy-db/to-aws-s3'`,\n        ``,\n        `export default {`,\n        `  store: browserIdbStore({ prefix: process.env.NOYDB_APP ?? 'team' }),`,\n        `  sync: [`,\n        `    { store: awsDynamoStore({ table: process.env.NOYDB_DYNAMO_TABLE! }), role: 'sync-peer', label: 'team-hot' },`,\n        `    { store: awsS3Store({ bucket: process.env.NOYDB_S3_BACKUP! }),       role: 'backup',    label: 'team-backup' },`,\n        `    { store: awsS3Store({ bucket: process.env.NOYDB_S3_ARCHIVE! }),      role: 'archive',   label: 'team-archive' },`,\n        `  ],`,\n        `  user:   process.env.NOYDB_USER ?? 'member',`,\n        `  secret: process.env.NOYDB_SECRET,`,\n        `}`,\n      ].join('\\n'),\n      env: `NOYDB_USER=member\\nNOYDB_SECRET=\\nNOYDB_APP=team\\nNOYDB_DYNAMO_TABLE=team-hot\\nNOYDB_S3_BACKUP=team-backup\\nNOYDB_S3_ARCHIVE=team-archive\\n`,\n    }\n    case 'F': return {\n      profile, notes: 'CRDT collaboration — Yjs-backed shared records over the encrypted envelope.',\n      code: [\n        `import { createNoydb } from '@noy-db/hub'`,\n        `import { browserIdbStore } from '@noy-db/to-browser-idb'`,\n        `import { awsDynamoStore } from '@noy-db/to-aws-dynamo'`,\n        `// import { yjsCollection } from '@noy-db/in-yjs'   // use inside your app`,\n        ``,\n        `export default {`,\n        `  store: browserIdbStore({ prefix: 'collab' }),`,\n        `  sync: [{ store: awsDynamoStore({ table: process.env.NOYDB_DYNAMO_TABLE! }), role: 'sync-peer' }],`,\n        `  user:   process.env.NOYDB_USER!,`,\n        `  secret: process.env.NOYDB_SECRET,`,\n        `}`,\n        ``,\n        `// After createNoydb(), replace normal collections with yjsCollection() for CRDT fields.`,\n      ].join('\\n'),\n      env: `NOYDB_USER=\\nNOYDB_SECRET=\\nNOYDB_DYNAMO_TABLE=collab-live\\n`,\n    }\n    case 'H': return {\n      profile, notes: 'USB-portable — everything on a single file store, no cloud.',\n      code: [\n        `import { createNoydb } from '@noy-db/hub'`,\n        `import { jsonFile } from '@noy-db/to-file'`,\n        ``,\n        `export default {`,\n        `  store:  jsonFile({ dir: process.env.NOYDB_DATA_DIR ?? '/Volumes/MY_USB/data' }),`,\n        `  user:   process.env.NOYDB_USER!,`,\n        `  secret: process.env.NOYDB_SECRET,`,\n        `}`,\n      ].join('\\n'),\n      env: `NOYDB_USER=\\nNOYDB_SECRET=\\nNOYDB_DATA_DIR=/Volumes/MY_USB/data\\n`,\n    }\n    case 'I': return {\n      profile, notes: 'Multi-tenant geographic sharding — per-vault primary per region.',\n      code: [\n        `import { createNoydb } from '@noy-db/hub'`,\n        `import { awsDynamoStore } from '@noy-db/to-aws-dynamo'`,\n        ``,\n        `// Pick the nearest region at init time based on tenant config.`,\n        `const region = process.env.NOYDB_REGION ?? 'ap-southeast-1'`,\n        `const table  = \\`myapp-\\${region}\\``,\n        ``,\n        `export default {`,\n        `  store:  awsDynamoStore({ table, region }),`,\n        `  user:   process.env.NOYDB_USER!,`,\n        `  secret: process.env.NOYDB_SECRET,`,\n        `}`,\n      ].join('\\n'),\n      env: `NOYDB_USER=\\nNOYDB_SECRET=\\nNOYDB_REGION=ap-southeast-1\\n`,\n    }\n    case 'J': return {\n      profile, notes: 'Authentication bridge (passphrase-less unlock via OIDC or WebAuthn).',\n      code: [\n        `import { createNoydb } from '@noy-db/hub'`,\n        `import { browserIdbStore } from '@noy-db/to-browser-idb'`,\n        `// import { unlockWebAuthn } from '@noy-db/on-webauthn'   // in the browser`,\n        `// import { keyConnector } from '@noy-db/on-oidc'         // in a server app`,\n        ``,\n        `export default {`,\n        `  store: browserIdbStore({ prefix: process.env.NOYDB_APP ?? 'app' }),`,\n        `  user:  process.env.NOYDB_USER!,`,\n        `  // secret supplied by the unlock method at openVault() time, not here.`,\n        `}`,\n      ].join('\\n'),\n      env: `NOYDB_USER=\\nNOYDB_APP=app\\n`,\n    }\n  }\n}\n\nexport async function runConfigScaffold(argv: readonly string[]): Promise<number> {\n  const profileArg = argv.find((a) => a.startsWith('--profile='))\n  const profile = (profileArg?.split('=')[1] ?? 'A') as Profile\n  if (!/^[A-J]$/.test(profile)) {\n    process.stderr.write(`unknown profile: ${profile}. Valid: A-J (see docs/guides/topology-matrix.md)\\n`)\n    return 2\n  }\n  const out = scaffold(profile)\n  process.stdout.write(`// ── noydb config (profile ${out.profile}) ───────────────────\\n`)\n  process.stdout.write(`// ${out.notes}\\n\\n`)\n  process.stdout.write(out.code + '\\n\\n')\n  if (out.env) {\n    process.stdout.write(`// ── .env template ───────────────────────────────────────\\n`)\n    process.stdout.write(out.env)\n  }\n  return 0\n}\n\n// ── Helpers ─────────────────────────────────────────────────────────────\n\nfunction isRecord(v: unknown): v is Record<string, unknown> {\n  return typeof v === 'object' && v !== null && !Array.isArray(v)\n}\n\nfunction isStoreShape(v: unknown): boolean {\n  if (!isRecord(v)) return false\n  return ['get', 'put', 'delete', 'list', 'loadAll', 'saveAll']\n    .every((m) => typeof v[m] === 'function')\n}\n\nfunction normalizeSync(v: unknown): unknown[] {\n  if (Array.isArray(v)) return v\n  return [v]\n}\n\nfunction validateTarget(t: unknown, path: string, issues: ValidationIssue[]): void {\n  if (!isRecord(t)) {\n    issues.push({ severity: 'error', code: 'bad-target', path,\n      message: 'sync target must be an object with { store, role }' })\n    return\n  }\n  if (t['role'] === undefined) {\n    // Bare store is allowed — core wraps it as { store, role: 'sync-peer' }\n    if (!isStoreShape(t)) {\n      issues.push({ severity: 'error', code: 'bad-store-shape', path,\n        message: 'sync target store does not expose the 6-method contract' })\n    }\n    return\n  }\n  const validRoles = ['sync-peer', 'backup', 'archive']\n  if (!validRoles.includes(safeStringify(t['role']))) {\n    issues.push({ severity: 'error', code: 'bad-role', path: `${path}.role`,\n      message: `role must be one of ${validRoles.join(', ')}; got ${safeStringify(t['role'])}` })\n  }\n  if (!t['store'] || !isStoreShape(t['store'])) {\n    issues.push({ severity: 'error', code: 'bad-store-shape', path: `${path}.store`,\n      message: 'sync target store does not expose the 6-method contract' })\n  }\n  if (t['role'] === 'archive' && isRecord(t['policy']) && isRecord(t['policy']['pull'])) {\n    issues.push({ severity: 'error', code: 'archive-pull-configured', path: `${path}.policy.pull`,\n      message: 'archive targets are push-only — pull policy is invalid' })\n  }\n}\n","/**\n * `noydb monitor <config.ts>` — live text dashboard of store metrics.\n *\n * Loads a `NoydbOptions` from a config file, wraps the primary store\n * in `@noy-db/to-meter`, creates a `Noydb` instance, and prints a\n * refreshing snapshot to stdout at a configurable interval. Ctrl-C\n * to stop.\n *\n * This is the scope of issue  — CLI-first. A web dashboard\n * is deferred: the meter handle already exposes everything a dashboard\n * needs via `snapshot()` + `subscribe()`.\n *\n * @module\n */\nimport { toMeter } from '@noy-db/to-meter'\nimport type { MeterSnapshot } from '@noy-db/to-meter'\nimport { loadOptionsFromFile } from './config.js'\n\nexport interface MonitorOptions {\n  intervalMs: number\n  iterations?: number    // undefined → run forever\n}\n\nexport async function runMonitor(argv: readonly string[]): Promise<number> {\n  const file = argv[0]\n  if (!file) {\n    process.stderr.write('usage: noydb monitor <config.ts> [--interval=ms]\\n')\n    return 2\n  }\n\n  const intervalArg = argv.find((a) => a.startsWith('--interval='))\n  const intervalMs = intervalArg ? parseInt(intervalArg.split('=')[1] ?? '5000', 10) : 5_000\n\n  let opts: Record<string, unknown>\n  try {\n    const loaded = await loadOptionsFromFile(file)\n    if (typeof loaded !== 'object' || loaded === null) {\n      process.stderr.write(`config file must export a NoydbOptions-shaped object\\n`)\n      return 1\n    }\n    opts = loaded as Record<string, unknown>\n  } catch (err) {\n    process.stderr.write(`failed to load ${file}: ${(err as Error).message}\\n`)\n    return 1\n  }\n\n  const innerStore = opts['store']\n  if (!innerStore || typeof innerStore !== 'object') {\n    process.stderr.write('config has no `store` — nothing to monitor\\n')\n    return 1\n  }\n\n  const { store: metered, meter } = toMeter(innerStore as never, {\n    degradedMs: 500,\n    onDegraded: (e) => process.stderr.write(`DEGRADED: ${e.reason}\\n`),\n    onRestored: (e) => process.stderr.write(`RESTORED: ${e.reason}\\n`),\n  })\n\n  // Replace the store in the options object so the Noydb instance\n  // goes through the meter.\n  const liveOpts = { ...opts, store: metered } as Record<string, unknown>\n\n  // Dynamically import hub so the CLI doesn't need to bundle it at\n  // build time. Adopter's installed @noy-db/hub version wins.\n  const hub = await import('@noy-db/hub') as { createNoydb: (o: unknown) => Promise<unknown> }\n  await hub.createNoydb(liveOpts)\n\n  process.stdout.write(`monitoring ${file} — interval ${intervalMs}ms — Ctrl-C to stop\\n\\n`)\n\n  const stop = installSigintHandler(meter)\n\n  return new Promise<number>((resolveP) => {\n    const timer = setInterval(() => {\n      if (stop.signalled) {\n        clearInterval(timer)\n        meter.close()\n        resolveP(0)\n        return\n      }\n      const snap = meter.snapshot()\n      process.stdout.write(formatSnapshot(snap) + '\\n')\n    }, intervalMs)\n  })\n}\n\nfunction installSigintHandler(meter: { close(): void }): { signalled: boolean } {\n  const state = { signalled: false }\n  const handler = () => { state.signalled = true; meter.close() }\n  process.on('SIGINT', handler)\n  process.on('SIGTERM', handler)\n  return state\n}\n\nexport function formatSnapshot(snap: MeterSnapshot): string {\n  const lines: string[] = []\n  const ts = new Date(snap.collectedAt).toISOString().slice(11, 19)\n  lines.push(`[${ts}] status=${snap.status} calls=${snap.totalCalls} casConflicts=${snap.casConflicts} windowMs=${snap.windowMs}`)\n  for (const m of ['get', 'put', 'delete', 'list', 'loadAll', 'saveAll'] as const) {\n    const s = snap.byMethod[m]\n    if (s.count === 0) continue\n    lines.push(`  ${m.padEnd(7)} count=${s.count} errors=${s.errors} p50=${s.p50}ms p99=${s.p99}ms max=${s.max}ms avg=${s.avg}ms`)\n  }\n  return lines.join('\\n')\n}\n"],"mappings":"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","names":["import_hub","import_promises"]}

package/dist/index.d.cts

@@ -0,0 +1,68 @@
+import { MeterSnapshot } from '@noy-db/to-meter';
+
+interface InspectResult {
+    formatVersion: number;
+    handle: string;
+    bodyBytes: number;
+    bodySha256: string;
+}
+declare function inspect(filePath: string): Promise<InspectResult>;
+declare function runInspect(argv: readonly string[]): Promise<number>;
+
+interface VerifyReport {
+    ok: boolean;
+    file: string;
+    handle: string;
+    bodyBytes: number;
+    checks: {
+        magic: boolean;
+        header: boolean;
+        bodyHash: boolean;
+    };
+    error?: string;
+}
+declare function verify(filePath: string): Promise<VerifyReport>;
+declare function runVerify(argv: readonly string[]): Promise<number>;
+
+interface ValidationIssue {
+    severity: 'warn' | 'error';
+    code: string;
+    path: string;
+    message: string;
+}
+interface ValidationReport {
+    ok: boolean;
+    issues: ValidationIssue[];
+}
+declare function validateOptions(opts: unknown): ValidationReport;
+/** Dynamically import a JS/MJS/CJS config file and pull the NoydbOptions
+ *  out of it. Accepts a default export that is either the options
+ *  object or a zero-arg function (sync or async) returning the options.
+ *
+ *  **TypeScript note.** Node cannot `import()` a bare `.ts` file without
+ *  a loader. If the adopter's config is TypeScript, they should either
+ *  compile it first (`tsc foo.ts`) or run the CLI under a TS-capable
+ *  runtime (e.g. `tsx $(which noydb) config validate foo.ts`). The
+ *  function throws a human-readable error for `.ts` input rather than
+ *  propagating Node's cryptic `Unknown file extension` message. */
+declare function loadOptionsFromFile(filePath: string): Promise<unknown>;
+declare function runConfigValidate(argv: readonly string[]): Promise<number>;
+/** Profiles match `docs/guides/topology-matrix.md` § View 3. */
+type Profile = 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J';
+interface ScaffoldResult {
+    profile: Profile;
+    code: string;
+    env: string;
+    notes: string;
+}
+declare function scaffold(profile: Profile): ScaffoldResult;
+declare function runConfigScaffold(argv: readonly string[]): Promise<number>;
+
+interface MonitorOptions {
+    intervalMs: number;
+    iterations?: number;
+}
+declare function runMonitor(argv: readonly string[]): Promise<number>;
+declare function formatSnapshot(snap: MeterSnapshot): string;
+
+export { type InspectResult, type MonitorOptions, type Profile, type ScaffoldResult, type ValidationIssue, type ValidationReport, type VerifyReport, formatSnapshot, inspect, loadOptionsFromFile, runConfigScaffold, runConfigValidate, runInspect, runMonitor, runVerify, scaffold, validateOptions, verify };

package/dist/index.d.ts

@@ -0,0 +1,68 @@
+import { MeterSnapshot } from '@noy-db/to-meter';
+
+interface InspectResult {
+    formatVersion: number;
+    handle: string;
+    bodyBytes: number;
+    bodySha256: string;
+}
+declare function inspect(filePath: string): Promise<InspectResult>;
+declare function runInspect(argv: readonly string[]): Promise<number>;
+
+interface VerifyReport {
+    ok: boolean;
+    file: string;
+    handle: string;
+    bodyBytes: number;
+    checks: {
+        magic: boolean;
+        header: boolean;
+        bodyHash: boolean;
+    };
+    error?: string;
+}
+declare function verify(filePath: string): Promise<VerifyReport>;
+declare function runVerify(argv: readonly string[]): Promise<number>;
+
+interface ValidationIssue {
+    severity: 'warn' | 'error';
+    code: string;
+    path: string;
+    message: string;
+}
+interface ValidationReport {
+    ok: boolean;
+    issues: ValidationIssue[];
+}
+declare function validateOptions(opts: unknown): ValidationReport;
+/** Dynamically import a JS/MJS/CJS config file and pull the NoydbOptions
+ *  out of it. Accepts a default export that is either the options
+ *  object or a zero-arg function (sync or async) returning the options.
+ *
+ *  **TypeScript note.** Node cannot `import()` a bare `.ts` file without
+ *  a loader. If the adopter's config is TypeScript, they should either
+ *  compile it first (`tsc foo.ts`) or run the CLI under a TS-capable
+ *  runtime (e.g. `tsx $(which noydb) config validate foo.ts`). The
+ *  function throws a human-readable error for `.ts` input rather than
+ *  propagating Node's cryptic `Unknown file extension` message. */
+declare function loadOptionsFromFile(filePath: string): Promise<unknown>;
+declare function runConfigValidate(argv: readonly string[]): Promise<number>;
+/** Profiles match `docs/guides/topology-matrix.md` § View 3. */
+type Profile = 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J';
+interface ScaffoldResult {
+    profile: Profile;
+    code: string;
+    env: string;
+    notes: string;
+}
+declare function scaffold(profile: Profile): ScaffoldResult;
+declare function runConfigScaffold(argv: readonly string[]): Promise<number>;
+
+interface MonitorOptions {
+    intervalMs: number;
+    iterations?: number;
+}
+declare function runMonitor(argv: readonly string[]): Promise<number>;
+declare function formatSnapshot(snap: MeterSnapshot): string;
+
+export { type InspectResult, type MonitorOptions, type Profile, type ScaffoldResult, type ValidationIssue, type ValidationReport, type VerifyReport, formatSnapshot, inspect, loadOptionsFromFile, runConfigScaffold, runConfigValidate, runInspect, runMonitor, runVerify, scaffold, validateOptions, verify };