rivetkit 2.0.24-rc.1 → 2.0.24

package/dist/tsup/{conn-DJWL3nGx.d.cts → config-Bo-blHpJ.d.ts}

@@ -1,69 +1,10 @@
-import { SSEStreamingApi } from 'hono/streaming';
-import { WSContext } from 'hono/ws';
-import { GetUpgradeWebSocket, promiseWithResolvers } from './utils.cjs';
 import z$1, { z } from 'zod';
-import { Logger } from 'pino';
 import { Env, Context, Hono } from 'hono';
+import { Logger } from 'pino';
+import { GetUpgradeWebSocket } from './utils.js';
 import * as nanoevents from 'nanoevents';
 import z__default from 'zod/v4';
 
-type uint = bigint;
-type Init = {
-    readonly actorId: string;
-    readonly connectionId: string;
-    readonly connectionToken: string;
-};
-type Error$1 = {
-    readonly group: string;
-    readonly code: string;
-    readonly message: string;
-    readonly metadata: ArrayBuffer | null;
-    readonly actionId: uint | null;
-};
-type ActionResponse = {
-    readonly id: uint;
-    readonly output: ArrayBuffer;
-};
-type Event = {
-    readonly name: string;
-    readonly args: ArrayBuffer;
-};
-type ToClientBody = {
-    readonly tag: "Init";
-    readonly val: Init;
-} | {
-    readonly tag: "Error";
-    readonly val: Error$1;
-} | {
-    readonly tag: "ActionResponse";
-    readonly val: ActionResponse;
-} | {
-    readonly tag: "Event";
-    readonly val: Event;
-};
-type ToClient = {
-    readonly body: ToClientBody;
-};
-type ActionRequest = {
-    readonly id: uint;
-    readonly name: string;
-    readonly args: ArrayBuffer;
-};
-type SubscriptionRequest = {
-    readonly eventName: string;
-    readonly subscribe: boolean;
-};
-type ToServerBody = {
-    readonly tag: "ActionRequest";
-    readonly val: ActionRequest;
-} | {
-    readonly tag: "SubscriptionRequest";
-    readonly val: SubscriptionRequest;
-};
-type ToServer = {
-    readonly body: ToServerBody;
-};
-
 interface RivetEvent {
     type: string;
     target?: any;
@@ -113,6 +54,27 @@ interface UniversalWebSocket {
     onmessage?: ((event: RivetMessageEvent) => void) | null;
 }
 
+type InferDatabaseClient<DBProvider extends AnyDatabaseProvider> = DBProvider extends DatabaseProvider<any> ? Awaited<ReturnType<DBProvider["createClient"]>> : never;
+type AnyDatabaseProvider = DatabaseProvider<any> | undefined;
+type DatabaseProvider<DB extends {
+    execute: (query: string) => any;
+}> = {
+    /**
+     * Creates a new database client for the actor.
+     * The result is passed to the actor context as `c.db`.
+     * @experimental
+     */
+    createClient: (ctx: {
+        getDatabase: () => Promise<string | unknown>;
+    }) => Promise<DB>;
+    /**
+     * Runs before the actor has started.
+     * Use this to run migrations or other setup tasks.
+     * @experimental
+     */
+    onMigrate: (client: DB) => void | Promise<void>;
+};
+
 declare const ActorsSchema: z.ZodRecord<z.ZodString, z.ZodType<ActorDefinition<any, any, any, any, any, any, any>, z.ZodTypeDef, ActorDefinition<any, any, any, any, any, any, any>>>;
 type RegistryActors = z.infer<typeof ActorsSchema>;
 /** Base config used for the actor config across all platforms. */
@@ -153,12 +115,12 @@ declare const DriverConfigSchema: z.ZodObject<{
     manager: z.ZodType<ManagerDriverBuilder, z.ZodTypeDef, ManagerDriverBuilder>;
     actor: z.ZodType<ActorDriverBuilder, z.ZodTypeDef, ActorDriverBuilder>;
 }, "strip", z.ZodTypeAny, {
-    actor: ActorDriverBuilder;
     name: string;
+    actor: ActorDriverBuilder;
     manager: ManagerDriverBuilder;
 }, {
-    actor: ActorDriverBuilder;
     name: string;
+    actor: ActorDriverBuilder;
     manager: ManagerDriverBuilder;
 }>;
 type DriverConfig = z.infer<typeof DriverConfigSchema>;
@@ -170,12 +132,12 @@ declare const RunnerConfigSchema: z.ZodDefault<z.ZodObject<{
         manager: z.ZodType<ManagerDriverBuilder, z.ZodTypeDef, ManagerDriverBuilder>;
         actor: z.ZodType<ActorDriverBuilder, z.ZodTypeDef, ActorDriverBuilder>;
     }, "strip", z.ZodTypeAny, {
-        actor: ActorDriverBuilder;
         name: string;
+        actor: ActorDriverBuilder;
         manager: ManagerDriverBuilder;
     }, {
-        actor: ActorDriverBuilder;
         name: string;
+        actor: ActorDriverBuilder;
         manager: ManagerDriverBuilder;
     }>>;
     maxIncomingMessageSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -262,17 +224,15 @@ declare const RunnerConfigSchema: z.ZodDefault<z.ZodObject<{
     namespace: z.ZodDefault<z.ZodString>;
     runnerName: z.ZodDefault<z.ZodString>;
     encoding: z.ZodDefault<z.ZodEnum<["json", "cbor", "bare"]>>;
-    transport: z.ZodDefault<z.ZodEnum<["websocket", "sse"]>>;
     headers: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
     getUpgradeWebSocket: z.ZodOptional<z.ZodType<GetUpgradeWebSocket, z.ZodTypeDef, GetUpgradeWebSocket>>;
-    disableHealthCheck: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    disableMetadataLookup: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, "strip", z.ZodTypeAny, {
     encoding: "json" | "cbor" | "bare";
     namespace: string;
     runnerName: string;
-    transport: "websocket" | "sse";
     headers: Record<string, string>;
-    disableHealthCheck: boolean;
+    disableMetadataLookup: boolean;
     inspector: {
         enabled: boolean | {
             actor: boolean;
@@ -296,8 +256,8 @@ declare const RunnerConfigSchema: z.ZodDefault<z.ZodObject<{
         baseLogger?: Logger | undefined;
     };
     driver?: {
-        actor: ActorDriverBuilder;
         name: string;
+        actor: ActorDriverBuilder;
         manager: ManagerDriverBuilder;
     } | undefined;
     endpoint?: string | undefined;
@@ -318,18 +278,17 @@ declare const RunnerConfigSchema: z.ZodDefault<z.ZodObject<{
 }, {
     encoding?: "json" | "cbor" | "bare" | undefined;
     driver?: {
-        actor: ActorDriverBuilder;
         name: string;
+        actor: ActorDriverBuilder;
         manager: ManagerDriverBuilder;
     } | undefined;
     endpoint?: string | undefined;
     token?: string | undefined;
     namespace?: string | undefined;
     runnerName?: string | undefined;
-    transport?: "websocket" | "sse" | undefined;
     headers?: Record<string, string> | undefined;
     getUpgradeWebSocket?: GetUpgradeWebSocket | undefined;
-    disableHealthCheck?: boolean | undefined;
+    disableMetadataLookup?: boolean | undefined;
     inspector?: {
         enabled?: boolean | {
             actor?: boolean | undefined;
@@ -374,10 +333,11 @@ interface ManagerDriver {
     getWithKey(input: GetWithKeyInput): Promise<ActorOutput | undefined>;
     getOrCreateWithKey(input: GetOrCreateWithKeyInput): Promise<ActorOutput>;
     createActor(input: CreateInput): Promise<ActorOutput>;
+    listActors(input: ListActorsInput): Promise<ActorOutput[]>;
     sendRequest(actorId: string, actorRequest: Request): Promise<Response>;
-    openWebSocket(path: string, actorId: string, encoding: Encoding, params: unknown, connId?: string, connToken?: string): Promise<UniversalWebSocket>;
+    openWebSocket(path: string, actorId: string, encoding: Encoding, params: unknown): Promise<UniversalWebSocket>;
     proxyRequest(c: Context, actorRequest: Request, actorId: string): Promise<Response>;
-    proxyWebSocket(c: Context, path: string, actorId: string, encoding: Encoding, params: unknown, connId?: string, connToken?: string): Promise<Response>;
+    proxyWebSocket(c: Context, path: string, actorId: string, encoding: Encoding, params: unknown): Promise<Response>;
     displayInformation(): ManagerDisplayInformation;
     extraStartupLog?: () => Record<string, unknown>;
     modifyManagerRouter?: (registryConfig: RegistryConfig, router: Hono) => void;
@@ -416,19 +376,31 @@ interface CreateInput<E extends Env = any> {
     input?: unknown;
     region?: string;
 }
+interface ListActorsInput<E extends Env = any> {
+    c?: Context | undefined;
+    name: string;
+    key?: string;
+    includeDestroyed?: boolean;
+}
 interface ActorOutput {
     actorId: string;
     name: string;
     key: ActorKey;
+    createTs?: number;
 }
 
 type ActorDriverBuilder = (registryConfig: RegistryConfig, runConfig: RunnerConfig, managerDriver: ManagerDriver, inlineClient: AnyClient) => ActorDriver;
 interface ActorDriver {
     loadActor(actorId: string): Promise<AnyActorInstance>;
     getContext(actorId: string): unknown;
-    readPersistedData(actorId: string): Promise<Uint8Array | undefined>;
-    /** ActorInstance ensure that only one instance of writePersistedData is called in parallel at a time. */
-    writePersistedData(actorId: string, data: Uint8Array): Promise<void>;
+    /** Batch write multiple key-value pairs. Keys and values are Uint8Arrays. */
+    kvBatchPut(actorId: string, entries: [Uint8Array, Uint8Array][]): Promise<void>;
+    /** Batch read multiple keys. Returns null for keys that don't exist. */
+    kvBatchGet(actorId: string, keys: Uint8Array[]): Promise<(Uint8Array | null)[]>;
+    /** Batch delete multiple keys. */
+    kvBatchDelete(actorId: string, keys: Uint8Array[]): Promise<void>;
+    /** List all keys with a given prefix. */
+    kvListPrefix(actorId: string, prefix: Uint8Array): Promise<[Uint8Array, Uint8Array][]>;
     /** ActorInstance ensure that only one instance of setAlarm is called in parallel at a time. */
     setAlarm(actor: AnyActorInstance, timestamp: number): Promise<void>;
     /**
@@ -439,9 +411,15 @@ interface ActorDriver {
     /**
      * Requests the actor to go to sleep.
      *
-     * This will call `_stop` independently.
+     * This will call `ActorInstance.onStop` independently.
      */
     startSleep?(actorId: string): void;
+    /**
+     * Destroys the actor and its associated data.
+     *
+     * This will call `ActorInstance.onStop` independently.
+     */
+    startDestroy(actorId: string): void;
     /**
      * Shuts down the actor runner.
      */
@@ -450,6 +428,11 @@ interface ActorDriver {
     serverlessHandleStart?(c: Context): Promise<Response>;
     /** Extra properties to add to logs for each actor. */
     getExtraActorLogParams?(): Record<string, string>;
+    onBeforeActorStart?(actor: AnyActorInstance): Promise<void>;
+    onCreateConn?(conn: AnyConn): void;
+    onDestroyConn?(conn: AnyConn): void;
+    onBeforePersistConn?(conn: AnyConn): void;
+    onAfterPersistConn?(conn: AnyConn): void;
 }
 
 type ServerlessActorDriverBuilder = (updateConfig: (config: RunnerConfig) => void) => ActorDriver;
@@ -470,27 +453,6 @@ declare class Registry<A extends RegistryActors> {
 }
 declare function setup<A extends RegistryActors>(input: RegistryConfigInput<A>): Registry<A>;
 
-type InferDatabaseClient<DBProvider extends AnyDatabaseProvider> = DBProvider extends DatabaseProvider<any> ? Awaited<ReturnType<DBProvider["createClient"]>> : never;
-type AnyDatabaseProvider = DatabaseProvider<any> | undefined;
-type DatabaseProvider<DB extends {
-    execute: (query: string) => any;
-}> = {
-    /**
-     * Creates a new database client for the actor.
-     * The result is passed to the actor context as `c.db`.
-     * @experimental
-     */
-    createClient: (ctx: {
-        getDatabase: () => Promise<string | unknown>;
-    }) => Promise<DB>;
-    /**
-     * Runs before the actor has started.
-     * Use this to run migrations or other setup tasks.
-     * @experimental
-     */
-    onMigrate: (client: DB) => void | Promise<void>;
-};
-
 declare class Schedule {
     #private;
     constructor(actor: AnyActorInstance);
@@ -578,6 +540,28 @@ declare class ActorContext<TState, TConnParams, TConnState, TVars, TInput, TData
      * @experimental
      */
     sleep(): void;
+    /**
+     * Forces the actor to destroy.
+     *
+     * This will return immediately, then call `onStop` and `onDestroy`.
+     *
+     * @experimental
+     */
+    destroy(): void;
+}
+
+/**
+ * Base context for connection-based handlers.
+ * Extends ActorContext with connection-specific functionality.
+ */
+declare abstract class ConnContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider> extends ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase> {
+    readonly conn: Conn<TState, TConnParams, TConnState, TVars, TInput, TDatabase>;
+}
+
+/**
+ * Context for a remote procedure call.
+ */
+declare class ActionContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider> extends ConnContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase> {
 }
 
 type AnyActorDefinition = ActorDefinition<any, any, any, any, any, any, any>;
@@ -625,19 +609,13 @@ type Encoding = z.infer<typeof EncodingSchema>;
 /**
  * Helper class that helps serialize data without re-serializing for the same encoding.
  */
-declare class CachedSerializer<T> {
+declare class CachedSerializer<TBare, TJson, T = TBare> {
     #private;
-    constructor(data: T, versionedDataHandler: VersionedDataHandler<T>);
+    constructor(data: T, versionedDataHandler: VersionedDataHandler<TBare>, zodSchema: z.ZodType<TJson>, toJson: (value: T) => TJson, toBare: (value: T) => TBare);
     get rawData(): T;
     serialize(encoding: Encoding): OutputData;
 }
 
-declare const TransportSchema: z.ZodEnum<["websocket", "sse"]>;
-/**
- * Transport mechanism used to communicate between client & actor.
- */
-type Transport = z.infer<typeof TransportSchema>;
-
 declare const ActorKeySchema: z.ZodArray<z.ZodString, "many">;
 type ActorKey = z.infer<typeof ActorKeySchema>;
 declare const CreateRequestSchema: z.ZodObject<{
@@ -646,13 +624,13 @@ declare const CreateRequestSchema: z.ZodObject<{
     input: z.ZodOptional<z.ZodUnknown>;
     region: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    key: string[];
     name: string;
+    key: string[];
     input?: unknown;
     region?: string | undefined;
 }, {
-    key: string[];
     name: string;
+    key: string[];
     input?: unknown;
     region?: string | undefined;
 }>;
@@ -661,42 +639,42 @@ declare const ActorQuerySchema: z.ZodUnion<[z.ZodObject<{
         name: z.ZodString;
         actorId: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        name: string;
         actorId: string;
-    }, {
         name: string;
+    }, {
         actorId: string;
+        name: string;
     }>;
 }, "strip", z.ZodTypeAny, {
     getForId: {
-        name: string;
         actorId: string;
+        name: string;
     };
 }, {
     getForId: {
-        name: string;
         actorId: string;
+        name: string;
     };
 }>, z.ZodObject<{
     getForKey: z.ZodObject<{
         name: z.ZodString;
         key: z.ZodArray<z.ZodString, "many">;
     }, "strip", z.ZodTypeAny, {
-        key: string[];
         name: string;
-    }, {
         key: string[];
+    }, {
         name: string;
+        key: string[];
     }>;
 }, "strip", z.ZodTypeAny, {
     getForKey: {
-        key: string[];
         name: string;
+        key: string[];
     };
 }, {
     getForKey: {
-        key: string[];
         name: string;
+        key: string[];
     };
 }>, z.ZodObject<{
     getOrCreateForKey: z.ZodObject<{
@@ -705,27 +683,27 @@ declare const ActorQuerySchema: z.ZodUnion<[z.ZodObject<{
         input: z.ZodOptional<z.ZodUnknown>;
         region: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        key: string[];
         name: string;
+        key: string[];
         input?: unknown;
         region?: string | undefined;
     }, {
-        key: string[];
         name: string;
+        key: string[];
         input?: unknown;
         region?: string | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
     getOrCreateForKey: {
-        key: string[];
         name: string;
+        key: string[];
         input?: unknown;
         region?: string | undefined;
     };
 }, {
     getOrCreateForKey: {
-        key: string[];
         name: string;
+        key: string[];
         input?: unknown;
         region?: string | undefined;
     };
@@ -736,27 +714,27 @@ declare const ActorQuerySchema: z.ZodUnion<[z.ZodObject<{
         input: z.ZodOptional<z.ZodUnknown>;
         region: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        key: string[];
         name: string;
+        key: string[];
         input?: unknown;
         region?: string | undefined;
     }, {
-        key: string[];
         name: string;
+        key: string[];
         input?: unknown;
         region?: string | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
     create: {
-        key: string[];
         name: string;
+        key: string[];
         input?: unknown;
         region?: string | undefined;
     };
 }, {
     create: {
-        key: string[];
         name: string;
+        key: string[];
         input?: unknown;
         region?: string | undefined;
     };
@@ -995,18 +973,16 @@ declare const ClientConfigSchema: z$1.ZodObject<{
     /** Name of the runner. This is used to group together runners in to different pools. */
     runnerName: z$1.ZodDefault<z$1.ZodString>;
     encoding: z$1.ZodDefault<z$1.ZodEnum<["json", "cbor", "bare"]>>;
-    transport: z$1.ZodDefault<z$1.ZodEnum<["websocket", "sse"]>>;
     headers: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodString>>>;
     getUpgradeWebSocket: z$1.ZodOptional<z$1.ZodType<GetUpgradeWebSocket, z$1.ZodTypeDef, GetUpgradeWebSocket>>;
     /** Whether to automatically perform health checks when the client is created. */
-    disableHealthCheck: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodBoolean>>;
+    disableMetadataLookup: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodBoolean>>;
 }, "strip", z$1.ZodTypeAny, {
     encoding: "json" | "cbor" | "bare";
     namespace: string;
     runnerName: string;
-    transport: "websocket" | "sse";
     headers: Record<string, string>;
-    disableHealthCheck: boolean;
+    disableMetadataLookup: boolean;
     endpoint?: string | undefined;
     token?: string | undefined;
     getUpgradeWebSocket?: GetUpgradeWebSocket | undefined;
@@ -1016,10 +992,9 @@ declare const ClientConfigSchema: z$1.ZodObject<{
     token?: string | undefined;
     namespace?: string | undefined;
     runnerName?: string | undefined;
-    transport?: "websocket" | "sse" | undefined;
     headers?: Record<string, string> | undefined;
     getUpgradeWebSocket?: GetUpgradeWebSocket | undefined;
-    disableHealthCheck?: boolean | undefined;
+    disableMetadataLookup?: boolean | undefined;
 }>;
 type ClientConfig = z$1.infer<typeof ClientConfigSchema>;
 type ClientConfigInput = z$1.input<typeof ClientConfigSchema>;
@@ -1137,7 +1112,6 @@ interface Region {
 }
 declare const ACTOR_CONNS_SYMBOL: unique symbol;
 declare const CREATE_ACTOR_CONN_PROXY: unique symbol;
-declare const TRANSPORT_SYMBOL: unique symbol;
 /**
  * Client for managing & connecting to actors.
  *
@@ -1147,7 +1121,6 @@ declare const TRANSPORT_SYMBOL: unique symbol;
 declare class ClientRaw {
     #private;
     [ACTOR_CONNS_SYMBOL]: Set<ActorConnRaw>;
-    [TRANSPORT_SYMBOL]: Transport;
     /**
      * Creates an instance of Client.
      */
@@ -1213,596 +1186,18 @@ type Client<A extends Registry<any>> = ClientRaw & {
 type AnyClient = Client<Registry<any>>;
 declare function createClientWithDriver<A extends Registry<any>>(driver: ManagerDriver, config: ClientConfig): Client<A>;
 
-/**
- * Context for a remote procedure call.
- *
- * @typeParam A Actor this action belongs to
- */
-declare class ActionContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider> {
-    #private;
-    readonly conn: Conn<TState, TConnParams, TConnState, TVars, TInput, TDatabase>;
-    /**
-     * Should not be called directly.
-     *
-     * @param actorContext - The actor context
-     * @param conn - The connection associated with the action
-     */
-    constructor(actorContext: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, conn: Conn<TState, TConnParams, TConnState, TVars, TInput, TDatabase>);
-    /**
-     * Get the actor state
-     */
-    get state(): TState;
-    /**
-     * Get the actor variables
-     */
-    get vars(): TVars;
-    /**
-     * Broadcasts an event to all connected clients.
-     */
-    broadcast(name: string, ...args: any[]): void;
-    /**
-     * Gets the logger instance.
-     */
-    get log(): Logger;
-    /**
-     * Gets actor ID.
-     */
-    get actorId(): string;
-    /**
-     * Gets the actor name.
-     */
-    get name(): string;
-    /**
-     * Gets the actor key.
-     */
-    get key(): ActorKey;
-    /**
-     * Gets the region.
-     */
-    get region(): string;
-    /**
-     * Gets the scheduler.
-     */
-    get schedule(): Schedule;
-    /**
-     * Gets the map of connections.
-     */
-    get conns(): Map<ConnId, Conn<TState, TConnParams, TConnState, TVars, TInput, TDatabase>>;
-    /**
-     * Returns the client for the given registry.
-     */
-    client<R extends Registry<any>>(): Client<R>;
-    /**
-     * @experimental
-     */
-    get db(): InferDatabaseClient<TDatabase>;
-    /**
-     * Forces the state to get saved.
-     */
-    saveState(opts: SaveStateOptions): Promise<void>;
-    /**
-     * Prevents the actor from sleeping until promise is complete.
-     */
-    waitUntil(promise: Promise<void>): void;
-    /**
-     * AbortSignal that fires when the actor is stopping.
-     */
-    get abortSignal(): AbortSignal;
-    /**
-     * Forces the actor to sleep.
-     *
-     * Not supported on all drivers.
-     *
-     * @experimental
-     */
-    sleep(): void;
-}
-
-type InitContext = ActorContext<undefined, undefined, undefined, undefined, undefined, undefined>;
-interface ActorTypes<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider> {
-    state?: TState;
-    connParams?: TConnParams;
-    connState?: TConnState;
-    vars?: TVars;
-    input?: TInput;
-    database?: TDatabase;
-}
-declare const ActorConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodObject<{
-    onCreate: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    onStart: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    onStop: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    onStateChange: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    onBeforeConnect: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    onConnect: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    onDisconnect: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    onBeforeActionResponse: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    onFetch: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    onWebSocket: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    actions: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>>;
-    state: z.ZodOptional<z.ZodAny>;
-    createState: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    connState: z.ZodOptional<z.ZodAny>;
-    createConnState: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    vars: z.ZodOptional<z.ZodAny>;
-    db: z.ZodOptional<z.ZodAny>;
-    createVars: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    options: z.ZodDefault<z.ZodObject<{
-        createVarsTimeout: z.ZodDefault<z.ZodNumber>;
-        createConnStateTimeout: z.ZodDefault<z.ZodNumber>;
-        onConnectTimeout: z.ZodDefault<z.ZodNumber>;
-        onStopTimeout: z.ZodDefault<z.ZodNumber>;
-        stateSaveInterval: z.ZodDefault<z.ZodNumber>;
-        actionTimeout: z.ZodDefault<z.ZodNumber>;
-        waitUntilTimeout: z.ZodDefault<z.ZodNumber>;
-        connectionLivenessTimeout: z.ZodDefault<z.ZodNumber>;
-        connectionLivenessInterval: z.ZodDefault<z.ZodNumber>;
-        noSleep: z.ZodDefault<z.ZodBoolean>;
-        sleepTimeout: z.ZodDefault<z.ZodNumber>;
-        /** @experimental */
-        canHibernatWebSocket: z.ZodDefault<z.ZodUnion<[z.ZodBoolean, z.ZodFunction<z.ZodTuple<[z.ZodType<Request, z.ZodTypeDef, Request>], z.ZodUnknown>, z.ZodBoolean>]>>;
-    }, "strict", z.ZodTypeAny, {
-        createVarsTimeout: number;
-        createConnStateTimeout: number;
-        onConnectTimeout: number;
-        onStopTimeout: number;
-        stateSaveInterval: number;
-        actionTimeout: number;
-        waitUntilTimeout: number;
-        connectionLivenessTimeout: number;
-        connectionLivenessInterval: number;
-        noSleep: boolean;
-        sleepTimeout: number;
-        canHibernatWebSocket: boolean | ((args_0: Request, ...args: unknown[]) => boolean);
-    }, {
-        createVarsTimeout?: number | undefined;
-        createConnStateTimeout?: number | undefined;
-        onConnectTimeout?: number | undefined;
-        onStopTimeout?: number | undefined;
-        stateSaveInterval?: number | undefined;
-        actionTimeout?: number | undefined;
-        waitUntilTimeout?: number | undefined;
-        connectionLivenessTimeout?: number | undefined;
-        connectionLivenessInterval?: number | undefined;
-        noSleep?: boolean | undefined;
-        sleepTimeout?: number | undefined;
-        canHibernatWebSocket?: boolean | ((args_0: Request, ...args: unknown[]) => boolean) | undefined;
-    }>>;
-}, "strict", z.ZodTypeAny, {
-    options: {
-        createVarsTimeout: number;
-        createConnStateTimeout: number;
-        onConnectTimeout: number;
-        onStopTimeout: number;
-        stateSaveInterval: number;
-        actionTimeout: number;
-        waitUntilTimeout: number;
-        connectionLivenessTimeout: number;
-        connectionLivenessInterval: number;
-        noSleep: boolean;
-        sleepTimeout: number;
-        canHibernatWebSocket: boolean | ((args_0: Request, ...args: unknown[]) => boolean);
-    };
-    actions: Record<string, (...args: unknown[]) => unknown>;
-    state?: any;
-    onCreate?: ((...args: unknown[]) => unknown) | undefined;
-    onStart?: ((...args: unknown[]) => unknown) | undefined;
-    onStop?: ((...args: unknown[]) => unknown) | undefined;
-    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
-    onFetch?: ((...args: unknown[]) => unknown) | undefined;
-    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
-    createState?: ((...args: unknown[]) => unknown) | undefined;
-    connState?: any;
-    createConnState?: ((...args: unknown[]) => unknown) | undefined;
-    vars?: any;
-    db?: any;
-    createVars?: ((...args: unknown[]) => unknown) | undefined;
-}, {
-    state?: any;
-    options?: {
-        createVarsTimeout?: number | undefined;
-        createConnStateTimeout?: number | undefined;
-        onConnectTimeout?: number | undefined;
-        onStopTimeout?: number | undefined;
-        stateSaveInterval?: number | undefined;
-        actionTimeout?: number | undefined;
-        waitUntilTimeout?: number | undefined;
-        connectionLivenessTimeout?: number | undefined;
-        connectionLivenessInterval?: number | undefined;
-        noSleep?: boolean | undefined;
-        sleepTimeout?: number | undefined;
-        canHibernatWebSocket?: boolean | ((args_0: Request, ...args: unknown[]) => boolean) | undefined;
-    } | undefined;
-    onCreate?: ((...args: unknown[]) => unknown) | undefined;
-    onStart?: ((...args: unknown[]) => unknown) | undefined;
-    onStop?: ((...args: unknown[]) => unknown) | undefined;
-    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
-    onFetch?: ((...args: unknown[]) => unknown) | undefined;
-    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
-    actions?: Record<string, (...args: unknown[]) => unknown> | undefined;
-    createState?: ((...args: unknown[]) => unknown) | undefined;
-    connState?: any;
-    createConnState?: ((...args: unknown[]) => unknown) | undefined;
-    vars?: any;
-    db?: any;
-    createVars?: ((...args: unknown[]) => unknown) | undefined;
-}>, {
-    options: {
-        createVarsTimeout: number;
-        createConnStateTimeout: number;
-        onConnectTimeout: number;
-        onStopTimeout: number;
-        stateSaveInterval: number;
-        actionTimeout: number;
-        waitUntilTimeout: number;
-        connectionLivenessTimeout: number;
-        connectionLivenessInterval: number;
-        noSleep: boolean;
-        sleepTimeout: number;
-        canHibernatWebSocket: boolean | ((args_0: Request, ...args: unknown[]) => boolean);
-    };
-    actions: Record<string, (...args: unknown[]) => unknown>;
-    state?: any;
-    onCreate?: ((...args: unknown[]) => unknown) | undefined;
-    onStart?: ((...args: unknown[]) => unknown) | undefined;
-    onStop?: ((...args: unknown[]) => unknown) | undefined;
-    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
-    onFetch?: ((...args: unknown[]) => unknown) | undefined;
-    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
-    createState?: ((...args: unknown[]) => unknown) | undefined;
-    connState?: any;
-    createConnState?: ((...args: unknown[]) => unknown) | undefined;
-    vars?: any;
-    db?: any;
-    createVars?: ((...args: unknown[]) => unknown) | undefined;
-}, {
-    state?: any;
-    options?: {
-        createVarsTimeout?: number | undefined;
-        createConnStateTimeout?: number | undefined;
-        onConnectTimeout?: number | undefined;
-        onStopTimeout?: number | undefined;
-        stateSaveInterval?: number | undefined;
-        actionTimeout?: number | undefined;
-        waitUntilTimeout?: number | undefined;
-        connectionLivenessTimeout?: number | undefined;
-        connectionLivenessInterval?: number | undefined;
-        noSleep?: boolean | undefined;
-        sleepTimeout?: number | undefined;
-        canHibernatWebSocket?: boolean | ((args_0: Request, ...args: unknown[]) => boolean) | undefined;
-    } | undefined;
-    onCreate?: ((...args: unknown[]) => unknown) | undefined;
-    onStart?: ((...args: unknown[]) => unknown) | undefined;
-    onStop?: ((...args: unknown[]) => unknown) | undefined;
-    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
-    onFetch?: ((...args: unknown[]) => unknown) | undefined;
-    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
-    actions?: Record<string, (...args: unknown[]) => unknown> | undefined;
-    createState?: ((...args: unknown[]) => unknown) | undefined;
-    connState?: any;
-    createConnState?: ((...args: unknown[]) => unknown) | undefined;
-    vars?: any;
-    db?: any;
-    createVars?: ((...args: unknown[]) => unknown) | undefined;
-}>, {
-    options: {
-        createVarsTimeout: number;
-        createConnStateTimeout: number;
-        onConnectTimeout: number;
-        onStopTimeout: number;
-        stateSaveInterval: number;
-        actionTimeout: number;
-        waitUntilTimeout: number;
-        connectionLivenessTimeout: number;
-        connectionLivenessInterval: number;
-        noSleep: boolean;
-        sleepTimeout: number;
-        canHibernatWebSocket: boolean | ((args_0: Request, ...args: unknown[]) => boolean);
-    };
-    actions: Record<string, (...args: unknown[]) => unknown>;
-    state?: any;
-    onCreate?: ((...args: unknown[]) => unknown) | undefined;
-    onStart?: ((...args: unknown[]) => unknown) | undefined;
-    onStop?: ((...args: unknown[]) => unknown) | undefined;
-    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
-    onFetch?: ((...args: unknown[]) => unknown) | undefined;
-    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
-    createState?: ((...args: unknown[]) => unknown) | undefined;
-    connState?: any;
-    createConnState?: ((...args: unknown[]) => unknown) | undefined;
-    vars?: any;
-    db?: any;
-    createVars?: ((...args: unknown[]) => unknown) | undefined;
-}, {
-    state?: any;
-    options?: {
-        createVarsTimeout?: number | undefined;
-        createConnStateTimeout?: number | undefined;
-        onConnectTimeout?: number | undefined;
-        onStopTimeout?: number | undefined;
-        stateSaveInterval?: number | undefined;
-        actionTimeout?: number | undefined;
-        waitUntilTimeout?: number | undefined;
-        connectionLivenessTimeout?: number | undefined;
-        connectionLivenessInterval?: number | undefined;
-        noSleep?: boolean | undefined;
-        sleepTimeout?: number | undefined;
-        canHibernatWebSocket?: boolean | ((args_0: Request, ...args: unknown[]) => boolean) | undefined;
-    } | undefined;
-    onCreate?: ((...args: unknown[]) => unknown) | undefined;
-    onStart?: ((...args: unknown[]) => unknown) | undefined;
-    onStop?: ((...args: unknown[]) => unknown) | undefined;
-    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
-    onFetch?: ((...args: unknown[]) => unknown) | undefined;
-    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
-    actions?: Record<string, (...args: unknown[]) => unknown> | undefined;
-    createState?: ((...args: unknown[]) => unknown) | undefined;
-    connState?: any;
-    createConnState?: ((...args: unknown[]) => unknown) | undefined;
-    vars?: any;
-    db?: any;
-    createVars?: ((...args: unknown[]) => unknown) | undefined;
-}>, {
-    options: {
-        createVarsTimeout: number;
-        createConnStateTimeout: number;
-        onConnectTimeout: number;
-        onStopTimeout: number;
-        stateSaveInterval: number;
-        actionTimeout: number;
-        waitUntilTimeout: number;
-        connectionLivenessTimeout: number;
-        connectionLivenessInterval: number;
-        noSleep: boolean;
-        sleepTimeout: number;
-        canHibernatWebSocket: boolean | ((args_0: Request, ...args: unknown[]) => boolean);
-    };
-    actions: Record<string, (...args: unknown[]) => unknown>;
-    state?: any;
-    onCreate?: ((...args: unknown[]) => unknown) | undefined;
-    onStart?: ((...args: unknown[]) => unknown) | undefined;
-    onStop?: ((...args: unknown[]) => unknown) | undefined;
-    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
-    onFetch?: ((...args: unknown[]) => unknown) | undefined;
-    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
-    createState?: ((...args: unknown[]) => unknown) | undefined;
-    connState?: any;
-    createConnState?: ((...args: unknown[]) => unknown) | undefined;
-    vars?: any;
-    db?: any;
-    createVars?: ((...args: unknown[]) => unknown) | undefined;
-}, {
-    state?: any;
-    options?: {
-        createVarsTimeout?: number | undefined;
-        createConnStateTimeout?: number | undefined;
-        onConnectTimeout?: number | undefined;
-        onStopTimeout?: number | undefined;
-        stateSaveInterval?: number | undefined;
-        actionTimeout?: number | undefined;
-        waitUntilTimeout?: number | undefined;
-        connectionLivenessTimeout?: number | undefined;
-        connectionLivenessInterval?: number | undefined;
-        noSleep?: boolean | undefined;
-        sleepTimeout?: number | undefined;
-        canHibernatWebSocket?: boolean | ((args_0: Request, ...args: unknown[]) => boolean) | undefined;
-    } | undefined;
-    onCreate?: ((...args: unknown[]) => unknown) | undefined;
-    onStart?: ((...args: unknown[]) => unknown) | undefined;
-    onStop?: ((...args: unknown[]) => unknown) | undefined;
-    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
-    onFetch?: ((...args: unknown[]) => unknown) | undefined;
-    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
-    actions?: Record<string, (...args: unknown[]) => unknown> | undefined;
-    createState?: ((...args: unknown[]) => unknown) | undefined;
-    connState?: any;
-    createConnState?: ((...args: unknown[]) => unknown) | undefined;
-    vars?: any;
-    db?: any;
-    createVars?: ((...args: unknown[]) => unknown) | undefined;
-}>;
-interface OnConnectOptions {
-    /**
-     * The request object associated with the connection.
-     *
-     * @experimental
-     */
-    request?: Request;
-}
-type CreateState<TState, TConnParams, TConnState, TVars, TInput, TDatabase> = {
-    state: TState;
-} | {
-    createState: (c: InitContext, input: TInput) => TState | Promise<TState>;
-} | Record<never, never>;
-type CreateConnState<TState, TConnParams, TConnState, TVars, TInput, TDatabase> = {
-    connState: TConnState;
-} | {
-    createConnState: (c: InitContext, opts: OnConnectOptions, params: TConnParams) => TConnState | Promise<TConnState>;
-} | Record<never, never>;
-/**
- * @experimental
- */
-type CreateVars<TState, TConnParams, TConnState, TVars, TInput, TDatabase> = {
-    /**
-     * @experimental
-     */
-    vars: TVars;
-} | {
-    /**
-     * @experimental
-     */
-    createVars: (c: InitContext, driverCtx: any) => TVars | Promise<TVars>;
-} | Record<never, never>;
-interface Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider> {
-    [Action: string]: (c: ActionContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, ...args: any[]) => any;
-}
-/**
- * @experimental
- */
-type AuthIntent = "get" | "create" | "connect" | "action" | "message";
-interface BaseActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TActions extends Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase>> {
-    /**
-     * Called when the actor is first initialized.
-     *
-     * Use this hook to initialize your actor's state.
-     * This is called before any other lifecycle hooks.
-     */
-    onCreate?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, input: TInput) => void | Promise<void>;
-    /**
-     * Called when the actor is started and ready to receive connections and action.
-     *
-     * Use this hook to initialize resources needed for the actor's operation
-     * (timers, external connections, etc.)
-     *
-     * @returns Void or a Promise that resolves when startup is complete
-     */
-    onStart?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>) => void | Promise<void>;
-    /**
-     * Called when the actor is stopping or sleeping.
-     *
-     * Use this hook to clean up resources, save state, or perform
-     * any shutdown operations before the actor sleeps or stops.
-     *
-     * Not supported on all platforms.
-     *
-     * @returns Void or a Promise that resolves when shutdown is complete
-     */
-    onStop?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>) => void | Promise<void>;
-    /**
-     * Called when the actor's state changes.
-     *
-     * Use this hook to react to state changes, such as updating
-     * external systems or triggering events.
-     *
-     * State changes made within this hook will NOT trigger
-     * another onStateChange call, preventing infinite recursion.
-     *
-     * @param newState The updated state
-     */
-    onStateChange?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, newState: TState) => void;
-    /**
-     * Called before a client connects to the actor.
-     *
-     * Use this hook to determine if a connection should be accepted
-     * and to initialize connection-specific state.
-     *
-     * @param opts Connection parameters including client-provided data
-     * @returns The initial connection state or a Promise that resolves to it
-     * @throws Throw an error to reject the connection
-     */
-    onBeforeConnect?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, opts: OnConnectOptions, params: TConnParams) => void | Promise<void>;
-    /**
-     * Called when a client successfully connects to the actor.
-     *
-     * Use this hook to perform actions when a connection is established,
-     * such as sending initial data or updating the actor's state.
-     *
-     * @param conn The connection object
-     * @returns Void or a Promise that resolves when connection handling is complete
-     */
-    onConnect?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, conn: Conn<TState, TConnParams, TConnState, TVars, TInput, TDatabase>) => void | Promise<void>;
-    /**
-     * Called when a client disconnects from the actor.
-     *
-     * Use this hook to clean up resources associated with the connection
-     * or update the actor's state.
-     *
-     * @param conn The connection that is being closed
-     * @returns Void or a Promise that resolves when disconnect handling is complete
-     */
-    onDisconnect?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, conn: Conn<TState, TConnParams, TConnState, TVars, TInput, TDatabase>) => void | Promise<void>;
-    /**
-     * Called before sending an action response to the client.
-     *
-     * Use this hook to modify or transform the output of an action before it's sent
-     * to the client. This is useful for formatting responses, adding metadata,
-     * or applying transformations to the output.
-     *
-     * @param name The name of the action that was called
-     * @param args The arguments that were passed to the action
-     * @param output The output that will be sent to the client
-     * @returns The modified output to send to the client
-     */
-    onBeforeActionResponse?: <Out>(c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, name: string, args: unknown[], output: Out) => Out | Promise<Out>;
-    /**
-     * Called when a raw HTTP request is made to the actor.
-     *
-     * This handler receives raw HTTP requests made to `/actors/{actorName}/http/*` endpoints.
-     * Use this hook to handle custom HTTP patterns, REST APIs, or other HTTP-based protocols.
-     *
-     * @param request The raw HTTP request object
-     * @returns A Response object to send back, or void to continue with default routing
-     */
-    onFetch?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, request: Request, opts: {}) => Response | Promise<Response>;
-    /**
-     * Called when a raw WebSocket connection is established to the actor.
-     *
-     * This handler receives WebSocket connections made to `/actors/{actorName}/websocket/*` endpoints.
-     * Use this hook to handle custom WebSocket protocols, binary streams, or other WebSocket-based communication.
-     *
-     * @param websocket The raw WebSocket connection
-     * @param request The original HTTP upgrade request
-     */
-    onWebSocket?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, websocket: UniversalWebSocket, opts: {
-        request: Request;
-    }) => void | Promise<void>;
-    actions: TActions;
-}
-type ActorDatabaseConfig<TDatabase extends AnyDatabaseProvider> = {
-    /**
-     * @experimental
-     */
-    db: TDatabase;
-} | Record<never, never>;
-type ActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider> = Omit<z.infer<typeof ActorConfigSchema>, "actions" | "onCreate" | "onStart" | "onStateChange" | "onBeforeConnect" | "onConnect" | "onDisconnect" | "onBeforeActionResponse" | "onFetch" | "onWebSocket" | "state" | "createState" | "connState" | "createConnState" | "vars" | "createVars" | "db"> & BaseActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase, Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase>> & CreateState<TState, TConnParams, TConnState, TVars, TInput, TDatabase> & CreateConnState<TState, TConnParams, TConnState, TVars, TInput, TDatabase> & CreateVars<TState, TConnParams, TConnState, TVars, TInput, TDatabase> & ActorDatabaseConfig<TDatabase>;
-type ActorConfigInput<TState = undefined, TConnParams = undefined, TConnState = undefined, TVars = undefined, TInput = undefined, TDatabase extends AnyDatabaseProvider = undefined, TActions extends Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase> = Record<never, never>> = {
-    types?: ActorTypes<TState, TConnParams, TConnState, TVars, TInput, TDatabase>;
-} & Omit<z.input<typeof ActorConfigSchema>, "actions" | "onCreate" | "onStart" | "onStop" | "onStateChange" | "onBeforeConnect" | "onConnect" | "onDisconnect" | "onBeforeActionResponse" | "onFetch" | "onWebSocket" | "state" | "createState" | "connState" | "createConnState" | "vars" | "createVars" | "db"> & BaseActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TActions> & CreateState<TState, TConnParams, TConnState, TVars, TInput, TDatabase> & CreateConnState<TState, TConnParams, TConnState, TVars, TInput, TDatabase> & CreateVars<TState, TConnParams, TConnState, TVars, TInput, TDatabase> & ActorDatabaseConfig<TDatabase>;
-declare function test<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TActions extends Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase>>(input: ActorConfigInput<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TActions>): ActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase>;
-
-declare const ActorId: z__default.core.$ZodBranded<z__default.ZodString, "ActorId">;
-type ActorId = z__default.infer<typeof ActorId>;
-declare enum ActorFeature {
-    Logs = "logs",
-    Config = "config",
-    Connections = "connections",
-    State = "state",
-    Console = "console",
-    Runtime = "runtime",
-    Metrics = "metrics",
-    EventsMonitoring = "events-monitoring",
-    Database = "database"
+declare const ActorId: z__default.core.$ZodBranded<z__default.ZodString, "ActorId">;
+type ActorId = z__default.infer<typeof ActorId>;
+declare enum ActorFeature {
+    Logs = "logs",
+    Config = "config",
+    Connections = "connections",
+    State = "state",
+    Console = "console",
+    Runtime = "runtime",
+    Metrics = "metrics",
+    EventsMonitoring = "events-monitoring",
+    Database = "database"
 }
 declare const ActorSchema: z__default.ZodObject<{
     id: z__default.core.$ZodBranded<z__default.ZodString, "ActorId">;
@@ -1958,7 +1353,7 @@ type Tables = z__default.infer<typeof TablesSchema>;
 declare const ColumnSchema: z__default.ZodObject<{
     cid: z__default.ZodNumber;
     name: z__default.ZodString;
-    type: z__default.ZodPipe<z__default.ZodString, z__default.ZodTransform<"integer" | "blob" | "text" | "real" | "numeric" | "serial", string>>;
+    type: z__default.ZodPipe<z__default.ZodString, z__default.ZodTransform<"blob" | "integer" | "text" | "real" | "numeric" | "serial", string>>;
     notnull: z__default.ZodCoercedBoolean<unknown>;
     dflt_value: z__default.ZodNullable<z__default.ZodString>;
     pk: z__default.ZodNullable<z__default.ZodCoercedBoolean<unknown>>;
@@ -1967,7 +1362,7 @@ type Column = z__default.infer<typeof ColumnSchema>;
 declare const ColumnsSchema: z__default.ZodArray<z__default.ZodObject<{
     cid: z__default.ZodNumber;
     name: z__default.ZodString;
-    type: z__default.ZodPipe<z__default.ZodString, z__default.ZodTransform<"integer" | "blob" | "text" | "real" | "numeric" | "serial", string>>;
+    type: z__default.ZodPipe<z__default.ZodString, z__default.ZodTransform<"blob" | "integer" | "text" | "real" | "numeric" | "serial", string>>;
     notnull: z__default.ZodCoercedBoolean<unknown>;
     dflt_value: z__default.ZodNullable<z__default.ZodString>;
     pk: z__default.ZodNullable<z__default.ZodCoercedBoolean<unknown>>;
@@ -2006,390 +1401,1067 @@ declare const CreateActorSchema: z__default.ZodObject<{
 }, z__default.core.$strip>;
 type CreateActor = z__default.infer<typeof CreateActorSchema>;
 
-interface ActorInspectorAccessors {
-    isStateEnabled: () => Promise<boolean>;
-    getState: () => Promise<unknown>;
-    setState: (state: unknown) => Promise<void>;
-    isDbEnabled: () => Promise<boolean>;
-    getDb: () => Promise<InferDatabaseClient<AnyDatabaseProvider>>;
-    getRpcs: () => Promise<string[]>;
-    getConnections: () => Promise<Connection[]>;
-    executeAction: (name: string, params?: unknown[]) => Promise<unknown>;
+interface ActorInspectorAccessors {
+    isStateEnabled: () => Promise<boolean>;
+    getState: () => Promise<unknown>;
+    setState: (state: unknown) => Promise<void>;
+    isDbEnabled: () => Promise<boolean>;
+    getDb: () => Promise<InferDatabaseClient<AnyDatabaseProvider>>;
+    getRpcs: () => Promise<string[]>;
+    getConnections: () => Promise<Connection[]>;
+    executeAction: (name: string, params?: unknown[]) => Promise<unknown>;
+}
+interface ActorInspectorEmitterEvents {
+    stateUpdated: (state: unknown) => void;
+    connectionUpdated: () => void;
+    eventFired: (event: RealtimeEvent) => void;
+}
+/**
+ * Provides a unified interface for inspecting actor external and internal state.
+ */
+declare class ActorInspector {
+    #private;
+    readonly accessors: ActorInspectorAccessors;
+    readonly emitter: nanoevents.Emitter<ActorInspectorEmitterEvents>;
+    get lastRealtimeEvents(): (({
+        type: "action";
+        name: string;
+        args: any[];
+        connId: string;
+    } | {
+        type: "broadcast";
+        eventName: string;
+        args: any[];
+    } | {
+        type: "subscribe";
+        eventName: string;
+        connId: string;
+    } | {
+        type: "unsubscribe";
+        eventName: string;
+        connId: string;
+    } | {
+        type: "event";
+        eventName: string;
+        args: any[];
+        connId: string;
+    }) & {
+        id: string;
+        timestamp: number;
+    })[];
+    constructor(accessors: () => ActorInspectorAccessors);
+}
+
+declare enum DriverReadyState {
+    UNKNOWN = -1,
+    CONNECTING = 0,
+    OPEN = 1,
+    CLOSING = 2,
+    CLOSED = 3
+}
+interface ConnDriver {
+    /** The type of driver. Used for debug purposes only. */
+    type: string;
+    /**
+     * If defined, this connection driver talks the RivetKit client driver (see
+     * schemas/client-protocol/).
+     *
+     * If enabled, events like `Init`, subscription events, etc. will be sent
+     * to this connection.
+     */
+    rivetKitProtocol?: {
+        /** Sends a RivetKit client message. */
+        sendMessage(actor: AnyActorInstance, conn: AnyConn, message: CachedSerializer<any, any, any>): void;
+    };
+    /**
+     * If the connection can be hibernated. If true, this will allow the actor to go to sleep while the connection is still active.
+     **/
+    hibernatable?: {
+        gatewayId: ArrayBuffer;
+        requestId: ArrayBuffer;
+    };
+    /**
+     * This returns a promise since we commonly disconnect at the end of a program, and not waiting will cause the socket to not close cleanly.
+     */
+    disconnect(actor: AnyActorInstance, conn: AnyConn, reason?: string): Promise<void>;
+    /** Terminates the connection without graceful handling. */
+    terminate?(actor: AnyActorInstance, conn: AnyConn): void;
+    /**
+     * Returns the ready state of the connection.
+     * This is used to determine if the connection is ready to send messages, or if the connection is stale.
+     */
+    getConnectionReadyState(actor: AnyActorInstance, conn: AnyConn): DriverReadyState | undefined;
+}
+
+/**
+ * Persisted data structures for connections.
+ *
+ * Keep this file in sync with the Connection section of rivetkit-typescript/packages/rivetkit/schemas/actor-persist/
+ */
+
+type GatewayId = ArrayBuffer;
+type RequestId = ArrayBuffer;
+/** Event subscription for connection */
+interface PersistedSubscription {
+    eventName: string;
+}
+/** Connection associated with hibernatable WebSocket that should persist across lifecycles */
+interface PersistedConn<CP, CS> {
+    /** Connection ID generated by RivetKit */
+    id: string;
+    parameters: CP;
+    state: CS;
+    subscriptions: PersistedSubscription[];
+    gatewayId: GatewayId;
+    requestId: RequestId;
+    serverMessageIndex: number;
+    clientMessageIndex: number;
+    requestPath: string;
+    requestHeaders: Record<string, string>;
+}
+
+/**
+ * Manages all connection-related operations for an actor instance.
+ * Handles connection creation, tracking, hibernation, and cleanup.
+ */
+declare class ConnectionManager<S, CP, CS, V, I, DB extends AnyDatabaseProvider> {
+    #private;
+    constructor(actor: ActorInstance<S, CP, CS, V, I, DB>);
+    get connections(): Map<ConnId, Conn<S, CP, CS, V, I, DB>>;
+    getConnForId(id: string): Conn<S, CP, CS, V, I, DB> | undefined;
+    get connsWithPersistChanged(): Set<ConnId>;
+    clearConnWithPersistChanged(): void;
+    markConnWithPersistChanged(conn: Conn<S, CP, CS, V, I, DB>): void;
+    /**
+     * Handles pre-connection logic (i.e. auth & create state) before actually connecting the connection.
+     */
+    prepareConn(driver: ConnDriver, params: CP, request: Request | undefined, requestPath: string | undefined, requestHeaders: Record<string, string> | undefined, isHibernatable: boolean, isRestoringHibernatable: boolean): Promise<Conn<S, CP, CS, V, I, DB>>;
+    /**
+     * Adds a connection form prepareConn to the actor and calls onConnect.
+     *
+     * This method is intentionally not async since it needs to be called in
+     * `onOpen` for WebSockets. If this is async, the order of open events will
+     * be messed up and cause race conditions that can drop WebSocket messages.
+     * So all async work in prepareConn.
+     */
+    connectConn(conn: Conn<S, CP, CS, V, I, DB>): void;
+    /**
+     * Handle connection disconnection.
+     *
+     * This is called by `Conn.disconnect`. This should not call `Conn.disconnect.`
+     */
+    connDisconnected(conn: Conn<S, CP, CS, V, I, DB>): Promise<void>;
+    /**
+     * Utilify function for call sites that don't need a separate prepare and connect phase.
+     */
+    prepareAndConnectConn(driver: ConnDriver, params: CP, request: Request | undefined, requestPath: string | undefined, requestHeaders: Record<string, string> | undefined): Promise<Conn<S, CP, CS, V, I, DB>>;
+    /**
+     * Restores connections from persisted data during actor initialization.
+     */
+    restoreConnections(connections: PersistedConn<CP, CS>[]): void;
+    findHibernatableConn(gatewayIdBuf: ArrayBuffer, requestIdBuf: ArrayBuffer): Conn<S, CP, CS, V, I, DB> | undefined;
+}
+
+/**
+ * Manages event subscriptions and broadcasting for actor instances.
+ * Handles subscription tracking and efficient message distribution to connected clients.
+ */
+declare class EventManager<S, CP, CS, V, I, DB extends AnyDatabaseProvider> {
+    #private;
+    constructor(actor: ActorInstance<S, CP, CS, V, I, DB>);
+    /**
+     * Adds a subscription for a connection to an event.
+     *
+     * @param eventName - The name of the event to subscribe to
+     * @param connection - The connection subscribing to the event
+     * @param fromPersist - Whether this subscription is being restored from persistence
+     */
+    addSubscription(eventName: string, connection: Conn<S, CP, CS, V, I, DB>, fromPersist: boolean): void;
+    /**
+     * Removes a subscription for a connection from an event.
+     *
+     * @param eventName - The name of the event to unsubscribe from
+     * @param connection - The connection unsubscribing from the event
+     * @param fromRemoveConn - Whether this is being called as part of connection removal
+     */
+    removeSubscription(eventName: string, connection: Conn<S, CP, CS, V, I, DB>, fromRemoveConn: boolean): void;
+    /**
+     * Broadcasts an event to all subscribed connections.
+     *
+     * @param name - The name of the event to broadcast
+     * @param args - The arguments to send with the event
+     */
+    broadcast<Args extends Array<unknown>>(name: string, ...args: Args): void;
+    /**
+     * Gets all subscribers for a specific event.
+     *
+     * @param eventName - The name of the event
+     * @returns Set of connections subscribed to the event, or undefined if no subscribers
+     */
+    getSubscribers(eventName: string): Set<Conn<S, CP, CS, V, I, DB>> | undefined;
+    /**
+     * Gets all events and their subscriber counts.
+     *
+     * @returns Map of event names to subscriber counts
+     */
+    getEventStats(): Map<string, number>;
+    /**
+     * Clears all subscriptions for a connection.
+     * Used during connection cleanup.
+     *
+     * @param connection - The connection to clear subscriptions for
+     */
+    clearConnectionSubscriptions(connection: Conn<S, CP, CS, V, I, DB>): void;
+    /**
+     * Gets the total number of unique events being subscribed to.
+     */
+    get eventCount(): number;
+    /**
+     * Gets the total number of subscriptions across all events.
+     */
+    get totalSubscriptionCount(): number;
+    /**
+     * Checks if an event has any subscribers.
+     *
+     * @param eventName - The name of the event to check
+     * @returns True if the event has at least one subscriber
+     */
+    hasSubscribers(eventName: string): boolean;
+}
+
+/**
+ * Persisted data structures for actors.
+ *
+ * Keep this file in sync with the Connection section of rivetkit-typescript/packages/rivetkit/schemas/actor-persist/
+ */
+
+type Cbor = ArrayBuffer;
+/** Scheduled event to be executed at a specific timestamp */
+interface PersistedScheduleEvent {
+    eventId: string;
+    timestamp: number;
+    action: string;
+    args?: Cbor;
 }
-interface ActorInspectorEmitterEvents {
-    stateUpdated: (state: unknown) => void;
-    connectionUpdated: () => void;
-    eventFired: (event: RealtimeEvent) => void;
+/** State object that gets automatically persisted to storage */
+interface PersistedActor<S, I> {
+    /** Input data passed to the actor on initialization */
+    input?: I;
+    hasInitialized: boolean;
+    state: S;
+    scheduledEvents: PersistedScheduleEvent[];
+}
+
+interface SaveStateOptions {
+    /**
+     * Forces the state to be saved immediately. This function will return when the state has saved successfully.
+     */
+    immediate?: boolean;
+    /** Bypass ready check for stopping. */
+    allowStoppingState?: boolean;
+    /**
+     * Maximum time in milliseconds to wait before forcing a save.
+     *
+     * If a save is already scheduled to occur later than this deadline, it will be rescheduled earlier.
+     */
+    maxWait?: number;
 }
 /**
- * Provides a unified interface for inspecting actor external and internal state.
+ * Manages actor state persistence, proxying, and synchronization.
+ * Handles automatic state change detection and throttled persistence to KV storage.
  */
-declare class ActorInspector {
+declare class StateManager$1<S, CP, CS, I> {
     #private;
-    readonly accessors: ActorInspectorAccessors;
-    readonly emitter: nanoevents.Emitter<ActorInspectorEmitterEvents>;
-    get lastRealtimeEvents(): (({
-        type: "action";
-        name: string;
-        args: any[];
-        connId: string;
-    } | {
-        type: "broadcast";
-        eventName: string;
-        args: any[];
-    } | {
-        type: "subscribe";
-        eventName: string;
-        connId: string;
-    } | {
-        type: "unsubscribe";
+    constructor(actor: ActorInstance<S, CP, CS, any, I, any>, actorDriver: ActorDriver, config: any);
+    get persist(): PersistedActor<S, I>;
+    get persistRaw(): PersistedActor<S, I>;
+    get persistChanged(): boolean;
+    get state(): S;
+    set state(value: S);
+    get stateEnabled(): boolean;
+    /**
+     * Initializes state from persisted data or creates new state.
+     */
+    initializeState(persistData: PersistedActor<S, I>): Promise<void>;
+    /**
+     * Creates proxy for persist object that handles automatic state change detection.
+     */
+    initPersistProxy(target: PersistedActor<S, I>): undefined;
+    /**
+     * Forces the state to get saved.
+     */
+    saveState(opts: SaveStateOptions): Promise<void>;
+    /**
+     * Throttled save state method. Used to write to KV at a reasonable cadence.
+     *
+     * Passing a maxWait will override the stateSaveInterval with the min
+     * between that and the maxWait.
+     */
+    savePersistThrottled(maxWait?: number): void;
+    /**
+     * Clears any pending save timeout.
+     */
+    clearPendingSaveTimeout(): void;
+    /**
+     * Waits for any pending write operations to complete.
+     */
+    waitForPendingWrites(): Promise<void>;
+}
+
+/** Actor type alias with all `any` types. Used for `extends` in classes referencing this actor. */
+type AnyActorInstance = ActorInstance<any, any, any, any, any, any>;
+declare class ActorInstance<S, CP, CS, V, I, DB extends AnyDatabaseProvider> {
+    #private;
+    actorContext: ActorContext<S, CP, CS, V, I, DB>;
+    driver: ActorDriver;
+    connectionManager: ConnectionManager<S, CP, CS, V, I, DB>;
+    stateManager: StateManager$1<S, CP, CS, I>;
+    eventManager: EventManager<S, CP, CS, V, I, DB>;
+    constructor(config: ActorConfig<S, CP, CS, V, I, DB>);
+    get log(): Logger;
+    get rLog(): Logger;
+    get isStopping(): boolean;
+    get id(): string;
+    get name(): string;
+    get key(): ActorKey;
+    get region(): string;
+    get inlineClient(): Client<Registry<any>>;
+    get inspector(): ActorInspector;
+    get inspectorToken(): string | undefined;
+    get conns(): Map<ConnId, Conn<S, CP, CS, V, I, DB>>;
+    get schedule(): Schedule;
+    get abortSignal(): AbortSignal;
+    get actions(): string[];
+    get config(): ActorConfig<S, CP, CS, V, I, DB>;
+    get persist(): PersistedActor<S, I>;
+    get state(): S;
+    set state(value: S);
+    get stateEnabled(): boolean;
+    get connStateEnabled(): boolean;
+    get vars(): V;
+    get db(): InferDatabaseClient<DB>;
+    start(actorDriver: ActorDriver, inlineClient: Client<Registry<any>>, actorId: string, name: string, key: ActorKey, region: string): Promise<void>;
+    isReady(): boolean;
+    assertReady(allowStoppingState?: boolean): void;
+    onStop(mode: "sleep" | "destroy"): Promise<void>;
+    startSleep(): void;
+    startDestroy(): void;
+    beginHonoHttpRequest(): void;
+    endHonoHttpRequest(): void;
+    processMessage(message: {
+        body: {
+            tag: "ActionRequest";
+            val: {
+                id: bigint;
+                name: string;
+                args: unknown;
+            };
+        } | {
+            tag: "SubscriptionRequest";
+            val: {
+                eventName: string;
+                subscribe: boolean;
+            };
+        };
+    }, conn: Conn<S, CP, CS, V, I, DB>): Promise<void>;
+    executeAction(ctx: ActionContext<S, CP, CS, V, I, DB>, actionName: string, args: unknown[]): Promise<unknown>;
+    handleRawRequest(conn: Conn<S, CP, CS, V, I, DB>, request: Request): Promise<Response>;
+    handleRawWebSocket(conn: Conn<S, CP, CS, V, I, DB>, websocket: UniversalWebSocket, request?: Request): void;
+    scheduleEvent(timestamp: number, action: string, args: unknown[]): Promise<void>;
+    onAlarm(): Promise<void>;
+    waitUntil(promise: Promise<void>): void;
+    resetSleepTimer(): void;
+}
+
+/** Pick a subset of persisted data used to represent ephemeral connections */
+type EphemeralConn<CP, CS> = Pick<PersistedConn<CP, CS>, "id" | "parameters" | "state">;
+type ConnDataInput<CP, CS> = {
+    ephemeral: EphemeralConn<CP, CS>;
+} | {
+    hibernatable: PersistedConn<CP, CS>;
+};
+/**
+ * Manages connection state persistence, proxying, and change tracking.
+ * Handles automatic state change detection for connection-specific state.
+ */
+declare class StateManager<CP, CS> {
+    #private;
+    constructor(conn: Conn<any, CP, CS, any, any, any>, data: ConnDataInput<CP, CS>);
+    /**
+     * Returns the ephemeral or persisted data for this connectioned.
+     *
+     * This property is used to be able to treat both memory & persist conns
+     * identical by looking up the correct underlying data structure.
+     */
+    get ephemeralData(): EphemeralConn<CP, CS>;
+    get hibernatableData(): PersistedConn<CP, CS> | undefined;
+    hibernatableDataOrError(): PersistedConn<CP, CS>;
+    get hibernatableDataRaw(): PersistedConn<CP, CS> | undefined;
+    get stateEnabled(): boolean;
+    get state(): CS;
+    set state(value: CS);
+    addSubscription({ eventName }: {
         eventName: string;
-        connId: string;
-    } | {
-        type: "event";
+    }): void;
+    removeSubscription({ eventName }: {
         eventName: string;
-        args: any[];
-        connId: string;
-    }) & {
-        id: string;
-        timestamp: number;
-    })[];
-    constructor(accessors: () => ActorInspectorAccessors);
+    }): boolean | undefined;
+}
+
+type ConnId = string;
+type AnyConn = Conn<any, any, any, any, any, any>;
+declare const CONN_CONNECTED_SYMBOL: unique symbol;
+declare const CONN_SPEAKS_RIVETKIT_SYMBOL: unique symbol;
+declare const CONN_DRIVER_SYMBOL: unique symbol;
+declare const CONN_ACTOR_SYMBOL: unique symbol;
+declare const CONN_STATE_MANAGER_SYMBOL: unique symbol;
+declare const CONN_SEND_MESSAGE_SYMBOL: unique symbol;
+/**
+ * Represents a client connection to a actor.
+ *
+ * Manages connection-specific data and controls the connection lifecycle.
+ *
+ * @see {@link https://rivet.dev/docs/connections|Connection Documentation}
+ */
+declare class Conn<S, CP, CS, V, I, DB extends AnyDatabaseProvider> {
+    #private;
+    get [CONN_ACTOR_SYMBOL](): ActorInstance<S, CP, CS, V, I, DB>;
+    get [CONN_STATE_MANAGER_SYMBOL](): StateManager<CP, CS>;
+    /**
+     * Connections exist before being connected to an actor. If true, this
+     * connection has been connected.
+     **/
+    [CONN_CONNECTED_SYMBOL]: boolean;
+    /**
+     * If undefined, then no socket is connected to this conn
+     */
+    [CONN_DRIVER_SYMBOL]?: ConnDriver;
+    /**
+     * If this connection is speaking the RivetKit protocol. If false, this is
+     * a raw connection for WebSocket or fetch or inspector.
+     **/
+    get [CONN_SPEAKS_RIVETKIT_SYMBOL](): boolean;
+    subscriptions: Set<string>;
+    get params(): CP;
+    /**
+     * Gets the current state of the connection.
+     *
+     * Throws an error if the state is not enabled.
+     */
+    get state(): CS;
+    /**
+     * Sets the state of the connection.
+     *
+     * Throws an error if the state is not enabled.
+     */
+    set state(value: CS);
+    /**
+     * Unique identifier for the connection.
+     */
+    get id(): ConnId;
+    /**
+     * @experimental
+     *
+     * If the underlying connection can hibernate.
+     */
+    get isHibernatable(): boolean;
+    /**
+     * Initializes a new instance of the Connection class.
+     *
+     * This should only be constructed by {@link Actor}.
+     *
+     * @protected
+     */
+    constructor(actor: ActorInstance<S, CP, CS, V, I, DB>, data: ConnDataInput<CP, CS>);
+    /**
+     * Sends a raw message to the underlying connection.
+     */
+    [CONN_SEND_MESSAGE_SYMBOL](message: CachedSerializer<any, any, any>): void;
+    /**
+     * Sends an event with arguments to the client.
+     *
+     * @param eventName - The name of the event.
+     * @param args - The arguments for the event.
+     * @see {@link https://rivet.dev/docs/events|Events Documentation}
+     */
+    send(eventName: string, ...args: unknown[]): void;
+    /**
+     * Disconnects the client with an optional reason.
+     *
+     * @param reason - The reason for disconnection.
+     */
+    disconnect(reason?: string): Promise<void>;
 }
 
-interface ConnSocket {
-    requestId: string;
-    requestIdBuf?: ArrayBuffer;
-    hibernatable: boolean;
-    driverState: ConnDriverState;
+/**
+ * Base context for connection initialization handlers.
+ * Extends ActorContext with request-specific functionality for connection lifecycle events.
+ */
+declare abstract class ConnInitContext<TState, TVars, TInput, TDatabase extends AnyDatabaseProvider> extends ActorContext<TState, undefined, undefined, TVars, TInput, TDatabase> {
+    /**
+     * The incoming request that initiated the connection.
+     * May be undefined for connections initiated without a direct HTTP request.
+     */
+    readonly request: Request | undefined;
 }
 
-/** State object that gets automatically persisted to storage. */
-interface PersistedActor<S, CP, CS, I> {
-    input?: I;
-    hasInitiated: boolean;
-    state: S;
-    connections: PersistedConn<CP, CS>[];
-    scheduledEvents: PersistedScheduleEvent[];
-    hibernatableWebSocket: PersistedHibernatableWebSocket[];
+/**
+ * Context for the createConnState lifecycle hook.
+ * Called to initialize connection-specific state when a connection is created.
+ */
+declare class CreateConnStateContext<TState, TVars, TInput, TDatabase extends AnyDatabaseProvider> extends ConnInitContext<TState, TVars, TInput, TDatabase> {
 }
-/** Object representing connection that gets persisted to storage. */
-interface PersistedConn<CP, CS> {
-    connId: string;
-    token: string;
-    params: CP;
-    state: CS;
-    subscriptions: PersistedSubscription[];
-    /** Last time the socket was seen. This is set when disconnected so we can determine when we need to clean this up. */
-    lastSeen: number;
-    /** Request ID of the hibernatable WebSocket. See PersistedActor.hibernatableWebSocket */
-    hibernatableRequestId?: ArrayBuffer;
+
+/**
+ * Context for the onBeforeConnect lifecycle hook.
+ * Called before a connection is established, allowing for validation and early rejection.
+ */
+declare class OnBeforeConnectContext<TState, TVars, TInput, TDatabase extends AnyDatabaseProvider> extends ConnInitContext<TState, TVars, TInput, TDatabase> {
 }
-interface PersistedSubscription {
-    eventName: string;
+
+/**
+ * Context for the onConnect lifecycle hook.
+ * Called when a connection is successfully established.
+ */
+declare class OnConnectContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider> extends ConnContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase> {
 }
-interface GenericPersistedScheduleEvent {
-    actionName: string;
-    args: ArrayBuffer | null;
+
+/**
+ * Context for raw HTTP request handlers (onRequest).
+ */
+declare class RequestContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider> extends ConnContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase> {
+    /**
+     * The incoming HTTP request.
+     * May be undefined for request contexts initiated without a direct HTTP request.
+     */
+    readonly request: Request | undefined;
 }
-type PersistedScheduleEventKind = {
-    generic: GenericPersistedScheduleEvent;
-};
-interface PersistedScheduleEvent {
-    eventId: string;
-    timestamp: number;
-    kind: PersistedScheduleEventKind;
+
+/**
+ * Context for raw WebSocket handlers (onWebSocket).
+ */
+declare class WebSocketContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider> extends ConnContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase> {
+    /**
+     * The incoming HTTP request that initiated the WebSocket upgrade.
+     * May be undefined for WebSocket connections initiated without a direct HTTP request.
+     */
+    readonly request: Request | undefined;
 }
-interface PersistedHibernatableWebSocket {
-    requestId: ArrayBuffer;
-    lastSeenTimestamp: bigint;
-    msgIndex: bigint;
+
+type InitContext = ActorContext<undefined, undefined, undefined, undefined, undefined, undefined>;
+interface ActorTypes<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider> {
+    state?: TState;
+    connParams?: TConnParams;
+    connState?: TConnState;
+    vars?: TVars;
+    input?: TInput;
+    database?: TDatabase;
 }
-
-declare const PERSIST_SYMBOL: unique symbol;
+declare const ActorConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodObject<{
+    onCreate: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    onDestroy: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    onWake: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    onSleep: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    onStateChange: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    onBeforeConnect: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    onConnect: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    onDisconnect: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    onBeforeActionResponse: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    onRequest: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    onWebSocket: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    actions: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>>;
+    state: z.ZodOptional<z.ZodAny>;
+    createState: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    connState: z.ZodOptional<z.ZodAny>;
+    createConnState: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    vars: z.ZodOptional<z.ZodAny>;
+    db: z.ZodOptional<z.ZodAny>;
+    createVars: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    options: z.ZodDefault<z.ZodObject<{
+        createVarsTimeout: z.ZodDefault<z.ZodNumber>;
+        createConnStateTimeout: z.ZodDefault<z.ZodNumber>;
+        onConnectTimeout: z.ZodDefault<z.ZodNumber>;
+        onSleepTimeout: z.ZodDefault<z.ZodNumber>;
+        onDestroyTimeout: z.ZodDefault<z.ZodNumber>;
+        stateSaveInterval: z.ZodDefault<z.ZodNumber>;
+        actionTimeout: z.ZodDefault<z.ZodNumber>;
+        waitUntilTimeout: z.ZodDefault<z.ZodNumber>;
+        connectionLivenessTimeout: z.ZodDefault<z.ZodNumber>;
+        connectionLivenessInterval: z.ZodDefault<z.ZodNumber>;
+        noSleep: z.ZodDefault<z.ZodBoolean>;
+        sleepTimeout: z.ZodDefault<z.ZodNumber>;
+        /**
+         * Can hibernate WebSockets for onWebSocket.
+         *
+         * WebSockets using actions/events are hibernatable by default.
+         *
+         * @experimental
+         **/
+        canHibernateWebSocket: z.ZodDefault<z.ZodUnion<[z.ZodBoolean, z.ZodFunction<z.ZodTuple<[z.ZodType<Request, z.ZodTypeDef, Request>], z.ZodUnknown>, z.ZodBoolean>]>>;
+    }, "strict", z.ZodTypeAny, {
+        createVarsTimeout: number;
+        createConnStateTimeout: number;
+        onConnectTimeout: number;
+        onSleepTimeout: number;
+        onDestroyTimeout: number;
+        stateSaveInterval: number;
+        actionTimeout: number;
+        waitUntilTimeout: number;
+        connectionLivenessTimeout: number;
+        connectionLivenessInterval: number;
+        noSleep: boolean;
+        sleepTimeout: number;
+        canHibernateWebSocket: boolean | ((args_0: Request, ...args: unknown[]) => boolean);
+    }, {
+        createVarsTimeout?: number | undefined;
+        createConnStateTimeout?: number | undefined;
+        onConnectTimeout?: number | undefined;
+        onSleepTimeout?: number | undefined;
+        onDestroyTimeout?: number | undefined;
+        stateSaveInterval?: number | undefined;
+        actionTimeout?: number | undefined;
+        waitUntilTimeout?: number | undefined;
+        connectionLivenessTimeout?: number | undefined;
+        connectionLivenessInterval?: number | undefined;
+        noSleep?: boolean | undefined;
+        sleepTimeout?: number | undefined;
+        canHibernateWebSocket?: boolean | ((args_0: Request, ...args: unknown[]) => boolean) | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    options: {
+        createVarsTimeout: number;
+        createConnStateTimeout: number;
+        onConnectTimeout: number;
+        onSleepTimeout: number;
+        onDestroyTimeout: number;
+        stateSaveInterval: number;
+        actionTimeout: number;
+        waitUntilTimeout: number;
+        connectionLivenessTimeout: number;
+        connectionLivenessInterval: number;
+        noSleep: boolean;
+        sleepTimeout: number;
+        canHibernateWebSocket: boolean | ((args_0: Request, ...args: unknown[]) => boolean);
+    };
+    actions: Record<string, (...args: unknown[]) => unknown>;
+    state?: any;
+    onCreate?: ((...args: unknown[]) => unknown) | undefined;
+    onDestroy?: ((...args: unknown[]) => unknown) | undefined;
+    onWake?: ((...args: unknown[]) => unknown) | undefined;
+    onSleep?: ((...args: unknown[]) => unknown) | undefined;
+    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
+    onRequest?: ((...args: unknown[]) => unknown) | undefined;
+    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
+    createState?: ((...args: unknown[]) => unknown) | undefined;
+    connState?: any;
+    createConnState?: ((...args: unknown[]) => unknown) | undefined;
+    vars?: any;
+    db?: any;
+    createVars?: ((...args: unknown[]) => unknown) | undefined;
+}, {
+    options?: {
+        createVarsTimeout?: number | undefined;
+        createConnStateTimeout?: number | undefined;
+        onConnectTimeout?: number | undefined;
+        onSleepTimeout?: number | undefined;
+        onDestroyTimeout?: number | undefined;
+        stateSaveInterval?: number | undefined;
+        actionTimeout?: number | undefined;
+        waitUntilTimeout?: number | undefined;
+        connectionLivenessTimeout?: number | undefined;
+        connectionLivenessInterval?: number | undefined;
+        noSleep?: boolean | undefined;
+        sleepTimeout?: number | undefined;
+        canHibernateWebSocket?: boolean | ((args_0: Request, ...args: unknown[]) => boolean) | undefined;
+    } | undefined;
+    state?: any;
+    onCreate?: ((...args: unknown[]) => unknown) | undefined;
+    onDestroy?: ((...args: unknown[]) => unknown) | undefined;
+    onWake?: ((...args: unknown[]) => unknown) | undefined;
+    onSleep?: ((...args: unknown[]) => unknown) | undefined;
+    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
+    onRequest?: ((...args: unknown[]) => unknown) | undefined;
+    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
+    actions?: Record<string, (...args: unknown[]) => unknown> | undefined;
+    createState?: ((...args: unknown[]) => unknown) | undefined;
+    connState?: any;
+    createConnState?: ((...args: unknown[]) => unknown) | undefined;
+    vars?: any;
+    db?: any;
+    createVars?: ((...args: unknown[]) => unknown) | undefined;
+}>, {
+    options: {
+        createVarsTimeout: number;
+        createConnStateTimeout: number;
+        onConnectTimeout: number;
+        onSleepTimeout: number;
+        onDestroyTimeout: number;
+        stateSaveInterval: number;
+        actionTimeout: number;
+        waitUntilTimeout: number;
+        connectionLivenessTimeout: number;
+        connectionLivenessInterval: number;
+        noSleep: boolean;
+        sleepTimeout: number;
+        canHibernateWebSocket: boolean | ((args_0: Request, ...args: unknown[]) => boolean);
+    };
+    actions: Record<string, (...args: unknown[]) => unknown>;
+    state?: any;
+    onCreate?: ((...args: unknown[]) => unknown) | undefined;
+    onDestroy?: ((...args: unknown[]) => unknown) | undefined;
+    onWake?: ((...args: unknown[]) => unknown) | undefined;
+    onSleep?: ((...args: unknown[]) => unknown) | undefined;
+    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
+    onRequest?: ((...args: unknown[]) => unknown) | undefined;
+    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
+    createState?: ((...args: unknown[]) => unknown) | undefined;
+    connState?: any;
+    createConnState?: ((...args: unknown[]) => unknown) | undefined;
+    vars?: any;
+    db?: any;
+    createVars?: ((...args: unknown[]) => unknown) | undefined;
+}, {
+    options?: {
+        createVarsTimeout?: number | undefined;
+        createConnStateTimeout?: number | undefined;
+        onConnectTimeout?: number | undefined;
+        onSleepTimeout?: number | undefined;
+        onDestroyTimeout?: number | undefined;
+        stateSaveInterval?: number | undefined;
+        actionTimeout?: number | undefined;
+        waitUntilTimeout?: number | undefined;
+        connectionLivenessTimeout?: number | undefined;
+        connectionLivenessInterval?: number | undefined;
+        noSleep?: boolean | undefined;
+        sleepTimeout?: number | undefined;
+        canHibernateWebSocket?: boolean | ((args_0: Request, ...args: unknown[]) => boolean) | undefined;
+    } | undefined;
+    state?: any;
+    onCreate?: ((...args: unknown[]) => unknown) | undefined;
+    onDestroy?: ((...args: unknown[]) => unknown) | undefined;
+    onWake?: ((...args: unknown[]) => unknown) | undefined;
+    onSleep?: ((...args: unknown[]) => unknown) | undefined;
+    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
+    onRequest?: ((...args: unknown[]) => unknown) | undefined;
+    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
+    actions?: Record<string, (...args: unknown[]) => unknown> | undefined;
+    createState?: ((...args: unknown[]) => unknown) | undefined;
+    connState?: any;
+    createConnState?: ((...args: unknown[]) => unknown) | undefined;
+    vars?: any;
+    db?: any;
+    createVars?: ((...args: unknown[]) => unknown) | undefined;
+}>, {
+    options: {
+        createVarsTimeout: number;
+        createConnStateTimeout: number;
+        onConnectTimeout: number;
+        onSleepTimeout: number;
+        onDestroyTimeout: number;
+        stateSaveInterval: number;
+        actionTimeout: number;
+        waitUntilTimeout: number;
+        connectionLivenessTimeout: number;
+        connectionLivenessInterval: number;
+        noSleep: boolean;
+        sleepTimeout: number;
+        canHibernateWebSocket: boolean | ((args_0: Request, ...args: unknown[]) => boolean);
+    };
+    actions: Record<string, (...args: unknown[]) => unknown>;
+    state?: any;
+    onCreate?: ((...args: unknown[]) => unknown) | undefined;
+    onDestroy?: ((...args: unknown[]) => unknown) | undefined;
+    onWake?: ((...args: unknown[]) => unknown) | undefined;
+    onSleep?: ((...args: unknown[]) => unknown) | undefined;
+    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
+    onRequest?: ((...args: unknown[]) => unknown) | undefined;
+    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
+    createState?: ((...args: unknown[]) => unknown) | undefined;
+    connState?: any;
+    createConnState?: ((...args: unknown[]) => unknown) | undefined;
+    vars?: any;
+    db?: any;
+    createVars?: ((...args: unknown[]) => unknown) | undefined;
+}, {
+    options?: {
+        createVarsTimeout?: number | undefined;
+        createConnStateTimeout?: number | undefined;
+        onConnectTimeout?: number | undefined;
+        onSleepTimeout?: number | undefined;
+        onDestroyTimeout?: number | undefined;
+        stateSaveInterval?: number | undefined;
+        actionTimeout?: number | undefined;
+        waitUntilTimeout?: number | undefined;
+        connectionLivenessTimeout?: number | undefined;
+        connectionLivenessInterval?: number | undefined;
+        noSleep?: boolean | undefined;
+        sleepTimeout?: number | undefined;
+        canHibernateWebSocket?: boolean | ((args_0: Request, ...args: unknown[]) => boolean) | undefined;
+    } | undefined;
+    state?: any;
+    onCreate?: ((...args: unknown[]) => unknown) | undefined;
+    onDestroy?: ((...args: unknown[]) => unknown) | undefined;
+    onWake?: ((...args: unknown[]) => unknown) | undefined;
+    onSleep?: ((...args: unknown[]) => unknown) | undefined;
+    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
+    onRequest?: ((...args: unknown[]) => unknown) | undefined;
+    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
+    actions?: Record<string, (...args: unknown[]) => unknown> | undefined;
+    createState?: ((...args: unknown[]) => unknown) | undefined;
+    connState?: any;
+    createConnState?: ((...args: unknown[]) => unknown) | undefined;
+    vars?: any;
+    db?: any;
+    createVars?: ((...args: unknown[]) => unknown) | undefined;
+}>, {
+    options: {
+        createVarsTimeout: number;
+        createConnStateTimeout: number;
+        onConnectTimeout: number;
+        onSleepTimeout: number;
+        onDestroyTimeout: number;
+        stateSaveInterval: number;
+        actionTimeout: number;
+        waitUntilTimeout: number;
+        connectionLivenessTimeout: number;
+        connectionLivenessInterval: number;
+        noSleep: boolean;
+        sleepTimeout: number;
+        canHibernateWebSocket: boolean | ((args_0: Request, ...args: unknown[]) => boolean);
+    };
+    actions: Record<string, (...args: unknown[]) => unknown>;
+    state?: any;
+    onCreate?: ((...args: unknown[]) => unknown) | undefined;
+    onDestroy?: ((...args: unknown[]) => unknown) | undefined;
+    onWake?: ((...args: unknown[]) => unknown) | undefined;
+    onSleep?: ((...args: unknown[]) => unknown) | undefined;
+    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
+    onRequest?: ((...args: unknown[]) => unknown) | undefined;
+    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
+    createState?: ((...args: unknown[]) => unknown) | undefined;
+    connState?: any;
+    createConnState?: ((...args: unknown[]) => unknown) | undefined;
+    vars?: any;
+    db?: any;
+    createVars?: ((...args: unknown[]) => unknown) | undefined;
+}, {
+    options?: {
+        createVarsTimeout?: number | undefined;
+        createConnStateTimeout?: number | undefined;
+        onConnectTimeout?: number | undefined;
+        onSleepTimeout?: number | undefined;
+        onDestroyTimeout?: number | undefined;
+        stateSaveInterval?: number | undefined;
+        actionTimeout?: number | undefined;
+        waitUntilTimeout?: number | undefined;
+        connectionLivenessTimeout?: number | undefined;
+        connectionLivenessInterval?: number | undefined;
+        noSleep?: boolean | undefined;
+        sleepTimeout?: number | undefined;
+        canHibernateWebSocket?: boolean | ((args_0: Request, ...args: unknown[]) => boolean) | undefined;
+    } | undefined;
+    state?: any;
+    onCreate?: ((...args: unknown[]) => unknown) | undefined;
+    onDestroy?: ((...args: unknown[]) => unknown) | undefined;
+    onWake?: ((...args: unknown[]) => unknown) | undefined;
+    onSleep?: ((...args: unknown[]) => unknown) | undefined;
+    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
+    onRequest?: ((...args: unknown[]) => unknown) | undefined;
+    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
+    actions?: Record<string, (...args: unknown[]) => unknown> | undefined;
+    createState?: ((...args: unknown[]) => unknown) | undefined;
+    connState?: any;
+    createConnState?: ((...args: unknown[]) => unknown) | undefined;
+    vars?: any;
+    db?: any;
+    createVars?: ((...args: unknown[]) => unknown) | undefined;
+}>;
+type CreateState<TState, TConnParams, TConnState, TVars, TInput, TDatabase> = {
+    state: TState;
+} | {
+    createState: (c: InitContext, input: TInput) => TState | Promise<TState>;
+} | Record<never, never>;
+type CreateConnState<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider> = {
+    connState: TConnState;
+} | {
+    createConnState: (c: CreateConnStateContext<TState, TVars, TInput, TDatabase>, params: TConnParams) => TConnState | Promise<TConnState>;
+} | Record<never, never>;
 /**
- * Options for the `_saveState` method.
+ * @experimental
  */
-interface SaveStateOptions {
-    /**
-     * Forces the state to be saved immediately. This function will return when the state has saved successfully.
-     */
-    immediate?: boolean;
-    /** Bypass ready check for stopping. */
-    allowStoppingState?: boolean;
-}
-/** Actor type alias with all `any` types. Used for `extends` in classes referencing this actor. */
-type AnyActorInstance = ActorInstance<any, any, any, any, any, any>;
-declare class ActorInstance<S, CP, CS, V, I, DB extends AnyDatabaseProvider> {
-    #private;
-    actorContext: ActorContext<S, CP, CS, V, I, DB>;
-    get isStopping(): boolean;
-    get [PERSIST_SYMBOL](): PersistedActor<S, CP, CS, I>;
-    get id(): string;
-    get inlineClient(): Client<Registry<any>>;
-    get inspector(): ActorInspector;
+type CreateVars<TState, TConnParams, TConnState, TVars, TInput, TDatabase> = {
     /**
-     * This constructor should never be used directly.
-     *
-     * Constructed in {@link ActorInstance.start}.
-     *
-     * @private
+     * @experimental
      */
-    constructor(config: ActorConfig<S, CP, CS, V, I, DB>);
-    start(actorDriver: ActorDriver, inlineClient: Client<Registry<any>>, actorId: string, name: string, key: ActorKey, region: string): Promise<void>;
+    vars: TVars;
+} | {
     /**
-     * Triggers any pending alarms.
-     *
-     * This method is idempotent. It's called automatically when the actor wakes
-     * in order to trigger any pending alarms.
+     * @experimental
      */
-    _onAlarm(): Promise<void>;
-    scheduleEvent(timestamp: number, action: string, args: unknown[]): Promise<void>;
-    get stateEnabled(): boolean;
-    get connStateEnabled(): boolean;
-    __getConnForId(id: string): Conn<S, CP, CS, V, I, DB> | undefined;
+    createVars: (c: InitContext, driverCtx: any) => TVars | Promise<TVars>;
+} | Record<never, never>;
+interface Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider> {
+    [Action: string]: (c: ActionContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, ...args: any[]) => any;
+}
+/**
+ * @experimental
+ */
+type AuthIntent = "get" | "create" | "connect" | "action" | "message";
+interface BaseActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TActions extends Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase>> {
     /**
-     * Call when conn is disconnected. Used by transports.
-     *
-     * If a clean diconnect, will be removed immediately.
+     * Called when the actor is first initialized.
      *
-     * If not a clean disconnect, will keep the connection alive for a given interval to wait for reconnect.
-     */
-    __connDisconnected(conn: Conn<S, CP, CS, V, I, DB>, wasClean: boolean, requestId: string): void;
-    /**
-     * Called to create a new connection or reconnect an existing one.
-     */
-    createConn(socket: ConnSocket, params: any, request?: Request, connectionId?: string, connectionToken?: string): Promise<Conn<S, CP, CS, V, I, DB>>;
-    processMessage(message: ToServer, conn: Conn<S, CP, CS, V, I, DB>): Promise<void>;
-    /**
-     * Check if the actor is ready to handle requests.
-     */
-    isReady(): boolean;
-    /**
-     * Returns a list of action methods available on this actor.
-     */
-    get actions(): string[];
-    /**
-     * Handles raw HTTP requests to the actor.
-     */
-    handleFetch(request: Request, opts: Record<never, never>): Promise<Response>;
-    /**
-     * Handles raw WebSocket connections to the actor.
-     */
-    handleWebSocket(websocket: UniversalWebSocket, opts: {
-        request: Request;
-    }): Promise<void>;
-    get log(): Logger;
-    get rLog(): Logger;
-    /**
-     * Gets the name.
-     */
-    get name(): string;
-    /**
-     * Gets the key.
-     */
-    get key(): ActorKey;
-    /**
-     * Gets the region.
-     */
-    get region(): string;
-    /**
-     * Gets the scheduler.
+     * Use this hook to initialize your actor's state.
+     * This is called before any other lifecycle hooks.
      */
-    get schedule(): Schedule;
+    onCreate?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, input: TInput) => void | Promise<void>;
     /**
-     * Gets the map of connections.
+     * Called when the actor is destroyed.
      */
-    get conns(): Map<ConnId, Conn<S, CP, CS, V, I, DB>>;
+    onDestroy?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>) => void | Promise<void>;
     /**
-     * Gets the current state.
+     * Called when the actor is started and ready to receive connections and action.
      *
-     * Changing properties of this value will automatically be persisted.
-     */
-    get state(): S;
-    /**
-     * Gets the database.
-     * @experimental
-     * @throws {DatabaseNotEnabled} If the database is not enabled.
-     */
-    get db(): InferDatabaseClient<DB>;
-    /**
-     * Sets the current state.
+     * Use this hook to initialize resources needed for the actor's operation
+     * (timers, external connections, etc.)
      *
-     * This property will automatically be persisted.
-     */
-    set state(value: S);
-    get vars(): V;
-    /**
-     * Broadcasts an event to all connected clients.
-     * @param name - The name of the event.
-     * @param args - The arguments to send with the event.
+     * @returns Void or a Promise that resolves when startup is complete
      */
-    _broadcast<Args extends Array<unknown>>(name: string, ...args: Args): void;
+    onWake?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>) => void | Promise<void>;
     /**
-     * Prevents the actor from sleeping until promise is complete.
+     * Called when the actor is stopping or sleeping.
+     *
+     * Use this hook to clean up resources, save state, or perform
+     * any shutdown operations before the actor sleeps or stops.
      *
-     * This allows the actor runtime to ensure that a promise completes while
-     * returning from an action request early.
+     * Not supported on all platforms.
      *
-     * @param promise - The promise to run in the background.
+     * @returns Void or a Promise that resolves when shutdown is complete
      */
-    _waitUntil(promise: Promise<void>): void;
+    onSleep?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>) => void | Promise<void>;
     /**
-     * Forces the state to get saved.
+     * Called when the actor's state changes.
      *
-     * This is helpful if running a long task that may fail later or when
-     * running a background job that updates the state.
+     * Use this hook to react to state changes, such as updating
+     * external systems or triggering events.
      *
-     * @param opts - Options for saving the state.
-     */
-    saveState(opts: SaveStateOptions): Promise<void>;
-    /**
-     * Called by router middleware when an HTTP request begins.
-     */
-    __beginHonoHttpRequest(): void;
-    /**
-     * Called by router middleware when an HTTP request ends.
-     */
-    __endHonoHttpRequest(): void;
-    /**
-     * Puts an actor to sleep. This should just start the sleep sequence, most shutdown logic should be in _stop (which is called by the ActorDriver when sleeping).
+     * State changes made within this hook will NOT trigger
+     * another onStateChange call, preventing infinite recursion.
      *
-     * For the engine, this will:
-     * 1. Publish EventActorIntent with ActorIntentSleep (via driver.startSleep)
-     * 2. Engine runner will wait for CommandStopActor
-     * 3. Engine runner will call _onStop and wait for it to finish
-     * 4. Engine runner will publish EventActorStateUpdate with ActorStateSTop
-     **/
-    _startSleep(): void;
-    /**
-     * For the engine:
-     * 1. Engine runner receives CommandStopActor
-     * 2. Engine runner calls _onStop and waits for it to finish
-     * 3. Engine runner publishes EventActorStateUpdate with ActorStateSTop
+     * @param newState The updated state
      */
-    _onStop(): Promise<void>;
-    /** Abort signal that fires when the actor is stopping. */
-    get abortSignal(): AbortSignal;
-}
-
-declare enum ConnDriverKind {
-    WEBSOCKET = 0,
-    SSE = 1,
-    HTTP = 2
-}
-interface ConnDriverWebSocketState {
-    encoding: Encoding;
-    websocket: WSContext;
-    closePromise: ReturnType<typeof promiseWithResolvers<void>>;
-}
-interface ConnDriverSseState {
-    encoding: Encoding;
-    stream: SSEStreamingApi;
-}
-type ConnDriverHttpState = Record<never, never>;
-type ConnDriverState = {
-    [ConnDriverKind.WEBSOCKET]: ConnDriverWebSocketState;
-} | {
-    [ConnDriverKind.SSE]: ConnDriverSseState;
-} | {
-    [ConnDriverKind.HTTP]: ConnDriverHttpState;
-};
-
-declare function generateConnId(): string;
-declare function generateConnToken(): string;
-type ConnId = string;
-type ConnectionStatus = "connected" | "reconnecting";
-/**
- * Represents a client connection to a actor.
- *
- * Manages connection-specific data and controls the connection lifecycle.
- *
- * @see {@link https://rivet.dev/docs/connections|Connection Documentation}
- */
-declare class Conn<S, CP, CS, V, I, DB extends AnyDatabaseProvider> {
-    #private;
-    subscriptions: Set<string>;
+    onStateChange?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, newState: TState) => void;
     /**
-     * The proxied state that notifies of changes automatically.
+     * Called before a client connects to the actor.
      *
-     * Any data that should be stored indefinitely should be held within this object.
-     */
-    __persist: PersistedConn<CP, CS>;
-    get __driverState(): ConnDriverState | undefined;
-    /**
-     * Socket connected to this connection.
+     * Use this hook to determine if a connection should be accepted
+     * and to initialize connection-specific state.
      *
-     * If undefined, then nothing is connected to this.
+     * @param opts Connection parameters including client-provided data
+     * @returns The initial connection state or a Promise that resolves to it
+     * @throws Throw an error to reject the connection
      */
-    __socket?: ConnSocket;
-    get __status(): ConnectionStatus;
-    get params(): CP;
-    get __stateEnabled(): boolean;
+    onBeforeConnect?: (c: OnBeforeConnectContext<TState, TVars, TInput, TDatabase>, params: TConnParams) => void | Promise<void>;
     /**
-     * Gets the current state of the connection.
+     * Called when a client successfully connects to the actor.
      *
-     * Throws an error if the state is not enabled.
-     */
-    get state(): CS;
-    /**
-     * Sets the state of the connection.
+     * Use this hook to perform actions when a connection is established,
+     * such as sending initial data or updating the actor's state.
      *
-     * Throws an error if the state is not enabled.
-     */
-    set state(value: CS);
-    /**
-     * Unique identifier for the connection.
-     */
-    get id(): ConnId;
-    /**
-     * Token used to authenticate this request.
-     */
-    get _token(): string;
-    /**
-     * Status of the connection.
+     * @param conn The connection object
+     * @returns Void or a Promise that resolves when connection handling is complete
      */
-    get status(): ConnectionStatus;
+    onConnect?: (c: OnConnectContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, conn: Conn<TState, TConnParams, TConnState, TVars, TInput, TDatabase>) => void | Promise<void>;
     /**
-     * @experimental
+     * Called when a client disconnects from the actor.
      *
-     * If the underlying connection can hibernate.
-     */
-    get isHibernatable(): boolean;
-    /**
-     * Timestamp of the last time the connection was seen, i.e. the last time the connection was active and checked for liveness.
+     * Use this hook to clean up resources associated with the connection
+     * or update the actor's state.
+     *
+     * @param conn The connection that is being closed
+     * @returns Void or a Promise that resolves when disconnect handling is complete
      */
-    get lastSeen(): number;
+    onDisconnect?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, conn: Conn<TState, TConnParams, TConnState, TVars, TInput, TDatabase>) => void | Promise<void>;
     /**
-     * Initializes a new instance of the Connection class.
+     * Called before sending an action response to the client.
      *
-     * This should only be constructed by {@link Actor}.
+     * Use this hook to modify or transform the output of an action before it's sent
+     * to the client. This is useful for formatting responses, adding metadata,
+     * or applying transformations to the output.
      *
-     * @protected
+     * @param name The name of the action that was called
+     * @param args The arguments that were passed to the action
+     * @param output The output that will be sent to the client
+     * @returns The modified output to send to the client
      */
-    constructor(actor: ActorInstance<S, CP, CS, V, I, DB>, persist: PersistedConn<CP, CS>);
+    onBeforeActionResponse?: <Out>(c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, name: string, args: unknown[], output: Out) => Out | Promise<Out>;
     /**
-     * Sends a WebSocket message to the client.
+     * Called when a raw HTTP request is made to the actor.
      *
-     * @param message - The message to send.
+     * This handler receives raw HTTP requests made to `/actors/{actorName}/http/*` endpoints.
+     * Use this hook to handle custom HTTP patterns, REST APIs, or other HTTP-based protocols.
      *
-     * @protected
+     * @param c The request context with access to the connection
+     * @param request The raw HTTP request object
+     * @param opts Additional options
+     * @returns A Response object to send back, or void to continue with default routing
      */
-    _sendMessage(message: CachedSerializer<ToClient>): void;
+    onRequest?: (c: RequestContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, request: Request) => Response | Promise<Response>;
     /**
-     * Sends an event with arguments to the client.
+     * Called when a raw WebSocket connection is established to the actor.
      *
-     * @param eventName - The name of the event.
-     * @param args - The arguments for the event.
-     * @see {@link https://rivet.dev/docs/events|Events Documentation}
-     */
-    send(eventName: string, ...args: unknown[]): void;
-    /**
-     * Disconnects the client with an optional reason.
+     * This handler receives WebSocket connections made to `/actors/{actorName}/websocket/*` endpoints.
+     * Use this hook to handle custom WebSocket protocols, binary streams, or other WebSocket-based communication.
      *
-     * @param reason - The reason for disconnection.
+     * @param c The WebSocket context with access to the connection
+     * @param websocket The raw WebSocket connection
+     * @param opts Additional options including the original HTTP upgrade request
      */
-    disconnect(reason?: string): Promise<void>;
+    onWebSocket?: (c: WebSocketContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, websocket: UniversalWebSocket) => void | Promise<void>;
+    actions: TActions;
 }
+type ActorDatabaseConfig<TDatabase extends AnyDatabaseProvider> = {
+    /**
+     * @experimental
+     */
+    db: TDatabase;
+} | Record<never, never>;
+type ActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider> = Omit<z.infer<typeof ActorConfigSchema>, "actions" | "onCreate" | "onDestroy" | "onWake" | "onStateChange" | "onBeforeConnect" | "onConnect" | "onDisconnect" | "onBeforeActionResponse" | "onRequest" | "onWebSocket" | "state" | "createState" | "connState" | "createConnState" | "vars" | "createVars" | "db"> & BaseActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase, Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase>> & CreateState<TState, TConnParams, TConnState, TVars, TInput, TDatabase> & CreateConnState<TState, TConnParams, TConnState, TVars, TInput, TDatabase> & CreateVars<TState, TConnParams, TConnState, TVars, TInput, TDatabase> & ActorDatabaseConfig<TDatabase>;
+type ActorConfigInput<TState = undefined, TConnParams = undefined, TConnState = undefined, TVars = undefined, TInput = undefined, TDatabase extends AnyDatabaseProvider = undefined, TActions extends Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase> = Record<never, never>> = {
+    types?: ActorTypes<TState, TConnParams, TConnState, TVars, TInput, TDatabase>;
+} & Omit<z.input<typeof ActorConfigSchema>, "actions" | "onCreate" | "onDestroy" | "onWake" | "onSleep" | "onStateChange" | "onBeforeConnect" | "onConnect" | "onDisconnect" | "onBeforeActionResponse" | "onRequest" | "onWebSocket" | "state" | "createState" | "connState" | "createConnState" | "vars" | "createVars" | "db"> & BaseActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TActions> & CreateState<TState, TConnParams, TConnState, TVars, TInput, TDatabase> & CreateConnState<TState, TConnParams, TConnState, TVars, TInput, TDatabase> & CreateVars<TState, TConnParams, TConnState, TVars, TInput, TDatabase> & ActorDatabaseConfig<TDatabase>;
+declare function test<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TActions extends Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase>>(input: ActorConfigInput<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TActions>): ActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase>;
 
-export { ActorConnRaw as $, type ActorDriver as A, test as B, type Client as C, type DriverConfig as D, type Encoding as E, type RegistryConfig as F, type RegistryActors as G, type RunnerConfigInput as H, type InitContext as I, RegistryConfigSchema as J, Registry as K, setup as L, type ClientConfigInput as M, ActorClientError as N, type OnConnectOptions as O, ActorError as P, InternalError as Q, type RivetEvent as R, type ServerlessActorDriverBuilder as S, type Transport as T, type UniversalWebSocket as U, MalformedResponseMessage as V, ManagerError as W, type CreateRequest as X, type ActorActionFunction as Y, type ActorConn as Z, type EventUnsubscribe as _, type RivetCloseEvent as a, type ActorHandle as a0, ActorHandleRaw as a1, type ActorAccessor as a2, ClientRaw as a3, type CreateOptions as a4, type ExtractActorsFromRegistry as a5, type ExtractRegistryFromClient as a6, type GetOptions as a7, type GetWithIdOptions as a8, type QueryOptions as a9, DatabaseQuerySchema as aA, type DatabaseQuery as aB, TableSchema as aC, type Table as aD, TablesSchema as aE, type Tables as aF, ColumnSchema as aG, type Column as aH, ColumnsSchema as aI, type Columns as aJ, ForeignKeySchema as aK, type ForeignKey as aL, ForeignKeysSchema as aM, type ForeignKeys as aN, BuildSchema as aO, type Build as aP, BuildsSchema as aQ, type Builds as aR, CreateActorSchema as aS, type CreateActor as aT, type Region as aa, ActorInstance as ab, type ActorOutput as ac, type CreateInput as ad, type GetForIdInput as ae, type GetOrCreateWithKeyInput as af, type GetWithKeyInput as ag, type ManagerDisplayInformation as ah, type ManagerDriver as ai, DriverConfigSchema as aj, RunnerConfigSchema as ak, ActorFeature as al, ActorId as am, ActorLogEntry as an, ActorSchema as ao, type Actor as ap, OperationSchema as aq, type Operation as ar, PatchSchema as as, type Patch as at, ConnectionSchema as au, type Connection as av, RealtimeEventSchema as aw, type RealtimeEvent as ax, RecordedRealtimeEventSchema as ay, type RecordedRealtimeEvent as az, type RivetMessageEvent as b, type RunnerConfig as c, type AnyDatabaseProvider as d, type Actions as e, type ActorConfigInput as f, ActorDefinition as g, generateConnId as h, generateConnToken as i, type AnyClient as j, createClientWithDriver as k, type ActorQuery as l, type ActorKey as m, ActionContext as n, Conn as o, type ConnectionStatus as p, ActorContext as q, type ActionContextOf as r, type ActorContextOf as s, type AnyActorDefinition as t, lookupInRegistry as u, type AnyActorInstance as v, type ActorTypes as w, ActorConfigSchema as x, type AuthIntent as y, type ActorConfig as z };
+export { type ActorConn as $, type ActorDriver as A, type AuthIntent as B, type Client as C, type DriverConfig as D, type Encoding as E, type ActorConfig as F, test as G, type RegistryConfig as H, type InitContext as I, type RegistryActors as J, type RunnerConfigInput as K, RegistryConfigSchema as L, Registry as M, setup as N, OnBeforeConnectContext as O, type ClientConfigInput as P, ActorClientError as Q, type RunnerConfig as R, type ServerlessActorDriverBuilder as S, ActorError as T, type UniversalWebSocket as U, InternalError as V, WebSocketContext as W, MalformedResponseMessage as X, ManagerError as Y, type CreateRequest as Z, type ActorActionFunction as _, type AnyConn as a, type EventUnsubscribe as a0, ActorConnRaw as a1, type ActorHandle as a2, ActorHandleRaw as a3, type ActorAccessor as a4, ClientRaw as a5, type CreateOptions as a6, type ExtractActorsFromRegistry as a7, type ExtractRegistryFromClient as a8, type GetOptions as a9, type RealtimeEvent as aA, RecordedRealtimeEventSchema as aB, type RecordedRealtimeEvent as aC, DatabaseQuerySchema as aD, type DatabaseQuery as aE, TableSchema as aF, type Table as aG, TablesSchema as aH, type Tables as aI, ColumnSchema as aJ, type Column as aK, ColumnsSchema as aL, type Columns as aM, ForeignKeySchema as aN, type ForeignKey as aO, ForeignKeysSchema as aP, type ForeignKeys as aQ, BuildSchema as aR, type Build as aS, BuildsSchema as aT, type Builds as aU, CreateActorSchema as aV, type CreateActor as aW, type GetWithIdOptions as aa, type QueryOptions as ab, type Region as ac, ActorInstance as ad, type ActorOutput as ae, type CreateInput as af, type GetForIdInput as ag, type GetOrCreateWithKeyInput as ah, type GetWithKeyInput as ai, type ListActorsInput as aj, type ManagerDisplayInformation as ak, type ManagerDriver as al, DriverConfigSchema as am, RunnerConfigSchema as an, ActorFeature as ao, ActorId as ap, ActorLogEntry as aq, ActorSchema as ar, type Actor as as, OperationSchema as at, type Operation as au, PatchSchema as av, type Patch as aw, ConnectionSchema as ax, type Connection as ay, RealtimeEventSchema as az, type AnyActorInstance as b, type AnyDatabaseProvider as c, type Actions as d, type ActorConfigInput as e, ActorDefinition as f, type RivetEvent as g, type RivetCloseEvent as h, type RivetMessageEvent as i, type AnyClient as j, createClientWithDriver as k, type ActorQuery as l, type ActorKey as m, Conn as n, ActionContext as o, ActorContext as p, ConnInitContext as q, CreateConnStateContext as r, OnConnectContext as s, RequestContext as t, type ActionContextOf as u, type ActorContextOf as v, type AnyActorDefinition as w, lookupInRegistry as x, type ActorTypes as y, ActorConfigSchema as z };