autotel-tanstack 1.13.46 → 1.13.48

package/dist/testing.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"testing.js","names":[],"sources":["../src/testing.ts"],"sourcesContent":["import { type ReadableSpan } from '@opentelemetry/sdk-trace-base';\nimport { InMemorySpanExporter } from 'autotel/exporters';\nimport { SimpleSpanProcessor } from 'autotel/processors';\nimport { init } from 'autotel';\n\n/**\n * Test harness for TanStack instrumentation testing\n *\n * Provides utilities for testing TanStack Start applications\n * with autotel-tanstack instrumentation.\n */\nexport interface TestHarness {\n  /**\n   * The in-memory span exporter\n   */\n  exporter: {\n    getFinishedSpans(): ReadableSpan[];\n    reset(): void;\n  };\n\n  /**\n   * Get all finished spans\n   */\n  getSpans(): ReadableSpan[];\n\n  /**\n   * Get spans by name (exact match or regex)\n   */\n  getSpansByName(name: string | RegExp): ReadableSpan[];\n\n  /**\n   * Get spans by TanStack type\n   */\n  getSpansByType(\n    type: 'request' | 'serverFn' | 'loader' | 'beforeLoad',\n  ): ReadableSpan[];\n\n  /**\n   * Reset collected spans\n   */\n  reset(): void;\n\n  /**\n   * Assert a span exists\n   */\n  assertSpanExists(name: string | RegExp): void;\n\n  /**\n   * Assert a span has a specific attribute\n   */\n  assertSpanHasAttribute(\n    name: string | RegExp,\n    attr: string,\n    value?: unknown,\n  ): void;\n\n  /**\n   * Assert a server function was traced\n   */\n  assertServerFnTraced(name: string): void;\n\n  /**\n   * Assert a loader was traced\n   */\n  assertLoaderTraced(routeId: string): void;\n\n  /**\n   * Assert a beforeLoad was traced\n   */\n  assertBeforeLoadTraced(routeId: string): void;\n\n  /**\n   * Assert an HTTP request was traced\n   */\n  assertRequestTraced(method: string, path: string): void;\n}\n\n/**\n * Create a test harness for TanStack instrumentation testing\n *\n * This sets up autotel with an in-memory exporter for testing.\n * Call this in your test setup to capture and assert on spans.\n *\n * @returns Test harness with assertion helpers\n *\n * @example\n * ```typescript\n * import { describe, it, beforeEach } from 'vitest';\n * import { createTestHarness } from 'autotel-tanstack/testing';\n *\n * describe('MyServerFunction', () => {\n *   let harness: ReturnType<typeof createTestHarness>;\n *\n *   beforeEach(() => {\n *     harness = createTestHarness();\n *   });\n *\n *   afterEach(() => {\n *     harness.reset();\n *   });\n *\n *   it('should trace the server function', async () => {\n *     await myServerFunction({ id: '123' });\n *\n *     harness.assertServerFnTraced('myServerFunction');\n *     harness.assertSpanHasAttribute(\n *       /tanstack\\.serverFn/,\n *       'tanstack.server_function.name',\n *       'myServerFunction'\n *     );\n *   });\n * });\n * ```\n */\nexport function createTestHarness(): TestHarness {\n  const exporter = new InMemorySpanExporter();\n\n  init({\n    service: 'test',\n    spanProcessors: [new SimpleSpanProcessor(exporter)],\n  });\n\n  function getSpans(): ReadableSpan[] {\n    return exporter.getFinishedSpans() as ReadableSpan[];\n  }\n\n  function getSpansByName(name: string | RegExp): ReadableSpan[] {\n    const spans = getSpans();\n    if (typeof name === 'string') {\n      return spans.filter((s) => s.name === name);\n    }\n    return spans.filter((s) => name.test(s.name));\n  }\n\n  function getSpansByType(\n    type: 'request' | 'serverFn' | 'loader' | 'beforeLoad',\n  ): ReadableSpan[] {\n    return getSpans().filter((s) => s.attributes['tanstack.type'] === type);\n  }\n\n  function reset(): void {\n    exporter.reset();\n  }\n\n  function assertSpanExists(name: string | RegExp): void {\n    const spans = getSpansByName(name);\n    if (spans.length === 0) {\n      const allSpanNames = getSpans().map((s) => s.name);\n      throw new Error(\n        `Expected span \"${name}\" to exist. Found spans: ${JSON.stringify(allSpanNames)}`,\n      );\n    }\n  }\n\n  function assertSpanHasAttribute(\n    name: string | RegExp,\n    attr: string,\n    value?: unknown,\n  ): void {\n    const spans = getSpansByName(name);\n    if (spans.length === 0) {\n      throw new Error(`Span \"${name}\" not found`);\n    }\n\n    const span = spans[0];\n    const attrValue = span.attributes[attr];\n\n    if (attrValue === undefined) {\n      throw new Error(\n        `Attribute \"${attr}\" not found on span \"${span.name}\". ` +\n          `Available attributes: ${JSON.stringify(Object.keys(span.attributes))}`,\n      );\n    }\n\n    if (value !== undefined && attrValue !== value) {\n      throw new Error(\n        `Expected attribute \"${attr}\" to be \"${value}\", got \"${attrValue}\"`,\n      );\n    }\n  }\n\n  function assertServerFnTraced(name: string): void {\n    assertSpanExists(`tanstack.serverFn.${name}`);\n  }\n\n  function assertLoaderTraced(routeId: string): void {\n    assertSpanExists(`tanstack.loader.${routeId}`);\n  }\n\n  function assertBeforeLoadTraced(routeId: string): void {\n    assertSpanExists(`tanstack.beforeLoad.${routeId}`);\n  }\n\n  function assertRequestTraced(method: string, path: string): void {\n    assertSpanExists(`${method} ${path}`);\n  }\n\n  return {\n    exporter,\n    getSpans,\n    getSpansByName,\n    getSpansByType,\n    reset,\n    assertSpanExists,\n    assertSpanHasAttribute,\n    assertServerFnTraced,\n    assertLoaderTraced,\n    assertBeforeLoadTraced,\n    assertRequestTraced,\n  };\n}\n\n/**\n * Mock request factory for testing\n *\n * Creates mock Request objects for testing middleware and handlers.\n *\n * @example\n * ```typescript\n * const request = createMockRequest('GET', '/api/users', {\n *   headers: { 'x-request-id': 'test-123' },\n * });\n * ```\n */\nexport function createMockRequest(\n  method: string,\n  path: string,\n  options: {\n    headers?: Record<string, string>;\n    body?: string;\n    traceparent?: string;\n  } = {},\n): Request {\n  const headers = new Headers(options.headers);\n\n  if (options.traceparent) {\n    headers.set('traceparent', options.traceparent);\n  }\n\n  return new Request(`http://localhost${path}`, {\n    method,\n    headers,\n    body: options.body,\n  });\n}\n\n/**\n * Generate a valid W3C traceparent header for testing\n *\n * @param traceId - Optional 32-char hex trace ID\n * @param spanId - Optional 16-char hex span ID\n * @returns Valid traceparent header string\n *\n * @example\n * ```typescript\n * const traceparent = generateTraceparent();\n * const request = createMockRequest('GET', '/api/users', { traceparent });\n * ```\n */\nexport function generateTraceparent(traceId?: string, spanId?: string): string {\n  const version = '00';\n  const trace = traceId || generateHex(32);\n  const span = spanId || generateHex(16);\n  const flags = '01'; // Sampled\n\n  return `${version}-${trace}-${span}-${flags}`;\n}\n\nfunction generateHex(length: number): string {\n  const chars = '0123456789abcdef';\n  let result = '';\n  for (let i = 0; i < length; i++) {\n    result += chars[Math.floor(Math.random() * 16)];\n  }\n  return result;\n}\n\n/**\n * Serialized span shape returned by the test-spans HTTP endpoint.\n * Mirrors the fields the Playwright side needs for assertions.\n *\n * Defined as a `type` (not `interface`) so it is assignable to\n * `Record<string, unknown>` in TypeScript 6+ strict mode.\n */\nexport type SerializedSpan = {\n  name: string;\n  spanId: string;\n  traceId: string;\n  parentSpanId?: string;\n  attributes?: Record<string, unknown>;\n  status: { code: number; message?: string };\n  durationMs: number;\n};\n\ninterface TestSpanExporter {\n  getFinishedSpans(): Array<{\n    name: string;\n    spanContext(): { spanId: string; traceId: string };\n    parentSpanContext?: { spanId: string };\n    attributes: Record<string, unknown>;\n    status: { code: number; message?: string };\n    duration: [number, number];\n  }>;\n  reset(): void;\n}\n\nfunction getExporter(): TestSpanExporter | undefined {\n  return (globalThis as Record<string, unknown>).__testSpanExporter as\n    TestSpanExporter | undefined;\n}\n\nfunction e2eGuard(): Response | null {\n  if (process.env.E2E !== '1') {\n    return Response.json(\n      { error: 'test-spans endpoint only available in E2E mode' },\n      { status: 404 },\n    );\n  }\n  return null;\n}\n\nfunction exporterGuard(): Response | null {\n  if (!getExporter()) {\n    return Response.json(\n      { error: 'in-memory span exporter not initialized' },\n      { status: 500 },\n    );\n  }\n  return null;\n}\n\n/**\n * Accepts either a raw `Request` (legacy) or a TanStack Router context\n * object containing `{ request: Request }` (Router 1.168+).\n */\ntype HandlerInput = Request | { request: Request };\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype CreateFileRoute = (path: string) => (options: any) => any;\n\n/**\n * Creates GET and DELETE handlers for a test-spans HTTP endpoint.\n *\n * Use in a TanStack Start route to expose in-memory spans for Playwright assertions.\n * Only works when E2E=1 (set in webServer command).\n *\n * Handlers accept either a raw `Request` or a TanStack Router context\n * object `{ request: Request }`, so they work with both Router < 1.168\n * and Router >= 1.168.\n *\n * @example\n * ```typescript\n * // src/routes/api/test-spans.ts\n * import { createFileRoute } from \"@tanstack/react-router\";\n * import { createTestSpansHandlers } from 'autotel-tanstack/testing';\n * const { GET, DELETE } = createTestSpansHandlers();\n * export const Route = createFileRoute('/api/test-spans')({\n *   server: { handlers: { GET, DELETE } },\n * });\n * ```\n */\n/**\n * Creates a pre-built TanStack Start route for the test-spans endpoint.\n *\n * Reduces E2E boilerplate to three lines. The handlers accept both\n * `Request` and `{ request: Request }` so they work with any Router version.\n *\n * @param createFileRoute - Pass `createFileRoute` from `@tanstack/react-router`\n * @param path - Route path (default: `/api/test-spans`)\n *\n * @example\n * ```typescript\n * // src/routes/api/test-spans.ts\n * import { createFileRoute } from \"@tanstack/react-router\";\n * import { createTestSpansRoute } from \"autotel-tanstack/testing\";\n *\n * export const Route = createTestSpansRoute(createFileRoute);\n * ```\n */\nexport function createTestSpansRoute(\n  createFileRoute: CreateFileRoute,\n  path = '/api/test-spans',\n) {\n  const { GET, DELETE } = createTestSpansHandlers();\n  return createFileRoute(path)({\n    server: {\n      handlers: { GET, DELETE },\n    },\n  });\n}\n\nexport function createTestSpansHandlers(): {\n  GET: (input: HandlerInput) => Response;\n  DELETE: (input: HandlerInput) => Response;\n} {\n  return {\n    GET(_input: HandlerInput): Response {\n      const guard = e2eGuard() ?? exporterGuard();\n      if (guard) return guard;\n\n      const spans: SerializedSpan[] = getExporter()!\n        .getFinishedSpans()\n        .map((span) => {\n          const { spanId, traceId } = span.spanContext();\n          const serialized: SerializedSpan = {\n            name: span.name,\n            spanId,\n            traceId,\n            attributes: span.attributes,\n            status: span.status,\n            durationMs: span.duration[0] * 1000 + span.duration[1] / 1_000_000,\n          };\n          if (span.parentSpanContext?.spanId) {\n            serialized.parentSpanId = span.parentSpanContext.spanId;\n          }\n          return serialized;\n        });\n\n      return Response.json({ spans });\n    },\n\n    DELETE(_input: HandlerInput): Response {\n      const guard = e2eGuard() ?? exporterGuard();\n      if (guard) return guard;\n      getExporter()!.reset();\n      return Response.json({ ok: true });\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/types-BJ7FyVoX.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types-BJ7FyVoX.d.ts","names":[],"sources":["../src/browser/types.ts"],"mappings":";;;;;;;;;KASY,aAAa;;;;UAKR;EACf;EACA;EACA;EACA;EACA;EACA,yBAAyB;EACzB;EACA,oBAAoB;IAClB;IACA;IACA,UAAU;IACV;IACA;QACI;;;;;UAMS,gCAAgC;EAC/C;;;;;UAMe;EACf;EACA;EACA;;;;;UAMe;EACf;EACA;EACA;;;;;UAMe,+BAA+B;EAC9C;EACA,UAAU;;;;;cAMC,gBAAgB,SAC3B,KAAK;;;;cAaM"}

package/dist/types-zkKShSiK.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types-zkKShSiK.d.ts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;UAKiB;;;;;EAKf;;;;;;EAOA;;;;;;EAOA;;;;;EAMA;;;;;EAMA;;;;;EAMA,yBAAyB;;;;;;;;EASzB;;;;EAKA,oBAAoB;IAClB;IACA;IACA,UAAU;IACV;IACA;QACI;;;;;UAMS,gCAAgC;;;;;;;EAO/C;;;;;UAMe;;;;;EAKf;;;;;EAMA;;;;;EAMA;;;;;UAMe;;;;;EAKf;;;;;EAMA;;;;;EAMA;;;;;UAMe,+BAA+B;;;;;EAK9C;;;;;EAMA,UAAU;;;;;cAMC,gBAAgB,SAC3B,KAAK;;;;cAaM"}