ninedeploy 0.18.26 → 0.18.27

package/dist/commands/databaseUpgrade.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `ninedeploy databases upgrade …` — O2 major-version upgrades (PostgreSQL on
+ * the panel host).
+ *
+ *   status <dbId>                              current major, targets, and the upgrade history
+ *   start <dbId> --to <major> [--yes] [--no-wait]
+ *                                              stop, dump, restore into a new volume, compare, switch
+ *   rollback <dbId> <upgradeId> [--yes]        point the database back at the previous volume
+ *   finalize <dbId> <upgradeId> [--yes]        delete the volume the database no longer uses
+ */
+import type { NineDeployClient } from '../client.js';
+export declare function upgradeStatus(client: NineDeployClient, dbIdStr: string): Promise<void>;
+export declare function upgradeStart(client: NineDeployClient, dbIdStr: string, opts?: {
+    to?: string;
+    yes?: boolean;
+    wait?: boolean;
+    pollMs?: number;
+}): Promise<void>;
+export declare function upgradeRollback(client: NineDeployClient, dbIdStr: string, upgradeIdStr: string, opts?: {
+    yes?: boolean;
+}): Promise<void>;
+export declare function upgradeFinalize(client: NineDeployClient, dbIdStr: string, upgradeIdStr: string, opts?: {
+    yes?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=databaseUpgrade.d.ts.map

package/dist/commands/databaseUpgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"databaseUpgrade.d.ts","sourceRoot":"","sources":["../../src/commands/databaseUpgrade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAwCrD,wBAAsB,aAAa,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB5F;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACzE,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAYlJ;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAWlJ"}

package/dist/commands/databaseUpgrade.js

@@ -0,0 +1,136 @@
+import { prompt } from '../prompts.js';
+import { c, error, header, info, kv, spinner, success, table } from '../lib/format.js';
+const num = (v, usage) => {
+    const n = Number(v);
+    if (!Number.isInteger(n) || n <= 0) {
+        error(usage);
+        process.exitCode = 1;
+        return null;
+    }
+    return n;
+};
+const fail = (err) => {
+    error(err instanceof Error ? err.message : String(err));
+    process.exitCode = 1;
+};
+const confirm = async (word, question) => {
+    const answer = await prompt(`${question} Type "${word}" to continue`, '');
+    if (answer.trim() !== word) {
+        info('Aborted.');
+        return false;
+    }
+    return true;
+};
+function describeOutcome(u, dbId) {
+    if (u.status === 'completed') {
+        success(`Upgraded to PostgreSQL ${u.toMajor}.`);
+        if (u.verification)
+            info(`Compared before the switch: ${u.verification.tables} table(s), ${u.verification.rows} row(s), ${u.verification.sequences} sequence(s).`);
+        info(`The previous volume ${u.previousVolume} is kept. Check your services, then: ninedeploy databases upgrade finalize ${dbId} ${u.id}`);
+        info(`To go back to PostgreSQL ${u.fromMajor}: ninedeploy databases upgrade rollback ${dbId} ${u.id}`);
+    }
+    else {
+        error(`The upgrade ${u.status === 'failed' ? 'failed' : `ended ${u.status}`}: ${u.error ?? 'no reason recorded'}`);
+        process.exitCode = 1;
+    }
+}
+export async function upgradeStatus(client, dbIdStr) {
+    const id = num(dbIdStr, 'Usage: ninedeploy databases upgrade status <dbId>');
+    if (id === null)
+        return;
+    let options;
+    let history;
+    try {
+        [options, history] = await spinner('Reading the cluster', () => Promise.all([client.databases.upgrades.options(id), client.databases.upgrades.list(id)]));
+    }
+    catch (err) {
+        fail(err);
+        return;
+    }
+    header('Major upgrade');
+    kv('Running', options.currentMajor != null ? `PostgreSQL ${options.currentMajor}` : c.dim('unknown'));
+    if (options.refusal)
+        info(options.refusal.message);
+    else
+        kv('Can move to', options.targets.map((m) => `PostgreSQL ${m}`).join(', '));
+    if (history.length) {
+        table(history.map((u) => ({
+            id: u.id,
+            upgrade: `${u.fromMajor} → ${u.toMajor}`,
+            status: u.status === 'running' ? `running (${u.phase ?? '…'})` : u.status,
+            started: u.createdAt,
+            kept: u.status === 'completed' ? u.previousVolume : u.status === 'rolled_back' ? u.targetVolume : '',
+            error: u.error ?? '',
+        })));
+    }
+}
+export async function upgradeStart(client, dbIdStr, opts = {}) {
+    const usage = 'Usage: ninedeploy databases upgrade start <dbId> --to <major> [--yes] [--no-wait]';
+    const id = num(dbIdStr, usage);
+    if (id === null)
+        return;
+    const toMajor = num(opts.to, `--to must be a PostgreSQL major, e.g. --to 18. ${usage}`);
+    if (toMajor === null)
+        return;
+    if (!opts.yes && !(await confirm('upgrade', `The database stops for the whole upgrade (dump, restore into PostgreSQL ${toMajor}, compare). Attached services lose their connection until it is back.`)))
+        return;
+    let admitted;
+    try {
+        admitted = await spinner('Checking the cluster', () => client.databases.upgrades.start(id, { toMajor }));
+    }
+    catch (err) {
+        fail(err);
+        return;
+    }
+    if (opts.wait === false) {
+        success(`Upgrade #${admitted.id} to PostgreSQL ${toMajor} is running. Follow it with: ninedeploy databases upgrade status ${id}`);
+        return;
+    }
+    let done;
+    try {
+        done = await spinner(`Upgrading to PostgreSQL ${toMajor}`, () => client.databases.upgrades.wait(id, admitted.id, opts.pollMs ? { intervalMs: opts.pollMs } : {}));
+    }
+    catch (err) {
+        fail(err);
+        return;
+    }
+    describeOutcome(done, id);
+}
+export async function upgradeRollback(client, dbIdStr, upgradeIdStr, opts = {}) {
+    const usage = 'Usage: ninedeploy databases upgrade rollback <dbId> <upgradeId> [--yes]';
+    const id = num(dbIdStr, usage);
+    if (id === null)
+        return;
+    const upgradeId = num(upgradeIdStr, usage);
+    if (upgradeId === null)
+        return;
+    if (!opts.yes && !(await confirm('rollback', 'The database restarts on its previous volume. Writes made since the upgrade stay on the upgraded volume and are NOT carried back.')))
+        return;
+    try {
+        const u = await spinner('Rolling back', () => client.databases.upgrades.rollback(id, upgradeId));
+        success(`The database runs on PostgreSQL ${u.fromMajor} again (${u.previousVolume}).`);
+        info(`The upgraded volume ${u.targetVolume} is kept. Delete it with: ninedeploy databases upgrade finalize ${id} ${u.id}`);
+    }
+    catch (err) {
+        fail(err);
+    }
+}
+export async function upgradeFinalize(client, dbIdStr, upgradeIdStr, opts = {}) {
+    const usage = 'Usage: ninedeploy databases upgrade finalize <dbId> <upgradeId> [--yes]';
+    const id = num(dbIdStr, usage);
+    if (id === null)
+        return;
+    const upgradeId = num(upgradeIdStr, usage);
+    if (upgradeId === null)
+        return;
+    if (!opts.yes && !(await confirm('finalize', 'The volume the database no longer uses is DELETED; after this there is no rollback.')))
+        return;
+    try {
+        const u = await spinner('Finalizing', () => client.databases.upgrades.finalize(id, upgradeId));
+        success(`Deleted ${u.removedVolume}.`);
+    }
+    catch (err) {
+        fail(err);
+    }
+}
+//# sourceMappingURL=databaseUpgrade.js.map

package/dist/commands/databaseUpgrade.js.map

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

package/dist/commands/importApply.d.ts

@@ -0,0 +1,114 @@
+import { type NineDeployClient } from '../client.js';
+import type { ImportPlan, PlanEngine } from '../lib/importers/plan.js';
+type CreateServiceInput = Parameters<NineDeployClient['services']['create']>[0];
+type CreateDatabaseInput = Parameters<NineDeployClient['databases']['create']>[0];
+/** The panel calls apply makes; NineDeployClient satisfies it. */
+export interface ApplyClient {
+    services: {
+        create: (input: CreateServiceInput) => Promise<{
+            id: number;
+        }>;
+        /** Settings set right after create (the plan's `settings`, e.g. a worker's `running` health check). */
+        update: (id: number, input: {
+            healthCheck?: 'running';
+        }) => Promise<unknown>;
+    };
+    databases: {
+        create: (input: CreateDatabaseInput) => Promise<{
+            id: number;
+        }>;
+    };
+    env: {
+        import: (serviceId: number, content: string) => Promise<{
+            imported: number;
+            skipped: number;
+            errors: Array<{
+                line: number;
+                message: string;
+            }>;
+        }>;
+    };
+    attachments: {
+        list: (serviceId: number) => Promise<Array<{
+            id: number;
+            databaseId: number;
+            envAlias: string;
+        }>>;
+        create: (serviceId: number, input: {
+            databaseId: number;
+            envAlias?: string;
+            reuseExisting?: boolean;
+        }) => Promise<{
+            id: number;
+            databaseId: number;
+            envAlias: string;
+        }>;
+    };
+}
+export type ReceiptState = 'pending' | 'done' | 'skipped' | 'failed';
+export interface ReceiptItem {
+    kind: 'service' | 'database' | 'env' | 'data' | 'domain' | 'attach' | 'volume';
+    ref: string;
+    name: string;
+    state: ReceiptState;
+    /** The NineDeploy id (the service's for an env item, the database's for a data item, the domain's for a domain item). */
+    id?: number;
+    /** Data and volume items (`import data`): the panel's import id, and the file's sha256 and size. */
+    importId?: number;
+    sha256?: string;
+    bytes?: number;
+    at: string;
+    notes: string[];
+}
+export interface ImportReceipt {
+    receiptVersion: 1;
+    panel: string;
+    source: {
+        kind: string;
+        url: string;
+    };
+    items: Record<string, ReceiptItem>;
+}
+export interface ApplyOptions {
+    /** Tag every created service and database with this project. */
+    project?: number;
+    /** Service name → .env file content. */
+    envFiles?: Record<string, string>;
+}
+export interface ApplyDeps {
+    client: ApplyClient;
+    panel: string;
+    receipt: ImportReceipt | null;
+    save: (receipt: ImportReceipt) => void;
+    now?: () => Date;
+}
+/** Accept only a plan this CLI wrote (planVersion 1) with the parts apply reads. */
+export declare function validatePlan(raw: unknown): ImportPlan;
+/**
+ * The source's version, when its image is the same repository NineDeploy runs
+ * and the tag is a version (starts with a digit). Otherwise undefined, and
+ * the panel picks its default.
+ */
+export declare function databaseVersion(engine: PlanEngine, image: string | null): string | undefined;
+/** Variable names a .env file defines (values are never looked at). */
+export declare function envFileKeys(content: string): string[];
+/** Create what the plan describes, recording every step in the receipt. */
+export declare function applyPlan(plan: ImportPlan, opts: ApplyOptions, deps: ApplyDeps): Promise<ImportReceipt>;
+/** The receipt, item by item, in plan order. */
+export declare function renderReceipt(receipt: ImportReceipt): string;
+/** What --yes would do, without calling the panel. */
+export declare function renderApplyPreview(plan: ImportPlan, receipt: ImportReceipt | null, envFiles: Record<string, string>): string;
+/** Write the receipt atomically (temp file, then rename). */
+export declare function writeReceipt(path: string, receipt: ImportReceipt): void;
+export interface ImportApplyOpts {
+    receipt?: string;
+    project?: string;
+    dotenv?: string[];
+    yes?: boolean;
+}
+export declare function importApplyAction(planPath: string, opts: ImportApplyOpts, deps?: {
+    client?: ApplyClient;
+    panel?: string;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=importApply.d.ts.map

package/dist/commands/importApply.d.ts.map

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