@owlpane/browser 0.1.1

package/dist/tracer.d.ts

@@ -0,0 +1,45 @@
+import type { Env } from "./env.js";
+import { RandomBytes } from "./ids.js";
+import type { Attrs, SpanData, SpanEvent } from "./otlp.js";
+export declare const VERSION = "0.1.0";
+export type ResolvedOptions = {
+    endpoint: string;
+    projectKey: string;
+    serviceName: string;
+    environment?: string;
+    release?: string;
+    sampleRate: number;
+    propagateTraceTo: (string | RegExp)[];
+    keepQuery: boolean;
+    maxErrorsPerPage: number;
+};
+export type ActiveSpan = {
+    traceId: string;
+    spanId: string;
+    sampled: boolean;
+    end(o?: {
+        status?: SpanData["status"];
+        attributes?: Attrs;
+        events?: SpanEvent[];
+        endMs?: number;
+    }): void;
+};
+/** Creates spans, stamps the attributes every RUM span carries, and hands finished spans to `emit`. */
+export type Tracer = ReturnType<typeof createTracer>;
+export declare function createTracer(env: Env, opts: ResolvedOptions, emit: (s: SpanData) => void, sessionId: string, pageUrl: () => {
+    url: string;
+    path: string;
+}): {
+    start: (name: string, kind: 1 | 3, o?: {
+        traceId?: string;
+        parentSpanId?: string;
+        sampled?: boolean;
+        startMs?: number;
+        attributes?: Attrs;
+    }) => ActiveSpan;
+    sample: () => boolean;
+    common: () => Attrs;
+    rand: RandomBytes;
+    newTraceId: () => string;
+    newSpanId: () => string;
+};

package/dist/tracer.js

@@ -0,0 +1,61 @@
+import { defaultRandomBytes, newSpanId, newTraceId } from "./ids.js";
+export const VERSION = "0.1.0";
+export function createTracer(env, opts, emit, sessionId, pageUrl) {
+    const rand = env.randomBytes ?? defaultRandomBytes();
+    const nav = env.navigator;
+    function common() {
+        const p = pageUrl();
+        return {
+            "owlpane.rum": "true",
+            "session.id": sessionId,
+            "browser.page.url": p.url,
+            "browser.page.path": p.path,
+            "user_agent.original": nav?.userAgent,
+            "browser.language": nav?.language,
+            "browser.platform": nav?.userAgentData?.platform ?? nav?.platform,
+            "browser.mobile": nav?.userAgentData?.mobile,
+        };
+    }
+    function sample() {
+        return opts.sampleRate >= 1 ? true : opts.sampleRate <= 0 ? false : env.random() < opts.sampleRate;
+    }
+    function start(name, kind, o = {}) {
+        const traceId = o.traceId ?? newTraceId(rand);
+        const spanId = newSpanId(rand);
+        const sampled = o.sampled ?? sample();
+        const startMs = o.startMs ?? env.now();
+        const startAttrs = o.attributes ?? {};
+        let done = false;
+        return {
+            traceId,
+            spanId,
+            sampled,
+            end(e = {}) {
+                if (done)
+                    return;
+                done = true;
+                if (!sampled)
+                    return;
+                try {
+                    emit({
+                        traceId,
+                        spanId,
+                        parentSpanId: o.parentSpanId,
+                        name,
+                        kind,
+                        startMs,
+                        endMs: e.endMs ?? env.now(),
+                        attributes: { ...common(), ...startAttrs, ...e.attributes },
+                        events: e.events,
+                        status: e.status,
+                    });
+                }
+                catch {
+                    /* never throw into the host app */
+                }
+            },
+        };
+    }
+    return { start, sample, common, rand, newTraceId: () => newTraceId(rand), newSpanId: () => newSpanId(rand) };
+}
+//# sourceMappingURL=tracer.js.map

package/dist/tracer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.js","sourceRoot":"","sources":["../src/tracer.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,kBAAkB,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGlF,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAwB/B,MAAM,UAAU,YAAY,CAAC,GAAQ,EAAE,IAAqB,EAAE,IAA2B,EAAE,SAAiB,EAAE,OAA4C;IACxJ,MAAM,IAAI,GAAgB,GAAG,CAAC,WAAW,IAAI,kBAAkB,EAAE,CAAC;IAClE,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC;IAE1B,SAAS,MAAM;QACb,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,aAAa,EAAE,MAAM;YACrB,YAAY,EAAE,SAAS;YACvB,kBAAkB,EAAE,CAAC,CAAC,GAAG;YACzB,mBAAmB,EAAE,CAAC,CAAC,IAAI;YAC3B,qBAAqB,EAAE,GAAG,EAAE,SAAS;YACrC,kBAAkB,EAAE,GAAG,EAAE,QAAQ;YACjC,kBAAkB,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,IAAI,GAAG,EAAE,QAAQ;YACjE,gBAAgB,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM;SAC7C,CAAC;IACJ,CAAC;IAED,SAAS,MAAM;QACb,OAAO,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;IACrG,CAAC;IAED,SAAS,KAAK,CAAC,IAAY,EAAE,IAAW,EAAE,IAA0G,EAAE;QACpJ,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,MAAM,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;QACvC,MAAM,UAAU,GAAG,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC;QACtC,IAAI,IAAI,GAAG,KAAK,CAAC;QACjB,OAAO;YACL,OAAO;YACP,MAAM;YACN,OAAO;YACP,GAAG,CAAC,CAAC,GAAG,EAAE;gBACR,IAAI,IAAI;oBAAE,OAAO;gBACjB,IAAI,GAAG,IAAI,CAAC;gBACZ,IAAI,CAAC,OAAO;oBAAE,OAAO;gBACrB,IAAI,CAAC;oBACH,IAAI,CAAC;wBACH,OAAO;wBACP,MAAM;wBACN,YAAY,EAAE,CAAC,CAAC,YAAY;wBAC5B,IAAI;wBACJ,IAAI;wBACJ,OAAO;wBACP,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,GAAG,EAAE;wBAC3B,UAAU,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,GAAG,UAAU,EAAE,GAAG,CAAC,CAAC,UAAU,EAAE;wBAC3D,MAAM,EAAE,CAAC,CAAC,MAAM;wBAChB,MAAM,EAAE,CAAC,CAAC,MAAM;qBACjB,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,mCAAmC;gBACrC,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;AAC/G,CAAC"}

package/dist/url.d.ts

@@ -0,0 +1,11 @@
+/** Removes credentials, and query/hash unless `keepQuery`. Relative URLs resolve against `base`. */
+export declare function sanitizeUrl(raw: string, base: string | undefined, keepQuery?: boolean): string;
+export declare function urlPath(raw: string, base: string | undefined): string;
+export declare function urlOrigin(raw: string, base: string | undefined): string | null;
+export type AllowEntry = string | RegExp;
+/**
+ * Decides whether a request URL may receive a traceparent header.
+ * Same-origin is always allowed. String entries match as a prefix of the absolute URL
+ * (so "https://api.example.com" covers the whole origin); RegExp entries are tested against the absolute URL.
+ */
+export declare function shouldPropagate(raw: string, base: string | undefined, allow?: readonly AllowEntry[]): boolean;

package/dist/url.js

@@ -0,0 +1,68 @@
+/** Removes credentials, and query/hash unless `keepQuery`. Relative URLs resolve against `base`. */
+export function sanitizeUrl(raw, base, keepQuery = false) {
+    try {
+        const u = new URL(raw, base);
+        u.username = "";
+        u.password = "";
+        if (!keepQuery) {
+            u.search = "";
+            u.hash = "";
+        }
+        else {
+            u.hash = "";
+        }
+        return u.toString();
+    }
+    catch {
+        return keepQuery ? raw.split("#")[0] : raw.split(/[?#]/)[0];
+    }
+}
+export function urlPath(raw, base) {
+    try {
+        return new URL(raw, base).pathname;
+    }
+    catch {
+        return raw.split(/[?#]/)[0];
+    }
+}
+export function urlOrigin(raw, base) {
+    try {
+        const o = new URL(raw, base).origin;
+        return o === "null" ? null : o;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Decides whether a request URL may receive a traceparent header.
+ * Same-origin is always allowed. String entries match as a prefix of the absolute URL
+ * (so "https://api.example.com" covers the whole origin); RegExp entries are tested against the absolute URL.
+ */
+export function shouldPropagate(raw, base, allow = []) {
+    let abs;
+    try {
+        abs = new URL(raw, base).toString();
+    }
+    catch {
+        return false;
+    }
+    if (base) {
+        const a = urlOrigin(abs, undefined);
+        if (a && a === urlOrigin(base, undefined))
+            return true;
+    }
+    for (const e of allow) {
+        if (typeof e === "string") {
+            if (abs.startsWith(e))
+                return true;
+        }
+        else {
+            e.lastIndex = 0;
+            if (e.test(abs))
+                return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=url.js.map

package/dist/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../src/url.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,IAAwB,EAAE,SAAS,GAAG,KAAK;IAClF,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC,CAAC,QAAQ,GAAG,EAAE,CAAC;QAChB,CAAC,CAAC,QAAQ,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC;YACd,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC;QACd,CAAC;aAAM,CAAC;YACN,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC;QACd,CAAC;QACD,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,IAAwB;IAC3D,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,IAAwB;IAC7D,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC;QACpC,OAAO,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAID;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,IAAwB,EAAE,QAA+B,EAAE;IACtG,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,CAAC,GAAG,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC;YAAE,OAAO,IAAI,CAAC;IACzD,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC1B,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC;YAChB,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/vitals.d.ts

@@ -0,0 +1,32 @@
+export type Rating = "good" | "needs-improvement" | "poor";
+export declare function rate(name: "LCP" | "CLS" | "INP", value: number): Rating;
+/**
+ * CLS = largest "session window" of layout shifts: a window closes after a 1s gap
+ * since the previous shift or when it reaches 5s. Shifts right after user input are ignored.
+ */
+export declare class ClsTracker {
+    value: number;
+    private windowValue;
+    private windowStart;
+    private lastShift;
+    private open;
+    add(shift: {
+        value: number;
+        startTime: number;
+        hadRecentInput?: boolean;
+    }): void;
+}
+/**
+ * INP: the worst interaction latency, ignoring one outlier per 50 interactions (approximates p98).
+ * Events sharing an interactionId are one interaction; its latency is the longest event duration.
+ */
+export declare class InpTracker {
+    private byId;
+    add(entry: {
+        interactionId?: number;
+        duration: number;
+    }): void;
+    get count(): number;
+    /** Returns undefined when no interaction was observed. */
+    get value(): number | undefined;
+}

package/dist/vitals.js

@@ -0,0 +1,54 @@
+const THRESHOLDS = { LCP: [2500, 4000], CLS: [0.1, 0.25], INP: [200, 500] };
+export function rate(name, value) {
+    const [good, poor] = THRESHOLDS[name];
+    return value <= good ? "good" : value <= poor ? "needs-improvement" : "poor";
+}
+/**
+ * CLS = largest "session window" of layout shifts: a window closes after a 1s gap
+ * since the previous shift or when it reaches 5s. Shifts right after user input are ignored.
+ */
+export class ClsTracker {
+    value = 0;
+    windowValue = 0;
+    windowStart = 0;
+    lastShift = 0;
+    open = false;
+    add(shift) {
+        if (shift.hadRecentInput)
+            return;
+        if (!this.open || shift.startTime - this.lastShift > 1000 || shift.startTime - this.windowStart > 5000) {
+            this.open = true;
+            this.windowValue = 0;
+            this.windowStart = shift.startTime;
+        }
+        this.windowValue += shift.value;
+        this.lastShift = shift.startTime;
+        if (this.windowValue > this.value)
+            this.value = this.windowValue;
+    }
+}
+/**
+ * INP: the worst interaction latency, ignoring one outlier per 50 interactions (approximates p98).
+ * Events sharing an interactionId are one interaction; its latency is the longest event duration.
+ */
+export class InpTracker {
+    byId = new Map();
+    add(entry) {
+        if (!entry.interactionId)
+            return; // not a discrete interaction (e.g. hover)
+        const prev = this.byId.get(entry.interactionId) ?? 0;
+        if (entry.duration > prev)
+            this.byId.set(entry.interactionId, entry.duration);
+    }
+    get count() {
+        return this.byId.size;
+    }
+    /** Returns undefined when no interaction was observed. */
+    get value() {
+        const all = [...this.byId.values()].sort((a, b) => b - a);
+        if (!all.length)
+            return undefined;
+        return all[Math.min(all.length - 1, Math.floor(all.length / 50))];
+    }
+}
+//# sourceMappingURL=vitals.js.map

package/dist/vitals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitals.js","sourceRoot":"","sources":["../src/vitals.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAqC,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;AAE9G,MAAM,UAAU,IAAI,CAAC,IAA2B,EAAE,KAAa;IAC7D,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,MAAM,CAAC;AAC/E,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,UAAU;IACrB,KAAK,GAAG,CAAC,CAAC;IACF,WAAW,GAAG,CAAC,CAAC;IAChB,WAAW,GAAG,CAAC,CAAC;IAChB,SAAS,GAAG,CAAC,CAAC;IACd,IAAI,GAAG,KAAK,CAAC;IAErB,GAAG,CAAC,KAAqE;QACvE,IAAI,KAAK,CAAC,cAAc;YAAE,OAAO;QACjC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,WAAW,GAAG,IAAI,EAAE,CAAC;YACvG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;YACrB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC;QACrC,CAAC;QACD,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC,KAAK,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACjC,IAAI,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC;IACnE,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,UAAU;IACb,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEzC,GAAG,CAAC,KAAmD;QACrD,IAAI,CAAC,KAAK,CAAC,aAAa;YAAE,OAAO,CAAC,0CAA0C;QAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,KAAK,CAAC,QAAQ,GAAG,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChF,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAED,0DAA0D;IAC1D,IAAI,KAAK;QACP,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,GAAG,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAClC,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IACpE,CAAC;CACF"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@owlpane/browser",
+  "version": "0.1.1",
+  "description": "Owlpane real-user-monitoring SDK for browsers: page load, Web Vitals, JS errors, fetch/XHR spans, optional rrweb DOM replay, and W3C trace propagation over OTLP/HTTP JSON.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/balaji-singh/owlpane-sdk.git",
+    "directory": "packages/browser"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "build:iife": "esbuild src/index.ts --bundle --format=iife --global-name=OwlpaneBrowser --target=es2020 --minify --outfile=dist/owlpane-browser.iife.js",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test --import tsx $(ls test/*.test.ts)"
+  },
+  "dependencies": {
+    "rrweb": "^2.0.0-alpha.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.0",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3"
+  }
+}