@mcpher/gas-fakes 2.5.3 → 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,10 +159,16 @@ 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)
@@ -178,6 +184,7 @@ As I mentioned earlier, to take this further, I'm going to need a lot of help to
 - [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.
@@ -202,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.3",
+  "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/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/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/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/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/spreadsheetapp/fakeembeddedchartbuilder.js

@@ -292,7 +292,34 @@ export class FakeEmbeddedChartBuilder {
     return axis;
   }
 
-  reverseCategories() { notYetImplemented('reverseCategories'); return this; }
+  __extractTextStyle(textStyle) {
+    if (!textStyle || !textStyle.getFontFamily) return textStyle; // fallback if it's not a FakeTextStyle
+    const format = {};
+    if (textStyle.getFontFamily() !== undefined) format.fontFamily = textStyle.getFontFamily();
+    if (textStyle.getFontSize() !== undefined) format.fontSize = textStyle.getFontSize();
+    if (textStyle.isBold() !== undefined) format.bold = textStyle.isBold();
+    if (textStyle.isItalic() !== undefined) format.italic = textStyle.isItalic();
+    if (textStyle.isStrikethrough() !== undefined) format.strikethrough = textStyle.isStrikethrough();
+    if (textStyle.isUnderline() !== undefined) format.underline = textStyle.isUnderline();
+    const color = textStyle.getForegroundColorObject && textStyle.getForegroundColorObject();
+    if (color && color.asRgbColor) {
+      const rgb = color.asRgbColor();
+      format.foregroundColorStyle = {
+        rgbColor: { red: rgb.getRed() / 255, green: rgb.getGreen() / 255, blue: rgb.getBlue() / 255 }
+      };
+    }
+    return format;
+  }
+
+  reverseCategories() { 
+    ScriptApp.__behavior.checkMethod("EmbeddedChartBuilder", "reverseCategories");
+    const chartType = this.__apiChart.spec.basicChart ? this.__apiChart.spec.basicChart.chartType : null;
+    const axisPos = chartType === "BAR" ? "LEFT_AXIS" : "BOTTOM_AXIS";
+    const axis = this.__getAxis(axisPos);
+    axis.reverseDirection = true;
+    return this; 
+  }
+
   setBackgroundColor(color) { return this.setOption("backgroundColor", color); }
   
   setColors(colors) { 
@@ -306,8 +333,17 @@ export class FakeEmbeddedChartBuilder {
     return this; 
   }
   
-  setLegendTextStyle(textStyle) { notYetImplemented('setLegendTextStyle'); return this; }
-  setPointStyle(pointStyle) { notYetImplemented('setPointStyle'); return this; }
+  setLegendTextStyle(textStyle) { 
+    ScriptApp.__behavior.checkMethod("EmbeddedChartBuilder", "setLegendTextStyle");
+    if (!this.__apiChart.spec.basicChart) this.__apiChart.spec.basicChart = {};
+    this.__apiChart.spec.basicChart.legendTextStyle = this.__extractTextStyle(textStyle);
+    return this; 
+  }
+
+  setPointStyle(pointStyle) { 
+    ScriptApp.__behavior.checkMethod("EmbeddedChartBuilder", "setPointStyle");
+    return this.setOption("pointStyle", pointStyle ? pointStyle.toString() : "NONE");
+  }
   
   setRange(min, max) { 
     ScriptApp.__behavior.checkMethod("EmbeddedChartBuilder", "setRange");
@@ -332,8 +368,17 @@ export class FakeEmbeddedChartBuilder {
     return this; 
   }
   
-  setTitleTextStyle(textStyle) { notYetImplemented('setTitleTextStyle'); return this; }
-  setXAxisTextStyle(textStyle) { notYetImplemented('setXAxisTextStyle'); return this; }
+  setTitleTextStyle(textStyle) { 
+    ScriptApp.__behavior.checkMethod("EmbeddedChartBuilder", "setTitleTextStyle");
+    this.__apiChart.spec.titleTextStyle = this.__extractTextStyle(textStyle);
+    return this; 
+  }
+
+  setXAxisTextStyle(textStyle) { 
+    ScriptApp.__behavior.checkMethod("EmbeddedChartBuilder", "setXAxisTextStyle");
+    this.__getAxis("BOTTOM_AXIS").textStyle = this.__extractTextStyle(textStyle);
+    return this; 
+  }
   
   setXAxisTitle(title) { 
     ScriptApp.__behavior.checkMethod("EmbeddedChartBuilder", "setXAxisTitle");
@@ -341,8 +386,17 @@ export class FakeEmbeddedChartBuilder {
     return this; 
   }
   
-  setXAxisTitleTextStyle(textStyle) { notYetImplemented('setXAxisTitleTextStyle'); return this; }
-  setYAxisTextStyle(textStyle) { notYetImplemented('setYAxisTextStyle'); return this; }
+  setXAxisTitleTextStyle(textStyle) { 
+    ScriptApp.__behavior.checkMethod("EmbeddedChartBuilder", "setXAxisTitleTextStyle");
+    this.__getAxis("BOTTOM_AXIS").titleTextStyle = this.__extractTextStyle(textStyle);
+    return this; 
+  }
+
+  setYAxisTextStyle(textStyle) { 
+    ScriptApp.__behavior.checkMethod("EmbeddedChartBuilder", "setYAxisTextStyle");
+    this.__getAxis("LEFT_AXIS").textStyle = this.__extractTextStyle(textStyle);
+    return this; 
+  }
   
   setYAxisTitle(title) { 
     ScriptApp.__behavior.checkMethod("EmbeddedChartBuilder", "setYAxisTitle");
@@ -350,8 +404,21 @@ export class FakeEmbeddedChartBuilder {
     return this; 
   }
   
-  setYAxisTitleTextStyle(textStyle) { notYetImplemented('setYAxisTitleTextStyle'); return this; }
-  useLogScale() { notYetImplemented('useLogScale'); return this; }
+  setYAxisTitleTextStyle(textStyle) { 
+    ScriptApp.__behavior.checkMethod("EmbeddedChartBuilder", "setYAxisTitleTextStyle");
+    this.__getAxis("LEFT_AXIS").titleTextStyle = this.__extractTextStyle(textStyle);
+    return this; 
+  }
+
+  useLogScale() { 
+    ScriptApp.__behavior.checkMethod("EmbeddedChartBuilder", "useLogScale");
+    const chartType = this.__apiChart.spec.basicChart ? this.__apiChart.spec.basicChart.chartType : null;
+    const axisPos = chartType === "BAR" ? "BOTTOM_AXIS" : "LEFT_AXIS";
+    const axis = this.__getAxis(axisPos);
+    axis.logScale = true;
+    return this; 
+  }
+
   set3D() { return this.setOption("is3D", true); }
   enablePaging(enable, pageSize) { notYetImplemented('enablePaging'); return this; }
   enableRtlTable(enable) { notYetImplemented('enableRtlTable'); return this; }
@@ -361,7 +428,12 @@ export class FakeEmbeddedChartBuilder {
   setInitialSortingDescending(column) { notYetImplemented('setInitialSortingDescending'); return this; }
   showRowNumberColumn(show) { notYetImplemented('showRowNumberColumn'); return this; }
   useAlternatingRowStyle(use) { notYetImplemented('useAlternatingRowStyle'); return this; }
-  setXAxisLogScale() { notYetImplemented('setXAxisLogScale'); return this; }
+
+  setXAxisLogScale() { 
+    ScriptApp.__behavior.checkMethod("EmbeddedChartBuilder", "setXAxisLogScale");
+    this.__getAxis("BOTTOM_AXIS").logScale = true;
+    return this; 
+  }
   
   setXAxisRange(min, max) { 
     ScriptApp.__behavior.checkMethod("EmbeddedChartBuilder", "setXAxisRange");
@@ -370,7 +442,11 @@ export class FakeEmbeddedChartBuilder {
     return this; 
   }
   
-  setYAxisLogScale() { notYetImplemented('setYAxisLogScale'); return this; }
+  setYAxisLogScale() { 
+    ScriptApp.__behavior.checkMethod("EmbeddedChartBuilder", "setYAxisLogScale");
+    this.__getAxis("LEFT_AXIS").logScale = true;
+    return this; 
+  }
   
   setYAxisRange(min, max) { 
     ScriptApp.__behavior.checkMethod("EmbeddedChartBuilder", "setYAxisRange");
@@ -379,7 +455,11 @@ export class FakeEmbeddedChartBuilder {
     return this; 
   }
   
-  reverseDirection() { notYetImplemented('reverseDirection'); return this; }
+  reverseDirection() { 
+    ScriptApp.__behavior.checkMethod("EmbeddedChartBuilder", "reverseDirection");
+    this.__getAxis("BOTTOM_AXIS").reverseDirection = true;
+    return this; 
+  }
 
   toString() {
     const type = this.__apiChart.spec.basicChart?.chartType;