@upstash/vector 1.2.1 → 1.2.3

package/dist/{chunk-HESEGT2A.mjs → chunk-VZUGHHBV.mjs}

@@ -31,13 +31,15 @@ var HttpClient = class {
     };
   }
   async request(req) {
+    const signal = this.options.signal;
+    const isSignalFunction = typeof signal === "function";
     const requestOptions = {
       cache: this.options.cache,
       method: "POST",
       headers: this.headers,
       body: JSON.stringify(req.body),
       keepalive: true,
-      signal: this.options.signal
+      signal: isSignalFunction ? signal() : signal
     };
     let res = null;
     let error = null;
@@ -46,13 +48,15 @@ var HttpClient = class {
         res = await fetch([this.baseUrl, ...req.path ?? []].join("/"), requestOptions);
         break;
       } catch (error_) {
-        if (this.options.signal?.aborted) {
+        if (requestOptions.signal?.aborted && isSignalFunction) {
+          throw error_;
+        } else if (requestOptions.signal?.aborted) {
           const myBlob = new Blob([
-            JSON.stringify({ result: this.options.signal.reason ?? "Aborted" })
+            JSON.stringify({ result: requestOptions.signal.reason ?? "Aborted" })
           ]);
           const myOptions = {
             status: 200,
-            statusText: this.options.signal.reason ?? "Aborted"
+            statusText: requestOptions.signal.reason ?? "Aborted"
           };
           res = new Response(myBlob, myOptions);
           break;
@@ -119,6 +123,7 @@ var Command = class {
 
 // src/commands/client/query/query-many/index.ts
 var QueryManyCommand = class extends Command {
+  queryCount;
   constructor(payload, options) {
     let endpoint = "query";
     const hasData = payload.some((p) => p.data);
@@ -127,6 +132,21 @@ var QueryManyCommand = class extends Command {
       endpoint = `${endpoint}/${options.namespace}`;
     }
     super(payload, endpoint);
+    this.queryCount = payload.length;
+  }
+  /**
+   * Override exec to normalize the API response.
+   *
+   * When a single query is sent via queryMany, the API returns a flat
+   * array of results instead of a nested array. This ensures the return
+   * type is always QueryResult<TMetadata>[][] regardless of query count.
+   */
+  async exec(client) {
+    const result = await super.exec(client);
+    if (this.queryCount === 1 && result.length > 0 && !Array.isArray(result[0])) {
+      return [result];
+    }
+    return result;
   }
 };
 
@@ -855,7 +875,7 @@ var Index = class {
 };
 
 // version.ts
-var VERSION = "v1.2.1";
+var VERSION = "1.2.3";
 
 export {
   HttpClient,

package/dist/cloudflare.d.mts

@@ -1,5 +1,5 @@
-import { R as RequesterConfig, D as Dict, I as Index$1 } from './vector-1qEMEEQL.mjs';
-export { d as FetchResult, F as FusionAlgorithm, f as InfoResult, Q as QueryMode, e as QueryResult, c as RangeResult, a as Requester, S as SparseVector, U as UpstashRequest, b as UpstashResponse, V as Vector, W as WeightingStrategy } from './vector-1qEMEEQL.mjs';
+import { H as HttpClientConfig, R as RequesterConfig, D as Dict, I as Index$1 } from './vector-3yYKIF78.mjs';
+export { d as FetchResult, F as FusionAlgorithm, f as InfoResult, Q as QueryMode, e as QueryResult, c as RangeResult, a as Requester, S as SparseVector, U as UpstashRequest, b as UpstashResponse, V as Vector, W as WeightingStrategy } from './vector-3yYKIF78.mjs';
 
 /**
  * Connection credentials for upstash vector.
@@ -18,7 +18,7 @@ type IndexConfig = {
      * The signal will allow aborting requests on the fly.
      * For more check: https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal
      */
-    signal?: AbortSignal;
+    signal?: HttpClientConfig["signal"];
     /**
      * Enable telemetry to help us improve the SDK.
      * The sdk will send the sdk version, platform and node version as telemetry headers.

package/dist/cloudflare.d.ts

@@ -1,5 +1,5 @@
-import { R as RequesterConfig, D as Dict, I as Index$1 } from './vector-1qEMEEQL.js';
-export { d as FetchResult, F as FusionAlgorithm, f as InfoResult, Q as QueryMode, e as QueryResult, c as RangeResult, a as Requester, S as SparseVector, U as UpstashRequest, b as UpstashResponse, V as Vector, W as WeightingStrategy } from './vector-1qEMEEQL.js';
+import { H as HttpClientConfig, R as RequesterConfig, D as Dict, I as Index$1 } from './vector-3yYKIF78.js';
+export { d as FetchResult, F as FusionAlgorithm, f as InfoResult, Q as QueryMode, e as QueryResult, c as RangeResult, a as Requester, S as SparseVector, U as UpstashRequest, b as UpstashResponse, V as Vector, W as WeightingStrategy } from './vector-3yYKIF78.js';
 
 /**
  * Connection credentials for upstash vector.
@@ -18,7 +18,7 @@ type IndexConfig = {
      * The signal will allow aborting requests on the fly.
      * For more check: https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal
      */
-    signal?: AbortSignal;
+    signal?: HttpClientConfig["signal"];
     /**
      * Enable telemetry to help us improve the SDK.
      * The sdk will send the sdk version, platform and node version as telemetry headers.

package/dist/cloudflare.js

@@ -60,13 +60,15 @@ var HttpClient = class {
     };
   }
   async request(req) {
+    const signal = this.options.signal;
+    const isSignalFunction = typeof signal === "function";
     const requestOptions = {
       cache: this.options.cache,
       method: "POST",
       headers: this.headers,
       body: JSON.stringify(req.body),
       keepalive: true,
-      signal: this.options.signal
+      signal: isSignalFunction ? signal() : signal
     };
     let res = null;
     let error = null;
@@ -75,13 +77,15 @@ var HttpClient = class {
         res = await fetch([this.baseUrl, ...req.path ?? []].join("/"), requestOptions);
         break;
       } catch (error_) {
-        if (this.options.signal?.aborted) {
+        if (requestOptions.signal?.aborted && isSignalFunction) {
+          throw error_;
+        } else if (requestOptions.signal?.aborted) {
           const myBlob = new Blob([
-            JSON.stringify({ result: this.options.signal.reason ?? "Aborted" })
+            JSON.stringify({ result: requestOptions.signal.reason ?? "Aborted" })
           ]);
           const myOptions = {
             status: 200,
-            statusText: this.options.signal.reason ?? "Aborted"
+            statusText: requestOptions.signal.reason ?? "Aborted"
           };
           res = new Response(myBlob, myOptions);
           break;
@@ -158,6 +162,7 @@ var DeleteCommand = class extends Command {
 
 // src/commands/client/query/query-many/index.ts
 var QueryManyCommand = class extends Command {
+  queryCount;
   constructor(payload, options) {
     let endpoint = "query";
     const hasData = payload.some((p) => p.data);
@@ -166,6 +171,21 @@ var QueryManyCommand = class extends Command {
       endpoint = `${endpoint}/${options.namespace}`;
     }
     super(payload, endpoint);
+    this.queryCount = payload.length;
+  }
+  /**
+   * Override exec to normalize the API response.
+   *
+   * When a single query is sent via queryMany, the API returns a flat
+   * array of results instead of a nested array. This ensures the return
+   * type is always QueryResult<TMetadata>[][] regardless of query count.
+   */
+  async exec(client) {
+    const result = await super.exec(client);
+    if (this.queryCount === 1 && result.length > 0 && !Array.isArray(result[0])) {
+      return [result];
+    }
+    return result;
   }
 };
 
@@ -884,7 +904,7 @@ var Index = class {
 };
 
 // version.ts
-var VERSION = "v1.2.1";
+var VERSION = "1.2.3";
 
 // src/platforms/cloudflare.ts
 var Index2 = class _Index extends Index {

package/dist/cloudflare.mjs

@@ -5,7 +5,7 @@ import {
   QueryMode,
   VERSION,
   WeightingStrategy
-} from "./chunk-HESEGT2A.mjs";
+} from "./chunk-VZUGHHBV.mjs";
 
 // src/platforms/cloudflare.ts
 var Index2 = class _Index extends Index {

package/dist/nodejs.d.mts

@@ -1,5 +1,5 @@
-import { R as RequesterConfig, D as Dict, I as Index$1, a as Requester } from './vector-1qEMEEQL.mjs';
-export { d as FetchResult, F as FusionAlgorithm, f as InfoResult, Q as QueryMode, e as QueryResult, c as RangeResult, S as SparseVector, U as UpstashRequest, b as UpstashResponse, V as Vector, W as WeightingStrategy } from './vector-1qEMEEQL.mjs';
+import { H as HttpClientConfig, R as RequesterConfig, D as Dict, I as Index$1, a as Requester } from './vector-3yYKIF78.mjs';
+export { d as FetchResult, F as FusionAlgorithm, f as InfoResult, Q as QueryMode, e as QueryResult, c as RangeResult, S as SparseVector, U as UpstashRequest, b as UpstashResponse, V as Vector, W as WeightingStrategy } from './vector-3yYKIF78.mjs';
 
 /**
  * Connection credentials for upstash vector.
@@ -18,7 +18,7 @@ type IndexConfig = {
      * The signal will allow aborting requests on the fly.
      * For more check: https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal
      */
-    signal?: AbortSignal;
+    signal?: HttpClientConfig["signal"];
     /**
      * Enable telemetry to help us improve the SDK.
      * The sdk will send the sdk version, platform and node version as telemetry headers.

package/dist/nodejs.d.ts

@@ -1,5 +1,5 @@
-import { R as RequesterConfig, D as Dict, I as Index$1, a as Requester } from './vector-1qEMEEQL.js';
-export { d as FetchResult, F as FusionAlgorithm, f as InfoResult, Q as QueryMode, e as QueryResult, c as RangeResult, S as SparseVector, U as UpstashRequest, b as UpstashResponse, V as Vector, W as WeightingStrategy } from './vector-1qEMEEQL.js';
+import { H as HttpClientConfig, R as RequesterConfig, D as Dict, I as Index$1, a as Requester } from './vector-3yYKIF78.js';
+export { d as FetchResult, F as FusionAlgorithm, f as InfoResult, Q as QueryMode, e as QueryResult, c as RangeResult, S as SparseVector, U as UpstashRequest, b as UpstashResponse, V as Vector, W as WeightingStrategy } from './vector-3yYKIF78.js';
 
 /**
  * Connection credentials for upstash vector.
@@ -18,7 +18,7 @@ type IndexConfig = {
      * The signal will allow aborting requests on the fly.
      * For more check: https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal
      */
-    signal?: AbortSignal;
+    signal?: HttpClientConfig["signal"];
     /**
      * Enable telemetry to help us improve the SDK.
      * The sdk will send the sdk version, platform and node version as telemetry headers.

package/dist/nodejs.js

@@ -60,13 +60,15 @@ var HttpClient = class {
     };
   }
   async request(req) {
+    const signal = this.options.signal;
+    const isSignalFunction = typeof signal === "function";
     const requestOptions = {
       cache: this.options.cache,
       method: "POST",
       headers: this.headers,
       body: JSON.stringify(req.body),
       keepalive: true,
-      signal: this.options.signal
+      signal: isSignalFunction ? signal() : signal
     };
     let res = null;
     let error = null;
@@ -75,13 +77,15 @@ var HttpClient = class {
         res = await fetch([this.baseUrl, ...req.path ?? []].join("/"), requestOptions);
         break;
       } catch (error_) {
-        if (this.options.signal?.aborted) {
+        if (requestOptions.signal?.aborted && isSignalFunction) {
+          throw error_;
+        } else if (requestOptions.signal?.aborted) {
           const myBlob = new Blob([
-            JSON.stringify({ result: this.options.signal.reason ?? "Aborted" })
+            JSON.stringify({ result: requestOptions.signal.reason ?? "Aborted" })
           ]);
           const myOptions = {
             status: 200,
-            statusText: this.options.signal.reason ?? "Aborted"
+            statusText: requestOptions.signal.reason ?? "Aborted"
           };
           res = new Response(myBlob, myOptions);
           break;
@@ -158,6 +162,7 @@ var DeleteCommand = class extends Command {
 
 // src/commands/client/query/query-many/index.ts
 var QueryManyCommand = class extends Command {
+  queryCount;
   constructor(payload, options) {
     let endpoint = "query";
     const hasData = payload.some((p) => p.data);
@@ -166,6 +171,21 @@ var QueryManyCommand = class extends Command {
       endpoint = `${endpoint}/${options.namespace}`;
     }
     super(payload, endpoint);
+    this.queryCount = payload.length;
+  }
+  /**
+   * Override exec to normalize the API response.
+   *
+   * When a single query is sent via queryMany, the API returns a flat
+   * array of results instead of a nested array. This ensures the return
+   * type is always QueryResult<TMetadata>[][] regardless of query count.
+   */
+  async exec(client) {
+    const result = await super.exec(client);
+    if (this.queryCount === 1 && result.length > 0 && !Array.isArray(result[0])) {
+      return [result];
+    }
+    return result;
   }
 };
 
@@ -884,7 +904,7 @@ var Index = class {
 };
 
 // version.ts
-var VERSION = "v1.2.1";
+var VERSION = "1.2.3";
 
 // src/utils/get-runtime.ts
 function getRuntime() {

package/dist/nodejs.mjs

@@ -5,7 +5,7 @@ import {
   QueryMode,
   VERSION,
   WeightingStrategy
-} from "./chunk-HESEGT2A.mjs";
+} from "./chunk-VZUGHHBV.mjs";
 
 // src/utils/get-runtime.ts
 function getRuntime() {

package/dist/{vector-1qEMEEQL.d.mts → vector-3yYKIF78.d.mts}

@@ -41,6 +41,12 @@ type RequesterConfig = {
      */
     cache?: CacheSetting;
 };
+type HttpClientConfig = {
+    headers?: Record<string, string>;
+    baseUrl: string;
+    retry?: RetryConfig;
+    signal?: AbortSignal | (() => AbortSignal);
+} & RequesterConfig;
 
 type Vector<TMetadata = Dict> = {
     id: string;
@@ -233,7 +239,16 @@ declare enum QueryMode {
 }
 
 declare class QueryManyCommand<TMetadata> extends Command<QueryResult<TMetadata>[][]> {
+    private queryCount;
     constructor(payload: QueryCommandPayload[], options?: QueryCommandOptions);
+    /**
+     * Override exec to normalize the API response.
+     *
+     * When a single query is sent via queryMany, the API returns a flat
+     * array of results instead of a nested array. This ensures the return
+     * type is always QueryResult<TMetadata>[][] regardless of query count.
+     */
+    exec(client: Requester): Promise<QueryResult<TMetadata>[][]>;
 }
 
 declare class QueryCommand<TMetadata> extends Command<QueryResult<TMetadata>[]> {
@@ -905,4 +920,4 @@ declare class Index<TIndexMetadata extends Dict = Dict> {
     deleteNamespace: (namespace: string) => Promise<string>;
 }
 
-export { type Dict as D, FusionAlgorithm as F, Index as I, QueryMode as Q, type RequesterConfig as R, type SparseVector as S, type UpstashRequest as U, type Vector as V, WeightingStrategy as W, type Requester as a, type UpstashResponse as b, type RangeResult as c, type FetchResult as d, type QueryResult as e, type InfoResult as f };
+export { type Dict as D, FusionAlgorithm as F, type HttpClientConfig as H, Index as I, QueryMode as Q, type RequesterConfig as R, type SparseVector as S, type UpstashRequest as U, type Vector as V, WeightingStrategy as W, type Requester as a, type UpstashResponse as b, type RangeResult as c, type FetchResult as d, type QueryResult as e, type InfoResult as f };

package/dist/{vector-1qEMEEQL.d.ts → vector-3yYKIF78.d.ts}

@@ -41,6 +41,12 @@ type RequesterConfig = {
      */
     cache?: CacheSetting;
 };
+type HttpClientConfig = {
+    headers?: Record<string, string>;
+    baseUrl: string;
+    retry?: RetryConfig;
+    signal?: AbortSignal | (() => AbortSignal);
+} & RequesterConfig;
 
 type Vector<TMetadata = Dict> = {
     id: string;
@@ -233,7 +239,16 @@ declare enum QueryMode {
 }
 
 declare class QueryManyCommand<TMetadata> extends Command<QueryResult<TMetadata>[][]> {
+    private queryCount;
     constructor(payload: QueryCommandPayload[], options?: QueryCommandOptions);
+    /**
+     * Override exec to normalize the API response.
+     *
+     * When a single query is sent via queryMany, the API returns a flat
+     * array of results instead of a nested array. This ensures the return
+     * type is always QueryResult<TMetadata>[][] regardless of query count.
+     */
+    exec(client: Requester): Promise<QueryResult<TMetadata>[][]>;
 }
 
 declare class QueryCommand<TMetadata> extends Command<QueryResult<TMetadata>[]> {
@@ -905,4 +920,4 @@ declare class Index<TIndexMetadata extends Dict = Dict> {
     deleteNamespace: (namespace: string) => Promise<string>;
 }
 
-export { type Dict as D, FusionAlgorithm as F, Index as I, QueryMode as Q, type RequesterConfig as R, type SparseVector as S, type UpstashRequest as U, type Vector as V, WeightingStrategy as W, type Requester as a, type UpstashResponse as b, type RangeResult as c, type FetchResult as d, type QueryResult as e, type InfoResult as f };
+export { type Dict as D, FusionAlgorithm as F, type HttpClientConfig as H, Index as I, QueryMode as Q, type RequesterConfig as R, type SparseVector as S, type UpstashRequest as U, type Vector as V, WeightingStrategy as W, type Requester as a, type UpstashResponse as b, type RangeResult as c, type FetchResult as d, type QueryResult as e, type InfoResult as f };

package/package.json

@@ -1 +1 @@
-{ "name": "@upstash/vector", "version": "v1.2.1", "author": "Oguzhan Olguncu <oguzhan@upstash.com>", "repository": { "type": "git", "url": "https://github.com/upstash/vector-js" }, "exports": { ".": { "import": "./dist/nodejs.mjs", "require": "./dist/nodejs.js" }, "./cloudflare": { "import": "./dist/cloudflare.mjs", "require": "./dist/cloudflare.js" }, "./nodejs": { "import": "./dist/nodejs.mjs", "require": "./dist/nodejs.js" } }, "main": "./dist/nodejs.js", "module": "./dist/nodejs.mjs", "types": "./dist/nodejs.d.ts", "devDependencies": { "@commitlint/cli": "^18.6.0", "@commitlint/config-conventional": "^18.6.0", "@typescript-eslint/eslint-plugin": "^8.4.0", "bun-types": "latest", "eslint": "9.10.0", "eslint-plugin-unicorn": "^55.0.0", "husky": "^8.0.3", "prettier": "^3.3.3", "tsup": "latest", "typescript": "^5.0.0", "vitest": "^1.2.2" }, "bugs": { "url": "https://github.com/upstash/vector/issues" }, "description": "An HTTP/REST based Vector DB client built on top of Upstash REST API.", "files": [ "dist" ], "homepage": "https://upstash.com/vector", "keywords": [ "vector", "upstash", "db" ], "license": "MIT", "scripts": { "test": "bun test src --coverage --bail --coverageSkipTestFiles=[test-utils.ts] --timeout 20000", "fmt": "prettier --write .", "lint": "tsc && eslint \"src/**/*.{js,ts,tsx}\" --quiet --fix", "build": "tsup ", "prepare": "husky install" } }
+{ "name": "@upstash/vector", "version": "1.2.3", "author": "Oguzhan Olguncu <oguzhan@upstash.com>", "repository": { "type": "git", "url": "git@github.com:upstash/vector-js.git" }, "exports": { ".": { "import": "./dist/nodejs.mjs", "require": "./dist/nodejs.js" }, "./cloudflare": { "import": "./dist/cloudflare.mjs", "require": "./dist/cloudflare.js" }, "./nodejs": { "import": "./dist/nodejs.mjs", "require": "./dist/nodejs.js" } }, "main": "./dist/nodejs.js", "module": "./dist/nodejs.mjs", "types": "./dist/nodejs.d.ts", "devDependencies": { "@commitlint/cli": "^18.6.0", "@commitlint/config-conventional": "^18.6.0", "@typescript-eslint/eslint-plugin": "^8.4.0", "bun-types": "latest", "eslint": "9.10.0", "eslint-plugin-unicorn": "^55.0.0", "husky": "^8.0.3", "prettier": "^3.3.3", "tsup": "latest", "typescript": "^5.0.0", "vitest": "^1.2.2" }, "bugs": { "url": "https://github.com/upstash/vector/issues" }, "description": "An HTTP/REST based Vector DB client built on top of Upstash REST API.", "files": [ "dist" ], "homepage": "https://upstash.com/vector", "keywords": [ "vector", "upstash", "db" ], "license": "MIT", "scripts": { "test": "bun test src --coverage --bail --coverageSkipTestFiles=[test-utils.ts] --timeout 20000", "fmt": "prettier --write .", "lint": "tsc && eslint \"src/**/*.{js,ts,tsx}\" --quiet --fix", "build": "tsup ", "prepare": "husky install" } }