convex-langfuse 0.0.1

package/dist/component/lib.js.map

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

package/dist/component/schema.d.ts

@@ -0,0 +1,83 @@
+declare const _default: import("convex/server").SchemaDefinition<{
+    traces: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        sessionId?: string | undefined;
+        userId?: string | undefined;
+        metadata?: string | undefined;
+        release?: string | undefined;
+        tags?: string[] | undefined;
+        traceId: string;
+        name: string;
+        createdAt: number;
+        updatedAt: number;
+    }, {
+        traceId: import("convex/values").VString<string, "required">;
+        name: import("convex/values").VString<string, "required">;
+        userId: import("convex/values").VString<string | undefined, "optional">;
+        sessionId: import("convex/values").VString<string | undefined, "optional">;
+        tags: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+        metadata: import("convex/values").VString<string | undefined, "optional">;
+        release: import("convex/values").VString<string | undefined, "optional">;
+        createdAt: import("convex/values").VFloat64<number, "required">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "traceId" | "sessionId" | "userId" | "metadata" | "name" | "release" | "tags" | "createdAt" | "updatedAt">, {
+        by_traceId: ["traceId", "_creationTime"];
+        by_userId: ["userId", "_creationTime"];
+        by_sessionId: ["sessionId", "_creationTime"];
+    }, {}, {}>;
+    observations: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        input?: string | undefined;
+        inputTokens?: number | undefined;
+        metadata?: string | undefined;
+        model?: string | undefined;
+        output?: string | undefined;
+        outputTokens?: number | undefined;
+        statusMessage?: string | undefined;
+        traceId: string;
+        endedAt: number;
+        level: "DEBUG" | "DEFAULT" | "WARNING" | "ERROR";
+        name: string;
+        observationId: string;
+        startedAt: number;
+        type: "span" | "generation" | "event" | "embedding" | "agent" | "tool" | "chain" | "retriever" | "guardrail" | "evaluator";
+        createdAt: number;
+    }, {
+        observationId: import("convex/values").VString<string, "required">;
+        traceId: import("convex/values").VString<string, "required">;
+        type: import("convex/values").VUnion<"span" | "generation" | "event" | "embedding" | "agent" | "tool" | "chain" | "retriever" | "guardrail" | "evaluator", [import("convex/values").VLiteral<"span", "required">, import("convex/values").VLiteral<"generation", "required">, import("convex/values").VLiteral<"event", "required">, import("convex/values").VLiteral<"embedding", "required">, import("convex/values").VLiteral<"agent", "required">, import("convex/values").VLiteral<"tool", "required">, import("convex/values").VLiteral<"chain", "required">, import("convex/values").VLiteral<"retriever", "required">, import("convex/values").VLiteral<"guardrail", "required">, import("convex/values").VLiteral<"evaluator", "required">], "required", never>;
+        name: import("convex/values").VString<string, "required">;
+        input: import("convex/values").VString<string | undefined, "optional">;
+        output: import("convex/values").VString<string | undefined, "optional">;
+        model: import("convex/values").VString<string | undefined, "optional">;
+        inputTokens: import("convex/values").VFloat64<number | undefined, "optional">;
+        outputTokens: import("convex/values").VFloat64<number | undefined, "optional">;
+        level: import("convex/values").VUnion<"DEBUG" | "DEFAULT" | "WARNING" | "ERROR", [import("convex/values").VLiteral<"DEBUG", "required">, import("convex/values").VLiteral<"DEFAULT", "required">, import("convex/values").VLiteral<"WARNING", "required">, import("convex/values").VLiteral<"ERROR", "required">], "required", never>;
+        statusMessage: import("convex/values").VString<string | undefined, "optional">;
+        metadata: import("convex/values").VString<string | undefined, "optional">;
+        startedAt: import("convex/values").VFloat64<number, "required">;
+        endedAt: import("convex/values").VFloat64<number, "required">;
+        createdAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "traceId" | "endedAt" | "input" | "inputTokens" | "level" | "metadata" | "model" | "name" | "observationId" | "output" | "outputTokens" | "startedAt" | "statusMessage" | "type" | "createdAt">, {
+        by_observationId: ["observationId", "_creationTime"];
+        by_traceId: ["traceId", "_creationTime"];
+    }, {}, {}>;
+    scores: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        comment?: string | undefined;
+        traceId: string;
+        name: string;
+        scoreId: string;
+        value: number;
+        createdAt: number;
+    }, {
+        scoreId: import("convex/values").VString<string, "required">;
+        traceId: import("convex/values").VString<string, "required">;
+        name: import("convex/values").VString<string, "required">;
+        value: import("convex/values").VFloat64<number, "required">;
+        comment: import("convex/values").VString<string | undefined, "optional">;
+        createdAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "traceId" | "name" | "comment" | "scoreId" | "value" | "createdAt">, {
+        by_scoreId: ["scoreId", "_creationTime"];
+        by_traceId: ["traceId", "_creationTime"];
+    }, {}, {}>;
+}, true>;
+export default _default;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/component/schema.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGA,wBA8DG"}

package/dist/component/schema.js

@@ -0,0 +1,48 @@
+import { defineSchema, defineTable } from "convex/server";
+import { v } from "convex/values";
+export default defineSchema({
+    traces: defineTable({
+        traceId: v.string(),
+        name: v.string(),
+        userId: v.optional(v.string()),
+        sessionId: v.optional(v.string()),
+        tags: v.optional(v.array(v.string())),
+        metadata: v.optional(v.string()),
+        release: v.optional(v.string()),
+        createdAt: v.number(),
+        updatedAt: v.number(),
+    })
+        .index("by_traceId", ["traceId"])
+        .index("by_userId", ["userId"])
+        .index("by_sessionId", ["sessionId"]),
+    observations: defineTable({
+        observationId: v.string(),
+        traceId: v.string(),
+        type: v.union(v.literal("span"), v.literal("generation"), v.literal("event"), v.literal("embedding"), v.literal("agent"), v.literal("tool"), v.literal("chain"), v.literal("retriever"), v.literal("guardrail"), v.literal("evaluator")),
+        name: v.string(),
+        input: v.optional(v.string()),
+        output: v.optional(v.string()),
+        model: v.optional(v.string()),
+        inputTokens: v.optional(v.number()),
+        outputTokens: v.optional(v.number()),
+        level: v.union(v.literal("DEBUG"), v.literal("DEFAULT"), v.literal("WARNING"), v.literal("ERROR")),
+        statusMessage: v.optional(v.string()),
+        metadata: v.optional(v.string()),
+        startedAt: v.number(),
+        endedAt: v.number(),
+        createdAt: v.number(),
+    })
+        .index("by_observationId", ["observationId"])
+        .index("by_traceId", ["traceId"]),
+    scores: defineTable({
+        scoreId: v.string(),
+        traceId: v.string(),
+        name: v.string(),
+        value: v.number(),
+        comment: v.optional(v.string()),
+        createdAt: v.number(),
+    })
+        .index("by_scoreId", ["scoreId"])
+        .index("by_traceId", ["traceId"]),
+});
+//# sourceMappingURL=schema.js.map

package/dist/component/schema.js.map

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

package/package.json

@@ -0,0 +1,106 @@
+{
+  "name": "convex-langfuse",
+  "description": "Send LLM traces, generations, and scores from your Convex app to Langfuse over OpenTelemetry, with reactive local queries.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sholajegede/convex-langfuse.git"
+  },
+  "homepage": "https://github.com/sholajegede/convex-langfuse#readme",
+  "bugs": {
+    "url": "https://github.com/sholajegede/convex-langfuse/issues"
+  },
+  "version": "0.0.1",
+  "license": "Apache-2.0",
+  "keywords": [
+    "convex",
+    "component",
+    "langfuse",
+    "observability",
+    "llm",
+    "opentelemetry",
+    "tracing",
+    "ai"
+  ],
+  "type": "module",
+  "scripts": {
+    "dev": "run-p -r 'dev:*'",
+    "dev:backend": "convex dev --typecheck-components",
+    "dev:frontend": "cd example && vite --clearScreen false",
+    "dev:build": "chokidar 'tsconfig*.json' 'src/**/*.ts' -i '**/*.test.ts' -c 'npm run build:codegen' --initial",
+    "predev": "path-exists .env.local dist || (npm run build && convex dev --once)",
+    "build": "tsc --project ./tsconfig.build.json",
+    "build:codegen": "npx convex codegen --component-dir ./src/component && npm run build",
+    "build:clean": "rm -rf dist *.tsbuildinfo && npm run build:codegen",
+    "typecheck": "tsc --noEmit && tsc -p example && tsc -p example/convex",
+    "lint": "eslint .",
+    "all": "run-p -r 'dev:*' 'test:watch'",
+    "test": "vitest run --typecheck",
+    "test:watch": "vitest --typecheck --clearScreen false",
+    "test:debug": "vitest --inspect-brk --no-file-parallelism",
+    "test:coverage": "vitest run --coverage --coverage.reporter=text",
+    "preversion": "npm install --legacy-peer-deps && npm run build:clean && run-p test lint typecheck",
+    "prepublishOnly": "npm whoami || npm login",
+    "alpha": "npm version prerelease --preid alpha && npm publish --tag alpha && git push --follow-tags",
+    "release": "npm version patch && npm publish && git push --follow-tags",
+    "version": "vim -c 'normal o' -c 'normal o## '$npm_package_version CHANGELOG.md && prettier -w CHANGELOG.md && git add CHANGELOG.md"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/client/index.d.ts",
+      "default": "./dist/client/index.js"
+    },
+    "./test": "./src/test.ts",
+    "./_generated/component.js": {
+      "types": "./dist/component/_generated/component.d.ts"
+    },
+    "./_generated/component": {
+      "types": "./dist/component/_generated/component.d.ts"
+    },
+    "./convex.config.js": {
+      "types": "./dist/component/convex.config.d.ts",
+      "default": "./dist/component/convex.config.js"
+    },
+    "./convex.config": {
+      "types": "./dist/component/convex.config.d.ts",
+      "default": "./dist/component/convex.config.js"
+    }
+  },
+  "peerDependencies": {
+    "convex": "^1.34.1"
+  },
+  "devDependencies": {
+    "@convex-dev/eslint-plugin": "^1.2.0",
+    "@edge-runtime/vm": "^5.0.0",
+    "@eslint/eslintrc": "^3.3.5",
+    "@eslint/js": "9.39.4",
+    "@types/node": "^24.12.0",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^5.2.0",
+    "chokidar-cli": "3.0.0",
+    "convex": "1.45.0",
+    "convex-test": "0.0.41",
+    "eslint": "9.39.4",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.5.2",
+    "globals": "^17.4.0",
+    "npm-run-all2": "8.0.4",
+    "path-exists-cli": "2.0.0",
+    "pkg-pr-new": "^0.0.66",
+    "prettier": "3.8.1",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.57.1",
+    "vite": "7.3.1",
+    "vitest": "4.1.0"
+  },
+  "types": "./dist/client/index.d.ts",
+  "module": "./dist/client/index.js"
+}

package/src/client/_generated/_ignore.ts

@@ -0,0 +1 @@
+// This is only here so convex-test can detect a _generated folder

package/src/client/index.ts

@@ -0,0 +1,322 @@
+import type { GenericActionCtx, GenericDataModel } from "convex/server";
+import type { ComponentApi } from "../component/_generated/component.js";
+
+export type LangfuseOptions = {
+  publicKey: string;
+  secretKey: string;
+  /** Defaults to the EU Langfuse Cloud region. */
+  baseUrl?: string;
+};
+
+export type ObservationLevel = "DEBUG" | "DEFAULT" | "WARNING" | "ERROR";
+
+export type LogObservationArgs = {
+  /** Continue an existing trace, or omit to start a new one. */
+  traceId?: string;
+  traceName?: string;
+  userId?: string;
+  sessionId?: string;
+  tags?: string[];
+  release?: string;
+  traceMetadata?: Record<string, unknown>;
+
+  name: string;
+  input?: unknown;
+  output?: unknown;
+  model?: string;
+  inputTokens?: number;
+  outputTokens?: number;
+  level?: ObservationLevel;
+  statusMessage?: string;
+  metadata?: Record<string, unknown>;
+  startTime?: number;
+  endTime?: number;
+};
+
+export type LogObservationResult = {
+  traceId: string;
+  observationId: string;
+};
+
+function randomHex(byteLength: number): string {
+  const bytes = new Uint8Array(byteLength);
+  crypto.getRandomValues(bytes);
+  return Array.from(bytes)
+    .map((b) => b.toString(16).padStart(2, "0"))
+    .join("");
+}
+
+type OtlpAttribute = { key: string; value: Record<string, unknown> };
+
+function attr(key: string, value: unknown): OtlpAttribute | null {
+  if (value === undefined || value === null) return null;
+  if (typeof value === "string") return { key, value: { stringValue: value } };
+  if (typeof value === "number") {
+    return Number.isInteger(value)
+      ? { key, value: { intValue: String(value) } }
+      : { key, value: { doubleValue: value } };
+  }
+  if (typeof value === "boolean") return { key, value: { boolValue: value } };
+  if (Array.isArray(value)) {
+    return {
+      key,
+      value: {
+        arrayValue: {
+          values: value.map((v) => ({ stringValue: String(v) })),
+        },
+      },
+    };
+  }
+  return { key, value: { stringValue: JSON.stringify(value) } };
+}
+
+function flattenMetadata(prefix: string, metadata: Record<string, unknown> | undefined): OtlpAttribute[] {
+  if (!metadata) return [];
+  return Object.entries(metadata)
+    .map(([k, v]) => attr(`${prefix}.${k}`, typeof v === "object" ? JSON.stringify(v) : v))
+    .filter((a): a is OtlpAttribute => a !== null);
+}
+
+/**
+ * Send LLM traces, generations, and scores to Langfuse over its OpenTelemetry
+ * ingestion endpoint (the legacy `/api/public/ingestion` batch API sunsets on
+ * Langfuse Cloud in November 2026), while keeping a reactive local copy in Convex.
+ */
+export class Langfuse {
+  constructor(
+    private component: ComponentApi,
+    private options: LangfuseOptions,
+  ) {}
+
+  private authHeader(): string {
+    return `Basic ${btoa(`${this.options.publicKey}:${this.options.secretKey}`)}`;
+  }
+
+  private baseUrl(): string {
+    return this.options.baseUrl ?? "https://cloud.langfuse.com";
+  }
+
+  private async exportSpan(args: {
+    traceId: string;
+    spanId: string;
+    name: string;
+    startTimeUnixNano: string;
+    endTimeUnixNano: string;
+    attributes: OtlpAttribute[];
+  }): Promise<void> {
+    const body = {
+      resourceSpans: [
+        {
+          resource: {
+            attributes: [{ key: "service.name", value: { stringValue: "convex-langfuse" } }],
+          },
+          scopeSpans: [
+            {
+              scope: { name: "convex-langfuse" },
+              spans: [
+                {
+                  traceId: args.traceId,
+                  spanId: args.spanId,
+                  name: args.name,
+                  kind: 1,
+                  startTimeUnixNano: args.startTimeUnixNano,
+                  endTimeUnixNano: args.endTimeUnixNano,
+                  attributes: args.attributes,
+                },
+              ],
+            },
+          ],
+        },
+      ],
+    };
+
+    const res = await fetch(`${this.baseUrl()}/api/public/otel/v1/traces`, {
+      method: "POST",
+      headers: {
+        Authorization: this.authHeader(),
+        "Content-Type": "application/json",
+        "x-langfuse-ingestion-version": "4",
+      },
+      body: JSON.stringify(body),
+    });
+
+    if (!res.ok) {
+      throw new Error(`Failed to export span to Langfuse: ${res.status} ${await res.text()}`);
+    }
+  }
+
+  private async logObservation(
+    ctx: GenericActionCtx<GenericDataModel>,
+    type:
+      | "span"
+      | "generation"
+      | "event"
+      | "embedding"
+      | "agent"
+      | "tool"
+      | "chain"
+      | "retriever"
+      | "guardrail"
+      | "evaluator",
+    args: LogObservationArgs,
+  ): Promise<LogObservationResult> {
+    const traceId = args.traceId ?? randomHex(16);
+    const spanId = randomHex(8);
+    const startTime = args.startTime ?? Date.now();
+    const endTime = args.endTime ?? startTime;
+
+    const attributes: OtlpAttribute[] = [
+      attr("langfuse.trace.name", args.traceName ?? args.name),
+      attr("langfuse.user.id", args.userId),
+      attr("langfuse.session.id", args.sessionId),
+      attr("langfuse.trace.tags", args.tags),
+      attr("langfuse.release", args.release),
+      attr("langfuse.observation.type", type),
+      attr("langfuse.observation.input", args.input !== undefined ? JSON.stringify(args.input) : undefined),
+      attr("langfuse.observation.output", args.output !== undefined ? JSON.stringify(args.output) : undefined),
+      attr("langfuse.observation.model.name", args.model),
+      attr("langfuse.observation.level", args.level ?? "DEFAULT"),
+      attr("langfuse.observation.status_message", args.statusMessage),
+      ...(args.inputTokens !== undefined || args.outputTokens !== undefined
+        ? [
+            attr(
+              "langfuse.observation.usage_details",
+              // Langfuse's usage details object uses "input"/"output"/"total",
+              // not "input_tokens"/"output_tokens" — the latter is silently
+              // ignored, so the generation shows no token usage or cost.
+              JSON.stringify({
+                input: args.inputTokens ?? 0,
+                output: args.outputTokens ?? 0,
+                total: (args.inputTokens ?? 0) + (args.outputTokens ?? 0),
+              }),
+            ),
+          ]
+        : []),
+      ...flattenMetadata("langfuse.trace.metadata", args.traceMetadata),
+      ...flattenMetadata("langfuse.observation.metadata", args.metadata),
+    ].filter((a): a is OtlpAttribute => a !== null);
+
+    await this.exportSpan({
+      traceId,
+      spanId,
+      name: args.name,
+      startTimeUnixNano: String(startTime * 1_000_000),
+      endTimeUnixNano: String(endTime * 1_000_000),
+      attributes,
+    });
+
+    await ctx.runMutation(this.component.lib.recordTrace, {
+      traceId,
+      name: args.traceName ?? args.name,
+      userId: args.userId,
+      sessionId: args.sessionId,
+      tags: args.tags,
+      metadata: args.traceMetadata ? JSON.stringify(args.traceMetadata) : undefined,
+      release: args.release,
+    });
+
+    await ctx.runMutation(this.component.lib.recordObservation, {
+      observationId: spanId,
+      traceId,
+      type,
+      name: args.name,
+      input: args.input !== undefined ? JSON.stringify(args.input) : undefined,
+      output: args.output !== undefined ? JSON.stringify(args.output) : undefined,
+      model: args.model,
+      inputTokens: args.inputTokens,
+      outputTokens: args.outputTokens,
+      level: args.level ?? "DEFAULT",
+      statusMessage: args.statusMessage,
+      metadata: args.metadata ? JSON.stringify(args.metadata) : undefined,
+      startedAt: startTime,
+      endedAt: endTime,
+    });
+
+    return { traceId, observationId: spanId };
+  }
+
+  /** Log a completed LLM call (model, input, output, token usage) as a Langfuse generation. */
+  async logGeneration(
+    ctx: GenericActionCtx<GenericDataModel>,
+    args: LogObservationArgs,
+  ): Promise<LogObservationResult> {
+    return await this.logObservation(ctx, "generation", args);
+  }
+
+  /** Log a non-LLM step (a tool call, a retrieval, a chain step) as a Langfuse span. */
+  async logSpan(
+    ctx: GenericActionCtx<GenericDataModel>,
+    args: LogObservationArgs,
+  ): Promise<LogObservationResult> {
+    return await this.logObservation(ctx, "span", args);
+  }
+
+  /** Attach an evaluation score to a trace, via Langfuse's Scores API. */
+  async recordScore(
+    ctx: GenericActionCtx<GenericDataModel>,
+    args: { traceId: string; name: string; value: number; comment?: string },
+  ): Promise<{ scoreId: string }> {
+    const scoreId = randomHex(16);
+
+    const res = await fetch(`${this.baseUrl()}/api/public/scores`, {
+      method: "POST",
+      headers: {
+        Authorization: this.authHeader(),
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({
+        id: scoreId,
+        traceId: args.traceId,
+        name: args.name,
+        value: args.value,
+        comment: args.comment,
+      }),
+    });
+
+    if (!res.ok) {
+      throw new Error(`Failed to record Langfuse score: ${res.status} ${await res.text()}`);
+    }
+
+    await ctx.runMutation(this.component.lib.recordScore, {
+      scoreId,
+      traceId: args.traceId,
+      name: args.name,
+      value: args.value,
+      comment: args.comment,
+    });
+
+    return { scoreId };
+  }
+
+  async getTrace(ctx: RunQueryCtx, args: { traceId: string }) {
+    return await ctx.runQuery(this.component.lib.getTrace, args);
+  }
+
+  async listTracesByUser(ctx: RunQueryCtx, args: { userId: string; limit?: number }) {
+    return await ctx.runQuery(this.component.lib.listTracesByUser, args);
+  }
+
+  async listTracesBySession(ctx: RunQueryCtx, args: { sessionId: string; limit?: number }) {
+    return await ctx.runQuery(this.component.lib.listTracesBySession, args);
+  }
+
+  async listObservations(ctx: RunQueryCtx, args: { traceId: string }) {
+    return await ctx.runQuery(this.component.lib.listObservations, args);
+  }
+
+  async listScores(ctx: RunQueryCtx, args: { traceId: string }) {
+    return await ctx.runQuery(this.component.lib.listScores, args);
+  }
+
+  async getStats(ctx: RunQueryCtx) {
+    return await ctx.runQuery(this.component.lib.getStats, {});
+  }
+
+  async listRecentTraces(ctx: RunQueryCtx, args: { limit?: number } = {}) {
+    return await ctx.runQuery(this.component.lib.listRecentTraces, args);
+  }
+}
+
+type RunQueryCtx = {
+  runQuery: GenericActionCtx<GenericDataModel>["runQuery"];
+};

package/src/client/setup.test.ts

@@ -0,0 +1,26 @@
+/// <reference types="vite/client" />
+import { test } from "vitest";
+import { convexTest } from "convex-test";
+export const modules = import.meta.glob("./**/*.*s");
+
+import {
+  defineSchema,
+  type GenericSchema,
+  type SchemaDefinition,
+} from "convex/server";
+import { type ComponentApi } from "../component/_generated/component.js";
+import { componentsGeneric } from "convex/server";
+import { register } from "../test.js";
+
+export function initConvexTest<
+  Schema extends SchemaDefinition<GenericSchema, boolean>,
+>(schema?: Schema) {
+  const t = convexTest(schema ?? defineSchema({}), modules);
+  register(t);
+  return t;
+}
+export const components = componentsGeneric() as unknown as {
+  convexLangfuse: ComponentApi;
+};
+
+test("setup", () => {});