neuron-inspector 0.5.6 → 0.6.0

package/dist/collections/executor.js

@@ -0,0 +1,251 @@
+import { buildResolvedRequest, checkUnresolved } from "./resolver.js";
+import { dotGet } from "./assertions.js";
+// ── Single endpoint execution ───────────────────────────────────
+export async function executeEndpoint(opts) {
+    const { collection, environment, folder, endpoint, httpExecutor, pipeline, assertionEvaluator, scriptRunner, extracted } = opts;
+    let scriptVars = {};
+    // Run pre-request script
+    if (scriptRunner && endpoint.pre_request) {
+        const preResult = scriptRunner.runPreRequest(endpoint.pre_request, {
+            variables: { ...(extracted ?? {}) },
+        });
+        scriptVars = preResult.variables;
+    }
+    // Build resolved request (includes script-set vars)
+    const resolved = buildResolvedRequest({
+        collection,
+        environment,
+        folder,
+        endpoint,
+        pipeline,
+        extracted,
+        scriptVars,
+    });
+    // Check for unresolved variables (skip $-prefixed dynamic vars that returned placeholder text)
+    const unresolved = checkUnresolved(resolved);
+    if (unresolved.length > 0) {
+        return {
+            endpoint: { method: endpoint.method, path: endpoint.path, name: endpoint.name },
+            request: { url: resolved.url, method: resolved.method },
+            response: { status: 0, statusText: "error", headers: {}, body: null, timing: { total_ms: 0, ttfb_ms: 0 } },
+            error: `Unresolved variables: ${unresolved.join(", ")}`,
+        };
+    }
+    // Execute HTTP request
+    const response = await httpExecutor.execute(resolved);
+    // Parse body
+    let parsedBody = response.body;
+    if (response.body) {
+        try {
+            parsedBody = JSON.parse(response.body);
+        }
+        catch {
+            // Keep as string
+        }
+    }
+    const target = {
+        status: response.status,
+        headers: response.headers,
+        body: parsedBody,
+        timing: response.timing,
+    };
+    // Run post-response script
+    if (scriptRunner && endpoint.post_response) {
+        const postResult = scriptRunner.runPostResponse(endpoint.post_response, target, {
+            variables: { ...(extracted ?? {}), ...scriptVars },
+        });
+        Object.assign(scriptVars, postResult.variables);
+    }
+    // Run assertions
+    let assertions;
+    if (endpoint.tests?.length) {
+        assertions = endpoint.tests.map((t) => assertionEvaluator.evaluate(t, target));
+    }
+    // Extract variables
+    let extractedVars;
+    if (endpoint.extract) {
+        extractedVars = {};
+        for (const [varName, path] of Object.entries(endpoint.extract)) {
+            const value = dotGet(parsedBody, path.replace(/^body\./, ""));
+            if (value !== undefined && value !== null) {
+                extractedVars[varName] = String(value);
+            }
+        }
+    }
+    return {
+        endpoint: { method: endpoint.method, path: endpoint.path, name: endpoint.name },
+        request: { url: resolved.url, method: resolved.method },
+        response: {
+            status: response.status,
+            statusText: response.statusText,
+            headers: response.headers,
+            body: parsedBody,
+            timing: response.timing,
+        },
+        assertions,
+        extracted: {
+            ...(extractedVars ?? {}),
+            // Script-set variables also carry forward
+            ...(Object.keys(scriptVars).length > 0 ? scriptVars : {}),
+        },
+        error: response.status === 0 ? response.statusText : undefined,
+    };
+}
+// ── Folder execution ────────────────────────────────────────────
+export async function executeFolder(opts) {
+    const { folderKey, collection, environment, folder, httpExecutor, pipeline, assertionEvaluator, scriptRunner } = opts;
+    const extracted = { ...(opts.extracted ?? {}) };
+    const results = [];
+    let passed = 0;
+    let failed = 0;
+    let errors = 0;
+    for (const endpoint of folder.endpoints ?? []) {
+        const result = await executeEndpoint({
+            collection,
+            environment,
+            folder,
+            endpoint,
+            httpExecutor,
+            pipeline,
+            assertionEvaluator,
+            scriptRunner,
+            extracted,
+        });
+        // Accumulate extracted variables for subsequent endpoints
+        if (result.extracted) {
+            Object.assign(extracted, result.extracted);
+        }
+        // Count results
+        if (result.error) {
+            errors++;
+        }
+        else if (result.assertions?.some((a) => !a.passed)) {
+            failed++;
+        }
+        else {
+            passed++;
+        }
+        results.push(result);
+        // Folder execution continues on failure (unlike scenarios)
+    }
+    return { folder: folderKey, results, passed, failed, errors };
+}
+// ── Collection execution ────────────────────────────────────────
+export async function executeCollection(opts) {
+    const { collectionId, collection, environment, httpExecutor, pipeline, assertionEvaluator, scriptRunner } = opts;
+    const folders = [];
+    let totalPassed = 0;
+    let totalFailed = 0;
+    let totalErrors = 0;
+    for (const [folderKey, folder] of Object.entries(collection.folders ?? {})) {
+        const result = await executeFolder({
+            folderKey,
+            collection,
+            environment,
+            folder,
+            httpExecutor,
+            pipeline,
+            assertionEvaluator,
+            scriptRunner,
+        });
+        folders.push(result);
+        totalPassed += result.passed;
+        totalFailed += result.failed;
+        totalErrors += result.errors;
+    }
+    return {
+        collection: collectionId,
+        environment: collection.active_environment ?? "unknown",
+        folders,
+        total_passed: totalPassed,
+        total_failed: totalFailed,
+        total_errors: totalErrors,
+    };
+}
+// ── Scenario execution ──────────────────────────────────────────
+function resolveStepRef(collection, ref) {
+    // ref format: "folder/endpoint-name"
+    const slashIdx = ref.indexOf("/");
+    if (slashIdx < 0)
+        return null;
+    const folderKey = ref.slice(0, slashIdx);
+    const endpointName = ref.slice(slashIdx + 1);
+    const folder = collection.folders?.[folderKey];
+    if (!folder)
+        return null;
+    const endpoint = folder.endpoints?.find((ep) => ep.name === endpointName);
+    if (!endpoint)
+        return null;
+    return { folderKey, folder, endpoint };
+}
+export async function executeScenario(opts) {
+    const { scenarioKey, steps, collectionId, collection, environment, httpExecutor, pipeline, assertionEvaluator, scriptRunner } = opts;
+    const extracted = {};
+    const results = [];
+    let halted = false;
+    let haltedAt;
+    for (let i = 0; i < steps.length; i++) {
+        const step = steps[i];
+        const resolved = resolveStepRef(collection, step.ref);
+        if (!resolved) {
+            results.push({
+                step: i,
+                ref: step.ref,
+                endpoint: { method: "?", path: "?", name: step.ref },
+                request: { url: "", method: "" },
+                response: { status: 0, statusText: "error", headers: {}, body: null, timing: { total_ms: 0, ttfb_ms: 0 } },
+                error: `Could not resolve step ref '${step.ref}'`,
+            });
+            halted = true;
+            haltedAt = i;
+            break;
+        }
+        // Apply step overrides
+        let endpoint = { ...resolved.endpoint };
+        if (step.overrides) {
+            if (step.overrides.path)
+                endpoint.path = step.overrides.path;
+            if (step.overrides.headers)
+                endpoint = { ...endpoint, headers: { ...endpoint.headers, ...step.overrides.headers } };
+            if (step.overrides.body !== undefined)
+                endpoint.body = step.overrides.body;
+            if (step.overrides.tests)
+                endpoint.tests = step.overrides.tests;
+            if (step.overrides.variables)
+                endpoint.variables = { ...endpoint.variables, ...step.overrides.variables };
+        }
+        const result = await executeEndpoint({
+            collection,
+            environment,
+            folder: resolved.folder,
+            endpoint,
+            httpExecutor,
+            scriptRunner,
+            pipeline,
+            assertionEvaluator,
+            extracted,
+        });
+        // Accumulate extracted variables
+        if (result.extracted) {
+            Object.assign(extracted, result.extracted);
+        }
+        results.push({ ...result, step: i, ref: step.ref });
+        // Check if this step failed (HTTP error or assertion failure)
+        const stepFailed = result.error || result.assertions?.some((a) => !a.passed);
+        if (stepFailed) {
+            halted = true;
+            haltedAt = i;
+            break;
+        }
+    }
+    return {
+        scenario: scenarioKey,
+        collection: collectionId,
+        environment: collection.active_environment ?? "unknown",
+        steps: results,
+        passed: !halted,
+        halted_at: haltedAt,
+        extracted,
+    };
+}
+//# sourceMappingURL=executor.js.map

package/dist/collections/executor.js.map

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

package/dist/collections/http.d.ts

@@ -0,0 +1,4 @@
+import type { HttpExecutor, ResolvedRequest, HttpResponse } from "./types.js";
+export declare class FetchHttpExecutor implements HttpExecutor {
+    execute(request: ResolvedRequest): Promise<HttpResponse>;
+}

package/dist/collections/http.js

@@ -0,0 +1,84 @@
+const MAX_BODY_BYTES = 100 * 1024; // 100KB truncation limit
+const MAX_REDIRECTS = 5;
+export class FetchHttpExecutor {
+    async execute(request) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), request.timeout_ms);
+        const startTime = performance.now();
+        let ttfbTime = 0;
+        try {
+            const res = await fetch(request.url, {
+                method: request.method,
+                headers: request.headers,
+                body: request.body ?? undefined,
+                signal: controller.signal,
+                redirect: "follow",
+                // @ts-expect-error -- Node.js fetch supports follow limit
+                follow: MAX_REDIRECTS,
+            });
+            ttfbTime = performance.now() - startTime;
+            // Read body with truncation
+            let body = null;
+            try {
+                const raw = await res.text();
+                if (raw.length > MAX_BODY_BYTES) {
+                    body = raw.slice(0, MAX_BODY_BYTES) + `\n...[truncated at ${MAX_BODY_BYTES} bytes]`;
+                }
+                else {
+                    body = raw;
+                }
+            }
+            catch {
+                body = null;
+            }
+            const totalTime = performance.now() - startTime;
+            // Flatten response headers to Record<string, string>
+            const headers = {};
+            res.headers.forEach((value, key) => {
+                headers[key.toLowerCase()] = value;
+            });
+            return {
+                status: res.status,
+                statusText: res.statusText,
+                headers,
+                body,
+                timing: {
+                    total_ms: Math.round(totalTime),
+                    ttfb_ms: Math.round(ttfbTime),
+                },
+            };
+        }
+        catch (err) {
+            const totalTime = performance.now() - startTime;
+            clearTimeout(timer);
+            if (err instanceof DOMException && err.name === "AbortError") {
+                return {
+                    status: 0,
+                    statusText: "timeout",
+                    headers: {},
+                    body: null,
+                    timing: {
+                        total_ms: request.timeout_ms,
+                        ttfb_ms: 0,
+                    },
+                };
+            }
+            // Connection refused, DNS failure, TLS errors, etc.
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                status: 0,
+                statusText: "error",
+                headers: {},
+                body: JSON.stringify({ error: message }),
+                timing: {
+                    total_ms: Math.round(totalTime),
+                    ttfb_ms: 0,
+                },
+            };
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/collections/http.js.map

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

package/dist/collections/index.d.ts

@@ -0,0 +1,12 @@
+export type { CollectionToolDef } from "./tools.js";
+export declare const COLLECTION_TOOLS: import("./tools.js").CollectionToolDef[];
+export declare const handleCollectionTool: (name: string, args: Record<string, unknown>) => Promise<unknown>;
+export type { Collection, CollectionStore, CollectionSummary, Endpoint, Folder, Environment, Scenario, HttpExecutor, ResolverStep, ResolverContext, ResolvedRequest, HttpResponse, AssertionEvaluator, AssertionResult, AssertionTarget, DynamicVarProvider, ScriptRunner, } from "./types.js";
+export { YamlCollectionStore, slugify, generateEndpointName } from "./store.js";
+export { FetchHttpExecutor } from "./http.js";
+export { buildDefaultPipeline, buildResolvedRequest, resolveTemplate, checkUnresolved } from "./resolver.js";
+export { OperatorRegistry, dotGet, extractCheckValue } from "./assertions.js";
+export { buildDefaultRegistry, DynamicVarRegistry } from "./dynamic-vars.js";
+export { DeclarativeScriptRunner } from "./scripts.js";
+export { executeEndpoint, executeFolder, executeCollection, executeScenario } from "./executor.js";
+export { fromPostmanV21, toPostmanV21 } from "./postman.js";

package/dist/collections/index.js

@@ -0,0 +1,27 @@
+import { YamlCollectionStore } from "./store.js";
+import { FetchHttpExecutor } from "./http.js";
+import { buildDefaultPipeline } from "./resolver.js";
+import { OperatorRegistry } from "./assertions.js";
+import { buildDefaultRegistry } from "./dynamic-vars.js";
+import { DeclarativeScriptRunner } from "./scripts.js";
+import { buildCollectionTools, buildCollectionHandler } from "./tools.js";
+// ── Composition root ────────────────────────────────────────────
+// All concrete implementations are wired here.
+// Nothing outside this file imports a concrete class directly.
+const store = new YamlCollectionStore();
+const httpExecutor = new FetchHttpExecutor();
+const dynamicVarRegistry = buildDefaultRegistry();
+const pipeline = buildDefaultPipeline(dynamicVarRegistry);
+const assertionEvaluator = new OperatorRegistry();
+const scriptRunner = new DeclarativeScriptRunner();
+export const COLLECTION_TOOLS = buildCollectionTools();
+export const handleCollectionTool = buildCollectionHandler(store, httpExecutor, pipeline, assertionEvaluator, scriptRunner);
+export { YamlCollectionStore, slugify, generateEndpointName } from "./store.js";
+export { FetchHttpExecutor } from "./http.js";
+export { buildDefaultPipeline, buildResolvedRequest, resolveTemplate, checkUnresolved } from "./resolver.js";
+export { OperatorRegistry, dotGet, extractCheckValue } from "./assertions.js";
+export { buildDefaultRegistry, DynamicVarRegistry } from "./dynamic-vars.js";
+export { DeclarativeScriptRunner } from "./scripts.js";
+export { executeEndpoint, executeFolder, executeCollection, executeScenario } from "./executor.js";
+export { fromPostmanV21, toPostmanV21 } from "./postman.js";
+//# sourceMappingURL=index.js.map

package/dist/collections/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/collections/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAI1E,mEAAmE;AACnE,+CAA+C;AAC/C,+DAA+D;AAE/D,MAAM,KAAK,GAAG,IAAI,mBAAmB,EAAE,CAAC;AACxC,MAAM,YAAY,GAAG,IAAI,iBAAiB,EAAE,CAAC;AAC7C,MAAM,kBAAkB,GAAG,oBAAoB,EAAE,CAAC;AAClD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,kBAAkB,CAAC,CAAC;AAC1D,MAAM,kBAAkB,GAAG,IAAI,gBAAgB,EAAE,CAAC;AAClD,MAAM,YAAY,GAAG,IAAI,uBAAuB,EAAE,CAAC;AAEnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,EAAE,CAAC;AACvD,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,kBAAkB,EAAE,YAAY,CAAC,CAAC;AAuB5H,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7G,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACnG,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/collections/postman.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Postman Collection v2.1 ↔ Neuron Collection converter.
+ *
+ * Two pure functions — no dependencies beyond the Collection types.
+ */
+import type { Collection } from "./types.js";
+/** Parse a Postman v2.1 JSON object into a Neuron Collection. */
+export declare function fromPostmanV21(json: unknown): Collection;
+/** Convert a Neuron Collection to Postman v2.1 JSON. */
+export declare function toPostmanV21(collection: Collection, id: string): unknown;