rivetkit 2.0.4 → 2.0.6

package/src/registry/mod.ts

@@ -1,4 +1,3 @@
-import type { Hono } from "hono";
 import { type Client, createClientWithDriver } from "@/client/client";
 import { configureBaseLogger, configureDefaultLogger } from "@/common/log";
 import { chooseDefaultDriver } from "@/drivers/default";
@@ -21,12 +20,10 @@ import {
 import { crossPlatformServe } from "./serve";
 
 interface ServerOutput<A extends Registry<any>> {
-	config: RunConfig;
-	driver: DriverConfig;
+	/** Client to communicate with the actors. */
 	client: Client<A>;
-	hono: Hono;
-	handler: (req: Request) => Promise<Response>;
-	serve: (hono?: Hono) => void;
+	/** Fetch handler to manually route requests to the Rivet manager API. */
+	fetch: (request: Request, ...args: any) => Response | Promise<Response>;
 }
 
 export class Registry<A extends RegistryActors> {
@@ -43,7 +40,7 @@ export class Registry<A extends RegistryActors> {
 	/**
 	 * Runs the registry for a server.
 	 */
-	public createServer(inputConfig?: RunConfigInput): ServerOutput<this> {
+	public start(inputConfig?: RunConfigInput): ServerOutput<this> {
 		const config = RunConfigSchema.parse(inputConfig);
 
 		// Configure logger
@@ -62,6 +59,13 @@ export class Registry<A extends RegistryActors> {
 		// TODO: Find cleaner way of disabling by default
 		if (driver.name === "engine") {
 			config.inspector.enabled = false;
+			config.disableServer = true;
+		}
+		if (driver.name === "cloudflare-workers") {
+			config.inspector.enabled = false;
+			config.disableServer = true;
+			config.disableActorDriver = true;
+			config.noWelcome = true;
 		}
 
 		// Configure getUpgradeWebSocket lazily so we can assign it in crossPlatformServe
@@ -109,41 +113,32 @@ export class Registry<A extends RegistryActors> {
 			console.log();
 		}
 
+		// HACK: We need to find a better way to let the driver itself decide when to start the actor driver
 		// Create runner
 		//
 		// Even though we do not use the return value, this is required to start the code that will handle incoming actors
-		const _actorDriver = driver.actor(
-			this.#config,
-			config,
-			managerDriver,
-			client,
-		);
+		if (!config.disableActorDriver) {
+			const _actorDriver = driver.actor(
+				this.#config,
+				config,
+				managerDriver,
+				client,
+			);
+		}
+
+		// Start server
+		if (!config.disableServer) {
+			(async () => {
+				const out = await crossPlatformServe(hono, undefined);
+				upgradeWebSocket = out.upgradeWebSocket;
+			})();
+		}
 
 		return {
-			config,
-			driver,
 			client,
-			hono,
-			handler: async (req: Request) => await hono.fetch(req),
-			serve: async (app) => {
-				const out = await crossPlatformServe(hono, app);
-				upgradeWebSocket = out.upgradeWebSocket;
-			},
+			fetch: hono.fetch.bind(hono),
 		};
 	}
-
-	/**
-	 * Runs the registry as a standalone server.
-	 */
-	public async runServer(inputConfig?: RunConfigInput) {
-		const { driver, serve } = this.createServer(inputConfig);
-
-		// TODO: FInd better way of doing this
-		// Don't run server by default
-		if (driver.name !== "engine") {
-			serve();
-		}
-	}
 }
 
 export function setup<A extends RegistryActors>(
@@ -153,5 +148,11 @@ export function setup<A extends RegistryActors>(
 	return new Registry(config);
 }
 
-export type { RegistryConfig, RegistryActors, RunConfig, DriverConfig };
+export type {
+	RegistryConfig,
+	RegistryActors,
+	RunConfig,
+	RunConfigInput,
+	DriverConfig,
+};
 export { RegistryConfigSchema };

package/src/registry/run-config.ts

@@ -29,16 +29,31 @@ export const RunConfigSchema = ClientConfigSchema.extend({
 
 	inspector: InspectorConfigSchema,
 
+	/** @experimental */
+	disableServer: z.boolean().optional().default(false),
+
+	/** @experimental */
+	disableActorDriver: z.boolean().optional().default(false),
+
 	/**
+	 * @experimental
+	 *
 	 * Base path for the router. This is used to prefix all routes.
 	 * For example, if the base path is `/api`, then the route `/actors` will be
 	 * available at `/api/actors`.
 	 */
 	basePath: z.string().optional().default("/"),
 
-	/** Disable welcome message. */
+	/**
+	 * @experimental
+	 *
+	 * Disable welcome message.
+	 * */
 	noWelcome: z.boolean().optional().default(false),
 
+	/**
+	 * @experimental
+	 * */
 	logging: z
 		.object({
 			baseLogger: z.custom<Logger>().optional(),

package/src/registry/serve.ts

@@ -1,5 +1,4 @@
 import { Hono } from "hono";
-import { getEnvUniversal } from "@/utils";
 import { logger } from "./log";
 
 export async function crossPlatformServe(
@@ -11,7 +10,10 @@ export async function crossPlatformServe(
 	// Import @hono/node-server
 	let serve: any;
 	try {
-		const dep = await import("@hono/node-server");
+		const dep = await import(
+			/* webpackIgnore: true */
+			"@hono/node-server"
+		);
 		serve = dep.serve;
 	} catch (err) {
 		logger().error(
@@ -27,7 +29,10 @@ export async function crossPlatformServe(
 	// Import @hono/node-ws
 	let createNodeWebSocket: any;
 	try {
-		const dep = await import("@hono/node-ws");
+		const dep = await import(
+			/* webpackIgnore: true */
+			"@hono/node-ws"
+		);
 		createNodeWebSocket = dep.createNodeWebSocket;
 	} catch (err) {
 		logger().error(

package/src/remote-manager-driver/actor-http-client.ts

@@ -1,4 +1,5 @@
 import type { ClientConfig } from "@/client/config";
+import { combineUrlPath } from "@/utils";
 import { getEndpoint } from "./api-utils";
 
 export async function sendHttpRequestToActor(
@@ -9,7 +10,7 @@ export async function sendHttpRequestToActor(
 	// Route through guard port
 	const url = new URL(actorRequest.url);
 	const endpoint = getEndpoint(runConfig);
-	const guardUrl = `${endpoint}${url.pathname}${url.search}`;
+	const guardUrl = combineUrlPath(endpoint, url.pathname + url.search);
 
 	// Handle body properly based on method and presence
 	let bodyToSend: ArrayBuffer | null = null;
@@ -43,6 +44,7 @@ export async function sendHttpRequestToActor(
 		method: actorRequest.method,
 		headers: guardHeaders,
 		body: bodyToSend,
+		signal: actorRequest.signal,
 	});
 
 	return mutableResponse(await fetch(guardRequest));

package/src/remote-manager-driver/actor-websocket-client.ts

@@ -1,11 +1,12 @@
+import type { ClientConfig } from "@/client/config";
 import {
 	HEADER_AUTH_DATA,
 	HEADER_CONN_PARAMS,
 	HEADER_ENCODING,
-} from "@/actor/router-endpoints";
-import type { ClientConfig } from "@/client/config";
+} from "@/common/actor-router-consts";
 import { importWebSocket } from "@/common/websocket";
 import type { Encoding, UniversalWebSocket } from "@/mod";
+import { combineUrlPath } from "@/utils";
 import { getEndpoint } from "./api-utils";
 import { logger } from "./log";
 
@@ -20,7 +21,7 @@ export async function openWebSocketToActor(
 
 	// WebSocket connections go through guard
 	const endpoint = getEndpoint(runConfig);
-	const guardUrl = `${endpoint}${path}`;
+	const guardUrl = combineUrlPath(endpoint, path);
 
 	logger().debug({
 		msg: "opening websocket to actor via guard",

package/src/remote-manager-driver/api-utils.ts

@@ -1,5 +1,6 @@
 import type { ClientConfig } from "@/client/config";
 import { sendHttpRequest } from "@/client/utils";
+import { combineUrlPath } from "@/utils";
 import { logger } from "./log";
 
 // Error class for Engine API errors
@@ -26,7 +27,9 @@ export async function apiCall<TInput = unknown, TOutput = unknown>(
 	body?: TInput,
 ): Promise<TOutput> {
 	const endpoint = getEndpoint(config);
-	const url = `${endpoint}${path}${path.includes("?") ? "&" : "?"}namespace=${encodeURIComponent(config.namespace)}`;
+	const url = combineUrlPath(endpoint, path, {
+		namespace: config.namespace,
+	});
 
 	logger().debug({ msg: "making api call", method, url });
 

package/src/remote-manager-driver/mod.ts

@@ -1,7 +1,6 @@
 import * as cbor from "cbor-x";
-import type { Hono, Context as HonoContext } from "hono";
+import type { Context as HonoContext } from "hono";
 import invariant from "invariant";
-import { ActorAlreadyExists } from "@/actor/errors";
 import { deserializeActorKey, serializeActorKey } from "@/actor/keys";
 import type { ClientConfig } from "@/client/client";
 import { noopNext } from "@/common/utils";
@@ -14,9 +13,8 @@ import type {
 	ManagerDisplayInformation,
 	ManagerDriver,
 } from "@/driver-helpers/mod";
-import type { ManagerInspector } from "@/inspector/manager";
-import type { Encoding, RegistryConfig, UniversalWebSocket } from "@/mod";
-import type { RunConfig } from "@/registry/run-config";
+import type { Encoding, UniversalWebSocket } from "@/mod";
+import { combineUrlPath } from "@/utils";
 import { sendHttpRequestToActor } from "./actor-http-client";
 import {
 	buildGuardHeadersForWebSocket,
@@ -246,7 +244,7 @@ export class RemoteManagerDriver implements ManagerDriver {
 		invariant(upgradeWebSocket, "missing getUpgradeWebSocket");
 
 		const endpoint = getEndpoint(this.#config);
-		const guardUrl = `${endpoint}${path}`;
+		const guardUrl = combineUrlPath(endpoint, path);
 		const wsGuardUrl = guardUrl.replace("http://", "ws://");
 
 		logger().debug({

package/src/utils.ts

@@ -170,3 +170,56 @@ export function bufferToArrayBuffer(buf: Buffer | Uint8Array): ArrayBuffer {
 		buf.byteOffset + buf.byteLength,
 	) as ArrayBuffer;
 }
+
+/**
+ * Properly combines a base URL endpoint with a path, preserving any base path in the endpoint.
+ *
+ * @example
+ * combineUrlPath("http://localhost:8787/rivet", "/actors/action")
+ * // Returns: "http://localhost:8787/rivet/actors/action"
+ *
+ * @example
+ * combineUrlPath("http://localhost:8787/rivet", "/actors?type=foo", { namespace: "test" })
+ * // Returns: "http://localhost:8787/rivet/actors?type=foo&namespace=test"
+ *
+ * @param endpoint The base URL endpoint that may contain a path component
+ * @param path The path to append to the endpoint (may include query parameters)
+ * @param queryParams Optional additional query parameters to append
+ * @returns The properly combined URL string
+ */
+export function combineUrlPath(
+	endpoint: string,
+	path: string,
+	queryParams?: Record<string, string | undefined>,
+): string {
+	const baseUrl = new URL(endpoint);
+
+	// Extract path and query from the provided path
+	const pathParts = path.split("?");
+	const pathOnly = pathParts[0];
+	const existingQuery = pathParts[1] || "";
+
+	// Remove trailing slash from base path and ensure path starts with /
+	const basePath = baseUrl.pathname.replace(/\/$/, "");
+	const cleanPath = pathOnly.startsWith("/") ? pathOnly : `/${pathOnly}`;
+	// Combine paths and remove any double slashes
+	const fullPath = (basePath + cleanPath).replace(/\/\//g, "/");
+
+	// Build query string
+	const queryParts: string[] = [];
+	if (existingQuery) {
+		queryParts.push(existingQuery);
+	}
+	if (queryParams) {
+		for (const [key, value] of Object.entries(queryParams)) {
+			if (value !== undefined) {
+				queryParts.push(
+					`${encodeURIComponent(key)}=${encodeURIComponent(value)}`,
+				);
+			}
+		}
+	}
+
+	const fullQuery = queryParts.length > 0 ? `?${queryParts.join("&")}` : "";
+	return `${baseUrl.protocol}//${baseUrl.host}${fullPath}${fullQuery}`;
+}

package/dist/tsup/chunk-4R73YDN3.cjs

@@ -1,20 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-
-var _chunkVO7ZRVVDcjs = require('./chunk-VO7ZRVVD.cjs');
-
-
-var _chunkWHBPJNGWcjs = require('./chunk-WHBPJNGW.cjs');
-
-// src/client/mod.ts
-function createClient(endpointOrConfig) {
-  const configInput = endpointOrConfig === void 0 ? {} : typeof endpointOrConfig === "string" ? { engine: endpointOrConfig } : endpointOrConfig;
-  const config = _chunkWHBPJNGWcjs.ClientConfigSchema.parse(configInput);
-  const driver = new (0, _chunkVO7ZRVVDcjs.RemoteManagerDriver)(config);
-  return _chunkVO7ZRVVDcjs.createClientWithDriver.call(void 0, driver, config);
-}
-
-
-
-exports.createClient = createClient;
-//# sourceMappingURL=chunk-4R73YDN3.cjs.map

package/dist/tsup/chunk-6LJT3QRL.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/Users/nathan/rivetkit/packages/rivetkit/dist/tsup/chunk-6LJT3QRL.cjs","../../src/common/utils.ts","../../package.json","../../src/utils.ts"],"names":[],"mappings":"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,QAAA;AACb,MAAA;AACW,MAAA;AACA,QAAA;AACE,QAAA;AACb,MAAA;AACF,IAAA;AACY,IAAA;AACA,MAAA;AACC,QAAA;AACE,QAAA;AACb,MAAA;AACW,MAAA;AACA,QAAA;AACE,QAAA;AACb,MAAA;AACF,IAAA;AACS,IAAA;AACG,MAAA;AACC,QAAA;AACE,QAAA;AACb,MAAA;AACW,MAAA;AACA,QAAA;AACE,QAAA;AACb,MAAA;AACF,IAAA;AACY,IAAA;AACA,MAAA;AACC,QAAA;AACE,QAAA;AACb,MAAA;AACW,MAAA;AACA,QAAA;AACE,QAAA;AACb,MAAA;AACF,IAAA;AACW,IAAA;AACC,MAAA;AACC,QAAA;AACE,QAAA;AACb,MAAA;AACW,MAAA;AACA,QAAA;AACE,QAAA;AACb,MAAA;AACF,IAAA;AACoB,IAAA;AACR,MAAA;AACC,QAAA;AACE,QAAA;AACb,MAAA;AACW,MAAA;AACA,QAAA;AACE,QAAA;AACb,MAAA;AACF,IAAA;AAC8B,IAAA;AAClB,MAAA;AACC,QAAA;AACE,QAAA;AACb,MAAA;AACW,MAAA;AACA,QAAA;AACE,QAAA;AACb,MAAA;AACF,IAAA;AACuB,IAAA;AACX,MAAA;AACC,QAAA;AACE,QAAA;AACb,MAAA;AACW,MAAA;AACA,QAAA;AACE,QAAA;AACb,MAAA;AACF,IAAA;AAC2B,IAAA;AACf,MAAA;AACC,QAAA;AACE,QAAA;AACb,MAAA;AACW,MAAA;AACA,QAAA;AACE,QAAA;AACb,MAAA;AACF,IAAA;AAC0B,IAAA;AACd,MAAA;AACC,QAAA;AACE,QAAA;AACb,MAAA;AACW,MAAA;AACA,QAAA;AACE,QAAA;AACb,MAAA;AACF,IAAA;AACU,IAAA;AACE,MAAA;AACC,QAAA;AACE,QAAA;AACb,MAAA;AACW,MAAA;AACA,QAAA;AACE,QAAA;AACb,MAAA;AACF,IAAA;AACe,IAAA;AACH,MAAA;AACC,QAAA;AACE,QAAA;AACb,MAAA;AACW,MAAA;AACA,QAAA;AACE,QAAA;AACb,MAAA;AACF,IAAA;AACF,EAAA;AACW,EAAA;AACD,IAAA;AACV,EAAA;AACe,EAAA;AACJ,EAAA;AACA,IAAA;AACO,IAAA;AACD,IAAA;AACP,IAAA;AACM,IAAA;AACE,IAAA;AAClB,EAAA;AACgB,EAAA;AACE,IAAA;AACY,IAAA;AACP,IAAA;AACM,IAAA;AACE,IAAA;AACnB,IAAA;AACF,IAAA;AACK,IAAA;AACC,IAAA;AACD,IAAA;AACL,IAAA;AACG,IAAA;AACJ,IAAA;AACT,EAAA;AACmB,EAAA;AACC,IAAA;AACG,IAAA;AACJ,IAAA;AACG,IAAA;AACL,IAAA;AACF,IAAA;AACC,IAAA;AACI,IAAA;AACH,IAAA;AACP,IAAA;AACD,IAAA;AACO,IAAA;AACJ,IAAA;AACJ,IAAA;AACR,EAAA;AACoB,EAAA;AACG,IAAA;AACJ,IAAA;AACF,IAAA;AACT,IAAA;AACR,EAAA;AACwB,EAAA;AACD,IAAA;AACP,MAAA;AACd,IAAA;AACiB,IAAA;AACH,MAAA;AACd,IAAA;AACe,IAAA;AACD,MAAA;AACd,IAAA;AACM,IAAA;AACQ,MAAA;AACd,IAAA;AACF,EAAA;AACiB,EAAA;AACnB;AFiNyC;AACA;AG7ZV;AAE3B;AAEoC;AAET,EAAA;AACtB,IAAA;AACR,EAAA;AAGmC,EAAA;AAGP,EAAA;AACxB,EAAA;AAES,EAAA;AAEN,EAAA;AACR;AAMiE;AAC/B,EAAA;AACT,IAAA;AACM,EAAA;AAEP,IAAA;AACvB,EAAA;AACD;AAEgC;AACjB,EAAA;AAAqB;AAC5B,EAAA;AACR;AAS8E;AAC7C,EAAA;AACxB,IAAA;AACmB,EAAA;AACA,IAAA;AACU,EAAA;AAEzB,IAAA;AACyB,MAAA;AACpC,IAAA;AACM,EAAA;AACc,IAAA;AACrB,EAAA;AACD;AAQoB;AAOC;AAChB,EAAA;AAE8B,EAAA;AACH,IAAA;AACE,MAAA;AACzB,IAAA;AACqB,MAAA;AACG,QAAA;AAChB,MAAA;AACf,IAAA;AACD,EAAA;AAEW,EAAA;AAEJ,EAAA;AACO,IAAA;AACe,MAAA;AAC5B,IAAA;AACD,EAAA;AACD;AAOgC;AAAA;AAE/B,EAAA;AAAA;AAGA,EAAA;AAAA;AAGA,EAAA;AAAA;AAGgD,EAAA;AAE9B,IAAA;AAGG,IAAA;AACK,MAAA;AACzB,IAAA;AAE8B,IAAA;AAGF,IAAA;AACE,MAAA;AAC9B,IAAA;AAEO,IAAA;AACR,EAAA;AAAA;AAGkC,EAAA;AAC7B,IAAA;AACoB,MAAA;AAEA,QAAA;AACN,QAAA;AAGA,QAAA;AACC,QAAA;AAEb,QAAA;AACM,UAAA;AACF,QAAA;AAER,QAAA;AAGA,QAAA;AACD,MAAA;AACC,IAAA;AACuB,MAAA;AACzB,IAAA;AACD,EAAA;AACD;AAE2E;AACxD,EAAA;AACb,IAAA;AACiB,IAAA;AACtB,EAAA;AACD;AH8VyC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA","file":"/Users/nathan/rivetkit/packages/rivetkit/dist/tsup/chunk-6LJT3QRL.cjs","sourcesContent":[null,"import type { Next } from \"hono\";\nimport type { ContentfulStatusCode } from \"hono/utils/http-status\";\nimport * as errors from \"@/actor/errors\";\nimport { getEnvUniversal } from \"@/utils\";\nimport type { Logger } from \"./log\";\n\nexport function assertUnreachable(x: never): never {\n\tthrow new Error(`Unreachable case: ${x}`);\n}\n\n/**\n * Safely stringifies an object, ensuring that the stringified object is under a certain size.\n * @param obj any object to stringify\n * @param maxSize maximum size of the stringified object in bytes\n * @returns stringified object\n */\nexport function safeStringify(obj: unknown, maxSize: number) {\n\tlet size = 0;\n\n\tfunction replacer(key: string, value: unknown) {\n\t\tif (value === null || value === undefined) return value;\n\t\tconst valueSize =\n\t\t\ttypeof value === \"string\" ? value.length : JSON.stringify(value).length;\n\t\tsize += key.length + valueSize;\n\n\t\tif (size > maxSize) {\n\t\t\tthrow new Error(`JSON object exceeds size limit of ${maxSize} bytes.`);\n\t\t}\n\n\t\treturn value;\n\t}\n\n\treturn JSON.stringify(obj, replacer);\n}\n\n// TODO: Instead of doing this, use a temp var for state and attempt to write\n// it. Roll back state if fails to serialize.\n\n/**\n * Check if a value is CBOR serializable.\n * Optionally pass an onInvalid callback to receive the path to invalid values.\n *\n * For a complete list of supported CBOR tags, see:\n * https://github.com/kriszyp/cbor-x/blob/cc1cf9df8ba72288c7842af1dd374d73e34cdbc1/README.md#list-of-supported-tags-for-decoding\n */\nexport function isCborSerializable(\n\tvalue: unknown,\n\tonInvalid?: (path: string) => void,\n\tcurrentPath = \"\",\n): boolean {\n\t// Handle primitive types directly\n\tif (value === null || value === undefined) {\n\t\treturn true;\n\t}\n\n\tif (typeof value === \"number\") {\n\t\tif (!Number.isFinite(value)) {\n\t\t\tonInvalid?.(currentPath);\n\t\t\treturn false;\n\t\t}\n\t\treturn true;\n\t}\n\n\tif (typeof value === \"boolean\" || typeof value === \"string\") {\n\t\treturn true;\n\t}\n\n\t// Handle BigInt (CBOR tags 2 and 3)\n\tif (typeof value === \"bigint\") {\n\t\treturn true;\n\t}\n\n\t// Handle Date objects (CBOR tags 0 and 1)\n\tif (value instanceof Date) {\n\t\treturn true;\n\t}\n\n\t// Handle typed arrays (CBOR tags 64-82)\n\tif (\n\t\tvalue instanceof Uint8Array ||\n\t\tvalue instanceof Uint8ClampedArray ||\n\t\tvalue instanceof Uint16Array ||\n\t\tvalue instanceof Uint32Array ||\n\t\tvalue instanceof BigUint64Array ||\n\t\tvalue instanceof Int8Array ||\n\t\tvalue instanceof Int16Array ||\n\t\tvalue instanceof Int32Array ||\n\t\tvalue instanceof BigInt64Array ||\n\t\tvalue instanceof Float32Array ||\n\t\tvalue instanceof Float64Array\n\t) {\n\t\treturn true;\n\t}\n\n\t// Handle Map (CBOR tag 259)\n\tif (value instanceof Map) {\n\t\tfor (const [key, val] of value.entries()) {\n\t\t\tconst keyPath = currentPath\n\t\t\t\t? `${currentPath}.key(${String(key)})`\n\t\t\t\t: `key(${String(key)})`;\n\t\t\tconst valPath = currentPath\n\t\t\t\t? `${currentPath}.value(${String(key)})`\n\t\t\t\t: `value(${String(key)})`;\n\t\t\tif (\n\t\t\t\t!isCborSerializable(key, onInvalid, keyPath) ||\n\t\t\t\t!isCborSerializable(val, onInvalid, valPath)\n\t\t\t) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t}\n\t\treturn true;\n\t}\n\n\t// Handle Set (CBOR tag 258)\n\tif (value instanceof Set) {\n\t\tlet index = 0;\n\t\tfor (const item of value.values()) {\n\t\t\tconst itemPath = currentPath\n\t\t\t\t? `${currentPath}.set[${index}]`\n\t\t\t\t: `set[${index}]`;\n\t\t\tif (!isCborSerializable(item, onInvalid, itemPath)) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\tindex++;\n\t\t}\n\t\treturn true;\n\t}\n\n\t// Handle RegExp (CBOR tag 27)\n\tif (value instanceof RegExp) {\n\t\treturn true;\n\t}\n\n\t// Handle Error objects (CBOR tag 27)\n\tif (value instanceof Error) {\n\t\treturn true;\n\t}\n\n\t// Handle arrays\n\tif (Array.isArray(value)) {\n\t\tfor (let i = 0; i < value.length; i++) {\n\t\t\tconst itemPath = currentPath ? `${currentPath}[${i}]` : `[${i}]`;\n\t\t\tif (!isCborSerializable(value[i], onInvalid, itemPath)) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t}\n\t\treturn true;\n\t}\n\n\t// Handle plain objects and records (CBOR tags 105, 51, 57344-57599)\n\tif (typeof value === \"object\") {\n\t\t// Allow plain objects and objects with prototypes (for records and named objects)\n\t\tconst proto = Object.getPrototypeOf(value);\n\t\tif (proto !== null && proto !== Object.prototype) {\n\t\t\t// Check if it's a known serializable object type\n\t\t\tconst protoConstructor = value.constructor;\n\t\t\tif (protoConstructor && typeof protoConstructor.name === \"string\") {\n\t\t\t\t// Allow objects with named constructors (records, named objects)\n\t\t\t\t// This includes user-defined classes and built-in objects\n\t\t\t\t// that CBOR can serialize with tag 27 or record tags\n\t\t\t}\n\t\t}\n\n\t\t// Check all properties recursively\n\t\tfor (const key in value) {\n\t\t\tconst propPath = currentPath ? `${currentPath}.${key}` : key;\n\t\t\tif (\n\t\t\t\t!isCborSerializable(\n\t\t\t\t\tvalue[key as keyof typeof value],\n\t\t\t\t\tonInvalid,\n\t\t\t\t\tpropPath,\n\t\t\t\t)\n\t\t\t) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t}\n\t\treturn true;\n\t}\n\n\t// Not serializable\n\tonInvalid?.(currentPath);\n\treturn false;\n}\n\nexport interface DeconstructedError {\n\t__type: \"ActorError\";\n\tstatusCode: ContentfulStatusCode;\n\tpublic: boolean;\n\tgroup: string;\n\tcode: string;\n\tmessage: string;\n\tmetadata?: unknown;\n}\n\n/** Deconstructs error in to components that are used to build responses. */\nexport function deconstructError(\n\terror: unknown,\n\tlogger: Logger,\n\textraLog: Record<string, unknown>,\n\texposeInternalError = false,\n): DeconstructedError {\n\t// Build response error information. Only return errors if flagged as public in order to prevent leaking internal behavior.\n\t//\n\t// We log the error here instead of after generating the code & message because we need to log the original error, not the masked internal error.\n\tlet statusCode: ContentfulStatusCode;\n\tlet public_: boolean;\n\tlet group: string;\n\tlet code: string;\n\tlet message: string;\n\tlet metadata: unknown;\n\tif (errors.ActorError.isActorError(error) && error.public) {\n\t\t// Check if error has statusCode (could be ActorError instance or DeconstructedError)\n\t\tstatusCode = (\n\t\t\t\"statusCode\" in error && error.statusCode ? error.statusCode : 400\n\t\t) as ContentfulStatusCode;\n\t\tpublic_ = true;\n\t\tgroup = error.group;\n\t\tcode = error.code;\n\t\tmessage = getErrorMessage(error);\n\t\tmetadata = error.metadata;\n\n\t\tlogger.info({\n\t\t\tmsg: \"public error\",\n\t\t\tgroup,\n\t\t\tcode,\n\t\t\tmessage,\n\t\t\tissues: \"https://github.com/rivet-dev/rivetkit/issues\",\n\t\t\tsupport: \"https://rivet.dev/discord\",\n\t\t\t...extraLog,\n\t\t});\n\t} else if (exposeInternalError) {\n\t\tif (errors.ActorError.isActorError(error)) {\n\t\t\tstatusCode = 500;\n\t\t\tpublic_ = false;\n\t\t\tgroup = error.group;\n\t\t\tcode = error.code;\n\t\t\tmessage = getErrorMessage(error);\n\t\t\tmetadata = error.metadata;\n\n\t\t\tlogger.info({\n\t\t\t\tmsg: \"internal error\",\n\t\t\t\tgroup,\n\t\t\t\tcode,\n\t\t\t\tmessage,\n\t\t\t\tissues: \"https://github.com/rivet-dev/rivetkit/issues\",\n\t\t\t\tsupport: \"https://rivet.dev/discord\",\n\t\t\t\t...extraLog,\n\t\t\t});\n\t\t} else {\n\t\t\tstatusCode = 500;\n\t\t\tpublic_ = false;\n\t\t\tgroup = \"internal\";\n\t\t\tcode = errors.INTERNAL_ERROR_CODE;\n\t\t\tmessage = getErrorMessage(error);\n\n\t\t\tlogger.info({\n\t\t\t\tmsg: \"internal error\",\n\t\t\t\tgroup,\n\t\t\t\tcode,\n\t\t\t\tmessage,\n\t\t\t\tissues: \"https://github.com/rivet-dev/rivetkit/issues\",\n\t\t\t\tsupport: \"https://rivet.dev/discord\",\n\t\t\t\t...extraLog,\n\t\t\t});\n\t\t}\n\t} else {\n\t\tstatusCode = 500;\n\t\tpublic_ = false;\n\t\tgroup = \"internal\";\n\t\tcode = errors.INTERNAL_ERROR_CODE;\n\t\tmessage = errors.INTERNAL_ERROR_DESCRIPTION;\n\t\tmetadata = {\n\t\t\t//url: `https://hub.rivet.dev/projects/${actorMetadata.project.slug}/environments/${actorMetadata.environment.slug}/actors?actorId=${actorMetadata.actor.id}`,\n\t\t} satisfies errors.InternalErrorMetadata;\n\n\t\tlogger.warn({\n\t\t\tmsg: \"internal error\",\n\t\t\terror: getErrorMessage(error),\n\t\t\tstack: (error as Error)?.stack,\n\t\t\tissues: \"https://github.com/rivet-dev/rivetkit/issues\",\n\t\t\tsupport: \"https://rivet.dev/discord\",\n\t\t\t...extraLog,\n\t\t});\n\t}\n\n\treturn {\n\t\t__type: \"ActorError\",\n\t\tstatusCode,\n\t\tpublic: public_,\n\t\tgroup,\n\t\tcode,\n\t\tmessage,\n\t\tmetadata,\n\t};\n}\n\nexport function stringifyError(error: unknown): string {\n\tif (error instanceof Error) {\n\t\tif (\n\t\t\ttypeof process !== \"undefined\" &&\n\t\t\tgetEnvUniversal(\"_RIVETKIT_ERROR_STACK\") === \"1\"\n\t\t) {\n\t\t\treturn `${error.name}: ${error.message}${error.stack ? `\\n${error.stack}` : \"\"}`;\n\t\t} else {\n\t\t\treturn `${error.name}: ${error.message}`;\n\t\t}\n\t} else if (typeof error === \"string\") {\n\t\treturn error;\n\t} else if (typeof error === \"object\" && error !== null) {\n\t\ttry {\n\t\t\treturn `${JSON.stringify(error)}`;\n\t\t} catch {\n\t\t\treturn \"[cannot stringify error]\";\n\t\t}\n\t} else {\n\t\treturn `Unknown error: ${getErrorMessage(error)}`;\n\t}\n}\n\nfunction getErrorMessage(err: unknown): string {\n\tif (\n\t\terr &&\n\t\ttypeof err === \"object\" &&\n\t\t\"message\" in err &&\n\t\ttypeof err.message === \"string\"\n\t) {\n\t\treturn err.message;\n\t} else {\n\t\treturn String(err);\n\t}\n}\n\n/** Generates a `Next` handler to pass to middleware in order to be able to call arbitrary middleware. */\nexport function noopNext(): Next {\n\treturn async () => {};\n}\n","{\n  \"name\": \"rivetkit\",\n  \"version\": \"2.0.4\",\n  \"description\": \"Lightweight libraries for building stateful actors on edge platforms\",\n  \"license\": \"Apache-2.0\",\n  \"keywords\": [\n    \"rivetkit\",\n    \"stateful\",\n    \"serverless\",\n    \"actors\",\n    \"agents\",\n    \"realtime\",\n    \"websocket\",\n    \"actors\",\n    \"framework\"\n  ],\n  \"files\": [\n    \"dist\",\n    \"src\",\n    \"deno.json\",\n    \"bun.json\",\n    \"package.json\"\n  ],\n  \"type\": \"module\",\n  \"exports\": {\n    \".\": {\n      \"import\": {\n        \"types\": \"./dist/tsup/mod.d.ts\",\n        \"default\": \"./dist/tsup/mod.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/tsup/mod.d.cts\",\n        \"default\": \"./dist/tsup/mod.cjs\"\n      }\n    },\n    \"./client\": {\n      \"import\": {\n        \"types\": \"./dist/tsup/client/mod.d.ts\",\n        \"default\": \"./dist/tsup/client/mod.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/tsup/client/mod.d.cts\",\n        \"default\": \"./dist/tsup/client/mod.cjs\"\n      }\n    },\n    \"./log\": {\n      \"import\": {\n        \"types\": \"./dist/tsup/common/log.d.ts\",\n        \"default\": \"./dist/tsup/common/log.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/tsup/common/log.d.cts\",\n        \"default\": \"./dist/tsup/common/log.cjs\"\n      }\n    },\n    \"./errors\": {\n      \"import\": {\n        \"types\": \"./dist/tsup/actor/errors.d.ts\",\n        \"default\": \"./dist/tsup/actor/errors.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/tsup/actor/errors.d.cts\",\n        \"default\": \"./dist/tsup/actor/errors.cjs\"\n      }\n    },\n    \"./utils\": {\n      \"import\": {\n        \"types\": \"./dist/tsup/utils.d.ts\",\n        \"default\": \"./dist/tsup/utils.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/tsup/utils.d.cts\",\n        \"default\": \"./dist/tsup/utils.cjs\"\n      }\n    },\n    \"./driver-helpers\": {\n      \"import\": {\n        \"types\": \"./dist/tsup/driver-helpers/mod.d.ts\",\n        \"default\": \"./dist/tsup/driver-helpers/mod.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/tsup/driver-helpers/mod.d.cts\",\n        \"default\": \"./dist/tsup/driver-helpers/mod.cjs\"\n      }\n    },\n    \"./driver-helpers/websocket\": {\n      \"import\": {\n        \"types\": \"./dist/tsup/common/websocket.d.ts\",\n        \"default\": \"./dist/tsup/common/websocket.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/tsup/common/websocket.d.cts\",\n        \"default\": \"./dist/tsup/common/websocket.cjs\"\n      }\n    },\n    \"./driver-test-suite\": {\n      \"import\": {\n        \"types\": \"./dist/tsup/driver-test-suite/mod.d.ts\",\n        \"default\": \"./dist/tsup/driver-test-suite/mod.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/tsup/driver-test-suite/mod.d.cts\",\n        \"default\": \"./dist/tsup/driver-test-suite/mod.cjs\"\n      }\n    },\n    \"./topologies/coordinate\": {\n      \"import\": {\n        \"types\": \"./dist/tsup/topologies/coordinate/mod.d.ts\",\n        \"default\": \"./dist/tsup/topologies/coordinate/mod.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/tsup/topologies/coordinate/mod.d.cts\",\n        \"default\": \"./dist/tsup/topologies/coordinate/mod.cjs\"\n      }\n    },\n    \"./topologies/partition\": {\n      \"import\": {\n        \"types\": \"./dist/tsup/topologies/partition/mod.d.ts\",\n        \"default\": \"./dist/tsup/topologies/partition/mod.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/tsup/topologies/partition/mod.d.cts\",\n        \"default\": \"./dist/tsup/topologies/partition/mod.cjs\"\n      }\n    },\n    \"./test\": {\n      \"import\": {\n        \"types\": \"./dist/tsup/test/mod.d.ts\",\n        \"default\": \"./dist/tsup/test/mod.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/tsup/test/mod.d.cts\",\n        \"default\": \"./dist/tsup/test/mod.cjs\"\n      }\n    },\n    \"./inspector\": {\n      \"import\": {\n        \"types\": \"./dist/tsup/inspector/mod.d.ts\",\n        \"default\": \"./dist/tsup/inspector/mod.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/tsup/inspector/mod.d.cts\",\n        \"default\": \"./dist/tsup/inspector/mod.cjs\"\n      }\n    }\n  },\n  \"engines\": {\n    \"node\": \">=22.0.0\"\n  },\n  \"sideEffects\": false,\n  \"scripts\": {\n    \"build\": \"tsup src/mod.ts src/client/mod.ts src/common/log.ts src/common/websocket.ts src/actor/errors.ts src/topologies/coordinate/mod.ts src/topologies/partition/mod.ts src/utils.ts src/driver-helpers/mod.ts src/driver-test-suite/mod.ts src/test/mod.ts src/inspector/mod.ts\",\n    \"build:schema\": \"./scripts/compile-bare.ts compile schemas/client-protocol/v1.bare -o dist/schemas/client-protocol/v1.ts && ./scripts/compile-bare.ts compile schemas/file-system-driver/v1.bare -o dist/schemas/file-system-driver/v1.ts && ./scripts/compile-bare.ts compile schemas/actor-persist/v1.bare -o dist/schemas/actor-persist/v1.ts\",\n    \"check-types\": \"tsc --noEmit\",\n    \"test\": \"vitest run\",\n    \"test:watch\": \"vitest\",\n    \"dump-openapi\": \"tsx scripts/dump-openapi.ts\"\n  },\n  \"dependencies\": {\n    \"@bare-ts/lib\": \"~0.3.0\",\n    \"@hono/standard-validator\": \"^0.1.3\",\n    \"@hono/zod-openapi\": \"^0.19.10\",\n    \"@rivetkit/engine-runner\": \"https://pkg.pr.new/rivet-dev/engine/@rivetkit/engine-runner@f841bef\",\n    \"@rivetkit/fast-json-patch\": \"^3.1.2\",\n    \"cbor-x\": \"^1.6.0\",\n    \"hono\": \"^4.7.0\",\n    \"invariant\": \"^2.2.4\",\n    \"nanoevents\": \"^9.1.0\",\n    \"on-change\": \"^5.0.1\",\n    \"pino\": \"^9.5.0\",\n    \"p-retry\": \"^6.2.1\",\n    \"zod\": \"^3.25.76\"\n  },\n  \"devDependencies\": {\n    \"@bare-ts/tools\": \"^0.13.0\",\n    \"@hono/node-server\": \"^1.18.2\",\n    \"@hono/node-ws\": \"^1.1.1\",\n    \"@types/invariant\": \"^2\",\n    \"@types/node\": \"^22.13.1\",\n    \"@types/ws\": \"^8\",\n    \"@vitest/ui\": \"3.1.1\",\n    \"bundle-require\": \"^5.1.0\",\n    \"eventsource\": \"^3.0.5\",\n    \"tsup\": \"^8.4.0\",\n    \"tsx\": \"^4.19.4\",\n    \"typescript\": \"^5.7.3\",\n    \"vitest\": \"^3.1.1\",\n    \"ws\": \"^8.18.1\"\n  },\n  \"peerDependencies\": {\n    \"@hono/node-server\": \"^1.14.0\",\n    \"@hono/node-ws\": \"^1.1.1\",\n    \"eventsource\": \"^3.0.5\",\n    \"ws\": \"^8.0.0\"\n  },\n  \"peerDependenciesMeta\": {\n    \"@hono/node-server\": {\n      \"optional\": true\n    },\n    \"@hono/node-ws\": {\n      \"optional\": true\n    },\n    \"eventsource\": {\n      \"optional\": true\n    },\n    \"ws\": {\n      \"optional\": true\n    }\n  },\n  \"stableVersion\": \"0.8.0\"\n}\n","export { stringifyError } from \"@/common/utils\";\nexport { assertUnreachable } from \"./common/utils\";\n\nimport type { Context as HonoContext, Handler as HonoHandler } from \"hono\";\n\nimport pkgJson from \"../package.json\" with { type: \"json\" };\n\nexport const VERSION = pkgJson.version;\n\nlet _userAgent: string | undefined;\n\nexport function httpUserAgent(): string {\n\t// Return cached value if already initialized\n\tif (_userAgent !== undefined) {\n\t\treturn _userAgent;\n\t}\n\n\t// Library\n\tlet userAgent = `RivetKit/${VERSION}`;\n\n\t// Navigator\n\tconst navigatorObj = typeof navigator !== \"undefined\" ? navigator : undefined;\n\tif (navigatorObj?.userAgent) userAgent += ` ${navigatorObj.userAgent}`;\n\n\t_userAgent = userAgent;\n\n\treturn userAgent;\n}\n\nexport type UpgradeWebSocket = (\n\tcreateEvents: (c: HonoContext) => any,\n) => HonoHandler;\n\nexport function getEnvUniversal(key: string): string | undefined {\n\tif (typeof Deno !== \"undefined\") {\n\t\treturn Deno.env.get(key);\n\t} else if (typeof process !== \"undefined\") {\n\t\t// Do this after Deno since `process` is sometimes polyfilled\n\t\treturn process.env[key];\n\t}\n}\n\nexport function dbg<T>(x: T): T {\n\tconsole.trace(`=== DEBUG ===\\n${x}`);\n\treturn x;\n}\n\n/**\n * Converts various ArrayBuffer-like types to Uint8Array.\n * Handles ArrayBuffer, ArrayBufferView (including typed arrays), and passes through existing Uint8Array.\n *\n * @param data - The ArrayBuffer or ArrayBufferView to convert\n * @returns A Uint8Array view of the data\n */\nexport function toUint8Array(data: ArrayBuffer | ArrayBufferView): Uint8Array {\n\tif (data instanceof Uint8Array) {\n\t\treturn data;\n\t} else if (data instanceof ArrayBuffer) {\n\t\treturn new Uint8Array(data);\n\t} else if (ArrayBuffer.isView(data)) {\n\t\t// Handle other ArrayBufferView types (Int8Array, Uint16Array, DataView, etc.)\n\t\treturn new Uint8Array(\n\t\t\tdata.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength),\n\t\t);\n\t} else {\n\t\tthrow new TypeError(\"Input must be ArrayBuffer or ArrayBufferView\");\n\t}\n}\n\n// Long timeouts\n//\n// JavaScript timers use a signed 32-bit integer for delays, so values above 2^31-1 (~24.8 days)\n// are not reliable and may fire immediately or overflow.\n//\n// https://developer.mozilla.org/en-US/docs/Web/API/Window/setTimeout#maximum_delay_value\nconst TIMEOUT_MAX = 2147483647; // 2^31-1\n\nexport type LongTimeoutHandle = { abort: () => void };\n\nexport function setLongTimeout(\n\tlistener: () => void,\n\tafter: number,\n): LongTimeoutHandle {\n\tlet timeout: ReturnType<typeof setTimeout> | undefined;\n\n\tfunction start(remaining: number) {\n\t\tif (remaining <= TIMEOUT_MAX) {\n\t\t\ttimeout = setTimeout(listener, remaining);\n\t\t} else {\n\t\t\ttimeout = setTimeout(() => {\n\t\t\t\tstart(remaining - TIMEOUT_MAX);\n\t\t\t}, TIMEOUT_MAX);\n\t\t}\n\t}\n\n\tstart(after);\n\n\treturn {\n\t\tabort: () => {\n\t\t\tif (timeout !== undefined) clearTimeout(timeout);\n\t\t},\n\t};\n}\n\n/**\n * A tiny utility that coalesces/enqueues async operations so only the latest\n * queued task runs per cycle, while callers receive a promise that resolves\n * when the task for the cycle they joined has completed.\n */\nexport class SinglePromiseQueue {\n\t/** Next operation to execute in the queue. If attempting to enqueue another op, it will override the existing op. */\n\t#queuedOp?: () => Promise<void>;\n\n\t/** The currently running promise of #drainLoop. Do not await this, instead await `pending` to await the current cycle. */\n\trunningDrainLoop?: Promise<void>;\n\n\t/** Pending resolver fro the currently queued entry. */\n\t#pending?: PromiseWithResolvers<void>;\n\n\t/** Queue the next operation and return a promise that resolves when it flushes. */\n\tenqueue(op: () => Promise<void>): Promise<void> {\n\t\t// Replace any previously queued operation with the latest one\n\t\tthis.#queuedOp = op;\n\n\t\t// Ensure a shared resolver exists for all callers in this cycle\n\t\tif (!this.#pending) {\n\t\t\tthis.#pending = Promise.withResolvers<void>();\n\t\t}\n\n\t\tconst waitForThisCycle = this.#pending.promise;\n\n\t\t// Start runner if not already running\n\t\tif (!this.runningDrainLoop) {\n\t\t\tthis.runningDrainLoop = this.#drainLoop();\n\t\t}\n\n\t\treturn waitForThisCycle;\n\t}\n\n\t/** Drain queued operations sequentially until there is nothing left. */\n\tasync #drainLoop(): Promise<void> {\n\t\ttry {\n\t\t\twhile (this.#queuedOp) {\n\t\t\t\t// Capture current cycle resolver then reset for the next cycle\n\t\t\t\tconst resolver = this.#pending;\n\t\t\t\tthis.#pending = undefined;\n\n\t\t\t\t// Capture and clear the currently queued operation\n\t\t\t\tconst op = this.#queuedOp;\n\t\t\t\tthis.#queuedOp = undefined;\n\n\t\t\t\ttry {\n\t\t\t\t\tawait op();\n\t\t\t\t} catch {\n\t\t\t\t\t// Swallow errors: callers only await cycle completion, not success\n\t\t\t\t}\n\n\t\t\t\t// Notify all waiters for this cycle\n\t\t\t\tresolver?.resolve();\n\t\t\t}\n\t\t} finally {\n\t\t\tthis.runningDrainLoop = undefined;\n\t\t}\n\t}\n}\n\nexport function bufferToArrayBuffer(buf: Buffer | Uint8Array): ArrayBuffer {\n\treturn buf.buffer.slice(\n\t\tbuf.byteOffset,\n\t\tbuf.byteOffset + buf.byteLength,\n\t) as ArrayBuffer;\n}\n"]}