@rivetkit/rivetkit-napi 0.0.0-pr.4701.a818b77

package/index.d.ts

@@ -0,0 +1,266 @@
+/* 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 JsRequestSaveOpts {
+  immediate?: boolean
+  maxWaitMs?: number
+}
+export interface JsInspectorSnapshot {
+  stateRevision: number
+  connectionsRevision: number
+  queueRevision: number
+  activeConnections: number
+  queueSize: number
+  connectedClients: number
+}
+export interface JsHttpResponse {
+  status?: number
+  headers?: Record<string, string>
+  body?: Buffer
+}
+export interface JsQueueSendResult {
+  status: string
+  response?: Buffer
+}
+export interface JsActorConfig {
+  name?: string
+  icon?: string
+  canHibernateWebsocket?: boolean
+  stateSaveIntervalMs?: number
+  createStateTimeoutMs?: number
+  onCreateTimeoutMs?: number
+  createVarsTimeoutMs?: number
+  createConnStateTimeoutMs?: number
+  onBeforeConnectTimeoutMs?: number
+  onConnectTimeoutMs?: number
+  onMigrateTimeoutMs?: number
+  onWakeTimeoutMs?: number
+  onBeforeActorStartTimeoutMs?: number
+  onDestroyTimeoutMs?: number
+  actionTimeoutMs?: number
+  onRequestTimeoutMs?: number
+  sleepTimeoutMs?: number
+  noSleep?: boolean
+  sleepGracePeriodMs?: number
+  connectionLivenessTimeoutMs?: number
+  connectionLivenessIntervalMs?: number
+  maxQueueSize?: number
+  maxQueueMessageSize?: number
+  maxIncomingMessageSize?: number
+  maxOutgoingMessageSize?: number
+  preloadMaxWorkflowBytes?: number
+  preloadMaxConnectionsBytes?: number
+}
+export declare function pollCancelToken(id: bigint): boolean
+export declare function registerNativeCancelToken(): bigint
+export declare function cancelNativeCancelToken(id: bigint): void
+export declare function dropNativeCancelToken(id: bigint): void
+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 JsSqliteVfsMetrics {
+  requestBuildNs: number
+  serializeNs: number
+  transportNs: number
+  stateUpdateNs: number
+  totalNs: number
+  commitCount: number
+}
+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 JsServeConfig {
+  version: number
+  endpoint: string
+  token?: string
+  namespace: string
+  poolName: string
+  engineBinaryPath?: string
+  handleInspectorHttpInRuntime?: boolean
+}
+/** 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 {
+  constructor(actorId: string, name: string, region: string)
+  state(): Buffer
+  beginOnStateChange(): void
+  endOnStateChange(): void
+  kv(): Kv
+  sql(): JsNativeDatabase
+  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>
+  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
+  markReady(): void
+  markStarted(): void
+  isReady(): boolean
+  isStarted(): boolean
+  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>): Promise<void>
+  registerTask(promise: Promise<any>): 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
+  getSqliteVfsMetrics(): JsSqliteVfsMetrics | null
+  run(sql: string, params?: Array<JsBindParam> | undefined | null): Promise<ExecuteResult>
+  query(sql: string, params?: Array<JsBindParam> | undefined | null): Promise<QueryResult>
+  exec(sql: string): Promise<QueryResult>
+  close(): 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, cancelTokenId?: bigint | undefined | null): Promise<QueueMessage>
+  waitForNamesAvailable(names: Array<string>, options?: JsQueueWaitOptions | 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>
+}
+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>
+}
+export declare class Schedule {
+  after(durationMs: number, actionName: string, args: Buffer): void
+  at(timestampMs: number, actionName: string, args: Buffer): void
+}
+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,329 @@
+/* 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, NapiActorFactory, pollCancelToken, registerNativeCancelToken, cancelNativeCancelToken, dropNativeCancelToken, CancellationToken, ConnHandle, JsNativeDatabase, Kv, Queue, QueueMessage, CoreRegistry, Schedule, WebSocket } = nativeBinding
+
+module.exports.ActorContext = ActorContext
+module.exports.NapiActorFactory = NapiActorFactory
+module.exports.pollCancelToken = pollCancelToken
+module.exports.registerNativeCancelToken = registerNativeCancelToken
+module.exports.cancelNativeCancelToken = cancelNativeCancelToken
+module.exports.dropNativeCancelToken = dropNativeCancelToken
+module.exports.CancellationToken = CancellationToken
+module.exports.ConnHandle = ConnHandle
+module.exports.JsNativeDatabase = JsNativeDatabase
+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,57 @@
+{
+	"name": "@rivetkit/rivetkit-napi",
+	"version": "0.0.0-pr.4701.a818b77",
+	"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"
+	},
+	"dependencies": {
+		"@napi-rs/cli": "^2.18.4",
+		"@rivetkit/engine-envoy-protocol": "0.0.0-pr.4701.a818b77"
+	},
+	"optionalDependencies": {
+		"@rivetkit/rivetkit-napi-darwin-arm64": "0.0.0-pr.4701.a818b77",
+		"@rivetkit/rivetkit-napi-darwin-x64": "0.0.0-pr.4701.a818b77",
+		"@rivetkit/rivetkit-napi-linux-arm64-gnu": "0.0.0-pr.4701.a818b77",
+		"@rivetkit/rivetkit-napi-linux-arm64-musl": "0.0.0-pr.4701.a818b77",
+		"@rivetkit/rivetkit-napi-linux-x64-gnu": "0.0.0-pr.4701.a818b77",
+		"@rivetkit/rivetkit-napi-linux-x64-musl": "0.0.0-pr.4701.a818b77",
+		"@rivetkit/rivetkit-napi-win32-x64-msvc": "0.0.0-pr.4701.a818b77"
+	}
+}

package/scripts/build.mjs

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+/**
+ * Smart build wrapper for rivetkit-napi.
+ *
+ * Skips the napi build if a prebuilt .node file already exists next to
+ * this package (either a root-level `rivetkit-napi.*.node` or one inside
+ * a `npm/<platform>/` directory). This lets CI skip a redundant napi build
+ * when the cross-compiled artifacts have already been downloaded from the
+ * platform build jobs.
+ *
+ * Pass `--force` to always run the napi build.
+ */
+import { execSync } from "node:child_process";
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageDir = join(__dirname, "..");
+
+const args = process.argv.slice(2);
+const force = args.includes("--force");
+const releaseArg = args.find((a) => a === "--release");
+const extraFlags = releaseArg ? ["--release"] : [];
+
+// Explicit skip for environments that don't need the native binary (e.g.
+// Docker engine-frontend build which only consumes TypeScript types).
+if (!force && process.env.SKIP_NAPI_BUILD === "1") {
+	console.log(
+		"[rivetkit-napi/build] SKIP_NAPI_BUILD=1 — skipping napi build",
+	);
+	process.exit(0);
+}
+
+function hasPrebuiltArtifact() {
+	// Check for root-level .node files.
+	const rootFiles = readdirSync(packageDir);
+	if (rootFiles.some((f) => f.endsWith(".node"))) {
+		return true;
+	}
+	// Check for any npm/<platform>/*.node files.
+	const npmDir = join(packageDir, "npm");
+	if (existsSync(npmDir) && statSync(npmDir).isDirectory()) {
+		for (const entry of readdirSync(npmDir)) {
+			const platDir = join(npmDir, entry);
+			if (!statSync(platDir).isDirectory()) continue;
+			const files = readdirSync(platDir);
+			if (files.some((f) => f.endsWith(".node"))) {
+				return true;
+			}
+		}
+	}
+	return false;
+}
+
+if (!force && hasPrebuiltArtifact()) {
+	console.log(
+		"[rivetkit-napi/build] prebuilt .node artifact found — skipping napi build",
+	);
+	console.log("[rivetkit-napi/build] use --force to rebuild from source");
+	process.exit(0);
+}
+
+const cmd = ["napi", "build", "--platform", ...extraFlags].join(" ");
+console.log(`[rivetkit-napi/build] running: ${cmd}`);
+execSync(cmd, { stdio: "inherit", cwd: packageDir });