@payloadcms-vectorize/cf 0.6.0-beta

package/README.md

@@ -0,0 +1,210 @@
+# @payloadcms-vectorize/cf
+
+Cloudflare Vectorize adapter for [payloadcms-vectorize](https://github.com/techiejd/payloadcms-vectorize). Enables vector search capabilities using Cloudflare Vectorize.
+
+## Prerequisites
+
+- Cloudflare account with Vectorize index configured
+- Payload CMS 3.x with any supported database adapter
+- Node.js 18+
+
+## Installation
+
+```bash
+pnpm add @payloadcms-vectorize/cf payloadcms-vectorize
+```
+
+## Quick Start
+
+### 1. Create Vectorize Index
+
+Create a Vectorize index in your Cloudflare dashboard or via Wrangler:
+
+```bash
+wrangler vectorize create my-vectorize-index --dimensions=384 --metric=cosine
+```
+
+### 2. Configure the Plugin
+
+```typescript
+import { buildConfig } from 'payload'
+import { postgresAdapter } from '@payloadcms/db-postgres'
+import { createCloudflareVectorizeIntegration } from '@payloadcms-vectorize/cf'
+import payloadcmsVectorize from 'payloadcms-vectorize'
+
+// Create the integration
+const integration = createCloudflareVectorizeIntegration({
+  config: {
+    default: {
+      dims: 384, // Vector dimensions (must match your embedding model and Vectorize index)
+    },
+  },
+  binding: env.VECTORIZE, // Cloudflare Vectorize binding
+})
+
+export default buildConfig({
+  // ... your existing config
+  db: postgresAdapter({
+    pool: {
+      connectionString: process.env.DATABASE_URL,
+    },
+  }),
+  plugins: [
+    payloadcmsVectorize({
+      dbAdapter: integration.adapter,
+      knowledgePools: {
+        default: {
+          collections: {
+            posts: {
+              toKnowledgePool: async (doc) => [{ chunk: doc.title || '' }],
+            },
+          },
+          embeddingConfig: {
+            version: 'v1.0.0',
+            queryFn: embedQuery,
+            realTimeIngestionFn: embedDocs,
+          },
+        },
+      },
+    }),
+  ],
+})
+```
+
+## Configuration
+
+The `createCloudflareVectorizeIntegration` function accepts a configuration object with `config` and `binding` properties:
+
+```typescript
+const integration = createCloudflareVectorizeIntegration({
+  config: {
+    poolName: {
+      dims: number, // Required: Vector dimensions
+    },
+    // ... additional pools
+  },
+  binding: vectorizeBinding, // Required: Cloudflare Vectorize binding
+})
+```
+
+### Configuration Options
+
+| Option | Type     | Required | Description                                                                                                                                       |
+| ------ | -------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `dims` | `number` | Yes      | Vector dimensions for the Vectorize index. Must match your embedding model's output dimensions and your Cloudflare Vectorize index configuration. |
+
+### Cloudflare Bindings
+
+| Property    | Type             | Required | Description                                                                                       |
+| ----------- | ---------------- | -------- | ------------------------------------------------------------------------------------------------- |
+| `vectorize` | `VectorizeIndex` | Yes      | Cloudflare Vectorize binding for vector storage. Configured in `wrangler.toml` for Workers/Pages. |
+
+## Integration Return Value
+
+`createCloudflareVectorizeIntegration` returns an object with:
+
+| Property  | Type        | Description                                                               |
+| --------- | ----------- | ------------------------------------------------------------------------- |
+| `adapter` | `DbAdapter` | The database adapter to pass to `payloadcmsVectorize({ dbAdapter: ... })` |
+
+## Multiple Knowledge Pools
+
+You can configure multiple knowledge pools with different dimensions:
+
+```typescript
+const integration = createCloudflareVectorizeIntegration({
+  config: {
+    documents: {
+      dims: 1536,
+    },
+    images: {
+      dims: 512,
+    },
+  },
+  binding: env.VECTORIZE,
+})
+
+export default buildConfig({
+  // ...
+  plugins: [
+    payloadcmsVectorize({
+      dbAdapter: integration.adapter,
+      knowledgePools: {
+        documents: {
+          collections: {
+            /* ... */
+          },
+          embeddingConfig: {
+            /* ... */
+          },
+        },
+        images: {
+          collections: {
+            /* ... */
+          },
+          embeddingConfig: {
+            /* ... */
+          },
+        },
+      },
+    }),
+  ],
+})
+```
+
+**Note:** Each knowledge pool requires a separate Vectorize index with matching dimensions.
+
+## Using with Cloudflare AI
+
+```typescript
+export const embedDocs = async (texts: string[]): Promise<number[][]> => {
+  const results = await Promise.all(
+    texts.map((text) =>
+      env.AI.run('@cf/baai/bge-small-en-v1.5', {
+        text,
+      }),
+    ),
+  )
+  return results.map((r) => r.data[0])
+}
+
+export const embedQuery = async (text: string): Promise<number[]> => {
+  const result = await env.AI.run('@cf/baai/bge-small-en-v1.5', {
+    text,
+  })
+  return result.data[0]
+}
+```
+
+## Using with Voyage AI
+
+```typescript
+import { embed, embedMany } from 'ai'
+import { voyage } from 'voyage-ai-provider'
+
+export const embedDocs = async (texts: string[]): Promise<number[][]> => {
+  const embedResult = await embedMany({
+    model: voyage.textEmbeddingModel('voyage-3.5-lite'),
+    values: texts,
+    providerOptions: {
+      voyage: { inputType: 'document' },
+    },
+  })
+  return embedResult.embeddings
+}
+
+export const embedQuery = async (text: string): Promise<number[]> => {
+  const embedResult = await embed({
+    model: voyage.textEmbeddingModel('voyage-3.5-lite'),
+    value: text,
+    providerOptions: {
+      voyage: { inputType: 'query' },
+    },
+  })
+  return embedResult.embedding
+}
+```
+
+## License
+
+MIT

package/dist/embed.js

@@ -0,0 +1,27 @@
+import { getVectorizedPayload } from 'payloadcms-vectorize';
+/**
+ * Store an embedding vector in Cloudflare Vectorize
+ * Also creates a Payload document for the metadata
+ */ export default (async (payload, poolName, id, embedding)=>{
+    // Get Cloudflare binding from config
+    const vectorizeBinding = getVectorizedPayload(payload).getDbAdapterCustom()._vectorizeBinding;
+    if (!vectorizeBinding) {
+        throw new Error('[@payloadcms-vectorize/cf] Cloudflare Vectorize binding not found');
+    }
+    try {
+        const vector = Array.isArray(embedding) ? embedding : Array.from(embedding);
+        // Upsert the vector in Cloudflare Vectorize
+        await vectorizeBinding.upsert([
+            {
+                id,
+                values: vector
+            }
+        ]);
+    } catch (e) {
+        const errorMessage = e.message || e.toString();
+        payload.logger.error(`[@payloadcms-vectorize/cf] Failed to store embedding: ${errorMessage}`);
+        throw new Error(`[@payloadcms-vectorize/cf] Failed to store embedding: ${errorMessage}`);
+    }
+});
+
+//# sourceMappingURL=embed.js.map

package/dist/embed.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/embed.ts"],"sourcesContent":["import { Payload } from 'payload'\nimport { getVectorizedPayload } from 'payloadcms-vectorize'\n\n/**\n * Store an embedding vector in Cloudflare Vectorize\n * Also creates a Payload document for the metadata\n */\nexport default async (\n  payload: Payload,\n  poolName: string,\n  id: string,\n  embedding: number[] | Float32Array,\n) => {\n  // Get Cloudflare binding from config\n  const vectorizeBinding = getVectorizedPayload(payload).getDbAdapterCustom()._vectorizeBinding\n  if (!vectorizeBinding) {\n    throw new Error('[@payloadcms-vectorize/cf] Cloudflare Vectorize binding not found')\n  }\n\n  try {\n    const vector = Array.isArray(embedding) ? embedding : Array.from(embedding)\n\n    // Upsert the vector in Cloudflare Vectorize\n    await vectorizeBinding.upsert([\n      {\n        id,\n        values: vector,\n      },\n    ])\n  } catch (e) {\n    const errorMessage = (e as Error).message || (e as any).toString()\n    payload.logger.error(`[@payloadcms-vectorize/cf] Failed to store embedding: ${errorMessage}`)\n    throw new Error(`[@payloadcms-vectorize/cf] Failed to store embedding: ${errorMessage}`)\n  }\n}\n"],"names":["getVectorizedPayload","payload","poolName","id","embedding","vectorizeBinding","getDbAdapterCustom","_vectorizeBinding","Error","vector","Array","isArray","from","upsert","values","e","errorMessage","message","toString","logger","error"],"mappings":"AACA,SAASA,oBAAoB,QAAQ,uBAAsB;AAE3D;;;CAGC,GACD,eAAe,CAAA,OACbC,SACAC,UACAC,IACAC;IAEA,qCAAqC;IACrC,MAAMC,mBAAmBL,qBAAqBC,SAASK,kBAAkB,GAAGC,iBAAiB;IAC7F,IAAI,CAACF,kBAAkB;QACrB,MAAM,IAAIG,MAAM;IAClB;IAEA,IAAI;QACF,MAAMC,SAASC,MAAMC,OAAO,CAACP,aAAaA,YAAYM,MAAME,IAAI,CAACR;QAEjE,4CAA4C;QAC5C,MAAMC,iBAAiBQ,MAAM,CAAC;YAC5B;gBACEV;gBACAW,QAAQL;YACV;SACD;IACH,EAAE,OAAOM,GAAG;QACV,MAAMC,eAAe,AAACD,EAAYE,OAAO,IAAI,AAACF,EAAUG,QAAQ;QAChEjB,QAAQkB,MAAM,CAACC,KAAK,CAAC,CAAC,sDAAsD,EAAEJ,cAAc;QAC5F,MAAM,IAAIR,MAAM,CAAC,sDAAsD,EAAEQ,cAAc;IACzF;AACF,CAAA,EAAC"}

package/dist/index.js

@@ -0,0 +1,81 @@
+import embed from './embed';
+import search from './search';
+/**
+ * Create a Cloudflare Vectorize integration for payloadcms-vectorize
+ *
+ * @param options Configuration object with knowledge pools and Vectorize binding
+ * @returns Object containing the DbAdapter instance
+ *
+ * @example
+ * ```typescript
+ * import { createCloudflareVectorizeIntegration } from '@payloadcms-vectorize/cf'
+ *
+ * const { adapter } = createCloudflareVectorizeIntegration({
+ *   config: {
+ *     default: {
+ *       dims: 384,
+ *     },
+ *   },
+ *   binding: env.VECTORIZE,
+ * })
+ * ```
+ */ export const createCloudflareVectorizeIntegration = (options)=>{
+    if (!options.binding) {
+        throw new Error('[@payloadcms-vectorize/cf] Cloudflare Vectorize binding is required');
+    }
+    const poolConfig = options.config;
+    const adapter = {
+        getConfigExtension: ()=>{
+            return {
+                custom: {
+                    _cfVectorizeAdapter: true,
+                    _poolConfigs: poolConfig,
+                    _vectorizeBinding: options.binding
+                }
+            };
+        },
+        search: async (payload, queryEmbedding, poolName, limit, where)=>{
+            return search(payload, queryEmbedding, poolName, limit, where);
+        },
+        storeEmbedding: async (payload, poolName, id, embedding)=>{
+            return embed(payload, poolName, id, embedding);
+        },
+        deleteEmbeddings: async (payload, poolName, sourceCollection, docId)=>{
+            // Delete all embeddings for this document from Cloudflare Vectorize
+            // First, query to find all matching IDs
+            const vectorizeBinding = options.binding;
+            const dims = poolConfig[poolName]?.dims || 384;
+            try {
+                const results = await vectorizeBinding.query(new Array(dims).fill(0), {
+                    topK: 10000,
+                    returnMetadata: true,
+                    where: {
+                        and: [
+                            {
+                                key: 'sourceCollection',
+                                value: sourceCollection
+                            },
+                            {
+                                key: 'docId',
+                                value: docId
+                            }
+                        ]
+                    }
+                });
+                const idsToDelete = (results.matches || []).map((match)=>match.id);
+                if (idsToDelete.length > 0) {
+                    await vectorizeBinding.delete(idsToDelete);
+                }
+            } catch (error) {
+                const errorMessage = error.message || error.toString();
+                payload.logger.error(`[@payloadcms-vectorize/cf] Failed to delete embeddings: ${errorMessage}`);
+                throw new Error(`[@payloadcms-vectorize/cf] Failed to delete embeddings: ${errorMessage}`);
+            }
+        }
+    };
+    return {
+        adapter
+    };
+};
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { DbAdapter } from 'payloadcms-vectorize'\nimport type { CloudflareVectorizeBinding, KnowledgePoolsConfig } from './types'\nimport embed from './embed'\nimport search from './search'\n\n/**\n * Configuration for Cloudflare Vectorize integration\n */\ninterface CloudflareVectorizeConfig {\n  /** Knowledge pools configuration with their dimensions */\n  config: KnowledgePoolsConfig\n  /** Cloudflare Vectorize binding for vector storage */\n  binding: CloudflareVectorizeBinding\n}\n\n/**\n * Create a Cloudflare Vectorize integration for payloadcms-vectorize\n *\n * @param options Configuration object with knowledge pools and Vectorize binding\n * @returns Object containing the DbAdapter instance\n *\n * @example\n * ```typescript\n * import { createCloudflareVectorizeIntegration } from '@payloadcms-vectorize/cf'\n *\n * const { adapter } = createCloudflareVectorizeIntegration({\n *   config: {\n *     default: {\n *       dims: 384,\n *     },\n *   },\n *   binding: env.VECTORIZE,\n * })\n * ```\n */\nexport const createCloudflareVectorizeIntegration = (\n  options: CloudflareVectorizeConfig,\n): { adapter: DbAdapter } => {\n  if (!options.binding) {\n    throw new Error('[@payloadcms-vectorize/cf] Cloudflare Vectorize binding is required')\n  }\n\n  const poolConfig = options.config\n\n  const adapter: DbAdapter = {\n    getConfigExtension: () => {\n      return {\n        custom: {\n          _cfVectorizeAdapter: true,\n          _poolConfigs: poolConfig,\n          _vectorizeBinding: options.binding,\n        },\n      }\n    },\n\n    search: async (payload, queryEmbedding, poolName, limit, where) => {\n      return search(payload, queryEmbedding, poolName, limit, where)\n    },\n\n    storeEmbedding: async (payload, poolName, id, embedding) => {\n      return embed(payload, poolName, id, embedding)\n    },\n\n    deleteEmbeddings: async (payload, poolName, sourceCollection, docId) => {\n      // Delete all embeddings for this document from Cloudflare Vectorize\n      // First, query to find all matching IDs\n      const vectorizeBinding = options.binding\n      const dims = poolConfig[poolName]?.dims || 384\n      try {\n        const results = await vectorizeBinding.query(new Array(dims).fill(0), {\n          topK: 10000,\n          returnMetadata: true,\n          where: {\n            and: [\n              { key: 'sourceCollection', value: sourceCollection },\n              { key: 'docId', value: docId },\n            ],\n          },\n        })\n\n        const idsToDelete = (results.matches || []).map((match: any) => match.id)\n\n        if (idsToDelete.length > 0) {\n          await vectorizeBinding.delete(idsToDelete)\n        }\n      } catch (error) {\n        const errorMessage = (error as Error).message || (error as any).toString()\n        payload.logger.error(\n          `[@payloadcms-vectorize/cf] Failed to delete embeddings: ${errorMessage}`,\n        )\n        throw new Error(`[@payloadcms-vectorize/cf] Failed to delete embeddings: ${errorMessage}`)\n      }\n    },\n  }\n\n  return { adapter }\n}\n\nexport type { CloudflareVectorizeBinding, KnowledgePoolsConfig }\nexport type { KnowledgePoolsConfig as KnowledgePoolConfig }\n"],"names":["embed","search","createCloudflareVectorizeIntegration","options","binding","Error","poolConfig","config","adapter","getConfigExtension","custom","_cfVectorizeAdapter","_poolConfigs","_vectorizeBinding","payload","queryEmbedding","poolName","limit","where","storeEmbedding","id","embedding","deleteEmbeddings","sourceCollection","docId","vectorizeBinding","dims","results","query","Array","fill","topK","returnMetadata","and","key","value","idsToDelete","matches","map","match","length","delete","error","errorMessage","message","toString","logger"],"mappings":"AAEA,OAAOA,WAAW,UAAS;AAC3B,OAAOC,YAAY,WAAU;AAY7B;;;;;;;;;;;;;;;;;;;CAmBC,GACD,OAAO,MAAMC,uCAAuC,CAClDC;IAEA,IAAI,CAACA,QAAQC,OAAO,EAAE;QACpB,MAAM,IAAIC,MAAM;IAClB;IAEA,MAAMC,aAAaH,QAAQI,MAAM;IAEjC,MAAMC,UAAqB;QACzBC,oBAAoB;YAClB,OAAO;gBACLC,QAAQ;oBACNC,qBAAqB;oBACrBC,cAAcN;oBACdO,mBAAmBV,QAAQC,OAAO;gBACpC;YACF;QACF;QAEAH,QAAQ,OAAOa,SAASC,gBAAgBC,UAAUC,OAAOC;YACvD,OAAOjB,OAAOa,SAASC,gBAAgBC,UAAUC,OAAOC;QAC1D;QAEAC,gBAAgB,OAAOL,SAASE,UAAUI,IAAIC;YAC5C,OAAOrB,MAAMc,SAASE,UAAUI,IAAIC;QACtC;QAEAC,kBAAkB,OAAOR,SAASE,UAAUO,kBAAkBC;YAC5D,oEAAoE;YACpE,wCAAwC;YACxC,MAAMC,mBAAmBtB,QAAQC,OAAO;YACxC,MAAMsB,OAAOpB,UAAU,CAACU,SAAS,EAAEU,QAAQ;YAC3C,IAAI;gBACF,MAAMC,UAAU,MAAMF,iBAAiBG,KAAK,CAAC,IAAIC,MAAMH,MAAMI,IAAI,CAAC,IAAI;oBACpEC,MAAM;oBACNC,gBAAgB;oBAChBd,OAAO;wBACLe,KAAK;4BACH;gCAAEC,KAAK;gCAAoBC,OAAOZ;4BAAiB;4BACnD;gCAAEW,KAAK;gCAASC,OAAOX;4BAAM;yBAC9B;oBACH;gBACF;gBAEA,MAAMY,cAAc,AAACT,CAAAA,QAAQU,OAAO,IAAI,EAAE,AAAD,EAAGC,GAAG,CAAC,CAACC,QAAeA,MAAMnB,EAAE;gBAExE,IAAIgB,YAAYI,MAAM,GAAG,GAAG;oBAC1B,MAAMf,iBAAiBgB,MAAM,CAACL;gBAChC;YACF,EAAE,OAAOM,OAAO;gBACd,MAAMC,eAAe,AAACD,MAAgBE,OAAO,IAAI,AAACF,MAAcG,QAAQ;gBACxE/B,QAAQgC,MAAM,CAACJ,KAAK,CAClB,CAAC,wDAAwD,EAAEC,cAAc;gBAE3E,MAAM,IAAItC,MAAM,CAAC,wDAAwD,EAAEsC,cAAc;YAC3F;QACF;IACF;IAEA,OAAO;QAAEnC;IAAQ;AACnB,EAAC"}

package/dist/search.js

@@ -0,0 +1,86 @@
+import { getVectorizedPayload } from 'payloadcms-vectorize';
+/**
+ * Search for similar vectors in Cloudflare Vectorize
+ */ export default (async (payload, queryEmbedding, poolName, limit = 10, where)=>{
+    // Get Cloudflare binding from config
+    const vectorizeBinding = getVectorizedPayload(payload).getDbAdapterCustom()._vectorizeBinding;
+    if (!vectorizeBinding) {
+        throw new Error('[@payloadcms-vectorize/cf] Cloudflare Vectorize binding not found');
+    }
+    try {
+        // Get collection config
+        const collectionConfig = payload.collections[poolName]?.config;
+        if (!collectionConfig) {
+            throw new Error(`Collection ${poolName} not found`);
+        }
+        // Query Cloudflare Vectorize
+        // The query returns the top-k most similar vectors
+        const results = await vectorizeBinding.query(queryEmbedding, {
+            topK: limit,
+            returnMetadata: true
+        });
+        if (!results.matches) {
+            return [];
+        }
+        // Fetch full documents from Payload for metadata
+        const searchResults = [];
+        for (const match of results.matches){
+            try {
+                const doc = await payload.findByID({
+                    collection: poolName,
+                    id: match.id
+                });
+                if (doc && (!where || matchesWhere(doc, where))) {
+                    // Extract fields excluding internal ones
+                    const { id: _id, createdAt: _createdAt, updatedAt: _updatedAt, ...docFields } = doc;
+                    searchResults.push({
+                        id: match.id,
+                        score: match.score || 0,
+                        ...docFields
+                    });
+                }
+            } catch (_e) {
+            // Document not found or error fetching, skip
+            }
+        }
+        return searchResults;
+    } catch (e) {
+        const errorMessage = e.message || e.toString();
+        payload.logger.error(`[@payloadcms-vectorize/cf] Search failed: ${errorMessage}`);
+        throw new Error(`[@payloadcms-vectorize/cf] Search failed: ${errorMessage}`);
+    }
+});
+/**
+ * Simple WHERE clause matcher for basic filtering
+ * Supports: equals, in, exists, and, or
+ */ function matchesWhere(doc, where) {
+    if (!where || Object.keys(where).length === 0) return true;
+    // Handle 'and' operator
+    if ('and' in where && Array.isArray(where.and)) {
+        return where.and.every((clause)=>matchesWhere(doc, clause));
+    }
+    // Handle 'or' operator
+    if ('or' in where && Array.isArray(where.or)) {
+        return where.or.some((clause)=>matchesWhere(doc, clause));
+    }
+    // Handle field-level conditions
+    for (const [field, condition] of Object.entries(where)){
+        if (field === 'and' || field === 'or') continue;
+        const value = doc[field];
+        if (typeof condition === 'object' && condition !== null) {
+            if ('equals' in condition && value !== condition.equals) {
+                return false;
+            }
+            if ('in' in condition && Array.isArray(condition.in) && !condition.in.includes(value)) {
+                return false;
+            }
+            if ('exists' in condition) {
+                const exists = value !== undefined && value !== null;
+                if (condition.exists !== exists) return false;
+            }
+        }
+    }
+    return true;
+}
+
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/search.ts"],"sourcesContent":["import { BasePayload, Where } from 'payload'\nimport { KnowledgePoolName, VectorSearchResult, getVectorizedPayload } from 'payloadcms-vectorize'\n\n/**\n * Search for similar vectors in Cloudflare Vectorize\n */\nexport default async (\n  payload: BasePayload,\n  queryEmbedding: number[],\n  poolName: KnowledgePoolName,\n  limit: number = 10,\n  where?: Where,\n): Promise<Array<VectorSearchResult>> => {\n  // Get Cloudflare binding from config\n  const vectorizeBinding = getVectorizedPayload(payload).getDbAdapterCustom()._vectorizeBinding\n  if (!vectorizeBinding) {\n    throw new Error('[@payloadcms-vectorize/cf] Cloudflare Vectorize binding not found')\n  }\n\n  try {\n    // Get collection config\n    const collectionConfig = payload.collections[poolName]?.config\n    if (!collectionConfig) {\n      throw new Error(`Collection ${poolName} not found`)\n    }\n\n    // Query Cloudflare Vectorize\n    // The query returns the top-k most similar vectors\n    const results = await vectorizeBinding.query(queryEmbedding, {\n      topK: limit,\n      returnMetadata: true,\n    })\n\n    if (!results.matches) {\n      return []\n    }\n\n    // Fetch full documents from Payload for metadata\n    const searchResults: VectorSearchResult[] = []\n\n    for (const match of results.matches) {\n      try {\n        const doc = await payload.findByID({\n          collection: poolName as any,\n          id: match.id,\n        })\n\n        if (doc && (!where || matchesWhere(doc, where))) {\n          // Extract fields excluding internal ones\n          const { id: _id, createdAt: _createdAt, updatedAt: _updatedAt, ...docFields } = doc as any\n\n          searchResults.push({\n            id: match.id,\n            score: match.score || 0,\n            ...docFields, // Includes sourceCollection, docId, chunkText, embeddingVersion, extension fields\n          })\n        }\n      } catch (_e) {\n        // Document not found or error fetching, skip\n      }\n    }\n\n    return searchResults\n  } catch (e) {\n    const errorMessage = (e as Error).message || (e as any).toString()\n    payload.logger.error(`[@payloadcms-vectorize/cf] Search failed: ${errorMessage}`)\n    throw new Error(`[@payloadcms-vectorize/cf] Search failed: ${errorMessage}`)\n  }\n}\n\n/**\n * Simple WHERE clause matcher for basic filtering\n * Supports: equals, in, exists, and, or\n */\nfunction matchesWhere(doc: Record<string, any>, where: Where): boolean {\n  if (!where || Object.keys(where).length === 0) return true\n\n  // Handle 'and' operator\n  if ('and' in where && Array.isArray(where.and)) {\n    return where.and.every((clause: Where) => matchesWhere(doc, clause))\n  }\n\n  // Handle 'or' operator\n  if ('or' in where && Array.isArray(where.or)) {\n    return where.or.some((clause: Where) => matchesWhere(doc, clause))\n  }\n\n  // Handle field-level conditions\n  for (const [field, condition] of Object.entries(where)) {\n    if (field === 'and' || field === 'or') continue\n\n    const value = doc[field]\n\n    if (typeof condition === 'object' && condition !== null) {\n      if ('equals' in condition && value !== condition.equals) {\n        return false\n      }\n      if ('in' in condition && Array.isArray(condition.in) && !condition.in.includes(value)) {\n        return false\n      }\n      if ('exists' in condition) {\n        const exists = value !== undefined && value !== null\n        if (condition.exists !== exists) return false\n      }\n    }\n  }\n\n  return true\n}\n"],"names":["getVectorizedPayload","payload","queryEmbedding","poolName","limit","where","vectorizeBinding","getDbAdapterCustom","_vectorizeBinding","Error","collectionConfig","collections","config","results","query","topK","returnMetadata","matches","searchResults","match","doc","findByID","collection","id","matchesWhere","_id","createdAt","_createdAt","updatedAt","_updatedAt","docFields","push","score","_e","e","errorMessage","message","toString","logger","error","Object","keys","length","Array","isArray","and","every","clause","or","some","field","condition","entries","value","equals","in","includes","exists","undefined"],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Cloudflare Vectorize binding for vector storage
+ */ export { };
+
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import { BasePayload } from 'payload'\n\n/**\n * Configuration for a knowledge pool in Cloudflare Vectorize\n */\nexport interface CloudflareVectorizePoolConfig {\n  /** Vector dimensions for this pool (must match embedding model output) */\n  dims: number\n}\n\n/**\n * All knowledge pools configuration for Cloudflare Vectorize\n */\nexport type KnowledgePoolsConfig = Record<string, CloudflareVectorizePoolConfig>\n\n/**\n * Cloudflare Vectorize binding for vector storage\n */\nexport type CloudflareVectorizeBinding = any\n"],"names":[],"mappings":"AAeA;;CAEC,GACD,WAA4C"}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@payloadcms-vectorize/cf",
+  "version": "0.6.0-beta",
+  "description": "Cloudflare Vectorize adapter for payloadcms-vectorize",
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "peerDependencies": {
+    "payload": ">=3.0.0 <4.0.0",
+    "payloadcms-vectorize": ">=0.6.0-beta <1.0.0"
+  },
+  "devDependencies": {
+    "payloadcms-vectorize": "0.6.0-beta"
+  },
+  "engines": {
+    "node": "^18.20.2 || >=20.9.0",
+    "pnpm": "^9 || ^10"
+  }
+}