@mcpher/gas-fakes 2.0.11 → 2.0.13

package/README.md

@@ -1,4 +1,4 @@
-# <img src="./logo.png" alt="gas-fakes logo" width="50" align="top"> A proof of concept implementation of Apps Script Environment on Node
+# <img src="./logo.png" alt="gas-fakes logo" width="50" align="top"> Run Native Apps Script code anywhere with gas-fakes
 
 I use clasp/antigravity to develop Google Apps Script (GAS) applications, but when using GAS native services, there's way too much back and forwards to the GAS IDE going while testing. I set myself the ambition of implementing a fake version of the GAS runtime environment on Node so I could at least do some testing and debugging of Apps Scripts locally on Node.
 
@@ -170,6 +170,8 @@ As I mentioned earlier, to take this further, I'm going to need a lot of help to
 - [gas fakes cli](gas-fakes-cli.md)
 - [running gas-fakes on google cloud run](https://github.com/brucemcpherson/gas-fakes-containers)
 - [running gas-fakes on google kubernetes engine](https://github.com/brucemcpherson/gas-fakes-containers)
+- [running gas-fakes on Amazon AWS lambda](https://github.com/brucemcpherson/gas-fakes-containers)
+- [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/)
 - [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/)

package/package.json

@@ -24,6 +24,10 @@
     "unzipper": "^0.12.3",
     "zod": "^4.3.6"
   },
+  "overrides": {
+    "minimatch": "^10.2.1",
+    "glob": "^13.0.0"
+  },
   "type": "module",
   "scripts": {
     "pub": "npm publish --access public",
@@ -33,7 +37,7 @@
   },
   "name": "@mcpher/gas-fakes",
   "author": "bruce mcpherson",
-  "version": "2.0.11",
+  "version": "2.0.13",
   "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/slidesapp/fakepageelement.js

@@ -64,6 +64,18 @@ export class FakePageElement {
     throw new Error('PageElement is not a line.');
   }
 
+  /**
+   * Returns the page element as a table.
+   * @returns {FakeTable} The table.
+   */
+  asTable() {
+    if (this.__resource.table) {
+      const { newFakeTable } = PageElementRegistry;
+      return newFakeTable(this.__resource, this.__page);
+    }
+    throw new Error('PageElement is not a table.');
+  }
+
   /**
    * Gets the type of the page element.
    * @returns {SlidesApp.PageElementType} The type.
@@ -391,5 +403,6 @@ export class FakePageElement {
 
 export const PageElementRegistry = {
   newFakeShape: null,
-  newFakeLine: null
+  newFakeLine: null,
+  newFakeTable: null
 };

package/src/services/slidesapp/fakeslide.js

@@ -167,6 +167,23 @@ export class FakeSlide {
     return newElement.asShape();
   }
 
+  /**
+   * Inserts a text box.
+   * @param {string} text The text to insert.
+   * @param {number} left The left position.
+   * @param {number} top The top position.
+   * @param {number} width The width.
+   * @param {number} height The height.
+   * @returns {FakeShape} The new text box.
+   */
+  insertTextBox(text, left, top, width, height) {
+    const shape = this.insertShape('TEXT_BOX', left, top, width, height);
+    if (text) {
+      shape.getText().setText(text);
+    }
+    return shape;
+  }
+
   /**
    * Inserts a line.
    * @param {SlidesApp.LineCategory} lineCategory The line category.
@@ -212,6 +229,105 @@ export class FakeSlide {
     return newElement.asLine();
   }
 
+  /**
+   * Inserts a table.
+   * @param {number|FakeTable} rowsOrTable The number of rows or a table to copy.
+   * @param {number} [columns] The number of columns (if rowsOrTable is a number).
+   * @param {number} [left]
+   * @param {number} [top]
+   * @param {number} [width]
+   * @param {number} [height]
+   * @returns {FakeTable} The new table.
+   */
+  insertTable(rowsOrTable, columns, left = 0, top = 0, width = 300, height = 300) {
+    const presentationId = this.__presentation.getId();
+    const objectId = `table_${Math.random().toString(36).substring(2, 11)}`;
+    let request = null;
+
+    if (typeof rowsOrTable === 'number') {
+      request = {
+        createTable: {
+          objectId,
+          rows: rowsOrTable,
+          columns: columns,
+          elementProperties: {
+            pageObjectId: this.getObjectId(),
+            size: {
+              width: { magnitude: width, unit: 'PT' },
+              height: { magnitude: height, unit: 'PT' }
+            },
+            transform: {
+              scaleX: 1,
+              scaleY: 1,
+              translateX: left,
+              translateY: top,
+              unit: 'PT'
+            }
+          }
+        }
+      };
+    } else {
+      // Copy table logic - use duplicateObject if it's the same presentation?
+      // Or manually create new table with same rows/cols.
+      // Slide.insertTable(Table) usually means copy.
+      const table = rowsOrTable;
+      request = {
+        createTable: {
+          objectId,
+          rows: table.getNumRows(),
+          columns: table.getNumColumns(),
+          elementProperties: {
+            pageObjectId: this.getObjectId(),
+            size: {
+              width: { magnitude: table.getWidth(), unit: 'PT' },
+              height: { magnitude: table.getHeight(), unit: 'PT' }
+            },
+            transform: {
+              scaleX: 1,
+              scaleY: 1,
+              translateX: table.getLeft(),
+              translateY: table.getTop(),
+              unit: 'PT'
+            }
+          }
+        }
+      };
+    }
+
+    try {
+      Slides.Presentations.batchUpdate([request], presentationId);
+    } catch (err) {
+      if (!err?.message?.includes('already exists')) throw err;
+    }
+
+    const elements = this.getPageElements();
+    const newElement = elements.find(e => e.getObjectId() === objectId);
+    if (!newElement) throw new Error('New table not found');
+
+    const newTable = newElement.asTable();
+
+    // If copying, we should probably copy cell contents too.
+    if (typeof rowsOrTable !== 'number') {
+      const sourceTable = rowsOrTable;
+      const targetTable = newTable;
+      const rows = sourceTable.getRows();
+      const targetRows = targetTable.getRows();
+
+      for (let r = 0; r < rows.length; r++) {
+        const cells = rows[r].getCells();
+        const targetCells = targetRows[r].getCells();
+        for (let c = 0; c < cells.length; c++) {
+          const text = cells[c].getText().asString();
+          if (text) {
+            targetCells[c].getText().setText(text);
+          }
+        }
+      }
+    }
+
+    return newTable;
+  }
+
   duplicate() {
     const presentationId = this.__presentation.getId();
     const objectId = `slide_${Math.random().toString(36).substring(2, 11)}`;

package/src/services/slidesapp/faketable.js

@@ -0,0 +1,63 @@
+import { Proxies } from '../../support/proxies.js';
+import { FakePageElement, PageElementRegistry } from './fakepageelement.js';
+import { newFakeTableRow } from './faketablerow.js';
+
+export const newFakeTable = (...args) => {
+  return Proxies.guard(new FakeTable(...args));
+};
+
+PageElementRegistry.newFakeTable = newFakeTable;
+
+export class FakeTable extends FakePageElement {
+  constructor(resource, page) {
+    super(resource, page);
+  }
+
+  get __presentation() {
+    return this.__page.__presentation || this.__page.__slide?.__presentation;
+  }
+
+  /**
+   * Gets the rows in the table.
+   * @returns {FakeTableRow[]} The rows.
+   */
+  getRows() {
+    return (this.__resource.table?.tableRows || []).map((row, index) =>
+      newFakeTableRow(row, this, index)
+    );
+  }
+
+  /**
+   * Gets a row by its index.
+   * @param {number} index The row index.
+   * @returns {FakeTableRow} The row.
+   */
+  getRow(index) {
+    const rows = this.getRows();
+    if (index < 0 || index >= rows.length) {
+      throw new Error(`Row index ${index} out of bounds`);
+    }
+    return rows[index];
+  }
+
+  /**
+   * Gets the number of rows in the table.
+   * @returns {number} The number of rows.
+   */
+  getNumRows() {
+    return (this.__resource.table?.tableRows || []).length;
+  }
+
+  /**
+   * Gets the number of columns in the table.
+   * @returns {number} The number of columns.
+   */
+  getNumColumns() {
+    const rows = this.__resource.table?.tableRows || [];
+    return rows.length > 0 ? (rows[0].tableCells || []).length : 0;
+  }
+
+  toString() {
+    return 'Table';
+  }
+}

package/src/services/slidesapp/faketablecell.js

@@ -0,0 +1,51 @@
+import { Proxies } from '../../support/proxies.js';
+import { newFakeTextRange } from './faketextrange.js';
+
+export const newFakeTableCell = (...args) => {
+  return Proxies.guard(new FakeTableCell(...args));
+};
+
+export class FakeTableCell {
+  constructor(resource, table, rowIndex, colIndex) {
+    this.__resource = resource;
+    this.__table = table;
+    this.__rowIndex = rowIndex;
+    this.__colIndex = colIndex;
+  }
+
+  /**
+   * Gets the text in the cell.
+   * @returns {FakeTextRange} The text range.
+   */
+  getText() {
+    // FakeTableCell in Slides API doesn't have a direct shape resource to pass to TextRange?
+    // Actually, TableCell has text property in Slides API.
+    // Wait, let's check Slides API TableCell resource.
+    // It has `text` field of type `TextContent`.
+    // FakeTextRange expects a `shape` with `__resource.shape.text`.
+    // We might need to adapt FakeTextRange or mock a shape-like object.
+
+    // Let's create a proxy for shape so FakeTextRange can work.
+    const mockShape = {
+      getObjectId: () => this.__table.getObjectId(),
+      __resource: {
+        shape: {
+          text: this.__resource.text || { textElements: [] }
+        }
+      },
+      __cellLocation: {
+        rowIndex: this.__rowIndex,
+        columnIndex: this.__colIndex
+      },
+      __presentation: this.__table.__presentation
+    };
+    if (!this.__resource.text) {
+      this.__resource.text = mockShape.__resource.shape.text;
+    }
+    return newFakeTextRange(mockShape);
+  }
+
+  toString() {
+    return 'TableCell';
+  }
+}

package/src/services/slidesapp/faketablerow.js

@@ -0,0 +1,49 @@
+import { Proxies } from '../../support/proxies.js';
+import { newFakeTableCell } from './faketablecell.js';
+
+export const newFakeTableRow = (...args) => {
+  return Proxies.guard(new FakeTableRow(...args));
+};
+
+export class FakeTableRow {
+  constructor(resource, table, rowIndex) {
+    this.__resource = resource;
+    this.__table = table;
+    this.__rowIndex = rowIndex;
+  }
+
+  /**
+   * Gets the cells in the row.
+   * @returns {FakeTableCell[]} The cells.
+   */
+  getCells() {
+    return (this.__resource.tableCells || []).map((cell, colIndex) =>
+      newFakeTableCell(cell, this.__table, this.__rowIndex, colIndex)
+    );
+  }
+
+  /**
+   * Gets a cell by its index.
+   * @param {number} index The cell index.
+   * @returns {FakeTableCell} The cell.
+   */
+  getCell(index) {
+    const cells = this.getCells();
+    if (index < 0 || index >= cells.length) {
+      throw new Error(`Cell index ${index} out of bounds`);
+    }
+    return cells[index];
+  }
+
+  /**
+   * Gets the number of cells in the row.
+   * @returns {number} The number of cells.
+   */
+  getNumCells() {
+    return (this.__resource.tableCells || []).length;
+  }
+
+  toString() {
+    return 'TableRow';
+  }
+}

package/src/services/slidesapp/faketextrange.js

@@ -83,6 +83,7 @@ export class FakeTextRange {
       requests.push({
         deleteText: {
           objectId: objectId,
+          cellLocation: this.__shape.__cellLocation,
           textRange: {
             type: 'FROM_START_INDEX',
             startIndex: 0
@@ -104,6 +105,7 @@ export class FakeTextRange {
       requests.push({
         insertText: {
           objectId: objectId,
+          cellLocation: this.__shape.__cellLocation,
           insertionIndex: 0,
           text: newText
         }

package/src/services/slidesapp/pageelementfactory.js

@@ -1,5 +1,6 @@
 import { newFakeShape } from './fakeshape.js';
 import { newFakeLine } from './fakeline.js';
+import { newFakeTable } from './faketable.js';
 
 /**
  * Converts a base PageElement to a more specific subclass (Shape, Line, etc.)
@@ -14,6 +15,9 @@ export const asSpecificPageElement = (pageElement) => {
   if (resource.line) {
     return newFakeLine(resource, pageElement.__page);
   }
+  if (resource.table) {
+    return newFakeTable(resource, pageElement.__page);
+  }
   // Add other types as they are implemented
   return pageElement;
 };

package/src/support/auth.js

@@ -56,7 +56,25 @@ const getHashedUserId = () =>
 const _getTokenInfo = async (client) => {
   const tokenResponse = await client.getAccessToken();
   const token = tokenResponse.token;
-  const tokenInfo = await client.getTokenInfo(token);
+  
+  let tokenInfo;
+  if (typeof client.getTokenInfo === 'function') {
+    tokenInfo = await client.getTokenInfo(token);
+  } else {
+    // Fallback for clients like AwsClient that don't have getTokenInfo
+    // Call the Token Info API directly
+    const response = await client.request({
+      url: `https://oauth2.googleapis.com/tokeninfo?access_token=${token}`,
+      method: 'GET'
+    });
+    tokenInfo = response.data;
+    
+    // Ensure email is populated from subject if missing (WIF fallback)
+    if (!tokenInfo.email && process.env.GOOGLE_WORKSPACE_SUBJECT) {
+      tokenInfo.email = process.env.GOOGLE_WORKSPACE_SUBJECT;
+    }
+  }
+  
   return {
     tokenInfo,
     token
@@ -112,9 +130,6 @@ const setAuth = async (scopes = [], mcpLoading = false) => {
     mayLog(`...discovered project ID: ${_projectId}`)
 
     // steering for auth type
-    // 1. if AUTH_TYPE is DWD, use DWD
-    // 2. if AUTH_TYPE is ADC, use ADC
-    // 3. if AUTH_TYPE is not set, use DWD if saName is present, else ADC
     const saName = process.env.GOOGLE_SERVICE_ACCOUNT_NAME
     const authType = process.env.AUTH_TYPE?.toLowerCase()
     const useDwd = authType === 'dwd' || (authType !== 'adc' && saName)
@@ -134,19 +149,21 @@ const setAuth = async (scopes = [], mcpLoading = false) => {
       mayLog(`...attempting to use service account: ${targetPrincipal}`)
 
       /// _sourceClient is the identity of the person/thing running the code
-      // we'll try to get the openid and email scopes for the source client too if they are in the manifest
       const sourceScopes = scopes.filter(s => s === 'openid' || s === 'https://www.googleapis.com/auth/userinfo.email')
       _sourceClient = await _auth.getClient(sourceScopes.length > 0 ? { scopes: sourceScopes } : {})
 
       // now to get who the real user is
       const { tokenInfo: userInfo } = await getSourceAccessTokenInfo()
-      mayLog(`...user verified as: ${userInfo.email}`);
-
-      // DWD Subject priority:
-      // 1. GOOGLE_WORKSPACE_SUBJECT
-      // 2. Caller identity (from getSourceAccessTokenInfo)
+      
+      // AWS tokens might not have email info
       const saEmail = targetPrincipal
       const userEmail = process.env.GOOGLE_WORKSPACE_SUBJECT || userInfo.email
+      
+      if (userEmail) {
+        mayLog(`...user verified as: ${userEmail}`);
+      } else {
+        mayLog(`...warning: user identity could not be verified from token, using fallback`);
+      }
 
       const dwdClient = new OAuth2Client()
       dwdClient._token = null
@@ -168,10 +185,7 @@ const setAuth = async (scopes = [], mcpLoading = false) => {
           scope: scopes.join(' ')
         }
 
-        //mayLog(`[Auth] DWD Scopes: ${payload.scope}`)
-
         // Sign the JWT via IAM API
-        // Note: The caller must have 'Service Account Token Creator' role on the target SA
         const signUrl = `https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/${saEmail}:signJwt`
         const signResponse = await _sourceClient.request({
           url: signUrl,
@@ -196,8 +210,6 @@ const setAuth = async (scopes = [], mcpLoading = false) => {
 
         if (!tokenResponse.ok) {
           const errorText = await tokenResponse.text()
-          console.log ('... it looks like you forgot to enable domain-wide delegation for the service account')
-          console.log ('... rerun gas-fakes auth and check the instructions about enabling domain-wide delegation')
           throw new Error(`Failed to exchange JWT for token: ${errorText}`)
         }
 
@@ -209,10 +221,9 @@ const setAuth = async (scopes = [], mcpLoading = false) => {
         return { token: this._token }
       }
 
-      // override request to ensure we use our token but leverage the existing transporter
+      // override request
       const originalRequest = dwdClient.request.bind(dwdClient)
       dwdClient.request = async function (options) {
-        // Ensure token is fresh
         await this.getAccessToken()
         return originalRequest(options)
       }
@@ -230,14 +241,18 @@ const setAuth = async (scopes = [], mcpLoading = false) => {
 
       mayLog(`...using Domain-Wide Delegation for user: ${userEmail}`)
 
-      // check we can get an access token - this will trigger the signJwt flow
-      const { tokenInfo } = await getAccessTokenInfo()
-      mayLog(`...sa (acting as user) verified as: ${tokenInfo.email}`);
+      // check we can get an access token
+      const { tokenInfo: authedTokenInfo } = await getAccessTokenInfo()
+      if (authedTokenInfo.email) {
+        mayLog(`...sa (acting as user) verified as: ${authedTokenInfo.email}`);
+      } else {
+        mayLog(`...sa (acting as user) token acquired successfully`);
+      }
     }
 
 
   } catch (error) {
-    mayLog(`...auth failed - check you are logged in with 'gcloud auth login' and have enabled workload identity: ${error}`)
+    mayLog(`...auth failed - check environment variables and workload identity: ${error}`)
     throw error
   }
   return getAuth()
@@ -256,15 +271,6 @@ const invalidateToken = () => {
     }
   }
 }
-/**
- * we'll be using adc credentials so no need for any special auth here
- * the idea here is to keep addign scopes to any auth so we have them all
- * @param {string[]} [scopes=[]] the required scopes will be added to existing scopes already asked for
- * @param {string} [keyFile=null]
- * @param {boolean} [mcpLoading=false] When the MCP server is loading, this value is true. By this, the invalid values can be hidden while the MCP server is loading. This is important for using Google Antigravity.
- * @returns {GoogleAuth.auth}
- */
-
 
 /**
  * if we're doing a fetch on drive API we need a special header
@@ -278,10 +284,6 @@ const googify = (options = {}) => {
   // if no authorization, we dont need this either
   if (!Reflect.has(headers, "Authorization")) return options;
 
-  // we'll need the projectID for this
-  // note - you must add the x-goog-user-project header, otherwise it'll use some nonexistent project
-  // see https://cloud.google.com/docs/authentication/rest#set-billing-project
-  // this has been syncified
   const projectId = getProjectId();
   return {
     ...options,
@@ -293,7 +295,6 @@ const googify = (options = {}) => {
 };
 
 /**
- * this would have been set up when manifest was imported
  * @returns {string} the project id
  */
 const getProjectId = () => {
@@ -318,7 +319,6 @@ const getAuth = () => {
   if (!hasAuth())
     throw new Error(`auth hasnt been intialized with setAuth yet`);
 
-  // Simply return the client we've already prepared/patched
   return getAuthClient();
 };
 
@@ -326,17 +326,11 @@ const getAuth = () => {
 
 /**
  * why is this here ?
- * because when we syncit, we import auth for each method and it needs this
- * if it was somewhere else we'd need to import that too.
- * we can't serialize a return object
- * so we just select a few props from it
- * @param {SyncApiResponse} result
- * @returns
  */
 export const responseSyncify = (result) => {
   if (!result) {
     return {
-      status: 503, // Service Unavailable, a good representation for a worker-level failure
+      status: 503,
       statusCode: 503,
       statusText: "Worker Error: No response object received from API call",
       error: {
@@ -357,10 +351,6 @@ export const responseSyncify = (result) => {
   };
 };
 
-/**
- * these are the ones that have been so far requested
- * @returns {Set}
- */
 const getAuthedScopes = () => _authScopes;
 
 export const Auth = {