@prisma-next/extension-pgvector 0.1.0-dev.2 → 0.1.0-dev.20

package/README.md

@@ -12,6 +12,7 @@ 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
+- **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 +29,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 +47,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({

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 };

package/dist/exports/control.js

@@ -35,6 +35,54 @@ function loadExtensionManifest() {
   }
   return result;
 }
+function verifyVectorExtensionInstalled(schema) {
+  if (!schema.extensions.includes("vector")) {
+    return [
+      {
+        kind: "extension_missing",
+        table: "",
+        message: 'Extension "vector" is missing from database (required by pgvector)'
+      }
+    ];
+  }
+  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",
@@ -42,6 +90,7 @@ var pgvectorExtensionDescriptor = {
   // pgvector is postgres-specific
   id: "pgvector",
   manifest: loadExtensionManifest(),
+  databaseDependencies: pgvectorDatabaseDependencies,
   create: () => ({
     familyId: "sql",
     targetId: "postgres"

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 { 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 { 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 { 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 * 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  kind: 'extension',\n  familyId: 'sql',\n  targetId: 'postgres', // pgvector is postgres-specific\n  id: 'pgvector',\n  manifest: loadExtensionManifest(),\n  databaseDependencies: pgvectorDatabaseDependencies,\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;AAQ9B,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;AAMA,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,MAAM;AAAA,EACN,UAAU;AAAA,EACV,UAAU;AAAA;AAAA,EACV,IAAI;AAAA,EACJ,UAAU,sBAAsB;AAAA,EAChC,sBAAsB;AAAA,EACtB,QAAQ,OAAO;AAAA,IACb,UAAU;AAAA,IACV,UAAU;AAAA,EACZ;AACF;AAEA,IAAO,kBAAQ;","names":[]}

package/package.json

@@ -1,34 +1,37 @@
 {
   "name": "@prisma-next/extension-pgvector",
-  "version": "0.1.0-dev.2",
+  "version": "0.1.0-dev.20",
   "type": "module",
   "sideEffects": false,
   "dependencies": {
     "arktype": "^2.0.0",
-    "@prisma-next/cli": "0.1.0-dev.2",
-    "@prisma-next/contract": "0.1.0-dev.2",
-    "@prisma-next/contract-authoring": "0.1.0-dev.2",
-    "@prisma-next/core-control-plane": "0.1.0-dev.2",
-    "@prisma-next/sql-operations": "0.1.0-dev.2",
-    "@prisma-next/sql-relational-core": "0.1.0-dev.2",
-    "@prisma-next/sql-runtime": "0.1.0-dev.2"
+    "@prisma-next/cli": "0.1.0-dev.20",
+    "@prisma-next/contract": "0.1.0-dev.20",
+    "@prisma-next/contract-authoring": "0.1.0-dev.20",
+    "@prisma-next/core-control-plane": "0.1.0-dev.20",
+    "@prisma-next/family-sql": "0.1.0-dev.20",
+    "@prisma-next/sql-operations": "0.1.0-dev.20",
+    "@prisma-next/sql-relational-core": "0.1.0-dev.20",
+    "@prisma-next/sql-runtime": "0.1.0-dev.20",
+    "@prisma-next/sql-schema-ir": "0.1.0-dev.20"
   },
   "devDependencies": {
     "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.2",
-    "@prisma-next/operations": "0.1.0-dev.2",
-    "@prisma-next/sql-contract": "0.1.0-dev.2",
-    "@prisma-next/sql-contract-ts": "0.1.0-dev.2",
-    "@prisma-next/sql-lane": "0.1.0-dev.2",
+    "vitest": "^4.0.16",
+    "@prisma-next/adapter-postgres": "0.1.0-dev.20",
+    "@prisma-next/operations": "0.1.0-dev.20",
+    "@prisma-next/sql-contract": "0.1.0-dev.20",
+    "@prisma-next/sql-contract-ts": "0.1.0-dev.20",
+    "@prisma-next/sql-lane": "0.1.0-dev.20",
     "@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"
@@ -56,6 +59,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"
   }
 }