@octaviaflow/flow-rules 0.1.0 → 0.2.0

package/dist/catalog/triggers/manual-trigger/config.js

@@ -1,60 +0,0 @@
-/**
- * Manual Trigger Configuration
- *
- * Defines the configuration structure and default values for the Manual Trigger action
- */
-export const ManualTriggerConfig = {
-    /**
-     * Default configuration for Manual Trigger
-     */
-    defaults: {
-        description: '',
-    },
-    /**
-     * Configuration schema for validation
-     */
-    schema: {
-        description: {
-            type: 'string',
-            maxLength: 500,
-            required: false,
-            description: 'Optional description for this trigger (shown on node)',
-        },
-    },
-    /**
-     * Validate configuration
-     */
-    validate: (config) => {
-        const errors = [];
-        if (config.description !== undefined) {
-            if (typeof config.description !== 'string') {
-                errors.push('Description must be a string');
-            }
-            if (config.description.length > 500) {
-                errors.push('Description must not exceed 500 characters');
-            }
-        }
-        return {
-            valid: errors.length === 0,
-            errors,
-        };
-    },
-    /**
-     * Merge user config with defaults
-     */
-    merge: (userConfig) => {
-        return {
-            ...ManualTriggerConfig.defaults,
-            ...userConfig,
-        };
-    },
-    /**
-     * Get display label for configuration
-     */
-    getLabel: (config) => {
-        if (config.description) {
-            return `Manual Trigger: ${config.description}`;
-        }
-        return 'Manual Trigger';
-    },
-};

package/dist/catalog/triggers/manual-trigger/index.js

@@ -1,74 +0,0 @@
-/**
- * Manual Trigger Action
- *
- * A built-in trigger action that allows manual workflow execution with optional configuration
- */
-import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
-import { randomSuffix } from '../../../ids';
-import { ManualTriggerConfig } from './config';
-export const manualTriggerDefinition = {
-    id: 'manual_trigger',
-    name: 'Manual Trigger',
-    description: 'Manually trigger workflow with optional description',
-    category: ActionCategory.Trigger,
-    type: ActionType.Manual,
-    tags: ['trigger', 'manual', 'built-in'],
-    status: ActionStatus.Stable,
-    icon: 'PlayOutline',
-    color: '#0f62fe',
-    inputSchema: {
-        fields: [
-            {
-                key: 'description',
-                label: 'Description',
-                type: FieldType.String,
-                description: 'Optional description for this trigger (shown on node)',
-                placeholder: 'e.g., Manual data sync, Testing workflow, etc.',
-                validation: {
-                    required: false,
-                    maxLength: 500,
-                },
-            },
-        ],
-    },
-    outputSchema: {
-        type: 'object',
-        properties: [
-            {
-                key: 'triggeredAt',
-                type: FieldType.DateTime,
-                description: 'Timestamp when workflow was triggered',
-            },
-            // `triggeredBy` was declared here but never produced, so the picker
-            // offered a token that always resolved to nothing. The Engine DOES have
-            // it — `metadata.triggeredBy` / `.triggeredByEmail` exist on the run —
-            // but they are not threaded into `executeStep`, which is where the
-            // trigger envelope is built. Removed rather than left as a dead token;
-            // re-add it together with that threading.
-            {
-                key: 'executionId',
-                type: FieldType.String,
-                description: 'Unique execution ID for this workflow run',
-            },
-            {
-                key: 'description',
-                type: FieldType.String,
-                description: 'The description provided by the user (if any)',
-            },
-        ],
-        sampleOutput: {
-            triggeredAt: new Date().toISOString(),
-            executionId: `exec_${Date.now()}_${randomSuffix(9)}`,
-            description: 'Manual data sync',
-        },
-    },
-    version: '1.0.0',
-    createdAt: '2025-01-01T00:00:00Z',
-    updatedAt: '2025-12-15T00:00:00Z',
-    createdBy: 'system',
-    isOfficial: true,
-    testable: true,
-};
-// The config PANEL stays in octaviaflow-ui: this package is data and rules,
-// and a React component here would make it unusable from Backend.
-export { ManualTriggerConfig };

package/dist/catalog/triggers/schedule-trigger/config.js

@@ -1,42 +0,0 @@
-/**
- * Schedule Trigger Configuration
- */
-export const ScheduleTriggerConfig = {
-    defaults: {
-        scheduleType: 'interval',
-        interval: 60,
-        intervalUnit: 'minutes',
-        timezone: 'UTC',
-    },
-    schema: {
-        scheduleType: { type: 'select', required: true },
-        interval: { type: 'number', required: false, min: 1 },
-        intervalUnit: { type: 'select', required: false },
-        cronExpression: { type: 'string', required: false },
-        timezone: { type: 'string', required: false },
-    },
-    validate: (config) => {
-        const errors = [];
-        if (!config.scheduleType) {
-            errors.push('Schedule type is required');
-        }
-        if (config.scheduleType === 'interval') {
-            if (!config.interval || config.interval < 1) {
-                errors.push('Interval must be at least 1');
-            }
-        }
-        if (config.scheduleType === 'cron' && !config.cronExpression) {
-            errors.push('Cron expression is required');
-        }
-        return { valid: errors.length === 0, errors };
-    },
-    merge: (userConfig) => {
-        return { ...ScheduleTriggerConfig.defaults, ...userConfig };
-    },
-    getLabel: (config) => {
-        if (config.scheduleType === 'interval') {
-            return `Every ${config.interval} ${config.intervalUnit}`;
-        }
-        return `Schedule: ${config.scheduleType}`;
-    },
-};

package/dist/catalog/triggers/schedule-trigger/index.js

@@ -1,102 +0,0 @@
-/**
- * Schedule Trigger Action
- *
- * Trigger workflows on a schedule using cron expressions or intervals
- */
-import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
-export const scheduleTriggerDefinition = {
-    id: 'schedule_trigger',
-    name: 'Schedule Trigger',
-    description: 'Trigger workflow on a schedule using cron or intervals',
-    category: ActionCategory.Trigger,
-    type: ActionType.Schedule,
-    tags: ['trigger', 'schedule', 'cron', 'built-in'],
-    status: ActionStatus.Stable,
-    icon: 'Time',
-    color: '#0f62fe',
-    inputSchema: {
-        fields: [
-            {
-                key: 'scheduleType',
-                label: 'Schedule Type',
-                type: FieldType.Select,
-                description: 'Type of schedule',
-                defaultValue: 'interval',
-                options: [
-                    { label: 'Interval', value: 'interval' },
-                    { label: 'Cron Expression', value: 'cron' },
-                    { label: 'Specific Time', value: 'specific' },
-                ],
-                validation: { required: true },
-            },
-            {
-                key: 'interval',
-                label: 'Interval',
-                type: FieldType.Number,
-                description: 'Interval value (used with interval type)',
-                validation: { required: false, min: 1 },
-            },
-            {
-                key: 'intervalUnit',
-                label: 'Interval Unit',
-                type: FieldType.Select,
-                description: 'Unit for interval (minutes, hours, days)',
-                defaultValue: 'minutes',
-                options: [
-                    { label: 'Minutes', value: 'minutes' },
-                    { label: 'Hours', value: 'hours' },
-                    { label: 'Days', value: 'days' },
-                    { label: 'Weeks', value: 'weeks' },
-                ],
-                validation: { required: false },
-            },
-            {
-                key: 'cronExpression',
-                label: 'Cron Expression',
-                type: FieldType.String,
-                description: 'Cron expression (e.g., 0 0 * * * for daily at midnight)',
-                placeholder: '0 0 * * *',
-                validation: { required: false },
-            },
-            {
-                key: 'timezone',
-                label: 'Timezone',
-                type: FieldType.String,
-                description: 'Timezone for schedule (e.g., UTC, America/New_York)',
-                defaultValue: 'UTC',
-                validation: { required: false },
-            },
-        ],
-    },
-    outputSchema: {
-        type: 'object',
-        properties: [
-            {
-                key: 'scheduledAt',
-                type: FieldType.DateTime,
-                description: 'When the schedule was triggered',
-            },
-            {
-                key: 'nextRun',
-                type: FieldType.DateTime,
-                description: 'When the next run is scheduled',
-            },
-            {
-                key: 'scheduleType',
-                type: FieldType.String,
-                description: 'Type of schedule that triggered',
-            },
-        ],
-        sampleOutput: {
-            scheduledAt: new Date().toISOString(),
-            nextRun: new Date(Date.now() + 3600000).toISOString(),
-            scheduleType: 'interval',
-        },
-    },
-    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/triggers/webhook-trigger/config.js

@@ -1,27 +0,0 @@
-/**
- * Webhook Trigger Configuration
- */
-export const WebhookTriggerConfig = {
-    defaults: {
-        method: 'POST',
-        requireAuth: true,
-    },
-    schema: {
-        webhookPath: { type: 'string', required: false },
-        method: { type: 'select', required: true },
-        requireAuth: { type: 'boolean', required: false },
-    },
-    validate: (config) => {
-        const errors = [];
-        if (!config.method) {
-            errors.push('HTTP method is required');
-        }
-        return { valid: errors.length === 0, errors };
-    },
-    merge: (userConfig) => {
-        return { ...WebhookTriggerConfig.defaults, ...userConfig };
-    },
-    getLabel: (config) => {
-        return `Webhook ${config.method}${config.webhookPath ? ` ${config.webhookPath}` : ''}`;
-    },
-};

package/dist/catalog/triggers/webhook-trigger/index.js

@@ -1,89 +0,0 @@
-/**
- * Webhook Trigger Action
- *
- * Trigger workflows via HTTP webhooks
- */
-import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
-export const webhookTriggerDefinition = {
-    id: 'webhook_trigger',
-    name: 'Webhook Trigger',
-    description: 'Trigger workflow via HTTP webhook',
-    category: ActionCategory.Trigger,
-    type: ActionType.Webhook,
-    tags: ['trigger', 'webhook', 'http', 'built-in'],
-    status: ActionStatus.Stable,
-    icon: 'WebhookAlt',
-    color: '#0f62fe',
-    inputSchema: {
-        fields: [
-            {
-                key: 'webhookPath',
-                label: 'Webhook Path',
-                type: FieldType.String,
-                description: 'Custom path for the webhook URL',
-                placeholder: '/my-webhook',
-                validation: { required: false },
-            },
-            {
-                key: 'method',
-                label: 'HTTP Method',
-                type: FieldType.Select,
-                description: 'Allowed HTTP methods',
-                defaultValue: 'POST',
-                options: [
-                    { label: 'GET', value: 'GET' },
-                    { label: 'POST', value: 'POST' },
-                    { label: 'PUT', value: 'PUT' },
-                    { label: 'PATCH', value: 'PATCH' },
-                    { label: 'DELETE', value: 'DELETE' },
-                ],
-                validation: { required: true },
-            },
-            {
-                key: 'requireAuth',
-                label: 'Require Authentication',
-                type: FieldType.Boolean,
-                description: 'Require API key or token for webhook',
-                defaultValue: true,
-                validation: { required: false },
-            },
-        ],
-    },
-    outputSchema: {
-        type: 'object',
-        properties: [
-            {
-                key: 'webhookUrl',
-                type: FieldType.URL,
-                description: 'The generated webhook URL',
-            },
-            {
-                key: 'method',
-                type: FieldType.String,
-                description: 'HTTP method used',
-            },
-            {
-                key: 'payload',
-                type: FieldType.JSON,
-                description: 'Request payload received',
-            },
-            {
-                key: 'headers',
-                type: FieldType.Object,
-                description: 'Request headers',
-            },
-        ],
-        sampleOutput: {
-            webhookUrl: 'https://api.example.com/webhooks/trigger-123',
-            method: 'POST',
-            payload: { data: 'example' },
-            headers: { 'content-type': 'application/json' },
-        },
-    },
-    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/types.js

@@ -1,135 +0,0 @@
-/**
- * Action System Type Definitions
- *
- * Complete type definitions for the action system including enums, interfaces, and utilities
- */
-// ============================================
-// ENUMS
-// ============================================
-export var ActionCategory;
-(function (ActionCategory) {
-    // Core workflow
-    ActionCategory["Trigger"] = "trigger";
-    ActionCategory["Action"] = "action";
-    ActionCategory["Logic"] = "logic";
-    ActionCategory["Transform"] = "transform";
-    // AI-specific
-    ActionCategory["AI"] = "ai";
-    // Data operations
-    ActionCategory["Database"] = "database";
-    ActionCategory["API"] = "api";
-    ActionCategory["Storage"] = "storage";
-    ActionCategory["FileStorage"] = "file_storage";
-    // Communication
-    ActionCategory["Communication"] = "communication";
-    // Integrations
-    ActionCategory["CRM"] = "crm";
-    ActionCategory["Ecommerce"] = "ecommerce";
-    ActionCategory["Marketing"] = "marketing";
-    ActionCategory["Analytics"] = "analytics";
-    ActionCategory["Productivity"] = "productivity";
-    // Advanced
-    ActionCategory["Custom"] = "custom";
-    ActionCategory["Utility"] = "utility";
-})(ActionCategory || (ActionCategory = {}));
-export var ActionType;
-(function (ActionType) {
-    // Triggers
-    ActionType["Schedule"] = "schedule";
-    ActionType["Webhook"] = "webhook";
-    ActionType["Manual"] = "manual";
-    ActionType["DataChange"] = "data_change";
-    ActionType["Event"] = "event";
-    // Data Actions
-    ActionType["Read"] = "read";
-    ActionType["Write"] = "write";
-    ActionType["Update"] = "update";
-    ActionType["Delete"] = "delete";
-    ActionType["Query"] = "query";
-    // API Actions
-    ActionType["HTTPRequest"] = "http_request";
-    ActionType["GraphQLQuery"] = "graphql_query";
-    // Logic Actions
-    ActionType["Condition"] = "condition";
-    ActionType["ForEach"] = "for_each";
-    ActionType["Group"] = "group";
-    // Transform Actions
-    ActionType["Format"] = "format";
-    // AI Actions
-    ActionType["AIAgent"] = "ai_agent";
-    ActionType["Embedding"] = "embedding";
-    ActionType["VectorSearch"] = "vector_search";
-    ActionType["ImageGeneration"] = "image_generation";
-    ActionType["ImageAnalysis"] = "image_analysis";
-    ActionType["SpeechToText"] = "speech_to_text";
-    ActionType["TextToSpeech"] = "text_to_speech";
-    // General Actions
-    ActionType["Transform"] = "transform";
-    // Storage Actions
-    ActionType["FileOperation"] = "file_operation";
-    ActionType["FileAction"] = "file_action";
-    ActionType["CsvAction"] = "csv_action";
-    ActionType["JsonAction"] = "json_action";
-    ActionType["XmlAction"] = "xml_action";
-    ActionType["ExcelAction"] = "excel_action";
-    ActionType["S3Action"] = "s3_action";
-    ActionType["FtpAction"] = "ftp_action";
-    ActionType["GoogleDriveAction"] = "google_drive_action";
-    ActionType["DropboxAction"] = "dropbox_action";
-    ActionType["OneDriveAction"] = "onedrive_action";
-    ActionType["StorageAction"] = "storage_action";
-    // Communication Actions
-    ActionType["EmailSend"] = "email_send";
-    ActionType["SlackMessage"] = "slack_message";
-    ActionType["WhatsappSend"] = "whatsapp_send";
-    ActionType["TeamsMessage"] = "teams_message";
-    ActionType["GoogleChat"] = "google_chat";
-    ActionType["WebhookCall"] = "webhook_call";
-    // Utility Actions
-    ActionType["Delay"] = "delay";
-    ActionType["Wait"] = "wait";
-    ActionType["Console"] = "console";
-    ActionType["Debug"] = "debug";
-    ActionType["Error"] = "error";
-    // Custom
-    ActionType["CustomCode"] = "custom_code";
-    ActionType["CustomAction"] = "custom_action";
-    // IDP — engine-driven sync extraction. Replaces the legacy
-    // idp_wait_for_job poll loop; the engine resolves the LLM connector at
-    // execution time and extracts once per source file.
-    ActionType["IdpExtract"] = "idp_extract";
-})(ActionType || (ActionType = {}));
-export var ActionStatus;
-(function (ActionStatus) {
-    ActionStatus["Stable"] = "stable";
-    ActionStatus["Beta"] = "beta";
-    ActionStatus["Alpha"] = "alpha";
-    ActionStatus["Experimental"] = "experimental";
-    ActionStatus["Deprecated"] = "deprecated";
-})(ActionStatus || (ActionStatus = {}));
-export var FieldType;
-(function (FieldType) {
-    FieldType["String"] = "string";
-    FieldType["Number"] = "number";
-    FieldType["Boolean"] = "boolean";
-    FieldType["Date"] = "date";
-    FieldType["DateTime"] = "datetime";
-    FieldType["Array"] = "array";
-    FieldType["Object"] = "object";
-    FieldType["JSON"] = "json";
-    FieldType["File"] = "file";
-    FieldType["Image"] = "image";
-    FieldType["Select"] = "select";
-    FieldType["MultiSelect"] = "multi_select";
-    FieldType["Code"] = "code";
-    FieldType["Expression"] = "expression";
-    FieldType["Mapping"] = "mapping";
-    FieldType["Connection"] = "connection";
-    FieldType["Secret"] = "secret";
-    FieldType["Color"] = "color";
-    FieldType["URL"] = "url";
-    FieldType["Email"] = "email";
-    FieldType["Phone"] = "phone";
-    FieldType["RichText"] = "rich_text";
-    FieldType["Markdown"] = "markdown";
-})(FieldType || (FieldType = {}));

package/dist/catalog/utility/debug/config.js

@@ -1,90 +0,0 @@
-/**
- * Debug Action — Config Types
- *
- * Mirrors the engine's `DebugConfig` shape so UI and engine agree on
- * serialization with no translation layer. See:
- *   Octaviaflow-Engine/src/services/debugExecutor.ts
- */
-export const DebugConfig = {
-    defaults: {
-        mode: 'log',
-        label: '',
-        log: { level: 'info', message: '' },
-    },
-    /**
-     * Pre-flight validation. Surfaces mode-specific missing-field errors.
-     */
-    validate(config) {
-        const errors = [];
-        if (!config.mode)
-            errors.push('Mode is required.');
-        if (!config.label?.trim())
-            errors.push('Label is required.');
-        switch (config.mode) {
-            case 'log':
-                if (!config.log?.message?.trim())
-                    errors.push('Log mode: message is required.');
-                if (!config.log?.level)
-                    errors.push('Log mode: level is required.');
-                break;
-            case 'snapshot':
-                // No required fields — paths is optional, schemaDiff is optional.
-                break;
-            case 'watch':
-                if (!config.watch?.expressions?.length) {
-                    errors.push('Watch mode: add at least one expression.');
-                }
-                else {
-                    for (const e of config.watch.expressions) {
-                        if (!e.label?.trim())
-                            errors.push('Watch mode: each expression needs a label.');
-                        if (!e.expression?.trim())
-                            errors.push('Watch mode: each expression needs an expression string.');
-                    }
-                }
-                break;
-            case 'assert':
-                if (!config.assert?.predicate?.trim())
-                    errors.push('Assert mode: predicate is required.');
-                if (!config.assert?.failureMessage?.trim())
-                    errors.push('Assert mode: failure message is required.');
-                break;
-            case 'profile':
-                if (!config.profile?.scope)
-                    errors.push('Profile mode: scope is required.');
-                break;
-        }
-        return { valid: errors.length === 0, errors };
-    },
-    /**
-     * One-time migration of the legacy `{ label, value }` stub config to
-     * the new `{ mode: 'log', label, log: {...} }` shape. Returns the
-     * config unchanged when it's already in the new shape.
-     */
-    migrateLegacyStub(config) {
-        if (config.mode) {
-            // Already migrated — strip stub-only `value` field if it lingers.
-            const { value: _stub, ...rest } = config;
-            return { ...DebugConfig.defaults, ...rest };
-        }
-        // Stub shape: { label, value }. Convert to log mode with the label
-        // doubled as the message (the most useful default given no other
-        // signal). The unused `value` is dropped — its content was always
-        // the upstream input which `includeInputData: true` now captures.
-        return {
-            mode: 'log',
-            label: config.label ?? 'Debug',
-            log: {
-                level: 'info',
-                message: config.label ?? 'Debug',
-                includeInputData: true,
-            },
-        };
-    },
-    merge(userConfig) {
-        return { ...DebugConfig.defaults, ...userConfig };
-    },
-    getLabel(config) {
-        return `Debug [${config.mode}]: ${config.label}`;
-    },
-};

package/dist/catalog/utility/debug/index.js

@@ -1,38 +0,0 @@
-/**
- * Debug Action
- *
- * Multi-mode workflow-author observability primitive: log / snapshot /
- * watch / assert / profile. Plus condition gating, sampling, schema-
- * diff classification, and a deploy-mode flag.
- *
- * See:
- */
-import { ActionCategory, ActionType, ActionStatus } from '../../types';
-export const debugDefinition = {
-    id: 'debug',
-    name: 'Debug',
-    description: 'Inspect, assert, watch, profile, or log workflow data at any point. Supports condition gating, sampling, and schema-drift detection.',
-    category: ActionCategory.Utility,
-    type: ActionType.Debug,
-    tags: ['utility', 'debug', 'observability', 'assert', 'snapshot', 'profile', 'built-in'],
-    status: ActionStatus.Stable,
-    icon: 'Debug',
-    color: '#6929C4',
-    // Custom panel handles all input — no generic field list.
-    inputSchema: { fields: [] },
-    // Output is intentionally minimal — Debug is observation, not data
-    // production. Captures live in the per-execution debug record.
-    outputSchema: {
-        type: 'object',
-        properties: [],
-        sampleOutput: { debugged: true, mode: 'log' },
-    },
-    // Bumping major version triggers the workflow migration that converts
-    // the legacy `{ label, value }` stub config to `{ mode: 'log', ... }`.
-    version: '2.0.0',
-    createdAt: '2025-01-01T00:00:00Z',
-    updatedAt: '2026-05-02T00:00:00Z',
-    createdBy: 'system',
-    isOfficial: true,
-    testable: false,
-};