@optimizely/ocp-local-env 1.0.0-beta.4

package/dist/src/local_engine/local-engine-client.js

@@ -0,0 +1,333 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalEngineClient = void 0;
+/**
+ * IPC Client for managing child process communication
+ */
+const child_process_1 = require("child_process");
+const path_1 = __importDefault(require("path"));
+const local_engine_utils_1 = require("./local-engine-utils");
+class LocalEngineClient {
+    constructor() {
+        this.connections = new Map();
+    }
+    /**
+     * Get or create a connection for the specified app
+     */
+    async getConnection(appConfig, appDir) {
+        const connectionKey = appConfig.manifest.meta?.app_id || 'unknown';
+        let connection = this.connections.get(connectionKey);
+        // Check if existing connection is healthy
+        if (connection && (0, local_engine_utils_1.isConnectionHealthy)(connection)) {
+            connection.lastActivity = Date.now();
+            return connection;
+        }
+        // Clean up old connection if it exists
+        if (connection) {
+            await this.closeConnection(connectionKey);
+        }
+        // Create new connection
+        connection = await this.createConnection(appConfig, appDir);
+        this.connections.set(connectionKey, connection);
+        return connection;
+    }
+    /**
+     * Create a new IPC connection using the unified wrapper
+     */
+    async createConnection(appConfig, appDir) {
+        const wrapperScript = path_1.default.join(__dirname, 'local-engine-unified.js');
+        console.log(`[IPC Client] Starting unified wrapper for app ${appConfig.manifest.meta?.app_id}: ${wrapperScript}`);
+        const childProcess = (0, child_process_1.spawn)('node', [wrapperScript], {
+            cwd: appDir,
+            stdio: ['pipe', 'pipe', 'pipe', 'ipc'],
+            env: { ...process.env }
+        });
+        const connection = {
+            process: childProcess,
+            ready: false,
+            pendingRequests: new Map(),
+            lastActivity: Date.now()
+        };
+        // Set up message handling
+        this.setupMessageHandlers(connection);
+        // Set up error handling
+        this.setupErrorHandlers(connection);
+        // Initialize the child process
+        await this.initializeChild(connection, appConfig, appDir);
+        return connection;
+    }
+    /**
+     * Set up message handlers for a connection
+     */
+    setupMessageHandlers(connection) {
+        connection.process.on('message', (message) => {
+            try {
+                (0, local_engine_utils_1.logIPCMessage)('RECV', message, '[IPC Client]');
+                if (!(0, local_engine_utils_1.validateMessage)(message)) {
+                    console.error('[IPC Client] Received invalid message:', message);
+                    return;
+                }
+                this.handleChildMessage(connection, message);
+            }
+            catch (error) {
+                console.error('[IPC Client] Error handling child message:', error);
+            }
+        });
+        // Handle stdout/stderr for debugging
+        connection.process.stdout?.on('data', (data) => {
+            const output = data.toString().trim();
+            if (output) {
+                console.log(`[IPC Child STDOUT] ${output}`);
+            }
+        });
+        connection.process.stderr?.on('data', (data) => {
+            const error = data.toString().trim();
+            if (error) {
+                console.error(`[IPC Child STDERR] ${error}`);
+            }
+        });
+    }
+    /**
+     * Set up error handlers for a connection
+     */
+    setupErrorHandlers(connection) {
+        connection.process.on('error', (error) => {
+            console.error('[IPC Client] Child process error:', error);
+            this.handleConnectionError(connection, error);
+        });
+        connection.process.on('exit', (code, signal) => {
+            console.log(`[IPC Client] Child process exited with code ${code}, signal ${signal}`);
+            this.handleConnectionExit(connection, code, signal);
+        });
+        connection.process.on('close', () => {
+            console.log('[IPC Client] Child process closed');
+            connection.ready = false;
+        });
+    }
+    /**
+     * Handle messages from child process
+     */
+    handleChildMessage(connection, message) {
+        connection.lastActivity = Date.now();
+        switch (message.type) {
+            case 'ready':
+                this.handleReadyMessage(connection);
+                break;
+            case 'progress':
+                this.handleProgressMessage(connection, message);
+                break;
+            case 'log':
+                this.handleLogMessage(connection, message);
+                break;
+            case 'success':
+                this.handleSuccessMessage(connection, message);
+                break;
+            case 'error':
+                this.handleErrorMessage(connection, message);
+                break;
+            default:
+                console.warn(`[IPC Client] Unknown message type: ${message.type}`);
+        }
+    }
+    /**
+     * Handle ready message from child
+     */
+    handleReadyMessage(connection) {
+        console.log('[IPC Client] Child process is ready');
+        connection.ready = true;
+    }
+    /**
+     * Handle progress message from child
+     */
+    handleProgressMessage(connection, message) {
+        const { requestId, message: progressMsg, progress } = message.data;
+        console.log(`[IPC Client] Progress for ${requestId}: ${progressMsg} (${progress || 'N/A'}%)`);
+    }
+    /**
+     * Handle log message from child
+     */
+    handleLogMessage(connection, message) {
+        const { level, message: logMsg, requestId } = message.data;
+        const prefix = requestId ? `[${requestId.slice(0, 8)}]` : '[IPC Child]';
+        console.log(`${prefix} [${level.toUpperCase()}] ${logMsg}`);
+    }
+    /**
+     * Handle success message from child
+     */
+    handleSuccessMessage(connection, message) {
+        const { requestId, result } = message.data;
+        const pendingRequest = connection.pendingRequests.get(requestId);
+        if (pendingRequest) {
+            (0, local_engine_utils_1.cleanupPendingRequest)(pendingRequest);
+            connection.pendingRequests.delete(requestId);
+            pendingRequest.resolve(result);
+        }
+        else {
+            console.warn(`[IPC Client] Received success for unknown request: ${requestId}`);
+        }
+    }
+    /**
+     * Handle error message from child
+     */
+    handleErrorMessage(connection, message) {
+        const { requestId, error: errorMsg, stack } = message.data;
+        const pendingRequest = connection.pendingRequests.get(requestId);
+        if (pendingRequest) {
+            (0, local_engine_utils_1.cleanupPendingRequest)(pendingRequest);
+            connection.pendingRequests.delete(requestId);
+            const error = (0, local_engine_utils_1.deserializeError)({ message: errorMsg, stack });
+            pendingRequest.reject(error);
+        }
+        else {
+            console.warn(`[IPC Client] Received error for unknown request: ${requestId} - ${errorMsg}`);
+        }
+    }
+    /**
+     * Handle connection errors
+     */
+    handleConnectionError(connection, error) {
+        console.error('[IPC Client] Connection error:', error);
+        // Reject all pending requests
+        for (const [requestId, pendingRequest] of connection.pendingRequests) {
+            (0, local_engine_utils_1.cleanupPendingRequest)(pendingRequest);
+            pendingRequest.reject(new Error(`Connection error: ${error.message}`));
+        }
+        connection.pendingRequests.clear();
+        connection.ready = false;
+    }
+    /**
+     * Handle connection exit
+     */
+    handleConnectionExit(connection, code, signal) {
+        // Reject all pending requests
+        for (const [requestId, pendingRequest] of connection.pendingRequests) {
+            (0, local_engine_utils_1.cleanupPendingRequest)(pendingRequest);
+            pendingRequest.reject(new Error(`Child process exited with code ${code}, signal ${signal}`));
+        }
+        connection.pendingRequests.clear();
+        connection.ready = false;
+    }
+    /**
+     * Initialize child process
+     */
+    async initializeChild(connection, appConfig, appDir) {
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                reject(new Error('Child process initialization timeout'));
+            }, local_engine_utils_1.IPC_CONFIG.DEFAULT_TIMEOUT);
+            const checkReady = () => {
+                if (connection.ready) {
+                    clearTimeout(timeout);
+                    resolve();
+                }
+                else {
+                    setTimeout(checkReady, 100);
+                }
+            };
+            // Send initialization message
+            const initMessage = {
+                ...(0, local_engine_utils_1.createBaseMessage)('initialize'),
+                type: 'initialize',
+                data: { appConfig, appDir }
+            };
+            (0, local_engine_utils_1.sendIPCMessage)(connection.process, initMessage);
+            (0, local_engine_utils_1.logIPCMessage)('SEND', initMessage, '[IPC Client]');
+            checkReady();
+        });
+    }
+    /**
+     * Send a request and wait for response
+     */
+    async sendRequest(connection, message, timeoutMs = local_engine_utils_1.IPC_CONFIG.DEFAULT_TIMEOUT) {
+        return new Promise((resolve, reject) => {
+            const pendingRequest = (0, local_engine_utils_1.createPendingRequest)(message.id, message.type === 'execute_function' ? 'function' : 'lifecycle', resolve, reject, timeoutMs);
+            // Set up timeout
+            pendingRequest.timeout = (0, local_engine_utils_1.createRequestTimeout)(message.id, timeoutMs, reject, () => connection.pendingRequests.delete(message.id));
+            // Track the request
+            connection.pendingRequests.set(message.id, pendingRequest);
+            // Send the message
+            (0, local_engine_utils_1.logIPCMessage)('SEND', message, '[IPC Client]');
+            if (!(0, local_engine_utils_1.sendIPCMessage)(connection.process, message)) {
+                (0, local_engine_utils_1.cleanupPendingRequest)(pendingRequest);
+                connection.pendingRequests.delete(message.id);
+                reject(new Error('Failed to send IPC message'));
+            }
+        });
+    }
+    /**
+     * Execute a function using IPC
+     */
+    async executeFunction(request, appConfig, appDir) {
+        const connection = await this.getConnection(appConfig, appDir);
+        const message = {
+            ...(0, local_engine_utils_1.createBaseMessage)('execute_function'),
+            type: 'execute_function',
+            data: request
+        };
+        return this.sendRequest(connection, message);
+    }
+    /**
+     * Execute a lifecycle method using IPC
+     */
+    async executeLifecycle(request, appConfig, appDir) {
+        const connection = await this.getConnection(appConfig, appDir);
+        const message = {
+            ...(0, local_engine_utils_1.createBaseMessage)('execute_lifecycle'),
+            type: 'execute_lifecycle',
+            data: request
+        };
+        return this.sendRequest(connection, message);
+    }
+    /**
+     * Execute a job using IPC
+     */
+    async executeJob(request, appConfig, appDir) {
+        const connection = await this.getConnection(appConfig, appDir);
+        const message = {
+            ...(0, local_engine_utils_1.createBaseMessage)('execute_job'),
+            type: 'execute_job',
+            data: request
+        };
+        return this.sendRequest(connection, message);
+    }
+    /**
+     * Close a specific connection
+     */
+    async closeConnection(connectionKey) {
+        const connection = this.connections.get(connectionKey);
+        if (!connection)
+            return;
+        try {
+            // Send shutdown message
+            const shutdownMessage = {
+                ...(0, local_engine_utils_1.createBaseMessage)('shutdown'),
+                type: 'shutdown'
+            };
+            (0, local_engine_utils_1.sendIPCMessage)(connection.process, shutdownMessage);
+            // Wait a bit for graceful shutdown
+            await new Promise(resolve => setTimeout(resolve, 1000));
+            // Force kill if still running
+            if (!connection.process.killed) {
+                connection.process.kill('SIGTERM');
+            }
+        }
+        catch (error) {
+            console.warn(`[IPC Client] Error during connection shutdown: ${error}`);
+        }
+        finally {
+            this.connections.delete(connectionKey);
+        }
+    }
+    /**
+     * Close all connections
+     */
+    async closeAllConnections() {
+        const closePromises = Array.from(this.connections.keys()).map(key => this.closeConnection(key));
+        await Promise.all(closePromises);
+    }
+}
+exports.LocalEngineClient = LocalEngineClient;
+//# sourceMappingURL=local-engine-client.js.map

package/dist/src/local_engine/local-engine-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-engine-client.js","sourceRoot":"","sources":["../../../src/local_engine/local-engine-client.ts"],"names":[],"mappings":"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"}

package/dist/src/local_engine/local-engine-types.d.ts

@@ -0,0 +1,132 @@
+/**
+ * IPC Message Types and Schemas for Parent-Child Communication
+ */
+/// <reference types="node" />
+export interface FunctionExecutionRequest {
+    functionId: string;
+    method: string;
+    fullpath: string;
+    path: string;
+    params: Record<string, any>;
+    headers: [string, string][];
+    body: any;
+}
+export interface LifecycleExecutionRequest {
+    method: string;
+    params?: any;
+    scriptPath: string;
+    appDir: string;
+}
+export interface JobExecutionRequest {
+    jobId: string;
+    parameters?: Record<string, any>;
+    dataSyncId?: string;
+    sourceKey?: string;
+    executionId: string;
+    appDir: string;
+}
+export interface AppConfig {
+    manifest: any;
+    path: string;
+    isBuilt: boolean;
+    isValid: boolean;
+}
+export interface IPCMessage {
+    id: string;
+    type: string;
+    timestamp: number;
+}
+export interface InitializeMessage extends IPCMessage {
+    type: 'initialize';
+    data: {
+        appConfig: AppConfig;
+        appDir: string;
+    };
+}
+export interface ExecuteFunctionMessage extends IPCMessage {
+    type: 'execute_function';
+    data: FunctionExecutionRequest;
+}
+export interface ExecuteLifecycleMessage extends IPCMessage {
+    type: 'execute_lifecycle';
+    data: LifecycleExecutionRequest;
+}
+export interface ExecuteJobMessage extends IPCMessage {
+    type: 'execute_job';
+    data: JobExecutionRequest;
+}
+export interface ShutdownMessage extends IPCMessage {
+    type: 'shutdown';
+}
+export interface CancelMessage extends IPCMessage {
+    type: 'cancel';
+    data: {
+        cancelId: string;
+    };
+}
+export type ParentMessage = InitializeMessage | ExecuteFunctionMessage | ExecuteLifecycleMessage | ExecuteJobMessage | ShutdownMessage | CancelMessage;
+export interface ReadyMessage extends IPCMessage {
+    type: 'ready';
+}
+export interface ProgressMessage extends IPCMessage {
+    type: 'progress';
+    data: {
+        requestId: string;
+        message: string;
+        progress?: number;
+    };
+}
+export interface LogMessage extends IPCMessage {
+    type: 'log';
+    data: {
+        requestId?: string;
+        level: 'debug' | 'info' | 'warn' | 'error';
+        message: string;
+        timestamp: number;
+    };
+}
+export interface SuccessMessage extends IPCMessage {
+    type: 'success';
+    data: {
+        requestId: string;
+        result: any;
+        executionTime: number;
+    };
+}
+export interface ErrorMessage extends IPCMessage {
+    type: 'error';
+    data: {
+        requestId: string;
+        error: string;
+        stack?: string;
+        executionTime: number;
+    };
+}
+export interface FunctionSuccessMessage extends SuccessMessage {
+    data: SuccessMessage['data'] & {
+        status: number;
+        headers: [string, string][];
+        body: any;
+    };
+}
+export interface LifecycleSuccessMessage extends SuccessMessage {
+    data: SuccessMessage['data'] & {
+        result: any;
+    };
+}
+export type ChildMessage = ReadyMessage | ProgressMessage | LogMessage | SuccessMessage | ErrorMessage | FunctionSuccessMessage | LifecycleSuccessMessage;
+export type IPCMessageUnion = ParentMessage | ChildMessage;
+export interface PendingRequest {
+    id: string;
+    type: 'function' | 'lifecycle';
+    startTime: number;
+    resolve: (result: any) => void;
+    reject: (error: Error) => void;
+    timeout?: NodeJS.Timeout;
+}
+export interface IPCConnection {
+    process: any;
+    ready: boolean;
+    pendingRequests: Map<string, PendingRequest>;
+    lastActivity: number;
+}

package/dist/src/local_engine/local-engine-types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * IPC Message Types and Schemas for Parent-Child Communication
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=local-engine-types.js.map

package/dist/src/local_engine/local-engine-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-engine-types.js","sourceRoot":"","sources":["../../../src/local_engine/local-engine-types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/src/local_engine/local-engine-unified.d.ts

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+/**
+ * Local Engine Unified
+ *
+ * This script runs in the app's Node.js process context and executes both OCP functions
+ * and lifecycle methods using IPC communication with the parent process.
+ * This is a single, persistent process that handles all app execution requests.
+ */
+import { LocalEngineChildBase } from './local-engine-child-base';
+import { AppConfig, FunctionExecutionRequest, LifecycleExecutionRequest, JobExecutionRequest } from './local-engine-types';
+export declare class LocalEngineUnified extends LocalEngineChildBase {
+    private sdkComponents;
+    private configureLocalSDKs;
+    private cleanUpLocalSDKs;
+    private LocalSettingsStore;
+    private LocalConfigStore;
+    private isInitialized;
+    /**
+     * Initialize the wrapper with app configuration
+     * This happens once when the process starts
+     */
+    protected initialize(appConfig: AppConfig, appDir: string): Promise<void>;
+    /**
+     * Execute a function with the given request
+     */
+    protected executeFunction(request: FunctionExecutionRequest): Promise<any>;
+    /**
+     * Execute a lifecycle method with the given request
+     */
+    protected executeLifecycle(request: LifecycleExecutionRequest): Promise<any>;
+    /**
+     * Execute a job with the given request
+     */
+    protected executeJob(request: JobExecutionRequest): Promise<any>;
+    /**
+     * Clean up SDK configuration
+     * This only happens when the process is shutting down
+     */
+    protected cleanup(): Promise<void>;
+}