@foxtware/mineral 0.1.14 → 0.1.16

package/api/printify/printifyProductsGet.js

@@ -0,0 +1,67 @@
+// https://developers.printify.com/#retrieve-a-list-of-products
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { printifyGet, printifyGetter } = require('../printify/printifyGet');
+const { resolveShopIdFromCreds } = require('../printify/printify.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+]);
+
+const printifyProductsGet = async (
+  returnGetter,
+
+  credsPayload,
+  {
+    shopId,
+    perPage,
+    ...getterOptions
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  const shopIdResponse = await resolveShopIdFromCreds({ shopId, credsPayload });
+  if (!shopIdResponse.ok) {
+    return shopIdResponse;
+  }
+  ({ data: shopId } = shopIdResponse);
+
+  const getterArgs = [
+    credsPayload,
+    `/shops/${ shopId }/products.json`,
+    {
+      ...(perPage && { params: { limit: perPage } }),
+      ...getterOptions,
+    },
+  ];
+
+  return returnGetter
+    ? printifyGetter(...getterArgs)
+    : printifyGet(...getterArgs);
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  printifyProductsGet: (...args) => printifyProductsGet(false, ...args),
+  printifyProductsGetter: (...args) => printifyProductsGet(true, ...args),
+  funcApiConfig,
+};
+
+/*
+curl -X POST "http://localhost:8000/printifyProductsGet" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "printify" },
+    "options": { "perPage": 10 }
+  }'
+*/

package/api/printify/printifyShippingGet.js

@@ -0,0 +1,70 @@
+// https://developers.printify.com/#retrieve-shipping-information
+
+const { ArgsWarden, actionSingleOrMultiple, everyIfArray, valueProvided } = require('../utils');
+const { credsValidator } = require('../validators');
+const { printifyClient } = require('../printify/printify.utils');
+
+const catalogQueryValidator = (catalogQuery) => {
+  return valueProvided(catalogQuery?.blueprintId)
+    && valueProvided(catalogQuery?.printProviderId);
+};
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['catalogQuery', (catalogQuery) => everyIfArray(catalogQueryValidator, catalogQuery)],
+]);
+
+const printifyShippingGetSingle = async (
+  credsPayload,
+  catalogQuery,
+) => {
+  const {
+    blueprintId,
+    printProviderId,
+  } = catalogQuery;
+
+  return printifyClient.fetch({
+    requestPayload: {
+      method: 'get',
+      url: `/catalog/blueprints/${ blueprintId }/print_providers/${ printProviderId }/shipping.json`,
+    },
+    context: { credsPayload },
+  });
+};
+
+const printifyShippingGet = async (
+  credsPayload,
+  catalogQuery,
+  {
+    queueRunOptions,
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    catalogQuery,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  return actionSingleOrMultiple(
+    catalogQuery,
+    printifyShippingGetSingle,
+    (catalogQueryItem) => ({
+      args: [credsPayload, catalogQueryItem],
+    }),
+    {
+      ...(queueRunOptions ? { queueRunOptions } : {}),
+    },
+  );
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  printifyShippingGet,
+  funcApiConfig,
+};

package/api/printify/printifyShopsGet.js

@@ -0,0 +1,56 @@
+// https://developers.printify.com/#retrieve-list-of-shops-in-a-printify-account
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { printifyGet, printifyGetter } = require('../printify/printifyGet');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+]);
+
+const printifyShopsGet = async (
+  returnGetter,
+
+  credsPayload,
+  {
+    ...getterOptions
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  const getterArgs = [
+    credsPayload,
+    '/shops.json',
+    {
+      ...getterOptions,
+    },
+  ];
+
+  return returnGetter
+    ? printifyGetter(...getterArgs)
+    : printifyGet(...getterArgs);
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  printifyShopsGet: (...args) => printifyShopsGet(false, ...args),
+  printifyShopsGetter: (...args) => printifyShopsGet(true, ...args),
+  funcApiConfig,
+};
+
+/*
+curl -X POST "http://localhost:8000/printifyShopsGet" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "printify" }
+  }'
+*/

package/api/printify/printifyWebhookCreate.js

@@ -0,0 +1,84 @@
+// https://developers.printify.com/#create-a-new-webhook
+
+const { ArgsWarden, actionSingleOrMultiple, everyIfArray, valueProvided } = require('../utils');
+const { credsValidator } = require('../validators');
+const { printifyClient, resolveShopIdFromCreds } = require('../printify/printify.utils');
+
+const webhookPayloadValidator = (webhookPayload) => {
+  return valueProvided(webhookPayload?.topic)
+    && valueProvided(webhookPayload?.webhookUrl);
+};
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['webhookPayload', (webhookPayload) => everyIfArray(webhookPayloadValidator, webhookPayload)],
+]);
+
+const printifyWebhookCreateSingle = async (
+  credsPayload,
+  webhookPayload,
+  {
+    shopId,
+  } = {},
+) => {
+  const {
+    topic,
+    webhookUrl,
+  } = webhookPayload;
+
+  return printifyClient.fetch({
+    requestPayload: {
+      method: 'post',
+      url: `/shops/${ shopId }/webhooks.json`,
+      body: {
+        topic,
+        url: webhookUrl,
+      },
+    },
+    context: { credsPayload },
+  });
+};
+
+const printifyWebhookCreate = async (
+  credsPayload,
+  webhookPayload,
+  {
+    shopId,
+    queueRunOptions,
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    webhookPayload,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  const shopIdResponse = await resolveShopIdFromCreds({ shopId, credsPayload });
+  if (!shopIdResponse.ok) {
+    return shopIdResponse;
+  }
+  ({ data: shopId } = shopIdResponse);
+
+  return actionSingleOrMultiple(
+    webhookPayload,
+    printifyWebhookCreateSingle,
+    (webhookPayloadItem) => ({
+      args: [credsPayload, webhookPayloadItem, { shopId }],
+    }),
+    {
+      ...(queueRunOptions ? { queueRunOptions } : {}),
+    },
+  );
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  printifyWebhookCreate,
+  funcApiConfig,
+};

package/api/printify/printifyWebhookDelete.js

@@ -0,0 +1,70 @@
+// https://developers.printify.com/#delete-a-webhook
+
+const { ArgsWarden, actionSingleOrMultiple } = require('../utils');
+const { credsValidator } = require('../validators');
+const { printifyClient, resolveShopIdFromCreds } = require('../printify/printify.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['webhookId'],
+]);
+
+const printifyWebhookDeleteSingle = async (
+  credsPayload,
+  webhookId,
+  {
+    shopId,
+  } = {},
+) => {
+  return printifyClient.fetch({
+    requestPayload: {
+      method: 'delete',
+      url: `/shops/${ shopId }/webhooks/${ webhookId }.json`,
+    },
+    context: { credsPayload },
+  });
+};
+
+const printifyWebhookDelete = async (
+  credsPayload,
+  webhookId,
+  {
+    shopId,
+    queueRunOptions,
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    webhookId,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  const shopIdResponse = await resolveShopIdFromCreds({ shopId, credsPayload });
+  if (!shopIdResponse.ok) {
+    return shopIdResponse;
+  }
+  ({ data: shopId } = shopIdResponse);
+
+  return actionSingleOrMultiple(
+    webhookId,
+    printifyWebhookDeleteSingle,
+    (webhookIdItem) => ({
+      args: [credsPayload, webhookIdItem, { shopId }],
+    }),
+    {
+      ...(queueRunOptions ? { queueRunOptions } : {}),
+    },
+  );
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  printifyWebhookDelete,
+  funcApiConfig,
+};

package/api/printify/printifyWebhookUpdate.js

@@ -0,0 +1,81 @@
+// https://developers.printify.com/#update-a-webhook
+
+const { ArgsWarden, actionSingleOrMultiple, everyIfArray, valueProvided } = require('../utils');
+const { credsValidator } = require('../validators');
+const { printifyClient, resolveShopIdFromCreds } = require('../printify/printify.utils');
+
+const webhookUpdateValidator = (webhookUpdate) => {
+  return valueProvided(webhookUpdate?.webhookId)
+    && valueProvided(webhookUpdate?.updatePayload);
+};
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['webhookUpdate', (webhookUpdate) => everyIfArray(webhookUpdateValidator, webhookUpdate)],
+]);
+
+const printifyWebhookUpdateSingle = async (
+  credsPayload,
+  webhookUpdate,
+  {
+    shopId,
+  } = {},
+) => {
+  const {
+    webhookId,
+    updatePayload,
+  } = webhookUpdate;
+
+  return printifyClient.fetch({
+    requestPayload: {
+      method: 'put',
+      url: `/shops/${ shopId }/webhooks/${ webhookId }.json`,
+      body: updatePayload,
+    },
+    context: { credsPayload },
+  });
+};
+
+const printifyWebhookUpdate = async (
+  credsPayload,
+  webhookUpdate,
+  {
+    shopId,
+    queueRunOptions,
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    webhookUpdate,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  const shopIdResponse = await resolveShopIdFromCreds({ shopId, credsPayload });
+  if (!shopIdResponse.ok) {
+    return shopIdResponse;
+  }
+  ({ data: shopId } = shopIdResponse);
+
+  return actionSingleOrMultiple(
+    webhookUpdate,
+    printifyWebhookUpdateSingle,
+    (webhookUpdateItem) => ({
+      args: [credsPayload, webhookUpdateItem, { shopId }],
+    }),
+    {
+      ...(queueRunOptions ? { queueRunOptions } : {}),
+    },
+  );
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  printifyWebhookUpdate,
+  funcApiConfig,
+};

package/api/printify/printifyWebhooksGet.js

@@ -0,0 +1,56 @@
+// https://developers.printify.com/#retrieve-a-list-of-webhooks
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { printifyGet, printifyGetter } = require('../printify/printifyGet');
+const { resolveShopIdFromCreds } = require('../printify/printify.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+]);
+
+const printifyWebhooksGet = async (
+  returnGetter,
+
+  credsPayload,
+  {
+    shopId,
+    ...getterOptions
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  const shopIdResponse = await resolveShopIdFromCreds({ shopId, credsPayload });
+  if (!shopIdResponse.ok) {
+    return shopIdResponse;
+  }
+  ({ data: shopId } = shopIdResponse);
+
+  const getterArgs = [
+    credsPayload,
+    `/shops/${ shopId }/webhooks.json`,
+    {
+      ...getterOptions,
+    },
+  ];
+
+  return returnGetter
+    ? printifyGetter(...getterArgs)
+    : printifyGet(...getterArgs);
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  printifyWebhooksGet: (...args) => printifyWebhooksGet(false, ...args),
+  printifyWebhooksGetter: (...args) => printifyWebhooksGet(true, ...args),
+  funcApiConfig,
+};

package/api/salesforce/docs.md

@@ -0,0 +1,6 @@
+# Salesforce
+
+- [Developer documentation](https://developer.salesforce.com/docs)
+- [REST API Developer Guide](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/)
+
+Org-specific REST and Bulk APIs at `{instance}.salesforce.com/services/data/v{version}/`, using OAuth 2.0 (and often connected-app JWT) rather than a single static API key.

package/api/shopify/_example.create.js

@@ -22,8 +22,8 @@ const shopifyThingCreate = async (
   } = {},
 ) => {
 
-  const rejectResponse = await argsWarden.responseIfRejectingArgs({ 
-    credsPayload, 
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
     thingInput,
   });
   if (rejectResponse) {

package/api/shopify/_example.get.js

@@ -2,27 +2,39 @@
 
 const { ArgsWarden } = require('../utils');
 const { credsValidator } = require('../validators');
-const { shopifyGet } = require('./shopifyGet');
+const { shopifyGet, shopifyGetter } = require('./shopifyGet');
 
 const argsWarden = new ArgsWarden([
   ['credsPayload', credsValidator],
 ]);
 
 const shopifyThingsGet = async (
+  returnGetter, // Always bound
+
   credsPayload,
   {
     ...getterOptions // e.g. limit
   } = {},
 ) => {
 
-  const rejectResponse = await argsWarden.responseIfRejectingArgs({ 
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
     credsPayload,
   });
   if (rejectResponse) {
     return rejectResponse;
   }
 
-  return await shopifyGet(credsPayload, 'thing', { ...getterOptions });
+  const getterArgs = [
+    credsPayload, 
+    'thing', 
+    {
+      ...getterOptions,
+    },
+  ];
+
+  return returnGetter
+    ? shopifyGetter(...getterArgs)
+    : shopifyGet(...getterArgs);
 };
 
 const funcApiConfig = {
@@ -30,7 +42,8 @@ const funcApiConfig = {
 };
 
 module.exports = {
-  shopifyThingsGet,
+  shopifyThingsGet: (...args) => shopifyThingsGet(false, ...args),
+  shopifyThingsGetter: (...args) => shopifyThingsGet(true, ...args),
   funcApiConfig,
 };
 

package/api/shopify/_example.getsingle.js

@@ -20,7 +20,10 @@ const FUNC = async (
   } = {},
 ) => {
 
-  const rejectResponse = await argsWarden.responseIfRejectingArgs({ credsPayload, thingId });
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    thingId,
+  });
   if (rejectResponse) {
     return rejectResponse;
   }

package/api/shopify/_example.js

@@ -12,7 +12,10 @@ const FUNC = async (
   options = {},
 ) => {
 
-  const rejectResponse = await argsWarden.responseIfRejectingArgs({ credsPayload, arg });
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    arg,
+  });
   if (rejectResponse) {
     return rejectResponse;
   }

package/api/shopify/_example.mutation.js

@@ -18,7 +18,10 @@ const FUNC = async (
   } = {},
 ) => {
 
-  const rejectResponse = await argsWarden.responseIfRejectingArgs({ credsPayload, thingId });
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    thingId,
+  });
   if (rejectResponse) {
     return rejectResponse;
   }

package/api/shopify/shopifyAbandonedCheckoutsGet.js

@@ -15,7 +15,7 @@ const shopifyAbandonedCheckoutsGet = async (
   } = {},
 ) => {
 
-  const rejectResponse = await argsWarden.responseIfRejectingArgs({ 
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
     credsPayload,
   });
   if (rejectResponse) {

package/api/shopify/shopifyArticlesGet.js

@@ -15,7 +15,7 @@ const shopifyArticlesGet = async (
   } = {},
 ) => {
 
-  const rejectResponse = await argsWarden.responseIfRejectingArgs({ 
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
     credsPayload,
   });
   if (rejectResponse) {

package/api/shopify/shopifyBlogsGet.js

@@ -15,7 +15,7 @@ const shopifyBlogsGet = async (
   } = {},
 ) => {
 
-  const rejectResponse = await argsWarden.responseIfRejectingArgs({ 
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
     credsPayload,
   });
   if (rejectResponse) {

package/api/shopify/shopifyBulkMutationDo.js

@@ -1,6 +1,5 @@
 const { randomUUID } = require('crypto');
-const { Blob } = require('buffer');
-const fs = require('fs').promises;
+const { openAsBlob, promises: fs } = require('fs');
 
 const { HOSTED, TEMP_DIR } = require('../constants');
 const { credsValidator } = require('../validators');
@@ -53,8 +52,8 @@ const shopifyBulkMutationDo = async (
   } = {},
 ) => {
 
-  const rejectResponse = await argsWarden.responseIfRejectingArgs({ 
-    credsPayload, 
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
     createOrResumeBulkOpPayload,
   });
   if (rejectResponse) {
@@ -106,14 +105,14 @@ const shopifyBulkMutationDo = async (
     const { url, parameters } = stagedUploadResponse.data.stagedTargets[0];
     const stagedUploadPath = parameters.find(({ name }) => name === 'key')?.value;
 
-    const fileBuffer = await fs.readFile(filepath);
+    const fileBlob = await openAsBlob(filepath, { type: 'text/jsonl' });
 
     const formData = objectToFormData(
       Object.fromEntries(parameters.map(({ name, value }) => [name, value])),
     );
     formData.append(
       'file',
-      new Blob([fileBuffer], { type: 'text/jsonl' }),
+      fileBlob,
       filepath.split('/').pop(),
     );
 

package/api/shopify/shopifyBulkOperationsGet.js

@@ -15,7 +15,7 @@ const shopifyBulkOperationsGet = async (
   } = {},
 ) => {
 
-  const rejectResponse = await argsWarden.responseIfRejectingArgs({ 
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
     credsPayload,
   });
   if (rejectResponse) {