convex-tracer 0.1.0

package/dist/client/index.js

@@ -0,0 +1,355 @@
+import { actionGeneric, internalActionGeneric, internalMutationGeneric, mutationGeneric, } from "convex/server";
+import { v } from "convex/values";
+import { statusValidator } from "../component/schema";
+import { executeTracedHandler, extractTraceContext, prepareLogArgs, setupTraceContext, } from "./helpers";
+import TracingAPI from "./tracer-api";
+export * from "../component/types";
+const DEFAULT_CONFIG = {
+    sampleRate: 0.1,
+    preserveErrors: true,
+    retentionMinutes: 120,
+};
+const __traceContext = v.optional(v.object({
+    traceId: v.string(),
+    spanId: v.string(),
+    sampleRate: v.optional(v.number()),
+    retentionMinutes: v.optional(v.number()),
+    preserveErrors: v.optional(v.boolean()),
+}));
+/**
+ * @example
+ * ```typescript
+ * import { components } from "./_generated/api";
+ * import { mutation, action } from "./_generated/server";
+ * import { Tracer } from "@convex-dev/tracer";
+ *
+ * export const { tracedQuery, tracedMutation, tracedAction } = new Tracer(components.tracer, {
+ *   sampleRate: 0.1,
+ *   preserveErrors: true,
+ * });
+ *
+ * export const createPost = tracedMutation({
+ *   name: "createPost",
+ *   args: { title: v.string() },
+ *   handler: async (ctx, args) => {
+ *     await ctx.tracer.info("Creating post");
+ *     return await ctx.db.insert("posts", args);
+ *   },
+ * });
+ * ```
+ */
+export class Tracer {
+    component;
+    sampleRate;
+    preserveErrors;
+    retentionMinutes;
+    constructor(component, config = {}) {
+        this.component = component;
+        this.sampleRate = config.sampleRate ?? DEFAULT_CONFIG.sampleRate;
+        this.preserveErrors =
+            config.preserveErrors ?? DEFAULT_CONFIG.preserveErrors;
+        this.retentionMinutes =
+            config.retentionMinutes ?? DEFAULT_CONFIG.retentionMinutes;
+    }
+    createRunTracedFunction(ctx, traceContext, type) {
+        return async (funcRef, args) => {
+            const argsWithTrace = {
+                ...args,
+                __traceContext: traceContext,
+            };
+            if (type === "action") {
+                return await ctx.runAction(funcRef, argsWithTrace);
+            }
+            return await ctx.runMutation(funcRef, argsWithTrace);
+        };
+    }
+    createRestrictedQueryContext(ctx, traceContext) {
+        const tracerConfig = {
+            sampleRate: this.sampleRate,
+            preserveErrors: this.preserveErrors,
+            retentionMinutes: this.retentionMinutes,
+        };
+        const { db, storage, ...restOfCtx } = ctx;
+        const { get, query, normalizeId, system } = db;
+        const { getUrl, getMetadata } = storage;
+        const queryCtx = {
+            ...restOfCtx,
+            db: { get, query, normalizeId, system },
+            storage: { getUrl, getMetadata },
+        };
+        return {
+            ...queryCtx,
+            tracer: new TracingAPI(ctx, this.component, traceContext.traceId, traceContext.spanId, tracerConfig),
+            runTracedQuery: this.createRunTracedFunction(ctx, traceContext, "mutation"),
+        };
+    }
+    createEnhancedContext(ctx, traceContext, type) {
+        const tracerConfig = {
+            sampleRate: this.sampleRate,
+            preserveErrors: this.preserveErrors,
+            retentionMinutes: this.retentionMinutes,
+        };
+        if (type === "query") {
+            return this.createRestrictedQueryContext(ctx, traceContext);
+        }
+        const baseCtx = {
+            ...ctx,
+            tracer: new TracingAPI(ctx, this.component, traceContext.traceId, traceContext.spanId, tracerConfig),
+            runTracedQuery: this.createRunTracedFunction(ctx, traceContext, "mutation"),
+            runTracedMutation: this.createRunTracedFunction(ctx, traceContext, "mutation"),
+        };
+        if (type === "mutation") {
+            return baseCtx;
+        }
+        if (type === "action") {
+            return {
+                ...baseCtx,
+                runTracedAction: this.createRunTracedFunction(ctx, traceContext, "action"),
+            };
+        }
+        throw new Error(`Unexpected function type: ${type}`);
+    }
+    createTracedHandler(tConfig, functionType, defaultName) {
+        const functionName = tConfig.name || defaultName;
+        return async (ctx, allArgs) => {
+            const startTime = Date.now();
+            const { existingContext, args } = extractTraceContext(allArgs);
+            const { traceId, spanId, traceContext, isRoot } = await setupTraceContext(ctx, this.component, existingContext, startTime, functionName, tConfig.sampleRate ?? this.sampleRate, tConfig.retentionMinutes ?? this.retentionMinutes, tConfig.preserveErrors ?? this.preserveErrors, {
+                functionName,
+                args: prepareLogArgs(args, tConfig.logArgs),
+            });
+            const enhancedCtx = this.createEnhancedContext(ctx, traceContext, functionType);
+            return await executeTracedHandler({
+                ctx: ctx,
+                component: this.component,
+                traceId,
+                spanId,
+                startTime,
+                config: tConfig,
+                args,
+                handler: tConfig.handler,
+                enhancedCtx,
+                isRoot,
+            });
+        };
+    }
+    /**
+     * Creates a traced query (runs as mutation internally).
+     * @example
+     * ```ts
+     * export const getUser = tracedQuery({
+     *   name: "getUser",
+     *   args: { userId: v.id("users") },
+     *   onSuccess: async (ctx, args, result) => {
+     *     await ctx.tracer.info("Succeeded user fetch", { userId: args.userId });
+     *   },
+     *   handler: async (ctx, args) => {
+     *     await ctx.tracer.info("fetching user", { title: args.userId });
+     *     const user = await ctx.db.get(args.userId);
+     *     await ctx.tracer.info("user fetched", { userId: args.userId });
+     *     return user;
+     *   },
+     * });
+     * ```
+     */
+    tracedQuery = (tConfig) => {
+        return mutationGeneric({
+            args: {
+                ...tConfig.args,
+                __traceContext,
+            },
+            handler: this.createTracedHandler(tConfig, "query", "anonymous-query"),
+        });
+    };
+    /**
+     * Creates a traced query (runs as mutation internally).
+     * @example
+     * ```ts
+     * export const getUser = internalTracedQuery({
+     *   name: "getUser",
+     *   args: { userId: v.id("users") },
+     *   onSuccess: async (ctx, args, result) => {
+     *     await ctx.tracer.info("Succeeded user fetch", { userId: args.userId });
+     *   },
+     *   handler: async (ctx, args) => {
+     *     await ctx.tracer.info("fetching user", { title: args.userId });
+     *     const user = await ctx.db.get(args.userId);
+     *     await ctx.tracer.info("user fetched", { userId: args.userId });
+     *     return user;
+     *   },
+     * });
+     * ```
+     */
+    internalTracedQuery = (tConfig) => {
+        return internalMutationGeneric({
+            args: {
+                ...tConfig.args,
+                __traceContext,
+            },
+            handler: this.createTracedHandler(tConfig, "query", "anonymous-internal-query"),
+        });
+    };
+    /**
+     * Creates a traced mutation.
+     * @example
+     * ```ts
+     * export const createUser = tracedMutation({
+     *   name: "createUser",
+     *   args: { user: v.object({ name: v.string(), email: v.string() }) },
+     *   handler: async (ctx, args) => {
+     *     const existing = await ctx.db
+     *       .query("users")
+     *       .withIndex("by_email", (q) => q.eq("email", args.user.email))
+     *       .first();
+     *
+     *     if (existing) {
+     *       ctx.tracer.info("User already exists", { user: args.user });
+     *       return existing._id;
+     *     }
+     *
+     *     ctx.tracer.info("Adding user", { ...args.user });
+     *
+     *     const userId = await ctx.db.insert("users", { ...args.user });
+     *     ctx.tracer.info("User added", { userId });
+     *
+     *     await ctx.tracer.withSpan("syncUser", async (span) => {
+     *       span.info("Syncing user");
+     *       // do something
+     *       span.info("User synced");
+     *     });
+     *
+     *     return userId;
+     *   },
+     * });
+     * ```
+     */
+    tracedMutation = (tConfig) => {
+        return mutationGeneric({
+            args: {
+                ...tConfig.args,
+                __traceContext,
+            },
+            handler: this.createTracedHandler(tConfig, "mutation", "anonymous-mutation"),
+        });
+    };
+    /**
+     * Creates a traced mutation.
+     * @example
+     * ```ts
+     * export const createUser = internalTracedMutation({
+     *   name: "createUser",
+     *   args: { user: v.object({ name: v.string(), email: v.string() }) },
+     *   handler: async (ctx, args) => {
+     *     const existing = await ctx.db
+     *       .query("users")
+     *       .withIndex("by_email", (q) => q.eq("email", args.user.email))
+     *       .first();
+     *
+     *     if (existing) {
+     *       await ctx.tracer.info("User already exists", { user: args.user });
+     *       return existing._id;
+     *     }
+     *
+     *     await ctx.tracer.info("Adding user", { ...args.user });
+     *
+     *     const userId = await ctx.db.insert("users", { ...args.user });
+     *     ctx.tracer.info("User added", { userId });
+     *
+     *     await ctx.tracer.withSpan("syncUser", async (span) => {
+     *       await span.info("Syncing user");
+     *       // do something
+     *       await span.info("User synced");
+     *     });
+     *
+     *     return userId;
+     *   },
+     * });
+     * ```
+     */
+    internalTracedMutation = (tConfig) => {
+        return internalMutationGeneric({
+            args: {
+                ...tConfig.args,
+                __traceContext,
+            },
+            handler: this.createTracedHandler(tConfig, "mutation", "anonymous-internal-mutation"),
+        });
+    };
+    /**
+     * Creates a traced action.
+     * @example
+     * ```ts
+     * export const someAction = tracedAction({
+     *   name: "someAction",
+     *   args: { userId: v.id("users") },
+     *   handler: async (ctx, args) => {
+     *     // do something
+     *   },
+     * });
+     * ```
+     */
+    tracedAction = (tConfig) => {
+        return actionGeneric({
+            args: {
+                ...tConfig.args,
+                __traceContext,
+            },
+            handler: this.createTracedHandler(tConfig, "action", "anonymous-action"),
+        });
+    };
+    /**
+     * Creates a traced action.
+     * @example
+     * ```ts
+     * export const someAction = internalTracedAction({
+     *   name: "someAction",
+     *   args: { userId: v.id("users") },
+     *   handler: async (ctx, args) => {
+     *     // do something
+     *   },
+     * });
+     * ```
+     */
+    internalTracedAction = (tConfig) => {
+        return internalActionGeneric({
+            args: {
+                ...tConfig.args,
+                __traceContext,
+            },
+            handler: this.createTracedHandler(tConfig, "action", "anonymous-internal-action"),
+        });
+    };
+    get tracer() {
+        return {
+            /**
+             * Retrieves a trace by its ID.
+             * @param traceId - The ID of the trace to retrieve.
+             * @example
+             * ```ts
+             * // In a convex function (query, mutation, or action)
+             * // Or in a traced function
+             * const trace = await tracer.getTrace("123")
+             * ```
+             */
+            getTrace: async (ctx, traceId) => {
+                return await ctx.runQuery(this.component.lib.getTrace, { traceId });
+            },
+            /**
+             * Lists traces with optional filtering by status.
+             * @param status - The status of the traces to retrieve.
+             * @param limit - The maximum number of traces to retrieve.
+             * @param userId - The ID of the user to retrieve traces for.
+             * @example
+             * ```ts
+             * // In a convex function (query, mutation, or action)
+             * // Or in a traced function
+             * const traces = await tracer.listTraces({ status: "success", limit: 10 })
+             * ```
+             */
+            listTraces: async (ctx, args) => {
+                return await ctx.runQuery(this.component.lib.listTraces, { ...args });
+            },
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

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

package/dist/client/tracer-api/index.d.ts

@@ -0,0 +1,27 @@
+import type { GenericActionCtx, GenericDataModel, GenericMutationCtx } from "convex/server";
+import type { ComponentApi } from "../../component/_generated/component";
+import type { TracerConfig } from "../types";
+import type { SpanAPI, TraceAPI } from "./types";
+export default class TracingAPI implements TraceAPI {
+    private ctx;
+    private component;
+    private traceId;
+    private spanId;
+    private config;
+    constructor(ctx: GenericMutationCtx<GenericDataModel> | GenericActionCtx<GenericDataModel>, component: ComponentApi, traceId: string, spanId: string, config: TracerConfig);
+    private addLog;
+    getTraceId(): string;
+    getSpanId(): string;
+    info(message: string, metadata?: Record<string, any>): Promise<void>;
+    warn(message: string, metadata?: Record<string, any>): Promise<void>;
+    error(message: string, metadata?: Record<string, any>): Promise<void>;
+    preserve(): Promise<void>;
+    discard(): Promise<void>;
+    sample(sampleRate?: number): Promise<void>;
+    withSpan<T>(spanName: string, fn: (span: SpanAPI) => Promise<T>): Promise<T>;
+    updateMetadata(metadata: Record<string, any>): Promise<void>;
+    private createSpanAPI;
+    private createAndRunSpan;
+    private createNoOpSpanAPI;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/client/tracer-api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/tracer-api/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEjD,MAAM,CAAC,OAAO,OAAO,UAAW,YAAW,QAAQ;IAE/C,OAAO,CAAC,GAAG;IAGX,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;gBANN,GAAG,EACP,kBAAkB,CAAC,gBAAgB,CAAC,GACpC,gBAAgB,CAAC,gBAAgB,CAAC,EAC9B,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY;YAGhB,MAAM;IAepB,UAAU,IAAI,MAAM;IAIpB,SAAS,IAAI,MAAM;IAIb,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAGpE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAGpE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IASzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IASxB,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY1C,QAAQ,CAAC,CAAC,EACd,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,GAChC,OAAO,CAAC,CAAC,CAAC;IAIP,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IASlE,OAAO,CAAC,aAAa;YAiEP,gBAAgB;IA0D9B,OAAO,CAAC,iBAAiB;CAW1B"}

package/dist/client/tracer-api/index.js

@@ -0,0 +1,177 @@
+export default class TracingAPI {
+    ctx;
+    component;
+    traceId;
+    spanId;
+    config;
+    constructor(ctx, component, traceId, spanId, config) {
+        this.ctx = ctx;
+        this.component = component;
+        this.traceId = traceId;
+        this.spanId = spanId;
+        this.config = config;
+    }
+    async addLog(severity, message, metadata) {
+        await this.ctx
+            .runMutation(this.component.lib.addLog, {
+            spanId: this.spanId,
+            log: { timestamp: Date.now(), severity, message, metadata },
+        })
+            .catch((err) => console.error(`[Tracer] Failed to add ${severity} log:`, err));
+    }
+    getTraceId() {
+        return this.traceId;
+    }
+    getSpanId() {
+        return this.spanId;
+    }
+    async info(message, metadata) {
+        await this.addLog("info", message, metadata);
+    }
+    async warn(message, metadata) {
+        await this.addLog("warn", message, metadata);
+    }
+    async error(message, metadata) {
+        await this.addLog("error", message, metadata);
+    }
+    async preserve() {
+        await this.ctx
+            .runMutation(this.component.lib.updateTracePreserve, {
+            traceId: this.traceId,
+            preserve: true,
+        })
+            .catch((err) => console.error("[Tracer] Failed to preserve trace:", err));
+    }
+    async discard() {
+        await this.ctx
+            .runMutation(this.component.lib.updateTracePreserve, {
+            traceId: this.traceId,
+            preserve: false,
+        })
+            .catch((err) => console.error("[Tracer] Failed to discard trace:", err));
+    }
+    async sample(sampleRate) {
+        await this.ctx
+            .runMutation(this.component.lib.updateTracePreserve, {
+            traceId: this.traceId,
+            preserve: undefined,
+            sampleRate,
+        })
+            .catch((err) => console.error("[Tracer] Failed to reset trace sampling:", err));
+    }
+    async withSpan(spanName, fn) {
+        return await this.createAndRunSpan(this.spanId, spanName, fn);
+    }
+    async updateMetadata(metadata) {
+        await this.ctx
+            .runMutation(this.component.lib.updateSpanMetadata, {
+            spanId: this.spanId,
+            metadata,
+        })
+            .catch((err) => console.error("[Tracer] Failed to set metadata:", err));
+    }
+    createSpanAPI(spanId) {
+        return {
+            info: async (message, metadata) => {
+                await this.ctx
+                    .runMutation(this.component.lib.addLog, {
+                    spanId,
+                    log: { timestamp: Date.now(), severity: "info", message, metadata },
+                })
+                    .catch((err) => console.error("[Tracer] Failed to add info log to child span:", err));
+            },
+            warn: async (message, metadata) => {
+                await this.ctx
+                    .runMutation(this.component.lib.addLog, {
+                    spanId,
+                    log: { timestamp: Date.now(), severity: "warn", message, metadata },
+                })
+                    .catch((err) => console.error("[Tracer] Failed to add warn log to child span:", err));
+            },
+            error: async (message, metadata) => {
+                await this.ctx
+                    .runMutation(this.component.lib.addLog, {
+                    spanId,
+                    log: {
+                        timestamp: Date.now(),
+                        severity: "error",
+                        message,
+                        metadata,
+                    },
+                })
+                    .catch((err) => console.error("[Tracer] Failed to add error log to child span:", err));
+            },
+            updateMetadata: async (metadata) => {
+                await this.ctx
+                    .runMutation(this.component.lib.updateSpanMetadata, {
+                    spanId,
+                    metadata,
+                })
+                    .catch((err) => console.error("[Tracer] Failed to set child span metadata:", err));
+            },
+            withSpan: async (spanName, fn) => {
+                return await this.createAndRunSpan(spanId, spanName, fn);
+            },
+        };
+    }
+    async createAndRunSpan(parentSpanId, spanName, fn) {
+        let childSpanId;
+        try {
+            childSpanId = await this.ctx.runMutation(this.component.lib.createSpan, {
+                traceId: this.traceId,
+                span: {
+                    parentSpanId,
+                    spanName,
+                    source: "backend",
+                    startTime: Date.now(),
+                    status: "pending",
+                },
+            });
+        }
+        catch (err) {
+            console.error("[Tracer] Failed to create child span:", err);
+            return await fn(this.createNoOpSpanAPI());
+        }
+        const spanAPI = this.createSpanAPI(childSpanId);
+        const startTime = Date.now();
+        try {
+            const result = await fn(spanAPI);
+            await this.ctx
+                .runMutation(this.component.lib.completeSpan, {
+                spanId: childSpanId,
+                endTime: Date.now(),
+                duration: Date.now() - startTime,
+                status: "success",
+            })
+                .catch((err) => console.error("[Tracer] Failed to complete span:", err));
+            return result;
+        }
+        catch (error) {
+            await this.ctx
+                .runMutation(this.component.lib.completeSpan, {
+                spanId: childSpanId,
+                endTime: Date.now(),
+                duration: Date.now() - startTime,
+                status: "error",
+                error: error instanceof Error ? error.message : String(error),
+            })
+                .catch((err) => console.error("[Tracer] Failed to complete span with error:", err));
+            if (this.config.preserveErrors) {
+                await this.preserve();
+            }
+            throw error;
+        }
+    }
+    createNoOpSpanAPI() {
+        return {
+            info: async () => { },
+            warn: async () => { },
+            error: async () => { },
+            updateMetadata: async () => { },
+            withSpan: async () => {
+                return undefined;
+            },
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/client/tracer-api/index.js.map

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