@prisma-next/core-control-plane 0.3.0-dev.3 → 0.3.0-dev.30

package/dist/{exports/errors.d.ts → errors.d.mts}

@@ -1,184 +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;
+  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;
+  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;
+  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;
+  readonly why?: string;
 }): CliStructuredError;
 /**
  * Contract configuration missing from config.
  */
 declare function errorContractConfigMissing(options?: {
-    readonly why?: string;
+  readonly why?: string;
 }): CliStructuredError;
 /**
  * Contract validation failed.
  */
 declare function errorContractValidationFailed(reason: string, options?: {
-    readonly where?: {
-        readonly path?: string;
-        readonly line?: number;
-    };
+  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;
+  readonly why?: string;
+  readonly fix?: string;
+  readonly docsUrl?: string;
 }): CliStructuredError;
 /**
- * Database URL is required but not provided.
+ * Database connection is required but not provided.
  */
-declare function errorDatabaseUrlRequired(options?: {
-    readonly why?: string;
+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;
+  readonly why?: string;
 }): CliStructuredError;
 /**
  * Family verify.readMarker is required but not provided.
  */
 declare function errorFamilyReadMarkerSqlRequired(options?: {
-    readonly why?: string;
+  readonly why?: string;
 }): CliStructuredError;
 /**
  * JSON output format not supported.
  */
 declare function errorJsonFormatNotSupported(options: {
-    readonly command: string;
-    readonly format: string;
-    readonly supportedFormats: readonly string[];
+  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;
+  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[];
+  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;
+  readonly conflicts: readonly CliErrorConflict[];
+  readonly why?: string;
 }): CliStructuredError;
 /**
  * Target does not support migrations (missing createPlanner/createRunner).
  */
 declare function errorTargetMigrationNotSupported(options?: {
-    readonly why?: string;
+  readonly why?: string;
 }): CliStructuredError;
 /**
  * Config validation error (missing required fields).
  */
 declare function errorConfigValidation(field: string, options?: {
-    readonly why?: string;
+  readonly why?: string;
 }): CliStructuredError;
 /**
  * Contract marker not found in database.
  */
 declare function errorMarkerMissing(options?: {
-    readonly why?: string;
-    readonly dbUrl?: string;
+  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;
+  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;
+  readonly why?: string;
 }): CliStructuredError;
 /**
  * Generic runtime error.
  */
 declare function errorRuntime(summary: string, options?: {
-    readonly why?: string;
-    readonly fix?: string;
-    readonly meta?: Record<string, unknown>;
+  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;
+  readonly why?: string;
+  readonly fix?: string;
 }): CliStructuredError;
-
-export { type CliErrorConflict, type CliErrorEnvelope, CliStructuredError, errorConfigFileNotFound, errorConfigValidation, errorContractConfigMissing, errorContractMissingExtensionPacks, errorContractValidationFailed, errorDatabaseUrlRequired, errorDriverRequired, errorFamilyReadMarkerSqlRequired, errorFileNotFound, errorHashMismatch, errorJsonFormatNotSupported, errorMarkerMissing, errorMigrationPlanningFailed, errorQueryRunnerFactoryRequired, errorRuntime, errorTargetMigrationNotSupported, errorTargetMismatch, errorUnexpected };
+//#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/{exports/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.
  *
@@ -70,18 +71,19 @@ type SchemaNodeKind = 'root' | 'namespace' | 'collection' | 'entity' | 'field' |
  * Tree-shaped structure good for Command Tree-style CLI output.
  */
 interface SchemaTreeNode {
-    readonly kind: SchemaNodeKind;
-    readonly id: string;
-    readonly label: string;
-    readonly meta?: Record<string, unknown>;
-    readonly children?: readonly 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.
  */
 interface CoreSchemaView {
-    readonly root: SchemaTreeNode;
+  readonly root: SchemaTreeNode;
 }
-
-export type { CoreSchemaView, SchemaNodeKind, SchemaTreeNode };
+//#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"}

package/dist/stack.mjs

@@ -0,0 +1,30 @@
+//#region src/stack.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
+* });
+* ```
+*/
+function createControlPlaneStack(input) {
+	return {
+		target: input.target,
+		adapter: input.adapter,
+		driver: input.driver,
+		extensionPacks: input.extensionPacks ?? []
+	};
+}
+
+//#endregion
+export { createControlPlaneStack };
+//# sourceMappingURL=stack.mjs.map

package/dist/stack.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.mjs","names":[],"sources":["../src/stack.ts"],"sourcesContent":["import type {\n  ControlAdapterDescriptor,\n  ControlDriverDescriptor,\n  ControlExtensionDescriptor,\n  ControlPlaneStack,\n  ControlTargetDescriptor,\n} from './types';\n\n/**\n * Creates a ControlPlaneStack from component descriptors.\n *\n * Provides sensible defaults:\n * - `driver` defaults to `undefined` (optional for commands that don't need DB connection)\n * - `extensionPacks` defaults to `[]` (empty array)\n *\n * @example\n * ```ts\n * const stack = createControlPlaneStack({\n *   target: postgresTarget,\n *   adapter: postgresAdapter,\n *   driver: postgresDriver, // optional\n *   extensionPacks: [pgvector], // optional\n * });\n * ```\n */\nexport function createControlPlaneStack<TFamilyId extends string, TTargetId extends string>(input: {\n  readonly target: ControlTargetDescriptor<TFamilyId, TTargetId>;\n  readonly adapter: ControlAdapterDescriptor<TFamilyId, TTargetId>;\n  readonly driver?: ControlDriverDescriptor<TFamilyId, TTargetId> | undefined;\n  readonly extensionPacks?: readonly ControlExtensionDescriptor<TFamilyId, TTargetId>[] | undefined;\n}): ControlPlaneStack<TFamilyId, TTargetId> {\n  return {\n    target: input.target,\n    adapter: input.adapter,\n    driver: input.driver,\n    extensionPacks: input.extensionPacks ?? [],\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAyBA,SAAgB,wBAA4E,OAKhD;AAC1C,QAAO;EACL,QAAQ,MAAM;EACd,SAAS,MAAM;EACf,QAAQ,MAAM;EACd,gBAAgB,MAAM,kBAAkB,EAAE;EAC3C"}