feat: DbAdapter API + pg adapter (without CF)

.changeset/README.md

@@ -0,0 +1,22 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in the readme](https://github.com/changesets/changesets/blob/main/README.md)
+
+## Usage
+
+### Adding a changeset
+
+Run `pnpm changeset` to create a new changeset. You'll be prompted to:
+1. Select which packages have changed
+2. Choose a bump type (major/minor/patch)
+3. Write a summary of the changes
+
+### Versioning
+
+Run `pnpm changeset:version` to consume all pending changesets, bump versions, and update changelogs.
+
+### Publishing
+
+Run `pnpm release` to build and publish all packages to npm.

.changeset/config.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.1/schema.json",
+  "changelog": [
+    "@changesets/changelog-github",
+    { "repo": "techiejd/payloadcms-vectorize" }
+  ],
+  "commit": false,
+  "fixed": [
+    ["payloadcms-vectorize", "@payloadcms-vectorize/pg"]
+  ],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

.github/workflows/ci.yml

@@ -7,6 +7,26 @@ on:
     branches: [main]
 
 jobs:
+  typecheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Type check all packages
+        run: pnpm build:types:all
+
   test_int:
     runs-on: ubuntu-latest
 
@@ -33,8 +53,8 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: "20"
-          cache: "pnpm"
+          node-version: '20'
+          cache: 'pnpm'
 
       - name: Install dependencies
         run: pnpm install
@@ -53,6 +73,52 @@ jobs:
           IVFFLATLISTS: 1
           TEST_ENV: 1
 
+  test_adapters_pg:
+    runs-on: ubuntu-latest
+
+    services:
+      postgres:
+        image: pgvector/pgvector:pg15
+        env:
+          POSTGRES_PASSWORD: password
+          POSTGRES_DB: payload_test
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          - 5433:5432
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Install pgvector extension
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y postgresql-client
+          PGPASSWORD=password psql -h localhost -p 5433 -U postgres -d payload_test -c "CREATE EXTENSION IF NOT EXISTS vector;"
+
+      - name: Run pg adapter tests
+        run: pnpm test:adapters:pg
+        env:
+          PAYLOAD_SECRET: test-secret-key
+          DIMS: 8
+          IVFFLATLISTS: 1
+          TEST_ENV: 1
+
   test_e2e:
     runs-on: ubuntu-latest
 
@@ -79,8 +145,8 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: "20"
-          cache: "pnpm"
+          node-version: '20'
+          cache: 'pnpm'
 
       - name: Install dependencies
         run: pnpm install
@@ -101,3 +167,18 @@ jobs:
           DIMS: 8
           IVFFLATLISTS: 1
           TEST_ENV: 1
+
+  test:
+    runs-on: ubuntu-latest
+    needs: [typecheck, test_int, test_adapters_pg, test_e2e]
+    if: always()
+    steps:
+      - name: Check required jobs
+        run: |
+          if [ "${{ needs.typecheck.result }}" != "success" ] || \
+             [ "${{ needs.test_int.result }}" != "success" ] || \
+             [ "${{ needs.test_adapters_pg.result }}" != "success" ] || \
+             [ "${{ needs.test_e2e.result }}" != "success" ]; then
+            echo "One or more required jobs failed"
+            exit 1
+          fi

.github/workflows/release.yml

@@ -0,0 +1,44 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+concurrency: ${{ github.workflow }}-${{ github.ref }}
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Create Release Pull Request or Publish
+        id: changesets
+        uses: changesets/action@v1
+        with:
+          publish: pnpm release
+          version: pnpm changeset:version
+          title: 'chore: version packages'
+          commit: 'chore: version packages'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_CONFIG_PROVENANCE: true

.gitignore

@@ -1,7 +1,7 @@
 # See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
 
 # dependencies
-/node_modules
+node_modules/
 /.pnp
 .pnp.js
 .yarn/install-state.gz
@@ -20,6 +20,7 @@
 # production
 /build
 /dist
+/adapters/pg/dist
 
 # misc
 .DS_Store

CHANGELOG.md

@@ -2,6 +2,108 @@
 
 All notable changes to this project will be documented in this file.
 
+## 0.7.0
+
+### Breaking Changes
+
+- **Database Adapter Architecture**: The plugin now uses a pluggable database adapter system. You must install a database adapter package (e.g., `@payloadcms-vectorize/pg`) separately from the core plugin.
+- **`dbAdapter` option required**: The `payloadcmsVectorize()` plugin now requires a `dbAdapter` option pointing to your adapter's implementation.
+- **`similarity` renamed to `score`**: The `VectorSearchResult.similarity` field has been renamed to `score` to be more generic across different distance metrics.
+
+### Added
+
+- **`@payloadcms-vectorize/pg` package**: PostgreSQL adapter for pgvector, extracted from the core plugin.
+- **`DbAdapter` interface**: New interface for implementing custom database adapters. See `adapters/README.md`.
+- **`deleteEmbeddings` on `DbAdapter`**: Adapters can now delete vectors when a document is deleted or re-indexed.
+
+## 0.6.0-beta.5 - 2026-02-25
+
+- Merges main into split_db_adapter (per-batch polling, coordinator/worker architecture, destroyPayload cleanup).
+
+## 0.6.0-beta.4 - 2026-02-20
+
+- Merges main with should embed changes.
+
+## 0.6.0-beta - 2026-02-01
+
+### Breaking Changes
+
+- **Database Adapter Architecture**: The plugin now uses a pluggable database adapter system. You must install a database adapter package (e.g., `@payloadcms-vectorize/pg`) separately from the core plugin.
+- **`createVectorizeIntegration` removed from core**: Use the adapter-specific integration factory instead (e.g., `createPostgresVectorIntegration` from `@payloadcms-vectorize/pg`).
+- **`dbAdapter` option required**: The `payloadcmsVectorize()` plugin now requires a `dbAdapter` option pointing to your adapter's implementation.
+- **`similarity` renamed to `score`**: The `VectorSearchResult.similarity` field has been renamed to `score` to be more generic across different distance metrics.
+
+### Added
+
+- **`@payloadcms-vectorize/pg` package**: PostgreSQL adapter for pgvector, extracted from the core plugin.
+- **`DbAdapter` interface**: New interface for implementing custom database adapters. See `adapters/README.md`.
+- **`deleteEmbeddings` on `DbAdapter`**: Adapters can now delete vectors when a document is deleted or re-indexed.
+- **Adapter documentation**: Added `adapters/README.md` explaining how to create custom adapters.
+
+### Migration
+
+**Before (0.5.x)**
+
+```typescript
+import { createVectorizeIntegration } from 'payloadcms-vectorize'
+
+const { afterSchemaInitHook, payloadcmsVectorize } = createVectorizeIntegration({
+  main: { dims: 1536, ivfflatLists: 100 },
+})
+
+export default buildConfig({
+  db: postgresAdapter({
+    afterSchemaInit: [afterSchemaInitHook],
+  }),
+  plugins: [
+    payloadcmsVectorize({
+      knowledgePools: {
+        main: {
+          /* ... */
+        },
+      },
+    }),
+  ],
+})
+```
+
+**After (0.6.0+)**
+
+```typescript
+import { createPostgresVectorIntegration } from '@payloadcms-vectorize/pg'
+import payloadcmsVectorize from 'payloadcms-vectorize'
+
+const integration = createPostgresVectorIntegration({
+  main: { dims: 1536, ivfflatLists: 100 },
+})
+
+export default buildConfig({
+  db: postgresAdapter({
+    afterSchemaInit: [integration.afterSchemaInitHook],
+  }),
+  plugins: [
+    payloadcmsVectorize({
+      dbAdapter: integration.adapter,
+      knowledgePools: {
+        main: {
+          /* ... */
+        },
+      },
+    }),
+  ],
+})
+```
+
+**Updating search result handling:**
+
+```typescript
+// Before
+const score = result.similarity
+
+// After
+const score = result.score
+```
+
 ## 0.5.5 - 2026-02-24
 
 ### Added