@objectstack/spec 0.7.1 → 0.7.2

package/dist/system/worker.zod.d.ts.map

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

package/dist/system/worker.zod.js

@@ -0,0 +1,479 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BatchTask = exports.WorkerConfig = exports.QueueConfig = exports.Task = exports.WorkerStatsSchema = exports.WorkerConfigSchema = exports.BatchProgressSchema = exports.BatchTaskSchema = exports.QueueConfigSchema = exports.TaskExecutionResultSchema = exports.TaskSchema = exports.TaskRetryPolicySchema = exports.TaskStatus = exports.TASK_PRIORITY_VALUES = exports.TaskPriority = void 0;
+const zod_1 = require("zod");
+/**
+ * Worker System Protocol
+ *
+ * Background task processing system with queues, priorities, and retry logic.
+ * Provides a robust foundation for async task execution similar to:
+ * - Sidekiq (Ruby)
+ * - Celery (Python)
+ * - Bull/BullMQ (Node.js)
+ * - AWS SQS/Lambda
+ *
+ * Features:
+ * - Task queues with priorities
+ * - Task scheduling and retry logic
+ * - Batch processing
+ * - Dead letter queues
+ * - Task monitoring and logging
+ *
+ * @example Basic task
+ * ```typescript
+ * const task: Task = {
+ *   id: 'task-123',
+ *   type: 'send_email',
+ *   payload: { to: 'user@example.com', subject: 'Welcome' },
+ *   queue: 'notifications',
+ *   priority: 5
+ * };
+ * ```
+ */
+// ==========================================
+// Task Priority
+// ==========================================
+/**
+ * Task Priority Enum
+ * Lower numbers = higher priority
+ */
+exports.TaskPriority = zod_1.z.enum([
+    'critical', // 0 - Must execute immediately
+    'high', // 1 - Execute soon
+    'normal', // 2 - Default priority
+    'low', // 3 - Execute when resources available
+    'background', // 4 - Execute during low-traffic periods
+]);
+/**
+ * Task Priority Mapping
+ * Maps priority names to numeric values for sorting
+ */
+exports.TASK_PRIORITY_VALUES = {
+    critical: 0,
+    high: 1,
+    normal: 2,
+    low: 3,
+    background: 4,
+};
+// ==========================================
+// Task Status
+// ==========================================
+/**
+ * Task Status Enum
+ * Lifecycle states of a task
+ */
+exports.TaskStatus = zod_1.z.enum([
+    'pending', // Waiting to be processed
+    'queued', // In queue, ready for worker
+    'processing', // Currently being executed
+    'completed', // Successfully completed
+    'failed', // Failed (may retry)
+    'cancelled', // Manually cancelled
+    'timeout', // Exceeded execution timeout
+    'dead', // Moved to dead letter queue
+]);
+// ==========================================
+// Task Schema
+// ==========================================
+/**
+ * Task Retry Policy Schema
+ * Configuration for task retry behavior
+ */
+exports.TaskRetryPolicySchema = zod_1.z.object({
+    maxRetries: zod_1.z.number().int().min(0).default(3).describe('Maximum retry attempts'),
+    backoffStrategy: zod_1.z.enum(['fixed', 'linear', 'exponential']).default('exponential')
+        .describe('Backoff strategy between retries'),
+    initialDelayMs: zod_1.z.number().int().positive().default(1000).describe('Initial retry delay in milliseconds'),
+    maxDelayMs: zod_1.z.number().int().positive().default(60000).describe('Maximum retry delay in milliseconds'),
+    backoffMultiplier: zod_1.z.number().positive().default(2).describe('Multiplier for exponential backoff'),
+});
+/**
+ * Task Schema
+ * Represents a background task to be executed
+ *
+ * @example
+ * {
+ *   "id": "task-abc123",
+ *   "type": "send_email",
+ *   "payload": { "to": "user@example.com", "template": "welcome" },
+ *   "queue": "notifications",
+ *   "priority": "high",
+ *   "retryPolicy": {
+ *     "maxRetries": 3,
+ *     "backoffStrategy": "exponential"
+ *   }
+ * }
+ */
+exports.TaskSchema = zod_1.z.object({
+    /**
+     * Unique task identifier
+     */
+    id: zod_1.z.string().describe('Unique task identifier'),
+    /**
+     * Task type (handler identifier)
+     */
+    type: zod_1.z.string().regex(/^[a-z_][a-z0-9_]*$/).describe('Task type (snake_case)'),
+    /**
+     * Task payload data
+     */
+    payload: zod_1.z.any().describe('Task payload data'),
+    /**
+     * Queue name
+     */
+    queue: zod_1.z.string().default('default').describe('Queue name'),
+    /**
+     * Task priority
+     */
+    priority: exports.TaskPriority.default('normal').describe('Task priority level'),
+    /**
+     * Retry policy
+     */
+    retryPolicy: exports.TaskRetryPolicySchema.optional().describe('Retry policy configuration'),
+    /**
+     * Execution timeout in milliseconds
+     */
+    timeoutMs: zod_1.z.number().int().positive().optional().describe('Task timeout in milliseconds'),
+    /**
+     * Scheduled execution time
+     */
+    scheduledAt: zod_1.z.string().datetime().optional().describe('ISO 8601 datetime to execute task'),
+    /**
+     * Maximum execution attempts
+     */
+    attempts: zod_1.z.number().int().min(0).default(0).describe('Number of execution attempts'),
+    /**
+     * Task status
+     */
+    status: exports.TaskStatus.default('pending').describe('Current task status'),
+    /**
+     * Task metadata
+     */
+    metadata: zod_1.z.object({
+        createdAt: zod_1.z.string().datetime().optional().describe('When task was created'),
+        updatedAt: zod_1.z.string().datetime().optional().describe('Last update time'),
+        createdBy: zod_1.z.string().optional().describe('User who created task'),
+        tags: zod_1.z.array(zod_1.z.string()).optional().describe('Task tags for filtering'),
+    }).optional().describe('Task metadata'),
+});
+// ==========================================
+// Task Execution Result
+// ==========================================
+/**
+ * Task Execution Result Schema
+ * Result of a task execution attempt
+ */
+exports.TaskExecutionResultSchema = zod_1.z.object({
+    /**
+     * Task identifier
+     */
+    taskId: zod_1.z.string().describe('Task identifier'),
+    /**
+     * Execution status
+     */
+    status: exports.TaskStatus.describe('Execution status'),
+    /**
+     * Execution result data
+     */
+    result: zod_1.z.any().optional().describe('Execution result data'),
+    /**
+     * Error information
+     */
+    error: zod_1.z.object({
+        message: zod_1.z.string().describe('Error message'),
+        stack: zod_1.z.string().optional().describe('Error stack trace'),
+        code: zod_1.z.string().optional().describe('Error code'),
+    }).optional().describe('Error details if failed'),
+    /**
+     * Execution duration
+     */
+    durationMs: zod_1.z.number().int().optional().describe('Execution duration in milliseconds'),
+    /**
+     * Execution timestamps
+     */
+    startedAt: zod_1.z.string().datetime().describe('When execution started'),
+    completedAt: zod_1.z.string().datetime().optional().describe('When execution completed'),
+    /**
+     * Retry information
+     */
+    attempt: zod_1.z.number().int().min(1).describe('Attempt number (1-indexed)'),
+    willRetry: zod_1.z.boolean().describe('Whether task will be retried'),
+});
+// ==========================================
+// Queue Configuration
+// ==========================================
+/**
+ * Queue Configuration Schema
+ * Configuration for a task queue
+ *
+ * @example
+ * {
+ *   "name": "notifications",
+ *   "concurrency": 10,
+ *   "rateLimit": {
+ *     "max": 100,
+ *     "duration": 60000
+ *   }
+ * }
+ */
+exports.QueueConfigSchema = zod_1.z.object({
+    /**
+     * Queue name
+     */
+    name: zod_1.z.string().describe('Queue name (snake_case)'),
+    /**
+     * Maximum concurrent workers
+     */
+    concurrency: zod_1.z.number().int().min(1).default(5).describe('Max concurrent task executions'),
+    /**
+     * Rate limiting
+     */
+    rateLimit: zod_1.z.object({
+        max: zod_1.z.number().int().positive().describe('Maximum tasks per duration'),
+        duration: zod_1.z.number().int().positive().describe('Duration in milliseconds'),
+    }).optional().describe('Rate limit configuration'),
+    /**
+     * Default retry policy
+     */
+    defaultRetryPolicy: exports.TaskRetryPolicySchema.optional().describe('Default retry policy for tasks'),
+    /**
+     * Dead letter queue
+     */
+    deadLetterQueue: zod_1.z.string().optional().describe('Dead letter queue name'),
+    /**
+     * Queue priority
+     */
+    priority: zod_1.z.number().int().min(0).default(0).describe('Queue priority (lower = higher priority)'),
+    /**
+     * Auto-scaling configuration
+     */
+    autoScale: zod_1.z.object({
+        enabled: zod_1.z.boolean().default(false).describe('Enable auto-scaling'),
+        minWorkers: zod_1.z.number().int().min(1).default(1).describe('Minimum workers'),
+        maxWorkers: zod_1.z.number().int().min(1).default(10).describe('Maximum workers'),
+        scaleUpThreshold: zod_1.z.number().int().positive().default(100).describe('Queue size to scale up'),
+        scaleDownThreshold: zod_1.z.number().int().min(0).default(10).describe('Queue size to scale down'),
+    }).optional().describe('Auto-scaling configuration'),
+});
+// ==========================================
+// Batch Processing
+// ==========================================
+/**
+ * Batch Task Schema
+ * Configuration for batch processing multiple items
+ *
+ * @example
+ * {
+ *   "id": "batch-import-123",
+ *   "type": "import_records",
+ *   "items": [{ "name": "Item 1" }, { "name": "Item 2" }],
+ *   "batchSize": 100,
+ *   "queue": "batch_processing"
+ * }
+ */
+exports.BatchTaskSchema = zod_1.z.object({
+    /**
+     * Batch job identifier
+     */
+    id: zod_1.z.string().describe('Unique batch job identifier'),
+    /**
+     * Task type for processing each item
+     */
+    type: zod_1.z.string().regex(/^[a-z_][a-z0-9_]*$/).describe('Task type (snake_case)'),
+    /**
+     * Items to process
+     */
+    items: zod_1.z.array(zod_1.z.any()).describe('Array of items to process'),
+    /**
+     * Batch size (items per task)
+     */
+    batchSize: zod_1.z.number().int().min(1).default(100).describe('Number of items per batch'),
+    /**
+     * Queue name
+     */
+    queue: zod_1.z.string().default('batch').describe('Queue for batch tasks'),
+    /**
+     * Priority
+     */
+    priority: exports.TaskPriority.default('normal').describe('Batch task priority'),
+    /**
+     * Parallel processing
+     */
+    parallel: zod_1.z.boolean().default(true).describe('Process batches in parallel'),
+    /**
+     * Stop on error
+     */
+    stopOnError: zod_1.z.boolean().default(false).describe('Stop batch if any item fails'),
+    /**
+     * Progress callback
+     *
+     * Called after each batch completes to report progress.
+     * Invoked asynchronously and should not throw errors.
+     * If the callback throws, the error is logged but batch processing continues.
+     *
+     * @param progress - Object containing processed count, total count, and failed count
+     */
+    onProgress: zod_1.z.function()
+        .args(zod_1.z.object({
+        processed: zod_1.z.number(),
+        total: zod_1.z.number(),
+        failed: zod_1.z.number(),
+    }))
+        .returns(zod_1.z.void())
+        .optional()
+        .describe('Progress callback function (called after each batch)'),
+});
+/**
+ * Batch Progress Schema
+ * Tracks progress of a batch job
+ */
+exports.BatchProgressSchema = zod_1.z.object({
+    /**
+     * Batch job identifier
+     */
+    batchId: zod_1.z.string().describe('Batch job identifier'),
+    /**
+     * Total items
+     */
+    total: zod_1.z.number().int().min(0).describe('Total number of items'),
+    /**
+     * Processed items
+     */
+    processed: zod_1.z.number().int().min(0).default(0).describe('Items processed'),
+    /**
+     * Successful items
+     */
+    succeeded: zod_1.z.number().int().min(0).default(0).describe('Items succeeded'),
+    /**
+     * Failed items
+     */
+    failed: zod_1.z.number().int().min(0).default(0).describe('Items failed'),
+    /**
+     * Progress percentage
+     */
+    percentage: zod_1.z.number().min(0).max(100).describe('Progress percentage'),
+    /**
+     * Status
+     */
+    status: zod_1.z.enum(['pending', 'running', 'completed', 'failed', 'cancelled']).describe('Batch status'),
+    /**
+     * Timestamps
+     */
+    startedAt: zod_1.z.string().datetime().optional().describe('When batch started'),
+    completedAt: zod_1.z.string().datetime().optional().describe('When batch completed'),
+});
+// ==========================================
+// Worker Configuration
+// ==========================================
+/**
+ * Worker Configuration Schema
+ * Configuration for a worker instance
+ */
+exports.WorkerConfigSchema = zod_1.z.object({
+    /**
+     * Worker name
+     */
+    name: zod_1.z.string().describe('Worker name'),
+    /**
+     * Queues to process
+     */
+    queues: zod_1.z.array(zod_1.z.string()).min(1).describe('Queue names to process'),
+    /**
+     * Queue configurations
+     */
+    queueConfigs: zod_1.z.array(exports.QueueConfigSchema).optional().describe('Queue configurations'),
+    /**
+     * Polling interval
+     */
+    pollIntervalMs: zod_1.z.number().int().positive().default(1000).describe('Queue polling interval in milliseconds'),
+    /**
+     * Visibility timeout
+     */
+    visibilityTimeoutMs: zod_1.z.number().int().positive().default(30000)
+        .describe('How long a task is invisible after being claimed'),
+    /**
+     * Task timeout
+     */
+    defaultTimeoutMs: zod_1.z.number().int().positive().default(300000).describe('Default task timeout in milliseconds'),
+    /**
+     * Graceful shutdown timeout
+     */
+    shutdownTimeoutMs: zod_1.z.number().int().positive().default(30000)
+        .describe('Graceful shutdown timeout in milliseconds'),
+    /**
+     * Task handlers
+     */
+    handlers: zod_1.z.record(zod_1.z.string(), zod_1.z.function()).optional().describe('Task type handlers'),
+});
+// ==========================================
+// Worker Stats
+// ==========================================
+/**
+ * Worker Stats Schema
+ * Runtime statistics for a worker
+ */
+exports.WorkerStatsSchema = zod_1.z.object({
+    /**
+     * Worker name
+     */
+    workerName: zod_1.z.string().describe('Worker name'),
+    /**
+     * Total tasks processed
+     */
+    totalProcessed: zod_1.z.number().int().min(0).describe('Total tasks processed'),
+    /**
+     * Successful tasks
+     */
+    succeeded: zod_1.z.number().int().min(0).describe('Successful tasks'),
+    /**
+     * Failed tasks
+     */
+    failed: zod_1.z.number().int().min(0).describe('Failed tasks'),
+    /**
+     * Active tasks
+     */
+    active: zod_1.z.number().int().min(0).describe('Currently active tasks'),
+    /**
+     * Average execution time
+     */
+    avgExecutionMs: zod_1.z.number().min(0).optional().describe('Average execution time in milliseconds'),
+    /**
+     * Uptime
+     */
+    uptimeMs: zod_1.z.number().int().min(0).describe('Worker uptime in milliseconds'),
+    /**
+     * Queue stats
+     */
+    queues: zod_1.z.record(zod_1.z.string(), zod_1.z.object({
+        pending: zod_1.z.number().int().min(0).describe('Pending tasks'),
+        active: zod_1.z.number().int().min(0).describe('Active tasks'),
+        completed: zod_1.z.number().int().min(0).describe('Completed tasks'),
+        failed: zod_1.z.number().int().min(0).describe('Failed tasks'),
+    })).optional().describe('Per-queue statistics'),
+});
+// ==========================================
+// Helper Functions
+// ==========================================
+/**
+ * Helper to create a task
+ */
+exports.Task = Object.assign(exports.TaskSchema, {
+    create: (task) => task,
+});
+/**
+ * Helper to create a queue config
+ */
+exports.QueueConfig = Object.assign(exports.QueueConfigSchema, {
+    create: (config) => config,
+});
+/**
+ * Helper to create a worker config
+ */
+exports.WorkerConfig = Object.assign(exports.WorkerConfigSchema, {
+    create: (config) => config,
+});
+/**
+ * Helper to create a batch task
+ */
+exports.BatchTask = Object.assign(exports.BatchTaskSchema, {
+    create: (batch) => batch,
+});

package/json-schema/api/BatchConfig.json

@@ -0,0 +1,51 @@
+{
+  "$ref": "#/definitions/BatchConfig",
+  "definitions": {
+    "BatchConfig": {
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "Enable batch operations"
+        },
+        "maxRecordsPerBatch": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 1000,
+          "default": 200,
+          "description": "Maximum records per batch"
+        },
+        "defaultOptions": {
+          "type": "object",
+          "properties": {
+            "atomic": {
+              "type": "boolean",
+              "default": true,
+              "description": "If true, rollback entire batch on any failure (transaction mode)"
+            },
+            "returnRecords": {
+              "type": "boolean",
+              "default": false,
+              "description": "If true, return full record data in response"
+            },
+            "continueOnError": {
+              "type": "boolean",
+              "default": false,
+              "description": "If true (and atomic=false), continue processing remaining records after errors"
+            },
+            "validateOnly": {
+              "type": "boolean",
+              "default": false,
+              "description": "If true, validate records without persisting changes (dry-run mode)"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Default batch options"
+        }
+      },
+      "additionalProperties": true
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/api/ODataConfig.json

@@ -0,0 +1,132 @@
+{
+  "$ref": "#/definitions/ODataConfig",
+  "definitions": {
+    "ODataConfig": {
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "Enable OData API"
+        },
+        "path": {
+          "type": "string",
+          "default": "/odata",
+          "description": "OData endpoint path"
+        },
+        "metadata": {
+          "type": "object",
+          "properties": {
+            "namespace": {
+              "type": "string",
+              "description": "Service namespace"
+            },
+            "entityTypes": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string",
+                    "description": "Entity type name"
+                  },
+                  "key": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    },
+                    "description": "Key fields"
+                  },
+                  "properties": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "name": {
+                          "type": "string"
+                        },
+                        "type": {
+                          "type": "string",
+                          "description": "OData type (Edm.String, Edm.Int32, etc.)"
+                        },
+                        "nullable": {
+                          "type": "boolean",
+                          "default": true
+                        }
+                      },
+                      "required": [
+                        "name",
+                        "type"
+                      ],
+                      "additionalProperties": false
+                    }
+                  },
+                  "navigationProperties": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "name": {
+                          "type": "string"
+                        },
+                        "type": {
+                          "type": "string"
+                        },
+                        "partner": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "name",
+                        "type"
+                      ],
+                      "additionalProperties": false
+                    }
+                  }
+                },
+                "required": [
+                  "name",
+                  "key",
+                  "properties"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Entity types"
+            },
+            "entitySets": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string",
+                    "description": "Entity set name"
+                  },
+                  "entityType": {
+                    "type": "string",
+                    "description": "Entity type"
+                  }
+                },
+                "required": [
+                  "name",
+                  "entityType"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Entity sets"
+            }
+          },
+          "required": [
+            "namespace",
+            "entityTypes",
+            "entitySets"
+          ],
+          "additionalProperties": false,
+          "description": "OData metadata configuration"
+        }
+      },
+      "additionalProperties": true
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}