rivetkit 2.1.3 → 2.1.5

package/dist/tsup/test/mod.cjs

@@ -1,18 +1,18 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
-var _chunkT6MM5RTWcjs = require('../chunk-T6MM5RTW.cjs');
+var _chunkU5SMSA27cjs = require('../chunk-U5SMSA27.cjs');
 
 
-var _chunkHPAX7L72cjs = require('../chunk-HPAX7L72.cjs');
-require('../chunk-U6VWVHVW.cjs');
+var _chunkIIJNPVPQcjs = require('../chunk-IIJNPVPQ.cjs');
+require('../chunk-JC6BEPE7.cjs');
 
 
-var _chunkR64EFI6Fcjs = require('../chunk-R64EFI6F.cjs');
+var _chunkTI5PXQGGcjs = require('../chunk-TI5PXQGG.cjs');
 require('../chunk-NIYZDWMW.cjs');
-require('../chunk-KSZZRTOD.cjs');
+require('../chunk-PB5AEMKQ.cjs');
 
 
-var _chunkZSJ2OTY4cjs = require('../chunk-ZSJ2OTY4.cjs');
+var _chunkHYPIHCDTcjs = require('../chunk-HYPIHCDT.cjs');
 require('../chunk-L47L3ZWJ.cjs');
 require('../chunk-HDQ2JUQT.cjs');
 
@@ -23,14 +23,14 @@ var _invariant = require('invariant'); var _invariant2 = _interopRequireDefault(
 
 // src/test/log.ts
 function logger() {
-  return _chunkZSJ2OTY4cjs.getLogger.call(void 0, "test");
+  return _chunkHYPIHCDTcjs.getLogger.call(void 0, "test");
 }
 
 // src/test/mod.ts
 async function setupTest(c, registry) {
   var _a;
   registry.config.test = { ...registry.config.test, enabled: true };
-  const driver = _chunkT6MM5RTWcjs.createFileSystemOrMemoryDriver.call(void 0, 
+  const driver = _chunkU5SMSA27cjs.createFileSystemOrMemoryDriver.call(void 0, 
     true,
     { path: `/tmp/rivetkit-test-${crypto.randomUUID()}` }
   );
@@ -45,7 +45,7 @@ async function setupTest(c, registry) {
   _invariant2.default.call(void 0, managerDriver, "missing manager driver");
   const getUpgradeWebSocket = () => upgradeWebSocket;
   managerDriver.setGetUpgradeWebSocket(getUpgradeWebSocket);
-  const { router } = _chunkR64EFI6Fcjs.buildManagerRouter.call(void 0, 
+  const { router } = _chunkTI5PXQGGcjs.buildManagerRouter.call(void 0, 
     parsedConfig,
     managerDriver,
     getUpgradeWebSocket
@@ -75,7 +75,7 @@ async function setupTest(c, registry) {
   c.onTestFinished(async () => {
     await new Promise((resolve) => server.close(() => resolve(void 0)));
   });
-  const client = _chunkHPAX7L72cjs.createClient.call(void 0, {
+  const client = _chunkIIJNPVPQcjs.createClient.call(void 0, {
     endpoint,
     namespace: "default",
     runnerName: "default",

package/dist/tsup/test/mod.d.cts

@@ -1,5 +1,5 @@
 import { TestContext } from 'vitest';
-import { a5 as Registry, C as Client } from '../config-_gfywqqI.cjs';
+import { a5 as Registry, C as Client } from '../config-iPj5l1bL.cjs';
 import 'zod/v4';
 import '@rivetkit/virtual-websocket';
 import '../config-BiNoIHRs.cjs';

package/dist/tsup/test/mod.d.ts

@@ -1,5 +1,5 @@
 import { TestContext } from 'vitest';
-import { a5 as Registry, C as Client } from '../config-P3XujgRr.js';
+import { a5 as Registry, C as Client } from '../config-Qj-zLJPc.js';
 import 'zod/v4';
 import '@rivetkit/virtual-websocket';
 import '../config-BiNoIHRs.js';

package/dist/tsup/test/mod.js

@@ -1,18 +1,18 @@
 import {
   createFileSystemOrMemoryDriver
-} from "../chunk-GNGRMP5E.js";
+} from "../chunk-SRIM3GHD.js";
 import {
   createClient
-} from "../chunk-N7ASEZ2Y.js";
-import "../chunk-OAOF23ZY.js";
+} from "../chunk-JPXO2H55.js";
+import "../chunk-2OK7S6QF.js";
 import {
   buildManagerRouter
-} from "../chunk-QUDLEWGD.js";
+} from "../chunk-MIX2KB6U.js";
 import "../chunk-LXUQ667X.js";
-import "../chunk-MAXIXG56.js";
+import "../chunk-TADUYCHF.js";
 import {
   getLogger
-} from "../chunk-YET3IZD6.js";
+} from "../chunk-EIATSBYZ.js";
 import "../chunk-7HTNH26M.js";
 import "../chunk-424PT5DM.js";
 

package/dist/tsup/utils.cjs

@@ -17,7 +17,7 @@
 
 
 
-var _chunkZSJ2OTY4cjs = require('./chunk-ZSJ2OTY4.cjs');
+var _chunkHYPIHCDTcjs = require('./chunk-HYPIHCDT.cjs');
 require('./chunk-L47L3ZWJ.cjs');
 require('./chunk-HDQ2JUQT.cjs');
 
@@ -39,5 +39,5 @@ require('./chunk-HDQ2JUQT.cjs');
 
 
 
-exports.EXTRA_ERROR_LOG = _chunkZSJ2OTY4cjs.EXTRA_ERROR_LOG; exports.SinglePromiseQueue = _chunkZSJ2OTY4cjs.SinglePromiseQueue; exports.VERSION = _chunkZSJ2OTY4cjs.VERSION; exports.arrayBuffersEqual = _chunkZSJ2OTY4cjs.arrayBuffersEqual; exports.assertUnreachable = _chunkZSJ2OTY4cjs.assertUnreachable; exports.bufferToArrayBuffer = _chunkZSJ2OTY4cjs.bufferToArrayBuffer; exports.combineUrlPath = _chunkZSJ2OTY4cjs.combineUrlPath; exports.dbg = _chunkZSJ2OTY4cjs.dbg; exports.detectRuntime = _chunkZSJ2OTY4cjs.detectRuntime; exports.getEnvUniversal = _chunkZSJ2OTY4cjs.getEnvUniversal; exports.httpUserAgent = _chunkZSJ2OTY4cjs.httpUserAgent; exports.interval = _chunkZSJ2OTY4cjs.interval; exports.joinSignals = _chunkZSJ2OTY4cjs.joinSignals; exports.promiseWithResolvers = _chunkZSJ2OTY4cjs.promiseWithResolvers; exports.setLongTimeout = _chunkZSJ2OTY4cjs.setLongTimeout; exports.sleep = _chunkZSJ2OTY4cjs.sleep; exports.stringifyError = _chunkZSJ2OTY4cjs.stringifyError; exports.toUint8Array = _chunkZSJ2OTY4cjs.toUint8Array;
+exports.EXTRA_ERROR_LOG = _chunkHYPIHCDTcjs.EXTRA_ERROR_LOG; exports.SinglePromiseQueue = _chunkHYPIHCDTcjs.SinglePromiseQueue; exports.VERSION = _chunkHYPIHCDTcjs.VERSION; exports.arrayBuffersEqual = _chunkHYPIHCDTcjs.arrayBuffersEqual; exports.assertUnreachable = _chunkHYPIHCDTcjs.assertUnreachable; exports.bufferToArrayBuffer = _chunkHYPIHCDTcjs.bufferToArrayBuffer; exports.combineUrlPath = _chunkHYPIHCDTcjs.combineUrlPath; exports.dbg = _chunkHYPIHCDTcjs.dbg; exports.detectRuntime = _chunkHYPIHCDTcjs.detectRuntime; exports.getEnvUniversal = _chunkHYPIHCDTcjs.getEnvUniversal; exports.httpUserAgent = _chunkHYPIHCDTcjs.httpUserAgent; exports.interval = _chunkHYPIHCDTcjs.interval; exports.joinSignals = _chunkHYPIHCDTcjs.joinSignals; exports.promiseWithResolvers = _chunkHYPIHCDTcjs.promiseWithResolvers; exports.setLongTimeout = _chunkHYPIHCDTcjs.setLongTimeout; exports.sleep = _chunkHYPIHCDTcjs.sleep; exports.stringifyError = _chunkHYPIHCDTcjs.stringifyError; exports.toUint8Array = _chunkHYPIHCDTcjs.toUint8Array;
 //# sourceMappingURL=utils.cjs.map

package/dist/tsup/utils.js

@@ -17,7 +17,7 @@ import {
   sleep,
   stringifyError,
   toUint8Array
-} from "./chunk-YET3IZD6.js";
+} from "./chunk-EIATSBYZ.js";
 import "./chunk-7HTNH26M.js";
 import "./chunk-424PT5DM.js";
 export {

package/dist/tsup/workflow/mod.cjs

@@ -2,15 +2,15 @@
 
 
 
-var _chunk5AZ6UPEFcjs = require('../chunk-5AZ6UPEF.cjs');
-require('../chunk-DADGS67O.cjs');
-require('../chunk-KSZZRTOD.cjs');
-require('../chunk-ZSJ2OTY4.cjs');
+var _chunk7WF2QSICcjs = require('../chunk-7WF2QSIC.cjs');
+require('../chunk-GQGRQDRL.cjs');
+require('../chunk-PB5AEMKQ.cjs');
+require('../chunk-HYPIHCDT.cjs');
 require('../chunk-L47L3ZWJ.cjs');
 require('../chunk-HDQ2JUQT.cjs');
 
 
 
 
-exports.ActorWorkflowContext = _chunk5AZ6UPEFcjs.ActorWorkflowContext; exports.Loop = _chunk5AZ6UPEFcjs.Loop; exports.workflow = _chunk5AZ6UPEFcjs.workflow;
+exports.ActorWorkflowContext = _chunk7WF2QSICcjs.ActorWorkflowContext; exports.Loop = _chunk7WF2QSICcjs.Loop; exports.workflow = _chunk7WF2QSICcjs.workflow;
 //# sourceMappingURL=mod.cjs.map

package/dist/tsup/workflow/mod.d.cts

@@ -1,7 +1,7 @@
-import { c as EventSchemaConfig, Q as QueueSchemaConfig, ad as RunContext } from '../config-_gfywqqI.cjs';
+import { c as EventSchemaConfig, Q as QueueSchemaConfig, ad as RunContext } from '../config-iPj5l1bL.cjs';
 import { A as AnyDatabaseProvider } from '../config-BiNoIHRs.cjs';
-import { A as ActorWorkflowContext } from '../context-Bxd8Cx4H.cjs';
-export { W as WorkflowBranchContextOf, a as WorkflowContextOf, b as WorkflowLoopContextOf, c as WorkflowStepContextOf } from '../context-Bxd8Cx4H.cjs';
+import { A as ActorWorkflowContext } from '../context-DzvH1PBK.cjs';
+export { W as WorkflowBranchContextOf, a as WorkflowContextOf, b as WorkflowLoopContextOf, c as WorkflowStepContextOf } from '../context-DzvH1PBK.cjs';
 export { Loop } from '@rivetkit/workflow-engine';
 import 'zod/v4';
 import '@rivetkit/virtual-websocket';

package/dist/tsup/workflow/mod.d.ts

@@ -1,7 +1,7 @@
-import { c as EventSchemaConfig, Q as QueueSchemaConfig, ad as RunContext } from '../config-P3XujgRr.js';
+import { c as EventSchemaConfig, Q as QueueSchemaConfig, ad as RunContext } from '../config-Qj-zLJPc.js';
 import { A as AnyDatabaseProvider } from '../config-BiNoIHRs.js';
-import { A as ActorWorkflowContext } from '../context-uNA4TRn3.js';
-export { W as WorkflowBranchContextOf, a as WorkflowContextOf, b as WorkflowLoopContextOf, c as WorkflowStepContextOf } from '../context-uNA4TRn3.js';
+import { A as ActorWorkflowContext } from '../context-CQCMuHND.js';
+export { W as WorkflowBranchContextOf, a as WorkflowContextOf, b as WorkflowLoopContextOf, c as WorkflowStepContextOf } from '../context-CQCMuHND.js';
 export { Loop } from '@rivetkit/workflow-engine';
 import 'zod/v4';
 import '@rivetkit/virtual-websocket';

package/dist/tsup/workflow/mod.js

@@ -2,10 +2,10 @@ import {
   ActorWorkflowContext,
   Loop,
   workflow
-} from "../chunk-6LHZQSWJ.js";
-import "../chunk-POUBQA6Z.js";
-import "../chunk-MAXIXG56.js";
-import "../chunk-YET3IZD6.js";
+} from "../chunk-WY2SHWXQ.js";
+import "../chunk-S662Y6ZU.js";
+import "../chunk-TADUYCHF.js";
+import "../chunk-EIATSBYZ.js";
 import "../chunk-7HTNH26M.js";
 import "../chunk-424PT5DM.js";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rivetkit",
-  "version": "2.1.3",
+  "version": "2.1.5",
   "description": "Lightweight libraries for building stateful actors on edge platforms",
   "license": "Apache-2.0",
   "keywords": [
@@ -219,11 +219,11 @@
     "vbare": "^0.0.4",
     "@rivetkit/sqlite": "^0.1.1",
     "zod": "^4.1.0",
-    "@rivetkit/engine-runner": "2.1.3",
-    "@rivetkit/traces": "2.1.3",
-    "@rivetkit/sqlite-vfs": "2.1.3",
-    "@rivetkit/virtual-websocket": "2.0.33",
-    "@rivetkit/workflow-engine": "2.1.3"
+    "@rivetkit/engine-runner": "2.1.5",
+    "@rivetkit/traces": "2.1.5",
+    "@rivetkit/workflow-engine": "2.1.5",
+    "@rivetkit/sqlite-vfs": "2.1.5",
+    "@rivetkit/virtual-websocket": "2.0.33"
   },
   "devDependencies": {
     "@bare-ts/tools": "^0.13.0",

package/src/actor/config.ts

@@ -208,9 +208,7 @@ export const ActorConfigSchema = z
 				createVarsTimeout: z.number().positive().default(5000),
 				createConnStateTimeout: z.number().positive().default(5000),
 				onConnectTimeout: z.number().positive().default(5000),
-				// This must be less than engine config > pegboard.actor_stop_threshold
 				onSleepTimeout: z.number().positive().default(5000),
-				// This must be less than engine config > pegboard.actor_stop_threshold
 				onDestroyTimeout: z.number().positive().default(5000),
 				stateSaveInterval: z.number().positive().default(10_000),
 				actionTimeout: z.number().positive().default(60_000),

package/src/actor/instance/mod.ts

@@ -195,6 +195,19 @@ export class ActorInstance<
 	// MARK: - Tracing
 	#traces!: Traces<OtlpExportTraceServiceRequestJson>;
 
+	// MARK: - Driver Overrides
+	/**
+	 * Per-instance config option overrides applied by the driver after creation.
+	 * When set, the effective option value is the minimum of the base config
+	 * value and the override value.
+	 */
+	overrides: {
+		onSleepTimeout?: number;
+		onDestroyTimeout?: number;
+		runStopTimeout?: number;
+		waitUntilTimeout?: number;
+	} = {};
+
 	// MARK: - Constructor
 	constructor(config: ActorConfig<S, CP, CS, V, I, DB, E, Q>) {
 		this.#config = config;
@@ -495,7 +508,7 @@ export class ActorInstance<
 			} catch { }
 
 			// Wait for run handler to complete
-			await this.#waitForRunHandler(this.#config.options.runStopTimeout);
+			await this.#waitForRunHandler(this.overrides.runStopTimeout !== undefined ? Math.min(this.#config.options.runStopTimeout, this.overrides.runStopTimeout) : this.#config.options.runStopTimeout);
 
 			// Call onStop lifecycle
 			if (mode === "sleep") {
@@ -511,7 +524,7 @@ export class ActorInstance<
 
 			// Wait for background tasks
 			await this.#waitBackgroundPromises(
-				this.#config.options.waitUntilTimeout,
+				this.overrides.waitUntilTimeout !== undefined ? Math.min(this.#config.options.waitUntilTimeout, this.overrides.waitUntilTimeout) : this.#config.options.waitUntilTimeout,
 			);
 
 			// Clear timeouts and save state
@@ -1265,7 +1278,7 @@ export class ActorInstance<
 						if (result instanceof Promise) {
 							await deadline(
 								result,
-								this.#config.options.onSleepTimeout,
+								this.overrides.onSleepTimeout !== undefined ? Math.min(this.#config.options.onSleepTimeout, this.overrides.onSleepTimeout) : this.#config.options.onSleepTimeout,
 							);
 						}
 					},
@@ -1297,7 +1310,7 @@ export class ActorInstance<
 						if (result instanceof Promise) {
 							await deadline(
 								result,
-								this.#config.options.onDestroyTimeout,
+								this.overrides.onDestroyTimeout !== undefined ? Math.min(this.#config.options.onDestroyTimeout, this.overrides.onDestroyTimeout) : this.#config.options.onDestroyTimeout,
 							);
 						}
 					},

package/src/actor/router.ts

@@ -20,11 +20,10 @@ import {
 } from "@/common/router";
 import { noopNext } from "@/common/utils";
 import { inspectorLogger } from "@/inspector/log";
-import { timingSafeEqual } from "@/utils/crypto";
-import { getNodeEnv } from "@/utils/env-vars";
-
 import type { RegistryConfig } from "@/registry/config";
 import { type GetUpgradeWebSocket, VERSION } from "@/utils";
+import { timingSafeEqual } from "@/utils/crypto";
+import { isDev } from "@/utils/env-vars";
 import { CONN_DRIVER_SYMBOL } from "./conn/mod";
 import type { ActorDriver } from "./driver";
 import { loggerWithoutContext } from "./log";
@@ -167,14 +166,16 @@ export function createActorRouter(
 	if (config.inspector.enabled) {
 		// Auth middleware for inspector routes
 		const inspectorAuth = async (c: any): Promise<Response | undefined> => {
-			if (getNodeEnv() === "development" && !config.inspector.token()) {
+			if (isDev() && !config.inspector.token()) {
 				inspectorLogger().warn({
 					msg: "RIVET_INSPECTOR_TOKEN is not set, skipping inspector auth in development mode",
 				});
 				return undefined;
 			}
 
-			const userToken = c.req.header("Authorization")?.replace("Bearer ", "");
+			const userToken = c.req
+				.header("Authorization")
+				?.replace("Bearer ", "");
 			if (!userToken) {
 				return c.text("Unauthorized", 401);
 			}
@@ -197,7 +198,9 @@ export function createActorRouter(
 
 			const actor = await actorDriver.loadActor(c.env.actorId);
 			const isStateEnabled = actor.inspector.isStateEnabled();
-			const state = isStateEnabled ? actor.inspector.getStateJson() : undefined;
+			const state = isStateEnabled
+				? actor.inspector.getStateJson()
+				: undefined;
 			return c.json({ state, isStateEnabled });
 		});
 

package/src/driver-test-suite/mod.ts

@@ -17,6 +17,7 @@ import { runActorConnTests } from "./tests/actor-conn";
 import { runActorConnHibernationTests } from "./tests/actor-conn-hibernation";
 import { runActorConnStateTests } from "./tests/actor-conn-state";
 import { runActorDbTests } from "./tests/actor-db";
+import { runConnErrorSerializationTests } from "./tests/conn-error-serialization";
 import { runActorDestroyTests } from "./tests/actor-destroy";
 import { runActorDriverTests } from "./tests/actor-driver";
 import { runActorErrorHandlingTests } from "./tests/actor-error-handling";
@@ -111,6 +112,8 @@ export function runDriverTests(
 
 						runActorConnHibernationTests(driverTestConfig);
 
+						runConnErrorSerializationTests(driverTestConfig);
+
 						runActorDbTests(driverTestConfig);
 
 						runActorDestroyTests(driverTestConfig);

package/src/driver-test-suite/tests/actor-driver.ts

@@ -1,5 +1,6 @@
 import { describe } from "vitest";
 import type { DriverTestConfig } from "../mod";
+import { runActorLifecycleTests } from "./actor-lifecycle";
 import { runActorScheduleTests } from "./actor-schedule";
 import { runActorSleepTests } from "./actor-sleep";
 import { runActorStateTests } from "./actor-state";
@@ -14,5 +15,8 @@ export function runActorDriverTests(driverTestConfig: DriverTestConfig) {
 
 		// Run actor sleep tests
 		runActorSleepTests(driverTestConfig);
+
+		// Run actor lifecycle tests
+		runActorLifecycleTests(driverTestConfig);
 	});
 }

package/src/driver-test-suite/tests/actor-lifecycle.ts

@@ -0,0 +1,157 @@
+import { describe, expect, test } from "vitest";
+import type { DriverTestConfig } from "../mod";
+import { setupDriverTest } from "../utils";
+
+export function runActorLifecycleTests(driverTestConfig: DriverTestConfig) {
+	describe("Actor Lifecycle Tests", () => {
+		test("actor stop during start waits for start to complete", async (c) => {
+			const { client } = await setupDriverTest(c, driverTestConfig);
+
+			const actorKey = `test-stop-during-start-${Date.now()}`;
+
+			// Create actor - this starts the actor
+			const actor = client.startStopRaceActor.getOrCreate([actorKey]);
+
+			// Immediately try to call an action and then destroy
+			// This creates a race where the actor might not be fully started yet
+			const pingPromise = actor.ping();
+
+			// Get actor ID
+			const actorId = await actor.resolve();
+
+			// Destroy immediately while start might still be in progress
+			await actor.destroy();
+
+			// The ping should still complete successfully because destroy waits for start
+			const result = await pingPromise;
+			expect(result).toBe("pong");
+
+			// Verify actor was actually destroyed
+			let destroyed = false;
+			try {
+				await client.startStopRaceActor.getForId(actorId).ping();
+			} catch (err: any) {
+				destroyed = true;
+				expect(err.group).toBe("actor");
+				expect(err.code).toBe("not_found");
+			}
+			expect(destroyed).toBe(true);
+		});
+
+		test("actor stop before actor instantiation completes cleans up handler", async (c) => {
+			const { client } = await setupDriverTest(c, driverTestConfig);
+
+			const actorKey = `test-stop-before-instantiation-${Date.now()}`;
+
+			// Create multiple actors rapidly to increase chance of race
+			const actors = Array.from({ length: 5 }, (_, i) =>
+				client.startStopRaceActor.getOrCreate([
+					`${actorKey}-${i}`,
+				]),
+			);
+
+			// Resolve all actor IDs (this triggers start)
+			const ids = await Promise.all(actors.map((a) => a.resolve()));
+
+			// Immediately destroy all actors
+			await Promise.all(actors.map((a) => a.destroy()));
+
+			// Verify all actors were cleaned up
+			for (const id of ids) {
+				let destroyed = false;
+				try {
+					await client.startStopRaceActor.getForId(id).ping();
+				} catch (err: any) {
+					destroyed = true;
+					expect(err.group).toBe("actor");
+					expect(err.code).toBe("not_found");
+				}
+				expect(destroyed, `actor ${id} should be destroyed`).toBe(
+					true,
+				);
+			}
+		});
+
+		test("onBeforeActorStart completes before stop proceeds", async (c) => {
+			const { client } = await setupDriverTest(c, driverTestConfig);
+
+			const actorKey = `test-before-actor-start-${Date.now()}`;
+
+			// Create actor
+			const actor = client.startStopRaceActor.getOrCreate([actorKey]);
+
+			// Call action to ensure actor is starting
+			const statePromise = actor.getState();
+
+			// Destroy immediately
+			await actor.destroy();
+
+			// State should be initialized because onBeforeActorStart must complete
+			const state = await statePromise;
+			expect(state.initialized).toBe(true);
+			expect(state.startCompleted).toBe(true);
+		});
+
+		test("multiple rapid create/destroy cycles handle race correctly", async (c) => {
+			const { client } = await setupDriverTest(c, driverTestConfig);
+
+			// Perform multiple rapid create/destroy cycles
+			for (let i = 0; i < 10; i++) {
+				const actorKey = `test-rapid-cycle-${Date.now()}-${i}`;
+				const actor = client.startStopRaceActor.getOrCreate([
+					actorKey,
+				]);
+
+				// Trigger start
+				const resolvePromise = actor.resolve();
+
+				// Immediately destroy
+				const destroyPromise = actor.destroy();
+
+				// Both should complete without errors
+				await Promise.all([resolvePromise, destroyPromise]);
+			}
+
+			// If we get here without errors, the race condition is handled correctly
+			expect(true).toBe(true);
+		});
+
+		test("actor stop called with no actor instance cleans up handler", async (c) => {
+			const { client } = await setupDriverTest(c, driverTestConfig);
+
+			const actorKey = `test-cleanup-no-instance-${Date.now()}`;
+
+			// Create and immediately destroy
+			const actor = client.startStopRaceActor.getOrCreate([actorKey]);
+			const id = await actor.resolve();
+			await actor.destroy();
+
+			// Try to recreate with same key - should work without issues
+			const newActor = client.startStopRaceActor.getOrCreate([
+				actorKey,
+			]);
+			const result = await newActor.ping();
+			expect(result).toBe("pong");
+
+			// Clean up
+			await newActor.destroy();
+		});
+
+		test("onDestroy is called even when actor is destroyed during start", async (c) => {
+			const { client } = await setupDriverTest(c, driverTestConfig);
+
+			const actorKey = `test-ondestroy-during-start-${Date.now()}`;
+
+			// Create actor
+			const actor = client.startStopRaceActor.getOrCreate([actorKey]);
+
+			// Start and immediately destroy
+			const statePromise = actor.getState();
+			await actor.destroy();
+
+			// Verify onDestroy was called (requires actor to be started)
+			const state = await statePromise;
+			expect(state.destroyCalled).toBe(true);
+		});
+	});
+}

package/src/driver-test-suite/tests/conn-error-serialization.ts

@@ -0,0 +1,64 @@
+import { describe, expect, test } from "vitest";
+import type { DriverTestConfig } from "../mod";
+import { setupDriverTest } from "../utils";
+
+export function runConnErrorSerializationTests(driverTestConfig: DriverTestConfig) {
+	describe("Connection Error Serialization Tests", () => {
+		test("error thrown in createConnState preserves group and code through WebSocket serialization", async (c) => {
+			const { client } = await setupDriverTest(c, driverTestConfig);
+
+			const actorKey = `test-error-serialization-${Date.now()}`;
+
+			// Create actor handle with params that will trigger error in createConnState
+			const actor = client.connErrorSerializationActor.getOrCreate(
+				[actorKey],
+				{ params: { shouldThrow: true } },
+			);
+
+			// Try to connect, which will trigger error in createConnState
+			const conn = actor.connect();
+
+			// Wait for connection to fail
+			let caughtError: any;
+			try {
+				// Try to call an action, which should fail because connection couldn't be established
+				await conn.getValue();
+			} catch (err) {
+				caughtError = err;
+			}
+
+			// Verify the error was caught
+			expect(caughtError).toBeDefined();
+
+			// Verify the error has the correct group and code from the original error
+			// Original error: new CustomConnectionError("...") with group="connection", code="custom_error"
+			expect(caughtError.group).toBe("connection");
+			expect(caughtError.code).toBe("custom_error");
+
+			// Clean up
+			await conn.dispose();
+		});
+
+		test("successful createConnState does not throw error", async (c) => {
+			const { client } = await setupDriverTest(c, driverTestConfig);
+
+			const actorKey = `test-no-error-${Date.now()}`;
+
+			// Create actor handle with params that will NOT trigger error
+			const actor = client.connErrorSerializationActor.getOrCreate(
+				[actorKey],
+				{ params: { shouldThrow: false } },
+			);
+
+			// Connect without triggering error
+			const conn = actor.connect();
+
+			// This should succeed
+			const value = await conn.getValue();
+			expect(value).toBe(0);
+
+			// Clean up
+			await conn.dispose();
+		});
+	});
+}