@prisma-next/adapter-postgres 0.5.0-dev.6 → 0.5.0-dev.60

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (45) hide show
  1. package/README.md +21 -15
  2. package/dist/{adapter-hNElNHo4.mjs → adapter-_L4wXA4O.mjs} +9 -5
  3. package/dist/adapter-_L4wXA4O.mjs.map +1 -0
  4. package/dist/adapter.d.mts +2 -1
  5. package/dist/adapter.d.mts.map +1 -1
  6. package/dist/adapter.mjs +1 -1
  7. package/dist/column-types.d.mts +27 -23
  8. package/dist/column-types.d.mts.map +1 -1
  9. package/dist/column-types.mjs +27 -58
  10. package/dist/column-types.mjs.map +1 -1
  11. package/dist/control.d.mts +76 -3
  12. package/dist/control.d.mts.map +1 -1
  13. package/dist/control.mjs +47 -8
  14. package/dist/control.mjs.map +1 -1
  15. package/dist/{descriptor-meta-RTDzyrae.mjs → descriptor-meta-CpEka_0t.mjs} +30 -22
  16. package/dist/descriptor-meta-CpEka_0t.mjs.map +1 -0
  17. package/dist/operation-types.d.mts +11 -10
  18. package/dist/operation-types.d.mts.map +1 -1
  19. package/dist/runtime.d.mts +3 -11
  20. package/dist/runtime.d.mts.map +1 -1
  21. package/dist/runtime.mjs +27 -68
  22. package/dist/runtime.mjs.map +1 -1
  23. package/dist/{sql-renderer-pEaSP82_.mjs → sql-renderer-DLwYpnxz.mjs} +97 -36
  24. package/dist/sql-renderer-DLwYpnxz.mjs.map +1 -0
  25. package/dist/{types-CfRPdAk8.d.mts → types-tLtmYqCO.d.mts} +12 -1
  26. package/dist/types-tLtmYqCO.d.mts.map +1 -0
  27. package/dist/types.d.mts +1 -1
  28. package/package.json +21 -21
  29. package/src/core/adapter.ts +10 -2
  30. package/src/core/codec-lookup.ts +24 -0
  31. package/src/core/control-adapter.ts +68 -1
  32. package/src/core/control-mutation-defaults.ts +24 -18
  33. package/src/core/descriptor-meta.ts +32 -11
  34. package/src/core/sql-renderer.ts +118 -50
  35. package/src/core/types.ts +11 -0
  36. package/src/exports/column-types.ts +27 -58
  37. package/src/exports/control.ts +3 -2
  38. package/src/exports/runtime.ts +40 -48
  39. package/src/types/operation-types.ts +19 -9
  40. package/dist/adapter-hNElNHo4.mjs.map +0 -1
  41. package/dist/descriptor-meta-RTDzyrae.mjs.map +0 -1
  42. package/dist/sql-renderer-pEaSP82_.mjs.map +0 -1
  43. package/dist/types-CfRPdAk8.d.mts.map +0 -1
  44. package/src/core/json-schema-validator.ts +0 -54
  45. package/src/core/standard-schema.ts +0 -71
@@ -1,4 +1,7 @@
1
+ import type { ContractMarkerRecord } from '@prisma-next/contract/types';
1
2
  import type { SqlControlAdapter } from '@prisma-next/family-sql/control-adapter';
3
+ import { parseContractMarkerRow } from '@prisma-next/family-sql/verify';
4
+ import type { CodecLookup } from '@prisma-next/framework-components/codec';
2
5
  import type { ControlDriverInstance } from '@prisma-next/framework-components/control';
3
6
  import type {
4
7
  AnyQueryAst,
@@ -19,6 +22,7 @@ import type {
19
22
  import { parsePostgresDefault } from '@prisma-next/target-postgres/default-normalizer';
20
23
  import { normalizeSchemaNativeType } from '@prisma-next/target-postgres/native-type-normalizer';
21
24
  import { ifDefined } from '@prisma-next/utils/defined';
25
+ import { createPostgresBuiltinCodecLookup } from './codec-lookup';
22
26
  import { pgEnumControlHooks } from './enum-control-hooks';
23
27
  import { renderLoweredSql } from './sql-renderer';
24
28
  import type { PostgresContract } from './types';
@@ -31,6 +35,19 @@ export class PostgresControlAdapter implements SqlControlAdapter<'postgres'> {
31
35
  readonly familyId = 'sql' as const;
32
36
  readonly targetId = 'postgres' as const;
33
37
 
38
+ private readonly codecLookup: CodecLookup;
39
+
40
+ /**
41
+ * @param codecLookup - Codec lookup used by the SQL renderer to resolve
42
+ * per-codec metadata at lower-time. Defaults to a Postgres-builtins-only
43
+ * lookup when omitted. Stack-aware callers
44
+ * (`SqlControlAdapterDescriptor.create(stack)`) supply
45
+ * `stack.codecLookup` so extension codecs are visible to the renderer.
46
+ */
47
+ constructor(codecLookup?: CodecLookup) {
48
+ this.codecLookup = codecLookup ?? createPostgresBuiltinCodecLookup();
49
+ }
50
+
34
51
  /**
35
52
  * Target-specific normalizer for raw Postgres default expressions.
36
53
  * Used by schema verification to normalize raw defaults before comparison.
@@ -53,7 +70,57 @@ export class PostgresControlAdapter implements SqlControlAdapter<'postgres'> {
53
70
  * without instantiating the runtime adapter.
54
71
  */
55
72
  lower(ast: AnyQueryAst, context: LowererContext<unknown>): LoweredStatement {
56
- return renderLoweredSql(ast, context.contract as PostgresContract);
73
+ return renderLoweredSql(ast, context.contract as PostgresContract, this.codecLookup);
74
+ }
75
+
76
+ /**
77
+ * Reads the contract marker from `prisma_contract.marker`. Probes
78
+ * `information_schema.tables` first so a fresh database (where the
79
+ * `prisma_contract` schema doesn't yet exist) returns `null` instead of a
80
+ * "relation does not exist" error — some Postgres wire-protocol clients
81
+ * (e.g. PGlite's TCP proxy) don't fully recover from extended-protocol
82
+ * parse errors, so we probe before reading.
83
+ */
84
+ async readMarker(
85
+ driver: ControlDriverInstance<'sql', 'postgres'>,
86
+ ): Promise<ContractMarkerRecord | null> {
87
+ const exists = await driver.query(
88
+ `select 1
89
+ from information_schema.tables
90
+ where table_schema = $1 and table_name = $2`,
91
+ ['prisma_contract', 'marker'],
92
+ );
93
+ if (exists.rows.length === 0) {
94
+ return null;
95
+ }
96
+
97
+ const result = await driver.query<{
98
+ core_hash: string;
99
+ profile_hash: string;
100
+ contract_json: unknown | null;
101
+ canonical_version: number | null;
102
+ updated_at: Date | string;
103
+ app_tag: string | null;
104
+ meta: unknown | null;
105
+ invariants: readonly string[];
106
+ }>(
107
+ `select
108
+ core_hash,
109
+ profile_hash,
110
+ contract_json,
111
+ canonical_version,
112
+ updated_at,
113
+ app_tag,
114
+ meta,
115
+ invariants
116
+ from prisma_contract.marker
117
+ where id = $1`,
118
+ [1],
119
+ );
120
+
121
+ const row = result.rows[0];
122
+ if (!row) return null;
123
+ return parseContractMarkerRow(row);
57
124
  }
58
125
 
59
126
  /**
@@ -1,4 +1,5 @@
1
1
  import type { ExecutionMutationDefaultValue } from '@prisma-next/contract/types';
2
+ import { timestampNowControlDescriptor } from '@prisma-next/family-sql/control';
2
3
  import type {
3
4
  ControlMutationDefaultEntry,
4
5
  DefaultFunctionLoweringContext,
@@ -301,25 +302,30 @@ export function createPostgresDefaultFunctionRegistry(): ReadonlyMap<
301
302
  }
302
303
 
303
304
  export function createPostgresMutationDefaultGeneratorDescriptors(): readonly MutationDefaultGeneratorDescriptor[] {
304
- return builtinGeneratorRegistryMetadata.map(({ id, applicableCodecIds }) => ({
305
- id,
306
- applicableCodecIds,
307
- resolveGeneratedColumnDescriptor: ({ generated }) => {
308
- if (generated.kind !== 'generator' || generated.id !== id) {
309
- return undefined;
310
- }
311
- const descriptor = resolveBuiltinGeneratedColumnDescriptor({
305
+ return [
306
+ ...builtinGeneratorRegistryMetadata.map(
307
+ ({ id, applicableCodecIds }): MutationDefaultGeneratorDescriptor => ({
312
308
  id,
313
- ...(generated.params ? { params: generated.params } : {}),
314
- });
315
- return {
316
- codecId: descriptor.type.codecId,
317
- nativeType: descriptor.type.nativeType,
318
- ...(descriptor.type.typeRef ? { typeRef: descriptor.type.typeRef } : {}),
319
- ...(descriptor.typeParams ? { typeParams: descriptor.typeParams } : {}),
320
- };
321
- },
322
- }));
309
+ applicableCodecIds,
310
+ resolveGeneratedColumnDescriptor: ({ generated }) => {
311
+ if (generated.kind !== 'generator' || generated.id !== id) {
312
+ return undefined;
313
+ }
314
+ const descriptor = resolveBuiltinGeneratedColumnDescriptor({
315
+ id,
316
+ ...(generated.params ? { params: generated.params } : {}),
317
+ });
318
+ return {
319
+ codecId: descriptor.type.codecId,
320
+ nativeType: descriptor.type.nativeType,
321
+ ...(descriptor.type.typeRef ? { typeRef: descriptor.type.typeRef } : {}),
322
+ ...(descriptor.typeParams ? { typeParams: descriptor.typeParams } : {}),
323
+ };
324
+ },
325
+ }),
326
+ ),
327
+ timestampNowControlDescriptor(),
328
+ ];
323
329
  }
324
330
 
325
331
  export function createPostgresScalarTypeDescriptors(): ReadonlyMap<string, string> {
@@ -1,8 +1,16 @@
1
1
  import type { CodecControlHooks, ExpandNativeTypeInput } from '@prisma-next/family-sql/control';
2
2
  import type { SqlOperationDescriptor } from '@prisma-next/sql-operations';
3
+ import {
4
+ buildOperation,
5
+ type CodecExpression,
6
+ type Expression,
7
+ type TraitExpression,
8
+ toExpr,
9
+ } from '@prisma-next/sql-relational-core/expression';
3
10
  import {
4
11
  PG_BIT_CODEC_ID,
5
12
  PG_BOOL_CODEC_ID,
13
+ PG_BYTEA_CODEC_ID,
6
14
  PG_CHAR_CODEC_ID,
7
15
  PG_ENUM_CODEC_ID,
8
16
  PG_FLOAT_CODEC_ID,
@@ -128,17 +136,28 @@ const identityHooks: CodecControlHooks = { expandNativeType: ({ nativeType }) =>
128
136
  // Descriptor metadata
129
137
  // ============================================================================
130
138
 
131
- export const postgresQueryOperations: readonly SqlOperationDescriptor[] = [
132
- {
133
- method: 'ilike',
134
- args: [
135
- { traits: ['textual'], nullable: false },
136
- { codecId: PG_TEXT_CODEC_ID, nullable: false },
137
- ],
138
- returns: { codecId: PG_BOOL_CODEC_ID, nullable: false },
139
- lowering: { targetFamily: 'sql', strategy: 'infix', template: '{{self}} ILIKE {{arg0}}' },
140
- },
141
- ];
139
+ type CodecTypesBase = Record<string, { readonly input: unknown; readonly output: unknown }>;
140
+
141
+ export function postgresQueryOperations<
142
+ CT extends CodecTypesBase,
143
+ >(): readonly SqlOperationDescriptor[] {
144
+ return [
145
+ {
146
+ method: 'ilike',
147
+ self: { traits: ['textual'] },
148
+ impl: (
149
+ self: TraitExpression<readonly ['textual'], false, CT>,
150
+ pattern: CodecExpression<'pg/text@1', false, CT>,
151
+ ): Expression<{ codecId: 'pg/bool@1'; nullable: false }> =>
152
+ buildOperation({
153
+ method: 'ilike',
154
+ args: [toExpr(self), toExpr(pattern, PG_TEXT_CODEC_ID)],
155
+ returns: { codecId: PG_BOOL_CODEC_ID, nullable: false },
156
+ lowering: { targetFamily: 'sql', strategy: 'infix', template: '{{self}} ILIKE {{arg0}}' },
157
+ }),
158
+ },
159
+ ];
160
+ }
142
161
 
143
162
  export const postgresAdapterDescriptorMeta = {
144
163
  kind: 'adapter',
@@ -202,6 +221,7 @@ export const postgresAdapterDescriptorMeta = {
202
221
  [PG_ENUM_CODEC_ID]: pgEnumControlHooks,
203
222
  [PG_JSON_CODEC_ID]: identityHooks,
204
223
  [PG_JSONB_CODEC_ID]: identityHooks,
224
+ [PG_BYTEA_CODEC_ID]: identityHooks,
205
225
  },
206
226
  },
207
227
  storage: [
@@ -267,6 +287,7 @@ export const postgresAdapterDescriptorMeta = {
267
287
  },
268
288
  { typeId: PG_JSON_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'json' },
269
289
  { typeId: PG_JSONB_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'jsonb' },
290
+ { typeId: PG_BYTEA_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'bytea' },
270
291
  ],
271
292
  queryOperationTypes: {
272
293
  import: {
@@ -1,3 +1,4 @@
1
+ import type { CodecLookup } from '@prisma-next/framework-components/codec';
1
2
  import {
2
3
  type AggregateExpr,
3
4
  type AnyExpression,
@@ -5,6 +6,7 @@ import {
5
6
  type AnyQueryAst,
6
7
  type BinaryExpr,
7
8
  type ColumnRef,
9
+ collectOrderedParamRefs,
8
10
  type DeleteAst,
9
11
  type InsertAst,
10
12
  type InsertValue,
@@ -20,50 +22,97 @@ import {
20
22
  type ParamRef,
21
23
  type ProjectionItem,
22
24
  type SelectAst,
25
+ type Codec as SqlCodec,
23
26
  type SubqueryExpr,
24
27
  type UpdateAst,
25
28
  } from '@prisma-next/sql-relational-core/ast';
26
- import { PG_JSON_CODEC_ID, PG_JSONB_CODEC_ID } from '@prisma-next/target-postgres/codec-ids';
27
29
  import { escapeLiteral, quoteIdentifier } from '@prisma-next/target-postgres/sql-utils';
28
30
  import type { PostgresContract } from './types';
29
31
 
30
- // Mirrors `VECTOR_CODEC_ID` in `@prisma-next/extension-pgvector/core/constants`.
31
- // Duplicated here rather than imported because the canonical export is not
32
- // part of the extension's public subpath surface, and `@prisma-next/adapter-postgres`
33
- // does not (and should not) take a runtime dependency on the extension package
34
- // just for one constant. The whole `getCodecParamCast` switch is slated for
35
- // removal under TML-2310 ("Move SQL param-cast metadata onto codec descriptors"),
36
- // at which point this and the JSON/JSONB IDs below also disappear.
37
- const VECTOR_CODEC_ID = 'pg/vector@1' as const;
38
-
39
32
  /**
40
- * Map a codec ID to its `::cast` suffix, if Postgres requires one for
41
- * parameterized values (e.g. `$1::vector`, `$1::jsonb`).
33
+ * Postgres native types whose unknown-OID parameter inference is reliable in
34
+ * arbitrary expression positions. Parameters bound to a codec whose
35
+ * `meta.db.sql.postgres.nativeType` falls in this set are emitted as plain
36
+ * `$N`; everything else (including `json`, `jsonb`, extension types like
37
+ * `vector`, and unknown user types) is emitted as `$N::<nativeType>` so the
38
+ * planner picks an unambiguous overload.
39
+ *
40
+ * `json` / `jsonb` are intentionally excluded despite being Postgres builtins:
41
+ * their operator overloads make context inference unreliable in expression
42
+ * positions (e.g. `$1 -> 'key'` is ambiguous between the two).
42
43
  *
43
- * NOTE: hardcoded codec IDs here are a known wart, tracked separately by
44
- * TML-2310 ("Move SQL param-cast metadata onto codec descriptors").
45
- * Until that lands the cast lives on the renderer rather than the codec.
44
+ * Spellings match the on-disk `meta.db.sql.postgres.nativeType` values in
45
+ * `@prisma-next/target-postgres`'s codec definitions, not the `udt_name`
46
+ * abbreviations that ADR 205 used as illustrative shorthand. The lookup-based
47
+ * cast policy compares against these strings directly.
46
48
  */
47
- function getCodecParamCast(codecId: string | undefined): string | undefined {
48
- if (codecId === VECTOR_CODEC_ID) {
49
- return 'vector';
50
- }
51
- if (codecId === PG_JSON_CODEC_ID) {
52
- return 'json';
53
- }
54
- if (codecId === PG_JSONB_CODEC_ID) {
55
- return 'jsonb';
56
- }
57
- return undefined;
49
+ const POSTGRES_INFERRABLE_NATIVE_TYPES: ReadonlySet<string> = new Set([
50
+ // Numeric
51
+ 'integer',
52
+ 'smallint',
53
+ 'bigint',
54
+ 'real',
55
+ 'double precision',
56
+ 'numeric',
57
+ // Boolean
58
+ 'boolean',
59
+ // Strings
60
+ 'text',
61
+ 'character',
62
+ 'character varying',
63
+ // Temporal
64
+ 'timestamp',
65
+ 'timestamp without time zone',
66
+ 'timestamp with time zone',
67
+ 'time',
68
+ 'timetz',
69
+ 'interval',
70
+ // Bit strings
71
+ 'bit',
72
+ 'bit varying',
73
+ ]);
74
+
75
+ function renderTypedParam(
76
+ index: number,
77
+ codecId: string | undefined,
78
+ codecLookup: CodecLookup,
79
+ ): string {
80
+ if (codecId === undefined) {
81
+ return `$${index}`;
82
+ }
83
+ // SQL codecs extend the framework `Codec` base with an optional
84
+ // `meta: CodecMeta`; the framework `CodecLookup.get` returns the base type,
85
+ // so we narrow to `SqlCodec` to read `meta`. Every codec actually
86
+ // registered into a SQL codec lookup conforms to `SqlCodec`.
87
+ const codec = codecLookup.get(codecId) as SqlCodec | undefined;
88
+ if (codec === undefined) {
89
+ throw new Error(
90
+ `Postgres lowering: ParamRef carries codecId "${codecId}" but the ` +
91
+ 'assembled codec lookup has no entry for it. This usually indicates ' +
92
+ 'a missing extension pack in the runtime stack — register the pack ' +
93
+ 'that contributes this codec (e.g. `extensionPacks: [pgvectorRuntime]`), ' +
94
+ 'or use the codec directly from `@prisma-next/target-postgres/codecs` ' +
95
+ "if it's a builtin.",
96
+ );
97
+ }
98
+ const nativeType = codec.meta?.db?.sql?.postgres?.nativeType;
99
+ if (nativeType !== undefined && !POSTGRES_INFERRABLE_NATIVE_TYPES.has(nativeType)) {
100
+ return `$${index}::${nativeType}`;
101
+ }
102
+ return `$${index}`;
58
103
  }
59
104
 
60
- function renderTypedParam(index: number, codecId: string | undefined): string {
61
- const cast = getCodecParamCast(codecId);
62
- return cast ? `$${index}::${cast}` : `$${index}`;
105
+ /**
106
+ * Per-render carrier threaded through every helper. Bundles the param-index
107
+ * map (for `$N` numbering) and the assembled-stack `codecLookup` (for
108
+ * cast policy at the `renderTypedParam` chokepoint). Carrying both on a
109
+ * single value keeps helper signatures stable.
110
+ */
111
+ interface ParamIndexMap {
112
+ readonly indexMap: Map<ParamRef, number>;
113
+ readonly codecLookup: CodecLookup;
63
114
  }
64
115
 
65
- type ParamIndexMap = Map<ParamRef, number>;
66
-
67
116
  /**
68
117
  * Render a SQL query AST to a Postgres-flavored `{ sql, params }` payload.
69
118
  *
@@ -74,32 +123,30 @@ type ParamIndexMap = Map<ParamRef, number>;
74
123
  export function renderLoweredSql(
75
124
  ast: AnyQueryAst,
76
125
  contract: PostgresContract,
126
+ codecLookup: CodecLookup,
77
127
  ): { readonly sql: string; readonly params: readonly unknown[] } {
78
- const collectedParamRefs = ast.collectParamRefs();
79
- const paramIndexMap: ParamIndexMap = new Map();
80
- const params: unknown[] = [];
81
- for (const ref of collectedParamRefs) {
82
- if (paramIndexMap.has(ref)) {
83
- continue;
84
- }
85
- paramIndexMap.set(ref, params.length + 1);
86
- params.push(ref.value);
87
- }
128
+ const orderedRefs = collectOrderedParamRefs(ast);
129
+ const indexMap = new Map<ParamRef, number>();
130
+ const params: unknown[] = orderedRefs.map((ref, i) => {
131
+ indexMap.set(ref, i + 1);
132
+ return ref.value;
133
+ });
134
+ const pim: ParamIndexMap = { indexMap, codecLookup };
88
135
 
89
136
  const node = ast;
90
137
  let sql: string;
91
138
  switch (node.kind) {
92
139
  case 'select':
93
- sql = renderSelect(node, contract, paramIndexMap);
140
+ sql = renderSelect(node, contract, pim);
94
141
  break;
95
142
  case 'insert':
96
- sql = renderInsert(node, contract, paramIndexMap);
143
+ sql = renderInsert(node, contract, pim);
97
144
  break;
98
145
  case 'update':
99
- sql = renderUpdate(node, contract, paramIndexMap);
146
+ sql = renderUpdate(node, contract, pim);
100
147
  break;
101
148
  case 'delete':
102
- sql = renderDelete(node, contract, paramIndexMap);
149
+ sql = renderDelete(node, contract, pim);
103
150
  break;
104
151
  // v8 ignore next 4
105
152
  default:
@@ -171,6 +218,27 @@ function renderProjection(
171
218
  .join(', ');
172
219
  }
173
220
 
221
+ function renderReturning(
222
+ items: ReadonlyArray<ProjectionItem>,
223
+ contract: PostgresContract,
224
+ pim: ParamIndexMap,
225
+ ): string {
226
+ return items
227
+ .map((item) => {
228
+ if (item.expr.kind === 'column-ref') {
229
+ const rendered = renderColumn(item.expr);
230
+ return item.expr.column === item.alias
231
+ ? rendered
232
+ : `${rendered} AS ${quoteIdentifier(item.alias)}`;
233
+ }
234
+ if (item.expr.kind === 'literal') {
235
+ return `${renderLiteral(item.expr)} AS ${quoteIdentifier(item.alias)}`;
236
+ }
237
+ return `${renderExpr(item.expr, contract, pim)} AS ${quoteIdentifier(item.alias)}`;
238
+ })
239
+ .join(', ');
240
+ }
241
+
174
242
  function renderDistinctPrefix(
175
243
  distinct: true | undefined,
176
244
  distinctOn: ReadonlyArray<AnyExpression> | undefined,
@@ -457,11 +525,11 @@ function renderExpr(expr: AnyExpression, contract: PostgresContract, pim: ParamI
457
525
  }
458
526
 
459
527
  function renderParamRef(ref: ParamRef, pim: ParamIndexMap): string {
460
- const index = pim.get(ref);
528
+ const index = pim.indexMap.get(ref);
461
529
  if (index === undefined) {
462
530
  throw new Error('ParamRef not found in index map');
463
531
  }
464
- return renderTypedParam(index, ref.codecId);
532
+ return renderTypedParam(index, ref.codecId, pim.codecLookup);
465
533
  }
466
534
 
467
535
  function renderLiteral(expr: LiteralExpr): string {
@@ -660,7 +728,7 @@ function renderInsert(ast: InsertAst, contract: PostgresContract, pim: ParamInde
660
728
  })()
661
729
  : '';
662
730
  const returningClause = ast.returning?.length
663
- ? ` RETURNING ${ast.returning.map((col) => `${quoteIdentifier(col.table)}.${quoteIdentifier(col.column)}`).join(', ')}`
731
+ ? ` RETURNING ${renderReturning(ast.returning, contract, pim)}`
664
732
  : '';
665
733
 
666
734
  return `${insertClause}${onConflictClause}${returningClause}`;
@@ -693,7 +761,7 @@ function renderUpdate(ast: UpdateAst, contract: PostgresContract, pim: ParamInde
693
761
 
694
762
  const whereClause = ast.where ? ` WHERE ${renderWhere(ast.where, contract, pim)}` : '';
695
763
  const returningClause = ast.returning?.length
696
- ? ` RETURNING ${ast.returning.map((col) => `${quoteIdentifier(col.table)}.${quoteIdentifier(col.column)}`).join(', ')}`
764
+ ? ` RETURNING ${renderReturning(ast.returning, contract, pim)}`
697
765
  : '';
698
766
 
699
767
  return `UPDATE ${table} SET ${setClauses.join(', ')}${whereClause}${returningClause}`;
@@ -703,7 +771,7 @@ function renderDelete(ast: DeleteAst, contract: PostgresContract, pim: ParamInde
703
771
  const table = quoteIdentifier(ast.table.name);
704
772
  const whereClause = ast.where ? ` WHERE ${renderWhere(ast.where, contract, pim)}` : '';
705
773
  const returningClause = ast.returning?.length
706
- ? ` RETURNING ${ast.returning.map((col) => `${quoteIdentifier(col.table)}.${quoteIdentifier(col.column)}`).join(', ')}`
774
+ ? ` RETURNING ${renderReturning(ast.returning, contract, pim)}`
707
775
  : '';
708
776
 
709
777
  return `DELETE FROM ${table}${whereClause}${returningClause}`;
package/src/core/types.ts CHANGED
@@ -1,4 +1,5 @@
1
1
  import type { Contract } from '@prisma-next/contract/types';
2
+ import type { CodecLookup } from '@prisma-next/framework-components/codec';
2
3
  import type { SqlStorage, StorageColumn, StorageTable } from '@prisma-next/sql-contract/types';
3
4
  import type {
4
5
  AnyQueryAst,
@@ -19,6 +20,16 @@ import type {
19
20
 
20
21
  export interface PostgresAdapterOptions {
21
22
  readonly profileId?: string;
23
+ /**
24
+ * Codec lookup used by the SQL renderer to resolve per-codec metadata at
25
+ * lower-time. Defaults to a Postgres-builtins-only lookup when omitted —
26
+ * see {@link createPostgresBuiltinCodecLookup} in `./codec-lookup`.
27
+ *
28
+ * Stack-aware callers (`SqlRuntimeAdapterDescriptor.create(stack)` /
29
+ * `SqlControlAdapterDescriptor.create(stack)`) supply the assembled stack
30
+ * lookup so extension codecs are visible to the renderer.
31
+ */
32
+ readonly codecLookup?: CodecLookup;
22
33
  }
23
34
 
24
35
  export type PostgresContract = Contract<SqlStorage> & { readonly target: 'postgres' };
@@ -10,6 +10,7 @@ import type { StorageTypeInstance } from '@prisma-next/sql-contract/types';
10
10
  import {
11
11
  PG_BIT_CODEC_ID,
12
12
  PG_BOOL_CODEC_ID,
13
+ PG_BYTEA_CODEC_ID,
13
14
  PG_ENUM_CODEC_ID,
14
15
  PG_FLOAT4_CODEC_ID,
15
16
  PG_FLOAT8_CODEC_ID,
@@ -29,12 +30,6 @@ import {
29
30
  SQL_CHAR_CODEC_ID,
30
31
  SQL_VARCHAR_CODEC_ID,
31
32
  } from '@prisma-next/target-postgres/codec-ids';
32
- import {
33
- extractStandardSchemaOutputJsonSchema,
34
- extractStandardSchemaTypeExpression,
35
- isStandardSchemaLike,
36
- type StandardSchemaLike,
37
- } from '../core/standard-schema';
38
33
 
39
34
  export const textColumn = {
40
35
  codecId: PG_TEXT_CODEC_ID,
@@ -154,6 +149,19 @@ export function varbitColumn(length: number): ColumnTypeDescriptor & {
154
149
  } as const;
155
150
  }
156
151
 
152
+ /**
153
+ * Postgres `bytea` column descriptor — variable-length binary string.
154
+ *
155
+ * Round-trips as `Uint8Array` on the JS side. The pg wire-protocol text
156
+ * encoding (`\x` followed by hex-encoded bytes, canonical for Postgres ≥ 9.0)
157
+ * and binary encoding are both handled by the underlying driver; the codec
158
+ * only normalizes the JS-side representation to a plain `Uint8Array` view.
159
+ */
160
+ export const byteaColumn = {
161
+ codecId: PG_BYTEA_CODEC_ID,
162
+ nativeType: 'bytea',
163
+ } as const satisfies ColumnTypeDescriptor;
164
+
157
165
  export function intervalColumn(precision?: number): ColumnTypeDescriptor & {
158
166
  readonly typeParams?: { readonly precision: number };
159
167
  } {
@@ -164,68 +172,29 @@ export function intervalColumn(precision?: number): ColumnTypeDescriptor & {
164
172
  } as const;
165
173
  }
166
174
 
175
+ /**
176
+ * Postgres `json` column descriptor — untyped raw JSON.
177
+ *
178
+ * For schema-typed JSON columns, use the per-library extension package
179
+ * (`@prisma-next/extension-arktype-json` ships `arktypeJson(schema)` for
180
+ * arktype). The schema-accepting `json(schema)` / `jsonb(schema)`
181
+ * overloads previously shipped from this module retired in Phase C of
182
+ * the codec-registry-unification project — see spec § AC-7.
183
+ */
167
184
  export const jsonColumn = {
168
185
  codecId: PG_JSON_CODEC_ID,
169
186
  nativeType: 'json',
170
187
  } as const satisfies ColumnTypeDescriptor;
171
188
 
189
+ /**
190
+ * Postgres `jsonb` column descriptor — untyped raw JSONB. Same retirement
191
+ * note as {@link jsonColumn}.
192
+ */
172
193
  export const jsonbColumn = {
173
194
  codecId: PG_JSONB_CODEC_ID,
174
195
  nativeType: 'jsonb',
175
196
  } as const satisfies ColumnTypeDescriptor;
176
197
 
177
- type JsonSchemaTypeParams = {
178
- readonly schemaJson: Record<string, unknown>;
179
- readonly type?: string;
180
- };
181
-
182
- function createJsonTypeParams(schema: StandardSchemaLike): JsonSchemaTypeParams {
183
- const outputSchema = extractStandardSchemaOutputJsonSchema(schema);
184
- if (!outputSchema) {
185
- throw new Error('JSON schema must expose ~standard.jsonSchema.output()');
186
- }
187
-
188
- const expression = extractStandardSchemaTypeExpression(schema);
189
- if (expression) {
190
- return { schemaJson: outputSchema, type: expression };
191
- }
192
-
193
- return { schemaJson: outputSchema };
194
- }
195
-
196
- function createJsonColumnFactory(
197
- codecId: string,
198
- nativeType: string,
199
- staticDescriptor: ColumnTypeDescriptor,
200
- ) {
201
- return (schema?: StandardSchemaLike): ColumnTypeDescriptor => {
202
- if (!schema) {
203
- return staticDescriptor;
204
- }
205
-
206
- if (!isStandardSchemaLike(schema)) {
207
- throw new Error(`${nativeType}(schema) expects a Standard Schema value`);
208
- }
209
-
210
- return {
211
- codecId,
212
- nativeType,
213
- typeParams: createJsonTypeParams(schema),
214
- };
215
- };
216
- }
217
-
218
- const _json = createJsonColumnFactory(PG_JSON_CODEC_ID, 'json', jsonColumn);
219
- const _jsonb = createJsonColumnFactory(PG_JSONB_CODEC_ID, 'jsonb', jsonbColumn);
220
-
221
- export function json(schema?: StandardSchemaLike): ColumnTypeDescriptor {
222
- return _json(schema);
223
- }
224
-
225
- export function jsonb(schema?: StandardSchemaLike): ColumnTypeDescriptor {
226
- return _jsonb(schema);
227
- }
228
-
229
198
  export function enumType<const Values extends readonly string[]>(
230
199
  name: string,
231
200
  values: Values,
@@ -21,8 +21,8 @@ const postgresAdapterDescriptor: SqlControlAdapterDescriptor<'postgres'> = {
21
21
  defaultFunctionRegistry: createPostgresDefaultFunctionRegistry(),
22
22
  generatorDescriptors: createPostgresMutationDefaultGeneratorDescriptors(),
23
23
  },
24
- create(_stack): SqlControlAdapter<'postgres'> {
25
- return new PostgresControlAdapter();
24
+ create(stack): SqlControlAdapter<'postgres'> {
25
+ return new PostgresControlAdapter(stack.codecLookup);
26
26
  },
27
27
  };
28
28
 
@@ -31,3 +31,4 @@ export default postgresAdapterDescriptor;
31
31
  export { parsePostgresDefault } from '@prisma-next/target-postgres/default-normalizer';
32
32
  export { normalizeSchemaNativeType } from '@prisma-next/target-postgres/native-type-normalizer';
33
33
  export { escapeLiteral, qualifyName, quoteIdentifier, SqlEscapeError };
34
+ export { PostgresControlAdapter } from '../core/control-adapter';