@mcpher/gas-fakes 2.5.2 → 2.5.4

package/README.md

@@ -16,7 +16,7 @@ npm i @mcpher/gas-fakes
 
 For a complete guide on how to set up your local environment for authentication and development, please see the consolidated guide: [Getting Started with `gas-fakes`](GETTING_STARTED.md)
 
-Collaborators should fork the repo and use the local versions of these files - see collaborators info.
+Collaborators should fork the repo and use the local versions of these files - see [collaborators info](./notes/contributing.md)
 
 ### Use exactly the same code as in Apps Script
 ## Usage
@@ -159,25 +159,39 @@ As I mentioned earlier, to take this further, I'm going to need a lot of help to
 
 ## <img src="../pngs/logo.png" alt="gas-fakes logo" width="50" align="top"> Further Reading
 
+
+
 ## Watch the gas-fakes intro video
 
 [![Watch the intro video](./pngs/introvideo.png)](https://youtu.be/oEjpIrkYpEM)
 
+## Watch the explainer about delegating work to local LLMs to save token costs
+
+[![Use local LLMs to save tokens](./pngs/hybrid_LLM_Architecture_Overview.png)](https://youtu.be/tcvU2NLEaNE)
+
 ## Watch the gf_agent video on natural language automation
 
 [![Use natural language with gf_agent](./pngs/gfagent.png)](https://youtu.be/lujByoX71HU)
 
+## Watch the local webapps and addons development video
+
+[![Local Apps Script Webapp and UI Emulation with gas-fakes](./pngs/srv.jpg)](https://youtu.be/vH9wl7QloZ4)
+
 ## Read more docs
 
 - [release notes](versionnotes/)
 - [gas fakes intro video](https://youtu.be/oEjpIrkYpEM)
 - [getting started](GETTING_STARTED.md) - how to handle authentication for Workspace scopes.
 - [readme](README.md)
+- [apps script parity](notes/parity.md)
+- [omlx setup](notes/omlx-setup.md)
 - [Natural Language Automation with Gemini Skills & MCP Server](notes/gemini-skills-mcp.md) - new skills-based agent approach.
 - [Add agent skills to gf_agent](https://ramblings.mcpher.com/add-skills-gf_agent/)
 - [gf_agent documentation](../gf_agent/README.md) - instructions for the Gemini CLI automation agent and MCP server.
 - [gas fakes cli](notes/gas-fakes-cli.md)
--[local add-on and webapp development with gas-fakes](notes/local-web-development.md)
+- [local add-on and webapp development with gas-fakes](notes/local-web-development.md)
+- [Bringing the webapp home](https://ramblings.mcpher.com/local-apps-script-webapp-and-ui-emulation/)
+- [Local development example code](https://github.com/brucemcpherson/gf-serve)
 - [github actions using adc](https://github.com/brucemcpherson/gas-fakes-actions-adc)
 - [github actions using dwd and wif](https://github.com/brucemcpherson/gas-fakes-actions-dwd)
 - [ksuite as a back end](notes/ksuite_poc.md)
@@ -195,7 +209,7 @@ As I mentioned earlier, to take this further, I'm going to need a lot of help to
 - [jdbc notes](notes/jdbc-notes.md)
 - [Yes – you can run native apps script code on Azure ACA as well!](https://ramblings.mcpher.com/yes-you-can-run-native-apps-script-code-on-azure-aca-as-well/)
 - [Yes – you can run native apps script code on AWS Lambda!](https://ramblings.mcpher.com/apps-script-on-aws-lambda/)
-- [initial idea and thoughts](https://ramblings.mcpher.com/a-proof-of-concept-implementation-of-apps-script-environment-on-node/)
+- [initial idea and thoughts - how it all started](https://ramblings.mcpher.com/a-proof-of-concept-implementation-of-apps-script-environment-on-node/)
 - [Inside the volatile world of a Google Document](https://ramblings.mcpher.com/inside-the-volatile-world-of-a-google-document/)
 - [Apps Script Services on Node – using apps script libraries](https://ramblings.mcpher.com/apps-script-services-on-node-using-apps-script-libraries/)
 - [Apps Script environment on Node – more services](https://ramblings.mcpher.com/apps-script-environment-on-node-more-services/)

package/package.json

@@ -39,7 +39,7 @@
   },
   "name": "@mcpher/gas-fakes",
   "author": "bruce mcpherson",
-  "version": "2.5.2",
+  "version": "2.5.4",
   "license": "MIT",
   "main": "main.js",
   "description": "An implementation of the Google Workspace Apps Script runtime: Run native App Script Code on Node and Cloud Run",

package/src/cli/app.js

@@ -219,6 +219,7 @@ export async function main() {
     .option("-s, --source <string>", "Source directory (default: ./ )")
     .option("-e, --env <path>", "Path to a custom .env file.", "./.env")
     .option("--scriptId <string>", "Script ID for the target clasp project.")
+    .option("-q, --quiet", "Automatically accept all prompts.")
     .action(togas);
 
   program.showHelpAfterError("(add --help for additional information)");

package/src/cli/togas.js

@@ -20,6 +20,7 @@ export async function togas(options) {
   const scriptId = options.scriptId || process.env.TOGAS_SCRIPT_ID || process.env.GF_SCRIPT_ID;
   const pattern = options.pattern || process.env.TOGAS_PATTERN || "*";
   const source = options.source || "./";
+  const autoAccept = !!options.quiet;
 
   if (!target) {
     console.error("Error: TOGAS_TARGET is not set. Please run 'gas-fakes init' or provide --target.");
@@ -41,14 +42,18 @@ export async function togas(options) {
 
   const claspJsonPath = path.join(absoluteTarget, ".clasp.json");
   if (!fs.existsSync(claspJsonPath)) {
-    const response = await prompts({
-      type: "confirm",
-      name: "create",
-      message: `No .clasp.json found in ${target}. Create one?`,
-      initial: true
-    });
+    let create = autoAccept;
+    if (!create) {
+      const response = await prompts({
+        type: "confirm",
+        name: "create",
+        message: `No .clasp.json found in ${target}. Create one?`,
+        initial: true
+      });
+      create = response.create;
+    }
 
-    if (response.create) {
+    if (create) {
         if (!scriptId) {
              console.error("Error: No Script ID found. Please provide one with --scriptId or in .env.");
              process.exit(1);
@@ -157,14 +162,18 @@ export async function togas(options) {
   console.log(`Ready for clasp push in ${target}.`);
 
   // 5. Clasp push
-  const response = await prompts({
-    type: "confirm",
-    name: "push",
-    message: "Push to Apps Script using clasp now?",
-    initial: true
-  });
+  let push = autoAccept;
+  if (!push) {
+    const response = await prompts({
+      type: "confirm",
+      name: "push",
+      message: "Push to Apps Script using clasp now?",
+      initial: true
+    });
+    push = response.push;
+  }
 
-  if (response.push) {
+  if (push) {
     console.log("Running clasp push...");
     try {
       execSync("clasp push", { cwd: absoluteTarget, stdio: "inherit" });

package/src/index.js

@@ -11,6 +11,7 @@ import './services/gmailapp/app.js'
 import './services/calendarapp/app.js'
 import './services/chartsapp/app.js'
 import './services/session/app.js'
+import './services/base/app.js'
 import './services/advdrive/app.js'
 import './services/advsheets/app.js'
 import './services/advdocs/app.js'

package/src/services/advslides/fakeadvslides.js

@@ -16,15 +16,15 @@ class FakeAdvSlidesPresentations extends FakeAdvResource {
   // Override 'get' to use the caching-enabled function fxSlidesGet.
   get(presentationId, options) {
     ScriptApp.__behavior.isAccessible(presentationId, 'Slides', 'read');
-    const { response, data } = this._call('get', { presentationId, ...options }, Syncit.fxSlidesGet);
+    const { response, data } = this._call('get', { presentationId, ...options }, {}, null, Syncit.fxSlidesGet);
     gError(response, 'slides.presentations', 'get');
     return data;    
   }
 
   // Signature matches Apps Script advanced service.
   create(presentation) {
-    // The underlying API wants the resource in a 'resource' property.
-    const result = this._call('create', { resource: presentation });
+    // The underlying API wants the resource in a 'requestBody' property for Node.js.
+    const result = this._call('create', { requestBody: presentation });
     if (result.data) {
       this.slides.__addAllowed(result.data.presentationId);
     }
@@ -32,12 +32,18 @@ class FakeAdvSlidesPresentations extends FakeAdvResource {
   }
 
   // Signature matches Apps Script advanced service.
-  batchUpdate(requests, presentationId) {
+  // Robustly handle both resource object and raw requests array.
+  batchUpdate(resource, presentationId) {
     // for slides, any batch update is a write
     ScriptApp.__behavior.isAccessible(presentationId, 'Slides', 'write');
+    
+    const requestBody = Array.isArray(resource) 
+      ? { requests: resource } 
+      : resource;
+
     const result = this._call('batchUpdate', {
       presentationId,
-      resource: { requests },
+      requestBody,
     });
     gError(result.response, 'slides.presentations', 'batchUpdate');
 

package/src/services/base/app.js

@@ -0,0 +1,9 @@
+/**
+ * the idea here is to create an empty global entry for the singleton
+ * but only load it when it is actually used.
+ */
+import { lazyLoaderApp } from '../common/lazyloader.js'
+import { newFakeBase as maker } from './fakebase.js';
+
+let _app = null;
+_app = lazyLoaderApp(_app, 'Base', maker);

package/src/services/base/fakebase.js

@@ -0,0 +1,28 @@
+import { Proxies } from '../../support/proxies.js';
+import * as BaseEnums from '../enums/baseenums.js';
+import { newFakeMimeType } from '../mimetype/fakemimetype.js';
+
+/**
+ * @class FakeBase
+ * @description The Base service in Google Apps Script.
+ * @see https://developers.google.com/apps-script/reference/base
+ */
+export class FakeBase {
+  constructor() {
+    this.Button = BaseEnums.Button;
+    this.ButtonSet = BaseEnums.ButtonSet;
+    this.ColorType = BaseEnums.ColorType;
+    this.MimeType = newFakeMimeType();
+    this.Month = BaseEnums.Month;
+    this.Weekday = BaseEnums.Weekday;
+  }
+
+  toString() {
+    return 'Base';
+  }
+}
+
+/**
+ * @returns {FakeBase}
+ */
+export const newFakeBase = () => Proxies.guard(new FakeBase());

package/src/services/common/fakeadvresource.js

@@ -14,7 +14,7 @@ export class FakeAdvResource {
     this.__syncitMethod = syncitMethod; // e.g., Syncit.fxDocs or Syncit.fxSheets
   }
 
-  _call(method, params, options, subProp = null) {
+  _call(method, params, options, subProp = null, syncMethodOverride = null) {
     const pack = {
       prop: this.__serviceName,
       subProp,
@@ -22,7 +22,8 @@ export class FakeAdvResource {
       params,
       options
     };
-    const result = this.__syncitMethod(pack);
+    const syncMethod = syncMethodOverride || this.__syncitMethod;
+    const result = syncMethod(pack);
     if (!result || !result.response) {
       // Simulate an error response if the worker didn't provide one.
       return {

package/src/services/content/contentservice.js

@@ -1,9 +1,10 @@
 import { FakeTextOutput } from "./textoutput.js";
-import { ContentEnums } from "../enums/contentenums.js";
+// just avoid conflict with global MimeType
+import { MimeType as mt } from "../enums/contentenums.js";
 
 export class FakeContentService {
   constructor() {
-    this.MimeType = ContentEnums.MimeType;
+    this.MimeType = mt;
   }
 
   createTextOutput(content = "") {

package/src/services/enums/baseenums.js

@@ -0,0 +1,47 @@
+import { newFakeGasenum } from "@mcpher/fake-gasenum";
+
+export const Button = newFakeGasenum([
+  "CANCEL",
+  "CLOSE",
+  "NO",
+  "OK",
+  "YES"
+])
+
+export const ButtonSet = newFakeGasenum([
+  "OK",
+  "OK_CANCEL",
+  "YES_NO",
+  "YES_NO_CANCEL"
+])
+
+export const ColorType = newFakeGasenum([
+  "RGB",
+  "THEME",
+  "UNSUPPORTED"
+])
+
+export const Month = newFakeGasenum([
+  "JANUARY",
+  "FEBRUARY",
+  "MARCH",
+  "APRIL",
+  "MAY",
+  "JUNE",
+  "JULY",
+  "AUGUST",
+  "SEPTEMBER",
+  "OCTOBER",
+  "NOVEMBER",
+  "DECEMBER"
+])
+
+export const Weekday = newFakeGasenum([
+  "SUNDAY",
+  "MONDAY",
+  "TUESDAY",
+  "WEDNESDAY",
+  "THURSDAY",
+  "FRIDAY",
+  "SATURDAY"
+])

package/src/services/enums/contentenums.js

@@ -1,7 +1,6 @@
 import { newFakeGasenum } from "@mcpher/fake-gasenum";
 
-export const ContentEnums = {
-  MimeType: newFakeGasenum([
+export const  MimeType = newFakeGasenum([
     "ATOM",
     "CSV",
     "ICAL",
@@ -12,4 +11,3 @@ export const ContentEnums = {
     "VCARD",
     "XML"
   ])
-}

package/src/services/enums/scriptenums.js

@@ -1,6 +1,33 @@
-export const ScriptEnums = {
-  AuthorizationStatus: {
+import { newFakeGasenum } from "@mcpher/fake-gasenum";
+
+export const AuthorizationStatus = newFakeGasenum({
     REQUIRED: 'REQUIRED',
     NOT_REQUIRED: 'NOT_REQUIRED'
-  }
-};
+  })
+export const TriggerSource  = newFakeGasenum( {
+    CALENDAR: 'CALENDAR',
+    CLOCK: 'CLOCK',
+    DOCUMENTS: 'DOCUMENTS',
+    FORMS: 'FORMS', 
+    SPREADSHEETS: 'SPREADSHEETS'
+  })
+export const AuthMode = newFakeGasenum( {
+  NONE: 'NONE',
+  CUSTOM_FUNCTION: 'CUSTOM_FUNCTION',
+  LIMITED: 'LIMITED',
+  FULL: 'FULL'
+})
+export const EventType = newFakeGasenum( {  
+  CLOCK: 'CLOCK',
+  ON_OPEN: 'ON_OPEN',
+  ON_EDIT: 'ON_EDIT',
+  ON_FORM_SUBMIT: 'ON_FORM_SUBMIT',
+  ON_CHANGE: 'ON_CHANGE',
+  ON_EVENT_UPDATED: 'ON_EVENT_UPDATED'
+})
+export const InstallationSource = newFakeGasenum({
+  APPS_MARKETPLACE_DOMAIN_ADD_ON: 'APPS_MARKETPLACE_DOMAIN_ADD_ON',
+  NONE: 'NONE',
+  WEB_STORE_ADD_ON: 'WEB_STORE_ADD_ON'
+})
+

package/src/services/enums/slidesenums.js

@@ -142,7 +142,9 @@ export const PageType = newFakeGasenum([
   "UNSUPPORTED",
   "SLIDE",
   "LAYOUT",
-  "MASTER"
+  "MASTER",
+  "NOTES_MASTER",
+  "NOTES_PAGE"
 ])
 export const ParagraphAlignment = newFakeGasenum([
   "UNSUPPORTED",

package/src/services/enums/xmlenums.js

@@ -0,0 +1,14 @@
+import { newFakeGasenum } from "@mcpher/fake-gasenum";
+
+/**
+ * Enum representing the possible content types found in XML.
+ */
+export const ContentTypes = newFakeGasenum([
+  "CDATA",
+  "COMMENT",
+  "DOCTYPE",
+  "ELEMENT",
+  "ENTITYREF",
+  "PROCESSINGINSTRUCTION",
+  "TEXT"
+]);

package/src/services/html/serverworker.js

@@ -60,7 +60,7 @@ export class ServerWorkerContext {
         mainScriptPath: globalThis.__gasFakesMainScriptPath || this._mainScriptPath,
         controlBuf: this._controlBuf,
         dataBuf: this._dataBuf,
-        env: process.env // Pass current environment
+        env: { ...process.env, GAS_FAKES_WORKER: 'true' } // Pass current environment and mark as worker
       },
       stdout: true,
       stderr: true

package/src/services/scriptapp/app.js

@@ -7,7 +7,13 @@ import { Auth } from '../../support/auth.js'
 import { Proxies } from '../../support/proxies.js'
 import { newFakeBehavior } from './behavior.js'
 import { newFakeAuthorizationInfo } from './fakeauthorizationinfo.js'
-import { ScriptEnums } from '../enums/scriptenums.js'
+import {
+  AuthMode,
+  AuthorizationStatus,
+  TriggerSource,
+  EventType,
+  InstallationSource
+} from '../enums/scriptenums.js'
 import { newCacheDropin } from '@mcpher/gas-flex-cache'
 import { slogger } from "../../support/slogger.js";
 import fs from 'fs';
@@ -48,8 +54,8 @@ const getSourceOAuthToken = () => {
 
 
 const limitMode = (mode) => {
-  if (mode !== ScriptApp.AuthMode.FULL) {
-    throw new Error(`only ${ScriptApp.AuthMode.FULL} is supported as mode for now`)
+  if (mode !== ScriptApp.AuthMode.FULL.toString()) {
+    throw new Error(`only ${ScriptApp.AuthMode.FULL.toString()} is supported as mode for now`)
   }
 
   return mode
@@ -234,10 +240,11 @@ if (typeof globalThis[name] === typeof undefined) {
           ensureInit()
           return Auth.getActiveUser()?.id
         },
-        AuthMode: {
-          FULL: 'FULL'
-        },
-        AuthorizationStatus: ScriptEnums.AuthorizationStatus,
+        AuthMode,
+        AuthorizationStatus,
+        TriggerSource,
+        EventType,
+        InstallationSource,
         getAuthorizationInfo: (authMode) => {
           ensureInit();
           return newFakeAuthorizationInfo(authMode);

package/src/services/scriptapp/fakeauthorizationinfo.js

@@ -1,4 +1,4 @@
-import { ScriptEnums } from '../enums/scriptenums.js';
+import { AuthorizationStatus } from '../enums/scriptenums.js';
 
 export class FakeAuthorizationInfo {
   constructor(authMode) {
@@ -8,12 +8,12 @@ export class FakeAuthorizationInfo {
   getAuthorizationStatus() {
     // gas-fakes always handles auth out-of-band via CLI, 
     // so during script execution, we assume auth is not required.
-    return ScriptEnums.AuthorizationStatus.NOT_REQUIRED;
+    return AuthorizationStatus.NOT_REQUIRED;
   }
 
   getAuthorizationUrl() {
-    // Return null since we don't require inline authorization
-    return null;
+    // Return empty string since we don't require inline authorization, matching live Apps Script parity
+    return "";
   }
 }
 

package/src/services/slidesapp/app.js

@@ -5,5 +5,10 @@
 
 import { lazyLoaderApp } from '../common/lazyloader.js'
 import { newFakeSlidesApp as maker} from './fakeslidesapp.js';
+import './pageelementfactory.js';
+export { newFakePageElementRange } from './fakepageelementrange.js';
+export { newFakePageRange } from './fakepagerange.js';
+export { newFakeTableCellRange } from './faketablecellrange.js';
+export { newFakeTableColumn } from './faketablecolumn.js';
 let _app = null;
 _app = lazyLoaderApp(_app, 'SlidesApp', maker)

package/src/services/slidesapp/fakeautofit.js

@@ -39,7 +39,7 @@ export class FakeAutofit {
       }
     }];
 
-    Slides.Presentations.batchUpdate(requests, presentationId);
+    Slides.Presentations.batchUpdate({ requests }, presentationId);
     return this;
   }
 

package/src/services/slidesapp/fakeborder.js

@@ -0,0 +1,106 @@
+import { Proxies } from '../../support/proxies.js';
+import { newFakeLineFill } from './fakelinefill.js';
+
+/**
+ * Represents the Border properties of a Slides element.
+ * Emulates the Slides API resource structure.
+ */
+export const newFakeBorder = (...args) => {
+  return Proxies.guard(new FakeBorder(...args));
+};
+
+export class FakeBorder {
+  /**
+   * @param {FakePageElement} parent - The element this border belongs to.
+   */
+  constructor(parent) {
+    this._parent = parent;
+  }
+
+  get __resource() {
+    // Border properties are typically in imageProperties.outline or shapeProperties.outline
+    const res = this._parent.__resource;
+    return res.image?.imageProperties?.outline || res.shape?.shapeProperties?.outline;
+  }
+
+  getLineFill() {
+    return newFakeLineFill(this._parent);
+  }
+
+  isVisible() {
+    const weight = this.getWeight();
+    return weight !== null && weight > 0;
+  }
+
+  setDashStyle(style) {
+    this.__update({ dashStyle: style.toString() }, 'dashStyle');
+    return this;
+  }
+
+  setTransparent() {
+    this.__update({ propertyState: 'NOT_RENDERED' }, 'propertyState');
+    return this;
+  }
+
+  setWeight(weight) {
+    this.__update({ weight: { magnitude: weight, unit: 'PT' }, propertyState: 'RENDERED' }, 'weight,propertyState');
+    return this;
+  }
+
+  __update(props, fields) {
+    const presentationId = this._parent.__presentation?.getId() || this._parent.__page?.__presentation?.getId();
+    const type = this._parent.getPageElementType().toString();
+    const objectId = this._parent.getObjectId();
+
+    let request = null;
+    if (type === 'SHAPE') {
+      request = {
+        updateShapeProperties: {
+          objectId,
+          shapeProperties: { outline: props },
+          fields: fields ? fields.split(',').map(f => `outline.${f}`).join(',') : 'outline'
+        }
+      };
+    } else if (type === 'IMAGE') {
+        request = {
+            updateImageProperties: {
+              objectId,
+              imageProperties: { outline: props },
+              fields: fields ? fields.split(',').map(f => `outline.${f}`).join(',') : 'outline'
+            }
+          };
+    }
+
+    if (request) {
+      Slides.Presentations.batchUpdate({ requests: [request] }, presentationId);
+    }
+  }
+
+  /**
+   * Retrieves the weight of the border in Points (PT).
+   * @returns {number | null} The border weight in PT, or null if not defined/rendered.
+   */
+  getWeight() {
+    const outline = this.__resource;
+    if (!outline || outline.propertyState === 'NOT_RENDERED' || outline.weight === undefined) {
+      return null;
+    }
+    return this._parent.__normalize(outline.weight);
+  }
+
+  /**
+   * Gets the DashStyle of the border.
+   * @returns {string} The dash style.
+   */
+  getDashStyle() {
+    const outline = this.__resource;
+    if (!outline || outline.propertyState === 'NOT_RENDERED' || !outline.dashStyle) {
+      return 'SOLID';
+    }
+    return outline.dashStyle;
+  }
+
+  toString() {
+    return 'Border';
+  }
+}

package/src/services/slidesapp/fakecolorscheme.js

@@ -150,7 +150,7 @@ export class FakeColorScheme {
       }
     }];
 
-    Slides.Presentations.batchUpdate(requests, presentationId);
+    Slides.Presentations.batchUpdate({ requests }, presentationId);
     return this;
   }