@rivetkit/rivetkit-native 0.0.0-pr.4673.028a93e → 0.0.0-pr.4673.2953c20

package/index.d.ts

@@ -4,54 +4,58 @@
 /* auto-generated by NAPI-RS */
 
 export interface JsBindParam {
-	kind: string;
-	intValue?: number;
-	floatValue?: number;
-	textValue?: string;
-	blobValue?: Buffer;
+  kind: string
+  intValue?: number
+  floatValue?: number
+  textValue?: string
+  blobValue?: Buffer
 }
 export interface ExecuteResult {
-	changes: number;
+  changes: number
 }
 export interface QueryResult {
-	columns: Array<string>;
-	rows: Array<Array<any>>;
+  columns: Array<string>
+  rows: Array<Array<any>>
+}
+export interface JsSqliteVfsMetrics {
+  requestBuildNs: number
+  serializeNs: number
+  transportNs: number
+  stateUpdateNs: number
+  totalNs: number
+  commitCount: number
 }
 /** Open a native SQLite database backed by the envoy's KV channel. */
-export declare function openDatabaseFromEnvoy(
-	jsHandle: JsEnvoyHandle,
-	actorId: string,
-	preloadedEntries?: Array<JsKvEntry> | undefined | null,
-): Promise<JsNativeDatabase>;
+export declare function openDatabaseFromEnvoy(jsHandle: JsEnvoyHandle, actorId: string, preloadedEntries?: Array<JsKvEntry> | undefined | null): Promise<JsNativeDatabase>
 /** Configuration for starting the native envoy client. */
 export interface JsEnvoyConfig {
-	endpoint: string;
-	token: string;
-	namespace: string;
-	poolName: string;
-	version: number;
-	metadata?: any;
-	notGlobal: boolean;
-	/**
-	 * Log level for the Rust tracing subscriber (e.g. "trace", "debug", "info", "warn", "error").
-	 * Falls back to RIVET_LOG_LEVEL, then LOG_LEVEL, then RUST_LOG env vars. Defaults to "warn".
-	 */
-	logLevel?: string;
+  endpoint: string
+  token: string
+  namespace: string
+  poolName: string
+  version: number
+  metadata?: any
+  notGlobal: boolean
+  /**
+   * Log level for the Rust tracing subscriber (e.g. "trace", "debug", "info", "warn", "error").
+   * Falls back to RIVET_LOG_LEVEL, then LOG_LEVEL, then RUST_LOG env vars. Defaults to "warn".
+   */
+  logLevel?: string
 }
 /** Options for KV list operations. */
 export interface JsKvListOptions {
-	reverse?: boolean;
-	limit?: number;
+  reverse?: boolean
+  limit?: number
 }
 /** A key-value entry returned from KV list operations. */
 export interface JsKvEntry {
-	key: Buffer;
-	value: Buffer;
+  key: Buffer
+  value: Buffer
 }
 /** A single hibernating request entry. */
 export interface HibernatingRequestEntry {
-	gatewayId: Buffer;
-	requestId: Buffer;
+  gatewayId: Buffer
+  requestId: Buffer
 }
 /**
  * Start the native envoy client synchronously.
@@ -59,93 +63,40 @@ export interface HibernatingRequestEntry {
  * Returns a handle immediately. The caller must call `await handle.started()`
  * to wait for the connection to be ready.
  */
-export declare function startEnvoySyncJs(
-	config: JsEnvoyConfig,
-	eventCallback: (event: any) => void,
-): JsEnvoyHandle;
+export declare function startEnvoySyncJs(config: JsEnvoyConfig, eventCallback: (event: any) => void): JsEnvoyHandle
 /** Start the native envoy client asynchronously. */
-export declare function startEnvoyJs(
-	config: JsEnvoyConfig,
-	eventCallback: (event: any) => void,
-): JsEnvoyHandle;
-/** Native SQLite database handle exposed to JavaScript. */
+export declare function startEnvoyJs(config: JsEnvoyConfig, eventCallback: (event: any) => void): JsEnvoyHandle
 export declare class JsNativeDatabase {
-	takeLastKvError(): string | 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>;
+  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>
 }
 /** Native envoy handle exposed to JavaScript via N-API. */
 export declare class JsEnvoyHandle {
-	started(): Promise<void>;
-	shutdown(immediate: boolean): void;
-	get envoyKey(): string;
-	sleepActor(actorId: string, generation?: number | undefined | null): void;
-	stopActor(
-		actorId: string,
-		generation?: number | undefined | null,
-		error?: string | undefined | null,
-	): void;
-	destroyActor(actorId: string, generation?: number | undefined | null): void;
-	setAlarm(
-		actorId: string,
-		alarmTs?: number | undefined | null,
-		generation?: number | undefined | null,
-	): void;
-	kvGet(
-		actorId: string,
-		keys: Array<Buffer>,
-	): Promise<Array<Buffer | undefined | null>>;
-	kvPut(actorId: string, entries: Array<JsKvEntry>): Promise<void>;
-	kvDelete(actorId: string, keys: Array<Buffer>): Promise<void>;
-	kvDeleteRange(actorId: string, start: Buffer, end: Buffer): Promise<void>;
-	kvListAll(
-		actorId: string,
-		options?: JsKvListOptions | undefined | null,
-	): Promise<Array<JsKvEntry>>;
-	kvListRange(
-		actorId: string,
-		start: Buffer,
-		end: Buffer,
-		exclusive?: boolean | undefined | null,
-		options?: JsKvListOptions | undefined | null,
-	): Promise<Array<JsKvEntry>>;
-	kvListPrefix(
-		actorId: string,
-		prefix: Buffer,
-		options?: JsKvListOptions | undefined | null,
-	): Promise<Array<JsKvEntry>>;
-	kvDrop(actorId: string): Promise<void>;
-	restoreHibernatingRequests(
-		actorId: string,
-		requests: Array<HibernatingRequestEntry>,
-	): void;
-	sendHibernatableWebSocketMessageAck(
-		gatewayId: Buffer,
-		requestId: Buffer,
-		clientMessageIndex: number,
-	): void;
-	/** Send a message on an open WebSocket connection identified by messageIdHex. */
-	sendWsMessage(
-		gatewayId: Buffer,
-		requestId: Buffer,
-		data: Buffer,
-		binary: boolean,
-	): Promise<void>;
-	/** Close an open WebSocket connection. */
-	closeWebsocket(
-		gatewayId: Buffer,
-		requestId: Buffer,
-		code?: number | undefined | null,
-		reason?: string | undefined | null,
-	): Promise<void>;
-	startServerless(payload: Buffer): Promise<void>;
-	respondCallback(responseId: string, data: any): Promise<void>;
+  started(): Promise<void>
+  shutdown(immediate: boolean): void
+  get envoyKey(): string
+  sleepActor(actorId: string, generation?: number | undefined | null): void
+  stopActor(actorId: string, generation?: number | undefined | null, error?: string | undefined | null): void
+  destroyActor(actorId: string, generation?: number | undefined | null): void
+  setAlarm(actorId: string, alarmTs?: number | undefined | null, generation?: number | undefined | null): void
+  kvGet(actorId: string, keys: Array<Buffer>): Promise<Array<Buffer | undefined | null>>
+  kvPut(actorId: string, entries: Array<JsKvEntry>): Promise<void>
+  kvDelete(actorId: string, keys: Array<Buffer>): Promise<void>
+  kvDeleteRange(actorId: string, start: Buffer, end: Buffer): Promise<void>
+  kvListAll(actorId: string, options?: JsKvListOptions | undefined | null): Promise<Array<JsKvEntry>>
+  kvListRange(actorId: string, start: Buffer, end: Buffer, exclusive?: boolean | undefined | null, options?: JsKvListOptions | undefined | null): Promise<Array<JsKvEntry>>
+  kvListPrefix(actorId: string, prefix: Buffer, options?: JsKvListOptions | undefined | null): Promise<Array<JsKvEntry>>
+  kvDrop(actorId: string): Promise<void>
+  restoreHibernatingRequests(actorId: string, requests: Array<HibernatingRequestEntry>): void
+  sendHibernatableWebSocketMessageAck(gatewayId: Buffer, requestId: Buffer, clientMessageIndex: number): void
+  /** Send a message on an open WebSocket connection identified by messageIdHex. */
+  sendWsMessage(gatewayId: Buffer, requestId: Buffer, data: Buffer, binary: boolean): Promise<void>
+  /** Close an open WebSocket connection. */
+  closeWebsocket(gatewayId: Buffer, requestId: Buffer, code?: number | undefined | null, reason?: string | undefined | null): Promise<void>
+  startServerless(payload: Buffer): Promise<void>
+  respondCallback(responseId: string, data: any): Promise<void>
 }

package/package.json

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

package/wrapper.d.ts

@@ -119,6 +119,10 @@ export interface EnvoyConfig {
 		preloadedKv:
 			| import("@rivetkit/engine-envoy-protocol").PreloadedKv
 			| null,
+		sqliteSchemaVersion: number,
+		sqliteStartupData:
+			| import("@rivetkit/engine-envoy-protocol").SqliteStartupData
+			| null,
 	) => Promise<void>;
 	onActorStop: (
 		envoyHandle: EnvoyHandle,

package/wrapper.js

@@ -194,6 +194,32 @@ function decodePreloadedKv(preloadedKv) {
 	};
 }
 
+function decodeSqliteStartupData(sqliteStartupData) {
+	if (!sqliteStartupData) {
+		return null;
+	}
+
+	const decodeBytes = (value) => Uint8Array.from(Buffer.from(value, "base64"));
+
+	return {
+		generation: sqliteStartupData.generation,
+		meta: {
+			schemaVersion: sqliteStartupData.meta.schemaVersion,
+			generation: sqliteStartupData.meta.generation,
+			headTxid: sqliteStartupData.meta.headTxid,
+			materializedTxid: sqliteStartupData.meta.materializedTxid,
+			dbSizePages: sqliteStartupData.meta.dbSizePages,
+			pageSize: sqliteStartupData.meta.pageSize,
+			creationTsMs: sqliteStartupData.meta.creationTsMs,
+			maxDeltaBytes: sqliteStartupData.meta.maxDeltaBytes,
+		},
+		preloadedPages: (sqliteStartupData.preloadedPages || []).map((page) => ({
+			pgno: page.pgno,
+			bytes: page.bytes ? decodeBytes(page.bytes) : null,
+		})),
+	};
+}
+
 /**
  * Route callback envelopes from the native addon to EnvoyConfig callbacks.
  */
@@ -216,6 +242,8 @@ function handleEvent(event, config, wrappedHandle) {
 					event.generation,
 					actorConfig,
 					decodePreloadedKv(event.preloadedKv),
+					event.sqliteSchemaVersion,
+					decodeSqliteStartupData(event.sqliteStartupData),
 				),
 			).then(
 				async () => {