movehat 0.1.8 → 0.2.0

package/dist/helpers/testFixtures.d.ts

@@ -19,6 +19,15 @@ export interface TestFixture<TModules extends string = string> {
     };
     /** Deployed contracts by module name - type-safe based on modules parameter */
     contracts: Record<TModules, MoveContract>;
+    /**
+     * Stop the local node / fork server this fixture started.
+     *
+     * Does **not** clear the shared `AccountManager` pool — clearing it
+     * would break parallel `setupTestFixture` invocations that share the
+     * pool. The pool grows for the lifetime of the process; the process
+     * exit reclaims it.
+     */
+    teardown: () => Promise<void>;
 }
 /**
  * Setup a complete test fixture with local fork, accounts, and deployed contracts
@@ -32,84 +41,41 @@ export interface TestFixture<TModules extends string = string> {
  * @param modules Array of module names to auto-deploy
  * @param accountLabels Optional array of account labels (defaults to ['alice', 'bob'])
  * @param options Optional LocalTestOptions for advanced configuration
- * @returns TestFixture with runtime, accounts, and contracts
+ * @returns TestFixture with runtime, accounts, contracts, and a teardown closure
  *
  * @example
  * ```typescript
- * import { setupTestFixture } from "movehat/helpers";
+ * import { setupTestFixture, type TestFixture } from "movehat/helpers";
  *
  * describe("Counter Contract", () => {
- *   let fixture: TestFixture;
+ *   let fixture: TestFixture<"counter">;
  *
  *   before(async function () {
- *     this.timeout(60000); // Allow time for fork + deployment
- *
- *     fixture = await setupTestFixture(['counter'], ['alice', 'bob']);
+ *     this.timeout(60000);
+ *     fixture = await setupTestFixture(['counter'] as const, ['alice', 'bob']);
  *   });
  *
- *   it("should initialize with value 0", async () => {
- *     const counter = fixture.contracts.counter;
- *     const value = await counter.view<number>("get", [
- *       fixture.accounts.deployer.accountAddress.toString()
- *     ]);
- *
- *     expect(value).to.equal(0);
+ *   after(async () => {
+ *     await fixture.teardown();
  *   });
  *
- *   it("alice can increment counter", async () => {
+ *   it("alice can increment", async () => {
  *     const tx = await fixture.contracts.counter.call(
- *       fixture.accounts.alice,
- *       "increment",
- *       []
+ *       fixture.accounts.alice, "increment", []
  *     );
- *
  *     expect(tx.success).to.be.true;
  *   });
- *
- *   after(async () => {
- *     await teardownTestFixture();
- *   });
  * });
  * ```
  */
 export declare function setupTestFixture<TModules extends readonly string[]>(modules: TModules, accountLabels?: string[], options?: Partial<LocalTestOptions>): Promise<TestFixture<TModules[number]>>;
-/**
- * Teardown test fixture and cleanup resources
- *
- * Call this in your test suite's `after` hook to properly cleanup:
- * - Stops fork server
- * - Clears account pool
- *
- * @example
- * ```typescript
- * after(async () => {
- *   await teardownTestFixture();
- * });
- * ```
- */
-export declare function teardownTestFixture(): Promise<void>;
 /**
  * Create a minimal test fixture without auto-deployment
  * Useful when you want to deploy contracts manually in tests
  *
  * @param accountLabels Account labels to create (defaults to ['alice', 'bob'])
  * @param options Optional LocalTestOptions
- * @returns Partial TestFixture (without contracts)
- *
- * @example
- * ```typescript
- * let fixture: Partial<TestFixture>;
- *
- * before(async function () {
- *   this.timeout(30000);
- *   fixture = await setupMinimalFixture(['alice', 'bob', 'charlie']);
- * });
- *
- * it("should deploy contract manually", async () => {
- *   await fixture.mh!.deployContract("counter");
- *   // ...
- * });
- * ```
+ * @returns Partial TestFixture (without contracts) plus a teardown closure
  */
 export declare function setupMinimalFixture(accountLabels?: string[], options?: Partial<LocalTestOptions>): Promise<Omit<TestFixture, "contracts">>;
 //# sourceMappingURL=testFixtures.d.ts.map

package/dist/helpers/testFixtures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testFixtures.d.ts","sourceRoot":"","sources":["../../src/helpers/testFixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM;IAC3D,+BAA+B;IAC/B,EAAE,EAAE,cAAc,CAAC;IAEnB,kDAAkD;IAClD,QAAQ,EAAE;QACR,QAAQ,EAAE,OAAO,CAAC;QAClB,KAAK,EAAE,OAAO,CAAC;QACf,GAAG,EAAE,OAAO,CAAC;QACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IAEF,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,SAAS,SAAS,MAAM,EAAE,EACvE,OAAO,EAAE,QAAQ,EACjB,aAAa,GAAE,MAAM,EAAqB,EAC1C,OAAO,GAAE,OAAO,CAAC,gBAAgB,CAAM,GACtC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAsDxC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAUzD;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,mBAAmB,CACvC,aAAa,GAAE,MAAM,EAAqB,EAC1C,OAAO,GAAE,OAAO,CAAC,gBAAgB,CAAM,GACtC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CA6BzC"}
+{"version":3,"file":"testFixtures.d.ts","sourceRoot":"","sources":["../../src/helpers/testFixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM;IAC3D,+BAA+B;IAC/B,EAAE,EAAE,cAAc,CAAC;IAEnB,kDAAkD;IAClD,QAAQ,EAAE;QACR,QAAQ,EAAE,OAAO,CAAC;QAClB,KAAK,EAAE,OAAO,CAAC;QACf,GAAG,EAAE,OAAO,CAAC;QACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IAEF,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAE1C;;;;;;;OAOG;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,SAAS,SAAS,MAAM,EAAE,EACvE,OAAO,EAAE,QAAQ,EACjB,aAAa,GAAE,MAAM,EAAqB,EAC1C,OAAO,GAAE,OAAO,CAAC,gBAAgB,CAAM,GACtC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAuExC;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,aAAa,GAAE,MAAM,EAAqB,EAC1C,OAAO,GAAE,OAAO,CAAC,gBAAgB,CAAM,GACtC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CA2CzC"}

package/dist/helpers/testFixtures.js

@@ -1,5 +1,6 @@
 import { AccountManager } from "../core/AccountManager.js";
-import { setupLocalTesting, stopLocalTesting } from "./setupLocalTesting.js";
+import { setupLocalTesting } from "./setupLocalTesting.js";
+import { logger } from "../ui/index.js";
 /**
  * Setup a complete test fixture with local fork, accounts, and deployed contracts
  *
@@ -12,108 +13,90 @@ import { setupLocalTesting, stopLocalTesting } from "./setupLocalTesting.js";
  * @param modules Array of module names to auto-deploy
  * @param accountLabels Optional array of account labels (defaults to ['alice', 'bob'])
  * @param options Optional LocalTestOptions for advanced configuration
- * @returns TestFixture with runtime, accounts, and contracts
+ * @returns TestFixture with runtime, accounts, contracts, and a teardown closure
  *
  * @example
  * ```typescript
- * import { setupTestFixture } from "movehat/helpers";
+ * import { setupTestFixture, type TestFixture } from "movehat/helpers";
  *
  * describe("Counter Contract", () => {
- *   let fixture: TestFixture;
+ *   let fixture: TestFixture<"counter">;
  *
  *   before(async function () {
- *     this.timeout(60000); // Allow time for fork + deployment
- *
- *     fixture = await setupTestFixture(['counter'], ['alice', 'bob']);
+ *     this.timeout(60000);
+ *     fixture = await setupTestFixture(['counter'] as const, ['alice', 'bob']);
  *   });
  *
- *   it("should initialize with value 0", async () => {
- *     const counter = fixture.contracts.counter;
- *     const value = await counter.view<number>("get", [
- *       fixture.accounts.deployer.accountAddress.toString()
- *     ]);
- *
- *     expect(value).to.equal(0);
+ *   after(async () => {
+ *     await fixture.teardown();
  *   });
  *
- *   it("alice can increment counter", async () => {
+ *   it("alice can increment", async () => {
  *     const tx = await fixture.contracts.counter.call(
- *       fixture.accounts.alice,
- *       "increment",
- *       []
+ *       fixture.accounts.alice, "increment", []
  *     );
- *
  *     expect(tx.success).to.be.true;
  *   });
- *
- *   after(async () => {
- *     await teardownTestFixture();
- *   });
  * });
  * ```
  */
 export async function setupTestFixture(modules, accountLabels = ["alice", "bob"], options = {}) {
-    console.log(`\n🧪 Setting up test fixture...`);
-    console.log(`   Modules to deploy: ${modules.join(", ")}`);
-    console.log(`   Account labels: deployer, ${accountLabels.join(", ")}\n`);
-    // Ensure 'deployer' is always in the account labels
+    logger.newline();
+    logger.step("Setting up test fixture...");
+    logger.plain(`   Modules to deploy: ${modules.join(", ")}`);
+    logger.plain(`   Account labels: deployer, ${accountLabels.join(", ")}`);
+    logger.newline();
     const allLabels = ["deployer", ...accountLabels.filter((l) => l !== "deployer")];
-    // Setup local testing environment with auto-deploy
     const setupOptions = {
         ...options,
         accountLabels: allLabels,
-        autoDeploy: modules, // Auto-deploy specified modules
+        autoDeploy: modules,
     };
-    const mh = await setupLocalTesting(setupOptions);
-    // Get all labeled accounts
-    const labeledAccounts = AccountManager.getLabeledAccounts();
-    // Build accounts object with required accounts
-    const accounts = {
-        deployer: labeledAccounts.deployer,
-    };
-    // Add other labeled accounts
-    for (const label of accountLabels) {
-        accounts[label] = labeledAccounts[label] || AccountManager.getOrCreateLabeled(label);
-    }
-    // Build contracts object - TypeScript will infer the correct type
-    const contracts = {};
-    for (const moduleName of modules) {
-        // Get deployed contract instance
-        const deploymentAddress = mh.getDeploymentAddress(moduleName);
-        if (!deploymentAddress) {
-            throw new Error(`Module "${moduleName}" was not deployed. Check auto-deploy logs.`);
+    const ctx = await setupLocalTesting(setupOptions);
+    // Assembly is fallible — a missing deployment address (autoDeploy
+    // silently failed) or any unexpected throw would leak the started
+    // infrastructure. Tear down ctx on failure; the outer caller sees
+    // the original assembly error unchanged.
+    try {
+        const mh = ctx.runtime;
+        const labeledAccounts = AccountManager.getLabeledAccounts();
+        // any: TestFixture.accounts has a structural shape with required
+        // `deployer/alice/bob` plus a `[key: string]: Account` index. The
+        // builder fills the index dynamically; typing this as the exact
+        // intersection would require a generic over `accountLabels` and
+        // produce noisy errors for the dynamic key assignment below.
+        const accounts = {
+            // non-null: setupLocalTesting → setupWithLocalNode/Fork unconditionally
+            // funds the deployer account via accountLabels[0]; deployer is always
+            // first by construction at L93 above.
+            deployer: labeledAccounts.deployer,
+        };
+        for (const label of accountLabels) {
+            accounts[label] = labeledAccounts[label] || AccountManager.getOrCreateLabeled(label);
         }
-        contracts[moduleName] = mh.getContract(deploymentAddress, moduleName);
-        console.log(`   ✓ Contract "${moduleName}" ready at ${deploymentAddress}`);
+        const contracts = {};
+        for (const moduleName of modules) {
+            const deploymentAddress = mh.getDeploymentAddress(moduleName);
+            if (!deploymentAddress) {
+                throw new Error(`Module "${moduleName}" was not deployed. Check auto-deploy logs.`);
+            }
+            contracts[moduleName] = mh.getContract(deploymentAddress, moduleName);
+            logger.success(`Contract "${moduleName}" ready at ${deploymentAddress}`, 2);
+        }
+        logger.newline();
+        logger.success("Test fixture ready!");
+        logger.newline();
+        return {
+            mh,
+            accounts,
+            contracts,
+            teardown: ctx.teardown,
+        };
+    }
+    catch (error) {
+        await ctx.teardown().catch(() => { });
+        throw error;
     }
-    console.log(`\n✅ Test fixture ready!\n`);
-    return {
-        mh,
-        accounts,
-        contracts,
-    };
-}
-/**
- * Teardown test fixture and cleanup resources
- *
- * Call this in your test suite's `after` hook to properly cleanup:
- * - Stops fork server
- * - Clears account pool
- *
- * @example
- * ```typescript
- * after(async () => {
- *   await teardownTestFixture();
- * });
- * ```
- */
-export async function teardownTestFixture() {
-    console.log(`\n🧹 Tearing down test fixture...`);
-    // Stop fork server
-    await stopLocalTesting();
-    // Clear account pool for test isolation
-    AccountManager.clearPool();
-    console.log(`✓ Teardown complete\n`);
 }
 /**
  * Create a minimal test fixture without auto-deployment
@@ -121,43 +104,42 @@ export async function teardownTestFixture() {
  *
  * @param accountLabels Account labels to create (defaults to ['alice', 'bob'])
  * @param options Optional LocalTestOptions
- * @returns Partial TestFixture (without contracts)
- *
- * @example
- * ```typescript
- * let fixture: Partial<TestFixture>;
- *
- * before(async function () {
- *   this.timeout(30000);
- *   fixture = await setupMinimalFixture(['alice', 'bob', 'charlie']);
- * });
- *
- * it("should deploy contract manually", async () => {
- *   await fixture.mh!.deployContract("counter");
- *   // ...
- * });
- * ```
+ * @returns Partial TestFixture (without contracts) plus a teardown closure
  */
 export async function setupMinimalFixture(accountLabels = ["alice", "bob"], options = {}) {
-    console.log(`\n🧪 Setting up minimal test fixture (no auto-deploy)...`);
+    logger.newline();
+    logger.step("Setting up minimal test fixture (no auto-deploy)...");
     const allLabels = ["deployer", ...accountLabels.filter((l) => l !== "deployer")];
     const setupOptions = {
         ...options,
         accountLabels: allLabels,
-        autoDeploy: [], // No auto-deploy
+        autoDeploy: [],
     };
-    const mh = await setupLocalTesting(setupOptions);
-    const labeledAccounts = AccountManager.getLabeledAccounts();
-    const accounts = {
-        deployer: labeledAccounts.deployer,
-    };
-    for (const label of accountLabels) {
-        accounts[label] = labeledAccounts[label] || AccountManager.getOrCreateLabeled(label);
+    const ctx = await setupLocalTesting(setupOptions);
+    // Same teardown-on-assembly-failure pattern as setupTestFixture.
+    try {
+        const mh = ctx.runtime;
+        const labeledAccounts = AccountManager.getLabeledAccounts();
+        // any: see setupTestFixture above — same dynamic-key builder pattern.
+        const accounts = {
+            // non-null: deployer is unconditionally added to allLabels at L156 above.
+            deployer: labeledAccounts.deployer,
+        };
+        for (const label of accountLabels) {
+            accounts[label] = labeledAccounts[label] || AccountManager.getOrCreateLabeled(label);
+        }
+        logger.newline();
+        logger.success("Minimal fixture ready!");
+        logger.newline();
+        return {
+            mh,
+            accounts,
+            teardown: ctx.teardown,
+        };
+    }
+    catch (error) {
+        await ctx.teardown().catch(() => { });
+        throw error;
     }
-    console.log(`\n✅ Minimal fixture ready!\n`);
-    return {
-        mh,
-        accounts,
-    };
 }
 //# sourceMappingURL=testFixtures.js.map

package/dist/helpers/testFixtures.js.map

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

package/dist/index.d.ts

@@ -1,11 +1,13 @@
 export * from "./helpers/index.js";
 export type { MovehatConfig } from "./types/config.js";
-export { initRuntime, getRuntime, getMovehat, mh } from "./runtime.js";
+export { initRuntime } from "./runtime.js";
 export type { MovehatRuntime, NetworkInfo } from "./types/runtime.js";
 export { ForkManager } from "./fork/manager.js";
 export { MovementApiClient } from "./fork/api.js";
 export { ForkStorage } from "./fork/storage.js";
 export { ForkServer } from "./fork/server.js";
 export type { ForkMetadata, AccountState, LedgerInfo, AccountData, AccountResource } from "./types/fork.js";
-export { ModuleAlreadyDeployedError } from "./errors.js";
+export { ModuleAlreadyDeployedError, PostPublishError } from "./errors.js";
+export { Harness, HarnessDisposedError } from "./harness/index.js";
+export type { HarnessMode } from "./harness/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC;AACnC,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAG5G,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC;AACnC,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKvD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAG5G,OAAO,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG3E,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACnE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,12 +1,16 @@
 // Export all helpers for end users
 export * from "./helpers/index.js";
-// Export Movehat Runtime Environment
-export { initRuntime, getRuntime, getMovehat, mh } from "./runtime.js";
+// Movehat Runtime Environment. `initRuntime` is a public utility but
+// external callers should prefer Harness; it's the construction primitive
+// `Harness.createLive` uses.
+export { initRuntime } from "./runtime.js";
 // Export Fork system
 export { ForkManager } from "./fork/manager.js";
 export { MovementApiClient } from "./fork/api.js";
 export { ForkStorage } from "./fork/storage.js";
 export { ForkServer } from "./fork/server.js";
 // Export custom errors
-export { ModuleAlreadyDeployedError } from "./errors.js";
+export { ModuleAlreadyDeployedError, PostPublishError } from "./errors.js";
+// Export Harness (Hardhat-style API — primary public surface from M2 onward)
+export { Harness, HarnessDisposedError } from "./harness/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,cAAc,oBAAoB,CAAC;AAGnC,qCAAqC;AACrC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAGvE,qBAAqB;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,uBAAuB;AACvB,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,cAAc,oBAAoB,CAAC;AAGnC,qEAAqE;AACrE,0EAA0E;AAC1E,6BAA6B;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,qBAAqB;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,uBAAuB;AACvB,OAAO,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE3E,6EAA6E;AAC7E,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/node/LocalNodeManager.d.ts

@@ -1,4 +1,5 @@
 import { Account } from "@aptos-labs/ts-sdk";
+import { type ChildProcessAdapter } from "../utils/childProcessAdapter.js";
 export interface LocalNodeOptions {
     testDir?: string;
     forceRestart?: boolean;
@@ -6,6 +7,11 @@ export interface LocalNodeOptions {
     apiPort?: number;
     readyPort?: number;
     silent?: boolean;
+    /**
+     * Override the child-process adapter. Tests inject a fake adapter so
+     * the daemon spawn never reaches the real `movement` binary.
+     */
+    adapter?: ChildProcessAdapter;
 }
 export interface LocalNodeInfo {
     rpcUrl: string;
@@ -23,8 +29,10 @@ export interface LocalNodeInfo {
  * - Cleanup on shutdown
  */
 export declare class LocalNodeManager {
-    private process;
+    private spawned;
+    private killed;
     private options;
+    private readonly adapter;
     private starting;
     constructor(options?: LocalNodeOptions);
     /**

package/dist/node/LocalNodeManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LocalNodeManager.d.ts","sourceRoot":"","sources":["../../src/node/LocalNodeManager.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,OAAO,GAAE,gBAAqB;IAW1C;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC;IAiGrC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC3B;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,WAAW,IAAI,aAAa;IAS5B;;OAEG;YACW,YAAY;IA0B1B;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,MAAM,GAAE,MAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCzF;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,CAAC,OAAO,GAAG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAE,MAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/F;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAW7B"}
+{"version":3,"file":"LocalNodeManager.d.ts","sourceRoot":"","sources":["../../src/node/LocalNodeManager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,iCAAiC,CAAC;AAGzC,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAA8C;IAC7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,OAAO,GAAE,gBAAqB;IAY1C;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC;IAqGrC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqC3B;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,WAAW,IAAI,aAAa;IAS5B;;OAEG;YACW,YAAY;IA0B1B;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,MAAM,GAAE,MAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCzF;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,CAAC,OAAO,GAAG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAE,MAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/F;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAW7B"}