@dev-ecosystem/core 0.1.0

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

@@ -0,0 +1,503 @@
+/**
+ * Orbyt Workflow Type Definitions
+ *
+ * Comprehensive TypeScript types for Orbyt workflows.
+ * These types 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
+ * - Versioned: includes v1 and future-reserved fields
+ */
+/**
+ * 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"
+}
+/**
+ * Workflow metadata for identification and organization.
+ * Never used for execution logic.
+ *
+ * @category Metadata
+ */
+export interface WorkflowMetadata {
+    /** Human-readable workflow name */
+    name?: string;
+    /** Detailed description of workflow purpose */
+    description?: string;
+    /** Tags for categorization and search */
+    tags?: string[];
+    /** Team or individual owner */
+    owner?: string;
+    /** Version of this workflow (not schema version) */
+    version?: string;
+    /** ISO 8601 creation timestamp */
+    createdAt?: string;
+    /** ISO 8601 last update timestamp */
+    updatedAt?: string;
+    /** Allow additional metadata fields */
+    [key: string]: any;
+}
+/**
+ * Zero-runtime-impact annotations for AI, UI, and tooling.
+ *
+ * @category Metadata
+ */
+export interface WorkflowAnnotations {
+    /** Hint for AI about workflow intent */
+    'ai.intent'?: string;
+    /** UI grouping category */
+    'ui.group'?: string;
+    /** Icon identifier for visual representation */
+    'ui.icon'?: string;
+    /** Allow additional annotations */
+    [key: string]: any;
+}
+/**
+ * Base trigger interface
+ *
+ * @category Triggers
+ */
+export interface BaseTrigger {
+    type: TriggerType;
+}
+/**
+ * Manual trigger - workflow must be explicitly invoked
+ *
+ * @category Triggers
+ */
+export interface ManualTrigger extends BaseTrigger {
+    type: TriggerType.Manual;
+}
+/**
+ * Cron-based scheduled trigger
+ *
+ * @category Triggers
+ */
+export interface CronTrigger extends BaseTrigger {
+    type: TriggerType.Cron;
+    /** Cron expression (e.g., "0 2 * * *") */
+    schedule: string;
+}
+/**
+ * Event-driven trigger
+ *
+ * @category Triggers
+ */
+export interface EventTrigger extends BaseTrigger {
+    type: TriggerType.Event;
+    /** Event source identifier (e.g., "github.push") */
+    source: string;
+    /** Optional filtering conditions */
+    filters?: Record<string, any>;
+}
+/**
+ * HTTP webhook trigger
+ *
+ * @category Triggers
+ */
+export interface WebhookTrigger extends BaseTrigger {
+    type: TriggerType.Webhook;
+    /** Webhook endpoint path */
+    endpoint: string;
+    /** 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.
+ *
+ * Format: "provider:path" (e.g., "vaulta:mediaproc/api/key")
+ *
+ * @category Secrets
+ */
+export interface WorkflowSecrets {
+    /** Secret vault provider (default: "vaulta") */
+    vault?: string;
+    /** 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
+ *
+ * @category Inputs
+ */
+export interface WorkflowInputDefinition {
+    /** Data type of input */
+    type?: InputType;
+    /** Whether input is required */
+    required?: boolean;
+    /** Default value if not provided */
+    default?: any;
+    /** 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)
+ *
+ * @category Context
+ */
+export interface WorkflowContext {
+    /** Environment name */
+    env?: ExecutionEnvironment;
+    /** Execution platform */
+    platform?: string;
+    /** Working directory path */
+    workspace?: string;
+    /** Allow additional context fields */
+    [key: string]: any;
+}
+/**
+ * Retry configuration
+ *
+ * @category Execution
+ */
+export interface WorkflowRetryConfig {
+    /** Maximum retry attempts */
+    max: number;
+    /** Backoff strategy */
+    backoff?: BackoffStrategy;
+    /** 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
+ *
+ * @category Configuration
+ */
+export interface WorkflowDefaults {
+    /** Default retry configuration */
+    retry?: WorkflowRetryConfig;
+    /** Default step timeout */
+    timeout?: TimeoutSpec;
+    /** Default adapter if not specified in uses */
+    adapter?: string;
+    /** Allow additional defaults */
+    [key: string]: any;
+}
+/**
+ * Execution policies and rules
+ *
+ * @category Configuration
+ */
+export interface WorkflowPolicies {
+    /** Failure handling policy */
+    failure?: FailurePolicy;
+    /** Maximum parallel step execution */
+    concurrency?: number;
+    /** Sandbox enforcement level */
+    sandbox?: SandboxLevel;
+    /** Allow additional policies */
+    [key: string]: any;
+}
+/**
+ * Filesystem permissions
+ *
+ * @category Security
+ */
+export interface FilesystemPermissions {
+    /** Allowed read paths */
+    read?: string[];
+    /** Allowed write paths */
+    write?: string[];
+}
+/**
+ * Network permissions
+ *
+ * @category Security
+ */
+export interface NetworkPermissions {
+    /** Allowed hosts/domains */
+    allow?: string[];
+    /** Blocked hosts/domains */
+    deny?: string[];
+}
+/**
+ * Fine-grained security permissions
+ *
+ * @category Security
+ */
+export interface WorkflowPermissions {
+    /** Filesystem access permissions */
+    fs?: FilesystemPermissions;
+    /** Network access permissions */
+    network?: NetworkPermissions;
+    /** Allow additional permission types */
+    [key: string]: any;
+}
+/**
+ * Resource constraints for cloud/distributed execution
+ * Reserved for future use
+ *
+ * @category Resources
+ */
+export interface WorkflowResources {
+    /** CPU allocation */
+    cpu?: number | string;
+    /** Memory allocation (e.g., "512MB", "2GB") */
+    memory?: string;
+    /** Disk allocation (e.g., "1GB", "10GB") */
+    disk?: string;
+    /** Overall workflow timeout */
+    timeout?: TimeoutSpec;
+    /** Allow additional resource specifications */
+    [key: string]: any;
+}
+/**
+ * Output mapping from step result to named outputs
+ *
+ * @category Steps
+ */
+export type StepOutputMapping = Record<string, string>;
+/**
+ * Conditional execution expression
+ * Supports ${inputs.*}, ${secrets.*}, ${steps.*.outputs.*}, ${context.*}
+ *
+ * @category Steps
+ */
+export type StepCondition = string;
+/**
+ * Individual workflow step definition
+ *
+ * @category Steps
+ */
+export interface WorkflowStepDefinition {
+    /**
+     * Unique step identifier
+     * Used for output referencing and dependencies
+     * Pattern: ^[a-zA-Z][a-zA-Z0-9_-]*$
+     */
+    id: string;
+    /** Human-readable step name */
+    name?: string;
+    /**
+     * Action to execute - THE universal abstraction
+     * Format: namespace.action or namespace.domain.action
+     *
+     * Examples:
+     * - mediaproc.image.resize
+     * - cli.exec
+     * - http.request
+     * - shell.run
+     * - db.query
+     */
+    uses: string;
+    /**
+     * Adapter-specific input parameters
+     * Structure validated by adapter, not by schema
+     * Supports variable interpolation: ${namespace.path}
+     */
+    with?: Record<string, any>;
+    /** Conditional execution expression */
+    when?: StepCondition;
+    /** Explicit step dependencies (step IDs) */
+    needs?: string[];
+    /** Step-specific retry config (overrides defaults) */
+    retry?: WorkflowRetryConfig;
+    /** Step execution timeout (overrides defaults) */
+    timeout?: TimeoutSpec;
+    /**
+     * Continue workflow even if step fails
+     * Critical for cleanup and best-effort steps
+     */
+    continueOnError?: boolean;
+    /** Map step outputs to named values for other steps */
+    outputs?: StepOutputMapping;
+    /** Environment variables for this step */
+    env?: Record<string, string>;
+}
+/**
+ * Core workflow execution definition
+ *
+ * @category Workflow
+ */
+export interface WorkflowBody {
+    /** Ordered list of execution steps */
+    steps: WorkflowStepDefinition[];
+}
+/**
+ * Lifecycle hooks - Reserved for future use
+ *
+ * @category Lifecycle
+ */
+export interface WorkflowLifecycleHooks {
+    /** Steps to run on successful completion */
+    success?: any[];
+    /** Steps to run on failure */
+    failure?: any[];
+    /** Steps to always run (cleanup) */
+    always?: any[];
+}
+/**
+ * Complete Orbyt workflow definition
+ *
+ * This is the root type for all workflow YAML/JSON files.
+ *
+ * @category Workflow
+ */
+export interface WorkflowDefinition {
+    /** Schema version (semantic versioning) */
+    version: string;
+    /** Type of executable */
+    kind: WorkflowKind | string;
+    /** Core workflow execution definition */
+    workflow: WorkflowBody;
+    /** Human-readable metadata */
+    metadata?: WorkflowMetadata;
+    /** Zero-impact annotations for tooling */
+    annotations?: WorkflowAnnotations;
+    /** Execution triggers */
+    triggers?: WorkflowTrigger[];
+    /** External secret references */
+    secrets?: WorkflowSecrets;
+    /** Runtime parameters */
+    inputs?: WorkflowInputs;
+    /** Runtime environment context */
+    context?: WorkflowContext;
+    /** Default settings for all steps */
+    defaults?: WorkflowDefaults;
+    /** Execution policies */
+    policies?: WorkflowPolicies;
+    /** Security permissions */
+    permissions?: WorkflowPermissions;
+    /** Resource constraints (future) */
+    resources?: WorkflowResources;
+    /** Final workflow outputs returned to caller */
+    outputs?: Record<string, string>;
+    /** Lifecycle hooks (future) */
+    on?: WorkflowLifecycleHooks;
+}
+/**
+ * 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

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

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

package/dist/types/workflow.types.js

@@ -0,0 +1,90 @@
+/**
+ * Orbyt Workflow Type Definitions
+ *
+ * Comprehensive TypeScript types for Orbyt workflows.
+ * These types 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
+ * - Versioned: includes v1 and future-reserved fields
+ */
+// ============================================================================
+// ENUMS & CONSTANTS
+// ============================================================================
+/**
+ * Type of workflow executable
+ */
+export var WorkflowKind;
+(function (WorkflowKind) {
+    /** Standard workflow - default execution model */
+    WorkflowKind["Workflow"] = "workflow";
+    /** Pipeline - emphasizes data flow */
+    WorkflowKind["Pipeline"] = "pipeline";
+    /** Job - emphasizes scheduled/batch execution */
+    WorkflowKind["Job"] = "job";
+    /** Playbook - emphasizes operational procedures */
+    WorkflowKind["Playbook"] = "playbook";
+    /** Automation - emphasizes event-driven execution */
+    WorkflowKind["Automation"] = "automation";
+})(WorkflowKind || (WorkflowKind = {}));
+/**
+ * Trigger types for workflow execution
+ */
+export var TriggerType;
+(function (TriggerType) {
+    /** Manually invoked by user */
+    TriggerType["Manual"] = "manual";
+    /** Scheduled via cron expression */
+    TriggerType["Cron"] = "cron";
+    /** Event-driven execution */
+    TriggerType["Event"] = "event";
+    /** HTTP webhook trigger */
+    TriggerType["Webhook"] = "webhook";
+})(TriggerType || (TriggerType = {}));
+/**
+ * Failure handling policy
+ */
+export var FailurePolicy;
+(function (FailurePolicy) {
+    /** Stop entire workflow on first failure */
+    FailurePolicy["Stop"] = "stop";
+    /** Continue with remaining steps */
+    FailurePolicy["Continue"] = "continue";
+    /** Isolate failure to step only */
+    FailurePolicy["Isolate"] = "isolate";
+})(FailurePolicy || (FailurePolicy = {}));
+/**
+ * Retry backoff strategy
+ */
+export var BackoffStrategy;
+(function (BackoffStrategy) {
+    /** Fixed delay between retries */
+    BackoffStrategy["Linear"] = "linear";
+    /** Exponentially increasing delay */
+    BackoffStrategy["Exponential"] = "exponential";
+})(BackoffStrategy || (BackoffStrategy = {}));
+/**
+ * Sandbox enforcement level
+ */
+export var SandboxLevel;
+(function (SandboxLevel) {
+    /** No sandboxing */
+    SandboxLevel["None"] = "none";
+    /** Basic permission checks */
+    SandboxLevel["Basic"] = "basic";
+    /** Strict isolation and permissions */
+    SandboxLevel["Strict"] = "strict";
+})(SandboxLevel || (SandboxLevel = {}));
+/**
+ * Execution environment
+ */
+export var ExecutionEnvironment;
+(function (ExecutionEnvironment) {
+    ExecutionEnvironment["Local"] = "local";
+    ExecutionEnvironment["Dev"] = "dev";
+    ExecutionEnvironment["Staging"] = "staging";
+    ExecutionEnvironment["Prod"] = "prod";
+})(ExecutionEnvironment || (ExecutionEnvironment = {}));
+//# sourceMappingURL=workflow.types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.types.js","sourceRoot":"","sources":["../../src/types/workflow.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAN,IAAY,YAWX;AAXD,WAAY,YAAY;IACtB,kDAAkD;IAClD,qCAAqB,CAAA;IACrB,sCAAsC;IACtC,qCAAqB,CAAA;IACrB,iDAAiD;IACjD,2BAAW,CAAA;IACX,mDAAmD;IACnD,qCAAqB,CAAA;IACrB,qDAAqD;IACrD,yCAAyB,CAAA;AAC3B,CAAC,EAXW,YAAY,KAAZ,YAAY,QAWvB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,WASX;AATD,WAAY,WAAW;IACrB,+BAA+B;IAC/B,gCAAiB,CAAA;IACjB,oCAAoC;IACpC,4BAAa,CAAA;IACb,6BAA6B;IAC7B,8BAAe,CAAA;IACf,2BAA2B;IAC3B,kCAAmB,CAAA;AACrB,CAAC,EATW,WAAW,KAAX,WAAW,QAStB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,4CAA4C;IAC5C,8BAAa,CAAA;IACb,oCAAoC;IACpC,sCAAqB,CAAA;IACrB,mCAAmC;IACnC,oCAAmB,CAAA;AACrB,CAAC,EAPW,aAAa,KAAb,aAAa,QAOxB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,kCAAkC;IAClC,oCAAiB,CAAA;IACjB,qCAAqC;IACrC,8CAA2B,CAAA;AAC7B,CAAC,EALW,eAAe,KAAf,eAAe,QAK1B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,YAOX;AAPD,WAAY,YAAY;IACtB,oBAAoB;IACpB,6BAAa,CAAA;IACb,8BAA8B;IAC9B,+BAAe,CAAA;IACf,uCAAuC;IACvC,iCAAiB,CAAA;AACnB,CAAC,EAPW,YAAY,KAAZ,YAAY,QAOvB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,oBAKX;AALD,WAAY,oBAAoB;IAC9B,uCAAe,CAAA;IACf,mCAAW,CAAA;IACX,2CAAmB,CAAA;IACnB,qCAAa,CAAA;AACf,CAAC,EALW,oBAAoB,KAApB,oBAAoB,QAK/B"}

package/dist/utils/assert.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=assert.d.ts.map

package/dist/utils/assert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../src/utils/assert.ts"],"names":[],"mappings":""}

package/dist/utils/assert.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=assert.js.map

package/dist/utils/assert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.js","sourceRoot":"","sources":["../../src/utils/assert.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@dev-ecosystem/core",
+  "version": "0.1.0",
+  "description": "Core utilities and libraries for the Dev Ecosystem.",
+  "type": "module",
+  "scripts": {
+    "build": "rm -rf dist && tsc",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "orbyt",
+    "ecosystem",
+    "developer",
+    "infrastructure",
+    "tools",
+    "devforge",
+    "scaffolding",
+    "automation",
+    "cli",
+    "libraries"
+  ],
+  "author": {
+    "name": "0xshariq",
+    "url": "https://github.com/0xshariq"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.0.0"
+  }
+}