@prisma-next/cli 0.3.0-dev.3 → 0.3.0-dev.30

package/dist/utils/output.d.ts

@@ -0,0 +1,142 @@
+import type { Command } from 'commander';
+export interface EmitContractResult {
+    readonly coreHash: string;
+    readonly profileHash: string;
+    readonly outDir: string;
+    readonly files: {
+        readonly json: string;
+        readonly dts: string;
+    };
+    readonly timings: {
+        readonly total: number;
+    };
+}
+import type { CoreSchemaView } from '@prisma-next/core-control-plane/schema-view';
+import type { IntrospectSchemaResult, SignDatabaseResult, VerifyDatabaseResult, VerifyDatabaseSchemaResult } from '@prisma-next/core-control-plane/types';
+import type { CliErrorEnvelope } from './cli-errors';
+import type { GlobalFlags } from './global-flags';
+/**
+ * Formats human-readable output for contract emit.
+ */
+export declare function formatEmitOutput(result: EmitContractResult, flags: GlobalFlags): string;
+/**
+ * Formats JSON output for contract emit.
+ */
+export declare function formatEmitJson(result: EmitContractResult): string;
+/**
+ * Formats error output for human-readable display.
+ */
+export declare function formatErrorOutput(error: CliErrorEnvelope, flags: GlobalFlags): string;
+/**
+ * Formats error output as JSON.
+ */
+export declare function formatErrorJson(error: CliErrorEnvelope): string;
+/**
+ * Formats human-readable output for database verify.
+ */
+export declare function formatVerifyOutput(result: VerifyDatabaseResult, flags: GlobalFlags): string;
+/**
+ * Formats JSON output for database verify.
+ */
+export declare function formatVerifyJson(result: VerifyDatabaseResult): string;
+/**
+ * Formats JSON output for database introspection.
+ */
+export declare function formatIntrospectJson(result: IntrospectSchemaResult<unknown>): string;
+/**
+ * Formats human-readable output for database introspection.
+ */
+export declare function formatIntrospectOutput(result: IntrospectSchemaResult<unknown>, schemaView: CoreSchemaView | undefined, flags: GlobalFlags): string;
+/**
+ * Formats human-readable output for database schema verification.
+ */
+export declare function formatSchemaVerifyOutput(result: VerifyDatabaseSchemaResult, flags: GlobalFlags): string;
+/**
+ * Formats JSON output for database schema verification.
+ */
+export declare function formatSchemaVerifyJson(result: VerifyDatabaseSchemaResult): string;
+/**
+ * Formats human-readable output for database sign.
+ */
+export declare function formatSignOutput(result: SignDatabaseResult, flags: GlobalFlags): string;
+/**
+ * Formats JSON output for database sign.
+ */
+export declare function formatSignJson(result: SignDatabaseResult): string;
+/**
+ * Result type for db init command.
+ */
+export interface DbInitResult {
+    readonly ok: boolean;
+    readonly mode: 'plan' | 'apply';
+    readonly plan?: {
+        readonly targetId: string;
+        readonly destination: {
+            readonly coreHash: string;
+            readonly profileHash?: string;
+        };
+        readonly operations: readonly {
+            readonly id: string;
+            readonly label: string;
+            readonly operationClass: string;
+        }[];
+    };
+    readonly execution?: {
+        readonly operationsPlanned: number;
+        readonly operationsExecuted: number;
+    };
+    readonly marker?: {
+        readonly coreHash: string;
+        readonly profileHash?: string;
+    };
+    readonly summary: string;
+    readonly timings: {
+        readonly total: number;
+    };
+}
+/**
+ * Formats human-readable output for db init plan mode.
+ */
+export declare function formatDbInitPlanOutput(result: DbInitResult, flags: GlobalFlags): string;
+/**
+ * Formats human-readable output for db init apply mode.
+ */
+export declare function formatDbInitApplyOutput(result: DbInitResult, flags: GlobalFlags): string;
+/**
+ * Formats JSON output for db init command.
+ */
+export declare function formatDbInitJson(result: DbInitResult): string;
+/**
+ * Formats the header in the new experimental visual style.
+ * This header appears at the start of command output, showing the operation,
+ * intent, documentation link, and parameters.
+ */
+export declare function formatStyledHeader(options: {
+    readonly command: string;
+    readonly description: string;
+    readonly url?: string;
+    readonly details: ReadonlyArray<{
+        readonly label: string;
+        readonly value: string;
+    }>;
+    readonly flags: GlobalFlags;
+}): string;
+/**
+ * Formats a success message in the styled output format.
+ */
+export declare function formatSuccessMessage(flags: GlobalFlags): string;
+/**
+ * Formats help output for a command using the styled format.
+ */
+export declare function formatCommandHelp(options: {
+    readonly command: Command;
+    readonly flags: GlobalFlags;
+}): string;
+/**
+ * Formats help output for the root program using the styled format.
+ */
+export declare function formatRootHelp(options: {
+    readonly program: Command;
+    readonly flags: GlobalFlags;
+}): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/utils/output.d.ts.map

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

package/dist/utils/progress-adapter.d.ts

@@ -0,0 +1,26 @@
+import type { OnControlProgress } from '../control-api/types';
+import type { GlobalFlags } from './global-flags';
+/**
+ * Options for creating a progress adapter.
+ */
+interface ProgressAdapterOptions {
+    /**
+     * Global flags that control progress output behavior (quiet, json, color).
+     */
+    readonly flags: GlobalFlags;
+}
+/**
+ * Creates a progress adapter that converts control-api progress events
+ * into CLI spinner/progress output.
+ *
+ * The adapter:
+ * - Starts/succeeds spinners for top-level span boundaries
+ * - Prints per-operation lines for nested spans (e.g., migration operations under 'apply')
+ * - Respects quiet/json/non-TTY flags (no-op in those cases)
+ *
+ * @param options - Progress adapter configuration
+ * @returns An onProgress callback compatible with control-api operations
+ */
+export declare function createProgressAdapter(options: ProgressAdapterOptions): OnControlProgress;
+export {};
+//# sourceMappingURL=progress-adapter.d.ts.map

package/dist/utils/progress-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-adapter.d.ts","sourceRoot":"","sources":["../../src/utils/progress-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAwB,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;GAEG;AACH,UAAU,sBAAsB;IAC9B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;CAC7B;AAUD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,iBAAiB,CAmDxF"}

package/dist/utils/result-handler.d.ts

@@ -0,0 +1,15 @@
+import type { Result } from '@prisma-next/utils/result';
+import type { CliStructuredError } from './cli-errors';
+import type { GlobalFlags } from './global-flags';
+/**
+ * Processes a CLI command result, handling both success and error cases.
+ * Formats output appropriately and returns the exit code.
+ * Never throws - returns exit code for commands to use with process.exit().
+ *
+ * @param result - The result from a CLI command
+ * @param flags - Global flags for output formatting
+ * @param onSuccess - Optional callback for successful results (for custom success output)
+ * @returns The exit code that should be used (0 for success, non-zero for errors)
+ */
+export declare function handleResult<T>(result: Result<T, CliStructuredError>, flags: GlobalFlags, onSuccess?: (value: T) => void): number;
+//# sourceMappingURL=result-handler.d.ts.map

package/dist/utils/result-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-handler.d.ts","sourceRoot":"","sources":["../../src/utils/result-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,kBAAkB,CAAC,EACrC,KAAK,EAAE,WAAW,EAClB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAC7B,MAAM,CAwBR"}

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@prisma-next/cli",
-  "version": "0.3.0-dev.3",
+  "version": "0.3.0-dev.30",
   "type": "module",
   "sideEffects": false,
   "files": [
-    "dist"
+    "dist",
+    "src"
   ],
   "bin": {
     "prisma-next": "./dist/cli.js"
@@ -19,33 +20,32 @@
     "string-width": "^7.2.0",
     "strip-ansi": "^7.1.2",
     "wrap-ansi": "^9.0.2",
-    "@prisma-next/contract": "0.3.0-dev.3",
-    "@prisma-next/core-control-plane": "0.3.0-dev.3",
-    "@prisma-next/emitter": "0.3.0-dev.3",
-    "@prisma-next/utils": "0.3.0-dev.3"
+    "@prisma-next/contract": "0.3.0-dev.30",
+    "@prisma-next/core-control-plane": "0.3.0-dev.30",
+    "@prisma-next/emitter": "0.3.0-dev.30",
+    "@prisma-next/utils": "0.3.0-dev.30"
   },
   "devDependencies": {
     "@types/node": "24.10.4",
-    "@vitest/coverage-v8": "^4.0.0",
-    "tsup": "^8.3.0",
-    "typescript": "^5.9.3",
-    "vite-tsconfig-paths": "^5.1.4",
-    "vitest": "^4.0.16",
-    "@prisma-next/sql-contract": "0.3.0-dev.3",
-    "@prisma-next/sql-contract-emitter": "0.3.0-dev.3",
-    "@prisma-next/sql-contract-ts": "0.3.0-dev.3",
-    "@prisma-next/sql-operations": "0.3.0-dev.3",
-    "@prisma-next/sql-runtime": "0.3.0-dev.3",
-    "@prisma-next/test-utils": "0.0.1"
+    "tsup": "8.5.1",
+    "typescript": "5.9.3",
+    "vitest": "4.0.16",
+    "@prisma-next/sql-contract": "0.3.0-dev.30",
+    "@prisma-next/sql-contract-emitter": "0.3.0-dev.30",
+    "@prisma-next/sql-contract-ts": "0.3.0-dev.30",
+    "@prisma-next/sql-operations": "0.3.0-dev.30",
+    "@prisma-next/sql-runtime": "0.3.0-dev.30",
+    "@prisma-next/test-utils": "0.0.1",
+    "@prisma-next/tsconfig": "0.0.0"
   },
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "types": "./dist/exports/index.d.ts",
+      "import": "./dist/exports/index.js"
     },
     "./config-types": {
-      "types": "./dist/config-types.d.ts",
-      "import": "./dist/config-types.js"
+      "types": "./dist/exports/config-types.d.ts",
+      "import": "./dist/exports/config-types.js"
     },
     "./commands/db-init": {
       "types": "./dist/commands/db-init.d.ts",
@@ -74,16 +74,20 @@
     "./config-loader": {
       "types": "./dist/config-loader.d.ts",
       "import": "./dist/config-loader.js"
+    },
+    "./control-api": {
+      "types": "./dist/exports/control-api.d.ts",
+      "import": "./dist/exports/control-api.js"
     }
   },
   "scripts": {
-    "build": "tsup --config tsup.config.ts",
+    "build": "tsup --config tsup.config.ts && tsc --project tsconfig.build.json",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --project tsconfig.json --noEmit",
-    "lint": "biome check . --config-path ../../../../biome.json --error-on-warnings",
-    "lint:fix": "biome check --write . --config-path ../../../../biome.json",
-    "lint:fix:unsafe": "biome check --write --unsafe . --config-path ../../../../biome.json",
-    "clean": "node ../../../../scripts/clean.mjs"
+    "lint": "biome check . --error-on-warnings",
+    "lint:fix": "biome check --write .",
+    "lint:fix:unsafe": "biome check --write --unsafe .",
+    "clean": "rm -rf dist dist-tsc dist-tsc-prod coverage .tmp-output"
   }
 }

package/src/cli.ts

@@ -0,0 +1,260 @@
+import { Command } from 'commander';
+import { createContractEmitCommand } from './commands/contract-emit';
+import { createDbInitCommand } from './commands/db-init';
+import { createDbIntrospectCommand } from './commands/db-introspect';
+import { createDbSchemaVerifyCommand } from './commands/db-schema-verify';
+import { createDbSignCommand } from './commands/db-sign';
+import { createDbVerifyCommand } from './commands/db-verify';
+import { setCommandDescriptions } from './utils/command-helpers';
+import { parseGlobalFlags } from './utils/global-flags';
+import { formatCommandHelp, formatRootHelp } from './utils/output';
+
+const program = new Command();
+
+program.name('prisma-next').description('Prisma Next CLI').version('0.0.1');
+
+// Override version option description to match capitalization style
+const versionOption = program.options.find((opt) => opt.flags.includes('--version'));
+if (versionOption) {
+  versionOption.description = 'Output the version number';
+}
+
+program.configureOutput({
+  writeErr: () => {
+    // Suppress all default error output - we handle errors in exitOverride
+  },
+  writeOut: () => {
+    // Suppress all default output - our custom formatters handle everything
+  },
+});
+
+// Customize root help output to use our styled format
+const rootHelpFormatter = (cmd: Command) => {
+  const flags = parseGlobalFlags({});
+  return formatRootHelp({ program: cmd, flags });
+};
+
+program.configureHelp({
+  formatHelp: rootHelpFormatter,
+  subcommandDescription: () => '',
+});
+
+// Override exit to handle unhandled errors (fail fast cases)
+// Commands handle structured errors themselves via process.exit()
+program.exitOverride((err) => {
+  if (err) {
+    // Help requests are not errors - allow Commander to output help and exit normally
+    // Commander throws errors with codes like 'commander.help', 'commander.helpDisplayed', or 'outputHelp'
+    const errorCode = (err as { code?: string }).code;
+    const errorMessage = String(err.message ?? '');
+    const errorName = err.name ?? '';
+
+    // Check for unknown command errors first (before other checks)
+    // Commander.js uses code 'commander.unknownCommand' or error message contains 'unknown command'
+    const isUnknownCommandError =
+      errorCode === 'commander.unknownCommand' ||
+      errorCode === 'commander.unknownArgument' ||
+      (errorName === 'CommanderError' &&
+        (errorMessage.includes('unknown command') || errorMessage.includes('unknown argument')));
+    if (isUnknownCommandError) {
+      const flags = parseGlobalFlags({});
+      // Extract the command/subcommand name from the error message
+      // Error message format: "unknown command 'command-name'"
+      const match = errorMessage.match(/unknown command ['"]([^'"]+)['"]/);
+      const commandName = match ? match[1] : process.argv[3] || process.argv[2] || 'unknown';
+
+      // Determine which command context we're in
+      // Check if the first argument is a recognized parent command
+      const firstArg = process.argv[2];
+      const parentCommand = firstArg
+        ? program.commands.find((cmd) => cmd.name() === firstArg)
+        : undefined;
+
+      if (parentCommand && commandName !== firstArg) {
+        // Unrecognized subcommand - show parent command help
+        // eslint-disable-next-line no-console
+        console.error(`Unknown command: ${commandName}`);
+        // eslint-disable-next-line no-console
+        console.error('');
+        const helpText = formatCommandHelp({ command: parentCommand, flags });
+        // eslint-disable-next-line no-console
+        console.log(helpText);
+      } else {
+        // Unrecognized top-level command - show root help
+        // eslint-disable-next-line no-console
+        console.error(`Unknown command: ${commandName}`);
+        // eslint-disable-next-line no-console
+        console.error('');
+        const helpText = formatRootHelp({ program, flags });
+        // eslint-disable-next-line no-console
+        console.log(helpText);
+      }
+      process.exit(1);
+      return;
+    }
+    const isHelpError =
+      errorCode === 'commander.help' ||
+      errorCode === 'commander.helpDisplayed' ||
+      errorCode === 'outputHelp' ||
+      errorMessage === '(outputHelp)' ||
+      errorMessage.includes('outputHelp') ||
+      (errorName === 'CommanderError' && errorMessage.includes('outputHelp'));
+    if (isHelpError) {
+      process.exit(0);
+      return;
+    }
+    // Missing required arguments/subcommands - show help and exit with 0
+    // Commander throws errors with code 'commander.missingArgument' or 'commander.missingMandatoryOptionValue'
+    // or when a command with subcommands is called without a subcommand
+    const isMissingArgumentError =
+      errorCode === 'commander.missingArgument' ||
+      errorCode === 'commander.missingMandatoryOptionValue' ||
+      (errorName === 'CommanderError' &&
+        (errorMessage.includes('missing') || errorMessage.includes('required')));
+    if (isMissingArgumentError) {
+      // Help was already displayed by Commander.js, just exit with 0
+      process.exit(0);
+      return;
+    }
+    // Unhandled error - fail fast with exit code 1
+    // eslint-disable-next-line no-console
+    console.error(`Unhandled error: ${err.message}`);
+    if (err.stack) {
+      // eslint-disable-next-line no-console
+      console.error(err.stack);
+    }
+    process.exit(1);
+  }
+  process.exit(0);
+});
+
+// Register contract subcommand
+const contractCommand = new Command('contract');
+setCommandDescriptions(
+  contractCommand,
+  'Contract management commands',
+  'Define and emit your application data contract. The contract describes your schema as a\n' +
+    'declarative data structure that can be signed and verified against your database.',
+);
+contractCommand.configureHelp({
+  formatHelp: (cmd) => {
+    const flags = parseGlobalFlags({});
+    return formatCommandHelp({ command: cmd, flags });
+  },
+  subcommandDescription: () => '',
+});
+
+// Add emit subcommand to contract
+const contractEmitCommand = createContractEmitCommand();
+contractCommand.addCommand(contractEmitCommand);
+
+// Register contract command
+program.addCommand(contractCommand);
+
+// Register db subcommand
+const dbCommand = new Command('db');
+setCommandDescriptions(
+  dbCommand,
+  'Database management commands',
+  'Verify and sign your database with your contract. Ensure your database schema matches\n' +
+    'your contract, and sign it to record the contract hash for future verification.',
+);
+dbCommand.configureHelp({
+  formatHelp: (cmd) => {
+    const flags = parseGlobalFlags({});
+    return formatCommandHelp({ command: cmd, flags });
+  },
+  subcommandDescription: () => '',
+});
+
+// Add verify subcommand to db
+const dbVerifyCommand = createDbVerifyCommand();
+dbCommand.addCommand(dbVerifyCommand);
+
+// Add init subcommand to db
+const dbInitCommand = createDbInitCommand();
+dbCommand.addCommand(dbInitCommand);
+
+// Add introspect subcommand to db
+const dbIntrospectCommand = createDbIntrospectCommand();
+dbCommand.addCommand(dbIntrospectCommand);
+
+// Add schema-verify subcommand to db
+const dbSchemaVerifyCommand = createDbSchemaVerifyCommand();
+dbCommand.addCommand(dbSchemaVerifyCommand);
+
+// Add sign subcommand to db
+const dbSignCommand = createDbSignCommand();
+dbCommand.addCommand(dbSignCommand);
+
+// Register db command
+program.addCommand(dbCommand);
+
+// Create help command
+const helpCommand = new Command('help')
+  .description('Show usage instructions')
+  .configureHelp({
+    formatHelp: (cmd) => {
+      const flags = parseGlobalFlags({});
+      return formatCommandHelp({ command: cmd, flags });
+    },
+  })
+  .action(() => {
+    const flags = parseGlobalFlags({});
+    const helpText = formatRootHelp({ program, flags });
+    // eslint-disable-next-line no-console
+    console.log(helpText);
+    process.exit(0);
+  });
+
+program.addCommand(helpCommand);
+
+// Set help as the default action when no command is provided
+program.action(() => {
+  const flags = parseGlobalFlags({});
+  const helpText = formatRootHelp({ program, flags });
+  // eslint-disable-next-line no-console
+  console.log(helpText);
+  process.exit(0);
+});
+
+// Check if a command was invoked with no arguments (just the command name)
+// or if an unrecognized command was provided
+const args = process.argv.slice(2);
+if (args.length > 0) {
+  const commandName = args[0];
+  // Handle version option explicitly since we suppress default output
+  if (commandName === '--version' || commandName === '-V') {
+    // eslint-disable-next-line no-console
+    console.log(program.version());
+    process.exit(0);
+  }
+  // Skip command check for global options like --help, -h
+  const isGlobalOption = commandName === '--help' || commandName === '-h';
+  if (!isGlobalOption) {
+    // Check if this is a recognized command
+    const command = program.commands.find((cmd) => cmd.name() === commandName);
+
+    if (!command) {
+      // Unrecognized command - show error message and usage
+      const flags = parseGlobalFlags({});
+      // eslint-disable-next-line no-console
+      console.error(`Unknown command: ${commandName}`);
+      // eslint-disable-next-line no-console
+      console.error('');
+      const helpText = formatRootHelp({ program, flags });
+      // eslint-disable-next-line no-console
+      console.log(helpText);
+      process.exit(1);
+    } else if (command.commands.length > 0 && args.length === 1) {
+      // Parent command called with no subcommand - show help and exit with 0
+      const flags = parseGlobalFlags({});
+      const helpText = formatCommandHelp({ command, flags });
+      // eslint-disable-next-line no-console
+      console.log(helpText);
+      process.exit(0);
+    }
+  }
+}
+
+program.parse();