@prisma-next/core-control-plane 0.3.0-pr.93.5 → 0.3.0-pr.94.2

package/dist/emission.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"emission.mjs","names":["result: Record<string, unknown>","sorted: Record<string, unknown>","result: StorageObject","sortedTable: TableObject","ordered: Record<string, unknown>","normalized: NormalizedContract","ctx: ValidationContext","contractWithHashes: ContractIR & { coreHash?: string; profileHash?: string }"],"sources":["../src/emission/canonicalization.ts","../src/emission/hashing.ts","../src/emission/emit.ts"],"sourcesContent":["import type { ContractIR } from '@prisma-next/contract/ir';\nimport { isArrayEqual } from '@prisma-next/utils/array-equal';\n\ntype NormalizedContract = {\n  schemaVersion: string;\n  targetFamily: string;\n  target: string;\n  coreHash?: string;\n  profileHash?: string;\n  models: Record<string, unknown>;\n  relations: Record<string, unknown>;\n  storage: Record<string, unknown>;\n  extensionPacks: Record<string, unknown>;\n  capabilities: Record<string, Record<string, boolean>>;\n  meta: Record<string, unknown>;\n  sources: Record<string, unknown>;\n};\n\nconst TOP_LEVEL_ORDER = [\n  'schemaVersion',\n  'canonicalVersion',\n  'targetFamily',\n  'target',\n  'coreHash',\n  'profileHash',\n  'models',\n  'storage',\n  'capabilities',\n  'extensionPacks',\n  'meta',\n  'sources',\n] as const;\n\nfunction isDefaultValue(value: unknown): boolean {\n  if (value === false) return true;\n  if (value === null) return false;\n  if (Array.isArray(value) && value.length === 0) return true;\n  if (typeof value === 'object' && value !== null) {\n    const keys = Object.keys(value);\n    return keys.length === 0;\n  }\n  return false;\n}\n\nfunction omitDefaults(obj: unknown, path: readonly string[]): unknown {\n  if (obj === null || typeof obj !== 'object') {\n    return obj;\n  }\n\n  if (Array.isArray(obj)) {\n    return obj.map((item) => omitDefaults(item, path));\n  }\n\n  const result: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(obj)) {\n    const currentPath = [...path, key];\n\n    // Exclude metadata fields from canonicalization\n    if (key === '_generated') {\n      continue;\n    }\n\n    if (key === 'nullable' && value === false) {\n      continue;\n    }\n\n    if (key === 'generated' && value === false) {\n      continue;\n    }\n\n    if (isDefaultValue(value)) {\n      const isRequiredModels = isArrayEqual(currentPath, ['models']);\n      const isRequiredTables = isArrayEqual(currentPath, ['storage', 'tables']);\n      const isRequiredRelations = isArrayEqual(currentPath, ['relations']);\n      const isRequiredExtensionPacks = isArrayEqual(currentPath, ['extensionPacks']);\n      const isRequiredCapabilities = isArrayEqual(currentPath, ['capabilities']);\n      const isRequiredMeta = isArrayEqual(currentPath, ['meta']);\n      const isRequiredSources = isArrayEqual(currentPath, ['sources']);\n      const isExtensionNamespace = currentPath.length === 2 && currentPath[0] === 'extensionPacks';\n      const isModelRelations =\n        currentPath.length === 3 &&\n        isArrayEqual([currentPath[0], currentPath[2]], ['models', 'relations']);\n      const isTableUniques =\n        currentPath.length === 4 &&\n        isArrayEqual(\n          [currentPath[0], currentPath[1], currentPath[3]],\n          ['storage', 'tables', 'uniques'],\n        );\n      const isTableIndexes =\n        currentPath.length === 4 &&\n        isArrayEqual(\n          [currentPath[0], currentPath[1], currentPath[3]],\n          ['storage', 'tables', 'indexes'],\n        );\n      const isTableForeignKeys =\n        currentPath.length === 4 &&\n        isArrayEqual(\n          [currentPath[0], currentPath[1], currentPath[3]],\n          ['storage', 'tables', 'foreignKeys'],\n        );\n\n      if (\n        !isRequiredModels &&\n        !isRequiredTables &&\n        !isRequiredRelations &&\n        !isRequiredExtensionPacks &&\n        !isRequiredCapabilities &&\n        !isRequiredMeta &&\n        !isRequiredSources &&\n        !isExtensionNamespace &&\n        !isModelRelations &&\n        !isTableUniques &&\n        !isTableIndexes &&\n        !isTableForeignKeys\n      ) {\n        continue;\n      }\n    }\n\n    result[key] = omitDefaults(value, currentPath);\n  }\n\n  return result;\n}\n\nfunction sortObjectKeys(obj: unknown): unknown {\n  if (obj === null || typeof obj !== 'object') {\n    return obj;\n  }\n\n  if (Array.isArray(obj)) {\n    return obj.map((item) => sortObjectKeys(item));\n  }\n\n  const sorted: Record<string, unknown> = {};\n  const keys = Object.keys(obj).sort();\n  for (const key of keys) {\n    sorted[key] = sortObjectKeys((obj as Record<string, unknown>)[key]);\n  }\n\n  return sorted;\n}\n\ntype StorageObject = {\n  tables?: Record<string, unknown>;\n  [key: string]: unknown;\n};\n\ntype TableObject = {\n  indexes?: unknown[];\n  uniques?: unknown[];\n  [key: string]: unknown;\n};\n\nfunction sortIndexesAndUniques(storage: unknown): unknown {\n  if (!storage || typeof storage !== 'object') {\n    return storage;\n  }\n\n  const storageObj = storage as StorageObject;\n  if (!storageObj.tables || typeof storageObj.tables !== 'object') {\n    return storage;\n  }\n\n  const tables = storageObj.tables;\n  const result: StorageObject = { ...storageObj };\n\n  result.tables = {};\n  // Sort table names to ensure deterministic ordering\n  const sortedTableNames = Object.keys(tables).sort();\n  for (const tableName of sortedTableNames) {\n    const table = tables[tableName];\n    if (!table || typeof table !== 'object') {\n      result.tables[tableName] = table;\n      continue;\n    }\n\n    const tableObj = table as TableObject;\n    const sortedTable: TableObject = { ...tableObj };\n\n    if (Array.isArray(tableObj.indexes)) {\n      sortedTable.indexes = [...tableObj.indexes].sort((a, b) => {\n        const nameA = (a as { name?: string })?.name || '';\n        const nameB = (b as { name?: string })?.name || '';\n        return nameA.localeCompare(nameB);\n      });\n    }\n\n    if (Array.isArray(tableObj.uniques)) {\n      sortedTable.uniques = [...tableObj.uniques].sort((a, b) => {\n        const nameA = (a as { name?: string })?.name || '';\n        const nameB = (b as { name?: string })?.name || '';\n        return nameA.localeCompare(nameB);\n      });\n    }\n\n    result.tables[tableName] = sortedTable;\n  }\n\n  return result;\n}\n\nfunction orderTopLevel(obj: Record<string, unknown>): Record<string, unknown> {\n  const ordered: Record<string, unknown> = {};\n  const remaining = new Set(Object.keys(obj));\n\n  for (const key of TOP_LEVEL_ORDER) {\n    if (remaining.has(key)) {\n      ordered[key] = obj[key];\n      remaining.delete(key);\n    }\n  }\n\n  for (const key of Array.from(remaining).sort()) {\n    ordered[key] = obj[key];\n  }\n\n  return ordered;\n}\n\nexport function canonicalizeContract(\n  ir: ContractIR & { coreHash?: string; profileHash?: string },\n): string {\n  const normalized: NormalizedContract = {\n    schemaVersion: ir.schemaVersion,\n    targetFamily: ir.targetFamily,\n    target: ir.target,\n    models: ir.models,\n    relations: ir.relations,\n    storage: ir.storage,\n    extensionPacks: ir.extensionPacks,\n    capabilities: ir.capabilities,\n    meta: ir.meta,\n    sources: ir.sources,\n  };\n\n  if (ir.coreHash !== undefined) {\n    normalized.coreHash = ir.coreHash;\n  }\n\n  if (ir.profileHash !== undefined) {\n    normalized.profileHash = ir.profileHash;\n  }\n\n  const withDefaultsOmitted = omitDefaults(normalized, []) as NormalizedContract;\n  const withSortedIndexes = sortIndexesAndUniques(withDefaultsOmitted.storage);\n  const withSortedStorage = { ...withDefaultsOmitted, storage: withSortedIndexes };\n  const withSortedKeys = sortObjectKeys(withSortedStorage) as Record<string, unknown>;\n  const withOrderedTopLevel = orderTopLevel(withSortedKeys);\n\n  return JSON.stringify(withOrderedTopLevel, null, 2);\n}\n","import { createHash } from 'node:crypto';\nimport type { ContractIR } from '@prisma-next/contract/ir';\nimport { canonicalizeContract } from './canonicalization';\n\ntype ContractInput = {\n  schemaVersion: string;\n  targetFamily: string;\n  target: string;\n  models: Record<string, unknown>;\n  relations: Record<string, unknown>;\n  storage: Record<string, unknown>;\n  extensionPacks: Record<string, unknown>;\n  sources: Record<string, unknown>;\n  capabilities: Record<string, Record<string, boolean>>;\n  meta: Record<string, unknown>;\n  [key: string]: unknown;\n};\n\nfunction computeHash(content: string): string {\n  const hash = createHash('sha256');\n  hash.update(content);\n  return `sha256:${hash.digest('hex')}`;\n}\n\nexport function computeCoreHash(contract: ContractInput): string {\n  const coreContract: ContractIR = {\n    schemaVersion: contract.schemaVersion,\n    targetFamily: contract.targetFamily,\n    target: contract.target,\n    models: contract.models,\n    relations: contract.relations,\n    storage: contract.storage,\n    extensionPacks: contract.extensionPacks,\n    sources: contract.sources,\n    capabilities: contract.capabilities,\n    meta: contract.meta,\n  };\n  const canonical = canonicalizeContract(coreContract);\n  return computeHash(canonical);\n}\n\nexport function computeProfileHash(contract: ContractInput): string {\n  const profileContract: ContractIR = {\n    schemaVersion: contract.schemaVersion,\n    targetFamily: contract.targetFamily,\n    target: contract.target,\n    models: {},\n    relations: {},\n    storage: {},\n    extensionPacks: {},\n    capabilities: contract.capabilities,\n    meta: {},\n    sources: {},\n  };\n  const canonical = canonicalizeContract(profileContract);\n  return computeHash(canonical);\n}\n","import type { ContractIR } from '@prisma-next/contract/ir';\nimport type { TargetFamilyHook, ValidationContext } from '@prisma-next/contract/types';\nimport { format } from 'prettier';\nimport { canonicalizeContract } from './canonicalization';\nimport { computeCoreHash, computeProfileHash } from './hashing';\nimport type { EmitOptions, EmitResult } from './types';\n\nfunction validateCoreStructure(ir: ContractIR): void {\n  if (!ir.targetFamily) {\n    throw new Error('ContractIR must have targetFamily');\n  }\n  if (!ir.target) {\n    throw new Error('ContractIR must have target');\n  }\n  if (!ir.schemaVersion) {\n    throw new Error('ContractIR must have schemaVersion');\n  }\n  if (!ir.models || typeof ir.models !== 'object') {\n    throw new Error('ContractIR must have models');\n  }\n  if (!ir.storage || typeof ir.storage !== 'object') {\n    throw new Error('ContractIR must have storage');\n  }\n  if (!ir.relations || typeof ir.relations !== 'object') {\n    throw new Error('ContractIR must have relations');\n  }\n  if (!ir.extensionPacks || typeof ir.extensionPacks !== 'object') {\n    throw new Error('ContractIR must have extensionPacks');\n  }\n  if (!ir.capabilities || typeof ir.capabilities !== 'object') {\n    throw new Error('ContractIR must have capabilities');\n  }\n  if (!ir.meta || typeof ir.meta !== 'object') {\n    throw new Error('ContractIR must have meta');\n  }\n  if (!ir.sources || typeof ir.sources !== 'object') {\n    throw new Error('ContractIR must have sources');\n  }\n}\n\nexport async function emit(\n  ir: ContractIR,\n  options: EmitOptions,\n  targetFamily: TargetFamilyHook,\n): Promise<EmitResult> {\n  const { operationRegistry, codecTypeImports, operationTypeImports, extensionIds } = options;\n\n  validateCoreStructure(ir);\n\n  const ctx: ValidationContext = {\n    ...(operationRegistry ? { operationRegistry } : {}),\n    ...(codecTypeImports ? { codecTypeImports } : {}),\n    ...(operationTypeImports ? { operationTypeImports } : {}),\n    ...(extensionIds ? { extensionIds } : {}),\n  };\n  targetFamily.validateTypes(ir, ctx);\n\n  targetFamily.validateStructure(ir);\n\n  const contractJson = {\n    schemaVersion: ir.schemaVersion,\n    targetFamily: ir.targetFamily,\n    target: ir.target,\n    models: ir.models,\n    relations: ir.relations,\n    storage: ir.storage,\n    extensionPacks: ir.extensionPacks,\n    capabilities: ir.capabilities,\n    meta: ir.meta,\n    sources: ir.sources,\n  } as const;\n\n  const coreHash = computeCoreHash(contractJson);\n  const profileHash = computeProfileHash(contractJson);\n\n  const contractWithHashes: ContractIR & { coreHash?: string; profileHash?: string } = {\n    ...ir,\n    schemaVersion: contractJson.schemaVersion,\n    coreHash,\n    profileHash,\n  };\n\n  // Add _generated metadata to indicate this is a generated artifact\n  // This ensures consistency between CLI emit and programmatic emit\n  // Always add/update _generated with standard content for consistency\n  const contractJsonObj = JSON.parse(canonicalizeContract(contractWithHashes)) as Record<\n    string,\n    unknown\n  >;\n  const contractJsonWithMeta = {\n    ...contractJsonObj,\n    _generated: {\n      warning: '⚠️  GENERATED FILE - DO NOT EDIT',\n      message: 'This file is automatically generated by \"prisma-next contract emit\".',\n      regenerate: 'To regenerate, run: prisma-next contract emit',\n    },\n  };\n  const contractJsonString = JSON.stringify(contractJsonWithMeta, null, 2);\n\n  const contractDtsRaw = targetFamily.generateContractTypes(\n    ir,\n    codecTypeImports ?? [],\n    operationTypeImports ?? [],\n  );\n  const contractDts = await format(contractDtsRaw, {\n    parser: 'typescript',\n    singleQuote: true,\n    semi: true,\n    printWidth: 100,\n  });\n\n  return {\n    contractJson: contractJsonString,\n    contractDts,\n    coreHash,\n    profileHash,\n  };\n}\n"],"mappings":"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"}

package/dist/errors-Qlh0sdcb.mjs

@@ -0,0 +1,276 @@
+//#region src/errors.ts
+/**
+* Structured CLI error that contains all information needed for error envelopes.
+* Call sites throw these errors with full context.
+*/
+var CliStructuredError = class extends Error {
+	code;
+	domain;
+	severity;
+	why;
+	fix;
+	where;
+	meta;
+	docsUrl;
+	constructor(code, summary, options) {
+		super(summary);
+		this.name = "CliStructuredError";
+		this.code = code;
+		this.domain = options?.domain ?? "CLI";
+		this.severity = options?.severity ?? "error";
+		this.why = options?.why;
+		this.fix = options?.fix;
+		this.where = options?.where ? {
+			path: options.where.path,
+			line: options.where.line
+		} : void 0;
+		this.meta = options?.meta;
+		this.docsUrl = options?.docsUrl;
+	}
+	/**
+	* Converts this error to a CLI error envelope for output formatting.
+	*/
+	toEnvelope() {
+		return {
+			code: `${this.domain === "CLI" ? "PN-CLI-" : "PN-RTM-"}${this.code}`,
+			domain: this.domain,
+			severity: this.severity,
+			summary: this.message,
+			why: this.why,
+			fix: this.fix,
+			where: this.where,
+			meta: this.meta,
+			docsUrl: this.docsUrl
+		};
+	}
+	/**
+	* Type guard to check if an error is a CliStructuredError.
+	* Uses duck-typing to work across module boundaries where instanceof may fail.
+	*/
+	static is(error) {
+		if (!(error instanceof Error)) return false;
+		const candidate = error;
+		return candidate.name === "CliStructuredError" && typeof candidate.code === "string" && (candidate.domain === "CLI" || candidate.domain === "RTM") && typeof candidate.toEnvelope === "function";
+	}
+};
+/**
+* Config file not found or missing.
+*/
+function errorConfigFileNotFound(configPath, options) {
+	return new CliStructuredError("4001", "Config file not found", {
+		domain: "CLI",
+		...options?.why ? { why: options.why } : { why: "Config file not found" },
+		fix: "Run 'prisma-next init' to create a config file",
+		docsUrl: "https://prisma-next.dev/docs/cli/config",
+		...configPath ? { where: { path: configPath } } : {}
+	});
+}
+/**
+* Contract configuration missing from config.
+*/
+function errorContractConfigMissing(options) {
+	return new CliStructuredError("4002", "Contract configuration missing", {
+		domain: "CLI",
+		why: options?.why ?? "The contract configuration is required for emit",
+		fix: "Add contract configuration to your prisma-next.config.ts",
+		docsUrl: "https://prisma-next.dev/docs/cli/contract-emit"
+	});
+}
+/**
+* Contract validation failed.
+*/
+function errorContractValidationFailed(reason, options) {
+	return new CliStructuredError("4003", "Contract validation failed", {
+		domain: "CLI",
+		why: reason,
+		fix: "Re-run `prisma-next contract emit`, or fix the contract file and try again",
+		docsUrl: "https://prisma-next.dev/docs/contracts",
+		...options?.where ? { where: options.where } : {}
+	});
+}
+/**
+* File not found.
+*/
+function errorFileNotFound(filePath, options) {
+	return new CliStructuredError("4004", "File not found", {
+		domain: "CLI",
+		why: options?.why ?? `File not found: ${filePath}`,
+		fix: options?.fix ?? "Check that the file path is correct",
+		where: { path: filePath },
+		...options?.docsUrl ? { docsUrl: options.docsUrl } : {}
+	});
+}
+/**
+* Database connection is required but not provided.
+*/
+function errorDatabaseConnectionRequired(options) {
+	return new CliStructuredError("4005", "Database connection is required", {
+		domain: "CLI",
+		why: options?.why ?? "Database connection is required for this command",
+		fix: "Provide `--db <url>` or set `db: { connection: \"postgres://…\" }` in prisma-next.config.ts"
+	});
+}
+/**
+* Query runner factory is required but not provided in config.
+*/
+function errorQueryRunnerFactoryRequired(options) {
+	return new CliStructuredError("4006", "Query runner factory is required", {
+		domain: "CLI",
+		why: options?.why ?? "Config.db.queryRunnerFactory is required for db verify",
+		fix: "Add db.queryRunnerFactory to prisma-next.config.ts",
+		docsUrl: "https://prisma-next.dev/docs/cli/db-verify"
+	});
+}
+/**
+* Family verify.readMarker is required but not provided.
+*/
+function errorFamilyReadMarkerSqlRequired(options) {
+	return new CliStructuredError("4007", "Family readMarker() is required", {
+		domain: "CLI",
+		why: options?.why ?? "Family verify.readMarker is required for db verify",
+		fix: "Ensure family.verify.readMarker() is exported by your family package",
+		docsUrl: "https://prisma-next.dev/docs/cli/db-verify"
+	});
+}
+/**
+* JSON output format not supported.
+*/
+function errorJsonFormatNotSupported(options) {
+	return new CliStructuredError("4008", "Unsupported JSON format", {
+		domain: "CLI",
+		why: `The ${options.command} command does not support --json ${options.format}`,
+		fix: `Use --json ${options.supportedFormats.join(" or ")}, or omit --json for human output`,
+		meta: {
+			command: options.command,
+			format: options.format,
+			supportedFormats: options.supportedFormats
+		}
+	});
+}
+/**
+* Driver is required for DB-connected commands but not provided.
+*/
+function errorDriverRequired(options) {
+	return new CliStructuredError("4010", "Driver is required for DB-connected commands", {
+		domain: "CLI",
+		why: options?.why ?? "Config.driver is required for DB-connected commands",
+		fix: "Add a control-plane driver to prisma-next.config.ts (e.g. import a driver descriptor and set `driver: postgresDriver`)",
+		docsUrl: "https://prisma-next.dev/docs/cli/config"
+	});
+}
+/**
+* Contract requires extension packs that are not provided by config descriptors.
+*/
+function errorContractMissingExtensionPacks(options) {
+	const missing = [...options.missingExtensionPacks].sort();
+	return new CliStructuredError("4011", "Missing extension packs in config", {
+		domain: "CLI",
+		why: missing.length === 1 ? `Contract requires extension pack '${missing[0]}', but CLI config does not provide a matching descriptor.` : `Contract requires extension packs ${missing.map((p) => `'${p}'`).join(", ")}, but CLI config does not provide matching descriptors.`,
+		fix: "Add the missing extension descriptors to `extensions` in prisma-next.config.ts",
+		docsUrl: "https://prisma-next.dev/docs/cli/config",
+		meta: {
+			missingExtensionPacks: missing,
+			providedComponentIds: [...options.providedComponentIds].sort()
+		}
+	});
+}
+/**
+* Migration planning failed due to conflicts.
+*/
+function errorMigrationPlanningFailed(options) {
+	const conflictSummaries = options.conflicts.map((c) => c.summary);
+	const computedWhy = options.why ?? conflictSummaries.join("\n");
+	const conflictFixes = options.conflicts.map((c) => c.why).filter((why) => typeof why === "string");
+	return new CliStructuredError("4020", "Migration planning failed", {
+		domain: "CLI",
+		why: computedWhy,
+		fix: conflictFixes.length > 0 ? conflictFixes.join("\n") : "Use `db schema-verify` to inspect conflicts, or ensure the database is empty",
+		meta: { conflicts: options.conflicts },
+		docsUrl: "https://prisma-next.dev/docs/cli/db-init"
+	});
+}
+/**
+* Target does not support migrations (missing createPlanner/createRunner).
+*/
+function errorTargetMigrationNotSupported(options) {
+	return new CliStructuredError("4021", "Target does not support migrations", {
+		domain: "CLI",
+		why: options?.why ?? "The configured target does not provide migration planner/runner",
+		fix: "Select a target that provides migrations (it must export `target.migrations` for db init)",
+		docsUrl: "https://prisma-next.dev/docs/cli/db-init"
+	});
+}
+/**
+* Config validation error (missing required fields).
+*/
+function errorConfigValidation(field, options) {
+	return new CliStructuredError("4001", "Config file not found", {
+		domain: "CLI",
+		why: options?.why ?? `Config must have a "${field}" field`,
+		fix: "Run 'prisma-next init' to create a config file",
+		docsUrl: "https://prisma-next.dev/docs/cli/config"
+	});
+}
+/**
+* Contract marker not found in database.
+*/
+function errorMarkerMissing(options) {
+	return new CliStructuredError("3001", "Marker missing", {
+		domain: "RTM",
+		why: options?.why ?? "Contract marker not found in database",
+		fix: "Run `prisma-next db sign --db <url>` to create marker"
+	});
+}
+/**
+* Contract hash does not match database marker.
+*/
+function errorHashMismatch(options) {
+	return new CliStructuredError("3002", "Hash mismatch", {
+		domain: "RTM",
+		why: options?.why ?? "Contract hash does not match database marker",
+		fix: "Migrate database or re-sign if intentional",
+		...options?.expected || options?.actual ? { meta: {
+			...options.expected ? { expected: options.expected } : {},
+			...options.actual ? { actual: options.actual } : {}
+		} } : {}
+	});
+}
+/**
+* Contract target does not match config target.
+*/
+function errorTargetMismatch(expected, actual, options) {
+	return new CliStructuredError("3003", "Target mismatch", {
+		domain: "RTM",
+		why: options?.why ?? `Contract target does not match config target (expected: ${expected}, actual: ${actual})`,
+		fix: "Align contract target and config target",
+		meta: {
+			expected,
+			actual
+		}
+	});
+}
+/**
+* Generic runtime error.
+*/
+function errorRuntime(summary, options) {
+	return new CliStructuredError("3000", summary, {
+		domain: "RTM",
+		...options?.why ? { why: options.why } : { why: "Verification failed" },
+		...options?.fix ? { fix: options.fix } : { fix: "Check contract and database state" },
+		...options?.meta ? { meta: options.meta } : {}
+	});
+}
+/**
+* Generic unexpected error.
+*/
+function errorUnexpected(message, options) {
+	return new CliStructuredError("4999", "Unexpected error", {
+		domain: "CLI",
+		why: options?.why ?? message,
+		fix: options?.fix ?? "Check the error message and try again"
+	});
+}
+
+//#endregion
+export { errorTargetMigrationNotSupported as _, errorContractMissingExtensionPacks as a, errorDriverRequired as c, errorHashMismatch as d, errorJsonFormatNotSupported as f, errorRuntime as g, errorQueryRunnerFactoryRequired as h, errorContractConfigMissing as i, errorFamilyReadMarkerSqlRequired as l, errorMigrationPlanningFailed as m, errorConfigFileNotFound as n, errorContractValidationFailed as o, errorMarkerMissing as p, errorConfigValidation as r, errorDatabaseConnectionRequired as s, CliStructuredError as t, errorFileNotFound as u, errorTargetMismatch as v, errorUnexpected as y };
+//# sourceMappingURL=errors-Qlh0sdcb.mjs.map

package/dist/errors-Qlh0sdcb.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-Qlh0sdcb.mjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/**\n * CLI error envelope for output formatting.\n * This is the serialized form of a CliStructuredError.\n */\nexport interface CliErrorEnvelope {\n  readonly code: string;\n  readonly domain: string;\n  readonly severity: 'error' | 'warn' | 'info';\n  readonly summary: string;\n  readonly why: string | undefined;\n  readonly fix: string | undefined;\n  readonly where:\n    | {\n        readonly path: string | undefined;\n        readonly line: number | undefined;\n      }\n    | undefined;\n  readonly meta: Record<string, unknown> | undefined;\n  readonly docsUrl: string | undefined;\n}\n\n/**\n * Minimal conflict data structure expected by CLI output.\n */\nexport interface CliErrorConflict {\n  readonly kind: string;\n  readonly summary: string;\n  readonly why?: string;\n}\n\n/**\n * Structured CLI error that contains all information needed for error envelopes.\n * Call sites throw these errors with full context.\n */\nexport class CliStructuredError extends Error {\n  readonly code: string;\n  readonly domain: 'CLI' | 'RTM';\n  readonly severity: 'error' | 'warn' | 'info';\n  readonly why: string | undefined;\n  readonly fix: string | undefined;\n  readonly where:\n    | {\n        readonly path: string | undefined;\n        readonly line: number | undefined;\n      }\n    | undefined;\n  readonly meta: Record<string, unknown> | undefined;\n  readonly docsUrl: string | undefined;\n\n  constructor(\n    code: string,\n    summary: string,\n    options?: {\n      readonly domain?: 'CLI' | 'RTM';\n      readonly severity?: 'error' | 'warn' | 'info';\n      readonly why?: string;\n      readonly fix?: string;\n      readonly where?: { readonly path?: string; readonly line?: number };\n      readonly meta?: Record<string, unknown>;\n      readonly docsUrl?: string;\n    },\n  ) {\n    super(summary);\n    this.name = 'CliStructuredError';\n    this.code = code;\n    this.domain = options?.domain ?? 'CLI';\n    this.severity = options?.severity ?? 'error';\n    this.why = options?.why;\n    this.fix = options?.fix;\n    this.where = options?.where\n      ? {\n          path: options.where.path,\n          line: options.where.line,\n        }\n      : undefined;\n    this.meta = options?.meta;\n    this.docsUrl = options?.docsUrl;\n  }\n\n  /**\n   * Converts this error to a CLI error envelope for output formatting.\n   */\n  toEnvelope(): CliErrorEnvelope {\n    const codePrefix = this.domain === 'CLI' ? 'PN-CLI-' : 'PN-RTM-';\n    return {\n      code: `${codePrefix}${this.code}`,\n      domain: this.domain,\n      severity: this.severity,\n      summary: this.message,\n      why: this.why,\n      fix: this.fix,\n      where: this.where,\n      meta: this.meta,\n      docsUrl: this.docsUrl,\n    };\n  }\n\n  /**\n   * Type guard to check if an error is a CliStructuredError.\n   * Uses duck-typing to work across module boundaries where instanceof may fail.\n   */\n  static is(error: unknown): error is CliStructuredError {\n    if (!(error instanceof Error)) {\n      return false;\n    }\n    const candidate = error as CliStructuredError;\n    return (\n      candidate.name === 'CliStructuredError' &&\n      typeof candidate.code === 'string' &&\n      (candidate.domain === 'CLI' || candidate.domain === 'RTM') &&\n      typeof candidate.toEnvelope === 'function'\n    );\n  }\n}\n\n// ============================================================================\n// Config Errors (PN-CLI-4001-4007)\n// ============================================================================\n\n/**\n * Config file not found or missing.\n */\nexport function errorConfigFileNotFound(\n  configPath?: string,\n  options?: {\n    readonly why?: string;\n  },\n): CliStructuredError {\n  return new CliStructuredError('4001', 'Config file not found', {\n    domain: 'CLI',\n    ...(options?.why ? { why: options.why } : { why: 'Config file not found' }),\n    fix: \"Run 'prisma-next init' to create a config file\",\n    docsUrl: 'https://prisma-next.dev/docs/cli/config',\n    ...(configPath ? { where: { path: configPath } } : {}),\n  });\n}\n\n/**\n * Contract configuration missing from config.\n */\nexport function errorContractConfigMissing(options?: {\n  readonly why?: string;\n}): CliStructuredError {\n  return new CliStructuredError('4002', 'Contract configuration missing', {\n    domain: 'CLI',\n    why: options?.why ?? 'The contract configuration is required for emit',\n    fix: 'Add contract configuration to your prisma-next.config.ts',\n    docsUrl: 'https://prisma-next.dev/docs/cli/contract-emit',\n  });\n}\n\n/**\n * Contract validation failed.\n */\nexport function errorContractValidationFailed(\n  reason: string,\n  options?: {\n    readonly where?: { readonly path?: string; readonly line?: number };\n  },\n): CliStructuredError {\n  return new CliStructuredError('4003', 'Contract validation failed', {\n    domain: 'CLI',\n    why: reason,\n    fix: 'Re-run `prisma-next contract emit`, or fix the contract file and try again',\n    docsUrl: 'https://prisma-next.dev/docs/contracts',\n    ...(options?.where ? { where: options.where } : {}),\n  });\n}\n\n/**\n * File not found.\n */\nexport function errorFileNotFound(\n  filePath: string,\n  options?: {\n    readonly why?: string;\n    readonly fix?: string;\n    readonly docsUrl?: string;\n  },\n): CliStructuredError {\n  return new CliStructuredError('4004', 'File not found', {\n    domain: 'CLI',\n    why: options?.why ?? `File not found: ${filePath}`,\n    fix: options?.fix ?? 'Check that the file path is correct',\n    where: { path: filePath },\n    ...(options?.docsUrl ? { docsUrl: options.docsUrl } : {}),\n  });\n}\n\n/**\n * Database connection is required but not provided.\n */\nexport function errorDatabaseConnectionRequired(options?: {\n  readonly why?: string;\n}): CliStructuredError {\n  return new CliStructuredError('4005', 'Database connection is required', {\n    domain: 'CLI',\n    why: options?.why ?? 'Database connection is required for this command',\n    fix: 'Provide `--db <url>` or set `db: { connection: \"postgres://…\" }` in prisma-next.config.ts',\n  });\n}\n\n/**\n * Query runner factory is required but not provided in config.\n */\nexport function errorQueryRunnerFactoryRequired(options?: {\n  readonly why?: string;\n}): CliStructuredError {\n  return new CliStructuredError('4006', 'Query runner factory is required', {\n    domain: 'CLI',\n    why: options?.why ?? 'Config.db.queryRunnerFactory is required for db verify',\n    fix: 'Add db.queryRunnerFactory to prisma-next.config.ts',\n    docsUrl: 'https://prisma-next.dev/docs/cli/db-verify',\n  });\n}\n\n/**\n * Family verify.readMarker is required but not provided.\n */\nexport function errorFamilyReadMarkerSqlRequired(options?: {\n  readonly why?: string;\n}): CliStructuredError {\n  return new CliStructuredError('4007', 'Family readMarker() is required', {\n    domain: 'CLI',\n    why: options?.why ?? 'Family verify.readMarker is required for db verify',\n    fix: 'Ensure family.verify.readMarker() is exported by your family package',\n    docsUrl: 'https://prisma-next.dev/docs/cli/db-verify',\n  });\n}\n\n/**\n * JSON output format not supported.\n */\nexport function errorJsonFormatNotSupported(options: {\n  readonly command: string;\n  readonly format: string;\n  readonly supportedFormats: readonly string[];\n}): CliStructuredError {\n  return new CliStructuredError('4008', 'Unsupported JSON format', {\n    domain: 'CLI',\n    why: `The ${options.command} command does not support --json ${options.format}`,\n    fix: `Use --json ${options.supportedFormats.join(' or ')}, or omit --json for human output`,\n    meta: {\n      command: options.command,\n      format: options.format,\n      supportedFormats: options.supportedFormats,\n    },\n  });\n}\n\n/**\n * Driver is required for DB-connected commands but not provided.\n */\nexport function errorDriverRequired(options?: { readonly why?: string }): CliStructuredError {\n  return new CliStructuredError('4010', 'Driver is required for DB-connected commands', {\n    domain: 'CLI',\n    why: options?.why ?? 'Config.driver is required for DB-connected commands',\n    fix: 'Add a control-plane driver to prisma-next.config.ts (e.g. import a driver descriptor and set `driver: postgresDriver`)',\n    docsUrl: 'https://prisma-next.dev/docs/cli/config',\n  });\n}\n\n/**\n * Contract requires extension packs that are not provided by config descriptors.\n */\nexport function errorContractMissingExtensionPacks(options: {\n  readonly missingExtensionPacks: readonly string[];\n  readonly providedComponentIds: readonly string[];\n}): CliStructuredError {\n  const missing = [...options.missingExtensionPacks].sort();\n  return new CliStructuredError('4011', 'Missing extension packs in config', {\n    domain: 'CLI',\n    why:\n      missing.length === 1\n        ? `Contract requires extension pack '${missing[0]}', but CLI config does not provide a matching descriptor.`\n        : `Contract requires extension packs ${missing.map((p) => `'${p}'`).join(', ')}, but CLI config does not provide matching descriptors.`,\n    fix: 'Add the missing extension descriptors to `extensions` in prisma-next.config.ts',\n    docsUrl: 'https://prisma-next.dev/docs/cli/config',\n    meta: {\n      missingExtensionPacks: missing,\n      providedComponentIds: [...options.providedComponentIds].sort(),\n    },\n  });\n}\n\n/**\n * Migration planning failed due to conflicts.\n */\nexport function errorMigrationPlanningFailed(options: {\n  readonly conflicts: readonly CliErrorConflict[];\n  readonly why?: string;\n}): CliStructuredError {\n  // Build \"why\" from conflict summaries - these contain the actual problem description\n  const conflictSummaries = options.conflicts.map((c) => c.summary);\n  const computedWhy = options.why ?? conflictSummaries.join('\\n');\n\n  // Build \"fix\" from conflict \"why\" fields - these contain actionable advice\n  const conflictFixes = options.conflicts\n    .map((c) => c.why)\n    .filter((why): why is string => typeof why === 'string');\n  const computedFix =\n    conflictFixes.length > 0\n      ? conflictFixes.join('\\n')\n      : 'Use `db schema-verify` to inspect conflicts, or ensure the database is empty';\n\n  return new CliStructuredError('4020', 'Migration planning failed', {\n    domain: 'CLI',\n    why: computedWhy,\n    fix: computedFix,\n    meta: { conflicts: options.conflicts },\n    docsUrl: 'https://prisma-next.dev/docs/cli/db-init',\n  });\n}\n\n/**\n * Target does not support migrations (missing createPlanner/createRunner).\n */\nexport function errorTargetMigrationNotSupported(options?: {\n  readonly why?: string;\n}): CliStructuredError {\n  return new CliStructuredError('4021', 'Target does not support migrations', {\n    domain: 'CLI',\n    why: options?.why ?? 'The configured target does not provide migration planner/runner',\n    fix: 'Select a target that provides migrations (it must export `target.migrations` for db init)',\n    docsUrl: 'https://prisma-next.dev/docs/cli/db-init',\n  });\n}\n\n/**\n * Config validation error (missing required fields).\n */\nexport function errorConfigValidation(\n  field: string,\n  options?: {\n    readonly why?: string;\n  },\n): CliStructuredError {\n  return new CliStructuredError('4001', 'Config file not found', {\n    domain: 'CLI',\n    why: options?.why ?? `Config must have a \"${field}\" field`,\n    fix: \"Run 'prisma-next init' to create a config file\",\n    docsUrl: 'https://prisma-next.dev/docs/cli/config',\n  });\n}\n\n// ============================================================================\n// Runtime Errors (PN-RTM-3000-3003)\n// ============================================================================\n\n/**\n * Contract marker not found in database.\n */\nexport function errorMarkerMissing(options?: {\n  readonly why?: string;\n  readonly dbUrl?: string;\n}): CliStructuredError {\n  return new CliStructuredError('3001', 'Marker missing', {\n    domain: 'RTM',\n    why: options?.why ?? 'Contract marker not found in database',\n    fix: 'Run `prisma-next db sign --db <url>` to create marker',\n  });\n}\n\n/**\n * Contract hash does not match database marker.\n */\nexport function errorHashMismatch(options?: {\n  readonly why?: string;\n  readonly expected?: string;\n  readonly actual?: string;\n}): CliStructuredError {\n  return new CliStructuredError('3002', 'Hash mismatch', {\n    domain: 'RTM',\n    why: options?.why ?? 'Contract hash does not match database marker',\n    fix: 'Migrate database or re-sign if intentional',\n    ...(options?.expected || options?.actual\n      ? {\n          meta: {\n            ...(options.expected ? { expected: options.expected } : {}),\n            ...(options.actual ? { actual: options.actual } : {}),\n          },\n        }\n      : {}),\n  });\n}\n\n/**\n * Contract target does not match config target.\n */\nexport function errorTargetMismatch(\n  expected: string,\n  actual: string,\n  options?: {\n    readonly why?: string;\n  },\n): CliStructuredError {\n  return new CliStructuredError('3003', 'Target mismatch', {\n    domain: 'RTM',\n    why:\n      options?.why ??\n      `Contract target does not match config target (expected: ${expected}, actual: ${actual})`,\n    fix: 'Align contract target and config target',\n    meta: { expected, actual },\n  });\n}\n\n/**\n * Generic runtime error.\n */\nexport function errorRuntime(\n  summary: string,\n  options?: {\n    readonly why?: string;\n    readonly fix?: string;\n    readonly meta?: Record<string, unknown>;\n  },\n): CliStructuredError {\n  return new CliStructuredError('3000', summary, {\n    domain: 'RTM',\n    ...(options?.why ? { why: options.why } : { why: 'Verification failed' }),\n    ...(options?.fix ? { fix: options.fix } : { fix: 'Check contract and database state' }),\n    ...(options?.meta ? { meta: options.meta } : {}),\n  });\n}\n\n// ============================================================================\n// Generic Error\n// ============================================================================\n\n/**\n * Generic unexpected error.\n */\nexport function errorUnexpected(\n  message: string,\n  options?: {\n    readonly why?: string;\n    readonly fix?: string;\n  },\n): CliStructuredError {\n  return new CliStructuredError('4999', 'Unexpected error', {\n    domain: 'CLI',\n    why: options?.why ?? message,\n    fix: options?.fix ?? 'Check the error message and try again',\n  });\n}\n"],"mappings":"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"}

package/dist/errors.d.mts

@@ -0,0 +1,191 @@
+//#region src/errors.d.ts
+/**
+ * CLI error envelope for output formatting.
+ * This is the serialized form of a CliStructuredError.
+ */
+interface CliErrorEnvelope {
+  readonly code: string;
+  readonly domain: string;
+  readonly severity: 'error' | 'warn' | 'info';
+  readonly summary: string;
+  readonly why: string | undefined;
+  readonly fix: string | undefined;
+  readonly where: {
+    readonly path: string | undefined;
+    readonly line: number | undefined;
+  } | undefined;
+  readonly meta: Record<string, unknown> | undefined;
+  readonly docsUrl: string | undefined;
+}
+/**
+ * Minimal conflict data structure expected by CLI output.
+ */
+interface CliErrorConflict {
+  readonly kind: string;
+  readonly summary: string;
+  readonly why?: string;
+}
+/**
+ * Structured CLI error that contains all information needed for error envelopes.
+ * Call sites throw these errors with full context.
+ */
+declare class CliStructuredError extends Error {
+  readonly code: string;
+  readonly domain: 'CLI' | 'RTM';
+  readonly severity: 'error' | 'warn' | 'info';
+  readonly why: string | undefined;
+  readonly fix: string | undefined;
+  readonly where: {
+    readonly path: string | undefined;
+    readonly line: number | undefined;
+  } | undefined;
+  readonly meta: Record<string, unknown> | undefined;
+  readonly docsUrl: string | undefined;
+  constructor(code: string, summary: string, options?: {
+    readonly domain?: 'CLI' | 'RTM';
+    readonly severity?: 'error' | 'warn' | 'info';
+    readonly why?: string;
+    readonly fix?: string;
+    readonly where?: {
+      readonly path?: string;
+      readonly line?: number;
+    };
+    readonly meta?: Record<string, unknown>;
+    readonly docsUrl?: string;
+  });
+  /**
+   * Converts this error to a CLI error envelope for output formatting.
+   */
+  toEnvelope(): CliErrorEnvelope;
+  /**
+   * Type guard to check if an error is a CliStructuredError.
+   * Uses duck-typing to work across module boundaries where instanceof may fail.
+   */
+  static is(error: unknown): error is CliStructuredError;
+}
+/**
+ * Config file not found or missing.
+ */
+declare function errorConfigFileNotFound(configPath?: string, options?: {
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * Contract configuration missing from config.
+ */
+declare function errorContractConfigMissing(options?: {
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * Contract validation failed.
+ */
+declare function errorContractValidationFailed(reason: string, options?: {
+  readonly where?: {
+    readonly path?: string;
+    readonly line?: number;
+  };
+}): CliStructuredError;
+/**
+ * File not found.
+ */
+declare function errorFileNotFound(filePath: string, options?: {
+  readonly why?: string;
+  readonly fix?: string;
+  readonly docsUrl?: string;
+}): CliStructuredError;
+/**
+ * Database connection is required but not provided.
+ */
+declare function errorDatabaseConnectionRequired(options?: {
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * Query runner factory is required but not provided in config.
+ */
+declare function errorQueryRunnerFactoryRequired(options?: {
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * Family verify.readMarker is required but not provided.
+ */
+declare function errorFamilyReadMarkerSqlRequired(options?: {
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * JSON output format not supported.
+ */
+declare function errorJsonFormatNotSupported(options: {
+  readonly command: string;
+  readonly format: string;
+  readonly supportedFormats: readonly string[];
+}): CliStructuredError;
+/**
+ * Driver is required for DB-connected commands but not provided.
+ */
+declare function errorDriverRequired(options?: {
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * Contract requires extension packs that are not provided by config descriptors.
+ */
+declare function errorContractMissingExtensionPacks(options: {
+  readonly missingExtensionPacks: readonly string[];
+  readonly providedComponentIds: readonly string[];
+}): CliStructuredError;
+/**
+ * Migration planning failed due to conflicts.
+ */
+declare function errorMigrationPlanningFailed(options: {
+  readonly conflicts: readonly CliErrorConflict[];
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * Target does not support migrations (missing createPlanner/createRunner).
+ */
+declare function errorTargetMigrationNotSupported(options?: {
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * Config validation error (missing required fields).
+ */
+declare function errorConfigValidation(field: string, options?: {
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * Contract marker not found in database.
+ */
+declare function errorMarkerMissing(options?: {
+  readonly why?: string;
+  readonly dbUrl?: string;
+}): CliStructuredError;
+/**
+ * Contract hash does not match database marker.
+ */
+declare function errorHashMismatch(options?: {
+  readonly why?: string;
+  readonly expected?: string;
+  readonly actual?: string;
+}): CliStructuredError;
+/**
+ * Contract target does not match config target.
+ */
+declare function errorTargetMismatch(expected: string, actual: string, options?: {
+  readonly why?: string;
+}): CliStructuredError;
+/**
+ * Generic runtime error.
+ */
+declare function errorRuntime(summary: string, options?: {
+  readonly why?: string;
+  readonly fix?: string;
+  readonly meta?: Record<string, unknown>;
+}): CliStructuredError;
+/**
+ * Generic unexpected error.
+ */
+declare function errorUnexpected(message: string, options?: {
+  readonly why?: string;
+  readonly fix?: string;
+}): CliStructuredError;
+//#endregion
+export { type CliErrorConflict, type CliErrorEnvelope, CliStructuredError, errorConfigFileNotFound, errorConfigValidation, errorContractConfigMissing, errorContractMissingExtensionPacks, errorContractValidationFailed, errorDatabaseConnectionRequired, errorDriverRequired, errorFamilyReadMarkerSqlRequired, errorFileNotFound, errorHashMismatch, errorJsonFormatNotSupported, errorMarkerMissing, errorMigrationPlanningFailed, errorQueryRunnerFactoryRequired, errorRuntime, errorTargetMigrationNotSupported, errorTargetMismatch, errorUnexpected };
+//# sourceMappingURL=errors.d.mts.map

package/dist/errors.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.mts","names":[],"sources":["../src/errors.ts"],"sourcesContent":[],"mappings":";;AAIA;AAoBA;AAUA;AAYiB,UA1CA,gBAAA,CA0CA;EAYK,SAAA,IAAA,EAAA,MAAA;EAwBN,SAAA,MAAA,EAAA,MAAA;EAmBsB,SAAA,QAAA,EAAA,OAAA,GAAA,MAAA,GAAA,MAAA;EAnEE,SAAA,OAAA,EAAA,MAAA;EAAK,SAAA,GAAA,EAAA,MAAA,GAAA,SAAA;EAwF7B,SAAA,GAAA,EAAA,MAAA,GAAA,SAAuB;EAkBvB,SAAA,KAAA,EAAA;IAcA,SAAA,IAAA,EAAA,MAAA,GAAA,SAA6B;IAkB7B,SAAA,IAAA,EAAA,MAAiB,GAAA,SAO9B;EAaa,CAAA,GAAA,SAAA;EAaA,SAAA,IAAA,EA5LC,MA4LD,CAAA,MAAA,EAAA,OAA+B,CAAA,GAAA,SAE3C;EAYY,SAAA,OAAA,EAAA,MAAA,GAAA,SAAgC;AAchD;AAoBA;AAYA;AAuBA;AA6BgB,UArSC,gBAAA,CAqSD;EAcA,SAAA,IAAA,EAAA,MAAA;EAqBA,SAAA,OAAA,EAAA,MAAkB;EAclB,SAAA,GAAA,CAAA,EAAA,MAAiB;AAuBjC;AAoBA;AAuBA;;;cA9Ya,kBAAA,SAA2B,KAAA;;;;;;;;;;iBAYvB;;;;;;;;;;;oBAYK;;;;;;gBAwBN;;;;;sCAmBsB;;;;;iBAqBtB,uBAAA;;IAKb;;;;iBAaa,0BAAA;;IAEZ;;;;iBAYY,6BAAA;;;;;IAKb;;;;iBAaa,iBAAA;;;;IAOb;;;;iBAaa,+BAAA;;IAEZ;;;;iBAWY,+BAAA;;IAEZ;;;;iBAYY,gCAAA;;IAEZ;;;;iBAYY,2BAAA;;;;IAIZ;;;;iBAgBY,mBAAA;;IAA0D;;;;iBAY1D,kCAAA;;;IAGZ;;;;iBAoBY,4BAAA;+BACe;;IAE3B;;;;iBA0BY,gCAAA;;IAEZ;;;;iBAYY,qBAAA;;IAKb;;;;iBAgBa,kBAAA;;;IAGZ;;;;iBAWY,iBAAA;;;;IAIZ;;;;iBAmBY,mBAAA;;IAMb;;;;iBAca,YAAA;;;kBAKI;IAEjB;;;;iBAgBa,eAAA;;;IAMb"}

package/dist/errors.mjs

@@ -0,0 +1,3 @@
+import { _ as errorTargetMigrationNotSupported, a as errorContractMissingExtensionPacks, c as errorDriverRequired, d as errorHashMismatch, f as errorJsonFormatNotSupported, g as errorRuntime, h as errorQueryRunnerFactoryRequired, i as errorContractConfigMissing, l as errorFamilyReadMarkerSqlRequired, m as errorMigrationPlanningFailed, n as errorConfigFileNotFound, o as errorContractValidationFailed, p as errorMarkerMissing, r as errorConfigValidation, s as errorDatabaseConnectionRequired, t as CliStructuredError, u as errorFileNotFound, v as errorTargetMismatch, y as errorUnexpected } from "./errors-Qlh0sdcb.mjs";
+
+export { CliStructuredError, errorConfigFileNotFound, errorConfigValidation, errorContractConfigMissing, errorContractMissingExtensionPacks, errorContractValidationFailed, errorDatabaseConnectionRequired, errorDriverRequired, errorFamilyReadMarkerSqlRequired, errorFileNotFound, errorHashMismatch, errorJsonFormatNotSupported, errorMarkerMissing, errorMigrationPlanningFailed, errorQueryRunnerFactoryRequired, errorRuntime, errorTargetMigrationNotSupported, errorTargetMismatch, errorUnexpected };

package/dist/{schema-view.d.ts → schema-view-BG_ebqoV.d.mts}

@@ -1,3 +1,4 @@
+//#region src/schema-view.d.ts
 /**
  * Core schema view types for family-agnostic schema visualization.
  *
@@ -64,23 +65,25 @@
  * Node kinds for schema tree nodes.
  * Designed to be generic enough for SQL, document, KV, and future families.
  */
-export type SchemaNodeKind = 'root' | 'namespace' | 'collection' | 'entity' | 'field' | 'index' | 'extension';
+type SchemaNodeKind = 'root' | 'namespace' | 'collection' | 'entity' | 'field' | 'index' | 'extension';
 /**
  * A node in the schema tree.
  * Tree-shaped structure good for Command Tree-style CLI output.
  */
-export interface SchemaTreeNode {
-    readonly kind: SchemaNodeKind;
-    readonly id: string;
-    readonly label: string;
-    readonly meta?: Record<string, unknown>;
-    readonly children?: readonly SchemaTreeNode[];
+interface SchemaTreeNode {
+  readonly kind: SchemaNodeKind;
+  readonly id: string;
+  readonly label: string;
+  readonly meta?: Record<string, unknown>;
+  readonly children?: readonly SchemaTreeNode[];
 }
 /**
  * Core schema view providing a family-agnostic tree representation of a schema.
  * Used by CLI and cross-family tooling for visualization.
  */
-export interface CoreSchemaView {
-    readonly root: SchemaTreeNode;
+interface CoreSchemaView {
+  readonly root: SchemaTreeNode;
 }
-//# sourceMappingURL=schema-view.d.ts.map
+//#endregion
+export { SchemaNodeKind as n, SchemaTreeNode as r, CoreSchemaView as t };
+//# sourceMappingURL=schema-view-BG_ebqoV.d.mts.map

package/dist/schema-view-BG_ebqoV.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-view-BG_ebqoV.d.mts","names":[],"sources":["../src/schema-view.ts"],"sourcesContent":[],"mappings":";;AAmEA;AAaA;;;;;AAYA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAzBY,cAAA;;;;;UAaK,cAAA;iBACA;;;kBAGC;+BACa;;;;;;UAOd,cAAA;iBACA"}

package/dist/schema-view.d.mts

@@ -0,0 +1,2 @@
+import { n as SchemaNodeKind, r as SchemaTreeNode, t as CoreSchemaView } from "./schema-view-BG_ebqoV.mjs";
+export { type CoreSchemaView, type SchemaNodeKind, type SchemaTreeNode };

package/dist/schema-view.mjs

@@ -0,0 +1 @@
+export {  };

package/dist/stack.d.mts

@@ -0,0 +1,30 @@
+import { a as ControlExtensionDescriptor, l as ControlPlaneStack, r as ControlDriverDescriptor, t as ControlAdapterDescriptor, u as ControlTargetDescriptor } from "./types-CsaU_uQP.mjs";
+
+//#region src/stack.d.ts
+
+/**
+ * Creates a ControlPlaneStack from component descriptors.
+ *
+ * Provides sensible defaults:
+ * - `driver` defaults to `undefined` (optional for commands that don't need DB connection)
+ * - `extensionPacks` defaults to `[]` (empty array)
+ *
+ * @example
+ * ```ts
+ * const stack = createControlPlaneStack({
+ *   target: postgresTarget,
+ *   adapter: postgresAdapter,
+ *   driver: postgresDriver, // optional
+ *   extensionPacks: [pgvector], // optional
+ * });
+ * ```
+ */
+declare function createControlPlaneStack<TFamilyId extends string, TTargetId extends string>(input: {
+  readonly target: ControlTargetDescriptor<TFamilyId, TTargetId>;
+  readonly adapter: ControlAdapterDescriptor<TFamilyId, TTargetId>;
+  readonly driver?: ControlDriverDescriptor<TFamilyId, TTargetId> | undefined;
+  readonly extensionPacks?: readonly ControlExtensionDescriptor<TFamilyId, TTargetId>[] | undefined;
+}): ControlPlaneStack<TFamilyId, TTargetId>;
+//#endregion
+export { createControlPlaneStack };
+//# sourceMappingURL=stack.d.mts.map

package/dist/stack.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.d.mts","names":[],"sources":["../src/stack.ts"],"sourcesContent":[],"mappings":";;;;;;AAyBA;;;;;;;;;;;;;;;AAKI,iBALY,uBAKZ,CAAA,kBAAA,MAAA,EAAA,kBAAA,MAAA,CAAA,CAAA,KAAA,EAAA;EAAiB,SAAA,MAAA,EAJF,uBAIE,CAJsB,SAItB,EAJiC,SAIjC,CAAA;oBAHD,yBAAyB,WAAW;oBACpC,wBAAwB,WAAW;qCAClB,2BAA2B,WAAW;IACvE,kBAAkB,WAAW"}