fastbrowser_cli 1.0.31 → 1.0.33

package/dist/shared/logger.js

@@ -0,0 +1,269 @@
+// npm imports
+import Chalk from 'chalk';
+import { minimatch } from 'minimatch';
+/**
+ * Simple logging utility with severity levels, colored output, and metadata support
+ */
+export class Logger {
+    /**
+     * Factory method to create a Logger from import.meta.url
+     * @param metaUrl - import.meta.url from the calling module
+     * @param minLevel - Minimum log level to display (defaults to WARN)
+     */
+    static fromMetaUrl(metaUrl, loggerConfig = Logger.LoggerConfigDefault) {
+        // Use WHATWG URL (available in Node and browsers) instead of node:url.fileURLToPath
+        // so this module stays browser-safe when bundled by Vite.
+        const parsedUrl = new URL(metaUrl);
+        const absFilename = parsedUrl.pathname;
+        return new Logger(absFilename, loggerConfig);
+    }
+    /**
+     * @param absFilename - Logger name (typically module path)
+     * @param minLevel - Minimum log level to display (defaults to INFO)
+     */
+    constructor(absFilename, loggerConfig) {
+        this._loggerConfig = Logger.LoggerConfigDefault;
+        this._absFilename = absFilename;
+        this._loggerConfig = loggerConfig;
+        // Strip file extension from filename for glob matching. Done with string ops
+        // so this module avoids node:path and remains browser-safe.
+        const lastDotIndex = this._absFilename.lastIndexOf('.');
+        const lastSeparatorIndex = this._absFilename.lastIndexOf('/');
+        const hasExtension = lastDotIndex !== -1 && lastDotIndex > lastSeparatorIndex;
+        this._filenameWithoutExt = hasExtension === true
+            ? this._absFilename.slice(0, lastDotIndex)
+            : this._absFilename;
+        // parse LOGGER environment variable for log filtering patterns. `process` is
+        // undefined in browsers, so guard the access.
+        const loggerEnvVar = typeof process !== 'undefined'
+            ? process.env['LOGGER']
+            : undefined;
+        if (loggerEnvVar === undefined || loggerEnvVar === '') {
+            this._parsedPatterns = [];
+        }
+        else {
+            this._parsedPatterns = Logger.parseLoggerEnv(loggerEnvVar);
+        }
+    }
+    ///////////////////////////////////////////////////////////////////////////////
+    ///////////////////////////////////////////////////////////////////////////////
+    //	log filtering logic based on LOGGER environment variable
+    ///////////////////////////////////////////////////////////////////////////////
+    ///////////////////////////////////////////////////////////////////////////////
+    /**
+     * LOGGER environment variable domain specific language:
+     * - comma separated list of patterns
+     *   - pattern1,pattern2,...,patternN
+     * Each pattern is:
+     * - {sign}{filename_glob}:{log_level}
+     * - sign: [-+] to add/remove filter
+     *   - if omitted, defaults to + (enable)
+     * - if log_level is omitted, it defaults to WARN
+     * - log_level can be one of DEBUG, INFO, WARN, ERROR
+     * - filename_glob is applied to __filename from import.meta.url without the file extension
+     *
+     * Example:
+     * - LOGGER="*strategy*" enables WARN logs for all loggers with "strategy" in their name
+     * - LOGGER="*:DEBUG" enables DEBUG logs for all loggers
+     * - LOGGER="*strategy:DEBUG" enables DEBUG logs for all loggers with "strategy" in their name
+     * - LOGGER="-*strategy:DEBUG" disables DEBUG logs for all loggers with "strategy" in their name
+     * - LOGGER="*trading-core*:INFO" enables INFO logs for all loggers in the trading-core package
+     * - LOGGER='**:INFO' npm run dev:batch enables INFO logs for all loggers
+     */
+    static parseLoggerEnv(loggerEnv) {
+        const loggerPatterns = [];
+        for (const rawPattern of loggerEnv.split(',')) {
+            const trimmedPattern = rawPattern.trim();
+            if (trimmedPattern.length === 0)
+                continue;
+            let enable = true;
+            let patternBody = trimmedPattern;
+            if (patternBody.startsWith('-')) {
+                enable = false;
+                patternBody = patternBody.slice(1);
+            }
+            else if (patternBody.startsWith('+')) {
+                patternBody = patternBody.slice(1);
+            }
+            const colonIndex = patternBody.lastIndexOf(':');
+            let glob;
+            let logLevel = Logger.DEFAULT_LEVEL;
+            if (colonIndex !== -1) {
+                const levelCandidate = patternBody.slice(colonIndex + 1).toUpperCase();
+                if (levelCandidate in Logger.LEVEL_RANK) {
+                    glob = patternBody.slice(0, colonIndex);
+                    logLevel = levelCandidate;
+                }
+                else {
+                    glob = patternBody;
+                }
+            }
+            else {
+                glob = patternBody;
+            }
+            const loggerPattern = { enable, glob, level: logLevel };
+            loggerPatterns.push(loggerPattern);
+        }
+        return loggerPatterns;
+    }
+    /**
+     * Determine if a log message with the given log level should be filtered out based on the LOGGER environment variable patterns
+     * and the logger's filename.
+     * @param logLevel - Log level of the message
+     * @returns boolean indicating whether the message should be filtered out
+     */
+    shouldBeFiltered(logLevel) {
+        // If no LOGGER env variable is set, default to filtering out logs below INFO
+        if (this._parsedPatterns.length === 0) {
+            const currentLevelRank = Logger.LEVEL_RANK[logLevel];
+            const minLevelRank = Logger.LEVEL_RANK[Logger.DEFAULT_LEVEL];
+            const shouldBeFiltered = currentLevelRank > minLevelRank;
+            return shouldBeFiltered;
+        }
+        // Walk patterns in order; last matching pattern wins
+        let minLevel = Logger.DEFAULT_LEVEL;
+        let hasMatched = false;
+        let isEnabled = true;
+        for (const parsedPattern of this._parsedPatterns) {
+            const globMatch = minimatch(this._filenameWithoutExt, parsedPattern.glob);
+            if (globMatch === false)
+                continue;
+            hasMatched = true;
+            isEnabled = parsedPattern.enable;
+            minLevel = parsedPattern.level;
+        }
+        // if there is filter, and it doesn't match, then filter out
+        if (hasMatched === false)
+            return true;
+        // if there is filter, and it matches, but it's disabled, then filter out
+        if (isEnabled === false)
+            return true;
+        // if there is filter, and it matches, and it's enabled, then check log level
+        const currentLevelRank = Logger.LEVEL_RANK[logLevel];
+        const minLevelRank = Logger.LEVEL_RANK[minLevel];
+        const shouldBeFiltered = currentLevelRank > minLevelRank;
+        // if log level is below the minimum level specified in the filter, then filter out
+        return shouldBeFiltered;
+    }
+    ///////////////////////////////////////////////////////////////////////////////
+    ///////////////////////////////////////////////////////////////////////////////
+    //	private log function
+    ///////////////////////////////////////////////////////////////////////////////
+    ///////////////////////////////////////////////////////////////////////////////
+    /**
+     * Core logging method
+     * @param logLevel - Log level
+     * @param msg - Log message
+     * @param meta - Optional metadata object to display
+     */
+    _log(logLevel, msg, meta) {
+        // // Skip if log level is below minimum threshold
+        const shouldBeFiltered = this.shouldBeFiltered(logLevel);
+        if (shouldBeFiltered)
+            return;
+        // Create a nounce base on this._filenameWithoutExt string
+        const nounceFromFilename = this._filenameWithoutExt.split('').reduce((acc, char) => acc + char.charCodeAt(0), 0);
+        const colorFns = [
+            Chalk.magenta,
+            Chalk.blueBright,
+            Chalk.green,
+            Chalk.yellow,
+        ];
+        const colorFn = colorFns[nounceFromFilename % colorFns.length];
+        const timestamp = new Date();
+        const colorize = Logger.LEVEL_COLOR[logLevel];
+        const fileName15Char = this._filenameWithoutExt.length <= Logger._maxFilenameLength
+            ? this._filenameWithoutExt
+            : '...' + this._filenameWithoutExt.slice(-Logger._maxFilenameLength + 3);
+        const parts = [
+            // Chalk.dim(timestamp.toISOString()),
+            colorize(logLevel.padEnd(5)),
+            colorFn(fileName15Char.padEnd(15)),
+            msg,
+        ];
+        // Append metadata if provided
+        if (meta !== undefined && Object.keys(meta).length > 0) {
+            const metaString = Object.entries(meta)
+                .map(([key, value]) => `${Chalk.green(key)}=${Chalk.white(typeof value === 'string' ? value : JSON.stringify(value))}`)
+                .join(' ');
+            parts.push(Chalk.dim('|'), metaString);
+        }
+        const line = parts.join(' ');
+        // Error and warn levels go to stderr, others to stdout
+        if (logLevel === 'WARN' || logLevel === 'ERROR' || this._loggerConfig.allToStderr === true) {
+            console.error(line);
+        }
+        else {
+            console.log(line);
+        }
+    }
+    ///////////////////////////////////////////////////////////////////////////////
+    ///////////////////////////////////////////////////////////////////////////////
+    //	public logging methods
+    ///////////////////////////////////////////////////////////////////////////////
+    ///////////////////////////////////////////////////////////////////////////////
+    // Public logging methods for each severity level
+    debug(msg, meta) {
+        this._log('DEBUG', msg, meta);
+    }
+    info(msg, meta) {
+        this._log('INFO', msg, meta);
+    }
+    warn(msg, meta) {
+        this._log('WARN', msg, meta);
+    }
+    error(msg, meta) {
+        this._log('ERROR', msg, meta);
+    }
+}
+Logger.LEVEL = {
+    DEBUG: 'DEBUG',
+    INFO: 'INFO',
+    WARN: 'WARN',
+    ERROR: 'ERROR',
+};
+Logger.DEFAULT_LEVEL = Logger.LEVEL.WARN;
+/** Rank mapping for log level filtering */
+Logger.LEVEL_RANK = {
+    DEBUG: 3,
+    INFO: 2,
+    WARN: 1,
+    ERROR: 0
+};
+/**
+ * Maximum length for filename in log output; longer names will be truncated with ellipsis. This is to prevent log lines
+ * from becoming too long due to long file paths.
+ */
+Logger._maxFilenameLength = 30;
+/** Color scheme for each log level */
+Logger.LEVEL_COLOR = {
+    DEBUG: Chalk.gray,
+    INFO: Chalk.cyan,
+    WARN: Chalk.yellow,
+    ERROR: Chalk.red,
+};
+// 
+Logger.LoggerConfigDefault = {
+    allToStderr: false,
+};
+///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////////
+//	Usage Example
+///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////////
+async function usageExample() {
+    process.env.LOGGER = '**:INFO'; // Enable DEBUG logs for this logger
+    console.log(Chalk.blue('--- Logger Usage Example ---'));
+    console.log(Chalk.blue('Current LOGGER env variable:'), process.env.LOGGER);
+    const logger = Logger.fromMetaUrl(import.meta.url);
+    logger.debug('This is a debug message', { user: 'alice', action: 'testDebug' });
+    logger.info('This is an info message', { user: 'bob', action: 'testInfo' });
+    logger.warn('This is a warning message', { user: 'carol', action: 'testWarn' });
+    logger.error('This is an error message', { user: 'dave', action: 'testError' });
+}
+if (import.meta.main) {
+    usageExample().catch(err => {
+        console.error('Error in usage example:', err);
+    });
+}
+//# sourceMappingURL=logger.js.map

package/dist/shared/logger.js.map

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

package/docs/brainstorm_scrap_by_ai.md

@@ -29,4 +29,4 @@
   - possible by selector language ? yes
 - get link with an url starting with "https://www.welcometothejungle.com/fr/companies/"
   - on a https://www.welcometothejungle.com/fr/jobs?refinementList%5Boffices.country_code%5D%5B%5D=FR&query=machine%20learning&page=7
-  - `npx tsx ./src/fastbrowser_cli/fastbrowser_cli.ts query_selectors_all --selector 'RootWebArea > link[url^="https://www.welcometothejungle.com/fr/companies/"]'`
+  - `npx tsx ./src/fastbrowser_cli/fastbrowser_cli.ts query_selectors --all --selector 'RootWebArea > link[url^="https://www.welcometothejungle.com/fr/companies/"]'`

package/docs/feature_support_cli.md

@@ -56,14 +56,6 @@ fastbrowser-cli click -s 'button[name="Submit"]'
 # Fill a form field by accessibility selector
 fastbrowser-cli fill_form -s 'textbox[name="Email"]' --value "hello@example.com"
 
-# Query the accessibility tree — --selector can be repeated for multiple selectors.
-# --limit and --with-ancestors apply to all selectors equally.
-fastbrowser-cli query_selectors_all --selector "button" --selector "link" --limit 5 --with-ancestors
-fastbrowser-cli query_selectors_all --selector 'heading[level="1"]' --no-with-ancestors
-
-# For per-selector control over limit/withAncestors, pass a JSON array directly:
-fastbrowser-cli query_selectors_all --selectors-json '[{"selector":"button","limit":3,"withAncestors":true},{"selector":"link","limit":0,"withAncestors":false}]'
-
 # Query the accessibility tree for the first matching element per selector (mirrors DOM querySelector).
 # --selector can be repeated for multiple selectors; --with-ancestors applies to all.
 fastbrowser-cli query_selectors --selector "button"
@@ -72,6 +64,13 @@ fastbrowser-cli query_selectors --selector "button" --selector "link" --no-with-
 # For per-selector control over withAncestors, pass a JSON array directly:
 fastbrowser-cli query_selectors --selectors-json '[{"selector":"button","withAncestors":true},{"selector":"link","withAncestors":false}]'
 
+# Pass -a/--all to return every match per selector. --limit caps results per selector (0 = unlimited).
+fastbrowser-cli query_selectors --all --selector "button" --selector "link" --limit 5 --with-ancestors
+fastbrowser-cli query_selectors --all --selector 'heading[level="1"]' --no-with-ancestors
+
+# For per-selector control over limit/withAncestors with --all, pass a JSON array directly:
+fastbrowser-cli query_selectors --all --selectors-json '[{"selector":"button","limit":3,"withAncestors":true},{"selector":"link","limit":0,"withAncestors":false}]'
+
 # Press a sequence of keys
 fastbrowser-cli press_keys --keys "Tab, Tab, Enter"
 fastbrowser-cli press_keys --keys "Hello, Tab, Enter"