@objectstack/service-automation 4.0.4 → 4.0.5

package/src/index.ts

@@ -1,14 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-// Core engine
-export { AutomationEngine } from './engine.js';
-export type { NodeExecutor, NodeExecutionResult, FlowTrigger } from './engine.js';
-
-// Kernel plugin
-export { AutomationServicePlugin } from './plugin.js';
-export type { AutomationServicePluginOptions } from './plugin.js';
-
-// Node plugins
-export { CrudNodesPlugin } from './plugins/crud-nodes-plugin.js';
-export { LogicNodesPlugin } from './plugins/logic-nodes-plugin.js';
-export { HttpConnectorPlugin } from './plugins/http-connector-plugin.js';

package/src/plugin.ts

@@ -1,80 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import type { Plugin, PluginContext } from '@objectstack/core';
-import { AutomationEngine } from './engine.js';
-
-/**
- * Configuration options for the AutomationServicePlugin.
- */
-export interface AutomationServicePluginOptions {
-    /** Enable debug logging for flow execution */
-    debug?: boolean;
-}
-
-/**
- * AutomationServicePlugin — Core engine plugin
- *
- * Responsibilities:
- * 1. init phase: Create engine instance, register as 'automation' service
- * 2. start phase: Trigger 'automation:ready' hook for node plugin registration
- * 3. destroy phase: Clean up resources
- *
- * Does NOT implement any specific nodes — nodes are registered by other plugins
- * via the engine's extension API.
- *
- * @example
- * ```ts
- * import { LiteKernel } from '@objectstack/core';
- * import { AutomationServicePlugin } from '@objectstack/service-automation';
- *
- * const kernel = new LiteKernel();
- * kernel.use(new AutomationServicePlugin());
- * await kernel.bootstrap();
- *
- * const automation = kernel.getService('automation');
- * ```
- */
-export class AutomationServicePlugin implements Plugin {
-    name = 'com.objectstack.service-automation';
-    version = '1.0.0';
-    type = 'standard' as const;
-    dependencies: string[] = [];
-
-    private engine?: AutomationEngine;
-    private readonly options: AutomationServicePluginOptions;
-
-    constructor(options: AutomationServicePluginOptions = {}) {
-        this.options = options;
-    }
-
-    async init(ctx: PluginContext): Promise<void> {
-        this.engine = new AutomationEngine(ctx.logger);
-
-        // Register as global service — other plugins access via ctx.getService('automation')
-        ctx.registerService('automation', this.engine);
-
-        if (this.options.debug) {
-            ctx.hook('automation:beforeExecute', async (flowName: string) => {
-                ctx.logger.debug(`[Automation] Before execute: ${flowName}`);
-            });
-        }
-
-        ctx.logger.info('[Automation] Engine initialized');
-    }
-
-    async start(ctx: PluginContext): Promise<void> {
-        if (!this.engine) return;
-
-        // Trigger hook to notify engine is ready — other plugins can start registering nodes
-        await ctx.trigger('automation:ready', this.engine);
-
-        const nodeTypes = this.engine.getRegisteredNodeTypes();
-        ctx.logger.info(
-            `[Automation] Engine started with ${nodeTypes.length} node types: ${nodeTypes.join(', ') || '(none)'}`,
-        );
-    }
-
-    async destroy(): Promise<void> {
-        this.engine = undefined;
-    }
-}

package/src/plugins/crud-nodes-plugin.ts

@@ -1,68 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import type { Plugin, PluginContext } from '@objectstack/core';
-import type { AutomationEngine } from '../engine.js';
-
-/**
- * CRUD Node Plugin — Provides get_record / create_record / update_record / delete_record
- *
- * Dependencies: service-automation (engine)
- *
- * In a full runtime environment these nodes would delegate to ObjectQL (data layer).
- * This MVP implementation provides the extension point structure.
- */
-export class CrudNodesPlugin implements Plugin {
-    name = 'com.objectstack.automation.crud-nodes';
-    version = '1.0.0';
-    type = 'standard' as const;
-    dependencies = ['com.objectstack.service-automation'];
-
-    async init(ctx: PluginContext): Promise<void> {
-        const engine = ctx.getService<AutomationEngine>('automation');
-
-        // get_record node executor
-        engine.registerNodeExecutor({
-            type: 'get_record',
-            async execute(node, _variables, _context) {
-                const config = node.config as Record<string, unknown> | undefined;
-                // In production, this would query via ObjectQL:
-                // const ql = ctx.getService('objectql');
-                // const records = await ql.find(config.object, config.filters);
-                return {
-                    success: true,
-                    output: { records: [], object: config?.object },
-                };
-            },
-        });
-
-        // create_record node executor
-        engine.registerNodeExecutor({
-            type: 'create_record',
-            async execute(node, _variables, _context) {
-                const config = node.config as Record<string, unknown> | undefined;
-                return {
-                    success: true,
-                    output: { id: 'new-record-id', object: config?.object },
-                };
-            },
-        });
-
-        // update_record node executor
-        engine.registerNodeExecutor({
-            type: 'update_record',
-            async execute(_node, _variables, _context) {
-                return { success: true };
-            },
-        });
-
-        // delete_record node executor
-        engine.registerNodeExecutor({
-            type: 'delete_record',
-            async execute(_node, _variables, _context) {
-                return { success: true };
-            },
-        });
-
-        ctx.logger.info('[CRUD Nodes] 4 node executors registered');
-    }
-}

package/src/plugins/http-connector-plugin.ts

@@ -1,70 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import type { Plugin, PluginContext } from '@objectstack/core';
-import type { AutomationEngine } from '../engine.js';
-
-/**
- * HTTP + Connector Node Plugin — Provides http_request / connector_action nodes
- *
- * Dependencies: service-automation (engine)
- */
-export class HttpConnectorPlugin implements Plugin {
-    name = 'com.objectstack.automation.http-connector';
-    version = '1.0.0';
-    type = 'standard' as const;
-    dependencies = ['com.objectstack.service-automation'];
-
-    async init(ctx: PluginContext): Promise<void> {
-        const engine = ctx.getService<AutomationEngine>('automation');
-
-        // http_request node executor
-        engine.registerNodeExecutor({
-            type: 'http_request',
-            async execute(node, _variables, _context) {
-                const config = node.config as Record<string, unknown> | undefined;
-                const url = config?.url as string | undefined;
-                const method = (config?.method as string) ?? 'GET';
-                const headers = config?.headers as Record<string, string> | undefined;
-                const body = config?.body;
-
-                if (!url) {
-                    return { success: false, error: 'http_request: url is required' };
-                }
-
-                const response = await fetch(url, {
-                    method,
-                    headers,
-                    body: body ? JSON.stringify(body) : undefined,
-                });
-                const data = await response.json();
-
-                return {
-                    success: response.ok,
-                    output: { response: data, status: response.status },
-                    error: response.ok ? undefined : `HTTP ${response.status}`,
-                };
-            },
-        });
-
-        // connector_action node — calls a registered connector
-        engine.registerNodeExecutor({
-            type: 'connector_action',
-            async execute(node, _variables, _context) {
-                const connectorConfig = node.connectorConfig;
-                if (!connectorConfig) {
-                    return { success: false, error: 'connector_action: connectorConfig is required' };
-                }
-
-                ctx.logger.info(
-                    `Connector action: ${connectorConfig.connectorId}.${connectorConfig.actionId}`,
-                );
-
-                // In production, this would look up the connector from a registry
-                // and execute the specified action with the mapped inputs
-                return { success: true, output: { connectorResult: {} } };
-            },
-        });
-
-        ctx.logger.info('[HTTP Connector] 2 node executors registered');
-    }
-}

package/src/plugins/logic-nodes-plugin.ts

@@ -1,67 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import type { Plugin, PluginContext } from '@objectstack/core';
-import type { AutomationEngine } from '../engine.js';
-
-/**
- * Logic Node Plugin — Provides decision / assignment / loop nodes
- *
- * Dependencies: service-automation (engine)
- */
-export class LogicNodesPlugin implements Plugin {
-    name = 'com.objectstack.automation.logic-nodes';
-    version = '1.0.0';
-    type = 'standard' as const;
-    dependencies = ['com.objectstack.service-automation'];
-
-    async init(ctx: PluginContext): Promise<void> {
-        const engine = ctx.getService<AutomationEngine>('automation');
-
-        // decision node — conditional branching
-        engine.registerNodeExecutor({
-            type: 'decision',
-            async execute(node, variables, _context) {
-                const config = node.config as Record<string, unknown> | undefined;
-                const conditions = (config?.conditions ?? []) as Array<{ label: string; expression: string }>;
-
-                for (const cond of conditions) {
-                    if (engine.evaluateCondition(cond.expression, variables)) {
-                        return { success: true, branchLabel: cond.label };
-                    }
-                }
-                return { success: true, branchLabel: 'default' };
-            },
-        });
-
-        // assignment node — set variables
-        engine.registerNodeExecutor({
-            type: 'assignment',
-            async execute(node, variables, _context) {
-                const config = (node.config ?? {}) as Record<string, unknown>;
-                for (const [key, value] of Object.entries(config)) {
-                    variables.set(key, value);
-                }
-                return { success: true };
-            },
-        });
-
-        // loop node — iterate over a collection
-        engine.registerNodeExecutor({
-            type: 'loop',
-            async execute(node, variables, _context) {
-                const config = node.config as Record<string, unknown> | undefined;
-                const collectionName = config?.collection as string | undefined;
-                if (collectionName) {
-                    const collection = variables.get(collectionName);
-                    if (Array.isArray(collection)) {
-                        variables.set('$loopItems', collection);
-                        variables.set('$loopIndex', 0);
-                    }
-                }
-                return { success: true };
-            },
-        });
-
-        ctx.logger.info('[Logic Nodes] 3 node executors registered');
-    }
-}

package/tsconfig.json

@@ -1,17 +0,0 @@
-{
-  "extends": "../../../tsconfig.json",
-  "compilerOptions": {
-    "outDir": "dist",
-    "rootDir": "src",
-    "types": [
-      "node"
-    ]
-  },
-  "include": [
-    "src"
-  ],
-  "exclude": [
-    "node_modules",
-    "dist"
-  ]
-}