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

package/dist/commands/aggregate/count.d.ts

@@ -0,0 +1,16 @@
+import { AuthenticatedCommand } from '../../common/authenticated-command.js';
+export declare class AggregateCount extends AuthenticatedCommand<typeof AggregateCount> {
+    static args: {};
+    static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static flags: {
+        table: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        query: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=count.d.ts.map

package/dist/commands/aggregate/count.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"count.d.ts","sourceRoot":"","sources":["../../../src/commands/aggregate/count.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAG5E,qBAAa,cAAe,SAAQ,oBAAoB,CAAC,OAAO,cAAc,CAAC;IAE7E,MAAM,CAAC,IAAI,KAAK;IAClB,MAAM,CAAC,WAAW,SAKuB;IACzC,MAAM,CAAC,QAAQ;;;QAaZ;IACH,MAAM,CAAC,KAAK;;;;MAiBT;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAwB3B"}

package/dist/commands/aggregate/count.js

@@ -0,0 +1,67 @@
+/* eslint-disable perfectionist/sort-objects */
+import { Flags } from '@oclif/core';
+import { AggregateQuery } from '@sonisoft/now-sdk-ext-core';
+import { AuthenticatedCommand } from '../../common/authenticated-command.js';
+import { AggregateDisplayService } from '../../services/aggregate-display.service.js';
+export class AggregateCount extends AuthenticatedCommand {
+    static args = {};
+    static description = 'Count records in a ServiceNow table.\n\n' +
+        'Uses the Stats API to efficiently count records with optional encoded query filtering.\n\n' +
+        'Features:\n' +
+        '  \u2022 Fast record counting via Stats API\n' +
+        '  \u2022 Optional encoded query filtering\n' +
+        '  \u2022 JSON output for scripting';
+    static examples = [
+        {
+            description: 'Count all incidents',
+            command: '<%= config.bin %> <%= command.id %> --table incident --auth dev',
+        },
+        {
+            description: 'Count active critical incidents',
+            command: '<%= config.bin %> <%= command.id %> --table incident --query "active=true^priority=1" --auth dev',
+        },
+        {
+            description: 'Count as JSON',
+            command: '<%= config.bin %> <%= command.id %> --table incident --query "active=true" --json --auth dev',
+        },
+    ];
+    static flags = {
+        'table': Flags.string({
+            char: 't',
+            description: 'ServiceNow table name to count records in',
+            required: true,
+        }),
+        'query': Flags.string({
+            char: 'q',
+            description: 'ServiceNow encoded query string to filter records',
+            required: false,
+        }),
+        'json': Flags.boolean({
+            char: 'j',
+            description: 'Output results as JSON',
+            required: false,
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(AggregateCount);
+        const displayService = new AggregateDisplayService();
+        try {
+            const aggregateQuery = new AggregateQuery(this.instance);
+            this.log(`Counting records in table: ${flags.table}`);
+            const count = await aggregateQuery.count({
+                table: flags.table,
+                query: flags.query,
+            });
+            const lines = displayService.formatCountResult(count, flags.table, flags.query, flags.json ?? false);
+            for (const line of lines) {
+                (flags.json ?? false) ? console.log(line) : this.log(line);
+            }
+        }
+        catch (error) {
+            this._logger.error("Error occurred when counting records.", error);
+            this.error(error);
+        }
+    }
+}
+//# sourceMappingURL=count.js.map

package/dist/commands/aggregate/count.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"count.js","sourceRoot":"","sources":["../../../src/commands/aggregate/count.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAE/C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAE3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAA;AAErF,MAAM,OAAO,cAAe,SAAQ,oBAA2C;IAE7E,MAAM,CAAC,IAAI,GAAG,EAAE,CAAA;IAClB,MAAM,CAAC,WAAW,GAAG,0CAA0C;QAC3D,4FAA4F;QAC5F,aAAa;QACb,+CAA+C;QAC/C,6CAA6C;QAC7C,oCAAoC,CAAC;IACzC,MAAM,CAAC,QAAQ,GAAG;QACd;YACE,WAAW,EAAE,qBAAqB;YAClC,OAAO,EAAE,iEAAiE;SAC3E;QACD;YACE,WAAW,EAAE,iCAAiC;YAC9C,OAAO,EAAE,kGAAkG;SAC5G;QACD;YACE,WAAW,EAAE,eAAe;YAC5B,OAAO,EAAE,8FAA8F;SACxG;KACF,CAAA;IACH,MAAM,CAAC,KAAK,GAAG;QACX,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,2CAA2C;YACxD,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,mDAAmD;YAChE,QAAQ,EAAE,KAAK;SAChB,CAAC;QACF,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC;YACpB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,wBAAwB;YACrC,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,KAAK;SACf,CAAC;KACH,CAAA;IAED,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACnD,MAAM,cAAc,GAAG,IAAI,uBAAuB,EAAE,CAAC;QAErD,IAAI,CAAC;YACH,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAEzD,IAAI,CAAC,GAAG,CAAC,8BAA8B,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YAEtD,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC;gBACvC,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,KAAK,EAAE,KAAK,CAAC,KAAK;aACnB,CAAC,CAAC;YAEH,MAAM,KAAK,GAAG,cAAc,CAAC,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC;YACrG,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC7D,CAAC;QAEH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,KAAc,CAAC,CAAC;YAC5E,IAAI,CAAC,KAAK,CAAC,KAAc,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC"}

package/dist/commands/aggregate/group.d.ts

@@ -0,0 +1,24 @@
+import { AuthenticatedCommand } from '../../common/authenticated-command.js';
+export declare class AggregateGroup extends AuthenticatedCommand<typeof AggregateGroup> {
+    static args: {};
+    static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static flags: {
+        table: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        query: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        'group-by': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string[], import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        count: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        avg: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        min: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        max: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        sum: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        having: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        'display-value': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        json: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=group.d.ts.map

package/dist/commands/aggregate/group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../../../src/commands/aggregate/group.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAG5E,qBAAa,cAAe,SAAQ,oBAAoB,CAAC,OAAO,cAAc,CAAC;IAE7E,MAAM,CAAC,IAAI,KAAK;IAClB,MAAM,CAAC,WAAW,SAQuB;IACzC,MAAM,CAAC,QAAQ;;;QAaZ;IACH,MAAM,CAAC,KAAK;;;;;;;;;;;;MA2DT;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAgC3B"}

package/dist/commands/aggregate/group.js

@@ -0,0 +1,120 @@
+/* eslint-disable perfectionist/sort-objects */
+import { Flags } from '@oclif/core';
+import { AggregateQuery } from '@sonisoft/now-sdk-ext-core';
+import { AuthenticatedCommand } from '../../common/authenticated-command.js';
+import { AggregateDisplayService } from '../../services/aggregate-display.service.js';
+export class AggregateGroup extends AuthenticatedCommand {
+    static args = {};
+    static description = 'Run a grouped aggregate query on a ServiceNow table.\n\n' +
+        'Compute aggregate statistics (COUNT, AVG, MIN, MAX, SUM) grouped by one or more fields ' +
+        'using the Stats API. Supports HAVING clauses for filtering groups.\n\n' +
+        'Features:\n' +
+        '  \u2022 GROUP BY one or more fields\n' +
+        '  \u2022 Compute AVG, MIN, MAX, SUM per group\n' +
+        '  \u2022 HAVING clause for group filtering\n' +
+        '  \u2022 Display values for reference fields\n' +
+        '  \u2022 JSON output for scripting';
+    static examples = [
+        {
+            description: 'Count incidents grouped by priority',
+            command: '<%= config.bin %> <%= command.id %> --table incident --group-by priority --count --auth dev',
+        },
+        {
+            description: 'Average reassignment count grouped by priority and assignment group',
+            command: '<%= config.bin %> <%= command.id %> --table incident --group-by priority --group-by assignment_group --avg reassignment_count --count --display-value --auth dev',
+        },
+        {
+            description: 'Groups with HAVING clause',
+            command: '<%= config.bin %> <%= command.id %> --table incident --group-by priority --count --having "count>10" --auth dev',
+        },
+    ];
+    static flags = {
+        'table': Flags.string({
+            char: 't',
+            description: 'ServiceNow table name to aggregate',
+            required: true,
+        }),
+        'query': Flags.string({
+            char: 'q',
+            description: 'ServiceNow encoded query string to filter records before grouping',
+            required: false,
+        }),
+        'group-by': Flags.string({
+            char: 'g',
+            description: 'Field name(s) to group by',
+            required: true,
+            multiple: true,
+        }),
+        'count': Flags.boolean({
+            char: 'c',
+            description: 'Include record count per group',
+            required: false,
+            default: false,
+        }),
+        'avg': Flags.string({
+            description: 'Comma-separated field names to compute AVG on per group',
+            required: false,
+            multiple: true,
+        }),
+        'min': Flags.string({
+            description: 'Comma-separated field names to compute MIN on per group',
+            required: false,
+            multiple: true,
+        }),
+        'max': Flags.string({
+            description: 'Comma-separated field names to compute MAX on per group',
+            required: false,
+            multiple: true,
+        }),
+        'sum': Flags.string({
+            description: 'Comma-separated field names to compute SUM on per group',
+            required: false,
+            multiple: true,
+        }),
+        'having': Flags.string({
+            description: 'HAVING clause to filter groups (e.g. "count>10")',
+            required: false,
+        }),
+        'display-value': Flags.boolean({
+            char: 'd',
+            description: 'Return display values for group-by fields',
+            required: false,
+            default: false,
+        }),
+        'json': Flags.boolean({
+            char: 'j',
+            description: 'Output results as JSON',
+            required: false,
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(AggregateGroup);
+        const displayService = new AggregateDisplayService();
+        try {
+            const aggregateQuery = new AggregateQuery(this.instance);
+            this.log(`Running grouped aggregate on table: ${flags.table} (group by: ${flags['group-by'].join(', ')})`);
+            const result = await aggregateQuery.groupBy({
+                table: flags.table,
+                query: flags.query,
+                groupBy: flags['group-by'],
+                count: flags.count,
+                avgFields: flags.avg,
+                minFields: flags.min,
+                maxFields: flags.max,
+                sumFields: flags.sum,
+                having: flags.having,
+                displayValue: flags['display-value'] ? 'all' : undefined,
+            });
+            const lines = displayService.formatGroupedResult(result.groups, flags.table, flags.json ?? false);
+            for (const line of lines) {
+                (flags.json ?? false) ? console.log(line) : this.log(line);
+            }
+        }
+        catch (error) {
+            this._logger.error("Error occurred when running grouped aggregate query.", error);
+            this.error(error);
+        }
+    }
+}
+//# sourceMappingURL=group.js.map

package/dist/commands/aggregate/group.js.map

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

package/dist/commands/aggregate/query.d.ts

@@ -0,0 +1,21 @@
+import { AuthenticatedCommand } from '../../common/authenticated-command.js';
+export declare class AggregateQueryCmd extends AuthenticatedCommand<typeof AggregateQueryCmd> {
+    static args: {};
+    static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static flags: {
+        table: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        query: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        count: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        avg: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        min: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        max: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        sum: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=query.d.ts.map

package/dist/commands/aggregate/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/commands/aggregate/query.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAG5E,qBAAa,iBAAkB,SAAQ,oBAAoB,CAAC,OAAO,iBAAiB,CAAC;IAEnF,MAAM,CAAC,IAAI,KAAK;IAClB,MAAM,CAAC,WAAW,SAOuB;IACzC,MAAM,CAAC,QAAQ;;;QAaZ;IACH,MAAM,CAAC,KAAK;;;;;;;;;MA2CT;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA6B3B"}

package/dist/commands/aggregate/query.js

@@ -0,0 +1,100 @@
+/* eslint-disable perfectionist/sort-objects */
+import { Flags } from '@oclif/core';
+import { AggregateQuery } from '@sonisoft/now-sdk-ext-core';
+import { AuthenticatedCommand } from '../../common/authenticated-command.js';
+import { AggregateDisplayService } from '../../services/aggregate-display.service.js';
+export class AggregateQueryCmd extends AuthenticatedCommand {
+    static args = {};
+    static description = 'Run aggregate statistics on a ServiceNow table.\n\n' +
+        'Compute AVG, MIN, MAX, and SUM on specified fields using the Stats API. ' +
+        'Optionally include a record count.\n\n' +
+        'Features:\n' +
+        '  \u2022 Compute AVG, MIN, MAX, SUM on any numeric field\n' +
+        '  \u2022 Optional record count\n' +
+        '  \u2022 Filter with encoded queries\n' +
+        '  \u2022 JSON output for scripting';
+    static examples = [
+        {
+            description: 'Get average reassignment count for incidents',
+            command: '<%= config.bin %> <%= command.id %> --table incident --avg reassignment_count --auth dev',
+        },
+        {
+            description: 'Get min, max, and average for active incidents',
+            command: '<%= config.bin %> <%= command.id %> --table incident --query "active=true" --avg reassignment_count --min reassignment_count --max reassignment_count --count --auth dev',
+        },
+        {
+            description: 'Get sum as JSON',
+            command: '<%= config.bin %> <%= command.id %> --table incident --sum reassignment_count --json --auth dev',
+        },
+    ];
+    static flags = {
+        'table': Flags.string({
+            char: 't',
+            description: 'ServiceNow table name to aggregate',
+            required: true,
+        }),
+        'query': Flags.string({
+            char: 'q',
+            description: 'ServiceNow encoded query string to filter records',
+            required: false,
+        }),
+        'count': Flags.boolean({
+            char: 'c',
+            description: 'Include record count in the result',
+            required: false,
+            default: false,
+        }),
+        'avg': Flags.string({
+            description: 'Comma-separated field names to compute AVG on',
+            required: false,
+            multiple: true,
+        }),
+        'min': Flags.string({
+            description: 'Comma-separated field names to compute MIN on',
+            required: false,
+            multiple: true,
+        }),
+        'max': Flags.string({
+            description: 'Comma-separated field names to compute MAX on',
+            required: false,
+            multiple: true,
+        }),
+        'sum': Flags.string({
+            description: 'Comma-separated field names to compute SUM on',
+            required: false,
+            multiple: true,
+        }),
+        'json': Flags.boolean({
+            char: 'j',
+            description: 'Output results as JSON',
+            required: false,
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(AggregateQueryCmd);
+        const displayService = new AggregateDisplayService();
+        try {
+            const aggregateQuery = new AggregateQuery(this.instance);
+            this.log(`Running aggregate query on table: ${flags.table}`);
+            const result = await aggregateQuery.aggregate({
+                table: flags.table,
+                query: flags.query,
+                count: flags.count,
+                avgFields: flags.avg,
+                minFields: flags.min,
+                maxFields: flags.max,
+                sumFields: flags.sum,
+            });
+            const lines = displayService.formatAggregateResult(result.stats, flags.table, flags.json ?? false);
+            for (const line of lines) {
+                (flags.json ?? false) ? console.log(line) : this.log(line);
+            }
+        }
+        catch (error) {
+            this._logger.error("Error occurred when running aggregate query.", error);
+            this.error(error);
+        }
+    }
+}
+//# sourceMappingURL=query.js.map

package/dist/commands/aggregate/query.js.map

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

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

@@ -2,13 +2,15 @@ import { AuthenticatedCommand } from '../../common/authenticated-command.js';
 export declare class App extends AuthenticatedCommand<typeof App> {
     static args: {};
     static description: string;
-    static examples: string[];
+    static examples: {
+        description: string;
+        command: string;
+    }[];
     static flags: {
         uninstall: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
         applicationId: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
         scope: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
     };
-    private _logger;
     run(): Promise<void>;
 }
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/app/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAG5E,qBAAa,GAAI,SAAQ,oBAAoB,CAAC,OAAO,GAAG,CAAC;IAEvD,MAAM,CAAC,IAAI,KACV;IAED,MAAM,CAAC,WAAW,SAAM;IACxB,MAAM,CAAC,QAAQ,WAId;IAED,MAAM,CAAC,KAAK;;;;MAMX;IAED,OAAO,CAAC,OAAO,CAAmC;IAE5C,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA4C3B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/app/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAG5E,qBAAa,GAAI,SAAQ,oBAAoB,CAAC,OAAO,GAAG,CAAC;IAEvD,MAAM,CAAC,IAAI,KACV;IACH,MAAM,CAAC,WAAW,SAYuC;IACzD,MAAM,CAAC,QAAQ;;;QAaZ;IACH,MAAM,CAAC,KAAK;;;;MAMT;IAIK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA4C3B"}

package/dist/commands/app/index.js

@@ -1,16 +1,37 @@
 /* eslint-disable @typescript-eslint/no-unused-vars */
 /* eslint-disable perfectionist/sort-objects */
 import { Flags } from '@oclif/core';
-import { Application, Logger, NowStringUtil } from '@sonisoft/now-sdk-ext-core';
+import { Application, NowStringUtil } from '@sonisoft/now-sdk-ext-core';
 import { AuthenticatedCommand } from '../../common/authenticated-command.js';
 import { isNilOrEmpty } from '../../common/utils.js';
 export class App extends AuthenticatedCommand {
     static args = {};
-    static description = '';
+    static description = 'Manage ServiceNow applications: uninstall applications from your instance.\n\n' +
+        'This command provides programmatic control over ServiceNow applications, allowing you to uninstall ' +
+        'applications remotely. This is useful for automated environment cleanup, testing workflows, and ' +
+        'application lifecycle management.\n\n' +
+        'Features:\n' +
+        '  • Uninstall applications by sys_id and scope\n' +
+        '  • Automated application removal in CI/CD pipelines\n' +
+        '  • Proper cleanup and rollback handling\n' +
+        '  • Detailed logging and error reporting\n\n' +
+        'Requirements:\n' +
+        '  • User must have admin role\n' +
+        '  • Application must be in a removable state\n' +
+        '  • Both application sys_id and scope are required';
     static examples = [
-        `<%= config.bin %> <%= command.id %> exec global test.js --auth sn_alias
-test
-`,
+        {
+            description: 'Uninstall an application by sys_id and scope',
+            command: '<%= config.bin %> <%= command.id %> --uninstall --applicationId a1b2c3d4e5f6 --scope x_my_custom_app --auth dev-instance',
+        },
+        {
+            description: 'Uninstall with enhanced debug logging',
+            command: '<%= config.bin %> <%= command.id %> -u -i a1b2c3d4e5f6 -s x_my_custom_app --auth dev-instance --log-level debug',
+        },
+        {
+            description: 'Uninstall using short flags',
+            command: '<%= config.bin %> <%= command.id %> -u -i a1b2c3d4e5f6 -s x_my_custom_app -a dev-instance',
+        },
     ];
     static flags = {
         // from: Flags.string({char: 'f', description: 'Who is saying hello', required: true}),
@@ -18,7 +39,7 @@ test
         applicationId: Flags.string({ char: 'i', description: 'Application sys_id', required: false }),
         scope: Flags.string({ char: 's', description: 'Scope of application.', required: false }),
     };
-    _logger = new Logger("AppCommand");
+    // private _logger:Logger = new Logger("AppCommand");
     async run() {
         const { args, flags } = await this.parse(App);
         this.log("App command");

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/app/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,+CAA+C;AAC/C,OAAO,EAAgB,KAAK,EAAC,MAAM,aAAa,CAAA;AAChD,OAAO,EAAG,WAAW,EAAiD,MAAM,EAAE,aAAa,EAAuB,MAAM,4BAA4B,CAAC;AAIrJ,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,OAAO,GAAI,SAAQ,oBAAgC;IAEvD,MAAM,CAAC,IAAI,GAAG,EACb,CAAA;IAED,MAAM,CAAC,WAAW,GAAG,EAAE,CAAC;IACxB,MAAM,CAAC,QAAQ,GAAG;QAChB;;CAEH;KACE,CAAA;IAED,MAAM,CAAC,KAAK,GAAG;QACb,uFAAuF;QACvF,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,EAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,mBAAmB,EAAE,QAAQ,EAAE,KAAK,EAAC,CAAC;QAExF,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,EAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,oBAAoB,EAAE,QAAQ,EAAE,KAAK,EAAC,CAAC;QAC5F,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,uBAAuB,EAAE,QAAQ,EAAE,KAAK,EAAC,CAAC;KACxF,CAAA;IAEO,OAAO,GAAU,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC;IAElD,KAAK,CAAC,GAAG;QACP,MAAM,EAAC,IAAI,EAAE,KAAK,EAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE5C,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAIxB,IAAG,KAAK,CAAC,SAAS,EAAC,CAAC;YACpB,IAAG,CAAC,YAAY,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,EAAC,CAAC;gBACnE,IAAG,CAAC;oBAEA,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;oBAE7B,IAAG,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC,EAAC,CAAC;wBACnD,IAAI,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;wBAClE,OAAO;oBACT,CAAC;oBAED,IAAG,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,EAAC,CAAC;wBAC3C,IAAI,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;wBACzD,OAAO;oBACT,CAAC;oBAED,IAAI,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;oBAC7C,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAe,EAAG,KAAK,CAAC,aAAuB,CAAC,CAAC;oBAClG,MAAM,GAAG,CAAC,iBAAiB,EAAE,CAAC;oBAC9B,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC;gBAG1B,CAAC;gBAAA,OAAM,KAAK,EAAC,CAAC;oBACZ,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,kDAAkD,EAAE,KAAc,CAAC,CAAC;oBACvF,IAAI,CAAC,KAAK,CAAC,KAAc,CAAC,CAAC;gBAC7B,CAAC;YAEH,CAAC;iBAAI,CAAC;gBACJ,IAAI,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;YAC3E,CAAC;QAGD,CAAC;aAAI,CAAC;YACJ,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACpC,CAAC;IAEH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/app/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,+CAA+C;AAC/C,OAAO,EAAgB,KAAK,EAAC,MAAM,aAAa,CAAA;AAChD,OAAO,EAAG,WAAW,EAAyD,aAAa,EAAuB,MAAM,4BAA4B,CAAC;AAIrJ,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,OAAO,GAAI,SAAQ,oBAAgC;IAEvD,MAAM,CAAC,IAAI,GAAG,EACb,CAAA;IACH,MAAM,CAAC,WAAW,GAAG,gFAAgF;QACjG,qGAAqG;QACrG,kGAAkG;QAClG,uCAAuC;QACvC,aAAa;QACb,kDAAkD;QAClD,wDAAwD;QACxD,4CAA4C;QAC5C,8CAA8C;QAC9C,iBAAiB;QACjB,iCAAiC;QACjC,gDAAgD;QAChD,oDAAoD,CAAC;IACzD,MAAM,CAAC,QAAQ,GAAG;QACd;YACE,WAAW,EAAE,8CAA8C;YAC3D,OAAO,EAAE,0HAA0H;SACpI;QACD;YACE,WAAW,EAAE,uCAAuC;YACpD,OAAO,EAAE,iHAAiH;SAC3H;QACD;YACE,WAAW,EAAE,6BAA6B;YAC1C,OAAO,EAAE,2FAA2F;SACrG;KACF,CAAA;IACH,MAAM,CAAC,KAAK,GAAG;QACX,uFAAuF;QACvF,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,EAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,mBAAmB,EAAE,QAAQ,EAAE,KAAK,EAAC,CAAC;QAExF,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,EAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,oBAAoB,EAAE,QAAQ,EAAE,KAAK,EAAC,CAAC;QAC5F,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,uBAAuB,EAAE,QAAQ,EAAE,KAAK,EAAC,CAAC;KACxF,CAAA;IAED,qDAAqD;IAErD,KAAK,CAAC,GAAG;QACP,MAAM,EAAC,IAAI,EAAE,KAAK,EAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE5C,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAIxB,IAAG,KAAK,CAAC,SAAS,EAAC,CAAC;YACpB,IAAG,CAAC,YAAY,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,EAAC,CAAC;gBACnE,IAAG,CAAC;oBAEA,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;oBAE7B,IAAG,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC,EAAC,CAAC;wBACnD,IAAI,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;wBAClE,OAAO;oBACT,CAAC;oBAED,IAAG,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,EAAC,CAAC;wBAC3C,IAAI,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;wBACzD,OAAO;oBACT,CAAC;oBAED,IAAI,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;oBAC7C,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAe,EAAG,KAAK,CAAC,aAAuB,CAAC,CAAC;oBAClG,MAAM,GAAG,CAAC,iBAAiB,EAAE,CAAC;oBAC9B,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC;gBAG1B,CAAC;gBAAA,OAAM,KAAK,EAAC,CAAC;oBACZ,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,kDAAkD,EAAE,KAAc,CAAC,CAAC;oBACvF,IAAI,CAAC,KAAK,CAAC,KAAc,CAAC,CAAC;gBAC7B,CAAC;YAEH,CAAC;iBAAI,CAAC;gBACJ,IAAI,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;YAC3E,CAAC;QAGD,CAAC;aAAI,CAAC;YACJ,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACpC,CAAC;IAEH,CAAC"}

package/dist/commands/app/install.d.ts

@@ -2,12 +2,14 @@ import { AuthenticatedCommand } from '../../common/authenticated-command.js';
 export declare class Install extends AuthenticatedCommand<typeof Install> {
     static args: {};
     static description: string;
-    static examples: string[];
+    static examples: {
+        command: string;
+        description: string;
+    }[];
     static flags: {
         batch: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
         definitionPath: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
     };
-    private _logger;
     run(): Promise<void>;
 }
 //# sourceMappingURL=install.d.ts.map

package/dist/commands/app/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/commands/app/install.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAE5E,qBAAa,OAAQ,SAAQ,oBAAoB,CAAC,OAAO,OAAO,CAAC;IAE/D,MAAM,CAAC,IAAI,KACV;IAED,MAAM,CAAC,WAAW,SAAkE;IAEpF,MAAM,CAAC,QAAQ,WAId;IAED,MAAM,CAAC,KAAK;;;MAKX;IAED,OAAO,CAAC,OAAO,CAA0C;IAEnD,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA2B3B"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/commands/app/install.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAE5E,qBAAa,OAAQ,SAAQ,oBAAoB,CAAC,OAAO,OAAO,CAAC;IAE/D,MAAM,CAAC,IAAI,KACV;IACH,MAAM,CAAC,WAAW,SAiB6B;IAC/C,MAAM,CAAC,QAAQ;;;QAaZ;IACH,MAAM,CAAC,KAAK;;;MAWT;IAGK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA2B3B"}

package/dist/commands/app/install.js

@@ -1,21 +1,54 @@
 /* eslint-disable @typescript-eslint/no-unused-vars */
 import { Flags } from '@oclif/core';
-import { ApplicationManager, Logger, NowStringUtil } from '@sonisoft/now-sdk-ext-core';
+import { ApplicationManager, NowStringUtil } from '@sonisoft/now-sdk-ext-core';
 import path from 'node:path';
 import { AuthenticatedCommand } from '../../common/authenticated-command.js';
 export class Install extends AuthenticatedCommand {
     static args = {};
-    static description = 'Install or Upgrade application(s) from batch definition file';
+    static description = 'Install or upgrade multiple ServiceNow applications from a batch definition file.\n\n' +
+        'This command enables automated installation and upgrade of multiple applications using a JSON definition file. ' +
+        'Perfect for setting up new environments, deploying application bundles, or managing application dependencies. ' +
+        'The batch file can specify multiple applications with their versions, scopes, and installation options.\n\n' +
+        'Features:\n' +
+        '  • Install multiple applications in a single operation\n' +
+        '  • Upgrade existing applications to new versions\n' +
+        '  • Control demo data loading per application\n' +
+        '  • Detailed installation progress and results\n' +
+        '  • Automatic dependency resolution\n' +
+        '  • Rollback support on failures\n\n' +
+        'Batch Definition Format:\n' +
+        '  The JSON file should contain an "applications" array with objects defining:\n' +
+        '  • name: Application name\n' +
+        '  • scope: Application scope (e.g., x_my_app)\n' +
+        '  • version: Target version number\n' +
+        '  • load_demo_data: Whether to load demo data (optional)\n' +
+        '  • notes: Installation notes (optional)';
     static examples = [
-        `<%= config.bin %> <%= command.id %> exec global test.js --auth sn_alias
-test
-`,
+        {
+            command: '<%= config.bin %> <%= command.id %> --batch --definitionPath ./apps-to-install.json --auth dev-instance',
+            description: 'Install applications from a batch definition file',
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> -b -d ./batch-apps.json -a dev-instance',
+            description: 'Install with short flags',
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> -b -d ./apps.json -a dev-instance --log-level debug',
+            description: 'Install with debug logging to troubleshoot issues',
+        },
     ];
     static flags = {
-        batch: Flags.boolean({ char: 'b', description: 'Install from batch definition file', required: false }),
-        definitionPath: Flags.string({ char: 'd', description: 'Batch definition file', required: false }),
+        batch: Flags.boolean({
+            char: 'b',
+            description: 'Enable batch installation mode from definition file',
+            required: false
+        }),
+        definitionPath: Flags.string({
+            char: 'd',
+            description: 'Path to JSON batch definition file containing applications to install',
+            required: false
+        }),
     };
-    _logger = new Logger("AppInstallCommand");
     async run() {
         const { args, flags } = await this.parse(Install);
         this.log("App Install Command Executed.");

package/dist/commands/app/install.js.map

@@ -1 +1 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/commands/app/install.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAEtD,OAAO,EAAgB,KAAK,EAAC,MAAM,aAAa,CAAA;AAChD,OAAO,EAAgB,kBAAkB,EAA6B,MAAM,EAAE,aAAa,EAAuB,MAAM,4BAA4B,CAAC;AAErJ,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAE5E,MAAM,OAAO,OAAQ,SAAQ,oBAAoC;IAE/D,MAAM,CAAC,IAAI,GAAG,EACb,CAAA;IAED,MAAM,CAAC,WAAW,GAAG,8DAA8D,CAAC;IAEpF,MAAM,CAAC,QAAQ,GAAG;QAChB;;CAEH;KACE,CAAA;IAED,MAAM,CAAC,KAAK,GAAG;QAEb,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,EAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,oCAAoC,EAAE,QAAQ,EAAE,KAAK,EAAC,CAAC;QACrG,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,EAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,uBAAuB,EAAE,QAAQ,EAAE,KAAK,EAAC,CAAC;KAEjG,CAAA;IAEO,OAAO,GAAU,IAAI,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAEzD,KAAK,CAAC,GAAG;QACP,MAAM,EAAC,IAAI,EAAE,KAAK,EAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEhD,IAAI,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAE1C,IAAG,CAAC,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,cAAc,CAAC,EAAC,CAAC;YAClG,IAAG,CAAC;gBACF,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;gBAE3B,IAAG,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,cAAc,CAAC,EAAC,CAAC;oBACpD,IAAI,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;oBACrE,OAAO;gBACT,CAAC;gBAED,MAAM,UAAU,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACzD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,cAAwB,CAAC,CAAC,CAAC;gBAC3F,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;YAE9B,CAAC;YAAA,OAAM,KAAK,EAAC,CAAC;gBACZ,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAc,CAAC,CAAC;gBACtD,IAAI,CAAC,KAAK,CAAC,KAAc,CAAC,CAAC;YAC7B,CAAC;QAGH,CAAC;IAEH,CAAC"}
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/commands/app/install.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAEtD,OAAO,EAAgB,KAAK,EAAC,MAAM,aAAa,CAAA;AAChD,OAAO,EAAgB,kBAAkB,EAAqC,aAAa,EAAuB,MAAM,4BAA4B,CAAC;AAErJ,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAE5E,MAAM,OAAO,OAAQ,SAAQ,oBAAoC;IAE/D,MAAM,CAAC,IAAI,GAAG,EACb,CAAA;IACH,MAAM,CAAC,WAAW,GAAG,uFAAuF;QACxG,iHAAiH;QACjH,gHAAgH;QAChH,6GAA6G;QAC7G,aAAa;QACb,2DAA2D;QAC3D,qDAAqD;QACrD,iDAAiD;QACjD,kDAAkD;QAClD,uCAAuC;QACvC,sCAAsC;QACtC,4BAA4B;QAC5B,iFAAiF;QACjF,8BAA8B;QAC9B,iDAAiD;QACjD,sCAAsC;QACtC,4DAA4D;QAC5D,0CAA0C,CAAC;IAC/C,MAAM,CAAC,QAAQ,GAAG;QACd;YACE,OAAO,EAAE,yGAAyG;YAClH,WAAW,EAAE,mDAAmD;SACjE;QACD;YACE,OAAO,EAAE,6EAA6E;YACtF,WAAW,EAAE,0BAA0B;SACxC;QACD;YACE,OAAO,EAAE,yFAAyF;YAClG,WAAW,EAAE,mDAAmD;SACjE;KACF,CAAA;IACH,MAAM,CAAC,KAAK,GAAG;QACX,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;YACnB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,qDAAqD;YAClE,QAAQ,EAAE,KAAK;SAChB,CAAC;QACF,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC;YAC3B,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,uEAAuE;YACpF,QAAQ,EAAE,KAAK;SAChB,CAAC;KACH,CAAA;IAGD,KAAK,CAAC,GAAG;QACP,MAAM,EAAC,IAAI,EAAE,KAAK,EAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEhD,IAAI,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAE1C,IAAG,CAAC,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,cAAc,CAAC,EAAC,CAAC;YAClG,IAAG,CAAC;gBACF,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;gBAE3B,IAAG,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,cAAc,CAAC,EAAC,CAAC;oBACpD,IAAI,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;oBACrE,OAAO;gBACT,CAAC;gBAED,MAAM,UAAU,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACzD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,cAAwB,CAAC,CAAC,CAAC;gBAC3F,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;YAE9B,CAAC;YAAA,OAAM,KAAK,EAAC,CAAC;gBACZ,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAc,CAAC,CAAC;gBACtD,IAAI,CAAC,KAAK,CAAC,KAAc,CAAC,CAAC;YAC7B,CAAC;QAGH,CAAC;IAEH,CAAC"}

package/dist/commands/app/repo-install.d.ts

@@ -0,0 +1,18 @@
+import { AuthenticatedCommand } from '../../common/authenticated-command.js';
+export declare class RepoInstall extends AuthenticatedCommand<typeof RepoInstall> {
+    static args: {};
+    static description: string;
+    static examples: {
+        command: string;
+        description: string;
+    }[];
+    static flags: {
+        'no-wait': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        'poll-interval': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<number, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        scope: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        timeout: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<number, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        version: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=repo-install.d.ts.map

package/dist/commands/app/repo-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-install.d.ts","sourceRoot":"","sources":["../../../src/commands/app/repo-install.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAG5E,qBAAa,WAAY,SAAQ,oBAAoB,CAAC,OAAO,WAAW,CAAC;IAEvE,MAAM,CAAC,IAAI,KACV;IACH,MAAM,CAAC,WAAW,SAqBmD;IACrE,MAAM,CAAC,QAAQ;;;QAqBZ;IACH,MAAM,CAAC,KAAK;;;;;;MA4BT;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA+G3B"}