@octaviaflow/flow-rules 0.1.0 → 0.2.0

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

@@ -1,25 +0,0 @@
-/**
- * Error Configuration
- */
-export const ErrorConfig = {
-    defaults: {
-        message: '',
-        code: undefined,
-    },
-    schema: {
-        message: { type: 'string', required: true },
-        code: { type: 'string', required: false },
-    },
-    validate: (config) => {
-        const errors = [];
-        if (!config.message)
-            errors.push('Error message is required');
-        return { valid: errors.length === 0, errors };
-    },
-    merge: (userConfig) => {
-        return { ...ErrorConfig.defaults, ...userConfig };
-    },
-    getLabel: (config) => {
-        return `Error: ${config.message}`;
-    },
-};

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

@@ -1,46 +0,0 @@
-/**
- * Error Action
- *
- * Throw an error to stop workflow execution
- */
-import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
-export const errorDefinition = {
-    id: 'error',
-    name: 'Error',
-    description: 'Throw an error to stop workflow execution',
-    category: ActionCategory.Utility,
-    type: ActionType.Error,
-    tags: ['utility', 'error', 'control', 'built-in'],
-    status: ActionStatus.Stable,
-    icon: 'ErrorFilled',
-    color: '#da3742',
-    inputSchema: {
-        fields: [
-            {
-                key: 'message',
-                label: 'Error Message',
-                type: FieldType.String,
-                description: 'Error message to throw',
-                validation: { required: true },
-            },
-            {
-                key: 'code',
-                label: 'Error Code',
-                type: FieldType.String,
-                description: 'Error code',
-                validation: { required: false },
-            },
-        ],
-    },
-    outputSchema: {
-        type: 'void',
-        properties: [],
-        sampleOutput: null,
-    },
-    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/utility/variables/config.js

@@ -1,70 +0,0 @@
-/**
- * Variables Action — Config Types
- *
- * Mirrors the engine's `VariableField` shape so the UI and engine
- * agree on serialization with no translation layer.
- */
-const RESERVED_KEYS = new Set(['_lineage', '_meta', '_redacted', '_error']);
-const KEY_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
-export const VariablesConfig = {
-    defaults: {
-        fields: [],
-    },
-    /**
-     * Pre-flight validation — runs at config save in the panel. Returns
-     * `valid: true` when every row passes; otherwise an array of human-
-     * readable error strings tagged with the offending key.
-     */
-    validate(config) {
-        const errors = [];
-        const fields = config.fields ?? [];
-        const seen = new Set();
-        for (const f of fields) {
-            if (!f.key) {
-                errors.push('Each field needs a key.');
-                continue;
-            }
-            if (RESERVED_KEYS.has(f.key)) {
-                errors.push(`"${f.key}" is reserved — pick another key.`);
-                continue;
-            }
-            if (!KEY_PATTERN.test(f.key)) {
-                errors.push(`"${f.key}" is not a valid identifier (letters, digits, underscore; must not start with a digit).`);
-                continue;
-            }
-            if (seen.has(f.key)) {
-                errors.push(`Duplicate key "${f.key}".`);
-                continue;
-            }
-            seen.add(f.key);
-            if (!f.type)
-                errors.push(`"${f.key}" is missing a type.`);
-            if (!f.source)
-                errors.push(`"${f.key}" is missing a source.`);
-        }
-        return { valid: errors.length === 0, errors };
-    },
-    /**
-     * Compute the action's `_outputSchema` from a field list. Maps each
-     * field's declared type to a JSONSchema node so downstream Field
-     * Mappers see real fields without a preview run.
-     */
-    computeOutputSchema(fields) {
-        const properties = {};
-        for (const f of fields) {
-            properties[f.key] = fieldToJsonSchema(f);
-        }
-        return { type: 'object', properties };
-    },
-};
-function fieldToJsonSchema(f) {
-    const node = { type: f.type };
-    if (f.description)
-        node.description = f.description;
-    if (f.validation?.enum)
-        node.enum = f.validation.enum;
-    // For arrays we don't know the item shape from the row alone (the
-    // user picks `array` but the source value may be string, number, or
-    // object). Leave items unset — Field Mapper synthesis can handle.
-    return node;
-}

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

@@ -1,40 +0,0 @@
-/**
- * Variables Action
- *
- * Emit one or more typed user-defined values as a step output. Five
- * source kinds — literal, expression, prompt, secret, env — each
- * captured via a row in the config panel. Replaces the legacy
- * USER_INPUT pattern with first-class typed step output.
- *
- * See:
- *   (design notes live in the platform's own documentation)
- */
-import { ActionCategory, ActionType, ActionStatus } from '../../types';
-export const variablesDefinition = {
-    id: 'variables',
-    name: 'Variables',
-    description: 'Emit one or more typed user-defined values as a step output. Sources: literal, expression, prompt, secret, env.',
-    category: ActionCategory.Utility,
-    type: ActionType.Write,
-    tags: ['utility', 'variables', 'value', 'expression', 'built-in'],
-    status: ActionStatus.Stable,
-    icon: 'Parameter',
-    color: '#0F62FE',
-    // Custom panel handles all input editing — no generic field list.
-    inputSchema: { fields: [] },
-    // Output schema is computed at config-save time from the field rows
-    // (the panel emits `_outputSchema` into config). The static fallback
-    // here is just a placeholder so the picker shows *something* before
-    // the user defines fields.
-    outputSchema: {
-        type: 'object',
-        properties: [],
-        sampleOutput: {},
-    },
-    version: '1.0.0',
-    createdAt: '2026-05-02T00:00:00Z',
-    updatedAt: '2026-05-02T00:00:00Z',
-    createdBy: 'system',
-    isOfficial: true,
-    testable: false,
-};

package/dist/catalog/workflow.js

@@ -1,25 +0,0 @@
-// ============================================
-// workflow.d.ts - Workflow Canvas Type Definitions
-// ============================================
-// ============================================
-// WORKFLOW NODE
-// ============================================
-export var NodeStatus;
-(function (NodeStatus) {
-    NodeStatus["Idle"] = "idle";
-    NodeStatus["Running"] = "running";
-    NodeStatus["Success"] = "success";
-    NodeStatus["Error"] = "error";
-    NodeStatus["Warning"] = "warning";
-    NodeStatus["Disabled"] = "disabled";
-})(NodeStatus || (NodeStatus = {}));
-// ============================================
-// WORKFLOW EDGE (CONNECTION)
-// ============================================
-export var EdgeType;
-(function (EdgeType) {
-    EdgeType["Default"] = "default";
-    EdgeType["Conditional"] = "conditional";
-    EdgeType["Loop"] = "loop";
-    EdgeType["Error"] = "error";
-})(EdgeType || (EdgeType = {}));

package/dist/ids.js

@@ -1,53 +0,0 @@
-/**
- * ID Generator Utilities
- *
- * All randomness comes from the Web Crypto API (`crypto.getRandomValues`),
- * which is available in every browser and as a Node global (≥18), so these
- * helpers work both client- and server-side. Using crypto instead of
- * `Math.random()` also clears the weak-PRNG security hotspot. These IDs are
- * NOT secrets — crypto is used for collision resistance, not unpredictability.
- */
-/**
- * Cryptographically-strong short token: `length` base36 chars (0-9a-z).
- * Drop-in replacement for the old `Math.random().toString(36).slice(2, 2+n)`
- * pattern — same character set and length, collision-resistant source.
- */
-export function randomSuffix(length = 7) {
-    const bytes = new Uint8Array(length);
-    crypto.getRandomValues(bytes);
-    let out = '';
-    for (let i = 0; i < length; i++) {
-        out += (bytes[i] % 36).toString(36);
-    }
-    return out;
-}
-/**
- * Generate a UUID v4 string using the Web Crypto API.
- */
-export function generateUUIDv4() {
-    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
-        const r = crypto.getRandomValues(new Uint8Array(1))[0] % 16;
-        const v = c === 'x' ? r : (r & 0x3) | 0x8;
-        return v.toString(16);
-    });
-}
-/**
- * Generate a workflow ID using UUID v4
- */
-export function generateWorkflowId() {
-    return generateUUIDv4();
-}
-/**
- * Generate a step/node ID with prefix for clarity
- */
-export function generateStepId() {
-    return `node_${Date.now()}_${randomSuffix(7)}`;
-}
-/**
- * Generate an edge/connection ID with prefix for clarity
- */
-export function generateEdgeId(sourceId, targetId) {
-    // Random suffix (same pattern as generateStepId) guarantees uniqueness even for
-    // two calls in the same millisecond with identical source/target.
-    return `edge_${sourceId}_${targetId}_${Date.now()}_${randomSuffix(7)}`;
-}

package/dist/rules/nodeConfigStatus.js

@@ -1,217 +0,0 @@
-/**
- * Node Config Status Utility
- *
- * Determines the status indicator for a workflow node based on
- * how completely its configuration has been filled out relative
- * to the action definition's input schema.
- *
- * Handles:
- * - Nested config keys (e.g., "visualConfig.tables" → config.visualConfig.tables)
- * - Conditional required fields (only enforced when their condition is met)
- * - Default values (count as filled if present)
- */
-import { getActionById } from '../catalog/index';
-/**
- * Action IDs whose nodes should not display a config status indicator.
- */
-const HIDDEN_STATUS_ACTIONS = new Set(['console_log']);
-/**
- * Check if a config value is considered "filled" (non-empty).
- */
-function isFieldFilled(value) {
-    if (value === undefined || value === null)
-        return false;
-    if (typeof value === 'string')
-        return value.trim().length > 0;
-    if (typeof value === 'number')
-        return true;
-    if (typeof value === 'boolean')
-        return true;
-    if (Array.isArray(value))
-        return value.length > 0;
-    if (typeof value === 'object')
-        return Object.keys(value).length > 0;
-    return false;
-}
-/**
- * Some actions persist part of their required configuration out-of-band rather
- * than in `node.config`. The Connector Trigger is the canonical case: its
- * watched entity/operation events are registered in the backend webhook
- * subscription store (keyed by flow + connector), and the node config only
- * carries a `subscribed` / `eventCount` summary of that subscription. For such
- * fields, that summary — not a literal `config.<key>` value — is the source of
- * truth for whether the field is configured.
- *
- * Returns true when the given required field should be treated as satisfied by
- * an out-of-band signal, so it is not falsely reported as missing. Removing a
- * subscription resets the summary (eventCount → 0), so an unconfigured trigger
- * still fails validation as expected.
- */
-function isSatisfiedOutOfBand(actionId, fieldKey, config) {
-    if (actionId === 'connector_trigger' && fieldKey === 'events') {
-        return Number(config.eventCount ?? 0) > 0;
-    }
-    // Messaging actions: the body can be plain text OR Block Kit, and the config
-    // panel stores the text under `text` while the action definition names the
-    // field `message` (its legacy alias). Without this, a Slack step that sends
-    // perfectly well reported "Missing required settings: message" — and since
-    // Flow Doctor errors BLOCK ACTIVATION, such a flow could run manually but
-    // never be scheduled.
-    if (MESSAGE_BODY_ACTIONS.has(actionId) && (fieldKey === 'message' || fieldKey === 'text')) {
-        const text = config.text ?? config.message;
-        if (typeof text === 'string' && text.trim().length > 0)
-            return true;
-        return Array.isArray(config.blocks) && config.blocks.length > 0;
-    }
-    return false;
-}
-/** Actions whose body may be text or blocks — see `isSatisfiedOutOfBand`. */
-const MESSAGE_BODY_ACTIONS = new Set([
-    'slack_message',
-    'teams_message',
-    'google_chat',
-]);
-/**
- * Resolve a nested key path (e.g., "visualConfig.tables") from a config object.
- */
-function getNestedValue(config, keyPath) {
-    const parts = keyPath.split('.');
-    let current = config;
-    for (const part of parts) {
-        if (current === null || current === undefined || typeof current !== 'object') {
-            return undefined;
-        }
-        current = current[part];
-    }
-    return current;
-}
-/**
- * Evaluate whether a conditional field should be active (visible/required)
- * based on the current config values.
- *
- * A field with conditionals is only required when at least one "show" or
- * "require" condition is satisfied.
- */
-function isFieldActive(field, config) {
-    if (!field.conditional || field.conditional.length === 0) {
-        return true;
-    }
-    // Check if any "show" or "require" condition is met
-    return field.conditional.some((cond) => {
-        if (cond.action !== 'show' && cond.action !== 'require') {
-            return false;
-        }
-        const fieldValue = getNestedValue(config, cond.field);
-        switch (cond.operator) {
-            case '==': return fieldValue === cond.value;
-            case '!=': return fieldValue !== cond.value;
-            case '>': return fieldValue > cond.value;
-            case '<': return fieldValue < cond.value;
-            case '>=': return fieldValue >= cond.value;
-            case '<=': return fieldValue <= cond.value;
-            case 'in': return Array.isArray(cond.value) && cond.value.includes(fieldValue);
-            case 'not_in': return Array.isArray(cond.value) && !cond.value.includes(fieldValue);
-            case 'contains':
-                return typeof fieldValue === 'string' && fieldValue.includes(cond.value);
-            default: return false;
-        }
-    });
-}
-/**
- * Determine the config completeness status of a workflow node.
- *
- * Status logic:
- * - "valid"        → All active required fields are filled (or no required fields exist)
- * - "warning"      → Some active required fields are missing, but at least one field has data
- * - "error"        → Has active required fields and none are filled, config is empty
- * - "unconfigured" → Action definition not found (unknown action type)
- */
-export function getNodeConfigStatus(node) {
-    // Some actions should never show a status indicator
-    if (HIDDEN_STATUS_ACTIONS.has(node.actionDefinitionId)) {
-        return {
-            status: 'hidden',
-            requiredTotal: 0,
-            requiredFilled: 0,
-            optionalTotal: 0,
-            optionalFilled: 0,
-            missingRequired: [],
-            filledOptional: [],
-        };
-    }
-    const definition = getActionById(node.actionDefinitionId);
-    if (!definition) {
-        return {
-            status: 'unconfigured',
-            requiredTotal: 0,
-            requiredFilled: 0,
-            optionalTotal: 0,
-            optionalFilled: 0,
-            missingRequired: [],
-            filledOptional: [],
-        };
-    }
-    const fields = definition.inputSchema?.fields ?? [];
-    const config = node.config ?? {};
-    // Filter to only active (visible) fields based on conditionals
-    const activeFields = fields.filter(f => !f.hidden && isFieldActive(f, config));
-    const requiredFields = activeFields.filter(f => f.validation?.required);
-    const optionalFields = activeFields.filter(f => !f.validation?.required);
-    const missingRequired = [];
-    let requiredFilled = 0;
-    for (const field of requiredFields) {
-        const value = getNestedValue(config, field.key);
-        if (isFieldFilled(value)) {
-            requiredFilled++;
-        }
-        else if (isFieldFilled(field.defaultValue)) {
-            // Field has a defaultValue — count as filled
-            requiredFilled++;
-        }
-        else if (isSatisfiedOutOfBand(node.actionDefinitionId, field.key, config)) {
-            // Field is configured out-of-band (e.g. Connector Trigger events live in
-            // the backend subscription store, mirrored here as an eventCount summary)
-            requiredFilled++;
-        }
-        else {
-            missingRequired.push(field.key);
-        }
-    }
-    const filledOptional = [];
-    let optionalFilled = 0;
-    for (const field of optionalFields) {
-        const value = getNestedValue(config, field.key);
-        if (isFieldFilled(value)) {
-            optionalFilled++;
-            filledOptional.push(field.key);
-        }
-    }
-    const requiredTotal = requiredFields.length;
-    const optionalTotal = optionalFields.length;
-    let status;
-    if (requiredTotal === 0) {
-        // No required fields → always valid (e.g., manual_trigger)
-        status = 'valid';
-    }
-    else if (missingRequired.length === 0) {
-        // All required fields filled
-        status = 'valid';
-    }
-    else if (requiredFilled > 0 || optionalFilled > 0) {
-        // Partially configured — some required fields still missing
-        status = 'warning';
-    }
-    else {
-        // Nothing configured at all but has required fields
-        status = 'error';
-    }
-    return {
-        status,
-        requiredTotal,
-        requiredFilled,
-        optionalTotal,
-        optionalFilled,
-        missingRequired,
-        filledOptional,
-    };
-}