@dev-ecosystem/core 0.1.0 → 0.2.0

package/dist/types/{workflow.types.d.ts → workflow.interfaces.d.ts}

@@ -1,83 +1,19 @@
 /**
  * Orbyt Workflow Type Definitions
  *
- * Comprehensive TypeScript types for Orbyt workflows.
- * These types define the structure of workflow definitions across the ecosystem.
+ * Comprehensive TypeScript interfaces for Orbyt workflows.
+ * These interfaces define the structure of workflow definitions across the ecosystem.
  *
  * Key Principles:
  * - Domain-agnostic: works for any workflow type
  * - Explicit over implicit: no `any` unless truly dynamic
- * - Documented: every type has clear purpose
+ * - Documented: every interface has clear purpose
  * - Versioned: includes v1 and future-reserved fields
+ *
+ * Note: Enums are in workflow.enums.ts, type aliases are in workflow.type-aliases.ts
  */
-/**
- * Type of workflow executable
- */
-export declare enum WorkflowKind {
-    /** Standard workflow - default execution model */
-    Workflow = "workflow",
-    /** Pipeline - emphasizes data flow */
-    Pipeline = "pipeline",
-    /** Job - emphasizes scheduled/batch execution */
-    Job = "job",
-    /** Playbook - emphasizes operational procedures */
-    Playbook = "playbook",
-    /** Automation - emphasizes event-driven execution */
-    Automation = "automation"
-}
-/**
- * Trigger types for workflow execution
- */
-export declare enum TriggerType {
-    /** Manually invoked by user */
-    Manual = "manual",
-    /** Scheduled via cron expression */
-    Cron = "cron",
-    /** Event-driven execution */
-    Event = "event",
-    /** HTTP webhook trigger */
-    Webhook = "webhook"
-}
-/**
- * Failure handling policy
- */
-export declare enum FailurePolicy {
-    /** Stop entire workflow on first failure */
-    Stop = "stop",
-    /** Continue with remaining steps */
-    Continue = "continue",
-    /** Isolate failure to step only */
-    Isolate = "isolate"
-}
-/**
- * Retry backoff strategy
- */
-export declare enum BackoffStrategy {
-    /** Fixed delay between retries */
-    Linear = "linear",
-    /** Exponentially increasing delay */
-    Exponential = "exponential"
-}
-/**
- * Sandbox enforcement level
- */
-export declare enum SandboxLevel {
-    /** No sandboxing */
-    None = "none",
-    /** Basic permission checks */
-    Basic = "basic",
-    /** Strict isolation and permissions */
-    Strict = "strict"
-}
-/**
- * Execution environment
- */
-export declare enum ExecutionEnvironment {
-    Local = "local",
-    Dev = "dev",
-    Staging = "staging",
-    Prod = "prod"
-}
+import type { WorkflowKind, TriggerType, FailurePolicy, BackoffStrategy, SandboxLevel, ExecutionEnvironment, WorkflowSourceType, ExecutionMode, IsolationLevel, ExecutionPriority, TelemetryLevel, AccountingUnit, FailureAction, TimeoutAction, RollbackStrategy, UsageScope, UsageCategory, ProductIdentifier, CostHint, LogsLevel, MetricsLevel, StepFailureAction, StrategyType, TraceLevel } from './workflow.enums.js';
+import type { InputType, TimeoutSpec, StepOutputMapping, StepCondition, V1Field, FutureField, OutputsSchema, WorkflowTrigger, WorkflowInputs } from './workflow.type.js';
 /**
  * Workflow metadata for identification and organization.
  * Never used for execution logic.
@@ -99,6 +35,10 @@ export interface WorkflowMetadata {
     createdAt?: string;
     /** ISO 8601 last update timestamp */
     updatedAt?: string;
+    /** V1 field marker */
+    v1?: V1Field;
+    /** Future field marker */
+    future?: FutureField;
     /** Allow additional metadata fields */
     [key: string]: any;
 }
@@ -167,12 +107,6 @@ export interface WebhookTrigger extends BaseTrigger {
     /** Optional filtering conditions */
     filters?: Record<string, any>;
 }
-/**
- * Union of all trigger types
- *
- * @category Triggers
- */
-export type WorkflowTrigger = ManualTrigger | CronTrigger | EventTrigger | WebhookTrigger;
 /**
  * External secret references.
  * Values are NEVER stored inline - only references to secret providers.
@@ -187,12 +121,6 @@ export interface WorkflowSecrets {
     /** Map of logical names to provider-specific paths */
     keys: Record<string, string>;
 }
-/**
- * Input parameter data types
- *
- * @category Inputs
- */
-export type InputType = 'string' | 'number' | 'boolean' | 'array' | 'object';
 /**
  * Definition of a single input parameter
  *
@@ -208,12 +136,6 @@ export interface WorkflowInputDefinition {
     /** Human-readable description */
     description?: string;
 }
-/**
- * Runtime parameters for workflow reusability
- *
- * @category Inputs
- */
-export type WorkflowInputs = Record<string, WorkflowInputDefinition>;
 /**
  * Runtime environment context (read-only for steps)
  *
@@ -242,12 +164,6 @@ export interface WorkflowRetryConfig {
     /** Initial delay in milliseconds */
     delay?: number;
 }
-/**
- * Timeout specification (e.g., "30s", "5m", "1h")
- *
- * @category Execution
- */
-export type TimeoutSpec = string;
 /**
  * Default settings applied to all steps
  *
@@ -332,18 +248,43 @@ export interface WorkflowResources {
     [key: string]: any;
 }
 /**
- * Output mapping from step result to named outputs
- *
- * @category Steps
- */
-export type StepOutputMapping = Record<string, string>;
+ * Workflow-level usage tracking configuration
+ * Engine counts, bridges transport, website displays
+ *
+ * @category Usage
+ * @status production-ready - minimal, final
+ */
+export interface WorkflowUsage {
+    /** Enable usage tracking for this workflow */
+    track?: boolean;
+    /** Aggregation scope */
+    scope?: UsageScope | string;
+    /** Usage category for billing */
+    category?: UsageCategory | string;
+    /** Whether this workflow is billable */
+    billable?: boolean;
+    /** Product/component identifier */
+    product?: ProductIdentifier | string;
+    /** Tags for analytics */
+    tags?: string[];
+}
 /**
- * Conditional execution expression
- * Supports ${inputs.*}, ${secrets.*}, ${steps.*.outputs.*}, ${context.*}
- *
- * @category Steps
- */
-export type StepCondition = string;
+ * Step-level usage tracking override
+ * Allows per-step billing customization
+ *
+ * @category Usage
+ * @status production-ready - minimal, final
+ */
+export interface StepUsage {
+    /** Override workflow billable setting */
+    billable?: boolean;
+    /** Billing unit (e.g., 'request', 'execution', 'second') */
+    unit?: string;
+    /** Cost multiplier (default: 1) */
+    weight?: number;
+    /** Cost estimation hint for billing */
+    costHint?: CostHint;
+}
 /**
  * Individual workflow step definition
  *
@@ -393,6 +334,12 @@ export interface WorkflowStepDefinition {
     outputs?: StepOutputMapping;
     /** Environment variables for this step */
     env?: Record<string, string>;
+    /** Usage tracking override (future: per-step billing) */
+    usage?: StepUsage;
+    /** Output schema (future: validation) */
+    outputsSchema?: OutputsSchema;
+    /** Step-level rollback logic (future: compensation) */
+    rollback?: StepRollback;
 }
 /**
  * Core workflow execution definition
@@ -416,6 +363,172 @@ export interface WorkflowLifecycleHooks {
     /** Steps to always run (cleanup) */
     always?: any[];
 }
+/**
+ * Workflow source information
+ *
+ * @category Identity
+ * @status future
+ */
+export interface WorkflowSource {
+    /** Source type */
+    type: WorkflowSourceType;
+    /** Source reference (e.g., marketplace URL, file path) */
+    ref?: string;
+}
+/**
+ * Workflow identity and lineage tracking
+ *
+ * @category Identity
+ * @status future - reserved for traceability
+ */
+export interface WorkflowIdentity {
+    /** Unique workflow identifier */
+    workflowId?: string;
+    /** Parent workflow ID (if forked) */
+    parentWorkflow?: string;
+    /** Workflow source information */
+    source?: WorkflowSource;
+}
+/**
+ * Execution strategy and runtime configuration
+ *
+ * @category Execution
+ * @status future - reserved for multi-environment support
+ */
+export interface ExecutionStrategy {
+    /** Execution mode */
+    mode?: ExecutionMode;
+    /** Isolation level */
+    isolation?: IsolationLevel;
+    /** Execution priority */
+    priority?: ExecutionPriority;
+    /** Strategy type for execution */
+    strategyType?: StrategyType;
+}
+/**
+ * Schema definition for outputs
+ *
+ * @category Contracts
+ * @status future - reserved for compile-time validation
+ */
+export interface OutputSchema {
+    /** Data type */
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    /** Whether output is required */
+    required?: boolean;
+    /** Output description */
+    description?: string;
+}
+/**
+ * Telemetry and observability controls
+ *
+ * @category Observability
+ * @status future - reserved for privacy controls
+ */
+export interface TelemetryConfig {
+    /** Enable telemetry */
+    enabled?: boolean;
+    /** Telemetry level */
+    level?: TelemetryLevel;
+    /** Logs verbosity level */
+    logs?: LogsLevel;
+    /** Metrics collection level */
+    metrics?: MetricsLevel;
+    /** Trace collection level */
+    trace?: TraceLevel;
+    /** Fields to redact from logs */
+    redact?: string[];
+}
+/**
+ * Cost and usage accounting
+ *
+ * @category Accounting
+ * @status future - reserved for monetization
+ */
+export interface AccountingConfig {
+    /** Whether execution is billable */
+    billable?: boolean;
+    /** Billing unit */
+    unit?: AccountingUnit;
+    /** Custom tags for accounting */
+    tags?: Record<string, string>;
+}
+/**
+ * Engine version constraints
+ *
+ * @category Compatibility
+ * @status future - reserved for version management
+ */
+export interface EngineCompatibility {
+    /** Minimum engine version */
+    min?: string;
+    /** Maximum engine version */
+    max?: string;
+}
+/**
+ * Version compatibility and constraints
+ *
+ * @category Compatibility
+ * @status future - reserved for safe upgrades
+ */
+export interface CompatibilityConfig {
+    /** Engine version requirements */
+    engine?: EngineCompatibility;
+    /** Required adapter versions */
+    adapters?: Record<string, string>;
+}
+/**
+ * Advanced failure handling semantics
+ *
+ * @category Execution
+ * @status future - reserved for complex workflows
+ */
+export interface FailureSemantics {
+    /** Action on step failure */
+    onStepFailure?: FailureAction;
+    /** Step-specific failure action */
+    stepAction?: StepFailureAction;
+    /** Action on timeout */
+    onTimeout?: TimeoutAction;
+}
+/**
+ * Step-level rollback configuration
+ *
+ * @category Execution
+ * @status future - reserved for compensation logic
+ */
+export interface StepRollback {
+    /** Action for rollback */
+    uses: string;
+    /** Input parameters for rollback */
+    with?: Record<string, any>;
+}
+/**
+ * Workflow-level rollback configuration
+ *
+ * @category Execution
+ * @status future - reserved for transactional workflows
+ */
+export interface RollbackConfig {
+    /** Enable rollback */
+    enabled?: boolean;
+    /** Rollback strategy */
+    strategy?: RollbackStrategy;
+}
+/**
+ * Governance and team metadata
+ *
+ * @category Governance
+ * @status future - reserved for enterprise features
+ */
+export interface GovernanceConfig {
+    /** Required reviewers */
+    reviewers?: string[];
+    /** Whether approval is required before execution */
+    approvalRequired?: boolean;
+    /** Additional governance metadata */
+    [key: string]: any;
+}
 /**
  * Complete Orbyt workflow definition
  *
@@ -454,50 +567,27 @@ export interface WorkflowDefinition {
     outputs?: Record<string, string>;
     /** Lifecycle hooks (future) */
     on?: WorkflowLifecycleHooks;
+    /** Usage tracking configuration */
+    usage?: WorkflowUsage;
+    /** Workflow identity & lineage (future: traceability) */
+    identity?: WorkflowIdentity;
+    /** Execution strategy (future: multi-environment) */
+    execution?: ExecutionStrategy;
+    /** Output schema (future: validation) */
+    outputsSchema?: OutputsSchema;
+    /** Telemetry controls (future: privacy) */
+    telemetry?: TelemetryConfig;
+    /** Cost accounting (future: monetization) */
+    accounting?: AccountingConfig;
+    /** Version compatibility (future: safe upgrades) */
+    compatibility?: CompatibilityConfig;
+    /** Failure semantics (future: advanced error handling) */
+    failurePolicy?: FailureSemantics;
+    /** Rollback config (future: transactional workflows) */
+    rollback?: RollbackConfig;
+    /** Governance metadata (future: enterprise) */
+    governance?: GovernanceConfig;
 }
-/**
- * Variable reference pattern
- * Format: ${namespace.path.to.value}
- *
- * Namespaces:
- * - inputs.*
- * - secrets.*
- * - steps.*.outputs.*
- * - context.*
- * - env.*
- *
- * @category Variables
- */
-export type VariableReference = string;
-/**
- * Action reference pattern
- * Format: namespace.action or namespace.domain.action
- *
- * Examples:
- * - mediaproc.image.resize
- * - cli.exec
- * - http.request
- *
- * @category Actions
- */
-export type ActionReference = string;
-/**
- * Secret reference pattern
- * Format: provider:path
- *
- * Examples:
- * - vaulta:mediaproc/api/key
- * - aws-secrets:prod/db/password
- *
- * @category Secrets
- */
-export type SecretReference = string;
-/**
- * Marks fields that are implemented in v1
- */
-export type V1Field = unknown;
-/**
- * Marks fields that are reserved for future versions
- */
-export type FutureField = unknown;
-//# sourceMappingURL=workflow.types.d.ts.map
+export * from './workflow.enums.js';
+export * from './workflow.type.js';
+//# sourceMappingURL=workflow.interfaces.d.ts.map

package/dist/types/workflow.interfaces.d.ts.map

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

package/dist/types/workflow.interfaces.js

@@ -0,0 +1,19 @@
+/**
+ * Orbyt Workflow Type Definitions
+ *
+ * Comprehensive TypeScript interfaces for Orbyt workflows.
+ * These interfaces define the structure of workflow definitions across the ecosystem.
+ *
+ * Key Principles:
+ * - Domain-agnostic: works for any workflow type
+ * - Explicit over implicit: no `any` unless truly dynamic
+ * - Documented: every interface has clear purpose
+ * - Versioned: includes v1 and future-reserved fields
+ *
+ * Note: Enums are in workflow.enums.ts, type aliases are in workflow.type-aliases.ts
+ */
+// VariableReference, ActionReference, SecretReference are imported from workflow.type-aliases.ts
+// V1Field and FutureField markers are imported from workflow.type-aliases.ts
+export * from './workflow.enums.js';
+export * from './workflow.type.js';
+//# sourceMappingURL=workflow.interfaces.js.map

package/dist/types/workflow.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.interfaces.js","sourceRoot":"","sources":["../../src/types/workflow.interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAy2BH,iGAAiG;AACjG,6EAA6E;AAE7E,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/dist/types/workflow.type.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Simple type aliases for workflow schemas
+ * @module workflow.type-aliases
+ */
+import type { CronTrigger, EventTrigger, ManualTrigger, OutputSchema, WebhookTrigger, WorkflowInputDefinition } from "./workflow.interfaces";
+/**
+ * Scalar and complex input types for workflow variables
+ */
+export type InputType = 'string' | 'number' | 'boolean' | 'array' | 'object' | 'secret';
+/**
+ * Timeout specification - ISO 8601 duration or numeric seconds
+ */
+export type TimeoutSpec = string | number;
+/**
+ * Mapping of step outputs to workflow variables - key = target var, value = source path
+ */
+export type StepOutputMapping = Record<string, string>;
+/**
+ * Step execution condition - expression string
+ * Supports $inputs.*, $secrets.*, $steps.*.outputs.*, $context.*
+ */
+export type StepCondition = string;
+/**
+ * Runtime variable reference - used for ${variable} interpolation
+ * @example "${inputs.name}", "${context.workspace}"
+ */
+export type VariableReference = string;
+/**
+ * Reference to a step or action - used for step dependencies
+ * @example "build", "test", "deploy"
+ */
+export type ActionReference = string;
+/**
+ * Secret reference for secure data - used for ${secrets.*} interpolation
+ * @example "${secrets.apiKey}", "${secrets.dbPassword}"
+ */
+export type SecretReference = string;
+/**
+ * Marker for V1 fields - used for tracking schema evolution
+ */
+export type V1Field = true;
+/**
+ * Marker for future fields - reserved for upcoming features
+ */
+export type FutureField = true;
+/**
+ * Workflow version string
+ */
+export type WorkflowVersion = string;
+/**
+ * Retry policy identifier
+ */
+export type RetryPolicy = string;
+/**
+ * Caching strategy identifier
+ */
+export type CacheStrategy = string;
+/**
+ * Resource constraint specification
+ */
+export type ResourceConstraints = Record<string, any>;
+/**
+ * Environment variable definitions
+ */
+export type EnvironmentVariables = Record<string, string>;
+/**
+ * Metadata key-value pairs
+ */
+export type Metadata = Record<string, any>;
+/**
+ * Tags for categorization
+ */
+export type Tags = string[];
+/**
+ * Permission scope identifier
+ */
+export type PermissionScope = string;
+/**
+ * Audit log entry structure
+ */
+export type AuditLogEntry = Record<string, any>;
+/**
+ * Execution context data
+ */
+export type ExecutionContext = Record<string, any>;
+/**
+ * Step dependencies array
+ */
+export type StepDependencies = string[];
+/**
+ * Transformation function definition
+ */
+export type TransformFunction = string;
+/**
+ * Validation rule definition
+ */
+export type ValidationRule = Record<string, any>;
+/**
+ * Notification configuration
+ */
+export type NotificationConfig = Record<string, any>;
+/**
+ * Webhook payload structure
+ */
+export type WebhookPayload = Record<string, any>;
+/**
+ * Schedule configuration
+ */
+export type ScheduleConfig = Record<string, any>;
+/**
+ * Filter expression string
+ */
+export type FilterExpression = string;
+/**
+ * Aggregation configuration
+ */
+export type AggregationConfig = Record<string, any>;
+/**
+ * Parallel execution configuration
+ */
+export type ParallelConfig = Record<string, any>;
+/**
+ * Union of all trigger types (override type alias with proper definition)
+ *
+ * @category Triggers
+ */
+export type WorkflowTrigger = ManualTrigger | CronTrigger | EventTrigger | WebhookTrigger;
+/**
+ * Runtime parameters for workflow reusability (override type alias with proper definition)
+ *
+ * @category Inputs
+ */
+export type WorkflowInputs = Record<string, WorkflowInputDefinition>;
+/**
+ * Output schema mapping (override type alias with proper definition)
+ *
+ * @category Contracts
+ * @status future - reserved for type safety
+ */
+export type OutputsSchema = Record<string, OutputSchema>;
+//# sourceMappingURL=workflow.type.d.ts.map

package/dist/types/workflow.type.d.ts.map

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

package/dist/types/workflow.type.js

@@ -0,0 +1,6 @@
+/**
+ * Simple type aliases for workflow schemas
+ * @module workflow.type-aliases
+ */
+export {};
+//# sourceMappingURL=workflow.type.js.map

package/dist/types/workflow.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.type.js","sourceRoot":"","sources":["../../src/types/workflow.type.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/package.json

@@ -1,8 +1,16 @@
 {
   "name": "@dev-ecosystem/core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Core utilities and libraries for the Dev Ecosystem.",
   "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
   "scripts": {
     "build": "rm -rf dist && tsc",
     "clean": "rm -rf dist"
@@ -26,5 +34,8 @@
   "license": "MIT",
   "engines": {
     "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "zod": "^4.3.6"
   }
-}
+}