@mcpher/gas-fakes 1.0.19 → 1.0.21

package/gprompts/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "gas-inventory",
+  "version": "1.0.0",
+  "description": "Scrapes Google Apps Script documentation",
+  "main": "gas-inventory.js",
+  "type": "module",
+  "scripts": {
+    "start": "node gas-inventory.js"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "cheerio": "^1.1.2",
+    "jsdom": "^24.0.0",
+    "node-fetch": "^3.3.2"
+  }
+}

package/gprompts/temp_fetch.mjs

@@ -0,0 +1,9 @@
+import got from 'got';
+
+const url = 'https://developers.google.com/apps-script/reference/document';
+
+got(url).then(response => {
+  console.log(response.body);
+}).catch(err => {
+  console.error(err);
+});

package/gprompts/update-progress.js

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+
+import { promises as fs } from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const progressDir = path.join(__dirname, '..', 'progress');
+const overallMdPath = path.join(progressDir, 'overall.md');
+
+/**
+ * Calculates a percentage and formats it as a string.
+ * @param {number} completed - The number of completed items.
+ * @param {number} total - The total number of items.
+ * @returns {string} The formatted percentage string.
+ */
+const formatPercent = (completed, total) => {
+  if (total === 0) {
+    return '0%';
+  }
+  return `${Math.round((completed / total) * 100)}%`;
+};
+
+/**
+ * Parses a single markdown progress file to count classes and methods.
+ * @param {string} filePath - The path to the markdown file.
+ * @returns {Promise<{totalClasses: number, completedClasses: number, totalMethods: number, completedMethods: number}>}
+ */
+async function parseProgressFile(filePath) {
+  const content = await fs.readFile(filePath, 'utf-8');
+  // Split the file into sections based on '## ' headings.
+  // The first element will be anything before the first class, which we ignore.
+  const classSections = content.split('\n## ').slice(1);
+
+  if (classSections.length === 0) {
+    return { totalClasses: 0, completedClasses: 0, totalMethods: 0, completedMethods: 0 };
+  }
+
+  let totalClasses = 0;
+  let completedClasses = 0;
+  let totalMethods = 0;
+  let completedMethods = 0;
+  for (const classContent of classSections) {
+    totalClasses++;
+    const classLines = classContent.split('\n');
+    let statusColumnIndex = -1;
+    let classTotalMethods = 0;
+    let classCompletedMethods = 0;
+    let isTableBody = false;
+
+    for (const line of classLines) {
+      const trimmedLine = line.trim();
+
+      if (!trimmedLine.startsWith('|')) {
+        continue;
+      }
+
+      // Find the header row to locate the 'status' column.
+      if (statusColumnIndex === -1 && trimmedLine.toLowerCase().includes('status') && !trimmedLine.includes('---')) {
+        const headers = trimmedLine.split('|').map(h => h.trim().toLowerCase());
+        statusColumnIndex = headers.indexOf('status');
+        continue;
+      }
+
+      // The separator row marks the beginning of the table body.
+      if (trimmedLine.includes('---')) {
+        isTableBody = true;
+        continue;
+      }
+
+      // If we are in the table body and have a valid status column, count the method.
+      if (isTableBody && statusColumnIndex > -1) {
+        const columns = trimmedLine.split('|');
+        if (columns.length > statusColumnIndex) {
+          classTotalMethods++;
+          const statusCell = columns[statusColumnIndex].trim();
+          if (statusCell.toLowerCase().includes('completed')) {
+            classCompletedMethods++;
+          }
+        }
+      }
+    }
+    totalMethods += classTotalMethods;
+    completedMethods += classCompletedMethods;
+    if (classTotalMethods > 0 && classTotalMethods === classCompletedMethods) {
+      completedClasses++;
+    }
+  }
+
+  return { totalClasses, completedClasses, totalMethods, completedMethods };
+}
+
+/**
+ * Main function to generate the overall progress summary.
+ */
+async function generateSummary() {
+  try {
+    const files = await fs.readdir(progressDir);
+    // Filter for .md files, excluding overall.md and other non-service files, case-insensitively
+    const mdFiles = files.filter(file =>
+      file.toLowerCase().endsWith('.md') &&
+      !['overall.md'].includes(file.toLowerCase())
+    );
+
+    const allStats = [];
+    const grandTotal = { classes: 0, classesCompleted: 0, methods: 0, methodsCompleted: 0 };
+
+    for (const file of mdFiles) {
+      const serviceName = path.basename(file, path.extname(file));
+      const filePath = path.join(progressDir, file);
+      const stats = await parseProgressFile(filePath);
+      allStats.push({ name: serviceName, file, ...stats });
+      grandTotal.classes += stats.totalClasses;
+      grandTotal.classesCompleted += stats.completedClasses;
+      grandTotal.methods += stats.totalMethods;
+      grandTotal.methodsCompleted += stats.completedMethods;
+    }
+
+    allStats.sort((a, b) => a.name.localeCompare(b.name));
+
+    let table = '# Overall Progress\n\n';
+    table += '| service | classes | methods | methods completed | %age |\n';
+    table += '| :--- | :---: | :---: | :---: | :---: |\n';
+
+    for (const stat of allStats) {
+      const methodPercent = formatPercent(stat.completedMethods, stat.totalMethods);
+      table += `| [${stat.name}](${stat.file}) | ${stat.totalClasses} | ${stat.totalMethods} | ${stat.completedMethods} | ${methodPercent} |\n`;
+    }
+
+    const totalMethodPercent = formatPercent(grandTotal.methodsCompleted, grandTotal.methods);
+    table += `| **Total** | **${grandTotal.classes}** | **${grandTotal.methods}** | **${grandTotal.methodsCompleted}** | **${totalMethodPercent}** |\n`;
+
+    await fs.writeFile(overallMdPath, table);
+    console.log(`Successfully updated ${overallMdPath}`);
+  } catch (error) {
+    console.error('Failed to generate progress summary:', error);
+  }
+}
+
+generateSummary();

package/package.json

@@ -3,10 +3,12 @@
     "node": ">=20.11.0"
   },
   "dependencies": {
+    "@google-cloud/logging": "^11.2.1",
     "@mcpher/fake-gasenum": "^1.0.2",
     "@mcpher/unit": "^1.1.11",
     "@sindresorhus/is": "^7.0.1",
     "archiver": "^7.0.1",
+    "fast-json-stable-stringify": "^2.1.0",
     "get-stream": "^9.0.1",
     "googleapis": "^157.0.0",
     "got": "^14.4.7",
@@ -57,13 +59,15 @@
     "testdocsimages": "cp mainlocal.js main.js &&  node --env-file=.env ./test/testdocsimages.js execute",
     "testdocsstyles": "cp mainlocal.js main.js &&  node --env-file=.env ./test/testdocsstyles.js execute",
     "testsandbox": "cp mainlocal.js main.js &&  node --env-file=.env ./test/testsandbox.js execute",
+    "testgmail": "cp mainlocal.js main.js &&  node --env-file=.env ./test/testgmail.js execute",
+    "testlogger": "cp mainlocal.js main.js &&  node --env-file=.env ./test/testlogger.js execute",
     "pub": "cp mainlocal.js main.js && npm publish --access public"
   },
   "name": "@mcpher/gas-fakes",
-  "version": "1.0.19",
+  "version": "1.0.21",
   "license": "MIT",
   "main": "main.js",
   "description": "A proof of concept implementation of Apps Script Environment on Node",
   "repository": "github:brucemcpherson/gas-fakes",
   "homepage": "https://ramblings.mcpher.com/a-proof-of-concept-implementation-of-apps-script-environment-on-node/"
-}
+}

package/setup.sh

@@ -0,0 +1,147 @@
+#!/bin/bash
+
+# --- 1. Collect Phase ---
+echo "Welcome to the gas-fakes project setup."
+echo "This script will guide you through creating your .env file for testing."
+echo "Please provide the following configuration values."
+echo "Some values are required for the test suite to run correctly."
+echo
+
+# --- Required values ---
+read -p "Enter your GCP Project ID: " gcp_project_id
+if [ -z "$gcp_project_id" ]; then
+    echo "Error: GCP Project ID is required." >&2
+    exit 1
+fi
+
+read -p "Enter a Drive File ID you have read access to (for testing ADC): " drive_test_file_id
+if [ -z "$drive_test_file_id" ]; then
+    echo "Error: Drive File ID is required." >&2
+    exit 1
+fi
+
+read -p "Enter a test Drive Folder Name you have write access to: " test_folder_name
+if [ -z "$test_folder_name" ]; then
+    echo "Error: Test Folder Name is required." >&2
+    exit 1
+fi
+
+read -p "Enter the ID of that test Drive Folder: " test_folder_id
+if [ -z "$test_folder_id" ]; then
+    echo "Error: Test Folder ID is required." >&2
+    exit 1
+fi
+
+# --- Optional values with defaults ---
+read -p "Enter the number of files in that folder [0]: " test_folder_files
+test_folder_files=${test_folder_files:-0}
+
+read -p "Enter a viewer email for permission tests [viewer@mcpher.com]: " scratch_viewer
+scratch_viewer=${scratch_viewer:-"viewer@mcpher.com"}
+
+read -p "Enter an editor email for permission tests [editor@mcpher.com]: " scratch_editor
+scratch_editor=${scratch_editor:-"editor@mcpher.com"}
+
+read -p "Enter a second viewer email [viewer2@mcpher.com]: " scratch_b_viewer
+scratch_b_viewer=${scratch_b_viewer:-"viewer2@mcpher.com"}
+
+read -p "Enter a second editor email [editor2@mcpher.com]: " scratch_b_editor
+scratch_b_editor=${scratch_b_editor:-"editor2@mcpher.com"}
+
+read -p "Enter min PDFs in root for tests [20]: " min_root_pdfs
+min_root_pdfs=${min_root_pdfs:-20}
+
+read -p "Enter min PDFs total for tests [400]: " min_pdfs
+min_pdfs=${min_pdfs:-400}
+
+read -p "Enter min folders in root for tests [5]: " min_folders_root
+min_folders_root=${min_folders_root:-5}
+
+
+# --- 2. Confirm Phase ---
+echo
+echo "The following configuration will be written to .env:"
+echo "================================================="
+echo "# User-specific values"
+echo "GCP_PROJECT_ID=${gcp_project_id}"
+echo "DRIVE_TEST_FILE_ID=${drive_test_file_id}"
+echo "TEST_FOLDER_NAME=\"${test_folder_name}\""
+echo "TEST_FOLDER_ID=${test_folder_id}"
+echo "TEST_FOLDER_FILES=${test_folder_files}"
+echo "SCRATCH_VIEWER=${scratch_viewer}"
+echo "SCRATCH_EDITOR=${scratch_editor}"
+echo "SCRATCH_B_VIEWER=${scratch_b_viewer}"
+echo "SCRATCH_B_EDITOR=${scratch_b_editor}"
+echo "MIN_ROOT_PDFS=${min_root_pdfs}"
+echo "MIN_PDFS=${min_pdfs}"
+echo "MIN_FOLDERS_ROOT=${min_folders_root}"
+echo
+echo "# Shared and static values will also be included."
+echo "================================================="
+echo
+
+read -p "Proceed with creating the .env file? (y/N) " confirm
+if [[ ! "$confirm" =~ ^[yY](es)?$ ]]; then
+    echo "Setup aborted. No file was written."
+    exit 0
+fi
+
+
+# --- 3. Commit Phase ---
+ENV_FILE=".env"
+TEMP_ENV_FILE="${ENV_FILE}.tmp"
+
+# Using a heredoc to write the complete file content.
+cat > "$TEMP_ENV_FILE" << EOL
+# Auto-generated by setup.sh on $(date)
+
+# --- User-specific values ---
+# Required for authentication and core tests
+GCP_PROJECT_ID="${gcp_project_id}"
+DRIVE_TEST_FILE_ID="${drive_test_file_id}"
+
+# Required for file/folder manipulation tests
+TEST_FOLDER_NAME="${test_folder_name}"
+TEST_FOLDER_ID="${test_folder_id}"
+TEST_FOLDER_FILES=${test_folder_files}
+
+# For permission tests
+SCRATCH_VIEWER="${scratch_viewer}"
+SCRATCH_EDITOR="${scratch_editor}"
+SCRATCH_B_VIEWER="${scratch_b_viewer}"
+SCRATCH_B_EDITOR="${scratch_b_editor}"
+
+# For iterator/search tests (adjust to your Drive content)
+MIN_ROOT_PDFS=${min_root_pdfs}
+MIN_PDFS=${min_pdfs}
+MIN_FOLDERS_ROOT=${min_folders_root}
+
+# --- Static auth config ---
+# we'll use the default config for application default credentials
+# probably dont need to change these
+AC=default
+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"
+
+# --- Shared test file fixtures (read-only) ---
+TEST_BORDERS_ID=1hRGdrYHEPixXTuQLeL3Z0qGRZVs_8ojMIm6D4KrCh1o
+TEST_AIRPORTS_ID=1h9IGIShgVBVUrUjjawk5MaCEQte_7t32XeEP1Z5jXKQ
+TEXT_FILE_NAME="fake.txt"
+TEXT_FILE_ID=1142Vn7W-pGl5nWLpUSkpOB82JDiz9R6p
+TEXT_FILE_TYPE="text/plain"
+TEXT_FILE_CONTENT="foo is not bar"
+TEST_SHEET_ID=1DlKpVVYCrCPNfRbGsz6N_K3oPTgdC9gQIKi0aNb42uI
+TEST_SHEET_NAME="sharedlibraries"
+PDF_ID=17t4ep9Jt6jRyDx0KlxMhHQNGZ3whg6GS
+
+# --- Test behavior ---
+# Set to 0 to preserve test files for debugging
+CLEAN=1
+EOL
+
+# Atomically rename the temp file to the final .env file.
+mv "$TEMP_ENV_FILE" "$ENV_FILE"
+
+echo
+echo "✅ The .env file has been created successfully."
+echo "You can now run 'npm install && npm test' to run the test suite."

package/src/index.js

@@ -1,15 +1,22 @@
 import './services/scriptapp/app.js'
 import './services/driveapp/app.js'
+import './services/logger/app.js'
 import './services/urlfetchapp/app.js'
 import './services/utilities/app.js'
 import './services/spreadsheetapp/app.js'
 import './services/stores/app.js'
-import './services/base/app.js'
+import './services/gmailapp/app.js'
+import './services/session/app.js'
 import './services/advdrive/app.js'
 import './services/advsheets/app.js'
 import './services/advdocs/app.js'
+import './services/advgmail/app.js'
 import './services/advslides/app.js'
 import './services/documentapp/app.js'
 import './services/advforms/app.js'
 import './services/formapp/app.js'
-import './services/slidesapp/app.js'
+import './services/slidesapp/app.js'
+
+// force initilialization of scriptApp - which is always needed
+// scriptapp will always be fake here
+ScriptApp.isFake

package/src/services/advdocs/app.js

@@ -5,28 +5,9 @@
  * We do this by using a proxy, intercepting calls to the 
  * initial sigleton and diverting them to a completed one
  */
-import { newFakeAdvDocs } from './fakeadvdocs.js'
-import { Proxies } from '../../support/proxies.js'
+import { newFakeAdvDocs as maker } from './fakeadvdocs.js'
+import { lazyLoaderApp } from '../common/lazyloader.js'
 
-// This will eventually hold a proxy for DriveApp
-let _app = null
+let _app = null;
+_app = lazyLoaderApp(_app, 'Docs', maker)
 
-/**
- * adds to global space to mimic Apps Script behavior
- */
-const name = "Docs"
-if (typeof globalThis[name] === typeof undefined) {
-
-  const getApp = () => {
-    // if it hasne been intialized yet then do that
-    if (!_app) {
-      console.log('...activating proxy for', name)
-      _app = newFakeAdvDocs()
-    }
-    // this is the actual driveApp we'll return from the proxy
-    return _app
-  }
-
-  Proxies.registerProxy(name, getApp)
-
-}

package/src/services/advdrive/app.js

@@ -1,32 +1,10 @@
-// fake Apps Script DriveApp
-/**
- * the idea here is to create a global entry for the singleton 
- * before we actually have everything we need to create it. 
- * We do this by using a proxy, intercepting calls to the 
- * initial sigleton and diverting them to a completed one
- */
-import { newFakeAdvDrive} from './fakeadvdrive.js'
-import { Proxies } from '../../support/proxies.js'
-
-
-let _app = null
 
 /**
- * adds to global space to mimic Apps Script behavior
+ * the idea here is to create an empty global entry for the singleton
+ * but only load it when it is actually used.
  */
-const name = "Drive"
-if (typeof globalThis[name] === typeof undefined) {
-
-  const getApp = () => {
-    // if it hasne been intialized yet then do that
-    if (!_app) {
-      console.log ('...activating proxy for', name)
-      _app = newFakeAdvDrive()
-    }
-    // this is the actual driveApp we'll return from the proxy
-    return _app
-  }
-
-  Proxies.registerProxy (name, getApp)
+import { newFakeAdvDrive as maker} from './fakeadvdrive.js'
+import { lazyLoaderApp } from '../common/lazyloader.js'
 
-}
+let _app = null;
+_app = lazyLoaderApp(_app, 'Drive', maker)

package/src/services/advforms/app.js

@@ -1,31 +1,12 @@
 
-/**
- * NOTE - Although Apps Script doesnt yet have a Forms advanced service
- * we're going to funnel everything through here as if there was one.
- * 
- */
-import { newFakeAdvForms } from './fakeadvforms.js'
-import { Proxies } from '../../support/proxies.js'
-
-// This will eventually hold a proxy for Formsapp
-let _app = null
 
 /**
- * adds to global space to mimic Apps Script behavior
+ * the idea here is to create an empty global entry for the singleton
+ * but only load it when it is actually used.
  */
-const name = "Forms"
-if (typeof globalThis[name] === typeof undefined) {
-
-  const getApp = () => {
-    // if it hasne been intialized yet then do that
-    if (!_app) {
-      console.log('...activating proxy for', name)
-      _app = newFakeAdvForms()
-    }
-    // this is the actual formsapp we'll return from the proxy
-    return _app
-  }
 
-  Proxies.registerProxy(name, getApp)
+import { newFakeAdvForms as maker} from './fakeadvforms.js'
+import { lazyLoaderApp } from '../common/lazyloader.js'
 
-}
+let _app = null;
+_app = lazyLoaderApp(_app, 'Forms', maker)

package/src/services/advgmail/app.js

@@ -0,0 +1,11 @@
+
+
+/**
+ * the idea here is to create an empty global entry for the singleton
+ * but only load it when it is actually used.
+ */
+import { newFakeAdvGmail as maker} from './fakeadvgmail.js'
+import { lazyLoaderApp } from '../common/lazyloader.js'
+
+let _app = null;
+_app = lazyLoaderApp(_app, 'Gmail', maker)

package/src/services/advgmail/fakeadvgmail.js

@@ -0,0 +1,39 @@
+
+/**
+ * Advanced gmail service
+ */
+import { Proxies } from '../../support/proxies.js';
+import { newFakeAdvGmailUsers } from './fakeadvgmailusers.js';
+import { advClassMaker } from '../../support/helpers.js';
+import { gmailCacher } from '../../support/gmailcacher.js';
+
+const propsList = {  "newModifyMessageRequest": ["addLabelIds", "removeLabelIds"], "newObliterateCseKeyPairRequest": [], "newFilter": ["action", "criteria", "id"], "newHardwareKeyMetadata": ["description"], "newImapSettings": ["autoExpunge", "enabled", "expungeBehavior", "maxFolderSize"], "newDisableCseKeyPairRequest": [], "newFilterAction": ["addLabelIds", "forward", "removeLabelIds"], "newMessagePartHeader": ["name", "value"], "newVacationSettings": ["enableAutoReply", "endTime", "responseBodyHtml", "responseBodyPlainText", "responseSubject", "restrictToContacts", "restrictToDomain", "startTime"], "newFilterCriteria": ["excludeChats", "from", "hasAttachment", "negatedQuery", "query", "size", "sizeComparison", "subject", "to"], "newModifyThreadRequest": ["addLabelIds", "removeLabelIds"], "newSmimeInfo": ["encryptedKeyPassword", "expiration", "id", "isDefault", "issuerCn", "pem", "pkcs12"], "newMessage": ["historyId", "id", "internalDate", "labelIds", "payload", "raw", "sizeEstimate", "snippet", "threadId"], "newMessagePartBody": ["attachmentId", "data", "size"], "newBatchDeleteMessagesRequest": ["ids"], "newCsePrivateKeyMetadata": ["hardwareKeyMetadata", "kaclsKeyMetadata", "privateKeyMetadataId"], "newAutoForwarding": ["disposition", "emailAddress", "enabled"], "newLabelColor": ["backgroundColor", "textColor"], "newLanguageSettings": ["displayLanguage"], "newBatchModifyMessagesRequest": ["addLabelIds", "ids", "removeLabelIds"], "newForwardingAddress": ["forwardingEmail", "verificationStatus"], "newSignAndEncryptKeyPairs": ["encryptionKeyPairId", "signingKeyPairId"], "newSendAs": ["displayName", "isDefault", "isPrimary", "replyToAddress", "sendAsEmail", "signature", "smtpMsa", "treatAsAlias", "verificationStatus"], "newSmtpMsa": ["host", "password", "port", "securityMode", "username"], "newMessagePart": ["body", "filename", "headers", "mimeType", "partId", "parts"], "newLabel": ["color", "id", "labelListVisibility", "messageListVisibility", "messagesTotal", "messagesUnread", "name", "threadsTotal", "threadsUnread", "type"], "newWatchRequest": ["labelFilterAction", "labelFilterBehavior", "labelIds", "topicName"], "newKaclsKeyMetadata": ["kaclsData", "kaclsUri"], "newEnableCseKeyPairRequest": [], "newDraft": ["id", "message"], "newPopSettings": ["accessWindow", "disposition"], "newDelegate": ["delegateEmail", "verificationStatus"], "newCseIdentity": ["emailAddress", "primaryKeyPairId", "signAndEncryptKeyPairs"], "newCseKeyPair": ["disableTime", "enablementState", "keyPairId", "pem", "pkcs7", "privateKeyMetadata", "subjectEmailAddresses"] }
+
+
+class FakeAdvGmail {
+  constructor() {
+    this.__fakeObjectType = "Gmail"
+
+    Reflect.ownKeys(propsList).forEach(p => {
+      this[p] = () => advClassMaker(propsList[p])
+    })
+
+  }
+  toString() {
+    return 'AdvancedServiceIdentifier{name=gmail, version=v1}'
+  }
+
+  getVersion() {
+    return 'v1'
+  }
+
+  get Users() {
+    return newFakeAdvGmailUsers(this)
+  }
+
+  __getGmailPerformance() {
+    return gmailCacher.getPerformance()
+  }
+}
+
+export const newFakeAdvGmail = (...args) => Proxies.guard(new FakeAdvGmail(...args))

package/src/services/advgmail/fakeadvgmaillabels.js

@@ -0,0 +1,119 @@
+import { FakeAdvResource } from '../common/fakeadvresource.js';
+import { Proxies } from '../../support/proxies.js';
+import { gError, normalizeSerialization } from '../../support/helpers.js';
+import { Syncit } from '../../support/syncit.js';
+
+export const newFakeAdvGmailLabels = (...args) => Proxies.guard(new FakeAdvGmailLabels(...args));
+
+class FakeAdvGmailLabels extends FakeAdvResource {
+  constructor(mainService) {
+    super(mainService, 'users', Syncit.fxGmail);
+    this.gmail = mainService;
+    this.__fakeObjectType = 'Gmail.Users.Labels';
+  }
+
+  /**
+   * Creates a new label.
+   * @param {object} resource - The label resource to create.
+   * @param {string} userId - The user's email address. The special value me can be used to indicate the authenticated user.
+   * @returns {object} The created label resource.
+   */
+  create(resource, userId) {
+    const { data, response } = this._call(
+      'create',
+      { userId, requestBody: normalizeSerialization(resource) },
+      null,
+      'labels'
+    );
+    gError(response, 'gmail', 'users.labels.create');
+    return data;
+  }
+
+  /**
+   * Deletes the specified label.
+   * @param {string} userId - The user's email address. The special value me can be used to indicate the authenticated user.
+   * @param {string} id - The ID of the label to delete.
+   */
+  remove(userId, id) {
+    const { data, response } = this._call(
+      'delete',
+      { userId, id },
+      null,
+      'labels'
+    );
+    gError(response, 'gmail', 'users.labels.delete');
+    return data;
+  }
+
+  /**
+   * Gets the specified label.
+   * @param {string} userId - The user's email address. The special value me can be used to indicate the authenticated user.
+   * @param {string} id - The ID of the label to retrieve.
+   * @returns {object} The label resource.
+   */
+  get(userId, id) {
+    const { data, response } = this._call(
+      'get',
+      { userId, id },
+      null,
+      'labels'
+    );
+    gError(response, 'gmail', 'users.labels.get', true);
+    return data;
+  }
+
+  /**
+   * Lists all labels in the user's mailbox.
+   * @param {string} userId - The user's email address. The special value me can be used to indicate the authenticated user.
+   * @param {object} params - The parameters for the request.
+   * @returns {object} A list of labels.
+   */
+  list(userId, params = {}) {
+    const { data, response } = this._call(
+      'list',
+      { ...params, userId },
+      null,
+      'labels'
+    );
+    gError(response, 'gmail', 'users.labels.list');
+    return data;
+  }
+
+  /**
+   * Updates the specified label. This method supports patch semantics.
+   * @param {string} userId - The user's email address. The special value me can be used to indicate the authenticated user.
+   * @param {object} resource - The label resource to update.
+   * @param {object} [params={}] - The parameters for the request.
+   * @param {string} params.id - The ID of the label to update.
+   * @returns {object} The updated label resource.
+   */
+  patch(userId, resource, params = {}) {
+    const { data, response } = this._call(
+      'patch',
+      { ...params, userId, requestBody: normalizeSerialization(resource) },
+      null,
+      'labels'
+    );
+    gError(response, 'gmail', 'users.labels.patch');
+    return data;
+  }
+
+  /**
+   * Updates the specified label.
+   * @param {string} userId - The user's email address. The special value me can be used to indicate the authenticated user.
+   * @param {object} resource - The label resource to update.
+   * @param {object} [params={}] - The parameters for the request.
+   * @param {string} params.id - The ID of the label to update.
+   * @returns {object} The updated label resource.
+   */
+  update(userId, resource, params = {}) {
+    const { data, response } = this._call(
+      'update',
+      { ...params, userId, requestBody: normalizeSerialization(resource) },
+      null,
+      'labels'
+    );
+    gError(response, 'gmail', 'users.labels.update');
+    return data;
+  }
+}