@aztec-foundation/bb-avm-sim 0.0.1-commit.b66364b

package/README.md

@@ -0,0 +1,29 @@
+# @aztec-foundation/bb-avm-sim
+
+Generated TypeScript IPC package for the Avm service.
+
+```ts
+import { AvmService } from '@aztec-foundation/bb-avm-sim';
+
+const service = await AvmService.spawn({ transport: 'uds' });
+try {
+  const response = await service.bytes({ data: new Uint8Array([1, 2, 3]) });
+} finally {
+  await service.destroy();
+}
+```
+
+The package resolves `bb-avm-sim` from `BB_AVM_SIM_PATH`,
+an explicit `binaryPath`, or an installed/prepared arch package.
+
+## Build
+
+The package shell (package.json, tsconfig, src/index.ts, scripts/) is
+generated; build through the owning project's `./bootstrap.sh`, which
+regenerates and then runs `npm install --omit=optional && npm run build`.
+
+To prepare per-architecture binary packages:
+
+```sh
+npm run prepare_arch_packages -- linux-x64=/path/to/bb-avm-sim
+```

package/dest/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dest/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dest/bin.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+import { findAvmBinary } from './platform.js';
+const binaryPath = findAvmBinary();
+if (!binaryPath) {
+    console.error("bb-avm-sim: native binary not found. Install the matching " +
+        "'@aztec-foundation/bb-avm-sim-<platform>' package, set BB_AVM_SIM_PATH, or pass its path.");
+    process.exit(1);
+}
+const result = spawnSync(binaryPath, process.argv.slice(2), { stdio: 'inherit' });
+if (result.error) {
+    console.error(result.error.message);
+    process.exit(1);
+}
+process.exit(result.status ?? 1);

package/dest/generated/api_types.d.ts

@@ -0,0 +1,54 @@
+/** Schema version hash for compatibility checking */
+export declare const SCHEMA_HASH = "b78dac843cac6b68df35236452e452f348f5dde3a205084e9b6a79da690eb6af";
+export interface AvmSimulate {
+    inputs: Uint8Array;
+}
+export interface AvmSimulateWithHints {
+    inputs: Uint8Array;
+}
+export interface AvmSimulateResponse {
+    result: Uint8Array;
+}
+export interface AvmSimulateWithHintsResponse {
+    result: Uint8Array;
+}
+export interface AvmErrorResponse {
+    message: string;
+}
+interface MsgpackAvmSimulate {
+    inputs: Uint8Array;
+}
+interface MsgpackAvmSimulateWithHints {
+    inputs: Uint8Array;
+}
+interface MsgpackAvmSimulateResponse {
+    result: Uint8Array;
+}
+interface MsgpackAvmSimulateWithHintsResponse {
+    result: Uint8Array;
+}
+interface MsgpackAvmErrorResponse {
+    message: string;
+}
+export declare function toAvmSimulate(o: MsgpackAvmSimulate): AvmSimulate;
+export declare function toAvmSimulateWithHints(o: MsgpackAvmSimulateWithHints): AvmSimulateWithHints;
+export declare function toAvmSimulateResponse(o: MsgpackAvmSimulateResponse): AvmSimulateResponse;
+export declare function toAvmSimulateWithHintsResponse(o: MsgpackAvmSimulateWithHintsResponse): AvmSimulateWithHintsResponse;
+export declare function toAvmErrorResponse(o: MsgpackAvmErrorResponse): AvmErrorResponse;
+export declare function fromAvmSimulate(o: AvmSimulate): MsgpackAvmSimulate;
+export declare function fromAvmSimulateWithHints(o: AvmSimulateWithHints): MsgpackAvmSimulateWithHints;
+export declare function fromAvmSimulateResponse(o: AvmSimulateResponse): MsgpackAvmSimulateResponse;
+export declare function fromAvmSimulateWithHintsResponse(o: AvmSimulateWithHintsResponse): MsgpackAvmSimulateWithHintsResponse;
+export declare function fromAvmErrorResponse(o: AvmErrorResponse): MsgpackAvmErrorResponse;
+export interface AsyncApiBase {
+    simulate(command: AvmSimulate): Promise<AvmSimulateResponse>;
+    simulateWithHints(command: AvmSimulateWithHints): Promise<AvmSimulateWithHintsResponse>;
+    destroy(): Promise<void>;
+}
+export interface SyncApiBase {
+    simulate(command: AvmSimulate): AvmSimulateResponse;
+    simulateWithHints(command: AvmSimulateWithHints): AvmSimulateWithHintsResponse;
+    destroy(): void;
+}
+export {};
+//# sourceMappingURL=api_types.d.ts.map

package/dest/generated/api_types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api_types.d.ts","sourceRoot":"","sources":["../../src/generated/api_types.ts"],"names":[],"mappings":"AAEA,qDAAqD;AACrD,eAAO,MAAM,WAAW,qEAAqE,CAAC;AAsC9F,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAGD,UAAU,kBAAkB;IAC1B,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,UAAU,2BAA2B;IACnC,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,UAAU,0BAA0B;IAClC,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,UAAU,mCAAmC;IAC3C,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,UAAU,uBAAuB;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAGD,wBAAgB,aAAa,CAAC,CAAC,EAAE,kBAAkB,GAAG,WAAW,CAKhE;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,2BAA2B,GAAG,oBAAoB,CAK3F;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,0BAA0B,GAAG,mBAAmB,CAKxF;AAED,wBAAgB,8BAA8B,CAAC,CAAC,EAAE,mCAAmC,GAAG,4BAA4B,CAKnH;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,uBAAuB,GAAG,gBAAgB,CAK/E;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,WAAW,GAAG,kBAAkB,CAKlE;AAED,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,oBAAoB,GAAG,2BAA2B,CAK7F;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,mBAAmB,GAAG,0BAA0B,CAK1F;AAED,wBAAgB,gCAAgC,CAAC,CAAC,EAAE,4BAA4B,GAAG,mCAAmC,CAKrH;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,gBAAgB,GAAG,uBAAuB,CAKjF;AAGD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC7D,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;IACxF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,mBAAmB,CAAC;IACpD,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,4BAA4B,CAAC;IAC/E,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dest/generated/api_types.js

@@ -0,0 +1,123 @@
+// AUTOGENERATED FILE - DO NOT EDIT
+/** Schema version hash for compatibility checking */
+export const SCHEMA_HASH = 'b78dac843cac6b68df35236452e452f348f5dde3a205084e9b6a79da690eb6af';
+// Runtime guards for wire types that JS cannot represent natively.
+// TODO: migrate u64 fields to bigint end-to-end and drop these.
+//
+// Decode: msgpackr returns uint64/int64 wire values as bigint once they
+// exceed 32 bits; values must fit in the JS safe integer range.
+function assertU64(value, ctx) {
+    if (typeof value === "bigint") {
+        if (value < 0n || value > BigInt(Number.MAX_SAFE_INTEGER)) {
+            throw new Error(`${ctx}: u64 value ${value} is outside JS safe integer range`);
+        }
+        return Number(value);
+    }
+    if (!Number.isSafeInteger(value) || value < 0) {
+        throw new Error(`${ctx}: u64 value ${value} is outside JS safe integer range`);
+    }
+    return value;
+}
+// Encode: msgpackr encodes JS numbers above 2^32 as float64, which strict
+// u64 decoders reject; route them through bigint so the wire type stays uint.
+function toWireU64(value, ctx) {
+    const checked = assertU64(value, ctx);
+    return checked > 0xffffffff ? BigInt(checked) : checked;
+}
+function assertBin32(value, ctx) {
+    if (value.length !== 32) {
+        throw new Error(`${ctx}: expected 32 bytes, got ${value.length}`);
+    }
+    return value;
+}
+// Conversion functions (exported)
+export function toAvmSimulate(o) {
+    if (o.inputs === undefined) {
+        throw new Error("Expected inputs in AvmSimulate deserialization");
+    }
+    ;
+    return {
+        inputs: o.inputs,
+    };
+}
+export function toAvmSimulateWithHints(o) {
+    if (o.inputs === undefined) {
+        throw new Error("Expected inputs in AvmSimulateWithHints deserialization");
+    }
+    ;
+    return {
+        inputs: o.inputs,
+    };
+}
+export function toAvmSimulateResponse(o) {
+    if (o.result === undefined) {
+        throw new Error("Expected result in AvmSimulateResponse deserialization");
+    }
+    ;
+    return {
+        result: o.result,
+    };
+}
+export function toAvmSimulateWithHintsResponse(o) {
+    if (o.result === undefined) {
+        throw new Error("Expected result in AvmSimulateWithHintsResponse deserialization");
+    }
+    ;
+    return {
+        result: o.result,
+    };
+}
+export function toAvmErrorResponse(o) {
+    if (o.message === undefined) {
+        throw new Error("Expected message in AvmErrorResponse deserialization");
+    }
+    ;
+    return {
+        message: o.message,
+    };
+}
+export function fromAvmSimulate(o) {
+    if (o.inputs === undefined) {
+        throw new Error("Expected inputs in AvmSimulate serialization");
+    }
+    ;
+    return {
+        inputs: o.inputs,
+    };
+}
+export function fromAvmSimulateWithHints(o) {
+    if (o.inputs === undefined) {
+        throw new Error("Expected inputs in AvmSimulateWithHints serialization");
+    }
+    ;
+    return {
+        inputs: o.inputs,
+    };
+}
+export function fromAvmSimulateResponse(o) {
+    if (o.result === undefined) {
+        throw new Error("Expected result in AvmSimulateResponse serialization");
+    }
+    ;
+    return {
+        result: o.result,
+    };
+}
+export function fromAvmSimulateWithHintsResponse(o) {
+    if (o.result === undefined) {
+        throw new Error("Expected result in AvmSimulateWithHintsResponse serialization");
+    }
+    ;
+    return {
+        result: o.result,
+    };
+}
+export function fromAvmErrorResponse(o) {
+    if (o.message === undefined) {
+        throw new Error("Expected message in AvmErrorResponse serialization");
+    }
+    ;
+    return {
+        message: o.message,
+    };
+}

package/dest/generated/async.d.ts

@@ -0,0 +1,15 @@
+import { AsyncApiBase, AvmSimulate, AvmSimulateResponse, AvmSimulateWithHints, AvmSimulateWithHintsResponse } from './api_types.js';
+export interface IpcClientAsync {
+    call(input: Uint8Array): Promise<Uint8Array>;
+    destroy(): Promise<void>;
+}
+export type IpcErrorFactory = (message: string) => Error;
+export declare class AsyncApi implements AsyncApiBase {
+    protected backend: IpcClientAsync;
+    protected createError: IpcErrorFactory;
+    constructor(backend: IpcClientAsync, createError?: IpcErrorFactory);
+    simulate(command: AvmSimulate): Promise<AvmSimulateResponse>;
+    simulateWithHints(command: AvmSimulateWithHints): Promise<AvmSimulateWithHintsResponse>;
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=async.d.ts.map

package/dest/generated/async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../../src/generated/async.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,4BAA4B,EAAoG,MAAM,gBAAgB,CAAC;AAEtO,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,KAAK,CAAC;AAQzD,qBAAa,QAAS,YAAW,YAAY;IAEzC,SAAS,CAAC,OAAO,EAAE,cAAc;IACjC,SAAS,CAAC,WAAW,EAAE,eAAe;gBAD5B,OAAO,EAAE,cAAc,EACvB,WAAW,GAAE,eAA+C;IAGxE,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAa5D,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAavF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAGzB"}

package/dest/generated/async.js

@@ -0,0 +1,43 @@
+// AUTOGENERATED FILE - DO NOT EDIT
+import { Decoder, Encoder } from 'msgpackr';
+import { fromAvmSimulate, fromAvmSimulateWithHints, toAvmSimulateResponse, toAvmSimulateWithHintsResponse } from './api_types.js';
+async function msgpackCall(backend, input) {
+    const inputBuffer = new Encoder({ useRecords: false, variableMapSize: true }).pack(input);
+    const encodedResult = await backend.call(inputBuffer);
+    return new Decoder({ useRecords: false }).unpack(encodedResult);
+}
+export class AsyncApi {
+    backend;
+    createError;
+    constructor(backend, createError = message => new Error(message)) {
+        this.backend = backend;
+        this.createError = createError;
+    }
+    simulate(command) {
+        const msgpackCommand = fromAvmSimulate(command);
+        return msgpackCall(this.backend, [["AvmSimulate", msgpackCommand]]).then(([variantName, result]) => {
+            if (variantName === 'AvmErrorResponse') {
+                throw this.createError(result.message || 'Unknown error from server');
+            }
+            if (variantName !== 'AvmSimulateResponse') {
+                throw new Error(`Expected variant name 'AvmSimulateResponse' but got '${variantName}'`);
+            }
+            return toAvmSimulateResponse(result);
+        });
+    }
+    simulateWithHints(command) {
+        const msgpackCommand = fromAvmSimulateWithHints(command);
+        return msgpackCall(this.backend, [["AvmSimulateWithHints", msgpackCommand]]).then(([variantName, result]) => {
+            if (variantName === 'AvmErrorResponse') {
+                throw this.createError(result.message || 'Unknown error from server');
+            }
+            if (variantName !== 'AvmSimulateWithHintsResponse') {
+                throw new Error(`Expected variant name 'AvmSimulateWithHintsResponse' but got '${variantName}'`);
+            }
+            return toAvmSimulateWithHintsResponse(result);
+        });
+    }
+    destroy() {
+        return this.backend.destroy();
+    }
+}

package/dest/generated/sync.d.ts

@@ -0,0 +1,15 @@
+import { AvmSimulate, AvmSimulateResponse, AvmSimulateWithHints, AvmSimulateWithHintsResponse, SyncApiBase } from './api_types.js';
+export interface IpcClientSync {
+    call(input: Uint8Array): Uint8Array;
+    destroy(): void;
+}
+export type IpcErrorFactory = (message: string) => Error;
+export declare class SyncApi implements SyncApiBase {
+    protected backend: IpcClientSync;
+    protected createError: IpcErrorFactory;
+    constructor(backend: IpcClientSync, createError?: IpcErrorFactory);
+    simulate(command: AvmSimulate): AvmSimulateResponse;
+    simulateWithHints(command: AvmSimulateWithHints): AvmSimulateWithHintsResponse;
+    destroy(): void;
+}
+//# sourceMappingURL=sync.d.ts.map

package/dest/generated/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/generated/sync.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,WAAW,EAAoG,MAAM,gBAAgB,CAAC;AAErO,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAAC;IACpC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,KAAK,CAAC;AAQzD,qBAAa,OAAQ,YAAW,WAAW;IAEvC,SAAS,CAAC,OAAO,EAAE,aAAa;IAChC,SAAS,CAAC,WAAW,EAAE,eAAe;gBAD5B,OAAO,EAAE,aAAa,EACtB,WAAW,GAAE,eAA+C;IAGxE,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,mBAAmB;IAYnD,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,4BAA4B;IAY9E,OAAO,IAAI,IAAI;CAGhB"}

package/dest/generated/sync.js

@@ -0,0 +1,41 @@
+// AUTOGENERATED FILE - DO NOT EDIT
+import { Decoder, Encoder } from 'msgpackr';
+import { fromAvmSimulate, fromAvmSimulateWithHints, toAvmSimulateResponse, toAvmSimulateWithHintsResponse } from './api_types.js';
+function msgpackCall(backend, input) {
+    const inputBuffer = new Encoder({ useRecords: false, variableMapSize: true }).pack(input);
+    const encodedResult = backend.call(inputBuffer);
+    return new Decoder({ useRecords: false }).unpack(encodedResult);
+}
+export class SyncApi {
+    backend;
+    createError;
+    constructor(backend, createError = message => new Error(message)) {
+        this.backend = backend;
+        this.createError = createError;
+    }
+    simulate(command) {
+        const msgpackCommand = fromAvmSimulate(command);
+        const [variantName, result] = msgpackCall(this.backend, [["AvmSimulate", msgpackCommand]]);
+        if (variantName === 'AvmErrorResponse') {
+            throw this.createError(result.message || 'Unknown error from server');
+        }
+        if (variantName !== 'AvmSimulateResponse') {
+            throw new Error(`Expected variant name 'AvmSimulateResponse' but got '${variantName}'`);
+        }
+        return toAvmSimulateResponse(result);
+    }
+    simulateWithHints(command) {
+        const msgpackCommand = fromAvmSimulateWithHints(command);
+        const [variantName, result] = msgpackCall(this.backend, [["AvmSimulateWithHints", msgpackCommand]]);
+        if (variantName === 'AvmErrorResponse') {
+            throw this.createError(result.message || 'Unknown error from server');
+        }
+        if (variantName !== 'AvmSimulateWithHintsResponse') {
+            throw new Error(`Expected variant name 'AvmSimulateWithHintsResponse' but got '${variantName}'`);
+        }
+        return toAvmSimulateWithHintsResponse(result);
+    }
+    destroy() {
+        this.backend.destroy();
+    }
+}

package/dest/index.d.ts

@@ -0,0 +1,36 @@
+import { AsyncApi, type IpcErrorFactory } from './generated/async.js';
+export * from './generated/api_types.js';
+export { AsyncApi } from './generated/async.js';
+export { SyncApi } from './generated/sync.js';
+export type AvmTransport = 'uds';
+export interface AvmServiceOptions {
+    binaryPath?: string;
+    transport?: AvmTransport;
+    logger?: (msg: string) => void;
+    connectTimeoutMs?: number;
+    env?: NodeJS.ProcessEnv;
+    extraArgs?: string[];
+    createError?: IpcErrorFactory;
+    /**
+     * Respawn the server on the next call after it dies, instead of failing all
+     * subsequent calls. Only enable for stateless servers: a respawned process
+     * remembers nothing, so any server-side session state held by callers would
+     * silently dangle.
+     */
+    respawn?: boolean;
+}
+/**
+ * Spawns and talks to a 'bb-avm-sim' server process. Process
+ * lifecycle — connectivity, death detection, optional respawn, teardown — is
+ * owned by the backend (see SpawnedProcessBackend in ipc-runtime); it never
+ * leaks onto this API. Failed calls carry a 'retry' property set to true when
+ * the failure was environmental and the operation may be retried.
+ */
+export declare class AvmService extends AsyncApi {
+    private spawnedBackend;
+    private constructor();
+    static spawn(options?: AvmServiceOptions): Promise<AvmService>;
+    getIpcPath(): string;
+    sendProcessSignal(signal: NodeJS.Signals): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGtE,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC;AAEjC,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,qBAAa,UAAW,SAAQ,QAAQ;IAClB,OAAO,CAAC,cAAc;IAA1C,OAAO;WAIM,KAAK,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC;IAoBxE,UAAU,IAAI,MAAM;IAIpB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI;CAGhD"}

package/dest/index.js

@@ -0,0 +1,45 @@
+import { IpcSpawnError, SpawnedProcessBackend } from '@aztec-foundation/ipc-runtime';
+import { AsyncApi } from './generated/async.js';
+import { findAvmBinary } from './platform.js';
+export * from './generated/api_types.js';
+export { AsyncApi } from './generated/async.js';
+export { SyncApi } from './generated/sync.js';
+/**
+ * Spawns and talks to a 'bb-avm-sim' server process. Process
+ * lifecycle — connectivity, death detection, optional respawn, teardown — is
+ * owned by the backend (see SpawnedProcessBackend in ipc-runtime); it never
+ * leaks onto this API. Failed calls carry a 'retry' property set to true when
+ * the failure was environmental and the operation may be retried.
+ */
+export class AvmService extends AsyncApi {
+    spawnedBackend;
+    constructor(spawnedBackend, createError) {
+        super(spawnedBackend, createError);
+        this.spawnedBackend = spawnedBackend;
+    }
+    static async spawn(options = {}) {
+        const binaryPath = findAvmBinary(options.binaryPath);
+        if (!binaryPath) {
+            throw new IpcSpawnError('bb-avm-sim binary not found', /*retry=*/ false);
+        }
+        const backend = await SpawnedProcessBackend.spawn({
+            binaryPath,
+            binaryName: 'bb-avm-sim',
+            instancePrefix: 'avm',
+            ipcPathArgs: ["msgpack", "run", "--input", "{path}"],
+            transport: options.transport ?? 'uds',
+            logger: options.logger,
+            connectTimeoutMs: options.connectTimeoutMs,
+            env: options.env,
+            extraArgs: options.extraArgs,
+            respawn: options.respawn,
+        });
+        return new AvmService(backend, options.createError);
+    }
+    getIpcPath() {
+        return this.spawnedBackend.getIpcPath();
+    }
+    sendProcessSignal(signal) {
+        this.spawnedBackend.sendProcessSignal(signal);
+    }
+}

package/dest/platform.d.ts

@@ -0,0 +1,4 @@
+export type Platform = 'x86_64-linux' | 'x86_64-darwin' | 'aarch64-linux' | 'aarch64-darwin';
+export declare function findAvmBinary(customPath?: string): string | null;
+export declare const ARCH_PACKAGE_STEM = "bb-avm-sim";
+//# sourceMappingURL=platform.d.ts.map

package/dest/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,QAAQ,GAAG,cAAc,GAAG,eAAe,GAAG,eAAe,GAAG,gBAAgB,CAAC;AAgC7F,wBAAgB,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwBhE;AAED,eAAO,MAAM,iBAAiB,eAAe,CAAC"}

package/dest/platform.js

@@ -0,0 +1,57 @@
+import { createRequire } from 'node:module';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const PLATFORM_TO_PACKAGE = {
+    'x86_64-linux': '@aztec-foundation/bb-avm-sim-linux-x64',
+    'x86_64-darwin': '@aztec-foundation/bb-avm-sim-darwin-x64',
+    'aarch64-linux': '@aztec-foundation/bb-avm-sim-linux-arm64',
+    'aarch64-darwin': '@aztec-foundation/bb-avm-sim-darwin-arm64',
+};
+function currentDir() {
+    return path.dirname(fileURLToPath(import.meta.url));
+}
+function detectPlatform() {
+    if (process.arch === 'x64' && process.platform === 'linux')
+        return 'x86_64-linux';
+    if (process.arch === 'x64' && process.platform === 'darwin')
+        return 'x86_64-darwin';
+    if (process.arch === 'arm64' && process.platform === 'linux')
+        return 'aarch64-linux';
+    if (process.arch === 'arm64' && process.platform === 'darwin')
+        return 'aarch64-darwin';
+    return null;
+}
+function findArchPackageDir(platform) {
+    const packageName = PLATFORM_TO_PACKAGE[platform];
+    try {
+        const require = createRequire(import.meta.url);
+        return path.dirname(require.resolve(packageName + '/package.json'));
+    }
+    catch {
+        const siblingPackageDir = path.join(currentDir(), '..', 'packages', packageName.split('/').pop());
+        return fs.existsSync(path.join(siblingPackageDir, 'package.json')) ? siblingPackageDir : null;
+    }
+}
+export function findAvmBinary(customPath) {
+    if (customPath) {
+        return fs.existsSync(customPath) ? path.resolve(customPath) : null;
+    }
+    const envPath = process.env.BB_AVM_SIM_PATH;
+    if (envPath) {
+        return fs.existsSync(envPath) ? path.resolve(envPath) : null;
+    }
+    const platform = detectPlatform();
+    if (!platform) {
+        return null;
+    }
+    const archDir = findArchPackageDir(platform);
+    if (archDir) {
+        const candidate = path.join(archDir, 'bb-avm-sim');
+        if (fs.existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+export const ARCH_PACKAGE_STEM = 'bb-avm-sim';

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@aztec-foundation/bb-avm-sim",
+  "version": "0.0.1-commit.b66364b",
+  "type": "module",
+  "bin": {
+    "bb-avm-sim": "./dest/bin.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dest/index.d.ts",
+      "default": "./dest/index.js"
+    }
+  },
+  "files": [
+    "dest/",
+    "README.md"
+  ],
+  "scripts": {
+    "clean": "rm -rf dest .tsbuildinfo",
+    "build": "tsc -p tsconfig.json",
+    "prepare_arch_packages": "./scripts/prepare_arch_packages.sh"
+  },
+  "dependencies": {
+    "@aztec-foundation/ipc-runtime": "0.0.1-commit.b66364b",
+    "msgpackr": "^1.11.2",
+    "tslib": "^2.4.0"
+  },
+  "optionalDependencies": {
+    "@aztec-foundation/bb-avm-sim-linux-x64": "0.0.1-commit.b66364b",
+    "@aztec-foundation/bb-avm-sim-darwin-x64": "0.0.1-commit.b66364b",
+    "@aztec-foundation/bb-avm-sim-linux-arm64": "0.0.1-commit.b66364b",
+    "@aztec-foundation/bb-avm-sim-darwin-arm64": "0.0.1-commit.b66364b"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.17",
+    "typescript": "^5.3.3"
+  }
+}