@boundaryml/baml-core-node 0.11.2-nightly.20260604.d

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * THIS FILE IS AUTO-GENERATED — DO NOT EDIT BY HAND.
+ *
+ * Source: baml_language/crates/bridge_nodejs/typescript_src/
+ * Proto:  baml_language/crates/bridge_ctypes/types/baml_core/cffi/v1/*.proto
+ * Build:  cd baml_language/crates/bridge_nodejs && pnpm build:debug
+ */
+import { BamlRuntime, AbortController, HostSpanManager, Collector as NativeCollector, FunctionLog as NativeFunctionLog, Timing, Usage, LLMCall } from './native.js';
+export { BamlRuntime, AbortController, BamlHandle, HostSpanManager, getRuntime, getVersion, flushEvents } from './native.js';
+export { Timing, Usage, LLMCall } from './native.js';
+export { takeHandleFromTable, putHandleIntoTable, _seedFunctionRefHandle, _seedGenericMediaHandle, } from './native.js';
+export { BamlImage, BamlAudio, BamlVideo, BamlPdf } from './native.js';
+export { BamlStream } from './stream.js';
+export { encodeCallArgs, decodeCallResult } from './proto.js';
+export { CtxManager } from './ctx_manager.js';
+export { BamlTypeMap, setTypeMap, getTypeMap } from './typemap.js';
+export { defineFunction, defineInstanceFunction, UNSET } from './define_function.js';
+/**
+ * Free-function runtime initializer used by generated `baml_sdk/index.ts`:
+ * `initializeRuntime("baml_src", _inlinedbaml.FILES)`. Thin wrapper over the
+ * `BamlRuntime.initializeRuntime` factory (which sets the process-global
+ * singleton reachable via `getRuntime()`).
+ */
+export declare function initializeRuntime(srcDir: string, files: Record<string, string>): void;
+/**
+ * Free-function runtime initializer used by generated `baml_sdk/index.ts` when
+ * codegen embeds precompiled BAML bytecode.
+ */
+export declare function initializeRuntimeFromBytecode(bytecode: Buffer | Uint8Array): void;
+export { BamlError, BamlInvalidArgumentError, BamlClientError, BamlCancelledError, BamlPanic, wrapNativeError, } from './errors.js';
+export declare class FunctionResult {
+    private _value;
+    constructor(value: unknown);
+    result(): unknown;
+    toString(): string;
+}
+export declare class FunctionLog {
+    private _inner;
+    constructor(inner: NativeFunctionLog);
+    get id(): string;
+    get functionName(): string;
+    get timing(): Timing;
+    get usage(): Usage;
+    get calls(): LLMCall[];
+    get tags(): Record<string, string>;
+    get result(): unknown;
+}
+export declare class Collector {
+    private _inner;
+    constructor(name?: string);
+    get name(): string;
+    get logs(): FunctionLog[];
+    get last(): FunctionLog | null;
+    get usage(): Usage;
+    clear(): number;
+    id(functionLogId: string): FunctionLog | null;
+    /** Internal: get native collector for passing to Rust */
+    _native(): NativeCollector;
+}
+export declare function callFunctionSync(rt: BamlRuntime, functionName: string, kwargs: Record<string, unknown>, ctx?: HostSpanManager, collectors?: Collector[], abortController?: AbortController): FunctionResult;
+export declare function callFunction(rt: BamlRuntime, functionName: string, kwargs: Record<string, unknown>, ctx?: HostSpanManager, collectors?: Collector[], abortController?: AbortController): Promise<FunctionResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../typescript_src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,125 @@
+/**
+ * THIS FILE IS AUTO-GENERATED — DO NOT EDIT BY HAND.
+ *
+ * Source: baml_language/crates/bridge_nodejs/typescript_src/
+ * Proto:  baml_language/crates/bridge_ctypes/types/baml_core/cffi/v1/*.proto
+ * Build:  cd baml_language/crates/bridge_nodejs && pnpm build:debug
+ */
+// index.ts — mirrors bridge_python/python_src/baml_py/__init__.py
+import { BamlRuntime, Collector as NativeCollector, } from './native.js';
+import { encodeCallArgs, decodeCallResult } from './proto.js';
+import { installFlushOnExit } from './exit_hook.js';
+export { BamlRuntime, AbortController, BamlHandle, HostSpanManager, getRuntime, getVersion, flushEvents } from './native.js';
+export { Timing, Usage } from './native.js';
+// Handle-table helpers (decode validate-on-take / encode clone-on-put + test seeds).
+export { takeHandleFromTable, putHandleIntoTable, _seedFunctionRefHandle, _seedGenericMediaHandle, } from './native.js';
+// Runtime-owned stdlib value classes. Exported under their `Baml*` names only;
+// codegen aliases them as Image/Audio/Video/Pdf on re-export.
+export { BamlImage, BamlAudio, BamlVideo, BamlPdf } from './native.js';
+// Stream wrapper. Exported as `BamlStream`; codegen aliases it as `Stream`.
+export { BamlStream } from './stream.js';
+export { encodeCallArgs, decodeCallResult } from './proto.js';
+export { CtxManager } from './ctx_manager.js';
+// Codegen support: typemap + placeholder sentinel + free runtime initializer.
+export { BamlTypeMap, setTypeMap, getTypeMap } from './typemap.js';
+// Callable factories the generated SDK emits for every BAML function/method.
+export { defineFunction, defineInstanceFunction, UNSET } from './define_function.js';
+/**
+ * Free-function runtime initializer used by generated `baml_sdk/index.ts`:
+ * `initializeRuntime("baml_src", _inlinedbaml.FILES)`. Thin wrapper over the
+ * `BamlRuntime.initializeRuntime` factory (which sets the process-global
+ * singleton reachable via `getRuntime()`).
+ */
+export function initializeRuntime(srcDir, files) {
+    BamlRuntime.initializeRuntime(srcDir, files);
+}
+/**
+ * Free-function runtime initializer used by generated `baml_sdk/index.ts` when
+ * codegen embeds precompiled BAML bytecode.
+ */
+export function initializeRuntimeFromBytecode(bytecode) {
+    BamlRuntime.initializeRuntimeFromBytecode(Buffer.from(bytecode));
+}
+import { wrapNativeError } from './errors.js';
+export { BamlError, BamlInvalidArgumentError, BamlClientError, BamlCancelledError, BamlPanic, wrapNativeError, } from './errors.js';
+export class FunctionResult {
+    _value;
+    constructor(value) {
+        this._value = value;
+    }
+    result() {
+        return this._value;
+    }
+    toString() {
+        return `FunctionResult(${JSON.stringify(this._value)})`;
+    }
+}
+export class FunctionLog {
+    _inner;
+    constructor(inner) { this._inner = inner; }
+    get id() { return this._inner.id; }
+    get functionName() { return this._inner.functionName; }
+    get timing() { return this._inner.timing; }
+    get usage() { return this._inner.usage; }
+    get calls() { return this._inner.calls; }
+    get tags() { return this._inner.tags; }
+    // FIXME: Returns null for both "no serialized result" (bytes == null) and a legitimate
+    // BAML null result (decodeCallResult returns null). Legacy engine/ had no result getter
+    // on FunctionLog at all. bridge_python has the same ambiguity (None for both cases).
+    // Leaving as-is for parity with bridge_python; narrow edge case in practice.
+    get result() {
+        const bytes = this._inner.result;
+        if (bytes == null)
+            return null;
+        return decodeCallResult(bytes);
+    }
+}
+export class Collector {
+    _inner;
+    constructor(name) { this._inner = new NativeCollector(name ?? null); }
+    get name() { return this._inner.name; }
+    get logs() {
+        return this._inner.logs.map((l) => new FunctionLog(l));
+    }
+    get last() {
+        const l = this._inner.last;
+        return l ? new FunctionLog(l) : null;
+    }
+    get usage() { return this._inner.usage; }
+    clear() { return this._inner.clear(); }
+    id(functionLogId) {
+        const l = this._inner.id(functionLogId);
+        return l ? new FunctionLog(l) : null;
+    }
+    /** Internal: get native collector for passing to Rust */
+    _native() { return this._inner; }
+}
+export function callFunctionSync(rt, functionName, kwargs, ctx, collectors, abortController) {
+    // Encode in sync mode so a host callable in the kwargs fast-fails
+    // with a clear error instead of registering a tsfn and then hanging —
+    // the sync path blocks the Node main thread on a tokio `block_on`,
+    // starving libuv so the dispatch could never run.
+    const argsProto = encodeCallArgs(kwargs, /* syncMode */ true);
+    const nativeCollectors = collectors?.map(c => c._native()) ?? null;
+    try {
+        const resultBytes = rt.callFunctionSync(functionName, argsProto, ctx ?? null, nativeCollectors, abortController ?? null);
+        return new FunctionResult(decodeCallResult(resultBytes));
+    }
+    catch (err) {
+        throw wrapNativeError(err);
+    }
+}
+export async function callFunction(rt, functionName, kwargs, ctx, collectors, abortController) {
+    const argsProto = encodeCallArgs(kwargs);
+    const nativeCollectors = collectors?.map(c => c._native()) ?? null;
+    try {
+        const resultBytes = await rt.callFunction(functionName, argsProto, ctx ?? null, nativeCollectors, abortController ?? null);
+        return new FunctionResult(decodeCallResult(resultBytes));
+    }
+    catch (err) {
+        throw wrapNativeError(err);
+    }
+}
+// Register flush on process exit (single registration; see exit_hook.ts).
+installFlushOnExit();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../typescript_src/index.ts"],"names":[],"mappings":"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"}

package/dist/native.d.ts

@@ -0,0 +1,280 @@
+/**
+ * THIS FILE IS AUTO-GENERATED — DO NOT EDIT BY HAND.
+ *
+ * Source: baml_language/crates/bridge_nodejs/typescript_src/
+ * Proto:  baml_language/crates/bridge_ctypes/types/baml_core/cffi/v1/*.proto
+ * Build:  cd baml_language/crates/bridge_nodejs && pnpm build:debug
+ */
+/* auto-generated by NAPI-RS */
+/* eslint-disable */
+/** An abort controller for cancelling BAML function calls. */
+export declare class AbortController {
+  constructor()
+  abort(): void
+  get aborted(): boolean
+}
+
+export declare class BamlAudio {
+  static fromUrl(url: string, mimeType?: string | undefined | null): BamlAudio
+  static fromFile(file: string, mimeType?: string | undefined | null): BamlAudio
+  static fromBase64(base64: string, mimeType?: string | undefined | null): BamlAudio
+  url(): string | null
+  file(): string | null
+  base64(): string
+  mimeType(): string | null
+  /**
+   * Internal: build from an existing `BamlHandle`. Used by proto
+   * decode. Validates the handle's `handle_type` tag matches the
+   * expected media kind, then clones the table row so the input
+   * handle stays usable.
+   */
+  static _fromHandle(handle: BamlHandle): BamlAudio
+  /**
+   * Internal: produce a fresh `BamlHandle` pointing at the same
+   * table row (cloned). Used by inbound encode.
+   */
+  _toHandle(): BamlHandle
+}
+
+/**
+ * Base class for all opaque BAML handles.
+ *
+ * When the Node.js garbage collector finalizes an instance, `finalize`
+ * releases the corresponding entry from the global handle table.
+ */
+export declare class BamlHandle {
+  constructor(key: HandleKey, handleType: number)
+  get key(): HandleKey
+  get handleType(): number
+  clone(): BamlHandle
+}
+
+export declare class BamlImage {
+  static fromUrl(url: string, mimeType?: string | undefined | null): BamlImage
+  static fromFile(file: string, mimeType?: string | undefined | null): BamlImage
+  static fromBase64(base64: string, mimeType?: string | undefined | null): BamlImage
+  url(): string | null
+  file(): string | null
+  base64(): string
+  mimeType(): string | null
+  /**
+   * Internal: build from an existing `BamlHandle`. Used by proto
+   * decode. Validates the handle's `handle_type` tag matches the
+   * expected media kind, then clones the table row so the input
+   * handle stays usable.
+   */
+  static _fromHandle(handle: BamlHandle): BamlImage
+  /**
+   * Internal: produce a fresh `BamlHandle` pointing at the same
+   * table row (cloned). Used by inbound encode.
+   */
+  _toHandle(): BamlHandle
+}
+
+export declare class BamlPdf {
+  static fromUrl(url: string, mimeType?: string | undefined | null): BamlPdf
+  static fromFile(file: string, mimeType?: string | undefined | null): BamlPdf
+  static fromBase64(base64: string, mimeType?: string | undefined | null): BamlPdf
+  url(): string | null
+  file(): string | null
+  base64(): string
+  mimeType(): string | null
+  /**
+   * Internal: build from an existing `BamlHandle`. Used by proto
+   * decode. Validates the handle's `handle_type` tag matches the
+   * expected media kind, then clones the table row so the input
+   * handle stays usable.
+   */
+  static _fromHandle(handle: BamlHandle): BamlPdf
+  /**
+   * Internal: produce a fresh `BamlHandle` pointing at the same
+   * table row (cloned). Used by inbound encode.
+   */
+  _toHandle(): BamlHandle
+}
+
+/** The main BAML runtime. A zero-sized handle (see module docs). */
+export declare class BamlRuntime {
+  /**
+   * Initialize the process-global runtime from in-memory BAML source
+   * files. `bridge_cffi::initialize_runtime` is a single-slot singleton, so
+   * a second call replaces the prior runtime; the result is also reachable
+   * via the module-level `getRuntime()`. Renamed from `fromFiles` for
+   * parity with `bridge_python`'s sole `initialize_runtime` constructor and
+   * the `initializeRuntime(...)` import the spec docs use.
+   */
+  static initializeRuntime(rootPath: string, files: Record<string, string>): BamlRuntime
+  /** Initialize the process-global runtime from precompiled BAML bytecode. */
+  static initializeRuntimeFromBytecode(bytecode: Buffer): BamlRuntime
+  /** Call a BAML function synchronously (blocking). */
+  callFunctionSync(functionName: string, argsProto: Buffer, ctx?: HostSpanManager | undefined | null, collectors?: Array<Collector> | undefined | null, abortController?: AbortController | undefined | null): Buffer
+  /** Call a BAML function asynchronously. */
+  callFunction(functionName: string, argsProto: Buffer, ctx?: HostSpanManager | undefined | null, collectors?: Array<Collector> | undefined | null, abortController?: AbortController | undefined | null): Promise<Buffer>
+}
+
+export declare class BamlVideo {
+  static fromUrl(url: string, mimeType?: string | undefined | null): BamlVideo
+  static fromFile(file: string, mimeType?: string | undefined | null): BamlVideo
+  static fromBase64(base64: string, mimeType?: string | undefined | null): BamlVideo
+  url(): string | null
+  file(): string | null
+  base64(): string
+  mimeType(): string | null
+  /**
+   * Internal: build from an existing `BamlHandle`. Used by proto
+   * decode. Validates the handle's `handle_type` tag matches the
+   * expected media kind, then clones the table row so the input
+   * handle stays usable.
+   */
+  static _fromHandle(handle: BamlHandle): BamlVideo
+  /**
+   * Internal: produce a fresh `BamlHandle` pointing at the same
+   * table row (cloned). Used by inbound encode.
+   */
+  _toHandle(): BamlHandle
+}
+
+export declare class Collector {
+  constructor(name?: string | undefined | null)
+  get name(): string
+  get logs(): Array<FunctionLog>
+  get last(): FunctionLog | null
+  get usage(): Usage
+  clear(): number
+  id(functionLogId: string): FunctionLog | null
+}
+
+export declare class FunctionLog {
+  get id(): string
+  get functionName(): string
+  get timing(): Timing
+  get usage(): Usage
+  get calls(): Array<LLMCall>
+  get tags(): Record<string, string>
+  get result(): Buffer | null
+}
+
+export declare class HostSpanManager {
+  constructor()
+  enter(name: string, args: any): void
+  exitOk(): void
+  exitError(errorMessage: string): void
+  upsertTags(tags: Record<string, string>): void
+  deepClone(): HostSpanManager
+  contextDepth(): number
+}
+
+export declare class LlmCall {
+  get functionName(): string
+  get provider(): string | null
+  get timing(): Timing
+  get usage(): Usage
+}
+export type LLMCall = LlmCall
+
+export declare class Timing {
+  get startTimeUtcMs(): number
+  get durationMs(): number | null
+}
+
+export declare class Usage {
+  get inputTokens(): number | null
+  get outputTokens(): number | null
+  get cachedInputTokens(): number | null
+}
+
+/**
+ * Test-only: seed a `FunctionRef` entry into `HANDLE_TABLE`, returning
+ * `[key, handleType]` so test code can construct a `BamlHandle`.
+ */
+export declare function _seedFunctionRefHandle(globalIndex: number): [HandleKey, number]
+
+/** Test-only: seed an `Adt(Media(generic))` entry into `HANDLE_TABLE`. */
+export declare function _seedGenericMediaHandle(): [HandleKey, number]
+
+/**
+ * Complete an in-flight host call from the JS dispatch wrapper.
+ *
+ * Exposed to JS as `completeHostCall(callId, isError, content)`. The JS
+ * dispatch wrapper invokes this after it has decoded `argsBytes`, called
+ * the user function, and encoded the result (success) or constructed a
+ * `HostCallableError` (failure).
+ *
+ * Forwards directly to the `bridge_cffi::complete_host_call` C entry point
+ * the engine uses for cross-language completion.
+ */
+export declare function completeHostCall(callId: number, isError: number, content: Buffer): void
+
+/** Flush all buffered trace events to the JSONL file (if BAML_TRACE_FILE is set). */
+export declare function flushEvents(): void
+
+/**
+ * Return the process-global `BamlRuntime`, or a `BamlError`-shaped
+ * `napi::Error` if `initializeRuntime` has not run yet. The handle is
+ * zero-sized; the `Arc<dyn Bex>` lives in `bridge_cffi`. Mirrors
+ * `bridge_python`'s module-level `get_runtime()`.
+ */
+export declare function getRuntime(): BamlRuntime
+
+export declare function getVersion(): string
+
+/**
+ * A u64 handle key split into two i32 halves, mirroring the shape of
+ * protobufjs's `Long` type (`{ low: number, high: number }`).
+ *
+ * JavaScript has no convenient native representation for u64 — `number` is
+ * f64 and silently loses precision above 2^53. Rather than forcing BigInt
+ * (which many JS libraries don't handle well), we pass the key as two 32-bit
+ * halves that are layout-compatible with `Long`. This means a protobufjs
+ * `Long` decoded from a uint64 proto field can be handed directly to the
+ * `BamlHandle` constructor, and the `HandleKey` returned by the getter can
+ * be passed straight back into a proto uint64 field — no conversions needed.
+ */
+export interface HandleKey {
+  low: number
+  high: number
+}
+
+/**
+ * Allocate a fresh `HANDLE_TABLE` row sharing the same `Arc` as `handle`,
+ * returning the new key so the caller can stage a wire `BamlHandle`. The
+ * original `handle` keeps its key and stays usable. Mirrors
+ * `bridge_python::py_handle::put_pyhandle_into_table`.
+ */
+export declare function putHandleIntoTable(handle: BamlHandle): HandleKey
+
+/**
+ * Register a JS dispatch wrapper in the host-value table and return its key.
+ *
+ * Exposed to JS as `registerHostCallable(fn) -> HandleKey`. Called from
+ * the inbound encoder in `typescript_src/proto.ts` whenever a JS callable
+ * appears as a kwarg — the encoder constructs the dispatch wrapper around
+ * the user's function before calling this.
+ *
+ * The `Function` is converted into a `ThreadsafeFunction` so it can outlive
+ * the napi call scope and be invoked from any thread (the engine's tokio
+ * runtime calls into this entry point from a worker thread).
+ */
+export declare function registerHostCallable(callable: (callId: number, argsBytes: Buffer) => void): HandleKey
+
+/**
+ * Release a host callable the inbound encoder registered but never handed to
+ * the engine — the encode-error rollback path.
+ *
+ * Exposed to JS as `releaseHostCallable(key)`. When `encodeCallArgs`
+ * registers a callable for an early kwarg and then fails to encode a later
+ * kwarg, the `CallFunctionArgs` is never sent, so the engine never decodes
+ * (and so never releases) that key. Without this, the registry entry — and
+ * its strong `weak::<false>` tsfn ref, which keeps the libuv loop alive —
+ * would leak for the life of the process. The encoder calls this for every
+ * key it registered during a failed encode.
+ */
+export declare function releaseHostCallable(key: HandleKey): void
+
+/**
+ * Validate that `key` exists in `HANDLE_TABLE`, then wrap as a `BamlHandle`.
+ * Used by the proto decoder's handle path. Does **not** drain — the entry
+ * stays in the table and is owned by the returned `BamlHandle`. Mirrors
+ * `bridge_python::py_handle::take_pyhandle_from_table`.
+ */
+export declare function takeHandleFromTable(key: HandleKey, handleType: number): BamlHandle