qarpeo 0.0.0-alpha.10

package/dist/runtime/vectorize.d.ts

@@ -0,0 +1,21 @@
+import type { CFEvent } from "./types/index";
+import type { QarpeoVectorize, VectorizeIndex } from "./types/vectorize";
+export type * from "./types/vectorize";
+/**
+ * Returns the raw Cloudflare VectorizeIndex binding from the active environment.
+ *
+ * @param bindingName Optional Cloudflare Vectorize binding name (defaults to 'VECTORIZE')
+ * @param event Optional event context
+ */
+export declare function getVectorizeBinding(bindingName?: string, event?: CFEvent): VectorizeIndex;
+/** Creates a typed Vectorize client for a specific binding and optional event. */
+export declare function createVectorize(bindingName?: string, event?: CFEvent): QarpeoVectorize;
+/**
+ * Access a typed Cloudflare Vectorize client.
+ *
+ * @param bindingName Optional Cloudflare Vectorize binding name (defaults to 'VECTORIZE')
+ * @param event Optional event context
+ */
+export declare const useVectorize: (bindingName?: string, event?: CFEvent) => QarpeoVectorize;
+/** Auto-imported `vectorize` instance for direct Cloudflare Vectorize operations. */
+export declare const vectorize: QarpeoVectorize;

package/dist/runtime/vectorize.mjs

@@ -0,0 +1,53 @@
+import { getCloudflareEnv, resolveRuntimeBinding } from "./bindings.mjs";
+export function getVectorizeBinding(bindingName, event) {
+  const resolvedBinding = resolveRuntimeBinding("vectorize", bindingName, "VECTORIZE");
+  const env = getCloudflareEnv(event);
+  const binding = env[resolvedBinding];
+  if (!binding) {
+    throw new Error(
+      `[qarpeo] Cloudflare Vectorize binding "${resolvedBinding}" was not found. Check your wrangler.json or QARPEO_VECTORIZE_BINDING environment variable.`
+    );
+  }
+  return binding;
+}
+export function createVectorize(bindingName, event) {
+  const resolvedBinding = resolveRuntimeBinding("vectorize", bindingName, "VECTORIZE");
+  const getIndex = () => getVectorizeBinding(resolvedBinding, event);
+  return {
+    query: (vector, options) => {
+      return getIndex().query(vector, options);
+    },
+    insert: (vectors) => {
+      return getIndex().insert(vectors);
+    },
+    upsert: (vectors) => {
+      return getIndex().upsert(vectors);
+    },
+    deleteByIds: (ids) => {
+      return getIndex().deleteByIds(ids);
+    },
+    getByIds: (ids) => {
+      return getIndex().getByIds(ids);
+    },
+    describe: () => {
+      return getIndex().describe();
+    },
+    raw: (bName) => {
+      return getVectorizeBinding(bName || resolvedBinding, event);
+    }
+  };
+}
+export const useVectorize = createVectorize;
+export const vectorize = new Proxy({}, {
+  get(_target, prop) {
+    if (prop === "raw") {
+      return (bindingName) => getVectorizeBinding(bindingName);
+    }
+    const instance = createVectorize();
+    const val = instance[prop];
+    if (typeof val === "function") {
+      return val.bind(instance);
+    }
+    return val;
+  }
+});