praetom 0.1.0

package/dist/_internal.js

@@ -0,0 +1,357 @@
+/**
+ * Internal runtime primitives. NOT part of the public package surface —
+ * customers should import from `praetom` or
+ * `praetom`, which together expose only `register` and
+ * `emit`.
+ *
+ * Everything else (`feature`, `featureSync`, `continueTrace`, `init`,
+ * `flush`, `shutdown`, the buffer, the fetch patch) lives here and is
+ * called by `register()` + the autowrap hook + the bundler plugin's
+ * generated code. We don't ship a manual-wrap API.
+ */
+import { AsyncLocalStorage } from "node:async_hooks";
+import { randomBytes } from "node:crypto";
+const DEFAULT_ENDPOINT = "https://praetom.com/api/otlp/v1/traces";
+const FLUSH_INTERVAL_MS = 5_000;
+const FLUSH_BATCH_SIZE = 50;
+const g = globalThis;
+if (!g.__praetom) {
+    g.__praetom = {
+        config: null,
+        buffer: [],
+        flushTimer: null,
+        fetchPatched: false,
+        als: new AsyncLocalStorage(),
+    };
+}
+const _state = g.__praetom;
+const als = _state.als;
+export function init(opts) {
+    _state.config = {
+        token: opts.token,
+        endpoint: opts.endpoint ?? DEFAULT_ENDPOINT,
+        serviceName: opts.serviceName,
+    };
+    patchFetch();
+}
+/**
+ * Wrap an async function as a feature entry point. Called by the
+ * autowrap hook in `server.ts` and the bundler plugin's generated
+ * browser-side code — NOT a customer-facing API.
+ */
+export async function feature(slug, fn, attributes) {
+    const ctx = {
+        traceId: randHex(16),
+        spanId: randHex(8),
+        slug,
+    };
+    return runFeature(ctx, null, fn, attributes);
+}
+export function featureSync(slug, fn) {
+    const ctx = {
+        traceId: randHex(16),
+        spanId: randHex(8),
+        slug,
+    };
+    const startMs = Date.now();
+    try {
+        return als.run(ctx, () => {
+            const result = fn();
+            record(ctx, null, startMs, false);
+            return result;
+        });
+    }
+    catch (e) {
+        record(ctx, null, startMs, true);
+        throw e;
+    }
+}
+/**
+ * Continue a trace from an incoming HTTP request. Called by the
+ * autowrap hook when wrapping HTTP handlers — reads `traceparent` and
+ * stitches the local span under the upstream span.
+ */
+export async function continueTrace(headers, slug, fn, attributes) {
+    const tp = readTraceparent(headers);
+    const ctx = tp
+        ? { traceId: tp.traceId, spanId: randHex(8), slug }
+        : { traceId: randHex(16), spanId: randHex(8), slug };
+    const parentSpanId = tp?.parentSpanId ?? null;
+    return runFeature(ctx, parentSpanId, fn, attributes);
+}
+async function runFeature(ctx, parentSpanId, fn, attributes) {
+    const startMs = Date.now();
+    return als.run(ctx, async () => {
+        try {
+            const result = await fn();
+            record(ctx, parentSpanId, startMs, false, attributes);
+            return result;
+        }
+        catch (e) {
+            record(ctx, parentSpanId, startMs, true, attributes);
+            throw e;
+        }
+    });
+}
+export function currentFeatureContext() {
+    return als.getStore();
+}
+const HTTP_METHODS = new Set([
+    "GET",
+    "POST",
+    "PUT",
+    "PATCH",
+    "DELETE",
+    "OPTIONS",
+    "HEAD",
+]);
+/**
+ * Internal wrap-as-entry-point helper. Shared by the CJS Module._load
+ * hook, the ESM loader hook, and the bundler plugin's injected code.
+ *
+ * If `entryName` is an HTTP method (`GET`, `POST`, ...), the wrap reads
+ * `traceparent` from the first arg's `headers` to continue an upstream
+ * trace. Otherwise it opens a fresh feature span.
+ *
+ * NOT a public customer API — exported under `__praetom*` only so the
+ * bundler-plugin-injected code can call it; customers should never
+ * import it directly.
+ */
+export function wrapEntryPoint(slug, entryName, original) {
+    const isHttpHandler = HTTP_METHODS.has(entryName);
+    const wrapped = function (...args) {
+        if (isHttpHandler) {
+            const req = args[0];
+            const headers = req?.headers;
+            if (headers) {
+                const attrs = classifyHttpCaller(headers);
+                return continueTrace(headers, slug, async () => original.apply(this, args), attrs);
+            }
+        }
+        return feature(slug, async () => original.apply(this, args));
+    };
+    Object.defineProperty(wrapped, "name", { value: entryName });
+    return wrapped;
+}
+/**
+ * Pulls the request's user-agent and classifies the caller as either
+ * "agent" (an AI tool: Claude Code, Cursor, ChatGPT, MCP clients) or
+ * "user" (everything else). Stamps the result on the span as
+ * `praetom.actor` so the dashboard can split traffic by caller without
+ * a second query.
+ */
+function classifyHttpCaller(headers) {
+    const ua = readHeader(headers, "user-agent");
+    if (!ua)
+        return { "praetom.actor": "user" };
+    const lc = ua.toLowerCase();
+    const isAgent = lc.includes("claude") ||
+        lc.includes("cursor") ||
+        lc.includes("chatgpt") ||
+        lc.includes("openai") ||
+        lc.includes("mcp-") ||
+        lc.includes("/mcp ") ||
+        lc.includes("anthropic-ai");
+    return {
+        "praetom.actor": isAgent ? "agent" : "user",
+        "praetom.user_agent": ua.slice(0, 256),
+    };
+}
+function readHeader(headers, key) {
+    if (typeof headers.get === "function") {
+        return (headers.get(key) ??
+            headers.get(key.toLowerCase()) ??
+            null);
+    }
+    const rec = headers;
+    return rec[key] ?? rec[key.toLowerCase()] ?? null;
+}
+/**
+ * Public primitive — fire a point-in-time event tagged with the current
+ * feature context if one exists. Use inside business logic to mark
+ * latency splits, business events, or error context that the entry-
+ * point wrap doesn't capture by itself.
+ *
+ * Outside a feature context the span still emits, but with no parent —
+ * use sparingly for top-level signals.
+ */
+export function emit(eventName, payload) {
+    if (!_state.config)
+        return;
+    const ctx = als.getStore();
+    const now = Date.now();
+    _state.buffer.push({
+        featureSlug: ctx?.slug ?? eventName,
+        name: eventName,
+        traceId: ctx?.traceId ?? randHex(16),
+        spanId: randHex(8),
+        parentSpanId: ctx?.spanId ?? null,
+        startMs: now,
+        endMs: now,
+        isError: false,
+        attributes: payload ? stringifyAttributes(payload) : undefined,
+    });
+    scheduleFlush();
+}
+function record(ctx, parentSpanId, startMs, isError, attributes) {
+    if (!_state.config)
+        return;
+    _state.buffer.push({
+        featureSlug: ctx.slug,
+        name: ctx.slug,
+        traceId: ctx.traceId,
+        spanId: ctx.spanId,
+        parentSpanId,
+        startMs,
+        endMs: Date.now(),
+        isError,
+        attributes,
+    });
+    scheduleFlush();
+}
+function scheduleFlush() {
+    if (_state.buffer.length >= FLUSH_BATCH_SIZE) {
+        void flushNow();
+        return;
+    }
+    if (!_state.flushTimer) {
+        _state.flushTimer = setTimeout(() => {
+            _state.flushTimer = null;
+            void flushNow();
+        }, FLUSH_INTERVAL_MS);
+    }
+}
+export async function flush() {
+    await flushNow();
+}
+export async function shutdown() {
+    if (_state.flushTimer) {
+        clearTimeout(_state.flushTimer);
+        _state.flushTimer = null;
+    }
+    await flushNow();
+}
+async function flushNow() {
+    if (!_state.config)
+        return;
+    if (_state.buffer.length === 0)
+        return;
+    const spans = _state.buffer;
+    _state.buffer = [];
+    const body = encodeOtlp(spans, _state.config);
+    try {
+        await fetch(_state.config.endpoint, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                authorization: `Bearer ${_state.config.token}`,
+            },
+            body: JSON.stringify(body),
+        });
+    }
+    catch {
+        // network error — drop. Telemetry must not crash the host.
+    }
+}
+function patchFetch() {
+    if (_state.fetchPatched)
+        return;
+    if (typeof globalThis.fetch !== "function")
+        return;
+    const original = globalThis.fetch.bind(globalThis);
+    globalThis.fetch = ((input, init) => {
+        const ctx = als.getStore();
+        if (!ctx)
+            return original(input, init);
+        const headers = new Headers(init?.headers ?? {});
+        if (!headers.has("traceparent")) {
+            headers.set("traceparent", buildTraceparent(ctx.traceId, ctx.spanId));
+        }
+        return original(input, { ...init, headers });
+    });
+    _state.fetchPatched = true;
+}
+function buildTraceparent(traceId, spanId) {
+    return `00-${traceId}-${spanId}-01`;
+}
+function readTraceparent(source) {
+    let raw;
+    if (typeof source.get === "function") {
+        raw = source.get("traceparent");
+    }
+    else if (source instanceof Headers) {
+        raw = source.get("traceparent");
+    }
+    else {
+        const o = source;
+        raw = o.traceparent ?? o.Traceparent ?? o.TRACEPARENT;
+    }
+    if (!raw)
+        return null;
+    const parts = raw.trim().split("-");
+    if (parts.length !== 4)
+        return null;
+    const [version, traceId, spanId] = parts;
+    if (version !== "00")
+        return null;
+    if (!/^[0-9a-f]{32}$/i.test(traceId))
+        return null;
+    if (!/^[0-9a-f]{16}$/i.test(spanId))
+        return null;
+    return { traceId: traceId.toLowerCase(), parentSpanId: spanId.toLowerCase() };
+}
+function randHex(bytes) {
+    return randomBytes(bytes).toString("hex");
+}
+function stringifyAttributes(payload) {
+    const out = {};
+    for (const [k, v] of Object.entries(payload)) {
+        if (v == null)
+            continue;
+        out[k] = typeof v === "string" ? v : JSON.stringify(v);
+    }
+    return out;
+}
+function encodeOtlp(spans, config) {
+    const resourceAttrs = [];
+    if (config.serviceName) {
+        resourceAttrs.push({
+            key: "service.name",
+            value: { stringValue: config.serviceName },
+        });
+    }
+    return {
+        resourceSpans: [
+            {
+                resource: resourceAttrs.length ? { attributes: resourceAttrs } : undefined,
+                scopeSpans: [
+                    {
+                        scope: { name: "praetom", version: "0.4.0" },
+                        spans: spans.map((s) => {
+                            const attrs = [
+                                { key: "praetom.feature", value: { stringValue: s.featureSlug } },
+                            ];
+                            if (s.attributes) {
+                                for (const [k, v] of Object.entries(s.attributes)) {
+                                    attrs.push({ key: k, value: { stringValue: v } });
+                                }
+                            }
+                            return {
+                                traceId: s.traceId,
+                                spanId: s.spanId,
+                                parentSpanId: s.parentSpanId ?? undefined,
+                                name: s.name,
+                                kind: 2,
+                                startTimeUnixNano: `${s.startMs}000000`,
+                                endTimeUnixNano: `${s.endMs}000000`,
+                                attributes: attrs,
+                                status: { code: s.isError ? 2 : 1 },
+                            };
+                        }),
+                    },
+                ],
+            },
+        ],
+    };
+}
+//# sourceMappingURL=_internal.js.map

package/dist/_internal.js.map

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

package/dist/browser.d.ts

@@ -0,0 +1,90 @@
+/**
+ * praetom — client-side customer API.
+ *
+ * Two exports, mirroring /server:
+ *   - register({ ingestId })  — call once at boot (root layout / entry)
+ *   - emit(eventName, payload?) — point-in-time event from business logic
+ *
+ *   // In a Next.js root layout or _app.tsx:
+ *   import { register } from "praetom";
+ *   register({ ingestId: "praetom_..." });  // DSN-style, public OK
+ *
+ *   // Inside a component's interaction handler:
+ *   import { emit } from "praetom";
+ *   <button onClick={() => {
+ *     emit("checkout:button-clicked");
+ *     submit();
+ *   }} />
+ *
+ * Auto-instrumentation: praetom's DB names the components that count
+ * as feature entry points. The praetom/vite (and webpack/rollup
+ * variants to follow) read the same config at build time and inject the
+ * wrap automatically — no source-level feature() calls in customer code.
+ *
+ * v1 internals:
+ *   • No native AsyncLocalStorage → module-level "current feature" stack.
+ *     Safe for single-threaded JS in the common case (one user action =
+ *     one in-flight feature). Concurrent features in true parallel (e.g.
+ *     two Promise.all-ed unrelated wraps) may attribute fetches to
+ *     whichever wrap was entered last; accepted for v1.
+ *   • Wire shape mirrors the server: OTLP/JSON via beacon on page hide,
+ *     or via fetch on interval flush. Same trace context propagation via
+ *     W3C traceparent.
+ */
+interface RegisterOptions {
+    ingestId: string;
+    /** Override the OTLP endpoint (defaults to praetom.com). */
+    endpoint?: string;
+    /** Override the runtime config endpoint (defaults to praetom.com). */
+    configEndpoint?: string;
+    /** Override the repo identifier (defaults to data-praetom-repo on <script>). */
+    repo?: string;
+    /** Suppress console.warn lines (for tests). */
+    silent?: boolean;
+}
+interface FeatureMapEntry {
+    slug: string;
+    paths: string[];
+    entrySymbol?: string;
+    side?: string;
+}
+export declare function register(opts: RegisterOptions): Promise<void>;
+/**
+ * Internal — wrap a callback as a feature entry point. NOT a public
+ * export. The bundler plugin (`praetom/vite` and friends)
+ * generates code that calls this around the entry symbols praetom's
+ * DB names. Customer source code does not contain feature() calls.
+ */
+declare function feature<T>(slug: string, fn: () => Promise<T>): Promise<T>;
+/**
+ * Fire a point-in-time event tagged with the current feature context
+ * if one exists. Use inside component code to mark interactions,
+ * business events, or latency-relevant moments that the entry-point
+ * wrap doesn't capture.
+ */
+export declare function emit(eventName: string, payload?: Record<string, unknown>): void;
+/**
+ * Internal escape hatch for the bundler plugin's generated code. NOT
+ * a public export. Exported under an underscored name so the build-
+ * tool plugin can import it without polluting the customer-facing
+ * surface. May be removed once the plugin codegen stabilizes.
+ */
+export declare const __praetomFeature: typeof feature;
+/**
+ * Browser counterpart of the server's `__praetomWrapEntryPoint`. Same
+ * shape so the bundler plugin can emit a single `__praetomWrapEntryPoint`
+ * call regardless of build layer; browser ignores `entryName` since
+ * there's no HTTP request context to continue a trace from.
+ */
+export declare function __praetomWrapEntryPoint<T>(slug: string, _entryName: string, original: (...args: unknown[]) => Promise<T> | T): (...args: unknown[]) => Promise<T>;
+/**
+ * Test-only — reset module state between tests.
+ */
+export declare function _resetForTests(): void;
+/**
+ * Read the current feature map. Useful for v1.5 bundler-plugin work
+ * where the plugin asks the runtime which paths to wrap.
+ */
+export declare function getFeatureMap(): readonly FeatureMapEntry[];
+export {};
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,UAAU,eAAe;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAuCD,wBAAsB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA6CnE;AAaD;;;;;GAKG;AACH,iBAAe,OAAO,CAAC,CAAC,EACtB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAmBZ;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAClB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAgCN;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,gBAAU,CAAC;AAExC;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAC/C,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CASpC;AAyLD;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAOrC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,SAAS,eAAe,EAAE,CAE1D"}