rivetkit 2.0.37 → 2.0.39

package/dist/tsup/{chunk-G4N7FZMM.cjs → chunk-7E3RWMR6.cjs}

@@ -10,7 +10,7 @@
 
 
 
-var _chunkLYYTV7DNcjs = require('./chunk-LYYTV7DN.cjs');
+var _chunkDY4H3ASEcjs = require('./chunk-DY4H3ASE.cjs');
 
 
 
@@ -23,7 +23,7 @@ var _chunkLYYTV7DNcjs = require('./chunk-LYYTV7DN.cjs');
 
 
 
-var _chunk5VVIFC6Mcjs = require('./chunk-5VVIFC6M.cjs');
+var _chunkUAX5E3EUcjs = require('./chunk-UAX5E3EU.cjs');
 
 
 
@@ -47,7 +47,7 @@ var _chunk5VVIFC6Mcjs = require('./chunk-5VVIFC6M.cjs');
 
 
 
-var _chunkB6BP74X3cjs = require('./chunk-B6BP74X3.cjs');
+var _chunkKMYFL3OLcjs = require('./chunk-KMYFL3OL.cjs');
 
 
 
@@ -65,7 +65,7 @@ var _chunkB6BP74X3cjs = require('./chunk-B6BP74X3.cjs');
 
 
 
-var _chunkX5IX3YPOcjs = require('./chunk-X5IX3YPO.cjs');
+var _chunkX72X7I7Tcjs = require('./chunk-X72X7I7T.cjs');
 
 
 
@@ -142,11 +142,94 @@ var ActorConfigSchema = _zod.z.object({
     path: ["vars"]
   }
 );
+var DocActorOptionsSchema = _zod.z.object({
+  createVarsTimeout: _zod.z.number().optional().describe("Timeout in ms for createVars handler. Default: 5000"),
+  createConnStateTimeout: _zod.z.number().optional().describe(
+    "Timeout in ms for createConnState handler. Default: 5000"
+  ),
+  onConnectTimeout: _zod.z.number().optional().describe("Timeout in ms for onConnect handler. Default: 5000"),
+  onSleepTimeout: _zod.z.number().optional().describe(
+    "Timeout in ms for onSleep handler. Must be less than ACTOR_STOP_THRESHOLD_MS. Default: 5000"
+  ),
+  onDestroyTimeout: _zod.z.number().optional().describe("Timeout in ms for onDestroy handler. Default: 5000"),
+  stateSaveInterval: _zod.z.number().optional().describe(
+    "Interval in ms between automatic state saves. Default: 10000"
+  ),
+  actionTimeout: _zod.z.number().optional().describe("Timeout in ms for action handlers. Default: 60000"),
+  waitUntilTimeout: _zod.z.number().optional().describe(
+    "Max time in ms to wait for waitUntil background promises during shutdown. Default: 15000"
+  ),
+  connectionLivenessTimeout: _zod.z.number().optional().describe(
+    "Timeout in ms for connection liveness checks. Default: 2500"
+  ),
+  connectionLivenessInterval: _zod.z.number().optional().describe(
+    "Interval in ms between connection liveness checks. Default: 5000"
+  ),
+  noSleep: _zod.z.boolean().optional().describe("If true, the actor will never sleep. Default: false"),
+  sleepTimeout: _zod.z.number().optional().describe(
+    "Time in ms of inactivity before the actor sleeps. Default: 30000"
+  ),
+  canHibernateWebSocket: _zod.z.boolean().optional().describe(
+    "Whether WebSockets using onWebSocket can be hibernated. WebSockets using actions/events are hibernatable by default. Default: false"
+  )
+}).describe("Actor options for timeouts and behavior configuration.");
+var DocActorConfigSchema = _zod.z.object({
+  state: _zod.z.unknown().optional().describe(
+    "Initial state value for the actor. Cannot be used with createState."
+  ),
+  createState: _zod.z.unknown().optional().describe(
+    "Function to create initial state. Receives context and input. Cannot be used with state."
+  ),
+  connState: _zod.z.unknown().optional().describe(
+    "Initial connection state value. Cannot be used with createConnState."
+  ),
+  createConnState: _zod.z.unknown().optional().describe(
+    "Function to create connection state. Receives context and connection params. Cannot be used with connState."
+  ),
+  vars: _zod.z.unknown().optional().describe(
+    "Initial ephemeral variables value. Cannot be used with createVars."
+  ),
+  createVars: _zod.z.unknown().optional().describe(
+    "Function to create ephemeral variables. Receives context and driver context. Cannot be used with vars."
+  ),
+  db: _zod.z.unknown().optional().describe("Database provider instance for the actor."),
+  onCreate: _zod.z.unknown().optional().describe(
+    "Called when the actor is first initialized. Use to initialize state."
+  ),
+  onDestroy: _zod.z.unknown().optional().describe("Called when the actor is destroyed."),
+  onWake: _zod.z.unknown().optional().describe(
+    "Called when the actor wakes up and is ready to receive connections and actions."
+  ),
+  onSleep: _zod.z.unknown().optional().describe(
+    "Called when the actor is stopping or sleeping. Use to clean up resources."
+  ),
+  onStateChange: _zod.z.unknown().optional().describe(
+    "Called when the actor's state changes. State changes within this hook won't trigger recursion."
+  ),
+  onBeforeConnect: _zod.z.unknown().optional().describe(
+    "Called before a client connects. Throw an error to reject the connection."
+  ),
+  onConnect: _zod.z.unknown().optional().describe("Called when a client successfully connects."),
+  onDisconnect: _zod.z.unknown().optional().describe("Called when a client disconnects."),
+  onBeforeActionResponse: _zod.z.unknown().optional().describe(
+    "Called before sending an action response. Use to transform output."
+  ),
+  onRequest: _zod.z.unknown().optional().describe(
+    "Called for raw HTTP requests to /actors/{name}/http/* endpoints."
+  ),
+  onWebSocket: _zod.z.unknown().optional().describe(
+    "Called for raw WebSocket connections to /actors/{name}/websocket/* endpoints."
+  ),
+  actions: _zod.z.record(_zod.z.string(), _zod.z.unknown()).optional().describe(
+    "Map of action name to handler function. Defaults to an empty object."
+  ),
+  options: DocActorOptionsSchema.optional()
+}).describe("Actor configuration passed to the actor() function.");
 
 // src/actor/mod.ts
 function actor(input) {
   const config = ActorConfigSchema.parse(input);
-  return new (0, _chunk5VVIFC6Mcjs.ActorDefinition)(config);
+  return new (0, _chunkUAX5E3EUcjs.ActorDefinition)(config);
 }
 
 // src/drivers/engine/actor-driver.ts
@@ -158,7 +241,7 @@ var _invariant = require('invariant'); var _invariant2 = _interopRequireDefault(
 
 // src/drivers/engine/log.ts
 function logger() {
-  return _chunkX5IX3YPOcjs.getLogger.call(void 0, "driver-engine");
+  return _chunkX72X7I7Tcjs.getLogger.call(void 0, "driver-engine");
 }
 
 // src/drivers/engine/actor-driver.ts
@@ -172,8 +255,8 @@ var EngineActorDriver = class {
   #runner;
   #actors = /* @__PURE__ */ new Map();
   #actorRouter;
-  #runnerStarted = _chunkX5IX3YPOcjs.promiseWithResolvers.call(void 0, );
-  #runnerStopped = _chunkX5IX3YPOcjs.promiseWithResolvers.call(void 0, );
+  #runnerStarted = _chunkX72X7I7Tcjs.promiseWithResolvers.call(void 0, );
+  #runnerStopped = _chunkX72X7I7Tcjs.promiseWithResolvers.call(void 0, );
   #isRunnerStopped = false;
   // HACK: Track actor stop intent locally since the runner protocol doesn't
   // pass the stop reason to onActorStop. This will be fixed when the runner
@@ -197,7 +280,7 @@ var EngineActorDriver = class {
     this.#managerDriver = managerDriver;
     this.#inlineClient = inlineClient;
     const token = config.token;
-    this.#actorRouter = _chunkLYYTV7DNcjs.createActorRouter.call(void 0, 
+    this.#actorRouter = _chunkDY4H3ASEcjs.createActorRouter.call(void 0, 
       config,
       this,
       void 0,
@@ -205,16 +288,16 @@ var EngineActorDriver = class {
     );
     const engineRunnerConfig = {
       version: config.runner.version,
-      endpoint: _chunk5VVIFC6Mcjs.getEndpoint.call(void 0, config),
+      endpoint: _chunkUAX5E3EUcjs.getEndpoint.call(void 0, config),
       token,
       namespace: config.namespace,
       totalSlots: config.runner.totalSlots,
       runnerName: config.runner.runnerName,
       runnerKey: _nullishCoalesce(config.runner.runnerKey, () => ( crypto.randomUUID())),
       metadata: {
-        rivetkit: { version: _chunkX5IX3YPOcjs.VERSION }
+        rivetkit: { version: _chunkX72X7I7Tcjs.VERSION }
       },
-      prepopulateActorNames: _chunkB6BP74X3cjs.buildActorNames.call(void 0, config),
+      prepopulateActorNames: _chunkKMYFL3OLcjs.buildActorNames.call(void 0, config),
       onConnected: () => {
         this.#runnerStarted.resolve(void 0);
       },
@@ -231,7 +314,7 @@ var EngineActorDriver = class {
       },
       onActorStart: this.#runnerOnActorStart.bind(this),
       onActorStop: this.#runnerOnActorStop.bind(this),
-      logger: _chunkX5IX3YPOcjs.getLogger.call(void 0, "engine-runner")
+      logger: _chunkX72X7I7Tcjs.getLogger.call(void 0, "engine-runner")
     };
     this.#runner = new (0, _enginerunner.Runner)(engineRunnerConfig);
     this.#runner.start();
@@ -269,7 +352,7 @@ var EngineActorDriver = class {
       handler.alarmTimeout = void 0;
     }
     const delay = Math.max(0, timestamp - Date.now());
-    handler.alarmTimeout = _chunkX5IX3YPOcjs.setLongTimeout.call(void 0, () => {
+    handler.alarmTimeout = _chunkX72X7I7Tcjs.setLongTimeout.call(void 0, () => {
       actor2.onAlarm();
       handler.alarmTimeout = void 0;
     }, delay);
@@ -341,7 +424,7 @@ var EngineActorDriver = class {
             var _a;
             (_a = handler.actor) == null ? void 0 : _a.rLog.error({
               msg: "onStop errored",
-              error: _chunkX5IX3YPOcjs.stringifyError.call(void 0, err)
+              error: _chunkX72X7I7Tcjs.stringifyError.call(void 0, err)
             });
           })
         );
@@ -399,18 +482,18 @@ var EngineActorDriver = class {
     let handler = this.#actors.get(actorId);
     if (!handler) {
       handler = {
-        actorStartPromise: _chunkX5IX3YPOcjs.promiseWithResolvers.call(void 0, )
+        actorStartPromise: _chunkX72X7I7Tcjs.promiseWithResolvers.call(void 0, )
       };
       this.#actors.set(actorId, handler);
     }
     const name = actorConfig.name;
     _invariant2.default.call(void 0, actorConfig.key, "actor should have a key");
-    const key = _chunkB6BP74X3cjs.deserializeActorKey.call(void 0, actorConfig.key);
+    const key = _chunkKMYFL3OLcjs.deserializeActorKey.call(void 0, actorConfig.key);
     const [persistDataBuffer] = await this.#runner.kvGet(actorId, [
-      _chunkB6BP74X3cjs.KEYS.PERSIST_DATA
+      _chunkKMYFL3OLcjs.KEYS.PERSIST_DATA
     ]);
     if (persistDataBuffer === null) {
-      const initialKvState = _chunkB6BP74X3cjs.getInitialActorKvState.call(void 0, input);
+      const initialKvState = _chunkKMYFL3OLcjs.getInitialActorKvState.call(void 0, input);
       await this.#runner.kvPut(actorId, initialKvState);
       logger().debug({
         msg: "initialized persist data for new actor",
@@ -423,7 +506,7 @@ var EngineActorDriver = class {
         dataSize: persistDataBuffer.byteLength
       });
     }
-    const definition = _chunk5VVIFC6Mcjs.lookupInRegistry.call(void 0, this.#config, actorConfig.name);
+    const definition = _chunkUAX5E3EUcjs.lookupInRegistry.call(void 0, this.#config, actorConfig.name);
     handler.actor = definition.instantiate();
     await handler.actor.start(
       this,
@@ -447,7 +530,7 @@ var EngineActorDriver = class {
       } catch (err) {
         logger().error({
           msg: "error in onStop, proceeding with removing actor",
-          err: _chunkX5IX3YPOcjs.stringifyError.call(void 0, err)
+          err: _chunkX72X7I7Tcjs.stringifyError.call(void 0, err)
         });
       }
       this.#actors.delete(actorId);
@@ -480,10 +563,10 @@ var EngineActorDriver = class {
       websocketProps: websocketRaw ? Object.keys(websocketRaw).join(", ") : "null"
     });
     const protocols = request.headers.get("sec-websocket-protocol");
-    const { encoding, connParams } = _chunkB6BP74X3cjs.parseWebSocketProtocols.call(void 0, protocols);
+    const { encoding, connParams } = _chunkKMYFL3OLcjs.parseWebSocketProtocols.call(void 0, protocols);
     let wsHandler;
     try {
-      wsHandler = await _chunkB6BP74X3cjs.routeWebSocket.call(void 0, 
+      wsHandler = await _chunkKMYFL3OLcjs.routeWebSocket.call(void 0, 
         request,
         requestPath,
         requestHeaders,
@@ -506,7 +589,7 @@ var EngineActorDriver = class {
     const wsContext = new (0, _ws.WSContext)(websocket);
     const conn = wsHandler.conn;
     const actor2 = wsHandler.actor;
-    const connStateManager = conn == null ? void 0 : conn[_chunkB6BP74X3cjs.CONN_STATE_MANAGER_SYMBOL];
+    const connStateManager = conn == null ? void 0 : conn[_chunkKMYFL3OLcjs.CONN_STATE_MANAGER_SYMBOL];
     logger().debug({
       msg: "attaching websocket event listeners",
       actorId,
@@ -566,7 +649,7 @@ var EngineActorDriver = class {
         });
         const entry = this.#hwsMessageIndex.get(conn.id);
         if (entry) {
-          const messageLength = _chunkB6BP74X3cjs.getValueLength.call(void 0, event.data);
+          const messageLength = _chunkKMYFL3OLcjs.getValueLength.call(void 0, event.data);
           entry.bufferedMessageSize += messageLength;
           if (entry.bufferedMessageSize >= CONN_BUFFERED_MESSAGE_SIZE_THRESHOLD) {
             entry.bufferedMessageSize = 0;
@@ -637,10 +720,10 @@ var EngineActorDriver = class {
       gatewayId: _enginerunner.idToStr.call(void 0, gatewayId),
       requestId: _enginerunner.idToStr.call(void 0, requestId)
     });
-    if (path === _chunkB6BP74X3cjs.PATH_CONNECT) {
+    if (path === _chunkKMYFL3OLcjs.PATH_CONNECT) {
       return true;
-    } else if (path === _chunkB6BP74X3cjs.PATH_WEBSOCKET_BASE || path.startsWith(_chunkB6BP74X3cjs.PATH_WEBSOCKET_PREFIX)) {
-      const definition = _chunk5VVIFC6Mcjs.lookupInRegistry.call(void 0, 
+    } else if (path === _chunkKMYFL3OLcjs.PATH_WEBSOCKET_BASE || path.startsWith(_chunkKMYFL3OLcjs.PATH_WEBSOCKET_PREFIX)) {
+      const definition = _chunkUAX5E3EUcjs.lookupInRegistry.call(void 0, 
         this.#config,
         actorInstance.config.name
       );
@@ -649,7 +732,7 @@ var EngineActorDriver = class {
         return true;
       } else if (typeof canHibernateWebSocket === "function") {
         try {
-          const newPath = _chunkB6BP74X3cjs.truncateRawWebSocketPathPrefix.call(void 0, 
+          const newPath = _chunkKMYFL3OLcjs.truncateRawWebSocketPathPrefix.call(void 0, 
             url.pathname
           );
           const truncatedRequest = new Request(
@@ -668,7 +751,7 @@ var EngineActorDriver = class {
       } else {
         return false;
       }
-    } else if (path === _chunkB6BP74X3cjs.PATH_INSPECTOR_CONNECT) {
+    } else if (path === _chunkKMYFL3OLcjs.PATH_INSPECTOR_CONNECT) {
       return false;
     } else {
       logger().warn({
@@ -681,7 +764,7 @@ var EngineActorDriver = class {
   async #hwsLoadAll(actorId) {
     const actor2 = await this.loadActor(actorId);
     return actor2.conns.values().map((conn) => {
-      const connStateManager = conn[_chunkB6BP74X3cjs.CONN_STATE_MANAGER_SYMBOL];
+      const connStateManager = conn[_chunkKMYFL3OLcjs.CONN_STATE_MANAGER_SYMBOL];
       const hibernatable = connStateManager.hibernatableData;
       if (!hibernatable) return void 0;
       return {
@@ -704,7 +787,7 @@ var EngineActorDriver = class {
     await this.#runner.restoreHibernatingRequests(actor2.id, metaEntries);
   }
   onCreateConn(conn) {
-    const hibernatable = conn[_chunkB6BP74X3cjs.CONN_STATE_MANAGER_SYMBOL].hibernatableData;
+    const hibernatable = conn[_chunkKMYFL3OLcjs.CONN_STATE_MANAGER_SYMBOL].hibernatableData;
     if (!hibernatable) return;
     this.#hwsMessageIndex.set(conn.id, {
       serverMessageIndex: hibernatable.serverMessageIndex,
@@ -726,7 +809,7 @@ var EngineActorDriver = class {
     });
   }
   onBeforePersistConn(conn) {
-    const stateManager = conn[_chunkB6BP74X3cjs.CONN_STATE_MANAGER_SYMBOL];
+    const stateManager = conn[_chunkKMYFL3OLcjs.CONN_STATE_MANAGER_SYMBOL];
     const hibernatable = stateManager.hibernatableDataOrError();
     const entry = this.#hwsMessageIndex.get(conn.id);
     if (!entry) {
@@ -740,7 +823,7 @@ var EngineActorDriver = class {
     entry.serverMessageIndex = hibernatable.serverMessageIndex;
   }
   onAfterPersistConn(conn) {
-    const stateManager = conn[_chunkB6BP74X3cjs.CONN_STATE_MANAGER_SYMBOL];
+    const stateManager = conn[_chunkKMYFL3OLcjs.CONN_STATE_MANAGER_SYMBOL];
     const hibernatable = stateManager.hibernatableDataOrError();
     const entry = this.#hwsMessageIndex.get(conn.id);
     if (!entry) {
@@ -765,9 +848,9 @@ var EngineActorDriver = class {
 
 // src/drivers/engine/config.ts
 
-var EngineConfigSchemaBase = _chunk5VVIFC6Mcjs.ClientConfigSchemaBase.extend({
+var EngineConfigSchemaBase = _chunkUAX5E3EUcjs.ClientConfigSchemaBase.extend({
   /** Unique key for this runner. Runners connecting a given key will replace any other runner connected with the same key. */
-  runnerKey: _zod.z.string().optional().transform((val) => _nullishCoalesce(val, () => ( _chunkX5IX3YPOcjs.getRivetRunnerKey.call(void 0, )))),
+  runnerKey: _zod.z.string().optional().transform((val) => _nullishCoalesce(val, () => ( _chunkX72X7I7Tcjs.getRivetRunnerKey.call(void 0, )))),
   /** How many actors this runner can run. */
   totalSlots: _zod.z.number().default(1e5)
 });
@@ -779,7 +862,7 @@ var EngineConfigSchema = EngineConfigSchemaTransformed.default(
 );
 function transformEngineConfig(config, ctx) {
   return {
-    ..._chunk5VVIFC6Mcjs.transformClientConfig.call(void 0, config, ctx),
+    ..._chunkUAX5E3EUcjs.transformClientConfig.call(void 0, config, ctx),
     runnerKey: config.runnerKey
   };
 }
@@ -790,8 +873,8 @@ function createEngineDriver() {
     name: "engine",
     displayName: "Engine",
     manager: (config) => {
-      const clientConfig = _chunk5VVIFC6Mcjs.convertRegistryConfigToClientConfig.call(void 0, config);
-      return new (0, _chunk5VVIFC6Mcjs.RemoteManagerDriver)(clientConfig);
+      const clientConfig = _chunkUAX5E3EUcjs.convertRegistryConfigToClientConfig.call(void 0, config);
+      return new (0, _chunkUAX5E3EUcjs.RemoteManagerDriver)(clientConfig);
     },
     actor: (config, managerDriver, inlineClient) => {
       return new EngineActorDriver(
@@ -819,15 +902,15 @@ var LegacyRunnerConfigSchemaUnmerged = _zod.z.object({
   /** @experimental */
   maxOutgoingMessageSize: _zod.z.number().optional().default(1048576),
   /** @experimental */
-  inspector: _chunkB6BP74X3cjs.InspectorConfigSchema,
+  inspector: _chunkKMYFL3OLcjs.InspectorConfigSchema,
   /** @experimental */
   disableDefaultServer: _zod.z.boolean().optional().default(false),
   /** @experimental */
   defaultServerPort: _zod.z.number().default(6420),
   /** @experimental */
-  runEngine: _zod.z.boolean().optional().default(() => _chunkX5IX3YPOcjs.getRivetRunEngine.call(void 0, )),
+  runEngine: _zod.z.boolean().optional().default(() => _chunkX72X7I7Tcjs.getRivetRunEngine.call(void 0, )),
   /** @experimental */
-  runEngineVersion: _zod.z.string().optional().default(() => _nullishCoalesce(_chunkX5IX3YPOcjs.getRivetRunEngineVersion.call(void 0, ), () => ( _chunkX5IX3YPOcjs.VERSION))),
+  runEngineVersion: _zod.z.string().optional().default(() => _nullishCoalesce(_chunkX72X7I7Tcjs.getRivetRunEngineVersion.call(void 0, ), () => ( _chunkX72X7I7Tcjs.VERSION))),
   /** @experimental */
   overrideServerAddress: _zod.z.string().optional(),
   /** @experimental */
@@ -839,7 +922,7 @@ var LegacyRunnerConfigSchemaUnmerged = _zod.z.object({
    * serverlessly (by the Rivet Engine for example).
    */
   runnerKind: _zod.z.enum(["serverless", "normal"]).optional().default(
-    () => _chunkX5IX3YPOcjs.getRivetRunnerKind.call(void 0, ) === "serverless" ? "serverless" : "normal"
+    () => _chunkX72X7I7Tcjs.getRivetRunnerKind.call(void 0, ) === "serverless" ? "serverless" : "normal"
   ),
   totalSlots: _zod.z.number().optional(),
   /**
@@ -861,7 +944,7 @@ var LegacyRunnerConfigSchemaUnmerged = _zod.z.object({
    * */
   logging: _zod.z.object({
     baseLogger: _zod.z.custom().optional(),
-    level: _chunkX5IX3YPOcjs.LogLevelSchema.optional()
+    level: _chunkX72X7I7Tcjs.LogLevelSchema.optional()
   }).optional().default(() => ({})),
   /**
    * @experimental
@@ -889,7 +972,7 @@ var LegacyRunnerConfigSchemaUnmerged = _zod.z.object({
   // created or must be imported async using `await import(...)`
   getUpgradeWebSocket: _zod.z.custom().optional(),
   /** @experimental */
-  token: _zod.z.string().optional().transform((v) => v || _chunkX5IX3YPOcjs.getRivetToken.call(void 0, ))
+  token: _zod.z.string().optional().transform((v) => v || _chunkX72X7I7Tcjs.getRivetToken.call(void 0, ))
 }).merge(EngineConfigSchemaBase);
 var LegacyRunnerConfigSchemaTransformed = LegacyRunnerConfigSchemaUnmerged.transform((config, ctx) => ({
   ...config,
@@ -913,38 +996,38 @@ function chooseDefaultDriver(config) {
     return config.driver;
   }
   if (config.endpoint || config.token) {
-    _chunkB6BP74X3cjs.loggerWithoutContext.call(void 0, ).debug({
+    _chunkKMYFL3OLcjs.loggerWithoutContext.call(void 0, ).debug({
       msg: "using rivet engine driver",
       endpoint: config.endpoint
     });
     return createEngineDriver();
   }
-  _chunkB6BP74X3cjs.loggerWithoutContext.call(void 0, ).debug({ msg: "using default file system driver" });
-  return _chunkLYYTV7DNcjs.createFileSystemOrMemoryDriver.call(void 0, true);
+  _chunkKMYFL3OLcjs.loggerWithoutContext.call(void 0, ).debug({ msg: "using default file system driver" });
+  return _chunkDY4H3ASEcjs.createFileSystemOrMemoryDriver.call(void 0, true);
 }
 
 // src/engine-process/log.ts
 function logger2() {
-  return _chunkX5IX3YPOcjs.getLogger.call(void 0, "engine-process");
+  return _chunkX72X7I7Tcjs.getLogger.call(void 0, "engine-process");
 }
 
 // src/engine-process/mod.ts
 var ENGINE_BASE_URL = "https://releases.rivet.dev/rivet";
 var ENGINE_BINARY_NAME = "rivet-engine";
 async function ensureEngineProcess(options) {
-  _chunkLYYTV7DNcjs.importNodeDependencies.call(void 0, );
+  _chunkDY4H3ASEcjs.importNodeDependencies.call(void 0, );
   logger2().debug({
     msg: "ensuring engine process",
     version: options.version
   });
-  const path = _chunkLYYTV7DNcjs.getNodePath.call(void 0, );
-  const storageRoot = _chunkLYYTV7DNcjs.getStoragePath.call(void 0, );
+  const path = _chunkDY4H3ASEcjs.getNodePath.call(void 0, );
+  const storageRoot = _chunkDY4H3ASEcjs.getStoragePath.call(void 0, );
   const binDir = path.join(storageRoot, "bin");
   const varDir = path.join(storageRoot, "var");
   const logsDir = path.join(varDir, "logs", "rivet-engine");
-  await _chunkLYYTV7DNcjs.ensureDirectoryExists.call(void 0, binDir);
-  await _chunkLYYTV7DNcjs.ensureDirectoryExists.call(void 0, varDir);
-  await _chunkLYYTV7DNcjs.ensureDirectoryExists.call(void 0, logsDir);
+  await _chunkDY4H3ASEcjs.ensureDirectoryExists.call(void 0, binDir);
+  await _chunkDY4H3ASEcjs.ensureDirectoryExists.call(void 0, varDir);
+  await _chunkDY4H3ASEcjs.ensureDirectoryExists.call(void 0, logsDir);
   if (await isEngineRunning()) {
     try {
       const health = await waitForEngineHealth();
@@ -969,7 +1052,7 @@ async function ensureEngineProcess(options) {
   const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/:/g, "-").replace(/\./g, "-");
   const stdoutLogPath = path.join(logsDir, `engine-${timestamp}-stdout.log`);
   const stderrLogPath = path.join(logsDir, `engine-${timestamp}-stderr.log`);
-  const fsSync = _chunkLYYTV7DNcjs.getNodeFsSync.call(void 0, );
+  const fsSync = _chunkDY4H3ASEcjs.getNodeFsSync.call(void 0, );
   const stdoutStream = fsSync.createWriteStream(stdoutLogPath, {
     flags: "a"
   });
@@ -981,7 +1064,7 @@ async function ensureEngineProcess(options) {
     stdout: stdoutLogPath,
     stderr: stderrLogPath
   });
-  const childProcess = _chunkLYYTV7DNcjs.getNodeChildProcess.call(void 0, );
+  const childProcess = _chunkDY4H3ASEcjs.getNodeChildProcess.call(void 0, );
   const child = childProcess.spawn(binaryPath, ["start"], {
     cwd: path.dirname(binaryPath),
     stdio: ["inherit", "pipe", "pipe"],
@@ -1058,7 +1141,7 @@ async function downloadEngineBinaryIfNeeded(binaryPath, version, varDir) {
       `failed to download rivet engine binary from ${downloadUrl}: ${response.status} ${response.statusText}`
     );
   }
-  const crypto2 = _chunkLYYTV7DNcjs.getNodeCrypto.call(void 0, );
+  const crypto2 = _chunkDY4H3ASEcjs.getNodeCrypto.call(void 0, );
   const tempPath = `${binaryPath}.${crypto2.randomUUID()}.tmp`;
   const startTime = Date.now();
   logger2().debug({
@@ -1073,14 +1156,14 @@ async function downloadEngineBinaryIfNeeded(binaryPath, version, varDir) {
     });
   }, 5e3);
   try {
-    const stream = _chunkLYYTV7DNcjs.getNodeStream.call(void 0, );
-    const fsSync = _chunkLYYTV7DNcjs.getNodeFsSync.call(void 0, );
+    const stream = _chunkDY4H3ASEcjs.getNodeStream.call(void 0, );
+    const fsSync = _chunkDY4H3ASEcjs.getNodeFsSync.call(void 0, );
     await stream.pipeline(
       response.body,
       fsSync.createWriteStream(tempPath)
     );
     clearTimeout(slowDownloadWarning);
-    const fs = _chunkLYYTV7DNcjs.getNodeFs.call(void 0, );
+    const fs = _chunkDY4H3ASEcjs.getNodeFs.call(void 0, );
     const stats = await fs.stat(tempPath);
     const downloadDuration = Date.now() - startTime;
     if (process.platform !== "win32") {
@@ -1109,7 +1192,7 @@ async function downloadEngineBinaryIfNeeded(binaryPath, version, varDir) {
       support: "https://rivet.dev/discord"
     });
     try {
-      const fs = _chunkLYYTV7DNcjs.getNodeFs.call(void 0, );
+      const fs = _chunkDY4H3ASEcjs.getNodeFs.call(void 0, );
       await fs.unlink(tempPath);
     } catch (unlinkError) {
     }
@@ -1151,7 +1234,7 @@ function resolveTargetTripletFor(platform, arch) {
   );
 }
 async function isEngineRunning() {
-  return await checkIfEngineAlreadyRunningOnPort(_chunkB6BP74X3cjs.ENGINE_PORT);
+  return await checkIfEngineAlreadyRunningOnPort(_chunkKMYFL3OLcjs.ENGINE_PORT);
 }
 async function checkIfEngineAlreadyRunningOnPort(port) {
   let response;
@@ -1186,7 +1269,7 @@ async function checkIfEngineAlreadyRunningOnPort(port) {
 }
 async function fileExists(filePath) {
   try {
-    const fs = _chunkLYYTV7DNcjs.getNodeFs.call(void 0, );
+    const fs = _chunkDY4H3ASEcjs.getNodeFs.call(void 0, );
     await fs.access(filePath);
     return true;
   } catch (e) {
@@ -1200,7 +1283,7 @@ async function waitForEngineHealth() {
   logger2().debug({ msg: "waiting for engine health check" });
   for (let i = 0; i < maxRetries; i++) {
     try {
-      const response = await fetch(`${_chunkB6BP74X3cjs.ENGINE_ENDPOINT}/health`, {
+      const response = await fetch(`${_chunkKMYFL3OLcjs.ENGINE_ENDPOINT}/health`, {
         signal: AbortSignal.timeout(1e3)
       });
       if (response.ok) {
@@ -1244,7 +1327,7 @@ function getInspectorUrl(config, managerPort) {
 
 // src/serverless/log.ts
 function logger3() {
-  return _chunkX5IX3YPOcjs.getLogger.call(void 0, "serverless");
+  return _chunkX72X7I7Tcjs.getLogger.call(void 0, "serverless");
 }
 
 // src/serverless/configure.ts
@@ -1264,12 +1347,12 @@ async function configureServerlessRunner(config) {
     }
     const customConfig = config.serverless.configureRunnerPool;
     _invariant2.default.call(void 0, customConfig, "configureRunnerPool should exist");
-    const clientConfig = _chunk5VVIFC6Mcjs.convertRegistryConfigToClientConfig.call(void 0, config);
+    const clientConfig = _chunkUAX5E3EUcjs.convertRegistryConfigToClientConfig.call(void 0, config);
     logger3().debug({
       msg: "fetching datacenters",
       endpoint: config.endpoint
     });
-    const dcsRes = await _chunk5VVIFC6Mcjs.getDatacenters.call(void 0, clientConfig);
+    const dcsRes = await _chunkUAX5E3EUcjs.getDatacenters.call(void 0, clientConfig);
     const runnerName = _nullishCoalesce(customConfig.name, () => ( "default"));
     logger3().debug({
       msg: "configuring serverless runner",
@@ -1288,7 +1371,7 @@ async function configureServerlessRunner(config) {
       },
       metadata: _nullishCoalesce(customConfig.metadata, () => ( {}))
     };
-    await _chunk5VVIFC6Mcjs.updateRunnerConfig.call(void 0, clientConfig, runnerName, {
+    await _chunkUAX5E3EUcjs.updateRunnerConfig.call(void 0, clientConfig, runnerName, {
       datacenters: Object.fromEntries(
         dcsRes.datacenters.map((dc) => [dc.name, serverlessConfig])
       )
@@ -1308,7 +1391,7 @@ async function configureServerlessRunner(config) {
 
 // src/registry/log.ts
 function logger4() {
-  return _chunkX5IX3YPOcjs.getLogger.call(void 0, "registry");
+  return _chunkX72X7I7Tcjs.getLogger.call(void 0, "registry");
 }
 
 // src/registry/serve.ts
@@ -1323,7 +1406,7 @@ async function findFreePort(startPort = DEFAULT_PORT) {
   return _getport2.default.call(void 0, { port: portRange(startPort) });
 }
 async function crossPlatformServe(config, managerPort, app) {
-  const runtime = _chunkX5IX3YPOcjs.detectRuntime.call(void 0, );
+  const runtime = _chunkX72X7I7Tcjs.detectRuntime.call(void 0, );
   logger4().debug({ msg: "detected runtime for serve", runtime });
   switch (runtime) {
     case "deno":
@@ -1348,7 +1431,7 @@ async function serveNode(config, managerPort, app) {
   } catch (err) {
     logger4().error({
       msg: "failed to import @hono/node-server. please run 'npm install @hono/node-server @hono/node-ws'",
-      error: _chunkX5IX3YPOcjs.stringifyError.call(void 0, err)
+      error: _chunkX72X7I7Tcjs.stringifyError.call(void 0, err)
     });
     process.exit(1);
   }
@@ -1363,7 +1446,7 @@ async function serveNode(config, managerPort, app) {
   } catch (err) {
     logger4().error({
       msg: "failed to import @hono/node-ws. please run 'npm install @hono/node-server @hono/node-ws'",
-      error: _chunkX5IX3YPOcjs.stringifyError.call(void 0, err)
+      error: _chunkX72X7I7Tcjs.stringifyError.call(void 0, err)
     });
     process.exit(1);
   }
@@ -1390,7 +1473,7 @@ async function serveDeno(config, managerPort, app) {
   } catch (err) {
     logger4().error({
       msg: "failed to import hono/deno",
-      error: _chunkX5IX3YPOcjs.stringifyError.call(void 0, err)
+      error: _chunkX72X7I7Tcjs.stringifyError.call(void 0, err)
     });
     process.exit(1);
   }
@@ -1411,7 +1494,7 @@ async function serveBun(config, managerPort, app) {
   } catch (err) {
     logger4().error({
       msg: "failed to import hono/bun",
-      error: _chunkX5IX3YPOcjs.stringifyError.call(void 0, err)
+      error: _chunkX72X7I7Tcjs.stringifyError.call(void 0, err)
     });
     process.exit(1);
   }
@@ -1449,7 +1532,7 @@ var ServerlessStartHeadersSchema = _zod.z.object({
 
 // src/serverless/router.ts
 function buildServerlessRouter(driverConfig, config) {
-  return _chunkB6BP74X3cjs.createRouter.call(void 0, config.serverless.basePath, (router) => {
+  return _chunkKMYFL3OLcjs.createRouter.call(void 0, config.serverless.basePath, (router) => {
     router.get("/", (c) => {
       return c.text(
         "This is a RivetKit server.\n\nLearn more at https://rivetkit.org"
@@ -1498,10 +1581,10 @@ function buildServerlessRouter(driverConfig, config) {
           runnerKey: void 0
         }
       };
-      const managerDriver = new (0, _chunk5VVIFC6Mcjs.RemoteManagerDriver)(
-        _chunk5VVIFC6Mcjs.convertRegistryConfigToClientConfig.call(void 0, newConfig)
+      const managerDriver = new (0, _chunkUAX5E3EUcjs.RemoteManagerDriver)(
+        _chunkUAX5E3EUcjs.convertRegistryConfigToClientConfig.call(void 0, newConfig)
       );
-      const client = _chunk5VVIFC6Mcjs.createClientWithDriver.call(void 0, managerDriver);
+      const client = _chunkUAX5E3EUcjs.createClientWithDriver.call(void 0, managerDriver);
       const actorDriver = driverConfig.actor(
         newConfig,
         managerDriver,
@@ -1513,10 +1596,10 @@ function buildServerlessRouter(driverConfig, config) {
       );
       return await actorDriver.serverlessHandleStart(c);
     });
-    router.get("/health", (c) => _chunkB6BP74X3cjs.handleHealthRequest.call(void 0, c));
+    router.get("/health", (c) => _chunkKMYFL3OLcjs.handleHealthRequest.call(void 0, c));
     router.get(
       "/metadata",
-      (c) => _chunkB6BP74X3cjs.handleMetadataRequest.call(void 0, 
+      (c) => _chunkKMYFL3OLcjs.handleMetadataRequest.call(void 0, 
         c,
         config,
         { serverless: {} },
@@ -1531,13 +1614,29 @@ function normalizeEndpointUrl(url) {
   try {
     const parsed = new URL(url);
     const pathname = parsed.pathname === "/" ? "/" : parsed.pathname.replace(/\/+$/, "");
-    const hostname = parsed.hostname === "127.0.0.1" || parsed.hostname === "0.0.0.0" ? "localhost" : parsed.hostname;
+    let hostname = isLoopbackAddress(parsed.hostname) ? "localhost" : parsed.hostname;
+    hostname = normalizeRegionalHostname(hostname);
     const host = parsed.port ? `${hostname}:${parsed.port}` : hostname;
     return `${parsed.protocol}//${host}${pathname}`;
   } catch (e2) {
     return null;
   }
 }
+function normalizeRegionalHostname(hostname) {
+  if (!hostname.endsWith(".rivet.dev")) {
+    return hostname;
+  }
+  if (!hostname.startsWith("api-")) {
+    return hostname;
+  }
+  const withoutPrefix = hostname.slice(4);
+  const firstDotIndex = withoutPrefix.indexOf(".");
+  if (firstDotIndex === -1) {
+    return hostname;
+  }
+  const domain = withoutPrefix.slice(firstDotIndex + 1);
+  return `api.${domain}`;
+}
 function endpointsMatch(a, b) {
   const normalizedA = normalizeEndpointUrl(a);
   const normalizedB = normalizeEndpointUrl(b);
@@ -1546,6 +1645,9 @@ function endpointsMatch(a, b) {
   }
   return normalizedA === normalizedB;
 }
+function isLoopbackAddress(hostname) {
+  return hostname === "127.0.0.1" || hostname === "0.0.0.0" || hostname === "::1" || hostname === "[::1]";
+}
 
 // runtime/index.ts
 function logLine(label, value) {
@@ -1582,9 +1684,9 @@ var Runtime = class _Runtime {
     logger4().info("rivetkit starting");
     const config = registry.parseConfig();
     if ((_a = config.logging) == null ? void 0 : _a.baseLogger) {
-      _chunkX5IX3YPOcjs.configureBaseLogger.call(void 0, config.logging.baseLogger);
+      _chunkX72X7I7Tcjs.configureBaseLogger.call(void 0, config.logging.baseLogger);
     } else {
-      _chunkX5IX3YPOcjs.configureDefaultLogger.call(void 0, (_b = config.logging) == null ? void 0 : _b.level);
+      _chunkX72X7I7Tcjs.configureDefaultLogger.call(void 0, (_b = config.logging) == null ? void 0 : _b.level);
     }
     _invariant2.default.call(void 0, 
       !(config.serverless.spawnEngine && config.serveManager),
@@ -1594,7 +1696,7 @@ var Runtime = class _Runtime {
     const managerDriver = driver.manager(config);
     let managerPort;
     if (config.serverless.spawnEngine) {
-      managerPort = _chunkB6BP74X3cjs.ENGINE_PORT;
+      managerPort = _chunkKMYFL3OLcjs.ENGINE_PORT;
       logger4().debug({
         msg: "spawning engine",
         version: config.serverless.engineVersion
@@ -1606,7 +1708,7 @@ var Runtime = class _Runtime {
       let upgradeWebSocket;
       const getUpgradeWebSocket = () => upgradeWebSocket;
       managerDriver.setGetUpgradeWebSocket(getUpgradeWebSocket);
-      const { router: managerRouter } = _chunkB6BP74X3cjs.buildManagerRouter.call(void 0, 
+      const { router: managerRouter } = _chunkKMYFL3OLcjs.buildManagerRouter.call(void 0, 
         config,
         managerDriver,
         getUpgradeWebSocket
@@ -1658,7 +1760,7 @@ var Runtime = class _Runtime {
     this.#startKind = "runner";
     if (this.#config.runner && this.#driver.autoStartActorDriver) {
       logger4().debug("starting actor driver");
-      const inlineClient = _chunk5VVIFC6Mcjs.createClientWithDriver.call(void 0, 
+      const inlineClient = _chunkUAX5E3EUcjs.createClientWithDriver.call(void 0, 
         this.#managerDriver
       );
       this.#driver.actor(this.#config, this.#managerDriver, inlineClient);
@@ -1670,7 +1772,7 @@ var Runtime = class _Runtime {
     const inspectorUrl = this.managerPort ? getInspectorUrl(this.#config, this.managerPort) : void 0;
     console.log();
     console.log(
-      `  RivetKit ${_chunkX5IX3YPOcjs.package_default.version} (${this.#driver.displayName} - ${this.#startKind === "serverless" ? "Serverless" : "Runner"})`
+      `  RivetKit ${_chunkX72X7I7Tcjs.package_default.version} (${this.#driver.displayName} - ${this.#startKind === "serverless" ? "Serverless" : "Runner"})`
     );
     if (this.#config.namespace !== "default") {
       logLine("Namespace", this.#config.namespace);
@@ -1711,7 +1813,7 @@ var Registry = class {
     return this.#config;
   }
   parseConfig() {
-    return _chunkB6BP74X3cjs.RegistryConfigSchema.parse(this.#config);
+    return _chunkKMYFL3OLcjs.RegistryConfigSchema.parse(this.#config);
   }
   // Shared runtime instance
   #runtime;
@@ -1777,7 +1879,7 @@ var Registry = class {
         "autoConfigureServerless can only be configured when runnerKind is 'serverless'"
       );
     }
-    const isDevEnv = _chunkX5IX3YPOcjs.isDev.call(void 0, );
+    const isDevEnv = _chunkX72X7I7Tcjs.isDev.call(void 0, );
     if (isDevEnv && config.runnerKind === "serverless") {
       if ((inputConfig == null ? void 0 : inputConfig.runEngine) === void 0) config.runEngine = true;
       if ((inputConfig == null ? void 0 : inputConfig.autoConfigureServerless) === void 0)
@@ -1790,7 +1892,7 @@ var Registry = class {
     }
   }
   #legacyStartServerless(config, _inputConfig) {
-    const client = _chunk5VVIFC6Mcjs.createClient.call(void 0, {
+    const client = _chunkUAX5E3EUcjs.createClient.call(void 0, {
       endpoint: config.endpoint,
       token: config.token,
       namespace: config.namespace,
@@ -1803,7 +1905,7 @@ var Registry = class {
   }
   #legacyStartNormal(config) {
     this.#ensureRuntime().then((runtime) => runtime.startRunner());
-    const client = _chunk5VVIFC6Mcjs.createClient.call(void 0, {
+    const client = _chunkUAX5E3EUcjs.createClient.call(void 0, {
       endpoint: config.endpoint,
       token: config.token,
       namespace: config.namespace,
@@ -1825,4 +1927,4 @@ function setup(input) {
 
 
 exports.actor = actor; exports.createEngineDriver = createEngineDriver; exports.Registry = Registry; exports.setup = setup;
-//# sourceMappingURL=chunk-G4N7FZMM.cjs.map
+//# sourceMappingURL=chunk-7E3RWMR6.cjs.map