backend-manager 3.2.96 → 3.2.97

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backend-manager",
-  "version": "3.2.96",
+  "version": "3.2.97",
   "description": "Quick tools for developing Firebase functions",
   "main": "src/manager/index.js",
   "bin": {
@@ -36,6 +36,7 @@
   "dependencies": {
     "@firebase/rules-unit-testing": "^2.0.7",
     "@google-cloud/storage": "^7.9.0",
+    "@octokit/rest": "^19.0.13",
     "@sendgrid/mail": "^7.7.0",
     "@sentry/node": "^6.19.7",
     "busboy": "^1.6.0",
@@ -71,4 +72,4 @@
     "wonderful-log": "^1.0.5",
     "yargs": "^17.7.2"
   }
-}
+}

package/src/manager/functions/core/actions/api/general/fetch-post.js

@@ -0,0 +1,95 @@
+const { Octokit } = require('@octokit/rest');
+
+function Module() {
+
+}
+
+Module.prototype.main = function () {
+  const self = this;
+  const Manager = self.Manager;
+  const Api = self.Api;
+  const assistant = self.assistant;
+  const payload = self.payload;
+
+  return new Promise(async function(resolve, reject) {
+    // Setup Octokit
+    const octokit = new Octokit({
+      auth: Manager?.config?.github?.key,
+    });
+
+    // Setup options
+    payload.data.payload.url = payload.data.payload.url || '';
+
+    // Check for required parameters
+    if (!payload.data.payload.url) {
+      return reject(assistant.errorify(`Missing required parameter: url`, {code: 400}));
+    }
+
+    let url;
+    try {
+      url = new URL(payload.data.payload.url);
+    } catch (e) {
+      return reject(assistant.errorify(`Invalid URL`, {code: 400}));
+    }
+
+    // Get the post
+    const filename = url.pathname.replace(/blog|\//ig, '')
+    const repoInfo = assistant.parseRepo(self?.Manager?.config?.github?.repo_website);
+    const query = `title+repo:${repoInfo.user}/${repoInfo.name}+filename:${filename}`;
+
+    assistant.log('Running search', query, repoInfo);
+
+    // Using octokit, search the repo for the file matching the url
+    // https://stackoverflow.com/questions/25564760/how-can-i-search-file-name-in-specific-github-repository
+    // https://docs.github.com/en/search-github/searching-on-github/searching-code#search-by-filename
+    const results = await octokit.rest.search.code({
+      q: query,
+    }).catch(e => e);
+
+    // Log
+    assistant.log('Results', results);
+
+    // Check for errors
+    if (results instanceof Error) {
+      return reject(assistant.errorify(`Error searching for post: ${results}`, {code: 500}));
+    } else if (results?.data?.total_count === 0) {
+      return reject(assistant.errorify(`Post not found`, {code: 404}));
+    }
+
+    // Get the first results
+    const firstResult = results.data.items[0];
+
+    // Fetch the content of the post
+    const post = await octokit.rest.repos.getContent({
+      owner: repoInfo.user,
+      repo: repoInfo.name,
+      path: firstResult.path,
+    }).catch(e => e);
+
+
+    // Log
+    assistant.log('Post', post);
+
+    // Check for errors
+    if (post instanceof Error) {
+      return reject(assistant.errorify(`Error fetching post: ${post}`, {code: 500}));
+    }
+
+    // Decode the content
+    const fullContent = Buffer.from(post.data.content, 'base64').toString();
+    const splitContent = fullContent.split('---');
+    const frontmatter = splitContent[1].trim();
+    const body = splitContent.slice(2).join('---').trim();
+
+    // Return
+    return resolve({
+      data: {
+        frontmatter: frontmatter,
+        body: body,
+      }
+    });
+  });
+
+};
+
+module.exports = Module;

package/src/manager/functions/core/actions/api/test/run-hook.js

@@ -0,0 +1,52 @@
+function Module() {
+
+}
+
+Module.prototype.main = function () {
+  const self = this;
+  const Manager = self.Manager;
+  const Api = self.Api;
+  const assistant = self.assistant;
+  const payload = self.payload;
+
+  return new Promise(async function(resolve, reject) {
+    // Log
+    assistant.log('assistant.cwd', assistant.cwd)
+
+    // If not dev, quit
+    if (!assistant.isDevelopment()) {
+      return reject(assistant.errorify(`This command is only available in development mode`, {code: 401}));
+    }
+
+    // Check for required options
+    if (!payload.data.payload.path) {
+      return reject(assistant.errorify(`Missing required parameter: path`, {code: 400}));
+    }
+
+    // Load the hook
+    let hook;
+    try {
+      hook = (new (require(pathify(`${assistant.cwd}/${payload.data.payload.path}.js`)))()).main(Manager);
+    } catch (e) {
+      hook = (new (require(pathify(`${assistant.cwd}/methods/hooks/${payload.data.payload.path}.js`)))()).main(Manager);
+    }
+
+    //
+    if (payload.data.payload.status >= 200 && payload.data.payload.status <= 299) {
+      return resolve({data: payload.data.payload.response, status: payload.data.payload.status});
+    } else if (payload.data.payload.status >= 400 && payload.data.payload.status <= 599) {
+      return reject(assistant.errorify(payload.data.payload.response || 'Unknown error message provided', {code: payload.data.payload.status}));
+    }
+  });
+};
+
+function pathify(path) {
+  const fixed =  path
+    // Replace .js
+    .replace('.js', '')
+
+  // Return
+  return `${fixed}.js`;
+}
+
+module.exports = Module;

package/src/manager/helpers/analytics.js

@@ -1,235 +1,421 @@
-// const ua = require('universal-analytics');
-const get = require('lodash/get');
 const fetch = require('wonderful-fetch');
-
-const uuidRegex = /[0-9a-fA-F]{8}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{12}/;
+const moment = require('moment');
 let uuidv5;
 
-const BLACKLISTED_USER_AGENTS = new RegExp([
-  /(node-fetch)/,
-].map(r => r.source).join(''));
+const UUID_REGEX = /[0-9a-fA-F]{8}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{12}/;
+const BLOCKED_USER_AGENTS = [
+  /(node-fetch)/ig,
+];
 
 function Analytics(Manager, options) {
   const self = this;
-  self.Manager = Manager;
-  // self._request = self.Manager._inner || {};
 
-  // Set id and secret
-  // const analyticsId = get(self.Manager, 'config.google_analytics.id', undefined);
-  self.analyticsId = self?.Manager?.config?.google_analytics?.id;
-  self.analyticsSecret = self?.Manager?.config?.google_analytics?.secret;
+  // Set initialized
+  self.initialized = false;
 
   // Fix options
   options = options || {};
 
   // Set properties
-  self._assistant = options.assistant || Manager.Assistant();
-  self._request = {
-    ip: get(self._assistant, 'request.geolocation.ip', '127.0.0.1'),
-    country: get(self._assistant, 'request.geolocation.country', ''),
-    referrer: get(self._assistant, 'request.referrer', ''),
-    userAgent: get(self._assistant, 'request.client.userAgent', ''),
-    name: get(self._assistant, 'meta.name', ''),
+  self.Manager = Manager;
+  self.assistant = options?.assistant || Manager.Assistant();
+
+  // Set request properties
+  self.request = {
+    ip: self.assistant?.request?.geolocation?.ip || '127.0.0.1',
+    country: self.assistant?.request?.geolocation?.country || '',
+    city: self.assistant?.request?.geolocation?.city || '',
+    referrer: self.assistant?.request?.referrer || '',
+    userAgent: self.assistant?.request?.client?.userAgent || '',
+    language: (self.assistant?.request?.client?.language || '').split(',')[0],
+    mobile: self.assistant?.request?.client?.mobile || false,
+    platform: self.assistant?.request?.client?.platform || '',
+    name: self.assistant?.meta?.name || '',
   }
 
-  self._request.userAgent = self._request.userAgent.match(BLACKLISTED_USER_AGENTS) ? '' : self._request.userAgent;
+  // Remove blacklisted user agents
+  self.request.userAgent = BLOCKED_USER_AGENTS.some((regex) => self.request.userAgent.match(regex))
+    ? ''
+    : self.request.userAgent;
 
-  self._data_soruce = 'server';
-  self._uuid = options.uuid || self._request.ip || self.Manager.SERVER_UUID;
-  self._uuid = self._uuid.match(uuidRegex) ? self._uuid : self.generateId(self._uuid);
-  self._debug = typeof options.debug === 'undefined' ? self._assistant.isDevelopment() : options.debug;
-  self._pageview = typeof options.pageview === 'undefined' ? true : options.pageview;
-  self._version = self.Manager.package.version;
-  self._initialized = false;
+  // Fix options
+  options.dataSource = options.dataSource || 'server';
+  options.uuid = options.uuid || self.request.ip || Manager.SERVER_UUID;
+  options.isDevelopment = typeof options.isDevelopment === 'undefined' ? self.assistant.isDevelopment() : options.isDevelopment;
+  options.pageview = typeof options.pageview === 'undefined' ? true : options.pageview;
+  options.version = options.version || Manager.package.version;
+  options.userProperties = options.userProperties || {};
+
+  // Set user
+  // https://www.optimizesmart.com/how-to-create-and-use-user-properties-in-ga4/
+  // https://developers.google.com/analytics/devguides/collection/protocol/ga4/user-properties?client_type=gtag
+  // https://support.google.com/analytics/answer/12980150?hl=en&co=GENIE.Platform%3DAndroid
+  const authUser = self.assistant?.usage?.user;
+  self.user = {
+    app_version: {
+      value: options.version,
+    },
+    // browser: {
+    //   value: self.request.userAgent,
+    // },
+    device_category: {
+      value: self.request.mobile ? 'mobile' : 'desktop',
+    },
+    // device_model: {
+    //   value: 'None',
+    // },
+    operating_system: {
+      value: self.request.platform,
+    },
+    // os_version: {
+    //   value: 'None',
+    // },
+    // os_with_version: {
+    //   value: 'None',
+    // },
+    platform: {
+      value: 'web',
+    },
+    // screen_resolution: {
+    //   value: 'None',
+    // },
+    age: {
+      value: authUser?.personal?.birthday?.timestampUNIX
+        ? new Date().getFullYear() - new Date(authUser?.personal?.birthday?.timestampUNIX).getFullYear()
+        : 'None',
+    },
+    country: {
+      value: self.request.country
+    },
+    city: {
+      value: self.request.city
+    },
+    gender: {
+      value: authUser?.personal?.gender
+        ? authUser?.personal?.gender
+        : 'None',
+    },
+    // interests: {
+    //   value: 'None',
+    // },
+    language: {
+      value: self.request.language,
+    },
+
+    // TODO
+    // Add custom events for user properties, like plan ID, etc, draw from self.assistant.usage, etc
+    authenticated: {
+      value: authUser?.auth?.uid ? true : false,
+    },
+    plan_id: {
+      value: authUser?.plan?.id || 'basic',
+    },
+    plan_trial_activated: {
+      value: authUser?.plan?.trial?.activated || false,
+    },
+    activity_created: {
+      value: moment(authUser?.activity?.created?.timestampUNIX
+        ? authUser?.activity?.created?.timestamp
+        : self.assistant.meta.startTime.timestamp).format('YYYY-MM-DD'),
+    },
+
+    // ds? 'app
+    // uid?
+    // uip?
+    // ua?
+    // dr? (referrer)
+  };
+
+  // Merge user properties
+  self.user = {
+    ...self.user,
+    ...options.userProperties,
+  };
+
+  // Set id and secret
+  self.analyticsId = self?.Manager?.config?.google_analytics?.id;
+  self.analyticsSecret = self?.Manager?.config?.google_analytics?.secret;
 
+  // Check if we have the required properties
   if (!self.analyticsId) {
-    self._assistant.log('analytics(): Not initializing because missing analyticsId', self.analyticsId);
+    self.assistant.log('analytics(): Not initializing because missing analyticsId', self.analyticsId);
     return self;
   } else if (!self.analyticsSecret) {
-    self._assistant.log('analytics(): Not initializing because missing analyticsSecret', self.analyticsSecret);
+    self.assistant.log('analytics(): Not initializing because missing analyticsSecret', self.analyticsSecret);
     return self;
   }
 
-  // self.user = ua(self.analyticsId, self._uuid, {
-  //   strictCidFormat: false, // https://analytics.google.com/analytics/web/#/report-home/a104885300w228822596p215709578
-  // });
-  // self.user.set('ds', 'app');
+  // Automatically convert the supplied uuid to a valid uuid (in case the user supplies something else like an IP or email)
+  options.uuid = options.uuid.match(UUID_REGEX)
+    ? options.uuid
+    : self.generateId(options.uuid);
 
-  // // https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters#sc
-  // if (self._uuid) {
-  //   self.user.set('uid', self._uuid);
-  // }
-  // if (self._request.ip) {
-  //   self.user.set('uip', encodeURIComponent(self._request.ip));
-  // }
-  // if (self._request.userAgent) {
-  //   self.user.set('ua', encodeURIComponent(self._request.userAgent));
-  // }
-  // if (self._request.referrer) {
-  //   self.user.set('dr', encodeURIComponent(self._request.referrer));
-  // }
+  // Attach options
+  self.options = options;
 
-  self._initialized = true;
+  // Set initialized
+  self.initialized = true;
 
-  if (self._pageview) {
-    self.pageview({
-      path: self._request.name,
-      location: self._request.name,
-      host: self._request.name,
-      title: self._request.name,
-    })
-  }
+  // Send pageview if enabled
+  // .. Removed
 
+  // Return
   return self;
 }
 
 Analytics.prototype.generateId = function (id) {
   const self = this;
-  uuidv5 = uuidv5 || require('uuid').v5;
-  let namespace = get(self.Manager, 'config.backend_manager.namespace', undefined);
-
-  return id && namespace ? uuidv5(id, namespace) : undefined;
-};
-
-// Disabled because we are using the Measurement Protocol (12/19/2023)
-Analytics.prototype.pageview = function (options) {
-  // const self = this;
-  // options = options || {};
-  // options.path = options.path || self._request.name;
-  // options.location = options.location || self._request.name;
-  // options.host = options.host || self._request.name;
-  // options.title = options.title || self._request.name;
-
-  // if (!self._initialized) {
-  //   return self;
-  // } else if (self._debug) {
-  //   self._assistant.log('analytics(): Skipping Analytics.pageview() because in development', self._uuid, options);
-  //   return self;
-  // }
+  const Manager = self.Manager;
+  const assistant = self.assistant;
+  const options = self.options;
+  const request = self.request;
+  const user = self.user;
 
-  // // self.user.pageview({
-  // //   dp: options.path,
-  // //   dl: options.location,
-  // //   dh: options.host,
-  // //   dt: options.title,
-  // // }).send();
+  // Load uuidv5
+  uuidv5 = uuidv5 || require('uuid').v5;
 
-  // // self.send();
+  // Get namespace
+  const namespace = Manager?.config?.backend_manager?.namespace || undefined;
 
-  // return self;
+  // Generate id
+  return id && namespace
+    ? uuidv5(id, namespace)
+    : undefined;
 };
 
-Analytics.prototype.event = function (options) {
+Analytics.prototype.event = function (payload) {
   const self = this;
-
-  // Fix options
-  options = options || {};
-
-  if (!self._initialized) {
+  const Manager = self.Manager;
+  const assistant = self.assistant;
+  const options = self.options;
+  const request = self.request;
+  const user = self.user;
+
+  // Fix payload
+  // https://support.google.com/analytics/answer/13316687?hl=en#zippy=%2Cweb
+  // https://support.google.com/analytics/answer/9268042?sjid=4476481583372132143-NC
+  // https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference/events#screen_view
+  payload = payload || {};
+  payload.name = (payload.name || '')
+    // Replace slashes and spaces with underscores
+    .replace(/\/| /g, '_')
+    // Remove leading and trailing underscores
+    .replace(/^_+|_+$/g, '')
+    // Remove multiple underscores
+    .replace(/_+/g, '_');
+  payload.params = payload.params || {};
+
+  // Check if initialized
+  if (!self.initialized) {
     return self;
-  } else if (self._debug) {
-    self._assistant.log('analytics(): Skipping Analytics.event() because in development', self._uuid, options);
+  } else if (options.isDevelopment) {
+    assistant.log('analytics().event(): Skipping because in development', options.uuid, JSON.stringify(payload));
     return self;
   }
 
-  // self.user.event({
-  //   ec: options.category,
-  //   ea: options.action,
-  //   el: options.label,
-  //   ev: options.value,
-  //   // dp: options.path || window.location.href,
-  // }).send();
-
-  self.send({
-    name: options.name,
-    params: options.params
-  });
-
-  return self;
-};
-
-Analytics.prototype.send = function (event) {
-  const self = this;
-
-  if (!self._initialized) {
-    return self;
-  } else if (self._debug) {
-    self._assistant.log('analytics(): Skipping Analytics.event() because in development', self._uuid, event);
-    return self;
-  }
+  // https://stackoverflow.com/questions/71871458/how-to-send-user-properties-to-measurement-protocol-google-analytics-4
+
+  // USer properties
+  // https://developers.google.com/analytics/devguides/collection/protocol/ga4/user-properties?client_type=gtag
+
+  // raw
+  // https://stackoverflow.com/questions/69105735/google-analytics-4-measurement-protocol-api-used-without-gtag-js-or-firebase
+
+  // Fix payload
+  payload.params.event_source = options.dataSource;
+  payload.params.page_location = request.name; // Supposed to be domain
+  // payload.params.page_location = `${INSERT DOMAIN HERE}${request.name}`; // Supposed to be domain
+  payload.params.page_title = request.name; // Supposed to be title
+  payload.params.ip_override = request.ip;
+  payload.params.user_agent = request.userAgent;
+  payload.params.page_referrer = request.referrer;
+  // https://stackoverflow.com/questions/70708893/google-analytics-4-measurement-protocol-shows-events-but-no-users/71811327#71811327
+  payload.params.engagement_time_msec = new Date().getTime() - new Date(assistant.meta.startTime.timestamp).getTime();
+  // payload.params.engagement_time_msec = 1;
+  payload.params.debug_mode = false;
+  payload.params.session_id = assistant.id;
+  // payload.params.campaign = 'your_campaign';
+  // payload.params.source = 'your_source';
+  // payload.params.medium = 'your_medium';
+  // payload.params.term = 'your_term';
+  // payload.params.content = 'your_content';
+
+
+  // https://stackoverflow.com/questions/75998626/city-is-not-populating-in-ga4-measurement-protocol-api
+  // {
+  //     "client_id": "6909975079.1681323722",
+  //     "events": [
+  //         {
+  //             "name": "page_view",
+  //             "params": {
+  //                 "page_title": "Wedding: QR Code",
+  //                 "hostname": "scan.example.com",
+  //                 "landing_page": "/eRCU",
+  //                 "page_location": "https://scan.example.com/eRCU",
+  //                 "page_referrer": "https://scan.example.com/eRCU",
+  //                 "city": "Mumbai",
+  //                 "continent_code": "AS",
+  //                 "country_code": "IN",
+  //                 "country": "India",
+  //                 "latitude": "19.0748",
+  //                 "longitude": "72.8856",
+  //                 "session_id": 1681313623,
+  //                 "engagement_time_msec": 264,
+  //                 "ip_address": "XX.36.XXX.14"
+  //             }
+  //         }
+  //     ]
+  // }
 
-  /*
-    https://stackoverflow.com/questions/68773179/what-should-the-client-id-be-when-sending-events-to-google-analytics-4-using-the
-    https://developers.google.com/analytics/devguides/collection/protocol/ga4/sending-events?client_type=gtag
-
-
-    https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters#sc
-    https://developers.google.com/analytics/devguides/collection/protocol/ga4/sending-events?client_type=gtag#recommended_parameters_for_reports
-    https://stackoverflow.com/questions/43049662/how-to-send-measurement-protocol-if-there-is-no-clientid
-
-    https://developers.google.com/analytics/devguides/collection/protocol/ga4/validating-events?client_type=gtag
-    https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference?client_type=gtag
-    https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference/events
-    https://developers.google.com/analytics/devguides/collection/protocol/ga4/ua-feature-matrix
-  */
-
-  // Format event
-  event = event || {};
-  event.name = event.name || '';
-  event.timestamp_micros = new Date().getTime() * 1000,
-  event.params = event.params || {};
-  event.params.session_id = self._assistant.id;
-  event.params.engagement_time_msec = `${new Date().getTime() - new Date(self._assistant.meta.startTime.timestamp).getTime()}`;
-  event.params.event_source = self._data_soruce;
-  event.params.ip_override = self._request.ip;
-  event.params.user_agent = self._request.userAgent;
-  event.params.page_location = self._request.name;
-  event.params.page_referrer = self._request.referrer;
-  event.params.page_title = self._request.name;
-
-  // "event_source": "server",
-  // "page_location": "https:\/\/www.yourdomain.com\/page2",
-  // "page_referrer": "\/page1",
-  // "page_title": "Page 2",
-  // "ip_override": "xxx.xxx.xxx.0",
-  // "campaign": "your_campaign",
-  // "source": "your_source",
-  // "medium": "your_medium",
-  // "term": "your_term",
-  // "content": "your_content"
 
+  // Build url and body
+  const url = `https://www.google-analytics.com/mp/collect?measurement_id=${self.analyticsId}&api_secret=${self.analyticsSecret}`;
   const body = {
-    client_id: self._uuid,
-    user_id: self._uuid,
-    // ip_override: self._request.ip,
-    // user_agent: self._request.userAgent,
-    events: [event],
+    client_id: self.options.uuid,
+    user_id: self.options.uuid,
+    // timestamp_micros: new Date().getTime() * 1000,
+    user_properties: user,
+    // consent: {},
+    // non_personalized_ads: false,
+    events: [payload],
   }
 
-  // Log
-  if (self._assistant.isDevelopment()) {
-    self._assistant.log('analytics().send(): Sending...', JSON.stringify(body));
+  // Log full payload
+  if (assistant.isDevelopment()) {
+    assistant.log('analytics().event(): Sending...', url, JSON.stringify(body));
   }
 
   // Send event
-  fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${self.analyticsId}&api_secret=${self.analyticsSecret}`, {
-  // fetch(`https://www.google-analytics.com/debug/mp/collect?measurement_id=${self.analyticsId}&api_secret=${self.analyticsSecret}`, {
+  fetch(url, {
     method: 'post',
     response: 'text',
     tries: 2,
     timeout: 30000,
+    // headers: {
+    //   "Content-Type": "application/json"
+    // },
     body: body,
   })
   .then((r) => {
-    if (self._assistant.isDevelopment()) {
-      self._assistant.log('analytics().send(): Success', r);
+    if (assistant.isDevelopment()) {
+      assistant.log('analytics().event(): Success', r);
     }
   })
   .catch((e) => {
-    self._assistant.error('analytics().send(): Failed', e);
+    assistant.error('analytics().event(): Failed', e);
   });
 
+  // Return
   return self;
 };
 
+
+
+
+// Analytics.prototype.send = function (event) {
+//   const self = this;
+
+//   // Check if initialized
+//   if (!self.initialized) {
+//     return self;
+//   } else if (self.options.isDevelopment) {
+//     assistant.log('analytics(): Skipping Analytics.event() because in development', self.options.uuid, event);
+//     return self;
+//   }
+
+//   /*
+//     https://stackoverflow.com/questions/68773179/what-should-the-client-id-be-when-sending-events-to-google-analytics-4-using-the
+//     https://developers.google.com/analytics/devguides/collection/protocol/ga4/sending-events?client_type=gtag
+
+
+//     https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters#sc
+//     https://developers.google.com/analytics/devguides/collection/protocol/ga4/sending-events?client_type=gtag#recommended_parameters_for_reports
+//     https://stackoverflow.com/questions/43049662/how-to-send-measurement-protocol-if-there-is-no-clientid
+
+//     https://developers.google.com/analytics/devguides/collection/protocol/ga4/validating-events?client_type=gtag
+//     https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference?client_type=gtag
+//     https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference/events
+//     https://developers.google.com/analytics/devguides/collection/protocol/ga4/ua-feature-matrix
+//   */
+
+
+//  /*
+
+//   */
+
+//   // Format event
+//   // event = event || {};
+//   // event.name = event.name || '';
+//   // event.params = event.params || {};
+//   // event.params.engagement_time_msec = `${new Date().getTime() - new Date(self.assistant.meta.startTime.timestamp).getTime()}`;
+//   // event.params.event_source = self.options.dataSource;
+//   // event.params.ip_override = self.request.ip;
+//   // event.params.user_agent = self.request.userAgent;
+//   // event.params.page_location = self.request.name;
+//   // event.params.page_referrer = self.request.referrer;
+//   // event.params.page_title = self.request.name;
+
+//   event = event || {};
+//   event.name = event.name || '';
+//   event.params = event.params || {};
+//   // event.params.session_id = self.assistant.id;
+//   // event.params.engagement_time_msec = `${new Date().getTime() - new Date(self.assistant.meta.startTime.timestamp).getTime()}`;
+//   // event.params.event_source = self.options.dataSource;
+//   // event.params.ip_override = self.request.ip;
+//   // event.params.user_agent = self.request.userAgent;
+//   // event.params.page_location = self.request.name;
+//   // event.params.page_referrer = self.request.referrer;
+//   // event.params.page_title = self.request.name;
+
+//   // "event_source": "server",
+//   // "page_location": "https:\/\/www.yourdomain.com\/page2",
+//   // "page_referrer": "\/page1",
+//   // "page_title": "Page 2",
+//   // "ip_override": "xxx.xxx.xxx.0",
+//   // "campaign": "your_campaign",
+//   // "source": "your_source",
+//   // "medium": "your_medium",
+//   // "term": "your_term",
+//   // "content": "your_content"
+
+//   const url = `https://www.google-analytics.com/mp/collect?measurement_id=${self.analyticsId}&api_secret=${self.analyticsSecret}`;
+//   const body = {
+//     client_id: self.options.uuid,
+//     user_id: self.options.uuid,
+//     // timestamp_micros: new Date().getTime() * 1000,
+//     user_properties: {},
+//     // consent: {},
+//     // non_personalized_ads: false,
+//     events: [event],
+//   }
+
+//   // Log
+//   if (self.assistant.isDevelopment()) {
+//     assistant.log('analytics().send(): Sending...', url, JSON.stringify(body));
+//   }
+
+//   // Send event
+//   fetch(url, {
+//   // fetch(`https://www.google-analytics.com/debug/mp/collect?measurement_id=${self.analyticsId}&api_secret=${self.analyticsSecret}`, {
+//     method: 'post',
+//     response: 'text',
+//     tries: 2,
+//     timeout: 30000,
+//     // headers: {
+//     //   "Content-Type": "application/json"
+//     // },
+//     body: body,
+//   })
+//   .then((r) => {
+//     if (self.assistant.isDevelopment()) {
+//       assistant.log('analytics().send(): Success', r);
+//     }
+//   })
+//   .catch((e) => {
+//     self.assistant.error('analytics().send(): Failed', e);
+//   });
+
+//   return self;
+// };
+
 module.exports = Analytics;

package/src/manager/helpers/settings.js

@@ -53,7 +53,17 @@ Settings.prototype.resolve = function (assistant, schema, settings) {
     // assistant.log('resolvedValue:', resolvedValue);
 
     // Check if this node is marked as required
-    if (schemaNode.required && typeof originalValue === 'undefined') {
+    let isRequired = false;
+    if (typeof schemaNode.required === 'function') {
+      isRequired = schemaNode.required(assistant);
+    } else if (typeof schemaNode.required === 'boolean') {
+      isRequired = schemaNode.required;
+    }
+
+    // assistant.log('isRequired:', isRequired);
+
+    // If the key is required and the original value is undefined, throw an error
+    if (isRequired && typeof originalValue === 'undefined') {
       throw assistant.errorify(`Required key {${path}} is missing in settings`, {code: 400});
     }
 

package/src/manager/index.js

@@ -436,6 +436,7 @@ Manager.prototype.init = function (exporter, options) {
     self.storage();
   }
 
+  // Fetch stats
   if (self.assistant.isDevelopment() && options.fetchStats) {
     setTimeout(function () {
       self.assistant.log('Fetching meta/stats...');
@@ -445,9 +446,52 @@ Manager.prototype.init = function (exporter, options) {
       .then(doc => {
         self.assistant.log('meta/stats', doc.data());
       })
-    }, 3000);
+    }, 100);
   }
 
+  // Send analytics
+  // self.Analytics({
+  //   assistant: self.assistant,
+  //   uuid: self.SERVER_UUID,
+  //   isDevelopment: false,
+  // })
+  // .event({
+  //   // category: 'admin',
+  //   // action: 'initialized',
+  //   // label: '',
+  //   // name: 'admin/initialized',
+  //   // name: 'screen_view',
+  //   // params: {
+  //   //   screen_class: 'MainActivity',
+  //   // },
+  // });
+
+  // self.Analytics({
+  //   assistant: self.assistant,
+  //   // uuid: '256675177.1692831448',
+  //   // uuid: self.SERVER_UUID,
+  //   uuid: 'a5b43c29-7bb3-514b-b7bb-33782cd8d802',
+  //   isDevelopment: false,
+  // })
+  // .event({
+  //   "name": "purchase",
+  //   "params": {
+  //     "transaction_id": "T12345",
+  //     "value": 123.45,
+  //     "currency": "USD",
+  //     "items": [
+  //       {
+  //         "item_id": "sku1234",
+  //         "item_name": "widget",
+  //         "quantity": 1,
+  //         "item_brand": "Google",
+  //         "price": 123.45
+  //       }
+  //     ]
+  //   }
+  // });
+
+  // Return
   return self;
 };