@objectstack/spec 0.7.1 → 0.7.2

package/json-schema/system/WorkerConfig.json

@@ -0,0 +1,188 @@
+{
+  "$ref": "#/definitions/WorkerConfig",
+  "definitions": {
+    "WorkerConfig": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Worker name"
+        },
+        "queues": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "minItems": 1,
+          "description": "Queue names to process"
+        },
+        "queueConfigs": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "description": "Queue name (snake_case)"
+              },
+              "concurrency": {
+                "type": "integer",
+                "minimum": 1,
+                "default": 5,
+                "description": "Max concurrent task executions"
+              },
+              "rateLimit": {
+                "type": "object",
+                "properties": {
+                  "max": {
+                    "type": "integer",
+                    "exclusiveMinimum": 0,
+                    "description": "Maximum tasks per duration"
+                  },
+                  "duration": {
+                    "type": "integer",
+                    "exclusiveMinimum": 0,
+                    "description": "Duration in milliseconds"
+                  }
+                },
+                "required": [
+                  "max",
+                  "duration"
+                ],
+                "additionalProperties": false,
+                "description": "Rate limit configuration"
+              },
+              "defaultRetryPolicy": {
+                "type": "object",
+                "properties": {
+                  "maxRetries": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "default": 3,
+                    "description": "Maximum retry attempts"
+                  },
+                  "backoffStrategy": {
+                    "type": "string",
+                    "enum": [
+                      "fixed",
+                      "linear",
+                      "exponential"
+                    ],
+                    "default": "exponential",
+                    "description": "Backoff strategy between retries"
+                  },
+                  "initialDelayMs": {
+                    "type": "integer",
+                    "exclusiveMinimum": 0,
+                    "default": 1000,
+                    "description": "Initial retry delay in milliseconds"
+                  },
+                  "maxDelayMs": {
+                    "type": "integer",
+                    "exclusiveMinimum": 0,
+                    "default": 60000,
+                    "description": "Maximum retry delay in milliseconds"
+                  },
+                  "backoffMultiplier": {
+                    "type": "number",
+                    "exclusiveMinimum": 0,
+                    "default": 2,
+                    "description": "Multiplier for exponential backoff"
+                  }
+                },
+                "additionalProperties": false,
+                "description": "Default retry policy for tasks"
+              },
+              "deadLetterQueue": {
+                "type": "string",
+                "description": "Dead letter queue name"
+              },
+              "priority": {
+                "type": "integer",
+                "minimum": 0,
+                "default": 0,
+                "description": "Queue priority (lower = higher priority)"
+              },
+              "autoScale": {
+                "type": "object",
+                "properties": {
+                  "enabled": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "Enable auto-scaling"
+                  },
+                  "minWorkers": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "default": 1,
+                    "description": "Minimum workers"
+                  },
+                  "maxWorkers": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "default": 10,
+                    "description": "Maximum workers"
+                  },
+                  "scaleUpThreshold": {
+                    "type": "integer",
+                    "exclusiveMinimum": 0,
+                    "default": 100,
+                    "description": "Queue size to scale up"
+                  },
+                  "scaleDownThreshold": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "default": 10,
+                    "description": "Queue size to scale down"
+                  }
+                },
+                "additionalProperties": false,
+                "description": "Auto-scaling configuration"
+              }
+            },
+            "required": [
+              "name"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Queue configurations"
+        },
+        "pollIntervalMs": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "default": 1000,
+          "description": "Queue polling interval in milliseconds"
+        },
+        "visibilityTimeoutMs": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "default": 30000,
+          "description": "How long a task is invisible after being claimed"
+        },
+        "defaultTimeoutMs": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "default": 300000,
+          "description": "Default task timeout in milliseconds"
+        },
+        "shutdownTimeoutMs": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "default": 30000,
+          "description": "Graceful shutdown timeout in milliseconds"
+        },
+        "handlers": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "Task type handlers"
+        }
+      },
+      "required": [
+        "name",
+        "queues"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/system/WorkerStats.json

@@ -0,0 +1,90 @@
+{
+  "$ref": "#/definitions/WorkerStats",
+  "definitions": {
+    "WorkerStats": {
+      "type": "object",
+      "properties": {
+        "workerName": {
+          "type": "string",
+          "description": "Worker name"
+        },
+        "totalProcessed": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Total tasks processed"
+        },
+        "succeeded": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Successful tasks"
+        },
+        "failed": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Failed tasks"
+        },
+        "active": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Currently active tasks"
+        },
+        "avgExecutionMs": {
+          "type": "number",
+          "minimum": 0,
+          "description": "Average execution time in milliseconds"
+        },
+        "uptimeMs": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Worker uptime in milliseconds"
+        },
+        "queues": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "pending": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Pending tasks"
+              },
+              "active": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Active tasks"
+              },
+              "completed": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Completed tasks"
+              },
+              "failed": {
+                "type": "integer",
+                "minimum": 0,
+                "description": "Failed tasks"
+              }
+            },
+            "required": [
+              "pending",
+              "active",
+              "completed",
+              "failed"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Per-queue statistics"
+        }
+      },
+      "required": [
+        "workerName",
+        "totalProcessed",
+        "succeeded",
+        "failed",
+        "active",
+        "uptimeMs"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectstack/spec",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "ObjectStack Protocol & Specification - TypeScript Interfaces, JSON Schemas, and Convention Configurations",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -52,6 +52,14 @@
     "./contracts": {
       "types": "./dist/contracts/index.d.ts",
       "default": "./dist/contracts/index.js"
+    },
+    "./integration": {
+      "types": "./dist/integration/index.d.ts",
+      "default": "./dist/integration/index.js"
+    },
+    "./permission": {
+      "types": "./dist/permission/index.d.ts",
+      "default": "./dist/permission/index.js"
     }
   },
   "files": [