@rivetkit/rivetkit-napi 0.0.0-0-0-0-preview-guard-stops.9d82529

package/index.d.ts

@@ -0,0 +1,487 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+export interface JsActorKeySegment {
+  kind: string
+  stringValue?: string
+  numberValue?: number
+}
+export interface JsHttpRequest {
+  method: string
+  uri: string
+  headers?: Record<string, string>
+  body?: Buffer
+}
+export interface StateDeltaConnHibernationEntry {
+  connId: string
+  bytes: Buffer
+}
+export interface StateDeltaPayload {
+  state?: Buffer
+  connHibernation: Array<StateDeltaConnHibernationEntry>
+  connHibernationRemoved: Array<string>
+}
+export interface WorkflowKvWritePayload {
+  key: Buffer
+  value: Buffer
+}
+export interface JsRequestSaveOpts {
+  immediate?: boolean
+  maxWaitMs?: number
+}
+export declare function decodeInspectorRequest(bytes: Buffer, advertisedVersion: number): Buffer
+export declare function encodeInspectorResponse(bytes: Buffer, targetVersion: number): Buffer
+export interface JsInspectorSnapshot {
+  stateRevision: number
+  connectionsRevision: number
+  queueRevision: number
+  activeConnections: number
+  queueSize: number
+  connectedClients: number
+}
+export interface JsActorRuntimeSocketEndpointInfo {
+  path: string
+}
+export interface JsQueueSendResult {
+  status: string
+  response?: Buffer
+}
+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
+}
+/**
+ * Experimental SQLite profiling configuration. This entire configuration
+ * surface is subject to change without notice.
+ */
+export interface JsSqliteProfilingConfig {
+  enabled?: boolean
+  maxTrackedStatementFingerprints?: number
+  maxTrackedTransactionFingerprints?: number
+  maxPrometheusSeries?: number
+  maxStatementsPerTransactionTrace?: number
+  maxGetPagesRequestsPerTrace?: number
+  maxTransactionNameBytes?: number
+  slowOperationThresholdMs?: number
+  baselineSampleRate?: number
+  maxDiagnosticEventsPerMinute?: number
+  diagnosticEventQueueCapacity?: number
+}
+export interface JsActorConfig {
+  name?: string
+  icon?: string
+  hasDatabase?: boolean
+  remoteSqlite?: boolean
+  sqliteProfiling?: JsSqliteProfilingConfig
+  enableActorRuntimeSocket?: boolean
+  hasState?: boolean
+  canHibernateWebsocket?: boolean
+  stateSaveIntervalMs?: number
+  createStateTimeoutMs?: number
+  onCreateTimeoutMs?: number
+  createVarsTimeoutMs?: number
+  createConnStateTimeoutMs?: number
+  onBeforeConnectTimeoutMs?: number
+  onConnectTimeoutMs?: number
+  onMigrateTimeoutMs?: number
+  onWakeTimeoutMs?: number
+  onBeforeActorStartTimeoutMs?: number
+  actionTimeoutMs?: number
+  onRequestTimeoutMs?: number
+  sleepTimeoutMs?: number
+  noSleep?: boolean
+  sleepGracePeriodMs?: number
+  connectionLivenessTimeoutMs?: number
+  connectionLivenessIntervalMs?: number
+  maxQueueSize?: number
+  maxSchedules?: number
+  maxQueueMessageSize?: number
+  maxIncomingMessageSize?: number
+  maxOutgoingMessageSize?: number
+  actions?: Array<JsActionDefinition>
+  inspectorTabs?: Array<JsInspectorTabEntry>
+}
+export interface JsBindParam {
+  kind: string
+  intValue?: number
+  floatValue?: number
+  textValue?: string
+  blobValue?: Buffer
+}
+export interface ExecuteResult {
+  changes: number
+}
+export interface QueryResult {
+  columns: Array<string>
+  rows: Array<Array<any>>
+}
+export interface NativeExecuteResult {
+  columns: Array<string>
+  rows: Array<Array<any>>
+  changes: number
+  lastInsertRowId?: number
+}
+export interface JsSqliteBatchStatement {
+  sql: string
+  params?: Array<JsBindParam>
+}
+export interface JsSqliteVfsMetrics {
+  requestBuildNs: number
+  serializeNs: number
+  transportNs: number
+  stateUpdateNs: number
+  totalNs: number
+  commitCount: number
+  pageCacheEntries: number
+  pageCacheWeightedSize: number
+  pageCacheCapacityPages: number
+  writeBufferDirtyPages: number
+  dbSizePages: number
+}
+export interface JsHttpResponse {
+  status?: number
+  headers?: Record<string, string>
+  body?: Buffer
+  stream?: boolean
+}
+export interface JsQueueNextOptions {
+  names?: Array<string>
+  timeoutMs?: number
+  completable?: boolean
+}
+export interface JsQueueNextBatchOptions {
+  names?: Array<string>
+  count?: number
+  timeoutMs?: number
+  completable?: boolean
+}
+export interface JsQueueWaitOptions {
+  timeoutMs?: number
+  completable?: boolean
+}
+export interface JsQueueEnqueueAndWaitOptions {
+  timeoutMs?: number
+}
+export interface JsQueueTryNextOptions {
+  names?: Array<string>
+  completable?: boolean
+}
+export interface JsQueueTryNextBatchOptions {
+  names?: Array<string>
+  count?: number
+  completable?: boolean
+}
+export interface JsQueueInspectMessage {
+  /**
+   * Queue message id. Stored as the raw u64 reinterpreted as i64 so JS
+   * sees a plain number; ids are monotonic and fit comfortably in i64.
+   */
+  id: number
+  name: string
+  createdAtMs: number
+}
+export interface JsServeConfig {
+  version: number
+  endpoint: string
+  token?: string
+  namespace: string
+  poolName: string
+  engineBinaryPath?: string
+  startServices?: boolean
+  servicesBinaryPath?: string
+  engineHost?: string
+  enginePort?: number
+  handleInspectorHttpInRuntime?: boolean
+  serverlessBasePath?: string
+  serverlessPackageVersion: string
+  serverlessClientEndpoint?: string
+  serverlessClientNamespace?: string
+  serverlessClientToken?: string
+  serverlessValidateEndpoint: boolean
+  serverlessMaxStartPayloadBytes: number
+}
+export interface JsListenerConfig {
+  /** Host to bind. Defaults to `0.0.0.0` when not provided. */
+  host?: string
+  port: number
+  /**
+   * Optional static file root mounted as a fallback below the framework
+   * routes.
+   */
+  publicDir?: string
+}
+export interface JsServerlessRequest {
+  method: string
+  url: string
+  headers: Record<string, string>
+  body: Buffer
+}
+export interface JsServerlessResponseHead {
+  status: number
+  headers: Record<string, string>
+}
+export interface JsApplicationResponse {
+  status: number
+  headers: Record<string, string>
+  body?: Buffer
+  stream?: boolean
+}
+export interface JsRegistryRouteResponse {
+  status: number
+  headers: Record<string, string>
+  body: Buffer
+}
+export interface JsServerlessStreamError {
+  group: string
+  code: string
+  message: string
+}
+export interface JsScheduledEventInfo {
+  id: string
+  action: string
+  args: Buffer
+  runAt: number
+}
+export interface JsCronJobInfo {
+  name: string
+  kind: string
+  action: string
+  args: Buffer
+  nextRunAt: number
+  lastRunAt?: number
+  expression?: string
+  timezone?: string
+  intervalMs?: number
+  maxHistory: number
+}
+export interface JsScheduleErrorInfo {
+  group: string
+  code: string
+  message: string
+  metadata?: any
+}
+export interface JsCronFire {
+  action: string
+  scheduledAt: number
+  firedAt: number
+  finishedAt?: number
+  result: string
+  error?: JsScheduleErrorInfo
+}
+/** Options for KV list operations. */
+export interface JsKvListOptions {
+  reverse?: boolean
+  limit?: number
+}
+/** A key-value entry returned from KV list operations. */
+export interface JsKvEntry {
+  key: Buffer
+  value: Buffer
+}
+/** N-API wrapper around `rivetkit-core::ActorContext`. */
+export declare class ActorContext {
+  state(): Buffer
+  beginOnStateChange(): void
+  endOnStateChange(): void
+  kv(): Kv
+  sql(): JsNativeDatabase
+  provisionActorRuntimeSocket(): Promise<JsActorRuntimeSocketEndpointInfo>
+  schedule(): Schedule
+  queue(): Queue
+  setAlarm(timestampMs?: number | undefined | null): void
+  requestSave(opts?: JsRequestSaveOpts | undefined | null): void
+  requestSaveAndWait(opts?: JsRequestSaveOpts | undefined | null): Promise<void>
+  decodeInspectorRequest(bytes: Buffer, advertisedVersion: number): Buffer
+  encodeInspectorResponse(bytes: Buffer, targetVersion: number): Buffer
+  inspectorSnapshot(): JsInspectorSnapshot
+  verifyInspectorAuth(bearerToken?: string | undefined | null): Promise<void>
+  queueHibernationRemoval(connId: string): void
+  hasPendingHibernationChanges(): boolean
+  takePendingHibernationChanges(): Array<string>
+  dirtyHibernatableConns(): Array<ConnHandle>
+  saveState(payload: StateDeltaPayload): Promise<void>
+  beginStateTransaction(timeoutMs?: number | undefined | null): Promise<JsActorStateTransaction>
+  saveStateAndWorkflowBatch(writes: Array<WorkflowKvWritePayload>): Promise<void>
+  actorId(): string
+  name(): string
+  key(): Array<JsActorKeySegment>
+  region(): string
+  sleep(): void
+  destroy(): void
+  destroyRequested(): boolean
+  waitForDestroyCompletion(): Promise<void>
+  setPreventSleep(preventSleep: boolean): void
+  preventSleep(): boolean
+  aborted(): boolean
+  runHandlerActive(): boolean
+  restartRunHandler(): void
+  setRunWakeAt(timestampMs?: number | undefined | null): Promise<void>
+  beginKeepAwake(): number
+  endKeepAwake(regionId: number): void
+  keepAwake(promise: Promise<any>): void
+  beginWebsocketCallback(): number
+  endWebsocketCallback(regionId: number): void
+  abortSignal(): AbortSignal
+  conns(): Array<ConnHandle>
+  connectConn(params: Buffer, request?: JsHttpRequest | undefined | null): Promise<ConnHandle>
+  disconnectConn(id: string): Promise<void>
+  disconnectConns(predicate: (...args: any[]) => any): Promise<void>
+  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
+}
+export declare class NapiActorFactory {
+  constructor(callbacks: object, config?: JsActorConfig | undefined | null)
+}
+export declare class CancellationToken {
+  constructor()
+  aborted(): boolean
+  cancel(): void
+  onCancelled(callback: (...args: any[]) => any): void
+}
+export declare class ConnHandle {
+  id(): string
+  params(): Buffer
+  state(): Buffer
+  setState(state: Buffer): void
+  isHibernatable(): boolean
+  send(name: string, args: Buffer): void
+  disconnect(reason?: string | undefined | null): Promise<void>
+}
+export declare class JsNativeDatabase {
+  takeLastKvError(): string | null
+  metrics(): JsSqliteVfsMetrics | null
+  run(sql: string, params?: Array<JsBindParam> | undefined | null): Promise<ExecuteResult>
+  query(sql: string, params?: Array<JsBindParam> | undefined | null): Promise<QueryResult>
+  execute(sql: string, params?: Array<JsBindParam> | undefined | null): Promise<NativeExecuteResult>
+  executeBatch(statements: Array<JsSqliteBatchStatement>): Promise<Array<NativeExecuteResult>>
+  exec(sql: string): Promise<QueryResult>
+  close(): Promise<void>
+  beginTransaction(timeoutMs?: number | undefined | null, name?: string | undefined | null): Promise<JsSqliteTransaction>
+}
+export declare class JsSqliteTransaction {
+  execute(sql: string, params?: Array<JsBindParam> | undefined | null): Promise<NativeExecuteResult>
+  exec(sql: string): Promise<QueryResult>
+  commit(): Promise<void>
+  rollback(): Promise<void>
+}
+export declare class JsActorStateTransaction {
+  execute(sql: string, params?: Array<JsBindParam> | undefined | null): Promise<NativeExecuteResult>
+  commit(payload: StateDeltaPayload): Promise<void>
+  rollback(): Promise<void>
+}
+/** JavaScript-facing writer for a streaming actor HTTP response. */
+export declare class HttpResponseBodyStream {
+  cancelled(): Promise<void>
+  write(chunk: Buffer): Promise<void>
+  end(): Promise<void>
+  error(message: string): Promise<void>
+}
+/** JavaScript-facing reader for a streaming actor HTTP request. */
+export declare class HttpRequestBodyStream {
+  read(): Promise<Buffer | null>
+  cancel(): Promise<void>
+}
+export declare class Kv {
+  get(key: Buffer): Promise<Buffer | null>
+  put(key: Buffer, value: Buffer): Promise<void>
+  delete(key: Buffer): Promise<void>
+  deleteRange(start: Buffer, end: Buffer): Promise<void>
+  listPrefix(prefix: Buffer, options?: JsKvListOptions | undefined | null): Promise<Array<JsKvEntry>>
+  listRange(start: Buffer, end: Buffer, options?: JsKvListOptions | undefined | null): Promise<Array<JsKvEntry>>
+  batchGet(keys: Array<Buffer>): Promise<Array<Buffer | undefined | null>>
+  batchPut(entries: Array<JsKvEntry>): Promise<void>
+  batchDelete(keys: Array<Buffer>): Promise<void>
+}
+export declare class Queue {
+  send(name: string, body: Buffer): Promise<QueueMessage>
+  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, signal?: CancellationToken | undefined | null): Promise<void>
+  completePersisted(messageId: bigint, expectedName: string, response?: Buffer | undefined | null): Promise<boolean>
+  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>
+  maxSize(): number
+  reset(): Promise<void>
+  inspectMessages(): Promise<Array<JsQueueInspectMessage>>
+}
+export declare class QueueMessage {
+  id(): bigint
+  name(): string
+  body(): Buffer
+  createdAt(): number
+  isCompletable(): boolean
+  complete(response?: Buffer | undefined | null): Promise<void>
+}
+export declare class CoreRegistry {
+  constructor()
+  register(name: string, factory: NapiActorFactory): void
+  serve(config: JsServeConfig): Promise<void>
+  /**
+   * Wait until the serverful envoy has completed its Engine registration.
+   *
+   * Readiness is the envoy client's `ToEnvoyInit` signal, not HTTP health or
+   * merely constructing the envoy handle.
+   */
+  waitReady(): Promise<void>
+  /**
+   * Trip the shutdown token and tear down any live serverless runtime.
+   *
+   * Idempotent. Safe to call when neither mode has been activated.
+   * Does not block on the `serve()` future; TS awaits that promise
+   * separately to avoid re-entrancy.
+   */
+  shutdown(): Promise<void>
+  actorStopThresholdMs(): Promise<number | null>
+  health(): Promise<JsRegistryRouteResponse>
+  metadata(): JsRegistryRouteResponse
+  metrics(): JsRegistryRouteResponse
+  serveApplicationListener(listener: JsListenerConfig, application: (...args: any[]) => any, config: JsServeConfig): Promise<void>
+  serveListener(listener: JsListenerConfig, config: JsServeConfig, application?: (...args: any[]) => any | undefined | null): Promise<void>
+  handleServerlessRequest(req: JsServerlessRequest, onStreamEvent: (...args: any[]) => any, cancelToken: CancellationToken, config: JsServeConfig): Promise<JsServerlessResponseHead>
+}
+export declare class Schedule {
+  after(durationMs: number, actionName: string, args: Buffer): Promise<string>
+  at(timestampMs: number, actionName: string, args: Buffer): Promise<string>
+  cancel(id: string): Promise<boolean>
+  get(id: string): Promise<JsScheduledEventInfo | null>
+  list(): Promise<Array<JsScheduledEventInfo>>
+  cronSet(name: string, expression: string, timezone: string | undefined | null, actionName: string, args: Buffer, maxHistory?: number | undefined | null): Promise<void>
+  cronEvery(name: string, intervalMs: number, actionName: string, args: Buffer, maxHistory?: number | undefined | null): Promise<void>
+  cronGet(name: string): Promise<JsCronJobInfo | null>
+  cronList(): Promise<Array<JsCronJobInfo>>
+  cronDelete(name: string): Promise<boolean>
+  cronHistory(name: string, limit?: number | undefined | null): Promise<Array<JsCronFire>>
+}
+export declare class WebSocket {
+  send(data: Buffer, binary: boolean): void
+  close(code?: number | undefined | null, reason?: string | undefined | null): Promise<void>
+  setEventCallback(callback: (...args: any[]) => any): void
+}

package/index.js

@@ -0,0 +1,331 @@
+/* tslint:disable */
+/* eslint-disable */
+/* prettier-ignore */
+
+/* auto-generated by NAPI-RS */
+
+const { existsSync, readFileSync } = require('fs')
+const { join } = require('path')
+
+const { platform, arch } = process
+
+let nativeBinding = null
+let localFileExisted = false
+let loadError = null
+
+function isMusl() {
+  // For Node 10
+  if (!process.report || typeof process.report.getReport !== 'function') {
+    try {
+      const lddPath = require('child_process').execSync('which ldd').toString().trim()
+      return readFileSync(lddPath, 'utf8').includes('musl')
+    } catch (e) {
+      return true
+    }
+  } else {
+    const { glibcVersionRuntime } = process.report.getReport().header
+    return !glibcVersionRuntime
+  }
+}
+
+switch (platform) {
+  case 'android':
+    switch (arch) {
+      case 'arm64':
+        localFileExisted = existsSync(join(__dirname, 'rivetkit-napi.android-arm64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./rivetkit-napi.android-arm64.node')
+          } else {
+            nativeBinding = require('@rivetkit/rivetkit-napi-android-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm':
+        localFileExisted = existsSync(join(__dirname, 'rivetkit-napi.android-arm-eabi.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./rivetkit-napi.android-arm-eabi.node')
+          } else {
+            nativeBinding = require('@rivetkit/rivetkit-napi-android-arm-eabi')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Android ${arch}`)
+    }
+    break
+  case 'win32':
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(
+          join(__dirname, 'rivetkit-napi.win32-x64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./rivetkit-napi.win32-x64-msvc.node')
+          } else {
+            nativeBinding = require('@rivetkit/rivetkit-napi-win32-x64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'ia32':
+        localFileExisted = existsSync(
+          join(__dirname, 'rivetkit-napi.win32-ia32-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./rivetkit-napi.win32-ia32-msvc.node')
+          } else {
+            nativeBinding = require('@rivetkit/rivetkit-napi-win32-ia32-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'rivetkit-napi.win32-arm64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./rivetkit-napi.win32-arm64-msvc.node')
+          } else {
+            nativeBinding = require('@rivetkit/rivetkit-napi-win32-arm64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Windows: ${arch}`)
+    }
+    break
+  case 'darwin':
+    localFileExisted = existsSync(join(__dirname, 'rivetkit-napi.darwin-universal.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./rivetkit-napi.darwin-universal.node')
+      } else {
+        nativeBinding = require('@rivetkit/rivetkit-napi-darwin-universal')
+      }
+      break
+    } catch {}
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(join(__dirname, 'rivetkit-napi.darwin-x64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./rivetkit-napi.darwin-x64.node')
+          } else {
+            nativeBinding = require('@rivetkit/rivetkit-napi-darwin-x64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'rivetkit-napi.darwin-arm64.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./rivetkit-napi.darwin-arm64.node')
+          } else {
+            nativeBinding = require('@rivetkit/rivetkit-napi-darwin-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on macOS: ${arch}`)
+    }
+    break
+  case 'freebsd':
+    if (arch !== 'x64') {
+      throw new Error(`Unsupported architecture on FreeBSD: ${arch}`)
+    }
+    localFileExisted = existsSync(join(__dirname, 'rivetkit-napi.freebsd-x64.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./rivetkit-napi.freebsd-x64.node')
+      } else {
+        nativeBinding = require('@rivetkit/rivetkit-napi-freebsd-x64')
+      }
+    } catch (e) {
+      loadError = e
+    }
+    break
+  case 'linux':
+    switch (arch) {
+      case 'x64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'rivetkit-napi.linux-x64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./rivetkit-napi.linux-x64-musl.node')
+            } else {
+              nativeBinding = require('@rivetkit/rivetkit-napi-linux-x64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'rivetkit-napi.linux-x64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./rivetkit-napi.linux-x64-gnu.node')
+            } else {
+              nativeBinding = require('@rivetkit/rivetkit-napi-linux-x64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'rivetkit-napi.linux-arm64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./rivetkit-napi.linux-arm64-musl.node')
+            } else {
+              nativeBinding = require('@rivetkit/rivetkit-napi-linux-arm64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'rivetkit-napi.linux-arm64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./rivetkit-napi.linux-arm64-gnu.node')
+            } else {
+              nativeBinding = require('@rivetkit/rivetkit-napi-linux-arm64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'rivetkit-napi.linux-arm-musleabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./rivetkit-napi.linux-arm-musleabihf.node')
+            } else {
+              nativeBinding = require('@rivetkit/rivetkit-napi-linux-arm-musleabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'rivetkit-napi.linux-arm-gnueabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./rivetkit-napi.linux-arm-gnueabihf.node')
+            } else {
+              nativeBinding = require('@rivetkit/rivetkit-napi-linux-arm-gnueabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'riscv64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'rivetkit-napi.linux-riscv64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./rivetkit-napi.linux-riscv64-musl.node')
+            } else {
+              nativeBinding = require('@rivetkit/rivetkit-napi-linux-riscv64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'rivetkit-napi.linux-riscv64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./rivetkit-napi.linux-riscv64-gnu.node')
+            } else {
+              nativeBinding = require('@rivetkit/rivetkit-napi-linux-riscv64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 's390x':
+        localFileExisted = existsSync(
+          join(__dirname, 'rivetkit-napi.linux-s390x-gnu.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./rivetkit-napi.linux-s390x-gnu.node')
+          } else {
+            nativeBinding = require('@rivetkit/rivetkit-napi-linux-s390x-gnu')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Linux: ${arch}`)
+    }
+    break
+  default:
+    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`)
+}
+
+if (!nativeBinding) {
+  if (loadError) {
+    throw loadError
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+const { ActorContext, decodeInspectorRequest, encodeInspectorResponse, NapiActorFactory, CancellationToken, ConnHandle, JsNativeDatabase, JsSqliteTransaction, JsActorStateTransaction, HttpResponseBodyStream, HttpRequestBodyStream, Kv, Queue, QueueMessage, CoreRegistry, Schedule, WebSocket } = nativeBinding
+
+module.exports.ActorContext = ActorContext
+module.exports.decodeInspectorRequest = decodeInspectorRequest
+module.exports.encodeInspectorResponse = encodeInspectorResponse
+module.exports.NapiActorFactory = NapiActorFactory
+module.exports.CancellationToken = CancellationToken
+module.exports.ConnHandle = ConnHandle
+module.exports.JsNativeDatabase = JsNativeDatabase
+module.exports.JsSqliteTransaction = JsSqliteTransaction
+module.exports.JsActorStateTransaction = JsActorStateTransaction
+module.exports.HttpResponseBodyStream = HttpResponseBodyStream
+module.exports.HttpRequestBodyStream = HttpRequestBodyStream
+module.exports.Kv = Kv
+module.exports.Queue = Queue
+module.exports.QueueMessage = QueueMessage
+module.exports.CoreRegistry = CoreRegistry
+module.exports.Schedule = Schedule
+module.exports.WebSocket = WebSocket

package/package.json

@@ -0,0 +1,62 @@
+{
+	"name": "@rivetkit/rivetkit-napi",
+	"version": "0.0.0-0-0-0-preview-guard-stops.9d82529",
+	"description": "Native N-API addon for RivetKit providing envoy client and SQLite access",
+	"license": "Apache-2.0",
+	"main": "index.js",
+	"types": "index.d.ts",
+	"exports": {
+		".": {
+			"types": "./index.d.ts",
+			"default": "./index.js"
+		}
+	},
+	"engines": {
+		"node": ">= 20.0.0"
+	},
+	"napi": {
+		"name": "rivetkit-napi",
+		"triples": {
+			"defaults": false,
+			"additional": [
+				"x86_64-unknown-linux-gnu",
+				"aarch64-unknown-linux-gnu",
+				"x86_64-unknown-linux-musl",
+				"aarch64-unknown-linux-musl",
+				"x86_64-apple-darwin",
+				"aarch64-apple-darwin",
+				"x86_64-pc-windows-msvc"
+			]
+		}
+	},
+	"files": [
+		"index.js",
+		"index.d.ts",
+		"package.json",
+		"scripts/build.mjs"
+	],
+	"scripts": {
+		"build": "node scripts/build.mjs",
+		"build:release": "node scripts/build.mjs --release",
+		"build:force": "node scripts/build.mjs --force",
+		"build:force:release": "node scripts/build.mjs --force --release",
+		"build:embed": "node scripts/build.mjs"
+	},
+	"dependencies": {
+		"@napi-rs/cli": "^2.18.4",
+		"@rivetkit/engine-envoy-protocol": "0.0.0-0-0-0-preview-guard-stops.9d82529"
+	},
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/rivet-dev/actors.git",
+		"directory": "rivetkit-typescript/packages/rivetkit-napi"
+	},
+	"optionalDependencies": {
+		"@rivetkit/rivetkit-napi-darwin-arm64": "0.0.0-0-0-0-preview-guard-stops.9d82529",
+		"@rivetkit/rivetkit-napi-darwin-x64": "0.0.0-0-0-0-preview-guard-stops.9d82529",
+		"@rivetkit/rivetkit-napi-linux-arm64-gnu": "0.0.0-0-0-0-preview-guard-stops.9d82529",
+		"@rivetkit/rivetkit-napi-linux-arm64-musl": "0.0.0-0-0-0-preview-guard-stops.9d82529",
+		"@rivetkit/rivetkit-napi-linux-x64-gnu": "0.0.0-0-0-0-preview-guard-stops.9d82529",
+		"@rivetkit/rivetkit-napi-linux-x64-musl": "0.0.0-0-0-0-preview-guard-stops.9d82529"
+	}
+}

package/scripts/build.mjs

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+/**
+ * Build wrapper for rivetkit-napi.
+ */
+import { execFileSync } from "node:child_process";
+
+const args = process.argv.slice(2);
+const extraFlags = args.includes("--release") ? ["--release"] : [];
+
+// Explicit skip for environments that don't need the native binary (e.g.
+// Docker engine-frontend build which only consumes TypeScript types).
+if (process.env.SKIP_NAPI_BUILD === "1") {
+	console.log(
+		"[rivetkit-napi/build] SKIP_NAPI_BUILD=1 — skipping napi build",
+	);
+	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" });