@mcpher/gas-fakes 2.3.10 → 2.3.13

package/src/services/slidesapp/fakecolorscheme.js

@@ -0,0 +1,160 @@
+import { Proxies } from '../../support/proxies.js';
+import { newFakeColor } from '../common/fakecolor.js';
+import { newFakeColorBuilder } from '../common/fakecolorbuilder.js';
+import { ThemeColorType } from '../enums/slidesenums.js';
+import { signatureArgs } from '../../support/helpers.js';
+
+export const newFakeColorScheme = (...args) => {
+  return Proxies.guard(new FakeColorScheme(...args));
+};
+
+/**
+ * @class FakeColorScheme
+ */
+export class FakeColorScheme {
+  constructor(parent) {
+    this.__parent = parent;
+  }
+
+  get __masterPage() {
+    const parent = this.__parent;
+    const type = parent.toString();
+
+    if (type === 'Master') return parent;
+    if (type === 'Slide' || type === 'Layout') {
+      // Find the master for this slide/layout
+      if (type === 'Slide') {
+        const layout = parent.getLayout();
+        return layout ? layout.getMaster() : null;
+      } else {
+        return parent.getMaster();
+      }
+    }
+    if (type === 'Presentation') {
+      // Use the first master of the presentation
+      const masters = parent.getMasters();
+      if (masters.length > 0) {
+        return masters[0];
+      }
+    }
+    return null;
+  }
+
+  get __resource() {
+    const master = this.__masterPage;
+    return master?.__resource?.pageProperties?.colorScheme || { colors: [] };
+  }
+
+  /**
+   * getConcreteColor(themeColorType) https://developers.google.com/apps-script/reference/slides/color-scheme#getconcretecolorthemecolortype
+   * @param {ThemeColorType} themeColorType
+   * @returns {FakeColor}
+   */
+  getConcreteColor(themeColorType) {
+    const { nargs, matchThrow } = signatureArgs(arguments, "ColorScheme.getConcreteColor");
+    if (nargs !== 1) matchThrow();
+
+    const colors = this.__resource.colors || [];
+    const typeStr = themeColorType.toString();
+    const pair = colors.find(c => c.type === typeStr);
+
+    if (pair && pair.color) {
+      return makeColorFromApiForSlides(pair.color);
+    }
+
+    return null;
+  }
+
+  /**
+   * getThemeColors() https://developers.google.com/apps-script/reference/slides/color-scheme#getthemecolors
+   * @returns {ThemeColorType[]}
+   */
+  getThemeColors() {
+    return Object.keys(ThemeColorType)
+      .filter(k => k !== 'UNSUPPORTED')
+      .map(k => ThemeColorType[k]);
+  }
+
+  /**
+   * setConcreteColor(themeColorType, color) https://developers.google.com/apps-script/reference/slides/color-scheme#setconcretecolorthemecolortype,color
+   * @param {ThemeColorType} themeColorType
+   * @param {FakeColor} color
+   * @returns {FakeColorScheme} self
+   */
+  setConcreteColor(themeColorType, color) {
+    const { nargs, matchThrow } = signatureArgs(arguments, "ColorScheme.setConcreteColor");
+    if (nargs !== 2) matchThrow();
+
+    const master = this.__masterPage;
+    if (!master) throw new Error('Could not find master page for color scheme');
+
+    const presentationId = master.__presentation.getId();
+    const typeStr = themeColorType.toString();
+
+    // The API requires ALL theme colors to be present when updating the color scheme.
+    // So we fetch the current colors, update the one we want, and send them all back.
+    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();
+    }
+
+    // Find and update or add the color pair
+    const index = colors.findIndex(c => c.type === typeStr);
+    if (index !== -1) {
+      colors[index] = { type: typeStr, color: apiColor };
+    } else {
+      colors.push({ type: typeStr, color: apiColor });
+    }
+
+    // Ensure we have exactly the right set of colors if possible?
+    // The API error said "must have 12 theme colors pairs".
+    // Usually these are the standard 12 types.
+
+    const requests = [{
+      updatePageProperties: {
+        objectId: master.getObjectId(),
+        pageProperties: {
+          colorScheme: {
+            colors: colors
+          }
+        },
+        fields: 'colorScheme'
+      }
+    }];
+
+    Slides.Presentations.batchUpdate(requests, presentationId);
+    return this;
+  }
+
+  toString() {
+    return 'ColorScheme';
+  }
+}
+
+// Helper to avoid circular dependency or reusing the spreadsheet-specific one if it differs
+const makeColorFromApiForSlides = (apiColor) => {
+  const builder = newFakeColorBuilder();
+  const rgb = apiColor.rgbColor || (apiColor.red !== undefined ? apiColor : null);
+  
+  if (rgb) {
+    const hex = '#' + [rgb.red, rgb.green, rgb.blue].map(v => {
+      const val = Math.round((v || 0) * 255);
+      const hex = val.toString(16);
+      return hex.length === 1 ? '0' + hex : hex;
+    }).join('');
+    builder.setRgbColor(hex);
+  } else if (apiColor.themeColor) {
+    const tc = apiColor.themeColor;
+    builder.setThemeColor(ThemeColorType[tc]);
+  }
+  return builder.build();
+};

package/src/services/slidesapp/fakelayout.js

@@ -1,5 +1,6 @@
 import { Proxies } from '../../support/proxies.js';
 import { newFakeMaster } from './fakemaster.js';
+import { newFakeColorScheme } from './fakecolorscheme.js';
 
 export const newFakeLayout = (...args) => {
   return Proxies.guard(new FakeLayout(...args));
@@ -21,7 +22,7 @@ export class FakeLayout {
   }
 
   getMaster() {
-    const masterId = this.__resource.masterObjectId;
+    const masterId = this.__resource.layoutProperties?.masterObjectId;
     if (!masterId) return null;
 
     const presentationResource = this.__presentation.__resource;
@@ -32,6 +33,15 @@ export class FakeLayout {
   getObjectId() {
     return this.__id;
   }
+
+  /**
+   * Gets the color scheme of the layout.
+   * @returns {FakeColorScheme} The color scheme.
+   */
+  getColorScheme() {
+    return newFakeColorScheme(this);
+  }
+
   toString() {
     return 'Layout';
   }

package/src/services/slidesapp/fakemaster.js

@@ -1,4 +1,5 @@
 import { Proxies } from '../../support/proxies.js';
+import { newFakeColorScheme } from './fakecolorscheme.js';
 
 export const newFakeMaster = (...args) => {
   return Proxies.guard(new FakeMaster(...args));
@@ -22,6 +23,15 @@ export class FakeMaster {
   getObjectId() {
     return this.__id;
   }
+
+  /**
+   * Gets the color scheme of the master.
+   * @returns {FakeColorScheme} The color scheme.
+   */
+  getColorScheme() {
+    return newFakeColorScheme(this);
+  }
+
   toString() {
     return 'Master';
   }

package/src/services/slidesapp/fakepresentation.js

@@ -1,5 +1,7 @@
 import { Proxies } from '../../support/proxies.js';
 import { newFakeSlide } from './fakeslide.js';
+import { newFakeMaster } from './fakemaster.js';
+import { newFakeColorScheme } from './fakecolorscheme.js';
 
 export const newFakePresentation = (...args) => {
   return Proxies.guard(new FakePresentation(...args));
@@ -50,6 +52,31 @@ 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.
+   */
+  getMasters() {
+    return (this.__resource.masters || []).map(m => newFakeMaster(m, this));
+  }
+
+  /**
+   * Gets a master by its ID.
+   * @param {string} id The master ID.
+   * @returns {FakeMaster | null} The master, or null if not found.
+   */
+  getMasterById(id) {
+    return this.getMasters().find(m => m.getObjectId() === id) || null;
+  }
+
   /**
    * Gets the slides in the presentation.
    * @returns {FakeSlide[]} The slides.

package/src/services/slidesapp/fakeslide.js

@@ -4,6 +4,7 @@ import { newFakeLayout } from './fakelayout.js';
 import { newFakeMaster } from './fakemaster.js';
 import { newFakePageElement } from './fakepageelement.js';
 import { newFakePageBackground } from './fakepagebackground.js';
+import { newFakeColorScheme } from './fakecolorscheme.js';
 import { asSpecificPageElement } from './pageelementfactory.js';
 
 export const newFakeSlide = (...args) => {
@@ -86,6 +87,14 @@ export class FakeSlide {
     return background ? newFakePageBackground(this) : null;
   }
 
+  /**
+   * Gets the color scheme of the slide.
+   * @returns {FakeColorScheme} The color scheme.
+   */
+  getColorScheme() {
+    return newFakeColorScheme(this);
+  }
+
   /**
    * Gets the list of tables on the slide.
    * @returns {FakeTable[]} The tables.

package/src/services/slidesapp/faketextrange.js

@@ -17,10 +17,11 @@ export class FakeTextRange {
   }
 
   get __resource() {
-    if (!this.__shape.__resource.shape.text) {
-      this.__shape.__resource.shape.text = {};
+    const shapeResource = this.__shape.__resource;
+    if (shapeResource && shapeResource.shape && shapeResource.shape.text) {
+      return shapeResource.shape.text;
     }
-    return this.__shape.__resource.shape.text;
+    return {};
   }
 
   getStartIndex() {
@@ -42,7 +43,7 @@ export class FakeTextRange {
    * @returns {string} The text.
    */
   asString() {
-    const textElements = this.__resource.textElements || [];
+    const textElements = this.__resource?.textElements || [];
     let fullText = textElements.map(te => {
       if (te.textRun) return te.textRun.content;
       if (te.autoText) return te.autoText.content || '[AutoText]'; // Use placeholder
@@ -114,12 +115,6 @@ export class FakeTextRange {
 
     if (requests.length > 0) {
       Slides.Presentations.batchUpdate(requests, presentationId);
-
-      // REST API documentation: "The field is automatically set to NONE if a request is made that might affect text fitting within its bounding text box."
-      if (!this.__resource.autoFit) {
-        this.__resource.autoFit = {};
-      }
-      this.__resource.autoFit.autofitType = AutofitType.NONE;
     }
 
     return this;
@@ -176,7 +171,7 @@ export class FakeTextRange {
    * @returns {FakeAutoText[]} The auto texts.
    */
   getAutoTexts() {
-    const textElements = this.__resource.textElements || [];
+    const textElements = this.__resource?.textElements || [];
     const autoTexts = [];
     let charIndex = 0;
     let autoTextIndex = 0;

package/src/services/spreadsheetapp/chartenummapping.js

@@ -0,0 +1,15 @@
+export const ChartEnumMapping = {
+  Position: {
+    BOTTOM: "BOTTOM_LEGEND",
+    TOP: "TOP_LEGEND",
+    LEFT: "LEFT_LEGEND",
+    RIGHT: "RIGHT_LEGEND",
+    NONE: "NO_LEGEND",
+  },
+  ChartHiddenDimensionStrategy: {
+    IGNORE_BOTH: "SKIP_HIDDEN_ROWS_AND_COLUMNS",
+    IGNORE_ROWS: "SKIP_HIDDEN_ROWS",
+    IGNORE_COLUMNS: "SKIP_HIDDEN_COLUMNS",
+    SHOW_BOTH: "SHOW_ALL",
+  }
+};

package/src/services/spreadsheetapp/fakebooleancondition.js

@@ -0,0 +1,119 @@
+import { Proxies } from '../../support/proxies.js';
+import { BooleanCriteria } from '../enums/sheetsenums.js';
+import { newFakeColor } from '../common/fakecolor.js';
+import { makeColorFromApi } from '../common/fakecolorbuilder.js';
+
+export const newFakeBooleanCondition = (...args) => {
+  return Proxies.guard(new FakeBooleanCondition(...args));
+};
+
+export class FakeBooleanCondition {
+  constructor(apiCondition, format) {
+    this.__apiCondition = apiCondition;
+    this.__format = format || {};
+  }
+
+  getBackgroundObject() {
+    if (this.__format.backgroundColorStyle) {
+      return makeColorFromApi(this.__format.backgroundColorStyle);
+    }
+    if (this.__format.backgroundColor) {
+      return makeColorFromApi({ rgbColor: this.__format.backgroundColor });
+    }
+    return null;
+  }
+
+  getBold() {
+    return this.__format.textFormat?.bold ?? null;
+  }
+
+  getCriteriaType() {
+    // The API uses slightly different strings than the GAS enum for many rules
+    const map = {
+      'BLANK': 'CELL_EMPTY',
+      'NOT_BLANK': 'CELL_NOT_EMPTY',
+      'DATE_AFTER': 'DATE_AFTER',
+      'DATE_BEFORE': 'DATE_BEFORE',
+      'DATE_EQ': 'DATE_EQUAL_TO',
+      'DATE_NOT_EQ': 'DATE_NOT_EQUAL_TO',
+      'DATE_AFTER_RELATIVE': 'DATE_AFTER_RELATIVE',
+      'DATE_BEFORE_RELATIVE': 'DATE_BEFORE_RELATIVE',
+      'DATE_EQUAL_TO_RELATIVE': 'DATE_EQUAL_TO_RELATIVE',
+      'DATE_EQ_RELATIVE': 'DATE_EQUAL_TO_RELATIVE',
+      'NUMBER_BETWEEN': 'NUMBER_BETWEEN',
+      'NUMBER_NOT_BETWEEN': 'NUMBER_NOT_BETWEEN',
+      'NUMBER_EQ': 'NUMBER_EQUAL_TO',
+      'NUMBER_NOT_EQ': 'NUMBER_NOT_EQUAL_TO',
+      'NUMBER_GREATER': 'NUMBER_GREATER_THAN',
+      'NUMBER_GREATER_THAN_EQ': 'NUMBER_GREATER_THAN_OR_EQUAL_TO',
+      'NUMBER_LESS': 'NUMBER_LESS_THAN',
+      'NUMBER_LESS_THAN_EQ': 'NUMBER_LESS_THAN_OR_EQUAL_TO',
+      'TEXT_CONTAINS': 'TEXT_CONTAINS',
+      'TEXT_NOT_CONTAINS': 'TEXT_DOES_NOT_CONTAIN',
+      'TEXT_EQ': 'TEXT_EQUAL_TO',
+      'TEXT_NOT_EQ': 'TEXT_NOT_EQUAL_TO',
+      'TEXT_STARTS_WITH': 'TEXT_STARTS_WITH',
+      'TEXT_ENDS_WITH': 'TEXT_ENDS_WITH',
+      'CUSTOM_FORMULA': 'CUSTOM_FORMULA'
+    };
+
+    // If the API value contains RELATIVE properties it should probably be resolved to the _RELATIVE equivalents 
+    // However the API 'type' doesn't usually distinguish between DATE_EQ and DATE_EQUAL_TO_RELATIVE at the root level,
+    // they are often just DATE_EQ and the value object specifies if it's relative.
+    // Let's infer if it's relative.
+    let type = this.__apiCondition.type;
+    if (type && type.startsWith('DATE_')) {
+      const isRelative = this.__apiCondition.values && this.__apiCondition.values.some(v => v.relativeDate !== undefined);
+      if (isRelative && !type.endsWith('_RELATIVE')) {
+        type += '_RELATIVE';
+      }
+    }
+
+    const enumKey = map[type] || type;
+
+    // Return the Enum if available
+    if (BooleanCriteria[enumKey]) {
+      return BooleanCriteria[enumKey];
+    }
+    
+    return enumKey || null;
+  }
+
+  getCriteriaValues() {
+    if (!this.__apiCondition.values) return [];
+    
+    // API condition values are typically { userEnteredValue: 'string' } or { relativeDate: 'TODAY' }
+    return this.__apiCondition.values.map(v => {
+      if (v.userEnteredValue !== undefined) return v.userEnteredValue;
+      // In Apps Script, RelativeDate enum values are typically returned as strings matching the enum
+      if (v.relativeDate !== undefined) return SpreadsheetApp.RelativeDate[v.relativeDate] || v.relativeDate; 
+      return null;
+    });
+  }
+
+  getFontColorObject() {
+    if (this.__format.textFormat?.foregroundColorStyle) {
+      return makeColorFromApi(this.__format.textFormat.foregroundColorStyle);
+    }
+    if (this.__format.textFormat?.foregroundColor) {
+      return makeColorFromApi({ rgbColor: this.__format.textFormat.foregroundColor });
+    }
+    return null;
+  }
+
+  getItalic() {
+    return this.__format.textFormat?.italic ?? null;
+  }
+
+  getStrikethrough() {
+    return this.__format.textFormat?.strikethrough ?? null;
+  }
+
+  getUnderline() {
+    return this.__format.textFormat?.underline ?? null;
+  }
+
+  toString() {
+    return 'BooleanCondition';
+  }
+}

package/src/services/spreadsheetapp/fakecellimage.js

@@ -0,0 +1,42 @@
+import { Proxies } from "../../support/proxies.js";
+import { newFakeCellImageBuilder } from "./fakecellimagebuilder.js";
+
+/**
+ * Fake CellImage
+ * @class FakeCellImage
+ */
+export class FakeCellImage {
+  constructor(properties) {
+    this._properties = properties || {};
+  }
+
+  getAltTextDescription() {
+    return this._properties.altTextDescription || null;
+  }
+
+  getAltTextTitle() {
+    return this._properties.altTextTitle || null;
+  }
+
+  getContentUrl() {
+    const url = this._properties.sourceUrl || null;
+    if (url && !url.includes('googleusercontent.com')) {
+      throw new Error('Unexpected error while getting the method or property getContentUrl on object SpreadsheetApp.CellImage.');
+    }
+    return url;
+  }
+
+  toBuilder() {
+    const builder = newFakeCellImageBuilder();
+    if (this._properties.sourceUrl) builder.setSourceUrl(this._properties.sourceUrl);
+    if (this._properties.altTextTitle) builder.setAltTextTitle(this._properties.altTextTitle);
+    if (this._properties.altTextDescription) builder.setAltTextDescription(this._properties.altTextDescription);
+    return builder;
+  }
+
+  toString() {
+    return 'CellImage';
+  }
+}
+
+export const newFakeCellImage = (...args) => Proxies.guard(new FakeCellImage(...args));

package/src/services/spreadsheetapp/fakecellimagebuilder.js

@@ -0,0 +1,59 @@
+import { Proxies } from "../../support/proxies.js";
+import { newFakeCellImage } from "./fakecellimage.js";
+
+/**
+ * Fake CellImageBuilder
+ * @class FakeCellImageBuilder
+ */
+export class FakeCellImageBuilder {
+  constructor() {
+    this._properties = {};
+  }
+
+  build() {
+    return newFakeCellImage(this._properties);
+  }
+
+  getAltTextDescription() {
+    return this._properties.altTextDescription || null;
+  }
+
+  getAltTextTitle() {
+    return this._properties.altTextTitle || null;
+  }
+
+  getContentUrl() {
+    const url = this._properties.sourceUrl || null;
+    if (url && !url.includes('googleusercontent.com')) {
+      throw new Error('Unexpected error while getting the method or property getContentUrl on object SpreadsheetApp.CellImageBuilder.');
+    }
+    return url;
+  }
+
+  setAltTextDescription(description) {
+    this._properties.altTextDescription = description;
+    return this;
+  }
+
+  setAltTextTitle(title) {
+    this._properties.altTextTitle = title;
+    return this;
+  }
+
+  setSourceUrl(url) {
+    this._properties.sourceUrl = url;
+    return this;
+  }
+
+  toBuilder() {
+    const builder = newFakeCellImageBuilder();
+    builder._properties = { ...this._properties };
+    return builder;
+  }
+
+  toString() {
+    return 'CellImageBuilder';
+  }
+}
+
+export const newFakeCellImageBuilder = (...args) => Proxies.guard(new FakeCellImageBuilder(...args));

package/src/services/spreadsheetapp/fakeconditionalformatrule.js

@@ -0,0 +1,55 @@
+import { Proxies } from '../../support/proxies.js';
+import { newFakeBooleanCondition } from './fakebooleancondition.js';
+import { newFakeGradientCondition } from './fakegradientcondition.js';
+import { newFakeSheetRange } from './fakesheetrange.js';
+import { newFakeConditionalFormatRuleBuilder } from './fakeconditionalformatrulebuilder.js';
+
+export const newFakeConditionalFormatRule = (...args) => {
+  return Proxies.guard(new FakeConditionalFormatRule(...args));
+};
+
+export class FakeConditionalFormatRule {
+  constructor(apiRule, sheet) {
+    this.__apiRule = apiRule;
+    this.__sheet = sheet;
+  }
+
+  copy() {
+    // Builder takes spreadsheet. Sheet gives us spreadsheet via getParent()
+    return newFakeConditionalFormatRuleBuilder(this.__apiRule, this.__sheet.getParent());
+  }
+
+  getBooleanCondition() {
+    if (!this.__apiRule.booleanRule) return null;
+    return newFakeBooleanCondition(
+      this.__apiRule.booleanRule.condition,
+      this.__apiRule.booleanRule.format
+    );
+  }
+
+  getGradientCondition() {
+    if (!this.__apiRule.gradientRule) return null;
+    return newFakeGradientCondition(this.__apiRule.gradientRule);
+  }
+
+  getRanges() {
+    if (!this.__apiRule.ranges) return [];
+    return this.__apiRule.ranges.map(gridRange => {
+      const sheetId = gridRange.sheetId;
+      let sheet = this.__sheet; // Default to the sheet this rule was fetched from
+      if (sheetId !== undefined && sheet.getSheetId() !== sheetId) {
+        sheet = this.__sheet.getParent().getSheets().find(s => s.getSheetId() === sheetId);
+      }
+      
+      if (!sheet) return null;
+      return newFakeSheetRange(
+        gridRange,
+        sheet
+      );
+    }).filter(Boolean);
+  }
+
+  toString() {
+    return 'ConditionalFormatRule';
+  }
+}