@anthropic-ai/foundry-sdk 0.4.4 → 0.4.6

package/src/internal/file-store.ts

@@ -7,14 +7,15 @@
  * scope.
  */
 
-import * as fsp from 'node:fs/promises';
-import * as path from 'node:path';
-import { constants as C } from 'node:fs';
 import type { BigIntStats, Dirent } from 'node:fs';
+import type { FileHandle } from 'node:fs/promises';
 import type * as util from 'node:util';
-import { createHash, randomBytes } from 'node:crypto';
+import { crypto, fs, path } from './node';
 import { encodeUTF8 } from './utils/bytes';
 
+const fsp = fs.promises;
+const C = fs.constants;
+
 // Owner-only regardless of umask: the store holds downloaded user/model content.
 const OWNER_ONLY_DIR_MODE = 0o700;
 const OWNER_ONLY_FILE_MODE = 0o600;
@@ -182,7 +183,7 @@ export class FileStore {
   /** The file's bytes; `null` when absent. */
   async get(relPath: string): Promise<Uint8Array | null> {
     const dest = this.resolveUnderRoot(relPath);
-    let handle: fsp.FileHandle;
+    let handle: FileHandle;
     try {
       handle = await openRegularFile(relPath, dest);
     } catch (e) {
@@ -388,8 +389,8 @@ async function makeDirsBelowRoot(root: string, dir: string): Promise<void> {
 
 async function replaceViaTemp(dest: string, data: Uint8Array, isExecutable: boolean): Promise<void> {
   const mode = isExecutable ? OWNER_ONLY_EXEC_MODE : OWNER_ONLY_FILE_MODE;
-  const tmp = path.join(path.dirname(dest), `.fs-${randomBytes(8).toString('hex')}.tmp`);
-  let handle: fsp.FileHandle | undefined;
+  const tmp = path.join(path.dirname(dest), `.fs-${crypto.randomBytes(8).toString('hex')}.tmp`);
+  let handle: FileHandle | undefined;
   try {
     handle = await fsp.open(tmp, C.O_WRONLY | C.O_CREAT | C.O_EXCL | O_NOFOLLOW, mode);
     await handle.writeFile(data);
@@ -404,9 +405,9 @@ async function replaceViaTemp(dest: string, data: Uint8Array, isExecutable: bool
   }
 }
 
-async function openRegularFile(relPath: string, dest: string): Promise<fsp.FileHandle> {
+async function openRegularFile(relPath: string, dest: string): Promise<FileHandle> {
   // O_NONBLOCK: a FIFO fails the fstat check below instead of blocking the open.
-  let handle: fsp.FileHandle;
+  let handle: FileHandle;
   try {
     handle = await fsp.open(dest, C.O_RDONLY | O_NOFOLLOW | O_NONBLOCK);
   } catch (e) {
@@ -429,7 +430,7 @@ async function openRegularFile(relPath: string, dest: string): Promise<fsp.FileH
 
 /** sha256 of a file's contents, streamed — constant memory on any file size. */
 async function hashFile(full: string): Promise<string> {
-  const digest = createHash('sha256');
+  const digest = crypto.createHash('sha256');
   const handle = await openRegularFile(path.basename(full), full);
   const buf = new Uint8Array(1024 * 1024);
   try {

package/src/internal/headers.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { isReadonlyArray } from './utils/values';
 
 type HeaderValue = string | undefined | null;

package/src/internal/node.browser.ts

@@ -0,0 +1,22 @@
+import { AnthropicError } from '../core/error';
+import type * as node from './node';
+
+/** Substituted for `./node` by the package.json `browser` field; every property access throws. */
+function unavailable<T extends object>(module: string): T {
+  return new Proxy({} as T, {
+    get(_target, property) {
+      if (typeof property === 'symbol') return undefined;
+      throw new AnthropicError(
+        `\`${module}.${property}\` is not available in this environment; it needs a Node.js-compatible runtime`,
+      );
+    },
+  });
+}
+
+export const child_process: typeof node.child_process = unavailable('child_process');
+export const crypto: typeof node.crypto = unavailable('crypto');
+export const fs: typeof node.fs = unavailable('fs');
+export const os: typeof node.os = unavailable('os');
+export const path: typeof node.path = unavailable('path');
+export const stream: typeof node.stream = unavailable('stream');
+export const util: typeof node.util = unavailable('util');

package/src/internal/node.ts

@@ -0,0 +1,14 @@
+/**
+ * The one module under `src/` that may import Node built-ins (eslint enforces this).
+ * The package.json `browser` field swaps it for `./node.browser`, so only touch its
+ * exports on code paths that run on Node-compatible runtimes.
+ */
+import * as child_process from 'node:child_process';
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import * as stream from 'node:stream';
+import * as util from 'node:util';
+
+export { child_process, crypto, fs, os, path, stream, util };

package/src/internal/parse.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import type { FinalRequestOptions } from './request-options';
 import { Stream } from '../core/streaming';
 import { type BaseAnthropic } from '../client';
@@ -28,7 +26,7 @@ export async function defaultParseResponse<T>(
       // Note: there is an invariant here that isn't represented in the type system
       // that if you set `stream: true` the response type must also be `Stream<T>`
 
-      return Stream.fromSSEResponse(response, props.controller) as any;
+      return Stream.fromSSEResponse(response, props.controller, client) as any;
     }
 
     // fetch refuses to read the body when the status code is 204.

package/src/internal/request-options.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { NullableHeaders } from './headers';
 
 import type { BodyInit } from './builtin-types';
@@ -120,7 +118,7 @@ export interface RequestOptions {
   fallbackState?: BetaFallbackState;
 
   /**
-   * A unique key for this request to enable idempotency.
+   * @deprecated This option has no effect and will be removed in a future major version.
    */
   idempotencyKey?: string;
 

package/src/internal/shim-types.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 /**
  * Shims for types that we can't always rely on being available globally.
  *

package/src/internal/shims.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 /**
  * This module provides internal shims and utility functions for environments where certain Node.js or global types may not be available.
  *

package/src/internal/types.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export type PromiseOrValue<T> = T | Promise<T>;
 export type HTTPMethod = 'get' | 'post' | 'put' | 'patch' | 'delete';
 

package/src/internal/uploads.ts

@@ -137,14 +137,11 @@ export const createForm = async <T = Record<string, unknown>>(
   return form;
 };
 
-// We check for Blob not File because Bun.File doesn't inherit from File,
-// but they both inherit from Blob and have a `name` property at runtime.
-const isNamedBlob = (value: unknown): value is Blob => value instanceof Blob && 'name' in value;
-
+// Blob, not File: bare Blobs and Bun.file() results don't inherit from File.
 const isUploadable = (value: unknown) =>
   typeof value === 'object' &&
   value !== null &&
-  (value instanceof Response || isAsyncIterable(value) || isNamedBlob(value));
+  (value instanceof Response || isAsyncIterable(value) || value instanceof Blob);
 
 const hasUploadableValue = (value: unknown): boolean => {
   if (isUploadable(value)) return true;
@@ -186,10 +183,16 @@ const addFormValue = async (
       key,
       makeFile([await new Response(ReadableStreamFrom(value)).blob()], getName(value, stripFilenames)),
     );
-  } else if (isNamedBlob(value)) {
-    form.append(key, makeFile([value], getName(value, stripFilenames), { type: value.type }));
+  } else if (value instanceof Blob) {
+    form.append(key, makeFile([value], getName(value, stripFilenames) || undefined, { type: value.type }));
   } else if (Array.isArray(value)) {
     await Promise.all(value.map((entry) => addFormValue(form, key + '[]', entry, stripFilenames)));
+  } else if (typeof (value as any).then === 'function') {
+    throw new TypeError(`Received a Promise for "${key}"; await it first, e.g. \`await toFile(...)\``);
+  } else if (value instanceof ArrayBuffer || ArrayBuffer.isView(value)) {
+    throw new TypeError(
+      `Received ${value.constructor.name} for "${key}"; to upload raw bytes, wrap them with \`await toFile(bytes, 'filename')\``,
+    );
   } else if (typeof value === 'object') {
     await Promise.all(
       Object.entries(value).map(([name, prop]) =>

package/src/internal/utils/base64.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { AnthropicError } from '../../core/error';
 import { encodeUTF8 } from './bytes';
 

package/src/internal/utils/env.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 /**
  * Read an environment variable.
  *

package/src/internal/utils/log.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { hasOwn } from './values';
 import { readEnv } from './env';
 import { type BaseAnthropic } from '../../client';

package/src/internal/utils/query.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import * as qs from '../qs/stringify';
 
 export function stringifyQuery(query: object | Record<string, unknown>) {

package/src/internal/utils/uuid.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 /**
  * https://stackoverflow.com/a/2117523
  */

package/src/internal/utils/values.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { AnthropicError } from '../../core/error';
 
 // https://url.spec.whatwg.org/#url-scheme-string
@@ -110,3 +108,10 @@ export const pop = <T extends Record<string, any>, K extends string>(obj: T, key
   delete obj[key];
   return value;
 };
+
+/**
+ * Compile-time exhaustiveness check: passing a value here only type-checks once every
+ * member of its union has been handled. Does nothing at runtime, so unknown values from a
+ * newer API version fall through instead of throwing.
+ */
+export function checkNever(_value: never): void {}

package/src/internal/utils.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export * from './utils/values';
 export * from './utils/base64';
 export * from './utils/env';