@prisma-next/extension-pgvector 0.16.0-dev.25 → 0.16.0-dev.27

package/dist/{codec-types-CEqpE2q2.d.mts → codec-types-eUx62rq4.d.mts}

@@ -9,13 +9,14 @@ import { StandardSchemaV1 } from "@standard-schema/spec";
 declare const VECTOR_CODEC_ID: "pg/vector@1";
 //#endregion
 //#region src/core/codecs.d.ts
+type VectorConversionCode = 'RUNTIME.ENCODE_FAILED' | 'RUNTIME.DECODE_FAILED';
 type VectorParams = {
   readonly length: number;
 };
 declare class PgVectorCodec extends CodecImpl<typeof VECTOR_CODEC_ID, readonly ['equality'], string, number[]> {
   readonly length: number;
   constructor(descriptor: AnyCodecDescriptor, length: number);
-  assertVector(value: unknown): asserts value is number[];
+  assertVector(value: unknown, code: VectorConversionCode): asserts value is number[];
   encode(value: number[], _ctx: CodecCallContext): Promise<string>;
   decode(wire: string, _ctx: CodecCallContext): Promise<number[]>;
   encodeJson(value: number[]): JsonValue;
@@ -56,4 +57,4 @@ type Vector<N extends number = number> = number[] & {
 type CodecTypes = CodecTypes$1;
 //#endregion
 export { Vector as n, CodecTypes as t };
-//# sourceMappingURL=codec-types-CEqpE2q2.d.mts.map
+//# sourceMappingURL=codec-types-eUx62rq4.d.mts.map

package/dist/codec-types-eUx62rq4.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec-types-eUx62rq4.d.mts","names":[],"sources":["../src/core/constants.ts","../src/core/codecs.ts","../src/types/codec-types.ts"],"mappings":";;;;;;;;cAGa;;;KC0BR;KAEA;WAA0B;;cA+ClB,sBAAsB,iBAC1B;WAKE;cAEG,YAAY,oBAAoB;EAK5C,aAAa,gBAAgB,MAAM,+BAA+B;EAyB5D,OAAO,iBAAiB,MAAM,mBAAmB;EAKjD,OAAO,cAAc,MAAM,mBAAmB;EAWpD,WAAW,kBAAkB;EAK7B,WAAW,MAAM;;cAYN,2BAA2B,oBAAoB;WACxC;WACA;WACA;WACA;;;;;;;;;WACA,cAAc,iBAAiB;EACxC,iBAAiB,QAAQ;EAGzB,QAAQ,QAAQ,gBAAgB,KAAK,yBAAyB;;cAkBnE;mBAAA;;KAIM,eAAa,yBAAyB;;;;;;;;;KCnKtC,OAAO;WAAmD,iBAAiB;;KAE3E,aAAa"}

package/dist/codec-types.d.mts

@@ -1,2 +1,2 @@
-import { n as Vector, t as CodecTypes } from "./codec-types-CEqpE2q2.mjs";
+import { n as Vector, t as CodecTypes } from "./codec-types-eUx62rq4.mjs";
 export type { CodecTypes, Vector };

package/dist/column-types.d.mts

@@ -10,7 +10,7 @@ import { ColumnTypeDescriptor } from "@prisma-next/framework-components/codec";
  * ```
  * @param length - The dimension of the vector (e.g., 1536 for OpenAI embeddings)
  * @returns A column type descriptor with `typeParams.length` set
- * @throws {RangeError} If length is not an integer in the range [1, VECTOR_MAX_DIM]
+ * @throws `CONTRACT.ARGUMENT_INVALID` if length is not an integer in the range [1, VECTOR_MAX_DIM]
  */
 declare function vector<N extends number>(length: N): ColumnTypeDescriptor & {
   readonly typeParams: {

package/dist/column-types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"column-types.d.mts","names":[],"sources":["../src/exports/column-types.ts"],"mappings":";;;;;;;;;;;;;;iBAmBgB,OAAO,kBACrB,QAAQ,IACP;WAAkC;aAAuB,QAAQ"}
+{"version":3,"file":"column-types.d.mts","names":[],"sources":["../src/exports/column-types.ts"],"mappings":";;;;;;;;;;;;;;iBAoBgB,OAAO,kBACrB,QAAQ,IACP;WAAkC;aAAuB,QAAQ"}

package/dist/column-types.mjs

@@ -1,4 +1,4 @@
-import { n as VECTOR_MAX_DIM, t as VECTOR_CODEC_ID } from "./constants-D8Ccy-f4.mjs";
+import { n as VECTOR_CODEC_ID, r as VECTOR_MAX_DIM, t as pgVectorError } from "./errors-BnZLl-sM.mjs";
 //#region src/exports/column-types.ts
 /**
 * Factory for creating dimensioned vector column descriptors.
@@ -10,10 +10,17 @@ import { n as VECTOR_MAX_DIM, t as VECTOR_CODEC_ID } from "./constants-D8Ccy-f4.
 * ```
 * @param length - The dimension of the vector (e.g., 1536 for OpenAI embeddings)
 * @returns A column type descriptor with `typeParams.length` set
-* @throws {RangeError} If length is not an integer in the range [1, VECTOR_MAX_DIM]
+* @throws `CONTRACT.ARGUMENT_INVALID` if length is not an integer in the range [1, VECTOR_MAX_DIM]
 */
 function vector(length) {
-	if (!Number.isInteger(length) || length < 1 || length > 16e3) throw new RangeError(`pgvector: dimension must be an integer in [1, ${VECTOR_MAX_DIM}], got ${length}`);
+	if (!Number.isInteger(length) || length < 1 || length > 16e3) throw pgVectorError("CONTRACT.ARGUMENT_INVALID", `pgvector: dimension must be an integer in [1, ${VECTOR_MAX_DIM}], got ${length}`, {
+		fix: `Pass an integer dimension between 1 and ${VECTOR_MAX_DIM}, e.g. vector(1536).`,
+		meta: {
+			helperPath: "vector",
+			expected: `an integer in [1, ${VECTOR_MAX_DIM}]`,
+			received: length
+		}
+	});
 	return {
 		codecId: VECTOR_CODEC_ID,
 		nativeType: "vector",

package/dist/column-types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"column-types.mjs","names":[],"sources":["../src/exports/column-types.ts"],"sourcesContent":["/**\n * Column type descriptor factory for pgvector extension. `vector(N)` is the canonical authoring surface; every pgvector column must declare a dimension via this factory. The dimension threads into the runtime codec through `paramsSchema.length` and into the DDL via the family-layer `expandNativeType` hook (e.g. `vector(1536)`).\n */\n\nimport type { ColumnTypeDescriptor } from '@prisma-next/framework-components/codec';\nimport { VECTOR_CODEC_ID, VECTOR_MAX_DIM } from '../core/constants';\n\n/**\n * Factory for creating dimensioned vector column descriptors.\n *\n * @example\n * ```typescript\n * .column('embedding', { type: vector(1536), nullable: false })\n * // Produces: nativeType: 'vector', typeParams: { length: 1536 }\n * ```\n * @param length - The dimension of the vector (e.g., 1536 for OpenAI embeddings)\n * @returns A column type descriptor with `typeParams.length` set\n * @throws {RangeError} If length is not an integer in the range [1, VECTOR_MAX_DIM]\n */\nexport function vector<N extends number>(\n  length: N,\n): ColumnTypeDescriptor & { readonly typeParams: { readonly length: N } } {\n  if (!Number.isInteger(length) || length < 1 || length > VECTOR_MAX_DIM) {\n    throw new RangeError(\n      `pgvector: dimension must be an integer in [1, ${VECTOR_MAX_DIM}], got ${length}`,\n    );\n  }\n  return {\n    codecId: VECTOR_CODEC_ID,\n    nativeType: 'vector',\n    typeParams: { length },\n  } as const;\n}\n"],"mappings":";;;;;;;;;;;;;;AAmBA,SAAgB,OACd,QACwE;CACxE,IAAI,CAAC,OAAO,UAAU,MAAM,KAAK,SAAS,KAAK,SAAA,MAC7C,MAAM,IAAI,WACR,iDAAiD,eAAe,SAAS,QAC3E;CAEF,OAAO;EACL,SAAS;EACT,YAAY;EACZ,YAAY,EAAE,OAAO;CACvB;AACF"}
+{"version":3,"file":"column-types.mjs","names":[],"sources":["../src/exports/column-types.ts"],"sourcesContent":["/**\n * Column type descriptor factory for pgvector extension. `vector(N)` is the canonical authoring surface; every pgvector column must declare a dimension via this factory. The dimension threads into the runtime codec through `paramsSchema.length` and into the DDL via the family-layer `expandNativeType` hook (e.g. `vector(1536)`).\n */\n\nimport type { ColumnTypeDescriptor } from '@prisma-next/framework-components/codec';\nimport { VECTOR_CODEC_ID, VECTOR_MAX_DIM } from '../core/constants';\nimport { pgVectorError } from '../core/errors';\n\n/**\n * Factory for creating dimensioned vector column descriptors.\n *\n * @example\n * ```typescript\n * .column('embedding', { type: vector(1536), nullable: false })\n * // Produces: nativeType: 'vector', typeParams: { length: 1536 }\n * ```\n * @param length - The dimension of the vector (e.g., 1536 for OpenAI embeddings)\n * @returns A column type descriptor with `typeParams.length` set\n * @throws `CONTRACT.ARGUMENT_INVALID` if length is not an integer in the range [1, VECTOR_MAX_DIM]\n */\nexport function vector<N extends number>(\n  length: N,\n): ColumnTypeDescriptor & { readonly typeParams: { readonly length: N } } {\n  if (!Number.isInteger(length) || length < 1 || length > VECTOR_MAX_DIM) {\n    throw pgVectorError(\n      'CONTRACT.ARGUMENT_INVALID',\n      `pgvector: dimension must be an integer in [1, ${VECTOR_MAX_DIM}], got ${length}`,\n      {\n        fix: `Pass an integer dimension between 1 and ${VECTOR_MAX_DIM}, e.g. vector(1536).`,\n        meta: {\n          helperPath: 'vector',\n          expected: `an integer in [1, ${VECTOR_MAX_DIM}]`,\n          received: length,\n        },\n      },\n    );\n  }\n  return {\n    codecId: VECTOR_CODEC_ID,\n    nativeType: 'vector',\n    typeParams: { length },\n  } as const;\n}\n"],"mappings":";;;;;;;;;;;;;;AAoBA,SAAgB,OACd,QACwE;CACxE,IAAI,CAAC,OAAO,UAAU,MAAM,KAAK,SAAS,KAAK,SAAA,MAC7C,MAAM,cACJ,6BACA,iDAAiD,eAAe,SAAS,UACzE;EACE,KAAK,2CAA2C,eAAe;EAC/D,MAAM;GACJ,YAAY;GACZ,UAAU,qBAAqB,eAAe;GAC9C,UAAU;EACZ;CACF,CACF;CAEF,OAAO;EACL,SAAS;EACT,YAAY;EACZ,YAAY,EAAE,OAAO;CACvB;AACF"}

package/dist/control.mjs

@@ -1,4 +1,4 @@
-import { n as pgvectorQueryOperations, t as pgvectorPackMeta } from "./descriptor-meta-G5zBc8J8.mjs";
+import { n as pgvectorQueryOperations, t as pgvectorPackMeta } from "./descriptor-meta-DMPKzaNe.mjs";
 import { contractSpaceFromJson } from "@prisma-next/migration-tools/spaces";
 //#region migrations/20260601T0000_install_vector_extension/migration.json
 var migration_default = {

package/dist/{descriptor-meta-G5zBc8J8.mjs → descriptor-meta-DMPKzaNe.mjs}

@@ -1,4 +1,4 @@
-import { n as VECTOR_MAX_DIM, t as VECTOR_CODEC_ID } from "./constants-D8Ccy-f4.mjs";
+import { n as VECTOR_CODEC_ID, r as VECTOR_MAX_DIM, t as pgVectorError } from "./errors-BnZLl-sM.mjs";
 import { buildOperation, codecOf, toExpr } from "@prisma-next/sql-relational-core/expression";
 import { buildCodecDescriptorRegistry } from "@prisma-next/sql-relational-core/codec-descriptor-registry";
 import { CodecDescriptorImpl, CodecImpl } from "@prisma-next/framework-components/codec";
@@ -32,11 +32,23 @@ const vectorParamsSchema = type({ length: "number" }).narrow((params, ctx) => {
 });
 const PG_VECTOR_META = { db: { sql: { postgres: { nativeType: "vector" } } } };
 function parseVector(value) {
-	if (!value.startsWith("[") || !value.endsWith("]")) throw new Error(`Invalid vector format: expected "[...]", got "${value}"`);
+	if (!value.startsWith("[") || !value.endsWith("]")) throw pgVectorError("RUNTIME.DECODE_FAILED", `Invalid vector format: expected "[...]", got "${value}"`, {
+		why: "The database returned a vector value that is not in the PostgreSQL \"[x,y,z]\" text format.",
+		meta: {
+			codecId: VECTOR_CODEC_ID,
+			wirePreview: value
+		}
+	});
 	const content = value.slice(1, -1).trim();
 	return content === "" ? [] : content.split(",").map((entry) => {
 		const number = Number.parseFloat(entry.trim());
-		if (Number.isNaN(number)) throw new Error(`Invalid vector value: "${entry}" is not a number`);
+		if (Number.isNaN(number)) throw pgVectorError("RUNTIME.DECODE_FAILED", `Invalid vector value: "${entry}" is not a number`, {
+			why: "A vector entry returned by the database could not be parsed as a number.",
+			meta: {
+				codecId: VECTOR_CODEC_ID,
+				wirePreview: value
+			}
+		});
 		return number;
 	});
 }
@@ -46,32 +58,42 @@ var PgVectorCodec = class extends CodecImpl {
 		super(descriptor);
 		this.length = length;
 	}
-	assertVector(value) {
-		if (!Array.isArray(value)) throw new Error("Vector value must be an array of numbers");
+	assertVector(value, code) {
+		const meta = {
+			codecId: VECTOR_CODEC_ID,
+			expectedLength: this.length
+		};
+		if (!Array.isArray(value)) throw pgVectorError(code, "Vector value must be an array of numbers", { meta });
 		for (const element of value) {
-			if (typeof element !== "number") throw new Error("Vector value must contain only numbers");
-			if (!Number.isFinite(element)) throw new Error("Vector value must contain only finite numbers");
+			if (typeof element !== "number") throw pgVectorError(code, "Vector value must contain only numbers", { meta });
+			if (!Number.isFinite(element)) throw pgVectorError(code, "Vector value must contain only finite numbers", { meta });
 		}
-		if (value.length !== this.length) throw new Error(`Vector length mismatch: expected ${this.length}, got ${value.length}`);
+		if (value.length !== this.length) throw pgVectorError(code, `Vector length mismatch: expected ${this.length}, got ${value.length}`, {
+			why: `This column is declared as vector(${this.length}); every value must have exactly that many dimensions.`,
+			meta: {
+				...meta,
+				receivedLength: value.length
+			}
+		});
 	}
 	async encode(value, _ctx) {
-		this.assertVector(value);
+		this.assertVector(value, "RUNTIME.ENCODE_FAILED");
 		return `[${value.join(",")}]`;
 	}
 	async decode(wire, _ctx) {
-		if (typeof wire !== "string") throw new Error("Vector wire value must be a string");
+		if (typeof wire !== "string") throw pgVectorError("RUNTIME.DECODE_FAILED", "Vector wire value must be a string", { meta: { codecId: VECTOR_CODEC_ID } });
 		const value = parseVector(wire);
-		this.assertVector(value);
+		this.assertVector(value, "RUNTIME.DECODE_FAILED");
 		return value;
 	}
 	encodeJson(value) {
-		this.assertVector(value);
+		this.assertVector(value, "RUNTIME.ENCODE_FAILED");
 		return `[${value.join(",")}]`;
 	}
 	decodeJson(json) {
-		if (typeof json !== "string") throw new Error("Vector database JSON value must be a string");
+		if (typeof json !== "string") throw pgVectorError("RUNTIME.DECODE_FAILED", "Vector database JSON value must be a string", { meta: { codecId: VECTOR_CODEC_ID } });
 		const value = parseVector(json);
-		this.assertVector(value);
+		this.assertVector(value, "RUNTIME.DECODE_FAILED");
 		return value;
 	}
 };
@@ -185,4 +207,4 @@ const pgvectorPackMeta = {
 //#endregion
 export { pgvectorQueryOperations as n, pgvectorCodecRegistry as r, pgvectorPackMeta as t };
 
-//# sourceMappingURL=descriptor-meta-G5zBc8J8.mjs.map
+//# sourceMappingURL=descriptor-meta-DMPKzaNe.mjs.map

package/dist/descriptor-meta-DMPKzaNe.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor-meta-DMPKzaNe.mjs","names":["arktype"],"sources":["../src/core/authoring.ts","../src/core/codecs.ts","../src/core/registry.ts","../src/core/descriptor-meta.ts"],"sourcesContent":["import type { AuthoringTypeNamespace } from '@prisma-next/framework-components/authoring';\nimport { VECTOR_MAX_DIM } from './constants';\n\nexport const pgvectorAuthoringTypes = {\n  pgvector: {\n    Vector: {\n      kind: 'typeConstructor',\n      args: [\n        { kind: 'number', name: 'length', integer: true, minimum: 1, maximum: VECTOR_MAX_DIM },\n      ],\n      output: {\n        codecId: 'pg/vector@1',\n        nativeType: 'vector',\n        typeParams: {\n          length: { kind: 'arg', index: 0 },\n        },\n      },\n    },\n  },\n} as const satisfies AuthoringTypeNamespace;\n","/**\n * pgvector extension codec.\n *\n * Mirrors the patterns in `postgres/codecs-class.ts` and `sqlite/codecs-class.ts` for the single `pg/vector@1` codec. Three artifacts:\n *\n * 1. `PgVectorCodec` extends {@link CodecImpl} with the runtime encode/decode/encodeJson/decodeJson conversions inline. Conversions are simple enough (PostgreSQL `[1,2,3]` text format) that no shared helper module is warranted; the class body is the source of truth.\n * 2. `PgVectorDescriptor` extends {@link CodecDescriptorImpl} with the codec id, traits, target types, params schema (`{ length: number }`, validated against {@link VECTOR_MAX_DIM}), `meta` (postgres `nativeType: 'vector'`), and the emit-path `renderOutputType` producing `Vector<${length}>`.\n * 3. `pgVectorColumn(length)` per-codec column helper invoking `descriptor.factory({ length })` directly + passing the bare `nativeType: 'vector'`. The family-layer {@link expandNativeType} hook renders the parameterized form (`vector(1536)`) at emit/verify time from `nativeType` + `typeParams`.\n *\n * `length` threads into the runtime codec via the constructor so encode/decode/encodeJson/decodeJson enforce the declared dimension at every ingress path. Without this, `vector(3)` and `vector(1536)` would produce codecs with identical behaviour and a dimension-mismatched value would round-trip undetected.\n */\n\nimport type { JsonValue } from '@prisma-next/contract/types';\nimport {\n  type AnyCodecDescriptor,\n  type CodecCallContext,\n  CodecDescriptorImpl,\n  CodecImpl,\n  type CodecInstanceContext,\n  type ColumnHelperFor,\n  type ColumnHelperForStrict,\n  column,\n} from '@prisma-next/framework-components/codec';\nimport type { ExtractCodecTypes } from '@prisma-next/sql-relational-core/ast';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { type as arktype } from 'arktype';\nimport { VECTOR_CODEC_ID, VECTOR_MAX_DIM } from './constants';\nimport { pgVectorError } from './errors';\n\ntype VectorConversionCode = 'RUNTIME.ENCODE_FAILED' | 'RUNTIME.DECODE_FAILED';\n\ntype VectorParams = { readonly length: number };\n\nconst vectorParamsSchema = arktype({\n  length: 'number',\n}).narrow((params, ctx) => {\n  const { length } = params;\n  if (!Number.isInteger(length)) {\n    return ctx.mustBe('an integer');\n  }\n  if (length < 1 || length > VECTOR_MAX_DIM) {\n    return ctx.mustBe(`in the range [1, ${VECTOR_MAX_DIM}]`);\n  }\n  return true;\n}) satisfies StandardSchemaV1<VectorParams>;\n\nconst PG_VECTOR_META = { db: { sql: { postgres: { nativeType: 'vector' } } } } as const;\n\nfunction parseVector(value: string): number[] {\n  if (!value.startsWith('[') || !value.endsWith(']')) {\n    throw pgVectorError(\n      'RUNTIME.DECODE_FAILED',\n      `Invalid vector format: expected \"[...]\", got \"${value}\"`,\n      {\n        why: 'The database returned a vector value that is not in the PostgreSQL \"[x,y,z]\" text format.',\n        meta: { codecId: VECTOR_CODEC_ID, wirePreview: value },\n      },\n    );\n  }\n  const content = value.slice(1, -1).trim();\n  return content === ''\n    ? []\n    : content.split(',').map((entry) => {\n        const number = Number.parseFloat(entry.trim());\n        if (Number.isNaN(number)) {\n          throw pgVectorError(\n            'RUNTIME.DECODE_FAILED',\n            `Invalid vector value: \"${entry}\" is not a number`,\n            {\n              why: 'A vector entry returned by the database could not be parsed as a number.',\n              meta: { codecId: VECTOR_CODEC_ID, wirePreview: value },\n            },\n          );\n        }\n        return number;\n      });\n}\n\nexport class PgVectorCodec extends CodecImpl<\n  typeof VECTOR_CODEC_ID,\n  readonly ['equality'],\n  string,\n  number[]\n> {\n  readonly length: number;\n\n  constructor(descriptor: AnyCodecDescriptor, length: number) {\n    super(descriptor);\n    this.length = length;\n  }\n\n  assertVector(value: unknown, code: VectorConversionCode): asserts value is number[] {\n    const meta = { codecId: VECTOR_CODEC_ID, expectedLength: this.length };\n    if (!Array.isArray(value)) {\n      throw pgVectorError(code, 'Vector value must be an array of numbers', { meta });\n    }\n    for (const element of value) {\n      if (typeof element !== 'number') {\n        throw pgVectorError(code, 'Vector value must contain only numbers', { meta });\n      }\n      if (!Number.isFinite(element)) {\n        throw pgVectorError(code, 'Vector value must contain only finite numbers', { meta });\n      }\n    }\n    if (value.length !== this.length) {\n      throw pgVectorError(\n        code,\n        `Vector length mismatch: expected ${this.length}, got ${value.length}`,\n        {\n          why: `This column is declared as vector(${this.length}); every value must have exactly that many dimensions.`,\n          meta: { ...meta, receivedLength: value.length },\n        },\n      );\n    }\n  }\n\n  async encode(value: number[], _ctx: CodecCallContext): Promise<string> {\n    this.assertVector(value, 'RUNTIME.ENCODE_FAILED');\n    return `[${value.join(',')}]`;\n  }\n\n  async decode(wire: string, _ctx: CodecCallContext): Promise<number[]> {\n    if (typeof wire !== 'string') {\n      throw pgVectorError('RUNTIME.DECODE_FAILED', 'Vector wire value must be a string', {\n        meta: { codecId: VECTOR_CODEC_ID },\n      });\n    }\n    const value = parseVector(wire);\n    this.assertVector(value, 'RUNTIME.DECODE_FAILED');\n    return value;\n  }\n\n  encodeJson(value: number[]): JsonValue {\n    this.assertVector(value, 'RUNTIME.ENCODE_FAILED');\n    return `[${value.join(',')}]`;\n  }\n\n  decodeJson(json: JsonValue): number[] {\n    if (typeof json !== 'string') {\n      throw pgVectorError('RUNTIME.DECODE_FAILED', 'Vector database JSON value must be a string', {\n        meta: { codecId: VECTOR_CODEC_ID },\n      });\n    }\n    const value = parseVector(json);\n    this.assertVector(value, 'RUNTIME.DECODE_FAILED');\n    return value;\n  }\n}\n\nexport class PgVectorDescriptor extends CodecDescriptorImpl<VectorParams> {\n  override readonly codecId = VECTOR_CODEC_ID;\n  override readonly traits = ['equality'] as const;\n  override readonly targetTypes = ['vector'] as const;\n  override readonly meta = PG_VECTOR_META;\n  override readonly paramsSchema: StandardSchemaV1<VectorParams> = vectorParamsSchema;\n  override renderOutputType(params: VectorParams): string {\n    return `Vector<${params.length}>`;\n  }\n  override factory(params: VectorParams): (ctx: CodecInstanceContext) => PgVectorCodec {\n    return () => new PgVectorCodec(this, params.length);\n  }\n}\n\nexport const pgVectorDescriptor = new PgVectorDescriptor();\n\n/**\n * Per-codec column helper for `pg/vector@1`. Generic over `N extends number` so the column site preserves the dimension literal in `typeParams` (e.g. `pgVectorColumn(1536)` packs `typeParams: { length: 1536 }`).\n *\n * Passes the bare `nativeType: 'vector'`; the family-layer `expandNativeType` hook renders the parameterized form (`vector(1536)`) at emit/verify time from `nativeType` + `typeParams`.\n */\nexport const pgVectorColumn = <N extends number>(length: N) =>\n  column(pgVectorDescriptor.factory({ length }), pgVectorDescriptor.codecId, { length }, 'vector');\n\npgVectorColumn satisfies ColumnHelperFor<PgVectorDescriptor>;\npgVectorColumn satisfies ColumnHelperForStrict<PgVectorDescriptor>;\n\nconst codecDescriptorMap = {\n  vector: pgVectorDescriptor,\n} as const;\n\nexport type CodecTypes = ExtractCodecTypes<typeof codecDescriptorMap>;\n\nexport const codecDescriptors: readonly AnyCodecDescriptor[] = Object.values(codecDescriptorMap);\n","import { buildCodecDescriptorRegistry } from '@prisma-next/sql-relational-core/codec-descriptor-registry';\nimport type { CodecDescriptorRegistry } from '@prisma-next/sql-relational-core/query-lane-context';\nimport { codecDescriptors } from './codecs';\n\n/**\n * Registry of every codec descriptor shipped by `@prisma-next/extension-pgvector`.\n *\n * Public consumer surface for the pgvector codec set. Currently a single entry (`pg/vector@1`); the registry shape stays consistent with the other codec-shipping packages so consumers don't need to special-case extensions. See ADR 208.\n */\nexport const pgvectorCodecRegistry: CodecDescriptorRegistry =\n  buildCodecDescriptorRegistry(codecDescriptors);\n","import {\n  buildOperation,\n  type CodecExpression,\n  codecOf,\n  type Expression,\n  toExpr,\n} from '@prisma-next/sql-relational-core/expression';\nimport type { CodecTypes } from '../types/codec-types';\nimport type { QueryOperationTypes } from '../types/operation-types';\nimport { pgvectorAuthoringTypes } from './authoring';\nimport { pgvectorCodecRegistry } from './registry';\n\nconst pgvectorTypeId = 'pg/vector@1' as const;\n\ntype CodecTypesBase = Record<string, { readonly input: unknown; readonly output: unknown }>;\n\nexport function pgvectorQueryOperations<CT extends CodecTypesBase>(): QueryOperationTypes<CT> {\n  return {\n    cosineDistance: {\n      self: { codecId: pgvectorTypeId },\n      impl: (\n        self: CodecExpression<'pg/vector@1', boolean, CT>,\n        other: CodecExpression<'pg/vector@1', boolean, CT>,\n      ): Expression<{ codecId: 'pg/float8@1'; nullable: false }> => {\n        const selfCodec = codecOf(self);\n        return buildOperation({\n          method: 'cosineDistance',\n          args: [toExpr(self, selfCodec), toExpr(other, selfCodec)],\n          returns: { codecId: 'pg/float8@1', nullable: false },\n          lowering: {\n            targetFamily: 'sql',\n            strategy: 'function',\n            template: '{{self}} <=> {{arg0}}',\n          },\n        });\n      },\n    },\n    cosineSimilarity: {\n      self: { codecId: pgvectorTypeId },\n      impl: (\n        self: CodecExpression<'pg/vector@1', boolean, CT>,\n        other: CodecExpression<'pg/vector@1', boolean, CT>,\n      ): Expression<{ codecId: 'pg/float8@1'; nullable: false }> => {\n        const selfCodec = codecOf(self);\n        return buildOperation({\n          method: 'cosineSimilarity',\n          args: [toExpr(self, selfCodec), toExpr(other, selfCodec)],\n          returns: { codecId: 'pg/float8@1', nullable: false },\n          lowering: {\n            targetFamily: 'sql',\n            strategy: 'function',\n            template: '1 - ({{self}} <=> {{arg0}})',\n          },\n        });\n      },\n    },\n  };\n}\n\nconst pgvectorPackMetaBase = {\n  kind: 'extension',\n  id: 'pgvector',\n  familyId: 'sql',\n  targetId: 'postgres',\n  version: '0.0.1',\n  capabilities: {\n    postgres: {\n      'pgvector.cosine': true,\n    },\n  },\n  authoring: {\n    type: pgvectorAuthoringTypes,\n  },\n  types: {\n    codecTypes: {\n      codecDescriptors: Array.from(pgvectorCodecRegistry.values()),\n      import: {\n        package: '@prisma-next/extension-pgvector/codec-types',\n        named: 'CodecTypes',\n        alias: 'PgVectorTypes',\n      },\n      typeImports: [\n        {\n          package: '@prisma-next/extension-pgvector/codec-types',\n          named: 'Vector',\n          alias: 'Vector',\n        },\n      ],\n    },\n    operationTypes: {\n      import: {\n        package: '@prisma-next/extension-pgvector/operation-types',\n        named: 'OperationTypes',\n        alias: 'PgVectorOperationTypes',\n      },\n    },\n    queryOperationTypes: {\n      import: {\n        package: '@prisma-next/extension-pgvector/operation-types',\n        named: 'QueryOperationTypes',\n        alias: 'PgVectorQueryOperationTypes',\n      },\n    },\n    storage: [\n      { typeId: pgvectorTypeId, familyId: 'sql', targetId: 'postgres', nativeType: 'vector' },\n    ],\n  },\n} as const;\n\nexport const pgvectorPackMeta: typeof pgvectorPackMetaBase & {\n  readonly __codecTypes?: CodecTypes;\n} = pgvectorPackMetaBase;\n"],"mappings":"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"}

package/dist/errors-BnZLl-sM.mjs

@@ -0,0 +1,19 @@
+import { structuredError } from "@prisma-next/utils/structured-error";
+//#region src/core/constants.ts
+/**
+* Codec ID for pgvector's vector type.
+*/
+const VECTOR_CODEC_ID = "pg/vector@1";
+/**
+* Maximum dimension for pgvector vectors (VECTOR_MAX_DIM from pgvector).
+*/
+const VECTOR_MAX_DIM = 16e3;
+//#endregion
+//#region src/core/errors.ts
+function pgVectorError(code, message, options) {
+	return structuredError(code, message, options);
+}
+//#endregion
+export { VECTOR_CODEC_ID as n, VECTOR_MAX_DIM as r, pgVectorError as t };
+
+//# sourceMappingURL=errors-BnZLl-sM.mjs.map

package/dist/errors-BnZLl-sM.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-BnZLl-sM.mjs","names":[],"sources":["../src/core/constants.ts","../src/core/errors.ts"],"sourcesContent":["/**\n * Codec ID for pgvector's vector type.\n */\nexport const VECTOR_CODEC_ID = 'pg/vector@1' as const;\n\n/**\n * Maximum dimension for pgvector vectors (VECTOR_MAX_DIM from pgvector).\n */\nexport const VECTOR_MAX_DIM = 16000;\n","import type { StructuredError, StructuredErrorOptions } from '@prisma-next/utils/structured-error';\nimport { structuredError } from '@prisma-next/utils/structured-error';\n\nexport type PgVectorErrorCode =\n  | 'RUNTIME.ENCODE_FAILED'\n  | 'RUNTIME.DECODE_FAILED'\n  | 'CONTRACT.ARGUMENT_INVALID';\n\nexport function pgVectorError(\n  code: PgVectorErrorCode,\n  message: string,\n  options?: StructuredErrorOptions,\n): StructuredError {\n  return structuredError(code, message, options);\n}\n"],"mappings":";;;;;AAGA,MAAa,kBAAkB;;;;AAK/B,MAAa,iBAAiB;;;ACA9B,SAAgB,cACd,MACA,SACA,SACiB;CACjB,OAAO,gBAAgB,MAAM,SAAS,OAAO;AAC/C"}

package/dist/pack.d.mts

@@ -1,4 +1,4 @@
-import { t as CodecTypes } from "./codec-types-CEqpE2q2.mjs";
+import { t as CodecTypes } from "./codec-types-eUx62rq4.mjs";
 import "./operation-types-CenOz3DU.mjs";
 //#region src/core/descriptor-meta.d.ts
 declare const pgvectorPackMetaBase: {

package/dist/pack.mjs

@@ -1,2 +1,2 @@
-import { t as pgvectorPackMeta } from "./descriptor-meta-G5zBc8J8.mjs";
+import { t as pgvectorPackMeta } from "./descriptor-meta-DMPKzaNe.mjs";
 export { pgvectorPackMeta as default };

package/dist/runtime.mjs

@@ -1,4 +1,4 @@
-import { n as pgvectorQueryOperations, r as pgvectorCodecRegistry, t as pgvectorPackMeta } from "./descriptor-meta-G5zBc8J8.mjs";
+import { n as pgvectorQueryOperations, r as pgvectorCodecRegistry, t as pgvectorPackMeta } from "./descriptor-meta-DMPKzaNe.mjs";
 //#region src/exports/runtime.ts
 const pgvectorRuntimeDescriptor = {
 	kind: "extension",

package/package.json

@@ -1,39 +1,40 @@
 {
   "name": "@prisma-next/extension-pgvector",
-  "version": "0.16.0-dev.25",
+  "version": "0.16.0-dev.27",
   "license": "Apache-2.0",
   "type": "module",
   "sideEffects": false,
   "dependencies": {
-    "@prisma-next/contract": "0.16.0-dev.25",
-    "@prisma-next/contract-authoring": "0.16.0-dev.25",
-    "@prisma-next/family-sql": "0.16.0-dev.25",
-    "@prisma-next/framework-components": "0.16.0-dev.25",
-    "@prisma-next/migration-tools": "0.16.0-dev.25",
-    "@prisma-next/sql-contract": "0.16.0-dev.25",
-    "@prisma-next/sql-operations": "0.16.0-dev.25",
-    "@prisma-next/sql-relational-core": "0.16.0-dev.25",
-    "@prisma-next/sql-runtime": "0.16.0-dev.25",
-    "@prisma-next/sql-schema-ir": "0.16.0-dev.25",
+    "@prisma-next/contract": "0.16.0-dev.27",
+    "@prisma-next/contract-authoring": "0.16.0-dev.27",
+    "@prisma-next/family-sql": "0.16.0-dev.27",
+    "@prisma-next/framework-components": "0.16.0-dev.27",
+    "@prisma-next/migration-tools": "0.16.0-dev.27",
+    "@prisma-next/sql-contract": "0.16.0-dev.27",
+    "@prisma-next/sql-operations": "0.16.0-dev.27",
+    "@prisma-next/sql-relational-core": "0.16.0-dev.27",
+    "@prisma-next/sql-runtime": "0.16.0-dev.27",
+    "@prisma-next/sql-schema-ir": "0.16.0-dev.27",
+    "@prisma-next/utils": "0.16.0-dev.27",
     "@standard-schema/spec": "^1.1.0",
     "arktype": "^2.2.2"
   },
   "devDependencies": {
-    "@prisma-next/adapter-postgres": "0.16.0-dev.25",
-    "@prisma-next/cli": "0.16.0-dev.25",
-    "@prisma-next/operations": "0.16.0-dev.25",
-    "@prisma-next/postgres": "0.16.0-dev.25",
-    "@prisma-next/sql-contract-ts": "0.16.0-dev.25",
-    "@prisma-next/target-postgres": "0.16.0-dev.25",
-    "@prisma-next/test-utils": "0.16.0-dev.25",
-    "@prisma-next/tsconfig": "0.16.0-dev.25",
-    "@prisma-next/tsdown": "0.16.0-dev.25",
+    "@prisma-next/adapter-postgres": "0.16.0-dev.27",
+    "@prisma-next/cli": "0.16.0-dev.27",
+    "@prisma-next/operations": "0.16.0-dev.27",
+    "@prisma-next/postgres": "0.16.0-dev.27",
+    "@prisma-next/sql-contract-ts": "0.16.0-dev.27",
+    "@prisma-next/target-postgres": "0.16.0-dev.27",
+    "@prisma-next/test-utils": "0.16.0-dev.27",
+    "@prisma-next/tsconfig": "0.16.0-dev.27",
+    "@prisma-next/tsdown": "0.16.0-dev.27",
     "tsdown": "0.22.8",
     "typescript": "5.9.3",
     "vitest": "4.1.10"
   },
   "peerDependencies": {
-    "@prisma-next/adapter-postgres": "0.16.0-dev.25",
+    "@prisma-next/adapter-postgres": "0.16.0-dev.27",
     "typescript": ">=5.9"
   },
   "peerDependenciesMeta": {

package/src/core/codecs.ts

@@ -25,6 +25,9 @@ import type { ExtractCodecTypes } from '@prisma-next/sql-relational-core/ast';
 import type { StandardSchemaV1 } from '@standard-schema/spec';
 import { type as arktype } from 'arktype';
 import { VECTOR_CODEC_ID, VECTOR_MAX_DIM } from './constants';
+import { pgVectorError } from './errors';
+
+type VectorConversionCode = 'RUNTIME.ENCODE_FAILED' | 'RUNTIME.DECODE_FAILED';
 
 type VectorParams = { readonly length: number };
 
@@ -45,7 +48,14 @@ const PG_VECTOR_META = { db: { sql: { postgres: { nativeType: 'vector' } } } } a
 
 function parseVector(value: string): number[] {
   if (!value.startsWith('[') || !value.endsWith(']')) {
-    throw new Error(`Invalid vector format: expected "[...]", got "${value}"`);
+    throw pgVectorError(
+      'RUNTIME.DECODE_FAILED',
+      `Invalid vector format: expected "[...]", got "${value}"`,
+      {
+        why: 'The database returned a vector value that is not in the PostgreSQL "[x,y,z]" text format.',
+        meta: { codecId: VECTOR_CODEC_ID, wirePreview: value },
+      },
+    );
   }
   const content = value.slice(1, -1).trim();
   return content === ''
@@ -53,7 +63,14 @@ function parseVector(value: string): number[] {
     : content.split(',').map((entry) => {
         const number = Number.parseFloat(entry.trim());
         if (Number.isNaN(number)) {
-          throw new Error(`Invalid vector value: "${entry}" is not a number`);
+          throw pgVectorError(
+            'RUNTIME.DECODE_FAILED',
+            `Invalid vector value: "${entry}" is not a number`,
+            {
+              why: 'A vector entry returned by the database could not be parsed as a number.',
+              meta: { codecId: VECTOR_CODEC_ID, wirePreview: value },
+            },
+          );
         }
         return number;
       });
@@ -72,48 +89,60 @@ export class PgVectorCodec extends CodecImpl<
     this.length = length;
   }
 
-  assertVector(value: unknown): asserts value is number[] {
+  assertVector(value: unknown, code: VectorConversionCode): asserts value is number[] {
+    const meta = { codecId: VECTOR_CODEC_ID, expectedLength: this.length };
     if (!Array.isArray(value)) {
-      throw new Error('Vector value must be an array of numbers');
+      throw pgVectorError(code, 'Vector value must be an array of numbers', { meta });
     }
     for (const element of value) {
       if (typeof element !== 'number') {
-        throw new Error('Vector value must contain only numbers');
+        throw pgVectorError(code, 'Vector value must contain only numbers', { meta });
       }
       if (!Number.isFinite(element)) {
-        throw new Error('Vector value must contain only finite numbers');
+        throw pgVectorError(code, 'Vector value must contain only finite numbers', { meta });
       }
     }
     if (value.length !== this.length) {
-      throw new Error(`Vector length mismatch: expected ${this.length}, got ${value.length}`);
+      throw pgVectorError(
+        code,
+        `Vector length mismatch: expected ${this.length}, got ${value.length}`,
+        {
+          why: `This column is declared as vector(${this.length}); every value must have exactly that many dimensions.`,
+          meta: { ...meta, receivedLength: value.length },
+        },
+      );
     }
   }
 
   async encode(value: number[], _ctx: CodecCallContext): Promise<string> {
-    this.assertVector(value);
+    this.assertVector(value, 'RUNTIME.ENCODE_FAILED');
     return `[${value.join(',')}]`;
   }
 
   async decode(wire: string, _ctx: CodecCallContext): Promise<number[]> {
     if (typeof wire !== 'string') {
-      throw new Error('Vector wire value must be a string');
+      throw pgVectorError('RUNTIME.DECODE_FAILED', 'Vector wire value must be a string', {
+        meta: { codecId: VECTOR_CODEC_ID },
+      });
     }
     const value = parseVector(wire);
-    this.assertVector(value);
+    this.assertVector(value, 'RUNTIME.DECODE_FAILED');
     return value;
   }
 
   encodeJson(value: number[]): JsonValue {
-    this.assertVector(value);
+    this.assertVector(value, 'RUNTIME.ENCODE_FAILED');
     return `[${value.join(',')}]`;
   }
 
   decodeJson(json: JsonValue): number[] {
     if (typeof json !== 'string') {
-      throw new Error('Vector database JSON value must be a string');
+      throw pgVectorError('RUNTIME.DECODE_FAILED', 'Vector database JSON value must be a string', {
+        meta: { codecId: VECTOR_CODEC_ID },
+      });
     }
     const value = parseVector(json);
-    this.assertVector(value);
+    this.assertVector(value, 'RUNTIME.DECODE_FAILED');
     return value;
   }
 }

package/src/core/errors.ts

@@ -0,0 +1,15 @@
+import type { StructuredError, StructuredErrorOptions } from '@prisma-next/utils/structured-error';
+import { structuredError } from '@prisma-next/utils/structured-error';
+
+export type PgVectorErrorCode =
+  | 'RUNTIME.ENCODE_FAILED'
+  | 'RUNTIME.DECODE_FAILED'
+  | 'CONTRACT.ARGUMENT_INVALID';
+
+export function pgVectorError(
+  code: PgVectorErrorCode,
+  message: string,
+  options?: StructuredErrorOptions,
+): StructuredError {
+  return structuredError(code, message, options);
+}

package/src/exports/column-types.ts

@@ -4,6 +4,7 @@
 
 import type { ColumnTypeDescriptor } from '@prisma-next/framework-components/codec';
 import { VECTOR_CODEC_ID, VECTOR_MAX_DIM } from '../core/constants';
+import { pgVectorError } from '../core/errors';
 
 /**
  * Factory for creating dimensioned vector column descriptors.
@@ -15,14 +16,23 @@ import { VECTOR_CODEC_ID, VECTOR_MAX_DIM } from '../core/constants';
  * ```
  * @param length - The dimension of the vector (e.g., 1536 for OpenAI embeddings)
  * @returns A column type descriptor with `typeParams.length` set
- * @throws {RangeError} If length is not an integer in the range [1, VECTOR_MAX_DIM]
+ * @throws `CONTRACT.ARGUMENT_INVALID` if length is not an integer in the range [1, VECTOR_MAX_DIM]
  */
 export function vector<N extends number>(
   length: N,
 ): ColumnTypeDescriptor & { readonly typeParams: { readonly length: N } } {
   if (!Number.isInteger(length) || length < 1 || length > VECTOR_MAX_DIM) {
-    throw new RangeError(
+    throw pgVectorError(
+      'CONTRACT.ARGUMENT_INVALID',
       `pgvector: dimension must be an integer in [1, ${VECTOR_MAX_DIM}], got ${length}`,
+      {
+        fix: `Pass an integer dimension between 1 and ${VECTOR_MAX_DIM}, e.g. vector(1536).`,
+        meta: {
+          helperPath: 'vector',
+          expected: `an integer in [1, ${VECTOR_MAX_DIM}]`,
+          received: length,
+        },
+      },
     );
   }
   return {

package/dist/codec-types-CEqpE2q2.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"codec-types-CEqpE2q2.d.mts","names":[],"sources":["../src/core/constants.ts","../src/core/codecs.ts","../src/types/codec-types.ts"],"mappings":";;;;;;;;cAGa;;;KCyBR;WAA0B;;cAiClB,sBAAsB,iBAC1B;WAKE;cAEG,YAAY,oBAAoB;EAK5C,aAAa,yBAAyB;EAiBhC,OAAO,iBAAiB,MAAM,mBAAmB;EAKjD,OAAO,cAAc,MAAM,mBAAmB;EASpD,WAAW,kBAAkB;EAK7B,WAAW,MAAM;;cAUN,2BAA2B,oBAAoB;WACxC;WACA;WACA;WACA;;;;;;;;;WACA,cAAc,iBAAiB;EACxC,iBAAiB,QAAQ;EAGzB,QAAQ,QAAQ,gBAAgB,KAAK,yBAAyB;;cAkBnE;mBAAA;;KAIM,eAAa,yBAAyB;;;;;;;;;KCtItC,OAAO;WAAmD,iBAAiB;;KAE3E,aAAa"}

package/dist/constants-D8Ccy-f4.mjs

@@ -1,13 +0,0 @@
-//#region src/core/constants.ts
-/**
-* Codec ID for pgvector's vector type.
-*/
-const VECTOR_CODEC_ID = "pg/vector@1";
-/**
-* Maximum dimension for pgvector vectors (VECTOR_MAX_DIM from pgvector).
-*/
-const VECTOR_MAX_DIM = 16e3;
-//#endregion
-export { VECTOR_MAX_DIM as n, VECTOR_CODEC_ID as t };
-
-//# sourceMappingURL=constants-D8Ccy-f4.mjs.map

package/dist/constants-D8Ccy-f4.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants-D8Ccy-f4.mjs","names":[],"sources":["../src/core/constants.ts"],"sourcesContent":["/**\n * Codec ID for pgvector's vector type.\n */\nexport const VECTOR_CODEC_ID = 'pg/vector@1' as const;\n\n/**\n * Maximum dimension for pgvector vectors (VECTOR_MAX_DIM from pgvector).\n */\nexport const VECTOR_MAX_DIM = 16000;\n"],"mappings":";;;;AAGA,MAAa,kBAAkB;;;;AAK/B,MAAa,iBAAiB"}

package/dist/descriptor-meta-G5zBc8J8.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"descriptor-meta-G5zBc8J8.mjs","names":["arktype"],"sources":["../src/core/authoring.ts","../src/core/codecs.ts","../src/core/registry.ts","../src/core/descriptor-meta.ts"],"sourcesContent":["import type { AuthoringTypeNamespace } from '@prisma-next/framework-components/authoring';\nimport { VECTOR_MAX_DIM } from './constants';\n\nexport const pgvectorAuthoringTypes = {\n  pgvector: {\n    Vector: {\n      kind: 'typeConstructor',\n      args: [\n        { kind: 'number', name: 'length', integer: true, minimum: 1, maximum: VECTOR_MAX_DIM },\n      ],\n      output: {\n        codecId: 'pg/vector@1',\n        nativeType: 'vector',\n        typeParams: {\n          length: { kind: 'arg', index: 0 },\n        },\n      },\n    },\n  },\n} as const satisfies AuthoringTypeNamespace;\n","/**\n * pgvector extension codec.\n *\n * Mirrors the patterns in `postgres/codecs-class.ts` and `sqlite/codecs-class.ts` for the single `pg/vector@1` codec. Three artifacts:\n *\n * 1. `PgVectorCodec` extends {@link CodecImpl} with the runtime encode/decode/encodeJson/decodeJson conversions inline. Conversions are simple enough (PostgreSQL `[1,2,3]` text format) that no shared helper module is warranted; the class body is the source of truth.\n * 2. `PgVectorDescriptor` extends {@link CodecDescriptorImpl} with the codec id, traits, target types, params schema (`{ length: number }`, validated against {@link VECTOR_MAX_DIM}), `meta` (postgres `nativeType: 'vector'`), and the emit-path `renderOutputType` producing `Vector<${length}>`.\n * 3. `pgVectorColumn(length)` per-codec column helper invoking `descriptor.factory({ length })` directly + passing the bare `nativeType: 'vector'`. The family-layer {@link expandNativeType} hook renders the parameterized form (`vector(1536)`) at emit/verify time from `nativeType` + `typeParams`.\n *\n * `length` threads into the runtime codec via the constructor so encode/decode/encodeJson/decodeJson enforce the declared dimension at every ingress path. Without this, `vector(3)` and `vector(1536)` would produce codecs with identical behaviour and a dimension-mismatched value would round-trip undetected.\n */\n\nimport type { JsonValue } from '@prisma-next/contract/types';\nimport {\n  type AnyCodecDescriptor,\n  type CodecCallContext,\n  CodecDescriptorImpl,\n  CodecImpl,\n  type CodecInstanceContext,\n  type ColumnHelperFor,\n  type ColumnHelperForStrict,\n  column,\n} from '@prisma-next/framework-components/codec';\nimport type { ExtractCodecTypes } from '@prisma-next/sql-relational-core/ast';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { type as arktype } from 'arktype';\nimport { VECTOR_CODEC_ID, VECTOR_MAX_DIM } from './constants';\n\ntype VectorParams = { readonly length: number };\n\nconst vectorParamsSchema = arktype({\n  length: 'number',\n}).narrow((params, ctx) => {\n  const { length } = params;\n  if (!Number.isInteger(length)) {\n    return ctx.mustBe('an integer');\n  }\n  if (length < 1 || length > VECTOR_MAX_DIM) {\n    return ctx.mustBe(`in the range [1, ${VECTOR_MAX_DIM}]`);\n  }\n  return true;\n}) satisfies StandardSchemaV1<VectorParams>;\n\nconst PG_VECTOR_META = { db: { sql: { postgres: { nativeType: 'vector' } } } } as const;\n\nfunction parseVector(value: string): number[] {\n  if (!value.startsWith('[') || !value.endsWith(']')) {\n    throw new Error(`Invalid vector format: expected \"[...]\", got \"${value}\"`);\n  }\n  const content = value.slice(1, -1).trim();\n  return content === ''\n    ? []\n    : content.split(',').map((entry) => {\n        const number = Number.parseFloat(entry.trim());\n        if (Number.isNaN(number)) {\n          throw new Error(`Invalid vector value: \"${entry}\" is not a number`);\n        }\n        return number;\n      });\n}\n\nexport class PgVectorCodec extends CodecImpl<\n  typeof VECTOR_CODEC_ID,\n  readonly ['equality'],\n  string,\n  number[]\n> {\n  readonly length: number;\n\n  constructor(descriptor: AnyCodecDescriptor, length: number) {\n    super(descriptor);\n    this.length = length;\n  }\n\n  assertVector(value: unknown): asserts value is number[] {\n    if (!Array.isArray(value)) {\n      throw new Error('Vector value must be an array of numbers');\n    }\n    for (const element of value) {\n      if (typeof element !== 'number') {\n        throw new Error('Vector value must contain only numbers');\n      }\n      if (!Number.isFinite(element)) {\n        throw new Error('Vector value must contain only finite numbers');\n      }\n    }\n    if (value.length !== this.length) {\n      throw new Error(`Vector length mismatch: expected ${this.length}, got ${value.length}`);\n    }\n  }\n\n  async encode(value: number[], _ctx: CodecCallContext): Promise<string> {\n    this.assertVector(value);\n    return `[${value.join(',')}]`;\n  }\n\n  async decode(wire: string, _ctx: CodecCallContext): Promise<number[]> {\n    if (typeof wire !== 'string') {\n      throw new Error('Vector wire value must be a string');\n    }\n    const value = parseVector(wire);\n    this.assertVector(value);\n    return value;\n  }\n\n  encodeJson(value: number[]): JsonValue {\n    this.assertVector(value);\n    return `[${value.join(',')}]`;\n  }\n\n  decodeJson(json: JsonValue): number[] {\n    if (typeof json !== 'string') {\n      throw new Error('Vector database JSON value must be a string');\n    }\n    const value = parseVector(json);\n    this.assertVector(value);\n    return value;\n  }\n}\n\nexport class PgVectorDescriptor extends CodecDescriptorImpl<VectorParams> {\n  override readonly codecId = VECTOR_CODEC_ID;\n  override readonly traits = ['equality'] as const;\n  override readonly targetTypes = ['vector'] as const;\n  override readonly meta = PG_VECTOR_META;\n  override readonly paramsSchema: StandardSchemaV1<VectorParams> = vectorParamsSchema;\n  override renderOutputType(params: VectorParams): string {\n    return `Vector<${params.length}>`;\n  }\n  override factory(params: VectorParams): (ctx: CodecInstanceContext) => PgVectorCodec {\n    return () => new PgVectorCodec(this, params.length);\n  }\n}\n\nexport const pgVectorDescriptor = new PgVectorDescriptor();\n\n/**\n * Per-codec column helper for `pg/vector@1`. Generic over `N extends number` so the column site preserves the dimension literal in `typeParams` (e.g. `pgVectorColumn(1536)` packs `typeParams: { length: 1536 }`).\n *\n * Passes the bare `nativeType: 'vector'`; the family-layer `expandNativeType` hook renders the parameterized form (`vector(1536)`) at emit/verify time from `nativeType` + `typeParams`.\n */\nexport const pgVectorColumn = <N extends number>(length: N) =>\n  column(pgVectorDescriptor.factory({ length }), pgVectorDescriptor.codecId, { length }, 'vector');\n\npgVectorColumn satisfies ColumnHelperFor<PgVectorDescriptor>;\npgVectorColumn satisfies ColumnHelperForStrict<PgVectorDescriptor>;\n\nconst codecDescriptorMap = {\n  vector: pgVectorDescriptor,\n} as const;\n\nexport type CodecTypes = ExtractCodecTypes<typeof codecDescriptorMap>;\n\nexport const codecDescriptors: readonly AnyCodecDescriptor[] = Object.values(codecDescriptorMap);\n","import { buildCodecDescriptorRegistry } from '@prisma-next/sql-relational-core/codec-descriptor-registry';\nimport type { CodecDescriptorRegistry } from '@prisma-next/sql-relational-core/query-lane-context';\nimport { codecDescriptors } from './codecs';\n\n/**\n * Registry of every codec descriptor shipped by `@prisma-next/extension-pgvector`.\n *\n * Public consumer surface for the pgvector codec set. Currently a single entry (`pg/vector@1`); the registry shape stays consistent with the other codec-shipping packages so consumers don't need to special-case extensions. See ADR 208.\n */\nexport const pgvectorCodecRegistry: CodecDescriptorRegistry =\n  buildCodecDescriptorRegistry(codecDescriptors);\n","import {\n  buildOperation,\n  type CodecExpression,\n  codecOf,\n  type Expression,\n  toExpr,\n} from '@prisma-next/sql-relational-core/expression';\nimport type { CodecTypes } from '../types/codec-types';\nimport type { QueryOperationTypes } from '../types/operation-types';\nimport { pgvectorAuthoringTypes } from './authoring';\nimport { pgvectorCodecRegistry } from './registry';\n\nconst pgvectorTypeId = 'pg/vector@1' as const;\n\ntype CodecTypesBase = Record<string, { readonly input: unknown; readonly output: unknown }>;\n\nexport function pgvectorQueryOperations<CT extends CodecTypesBase>(): QueryOperationTypes<CT> {\n  return {\n    cosineDistance: {\n      self: { codecId: pgvectorTypeId },\n      impl: (\n        self: CodecExpression<'pg/vector@1', boolean, CT>,\n        other: CodecExpression<'pg/vector@1', boolean, CT>,\n      ): Expression<{ codecId: 'pg/float8@1'; nullable: false }> => {\n        const selfCodec = codecOf(self);\n        return buildOperation({\n          method: 'cosineDistance',\n          args: [toExpr(self, selfCodec), toExpr(other, selfCodec)],\n          returns: { codecId: 'pg/float8@1', nullable: false },\n          lowering: {\n            targetFamily: 'sql',\n            strategy: 'function',\n            template: '{{self}} <=> {{arg0}}',\n          },\n        });\n      },\n    },\n    cosineSimilarity: {\n      self: { codecId: pgvectorTypeId },\n      impl: (\n        self: CodecExpression<'pg/vector@1', boolean, CT>,\n        other: CodecExpression<'pg/vector@1', boolean, CT>,\n      ): Expression<{ codecId: 'pg/float8@1'; nullable: false }> => {\n        const selfCodec = codecOf(self);\n        return buildOperation({\n          method: 'cosineSimilarity',\n          args: [toExpr(self, selfCodec), toExpr(other, selfCodec)],\n          returns: { codecId: 'pg/float8@1', nullable: false },\n          lowering: {\n            targetFamily: 'sql',\n            strategy: 'function',\n            template: '1 - ({{self}} <=> {{arg0}})',\n          },\n        });\n      },\n    },\n  };\n}\n\nconst pgvectorPackMetaBase = {\n  kind: 'extension',\n  id: 'pgvector',\n  familyId: 'sql',\n  targetId: 'postgres',\n  version: '0.0.1',\n  capabilities: {\n    postgres: {\n      'pgvector.cosine': true,\n    },\n  },\n  authoring: {\n    type: pgvectorAuthoringTypes,\n  },\n  types: {\n    codecTypes: {\n      codecDescriptors: Array.from(pgvectorCodecRegistry.values()),\n      import: {\n        package: '@prisma-next/extension-pgvector/codec-types',\n        named: 'CodecTypes',\n        alias: 'PgVectorTypes',\n      },\n      typeImports: [\n        {\n          package: '@prisma-next/extension-pgvector/codec-types',\n          named: 'Vector',\n          alias: 'Vector',\n        },\n      ],\n    },\n    operationTypes: {\n      import: {\n        package: '@prisma-next/extension-pgvector/operation-types',\n        named: 'OperationTypes',\n        alias: 'PgVectorOperationTypes',\n      },\n    },\n    queryOperationTypes: {\n      import: {\n        package: '@prisma-next/extension-pgvector/operation-types',\n        named: 'QueryOperationTypes',\n        alias: 'PgVectorQueryOperationTypes',\n      },\n    },\n    storage: [\n      { typeId: pgvectorTypeId, familyId: 'sql', targetId: 'postgres', nativeType: 'vector' },\n    ],\n  },\n} as const;\n\nexport const pgvectorPackMeta: typeof pgvectorPackMetaBase & {\n  readonly __codecTypes?: CodecTypes;\n} = pgvectorPackMetaBase;\n"],"mappings":"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"}