@econ-v1/app-sdk 7.0.78 → 7.0.79

package/dist/otel-burger.d.ts

@@ -0,0 +1,5 @@
+export declare function initAppTelemetry(_appName: string): Promise<void>;
+export declare function telemetryActive(): boolean;
+export declare function incrementCounter(_name: string, _value?: number, _attributes?: Record<string, string | number | boolean>): void;
+export declare function injectTraceContext(carrier: Record<string, string>): Record<string, string>;
+export declare function traceIncomingCapability<T>(_capability: string, _carrier: Record<string, string> | undefined, fn: () => Promise<T>): Promise<T>;

package/dist/platform/bun.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Bun (and Node-compatible) platform for the SDK core. Selected by
+ * `#platform` for every export condition except `burger`. The bodies here
+ * were moved verbatim from `src/index.ts`; behaviour is unchanged.
+ */
+import type { AppMemorySample, HostConnection, HostConnectionHandlers, InvocationContextStore, NodeAppCtx } from "./types.js";
+export declare const platformName: "bun" | "burger";
+export declare const isMainThread: boolean;
+export declare const DEFAULT_SQLITE_CACHE_SIZE_KB: number;
+/** @internal exported for unit tests; not part of the public SDK surface. */
+export declare function _resolveCtx(): NodeAppCtx;
+/** Context captured once at SDK import time. */
+export declare const appCtx: NodeAppCtx;
+/** @internal test-only export */
+export declare function _testRunNodeAppPath(): string | undefined;
+/** @internal test-only export; also the production exit pathway. */
+export declare function _testExitWorker(code: number, mainThread: boolean, exit?: (code: number) => never): void;
+/** Exit this app: the process on the main thread, the worker otherwise. */
+export declare function exitApp(code: number): void;
+/** Exit with an error when the host did not provide `NODE_APP_SOCKET`. */
+export declare function assertHostEndpoint(): void;
+/**
+ * Connect to the host over the per-app Unix socket and speak the
+ * newline-delimited JSON protocol. Frames that arrive in one chunk are
+ * handled in order; a frame's handler finishing is awaited before the next
+ * frame of the same chunk is dispatched.
+ */
+export declare function connectToHost(handlers: HostConnectionHandlers): HostConnection;
+export declare function createInvocationContextStore<T>(): InvocationContextStore<T>;
+/** @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;
+}>;

package/dist/platform/burger.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Burger platform for the SDK core. Selected by `#platform` under the
+ * `burger` export condition (Burger apps are bundled by `burger-build`,
+ * which sets it).
+ *
+ * The per-app channel is opened by the Burger runtime from its load_app
+ * message (Contract C3); framing and JSON (de)serialisation happen in Rust
+ * (Contract C4), so this module never splits lines or calls `JSON.parse`.
+ */
+import type { AppMemorySample, HostConnection, HostConnectionHandlers, InvocationContextStore, NodeAppCtx } from "./types.js";
+export declare const platformName: "bun" | "burger";
+/** Burger runs each app on its own runtime; there are no worker threads. */
+export declare const isMainThread: boolean;
+/** Burger applies `PRAGMA cache_size = -256` to every database it opens; the SDK must not widen it. */
+export declare const DEFAULT_SQLITE_CACHE_SIZE_KB: number;
+/** @internal exported for unit tests; not part of the public SDK surface. */
+export declare function _resolveCtx(): NodeAppCtx;
+/** Context captured once at SDK import time. */
+export declare const appCtx: NodeAppCtx;
+/** @internal test-only export */
+export declare function _testRunNodeAppPath(): string | undefined;
+/** @internal test-only export; also the production exit pathway. */
+export declare function _testExitWorker(code: number, _mainThread: boolean, exitFn?: (code: number) => never): void;
+/** Exit this app through the runtime (runs shutdown handlers, tears down the runtime). */
+export declare function exitApp(code: number): void;
+/** The runtime always binds the app channel, so there is nothing to check. */
+export declare function assertHostEndpoint(): void;
+/**
+ * Open the runtime-owned app channel. Each inbound frame is dispatched as
+ * soon as the runtime delivers it: handlers for different frames may
+ * interleave at `await` points, which is what lets a capability handler
+ * await an `invoke_capability_result` frame that arrives later.
+ */
+export declare function connectToHost(handlers: HostConnectionHandlers): HostConnection;
+/**
+ * Burger Phase 1 has no `AsyncLocalStorage` (C6). The store is visible only
+ * during the synchronous part of `fn`: a nested `invokeCapability` made
+ * before the handler's first `await` carries `invocation_context_id`, later
+ * ones carry none and the host classifies them as
+ * `Background(AutonomousApp)` — never a wrong or elevated origin.
+ */
+export declare function createInvocationContextStore<T>(): InvocationContextStore<T>;
+/** @internal Exact QuickJS runtime 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;
+}>;

package/dist/platform/conformance.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Compile-time guard: the Bun and Burger platforms export the same names
+ * with compatible types. `tsc --noEmit` (the SDK's `typecheck` script and
+ * the publish gate) fails when they drift apart.
+ */
+import type * as BunPlatform from "./bun.js";
+import type * as BurgerPlatform from "./burger.js";
+type Bun = typeof BunPlatform;
+type Burger = typeof BurgerPlatform;
+type SameExportNames = [Exclude<keyof Bun, keyof Burger>, Exclude<keyof Burger, keyof Bun>] extends [never, never] ? true : false;
+type BurgerAssignableToBun = Burger extends Bun ? true : false;
+type BunAssignableToBurger = Bun extends Burger ? true : false;
+export declare const platformsExportTheSameNames: SameExportNames;
+export declare const burgerPlatformMatchesBun: BurgerAssignableToBun;
+export declare const bunPlatformMatchesBurger: BunAssignableToBurger;
+import type * as OtelDefault from "../otel.js";
+import type * as OtelBurger from "../otel-burger.js";
+type OtelSameExportNames = [
+    Exclude<keyof typeof OtelDefault, keyof typeof OtelBurger>,
+    Exclude<keyof typeof OtelBurger, keyof typeof OtelDefault>
+] extends [never, never] ? true : false;
+type OtelBurgerAssignable = typeof OtelBurger extends typeof OtelDefault ? true : false;
+export declare const otelModulesExportTheSameNames: OtelSameExportNames;
+export declare const burgerOtelMatchesDefault: OtelBurgerAssignable;
+export {};

package/dist/platform/types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * The seam between the platform-neutral SDK core (`src/index.ts`) and the
+ * runtime it runs on. `src/platform/bun.ts` and `src/platform/burger.ts`
+ * export exactly the same names with these types; `package.json#imports`
+ * selects one through the `#platform` specifier (`burger` export condition
+ * → Burger, everything else → Bun). `src/platform/conformance.ts` fails
+ * `tsc` if the two drift apart.
+ */
+export interface NodeAppCtx {
+    socket: string | undefined;
+    logDir: string | undefined;
+    dataDir: string | undefined;
+}
+export interface AppMemorySample {
+    heap_used_kb: number;
+    heap_total_kb: number;
+    external_kb?: number;
+    heap_capacity_kb?: number;
+}
+/** Callbacks the SDK core registers on the host connection. */
+export interface HostConnectionHandlers {
+    /** The connection is open; `endpoint` is a human-readable description for logs. */
+    onConnected(endpoint: string): void;
+    /** One inbound IPC frame, already parsed into a plain object. */
+    onFrame(frame: unknown): Promise<void>;
+    /** A frame could not be parsed, or its handler threw. */
+    onFrameError(error: unknown): void;
+    /** The connection failed. */
+    onError(error: Error): void;
+    /** The connection closed normally. */
+    onClose(): void;
+}
+export interface HostConnection {
+    /** Write one frame. */
+    send(frame: object): void;
+    /** Write one frame and resolve once the runtime has accepted the bytes. */
+    sendAndFlush(frame: object): Promise<void>;
+    /** Stop delivering inbound frames that have not been delivered yet (lease drain). */
+    stopAccepting(): void;
+    /** Close the connection. */
+    end(): void;
+}
+/** The subset of `AsyncLocalStorage` the SDK core uses. */
+export interface InvocationContextStore<T> {
+    run<R>(store: T, fn: () => R): R;
+    getStore(): T | undefined;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@econ-v1/app-sdk",
-  "version": "7.0.78",
+  "version": "7.0.79",
   "description": "TypeScript SDK for building Node mini-app plugins (Bun runtime) on the Lightning-powered marketplace daemon",
   "license": "MIT OR Apache-2.0",
   "author": "Node contributors",
@@ -27,11 +27,44 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
+      "burger": "./dist/burger/index.js",
       "default": "./dist/index.js"
+    },
+    "./burger-build": {
+      "types": "./dist/burger-build/index.d.ts",
+      "default": "./dist/burger-build/index.js"
+    },
+    "./burger-types": {
+      "types": "./dist/burger-types/index.d.ts"
+    },
+    "./burger-types/modules": {
+      "types": "./dist/burger-types/modules.d.ts"
+    },
+    "./burger-types/aliases": {
+      "types": "./dist/burger-types/aliases.d.ts"
+    },
+    "./burger-types/globals": {
+      "types": "./dist/burger-types/globals.d.ts"
+    }
+  },
+  "bin": {
+    "burger-build": "dist/burger-build/cli.js"
+  },
+  "imports": {
+    "#platform": {
+      "burger": "./src/platform/burger.ts",
+      "default": "./src/platform/bun.ts"
+    },
+    "#otel": {
+      "burger": "./src/otel-burger.ts",
+      "default": "./src/otel.ts"
     }
   },
   "files": [
     "dist",
+    "!dist/__burger__",
+    "!dist/__tests__",
+    "!dist/**/*.test.d.ts",
     "README.md"
   ],
   "engines": {
@@ -39,11 +72,16 @@
     "bun": ">=1.0"
   },
   "scripts": {
-    "build": "rm -rf dist && bun build src/index.ts --outdir dist --target=bun --minify && tsc --emitDeclarationOnly --declaration --outDir dist",
+    "build": "rm -rf dist && bun build src/index.ts --outdir dist --target=bun --minify && bun run build:burger && tsc --emitDeclarationOnly --declaration --outDir dist && bun run build:toolchain",
+    "build:burger": "bun ../burger-build/src/cli.ts build src/index.ts --outdir dist/burger",
+    "build:toolchain": "bun scripts/build-burger-toolchain.ts",
     "prepublishOnly": "npm run build",
     "test": "bun test",
+    "test:burger": "bun test --conditions=burger --preload ./src/__burger__/preload.ts ./src/__burger__/run-node-app.burger-test.ts",
+    "test:toolchain": "cd ../burger-types && bun install && bun test && cd ../burger-build && bun install && bun run typecheck && bun test",
     "typecheck": "tsc --noEmit",
-    "pack:dry": "npm pack --dry-run"
+    "pack:dry": "npm pack --dry-run",
+    "verify:pack": "bun scripts/verify-pack.ts"
   },
   "publishConfig": {
     "access": "public"

package/dist/__tests__/lease-drain-socket.integration.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/__tests__/lease-drain.fixture.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/__tests__/otel.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/__tests__/worker-context.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/__tests__/worker-exit.fixture.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/__tests__/worker-exit.integration.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/index.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/managed-v1.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/memory.test.d.ts

@@ -1 +0,0 @@
-export {};