@tryhuset/foundation-utils 4.84.2

package/README.md

@@ -0,0 +1,117 @@
+# @tryhuset/foundation-utils
+
+Public utility CLI tools for Foundation server framework. Provides generic tools for database and Docker management that can be installed without GitHub Personal Access Tokens.
+
+## Installation
+
+```bash
+npm install -g @tryhuset/foundation-utils
+```
+
+## Usage
+
+### Database management
+
+```bash
+foundation-utils db list      # List sessions
+foundation-utils db restore   # Restore a session by ID (ends current active if any)
+foundation-utils db export    # Export database to mongodump backup
+foundation-utils db import    # Import database from mongodump backup
+foundation-utils db end       # End all active sessions
+```
+
+Requires `STORAGE_URL` environment variable. Use `-e, --env <path>` to load from a .env file.
+
+**db list** – List sessions (default 50, newest first). Use `-a, --active` for active only, `-l, --limit <n>` to change limit.
+
+**db restore** – Restore a session by ID. Ends the current active session if one exists. Requires `-i, --id <sessionId>`. Restart the server to pick up the restored session.
+
+**db export** – Create mongodump backup. Requires `-o, --out <path>` for output directory.
+
+**db import** – Import from mongodump backup. Requires `-p, --path <path>` to dump directory.
+
+**db end** – Ends all sessions by updating endedAt with `null` to have the current date.
+
+### Docker Compose management
+
+Uses `./compose.yaml` by default. Override with `-f, --file <path>`.
+
+```bash
+# Update images with backup (default: ./compose.yaml)
+foundation-utils docker update
+
+# Create backup only
+foundation-utils docker backup
+
+# Restore stack from a backup compose file (from docker backup output)
+foundation-utils docker backup --restore ./docker_image_backups/docker-compose_20260101T120000.yaml
+
+# Update without backup
+foundation-utils docker update --no-backup
+
+# Force without confirmation (e.g. restore)
+foundation-utils docker backup --restore ./docker_image_backups/docker-compose_20260101T120000.yaml --force
+foundation-utils docker update --force
+
+# Restart a specific service
+foundation-utils docker restart -s <service-name>
+
+# List containers (docker compose ps)
+foundation-utils docker list
+```
+
+## Programmatic Usage
+
+```typescript
+import { Command } from 'commander';
+import {
+  registerCommands,
+  dbEnd,
+  dbExport,
+  dbImport,
+  dbList,
+  dbRestore,
+  dockerBackup,
+  dockerList,
+  dockerRestart,
+  dockerUpdate
+} from '@tryhuset/foundation-utils';
+
+// Attach all db + docker subcommands to a Commander program
+const program = new Command();
+registerCommands(program);
+
+// End all active sessions
+await dbEnd();
+
+// List sessions
+await dbList({ active: true });
+
+// Restore a session by ID
+await dbRestore({ sessionId: 'abc123', force: true });
+
+// Export database backup
+await dbExport({ path: './backup' });
+
+// Import from backup
+await dbImport({ path: './backup' });
+
+// Create backup only
+await dockerBackup();
+
+// Update Docker images (default: ./compose.yaml)
+await dockerUpdate({ force: true });
+
+// Restore stack from backup compose file (same as: docker backup --restore <path>)
+await dockerUpdate({ backupFile: './docker_image_backups/docker-compose_20260101T120000.yaml', force: true });
+
+// Restart a service
+await dockerRestart({ service: 'api' });
+
+// List containers
+await dockerList();
+```
+
+## License
+
+MIT

package/dist/jest.config.d.ts

@@ -0,0 +1,3 @@
+import type { Config } from '@jest/types';
+declare const config: Config.InitialOptions;
+export default config;

package/dist/jest.config.js

@@ -0,0 +1,33 @@
+const config = {
+    preset: 'ts-jest/presets/default-esm',
+    roots: ['<rootDir>/src'],
+    collectCoverageFrom: [
+        './src/**/*',
+        '!**/coverage/**',
+        '!**/node_modules/**',
+        '!*.config.js',
+        '!**/__tests__/**'
+    ],
+    testMatch: ['**/*.spec.ts'],
+    transform: {
+        '^.+\\.m?ts$': [
+            'ts-jest',
+            {
+                useESM: true,
+                tsconfig: 'tsconfig.spec.json'
+            }
+        ]
+    },
+    extensionsToTreatAsEsm: ['.ts', '.tsx'],
+    transformIgnorePatterns: ['node_modules/(?!(#ansi-styles|#supports-color|#has-flag|#chalk)/)'],
+    moduleNameMapper: {
+        '^(\\.{1,2}/.*)\\.js$': '$1'
+    },
+    moduleDirectories: ['node_modules', '../../node_modules', 'src'],
+    moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node', 'mjs'],
+    verbose: true,
+    forceExit: true,
+    testTimeout: 30000
+};
+export default config;
+//# sourceMappingURL=jest.config.js.map

package/dist/jest.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jest.config.js","sourceRoot":"","sources":["../jest.config.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAA0B;IACpC,MAAM,EAAE,6BAA6B;IACrC,KAAK,EAAE,CAAC,eAAe,CAAC;IACxB,mBAAmB,EAAE;QACnB,YAAY;QACZ,iBAAiB;QACjB,qBAAqB;QACrB,cAAc;QACd,kBAAkB;KACnB;IACD,SAAS,EAAE,CAAC,cAAc,CAAC;IAC3B,SAAS,EAAE;QACT,aAAa,EAAE;YACb,SAAS;YACT;gBACE,MAAM,EAAE,IAAI;gBACZ,QAAQ,EAAE,oBAAoB;aAC/B;SACF;KACF;IACD,sBAAsB,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;IACvC,uBAAuB,EAAE,CAAC,mEAAmE,CAAC;IAC9F,gBAAgB,EAAE;QAChB,sBAAsB,EAAE,IAAI;KAC7B;IACD,iBAAiB,EAAE,CAAC,cAAc,EAAE,oBAAoB,EAAE,KAAK,CAAC;IAChE,oBAAoB,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC;IACvE,OAAO,EAAE,IAAI;IACb,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,KAAK;CACnB,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/src/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/src/cli.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { readFileSync } from 'fs';
+import { Command } from 'commander';
+import { registerCommands } from './commands/index.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', '..', 'package.json'), 'utf-8'));
+const program = new Command();
+program
+    .name('foundation-utils')
+    .description('Utility CLI tools for Foundation server framework')
+    .version(pkg.version);
+registerCommands(program);
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAElC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AACtC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AAE3F,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,kBAAkB,CAAC;KACxB,WAAW,CAAC,mDAAmD,CAAC;KAChE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAExB,gBAAgB,CAAC,OAAO,CAAC,CAAC;AAC1B,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/src/commands/db/end.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Ends all active sessions in the Foundation database by updating
+ * sessions with null endedAt to have the current date.
+ * @param [options] Optional settings.
+ * @param [options.env] Path to .env file to load before reading STORAGE_URL.
+ */
+export declare const dbEnd: (options?: {
+    env?: string;
+}) => Promise<void>;

package/dist/src/commands/db/end.js

@@ -0,0 +1,52 @@
+/**
+ * Handles managing the Foundation database.
+ * This command will handle any necessary database operations.
+ *
+ * Currently supports:
+ * - Updating sessions with null endedAt to have the current date
+ */
+import { MongoClient } from 'mongodb';
+import inquirer from 'inquirer';
+import { exitProcess } from '../../utils/processExit.js';
+import { loadEnv } from '../../utils/loadEnv.js';
+import { getDbConfig } from '../../utils/dbConfig.js';
+/**
+ * Ends all active sessions in the Foundation database by updating
+ * sessions with null endedAt to have the current date.
+ * @param [options] Optional settings.
+ * @param [options.env] Path to .env file to load before reading STORAGE_URL.
+ */
+export const dbEnd = async (options) => {
+    loadEnv(options?.env);
+    const { storageUrl, dbCollection } = getDbConfig();
+    if (!storageUrl) {
+        console.error('STORAGE_URL environment variable not set');
+        exitProcess(1);
+    }
+    try {
+        const { confirm } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'confirm',
+                message: 'This will update all sessions with null endedAt to have the current date. Continue?',
+                default: false
+            }
+        ]);
+        if (!confirm) {
+            console.log('Operation cancelled');
+            exitProcess(0);
+        }
+        const client = await MongoClient.connect(storageUrl);
+        const db = client.db();
+        const result = await db
+            .collection(dbCollection)
+            .updateMany({ endedAt: null }, { $set: { endedAt: new Date() } });
+        console.log(`Updated ${result.modifiedCount} sessions`);
+        await client.close();
+    }
+    catch (error) {
+        console.error('Failed to update sessions:', error);
+        exitProcess(1);
+    }
+};
+//# sourceMappingURL=end.js.map

package/dist/src/commands/db/end.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"end.js","sourceRoot":"","sources":["../../../../src/commands/db/end.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,QAAQ,MAAM,UAAU,CAAC;AAEhC,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,EAAE,OAA0B,EAAE,EAAE;IACxD,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACtB,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,WAAW,EAAE,CAAC;IAEnD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC1D,WAAW,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;YACxC;gBACE,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,SAAS;gBACf,OAAO,EACL,qFAAqF;gBACvF,OAAO,EAAE,KAAK;aACf;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;YACnC,WAAW,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,UAAW,CAAC,CAAC;QACtD,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,EAAE,CAAC;QAEvB,MAAM,MAAM,GAAG,MAAM,EAAE;aACpB,UAAU,CAAC,YAAY,CAAC;aACxB,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAEpE,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,aAAa,WAAW,CAAC,CAAC;QACxD,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;QACnD,WAAW,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;AACH,CAAC,CAAC"}

package/dist/src/commands/db/export.d.ts

@@ -0,0 +1,13 @@
+interface DbExportOptions {
+    env?: string;
+    path: string;
+}
+/**
+ * Exports the database to a mongodump backup directory.
+ * Requires mongodump to be installed (MongoDB Database Tools).
+ * @param options Export options.
+ * @param [options.env] Path to .env file.
+ * @param options.path Output directory for the dump.
+ */
+export declare const dbExport: (options: DbExportOptions) => Promise<void>;
+export {};

package/dist/src/commands/db/export.js

@@ -0,0 +1,39 @@
+/**
+ * Exports the Foundation database to a mongodump backup.
+ */
+import { execFileSync } from 'child_process';
+import { mkdirSync, existsSync } from 'fs';
+import { exitProcess } from '../../utils/processExit.js';
+import { loadEnv } from '../../utils/loadEnv.js';
+import { getDbConfig } from '../../utils/dbConfig.js';
+/**
+ * Exports the database to a mongodump backup directory.
+ * Requires mongodump to be installed (MongoDB Database Tools).
+ * @param options Export options.
+ * @param [options.env] Path to .env file.
+ * @param options.path Output directory for the dump.
+ */
+export const dbExport = async (options) => {
+    loadEnv(options?.env);
+    const { storageUrl } = getDbConfig();
+    if (!storageUrl) {
+        console.error('STORAGE_URL environment variable not set');
+        exitProcess(1);
+    }
+    const uri = storageUrl;
+    const outPath = options.path;
+    try {
+        if (!existsSync(outPath)) {
+            mkdirSync(outPath, { recursive: true });
+        }
+        execFileSync('mongodump', ['--uri', uri, '--out', outPath], {
+            stdio: 'inherit'
+        });
+        console.log(`Export completed to ${outPath}`);
+    }
+    catch (error) {
+        console.error('Failed to export:', error);
+        exitProcess(1);
+    }
+};
+//# sourceMappingURL=export.js.map

package/dist/src/commands/db/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../../../src/commands/db/export.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAOtD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAAE,OAAwB,EAAE,EAAE;IACzD,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACtB,MAAM,EAAE,UAAU,EAAE,GAAG,WAAW,EAAE,CAAC;IAErC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC1D,WAAW,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IAED,MAAM,GAAG,GAAG,UAAoB,CAAC;IACjC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAE7B,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC;QAED,YAAY,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;YAC1D,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,uBAAuB,OAAO,EAAE,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;QAC1C,WAAW,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;AACH,CAAC,CAAC"}

package/dist/src/commands/db/import.d.ts

@@ -0,0 +1,14 @@
+interface DbImportOptions {
+    env?: string;
+    path: string;
+}
+/**
+ * Imports the database from a mongodump backup directory.
+ * Requires mongorestore to be installed (MongoDB Database Tools).
+ * Always prompts for confirmation.
+ * @param options Import options.
+ * @param [options.env] Path to .env file.
+ * @param options.path Dump directory (mongodump output).
+ */
+export declare const dbImport: (options: DbImportOptions) => Promise<void>;
+export {};

package/dist/src/commands/db/import.js

@@ -0,0 +1,54 @@
+/**
+ * Imports the Foundation database from a mongodump backup.
+ */
+import { execFileSync } from 'child_process';
+import { existsSync } from 'fs';
+import inquirer from 'inquirer';
+import { exitProcess } from '../../utils/processExit.js';
+import { loadEnv } from '../../utils/loadEnv.js';
+import { getDbConfig } from '../../utils/dbConfig.js';
+/**
+ * Imports the database from a mongodump backup directory.
+ * Requires mongorestore to be installed (MongoDB Database Tools).
+ * Always prompts for confirmation.
+ * @param options Import options.
+ * @param [options.env] Path to .env file.
+ * @param options.path Dump directory (mongodump output).
+ */
+export const dbImport = async (options) => {
+    loadEnv(options?.env);
+    const { storageUrl } = getDbConfig();
+    if (!storageUrl) {
+        console.error('STORAGE_URL environment variable not set');
+        exitProcess(1);
+    }
+    const uri = storageUrl;
+    const dumpPath = options.path;
+    if (!existsSync(dumpPath)) {
+        console.error(`Dump path not found: ${dumpPath}`);
+        exitProcess(1);
+    }
+    try {
+        const { confirm } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'confirm',
+                message: `Import database from ${dumpPath}? This will overwrite existing data.`,
+                default: false
+            }
+        ]);
+        if (!confirm) {
+            console.log('Operation cancelled');
+            exitProcess(0);
+        }
+        execFileSync('mongorestore', ['--uri', uri, dumpPath], {
+            stdio: 'inherit'
+        });
+        console.log('Import completed');
+    }
+    catch (error) {
+        console.error('Failed to import:', error);
+        exitProcess(1);
+    }
+};
+//# sourceMappingURL=import.js.map

package/dist/src/commands/db/import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.js","sourceRoot":"","sources":["../../../../src/commands/db/import.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAEhC,OAAO,QAAQ,MAAM,UAAU,CAAC;AAEhC,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAOtD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAAE,OAAwB,EAAE,EAAE;IACzD,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACtB,MAAM,EAAE,UAAU,EAAE,GAAG,WAAW,EAAE,CAAC;IAErC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC1D,WAAW,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IAED,MAAM,GAAG,GAAG,UAAoB,CAAC;IACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAE9B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,wBAAwB,QAAQ,EAAE,CAAC,CAAC;QAClD,WAAW,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;YACxC;gBACE,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,wBAAwB,QAAQ,sCAAsC;gBAC/E,OAAO,EAAE,KAAK;aACf;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;YACnC,WAAW,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;QAED,YAAY,CAAC,cAAc,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE;YACrD,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;QAC1C,WAAW,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;AACH,CAAC,CAAC"}

package/dist/src/commands/db/index.d.ts

@@ -0,0 +1,12 @@
+import type { Command } from 'commander';
+import { dbEnd } from './end.js';
+import { dbExport } from './export.js';
+import { dbImport } from './import.js';
+import { dbList } from './list.js';
+import { dbRestore } from './restore.js';
+export { dbEnd, dbExport, dbImport, dbList, dbRestore };
+/**
+ * Registers `db` subcommands on the given Commander program.
+ * @param program Commander root or parent command.
+ */
+export declare function registerDbCommands(program: Command): void;

package/dist/src/commands/db/index.js

@@ -0,0 +1,50 @@
+import { dbEnd } from './end.js';
+import { dbExport } from './export.js';
+import { dbImport } from './import.js';
+import { dbList } from './list.js';
+import { dbRestore } from './restore.js';
+export { dbEnd, dbExport, dbImport, dbList, dbRestore };
+/**
+ * Registers `db` subcommands on the given Commander program.
+ * @param program Commander root or parent command.
+ */
+export function registerDbCommands(program) {
+    const db = program.command('db').description('Database management');
+    db.command('list')
+        .description('List sessions in the Foundation database')
+        .option('-e, --env <path>', 'Path to .env file')
+        .option('-l, --limit <n>', 'Max sessions to show', '50')
+        .option('-a, --active', 'Only show active sessions')
+        .option('-f, --fields <fields>', 'Additional fields to show (comma-separated, e.g. currentDay,category)')
+        .action((opts) => dbList({
+        ...opts,
+        limit: opts.limit ? parseInt(opts.limit, 10) : undefined,
+        fields: opts.fields
+            ? opts.fields
+                .split(',')
+                .map((s) => s.trim())
+                .filter(Boolean)
+            : undefined
+    }));
+    db.command('restore')
+        .description('Restore a session by ID (ends current active session if any)')
+        .requiredOption('-i, --id <sessionId>', 'Session ID to restore')
+        .option('-e, --env <path>', 'Path to .env file')
+        .option('--force', 'Skip confirmation prompt')
+        .action((opts) => dbRestore({ ...opts, sessionId: opts.id }));
+    db.command('export')
+        .description('Export database to mongodump backup')
+        .requiredOption('-o, --out <path>', 'Output directory for dump')
+        .option('-e, --env <path>', 'Path to .env file')
+        .action(dbExport);
+    db.command('import')
+        .description('Import database from mongodump backup')
+        .requiredOption('-p, --path <path>', 'Path to dump directory')
+        .option('-e, --env <path>', 'Path to .env file')
+        .action(dbImport);
+    db.command('end')
+        .description('End all sessions in the Foundation database')
+        .option('-e, --env <path>', 'Path to .env file')
+        .action(dbEnd);
+}
+//# sourceMappingURL=index.js.map

package/dist/src/commands/db/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/db/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAExD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAEpE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,0CAA0C,CAAC;SACvD,MAAM,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;SAC/C,MAAM,CAAC,iBAAiB,EAAE,sBAAsB,EAAE,IAAI,CAAC;SACvD,MAAM,CAAC,cAAc,EAAE,2BAA2B,CAAC;SACnD,MAAM,CACL,uBAAuB,EACvB,uEAAuE,CACxE;SACA,MAAM,CAAC,CAAC,IAAyE,EAAE,EAAE,CACpF,MAAM,CAAC;QACL,GAAG,IAAI;QACP,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;QACxD,MAAM,EAAE,IAAI,CAAC,MAAM;YACjB,CAAC,CAAC,IAAI,CAAC,MAAM;iBACR,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;iBAC5B,MAAM,CAAC,OAAO,CAAC;YACpB,CAAC,CAAC,SAAS;KACd,CAAC,CACH,CAAC;IAEJ,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,8DAA8D,CAAC;SAC3E,cAAc,CAAC,sBAAsB,EAAE,uBAAuB,CAAC;SAC/D,MAAM,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;SAC/C,MAAM,CAAC,SAAS,EAAE,0BAA0B,CAAC;SAC7C,MAAM,CAAC,CAAC,IAAmD,EAAE,EAAE,CAC9D,SAAS,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAC3C,CAAC;IAEJ,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,qCAAqC,CAAC;SAClD,cAAc,CAAC,kBAAkB,EAAE,2BAA2B,CAAC;SAC/D,MAAM,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;SAC/C,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEpB,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,uCAAuC,CAAC;SACpD,cAAc,CAAC,mBAAmB,EAAE,wBAAwB,CAAC;SAC7D,MAAM,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;SAC/C,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEpB,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,6CAA6C,CAAC;SAC1D,MAAM,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;SAC/C,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC"}

package/dist/src/commands/db/list.d.ts

@@ -0,0 +1,16 @@
+interface DbListOptions {
+    env?: string;
+    limit?: number;
+    active?: boolean;
+    fields?: string[];
+}
+/**
+ * Lists sessions in the Foundation database.
+ * @param [options] List filters and display options.
+ * @param [options.env] Path to .env file.
+ * @param [options.limit] Max sessions to show (default 50).
+ * @param [options.active] If true, only sessions with null endedAt.
+ * @param [options.fields] Extra session fields to show (comma-separated); missing values show '-'.
+ */
+export declare const dbList: (options?: DbListOptions) => Promise<void>;
+export {};

package/dist/src/commands/db/list.js

@@ -0,0 +1,77 @@
+/**
+ * Lists sessions in the Foundation database.
+ */
+import { MongoClient } from 'mongodb';
+import { exitProcess } from '../../utils/processExit.js';
+import { loadEnv } from '../../utils/loadEnv.js';
+import { getDbConfig } from '../../utils/dbConfig.js';
+const formatFieldValue = (value) => {
+    if (value === null || value === undefined)
+        return '-';
+    if (value instanceof Date)
+        return value.toISOString();
+    if (typeof value === 'object')
+        return JSON.stringify(value);
+    return String(value);
+};
+/**
+ * Lists sessions in the Foundation database.
+ * @param [options] List filters and display options.
+ * @param [options.env] Path to .env file.
+ * @param [options.limit] Max sessions to show (default 50).
+ * @param [options.active] If true, only sessions with null endedAt.
+ * @param [options.fields] Extra session fields to show (comma-separated); missing values show '-'.
+ */
+export const dbList = async (options) => {
+    loadEnv(options?.env);
+    const { storageUrl, dbCollection } = getDbConfig();
+    if (!storageUrl) {
+        console.error('STORAGE_URL environment variable not set');
+        exitProcess(1);
+    }
+    const extraFields = options?.fields ?? [];
+    const project = { id: 1, name: 1, startedAt: 1, endedAt: 1 };
+    for (const f of extraFields) {
+        if (f.trim())
+            project[f.trim()] = 1;
+    }
+    try {
+        const client = await MongoClient.connect(storageUrl);
+        const db = client.db();
+        const filter = {};
+        if (options?.active) {
+            filter.endedAt = null;
+        }
+        const limit = options?.limit ?? 50;
+        const sessions = await db
+            .collection(dbCollection)
+            .find(filter)
+            .sort({ startedAt: -1 })
+            .limit(limit)
+            .project(project)
+            .toArray();
+        await client.close();
+        if (sessions.length === 0) {
+            console.log('No sessions found');
+            return;
+        }
+        const baseHeaders = ['ID', 'Name', 'Started', 'Ended'];
+        const headers = [...baseHeaders, ...extraFields.map((f) => f.trim()).filter(Boolean)];
+        const rows = sessions.map((s) => {
+            const started = s.startedAt ? new Date(s.startedAt).toISOString() : '-';
+            const ended = s.endedAt ? new Date(s.endedAt).toISOString() : 'active';
+            const base = [s.id, String(s.name || '-'), started, ended];
+            const extras = extraFields.map((f) => formatFieldValue(s[f.trim()]));
+            return [...base, ...extras].join('\t');
+        });
+        console.log(headers.join('\t'));
+        console.log('-'.repeat(Math.min(80, headers.join('\t').length + 20)));
+        rows.forEach((r) => console.log(r));
+        console.log(`\nTotal: ${sessions.length} session(s)`);
+    }
+    catch (error) {
+        console.error('Failed to list sessions:', error);
+        exitProcess(1);
+    }
+};
+//# sourceMappingURL=list.js.map

package/dist/src/commands/db/list.js.map

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

package/dist/src/commands/db/restore.d.ts

@@ -0,0 +1,15 @@
+interface DbRestoreOptions {
+    env?: string;
+    sessionId: string;
+    force?: boolean;
+}
+/**
+ * Restores a session by ID. Ends any active session first, then sets the target session as active.
+ * Restart the server to pick up the restored session.
+ * @param options Restore options.
+ * @param [options.env] Path to .env file.
+ * @param options.sessionId Session ID to restore (from db list).
+ * @param [options.force] Skip confirmation prompt.
+ */
+export declare const dbRestore: (options: DbRestoreOptions) => Promise<void>;
+export {};

package/dist/src/commands/db/restore.js

@@ -0,0 +1,70 @@
+/**
+ * Restores a session by ID, making it active. Ends the current active session if one exists.
+ */
+import { MongoClient } from 'mongodb';
+import inquirer from 'inquirer';
+import { exitProcess } from '../../utils/processExit.js';
+import { loadEnv } from '../../utils/loadEnv.js';
+import { getDbConfig } from '../../utils/dbConfig.js';
+/**
+ * Restores a session by ID. Ends any active session first, then sets the target session as active.
+ * Restart the server to pick up the restored session.
+ * @param options Restore options.
+ * @param [options.env] Path to .env file.
+ * @param options.sessionId Session ID to restore (from db list).
+ * @param [options.force] Skip confirmation prompt.
+ */
+export const dbRestore = async (options) => {
+    loadEnv(options?.env);
+    const { storageUrl, dbCollection } = getDbConfig();
+    if (!storageUrl) {
+        console.error('STORAGE_URL environment variable not set');
+        exitProcess(1);
+    }
+    const sessionId = options.sessionId;
+    try {
+        const client = await MongoClient.connect(storageUrl);
+        const db = client.db();
+        const collection = db.collection(dbCollection);
+        const targetSession = await collection.findOne({ id: sessionId });
+        if (!targetSession) {
+            console.error(`Session not found: ${sessionId}`);
+            await client.close();
+            exitProcess(1);
+        }
+        const sessionName = targetSession.name ?? sessionId;
+        if (!options.force) {
+            const { confirm } = await inquirer.prompt([
+                {
+                    type: 'confirm',
+                    name: 'confirm',
+                    message: `Restore session "${sessionName}"? This will end the current active session if one exists.`,
+                    default: false
+                }
+            ]);
+            if (!confirm) {
+                console.log('Operation cancelled');
+                await client.close();
+                exitProcess(0);
+            }
+        }
+        const now = new Date();
+        const endResult = await collection.updateMany({ id: { $ne: sessionId }, endedAt: null }, { $set: { endedAt: now } });
+        const restoreResult = await collection.updateOne({ id: sessionId }, { $set: { endedAt: null } });
+        await client.close();
+        if (endResult.modifiedCount > 0) {
+            console.log(`Ended ${endResult.modifiedCount} active session(s)`);
+        }
+        if (restoreResult.modifiedCount > 0) {
+            console.log(`Restored session ${sessionId}. Restart the server to pick it up.`);
+        }
+        else {
+            console.log(`Session ${sessionId} is already active.`);
+        }
+    }
+    catch (error) {
+        console.error('Failed to restore session:', error);
+        exitProcess(1);
+    }
+};
+//# sourceMappingURL=restore.js.map