@onlineapps/cookbook-core 2.0.0 → 2.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onlineapps/cookbook-core",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Core cookbook parsing and validation - lightweight foundation for workflow definitions",
   "main": "src/index.js",
   "scripts": {

package/schemas/cookbook.v2.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://onlineapps.com/schemas/cookbook/v2.0.0/cookbook.schema.json",
-  "title": "Cookbook Workflow Schema v2.0",
+  "$id": "https://onlineapps.com/schemas/cookbook/v2.1.0/cookbook.schema.json",
+  "title": "Cookbook Workflow Schema v2.1",
   "description": "Schema for defining workflow orchestration with snake_case convention",
   "type": "object",
   "required": ["version", "steps"],
@@ -36,6 +36,10 @@
         "$ref": "#/definitions/Step"
       },
       "description": "Array of workflow steps"
+    },
+    "delivery": {
+      "$ref": "#/definitions/DeliveryConfig",
+      "description": "Delivery strategy and destinations for workflow output"
     }
   },
   "definitions": {
@@ -514,6 +518,211 @@
           "additionalProperties": true
         }
       }
+    },
+    "DeliveryConfig": {
+      "type": "object",
+      "required": ["handler"],
+      "additionalProperties": false,
+      "properties": {
+        "handler": {
+          "enum": ["dispatcher", "service_step", "none"],
+          "description": "Delivery handler selection"
+        },
+        "allow_skip": {
+          "type": "boolean",
+          "default": false,
+          "description": "Allow dispatcher to skip delivery without failing workflow"
+        },
+        "delivery_step": {
+          "type": "string",
+          "pattern": "^[a-zA-Z0-9_]+$",
+          "description": "Step ID that performs delivery when handler=service_step"
+        },
+        "destinations": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DeliveryDestination"
+          },
+          "default": []
+        },
+        "output": {
+          "$ref": "#/definitions/DeliveryOutput"
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "handler": { "const": "dispatcher" }
+            }
+          },
+          "then": {
+            "required": ["destinations", "output"],
+            "properties": {
+              "destinations": {
+                "minItems": 1
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "handler": { "const": "service_step" }
+            }
+          },
+          "then": {
+            "required": ["delivery_step", "output"]
+          }
+        }
+      ]
+    },
+    "DeliveryDestination": {
+      "type": "object",
+      "required": ["type"],
+      "properties": {
+        "type": {
+          "enum": ["webhook", "websocket", "public_url"],
+          "description": "Delivery channel type"
+        },
+        "name": {
+          "type": "string",
+          "pattern": "^[a-zA-Z0-9._-]+$",
+          "description": "Optional identifier for monitoring"
+        },
+        "enabled": {
+          "type": "boolean",
+          "default": true
+        },
+        "retry": {
+          "$ref": "#/definitions/RetryConfig"
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "type": { "const": "webhook" }
+            }
+          },
+          "then": {
+            "$ref": "#/definitions/DeliveryWebhookOptions"
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "type": { "const": "websocket" }
+            }
+          },
+          "then": {
+            "$ref": "#/definitions/DeliveryWebsocketOptions"
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "type": { "const": "public_url" }
+            }
+          },
+          "then": {
+            "$ref": "#/definitions/DeliveryPublicUrlOptions"
+          }
+        }
+      ]
+    },
+    "DeliveryWebhookOptions": {
+      "type": "object",
+      "required": ["url", "method"],
+      "properties": {
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "Target webhook URL"
+        },
+        "method": {
+          "type": "string",
+          "enum": ["GET", "POST", "PUT", "PATCH", "DELETE"]
+        },
+        "headers": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "body_template": {
+          "type": ["object", "array"],
+          "description": "Optional custom payload template"
+        },
+        "timeout_ms": {
+          "type": "integer",
+          "minimum": 100,
+          "description": "Request timeout"
+        }
+      }
+    },
+    "DeliveryWebsocketOptions": {
+      "type": "object",
+      "properties": {
+        "client_id": {
+          "type": "string",
+          "description": "Client session identifier"
+        },
+        "tenant_id": {
+          "type": "string",
+          "description": "Tenant/topic identifier"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "anyOf": [
+        { "required": ["client_id"] },
+        { "required": ["tenant_id"] }
+      ]
+    },
+    "DeliveryPublicUrlOptions": {
+      "type": "object",
+      "required": ["path"],
+      "properties": {
+        "path": {
+          "type": "string",
+          "pattern": "^[a-zA-Z0-9._\\-/\\${}]+$",
+          "description": "Storage key / relative path"
+        },
+        "ttl_seconds": {
+          "type": "integer",
+          "minimum": 60,
+          "description": "Time to live for generated URL"
+        },
+        "access": {
+          "type": "string",
+          "enum": ["public", "signed"],
+          "default": "signed"
+        },
+        "max_downloads": {
+          "type": "integer",
+          "minimum": 1
+        }
+      }
+    },
+    "DeliveryOutput": {
+      "type": "object",
+      "propertyNames": {
+        "pattern": "^[a-zA-Z0-9_]+$"
+      },
+      "additionalProperties": {
+        "type": [
+          "string",
+          "number",
+          "boolean",
+          "object",
+          "array"
+        ]
+      }
     }
   }
 }

package/src/index.js

@@ -60,5 +60,5 @@ module.exports = {
 
   // Utility exports
   VERSION: '2.0.0',
-  SCHEMA_VERSION: '2.0.0'
+  SCHEMA_VERSION: '2.1.0'
 };

package/src/parser/cookbookValidatorV2.js

@@ -156,10 +156,11 @@ function checkMigration(cookbook, detectedVersion) {
         if ('timeoutMs' in step) {
           suggestions.push(`- Step ${idx}: Rename 'timeoutMs' to 'timeout_ms'`);
         }
-        if ('maxAttempts' in step.retry || {}) {
+        const retry = step.retry || {};
+        if ('maxAttempts' in retry) {
           suggestions.push(`- Step ${idx}: Rename 'retry.maxAttempts' to 'retry.max_attempts'`);
         }
-        if ('delayMs' in step.retry || {}) {
+        if ('delayMs' in retry) {
           suggestions.push(`- Step ${idx}: Rename 'retry.delayMs' to 'retry.delay_ms'`);
         }
       });