@google-cloud/nodejs-common 2.2.1 → 2.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@google-cloud/nodejs-common",
-  "version": "2.2.1",
+  "version": "2.3.0",
   "description": "A NodeJs common library for solutions based on Cloud Functions",
   "author": "Google Inc.",
   "license": "Apache-2.0",
@@ -16,28 +16,26 @@
   },
   "homepage": "https://github.com/GoogleCloudPlatform/cloud-for-marketing/blob/master/marketing-analytics/activation/common-libs/nodejs-common/README.md",
   "dependencies": {
-    "@google-cloud/aiplatform": "^3.17.0",
+    "@google-cloud/aiplatform": "^3.25.0",
     "@google-cloud/automl": "^4.0.1",
-    "@google-cloud/bigquery": "^7.5.2",
-    "@google-cloud/datastore": "^8.6.0",
-    "@google-cloud/firestore": "^7.5.0",
+    "@google-cloud/bigquery": "^7.8.0",
+    "@google-cloud/datastore": "^9.1.0",
+    "@google-cloud/firestore": "^7.9.0",
     "@google-cloud/logging-winston": "^6.0.0",
-    "@google-cloud/pubsub": "^4.3.3",
-    "@google-cloud/storage": "^7.9.0",
-    "@google-cloud/scheduler": "^4.1.0",
-    "@google-cloud/secret-manager": "^5.2.0",
-    "gaxios": "^6.3.0",
+    "@google-cloud/pubsub": "^4.5.0",
+    "@google-cloud/storage": "^7.12.0",
+    "@google-cloud/scheduler": "^4.3.0",
+    "@google-cloud/secret-manager": "^5.6.0",
+    "gaxios": "^6.7.0",
     "google-ads-nodejs-client": "16.0.0",
-    "google-ads-api": "^14.1.0",
-    "google-ads-node": "^12.0.2",
-    "google-auth-library": "^9.7.0",
-    "googleapis": "^134.0.0",
-    "winston": "^3.13.0",
-    "@grpc/grpc-js": "^1.10.5",
+    "google-auth-library": "^9.11.0",
+    "googleapis": "^140.0.1",
+    "winston": "^3.13.1",
+    "@grpc/grpc-js": "^1.11.1",
     "lodash": "^4.17.21"
   },
   "devDependencies": {
-    "jasmine": "^5.1.0"
+    "jasmine": "^5.2.0"
   },
   "scripts": {
     "test": "node node_modules/jasmine/bin/jasmine"

package/src/apis/base/google_api_client.js

@@ -16,7 +16,7 @@
  * @fileoverview A base class for Google Api client library class.
  */
 const { google } = require('googleapis');
-const { getLogger, getObjectByPath } = require('../../components/utils.js');
+const { getLogger } = require('../../components/utils.js');
 const { AuthRestfulApi } = require('./auth_restful_api.js');
 
 /**

package/src/apis/doubleclick_bidmanager.js

@@ -94,13 +94,13 @@ class DoubleClickBidManager extends GoogleApiClient {
    * Gets a query metadata.
    * See https://developers.google.com/bid-manager/reference/rest/v2/queries/get
    * @param {number} queryId Id of the query.
-   * @return {!Promise<!QueryMetadata>} Query metadata, see
-   *     https://developers.google.com/bid-manager/reference/rest/v2/queries#QueryMetadata
+   * @return {!Promise<!Query>} Query, see
+   *     https://developers.google.com/bid-manager/reference/rest/v2/queries#Query
    */
   async getQuery(queryId) {
     const doubleclickbidmanager = await this.getApiClient();
     const response = await doubleclickbidmanager.queries.get({ queryId });
-    return response.data.metadata;
+    return response.data;
   }
 
   /**

package/src/apis/gmail.js

@@ -0,0 +1,113 @@
+// Copyright 2024 Google Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/** @fileoverview Gmail API Client Library. */
+
+'use strict';
+
+const { GoogleApiClient } = require('./base/google_api_client.js');
+
+const API_SCOPES =
+  Object.freeze(['https://www.googleapis.com/auth/gmail.send']);
+const API_VERSION = 'v1';
+
+/**
+ * @typedef {{
+ *     from: string|undefined,
+ *     to: string|Array<string>,
+ *     cc: string|Array<string>|undefined,
+ *     bcc: string|Array<string>|undefined,
+ *     'reply-to': string|Array<string>|undefined,
+ *     subject: string,
+ *     content: string,
+ *     type: 'text/plain'|'text/html'|undefined,
+ * }}
+ */
+let EmailOptions;
+
+/**
+ * Email sending class based on Gmail API.
+ */
+class Gmail extends GoogleApiClient {
+
+  constructor(env = process.env) {
+    super(env);
+    this.googleApi = 'gmail';
+  }
+
+  /** @override */
+  getScope() {
+    return API_SCOPES;
+  }
+
+  /** @override */
+  getVersion() {
+    return API_VERSION;
+  }
+
+  /**
+   * Generates a string for an email in RFC 2822 format.
+   * If 'from' is different from the OAuth token's owner account, it would be
+   * ignored.
+   * @param {!EmailOptions} options
+   * @return {string}
+   * @private
+   */
+  getRawEmail_(options = {}) {
+    const message = [];
+    ['from', 'to', 'cc', 'bcc', 'reply-to', 'subject'].forEach((key) => {
+      if (options[key]) {
+        const value = Array.isArray(options[key])
+          ? options[key].join(',') : options[key];
+        message.push(`${key}: ${value}`);
+      }
+    });
+    if (message.length === 0)
+      throw new Error(`Can not get email from ${options}`);
+    message.push('\n');
+    message.push(options.content);
+    return message.join('\n');
+  }
+
+  /**
+   * Sends a simple email (no attachment).
+   * @see https://developers.google.com/gmail/api/reference/rest/v1/users.messages/send
+   * @param {!EmailOptions} options
+   * @return {!Message}
+   */
+  async sendSimpleEmail(options) {
+    const email = this.getRawEmail_(options);
+
+    const gmail = await this.getApiClient();
+    const message = {
+      userId: 'me',
+      requestBody: { raw: Buffer.from(email).toString('base64') }
+    };
+    try {
+      const response = await gmail.users.messages.send(message);
+      return { responseStatus: response.status };
+    } catch (error) {
+      this.logger.error('Result of sending an email', JSON.stringify(error));
+      return { responseStatus: error.status };
+    }
+  }
+
+}
+
+module.exports = {
+  Gmail,
+  EmailOptions,
+  API_SCOPES,
+  API_VERSION,
+};

package/src/apis/index.js

@@ -99,18 +99,6 @@ exports.doubleclickbidmanager = require('./doubleclick_bidmanager.js');
  */
 exports.bigquery = require('./bigquery.js');
 
-/**
- * APIs integration class for Google Ads.
- * @const {{
- *   GoogleAds:!GoogleAds,
- *   ConversionConfig:!ConversionConfig,
- *   CustomerMatchConfig: !CustomerMatchConfig,
- *   CustomerMatchRecord: !CustomerMatchRecord,
- *   ReportQueryConfig:!ReportQueryConfig,
- * }}
- */
-exports.googleads = require('./google_ads.js');
-
 /**
  * APIs integration class for Google Ads with Google API library.
  * @const {{
@@ -146,9 +134,7 @@ exports.measurementprotocolga4 = require('./measurement_protocol_ga4.js');
 /**
  * APIs integration class for YouTube.
  * @const {{
- *   YouTube:!YouTube,
- *   ListChannelsConfig: !ListChannelsConfig,
- *   ListVideosConfig: !ListVideosConfig,
+ *   YouTube:!YouTube
  * }}
  */
 exports.youtube = require('./youtube.js');
@@ -162,3 +148,12 @@ exports.youtube = require('./youtube.js');
 * }}
 */
 exports.sendgrid = require('./sendgrid.js');
+
+/**
+ * APIs integration class for Gmail.
+ * @const {{
+*   Gmail:!Gmail,
+*   API_VERSION: string,
+* }}
+*/
+exports.gmail = require('./gmail.js');

package/src/apis/sendgrid.js

@@ -18,12 +18,33 @@
 
 'use strict';
 
+const { EmailOptions } = require('./gmail.js');
 const { RestfulApiBase } = require('./base/restful_api_base.js');
 const { getLogger } = require('../components/utils.js');
 
 const API_VERSION = 'v3';
 const API_ENDPOINT = 'https://api.sendgrid.com';
 
+/**
+ * Returns a SendGrid email object based on a given RFC 2822 `mailbox` string.
+ * For `mailbox` @see https://www.rfc-editor.org/rfc/rfc2822#page-15
+ * @param {string} mailbox
+ * @return {{name: string, email: string}} A SendGrid email object.
+ */
+function getSendGridEmail(mailbox) {
+  if (typeof mailbox === 'string') {
+    if (mailbox.indexOf('<') > -1) {
+      const name = mailbox.substring(0, mailbox.indexOf('<')).trim();
+      const email =
+        mailbox.substring(mailbox.indexOf('<') + 1, mailbox.indexOf('>'));
+      return { name, email };
+    } else {
+      return { email: mailbox.trim() };
+    }
+  }
+  return mailbox;
+}
+
 /**
  * SendGrid API access class.
  * @see https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/authentication
@@ -48,11 +69,51 @@ class SendGrid extends RestfulApiBase {
     });
   }
 
+  /**
+   * Generates an email object for Sendgrid.
+   * @param {!EmailOptions} options
+   * @return {object}
+   * @see https://www.twilio.com/docs/sendgrid/api-reference/mail-send/mail-send#reques
+   * @private
+   */
+  getEmail_(options = {}) {
+    const {
+      from,
+      'reply-to': reply_to,
+      subject,
+      content,
+      type = 'text/plain',
+    } = options;
+    const recipientObject = {};
+    ['to', 'cc', 'bcc'].forEach((key) => {
+      if (options[key]) {
+        recipientObject[key] = [options[key]].flat().map(getSendGridEmail);
+      }
+    });
+    const email = {
+      subject,
+      content: [{ type, value: content }],
+      personalizations: [recipientObject],
+    };
+    if (from) email.from = getSendGridEmail(from);
+    //@see https://www.twilio.com/docs/sendgrid/api-reference/mail-send/mail-send#reques
+    if (reply_to) {
+      if (Array.isArray(reply_to)) {
+        email.reply_to_list = reply_to.map(getSendGridEmail);
+      } else {
+        email.reply_to = getSendGridEmail(reply_to);
+      }
+    }
+    return email;
+  }
+
   /**
    * Sends an email.
+   * @param {!EmailOptions} options
    * @see https://docs.sendgrid.com/api-reference/mail-send/mail-send
    */
-  async sendMail(email) {
+  async sendMail(options) {
+    const email = this.getEmail_(options);
     const response = await this.request('mail/send', 'POST', email);
     return response;
   }

package/src/apis/spreadsheets.js

@@ -109,21 +109,73 @@ class Spreadsheets extends GoogleApiClient {
   }
 
   /**
-   * Clears the content of the Sheet.
-   * see:
-   * https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/clear
+   * Returns whether the sheet with speicified name exists.
+   * @param {string} sheetName
+   * @return {boolean}
+   */
+  async hasSheet(sheetName) {
+    const sheets = await this.getApiClient();
+    const spreadsheet = await sheets.spreadsheets.get(
+      { spreadsheetId: this.spreadsheetId });
+    return spreadsheet.data.sheets.some(
+      ({ properties: { title } }) => title === sheetName);
+  }
+
+  /**
+   * Creates a sheet with the gvien name.
+   *
+   * @param {string} sheetName
+   */
+  async createSheet(sheetName) {
+    const sheets = await this.getApiClient();
+    await sheets.spreadsheets.batchUpdate({
+      spreadsheetId: this.spreadsheetId,
+      requestBody: {
+        requests: [{ addSheet: { properties: { title: sheetName } } }],
+      }
+    });
+  }
+
+  /**
+   * Deletes a sheet with the gvien name.
+   *
+   * @param {string} sheetName
+   */
+  async deleteSheet(sheetName) {
+    if (await this.hasSheet(sheetName)) {
+      const sheetId = await this.getSheetId(sheetName);
+      const sheets = await this.getApiClient();
+      await sheets.spreadsheets.batchUpdate({
+        spreadsheetId: this.spreadsheetId,
+        requestBody: {
+          requests: [{ deleteSheet: { sheetId } }],
+        }
+      });
+    }
+  }
+
+  /**
+   * Clears the content of the Sheet. If the Sheet doesn't exist, then creates
+   * an empty sheet with the sheetName..
+   * @see https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/clear
    * @param {string} sheetName Name of the Sheet.
    */
   async clearSheet(sheetName) {
-    const request = {
-      spreadsheetId: this.spreadsheetId,
-      range: sheetName,
-    };
     try {
-      const sheets = await this.getApiClient();
-      const response = await sheets.spreadsheets.values.clear(request);
-      const data = response.data;
-      this.logger.debug(`Clear sheet[${sheetName}}]: `, data);
+      const hasSheet = await this.hasSheet(sheetName);
+      if (!hasSheet) {
+        await this.createSheet(sheetName);
+        this.logger.debug(`Create sheet[${sheetName}]`);
+      } else {
+        const sheets = await this.getApiClient();
+        const request = {
+          spreadsheetId: this.spreadsheetId,
+          range: sheetName,
+        };
+        const response = await sheets.spreadsheets.values.clear(request);
+        const data = response.data;
+        this.logger.debug(`Clear sheet[${sheetName}]: `, data);
+      }
     } catch (error) {
       this.logger.error(error.toString());
       throw error;