@foxtware/mineral 0.1.14 → 0.1.16

package/api/google/googlecalendarCalendarsGet.js

@@ -0,0 +1,54 @@
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { getGoogleCalendar, googleApiCall } = require('../google/google.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+]);
+
+const googlecalendarCalendarsGet = async (
+  credsPayload,
+  {
+    subject,
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  const { client, error } = await getGoogleCalendar(credsPayload, { subject });
+
+  if (error) {
+    return error;
+  }
+
+  return googleApiCall(() => client.calendarList.list());
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  googlecalendarCalendarsGet,
+  funcApiConfig,
+};
+
+/*
+curl -X POST "http://localhost:8000/googlecalendarCalendarsGet" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "google" }
+  }'
+
+curl -X POST "http://localhost:8000/googlecalendarCalendarsGet" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "google" },
+    "options": { "subject": "x@y.com" }
+  }'
+*/

package/api/google/googlecalendarEventCreate.js

@@ -0,0 +1,63 @@
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { getGoogleCalendar, googleApiCall } = require('../google/google.utils');
+
+const eventDataValidator = (eventData) => {
+  return Boolean(eventData?.summary && eventData?.start && eventData?.end);
+};
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['eventData', eventDataValidator],
+]);
+
+const googlecalendarEventCreate = async (
+  credsPayload,
+  eventData,
+  {
+    subject,
+    calendarId = 'primary',
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    eventData,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  const { client, error } = await getGoogleCalendar(credsPayload, { subject });
+
+  if (error) {
+    return error;
+  }
+
+  return googleApiCall(() => client.events.insert({
+    calendarId,
+    requestBody: eventData,
+  }));
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  googlecalendarEventCreate,
+  funcApiConfig,
+};
+
+/*
+curl -X POST "http://localhost:8000/googlecalendarEventCreate" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "google" },
+    "eventData": {
+      "summary": "Meeting",
+      "start": { "dateTime": "2026-04-09T10:00:00-04:00" },
+      "end": { "dateTime": "2026-04-09T11:00:00-04:00" }
+    }
+  }'
+*/

package/api/google/googlecalendarEventDelete.js

@@ -0,0 +1,55 @@
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { getGoogleCalendar, googleApiCall } = require('../google/google.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['eventId'],
+]);
+
+const googlecalendarEventDelete = async (
+  credsPayload,
+  eventId,
+  {
+    subject,
+    calendarId = 'primary',
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    eventId,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  const { client, error } = await getGoogleCalendar(credsPayload, { subject });
+
+  if (error) {
+    return error;
+  }
+
+  return googleApiCall(() => client.events.delete({
+    calendarId,
+    eventId,
+  }));
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  googlecalendarEventDelete,
+  funcApiConfig,
+};
+
+/*
+curl -X POST "http://localhost:8000/googlecalendarEventDelete" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "google" },
+    "eventId": "abc123"
+  }'
+*/

package/api/google/googlecalendarEventGet.js

@@ -0,0 +1,55 @@
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { getGoogleCalendar, googleApiCall } = require('../google/google.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['eventId'],
+]);
+
+const googlecalendarEventGet = async (
+  credsPayload,
+  eventId,
+  {
+    subject,
+    calendarId = 'primary',
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    eventId,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  const { client, error } = await getGoogleCalendar(credsPayload, { subject });
+
+  if (error) {
+    return error;
+  }
+
+  return googleApiCall(() => client.events.get({
+    calendarId,
+    eventId,
+  }));
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  googlecalendarEventGet,
+  funcApiConfig,
+};
+
+/*
+curl -X POST "http://localhost:8000/googlecalendarEventGet" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "google" },
+    "eventId": "abc123"
+  }'
+*/

package/api/google/googlecalendarEventsGet.js

@@ -0,0 +1,65 @@
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { getGoogleCalendar, googleApiCall } = require('../google/google.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+]);
+
+const googlecalendarEventsGet = async (
+  credsPayload,
+  {
+    subject,
+    calendarId = 'primary',
+    timeMin,
+    timeMax,
+    maxResults = 50,
+    orderBy = 'startTime',
+    singleEvents = true,
+    q,
+    pageToken,
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  const { client, error } = await getGoogleCalendar(credsPayload, { subject });
+
+  if (error) {
+    return error;
+  }
+
+  return googleApiCall(() => client.events.list({
+    calendarId,
+    ...timeMin && { timeMin },
+    ...timeMax && { timeMax },
+    maxResults,
+    orderBy,
+    singleEvents,
+    ...q && { q },
+    ...pageToken && { pageToken },
+  }));
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  googlecalendarEventsGet,
+  funcApiConfig,
+};
+
+/*
+curl -X POST "http://localhost:8000/googlecalendarEventsGet" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "google" },
+    "options": { "calendarId": "primary", "maxResults": 10 }
+  }'
+*/

package/api/google/googledriveFileDelete.js

@@ -0,0 +1,53 @@
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { getGoogleDrive, googleApiCall } = require('../google/google.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['fileId'],
+]);
+
+const googledriveFileDelete = async (
+  credsPayload,
+  fileId,
+  {
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    fileId,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  const { client, error } = await getGoogleDrive(credsPayload);
+
+  if (error) {
+    return error;
+  }
+
+  return googleApiCall(() => client.files.delete({
+    supportsAllDrives: true,
+    fileId,
+  }));
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  googledriveFileDelete,
+  funcApiConfig,
+};
+
+/*
+curl -X POST "http://localhost:8000/googledriveFileDelete" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "google" },
+    "fileId": "REPLACE_FILE_ID"
+  }'
+*/

package/api/google/googledriveFileGet.js

@@ -0,0 +1,57 @@
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { getGoogleDrive, googleApiCall } = require('../google/google.utils');
+
+const defaultAttrs = 'id, name, mimeType, size, createdTime, modifiedTime, webViewLink';
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['fileId'],
+]);
+
+const googledriveFileGet = async (
+  credsPayload,
+  fileId,
+  {
+    attrs = defaultAttrs,
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    fileId,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  const { client, error } = await getGoogleDrive(credsPayload);
+
+  if (error) {
+    return error;
+  }
+
+  return googleApiCall(() => client.files.get({
+    supportsAllDrives: true,
+    fileId,
+    fields: attrs,
+  }));
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  googledriveFileGet,
+  funcApiConfig,
+};
+
+/*
+curl -X POST "http://localhost:8000/googledriveFileGet" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "google" },
+    "fileId": "1YWzBt28D9ikWpreifWwo-2xdOQ4FATcA"
+  }'
+*/

package/api/google/googledriveFileUpload.js

@@ -0,0 +1,127 @@
+const fs = require('fs').promises;
+const path = require('path');
+const { Readable } = require('stream');
+
+const { ArgsWarden, objHasAny } = require('../utils');
+const { credsValidator } = require('../validators');
+const { getGoogleDrive, googleApiCall } = require('../google/google.utils');
+
+const fileDataValidator = (fileData) => {
+  if (fileData?.filePath) {
+    return true;
+  }
+
+  return Boolean(fileData?.fileName && fileData?.fileSource !== undefined);
+};
+
+const folderIdentifierValidator = (folderIdentifier) => {
+  return objHasAny(folderIdentifier, ['folderId']);
+};
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['fileData', fileDataValidator],
+  ['folderIdentifier', folderIdentifierValidator],
+]);
+
+const googledriveFileUpload = async (
+  credsPayload,
+  fileData,
+  folderIdentifier,
+  {
+    mimeType = 'application/octet-stream',
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    fileData,
+    folderIdentifier,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  let {
+    filePath,
+    fileName,
+    fileSource,
+  } = fileData;
+
+  const { folderId } = folderIdentifier;
+
+  if (filePath) {
+    fileName = path.basename(filePath);
+    fileSource = await fs.readFile(filePath);
+  }
+
+  if (!(fileName && fileSource !== undefined)) {
+    return {
+      ok: false,
+      error: {
+        code: 'INVALID_FILE_DATA',
+        message: 'Provide filePath or fileName with fileSource',
+      },
+    };
+  }
+
+  const buffer = Buffer.isBuffer(fileSource)
+    ? fileSource
+    : Buffer.from(String(fileSource));
+
+  const { client, error } = await getGoogleDrive(credsPayload);
+
+  if (error) {
+    return error;
+  }
+
+  const uploadResponse = await googleApiCall(() => client.files.create({
+    supportsAllDrives: true,
+    requestBody: {
+      name: fileName,
+      ...folderId && { parents: [folderId] },
+    },
+    media: {
+      body: Readable.from(buffer),
+      mimeType,
+    },
+  }));
+
+  if (!uploadResponse.ok) {
+    return uploadResponse;
+  }
+
+  const uploadedFileId = uploadResponse.data.id;
+  const fileUrl = `https://drive.google.com/file/d/${ uploadedFileId }/view`;
+  const folderUrl = folderId ? `https://drive.google.com/drive/folders/${ folderId }` : null;
+
+  return {
+    ok: true,
+    data: {
+      ...uploadResponse.data,
+      customData: {
+        fileUrl,
+        ...folderUrl && { folderUrl },
+      },
+    },
+  };
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  googledriveFileUpload,
+  funcApiConfig,
+};
+
+/*
+curl -X POST "http://localhost:8000/googledriveFileUpload" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "google" },
+    "fileData": { "fileName": "hello.txt", "fileSource": "hello world" },
+    "folderIdentifier": { "folderId": "REPLACE_FOLDER_ID" }
+  }'
+*/

package/api/google/googledriveFilesGet.js

@@ -0,0 +1,72 @@
+const { ArgsWarden, objHasAny } = require('../utils');
+const { credsValidator } = require('../validators');
+const { getGoogleDrive, googleApiCall } = require('../google/google.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+]);
+
+const googledriveFilesGet = async (
+  credsPayload,
+  {
+    folderIdentifier = {},
+    pageSize = 100,
+    pageToken,
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  const { folderId } = folderIdentifier;
+
+  if (!folderId) {
+    return {
+      ok: false,
+      error: {
+        code: 'MISSING_FOLDER_ID',
+        message: 'folderIdentifier.folderId is required',
+      },
+    };
+  }
+
+  const { client, error } = await getGoogleDrive(credsPayload);
+
+  if (error) {
+    return error;
+  }
+
+  return googleApiCall(() => client.files.list({
+    supportsAllDrives: true,
+    includeItemsFromAllDrives: true,
+    q: [
+      'trashed=false',
+      `'${ folderId }' in parents`,
+    ].join(' and '),
+    pageSize,
+    ...pageToken && { pageToken },
+    fields: 'nextPageToken, files(id, name, mimeType, size, createdTime, modifiedTime, webViewLink)',
+  }));
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  googledriveFilesGet,
+  funcApiConfig,
+};
+
+/*
+curl -X POST "http://localhost:8000/googledriveFilesGet" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "google" },
+    "options": { "folderIdentifier": { "folderId": "REPLACE_FOLDER_ID" } }
+  }'
+*/

package/api/google/googlesheetsSpreadsheetGet.js

@@ -0,0 +1,57 @@
+// https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/get
+
+const { ArgsWarden, objHasAny } = require('../utils');
+const { credsValidator } = require('../validators');
+const { getGoogleSheets, googleApiCall } = require('../google/google.utils');
+
+const spreadsheetIdentifierValidator = (spreadsheetIdentifier) => {
+  return objHasAny(spreadsheetIdentifier, ['spreadsheetId']);
+};
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['spreadsheetIdentifier', spreadsheetIdentifierValidator],
+]);
+
+const googlesheetsSpreadsheetGet = async (
+  credsPayload,
+  spreadsheetIdentifier,
+  {
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    spreadsheetIdentifier,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  const { spreadsheetId } = spreadsheetIdentifier;
+  const { client, error } = await getGoogleSheets(credsPayload);
+
+  if (error) {
+    return error;
+  }
+
+  return googleApiCall(() => client.spreadsheets.get({ spreadsheetId }));
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  googlesheetsSpreadsheetGet,
+  funcApiConfig,
+};
+
+/*
+curl -X POST "http://localhost:8000/googlesheetsSpreadsheetGet" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "google" },
+    "spreadsheetIdentifier": { "spreadsheetId": "ABC123" }
+  }'
+*/