@payloadcms-vectorize/cf 0.6.0-beta.2 → 0.6.0-beta.4

package/README.md

@@ -205,6 +205,10 @@ export const embedQuery = async (text: string): Promise<number[]> => {
 }
 ```
 
+## Known Limitations
+
+- **Search `limit` with `where` filtering:** When a `where` clause is provided, filtering is applied after fetching results from Cloudflare Vectorize. This means you may receive fewer results than the requested `limit` even when more matching vectors exist.
+
 ## License
 
 MIT

package/dist/collections/cfMappings.js

@@ -0,0 +1,46 @@
+export const CF_MAPPINGS_SLUG = 'vector-cf-mappings';
+// This collection maps Cloudflare Vectorize vector IDs to source documents,
+// so we can find and delete vectors when the source document is deleted.
+const CFMappingsCollection = {
+    slug: CF_MAPPINGS_SLUG,
+    admin: {
+        hidden: true,
+        description: 'Maps Cloudflare Vectorize vector IDs to source documents. Managed by the CF adapter.'
+    },
+    access: {
+        read: ()=>true,
+        create: ({ req })=>req?.payloadAPI === 'local',
+        update: ({ req })=>req?.payloadAPI === 'local',
+        delete: ({ req })=>req?.payloadAPI === 'local'
+    },
+    fields: [
+        {
+            name: 'vectorId',
+            type: 'text',
+            required: true,
+            index: true
+        },
+        {
+            name: 'poolName',
+            type: 'text',
+            required: true,
+            index: true
+        },
+        {
+            name: 'sourceCollection',
+            type: 'text',
+            required: true,
+            index: true
+        },
+        {
+            name: 'docId',
+            type: 'text',
+            required: true,
+            index: true
+        }
+    ],
+    timestamps: true
+};
+export default CFMappingsCollection;
+
+//# sourceMappingURL=cfMappings.js.map

package/dist/collections/cfMappings.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/collections/cfMappings.ts"],"sourcesContent":["import type { CollectionConfig } from 'payload'\n\nexport const CF_MAPPINGS_SLUG = 'vector-cf-mappings'\n\n// This collection maps Cloudflare Vectorize vector IDs to source documents,\n// so we can find and delete vectors when the source document is deleted.\nconst CFMappingsCollection: CollectionConfig = {\n  slug: CF_MAPPINGS_SLUG,\n  admin: {\n    hidden: true,\n    description:\n      'Maps Cloudflare Vectorize vector IDs to source documents. Managed by the CF adapter.',\n  },\n  access: {\n    read: () => true,\n    create: ({ req }) => req?.payloadAPI === 'local',\n    update: ({ req }) => req?.payloadAPI === 'local',\n    delete: ({ req }) => req?.payloadAPI === 'local',\n  },\n  fields: [\n    {\n      name: 'vectorId',\n      type: 'text',\n      required: true,\n      index: true,\n    },\n    {\n      name: 'poolName',\n      type: 'text',\n      required: true,\n      index: true,\n    },\n    {\n      name: 'sourceCollection',\n      type: 'text',\n      required: true,\n      index: true,\n    },\n    {\n      name: 'docId',\n      type: 'text',\n      required: true,\n      index: true,\n    },\n  ],\n  timestamps: true,\n}\n\nexport default CFMappingsCollection\n"],"names":["CF_MAPPINGS_SLUG","CFMappingsCollection","slug","admin","hidden","description","access","read","create","req","payloadAPI","update","delete","fields","name","type","required","index","timestamps"],"mappings":"AAEA,OAAO,MAAMA,mBAAmB,qBAAoB;AAEpD,4EAA4E;AAC5E,yEAAyE;AACzE,MAAMC,uBAAyC;IAC7CC,MAAMF;IACNG,OAAO;QACLC,QAAQ;QACRC,aACE;IACJ;IACAC,QAAQ;QACNC,MAAM,IAAM;QACZC,QAAQ,CAAC,EAAEC,GAAG,EAAE,GAAKA,KAAKC,eAAe;QACzCC,QAAQ,CAAC,EAAEF,GAAG,EAAE,GAAKA,KAAKC,eAAe;QACzCE,QAAQ,CAAC,EAAEH,GAAG,EAAE,GAAKA,KAAKC,eAAe;IAC3C;IACAG,QAAQ;QACN;YACEC,MAAM;YACNC,MAAM;YACNC,UAAU;YACVC,OAAO;QACT;QACA;YACEH,MAAM;YACNC,MAAM;YACNC,UAAU;YACVC,OAAO;QACT;QACA;YACEH,MAAM;YACNC,MAAM;YACNC,UAAU;YACVC,OAAO;QACT;QACA;YACEH,MAAM;YACNC,MAAM;YACNC,UAAU;YACVC,OAAO;QACT;KACD;IACDC,YAAY;AACd;AAEA,eAAejB,qBAAoB"}

package/dist/embed.js

@@ -1,13 +1,9 @@
-import { getVectorizedPayload } from 'payloadcms-vectorize';
+import { getVectorizeBinding } from './types.js';
+import { CF_MAPPINGS_SLUG } from './collections/cfMappings.js';
 /**
  * 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');
-    }
+ */ export default (async (payload, poolName, sourceCollection, sourceDocId, id, embedding)=>{
+    const vectorizeBinding = getVectorizeBinding(payload);
     try {
         const vector = Array.isArray(embedding) ? embedding : Array.from(embedding);
         // Upsert the vector in Cloudflare Vectorize
@@ -17,8 +13,18 @@ import { getVectorizedPayload } from 'payloadcms-vectorize';
                 values: vector
             }
         ]);
+        // Create a mapping row so we can find this vector during deletion
+        await payload.create({
+            collection: CF_MAPPINGS_SLUG,
+            data: {
+                vectorId: id,
+                poolName,
+                sourceCollection,
+                docId: sourceDocId
+            }
+        });
     } catch (e) {
-        const errorMessage = e.message || e.toString();
+        const errorMessage = e instanceof Error ? e.message : String(e);
         payload.logger.error(`[@payloadcms-vectorize/cf] Failed to store embedding: ${errorMessage}`);
         throw new Error(`[@payloadcms-vectorize/cf] Failed to store embedding: ${errorMessage}`);
     }

package/dist/embed.js.map

@@ -1 +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,UAAUK,sBAAsBC;IAC9E,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"}
+{"version":3,"sources":["../src/embed.ts"],"sourcesContent":["import { CollectionSlug, Payload } from 'payload'\nimport { getVectorizeBinding } from './types.js'\nimport { CF_MAPPINGS_SLUG } from './collections/cfMappings.js'\n\n/**\n * Store an embedding vector in Cloudflare Vectorize\n */\nexport default async (\n  payload: Payload,\n  poolName: string,\n  sourceCollection: string,\n  sourceDocId: string,\n  id: string,\n  embedding: number[] | Float32Array,\n) => {\n  const vectorizeBinding = getVectorizeBinding(payload)\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\n    // Create a mapping row so we can find this vector during deletion\n    await payload.create({\n      collection: CF_MAPPINGS_SLUG as CollectionSlug,\n      data: {\n        vectorId: id,\n        poolName,\n        sourceCollection,\n        docId: sourceDocId,\n      },\n    })\n  } catch (e) {\n    const errorMessage = e instanceof Error ? e.message : String(e)\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":["getVectorizeBinding","CF_MAPPINGS_SLUG","payload","poolName","sourceCollection","sourceDocId","id","embedding","vectorizeBinding","vector","Array","isArray","from","upsert","values","create","collection","data","vectorId","docId","e","errorMessage","Error","message","String","logger","error"],"mappings":"AACA,SAASA,mBAAmB,QAAQ,aAAY;AAChD,SAASC,gBAAgB,QAAQ,8BAA6B;AAE9D;;CAEC,GACD,eAAe,CAAA,OACbC,SACAC,UACAC,kBACAC,aACAC,IACAC;IAEA,MAAMC,mBAAmBR,oBAAoBE;IAE7C,IAAI;QACF,MAAMO,SAASC,MAAMC,OAAO,CAACJ,aAAaA,YAAYG,MAAME,IAAI,CAACL;QAEjE,4CAA4C;QAC5C,MAAMC,iBAAiBK,MAAM,CAAC;YAC5B;gBACEP;gBACAQ,QAAQL;YACV;SACD;QAED,kEAAkE;QAClE,MAAMP,QAAQa,MAAM,CAAC;YACnBC,YAAYf;YACZgB,MAAM;gBACJC,UAAUZ;gBACVH;gBACAC;gBACAe,OAAOd;YACT;QACF;IACF,EAAE,OAAOe,GAAG;QACV,MAAMC,eAAeD,aAAaE,QAAQF,EAAEG,OAAO,GAAGC,OAAOJ;QAC7DlB,QAAQuB,MAAM,CAACC,KAAK,CAAC,CAAC,sDAAsD,EAAEL,cAAc;QAC5F,MAAM,IAAIC,MAAM,CAAC,sDAAsD,EAAED,cAAc;IACzF;AACF,CAAA,EAAC"}

package/dist/index.js

@@ -1,3 +1,5 @@
+import { getVectorizeBinding } from './types.js';
+import cfMappingsCollection, { CF_MAPPINGS_SLUG } from './collections/cfMappings.js';
 import embed from './embed.js';
 import search from './search.js';
 /**
@@ -27,6 +29,9 @@ import search from './search.js';
     const adapter = {
         getConfigExtension: ()=>{
             return {
+                collections: {
+                    [CF_MAPPINGS_SLUG]: cfMappingsCollection
+                },
                 custom: {
                     _cfVectorizeAdapter: true,
                     _poolConfigs: poolConfig,
@@ -34,40 +39,75 @@ import search from './search.js';
                 }
             };
         },
-        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);
-        },
+        search,
+        storeEmbedding: embed,
         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;
+            const vectorizeBinding = getVectorizeBinding(payload);
             try {
-                const results = await vectorizeBinding.query(new Array(dims).fill(0), {
-                    topK: 100,
-                    returnMetadata: 'indexed',
+                // Paginate through all mapping rows for this document+pool
+                const allVectorIds = [];
+                let page = 1;
+                let hasNextPage = true;
+                while(hasNextPage){
+                    const mappings = await payload.find({
+                        collection: CF_MAPPINGS_SLUG,
+                        where: {
+                            and: [
+                                {
+                                    poolName: {
+                                        equals: poolName
+                                    }
+                                },
+                                {
+                                    sourceCollection: {
+                                        equals: sourceCollection
+                                    }
+                                },
+                                {
+                                    docId: {
+                                        equals: docId
+                                    }
+                                }
+                            ]
+                        },
+                        page
+                    });
+                    for (const mapping of mappings.docs){
+                        allVectorIds.push(mapping.vectorId);
+                    }
+                    hasNextPage = mappings.hasNextPage;
+                    page++;
+                }
+                if (allVectorIds.length === 0) {
+                    return;
+                }
+                // Delete vectors from Cloudflare Vectorize
+                await vectorizeBinding.deleteByIds(allVectorIds);
+                // Delete mapping rows
+                await payload.delete({
+                    collection: CF_MAPPINGS_SLUG,
                     where: {
                         and: [
                             {
-                                key: 'sourceCollection',
-                                value: sourceCollection
+                                poolName: {
+                                    equals: poolName
+                                }
+                            },
+                            {
+                                sourceCollection: {
+                                    equals: sourceCollection
+                                }
                             },
                             {
-                                key: 'docId',
-                                value: docId
+                                docId: {
+                                    equals: docId
+                                }
                             }
                         ]
                     }
                 });
-                const idsToDelete = (results.matches || []).map((match)=>match.id);
-                if (idsToDelete.length > 0) {
-                    await vectorizeBinding.deleteByIds(idsToDelete);
-                }
             } catch (error) {
-                const errorMessage = error.message || error.toString();
+                const errorMessage = error instanceof Error ? error.message : String(error);
                 payload.logger.error(`[@payloadcms-vectorize/cf] Failed to delete embeddings: ${errorMessage}`);
                 throw new Error(`[@payloadcms-vectorize/cf] Failed to delete embeddings: ${errorMessage}`);
             }
@@ -77,5 +117,6 @@ import search from './search.js';
         adapter
     };
 };
+export { CF_MAPPINGS_SLUG } from './collections/cfMappings.js';
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { DbAdapter } from 'payloadcms-vectorize'\nimport type { CloudflareVectorizeBinding, KnowledgePoolsConfig } from './types.js'\nimport embed from './embed.js'\nimport search from './search.js'\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: 100,\n          returnMetadata: 'indexed',\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.deleteByIds(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","deleteByIds","error","errorMessage","message","toString","logger"],"mappings":"AAEA,OAAOA,WAAW,aAAY;AAC9B,OAAOC,YAAY,cAAa;AAYhC;;;;;;;;;;;;;;;;;;;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,WAAW,CAACL;gBACrC;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"}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { CollectionSlug } from 'payload'\nimport type { DbAdapter } from 'payloadcms-vectorize'\nimport { getVectorizeBinding } from './types.js'\nimport type { CloudflareVectorizeBinding, KnowledgePoolsConfig } from './types.js'\nimport cfMappingsCollection, { CF_MAPPINGS_SLUG } from './collections/cfMappings.js'\nimport embed from './embed.js'\nimport search from './search.js'\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        collections: {\n          [CF_MAPPINGS_SLUG]: cfMappingsCollection,\n        },\n        custom: {\n          _cfVectorizeAdapter: true,\n          _poolConfigs: poolConfig,\n          _vectorizeBinding: options.binding,\n        },\n      }\n    },\n\n    search,\n\n    storeEmbedding: embed,\n\n    deleteEmbeddings: async (payload, poolName, sourceCollection, docId) => {\n      const vectorizeBinding = getVectorizeBinding(payload)\n\n      try {\n        // Paginate through all mapping rows for this document+pool\n        const allVectorIds: string[] = []\n        let page = 1\n        let hasNextPage = true\n\n        while (hasNextPage) {\n          const mappings = await payload.find({\n            collection: CF_MAPPINGS_SLUG as CollectionSlug,\n            where: {\n              and: [\n                { poolName: { equals: poolName } },\n                { sourceCollection: { equals: sourceCollection } },\n                { docId: { equals: docId } },\n              ],\n            },\n            page,\n          })\n\n          for (const mapping of mappings.docs) {\n            allVectorIds.push((mapping as Record<string, unknown>).vectorId as string)\n          }\n\n          hasNextPage = mappings.hasNextPage\n          page++\n        }\n\n        if (allVectorIds.length === 0) {\n          return\n        }\n        // Delete vectors from Cloudflare Vectorize\n        await vectorizeBinding.deleteByIds(allVectorIds)\n        // Delete mapping rows\n        await payload.delete({\n          collection: CF_MAPPINGS_SLUG as CollectionSlug,\n          where: {\n            and: [\n              { poolName: { equals: poolName } },\n              { sourceCollection: { equals: sourceCollection } },\n              { docId: { equals: docId } },\n            ],\n          },\n        })\n      } catch (error) {\n        const errorMessage = error instanceof Error ? error.message : String(error)\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 { CF_MAPPINGS_SLUG } from './collections/cfMappings.js'\nexport type { CloudflareVectorizeBinding, KnowledgePoolsConfig }\nexport type { KnowledgePoolsConfig as KnowledgePoolConfig }\n"],"names":["getVectorizeBinding","cfMappingsCollection","CF_MAPPINGS_SLUG","embed","search","createCloudflareVectorizeIntegration","options","binding","Error","poolConfig","config","adapter","getConfigExtension","collections","custom","_cfVectorizeAdapter","_poolConfigs","_vectorizeBinding","storeEmbedding","deleteEmbeddings","payload","poolName","sourceCollection","docId","vectorizeBinding","allVectorIds","page","hasNextPage","mappings","find","collection","where","and","equals","mapping","docs","push","vectorId","length","deleteByIds","delete","error","errorMessage","message","String","logger"],"mappings":"AAEA,SAASA,mBAAmB,QAAQ,aAAY;AAEhD,OAAOC,wBAAwBC,gBAAgB,QAAQ,8BAA6B;AACpF,OAAOC,WAAW,aAAY;AAC9B,OAAOC,YAAY,cAAa;AAYhC;;;;;;;;;;;;;;;;;;;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,aAAa;oBACX,CAACX,iBAAiB,EAAED;gBACtB;gBACAa,QAAQ;oBACNC,qBAAqB;oBACrBC,cAAcP;oBACdQ,mBAAmBX,QAAQC,OAAO;gBACpC;YACF;QACF;QAEAH;QAEAc,gBAAgBf;QAEhBgB,kBAAkB,OAAOC,SAASC,UAAUC,kBAAkBC;YAC5D,MAAMC,mBAAmBxB,oBAAoBoB;YAE7C,IAAI;gBACF,2DAA2D;gBAC3D,MAAMK,eAAyB,EAAE;gBACjC,IAAIC,OAAO;gBACX,IAAIC,cAAc;gBAElB,MAAOA,YAAa;oBAClB,MAAMC,WAAW,MAAMR,QAAQS,IAAI,CAAC;wBAClCC,YAAY5B;wBACZ6B,OAAO;4BACLC,KAAK;gCACH;oCAAEX,UAAU;wCAAEY,QAAQZ;oCAAS;gCAAE;gCACjC;oCAAEC,kBAAkB;wCAAEW,QAAQX;oCAAiB;gCAAE;gCACjD;oCAAEC,OAAO;wCAAEU,QAAQV;oCAAM;gCAAE;6BAC5B;wBACH;wBACAG;oBACF;oBAEA,KAAK,MAAMQ,WAAWN,SAASO,IAAI,CAAE;wBACnCV,aAAaW,IAAI,CAAC,AAACF,QAAoCG,QAAQ;oBACjE;oBAEAV,cAAcC,SAASD,WAAW;oBAClCD;gBACF;gBAEA,IAAID,aAAaa,MAAM,KAAK,GAAG;oBAC7B;gBACF;gBACA,2CAA2C;gBAC3C,MAAMd,iBAAiBe,WAAW,CAACd;gBACnC,sBAAsB;gBACtB,MAAML,QAAQoB,MAAM,CAAC;oBACnBV,YAAY5B;oBACZ6B,OAAO;wBACLC,KAAK;4BACH;gCAAEX,UAAU;oCAAEY,QAAQZ;gCAAS;4BAAE;4BACjC;gCAAEC,kBAAkB;oCAAEW,QAAQX;gCAAiB;4BAAE;4BACjD;gCAAEC,OAAO;oCAAEU,QAAQV;gCAAM;4BAAE;yBAC5B;oBACH;gBACF;YACF,EAAE,OAAOkB,OAAO;gBACd,MAAMC,eAAeD,iBAAiBjC,QAAQiC,MAAME,OAAO,GAAGC,OAAOH;gBACrErB,QAAQyB,MAAM,CAACJ,KAAK,CAClB,CAAC,wDAAwD,EAAEC,cAAc;gBAE3E,MAAM,IAAIlC,MAAM,CAAC,wDAAwD,EAAEkC,cAAc;YAC3F;QACF;IACF;IAEA,OAAO;QAAE/B;IAAQ;AACnB,EAAC;AAED,SAAST,gBAAgB,QAAQ,8BAA6B"}

package/dist/search.js

@@ -1,18 +1,9 @@
-import { getVectorizedPayload } from 'payloadcms-vectorize';
+import { getVectorizeBinding } from './types.js';
 /**
  * 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');
-    }
+    const vectorizeBinding = getVectorizeBinding(payload);
     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, {
@@ -22,36 +13,52 @@ import { getVectorizedPayload } from 'payloadcms-vectorize';
         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
+        // Batch-fetch all matched documents, paginating through results
+        const matchIds = results.matches.map((m)=>m.id);
+        const scoreById = new Map(results.matches.map((m)=>[
+                m.id,
+                m.score || 0
+            ]));
+        const docsById = new Map();
+        let page = 1;
+        let hasNextPage = true;
+        while(hasNextPage){
+            const found = await payload.find({
+                collection: poolName,
+                where: {
+                    id: {
+                        in: matchIds
+                    }
+                },
+                page
+            });
+            for (const doc of found.docs){
+                docsById.set(String(doc.id), doc);
             }
+            hasNextPage = found.hasNextPage;
+            page++;
+        }
+        // Build results preserving the original similarity-score order
+        const searchResults = [];
+        for (const matchId of matchIds){
+            const doc = docsById.get(matchId);
+            if (!doc || where && !matchesWhere(doc, where)) continue;
+            const { id: _id, createdAt: _createdAt, updatedAt: _updatedAt, ...docFields } = doc;
+            searchResults.push({
+                id: matchId,
+                score: scoreById.get(matchId) || 0,
+                ...docFields
+            });
         }
         return searchResults;
     } catch (e) {
-        const errorMessage = e.message || e.toString();
+        const errorMessage = e instanceof Error ? e.message : String(e);
         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
+ * 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;

package/dist/search.js.map

@@ -1 +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":"AACA,SAAgDA,oBAAoB,QAAQ,uBAAsB;AAElG;;CAEC,GACD,eAAe,CAAA,OACbC,SACAC,gBACAC,UACAC,QAAgB,EAAE,EAClBC;IAEA,qCAAqC;IACrC,MAAMC,mBAAmBN,qBAAqBC,UAAUM,sBAAsBC;IAC9E,IAAI,CAACF,kBAAkB;QACrB,MAAM,IAAIG,MAAM;IAClB;IAEA,IAAI;QACF,wBAAwB;QACxB,MAAMC,mBAAmBT,QAAQU,WAAW,CAACR,SAAS,EAAES;QACxD,IAAI,CAACF,kBAAkB;YACrB,MAAM,IAAID,MAAM,CAAC,WAAW,EAAEN,SAAS,UAAU,CAAC;QACpD;QAEA,6BAA6B;QAC7B,mDAAmD;QACnD,MAAMU,UAAU,MAAMP,iBAAiBQ,KAAK,CAACZ,gBAAgB;YAC3Da,MAAMX;YACNY,gBAAgB;QAClB;QAEA,IAAI,CAACH,QAAQI,OAAO,EAAE;YACpB,OAAO,EAAE;QACX;QAEA,iDAAiD;QACjD,MAAMC,gBAAsC,EAAE;QAE9C,KAAK,MAAMC,SAASN,QAAQI,OAAO,CAAE;YACnC,IAAI;gBACF,MAAMG,MAAM,MAAMnB,QAAQoB,QAAQ,CAAC;oBACjCC,YAAYnB;oBACZoB,IAAIJ,MAAMI,EAAE;gBACd;gBAEA,IAAIH,OAAQ,CAAA,CAACf,SAASmB,aAAaJ,KAAKf,MAAK,GAAI;oBAC/C,yCAAyC;oBACzC,MAAM,EAAEkB,IAAIE,GAAG,EAAEC,WAAWC,UAAU,EAAEC,WAAWC,UAAU,EAAE,GAAGC,WAAW,GAAGV;oBAEhFF,cAAca,IAAI,CAAC;wBACjBR,IAAIJ,MAAMI,EAAE;wBACZS,OAAOb,MAAMa,KAAK,IAAI;wBACtB,GAAGF,SAAS;oBACd;gBACF;YACF,EAAE,OAAOG,IAAI;YACX,6CAA6C;YAC/C;QACF;QAEA,OAAOf;IACT,EAAE,OAAOgB,GAAG;QACV,MAAMC,eAAe,AAACD,EAAYE,OAAO,IAAI,AAACF,EAAUG,QAAQ;QAChEpC,QAAQqC,MAAM,CAACC,KAAK,CAAC,CAAC,0CAA0C,EAAEJ,cAAc;QAChF,MAAM,IAAI1B,MAAM,CAAC,0CAA0C,EAAE0B,cAAc;IAC7E;AACF,CAAA,EAAC;AAED;;;CAGC,GACD,SAASX,aAAaJ,GAAwB,EAAEf,KAAY;IAC1D,IAAI,CAACA,SAASmC,OAAOC,IAAI,CAACpC,OAAOqC,MAAM,KAAK,GAAG,OAAO;IAEtD,wBAAwB;IACxB,IAAI,SAASrC,SAASsC,MAAMC,OAAO,CAACvC,MAAMwC,GAAG,GAAG;QAC9C,OAAOxC,MAAMwC,GAAG,CAACC,KAAK,CAAC,CAACC,SAAkBvB,aAAaJ,KAAK2B;IAC9D;IAEA,uBAAuB;IACvB,IAAI,QAAQ1C,SAASsC,MAAMC,OAAO,CAACvC,MAAM2C,EAAE,GAAG;QAC5C,OAAO3C,MAAM2C,EAAE,CAACC,IAAI,CAAC,CAACF,SAAkBvB,aAAaJ,KAAK2B;IAC5D;IAEA,gCAAgC;IAChC,KAAK,MAAM,CAACG,OAAOC,UAAU,IAAIX,OAAOY,OAAO,CAAC/C,OAAQ;QACtD,IAAI6C,UAAU,SAASA,UAAU,MAAM;QAEvC,MAAMG,QAAQjC,GAAG,CAAC8B,MAAM;QAExB,IAAI,OAAOC,cAAc,YAAYA,cAAc,MAAM;YACvD,IAAI,YAAYA,aAAaE,UAAUF,UAAUG,MAAM,EAAE;gBACvD,OAAO;YACT;YACA,IAAI,QAAQH,aAAaR,MAAMC,OAAO,CAACO,UAAUI,EAAE,KAAK,CAACJ,UAAUI,EAAE,CAACC,QAAQ,CAACH,QAAQ;gBACrF,OAAO;YACT;YACA,IAAI,YAAYF,WAAW;gBACzB,MAAMM,SAASJ,UAAUK,aAAaL,UAAU;gBAChD,IAAIF,UAAUM,MAAM,KAAKA,QAAQ,OAAO;YAC1C;QACF;IACF;IAEA,OAAO;AACT"}
+{"version":3,"sources":["../src/search.ts"],"sourcesContent":["import { BasePayload, CollectionSlug, Where } from 'payload'\nimport { KnowledgePoolName, VectorSearchResult } from 'payloadcms-vectorize'\nimport { getVectorizeBinding } from './types.js'\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  const vectorizeBinding = getVectorizeBinding(payload)\n\n  try {\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    // Batch-fetch all matched documents, paginating through results\n    const matchIds = results.matches.map((m) => m.id)\n    const scoreById = new Map(results.matches.map((m) => [m.id, m.score || 0]))\n\n    const docsById = new Map<string, Record<string, unknown>>()\n    let page = 1\n    let hasNextPage = true\n    while (hasNextPage) {\n      const found = await payload.find({\n        collection: poolName as CollectionSlug,\n        where: { id: { in: matchIds } },\n        page,\n      })\n      for (const doc of found.docs as Record<string, unknown>[]) {\n        docsById.set(String(doc.id), doc)\n      }\n      hasNextPage = found.hasNextPage\n      page++\n    }\n\n    // Build results preserving the original similarity-score order\n    const searchResults: VectorSearchResult[] = []\n    for (const matchId of matchIds) {\n      const doc = docsById.get(matchId)\n      if (!doc || (where && !matchesWhere(doc, where))) continue\n\n      const { id: _id, createdAt: _createdAt, updatedAt: _updatedAt, ...docFields } = doc\n      searchResults.push({\n        id: matchId,\n        score: scoreById.get(matchId) || 0,\n        ...docFields,\n      } as VectorSearchResult)\n    }\n\n    return searchResults\n  } catch (e) {\n    const errorMessage = e instanceof Error ? e.message : String(e)\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, unknown>, 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":["getVectorizeBinding","payload","queryEmbedding","poolName","limit","where","vectorizeBinding","results","query","topK","returnMetadata","matches","matchIds","map","m","id","scoreById","Map","score","docsById","page","hasNextPage","found","find","collection","in","doc","docs","set","String","searchResults","matchId","get","matchesWhere","_id","createdAt","_createdAt","updatedAt","_updatedAt","docFields","push","e","errorMessage","Error","message","logger","error","Object","keys","length","Array","isArray","and","every","clause","or","some","field","condition","entries","value","equals","includes","exists","undefined"],"mappings":"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"}

package/dist/types.js

@@ -1,5 +1,13 @@
+import { getVectorizedPayload } from 'payloadcms-vectorize';
 /**
- * Cloudflare Vectorize binding for vector storage
- */ export { };
+ * Retrieve the Cloudflare Vectorize binding from a Payload instance.
+ * Throws if the binding is not found.
+ */ export function getVectorizeBinding(payload) {
+    const binding = getVectorizedPayload(payload)?.getDbAdapterCustom()?._vectorizeBinding;
+    if (!binding) {
+        throw new Error('[@payloadcms-vectorize/cf] Cloudflare Vectorize binding not found');
+    }
+    return binding;
+}
 
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +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"}
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type { BasePayload } from 'payload'\nimport { getVectorizedPayload } from 'payloadcms-vectorize'\n\n/**\n * Retrieve the Cloudflare Vectorize binding from a Payload instance.\n * Throws if the binding is not found.\n */\nexport function getVectorizeBinding(payload: BasePayload): CloudflareVectorizeBinding {\n  const binding = getVectorizedPayload(payload)?.getDbAdapterCustom()\n    ?._vectorizeBinding as CloudflareVectorizeBinding | undefined\n  if (!binding) {\n    throw new Error('[@payloadcms-vectorize/cf] Cloudflare Vectorize binding not found')\n  }\n  return binding\n}\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/** A single vector match returned by a Vectorize query */\nexport interface VectorizeMatch {\n  id: string\n  score?: number\n  metadata?: Record<string, unknown>\n}\n\n/** Result of a Vectorize query */\nexport interface VectorizeQueryResult {\n  matches: VectorizeMatch[]\n  count: number\n}\n\n/** Vector to upsert into Vectorize */\nexport interface VectorizeVector {\n  id: string\n  values: number[]\n  metadata?: Record<string, unknown>\n}\n\n/**\n * Cloudflare Vectorize binding interface.\n * Mirrors the subset of the Vectorize API we use.\n * For the full type, install `@cloudflare/workers-types`.\n */\nexport interface CloudflareVectorizeBinding {\n  query(vector: number[], options?: {\n    topK?: number\n    returnMetadata?: boolean | 'indexed' | 'all'\n    filter?: Record<string, unknown>\n    /** Vectorize metadata filtering */\n    where?: Record<string, unknown>\n  }): Promise<VectorizeQueryResult>\n  upsert(vectors: VectorizeVector[]): Promise<unknown>\n  deleteByIds(ids: string[]): Promise<unknown>\n}\n"],"names":["getVectorizedPayload","getVectorizeBinding","payload","binding","getDbAdapterCustom","_vectorizeBinding","Error"],"mappings":"AACA,SAASA,oBAAoB,QAAQ,uBAAsB;AAE3D;;;CAGC,GACD,OAAO,SAASC,oBAAoBC,OAAoB;IACtD,MAAMC,UAAUH,qBAAqBE,UAAUE,sBAC3CC;IACJ,IAAI,CAACF,SAAS;QACZ,MAAM,IAAIG,MAAM;IAClB;IACA,OAAOH;AACT"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms-vectorize/cf",
-  "version": "0.6.0-beta.2",
+  "version": "0.6.0-beta.4",
   "description": "Cloudflare Vectorize adapter for payloadcms-vectorize",
   "license": "MIT",
   "type": "module",