@google/clasp 3.1.0 → 3.1.3

package/README.md

@@ -1,5 +1,7 @@
 # Clasp
 
+Note: This is not an officially support Google product.
+
 ![build status](https://github.com/google/clasp/actions/workflows/ci.yaml/badge.svg)
 <a href="https://coveralls.io/github/google/clasp?branch=master"><img src="https://coveralls.io/repos/github/google/clasp/badge.svg?branch=master" alt="Coverage Status"></a>
 <a href="https://www.npmjs.com/package/@google/clasp"><img src="https://img.shields.io/npm/v/@google/clasp.svg" alt="npm Version"></a>
@@ -64,6 +66,18 @@ Then enable the Google Apps Script API: https://script.google.com/home/usersetti
 
 ![Enable Apps Script API](https://user-images.githubusercontent.com/744973/54870967-a9135780-4d6a-11e9-991c-9f57a508bdf0.gif)
 
+### Installing as a Gemini CLI Extension
+
+You can install clasp as an Gemini CLI extensions using the following command:
+
+```sh
+gemini extensions install https://github.com/google/clasp
+```
+
+This makes clasp available as an MCP server in Gemini CLI. 
+
+Make sure to enable the Google Apps Script API (as explained above) and perform a `clasp login` (with your specific login parameters) before you use the extension.
+
 ## Commands
 
 The following command provide basic Apps Script project management.

package/build/src/auth/auth.js

@@ -135,7 +135,7 @@ export async function authorize(options) {
     }
     else {
         debug('Starting auth with local server flow');
-        flow = new LocalServerAuthorizationCodeFlow(options.oauth2Client);
+        flow = new LocalServerAuthorizationCodeFlow(options.oauth2Client, options.redirectPort);
     }
     const client = await flow.authorize(options.scopes);
     await saveOauthClientCredentials(options.store, options.userKey, client);

package/build/src/auth/localhost_auth_code_flow.js

@@ -26,9 +26,10 @@ import { AuthorizationCodeFlow, parseAuthResponseUrl } from './auth_code_flow.js
  * authorization code.
  */
 export class LocalServerAuthorizationCodeFlow extends AuthorizationCodeFlow {
-    constructor(oauth2client) {
+    constructor(oauth2client, port) {
         super(oauth2client);
         this.port = 0;
+        this.port = port;
     }
     /**
      * Starts a local HTTP server and returns its address as the redirect URI.

package/build/src/auth/serverless_auth_code_flow.js

@@ -44,12 +44,14 @@ export class ServerlessAuthorizationCodeFlow extends AuthorizationCodeFlow {
      * @throws {Error} If the pasted URL contains an error or no code.
      */
     async promptAndReturnCode(authorizationUrl) {
-        const prompt = intl.formatMessage({ id: "Tx67iE", defaultMessage: [{ type: 0, value: "Authorize clasp by visiting the following URL on another device: " }, { type: 1, value: "url" }, { type: 0, value: " After authorization, copy the URL in the browser. Enter the URL from your browser after completing authorization" }] }, {
+        const urlMessage = intl.formatMessage({ id: "7EHKbR", defaultMessage: [{ type: 0, value: "\uD83D\uDD11 Authorize clasp by visiting this url: " }, { type: 1, value: "url" }] }, {
             url: authorizationUrl,
         });
+        console.log(urlMessage);
+        const promptMessage = intl.formatMessage({ id: "xADuBP", defaultMessage: [{ type: 0, value: "After authorizing, copy the URL from your browser and paste it here:" }] });
         const answer = await inquirer.prompt([
             {
-                message: prompt,
+                message: promptMessage,
                 name: 'url',
                 type: 'input',
             },

package/build/src/commands/login.js

@@ -18,6 +18,7 @@
 import { Command } from 'commander';
 import { authorize, getUnauthorizedOuth2Client, getUserInfo } from '../auth/auth.js';
 import { intl } from '../intl.js';
+import { validateOptionInt } from './validate.js';
 const DEFAULT_SCOPES = [
     // Default to clasp scopes
     'https://www.googleapis.com/auth/script.deployments', // Apps Script deployments
@@ -36,7 +37,7 @@ export const command = new Command('login')
     .option('--no-localhost', 'Do not run a local server, manually enter code instead')
     .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.')
+    .option('--redirect-port <port>', 'Specify a custom port for the redirect URL.', val => validateOptionInt(val, 0, 65535))
     .action(async function () {
     var _a;
     const options = this.optsWithGlobals();

package/build/src/commands/validate.js

@@ -0,0 +1,39 @@
+// 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 module provides validatition functions for commandline options and arguments
+import { InvalidOptionArgumentError } from 'commander';
+/**
+ * Validates if the value is an integer.
+ * If the startInclusive and endInclusive parameters are provided, additional check against the bounds
+ *
+ * @returns {number} The valid integer value.
+ * @throws {InvalidOptionArgumentError} If value is not an integer or out of bounds.
+ */
+export const validateOptionInt = (val, startInclusive, endInclusive) => {
+    let errorMsg = '';
+    // Commander already handles the case where the option was provided with no argument
+    if (val) {
+        if (!Number.isInteger(Number(val))) {
+            errorMsg = `'${val}' is not a valid integer.`;
+        }
+        else {
+            if (startInclusive != null && endInclusive != null && (val < startInclusive || val > endInclusive)) {
+                errorMsg = `'${val}' should be >= ${startInclusive} and <= ${endInclusive}.`;
+            }
+        }
+        if (errorMsg)
+            throw new InvalidOptionArgumentError(errorMsg);
+    }
+    return val;
+};

package/docs/run.md

@@ -67,7 +67,7 @@ After setup, you can remotely execute Apps Script functions from `clasp`:
 
 If you get an "Script API executable not published/deployed." error, deploy your script as an API Executable:
 
-- Run `clasp open`
+- Run `clasp open-script`
 - Click `Deploy > New deployment`
 - Select type ⚙ > API Executable
 - Type a `Description`
@@ -79,7 +79,7 @@ Many Apps Script functions require special OAuth Scopes (Gmail, Drive, etc.).
 
 To run functions that use these scopes, you must add the scopes to your Apps Script manifest and `clasp login` again.
 
-- `clasp open`
+- `clasp open-script`
 - `File > Project Properties > Scopes`
 - Add these [scopes to your `appsscript.json`](https://developers.google.com/apps-script/concepts/scopes#set-explicit).
 - Log in again: `clasp login --user <name> --use-project-scopes --creds creds.json`. This will add these scopes to your credentials.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@google/clasp",
-  "version": "3.1.0",
+  "version": "3.1.3",
   "description": "Develop Apps Script Projects locally",
   "type": "module",
   "exports": "./build/src/index.js",
@@ -102,6 +102,7 @@
     "c8": "^10.1.3",
     "chai": "^5.2.0",
     "chai-as-promised": "^8.0.1",
+    "esmock": "^2.7.3",
     "mocha": "^11.2.2",
     "mock-fs": "^5.5.0",
     "nock": "^14.0.4",