exa-js 1.9.1 → 1.9.3

package/dist/index.js

@@ -71,6 +71,89 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 var import_cross_fetch = __toESM(require("cross-fetch"));
 
+// package.json
+var package_default = {
+  name: "exa-js",
+  version: "1.9.3",
+  description: "Exa SDK for Node.js and the browser",
+  publishConfig: {
+    access: "public"
+  },
+  files: [
+    "dist"
+  ],
+  main: "./dist/index.js",
+  module: "./dist/index.mjs",
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      require: "./dist/index.js",
+      module: "./dist/index.mjs",
+      import: "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  types: "./dist/index.d.ts",
+  scripts: {
+    "build-fast": "tsup src/index.ts --format cjs,esm",
+    build: "tsup",
+    test: "vitest run",
+    typecheck: "tsc --noEmit",
+    "typecheck:src": "tsc --noEmit src/**/*.ts",
+    "typecheck:examples": "tsc --noEmit examples/**/*.ts",
+    "generate:types:websets": "openapi-typescript https://raw.githubusercontent.com/exa-labs/openapi-spec/refs/heads/master/exa-websets-spec.yaml  --enum --root-types --alphabetize --root-types-no-schema-prefix --output ./src/websets/openapi.ts && npm run format:websets",
+    format: 'prettier --write "src/**/*.ts" "examples/**/*.ts"',
+    "format:websets": "prettier --write src/websets/openapi.ts",
+    "build:beta": "cross-env NPM_CONFIG_TAG=beta npm run build",
+    "version:beta": "npm version prerelease --preid=beta",
+    "version:stable": "npm version patch",
+    "publish:beta": "npm run version:beta && npm run build:beta && npm publish --tag beta",
+    "publish:stable": "npm run version:stable && npm run build && npm publish",
+    prepublishOnly: "npm run build"
+  },
+  license: "MIT",
+  devDependencies: {
+    "@types/node": "~22.14.0",
+    "cross-env": "~7.0.3",
+    "openapi-typescript": "~7.6.1",
+    prettier: "~3.5.3",
+    "ts-node": "~10.9.2",
+    tsup: "~8.4.0",
+    typescript: "~5.8.3",
+    vitest: "~3.1.1"
+  },
+  dependencies: {
+    "cross-fetch": "~4.1.0",
+    dotenv: "~16.4.7",
+    openai: "^5.0.1",
+    zod: "^3.22.0",
+    "zod-to-json-schema": "^3.20.0"
+  },
+  directories: {
+    test: "test"
+  },
+  repository: {
+    type: "git",
+    url: "git+https://github.com/exa-labs/exa-js.git"
+  },
+  keywords: [
+    "exa",
+    "metaphor",
+    "search",
+    "AI",
+    "LLMs",
+    "RAG",
+    "retrieval",
+    "augmented",
+    "generation"
+  ],
+  author: "jeffzwang",
+  bugs: {
+    url: "https://github.com/exa-labs/exa-js/issues"
+  },
+  homepage: "https://github.com/exa-labs/exa-js#readme"
+};
+
 // src/errors.ts
 var HttpStatusCode = /* @__PURE__ */ ((HttpStatusCode2) => {
   HttpStatusCode2[HttpStatusCode2["BadRequest"] = 400] = "BadRequest";
@@ -100,6 +183,173 @@ var ExaError = class extends Error {
   }
 };
 
+// src/zod-utils.ts
+var import_zod = require("zod");
+var import_zod_to_json_schema = require("zod-to-json-schema");
+function isZodSchema(obj) {
+  return obj instanceof import_zod.ZodType;
+}
+function zodToJsonSchema(schema) {
+  return (0, import_zod_to_json_schema.zodToJsonSchema)(schema, {
+    $refStrategy: "none"
+  });
+}
+
+// src/research/base.ts
+var ResearchBaseClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async request(endpoint, method = "POST", data, params) {
+    return this.client.request(
+      `/research/v1${endpoint}`,
+      method,
+      data,
+      params
+    );
+  }
+  async rawRequest(endpoint, method = "POST", data, params) {
+    return this.client.rawRequest(
+      `/research/v1${endpoint}`,
+      method,
+      data,
+      params
+    );
+  }
+  buildPaginationParams(pagination) {
+    const params = {};
+    if (!pagination) return params;
+    if (pagination.cursor) params.cursor = pagination.cursor;
+    if (pagination.limit) params.limit = pagination.limit;
+    return params;
+  }
+};
+
+// src/research/client.ts
+var ResearchClient = class extends ResearchBaseClient {
+  constructor(client) {
+    super(client);
+  }
+  async create(params) {
+    const { instructions, model, outputSchema } = params;
+    let schema = outputSchema;
+    if (schema && isZodSchema(schema)) {
+      schema = zodToJsonSchema(schema);
+    }
+    const payload = {
+      instructions,
+      model: model ?? "exa-research"
+    };
+    if (schema) {
+      payload.outputSchema = schema;
+    }
+    return this.request("", "POST", payload);
+  }
+  get(researchId, options) {
+    if (options?.stream) {
+      const promise = async () => {
+        const params = { stream: "true" };
+        if (options.events !== void 0) {
+          params.events = options.events.toString();
+        }
+        const resp = await this.rawRequest(
+          `/${researchId}`,
+          "GET",
+          void 0,
+          params
+        );
+        if (!resp.body) {
+          throw new Error("No response body for SSE stream");
+        }
+        const reader = resp.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        function processPart(part) {
+          const lines = part.split("\n");
+          let data = lines.slice(1).join("\n");
+          if (data.startsWith("data:")) {
+            data = data.slice(5).trimStart();
+          }
+          try {
+            return JSON.parse(data);
+          } catch (e) {
+            return null;
+          }
+        }
+        async function* streamEvents() {
+          while (true) {
+            const { done, value } = await reader.read();
+            if (done) break;
+            buffer += decoder.decode(value, { stream: true });
+            let parts = buffer.split("\n\n");
+            buffer = parts.pop() ?? "";
+            for (const part of parts) {
+              const processed = processPart(part);
+              if (processed) {
+                yield processed;
+              }
+            }
+          }
+          if (buffer.trim()) {
+            const processed = processPart(buffer.trim());
+            if (processed) {
+              yield processed;
+            }
+          }
+        }
+        return streamEvents();
+      };
+      return promise();
+    } else {
+      const params = { stream: "false" };
+      if (options?.events !== void 0) {
+        params.events = options.events.toString();
+      }
+      return this.request(
+        `/${researchId}`,
+        "GET",
+        void 0,
+        params
+      );
+    }
+  }
+  async list(options) {
+    const params = this.buildPaginationParams(options);
+    return this.request("", "GET", void 0, params);
+  }
+  async pollUntilFinished(researchId, options) {
+    const pollInterval = options?.pollInterval ?? 1e3;
+    const timeoutMs = options?.timeoutMs ?? 10 * 60 * 1e3;
+    const maxConsecutiveFailures = 5;
+    const startTime = Date.now();
+    let consecutiveFailures = 0;
+    while (true) {
+      try {
+        const research = await this.get(researchId, {
+          events: options?.events
+        });
+        consecutiveFailures = 0;
+        if (research.status === "completed" || research.status === "failed" || research.status === "canceled") {
+          return research;
+        }
+      } catch (err) {
+        consecutiveFailures += 1;
+        if (consecutiveFailures >= maxConsecutiveFailures) {
+          throw new Error(
+            `Polling failed ${maxConsecutiveFailures} times in a row for research ${researchId}: ${err}`
+          );
+        }
+      }
+      if (Date.now() - startTime > timeoutMs) {
+        throw new Error(
+          `Polling timeout: Research ${researchId} did not complete within ${timeoutMs}ms`
+        );
+      }
+      await new Promise((resolve) => setTimeout(resolve, pollInterval));
+    }
+  }
+};
+
 // src/websets/base.ts
 var WebsetsBaseClient = class {
   /**
@@ -1076,173 +1326,6 @@ var WebsetsClient = class extends WebsetsBaseClient {
   }
 };
 
-// src/zod-utils.ts
-var import_zod = require("zod");
-var import_zod_to_json_schema = require("zod-to-json-schema");
-function isZodSchema(obj) {
-  return obj instanceof import_zod.ZodType;
-}
-function zodToJsonSchema(schema) {
-  return (0, import_zod_to_json_schema.zodToJsonSchema)(schema, {
-    $refStrategy: "none"
-  });
-}
-
-// src/research/base.ts
-var ResearchBaseClient = class {
-  constructor(client) {
-    this.client = client;
-  }
-  async request(endpoint, method = "POST", data, params) {
-    return this.client.request(
-      `/research/v1${endpoint}`,
-      method,
-      data,
-      params
-    );
-  }
-  async rawRequest(endpoint, method = "POST", data, params) {
-    return this.client.rawRequest(
-      `/research/v1${endpoint}`,
-      method,
-      data,
-      params
-    );
-  }
-  buildPaginationParams(pagination) {
-    const params = {};
-    if (!pagination) return params;
-    if (pagination.cursor) params.cursor = pagination.cursor;
-    if (pagination.limit) params.limit = pagination.limit;
-    return params;
-  }
-};
-
-// src/research/client.ts
-var ResearchClient = class extends ResearchBaseClient {
-  constructor(client) {
-    super(client);
-  }
-  async create(params) {
-    const { instructions, model, outputSchema } = params;
-    let schema = outputSchema;
-    if (schema && isZodSchema(schema)) {
-      schema = zodToJsonSchema(schema);
-    }
-    const payload = {
-      instructions,
-      model: model ?? "exa-research"
-    };
-    if (schema) {
-      payload.outputSchema = schema;
-    }
-    return this.request("", "POST", payload);
-  }
-  get(researchId, options) {
-    if (options?.stream) {
-      const promise = async () => {
-        const params = { stream: "true" };
-        if (options.events !== void 0) {
-          params.events = options.events.toString();
-        }
-        const resp = await this.rawRequest(
-          `/${researchId}`,
-          "GET",
-          void 0,
-          params
-        );
-        if (!resp.body) {
-          throw new Error("No response body for SSE stream");
-        }
-        const reader = resp.body.getReader();
-        const decoder = new TextDecoder();
-        let buffer = "";
-        function processPart(part) {
-          const lines = part.split("\n");
-          let data = lines.slice(1).join("\n");
-          if (data.startsWith("data:")) {
-            data = data.slice(5).trimStart();
-          }
-          try {
-            return JSON.parse(data);
-          } catch (e) {
-            return null;
-          }
-        }
-        async function* streamEvents() {
-          while (true) {
-            const { done, value } = await reader.read();
-            if (done) break;
-            buffer += decoder.decode(value, { stream: true });
-            let parts = buffer.split("\n\n");
-            buffer = parts.pop() ?? "";
-            for (const part of parts) {
-              const processed = processPart(part);
-              if (processed) {
-                yield processed;
-              }
-            }
-          }
-          if (buffer.trim()) {
-            const processed = processPart(buffer.trim());
-            if (processed) {
-              yield processed;
-            }
-          }
-        }
-        return streamEvents();
-      };
-      return promise();
-    } else {
-      const params = { stream: "false" };
-      if (options?.events !== void 0) {
-        params.events = options.events.toString();
-      }
-      return this.request(
-        `/${researchId}`,
-        "GET",
-        void 0,
-        params
-      );
-    }
-  }
-  async list(options) {
-    const params = this.buildPaginationParams(options);
-    return this.request("", "GET", void 0, params);
-  }
-  async pollUntilFinished(researchId, options) {
-    const pollInterval = options?.pollInterval ?? 1e3;
-    const timeoutMs = options?.timeoutMs ?? 10 * 60 * 1e3;
-    const maxConsecutiveFailures = 5;
-    const startTime = Date.now();
-    let consecutiveFailures = 0;
-    while (true) {
-      try {
-        const research = await this.get(researchId, {
-          events: options?.events
-        });
-        consecutiveFailures = 0;
-        if (research.status === "completed" || research.status === "failed" || research.status === "canceled") {
-          return research;
-        }
-      } catch (err) {
-        consecutiveFailures += 1;
-        if (consecutiveFailures >= maxConsecutiveFailures) {
-          throw new Error(
-            `Polling failed ${maxConsecutiveFailures} times in a row for research ${researchId}: ${err}`
-          );
-        }
-      }
-      if (Date.now() - startTime > timeoutMs) {
-        throw new Error(
-          `Polling timeout: Research ${researchId} did not complete within ${timeoutMs}ms`
-        );
-      }
-      await new Promise((resolve) => setTimeout(resolve, pollInterval));
-    }
-  }
-};
-
 // src/index.ts
 var fetchImpl = typeof global !== "undefined" && global.fetch ? global.fetch : import_cross_fetch.default;
 var HeadersImpl = typeof global !== "undefined" && global.Headers ? global.Headers : import_cross_fetch.Headers;
@@ -1311,7 +1394,7 @@ var Exa2 = class {
     this.headers = new HeadersImpl({
       "x-api-key": apiKey,
       "Content-Type": "application/json",
-      "User-Agent": "exa-node 1.4.0"
+      "User-Agent": `exa-node ${package_default.version}`
     });
     this.websets = new WebsetsClient(this);
     this.research = new ResearchClient(this);
@@ -1498,7 +1581,8 @@ var Exa2 = class {
       text: options?.text ?? false,
       model: options?.model ?? "exa",
       systemPrompt: options?.systemPrompt,
-      outputSchema
+      outputSchema,
+      userLocation: options?.userLocation
     };
     return await this.request("/answer", "POST", requestBody);
   }