convex-tracer 0.1.0 → 0.1.2

package/dist/component/schema.d.ts

@@ -5,6 +5,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
     traces: import("convex/server").TableDefinition<import("convex/values").VObject<{
         metadata?: Record<string, any> | undefined;
         userId?: string | undefined;
+        functionName?: string | undefined;
         preserve?: boolean | undefined;
         status: "error" | "success" | "pending";
         sampleRate: number;
@@ -15,20 +16,26 @@ declare const _default: import("convex/server").SchemaDefinition<{
         preserve: import("convex/values").VBoolean<boolean | undefined, "optional">;
         updatedAt: import("convex/values").VFloat64<number, "required">;
         metadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
+        functionName: import("convex/values").VString<string | undefined, "optional">;
         userId: import("convex/values").VString<string | undefined, "optional">;
-    }, "required", "status" | "metadata" | "sampleRate" | "userId" | "preserve" | "updatedAt" | `metadata.${string}`>, {
+    }, "required", "status" | "metadata" | "sampleRate" | "userId" | "functionName" | "preserve" | "updatedAt" | `metadata.${string}`>, {
         by_status: ["status", "_creationTime"];
         by_userId: ["userId", "_creationTime"];
         by_status_and_userId: ["status", "userId", "_creationTime"];
-    }, {}, {}>;
+    }, {
+        by_function_name: {
+            searchField: "functionName";
+            filterFields: "status" | "userId";
+        };
+    }, {}>;
     spans: import("convex/server").TableDefinition<import("convex/values").VObject<{
         error?: string | undefined;
         duration?: number | undefined;
         endTime?: number | undefined;
         result?: any;
         metadata?: Record<string, any> | undefined;
-        parentSpanId?: import("convex/values").GenericId<"spans"> | undefined;
         functionName?: string | undefined;
+        parentSpanId?: import("convex/values").GenericId<"spans"> | undefined;
         args?: any;
         traceId: import("convex/values").GenericId<"traces">;
         status: "error" | "success" | "pending";
@@ -49,7 +56,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
         result: import("convex/values").VAny<any, "optional", string>;
         error: import("convex/values").VString<string | undefined, "optional">;
         metadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
-    }, "required", "error" | "traceId" | "duration" | "endTime" | "result" | "status" | "metadata" | "source" | `metadata.${string}` | "parentSpanId" | "spanName" | "startTime" | "functionName" | "args" | `result.${string}` | `args.${string}`>, {
+    }, "required", "error" | "traceId" | "duration" | "endTime" | "result" | "status" | "metadata" | "source" | "functionName" | `metadata.${string}` | "parentSpanId" | "spanName" | "startTime" | "args" | `result.${string}` | `args.${string}`>, {
         by_traceId: ["traceId", "_creationTime"];
         by_parentSpanId: ["parentSpanId", "_creationTime"];
         by_status: ["status", "_creationTime"];

package/dist/component/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/component/schema.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,eAAe,+PAI3B,CAAC;AAEF,eAAO,MAAM,eAAe,gMAG3B,CAAC;AAEF,eAAO,MAAM,iBAAiB,mPAI7B,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEF,wBAyCG"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/component/schema.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,eAAe,+PAI3B,CAAC;AAEF,eAAO,MAAM,eAAe,gMAG3B,CAAC;AAEF,eAAO,MAAM,iBAAiB,mPAI7B,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEF,wBA8CG"}

package/dist/component/schema.js

@@ -10,11 +10,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"),
         parentSpanId: v.optional(v.id("spans")),

package/dist/component/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/component/schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/component/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAElC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CACpC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EACpB,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EACpB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CACnB,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CACpC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,EACrB,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CACrB,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CACtC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EACjB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EACjB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CACnB,CAAC;AAEF,eAAe,YAAY,CAAC;IAC1B,MAAM,EAAE,WAAW,CAAC;QAClB,MAAM,EAAE,eAAe;QACvB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACjC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QACnD,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KAC/B,CAAC;SACC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC;SAC9B,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC;SAC9B,KAAK,CAAC,sBAAsB,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;SACnD,WAAW,CAAC,kBAAkB,EAAE;QAC/B,WAAW,EAAE,cAAc;QAC3B,YAAY,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;KACnC,CAAC;IAEJ,KAAK,EAAE,WAAW,CAAC;QACjB,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC;QACvB,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;QACvC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,MAAM,EAAE,eAAe;QACvB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC/B,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAChC,MAAM,EAAE,eAAe;QACvB,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACpC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QAC3B,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC7B,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;KACpD,CAAC;SACC,KAAK,CAAC,YAAY,EAAE,CAAC,SAAS,CAAC,CAAC;SAChC,KAAK,CAAC,iBAAiB,EAAE,CAAC,cAAc,CAAC,CAAC;SAC1C,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC;IAEjC,IAAI,EAAE,WAAW,CAAC;QAChB,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC;QACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,QAAQ,EAAE,iBAAiB;QAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;KACpD,CAAC;SACC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC;SAC9B,KAAK,CAAC,aAAa,EAAE,CAAC,UAAU,CAAC,CAAC;CACtC,CAAC,CAAC"}

package/dist/component/types.d.ts

@@ -2,6 +2,7 @@ import { type Infer } from "convex/values";
 export declare const vTrace: import("convex/values").VObject<{
     metadata?: Record<string, any> | undefined;
     userId?: string | undefined;
+    functionName?: string | undefined;
     preserve?: boolean | undefined;
     status: "error" | "success" | "pending";
     sampleRate: number;
@@ -14,10 +15,64 @@ export declare const vTrace: import("convex/values").VObject<{
     preserve: import("convex/values").VBoolean<boolean | undefined, "optional">;
     updatedAt: import("convex/values").VFloat64<number, "required">;
     metadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
+    functionName: import("convex/values").VString<string | undefined, "optional">;
     userId: import("convex/values").VString<string | undefined, "optional">;
     _id: import("convex/values").VString<string, "required">;
     _creationTime: import("convex/values").VFloat64<number, "required">;
-}, "required", "status" | "metadata" | "sampleRate" | "userId" | "preserve" | "updatedAt" | `metadata.${string}` | "_creationTime" | "_id">;
+}, "required", "status" | "metadata" | "sampleRate" | "userId" | "functionName" | "preserve" | "updatedAt" | `metadata.${string}` | "_creationTime" | "_id">;
+export declare const vPaginatedTraces: import("convex/values").VObject<{
+    splitCursor?: string | null;
+    pageStatus?: "SplitRecommended" | "SplitRequired" | null;
+    page: {
+        metadata?: Record<string, any> | undefined;
+        userId?: string | undefined;
+        functionName?: string | undefined;
+        preserve?: boolean | undefined;
+        status: "error" | "success" | "pending";
+        sampleRate: number;
+        updatedAt: number;
+        _creationTime: number;
+        _id: string;
+    }[];
+    continueCursor: string;
+    isDone: boolean;
+}, {
+    page: import("convex/values").VArray<{
+        metadata?: Record<string, any> | undefined;
+        userId?: string | undefined;
+        functionName?: string | undefined;
+        preserve?: boolean | undefined;
+        status: "error" | "success" | "pending";
+        sampleRate: number;
+        updatedAt: number;
+        _creationTime: number;
+        _id: string;
+    }[], import("convex/values").VObject<{
+        metadata?: Record<string, any> | undefined;
+        userId?: string | undefined;
+        functionName?: string | undefined;
+        preserve?: boolean | undefined;
+        status: "error" | "success" | "pending";
+        sampleRate: number;
+        updatedAt: number;
+        _creationTime: number;
+        _id: string;
+    }, {
+        status: import("convex/values").VUnion<"error" | "success" | "pending", [import("convex/values").VLiteral<"pending", "required">, import("convex/values").VLiteral<"success", "required">, import("convex/values").VLiteral<"error", "required">], "required", never>;
+        sampleRate: import("convex/values").VFloat64<number, "required">;
+        preserve: import("convex/values").VBoolean<boolean | undefined, "optional">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+        metadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
+        functionName: import("convex/values").VString<string | undefined, "optional">;
+        userId: import("convex/values").VString<string | undefined, "optional">;
+        _id: import("convex/values").VString<string, "required">;
+        _creationTime: import("convex/values").VFloat64<number, "required">;
+    }, "required", "status" | "metadata" | "sampleRate" | "userId" | "functionName" | "preserve" | "updatedAt" | `metadata.${string}` | "_creationTime" | "_id">, "required">;
+    continueCursor: import("convex/values").VString<string, "required">;
+    isDone: import("convex/values").VBoolean<boolean, "required">;
+    splitCursor: import("convex/values").VUnion<string | null | undefined, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "optional", never>;
+    pageStatus: import("convex/values").VUnion<"SplitRecommended" | "SplitRequired" | null | undefined, [import("convex/values").VLiteral<"SplitRecommended", "required">, import("convex/values").VLiteral<"SplitRequired", "required">, import("convex/values").VNull<null, "required">], "optional", never>;
+}, "required", "page" | "continueCursor" | "isDone" | "splitCursor" | "pageStatus">;
 export declare const vSpan: import("convex/values").VObject<{
     error?: string | undefined;
     duration?: number | undefined;
@@ -26,9 +81,9 @@ export declare const vSpan: import("convex/values").VObject<{
     status: "error" | "success" | "pending";
     metadata?: Record<string, any> | undefined;
     source: "frontend" | "backend";
+    functionName?: string | undefined;
     spanName: string;
     startTime: number;
-    functionName?: string | undefined;
     args?: any;
     parentSpanId?: string | undefined;
     traceId: string;
@@ -42,15 +97,15 @@ export declare const vSpan: import("convex/values").VObject<{
     status: import("convex/values").VUnion<"error" | "success" | "pending", [import("convex/values").VLiteral<"pending", "required">, import("convex/values").VLiteral<"success", "required">, import("convex/values").VLiteral<"error", "required">], "required", never>;
     metadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
     source: import("convex/values").VUnion<"frontend" | "backend", [import("convex/values").VLiteral<"frontend", "required">, import("convex/values").VLiteral<"backend", "required">], "required", never>;
+    functionName: import("convex/values").VString<string | undefined, "optional">;
     spanName: import("convex/values").VString<string, "required">;
     startTime: import("convex/values").VFloat64<number, "required">;
-    functionName: import("convex/values").VString<string | undefined, "optional">;
     args: import("convex/values").VAny<any, "optional", string>;
     _id: import("convex/values").VString<string, "required">;
     traceId: import("convex/values").VString<string, "required">;
     parentSpanId: import("convex/values").VString<string | undefined, "optional">;
     _creationTime: import("convex/values").VFloat64<number, "required">;
-}, "required", "error" | "traceId" | "duration" | "endTime" | "result" | "status" | "metadata" | "source" | `metadata.${string}` | "_creationTime" | "parentSpanId" | "spanName" | "startTime" | "functionName" | "args" | `result.${string}` | `args.${string}` | "_id">;
+}, "required", "error" | "traceId" | "duration" | "endTime" | "result" | "status" | "metadata" | "source" | "functionName" | `metadata.${string}` | "_creationTime" | "parentSpanId" | "spanName" | "startTime" | "args" | `result.${string}` | `args.${string}` | "_id">;
 export declare const vLog: import("convex/values").VObject<{
     metadata?: Record<string, any> | undefined;
     severity: "info" | "warn" | "error";
@@ -76,9 +131,9 @@ export declare const vSpanWithLogs: import("convex/values").VObject<{
     status: "error" | "success" | "pending";
     metadata?: Record<string, any> | undefined;
     source: "frontend" | "backend";
+    functionName?: string | undefined;
     spanName: string;
     startTime: number;
-    functionName?: string | undefined;
     args?: any;
     parentSpanId?: string | undefined;
     traceId: string;
@@ -102,9 +157,9 @@ export declare const vSpanWithLogs: import("convex/values").VObject<{
     status: import("convex/values").VUnion<"error" | "success" | "pending", [import("convex/values").VLiteral<"pending", "required">, import("convex/values").VLiteral<"success", "required">, import("convex/values").VLiteral<"error", "required">], "required", never>;
     metadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
     source: import("convex/values").VUnion<"frontend" | "backend", [import("convex/values").VLiteral<"frontend", "required">, import("convex/values").VLiteral<"backend", "required">], "required", never>;
+    functionName: import("convex/values").VString<string | undefined, "optional">;
     spanName: import("convex/values").VString<string, "required">;
     startTime: import("convex/values").VFloat64<number, "required">;
-    functionName: import("convex/values").VString<string | undefined, "optional">;
     args: import("convex/values").VAny<any, "optional", string>;
     _id: import("convex/values").VString<string, "required">;
     traceId: import("convex/values").VString<string, "required">;
@@ -136,10 +191,11 @@ export declare const vSpanWithLogs: import("convex/values").VObject<{
         _creationTime: import("convex/values").VFloat64<number, "required">;
     }, "required", "spanId" | "metadata" | `metadata.${string}` | "_creationTime" | "severity" | "timestamp" | "message" | "_id">, "optional">;
     children: import("convex/values").VArray<any[] | undefined, import("convex/values").VAny<any, "required", string>, "optional">;
-}, "required", "error" | "traceId" | "duration" | "endTime" | "result" | "status" | "metadata" | "source" | `metadata.${string}` | "_creationTime" | "parentSpanId" | "spanName" | "startTime" | "functionName" | "args" | `result.${string}` | `args.${string}` | "logs" | "_id" | "children">;
+}, "required", "error" | "traceId" | "duration" | "endTime" | "result" | "status" | "metadata" | "source" | "functionName" | `metadata.${string}` | "_creationTime" | "parentSpanId" | "spanName" | "startTime" | "args" | `result.${string}` | `args.${string}` | "logs" | "_id" | "children">;
 export declare const vCompleteTrace: import("convex/values").VObject<{
     metadata?: Record<string, any> | undefined;
     userId?: string | undefined;
+    functionName?: string | undefined;
     preserve?: boolean | undefined;
     status: "error" | "success" | "pending";
     sampleRate: number;
@@ -154,9 +210,9 @@ export declare const vCompleteTrace: import("convex/values").VObject<{
         status: "error" | "success" | "pending";
         metadata?: Record<string, any> | undefined;
         source: "frontend" | "backend";
+        functionName?: string | undefined;
         spanName: string;
         startTime: number;
-        functionName?: string | undefined;
         args?: any;
         parentSpanId?: string | undefined;
         traceId: string;
@@ -179,6 +235,7 @@ export declare const vCompleteTrace: import("convex/values").VObject<{
     preserve: import("convex/values").VBoolean<boolean | undefined, "optional">;
     updatedAt: import("convex/values").VFloat64<number, "required">;
     metadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
+    functionName: import("convex/values").VString<string | undefined, "optional">;
     userId: import("convex/values").VString<string | undefined, "optional">;
     _id: import("convex/values").VString<string, "required">;
     _creationTime: import("convex/values").VFloat64<number, "required">;
@@ -190,9 +247,9 @@ export declare const vCompleteTrace: import("convex/values").VObject<{
         status: "error" | "success" | "pending";
         metadata?: Record<string, any> | undefined;
         source: "frontend" | "backend";
+        functionName?: string | undefined;
         spanName: string;
         startTime: number;
-        functionName?: string | undefined;
         args?: any;
         parentSpanId?: string | undefined;
         traceId: string;
@@ -216,9 +273,9 @@ export declare const vCompleteTrace: import("convex/values").VObject<{
         status: "error" | "success" | "pending";
         metadata?: Record<string, any> | undefined;
         source: "frontend" | "backend";
+        functionName?: string | undefined;
         spanName: string;
         startTime: number;
-        functionName?: string | undefined;
         args?: any;
         parentSpanId?: string | undefined;
         traceId: string;
@@ -242,9 +299,9 @@ export declare const vCompleteTrace: import("convex/values").VObject<{
         status: import("convex/values").VUnion<"error" | "success" | "pending", [import("convex/values").VLiteral<"pending", "required">, import("convex/values").VLiteral<"success", "required">, import("convex/values").VLiteral<"error", "required">], "required", never>;
         metadata: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
         source: import("convex/values").VUnion<"frontend" | "backend", [import("convex/values").VLiteral<"frontend", "required">, import("convex/values").VLiteral<"backend", "required">], "required", never>;
+        functionName: import("convex/values").VString<string | undefined, "optional">;
         spanName: import("convex/values").VString<string, "required">;
         startTime: import("convex/values").VFloat64<number, "required">;
-        functionName: import("convex/values").VString<string | undefined, "optional">;
         args: import("convex/values").VAny<any, "optional", string>;
         _id: import("convex/values").VString<string, "required">;
         traceId: import("convex/values").VString<string, "required">;
@@ -276,11 +333,12 @@ export declare const vCompleteTrace: import("convex/values").VObject<{
             _creationTime: import("convex/values").VFloat64<number, "required">;
         }, "required", "spanId" | "metadata" | `metadata.${string}` | "_creationTime" | "severity" | "timestamp" | "message" | "_id">, "optional">;
         children: import("convex/values").VArray<any[] | undefined, import("convex/values").VAny<any, "required", string>, "optional">;
-    }, "required", "error" | "traceId" | "duration" | "endTime" | "result" | "status" | "metadata" | "source" | `metadata.${string}` | "_creationTime" | "parentSpanId" | "spanName" | "startTime" | "functionName" | "args" | `result.${string}` | `args.${string}` | "logs" | "_id" | "children">, "required">;
-}, "required", "status" | "metadata" | "sampleRate" | "userId" | "preserve" | "updatedAt" | `metadata.${string}` | "_creationTime" | "spans" | "_id">;
+    }, "required", "error" | "traceId" | "duration" | "endTime" | "result" | "status" | "metadata" | "source" | "functionName" | `metadata.${string}` | "_creationTime" | "parentSpanId" | "spanName" | "startTime" | "args" | `result.${string}` | `args.${string}` | "logs" | "_id" | "children">, "required">;
+}, "required", "status" | "metadata" | "sampleRate" | "userId" | "functionName" | "preserve" | "updatedAt" | `metadata.${string}` | "_creationTime" | "spans" | "_id">;
 export type Trace = Infer<typeof vTrace>;
 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>;
 //# sourceMappingURL=types.d.ts.map

package/dist/component/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/component/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAG9C,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;2IAGjB,CAAC;AAEH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yQAQd,CAAC;AAEL,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;6HAIf,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+RAGxB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qJAEzB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AACzC,MAAM,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC;AACvC,MAAM,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AACrC,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACvD,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/component/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAK,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAG9C,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;4JAGjB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mFAAoC,CAAC;AAElE,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yQAQd,CAAC;AAEL,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;6HAIf,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+RAGxB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sKAEzB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AACzC,MAAM,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC;AACvC,MAAM,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AACrC,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACvD,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACzD,MAAM,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/component/types.js

@@ -1,9 +1,11 @@
+import { paginationResultValidator } from "convex/server";
 import { v } from "convex/values";
 import schema from "./schema";
 export const vTrace = schema.tables.traces.validator.extend({
     _id: v.string(),
     _creationTime: v.number(),
 });
+export const vPaginatedTraces = paginationResultValidator(vTrace);
 export const vSpan = schema.tables.spans.validator
     .omit("parentSpanId")
     .omit("traceId")

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.2",
   "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<