convex-tracer 0.1.0 → 0.1.1

package/dist/component/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/component/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAc,MAAM,eAAe,CAAC;AAC9C,OAAO,MAAM,MAAM,UAAU,CAAC;AAE9B,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC;IAC1D,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;CAC1B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS;KAC/C,IAAI,CAAC,cAAc,CAAC;KACpB,IAAI,CAAC,SAAS,CAAC;KACf,MAAM,CAAC;IACN,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACpC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;CAC1B,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;IACrE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;CAC1B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;CACvC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;CAC9B,CAAC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/component/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,CAAC,EAAc,MAAM,eAAe,CAAC;AAC9C,OAAO,MAAM,MAAM,UAAU,CAAC;AAE9B,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC;IAC1D,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;CAC1B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAElE,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS;KAC/C,IAAI,CAAC,cAAc,CAAC;KACpB,IAAI,CAAC,SAAS,CAAC;KACf,MAAM,CAAC;IACN,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACpC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;CAC1B,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;IACrE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;CAC1B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;CACvC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;CAC9B,CAAC,CAAC"}

package/package.json

@@ -9,7 +9,7 @@
   "bugs": {
     "url": "https://github.com/Moumen-io/convex-tracer/issues"
   },
-  "version": "0.1.0",
+  "version": "0.1.1",
   "license": "Apache-2.0",
   "keywords": [
     "convex",

package/src/client/helpers.ts

@@ -1,4 +1,4 @@
-import type { GenericDataModel } from "convex/server";
+import type { Auth, GenericDataModel } from "convex/server";
 import type { ObjectType, PropertyValidators } from "convex/values";
 import type { ComponentApi } from "../component/_generated/component";
 import TracerAPI from "./tracer-api/index";
@@ -25,6 +25,14 @@ function pick<T extends Record<string, any>, Keys extends (keyof T)[]>(
   };
 }
 
+async function getAuthUserId(ctx: { auth: Auth }) {
+  const identity = await ctx.auth.getUserIdentity();
+  if (identity === null) return "anonymous";
+
+  const [userId] = identity.subject.split("|");
+  return userId;
+}
+
 export function extractTraceContext<Args extends Record<string, unknown>>(
   allArgs: ArgsWithTraceContext<Args>,
 ): { existingContext?: TraceContext; args: Args } {
@@ -90,11 +98,13 @@ export async function setupTraceContext(
     };
   }
 
+  const userId = await getAuthUserId(ctx);
   const traceId = await ctx.runMutation(component.lib.createTrace, {
     status: "pending",
     sampleRate,
     metadata: {},
     source: "backend",
+    userId,
   });
 
   const spanId = await ctx.runMutation(component.lib.createSpan, {

package/src/client/index.ts

@@ -1,12 +1,16 @@
-import type { FunctionType, GenericQueryCtx } from "convex/server";
+import type {
+  FunctionType,
+  GenericQueryCtx,
+  paginationOptsValidator,
+} from "convex/server";
 import {
   actionGeneric,
-  type GenericActionCtx,
-  type GenericDataModel,
-  type GenericMutationCtx,
   internalActionGeneric,
   internalMutationGeneric,
   mutationGeneric,
+  type GenericActionCtx,
+  type GenericDataModel,
+  type GenericMutationCtx,
   type RegisteredAction,
   type RegisteredMutation,
 } from "convex/server";
@@ -14,7 +18,7 @@ import type { Infer, PropertyValidators } from "convex/values";
 import { v } from "convex/values";
 import type { ComponentApi } from "../component/_generated/component";
 import { statusValidator } from "../component/schema";
-import type { CompleteTrace, Trace } from "../component/types";
+import { type CompleteTrace, type paginatedTraces } from "../component/types";
 import type { EmptyObject } from "../react/types";
 import {
   executeTracedHandler,
@@ -40,6 +44,11 @@ import type {
   TracerHandler,
 } from "./types";
 
+export {
+  severityValidator,
+  sourceValidator,
+  statusValidator,
+} from "../component/schema";
 export * from "../component/types";
 
 const DEFAULT_CONFIG: Required<TracerConfig> = {
@@ -571,6 +580,9 @@ export class Tracer<DataModel extends GenericDataModel> {
        * @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.
+       * @param paginationOpts - Convex pagination options.
+       * @returns A pagination result containing the page of results and a
+       * cursor to continue paginating.
        * @example
        * ```ts
        * // In a convex function (query, mutation, or action)
@@ -580,13 +592,34 @@ export class Tracer<DataModel extends GenericDataModel> {
        */
       listTraces: async (
         ctx: GenericFunctionContext<DataModel>,
-        args?: {
+        args: {
           status?: Infer<typeof statusValidator>;
-          limit?: number;
           userId?: string;
+          paginationOpts: Infer<typeof paginationOptsValidator>;
+        },
+      ): Promise<paginatedTraces> => {
+        return await ctx.runQuery(this.component.lib.listTraces, args);
+      },
+
+      /**
+       * Searches for traces by function name.
+       * @param functionName - The name of the function to search for.
+       * @param userId - The ID of the user to search for.
+       * @param status - The status of the traces to search for.
+       * @param paginationOpts - Convex pagination options.
+       * @returns A pagination result containing the page of results and a
+       * cursor to continue paginating.
+       */
+      searchTraces: async (
+        ctx: GenericFunctionContext<DataModel>,
+        args: {
+          functionName: string;
+          userId?: string;
+          status?: Infer<typeof statusValidator>;
+          paginationOpts: Infer<typeof paginationOptsValidator>;
         },
-      ): Promise<Trace[]> => {
-        return await ctx.runQuery(this.component.lib.listTraces, { ...args });
+      ): Promise<paginatedTraces> => {
+        return await ctx.runQuery(this.component.lib.searchTraces, args);
       },
     };
   }

package/src/component/_generated/component.ts

@@ -86,6 +86,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
           sampleRate: number;
           source: "frontend" | "backend";
           status: "pending" | "success" | "error";
+          userId: "anonymous" | string;
         },
         string,
         Name
@@ -97,6 +98,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         null | {
           _creationTime: number;
           _id: string;
+          functionName?: string;
           metadata?: Record<string, any>;
           preserve?: boolean;
           sampleRate: number;
@@ -137,20 +139,69 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         "query",
         "internal",
         {
-          limit?: number;
+          paginationOpts: {
+            cursor: string | null;
+            endCursor?: string | null;
+            id?: number;
+            maximumBytesRead?: number;
+            maximumRowsRead?: number;
+            numItems: number;
+          };
           status?: "pending" | "success" | "error";
           userId?: string;
         },
-        Array<{
-          _creationTime: number;
-          _id: string;
-          metadata?: Record<string, any>;
-          preserve?: boolean;
-          sampleRate: number;
-          status: "pending" | "success" | "error";
-          updatedAt: number;
+        {
+          continueCursor: string;
+          isDone: boolean;
+          page: Array<{
+            _creationTime: number;
+            _id: string;
+            functionName?: string;
+            metadata?: Record<string, any>;
+            preserve?: boolean;
+            sampleRate: number;
+            status: "pending" | "success" | "error";
+            updatedAt: number;
+            userId?: string;
+          }>;
+          pageStatus?: "SplitRecommended" | "SplitRequired" | null;
+          splitCursor?: string | null;
+        },
+        Name
+      >;
+      searchTraces: FunctionReference<
+        "query",
+        "internal",
+        {
+          functionName: string;
+          paginationOpts: {
+            cursor: string | null;
+            endCursor?: string | null;
+            id?: number;
+            maximumBytesRead?: number;
+            maximumRowsRead?: number;
+            numItems: number;
+          };
+          status?: "pending" | "success" | "error";
           userId?: string;
-        }>,
+        },
+        {
+          continueCursor: string;
+          isDone: boolean;
+          page: Array<{
+            _creationTime: number;
+            _id: string;
+            functionName?: string;
+            metadata?: Record<string, any>;
+            preserve?: boolean;
+            sampleRate: number;
+            status: "pending" | "success" | "error";
+            updatedAt: number;
+            userId?: string;
+          }>;
+          pageStatus?: "SplitRecommended" | "SplitRequired" | null;
+          splitCursor?: string | null;
+        },
         Name
       >;
       updateSpanMetadata: FunctionReference<

package/src/component/lib.ts

@@ -2,15 +2,16 @@
  * Internal mutations for managing traces, spans, and logs.
  * These are called automatically by the tracing system to persist data immediately.
  */
+import { paginationOptsValidator } from "convex/server";
 import { v } from "convex/values";
 import type { Id } from "./_generated/dataModel.js";
 import { mutation, query, type MutationCtx } from "./_generated/server.js";
-import schema, {
+import {
   severityValidator,
   sourceValidator,
   statusValidator,
 } from "./schema.js";
-import { vCompleteTrace } from "./types.js";
+import { vCompleteTrace, vPaginatedTraces } from "./types.js";
 
 // ============================================================================
 // Trace Operations
@@ -26,6 +27,7 @@ export const createTrace = mutation({
     sampleRate: v.number(),
     metadata: v.optional(v.record(v.string(), v.any())),
     source: sourceValidator,
+    userId: v.union(v.literal("anonymous"), v.string()),
   },
   returns: v.id("traces"),
   handler: async (ctx, args): Promise<Id<"traces">> => {
@@ -34,6 +36,7 @@ export const createTrace = mutation({
       sampleRate: args.sampleRate,
       updatedAt: Date.now(),
       metadata: args.metadata,
+      userId: args.userId,
     });
   },
 });
@@ -305,34 +308,75 @@ export const getTrace = query({
 export const listTraces = query({
   args: {
     status: v.optional(statusValidator),
-    limit: v.optional(v.number()),
     userId: v.optional(v.string()),
+    paginationOpts: paginationOptsValidator,
   },
-  returns: v.array(
-    schema.tables.traces.validator.extend({
-      _id: v.id("traces"),
-      _creationTime: v.number(),
-    }),
-  ),
-  handler: async (ctx, { status, limit, userId }) => {
-    const query =
-      status && !userId
-        ? ctx.db
-            .query("traces")
-            .withIndex("by_status", (q) => q.eq("status", status))
-        : !status && userId
-          ? ctx.db
-              .query("traces")
-              .withIndex("by_userId", (q) => q.eq("userId", userId))
-          : status && userId
-            ? ctx.db
-                .query("traces")
-                .withIndex("by_status_and_userId", (q) =>
-                  q.eq("status", status).eq("userId", userId),
-                )
-            : ctx.db.query("traces");
-
-    return await query.order("desc").take(limit ?? 100);
+  returns: vPaginatedTraces,
+  handler: async (ctx, { status, userId, paginationOpts }) => {
+    const query = ctx.db.query("traces");
+
+    if (status && !userId) {
+      return await query
+        .withIndex("by_status", (q) => q.eq("status", status))
+        .order("desc")
+        .paginate(paginationOpts);
+    } else if (!status && userId) {
+      return await query
+        .withIndex("by_userId", (q) => q.eq("userId", userId))
+        .order("desc")
+        .paginate(paginationOpts);
+    } else if (status && userId) {
+      return await query
+        .withIndex("by_status_and_userId", (q) =>
+          q.eq("status", status).eq("userId", userId),
+        )
+        .order("desc")
+        .paginate(paginationOpts);
+    }
+
+    return await query.order("desc").paginate(paginationOpts);
+  },
+});
+
+export const searchTraces = query({
+  args: {
+    functionName: v.string(),
+    userId: v.optional(v.string()),
+    status: v.optional(statusValidator),
+    paginationOpts: paginationOptsValidator,
+  },
+  returns: vPaginatedTraces,
+  handler: async (ctx, { functionName, paginationOpts, userId, status }) => {
+    const query = ctx.db.query("traces");
+
+    if (userId && !status) {
+      return await query
+        .withSearchIndex("by_function_name", (q) =>
+          q.search("functionName", functionName).eq("userId", userId),
+        )
+        .paginate(paginationOpts);
+    } else if (status && !userId) {
+      return await query
+        .withSearchIndex("by_function_name", (q) =>
+          q.search("functionName", functionName).eq("status", status),
+        )
+        .paginate(paginationOpts);
+    } else if (userId && status) {
+      return await query
+        .withSearchIndex("by_function_name", (q) =>
+          q
+            .search("functionName", functionName)
+            .eq("userId", userId)
+            .eq("status", status),
+        )
+        .paginate(paginationOpts);
+    }
+
+    return await query
+      .withSearchIndex("by_function_name", (q) =>
+        q.search("functionName", functionName),
+      )
+      .paginate(paginationOpts);
   },
 });
 

package/src/component/schema.ts

@@ -25,11 +25,16 @@ export default defineSchema({
     preserve: v.optional(v.boolean()),
     updatedAt: v.number(),
     metadata: v.optional(v.record(v.string(), v.any())),
+    functionName: v.optional(v.string()),
     userId: v.optional(v.string()),
   })
     .index("by_status", ["status"])
     .index("by_userId", ["userId"])
-    .index("by_status_and_userId", ["status", "userId"]),
+    .index("by_status_and_userId", ["status", "userId"])
+    .searchIndex("by_function_name", {
+      searchField: "functionName",
+      filterFields: ["status", "userId"],
+    }),
 
   spans: defineTable({
     traceId: v.id("traces"),

package/src/component/types.ts

@@ -1,3 +1,4 @@
+import { paginationResultValidator } from "convex/server";
 import { v, type Infer } from "convex/values";
 import schema from "./schema";
 
@@ -6,6 +7,8 @@ export const vTrace = schema.tables.traces.validator.extend({
   _creationTime: v.number(),
 });
 
+export const vPaginatedTraces = paginationResultValidator(vTrace);
+
 export const vSpan = schema.tables.spans.validator
   .omit("parentSpanId")
   .omit("traceId")
@@ -36,3 +39,4 @@ export type Span = Infer<typeof vSpan>;
 export type Log = Infer<typeof vLog>;
 export type SpanWithLogs = Infer<typeof vSpanWithLogs>;
 export type CompleteTrace = Infer<typeof vCompleteTrace>;
+export type paginatedTraces = Infer<typeof vPaginatedTraces>;

package/dist/client/_generated/_ignore.d.ts

@@ -1 +0,0 @@
-//# sourceMappingURL=_ignore.d.ts.map

package/dist/client/_generated/_ignore.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"_ignore.d.ts","sourceRoot":"","sources":["../../../src/client/_generated/_ignore.ts"],"names":[],"mappings":""}

package/dist/client/_generated/_ignore.js

@@ -1,3 +0,0 @@
-"use strict";
-// This is only here so convex-test can detect a _generated folder
-//# sourceMappingURL=_ignore.js.map

package/dist/client/_generated/_ignore.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"_ignore.js","sourceRoot":"","sources":["../../../src/client/_generated/_ignore.ts"],"names":[],"mappings":";AAAA,kEAAkE"}

package/dist/client/helpers.d.ts

@@ -1,31 +0,0 @@
-import type { GenericDataModel } from "convex/server";
-import type { ObjectType, PropertyValidators } from "convex/values";
-import type { ComponentApi } from "../component/_generated/component";
-import type { ArgsWithTraceContext, LogArgs, OptionalArgsObject, StrippedGenericFunctionContext, TraceContext, TracedFunctionOptions, TracedResult, TracerConfig, TracerHandler } from "./types";
-export declare function extractTraceContext<Args extends Record<string, unknown>>(allArgs: ArgsWithTraceContext<Args>): {
-    existingContext?: TraceContext;
-    args: Args;
-};
-export declare function prepareLogArgs<Args extends PropertyValidators>(args: ObjectType<Args>, logArgs: LogArgs<Args>): unknown | undefined;
-export declare function setupTraceContext(ctx: StrippedGenericFunctionContext<GenericDataModel>, component: ComponentApi, existingContext: TraceContext | undefined, startTime: number, functionName: string, sampleRate: number, retentionMinutes: number, preserveErrors: boolean, spanData: {
-    functionName?: string;
-    args?: unknown;
-}): Promise<{
-    traceId: string;
-    spanId: string;
-    traceContext: TraceContext;
-    isRoot: boolean;
-}>;
-export declare function executeTracedHandler<Args extends PropertyValidators, Output, EnhancedCtx>(params: {
-    ctx: StrippedGenericFunctionContext<GenericDataModel>;
-    component: ComponentApi;
-    traceId: string;
-    spanId: string;
-    startTime: number;
-    config: TracedFunctionOptions<EnhancedCtx, Args, Output> & TracerConfig;
-    args: OptionalArgsObject<Args>;
-    handler: TracerHandler<EnhancedCtx, Args>;
-    enhancedCtx: EnhancedCtx;
-    isRoot: boolean;
-}): Promise<TracedResult<Output>>;
-//# sourceMappingURL=helpers.d.ts.map

package/dist/client/helpers.js

@@ -1,177 +0,0 @@
-import TracerAPI from "./tracer-api/index";
-function pick(obj, keys) {
-    return Object.fromEntries(Object.entries(obj).filter(([k]) => keys.includes(k)));
-}
-export function extractTraceContext(allArgs) {
-    const existingContext = allArgs.__traceContext;
-    const args = { ...allArgs };
-    delete args.__traceContext;
-    return { existingContext, args };
-}
-export function prepareLogArgs(args, logArgs) {
-    if (!logArgs)
-        return undefined;
-    if (logArgs === true)
-        return args;
-    if (Array.isArray(logArgs)) {
-        return pick(args, logArgs);
-    }
-    return undefined;
-}
-export async function setupTraceContext(ctx, component, existingContext, startTime, functionName, sampleRate, retentionMinutes, preserveErrors, spanData) {
-    if (existingContext?.traceId) {
-        const spanId = await ctx.runMutation(component.lib.createSpan, {
-            traceId: existingContext.traceId,
-            span: {
-                parentSpanId: existingContext.spanId,
-                spanName: functionName,
-                source: "backend",
-                startTime,
-                status: "pending",
-                functionName: spanData.functionName,
-                args: spanData.args,
-            },
-        });
-        return {
-            traceId: existingContext.traceId,
-            spanId,
-            traceContext: {
-                traceId: existingContext.traceId,
-                spanId,
-                sampleRate: existingContext.sampleRate,
-                retentionMinutes: existingContext.retentionMinutes,
-                preserveErrors: existingContext.preserveErrors,
-            },
-            isRoot: false,
-        };
-    }
-    const traceId = await ctx.runMutation(component.lib.createTrace, {
-        status: "pending",
-        sampleRate,
-        metadata: {},
-        source: "backend",
-    });
-    const spanId = await ctx.runMutation(component.lib.createSpan, {
-        traceId,
-        span: {
-            spanName: functionName,
-            source: "backend",
-            startTime: Date.now(),
-            status: "pending",
-            functionName: spanData.functionName,
-            args: spanData.args,
-        },
-    });
-    return {
-        traceId,
-        spanId,
-        traceContext: {
-            traceId,
-            spanId,
-            sampleRate,
-            retentionMinutes,
-            preserveErrors,
-        },
-        isRoot: true,
-    };
-}
-export async function executeTracedHandler(params) {
-    const { ctx, component, traceId, spanId, startTime, config, args, handler, enhancedCtx, isRoot, } = params;
-    const defaultConfig = enhancedCtx.tracer
-        .config;
-    try {
-        // Reject any functions that pass a traceId that doesn't exist
-        // These params can be passed from the frontend to break tracing
-        // Running a tracedFunction without passing ids will create a new trace
-        if (traceId) {
-            const traceExists = await ctx.runQuery(component.lib.verifyTrace, {
-                traceId,
-            });
-            if (!traceExists)
-                throw new Error("Cannot pass a traceId for a trace that doesn't exist");
-        }
-        // Reject any functions that pass a spanId that doesn't exist
-        // These params can be passed from the frontend to break tracing
-        if (spanId) {
-            const spanExists = await ctx.runQuery(component.lib.verifySpan, {
-                spanId,
-            });
-            if (!spanExists)
-                throw new Error("Cannot pass a spanId for a span that doesn't exist");
-        }
-        if (config.onStart) {
-            await config.onStart(enhancedCtx, args);
-        }
-        const result = await handler(enhancedCtx, args);
-        if (config.onSuccess) {
-            await config.onSuccess(enhancedCtx, args, result);
-        }
-        const now = Date.now();
-        await ctx
-            .runMutation(component.lib.completeSpan, {
-            spanId,
-            endTime: now,
-            duration: now - startTime,
-            status: "success",
-            result: config.logReturn ? result : undefined,
-        })
-            .catch((err) => console.error("[Tracer] Failed to complete span with success:", err));
-        if (isRoot) {
-            await ctx
-                .runMutation(component.lib.updateTraceStatus, {
-                traceId,
-                status: "success",
-            })
-                .catch((err) => console.error("[Tracer] Failed to update trace status:", err));
-        }
-        return { success: true, data: result, error: undefined };
-    }
-    catch (e) {
-        const error = e;
-        if (config.onError) {
-            await config.onError(enhancedCtx, args, error);
-        }
-        const preserveErrors = config.preserveErrors ?? defaultConfig.preserveErrors;
-        if (preserveErrors) {
-            const tracerAPI = new TracerAPI(ctx, component, traceId, spanId, config);
-            await tracerAPI.preserve();
-        }
-        await ctx
-            .runMutation(component.lib.completeSpan, {
-            spanId,
-            endTime: Date.now(),
-            duration: Date.now() - startTime,
-            status: "error",
-            error: error.message,
-        })
-            .catch((err) => console.error("[Tracer] Failed to complete span with error:", err));
-        if (isRoot) {
-            await ctx
-                .runMutation(component.lib.updateTraceStatus, {
-                traceId,
-                status: "error",
-            })
-                .catch((err) => console.error("[Tracer] Failed to update trace status:", err));
-        }
-        return { success: false, data: undefined, error: error.message };
-    }
-    finally {
-        const retMins = config.retentionMinutes ?? defaultConfig.retentionMinutes;
-        if (!retMins) {
-            console.error("[Tracer] retentionMinutes is not defined");
-        }
-        const sampleRate = config.sampleRate ?? defaultConfig.sampleRate;
-        if (!sampleRate) {
-            console.error("[Tracer] sampleRate is not defined");
-        }
-        else if (sampleRate && sampleRate < 1) {
-            const MINUTE = 60 * 1000;
-            const delayMins = retMins ?? 120;
-            const delay = delayMins * MINUTE;
-            await ctx.scheduler.runAfter(delay, component.lib.cleanupTrace, {
-                traceId,
-            });
-        }
-    }
-}
-//# sourceMappingURL=helpers.js.map

package/dist/client/helpers.js.map

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