@sonisoft/now-sdk-ext-cli 1.1.0-alpha.3 → 2.0.0-alpha.0

package/dist/commands/exec/index.js

@@ -1,51 +1,311 @@
 /* eslint-disable @typescript-eslint/no-unused-vars */
 /* eslint-disable perfectionist/sort-objects */
-import { Args } from '@oclif/core';
+import { Args, Flags } from '@oclif/core';
 import { BackgroundScriptExecutor, Logger, NowStringUtil } from '@sonisoft/now-sdk-ext-core';
 import fs from 'node:fs';
 import path from 'node:path';
+import * as readline from 'node:readline';
 import { AuthenticatedCommand } from '../../common/authenticated-command.js';
+import { getCachedScopes } from '../../common/scope-autocomplete.js';
 export class Exec extends AuthenticatedCommand {
     static args = {
-        scope: Args.string({ description: 'Scope to execute file in.', required: true }),
-        file: Args.string({ description: 'File to execute in scripts background.', required: true }),
+        scope: Args.string({
+            description: 'Scope to execute script in. Use "global" for global scope.',
+            required: true
+        }),
+        file: Args.string({ description: 'File to execute in scripts background. If omitted, starts REPL mode.', required: false }),
     };
-    static description = 'Execute a local javascript file on a ServiceNow instance using Scripts - Background remotely. Returns the output/raw console output that Scripts - Background outputs to the browser in order to support the execution and result being piped to another command.';
+    // Autocomplete hook for scope argument
+    static autocomplete = {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        async scope(ctx) {
+            const authFlag = ctx.flags?.auth;
+            try {
+                const scopes = await getCachedScopes(authFlag);
+                return ['global', ...scopes];
+            }
+            catch {
+                return ['global'];
+            }
+        }
+    };
+    static description = 'Execute JavaScript on a ServiceNow instance remotely using Scripts - Background.\n\n' +
+        'This command allows you to run JavaScript either from files or interactively via REPL mode. ' +
+        'It mimics the functionality of the Scripts - Background interface in ServiceNow, providing a way to ' +
+        'execute scripts programmatically without manual interaction. The output is returned in real-time and can be ' +
+        'piped to other commands or saved to files.\n\n' +
+        'Modes:\n' +
+        '  • File Mode: Provide a file path to execute scripts from a file\n' +
+        '  • REPL Mode: Omit the file path to start an interactive session\n\n' +
+        'Features:\n' +
+        '  • Execute local JavaScript files remotely\n' +
+        '  • Interactive REPL for ad-hoc script execution\n' +
+        '  • Script parameterization with {placeholder} replacement\n' +
+        '  • Multi-line script support in REPL\n' +
+        '  • Scope-aware execution (global or custom scope)\n' +
+        '  • Real-time console output capture\n' +
+        '  • Pipe-able output for command chaining\n' +
+        '  • Debug logging support\n' +
+        '  • Useful for data migration, testing, and administrative tasks\n\n' +
+        'Script Parameterization:\n' +
+        '  Use {paramName} placeholders in your script files, then provide values via --params:\n' +
+        '  • Supports any JSON-serializable values (strings, numbers, booleans)\n' +
+        '  • Multiple parameters supported\n' +
+        '  • All occurrences of each placeholder are replaced\n' +
+        '  • Example: {token}, {username}, {environment}\n\n' +
+        'REPL Controls:\n' +
+        '  • Press Enter to add a new line\n' +
+        '  • Type .exec or press Ctrl+D to execute the script\n' +
+        '  • Type .clear to clear the current input\n' +
+        '  • Type .exit or press Ctrl+C twice to exit REPL\n\n' +
+        '⚠️  IMPORTANT SECURITY WARNING:\n' +
+        'This command executes scripts with the same permissions and risks as using Scripts - Background directly\n' +
+        'in ServiceNow. Always:\n' +
+        '  • Review scripts before execution\n' +
+        '  • Test in non-production environments first\n' +
+        '  • Use appropriate scoping to limit access\n' +
+        '  • Be aware of data modification risks\n' +
+        '  • Follow your organization\'s security policies\n' +
+        '  • Never execute untrusted scripts\n\n' +
+        'Script Capabilities:\n' +
+        '  Scripts run with full GlideSystem API access and can:\n' +
+        '  • Query and modify database records\n' +
+        '  • Create, update, and delete data\n' +
+        '  • Execute business rules and workflows\n' +
+        '  • Access all APIs available in Scripts - Background\n' +
+        '  • Use gs, GlideRecord, GlideAggregate, and other server-side APIs';
     static examples = [
-        `<%= config.bin %> <%= command.id %> exec global test.js --auth sn_alias
-test
-`,
+        {
+            description: 'Start REPL in global scope',
+            command: '<%= config.bin %> <%= command.id %> global --auth dev-instance',
+        },
+        {
+            description: 'Start REPL in custom application scope',
+            command: '<%= config.bin %> <%= command.id %> x_my_custom_app --auth dev-instance',
+        },
+        {
+            description: 'Execute a script file in global scope',
+            command: '<%= config.bin %> <%= command.id %> global ./scripts/cleanup.js --auth dev-instance',
+        },
+        {
+            description: 'Execute a script file in a custom application scope',
+            command: '<%= config.bin %> <%= command.id %> x_my_custom_app ./scripts/app-config.js --auth dev-instance',
+        },
+        {
+            description: 'Execute a parameterized script with single parameter',
+            command: '<%= config.bin %> <%= command.id %> global ./scripts/query-user.js --auth dev-instance --params \'{"username":"admin"}\'',
+        },
+        {
+            description: 'Execute a parameterized script with multiple parameters',
+            command: '<%= config.bin %> <%= command.id %> global ./scripts/update-record.js --auth dev-instance --params \'{"table":"incident","field":"priority","value":"1"}\'',
+        },
+        {
+            description: 'Execute and save output to a file',
+            command: '<%= config.bin %> <%= command.id %> global ./scripts/report.js --auth dev-instance > report.txt',
+        },
+        {
+            description: 'Execute and pipe output to grep for filtering',
+            command: '<%= config.bin %> <%= command.id %> global ./scripts/list-users.js --auth dev-instance | grep "admin"',
+        },
+        {
+            description: 'Execute with debug logging to troubleshoot issues',
+            command: '<%= config.bin %> <%= command.id %> global ./script.js --auth dev-instance --log-level debug',
+        },
+        {
+            description: 'Execute with parameters for template replacement',
+            command: '<%= config.bin %> <%= command.id %> global ./script.js --auth dev-instance --params \'{"token":"abc123","env":"dev"}\'',
+        },
     ];
     static flags = {
-    // from: Flags.string({char: 'f', description: 'Who is saying hello', required: true}),
+        params: Flags.string({
+            char: 'p',
+            description: 'JSON object of parameters to replace in script file. Use {paramName} syntax in your script.',
+            required: false
+        }),
     };
     _logger = new Logger("ExecCommand");
     async run() {
         const { args, flags } = await this.parse(Exec);
-        if (!NowStringUtil.isStringEmpty(args.file) && !NowStringUtil.isStringEmpty(args.scope)) {
+        if (NowStringUtil.isStringEmpty(args.scope)) {
+            this.error("Scope is required.");
+        }
+        else if (!NowStringUtil.isStringEmpty(args.file) && args.file) {
+            // File mode - execute script from file
+            await this.executeFromFile(args.file, args.scope, flags.params);
+        }
+        else {
+            // REPL mode - interactive script execution
+            await this.startREPL(args.scope);
+        }
+    }
+    applyParameters(script, paramsJson) {
+        try {
+            const params = JSON.parse(paramsJson);
+            if (typeof params !== 'object' || params === null) {
+                this.error('Parameters must be a valid JSON object');
+                return script;
+            }
+            let processedScript = script;
+            // Replace each parameter in the script
+            for (const [key, value] of Object.entries(params)) {
+                const placeholder = `{${key}}`;
+                const replacement = String(value);
+                // Replace all occurrences of the placeholder
+                processedScript = processedScript.split(placeholder).join(replacement);
+            }
+            // Log parameter replacements in debug mode
+            this._logger.debug(`Applied ${Object.keys(params).length} parameter replacement(s)`, params);
+            return processedScript;
+        }
+        catch (error) {
+            this._logger.error("Error parsing parameters JSON", error);
+            this.error(`Invalid JSON in --params: ${error.message}`);
+            return script;
+        }
+    }
+    async executeFromFile(filePath, scope, params) {
+        try {
+            const resolvedPath = path.resolve(filePath);
+            let script = fs.readFileSync(resolvedPath).toString('utf8');
+            // Apply parameter replacement if params provided
+            if (params) {
+                script = this.applyParameters(script, params);
+            }
+            await this.executeScript(script, scope);
+        }
+        catch (error) {
+            this._logger.error("Error occurred when executing background script from file.", error);
+            this.error(error);
+        }
+    }
+    async executeScript(script, scope) {
+        try {
+            const executor = new BackgroundScriptExecutor(this.instance, scope);
+            const result = await executor.executeScript(script, scope, this.instance);
+            this._logger.debug("Ran background script", result);
+            if (result !== null && result.scriptResults !== null) {
+                const { scriptResults } = result;
+                for (const scriptResult of scriptResults) {
+                    console.log(scriptResult.line);
+                    this._logger.debug(scriptResult.line);
+                }
+            }
+            else {
+                throw new Error("Response from script execution was null or undefined. Please review logs to identify the problem.");
+            }
+        }
+        catch (error) {
+            this._logger.error("Error occurred when executing background script.", error);
+            throw error;
+        }
+    }
+    async startREPL(scope) {
+        this.log(`\n╔═══════════════════════════════════════════════════════════════╗`);
+        this.log(`║  ServiceNow Script Executor REPL                              ║`);
+        this.log(`╚═══════════════════════════════════════════════════════════════╝`);
+        this.log(`  Scope: ${scope}`);
+        this.log(`  Instance: ${this.instance.getHost()}`);
+        this.log(`\n  Commands:`);
+        this.log(`    .exec    - Execute the current script`);
+        this.log(`    .clear   - Clear the current input`);
+        this.log(`    .exit    - Exit REPL`);
+        this.log(`    Ctrl+D   - Execute the current script`);
+        this.log(`    Ctrl+C   - Cancel current input or exit (press twice)`);
+        this.log(`\n  Type your script below (press Enter for new lines):\n`);
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            prompt: 'sn> ',
+            terminal: true
+        });
+        let scriptBuffer = [];
+        let lineCount = 0;
+        const executeBufferedScript = async () => {
+            if (scriptBuffer.length === 0) {
+                this.log('  (No script to execute)\n');
+                rl.prompt();
+                return;
+            }
+            const script = scriptBuffer.join('\n');
+            this.log(`\n  Executing script (${scriptBuffer.length} lines)...\n`);
+            this.log(`  ${'─'.repeat(63)}\n`);
             try {
-                const filePath = path.resolve(args.file);
-                const script = fs.readFileSync(filePath).toString('utf8');
-                const scope = args.scope ?? "global";
-                const executor = new BackgroundScriptExecutor(this.instance, args.scope);
-                ;
-                const result = await executor.executeScript(script, scope, this.instance);
-                this._logger.debug("Ran background script", result);
-                if (result !== null && result.scriptResults !== null) {
-                    const { scriptResults } = result;
-                    for (const scriptResult of scriptResults) {
-                        this.log(scriptResult.line);
-                    }
+                await this.executeScript(script, scope);
+                this.log(`\n  ${'─'.repeat(63)}`);
+                this.log(`  ✓ Script executed successfully\n`);
+            }
+            catch (error) {
+                this.log(`\n  ${'─'.repeat(63)}`);
+                this.log(`  ✗ Script execution failed`);
+                this.log(`  Error: ${error.message}\n`);
+            }
+            scriptBuffer = [];
+            lineCount = 0;
+            rl.setPrompt('sn> ');
+            rl.prompt();
+        };
+        const clearBuffer = () => {
+            scriptBuffer = [];
+            lineCount = 0;
+            this.log('  (Input cleared)\n');
+            rl.setPrompt('sn> ');
+            rl.prompt();
+        };
+        rl.on('line', async (line) => {
+            const trimmedLine = line.trim();
+            // Handle REPL commands
+            if (trimmedLine === '.exec') {
+                await executeBufferedScript();
+                return;
+            }
+            if (trimmedLine === '.clear') {
+                clearBuffer();
+                return;
+            }
+            if (trimmedLine === '.exit') {
+                this.log('\n  Goodbye! 👋\n');
+                rl.close();
+                return;
+            }
+            // Add line to buffer
+            scriptBuffer.push(line);
+            lineCount++;
+            // Update prompt to show continuation
+            rl.setPrompt(`... `);
+            rl.prompt();
+        });
+        rl.on('close', async () => {
+            // Execute on Ctrl+D
+            if (scriptBuffer.length > 0) {
+                this.log('\n');
+                await executeBufferedScript();
+            }
+            this.exit(0);
+        });
+        // Handle Ctrl+C
+        let ctrlCCount = 0;
+        rl.on('SIGINT', () => {
+            ctrlCCount++;
+            if (ctrlCCount === 1) {
+                if (scriptBuffer.length > 0) {
+                    // First Ctrl+C: clear buffer
+                    this.log('\n  (Input cancelled. Press Ctrl+C again to exit)\n');
+                    clearBuffer();
+                    ctrlCCount = 0;
                 }
                 else {
-                    throw new Error("Response from script execution was null or undefined. Please review logs to identify the problem.");
+                    this.log('\n  (Press Ctrl+C again to exit)\n');
+                    rl.prompt();
                 }
             }
-            catch (error) {
-                this._logger.error("Error occurred when executing background script.", error);
-                this.error(error);
+            else {
+                // Second Ctrl+C: exit
+                this.log('\n  Goodbye! 👋\n');
+                rl.close();
+                this.exit(0);
             }
-        }
+        });
+        rl.prompt();
     }
 }
 //# sourceMappingURL=index.js.map

package/dist/commands/exec/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/exec/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,+CAA+C;AAC/C,OAAO,EAAC,IAAI,EAAiB,MAAM,aAAa,CAAA;AAChD,OAAO,EAAG,wBAAwB,EAAG,MAAM,EAAE,aAAa,EAAuB,MAAM,4BAA4B,CAAC;AACpH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAE5E,MAAM,OAAO,IAAK,SAAQ,oBAAiC;IAEzD,MAAM,CAAC,IAAI,GAAG;QACZ,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAC,WAAW,EAAE,2BAA2B,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAC;QAC9E,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAC,WAAW,EAAE,wCAAwC,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAC;KAC3F,CAAA;IAED,MAAM,CAAC,WAAW,GAAG,mQAAmQ,CAAC;IAEzR,MAAM,CAAC,QAAQ,GAAG;QAChB;;CAEH;KACE,CAAA;IAED,MAAM,CAAC,KAAK,GAAG;IACb,uFAAuF;KACxF,CAAA;IAEO,OAAO,GAAU,IAAI,MAAM,CAAC,aAAa,CAAC,CAAC;IAEnD,KAAK,CAAC,GAAG;QACP,MAAM,EAAC,IAAI,EAAE,KAAK,EAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE7C,IAAG,CAAC,aAAa,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAC,CAAC;YACtF,IAAG,CAAC;gBACF,MAAM,QAAQ,GAAU,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAChD,MAAM,MAAM,GAAU,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACjE,MAAM,KAAK,GAAU,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC;gBAE5C,MAAM,QAAQ,GAA6B,IAAI,wBAAwB,CAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAE,CAAC;gBAAA,CAAC;gBACtG,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAE,CAAC;gBAC5E,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;gBACpD,IAAG,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,aAAa,KAAK,IAAI,EAAC,CAAC;oBACnD,MAAM,EAAC,aAAa,EAAC,GAAG,MAAM,CAAC;oBAC/B,KAAI,MAAM,YAAY,IAAI,aAAa,EAAC,CAAC;wBACvC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;oBAC9B,CAAC;gBAEH,CAAC;qBAAI,CAAC;oBACJ,MAAM,IAAI,KAAK,CAAC,mGAAmG,CAAC,CAAC;gBACvH,CAAC;YAEH,CAAC;YAAA,OAAM,KAAK,EAAC,CAAC;gBACZ,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,kDAAkD,EAAE,KAAc,CAAC,CAAC;gBACvF,IAAI,CAAC,KAAK,CAAC,KAAc,CAAC,CAAC;YAC7B,CAAC;QAGH,CAAC;IAEH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/exec/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/log/index.d.ts

@@ -0,0 +1,46 @@
+import { AuthenticatedCommand } from '../../common/authenticated-command.js';
+export declare class Log extends AuthenticatedCommand<typeof Log> {
+    static args: {};
+    static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static flags: {
+        output: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        interval: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<number, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        'no-color': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        filter: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+    };
+    private _logger;
+    private filterRules;
+    private syslogReader?;
+    run(): Promise<void>;
+    private displayHeader;
+    private displayLog;
+    private handleExit;
+    private highlightKeywords;
+    /**
+     * Check if a log record matches a single filter rule
+     * @param log The log record to check
+     * @param rule The filter rule to apply
+     * @returns true if the log matches the filter, false otherwise
+     */
+    private matchesFilter;
+    /**
+     * Check if a log record matches all filter rules
+     * @param log The log record to check
+     * @returns true if the log matches all filters (AND logic), false otherwise
+     */
+    private matchesFilters;
+    /**
+     * Parse a filter string into a FilterRule object
+     * Supports formats:
+     *   - "field OPERATOR value"
+     *   - "OPERATOR value" (defaults to message field)
+     * @param filterStr The filter string to parse
+     * @returns A FilterRule object
+     */
+    private parseFilter;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/log/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/log/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAiB5E,qBAAa,GAAI,SAAQ,oBAAoB,CAAC,OAAO,GAAG,CAAC;IAEvD,MAAM,CAAC,IAAI,KAAK;IAEhB,MAAM,CAAC,WAAW,SAoCiD;IAEnE,MAAM,CAAC,QAAQ;;;QAiCd;IAED,MAAM,CAAC,KAAK;;;;;MA0BX;IAED,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,YAAY,CAAC,CAAe;IAE9B,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IA6D1B,OAAO,CAAC,aAAa;IAoDrB,OAAO,CAAC,UAAU;IA0ElB,OAAO,CAAC,UAAU;IAiBlB,OAAO,CAAC,iBAAiB;IAYzB;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAyErB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAatB;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;CAsDpB"}