feat: adapter-owns-storage + CF native metadata filtering

.changeset/config.json

@@ -6,7 +6,7 @@
   ],
   "commit": false,
   "fixed": [
-    ["payloadcms-vectorize", "@payloadcms-vectorize/pg"]
+    ["payloadcms-vectorize", "@payloadcms-vectorize/pg", "@payloadcms-vectorize/cf"]
   ],
   "access": "public",
   "baseBranch": "main",

.claude/settings.json

@@ -0,0 +1,11 @@
+{
+  "permissions": {
+    "allow": [
+      "WebFetch(domain:developers.cloudflare.com)"
+    ],
+    "additionalDirectories": [
+      "/Users/juandominguez/development/payloadcms-vectorize/adapters/cf",
+      "/Users/juandominguez/development/payloadcms-vectorize/docs"
+    ]
+  }
+}

.github/workflows/ci.yml

@@ -4,7 +4,7 @@ on:
   push:
     branches: [main, develop]
   pull_request:
-    branches: [main]
+    branches: [main, split_db_adapter]
 
 jobs:
   typecheck:
@@ -119,6 +119,44 @@ jobs:
           IVFFLATLISTS: 1
           TEST_ENV: 1
 
+  test_adapters_cf:
+    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: Run cf adapter tests
+        run: pnpm test:adapters:cf
+        env:
+          PAYLOAD_SECRET: test-secret-key
+          TEST_ENV: 1
+
   test_e2e:
     runs-on: ubuntu-latest
 
@@ -170,14 +208,15 @@ jobs:
 
   test:
     runs-on: ubuntu-latest
-    needs: [typecheck, test_int, test_adapters_pg, test_e2e]
+    needs: [typecheck, test_int, test_adapters_pg, test_adapters_cf, 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_adapters_cf.result }}" != "success" ] || \
              [ "${{ needs.test_e2e.result }}" != "success" ]; then
             echo "One or more required jobs failed"
             exit 1

.gitignore

@@ -21,6 +21,7 @@ node_modules/
 /build
 /dist
 /adapters/pg/dist
+/adapters/cf/dist
 
 # misc
 .DS_Store
@@ -53,6 +54,5 @@ yarn-error.log*
 # Secrets
 */secret
 
-# Agent
-.cursor/
-.claude/
+# Cursor
+.cursor/

CHANGELOG.md

@@ -2,19 +2,33 @@
 
 All notable changes to this project will be documented in this file.
 
-## 0.7.0
+## 0.7.0-beta.1 - 2026-03-06
 
 ### 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.
+- **`DbAdapter` interface redesigned**: `storeEmbedding` and `deleteEmbeddings` replaced with `storeChunk`, `deleteChunks`, and `hasEmbeddingVersion`. Adapters now own all chunk storage, deletion, and version checking — the core plugin no longer calls `payload.create()` or `payload.delete()` directly for embeddings.
+- **New `StoreChunkData` type**: Adapters receive a single data object containing `sourceCollection`, `docId`, `chunkIndex`, `chunkText`, `embeddingVersion`, `embedding`, and `extensionFields`.
 
-### Added
+### Improved
 
-- **`@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.
+- **CF adapter: native Vectorize metadata filtering**: Search now uses Cloudflare Vectorize's native `filter` parameter (applied before topK) for `equals`, `not_equals`, `in`, `notIn`, `greater_than`, `greater_than_equal`, `less_than`, `less_than_equal`. Operators `like`, `contains`, `exists`, and `or` clauses are post-filtered.
+- **CF adapter: deterministic vector IDs**: Vectors are now stored with deterministic IDs (`poolName:collection:docId:chunkIndex`), enabling reliable upserts and deletions.
+- **CF adapter: metadata on vectors**: All chunk metadata (including extension fields) is stored directly on Vectorize vectors, enabling filtered search without a separate metadata collection.
+
+### Migration
+
+Custom `DbAdapter` implementations must update to the new interface:
+
+```typescript
+// Before
+storeEmbedding(payload, poolName, collection, docId, embeddingId, embedding)
+deleteEmbeddings(payload, poolName, collection, docId)
+
+// After
+storeChunk(payload, poolName, data: StoreChunkData)
+deleteChunks(payload, poolName, sourceCollection, docId)
+hasEmbeddingVersion(payload, poolName, sourceCollection, docId, embeddingVersion)
+```
 
 ## 0.6.0-beta.5 - 2026-02-25
 
@@ -36,8 +50,9 @@ All notable changes to this project will be documented in this file.
 ### Added
 
 - **`@payloadcms-vectorize/pg` package**: PostgreSQL adapter for pgvector, extracted from the core plugin.
+- **`@payloadcms-vectorize/cf` package**: Cloudflare Vectorize adapter for edge-native vector search.
 - **`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.
+- **`deleteEmbeddings` on `DbAdapter`**: Adapters can now delete vectors when a document is deleted or re-indexed. Implemented in both the `pg` and `cf` adapters.
 - **Adapter documentation**: Added `adapters/README.md` explaining how to create custom adapters.
 
 ### Migration