@mcpher/gas-fakes 1.2.18 → 1.2.20

package/README.RU.md

@@ -332,7 +332,7 @@ const getParentsIterator = ({
 - [named colors](named-colors.md)
 - [sandbox](sandbox.md)
 
-## <img src="./logo.png" alt="gas-fakes logo" width="50" align="top">  Further Reading
+## <img src="./logo.png" alt="gas-fakes logo" width="50" align="top"> Further Reading
 
 - [getting started](GETTING_STARTED.md) - how to handle authentication for restricted scopes.
 - [readme](README.md)
@@ -359,8 +359,9 @@ const getParentsIterator = ({
 - [Supercharge Your Google Apps Script Caching with GasFlexCache](https://ramblings.mcpher.com/supercharge-your-google-apps-script-caching-with-gasflexcache/)
 - [Fake-Sandbox for Google Apps Script: Granular controls.](https://ramblings.mcpher.com/fake-sandbox-for-google-apps-script-granular-controls/)
 - [A Fake-Sandbox for Google Apps Script: Securely Executing Code Generated by Gemini CLI](https://ramblings.mcpher.com/gas-fakes-sandbox/)
+- [Modern Google Apps Script Workflow Building on the Cloud](https://medium.com/google-cloud/modern-google-apps-script-workflow-building-on-the-cloud-2255dbd32ac3)
 - [Bridging the Gap: Seamless Integration for Local Google Apps Script Development](https://medium.com/@tanaike/bridging-the-gap-seamless-integration-for-local-google-apps-script-development-9b9b973aeb02)
 - [Next-Level Google Apps Script Development](https://medium.com/google-cloud/next-level-google-apps-script-development-654be5153912)
 - [Secure and Streamlined Google Apps Script Development with gas-fakes CLI and Gemini CLI Extension](https://medium.com/google-cloud/secure-and-streamlined-google-apps-script-development-with-gas-fakes-cli-and-gemini-cli-extension-67bbce80e2c8)
 - [Secure and Conversational Google Workspace Automation: Integrating Gemini CLI with a gas-fakes MCP Server](https://medium.com/google-cloud/secure-and-conversational-google-workspace-automation-integrating-gemini-cli-with-a-gas-fakes-mcp-0a5341559865)
-- [A Fake-Sandbox for Google Apps Script: A Feasibility Study on Securely Executing Code Generated by Gemini CL](https://medium.com/google-cloud/a-fake-sandbox-for-google-apps-script-a-feasibility-study-on-securely-executing-code-generated-by-cc985ce5dae3)
+- [A Fake-Sandbox for Google Apps Script: A Feasibility Study on Securely Executing Code Generated by Gemini CL](https://medium.com/google-cloud/a-fake-sandbox-for-google-apps-script-a-feasibility-study-on-securely-executing-code-generated-by-cc985ce5dae3)

package/README.md

@@ -151,7 +151,7 @@ For inspiration on pushing modified files to the IDE, see the togas.sh bash scri
 
 As I mentioned earlier, to take this further, I'm going to need a lot of help to extend the methods and services supported - so if you feel this would be useful to you, and would like to collaborate, please ping me on bruce@mcpher.com and we'll talk.
 
-## <img src="./logo.png" alt="gas-fakes logo" width="50" align="top">  Further Reading
+## <img src="./logo.png" alt="gas-fakes logo" width="50" align="top"> Further Reading
 
 - [getting started](GETTING_STARTED.md) - how to handle authentication for restricted scopes.
 - [readme](README.md)
@@ -178,8 +178,9 @@ As I mentioned earlier, to take this further, I'm going to need a lot of help to
 - [Supercharge Your Google Apps Script Caching with GasFlexCache](https://ramblings.mcpher.com/supercharge-your-google-apps-script-caching-with-gasflexcache/)
 - [Fake-Sandbox for Google Apps Script: Granular controls.](https://ramblings.mcpher.com/fake-sandbox-for-google-apps-script-granular-controls/)
 - [A Fake-Sandbox for Google Apps Script: Securely Executing Code Generated by Gemini CLI](https://ramblings.mcpher.com/gas-fakes-sandbox/)
+- [Modern Google Apps Script Workflow Building on the Cloud](https://medium.com/google-cloud/modern-google-apps-script-workflow-building-on-the-cloud-2255dbd32ac3)
 - [Bridging the Gap: Seamless Integration for Local Google Apps Script Development](https://medium.com/@tanaike/bridging-the-gap-seamless-integration-for-local-google-apps-script-development-9b9b973aeb02)
 - [Next-Level Google Apps Script Development](https://medium.com/google-cloud/next-level-google-apps-script-development-654be5153912)
 - [Secure and Streamlined Google Apps Script Development with gas-fakes CLI and Gemini CLI Extension](https://medium.com/google-cloud/secure-and-streamlined-google-apps-script-development-with-gas-fakes-cli-and-gemini-cli-extension-67bbce80e2c8)
 - [Secure and Conversational Google Workspace Automation: Integrating Gemini CLI with a gas-fakes MCP Server](https://medium.com/google-cloud/secure-and-conversational-google-workspace-automation-integrating-gemini-cli-with-a-gas-fakes-mcp-0a5341559865)
-- [A Fake-Sandbox for Google Apps Script: A Feasibility Study on Securely Executing Code Generated by Gemini CL](https://medium.com/google-cloud/a-fake-sandbox-for-google-apps-script-a-feasibility-study-on-securely-executing-code-generated-by-cc985ce5dae3)
+- [A Fake-Sandbox for Google Apps Script: A Feasibility Study on Securely Executing Code Generated by Gemini CL](https://medium.com/google-cloud/a-fake-sandbox-for-google-apps-script-a-feasibility-study-on-securely-executing-code-generated-by-cc985ce5dae3)

package/gas-fakes.js

@@ -31,7 +31,7 @@ const VERSION = pjson.version;
 // CONSTANTS & UTILITIES
 // -----------------------------------------------------------------------------
 
-const CLI_VERSION = "0.0.11";
+const CLI_VERSION = "0.0.13";
 const MCP_VERSION = "0.0.3";
 const execAsync = promisify(exec);
 
@@ -475,9 +475,9 @@ async function main() {
         // We check if the command is not one of the others.
         const knownCommands = program.commands.map((cmd) => cmd.name());
         if (!process.argv.slice(2).some((arg) => knownCommands.includes(arg))) {
-          console.error(
-            "Error: You must provide a script via --filename or --script, or use a specific command (e.g., init, auth, mcp)."
-          );
+          // console.error(
+          //   "Error: You must provide a script via --filename or --script, or use a specific command (e.g., init, auth, mcp)."
+          // );
           program.help();
           process.exit(1);
         }
@@ -529,6 +529,7 @@ async function main() {
     .description(
       "Initializes the configuration by creating or updating the .env file."
     )
+    .option("-e, --env <path>", "Path to a custom .env file.")
     .action(initializeConfiguration);
 
   program

package/package.json

@@ -32,7 +32,7 @@
   },
   "name": "@mcpher/gas-fakes",
   "author": "bruce mcpherson",
-  "version": "1.2.18",
+  "version": "1.2.20",
   "license": "MIT",
   "main": "main.js",
   "description": "A proof of concept implementation of Apps Script Environment on Node",

package/setup.js

@@ -75,26 +75,51 @@ function runCommand(command) {
 }
 
 // --- Exported Command Implementations ---
+export async function initializeConfiguration(options = {}) {
+  let envPath;
 
-/**
- * Handles the 'init' command to configure the .env file.
- */
-export async function initializeConfiguration() {
-  let envPath = path.join(process.cwd(), ".env");
-  const searchPath = process.cwd(); // or process.env.HOME
-  const absoluteSearchPath = path.resolve(searchPath);
-  const foundFiles = await findEnvFiles(absoluteSearchPath);
-  if (foundFiles.length > 0) {
-    // Check .env on the top directory.
-    const results = foundFiles
-      .map((file) => file.split("/"))
-      .sort((a, b) => (a.length > b.length ? 1 : -1));
-    envPath = results[0].join("/");
+  if (options.env) {
+    envPath = path.resolve(process.cwd(), options.env);
+    console.log(`-> Using specified .env path: ${envPath}`);
+  } else {
+    const foundFiles = await findEnvFiles(process.cwd());
+    if (foundFiles.length > 0) {
+      const choices = foundFiles.map((file) => ({
+        title: file,
+        value: file,
+      }));
+      choices.push({
+        title: "Create a new .env file in the current directory",
+        value: "new",
+      });
+
+      const response = await prompts({
+        type: "select",
+        name: "envPathSelection",
+        message: "Found .env file(s). Which one would you like to use?",
+        choices: choices,
+      });
+
+      if (typeof response.envPathSelection === "undefined") {
+        console.log("Initialization cancelled.");
+        return;
+      }
+
+      if (response.envPathSelection === "new") {
+        envPath = path.join(process.cwd(), ".env");
+      } else {
+        envPath = response.envPathSelection;
+      }
+    } else {
+      console.log(
+        "No .env file found. A new one will be created in the current directory."
+      );
+      envPath = path.join(process.cwd(), ".env");
+    }
+    console.log(`-> Using .env file at: ${envPath}`);
   }
 
   let existingConfig = {};
-
-  // Load existing values from .env file if it exists to use as defaults for prompts.
   if (existsSync(envPath)) {
     console.log(
       "Found existing .env file. Loading current values as defaults."
@@ -105,47 +130,196 @@ export async function initializeConfiguration() {
   console.log("--------------------------------------------------");
   console.log("Configuring .env for gas-fakes");
   console.log("Press Enter to accept the default value in brackets.");
+  console.log("Use Space to select/deselect scopes.");
   console.log("--------------------------------------------------");
 
-  const questions = [
+  const existingExtraScopes = existingConfig.EXTRA_SCOPES
+    ? existingConfig.EXTRA_SCOPES.split(",").filter((s) => s)
+    : [];
+
+  const responses = {};
+
+  // --- Stage 1: Basic Info ---
+  const basicInfoQuestions = [
     {
       type: "text",
       name: "GCP_PROJECT_ID",
       message: "Enter your GCP Project ID",
-      initial: existingConfig.GCP_PROJECT_ID || "",
+      initial:
+        existingConfig.GCP_PROJECT_ID || process.env.GOOGLE_CLOUD_PROJECT,
     },
     {
       type: "text",
       name: "DRIVE_TEST_FILE_ID",
-      message: "Enter a test Drive file ID for authentication checks",
+      message:
+        "Enter a test Drive file ID for authentication checks (optional)",
       initial: existingConfig.DRIVE_TEST_FILE_ID || "",
     },
-    {
-      type: "text",
-      name: "CLIENT_CREDENTIAL_FILE",
-      message: "Enter path to OAuth client credentials JSON (optional)",
-      initial: existingConfig.CLIENT_CREDENTIAL_FILE || "",
-    },
-    {
-      type: "text",
-      name: "DEFAULT_SCOPES",
-      message: "Enter default scopes",
-      initial:
-        existingConfig.DEFAULT_SCOPES ||
-        "https://www.googleapis.com/auth/userinfo.email,openid,https://www.googleapis.com/auth/cloud-platform",
+  ];
+
+  const basicInfoResponses = await prompts(basicInfoQuestions);
+  if (typeof basicInfoResponses.GCP_PROJECT_ID === "undefined") {
+    console.log("Initialization cancelled.");
+    return;
+  }
+  Object.assign(responses, basicInfoResponses);
+
+  // --- Stage 2: Scopes ---
+
+  const DEFAULT_SCOPES_VALUES = [
+    "https://www.googleapis.com/auth/userinfo.email",
+    "openid",
+    "https://www.googleapis.com/auth/cloud-platform",
+  ];
+  console.log(
+    "\nThe following default scopes are required for basic operations and will be enabled automatically:"
+  );
+  DEFAULT_SCOPES_VALUES.forEach((scope) => console.log(`  - ${scope}`));
+  responses.DEFAULT_SCOPES = DEFAULT_SCOPES_VALUES;
+
+  const extraScopeQuestion = {
+    type: "multiselect",
+    name: "EXTRA_SCOPES",
+    message: "Select any extra scopes your script requires",
+
+    // i think we only need to have drive (which we must have for all the others anyway)
+    choices: [
+      {
+        title: "Workspace resources",
+        value: "https://www.googleapis.com/auth/drive",
+      },
+      /*
+      {
+        title: "Sheets (full access)",
+        value: "https://www.googleapis.com/auth/spreadsheets",
+      },
+      {
+        title: "Docs (full access)",
+        value: "https://www.googleapis.com/auth/documents",
+      },
+      {
+        title: "Forms (full access)",
+        value: "https://www.googleapis.com/auth/forms",
+      },
+      {
+        title: "Gmail (send mail)",
+        value: "https://www.googleapis.com/auth/gmail.send",
+      },
+      {
+        title: "Gmail (full access)",
+        value: "https://www.googleapis.com/auth/gmail.modify",
+      },
+      */
+      {
+        // actually labels are not sensitive
+        title: "Gmail labels",
+        value: "https://www.googleapis.com/auth/gmail.labels",
+      },
+      {
+        sensitivity: "sensitive",
+        title: "Gmail compose",
+        value: "https://www.googleapis.com/auth/gmail.compose",
+      },
+    ].map((scope) => ({
+      ...scope,
+      title: scope.sensitivity
+        ? `[${scope.sensitivity}] ${scope.title}`
+        : scope.title,
+      // because we always need drive for ant extra scopes
+      selected:
+        existingExtraScopes.length > 0
+          ? existingExtraScopes.includes(scope.value)
+          : scope.value === "https://www.googleapis.com/auth/drive",
+    })),
+    hint: "- Use space to select/deselect. Press Enter to submit.",
+  };
+
+  // to check for any kind of sensitivity
+  const sensitiveScopesList = extraScopeQuestion.choices.filter(
+    (scope) => scope.sensitivity
+  );
+
+  const extraScopeResponses = await prompts(extraScopeQuestion);
+
+  if (typeof extraScopeResponses.EXTRA_SCOPES === "undefined") {
+    console.log("Initialization cancelled.");
+    return;
+  }
+  Object.assign(responses, extraScopeResponses);
+
+  const selectedExtraScopes = responses.EXTRA_SCOPES || [];
+
+  const usesSensitiveScopes = sensitiveScopesList.some((s) =>
+    selectedExtraScopes.includes(s.value)
+  );
+
+  if (usesSensitiveScopes) {
+    console.log("\n--------------------------------------------------");
+    console.log(
+      "You have selected sensitive or restricted scopes. Google requires an OAuth client credential file for these."
+    );
+    console.log(
+      "See the getting started guide https://github.com/brucemcpherson/gas-fakes/blob/main/GETTING_STARTED.md for how."
+    );
+    console.log("--------------------------------------------------");
+  }
+
+  const clientCredentialQuestion = {
+    type: "text",
+    name: "CLIENT_CREDENTIAL_FILE",
+    message: usesSensitiveScopes
+      ? "Enter the path and filename for your OAuth client credentials JSON"
+      : "Enter path to OAuth client credentials JSON (optional)",
+    initial: existingConfig.CLIENT_CREDENTIAL_FILE || "",
+    validate: (input) => {
+      const trimmedInput = input.trim();
+
+      if (usesSensitiveScopes) {
+        if (trimmedInput === "") {
+          return "This field is required for the selected sensitive scopes.";
+        }
+      } else {
+        if (trimmedInput === "") {
+          return true;
+        }
+      }
+
+      const resolvedPath = path.resolve(process.cwd(), trimmedInput);
+      if (!existsSync(resolvedPath)) {
+        return `File not found at '${resolvedPath}'. Please check the path and try again.`;
+      }
+
+      return true;
     },
+  };
+
+  const clientCredentialResponse = await prompts(clientCredentialQuestion);
+  if (typeof clientCredentialResponse.CLIENT_CREDENTIAL_FILE === "undefined") {
+    console.log("Initialization cancelled.");
+    return;
+  }
+  Object.assign(responses, clientCredentialResponse);
+
+  // --- Stage 3: Remaining Config ---
+  const defaultScopesDisplay = `\n  - Default: [${responses.DEFAULT_SCOPES.join(
+    ", "
+  )}]`;
+  const extraScopesDisplay =
+    responses.EXTRA_SCOPES && responses.EXTRA_SCOPES.length > 0
+      ? `\n  - Extra:   [${responses.EXTRA_SCOPES.join(", ")}]`
+      : "\n  - Extra:   [None]";
+
+  const remainingQuestions = [
     {
-      type: "text",
-      name: "EXTRA_SCOPES",
-      message: "Enter any extra scopes (comma-separated)",
-      initial:
-        existingConfig.EXTRA_SCOPES ||
-        ",https://www.googleapis.com/auth/drive,https://www.googleapis.com/auth/spreadsheets",
+      type: "toggle",
+      name: "QUIET",
+      message: "Run gas-fakes package in quiet mode",
+      initial: existingConfig.QUIET === "true" ? true : false,
     },
     {
       type: "select",
       name: "LOG_DESTINATION",
-      message: "Enter logging destination",
+      message: `Selected Scopes:${defaultScopesDisplay}${extraScopesDisplay}\n\nEnter logging destination`,
       choices: [
         { title: "CONSOLE", value: "CONSOLE" },
         { title: "CLOUD", value: "CLOUD" },
@@ -177,19 +351,22 @@ export async function initializeConfiguration() {
     },
   ];
 
-  const responses = await prompts(questions);
-
-  // If the user cancels (e.g., Ctrl+C), prompts returns undefined for the keys.
-  if (typeof responses.GCP_PROJECT_ID === "undefined") {
+  const remainingResponses = await prompts(remainingQuestions);
+  if (typeof remainingResponses.LOG_DESTINATION === "undefined") {
     console.log("Initialization cancelled.");
-    return; // Exit the function without writing to file.
+    return;
+  }
+  Object.assign(responses, remainingResponses);
+
+  // Convert scope arrays to comma-separated strings for saving
+  if (Array.isArray(responses.DEFAULT_SCOPES)) {
+    responses.DEFAULT_SCOPES = responses.DEFAULT_SCOPES.join(",");
+  }
+  if (Array.isArray(responses.EXTRA_SCOPES)) {
+    responses.EXTRA_SCOPES = responses.EXTRA_SCOPES.join(",");
   }
 
-  // If Upstash is selected, ask for its credentials.
   if (responses.STORE_TYPE === "UPSTASH") {
-    console.log(
-      "Upstash storage selected. Please provide your Redis credentials."
-    );
     const upstashQuestions = [
       {
         type: "text",
@@ -213,64 +390,76 @@ export async function initializeConfiguration() {
     Object.assign(responses, upstashResponses);
   }
 
-  console.log("--------------------------------------------------");
-  console.log(`Writing configuration to ${envPath}...`);
+  // --- Confirmation Step ---
+  console.log("\n------------------ Summary ------------------");
+  Object.entries(responses).forEach(([key, value]) => {
+    if (value !== undefined) console.log(`${key}: ${value}`);
+  });
+  console.log("-------------------------------------------");
+
+  const confirmSave = await prompts({
+    type: "confirm",
+    name: "save",
+    message: `Save this configuration to ${envPath}?`,
+    initial: true,
+  });
+
+  if (!confirmSave.save) {
+    console.log("Configuration discarded. No changes were made.");
+    return;
+  }
 
-  if (!existsSync(envPath)) {
-    // --- Create a new .env file from a template ---
+  // --- File Writing Logic ---
+  console.log(`Writing configuration to "${envPath}"...`);
+  const inits =
+    responses.STORE_TYPE !== "UPSTASH"
+      ? { UPSTASH_REDIS_REST_TOKEN: "", UPSTASH_REDIS_REST_URL: "" }
+      : {};
+  const finalConfig = { ...existingConfig, ...responses, ...inits };
+
+  console.log("\n------------------ Final output ------------------");
+  const envContent = Reflect.ownKeys(finalConfig)
+    .map((key) => {
+      const item = finalConfig[key];
+      const res = `${key}="${(item.toString() || "").trim()}"`;
+      console.log(res);
+      return res;
+    })
+    .join("\n");
+  /* replacing this to include existing values
     let envContent = `
-# Google Cloud Project ID (required)
-GCP_PROJECT_ID="${responses.GCP_PROJECT_ID || ""}"
-
-# Path to OAuth client credentials for restricted scopes (optional)
-CLIENT_CREDENTIAL_FILE="${responses.CLIENT_CREDENTIAL_FILE || ""}"
-
-# A test file ID for checking authentication (optional)
-DRIVE_TEST_FILE_ID="${responses.DRIVE_TEST_FILE_ID || ""}"
-
-# Storage configuration for PropertiesService and CacheService ('FILE' or 'UPSTASH')
-STORE_TYPE="${responses.STORE_TYPE || "FILE"}"
-
-# Logging destination for Logger.log() ('CONSOLE', 'CLOUD', 'BOTH', 'NONE')
-LOG_DESTINATION="${responses.LOG_DESTINATION || "CONSOLE"}"
-
-# Scopes for authentication
-# these are the scopes set by default - take some of these out if you want to minimize access
-DEFAULT_SCOPES="${responses.DEFAULT_SCOPES || ""}"
-EXTRA_SCOPES="${responses.EXTRA_SCOPES || ""}"
-`.trim();
-
-    if (responses.STORE_TYPE === "UPSTASH") {
+  # Google Cloud Project ID (required)
+  GCP_PROJECT_ID="${finalConfig.GCP_PROJECT_ID || ""}"
+  
+  # Path to OAuth client credentials for restricted scopes (optional)
+  CLIENT_CREDENTIAL_FILE="${finalConfig.CLIENT_CREDENTIAL_FILE || ""}"
+  
+  # A test file ID for checking authentication (optional)
+  DRIVE_TEST_FILE_ID="${finalConfig.DRIVE_TEST_FILE_ID || ""}"
+  
+  # Storage configuration for PropertiesService and CacheService ('FILE' or 'UPSTASH')
+  STORE_TYPE="${finalConfig.STORE_TYPE || "FILE"}"
+  
+  # Logging destination for Logger.log() ('CONSOLE', 'CLOUD', 'BOTH', 'NONE')
+  LOG_DESTINATION="${finalConfig.LOG_DESTINATION || "CONSOLE"}"
+  
+  # Scopes for authentication
+  DEFAULT_SCOPES="${finalConfig.DEFAULT_SCOPES || ""}"
+  EXTRA_SCOPES="${finalConfig.EXTRA_SCOPES || ""}"
+  `.trim();
+  
+    if (finalConfig.STORE_TYPE === "UPSTASH") {
       envContent += `
-
-# Upstash credentials (only used if STORE_TYPE is 'UPSTASH')
-UPSTASH_REDIS_REST_URL="${responses.UPSTASH_REDIS_REST_URL || ""}"
-UPSTASH_REDIS_REST_TOKEN="${responses.UPSTASH_REDIS_REST_TOKEN || ""}"
-`;
-    }
-    writeFileSync(envPath, envContent, "utf8");
-  } else {
-    // --- Update the existing .env file ---
-    let envContent = readFileSync(envPath, "utf8");
-
-    const configToUpdate = { ...responses };
-
-    for (const key of Object.keys(configToUpdate)) {
-      const value = configToUpdate[key] || "";
-      const keyRegex = new RegExp(`^\\s*${key}\\s*=.*$`, "m");
-
-      if (keyRegex.test(envContent)) {
-        envContent = envContent.replace(keyRegex, `${key}="${value}"`);
-      } else {
-        if (envContent.length > 0 && !envContent.endsWith("\n")) {
-          envContent += "\n";
-        }
-        envContent += `${key}="${value}"\n`;
-      }
+  
+  # Upstash credentials (only used if STORE_TYPE is 'UPSTASH')
+  UPSTASH_REDIS_REST_URL="${finalConfig.UPSTASH_REDIS_REST_URL || ""}"
+  UPSTASH_REDIS_REST_TOKEN="${finalConfig.UPSTASH_REDIS_REST_TOKEN || ""}"
+  `;
     }
-    writeFileSync(envPath, envContent, "utf8");
-  }
+  */
+  writeFileSync(envPath, envContent + "\n", "utf8");
 
+  console.log("--------------------------------------------------");
   console.log("Setup complete. Your .env file has been updated.");
   console.log("--------------------------------------------------");
 }

package/src/services/advdocs/fakeadvdocuments.js

@@ -48,7 +48,6 @@ class FakeAdvDocuments extends FakeAdvResource {
 
     // Invalidate the cache for this document since we are updating it.
     docsCacher.clear(documentId);
-    // console.log (JSON.stringify(requests))
     const { response, data } = this._call("batchUpdate", {
       documentId,
       requestBody: requests

package/src/services/common/lazyloader.js

@@ -8,13 +8,12 @@ export const lazyLoaderApp = (app, name, maker) => {
    
             // if it hasne been intialized yet then do that
             if (!app) {
-                //console.log ('...loading', name)
                 app = maker()
             }
             // this is the actual driveApp we'll return from the proxy
             return app
         }
-        //console.log ('...registering', name)
+
         Proxies.registerProxy(name, getApp)
 
     }

package/src/services/documentapp/elementhelpers.js

@@ -2,7 +2,7 @@
  * @file Provides helper functions for working with fake document elements.
  */
 
-
+import {slogger } from "../../support/slogger.js";
 import { Utils } from "../../support/utils.js";
 const { is } = Utils
 
@@ -38,7 +38,7 @@ export const getElementProp = (se) => {
     return { prop: 'body', type: 'BODY_SECTION' };
   }
 
-  console.log(se);
+  slogger.error(se);
   throw new Error('couldnt establish structural element type');
 }
 
@@ -220,7 +220,7 @@ export const findItem = (elementMap, type, startIndex, segmentId) => {
     return f.__type === type && f.startIndex === startIndex;
   });
   if (!item) {
-    console.log(elementMap.values())
+    slogger.error(elementMap.values())
     throw new Error(`Couldnt find element ${type} at ${startIndex} in segment ${segmentId || 'body'}`)
   }
   return item

package/src/services/documentapp/shadowdocument.js

@@ -91,7 +91,7 @@ class ShadowDocument {
       __twig: footnoteSectionTree,
     };
     this.__elementMap.set(footnoteSectionName, footnoteSectionElement);
-    // console.log('named ranges after document fetch', JSON.stringify(currentNr))
+
 
     // maps all the elements to their named range
     const mapElements = (element, branch, segmentId, knownType = null) => {
@@ -127,7 +127,7 @@ class ShadowDocument {
       }
 
       if (!is.integer(element.endIndex) || !is.integer(element.startIndex)) {
-        console.log(element);
+        slogger.error(element);
         throw new Error(`failed to find endindex/startindex for ${type}`);
       }
       // For an empty document, we use static, non-API names to avoid re-indexing issues.

package/src/services/driveapp/fakedrivemeta.js

@@ -13,7 +13,7 @@ import { isFolder, notYetImplemented, isFakeFolder, signatureArgs } from '../../
 import { getParentsIterator } from './driveiterators.js';
 import { improveFileCache } from "../../support/filecache.js"
 import { getSharers } from '../../support/filesharers.js';
-
+import {slogger } from "../../support/slogger.js";
 /**
  * basic fake File meta data
  * these are shared between folders and files
@@ -34,7 +34,7 @@ export class FakeDriveMeta {
 
   __preventRootDamage = (operation) => {
     if (this.__isRoot) {
-      console.log (`Can't do ${operation} on root folder`)
+      slogger.error (`Can't do ${operation} on root folder`)
       throw new Error("Access denied: DriveApp")
     }
   }

package/src/services/logger/fakelogger.js

@@ -189,7 +189,7 @@ const writeToCloudOrConsole = (message, loggerInstance) => {
       headers,
     })
     if (response.getResponseCode() !== 200) {
-      console.log ('logging failure', response.getContentText())
+      console.error ('logging failure', response.getContentText())
     }
  
   }

package/src/services/scriptapp/app.js

@@ -9,6 +9,7 @@ import { Auth } from '../../support/auth.js'
 import { Proxies } from '../../support/proxies.js'
 import { newFakeBehavior } from './behavior.js'
 import { newCacheDropin , getUserIdFromToken} from '@mcpher/gas-flex-cache'
+import {slogger } from "../../support/slogger.js";
 /**
  * fake ScriptApp.getOAuthToken 
  * @return {string} token
@@ -79,7 +80,7 @@ const checkScopesMatch = (required) => {
     ]
     const hasIgnore = ignores.includes(s)
     if (hasIgnore) {
-      console.log('...ignoring requested scope for adc as google blocks it outside apps script' + s)
+      slogger.warn('...ignoring requested scope for adc as google blocks it outside apps script' + s)
     }
     // if drive is authorized and drive.readonly is required that's okay too
     // if drive.readonly is authorized and drive is requested thats not

package/src/services/scriptapp/behavior.js

@@ -1,5 +1,6 @@
 import { Proxies } from '../../support/proxies.js'
 import { Utils } from '../../support/utils.js'
+import {slogger } from "../../support/slogger.js";
 
 const { is } = Utils
 const checkArgs = (actual, expect = "boolean") => {
@@ -250,7 +251,7 @@ class FakeBehavior {
         throw new Error(`Invalid sandbox id parameter (${id}) - must be a non-empty string`);
       }
       if (!this.isKnown(id)) {
-        console.log(`...adding file ${id} to sandbox allowed list`);
+        slogger.log(`...adding file ${id} to sandbox allowed list`);
         this.__createdIds.add(id);
       }
     }
@@ -344,7 +345,7 @@ class FakeBehavior {
   trash() {
     // this is where we would trash all the created files
     if (!this.__cleanup) {
-      console.log('...skipping cleaning up sandbox files')
+      slogger.log('...skipping cleaning up sandbox files')
       return [];
     }
 
@@ -357,14 +358,14 @@ class FakeBehavior {
       }
       if (d) {
         d.setTrashed(true);
-        console.log(`...trashed file ${d.getName()} (${id})`);
+        slogger.log(`...trashed file ${d.getName()} (${id})`);
         acc.push(id);
       }
       return acc;
     }, []);
 
     this.__createdIds.clear();
-    console.log(`...trashed ${trashed.length} sandboxed files`);
+    slogger.log(`...trashed ${trashed.length} sandboxed files`);
     return trashed;
   }
   isKnown(id) {

package/src/services/spreadsheetapp/fakesheet.js

@@ -15,10 +15,8 @@ import { newFakeNamedRange } from "./fakenamedrange.js";
 import { newFakeProtection } from "./fakeprotection.js";
 import { newFakeOverGridImage } from "./fakeovergridimage.js";
 
-import { Syncit } from "../../support/syncit.js";
 import { XMLParser } from "fast-xml-parser";
-import { nullable } from "zod/v4";
-
+import {slogger } from "../../support/slogger.js";
 const { is, isEnum } = Utils;
 
 export const newFakeSheet = (properties, parent) => {
@@ -1082,7 +1080,7 @@ export class FakeSheet {
         const p = parser.parse(b.getDataAsString());
         o[filename] = p;
       } catch (err) {
-        // console.log(err);
+          slogger.error(err)
       }
       return o;
     }, {});

package/src/services/spreadsheetapp/sheetrangehelpers.js

@@ -1,5 +1,5 @@
 import { Utils } from '../../support/utils.js'
-
+import {slogger } from "../../support/slogger.js";
 const { is, hexToRgb } = Utils
 
 export const bandingThemeMap = {
@@ -135,7 +135,7 @@ export const isThemeColor = (color) =>{
 // Make a gridrange from a range
 export const makeGridRange = (range) => {
   if (!isRange(range)) {
-    console.log(range)
+    slogger.error(range)
     throw new Error(`expected a range but got ${typeof range}`)
   }
   return {

package/src/services/stores/fakestores.js

@@ -5,9 +5,8 @@ import { Utils } from '../../support/utils.js'
 import { storeModels } from './gasflex.js'
 import { newCacheDropin } from '@mcpher/gas-flex-cache'
 import { notYetImplemented } from '../../support/helpers.js'
-import { file } from 'googleapis/build/src/apis/file/index.js'
 const { is } = Utils
-
+import {slogger } from "../../support/slogger.js";
 /**
  * what these props mean
  * store_type = currently upstash or file - it defines the back end and maps to env variable
@@ -185,7 +184,7 @@ class FakeCacheService {
 export const newFakeService = (kind) => {
   kind = validateProp (kind, ServiceKind, 'service_kind')
   const w = whichCache ()
-  console.log (`...${kind} store service is using store type ${w.type} as backend`)
+  slogger.log (`...${kind} store service is using store type ${w.type} as backend`)
   return Proxies.guard(kind === ServiceKind.CACHE ? new FakeCacheService(w.type) : new FakePropertiesService(w.type))
 }
 

package/src/support/fakegasenum.js

@@ -11,7 +11,7 @@
  *
  * @example
  * const MyEnum = newFakeGasEnum('MyEnum', ['KEY_A', 'KEY_B']);
- * console.log(MyEnum.KEY_A); // Outputs: "KEY_A"
+ * c.log(MyEnum.KEY_A); // Outputs: "KEY_A"
  * MyEnum.KEY_A = 'new value'; // Throws an error in strict mode
  *
  * @param {string} name The name of the enum, used for `toString()` representation (e.g., "ElementType").

package/src/support/helpers.js

@@ -1,7 +1,7 @@
 import {Utils} from './utils.js'
 const {is, capital} = Utils
 import { Proxies } from './proxies.js'
-
+import {slogger } from "./slogger.js";
 /**
  * @constant
  * @type {string}
@@ -142,7 +142,7 @@ export const signatureArgs = (received, method, objectType = 'Object') => {
   try {
     passedTypes = args.map(f=>is.null(f) ? 'null' : is(f)).map(f=>f==='null'? f :capital(f)).map(f=>f==='Object' ? objectType : f)
   } catch (err) {
-    console.log ("...warning failed signature check- probably an unsupported probe. probe of an enum - ignoring", args)
+    slogger.warn ("...warning failed signature check- probably an unsupported probe. probe of an enum - ignoring", args)
     passedTypes=[]
   }
   const matchThrow = (mess = method) => {
@@ -171,7 +171,7 @@ export const advClassMaker = (props) => {
   capped.map((f, i) => {
 
     if (done.has(f)) {
-      console.log('....WARNING duplicate property  in advClassMaker', f)
+      slogger.warn('....WARNING duplicate property  in advClassMaker', f)
     }
     done.add(f)
     ob['get' + f] = () => ob[props[i]]

package/src/support/proxies.js

@@ -74,7 +74,7 @@ const registerProxy = (name, getApp) => {
   serviceRegistry.add(name);
   const value = new Proxy({}, getAppHandler(getApp, name))
   // add it to the global space to mimic what apps script does
-  // console.log (`setting ${name} to global`)
+
   Object.defineProperty(globalThis, name, {
     value,
     enumerable: true,
@@ -103,7 +103,7 @@ const validateProperties = () => {
       if (
         // skip any inserted symbos
         typeof prop !== 'symbol' &&
-        // sometimes typeof & console.log looks for ths
+        // sometimes typeof & c.log looks for ths
         prop !== 'inspect' &&
         // this is a mysterious property that APPS script sometimes checks for
         prop !== '__GS_INTERNAL_isProxy' &&

package/src/support/slogger.js

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview a logger that can be silenced by an env variable
+ * used for all internal gas-fakes logging
+ */
+
+const q = process.env.QUIET || false
+export const isQuiet =  q.toString().toLowerCase()=== "true";
+
+export const slogger = {
+  log: isQuiet ? () => {} : console.log,
+  error: console.error,
+  warn: console.warn,
+  info: isQuiet ? () => {} : console.info
+};

package/src/support/utils.js

@@ -2,7 +2,7 @@
 
 import is from '@sindresorhus/is';
 import { assert } from '@sindresorhus/is'
-
+import {slogger} from './slogger.js'
 
 const isNU = (item) => is.null(item) || is.undefined(item)
 
@@ -14,7 +14,7 @@ const fromJson = (text, failOnError = false) => {
   try {
     return JSON.parse(text)
   } catch (err) {
-    console.log(text)
+    slogger.warn(text)
     if (failOnError) {
       throw err
     }
@@ -425,7 +425,7 @@ function stabilizeKeyOrder(obj) {
 const lobify = (ob, mess = '') => {
   let lob = ob
   if (is.object(lob)) lob = stringCircular(lob)
-  console.log(mess, lob)
+  slogger.log(mess, lob)
   return ob
 }
 export const Utils = {

package/src/support/workersync/synchronizer.js

@@ -2,6 +2,7 @@ import { Worker } from 'worker_threads';
 import { fileURLToPath } from 'url';
 import path from 'path';
 import fs from 'node:fs';
+import { slogger} from '../slogger.js'
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -92,7 +93,7 @@ worker.unref();
  * whether normally or via signals like Ctrl+C.
  */
 function cleanup() {
-  console.log('...terminating worker thread');
+  slogger.log('...terminating worker thread');
   worker.terminate();
 }
 

package/src/support/workersync/synclogger.js

@@ -1,13 +1,16 @@
 import fs from 'node:fs';
-
+import { isQuiet } from '../slogger.js';
 export const syncLog = (message) => {
-  fs.writeSync(1, `[Worker] ${message}\n`);
+  if (!isQuiet) fs.writeSync(1, `[Worker] ${message}\n`);
 };
 
 export const syncWarn = (message) => {
   fs.writeSync(1, `[Worker Warn] ${message}\n`);
 };
 
+export const syncInfo = (message) => {
+  if (!isQuiet) fs.writeSync(1, `[Worker Info] ${message}\n`);
+};
 export const syncError = (message, error) => {
   // Providing the error object is optional
   const errorMessage = error ? `: ${error?.stack || error}` : '';