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

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

@@ -0,0 +1,56 @@
+/**
+ * Configuration interface for local app state
+ */
+export interface LocalAppConfig {
+    isInstalled: boolean;
+    functionGuids?: Record<string, string>;
+}
+/**
+ * Local configuration store that manages app state in .ocp-local/config.json
+ */
+export declare class LocalConfigStore {
+    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;
+}

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

@@ -0,0 +1,129 @@
+"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");
+/**
+ * Default configuration values
+ */
+const DEFAULT_CONFIG = {
+    isInstalled: false,
+    functionGuids: {}
+};
+/**
+ * Local configuration store that manages app state in .ocp-local/config.json
+ */
+class LocalConfigStore {
+    constructor(appRootDir) {
+        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) {
+            console.warn(`Failed to load config from ${this.configPath}, using defaults:`, 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) {
+            console.error(`Failed to save config to ${this.configPath}:`, 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);
+    }
+}
+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,110 @@
+/**
+ * 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 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;
+    };
+}

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

@@ -0,0 +1,239 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalJobStore = exports.JobExecutionStatus = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const crypto_1 = require("crypto");
+/**
+ * Job execution status enum
+ */
+var JobExecutionStatus;
+(function (JobExecutionStatus) {
+    JobExecutionStatus["PENDING"] = "pending";
+    JobExecutionStatus["RUNNING"] = "running";
+    JobExecutionStatus["COMPLETED"] = "completed";
+    JobExecutionStatus["FAILED"] = "failed";
+    JobExecutionStatus["INTERRUPTED"] = "interrupted";
+})(JobExecutionStatus = exports.JobExecutionStatus || (exports.JobExecutionStatus = {}));
+/**
+ * Local storage for job executions and state history
+ */
+class LocalJobStore {
+    constructor(appDir) {
+        this.appDir = appDir;
+        this.jobsDir = path_1.default.join(appDir, '.ocp-local', 'jobs');
+        this.executionsDir = path_1.default.join(this.jobsDir, 'executions');
+        this.statesDir = path_1.default.join(this.jobsDir, 'states');
+        this.ensureDirectories();
+    }
+    /**
+     * Get singleton instance for the given app directory
+     */
+    static getInstance(appDir) {
+        if (!this.instances.has(appDir)) {
+            this.instances.set(appDir, new LocalJobStore(appDir));
+        }
+        return this.instances.get(appDir);
+    }
+    /**
+     * Ensure required directories exist
+     */
+    ensureDirectories() {
+        [this.jobsDir, this.executionsDir, this.statesDir].forEach(dir => {
+            if (!fs_1.default.existsSync(dir)) {
+                fs_1.default.mkdirSync(dir, { recursive: true });
+            }
+        });
+    }
+    /**
+     * Create a new job execution record
+     */
+    createExecution(jobId, parameters = {}) {
+        const execution = {
+            id: (0, crypto_1.randomUUID)(),
+            jobId,
+            status: JobExecutionStatus.PENDING,
+            startedAt: new Date(),
+            parameters,
+            stateCount: 0
+        };
+        this.saveExecution(execution);
+        return execution;
+    }
+    /**
+     * Update job execution status
+     */
+    updateExecutionStatus(executionId, status, error) {
+        const execution = this.getExecution(executionId);
+        if (!execution) {
+            throw new Error(`Execution not found: ${executionId}`);
+        }
+        execution.status = status;
+        if (error) {
+            execution.error = error;
+        }
+        if (status === JobExecutionStatus.COMPLETED || status === JobExecutionStatus.FAILED || status === JobExecutionStatus.INTERRUPTED) {
+            execution.completedAt = new Date();
+            execution.executionTime = execution.completedAt.getTime() - execution.startedAt.getTime();
+        }
+        this.saveExecution(execution);
+    }
+    /**
+     * Save job state snapshot
+     */
+    saveState(executionId, state, complete, stateHash, phase) {
+        const snapshot = {
+            id: (0, crypto_1.randomUUID)(),
+            executionId,
+            timestamp: new Date(),
+            state,
+            complete,
+            stateHash,
+            phase
+        };
+        // Create execution state directory if it doesn't exist
+        const executionStatesDir = path_1.default.join(this.statesDir, executionId);
+        if (!fs_1.default.existsSync(executionStatesDir)) {
+            fs_1.default.mkdirSync(executionStatesDir, { recursive: true });
+        }
+        // Save state snapshot
+        const stateFile = path_1.default.join(executionStatesDir, `state-${snapshot.timestamp.getTime()}.json`);
+        fs_1.default.writeFileSync(stateFile, JSON.stringify(snapshot, null, 2));
+        // Update state count in execution
+        const execution = this.getExecution(executionId);
+        if (execution) {
+            execution.stateCount++;
+            this.saveExecution(execution);
+        }
+        return snapshot;
+    }
+    /**
+     * Get job execution by ID
+     */
+    getExecution(executionId) {
+        const executionFile = path_1.default.join(this.executionsDir, `${executionId}.json`);
+        if (!fs_1.default.existsSync(executionFile)) {
+            return null;
+        }
+        try {
+            const data = JSON.parse(fs_1.default.readFileSync(executionFile, 'utf8'));
+            // Convert date strings back to Date objects
+            data.startedAt = new Date(data.startedAt);
+            if (data.completedAt) {
+                data.completedAt = new Date(data.completedAt);
+            }
+            return data;
+        }
+        catch (error) {
+            console.error(`Error reading execution file ${executionFile}:`, error);
+            return null;
+        }
+    }
+    /**
+     * Get all executions, optionally filtered by job ID
+     */
+    getExecutions(jobId) {
+        if (!fs_1.default.existsSync(this.executionsDir)) {
+            return [];
+        }
+        const executions = [];
+        const files = fs_1.default.readdirSync(this.executionsDir);
+        for (const file of files) {
+            if (file.endsWith('.json')) {
+                const executionId = file.replace('.json', '');
+                const execution = this.getExecution(executionId);
+                if (execution && (!jobId || execution.jobId === jobId)) {
+                    executions.push(execution);
+                }
+            }
+        }
+        // Sort by start time (newest first)
+        return executions.sort((a, b) => b.startedAt.getTime() - a.startedAt.getTime());
+    }
+    /**
+     * Get state snapshots for an execution
+     */
+    getExecutionStates(executionId) {
+        const executionStatesDir = path_1.default.join(this.statesDir, executionId);
+        if (!fs_1.default.existsSync(executionStatesDir)) {
+            return [];
+        }
+        const states = [];
+        const files = fs_1.default.readdirSync(executionStatesDir);
+        for (const file of files) {
+            if (file.endsWith('.json')) {
+                try {
+                    const stateFile = path_1.default.join(executionStatesDir, file);
+                    const data = JSON.parse(fs_1.default.readFileSync(stateFile, 'utf8'));
+                    data.timestamp = new Date(data.timestamp);
+                    states.push(data);
+                }
+                catch (error) {
+                    console.error(`Error reading state file ${file}:`, error);
+                }
+            }
+        }
+        // Sort by timestamp (oldest first)
+        return states.sort((a, b) => a.timestamp.getTime() - b.timestamp.getTime());
+    }
+    /**
+     * Get latest state for an execution
+     */
+    getLatestState(executionId) {
+        const states = this.getExecutionStates(executionId);
+        return states.length > 0 ? states[states.length - 1] : null;
+    }
+    /**
+     * Save execution to disk
+     */
+    saveExecution(execution) {
+        const executionFile = path_1.default.join(this.executionsDir, `${execution.id}.json`);
+        fs_1.default.writeFileSync(executionFile, JSON.stringify(execution, null, 2));
+    }
+    /**
+     * Clean up old executions (7 days retention)
+     */
+    cleanup() {
+        const retentionMs = 7 * 24 * 60 * 60 * 1000; // 7 days
+        const cutoff = new Date(Date.now() - retentionMs);
+        const executions = this.getExecutions();
+        for (const execution of executions) {
+            if (execution.startedAt < cutoff) {
+                this.deleteExecution(execution.id);
+            }
+        }
+    }
+    /**
+     * Delete execution and its states
+     */
+    deleteExecution(executionId) {
+        // Delete execution file
+        const executionFile = path_1.default.join(this.executionsDir, `${executionId}.json`);
+        if (fs_1.default.existsSync(executionFile)) {
+            fs_1.default.unlinkSync(executionFile);
+        }
+        // Delete state directory
+        const executionStatesDir = path_1.default.join(this.statesDir, executionId);
+        if (fs_1.default.existsSync(executionStatesDir)) {
+            fs_1.default.rmSync(executionStatesDir, { recursive: true, force: true });
+        }
+    }
+    /**
+     * Get summary statistics
+     */
+    getStats() {
+        const executions = this.getExecutions();
+        return {
+            totalExecutions: executions.length,
+            runningExecutions: executions.filter(e => e.status === JobExecutionStatus.RUNNING).length,
+            completedExecutions: executions.filter(e => e.status === JobExecutionStatus.COMPLETED).length,
+            failedExecutions: executions.filter(e => e.status === JobExecutionStatus.FAILED).length
+        };
+    }
+}
+exports.LocalJobStore = LocalJobStore;
+LocalJobStore.instances = new Map();
+//# sourceMappingURL=LocalJobStore.js.map

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

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

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

@@ -0,0 +1,105 @@
+import { KVStore, KVHash, KVRowOptions, KVPatchUpdater, MultiValue, Value } from '../../types/kvstore';
+import { NumberSet } from './NumberSet';
+import { StringSet } from './StringSet';
+/**
+ * Local implementation of KVStore that persists data to disk
+ * Follows the pattern of LocalSettingsStore with singleton per app directory
+ */
+export declare class LocalKVStore implements KVStore {
+    private static instances;
+    private kvStorePath;
+    private configDirPath;
+    private appRootDir;
+    private storeFileName;
+    private constructor();
+    /**
+     * Get or create a singleton instance for the given app directory
+     */
+    static getInstance(appRootDir: string, storeFileName?: string): LocalKVStore;
+    /**
+     * Clear singleton instance for testing
+     */
+    static clearInstance(appRootDir: string, storeFileName?: string): void;
+    /**
+     * Clear all singleton instances for testing
+     */
+    static clearAllInstances(): void;
+    /**
+     * Ensure store file exists with empty structure
+     */
+    private ensureStoreFileExists;
+    /**
+     * Load data from disk and clean up expired entries
+     */
+    private loadDataFromDisk;
+    /**
+     * Save data to disk atomically
+     */
+    private saveDataToDisk;
+    /**
+     * Deserialize data with custom handling for NumberSet and StringSet
+     */
+    private deserializeValue;
+    /**
+     * Get stored item with deserialization
+     */
+    private getStoredItem;
+    /**
+     * Store item with optional TTL
+     */
+    private storeItem;
+    get<T extends KVHash>(key: string, fields?: string[]): Promise<T>;
+    put<T extends KVHash>(key: string, value: T, options?: KVRowOptions): Promise<T>;
+    patch<T extends KVHash>(key: string, value: T, options?: KVRowOptions): Promise<T>;
+    patch<T extends KVHash>(key: string, updater: KVPatchUpdater<T>, options?: KVRowOptions): Promise<T>;
+    delete<T extends KVHash>(key: string, fields?: string[]): Promise<T>;
+    exists(key: string): Promise<boolean>;
+    increment(key: string, field: string, amount?: number, options?: KVRowOptions): Promise<number>;
+    incrementMulti(key: string, fieldAmounts: MultiValue<number>, options?: KVRowOptions): Promise<MultiValue<number>>;
+    shift<T extends Value>(key: string, field: string): Promise<T | undefined>;
+    shiftMulti<T extends Value>(key: string, fieldCounts: MultiValue<number>): Promise<MultiValue<T[]>>;
+    unshift<T extends Value>(key: string, field: string, value: T): Promise<void>;
+    unshiftMulti<T extends Value>(key: string, fieldValues: MultiValue<T[]>): Promise<void>;
+    peek<T extends Value>(key: string, field: string): Promise<T | undefined>;
+    peekMulti<T extends Value>(key: string, fieldCounts: MultiValue<number>): Promise<MultiValue<T[]>>;
+    append<T extends Value>(key: string, field: string, value: T): Promise<void>;
+    appendMulti<T extends Value>(key: string, fieldValues: MultiValue<T[]>): Promise<void>;
+    addNumber(key: string, field: string, value: number): Promise<boolean>;
+    addNumberMulti(key: string, fieldValues: MultiValue<number[]>): Promise<MultiValue<NumberSet>>;
+    removeNumber(key: string, field: string, value: number): Promise<boolean>;
+    removeNumberMulti(key: string, fieldValues: MultiValue<number[]>): Promise<MultiValue<NumberSet>>;
+    hasNumber(key: string, field: string, value: number): Promise<boolean>;
+    hasNumberMulti(key: string, fieldValues: MultiValue<number[]>): Promise<MultiValue<NumberSet>>;
+    addString(key: string, field: string, value: string): Promise<boolean>;
+    addStringMulti(key: string, fieldValues: MultiValue<string[]>): Promise<MultiValue<StringSet>>;
+    removeString(key: string, field: string, value: string): Promise<boolean>;
+    removeStringMulti(key: string, fieldValues: MultiValue<string[]>): Promise<MultiValue<StringSet>>;
+    hasString(key: string, field: string, value: string): Promise<boolean>;
+    hasStringMulti(key: string, fieldValues: MultiValue<string[]>): Promise<MultiValue<StringSet>>;
+    /**
+     * Get all stored data as a simple key-value object for the UI
+     */
+    getAllData(): {
+        [key: string]: any;
+    };
+    /**
+     * Set a simple key-value pair (for UI convenience)
+     */
+    set(key: string, value: any): Promise<void>;
+    /**
+     * Get a simple value by key (for UI convenience)
+     */
+    getValue(key: string): Promise<any>;
+    /**
+     * Delete a key entirely (for UI convenience)
+     */
+    deleteKey(key: string): Promise<boolean>;
+    /**
+     * Get all keys
+     */
+    getAllKeys(): string[];
+    /**
+     * Get a shared instance for shared KV store (global across installations of the same app)
+     */
+    static getSharedInstance(appRootDir: string): LocalKVStore;
+}