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

package/dist/src/local_engine/storage/BaseKVStoreWrapper.d.ts

@@ -0,0 +1,37 @@
+import { LogManager, LogCategory } from '../../logging/LogManager';
+/**
+ * Abstract base class for KV store wrappers that adapt local stores to BaseKVStore interface.
+ * Eliminates code duplication between LocalSettingsStoreWrapper and LocalSecretsStoreWrapper.
+ */
+export declare abstract class BaseKVStoreWrapper {
+    protected logManager: LogManager;
+    /** Name of the store for logging purposes */
+    protected abstract readonly storeName: string;
+    /** Log category to use for this store */
+    protected abstract readonly logCategory: LogCategory;
+    /**
+     * Get all data for a section/key
+     */
+    protected abstract getSectionData(key: string): Record<string, any>;
+    /**
+     * Update/replace data for a section/key
+     */
+    protected abstract updateSectionData(key: string, value: any): void;
+    /**
+     * Check if a section/key has data
+     */
+    protected abstract hasSectionData(key: string): boolean;
+    /**
+     * Filter an object to only include specified fields
+     */
+    private filterFields;
+    /**
+     * Create log metadata object with proper typing
+     */
+    private logMeta;
+    get(key: string, fields?: string[]): Promise<any>;
+    put(key: string, value: any): Promise<true>;
+    patch(key: string, value: any): Promise<any>;
+    delete(key: string, fields?: string[]): Promise<true>;
+    exists(key: string): Promise<boolean>;
+}

package/dist/src/local_engine/storage/BaseKVStoreWrapper.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseKVStoreWrapper = void 0;
+const LogManager_1 = require("../../logging/LogManager");
+/**
+ * Abstract base class for KV store wrappers that adapt local stores to BaseKVStore interface.
+ * Eliminates code duplication between LocalSettingsStoreWrapper and LocalSecretsStoreWrapper.
+ */
+class BaseKVStoreWrapper {
+    constructor() {
+        this.logManager = LogManager_1.LogManager.getInstance();
+    }
+    /**
+     * Filter an object to only include specified fields
+     */
+    filterFields(data, fields) {
+        const result = {};
+        for (const field of fields) {
+            if (data[field] !== undefined) {
+                result[field] = data[field];
+            }
+        }
+        return result;
+    }
+    /**
+     * Create log metadata object with proper typing
+     */
+    logMeta(key, operation) {
+        return {
+            id: key || 'unknown',
+            store: this.storeName,
+            operation,
+            key
+        };
+    }
+    async get(key, fields) {
+        this.logManager.debug(LogManager_1.LogSource.System, this.logCategory, `GET: key="${key}"`, this.logMeta(key, 'get'));
+        try {
+            const data = this.getSectionData(key);
+            const result = fields?.length ? this.filterFields(data, fields) : data;
+            this.logManager.debug(LogManager_1.LogSource.System, this.logCategory, `GET result: key="${key}"`, this.logMeta(key, 'get'));
+            return result;
+        }
+        catch (error) {
+            this.logManager.error(LogManager_1.LogSource.System, this.logCategory, `GET failed: key="${key}"`, { ...this.logMeta(key, 'get'), error });
+            return {};
+        }
+    }
+    async put(key, value) {
+        this.logManager.debug(LogManager_1.LogSource.System, this.logCategory, `PUT: key="${key}"`, this.logMeta(key, 'set'));
+        try {
+            this.updateSectionData(key, value);
+            this.logManager.debug(LogManager_1.LogSource.System, this.logCategory, `PUT completed: key="${key}"`, this.logMeta(key, 'set'));
+            return true;
+        }
+        catch (error) {
+            this.logManager.error(LogManager_1.LogSource.System, this.logCategory, `PUT failed: key="${key}"`, { ...this.logMeta(key, 'set'), error });
+            return true;
+        }
+    }
+    async patch(key, value) {
+        this.logManager.debug(LogManager_1.LogSource.System, this.logCategory, `PATCH: key="${key}"`, this.logMeta(key, 'set'));
+        try {
+            const currentData = this.getSectionData(key);
+            this.updateSectionData(key, value);
+            this.logManager.debug(LogManager_1.LogSource.System, this.logCategory, `PATCH completed: key="${key}"`, this.logMeta(key, 'set'));
+            return currentData;
+        }
+        catch (error) {
+            this.logManager.error(LogManager_1.LogSource.System, this.logCategory, `PATCH failed: key="${key}"`, { ...this.logMeta(key, 'set'), error });
+            return {};
+        }
+    }
+    async delete(key, fields) {
+        this.logManager.debug(LogManager_1.LogSource.System, this.logCategory, `DELETE: key="${key}", fields=${JSON.stringify(fields)}`, this.logMeta(key, 'delete'));
+        try {
+            if (fields?.length) {
+                const currentData = this.getSectionData(key);
+                for (const field of fields) {
+                    delete currentData[field];
+                }
+                this.updateSectionData(key, currentData);
+                this.logManager.debug(LogManager_1.LogSource.System, this.logCategory, `DELETE completed: removed fields from "${key}"`, this.logMeta(key, 'delete'));
+            }
+            else {
+                this.updateSectionData(key, {});
+                this.logManager.debug(LogManager_1.LogSource.System, this.logCategory, `DELETE completed: cleared "${key}"`, this.logMeta(key, 'clear'));
+            }
+            return true;
+        }
+        catch (error) {
+            this.logManager.error(LogManager_1.LogSource.System, this.logCategory, `DELETE failed: key="${key}"`, { ...this.logMeta(key, 'delete'), error });
+            return true;
+        }
+    }
+    async exists(key) {
+        this.logManager.debug(LogManager_1.LogSource.System, this.logCategory, `EXISTS: key="${key}"`, this.logMeta(key, 'exists'));
+        try {
+            const exists = this.hasSectionData(key);
+            this.logManager.debug(LogManager_1.LogSource.System, this.logCategory, `EXISTS result: key="${key}" -> ${exists}`, this.logMeta(key, 'exists'));
+            return exists;
+        }
+        catch (error) {
+            this.logManager.error(LogManager_1.LogSource.System, this.logCategory, `EXISTS failed: key="${key}"`, { ...this.logMeta(key, 'exists'), error });
+            return false;
+        }
+    }
+}
+exports.BaseKVStoreWrapper = BaseKVStoreWrapper;
+//# sourceMappingURL=BaseKVStoreWrapper.js.map

package/dist/src/local_engine/storage/BaseKVStoreWrapper.js.map

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

package/dist/src/local_engine/storage/LocalConfigStore.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Configuration interface for local app state
+ */
+export interface LocalAppConfig {
+    isInstalled: boolean;
+    functionGuids?: Record<string, string>;
+    sourceGuids?: Record<string, string>;
+}
+/**
+ * Local configuration store that manages app state in .ocp-local/config.json
+ */
+export declare class LocalConfigStore {
+    private logManager;
+    private configPath;
+    private configDirPath;
+    private config;
+    constructor(appRootDir: string);
+    /**
+     * Load configuration from disk or create default if not exists
+     */
+    private loadConfig;
+    /**
+     * Save configuration to disk
+     */
+    private saveConfigToDisk;
+    /**
+     * Get the current configuration
+     */
+    getConfig(): LocalAppConfig;
+    /**
+     * Get the installation status
+     */
+    isInstalled(): boolean;
+    /**
+     * Set the installation status
+     */
+    setInstalled(isInstalled: boolean): void;
+    /**
+     * Update the entire configuration
+     */
+    updateConfig(newConfig: Partial<LocalAppConfig>): void;
+    /**
+     * Reset configuration to defaults
+     */
+    resetConfig(): void;
+    /**
+     * Get or generate a GUID for a function
+     */
+    getFunctionGuid(functionName: string): string;
+    /**
+     * Get all function GUIDs
+     */
+    getAllFunctionGuids(): Record<string, string>;
+    /**
+     * Clear all function GUIDs (useful on uninstall)
+     */
+    clearFunctionGuids(): void;
+    /**
+     * Get or generate a GUID for a source
+     */
+    getSourceGuid(sourceId: string): string;
+    /**
+     * Set a GUID for a source
+     */
+    setSourceGuid(sourceId: string, guid: string): void;
+    /**
+     * Get all source GUIDs
+     */
+    getAllSourceGuids(): Record<string, string>;
+    /**
+     * Clear all source GUIDs (useful on uninstall)
+     */
+    clearSourceGuids(): void;
+}

package/dist/src/local_engine/storage/LocalConfigStore.js

@@ -0,0 +1,178 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalConfigStore = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const crypto_1 = require("crypto");
+const LogManager_1 = require("../../logging/LogManager");
+/**
+ * Default configuration values
+ */
+const DEFAULT_CONFIG = {
+    isInstalled: false,
+    functionGuids: {},
+    sourceGuids: {}
+};
+/**
+ * Local configuration store that manages app state in .ocp-local/config.json
+ */
+class LocalConfigStore {
+    constructor(appRootDir) {
+        this.logManager = LogManager_1.LogManager.getInstance();
+        this.configDirPath = path_1.default.join(appRootDir, '.ocp-local');
+        this.configPath = path_1.default.join(this.configDirPath, 'config.json');
+        this.config = this.loadConfig();
+    }
+    /**
+     * Load configuration from disk or create default if not exists
+     */
+    loadConfig() {
+        try {
+            // Ensure the .ocp-local directory exists
+            if (!fs_1.default.existsSync(this.configDirPath)) {
+                fs_1.default.mkdirSync(this.configDirPath, { recursive: true });
+            }
+            // Load existing config if file exists
+            if (fs_1.default.existsSync(this.configPath)) {
+                const configData = fs_1.default.readFileSync(this.configPath, 'utf-8');
+                const parsedConfig = JSON.parse(configData);
+                // Merge with defaults to ensure all required properties exist
+                return { ...DEFAULT_CONFIG, ...parsedConfig };
+            }
+            // Create default config file
+            this.saveConfigToDisk(DEFAULT_CONFIG);
+            return { ...DEFAULT_CONFIG };
+        }
+        catch (error) {
+            this.logManager.warn(LogManager_1.LogSource.System, LogManager_1.LogCategory.Config, `Failed to load config from ${this.configPath}, using defaults`, {
+                id: 'config',
+                store: 'LocalConfigStore',
+                operation: 'get',
+                error
+            });
+            return { ...DEFAULT_CONFIG };
+        }
+    }
+    /**
+     * Save configuration to disk
+     */
+    saveConfigToDisk(config) {
+        try {
+            // Ensure the .ocp-local directory exists
+            if (!fs_1.default.existsSync(this.configDirPath)) {
+                fs_1.default.mkdirSync(this.configDirPath, { recursive: true });
+            }
+            // Write config to file
+            fs_1.default.writeFileSync(this.configPath, JSON.stringify(config, null, 2), 'utf-8');
+        }
+        catch (error) {
+            this.logManager.error(LogManager_1.LogSource.System, LogManager_1.LogCategory.Config, `Failed to save config to ${this.configPath}`, {
+                id: 'config',
+                store: 'LocalConfigStore',
+                operation: 'set',
+                error
+            });
+            throw error;
+        }
+    }
+    /**
+     * Get the current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Get the installation status
+     */
+    isInstalled() {
+        return this.config.isInstalled;
+    }
+    /**
+     * Set the installation status
+     */
+    setInstalled(isInstalled) {
+        this.config.isInstalled = isInstalled;
+        this.saveConfigToDisk(this.config);
+    }
+    /**
+     * Update the entire configuration
+     */
+    updateConfig(newConfig) {
+        this.config = { ...this.config, ...newConfig };
+        this.saveConfigToDisk(this.config);
+    }
+    /**
+     * Reset configuration to defaults
+     */
+    resetConfig() {
+        this.config = { ...DEFAULT_CONFIG };
+        this.saveConfigToDisk(this.config);
+    }
+    /**
+     * Get or generate a GUID for a function
+     */
+    getFunctionGuid(functionName) {
+        if (!this.config.functionGuids) {
+            this.config.functionGuids = {};
+        }
+        if (!this.config.functionGuids[functionName]) {
+            this.config.functionGuids[functionName] = (0, crypto_1.randomUUID)();
+            this.saveConfigToDisk(this.config);
+        }
+        return this.config.functionGuids[functionName];
+    }
+    /**
+     * Get all function GUIDs
+     */
+    getAllFunctionGuids() {
+        return { ...(this.config.functionGuids || {}) };
+    }
+    /**
+     * Clear all function GUIDs (useful on uninstall)
+     */
+    clearFunctionGuids() {
+        this.config.functionGuids = {};
+        this.saveConfigToDisk(this.config);
+    }
+    /**
+     * Get or generate a GUID for a source
+     */
+    getSourceGuid(sourceId) {
+        if (!this.config.sourceGuids) {
+            this.config.sourceGuids = {};
+        }
+        if (!this.config.sourceGuids[sourceId]) {
+            this.config.sourceGuids[sourceId] = (0, crypto_1.randomUUID)();
+            this.saveConfigToDisk(this.config);
+        }
+        return this.config.sourceGuids[sourceId];
+    }
+    /**
+     * Set a GUID for a source
+     */
+    setSourceGuid(sourceId, guid) {
+        if (!this.config.sourceGuids) {
+            this.config.sourceGuids = {};
+        }
+        this.config.sourceGuids[sourceId] = guid;
+        this.saveConfigToDisk(this.config);
+    }
+    /**
+     * Get all source GUIDs
+     */
+    getAllSourceGuids() {
+        return { ...(this.config.sourceGuids || {}) };
+    }
+    /**
+     * Clear all source GUIDs (useful on uninstall)
+     */
+    clearSourceGuids() {
+        this.config.sourceGuids = {};
+        this.saveConfigToDisk(this.config);
+    }
+}
+exports.LocalConfigStore = LocalConfigStore;
+//# sourceMappingURL=LocalConfigStore.js.map

package/dist/src/local_engine/storage/LocalConfigStore.js.map

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

package/dist/src/local_engine/storage/LocalJobStore.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Job execution status enum
+ */
+export declare enum JobExecutionStatus {
+    PENDING = "pending",
+    RUNNING = "running",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    INTERRUPTED = "interrupted"
+}
+/**
+ * Job execution record
+ */
+export interface JobExecution {
+    id: string;
+    jobId: string;
+    status: JobExecutionStatus;
+    startedAt: Date;
+    completedAt?: Date;
+    parameters: Record<string, any>;
+    error?: {
+        message: string;
+        stack?: string;
+    };
+    executionTime?: number;
+    stateCount: number;
+}
+/**
+ * Job state snapshot
+ */
+export interface JobStateSnapshot {
+    id: string;
+    executionId: string;
+    timestamp: Date;
+    state: Record<string, any>;
+    complete: boolean;
+    stateHash: string;
+    phase: 'prepare' | 'perform';
+}
+/**
+ * Local storage for job executions and state history
+ */
+export declare class LocalJobStore {
+    private appDir;
+    private logManager;
+    private static instances;
+    private jobsDir;
+    private executionsDir;
+    private statesDir;
+    private constructor();
+    /**
+     * Get singleton instance for the given app directory
+     */
+    static getInstance(appDir: string): LocalJobStore;
+    /**
+     * Ensure required directories exist
+     */
+    private ensureDirectories;
+    /**
+     * Create a new job execution record
+     */
+    createExecution(jobId: string, parameters?: Record<string, any>): JobExecution;
+    /**
+     * Update job execution status
+     */
+    updateExecutionStatus(executionId: string, status: JobExecutionStatus, error?: {
+        message: string;
+        stack?: string;
+    }): void;
+    /**
+     * Save job state snapshot
+     */
+    saveState(executionId: string, state: Record<string, any>, complete: boolean, stateHash: string, phase: 'prepare' | 'perform'): JobStateSnapshot;
+    /**
+     * Get job execution by ID
+     */
+    getExecution(executionId: string): JobExecution | null;
+    /**
+     * Get all executions, optionally filtered by job ID
+     */
+    getExecutions(jobId?: string): JobExecution[];
+    /**
+     * Get state snapshots for an execution
+     */
+    getExecutionStates(executionId: string): JobStateSnapshot[];
+    /**
+     * Get latest state for an execution
+     */
+    getLatestState(executionId: string): JobStateSnapshot | null;
+    /**
+     * Save execution to disk
+     */
+    private saveExecution;
+    /**
+     * Clean up old executions (7 days retention)
+     */
+    cleanup(): void;
+    /**
+     * Delete execution and its states
+     */
+    private deleteExecution;
+    /**
+     * Get summary statistics
+     */
+    getStats(): {
+        totalExecutions: number;
+        runningExecutions: number;
+        completedExecutions: number;
+        failedExecutions: number;
+    };
+}