@prisma-next/adapter-postgres 0.16.0-dev.22 → 0.16.0-dev.23

package/dist/{adapter-DcBWxseT.mjs → adapter-CuTsfsz3.mjs}

@@ -1,4 +1,4 @@
-import { n as renderLoweredSql, r as createPostgresBuiltinCodecLookup, t as PostgresControlAdapter } from "./control-adapter-hSsjUXtc.mjs";
+import { i as adapterError, n as renderLoweredSql, r as createPostgresBuiltinCodecLookup, t as PostgresControlAdapter } from "./control-adapter-Xog0HsuP.mjs";
 import { APP_SPACE_ID } from "@prisma-next/framework-components/control";
 import { isDdlNode } from "@prisma-next/sql-relational-core/ast";
 //#region src/core/adapter.ts
@@ -42,7 +42,7 @@ var PostgresAdapterImpl = class {
 		});
 	}
 	lower(ast, context) {
-		if (isDdlNode(ast)) throw new Error("lower() does not lower DDL on the runtime adapter — DDL lowering is a control-plane concern handled by the control adapter.");
+		if (isDdlNode(ast)) throw adapterError("RUNTIME.DDL_UNSUPPORTED", "lower() does not lower DDL on the runtime adapter — DDL lowering is a control-plane concern handled by the control adapter.", { meta: { surface: "runtime-adapter" } });
 		return renderLoweredSql(ast, context.contract, this.codecLookup);
 	}
 };
@@ -55,7 +55,7 @@ const postgresRawCodecInferer = { inferCodec(value) {
 		case "boolean": return "pg/bool";
 		case "object": if (value instanceof Uint8Array) return "pg/bytea";
 	}
-	throw new Error("unsupported JS value type for raw-SQL interpolation: wrap this value in `param(...)` with an explicit codec");
+	throw adapterError("RUNTIME.RAW_SQL_UNSUPPORTED_INTERPOLATION", "unsupported JS value type for raw-SQL interpolation: wrap this value in `param(...)` with an explicit codec", { meta: { valueType: typeof value } });
 } };
 function createPostgresAdapter(options) {
 	return Object.freeze(new PostgresAdapterImpl(options));
@@ -63,4 +63,4 @@ function createPostgresAdapter(options) {
 //#endregion
 export { postgresRawCodecInferer as n, createPostgresAdapter as t };
 
-//# sourceMappingURL=adapter-DcBWxseT.mjs.map
+//# sourceMappingURL=adapter-CuTsfsz3.mjs.map

package/dist/adapter-CuTsfsz3.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-CuTsfsz3.mjs","names":[],"sources":["../src/core/adapter.ts"],"sourcesContent":["import type { CodecRegistry } from '@prisma-next/framework-components/codec';\nimport { APP_SPACE_ID } from '@prisma-next/framework-components/control';\nimport type {\n  Adapter,\n  AdapterProfile,\n  AnyQueryAst,\n  LowererContext,\n  RawSqlLiteral,\n  SqlQueryable,\n} from '@prisma-next/sql-relational-core/ast';\nimport { isDdlNode } from '@prisma-next/sql-relational-core/ast';\nimport type { RawCodecInferer } from '@prisma-next/sql-relational-core/expression';\nimport type { PostgresDdlNode } from '@prisma-next/target-postgres/ddl';\nimport { adapterError } from './adapter-errors';\nimport { createPostgresBuiltinCodecLookup } from './codec-lookup';\nimport { PostgresControlAdapter } from './control-adapter';\nimport { renderLoweredSql } from './sql-renderer';\nimport type { PostgresAdapterOptions, PostgresContract, PostgresLoweredStatement } from './types';\n\nconst defaultCapabilities = Object.freeze({\n  postgres: {\n    orderBy: true,\n    limit: true,\n    lateral: true,\n    jsonAgg: true,\n    returning: true,\n    distinctOn: true,\n  },\n  sql: {\n    enums: true,\n    returning: true,\n    defaultInInsert: true,\n    lateral: true,\n    scalarList: true,\n  },\n});\n\nclass PostgresAdapterImpl\n  implements Adapter<AnyQueryAst, PostgresContract, PostgresLoweredStatement>\n{\n  // These fields make the adapter instance structurally compatible with RuntimeAdapterInstance<'sql', 'postgres'> without introducing a runtime-plane dependency.\n  readonly familyId = 'sql' as const;\n  readonly targetId = 'postgres' as const;\n\n  readonly profile: AdapterProfile<'postgres'>;\n  private readonly codecLookup: CodecRegistry;\n\n  constructor(options?: PostgresAdapterOptions) {\n    this.codecLookup = options?.codecLookup ?? createPostgresBuiltinCodecLookup();\n    const controlAdapter = new PostgresControlAdapter(this.codecLookup);\n    this.profile = Object.freeze({\n      id: options?.profileId ?? 'postgres/default@1',\n      target: 'postgres',\n      capabilities: defaultCapabilities,\n      readMarker: (queryable: SqlQueryable) =>\n        controlAdapter.readMarkerDiscriminated(\n          {\n            familyId: 'sql',\n            targetId: 'postgres',\n            query: async <Row = Record<string, unknown>>(\n              sql: string,\n              params?: readonly unknown[],\n            ) => {\n              const result = await queryable.query<Row>(sql, params);\n              return { rows: [...result.rows] };\n            },\n            close: async () => {},\n          },\n          APP_SPACE_ID,\n        ),\n    });\n  }\n\n  lower(\n    ast: AnyQueryAst | PostgresDdlNode,\n    context: LowererContext<PostgresContract>,\n  ): PostgresLoweredStatement {\n    if (isDdlNode(ast)) {\n      throw adapterError(\n        'RUNTIME.DDL_UNSUPPORTED',\n        'lower() does not lower DDL on the runtime adapter — DDL lowering is a control-plane concern handled by the control adapter.',\n        { meta: { surface: 'runtime-adapter' } },\n      );\n    }\n    return renderLoweredSql(ast, context.contract, this.codecLookup);\n  }\n}\n\n/** Codec-id lookup for bare-literal interpolations used by `fns.raw` on a postgres client. Contributed as the descriptor's static `rawCodecInferer` slot. */\nexport const postgresRawCodecInferer: RawCodecInferer = {\n  inferCodec(value: RawSqlLiteral): string {\n    switch (typeof value) {\n      case 'number':\n        return Number.isSafeInteger(value) && value % 1 === 0 ? 'pg/int4' : 'pg/float8';\n      case 'bigint':\n        return 'pg/int8';\n      case 'string':\n        return 'pg/text';\n      case 'boolean':\n        return 'pg/bool';\n      case 'object':\n        if (value instanceof Uint8Array) return 'pg/bytea';\n    }\n    throw adapterError(\n      'RUNTIME.RAW_SQL_UNSUPPORTED_INTERPOLATION',\n      'unsupported JS value type for raw-SQL interpolation: wrap this value in `param(...)` with an explicit codec',\n      { meta: { valueType: typeof value } },\n    );\n  },\n};\n\nexport function createPostgresAdapter(options?: PostgresAdapterOptions) {\n  return Object.freeze(new PostgresAdapterImpl(options));\n}\n"],"mappings":";;;;AAmBA,MAAM,sBAAsB,OAAO,OAAO;CACxC,UAAU;EACR,SAAS;EACT,OAAO;EACP,SAAS;EACT,SAAS;EACT,WAAW;EACX,YAAY;CACd;CACA,KAAK;EACH,OAAO;EACP,WAAW;EACX,iBAAiB;EACjB,SAAS;EACT,YAAY;CACd;AACF,CAAC;AAED,IAAM,sBAAN,MAEA;CAEE,WAAoB;CACpB,WAAoB;CAEpB;CACA;CAEA,YAAY,SAAkC;EAC5C,KAAK,cAAc,SAAS,eAAe,iCAAiC;EAC5E,MAAM,iBAAiB,IAAI,uBAAuB,KAAK,WAAW;EAClE,KAAK,UAAU,OAAO,OAAO;GAC3B,IAAI,SAAS,aAAa;GAC1B,QAAQ;GACR,cAAc;GACd,aAAa,cACX,eAAe,wBACb;IACE,UAAU;IACV,UAAU;IACV,OAAO,OACL,KACA,WACG;KAEH,OAAO,EAAE,MAAM,CAAC,IAAG,MADE,UAAU,MAAW,KAAK,MAAM,EAAA,CAC3B,IAAI,EAAE;IAClC;IACA,OAAO,YAAY,CAAC;GACtB,GACA,YACF;EACJ,CAAC;CACH;CAEA,MACE,KACA,SAC0B;EAC1B,IAAI,UAAU,GAAG,GACf,MAAM,aACJ,2BACA,+HACA,EAAE,MAAM,EAAE,SAAS,kBAAkB,EAAE,CACzC;EAEF,OAAO,iBAAiB,KAAK,QAAQ,UAAU,KAAK,WAAW;CACjE;AACF;;AAGA,MAAa,0BAA2C,EACtD,WAAW,OAA8B;CACvC,QAAQ,OAAO,OAAf;EACE,KAAK,UACH,OAAO,OAAO,cAAc,KAAK,KAAK,QAAQ,MAAM,IAAI,YAAY;EACtE,KAAK,UACH,OAAO;EACT,KAAK,UACH,OAAO;EACT,KAAK,WACH,OAAO;EACT,KAAK,UACH,IAAI,iBAAiB,YAAY,OAAO;CAC5C;CACA,MAAM,aACJ,6CACA,+GACA,EAAE,MAAM,EAAE,WAAW,OAAO,MAAM,EAAE,CACtC;AACF,EACF;AAEA,SAAgB,sBAAsB,SAAkC;CACtE,OAAO,OAAO,OAAO,IAAI,oBAAoB,OAAO,CAAC;AACvD"}

package/dist/adapter.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.mts","names":[],"sources":["../src/core/adapter.ts"],"mappings":";;;;;cAoCM,+BACO,QAAQ,aAAa,kBAAkB;WAGzC;WACA;WAEA,SAAS;mBACD;cAEL,UAAU;EA0BtB,MACE,KAAK,cAAc,iBACnB,SAAS,eAAe,oBACvB;;;cAWQ,yBAAyB;iBAoBtB,sBAAsB,UAAU,yBAAsB,SAAA"}
+{"version":3,"file":"adapter.d.mts","names":[],"sources":["../src/core/adapter.ts"],"mappings":";;;;;cAqCM,+BACO,QAAQ,aAAa,kBAAkB;WAGzC;WACA;WAEA,SAAS;mBACD;cAEL,UAAU;EA0BtB,MACE,KAAK,cAAc,iBACnB,SAAS,eAAe,oBACvB;;;cAaQ,yBAAyB;iBAsBtB,sBAAsB,UAAU,yBAAsB,SAAA"}

package/dist/adapter.mjs

@@ -1,2 +1,2 @@
-import { n as postgresRawCodecInferer, t as createPostgresAdapter } from "./adapter-DcBWxseT.mjs";
+import { n as postgresRawCodecInferer, t as createPostgresAdapter } from "./adapter-CuTsfsz3.mjs";
 export { createPostgresAdapter, postgresRawCodecInferer };

package/dist/{control-adapter-hSsjUXtc.mjs → control-adapter-Xog0HsuP.mjs}

@@ -1,5 +1,6 @@
 import { APP_SPACE_ID, extractCodecLookup } from "@prisma-next/framework-components/control";
 import { LiteralExpr, RawExpr, collectOrderedParamRefs, isDdlNode } from "@prisma-next/sql-relational-core/ast";
+import { structuredError } from "@prisma-next/utils/structured-error";
 import { isPgEnumParams, postgresCodecRegistry } from "@prisma-next/target-postgres/codecs";
 import { parseMarkerRowSafely, rethrowMarkerReadError, withMarkerReadErrorHandling } from "@prisma-next/errors/execution";
 import { parseContractMarkerRow } from "@prisma-next/family-sql/verify";
@@ -15,8 +16,14 @@ import { PostgresDatabaseSchemaNode, PostgresNamespaceSchemaNode, PostgresNative
 import { blindCast } from "@prisma-next/utils/casts";
 import { ifDefined } from "@prisma-next/utils/defined";
 import { createAstCodecRegistry, deriveParamMetadata, encodeParamsWithMetadata } from "@prisma-next/sql-runtime";
+import { InternalError, assertNever } from "@prisma-next/utils/internal-error";
 import { PG_TIMESTAMPTZ_CODEC_ID } from "@prisma-next/target-postgres/codec-ids";
 import { runtimeError } from "@prisma-next/framework-components/runtime";
+//#region src/core/adapter-errors.ts
+function adapterError(code, message, options) {
+	return structuredError(code, message, options);
+}
+//#endregion
 //#region src/core/codec-lookup.ts
 /**
 * Build a {@link CodecRegistry} populated with the Postgres-builtin codec definitions only.
@@ -43,7 +50,7 @@ const CONTROL_CODECS = createAstCodecRegistry(postgresCodecRegistry);
 async function encodeControlQueryParams(lowered, ast, codecs = CONTROL_CODECS) {
 	return encodeParamsWithMetadata(lowered.params.map((slot) => {
 		if (slot.kind === "literal") return slot.value;
-		throw new Error(`control query lowered to a bind slot '${slot.name}', which is unsupported`);
+		throw new InternalError(`control query lowered to a bind slot '${slot.name}', which is unsupported`);
 	}), deriveParamMetadata(ast), {}, codecs);
 }
 //#endregion
@@ -163,7 +170,7 @@ const POSTGRES_INFERRABLE_NATIVE_TYPES = /* @__PURE__ */ new Set([
 function renderTypedParam(index, codecId, codecLookup, many, typeParams) {
 	if (codecId === void 0) return `$${index}`;
 	const meta = codecLookup.metaFor(codecId, typeParams);
-	if (!(codecLookup.get(codecId) !== void 0 || meta !== void 0 || codecLookup.targetTypesFor(codecId) !== void 0)) throw new Error(`Postgres lowering: ParamRef carries codecId "${codecId}" but the assembled codec lookup has no entry for it. This usually indicates a missing extension pack in the runtime stack — register the pack that contributes this codec (e.g. \`extensions: [pgvectorRuntime]\`), or use the codec directly from \`@prisma-next/target-postgres/codecs\` if it's a builtin.`);
+	if (!(codecLookup.get(codecId) !== void 0 || meta !== void 0 || codecLookup.targetTypesFor(codecId) !== void 0)) throw adapterError("RUNTIME.PARAM_REF_MISSING_CODEC", `Postgres lowering: ParamRef carries codecId "${codecId}" but the assembled codec lookup has no entry for it. This usually indicates a missing extension pack in the runtime stack — register the pack that contributes this codec (e.g. \`extensions: [pgvectorRuntime]\`), or use the codec directly from \`@prisma-next/target-postgres/codecs\` if it's a builtin.`, { meta: { codecId } });
 	const dbRecord = meta?.db;
 	const sqlBlock = isRecord(dbRecord) ? dbRecord["sql"] : void 0;
 	const dialectBlock = isRecord(sqlBlock) ? sqlBlock["postgres"] : void 0;
@@ -225,7 +232,7 @@ function renderLoweredSql(ast, contract, codecLookup) {
 			sql = renderRawSql(node, contract, pim);
 			break;
 		// v8 ignore next 4
-		default: throw new Error(`Unsupported AST node kind: ${unreachableKind(node)}`);
+		default: assertNever(node, `Unsupported AST node kind: ${unreachableKind(node)}`);
 	}
 	return Object.freeze({
 		sql,
@@ -348,9 +355,17 @@ function qualifyTableFromNamespaceCoordinate(table, contract) {
 	if (hasExplicitSchema(table)) return `${quoteIdentifier(table.schema)}.${quoteIdentifier(table.name)}`;
 	if (table.namespaceId === void 0) return quoteIdentifier(table.name);
 	const namespace = contract.storage.namespaces[table.namespaceId];
-	if (namespace === void 0) throw new Error(`Table "${table.name}" references namespace "${table.namespaceId}" which is not present as a Postgres schema on the contract`);
+	if (namespace === void 0) throw adapterError("RUNTIME.NAMESPACE_UNKNOWN", `Table "${table.name}" references namespace "${table.namespaceId}" which is not present as a Postgres schema on the contract`, { meta: {
+		table: table.name,
+		namespaceId: table.namespaceId,
+		reason: "not-present"
+	} });
 	const qualifyTable = namespace.qualifyTable;
-	if (qualifyTable === void 0) throw new Error(`Table "${table.name}" references namespace "${table.namespaceId}" which is not materialised as a Postgres schema on the contract`);
+	if (qualifyTable === void 0) throw adapterError("RUNTIME.NAMESPACE_UNKNOWN", `Table "${table.name}" references namespace "${table.namespaceId}" which is not materialised as a Postgres schema on the contract`, { meta: {
+		table: table.name,
+		namespaceId: table.namespaceId,
+		reason: "not-materialised"
+	} });
 	return qualifyTable.call(namespace, table.name);
 }
 function renderTableSource(source, contract) {
@@ -368,11 +383,11 @@ function renderSource(source, contract, pim) {
 			return `${`${node.fn}(${args})`}${node.ordinality ? " WITH ORDINALITY" : ""}${node.alias === void 0 ? "" : ` AS ${quoteIdentifier(node.alias)}`}${node.columnAliases === void 0 ? "" : `(${node.columnAliases.map((column) => quoteIdentifier(column)).join(", ")})`}`;
 		}
 		// v8 ignore next 4
-		default: throw new Error(`Unsupported source node kind: ${unreachableKind(node)}`);
+		default: assertNever(node, `Unsupported source node kind: ${unreachableKind(node)}`);
 	}
 }
 function assertScalarSubquery(query) {
-	if (query.projection.length !== 1) throw new Error("Subquery expressions must project exactly one column");
+	if (query.projection.length !== 1) throw adapterError("RUNTIME.AST_INVALID", "Subquery expressions must project exactly one column", { meta: { node: "subquery-expr" } });
 }
 function renderSubqueryExpr(expr, contract, pim) {
 	assertScalarSubquery(expr.query);
@@ -538,12 +553,12 @@ function renderExpr(expr, contract, pim) {
 		case "list": return renderListLiteral(node, contract, pim);
 		case "raw-expr": return renderRawExpr(node, contract, pim);
 		// v8 ignore next 4
-		default: throw new Error(`Unsupported expression node kind: ${unreachableKind(node)}`);
+		default: assertNever(node, `Unsupported expression node kind: ${unreachableKind(node)}`);
 	}
 }
 function renderParamRef(ref, pim) {
 	const index = pim.indexMap.get(ref);
-	if (index === void 0) throw new Error("ParamRef not found in index map");
+	if (index === void 0) throw new InternalError("ParamRef not found in index map");
 	if (ref.kind === "prepared-param-ref") return renderTypedParam(index, ref.codec.codecId, pim.codecLookup, ref.codec.many, ref.codec.typeParams);
 	if (ref.codec === void 0) throw runtimeError("RUNTIME.PARAM_REF_MISSING_CODEC", "Postgres renderer: ParamRef reached lowering without a bound CodecRef. Every column-bound ParamRef must carry a codec under the AST-bound codec contract. This usually indicates a builder path that constructed a ParamRef without threading the column codec.", {
 		paramIndex: index,
@@ -571,7 +586,7 @@ function renderOperation(expr, contract, pim) {
 	return expr.lowering.template.replace(/\{\{self\}\}|\{\{arg(\d+)\}\}/g, (token, argIndex) => {
 		if (token === "{{self}}") return self;
 		const arg = args[Number(argIndex)];
-		if (arg === void 0) throw new Error(`Operation lowering template for "${expr.method}" referenced missing argument {{arg${argIndex}}}; template has ${args.length} arg(s)`);
+		if (arg === void 0) throw adapterError("CONTRACT.PACK_CONTRIBUTION_INVALID", `Operation lowering template for "${expr.method}" referenced missing argument {{arg${argIndex}}}; template has ${args.length} arg(s)`, { meta: { method: expr.method } });
 		return arg;
 	});
 }
@@ -604,7 +619,10 @@ function getInsertColumnOrder(rows, contract, tableRef) {
 			break;
 		}
 	}
-	if (!table) throw new Error(`INSERT target table not found in contract storage: ${tableName}`);
+	if (!table) throw adapterError("RUNTIME.AST_INVALID", `INSERT target table not found in contract storage: ${tableName}`, { meta: {
+		node: "insert",
+		table: tableName
+	} });
 	return Object.keys(table.columns);
 }
 function renderInsertValue(value, contract, pim) {
@@ -615,13 +633,13 @@ function renderInsertValue(value, contract, pim) {
 		case "column-ref": return renderColumn(value);
 		case "raw-expr": return renderExpr(value, contract, pim);
 		// v8 ignore next 4
-		default: throw new Error(`Unsupported value node in INSERT: ${unreachableKind(value)}`);
+		default: assertNever(value, `Unsupported value node in INSERT: ${unreachableKind(value)}`);
 	}
 }
 function renderInsert(ast, contract, pim) {
 	const table = qualifyTableFromNamespaceCoordinate(ast.table, contract);
 	const rows = ast.rows;
-	if (rows.length === 0) throw new Error("INSERT requires at least one row");
+	if (rows.length === 0) throw adapterError("RUNTIME.AST_INVALID", "INSERT requires at least one row", { meta: { node: "insert" } });
 	const hasExplicitValues = rows.some((row) => Object.keys(row).length > 0);
 	return `${(() => {
 		if (!hasExplicitValues) {
@@ -640,27 +658,27 @@ function renderInsert(ast, contract, pim) {
 		return `INSERT INTO ${table} (${columns.join(", ")}) VALUES ${values}`;
 	})()}${ast.onConflict ? (() => {
 		const conflictColumns = ast.onConflict.columns.map((col) => quoteIdentifier(col.column));
-		if (conflictColumns.length === 0) throw new Error("INSERT onConflict requires at least one conflict column");
+		if (conflictColumns.length === 0) throw adapterError("RUNTIME.AST_INVALID", "INSERT onConflict requires at least one conflict column", { meta: { node: "insert-on-conflict" } });
 		const action = ast.onConflict.action;
 		switch (action.kind) {
 			case "do-nothing": return ` ON CONFLICT (${conflictColumns.join(", ")}) DO NOTHING`;
 			case "do-update-set": {
 				const updateEntries = Object.entries(action.set);
-				if (updateEntries.length === 0) throw new Error("INSERT onConflict do-update-set requires at least one assignment");
+				if (updateEntries.length === 0) throw adapterError("RUNTIME.AST_INVALID", "INSERT onConflict do-update-set requires at least one assignment", { meta: { node: "insert-on-conflict" } });
 				const updates = updateEntries.map(([colName, value]) => {
 					return `${quoteIdentifier(colName)} = ${renderExpr(value, contract, pim)}`;
 				});
 				return ` ON CONFLICT (${conflictColumns.join(", ")}) DO UPDATE SET ${updates.join(", ")}`;
 			}
 			// v8 ignore next 4
-			default: throw new Error(`Unsupported onConflict action: ${unreachableKind(action)}`);
+			default: assertNever(action, `Unsupported onConflict action: ${unreachableKind(action)}`);
 		}
 	})() : ""}${ast.returning?.length ? ` RETURNING ${renderReturning(ast.returning, contract, pim)}` : ""}`;
 }
 function renderUpdate(ast, contract, pim) {
 	const table = qualifyTableFromNamespaceCoordinate(ast.table, contract);
 	const setEntries = Object.entries(ast.set);
-	if (setEntries.length === 0) throw new Error("UPDATE requires at least one SET assignment");
+	if (setEntries.length === 0) throw adapterError("RUNTIME.AST_INVALID", "UPDATE requires at least one SET assignment", { meta: { node: "update" } });
 	const setClauses = setEntries.map(([col, val]) => {
 		return `${quoteIdentifier(col)} = ${renderExpr(val, contract, pim)}`;
 	});
@@ -726,7 +744,7 @@ var PostgresControlAdapter = class {
 	* without instantiating the runtime adapter.
 	*/
 	lower(ast, context) {
-		if (isDdlNode(ast)) throw new Error("lower() cannot lower DDL: DDL default literals require inline codec encoding, which is async. Use lowerToExecuteRequest().");
+		if (isDdlNode(ast)) throw adapterError("RUNTIME.DDL_UNSUPPORTED", "lower() cannot lower DDL: DDL default literals require inline codec encoding, which is async. Use lowerToExecuteRequest().", { meta: { surface: "control-adapter" } });
 		return renderLoweredSql(ast, blindCast(context.contract), this.codecRegistry);
 	}
 	/**
@@ -1492,7 +1510,7 @@ const PG_REFERENTIAL_ACTION_MAP = {
 */
 function mapReferentialAction(rule) {
 	const mapped = PG_REFERENTIAL_ACTION_MAP[rule];
-	if (mapped === void 0) throw new Error(`Unknown PostgreSQL referential action rule: "${rule}". Expected one of: NO ACTION, RESTRICT, CASCADE, SET NULL, SET DEFAULT.`);
+	if (mapped === void 0) throw adapterError("CONTRACT.INTROSPECTION_UNSUPPORTED", `Unknown PostgreSQL referential action rule: "${rule}". Expected one of: NO ACTION, RESTRICT, CASCADE, SET NULL, SET DEFAULT.`, { meta: { rule } });
 	if (mapped === "noAction") return void 0;
 	return mapped;
 }
@@ -1559,7 +1577,10 @@ function parsePgReloptions(reloptions, indexName) {
 	const result = {};
 	for (const entry of reloptions) {
 		const eq = entry.indexOf("=");
-		if (eq === -1) throw new Error(`Postgres introspection: malformed reloption entry "${entry}" on index "${indexName}" (expected "key=value")`);
+		if (eq === -1) throw adapterError("CONTRACT.INTROSPECTION_UNSUPPORTED", `Postgres introspection: malformed reloption entry "${entry}" on index "${indexName}" (expected "key=value")`, { meta: {
+			entry,
+			indexName
+		} });
 		const key = entry.slice(0, eq);
 		result[key] = entry.slice(eq + 1);
 	}
@@ -1664,12 +1685,12 @@ function pgInlineLiteral(wire, nativeType) {
 	if (wire === null) return "NULL";
 	if (typeof wire === "boolean") return wire ? "true" : "false";
 	if (typeof wire === "number") {
-		if (!Number.isFinite(wire)) throw new Error(`pgRenderDdlExecuteRequest: non-finite number wire value ${String(wire)} cannot be emitted as a DEFAULT literal for native type "${nativeType}"`);
+		if (!Number.isFinite(wire)) throw adapterError("CONTRACT.DEFAULT_INVALID", `pgRenderDdlExecuteRequest: non-finite number wire value ${String(wire)} cannot be emitted as a DEFAULT literal for native type "${nativeType}"`, { meta: { nativeType } });
 		return String(wire);
 	}
 	if (typeof wire === "bigint") return String(wire);
 	if (wire instanceof Date) {
-		if (Number.isNaN(wire.getTime())) throw new Error(`pgRenderDdlExecuteRequest: invalid Date value cannot be emitted as a DEFAULT literal for native type "${nativeType}"`);
+		if (Number.isNaN(wire.getTime())) throw adapterError("CONTRACT.DEFAULT_INVALID", `pgRenderDdlExecuteRequest: invalid Date value cannot be emitted as a DEFAULT literal for native type "${nativeType}"`, { meta: { nativeType } });
 		const quoted = `'${escapeLiteral(wire.toISOString())}'`;
 		return pgIsTextLikeNativeType(nativeType) ? quoted : `${quoted}::${nativeType}`;
 	}
@@ -1680,7 +1701,10 @@ function pgInlineLiteral(wire, nativeType) {
 	if (wire instanceof Uint8Array) return `'\\x${Array.from(wire).map((b) => b.toString(16).padStart(2, "0")).join("")}'::${nativeType}`;
 	if (Array.isArray(wire) && nativeType.endsWith("[]")) return pgRenderArrayLiteral(wire);
 	if (typeof wire === "object") return `${`'${escapeLiteral(JSON.stringify(wire))}'`}::${nativeType}`;
-	throw new Error(`pgRenderDdlExecuteRequest: unexpected wire type "${typeof wire}" for native type "${nativeType}"`);
+	throw adapterError("CONTRACT.PACK_CONTRIBUTION_INVALID", `pgRenderDdlExecuteRequest: unexpected wire type "${typeof wire}" for native type "${nativeType}"`, { meta: {
+		wireType: typeof wire,
+		nativeType
+	} });
 }
 async function pgRenderDdlColumnDefault(def, nativeType, codecLookup, codecRef) {
 	if (def.kind === "function") {
@@ -1818,6 +1842,6 @@ async function pgRenderDdlExecuteRequest(ast, codecLookup) {
 	});
 }
 //#endregion
-export { renderLoweredSql as n, createPostgresBuiltinCodecLookup as r, PostgresControlAdapter as t };
+export { adapterError as i, renderLoweredSql as n, createPostgresBuiltinCodecLookup as r, PostgresControlAdapter as t };
 
-//# sourceMappingURL=control-adapter-hSsjUXtc.mjs.map
+//# sourceMappingURL=control-adapter-Xog0HsuP.mjs.map