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

package/dist/ctx_manager.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 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 { HostSpanManager } from './native.js';
+export declare class CtxManager {
+    private rt;
+    private ctx;
+    constructor(rt: unknown);
+    get(): HostSpanManager;
+    allowReset(): boolean;
+    reset(): void;
+    cloneContext(): HostSpanManager;
+    upsertTags(tags: Record<string, string>): void;
+    traceFn<T>(name: string, fn: (...args: unknown[]) => T): (...args: unknown[]) => T;
+    traceFnAsync<T>(name: string, fn: (...args: unknown[]) => Promise<T>): (...args: unknown[]) => Promise<T>;
+    flush(): void;
+}
+//# sourceMappingURL=ctx_manager.d.ts.map

package/dist/ctx_manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ctx_manager.d.ts","sourceRoot":"","sources":["../typescript_src/ctx_manager.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAe,MAAM,aAAa,CAAC;AAG3D,qBAAa,UAAU;IACnB,OAAO,CAAC,EAAE,CAAU;IACpB,OAAO,CAAC,GAAG,CAAqC;gBAEpC,EAAE,EAAE,OAAO;IAavB,GAAG,IAAI,eAAe;IAStB,UAAU,IAAI,OAAO;IAMrB,KAAK,IAAI,IAAI;IAIb,YAAY,IAAI,eAAe;IAK/B,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAI9C,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC;IAkBlF,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC;IAkBzG,KAAK,IAAI,IAAI;CAGhB"}

package/dist/ctx_manager.js

@@ -0,0 +1,91 @@
+/**
+ * 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
+ */
+// ctx_manager.ts — mirrors bridge_python/python_src/baml_py/ctx_manager.py
+// Uses AsyncLocalStorage for async context isolation (Node.js built-in).
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { HostSpanManager, flushEvents } from './native.js';
+import { installFlushOnExit } from './exit_hook.js';
+export class CtxManager {
+    rt;
+    ctx;
+    constructor(rt) {
+        this.rt = rt;
+        this.ctx = new AsyncLocalStorage();
+        // FIXME: Eagerly creates HostSpanManager before the runtime may be fully initialized.
+        // Legacy engine/ was also eager (rt.createContextManager() in constructor).
+        // bridge_python lazily creates HostSpanManager per-thread on first access.
+        // Leaving as-is: get() and reset() already create fresh managers, and the legacy
+        // engine/ had the same eager pattern without reported issues.
+        this.ctx.enterWith(new HostSpanManager());
+        installFlushOnExit();
+    }
+    get() {
+        let mgr = this.ctx.getStore();
+        if (!mgr) {
+            mgr = new HostSpanManager();
+            this.ctx.enterWith(mgr);
+        }
+        return mgr;
+    }
+    allowReset() {
+        const mgr = this.ctx.getStore();
+        if (!mgr)
+            return true;
+        return mgr.contextDepth() === 0;
+    }
+    reset() {
+        this.ctx.enterWith(new HostSpanManager());
+    }
+    cloneContext() {
+        const mgr = this.get();
+        return mgr.deepClone();
+    }
+    upsertTags(tags) {
+        this.get().upsertTags(tags);
+    }
+    traceFn(name, fn) {
+        const self = this;
+        return function (...args) {
+            const mgr = self.cloneContext();
+            const argsObj = {};
+            args.forEach((arg, i) => { argsObj[`arg${i}`] = arg; });
+            mgr.enter(name, argsObj);
+            try {
+                const result = self.ctx.run(mgr, () => fn.apply(this, args));
+                mgr.exitOk();
+                return result;
+            }
+            catch (e) {
+                mgr.exitError(String(e));
+                throw e;
+            }
+        };
+    }
+    traceFnAsync(name, fn) {
+        const self = this;
+        return async function (...args) {
+            const mgr = self.cloneContext();
+            const argsObj = {};
+            args.forEach((arg, i) => { argsObj[`arg${i}`] = arg; });
+            mgr.enter(name, argsObj);
+            try {
+                const result = await self.ctx.run(mgr, () => fn.apply(this, args));
+                mgr.exitOk();
+                return result;
+            }
+            catch (e) {
+                mgr.exitError(String(e));
+                throw e;
+            }
+        };
+    }
+    flush() {
+        flushEvents();
+    }
+}
+//# sourceMappingURL=ctx_manager.js.map

package/dist/ctx_manager.js.map

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

package/dist/define_function.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 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
+ */
+export type Mode = 'sync' | 'async';
+/** Sentinel for "argument not supplied" so optional kwargs can be skipped. */
+export declare const UNSET: unique symbol;
+/**
+ * Generic-binding contract for a callable. `typeParams` are the callee's OWN
+ * `<...>` param names (bound by the caller's `$types` option); `classTypeParams`
+ * are the enclosing generic class's params (bound from the `self` receiver's
+ * `$types` field). Mirrors `define_function`'s `type_params` /
+ * `class_type_params` kwargs in the Python SDK. Omitted/empty ⇒ non-generic.
+ */
+export interface GenericParams {
+    typeParams?: readonly string[];
+    classTypeParams?: readonly string[];
+}
+/**
+ * Factory for a free function or static method binding. Returns a callable
+ * that maps positional args to kwargs, encodes, calls the runtime, and decodes.
+ * `sync` returns the decoded value; `async` returns a `Promise` of it.
+ */
+export declare function defineFunction(bamlFqn: string, mode: Mode, requiredParamNames: readonly string[], optionalParamNames?: readonly string[] | undefined, generics?: GenericParams | undefined): (...args: unknown[]) => unknown;
+/**
+ * Receiver-binding factory for instance methods. `paramNames[0]` is always
+ * `"self"`. Codegen emits the binding as a class-field initializer
+ * `m = defineInstanceFunction(...).bind(this) as () => R;`, so `.bind(self)`
+ * captures the instance at construction time; the synthetic `self` param never
+ * appears in the surface type.
+ */
+export declare function defineInstanceFunction(bamlFqn: string, mode: Mode, requiredParamNames: readonly string[], optionalParamNames?: readonly string[] | undefined, generics?: GenericParams | undefined): {
+    bind(self: unknown): (...args: unknown[]) => unknown;
+};
+//# sourceMappingURL=define_function.d.ts.map

package/dist/define_function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define_function.d.ts","sourceRoot":"","sources":["../typescript_src/define_function.ts"],"names":[],"mappings":"AAsBA,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpC,8EAA8E;AAC9E,eAAO,MAAM,KAAK,EAAE,OAAO,MAA6B,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC1B,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAoLD;;;;GAIG;AACH,wBAAgB,cAAc,CAC1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,IAAI,EACV,kBAAkB,EAAE,SAAS,MAAM,EAAE,EACrC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAClD,QAAQ,CAAC,EAAE,aAAa,GAAG,SAAS,GACrC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CA8CjC;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAClC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,IAAI,EACV,kBAAkB,EAAE,SAAS,MAAM,EAAE,EACrC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAClD,QAAQ,CAAC,EAAE,aAAa,GAAG,SAAS,GACrC;IAAE,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAA;CAAE,CA2D1D"}

package/dist/define_function.js

@@ -0,0 +1,281 @@
+/**
+ * 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
+ */
+// define_function.ts — runtime factories for BAML callables, the Node analog
+// of `define_function` in sdks/python/src/baml_bridge/__init__.py.
+//
+// Generated SDK code emits, per BAML function:
+//   export const f = defineFunction("user.ns.f", "sync", ["a"]) as (a: A) => R;
+//   export const f_async = defineFunction("user.ns.f", "async", ["a"]) as (a: A) => Promise<R>;
+// and per instance method (inside the class body):
+//   m = defineInstanceFunction("user.ns.C.m", "sync", ["self"]).bind(this) as () => R;
+//
+// The factory captures (fqn, mode, requiredNames, optionalNames) by closure;
+// the returned callable zips positional args against requiredNames into kwargs,
+// encodes it, calls the runtime, and decodes the result.
+import { getRuntime, newFunctionCall as nativeNewFunctionCall, } from './native.js';
+import { encodeCallArgs, decodeCallResult } from './proto.js';
+import { lowerTypeToWireTy } from './wire_ty.js';
+/** Sentinel for "argument not supplied" so optional kwargs can be skipped. */
+export const UNSET = Symbol('baml.UNSET');
+/**
+ * Resolve the caller's `$types` option onto the callee's own generic params, in
+ * declaration order. Mirrors Python's `_resolve_types_kwarg`: `$types` is an
+ * object keyed by param name and is required iff the callee declares its own
+ * generic params; it must bind exactly those params (no missing, no extras).
+ */
+function resolveTypesOption(typesOpt, typeParams) {
+    if (typeParams.length === 0) {
+        if (typesOpt !== undefined && typesOpt !== null) {
+            throw new TypeError('$types is not accepted here: this function/method declares no generic type ' +
+                'parameters of its own');
+        }
+        return [];
+    }
+    const example = `{ ${JSON.stringify(typeParams[0])}: 'int' }`;
+    if (typesOpt === undefined || typesOpt === null) {
+        throw new TypeError(`$types is required for this generic call: bind every type parameter in ` +
+            `${JSON.stringify(typeParams)} with an object, e.g. $types: ${example}`);
+    }
+    if (typeof typesOpt !== 'object' || Array.isArray(typesOpt)) {
+        throw new TypeError(`$types must be an object mapping type-parameter names to types (e.g. ` +
+            `$types: ${example}); got ${typeof typesOpt}`);
+    }
+    const obj = typesOpt;
+    const missing = typeParams.filter((n) => !(n in obj));
+    if (missing.length) {
+        throw new TypeError(`$types is missing binding(s) for ${JSON.stringify(missing)}: every type parameter ` +
+            `in ${JSON.stringify(typeParams)} must be bound.`);
+    }
+    const extra = Object.keys(obj).filter((k) => !typeParams.includes(k));
+    if (extra.length) {
+        throw new TypeError(`$types has unknown type parameter(s) ${JSON.stringify(extra)}; expected exactly ` +
+            `${JSON.stringify(typeParams)}.`);
+    }
+    return typeParams.map((n) => obj[n]);
+}
+/** The `$types` field of a generic receiver instance (its class TypeVar
+ * bindings), or `undefined` when the receiver carries none. The TS analog of
+ * Python's `pydantic_instance_type_args(self)`. */
+function receiverTypes(self) {
+    if (self != null && typeof self === 'object') {
+        const t = self.$types;
+        if (t != null && typeof t === 'object') {
+            return t;
+        }
+    }
+    return undefined;
+}
+/**
+ * Build the named, order-preserving wire `type_args` for a generic call. Mirrors
+ * Python's `_build_type_args`: enclosing class params (recovered from the `self`
+ * receiver's `$types`) come first, then the callee's own params (`$types`
+ * option) — De Bruijn order. Class params are seeded only when the receiver
+ * actually carries them, so a non-generic receiver keeps the engine's
+ * recover-from-receiver behavior. Returns `[]` when the call binds nothing.
+ */
+function buildTypeArgs(self, typesOpt, typeParams, classTypeParams) {
+    const wire = [];
+    const classTypes = classTypeParams.length ? receiverTypes(self) : undefined;
+    if (classTypes) {
+        for (const name of classTypeParams) {
+            wire.push([name, lowerTypeToWireTy(classTypes[name])]);
+        }
+    }
+    const resolved = resolveTypesOption(typesOpt, typeParams);
+    if (typeParams.length > 0) {
+        if (classTypeParams.length && !classTypes) {
+            // The method's own params sit after the class prefix in De Bruijn
+            // order; without recovered class args we can't position them.
+            throw new TypeError('$types on a generic method requires a generic receiver carrying its class type ' +
+                'args (a `$types` field on the instance)');
+        }
+        typeParams.forEach((name, i) => {
+            wire.push([name, lowerTypeToWireTy(resolved[i])]);
+        });
+    }
+    return wire;
+}
+function newFunctionCall() {
+    return BigInt(nativeNewFunctionCall());
+}
+function attachCallContext(ctx, callId) {
+    ctx?._attachCallId(callId.toString());
+    return {
+        detach() {
+            ctx?._detachCallId(callId.toString());
+        },
+    };
+}
+function buildArgs(args, requiredParamNames, optionalParamNames) {
+    const positionalLimit = requiredParamNames.length;
+    if (args.length > positionalLimit + 1) {
+        throw new TypeError(`got ${args.length} positional arguments but only ${positionalLimit} positional ` +
+            `parameter names (${JSON.stringify(requiredParamNames)})`);
+    }
+    const built = {};
+    for (let i = 0; i < args.length && i < positionalLimit; i++) {
+        if (args[i] === UNSET)
+            continue;
+        built[requiredParamNames[i]] = args[i];
+    }
+    let ctx;
+    let types;
+    if (args.length > positionalLimit) {
+        const opts = args[positionalLimit];
+        if (opts === undefined || opts === UNSET) {
+            return { kwargs: built };
+        }
+        if (opts === null || Array.isArray(opts) || typeof opts !== 'object') {
+            throw new TypeError('optional arguments must be passed as an object');
+        }
+        const optionNames = new Set(optionalParamNames);
+        for (const [key, value] of Object.entries(opts)) {
+            if (key === '$ctx') {
+                if (value !== undefined && value !== UNSET) {
+                    ctx = value;
+                }
+                continue;
+            }
+            if (key === '$types') {
+                // Generic-call TypeVar bindings — captured here and lowered to
+                // wire `type_args` by the factory, never sent as a kwarg value.
+                if (value !== undefined && value !== UNSET) {
+                    types = value;
+                }
+                continue;
+            }
+            if (!optionNames.has(key)) {
+                throw new TypeError(`unknown optional argument ${JSON.stringify(key)}`);
+            }
+            if (value === undefined || value === UNSET)
+                continue;
+            built[key] = value;
+        }
+    }
+    return { kwargs: built, ctx, types };
+}
+/**
+ * Factory for a free function or static method binding. Returns a callable
+ * that maps positional args to kwargs, encodes, calls the runtime, and decodes.
+ * `sync` returns the decoded value; `async` returns a `Promise` of it.
+ */
+export function defineFunction(bamlFqn, mode, requiredParamNames, optionalParamNames, generics) {
+    const requiredNames = [...requiredParamNames];
+    const optionNames = [...(optionalParamNames ?? [])];
+    // A free function / static method binds only its OWN generic params (a
+    // generic receiver is never in play here), so `classTypeParams` is unused.
+    const typeParams = generics?.typeParams ?? [];
+    const isGeneric = typeParams.length > 0;
+    // Eagerly reject `$types` on a non-generic call, matching the generic path's
+    // strict binding contract (mirrors Python's `is_generic` gate).
+    const typeArgsFor = (built) => isGeneric ? buildTypeArgs(undefined, built.types, typeParams, []) : [];
+    if (mode === 'sync') {
+        return (...args) => {
+            const built = buildArgs(args, requiredNames, optionNames);
+            const typeArgs = typeArgsFor(built);
+            const rt = getRuntime();
+            const callId = newFunctionCall();
+            const argsProto = encodeCallArgs(built.kwargs, { syncMode: true, callId, typeArgs });
+            const callCtxBinding = attachCallContext(built.ctx, callId);
+            let resultBytes;
+            try {
+                resultBytes = rt.callFunctionSync(bamlFqn, argsProto, null, null);
+            }
+            finally {
+                callCtxBinding.detach();
+            }
+            return decodeCallResult(resultBytes);
+        };
+    }
+    if (mode === 'async') {
+        return async (...args) => {
+            const built = buildArgs(args, requiredNames, optionNames);
+            const typeArgs = typeArgsFor(built);
+            const rt = getRuntime();
+            const callId = newFunctionCall();
+            const argsProto = encodeCallArgs(built.kwargs, { callId, typeArgs });
+            const callCtxBinding = attachCallContext(built.ctx, callId);
+            let resultBytes;
+            try {
+                resultBytes = await rt.callFunction(bamlFqn, argsProto, null, null);
+            }
+            finally {
+                callCtxBinding.detach();
+            }
+            return decodeCallResult(resultBytes);
+        };
+    }
+    throw new Error(`mode must be 'sync' or 'async', got ${JSON.stringify(mode)}`);
+}
+/**
+ * Receiver-binding factory for instance methods. `paramNames[0]` is always
+ * `"self"`. Codegen emits the binding as a class-field initializer
+ * `m = defineInstanceFunction(...).bind(this) as () => R;`, so `.bind(self)`
+ * captures the instance at construction time; the synthetic `self` param never
+ * appears in the surface type.
+ */
+export function defineInstanceFunction(bamlFqn, mode, requiredParamNames, optionalParamNames, generics) {
+    const requiredNames = [...requiredParamNames];
+    const optionNames = [...(optionalParamNames ?? [])];
+    const selfName = requiredNames[0] ?? 'self';
+    const rest = requiredNames.slice(1);
+    // An instance method binds its own `<...>` params (caller's `$types`) AND
+    // the enclosing class's params, recovered from the `self` receiver's
+    // `$types` field. Mirrors Python's `class_type_params` for instance methods.
+    const typeParams = generics?.typeParams ?? [];
+    const classTypeParams = generics?.classTypeParams ?? [];
+    const isGeneric = typeParams.length > 0 || classTypeParams.length > 0;
+    const makeArgs = (self, args) => {
+        const built = buildArgs(args, rest, optionNames);
+        built.kwargs[selfName] = self;
+        return built;
+    };
+    return {
+        bind(self) {
+            const typeArgsFor = (built) => isGeneric ? buildTypeArgs(self, built.types, typeParams, classTypeParams) : [];
+            if (mode === 'sync') {
+                return (...args) => {
+                    const built = makeArgs(self, args);
+                    const typeArgs = typeArgsFor(built);
+                    const rt = getRuntime();
+                    const callId = newFunctionCall();
+                    const argsProto = encodeCallArgs(built.kwargs, { syncMode: true, callId, typeArgs });
+                    const callCtxBinding = attachCallContext(built.ctx, callId);
+                    let resultBytes;
+                    try {
+                        resultBytes = rt.callFunctionSync(bamlFqn, argsProto, null, null);
+                    }
+                    finally {
+                        callCtxBinding.detach();
+                    }
+                    return decodeCallResult(resultBytes);
+                };
+            }
+            if (mode === 'async') {
+                return async (...args) => {
+                    const built = makeArgs(self, args);
+                    const typeArgs = typeArgsFor(built);
+                    const rt = getRuntime();
+                    const callId = newFunctionCall();
+                    const argsProto = encodeCallArgs(built.kwargs, { callId, typeArgs });
+                    const callCtxBinding = attachCallContext(built.ctx, callId);
+                    let resultBytes;
+                    try {
+                        resultBytes = await rt.callFunction(bamlFqn, argsProto, null, null);
+                    }
+                    finally {
+                        callCtxBinding.detach();
+                    }
+                    return decodeCallResult(resultBytes);
+                };
+            }
+            throw new Error(`mode must be 'sync' or 'async', got ${JSON.stringify(mode)}`);
+        },
+    };
+}
+//# sourceMappingURL=define_function.js.map

package/dist/define_function.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Structured detail carried by a thrown `BamlError` / `BamlPanic`, mirroring
+ * `bridge_python`'s `BamlError(value, baml_trace=..., class_name=...)`.
+ *
+ * - `value`: the fully decoded thrown BAML value (a generated class instance
+ *   when the FQN is mapped, else a plain object / primitive).
+ * - `bamlTrace`: the pre-rendered `File "...", line N, in fn` frame strings
+ *   from the BAML stack.
+ * - `className`: the thrown value's BAML FQN when known (e.g.
+ *   `baml.json.JsonParseError`).
+ */
+export interface BamlErrorDetail {
+    value?: unknown;
+    bamlTrace?: string[];
+    className?: string;
+}
+export declare class BamlError extends Error {
+    /** The decoded thrown BAML value, or `undefined` for SDK-internal errors. */
+    readonly value: unknown;
+    /** Pre-rendered BAML stack frames; empty for SDK-internal errors. */
+    readonly bamlTrace: string[];
+    /** The thrown value's BAML FQN, when known. */
+    readonly className: string | undefined;
+    constructor(message: string, detail?: BamlErrorDetail);
+}
+export declare class BamlInvalidArgumentError extends BamlError {
+    constructor(message: string);
+}
+export declare class BamlClientError extends BamlError {
+    constructor(message: string);
+}
+export declare class BamlCancelledError extends BamlError {
+    constructor(message: string);
+}
+export declare class BamlAbortError extends Error {
+    readonly reason: unknown;
+    constructor(message: string, options?: {
+        reason?: unknown;
+    });
+}
+/**
+ * Raised for SDK-setup failures and BAML-runtime panics — the Node analog of
+ * `bridge_python`'s `BamlPanic`. The in-call panic path (`decodeCallResult`'s
+ * `panic` arm) and the `getRuntime` not-initialized path both surface this,
+ * except clean process-exit panics, which exit after flushing telemetry.
+ */
+export declare class BamlPanic extends BamlError {
+    constructor(message: string, detail?: BamlErrorDetail);
+}
+export declare function wrapNativeError(err: unknown): BamlError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../typescript_src/errors.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,SAAU,SAAQ,KAAK;IAChC,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7B,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE3B,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe;CAOxD;AAED,qBAAa,wBAAyB,SAAQ,SAAS;gBACvC,OAAO,EAAE,MAAM;CAI9B;AAED,qBAAa,eAAgB,SAAQ,SAAS;gBAC9B,OAAO,EAAE,MAAM;CAI9B;AAED,qBAAa,kBAAmB,SAAQ,SAAS;gBACjC,OAAO,EAAE,MAAM;CAI9B;AAED,qBAAa,cAAe,SAAQ,KAAK;IACrC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;gBAEb,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE;CAK9D;AAED;;;;;GAKG;AACH,qBAAa,SAAU,SAAQ,SAAS;gBACxB,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe;CAIxD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,CAGvD"}

package/dist/errors.js

@@ -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
+ */
+// errors.ts — mirrors bridge_python/python_src/baml_py/errors.py
+export class BamlError extends Error {
+    /** The decoded thrown BAML value, or `undefined` for SDK-internal errors. */
+    value;
+    /** Pre-rendered BAML stack frames; empty for SDK-internal errors. */
+    bamlTrace;
+    /** The thrown value's BAML FQN, when known. */
+    className;
+    constructor(message, detail) {
+        super(message);
+        this.name = 'BamlError';
+        this.value = detail?.value;
+        this.bamlTrace = detail?.bamlTrace ? [...detail.bamlTrace] : [];
+        this.className = detail?.className;
+    }
+}
+export class BamlInvalidArgumentError extends BamlError {
+    constructor(message) {
+        super(message);
+        this.name = 'BamlInvalidArgumentError';
+    }
+}
+export class BamlClientError extends BamlError {
+    constructor(message) {
+        super(message);
+        this.name = 'BamlClientError';
+    }
+}
+export class BamlCancelledError extends BamlError {
+    constructor(message) {
+        super(message);
+        this.name = 'BamlCancelledError';
+    }
+}
+export class BamlAbortError extends Error {
+    reason;
+    constructor(message, options) {
+        super(message);
+        this.name = 'AbortError';
+        this.reason = options?.reason;
+    }
+}
+/**
+ * Raised for SDK-setup failures and BAML-runtime panics — the Node analog of
+ * `bridge_python`'s `BamlPanic`. The in-call panic path (`decodeCallResult`'s
+ * `panic` arm) and the `getRuntime` not-initialized path both surface this,
+ * except clean process-exit panics, which exit after flushing telemetry.
+ */
+export class BamlPanic extends BamlError {
+    constructor(message, detail) {
+        super(message, detail);
+        this.name = 'BamlPanic';
+    }
+}
+export function wrapNativeError(err) {
+    if (!(err instanceof Error))
+        return new BamlError(String(err));
+    return new BamlError(err.message);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../typescript_src/errors.ts"],"names":[],"mappings":"AAAA,iEAAiE;AAmBjE,MAAM,OAAO,SAAU,SAAQ,KAAK;IAChC,6EAA6E;IACpE,KAAK,CAAU;IACxB,qEAAqE;IAC5D,SAAS,CAAW;IAC7B,+CAA+C;IACtC,SAAS,CAAqB;IAEvC,YAAY,OAAe,EAAE,MAAwB;QACjD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,MAAM,EAAE,KAAK,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,IAAI,CAAC,SAAS,GAAG,MAAM,EAAE,SAAS,CAAC;IACvC,CAAC;CACJ;AAED,MAAM,OAAO,wBAAyB,SAAQ,SAAS;IACnD,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IAC3C,CAAC;CACJ;AAED,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC1C,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAClC,CAAC;CACJ;AAED,MAAM,OAAO,kBAAmB,SAAQ,SAAS;IAC7C,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACrC,CAAC;CACJ;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC5B,MAAM,CAAU;IAEzB,YAAY,OAAe,EAAE,OAA8B;QACvD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;IAClC,CAAC;CACJ;AAED;;;;;GAKG;AACH,MAAM,OAAO,SAAU,SAAQ,SAAS;IACpC,YAAY,OAAe,EAAE,MAAwB;QACjD,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC5B,CAAC;CACJ;AAED,MAAM,UAAU,eAAe,CAAC,GAAY;IACxC,IAAI,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC;QAAE,OAAO,IAAI,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,OAAO,IAAI,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC"}

package/dist/exit_hook.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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
+ */
+export declare function installFlushOnExit(): void;
+//# sourceMappingURL=exit_hook.d.ts.map

package/dist/exit_hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit_hook.d.ts","sourceRoot":"","sources":["../typescript_src/exit_hook.ts"],"names":[],"mappings":"AASA,wBAAgB,kBAAkB,IAAI,IAAI,CAUzC"}

package/dist/exit_hook.js

@@ -0,0 +1,27 @@
+/**
+ * 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
+ */
+// exit_hook.ts — single-registration helper for flushEvents on process exit.
+// Both index.ts and the CtxManager constructor used to call
+// process.once('exit', …) independently; consolidate to one registration so
+// `process.listenerCount('exit')` increases by exactly one per process.
+import { flushEvents } from './native.js';
+let installed = false;
+export function installFlushOnExit() {
+    if (installed)
+        return;
+    installed = true;
+    process.once('exit', () => {
+        try {
+            flushEvents();
+        }
+        catch {
+            /* ignore */
+        }
+    });
+}
+//# sourceMappingURL=exit_hook.js.map

package/dist/exit_hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit_hook.js","sourceRoot":"","sources":["../typescript_src/exit_hook.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,4DAA4D;AAC5D,4EAA4E;AAC5E,wEAAwE;AAExE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,IAAI,SAAS,GAAG,KAAK,CAAC;AAEtB,MAAM,UAAU,kBAAkB;IAC9B,IAAI,SAAS;QAAE,OAAO;IACtB,SAAS,GAAG,IAAI,CAAC;IACjB,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;QACtB,IAAI,CAAC;YACD,WAAW,EAAE,CAAC;QAClB,CAAC;QAAC,MAAM,CAAC;YACL,YAAY;QAChB,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}