rivetkit 2.0.36 → 2.0.38

package/dist/tsup/{chunk-OYJU4B2I.cjs → chunk-6WLJW57U.cjs}

@@ -10,7 +10,7 @@
 
 
 
-var _chunk7EGXCVJLcjs = require('./chunk-7EGXCVJL.cjs');
+var _chunkIRTVRBJAcjs = require('./chunk-IRTVRBJA.cjs');
 
 
 
@@ -23,7 +23,7 @@ var _chunk7EGXCVJLcjs = require('./chunk-7EGXCVJL.cjs');
 
 
 
-var _chunkRTSLQIZ5cjs = require('./chunk-RTSLQIZ5.cjs');
+var _chunkLULP6HM2cjs = require('./chunk-LULP6HM2.cjs');
 
 
 
@@ -47,7 +47,7 @@ var _chunkRTSLQIZ5cjs = require('./chunk-RTSLQIZ5.cjs');
 
 
 
-var _chunk6TLJAB64cjs = require('./chunk-6TLJAB64.cjs');
+var _chunkIWXMFQDTcjs = require('./chunk-IWXMFQDT.cjs');
 
 
 
@@ -65,7 +65,7 @@ var _chunk6TLJAB64cjs = require('./chunk-6TLJAB64.cjs');
 
 
 
-var _chunkWRYYREBNcjs = require('./chunk-WRYYREBN.cjs');
+var _chunkO433HWWGcjs = require('./chunk-O433HWWG.cjs');
 
 
 
@@ -142,11 +142,48 @@ 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."),
+  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, _chunkRTSLQIZ5cjs.ActorDefinition)(config);
+  return new (0, _chunkLULP6HM2cjs.ActorDefinition)(config);
 }
 
 // src/drivers/engine/actor-driver.ts
@@ -158,7 +195,7 @@ var _invariant = require('invariant'); var _invariant2 = _interopRequireDefault(
 
 // src/drivers/engine/log.ts
 function logger() {
-  return _chunkWRYYREBNcjs.getLogger.call(void 0, "driver-engine");
+  return _chunkO433HWWGcjs.getLogger.call(void 0, "driver-engine");
 }
 
 // src/drivers/engine/actor-driver.ts
@@ -172,8 +209,8 @@ var EngineActorDriver = class {
   #runner;
   #actors = /* @__PURE__ */ new Map();
   #actorRouter;
-  #runnerStarted = _chunkWRYYREBNcjs.promiseWithResolvers.call(void 0, );
-  #runnerStopped = _chunkWRYYREBNcjs.promiseWithResolvers.call(void 0, );
+  #runnerStarted = _chunkO433HWWGcjs.promiseWithResolvers.call(void 0, );
+  #runnerStopped = _chunkO433HWWGcjs.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 +234,7 @@ var EngineActorDriver = class {
     this.#managerDriver = managerDriver;
     this.#inlineClient = inlineClient;
     const token = config.token;
-    this.#actorRouter = _chunk7EGXCVJLcjs.createActorRouter.call(void 0, 
+    this.#actorRouter = _chunkIRTVRBJAcjs.createActorRouter.call(void 0, 
       config,
       this,
       void 0,
@@ -205,16 +242,16 @@ var EngineActorDriver = class {
     );
     const engineRunnerConfig = {
       version: config.runner.version,
-      endpoint: _chunkRTSLQIZ5cjs.getEndpoint.call(void 0, config),
+      endpoint: _chunkLULP6HM2cjs.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: _chunkWRYYREBNcjs.VERSION }
+        rivetkit: { version: _chunkO433HWWGcjs.VERSION }
       },
-      prepopulateActorNames: _chunk6TLJAB64cjs.buildActorNames.call(void 0, config),
+      prepopulateActorNames: _chunkIWXMFQDTcjs.buildActorNames.call(void 0, config),
       onConnected: () => {
         this.#runnerStarted.resolve(void 0);
       },
@@ -231,7 +268,7 @@ var EngineActorDriver = class {
       },
       onActorStart: this.#runnerOnActorStart.bind(this),
       onActorStop: this.#runnerOnActorStop.bind(this),
-      logger: _chunkWRYYREBNcjs.getLogger.call(void 0, "engine-runner")
+      logger: _chunkO433HWWGcjs.getLogger.call(void 0, "engine-runner")
     };
     this.#runner = new (0, _enginerunner.Runner)(engineRunnerConfig);
     this.#runner.start();
@@ -269,7 +306,7 @@ var EngineActorDriver = class {
       handler.alarmTimeout = void 0;
     }
     const delay = Math.max(0, timestamp - Date.now());
-    handler.alarmTimeout = _chunkWRYYREBNcjs.setLongTimeout.call(void 0, () => {
+    handler.alarmTimeout = _chunkO433HWWGcjs.setLongTimeout.call(void 0, () => {
       actor2.onAlarm();
       handler.alarmTimeout = void 0;
     }, delay);
@@ -341,7 +378,7 @@ var EngineActorDriver = class {
             var _a;
             (_a = handler.actor) == null ? void 0 : _a.rLog.error({
               msg: "onStop errored",
-              error: _chunkWRYYREBNcjs.stringifyError.call(void 0, err)
+              error: _chunkO433HWWGcjs.stringifyError.call(void 0, err)
             });
           })
         );
@@ -399,18 +436,18 @@ var EngineActorDriver = class {
     let handler = this.#actors.get(actorId);
     if (!handler) {
       handler = {
-        actorStartPromise: _chunkWRYYREBNcjs.promiseWithResolvers.call(void 0, )
+        actorStartPromise: _chunkO433HWWGcjs.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 = _chunk6TLJAB64cjs.deserializeActorKey.call(void 0, actorConfig.key);
+    const key = _chunkIWXMFQDTcjs.deserializeActorKey.call(void 0, actorConfig.key);
     const [persistDataBuffer] = await this.#runner.kvGet(actorId, [
-      _chunk6TLJAB64cjs.KEYS.PERSIST_DATA
+      _chunkIWXMFQDTcjs.KEYS.PERSIST_DATA
     ]);
     if (persistDataBuffer === null) {
-      const initialKvState = _chunk6TLJAB64cjs.getInitialActorKvState.call(void 0, input);
+      const initialKvState = _chunkIWXMFQDTcjs.getInitialActorKvState.call(void 0, input);
       await this.#runner.kvPut(actorId, initialKvState);
       logger().debug({
         msg: "initialized persist data for new actor",
@@ -423,7 +460,7 @@ var EngineActorDriver = class {
         dataSize: persistDataBuffer.byteLength
       });
     }
-    const definition = _chunkRTSLQIZ5cjs.lookupInRegistry.call(void 0, this.#config, actorConfig.name);
+    const definition = _chunkLULP6HM2cjs.lookupInRegistry.call(void 0, this.#config, actorConfig.name);
     handler.actor = definition.instantiate();
     await handler.actor.start(
       this,
@@ -447,7 +484,7 @@ var EngineActorDriver = class {
       } catch (err) {
         logger().error({
           msg: "error in onStop, proceeding with removing actor",
-          err: _chunkWRYYREBNcjs.stringifyError.call(void 0, err)
+          err: _chunkO433HWWGcjs.stringifyError.call(void 0, err)
         });
       }
       this.#actors.delete(actorId);
@@ -480,10 +517,10 @@ var EngineActorDriver = class {
       websocketProps: websocketRaw ? Object.keys(websocketRaw).join(", ") : "null"
     });
     const protocols = request.headers.get("sec-websocket-protocol");
-    const { encoding, connParams } = _chunk6TLJAB64cjs.parseWebSocketProtocols.call(void 0, protocols);
+    const { encoding, connParams } = _chunkIWXMFQDTcjs.parseWebSocketProtocols.call(void 0, protocols);
     let wsHandler;
     try {
-      wsHandler = await _chunk6TLJAB64cjs.routeWebSocket.call(void 0, 
+      wsHandler = await _chunkIWXMFQDTcjs.routeWebSocket.call(void 0, 
         request,
         requestPath,
         requestHeaders,
@@ -506,7 +543,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[_chunk6TLJAB64cjs.CONN_STATE_MANAGER_SYMBOL];
+    const connStateManager = conn == null ? void 0 : conn[_chunkIWXMFQDTcjs.CONN_STATE_MANAGER_SYMBOL];
     logger().debug({
       msg: "attaching websocket event listeners",
       actorId,
@@ -566,7 +603,7 @@ var EngineActorDriver = class {
         });
         const entry = this.#hwsMessageIndex.get(conn.id);
         if (entry) {
-          const messageLength = _chunk6TLJAB64cjs.getValueLength.call(void 0, event.data);
+          const messageLength = _chunkIWXMFQDTcjs.getValueLength.call(void 0, event.data);
           entry.bufferedMessageSize += messageLength;
           if (entry.bufferedMessageSize >= CONN_BUFFERED_MESSAGE_SIZE_THRESHOLD) {
             entry.bufferedMessageSize = 0;
@@ -637,10 +674,10 @@ var EngineActorDriver = class {
       gatewayId: _enginerunner.idToStr.call(void 0, gatewayId),
       requestId: _enginerunner.idToStr.call(void 0, requestId)
     });
-    if (path === _chunk6TLJAB64cjs.PATH_CONNECT) {
+    if (path === _chunkIWXMFQDTcjs.PATH_CONNECT) {
       return true;
-    } else if (path === _chunk6TLJAB64cjs.PATH_WEBSOCKET_BASE || path.startsWith(_chunk6TLJAB64cjs.PATH_WEBSOCKET_PREFIX)) {
-      const definition = _chunkRTSLQIZ5cjs.lookupInRegistry.call(void 0, 
+    } else if (path === _chunkIWXMFQDTcjs.PATH_WEBSOCKET_BASE || path.startsWith(_chunkIWXMFQDTcjs.PATH_WEBSOCKET_PREFIX)) {
+      const definition = _chunkLULP6HM2cjs.lookupInRegistry.call(void 0, 
         this.#config,
         actorInstance.config.name
       );
@@ -649,7 +686,7 @@ var EngineActorDriver = class {
         return true;
       } else if (typeof canHibernateWebSocket === "function") {
         try {
-          const newPath = _chunk6TLJAB64cjs.truncateRawWebSocketPathPrefix.call(void 0, 
+          const newPath = _chunkIWXMFQDTcjs.truncateRawWebSocketPathPrefix.call(void 0, 
             url.pathname
           );
           const truncatedRequest = new Request(
@@ -668,7 +705,7 @@ var EngineActorDriver = class {
       } else {
         return false;
       }
-    } else if (path === _chunk6TLJAB64cjs.PATH_INSPECTOR_CONNECT) {
+    } else if (path === _chunkIWXMFQDTcjs.PATH_INSPECTOR_CONNECT) {
       return false;
     } else {
       logger().warn({
@@ -681,7 +718,7 @@ var EngineActorDriver = class {
   async #hwsLoadAll(actorId) {
     const actor2 = await this.loadActor(actorId);
     return actor2.conns.values().map((conn) => {
-      const connStateManager = conn[_chunk6TLJAB64cjs.CONN_STATE_MANAGER_SYMBOL];
+      const connStateManager = conn[_chunkIWXMFQDTcjs.CONN_STATE_MANAGER_SYMBOL];
       const hibernatable = connStateManager.hibernatableData;
       if (!hibernatable) return void 0;
       return {
@@ -704,7 +741,7 @@ var EngineActorDriver = class {
     await this.#runner.restoreHibernatingRequests(actor2.id, metaEntries);
   }
   onCreateConn(conn) {
-    const hibernatable = conn[_chunk6TLJAB64cjs.CONN_STATE_MANAGER_SYMBOL].hibernatableData;
+    const hibernatable = conn[_chunkIWXMFQDTcjs.CONN_STATE_MANAGER_SYMBOL].hibernatableData;
     if (!hibernatable) return;
     this.#hwsMessageIndex.set(conn.id, {
       serverMessageIndex: hibernatable.serverMessageIndex,
@@ -726,7 +763,7 @@ var EngineActorDriver = class {
     });
   }
   onBeforePersistConn(conn) {
-    const stateManager = conn[_chunk6TLJAB64cjs.CONN_STATE_MANAGER_SYMBOL];
+    const stateManager = conn[_chunkIWXMFQDTcjs.CONN_STATE_MANAGER_SYMBOL];
     const hibernatable = stateManager.hibernatableDataOrError();
     const entry = this.#hwsMessageIndex.get(conn.id);
     if (!entry) {
@@ -740,7 +777,7 @@ var EngineActorDriver = class {
     entry.serverMessageIndex = hibernatable.serverMessageIndex;
   }
   onAfterPersistConn(conn) {
-    const stateManager = conn[_chunk6TLJAB64cjs.CONN_STATE_MANAGER_SYMBOL];
+    const stateManager = conn[_chunkIWXMFQDTcjs.CONN_STATE_MANAGER_SYMBOL];
     const hibernatable = stateManager.hibernatableDataOrError();
     const entry = this.#hwsMessageIndex.get(conn.id);
     if (!entry) {
@@ -765,9 +802,9 @@ var EngineActorDriver = class {
 
 // src/drivers/engine/config.ts
 
-var EngineConfigSchemaBase = _chunkRTSLQIZ5cjs.ClientConfigSchemaBase.extend({
+var EngineConfigSchemaBase = _chunkLULP6HM2cjs.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, () => ( _chunkWRYYREBNcjs.getRivetRunnerKey.call(void 0, )))),
+  runnerKey: _zod.z.string().optional().transform((val) => _nullishCoalesce(val, () => ( _chunkO433HWWGcjs.getRivetRunnerKey.call(void 0, )))),
   /** How many actors this runner can run. */
   totalSlots: _zod.z.number().default(1e5)
 });
@@ -779,7 +816,7 @@ var EngineConfigSchema = EngineConfigSchemaTransformed.default(
 );
 function transformEngineConfig(config, ctx) {
   return {
-    ..._chunkRTSLQIZ5cjs.transformClientConfig.call(void 0, config, ctx),
+    ..._chunkLULP6HM2cjs.transformClientConfig.call(void 0, config, ctx),
     runnerKey: config.runnerKey
   };
 }
@@ -790,8 +827,8 @@ function createEngineDriver() {
     name: "engine",
     displayName: "Engine",
     manager: (config) => {
-      const clientConfig = _chunkRTSLQIZ5cjs.convertRegistryConfigToClientConfig.call(void 0, config);
-      return new (0, _chunkRTSLQIZ5cjs.RemoteManagerDriver)(clientConfig);
+      const clientConfig = _chunkLULP6HM2cjs.convertRegistryConfigToClientConfig.call(void 0, config);
+      return new (0, _chunkLULP6HM2cjs.RemoteManagerDriver)(clientConfig);
     },
     actor: (config, managerDriver, inlineClient) => {
       return new EngineActorDriver(
@@ -819,15 +856,15 @@ var LegacyRunnerConfigSchemaUnmerged = _zod.z.object({
   /** @experimental */
   maxOutgoingMessageSize: _zod.z.number().optional().default(1048576),
   /** @experimental */
-  inspector: _chunk6TLJAB64cjs.InspectorConfigSchema,
+  inspector: _chunkIWXMFQDTcjs.InspectorConfigSchema,
   /** @experimental */
   disableDefaultServer: _zod.z.boolean().optional().default(false),
   /** @experimental */
   defaultServerPort: _zod.z.number().default(6420),
   /** @experimental */
-  runEngine: _zod.z.boolean().optional().default(() => _chunkWRYYREBNcjs.getRivetRunEngine.call(void 0, )),
+  runEngine: _zod.z.boolean().optional().default(() => _chunkO433HWWGcjs.getRivetRunEngine.call(void 0, )),
   /** @experimental */
-  runEngineVersion: _zod.z.string().optional().default(() => _nullishCoalesce(_chunkWRYYREBNcjs.getRivetRunEngineVersion.call(void 0, ), () => ( _chunkWRYYREBNcjs.VERSION))),
+  runEngineVersion: _zod.z.string().optional().default(() => _nullishCoalesce(_chunkO433HWWGcjs.getRivetRunEngineVersion.call(void 0, ), () => ( _chunkO433HWWGcjs.VERSION))),
   /** @experimental */
   overrideServerAddress: _zod.z.string().optional(),
   /** @experimental */
@@ -839,7 +876,7 @@ var LegacyRunnerConfigSchemaUnmerged = _zod.z.object({
    * serverlessly (by the Rivet Engine for example).
    */
   runnerKind: _zod.z.enum(["serverless", "normal"]).optional().default(
-    () => _chunkWRYYREBNcjs.getRivetRunnerKind.call(void 0, ) === "serverless" ? "serverless" : "normal"
+    () => _chunkO433HWWGcjs.getRivetRunnerKind.call(void 0, ) === "serverless" ? "serverless" : "normal"
   ),
   totalSlots: _zod.z.number().optional(),
   /**
@@ -861,7 +898,7 @@ var LegacyRunnerConfigSchemaUnmerged = _zod.z.object({
    * */
   logging: _zod.z.object({
     baseLogger: _zod.z.custom().optional(),
-    level: _chunkWRYYREBNcjs.LogLevelSchema.optional()
+    level: _chunkO433HWWGcjs.LogLevelSchema.optional()
   }).optional().default(() => ({})),
   /**
    * @experimental
@@ -889,7 +926,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 || _chunkWRYYREBNcjs.getRivetToken.call(void 0, ))
+  token: _zod.z.string().optional().transform((v) => v || _chunkO433HWWGcjs.getRivetToken.call(void 0, ))
 }).merge(EngineConfigSchemaBase);
 var LegacyRunnerConfigSchemaTransformed = LegacyRunnerConfigSchemaUnmerged.transform((config, ctx) => ({
   ...config,
@@ -913,38 +950,38 @@ function chooseDefaultDriver(config) {
     return config.driver;
   }
   if (config.endpoint || config.token) {
-    _chunk6TLJAB64cjs.loggerWithoutContext.call(void 0, ).debug({
+    _chunkIWXMFQDTcjs.loggerWithoutContext.call(void 0, ).debug({
       msg: "using rivet engine driver",
       endpoint: config.endpoint
     });
     return createEngineDriver();
   }
-  _chunk6TLJAB64cjs.loggerWithoutContext.call(void 0, ).debug({ msg: "using default file system driver" });
-  return _chunk7EGXCVJLcjs.createFileSystemOrMemoryDriver.call(void 0, true);
+  _chunkIWXMFQDTcjs.loggerWithoutContext.call(void 0, ).debug({ msg: "using default file system driver" });
+  return _chunkIRTVRBJAcjs.createFileSystemOrMemoryDriver.call(void 0, true);
 }
 
 // src/engine-process/log.ts
 function logger2() {
-  return _chunkWRYYREBNcjs.getLogger.call(void 0, "engine-process");
+  return _chunkO433HWWGcjs.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) {
-  _chunk7EGXCVJLcjs.importNodeDependencies.call(void 0, );
+  _chunkIRTVRBJAcjs.importNodeDependencies.call(void 0, );
   logger2().debug({
     msg: "ensuring engine process",
     version: options.version
   });
-  const path = _chunk7EGXCVJLcjs.getNodePath.call(void 0, );
-  const storageRoot = _chunk7EGXCVJLcjs.getStoragePath.call(void 0, );
+  const path = _chunkIRTVRBJAcjs.getNodePath.call(void 0, );
+  const storageRoot = _chunkIRTVRBJAcjs.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 _chunk7EGXCVJLcjs.ensureDirectoryExists.call(void 0, binDir);
-  await _chunk7EGXCVJLcjs.ensureDirectoryExists.call(void 0, varDir);
-  await _chunk7EGXCVJLcjs.ensureDirectoryExists.call(void 0, logsDir);
+  await _chunkIRTVRBJAcjs.ensureDirectoryExists.call(void 0, binDir);
+  await _chunkIRTVRBJAcjs.ensureDirectoryExists.call(void 0, varDir);
+  await _chunkIRTVRBJAcjs.ensureDirectoryExists.call(void 0, logsDir);
   if (await isEngineRunning()) {
     try {
       const health = await waitForEngineHealth();
@@ -969,7 +1006,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 = _chunk7EGXCVJLcjs.getNodeFsSync.call(void 0, );
+  const fsSync = _chunkIRTVRBJAcjs.getNodeFsSync.call(void 0, );
   const stdoutStream = fsSync.createWriteStream(stdoutLogPath, {
     flags: "a"
   });
@@ -981,7 +1018,7 @@ async function ensureEngineProcess(options) {
     stdout: stdoutLogPath,
     stderr: stderrLogPath
   });
-  const childProcess = _chunk7EGXCVJLcjs.getNodeChildProcess.call(void 0, );
+  const childProcess = _chunkIRTVRBJAcjs.getNodeChildProcess.call(void 0, );
   const child = childProcess.spawn(binaryPath, ["start"], {
     cwd: path.dirname(binaryPath),
     stdio: ["inherit", "pipe", "pipe"],
@@ -1058,7 +1095,7 @@ async function downloadEngineBinaryIfNeeded(binaryPath, version, varDir) {
       `failed to download rivet engine binary from ${downloadUrl}: ${response.status} ${response.statusText}`
     );
   }
-  const crypto2 = _chunk7EGXCVJLcjs.getNodeCrypto.call(void 0, );
+  const crypto2 = _chunkIRTVRBJAcjs.getNodeCrypto.call(void 0, );
   const tempPath = `${binaryPath}.${crypto2.randomUUID()}.tmp`;
   const startTime = Date.now();
   logger2().debug({
@@ -1073,14 +1110,14 @@ async function downloadEngineBinaryIfNeeded(binaryPath, version, varDir) {
     });
   }, 5e3);
   try {
-    const stream = _chunk7EGXCVJLcjs.getNodeStream.call(void 0, );
-    const fsSync = _chunk7EGXCVJLcjs.getNodeFsSync.call(void 0, );
+    const stream = _chunkIRTVRBJAcjs.getNodeStream.call(void 0, );
+    const fsSync = _chunkIRTVRBJAcjs.getNodeFsSync.call(void 0, );
     await stream.pipeline(
       response.body,
       fsSync.createWriteStream(tempPath)
     );
     clearTimeout(slowDownloadWarning);
-    const fs = _chunk7EGXCVJLcjs.getNodeFs.call(void 0, );
+    const fs = _chunkIRTVRBJAcjs.getNodeFs.call(void 0, );
     const stats = await fs.stat(tempPath);
     const downloadDuration = Date.now() - startTime;
     if (process.platform !== "win32") {
@@ -1109,7 +1146,7 @@ async function downloadEngineBinaryIfNeeded(binaryPath, version, varDir) {
       support: "https://rivet.dev/discord"
     });
     try {
-      const fs = _chunk7EGXCVJLcjs.getNodeFs.call(void 0, );
+      const fs = _chunkIRTVRBJAcjs.getNodeFs.call(void 0, );
       await fs.unlink(tempPath);
     } catch (unlinkError) {
     }
@@ -1151,12 +1188,12 @@ function resolveTargetTripletFor(platform, arch) {
   );
 }
 async function isEngineRunning() {
-  return await checkIfEngineAlreadyRunningOnPort(_chunk6TLJAB64cjs.ENGINE_PORT);
+  return await checkIfEngineAlreadyRunningOnPort(_chunkIWXMFQDTcjs.ENGINE_PORT);
 }
 async function checkIfEngineAlreadyRunningOnPort(port) {
   let response;
   try {
-    response = await fetch(`http://localhost:${port}/health`);
+    response = await fetch(`http://127.0.0.1:${port}/health`);
   } catch (err) {
     return false;
   }
@@ -1186,7 +1223,7 @@ async function checkIfEngineAlreadyRunningOnPort(port) {
 }
 async function fileExists(filePath) {
   try {
-    const fs = _chunk7EGXCVJLcjs.getNodeFs.call(void 0, );
+    const fs = _chunkIRTVRBJAcjs.getNodeFs.call(void 0, );
     await fs.access(filePath);
     return true;
   } catch (e) {
@@ -1200,7 +1237,7 @@ async function waitForEngineHealth() {
   logger2().debug({ msg: "waiting for engine health check" });
   for (let i = 0; i < maxRetries; i++) {
     try {
-      const response = await fetch(`${_chunk6TLJAB64cjs.ENGINE_ENDPOINT}/health`, {
+      const response = await fetch(`${_chunkIWXMFQDTcjs.ENGINE_ENDPOINT}/health`, {
         signal: AbortSignal.timeout(1e3)
       });
       if (response.ok) {
@@ -1235,7 +1272,7 @@ var _factory = require('hono/factory');
 function getInspectorUrl(config, managerPort) {
   if (!config.inspector.enabled) return void 0;
   const url = new URL("https://inspect.rivet.dev");
-  const endpoint = _nullishCoalesce(config.inspector.defaultEndpoint, () => ( (config.managerPort !== 6420 ? `http://localhost:${managerPort}` : void 0)));
+  const endpoint = _nullishCoalesce(config.inspector.defaultEndpoint, () => ( (config.managerPort !== 6420 ? `http://127.0.0.1:${managerPort}` : void 0)));
   if (endpoint) {
     url.searchParams.set("u", endpoint);
   }
@@ -1244,7 +1281,7 @@ function getInspectorUrl(config, managerPort) {
 
 // src/serverless/log.ts
 function logger3() {
-  return _chunkWRYYREBNcjs.getLogger.call(void 0, "serverless");
+  return _chunkO433HWWGcjs.getLogger.call(void 0, "serverless");
 }
 
 // src/serverless/configure.ts
@@ -1264,12 +1301,12 @@ async function configureServerlessRunner(config) {
     }
     const customConfig = config.serverless.configureRunnerPool;
     _invariant2.default.call(void 0, customConfig, "configureRunnerPool should exist");
-    const clientConfig = _chunkRTSLQIZ5cjs.convertRegistryConfigToClientConfig.call(void 0, config);
+    const clientConfig = _chunkLULP6HM2cjs.convertRegistryConfigToClientConfig.call(void 0, config);
     logger3().debug({
       msg: "fetching datacenters",
       endpoint: config.endpoint
     });
-    const dcsRes = await _chunkRTSLQIZ5cjs.getDatacenters.call(void 0, clientConfig);
+    const dcsRes = await _chunkLULP6HM2cjs.getDatacenters.call(void 0, clientConfig);
     const runnerName = _nullishCoalesce(customConfig.name, () => ( "default"));
     logger3().debug({
       msg: "configuring serverless runner",
@@ -1288,7 +1325,7 @@ async function configureServerlessRunner(config) {
       },
       metadata: _nullishCoalesce(customConfig.metadata, () => ( {}))
     };
-    await _chunkRTSLQIZ5cjs.updateRunnerConfig.call(void 0, clientConfig, runnerName, {
+    await _chunkLULP6HM2cjs.updateRunnerConfig.call(void 0, clientConfig, runnerName, {
       datacenters: Object.fromEntries(
         dcsRes.datacenters.map((dc) => [dc.name, serverlessConfig])
       )
@@ -1308,7 +1345,7 @@ async function configureServerlessRunner(config) {
 
 // src/registry/log.ts
 function logger4() {
-  return _chunkWRYYREBNcjs.getLogger.call(void 0, "registry");
+  return _chunkO433HWWGcjs.getLogger.call(void 0, "registry");
 }
 
 // src/registry/serve.ts
@@ -1323,7 +1360,7 @@ async function findFreePort(startPort = DEFAULT_PORT) {
   return _getport2.default.call(void 0, { port: portRange(startPort) });
 }
 async function crossPlatformServe(config, managerPort, app) {
-  const runtime = _chunkWRYYREBNcjs.detectRuntime.call(void 0, );
+  const runtime = _chunkO433HWWGcjs.detectRuntime.call(void 0, );
   logger4().debug({ msg: "detected runtime for serve", runtime });
   switch (runtime) {
     case "deno":
@@ -1348,7 +1385,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: _chunkWRYYREBNcjs.stringifyError.call(void 0, err)
+      error: _chunkO433HWWGcjs.stringifyError.call(void 0, err)
     });
     process.exit(1);
   }
@@ -1363,7 +1400,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: _chunkWRYYREBNcjs.stringifyError.call(void 0, err)
+      error: _chunkO433HWWGcjs.stringifyError.call(void 0, err)
     });
     process.exit(1);
   }
@@ -1390,7 +1427,7 @@ async function serveDeno(config, managerPort, app) {
   } catch (err) {
     logger4().error({
       msg: "failed to import hono/deno",
-      error: _chunkWRYYREBNcjs.stringifyError.call(void 0, err)
+      error: _chunkO433HWWGcjs.stringifyError.call(void 0, err)
     });
     process.exit(1);
   }
@@ -1411,7 +1448,7 @@ async function serveBun(config, managerPort, app) {
   } catch (err) {
     logger4().error({
       msg: "failed to import hono/bun",
-      error: _chunkWRYYREBNcjs.stringifyError.call(void 0, err)
+      error: _chunkO433HWWGcjs.stringifyError.call(void 0, err)
     });
     process.exit(1);
   }
@@ -1449,7 +1486,7 @@ var ServerlessStartHeadersSchema = _zod.z.object({
 
 // src/serverless/router.ts
 function buildServerlessRouter(driverConfig, config) {
-  return _chunk6TLJAB64cjs.createRouter.call(void 0, config.serverless.basePath, (router) => {
+  return _chunkIWXMFQDTcjs.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"
@@ -1478,7 +1515,7 @@ function buildServerlessRouter(driverConfig, config) {
         namespace
       });
       if (config.endpoint) {
-        if (endpoint !== config.endpoint) {
+        if (!endpointsMatch(endpoint, config.endpoint)) {
           throw new (0, _chunkSNAUKDDKcjs.EndpointMismatch)(config.endpoint, endpoint);
         }
         if (namespace !== config.namespace) {
@@ -1498,10 +1535,10 @@ function buildServerlessRouter(driverConfig, config) {
           runnerKey: void 0
         }
       };
-      const managerDriver = new (0, _chunkRTSLQIZ5cjs.RemoteManagerDriver)(
-        _chunkRTSLQIZ5cjs.convertRegistryConfigToClientConfig.call(void 0, newConfig)
+      const managerDriver = new (0, _chunkLULP6HM2cjs.RemoteManagerDriver)(
+        _chunkLULP6HM2cjs.convertRegistryConfigToClientConfig.call(void 0, newConfig)
       );
-      const client = _chunkRTSLQIZ5cjs.createClientWithDriver.call(void 0, managerDriver);
+      const client = _chunkLULP6HM2cjs.createClientWithDriver.call(void 0, managerDriver);
       const actorDriver = driverConfig.actor(
         newConfig,
         managerDriver,
@@ -1513,10 +1550,10 @@ function buildServerlessRouter(driverConfig, config) {
       );
       return await actorDriver.serverlessHandleStart(c);
     });
-    router.get("/health", (c) => _chunk6TLJAB64cjs.handleHealthRequest.call(void 0, c));
+    router.get("/health", (c) => _chunkIWXMFQDTcjs.handleHealthRequest.call(void 0, c));
     router.get(
       "/metadata",
-      (c) => _chunk6TLJAB64cjs.handleMetadataRequest.call(void 0, 
+      (c) => _chunkIWXMFQDTcjs.handleMetadataRequest.call(void 0, 
         c,
         config,
         { serverless: {} },
@@ -1527,6 +1564,44 @@ function buildServerlessRouter(driverConfig, config) {
     );
   });
 }
+function normalizeEndpointUrl(url) {
+  try {
+    const parsed = new URL(url);
+    const pathname = parsed.pathname === "/" ? "/" : parsed.pathname.replace(/\/+$/, "");
+    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);
+  if (normalizedA === null || normalizedB === null) {
+    return 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) {
@@ -1563,9 +1638,9 @@ var Runtime = class _Runtime {
     logger4().info("rivetkit starting");
     const config = registry.parseConfig();
     if ((_a = config.logging) == null ? void 0 : _a.baseLogger) {
-      _chunkWRYYREBNcjs.configureBaseLogger.call(void 0, config.logging.baseLogger);
+      _chunkO433HWWGcjs.configureBaseLogger.call(void 0, config.logging.baseLogger);
     } else {
-      _chunkWRYYREBNcjs.configureDefaultLogger.call(void 0, (_b = config.logging) == null ? void 0 : _b.level);
+      _chunkO433HWWGcjs.configureDefaultLogger.call(void 0, (_b = config.logging) == null ? void 0 : _b.level);
     }
     _invariant2.default.call(void 0, 
       !(config.serverless.spawnEngine && config.serveManager),
@@ -1575,7 +1650,7 @@ var Runtime = class _Runtime {
     const managerDriver = driver.manager(config);
     let managerPort;
     if (config.serverless.spawnEngine) {
-      managerPort = _chunk6TLJAB64cjs.ENGINE_PORT;
+      managerPort = _chunkIWXMFQDTcjs.ENGINE_PORT;
       logger4().debug({
         msg: "spawning engine",
         version: config.serverless.engineVersion
@@ -1587,7 +1662,7 @@ var Runtime = class _Runtime {
       let upgradeWebSocket;
       const getUpgradeWebSocket = () => upgradeWebSocket;
       managerDriver.setGetUpgradeWebSocket(getUpgradeWebSocket);
-      const { router: managerRouter } = _chunk6TLJAB64cjs.buildManagerRouter.call(void 0, 
+      const { router: managerRouter } = _chunkIWXMFQDTcjs.buildManagerRouter.call(void 0, 
         config,
         managerDriver,
         getUpgradeWebSocket
@@ -1639,7 +1714,7 @@ var Runtime = class _Runtime {
     this.#startKind = "runner";
     if (this.#config.runner && this.#driver.autoStartActorDriver) {
       logger4().debug("starting actor driver");
-      const inlineClient = _chunkRTSLQIZ5cjs.createClientWithDriver.call(void 0, 
+      const inlineClient = _chunkLULP6HM2cjs.createClientWithDriver.call(void 0, 
         this.#managerDriver
       );
       this.#driver.actor(this.#config, this.#managerDriver, inlineClient);
@@ -1651,7 +1726,7 @@ var Runtime = class _Runtime {
     const inspectorUrl = this.managerPort ? getInspectorUrl(this.#config, this.managerPort) : void 0;
     console.log();
     console.log(
-      `  RivetKit ${_chunkWRYYREBNcjs.package_default.version} (${this.#driver.displayName} - ${this.#startKind === "serverless" ? "Serverless" : "Runner"})`
+      `  RivetKit ${_chunkO433HWWGcjs.package_default.version} (${this.#driver.displayName} - ${this.#startKind === "serverless" ? "Serverless" : "Runner"})`
     );
     if (this.#config.namespace !== "default") {
       logLine("Namespace", this.#config.namespace);
@@ -1692,7 +1767,7 @@ var Registry = class {
     return this.#config;
   }
   parseConfig() {
-    return _chunk6TLJAB64cjs.RegistryConfigSchema.parse(this.#config);
+    return _chunkIWXMFQDTcjs.RegistryConfigSchema.parse(this.#config);
   }
   // Shared runtime instance
   #runtime;
@@ -1758,7 +1833,7 @@ var Registry = class {
         "autoConfigureServerless can only be configured when runnerKind is 'serverless'"
       );
     }
-    const isDevEnv = _chunkWRYYREBNcjs.isDev.call(void 0, );
+    const isDevEnv = _chunkO433HWWGcjs.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)
@@ -1771,7 +1846,7 @@ var Registry = class {
     }
   }
   #legacyStartServerless(config, _inputConfig) {
-    const client = _chunkRTSLQIZ5cjs.createClient.call(void 0, {
+    const client = _chunkLULP6HM2cjs.createClient.call(void 0, {
       endpoint: config.endpoint,
       token: config.token,
       namespace: config.namespace,
@@ -1784,7 +1859,7 @@ var Registry = class {
   }
   #legacyStartNormal(config) {
     this.#ensureRuntime().then((runtime) => runtime.startRunner());
-    const client = _chunkRTSLQIZ5cjs.createClient.call(void 0, {
+    const client = _chunkLULP6HM2cjs.createClient.call(void 0, {
       endpoint: config.endpoint,
       token: config.token,
       namespace: config.namespace,
@@ -1806,4 +1881,4 @@ function setup(input) {
 
 
 exports.actor = actor; exports.createEngineDriver = createEngineDriver; exports.Registry = Registry; exports.setup = setup;
-//# sourceMappingURL=chunk-OYJU4B2I.cjs.map
+//# sourceMappingURL=chunk-6WLJW57U.cjs.map