@foxtware/mineral 0.1.28 → 0.1.30

package/api/spotify/spotifySearch.js

@@ -0,0 +1,174 @@
+// https://developer.spotify.com/documentation/web-api/reference/search
+
+const { ArgsWarden, Getter } = require('../utils');
+const { credsValidator } = require('../validators');
+const { spotifyClient } = require('../spotify/spotify.utils');
+const { MAX_SEARCH_PER_PAGE } = require('../spotify/spotify.constants');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['query'],
+  ['types'],
+]);
+
+const digSearchResults = (data, types) => {
+  const typeList = (Array.isArray(types) ? types : String(types).split(','))
+    .map((t) => t.trim())
+    .filter(Boolean);
+
+  // Flatten matches across requested types, tagging each with its type key.
+  const out = [];
+  for (const type of typeList) {
+    const key = type.endsWith('s') ? type : `${ type }s`;
+    const page = data?.[key];
+    const items = page?.items ?? [];
+    for (const item of items) {
+      out.push({ type: key, ...item });
+    }
+  }
+  return out;
+};
+
+const spotifySearchPacket = async (
+  credsPayload,
+  query,
+  types,
+  {
+    params = {},
+    perPage = MAX_SEARCH_PER_PAGE,
+    fetchClient = spotifyClient,
+  } = {},
+) => {
+  const typeParam = Array.isArray(types) ? types.join(',') : types;
+
+  return fetchClient.fetch({
+    context: { credsPayload },
+    requestPayload: {
+      method: 'get',
+      url: '/search',
+      params: {
+        q: query,
+        type: typeParam,
+        limit: Math.min(perPage, MAX_SEARCH_PER_PAGE),
+        offset: 0,
+        ...params,
+      },
+    },
+  });
+};
+
+const spotifySearchPaginator = async (currentParams, response) => {
+  if (!response?.ok) {
+    return [true];
+  }
+
+  const data = response.data ?? {};
+  // Any requested type still having a next URL means we continue.
+  const hasNext = Object.values(data).some(
+    (page) => page && typeof page === 'object' && page.next,
+  );
+  if (!hasNext) {
+    return [true];
+  }
+
+  const { args, options } = currentParams;
+  const { params = {}, perPage = MAX_SEARCH_PER_PAGE } = options;
+  const currentOffset = Number(params.offset ?? 0);
+  const pageLimit = Number(params.limit ?? perPage);
+
+  return [false, {
+    args,
+    options: {
+      ...options,
+      params: {
+        ...params,
+        offset: currentOffset + pageLimit,
+        limit: pageLimit,
+      },
+    },
+  }];
+};
+
+const spotifySearch = async (
+  returnGetter,
+
+  credsPayload,
+  query,
+  types,
+  {
+    market,
+    includeExternal,
+    perPage = MAX_SEARCH_PER_PAGE,
+    fetchClient,
+    ...getterOptions
+  } = {},
+) => {
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    query,
+    types,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  const typeList = Array.isArray(types) ? types : String(types).split(',');
+
+  const getter = new Getter(
+    {
+      args: [credsPayload, query, types],
+      options: {
+        params: {
+          ...(market !== undefined && { market }),
+          ...(includeExternal !== undefined && {
+            include_external: includeExternal,
+          }),
+        },
+        perPage,
+        fetchClient,
+      },
+    },
+    {
+      func: spotifySearchPacket,
+      digester: (response) => {
+        if (!response?.ok) {
+          return [];
+        }
+        return digSearchResults(response.data, typeList);
+      },
+      paginator: spotifySearchPaginator,
+      ...getterOptions,
+    },
+  );
+
+  if (returnGetter) {
+    return getter;
+  }
+
+  const data = await getter.run({ returnAll: true });
+
+  return {
+    ok: true,
+    data,
+  };
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  spotifySearch: (...args) => spotifySearch(false, ...args),
+  spotifySearchGetter: (...args) => spotifySearch(true, ...args),
+  funcApiConfig,
+};
+
+/*
+curl -X POST "http://localhost:8000/spotifySearch" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "spotify" },
+    "query": "radiohead",
+    "types": ["artist", "album"]
+  }'
+*/

package/api/spotify/spotifyTrackGet.js

@@ -0,0 +1,76 @@
+// https://developer.spotify.com/documentation/web-api/reference/get-track
+
+const { ArgsWarden, actionSingleOrMultiple, logDeep } = require('../utils');
+const { credsValidator } = require('../validators');
+const { spotifyClient } = require('../spotify/spotify.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['trackId'],
+]);
+
+const spotifyTrackGetSingle = async (
+  credsPayload,
+  trackId,
+  {
+    market,
+    fetchClient = spotifyClient,
+  } = {},
+) => {
+  const response = await fetchClient.fetch({
+    context: { credsPayload },
+    requestPayload: {
+      method: 'get',
+      url: `/tracks/${ trackId }`,
+      params: {
+        ...(market !== undefined && { market }),
+      },
+    },
+  });
+
+  const { ok, data, error } = response;
+  if (!ok) {
+    logDeep({ error });
+    return { ok: false, error };
+  }
+
+  return { ok: true, data };
+};
+
+const spotifyTrackGet = async (
+  credsPayload,
+  trackId,
+  {
+    market,
+    queueRunOptions,
+    fetchClient,
+  } = {},
+) => {
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    trackId,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  return actionSingleOrMultiple(
+    trackId,
+    spotifyTrackGetSingle,
+    (trackIdItem) => ({
+      args: [credsPayload, trackIdItem, { market, fetchClient }],
+    }),
+    {
+      ...(queueRunOptions ? { queueRunOptions } : {}),
+    },
+  );
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  spotifyTrackGet,
+  funcApiConfig,
+};

package/api/starshipit/starshipitProductUpdate.js

@@ -0,0 +1,102 @@
+// https://api-docs.starshipit.com/#9101a9d7-91b1-492c-b7ad-5f92f80bbfd7
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { starshipitClient } = require('../starshipit/starshipit.utils');
+const { starshipitProductsGet } = require('../starshipit/starshipitProductsGet');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['productId'],
+  ['sku'],
+  ['updatePayload'],
+]);
+
+const starshipitProductUpdate = async (
+  credsPayload,
+  productId,
+  sku,
+  updatePayload,
+  {
+    setData = false,
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    productId,
+    sku,
+    updatePayload,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  if (!setData) {
+    const productsResponse = await starshipitProductsGet(
+      credsPayload,
+      {
+        searchTerm: sku,
+      },
+    );
+
+    if (!productsResponse?.ok) {
+      return productsResponse;
+    }
+
+    const currentProduct = productsResponse.data?.find(product => product?.sku === sku);
+    if (!currentProduct) {
+      return {
+        ok: false,
+        error: {
+          code: 'PRODUCT_NOT_FOUND',
+          message: `No Starshipit product found for SKU ${ sku }`,
+        },
+      };
+    }
+
+    updatePayload = {
+      ...currentProduct,
+      ...updatePayload,
+    };
+  }
+
+  return starshipitClient.fetch({
+    requestPayload: {
+      url: '/products/update',
+      method: 'put',
+      body: {
+        id: productId,
+        product: {
+          id: productId,
+          sku,
+          ...updatePayload,
+        },
+      },
+    },
+    context: {
+      credsPayload,
+      resultPath: 'result.product',
+    },
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  starshipitProductUpdate,
+  funcApiConfig,
+};
+
+/*
+curl -X POST "http://localhost:8000/starshipitProductUpdate" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "starshipit.wf" },
+    "productId": 3015817,
+    "sku": "WFAL48-1-S",
+    "updatePayload": { "hs_code": "6104630011" }
+  }'
+*/

package/api/starshipit/starshipitProductsGet.js

@@ -45,7 +45,7 @@ module.exports = {
 curl -X POST "http://localhost:8000/starshipitProductsGet" \
   -H "Content-Type: application/json" \
   -d '{
-    "credsPayload": { "credsPath": "starshipit.acc" },
-    "options": { "searchTerm": "WFAL48-1-S" }
+    "credsPayload": { "credsPath": "starshipit.wf" },
+    "options": { "limit": 20 }
   }'
 */

package/api/stylearcade/stylearcadeGet.js

@@ -1,4 +1,4 @@
-const { ArgsWarden, Getter } = require('../utils');
+const { ArgsWarden, Getter, valueProvided } = require('../utils');
 const { credsValidator } = require('../validators');
 const { stylearcadeClient } = require('../stylearcade/stylearcade.utils');
 const { MAX_PER_PAGE } = require('../stylearcade/stylearcade.constants');
@@ -59,7 +59,10 @@ const stylearcadeGetDigester = (response, nodeName) => {
     return [];
   }
 
-  return response?.data?.[nodeName] ?? [];
+  const items = response?.data?.[nodeName] ?? [];
+  // Filter out items that have data property, but it's null
+  const meaningfulItems = items.filter(item => Object.hasOwn(item, 'data') && valueProvided(item.data));
+  return meaningfulItems;
 };
 
 const stylearcadeGet = async (

package/api/utils.js

@@ -1411,6 +1411,43 @@ const surveyObject = (
   );
 };
 
+const diffObjects = (
+  sourceOfTruthObject, 
+  comparisonObject,
+  {
+    propMap = {},
+  } = {},
+) => {
+  const diff = {};
+  for (const [key, value] of Object.entries(sourceOfTruthObject)) {
+    const comparisonKey = propMap[key] || key;
+    // TODO: Consider deep equality
+    if (comparisonObject[comparisonKey] !== value) {
+      diff[key] = value;
+    }
+  }
+  return diff;
+};
+
+const objectPropsTranslate = (
+  obj, 
+  propMap,
+  {
+    omitUnmappedProps = false,
+  } = {},
+) => {
+  const translatedObj = {};
+
+  for (const [key, value] of Object.entries(obj)) {
+    if (omitUnmappedProps && !propMap[key]) {
+      continue;
+    }
+    const translatedKey = propMap[key] || key;
+    translatedObj[translatedKey] = value;
+  }
+  return translatedObj;
+};
+
 module.exports = {
   wait,
   timeMs,
@@ -1452,4 +1489,6 @@ module.exports = {
   objectMatchesPartial,
   oneFromManyInResponse,
   surveyObject,
+  diffObjects,
+  objectPropsTranslate,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxtware/mineral",
-  "version": "0.1.28",
+  "version": "0.1.30",
   "bin": {
     "mineral": "bin/mineral.js"
   },

package/server.js

@@ -200,11 +200,13 @@ const logStartup = ({
   if (api_dirs.length) {
     console.log('Extra API dirs:', api_dirs.join(', '));
   }
-
+  
+  /*
   console.log('Registered routes:');
   for (const route of [...routeHandlers.keys()].sort()) {
     console.log(route);
   }
+  */
 };
 
 const startServer = (options = {}) => {