@foxtware/mineral 0.1.9 → 0.1.11

package/api/stylearcade/stylearcadeMetadataGet.js

@@ -0,0 +1,47 @@
+// https://stylearcade.gitlab.io/api-docs/range-plan
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { stylearcadeClient } = require('../stylearcade/stylearcade.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+]);
+
+const stylearcadeMetadataGet = async (
+  credsPayload,
+  options = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({ credsPayload });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  return stylearcadeClient.fetch({
+    requestPayload: {
+      url: '/metadata',
+      ...options.params && { params: options.params },
+    },
+    context: {
+      credsPayload,
+    },
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  stylearcadeMetadataGet,
+  funcApiConfig,
+};
+
+/*
+curl -X POST "http://localhost:8000/stylearcadeMetadataGet" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "stylearcade" }
+  }'
+*/

package/api/threeclicks/threeclicks.constants.js

@@ -0,0 +1,8 @@
+const API_BASE_PATH = '/api-user/v1';
+
+const API_REFERENCE_URL = 'https://g40-server.instance.3clickscloud.com/swagger-ui/index.html';
+
+module.exports = {
+  API_BASE_PATH,
+  API_REFERENCE_URL,
+};

package/api/threeclicks/threeclicks.utils.js

@@ -0,0 +1,119 @@
+const crypto = require('crypto');
+const { API_BASE_PATH } = require('../threeclicks/threeclicks.constants');
+const { resolveCreds } = require('../pipelineSteps');
+const {
+  FetchClient,
+  appendUrlToBase,
+  fetchClientCommonSteps,
+} = require('../utils');
+
+const nowAsUnixTimestamp = () => Math.floor(Date.now() / 1000);
+
+const threeclicksSignatureCalculate = ({
+  creds,
+  method,
+  data,
+}) => {
+  const {
+    API_KEY,
+    API_SECRET,
+  } = creds;
+
+  const timestamp = nowAsUnixTimestamp();
+  const stitchedString = `${ API_KEY }${ API_SECRET }${ method }${
+    data ? JSON.stringify(data) : ''
+  }${ timestamp }`;
+
+  const signature = crypto
+    .createHmac('sha256', API_SECRET)
+    .update(stitchedString)
+    .digest('hex');
+
+  return {
+    signature,
+    timestamp,
+  };
+};
+
+const getSignatureData = (requestPayload) => {
+  const method = (requestPayload.method || 'get').toLowerCase();
+
+  if (method === 'get') {
+    return requestPayload.params ?? {};
+  }
+
+  return requestPayload.body ?? {};
+};
+
+const useThreeclicksUrlAndAuth = async (state) => {
+  const { requestPayload, context } = state;
+  const { creds } = context;
+  const {
+    API_KEY,
+    API_DOMAIN,
+  } = creds;
+
+  const method = (requestPayload.method || 'get').toLowerCase();
+  const signatureData = getSignatureData({
+    ...requestPayload,
+    method,
+  });
+
+  const { signature, timestamp } = threeclicksSignatureCalculate({
+    creds,
+    method,
+    data: signatureData,
+  });
+
+  const baseUrl = `https://${ API_DOMAIN }${ API_BASE_PATH }`;
+
+  return {
+    requestPayload: {
+      ...requestPayload,
+      method,
+      url: appendUrlToBase(baseUrl, requestPayload.url),
+      headers: {
+        'X-Api-Key': API_KEY,
+        'X-Api-Signature': signature,
+        'X-Api-Timestamp': String(timestamp),
+        ...requestPayload.headers,
+      },
+    },
+  };
+};
+
+const interpretThreeclicksResponse = async (state) => {
+  const { response } = state;
+  const { success, message } = response?.data?.result ?? {};
+
+  if (response?.ok && success === false) {
+    return {
+      response: {
+        ok: false,
+        error: {
+          message,
+          details: response.data?.result,
+        },
+      },
+      breakChain: true,
+    };
+  }
+
+  return {};
+};
+
+const threeclicksClient = new FetchClient({
+  pipeline: [
+    resolveCreds,
+    useThreeclicksUrlAndAuth,
+    'fetch',
+    fetchClientCommonSteps.exitEarlyOnNotOk,
+    interpretThreeclicksResponse,
+  ],
+});
+
+module.exports = {
+  threeclicksClient,
+  threeclicksSignatureCalculate,
+  getSignatureData,
+};

package/api/threeclicks/threeclicksCollectionsGet.js

@@ -0,0 +1,40 @@
+// https://g40-server.instance.3clickscloud.com/swagger-ui/index.html#operations-v1_-_Site_Settings_>_Style-list_5
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { threeclicksClient } = require('../threeclicks/threeclicks.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+]);
+
+const threeclicksCollectionsGet = async (credsPayload) => {
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({ credsPayload });
+  if (rejectResponse) return rejectResponse;
+  return threeclicksClient.fetch({
+    requestPayload: {
+      url: '/site-settings/style/collection',
+      method: 'get',
+    },
+    context: {
+      credsPayload,
+    },
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  threeclicksCollectionsGet,
+  funcApiConfig,
+};
+
+/*
+curl -X POST "http://localhost:8000/threeclicksCollectionsGet" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "threeclicks" }
+  }'
+*/

package/api/threeclicks/threeclicksGet.js

@@ -0,0 +1,138 @@
+// https://g40-server.instance.3clickscloud.com/swagger-ui/index.html#operations-tag-v1_-_Search_>_Advanced
+
+const { ArgsWarden, Getter } = require('../utils');
+const { credsValidator } = require('../validators');
+const { threeclicksClient } = require('../threeclicks/threeclicks.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['url'],
+]);
+
+const threeclicksGetPacket = async (
+  credsPayload,
+  url,
+  {
+    params,
+    page = '1',
+  } = {},
+) => {
+  const paramsWithPage = {
+    ...params,
+    page: String(page),
+  };
+
+  return threeclicksClient.fetch({
+    requestPayload: {
+      url,
+      method: 'get',
+      params: paramsWithPage,
+    },
+    context: {
+      credsPayload,
+    },
+  });
+};
+
+const threeclicksGetPaginator = async (currentParams, response) => {
+  if (!response?.ok) {
+    return [true];
+  }
+
+  const pageCount = response?.data?.content?.pagination_data?.page_count;
+  const currentPage = parseInt(currentParams.options.page, 10);
+
+  if (!pageCount || currentPage >= pageCount) {
+    return [true];
+  }
+
+  const { args, options } = currentParams;
+
+  return [false, {
+    args,
+    options: {
+      ...options,
+      page: String(currentPage + 1),
+    },
+  }];
+};
+
+const threeclicksGetDigester = (response) => {
+  if (!response?.ok) {
+    return [];
+  }
+
+  return response?.data?.content?.pagination_data?.result_data ?? [];
+};
+
+const threeclicksGet = async (
+  returnGetter,
+
+  credsPayload,
+  url,
+  {
+    params,
+    page = '1',
+    ...getterOptions
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    url,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  const getter = new Getter(
+    {
+      args: [credsPayload, url],
+      options: {
+        params,
+        page,
+      },
+    },
+    {
+      func: threeclicksGetPacket,
+      digester: threeclicksGetDigester,
+      paginator: threeclicksGetPaginator,
+      ...getterOptions,
+    },
+  );
+
+  if (returnGetter) {
+    return getter;
+  }
+
+  const data = await getter.run({ returnAll: true });
+
+  return {
+    ok: true,
+    data,
+  };
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  threeclicksGet: (...args) => threeclicksGet(false, ...args),
+  threeclicksGetter: (...args) => threeclicksGet(true, ...args),
+  funcApiConfig,
+};
+
+/*
+curl -X POST "http://localhost:8000/threeclicksGet" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "threeclicks" },
+    "url": "/search/advanced/style",
+    "options": {
+      "params": {
+        "mode": "all"
+      }
+    }
+  }'
+*/

package/api/threeclicks/threeclicksKeycodeCreate.js

@@ -0,0 +1,55 @@
+// https://g40-server.instance.3clickscloud.com/swagger-ui/index.html#operations-v1_-_Style_>_Codes-keycodeCreate
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { threeclicksClient } = require('../threeclicks/threeclicks.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['styleNumber'],
+  ['styleColoursizeId'],
+  ['size'],
+]);
+
+const threeclicksKeycodeCreate = async (
+  credsPayload,
+  styleNumber,
+  styleColoursizeId,
+  size,
+  {
+    keycode = `${ styleNumber }-${ size }`,
+  } = {},
+) => {
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    styleNumber,
+    styleColoursizeId,
+    size,
+  });
+  if (rejectResponse) return rejectResponse;
+
+  return threeclicksClient.fetch({
+    requestPayload: {
+      url: '/style/codes/keycode',
+      method: 'post',
+      body: {
+      size,
+      style_coloursize_id: styleColoursizeId,
+      style_number: styleNumber,
+      keycode,
+      },
+    },
+    context: {
+      credsPayload,
+    },
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  threeclicksKeycodeCreate,
+  funcApiConfig,
+};

package/api/threeclicks/threeclicksKeycodeGet.js

@@ -0,0 +1,47 @@
+// https://g40-server.instance.3clickscloud.com/swagger-ui/index.html#operations-v1_-_Style_>_Codes-keycodeGet_1
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { threeclicksClient } = require('../threeclicks/threeclicks.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['styleNumber'],
+  ['styleColoursizeId'],
+  ['size'],
+]);
+
+const threeclicksKeycodeGet = async (credsPayload, styleNumber, styleColoursizeId, size) => {
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    styleNumber,
+    styleColoursizeId,
+    size,
+  });
+  if (rejectResponse) return rejectResponse;
+
+  const params = {
+    size,
+    style_coloursize_id: styleColoursizeId,
+  };
+
+  return threeclicksClient.fetch({
+    requestPayload: {
+      url: `/style/codes/keycode/${ styleNumber }`,
+      method: 'get',
+      params,
+    },
+    context: {
+      credsPayload,
+    },
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  threeclicksKeycodeGet,
+  funcApiConfig,
+};

package/api/threeclicks/threeclicksPurchaseOrderCreate.js

@@ -0,0 +1,34 @@
+// https://g40-server.instance.3clickscloud.com/swagger-ui/index.html#operations-v1_-_Order-createNormal
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { threeclicksClient } = require('../threeclicks/threeclicks.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['orderPayload'],
+]);
+
+const threeclicksPurchaseOrderCreate = async (credsPayload, orderPayload) => {
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({ credsPayload, orderPayload });
+  if (rejectResponse) return rejectResponse;
+  return threeclicksClient.fetch({
+    requestPayload: {
+      url: '/order/normal',
+      method: 'post',
+      body: orderPayload ,
+    },
+    context: {
+      credsPayload,
+    },
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  threeclicksPurchaseOrderCreate,
+  funcApiConfig,
+};

package/api/threeclicks/threeclicksPurchaseOrderCreateBulk.js

@@ -0,0 +1,34 @@
+// https://g40-server.instance.3clickscloud.com/swagger-ui/index.html#operations-v1_-_Order-createBulkStyle
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { threeclicksClient } = require('../threeclicks/threeclicks.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['orderPayload'],
+]);
+
+const threeclicksPurchaseOrderCreateBulk = async (credsPayload, orderPayload) => {
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({ credsPayload, orderPayload });
+  if (rejectResponse) return rejectResponse;
+  return threeclicksClient.fetch({
+    requestPayload: {
+      url: '/order/bulk-style',
+      method: 'post',
+      body: orderPayload,
+    },
+    context: {
+      credsPayload,
+    },
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  threeclicksPurchaseOrderCreateBulk,
+  funcApiConfig,
+};

package/api/threeclicks/threeclicksPurchaseOrderGet.js

@@ -0,0 +1,33 @@
+// https://g40-server.instance.3clickscloud.com/swagger-ui/index.html#operations-v1_-_Order_>_Details-detail_7
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { threeclicksClient } = require('../threeclicks/threeclicks.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['orderNumber'],
+]);
+
+const threeclicksPurchaseOrderGet = async (credsPayload, orderNumber) => {
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({ credsPayload, orderNumber });
+  if (rejectResponse) return rejectResponse;
+  return threeclicksClient.fetch({
+    requestPayload: {
+      url: `/order/basic/${ orderNumber }`,
+      method: 'get',
+    },
+    context: {
+      credsPayload,
+    },
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  threeclicksPurchaseOrderGet,
+  funcApiConfig,
+};

package/api/threeclicks/threeclicksPurchaseOrderQuantitiesGet.js

@@ -0,0 +1,33 @@
+// https://g40-server.instance.3clickscloud.com/swagger-ui/index.html#operations-v1_-_Order_>_Details-quantityNormal
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { threeclicksClient } = require('../threeclicks/threeclicks.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['orderNumber'],
+]);
+
+const threeclicksPurchaseOrderQuantitiesGet = async (credsPayload, orderNumber) => {
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({ credsPayload, orderNumber });
+  if (rejectResponse) return rejectResponse;
+  return threeclicksClient.fetch({
+    requestPayload: {
+      url: `/order/basic/quantity/normal/${ orderNumber }`,
+      method: 'get',
+    },
+    context: {
+      credsPayload,
+    },
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  threeclicksPurchaseOrderQuantitiesGet,
+  funcApiConfig,
+};

package/api/threeclicks/threeclicksPurchaseOrderQuantityCreate.js

@@ -0,0 +1,34 @@
+// https://g40-server.instance.3clickscloud.com/swagger-ui/index.html#operations-v1_-_Order_>_Details-quantityNormalCreate
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { threeclicksClient } = require('../threeclicks/threeclicks.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['quantityPayload'],
+]);
+
+const threeclicksPurchaseOrderQuantityCreate = async (credsPayload, quantityPayload) => {
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({ credsPayload, quantityPayload });
+  if (rejectResponse) return rejectResponse;
+  return threeclicksClient.fetch({
+    requestPayload: {
+      url: '/order/basic/quantity/normal',
+      method: 'post',
+      body: quantityPayload ,
+    },
+    context: {
+      credsPayload,
+    },
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  threeclicksPurchaseOrderQuantityCreate,
+  funcApiConfig,
+};

package/api/threeclicks/threeclicksPurchaseOrderQuantityCreateBulk.js

@@ -0,0 +1,34 @@
+// https://g40-server.instance.3clickscloud.com/swagger-ui/index.html#operations-v1_-_Order_>_Details-quantityBulkStyleCreate
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { threeclicksClient } = require('../threeclicks/threeclicks.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['quantityPayload'],
+]);
+
+const threeclicksPurchaseOrderQuantityCreateBulk = async (credsPayload, quantityPayload) => {
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({ credsPayload, quantityPayload });
+  if (rejectResponse) return rejectResponse;
+  return threeclicksClient.fetch({
+    requestPayload: {
+      url: '/order/basic/quantity/bulk-style',
+      method: 'post',
+      body: quantityPayload,
+    },
+    context: {
+      credsPayload,
+    },
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  threeclicksPurchaseOrderQuantityCreateBulk,
+  funcApiConfig,
+};