@prisma-next/cli 0.16.0-dev.20 → 0.16.0-dev.22

package/src/control-api/contract-enrichment.ts

@@ -65,21 +65,21 @@ export function enrichContract(
 ): Contract {
   const mergedCapabilities = mergeCapabilityMatrices(ir.capabilities, components);
 
-  const extensionPacksMeta: Record<string, unknown> = {};
+  const extensionsMeta: Record<string, unknown> = {};
   for (const component of components) {
     if (component.kind === 'extension') {
-      extensionPacksMeta[component.id] = extractExtensionPackMeta(component);
+      extensionsMeta[component.id] = extractExtensionPackMeta(component);
     }
   }
 
-  const extensionPacks =
-    Object.keys(extensionPacksMeta).length > 0
-      ? { ...ir.extensionPacks, ...extensionPacksMeta }
-      : ir.extensionPacks;
+  const extensions =
+    Object.keys(extensionsMeta).length > 0
+      ? { ...ir.extensions, ...extensionsMeta }
+      : ir.extensions;
 
   return {
     ...ir,
     capabilities: sortDeepTyped(mergedCapabilities),
-    extensionPacks: sortDeepTyped(extensionPacks),
+    extensions: sortDeepTyped(extensions),
   };
 }

package/src/control-api/operations/contract-emit.ts

@@ -195,7 +195,7 @@ export async function executeContractEmit(
     const stack = createControlStack(config);
 
     const sourceContext = {
-      composedExtensionPacks: stack.extensionPacks.map((p) => p.id),
+      composedExtensions: stack.extensions.map((p) => p.id),
       composedExtensionContracts: stack.extensionContracts,
       authoringContributions: stack.authoringContributions,
       codecLookup: stack.codecLookup,
@@ -230,7 +230,7 @@ export async function executeContractEmit(
     let emitResult: Awaited<ReturnType<typeof emit>>;
     try {
       const familyInstance = config.family.create(stack);
-      const rawComponents = [config.target, config.adapter, ...(config.extensionPacks ?? [])];
+      const rawComponents = [config.target, config.adapter, ...(config.extensions ?? [])];
       const frameworkComponents = assertFrameworkComponentsCompatible(
         config.family.familyId,
         config.target.targetId,

package/src/control-api/operations/db-init.ts

@@ -25,7 +25,7 @@ import { executeRun } from './db-run';
  * 3. The runner's `execute` applies the per-space plans
  *    inside one outer transaction.
  *
- * `extensionPacks` mirrors `Config.extensionPacks` (descriptor list).
+ * `extensions` mirrors `Config.extensions` (descriptor list).
  * The loader (sub-spec § Loader) is the sole descriptor-import boundary.
  */
 export interface ExecuteDbInitOptions<TFamilyId extends string, TTargetId extends string> {
@@ -55,7 +55,7 @@ export interface ExecuteDbInitOptions<TFamilyId extends string, TTargetId extend
    * routes through the same loader → planner → runner pipeline with no
    * extension spaces in the aggregate.
    */
-  readonly extensionPacks?: ReadonlyArray<ControlExtensionDescriptor<TFamilyId, TTargetId>>;
+  readonly extensions?: ReadonlyArray<ControlExtensionDescriptor<TFamilyId, TTargetId>>;
   /** Optional progress callback for observing operation progress */
   readonly onProgress?: OnControlProgress;
 }
@@ -80,7 +80,7 @@ export async function executeDbInit<TFamilyId extends string, TTargetId extends
     frameworkComponents: options.frameworkComponents,
     migrationsDir: options.migrationsDir,
     targetId: options.targetId,
-    extensionPacks: options.extensionPacks ?? [],
+    extensions: options.extensions ?? [],
     policy: { allowedOperationClasses: ['additive'] },
     action: 'dbInit',
     ...ifDefined('onProgress', options.onProgress),

package/src/control-api/operations/db-run.ts

@@ -80,7 +80,7 @@ export interface ExecuteRunOptions<TFamilyId extends string, TTargetId extends s
   >;
   readonly frameworkComponents: ReadonlyArray<TargetBoundComponentDescriptor<TFamilyId, TTargetId>>;
   readonly migrationsDir: string;
-  readonly extensionPacks: ReadonlyArray<ControlExtensionDescriptor<TFamilyId, TTargetId>>;
+  readonly extensions: ReadonlyArray<ControlExtensionDescriptor<TFamilyId, TTargetId>>;
   readonly targetId: TTargetId;
   readonly policy: MigrationOperationPolicy;
   readonly action: 'dbInit' | 'dbUpdate';
@@ -119,7 +119,7 @@ export async function executeRun<TFamilyId extends string, TTargetId extends str
     migrations,
     frameworkComponents,
     migrationsDir,
-    extensionPacks,
+    extensions,
     targetId,
     policy,
     action,
@@ -131,7 +131,7 @@ export async function executeRun<TFamilyId extends string, TTargetId extends str
     targetId,
     migrationsDir,
     appContract: contract,
-    extensionPacks,
+    extensions,
     deserializeContract: (json) => familyInstance.deserializeContract(json),
   };
   const loaded = await buildContractSpaceAggregate(loadInputs);
@@ -283,7 +283,7 @@ function aggregatePlannerWarnings(
  * Compare the live `_prisma_marker` rows against the aggregate's
  * declared contract spaces. Any marker row whose `space` is not a space of
  * the aggregate is an "orphan" — typically a marker left behind by
- * an extension that was removed from `extensionPacks` without first
+ * an extension that was removed from `extensions` without first
  * cleaning up its on-disk migrations / database tables.
  *
  * Returns a {@link CliStructuredError} envelope (code
@@ -319,8 +319,8 @@ function detectOrphanMarkers(
       .map((s) => `"${s}"`)
       .join(
         ', ',
-      )}) that are not declared in the project's \`extensionPacks\`. The aggregate pipeline refuses to advance markers it cannot account for.`,
-    fix: 'Either re-declare the missing extension(s) in `extensionPacks` (so the aggregate owns them again), or remove the orphan marker row(s) from `_prisma_marker` once you have confirmed the corresponding tables can be safely retired.',
+      )}) that are not declared in the project's \`extensions\`. The aggregate pipeline refuses to advance markers it cannot account for.`,
+    fix: 'Either re-declare the missing extension(s) in `extensions` (so the aggregate owns them again), or remove the orphan marker row(s) from `_prisma_marker` once you have confirmed the corresponding tables can be safely retired.',
     docsUrl: 'https://pris.ly/contract-spaces',
     meta: {
       violations: orphans.map((spaceId) => ({ kind: 'orphanMarker', spaceId })),

package/src/control-api/operations/db-update.ts

@@ -40,7 +40,7 @@ export interface ExecuteDbUpdateOptions<TFamilyId extends string, TTargetId exte
   readonly acceptDataLoss?: boolean;
   readonly migrationsDir: string;
   readonly targetId: TTargetId;
-  readonly extensionPacks?: ReadonlyArray<ControlExtensionDescriptor<TFamilyId, TTargetId>>;
+  readonly extensions?: ReadonlyArray<ControlExtensionDescriptor<TFamilyId, TTargetId>>;
   readonly onProgress?: OnControlProgress;
 }
 
@@ -65,7 +65,7 @@ export async function executeDbUpdate<TFamilyId extends string, TTargetId extend
     frameworkComponents: options.frameworkComponents,
     migrationsDir: options.migrationsDir,
     targetId: options.targetId,
-    extensionPacks: options.extensionPacks ?? [],
+    extensions: options.extensions ?? [],
     policy: DB_UPDATE_POLICY,
     action: 'dbUpdate' as const,
     ...ifDefined('onProgress', options.onProgress),

package/src/control-api/operations/db-verify.ts

@@ -50,7 +50,7 @@ export interface ExecuteDbVerifyOptions<TFamilyId extends string, TTargetId exte
   readonly contract: Contract;
   readonly migrationsDir: string;
   readonly targetId: TTargetId;
-  readonly extensionPacks: ReadonlyArray<ControlExtensionDescriptor<TFamilyId, TTargetId>>;
+  readonly extensions: ReadonlyArray<ControlExtensionDescriptor<TFamilyId, TTargetId>>;
   readonly frameworkComponents: ReadonlyArray<TargetBoundComponentDescriptor<TFamilyId, TTargetId>>;
   readonly mode: 'strict' | 'lenient';
   readonly skipSchema: boolean;
@@ -149,7 +149,7 @@ function buildLoadInputs<TFamilyId extends string, TTargetId extends string>(
     targetId: options.targetId,
     migrationsDir: options.migrationsDir,
     appContract: options.contract,
-    extensionPacks: options.extensionPacks,
+    extensions: options.extensions,
     deserializeContract: (json) => options.familyInstance.deserializeContract(json),
   };
 }
@@ -349,7 +349,7 @@ function mapMarkerCheckFailures(
     violations.push({
       kind: 'orphanMarker',
       spaceId: orphan.spaceId,
-      remediation: `Add the corresponding extension to \`extensionPacks\` in \`prisma-next.config.ts\`, or delete the orphan marker row for "${orphan.spaceId}".`,
+      remediation: `Add the corresponding extension to \`extensions\` in \`prisma-next.config.ts\`, or delete the orphan marker row for "${orphan.spaceId}".`,
     });
   }
   if (violations.length === 0) return null;
@@ -359,7 +359,7 @@ function mapMarkerCheckFailures(
       ? 'Contract-space verifier found a violation'
       : `Contract-space verifier found violations (${violations.length})`;
   return new CliStructuredError('MIGRATION.CONTRACT_SPACE_VIOLATION', summary, {
-    why: `The on-disk \`migrations/\` directory, the \`extensionPacks\` declaration, and the live database marker rows are not in agreement.\n${lines.join('\n')}`,
+    why: `The on-disk \`migrations/\` directory, the \`extensions\` declaration, and the live database marker rows are not in agreement.\n${lines.join('\n')}`,
     fix: violations[0]?.remediation ?? 'Review and reconcile the violations listed above.',
     docsUrl: 'https://pris.ly/contract-spaces',
     meta: { violations },

package/src/control-api/operations/format.ts

@@ -42,7 +42,7 @@ export async function executeFormat(
   }
 
   const source = config.contract?.source;
-  if (source?.sourceFormat !== 'psl') {
+  if (source?.format !== 'psl') {
     return ok({ formatted: false });
   }
 

package/src/control-api/operations/migrate.ts

@@ -60,7 +60,7 @@ export interface ExecuteMigrateOptions<TFamilyId extends string, TTargetId exten
   >;
   readonly frameworkComponents: ReadonlyArray<TargetBoundComponentDescriptor<TFamilyId, TTargetId>>;
   readonly migrationsDir: string;
-  readonly extensionPacks: ReadonlyArray<ControlExtensionDescriptor<TFamilyId, TTargetId>>;
+  readonly extensions: ReadonlyArray<ControlExtensionDescriptor<TFamilyId, TTargetId>>;
   readonly targetId: TTargetId;
   /**
    * Optional app-space ref override. When provided, the app space's
@@ -122,7 +122,7 @@ export async function executeMigrate<TFamilyId extends string, TTargetId extends
     migrations,
     frameworkComponents,
     migrationsDir,
-    extensionPacks,
+    extensions,
     targetId,
     refHash,
     refInvariants,
@@ -134,7 +134,7 @@ export async function executeMigrate<TFamilyId extends string, TTargetId extends
     targetId,
     migrationsDir,
     appContract: contract,
-    extensionPacks,
+    extensions,
     deserializeContract: (json) => familyInstance.deserializeContract(json),
   };
   const loaded = await buildContractSpaceAggregate(loadInputs);

package/src/control-api/types.ts

@@ -52,7 +52,7 @@ export interface ControlClientOptions {
   // biome-ignore lint/suspicious/noExplicitAny: required for contravariance in driver.create()
   readonly driver?: ControlDriverDescriptor<any, any, any, any>;
   // biome-ignore lint/suspicious/noExplicitAny: required for contravariance in extension.create()
-  readonly extensionPacks?: ReadonlyArray<ControlExtensionDescriptor<any, any, any>>;
+  readonly extensions?: ReadonlyArray<ControlExtensionDescriptor<any, any, any>>;
   /**
    * Optional default connection for auto-connect.
    * When provided, operations will auto-connect if not already connected.

package/src/utils/cli-errors.ts

@@ -10,7 +10,7 @@ import {
   errorConfigFileNotFound,
   errorConfigValidation,
   errorContractConfigMissing,
-  errorContractMissingExtensionPacks,
+  errorContractMissingExtensions,
   errorContractValidationFailed,
   errorDatabaseConnectionRequired,
   errorDriverRequired,
@@ -54,7 +54,7 @@ export {
   errorConfigFileNotFound,
   errorConfigValidation,
   errorContractConfigMissing,
-  errorContractMissingExtensionPacks,
+  errorContractMissingExtensions,
   errorContractValidationFailed,
   errorDatabaseConnectionRequired,
   errorDriverRequired,

package/src/utils/contract-space-aggregate-loader.ts

@@ -114,8 +114,8 @@ export function mapIntegrityViolations(
         ? 'Contract-space layout violation detected'
         : `Contract-space layout violations detected (${layout.length})`;
     return new CliStructuredError('MIGRATION.CONTRACT_SPACE_LAYOUT_VIOLATION', summary, {
-      why: `The on-disk \`migrations/\` directory and your \`extensionPacks\` declaration are not in agreement.\n${lines.join('\n')}`,
-      fix: 'Declare the extension in `extensionPacks` and re-emit its contract-space artefacts, or remove the orphan `migrations/<space>` directory.',
+      why: `The on-disk \`migrations/\` directory and your \`extensions\` declaration are not in agreement.\n${lines.join('\n')}`,
+      fix: 'Declare the extension in `extensions` and re-emit its contract-space artefacts, or remove the orphan `migrations/<space>` directory.',
       docsUrl: CONTRACT_SPACES_DOCS_URL,
       meta: { violations: layout },
     });
@@ -177,14 +177,14 @@ export interface BuildAggregateInputs<TFamilyId extends string, TTargetId extend
   readonly targetId: TTargetId;
   readonly migrationsDir: string;
   readonly appContract: Contract;
-  readonly extensionPacks: ReadonlyArray<ControlExtensionDescriptor<TFamilyId, TTargetId>>;
+  readonly extensions: ReadonlyArray<ControlExtensionDescriptor<TFamilyId, TTargetId>>;
   readonly deserializeContract: (contractJson: unknown) => Contract;
 }
 
 function declaredExtensionsFromInputs(
-  extensionPacks: BuildAggregateInputs<string, string>['extensionPacks'],
+  extensions: BuildAggregateInputs<string, string>['extensions'],
 ): readonly DeclaredExtensionEntry[] {
-  return toDeclaredExtensionsFromRaw(extensionPacks as ReadonlyArray<unknown>);
+  return toDeclaredExtensionsFromRaw(extensions as ReadonlyArray<unknown>);
 }
 
 /**
@@ -195,7 +195,7 @@ export function refuseDeclaredExtensionTargetMismatch<
   TFamilyId extends string,
   TTargetId extends string,
 >(inputs: BuildAggregateInputs<TFamilyId, TTargetId>): CliStructuredError | null {
-  for (const declared of declaredExtensionsFromInputs(inputs.extensionPacks)) {
+  for (const declared of declaredExtensionsFromInputs(inputs.extensions)) {
     if (declared.targetId !== inputs.targetId) {
       return targetMismatchError(declared.id, inputs.targetId, declared.targetId);
     }
@@ -271,7 +271,7 @@ export async function buildContractSpaceAggregate<
 >(
   inputs: BuildAggregateInputs<TFamilyId, TTargetId>,
 ): Promise<Result<ContractSpaceAggregate, CliStructuredError>> {
-  const declaredExtensions = declaredExtensionsFromInputs(inputs.extensionPacks);
+  const declaredExtensions = declaredExtensionsFromInputs(inputs.extensions);
   const loaded = await loadContractSpaceAggregateForCli(inputs);
   if (!loaded.ok) {
     return loaded;
@@ -375,7 +375,7 @@ export async function buildReadAggregate(
       targetId: config.target.id,
       migrationsDir: options.migrationsDir,
       appContract: appContractForLoad,
-      extensionPacks: config.extensionPacks ?? [],
+      extensions: config.extensions ?? [],
       deserializeContract,
     });
     if (!loaded.ok) {

package/src/utils/contract-space-seed-phase.ts

@@ -39,7 +39,7 @@ export interface SeedPhaseExtensionInput {
 
 export interface ContractSpaceSeedPhaseInputs {
   readonly migrationsDir: string;
-  readonly extensionPacks: ReadonlyArray<SeedPhaseExtensionInput>;
+  readonly extensions: ReadonlyArray<SeedPhaseExtensionInput>;
 }
 
 /**
@@ -98,7 +98,7 @@ export interface ContractSpaceSeedPhaseResult {
 export async function runContractSpaceSeedPhase(
   inputs: ContractSpaceSeedPhaseInputs,
 ): Promise<ContractSpaceSeedPhaseResult> {
-  const planInputs = inputs.extensionPacks
+  const planInputs = inputs.extensions
     .filter(
       (
         pack,
@@ -134,7 +134,7 @@ export async function runContractSpaceSeedPhase(
     string,
     NonNullable<SeedPhaseExtensionInput['contractSpace']>
   >();
-  for (const pack of inputs.extensionPacks) {
+  for (const pack of inputs.extensions) {
     if (pack.contractSpace !== undefined) descriptorBySpace.set(pack.id, pack.contractSpace);
   }
 

package/src/utils/extension-pack-inputs.ts

@@ -1,5 +1,5 @@
 /**
- * Single descriptor-import boundary for CLI consumers of `Config.extensionPacks`.
+ * Single descriptor-import boundary for CLI consumers of `Config.extensions`.
  *
  * Every CLI command / utility that reads an extension descriptor's
  * `contractSpace` projection (loader, migrate-pass, extension-migrations
@@ -54,9 +54,9 @@ export interface ExtensionPackInput {
 }
 
 /**
- * Structural shape we read off each `Config.extensionPacks` entry.
+ * Structural shape we read off each `Config.extensions` entry.
  *
- * The CLI is the descriptor-import boundary; `extensionPacks` is the only
+ * The CLI is the descriptor-import boundary; `extensions` is the only
  * surface where the SQL-family-typed `ControlExtensionDescriptor` flows
  * into framework-neutral helpers. The structural cast lives here, and
  * here alone — every other CLI consumer reads the canonical
@@ -76,14 +76,14 @@ type ExtensionPackLike = {
 };
 
 /**
- * Project the CLI's `Config.extensionPacks` array into the canonical
+ * Project the CLI's `Config.extensions` array into the canonical
  * {@link ExtensionPackInput} shape. The single `as ExtensionPackLike`
  * structural cast in the CLI lives inside this function.
  */
 export function toExtensionInputs(
-  extensionPacks: ReadonlyArray<unknown>,
+  extensions: ReadonlyArray<unknown>,
 ): readonly ExtensionPackInput[] {
-  return extensionPacks.map((raw) => {
+  return extensions.map((raw) => {
     const pack = raw as ExtensionPackLike;
     if (pack.contractSpace === undefined) {
       return { id: pack.id, targetId: pack.targetId };
@@ -147,10 +147,10 @@ export function toDeclaredExtensions(
  * always reads the contract from on-disk artefacts instead.
  */
 export function toDeclaredExtensionsFromRaw(
-  extensionPacks: ReadonlyArray<unknown>,
+  extensions: ReadonlyArray<unknown>,
 ): readonly DeclaredExtensionEntry[] {
   const entries: DeclaredExtensionEntry[] = [];
-  for (const raw of extensionPacks) {
+  for (const raw of extensions) {
     if (typeof raw !== 'object' || raw === null) continue;
     const descriptor = Object.getOwnPropertyDescriptor(raw, 'contractSpace');
     if (descriptor === undefined) continue;

package/src/utils/framework-components.ts

@@ -4,7 +4,7 @@ import {
   type TargetBoundComponentDescriptor,
 } from '@prisma-next/framework-components/components';
 import type { ControlStack } from '@prisma-next/framework-components/control';
-import { errorConfigValidation, errorContractMissingExtensionPacks } from './cli-errors';
+import { errorConfigValidation, errorContractMissingExtensions } from './cli-errors';
 
 /**
  * Asserts that all framework components are compatible with the expected family and target.
@@ -27,7 +27,7 @@ import { errorConfigValidation, errorContractMissingExtensionPacks } from './cli
  * @example
  * ```ts
  * const config = await loadConfig();
- * const frameworkComponents = [config.target, config.adapter, ...(config.extensionPacks ?? [])];
+ * const frameworkComponents = [config.target, config.adapter, ...(config.extensions ?? [])];
  *
  * // Validate and type-narrow components before passing to planner
  * const typedComponents = assertFrameworkComponentsCompatible(
@@ -114,12 +114,12 @@ export function assertFrameworkComponentsCompatible<
  * This check ensures the emitted contract matches the CLI config before running
  * commands that depend on the contract (e.g., db verify, db sign).
  *
- * @param contract - The contract to validate (must include targetFamily, target, extensionPacks).
- * @param stack - The control plane stack (target, adapter, driver, extensionPacks).
+ * @param contract - The contract to validate (must include targetFamily, target, extensions).
+ * @param stack - The control plane stack (target, adapter, driver, extensions).
  *
  * @throws {CliStructuredError} errorConfigValidation when contract.targetFamily or contract.target
  *   doesn't match the configured family/target.
- * @throws {CliStructuredError} errorContractMissingExtensionPacks when the contract requires
+ * @throws {CliStructuredError} errorContractMissingExtensions when the contract requires
  *   extension packs that are not provided in the config (includes all missing packs in error.meta).
  *
  * @example
@@ -141,14 +141,14 @@ export function assertContractRequirementsSatisfied<
   contract,
   stack,
 }: {
-  readonly contract: Pick<Contract, 'targetFamily' | 'target' | 'extensionPacks'>;
+  readonly contract: Pick<Contract, 'targetFamily' | 'target' | 'extensions'>;
   readonly stack: ControlStack<TFamilyId, TTargetId>;
 }): void {
   const providedComponentIds = new Set<string>([
     stack.target.id,
     ...(stack.adapter ? [stack.adapter.id] : []),
   ]);
-  for (const extension of stack.extensionPacks) {
+  for (const extension of stack.extensions) {
     providedComponentIds.add(extension.id);
   }
 
@@ -172,8 +172,8 @@ export function assertContractRequirementsSatisfied<
   }
 
   if (result.missingExtensionPackIds.length > 0) {
-    throw errorContractMissingExtensionPacks({
-      missingExtensionPacks: result.missingExtensionPackIds,
+    throw errorContractMissingExtensions({
+      missingExtensions: result.missingExtensionPackIds,
       providedComponentIds: [...providedComponentIds],
     });
   }

package/src/utils/integrity-violation-to-check-failure.ts

@@ -69,15 +69,15 @@ export function integrityViolationToCheckFailure(
         code: 'MIGRATION.CHECK_ORPHAN_SPACE_DIR',
         where: spaceRelative(violation.spaceId),
         why: `Contract-space directory "${violation.spaceId}" exists on disk but no extension declares it.`,
-        fix: 'Remove the orphan directory, or declare the extension in `extensionPacks`.',
+        fix: 'Remove the orphan directory, or declare the extension in `extensions`.',
       };
     case 'declaredButUnmigrated':
       return {
         space: violation.spaceId,
         code: 'MIGRATION.CHECK_DECLARED_BUT_UNMIGRATED',
         where: spaceRelative(violation.spaceId),
-        why: `Extension "${violation.spaceId}" is declared in \`extensionPacks\` but has no on-disk migrations directory.`,
-        fix: 'Re-emit the extension contract-space artefacts with `prisma-next contract emit` and migration planning, or remove the extension from `extensionPacks` if it is unused.',
+        why: `Extension "${violation.spaceId}" is declared in \`extensions\` but has no on-disk migrations directory.`,
+        fix: 'Re-emit the extension contract-space artefacts with `prisma-next contract emit` and migration planning, or remove the extension from `extensions` if it is unused.',
       };
     case 'headRefMissing':
       return {

package/src/utils/migration-command-scaffold.ts

@@ -154,7 +154,7 @@ export async function prepareMigrationContext(
     target: config.target,
     adapter: config.adapter,
     driver: config.driver,
-    extensionPacks: config.extensionPacks ?? [],
+    extensions: config.extensions ?? [],
   });
 
   // Create progress adapter