@enactprotocol/shared 2.0.0 → 2.0.2

package/dist/utils/fs.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @enactprotocol/shared - File system helpers
+ *
+ * Provides utilities for common filesystem operations.
+ */
+/**
+ * Ensure a directory exists, creating it if necessary
+ */
+export declare function ensureDir(dirPath: string): void;
+/**
+ * Ensure the parent directory of a file exists
+ */
+export declare function ensureParentDir(filePath: string): void;
+/**
+ * Check if a path exists
+ */
+export declare function pathExists(path: string): boolean;
+/**
+ * Check if a path is a directory
+ */
+export declare function isDirectory(path: string): boolean;
+/**
+ * Check if a path is a file
+ */
+export declare function isFile(path: string): boolean;
+/**
+ * Read and parse a JSON file
+ * @throws Error if file doesn't exist or isn't valid JSON
+ */
+export declare function readJsonFile<T = unknown>(filePath: string): T;
+/**
+ * Try to read and parse a JSON file
+ * @returns The parsed JSON or null if file doesn't exist or is invalid
+ */
+export declare function tryReadJsonFile<T = unknown>(filePath: string): T | null;
+/**
+ * Write data to a JSON file with formatting
+ */
+export declare function writeJsonFile(filePath: string, data: unknown, options?: {
+    indent?: number | undefined;
+}): void;
+/**
+ * Read a text file
+ */
+export declare function readTextFile(filePath: string): string;
+/**
+ * Try to read a text file
+ * @returns The file content or null if file doesn't exist
+ */
+export declare function tryReadTextFile(filePath: string): string | null;
+/**
+ * Write content to a text file
+ */
+export declare function writeTextFile(filePath: string, content: string): void;
+/**
+ * Copy a file
+ */
+export declare function copyFile(src: string, dest: string): void;
+/**
+ * Copy a directory recursively
+ */
+export declare function copyDir(src: string, dest: string): void;
+/**
+ * Remove a file or directory
+ */
+export declare function remove(path: string): void;
+/**
+ * List directory contents
+ */
+export declare function listDir(dirPath: string): string[];
+/**
+ * List directory entries with types
+ */
+export declare function listDirEntries(dirPath: string): Array<{
+    name: string;
+    type: "file" | "directory" | "unknown";
+    path: string;
+}>;
+/**
+ * Find files matching a pattern in a directory (non-recursive)
+ */
+export declare function findFiles(dirPath: string, pattern: RegExp | string): string[];
+/**
+ * Find files recursively
+ */
+export declare function findFilesRecursive(dirPath: string, pattern?: RegExp | string): string[];
+/**
+ * Get file stats
+ */
+export declare function getStats(path: string): {
+    size: number;
+    isFile: boolean;
+    isDirectory: boolean;
+    created: Date;
+    modified: Date;
+} | null;
+/**
+ * Get file size in bytes
+ */
+export declare function getFileSize(filePath: string): number | null;
+/**
+ * Touch a file (create if not exists, update mtime if exists)
+ */
+export declare function touchFile(filePath: string): void;
+//# sourceMappingURL=fs.d.ts.map

package/dist/utils/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI/C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAGtD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMjD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAM5C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,CAG7D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAMvE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACxC,IAAI,CAIN;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM/D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGrE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAGxD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAevD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIzC;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAKjD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAWD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAO7E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CA4BvF;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,IAAI,CAAC;IACd,QAAQ,EAAE,IAAI,CAAC;CAChB,GAAG,IAAI,CAaP;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG3D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAQhD"}

package/dist/utils/fs.js

@@ -0,0 +1,233 @@
+/**
+ * @enactprotocol/shared - File system helpers
+ *
+ * Provides utilities for common filesystem operations.
+ */
+import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync, } from "node:fs";
+import { dirname, join } from "node:path";
+/**
+ * Ensure a directory exists, creating it if necessary
+ */
+export function ensureDir(dirPath) {
+    if (!existsSync(dirPath)) {
+        mkdirSync(dirPath, { recursive: true });
+    }
+}
+/**
+ * Ensure the parent directory of a file exists
+ */
+export function ensureParentDir(filePath) {
+    const parentDir = dirname(filePath);
+    ensureDir(parentDir);
+}
+/**
+ * Check if a path exists
+ */
+export function pathExists(path) {
+    return existsSync(path);
+}
+/**
+ * Check if a path is a directory
+ */
+export function isDirectory(path) {
+    try {
+        return existsSync(path) && statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a path is a file
+ */
+export function isFile(path) {
+    try {
+        return existsSync(path) && statSync(path).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Read and parse a JSON file
+ * @throws Error if file doesn't exist or isn't valid JSON
+ */
+export function readJsonFile(filePath) {
+    const content = readFileSync(filePath, "utf-8");
+    return JSON.parse(content);
+}
+/**
+ * Try to read and parse a JSON file
+ * @returns The parsed JSON or null if file doesn't exist or is invalid
+ */
+export function tryReadJsonFile(filePath) {
+    try {
+        return readJsonFile(filePath);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write data to a JSON file with formatting
+ */
+export function writeJsonFile(filePath, data, options) {
+    const indent = options?.indent ?? 2;
+    ensureParentDir(filePath);
+    writeFileSync(filePath, `${JSON.stringify(data, null, indent)}\n`, "utf-8");
+}
+/**
+ * Read a text file
+ */
+export function readTextFile(filePath) {
+    return readFileSync(filePath, "utf-8");
+}
+/**
+ * Try to read a text file
+ * @returns The file content or null if file doesn't exist
+ */
+export function tryReadTextFile(filePath) {
+    try {
+        return readTextFile(filePath);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write content to a text file
+ */
+export function writeTextFile(filePath, content) {
+    ensureParentDir(filePath);
+    writeFileSync(filePath, content, "utf-8");
+}
+/**
+ * Copy a file
+ */
+export function copyFile(src, dest) {
+    ensureParentDir(dest);
+    copyFileSync(src, dest);
+}
+/**
+ * Copy a directory recursively
+ */
+export function copyDir(src, dest) {
+    ensureDir(dest);
+    const entries = readdirSync(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = join(src, entry.name);
+        const destPath = join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyDir(srcPath, destPath);
+        }
+        else {
+            copyFile(srcPath, destPath);
+        }
+    }
+}
+/**
+ * Remove a file or directory
+ */
+export function remove(path) {
+    if (existsSync(path)) {
+        rmSync(path, { recursive: true, force: true });
+    }
+}
+/**
+ * List directory contents
+ */
+export function listDir(dirPath) {
+    if (!existsSync(dirPath)) {
+        return [];
+    }
+    return readdirSync(dirPath);
+}
+/**
+ * List directory entries with types
+ */
+export function listDirEntries(dirPath) {
+    if (!existsSync(dirPath)) {
+        return [];
+    }
+    const entries = readdirSync(dirPath, { withFileTypes: true });
+    return entries.map((entry) => ({
+        name: entry.name,
+        type: entry.isDirectory() ? "directory" : entry.isFile() ? "file" : "unknown",
+        path: join(dirPath, entry.name),
+    }));
+}
+/**
+ * Find files matching a pattern in a directory (non-recursive)
+ */
+export function findFiles(dirPath, pattern) {
+    const entries = listDir(dirPath);
+    const regex = typeof pattern === "string" ? new RegExp(pattern) : pattern;
+    return entries
+        .filter((name) => regex.test(name) && isFile(join(dirPath, name)))
+        .map((name) => join(dirPath, name));
+}
+/**
+ * Find files recursively
+ */
+export function findFilesRecursive(dirPath, pattern) {
+    const results = [];
+    if (!existsSync(dirPath)) {
+        return results;
+    }
+    const regex = pattern !== undefined ? (typeof pattern === "string" ? new RegExp(pattern) : pattern) : null;
+    function walk(dir) {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                walk(fullPath);
+            }
+            else if (entry.isFile()) {
+                if (!regex || regex.test(entry.name)) {
+                    results.push(fullPath);
+                }
+            }
+        }
+    }
+    walk(dirPath);
+    return results;
+}
+/**
+ * Get file stats
+ */
+export function getStats(path) {
+    try {
+        const stats = statSync(path);
+        return {
+            size: stats.size,
+            isFile: stats.isFile(),
+            isDirectory: stats.isDirectory(),
+            created: stats.birthtime,
+            modified: stats.mtime,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get file size in bytes
+ */
+export function getFileSize(filePath) {
+    const stats = getStats(filePath);
+    return stats?.isFile ? stats.size : null;
+}
+/**
+ * Touch a file (create if not exists, update mtime if exists)
+ */
+export function touchFile(filePath) {
+    ensureParentDir(filePath);
+    if (existsSync(filePath)) {
+        // Update access and modification time by rewriting the file
+        writeFileSync(filePath, readFileSync(filePath));
+    }
+    else {
+        writeFileSync(filePath, "", "utf-8");
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,112 @@
+/**
+ * @enactprotocol/shared - Logger utility
+ *
+ * Provides structured logging with level filtering and
+ * configurable output formats (console with colors or JSON).
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error" | "silent";
+export interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    message: string;
+    context?: Record<string, unknown> | undefined;
+}
+export interface LoggerOptions {
+    /** Minimum level to output */
+    level?: LogLevel;
+    /** Output format: 'console' for colored output, 'json' for structured */
+    format?: "console" | "json";
+    /** Enable colors in console output */
+    colors?: boolean;
+    /** Custom output function (defaults to console) */
+    output?: (text: string) => void;
+    /** Custom error output function (defaults to console.error) */
+    errorOutput?: (text: string) => void;
+    /** Prefix for log messages */
+    prefix?: string;
+}
+/**
+ * Logger class with level filtering and structured output
+ */
+export declare class Logger {
+    private level;
+    private format;
+    private colors;
+    private output;
+    private errorOutput;
+    private prefix;
+    constructor(options?: LoggerOptions);
+    /**
+     * Check if a level should be logged
+     */
+    shouldLog(level: LogLevel): boolean;
+    /**
+     * Set the minimum log level
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * Get the current log level
+     */
+    getLevel(): LogLevel;
+    /**
+     * Set the output format
+     */
+    setFormat(format: "console" | "json"): void;
+    /**
+     * Enable or disable colors
+     */
+    setColors(enabled: boolean): void;
+    /**
+     * Set the prefix for log messages
+     */
+    setPrefix(prefix: string): void;
+    /**
+     * Create a child logger with a prefix
+     */
+    child(prefix: string): Logger;
+    /**
+     * Log a debug message
+     */
+    debug(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log an info message
+     */
+    info(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log a warning message
+     */
+    warn(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log an error message
+     */
+    error(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Core logging method
+     */
+    private log;
+    /**
+     * Format entry as JSON
+     */
+    private formatJson;
+    /**
+     * Format entry for console with colors
+     */
+    private formatConsole;
+}
+/**
+ * Get the default logger instance
+ */
+export declare function getLogger(): Logger;
+/**
+ * Configure the default logger
+ */
+export declare function configureLogger(options: LoggerOptions): void;
+/**
+ * Create a new logger with the given options
+ */
+export declare function createLogger(options?: LoggerOptions): Logger;
+export declare const debug: (message: string, context?: Record<string, unknown>) => void;
+export declare const info: (message: string, context?: Record<string, unknown>) => void;
+export declare const warn: (message: string, context?: Record<string, unknown>) => void;
+export declare const error: (message: string, context?: Record<string, unknown>) => void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

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

package/dist/utils/logger.js

@@ -0,0 +1,232 @@
+/**
+ * @enactprotocol/shared - Logger utility
+ *
+ * Provides structured logging with level filtering and
+ * configurable output formats (console with colors or JSON).
+ */
+/** Level priorities (higher = more severe) */
+const LEVEL_PRIORITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    silent: 4,
+};
+/** ANSI color codes */
+const COLORS = {
+    reset: "\x1b[0m",
+    dim: "\x1b[2m",
+    bold: "\x1b[1m",
+    red: "\x1b[31m",
+    yellow: "\x1b[33m",
+    blue: "\x1b[34m",
+    cyan: "\x1b[36m",
+    gray: "\x1b[90m",
+};
+/** Level display colors */
+const LEVEL_COLORS = {
+    debug: COLORS.gray,
+    info: COLORS.blue,
+    warn: COLORS.yellow,
+    error: COLORS.red,
+};
+/** Level labels for output */
+const LEVEL_LABELS = {
+    debug: "DEBUG",
+    info: "INFO",
+    warn: "WARN",
+    error: "ERROR",
+};
+/**
+ * Logger class with level filtering and structured output
+ */
+export class Logger {
+    level;
+    format;
+    colors;
+    output;
+    errorOutput;
+    prefix;
+    constructor(options = {}) {
+        this.level = options.level ?? "info";
+        this.format = options.format ?? "console";
+        this.colors = options.colors ?? true;
+        this.output = options.output ?? console.log;
+        this.errorOutput = options.errorOutput ?? console.error;
+        this.prefix = options.prefix ?? "";
+    }
+    /**
+     * Check if a level should be logged
+     */
+    shouldLog(level) {
+        return LEVEL_PRIORITY[level] >= LEVEL_PRIORITY[this.level];
+    }
+    /**
+     * Set the minimum log level
+     */
+    setLevel(level) {
+        this.level = level;
+    }
+    /**
+     * Get the current log level
+     */
+    getLevel() {
+        return this.level;
+    }
+    /**
+     * Set the output format
+     */
+    setFormat(format) {
+        this.format = format;
+    }
+    /**
+     * Enable or disable colors
+     */
+    setColors(enabled) {
+        this.colors = enabled;
+    }
+    /**
+     * Set the prefix for log messages
+     */
+    setPrefix(prefix) {
+        this.prefix = prefix;
+    }
+    /**
+     * Create a child logger with a prefix
+     */
+    child(prefix) {
+        const childPrefix = this.prefix ? `${this.prefix}:${prefix}` : prefix;
+        return new Logger({
+            level: this.level,
+            format: this.format,
+            colors: this.colors,
+            output: this.output,
+            errorOutput: this.errorOutput,
+            prefix: childPrefix,
+        });
+    }
+    /**
+     * Log a debug message
+     */
+    debug(message, context) {
+        this.log("debug", message, context);
+    }
+    /**
+     * Log an info message
+     */
+    info(message, context) {
+        this.log("info", message, context);
+    }
+    /**
+     * Log a warning message
+     */
+    warn(message, context) {
+        this.log("warn", message, context);
+    }
+    /**
+     * Log an error message
+     */
+    error(message, context) {
+        this.log("error", message, context);
+    }
+    /**
+     * Core logging method
+     */
+    log(level, message, context) {
+        if (!this.shouldLog(level)) {
+            return;
+        }
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            message: this.prefix ? `[${this.prefix}] ${message}` : message,
+            context,
+        };
+        const formatted = this.format === "json" ? this.formatJson(entry) : this.formatConsole(entry);
+        // Use error output for warn/error levels
+        if (level === "warn" || level === "error") {
+            this.errorOutput(formatted);
+        }
+        else {
+            this.output(formatted);
+        }
+    }
+    /**
+     * Format entry as JSON
+     */
+    formatJson(entry) {
+        const obj = {
+            timestamp: entry.timestamp,
+            level: entry.level,
+            message: entry.message,
+        };
+        if (entry.context && Object.keys(entry.context).length > 0) {
+            obj.context = entry.context;
+        }
+        return JSON.stringify(obj);
+    }
+    /**
+     * Format entry for console with colors
+     */
+    formatConsole(entry) {
+        const parts = [];
+        // Timestamp (dim)
+        if (this.colors) {
+            parts.push(`${COLORS.dim}${entry.timestamp}${COLORS.reset}`);
+        }
+        else {
+            parts.push(entry.timestamp);
+        }
+        // Level label with color (only active levels, not silent)
+        const level = entry.level;
+        const label = LEVEL_LABELS[level];
+        if (this.colors) {
+            const color = LEVEL_COLORS[level];
+            parts.push(`${color}${label.padEnd(5)}${COLORS.reset}`);
+        }
+        else {
+            parts.push(label.padEnd(5));
+        }
+        // Message
+        parts.push(entry.message);
+        // Context (if any)
+        if (entry.context && Object.keys(entry.context).length > 0) {
+            const contextStr = JSON.stringify(entry.context);
+            if (this.colors) {
+                parts.push(`${COLORS.dim}${contextStr}${COLORS.reset}`);
+            }
+            else {
+                parts.push(contextStr);
+            }
+        }
+        return parts.join(" ");
+    }
+}
+/**
+ * Default logger instance
+ */
+let defaultLogger = new Logger();
+/**
+ * Get the default logger instance
+ */
+export function getLogger() {
+    return defaultLogger;
+}
+/**
+ * Configure the default logger
+ */
+export function configureLogger(options) {
+    defaultLogger = new Logger(options);
+}
+/**
+ * Create a new logger with the given options
+ */
+export function createLogger(options) {
+    return new Logger(options);
+}
+// Convenience exports for quick logging
+export const debug = (message, context) => defaultLogger.debug(message, context);
+export const info = (message, context) => defaultLogger.info(message, context);
+export const warn = (message, context) => defaultLogger.warn(message, context);
+export const error = (message, context) => defaultLogger.error(message, context);
+//# sourceMappingURL=logger.js.map