@google/clasp 3.0.6-alpha → 3.1.1

package/build/src/commands/create-deployment.js

@@ -1,3 +1,18 @@
+// 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 'create-deployment' (alias 'deploy') command for the
+// clasp CLI.
 import { Command } from 'commander';
 import { intl } from '../intl.js';
 import { withSpinner } from './utils.js';
@@ -7,25 +22,35 @@ export const command = new Command('create-deployment')
     .option('-V, --versionNumber <version>', 'The project version')
     .option('-d, --description <description>', 'The deployment description')
     .option('-i, --deploymentId <id>', 'The deployment ID to redeploy')
-    .action(async function (options) {
-    var _a, _b, _c;
-    const clasp = this.opts().clasp;
+    .action(async function () {
+    var _a, _b, _c, _d, _e;
+    const options = this.optsWithGlobals();
+    const clasp = options.clasp;
     const deploymentId = options.deploymentId;
     const description = (_a = options.description) !== null && _a !== void 0 ? _a : '';
     const versionNumber = options.versionNumber ? Number(options.versionNumber) : undefined;
     try {
         const spinnerMsg = intl.formatMessage({ id: "oL8t7p", defaultMessage: [{ type: 0, value: "Deploying project..." }] });
         const deployment = await withSpinner(spinnerMsg, async () => {
-            return await clasp.project.deploy(description, deploymentId, versionNumber);
+            return clasp.project.deploy(description, deploymentId, versionNumber);
         });
+        if (options.json) {
+            const output = {
+                deploymentId: deployment.deploymentId,
+                versionNumber: (_b = deployment.deploymentConfig) === null || _b === void 0 ? void 0 : _b.versionNumber,
+                description: (_c = deployment.deploymentConfig) === null || _c === void 0 ? void 0 : _c.description,
+            };
+            console.log(JSON.stringify(output, null, 2));
+            return;
+        }
         const successMessage = intl.formatMessage({ id: "182gSV", defaultMessage: [{ type: 0, value: "Deployed " }, { type: 1, value: "deploymentId" }, { type: 0, value: " " }, { type: 5, value: "version", options: { undefined: { value: [{ type: 0, value: "@HEAD" }] }, other: { value: [{ type: 0, value: "@" }, { type: 1, value: "version" }] } } }] }, {
             deploymentId: deployment.deploymentId,
-            version: (_b = deployment.deploymentConfig) === null || _b === void 0 ? void 0 : _b.versionNumber,
+            version: (_d = deployment.deploymentConfig) === null || _d === void 0 ? void 0 : _d.versionNumber,
         });
         console.log(successMessage);
     }
     catch (error) {
-        if (((_c = error.cause) === null || _c === void 0 ? void 0 : _c.code) === 'INVALID_ARGUMENT') {
+        if (((_e = error.cause) === null || _e === void 0 ? void 0 : _e.code) === 'INVALID_ARGUMENT') {
             this.error(error.cause.message);
         }
         throw error;

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

@@ -1,3 +1,18 @@
+// 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 'create-script' (alias 'create') command for the clasp
+// CLI.
 import path from 'node:path';
 import { Command } from 'commander';
 import inflection from 'inflection';
@@ -17,9 +32,10 @@ export const command = new Command('create-script')
     .option('--title <title>', 'The project title.')
     .option('--parentId <id>', 'A project parent Id.')
     .option('--rootDir <rootDir>', 'Local root directory in which clasp will store your project files.')
-    .action(async function (options) {
+    .action(async function () {
     var _a;
-    const clasp = this.opts().clasp;
+    const options = this.optsWithGlobals();
+    const clasp = options.clasp;
     if (clasp.project.exists()) {
         const msg = intl.formatMessage({ id: "kk5+4G", defaultMessage: [{ type: 0, value: "Project file already exists." }] });
         this.error(msg);
@@ -30,42 +46,65 @@ export const command = new Command('create-script')
     const type = options.type ? options.type.toLowerCase() : 'standalone';
     const rootDir = (_a = options.rootDir) !== null && _a !== void 0 ? _a : '.';
     clasp.withContentDir(rootDir);
+    let scriptId;
+    let createdParentId;
+    // Handle container-bound script creation (e.g., for Sheets, Docs, Forms, Slides).
     if (type && type !== 'standalone') {
-        const mimeType = DRIVE_FILE_MIMETYPES[type];
+        const mimeType = DRIVE_FILE_MIMETYPES[type]; // Look up MIME type for the specified container type.
         if (!mimeType) {
+            // If the type is invalid or not supported for container-bound scripts.
             const msg = intl.formatMessage({ id: "d2MBtN", defaultMessage: [{ type: 0, value: "Invalid container file type" }] });
             this.error(msg);
         }
         const spinnerMsg = intl.formatMessage({ id: "TMfpGK", defaultMessage: [{ type: 0, value: "Creating script..." }] });
-        const { parentId, scriptId } = await withSpinner(spinnerMsg, async () => await clasp.project.createWithContainer(name, mimeType));
-        const parentUrl = `https://drive.google.com/open?id=${parentId}`;
-        const scriptUrl = `https://script.google.com/d/${scriptId}/edit`;
-        const successMessage = intl.formatMessage({ id: "yf9wXJ", defaultMessage: [{ type: 0, value: "Created new document: " }, { type: 1, value: "parentUrl" }, { type: 1, value: "br" }, { type: 0, value: "Created new script: " }, { type: 1, value: "scriptUrl" }] }, {
-            parentUrl,
-            scriptUrl,
-            br: '\n',
-        });
-        console.log(successMessage);
+        // This call creates both the Google Drive file (e.g., a new Spreadsheet)
+        // and the Apps Script project bound to it.
+        const result = await withSpinner(spinnerMsg, async () => await clasp.project.createWithContainer(name, mimeType));
+        scriptId = result.scriptId;
+        createdParentId = result.parentId;
+        if (!options.json) {
+            const parentUrl = `https://drive.google.com/open?id=${createdParentId}`; // URL to the container file.
+            const scriptUrl = `https://script.google.com/d/${scriptId}/edit`; // URL to the new Apps Script project.
+            const successMessage = intl.formatMessage({ id: "yf9wXJ", defaultMessage: [{ type: 0, value: "Created new document: " }, { type: 1, value: "parentUrl" }, { type: 1, value: "br" }, { type: 0, value: "Created new script: " }, { type: 1, value: "scriptUrl" }] }, {
+                parentUrl,
+                scriptUrl,
+                br: '\n',
+            });
+            console.log(successMessage);
+        }
     }
     else {
+        // Handle standalone script creation.
         const spinnerMsg = intl.formatMessage({ id: "TMfpGK", defaultMessage: [{ type: 0, value: "Creating script..." }] });
-        const scriptId = await withSpinner(spinnerMsg, async () => await clasp.project.createScript(name, parentId));
-        const parentUrl = `https://drive.google.com/open?id=${parentId}`;
-        const scriptUrl = `https://script.google.com/d/${scriptId}/edit`;
-        const successMessage = intl.formatMessage({ id: "0a429S", defaultMessage: [{ type: 0, value: "Created new script: " }, { type: 1, value: "scriptUrl" }, { type: 5, value: "parentId", options: { undefined: { value: [] }, other: { value: [{ type: 1, value: "br" }, { type: 0, value: "Bound to document: " }, { type: 1, value: "parentUrl" }] } } }] }, {
-            parentId,
-            parentUrl,
-            scriptUrl,
-            br: '\n',
-        });
-        console.log(successMessage);
+        // This call creates a standalone Apps Script project.
+        // If `parentId` is provided, it attempts to create it within that Drive folder.
+        scriptId = await withSpinner(spinnerMsg, async () => await clasp.project.createScript(name, parentId));
+        if (!options.json) {
+            const parentUrl = `https://drive.google.com/open?id=${parentId}`; // URL to parent folder if specified.
+            const scriptUrl = `https://script.google.com/d/${scriptId}/edit`; // URL to the new Apps Script project.
+            const successMessage = intl.formatMessage({ id: "0a429S", defaultMessage: [{ type: 0, value: "Created new script: " }, { type: 1, value: "scriptUrl" }, { type: 5, value: "parentId", options: { undefined: { value: [] }, other: { value: [{ type: 1, value: "br" }, { type: 0, value: "Bound to document: " }, { type: 1, value: "parentUrl" }] } } }] }, {
+                parentId,
+                parentUrl,
+                scriptUrl,
+                br: '\n',
+            });
+            console.log(successMessage);
+        }
     }
     const spinnerMsg = intl.formatMessage({ id: "UTMHnH", defaultMessage: [{ type: 0, value: "Cloning script..." }] });
+    // After creating the script (either standalone or container-bound),
+    // pull its initial files (e.g., Code.gs, appsscript.json) to the local directory.
     const files = await withSpinner(spinnerMsg, async () => {
         const files = await clasp.files.pull();
+        // Update the local .clasp.json with the new scriptId and other settings.
         clasp.project.updateSettings();
         return files;
     });
+    if (options.json) {
+        console.log(JSON.stringify({ scriptId, parentId: createdParentId, files: files.map(f => f.localPath) }, null, 2));
+        return;
+    }
+    // Log the paths of the pulled files.
     files.forEach(f => console.log(`└─ ${f.localPath}`));
     const successMessage = intl.formatMessage({ id: "XABSyD", defaultMessage: [{ type: 0, value: "Cloned " }, { 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,
@@ -73,8 +112,10 @@ export const command = new Command('create-script')
     console.log(successMessage);
 });
 /**
- * Gets default project name.
- * @return {string} default project name.
+ * Generates a default project name based on the current directory's basename.
+ * It humanizes the directory name (e.g., 'my-project-folder' becomes 'My project folder').
+ * @param {string} dir - The directory path from which to derive the project name.
+ * @returns {string} The humanized default project name.
  */
 export function getDefaultProjectName(dir) {
     const dirName = path.basename(dir);

package/build/src/commands/create-version.js

@@ -1,3 +1,18 @@
+// 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 'create-version' (alias 'version') command for the
+// clasp CLI.
 import { Command } from 'commander';
 import inquirer from 'inquirer';
 import { intl } from '../intl.js';
@@ -7,7 +22,8 @@ export const command = new Command('create-version')
     .arguments('[description]')
     .description('Creates an immutable version of the script')
     .action(async function (description) {
-    const clasp = this.opts().clasp;
+    const options = this.optsWithGlobals();
+    const clasp = options.clasp;
     if (!description && isInteractive()) {
         const prompt = intl.formatMessage({ id: "6U9ksF", defaultMessage: [{ type: 0, value: "Give a description:" }] });
         const answer = await inquirer.prompt([
@@ -24,6 +40,10 @@ export const command = new Command('create-version')
     const versionNumber = await withSpinner(spinnerMsg, async () => {
         return clasp.project.version(description);
     });
+    if (options.json) {
+        console.log(JSON.stringify({ versionNumber }, null, 2));
+        return;
+    }
     const successMessage = intl.formatMessage({ id: "TVOEZz", defaultMessage: [{ type: 0, value: "Created version " }, { type: 2, value: "version", style: null }] }, {
         version: versionNumber,
     });

package/build/src/commands/delete-deployment.js

@@ -1,3 +1,18 @@
+// 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 'delete-deployment' (alias 'undeploy') command for
+// the clasp CLI.
 import { Command } from 'commander';
 import inquirer from 'inquirer';
 import { intl } from '../intl.js';
@@ -7,17 +22,22 @@ export const command = new Command('delete-deployment')
     .description('Delete a deployment of a project')
     .arguments('[deploymentId]')
     .option('-a, --all', 'Undeploy all deployments')
-    .action(async function (deploymentId, options) {
+    .action(async function (deploymentId) {
     var _a;
-    const clasp = this.opts().clasp;
+    const options = this.optsWithGlobals();
+    const clasp = options.clasp;
     const removeAll = options.all;
+    const deletedDeploymentIds = [];
     const deleteDeployment = async (id) => {
         const spinnerMsg = intl.formatMessage({ id: "d6mKEK", defaultMessage: [{ type: 0, value: "Deleting deployment..." }] });
         await withSpinner(spinnerMsg, async () => {
-            return await clasp.project.undeploy(id);
+            return clasp.project.undeploy(id);
         });
-        const successMessage = intl.formatMessage({ id: "GbtFER", defaultMessage: [{ type: 0, value: "Deleted deployment " }, { type: 1, value: "id" }] }, { id });
-        console.log(successMessage);
+        deletedDeploymentIds.push(id);
+        if (!options.json) {
+            const successMessage = intl.formatMessage({ id: "GbtFER", defaultMessage: [{ type: 0, value: "Deleted deployment " }, { type: 1, value: "id" }] }, { id });
+            console.log(successMessage);
+        }
     };
     if (removeAll) {
         const spinnerMsg = intl.formatMessage({ id: "baVdkq", defaultMessage: [{ type: 0, value: "Fetching deployments..." }] });
@@ -32,6 +52,10 @@ export const command = new Command('delete-deployment')
             }
             await deleteDeployment(id);
         }
+        if (options.json) {
+            console.log(JSON.stringify({ deletedDeploymentIds }, null, 2));
+            return;
+        }
         const successMessage = intl.formatMessage({ id: "cE8hF0", defaultMessage: [{ type: 0, value: "Deleted all deployments." }] });
         console.log(successMessage);
         return;
@@ -64,8 +88,15 @@ export const command = new Command('delete-deployment')
         }
     }
     if (!deploymentId) {
+        if (options.json) {
+            console.log(JSON.stringify({ deletedDeploymentIds: [] }, null, 2));
+            return;
+        }
         const msg = intl.formatMessage({ id: "UufukD", defaultMessage: [{ type: 0, value: "No deployments found." }] });
         this.error(msg);
     }
     await deleteDeployment(deploymentId);
+    if (options.json) {
+        console.log(JSON.stringify({ deletedDeploymentIds }, null, 2));
+    }
 });

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

@@ -0,0 +1,41 @@
+import { Command } from 'commander';
+import inquirer from 'inquirer';
+import { intl } from '../intl.js';
+import { isInteractive, withSpinner } from './utils.js';
+export const command = new Command('delete-script')
+    .alias('delete')
+    .description('Delete a project')
+    .argument('[scriptId]', 'Apps Script ID to list deployments for')
+    .option('-f, --force', "Bypass any confirmation messages. It's not a good idea to do this unless you want to run clasp from a script.")
+    .action(async function (scriptId) {
+    const options = this.optsWithGlobals();
+    const clasp = options.clasp;
+    if (scriptId) {
+        clasp.withScriptId(scriptId);
+    }
+    if (!clasp.project.scriptId) {
+        const msg = intl.formatMessage({ id: "6dAsTC", defaultMessage: [{ type: 0, value: "Script ID not set, unable to delete the script." }] });
+        this.error(msg);
+    }
+    //ask confirmation
+    let confirmed = options.force || false;
+    if (!confirmed && isInteractive()) {
+        const promptDeleteDriveFiles = intl.formatMessage({ id: "DKO5+J", defaultMessage: [{ type: 0, value: "Are you sure you want to delete the script?" }] });
+        const answerDeleteDriveFiles = await inquirer.prompt([
+            {
+                default: false,
+                message: promptDeleteDriveFiles,
+                name: 'answer',
+                type: 'confirm',
+            },
+        ]);
+        confirmed = answerDeleteDriveFiles.answer;
+    }
+    if (!confirmed) {
+        return;
+    }
+    const spinnerMsg = intl.formatMessage({ id: "lRbOjS", defaultMessage: [{ type: 0, value: "Deleting your scripts..." }] });
+    await withSpinner(spinnerMsg, async () => await clasp.project.trashScript());
+    const successMessage = intl.formatMessage({ id: "zDXU5q", defaultMessage: [{ type: 0, value: "Deleted script " }, { type: 1, value: "scriptId" }] }, { scriptId: clasp.project.scriptId });
+    console.log(successMessage);
+});

package/build/src/commands/disable-api.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 'disable-api' command for the clasp CLI.
 import { Command } from 'commander';
 import { intl } from '../intl.js';
 import { assertGcpProjectConfigured, maybePromptForProjectId, withSpinner } from './utils.js';
@@ -5,13 +19,18 @@ export const command = new Command('disable-api')
     .description('Disable a service for the current project.')
     .argument('<api>', 'Service to disable')
     .action(async function (serviceName) {
-    const clasp = this.opts().clasp;
+    const options = this.optsWithGlobals();
+    const clasp = options.clasp;
     await maybePromptForProjectId(clasp);
     assertGcpProjectConfigured(clasp);
     const spinnerMsg = intl.formatMessage({ id: "awbyYM", defaultMessage: [{ type: 0, value: "Disabling service..." }] });
     await withSpinner(spinnerMsg, async () => {
         await clasp.services.disableService(serviceName);
     });
+    if (options.json) {
+        console.log(JSON.stringify({ success: true, disabledService: serviceName }, null, 2));
+        return;
+    }
     const successMessage = intl.formatMessage({ id: "tjmJ+e", defaultMessage: [{ type: 0, value: "Disabled " }, { type: 1, value: "name" }, { type: 0, value: " API." }] }, {
         name: serviceName,
     });

package/build/src/commands/enable-api.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 'enable-api' command for the clasp CLI.
 import { Command } from 'commander';
 import { intl } from '../intl.js';
 import { assertGcpProjectConfigured, maybePromptForProjectId, withSpinner } from './utils.js';
@@ -6,7 +20,8 @@ export const command = new Command('enable-api')
     .argument('<api>', 'Service to enable')
     .action(async function (serviceName) {
     var _a;
-    const clasp = this.opts().clasp;
+    const options = this.optsWithGlobals();
+    const clasp = options.clasp;
     await maybePromptForProjectId(clasp);
     assertGcpProjectConfigured(clasp);
     try {
@@ -24,6 +39,10 @@ export const command = new Command('enable-api')
         }
         throw error;
     }
+    if (options.json) {
+        console.log(JSON.stringify({ success: true }, null, 2));
+        return;
+    }
     const successMessage = intl.formatMessage({ id: "6lXgOl", defaultMessage: [{ type: 0, value: "Enabled " }, { type: 1, value: "name" }, { type: 0, value: " API." }] }, {
         name: serviceName,
     });

package/build/src/commands/list-apis.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 'list-apis' (alias 'apis') command for the clasp CLI.
 import { Command } from 'commander';
 import { intl } from '../intl.js';
 import { assertGcpProjectConfigured, maybePromptForProjectId, withSpinner } from './utils.js';
@@ -5,11 +19,20 @@ export const command = new Command('list-apis')
     .alias('apis')
     .description('List enabled APIs for the current project')
     .action(async function () {
-    const clasp = this.opts().clasp;
+    const options = this.optsWithGlobals();
+    const clasp = options.clasp;
     await maybePromptForProjectId(clasp);
     assertGcpProjectConfigured(clasp);
     const spinnerMsg = intl.formatMessage({ id: "aY+ZR2", defaultMessage: [{ type: 0, value: "Fetching APIs..." }] });
     const [enabledApis, availableApis] = await withSpinner(spinnerMsg, () => Promise.all([clasp.services.getEnabledServices(), clasp.services.getAvailableServices()]));
+    if (options.json) {
+        const output = {
+            enabledApis: enabledApis.map(api => ({ name: api.name, description: api.description })),
+            availableApis: availableApis.map(api => ({ name: api.name, description: api.description })),
+        };
+        console.log(JSON.stringify(output, null, 2));
+        return;
+    }
     const enabledApisLabel = intl.formatMessage({ id: "QfnjZ4", defaultMessage: [{ type: 0, value: "# Currently enabled APIs:" }] });
     console.log(`\n${enabledApisLabel}`);
     for (const service of enabledApis) {

package/build/src/commands/list-deployments.js

@@ -1,15 +1,45 @@
+// 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 'list-deployments' (alias 'deployments') command for
+// the clasp CLI.
 import { Command } from 'commander';
 import { intl } from '../intl.js';
 import { withSpinner } from './utils.js';
 export const command = new Command('list-deployments')
     .alias('deployments')
     .description('List deployment ids of a script')
-    .action(async function () {
-    const clasp = this.opts().clasp;
+    .argument('[scriptId]', 'Apps Script ID to list deployments for')
+    .action(async function (scriptId) {
+    const options = this.optsWithGlobals();
+    const clasp = options.clasp;
+    if (scriptId) {
+        clasp.withScriptId(scriptId);
+    }
     const spinnerMsg = intl.formatMessage({ id: "baVdkq", defaultMessage: [{ type: 0, value: "Fetching deployments..." }] });
-    const deployments = await withSpinner(spinnerMsg, async () => {
-        return await clasp.project.listDeployments();
-    });
+    const deployments = await withSpinner(spinnerMsg, () => clasp.project.listDeployments());
+    if (options.json) {
+        const deploymentOutput = deployments.results.map(deployment => {
+            var _a, _b;
+            return ({
+                deploymentId: deployment.deploymentId,
+                versionNumber: (_a = deployment.deploymentConfig) === null || _a === void 0 ? void 0 : _a.versionNumber,
+                description: (_b = deployment.deploymentConfig) === null || _b === void 0 ? void 0 : _b.description,
+            });
+        });
+        console.log(JSON.stringify(deploymentOutput, null, 2));
+        return;
+    }
     if (!deployments.results.length) {
         const msg = intl.formatMessage({ id: "q2/XsW", defaultMessage: [{ type: 0, value: "No deployments." }] });
         console.log(msg);

package/build/src/commands/list-scripts.js

@@ -1,3 +1,18 @@
+// 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 'list-scripts' (alias 'list') command for the clasp
+// CLI.
 import { Command } from 'commander';
 import { intl } from '../intl.js';
 import { ellipsize, withSpinner } from './utils.js';
@@ -5,12 +20,21 @@ export const command = new Command('list-scripts')
     .alias('list')
     .description('List App Scripts projects')
     .option('--noShorten', 'Do not shorten long names', false)
-    .action(async function (options) {
-    const clasp = this.opts().clasp;
+    .action(async function () {
+    const options = this.optsWithGlobals();
+    const clasp = options.clasp;
     const spinnerMsg = intl.formatMessage({ id: "x0awdZ", defaultMessage: [{ type: 0, value: "Finding your scripts..." }] });
     const files = await withSpinner(spinnerMsg, async () => {
         return clasp.project.listScripts();
     });
+    if (options.json) {
+        const scripts = files.results.map(file => ({
+            id: file.id,
+            name: file.name,
+        }));
+        console.log(JSON.stringify(scripts, null, 2));
+        return;
+    }
     if (!files.results.length) {
         const msg = intl.formatMessage({ id: "rPMgOk", defaultMessage: [{ type: 0, value: "No script files found." }] });
         console.log(msg);

package/build/src/commands/list-versions.js

@@ -1,18 +1,46 @@
+// 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 'list-versions' (alias 'versions') command for the
+// clasp CLI.
 import { Command } from 'commander';
 import { intl } from '../intl.js';
 import { withSpinner } from './utils.js';
 export const command = new Command('list-versions')
     .alias('versions')
     .description('List versions of a script')
-    .action(async function () {
-    const clasp = this.opts().clasp;
+    .argument('[scriptId]', 'Apps Script ID to list deployments for')
+    .action(async function (scriptId) {
+    var _a;
+    const options = this.optsWithGlobals();
+    const clasp = options.clasp;
+    if (scriptId) {
+        clasp.withScriptId(scriptId);
+    }
     const spinnerMsg = intl.formatMessage({ id: "Cqxqh0", defaultMessage: [{ type: 0, value: "Fetching versions..." }] });
-    const versions = await withSpinner(spinnerMsg, async () => {
-        return await clasp.project.listVersions();
-    });
-    if (versions.results.length === 0) {
+    const versions = await withSpinner(spinnerMsg, () => clasp.project.listVersions());
+    if (options.json) {
+        const versionOutput = versions.results.map(version => ({
+            versionNumber: version.versionNumber,
+            description: version.description,
+        }));
+        console.log(JSON.stringify(versionOutput, null, 2));
+        return;
+    }
+    if (!((_a = versions.results) === null || _a === void 0 ? void 0 : _a.length)) {
         const msg = intl.formatMessage({ id: "Jmvq7L", defaultMessage: [{ type: 0, value: "No deployed versions of script." }] });
-        this.error(msg);
+        console.log(msg);
+        return;
     }
     const successMessage = intl.formatMessage({ id: "6CS9SE", defaultMessage: [{ type: 0, value: "Found " }, { type: 6, value: "count", options: { one: { value: [{ type: 7 }, { type: 0, value: " version" }] }, other: { value: [{ type: 7 }, { type: 0, value: " versions" }] } }, offset: 0, pluralType: "cardinal" }, { type: 0, value: "." }] }, {
         count: versions.results.length,