@anlyx/core 0.1.3 → 0.1.5

package/README.md

@@ -1,5 +1,7 @@
 # @anlyx/core
 
-Core data contracts, runtime schemas, config normalization, fixture validation, and report aggregation for Anlyx.
+Core Project JSON schemas, validation, normalization, and local viewer data
+contracts for Anlyx.
 
-See the root Anlyx README for v0.1 usage and scope.
+The public product path is `anlyx.project.json -> validate -> import -> local
+4777 viewer`.

package/dist/flow-spec/normalize.d.ts

@@ -0,0 +1,7 @@
+import type { ReportData, ScanResult } from "../schema.js";
+import type { AnlyxFlowFile } from "./schema.js";
+export type NormalizeFlowFileToScanResult = (file: AnlyxFlowFile) => ScanResult;
+export type NormalizeFlowFileToReportData = (file: AnlyxFlowFile) => ReportData;
+export declare function normalizeFlowFileToScanResult(file: AnlyxFlowFile): ScanResult;
+export declare function normalizeFlowFileToReportData(file: AnlyxFlowFile): ReportData;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/flow-spec/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/flow-spec/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAMV,UAAU,EACV,UAAU,EACX,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EACV,aAAa,EAMd,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,6BAA6B,GAAG,CAAC,IAAI,EAAE,aAAa,KAAK,UAAU,CAAC;AAChF,MAAM,MAAM,6BAA6B,GAAG,CAAC,IAAI,EAAE,aAAa,KAAK,UAAU,CAAC;AAIhF,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,aAAa,GAAG,UAAU,CAU7E;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,aAAa,GAAG,UAAU,CAE7E"}

package/dist/flow-spec/normalize.js

@@ -0,0 +1,153 @@
+const API_NODE_TYPES = new Set(["api.request", "api.route"]);
+export function normalizeFlowFileToScanResult(file) {
+    return {
+        projectName: file.project.name,
+        generatedAt: file.snapshot?.createdAt ?? new Date().toISOString(),
+        schemaVersion: "0.1",
+        endpoints: file.flows.flatMap((flow) => flow.nodes.filter(isApiNode).map(toEndpoint)),
+        flows: file.flows.map((flow) => toEndpointFlow(flow, file)),
+        pages: [],
+        warnings: []
+    };
+}
+export function normalizeFlowFileToReportData(file) {
+    return normalizeFlowFileToScanResult(file);
+}
+function toEndpoint(node) {
+    const endpoint = parseEndpointLabel(node.label);
+    return {
+        id: node.id,
+        method: endpoint.method,
+        path: endpoint.path,
+        supportLevel: "basic",
+        confidence: confidenceFromStatus(node.status),
+        ...(node.request ? { requestSchema: "Flow JSON request" } : {}),
+        ...(node.response ? { responseSchema: "Flow JSON response" } : {})
+    };
+}
+function toEndpointFlow(flow, file) {
+    const endpointId = flow.nodes.find(isApiNode)?.id ?? flow.nodes[0]?.id ?? flow.id;
+    return {
+        endpointId,
+        nodes: flow.nodes.map((node) => toViewerNode(node, file)),
+        edges: flow.edges.map(toViewerEdge),
+        mainPath: buildMainPath(flow),
+        subFlows: []
+    };
+}
+function toViewerNode(node, file) {
+    const metadata = {
+        ...(node.metadata ?? {}),
+        flowJsonType: node.type
+    };
+    if (file.generatedBy) {
+        metadata.generatedBy = file.generatedBy;
+    }
+    if (file.snapshot) {
+        metadata.snapshot = file.snapshot;
+    }
+    return {
+        id: node.id,
+        type: toViewerNodeType(node.type),
+        label: node.label,
+        confidence: confidenceFromStatus(node.status),
+        status: node.status,
+        ...(node.timing ? { timing: node.timing } : {}),
+        ...(node.evidenceIds ? { evidenceIds: node.evidenceIds } : {}),
+        ...(node.request ? { request: node.request } : {}),
+        ...(node.response ? { response: node.response } : {}),
+        metadata
+    };
+}
+function toViewerEdge(edge, index) {
+    return {
+        id: edge.id ?? `edge:${edge.from}:${edge.to}:${index}`,
+        from: edge.from,
+        to: edge.to,
+        kind: "main",
+        ...(edge.label ? { label: edge.label } : {}),
+        confidence: confidenceFromStatus(edge.status),
+        status: edge.status,
+        ...(edge.timing ? { timing: edge.timing } : {}),
+        ...(edge.evidenceIds ? { evidenceIds: edge.evidenceIds } : {}),
+        ...(edge.metadata ? { metadata: edge.metadata } : {})
+    };
+}
+function buildMainPath(flow) {
+    const firstNode = flow.nodes[0];
+    if (!firstNode) {
+        return [];
+    }
+    const nodeIds = new Set(flow.nodes.map((node) => node.id));
+    const path = [firstNode.id];
+    const visited = new Set(path);
+    let current = firstNode.id;
+    for (let step = 0; step < flow.edges.length; step += 1) {
+        const nextEdge = flow.edges.find((edge) => edge.from === current);
+        if (!nextEdge || visited.has(nextEdge.to) || !nodeIds.has(nextEdge.to)) {
+            break;
+        }
+        path.push(nextEdge.to);
+        visited.add(nextEdge.to);
+        current = nextEdge.to;
+    }
+    return path;
+}
+function parseEndpointLabel(label) {
+    const match = /^(GET|POST|PUT|PATCH|DELETE)\s+(\S+)/.exec(label.trim());
+    if (!match) {
+        return {
+            method: "GET",
+            path: label
+        };
+    }
+    return {
+        method: match[1],
+        path: match[2]
+    };
+}
+function confidenceFromStatus(status) {
+    if (status === "observed" || status === "measured" || status === "source-matched") {
+        return "high";
+    }
+    if (status === "manual") {
+        return "medium";
+    }
+    if (status === "agent-inferred" || status === "not-proven") {
+        return "low";
+    }
+    return "unknown";
+}
+function isApiNode(node) {
+    return API_NODE_TYPES.has(node.type);
+}
+function toViewerNodeType(type) {
+    switch (type) {
+        case "ui.page":
+        case "ui.action":
+        case "ui.component":
+            return "page";
+        case "api.request":
+        case "api.route":
+            return "endpoint";
+        case "external":
+            return "externalApi";
+        case "response":
+        case "result":
+            return "schema";
+        case "middleware":
+        case "auth.session":
+        case "queue":
+        case "job":
+            return "utility";
+        case "controller":
+        case "service":
+        case "repository":
+        case "database":
+        case "unknown":
+            return type;
+        default:
+            return "unknown";
+    }
+}
+//# sourceMappingURL=normalize.js.map

package/dist/flow-spec/normalize.js.map

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