duron 0.3.0-beta.8 → 0.3.0

package/dist/adapters/schemas.js

@@ -1,7 +1,13 @@
 import { z } from 'zod';
 import { JOB_STATUSES, STEP_STATUSES } from '../constants.js';
+// ============================================================================
+// Status Enums
+// ============================================================================
 export const JobStatusSchema = z.enum(JOB_STATUSES);
 export const StepStatusSchema = z.enum(STEP_STATUSES);
+// ============================================================================
+// Date Schema
+// ============================================================================
 const DateSchema = z.union([
     z.date(),
     z.string().transform((str) => new Date(str)),
@@ -13,10 +19,14 @@ export const SerializableErrorSchema = z.object({
     cause: z.any().optional(),
     stack: z.string().optional(),
 });
+// ============================================================================
+// Job Schema
+// ============================================================================
 export const JobSchema = z.object({
     id: z.string(),
     actionName: z.string(),
     groupKey: z.string(),
+    description: z.string().nullable().default(null),
     input: z.any(),
     output: z.any().nullable(),
     error: z.any().nullable(),
@@ -28,8 +38,14 @@ export const JobSchema = z.object({
     createdAt: DateSchema,
     updatedAt: DateSchema,
     concurrencyLimit: z.coerce.number(),
+    concurrencyStepLimit: z.coerce.number(),
     clientId: z.string().nullable().optional(),
+    /** Duration in milliseconds (finishedAt - startedAt). Null if job hasn't finished. */
+    durationMs: z.coerce.number().nullable().default(null),
 });
+// ============================================================================
+// JobStep Schema
+// ============================================================================
 export const JobStepSchema = z.object({
     id: z.string(),
     jobId: z.string(),
@@ -50,9 +66,22 @@ export const JobStepSchema = z.object({
     createdAt: DateSchema,
     updatedAt: DateSchema,
 });
+// JobStep without output (for getJobSteps)
 export const JobStepWithoutOutputSchema = JobStepSchema.omit({ output: true });
+// ============================================================================
+// Query Option Schemas
+// ============================================================================
 export const SortOrderSchema = z.enum(['asc', 'desc']);
-export const JobSortFieldSchema = z.enum(['createdAt', 'startedAt', 'finishedAt', 'status', 'actionName', 'expiresAt']);
+export const JobSortFieldSchema = z.enum([
+    'createdAt',
+    'startedAt',
+    'finishedAt',
+    'status',
+    'actionName',
+    'expiresAt',
+    'duration',
+    'description',
+]);
 export const JobSortSchema = z.object({
     field: JobSortFieldSchema,
     order: SortOrderSchema,
@@ -62,6 +91,7 @@ export const JobFiltersSchema = z.object({
     actionName: z.union([z.string(), z.array(z.string())]).optional(),
     groupKey: z.union([z.string(), z.array(z.string())]).optional(),
     clientId: z.union([z.string(), z.array(z.string())]).optional(),
+    description: z.string().optional(),
     createdAt: z.union([DateSchema, z.array(DateSchema).length(2)]).optional(),
     startedAt: z.union([DateSchema, z.array(DateSchema).length(2)]).optional(),
     finishedAt: z.union([DateSchema, z.array(DateSchema).length(2)]).optional(),
@@ -81,66 +111,109 @@ export const GetJobStepsOptionsSchema = z.object({
     search: z.string().optional(),
     updatedAfter: DateSchema.optional(),
 });
+// ============================================================================
+// Job Option Schemas
+// ============================================================================
 export const CreateJobOptionsSchema = z.object({
+    /** The queue name (action name) */
     queue: z.string(),
+    /** The group key for concurrency control */
     groupKey: z.string(),
+    /** The checksum of the action */
     checksum: z.string(),
+    /** The job input data */
     input: z.any(),
+    /** Timeout in milliseconds for the job */
     timeoutMs: z.number(),
+    /** The concurrency limit for this job's group */
     concurrencyLimit: z.number(),
+    /** The concurrency limit for steps within this job */
+    concurrencyStepLimit: z.number(),
+    /** Optional description for the job */
+    description: z.string().nullable().optional(),
 });
 export const RecoverJobsOptionsSchema = z.object({
+    /** The action checksums to recover jobs for */
     checksums: z.array(z.string()),
+    /** Whether to ping other processes before recovering their jobs */
     multiProcessMode: z.boolean().optional(),
+    /** Timeout in milliseconds to wait for process ping responses */
     processTimeout: z.number().optional(),
 });
 export const FetchOptionsSchema = z.object({
+    /** Maximum number of jobs to fetch in this batch */
     batch: z.number(),
 });
 export const CompleteJobOptionsSchema = z.object({
+    /** The ID of the job to complete */
     jobId: z.string(),
+    /** The job output data */
     output: z.any(),
 });
 export const FailJobOptionsSchema = z.object({
+    /** The ID of the job to fail */
     jobId: z.string(),
+    /** The error data */
     error: z.any(),
 });
 export const CancelJobOptionsSchema = z.object({
+    /** The ID of the job to cancel */
     jobId: z.string(),
 });
 export const RetryJobOptionsSchema = z.object({
+    /** The ID of the job to retry */
     jobId: z.string(),
 });
 export const DeleteJobOptionsSchema = z.object({
+    /** The ID of the job to delete */
     jobId: z.string(),
 });
 export const DeleteJobsOptionsSchema = GetJobsOptionsSchema.optional();
 export const TimeTravelJobOptionsSchema = z.object({
+    /** The ID of the job to time travel */
     jobId: z.string(),
+    /** The ID of the step to restart from */
     stepId: z.string(),
 });
+// ============================================================================
+// Step Option Schemas
+// ============================================================================
 export const CreateOrRecoverJobStepOptionsSchema = z.object({
+    /** The ID of the job this step belongs to */
     jobId: z.string(),
+    /** The ID of the parent step (null for root steps) */
     parentStepId: z.string().nullable().default(null),
+    /** Whether this step runs in parallel (independent from siblings during time travel) */
     parallel: z.boolean().default(false),
+    /** The name of the step */
     name: z.string(),
+    /** Timeout in milliseconds for the step */
     timeoutMs: z.number(),
+    /** Maximum number of retries for the step */
     retriesLimit: z.number(),
 });
 export const CompleteJobStepOptionsSchema = z.object({
+    /** The ID of the step to complete */
     stepId: z.string(),
+    /** The step output data */
     output: z.any(),
 });
 export const FailJobStepOptionsSchema = z.object({
+    /** The ID of the step to fail */
     stepId: z.string(),
+    /** The error data */
     error: z.any(),
 });
 export const DelayJobStepOptionsSchema = z.object({
+    /** The ID of the step to delay */
     stepId: z.string(),
+    /** The delay in milliseconds */
     delayMs: z.number(),
+    /** The error data */
     error: z.any(),
 });
 export const CancelJobStepOptionsSchema = z.object({
+    /** The ID of the step to cancel */
     stepId: z.string(),
 });
 export const CreateOrRecoverJobStepResultSchema = z.object({
@@ -153,6 +226,10 @@ export const CreateOrRecoverJobStepResultSchema = z.object({
     output: z.any().nullable(),
     isNew: z.boolean(),
 });
+// ============================================================================
+// Response Schemas
+// ============================================================================
+// Simple response schemas
 export const JobIdResultSchema = z.union([z.string(), z.null()]);
 export const BooleanResultSchema = z.boolean();
 export const NumberResultSchema = z.number();
@@ -187,47 +264,83 @@ export const JobStepStatusResultSchema = z.object({
     status: StepStatusSchema,
     updatedAt: DateSchema,
 });
-export const MetricTypeSchema = z.enum(['metric', 'span_event', 'span_attribute']);
-export const MetricSchema = z.object({
-    id: z.string(),
-    jobId: z.string(),
+// ============================================================================
+// Span Schemas (OpenTelemetry compatible)
+// ============================================================================
+/**
+ * SpanKind values (OpenTelemetry standard):
+ * 0 = INTERNAL - Default, internal operation
+ * 1 = SERVER - Server-side handling of RPC/HTTP request
+ * 2 = CLIENT - Client-side of RPC/HTTP request
+ * 3 = PRODUCER - Producer of async message
+ * 4 = CONSUMER - Consumer of async message
+ */
+export const SpanKindSchema = z.union([z.literal(0), z.literal(1), z.literal(2), z.literal(3), z.literal(4)]);
+/**
+ * SpanStatusCode values (OpenTelemetry standard):
+ * 0 = UNSET - Status not set
+ * 1 = OK - Operation completed successfully
+ * 2 = ERROR - Operation failed
+ */
+export const SpanStatusCodeSchema = z.union([z.literal(0), z.literal(1), z.literal(2)]);
+export const SpanEventSchema = z.object({
+    name: z.string(),
+    timeUnixNano: z.string(),
+    attributes: z.record(z.string(), z.any()).optional(),
+});
+export const SpanSchema = z.object({
+    id: z.number(),
+    traceId: z.string(),
+    spanId: z.string(),
+    parentSpanId: z.string().nullable(),
+    jobId: z.string().nullable(),
     stepId: z.string().nullable(),
     name: z.string(),
-    value: z.number(),
+    kind: SpanKindSchema,
+    startTimeUnixNano: z.string().nullable(), // Stored as bigint but serialized as string for JSON
+    endTimeUnixNano: z.string().nullable(), // Stored as bigint but serialized as string for JSON
+    statusCode: SpanStatusCodeSchema,
+    statusMessage: z.string().nullable(),
     attributes: z.record(z.string(), z.any()),
-    type: MetricTypeSchema,
-    timestamp: DateSchema,
-    createdAt: DateSchema,
+    events: z.array(SpanEventSchema),
 });
-export const MetricSortFieldSchema = z.enum(['name', 'value', 'timestamp', 'createdAt']);
-export const MetricSortSchema = z.object({
-    field: MetricSortFieldSchema,
+export const SpanSortFieldSchema = z.enum(['name', 'startTimeUnixNano', 'endTimeUnixNano']);
+export const SpanSortSchema = z.object({
+    field: SpanSortFieldSchema,
     order: SortOrderSchema,
 });
-export const MetricFiltersSchema = z.object({
+export const SpanFiltersSchema = z.object({
     name: z.union([z.string(), z.array(z.string())]).optional(),
-    type: z.union([MetricTypeSchema, z.array(MetricTypeSchema)]).optional(),
+    kind: z.union([SpanKindSchema, z.array(SpanKindSchema)]).optional(),
+    statusCode: z.union([SpanStatusCodeSchema, z.array(SpanStatusCodeSchema)]).optional(),
+    traceId: z.string().optional(),
     attributesFilter: z.record(z.string(), z.any()).optional(),
-    timestampRange: z.array(DateSchema).length(2).optional(),
 });
-export const InsertMetricOptionsSchema = z.object({
-    jobId: z.string(),
-    stepId: z.string().optional(),
+export const InsertSpanOptionsSchema = z.object({
+    traceId: z.string(),
+    spanId: z.string(),
+    parentSpanId: z.string().nullable(),
+    jobId: z.string().nullable(),
+    stepId: z.string().nullable(),
     name: z.string(),
-    value: z.number(),
+    kind: SpanKindSchema,
+    startTimeUnixNano: z.bigint(),
+    endTimeUnixNano: z.bigint().nullable(),
+    statusCode: SpanStatusCodeSchema,
+    statusMessage: z.string().nullable(),
     attributes: z.record(z.string(), z.any()).optional(),
-    type: MetricTypeSchema,
+    events: z.array(SpanEventSchema).optional(),
 });
-export const GetMetricsOptionsSchema = z.object({
+export const GetSpansOptionsSchema = z.object({
     jobId: z.string().optional(),
     stepId: z.string().optional(),
-    filters: MetricFiltersSchema.optional(),
-    sort: MetricSortSchema.optional(),
+    filters: SpanFiltersSchema.optional(),
+    sort: SpanSortSchema.optional(),
 });
-export const GetMetricsResultSchema = z.object({
-    metrics: z.array(MetricSchema),
+export const GetSpansResultSchema = z.object({
+    spans: z.array(SpanSchema),
     total: z.number().int().nonnegative(),
 });
-export const DeleteMetricsOptionsSchema = z.object({
+export const DeleteSpansOptionsSchema = z.object({
     jobId: z.string(),
 });