rivetkit 2.3.0-rc.5 → 2.3.0-rc.7

package/dist/browser/client.d.ts

@@ -190,6 +190,7 @@ interface DeconstructedError {
     code: string;
     message: string;
     metadata?: unknown;
+    actor?: ActorSpecifier;
 }
 
 interface RivetErrorOptions extends ErrorOptions {
@@ -199,6 +200,14 @@ interface RivetErrorOptions extends ErrorOptions {
     metadata?: unknown;
     /** Explicit HTTP status override for router responses. */
     statusCode?: number;
+    /** Actor context associated with this error. */
+    actor?: ActorSpecifier;
+}
+/** Identifies the actor that was handling work when an error was produced. */
+interface ActorSpecifier {
+    actorId: string;
+    generation: number;
+    key?: string;
 }
 interface UserErrorOptions extends ErrorOptions {
     /**
@@ -217,6 +226,7 @@ declare class RivetError extends Error {
     public: boolean;
     metadata?: unknown;
     statusCode: number;
+    actor?: ActorSpecifier;
     readonly group: string;
     readonly code: string;
     static isRivetError(error: unknown): error is RivetError | DeconstructedError;
@@ -919,6 +929,7 @@ type Client<A extends Registry<any>> = ClientRaw & {
 };
 
 declare const ACTOR_CONTEXT_INTERNAL_SYMBOL: unique symbol;
+declare const RAW_STATE_SYMBOL: unique symbol;
 interface ActorLogger {
     level: any;
     fatal: any;
@@ -1038,6 +1049,8 @@ interface Conn<TState = unknown, TConnParams = unknown, TConnState = unknown, TV
 }
 interface ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> {
     [ACTOR_CONTEXT_INTERNAL_SYMBOL]?: unknown;
+    /** Returns the raw unwrapped state without the write-through proxy. */
+    [RAW_STATE_SYMBOL](): TState;
     state: TState;
     vars: TVars;
     readonly kv: ActorKv;
@@ -1461,7 +1474,7 @@ declare const RegistryConfigSchema: z$2.ZodPipe<z$2.ZodObject<{
         envoyKey: z$2.ZodOptional<z$2.ZodString>;
     }, z$2.core.$strip>>>;
     shutdown: z$2.ZodDefault<z$2.ZodOptional<z$2.ZodObject<{
-        gracePeriodMs: z$2.ZodDefault<z$2.ZodOptional<z$2.ZodNumber>>;
+        gracePeriodMs: z$2.ZodOptional<z$2.ZodNumber>;
         disableSignalHandlers: z$2.ZodDefault<z$2.ZodOptional<z$2.ZodBoolean>>;
     }, z$2.core.$strip>>>;
 }, z$2.core.$strip>, z$2.ZodTransform<{
@@ -1512,8 +1525,8 @@ declare const RegistryConfigSchema: z$2.ZodPipe<z$2.ZodObject<{
         envoyKey?: string | undefined;
     };
     shutdown: {
-        gracePeriodMs: number;
         disableSignalHandlers: boolean;
+        gracePeriodMs?: number | undefined;
     };
     staticDir?: string | undefined;
     httpHost?: string | undefined;
@@ -1571,8 +1584,8 @@ declare const RegistryConfigSchema: z$2.ZodPipe<z$2.ZodObject<{
         envoyKey?: string | undefined;
     };
     shutdown: {
-        gracePeriodMs: number;
         disableSignalHandlers: boolean;
+        gracePeriodMs?: number | undefined;
     };
     staticDir?: string | undefined;
     httpHost?: string | undefined;
@@ -1625,6 +1638,25 @@ declare class Registry<A extends RegistryActors> {
      * ```
      */
     serve(): ServerlessHandler;
+    /**
+     * Starts an HTTP server that dispatches every request through the
+     * serverless handler. Uses `crossPlatformServe` to pick the right
+     * runtime (Node, Bun, Deno).
+     *
+     * @param opts.port      Port to listen on. Defaults to 3000.
+     * @param opts.publicDir If set, serves static files from this directory
+     *                       before falling through to the registry handler.
+     *
+     * @example
+     * ```ts
+     * await registry.listen();
+     * await registry.listen({ port: 8080, publicDir: "./public" });
+     * ```
+     */
+    listen(opts?: {
+        port?: number;
+        publicDir?: string;
+    }): Promise<void>;
     diagnostics(): Promise<RegistryDiagnostics>;
     startEnvoy(): void;
     /**