@parix/cli 0.1.5

package/dist/commands/database.cjs

@@ -0,0 +1,259 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDatabaseCommand = createDatabaseCommand;
+const prompts_1 = require("@clack/prompts");
+const commander_1 = require("commander");
+const output_1 = require("../lib/output.cjs");
+const parix_api_1 = require("../lib/parix-api.cjs");
+function createDatabaseCommand() {
+    const database = new commander_1.Command('database')
+        .description('Manage Parix databases')
+        .addHelpText('after', [
+        '',
+        'Examples:',
+        '  parix database catalog --base-url http://localhost:5173',
+        '  parix database create demo-ledger --provider gcp --region asia-southeast1',
+        '  parix database list',
+        '  parix database info id-123',
+        '  parix database remove id-123 --yes',
+    ].join('\n'));
+    database
+        .command('catalog')
+        .description('Show database creation catalog options')
+        .option('-b, --base-url <url>', 'Parix base URL')
+        .option('--json', 'Print raw JSON')
+        .action(async (options) => {
+        const response = await (0, parix_api_1.requestApiJson)({
+            baseUrl: options.baseUrl,
+            path: '/api/v1/catalog/create',
+        });
+        if (options.json) {
+            (0, output_1.printJson)(response);
+            return;
+        }
+        (0, output_1.printTable)({
+            columns: ['Provider', 'Regions'],
+            rows: response.catalog.providers.map((provider) => [
+                provider.slug,
+                provider.regions.map((region) => region.code).join(', '),
+            ]),
+        });
+        (0, prompts_1.note)('Use `--provider <slug>` and `--region <code>` from this table.', 'Providers');
+        (0, output_1.printTable)({
+            columns: ['Config ID', 'Label', 'Nodes'],
+            rows: response.catalog.clusterConfigs.map((config) => [config.id, config.label, String(config.nodeCount)]),
+        });
+        (0, output_1.printTable)({
+            columns: ['Storage ID', 'Label', 'Multiplier'],
+            rows: response.catalog.storageTiers.map((tier) => [tier.id, tier.label, `${tier.priceMultiplier}x`]),
+        });
+        (0, output_1.printTable)({
+            columns: ['Size ID', 'Label', 'vCPU', 'Memory GB'],
+            rows: response.catalog.clusterSizes.map((size) => [
+                size.id,
+                size.label,
+                String(size.vcpu),
+                String(size.memoryGb),
+            ]),
+        });
+        (0, prompts_1.outro)('Done');
+    });
+    database
+        .command('create')
+        .description('Create a new database')
+        .argument('<database>', 'Database name')
+        .option('-b, --base-url <url>', 'Parix base URL')
+        .option('--provider <slug>', 'Provider slug (for example: gcp, aws)')
+        .option('--region <code>', 'Region code')
+        .option('--cluster-config-id <id>', 'Cluster config id')
+        .option('--storage-tier-id <id>', 'Storage tier id')
+        .option('--cluster-size-id <id>', 'Cluster size id')
+        .option('--storage-gb <n>', 'Storage size in GB')
+        .option('--json', 'Print raw JSON')
+        .addHelpText('after', [
+        '',
+        'Examples:',
+        '  parix database create payments-ledger --provider gcp --region asia-southeast1',
+        '  parix database create payments-ledger --provider aws --region ap-southeast-1 --cluster-config-id config-single --cluster-size-id size-hx-5',
+    ].join('\n'))
+        .action(async (databaseName, options) => {
+        const parsedStorageGb = options.storageGb ? Number.parseInt(options.storageGb, 10) : null;
+        if (options.storageGb &&
+            (typeof parsedStorageGb !== 'number' || !Number.isInteger(parsedStorageGb) || parsedStorageGb <= 0)) {
+            throw new Error('--storage-gb must be a positive integer.');
+        }
+        const response = await (0, parix_api_1.requestApiJson)({
+            baseUrl: options.baseUrl,
+            body: JSON.stringify({
+                clusterConfigId: options.clusterConfigId,
+                clusterSizeId: options.clusterSizeId,
+                name: databaseName,
+                provider: options.provider,
+                region: options.region,
+                selectedStorageGb: parsedStorageGb ?? undefined,
+                storageTierId: options.storageTierId,
+            }),
+            headers: {
+                'content-type': 'application/json',
+            },
+            method: 'POST',
+            path: '/api/v1/databases',
+        });
+        if (options.json) {
+            (0, output_1.printJson)(response);
+            return;
+        }
+        if (!response.success) {
+            (0, prompts_1.note)([
+                `Billing: ${response.billing?.message ?? response.message}`,
+                `Checkout URL: ${response.billing?.checkoutUrl ?? '-'}`,
+            ].join('\n'), 'Provisioning blocked');
+            (0, prompts_1.outro)(response.message);
+            return;
+        }
+        (0, output_1.printKeyValues)([
+            ['Database ID', response.database?.id ?? '-'],
+            ['Database Name', response.database?.name ?? databaseName],
+            ['Profile ID', response.profile?.id ?? '-'],
+            ['Profile status', response.profile?.status ?? '-'],
+            ['Provisioning', response.provisioning?.status ?? '-'],
+            ['Workflow ID', response.job?.workflowId ?? '-'],
+        ]);
+        if (response.provisioning) {
+            (0, prompts_1.note)([`Status: ${response.provisioning.status}`, `Message: ${response.provisioning.message ?? '-'}`].join('\n'), 'Provisioning');
+        }
+        (0, prompts_1.outro)(response.message);
+    });
+    database
+        .command('list')
+        .description('List databases in the active organization')
+        .option('-b, --base-url <url>', 'Parix base URL')
+        .option('--search <text>', 'Filter database names')
+        .option('--limit <n>', 'Maximum number of rows to return')
+        .option('--json', 'Print raw JSON')
+        .addHelpText('after', [
+        '',
+        'Examples:',
+        '  parix database list',
+        '  parix database list --search payments',
+        '  parix database list --json',
+    ].join('\n'))
+        .action(async (options) => {
+        const query = new URLSearchParams();
+        if (options.search) {
+            query.set('search', options.search);
+        }
+        if (options.limit) {
+            query.set('limit', options.limit);
+        }
+        const suffix = query.size > 0 ? `?${query.toString()}` : '';
+        const response = await (0, parix_api_1.requestApiJson)({
+            baseUrl: options.baseUrl,
+            path: `/api/v1/databases${suffix}`,
+        });
+        if (options.json) {
+            (0, output_1.printJson)(response);
+            return;
+        }
+        if (response.databases.length === 0) {
+            (0, prompts_1.outro)('No databases found');
+            return;
+        }
+        (0, output_1.printTable)({
+            columns: ['ID', 'Name', 'Region', 'Provider', 'Status', 'Updated'],
+            rows: response.databases.map((database) => [
+                database.id,
+                database.name,
+                database.region ?? '-',
+                database.provider ?? '-',
+                database.status,
+                database.updatedAt,
+            ]),
+        });
+        (0, prompts_1.note)(String(response.databases.length), 'Databases');
+        (0, prompts_1.outro)('Done');
+    });
+    database
+        .command('info')
+        .description('Show database details')
+        .argument('<database-id>', 'Database id')
+        .option('-b, --base-url <url>', 'Parix base URL')
+        .option('--json', 'Print raw JSON')
+        .addHelpText('after', ['', 'Examples:', '  parix database info db_123', '  parix database info db_123 --json'].join('\n'))
+        .action(async (databaseId, options) => {
+        const response = await (0, parix_api_1.requestApiJson)({
+            baseUrl: options.baseUrl,
+            path: `/api/v1/databases/${encodeURIComponent(databaseId)}`,
+        });
+        if (options.json) {
+            (0, output_1.printJson)(response);
+            return;
+        }
+        (0, output_1.printKeyValues)([
+            ['Database ID', response.database.id],
+            ['Database Name', response.database.name],
+            ['Provider', response.provider ?? '-'],
+            ['Region', response.region ?? '-'],
+            ['Gateway URL', response.gatewayUrl ?? '-'],
+            ['Status', response.decommissionState?.status ?? response.profile?.status ?? '-'],
+            ['Version', response.profile?.tigerbeetleCurrentVersion ?? response.profile?.tigerbeetleVersion ?? '-'],
+            ['Nodes', response.profile ? String(response.profile.selectedNodeCount) : '-'],
+            ['CPU', response.profile ? String(response.profile.selectedVcpu) : '-'],
+            ['Memory GB', response.profile ? String(response.profile.selectedMemoryGb) : '-'],
+            ['Storage GB', response.profile?.selectedStorageGb != null ? String(response.profile.selectedStorageGb) : '-'],
+            ['Updated', response.database.updatedAt],
+        ]);
+        if (response.metricsSummary) {
+            (0, prompts_1.note)([
+                `CPU: ${response.metricsSummary.cpuUsagePct ?? '-'}%`,
+                `Memory: ${response.metricsSummary.memoryUsagePct ?? '-'}%`,
+                `Disk: ${response.metricsSummary.diskUsagePct ?? '-'}%`,
+                `Gateway P95: ${response.metricsSummary.gatewayP95LatencyMs ?? '-'}ms`,
+                `Last collected: ${response.metricsSummary.lastCollectedAt ?? '-'}`,
+            ].join('\n'), 'Metrics');
+        }
+        if (response.latestProvisionJob) {
+            (0, prompts_1.note)([
+                `Provision job: ${response.latestProvisionJob.id}`,
+                `Provision status: ${response.latestProvisionJob.status}`,
+                `Workflow ID: ${response.latestProvisionJob.workflowId ?? '-'}`,
+            ].join('\n'), 'Latest provision job');
+        }
+        (0, prompts_1.outro)('Done');
+    });
+    database
+        .command('remove')
+        .description('Queue database deletion')
+        .argument('<database-id>', 'Database id')
+        .option('-b, --base-url <url>', 'Parix base URL')
+        .option('--json', 'Print raw JSON')
+        .option('-y, --yes', 'Skip confirmation prompt')
+        .addHelpText('after', ['', 'Examples:', '  parix database remove db_123', '  parix database remove db_123 --yes --json'].join('\n'))
+        .action(async (databaseId, options) => {
+        if (!options.yes) {
+            const confirmed = await (0, prompts_1.confirm)({
+                message: `Queue deletion for ${databaseId}?`,
+            });
+            if ((0, prompts_1.isCancel)(confirmed) || !confirmed) {
+                (0, prompts_1.outro)('Cancelled');
+                return;
+            }
+        }
+        const response = await (0, parix_api_1.requestApiJson)({
+            baseUrl: options.baseUrl,
+            method: 'DELETE',
+            path: `/api/v1/databases/${encodeURIComponent(databaseId)}`,
+        });
+        if (options.json) {
+            (0, output_1.printJson)(response);
+            return;
+        }
+        (0, output_1.printKeyValues)([
+            ['Database ID', response.databaseId],
+            ['Status', response.status],
+            ['Workflow ID', response.workflowId],
+        ]);
+        (0, prompts_1.outro)(response.message);
+    });
+    return database;
+}

package/dist/commands/database.d.cts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function createDatabaseCommand(): Command;

package/dist/commands/database.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function createDatabaseCommand(): Command;

package/dist/commands/database.js

@@ -0,0 +1,256 @@
+import { confirm, isCancel, note, outro } from '@clack/prompts';
+import { Command } from 'commander';
+import { printJson, printKeyValues, printTable } from "../lib/output.js";
+import { requestApiJson } from "../lib/parix-api.js";
+export function createDatabaseCommand() {
+    const database = new Command('database')
+        .description('Manage Parix databases')
+        .addHelpText('after', [
+        '',
+        'Examples:',
+        '  parix database catalog --base-url http://localhost:5173',
+        '  parix database create demo-ledger --provider gcp --region asia-southeast1',
+        '  parix database list',
+        '  parix database info id-123',
+        '  parix database remove id-123 --yes',
+    ].join('\n'));
+    database
+        .command('catalog')
+        .description('Show database creation catalog options')
+        .option('-b, --base-url <url>', 'Parix base URL')
+        .option('--json', 'Print raw JSON')
+        .action(async (options) => {
+        const response = await requestApiJson({
+            baseUrl: options.baseUrl,
+            path: '/api/v1/catalog/create',
+        });
+        if (options.json) {
+            printJson(response);
+            return;
+        }
+        printTable({
+            columns: ['Provider', 'Regions'],
+            rows: response.catalog.providers.map((provider) => [
+                provider.slug,
+                provider.regions.map((region) => region.code).join(', '),
+            ]),
+        });
+        note('Use `--provider <slug>` and `--region <code>` from this table.', 'Providers');
+        printTable({
+            columns: ['Config ID', 'Label', 'Nodes'],
+            rows: response.catalog.clusterConfigs.map((config) => [config.id, config.label, String(config.nodeCount)]),
+        });
+        printTable({
+            columns: ['Storage ID', 'Label', 'Multiplier'],
+            rows: response.catalog.storageTiers.map((tier) => [tier.id, tier.label, `${tier.priceMultiplier}x`]),
+        });
+        printTable({
+            columns: ['Size ID', 'Label', 'vCPU', 'Memory GB'],
+            rows: response.catalog.clusterSizes.map((size) => [
+                size.id,
+                size.label,
+                String(size.vcpu),
+                String(size.memoryGb),
+            ]),
+        });
+        outro('Done');
+    });
+    database
+        .command('create')
+        .description('Create a new database')
+        .argument('<database>', 'Database name')
+        .option('-b, --base-url <url>', 'Parix base URL')
+        .option('--provider <slug>', 'Provider slug (for example: gcp, aws)')
+        .option('--region <code>', 'Region code')
+        .option('--cluster-config-id <id>', 'Cluster config id')
+        .option('--storage-tier-id <id>', 'Storage tier id')
+        .option('--cluster-size-id <id>', 'Cluster size id')
+        .option('--storage-gb <n>', 'Storage size in GB')
+        .option('--json', 'Print raw JSON')
+        .addHelpText('after', [
+        '',
+        'Examples:',
+        '  parix database create payments-ledger --provider gcp --region asia-southeast1',
+        '  parix database create payments-ledger --provider aws --region ap-southeast-1 --cluster-config-id config-single --cluster-size-id size-hx-5',
+    ].join('\n'))
+        .action(async (databaseName, options) => {
+        const parsedStorageGb = options.storageGb ? Number.parseInt(options.storageGb, 10) : null;
+        if (options.storageGb &&
+            (typeof parsedStorageGb !== 'number' || !Number.isInteger(parsedStorageGb) || parsedStorageGb <= 0)) {
+            throw new Error('--storage-gb must be a positive integer.');
+        }
+        const response = await requestApiJson({
+            baseUrl: options.baseUrl,
+            body: JSON.stringify({
+                clusterConfigId: options.clusterConfigId,
+                clusterSizeId: options.clusterSizeId,
+                name: databaseName,
+                provider: options.provider,
+                region: options.region,
+                selectedStorageGb: parsedStorageGb ?? undefined,
+                storageTierId: options.storageTierId,
+            }),
+            headers: {
+                'content-type': 'application/json',
+            },
+            method: 'POST',
+            path: '/api/v1/databases',
+        });
+        if (options.json) {
+            printJson(response);
+            return;
+        }
+        if (!response.success) {
+            note([
+                `Billing: ${response.billing?.message ?? response.message}`,
+                `Checkout URL: ${response.billing?.checkoutUrl ?? '-'}`,
+            ].join('\n'), 'Provisioning blocked');
+            outro(response.message);
+            return;
+        }
+        printKeyValues([
+            ['Database ID', response.database?.id ?? '-'],
+            ['Database Name', response.database?.name ?? databaseName],
+            ['Profile ID', response.profile?.id ?? '-'],
+            ['Profile status', response.profile?.status ?? '-'],
+            ['Provisioning', response.provisioning?.status ?? '-'],
+            ['Workflow ID', response.job?.workflowId ?? '-'],
+        ]);
+        if (response.provisioning) {
+            note([`Status: ${response.provisioning.status}`, `Message: ${response.provisioning.message ?? '-'}`].join('\n'), 'Provisioning');
+        }
+        outro(response.message);
+    });
+    database
+        .command('list')
+        .description('List databases in the active organization')
+        .option('-b, --base-url <url>', 'Parix base URL')
+        .option('--search <text>', 'Filter database names')
+        .option('--limit <n>', 'Maximum number of rows to return')
+        .option('--json', 'Print raw JSON')
+        .addHelpText('after', [
+        '',
+        'Examples:',
+        '  parix database list',
+        '  parix database list --search payments',
+        '  parix database list --json',
+    ].join('\n'))
+        .action(async (options) => {
+        const query = new URLSearchParams();
+        if (options.search) {
+            query.set('search', options.search);
+        }
+        if (options.limit) {
+            query.set('limit', options.limit);
+        }
+        const suffix = query.size > 0 ? `?${query.toString()}` : '';
+        const response = await requestApiJson({
+            baseUrl: options.baseUrl,
+            path: `/api/v1/databases${suffix}`,
+        });
+        if (options.json) {
+            printJson(response);
+            return;
+        }
+        if (response.databases.length === 0) {
+            outro('No databases found');
+            return;
+        }
+        printTable({
+            columns: ['ID', 'Name', 'Region', 'Provider', 'Status', 'Updated'],
+            rows: response.databases.map((database) => [
+                database.id,
+                database.name,
+                database.region ?? '-',
+                database.provider ?? '-',
+                database.status,
+                database.updatedAt,
+            ]),
+        });
+        note(String(response.databases.length), 'Databases');
+        outro('Done');
+    });
+    database
+        .command('info')
+        .description('Show database details')
+        .argument('<database-id>', 'Database id')
+        .option('-b, --base-url <url>', 'Parix base URL')
+        .option('--json', 'Print raw JSON')
+        .addHelpText('after', ['', 'Examples:', '  parix database info db_123', '  parix database info db_123 --json'].join('\n'))
+        .action(async (databaseId, options) => {
+        const response = await requestApiJson({
+            baseUrl: options.baseUrl,
+            path: `/api/v1/databases/${encodeURIComponent(databaseId)}`,
+        });
+        if (options.json) {
+            printJson(response);
+            return;
+        }
+        printKeyValues([
+            ['Database ID', response.database.id],
+            ['Database Name', response.database.name],
+            ['Provider', response.provider ?? '-'],
+            ['Region', response.region ?? '-'],
+            ['Gateway URL', response.gatewayUrl ?? '-'],
+            ['Status', response.decommissionState?.status ?? response.profile?.status ?? '-'],
+            ['Version', response.profile?.tigerbeetleCurrentVersion ?? response.profile?.tigerbeetleVersion ?? '-'],
+            ['Nodes', response.profile ? String(response.profile.selectedNodeCount) : '-'],
+            ['CPU', response.profile ? String(response.profile.selectedVcpu) : '-'],
+            ['Memory GB', response.profile ? String(response.profile.selectedMemoryGb) : '-'],
+            ['Storage GB', response.profile?.selectedStorageGb != null ? String(response.profile.selectedStorageGb) : '-'],
+            ['Updated', response.database.updatedAt],
+        ]);
+        if (response.metricsSummary) {
+            note([
+                `CPU: ${response.metricsSummary.cpuUsagePct ?? '-'}%`,
+                `Memory: ${response.metricsSummary.memoryUsagePct ?? '-'}%`,
+                `Disk: ${response.metricsSummary.diskUsagePct ?? '-'}%`,
+                `Gateway P95: ${response.metricsSummary.gatewayP95LatencyMs ?? '-'}ms`,
+                `Last collected: ${response.metricsSummary.lastCollectedAt ?? '-'}`,
+            ].join('\n'), 'Metrics');
+        }
+        if (response.latestProvisionJob) {
+            note([
+                `Provision job: ${response.latestProvisionJob.id}`,
+                `Provision status: ${response.latestProvisionJob.status}`,
+                `Workflow ID: ${response.latestProvisionJob.workflowId ?? '-'}`,
+            ].join('\n'), 'Latest provision job');
+        }
+        outro('Done');
+    });
+    database
+        .command('remove')
+        .description('Queue database deletion')
+        .argument('<database-id>', 'Database id')
+        .option('-b, --base-url <url>', 'Parix base URL')
+        .option('--json', 'Print raw JSON')
+        .option('-y, --yes', 'Skip confirmation prompt')
+        .addHelpText('after', ['', 'Examples:', '  parix database remove db_123', '  parix database remove db_123 --yes --json'].join('\n'))
+        .action(async (databaseId, options) => {
+        if (!options.yes) {
+            const confirmed = await confirm({
+                message: `Queue deletion for ${databaseId}?`,
+            });
+            if (isCancel(confirmed) || !confirmed) {
+                outro('Cancelled');
+                return;
+            }
+        }
+        const response = await requestApiJson({
+            baseUrl: options.baseUrl,
+            method: 'DELETE',
+            path: `/api/v1/databases/${encodeURIComponent(databaseId)}`,
+        });
+        if (options.json) {
+            printJson(response);
+            return;
+        }
+        printKeyValues([
+            ['Database ID', response.databaseId],
+            ['Status', response.status],
+            ['Workflow ID', response.workflowId],
+        ]);
+        outro(response.message);
+    });
+    return database;
+}