257 lines
9.8 KiB
TypeScript
257 lines
9.8 KiB
TypeScript
import type { Command } from 'commander';
|
|
|
|
/**
|
|
* Reads the DATABASE_URL environment variable and redacts the password portion.
|
|
*/
|
|
function redactedConnectionString(): string | null {
|
|
const url = process.env['DATABASE_URL'];
|
|
if (!url) return null;
|
|
try {
|
|
const parsed = new URL(url);
|
|
if (parsed.password) {
|
|
parsed.password = '***';
|
|
}
|
|
return parsed.toString();
|
|
} catch {
|
|
// Not a valid URL — redact anything that looks like :password@
|
|
return url.replace(/:([^@/]+)@/, ':***@');
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Determine the active storage tier from the environment.
|
|
* Looks at DATABASE_URL; if absent or set to a pglite path, treats tier as pglite.
|
|
*/
|
|
function activeTier(): 'postgres' | 'pglite' {
|
|
const url = process.env['DATABASE_URL'];
|
|
if (url && url.startsWith('postgres')) return 'postgres';
|
|
return 'pglite';
|
|
}
|
|
|
|
/**
|
|
* Return a human-readable config source description.
|
|
*/
|
|
function configSource(): string {
|
|
if (process.env['DATABASE_URL']) return 'env:DATABASE_URL';
|
|
const pgliteDir = process.env['PGLITE_DATA_DIR'];
|
|
if (pgliteDir) return `env:PGLITE_DATA_DIR (${pgliteDir})`;
|
|
return 'default (no DATABASE_URL set)';
|
|
}
|
|
|
|
/**
|
|
* Register storage subcommands on an existing Commander program.
|
|
* Follows the registerQualityRails pattern — uses the caller's Command
|
|
* instance to avoid cross-package Commander version mismatches.
|
|
*/
|
|
export function registerStorageCommand(parent: Command): void {
|
|
const storage = parent
|
|
.command('storage')
|
|
.description('Inspect and manage Mosaic storage configuration');
|
|
|
|
// ── storage status ───────────────────────────────────────────────────────
|
|
|
|
storage
|
|
.command('status')
|
|
.description('Show the configured storage tier and whether the adapter is reachable')
|
|
.action(async () => {
|
|
const tier = activeTier();
|
|
const source = configSource();
|
|
const connStr = tier === 'postgres' ? redactedConnectionString() : null;
|
|
|
|
console.log(`[storage] tier: ${tier}`);
|
|
console.log(`[storage] config source: ${source}`);
|
|
|
|
if (tier === 'postgres' && connStr) {
|
|
console.log(`[storage] connection: ${connStr}`);
|
|
try {
|
|
const { createDb, sql } = await import('@mosaicstack/db');
|
|
const url = process.env['DATABASE_URL'] ?? '';
|
|
const handle = createDb(url);
|
|
await handle.db.execute(sql`SELECT 1`);
|
|
await handle.close();
|
|
console.log('[storage] reachable: yes');
|
|
} catch (err) {
|
|
console.log(
|
|
`[storage] reachable: no (${err instanceof Error ? err.message : String(err)})`,
|
|
);
|
|
}
|
|
} else {
|
|
const dataDir = process.env['PGLITE_DATA_DIR'] ?? ':memory:';
|
|
console.log(`[storage] data dir: ${dataDir}`);
|
|
console.log('[storage] reachable: pglite is always local — no network check needed');
|
|
}
|
|
});
|
|
|
|
// ── storage tier ─────────────────────────────────────────────────────────
|
|
|
|
const tier = storage.command('tier').description('Inspect or switch the storage tier');
|
|
|
|
tier
|
|
.command('show')
|
|
.description('Print the active storage tier and its config source')
|
|
.action(() => {
|
|
const activeTierValue = activeTier();
|
|
const source = configSource();
|
|
console.log(`[storage] active tier: ${activeTierValue}`);
|
|
console.log(`[storage] config source: ${source}`);
|
|
});
|
|
|
|
tier
|
|
.command('switch <tier>')
|
|
.description('Switch storage tier between pglite and postgres')
|
|
.action((newTier: string) => {
|
|
const validTiers = ['pglite', 'postgres'];
|
|
if (!validTiers.includes(newTier)) {
|
|
console.error(
|
|
`[storage] unknown tier: ${newTier}. Valid options: ${validTiers.join(', ')}`,
|
|
);
|
|
process.exitCode = 1;
|
|
return;
|
|
}
|
|
|
|
console.log(`[storage] tier switch requested: ${newTier}`);
|
|
console.log('');
|
|
console.log('Mosaic storage tier is controlled by environment variables.');
|
|
console.log('Automatic config-file mutation is not supported — set the variable manually.');
|
|
console.log('');
|
|
|
|
if (newTier === 'postgres') {
|
|
console.log('To switch to postgres:');
|
|
console.log(' 1. Set DATABASE_URL in your environment or .env file:');
|
|
console.log(' export DATABASE_URL="postgresql://user:pass@localhost:5432/mosaic"');
|
|
console.log(' 2. Run migrations:');
|
|
console.log(' pnpm --filter @mosaicstack/db db:migrate');
|
|
console.log(' 3. Restart the gateway.');
|
|
} else {
|
|
console.log('To switch to pglite:');
|
|
console.log(' 1. Unset DATABASE_URL (or set it to a pglite path):');
|
|
console.log(' unset DATABASE_URL');
|
|
console.log(' # optionally: export PGLITE_DATA_DIR=/path/to/pglite/data');
|
|
console.log(' 2. Restart the gateway.');
|
|
console.log(' Note: pglite uses an in-process database — no migrations needed.');
|
|
}
|
|
});
|
|
|
|
// ── storage export ───────────────────────────────────────────────────────
|
|
|
|
storage
|
|
.command('export <path>')
|
|
.description('Dump the active storage contents to a file')
|
|
.action((outputPath: string) => {
|
|
const currentTier = activeTier();
|
|
|
|
if (currentTier === 'postgres') {
|
|
const redacted = redactedConnectionString() ?? '<DATABASE_URL>';
|
|
console.log('[storage] export for postgres tier');
|
|
console.log('');
|
|
console.log('postgres export is not yet wired in the CLI — use pg_dump directly:');
|
|
console.log('');
|
|
console.log(` pg_dump "${redacted}" > ${outputPath}`);
|
|
console.log('');
|
|
console.log('Or with Docker:');
|
|
console.log(
|
|
` docker exec <postgres-container> pg_dump -U <user> <dbname> > ${outputPath}`,
|
|
);
|
|
process.exitCode = 0;
|
|
} else {
|
|
const dataDir = process.env['PGLITE_DATA_DIR'];
|
|
console.log('[storage] export for pglite tier');
|
|
console.log('');
|
|
console.log(
|
|
'pglite export is not yet wired in the CLI — copy the data directory directly:',
|
|
);
|
|
console.log('');
|
|
if (dataDir) {
|
|
console.log(` cp -r ${dataDir} ${outputPath}`);
|
|
} else {
|
|
console.log(
|
|
' PGLITE_DATA_DIR is not set; the database is in-memory and cannot be exported.',
|
|
);
|
|
console.log(' Set PGLITE_DATA_DIR to a persistent path before running export.');
|
|
}
|
|
process.exitCode = 0;
|
|
}
|
|
});
|
|
|
|
// ── storage import ───────────────────────────────────────────────────────
|
|
|
|
storage
|
|
.command('import <path>')
|
|
.description('Restore storage contents from a previously exported file')
|
|
.action((inputPath: string) => {
|
|
const currentTier = activeTier();
|
|
|
|
if (currentTier === 'postgres') {
|
|
const redacted = redactedConnectionString() ?? '<DATABASE_URL>';
|
|
console.log('[storage] import for postgres tier');
|
|
console.log('');
|
|
console.log('postgres import is not yet wired in the CLI — use psql directly:');
|
|
console.log('');
|
|
console.log(` psql "${redacted}" < ${inputPath}`);
|
|
process.exitCode = 0;
|
|
} else {
|
|
const dataDir = process.env['PGLITE_DATA_DIR'];
|
|
console.log('[storage] import for pglite tier');
|
|
console.log('');
|
|
console.log(
|
|
'pglite import is not yet wired in the CLI — restore the data directory directly:',
|
|
);
|
|
console.log('');
|
|
if (dataDir) {
|
|
console.log(` rm -rf ${dataDir} && cp -r ${inputPath} ${dataDir}`);
|
|
console.log(' Then restart the gateway.');
|
|
} else {
|
|
console.log(
|
|
' PGLITE_DATA_DIR is not set; set it to a persistent path before running import.',
|
|
);
|
|
}
|
|
process.exitCode = 0;
|
|
}
|
|
});
|
|
|
|
// ── storage migrate ──────────────────────────────────────────────────────
|
|
|
|
storage
|
|
.command('migrate')
|
|
.description(
|
|
'Run database migrations (thin wrapper — delegates to pnpm db:migrate or prints the command)',
|
|
)
|
|
.option('--run', 'Actually execute the migration command via shell')
|
|
.action(async (opts: { run?: boolean }) => {
|
|
const currentTier = activeTier();
|
|
|
|
if (currentTier === 'pglite') {
|
|
console.log('[storage] pglite tier detected');
|
|
console.log(
|
|
'pglite runs schema setup automatically on first connection via adapter.migrate().',
|
|
);
|
|
console.log('No separate migration step is required.');
|
|
return;
|
|
}
|
|
|
|
const migrateCmd = 'pnpm --filter @mosaicstack/db db:migrate';
|
|
console.log('[storage] postgres tier detected');
|
|
console.log(`Migration command: ${migrateCmd}`);
|
|
console.log('');
|
|
|
|
if (opts.run) {
|
|
console.log('Running migrations...');
|
|
const { execSync } = await import('node:child_process');
|
|
try {
|
|
execSync(migrateCmd, { stdio: 'inherit' });
|
|
console.log('[storage] migrations complete.');
|
|
} catch (err) {
|
|
console.error(
|
|
`[storage] migration failed: ${err instanceof Error ? err.message : String(err)}`,
|
|
);
|
|
process.exitCode = 1;
|
|
}
|
|
} else {
|
|
console.log('To run migrations, execute:');
|
|
console.log(` ${migrateCmd}`);
|
|
console.log('');
|
|
console.log('Or pass --run to have this command execute it for you.');
|
|
}
|
|
});
|
|
}
|