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

package/dist/{descriptor-meta-jMtx881n.mjs → descriptor-meta-DpA4aG-x.mjs}

@@ -1,3 +1,4 @@
+import { i as adapterError } from "./control-adapter-Xog0HsuP.mjs";
 import { postgresCodecRegistry } from "@prisma-next/target-postgres/codecs";
 import { PG_BIT_CODEC_ID, PG_BOOL_CODEC_ID, PG_BYTEA_CODEC_ID, PG_CHAR_CODEC_ID, PG_FLOAT4_CODEC_ID, PG_FLOAT8_CODEC_ID, PG_FLOAT_CODEC_ID, PG_INET_CODEC_ID, PG_INT2_CODEC_ID, PG_INT4_CODEC_ID, PG_INT8_CODEC_ID, PG_INTERVAL_CODEC_ID, PG_INT_CODEC_ID, PG_JSONB_CODEC_ID, PG_JSON_CODEC_ID, PG_NUMERIC_CODEC_ID, PG_TEXT_CODEC_ID, PG_TIMESTAMPTZ_CODEC_ID, PG_TIMESTAMP_CODEC_ID, PG_TIMETZ_CODEC_ID, PG_TIME_CODEC_ID, PG_UUID_CODEC_ID, PG_VARBIT_CODEC_ID, PG_VARCHAR_CODEC_ID, SQL_CHAR_CODEC_ID, SQL_FLOAT_CODEC_ID, SQL_INT_CODEC_ID, SQL_TEXT_CODEC_ID, SQL_TIMESTAMP_CODEC_ID, SQL_VARCHAR_CODEC_ID } from "@prisma-next/target-postgres/codec-ids";
 import { buildOperation, toExpr } from "@prisma-next/sql-relational-core/expression";
@@ -17,26 +18,45 @@ function isNonNegativeInteger(value) {
 function expandLength({ nativeType, typeParams }) {
 	if (!typeParams || !("length" in typeParams)) return nativeType;
 	const length = typeParams["length"];
-	if (!isPositiveInteger(length)) throw new Error(`Invalid "length" type parameter for "${nativeType}": expected a positive integer, got ${JSON.stringify(length)}`);
+	if (!isPositiveInteger(length)) throw adapterError("RUNTIME.TYPE_PARAMS_INVALID", `Invalid "length" type parameter for "${nativeType}": expected a positive integer, got ${JSON.stringify(length)}`, { meta: {
+		nativeType,
+		param: "length",
+		received: length
+	} });
 	return `${nativeType}(${length})`;
 }
 function expandPrecision({ nativeType, typeParams }) {
 	if (!typeParams || !("precision" in typeParams)) return nativeType;
 	const precision = typeParams["precision"];
-	if (!isPositiveInteger(precision)) throw new Error(`Invalid "precision" type parameter for "${nativeType}": expected a positive integer, got ${JSON.stringify(precision)}`);
+	if (!isPositiveInteger(precision)) throw adapterError("RUNTIME.TYPE_PARAMS_INVALID", `Invalid "precision" type parameter for "${nativeType}": expected a positive integer, got ${JSON.stringify(precision)}`, { meta: {
+		nativeType,
+		param: "precision",
+		received: precision
+	} });
 	return `${nativeType}(${precision})`;
 }
 function expandNumeric({ nativeType, typeParams }) {
 	const hasPrecision = typeParams && "precision" in typeParams;
 	const hasScale = typeParams && "scale" in typeParams;
 	if (!hasPrecision && !hasScale) return nativeType;
-	if (!hasPrecision && hasScale) throw new Error(`Invalid type parameters for "${nativeType}": "scale" requires "precision" to be specified`);
+	if (!hasPrecision && hasScale) throw adapterError("RUNTIME.TYPE_PARAMS_INVALID", `Invalid type parameters for "${nativeType}": "scale" requires "precision" to be specified`, { meta: {
+		nativeType,
+		param: "scale"
+	} });
 	if (hasPrecision) {
 		const precision = typeParams["precision"];
-		if (!isPositiveInteger(precision)) throw new Error(`Invalid "precision" type parameter for "${nativeType}": expected a positive integer, got ${JSON.stringify(precision)}`);
+		if (!isPositiveInteger(precision)) throw adapterError("RUNTIME.TYPE_PARAMS_INVALID", `Invalid "precision" type parameter for "${nativeType}": expected a positive integer, got ${JSON.stringify(precision)}`, { meta: {
+			nativeType,
+			param: "precision",
+			received: precision
+		} });
 		if (hasScale) {
 			const scale = typeParams["scale"];
-			if (!isNonNegativeInteger(scale)) throw new Error(`Invalid "scale" type parameter for "${nativeType}": expected a non-negative integer, got ${JSON.stringify(scale)}`);
+			if (!isNonNegativeInteger(scale)) throw adapterError("RUNTIME.TYPE_PARAMS_INVALID", `Invalid "scale" type parameter for "${nativeType}": expected a non-negative integer, got ${JSON.stringify(scale)}`, { meta: {
+				nativeType,
+				param: "scale",
+				received: scale
+			} });
 			return `${nativeType}(${precision},${scale})`;
 		}
 		return `${nativeType}(${precision})`;
@@ -328,4 +348,4 @@ const postgresAdapterDescriptorMeta = {
 //#endregion
 export { postgresQueryOperations as n, postgresAdapterDescriptorMeta as t };
 
-//# sourceMappingURL=descriptor-meta-jMtx881n.mjs.map
+//# sourceMappingURL=descriptor-meta-DpA4aG-x.mjs.map

package/dist/descriptor-meta-DpA4aG-x.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor-meta-DpA4aG-x.mjs","names":[],"sources":["../src/core/descriptor-meta.ts"],"sourcesContent":["import type { CodecControlHooks, ExpandNativeTypeInput } from '@prisma-next/family-sql/control';\nimport {\n  buildOperation,\n  type CodecExpression,\n  type Expression,\n  type TraitExpression,\n  toExpr,\n} from '@prisma-next/sql-relational-core/expression';\nimport {\n  PG_BIT_CODEC_ID,\n  PG_BOOL_CODEC_ID,\n  PG_BYTEA_CODEC_ID,\n  PG_CHAR_CODEC_ID,\n  PG_FLOAT_CODEC_ID,\n  PG_FLOAT4_CODEC_ID,\n  PG_FLOAT8_CODEC_ID,\n  PG_INET_CODEC_ID,\n  PG_INT_CODEC_ID,\n  PG_INT2_CODEC_ID,\n  PG_INT4_CODEC_ID,\n  PG_INT8_CODEC_ID,\n  PG_INTERVAL_CODEC_ID,\n  PG_JSON_CODEC_ID,\n  PG_JSONB_CODEC_ID,\n  PG_NUMERIC_CODEC_ID,\n  PG_TEXT_CODEC_ID,\n  PG_TIME_CODEC_ID,\n  PG_TIMESTAMP_CODEC_ID,\n  PG_TIMESTAMPTZ_CODEC_ID,\n  PG_TIMETZ_CODEC_ID,\n  PG_UUID_CODEC_ID,\n  PG_VARBIT_CODEC_ID,\n  PG_VARCHAR_CODEC_ID,\n  SQL_CHAR_CODEC_ID,\n  SQL_FLOAT_CODEC_ID,\n  SQL_INT_CODEC_ID,\n  SQL_TEXT_CODEC_ID,\n  SQL_TIMESTAMP_CODEC_ID,\n  SQL_VARCHAR_CODEC_ID,\n} from '@prisma-next/target-postgres/codec-ids';\nimport { postgresCodecRegistry } from '@prisma-next/target-postgres/codecs';\nimport type { QueryOperationTypes } from '../types/operation-types';\nimport { adapterError } from './adapter-errors';\n\n// ============================================================================ Helper functions for reducing boilerplate ============================================================================\n\n/** Creates a type import spec for codec types */\nconst codecTypeImport = (named: string) =>\n  ({\n    package: '@prisma-next/target-postgres/codec-types',\n    named,\n    alias: named,\n  }) as const;\n\nfunction isPositiveInteger(value: unknown): value is number {\n  return (\n    typeof value === 'number' && Number.isFinite(value) && Number.isInteger(value) && value > 0\n  );\n}\n\nfunction isNonNegativeInteger(value: unknown): value is number {\n  return (\n    typeof value === 'number' && Number.isFinite(value) && Number.isInteger(value) && value >= 0\n  );\n}\n\nfunction expandLength({ nativeType, typeParams }: ExpandNativeTypeInput): string {\n  if (!typeParams || !('length' in typeParams)) {\n    return nativeType;\n  }\n  const length = typeParams['length'];\n  if (!isPositiveInteger(length)) {\n    throw adapterError(\n      'RUNTIME.TYPE_PARAMS_INVALID',\n      `Invalid \"length\" type parameter for \"${nativeType}\": expected a positive integer, got ${JSON.stringify(length)}`,\n      { meta: { nativeType, param: 'length', received: length } },\n    );\n  }\n  return `${nativeType}(${length})`;\n}\n\nfunction expandPrecision({ nativeType, typeParams }: ExpandNativeTypeInput): string {\n  if (!typeParams || !('precision' in typeParams)) {\n    return nativeType;\n  }\n  const precision = typeParams['precision'];\n  if (!isPositiveInteger(precision)) {\n    throw adapterError(\n      'RUNTIME.TYPE_PARAMS_INVALID',\n      `Invalid \"precision\" type parameter for \"${nativeType}\": expected a positive integer, got ${JSON.stringify(precision)}`,\n      { meta: { nativeType, param: 'precision', received: precision } },\n    );\n  }\n  return `${nativeType}(${precision})`;\n}\n\nfunction expandNumeric({ nativeType, typeParams }: ExpandNativeTypeInput): string {\n  const hasPrecision = typeParams && 'precision' in typeParams;\n  const hasScale = typeParams && 'scale' in typeParams;\n\n  if (!hasPrecision && !hasScale) {\n    return nativeType;\n  }\n\n  if (!hasPrecision && hasScale) {\n    throw adapterError(\n      'RUNTIME.TYPE_PARAMS_INVALID',\n      `Invalid type parameters for \"${nativeType}\": \"scale\" requires \"precision\" to be specified`,\n      { meta: { nativeType, param: 'scale' } },\n    );\n  }\n\n  if (hasPrecision) {\n    const precision = typeParams['precision'];\n    if (!isPositiveInteger(precision)) {\n      throw adapterError(\n        'RUNTIME.TYPE_PARAMS_INVALID',\n        `Invalid \"precision\" type parameter for \"${nativeType}\": expected a positive integer, got ${JSON.stringify(precision)}`,\n        { meta: { nativeType, param: 'precision', received: precision } },\n      );\n    }\n    if (hasScale) {\n      const scale = typeParams['scale'];\n      if (!isNonNegativeInteger(scale)) {\n        throw adapterError(\n          'RUNTIME.TYPE_PARAMS_INVALID',\n          `Invalid \"scale\" type parameter for \"${nativeType}\": expected a non-negative integer, got ${JSON.stringify(scale)}`,\n          { meta: { nativeType, param: 'scale', received: scale } },\n        );\n      }\n      return `${nativeType}(${precision},${scale})`;\n    }\n    return `${nativeType}(${precision})`;\n  }\n\n  return nativeType;\n}\n\nconst lengthHooks: CodecControlHooks = { expandNativeType: expandLength };\nconst precisionHooks: CodecControlHooks = { expandNativeType: expandPrecision };\nconst numericHooks: CodecControlHooks = { expandNativeType: expandNumeric };\nconst identityHooks: CodecControlHooks = { expandNativeType: ({ nativeType }) => nativeType };\n\n// ============================================================================ Descriptor metadata ============================================================================\n\ntype CodecTypesBase = Record<string, { readonly input: unknown; readonly output: unknown }>;\n\nexport function postgresQueryOperations<CT extends CodecTypesBase>(): QueryOperationTypes<CT> {\n  return {\n    ilike: {\n      self: { traits: ['textual'] },\n      impl: (\n        self: TraitExpression<readonly ['textual'], false, CT>,\n        pattern: CodecExpression<'pg/text@1', false, CT>,\n      ): Expression<{ codecId: 'pg/bool@1'; nullable: false }> => {\n        return buildOperation({\n          method: 'ilike',\n          args: [toExpr(self), toExpr(pattern, { codecId: PG_TEXT_CODEC_ID })],\n          returns: { codecId: PG_BOOL_CODEC_ID, nullable: false },\n          lowering: { targetFamily: 'sql', strategy: 'infix', template: '{{self}} ILIKE {{arg0}}' },\n        });\n      },\n    },\n  };\n}\n\nexport const postgresAdapterDescriptorMeta = {\n  kind: 'adapter',\n  familyId: 'sql',\n  targetId: 'postgres',\n  id: 'postgres',\n  version: '0.0.1',\n  capabilities: {\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  types: {\n    codecTypes: {\n      codecDescriptors: Array.from(postgresCodecRegistry.values()),\n      import: {\n        package: '@prisma-next/target-postgres/codec-types',\n        named: 'CodecTypes',\n        alias: 'PgTypes',\n      },\n      typeImports: [\n        {\n          package: '@prisma-next/target-postgres/codec-types',\n          named: 'JsonValue',\n          alias: 'JsonValue',\n        },\n        codecTypeImport('Char'),\n        codecTypeImport('Varchar'),\n        codecTypeImport('Numeric'),\n        codecTypeImport('Bit'),\n        codecTypeImport('VarBit'),\n        codecTypeImport('Timestamp'),\n        codecTypeImport('Timestamptz'),\n        codecTypeImport('Time'),\n        codecTypeImport('Timetz'),\n        codecTypeImport('Interval'),\n      ],\n      controlPlaneHooks: {\n        [SQL_CHAR_CODEC_ID]: lengthHooks,\n        [SQL_VARCHAR_CODEC_ID]: lengthHooks,\n        [SQL_TIMESTAMP_CODEC_ID]: precisionHooks,\n        [PG_CHAR_CODEC_ID]: lengthHooks,\n        [PG_VARCHAR_CODEC_ID]: lengthHooks,\n        [PG_NUMERIC_CODEC_ID]: numericHooks,\n        [PG_BIT_CODEC_ID]: lengthHooks,\n        [PG_VARBIT_CODEC_ID]: lengthHooks,\n        [PG_TIMESTAMP_CODEC_ID]: precisionHooks,\n        [PG_TIMESTAMPTZ_CODEC_ID]: precisionHooks,\n        [PG_TIME_CODEC_ID]: precisionHooks,\n        [PG_TIMETZ_CODEC_ID]: precisionHooks,\n        [PG_INTERVAL_CODEC_ID]: precisionHooks,\n        [PG_JSON_CODEC_ID]: identityHooks,\n        [PG_JSONB_CODEC_ID]: identityHooks,\n        [PG_BYTEA_CODEC_ID]: identityHooks,\n        [PG_UUID_CODEC_ID]: identityHooks,\n        [PG_INET_CODEC_ID]: identityHooks,\n      },\n    },\n    storage: [\n      { typeId: PG_TEXT_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'text' },\n      { typeId: SQL_TEXT_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'text' },\n      { typeId: SQL_CHAR_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'character' },\n      {\n        typeId: SQL_VARCHAR_CODEC_ID,\n        familyId: 'sql',\n        targetId: 'postgres',\n        nativeType: 'character varying',\n      },\n      { typeId: SQL_INT_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'int4' },\n      { typeId: SQL_FLOAT_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'float8' },\n      {\n        typeId: SQL_TIMESTAMP_CODEC_ID,\n        familyId: 'sql',\n        targetId: 'postgres',\n        nativeType: 'timestamp',\n      },\n      { typeId: PG_CHAR_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'character' },\n      {\n        typeId: PG_VARCHAR_CODEC_ID,\n        familyId: 'sql',\n        targetId: 'postgres',\n        nativeType: 'character varying',\n      },\n      { typeId: PG_INT_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'int4' },\n      { typeId: PG_FLOAT_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'float8' },\n      { typeId: PG_INT4_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'int4' },\n      { typeId: PG_INT2_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'int2' },\n      { typeId: PG_INT8_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'int8' },\n      { typeId: PG_FLOAT4_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'float4' },\n      { typeId: PG_FLOAT8_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'float8' },\n      { typeId: PG_NUMERIC_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'numeric' },\n      {\n        typeId: PG_TIMESTAMP_CODEC_ID,\n        familyId: 'sql',\n        targetId: 'postgres',\n        nativeType: 'timestamp',\n      },\n      {\n        typeId: PG_TIMESTAMPTZ_CODEC_ID,\n        familyId: 'sql',\n        targetId: 'postgres',\n        nativeType: 'timestamptz',\n      },\n      { typeId: PG_TIME_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'time' },\n      { typeId: PG_TIMETZ_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'timetz' },\n      { typeId: PG_BOOL_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'bool' },\n      { typeId: PG_BIT_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'bit' },\n      {\n        typeId: PG_VARBIT_CODEC_ID,\n        familyId: 'sql',\n        targetId: 'postgres',\n        nativeType: 'bit varying',\n      },\n      {\n        typeId: PG_INTERVAL_CODEC_ID,\n        familyId: 'sql',\n        targetId: 'postgres',\n        nativeType: 'interval',\n      },\n      { typeId: PG_JSON_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'json' },\n      { typeId: PG_JSONB_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'jsonb' },\n      { typeId: PG_BYTEA_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'bytea' },\n      { typeId: PG_UUID_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'uuid' },\n      { typeId: PG_INET_CODEC_ID, familyId: 'sql', targetId: 'postgres', nativeType: 'inet' },\n    ],\n    queryOperationTypes: {\n      import: {\n        package: '@prisma-next/adapter-postgres/operation-types',\n        named: 'QueryOperationTypes',\n        alias: 'PgAdapterQueryOps',\n      },\n    },\n  },\n} as const;\n"],"mappings":"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"}

package/dist/runtime.mjs

@@ -1,5 +1,5 @@
-import { n as postgresRawCodecInferer, t as createPostgresAdapter } from "./adapter-DcBWxseT.mjs";
-import { n as postgresQueryOperations, t as postgresAdapterDescriptorMeta } from "./descriptor-meta-jMtx881n.mjs";
+import { n as postgresRawCodecInferer, t as createPostgresAdapter } from "./adapter-CuTsfsz3.mjs";
+import { n as postgresQueryOperations, t as postgresAdapterDescriptorMeta } from "./descriptor-meta-DpA4aG-x.mjs";
 import { extractCodecLookup } from "@prisma-next/framework-components/control";
 import { postgresCodecRegistry } from "@prisma-next/target-postgres/codecs";
 import { builtinGeneratorIds } from "@prisma-next/ids";

package/package.json

@@ -1,35 +1,35 @@
 {
   "name": "@prisma-next/adapter-postgres",
-  "version": "0.16.0-dev.22",
+  "version": "0.16.0-dev.23",
   "license": "Apache-2.0",
   "type": "module",
   "sideEffects": false,
   "dependencies": {
-    "@prisma-next/contract": "0.16.0-dev.22",
-    "@prisma-next/contract-authoring": "0.16.0-dev.22",
-    "@prisma-next/errors": "0.16.0-dev.22",
-    "@prisma-next/family-sql": "0.16.0-dev.22",
-    "@prisma-next/framework-components": "0.16.0-dev.22",
-    "@prisma-next/ids": "0.16.0-dev.22",
-    "@prisma-next/psl-parser": "0.16.0-dev.22",
-    "@prisma-next/sql-contract": "0.16.0-dev.22",
-    "@prisma-next/sql-contract-psl": "0.16.0-dev.22",
-    "@prisma-next/sql-contract-ts": "0.16.0-dev.22",
-    "@prisma-next/sql-operations": "0.16.0-dev.22",
-    "@prisma-next/sql-relational-core": "0.16.0-dev.22",
-    "@prisma-next/sql-runtime": "0.16.0-dev.22",
-    "@prisma-next/sql-schema-ir": "0.16.0-dev.22",
-    "@prisma-next/target-postgres": "0.16.0-dev.22",
-    "@prisma-next/utils": "0.16.0-dev.22",
+    "@prisma-next/contract": "0.16.0-dev.23",
+    "@prisma-next/contract-authoring": "0.16.0-dev.23",
+    "@prisma-next/errors": "0.16.0-dev.23",
+    "@prisma-next/family-sql": "0.16.0-dev.23",
+    "@prisma-next/framework-components": "0.16.0-dev.23",
+    "@prisma-next/ids": "0.16.0-dev.23",
+    "@prisma-next/psl-parser": "0.16.0-dev.23",
+    "@prisma-next/sql-contract": "0.16.0-dev.23",
+    "@prisma-next/sql-contract-psl": "0.16.0-dev.23",
+    "@prisma-next/sql-contract-ts": "0.16.0-dev.23",
+    "@prisma-next/sql-operations": "0.16.0-dev.23",
+    "@prisma-next/sql-relational-core": "0.16.0-dev.23",
+    "@prisma-next/sql-runtime": "0.16.0-dev.23",
+    "@prisma-next/sql-schema-ir": "0.16.0-dev.23",
+    "@prisma-next/target-postgres": "0.16.0-dev.23",
+    "@prisma-next/utils": "0.16.0-dev.23",
     "arktype": "^2.2.2"
   },
   "devDependencies": {
-    "@prisma-next/cli": "0.16.0-dev.22",
-    "@prisma-next/driver-postgres": "0.16.0-dev.22",
-    "@prisma-next/migration-tools": "0.16.0-dev.22",
-    "@prisma-next/test-utils": "0.16.0-dev.22",
-    "@prisma-next/tsconfig": "0.16.0-dev.22",
-    "@prisma-next/tsdown": "0.16.0-dev.22",
+    "@prisma-next/cli": "0.16.0-dev.23",
+    "@prisma-next/driver-postgres": "0.16.0-dev.23",
+    "@prisma-next/migration-tools": "0.16.0-dev.23",
+    "@prisma-next/test-utils": "0.16.0-dev.23",
+    "@prisma-next/tsconfig": "0.16.0-dev.23",
+    "@prisma-next/tsdown": "0.16.0-dev.23",
     "pathe": "^2.0.3",
     "tsdown": "0.22.8",
     "typescript": "5.9.3",

package/src/core/adapter-errors.ts

@@ -0,0 +1,25 @@
+import type { StructuredError, StructuredErrorOptions } from '@prisma-next/utils/structured-error';
+import { structuredError } from '@prisma-next/utils/structured-error';
+
+type RuntimeSubcode =
+  | 'DDL_UNSUPPORTED'
+  | 'RAW_SQL_UNSUPPORTED_INTERPOLATION'
+  | 'TYPE_PARAMS_INVALID'
+  | 'PARAM_REF_MISSING_CODEC'
+  | 'NAMESPACE_UNKNOWN'
+  | 'AST_INVALID';
+
+type ContractSubcode =
+  | 'INTROSPECTION_UNSUPPORTED'
+  | 'DEFAULT_INVALID'
+  | 'PACK_CONTRIBUTION_INVALID';
+
+export type PostgresAdapterErrorCode = `RUNTIME.${RuntimeSubcode}` | `CONTRACT.${ContractSubcode}`;
+
+export function adapterError(
+  code: PostgresAdapterErrorCode,
+  message: string,
+  options?: StructuredErrorOptions,
+): StructuredError {
+  return structuredError(code, message, options);
+}

package/src/core/adapter.ts

@@ -11,6 +11,7 @@ import type {
 import { isDdlNode } from '@prisma-next/sql-relational-core/ast';
 import type { RawCodecInferer } from '@prisma-next/sql-relational-core/expression';
 import type { PostgresDdlNode } from '@prisma-next/target-postgres/ddl';
+import { adapterError } from './adapter-errors';
 import { createPostgresBuiltinCodecLookup } from './codec-lookup';
 import { PostgresControlAdapter } from './control-adapter';
 import { renderLoweredSql } from './sql-renderer';
@@ -75,8 +76,10 @@ class PostgresAdapterImpl
     context: LowererContext<PostgresContract>,
   ): PostgresLoweredStatement {
     if (isDdlNode(ast)) {
-      throw new Error(
+      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);
@@ -98,8 +101,10 @@ export const postgresRawCodecInferer: RawCodecInferer = {
       case 'object':
         if (value instanceof Uint8Array) return 'pg/bytea';
     }
-    throw new Error(
+    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 } },
     );
   },
 };

package/src/core/control-adapter.ts

@@ -76,6 +76,7 @@ import {
 } from '@prisma-next/target-postgres/types';
 import { blindCast } from '@prisma-next/utils/casts';
 import { ifDefined } from '@prisma-next/utils/defined';
+import { adapterError } from './adapter-errors';
 import { encodeControlQueryParams } from './control-codecs';
 import {
   execute,
@@ -148,8 +149,10 @@ export class PostgresControlAdapter implements SqlControlAdapter<'postgres'> {
    */
   lower(ast: AnyQueryAst | PostgresDdlNode, context: LowererContext<unknown>): LoweredStatement {
     if (isDdlNode(ast)) {
-      throw new Error(
+      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(
@@ -1548,8 +1551,10 @@ const PG_REFERENTIAL_ACTION_MAP: Record<PgReferentialActionRule, SqlReferentialA
 function mapReferentialAction(rule: string): SqlReferentialAction | undefined {
   const mapped = PG_REFERENTIAL_ACTION_MAP[rule as PgReferentialActionRule];
   if (mapped === undefined) {
-    throw new Error(
+    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 undefined;
@@ -1620,8 +1625,10 @@ export function parsePgReloptions(
   for (const entry of reloptions) {
     const eq = entry.indexOf('=');
     if (eq === -1) {
-      throw new Error(
+      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);
@@ -1777,8 +1784,10 @@ function pgInlineLiteral(wire: unknown, nativeType: string): string {
   if (typeof wire === 'boolean') return wire ? 'true' : 'false';
   if (typeof wire === 'number') {
     if (!Number.isFinite(wire)) {
-      throw new Error(
+      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);
@@ -1786,8 +1795,10 @@ function pgInlineLiteral(wire: unknown, nativeType: string): string {
   if (typeof wire === 'bigint') return String(wire);
   if (wire instanceof Date) {
     if (Number.isNaN(wire.getTime())) {
-      throw new Error(
+      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())}'`;
@@ -1810,8 +1821,10 @@ function pgInlineLiteral(wire: unknown, nativeType: string): string {
     const quoted = `'${escapeLiteral(JSON.stringify(wire))}'`;
     return `${quoted}::${nativeType}`;
   }
-  throw new Error(
+  throw adapterError(
+    'CONTRACT.PACK_CONTRIBUTION_INVALID',
     `pgRenderDdlExecuteRequest: unexpected wire type "${typeof wire}" for native type "${nativeType}"`,
+    { meta: { wireType: typeof wire, nativeType } },
   );
 }
 

package/src/core/control-codecs.ts

@@ -9,6 +9,7 @@ import {
   encodeParamsWithMetadata,
 } from '@prisma-next/sql-runtime';
 import { postgresCodecRegistry } from '@prisma-next/target-postgres/codecs';
+import { InternalError } from '@prisma-next/utils/internal-error';
 
 export const CONTROL_CODECS = createAstCodecRegistry(postgresCodecRegistry);
 
@@ -19,7 +20,9 @@ export async function encodeControlQueryParams(
 ): Promise<readonly unknown[]> {
   const values = 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`,
+    );
   });
   return encodeParamsWithMetadata(values, deriveParamMetadata(ast), {}, codecs);
 }

package/src/core/descriptor-meta.ts

@@ -40,6 +40,7 @@ import {
 } from '@prisma-next/target-postgres/codec-ids';
 import { postgresCodecRegistry } from '@prisma-next/target-postgres/codecs';
 import type { QueryOperationTypes } from '../types/operation-types';
+import { adapterError } from './adapter-errors';
 
 // ============================================================================ Helper functions for reducing boilerplate ============================================================================
 
@@ -69,8 +70,10 @@ function expandLength({ nativeType, typeParams }: ExpandNativeTypeInput): string
   }
   const length = typeParams['length'];
   if (!isPositiveInteger(length)) {
-    throw new Error(
+    throw adapterError(
+      'RUNTIME.TYPE_PARAMS_INVALID',
       `Invalid "length" type parameter for "${nativeType}": expected a positive integer, got ${JSON.stringify(length)}`,
+      { meta: { nativeType, param: 'length', received: length } },
     );
   }
   return `${nativeType}(${length})`;
@@ -82,8 +85,10 @@ function expandPrecision({ nativeType, typeParams }: ExpandNativeTypeInput): str
   }
   const precision = typeParams['precision'];
   if (!isPositiveInteger(precision)) {
-    throw new Error(
+    throw adapterError(
+      'RUNTIME.TYPE_PARAMS_INVALID',
       `Invalid "precision" type parameter for "${nativeType}": expected a positive integer, got ${JSON.stringify(precision)}`,
+      { meta: { nativeType, param: 'precision', received: precision } },
     );
   }
   return `${nativeType}(${precision})`;
@@ -98,23 +103,29 @@ function expandNumeric({ nativeType, typeParams }: ExpandNativeTypeInput): strin
   }
 
   if (!hasPrecision && hasScale) {
-    throw new Error(
+    throw adapterError(
+      'RUNTIME.TYPE_PARAMS_INVALID',
       `Invalid type parameters for "${nativeType}": "scale" requires "precision" to be specified`,
+      { meta: { nativeType, param: 'scale' } },
     );
   }
 
   if (hasPrecision) {
     const precision = typeParams['precision'];
     if (!isPositiveInteger(precision)) {
-      throw new Error(
+      throw adapterError(
+        'RUNTIME.TYPE_PARAMS_INVALID',
         `Invalid "precision" type parameter for "${nativeType}": expected a positive integer, got ${JSON.stringify(precision)}`,
+        { meta: { nativeType, param: 'precision', received: precision } },
       );
     }
     if (hasScale) {
       const scale = typeParams['scale'];
       if (!isNonNegativeInteger(scale)) {
-        throw new Error(
+        throw adapterError(
+          'RUNTIME.TYPE_PARAMS_INVALID',
           `Invalid "scale" type parameter for "${nativeType}": expected a non-negative integer, got ${JSON.stringify(scale)}`,
+          { meta: { nativeType, param: 'scale', received: scale } },
         );
       }
       return `${nativeType}(${precision},${scale})`;

package/src/core/sql-renderer.ts

@@ -44,6 +44,8 @@ import {
   quoteQualifiedName,
 } from '@prisma-next/target-postgres/sql-utils';
 import { ifDefined } from '@prisma-next/utils/defined';
+import { assertNever, InternalError } from '@prisma-next/utils/internal-error';
+import { adapterError } from './adapter-errors';
 import type { PostgresContract } from './types';
 
 /**
@@ -95,13 +97,15 @@ function renderTypedParam(
     meta !== undefined ||
     codecLookup.targetTypesFor(codecId) !== undefined;
   if (!isRegistered) {
-    throw new Error(
+    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 } },
     );
   }
   // `typeParams` above already resolved a parameterized codec's per-instance
@@ -201,7 +205,7 @@ export function renderLoweredSql(
       break;
     // v8 ignore next 4
     default:
-      throw new Error(`Unsupported AST node kind: ${unreachableKind(node)}`);
+      assertNever(node, `Unsupported AST node kind: ${unreachableKind(node)}`);
   }
 
   return Object.freeze({ sql, params: Object.freeze(params) });
@@ -460,14 +464,18 @@ function qualifyTableFromNamespaceCoordinate(
   }
   const namespace = contract.storage.namespaces[table.namespaceId];
   if (namespace === undefined) {
-    throw new Error(
+    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 === undefined) {
-    throw new Error(
+    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);
@@ -505,13 +513,17 @@ function renderSource(
     }
     // v8 ignore next 4
     default:
-      throw new Error(`Unsupported source node kind: ${unreachableKind(node)}`);
+      assertNever(node, `Unsupported source node kind: ${unreachableKind(node)}`);
   }
 }
 
 function assertScalarSubquery(query: SelectAst): void {
   if (query.projection.length !== 1) {
-    throw new Error('Subquery expressions must project exactly one column');
+    throw adapterError(
+      'RUNTIME.AST_INVALID',
+      'Subquery expressions must project exactly one column',
+      { meta: { node: 'subquery-expr' } },
+    );
   }
 }
 
@@ -816,14 +828,14 @@ function renderExpr(expr: AnyExpression, contract: PostgresContract, pim: ParamI
       return renderRawExpr(node, contract, pim);
     // v8 ignore next 4
     default:
-      throw new Error(`Unsupported expression node kind: ${unreachableKind(node)}`);
+      assertNever(node, `Unsupported expression node kind: ${unreachableKind(node)}`);
   }
 }
 
 function renderParamRef(ref: AnyParamRef, pim: ParamIndexMap): string {
   const index = pim.indexMap.get(ref);
   if (index === undefined) {
-    throw new Error('ParamRef not found in index map');
+    throw new InternalError('ParamRef not found in index map');
   }
   if (ref.kind === 'prepared-param-ref') {
     return renderTypedParam(
@@ -900,8 +912,10 @@ function renderOperation(
       }
       const arg = args[Number(argIndex)];
       if (arg === undefined) {
-        throw new Error(
+        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;
@@ -964,7 +978,11 @@ function getInsertColumnOrder(
     }
   }
   if (!table) {
-    throw new Error(`INSERT target table not found in contract storage: ${tableName}`);
+    throw adapterError(
+      'RUNTIME.AST_INVALID',
+      `INSERT target table not found in contract storage: ${tableName}`,
+      { meta: { node: 'insert', table: tableName } },
+    );
   }
   return Object.keys(table.columns);
 }
@@ -988,7 +1006,7 @@ function renderInsertValue(
       return renderExpr(value, contract, pim);
     // v8 ignore next 4
     default:
-      throw new Error(`Unsupported value node in INSERT: ${unreachableKind(value)}`);
+      assertNever(value, `Unsupported value node in INSERT: ${unreachableKind(value)}`);
   }
 }
 
@@ -996,7 +1014,9 @@ function renderInsert(ast: InsertAst, contract: PostgresContract, pim: ParamInde
   const table = qualifyTableFromNamespaceCoordinate(ast.table, contract);
   const rows = ast.rows;
   if (rows.length === 0) {
-    throw new Error('INSERT requires at least one row');
+    throw adapterError('RUNTIME.AST_INVALID', 'INSERT requires at least one row', {
+      meta: { node: 'insert' },
+    });
   }
   const hasExplicitValues = rows.some((row) => Object.keys(row).length > 0);
   const insertClause = (() => {
@@ -1034,7 +1054,11 @@ function renderInsert(ast: InsertAst, contract: PostgresContract, pim: ParamInde
     ? (() => {
         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');
+          throw adapterError(
+            'RUNTIME.AST_INVALID',
+            'INSERT onConflict requires at least one conflict column',
+            { meta: { node: 'insert-on-conflict' } },
+          );
         }
 
         const action = ast.onConflict.action;
@@ -1044,7 +1068,11 @@ function renderInsert(ast: InsertAst, contract: PostgresContract, pim: ParamInde
           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');
+              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)}`;
@@ -1053,7 +1081,7 @@ function renderInsert(ast: InsertAst, contract: PostgresContract, pim: ParamInde
           }
           // v8 ignore next 4
           default:
-            throw new Error(`Unsupported onConflict action: ${unreachableKind(action)}`);
+            assertNever(action, `Unsupported onConflict action: ${unreachableKind(action)}`);
         }
       })()
     : '';
@@ -1068,7 +1096,9 @@ function renderUpdate(ast: UpdateAst, contract: PostgresContract, pim: ParamInde
   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');
+    throw adapterError('RUNTIME.AST_INVALID', 'UPDATE requires at least one SET assignment', {
+      meta: { node: 'update' },
+    });
   }
   const setClauses = setEntries.map(([col, val]) => {
     const column = quoteIdentifier(col);

package/src/exports/control.ts

@@ -4,7 +4,6 @@ import {
   escapeLiteral,
   qualifyName,
   quoteIdentifier,
-  SqlEscapeError,
 } from '@prisma-next/target-postgres/sql-utils';
 import { PostgresControlAdapter } from '../core/control-adapter';
 import {
@@ -32,4 +31,4 @@ export { parsePostgresDefault } from '@prisma-next/target-postgres/default-norma
 export { normalizeSchemaNativeType } from '@prisma-next/target-postgres/native-type-normalizer';
 export { createPostgresBuiltinCodecLookup } from '../core/codec-lookup';
 export { PostgresControlAdapter } from '../core/control-adapter';
-export { escapeLiteral, qualifyName, quoteIdentifier, SqlEscapeError };
+export { escapeLiteral, qualifyName, quoteIdentifier };

package/dist/adapter-DcBWxseT.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter-DcBWxseT.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 { 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 new Error(\n        'lower() does not lower DDL on the runtime adapter — DDL lowering is a control-plane concern handled by the control 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 new Error(\n      'unsupported JS value type for raw-SQL interpolation: wrap this value in `param(...)` with an explicit codec',\n    );\n  },\n};\n\nexport function createPostgresAdapter(options?: PostgresAdapterOptions) {\n  return Object.freeze(new PostgresAdapterImpl(options));\n}\n"],"mappings":";;;;AAkBA,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,IAAI,MACR,6HACF;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,IAAI,MACR,6GACF;AACF,EACF;AAEA,SAAgB,sBAAsB,SAAkC;CACtE,OAAO,OAAO,OAAO,IAAI,oBAAoB,OAAO,CAAC;AACvD"}