@rivetkit/rivetkit-napi 2.3.0-rc.8 → 2.3.0

package/index.d.ts

@@ -47,6 +47,26 @@ export interface JsQueueSendResult {
 export interface JsActionDefinition {
   name: string
 }
+/**
+ * One entry in the actor's `inspector.tabs[]` declaration. Either a
+ * custom-tab descriptor (id + label + source dir) or a built-in modifier
+ * (id + hidden=true). Validation already happened on the TS side; the
+ * runtime just splits the discriminator.
+ */
+export interface JsInspectorTabEntry {
+  id: string
+  /** Required for custom entries; omitted for HideBuiltin. */
+  label?: string
+  /** Required for custom entries — absolute path to the source directory. */
+  source?: string
+  /**
+   * Optional icon id for custom entries. Dashboard maps strings to
+   * glyphs; unknown ids fall back to a generic icon.
+   */
+  icon?: string
+  /** Set to true for HideBuiltin entries. */
+  hidden?: boolean
+}
 export interface JsActorConfig {
   name?: string
   icon?: string
@@ -78,6 +98,7 @@ export interface JsActorConfig {
   preloadMaxWorkflowBytes?: number
   preloadMaxConnectionsBytes?: number
   actions?: Array<JsActionDefinition>
+  inspectorTabs?: Array<JsInspectorTabEntry>
 }
 export interface JsBindParam {
   kind: string
@@ -155,6 +176,8 @@ export interface JsServeConfig {
   namespace: string
   poolName: string
   engineBinaryPath?: string
+  engineHost?: string
+  enginePort?: number
   handleInspectorHttpInRuntime?: boolean
   serverlessBasePath?: string
   serverlessPackageVersion: string
@@ -174,24 +197,16 @@ export interface JsServerlessResponseHead {
   status: number
   headers: Record<string, string>
 }
-export interface JsRegistryDiagnostics {
-  mode: string
-  envoyActiveActorCount?: number
+export interface JsRegistryRouteResponse {
+  status: number
+  headers: Record<string, string>
+  body: Buffer
 }
 export interface JsServerlessStreamError {
   group: string
   code: string
   message: string
 }
-export declare function jsSetEventloopLagQuantile(quantile: string, seconds: number): void
-export declare function jsSetEventloopUtilization(value: number): void
-export declare function jsSetEventloopHeartbeatTsMs(epochMs: number): void
-export declare function jsAddProcessCpuSeconds(mode: string, seconds: number): void
-export declare function jsSetProcessResidentMemoryBytes(bytes: number): void
-export declare function jsSetHeapBytes(state: string, bytes: number): void
-export declare function jsObserveGcDuration(kind: string, seconds: number): void
-export declare function jsSetActiveHandles(count: number): void
-export declare function jsSetActiveRequests(count: number): void
 /** Options for KV list operations. */
 export interface JsKvListOptions {
   reverse?: boolean
@@ -250,6 +265,7 @@ export declare class ActorContext {
   broadcast(name: string, args: Buffer): void
   waitUntil(promise: Promise<any>): void
   waitForTrackedShutdownWork(): Promise<boolean>
+  waitForTrackedShutdownWorkUnbounded(): Promise<void>
   registerTask(promise: Promise<any>): void
   runtimeState(): object
   clearRuntimeState(): void
@@ -297,7 +313,7 @@ export declare class Queue {
   next(options?: JsQueueNextOptions | undefined | null, signal?: CancellationToken | undefined | null): Promise<QueueMessage | null>
   nextBatch(options?: JsQueueNextBatchOptions | undefined | null, signal?: CancellationToken | undefined | null): Promise<Array<QueueMessage>>
   waitForNames(names: Array<string>, options?: JsQueueWaitOptions | undefined | null, signal?: CancellationToken | undefined | null): Promise<QueueMessage>
-  waitForNamesAvailable(names: Array<string>, options?: JsQueueWaitOptions | undefined | null): Promise<void>
+  waitForNamesAvailable(names: Array<string>, options?: JsQueueWaitOptions | undefined | null, signal?: CancellationToken | undefined | null): Promise<void>
   enqueueAndWait(name: string, body: Buffer, options?: JsQueueEnqueueAndWaitOptions | undefined | null, signal?: CancellationToken | undefined | null): Promise<Buffer | null>
   tryNext(options?: JsQueueTryNextOptions | undefined | null): QueueMessage | null
   tryNextBatch(options?: JsQueueTryNextBatchOptions | undefined | null): Array<QueueMessage>
@@ -325,7 +341,9 @@ export declare class CoreRegistry {
    */
   shutdown(): Promise<void>
   actorStopThresholdMs(): Promise<number | null>
-  diagnostics(): Promise<JsRegistryDiagnostics>
+  health(): Promise<JsRegistryRouteResponse>
+  metadata(): JsRegistryRouteResponse
+  metrics(): JsRegistryRouteResponse
   handleServerlessRequest(req: JsServerlessRequest, onStreamEvent: (...args: any[]) => any, cancelToken: CancellationToken, config: JsServeConfig): Promise<JsServerlessResponseHead>
 }
 export declare class Schedule {

package/index.js

@@ -310,7 +310,7 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { ActorContext, NapiActorFactory, CancellationToken, ConnHandle, JsNativeDatabase, Kv, Queue, QueueMessage, CoreRegistry, jsSetEventloopLagQuantile, jsSetEventloopUtilization, jsSetEventloopHeartbeatTsMs, jsAddProcessCpuSeconds, jsSetProcessResidentMemoryBytes, jsSetHeapBytes, jsObserveGcDuration, jsSetActiveHandles, jsSetActiveRequests, Schedule, WebSocket } = nativeBinding
+const { ActorContext, NapiActorFactory, CancellationToken, ConnHandle, JsNativeDatabase, Kv, Queue, QueueMessage, CoreRegistry, Schedule, WebSocket } = nativeBinding
 
 module.exports.ActorContext = ActorContext
 module.exports.NapiActorFactory = NapiActorFactory
@@ -321,14 +321,5 @@ module.exports.Kv = Kv
 module.exports.Queue = Queue
 module.exports.QueueMessage = QueueMessage
 module.exports.CoreRegistry = CoreRegistry
-module.exports.jsSetEventloopLagQuantile = jsSetEventloopLagQuantile
-module.exports.jsSetEventloopUtilization = jsSetEventloopUtilization
-module.exports.jsSetEventloopHeartbeatTsMs = jsSetEventloopHeartbeatTsMs
-module.exports.jsAddProcessCpuSeconds = jsAddProcessCpuSeconds
-module.exports.jsSetProcessResidentMemoryBytes = jsSetProcessResidentMemoryBytes
-module.exports.jsSetHeapBytes = jsSetHeapBytes
-module.exports.jsObserveGcDuration = jsObserveGcDuration
-module.exports.jsSetActiveHandles = jsSetActiveHandles
-module.exports.jsSetActiveRequests = jsSetActiveRequests
 module.exports.Schedule = Schedule
 module.exports.WebSocket = WebSocket

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rivetkit/rivetkit-napi",
-	"version": "2.3.0-rc.8",
+	"version": "2.3.0",
 	"description": "Native N-API addon for RivetKit providing envoy client and SQLite access",
 	"license": "Apache-2.0",
 	"main": "index.js",
@@ -43,15 +43,15 @@
 	},
 	"dependencies": {
 		"@napi-rs/cli": "^2.18.4",
-		"@rivetkit/engine-envoy-protocol": "2.3.0-rc.8"
+		"@rivetkit/engine-envoy-protocol": "2.3.0"
 	},
 	"optionalDependencies": {
-		"@rivetkit/rivetkit-napi-darwin-arm64": "2.3.0-rc.8",
-		"@rivetkit/rivetkit-napi-darwin-x64": "2.3.0-rc.8",
-		"@rivetkit/rivetkit-napi-linux-arm64-gnu": "2.3.0-rc.8",
-		"@rivetkit/rivetkit-napi-linux-arm64-musl": "2.3.0-rc.8",
-		"@rivetkit/rivetkit-napi-linux-x64-gnu": "2.3.0-rc.8",
-		"@rivetkit/rivetkit-napi-linux-x64-musl": "2.3.0-rc.8",
-		"@rivetkit/rivetkit-napi-win32-x64-msvc": "2.3.0-rc.8"
+		"@rivetkit/rivetkit-napi-darwin-arm64": "2.3.0",
+		"@rivetkit/rivetkit-napi-darwin-x64": "2.3.0",
+		"@rivetkit/rivetkit-napi-linux-arm64-gnu": "2.3.0",
+		"@rivetkit/rivetkit-napi-linux-arm64-musl": "2.3.0",
+		"@rivetkit/rivetkit-napi-linux-x64-gnu": "2.3.0",
+		"@rivetkit/rivetkit-napi-linux-x64-musl": "2.3.0",
+		"@rivetkit/rivetkit-napi-win32-x64-msvc": "2.3.0"
 	}
 }

package/scripts/build.mjs

@@ -16,6 +16,14 @@ if (process.env.SKIP_NAPI_BUILD === "1") {
 	process.exit(0);
 }
 
+// The per-actor inspector UI (frontend/dist/inspector-ui, embedded into
+// rivetkit-core by its build.rs) must be built before this napi build runs.
+// It is NOT built here: rivetkit-core's embed needs rivetkit/inspector-tab,
+// which is downstream of this package in the build graph, so building it from
+// the napi build would invert the dependency order. CI builds it via
+// `turbo build:inspector-ui` in docker/build/*.Dockerfile before `napi build`;
+// for local builds run `pnpm -F @rivetkit/engine-frontend build:inspector-ui`
+// (or `turbo build:inspector-ui`) first.
 const cmd = ["build", "--platform", ...extraFlags];
 console.log(`[rivetkit-napi/build] running: napi ${cmd.join(" ")}`);
 execFileSync("napi", cmd, { stdio: "inherit" });