@salesforce/b2c-tooling-sdk 0.2.0 → 0.3.0

package/dist/esm/operations/logs/tail.js

@@ -0,0 +1,525 @@
+import { getLogger } from '../../logging/logger.js';
+import { listLogFiles } from './list.js';
+/**
+ * Default log prefixes to tail.
+ */
+const DEFAULT_PREFIXES = ['error', 'customerror'];
+/**
+ * Default polling interval in milliseconds.
+ */
+const DEFAULT_POLL_INTERVAL = 3000;
+/**
+ * Default max entries for getRecentLogs.
+ */
+const DEFAULT_MAX_ENTRIES = 100;
+/**
+ * Default bytes to read from end of file for getRecentLogs.
+ */
+const DEFAULT_TAIL_BYTES = 65536; // 64KB
+/**
+ * Regex to detect the start of a new log entry.
+ * Matches: [YYYY-MM-DD HH:MM:SS.mmm GMT]
+ */
+const LOG_ENTRY_START = /^\[\d{4}-\d{2}-\d{2}\s+\d{2}:\d{2}:\d{2}\.\d+\s+\w+\]/;
+/**
+ * Parses the first line of a log entry to extract timestamp, level, and message.
+ *
+ * Expected format: [timestamp GMT] LEVEL context - message
+ * Example: [2025-01-25 10:30:45.123 GMT] ERROR PipelineCallServlet|... - Error message
+ *
+ * The message field will contain:
+ * - The content portion from the first line (after LEVEL)
+ * - Plus any continuation lines (stack traces, etc.)
+ *
+ * @param firstLine - First line of the log entry
+ * @param file - File name the entry came from
+ * @param fullMessage - Complete raw message including all lines
+ * @param pathNormalizer - Optional function to normalize paths in the message
+ * @returns Parsed log entry
+ */
+export function parseLogEntry(firstLine, file, fullMessage, pathNormalizer) {
+    // Try to parse the standard B2C log format: [timestamp GMT] LEVEL message
+    const match = firstLine.match(/^\[([^\]]+)\]\s+(INFO|WARN|ERROR|DEBUG|FATAL|TRACE)\s+(.*)$/s);
+    if (match) {
+        const [, timestamp, level, firstLineContent] = match;
+        // Build the message: first line content + continuation lines
+        const lines = fullMessage.split('\n');
+        const continuationLines = lines.slice(1);
+        let message = continuationLines.length > 0 ? [firstLineContent, ...continuationLines].join('\n') : firstLineContent;
+        if (pathNormalizer) {
+            message = pathNormalizer(message);
+        }
+        return {
+            file,
+            timestamp,
+            level,
+            message,
+            raw: fullMessage,
+        };
+    }
+    // Fallback: return as unparsed entry
+    let message = fullMessage;
+    if (pathNormalizer) {
+        message = pathNormalizer(message);
+    }
+    return {
+        file,
+        message,
+        raw: fullMessage,
+    };
+}
+/**
+ * Splits content into lines, handling incomplete lines at boundaries.
+ * Uses TextDecoder with stream mode for proper UTF-8 multi-byte character handling.
+ *
+ * @param content - ArrayBuffer content
+ * @param decoder - TextDecoder instance (should be reused for streaming)
+ * @param isComplete - Whether this is the final chunk (flush decoder)
+ * @returns Array of complete lines (without trailing incomplete line)
+ */
+export function splitLines(content, decoder, isComplete = true) {
+    const text = decoder.decode(content, { stream: !isComplete });
+    // Split by newlines, keeping track of whether last line is complete
+    const lines = text.split(/\r?\n/);
+    // If the text doesn't end with a newline, the last line is incomplete
+    // We should not include it in the results (it will be completed in next read)
+    if (!isComplete && lines.length > 0 && !text.endsWith('\n')) {
+        lines.pop();
+    }
+    // Filter out empty lines
+    return lines.filter((line) => line.trim().length > 0);
+}
+/**
+ * Aggregates lines into multi-line log entries.
+ *
+ * B2C log entries can span multiple lines. A new entry starts when a line
+ * begins with a timestamp pattern: [YYYY-MM-DD HH:MM:SS.mmm GMT]
+ *
+ * @param lines - Array of individual lines
+ * @param pendingLines - Lines carried over from previous chunk (incomplete entry)
+ * @returns Object with complete entries and any pending lines for next chunk
+ */
+export function aggregateLogEntries(lines, pendingLines = []) {
+    const entries = [];
+    let currentEntry = [...pendingLines];
+    for (const line of lines) {
+        if (LOG_ENTRY_START.test(line)) {
+            // This line starts a new entry
+            if (currentEntry.length > 0) {
+                // Save the previous entry
+                entries.push(currentEntry);
+            }
+            currentEntry = [line];
+        }
+        else {
+            // Continuation line - add to current entry
+            currentEntry.push(line);
+        }
+    }
+    // Return complete entries and any pending lines
+    return {
+        entries,
+        pending: currentEntry,
+    };
+}
+/**
+ * Tails log files on a B2C Commerce instance.
+ *
+ * Continuously polls for new log content using HTTP Range requests for efficiency.
+ * Calls the onEntry callback for each new log line.
+ *
+ * @param instance - B2C instance to tail logs from
+ * @param options - Tailing options (filters, callbacks, polling interval)
+ * @returns Tail result with stop() control and done promise
+ *
+ * @example
+ * ```typescript
+ * const result = await tailLogs(instance, {
+ *   prefixes: ['error', 'customerror'],
+ *   onEntry: (entry) => console.log(`[${entry.file}] ${entry.message}`),
+ *   onError: (err) => console.error('Tail error:', err),
+ * });
+ *
+ * // Stop after 10 seconds
+ * setTimeout(() => result.stop(), 10000);
+ *
+ * // Wait for tailing to complete
+ * await result.done;
+ * ```
+ */
+export async function tailLogs(instance, options = {}) {
+    const logger = getLogger();
+    const { prefixes = DEFAULT_PREFIXES, pollInterval = DEFAULT_POLL_INTERVAL, lastEntries = 1, maxEntries, pathNormalizer, onEntry, onError, onFileDiscovered, onFileRotated, } = options;
+    // Track file positions and collected entries
+    const filePositions = new Map();
+    const fileSizes = new Map();
+    const trackedFiles = [];
+    const collectedEntries = [];
+    // Control state
+    let running = true;
+    let resolveComplete;
+    const donePromise = new Promise((resolve) => {
+        resolveComplete = resolve;
+    });
+    // TextDecoder for proper UTF-8 handling (one per file for streaming)
+    const decoders = new Map();
+    // Pending lines for multi-line entry aggregation (per file)
+    const pendingLines = new Map();
+    /**
+     * Stop the tailing operation.
+     */
+    const stop = async () => {
+        running = false;
+        // Give a small delay to allow any in-flight requests to complete
+        await new Promise((resolve) => setTimeout(resolve, 100));
+    };
+    /**
+     * Get or create a decoder for a file.
+     */
+    const getDecoder = (filename) => {
+        let decoder = decoders.get(filename);
+        if (!decoder) {
+            decoder = new TextDecoder('utf-8', { fatal: false });
+            decoders.set(filename, decoder);
+        }
+        return decoder;
+    };
+    /**
+     * Fetch the last N entries from a file's tail.
+     */
+    const fetchLastEntries = async (file, count) => {
+        if (count <= 0 || file.size === 0) {
+            return [];
+        }
+        try {
+            // Read last ~64KB of the file to find recent entries
+            const tailBytes = Math.min(file.size, DEFAULT_TAIL_BYTES);
+            const startByte = Math.max(0, file.size - tailBytes);
+            let content;
+            if (startByte === 0) {
+                // Read entire file
+                content = await instance.webdav.get(file.path);
+            }
+            else {
+                // Use Range request for tail
+                const response = await instance.webdav.request(file.path, {
+                    method: 'GET',
+                    headers: {
+                        Range: `bytes=${startByte}-`,
+                    },
+                });
+                if (response.status === 416) {
+                    // File might be smaller than expected, read entire file
+                    content = await instance.webdav.get(file.path);
+                }
+                else if (!response.ok && response.status !== 206) {
+                    throw new Error(`Failed to read ${file.name}: ${response.status}`);
+                }
+                else {
+                    content = await response.arrayBuffer();
+                }
+            }
+            // Parse lines and aggregate into multi-line entries
+            const decoder = new TextDecoder('utf-8', { fatal: false });
+            const lines = splitLines(content, decoder, true);
+            // If we started mid-file, skip lines until we find an entry start
+            let startIndex = 0;
+            if (startByte > 0) {
+                for (let i = 0; i < lines.length; i++) {
+                    if (LOG_ENTRY_START.test(lines[i])) {
+                        startIndex = i;
+                        break;
+                    }
+                }
+            }
+            // Aggregate lines into entries
+            const { entries: rawEntries, pending } = aggregateLogEntries(lines.slice(startIndex), []);
+            // Include pending as the last entry if it has content
+            const allRawEntries = pending.length > 0 ? [...rawEntries, pending] : rawEntries;
+            const entries = [];
+            for (const entryLines of allRawEntries) {
+                const firstLine = entryLines[0];
+                const fullMessage = entryLines.join('\n');
+                const entry = parseLogEntry(firstLine, file.name, fullMessage, pathNormalizer);
+                entries.push(entry);
+            }
+            // Return only the last N entries (most recent)
+            return entries.slice(-count);
+        }
+        catch (error) {
+            logger.error({ error, file: file.name }, `Error fetching last entries from ${file.name}`);
+            if (onError) {
+                onError(error instanceof Error ? error : new Error(String(error)));
+            }
+            return [];
+        }
+    };
+    /**
+     * Discover and track log files matching the prefix filters.
+     */
+    const discoverFiles = async () => {
+        try {
+            const files = await listLogFiles(instance, { prefixes, sortBy: 'date', sortOrder: 'desc' });
+            for (const file of files) {
+                if (!filePositions.has(file.name)) {
+                    // New file discovered
+                    logger.debug({ file: file.name }, `Discovered log file: ${file.name}`);
+                    trackedFiles.push(file);
+                    fileSizes.set(file.name, file.size);
+                    // Notify about discovery first
+                    if (onFileDiscovered) {
+                        onFileDiscovered(file);
+                    }
+                    // Fetch and emit last N entries if requested
+                    if (lastEntries > 0) {
+                        const recentEntries = await fetchLastEntries(file, lastEntries);
+                        for (const entry of recentEntries) {
+                            if (onEntry) {
+                                onEntry(entry);
+                            }
+                            if (maxEntries !== undefined) {
+                                collectedEntries.push(entry);
+                                if (collectedEntries.length >= maxEntries) {
+                                    running = false;
+                                    return;
+                                }
+                            }
+                        }
+                    }
+                    // Set position to end of file to only tail new content
+                    filePositions.set(file.name, file.size);
+                }
+                else {
+                    // Check for file rotation (size decreased)
+                    const previousSize = fileSizes.get(file.name) || 0;
+                    if (file.size < previousSize) {
+                        logger.debug({ file: file.name, previousSize, newSize: file.size }, `File rotated: ${file.name}`);
+                        // Reset position to start of new file
+                        filePositions.set(file.name, 0);
+                        fileSizes.set(file.name, file.size);
+                        // Create fresh decoder and clear pending lines
+                        decoders.set(file.name, new TextDecoder('utf-8', { fatal: false }));
+                        pendingLines.delete(file.name);
+                        if (onFileRotated) {
+                            onFileRotated(file);
+                        }
+                    }
+                    else {
+                        fileSizes.set(file.name, file.size);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            logger.error({ error }, 'Error discovering log files');
+            if (onError) {
+                onError(error instanceof Error ? error : new Error(String(error)));
+            }
+        }
+    };
+    /**
+     * Read new content from a file using Range request.
+     */
+    const readNewContent = async (file) => {
+        const position = filePositions.get(file.name) || 0;
+        const currentSize = fileSizes.get(file.name) || 0;
+        // No new content
+        if (position >= currentSize) {
+            return;
+        }
+        try {
+            // Use Range header to get only new content
+            const response = await instance.webdav.request(file.path, {
+                method: 'GET',
+                headers: {
+                    Range: `bytes=${position}-`,
+                },
+            });
+            // Handle different response statuses
+            if (response.status === 416) {
+                // Range Not Satisfiable - position is at or past end of file
+                // This can happen due to race conditions, just skip
+                return;
+            }
+            if (!response.ok && response.status !== 206) {
+                throw new Error(`Failed to read ${file.name}: ${response.status} ${response.statusText}`);
+            }
+            const content = await response.arrayBuffer();
+            const decoder = getDecoder(file.name);
+            // Update position based on content received
+            const contentLength = content.byteLength;
+            filePositions.set(file.name, position + contentLength);
+            // Parse lines and aggregate into multi-line entries
+            const lines = splitLines(content, decoder, true);
+            const { entries: rawEntries, pending } = aggregateLogEntries(lines, pendingLines.get(file.name) || []);
+            // Check if we've caught up to the end of the file
+            const newPosition = position + contentLength;
+            const atEndOfFile = newPosition >= currentSize;
+            // If we're at the end of the file, flush pending as a complete entry
+            // (the entry is complete for now, more content may arrive later)
+            let allEntries = rawEntries;
+            if (atEndOfFile && pending.length > 0) {
+                allEntries = [...rawEntries, pending];
+                pendingLines.set(file.name, []);
+            }
+            else {
+                pendingLines.set(file.name, pending);
+            }
+            // Process complete entries
+            for (const entryLines of allEntries) {
+                const firstLine = entryLines[0];
+                const fullMessage = entryLines.join('\n');
+                const entry = parseLogEntry(firstLine, file.name, fullMessage, pathNormalizer);
+                if (onEntry) {
+                    onEntry(entry);
+                }
+                if (maxEntries !== undefined) {
+                    collectedEntries.push(entry);
+                    if (collectedEntries.length >= maxEntries) {
+                        running = false;
+                        return;
+                    }
+                }
+            }
+        }
+        catch (error) {
+            logger.error({ error, file: file.name }, `Error reading ${file.name}`);
+            if (onError) {
+                onError(error instanceof Error ? error : new Error(String(error)));
+            }
+        }
+    };
+    /**
+     * Main polling loop.
+     */
+    const poll = async () => {
+        // Initial file discovery
+        await discoverFiles();
+        while (running) {
+            // Read new content from all tracked files
+            for (const file of trackedFiles) {
+                if (!running)
+                    break;
+                await readNewContent(file);
+            }
+            if (!running)
+                break;
+            // Wait for next poll
+            await new Promise((resolve) => setTimeout(resolve, pollInterval));
+            // Check for new files
+            await discoverFiles();
+        }
+        resolveComplete();
+    };
+    // Start polling (don't await - runs in background)
+    poll().catch((error) => {
+        logger.error({ error }, 'Polling error');
+        if (onError) {
+            onError(error instanceof Error ? error : new Error(String(error)));
+        }
+        resolveComplete();
+    });
+    return {
+        stop,
+        files: trackedFiles,
+        entries: collectedEntries,
+        done: donePromise,
+    };
+}
+/**
+ * Gets recent log entries (one-shot retrieval).
+ *
+ * Useful for MCP server integration or programmatic access without continuous tailing.
+ * Reads the tail end of log files and returns parsed entries.
+ *
+ * @param instance - B2C instance to get logs from
+ * @param options - Retrieval options
+ * @returns Array of recent log entries
+ *
+ * @example
+ * ```typescript
+ * // Get the last 50 error entries
+ * const entries = await getRecentLogs(instance, {
+ *   prefixes: ['error'],
+ *   maxEntries: 50
+ * });
+ * ```
+ */
+export async function getRecentLogs(instance, options = {}) {
+    const logger = getLogger();
+    const { prefixes = DEFAULT_PREFIXES, maxEntries = DEFAULT_MAX_ENTRIES, tailBytes = DEFAULT_TAIL_BYTES, pathNormalizer, } = options;
+    logger.debug({ prefixes, maxEntries, tailBytes }, 'Getting recent logs');
+    // Get log files
+    const files = await listLogFiles(instance, {
+        prefixes,
+        sortBy: 'date',
+        sortOrder: 'desc',
+    });
+    const allEntries = [];
+    // Read from files until we have enough entries
+    for (const file of files) {
+        if (allEntries.length >= maxEntries)
+            break;
+        try {
+            // Calculate range to read (tail end of file)
+            const startByte = Math.max(0, file.size - tailBytes);
+            let content;
+            if (startByte === 0) {
+                // Read entire file
+                content = await instance.webdav.get(file.path);
+            }
+            else {
+                // Use Range request for tail
+                const response = await instance.webdav.request(file.path, {
+                    method: 'GET',
+                    headers: {
+                        Range: `bytes=${startByte}-`,
+                    },
+                });
+                if (response.status === 416) {
+                    // File might be smaller than expected, read entire file
+                    content = await instance.webdav.get(file.path);
+                }
+                else if (!response.ok && response.status !== 206) {
+                    throw new Error(`Failed to read ${file.name}: ${response.status}`);
+                }
+                else {
+                    content = await response.arrayBuffer();
+                }
+            }
+            // Parse lines and aggregate into multi-line entries
+            const decoder = new TextDecoder('utf-8', { fatal: false });
+            const lines = splitLines(content, decoder, true);
+            // If we started mid-file, skip lines until we find an entry start
+            let startIndex = 0;
+            if (startByte > 0) {
+                for (let i = 0; i < lines.length; i++) {
+                    if (LOG_ENTRY_START.test(lines[i])) {
+                        startIndex = i;
+                        break;
+                    }
+                }
+            }
+            // Aggregate lines into entries
+            const { entries: rawEntries, pending } = aggregateLogEntries(lines.slice(startIndex), []);
+            // Process complete entries (ignore pending - we're reading a snapshot)
+            // Also include pending as the last entry if it has content
+            const allRawEntries = pending.length > 0 ? [...rawEntries, pending] : rawEntries;
+            for (const entryLines of allRawEntries) {
+                const firstLine = entryLines[0];
+                const fullMessage = entryLines.join('\n');
+                const entry = parseLogEntry(firstLine, file.name, fullMessage, pathNormalizer);
+                allEntries.push(entry);
+                if (allEntries.length >= maxEntries)
+                    break;
+            }
+        }
+        catch (error) {
+            logger.error({ error, file: file.name }, `Error reading ${file.name}`);
+            // Continue to next file instead of failing completely
+        }
+    }
+    // Return entries in reverse order (most recent first)
+    return allEntries.reverse().slice(0, maxEntries);
+}
+//# sourceMappingURL=tail.js.map

package/dist/esm/operations/logs/tail.js.map

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

package/dist/esm/operations/logs/types.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Represents a log file on a B2C Commerce instance.
+ */
+export interface LogFile {
+    /** File name (e.g., "error-blade1-20250125.log") */
+    name: string;
+    /** Log prefix/type (e.g., "error", "customerror", "debug") */
+    prefix: string;
+    /** File size in bytes */
+    size: number;
+    /** Last modified date */
+    lastModified: Date;
+    /** Full WebDAV path to the file */
+    path: string;
+}
+/**
+ * Represents a parsed log entry.
+ */
+export interface LogEntry {
+    /** File name this entry came from */
+    file: string;
+    /** Log level (INFO, WARN, ERROR, DEBUG, etc.) */
+    level?: string;
+    /** Timestamp string from the log entry */
+    timestamp?: string;
+    /** Log message (with path normalization applied if enabled) */
+    message: string;
+    /** Raw unprocessed log line */
+    raw: string;
+}
+/**
+ * Options for listing log files.
+ */
+export interface ListLogsOptions {
+    /**
+     * Filter by log prefixes (e.g., ["error", "customerror"]).
+     * If not specified, returns all log files.
+     */
+    prefixes?: string[];
+    /**
+     * Sort field: "name", "date", or "size".
+     * @default "date"
+     */
+    sortBy?: 'name' | 'date' | 'size';
+    /**
+     * Sort order.
+     * @default "desc"
+     */
+    sortOrder?: 'asc' | 'desc';
+}
+/**
+ * Callback functions for tail operation events.
+ */
+export interface TailLogsCallbacks {
+    /** Called for each new log entry */
+    onEntry?: (entry: LogEntry) => void;
+    /** Called when an error occurs */
+    onError?: (error: Error) => void;
+    /** Called when a new log file is discovered */
+    onFileDiscovered?: (file: LogFile) => void;
+    /** Called when file rotation is detected (file size decreased) */
+    onFileRotated?: (file: LogFile) => void;
+}
+/**
+ * Options for tailing logs.
+ */
+export interface TailLogsOptions extends TailLogsCallbacks {
+    /**
+     * Filter by log prefixes (e.g., ["error", "customerror"]).
+     * @default ["error", "customerror"]
+     */
+    prefixes?: string[];
+    /**
+     * Polling interval in milliseconds.
+     * @default 3000
+     */
+    pollInterval?: number;
+    /**
+     * Number of recent entries to show per file on startup.
+     * Set to 0 to skip initial entries and only show new ones.
+     * @default 1
+     */
+    lastEntries?: number;
+    /**
+     * Maximum number of entries to collect before stopping.
+     * When set, the tail operation will automatically stop after collecting
+     * this many entries. Useful for programmatic access.
+     */
+    maxEntries?: number;
+    /**
+     * Path normalizer function to convert remote paths to local paths.
+     * Called on each log message to make paths clickable in IDEs.
+     */
+    pathNormalizer?: (message: string) => string;
+}
+/**
+ * Result of a tail operation.
+ */
+export interface TailLogsResult {
+    /** Stop the tailing operation */
+    stop: () => Promise<void>;
+    /** Currently tracked files */
+    files: LogFile[];
+    /** Collected entries (when maxEntries is set) */
+    entries: LogEntry[];
+    /** Promise that resolves when tailing stops (via stop() or maxEntries) */
+    done: Promise<void>;
+}
+/**
+ * Options for getting recent logs (one-shot retrieval).
+ */
+export interface GetRecentLogsOptions {
+    /**
+     * Filter by log prefixes (e.g., ["error", "customerror"]).
+     * @default ["error", "customerror"]
+     */
+    prefixes?: string[];
+    /**
+     * Maximum number of entries to retrieve.
+     * @default 100
+     */
+    maxEntries?: number;
+    /**
+     * Maximum bytes to read from the end of each file.
+     * @default 65536 (64KB)
+     */
+    tailBytes?: number;
+    /**
+     * Path normalizer function to convert remote paths to local paths.
+     */
+    pathNormalizer?: (message: string) => string;
+}