@spexcode/spec-cli 0.6.5

package/dist/host.d.ts

@@ -0,0 +1,88 @@
+import http from 'node:http';
+import { type ResolvedIdentity } from '@spexcode/spec-core';
+export type EndpointRecord = {
+    version: 2;
+    url: string;
+    pid: number;
+    instanceId: string;
+    root: string;
+    identity: ResolvedIdentity;
+    startedAt: string;
+};
+export declare const endpointRecordPath: (root: string) => string;
+export declare function publishEndpoint(rec: EndpointRecord): void;
+export declare function dropOwnEndpoint(instanceId: string, root: string): void;
+export declare function readEndpointRecord(file: string): EndpointRecord | null;
+export type CatalogEntry = {
+    root: string;
+    addedAt: string;
+};
+export declare const catalogPath: () => string;
+export declare function readCatalog(): CatalogEntry[];
+export type ProjectDirectoryListing = {
+    path: string;
+    exists: boolean;
+    parent: string | null;
+    home: string;
+    gitRoot: string | null;
+    initialized: boolean;
+    cataloged: boolean;
+    entries: Array<{
+        name: string;
+        path: string;
+        git: boolean;
+        initialized: boolean;
+    }>;
+};
+export declare function browseProjectDirectories(dir?: string): ProjectDirectoryListing;
+export declare function addKnownProject(dir: string): string;
+export type ProjectEntry = {
+    projectId: string;
+    root: string;
+    identity: ResolvedIdentity;
+    configRevision: string;
+    online: boolean;
+    url: string | null;
+    pid?: number;
+    startedAt?: string;
+};
+export declare function reconcileProjects(): Promise<ProjectEntry[]>;
+export declare function reconcileNow(): Promise<ProjectEntry[]>;
+export declare function runSpex(root: string, args: string[], timeoutMs?: number): Promise<{
+    code: number | null;
+    output: string;
+}>;
+export type AddProjectSetup = {
+    createDir?: boolean;
+    initGit?: boolean;
+    init?: {
+        harness: string;
+        preset?: string;
+    };
+};
+export type AddProjectSetupResult = {
+    ok: boolean;
+    root: string;
+    directoryCreated: boolean;
+    gitInitialized: boolean;
+    init?: {
+        code: number | null;
+        output: string;
+    };
+};
+export declare function addKnownProjectWithSetup(dir: string, setup?: AddProjectSetup): Promise<AddProjectSetupResult>;
+export declare function startBackend(root: string, waitMs?: number): Promise<ProjectEntry>;
+export type HostDashboardOpts = {
+    port: number;
+    host?: string;
+    distDir?: string;
+    tls?: {
+        cert: string;
+        key: string;
+    } | null;
+};
+export type HostDashboard = {
+    server: http.Server;
+    close: () => Promise<void>;
+};
+export declare function startHostDashboard(opts: HostDashboardOpts): HostDashboard;