@probemap/shared 0.1.0

package/dist/protocol/event-batch.d.ts

@@ -0,0 +1,102 @@
+import { z } from "zod";
+export declare const eventBatchSchema: z.ZodObject<{
+    projectId: z.ZodUUID;
+    sessionId: z.ZodUUID;
+    events: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        protocolVersion: z.ZodString;
+        sdkVersion: z.ZodString;
+        payloadSchemaId: z.ZodOptional<z.ZodString>;
+        projectId: z.ZodUUID;
+        sessionId: z.ZodUUID;
+        flowId: z.ZodOptional<z.ZodUUID>;
+        flowContractVersionId: z.ZodOptional<z.ZodUUID>;
+        probeDefinitionId: z.ZodOptional<z.ZodUUID>;
+        traceId: z.ZodString;
+        spanId: z.ZodString;
+        parentSpanId: z.ZodOptional<z.ZodString>;
+        linkedSpanIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        runtimeId: z.ZodString;
+        processId: z.ZodOptional<z.ZodString>;
+        threadId: z.ZodOptional<z.ZodString>;
+        clientSequence: z.ZodNumber;
+        clientTimestamp: z.ZodISODateTime;
+        monotonicTime: z.ZodNumber;
+        serverReceivedAt: z.ZodOptional<z.ZodISODateTime>;
+        type: z.ZodEnum<{
+            "action.click": "action.click";
+            "action.double_click": "action.double_click";
+            "action.drag_end": "action.drag_end";
+            "action.drag_move": "action.drag_move";
+            "action.drag_start": "action.drag_start";
+            "action.drop": "action.drop";
+            "action.input": "action.input";
+            "action.keypress": "action.keypress";
+            "action.navigation": "action.navigation";
+            "bug.recorded": "bug.recorded";
+            "console.error": "console.error";
+            "console.log": "console.log";
+            "console.warn": "console.warn";
+            "diagnosis.created": "diagnosis.created";
+            "flow.end": "flow.end";
+            "flow.start": "flow.start";
+            "git.snapshot": "git.snapshot";
+            "network.error": "network.error";
+            "network.request": "network.request";
+            "network.response": "network.response";
+            "performance.long_task": "performance.long_task";
+            "probe.assert": "probe.assert";
+            "probe.observe": "probe.observe";
+            "probe.step": "probe.step";
+            "runtime.exception": "runtime.exception";
+            "session.end": "session.end";
+            "session.start": "session.start";
+            "state.snapshot": "state.snapshot";
+            "verification.created": "verification.created";
+            "visual.snapshot": "visual.snapshot";
+        }>;
+        source: z.ZodEnum<{
+            adapter: "adapter";
+            "browser-sdk": "browser-sdk";
+            cli: "cli";
+            collector: "collector";
+            mcp: "mcp";
+            "node-sdk": "node-sdk";
+        }>;
+        status: z.ZodOptional<z.ZodEnum<{
+            fail: "fail";
+            not_reached: "not_reached";
+            pass: "pass";
+            skipped: "skipped";
+            unknown: "unknown";
+            warn: "warn";
+        }>>;
+        name: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+        payload: z.ZodOptional<z.ZodUnknown>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        relatedObjectIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        stackTrace: z.ZodOptional<z.ZodString>;
+        fileHints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            reason: z.ZodString;
+            confidence: z.ZodNumber;
+            source: z.ZodEnum<{
+                discovery: "discovery";
+                git: "git";
+                heuristic: "heuristic";
+                probe: "probe";
+                stack: "stack";
+            }>;
+            line: z.ZodOptional<z.ZodNumber>;
+            column: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>>;
+        privacyLevel: z.ZodEnum<{
+            redacted: "redacted";
+            safe: "safe";
+            sensitive: "sensitive";
+        }>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type EventBatch = z.infer<typeof eventBatchSchema>;
+//# sourceMappingURL=event-batch.d.ts.map

package/dist/protocol/event-batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-batch.d.ts","sourceRoot":"","sources":["../../src/protocol/event-batch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA8CzB,CAAC;AAEL,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/protocol/event-batch.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { probeMapEventSchema } from "./event.js";
+export const eventBatchSchema = z
+    .strictObject({
+    projectId: z.uuid(),
+    sessionId: z.uuid(),
+    events: z.array(probeMapEventSchema).min(1).max(1_000),
+})
+    .superRefine((batch, context) => {
+    const eventIds = new Set();
+    const sequences = new Set();
+    batch.events.forEach((event, index) => {
+        if (event.projectId !== batch.projectId) {
+            context.addIssue({
+                code: "custom",
+                path: ["events", index, "projectId"],
+                message: "Event projectId must match its batch projectId.",
+            });
+        }
+        if (event.sessionId !== batch.sessionId) {
+            context.addIssue({
+                code: "custom",
+                path: ["events", index, "sessionId"],
+                message: "Event sessionId must match its batch sessionId.",
+            });
+        }
+        if (eventIds.has(event.id)) {
+            context.addIssue({
+                code: "custom",
+                path: ["events", index, "id"],
+                message: "Event IDs must be unique inside a batch.",
+            });
+        }
+        if (sequences.has(event.clientSequence)) {
+            context.addIssue({
+                code: "custom",
+                path: ["events", index, "clientSequence"],
+                message: "Client sequences must be unique inside a batch.",
+            });
+        }
+        eventIds.add(event.id);
+        sequences.add(event.clientSequence);
+    });
+});
+//# sourceMappingURL=event-batch.js.map

package/dist/protocol/event-batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-batch.js","sourceRoot":"","sources":["../../src/protocol/event-batch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC9B,YAAY,CAAC;IACZ,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE;IACnB,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;CACvD,CAAC;KACD,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IAC9B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAEpC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACpC,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,EAAE,CAAC;YACxC,OAAO,CAAC,QAAQ,CAAC;gBACf,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC;gBACpC,OAAO,EAAE,iDAAiD;aAC3D,CAAC,CAAC;QACL,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,EAAE,CAAC;YACxC,OAAO,CAAC,QAAQ,CAAC;gBACf,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC;gBACpC,OAAO,EAAE,iDAAiD;aAC3D,CAAC,CAAC;QACL,CAAC;QAED,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,QAAQ,CAAC;gBACf,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC;gBAC7B,OAAO,EAAE,0CAA0C;aACpD,CAAC,CAAC;QACL,CAAC;QAED,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;YACxC,OAAO,CAAC,QAAQ,CAAC;gBACf,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,gBAAgB,CAAC;gBACzC,OAAO,EAAE,iDAAiD;aAC3D,CAAC,CAAC;QACL,CAAC;QAED,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACvB,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/protocol/event.d.ts

@@ -0,0 +1,253 @@
+import { z } from "zod";
+export declare const probeStatuses: readonly ["pass", "warn", "fail", "skipped", "not_reached", "unknown"];
+export declare const probeStatusSchema: z.ZodEnum<{
+    fail: "fail";
+    not_reached: "not_reached";
+    pass: "pass";
+    skipped: "skipped";
+    unknown: "unknown";
+    warn: "warn";
+}>;
+export declare const probeMapEventTypes: readonly ["session.start", "session.end", "flow.start", "flow.end", "action.click", "action.double_click", "action.drag_start", "action.drag_move", "action.drag_end", "action.drop", "action.input", "action.keypress", "action.navigation", "state.snapshot", "probe.step", "probe.observe", "probe.assert", "network.request", "network.response", "network.error", "console.log", "console.warn", "console.error", "runtime.exception", "performance.long_task", "visual.snapshot", "git.snapshot", "bug.recorded", "diagnosis.created", "verification.created"];
+export declare const probeMapEventTypeSchema: z.ZodEnum<{
+    "action.click": "action.click";
+    "action.double_click": "action.double_click";
+    "action.drag_end": "action.drag_end";
+    "action.drag_move": "action.drag_move";
+    "action.drag_start": "action.drag_start";
+    "action.drop": "action.drop";
+    "action.input": "action.input";
+    "action.keypress": "action.keypress";
+    "action.navigation": "action.navigation";
+    "bug.recorded": "bug.recorded";
+    "console.error": "console.error";
+    "console.log": "console.log";
+    "console.warn": "console.warn";
+    "diagnosis.created": "diagnosis.created";
+    "flow.end": "flow.end";
+    "flow.start": "flow.start";
+    "git.snapshot": "git.snapshot";
+    "network.error": "network.error";
+    "network.request": "network.request";
+    "network.response": "network.response";
+    "performance.long_task": "performance.long_task";
+    "probe.assert": "probe.assert";
+    "probe.observe": "probe.observe";
+    "probe.step": "probe.step";
+    "runtime.exception": "runtime.exception";
+    "session.end": "session.end";
+    "session.start": "session.start";
+    "state.snapshot": "state.snapshot";
+    "verification.created": "verification.created";
+    "visual.snapshot": "visual.snapshot";
+}>;
+export declare const eventSourceSchema: z.ZodEnum<{
+    adapter: "adapter";
+    "browser-sdk": "browser-sdk";
+    cli: "cli";
+    collector: "collector";
+    mcp: "mcp";
+    "node-sdk": "node-sdk";
+}>;
+export declare const privacyLevelSchema: z.ZodEnum<{
+    redacted: "redacted";
+    safe: "safe";
+    sensitive: "sensitive";
+}>;
+export declare const protocolVersionSchema: z.ZodString;
+export declare const probeMapEventSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    protocolVersion: z.ZodString;
+    sdkVersion: z.ZodString;
+    payloadSchemaId: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodUUID;
+    sessionId: z.ZodUUID;
+    flowId: z.ZodOptional<z.ZodUUID>;
+    flowContractVersionId: z.ZodOptional<z.ZodUUID>;
+    probeDefinitionId: z.ZodOptional<z.ZodUUID>;
+    traceId: z.ZodString;
+    spanId: z.ZodString;
+    parentSpanId: z.ZodOptional<z.ZodString>;
+    linkedSpanIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    runtimeId: z.ZodString;
+    processId: z.ZodOptional<z.ZodString>;
+    threadId: z.ZodOptional<z.ZodString>;
+    clientSequence: z.ZodNumber;
+    clientTimestamp: z.ZodISODateTime;
+    monotonicTime: z.ZodNumber;
+    serverReceivedAt: z.ZodOptional<z.ZodISODateTime>;
+    type: z.ZodEnum<{
+        "action.click": "action.click";
+        "action.double_click": "action.double_click";
+        "action.drag_end": "action.drag_end";
+        "action.drag_move": "action.drag_move";
+        "action.drag_start": "action.drag_start";
+        "action.drop": "action.drop";
+        "action.input": "action.input";
+        "action.keypress": "action.keypress";
+        "action.navigation": "action.navigation";
+        "bug.recorded": "bug.recorded";
+        "console.error": "console.error";
+        "console.log": "console.log";
+        "console.warn": "console.warn";
+        "diagnosis.created": "diagnosis.created";
+        "flow.end": "flow.end";
+        "flow.start": "flow.start";
+        "git.snapshot": "git.snapshot";
+        "network.error": "network.error";
+        "network.request": "network.request";
+        "network.response": "network.response";
+        "performance.long_task": "performance.long_task";
+        "probe.assert": "probe.assert";
+        "probe.observe": "probe.observe";
+        "probe.step": "probe.step";
+        "runtime.exception": "runtime.exception";
+        "session.end": "session.end";
+        "session.start": "session.start";
+        "state.snapshot": "state.snapshot";
+        "verification.created": "verification.created";
+        "visual.snapshot": "visual.snapshot";
+    }>;
+    source: z.ZodEnum<{
+        adapter: "adapter";
+        "browser-sdk": "browser-sdk";
+        cli: "cli";
+        collector: "collector";
+        mcp: "mcp";
+        "node-sdk": "node-sdk";
+    }>;
+    status: z.ZodOptional<z.ZodEnum<{
+        fail: "fail";
+        not_reached: "not_reached";
+        pass: "pass";
+        skipped: "skipped";
+        unknown: "unknown";
+        warn: "warn";
+    }>>;
+    name: z.ZodOptional<z.ZodString>;
+    message: z.ZodOptional<z.ZodString>;
+    payload: z.ZodOptional<z.ZodUnknown>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    relatedObjectIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    stackTrace: z.ZodOptional<z.ZodString>;
+    fileHints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        reason: z.ZodString;
+        confidence: z.ZodNumber;
+        source: z.ZodEnum<{
+            discovery: "discovery";
+            git: "git";
+            heuristic: "heuristic";
+            probe: "probe";
+            stack: "stack";
+        }>;
+        line: z.ZodOptional<z.ZodNumber>;
+        column: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>>;
+    privacyLevel: z.ZodEnum<{
+        redacted: "redacted";
+        safe: "safe";
+        sensitive: "sensitive";
+    }>;
+}, z.core.$strict>;
+export declare const collectedProbeMapEventSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    protocolVersion: z.ZodString;
+    sdkVersion: z.ZodString;
+    payloadSchemaId: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodUUID;
+    sessionId: z.ZodUUID;
+    flowId: z.ZodOptional<z.ZodUUID>;
+    flowContractVersionId: z.ZodOptional<z.ZodUUID>;
+    probeDefinitionId: z.ZodOptional<z.ZodUUID>;
+    traceId: z.ZodString;
+    spanId: z.ZodString;
+    parentSpanId: z.ZodOptional<z.ZodString>;
+    linkedSpanIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    runtimeId: z.ZodString;
+    processId: z.ZodOptional<z.ZodString>;
+    threadId: z.ZodOptional<z.ZodString>;
+    clientSequence: z.ZodNumber;
+    clientTimestamp: z.ZodISODateTime;
+    monotonicTime: z.ZodNumber;
+    serverReceivedAt: z.ZodOptional<z.ZodISODateTime>;
+    type: z.ZodEnum<{
+        "action.click": "action.click";
+        "action.double_click": "action.double_click";
+        "action.drag_end": "action.drag_end";
+        "action.drag_move": "action.drag_move";
+        "action.drag_start": "action.drag_start";
+        "action.drop": "action.drop";
+        "action.input": "action.input";
+        "action.keypress": "action.keypress";
+        "action.navigation": "action.navigation";
+        "bug.recorded": "bug.recorded";
+        "console.error": "console.error";
+        "console.log": "console.log";
+        "console.warn": "console.warn";
+        "diagnosis.created": "diagnosis.created";
+        "flow.end": "flow.end";
+        "flow.start": "flow.start";
+        "git.snapshot": "git.snapshot";
+        "network.error": "network.error";
+        "network.request": "network.request";
+        "network.response": "network.response";
+        "performance.long_task": "performance.long_task";
+        "probe.assert": "probe.assert";
+        "probe.observe": "probe.observe";
+        "probe.step": "probe.step";
+        "runtime.exception": "runtime.exception";
+        "session.end": "session.end";
+        "session.start": "session.start";
+        "state.snapshot": "state.snapshot";
+        "verification.created": "verification.created";
+        "visual.snapshot": "visual.snapshot";
+    }>;
+    source: z.ZodEnum<{
+        adapter: "adapter";
+        "browser-sdk": "browser-sdk";
+        cli: "cli";
+        collector: "collector";
+        mcp: "mcp";
+        "node-sdk": "node-sdk";
+    }>;
+    status: z.ZodOptional<z.ZodEnum<{
+        fail: "fail";
+        not_reached: "not_reached";
+        pass: "pass";
+        skipped: "skipped";
+        unknown: "unknown";
+        warn: "warn";
+    }>>;
+    name: z.ZodOptional<z.ZodString>;
+    message: z.ZodOptional<z.ZodString>;
+    payload: z.ZodOptional<z.ZodUnknown>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    relatedObjectIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    stackTrace: z.ZodOptional<z.ZodString>;
+    fileHints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        reason: z.ZodString;
+        confidence: z.ZodNumber;
+        source: z.ZodEnum<{
+            discovery: "discovery";
+            git: "git";
+            heuristic: "heuristic";
+            probe: "probe";
+            stack: "stack";
+        }>;
+        line: z.ZodOptional<z.ZodNumber>;
+        column: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>>;
+    privacyLevel: z.ZodEnum<{
+        redacted: "redacted";
+        safe: "safe";
+        sensitive: "sensitive";
+    }>;
+    serverSequence: z.ZodNumber;
+}, z.core.$strict>;
+export type ProbeStatus = z.infer<typeof probeStatusSchema>;
+export type ProbeMapEventType = z.infer<typeof probeMapEventTypeSchema>;
+export type ProbeMapEvent = z.infer<typeof probeMapEventSchema>;
+export type CollectedProbeMapEvent = z.infer<typeof collectedProbeMapEventSchema>;
+//# sourceMappingURL=event.d.ts.map

package/dist/protocol/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/protocol/event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,aAAa,YACxB,MAAM,EACN,MAAM,EACN,MAAM,EACN,SAAS,EACT,aAAa,EACb,SAAS,CACD,CAAC;AAEX,eAAO,MAAM,iBAAiB;;;;;;;EAAwB,CAAC;AAEvD,eAAO,MAAM,kBAAkB,YAC7B,eAAe,EACf,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,sBAAsB,CACd,CAAC;AAEX,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA6B,CAAC;AAElE,eAAO,MAAM,iBAAiB;;;;;;;EAO5B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;EAA4C,CAAC;AAE5E,eAAO,MAAM,qBAAqB,aAEwC,CAAC;AAE3E,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAsC9B,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAEvC,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

package/dist/protocol/event.js

@@ -0,0 +1,93 @@
+import { z } from "zod";
+import { fileHintSchema } from "./file-hint.js";
+export const probeStatuses = [
+    "pass",
+    "warn",
+    "fail",
+    "skipped",
+    "not_reached",
+    "unknown",
+];
+export const probeStatusSchema = z.enum(probeStatuses);
+export const probeMapEventTypes = [
+    "session.start",
+    "session.end",
+    "flow.start",
+    "flow.end",
+    "action.click",
+    "action.double_click",
+    "action.drag_start",
+    "action.drag_move",
+    "action.drag_end",
+    "action.drop",
+    "action.input",
+    "action.keypress",
+    "action.navigation",
+    "state.snapshot",
+    "probe.step",
+    "probe.observe",
+    "probe.assert",
+    "network.request",
+    "network.response",
+    "network.error",
+    "console.log",
+    "console.warn",
+    "console.error",
+    "runtime.exception",
+    "performance.long_task",
+    "visual.snapshot",
+    "git.snapshot",
+    "bug.recorded",
+    "diagnosis.created",
+    "verification.created",
+];
+export const probeMapEventTypeSchema = z.enum(probeMapEventTypes);
+export const eventSourceSchema = z.enum([
+    "browser-sdk",
+    "node-sdk",
+    "collector",
+    "mcp",
+    "cli",
+    "adapter",
+]);
+export const privacyLevelSchema = z.enum(["safe", "redacted", "sensitive"]);
+export const protocolVersionSchema = z
+    .string()
+    .regex(/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-[0-9A-Za-z.-]+)?$/);
+export const probeMapEventSchema = z.strictObject({
+    id: z.uuid(),
+    protocolVersion: protocolVersionSchema,
+    sdkVersion: z.string().min(1),
+    payloadSchemaId: z.string().min(1).optional(),
+    projectId: z.uuid(),
+    sessionId: z.uuid(),
+    flowId: z.uuid().optional(),
+    flowContractVersionId: z.uuid().optional(),
+    probeDefinitionId: z.uuid().optional(),
+    traceId: z.string().min(1).max(64),
+    spanId: z.string().min(1).max(32),
+    parentSpanId: z.string().min(1).max(32).optional(),
+    linkedSpanIds: z.array(z.string().min(1).max(32)).max(32).optional(),
+    runtimeId: z.string().min(1).max(128),
+    processId: z.string().min(1).max(128).optional(),
+    threadId: z.string().min(1).max(128).optional(),
+    clientSequence: z.number().int().nonnegative().safe(),
+    clientTimestamp: z.iso.datetime({ offset: true }),
+    monotonicTime: z.number().nonnegative().finite(),
+    serverReceivedAt: z.iso.datetime({ offset: true }).optional(),
+    type: probeMapEventTypeSchema,
+    source: eventSourceSchema,
+    status: probeStatusSchema.optional(),
+    name: z.string().min(1).max(512).optional(),
+    message: z.string().max(16_384).optional(),
+    payload: z.unknown().optional(),
+    tags: z.array(z.string().min(1).max(128)).max(64).optional(),
+    relatedObjectIds: z.array(z.string().min(1).max(256)).max(128).optional(),
+    stackTrace: z.string().max(100_000).optional(),
+    fileHints: z.array(fileHintSchema).max(64).optional(),
+    privacyLevel: privacyLevelSchema,
+});
+export const collectedProbeMapEventSchema = probeMapEventSchema.extend({
+    serverSequence: z.number().int().positive().safe(),
+});
+//# sourceMappingURL=event.js.map

package/dist/protocol/event.js.map

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

package/dist/protocol/file-hint.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod";
+export declare const fileHintSourceSchema: z.ZodEnum<{
+    discovery: "discovery";
+    git: "git";
+    heuristic: "heuristic";
+    probe: "probe";
+    stack: "stack";
+}>;
+export declare const fileHintSchema: z.ZodObject<{
+    path: z.ZodString;
+    reason: z.ZodString;
+    confidence: z.ZodNumber;
+    source: z.ZodEnum<{
+        discovery: "discovery";
+        git: "git";
+        heuristic: "heuristic";
+        probe: "probe";
+        stack: "stack";
+    }>;
+    line: z.ZodOptional<z.ZodNumber>;
+    column: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type FileHint = z.infer<typeof fileHintSchema>;
+//# sourceMappingURL=file-hint.d.ts.map

package/dist/protocol/file-hint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-hint.d.ts","sourceRoot":"","sources":["../../src/protocol/file-hint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB;;;;;;EAM/B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;kBAOzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/protocol/file-hint.js

@@ -0,0 +1,17 @@
+import { z } from "zod";
+export const fileHintSourceSchema = z.enum([
+    "probe",
+    "stack",
+    "discovery",
+    "git",
+    "heuristic",
+]);
+export const fileHintSchema = z.strictObject({
+    path: z.string().min(1),
+    reason: z.string().min(1),
+    confidence: z.number().min(0).max(1),
+    source: fileHintSourceSchema,
+    line: z.number().int().positive().optional(),
+    column: z.number().int().nonnegative().optional(),
+});
+//# sourceMappingURL=file-hint.js.map

package/dist/protocol/file-hint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-hint.js","sourceRoot":"","sources":["../../src/protocol/file-hint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC;IACzC,OAAO;IACP,OAAO;IACP,WAAW;IACX,KAAK;IACL,WAAW;CACZ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,YAAY,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,MAAM,EAAE,oBAAoB;IAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAC"}

package/dist/protocol/trace-context.d.ts

@@ -0,0 +1,21 @@
+export declare const PROBEMAP_PROJECT_HEADER = "x-probemap-project-id";
+export declare const PROBEMAP_SESSION_HEADER = "x-probemap-session-id";
+export declare const PROBEMAP_FLOW_HEADER = "x-probemap-flow-id";
+export declare const TRACEPARENT_HEADER = "traceparent";
+export interface PropagatedTraceContext {
+    projectId: string;
+    sessionId: string;
+    flowId?: string;
+    traceId: string;
+    parentSpanId: string;
+    sampled: boolean;
+}
+export type TraceHeaders = Record<string, string>;
+export interface HeaderReader {
+    get(name: string): string | null;
+}
+export type HeaderSource = HeaderReader | Record<string, string | string[] | undefined>;
+export declare function formatTraceparent(traceId: string, spanId: string, sampled?: boolean): string;
+export declare function createTraceHeaders(context: PropagatedTraceContext): TraceHeaders;
+export declare function parseTraceHeaders(source: HeaderSource): PropagatedTraceContext | undefined;
+//# sourceMappingURL=trace-context.d.ts.map

package/dist/protocol/trace-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-context.d.ts","sourceRoot":"","sources":["../../src/protocol/trace-context.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,0BAA0B,CAAC;AAC/D,eAAO,MAAM,uBAAuB,0BAA0B,CAAC;AAC/D,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AACzD,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AAMhD,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,MAAM,YAAY,GACpB,YAAY,GACZ,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;AAYlD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,UAAO,GAAG,MAAM,CAWzF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,sBAAsB,GAAG,YAAY,CAWhF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,sBAAsB,GAAG,SAAS,CA+B1F"}

package/dist/protocol/trace-context.js

@@ -0,0 +1,59 @@
+export const PROBEMAP_PROJECT_HEADER = "x-probemap-project-id";
+export const PROBEMAP_SESSION_HEADER = "x-probemap-session-id";
+export const PROBEMAP_FLOW_HEADER = "x-probemap-flow-id";
+export const TRACEPARENT_HEADER = "traceparent";
+const uuidPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+const traceIdPattern = /^[0-9a-f]{32}$/i;
+const spanIdPattern = /^[0-9a-f]{16}$/i;
+function readHeader(source, name) {
+    if ("get" in source && typeof source.get === "function") {
+        return source.get(name) ?? undefined;
+    }
+    const record = source;
+    const value = record[name] ?? record[name.toLowerCase()];
+    return Array.isArray(value) ? value[0] : value;
+}
+export function formatTraceparent(traceId, spanId, sampled = true) {
+    if (!traceIdPattern.test(traceId) ||
+        /^0+$/.test(traceId) ||
+        !spanIdPattern.test(spanId) ||
+        /^0+$/.test(spanId)) {
+        throw new Error("Cannot format an invalid W3C trace context.");
+    }
+    return `00-${traceId.toLowerCase()}-${spanId.toLowerCase()}-${sampled ? "01" : "00"}`;
+}
+export function createTraceHeaders(context) {
+    return {
+        [TRACEPARENT_HEADER]: formatTraceparent(context.traceId, context.parentSpanId, context.sampled),
+        [PROBEMAP_PROJECT_HEADER]: context.projectId,
+        [PROBEMAP_SESSION_HEADER]: context.sessionId,
+        ...(context.flowId === undefined ? {} : { [PROBEMAP_FLOW_HEADER]: context.flowId }),
+    };
+}
+export function parseTraceHeaders(source) {
+    const projectId = readHeader(source, PROBEMAP_PROJECT_HEADER);
+    const sessionId = readHeader(source, PROBEMAP_SESSION_HEADER);
+    const flowId = readHeader(source, PROBEMAP_FLOW_HEADER);
+    const traceparent = readHeader(source, TRACEPARENT_HEADER);
+    const match = /^([0-9a-f]{2})-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/i.exec(traceparent ?? "");
+    if (projectId === undefined ||
+        sessionId === undefined ||
+        !uuidPattern.test(projectId) ||
+        !uuidPattern.test(sessionId) ||
+        (flowId !== undefined && !uuidPattern.test(flowId)) ||
+        match === null ||
+        match[1] === "ff" ||
+        /^0+$/.test(match[2]) ||
+        /^0+$/.test(match[3])) {
+        return undefined;
+    }
+    return {
+        projectId,
+        sessionId,
+        ...(flowId === undefined ? {} : { flowId }),
+        traceId: match[2].toLowerCase(),
+        parentSpanId: match[3].toLowerCase(),
+        sampled: (Number.parseInt(match[4], 16) & 1) === 1,
+    };
+}
+//# sourceMappingURL=trace-context.js.map