@mcpher/gas-fakes 1.0.20 → 1.0.22

package/README.md

@@ -37,23 +37,15 @@ In order to avoid a bunch of Node specific code and credentials, yet still handl
 
 At the very least you need to add the gcp project id and optionally the id of some file you have access to - this'll be used to check that you have set up ADC properly.
 
-#### Option 1 - automated setup
-
-In the shells folder run
-```sh
-bash setup.sh
-```
-This will prompt you for project id and a file id to test with. It will also ask it you want to set up all the parameters needed for testing. If you answer yes, this will set up other things from the .env-template you can ignore unless you're planning to run the test suite. More information on that is in [collaborators info](collaborators.md) 
-
-Running set up will enhance your .env file and auth you in ADC with the required scopes
-
-#### Option 2 - manual setup
+#### Your .env file
 
 You can setup the .env file your self using the .env.template as a guide.
 
 ```
 # must set these
 GCP_PROJECT_ID="add your gcp project id here"
+
+# optional reference if you want to run a test after setting up
 DRIVE_TEST_FILE_ID="add the id of some test file you have access to here"
 
 # we'll use the default config for application default credentials
@@ -62,12 +54,13 @@ AC=default
 # these are the scopes set by default - take some of these out if you want to minimize access
 DEFAULT_SCOPES="https://www.googleapis.com/auth/userinfo.email,openid,https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/sqlservice.login"
 EXTRA_SCOPES=",https://www.googleapis.com/auth/drive,https://www.googleapis.com/auth/spreadsheets"
+ 
+# optional logging destination
+# can be CONSOLE (default), CLOUD, BOTH, NONE
+LOG_DESTINATION="BOTH"
 
 ```
 
-- goto ./shells and execute sp.sh
-
-
 #### Manifest file
 
 If you have an associated apps script project, you'll probably be using clasp to sync with the apps script IDE, and you'll have an appsscript.json available in your project folder
@@ -104,6 +97,66 @@ Optionally, gasfakes.json holds various location and behavior parameters to info
 | properties | string | /tmp/gas-fakes/properties        | gas-fakes uses a local file to emulate apps script's PropertiesService. This is where it should put the files. You may want to put it somewhere other than /tmp to avoid accidental deletion, but don't put it in a place that'll get commited to public git repo                        |
 | scriptId   | string | from clasp, or some random value | If you have a clasp file, it'll pick up the scriptId from there. If not you can enter your scriptId manually, or just leave it to create a fake one. It's use for the moment is to return something useful from ScriptApp.getScriptId() and to partition the cache and properties stores |
 
+
+
+### Cloud Logging Integration
+
+`gas-fakes` emulates the native Google Apps Script `Logger.log()` integration with Google Cloud Logging, allowing you to send structured logs from your local Node.js environment directly to your Google Cloud project. Note that console.log is the normal Node console and writes to the local console only. All messages from gas-fakes api still go to the console, so the Logger.log is for your own user messages as required.
+
+#### Initial Configuration
+
+The initial logging behavior is controlled by the `LOG_DESTINATION` environment variable in your `.env` file.
+
+| `LOG_DESTINATION` | Behavior |
+|---|---|
+| `CONSOLE` (Default) | Logs structured JSON to the console (`stdout`). This is the default behavior if the variable is not set. |
+| `CLOUD` | Sends logs directly to Google Cloud Logging. Nothing is written to the console. |
+| `BOTH` | Sends logs to both Google Cloud Logging and the console. |
+| `NONE` | Disables all output from `Logger.log()`. |
+
+When logging to the cloud, entries are sent to the `gas-fakes/console_logs` log name and include the following labels for easy filtering in the Log Explorer:
+- `gas-fakes-scriptId`
+- `gas-fakes-userId`
+
+#### Dynamic Control
+
+You can change the logging destination at any time during runtime by setting the `Logger.__logDestination` property. This is especially useful for testing or for applications that need to change their logging behavior dynamically.
+
+The method accepts one of the following string values: `'CONSOLE'`, `'CLOUD'`, `'BOTH'`, or `'NONE'`.
+
+#### Example Usage
+
+To set the initial destination, modify your `.env` file:
+```
+LOG_DESTINATION="BOTH"
+```
+
+To change the destination during runtime in your script:
+```javascript
+// Initially logs to BOTH (from .env)
+Logger.log('This goes to console and cloud');
+
+// Switch to only logging to the console
+Logger.__logDestination='CONSOLE';
+Logger.log('This now only goes to the console');
+
+// Disable logging completely
+Logger.__logDestination='NONE';
+Logger.log('This goes nowhere');
+```
+
+#### Link to Cloud log for this run
+
+If you have used Logging to cloud, you can get a link to the log data like this. 
+
+```javascript
+console.log ('....example cloud log link for this session',Logger.__cloudLogLink)
+````
+
+It contains a cloud logging query that will display any logging done in this session - the filter is based on the scriptId (from gasfakes.json), the projectId and userId (from Auth), as well as the start and end time of the session. 
+
+
+
 ### Pushing files to GAS
 
 There are a couple of syntactical differences between Node and Apps Script. Not in the body of the code but in how the IDE executes. The 2 main ones are
@@ -113,16 +166,15 @@ There are a couple of syntactical differences between Node and Apps Script. Not
 // this required on Node but not on Apps Script
 if (ScriptApp.isFake) testFakes()
 ````
-For inspiration on pushing modified files to the IDE, see the [bash script](https://github.com/brucemcpherson/gas-fakes/blob/main/togas.bash) I use for the test suite. 
-
-
+For inspiration on pushing modified files to the IDE, see the togas.sh bash script I use for the test suite. 
 
 ## Help
 
-As I mentioned earlier, to take this further, I'm going to need a lot of help to extend the methods and services supported - so if you feel this would be useful to you, and would like to collaborate, please ping me on [bruce@mcpher.com](mailto:bruce@mcpher.com) and we'll talk.
+As I mentioned earlier, to take this further, I'm going to need a lot of help to extend the methods and services supported - so if you feel this would be useful to you, and would like to collaborate, please ping me on bruce@mcpher.com and we'll talk.
 
 ## Translations and writeups
 
+
 - [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/gprompts/gas-inventory.js

@@ -0,0 +1,96 @@
+import got from 'got';
+import * as cheerio from 'cheerio';
+import fs from 'fs/promises';
+import { URL } from 'url';
+
+const baseUrl = "https://developers.google.com/apps-script/reference/script/"
+const outputFile = './gas-inventory.json';
+
+const visited = new Map();
+const queue = [baseUrl]
+
+// the urls are kebab cased
+const kebabCamel = (s) => {
+  return s.replace(/([-][a-z])/ig, ($1) => {
+    return $1.toUpperCase()
+      .replace('-', '')
+  });
+};
+
+function debugPageStructure($) {
+  console.log('=== PAGE STRUCTURE DEBUG ===');
+
+  // Check if main elements exist
+  console.log('#main-content exists:', $('#main-content').length > 0);
+  console.log('devsite-content exists:', $('devsite-content').length > 0);
+  console.log('article exists:', $('article').length > 0);
+  console.log('h1 elements:', $('h1').length);
+
+  // Show all h1 texts
+  $('h1').each((i, el) => {
+    console.log(`H1[${i}]:`, $(el).text().trim());
+  });
+
+  // Show structure of main-content
+  const mainContent = $('#main-content');
+  if (mainContent.length > 0) {
+    console.log('Main-content children:', mainContent.children().length);
+    mainContent.children().each((i, el) => {
+      console.log(`Child ${i}:`, el.tagName, $(el).attr('class') || $(el).attr('id'));
+    });
+  }
+}
+
+
+const getNextCheer = async (u) => {
+  console.log(`Scraping ${u}`);
+  const response = await got(u);
+  return cheerio.load(response.body);
+}
+
+const getHrefs = ($) => {
+  return $('a').map((i, el) => {
+    const r = $(el).attr('href');
+    if (r) {
+      const absolute = new URL(r, baseUrl).href;
+      // skip references to elsewhere and blank anchors
+      if (absolute.startsWith(baseUrl) && !absolute.endsWith('#')) return absolute;
+    }
+  }).get();
+}
+
+
+const s2 = async () => {
+  const umap = new Map();
+  const uset = new Set()
+  while (queue.length) {
+
+    const url = queue.shift();
+    console.log('working on url', url)
+    const $ = await getNextCheer(url);
+    debugPageStructure($);
+
+    // get all the hrefs
+    getHrefs($).forEach(f => {
+      // so a url could have an anchor for a method so we need to strip that out
+      const u = new URL(f);
+      const method = u.hash.substring(1);
+      const classUrl = u.origin + '/' + u.pathname
+      const methodUrl = u.href
+      if (!umap.has(classUrl)) {
+        umap.set(classUrl, {
+          parents: new Map(),
+          classUrl,
+          methods: new Map()
+        })
+        console.log ('pushing', classUrl)
+        queue.push (classUrl)
+      }
+      const ob = umap.get(classUrl)
+      ob.methods.set(method, { method, methodUrl })
+      ob.parents.set(url, { url })
+      console.log('adding', f)
+    })
+  }
+}
+s2().catch(console.error)

package/gprompts/gas-inventory.json

@@ -1,77 +1,173 @@
 {
-  "Base Service": {
-    "name": "Base Service",
-    "link": "https://developers.google.com/apps-script/reference/base",
+  "Forms Service": {
+    "name": "Forms Service",
+    "link": "https://developers.google.com/apps-script/reference/forms",
     "classes": {
       "Classes": {
         "methods": {},
         "properties": {}
       },
-      "Blob": {
+      "Alignment": {
         "methods": {},
         "properties": {}
       },
-      "BlobSource": {
+      "CheckboxGridItem": {
         "methods": {},
         "properties": {}
       },
-      "Browser": {
+      "CheckboxGridValidation": {
         "methods": {},
         "properties": {}
       },
-      "Button": {
+      "CheckboxGridValidationBuilder": {
         "methods": {},
         "properties": {}
       },
-      "ButtonSet": {
+      "CheckboxItem": {
         "methods": {},
         "properties": {}
       },
-      "ColorType": {
+      "CheckboxValidation": {
         "methods": {},
         "properties": {}
       },
-      "Logger": {
+      "CheckboxValidationBuilder": {
         "methods": {},
         "properties": {}
       },
-      "Menu": {
+      "Choice": {
         "methods": {},
         "properties": {}
       },
-      "MimeType": {
+      "DateItem": {
         "methods": {},
         "properties": {}
       },
-      "Month": {
+      "DateTimeItem": {
         "methods": {},
         "properties": {}
       },
-      "PromptResponse": {
+      "DestinationType": {
         "methods": {},
         "properties": {}
       },
-      "RgbColor": {
+      "DurationItem": {
         "methods": {},
         "properties": {}
       },
-      "Session": {
+      "FeedbackType": {
         "methods": {},
         "properties": {}
       },
-      "Ui": {
+      "Form": {
         "methods": {},
         "properties": {}
       },
-      "User": {
+      "FormApp": {
         "methods": {},
         "properties": {}
       },
-      "Weekday": {
+      "FormResponse": {
         "methods": {},
         "properties": {}
       },
-      "console": {
+      "GridItem": {
+        "methods": {},
+        "properties": {}
+      },
+      "GridValidation": {
+        "methods": {},
+        "properties": {}
+      },
+      "GridValidationBuilder": {
+        "methods": {},
+        "properties": {}
+      },
+      "ImageItem": {
+        "methods": {},
+        "properties": {}
+      },
+      "Item": {
+        "methods": {},
+        "properties": {}
+      },
+      "ItemResponse": {
+        "methods": {},
+        "properties": {}
+      },
+      "ItemType": {
+        "methods": {},
+        "properties": {}
+      },
+      "ListItem": {
+        "methods": {},
+        "properties": {}
+      },
+      "MultipleChoiceItem": {
+        "methods": {},
+        "properties": {}
+      },
+      "PageBreakItem": {
+        "methods": {},
+        "properties": {}
+      },
+      "PageNavigationType": {
+        "methods": {},
+        "properties": {}
+      },
+      "ParagraphTextItem": {
+        "methods": {},
+        "properties": {}
+      },
+      "ParagraphTextValidation": {
+        "methods": {},
+        "properties": {}
+      },
+      "ParagraphTextValidationBuilder": {
+        "methods": {},
+        "properties": {}
+      },
+      "QuizFeedback": {
+        "methods": {},
+        "properties": {}
+      },
+      "QuizFeedbackBuilder": {
+        "methods": {},
+        "properties": {}
+      },
+      "RatingIconType": {
+        "methods": {},
+        "properties": {}
+      },
+      "RatingItem": {
+        "methods": {},
+        "properties": {}
+      },
+      "ScaleItem": {
+        "methods": {},
+        "properties": {}
+      },
+      "SectionHeaderItem": {
+        "methods": {},
+        "properties": {}
+      },
+      "TextItem": {
+        "methods": {},
+        "properties": {}
+      },
+      "TextValidation": {
+        "methods": {},
+        "properties": {}
+      },
+      "TextValidationBuilder": {
+        "methods": {},
+        "properties": {}
+      },
+      "TimeItem": {
+        "methods": {},
+        "properties": {}
+      },
+      "VideoItem": {
         "methods": {},
         "properties": {}
       }

package/gprompts/inventory-list.json

@@ -1 +1 @@
-["base"]
+["forms"]