@prisma-next/extension-pgvector 0.1.0-dev.3 → 0.1.0-dev.30

package/README.md

@@ -12,6 +12,8 @@ This extension pack adds support for the `vector` data type and vector similarit
 - **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
+- **Pack Ref Export**: Ships a pure `/pack` entrypoint for TypeScript contract authoring without runtime filesystem access
+- **Database Dependencies**: Declares the `vector` Postgres extension as a database dependency, which the migration planner emits as a `CREATE EXTENSION IF NOT EXISTS vector` operation and the verifier checks against the schema IR
 
 ## Dependencies
 
@@ -28,12 +30,16 @@ pnpm add @prisma-next/extension-pgvector
 
 ## Database Setup
 
-Before using this extension, ensure the pgvector extension is installed in your PostgreSQL database:
+The pgvector extension declares its database requirements as component-owned database dependencies. When using the `prisma-next db init` command, the migration planner automatically includes a `CREATE EXTENSION IF NOT EXISTS vector` operation.
+
+For manual database setup, ensure the pgvector extension is installed:
 
 ```sql
 CREATE EXTENSION IF NOT EXISTS vector;
 ```
 
+The verifier will check for the presence of the `vector` extension in your database schema and report an error if it's missing.
+
 ## Configuration
 
 Add the extension to your `prisma-next.config.ts`:
@@ -42,7 +48,7 @@ Add the extension to your `prisma-next.config.ts`:
 import { defineConfig } from '@prisma-next/cli/config-types';
 import postgresAdapter from '@prisma-next/adapter-postgres/control';
 import sql from '@prisma-next/family-sql/cli';
-import postgres from '@prisma-next/targets-postgres/control';
+import postgres from '@prisma-next/target-postgres/control';
 import pgvector from '@prisma-next/extension-pgvector/control';
 
 export default defineConfig({
@@ -57,7 +63,7 @@ export default defineConfig({
 
 ### Contract Definition
 
-Add vector columns to your contract:
+Add vector columns to your contract and enable the namespace via pack refs:
 
 ```typescript
 import { defineContract } from '@prisma-next/sql-contract-ts/contract-builder';
@@ -65,11 +71,14 @@ import type { CodecTypes } from '@prisma-next/adapter-postgres/codec-types';
 import { int4Column, textColumn } from '@prisma-next/adapter-postgres/column-types';
 import type { CodecTypes as PgVectorCodecTypes } from '@prisma-next/extension-pgvector/codec-types';
 import { vectorColumn } from '@prisma-next/extension-pgvector/column-types';
+import pgvector from '@prisma-next/extension-pgvector/pack';
+import postgres from '@prisma-next/target-postgres/pack';
 
 type AllCodecTypes = CodecTypes & PgVectorCodecTypes;
 
 export const contract = defineContract<AllCodecTypes>()
-  .target('postgres')
+  .target(postgres)
+  .extensionPacks({ pgvector })
   .table('post', (t) =>
     t
       .column('id', { type: int4Column, nullable: false })
@@ -171,3 +180,5 @@ The extension declares the following capabilities:
 - [Prisma Next Architecture Overview](../../../docs/Architecture%20Overview.md)
 - [Extension Packs Guide](../../../docs/reference/Extension-Packs-Naming-and-Layout.md)
 
+Pack refs (`@prisma-next/extension-pgvector/pack`) are pure data objects generated from the hydrated manifest (`src/core/manifest.ts`), so TypeScript contract builders can enable the pgvector namespace in both emit and no-emit workflows without touching the filesystem.
+

package/dist/exports/chunk-QZXQPESZ.js

@@ -0,0 +1,60 @@
+// src/core/descriptor-meta.ts
+var pgvectorTypeId = "pg/vector@1";
+var cosineLowering = {
+  targetFamily: "sql",
+  strategy: "function",
+  template: "1 - ({{self}} <=> {{arg0}})"
+};
+var cosineDistanceOperation = Object.freeze({
+  method: "cosineDistance",
+  args: [{ kind: "param" }],
+  returns: { kind: "builtin", type: "number" },
+  lowering: cosineLowering
+});
+var 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
+    }
+  ]
+};
+var pgvectorRuntimeOperation = {
+  forTypeId: pgvectorTypeId,
+  ...cosineDistanceOperation
+};
+
+export {
+  pgvectorPackMeta,
+  pgvectorRuntimeOperation
+};
+//# sourceMappingURL=chunk-QZXQPESZ.js.map

package/dist/exports/chunk-QZXQPESZ.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/exports/control.d.ts

@@ -1,8 +1,9 @@
-import { ControlExtensionDescriptor } from '@prisma-next/core-control-plane/types';
+import { SqlControlExtensionDescriptor } from '@prisma-next/family-sql/control';
 
 /**
  * pgvector extension descriptor for CLI config.
+ * Declares database dependencies for the 'vector' Postgres extension.
  */
-declare const pgvectorExtensionDescriptor: ControlExtensionDescriptor<'sql', 'postgres'>;
+declare const pgvectorExtensionDescriptor: SqlControlExtensionDescriptor<'postgres'>;
 
-export { pgvectorExtensionDescriptor as default };
+export { pgvectorExtensionDescriptor as default, pgvectorExtensionDescriptor };

package/dist/exports/control.js

@@ -1,47 +1,59 @@
+import {
+  pgvectorPackMeta
+} from "./chunk-QZXQPESZ.js";
+
 // src/exports/control.ts
-import { readFileSync } from "fs";
-import { dirname, join } from "path";
-import { fileURLToPath } from "url";
-import { type } from "arktype";
-var __filename = fileURLToPath(import.meta.url);
-var __dirname = dirname(__filename);
-var TypesImportSpecSchema = type({
-  package: "string",
-  named: "string",
-  alias: "string"
-});
-var ExtensionPackManifestSchema = type({
-  id: "string",
-  version: "string",
-  "targets?": type({ "[string]": type({ "minVersion?": "string" }) }),
-  "capabilities?": "Record<string, unknown>",
-  "types?": type({
-    "codecTypes?": type({
-      import: TypesImportSpecSchema
-    }),
-    "operationTypes?": type({
-      import: TypesImportSpecSchema
-    })
-  }),
-  "operations?": "unknown[]"
-});
-function loadExtensionManifest() {
-  const manifestPath = join(__dirname, "../../packs/manifest.json");
-  const manifestJson = JSON.parse(readFileSync(manifestPath, "utf-8"));
-  const result = ExtensionPackManifestSchema(manifestJson);
-  if (result instanceof type.errors) {
-    const messages = result.map((p) => p.message).join("; ");
-    throw new Error(`Invalid extension manifest structure at ${manifestPath}: ${messages}`);
+function verifyVectorExtensionInstalled(schema) {
+  if (!schema.extensions.includes("vector")) {
+    return [
+      {
+        kind: "extension_missing",
+        table: "",
+        message: 'Extension "vector" is missing from database (required by pgvector)'
+      }
+    ];
   }
-  return result;
+  return [];
 }
+var 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
+    }
+  ]
+};
 var pgvectorExtensionDescriptor = {
-  kind: "extension",
-  familyId: "sql",
-  targetId: "postgres",
-  // pgvector is postgres-specific
-  id: "pgvector",
-  manifest: loadExtensionManifest(),
+  ...pgvectorPackMeta,
+  databaseDependencies: pgvectorDatabaseDependencies,
   create: () => ({
     familyId: "sql",
     targetId: "postgres"
@@ -49,6 +61,7 @@ var pgvectorExtensionDescriptor = {
 };
 var control_default = pgvectorExtensionDescriptor;
 export {
-  control_default as default
+  control_default as default,
+  pgvectorExtensionDescriptor
 };
 //# sourceMappingURL=control.js.map

package/dist/exports/control.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/exports/control.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { ExtensionPackManifest } from '@prisma-next/contract/pack-manifest-types';\nimport type { ControlExtensionDescriptor } from '@prisma-next/core-control-plane/types';\nimport { type } from 'arktype';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\nconst TypesImportSpecSchema = type({\n  package: 'string',\n  named: 'string',\n  alias: 'string',\n});\n\nconst ExtensionPackManifestSchema = type({\n  id: 'string',\n  version: 'string',\n  'targets?': type({ '[string]': type({ 'minVersion?': 'string' }) }),\n  'capabilities?': 'Record<string, unknown>',\n  'types?': type({\n    'codecTypes?': type({\n      import: TypesImportSpecSchema,\n    }),\n    'operationTypes?': type({\n      import: TypesImportSpecSchema,\n    }),\n  }),\n  'operations?': 'unknown[]',\n});\n\n/**\n * Loads the extension pack manifest from packs/manifest.json.\n */\nfunction loadExtensionManifest(): ExtensionPackManifest {\n  const manifestPath = join(__dirname, '../../packs/manifest.json');\n  const manifestJson = JSON.parse(readFileSync(manifestPath, 'utf-8'));\n\n  const result = ExtensionPackManifestSchema(manifestJson);\n  if (result instanceof type.errors) {\n    const messages = result.map((p: { message: string }) => p.message).join('; ');\n    throw new Error(`Invalid extension manifest structure at ${manifestPath}: ${messages}`);\n  }\n\n  return result as ExtensionPackManifest;\n}\n\n/**\n * pgvector extension descriptor for CLI config.\n */\nconst pgvectorExtensionDescriptor: ControlExtensionDescriptor<'sql', 'postgres'> = {\n  kind: 'extension',\n  familyId: 'sql',\n  targetId: 'postgres', // pgvector is postgres-specific\n  id: 'pgvector',\n  manifest: loadExtensionManifest(),\n  create: () => ({\n    familyId: 'sql' as const,\n    targetId: 'postgres' as const,\n  }),\n};\n\nexport default pgvectorExtensionDescriptor;\n"],"mappings":";AAAA,SAAS,oBAAoB;AAC7B,SAAS,SAAS,YAAY;AAC9B,SAAS,qBAAqB;AAG9B,SAAS,YAAY;AAErB,IAAM,aAAa,cAAc,YAAY,GAAG;AAChD,IAAM,YAAY,QAAQ,UAAU;AAEpC,IAAM,wBAAwB,KAAK;AAAA,EACjC,SAAS;AAAA,EACT,OAAO;AAAA,EACP,OAAO;AACT,CAAC;AAED,IAAM,8BAA8B,KAAK;AAAA,EACvC,IAAI;AAAA,EACJ,SAAS;AAAA,EACT,YAAY,KAAK,EAAE,YAAY,KAAK,EAAE,eAAe,SAAS,CAAC,EAAE,CAAC;AAAA,EAClE,iBAAiB;AAAA,EACjB,UAAU,KAAK;AAAA,IACb,eAAe,KAAK;AAAA,MAClB,QAAQ;AAAA,IACV,CAAC;AAAA,IACD,mBAAmB,KAAK;AAAA,MACtB,QAAQ;AAAA,IACV,CAAC;AAAA,EACH,CAAC;AAAA,EACD,eAAe;AACjB,CAAC;AAKD,SAAS,wBAA+C;AACtD,QAAM,eAAe,KAAK,WAAW,2BAA2B;AAChE,QAAM,eAAe,KAAK,MAAM,aAAa,cAAc,OAAO,CAAC;AAEnE,QAAM,SAAS,4BAA4B,YAAY;AACvD,MAAI,kBAAkB,KAAK,QAAQ;AACjC,UAAM,WAAW,OAAO,IAAI,CAAC,MAA2B,EAAE,OAAO,EAAE,KAAK,IAAI;AAC5E,UAAM,IAAI,MAAM,2CAA2C,YAAY,KAAK,QAAQ,EAAE;AAAA,EACxF;AAEA,SAAO;AACT;AAKA,IAAM,8BAA6E;AAAA,EACjF,MAAM;AAAA,EACN,UAAU;AAAA,EACV,UAAU;AAAA;AAAA,EACV,IAAI;AAAA,EACJ,UAAU,sBAAsB;AAAA,EAChC,QAAQ,OAAO;AAAA,IACb,UAAU;AAAA,IACV,UAAU;AAAA,EACZ;AACF;AAEA,IAAO,kBAAQ;","names":[]}
+{"version":3,"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 { pgvectorPackMeta } from '../core/descriptor-meta';\n\n/**\n * Pure verification hook: checks whether the 'vector' extension is installed\n * based on the in-memory schema IR (no DB I/O).\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\n/**\n * Database dependencies for the pgvector extension.\n * Declares the 'vector' Postgres extension as a required dependency.\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\n/**\n * pgvector extension descriptor for CLI config.\n * Declares database dependencies for the 'vector' Postgres extension.\n */\nconst pgvectorExtensionDescriptor: SqlControlExtensionDescriptor<'postgres'> = {\n  ...pgvectorPackMeta,\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":";;;;;AAYA,SAAS,+BAA+B,QAA6C;AACnF,MAAI,CAAC,OAAO,WAAW,SAAS,QAAQ,GAAG;AACzC,WAAO;AAAA,MACL;AAAA,QACE,MAAM;AAAA,QACN,OAAO;AAAA,QACP,SAAS;AAAA,MACX;AAAA,IACF;AAAA,EACF;AACA,SAAO,CAAC;AACV;AAMA,IAAM,+BAAuE;AAAA,EAC3E,MAAM;AAAA,IACJ;AAAA,MACE,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,SAAS;AAAA,QACP;AAAA,UACE,IAAI;AAAA,UACJ,OAAO;AAAA,UACP,SAAS;AAAA,UACT,gBAAgB;AAAA,UAChB,QAAQ,EAAE,IAAI,WAAW;AAAA,UACzB,UAAU;AAAA,YACR;AAAA,cACE,aAAa;AAAA,cACb,KAAK;AAAA,YACP;AAAA,UACF;AAAA,UACA,SAAS;AAAA,YACP;AAAA,cACE,aAAa;AAAA,cACb,KAAK;AAAA,YACP;AAAA,UACF;AAAA,UACA,WAAW;AAAA,YACT;AAAA,cACE,aAAa;AAAA,cACb,KAAK;AAAA,YACP;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,MACA,mCAAmC;AAAA,IACrC;AAAA,EACF;AACF;AAMA,IAAM,8BAAyE;AAAA,EAC7E,GAAG;AAAA,EACH,sBAAsB;AAAA,EACtB,QAAQ,OAAO;AAAA,IACb,UAAU;AAAA,IACV,UAAU;AAAA,EACZ;AACF;AAGA,IAAO,kBAAQ;","names":[]}

package/dist/exports/pack.d.ts

@@ -0,0 +1,52 @@
+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 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 { pgvectorPack as default };

package/dist/exports/pack.js

@@ -0,0 +1,11 @@
+import {
+  pgvectorPackMeta
+} from "./chunk-QZXQPESZ.js";
+
+// src/exports/pack.ts
+var pgvectorPack = pgvectorPackMeta;
+var pack_default = pgvectorPack;
+export {
+  pack_default as default
+};
+//# sourceMappingURL=pack.js.map

package/dist/exports/pack.js.map

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

package/dist/exports/runtime.d.ts

@@ -1,9 +1,9 @@
-import { Extension } from '@prisma-next/sql-runtime';
+import { SqlRuntimeExtensionDescriptor } from '@prisma-next/sql-runtime';
 
 /**
- * Creates a pgvector extension instance for runtime registration.
- * Provides codecs and operations for vector data type and similarity operations.
+ * pgvector SQL runtime extension descriptor.
+ * Provides metadata and factory for creating runtime extension instances.
  */
-declare function pgvector(): Extension;
+declare const pgvectorRuntimeDescriptor: SqlRuntimeExtensionDescriptor<'postgres'>;
 
-export { pgvector as default };
+export { pgvectorRuntimeDescriptor as default };

package/dist/exports/runtime.js

@@ -1,3 +1,8 @@
+import {
+  pgvectorPackMeta,
+  pgvectorRuntimeOperation
+} from "./chunk-QZXQPESZ.js";
+
 // src/exports/runtime.ts
 import { createCodecRegistry } from "@prisma-next/sql-relational-core/ast";
 
@@ -50,33 +55,32 @@ var codecDefinitions = codecs.codecDefinitions;
 var dataTypes = codecs.dataTypes;
 
 // src/exports/runtime.ts
-function pgvector() {
-  return {
-    codecs() {
-      const registry = createCodecRegistry();
-      for (const def of Object.values(codecDefinitions)) {
-        registry.register(def.codec);
-      }
-      return registry;
-    },
-    operations() {
-      return [
-        {
-          forTypeId: "pg/vector@1",
-          method: "cosineDistance",
-          args: [{ kind: "param" }],
-          returns: { kind: "builtin", type: "number" },
-          lowering: {
-            targetFamily: "sql",
-            strategy: "function",
-            template: "1 - ({{self}} <=> {{arg0}})"
-          }
-        }
-      ];
+var PgVectorRuntimeExtensionInstance = class {
+  familyId = "sql";
+  targetId = "postgres";
+  codecs() {
+    const registry = createCodecRegistry();
+    for (const def of Object.values(codecDefinitions)) {
+      registry.register(def.codec);
     }
-  };
-}
+    return registry;
+  }
+  operations() {
+    return [pgvectorRuntimeOperation];
+  }
+};
+var pgvectorRuntimeDescriptor = {
+  kind: "extension",
+  id: pgvectorPackMeta.id,
+  version: pgvectorPackMeta.version,
+  familyId: "sql",
+  targetId: "postgres",
+  create() {
+    return new PgVectorRuntimeExtensionInstance();
+  }
+};
+var runtime_default = pgvectorRuntimeDescriptor;
 export {
-  pgvector as default
+  runtime_default as default
 };
 //# sourceMappingURL=runtime.js.map

package/dist/exports/runtime.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/exports/runtime.ts","../../src/core/codecs.ts"],"sourcesContent":["import type { SqlOperationSignature } from '@prisma-next/sql-operations';\nimport type { CodecRegistry } from '@prisma-next/sql-relational-core/ast';\nimport { createCodecRegistry } from '@prisma-next/sql-relational-core/ast';\nimport type { Extension } from '@prisma-next/sql-runtime';\nimport { codecDefinitions } from '../core/codecs';\n\n/**\n * Creates a pgvector extension instance for runtime registration.\n * Provides codecs and operations for vector data type and similarity operations.\n */\nexport default function pgvector(): Extension {\n  return {\n    codecs(): CodecRegistry {\n      const registry = createCodecRegistry();\n      // Register all codecs from codecDefinitions\n      for (const def of Object.values(codecDefinitions)) {\n        registry.register(def.codec);\n      }\n      return registry;\n    },\n    operations(): ReadonlyArray<SqlOperationSignature> {\n      return [\n        {\n          forTypeId: 'pg/vector@1',\n          method: 'cosineDistance',\n          args: [{ kind: 'param' }],\n          returns: { kind: 'builtin', type: 'number' },\n          lowering: {\n            targetFamily: 'sql',\n            strategy: 'function',\n            template: '1 - ({{self}} <=> {{arg0}})',\n          },\n        },\n      ];\n    },\n  };\n}\n","/**\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"],"mappings":";AAEA,SAAS,2BAA2B;;;ACKpC,SAAS,OAAO,oBAAoB;AAEpC,IAAM,gBAAgB,MAAuC;AAAA,EAC3D,QAAQ;AAAA,EACR,aAAa,CAAC,QAAQ;AAAA,EACtB,QAAQ,CAAC,UAA4B;AAEnC,QAAI,CAAC,MAAM,QAAQ,KAAK,GAAG;AACzB,YAAM,IAAI,MAAM,0CAA0C;AAAA,IAC5D;AACA,QAAI,CAAC,MAAM,MAAM,CAAC,MAAM,OAAO,MAAM,QAAQ,GAAG;AAC9C,YAAM,IAAI,MAAM,wCAAwC;AAAA,IAC1D;AAGA,WAAO,IAAI,MAAM,KAAK,GAAG,CAAC;AAAA,EAC5B;AAAA,EACA,QAAQ,CAAC,SAA2B;AAElC,QAAI,OAAO,SAAS,UAAU;AAC5B,YAAM,IAAI,MAAM,oCAAoC;AAAA,IACtD;AAEA,QAAI,CAAC,KAAK,WAAW,GAAG,KAAK,CAAC,KAAK,SAAS,GAAG,GAAG;AAChD,YAAM,IAAI,MAAM,iDAAiD,IAAI,GAAG;AAAA,IAC1E;AACA,UAAM,UAAU,KAAK,MAAM,GAAG,EAAE,EAAE,KAAK;AACvC,QAAI,YAAY,IAAI;AAClB,aAAO,CAAC;AAAA,IACV;AACA,UAAM,SAAS,QAAQ,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM;AAC3C,YAAM,MAAM,OAAO,WAAW,EAAE,KAAK,CAAC;AACtC,UAAI,OAAO,MAAM,GAAG,GAAG;AACrB,cAAM,IAAI,MAAM,0BAA0B,CAAC,mBAAmB;AAAA,MAChE;AACA,aAAO;AAAA,IACT,CAAC;AACD,WAAO;AAAA,EACT;AAAA,EACA,MAAM;AAAA,IACJ,IAAI;AAAA,MACF,KAAK;AAAA,QACH,UAAU;AAAA,UACR,YAAY;AAAA,QACd;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF,CAAC;AAGD,IAAM,SAAS,aAAa,EAAE,IAAI,UAAU,aAAa;AAGlD,IAAM,mBAAmB,OAAO;AAChC,IAAM,YAAY,OAAO;;;ADpDjB,SAAR,WAAuC;AAC5C,SAAO;AAAA,IACL,SAAwB;AACtB,YAAM,WAAW,oBAAoB;AAErC,iBAAW,OAAO,OAAO,OAAO,gBAAgB,GAAG;AACjD,iBAAS,SAAS,IAAI,KAAK;AAAA,MAC7B;AACA,aAAO;AAAA,IACT;AAAA,IACA,aAAmD;AACjD,aAAO;AAAA,QACL;AAAA,UACE,WAAW;AAAA,UACX,QAAQ;AAAA,UACR,MAAM,CAAC,EAAE,MAAM,QAAQ,CAAC;AAAA,UACxB,SAAS,EAAE,MAAM,WAAW,MAAM,SAAS;AAAA,UAC3C,UAAU;AAAA,YACR,cAAc;AAAA,YACd,UAAU;AAAA,YACV,UAAU;AAAA,UACZ;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/exports/runtime.ts","../../src/core/codecs.ts"],"sourcesContent":["import type { SqlOperationSignature } from '@prisma-next/sql-operations';\nimport type { CodecRegistry } from '@prisma-next/sql-relational-core/ast';\nimport { createCodecRegistry } from '@prisma-next/sql-relational-core/ast';\nimport type {\n  SqlRuntimeExtensionDescriptor,\n  SqlRuntimeExtensionInstance,\n} from '@prisma-next/sql-runtime';\nimport { codecDefinitions } from '../core/codecs';\nimport { pgvectorPackMeta, pgvectorRuntimeOperation } from '../core/descriptor-meta';\n\n/**\n * pgvector SQL runtime extension instance.\n * Provides codecs and operations for vector data type and similarity operations.\n */\nclass PgVectorRuntimeExtensionInstance implements SqlRuntimeExtensionInstance<'postgres'> {\n  readonly familyId = 'sql' as const;\n  readonly targetId = 'postgres' as const;\n\n  codecs(): CodecRegistry {\n    const registry = createCodecRegistry();\n    // Register all codecs from codecDefinitions\n    for (const def of Object.values(codecDefinitions)) {\n      registry.register(def.codec);\n    }\n    return registry;\n  }\n\n  operations(): ReadonlyArray<SqlOperationSignature> {\n    return [pgvectorRuntimeOperation];\n  }\n}\n\n/**\n * pgvector SQL runtime extension descriptor.\n * Provides metadata and factory for creating runtime extension instances.\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  create(): SqlRuntimeExtensionInstance<'postgres'> {\n    return new PgVectorRuntimeExtensionInstance();\n  },\n};\n\nexport default pgvectorRuntimeDescriptor;\n","/**\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"],"mappings":";;;;;;AAEA,SAAS,2BAA2B;;;ACKpC,SAAS,OAAO,oBAAoB;AAEpC,IAAM,gBAAgB,MAAuC;AAAA,EAC3D,QAAQ;AAAA,EACR,aAAa,CAAC,QAAQ;AAAA,EACtB,QAAQ,CAAC,UAA4B;AAEnC,QAAI,CAAC,MAAM,QAAQ,KAAK,GAAG;AACzB,YAAM,IAAI,MAAM,0CAA0C;AAAA,IAC5D;AACA,QAAI,CAAC,MAAM,MAAM,CAAC,MAAM,OAAO,MAAM,QAAQ,GAAG;AAC9C,YAAM,IAAI,MAAM,wCAAwC;AAAA,IAC1D;AAGA,WAAO,IAAI,MAAM,KAAK,GAAG,CAAC;AAAA,EAC5B;AAAA,EACA,QAAQ,CAAC,SAA2B;AAElC,QAAI,OAAO,SAAS,UAAU;AAC5B,YAAM,IAAI,MAAM,oCAAoC;AAAA,IACtD;AAEA,QAAI,CAAC,KAAK,WAAW,GAAG,KAAK,CAAC,KAAK,SAAS,GAAG,GAAG;AAChD,YAAM,IAAI,MAAM,iDAAiD,IAAI,GAAG;AAAA,IAC1E;AACA,UAAM,UAAU,KAAK,MAAM,GAAG,EAAE,EAAE,KAAK;AACvC,QAAI,YAAY,IAAI;AAClB,aAAO,CAAC;AAAA,IACV;AACA,UAAM,SAAS,QAAQ,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM;AAC3C,YAAM,MAAM,OAAO,WAAW,EAAE,KAAK,CAAC;AACtC,UAAI,OAAO,MAAM,GAAG,GAAG;AACrB,cAAM,IAAI,MAAM,0BAA0B,CAAC,mBAAmB;AAAA,MAChE;AACA,aAAO;AAAA,IACT,CAAC;AACD,WAAO;AAAA,EACT;AAAA,EACA,MAAM;AAAA,IACJ,IAAI;AAAA,MACF,KAAK;AAAA,QACH,UAAU;AAAA,UACR,YAAY;AAAA,QACd;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF,CAAC;AAGD,IAAM,SAAS,aAAa,EAAE,IAAI,UAAU,aAAa;AAGlD,IAAM,mBAAmB,OAAO;AAChC,IAAM,YAAY,OAAO;;;ADhDhC,IAAM,mCAAN,MAA0F;AAAA,EAC/E,WAAW;AAAA,EACX,WAAW;AAAA,EAEpB,SAAwB;AACtB,UAAM,WAAW,oBAAoB;AAErC,eAAW,OAAO,OAAO,OAAO,gBAAgB,GAAG;AACjD,eAAS,SAAS,IAAI,KAAK;AAAA,IAC7B;AACA,WAAO;AAAA,EACT;AAAA,EAEA,aAAmD;AACjD,WAAO,CAAC,wBAAwB;AAAA,EAClC;AACF;AAMA,IAAM,4BAAuE;AAAA,EAC3E,MAAM;AAAA,EACN,IAAI,iBAAiB;AAAA,EACrB,SAAS,iBAAiB;AAAA,EAC1B,UAAU;AAAA,EACV,UAAU;AAAA,EACV,SAAkD;AAChD,WAAO,IAAI,iCAAiC;AAAA,EAC9C;AACF;AAEA,IAAO,kBAAQ;","names":[]}

package/package.json

@@ -1,34 +1,38 @@
 {
   "name": "@prisma-next/extension-pgvector",
-  "version": "0.1.0-dev.3",
+  "version": "0.1.0-dev.30",
   "type": "module",
   "sideEffects": false,
   "dependencies": {
     "arktype": "^2.0.0",
-    "@prisma-next/cli": "0.1.0-dev.3",
-    "@prisma-next/contract": "0.1.0-dev.3",
-    "@prisma-next/contract-authoring": "0.1.0-dev.3",
-    "@prisma-next/core-control-plane": "0.1.0-dev.3",
-    "@prisma-next/sql-operations": "0.1.0-dev.3",
-    "@prisma-next/sql-relational-core": "0.1.0-dev.3",
-    "@prisma-next/sql-runtime": "0.1.0-dev.3"
+    "@prisma-next/cli": "0.1.0-dev.30",
+    "@prisma-next/contract": "0.1.0-dev.30",
+    "@prisma-next/contract-authoring": "0.1.0-dev.30",
+    "@prisma-next/core-control-plane": "0.1.0-dev.30",
+    "@prisma-next/family-sql": "0.1.0-dev.30",
+    "@prisma-next/sql-operations": "0.1.0-dev.30",
+    "@prisma-next/sql-relational-core": "0.1.0-dev.30",
+    "@prisma-next/sql-schema-ir": "0.1.0-dev.30",
+    "@prisma-next/sql-runtime": "0.1.0-dev.30"
   },
   "devDependencies": {
+    "@vitest/coverage-v8": "^4.0.0",
     "tsup": "^8.3.0",
     "typescript": "^5.9.3",
     "vite-tsconfig-paths": "^5.1.4",
-    "vitest": "^2.1.1",
-    "@prisma-next/adapter-postgres": "0.1.0-dev.3",
-    "@prisma-next/operations": "0.1.0-dev.3",
-    "@prisma-next/sql-contract": "0.1.0-dev.3",
-    "@prisma-next/sql-contract-ts": "0.1.0-dev.3",
-    "@prisma-next/sql-lane": "0.1.0-dev.3",
+    "vitest": "^4.0.16",
+    "@prisma-next/adapter-postgres": "0.1.0-dev.30",
+    "@prisma-next/sql-contract": "0.1.0-dev.30",
+    "@prisma-next/operations": "0.1.0-dev.30",
+    "@prisma-next/sql-contract-ts": "0.1.0-dev.30",
+    "@prisma-next/sql-lane": "0.1.0-dev.30",
     "@prisma-next/test-utils": "0.0.1"
   },
   "files": [
     "dist"
   ],
   "exports": {
+    "./package.json": "./package.json",
     "./control": {
       "types": "./dist/exports/control.d.ts",
       "import": "./dist/exports/control.js"
@@ -37,6 +41,10 @@
       "types": "./dist/exports/runtime.d.ts",
       "import": "./dist/exports/runtime.js"
     },
+    "./pack": {
+      "types": "./dist/exports/pack.d.ts",
+      "import": "./dist/exports/pack.js"
+    },
     "./codec-types": {
       "types": "./dist/exports/codec-types.d.ts",
       "import": "./dist/exports/codec-types.js"
@@ -56,6 +64,8 @@
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --project tsconfig.json --noEmit",
     "lint": "biome check . --config-path ../../../biome.json --error-on-warnings",
+    "lint:fix": "biome check --write . --config-path ../../../biome.json",
+    "lint:fix:unsafe": "biome check --write --unsafe . --config-path ../../../biome.json",
     "clean": "node ../../../scripts/clean.mjs"
   }
 }