@lite-fsm/cli 0.1.0 → 0.1.1

package/dist/visualize/server.d.ts

@@ -1,40 +0,0 @@
-import type { CliContext } from "../cli/context.js";
-import type { CliDiagnostic } from "../cli/diagnostics.js";
-import type { VisualizerSession } from "./session.js";
-import type { VisualizerHttpRequest, VisualizerHttpResponse, VisualizerHttpResponseWriter, VisualizerRoute } from "./types.js";
-export type VisualizerServer = {
-    url: string;
-    port: number;
-    close(): Promise<void>;
-};
-export type StartVisualizerServerOptions = {
-    context: CliContext;
-    port: number;
-    session: VisualizerSession;
-    staticRoot: string;
-};
-export type StartVisualizerServerDependencies = {
-    routes?: readonly VisualizerRoute[];
-    createHttpServer?: CreateVisualizerHttpServer;
-};
-export type StartVisualizerServerResult = {
-    ok: true;
-    server: VisualizerServer;
-} | {
-    ok: false;
-    diagnostics: CliDiagnostic[];
-};
-type VisualizerServerListenerArgs = [event: "error", listener: (error: NodeJS.ErrnoException) => void] | [event: "listening", listener: () => void];
-export type VisualizerHttpServer = {
-    once(...args: VisualizerServerListenerArgs): VisualizerHttpServer;
-    removeListener(...args: VisualizerServerListenerArgs): VisualizerHttpServer;
-    listen(port: number, host: string): void;
-    close(callback: (error?: Error) => void): void;
-};
-export type CreateVisualizerHttpServer = (handler: (request: VisualizerHttpRequest, response: VisualizerHttpResponseWriter) => void) => VisualizerHttpServer;
-export declare const handleVisualizerRequest: (options: StartVisualizerServerOptions & {
-    routes: readonly VisualizerRoute[];
-}, request: VisualizerHttpRequest) => Promise<VisualizerHttpResponse>;
-export declare const startVisualizerServer: (options: StartVisualizerServerOptions, dependencies?: StartVisualizerServerDependencies) => Promise<StartVisualizerServerResult>;
-export declare const waitForSignalShutdown: (server: VisualizerServer) => Promise<void>;
-export {};

package/dist/visualize/server.js

@@ -1,90 +0,0 @@
-import { createServer } from "node:http";
-import { cliDiagnostic } from "../cli/diagnostics.js";
-import { createRequestPathname, createRequestUrl, dispatchApiRoute, errorResponse, writeHttpResponse } from "./http.js";
-import { createVisualizerRoutes } from "./routes.js";
-import { serveStaticAsset } from "./static-assets.js";
-const diagnosticForListenError = (error, port) => {
-  if (error.code === "EADDRINUSE") {
-    return cliDiagnostic("LFC_VISUALIZER_PORT_UNAVAILABLE", "error", `Port ${port} is already in use.`);
-  }
-  return cliDiagnostic("LFC_VISUALIZER_SERVER_FAILED", "error", `Visualizer server failed to start: ${error.message}`);
-};
-const createNodeHttpServer = (handler) => createServer((request, response) => handler(request, response));
-const closeServer = (server) => new Promise((resolve, reject) => {
-  server.close((error) => {
-    if (error) reject(error);
-    else resolve();
-  });
-});
-const listenServer = async (server, port) => new Promise((resolve) => {
-  const cleanup = () => {
-    server.removeListener("error", onError);
-    server.removeListener("listening", onListening);
-  };
-  const onError = (error) => {
-    cleanup();
-    resolve({ ok: false, error });
-  };
-  const onListening = () => {
-    cleanup();
-    resolve({ ok: true });
-  };
-  server.once("error", onError);
-  server.once("listening", onListening);
-  server.listen(port, "127.0.0.1");
-});
-const handleVisualizerRequest = async (options, request) => {
-  const url = createRequestUrl(request);
-  const pathname = createRequestPathname(request);
-  if (url.pathname.startsWith("/api/")) {
-    return dispatchApiRoute(options.routes, {
-      request,
-      url,
-      cliContext: options.context,
-      session: options.session
-    });
-  }
-  return serveStaticAsset(options.context, {
-    staticRoot: options.staticRoot,
-    pathname,
-    method: request.method
-  });
-};
-const startVisualizerServer = async (options, dependencies = {}) => {
-  const { createHttpServer = createNodeHttpServer, routes = createVisualizerRoutes() } = dependencies;
-  const routeContext = { ...options, routes };
-  const server = createHttpServer(async (request, response) => {
-    try {
-      const output = await handleVisualizerRequest(routeContext, request);
-      writeHttpResponse(response, output);
-    } catch {
-      writeHttpResponse(response, errorResponse(500, "server-failure", "Unexpected visualizer server failure."));
-    }
-  });
-  const listening = await listenServer(server, options.port);
-  if (!listening.ok) {
-    return { ok: false, diagnostics: [diagnosticForListenError(listening.error, options.port)] };
-  }
-  return {
-    ok: true,
-    server: {
-      url: `http://127.0.0.1:${options.port}/?session=${options.session.token}`,
-      port: options.port,
-      close: () => closeServer(server)
-    }
-  };
-};
-const waitForSignalShutdown = (server) => new Promise((resolve) => {
-  const shutdown = () => {
-    process.removeListener("SIGINT", shutdown);
-    process.removeListener("SIGTERM", shutdown);
-    server.close().finally(resolve);
-  };
-  process.once("SIGINT", shutdown);
-  process.once("SIGTERM", shutdown);
-});
-export {
-  handleVisualizerRequest,
-  startVisualizerServer,
-  waitForSignalShutdown
-};

package/dist/visualize/session.d.cts

@@ -1,34 +0,0 @@
-import type { LiteFsmGraphProjectResult } from "@lite-fsm/graph";
-import type { CliContext } from "../cli/context.js";
-import type { LiteFsmProjectGraphExportDocument } from "../export-graph/export-document.js";
-import type { VisualizerHostCapabilities, VisualizerSessionResponse, VisualizerSourceResponse } from "./types.js";
-export type VisualizerSourceReadResult = {
-    ok: true;
-    response: VisualizerSourceResponse;
-} | {
-    ok: false;
-    status: 400 | 404 | 409 | 500;
-    code: string;
-    message: string;
-};
-export type VisualizerSession = {
-    sessionId: string;
-    token: string;
-    projectRoot: string;
-    exportDocument: LiteFsmProjectGraphExportDocument;
-    capabilities: VisualizerHostCapabilities;
-    authenticate(token: string | null): boolean;
-    createSessionResponse(): VisualizerSessionResponse;
-    readSource(context: CliContext, fileName: string | null): VisualizerSourceReadResult;
-};
-export type CreateVisualizerSessionOptions = {
-    projectRoot: string;
-    exportDocument: LiteFsmProjectGraphExportDocument;
-    graphResult: LiteFsmGraphProjectResult;
-    sessionId?: string;
-    token?: string;
-};
-export declare const createGraphCompatibleSourceHash: (source: string) => string;
-export declare const createSessionToken: () => string;
-export declare const isValidProjectFileName: (fileName: string) => boolean;
-export declare const createVisualizerSession: ({ projectRoot, exportDocument, graphResult, sessionId, token, }: CreateVisualizerSessionOptions) => VisualizerSession;

package/dist/visualize/session.d.ts

@@ -1,34 +0,0 @@
-import type { LiteFsmGraphProjectResult } from "@lite-fsm/graph";
-import type { CliContext } from "../cli/context.js";
-import type { LiteFsmProjectGraphExportDocument } from "../export-graph/export-document.js";
-import type { VisualizerHostCapabilities, VisualizerSessionResponse, VisualizerSourceResponse } from "./types.js";
-export type VisualizerSourceReadResult = {
-    ok: true;
-    response: VisualizerSourceResponse;
-} | {
-    ok: false;
-    status: 400 | 404 | 409 | 500;
-    code: string;
-    message: string;
-};
-export type VisualizerSession = {
-    sessionId: string;
-    token: string;
-    projectRoot: string;
-    exportDocument: LiteFsmProjectGraphExportDocument;
-    capabilities: VisualizerHostCapabilities;
-    authenticate(token: string | null): boolean;
-    createSessionResponse(): VisualizerSessionResponse;
-    readSource(context: CliContext, fileName: string | null): VisualizerSourceReadResult;
-};
-export type CreateVisualizerSessionOptions = {
-    projectRoot: string;
-    exportDocument: LiteFsmProjectGraphExportDocument;
-    graphResult: LiteFsmGraphProjectResult;
-    sessionId?: string;
-    token?: string;
-};
-export declare const createGraphCompatibleSourceHash: (source: string) => string;
-export declare const createSessionToken: () => string;
-export declare const isValidProjectFileName: (fileName: string) => boolean;
-export declare const createVisualizerSession: ({ projectRoot, exportDocument, graphResult, sessionId, token, }: CreateVisualizerSessionOptions) => VisualizerSession;

package/dist/visualize/session.js

@@ -1,137 +0,0 @@
-import { randomBytes, randomUUID, timingSafeEqual } from "node:crypto";
-import { resolve } from "node:path";
-import { normalizeAbsolutePath, normalizePath } from "../project/source-cache.js";
-const createGraphCompatibleSourceHash = (source) => {
-  let hash = 2166136261;
-  for (let index = 0; index < source.length; index += 1) {
-    hash ^= source.charCodeAt(index);
-    hash = Math.imul(hash, 16777619);
-  }
-  return (hash >>> 0).toString(16).padStart(8, "0");
-};
-const createSessionToken = () => {
-  return randomBytes(32).toString("base64url");
-};
-const isAbsoluteFileName = (fileName) => {
-  return fileName.startsWith("/") || /^[A-Za-z]:/.test(fileName);
-};
-const isValidProjectFileName = (fileName) => {
-  if (fileName === "" || isAbsoluteFileName(fileName) || fileName.includes("\\")) return false;
-  const segments = fileName.split("/");
-  return segments.every((segment) => segment !== "" && segment !== "." && segment !== "..");
-};
-const sourcePath = (projectRoot, fileName) => {
-  return normalizeAbsolutePath(resolve(projectRoot, fileName));
-};
-const tokenEquals = (actual, expected) => {
-  const actualBuffer = Buffer.from(actual);
-  const expectedBuffer = Buffer.from(expected);
-  return actualBuffer.length === expectedBuffer.length && timingSafeEqual(actualBuffer, expectedBuffer);
-};
-const sourceFileByName = (files) => {
-  return new Map(files.map((file) => [file.fileName, file]));
-};
-const invalidFileName = () => ({
-  ok: false,
-  status: 400,
-  code: "invalid-file-name",
-  message: "Source fileName must be a project-relative graph file."
-});
-const readSessionSource = (input) => {
-  const { context, files, projectRoot, fileName } = input;
-  if (fileName === null || !isValidProjectFileName(fileName)) return invalidFileName();
-  const file = files.get(fileName);
-  if (!file) {
-    return {
-      ok: false,
-      status: 404,
-      code: "source-not-found",
-      message: `Source file '${fileName}' is not part of the graph session.`
-    };
-  }
-  const absolutePath = sourcePath(projectRoot, fileName);
-  try {
-    if (!context.fs.fileExists(absolutePath)) {
-      return {
-        ok: false,
-        status: 404,
-        code: "source-not-found",
-        message: `Source file '${fileName}' could not be read.`
-      };
-    }
-    const text = context.fs.readFile(absolutePath);
-    const hash = createGraphCompatibleSourceHash(text);
-    if (hash !== file.hash) {
-      return {
-        ok: false,
-        status: 409,
-        code: "source-stale",
-        message: `Source file '${fileName}' changed after graph build.`
-      };
-    }
-    return {
-      ok: true,
-      response: {
-        ok: true,
-        fileName,
-        language: file.language,
-        hash,
-        text
-      }
-    };
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    return {
-      ok: false,
-      status: 500,
-      code: "source-read-failed",
-      message: `Source file '${normalizePath(fileName)}' could not be read: ${message}`
-    };
-  }
-};
-const createVisualizerSession = ({
-  projectRoot,
-  exportDocument,
-  graphResult,
-  sessionId = randomUUID(),
-  token = createSessionToken()
-}) => {
-  const normalizedProjectRoot = normalizeAbsolutePath(projectRoot);
-  const files = sourceFileByName(graphResult.files);
-  const capabilities = {
-    mode: "local",
-    canReadFiles: true,
-    canWriteFiles: false,
-    canApplyPatch: false,
-    projectRoot: normalizedProjectRoot
-  };
-  return {
-    sessionId,
-    token,
-    projectRoot: normalizedProjectRoot,
-    exportDocument,
-    capabilities,
-    authenticate(candidateToken) {
-      return typeof candidateToken === "string" && tokenEquals(candidateToken, token);
-    },
-    createSessionResponse() {
-      return {
-        ok: true,
-        sessionId,
-        capabilities,
-        entry: exportDocument.entry,
-        projectRoot: normalizedProjectRoot,
-        exportDocument
-      };
-    },
-    readSource(context, fileName) {
-      return readSessionSource({ context, files, projectRoot: normalizedProjectRoot, fileName });
-    }
-  };
-};
-export {
-  createGraphCompatibleSourceHash,
-  createSessionToken,
-  createVisualizerSession,
-  isValidProjectFileName
-};

package/dist/visualize/static-assets.d.cts

@@ -1,17 +0,0 @@
-import type { CliContext } from "../cli/context.js";
-import type { CliDiagnostic } from "../cli/diagnostics.js";
-import type { VisualizerHttpResponse } from "./types.js";
-export type ServeStaticAssetOptions = {
-    staticRoot: string;
-    pathname: string;
-    method?: string;
-};
-export declare const defaultVisualizerStaticRoot: () => string;
-export declare const verifyVisualizerStaticArtifact: (context: CliContext, staticRoot?: string) => {
-    ok: true;
-    staticRoot: string;
-} | {
-    ok: false;
-    diagnostics: CliDiagnostic[];
-};
-export declare const serveStaticAsset: (context: CliContext, { staticRoot, pathname, method }: ServeStaticAssetOptions) => VisualizerHttpResponse;

package/dist/visualize/static-assets.d.ts

@@ -1,17 +0,0 @@
-import type { CliContext } from "../cli/context.js";
-import type { CliDiagnostic } from "../cli/diagnostics.js";
-import type { VisualizerHttpResponse } from "./types.js";
-export type ServeStaticAssetOptions = {
-    staticRoot: string;
-    pathname: string;
-    method?: string;
-};
-export declare const defaultVisualizerStaticRoot: () => string;
-export declare const verifyVisualizerStaticArtifact: (context: CliContext, staticRoot?: string) => {
-    ok: true;
-    staticRoot: string;
-} | {
-    ok: false;
-    diagnostics: CliDiagnostic[];
-};
-export declare const serveStaticAsset: (context: CliContext, { staticRoot, pathname, method }: ServeStaticAssetOptions) => VisualizerHttpResponse;

package/dist/visualize/static-assets.js

@@ -1,87 +0,0 @@
-import { extname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { cliDiagnostic } from "../cli/diagnostics.js";
-import { normalizeAbsolutePath } from "../project/source-cache.js";
-const MIME_BY_EXTENSION = {
-  ".html": "text/html; charset=utf-8",
-  ".js": "text/javascript; charset=utf-8",
-  ".css": "text/css; charset=utf-8",
-  ".svg": "image/svg+xml",
-  ".png": "image/png",
-  ".ico": "image/x-icon",
-  ".json": "application/json; charset=utf-8",
-  ".map": "application/json; charset=utf-8"
-};
-const textResponse = (status, body) => ({
-  status,
-  headers: { "content-type": "text/plain; charset=utf-8" },
-  body
-});
-const defaultVisualizerStaticRoot = () => {
-  return normalizeAbsolutePath(fileURLToPath(new URL("../visualizer", import.meta.url)));
-};
-const verifyVisualizerStaticArtifact = (context, staticRoot = defaultVisualizerStaticRoot()) => {
-  const root = normalizeAbsolutePath(staticRoot);
-  const indexPath = normalizeAbsolutePath(resolve(root, "index.html"));
-  if (context.fs.fileExists(indexPath)) return { ok: true, staticRoot: root };
-  return {
-    ok: false,
-    diagnostics: [
-      cliDiagnostic("LFC_VISUALIZER_STATIC_MISSING", "error", "Visualizer static artifact is missing.", {
-        file: indexPath,
-        hint: "Run the @lite-fsm/cli build pipeline so apps/visualizer/dist is copied to packages/cli/dist/visualizer."
-      })
-    ]
-  };
-};
-const decodePathname = (pathname) => {
-  try {
-    return decodeURIComponent(pathname);
-  } catch {
-    return void 0;
-  }
-};
-const bodyForFile = (context, fileName) => {
-  return context.fs.readFileBuffer?.(fileName) ?? Buffer.from(context.fs.readFile(fileName), "utf8");
-};
-const fileResponse = (context, fileName) => {
-  const extension = extname(fileName);
-  const contentType = MIME_BY_EXTENSION[extension];
-  if (!contentType) return textResponse(404, "Not found\n");
-  return {
-    status: 200,
-    headers: {
-      "content-type": contentType
-    },
-    body: bodyForFile(context, fileName)
-  };
-};
-const serveStaticAsset = (context, { staticRoot, pathname, method = "GET" }) => {
-  if (method !== "GET") {
-    return {
-      status: 405,
-      headers: {
-        "allow": "GET",
-        "content-type": "text/plain; charset=utf-8"
-      },
-      body: `Method ${method} is not allowed.
-`
-    };
-  }
-  const root = normalizeAbsolutePath(staticRoot);
-  const decodedPathname = decodePathname(pathname);
-  if (decodedPathname === void 0 || decodedPathname.includes("\\")) return textResponse(404, "Not found\n");
-  if (decodedPathname.split("/").some((segment) => segment === "." || segment === "..")) {
-    return textResponse(404, "Not found\n");
-  }
-  const isAssetRequest = decodedPathname === "/assets" || decodedPathname.startsWith("/assets/");
-  const relativePath = decodedPathname === "/" || !isAssetRequest ? "index.html" : decodedPathname.slice(1);
-  const fileName = normalizeAbsolutePath(resolve(root, relativePath));
-  if (!context.fs.fileExists(fileName)) return textResponse(404, "Not found\n");
-  return fileResponse(context, fileName);
-};
-export {
-  defaultVisualizerStaticRoot,
-  serveStaticAsset,
-  verifyVisualizerStaticArtifact
-};

package/dist/visualize/types.d.cts

@@ -1,65 +0,0 @@
-import type { URL } from "node:url";
-import type { CliContext } from "../cli/context.js";
-import type { LiteFsmProjectGraphExportDocument } from "../export-graph/export-document.js";
-import type { VisualizerSession } from "./session.js";
-export type VisualizeOptions = {
-    entry: string;
-    tsconfig?: string;
-    port: number;
-    noOpen: boolean;
-};
-export type VisualizerHostCapabilities = {
-    mode: "local";
-    canReadFiles: boolean;
-    canWriteFiles: boolean;
-    canApplyPatch: boolean;
-    projectRoot: string;
-};
-export type VisualizerSessionResponse = {
-    ok: true;
-    sessionId: string;
-    capabilities: VisualizerHostCapabilities;
-    entry: {
-        path: string;
-        tsconfigPath?: string;
-    };
-    projectRoot: string;
-    exportDocument: LiteFsmProjectGraphExportDocument;
-};
-export type VisualizerSourceResponse = {
-    ok: true;
-    fileName: string;
-    language: "ts";
-    hash: string;
-    text: string;
-};
-export type VisualizerErrorResponse = {
-    ok: false;
-    code: string;
-    message: string;
-};
-export type VisualizerHttpResponse = {
-    status: number;
-    headers?: Record<string, string>;
-    body?: string | Uint8Array;
-};
-export type VisualizerHttpRequest = {
-    method?: string;
-    url?: string;
-};
-export type VisualizerHttpResponseWriter = {
-    writeHead(statusCode: number, headers?: Record<string, string>): unknown;
-    end(data?: Uint8Array): unknown;
-};
-export type VisualizerRouteContext = {
-    request: VisualizerHttpRequest;
-    url: URL;
-    cliContext: CliContext;
-    session: VisualizerSession;
-};
-export type VisualizerRoute = {
-    method: "GET" | "POST";
-    path: string;
-    auth: "none" | "session";
-    handle(context: VisualizerRouteContext): Promise<VisualizerHttpResponse> | VisualizerHttpResponse;
-};

package/dist/visualize/types.d.ts

@@ -1,65 +0,0 @@
-import type { URL } from "node:url";
-import type { CliContext } from "../cli/context.js";
-import type { LiteFsmProjectGraphExportDocument } from "../export-graph/export-document.js";
-import type { VisualizerSession } from "./session.js";
-export type VisualizeOptions = {
-    entry: string;
-    tsconfig?: string;
-    port: number;
-    noOpen: boolean;
-};
-export type VisualizerHostCapabilities = {
-    mode: "local";
-    canReadFiles: boolean;
-    canWriteFiles: boolean;
-    canApplyPatch: boolean;
-    projectRoot: string;
-};
-export type VisualizerSessionResponse = {
-    ok: true;
-    sessionId: string;
-    capabilities: VisualizerHostCapabilities;
-    entry: {
-        path: string;
-        tsconfigPath?: string;
-    };
-    projectRoot: string;
-    exportDocument: LiteFsmProjectGraphExportDocument;
-};
-export type VisualizerSourceResponse = {
-    ok: true;
-    fileName: string;
-    language: "ts";
-    hash: string;
-    text: string;
-};
-export type VisualizerErrorResponse = {
-    ok: false;
-    code: string;
-    message: string;
-};
-export type VisualizerHttpResponse = {
-    status: number;
-    headers?: Record<string, string>;
-    body?: string | Uint8Array;
-};
-export type VisualizerHttpRequest = {
-    method?: string;
-    url?: string;
-};
-export type VisualizerHttpResponseWriter = {
-    writeHead(statusCode: number, headers?: Record<string, string>): unknown;
-    end(data?: Uint8Array): unknown;
-};
-export type VisualizerRouteContext = {
-    request: VisualizerHttpRequest;
-    url: URL;
-    cliContext: CliContext;
-    session: VisualizerSession;
-};
-export type VisualizerRoute = {
-    method: "GET" | "POST";
-    path: string;
-    auth: "none" | "session";
-    handle(context: VisualizerRouteContext): Promise<VisualizerHttpResponse> | VisualizerHttpResponse;
-};