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

package/dist/{exports/chunk-QZXQPESZ.js → chunk-SHWLERB3.js}

@@ -57,4 +57,4 @@ export {
   pgvectorPackMeta,
   pgvectorRuntimeOperation
 };
-//# sourceMappingURL=chunk-QZXQPESZ.js.map
+//# sourceMappingURL=chunk-SHWLERB3.js.map

package/dist/chunk-SHWLERB3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/descriptor-meta.ts"],"sourcesContent":["import type { ExtensionPackRef } from '@prisma-next/contract/framework-components';\nimport 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\n/**\n * Shared operation definition used by both pack metadata and runtime descriptor.\n * Frozen to prevent accidental mutation.\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 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    },\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  operations: [\n    {\n      for: pgvectorTypeId,\n      ...cosineDistanceOperation,\n    },\n  ],\n} as const satisfies ExtensionPackRef<'sql', 'postgres'>;\n\nexport const pgvectorRuntimeOperation: SqlOperationSignature = {\n  forTypeId: pgvectorTypeId,\n  ...cosineDistanceOperation,\n};\n"],"mappings":";AAGA,IAAM,iBAAiB;AAEvB,IAAM,iBAAiB;AAAA,EACrB,cAAc;AAAA,EACd,UAAU;AAAA,EACV,UAAU;AACZ;AAMA,IAAM,0BAA0B,OAAO,OAAO;AAAA,EAC5C,QAAQ;AAAA,EACR,MAAM,CAAC,EAAE,MAAM,QAAQ,CAAC;AAAA,EACxB,SAAS,EAAE,MAAM,WAAW,MAAM,SAAS;AAAA,EAC3C,UAAU;AACZ,CAAU;AAEH,IAAM,mBAAmB;AAAA,EAC9B,MAAM;AAAA,EACN,IAAI;AAAA,EACJ,UAAU;AAAA,EACV,UAAU;AAAA,EACV,SAAS;AAAA,EACT,cAAc;AAAA,IACZ,UAAU;AAAA,MACR,mBAAmB;AAAA,IACrB;AAAA,EACF;AAAA,EACA,OAAO;AAAA,IACL,YAAY;AAAA,MACV,QAAQ;AAAA,QACN,SAAS;AAAA,QACT,OAAO;AAAA,QACP,OAAO;AAAA,MACT;AAAA,IACF;AAAA,IACA,gBAAgB;AAAA,MACd,QAAQ;AAAA,QACN,SAAS;AAAA,QACT,OAAO;AAAA,QACP,OAAO;AAAA,MACT;AAAA,IACF;AAAA,IACA,SAAS;AAAA,MACP,EAAE,QAAQ,gBAAgB,UAAU,OAAO,UAAU,YAAY,YAAY,SAAS;AAAA,IACxF;AAAA,EACF;AAAA,EACA,YAAY;AAAA,IACV;AAAA,MACE,KAAK;AAAA,MACL,GAAG;AAAA,IACL;AAAA,EACF;AACF;AAEO,IAAM,2BAAkD;AAAA,EAC7D,WAAW;AAAA,EACX,GAAG;AACL;","names":[]}

package/dist/core/codecs.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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: import("@prisma-next/sql-relational-core/ast").CodecDefBuilder<{} & Record<"vector", import("@prisma-next/sql-relational-core/ast").Codec<"pg/vector@1", string, number[]>>>;
+export declare const codecDefinitions: {
+    readonly vector: {
+        readonly typeId: "pg/vector@1";
+        readonly scalar: "vector";
+        readonly codec: import("@prisma-next/sql-relational-core/ast").Codec<"pg/vector@1", string, number[]>;
+        readonly input: number[];
+        readonly output: number[];
+        readonly jsType: number[];
+    };
+};
+export declare const dataTypes: {
+    readonly vector: "pg/vector@1";
+};
+export type CodecTypes = typeof codecs.CodecTypes;
+export {};
+//# sourceMappingURL=codecs.d.ts.map

package/dist/core/codecs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codecs.d.ts","sourceRoot":"","sources":["../../src/core/codecs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqDH,QAAA,MAAM,MAAM,8KAA8C,CAAC;AAG3D,eAAO,MAAM,gBAAgB;;;;;;;;;CAA0B,CAAC;AACxD,eAAO,MAAM,SAAS;;CAAmB,CAAC;AAG1C,MAAM,MAAM,UAAU,GAAG,OAAO,MAAM,CAAC,UAAU,CAAC"}

package/dist/core/descriptor-meta.d.ts

@@ -0,0 +1,53 @@
+import type { SqlOperationSignature } from '@prisma-next/sql-operations';
+export declare const pgvectorPackMeta: {
+    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 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";
+        }];
+    };
+    readonly operations: readonly [{
+        readonly method: "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: "1 - ({{self}} <=> {{arg0}})";
+        };
+        readonly for: "pg/vector@1";
+    }];
+};
+export declare const pgvectorRuntimeOperation: SqlOperationSignature;
+//# sourceMappingURL=descriptor-meta.d.ts.map

package/dist/core/descriptor-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor-meta.d.ts","sourceRoot":"","sources":["../../src/core/descriptor-meta.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAqBzE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoC2B,CAAC;AAEzD,eAAO,MAAM,wBAAwB,EAAE,qBAGtC,CAAC"}

package/dist/exports/codec-types.d.ts

@@ -1,12 +1,7 @@
-import * as _prisma_next_sql_relational_core_ast from '@prisma-next/sql-relational-core/ast';
-
 /**
- * Vector codec implementation for pgvector extension.
+ * Codec type definitions for pgvector extension.
  *
- * Provides encoding/decoding for the `vector` PostgreSQL type.
- * Wire format is a string like `[1,2,3]` (PostgreSQL vector text format).
+ * Re-export from types module for public API.
  */
-declare const codecs: _prisma_next_sql_relational_core_ast.CodecDefBuilder<{} & Record<"vector", _prisma_next_sql_relational_core_ast.Codec<"pg/vector@1", string, number[]>>>;
-type CodecTypes = typeof codecs.CodecTypes;
-
-export type { CodecTypes };
+export type { CodecTypes } from '../types/codec-types';
+//# sourceMappingURL=codec-types.d.ts.map

package/dist/exports/codec-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec-types.d.ts","sourceRoot":"","sources":["../../src/exports/codec-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/exports/column-types.d.ts

@@ -4,9 +4,8 @@
  * These descriptors provide both codecId and nativeType for use in contract authoring.
  * They are derived from the same source of truth as codec definitions and manifests.
  */
-declare const vectorColumn: {
+export declare const vectorColumn: {
     readonly codecId: "pg/vector@1";
     readonly nativeType: "vector";
 };
-
-export { vectorColumn };
+//# sourceMappingURL=column-types.d.ts.map

package/dist/exports/column-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-types.d.ts","sourceRoot":"","sources":["../../src/exports/column-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,eAAO,MAAM,YAAY;;;CAGgB,CAAC"}

package/dist/exports/control.d.ts

@@ -1,9 +1,9 @@
-import { SqlControlExtensionDescriptor } from '@prisma-next/family-sql/control';
-
+import type { SqlControlExtensionDescriptor } from '@prisma-next/family-sql/control';
 /**
  * pgvector extension descriptor for CLI config.
  * Declares database dependencies for the 'vector' Postgres extension.
  */
 declare const pgvectorExtensionDescriptor: SqlControlExtensionDescriptor<'postgres'>;
-
-export { pgvectorExtensionDescriptor as default, pgvectorExtensionDescriptor };
+export { pgvectorExtensionDescriptor };
+export default pgvectorExtensionDescriptor;
+//# sourceMappingURL=control.d.ts.map

package/dist/exports/control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.d.ts","sourceRoot":"","sources":["../../src/exports/control.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,6BAA6B,EAC9B,MAAM,iCAAiC,CAAC;AA8DzC;;;GAGG;AACH,QAAA,MAAM,2BAA2B,EAAE,6BAA6B,CAAC,UAAU,CAO1E,CAAC;AAEF,OAAO,EAAE,2BAA2B,EAAE,CAAC;AACvC,eAAe,2BAA2B,CAAC"}

package/dist/exports/control.js

@@ -1,6 +1,6 @@
 import {
   pgvectorPackMeta
-} from "./chunk-QZXQPESZ.js";
+} from "../chunk-SHWLERB3.js";
 
 // src/exports/control.ts
 function verifyVectorExtensionInstalled(schema) {

package/dist/exports/operation-types.d.ts

@@ -1,32 +1,7 @@
 /**
  * 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.
+ * Re-export from types module for public API.
  */
-/**
- * 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;
-            };
-        };
-    };
-};
-
-export type { OperationTypes };
+export type { OperationTypes } from '../types/operation-types';
+//# sourceMappingURL=operation-types.d.ts.map

package/dist/exports/operation-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-types.d.ts","sourceRoot":"","sources":["../../src/exports/operation-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/exports/pack.d.ts

@@ -48,5 +48,5 @@ declare const pgvectorPack: {
         readonly for: "pg/vector@1";
     }];
 };
-
-export { pgvectorPack as default };
+export default pgvectorPack;
+//# sourceMappingURL=pack.d.ts.map

package/dist/exports/pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.d.ts","sourceRoot":"","sources":["../../src/exports/pack.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAmB,CAAC;AAEtC,eAAe,YAAY,CAAC"}

package/dist/exports/pack.js

@@ -1,6 +1,6 @@
 import {
   pgvectorPackMeta
-} from "./chunk-QZXQPESZ.js";
+} from "../chunk-SHWLERB3.js";
 
 // src/exports/pack.ts
 var pgvectorPack = pgvectorPackMeta;

package/dist/exports/runtime.d.ts

@@ -1,9 +1,8 @@
-import { SqlRuntimeExtensionDescriptor } from '@prisma-next/sql-runtime';
-
+import type { SqlRuntimeExtensionDescriptor } from '@prisma-next/sql-runtime';
 /**
  * pgvector SQL runtime extension descriptor.
  * Provides metadata and factory for creating runtime extension instances.
  */
 declare const pgvectorRuntimeDescriptor: SqlRuntimeExtensionDescriptor<'postgres'>;
-
-export { pgvectorRuntimeDescriptor as default };
+export default pgvectorRuntimeDescriptor;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/exports/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/exports/runtime.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,6BAA6B,EAE9B,MAAM,0BAA0B,CAAC;AA0BlC;;;GAGG;AACH,QAAA,MAAM,yBAAyB,EAAE,6BAA6B,CAAC,UAAU,CASxE,CAAC;AAEF,eAAe,yBAAyB,CAAC"}

package/dist/exports/runtime.js

@@ -1,7 +1,7 @@
 import {
   pgvectorPackMeta,
   pgvectorRuntimeOperation
-} from "./chunk-QZXQPESZ.js";
+} from "../chunk-SHWLERB3.js";
 
 // src/exports/runtime.ts
 import { createCodecRegistry } from "@prisma-next/sql-relational-core/ast";

package/dist/types/codec-types.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Codec type definitions for pgvector extension.
+ *
+ * This file exports type-only definitions for codec input/output types.
+ * These types are imported by contract.d.ts files for compile-time type inference.
+ *
+ * Runtime codec implementations are provided by the extension's codec registry.
+ */
+export type { CodecTypes } from '../core/codecs';
+//# sourceMappingURL=codec-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codec-types.d.ts","sourceRoot":"","sources":["../../src/types/codec-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/types/operation-types.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 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.
+ */
+export 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;
+            };
+        };
+    };
+};
+//# sourceMappingURL=operation-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operation-types.d.ts","sourceRoot":"","sources":["../../src/types/operation-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,aAAa,EAAE;QACtB,QAAQ,CAAC,cAAc,EAAE;YACvB,QAAQ,CAAC,IAAI,EAAE,SAAS;gBACtB;oBACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;iBACxB;aACF,CAAC;YACF,QAAQ,CAAC,OAAO,EAAE;gBAChB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;gBACzB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;aACzB,CAAC;YACF,QAAQ,CAAC,QAAQ,EAAE;gBACjB,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAC;gBAC7B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;gBAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;aAC3B,CAAC;SACH,CAAC;KACH,CAAC;CACH,CAAC"}

package/package.json

@@ -1,34 +1,35 @@
 {
   "name": "@prisma-next/extension-pgvector",
-  "version": "0.3.0-dev.4",
+  "version": "0.3.0-dev.5",
   "type": "module",
   "sideEffects": false,
   "dependencies": {
     "arktype": "^2.0.0",
-    "@prisma-next/cli": "0.3.0-dev.4",
-    "@prisma-next/contract": "0.3.0-dev.4",
-    "@prisma-next/contract-authoring": "0.3.0-dev.4",
-    "@prisma-next/core-control-plane": "0.3.0-dev.4",
-    "@prisma-next/family-sql": "0.3.0-dev.4",
-    "@prisma-next/sql-operations": "0.3.0-dev.4",
-    "@prisma-next/sql-relational-core": "0.3.0-dev.4",
-    "@prisma-next/sql-runtime": "0.3.0-dev.4",
-    "@prisma-next/sql-schema-ir": "0.3.0-dev.4"
+    "@prisma-next/cli": "0.3.0-dev.5",
+    "@prisma-next/contract": "0.3.0-dev.5",
+    "@prisma-next/contract-authoring": "0.3.0-dev.5",
+    "@prisma-next/core-control-plane": "0.3.0-dev.5",
+    "@prisma-next/sql-operations": "0.3.0-dev.5",
+    "@prisma-next/sql-relational-core": "0.3.0-dev.5",
+    "@prisma-next/family-sql": "0.3.0-dev.5",
+    "@prisma-next/sql-runtime": "0.3.0-dev.5",
+    "@prisma-next/sql-schema-ir": "0.3.0-dev.5"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.0.16",
     "tsup": "8.5.1",
     "typescript": "5.9.3",
     "vitest": "4.0.16",
-    "@prisma-next/adapter-postgres": "0.3.0-dev.4",
-    "@prisma-next/operations": "0.3.0-dev.4",
-    "@prisma-next/sql-contract": "0.3.0-dev.4",
-    "@prisma-next/sql-contract-ts": "0.3.0-dev.4",
-    "@prisma-next/sql-lane": "0.3.0-dev.4",
+    "@prisma-next/adapter-postgres": "0.3.0-dev.5",
+    "@prisma-next/operations": "0.3.0-dev.5",
+    "@prisma-next/sql-contract": "0.3.0-dev.5",
+    "@prisma-next/sql-contract-ts": "0.3.0-dev.5",
+    "@prisma-next/sql-lane": "0.3.0-dev.5",
     "@prisma-next/test-utils": "0.0.1"
   },
   "files": [
-    "dist"
+    "dist",
+    "src"
   ],
   "exports": {
     "./package.json": "./package.json",
@@ -58,7 +59,7 @@
     }
   },
   "scripts": {
-    "build": "tsup --config tsup.config.ts",
+    "build": "tsup --config tsup.config.ts && tsc --project tsconfig.build.json",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --project tsconfig.json --noEmit",

package/src/core/codecs.ts

@@ -0,0 +1,66 @@
+/**
+ * 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).
+ */
+
+import { codec, defineCodecs } from '@prisma-next/sql-relational-core/ast';
+
+const pgVectorCodec = codec<'pg/vector@1', string, number[]>({
+  typeId: 'pg/vector@1',
+  targetTypes: ['vector'],
+  encode: (value: number[]): string => {
+    // Validate that value is an array of numbers
+    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');
+    }
+    // Format as PostgreSQL vector text format: [1,2,3]
+    // PostgreSQL's pg library requires the vector format string
+    return `[${value.join(',')}]`;
+  },
+  decode: (wire: string): number[] => {
+    // Handle string format from PostgreSQL: [1,2,3]
+    if (typeof wire !== 'string') {
+      throw new Error('Vector wire value must be a string');
+    }
+    // Parse PostgreSQL vector format: [1,2,3]
+    if (!wire.startsWith('[') || !wire.endsWith(']')) {
+      throw new Error(`Invalid vector format: expected "[...]", got "${wire}"`);
+    }
+    const content = wire.slice(1, -1).trim();
+    if (content === '') {
+      return [];
+    }
+    const values = 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;
+    });
+    return values;
+  },
+  meta: {
+    db: {
+      sql: {
+        postgres: {
+          nativeType: 'vector',
+        },
+      },
+    },
+  },
+});
+
+// Build codec definitions using the builder DSL
+const codecs = defineCodecs().add('vector', pgVectorCodec);
+
+// Export derived structures directly from codecs builder
+export const codecDefinitions = codecs.codecDefinitions;
+export const dataTypes = codecs.dataTypes;
+
+// Export types derived from codecs builder
+export type CodecTypes = typeof codecs.CodecTypes;

package/src/core/descriptor-meta.ts

@@ -0,0 +1,64 @@
+import type { ExtensionPackRef } from '@prisma-next/contract/framework-components';
+import type { SqlOperationSignature } from '@prisma-next/sql-operations';
+
+const pgvectorTypeId = 'pg/vector@1' as const;
+
+const cosineLowering = {
+  targetFamily: 'sql',
+  strategy: 'function',
+  template: '1 - ({{self}} <=> {{arg0}})',
+} as const;
+
+/**
+ * Shared operation definition used by both pack metadata and runtime descriptor.
+ * Frozen to prevent accidental mutation.
+ */
+const cosineDistanceOperation = Object.freeze({
+  method: 'cosineDistance',
+  args: [{ kind: 'param' }],
+  returns: { kind: 'builtin', type: 'number' },
+  lowering: cosineLowering,
+} as const);
+
+export 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',
+      },
+    },
+    operationTypes: {
+      import: {
+        package: '@prisma-next/extension-pgvector/operation-types',
+        named: 'OperationTypes',
+        alias: 'PgVectorOperationTypes',
+      },
+    },
+    storage: [
+      { typeId: pgvectorTypeId, familyId: 'sql', targetId: 'postgres', nativeType: 'vector' },
+    ],
+  },
+  operations: [
+    {
+      for: pgvectorTypeId,
+      ...cosineDistanceOperation,
+    },
+  ],
+} as const satisfies ExtensionPackRef<'sql', 'postgres'>;
+
+export const pgvectorRuntimeOperation: SqlOperationSignature = {
+  forTypeId: pgvectorTypeId,
+  ...cosineDistanceOperation,
+};

package/src/exports/codec-types.ts

@@ -0,0 +1,7 @@
+/**
+ * Codec type definitions for pgvector extension.
+ *
+ * Re-export from types module for public API.
+ */
+
+export type { CodecTypes } from '../types/codec-types';

package/src/exports/column-types.ts

@@ -0,0 +1,13 @@
+/**
+ * Column type descriptors for pgvector extension.
+ *
+ * These descriptors provide both codecId and nativeType for use in contract authoring.
+ * They are derived from the same source of truth as codec definitions and manifests.
+ */
+
+import type { ColumnTypeDescriptor } from '@prisma-next/contract-authoring';
+
+export const vectorColumn = {
+  codecId: 'pg/vector@1',
+  nativeType: 'vector',
+} as const satisfies ColumnTypeDescriptor;

package/src/exports/control.ts

@@ -0,0 +1,81 @@
+import type { SchemaIssue } from '@prisma-next/core-control-plane/types';
+import type {
+  ComponentDatabaseDependencies,
+  SqlControlExtensionDescriptor,
+} from '@prisma-next/family-sql/control';
+import type { SqlSchemaIR } from '@prisma-next/sql-schema-ir/types';
+import { pgvectorPackMeta } from '../core/descriptor-meta';
+
+/**
+ * Pure verification hook: checks whether the 'vector' extension is installed
+ * based on the in-memory schema IR (no DB I/O).
+ */
+function verifyVectorExtensionInstalled(schema: SqlSchemaIR): readonly SchemaIssue[] {
+  if (!schema.extensions.includes('vector')) {
+    return [
+      {
+        kind: 'extension_missing',
+        table: '',
+        message: 'Extension "vector" is missing from database (required by pgvector)',
+      },
+    ];
+  }
+  return [];
+}
+
+/**
+ * Database dependencies for the pgvector extension.
+ * Declares the 'vector' Postgres extension as a required dependency.
+ */
+const pgvectorDatabaseDependencies: ComponentDatabaseDependencies<unknown> = {
+  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,
+    },
+  ],
+};
+
+/**
+ * pgvector extension descriptor for CLI config.
+ * Declares database dependencies for the 'vector' Postgres extension.
+ */
+const pgvectorExtensionDescriptor: SqlControlExtensionDescriptor<'postgres'> = {
+  ...pgvectorPackMeta,
+  databaseDependencies: pgvectorDatabaseDependencies,
+  create: () => ({
+    familyId: 'sql' as const,
+    targetId: 'postgres' as const,
+  }),
+};
+
+export { pgvectorExtensionDescriptor };
+export default pgvectorExtensionDescriptor;

package/src/exports/operation-types.ts

@@ -0,0 +1,7 @@
+/**
+ * Operation type definitions for pgvector extension.
+ *
+ * Re-export from types module for public API.
+ */
+
+export type { OperationTypes } from '../types/operation-types';

package/src/exports/pack.ts

@@ -0,0 +1,5 @@
+import { pgvectorPackMeta } from '../core/descriptor-meta';
+
+const pgvectorPack = pgvectorPackMeta;
+
+export default pgvectorPack;

package/src/exports/runtime.ts

@@ -0,0 +1,48 @@
+import type { SqlOperationSignature } from '@prisma-next/sql-operations';
+import type { CodecRegistry } from '@prisma-next/sql-relational-core/ast';
+import { createCodecRegistry } from '@prisma-next/sql-relational-core/ast';
+import type {
+  SqlRuntimeExtensionDescriptor,
+  SqlRuntimeExtensionInstance,
+} from '@prisma-next/sql-runtime';
+import { codecDefinitions } from '../core/codecs';
+import { pgvectorPackMeta, pgvectorRuntimeOperation } from '../core/descriptor-meta';
+
+/**
+ * pgvector SQL runtime extension instance.
+ * Provides codecs and operations for vector data type and similarity operations.
+ */
+class PgVectorRuntimeExtensionInstance implements SqlRuntimeExtensionInstance<'postgres'> {
+  readonly familyId = 'sql' as const;
+  readonly targetId = 'postgres' as const;
+
+  codecs(): CodecRegistry {
+    const registry = createCodecRegistry();
+    // Register all codecs from codecDefinitions
+    for (const def of Object.values(codecDefinitions)) {
+      registry.register(def.codec);
+    }
+    return registry;
+  }
+
+  operations(): ReadonlyArray<SqlOperationSignature> {
+    return [pgvectorRuntimeOperation];
+  }
+}
+
+/**
+ * pgvector SQL runtime extension descriptor.
+ * Provides metadata and factory for creating runtime extension instances.
+ */
+const pgvectorRuntimeDescriptor: SqlRuntimeExtensionDescriptor<'postgres'> = {
+  kind: 'extension' as const,
+  id: pgvectorPackMeta.id,
+  version: pgvectorPackMeta.version,
+  familyId: 'sql' as const,
+  targetId: 'postgres' as const,
+  create(): SqlRuntimeExtensionInstance<'postgres'> {
+    return new PgVectorRuntimeExtensionInstance();
+  },
+};
+
+export default pgvectorRuntimeDescriptor;

package/src/types/codec-types.ts

@@ -0,0 +1,10 @@
+/**
+ * Codec type definitions for pgvector extension.
+ *
+ * This file exports type-only definitions for codec input/output types.
+ * These types are imported by contract.d.ts files for compile-time type inference.
+ *
+ * Runtime codec implementations are provided by the extension's codec registry.
+ */
+
+export type { CodecTypes } from '../core/codecs';

package/src/types/operation-types.ts

@@ -0,0 +1,31 @@
+/**
+ * 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.
+ */
+export 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;
+      };
+    };
+  };
+};

package/dist/exports/chunk-QZXQPESZ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/core/descriptor-meta.ts"],"sourcesContent":["import type { ExtensionPackRef } from '@prisma-next/contract/framework-components';\nimport 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\n/**\n * Shared operation definition used by both pack metadata and runtime descriptor.\n * Frozen to prevent accidental mutation.\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 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    },\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  operations: [\n    {\n      for: pgvectorTypeId,\n      ...cosineDistanceOperation,\n    },\n  ],\n} as const satisfies ExtensionPackRef<'sql', 'postgres'>;\n\nexport const pgvectorRuntimeOperation: SqlOperationSignature = {\n  forTypeId: pgvectorTypeId,\n  ...cosineDistanceOperation,\n};\n"],"mappings":";AAGA,IAAM,iBAAiB;AAEvB,IAAM,iBAAiB;AAAA,EACrB,cAAc;AAAA,EACd,UAAU;AAAA,EACV,UAAU;AACZ;AAMA,IAAM,0BAA0B,OAAO,OAAO;AAAA,EAC5C,QAAQ;AAAA,EACR,MAAM,CAAC,EAAE,MAAM,QAAQ,CAAC;AAAA,EACxB,SAAS,EAAE,MAAM,WAAW,MAAM,SAAS;AAAA,EAC3C,UAAU;AACZ,CAAU;AAEH,IAAM,mBAAmB;AAAA,EAC9B,MAAM;AAAA,EACN,IAAI;AAAA,EACJ,UAAU;AAAA,EACV,UAAU;AAAA,EACV,SAAS;AAAA,EACT,cAAc;AAAA,IACZ,UAAU;AAAA,MACR,mBAAmB;AAAA,IACrB;AAAA,EACF;AAAA,EACA,OAAO;AAAA,IACL,YAAY;AAAA,MACV,QAAQ;AAAA,QACN,SAAS;AAAA,QACT,OAAO;AAAA,QACP,OAAO;AAAA,MACT;AAAA,IACF;AAAA,IACA,gBAAgB;AAAA,MACd,QAAQ;AAAA,QACN,SAAS;AAAA,QACT,OAAO;AAAA,QACP,OAAO;AAAA,MACT;AAAA,IACF;AAAA,IACA,SAAS;AAAA,MACP,EAAE,QAAQ,gBAAgB,UAAU,OAAO,UAAU,YAAY,YAAY,SAAS;AAAA,IACxF;AAAA,EACF;AAAA,EACA,YAAY;AAAA,IACV;AAAA,MACE,KAAK;AAAA,MACL,GAAG;AAAA,IACL;AAAA,EACF;AACF;AAEO,IAAM,2BAAkD;AAAA,EAC7D,WAAW;AAAA,EACX,GAAG;AACL;","names":[]}