rivetkit 2.0.3 → 2.0.4-rc.1

package/dist/tsup/test/mod.js

@@ -1,21 +1,90 @@
 import {
-  getPort,
-  setupTest
-} from "../chunk-6PDXBYI5.js";
-import "../chunk-OV6AYD4S.js";
-import "../chunk-42I3OZ3Q.js";
-import "../chunk-UVUPOS46.js";
-import "../chunk-EGVZZFE2.js";
-import "../chunk-FLMTTN27.js";
-import "../chunk-PO4VLDWA.js";
-import "../chunk-KJCJLKRM.js";
-import "../chunk-VRRHBNJC.js";
-import "../chunk-4NSUQZ2H.js";
-import "../chunk-XFSS33EQ.js";
-import "../chunk-3H7O2A7I.js";
-import "../chunk-INGJP237.js";
+  createFileSystemOrMemoryDriver
+} from "../chunk-MXNPAB5W.js";
+import {
+  createClient
+} from "../chunk-K6DGYILQ.js";
+import "../chunk-JEAEA2PB.js";
+import {
+  buildManagerRouter
+} from "../chunk-HHXX2VRM.js";
+import "../chunk-LXUQ667X.js";
+import "../chunk-RTOCTWME.js";
+import {
+  getLogger
+} from "../chunk-325TLXJT.js";
+import "../chunk-7HTNH26M.js";
+import "../chunk-424PT5DM.js";
+
+// src/test/mod.ts
+import { serve as honoServe } from "@hono/node-server";
+import { createNodeWebSocket } from "@hono/node-ws";
+import invariant from "invariant";
+
+// src/test/log.ts
+function logger() {
+  return getLogger("test");
+}
+
+// src/test/mod.ts
+async function setupTest(c, registry) {
+  var _a;
+  registry.config.test = { ...registry.config.test, enabled: true };
+  const driver = createFileSystemOrMemoryDriver(
+    true,
+    { path: `/tmp/rivetkit-test-${crypto.randomUUID()}` }
+  );
+  let upgradeWebSocket;
+  registry.config.driver = driver;
+  registry.config.inspector = {
+    enabled: true,
+    token: () => "token"
+  };
+  const parsedConfig = registry.parseConfig();
+  const managerDriver = (_a = driver.manager) == null ? void 0 : _a.call(driver, parsedConfig);
+  invariant(managerDriver, "missing manager driver");
+  const getUpgradeWebSocket = () => upgradeWebSocket;
+  managerDriver.setGetUpgradeWebSocket(getUpgradeWebSocket);
+  const { router } = buildManagerRouter(
+    parsedConfig,
+    managerDriver,
+    getUpgradeWebSocket
+  );
+  const nodeWebSocket = createNodeWebSocket({ app: router });
+  upgradeWebSocket = nodeWebSocket.upgradeWebSocket;
+  const server = honoServe({
+    fetch: router.fetch,
+    hostname: "127.0.0.1",
+    port: 0
+  });
+  if (!server.listening) {
+    await new Promise((resolve) => {
+      server.once("listening", () => resolve());
+    });
+  }
+  invariant(
+    nodeWebSocket.injectWebSocket !== void 0,
+    "should have injectWebSocket"
+  );
+  nodeWebSocket.injectWebSocket(server);
+  const address = server.address();
+  invariant(address && typeof address !== "string", "missing server address");
+  const port = address.port;
+  const endpoint = `http://127.0.0.1:${port}`;
+  logger().info({ msg: "test server listening", port });
+  c.onTestFinished(async () => {
+    await new Promise((resolve) => server.close(() => resolve(void 0)));
+  });
+  const client = createClient({
+    endpoint,
+    namespace: "default",
+    runnerName: "default",
+    disableMetadataLookup: true
+  });
+  c.onTestFinished(async () => await client.dispose());
+  return { client };
+}
 export {
-  getPort,
   setupTest
 };
 //# sourceMappingURL=mod.js.map

package/dist/tsup/test/mod.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"sources":["../../../src/test/mod.ts","../../../src/test/log.ts"],"sourcesContent":["import { serve as honoServe } from \"@hono/node-server\";\nimport { createNodeWebSocket } from \"@hono/node-ws\";\nimport invariant from \"invariant\";\nimport { type TestContext, vi } from \"vitest\";\nimport { ClientConfigSchema } from \"@/client/config\";\nimport { type Client, createClient } from \"@/client/mod\";\nimport { createFileSystemOrMemoryDriver } from \"@/drivers/file-system/mod\";\nimport { createClientWithDriver, type Registry } from \"@/mod\";\nimport { RegistryConfig, RegistryConfigSchema } from \"@/registry/config\";\nimport { buildManagerRouter } from \"@/manager/router\";\nimport { logger } from \"./log\";\n\nexport interface SetupTestResult<A extends Registry<any>> {\n\tclient: Client<A>;\n}\n\n// Must use `TestContext` since global hooks do not work when running concurrently\nexport async function setupTest<A extends Registry<any>>(\n\tc: TestContext,\n\tregistry: A,\n): Promise<SetupTestResult<A>> {\n\t// Force enable test mode\n\tregistry.config.test = { ...registry.config.test, enabled: true };\n\n\t// Create driver\n\tconst driver = createFileSystemOrMemoryDriver(\n\t\ttrue,\n\t\t{ path: `/tmp/rivetkit-test-${crypto.randomUUID()}` },\n\t);\n\n\t// Build driver config\n\t// biome-ignore lint/style/useConst: Assigned later\n\tlet upgradeWebSocket: any;\n\tregistry.config.driver = driver;\n\tregistry.config.inspector = {\n\t\tenabled: true,\n\t\ttoken: () => \"token\",\n\t};\n\n\t// Create router\n\tconst parsedConfig = registry.parseConfig();\n\tconst managerDriver = driver.manager?.(parsedConfig);\n\tinvariant(managerDriver, \"missing manager driver\");\n\tconst getUpgradeWebSocket = () => upgradeWebSocket;\n\tmanagerDriver.setGetUpgradeWebSocket(getUpgradeWebSocket);\n\t// const internalClient = createClientWithDriver(\n\t// \tmanagerDriver,\n\t// \tClientConfigSchema.parse({}),\n\t// );\n\tconst { router } = buildManagerRouter(\n\t\tparsedConfig,\n\t\tmanagerDriver,\n\t\tgetUpgradeWebSocket,\n\t);\n\n\t// Inject WebSocket\n\tconst nodeWebSocket = createNodeWebSocket({ app: router });\n\tupgradeWebSocket = nodeWebSocket.upgradeWebSocket;\n\n\t// TODO: I think this whole function is fucked, we should probably switch to calling registry.serve() directly\n\t// Start server\n\tconst server = honoServe({\n\t\tfetch: router.fetch,\n\t\thostname: \"127.0.0.1\",\n\t\tport: 0,\n\t});\n\tif (!server.listening) {\n\t\tawait new Promise<void>((resolve) => {\n\t\t\tserver.once(\"listening\", () => resolve());\n\t\t});\n\t}\n\tinvariant(\n\t\tnodeWebSocket.injectWebSocket !== undefined,\n\t\t\"should have injectWebSocket\",\n\t);\n\tnodeWebSocket.injectWebSocket(server);\n\tconst address = server.address();\n\tinvariant(address && typeof address !== \"string\", \"missing server address\");\n\tconst port = address.port;\n\tconst endpoint = `http://127.0.0.1:${port}`;\n\n\tlogger().info({ msg: \"test server listening\", port });\n\n\t// Cleanup on test finish\n\tc.onTestFinished(async () => {\n\t\tawait new Promise((resolve) => server.close(() => resolve(undefined)));\n\t});\n\n\t// Create client\n\tconst client = createClient<A>({\n\t\tendpoint,\n\t\tnamespace: \"default\",\n\t\trunnerName: \"default\",\n\t\tdisableMetadataLookup: true,\n\t});\n\tc.onTestFinished(async () => await client.dispose());\n\n\treturn { client };\n}\n","import { getLogger } from \"@/common/log\";\n\nexport function logger() {\n\treturn getLogger(\"test\");\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA,SAAS,SAAS,iBAAiB;AACnC,SAAS,2BAA2B;AACpC,OAAO,eAAe;;;ACAf,SAAS,SAAS;AACxB,SAAO,UAAU,MAAM;AACxB;;;ADaA,eAAsB,UACrB,GACA,UAC8B;AApB/B;AAsBC,WAAS,OAAO,OAAO,EAAE,GAAG,SAAS,OAAO,MAAM,SAAS,KAAK;AAGhE,QAAM,SAAS;AAAA,IACd;AAAA,IACA,EAAE,MAAM,sBAAsB,OAAO,WAAW,CAAC,GAAG;AAAA,EACrD;AAIA,MAAI;AACJ,WAAS,OAAO,SAAS;AACzB,WAAS,OAAO,YAAY;AAAA,IAC3B,SAAS;AAAA,IACT,OAAO,MAAM;AAAA,EACd;AAGA,QAAM,eAAe,SAAS,YAAY;AAC1C,QAAM,iBAAgB,YAAO,YAAP,gCAAiB;AACvC,YAAU,eAAe,wBAAwB;AACjD,QAAM,sBAAsB,MAAM;AAClC,gBAAc,uBAAuB,mBAAmB;AAKxD,QAAM,EAAE,OAAO,IAAI;AAAA,IAClB;AAAA,IACA;AAAA,IACA;AAAA,EACD;AAGA,QAAM,gBAAgB,oBAAoB,EAAE,KAAK,OAAO,CAAC;AACzD,qBAAmB,cAAc;AAIjC,QAAM,SAAS,UAAU;AAAA,IACxB,OAAO,OAAO;AAAA,IACd,UAAU;AAAA,IACV,MAAM;AAAA,EACP,CAAC;AACD,MAAI,CAAC,OAAO,WAAW;AACtB,UAAM,IAAI,QAAc,CAAC,YAAY;AACpC,aAAO,KAAK,aAAa,MAAM,QAAQ,CAAC;AAAA,IACzC,CAAC;AAAA,EACF;AACA;AAAA,IACC,cAAc,oBAAoB;AAAA,IAClC;AAAA,EACD;AACA,gBAAc,gBAAgB,MAAM;AACpC,QAAM,UAAU,OAAO,QAAQ;AAC/B,YAAU,WAAW,OAAO,YAAY,UAAU,wBAAwB;AAC1E,QAAM,OAAO,QAAQ;AACrB,QAAM,WAAW,oBAAoB,IAAI;AAEzC,SAAO,EAAE,KAAK,EAAE,KAAK,yBAAyB,KAAK,CAAC;AAGpD,IAAE,eAAe,YAAY;AAC5B,UAAM,IAAI,QAAQ,CAAC,YAAY,OAAO,MAAM,MAAM,QAAQ,MAAS,CAAC,CAAC;AAAA,EACtE,CAAC;AAGD,QAAM,SAAS,aAAgB;AAAA,IAC9B;AAAA,IACA,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,uBAAuB;AAAA,EACxB,CAAC;AACD,IAAE,eAAe,YAAY,MAAM,OAAO,QAAQ,CAAC;AAEnD,SAAO,EAAE,OAAO;AACjB;","names":[]}

package/dist/tsup/{utils-CT0cv4jd.d.ts → utils-fwx3o3K9.d.cts}

@@ -6,6 +6,7 @@ interface DeconstructedError {
     __type: "ActorError";
     statusCode: ContentfulStatusCode;
     public: boolean;
+    group: string;
     code: string;
     message: string;
     metadata?: unknown;

package/dist/tsup/{utils-CT0cv4jd.d.cts → utils-fwx3o3K9.d.ts}

@@ -6,6 +6,7 @@ interface DeconstructedError {
     __type: "ActorError";
     statusCode: ContentfulStatusCode;
     public: boolean;
+    group: string;
     code: string;
     message: string;
     metadata?: unknown;

package/dist/tsup/utils.cjs

@@ -9,8 +9,6 @@
 
 
 
-var _chunkOGAPU3UGcjs = require('./chunk-OGAPU3UG.cjs');
-require('./chunk-GIR3AFFI.cjs');
 
 
 
@@ -19,8 +17,27 @@ require('./chunk-GIR3AFFI.cjs');
 
 
 
+var _chunkPQZHDKRWcjs = require('./chunk-PQZHDKRW.cjs');
+require('./chunk-L47L3ZWJ.cjs');
+require('./chunk-HDQ2JUQT.cjs');
 
 
 
-exports.SinglePromiseQueue = _chunkOGAPU3UGcjs.SinglePromiseQueue; exports.VERSION = _chunkOGAPU3UGcjs.VERSION; exports.assertUnreachable = _chunkOGAPU3UGcjs.assertUnreachable; exports.bufferToArrayBuffer = _chunkOGAPU3UGcjs.bufferToArrayBuffer; exports.dbg = _chunkOGAPU3UGcjs.dbg; exports.getEnvUniversal = _chunkOGAPU3UGcjs.getEnvUniversal; exports.httpUserAgent = _chunkOGAPU3UGcjs.httpUserAgent; exports.setLongTimeout = _chunkOGAPU3UGcjs.setLongTimeout; exports.stringifyError = _chunkOGAPU3UGcjs.stringifyError; exports.toUint8Array = _chunkOGAPU3UGcjs.toUint8Array;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.EXTRA_ERROR_LOG = _chunkPQZHDKRWcjs.EXTRA_ERROR_LOG; exports.SinglePromiseQueue = _chunkPQZHDKRWcjs.SinglePromiseQueue; exports.VERSION = _chunkPQZHDKRWcjs.VERSION; exports.arrayBuffersEqual = _chunkPQZHDKRWcjs.arrayBuffersEqual; exports.assertUnreachable = _chunkPQZHDKRWcjs.assertUnreachable; exports.bufferToArrayBuffer = _chunkPQZHDKRWcjs.bufferToArrayBuffer; exports.combineUrlPath = _chunkPQZHDKRWcjs.combineUrlPath; exports.dbg = _chunkPQZHDKRWcjs.dbg; exports.detectRuntime = _chunkPQZHDKRWcjs.detectRuntime; exports.getEnvUniversal = _chunkPQZHDKRWcjs.getEnvUniversal; exports.httpUserAgent = _chunkPQZHDKRWcjs.httpUserAgent; exports.interval = _chunkPQZHDKRWcjs.interval; exports.joinSignals = _chunkPQZHDKRWcjs.joinSignals; exports.promiseWithResolvers = _chunkPQZHDKRWcjs.promiseWithResolvers; exports.setLongTimeout = _chunkPQZHDKRWcjs.setLongTimeout; exports.sleep = _chunkPQZHDKRWcjs.sleep; exports.stringifyError = _chunkPQZHDKRWcjs.stringifyError; exports.toUint8Array = _chunkPQZHDKRWcjs.toUint8Array;
 //# sourceMappingURL=utils.cjs.map

package/dist/tsup/utils.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/nathan/rivetkit/packages/rivetkit/dist/tsup/utils.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,6jBAAC","file":"/Users/nathan/rivetkit/packages/rivetkit/dist/tsup/utils.cjs"}
+{"version":3,"sources":["/home/runner/work/rivet/rivet/rivetkit-typescript/packages/rivetkit/dist/tsup/utils.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,mgCAAC","file":"/home/runner/work/rivet/rivet/rivetkit-typescript/packages/rivetkit/dist/tsup/utils.cjs"}

package/dist/tsup/utils.d.cts

@@ -1,11 +1,56 @@
-export { a as assertUnreachable, s as stringifyError } from './utils-CT0cv4jd.cjs';
+export { a as assertUnreachable, s as stringifyError } from './utils-fwx3o3K9.cjs';
 import { Context, Handler } from 'hono';
 import 'hono/utils/http-status';
 
+/**
+ * Joins multiple abort signals into one.
+ *
+ * The returned signal aborts when the first input signal aborts.
+ * Uses `AbortSignal.any(...)` when available, with a runtime fallback.
+ *
+ * @experimental
+ */
+declare function joinSignals(...signals: Array<AbortSignal | undefined | null>): AbortSignal;
+/**
+ * Returns a promise that resolves after the given number of milliseconds.
+ *
+ * @experimental
+ */
+declare function sleep(ms: number): Promise<void>;
+/**
+ * Creates a fixed-rate interval tick function that can be awaited in a loop.
+ *
+ * @example
+ * const tick = interval(100);
+ * while (!c.aborted) {
+ *   await tick();
+ *   if (c.aborted) break;
+ *   // ... game logic
+ * }
+ *
+ * @experimental
+ */
+declare function interval(ms: number): () => Promise<void>;
 declare const VERSION: string;
+/**
+ * Builds the HTTP user agent used by this library.
+ *
+ * @experimental
+ */
 declare function httpUserAgent(): string;
 type UpgradeWebSocket = (createEvents: (c: Context) => any) => Handler;
+type GetUpgradeWebSocket = () => UpgradeWebSocket;
+/**
+ * Reads an environment variable from Deno or Node runtimes.
+ *
+ * @experimental
+ */
 declare function getEnvUniversal(key: string): string | undefined;
+/**
+ * Traces a debug value and returns it.
+ *
+ * @experimental
+ */
 declare function dbg<T>(x: T): T;
 /**
  * Converts various ArrayBuffer-like types to Uint8Array.
@@ -13,11 +58,30 @@ declare function dbg<T>(x: T): T;
  *
  * @param data - The ArrayBuffer or ArrayBufferView to convert
  * @returns A Uint8Array view of the data
+ *
+ * @experimental
  */
 declare function toUint8Array(data: ArrayBuffer | ArrayBufferView): Uint8Array;
 type LongTimeoutHandle = {
     abort: () => void;
 };
+/**
+ * Polyfill for Promise.withResolvers().
+ *
+ * This is specifically for Cloudflare Workers. Their implementation of Promise.withResolvers does not work correctly.
+ *
+ * @experimental
+ */
+declare function promiseWithResolvers<T>(onReject: (reason?: any) => void): {
+    promise: Promise<T>;
+    resolve: (value: T | PromiseLike<T>) => void;
+    reject: (reason?: any) => void;
+};
+/**
+ * Sets a timeout that supports delays larger than the JavaScript timer limit.
+ *
+ * @experimental
+ */
 declare function setLongTimeout(listener: () => void, after: number): LongTimeoutHandle;
 /**
  * A tiny utility that coalesces/enqueues async operations so only the latest
@@ -31,6 +95,54 @@ declare class SinglePromiseQueue {
     /** Queue the next operation and return a promise that resolves when it flushes. */
     enqueue(op: () => Promise<void>): Promise<void>;
 }
+/**
+ * Converts a Buffer or Uint8Array into an ArrayBuffer view.
+ *
+ * @experimental
+ */
 declare function bufferToArrayBuffer(buf: Buffer | Uint8Array): ArrayBuffer;
+/**
+ * Properly combines a base URL endpoint with a path, preserving any base path in the endpoint.
+ *
+ * @example
+ * combineUrlPath("http://localhost:8787/rivet", "/actors/action")
+ * // Returns: "http://localhost:8787/rivet/actors/action"
+ *
+ * @example
+ * combineUrlPath("http://localhost:8787/rivet", "/actors?type=foo", { namespace: "test" })
+ * // Returns: "http://localhost:8787/rivet/actors?type=foo&namespace=test"
+ *
+ * @param endpoint The base URL endpoint that may contain a path component
+ * @param path The path to append to the endpoint (may include query parameters)
+ * @param queryParams Optional additional query parameters to append
+ * @returns The properly combined URL string
+ *
+ * @experimental
+ */
+declare function combineUrlPath(endpoint: string, path: string, queryParams?: Record<string, string | undefined>): string;
+/**
+ * Compares two ArrayBuffer values by byte content.
+ *
+ * @experimental
+ */
+declare function arrayBuffersEqual(buf1: ArrayBuffer, buf2: ArrayBuffer): boolean;
+declare const EXTRA_ERROR_LOG: {
+    issues: string;
+    support: string;
+    version: string;
+};
+type Runtime = "deno" | "bun" | "node";
+/**
+ * Detects the current JavaScript runtime from the user agent.
+ *
+ * @experimental
+ */
+declare function detectRuntime(): Runtime;
+type DeepReadonly<T> = {
+    readonly [K in keyof T]: T[K] extends object ? DeepReadonly<T[K]> : T[K];
+};
+type DeepMutable<T> = {
+    -readonly [K in keyof T]: T[K] extends object ? DeepMutable<T[K]> : T[K];
+};
 
-export { type LongTimeoutHandle, SinglePromiseQueue, type UpgradeWebSocket, VERSION, bufferToArrayBuffer, dbg, getEnvUniversal, httpUserAgent, setLongTimeout, toUint8Array };
+export { type DeepMutable, type DeepReadonly, EXTRA_ERROR_LOG, type GetUpgradeWebSocket, type LongTimeoutHandle, type Runtime, SinglePromiseQueue, type UpgradeWebSocket, VERSION, arrayBuffersEqual, bufferToArrayBuffer, combineUrlPath, dbg, detectRuntime, getEnvUniversal, httpUserAgent, interval, joinSignals, promiseWithResolvers, setLongTimeout, sleep, toUint8Array };

package/dist/tsup/utils.d.ts

@@ -1,11 +1,56 @@
-export { a as assertUnreachable, s as stringifyError } from './utils-CT0cv4jd.js';
+export { a as assertUnreachable, s as stringifyError } from './utils-fwx3o3K9.js';
 import { Context, Handler } from 'hono';
 import 'hono/utils/http-status';
 
+/**
+ * Joins multiple abort signals into one.
+ *
+ * The returned signal aborts when the first input signal aborts.
+ * Uses `AbortSignal.any(...)` when available, with a runtime fallback.
+ *
+ * @experimental
+ */
+declare function joinSignals(...signals: Array<AbortSignal | undefined | null>): AbortSignal;
+/**
+ * Returns a promise that resolves after the given number of milliseconds.
+ *
+ * @experimental
+ */
+declare function sleep(ms: number): Promise<void>;
+/**
+ * Creates a fixed-rate interval tick function that can be awaited in a loop.
+ *
+ * @example
+ * const tick = interval(100);
+ * while (!c.aborted) {
+ *   await tick();
+ *   if (c.aborted) break;
+ *   // ... game logic
+ * }
+ *
+ * @experimental
+ */
+declare function interval(ms: number): () => Promise<void>;
 declare const VERSION: string;
+/**
+ * Builds the HTTP user agent used by this library.
+ *
+ * @experimental
+ */
 declare function httpUserAgent(): string;
 type UpgradeWebSocket = (createEvents: (c: Context) => any) => Handler;
+type GetUpgradeWebSocket = () => UpgradeWebSocket;
+/**
+ * Reads an environment variable from Deno or Node runtimes.
+ *
+ * @experimental
+ */
 declare function getEnvUniversal(key: string): string | undefined;
+/**
+ * Traces a debug value and returns it.
+ *
+ * @experimental
+ */
 declare function dbg<T>(x: T): T;
 /**
  * Converts various ArrayBuffer-like types to Uint8Array.
@@ -13,11 +58,30 @@ declare function dbg<T>(x: T): T;
  *
  * @param data - The ArrayBuffer or ArrayBufferView to convert
  * @returns A Uint8Array view of the data
+ *
+ * @experimental
  */
 declare function toUint8Array(data: ArrayBuffer | ArrayBufferView): Uint8Array;
 type LongTimeoutHandle = {
     abort: () => void;
 };
+/**
+ * Polyfill for Promise.withResolvers().
+ *
+ * This is specifically for Cloudflare Workers. Their implementation of Promise.withResolvers does not work correctly.
+ *
+ * @experimental
+ */
+declare function promiseWithResolvers<T>(onReject: (reason?: any) => void): {
+    promise: Promise<T>;
+    resolve: (value: T | PromiseLike<T>) => void;
+    reject: (reason?: any) => void;
+};
+/**
+ * Sets a timeout that supports delays larger than the JavaScript timer limit.
+ *
+ * @experimental
+ */
 declare function setLongTimeout(listener: () => void, after: number): LongTimeoutHandle;
 /**
  * A tiny utility that coalesces/enqueues async operations so only the latest
@@ -31,6 +95,54 @@ declare class SinglePromiseQueue {
     /** Queue the next operation and return a promise that resolves when it flushes. */
     enqueue(op: () => Promise<void>): Promise<void>;
 }
+/**
+ * Converts a Buffer or Uint8Array into an ArrayBuffer view.
+ *
+ * @experimental
+ */
 declare function bufferToArrayBuffer(buf: Buffer | Uint8Array): ArrayBuffer;
+/**
+ * Properly combines a base URL endpoint with a path, preserving any base path in the endpoint.
+ *
+ * @example
+ * combineUrlPath("http://localhost:8787/rivet", "/actors/action")
+ * // Returns: "http://localhost:8787/rivet/actors/action"
+ *
+ * @example
+ * combineUrlPath("http://localhost:8787/rivet", "/actors?type=foo", { namespace: "test" })
+ * // Returns: "http://localhost:8787/rivet/actors?type=foo&namespace=test"
+ *
+ * @param endpoint The base URL endpoint that may contain a path component
+ * @param path The path to append to the endpoint (may include query parameters)
+ * @param queryParams Optional additional query parameters to append
+ * @returns The properly combined URL string
+ *
+ * @experimental
+ */
+declare function combineUrlPath(endpoint: string, path: string, queryParams?: Record<string, string | undefined>): string;
+/**
+ * Compares two ArrayBuffer values by byte content.
+ *
+ * @experimental
+ */
+declare function arrayBuffersEqual(buf1: ArrayBuffer, buf2: ArrayBuffer): boolean;
+declare const EXTRA_ERROR_LOG: {
+    issues: string;
+    support: string;
+    version: string;
+};
+type Runtime = "deno" | "bun" | "node";
+/**
+ * Detects the current JavaScript runtime from the user agent.
+ *
+ * @experimental
+ */
+declare function detectRuntime(): Runtime;
+type DeepReadonly<T> = {
+    readonly [K in keyof T]: T[K] extends object ? DeepReadonly<T[K]> : T[K];
+};
+type DeepMutable<T> = {
+    -readonly [K in keyof T]: T[K] extends object ? DeepMutable<T[K]> : T[K];
+};
 
-export { type LongTimeoutHandle, SinglePromiseQueue, type UpgradeWebSocket, VERSION, bufferToArrayBuffer, dbg, getEnvUniversal, httpUserAgent, setLongTimeout, toUint8Array };
+export { type DeepMutable, type DeepReadonly, EXTRA_ERROR_LOG, type GetUpgradeWebSocket, type LongTimeoutHandle, type Runtime, SinglePromiseQueue, type UpgradeWebSocket, VERSION, arrayBuffersEqual, bufferToArrayBuffer, combineUrlPath, dbg, detectRuntime, getEnvUniversal, httpUserAgent, interval, joinSignals, promiseWithResolvers, setLongTimeout, sleep, toUint8Array };

package/dist/tsup/utils.js

@@ -1,25 +1,42 @@
 import {
+  EXTRA_ERROR_LOG,
   SinglePromiseQueue,
   VERSION,
+  arrayBuffersEqual,
   assertUnreachable,
   bufferToArrayBuffer,
+  combineUrlPath,
   dbg,
+  detectRuntime,
   getEnvUniversal,
   httpUserAgent,
+  interval,
+  joinSignals,
+  promiseWithResolvers,
   setLongTimeout,
+  sleep,
   stringifyError,
   toUint8Array
-} from "./chunk-3H7O2A7I.js";
-import "./chunk-INGJP237.js";
+} from "./chunk-325TLXJT.js";
+import "./chunk-7HTNH26M.js";
+import "./chunk-424PT5DM.js";
 export {
+  EXTRA_ERROR_LOG,
   SinglePromiseQueue,
   VERSION,
+  arrayBuffersEqual,
   assertUnreachable,
   bufferToArrayBuffer,
+  combineUrlPath,
   dbg,
+  detectRuntime,
   getEnvUniversal,
   httpUserAgent,
+  interval,
+  joinSignals,
+  promiseWithResolvers,
   setLongTimeout,
+  sleep,
   stringifyError,
   toUint8Array
 };