@google/clasp 3.0.6-alpha → 3.1.1

package/build/src/commands/login.js

@@ -1,3 +1,17 @@
+// Copyright 2019 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// This file defines the 'login' command for the clasp CLI.
 /**
  * Clasp command method bodies.
  */
@@ -23,17 +37,20 @@ export const command = new Command('login')
     .option('--creds <file>', 'Relative path to OAuth client secret file (from GCP).')
     .option('--use-project-scopes', 'Use the scopes from the current project manifest. Used only when authorizing access for the run command.')
     .option('--redirect-port <port>', 'Specify a custom port for the redirect URL.')
-    .action(async function (options) {
+    .action(async function () {
     var _a;
-    const auth = this.opts().auth;
-    const clasp = this.opts().clasp;
+    const options = this.optsWithGlobals();
+    const auth = options.authInfo;
+    const clasp = options.clasp;
     if (!auth.credentialStore) {
         const msg = intl.formatMessage({ id: "u1wQGD", defaultMessage: [{ type: 0, value: "No credential store found, unable to login." }] });
         this.error(msg);
     }
     if (auth.credentials) {
-        const msg = intl.formatMessage({ id: "FTrSWo", defaultMessage: [{ type: 0, value: "Warning: You seem to already be logged in." }] });
-        console.error(msg);
+        if (!options.json) {
+            const msg = intl.formatMessage({ id: "FTrSWo", defaultMessage: [{ type: 0, value: "Warning: You seem to already be logged in." }] });
+            console.error(msg);
+        }
     }
     const useLocalhost = Boolean(options.localhost);
     const redirectPort = options.redirectPort;
@@ -42,11 +59,13 @@ export const command = new Command('login')
     if (options.useProjectScopes) {
         const manifest = await clasp.project.readManifest();
         scopes = (_a = manifest.oauthScopes) !== null && _a !== void 0 ? _a : scopes;
-        const scopesLabel = intl.formatMessage({ id: "S0Kswv", defaultMessage: [{ type: 0, value: "Authorizing with the following scopes:" }] });
-        console.log('');
-        console.log(scopesLabel);
-        for (const scope of scopes) {
-            console.log(scope);
+        if (!options.json) {
+            const scopesLabel = intl.formatMessage({ id: "S0Kswv", defaultMessage: [{ type: 0, value: "Authorizing with the following scopes:" }] });
+            console.log('');
+            console.log(scopesLabel);
+            for (const scope of scopes) {
+                console.log(scope);
+            }
         }
     }
     const credentials = await authorize({
@@ -58,6 +77,13 @@ export const command = new Command('login')
         redirectPort,
     });
     const user = await getUserInfo(credentials);
+    if (options.json) {
+        const output = {
+            email: user === null || user === void 0 ? void 0 : user.email,
+        };
+        console.log(JSON.stringify(output, null, 2));
+        return;
+    }
     const msg = intl.formatMessage({ id: "sZ9k34", defaultMessage: [{ type: 5, value: "email", options: { undefined: { value: [{ type: 0, value: "You are logged in as an unknown user." }] }, other: { value: [{ type: 0, value: "You are logged in as " }, { type: 1, value: "email" }, { type: 0, value: "." }] } } }] }, {
         email: user === null || user === void 0 ? void 0 : user.email,
     });

package/build/src/commands/logout.js

@@ -1,16 +1,38 @@
+// Copyright 2019 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// This file defines the 'logout' command for the clasp CLI.
 import { Command } from 'commander';
 import { intl } from '../intl.js';
 export const command = new Command('logout').description('Logout of clasp').action(async function () {
     var _a;
-    const auth = this.opts().auth;
+    const options = this.optsWithGlobals();
+    const auth = options.authInfo;
     if (!auth.credentialStore) {
         const msg = intl.formatMessage({ id: "vWMhE2", defaultMessage: [{ type: 0, value: "No credential store found, unable to log out." }] });
         this.error(msg);
     }
     if (!auth.credentials) {
+        if (options.json) {
+            console.log(JSON.stringify({ success: true }, null, 2));
+        }
         return;
     }
     (_a = auth.credentialStore) === null || _a === void 0 ? void 0 : _a.delete(auth.user);
+    if (options.json) {
+        console.log(JSON.stringify({ success: true }, null, 2));
+        return;
+    }
     const successMessage = intl.formatMessage({ id: "lRlj4t", defaultMessage: [{ type: 0, value: "Deleted credentials." }] });
     console.log(successMessage);
 });

package/build/src/commands/open-apis.js

@@ -1,10 +1,26 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// This file defines the 'open-api-console' command for the clasp CLI.
 import { Command } from 'commander';
 import { INCLUDE_USER_HINT_IN_URL } from '../experiments.js';
 import { assertGcpProjectConfigured, maybePromptForProjectId, openUrl } from './utils.js';
 export const command = new Command('open-api-console')
     .description('Open the API console for the current project.')
     .action(async function () {
-    const clasp = this.opts().clasp;
+    const options = this.optsWithGlobals();
+    const clasp = options.clasp;
+    const json = options.json;
     const projectId = await maybePromptForProjectId(clasp);
     assertGcpProjectConfigured(clasp);
     const url = new URL('https://console.developers.google.com/apis/dashboard');
@@ -13,5 +29,8 @@ export const command = new Command('open-api-console')
         const userHint = await clasp.authorizedUser();
         url.searchParams.set('authUser', userHint !== null && userHint !== void 0 ? userHint : '');
     }
+    if (json) {
+        console.log(JSON.stringify({ url: url.toString() }, null, 2));
+    }
     await openUrl(url.toString());
 });

package/build/src/commands/open-container.js

@@ -1,3 +1,17 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// This file defines the 'open-container' command for the clasp CLI.
 import { Command } from 'commander';
 import { INCLUDE_USER_HINT_IN_URL } from '../experiments.js';
 import { intl } from '../intl.js';
@@ -5,7 +19,9 @@ import { openUrl } from './utils.js';
 export const command = new Command('open-container')
     .description('Open the Apps Script IDE for the current project.')
     .action(async function () {
-    const clasp = this.opts().clasp;
+    const options = this.optsWithGlobals();
+    const clasp = options.clasp;
+    const json = options.json;
     const parentId = clasp.project.parentId;
     if (!parentId) {
         const msg = intl.formatMessage({ id: "eXBzoP", defaultMessage: [{ type: 0, value: "Parent ID not set, unable to open document." }] });
@@ -17,5 +33,8 @@ export const command = new Command('open-container')
         const userHint = await clasp.authorizedUser();
         url.searchParams.set('authUser', userHint !== null && userHint !== void 0 ? userHint : '');
     }
+    if (json) {
+        console.log(JSON.stringify({ url: url.toString() }, null, 2));
+    }
     await openUrl(url.toString());
 });

package/build/src/commands/open-credentials.js

@@ -1,10 +1,26 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// This file defines the 'open-credentials-setup' command for the clasp CLI.
 import { Command } from 'commander';
 import { INCLUDE_USER_HINT_IN_URL } from '../experiments.js';
 import { assertGcpProjectConfigured, maybePromptForProjectId, openUrl } from './utils.js';
 export const command = new Command('open-credentials-setup')
     .description("Open credentials page for the script's GCP project")
     .action(async function () {
-    const clasp = this.opts().clasp;
+    const options = this.optsWithGlobals();
+    const clasp = options.clasp;
+    const json = options.json;
     const projectId = await maybePromptForProjectId(clasp);
     assertGcpProjectConfigured(clasp);
     const url = new URL('https://console.developers.google.com/apis/credentials');
@@ -13,5 +29,8 @@ export const command = new Command('open-credentials-setup')
         const userHint = await clasp.authorizedUser();
         url.searchParams.set('authUser', userHint !== null && userHint !== void 0 ? userHint : '');
     }
+    if (json) {
+        console.log(JSON.stringify({ url: url.toString() }, null, 2));
+    }
     await openUrl(url.toString());
 });

package/build/src/commands/open-logs.js

@@ -1,10 +1,26 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// This file defines the 'open-logs' command for the clasp CLI.
 import { Command } from 'commander';
 import { INCLUDE_USER_HINT_IN_URL } from '../experiments.js';
 import { assertGcpProjectConfigured, maybePromptForProjectId, openUrl } from './utils.js';
 export const command = new Command('open-logs')
     .description('Open logs in the developer console')
     .action(async function () {
-    const clasp = this.opts().clasp;
+    const options = this.optsWithGlobals();
+    const clasp = options.clasp;
+    const json = options.json;
     const projectId = await maybePromptForProjectId(clasp);
     assertGcpProjectConfigured(clasp);
     const url = new URL('https://console.cloud.google.com/logs/viewer');
@@ -14,5 +30,8 @@ export const command = new Command('open-logs')
         const userHint = await clasp.authorizedUser();
         url.searchParams.set('authUser', userHint !== null && userHint !== void 0 ? userHint : '');
     }
+    if (json) {
+        console.log(JSON.stringify({ url: url.toString() }, null, 2));
+    }
     await openUrl(url.toString());
 });

package/build/src/commands/open-script.js

@@ -1,3 +1,17 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// This file defines the 'open-script' command for the clasp CLI.
 import { Command } from 'commander';
 import { INCLUDE_USER_HINT_IN_URL } from '../experiments.js';
 import { intl } from '../intl.js';
@@ -6,7 +20,9 @@ export const command = new Command('open-script')
     .arguments('[scriptId]')
     .description('Open the Apps Script IDE for the current project.')
     .action(async function (scriptId) {
-    const clasp = this.opts().clasp;
+    const options = this.optsWithGlobals();
+    const clasp = options.clasp;
+    const json = options.json;
     if (!scriptId) {
         scriptId = clasp.project.scriptId;
     }
@@ -19,5 +35,8 @@ export const command = new Command('open-script')
         const userHint = await clasp.authorizedUser();
         url.searchParams.set('authUser', userHint !== null && userHint !== void 0 ? userHint : '');
     }
+    if (json) {
+        console.log(JSON.stringify({ url: url.toString() }, null, 2));
+    }
     await openUrl(url.toString());
 });

package/build/src/commands/open-webapp.js

@@ -1,3 +1,17 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// This file defines the 'open-web-app' command for the clasp CLI.
 import { Command } from 'commander';
 import inquirer from 'inquirer';
 import { INCLUDE_USER_HINT_IN_URL } from '../experiments.js';
@@ -8,7 +22,9 @@ export const command = new Command('open-web-app')
     .description('Open a deployed web app in the browser.')
     .action(async function (deploymentId) {
     var _a, _b;
-    const clasp = this.opts().clasp;
+    const options = this.optsWithGlobals();
+    const clasp = options.clasp;
+    const json = options.json;
     const scriptId = clasp.project.scriptId;
     if (!scriptId) {
         const msg = intl.formatMessage({ id: "Teli1g", defaultMessage: [{ type: 0, value: "Script ID not set, unable to open web app." }] });
@@ -57,5 +73,8 @@ export const command = new Command('open-web-app')
         const userHint = await clasp.authorizedUser();
         url.searchParams.set('authUser', userHint !== null && userHint !== void 0 ? userHint : '');
     }
+    if (json) {
+        console.log(JSON.stringify({ url: url.toString() }, null, 2));
+    }
     await openUrl(url.toString());
 });

package/build/src/commands/program.js

@@ -1,3 +1,19 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// This file sets up the main CLI program for clasp. It initializes commander,
+// defines global options, registers all command modules, and handles
+// versioning and error handling.
 import { Command, Option } from 'commander';
 import { PROJECT_NAME } from '../constants.js';
 import { command as cloneCommand } from './clone-script.js';
@@ -5,6 +21,7 @@ import { command as createDeploymentCommand } from './create-deployment.js';
 import { command as createCommand } from './create-script.js';
 import { command as createVersionCommand } from './create-version.js';
 import { command as deleteDeploymentCOmand } from './delete-deployment.js';
+import { command as deleteCommand } from './delete-script.js';
 import { command as disableApiCommand } from './disable-api.js';
 import { command as enableApiCommand } from './enable-api.js';
 import { command as listApisCommand } from './list-apis.js';
@@ -34,12 +51,24 @@ import { readPackageUpSync } from 'read-package-up';
 import { initAuth } from '../auth/auth.js';
 import { initClaspInstance } from '../core/clasp.js';
 import { intl } from '../intl.js';
+/**
+ * Retrieves the version of the clasp CLI from its package.json.
+ * @returns {string} The version string, or 'unknown' if it cannot be determined.
+ */
 export function getVersion() {
     const __dirname = dirname(fileURLToPath(import.meta.url));
     const manifest = readPackageUpSync({ cwd: __dirname });
     const version = manifest ? manifest.packageJson.version : 'unknown';
     return version;
 }
+/**
+ * Creates and configures the main Commander program for the clasp CLI.
+ * This includes setting the version, defining global options, registering all commands,
+ * and setting up pre-action hooks for auth and Clasp instance initialization.
+ * @param { (err: CommanderError) => void } [exitOveride] - Optional function to override
+ * the default exit behavior of Commander, primarily for testing.
+ * @returns {Command} The configured Commander program instance.
+ */
 export function makeProgram(exitOveride) {
     const version = getVersion();
     const program = new Command();
@@ -50,20 +79,30 @@ export function makeProgram(exitOveride) {
      */
     program.version(version, '-v, --version', 'output the current version');
     program.name(PROJECT_NAME).usage('<command> [options]').description(`${PROJECT_NAME} - The Apps Script CLI`);
+    // This hook runs before any command's action handler.
+    // It's used to initialize authentication and the main Clasp instance,
+    // making them available to all command actions.
     program.hook('preAction', async (_, cmd) => {
+        // `optsWithGlobals()` retrieves all options, including global ones like --auth, --project, etc.
         const opts = cmd.optsWithGlobals();
+        // Initialize authentication based on global options.
+        // This will load existing credentials or prepare for a new auth flow if needed.
         const auth = await initAuth({
-            authFilePath: opts.auth,
-            userKey: opts.user,
-            useApplicationDefaultCredentials: opts.adc,
+            authFilePath: opts.auth, // Path to .clasprc.json
+            userKey: opts.user, // User key for multi-user support
+            useApplicationDefaultCredentials: opts.adc, // Flag for using ADC
         });
+        // Initialize the main Clasp instance with the (potentially) authenticated client
+        // and paths to project config and ignore files.
         const clasp = await initClaspInstance({
-            credentials: auth.credentials,
-            configFile: opts.project,
-            ignoreFile: opts.ignore,
+            credentials: auth.credentials, // Pass the OAuth2 client (if authenticated)
+            configFile: opts.project, // Path to .clasp.json
+            ignoreFile: opts.ignore, // Path to .claspignore
         });
+        // Make the initialized `clasp` and `auth` objects available to the
+        // actual command's action function via its options.
         cmd.setOptionValue('clasp', clasp);
-        cmd.setOptionValue('auth', auth);
+        cmd.setOptionValue('authInfo', auth);
     });
     /**
      * Path to an auth file, or to a folder with a '.clasprc.json' file.
@@ -71,6 +110,7 @@ export function makeProgram(exitOveride) {
     program.addOption(new Option('-A, --auth <file>', "path to an auth file or a folder with a '.clasprc.json' file.").env('clasp_config_auth'));
     program.option('-u,--user <name>', 'Store named credentials. If unspecified, the "default" user is used.', 'default');
     program.option('--adc', 'Use the application default credentials from the environemnt.');
+    program.option('--json', 'Show output in JSON format');
     program.addOption(new Option('-I, --ignore <file>', "path to an ignore file or a folder with a '.claspignore' file.").env('clasp_config_ignore'));
     program.addOption(new Option('-P, --project <file>', "path to a project file or to a folder with a '.clasp.json' file.").env('clasp_config_project'));
     const commandsToAdd = [
@@ -82,6 +122,7 @@ export function makeProgram(exitOveride) {
         pushCommand,
         pullCommand,
         createDeploymentCommand,
+        deleteCommand,
         deleteDeploymentCOmand,
         listDeploymentsCommand,
         updateDeploymentCommand,

package/build/src/commands/pull.js

@@ -1,3 +1,17 @@
+// Copyright 2019 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// This file defines the 'pull' command for the clasp CLI.
 import { Command } from 'commander';
 import fs from 'fs/promises';
 import inquirer from 'inquirer';
@@ -8,48 +22,75 @@ export const command = new Command('pull')
     .option('--versionNumber <version>', 'The version number of the project to retrieve.')
     .option('-d, --deleteUnusedFiles ', 'Delete local files that are not in the remote project. Use with caution.')
     .option('-f, --force', 'Forcibly delete local files that are not in the remote project without prompting.')
-    .action(async function (options) {
-    const clasp = this.opts().clasp;
+    .action(async function () {
+    const options = this.optsWithGlobals();
+    const clasp = options.clasp;
     const versionNumber = options.versionNumber;
     const forceDelete = options.force;
+    // First, collect a list of current local files before pulling.
+    // This is used to determine which files might need to be deleted if --deleteUnusedFiles is active.
     let spinnerMsg = intl.formatMessage({ id: "dh7Bw6", defaultMessage: [{ type: 0, value: "Checking local files..." }] });
     const localFiles = await clasp.files.collectLocalFiles();
+    // Perform the pull operation from the remote Apps Script project.
+    // This fetches the files (optionally a specific version) and writes them to the local filesystem.
     spinnerMsg = intl.formatMessage({ id: "jilcJH", defaultMessage: [{ type: 0, value: "Pulling files..." }] });
     const files = await withSpinner(spinnerMsg, async () => {
-        return await clasp.files.pull(versionNumber);
+        return clasp.files.pull(versionNumber); // `clasp.files.pull` handles fetching and writing.
     });
+    const pulledFiles = files.map(f => f.localPath);
+    let deletedFiles = [];
+    // If the --deleteUnusedFiles option is used, identify and delete local files
+    // that are no longer present in the remote project.
     if (options.deleteUnusedFiles) {
+        // Compare the initial list of local files with the files just pulled.
+        // Any file in `localFiles` that is not in `files` (the pulled files) is considered unused.
         const filesToDelete = localFiles.filter(f => !files.find(p => p.localPath === f.localPath));
-        await deleteLocalFiles(filesToDelete, forceDelete);
+        deletedFiles = await deleteLocalFiles(filesToDelete, forceDelete, options.json);
     }
+    if (options.json) {
+        console.log(JSON.stringify({ pulledFiles, deletedFiles }, null, 2));
+        return;
+    }
+    // Log the paths of the pulled files.
     files.forEach(f => console.log(`└─ ${f.localPath}`));
     const successMessage = intl.formatMessage({ id: "4mRAfN", defaultMessage: [{ type: 0, value: "Pulled " }, { type: 6, value: "count", options: { "=0": { value: [{ type: 0, value: "no files." }] }, one: { value: [{ type: 0, value: "one file." }] }, other: { value: [{ type: 7 }, { type: 0, value: " files" }] } }, offset: 0, pluralType: "cardinal" }, { type: 0, value: "." }] }, {
         count: files.length,
     });
     console.log(successMessage);
 });
-async function deleteLocalFiles(filesToDelete, forceDelete = false) {
+async function deleteLocalFiles(filesToDelete, forceDelete = false, json = false) {
     if (!filesToDelete || filesToDelete.length === 0) {
-        return;
+        return []; // No files to delete.
     }
     const skipConfirmation = forceDelete;
+    // If not in an interactive terminal and --force is not used, skip deletion with a warning.
+    // This prevents accidental deletion in non-interactive environments like CI scripts.
     if (!isInteractive() && !forceDelete) {
-        const msg = intl.formatMessage({ id: "zLuvSg", defaultMessage: [{ type: 0, value: "You are not in an interactive terminal and --force not used. Skipping file deletion." }] });
-        console.warn(msg);
-        return;
+        if (!json) {
+            const msg = intl.formatMessage({ id: "zLuvSg", defaultMessage: [{ type: 0, value: "You are not in an interactive terminal and --force not used. Skipping file deletion." }] });
+            console.warn(msg);
+        }
+        return [];
     }
+    const deletedFiles = [];
     for (const file of filesToDelete) {
+        let doDelete = true; // Assume deletion unless confirmation is required and denied.
         if (!skipConfirmation) {
+            // If not forcing, prompt the user to confirm deletion for each file.
             const confirm = await inquirer.prompt({
                 type: 'confirm',
                 name: 'deleteFile',
                 message: intl.formatMessage({ id: "lVx/lI", defaultMessage: [{ type: 0, value: "Delete " }, { type: 1, value: "file" }, { type: 0, value: "?" }] }, { file: file.localPath }),
             });
-            if (!confirm.deleteFile) {
-                continue;
+            doDelete = confirm.deleteFile;
+        }
+        if (doDelete) {
+            await fs.unlink(file.localPath); // Delete the file from the local system.
+            deletedFiles.push(file.localPath);
+            if (!json) {
+                console.log(intl.formatMessage({ id: "Nx315v", defaultMessage: [{ type: 0, value: "Deleted " }, { type: 1, value: "file" }] }, { file: file.localPath }));
             }
         }
-        await fs.unlink(file.localPath);
-        console.log(intl.formatMessage({ id: "Nx315v", defaultMessage: [{ type: 0, value: "Deleted " }, { type: 1, value: "file" }] }, { file: file.localPath }));
     }
+    return deletedFiles;
 }