@ds-sfdc/sfparty 1.7.9 → 3.0.1

package/dist/lib/terminalUtils.js

@@ -0,0 +1,68 @@
+/**
+ * SEC-005: Validate environment variable value
+ * @param value - Environment variable value
+ * @param maxLength - Maximum allowed length (default: 256)
+ * @returns Sanitized value or undefined if invalid
+ */
+function validateEnvVar(value, maxLength = 256) {
+    if (!value || typeof value !== 'string') {
+        return undefined;
+    }
+    // Remove null bytes and control characters
+    const sanitized = value.replace(/[\0\n\r]/g, '').trim();
+    // Basic validation
+    if (sanitized.length === 0 ||
+        sanitized.length > maxLength ||
+        /[<>"|\\]/.test(sanitized) // Dangerous characters
+    ) {
+        return undefined;
+    }
+    return sanitized;
+}
+/**
+ * Suppress terminal capability errors from stderr
+ * Used to filter out noisy terminal capability warnings from blessed library
+ */
+export function suppressTerminalErrors() {
+    // SEC-005: Validate TERM environment variable
+    const term = validateEnvVar(process.env.TERM, 64);
+    if (process.stdout.isTTY && term !== 'dumb') {
+        const originalStderrWrite = process.stderr.write.bind(process.stderr);
+        process.stderr.write = function (chunk, encodingOrCb, cb) {
+            const message = chunk?.toString() || '';
+            // Filter out terminal capability errors
+            if (message.includes('xterm-256color.Setulc') ||
+                message.includes('stack.pop') ||
+                message.includes('out.push') ||
+                message.includes('var v,') ||
+                message.includes('stack.push') ||
+                message.includes('stack =') ||
+                message.includes('out =') ||
+                message.includes('return out.join') ||
+                message.includes('Error on xterm') ||
+                message.includes('\\u001b[58::') ||
+                message.includes('%p1%{65536}') ||
+                message.includes('\x1b[58::')) {
+                const actualCb = typeof encodingOrCb === 'function' ? encodingOrCb : cb;
+                if (typeof actualCb === 'function') {
+                    actualCb();
+                }
+                return true;
+            }
+            // Handle overloads: (chunk, cb) or (chunk, encoding, cb)
+            if (typeof encodingOrCb === 'function') {
+                return originalStderrWrite(chunk, encodingOrCb);
+            }
+            else if (cb) {
+                return originalStderrWrite(chunk, encodingOrCb, cb);
+            }
+            else if (encodingOrCb) {
+                return originalStderrWrite(chunk, encodingOrCb);
+            }
+            else {
+                return originalStderrWrite(chunk);
+            }
+        };
+    }
+}
+//# sourceMappingURL=terminalUtils.js.map

package/dist/lib/terminalUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminalUtils.js","sourceRoot":"","sources":["../../src/lib/terminalUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,SAAS,cAAc,CACtB,KAAyB,EACzB,SAAS,GAAG,GAAG;IAEf,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACzC,OAAO,SAAS,CAAA;IACjB,CAAC;IAED,2CAA2C;IAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IAEvD,mBAAmB;IACnB,IACC,SAAS,CAAC,MAAM,KAAK,CAAC;QACtB,SAAS,CAAC,MAAM,GAAG,SAAS;QAC5B,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,uBAAuB;MACjD,CAAC;QACF,OAAO,SAAS,CAAA;IACjB,CAAC;IAED,OAAO,SAAS,CAAA;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACrC,8CAA8C;IAC9C,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IACjD,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QAC7C,MAAM,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAErE,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,UACtB,KAA0B,EAC1B,YAA8D,EAC9D,EAAiC;YAEjC,MAAM,OAAO,GAAG,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;YACvC,wCAAwC;YACxC,IACC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC;gBACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACzB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;gBACnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;gBAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAC5B,CAAC;gBACF,MAAM,QAAQ,GACb,OAAO,YAAY,KAAK,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAA;gBACvD,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;oBACpC,QAAQ,EAAE,CAAA;gBACX,CAAC;gBACD,OAAO,IAAI,CAAA;YACZ,CAAC;YAED,yDAAyD;YACzD,IAAI,OAAO,YAAY,KAAK,UAAU,EAAE,CAAC;gBACxC,OAAO,mBAAmB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAA;YAChD,CAAC;iBAAM,IAAI,EAAE,EAAE,CAAC;gBACf,OAAO,mBAAmB,CACzB,KAAK,EACL,YAA8B,EAC9B,EAAE,CACF,CAAA;YACF,CAAC;iBAAM,IAAI,YAAY,EAAE,CAAC;gBACzB,OAAO,mBAAmB,CACzB,KAAK,EACL,YAA8B,CAC9B,CAAA;YACF,CAAC;iBAAM,CAAC;gBACP,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAA;YAClC,CAAC;QACF,CAAgC,CAAA;IACjC,CAAC;AACF,CAAC"}

package/dist/lib/tui.d.ts

@@ -0,0 +1,133 @@
+export interface TUIStats {
+    completed: number;
+    processed?: number;
+    total: number;
+    errors: number;
+    currentFile: string;
+    queueLength?: number;
+    batchSize?: number;
+    isFlushing?: boolean;
+    totalWritesEstimate?: number;
+    writesCompleted?: number;
+}
+export interface ResourceStats {
+    cpuCores: number;
+    totalMemory: number;
+    freeMemory: number;
+    usedMemory: number;
+    memoryUsagePercent: number;
+    concurrency: number;
+}
+interface BlessedScreen {
+    width?: number;
+    height?: number;
+    key: (keys: string[], handler: () => void) => void;
+    on: (event: string, handler: () => void) => void;
+    removeListener: (event: string, handler: () => void) => void;
+    removeAllListeners: () => void;
+    render: () => void;
+    clearRegion: (x1: number, x2: number, y1: number, y2: number) => void;
+    cursor: {
+        reset: () => void;
+        hide: () => void;
+        show: () => void;
+    };
+    destroy: () => void;
+    input?: {
+        pause?: () => void;
+        resume?: () => void;
+        removeAllListeners?: () => void;
+        unref?: () => void;
+        destroy?: () => void;
+    };
+}
+export declare class TUI {
+    private screen;
+    private grid;
+    private progressBox;
+    private statsBox;
+    private resourceBox;
+    private fileListBox;
+    private completedFilesBox;
+    private logBox;
+    private headerBox;
+    private startTime;
+    private completedFiles;
+    private maxCompletedFiles;
+    private filesWithErrors;
+    private stats;
+    private resourceStats;
+    private fileItems;
+    private maxFileItems;
+    private isInitialized;
+    private keyHandler;
+    private resizeHandler;
+    private peakQueueLength;
+    private operation;
+    constructor(title?: string);
+    private createHeader;
+    /**
+     * Initialize TUI with total file count
+     */
+    init(total: number, operation?: string): void;
+    /**
+     * Set startup information to display in TUI
+     */
+    setStartupInfo(info: {
+        sourcePath?: string;
+        targetPath?: string;
+        totalFiles?: number;
+        systemResources?: string;
+        concurrency?: string;
+        writeBatcher?: string;
+    }): void;
+    /**
+     * Update progress statistics
+     */
+    updateStats(stats: Partial<TUIStats>): void;
+    /**
+     * Update resource statistics
+     */
+    updateResourceStats(resourceStats: ResourceStats): void;
+    /**
+     * Add a file to the processing queue display
+     * Only shows pending and processing files - completed files are moved to completed queue
+     */
+    addFile(file: string, status?: 'pending' | 'processing' | 'completed' | 'error'): void;
+    /**
+     * Log a message to the status log
+     */
+    log(message: string): void;
+    /**
+     * Update progress display
+     * Now incorporates flushing writes into overall progress calculation
+     */
+    private updateProgress;
+    /**
+     * Update resource display
+     */
+    private updateResourceDisplay;
+    /**
+     * Format duration in human-readable format
+     */
+    private formatDuration;
+    /**
+     * Render the screen
+     */
+    render(): void;
+    /**
+     * Show completion message and cleanup
+     */
+    complete(success?: boolean): void;
+    /**
+     * Cleanup and restore terminal
+     * Must be called before any console.log output to prevent overwriting
+     */
+    cleanup(): void;
+    /**
+     * Get the screen instance (for advanced usage)
+     */
+    getScreen(): BlessedScreen;
+}
+export {};
+//# sourceMappingURL=tui.d.ts.map

package/dist/lib/tui.d.ts.map

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