@prisma-next/contract 0.3.0-dev.9 → 0.3.0-dev.90

package/dist/ir-C9rRU5WS.d.mts

@@ -0,0 +1,84 @@
+//#region src/ir.d.ts
+/**
+ * ContractIR types and factories for building contract intermediate representation.
+ * ContractIR is family-agnostic and used by authoring, emitter, and no-emit runtime.
+ */
+/**
+ * ContractIR represents the intermediate representation of a contract.
+ * It is family-agnostic and contains generic storage, models, and relations.
+ * Note: storageHash/executionHash and profileHash are computed by the emitter, not part of the IR.
+ */
+interface ContractIR<TStorage extends Record<string, unknown> = Record<string, unknown>, TModels extends Record<string, unknown> = Record<string, unknown>, TRelations extends Record<string, unknown> = Record<string, unknown>, TExecution extends Record<string, unknown> = Record<string, unknown>> {
+  readonly schemaVersion: string;
+  readonly targetFamily: string;
+  readonly target: string;
+  readonly models: TModels;
+  readonly relations: TRelations;
+  readonly storage: TStorage;
+  readonly execution?: TExecution;
+  readonly extensionPacks: Record<string, unknown>;
+  readonly capabilities: Record<string, Record<string, boolean>>;
+  readonly meta: Record<string, unknown>;
+  readonly sources: Record<string, unknown>;
+}
+/**
+ * Creates the header portion of a ContractIR.
+ * Contains schema version, target, target family, storage hash, and optional profile hash.
+ */
+declare function irHeader(opts: {
+  target: string;
+  targetFamily: string;
+  storageHash: string;
+  executionHash?: string | undefined;
+  profileHash?: string | undefined;
+}): {
+  readonly schemaVersion: string;
+  readonly target: string;
+  readonly targetFamily: string;
+  readonly storageHash: string;
+  readonly executionHash?: string | undefined;
+  readonly profileHash?: string | undefined;
+};
+/**
+ * Creates the meta portion of a ContractIR.
+ * Contains capabilities, extensionPacks, meta, and sources with empty object defaults.
+ * If a field is explicitly `undefined`, it will be omitted (for testing validation).
+ */
+declare function irMeta(opts?: {
+  capabilities?: Record<string, Record<string, boolean>> | undefined;
+  extensionPacks?: Record<string, unknown> | undefined;
+  meta?: Record<string, unknown> | undefined;
+  sources?: Record<string, unknown> | undefined;
+}): {
+  readonly capabilities: Record<string, Record<string, boolean>>;
+  readonly extensionPacks: Record<string, unknown>;
+  readonly meta: Record<string, unknown>;
+  readonly sources: Record<string, unknown>;
+};
+/**
+ * Creates a complete ContractIR by combining header, meta, and family-specific sections.
+ * This is a family-agnostic factory that accepts generic storage, models, and relations.
+ */
+declare function contractIR<TStorage extends Record<string, unknown>, TModels extends Record<string, unknown>, TRelations extends Record<string, unknown>, TExecution extends Record<string, unknown>>(opts: {
+  header: {
+    readonly schemaVersion: string;
+    readonly target: string;
+    readonly targetFamily: string;
+    readonly storageHash: string;
+    readonly executionHash?: string | undefined;
+    readonly profileHash?: string | undefined;
+  };
+  meta: {
+    readonly capabilities: Record<string, Record<string, boolean>>;
+    readonly extensionPacks: Record<string, unknown>;
+    readonly meta: Record<string, unknown>;
+    readonly sources: Record<string, unknown>;
+  };
+  storage: TStorage;
+  models: TModels;
+  relations: TRelations;
+  execution?: TExecution;
+}): ContractIR<TStorage, TModels, TRelations, TExecution>;
+//#endregion
+export { irMeta as i, contractIR as n, irHeader as r, ContractIR as t };
+//# sourceMappingURL=ir-C9rRU5WS.d.mts.map

package/dist/ir-C9rRU5WS.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ir-C9rRU5WS.d.mts","names":[],"sources":["../src/ir.ts"],"sourcesContent":[],"mappings":";;AAiBA;;;;;;;;AAI+C,UAJ9B,UAI8B,CAAA,iBAH5B,MAG4B,CAAA,MAAA,EAAA,OAAA,CAAA,GAHF,MAGE,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,gBAF7B,MAE6B,CAAA,MAAA,EAAA,OAAA,CAAA,GAFH,MAEG,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,mBAD1B,MAC0B,CAAA,MAAA,EAAA,OAAA,CAAA,GADA,MACA,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,mBAA1B,MAA0B,CAAA,MAAA,EAAA,OAAA,CAAA,GAAA,MAAA,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,CAAA;EAK5B,SAAA,aAAA,EAAA,MAAA;EACG,SAAA,YAAA,EAAA,MAAA;EACF,SAAA,MAAA,EAAA,MAAA;EACG,SAAA,MAAA,EAHJ,OAGI;EACI,SAAA,SAAA,EAHL,UAGK;EACa,SAAA,OAAA,EAHpB,QAGoB;EAAf,SAAA,SAAA,CAAA,EAFF,UAEE;EACR,SAAA,cAAA,EAFU,MAEV,CAAA,MAAA,EAAA,OAAA,CAAA;EACG,SAAA,YAAA,EAFK,MAEL,CAAA,MAAA,EAFoB,MAEpB,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA;EAAM,SAAA,IAAA,EADT,MACS,CAAA,MAAA,EAAA,OAAA,CAAA;EAOV,SAAA,OAAQ,EAPJ,MAOI,CAAA,MAAA,EAAA,OAAA,CAAA;AA6BxB;;;;;AAIY,iBAjCI,QAAA,CAiCJ,IAAA,EAAA;EAE4B,MAAA,EAAA,MAAA;EAAf,YAAA,EAAA,MAAA;EACE,WAAA,EAAA,MAAA;EACV,aAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EACG,WAAA,CAAA,EAAA,MAAA,GAAA,SAAA;CAAM,CAAA,EAAA;EAcV,SAAA,aAAU,EAAA,MAAA;EACP,SAAA,MAAA,EAAA,MAAA;EACD,SAAA,YAAA,EAAA,MAAA;EACG,SAAA,WAAA,EAAA,MAAA;EACA,SAAA,aAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EAWqB,SAAA,WAAA,CAAA,EAAA,MAAA,GAAA,SAAA;CAAf;;;;;;AAOd,iBA7CG,MAAA,CA6CH,IAEiC,CAFjC,EAAA;EACC,YAAA,CAAA,EA7CG,MA6CH,CAAA,MAAA,EA7CkB,MA6ClB,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,GAAA,SAAA;EACC,cAAA,CAAA,EA7CI,MA6CJ,CAAA,MAAA,EAAA,OAAA,CAAA,GAAA,SAAA;EAAU,IAAA,CAAA,EA5ChB,MA4CgB,CAAA,MAAA,EAAA,OAAA,CAAA,GAAA,SAAA;EAAS,OAAA,CAAA,EA3CtB,MA2CsB,CAAA,MAAA,EAAA,OAAA,CAAA,GAAA,SAAA;CAAY,CAAA,EAAA;EAA1C,SAAA,YAAA,EAzCqB,MAyCrB,CAAA,MAAA,EAzCoC,MAyCpC,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA;EAAU,SAAA,cAAA,EAxCa,MAwCb,CAAA,MAAA,EAAA,OAAA,CAAA;iBAvCG;oBACG;;;;;;iBAcJ,4BACG,yCACD,4CACG,4CACA;;;;;;;;;;2BAWM,eAAe;6BACb;mBACV;sBACG;;WAEX;UACD;aACG;cACC;IACV,WAAW,UAAU,SAAS,YAAY"}

package/dist/ir.d.mts

@@ -0,0 +1,2 @@
+import { i as irMeta, n as contractIR, r as irHeader, t as ContractIR } from "./ir-C9rRU5WS.mjs";
+export { ContractIR, contractIR, irHeader, irMeta };

package/dist/ir.mjs

@@ -0,0 +1,51 @@
+//#region src/ir.ts
+function ifDefined(key, value) {
+	return value !== void 0 ? { [key]: value } : {};
+}
+/**
+* Creates the header portion of a ContractIR.
+* Contains schema version, target, target family, storage hash, and optional profile hash.
+*/
+function irHeader(opts) {
+	return {
+		schemaVersion: "1",
+		target: opts.target,
+		targetFamily: opts.targetFamily,
+		storageHash: opts.storageHash,
+		...ifDefined("executionHash", opts.executionHash),
+		...ifDefined("profileHash", opts.profileHash)
+	};
+}
+/**
+* Creates the meta portion of a ContractIR.
+* Contains capabilities, extensionPacks, meta, and sources with empty object defaults.
+* If a field is explicitly `undefined`, it will be omitted (for testing validation).
+*/
+function irMeta(opts) {
+	return {
+		capabilities: opts?.capabilities ?? {},
+		extensionPacks: opts?.extensionPacks ?? {},
+		meta: opts?.meta ?? {},
+		sources: opts?.sources ?? {}
+	};
+}
+/**
+* Creates a complete ContractIR by combining header, meta, and family-specific sections.
+* This is a family-agnostic factory that accepts generic storage, models, and relations.
+*/
+function contractIR(opts) {
+	return {
+		schemaVersion: opts.header.schemaVersion,
+		target: opts.header.target,
+		targetFamily: opts.header.targetFamily,
+		...opts.meta,
+		storage: opts.storage,
+		models: opts.models,
+		relations: opts.relations,
+		...ifDefined("execution", opts.execution)
+	};
+}
+
+//#endregion
+export { contractIR, irHeader, irMeta };
+//# sourceMappingURL=ir.mjs.map

package/dist/ir.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ir.mjs","names":[],"sources":["../src/ir.ts"],"sourcesContent":["function ifDefined<K extends string, V>(\n  key: K,\n  value: V | undefined,\n): Record<never, never> | { [P in K]: V } {\n  return value !== undefined ? ({ [key]: value } as { [P in K]: V }) : {};\n}\n\n/**\n * ContractIR types and factories for building contract intermediate representation.\n * ContractIR is family-agnostic and used by authoring, emitter, and no-emit runtime.\n */\n\n/**\n * ContractIR represents the intermediate representation of a contract.\n * It is family-agnostic and contains generic storage, models, and relations.\n * Note: storageHash/executionHash and profileHash are computed by the emitter, not part of the IR.\n */\nexport interface ContractIR<\n  TStorage extends Record<string, unknown> = Record<string, unknown>,\n  TModels extends Record<string, unknown> = Record<string, unknown>,\n  TRelations extends Record<string, unknown> = Record<string, unknown>,\n  TExecution extends Record<string, unknown> = Record<string, unknown>,\n> {\n  readonly schemaVersion: string;\n  readonly targetFamily: string;\n  readonly target: string;\n  readonly models: TModels;\n  readonly relations: TRelations;\n  readonly storage: TStorage;\n  readonly execution?: TExecution;\n  readonly extensionPacks: Record<string, unknown>;\n  readonly capabilities: Record<string, Record<string, boolean>>;\n  readonly meta: Record<string, unknown>;\n  readonly sources: Record<string, unknown>;\n}\n\n/**\n * Creates the header portion of a ContractIR.\n * Contains schema version, target, target family, storage hash, and optional profile hash.\n */\nexport function irHeader(opts: {\n  target: string;\n  targetFamily: string;\n  storageHash: string;\n  executionHash?: string | undefined;\n  profileHash?: string | undefined;\n}): {\n  readonly schemaVersion: string;\n  readonly target: string;\n  readonly targetFamily: string;\n  readonly storageHash: string;\n  readonly executionHash?: string | undefined;\n  readonly profileHash?: string | undefined;\n} {\n  return {\n    schemaVersion: '1',\n    target: opts.target,\n    targetFamily: opts.targetFamily,\n    storageHash: opts.storageHash,\n    ...ifDefined('executionHash', opts.executionHash),\n    ...ifDefined('profileHash', opts.profileHash),\n  };\n}\n\n/**\n * Creates the meta portion of a ContractIR.\n * Contains capabilities, extensionPacks, meta, and sources with empty object defaults.\n * If a field is explicitly `undefined`, it will be omitted (for testing validation).\n */\nexport function irMeta(opts?: {\n  capabilities?: Record<string, Record<string, boolean>> | undefined;\n  extensionPacks?: Record<string, unknown> | undefined;\n  meta?: Record<string, unknown> | undefined;\n  sources?: Record<string, unknown> | undefined;\n}): {\n  readonly capabilities: Record<string, Record<string, boolean>>;\n  readonly extensionPacks: Record<string, unknown>;\n  readonly meta: Record<string, unknown>;\n  readonly sources: Record<string, unknown>;\n} {\n  return {\n    capabilities: opts?.capabilities ?? {},\n    extensionPacks: opts?.extensionPacks ?? {},\n    meta: opts?.meta ?? {},\n    sources: opts?.sources ?? {},\n  };\n}\n\n/**\n * Creates a complete ContractIR by combining header, meta, and family-specific sections.\n * This is a family-agnostic factory that accepts generic storage, models, and relations.\n */\nexport function contractIR<\n  TStorage extends Record<string, unknown>,\n  TModels extends Record<string, unknown>,\n  TRelations extends Record<string, unknown>,\n  TExecution extends Record<string, unknown>,\n>(opts: {\n  header: {\n    readonly schemaVersion: string;\n    readonly target: string;\n    readonly targetFamily: string;\n    readonly storageHash: string;\n    readonly executionHash?: string | undefined;\n    readonly profileHash?: string | undefined;\n  };\n  meta: {\n    readonly capabilities: Record<string, Record<string, boolean>>;\n    readonly extensionPacks: Record<string, unknown>;\n    readonly meta: Record<string, unknown>;\n    readonly sources: Record<string, unknown>;\n  };\n  storage: TStorage;\n  models: TModels;\n  relations: TRelations;\n  execution?: TExecution;\n}): ContractIR<TStorage, TModels, TRelations, TExecution> {\n  // ContractIR doesn't include storageHash/executionHash or profileHash (those are computed by emitter)\n  return {\n    schemaVersion: opts.header.schemaVersion,\n    target: opts.header.target,\n    targetFamily: opts.header.targetFamily,\n    ...opts.meta,\n    storage: opts.storage,\n    models: opts.models,\n    relations: opts.relations,\n    ...ifDefined('execution', opts.execution),\n  };\n}\n"],"mappings":";AAAA,SAAS,UACP,KACA,OACwC;AACxC,QAAO,UAAU,SAAa,GAAG,MAAM,OAAO,GAAuB,EAAE;;;;;;AAoCzE,SAAgB,SAAS,MAavB;AACA,QAAO;EACL,eAAe;EACf,QAAQ,KAAK;EACb,cAAc,KAAK;EACnB,aAAa,KAAK;EAClB,GAAG,UAAU,iBAAiB,KAAK,cAAc;EACjD,GAAG,UAAU,eAAe,KAAK,YAAY;EAC9C;;;;;;;AAQH,SAAgB,OAAO,MAUrB;AACA,QAAO;EACL,cAAc,MAAM,gBAAgB,EAAE;EACtC,gBAAgB,MAAM,kBAAkB,EAAE;EAC1C,MAAM,MAAM,QAAQ,EAAE;EACtB,SAAS,MAAM,WAAW,EAAE;EAC7B;;;;;;AAOH,SAAgB,WAKd,MAmBwD;AAExD,QAAO;EACL,eAAe,KAAK,OAAO;EAC3B,QAAQ,KAAK,OAAO;EACpB,cAAc,KAAK,OAAO;EAC1B,GAAG,KAAK;EACR,SAAS,KAAK;EACd,QAAQ,KAAK;EACb,WAAW,KAAK;EAChB,GAAG,UAAU,aAAa,KAAK,UAAU;EAC1C"}

package/dist/types-54JRJq9p.d.mts

@@ -0,0 +1,395 @@
+import { t as ContractIR } from "./ir-C9rRU5WS.mjs";
+import { OperationRegistry } from "@prisma-next/operations";
+
+//#region src/types.d.ts
+
+/**
+ * Unique symbol used as the key for branding types.
+ */
+declare const $: unique symbol;
+/**
+ * A helper type to brand a given type with a unique identifier.
+ *
+ * @template TKey Text used as the brand key.
+ * @template TValue Optional value associated with the brand key. Defaults to `true`.
+ */
+type Brand<TKey extends string | number | symbol, TValue = true> = {
+  [$]: { [K in TKey]: TValue };
+};
+/**
+ * Context passed to type renderers during contract.d.ts generation.
+ */
+interface RenderTypeContext {
+  /** The name of the CodecTypes type alias (typically 'CodecTypes') */
+  readonly codecTypesName: string;
+}
+/**
+ * Base type for storage contract hashes.
+ * Emitted contract.d.ts files use this with the hash value as a type parameter:
+ * `type StorageHash = StorageHashBase<'sha256:abc123...'>`
+ */
+type StorageHashBase<THash extends string> = THash & Brand<'StorageHash'>;
+/**
+ * Base type for execution contract hashes.
+ * Emitted contract.d.ts files use this with the hash value as a type parameter:
+ * `type ExecutionHash = ExecutionHashBase<'sha256:def456...'>`
+ */
+type ExecutionHashBase<THash extends string> = THash & Brand<'ExecutionHash'>;
+declare function coreHash<const T extends string>(value: T): StorageHashBase<T>;
+/**
+ * Base type for profile contract hashes.
+ * Emitted contract.d.ts files use this with the hash value as a type parameter:
+ * `type ProfileHash = ProfileHashBase<'sha256:def456...'>`
+ */
+type ProfileHashBase<THash extends string> = THash & Brand<'ProfileHash'>;
+declare function profileHash<const T extends string>(value: T): ProfileHashBase<T>;
+interface ContractBase<TStorageHash extends StorageHashBase<string> = StorageHashBase<string>, TExecutionHash extends ExecutionHashBase<string> = ExecutionHashBase<string>, TProfileHash extends ProfileHashBase<string> = ProfileHashBase<string>> {
+  readonly schemaVersion: string;
+  readonly target: string;
+  readonly targetFamily: string;
+  readonly storageHash: TStorageHash;
+  readonly executionHash?: TExecutionHash | undefined;
+  readonly profileHash?: TProfileHash | undefined;
+  readonly capabilities: Record<string, Record<string, boolean>>;
+  readonly extensionPacks: Record<string, unknown>;
+  readonly meta: Record<string, unknown>;
+  readonly sources: Record<string, Source>;
+  readonly execution?: ExecutionSection;
+}
+interface FieldType {
+  readonly type: string;
+  readonly nullable: boolean;
+  readonly items?: FieldType;
+  readonly properties?: Record<string, FieldType>;
+}
+type GeneratedValueSpec = {
+  readonly id: string;
+  readonly params?: Record<string, unknown>;
+};
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | {
+  readonly [key: string]: JsonValue;
+} | readonly JsonValue[];
+type TaggedBigInt = {
+  readonly $type: 'bigint';
+  readonly value: string;
+};
+declare function isTaggedBigInt(value: unknown): value is TaggedBigInt;
+declare function bigintJsonReplacer(_key: string, value: unknown): unknown;
+type TaggedRaw = {
+  readonly $type: 'raw';
+  readonly value: JsonValue;
+};
+declare function isTaggedRaw(value: unknown): value is TaggedRaw;
+type TaggedLiteralValue = TaggedBigInt | TaggedRaw;
+type ColumnDefaultLiteralValue = JsonValue | TaggedLiteralValue;
+type ColumnDefaultLiteralInputValue = ColumnDefaultLiteralValue | bigint | Date;
+type ColumnDefault = {
+  readonly kind: 'literal';
+  readonly value: ColumnDefaultLiteralInputValue;
+} | {
+  readonly kind: 'function';
+  readonly expression: string;
+};
+type ExecutionMutationDefaultValue = {
+  readonly kind: 'generator';
+  readonly id: GeneratedValueSpec['id'];
+  readonly params?: Record<string, unknown>;
+};
+type ExecutionMutationDefault = {
+  readonly ref: {
+    readonly table: string;
+    readonly column: string;
+  };
+  readonly onCreate?: ExecutionMutationDefaultValue;
+  readonly onUpdate?: ExecutionMutationDefaultValue;
+};
+type ExecutionSection = {
+  readonly mutations: {
+    readonly defaults: ReadonlyArray<ExecutionMutationDefault>;
+  };
+};
+interface Source {
+  readonly readOnly: boolean;
+  readonly projection: Record<string, FieldType>;
+  readonly origin?: Record<string, unknown>;
+  readonly capabilities?: Record<string, boolean>;
+}
+interface DocIndex {
+  readonly name: string;
+  readonly keys: Record<string, 'asc' | 'desc'>;
+  readonly unique?: boolean;
+  readonly where?: Expr;
+}
+type Expr = {
+  readonly kind: 'eq';
+  readonly path: ReadonlyArray<string>;
+  readonly value: unknown;
+} | {
+  readonly kind: 'exists';
+  readonly path: ReadonlyArray<string>;
+};
+interface DocCollection {
+  readonly name: string;
+  readonly id?: {
+    readonly strategy: 'auto' | 'client' | 'uuid' | 'objectId';
+  };
+  readonly fields: Record<string, FieldType>;
+  readonly indexes?: ReadonlyArray<DocIndex>;
+  readonly readOnly?: boolean;
+}
+interface DocumentStorage {
+  readonly document: {
+    readonly collections: Record<string, DocCollection>;
+  };
+}
+interface DocumentContract<TStorageHash extends StorageHashBase<string> = StorageHashBase<string>, TExecutionHash extends ExecutionHashBase<string> = ExecutionHashBase<string>, TProfileHash extends ProfileHashBase<string> = ProfileHashBase<string>> extends ContractBase<TStorageHash, TExecutionHash, TProfileHash> {
+  readonly targetFamily: string;
+  readonly storage: DocumentStorage;
+}
+interface ParamDescriptor {
+  readonly index?: number;
+  readonly name?: string;
+  readonly codecId?: string;
+  readonly nativeType?: string;
+  readonly nullable?: boolean;
+  readonly source: 'dsl' | 'raw' | 'lane';
+  readonly refs?: {
+    table: string;
+    column: string;
+  };
+}
+interface PlanRefs {
+  readonly tables?: readonly string[];
+  readonly columns?: ReadonlyArray<{
+    table: string;
+    column: string;
+  }>;
+  readonly indexes?: ReadonlyArray<{
+    readonly table: string;
+    readonly columns: ReadonlyArray<string>;
+    readonly name?: string;
+  }>;
+}
+interface PlanMeta {
+  readonly target: string;
+  readonly targetFamily?: string;
+  readonly storageHash: string;
+  readonly profileHash?: string;
+  readonly lane: string;
+  readonly annotations?: {
+    codecs?: Record<string, string>;
+    [key: string]: unknown;
+  };
+  readonly paramDescriptors: ReadonlyArray<ParamDescriptor>;
+  readonly refs?: PlanRefs;
+  readonly projection?: Record<string, string> | ReadonlyArray<string>;
+  /**
+   * Optional mapping of projection alias → column type ID (fully qualified ns/name@version).
+   * Used for codec resolution when AST+refs don't provide enough type info.
+   */
+  readonly projectionTypes?: Record<string, string>;
+}
+/**
+ * Canonical execution plan shape used by runtimes.
+ *
+ * - Row is the inferred result row type (TypeScript-only).
+ * - Ast is the optional, family-specific AST type (e.g. SQL QueryAst).
+ *
+ * The payload executed by the runtime is represented by the sql + params pair
+ * for now; future families can specialize this via Ast or additional metadata.
+ */
+interface ExecutionPlan<Row = unknown, Ast = unknown> {
+  readonly sql: string;
+  readonly params: readonly unknown[];
+  readonly ast?: Ast;
+  readonly meta: PlanMeta;
+  /**
+   * Phantom property to carry the Row generic for type-level utilities.
+   * Not set at runtime; used only for ResultType extraction.
+   */
+  readonly _row?: Row;
+}
+/**
+ * Utility type to extract the Row type from an ExecutionPlan.
+ * Example: `type Row = ResultType<typeof plan>`
+ *
+ * Works with both ExecutionPlan and SqlQueryPlan (SQL query plans before lowering).
+ * SqlQueryPlan includes a phantom `_Row` property to preserve the generic parameter
+ * for type extraction.
+ */
+type ResultType<P> = P extends ExecutionPlan<infer R, unknown> ? R : P extends {
+  readonly _Row?: infer R;
+} ? R : never;
+/**
+ * Type guard to check if a contract is a Document contract
+ */
+declare function isDocumentContract(contract: unknown): contract is DocumentContract;
+/**
+ * Contract marker record stored in the database.
+ * Represents the current contract identity for a database.
+ */
+interface ContractMarkerRecord {
+  readonly storageHash: string;
+  readonly profileHash: string;
+  readonly contractJson: unknown | null;
+  readonly canonicalVersion: number | null;
+  readonly updatedAt: Date;
+  readonly appTag: string | null;
+  readonly meta: Record<string, unknown>;
+}
+/**
+ * Specifies how to import TypeScript types from a package.
+ * Used in extension pack manifests to declare codec and operation type imports.
+ */
+interface TypesImportSpec {
+  readonly package: string;
+  readonly named: string;
+  readonly alias: string;
+}
+/**
+ * Validation context passed to TargetFamilyHook.validateTypes().
+ * Contains pre-assembled operation registry, type imports, and extension IDs.
+ */
+interface ValidationContext {
+  readonly operationRegistry?: OperationRegistry;
+  readonly codecTypeImports?: ReadonlyArray<TypesImportSpec>;
+  readonly operationTypeImports?: ReadonlyArray<TypesImportSpec>;
+  readonly extensionIds?: ReadonlyArray<string>;
+  /**
+   * Parameterized codec descriptors collected from adapters and extensions.
+   * Map of codecId → descriptor for quick lookup during type generation.
+   */
+  readonly parameterizedCodecs?: Map<string, ParameterizedCodecDescriptor>;
+}
+/**
+ * Context for rendering parameterized types during contract.d.ts generation.
+ * Passed to type renderers so they can reference CodecTypes by name.
+ */
+interface TypeRenderContext {
+  readonly codecTypesName: string;
+}
+/**
+ * A normalized type renderer for parameterized codecs.
+ * This is the interface expected by TargetFamilyHook.generateContractTypes.
+ */
+interface TypeRenderEntry {
+  readonly codecId: string;
+  readonly render: (params: Record<string, unknown>, ctx: TypeRenderContext) => string;
+}
+/**
+ * Additional options for generateContractTypes.
+ */
+interface GenerateContractTypesOptions {
+  /**
+   * Normalized parameterized type renderers, keyed by codecId.
+   * When a column has typeParams and a renderer exists for its codecId,
+   * the renderer is called to produce the TypeScript type expression.
+   */
+  readonly parameterizedRenderers?: Map<string, TypeRenderEntry>;
+  /**
+   * Type imports for parameterized codecs.
+   * These are merged with codec and operation type imports in contract.d.ts.
+   */
+  readonly parameterizedTypeImports?: ReadonlyArray<TypesImportSpec>;
+}
+/**
+ * SPI interface for target family hooks that extend emission behavior.
+ * Implemented by family-specific emitter hooks (e.g., SQL family).
+ */
+interface TargetFamilyHook {
+  readonly id: string;
+  /**
+   * Validates that all type IDs in the contract come from referenced extension packs.
+   * @param ir - Contract IR to validate
+   * @param ctx - Validation context with operation registry and extension IDs
+   */
+  validateTypes(ir: ContractIR, ctx: ValidationContext): void;
+  /**
+   * Validates family-specific contract structure.
+   * @param ir - Contract IR to validate
+   */
+  validateStructure(ir: ContractIR): void;
+  /**
+   * Generates contract.d.ts file content.
+   * @param ir - Contract IR
+   * @param codecTypeImports - Array of codec type import specs
+   * @param operationTypeImports - Array of operation type import specs
+   * @param hashes - Contract hash values (storageHash, executionHash, profileHash)
+   * @param options - Additional options including parameterized type renderers
+   * @returns Generated TypeScript type definitions as string
+   */
+  generateContractTypes(ir: ContractIR, codecTypeImports: ReadonlyArray<TypesImportSpec>, operationTypeImports: ReadonlyArray<TypesImportSpec>, hashes: {
+    readonly storageHash: string;
+    readonly executionHash?: string;
+    readonly profileHash: string;
+  }, options?: GenerateContractTypesOptions): string;
+}
+/**
+ * Declarative type renderer that produces a TypeScript type expression.
+ *
+ * Renderers can be:
+ * - A template string with `{{paramName}}` placeholders (e.g., `Vector<{{length}}>`)
+ * - A function that receives typeParams and context and returns a type expression
+ *
+ * **Prefer template strings** for most cases:
+ * - Templates are JSON-serializable (safe for pack-ref metadata)
+ * - Templates can be statically analyzed by tooling
+ *
+ * Function renderers are allowed but have tradeoffs:
+ * - Require runtime execution during emission (the emitter runs code)
+ * - Not JSON-serializable (can't be stored in contract.json)
+ * - The emitted artifacts (contract.json, contract.d.ts) still contain no
+ *   executable code - this constraint applies to outputs, not the emission process
+ */
+type TypeRenderer = string | ((params: Record<string, unknown>, ctx: RenderTypeContext) => string);
+/**
+ * Descriptor for a codec that supports type parameters.
+ *
+ * Parameterized codecs allow columns to carry additional metadata (typeParams)
+ * that affects the generated TypeScript types. For example:
+ * - A vector codec can use `{ length: 1536 }` to generate `Vector<1536>`
+ * - A decimal codec can use `{ precision: 10, scale: 2 }` to generate `Decimal<10, 2>`
+ *
+ * The SQL family emitter uses these descriptors to generate precise types
+ * without hard-coding knowledge of specific codec IDs.
+ *
+ * @example
+ * ```typescript
+ * const vectorCodecDescriptor: ParameterizedCodecDescriptor = {
+ *   codecId: 'pg/vector@1',
+ *   outputTypeRenderer: 'Vector<{{length}}>',
+ *   // Optional: paramsSchema for runtime validation
+ * };
+ * ```
+ */
+interface ParameterizedCodecDescriptor {
+  /** The codec ID this descriptor applies to (e.g., 'pg/vector@1') */
+  readonly codecId: string;
+  /**
+   * Renderer for the output (read) type.
+   * Can be a template string or function.
+   *
+   * This is the primary renderer used by SQL emission to generate
+   * model field types in contract.d.ts.
+   */
+  readonly outputTypeRenderer: TypeRenderer;
+  /**
+   * Optional renderer for the input (write) type.
+   * If not provided, outputTypeRenderer is used for both.
+   *
+   * **Reserved for future use**: Currently, SQL emission only uses
+   * outputTypeRenderer. This field is defined for future support of
+   * asymmetric codecs where input and output types differ (e.g., a
+   * codec that accepts `string | number` but always returns `number`).
+   */
+  readonly inputTypeRenderer?: TypeRenderer;
+  /**
+   * Optional import spec for types used by this codec's renderers.
+   * The emitter will add this import to contract.d.ts.
+   */
+  readonly typesImport?: TypesImportSpec;
+}
+//#endregion
+export { Source as A, ValidationContext as B, ParamDescriptor as C, ProfileHashBase as D, PlanRefs as E, TargetFamilyHook as F, isTaggedRaw as G, coreHash as H, TypeRenderContext as I, profileHash as K, TypeRenderEntry as L, TaggedBigInt as M, TaggedLiteralValue as N, RenderTypeContext as O, TaggedRaw as P, TypeRenderer as R, JsonValue as S, PlanMeta as T, isDocumentContract as U, bigintJsonReplacer as V, isTaggedBigInt as W, Expr as _, ColumnDefaultLiteralValue as a, GeneratedValueSpec as b, DocCollection as c, DocumentStorage as d, ExecutionHashBase as f, ExecutionSection as g, ExecutionPlan as h, ColumnDefaultLiteralInputValue as i, StorageHashBase as j, ResultType as k, DocIndex as l, ExecutionMutationDefaultValue as m, Brand as n, ContractBase as o, ExecutionMutationDefault as p, ColumnDefault as r, ContractMarkerRecord as s, $ as t, DocumentContract as u, FieldType as v, ParameterizedCodecDescriptor as w, JsonPrimitive as x, GenerateContractTypesOptions as y, TypesImportSpec as z };
+//# sourceMappingURL=types-54JRJq9p.d.mts.map

package/dist/types-54JRJq9p.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-54JRJq9p.d.mts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/types.d.mts

@@ -0,0 +1,2 @@
+import { A as Source, B as ValidationContext, C as ParamDescriptor, D as ProfileHashBase, E as PlanRefs, F as TargetFamilyHook, G as isTaggedRaw, H as coreHash, I as TypeRenderContext, K as profileHash, L as TypeRenderEntry, M as TaggedBigInt, N as TaggedLiteralValue, O as RenderTypeContext, P as TaggedRaw, R as TypeRenderer, S as JsonValue, T as PlanMeta, U as isDocumentContract, V as bigintJsonReplacer, W as isTaggedBigInt, _ as Expr, a as ColumnDefaultLiteralValue, b as GeneratedValueSpec, c as DocCollection, d as DocumentStorage, f as ExecutionHashBase, g as ExecutionSection, h as ExecutionPlan, i as ColumnDefaultLiteralInputValue, j as StorageHashBase, k as ResultType, l as DocIndex, m as ExecutionMutationDefaultValue, n as Brand, o as ContractBase, p as ExecutionMutationDefault, r as ColumnDefault, s as ContractMarkerRecord, t as $, u as DocumentContract, v as FieldType, w as ParameterizedCodecDescriptor, x as JsonPrimitive, y as GenerateContractTypesOptions, z as TypesImportSpec } from "./types-54JRJq9p.mjs";
+export { type $, type Brand, type ColumnDefault, type ColumnDefaultLiteralInputValue, type ColumnDefaultLiteralValue, type ContractBase, type ContractMarkerRecord, type DocCollection, type DocIndex, type DocumentContract, type DocumentStorage, type ExecutionHashBase, type ExecutionMutationDefault, type ExecutionMutationDefaultValue, type ExecutionPlan, type ExecutionSection, type Expr, type FieldType, type GenerateContractTypesOptions, type GeneratedValueSpec, type JsonPrimitive, type JsonValue, type ParamDescriptor, type ParameterizedCodecDescriptor, type PlanMeta, type PlanRefs, type ProfileHashBase, type RenderTypeContext, type ResultType, type Source, type StorageHashBase, type TaggedBigInt, type TaggedLiteralValue, type TaggedRaw, type TargetFamilyHook, type TypeRenderContext, type TypeRenderEntry, type TypeRenderer, type TypesImportSpec, type ValidationContext, bigintJsonReplacer, coreHash, isDocumentContract, isTaggedBigInt, isTaggedRaw, profileHash };

package/dist/types.mjs

@@ -0,0 +1,30 @@
+//#region src/types.ts
+function coreHash(value) {
+	return value;
+}
+function profileHash(value) {
+	return value;
+}
+function isTaggedBigInt(value) {
+	return typeof value === "object" && value !== null && value.$type === "bigint" && typeof value.value === "string";
+}
+function bigintJsonReplacer(_key, value) {
+	if (typeof value === "bigint") return {
+		$type: "bigint",
+		value: value.toString()
+	};
+	return value;
+}
+function isTaggedRaw(value) {
+	return typeof value === "object" && value !== null && value.$type === "raw" && "value" in value;
+}
+/**
+* Type guard to check if a contract is a Document contract
+*/
+function isDocumentContract(contract) {
+	return typeof contract === "object" && contract !== null && "targetFamily" in contract && contract.targetFamily === "document";
+}
+
+//#endregion
+export { bigintJsonReplacer, coreHash, isDocumentContract, isTaggedBigInt, isTaggedRaw, profileHash };
+//# sourceMappingURL=types.mjs.map

package/dist/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["import type { OperationRegistry } from '@prisma-next/operations';\nimport type { ContractIR } from './ir';\n\n/**\n * Unique symbol used as the key for branding types.\n */\nexport const $: unique symbol = Symbol('__prisma_next_brand__');\n\n/**\n * A helper type to brand a given type with a unique identifier.\n *\n * @template TKey Text used as the brand key.\n * @template TValue Optional value associated with the brand key. Defaults to `true`.\n */\nexport type Brand<TKey extends string | number | symbol, TValue = true> = {\n  [$]: {\n    [K in TKey]: TValue;\n  };\n};\n\n/**\n * Context passed to type renderers during contract.d.ts generation.\n */\nexport interface RenderTypeContext {\n  /** The name of the CodecTypes type alias (typically 'CodecTypes') */\n  readonly codecTypesName: string;\n}\n\n/**\n * Base type for storage contract hashes.\n * Emitted contract.d.ts files use this with the hash value as a type parameter:\n * `type StorageHash = StorageHashBase<'sha256:abc123...'>`\n */\nexport type StorageHashBase<THash extends string> = THash & Brand<'StorageHash'>;\n\n/**\n * Base type for execution contract hashes.\n * Emitted contract.d.ts files use this with the hash value as a type parameter:\n * `type ExecutionHash = ExecutionHashBase<'sha256:def456...'>`\n */\nexport type ExecutionHashBase<THash extends string> = THash & Brand<'ExecutionHash'>;\n\nexport function coreHash<const T extends string>(value: T): StorageHashBase<T> {\n  return value as StorageHashBase<T>;\n}\n\n/**\n * Base type for profile contract hashes.\n * Emitted contract.d.ts files use this with the hash value as a type parameter:\n * `type ProfileHash = ProfileHashBase<'sha256:def456...'>`\n */\nexport type ProfileHashBase<THash extends string> = THash & Brand<'ProfileHash'>;\n\nexport function profileHash<const T extends string>(value: T): ProfileHashBase<T> {\n  return value as ProfileHashBase<T>;\n}\n\nexport interface ContractBase<\n  TStorageHash extends StorageHashBase<string> = StorageHashBase<string>,\n  TExecutionHash extends ExecutionHashBase<string> = ExecutionHashBase<string>,\n  TProfileHash extends ProfileHashBase<string> = ProfileHashBase<string>,\n> {\n  readonly schemaVersion: string;\n  readonly target: string;\n  readonly targetFamily: string;\n  readonly storageHash: TStorageHash;\n  readonly executionHash?: TExecutionHash | undefined;\n  readonly profileHash?: TProfileHash | undefined;\n  readonly capabilities: Record<string, Record<string, boolean>>;\n  readonly extensionPacks: Record<string, unknown>;\n  readonly meta: Record<string, unknown>;\n  readonly sources: Record<string, Source>;\n  readonly execution?: ExecutionSection;\n}\n\nexport interface FieldType {\n  readonly type: string;\n  readonly nullable: boolean;\n  readonly items?: FieldType;\n  readonly properties?: Record<string, FieldType>;\n}\n\nexport type GeneratedValueSpec = {\n  readonly id: string;\n  readonly params?: Record<string, unknown>;\n};\n\nexport type JsonPrimitive = string | number | boolean | null;\n\nexport type JsonValue =\n  | JsonPrimitive\n  | { readonly [key: string]: JsonValue }\n  | readonly JsonValue[];\n\nexport type TaggedBigInt = { readonly $type: 'bigint'; readonly value: string };\n\nexport function isTaggedBigInt(value: unknown): value is TaggedBigInt {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    (value as { $type?: unknown }).$type === 'bigint' &&\n    typeof (value as { value?: unknown }).value === 'string'\n  );\n}\n\nexport function bigintJsonReplacer(_key: string, value: unknown): unknown {\n  if (typeof value === 'bigint') {\n    return { $type: 'bigint', value: value.toString() } satisfies TaggedBigInt;\n  }\n  return value;\n}\n\nexport type TaggedRaw = { readonly $type: 'raw'; readonly value: JsonValue };\n\nexport function isTaggedRaw(value: unknown): value is TaggedRaw {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    (value as { $type?: unknown }).$type === 'raw' &&\n    'value' in (value as object)\n  );\n}\n\nexport type TaggedLiteralValue = TaggedBigInt | TaggedRaw;\n\nexport type ColumnDefaultLiteralValue = JsonValue | TaggedLiteralValue;\n\nexport type ColumnDefaultLiteralInputValue = ColumnDefaultLiteralValue | bigint | Date;\n\nexport type ColumnDefault =\n  | {\n      readonly kind: 'literal';\n      readonly value: ColumnDefaultLiteralInputValue;\n    }\n  | { readonly kind: 'function'; readonly expression: string };\n\nexport type ExecutionMutationDefaultValue = {\n  readonly kind: 'generator';\n  readonly id: GeneratedValueSpec['id'];\n  readonly params?: Record<string, unknown>;\n};\n\nexport type ExecutionMutationDefault = {\n  readonly ref: { readonly table: string; readonly column: string };\n  readonly onCreate?: ExecutionMutationDefaultValue;\n  readonly onUpdate?: ExecutionMutationDefaultValue;\n};\n\nexport type ExecutionSection = {\n  readonly mutations: {\n    readonly defaults: ReadonlyArray<ExecutionMutationDefault>;\n  };\n};\n\nexport interface Source {\n  readonly readOnly: boolean;\n  readonly projection: Record<string, FieldType>;\n  readonly origin?: Record<string, unknown>;\n  readonly capabilities?: Record<string, boolean>;\n}\n\n// Document family types\nexport interface DocIndex {\n  readonly name: string;\n  readonly keys: Record<string, 'asc' | 'desc'>;\n  readonly unique?: boolean;\n  readonly where?: Expr;\n}\n\nexport type Expr =\n  | { readonly kind: 'eq'; readonly path: ReadonlyArray<string>; readonly value: unknown }\n  | { readonly kind: 'exists'; readonly path: ReadonlyArray<string> };\n\nexport interface DocCollection {\n  readonly name: string;\n  readonly id?: {\n    readonly strategy: 'auto' | 'client' | 'uuid' | 'objectId';\n  };\n  readonly fields: Record<string, FieldType>;\n  readonly indexes?: ReadonlyArray<DocIndex>;\n  readonly readOnly?: boolean;\n}\n\nexport interface DocumentStorage {\n  readonly document: {\n    readonly collections: Record<string, DocCollection>;\n  };\n}\n\nexport interface DocumentContract<\n  TStorageHash extends StorageHashBase<string> = StorageHashBase<string>,\n  TExecutionHash extends ExecutionHashBase<string> = ExecutionHashBase<string>,\n  TProfileHash extends ProfileHashBase<string> = ProfileHashBase<string>,\n> extends ContractBase<TStorageHash, TExecutionHash, TProfileHash> {\n  // Accept string to work with JSON imports; runtime validation ensures 'document'\n  readonly targetFamily: string;\n  readonly storage: DocumentStorage;\n}\n\n// Plan types - target-family agnostic execution types\nexport interface ParamDescriptor {\n  readonly index?: number;\n  readonly name?: string;\n  readonly codecId?: string;\n  readonly nativeType?: string;\n  readonly nullable?: boolean;\n  readonly source: 'dsl' | 'raw' | 'lane';\n  readonly refs?: { table: string; column: string };\n}\n\nexport interface PlanRefs {\n  readonly tables?: readonly string[];\n  readonly columns?: ReadonlyArray<{ table: string; column: string }>;\n  readonly indexes?: ReadonlyArray<{\n    readonly table: string;\n    readonly columns: ReadonlyArray<string>;\n    readonly name?: string;\n  }>;\n}\n\nexport interface PlanMeta {\n  readonly target: string;\n  readonly targetFamily?: string;\n  readonly storageHash: string;\n  readonly profileHash?: string;\n  readonly lane: string;\n  readonly annotations?: {\n    codecs?: Record<string, string>; // alias/param → codec id ('ns/name@v')\n    [key: string]: unknown;\n  };\n  readonly paramDescriptors: ReadonlyArray<ParamDescriptor>;\n  readonly refs?: PlanRefs;\n  readonly projection?: Record<string, string> | ReadonlyArray<string>;\n  /**\n   * Optional mapping of projection alias → column type ID (fully qualified ns/name@version).\n   * Used for codec resolution when AST+refs don't provide enough type info.\n   */\n  readonly projectionTypes?: Record<string, string>;\n}\n\n/**\n * Canonical execution plan shape used by runtimes.\n *\n * - Row is the inferred result row type (TypeScript-only).\n * - Ast is the optional, family-specific AST type (e.g. SQL QueryAst).\n *\n * The payload executed by the runtime is represented by the sql + params pair\n * for now; future families can specialize this via Ast or additional metadata.\n */\nexport interface ExecutionPlan<Row = unknown, Ast = unknown> {\n  readonly sql: string;\n  readonly params: readonly unknown[];\n  readonly ast?: Ast;\n  readonly meta: PlanMeta;\n  /**\n   * Phantom property to carry the Row generic for type-level utilities.\n   * Not set at runtime; used only for ResultType extraction.\n   */\n  readonly _row?: Row;\n}\n\n/**\n * Utility type to extract the Row type from an ExecutionPlan.\n * Example: `type Row = ResultType<typeof plan>`\n *\n * Works with both ExecutionPlan and SqlQueryPlan (SQL query plans before lowering).\n * SqlQueryPlan includes a phantom `_Row` property to preserve the generic parameter\n * for type extraction.\n */\nexport type ResultType<P> =\n  P extends ExecutionPlan<infer R, unknown> ? R : P extends { readonly _Row?: infer R } ? R : never;\n\n/**\n * Type guard to check if a contract is a Document contract\n */\nexport function isDocumentContract(contract: unknown): contract is DocumentContract {\n  return (\n    typeof contract === 'object' &&\n    contract !== null &&\n    'targetFamily' in contract &&\n    contract.targetFamily === 'document'\n  );\n}\n\n/**\n * Contract marker record stored in the database.\n * Represents the current contract identity for a database.\n */\nexport interface ContractMarkerRecord {\n  readonly storageHash: string;\n  readonly profileHash: string;\n  readonly contractJson: unknown | null;\n  readonly canonicalVersion: number | null;\n  readonly updatedAt: Date;\n  readonly appTag: string | null;\n  readonly meta: Record<string, unknown>;\n}\n\n// Emitter types - moved from @prisma-next/emitter to shared location\n/**\n * Specifies how to import TypeScript types from a package.\n * Used in extension pack manifests to declare codec and operation type imports.\n */\nexport interface TypesImportSpec {\n  readonly package: string;\n  readonly named: string;\n  readonly alias: string;\n}\n\n/**\n * Validation context passed to TargetFamilyHook.validateTypes().\n * Contains pre-assembled operation registry, type imports, and extension IDs.\n */\nexport interface ValidationContext {\n  readonly operationRegistry?: OperationRegistry;\n  readonly codecTypeImports?: ReadonlyArray<TypesImportSpec>;\n  readonly operationTypeImports?: ReadonlyArray<TypesImportSpec>;\n  readonly extensionIds?: ReadonlyArray<string>;\n  /**\n   * Parameterized codec descriptors collected from adapters and extensions.\n   * Map of codecId → descriptor for quick lookup during type generation.\n   */\n  readonly parameterizedCodecs?: Map<string, ParameterizedCodecDescriptor>;\n}\n\n/**\n * Context for rendering parameterized types during contract.d.ts generation.\n * Passed to type renderers so they can reference CodecTypes by name.\n */\nexport interface TypeRenderContext {\n  readonly codecTypesName: string;\n}\n\n/**\n * A normalized type renderer for parameterized codecs.\n * This is the interface expected by TargetFamilyHook.generateContractTypes.\n */\nexport interface TypeRenderEntry {\n  readonly codecId: string;\n  readonly render: (params: Record<string, unknown>, ctx: TypeRenderContext) => string;\n}\n\n/**\n * Additional options for generateContractTypes.\n */\nexport interface GenerateContractTypesOptions {\n  /**\n   * Normalized parameterized type renderers, keyed by codecId.\n   * When a column has typeParams and a renderer exists for its codecId,\n   * the renderer is called to produce the TypeScript type expression.\n   */\n  readonly parameterizedRenderers?: Map<string, TypeRenderEntry>;\n  /**\n   * Type imports for parameterized codecs.\n   * These are merged with codec and operation type imports in contract.d.ts.\n   */\n  readonly parameterizedTypeImports?: ReadonlyArray<TypesImportSpec>;\n}\n\n/**\n * SPI interface for target family hooks that extend emission behavior.\n * Implemented by family-specific emitter hooks (e.g., SQL family).\n */\nexport interface TargetFamilyHook {\n  readonly id: string;\n\n  /**\n   * Validates that all type IDs in the contract come from referenced extension packs.\n   * @param ir - Contract IR to validate\n   * @param ctx - Validation context with operation registry and extension IDs\n   */\n  validateTypes(ir: ContractIR, ctx: ValidationContext): void;\n\n  /**\n   * Validates family-specific contract structure.\n   * @param ir - Contract IR to validate\n   */\n  validateStructure(ir: ContractIR): void;\n\n  /**\n   * Generates contract.d.ts file content.\n   * @param ir - Contract IR\n   * @param codecTypeImports - Array of codec type import specs\n   * @param operationTypeImports - Array of operation type import specs\n   * @param hashes - Contract hash values (storageHash, executionHash, profileHash)\n   * @param options - Additional options including parameterized type renderers\n   * @returns Generated TypeScript type definitions as string\n   */\n  generateContractTypes(\n    ir: ContractIR,\n    codecTypeImports: ReadonlyArray<TypesImportSpec>,\n    operationTypeImports: ReadonlyArray<TypesImportSpec>,\n    hashes: {\n      readonly storageHash: string;\n      readonly executionHash?: string;\n      readonly profileHash: string;\n    },\n    options?: GenerateContractTypesOptions,\n  ): string;\n}\n\n// ============================================================================\n// Parameterized Codec Descriptor Types\n// ============================================================================\n//\n// Types for codecs that support type parameters (e.g., Vector<1536>, Decimal<2>).\n// These enable precise TypeScript types for parameterized columns without\n// coupling the SQL family emitter to specific adapter codec IDs.\n//\n// ============================================================================\n\n/**\n * Declarative type renderer that produces a TypeScript type expression.\n *\n * Renderers can be:\n * - A template string with `{{paramName}}` placeholders (e.g., `Vector<{{length}}>`)\n * - A function that receives typeParams and context and returns a type expression\n *\n * **Prefer template strings** for most cases:\n * - Templates are JSON-serializable (safe for pack-ref metadata)\n * - Templates can be statically analyzed by tooling\n *\n * Function renderers are allowed but have tradeoffs:\n * - Require runtime execution during emission (the emitter runs code)\n * - Not JSON-serializable (can't be stored in contract.json)\n * - The emitted artifacts (contract.json, contract.d.ts) still contain no\n *   executable code - this constraint applies to outputs, not the emission process\n */\nexport type TypeRenderer =\n  | string\n  | ((params: Record<string, unknown>, ctx: RenderTypeContext) => string);\n\n/**\n * Descriptor for a codec that supports type parameters.\n *\n * Parameterized codecs allow columns to carry additional metadata (typeParams)\n * that affects the generated TypeScript types. For example:\n * - A vector codec can use `{ length: 1536 }` to generate `Vector<1536>`\n * - A decimal codec can use `{ precision: 10, scale: 2 }` to generate `Decimal<10, 2>`\n *\n * The SQL family emitter uses these descriptors to generate precise types\n * without hard-coding knowledge of specific codec IDs.\n *\n * @example\n * ```typescript\n * const vectorCodecDescriptor: ParameterizedCodecDescriptor = {\n *   codecId: 'pg/vector@1',\n *   outputTypeRenderer: 'Vector<{{length}}>',\n *   // Optional: paramsSchema for runtime validation\n * };\n * ```\n */\nexport interface ParameterizedCodecDescriptor {\n  /** The codec ID this descriptor applies to (e.g., 'pg/vector@1') */\n  readonly codecId: string;\n\n  /**\n   * Renderer for the output (read) type.\n   * Can be a template string or function.\n   *\n   * This is the primary renderer used by SQL emission to generate\n   * model field types in contract.d.ts.\n   */\n  readonly outputTypeRenderer: TypeRenderer;\n\n  /**\n   * Optional renderer for the input (write) type.\n   * If not provided, outputTypeRenderer is used for both.\n   *\n   * **Reserved for future use**: Currently, SQL emission only uses\n   * outputTypeRenderer. This field is defined for future support of\n   * asymmetric codecs where input and output types differ (e.g., a\n   * codec that accepts `string | number` but always returns `number`).\n   */\n  readonly inputTypeRenderer?: TypeRenderer;\n\n  /**\n   * Optional import spec for types used by this codec's renderers.\n   * The emitter will add this import to contract.d.ts.\n   */\n  readonly typesImport?: TypesImportSpec;\n}\n"],"mappings":";AA0CA,SAAgB,SAAiC,OAA8B;AAC7E,QAAO;;AAUT,SAAgB,YAAoC,OAA8B;AAChF,QAAO;;AA0CT,SAAgB,eAAe,OAAuC;AACpE,QACE,OAAO,UAAU,YACjB,UAAU,QACT,MAA8B,UAAU,YACzC,OAAQ,MAA8B,UAAU;;AAIpD,SAAgB,mBAAmB,MAAc,OAAyB;AACxE,KAAI,OAAO,UAAU,SACnB,QAAO;EAAE,OAAO;EAAU,OAAO,MAAM,UAAU;EAAE;AAErD,QAAO;;AAKT,SAAgB,YAAY,OAAoC;AAC9D,QACE,OAAO,UAAU,YACjB,UAAU,QACT,MAA8B,UAAU,SACzC,WAAY;;;;;AA4JhB,SAAgB,mBAAmB,UAAiD;AAClF,QACE,OAAO,aAAa,YACpB,aAAa,QACb,kBAAkB,YAClB,SAAS,iBAAiB"}