feat: support ESM and web platform runtimes (#25)

We have added or improved support for:
- EcmaScript Modules (ESM) for Node and others (in addition to CJS)
- Cloudflare Workers
- Vercel Edge Runtime
- Deno
- Browser (tested with webpack) - though you should not expose your secret key.

In Node, we still use libraries like `node-fetch` and `formdata-node`; in others, we use the native APIs.

Co-authored-by: Stainless Bot <[email protected]>

Author: rattrayalex

.gitignore

@@ -1,3 +1,4 @@
 node_modules
 yarn-error.log
 dist
+/*.tgz

.npmignore

@@ -1 +1,3 @@
 CHANGELOG.md
+/ecosystem-tests
+/node_modules

.prettierignore

@@ -0,0 +1,20 @@
+/**
+ * Disclaimer: modules in _shims aren't intended to be imported by SDK users.
+ */
+
+import KeepAliveAgent from 'agentkeepalive';
+import type { Agent } from 'node:http';
+import { AbortController as AbortControllerPolyfill } from 'abort-controller';
+
+const defaultHttpAgent: Agent = new KeepAliveAgent({ keepAlive: true, timeout: 5 * 60 * 1000 });
+const defaultHttpsAgent: Agent = new KeepAliveAgent.HttpsAgent({ keepAlive: true, timeout: 5 * 60 * 1000 });
+
+// Polyfill global object if needed.
+if (typeof AbortController === 'undefined') {
+  AbortController = AbortControllerPolyfill as any as typeof AbortController;
+}
+
+export const getDefaultAgent = (url: string): Agent | undefined => {
+  if (defaultHttpsAgent && url.startsWith('https')) return defaultHttpsAgent;
+  return defaultHttpAgent;
+};

_shims/agent.node.ts

@@ -0,0 +1,12 @@
+/**
+ * Disclaimer: modules in _shims aren't intended to be imported by SDK users.
+ *
+ * This is a stub for non-node environments.
+ * In node environments, it gets replaced agent.node.ts by the package export map
+ */
+
+import type { Agent } from 'node:http';
+
+export const getDefaultAgent = (url: string): Agent | undefined => {
+  return undefined;
+};

_shims/agent.ts

@@ -0,0 +1,11 @@
+/**
+ * Disclaimer: modules in _shims aren't intended to be imported by SDK users.
+ */
+
+import fetch, { Request, Response, Headers } from 'node-fetch';
+import type { RequestInfo, RequestInit, BodyInit } from 'node-fetch';
+
+export { fetch, Request, Response, Headers };
+export type { RequestInfo, RequestInit, BodyInit };
+
+export const isPolyfilled = true;

_shims/fetch.node.ts

@@ -0,0 +1,32 @@
+/**
+ * Disclaimer: modules in _shims aren't intended to be imported by SDK users.
+ */
+
+import type * as nf from 'node-fetch';
+
+const _fetch: typeof nf.default =
+  // @ts-ignore
+  fetch as any;
+type _fetch = typeof nf.default;
+const _Request: typeof nf.Request =
+  // @ts-ignore
+  Request as any;
+type _Request = nf.Request;
+const _Response: typeof nf.Response =
+  // @ts-ignore
+  Response as any;
+type _Response = nf.Response;
+const _Headers: typeof nf.Headers =
+  // @ts-ignore
+  Headers as any;
+type _Headers = nf.Headers;
+
+export const isPolyfilled = false;
+
+export { _fetch as fetch, _Request as Request, _Response as Response, _Headers as Headers };
+
+type _RequestInfo = nf.RequestInfo;
+type _RequestInit = nf.RequestInit;
+type _BodyInit = nf.BodyInit;
+
+export type { _RequestInit as RequestInit, _RequestInfo as RequestInfo, _BodyInit as BodyInit };

_shims/fetch.ts

@@ -0,0 +1,30 @@
+/**
+ * Disclaimer: modules in _shims aren't intended to be imported by SDK users.
+ */
+
+import type { FilePropertyBag } from 'formdata-node';
+import { fileFromPath as _fileFromPath } from 'formdata-node/file-from-path';
+import type { File } from './formdata.node';
+
+export type FileFromPathOptions = Omit<FilePropertyBag, 'lastModified'>;
+
+let warned = false;
+
+/**
+ * @deprecated use fs.createReadStream('./my/file.txt') instead
+ */
+export async function fileFromPath(path: string): Promise<File>;
+export async function fileFromPath(path: string, filename?: string): Promise<File>;
+export async function fileFromPath(path: string, options?: FileFromPathOptions): Promise<File>;
+export async function fileFromPath(
+  path: string,
+  filename?: string,
+  options?: FileFromPathOptions,
+): Promise<File>;
+export async function fileFromPath(path: string, ...args: any[]): Promise<File> {
+  if (!warned) {
+    console.warn(`fileFromPath is deprecated; use fs.createReadStream(${JSON.stringify(path)}) instead`);
+    warned = true;
+  }
+  return await _fileFromPath(path, ...args);
+}

_shims/fileFromPath.node.ts

@@ -0,0 +1,30 @@
+/**
+ * Disclaimer: modules in _shims aren't intended to be imported by SDK users.
+ *
+ * This is a stub that gets replaced by fileFromPath.node.js for node environments
+ * in the package export map
+ */
+
+import type { FilePropertyBag } from 'formdata-node';
+import type { File } from './formdata';
+
+export type FileFromPathOptions = Omit<FilePropertyBag, 'lastModified'>;
+
+/**
+ * This is a stub for non-node environments that just throws an error.
+ * In node environments, this module will be replaced by util/node/fileFromPath by the
+ * package import map.
+ */
+export async function fileFromPath(path: string): Promise<File>;
+export async function fileFromPath(path: string, filename?: string): Promise<File>;
+export async function fileFromPath(path: string, options?: FileFromPathOptions): Promise<File>;
+export async function fileFromPath(
+  path: string,
+  filename?: string,
+  options?: FileFromPathOptions,
+): Promise<File>;
+export async function fileFromPath(): Promise<File> {
+  throw new Error(
+    'The `fileFromPath` function is only supported in Node. See the README for more details: https://www.github.com/anthropics/anthropic-sdk-typescript#file-uploads',
+  );
+}

_shims/fileFromPath.ts

@@ -0,0 +1,9 @@
+/**
+ * Disclaimer: modules in _shims aren't intended to be imported by SDK users.
+ */
+
+import { FormData, File, Blob } from 'formdata-node';
+
+export { FormData, File, Blob };
+
+export const isPolyfilled = true;