@innovatorstack/harness 0.0.0-stage → 0.1.1

package/dist/instrumentation/recorder.js

@@ -0,0 +1,372 @@
+import { appliedItem } from "../platform/request.js";
+import { describeFailure } from "./failures.js";
+import { Snapshots } from "./snapshots.js";
+import { ExecutionKind, ExecutionMode, ExecutionOutcome, ExecutionStatus } from "./types.js";
+const defaults = Object.freeze({
+    requests: 100,
+    calls: 2000,
+    events: 5000,
+    bytes: 1_048_576,
+    snapshotBytes: 65_536,
+    depth: 32,
+});
+const setupOperations = new Set([
+    "packages.import",
+    "packages.setup",
+    "fixtures.load",
+    "platform.seed",
+    "platform.seedRecords",
+]);
+/** Owns bounded, immutable reports. The dispatcher owns execution and transactions. */
+export class ExecutionRecorder {
+    now;
+    active = new Map();
+    reports = [];
+    limits;
+    constructor(limits = {}, now = () => new Date()) {
+        this.now = now;
+        this.limits = { ...defaults, ...limits };
+    }
+    get executions() {
+        return Object.freeze([...this.reports]);
+    }
+    started(execution, input) {
+        if (!execution.parentExecutionId) {
+            if (setupOperations.has(execution.operation)) {
+                return;
+            }
+            this.active.set(execution.requestId, {
+                id: crypto.randomUUID(),
+                requestId: execution.requestId,
+                startedAt: this.now().toISOString(),
+                started: performance.now(),
+                snapshots: new Snapshots(this.limits),
+                calls: new Map(),
+                changes: [],
+                mocks: [],
+                failures: [],
+                bindings: new Map(),
+                omitted: { calls: 0, changes: 0, mocks: 0, failures: 0, events: 0 },
+                events: 0,
+            });
+        }
+        const request = this.active.get(execution.requestId);
+        if (!request) {
+            return;
+        }
+        if (request.calls.size >= this.limits.calls) {
+            request.omitted.calls += 1;
+            return;
+        }
+        const captured = request.snapshots.value(input);
+        const via = execution.parentExecutionId
+            ? request.bindings.get(execution.parentExecutionId)
+            : undefined;
+        if (execution.parentExecutionId && execution.operation === "platform.method") {
+            request.bindings.delete(execution.parentExecutionId);
+        }
+        request.calls.set(execution.executionId, {
+            execution,
+            started: performance.now(),
+            name: operationName(execution.operation, input),
+            kind: operationKind(execution.operation),
+            mode: ExecutionMode.Real,
+            status: ExecutionStatus.Succeeded,
+            durationMs: 0,
+            executed: false,
+            events: [],
+            ...(captured === undefined ? {} : { input: captured }),
+            ...(via && execution.operation === "platform.method" ? { via } : {}),
+        });
+    }
+    completed(execution, result) {
+        const request = this.active.get(execution.requestId);
+        const call = request?.calls.get(execution.executionId);
+        if (!request || !call) {
+            return;
+        }
+        call.durationMs = performance.now() - call.started;
+        const captured = request.snapshots.value(result);
+        if (captured !== undefined) {
+            call.result = captured;
+        }
+    }
+    failed(execution, error) {
+        const request = this.active.get(execution.requestId);
+        const call = request?.calls.get(execution.executionId);
+        if (!request) {
+            return;
+        }
+        request.firstFailureId ??= execution.executionId;
+        if (call) {
+            call.durationMs = performance.now() - call.started;
+            call.status = ExecutionStatus.Failed;
+            call.error = error;
+        }
+    }
+    record(event) {
+        const request = this.active.get(event.requestId);
+        if (!request) {
+            return;
+        }
+        request.events += 1;
+        if (request.events > this.limits.events) {
+            if (event.kind === "mutation") {
+                request.omitted.changes += 1;
+            }
+            else if (event.kind === "mock") {
+                request.omitted.mocks += 1;
+            }
+            else {
+                request.omitted.events += 1;
+            }
+            return;
+        }
+        const call = request.calls.get(event.executionId);
+        if (call) {
+            this.describeCall(call, event);
+            if (event.result) {
+                const captured = request.snapshots.value(event.result);
+                if (captured !== undefined) {
+                    call.result = captured;
+                }
+            }
+        }
+        this.recordBinding(request, call, event);
+        this.recordChange(request, event);
+        this.recordMock(request, event);
+    }
+    settled(requestId, transaction, error) {
+        const request = this.active.get(requestId);
+        if (!request) {
+            return;
+        }
+        this.active.delete(requestId);
+        const outcome = transactionOutcome(transaction);
+        const failureId = request.firstFailureId;
+        const failureChain = this.chain(request, failureId && request.calls.has(failureId) ? failureId : requestId);
+        const failure = error === undefined
+            ? undefined
+            : describeFailure(error, failureChain, request.snapshots);
+        const calls = this.finishCalls(request);
+        const omitted = Object.freeze({ ...request.omitted, snapshots: request.snapshots.omitted });
+        const report = Object.freeze({
+            id: request.id,
+            requestId,
+            startedAt: request.startedAt,
+            durationMs: performance.now() - request.started,
+            outcome,
+            calls,
+            changes: Object.freeze(request.changes.map((change) => Object.freeze({ ...change, outcome }))),
+            mocks: Object.freeze([...request.mocks]),
+            failures: Object.freeze([...request.failures]),
+            ...(failure ? { error: failure } : {}),
+            truncated: Object.values(omitted).some((count) => count > 0),
+            omitted,
+        });
+        this.reports.push(report);
+        if (this.reports.length > this.limits.requests) {
+            this.reports.shift();
+        }
+    }
+    injected(execution, evidence, target) {
+        const request = this.active.get(execution.requestId);
+        if (!request) {
+            return;
+        }
+        if (request.failures.length >= this.limits.calls) {
+            request.omitted.failures += 1;
+            return;
+        }
+        request.failures.push(evidence);
+        const call = request.calls.get(execution.executionId);
+        if (call) {
+            call.name = target.name;
+            if (target.kind === "sql") {
+                call.kind = ExecutionKind.Sql;
+            }
+            if (target.source) {
+                call.source = Object.freeze({ ...target.source });
+            }
+            if (target.definition) {
+                call.definition = Object.freeze({ ...target.definition });
+            }
+            if (target.sourceHash) {
+                call.sourceHash = target.sourceHash;
+            }
+        }
+    }
+    reset() {
+        this.active.clear();
+        this.reports.length = 0;
+    }
+    recordBinding(request, call, event) {
+        if (event.kind === "event" || event.kind === "authorization") {
+            const binding = Object.freeze({
+                kind: event.kind,
+                name: event.name,
+                ...(event.source ? { source: Object.freeze({ ...event.source }) } : {}),
+            });
+            call?.events.push(binding);
+            if (event.kind === "event") {
+                request.bindings.set(event.executionId, binding);
+            }
+        }
+    }
+    recordChange(request, event) {
+        if (event.kind === "mutation") {
+            const before = event.before ? request.snapshots.record(event.before) : undefined;
+            const after = event.after ? request.snapshots.record(event.after) : undefined;
+            request.changes.push(Object.freeze({
+                executionId: event.executionId,
+                name: event.name,
+                ...(before ? { before } : {}),
+                ...(after ? { after } : {}),
+            }));
+        }
+    }
+    recordMock(request, event) {
+        if (event.kind === "mock" && event.mock) {
+            const parameters = request.snapshots.record(event.mock.parameters);
+            request.mocks.push(Object.freeze({
+                executionId: event.executionId,
+                name: event.name,
+                definition: event.mock.definition,
+                responseHash: event.mock.responseHash,
+                ...(parameters ? { parameters } : {}),
+                ...(event.mock.responseFile ? { responseFile: event.mock.responseFile } : {}),
+            }));
+        }
+    }
+    describeCall(call, event) {
+        if (event.kind === "method" || event.kind === "execution") {
+            call.kind = ExecutionKind.Method;
+            call.name = event.name;
+        }
+        else if (event.kind === "action") {
+            call.kind = event.name.startsWith("SQL Process:")
+                ? ExecutionKind.Sql
+                : ExecutionKind.Action;
+            call.name = event.name;
+        }
+        else if (event.kind === "mock") {
+            call.mode = ExecutionMode.Mocked;
+            call.name = event.name;
+        }
+        if (["method", "execution", "action", "mock"].includes(event.kind)) {
+            if (event.source) {
+                call.source = Object.freeze({ ...event.source });
+            }
+            if (event.sourceHash) {
+                call.sourceHash = event.sourceHash;
+            }
+            if (event.definition) {
+                call.definition = Object.freeze({ ...event.definition });
+                call.kind =
+                    event.definition.type === "Method" ? ExecutionKind.Method : ExecutionKind.Sql;
+            }
+        }
+        if (event.kind === "execution") {
+            call.executed = true;
+        }
+    }
+    finishCalls(request) {
+        const children = new Map();
+        const roots = [];
+        for (const call of [...request.calls.values()].reverse()) {
+            const finished = this.finishCall(request, call, children.get(call.execution.executionId) ?? []);
+            const parentId = call.execution.parentExecutionId;
+            if (parentId && request.calls.has(parentId)) {
+                let siblings = children.get(parentId);
+                if (!siblings) {
+                    siblings = [];
+                    children.set(parentId, siblings);
+                }
+                siblings.unshift(finished);
+            }
+            else {
+                roots.unshift(finished);
+            }
+        }
+        return Object.freeze(roots);
+    }
+    finishCall(request, call, children) {
+        const { execution, started: _started, error, ...details } = call;
+        const finished = {
+            ...details,
+            executionId: execution.executionId,
+            operation: execution.operation,
+            events: Object.freeze([...call.events]),
+            children: Object.freeze(children),
+        };
+        if (execution.parentExecutionId) {
+            finished.parentExecutionId = execution.parentExecutionId;
+        }
+        if (error !== undefined) {
+            finished.error = describeFailure(error, this.chain(request, execution.executionId), request.snapshots);
+        }
+        return Object.freeze(finished);
+    }
+    chain(request, executionId) {
+        const result = [];
+        let call = request.calls.get(executionId);
+        while (call) {
+            result.unshift(Object.freeze({
+                executionId: call.execution.executionId,
+                name: call.name,
+                ...(call.source ? { source: call.source } : {}),
+            }));
+            call = call.execution.parentExecutionId
+                ? request.calls.get(call.execution.parentExecutionId)
+                : undefined;
+        }
+        return Object.freeze(result);
+    }
+}
+function operationKind(operation) {
+    if (operation === "platform.method") {
+        return ExecutionKind.Method;
+    }
+    if (operation === "platform.apply" || operation === "platform.event-base") {
+        return ExecutionKind.Action;
+    }
+    if (operation === "platform.aml") {
+        return ExecutionKind.Aml;
+    }
+    if (operation === "platform.sql") {
+        return ExecutionKind.Sql;
+    }
+    return ExecutionKind.Operation;
+}
+function operationName(operation, input) {
+    const item = appliedItem(operation, input);
+    if (item) {
+        const node = item.payload.items[0];
+        if (node) {
+            return `${node.type}.${node.attributes.action ?? "get"}`;
+        }
+    }
+    if (input !== null && typeof input === "object") {
+        const key = operation === "platform.method" ? "name" : "method";
+        const name = Object.getOwnPropertyDescriptor(input, key)?.value;
+        if (typeof name === "string") {
+            if (operation === "platform.method") {
+                return name;
+            }
+            if (operation === "platform.sql") {
+                return `SQL: ${name}`;
+            }
+        }
+    }
+    return operation;
+}
+function transactionOutcome(outcome) {
+    if (outcome === "committed") {
+        return ExecutionOutcome.Committed;
+    }
+    if (outcome === "rolledBack") {
+        return ExecutionOutcome.RolledBack;
+    }
+    return ExecutionOutcome.Unknown;
+}
+//# sourceMappingURL=recorder.js.map

package/dist/instrumentation/recorder.js.map

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

package/dist/instrumentation/snapshots.d.ts

@@ -0,0 +1,20 @@
+import type { ExecutionValue } from "./types.js";
+export interface SnapshotLimits {
+    readonly bytes: number;
+    readonly snapshotBytes: number;
+    readonly depth: number;
+}
+/** Bounded copies never call user getters or retain live request/result objects. */
+export declare class Snapshots {
+    private readonly limits;
+    private bytes;
+    omitted: number;
+    constructor(limits: SnapshotLimits);
+    value(value: unknown): ExecutionValue | undefined;
+    record<Value extends object>(value: Value): Value | undefined;
+    private copy;
+    private copyStep;
+    private copyChildren;
+    private reserve;
+}
+//# sourceMappingURL=snapshots.d.ts.map

package/dist/instrumentation/snapshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.d.ts","sourceRoot":"","sources":["../../src/instrumentation/snapshots.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B;AAyBD,oFAAoF;AACpF,qBAAa,SAAS;IAIN,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,SAAK;IAEZ,YAA6B,MAAM,EAAE,cAAc,EAMlD;IAED,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAoBhD;IAED,MAAM,CAAC,KAAK,SAAS,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAO5D;IAED,OAAO,CAAC,IAAI;IAoCZ,OAAO,CAAC,QAAQ;IAuChB,OAAO,CAAC,YAAY;IAgEpB,OAAO,CAAC,OAAO;CAUlB"}

package/dist/instrumentation/snapshots.js

@@ -0,0 +1,177 @@
+import { cloneFrozenData, isFrozenData, setOwn, getOwn } from "../core/data.js";
+import { dataNodesMax } from "../core/limits.js";
+import { Item } from "../items/item.js";
+class SnapshotIssueError extends Error {
+    name = "SnapshotIssueError";
+}
+/** Bounded copies never call user getters or retain live request/result objects. */
+export class Snapshots {
+    limits;
+    bytes = 0;
+    omitted = 0;
+    constructor(limits) {
+        this.limits = limits;
+        for (const limit of [limits.bytes, limits.snapshotBytes, limits.depth]) {
+            if (!Number.isSafeInteger(limit) || limit < 1) {
+                throw new TypeError("Snapshot limits must be positive safe integers.");
+            }
+        }
+    }
+    value(value) {
+        if (value === undefined) {
+            return undefined;
+        }
+        try {
+            const state = { bytes: 0, nodes: 0, ancestors: new Set() };
+            const result = this.copy(value, state);
+            this.bytes += state.bytes;
+            return result;
+        }
+        catch (error) {
+            if (!(error instanceof SnapshotIssueError)) {
+                throw error;
+            }
+            this.omitted += 1;
+            return undefined;
+        }
+    }
+    record(value) {
+        // Platform records are validated data. Their public types survive native cloning.
+        if (this.value(value) === undefined) {
+            return undefined;
+        }
+        return isFrozenData(value) ? value : cloneFrozenData(value);
+    }
+    copy(value, state) {
+        let result;
+        const pending = [
+            {
+                kind: "copy",
+                value,
+                depth: 0,
+                write: (value) => {
+                    result = value;
+                },
+            },
+        ];
+        while (pending.length > 0) {
+            const task = pending.pop();
+            if (!task) {
+                throw new Error("A snapshot task must exist while traversal is pending.");
+            }
+            if (task.kind === "close") {
+                state.ancestors.delete(task.source);
+                Object.freeze(task.output);
+            }
+            else {
+                this.copyStep(task, state, pending);
+            }
+        }
+        if (result === undefined) {
+            throw new Error("A completed snapshot must have a value.");
+        }
+        return result;
+    }
+    copyStep(task, state, pending) {
+        state.nodes += 1;
+        if (task.depth > this.limits.depth || state.nodes > dataNodesMax) {
+            throw new SnapshotIssueError("Snapshot traversal limit");
+        }
+        const value = task.value;
+        if (value instanceof Item) {
+            pending.push({ ...task, value: value.payload });
+            return;
+        }
+        if (value === null || typeof value === "boolean") {
+            this.reserve(state, 5);
+            task.write(value);
+        }
+        else if (typeof value === "number" && Number.isFinite(value)) {
+            this.reserve(state, 24);
+            task.write(value);
+        }
+        else if (typeof value === "string") {
+            this.reserve(state, value.length * 3 + 2);
+            task.write(value);
+        }
+        else if (typeof value === "object" && value !== null) {
+            if (state.ancestors.has(value)) {
+                throw new SnapshotIssueError("Snapshot is not a finite data tree");
+            }
+            this.copyChildren(value, task, state, pending);
+        }
+        else {
+            throw new SnapshotIssueError("Snapshot has an unsupported value");
+        }
+    }
+    copyChildren(value, task, state, pending) {
+        const descriptors = snapshotDescriptors(value);
+        state.ancestors.add(value);
+        if (Array.isArray(value)) {
+            const output = [];
+            task.write(output);
+            pending.push({ kind: "close", source: value, output });
+            for (let index = value.length - 1; index >= 0; index -= 1) {
+                const descriptor = getOwn(descriptors, String(index));
+                if (!descriptor || descriptor.get || descriptor.set) {
+                    throw new SnapshotIssueError("Snapshot accessor or sparse array");
+                }
+                this.reserve(state, 1);
+                pending.push({
+                    kind: "copy",
+                    value: descriptor.value,
+                    depth: task.depth + 1,
+                    write: (value) => {
+                        output[index] = value;
+                    },
+                });
+            }
+            return;
+        }
+        const output = {};
+        task.write(output);
+        pending.push({ kind: "close", source: value, output });
+        for (const [name, descriptor] of Object.entries(descriptors).reverse()) {
+            if (!descriptor.enumerable) {
+                continue;
+            }
+            if (descriptor.get || descriptor.set) {
+                throw new SnapshotIssueError("Snapshot accessor");
+            }
+            if (descriptor.value === undefined) {
+                continue;
+            }
+            this.reserve(state, name.length * 3 + 3);
+            pending.push({
+                kind: "copy",
+                value: descriptor.value,
+                depth: task.depth + 1,
+                write: (value) => setOwn(output, name, value),
+            });
+        }
+    }
+    reserve(state, bytes) {
+        state.bytes += bytes;
+        if (state.bytes > this.limits.snapshotBytes ||
+            this.bytes + state.bytes > this.limits.bytes) {
+            throw new SnapshotIssueError("Snapshot size limit");
+        }
+    }
+}
+function snapshotDescriptors(value) {
+    try {
+        if (!Array.isArray(value) && !isPlainObject(value)) {
+            throw new SnapshotIssueError("Snapshot has an unsupported prototype");
+        }
+        return Object.getOwnPropertyDescriptors(value);
+    }
+    catch (error) {
+        // Reflection on a Proxy can fail even when no getter is evaluated.
+        throw new SnapshotIssueError("Snapshot reflection failed", { cause: error });
+    }
+}
+function isPlainObject(value) {
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+//# sourceMappingURL=snapshots.js.map

package/dist/instrumentation/snapshots.js.map

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