@nola-lang/console 0.1.4

package/dist/start.d.ts

@@ -0,0 +1,36 @@
+import { type ConsoleNotice } from "./core/service.js";
+export declare const CONSOLE_DEFAULT_PORT = 4141;
+/**
+ * The console is one instance per dev machine, so its root folder is
+ * per-machine, not per-project: `~/.nola/console`. Everything the console
+ * keeps lives under it — the database at `data/console.db` today, further
+ * settings later. `StartConsoleOptions.path` is the only override.
+ */
+export declare function defaultConsolePath(): string;
+/** The SQLite database inside a console root. */
+export declare function consoleDbPath(root: string): string;
+export interface StartConsoleOptions {
+    /** Exact port to bind — no scanning (0 = OS-assigned). Default: scan upward from 4141. */
+    port?: number;
+    /** Default 127.0.0.1 — loopback only (console design §13). */
+    host?: string;
+    /** The console's root folder — default `~/.nola/console`; created on demand. The database lives at `<path>/data/console.db`. */
+    path?: string;
+    /** Directory of the built UI. Default: `ui/` beside the compiled module (dist/ui in the published package); absent falls back to the placeholder page. */
+    uiDir?: string;
+}
+export interface RunningConsole {
+    url: string;
+    port: number;
+    /** The console root (`StartConsoleOptions.path` resolved). */
+    path: string;
+    /** The SQLite database inside the root. */
+    dbPath: string;
+    /** Subscribe to every ingested envelope and the `cleared` notice (the same fan-out the SSE stream reads); returns the unsubscribe. */
+    onEvent(listener: (notice: ConsoleNotice) => void): () => void;
+    close(): Promise<void>;
+}
+export declare function findFreePort(host: string, start: number, attempts?: number): Promise<number>;
+/** Open storage, mount the app, bind loopback — one process, one local database (console design §13). */
+export declare function startConsole(options?: StartConsoleOptions): Promise<RunningConsole>;
+//# sourceMappingURL=start.d.ts.map

package/dist/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,mBAAmB,CAAC;AAIvE,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,iDAAiD;AACjD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,MAAM,WAAW,mBAAmB;IAClC,0FAA0F;IAC1F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gIAAgI;IAChI,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0JAA0J;IAC1J,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,sIAAsI;IACtI,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC/D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAU9F;AAED,yGAAyG;AACzG,wBAAsB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,cAAc,CAAC,CA4B7F"}

package/dist/start.js

@@ -0,0 +1,66 @@
+import { mkdirSync } from "node:fs";
+import { createServer } from "node:net";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { serve } from "@hono/node-server";
+import { ConsoleService } from "./core/service.js";
+import { createApp } from "./server/app.js";
+import { SqliteConsoleStorage } from "./storage/sqlite.js";
+export const CONSOLE_DEFAULT_PORT = 4141;
+/**
+ * The console is one instance per dev machine, so its root folder is
+ * per-machine, not per-project: `~/.nola/console`. Everything the console
+ * keeps lives under it — the database at `data/console.db` today, further
+ * settings later. `StartConsoleOptions.path` is the only override.
+ */
+export function defaultConsolePath() {
+    return join(homedir(), ".nola", "console");
+}
+/** The SQLite database inside a console root. */
+export function consoleDbPath(root) {
+    return join(root, "data", "console.db");
+}
+export async function findFreePort(host, start, attempts = 20) {
+    for (let port = start; port < start + attempts; port++) {
+        const free = await new Promise((resolve) => {
+            const probe = createServer();
+            probe.once("error", () => resolve(false));
+            probe.listen({ port, host }, () => probe.close(() => resolve(true)));
+        });
+        if (free)
+            return port;
+    }
+    throw new Error(`No free port found in ${start}..${start + attempts - 1}.`);
+}
+/** Open storage, mount the app, bind loopback — one process, one local database (console design §13). */
+export async function startConsole(options = {}) {
+    const host = options.host ?? "127.0.0.1";
+    const path = options.path ?? defaultConsolePath();
+    const dbPath = consoleDbPath(path);
+    mkdirSync(dirname(dbPath), { recursive: true });
+    const storage = new SqliteConsoleStorage(dbPath);
+    const service = new ConsoleService(storage);
+    const uiDir = options.uiDir ?? fileURLToPath(new URL("ui/", import.meta.url));
+    const app = createApp(service, { uiDir });
+    const port = options.port ?? (await findFreePort(host, CONSOLE_DEFAULT_PORT));
+    const server = await new Promise((resolve, reject) => {
+        const s = serve({ fetch: app.fetch, port, hostname: host }, () => resolve(s));
+        s.once("error", reject);
+    });
+    // An explicit port 0 binds an OS-assigned port — report the real one.
+    const address = server.address();
+    const boundPort = typeof address === "object" && address !== null ? address.port : port;
+    return {
+        url: `http://${host}:${boundPort}`,
+        port: boundPort,
+        path,
+        dbPath,
+        onEvent: (listener) => service.onEvent(listener),
+        close: async () => {
+            await new Promise((resolve, reject) => server.close((err) => (err ? reject(err) : resolve())));
+            await storage.close();
+        },
+    };
+}
+//# sourceMappingURL=start.js.map

package/dist/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"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"}

package/dist/storage/sqlite.d.ts

@@ -0,0 +1,20 @@
+import type { NolaIngestEnvelope } from "@nola-lang/core";
+import type { AskDetail, ConsoleStorage, DefinitionDetail, DefinitionSummary, ProjectSummary, RecordsQuery, TraceDetail, TraceRecord } from "./types.js";
+/** Local trace store over node:sqlite. All reduction is SQL upserts, so event arrival order does not matter. */
+export declare class SqliteConsoleStorage implements ConsoleStorage {
+    #private;
+    constructor(path: string);
+    ingest(envelope: NolaIngestEnvelope): Promise<void>;
+    listProjects(): Promise<ProjectSummary[]>;
+    listRecords(query?: RecordsQuery): Promise<TraceRecord[]>;
+    getTrace(invocationId: string): Promise<TraceDetail | undefined>;
+    getAsk(askId: string): Promise<AskDetail | undefined>;
+    listDefinitions(query?: {
+        project?: string;
+        noProject?: boolean;
+    }): Promise<DefinitionSummary[]>;
+    getDefinition(def: string): Promise<DefinitionDetail | undefined>;
+    clear(): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/storage/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/storage/sqlite.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAW,kBAAkB,EAAkB,MAAM,iBAAiB,CAAC;AAEnF,OAAO,KAAK,EACV,SAAS,EAIT,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EAGjB,cAAc,EACd,YAAY,EACZ,WAAW,EACX,WAAW,EACZ,MAAM,YAAY,CAAC;AA2KpB,gHAAgH;AAChH,qBAAa,oBAAqB,YAAW,cAAc;;gBAG7C,IAAI,EAAE,MAAM;IA+DlB,MAAM,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkNnD,YAAY,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAiFzC,WAAW,CAAC,KAAK,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAoB7D,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAwBhE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAiErD,eAAe,CAAC,KAAK,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAepG,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAWjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}