@boundaryml/baml-bridge-web 0.0.0

package/dist/workerd/shared/proto.d.ts

@@ -0,0 +1,55 @@
+import { baml_bridge } from './proto/baml_cffi.js';
+/**
+ * Error thrown when a host callable (a JS `function`) is passed to the
+ * *synchronous* call path. See {@link encodeCallArgs} for why this can't work.
+ */
+export declare class HostCallableSyncError extends Error {
+    constructor(message: string);
+}
+export interface EncodeCallArgsOptions {
+    callId: bigint;
+    syncMode?: boolean;
+    /**
+     * Call-level TypeVar bindings for a generic function/method, as
+     * `[typeVarName, wireTy]` pairs in De Bruijn order (enclosing class params
+     * first, then the callee's own `<...>` params). Encoded into
+     * `CallFunctionArgs.type_args`. Mirrors Python's `encode_call_args`
+     * `type_args` argument. Omitted/empty for non-generic calls.
+     */
+    typeArgs?: Array<[string, baml_bridge.cffi.v1.IBamlTy]>;
+}
+/**
+ * Encode kwargs into `CallFunctionArgs` bytes.
+ *
+ * `syncMode` (default false) selects the sync guard: a host callable in the
+ * kwargs of a *synchronous* call rejects with {@link HostCallableSyncError}
+ * before any work, rather than registering a tsfn and then hanging.
+ *
+ * Release tradeoff: a callable that encodes successfully is registered in the
+ * host-value table and is normally released only when the engine GCs the
+ * `HostClosure` it allocated and fires the C release callback (a GC-timed
+ * release, drained by the engine after collection).
+ * Because the Node tsfn is built with `weak::<false>` it keeps a strong libuv
+ * ref, so a *leaked* registry entry can also keep the Node process from
+ * exiting — which is exactly why the encode-error rollback below matters: if a
+ * later kwarg fails, the engine never sees (and so never releases) the keys we
+ * already registered, so we release them here.
+ */
+export declare function encodeCallArgs(kwargs: Record<string, unknown>, options: EncodeCallArgsOptions): Uint8Array;
+/**
+ * Decode a bare `BamlOutboundValue` to a JS value. Used for the host-callable
+ * args path, where the engine sends a list-shaped `BamlOutboundValue` rather
+ * than the call-result `BamlOutboundResult` envelope.
+ */
+export declare function decodeOutboundValue(data: Uint8Array | Uint8Array): unknown;
+/**
+ * Decode a `BamlOutboundResult` envelope (the engine's call-result wire shape
+ * after 31c/31e). The `ok` arm returns the decoded value; the `error`/`panic`
+ * arms **throw** a `BamlError`/`BamlPanic` carrying the fully decoded thrown
+ * value (`.value`), the BAML trace (`.bamlTrace`), and the class FQN
+ * (`.className`), with a readable formatted `.message`. An `is_exit_panic`
+ * (clean `baml.sys.exit`) terminates the process via `process.exit(code)`
+ * rather than throwing.
+ */
+export declare function decodeCallResult(data: Uint8Array | Uint8Array): unknown;
+//# sourceMappingURL=proto.d.ts.map

package/dist/workerd/shared/proto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proto.d.ts","sourceRoot":"","sources":["../../typescript_src/shared/proto.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAiCnD;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI9B;AAmBD,MAAM,WAAW,qBAAqB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;CAC3D;AA+LD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,qBAAqB,GAAG,UAAU,CAuC1G;AAgOD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,CAG1E;AA4GD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,CAuDvE"}