@orbytautomation/engine 0.2.3 → 0.3.0

package/README.md

@@ -621,7 +621,7 @@ steps:
 
 ## Related Packages
 
-- **[@orbytautomation/cli](https://www.npmjs.com/package/@orbytautomation/cli)** — Command-line interface for Orbyt
+- **[@orbytautomation/cli](https://www.npmjs.com/package/@orbytautomation/cli)** — Command-line interface for Orbyt (Coming Soon...)
 - **[@dev-ecosystem/core](https://www.npmjs.com/package/@dev-ecosystem/core)** — Shared types and utilities
 
 ---

package/dist/core/EngineLogger.d.ts

@@ -8,13 +8,26 @@
  * - Severity-based log level filtering using LogLevelSeverity
  * - Multiple output formats (pretty, text, json, structured)
  * - Color support with ANSI codes
+ * - Engine-generated timestamps (consistent across CLI, API, web dashboards)
  * - Context and error tracking
  * - Performance measurement with automatic severity adjustment
  * - Efficient level comparison using numeric severity
  *
+ * Timestamps are generated by the engine to ensure consistency across:
+ * - CLI output
+ * - API responses
+ * - Web dashboard logs
+ * - Monitoring systems
+ * - Audit trails
+ *
  * @module core
  */
-import { LogLevel } from '@dev-ecosystem/core';
+import { LogLevel, formatTimestamp } from '@dev-ecosystem/core';
+/**
+ * Re-export formatTimestamp for external use
+ * Allows other parts of the system to format timestamps consistently
+ */
+export { formatTimestamp };
 /**
  * Engine-specific log format type
  */
@@ -119,7 +132,26 @@ export declare class EngineLogger {
      */
     setFormat(format: EngineLogFormat): void;
     /**
-     * Check if a level will be logged
+     * Update timestamp setting
+     */
+    setTimestamp(enabled: boolean): void;
+    /**
+     * Update timestamp format
+     *
+     * @param _format - 'time' | 'datetime' | 'full' (reserved for future use)
+     */
+    setTimestampFormat(_format: 'time' | 'datetime' | 'full'): void;
+    /**
+     * Format a timestamp using engine's timestamp formatter
+     * Useful for consistent timestamp formatting across the system
+     *
+     * @param date - Date to format (defaults to current time)
+     * @param format - Format type ('time', 'datetime', or 'full')
+     * @returns Formatted timestamp string
+     */
+    formatTimestamp(date?: Date, format?: 'time' | 'datetime' | 'full'): string;
+    /**
+     * Check if a level will be logged (uses shouldLog from ecosystem-core)
      */
     willLog(level: LogLevel): boolean;
     /**

package/dist/core/EngineLogger.d.ts.map

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

package/dist/core/EngineLogger.js

@@ -8,13 +8,26 @@
  * - Severity-based log level filtering using LogLevelSeverity
  * - Multiple output formats (pretty, text, json, structured)
  * - Color support with ANSI codes
+ * - Engine-generated timestamps (consistent across CLI, API, web dashboards)
  * - Context and error tracking
  * - Performance measurement with automatic severity adjustment
  * - Efficient level comparison using numeric severity
  *
+ * Timestamps are generated by the engine to ensure consistency across:
+ * - CLI output
+ * - API responses
+ * - Web dashboard logs
+ * - Monitoring systems
+ * - Audit trails
+ *
  * @module core
  */
-import { LogLevel, LogLevelSeverity, formatLog, createLogEntry, shouldLog, } from '@dev-ecosystem/core';
+import { LogLevel, LogLevelSeverity, formatLog, createLogEntry, shouldLog, formatTimestamp, } from '@dev-ecosystem/core';
+/**
+ * Re-export formatTimestamp for external use
+ * Allows other parts of the system to format timestamps consistently
+ */
+export { formatTimestamp };
 /**
  * Engine Logger
  *
@@ -189,7 +202,34 @@ export class EngineLogger {
         this.formatOptions.format = format;
     }
     /**
-     * Check if a level will be logged
+     * Update timestamp setting
+     */
+    setTimestamp(enabled) {
+        this.config.timestamp = enabled;
+        this.formatOptions.timestamp = enabled;
+    }
+    /**
+     * Update timestamp format
+     *
+     * @param _format - 'time' | 'datetime' | 'full' (reserved for future use)
+     */
+    setTimestampFormat(_format) {
+        // Timestamp format is handled by ecosystem-core formatTimestamp function
+        // This method is kept for API compatibility but doesn't modify formatOptions
+    }
+    /**
+     * Format a timestamp using engine's timestamp formatter
+     * Useful for consistent timestamp formatting across the system
+     *
+     * @param date - Date to format (defaults to current time)
+     * @param format - Format type ('time', 'datetime', or 'full')
+     * @returns Formatted timestamp string
+     */
+    formatTimestamp(date, format = 'time') {
+        return formatTimestamp(date || new Date(), format);
+    }
+    /**
+     * Check if a level will be logged (uses shouldLog from ecosystem-core)
      */
     willLog(level) {
         return shouldLog(level, this.config.level);
@@ -239,13 +279,14 @@ export function createEngineLogger(logLevel, verbose = false) {
         info: LogLevel.INFO,
         warn: LogLevel.WARN,
         error: LogLevel.ERROR,
+        fatal: LogLevel.FATAL,
     };
     const level = levelMap[logLevel] || LogLevel.INFO;
     return new EngineLogger({
         level,
         format: verbose ? 'pretty' : 'text',
         colors: true,
-        timestamp: false, // Engine adds its own prefix
+        timestamp: true, // Enable human-readable timestamps
         source: 'Orbyt',
     });
 }

package/dist/core/EngineLogger.js.map

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

package/dist/errors/ErrorCodes.d.ts

@@ -1,17 +1,43 @@
 /**
  * Orbyt Error Codes
  *
- * Stable error codes for reliable error handling and documentation.
+ * Structured error codes for the Orbyt workflow execution engine.
+ * These codes are separate from ecosystem exit codes (process-level).
+ *
+ * ARCHITECTURE:
+ * ============
+ * - Error Codes (ORB-XX-NNN): Structured diagnostic codes for detailed error identification
+ * - Exit Codes (100-509): Process-level codes from @dev-ecosystem/core for shell scripts
+ *
+ * TWO-LAYER SYSTEM:
+ * ================
+ * 1. Exit Codes (@dev-ecosystem/core): Process termination codes for the whole ecosystem
+ *    - Used by CLI, API, SDK to determine process exit status
+ *    - Example: ExitCodes.INVALID_SCHEMA (103) for schema validation failures
+ *
+ * 2. Error Codes (This file): Detailed diagnostic codes specific to Orbyt
+ *    - Used internally by engine for precise error identification
+ *    - Maps to exit codes for process termination
+ *    - Example: ORB-S-001 (unknown field) → ExitCodes.INVALID_SCHEMA
+ *
  * Format: ORB-[Category]-[Number]
  *
  * Categories:
- * - S: Schema/Structure errors
- * - V: Validation/Logic errors
- * - E: Execution errors
- * - R: Runtime errors
+ * - S: Schema/Structure errors (YAML syntax, field validation)
+ * - V: Validation/Logic errors (duplicate IDs, circular deps)
+ * - E: Execution errors (step failures, timeouts)
+ * - R: Runtime errors (file not found, permissions)
+ *
+ * ADDING NEW ERRORS:
+ * =================
+ * 1. Add error code enum value below
+ * 2. Add description in getErrorDescription()
+ * 3. Add exit code mapping in getExitCodeForError()
+ * 4. Add to appropriate error class (WorkflowError, StepError, etc.)
  *
  * @module errors
  */
+import { ExitCodes } from '@dev-ecosystem/core';
 export declare enum OrbytErrorCode {
     /** Unknown field in workflow definition */
     SCHEMA_UNKNOWN_FIELD = "ORB-S-001",
@@ -25,6 +51,8 @@ export declare enum OrbytErrorCode {
     SCHEMA_PARSE_ERROR = "ORB-S-005",
     /** Invalid field format/pattern */
     SCHEMA_INVALID_FORMAT = "ORB-S-006",
+    /** Reserved field detected (security) */
+    SCHEMA_RESERVED_FIELD = "ORB-S-007",
     /** Duplicate step ID */
     VALIDATION_DUPLICATE_ID = "ORB-V-001",
     /** Reference to non-existent step */
@@ -41,6 +69,10 @@ export declare enum OrbytErrorCode {
     VALIDATION_MISSING_INPUT = "ORB-V-007",
     /** Invalid adapter/action */
     VALIDATION_UNKNOWN_ADAPTER = "ORB-V-008",
+    /** Workflow has no steps */
+    VALIDATION_EMPTY_WORKFLOW = "ORB-V-009",
+    /** Invalid condition expression syntax */
+    VALIDATION_INVALID_CONDITION = "ORB-V-010",
     /** Step execution failed */
     EXECUTION_STEP_FAILED = "ORB-E-001",
     /** Timeout exceeded */
@@ -49,23 +81,190 @@ export declare enum OrbytErrorCode {
     EXECUTION_ADAPTER_ERROR = "ORB-E-003",
     /** Workflow cancelled */
     EXECUTION_CANCELLED = "ORB-E-004",
+    /** Step dependency failed */
+    EXECUTION_DEPENDENCY_FAILED = "ORB-E-005",
+    /** Conditional check failed */
+    EXECUTION_CONDITION_FAILED = "ORB-E-006",
     /** File not found */
     RUNTIME_FILE_NOT_FOUND = "ORB-R-001",
     /** Permission denied */
     RUNTIME_PERMISSION_DENIED = "ORB-R-002",
     /** Internal engine error */
-    RUNTIME_INTERNAL_ERROR = "ORB-R-003"
+    RUNTIME_INTERNAL_ERROR = "ORB-R-003",
+    /** Adapter not registered */
+    RUNTIME_ADAPTER_NOT_FOUND = "ORB-R-004",
+    /** Resource exhausted */
+    RUNTIME_RESOURCE_EXHAUSTED = "ORB-R-005"
 }
 /**
  * Error severity levels
+ * Used for prioritizing and determining execution control
+ *
+ * EXECUTION CONTROL BEHAVIOR:
+ * - CRITICAL/FATAL: Stop entire workflow execution immediately
+ * - ERROR/HIGH: Stop entire workflow execution (default for errors)
+ * - MEDIUM: Stop current step, attempt to continue to next step
+ * - LOW: Log warning and continue current step
+ * - WARNING: Log warning message, continue execution
+ * - INFO: Log informational message, continue execution
  */
 export declare enum ErrorSeverity {
+    /** Critical error - stop entire workflow immediately (unrecoverable) */
+    CRITICAL = "critical",
+    /** Fatal error - stop entire workflow (severe failure) */
+    FATAL = "fatal",
+    /** High severity error - stop entire workflow */
     ERROR = "error",
+    /** Medium severity - stop current step, try to continue workflow */
+    MEDIUM = "medium",
+    /** Low severity - log and continue current step */
+    LOW = "low",
+    /** Warning - log warning message, continue execution */
     WARNING = "warning",
+    /** Informational message */
     INFO = "info"
 }
 /**
  * Get human-readable category name from error code
+ *
+ * @param code - Orbyt error code
+ * @returns Category name (e.g., "Schema Error")
+ *
+ * @example
+ * ```typescript
+ * const category = getErrorCategory(OrbytErrorCode.SCHEMA_UNKNOWN_FIELD);
+ * // Returns: "Schema Error"
+ * ```
  */
 export declare function getErrorCategory(code: OrbytErrorCode): string;
+/**
+ * Get detailed description for an error code
+ * Helps users understand what went wrong
+ *
+ * @param code - Orbyt error code
+ * @returns Human-readable description
+ *
+ * @example
+ * ```typescript
+ * const desc = getErrorDescription(OrbytErrorCode.SCHEMA_UNKNOWN_FIELD);
+ * // Returns: "Workflow contains an unknown or misspelled field name"
+ * ```
+ */
+export declare function getErrorDescription(code: OrbytErrorCode): string;
+/**
+ * Map Orbyt error code to ecosystem exit code
+ * Determines which process exit code should be used
+ *
+ * @param code - Orbyt error code
+ * @returns Exit code from @dev-ecosystem/core
+ *
+ * @example
+ * ```typescript
+ * const exitCode = getExitCodeForError(OrbytErrorCode.SCHEMA_UNKNOWN_FIELD);
+ * // Returns: ExitCodes.INVALID_SCHEMA (103)
+ * ```
+ */
+export declare function getExitCodeForError(code: OrbytErrorCode): ExitCodes;
+/**
+ * Check if an error code represents a user error (fixable by changing workflow)
+ * vs system error (infrastructure, permissions, etc.)
+ *
+ * User errors are problems with the workflow definition that the user can fix.
+ * System errors are infrastructure/runtime issues outside user control.
+ *
+ * @param code - Orbyt error code
+ * @returns True if error is user-fixable
+ *
+ * @example
+ * ```typescript
+ * if (isUserError(error.code)) {
+ *   console.log('Fix your workflow definition');
+ * } else {
+ *   console.log('Contact system administrator');
+ * }
+ * ```
+ */
+export declare function isUserError(code: OrbytErrorCode): boolean;
+/**
+ * Check if an error code represents a retryable error
+ * Some errors (like timeouts, adapter failures) might succeed on retry.
+ * Others (like validation errors) will always fail.
+ *
+ * @param code - Orbyt error code
+ * @returns True if error might succeed on retry
+ *
+ * @example
+ * ```typescript
+ * if (isRetryable(error.code) && retryCount < maxRetries) {
+ *   console.log('Retrying...');
+ *   await retry();
+ * }
+ * ```
+ */
+export declare function isRetryable(code: OrbytErrorCode): boolean;
+/**
+ * Get suggested action for an error code
+ * Provides actionable guidance for users
+ *
+ * @param code - Orbyt error code
+ * @returns Suggested action to fix the error
+ *
+ * @example
+ * ```typescript
+ * const action = getSuggestedAction(OrbytErrorCode.SCHEMA_UNKNOWN_FIELD);
+ * console.log(action); // "Check field names against schema documentation"
+ * ```
+ */
+export declare function getSuggestedAction(code: OrbytErrorCode): string;
+/**
+ * Execution Control Actions
+ * Determines what action to take when error occurs
+ */
+export declare enum ExecutionControl {
+    /** Stop entire workflow execution immediately */
+    STOP_WORKFLOW = "STOP_WORKFLOW",
+    /** Stop current step, try to continue to next step */
+    STOP_STEP = "STOP_STEP",
+    /** Continue execution, just log the issue */
+    CONTINUE = "CONTINUE"
+}
+/**
+ * Get execution control action based on severity
+ * Determines whether to stop workflow, stop step, or continue
+ *
+ * @param severity - Error severity level
+ * @returns Execution control action
+ *
+ * @example
+ * ```typescript
+ * const action = getExecutionControl(ErrorSeverity.CRITICAL);
+ * // Returns: ExecutionControl.STOP_WORKFLOW
+ *
+ * const action2 = getExecutionControl(ErrorSeverity.MEDIUM);
+ * // Returns: ExecutionControl.STOP_STEP
+ * ```
+ */
+export declare function getExecutionControl(severity: ErrorSeverity): ExecutionControl;
+/**
+ * Check if severity should stop workflow execution
+ *
+ * @param severity - Error severity level
+ * @returns True if workflow should stop
+ */
+export declare function shouldStopWorkflow(severity: ErrorSeverity): boolean;
+/**
+ * Check if severity should stop step execution
+ *
+ * @param severity - Error severity level
+ * @returns True if step should stop
+ */
+export declare function shouldStopStep(severity: ErrorSeverity): boolean;
+/**
+ * Get severity level from error code
+ * Auto-determines appropriate severity for error code
+ *
+ * @param code - Orbyt error code
+ * @returns Appropriate severity level
+ */
+export declare function getSeverityForErrorCode(code: OrbytErrorCode): ErrorSeverity;
 //# sourceMappingURL=ErrorCodes.d.ts.map

package/dist/errors/ErrorCodes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorCodes.d.ts","sourceRoot":"","sources":["../../src/errors/ErrorCodes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,oBAAY,cAAc;IAKxB,2CAA2C;IAC3C,oBAAoB,cAAc;IAElC,yBAAyB;IACzB,mBAAmB,cAAc;IAEjC,6BAA6B;IAC7B,oBAAoB,cAAc;IAElC,yBAAyB;IACzB,mBAAmB,cAAc;IAEjC,iCAAiC;IACjC,kBAAkB,cAAc;IAEhC,mCAAmC;IACnC,qBAAqB,cAAc;IAMnC,wBAAwB;IACxB,uBAAuB,cAAc;IAErC,qCAAqC;IACrC,uBAAuB,cAAc;IAErC,mCAAmC;IACnC,8BAA8B,cAAc;IAE5C,yBAAyB;IACzB,wBAAwB,cAAc;IAEtC,uCAAuC;IACvC,4BAA4B,cAAc;IAE1C,iCAAiC;IACjC,2BAA2B,cAAc;IAEzC,6BAA6B;IAC7B,wBAAwB,cAAc;IAEtC,6BAA6B;IAC7B,0BAA0B,cAAc;IAMxC,4BAA4B;IAC5B,qBAAqB,cAAc;IAEnC,uBAAuB;IACvB,iBAAiB,cAAc;IAE/B,oBAAoB;IACpB,uBAAuB,cAAc;IAErC,yBAAyB;IACzB,mBAAmB,cAAc;IAMjC,qBAAqB;IACrB,sBAAsB,cAAc;IAEpC,wBAAwB;IACxB,yBAAyB,cAAc;IAEvC,4BAA4B;IAC5B,sBAAsB,cAAc;CACrC;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,IAAI,SAAS;CACd;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAM7D"}
+{"version":3,"file":"ErrorCodes.d.ts","sourceRoot":"","sources":["../../src/errors/ErrorCodes.ts"],"names":[],"mappings":"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"}