@prisma-next/extension-pgvector 0.3.0-dev.5 → 0.3.0-dev.52

package/README.md

@@ -8,7 +8,7 @@ This extension pack adds support for the `vector` data type and vector similarit
 
 ## Responsibilities
 
-- **Vector Codec**: Provides codec for `pg/vector@1` type ID mapping to `number[]` JavaScript type
+- **Vector Codec**: Provides codec for `pg/vector@1` mapping to `number[]` at runtime, and a `Vector<N>` type for dimensioned typing in `contract.d.ts`
 - **Vector Operations**: Registers vector similarity operations (e.g., `cosineDistance`) for use in queries
 - **CLI Integration**: Provides extension descriptor for `prisma-next.config.ts` configuration
 - **Runtime Extension**: Registers codecs and operations at runtime for vector column operations
@@ -91,19 +91,22 @@ export const contract = defineContract<AllCodecTypes>()
 
 ### Runtime Setup
 
-Register the extension when creating your runtime context:
+Register the extension when creating your execution stack:
 
 ```typescript
-import { createRuntimeContext } from '@prisma-next/sql-runtime';
-import { createPostgresAdapter } from '@prisma-next/adapter-postgres/runtime';
+import { instantiateExecutionStack } from '@prisma-next/core-execution-plane/stack';
+import { createExecutionContext, createSqlExecutionStack } from '@prisma-next/sql-runtime';
+import postgresAdapter from '@prisma-next/adapter-postgres/runtime';
+import postgresTarget from '@prisma-next/target-postgres/runtime';
 import pgvector from '@prisma-next/extension-pgvector/runtime';
 
-const adapter = createPostgresAdapter();
-const context = createRuntimeContext({
-  contract,
-  adapter,
-  extensions: [pgvector()],
+const stack = createSqlExecutionStack({
+  target: postgresTarget,
+  adapter: postgresAdapter,
+  extensionPacks: [pgvector],
 });
+const context = createExecutionContext({ contract, stack });
+const stackInstance = instantiateExecutionStack(stack);
 ```
 
 ### Query Usage
@@ -135,12 +138,16 @@ type Row = ResultType<typeof plan>;
 
 ### Codec Types
 
-The extension provides a `CodecTypes` export mapping the `pg/vector@1` type ID to `number[]`:
+The extension provides:
+
+- `CodecTypes` mapping the `pg/vector@1` type ID to `number[]` (runtime representation)
+- `Vector<N>` type for dimensioned vector typing in emitted `contract.d.ts` and schema result types when the contract includes dimension metadata
 
 ```typescript
-import type { CodecTypes } from '@prisma-next/extension-pgvector/codec-types';
+import type { CodecTypes, Vector } from '@prisma-next/extension-pgvector/codec-types';
 
 // CodecTypes['pg/vector@1']['output'] = number[]
+// Vector<1536> is a branded number[] type used for dimensioned typing
 ```
 
 ### Operation Types

package/dist/codec-types.d.mts

@@ -0,0 +1,41 @@
+import * as _prisma_next_sql_relational_core_ast0 from "@prisma-next/sql-relational-core/ast";
+
+//#region src/core/codecs.d.ts
+
+/**
+ * Vector codec implementation for pgvector extension.
+ *
+ * Provides encoding/decoding for the `vector` PostgreSQL type.
+ * Wire format is a string like `[1,2,3]` (PostgreSQL vector text format).
+ */
+declare const codecs: _prisma_next_sql_relational_core_ast0.CodecDefBuilder<{} & Record<"vector", _prisma_next_sql_relational_core_ast0.Codec<"pg/vector@1", string, number[], Record<string, unknown>, unknown>>>;
+type CodecTypes$1 = typeof codecs.CodecTypes;
+//#endregion
+//#region src/types/codec-types.d.ts
+/**
+ * Type-level branded vector.
+ *
+ * The runtime values are plain number arrays, but parameterized column typing can
+ * carry the dimension at the type level (e.g. Vector<1536>).
+ */
+type Vector<N$1 extends number = number> = number[] & {
+  readonly __vectorLength?: N$1;
+};
+/**
+ * Codec types for pgvector.
+ *
+ * - Scalar output remains `number[]` (runtime representation).
+ * - `parameterizedOutput` enables lane typing to compute `Vector<N>` from column `typeParams`.
+ */
+type CodecTypes = CodecTypes$1 & {
+  readonly 'pg/vector@1': CodecTypes$1['pg/vector@1'] & {
+    readonly parameterizedOutput: <P extends {
+      readonly length: number;
+    }>(params: P) => P extends {
+      readonly length: infer N extends number;
+    } ? Vector<N> : Vector<number>;
+  };
+};
+//#endregion
+export { type CodecTypes, type Vector };
+//# sourceMappingURL=codec-types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codec-types.d.mts","names":[],"sources":["../src/core/codecs.ts","../src/types/codec-types.ts"],"sourcesContent":[],"mappings":";;;;;;;AA0DY;;;cAAN,MAAM,EAAA,qCAAA,CAAA,eAAA,CAAA,CAAA,CAAA,GAAA,MAAA,CAAA,QAAA,EAAA,qCAAA,CAAA,KAAA,CAAA,aAAA,EAAA,MAAA,EAAA,MAAA,EAAA,EAAA,MAAA,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,OAAA,CAAA,CAAA,CAAA;AC7BqD,KDoCrD,YAAA,GCpCqD,ODoCjC,MAAA,CAAO,UCpC0B;;;ADoCjE;;;;AChDA;AAQA;AAAyB,KARb,MAQa,CAAA,YAAA,MAAA,GAAA,MAAA,CAAA,GAAA,MAAA,EAAA,GAAA;EACC,SAAA,cAAA,CAAA,EAT6D,GAS7D;CAEZ;;;;;;;KAHF,UAAA,GAAa;0BACC;;;eAEZ,MACL;;QAAwD,OAAO,KAAK"}

package/dist/codec-types.mjs

@@ -0,0 +1 @@
+export {  };

package/dist/column-types.d.mts

@@ -0,0 +1,33 @@
+import { ColumnTypeDescriptor } from "@prisma-next/contract-authoring";
+
+//#region src/exports/column-types.d.ts
+
+/**
+ * Static vector column descriptor without dimension.
+ * Use `vector(N)` for dimensioned vectors that produce `vector(N)` DDL.
+ */
+declare const vectorColumn: {
+  readonly codecId: "pg/vector@1";
+  readonly nativeType: "vector";
+};
+/**
+ * Factory for creating dimensioned vector column descriptors.
+ *
+ * @example
+ * ```typescript
+ * .column('embedding', { type: vector(1536), nullable: false })
+ * // Produces: nativeType: 'vector(1536)', typeParams: { length: 1536 }
+ * ```
+ *
+ * @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]
+ */
+declare function vector<N extends number>(length: N): ColumnTypeDescriptor & {
+  readonly typeParams: {
+    readonly length: N;
+  };
+};
+//#endregion
+export { vector, vectorColumn };
+//# sourceMappingURL=column-types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"column-types.d.mts","names":[],"sources":["../src/exports/column-types.ts"],"sourcesContent":[],"mappings":";;;;;;;;cAca;;;;;;;;;;;;;;;;;iBAkBG,iCACN,IACP;;qBAAiE"}

package/dist/column-types.mjs

@@ -0,0 +1,36 @@
+import { n as VECTOR_MAX_DIM, t as VECTOR_CODEC_ID } from "./constants-BmZpaev5.mjs";
+
+//#region src/exports/column-types.ts
+/**
+* Static vector column descriptor without dimension.
+* Use `vector(N)` for dimensioned vectors that produce `vector(N)` DDL.
+*/
+const vectorColumn = {
+	codecId: VECTOR_CODEC_ID,
+	nativeType: "vector"
+};
+/**
+* Factory for creating dimensioned vector column descriptors.
+*
+* @example
+* ```typescript
+* .column('embedding', { type: vector(1536), nullable: false })
+* // Produces: nativeType: 'vector(1536)', typeParams: { length: 1536 }
+* ```
+*
+* @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]
+*/
+function vector(length) {
+	if (!Number.isInteger(length) || length < 1 || length > VECTOR_MAX_DIM) throw new RangeError(`pgvector: dimension must be an integer in [1, ${VECTOR_MAX_DIM}], got ${length}`);
+	return {
+		codecId: VECTOR_CODEC_ID,
+		nativeType: `vector(${length})`,
+		typeParams: { length }
+	};
+}
+
+//#endregion
+export { vector, vectorColumn };
+//# sourceMappingURL=column-types.mjs.map

package/dist/column-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-types.mjs","names":[],"sources":["../src/exports/column-types.ts"],"sourcesContent":["/**\n * Column type descriptors for pgvector extension.\n *\n * These descriptors provide both codecId and nativeType for use in contract authoring.\n * They are derived from the same source of truth as codec definitions and manifests.\n */\n\nimport type { ColumnTypeDescriptor } from '@prisma-next/contract-authoring';\nimport { VECTOR_CODEC_ID, VECTOR_MAX_DIM } from '../core/constants';\n\n/**\n * Static vector column descriptor without dimension.\n * Use `vector(N)` for dimensioned vectors that produce `vector(N)` DDL.\n */\nexport const vectorColumn = {\n  codecId: VECTOR_CODEC_ID,\n  nativeType: 'vector',\n} as const satisfies ColumnTypeDescriptor;\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(1536)', typeParams: { length: 1536 }\n * ```\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(${length})`,\n    typeParams: { length },\n  } as const;\n}\n"],"mappings":";;;;;;;AAcA,MAAa,eAAe;CAC1B,SAAS;CACT,YAAY;CACb;;;;;;;;;;;;;;AAeD,SAAgB,OACd,QACwE;AACxE,KAAI,CAAC,OAAO,UAAU,OAAO,IAAI,SAAS,KAAK,SAAS,eACtD,OAAM,IAAI,WACR,iDAAiD,eAAe,SAAS,SAC1E;AAEH,QAAO;EACL,SAAS;EACT,YAAY,UAAU,OAAO;EAC7B,YAAY,EAAE,QAAQ;EACvB"}

package/dist/constants-BmZpaev5.mjs

@@ -0,0 +1,13 @@
+//#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-BmZpaev5.mjs.map

package/dist/constants-BmZpaev5.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants-BmZpaev5.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/control.d.mts

@@ -0,0 +1,7 @@
+import { SqlControlExtensionDescriptor } from "@prisma-next/family-sql/control";
+
+//#region src/exports/control.d.ts
+declare const pgvectorExtensionDescriptor: SqlControlExtensionDescriptor<'postgres'>;
+//#endregion
+export { pgvectorExtensionDescriptor as default, pgvectorExtensionDescriptor };
+//# sourceMappingURL=control.d.mts.map

package/dist/control.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.d.mts","names":[],"sources":["../src/exports/control.ts"],"sourcesContent":[],"mappings":";;;cA0DM,6BAA6B"}

package/dist/control.mjs

@@ -0,0 +1,49 @@
+import { n as pgvectorPackMeta, t as pgvectorOperationSignature } from "./descriptor-meta-BADTQp0u.mjs";
+
+//#region src/exports/control.ts
+function verifyVectorExtensionInstalled(schema) {
+	if (!schema.extensions.includes("vector")) return [{
+		kind: "extension_missing",
+		table: "",
+		message: "Extension \"vector\" is missing from database (required by pgvector)"
+	}];
+	return [];
+}
+const pgvectorDatabaseDependencies = { init: [{
+	id: "postgres.extension.vector",
+	label: "Enable vector extension",
+	install: [{
+		id: "extension.vector",
+		label: "Enable extension \"vector\"",
+		summary: "Ensures the vector extension is available for pgvector operations",
+		operationClass: "additive",
+		target: { id: "postgres" },
+		precheck: [{
+			description: "verify extension \"vector\" is not already enabled",
+			sql: "SELECT NOT EXISTS (SELECT 1 FROM pg_extension WHERE extname = 'vector')"
+		}],
+		execute: [{
+			description: "create extension \"vector\"",
+			sql: "CREATE EXTENSION IF NOT EXISTS vector"
+		}],
+		postcheck: [{
+			description: "confirm extension \"vector\" is enabled",
+			sql: "SELECT EXISTS (SELECT 1 FROM pg_extension WHERE extname = 'vector')"
+		}]
+	}],
+	verifyDatabaseDependencyInstalled: verifyVectorExtensionInstalled
+}] };
+const pgvectorExtensionDescriptor = {
+	...pgvectorPackMeta,
+	operationSignatures: () => [pgvectorOperationSignature],
+	databaseDependencies: pgvectorDatabaseDependencies,
+	create: () => ({
+		familyId: "sql",
+		targetId: "postgres"
+	})
+};
+var control_default = pgvectorExtensionDescriptor;
+
+//#endregion
+export { control_default as default, pgvectorExtensionDescriptor };
+//# sourceMappingURL=control.mjs.map

package/dist/control.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.mjs","names":["pgvectorDatabaseDependencies: ComponentDatabaseDependencies<unknown>","pgvectorExtensionDescriptor: SqlControlExtensionDescriptor<'postgres'>"],"sources":["../src/exports/control.ts"],"sourcesContent":["import type { SchemaIssue } from '@prisma-next/core-control-plane/types';\nimport type {\n  ComponentDatabaseDependencies,\n  SqlControlExtensionDescriptor,\n} from '@prisma-next/family-sql/control';\nimport type { SqlSchemaIR } from '@prisma-next/sql-schema-ir/types';\nimport { pgvectorOperationSignature, pgvectorPackMeta } from '../core/descriptor-meta';\n\nfunction verifyVectorExtensionInstalled(schema: SqlSchemaIR): readonly SchemaIssue[] {\n  if (!schema.extensions.includes('vector')) {\n    return [\n      {\n        kind: 'extension_missing',\n        table: '',\n        message: 'Extension \"vector\" is missing from database (required by pgvector)',\n      },\n    ];\n  }\n  return [];\n}\n\nconst pgvectorDatabaseDependencies: ComponentDatabaseDependencies<unknown> = {\n  init: [\n    {\n      id: 'postgres.extension.vector',\n      label: 'Enable vector extension',\n      install: [\n        {\n          id: 'extension.vector',\n          label: 'Enable extension \"vector\"',\n          summary: 'Ensures the vector extension is available for pgvector operations',\n          operationClass: 'additive',\n          target: { id: 'postgres' },\n          precheck: [\n            {\n              description: 'verify extension \"vector\" is not already enabled',\n              sql: \"SELECT NOT EXISTS (SELECT 1 FROM pg_extension WHERE extname = 'vector')\",\n            },\n          ],\n          execute: [\n            {\n              description: 'create extension \"vector\"',\n              sql: 'CREATE EXTENSION IF NOT EXISTS vector',\n            },\n          ],\n          postcheck: [\n            {\n              description: 'confirm extension \"vector\" is enabled',\n              sql: \"SELECT EXISTS (SELECT 1 FROM pg_extension WHERE extname = 'vector')\",\n            },\n          ],\n        },\n      ],\n      verifyDatabaseDependencyInstalled: verifyVectorExtensionInstalled,\n    },\n  ],\n};\n\nconst pgvectorExtensionDescriptor: SqlControlExtensionDescriptor<'postgres'> = {\n  ...pgvectorPackMeta,\n  operationSignatures: () => [pgvectorOperationSignature],\n  databaseDependencies: pgvectorDatabaseDependencies,\n  create: () => ({\n    familyId: 'sql' as const,\n    targetId: 'postgres' as const,\n  }),\n};\n\nexport { pgvectorExtensionDescriptor };\nexport default pgvectorExtensionDescriptor;\n"],"mappings":";;;AAQA,SAAS,+BAA+B,QAA6C;AACnF,KAAI,CAAC,OAAO,WAAW,SAAS,SAAS,CACvC,QAAO,CACL;EACE,MAAM;EACN,OAAO;EACP,SAAS;EACV,CACF;AAEH,QAAO,EAAE;;AAGX,MAAMA,+BAAuE,EAC3E,MAAM,CACJ;CACE,IAAI;CACJ,OAAO;CACP,SAAS,CACP;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,gBAAgB;EAChB,QAAQ,EAAE,IAAI,YAAY;EAC1B,UAAU,CACR;GACE,aAAa;GACb,KAAK;GACN,CACF;EACD,SAAS,CACP;GACE,aAAa;GACb,KAAK;GACN,CACF;EACD,WAAW,CACT;GACE,aAAa;GACb,KAAK;GACN,CACF;EACF,CACF;CACD,mCAAmC;CACpC,CACF,EACF;AAED,MAAMC,8BAAyE;CAC7E,GAAG;CACH,2BAA2B,CAAC,2BAA2B;CACvD,sBAAsB;CACtB,eAAe;EACb,UAAU;EACV,UAAU;EACX;CACF;AAGD,sBAAe"}

package/dist/descriptor-meta-BADTQp0u.mjs

@@ -0,0 +1,57 @@
+//#region src/core/descriptor-meta.ts
+const pgvectorTypeId = "pg/vector@1";
+const cosineDistanceOperation = Object.freeze({
+	method: "cosineDistance",
+	args: [{ kind: "param" }],
+	returns: {
+		kind: "builtin",
+		type: "number"
+	},
+	lowering: {
+		targetFamily: "sql",
+		strategy: "function",
+		template: "1 - ({{self}} <=> {{arg0}})"
+	}
+});
+const pgvectorOperationSignature = {
+	forTypeId: pgvectorTypeId,
+	...cosineDistanceOperation
+};
+const pgvectorPackMeta = {
+	kind: "extension",
+	id: "pgvector",
+	familyId: "sql",
+	targetId: "postgres",
+	version: "0.0.1",
+	capabilities: { postgres: { "pgvector/cosine": true } },
+	types: {
+		codecTypes: {
+			import: {
+				package: "@prisma-next/extension-pgvector/codec-types",
+				named: "CodecTypes",
+				alias: "PgVectorTypes"
+			},
+			typeImports: [{
+				package: "@prisma-next/extension-pgvector/codec-types",
+				named: "Vector",
+				alias: "Vector"
+			}],
+			parameterized: { [pgvectorTypeId]: "Vector<{{length}}>" }
+		},
+		operationTypes: { import: {
+			package: "@prisma-next/extension-pgvector/operation-types",
+			named: "OperationTypes",
+			alias: "PgVectorOperationTypes"
+		} },
+		storage: [{
+			typeId: pgvectorTypeId,
+			familyId: "sql",
+			targetId: "postgres",
+			nativeType: "vector"
+		}]
+	}
+};
+
+//#endregion
+export { pgvectorPackMeta as n, pgvectorOperationSignature as t };
+//# sourceMappingURL=descriptor-meta-BADTQp0u.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor-meta-BADTQp0u.mjs","names":["pgvectorOperationSignature: SqlOperationSignature"],"sources":["../src/core/descriptor-meta.ts"],"sourcesContent":["import type { SqlOperationSignature } from '@prisma-next/sql-operations';\n\nconst pgvectorTypeId = 'pg/vector@1' as const;\n\nconst cosineLowering = {\n  targetFamily: 'sql',\n  strategy: 'function',\n  template: '1 - ({{self}} <=> {{arg0}})',\n} as const;\n\nconst cosineDistanceOperation = Object.freeze({\n  method: 'cosineDistance',\n  args: [{ kind: 'param' }],\n  returns: { kind: 'builtin', type: 'number' },\n  lowering: cosineLowering,\n} as const);\n\nexport const pgvectorOperationSignature: SqlOperationSignature = {\n  forTypeId: pgvectorTypeId,\n  ...cosineDistanceOperation,\n};\n\nexport const pgvectorPackMeta = {\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  types: {\n    codecTypes: {\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      parameterized: {\n        [pgvectorTypeId]: 'Vector<{{length}}>',\n      },\n    },\n    operationTypes: {\n      import: {\n        package: '@prisma-next/extension-pgvector/operation-types',\n        named: 'OperationTypes',\n        alias: 'PgVectorOperationTypes',\n      },\n    },\n    storage: [\n      { typeId: pgvectorTypeId, familyId: 'sql', targetId: 'postgres', nativeType: 'vector' },\n    ],\n  },\n} as const;\n"],"mappings":";AAEA,MAAM,iBAAiB;AAQvB,MAAM,0BAA0B,OAAO,OAAO;CAC5C,QAAQ;CACR,MAAM,CAAC,EAAE,MAAM,SAAS,CAAC;CACzB,SAAS;EAAE,MAAM;EAAW,MAAM;EAAU;CAC5C,UAVqB;EACrB,cAAc;EACd,UAAU;EACV,UAAU;EACX;CAOA,CAAU;AAEX,MAAaA,6BAAoD;CAC/D,WAAW;CACX,GAAG;CACJ;AAED,MAAa,mBAAmB;CAC9B,MAAM;CACN,IAAI;CACJ,UAAU;CACV,UAAU;CACV,SAAS;CACT,cAAc,EACZ,UAAU,EACR,mBAAmB,MACpB,EACF;CACD,OAAO;EACL,YAAY;GACV,QAAQ;IACN,SAAS;IACT,OAAO;IACP,OAAO;IACR;GACD,aAAa,CACX;IACE,SAAS;IACT,OAAO;IACP,OAAO;IACR,CACF;GACD,eAAe,GACZ,iBAAiB,sBACnB;GACF;EACD,gBAAgB,EACd,QAAQ;GACN,SAAS;GACT,OAAO;GACP,OAAO;GACR,EACF;EACD,SAAS,CACP;GAAE,QAAQ;GAAgB,UAAU;GAAO,UAAU;GAAY,YAAY;GAAU,CACxF;EACF;CACF"}

package/dist/operation-types.d.mts

@@ -0,0 +1,32 @@
+//#region src/types/operation-types.d.ts
+/**
+ * Operation type definitions for pgvector extension.
+ *
+ * This file exports type-only definitions for operation method signatures.
+ * These types are imported by contract.d.ts files for compile-time type inference.
+ */
+/**
+ * Operation types for pgvector extension.
+ * Maps typeId to operation methods.
+ */
+type OperationTypes = {
+  readonly 'pg/vector@1': {
+    readonly cosineDistance: {
+      readonly args: readonly [{
+        readonly kind: 'param';
+      }];
+      readonly returns: {
+        readonly kind: 'builtin';
+        readonly type: 'number';
+      };
+      readonly lowering: {
+        readonly targetFamily: 'sql';
+        readonly strategy: 'function';
+        readonly template: string;
+      };
+    };
+  };
+};
+//#endregion
+export { type OperationTypes };
+//# sourceMappingURL=operation-types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operation-types.d.mts","names":[],"sources":["../src/types/operation-types.ts"],"sourcesContent":[],"mappings":";;AAWA;;;;;;;;;KAAY,cAAA"}

package/dist/operation-types.mjs

@@ -0,0 +1 @@
+export {  };

package/dist/pack.d.mts

@@ -0,0 +1,46 @@
+//#region src/exports/pack.d.ts
+declare const pgvectorPack: {
+  readonly kind: "extension";
+  readonly id: "pgvector";
+  readonly familyId: "sql";
+  readonly targetId: "postgres";
+  readonly version: "0.0.1";
+  readonly capabilities: {
+    readonly postgres: {
+      readonly 'pgvector/cosine': true;
+    };
+  };
+  readonly types: {
+    readonly codecTypes: {
+      readonly import: {
+        readonly package: "@prisma-next/extension-pgvector/codec-types";
+        readonly named: "CodecTypes";
+        readonly alias: "PgVectorTypes";
+      };
+      readonly typeImports: readonly [{
+        readonly package: "@prisma-next/extension-pgvector/codec-types";
+        readonly named: "Vector";
+        readonly alias: "Vector";
+      }];
+      readonly parameterized: {
+        readonly "pg/vector@1": "Vector<{{length}}>";
+      };
+    };
+    readonly operationTypes: {
+      readonly import: {
+        readonly package: "@prisma-next/extension-pgvector/operation-types";
+        readonly named: "OperationTypes";
+        readonly alias: "PgVectorOperationTypes";
+      };
+    };
+    readonly storage: readonly [{
+      readonly typeId: "pg/vector@1";
+      readonly familyId: "sql";
+      readonly targetId: "postgres";
+      readonly nativeType: "vector";
+    }];
+  };
+};
+//#endregion
+export { pgvectorPack as default };
+//# sourceMappingURL=pack.d.mts.map

package/dist/pack.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.d.mts","names":[],"sources":["../src/exports/pack.ts"],"sourcesContent":[],"mappings":";cAEM;EAAA,SAAA,IAAA,EAA+B,WAAA"}

package/dist/pack.mjs

@@ -0,0 +1,9 @@
+import { n as pgvectorPackMeta } from "./descriptor-meta-BADTQp0u.mjs";
+
+//#region src/exports/pack.ts
+const pgvectorPack = pgvectorPackMeta;
+var pack_default = pgvectorPack;
+
+//#endregion
+export { pack_default as default };
+//# sourceMappingURL=pack.mjs.map

package/dist/pack.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.mjs","names":[],"sources":["../src/exports/pack.ts"],"sourcesContent":["import { pgvectorPackMeta } from '../core/descriptor-meta';\n\nconst pgvectorPack = pgvectorPackMeta;\n\nexport default pgvectorPack;\n"],"mappings":";;;AAEA,MAAM,eAAe;AAErB,mBAAe"}

package/dist/runtime.d.mts

@@ -0,0 +1,7 @@
+import { SqlRuntimeExtensionDescriptor } from "@prisma-next/sql-runtime";
+
+//#region src/exports/runtime.d.ts
+declare const pgvectorRuntimeDescriptor: SqlRuntimeExtensionDescriptor<'postgres'>;
+//#endregion
+export { pgvectorRuntimeDescriptor as default };
+//# sourceMappingURL=runtime.d.mts.map

package/dist/runtime.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.mts","names":[],"sources":["../src/exports/runtime.ts"],"sourcesContent":[],"mappings":";;;cAwCM,2BAA2B"}

package/dist/runtime.mjs

@@ -0,0 +1,74 @@
+import { n as pgvectorPackMeta, t as pgvectorOperationSignature } from "./descriptor-meta-BADTQp0u.mjs";
+import { n as VECTOR_MAX_DIM, t as VECTOR_CODEC_ID } from "./constants-BmZpaev5.mjs";
+import { codec, createCodecRegistry, defineCodecs } from "@prisma-next/sql-relational-core/ast";
+import { type } from "arktype";
+
+//#region src/core/codecs.ts
+/**
+* Vector codec implementation for pgvector extension.
+*
+* Provides encoding/decoding for the `vector` PostgreSQL type.
+* Wire format is a string like `[1,2,3]` (PostgreSQL vector text format).
+*/
+const pgVectorCodec = codec({
+	typeId: "pg/vector@1",
+	targetTypes: ["vector"],
+	encode: (value) => {
+		if (!Array.isArray(value)) throw new Error("Vector value must be an array of numbers");
+		if (!value.every((v) => typeof v === "number")) throw new Error("Vector value must contain only numbers");
+		return `[${value.join(",")}]`;
+	},
+	decode: (wire) => {
+		if (typeof wire !== "string") throw new Error("Vector wire value must be a string");
+		if (!wire.startsWith("[") || !wire.endsWith("]")) throw new Error(`Invalid vector format: expected "[...]", got "${wire}"`);
+		const content = wire.slice(1, -1).trim();
+		if (content === "") return [];
+		return content.split(",").map((v) => {
+			const num = Number.parseFloat(v.trim());
+			if (Number.isNaN(num)) throw new Error(`Invalid vector value: "${v}" is not a number`);
+			return num;
+		});
+	},
+	meta: { db: { sql: { postgres: { nativeType: "vector" } } } }
+});
+const codecs = defineCodecs().add("vector", pgVectorCodec);
+const codecDefinitions = codecs.codecDefinitions;
+const dataTypes = codecs.dataTypes;
+
+//#endregion
+//#region src/exports/runtime.ts
+const parameterizedCodecDescriptors = [{
+	codecId: VECTOR_CODEC_ID,
+	paramsSchema: type({ length: "number" }).narrow((params, ctx) => {
+		const { length } = params;
+		if (!Number.isInteger(length)) return ctx.mustBe("an integer");
+		if (length < 1 || length > VECTOR_MAX_DIM) return ctx.mustBe(`in the range [1, ${VECTOR_MAX_DIM}]`);
+		return true;
+	})
+}];
+function createPgvectorCodecRegistry() {
+	const registry = createCodecRegistry();
+	for (const def of Object.values(codecDefinitions)) registry.register(def.codec);
+	return registry;
+}
+const pgvectorRuntimeDescriptor = {
+	kind: "extension",
+	id: pgvectorPackMeta.id,
+	version: pgvectorPackMeta.version,
+	familyId: "sql",
+	targetId: "postgres",
+	codecs: createPgvectorCodecRegistry,
+	operationSignatures: () => [pgvectorOperationSignature],
+	parameterizedCodecs: () => parameterizedCodecDescriptors,
+	create() {
+		return {
+			familyId: "sql",
+			targetId: "postgres"
+		};
+	}
+};
+var runtime_default = pgvectorRuntimeDescriptor;
+
+//#endregion
+export { runtime_default as default };
+//# sourceMappingURL=runtime.mjs.map

package/dist/runtime.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.mjs","names":["arktype","pgvectorRuntimeDescriptor: SqlRuntimeExtensionDescriptor<'postgres'>"],"sources":["../src/core/codecs.ts","../src/exports/runtime.ts"],"sourcesContent":["/**\n * Vector codec implementation for pgvector extension.\n *\n * Provides encoding/decoding for the `vector` PostgreSQL type.\n * Wire format is a string like `[1,2,3]` (PostgreSQL vector text format).\n */\n\nimport { codec, defineCodecs } from '@prisma-next/sql-relational-core/ast';\n\nconst pgVectorCodec = codec<'pg/vector@1', string, number[]>({\n  typeId: 'pg/vector@1',\n  targetTypes: ['vector'],\n  encode: (value: number[]): string => {\n    // Validate that value is an array of numbers\n    if (!Array.isArray(value)) {\n      throw new Error('Vector value must be an array of numbers');\n    }\n    if (!value.every((v) => typeof v === 'number')) {\n      throw new Error('Vector value must contain only numbers');\n    }\n    // Format as PostgreSQL vector text format: [1,2,3]\n    // PostgreSQL's pg library requires the vector format string\n    return `[${value.join(',')}]`;\n  },\n  decode: (wire: string): number[] => {\n    // Handle string format from PostgreSQL: [1,2,3]\n    if (typeof wire !== 'string') {\n      throw new Error('Vector wire value must be a string');\n    }\n    // Parse PostgreSQL vector format: [1,2,3]\n    if (!wire.startsWith('[') || !wire.endsWith(']')) {\n      throw new Error(`Invalid vector format: expected \"[...]\", got \"${wire}\"`);\n    }\n    const content = wire.slice(1, -1).trim();\n    if (content === '') {\n      return [];\n    }\n    const values = content.split(',').map((v) => {\n      const num = Number.parseFloat(v.trim());\n      if (Number.isNaN(num)) {\n        throw new Error(`Invalid vector value: \"${v}\" is not a number`);\n      }\n      return num;\n    });\n    return values;\n  },\n  meta: {\n    db: {\n      sql: {\n        postgres: {\n          nativeType: 'vector',\n        },\n      },\n    },\n  },\n});\n\n// Build codec definitions using the builder DSL\nconst codecs = defineCodecs().add('vector', pgVectorCodec);\n\n// Export derived structures directly from codecs builder\nexport const codecDefinitions = codecs.codecDefinitions;\nexport const dataTypes = codecs.dataTypes;\n\n// Export types derived from codecs builder\nexport type CodecTypes = typeof codecs.CodecTypes;\n","import { createCodecRegistry } from '@prisma-next/sql-relational-core/ast';\nimport type {\n  RuntimeParameterizedCodecDescriptor,\n  SqlRuntimeExtensionDescriptor,\n} from '@prisma-next/sql-runtime';\nimport { type as arktype } from 'arktype';\nimport { codecDefinitions } from '../core/codecs';\nimport { VECTOR_CODEC_ID, VECTOR_MAX_DIM } from '../core/constants';\nimport { pgvectorOperationSignature, pgvectorPackMeta } from '../core/descriptor-meta';\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});\n\nconst parameterizedCodecDescriptors = [\n  {\n    codecId: VECTOR_CODEC_ID,\n    paramsSchema: vectorParamsSchema,\n  },\n] as const satisfies ReadonlyArray<\n  RuntimeParameterizedCodecDescriptor<{ readonly length: number }>\n>;\n\nfunction createPgvectorCodecRegistry() {\n  const registry = createCodecRegistry();\n  for (const def of Object.values(codecDefinitions)) {\n    registry.register(def.codec);\n  }\n  return registry;\n}\n\nconst pgvectorRuntimeDescriptor: SqlRuntimeExtensionDescriptor<'postgres'> = {\n  kind: 'extension' as const,\n  id: pgvectorPackMeta.id,\n  version: pgvectorPackMeta.version,\n  familyId: 'sql' as const,\n  targetId: 'postgres' as const,\n  codecs: createPgvectorCodecRegistry,\n  operationSignatures: () => [pgvectorOperationSignature],\n  parameterizedCodecs: () => parameterizedCodecDescriptors,\n  create() {\n    return {\n      familyId: 'sql' as const,\n      targetId: 'postgres' as const,\n    };\n  },\n};\n\nexport default pgvectorRuntimeDescriptor;\n"],"mappings":";;;;;;;;;;;;AASA,MAAM,gBAAgB,MAAuC;CAC3D,QAAQ;CACR,aAAa,CAAC,SAAS;CACvB,SAAS,UAA4B;AAEnC,MAAI,CAAC,MAAM,QAAQ,MAAM,CACvB,OAAM,IAAI,MAAM,2CAA2C;AAE7D,MAAI,CAAC,MAAM,OAAO,MAAM,OAAO,MAAM,SAAS,CAC5C,OAAM,IAAI,MAAM,yCAAyC;AAI3D,SAAO,IAAI,MAAM,KAAK,IAAI,CAAC;;CAE7B,SAAS,SAA2B;AAElC,MAAI,OAAO,SAAS,SAClB,OAAM,IAAI,MAAM,qCAAqC;AAGvD,MAAI,CAAC,KAAK,WAAW,IAAI,IAAI,CAAC,KAAK,SAAS,IAAI,CAC9C,OAAM,IAAI,MAAM,iDAAiD,KAAK,GAAG;EAE3E,MAAM,UAAU,KAAK,MAAM,GAAG,GAAG,CAAC,MAAM;AACxC,MAAI,YAAY,GACd,QAAO,EAAE;AASX,SAPe,QAAQ,MAAM,IAAI,CAAC,KAAK,MAAM;GAC3C,MAAM,MAAM,OAAO,WAAW,EAAE,MAAM,CAAC;AACvC,OAAI,OAAO,MAAM,IAAI,CACnB,OAAM,IAAI,MAAM,0BAA0B,EAAE,mBAAmB;AAEjE,UAAO;IACP;;CAGJ,MAAM,EACJ,IAAI,EACF,KAAK,EACH,UAAU,EACR,YAAY,UACb,EACF,EACF,EACF;CACF,CAAC;AAGF,MAAM,SAAS,cAAc,CAAC,IAAI,UAAU,cAAc;AAG1D,MAAa,mBAAmB,OAAO;AACvC,MAAa,YAAY,OAAO;;;;ACvChC,MAAM,gCAAgC,CACpC;CACE,SAAS;CACT,cAhBuBA,KAAQ,EACjC,QAAQ,UACT,CAAC,CAAC,QAAQ,QAAQ,QAAQ;EACzB,MAAM,EAAE,WAAW;AACnB,MAAI,CAAC,OAAO,UAAU,OAAO,CAC3B,QAAO,IAAI,OAAO,aAAa;AAEjC,MAAI,SAAS,KAAK,SAAS,eACzB,QAAO,IAAI,OAAO,oBAAoB,eAAe,GAAG;AAE1D,SAAO;GACP;CAMC,CACF;AAID,SAAS,8BAA8B;CACrC,MAAM,WAAW,qBAAqB;AACtC,MAAK,MAAM,OAAO,OAAO,OAAO,iBAAiB,CAC/C,UAAS,SAAS,IAAI,MAAM;AAE9B,QAAO;;AAGT,MAAMC,4BAAuE;CAC3E,MAAM;CACN,IAAI,iBAAiB;CACrB,SAAS,iBAAiB;CAC1B,UAAU;CACV,UAAU;CACV,QAAQ;CACR,2BAA2B,CAAC,2BAA2B;CACvD,2BAA2B;CAC3B,SAAS;AACP,SAAO;GACL,UAAU;GACV,UAAU;GACX;;CAEJ;AAED,sBAAe"}