dx-devkit 0.0.0-stage → 1.1.0

package/node_modules/@dx/web/dist/dev.d.ts

@@ -0,0 +1,109 @@
+import { type DevError, type Project } from "@dx/core";
+/**
+ * Dev servers run by the dashboard. A project runs as one process, or, when it has a stack, as
+ * several services started in order (databases, then back ends, then front ends). Output is kept
+ * (the last lines) so the page and AI agents can read it, errors are picked out of it, and
+ * everything stops when the dashboard stops, like a dev server stops when you close its terminal.
+ */
+export interface DevLine {
+    /** Numbered across every server, so lines from a stack's services merge in order. */
+    n: number;
+    stream: "out" | "err" | "dx";
+    text: string;
+    /** The stack service the line came from. */
+    service?: string;
+}
+export type StartedBy = "dashboard" | "ai" | "terminal";
+export type DevStatus = "starting" | "ready" | "stopped" | "failed";
+export interface DevServerInfo {
+    project: string;
+    dir: string;
+    command: string;
+    url?: string;
+    /** Its address through dx's local domains, e.g. http://shop.localhost. */
+    localUrl?: string;
+    pid?: number;
+    status: DevStatus;
+    /** Who started it: the dashboard's Run button, an AI agent through MCP, or the terminal. */
+    startedBy: StartedBy;
+    /** Errors in its output that haven't been resolved by a clean rebuild. */
+    errorCount: number;
+    startedAt: string;
+    stoppedAt?: string;
+    exitCode?: number | null;
+    /** Number of the last line, so the page can ask only for what's new. */
+    lastLine: number;
+    /** For a stack's service: its name and role. */
+    service?: string;
+    role?: string;
+    /** For a stack: its services, how it was found, and anything worth knowing (a service that wasn't started). */
+    services?: DevServerInfo[];
+    stackSource?: string;
+    note?: string;
+}
+/** Tells the dev servers the local domains proxy's port, or undefined when it isn't running. */
+export declare function setLocalDomainsPort(port: number | undefined): void;
+/** Every *.localhost name dx serves, and the address it points at. */
+export declare function localRoutes(): Map<string, {
+    url: string;
+    dir: string;
+    service?: string;
+}>;
+export declare function listDevServers(): DevServerInfo[];
+export declare function devServer(dir: string): DevServerInfo | undefined;
+/** The process (or stack service) listening on a port, for matching a request to its server. */
+export declare function serverForPort(port: number): {
+    dir: string;
+    service?: string;
+    project: string;
+} | undefined;
+export declare function devLogs(dir: string, after?: number, service?: string): {
+    lines: DevLine[];
+    server?: DevServerInfo;
+};
+/** Errors found in one server's output (a stack's services included), or in every server's when `dir` is empty. */
+export declare function devErrors(dir?: string, options?: {
+    all?: boolean;
+    after?: number;
+    service?: string;
+}): {
+    project: string;
+    dir: string;
+    errors: DevError[];
+}[];
+/** Starts a project: its stack when it has one, else its dev command. */
+export declare function startDevServer(project: Project, startedBy?: StartedBy): DevServerInfo;
+export declare function stopDevServer(dir: string): Promise<DevServerInfo | undefined>;
+/** Stops every dev server; called when the dashboard shuts down. */
+export declare function stopAllDevServers(): Promise<void>;
+/** Stops the server (or stack), waits for it to exit, and starts it again. */
+export declare function restartDevServer(project: Project, startedBy?: StartedBy): Promise<DevServerInfo>;
+/** Forgets a stopped server or stack, so its card and output go away. */
+export declare function clearDevServer(dir: string): void;
+/** True while any dev server or stack is running. */
+export declare function anyDevServerRunning(): boolean;
+export interface WaitResult {
+    server?: DevServerInfo;
+    /** Output printed since `after` (the newest 200 lines at most). */
+    lines: DevLine[];
+    /** Current errors that appeared, or came back, since `after`. */
+    newErrors: DevError[];
+    /** Every current error. */
+    errors: DevError[];
+    /** False when the server printed nothing at all while waiting. */
+    sawOutput: boolean;
+    timedOut: boolean;
+}
+/**
+ * Waits for a dev server (or a stack's services) to settle, then says what they printed.
+ * `until: "ready"` waits for starting to finish; `until: "quiet"` waits for output to begin (a
+ * rebuild after a file change), then for it to stop for `quietMs`.
+ */
+export declare function waitForDevServer(dir: string, options?: {
+    after?: number;
+    until?: "ready" | "quiet";
+    quietMs?: number;
+    settleMs?: number;
+    timeoutMs?: number;
+}): Promise<WaitResult>;
+//# sourceMappingURL=dev.d.ts.map

package/node_modules/@dx/web/dist/dev.d.ts.map

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