@mcpher/gas-fakes 2.3.15 → 2.3.16

package/gf_agent/SKILL.md

@@ -344,6 +344,7 @@ ScriptApp.__behavior.sandboxService.GmailApp.cleanup = false;
 ## Best Practices for `gf_agent`
 - **Session Isolation**: When a user provides a list of files or emails, always initialize the sandbox with those specific whitelists at the top of the script.
 - **Explicit Whitelisting**: Use `behavior.addIdWhitelist` for file access. DO NOT assume `sandboxService.SpreadsheetApp` has an `addFileWhitelist` method (it is handled globally by the behavior ID whitelist).
+- **Cross-Platform Portability**: The `ScriptApp.__behavior` object is a `gas-fakes` exclusive feature. If the generated script is intended to be copied and run in Live Apps Script later, you MUST wrap all sandbox-related boilerplate in an `if (ScriptApp.isFake)` block to prevent `TypeError` crashes in the cloud.
 - **Safe Execution**: In the Orchestrator Phase, identify if the task requires external access and include the necessary sandbox boilerplate in the generated script.
 
 

package/gf_agent/index.md

@@ -2,6 +2,8 @@
 
 This index lists all Google Apps Script services and classes supported by `gf_agent` via `gas-fakes`.
 
+- [Gmail](skills/gmail.md)
+- [Spreadsheet](skills/spreadsheet.md)
 - [base](skills/base.md)
 - [cache](skills/cache.md)
 - [calendar](skills/calendar.md)
@@ -9,13 +11,11 @@ This index lists all Google Apps Script services and classes supported by `gf_ag
 - [document](skills/document.md)
 - [drive](skills/drive.md)
 - [forms](skills/forms.md)
-- [gmail](skills/gmail.md)
 - [jdbc](skills/jdbc.md)
 - [lock](skills/lock.md)
 - [properties](skills/properties.md)
 - [script](skills/script.md)
 - [slides](skills/slides.md)
-- [spreadsheet](skills/spreadsheet.md)
 - [urlfetch](skills/urlfetch.md)
 - [utilities](skills/utilities.md)
 - [xml](skills/xml.md)

package/gf_agent/knowledge/10-sandbox-security.md

@@ -58,4 +58,5 @@ ScriptApp.__behavior.sandboxService.GmailApp.cleanup = false;
 ## Best Practices for `gf_agent`
 - **Session Isolation**: When a user provides a list of files or emails, always initialize the sandbox with those specific whitelists at the top of the script.
 - **Explicit Whitelisting**: Use `behavior.addIdWhitelist` for file access. DO NOT assume `sandboxService.SpreadsheetApp` has an `addFileWhitelist` method (it is handled globally by the behavior ID whitelist).
+- **Cross-Platform Portability**: The `ScriptApp.__behavior` object is a `gas-fakes` exclusive feature. If the generated script is intended to be copied and run in Live Apps Script later, you MUST wrap all sandbox-related boilerplate in an `if (ScriptApp.isFake)` block to prevent `TypeError` crashes in the cloud.
 - **Safe Execution**: In the Orchestrator Phase, identify if the task requires external access and include the necessary sandbox boilerplate in the generated script.

package/gf_agent/skills/document.md

@@ -18,6 +18,8 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getMarginBottom()`
 - `getMarginLeft()`
 - `getMarginRight()`
@@ -25,7 +27,9 @@ Supported Methods:
 - `getNumChildren()`
 - `getPageHeight()`
 - `getPageWidth()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getText()`
 - `getType()`
 - `insertImage(Integer,BlobSource)`
@@ -101,8 +105,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getFootnoteContents()`
@@ -115,6 +123,7 @@ Supported Methods:
 - `getChild(Integer)`
 - `getChildIndex(Element)`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
 - `getText()`
 - `getType()`
@@ -122,8 +131,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getParent()`
@@ -402,8 +415,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getFootnoteContents()`
@@ -416,6 +433,7 @@ Supported Methods:
 - `getChild(Integer)`
 - `getChildIndex(Element)`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
 - `getText()`
 - `getType()`
@@ -423,8 +441,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getParent()`
@@ -700,8 +722,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getFootnoteContents()`
@@ -714,6 +740,7 @@ Supported Methods:
 - `getChild(Integer)`
 - `getChildIndex(Element)`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
 - `getText()`
 - `getType()`
@@ -721,8 +748,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getParent()`
@@ -986,8 +1017,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getFootnoteContents()`
@@ -1000,6 +1035,7 @@ Supported Methods:
 - `getChild(Integer)`
 - `getChildIndex(Element)`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
 - `getText()`
 - `getType()`
@@ -1007,8 +1043,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getParent()`
@@ -1272,8 +1312,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getFootnoteContents()`
@@ -1286,6 +1330,7 @@ Supported Methods:
 - `getChild(Integer)`
 - `getChildIndex(Element)`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
 - `getText()`
 - `getType()`
@@ -1293,8 +1338,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getParent()`
@@ -1532,8 +1581,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getFootnoteContents()`
@@ -1546,6 +1599,7 @@ Supported Methods:
 - `getChild(Integer)`
 - `getChildIndex(Element)`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
 - `getText()`
 - `getType()`
@@ -1553,8 +1607,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getParent()`
@@ -1787,8 +1845,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getFootnoteContents()`
@@ -1801,6 +1863,7 @@ Supported Methods:
 - `getChild(Integer)`
 - `getChildIndex(Element)`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
 - `getText()`
 - `getType()`
@@ -1808,8 +1871,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getParent()`
@@ -2039,8 +2106,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getFootnoteContents()`
@@ -2053,6 +2124,7 @@ Supported Methods:
 - `getChild(Integer)`
 - `getChildIndex(Element)`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
 - `getText()`
 - `getType()`
@@ -2060,8 +2132,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getParent()`
@@ -2291,8 +2367,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getFootnoteContents()`
@@ -2305,6 +2385,7 @@ Supported Methods:
 - `getChild(Integer)`
 - `getChildIndex(Element)`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
 - `getText()`
 - `getType()`
@@ -2312,8 +2393,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getParent()`
@@ -2543,8 +2628,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getFootnoteContents()`
@@ -2557,6 +2646,7 @@ Supported Methods:
 - `getChild(Integer)`
 - `getChildIndex(Element)`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
 - `getText()`
 - `getType()`
@@ -2564,8 +2654,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getParent()`
@@ -2795,8 +2889,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getFootnoteContents()`
@@ -2809,6 +2907,7 @@ Supported Methods:
 - `getChild(Integer)`
 - `getChildIndex(Element)`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
 - `getText()`
 - `getType()`
@@ -2816,8 +2915,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getParent()`
@@ -3047,8 +3150,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getFootnoteContents()`
@@ -3061,6 +3168,7 @@ Supported Methods:
 - `getChild(Integer)`
 - `getChildIndex(Element)`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
 - `getText()`
 - `getType()`
@@ -3068,8 +3176,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getParent()`
@@ -3307,6 +3419,7 @@ Supported Methods:
 - `getChild(Integer)`
 - `getChildIndex(Element)`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
 - `getText()`
 - `getType()`
@@ -3314,8 +3427,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getParent()`
@@ -3549,6 +3666,7 @@ Supported Methods:
 - `getChild(Integer)`
 - `getChildIndex(Element)`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
 - `getText()`
 - `getType()`
@@ -3556,8 +3674,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getParent()`
@@ -3787,8 +3909,12 @@ Supported Methods:
 - `copy()`
 - `getChild(Integer)`
 - `getChildIndex(Element)`
+- `getImages()`
+- `getListItems()`
 - `getNumChildren()`
+- `getParagraphs()`
 - `getParent()`
+- `getTables()`
 - `getType()`
 - `copy()`
 - `getParent()`

package/gf_agent/skills/gmail.md

@@ -1,4 +1,4 @@
-# Service: gmail
+# Service: Gmail
 
 ## Class: GmailApp
 

package/gf_agent/skills/spreadsheet.md

@@ -1,4 +1,4 @@
-# Service: spreadsheet
+# Service: Spreadsheet
 
 ## Class: Banding
 

package/package.json

@@ -40,7 +40,7 @@
   },
   "name": "@mcpher/gas-fakes",
   "author": "bruce mcpherson",
-  "version": "2.3.15",
+  "version": "2.3.16",
   "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/documentapp/fakecontainerelement.js

@@ -95,6 +95,94 @@ export class FakeContainerElement extends FakeElement {
     return this.appendFootnote(text);
   }
 
+  /**
+   * Retrieves all the InlineImages contained in the section.
+   * @returns {GoogleAppsScript.Document.InlineImage[]} The section images.
+   */
+  getImages() {
+    ScriptApp.__behavior.checkMethod(this.toString(), 'getImages');
+    const elements = [];
+    const numChildren = this.getNumChildren();
+    for (let i = 0; i < numChildren; i++) {
+      const child = this.getChild(i);
+      const type = child.getType().toString();
+      if (type === 'INLINE_IMAGE') {
+        elements.push(child);
+      } else if (child.getNumChildren) {
+        // Recurse into containers
+        elements.push(...child.getImages());
+      } else if (type === 'PARAGRAPH') {
+        // Paragraphs can contain inline images
+        const numParaChildren = child.getNumChildren();
+        for (let j = 0; j < numParaChildren; j++) {
+           const pChild = child.getChild(j);
+           if (pChild.getType().toString() === 'INLINE_IMAGE') {
+             elements.push(pChild);
+           }
+        }
+      }
+    }
+    return elements;
+  }
+
+  /**
+   * Retrieves all the ListItems contained in the section.
+   * @returns {GoogleAppsScript.Document.ListItem[]} The section list items.
+   */
+  getListItems() {
+    ScriptApp.__behavior.checkMethod(this.toString(), 'getListItems');
+    const elements = [];
+    const numChildren = this.getNumChildren();
+    for (let i = 0; i < numChildren; i++) {
+      const child = this.getChild(i);
+      if (child.getType().toString() === 'LIST_ITEM') {
+        elements.push(child);
+      } else if (child.getNumChildren) {
+        elements.push(...child.getListItems());
+      }
+    }
+    return elements;
+  }
+
+  /**
+   * Retrieves all the Paragraphs contained in the section (including ListItems).
+   * @returns {GoogleAppsScript.Document.Paragraph[]} The section paragraphs.
+   */
+  getParagraphs() {
+    ScriptApp.__behavior.checkMethod(this.toString(), 'getParagraphs');
+    const elements = [];
+    const numChildren = this.getNumChildren();
+    for (let i = 0; i < numChildren; i++) {
+      const child = this.getChild(i);
+      const type = child.getType().toString();
+      if (type === 'PARAGRAPH' || type === 'LIST_ITEM') {
+        elements.push(child);
+      } else if (child.getNumChildren) {
+        elements.push(...child.getParagraphs());
+      }
+    }
+    return elements;
+  }
+
+  /**
+   * Retrieves all the Tables contained in the section.
+   * @returns {GoogleAppsScript.Document.Table[]} The section tables.
+   */
+  getTables() {
+    ScriptApp.__behavior.checkMethod(this.toString(), 'getTables');
+    const elements = [];
+    const numChildren = this.getNumChildren();
+    for (let i = 0; i < numChildren; i++) {
+      const child = this.getChild(i);
+      if (child.getType().toString() === 'TABLE') {
+        elements.push(child);
+      } else if (child.getNumChildren) {
+        elements.push(...child.getTables());
+      }
+    }
+    return elements;
+  }
+
   /**
    * Retrieves the child element at the specified index.
    * @param {number} childIndex The zero-based index of the child element to retrieve.

package/src/services/slidesapp/fakecolorscheme.js

@@ -81,9 +81,9 @@ export class FakeColorScheme {
    * @param {FakeColor} color
    * @returns {FakeColorScheme} self
    */
-  setConcreteColor(themeColorType, color) {
+  setConcreteColor(themeColorType, ...colorArgs) {
     const { nargs, matchThrow } = signatureArgs(arguments, "ColorScheme.setConcreteColor");
-    if (nargs !== 2) matchThrow();
+    if (nargs < 2 || nargs > 4) matchThrow();
 
     const master = this.__masterPage;
     if (!master) throw new Error('Could not find master page for color scheme');
@@ -96,15 +96,34 @@ export class FakeColorScheme {
     const currentResource = this.__resource;
     const colors = [...(currentResource.colors || [])];
 
-    // Convert the new Color to API format
     const apiColor = {};
-    if (color.getColorType().toString() === 'RGB') {
-      const rgb = color.asRgbColor();
-      apiColor.red = rgb.getRed() / 255;
-      apiColor.green = rgb.getGreen() / 255;
-      apiColor.blue = rgb.getBlue() / 255;
-    } else if (color.getColorType().toString() === 'THEME') {
-      apiColor.themeColor = color.asThemeColor().getThemeColorType().toString();
+    if (colorArgs.length === 3) {
+      // (ThemeColorType, r, g, b)
+      apiColor.red = colorArgs[0] / 255;
+      apiColor.green = colorArgs[1] / 255;
+      apiColor.blue = colorArgs[2] / 255;
+    } else if (typeof colorArgs[0] === 'string') {
+      // (ThemeColorType, hexString)
+      const hex = colorArgs[0];
+      const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
+      if (result) {
+        apiColor.red = parseInt(result[1], 16) / 255;
+        apiColor.green = parseInt(result[2], 16) / 255;
+        apiColor.blue = parseInt(result[3], 16) / 255;
+      } else {
+        throw new Error("Invalid hex color string");
+      }
+    } else {
+      // (ThemeColorType, Color)
+      const color = colorArgs[0];
+      if (color.getColorType().toString() === 'RGB') {
+        const rgb = color.asRgbColor();
+        apiColor.red = rgb.getRed() / 255;
+        apiColor.green = rgb.getGreen() / 255;
+        apiColor.blue = rgb.getBlue() / 255;
+      } else if (color.getColorType().toString() === 'THEME') {
+        apiColor.themeColor = color.asThemeColor().getThemeColorType().toString();
+      }
     }
 
     // Find and update or add the color pair

package/src/services/slidesapp/fakepresentation.js

@@ -52,14 +52,6 @@ export class FakePresentation {
     return `https://docs.google.com/presentation/d/${this.getId()}/edit`;
   }
 
-  /**
-   * Gets the color scheme of the presentation.
-   * @returns {FakeColorScheme} The color scheme.
-   */
-  getColorScheme() {
-    return newFakeColorScheme(this);
-  }
-
   /**
    * Gets the masters in the presentation.
    * @returns {FakeMaster[]} The masters.

package/src/services/spreadsheetapp/fakespreadsheetapp.js

@@ -91,7 +91,6 @@ export class FakeSpreadsheetApp {
       "setActiveRange",
       "setActiveRangeList",
       "getUi",
-      "open",
 
       "ChartAggregationType",
       "ChartTransformationType",
@@ -106,6 +105,21 @@ export class FakeSpreadsheetApp {
   toString() {
     return "SpreadsheetApp";
   }
+
+  /**
+   * Opens the spreadsheet that corresponds to the given File object.
+   * @param {File} file A Drive file object representing a spreadsheet.
+   * @returns {FakeSpreadsheet} the spreadsheet
+   */
+  open(file) {
+    const { nargs, matchThrow } = signatureArgs(arguments, "SpreadsheetApp.open");
+    if (nargs !== 1) matchThrow();
+    if (!file || typeof file.getId !== 'function') {
+      throw new Error('Invalid file object');
+    }
+    return this.openById(file.getId());
+  }
+
   getActiveSpreadsheet() {
     if (this.__activeSpreadsheet) return this.__activeSpreadsheet;
     // because this is a faked container bound app, we need to get the documentId from the config file

package/src/support/sxjdbc.js

@@ -50,11 +50,24 @@ export const sxJdbcConnect = async (Auth, { url, user, password }) => {
       ssl: disableSsl ? false : { rejectUnauthorized: false }
     };
 
-    if (user !== null && typeof user !== 'undefined' && password !== null && typeof password !== 'undefined') {
+    let finalUser = user;
+    let finalPassword = password;
+
+    if ((user === null || typeof user === 'undefined') && (password === null || typeof password === 'undefined')) {
+      try {
+        const parsedUrl = new URL(pgConnectionString);
+        if (parsedUrl.username) finalUser = decodeURIComponent(parsedUrl.username);
+        if (parsedUrl.password) finalPassword = decodeURIComponent(parsedUrl.password);
+      } catch (e) {
+        // ignore parsing errors
+      }
+    }
+
+    if (finalUser !== null && typeof finalUser !== 'undefined' && finalPassword !== null && typeof finalPassword !== 'undefined') {
       client = new pg.Client({
         ...clientConfig,
-        user: String(user),
-        password: String(password)
+        user: String(finalUser),
+        password: String(finalPassword)
       });
     } else {
       client = new pg.Client(clientConfig);

package/src/support/utils.js

@@ -363,11 +363,11 @@ const normalizeColorStringToHex = (color) => {
   if (!is.string(color)) return null;
   const lowerColor = color.toLowerCase().replace(/\s/g, '');
   if (colorNameToHex[lowerColor]) {
-    return colorNameToHex[lowerColor];
+    return colorNameToHex[lowerColor].toUpperCase();
   }
   // Check if it's a valid hex string
   if (/^#[0-9a-f]{6}$/i.test(lowerColor)) {
-    return lowerColor;
+    return lowerColor.toUpperCase();
   }
   return null; // Invalid color string
 };