@octaviaflow/flow-rules 0.1.0 → 0.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octaviaflow/flow-rules",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "The flow action catalog and the rules engine behind Flow Doctor — one definition of what a step accepts and what makes a flow valid, shared by the editor and the server",
   "type": "module",
   "main": "./dist/index.js",
@@ -12,9 +12,12 @@
       "import": "./dist/index.js"
     }
   },
-  "files": ["dist", "README.md"],
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "scripts": {
-    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "build": "rm -rf dist && tsc -p tsconfig.build.json --emitDeclarationOnly && bun build src/index.ts --outdir dist --target node --format esm",
     "test": "bun test",
     "typecheck": "tsc --noEmit"
   },
@@ -25,12 +28,18 @@
   "engines": {
     "bun": ">=1.2.0"
   },
-  "keywords": ["octaviaflow", "workflow", "actions", "validation", "flow-doctor"],
+  "keywords": [
+    "octaviaflow",
+    "workflow",
+    "actions",
+    "validation",
+    "flow-doctor"
+  ],
   "author": "Octaviaflow Team",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/OctaviaFlow/Octaviaflow-System.git",
+    "url": "git+https://github.com/OctaviaFlow/Octaviaflow-System.git",
     "directory": "Octaviaflow-Flow-Rules"
   },
   "bugs": "https://github.com/OctaviaFlow/Octaviaflow-System/issues",

package/dist/catalog/actions/console-log/config.js

@@ -1,70 +0,0 @@
-/**
- * Console Log Configuration
- *
- * Defines the configuration structure and default values for the Console Log action
- */
-export const ConsoleLogConfig = {
-    /**
-     * Default configuration for Console Log
-     */
-    defaults: {
-        message: '',
-        level: 'info',
-        data: undefined,
-        includeInputData: true,
-    },
-    /**
-     * Configuration schema for validation
-     */
-    schema: {
-        message: {
-            type: 'string',
-            required: true,
-            description: 'Message to log',
-        },
-        level: {
-            type: 'select',
-            required: false,
-            description: 'Log level for the message',
-        },
-        data: {
-            type: 'json',
-            required: false,
-            description: 'Additional data to log',
-        },
-    },
-    /**
-     * Validate configuration
-     */
-    validate: (config) => {
-        const errors = [];
-        if (!config.message) {
-            errors.push('Message is required');
-        }
-        else if (typeof config.message !== 'string') {
-            errors.push('Message must be a string');
-        }
-        if (config.level && !['info', 'warning', 'error', 'debug'].includes(config.level)) {
-            errors.push('Invalid log level');
-        }
-        return {
-            valid: errors.length === 0,
-            errors,
-        };
-    },
-    /**
-     * Merge user config with defaults
-     */
-    merge: (userConfig) => {
-        return {
-            ...ConsoleLogConfig.defaults,
-            ...userConfig,
-        };
-    },
-    /**
-     * Get display label for configuration
-     */
-    getLabel: (config) => {
-        return `Log [${config.level}]: ${config.message}`;
-    },
-};

package/dist/catalog/actions/console-log/index.js

@@ -1,89 +0,0 @@
-/**
- * Console Log Action
- *
- * Log messages to the workflow console for debugging and monitoring
- */
-import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
-export const consoleLogDefinition = {
-    id: 'console_log',
-    name: 'Console Log',
-    description: 'Log messages to the workflow console for debugging',
-    category: ActionCategory.Utility,
-    type: ActionType.Console,
-    tags: ['utility', 'logging', 'debug', 'built-in'],
-    status: ActionStatus.Stable,
-    icon: 'Terminal',
-    color: '#525252',
-    inputSchema: {
-        fields: [
-            {
-                key: 'message',
-                label: 'Message',
-                type: FieldType.String,
-                description: 'Message to log',
-                placeholder: 'e.g., Processing user data...',
-                validation: { required: true },
-            },
-            {
-                key: 'level',
-                label: 'Log Level',
-                type: FieldType.Select,
-                description: 'Log level for the message',
-                defaultValue: 'info',
-                options: [
-                    { label: 'Info', value: 'info' },
-                    { label: 'Warning', value: 'warning' },
-                    { label: 'Error', value: 'error' },
-                    { label: 'Debug', value: 'debug' },
-                ],
-                validation: { required: true },
-            },
-            {
-                key: 'data',
-                label: 'Data',
-                type: FieldType.JSON,
-                description: 'Additional data to log',
-                validation: { required: false },
-            },
-            {
-                key: 'includeInputData',
-                label: 'Include previous step output',
-                type: FieldType.Boolean,
-                description: 'When off, only the custom message prints — useful for summary "Done" logs that follow a ForEach.',
-                defaultValue: true,
-                validation: { required: false },
-            },
-        ],
-    },
-    outputSchema: {
-        type: 'object',
-        properties: [
-            {
-                key: 'logged',
-                type: FieldType.Boolean,
-                description: 'Whether the message was successfully logged',
-            },
-            {
-                key: 'timestamp',
-                type: FieldType.DateTime,
-                description: 'Timestamp of the log entry',
-            },
-            {
-                key: 'level',
-                type: FieldType.String,
-                description: 'Log level used',
-            },
-        ],
-        sampleOutput: {
-            logged: true,
-            timestamp: new Date().toISOString(),
-            level: 'info',
-        },
-    },
-    version: '1.0.0',
-    createdAt: '2025-01-01T00:00:00Z',
-    updatedAt: '2025-12-15T00:00:00Z',
-    createdBy: 'system',
-    isOfficial: true,
-    testable: true,
-};

package/dist/catalog/actions/delay/config.js

@@ -1,79 +0,0 @@
-/**
- * Delay Configuration
- *
- * Defines the configuration structure and default values for the Delay action
- */
-export const DelayConfig = {
-    /**
-     * Default configuration for Delay
-     */
-    defaults: {
-        duration: 1000,
-        unit: 'milliseconds',
-    },
-    /**
-     * Configuration schema for validation
-     */
-    schema: {
-        duration: {
-            type: 'number',
-            required: true,
-            description: 'Duration to delay',
-            min: 0,
-        },
-        unit: {
-            type: 'select',
-            required: false,
-            description: 'Time unit for the duration',
-        },
-    },
-    /**
-     * Validate configuration
-     */
-    validate: (config) => {
-        const errors = [];
-        if (config.duration === undefined || config.duration === null) {
-            errors.push('Duration is required');
-        }
-        else if (typeof config.duration !== 'number') {
-            errors.push('Duration must be a number');
-        }
-        else if (config.duration < 0) {
-            errors.push('Duration must be non-negative');
-        }
-        if (config.unit && !['milliseconds', 'seconds', 'minutes', 'hours'].includes(config.unit)) {
-            errors.push('Invalid time unit');
-        }
-        return {
-            valid: errors.length === 0,
-            errors,
-        };
-    },
-    /**
-     * Convert duration to milliseconds
-     */
-    toMilliseconds: (duration, unit = 'milliseconds') => {
-        const multipliers = {
-            milliseconds: 1,
-            seconds: 1000,
-            minutes: 60000,
-            hours: 3600000,
-        };
-        return duration * (multipliers[unit] || 1);
-    },
-    /**
-     * Merge user config with defaults
-     */
-    merge: (userConfig) => {
-        return {
-            ...DelayConfig.defaults,
-            ...userConfig,
-        };
-    },
-    /**
-     * Get display label for configuration
-     */
-    getLabel: (config) => {
-        return `Delay ${config.duration}${config.unit ? ' ' + config.unit : 'ms'}`;
-    },
-};

package/dist/catalog/actions/delay/index.js

@@ -1,71 +0,0 @@
-/**
- * Delay Action
- *
- * Pause workflow execution for a specified duration
- */
-import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
-export const delayDefinition = {
-    id: 'delay',
-    name: 'Delay',
-    description: 'Pause workflow execution for a specified duration',
-    category: ActionCategory.Utility,
-    type: ActionType.Delay,
-    tags: ['utility', 'delay', 'wait', 'built-in'],
-    status: ActionStatus.Stable,
-    icon: 'Timer',
-    color: '#8f8f8f',
-    inputSchema: {
-        fields: [
-            {
-                key: 'duration',
-                label: 'Duration (ms)',
-                type: FieldType.Number,
-                description: 'Duration to delay in milliseconds',
-                defaultValue: 1000,
-                validation: { required: true, min: 0 },
-            },
-            {
-                key: 'unit',
-                label: 'Unit',
-                type: FieldType.Select,
-                description: 'Time unit for the duration',
-                defaultValue: 'milliseconds',
-                options: [
-                    { label: 'Milliseconds', value: 'milliseconds' },
-                    { label: 'Seconds', value: 'seconds' },
-                    { label: 'Minutes', value: 'minutes' },
-                    { label: 'Hours', value: 'hours' },
-                ],
-                validation: { required: true },
-            },
-        ],
-    },
-    outputSchema: {
-        type: 'object',
-        properties: [
-            {
-                key: 'delayedFor',
-                type: FieldType.Number,
-                description: 'Actual delay duration in milliseconds',
-            },
-            {
-                key: 'completedAt',
-                type: FieldType.DateTime,
-                description: 'Timestamp when delay completed',
-            },
-        ],
-        sampleOutput: {
-            delayedFor: 1000,
-            completedAt: new Date().toISOString(),
-        },
-    },
-    execution: {
-        timeout: 3600000,
-    },
-    version: '1.0.0',
-    createdAt: '2025-01-01T00:00:00Z',
-    updatedAt: '2025-12-15T00:00:00Z',
-    createdBy: 'system',
-    isOfficial: true,
-    testable: true,
-};

package/dist/catalog/actions/delay/migrate.js

@@ -1,38 +0,0 @@
-/**
- * Migration shim — legacy `{ duration, unit }` Delay config → v2 multi-mode shape.
- *
- * Runs at read time in both UI (panel renders v2 shape) and Engine (executor
- * dispatches v2 modes). One-way and pure: persisted v1 configs stay v1 on
- * disk until a user explicitly saves the step in the v2 UI panel.
- *
- * Detection rule: a config is v2 when it has a `mode` property; otherwise
- * treat as v1 and rewrite to fixed-mode with the legacy duration/unit.
- *
- * See implementation doc §5.7 for design rationale.
- */
-const LEGACY_UNITS = new Set([
-    'milliseconds',
-    'seconds',
-    'minutes',
-    'hours',
-]);
-/**
- * Convert any persisted Delay config (v1 legacy or v2 multi-mode) into the v2
- * `DelayConfig` shape. Always safe to call — passes v2 inputs through unchanged.
- */
-export function migrateDelayConfig(raw) {
-    if (raw && typeof raw === 'object' && 'mode' in raw) {
-        return raw;
-    }
-    const legacy = (raw ?? {});
-    const duration = typeof legacy.duration === 'number' && Number.isFinite(legacy.duration)
-        ? legacy.duration
-        : 1;
-    const unit = typeof legacy.unit === 'string' && LEGACY_UNITS.has(legacy.unit)
-        ? legacy.unit
-        : 'milliseconds';
-    return {
-        mode: 'fixed',
-        fixed: { duration, unit },
-    };
-}

package/dist/catalog/actions/delay/types.js

@@ -1,17 +0,0 @@
-/**
- * Delay Action — v2 type definitions.
- *
- * v2 turns Delay into a multi-mode primitive (fixed / until / random-jitter /
- * expression) with per-mode configs. See architecture doc for design rationale:
- *   (design notes live in the platform's own documentation)
- *
- * PR 1 ships these types alongside the legacy `config.ts`. PR 3 collapses the
- * legacy file and rewrites the action definition (`index.ts`) against this
- * schema.
- */
-/**
- * Schema version. Bumped from the legacy 1.0.0 to mark the multi-mode
- * shape. The migration shim (`migrate.ts`) detects v1 configs by the
- * absence of `mode` and rewrites them to v2 fixed-mode equivalents.
- */
-export const DELAY_CONFIG_VERSION = '2.0.0';

package/dist/catalog/actions/http-request/config.js

@@ -1,111 +0,0 @@
-/**
- * HTTP Request Configuration
- *
- * Defines the configuration structure and default values for the HTTP Request action
- */
-export const HTTPRequestConfig = {
-    /**
-     * Default configuration for HTTP Request
-     */
-    defaults: {
-        apiType: 'rest',
-        method: 'GET',
-        url: '',
-        queryParams: [],
-        headers: [],
-        bodyType: 'json',
-        body: undefined,
-        formData: [],
-        graphqlQuery: '',
-        graphqlVariables: {},
-        auth: { type: 'none' },
-        timeout: 30000,
-        failOnError: true,
-        followRedirects: true,
-        retry: { maxAttempts: 1, retryOn: [429, 500, 502, 503, 504], initialDelayMs: 1000, backoffFactor: 2, maxDelayMs: 30000 },
-        pagination: { type: 'none' },
-        extract: {},
-        responseType: 'json',
-        expectedContentTypes: [],
-    },
-    /**
-     * Configuration schema for validation
-     */
-    schema: {
-        method: {
-            type: 'select',
-            required: true,
-            description: 'HTTP method to use',
-        },
-        url: {
-            type: 'url',
-            required: true,
-            description: 'The URL to send the request to',
-        },
-        headers: {
-            type: 'json',
-            required: false,
-            description: 'HTTP headers to send with the request',
-        },
-        body: {
-            type: 'json',
-            required: false,
-            description: 'Request body (for POST, PUT, PATCH)',
-        },
-        timeout: {
-            type: 'number',
-            required: false,
-            description: 'Request timeout in milliseconds',
-            min: 1000,
-        },
-    },
-    /**
-     * Validate configuration
-     */
-    validate: (config) => {
-        const errors = [];
-        const apiType = config.apiType ?? 'rest';
-        if (apiType === 'rest' && !config.method) {
-            errors.push('Method is required');
-        }
-        if (apiType === 'graphql' && !config.graphqlQuery?.trim()) {
-            errors.push('GraphQL query is required');
-        }
-        if (!config.url) {
-            errors.push('URL is required');
-        }
-        else if (typeof config.url === 'string') {
-            try {
-                new URL(config.url);
-            }
-            catch {
-                errors.push('Invalid URL format');
-            }
-        }
-        if (config.timeout !== undefined && typeof config.timeout === 'number') {
-            if (config.timeout < 1000) {
-                errors.push('Timeout must be at least 1000ms');
-            }
-        }
-        return {
-            valid: errors.length === 0,
-            errors,
-        };
-    },
-    /**
-     * Merge user config with defaults
-     */
-    merge: (userConfig) => {
-        return {
-            ...HTTPRequestConfig.defaults,
-            ...userConfig,
-        };
-    },
-    /**
-     * Get display label for configuration
-     */
-    getLabel: (config) => {
-        const type = config.apiType === 'graphql' ? 'GraphQL' : (config.method ?? 'GET');
-        return `${type} ${config.url}`;
-    },
-};