rivetkit 2.0.38 → 2.0.39

package/dist/tsup/client/mod.cjs

@@ -9,13 +9,13 @@
 
 
 
-var _chunkLULP6HM2cjs = require('../chunk-LULP6HM2.cjs');
-require('../chunk-GFKZZG2A.cjs');
+var _chunkUAX5E3EUcjs = require('../chunk-UAX5E3EU.cjs');
+require('../chunk-C64FV764.cjs');
 
 
-var _chunkIWXMFQDTcjs = require('../chunk-IWXMFQDT.cjs');
+var _chunkKMYFL3OLcjs = require('../chunk-KMYFL3OL.cjs');
 require('../chunk-KDFWJKMJ.cjs');
-require('../chunk-O433HWWG.cjs');
+require('../chunk-X72X7I7T.cjs');
 require('../chunk-SNAUKDDK.cjs');
 require('../chunk-GBENOENJ.cjs');
 
@@ -30,5 +30,5 @@ require('../chunk-GBENOENJ.cjs');
 
 
 
-exports.ActorClientError = _chunkLULP6HM2cjs.ActorClientError; exports.ActorConnDisposed = _chunkLULP6HM2cjs.ActorConnDisposed; exports.ActorConnRaw = _chunkLULP6HM2cjs.ActorConnRaw; exports.ActorDefinition = _chunkLULP6HM2cjs.ActorDefinition; exports.ActorError = _chunkLULP6HM2cjs.ActorError; exports.ActorHandleRaw = _chunkLULP6HM2cjs.ActorHandleRaw; exports.InternalError = _chunkLULP6HM2cjs.InternalError; exports.KV_KEYS = _chunkIWXMFQDTcjs.KEYS; exports.MalformedResponseMessage = _chunkLULP6HM2cjs.MalformedResponseMessage; exports.ManagerError = _chunkLULP6HM2cjs.ManagerError; exports.createClient = _chunkLULP6HM2cjs.createClient;
+exports.ActorClientError = _chunkUAX5E3EUcjs.ActorClientError; exports.ActorConnDisposed = _chunkUAX5E3EUcjs.ActorConnDisposed; exports.ActorConnRaw = _chunkUAX5E3EUcjs.ActorConnRaw; exports.ActorDefinition = _chunkUAX5E3EUcjs.ActorDefinition; exports.ActorError = _chunkUAX5E3EUcjs.ActorError; exports.ActorHandleRaw = _chunkUAX5E3EUcjs.ActorHandleRaw; exports.InternalError = _chunkUAX5E3EUcjs.InternalError; exports.KV_KEYS = _chunkKMYFL3OLcjs.KEYS; exports.MalformedResponseMessage = _chunkUAX5E3EUcjs.MalformedResponseMessage; exports.ManagerError = _chunkUAX5E3EUcjs.ManagerError; exports.createClient = _chunkUAX5E3EUcjs.createClient;
 //# sourceMappingURL=mod.cjs.map

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

@@ -1,6 +1,6 @@
-import { a9 as Registry, C as Client } from '../config-CwJCQyP1.cjs';
-export { aB as ActorAccessor, as as ActorActionFunction, al as ActorClientError, at as ActorConn, am as ActorConnDisposed, ay as ActorConnRaw, au as ActorConnStatus, f as ActorDefinition, an as ActorError, az as ActorHandle, aA as ActorHandleRaw, l as AnyActorDefinition, aC as ClientRaw, av as ConnectionStateCallback, aD as CreateOptions, ar as CreateRequest, E as Encoding, aw as EventUnsubscribe, aE as ExtractActorsFromRegistry, aF as ExtractRegistryFromClient, aG as GetOptions, aH as GetWithIdOptions, ao as InternalError, ap as MalformedResponseMessage, aq as ManagerError, aI as QueryOptions, aJ as Region, ax as StatusChangeCallback } from '../config-CwJCQyP1.cjs';
-export { K as KV_KEYS } from '../kv-CTM8sCvx.cjs';
+import { aa as Registry, C as Client } from '../config-BuBlMs6C.cjs';
+export { aC as ActorAccessor, at as ActorActionFunction, am as ActorClientError, au as ActorConn, an as ActorConnDisposed, az as ActorConnRaw, av as ActorConnStatus, f as ActorDefinition, ao as ActorError, aA as ActorHandle, aB as ActorHandleRaw, l as AnyActorDefinition, aD as ClientRaw, aw as ConnectionStateCallback, aE as CreateOptions, as as CreateRequest, E as Encoding, ax as EventUnsubscribe, aF as ExtractActorsFromRegistry, aG as ExtractRegistryFromClient, aH as GetOptions, aI as GetWithIdOptions, ap as InternalError, aq as MalformedResponseMessage, ar as ManagerError, aJ as QueryOptions, aK as Region, ay as StatusChangeCallback } from '../config-BuBlMs6C.cjs';
+export { K as KV_KEYS } from '../keys-Chhy4ylv.cjs';
 import z from 'zod';
 import { GetUpgradeWebSocket } from '../utils.cjs';
 import '@rivetkit/virtual-websocket';

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

@@ -1,6 +1,6 @@
-import { a9 as Registry, C as Client } from '../config-CbIHPGKl.js';
-export { aB as ActorAccessor, as as ActorActionFunction, al as ActorClientError, at as ActorConn, am as ActorConnDisposed, ay as ActorConnRaw, au as ActorConnStatus, f as ActorDefinition, an as ActorError, az as ActorHandle, aA as ActorHandleRaw, l as AnyActorDefinition, aC as ClientRaw, av as ConnectionStateCallback, aD as CreateOptions, ar as CreateRequest, E as Encoding, aw as EventUnsubscribe, aE as ExtractActorsFromRegistry, aF as ExtractRegistryFromClient, aG as GetOptions, aH as GetWithIdOptions, ao as InternalError, ap as MalformedResponseMessage, aq as ManagerError, aI as QueryOptions, aJ as Region, ax as StatusChangeCallback } from '../config-CbIHPGKl.js';
-export { K as KV_KEYS } from '../kv-CTM8sCvx.js';
+import { aa as Registry, C as Client } from '../config-CBwo4ooA.js';
+export { aC as ActorAccessor, at as ActorActionFunction, am as ActorClientError, au as ActorConn, an as ActorConnDisposed, az as ActorConnRaw, av as ActorConnStatus, f as ActorDefinition, ao as ActorError, aA as ActorHandle, aB as ActorHandleRaw, l as AnyActorDefinition, aD as ClientRaw, aw as ConnectionStateCallback, aE as CreateOptions, as as CreateRequest, E as Encoding, ax as EventUnsubscribe, aF as ExtractActorsFromRegistry, aG as ExtractRegistryFromClient, aH as GetOptions, aI as GetWithIdOptions, ap as InternalError, aq as MalformedResponseMessage, ar as ManagerError, aJ as QueryOptions, aK as Region, ay as StatusChangeCallback } from '../config-CBwo4ooA.js';
+export { K as KV_KEYS } from '../keys-Chhy4ylv.js';
 import z from 'zod';
 import { GetUpgradeWebSocket } from '../utils.js';
 import '@rivetkit/virtual-websocket';

package/dist/tsup/client/mod.js

@@ -9,13 +9,13 @@ import {
   MalformedResponseMessage,
   ManagerError,
   createClient
-} from "../chunk-EEL32AJM.js";
-import "../chunk-WIZ4JGP6.js";
+} from "../chunk-XU74APB4.js";
+import "../chunk-PHCD25XO.js";
 import {
   KEYS
-} from "../chunk-MIOU6BF3.js";
+} from "../chunk-PVKUXMOA.js";
 import "../chunk-E6ZE2YEA.js";
-import "../chunk-4U45T5KW.js";
+import "../chunk-CDK6DRO2.js";
 import "../chunk-2YHR67M4.js";
 export {
   ActorClientError,

package/dist/tsup/common/log.cjs

@@ -6,7 +6,7 @@
 
 
 
-var _chunkO433HWWGcjs = require('../chunk-O433HWWG.cjs');
+var _chunkX72X7I7Tcjs = require('../chunk-X72X7I7T.cjs');
 require('../chunk-SNAUKDDK.cjs');
 require('../chunk-GBENOENJ.cjs');
 
@@ -17,5 +17,5 @@ require('../chunk-GBENOENJ.cjs');
 
 
 
-exports.LogLevelSchema = _chunkO433HWWGcjs.LogLevelSchema; exports.configureBaseLogger = _chunkO433HWWGcjs.configureBaseLogger; exports.configureDefaultLogger = _chunkO433HWWGcjs.configureDefaultLogger; exports.getBaseLogger = _chunkO433HWWGcjs.getBaseLogger; exports.getIncludeTarget = _chunkO433HWWGcjs.getIncludeTarget; exports.getLogger = _chunkO433HWWGcjs.getLogger; exports.getPinoLevel = _chunkO433HWWGcjs.getPinoLevel;
+exports.LogLevelSchema = _chunkX72X7I7Tcjs.LogLevelSchema; exports.configureBaseLogger = _chunkX72X7I7Tcjs.configureBaseLogger; exports.configureDefaultLogger = _chunkX72X7I7Tcjs.configureDefaultLogger; exports.getBaseLogger = _chunkX72X7I7Tcjs.getBaseLogger; exports.getIncludeTarget = _chunkX72X7I7Tcjs.getIncludeTarget; exports.getLogger = _chunkX72X7I7Tcjs.getLogger; exports.getPinoLevel = _chunkX72X7I7Tcjs.getPinoLevel;
 //# sourceMappingURL=log.cjs.map

package/dist/tsup/common/log.js

@@ -6,7 +6,7 @@ import {
   getIncludeTarget,
   getLogger,
   getPinoLevel
-} from "../chunk-4U45T5KW.js";
+} from "../chunk-CDK6DRO2.js";
 import "../chunk-2YHR67M4.js";
 export {
   LogLevelSchema,

package/dist/tsup/common/websocket.cjs

@@ -1,10 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkGFKZZG2Acjs = require('../chunk-GFKZZG2A.cjs');
-require('../chunk-O433HWWG.cjs');
+var _chunkC64FV764cjs = require('../chunk-C64FV764.cjs');
+require('../chunk-X72X7I7T.cjs');
 require('../chunk-SNAUKDDK.cjs');
 require('../chunk-GBENOENJ.cjs');
 
 
-exports.importWebSocket = _chunkGFKZZG2Acjs.importWebSocket;
+exports.importWebSocket = _chunkC64FV764cjs.importWebSocket;
 //# sourceMappingURL=websocket.cjs.map

package/dist/tsup/common/websocket.js

@@ -1,7 +1,7 @@
 import {
   importWebSocket
-} from "../chunk-WIZ4JGP6.js";
-import "../chunk-4U45T5KW.js";
+} from "../chunk-PHCD25XO.js";
+import "../chunk-CDK6DRO2.js";
 import "../chunk-2YHR67M4.js";
 export {
   importWebSocket

package/dist/tsup/{config-CwJCQyP1.d.cts → config-BuBlMs6C.d.cts}

@@ -39,6 +39,12 @@ interface ManagerDriver {
     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): Promise<Response>;
+    /**
+     * Build a public gateway URL for a specific actor.
+     *
+     * This lives on the driver because the base endpoint varies by runtime.
+     */
+    buildGatewayUrl(actorId: string): Promise<string>;
     displayInformation(): ManagerDisplayInformation;
     extraStartupLog?: () => Record<string, unknown>;
     modifyManagerRouter?: (config: RegistryConfig, router: Hono) => void;
@@ -962,13 +968,15 @@ declare class ActorHandleRaw {
      */
     websocket(path?: string, protocols?: string | string[]): Promise<WebSocket>;
     /**
-     * Resolves the actor to get its unique actor ID
-     *
-     * @returns {Promise<string>} - A promise that resolves to the actor's ID
+     * Resolves the actor to get its unique actor ID.
      */
     resolve({ signal }?: {
         signal?: AbortSignal;
     }): Promise<string>;
+    /**
+     * Returns the raw URL for routing traffic to the actor.
+     */
+    getGatewayUrl(): Promise<string>;
 }
 /**
  * Stateless handle to a actor. Allows calling actor's remote procedure calls with inferred types
@@ -1232,6 +1240,61 @@ declare class ActorInspector {
     executeAction(name: string, params: ArrayBuffer): Promise<ArrayBuffer>;
 }
 
+/**
+ * User-facing KV storage interface exposed on ActorContext.
+ */
+type KvValueType = "text" | "arrayBuffer" | "binary";
+type KvKeyType = "text" | "binary";
+type KvKey = Uint8Array | string;
+type KvValueTypeMap = {
+    text: string;
+    arrayBuffer: ArrayBuffer;
+    binary: Uint8Array;
+};
+type KvKeyTypeMap = {
+    text: string;
+    binary: Uint8Array;
+};
+type KvValueOptions<T extends KvValueType = "text"> = {
+    type?: T;
+};
+type KvListOptions<T extends KvValueType = "text", K extends KvKeyType = "text"> = KvValueOptions<T> & {
+    keyType?: K;
+};
+declare class ActorKv {
+    #private;
+    constructor(driver: ActorDriver, actorId: string);
+    /**
+     * Get a single value by key.
+     */
+    get<T extends KvValueType = "text">(key: KvKey, options?: KvValueOptions<T>): Promise<KvValueTypeMap[T] | null>;
+    /**
+     * Get multiple values by keys.
+     */
+    getBatch<T extends KvValueType = "text">(keys: KvKey[], options?: KvValueOptions<T>): Promise<(KvValueTypeMap[T] | null)[]>;
+    /**
+     * Put a single key-value pair.
+     */
+    put<T extends KvValueType = KvValueType>(key: KvKey, value: KvValueTypeMap[T], options?: KvValueOptions<T>): Promise<void>;
+    /**
+     * Put multiple key-value pairs.
+     */
+    putBatch<T extends KvValueType = KvValueType>(entries: [KvKey, KvValueTypeMap[T]][], options?: KvValueOptions<T>): Promise<void>;
+    /**
+     * Delete a single key.
+     */
+    delete(key: KvKey): Promise<void>;
+    /**
+     * Delete multiple keys.
+     */
+    deleteBatch(keys: KvKey[]): Promise<void>;
+    /**
+     * List all keys with a given prefix.
+     * Returns key-value pairs where keys have the user prefix removed.
+     */
+    list<T extends KvValueType = "text", K extends KvKeyType = "text">(prefix: KvKeyTypeMap[K], options?: KvListOptions<T, K>): Promise<[KvKeyTypeMap[K], KvValueTypeMap[T]][]>;
+}
+
 declare class Schedule {
     #private;
     constructor(actor: AnyActorInstance);
@@ -1245,6 +1308,10 @@ declare class Schedule {
 declare class ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider> {
     #private;
     constructor(actor: ActorInstance<TState, TConnParams, TConnState, TVars, TInput, TDatabase>);
+    /**
+     * Gets the KV storage interface.
+     */
+    get kv(): ActorKv;
     /**
      * Get the actor state
      *
@@ -2101,7 +2168,7 @@ interface BaseActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatab
      * @param opts Additional options including the original HTTP upgrade request
      */
     onWebSocket?: (c: WebSocketContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, websocket: UniversalWebSocket) => void | Promise<void>;
-    actions: TActions;
+    actions?: TActions;
 }
 type ActorDatabaseConfig<TDatabase extends AnyDatabaseProvider> = {
     /**
@@ -2166,4 +2233,4 @@ declare const DocActorConfigSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 
-export { type StateChangeContextOf as $, type ActorDriver as A, type ActionContextOf as B, type Client as C, DocActorOptionsSchema as D, type Encoding as E, BeforeActionResponseContext as F, type BeforeActionResponseContextOf as G, BeforeConnectContext as H, type BeforeConnectContextOf as I, ConnectContext as J, type ConnectContextOf as K, CreateContext as L, type CreateContextOf as M, CreateConnStateContext as N, type CreateConnStateContextOf as O, CreateVarsContext as P, type CreateVarsContextOf as Q, type RegistryConfig as R, DestroyContext as S, type DestroyContextOf as T, DisconnectContext as U, type DisconnectContextOf as V, RequestContext as W, type RequestContextOf as X, SleepContext as Y, type SleepContextOf as Z, StateChangeContext as _, type AnyConn as a, WakeContext as a0, type WakeContextOf as a1, WebSocketContext as a2, type WebSocketContextOf as a3, type RegistryActors as a4, RegistryConfigSchema as a5, type FetchHandler as a6, type ServerlessHandler as a7, type LegacyStartServerOutput as a8, Registry as a9, ActorHandleRaw as aA, type ActorAccessor as aB, ClientRaw as aC, type CreateOptions as aD, type ExtractActorsFromRegistry as aE, type ExtractRegistryFromClient as aF, type GetOptions as aG, type GetWithIdOptions as aH, type QueryOptions as aI, type Region as aJ, type ManagerDriver as aK, ActorInstance as aL, type ActorOutput as aM, type CreateInput as aN, type GetForIdInput as aO, type GetOrCreateWithKeyInput as aP, type GetWithKeyInput as aQ, type ListActorsInput as aR, type ManagerDisplayInformation as aS, type ManagerDriverBuilder as aT, type ActorDriverBuilder as aU, setup as aa, ActorsSchema as ab, TestConfigSchema as ac, type TestConfig as ad, type RegistryConfigInput as ae, buildActorNames as af, DocInspectorConfigSchema as ag, DocConfigureRunnerPoolSchema as ah, DocServerlessConfigSchema as ai, DocRunnerConfigSchema as aj, DocRegistryConfigSchema as ak, ActorClientError as al, ActorConnDisposed as am, ActorError as an, InternalError as ao, MalformedResponseMessage as ap, ManagerError as aq, type CreateRequest as ar, type ActorActionFunction as as, type ActorConn as at, type ActorConnStatus as au, type ConnectionStateCallback as av, type EventUnsubscribe as aw, type StatusChangeCallback as ax, ActorConnRaw as ay, type ActorHandle as az, type AnyActorInstance as b, type AnyDatabaseProvider as c, type Actions as d, type ActorConfigInput as e, ActorDefinition as f, type AnyClient as g, createClientWithDriver as h, type ActorQuery as i, type ActorKey as j, Conn as k, type AnyActorDefinition as l, lookupInRegistry as m, type ActorTypes as n, ActorConfigSchema as o, type AuthIntent as p, type ActorConfig as q, DocActorConfigSchema as r, ActorContext as s, test as t, type ActorContextOf as u, ConnContext as v, type ConnContextOf as w, ConnInitContext as x, type ConnInitContextOf as y, ActionContext as z };
+export { StateChangeContext as $, type ActorDriver as A, ActionContext as B, type Client as C, DocActorOptionsSchema as D, type Encoding as E, type ActionContextOf as F, BeforeActionResponseContext as G, type BeforeActionResponseContextOf as H, BeforeConnectContext as I, type BeforeConnectContextOf as J, ConnectContext as K, type ConnectContextOf as L, CreateContext as M, type CreateContextOf as N, CreateConnStateContext as O, type CreateConnStateContextOf as P, CreateVarsContext as Q, type RegistryConfig as R, type CreateVarsContextOf as S, DestroyContext as T, type DestroyContextOf as U, DisconnectContext as V, type DisconnectContextOf as W, RequestContext as X, type RequestContextOf as Y, SleepContext as Z, type SleepContextOf as _, type AnyConn as a, type StateChangeContextOf as a0, WakeContext as a1, type WakeContextOf as a2, WebSocketContext as a3, type WebSocketContextOf as a4, type RegistryActors as a5, RegistryConfigSchema as a6, type FetchHandler as a7, type ServerlessHandler as a8, type LegacyStartServerOutput as a9, type ActorHandle as aA, ActorHandleRaw as aB, type ActorAccessor as aC, ClientRaw as aD, type CreateOptions as aE, type ExtractActorsFromRegistry as aF, type ExtractRegistryFromClient as aG, type GetOptions as aH, type GetWithIdOptions as aI, type QueryOptions as aJ, type Region as aK, type ManagerDriver as aL, ActorInstance as aM, type ActorOutput as aN, type CreateInput as aO, type GetForIdInput as aP, type GetOrCreateWithKeyInput as aQ, type GetWithKeyInput as aR, type ListActorsInput as aS, type ManagerDisplayInformation as aT, type ManagerDriverBuilder as aU, type ActorDriverBuilder as aV, Registry as aa, setup as ab, ActorsSchema as ac, TestConfigSchema as ad, type TestConfig as ae, type RegistryConfigInput as af, buildActorNames as ag, DocInspectorConfigSchema as ah, DocConfigureRunnerPoolSchema as ai, DocServerlessConfigSchema as aj, DocRunnerConfigSchema as ak, DocRegistryConfigSchema as al, ActorClientError as am, ActorConnDisposed as an, ActorError as ao, InternalError as ap, MalformedResponseMessage as aq, ManagerError as ar, type CreateRequest as as, type ActorActionFunction as at, type ActorConn as au, type ActorConnStatus as av, type ConnectionStateCallback as aw, type EventUnsubscribe as ax, type StatusChangeCallback as ay, ActorConnRaw as az, type AnyActorInstance as b, type AnyDatabaseProvider as c, type Actions as d, type ActorConfigInput as e, ActorDefinition as f, type AnyClient as g, createClientWithDriver as h, type ActorQuery as i, type ActorKey as j, Conn as k, type AnyActorDefinition as l, lookupInRegistry as m, ActorKv as n, type ActorTypes as o, ActorConfigSchema as p, type AuthIntent as q, type ActorConfig as r, DocActorConfigSchema as s, test as t, ActorContext as u, type ActorContextOf as v, ConnContext as w, type ConnContextOf as x, ConnInitContext as y, type ConnInitContextOf as z };

package/dist/tsup/{config-CbIHPGKl.d.ts → config-CBwo4ooA.d.ts}

@@ -39,6 +39,12 @@ interface ManagerDriver {
     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): Promise<Response>;
+    /**
+     * Build a public gateway URL for a specific actor.
+     *
+     * This lives on the driver because the base endpoint varies by runtime.
+     */
+    buildGatewayUrl(actorId: string): Promise<string>;
     displayInformation(): ManagerDisplayInformation;
     extraStartupLog?: () => Record<string, unknown>;
     modifyManagerRouter?: (config: RegistryConfig, router: Hono) => void;
@@ -962,13 +968,15 @@ declare class ActorHandleRaw {
      */
     websocket(path?: string, protocols?: string | string[]): Promise<WebSocket>;
     /**
-     * Resolves the actor to get its unique actor ID
-     *
-     * @returns {Promise<string>} - A promise that resolves to the actor's ID
+     * Resolves the actor to get its unique actor ID.
      */
     resolve({ signal }?: {
         signal?: AbortSignal;
     }): Promise<string>;
+    /**
+     * Returns the raw URL for routing traffic to the actor.
+     */
+    getGatewayUrl(): Promise<string>;
 }
 /**
  * Stateless handle to a actor. Allows calling actor's remote procedure calls with inferred types
@@ -1232,6 +1240,61 @@ declare class ActorInspector {
     executeAction(name: string, params: ArrayBuffer): Promise<ArrayBuffer>;
 }
 
+/**
+ * User-facing KV storage interface exposed on ActorContext.
+ */
+type KvValueType = "text" | "arrayBuffer" | "binary";
+type KvKeyType = "text" | "binary";
+type KvKey = Uint8Array | string;
+type KvValueTypeMap = {
+    text: string;
+    arrayBuffer: ArrayBuffer;
+    binary: Uint8Array;
+};
+type KvKeyTypeMap = {
+    text: string;
+    binary: Uint8Array;
+};
+type KvValueOptions<T extends KvValueType = "text"> = {
+    type?: T;
+};
+type KvListOptions<T extends KvValueType = "text", K extends KvKeyType = "text"> = KvValueOptions<T> & {
+    keyType?: K;
+};
+declare class ActorKv {
+    #private;
+    constructor(driver: ActorDriver, actorId: string);
+    /**
+     * Get a single value by key.
+     */
+    get<T extends KvValueType = "text">(key: KvKey, options?: KvValueOptions<T>): Promise<KvValueTypeMap[T] | null>;
+    /**
+     * Get multiple values by keys.
+     */
+    getBatch<T extends KvValueType = "text">(keys: KvKey[], options?: KvValueOptions<T>): Promise<(KvValueTypeMap[T] | null)[]>;
+    /**
+     * Put a single key-value pair.
+     */
+    put<T extends KvValueType = KvValueType>(key: KvKey, value: KvValueTypeMap[T], options?: KvValueOptions<T>): Promise<void>;
+    /**
+     * Put multiple key-value pairs.
+     */
+    putBatch<T extends KvValueType = KvValueType>(entries: [KvKey, KvValueTypeMap[T]][], options?: KvValueOptions<T>): Promise<void>;
+    /**
+     * Delete a single key.
+     */
+    delete(key: KvKey): Promise<void>;
+    /**
+     * Delete multiple keys.
+     */
+    deleteBatch(keys: KvKey[]): Promise<void>;
+    /**
+     * List all keys with a given prefix.
+     * Returns key-value pairs where keys have the user prefix removed.
+     */
+    list<T extends KvValueType = "text", K extends KvKeyType = "text">(prefix: KvKeyTypeMap[K], options?: KvListOptions<T, K>): Promise<[KvKeyTypeMap[K], KvValueTypeMap[T]][]>;
+}
+
 declare class Schedule {
     #private;
     constructor(actor: AnyActorInstance);
@@ -1245,6 +1308,10 @@ declare class Schedule {
 declare class ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider> {
     #private;
     constructor(actor: ActorInstance<TState, TConnParams, TConnState, TVars, TInput, TDatabase>);
+    /**
+     * Gets the KV storage interface.
+     */
+    get kv(): ActorKv;
     /**
      * Get the actor state
      *
@@ -2101,7 +2168,7 @@ interface BaseActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatab
      * @param opts Additional options including the original HTTP upgrade request
      */
     onWebSocket?: (c: WebSocketContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, websocket: UniversalWebSocket) => void | Promise<void>;
-    actions: TActions;
+    actions?: TActions;
 }
 type ActorDatabaseConfig<TDatabase extends AnyDatabaseProvider> = {
     /**
@@ -2166,4 +2233,4 @@ declare const DocActorConfigSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 
-export { type StateChangeContextOf as $, type ActorDriver as A, type ActionContextOf as B, type Client as C, DocActorOptionsSchema as D, type Encoding as E, BeforeActionResponseContext as F, type BeforeActionResponseContextOf as G, BeforeConnectContext as H, type BeforeConnectContextOf as I, ConnectContext as J, type ConnectContextOf as K, CreateContext as L, type CreateContextOf as M, CreateConnStateContext as N, type CreateConnStateContextOf as O, CreateVarsContext as P, type CreateVarsContextOf as Q, type RegistryConfig as R, DestroyContext as S, type DestroyContextOf as T, DisconnectContext as U, type DisconnectContextOf as V, RequestContext as W, type RequestContextOf as X, SleepContext as Y, type SleepContextOf as Z, StateChangeContext as _, type AnyConn as a, WakeContext as a0, type WakeContextOf as a1, WebSocketContext as a2, type WebSocketContextOf as a3, type RegistryActors as a4, RegistryConfigSchema as a5, type FetchHandler as a6, type ServerlessHandler as a7, type LegacyStartServerOutput as a8, Registry as a9, ActorHandleRaw as aA, type ActorAccessor as aB, ClientRaw as aC, type CreateOptions as aD, type ExtractActorsFromRegistry as aE, type ExtractRegistryFromClient as aF, type GetOptions as aG, type GetWithIdOptions as aH, type QueryOptions as aI, type Region as aJ, type ManagerDriver as aK, ActorInstance as aL, type ActorOutput as aM, type CreateInput as aN, type GetForIdInput as aO, type GetOrCreateWithKeyInput as aP, type GetWithKeyInput as aQ, type ListActorsInput as aR, type ManagerDisplayInformation as aS, type ManagerDriverBuilder as aT, type ActorDriverBuilder as aU, setup as aa, ActorsSchema as ab, TestConfigSchema as ac, type TestConfig as ad, type RegistryConfigInput as ae, buildActorNames as af, DocInspectorConfigSchema as ag, DocConfigureRunnerPoolSchema as ah, DocServerlessConfigSchema as ai, DocRunnerConfigSchema as aj, DocRegistryConfigSchema as ak, ActorClientError as al, ActorConnDisposed as am, ActorError as an, InternalError as ao, MalformedResponseMessage as ap, ManagerError as aq, type CreateRequest as ar, type ActorActionFunction as as, type ActorConn as at, type ActorConnStatus as au, type ConnectionStateCallback as av, type EventUnsubscribe as aw, type StatusChangeCallback as ax, ActorConnRaw as ay, type ActorHandle as az, type AnyActorInstance as b, type AnyDatabaseProvider as c, type Actions as d, type ActorConfigInput as e, ActorDefinition as f, type AnyClient as g, createClientWithDriver as h, type ActorQuery as i, type ActorKey as j, Conn as k, type AnyActorDefinition as l, lookupInRegistry as m, type ActorTypes as n, ActorConfigSchema as o, type AuthIntent as p, type ActorConfig as q, DocActorConfigSchema as r, ActorContext as s, test as t, type ActorContextOf as u, ConnContext as v, type ConnContextOf as w, ConnInitContext as x, type ConnInitContextOf as y, ActionContext as z };
+export { StateChangeContext as $, type ActorDriver as A, ActionContext as B, type Client as C, DocActorOptionsSchema as D, type Encoding as E, type ActionContextOf as F, BeforeActionResponseContext as G, type BeforeActionResponseContextOf as H, BeforeConnectContext as I, type BeforeConnectContextOf as J, ConnectContext as K, type ConnectContextOf as L, CreateContext as M, type CreateContextOf as N, CreateConnStateContext as O, type CreateConnStateContextOf as P, CreateVarsContext as Q, type RegistryConfig as R, type CreateVarsContextOf as S, DestroyContext as T, type DestroyContextOf as U, DisconnectContext as V, type DisconnectContextOf as W, RequestContext as X, type RequestContextOf as Y, SleepContext as Z, type SleepContextOf as _, type AnyConn as a, type StateChangeContextOf as a0, WakeContext as a1, type WakeContextOf as a2, WebSocketContext as a3, type WebSocketContextOf as a4, type RegistryActors as a5, RegistryConfigSchema as a6, type FetchHandler as a7, type ServerlessHandler as a8, type LegacyStartServerOutput as a9, type ActorHandle as aA, ActorHandleRaw as aB, type ActorAccessor as aC, ClientRaw as aD, type CreateOptions as aE, type ExtractActorsFromRegistry as aF, type ExtractRegistryFromClient as aG, type GetOptions as aH, type GetWithIdOptions as aI, type QueryOptions as aJ, type Region as aK, type ManagerDriver as aL, ActorInstance as aM, type ActorOutput as aN, type CreateInput as aO, type GetForIdInput as aP, type GetOrCreateWithKeyInput as aQ, type GetWithKeyInput as aR, type ListActorsInput as aS, type ManagerDisplayInformation as aT, type ManagerDriverBuilder as aU, type ActorDriverBuilder as aV, Registry as aa, setup as ab, ActorsSchema as ac, TestConfigSchema as ad, type TestConfig as ae, type RegistryConfigInput as af, buildActorNames as ag, DocInspectorConfigSchema as ah, DocConfigureRunnerPoolSchema as ai, DocServerlessConfigSchema as aj, DocRunnerConfigSchema as ak, DocRegistryConfigSchema as al, ActorClientError as am, ActorConnDisposed as an, ActorError as ao, InternalError as ap, MalformedResponseMessage as aq, ManagerError as ar, type CreateRequest as as, type ActorActionFunction as at, type ActorConn as au, type ActorConnStatus as av, type ConnectionStateCallback as aw, type EventUnsubscribe as ax, type StatusChangeCallback as ay, ActorConnRaw as az, type AnyActorInstance as b, type AnyDatabaseProvider as c, type Actions as d, type ActorConfigInput as e, ActorDefinition as f, type AnyClient as g, createClientWithDriver as h, type ActorQuery as i, type ActorKey as j, Conn as k, type AnyActorDefinition as l, lookupInRegistry as m, ActorKv as n, type ActorTypes as o, ActorConfigSchema as p, type AuthIntent as q, type ActorConfig as r, DocActorConfigSchema as s, test as t, ActorContext as u, type ActorContextOf as v, ConnContext as w, type ConnContextOf as x, ConnInitContext as y, type ConnInitContextOf as z };

package/dist/tsup/{driver-Lw_oORox.d.cts → driver-CPXmh8f8.d.cts}

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { aT as ManagerDriverBuilder, aU as ActorDriverBuilder } from './config-CwJCQyP1.cjs';
+import { aU as ManagerDriverBuilder, aV as ActorDriverBuilder } from './config-BuBlMs6C.cjs';
 
 declare const DriverConfigSchema: z.ZodObject<{
     name: z.ZodString;

package/dist/tsup/{driver-CMN823Lc.d.ts → driver-DxWa6HUO.d.ts}

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { aT as ManagerDriverBuilder, aU as ActorDriverBuilder } from './config-CbIHPGKl.js';
+import { aU as ManagerDriverBuilder, aV as ActorDriverBuilder } from './config-CBwo4ooA.js';
 
 declare const DriverConfigSchema: z.ZodObject<{
     name: z.ZodString;

package/dist/tsup/driver-helpers/mod.cjs

@@ -17,9 +17,9 @@
 
 
 
-var _chunkIWXMFQDTcjs = require('../chunk-IWXMFQDT.cjs');
+var _chunkKMYFL3OLcjs = require('../chunk-KMYFL3OL.cjs');
 require('../chunk-KDFWJKMJ.cjs');
-require('../chunk-O433HWWG.cjs');
+require('../chunk-X72X7I7T.cjs');
 require('../chunk-SNAUKDDK.cjs');
 require('../chunk-GBENOENJ.cjs');
 
@@ -41,5 +41,5 @@ require('../chunk-GBENOENJ.cjs');
 
 
 
-exports.ALLOWED_PUBLIC_HEADERS = _chunkIWXMFQDTcjs.ALLOWED_PUBLIC_HEADERS; exports.HEADER_ACTOR_ID = _chunkIWXMFQDTcjs.HEADER_ACTOR_ID; exports.HEADER_ACTOR_QUERY = _chunkIWXMFQDTcjs.HEADER_ACTOR_QUERY; exports.HEADER_CONN_PARAMS = _chunkIWXMFQDTcjs.HEADER_CONN_PARAMS; exports.HEADER_ENCODING = _chunkIWXMFQDTcjs.HEADER_ENCODING; exports.HEADER_RIVET_ACTOR = _chunkIWXMFQDTcjs.HEADER_RIVET_ACTOR; exports.HEADER_RIVET_TARGET = _chunkIWXMFQDTcjs.HEADER_RIVET_TARGET; exports.PATH_CONNECT = _chunkIWXMFQDTcjs.PATH_CONNECT; exports.PATH_WEBSOCKET_BASE = _chunkIWXMFQDTcjs.PATH_WEBSOCKET_BASE; exports.PATH_WEBSOCKET_PREFIX = _chunkIWXMFQDTcjs.PATH_WEBSOCKET_PREFIX; exports.WS_PROTOCOL_ACTOR = _chunkIWXMFQDTcjs.WS_PROTOCOL_ACTOR; exports.WS_PROTOCOL_CONN_PARAMS = _chunkIWXMFQDTcjs.WS_PROTOCOL_CONN_PARAMS; exports.WS_PROTOCOL_ENCODING = _chunkIWXMFQDTcjs.WS_PROTOCOL_ENCODING; exports.WS_PROTOCOL_PATH = _chunkIWXMFQDTcjs.WS_TEST_PROTOCOL_PATH; exports.WS_PROTOCOL_STANDARD = _chunkIWXMFQDTcjs.WS_PROTOCOL_STANDARD; exports.WS_PROTOCOL_TARGET = _chunkIWXMFQDTcjs.WS_PROTOCOL_TARGET; exports.buildManagerRouter = _chunkIWXMFQDTcjs.buildManagerRouter; exports.getInitialActorKvState = _chunkIWXMFQDTcjs.getInitialActorKvState;
+exports.ALLOWED_PUBLIC_HEADERS = _chunkKMYFL3OLcjs.ALLOWED_PUBLIC_HEADERS; exports.HEADER_ACTOR_ID = _chunkKMYFL3OLcjs.HEADER_ACTOR_ID; exports.HEADER_ACTOR_QUERY = _chunkKMYFL3OLcjs.HEADER_ACTOR_QUERY; exports.HEADER_CONN_PARAMS = _chunkKMYFL3OLcjs.HEADER_CONN_PARAMS; exports.HEADER_ENCODING = _chunkKMYFL3OLcjs.HEADER_ENCODING; exports.HEADER_RIVET_ACTOR = _chunkKMYFL3OLcjs.HEADER_RIVET_ACTOR; exports.HEADER_RIVET_TARGET = _chunkKMYFL3OLcjs.HEADER_RIVET_TARGET; exports.PATH_CONNECT = _chunkKMYFL3OLcjs.PATH_CONNECT; exports.PATH_WEBSOCKET_BASE = _chunkKMYFL3OLcjs.PATH_WEBSOCKET_BASE; exports.PATH_WEBSOCKET_PREFIX = _chunkKMYFL3OLcjs.PATH_WEBSOCKET_PREFIX; exports.WS_PROTOCOL_ACTOR = _chunkKMYFL3OLcjs.WS_PROTOCOL_ACTOR; exports.WS_PROTOCOL_CONN_PARAMS = _chunkKMYFL3OLcjs.WS_PROTOCOL_CONN_PARAMS; exports.WS_PROTOCOL_ENCODING = _chunkKMYFL3OLcjs.WS_PROTOCOL_ENCODING; exports.WS_PROTOCOL_PATH = _chunkKMYFL3OLcjs.WS_TEST_PROTOCOL_PATH; exports.WS_PROTOCOL_STANDARD = _chunkKMYFL3OLcjs.WS_PROTOCOL_STANDARD; exports.WS_PROTOCOL_TARGET = _chunkKMYFL3OLcjs.WS_PROTOCOL_TARGET; exports.buildManagerRouter = _chunkKMYFL3OLcjs.buildManagerRouter; exports.getInitialActorKvState = _chunkKMYFL3OLcjs.getInitialActorKvState;
 //# sourceMappingURL=mod.cjs.map

package/dist/tsup/driver-helpers/mod.d.cts

@@ -1,5 +1,5 @@
-import { R as RegistryConfig, aK as ManagerDriver } from '../config-CwJCQyP1.cjs';
-export { A as ActorDriver, aL as ActorInstance, aM as ActorOutput, b as AnyActorInstance, aN as CreateInput, aO as GetForIdInput, aP as GetOrCreateWithKeyInput, aQ as GetWithKeyInput, aR as ListActorsInput, aS as ManagerDisplayInformation } from '../config-CwJCQyP1.cjs';
+import { R as RegistryConfig, aL as ManagerDriver } from '../config-BuBlMs6C.cjs';
+export { A as ActorDriver, aM as ActorInstance, aN as ActorOutput, b as AnyActorInstance, aO as CreateInput, aP as GetForIdInput, aQ as GetOrCreateWithKeyInput, aR as GetWithKeyInput, aS as ListActorsInput, aT as ManagerDisplayInformation } from '../config-BuBlMs6C.cjs';
 export { A as ALLOWED_PUBLIC_HEADERS, H as HEADER_ACTOR_ID, b as HEADER_ACTOR_QUERY, c as HEADER_CONN_PARAMS, d as HEADER_ENCODING, e as HEADER_RIVET_ACTOR, f as HEADER_RIVET_TARGET, P as PATH_CONNECT, g as PATH_WEBSOCKET_BASE, a as PATH_WEBSOCKET_PREFIX, W as WS_PROTOCOL_ACTOR, h as WS_PROTOCOL_CONN_PARAMS, i as WS_PROTOCOL_ENCODING, l as WS_PROTOCOL_PATH, j as WS_PROTOCOL_STANDARD, k as WS_PROTOCOL_TARGET } from '../actor-router-consts-DzI2szci.cjs';
 import * as _hono_zod_openapi from '@hono/zod-openapi';
 import { Hono } from 'hono';

package/dist/tsup/driver-helpers/mod.d.ts

@@ -1,5 +1,5 @@
-import { R as RegistryConfig, aK as ManagerDriver } from '../config-CbIHPGKl.js';
-export { A as ActorDriver, aL as ActorInstance, aM as ActorOutput, b as AnyActorInstance, aN as CreateInput, aO as GetForIdInput, aP as GetOrCreateWithKeyInput, aQ as GetWithKeyInput, aR as ListActorsInput, aS as ManagerDisplayInformation } from '../config-CbIHPGKl.js';
+import { R as RegistryConfig, aL as ManagerDriver } from '../config-CBwo4ooA.js';
+export { A as ActorDriver, aM as ActorInstance, aN as ActorOutput, b as AnyActorInstance, aO as CreateInput, aP as GetForIdInput, aQ as GetOrCreateWithKeyInput, aR as GetWithKeyInput, aS as ListActorsInput, aT as ManagerDisplayInformation } from '../config-CBwo4ooA.js';
 export { A as ALLOWED_PUBLIC_HEADERS, H as HEADER_ACTOR_ID, b as HEADER_ACTOR_QUERY, c as HEADER_CONN_PARAMS, d as HEADER_ENCODING, e as HEADER_RIVET_ACTOR, f as HEADER_RIVET_TARGET, P as PATH_CONNECT, g as PATH_WEBSOCKET_BASE, a as PATH_WEBSOCKET_PREFIX, W as WS_PROTOCOL_ACTOR, h as WS_PROTOCOL_CONN_PARAMS, i as WS_PROTOCOL_ENCODING, l as WS_PROTOCOL_PATH, j as WS_PROTOCOL_STANDARD, k as WS_PROTOCOL_TARGET } from '../actor-router-consts-DzI2szci.js';
 import * as _hono_zod_openapi from '@hono/zod-openapi';
 import { Hono } from 'hono';

package/dist/tsup/driver-helpers/mod.js

@@ -17,9 +17,9 @@ import {
   WS_TEST_PROTOCOL_PATH,
   buildManagerRouter,
   getInitialActorKvState
-} from "../chunk-MIOU6BF3.js";
+} from "../chunk-PVKUXMOA.js";
 import "../chunk-E6ZE2YEA.js";
-import "../chunk-4U45T5KW.js";
+import "../chunk-CDK6DRO2.js";
 import "../chunk-2YHR67M4.js";
 export {
   ALLOWED_PUBLIC_HEADERS,