@econ-v1/app-sdk 6.9.2 → 6.9.4

package/dist/index.d.ts

@@ -29,7 +29,17 @@
  * runNodeApp(new MyApp());
  * ```
  */
+import { Database } from "bun:sqlite";
 export { initAppTelemetry, telemetryActive, incrementCounter } from "./otel.js";
+/**
+ * Open an app-owned SQLite database with a bounded page cache.
+ *
+ * Bun does not expose SQLite's live cache-use counter, so this is explicitly
+ * a configured upper bound rather than a fabricated memory measurement.
+ */
+export declare function openDatabase(path: string, options?: {
+    cacheSizeKb?: number;
+}): Database;
 interface NodeAppCtx {
     socket: string | undefined;
     logDir: string | undefined;
@@ -114,6 +124,18 @@ export interface ProvidedCapability {
     priority?: number;
     examples?: CapabilityExample[];
 }
+export interface HeapSnapshotRequest {
+    type: "heap_snapshot_request";
+    id: string;
+    path: string;
+}
+export interface HeapSnapshotResponse {
+    type: "heap_snapshot_response";
+    id: string;
+    success: boolean;
+    error?: string;
+    size_bytes?: number;
+}
 /**
  * Host interaction helper for logging from within app code.
  * Logs are written to files for persistence and sent via IPC for real-time streaming.
@@ -143,6 +165,20 @@ export declare function invokeCapability(request: CapabilityRequest, timeoutMs?:
  * This is a fire-and-forget operation — no response is returned.
  */
 export declare function publishEvent(eventName: string, data: unknown): void;
+export interface AppMemorySample {
+    heap_used_kb: number;
+    heap_total_kb: number;
+    external_kb?: number;
+    heap_capacity_kb?: number;
+}
+/** @internal Exact isolate sample used by the IPC timer and unit tests. */
+export declare function _sampleMemory(): AppMemorySample;
+export declare function _captureHeapSnapshotTo(path: string, generate?: () => ArrayBuffer, write?: (path: string, bytes: ArrayBuffer) => Promise<number>): Promise<{
+    size_bytes: number;
+}>;
+export declare function _handleHeapSnapshotRequest(request: HeapSnapshotRequest, send: (message: HeapSnapshotResponse) => void, capture?: (path: string) => Promise<{
+    size_bytes: number;
+}>): Promise<void>;
 interface RoutePolicy {
     /** All listed permissions must be present in request.caller.granted_permissions */
     requiredPermissions?: string[];