duron 0.3.0-beta.9 → 0.3.0

package/dist/server.d.ts

@@ -1,11 +1,27 @@
 import { Elysia } from 'elysia';
 import { z } from 'zod';
-import { JobSortFieldSchema, MetricSortFieldSchema, SortOrderSchema } from './adapters/schemas.js';
+import { JobSortFieldSchema, SortOrderSchema, SpanSortFieldSchema } from './adapters/schemas.js';
 import type { Client } from './client.js';
+/**
+ * Error thrown when a requested resource is not found.
+ */
 export declare class NotFoundError extends Error {
+    /**
+     * Create a new NotFoundError.
+     *
+     * @param message - Error message describing what was not found
+     */
     constructor(message: string);
 }
+/**
+ * Error thrown when authentication fails.
+ */
 export declare class UnauthorizedError extends Error {
+    /**
+     * Create a new UnauthorizedError.
+     *
+     * @param message - Error message describing the authentication failure
+     */
     constructor(message: string);
 }
 export declare const GetJobStepsQuerySchema: z.ZodPipe<z.ZodObject<{
@@ -73,6 +89,7 @@ export declare const GetJobsQuerySchema: z.ZodPipe<z.ZodObject<{
     fActionName: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
     fGroupKey: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
     fClientId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    fDescription: z.ZodOptional<z.ZodString>;
     fCreatedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodCoercedDate<unknown>, z.ZodArray<z.ZodCoercedDate<unknown>>]>>;
     fStartedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodCoercedDate<unknown>, z.ZodArray<z.ZodCoercedDate<unknown>>]>>;
     fFinishedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodCoercedDate<unknown>, z.ZodArray<z.ZodCoercedDate<unknown>>]>>;
@@ -96,6 +113,7 @@ export declare const GetJobsQuerySchema: z.ZodPipe<z.ZodObject<{
     fActionName?: string | string[] | undefined;
     fGroupKey?: string | string[] | undefined;
     fClientId?: string | string[] | undefined;
+    fDescription?: string | undefined;
     fCreatedAt?: Date | Date[] | undefined;
     fStartedAt?: Date | Date[] | undefined;
     fFinishedAt?: Date | Date[] | undefined;
@@ -110,6 +128,7 @@ export declare const GetJobsResponseSchema: z.ZodObject<{
         id: z.ZodString;
         actionName: z.ZodString;
         groupKey: z.ZodString;
+        description: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         input: z.ZodAny;
         output: z.ZodNullable<z.ZodAny>;
         error: z.ZodNullable<z.ZodAny>;
@@ -127,7 +146,9 @@ export declare const GetJobsResponseSchema: z.ZodObject<{
         createdAt: z.ZodUnion<readonly [z.ZodDate, z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<Date, number>>]>;
         updatedAt: z.ZodUnion<readonly [z.ZodDate, z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<Date, number>>]>;
         concurrencyLimit: z.ZodCoercedNumber<unknown>;
+        concurrencyStepLimit: z.ZodCoercedNumber<unknown>;
         clientId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        durationMs: z.ZodDefault<z.ZodNullable<z.ZodCoercedNumber<unknown>>>;
     }, z.core.$strip>>;
     total: z.ZodNumber;
     page: z.ZodNumber;
@@ -149,34 +170,26 @@ export declare const GetActionsMetadataResponseSchema: z.ZodArray<z.ZodObject<{
 }, z.core.$strip>>;
 export type GetJobsQueryInput = z.input<typeof GetJobsQuerySchema>;
 export type GetJobStepsQueryInput = z.input<typeof GetJobStepsQuerySchema>;
-export declare const GetMetricsQuerySchema: z.ZodPipe<z.ZodObject<{
+export declare const GetSpansQuerySchema: z.ZodPipe<z.ZodObject<{
     fName: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
-    fType: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
-        metric: "metric";
-        span_event: "span_event";
-        span_attribute: "span_attribute";
-    }>, z.ZodArray<z.ZodEnum<{
-        metric: "metric";
-        span_event: "span_event";
-        span_attribute: "span_attribute";
-    }>>]>>;
-    fTimestampRange: z.ZodOptional<z.ZodArray<z.ZodCoercedDate<unknown>>>;
+    fKind: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>, z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>]>>;
+    fTraceId: z.ZodOptional<z.ZodString>;
     fAttributesFilter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     sort: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodTransform<{
     filters: any;
     sort: {
-        field: z.infer<typeof MetricSortFieldSchema>;
+        field: z.infer<typeof SpanSortFieldSchema>;
         order: z.infer<typeof SortOrderSchema>;
     } | undefined;
 }, {
     fName?: string | string[] | undefined;
-    fType?: "metric" | "span_event" | "span_attribute" | ("metric" | "span_event" | "span_attribute")[] | undefined;
-    fTimestampRange?: Date[] | undefined;
+    fKind?: 0 | 4 | 1 | 3 | 2 | (0 | 4 | 1 | 3 | 2)[] | undefined;
+    fTraceId?: string | undefined;
     fAttributesFilter?: Record<string, any> | undefined;
     sort?: string | undefined;
 }>>;
-export type GetMetricsQueryInput = z.input<typeof GetMetricsQuerySchema>;
+export type GetSpansQueryInput = z.input<typeof GetSpansQuerySchema>;
 export declare const ErrorResponseSchema: z.ZodObject<{
     error: z.ZodString;
     message: z.ZodOptional<z.ZodString>;
@@ -198,20 +211,45 @@ export declare const TimeTravelJobResponseSchema: z.ZodObject<{
     message: z.ZodString;
 }, z.core.$strip>;
 export interface CreateServerOptions<P extends string> {
+    /**
+     * The Duron instance to use for the API endpoints
+     */
     client: Client<any, any>;
+    /**
+     * Optional prefix for all routes (default: '/api')
+     */
     prefix?: P;
-    metricsEnabled?: boolean;
+    /**
+     * Enable spans endpoints (/jobs/:id/spans, /steps/:id/spans).
+     * Only works when client is configured with telemetry.local enabled.
+     * When true, enables the dashboard to show spans buttons.
+     * @default auto-detected from client.spansEnabled
+     */
+    spansEnabled?: boolean;
     login?: {
         onLogin: (body: {
             email: string;
             password: string;
         }) => Promise<boolean>;
         jwtSecret: string | Uint8Array;
+        /**
+         * Optional expiration time for the access JWT token (default: '1h')
+         */
         expirationTime?: string;
+        /**
+         * Optional expiration time for the refresh token (default: '7d')
+         */
         refreshTokenExpirationTime?: string;
     };
 }
-export declare function createServer<P extends string>({ client, prefix, login, metricsEnabled }: CreateServerOptions<P>): Elysia<P, {
+/**
+ * Creates an Elysia server instance with duron API endpoints.
+ * All endpoints use Zod for input and response validation.
+ *
+ * @param options - Configuration options
+ * @returns Elysia server instance
+ */
+export declare function createServer<P extends string>({ client, prefix, login, spansEnabled }: CreateServerOptions<P>): Elysia<P, {
     decorator: {};
     store: {};
     derive: {};
@@ -550,6 +588,7 @@ export declare function createServer<P extends string>({ client, prefix, login,
                 id: string;
                 actionName: string;
                 groupKey: string;
+                description: string | null;
                 input: any;
                 output: any;
                 error: any;
@@ -561,6 +600,8 @@ export declare function createServer<P extends string>({ client, prefix, login,
                 createdAt: Date;
                 updatedAt: Date;
                 concurrencyLimit: number;
+                concurrencyStepLimit: number;
+                durationMs: number | null;
                 clientId?: string | null | undefined;
             };
             401: {
@@ -676,6 +717,7 @@ export declare function createServer<P extends string>({ client, prefix, login,
                     id: string;
                     actionName: string;
                     groupKey: string;
+                    description: string | null;
                     input: any;
                     output: any;
                     error: any;
@@ -687,6 +729,8 @@ export declare function createServer<P extends string>({ client, prefix, login,
                     createdAt: Date;
                     updatedAt: Date;
                     concurrencyLimit: number;
+                    concurrencyStepLimit: number;
+                    durationMs: number | null;
                     clientId?: string | null | undefined;
                 }[];
                 total: number;
@@ -1141,7 +1185,7 @@ export declare function createServer<P extends string>({ client, prefix, login,
         headers: unknown;
         response: {
             200: {
-                metricsEnabled: boolean;
+                spansEnabled: boolean;
                 authEnabled: boolean;
             };
             422: {
@@ -1159,7 +1203,7 @@ export declare function createServer<P extends string>({ client, prefix, login,
             };
         };
     };
-}> & import("elysia").CreateEden<`${P}/jobs/:id/metrics`, {
+}> & import("elysia").CreateEden<`${P}/jobs/:id/spans`, {
     get: {
         body: {};
         params: {
@@ -1168,7 +1212,7 @@ export declare function createServer<P extends string>({ client, prefix, login,
         query: {
             filters: any;
             sort: {
-                field: z.infer<typeof MetricSortFieldSchema>;
+                field: z.infer<typeof SpanSortFieldSchema>;
                 order: z.infer<typeof SortOrderSchema>;
             } | undefined;
         };
@@ -1177,16 +1221,25 @@ export declare function createServer<P extends string>({ client, prefix, login,
         };
         response: {
             200: {
-                metrics: {
-                    id: string;
-                    jobId: string;
+                spans: {
+                    id: number;
+                    traceId: string;
+                    spanId: string;
+                    parentSpanId: string | null;
+                    jobId: string | null;
                     stepId: string | null;
                     name: string;
-                    value: number;
+                    kind: 0 | 4 | 1 | 3 | 2;
+                    startTimeUnixNano: string | null;
+                    endTimeUnixNano: string | null;
+                    statusCode: 0 | 1 | 2;
+                    statusMessage: string | null;
                     attributes: Record<string, any>;
-                    type: "metric" | "span_event" | "span_attribute";
-                    timestamp: Date;
-                    createdAt: Date;
+                    events: {
+                        name: string;
+                        timeUnixNano: string;
+                        attributes?: Record<string, any> | undefined;
+                    }[];
                 }[];
                 total: number;
             };
@@ -1213,7 +1266,7 @@ export declare function createServer<P extends string>({ client, prefix, login,
             };
         };
     };
-}> & import("elysia").CreateEden<`${P}/steps/:id/metrics`, {
+}> & import("elysia").CreateEden<`${P}/steps/:id/spans`, {
     get: {
         body: {};
         params: {
@@ -1222,7 +1275,7 @@ export declare function createServer<P extends string>({ client, prefix, login,
         query: {
             filters: any;
             sort: {
-                field: z.infer<typeof MetricSortFieldSchema>;
+                field: z.infer<typeof SpanSortFieldSchema>;
                 order: z.infer<typeof SortOrderSchema>;
             } | undefined;
         };
@@ -1231,16 +1284,25 @@ export declare function createServer<P extends string>({ client, prefix, login,
         };
         response: {
             200: {
-                metrics: {
-                    id: string;
-                    jobId: string;
+                spans: {
+                    id: number;
+                    traceId: string;
+                    spanId: string;
+                    parentSpanId: string | null;
+                    jobId: string | null;
                     stepId: string | null;
                     name: string;
-                    value: number;
+                    kind: 0 | 4 | 1 | 3 | 2;
+                    startTimeUnixNano: string | null;
+                    endTimeUnixNano: string | null;
+                    statusCode: 0 | 1 | 2;
+                    statusMessage: string | null;
                     attributes: Record<string, any>;
-                    type: "metric" | "span_event" | "span_attribute";
-                    timestamp: Date;
-                    createdAt: Date;
+                    events: {
+                        name: string;
+                        timeUnixNano: string;
+                        attributes?: Record<string, any> | undefined;
+                    }[];
                 }[];
                 total: number;
             };

package/dist/server.d.ts.map

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

package/dist/server.js

@@ -1,19 +1,44 @@
 import { Elysia } from 'elysia';
 import { jwtVerify, SignJWT } from 'jose';
 import { z } from 'zod';
-import { GetActionsResultSchema, GetJobStepsResultSchema, GetJobsResultSchema, GetMetricsResultSchema, JobSchema, JobSortFieldSchema, JobStatusResultSchema, JobStatusSchema, JobStepSchema, JobStepStatusResultSchema, MetricSortFieldSchema, MetricTypeSchema, SortOrderSchema, } from './adapters/schemas.js';
+import { GetActionsResultSchema, GetJobStepsResultSchema, GetJobsResultSchema, GetSpansResultSchema, JobSchema, JobSortFieldSchema, JobStatusResultSchema, JobStatusSchema, JobStepSchema, JobStepStatusResultSchema, SortOrderSchema, SpanKindSchema, SpanSortFieldSchema, } from './adapters/schemas.js';
+// ============================================================================
+// Custom Errors
+// ============================================================================
+/**
+ * Error thrown when a requested resource is not found.
+ */
 export class NotFoundError extends Error {
+    /**
+     * Create a new NotFoundError.
+     *
+     * @param message - Error message describing what was not found
+     */
     constructor(message) {
         super(message);
         this.name = 'NotFoundError';
     }
 }
+/**
+ * Error thrown when authentication fails.
+ */
 export class UnauthorizedError extends Error {
+    /**
+     * Create a new UnauthorizedError.
+     *
+     * @param message - Error message describing the authentication failure
+     */
     constructor(message) {
         super(message);
         this.name = 'UnauthorizedError';
     }
 }
+// ============================================================================
+// Zod Validation Schemas
+// ============================================================================
+// Note: JobStatusSchema, JobSortFieldSchema, SortOrderSchema, JobSchema,
+// JobStepSchema, GetJobStepsResultSchema, GetJobsResultSchema, and
+// GetActionsResultSchema are imported from ./adapters/schemas.js to avoid duplication
 export const GetJobStepsQuerySchema = z
     .object({
     search: z.string().optional(),
@@ -23,21 +48,28 @@ export const GetJobStepsQuerySchema = z
     search: data.search,
     updatedAfter: data.fUpdatedAfter,
 }));
+// Reuse GetJobStepsResultSchema from schemas.ts
 export const GetJobStepsResponseSchema = GetJobStepsResultSchema;
 export const GetJobsQuerySchema = z
     .object({
+    // Pagination
     page: z.coerce.number().int().min(1).optional(),
     pageSize: z.coerce.number().int().min(1).max(1000).optional(),
+    // Filters - arrays can be passed as comma-separated or multiple params
     fStatus: z.union([JobStatusSchema, z.array(JobStatusSchema)]).optional(),
     fActionName: z.union([z.string(), z.array(z.string())]).optional(),
     fGroupKey: z.union([z.string(), z.array(z.string())]).optional(),
     fClientId: z.union([z.string(), z.array(z.string())]).optional(),
+    fDescription: z.string().optional(),
+    // Date filters: can be a single ISO string or JSON array [start, end] - both coerced to Date objects
     fCreatedAt: z.union([z.coerce.date(), z.array(z.coerce.date())]).optional(),
     fStartedAt: z.union([z.coerce.date(), z.array(z.coerce.date())]).optional(),
     fFinishedAt: z.union([z.coerce.date(), z.array(z.coerce.date())]).optional(),
     fUpdatedAfter: z.coerce.date().optional(),
     fSearch: z.string().optional(),
+    // Sort - format: "field:asc,field:desc"
     sort: z.string().optional(),
+    // JSONB filters as JSON strings
     fInputFilter: z.record(z.string(), z.any()).optional(),
     fOutputFilter: z.record(z.string(), z.any()).optional(),
 })
@@ -51,6 +83,8 @@ export const GetJobsQuerySchema = z
         filters.groupKey = data.fGroupKey;
     if (data.fClientId)
         filters.clientId = data.fClientId;
+    if (data.fDescription)
+        filters.description = data.fDescription;
     if (data.fCreatedAt)
         filters.createdAt = data.fCreatedAt;
     if (data.fStartedAt)
@@ -65,6 +99,7 @@ export const GetJobsQuerySchema = z
         filters.inputFilter = data.fInputFilter;
     if (data.fOutputFilter)
         filters.outputFilter = data.fOutputFilter;
+    // Parse sort string: "field:asc,field:desc" -> [{ field: 'field', order: 'asc' }, { field: 'field', order: 'desc' }]
     let sort;
     if (data.sort) {
         const sortParts = data.sort
@@ -77,6 +112,7 @@ export const GetJobsQuerySchema = z
             if (!field || !order) {
                 return null;
             }
+            // Validate field and order
             const fieldResult = JobSortFieldSchema.safeParse(field);
             const orderResult = SortOrderSchema.safeParse(order.toLowerCase());
             if (!fieldResult.success || !orderResult.success) {
@@ -88,6 +124,7 @@ export const GetJobsQuerySchema = z
             };
         })
             .filter((s) => s !== null);
+        // If no valid sorts were parsed, set to undefined
         if (parsedSorts.length === 0) {
             sort = undefined;
         }
@@ -102,35 +139,41 @@ export const GetJobsQuerySchema = z
         sort,
     };
 });
+// Reuse GetJobsResultSchema from schemas.ts
 export const GetJobsResponseSchema = GetJobsResultSchema;
+// Reuse GetActionsResultSchema from schemas.ts
 export const GetActionsResponseSchema = GetActionsResultSchema;
 export const GetActionsMetadataResponseSchema = z.array(z.object({
     name: z.string(),
     mockInput: z.any(),
 }));
-export const GetMetricsQuerySchema = z
+// Spans query schema
+export const GetSpansQuerySchema = z
     .object({
+    // Filters
     fName: z.union([z.string(), z.array(z.string())]).optional(),
-    fType: z.union([MetricTypeSchema, z.array(MetricTypeSchema)]).optional(),
-    fTimestampRange: z.array(z.coerce.date()).length(2).optional(),
+    fKind: z.union([SpanKindSchema, z.array(SpanKindSchema)]).optional(),
+    fTraceId: z.string().optional(),
     fAttributesFilter: z.record(z.string(), z.any()).optional(),
+    // Sort - format: "field:asc" or "field:desc"
     sort: z.string().optional(),
 })
     .transform((data) => {
     const filters = {};
     if (data.fName)
         filters.name = data.fName;
-    if (data.fType)
-        filters.type = data.fType;
-    if (data.fTimestampRange)
-        filters.timestampRange = data.fTimestampRange;
+    if (data.fKind)
+        filters.kind = data.fKind;
+    if (data.fTraceId)
+        filters.traceId = data.fTraceId;
     if (data.fAttributesFilter)
         filters.attributesFilter = data.fAttributesFilter;
+    // Parse sort string: "field:asc" -> { field: 'field', order: 'asc' }
     let sort;
     if (data.sort) {
         const [field, order] = data.sort.split(':').map((s) => s.trim());
         if (field && order) {
-            const fieldResult = MetricSortFieldSchema.safeParse(field);
+            const fieldResult = SpanSortFieldSchema.safeParse(field);
             const orderResult = SortOrderSchema.safeParse(order.toLowerCase());
             if (fieldResult.success && orderResult.success) {
                 sort = {
@@ -171,10 +214,19 @@ export const TimeTravelJobResponseSchema = z.object({
     success: z.boolean(),
     message: z.string(),
 });
-export function createServer({ client, prefix, login, metricsEnabled }) {
+/**
+ * Creates an Elysia server instance with duron API endpoints.
+ * All endpoints use Zod for input and response validation.
+ *
+ * @param options - Configuration options
+ * @returns Elysia server instance
+ */
+export function createServer({ client, prefix, login, spansEnabled }) {
+    // Convert string secret to Uint8Array if needed
     const secretKey = typeof login?.jwtSecret === 'string' ? new TextEncoder().encode(login?.jwtSecret) : login?.jwtSecret;
     const routePrefix = (prefix ?? '/api');
-    const isMetricsEnabled = metricsEnabled ?? client.metricsEnabled;
+    // Auto-detect spansEnabled from client if not explicitly set
+    const isSpansEnabled = spansEnabled ?? client.spansEnabled;
     return new Elysia({
         prefix: routePrefix,
     })
@@ -197,6 +249,7 @@ export function createServer({ client, prefix, login, metricsEnabled }) {
                 message: error.message,
             };
         }
+        // Handle other errors
         set.status = code === 'NOT_FOUND' ? 404 : 500;
         return {
             error: 'Internal server error',
@@ -215,6 +268,7 @@ export function createServer({ client, prefix, login, metricsEnabled }) {
                         user: null,
                     };
                 }
+                // Extract token from "Bearer <token>" format
                 const token = authHeader.startsWith('Bearer ') ? authHeader.slice(7) : authHeader;
                 if (!token) {
                     return {
@@ -472,54 +526,54 @@ export function createServer({ client, prefix, login, metricsEnabled }) {
     })
         .get('/config', async () => {
         return {
-            metricsEnabled: isMetricsEnabled,
+            spansEnabled: isSpansEnabled,
             authEnabled: !!login,
         };
     }, {
         response: {
             200: z.object({
-                metricsEnabled: z.boolean(),
+                spansEnabled: z.boolean(),
                 authEnabled: z.boolean(),
             }),
             500: ErrorResponseSchema,
         },
     })
-        .get('/jobs/:id/metrics', async ({ params, query }) => {
-        if (!isMetricsEnabled) {
-            throw new Error('Metrics are not enabled. Use LocalTelemetryAdapter to enable metrics.');
+        .get('/jobs/:id/spans', async ({ params, query }) => {
+        if (!isSpansEnabled) {
+            throw new Error('Spans are not enabled. Enable telemetry.local to enable spans.');
         }
         const options = {
             jobId: params.id,
             filters: query.filters,
             sort: query.sort,
         };
-        return client.getMetrics(options);
+        return client.getSpans(options);
     }, {
         params: JobIdParamsSchema,
-        query: GetMetricsQuerySchema,
+        query: GetSpansQuerySchema,
         response: {
-            200: GetMetricsResultSchema,
+            200: GetSpansResultSchema,
             400: ErrorResponseSchema,
             500: ErrorResponseSchema,
             401: ErrorResponseSchema,
         },
         auth: true,
     })
-        .get('/steps/:id/metrics', async ({ params, query }) => {
-        if (!isMetricsEnabled) {
-            throw new Error('Metrics are not enabled. Use LocalTelemetryAdapter to enable metrics.');
+        .get('/steps/:id/spans', async ({ params, query }) => {
+        if (!isSpansEnabled) {
+            throw new Error('Spans are not enabled. Enable telemetry.local to enable spans.');
         }
         const options = {
             stepId: params.id,
             filters: query.filters,
             sort: query.sort,
         };
-        return client.getMetrics(options);
+        return client.getSpans(options);
     }, {
         params: StepIdParamsSchema,
-        query: GetMetricsQuerySchema,
+        query: GetSpansQuerySchema,
         response: {
-            200: GetMetricsResultSchema,
+            200: GetSpansResultSchema,
             400: ErrorResponseSchema,
             500: ErrorResponseSchema,
             401: ErrorResponseSchema,
@@ -557,11 +611,13 @@ export function createServer({ client, prefix, login, metricsEnabled }) {
         if (!success) {
             throw new UnauthorizedError('Invalid credentials');
         }
+        // Generate access token (short-lived)
         const accessToken = await new SignJWT({ email, type: 'access' })
             .setProtectedHeader({ alg: 'HS256' })
             .setIssuedAt()
             .setExpirationTime(login.expirationTime ?? '1h')
             .sign(secretKey);
+        // Generate refresh token (long-lived)
         const refreshToken = await new SignJWT({ email, type: 'refresh' })
             .setProtectedHeader({ alg: 'HS256' })
             .setIssuedAt()
@@ -595,14 +651,17 @@ export function createServer({ client, prefix, login, metricsEnabled }) {
             throw new UnauthorizedError('Refresh token is required');
         }
         try {
+            // Verify refresh token
             const { payload } = await jwtVerify(providedRefreshToken, secretKey);
             const typedPayload = payload;
+            // Ensure it's a refresh token
             if (typedPayload.type !== 'refresh') {
                 throw new UnauthorizedError('Invalid token type');
             }
             if (!typedPayload.email) {
                 throw new UnauthorizedError('Invalid token payload');
             }
+            // Generate new access token
             const accessToken = await new SignJWT({ email: typedPayload.email, type: 'access' })
                 .setProtectedHeader({ alg: 'HS256' })
                 .setIssuedAt()