@boundaryml/baml-bridge 0.0.0 → 0.13.1-nightly.20260707.e

package/dist/host_value_registry.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 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_bridge/cffi/v1/*.proto
+ * Build:  cd baml_language/crates/bridge_nodejs && pnpm build:debug
+ */
+import { type HandleKey } from './native.js';
+/**
+ * Register an arbitrary host JS value and return its native `HandleKey` for
+ * the `_handle: Handle(HOST_VALUE_OPAQUE, key)` slot of a
+ * `baml.errors.HostCallable` Instance (or any future opaque-value carrier).
+ * Mints a fresh key via the Rust side's shared counter (guaranteed non-zero —
+ * Rust `next_key` skips `0`); stores the value keyed by the same key
+ * (recomposed as a `bigint` for `Map`-key equality).
+ *
+ * Returns the native `HandleKey` directly so it can flow into the
+ * protobufjs encoder without an intermediate `bigint→Long` conversion
+ * (protobufjs reads `uint64` fields from a `{low, high}` shape, which
+ * the native `HandleKey` already provides; a bare `bigint` does not
+ * encode correctly through the `IInboundValue.handle.key` field).
+ */
+export declare function registerHostOpaque(value: unknown): HandleKey;
+/**
+ * Look up a host-registered JS value by key. Returns `undefined` when:
+ * - the key is the reserved sentinel `0n` (no real value was registered);
+ * - the engine has already released the entry (last `HostValueArc` clone
+ *   dropped → Rust `host_release_callback` fired → `_releaseHostValue`
+ *   removed the entry);
+ * - the key was minted by a different Node process (cross-runtime handle).
+ *
+ * Callers should fall back to a metadata-built exception in those cases.
+ *
+ * GC/decode race: a release notification and a rehydrating decode can be
+ * scheduled on the libuv loop concurrently in principle, but in practice
+ * the same `HostValueArc` cannot drop *while* the engine is actively
+ * emitting an outbound proto referencing its key — the outbound encode
+ * holds a strong handle through proto serialization, and the release tsfn
+ * isn't fired until that strong handle drops. By the time the TS decoder
+ * runs `tryRehydrateHostValueByKey`, the only way the map entry is gone is if
+ * a *prior* outbound completed and the engine has since dropped its last
+ * Arc; in that case the user has already observed the original throw at
+ * least once, so a second lookup-miss → metadata-fallback is acceptable.
+ */
+export declare function lookupHostValue(key: bigint): unknown;
+/**
+ * Convenience for the outbound decoder: if `handle` is a `BamlHandle`
+ * tagged `HOST_VALUE_OPAQUE`, look up the originating JS value in
+ * the registry and return it. Returns `undefined` for any other handle
+ * type, a non-`BamlHandle` argument, or a key that doesn't resolve.
+ *
+ * Used by `decodeCallResult`'s `error` arm to rehydrate the original JS
+ * exception when a BAML-thrown `baml.errors.HostCallable` propagates back
+ * to the same Node process that originated it.
+ */
+export declare function tryRehydrateHostValueByKey(handle: unknown): unknown;
+//# sourceMappingURL=host_value_registry.d.ts.map

package/dist/host_value_registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host_value_registry.d.ts","sourceRoot":"","sources":["../typescript_src/host_value_registry.ts"],"names":[],"mappings":"AAqCA,OAAO,EAAkE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AA4B7G;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAI5D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAInE"}

package/dist/host_value_registry.js

@@ -0,0 +1,141 @@
+/**
+ * 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_bridge/cffi/v1/*.proto
+ * Build:  cd baml_language/crates/bridge_nodejs && pnpm build:debug
+ */
+// host_value_registry.ts — mirrors bridge_python's `register_host_opaque`
+// + `lookup_host_value` pair.
+//
+// An arbitrary host JS value round-trips back to the *same* Node process as
+// the *same* object (identity preserved), not flattened into a metadata-only
+// wrapper. A native JS exception raised inside a user callable is the primary
+// consumer: it round-trips as the *same* `Error` object (`raised === caught`
+// identity), not a metadata-only `BamlError(HostCallable(...))` wrapper. The
+// plumbing:
+//
+//   1. The TS bridge catches the JS error inside `sendHostCallableError`
+//      (proto.ts) and calls `registerHostOpaque(err)` here.
+//   2. `registerHostOpaque` mints a globally-unique key via
+//      `native.mintHostValueKey` (drawing from the shared callable+opaque
+//      counter on the Rust side so the engine sees one keyspace), stores
+//      the JS value in the local `Map<bigint, unknown>`, returns the key.
+//   3. The bridge emits an `InboundValue.Class(name="baml.errors.HostCallable",
+//      fields=[..., _handle: Handle(HOST_VALUE_OPAQUE, key)])`. The engine
+//      interns an `Arc<HostValueArc>` per the same key.
+//   4. When BAML propagates the throw back out to the host, the outbound
+//      encoder re-emits the `_handle: Handle(HOST_VALUE_OPAQUE, key)`. The
+//      TS decoder (proto.ts) inspects a decoded `HostCallable` instance,
+//      reads `_handle.key`, calls `lookupHostValue(key)` here, and re-throws
+//      the original JS error.
+//   5. When the engine drops its last `Arc<HostValueArc>(key)`, the Rust
+//      `host_release_callback` fires the TS-installed release callback
+//      (`native.registerHostValueReleaseCallback`), which calls `_releaseHostValue`
+//      here to remove the map entry.
+//
+// Foreign runtimes (a different Node process, the Python bridge, etc.) see
+// a `_handle` whose key doesn't resolve in their local registry; the
+// decoder falls back to the metadata-bearing `BamlError(HostCallable(...))`
+// wrapper. The reserved `0` is used as a sentinel by code paths that
+// cannot register a real JS value (engine-internal synthetic faults like
+// "no JS callable for this key"); `_releaseHostValue(0n)` is a benign
+// no-op since `mintHostValueKey` never returns `0`.
+import { mintHostValueKey, registerHostValueReleaseCallback, BamlHandle } from './native.js';
+import { baml_bridge } from './proto/baml_cffi.js';
+const BamlHandleType = baml_bridge.cffi.v1.BamlHandleType;
+const hostValueMap = new Map();
+/**
+ * Convert a `HandleKey` (`{ low, high }`) to a `bigint` for use as a `Map` key.
+ * Native `HandleKey` instances split a `u64` across two `i32` low/high halves
+ * (signed, two's-complement). Recompose by treating each half as a 32-bit
+ * unsigned value via `>>> 0`, then shift+or as `bigint`.
+ *
+ * The `>>> 0` coercion matters whenever either half's MSB is set: without it,
+ * a negative `i32` would widen to a negative `bigint` and corrupt the
+ * recomposed `u64`. Examples:
+ *
+ *   - `{ low: 1, high: 0 }` →  `0x1n`               (small key, no MSB set)
+ *   - `{ low: -1, high: -1 }` → `0xFFFFFFFFFFFFFFFFn` (u64::MAX; both halves'
+ *      MSB set — `>>> 0` reinterprets `-1` as `0xFFFFFFFF` before widening)
+ *   - `{ low: 0, high: 1 }` →  `0x1_00000000n`     (2^32)
+ */
+function handleKeyToBigint(key) {
+    const low = BigInt(key.low >>> 0);
+    const high = BigInt(key.high >>> 0);
+    return (high << 32n) | low;
+}
+/**
+ * Register an arbitrary host JS value and return its native `HandleKey` for
+ * the `_handle: Handle(HOST_VALUE_OPAQUE, key)` slot of a
+ * `baml.errors.HostCallable` Instance (or any future opaque-value carrier).
+ * Mints a fresh key via the Rust side's shared counter (guaranteed non-zero —
+ * Rust `next_key` skips `0`); stores the value keyed by the same key
+ * (recomposed as a `bigint` for `Map`-key equality).
+ *
+ * Returns the native `HandleKey` directly so it can flow into the
+ * protobufjs encoder without an intermediate `bigint→Long` conversion
+ * (protobufjs reads `uint64` fields from a `{low, high}` shape, which
+ * the native `HandleKey` already provides; a bare `bigint` does not
+ * encode correctly through the `IInboundValue.handle.key` field).
+ */
+export function registerHostOpaque(value) {
+    const key = mintHostValueKey();
+    hostValueMap.set(handleKeyToBigint(key), value);
+    return key;
+}
+/**
+ * Look up a host-registered JS value by key. Returns `undefined` when:
+ * - the key is the reserved sentinel `0n` (no real value was registered);
+ * - the engine has already released the entry (last `HostValueArc` clone
+ *   dropped → Rust `host_release_callback` fired → `_releaseHostValue`
+ *   removed the entry);
+ * - the key was minted by a different Node process (cross-runtime handle).
+ *
+ * Callers should fall back to a metadata-built exception in those cases.
+ *
+ * GC/decode race: a release notification and a rehydrating decode can be
+ * scheduled on the libuv loop concurrently in principle, but in practice
+ * the same `HostValueArc` cannot drop *while* the engine is actively
+ * emitting an outbound proto referencing its key — the outbound encode
+ * holds a strong handle through proto serialization, and the release tsfn
+ * isn't fired until that strong handle drops. By the time the TS decoder
+ * runs `tryRehydrateHostValueByKey`, the only way the map entry is gone is if
+ * a *prior* outbound completed and the engine has since dropped its last
+ * Arc; in that case the user has already observed the original throw at
+ * least once, so a second lookup-miss → metadata-fallback is acceptable.
+ */
+export function lookupHostValue(key) {
+    return hostValueMap.get(key);
+}
+/**
+ * Convenience for the outbound decoder: if `handle` is a `BamlHandle`
+ * tagged `HOST_VALUE_OPAQUE`, look up the originating JS value in
+ * the registry and return it. Returns `undefined` for any other handle
+ * type, a non-`BamlHandle` argument, or a key that doesn't resolve.
+ *
+ * Used by `decodeCallResult`'s `error` arm to rehydrate the original JS
+ * exception when a BAML-thrown `baml.errors.HostCallable` propagates back
+ * to the same Node process that originated it.
+ */
+export function tryRehydrateHostValueByKey(handle) {
+    if (!(handle instanceof BamlHandle))
+        return undefined;
+    if (handle.handleType !== BamlHandleType.HOST_VALUE_OPAQUE)
+        return undefined;
+    return lookupHostValue(handleKeyToBigint(handle.key));
+}
+/**
+ * Internal: remove the map entry for `key`. Wired at module init as the
+ * Rust-side release callback. Idempotent and absent-key-safe so the same
+ * callback can be invoked for *every* `HostValueArc` release (including
+ * callable keys, which never have a TS-side host-value entry).
+ */
+function _releaseHostValue(key) {
+    hostValueMap.delete(handleKeyToBigint(key));
+}
+// Install the Rust-side release callback exactly once at module load. The
+// napi function is itself first-call-wins on the Rust side, so reloads
+// (e.g. test harnesses) are harmless.
+registerHostValueReleaseCallback(_releaseHostValue);
+//# sourceMappingURL=host_value_registry.js.map

package/dist/host_value_registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host_value_registry.js","sourceRoot":"","sources":["../typescript_src/host_value_registry.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,8BAA8B;AAC9B,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,8EAA8E;AAC9E,6EAA6E;AAC7E,6EAA6E;AAC7E,YAAY;AACZ,EAAE;AACF,yEAAyE;AACzE,4DAA4D;AAC5D,4DAA4D;AAC5D,0EAA0E;AAC1E,yEAAyE;AACzE,0EAA0E;AAC1E,gFAAgF;AAChF,2EAA2E;AAC3E,wDAAwD;AACxD,yEAAyE;AACzE,2EAA2E;AAC3E,yEAAyE;AACzE,6EAA6E;AAC7E,8BAA8B;AAC9B,yEAAyE;AACzE,uEAAuE;AACvE,oFAAoF;AACpF,qCAAqC;AACrC,EAAE;AACF,2EAA2E;AAC3E,qEAAqE;AACrE,4EAA4E;AAC5E,qEAAqE;AACrE,yEAAyE;AACzE,sEAAsE;AACtE,oDAAoD;AAEpD,OAAO,EAAE,gBAAgB,EAAE,gCAAgC,EAAE,UAAU,EAAkB,MAAM,aAAa,CAAC;AAC7G,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,cAAc,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC;AAE1D,MAAM,YAAY,GAAG,IAAI,GAAG,EAAmB,CAAC;AAEhD;;;;;;;;;;;;;;GAcG;AACH,SAAS,iBAAiB,CAAC,GAAc;IACrC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;IACpC,OAAO,CAAC,IAAI,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC;AAC/B,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC7C,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAC;IAC/B,YAAY,CAAC,GAAG,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IAChD,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACvC,OAAO,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAe;IACtD,IAAI,CAAC,CAAC,MAAM,YAAY,UAAU,CAAC;QAAE,OAAO,SAAS,CAAC;IACtD,IAAI,MAAM,CAAC,UAAU,KAAK,cAAc,CAAC,iBAAiB;QAAE,OAAO,SAAS,CAAC;IAC7E,OAAO,eAAe,CAAC,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,GAAc;IACrC,YAAY,CAAC,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,0EAA0E;AAC1E,uEAAuE;AACvE,sCAAsC;AACtC,gCAAgC,CAAC,iBAAiB,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 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_bridge/cffi/v1/*.proto
+ * Build:  cd baml_language/crates/bridge_nodejs && pnpm build:debug
+ */
+import { BamlRuntime, BamlCallContext, HostSpanManager, Collector as NativeCollector, FunctionLog as NativeFunctionLog, Timing, Usage, LLMCall } from './native.js';
+export { BamlRuntime, BamlCallContext, BamlHandle, HostSpanManager, getRuntime, getVersion, flushEvents, } from './native.js';
+export { Timing, Usage, LLMCall } from './native.js';
+export { _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';
+export type { GenericParams } from './define_function.js';
+export { Never, lowerTypeToWireTy } from './wire_ty.js';
+export type { BamlType, BamlPrimitiveToken, BamlClassCtor } from './wire_ty.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 function newFunctionCall(): bigint;
+export declare function cancelFunctionCall(callId: bigint): boolean;
+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[], callCtx?: BamlCallContext): FunctionResult;
+export declare function callFunction(rt: BamlRuntime, functionName: string, kwargs: Record<string, unknown>, ctx?: HostSpanManager, collectors?: Collector[], callCtx?: BamlCallContext): 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,162 @@
+/**
+ * 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_bridge/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, cancelFunctionCall as nativeCancelFunctionCall, newFunctionCall as nativeNewFunctionCall, } from './native.js';
+import { encodeCallArgs, decodeCallResult } from './proto.js';
+import { installFlushOnExit } from './exit_hook.js';
+import { wrapNativeError } from './errors.js';
+export { BamlRuntime, BamlCallContext, BamlHandle, HostSpanManager, getRuntime, getVersion, flushEvents, } from './native.js';
+export { Timing, Usage } from './native.js';
+export { _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';
+// Generic-type spelling for `$types` bindings on generic classes / calls.
+export { Never, lowerTypeToWireTy } from './wire_ty.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));
+}
+export { BamlError, BamlInvalidArgumentError, BamlClientError, BamlCancelledError, BamlPanic, wrapNativeError, } from './errors.js';
+export function newFunctionCall() {
+    return BigInt(nativeNewFunctionCall());
+}
+export function cancelFunctionCall(callId) {
+    return nativeCancelFunctionCall(callId.toString());
+}
+function attachCallContext(ctx, callId) {
+    ctx?._attachCallId(callId.toString());
+    return {
+        detach() {
+            ctx?._detachCallId(callId.toString());
+        },
+    };
+}
+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, callCtx) {
+    // 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 callId = newFunctionCall();
+    const argsProto = encodeCallArgs(kwargs, { syncMode: true, callId });
+    const callCtxBinding = attachCallContext(callCtx, callId);
+    const nativeCollectors = collectors?.map(c => c._native()) ?? null;
+    // Only the napi call gets `wrapNativeError`'d — its `napi::Error`
+    // messages need parsing into typed `Baml*Error` subclasses. The
+    // decoder's throws (`BamlError`/`BamlPanic`, *or* a re-raised
+    // original JS exception from the host-callable rehydration path)
+    // already carry the right type and must propagate by identity.
+    let resultBytes;
+    try {
+        resultBytes = rt.callFunctionSync(functionName, argsProto, ctx ?? null, nativeCollectors);
+    }
+    catch (err) {
+        throw wrapNativeError(err);
+    }
+    finally {
+        callCtxBinding.detach();
+    }
+    return new FunctionResult(decodeCallResult(resultBytes));
+}
+export async function callFunction(rt, functionName, kwargs, ctx, collectors, callCtx) {
+    const callId = newFunctionCall();
+    const argsProto = encodeCallArgs(kwargs, { callId });
+    const callCtxBinding = attachCallContext(callCtx, callId);
+    const nativeCollectors = collectors?.map(c => c._native()) ?? null;
+    // Only the napi call gets `wrapNativeError`'d — its `napi::Error`
+    // messages need parsing into typed `Baml*Error` subclasses. The
+    // decoder's throws (`BamlError`/`BamlPanic`, *or* a re-raised
+    // original JS exception from the host-callable rehydration path)
+    // already carry the right type and must propagate by identity.
+    let resultBytes;
+    try {
+        resultBytes = await rt.callFunction(functionName, argsProto, ctx ?? null, nativeCollectors);
+    }
+    catch (err) {
+        throw wrapNativeError(err);
+    }
+    finally {
+        callCtxBinding.detach();
+    }
+    return new FunctionResult(decodeCallResult(resultBytes));
+}
+// 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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"}