@foxtware/mineral 0.1.26 → 0.1.28

package/api/figma/figmaFileGet.js

@@ -0,0 +1,48 @@
+// https://developers.figma.com/docs/rest-api/file-endpoints/
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { figmaClient } = require('../figma/figma.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['fileKey'],
+]);
+
+const figmaFileGet = async (
+  credsPayload,
+  fileKey,
+  {
+    params,
+    fetchClient = figmaClient,
+  } = {},
+) => {
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    fileKey,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  return fetchClient.fetch({
+    requestPayload: {
+      method: 'get',
+      url: `/v1/files/${ fileKey }`,
+      params,
+      
+    },
+    context: {
+      credsPayload,
+    },
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  figmaFileGet,
+  funcApiConfig,
+};

package/api/figma/figmaFileImageFillsGet.js

@@ -0,0 +1,48 @@
+// https://developers.figma.com/docs/rest-api/file-endpoints/
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { figmaClient } = require('../figma/figma.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['fileKey'],
+]);
+
+const figmaFileImageFillsGet = async (
+  credsPayload,
+  fileKey,
+  {
+    params,
+    fetchClient = figmaClient,
+  } = {},
+) => {
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    fileKey,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  return fetchClient.fetch({
+    requestPayload: {
+      method: 'get',
+      url: `/v1/files/${ fileKey }/images`,
+      params,
+      
+    },
+    context: {
+      credsPayload,
+    },
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  figmaFileImageFillsGet,
+  funcApiConfig,
+};

package/api/figma/figmaFileImagesGet.js

@@ -0,0 +1,48 @@
+// https://developers.figma.com/docs/rest-api/file-endpoints/
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { figmaClient } = require('../figma/figma.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['fileKey'],
+]);
+
+const figmaFileImagesGet = async (
+  credsPayload,
+  fileKey,
+  {
+    params,
+    fetchClient = figmaClient,
+  } = {},
+) => {
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    fileKey,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  return fetchClient.fetch({
+    requestPayload: {
+      method: 'get',
+      url: `/v1/images/${ fileKey }`,
+      params,
+      
+    },
+    context: {
+      credsPayload,
+    },
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  figmaFileImagesGet,
+  funcApiConfig,
+};

package/api/figma/figmaFileMetaGet.js

@@ -0,0 +1,48 @@
+// https://developers.figma.com/docs/rest-api/file-endpoints/
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { figmaClient } = require('../figma/figma.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['fileKey'],
+]);
+
+const figmaFileMetaGet = async (
+  credsPayload,
+  fileKey,
+  {
+    params,
+    fetchClient = figmaClient,
+  } = {},
+) => {
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    fileKey,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  return fetchClient.fetch({
+    requestPayload: {
+      method: 'get',
+      url: `/v1/files/${ fileKey }/meta`,
+      params,
+      
+    },
+    context: {
+      credsPayload,
+    },
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  figmaFileMetaGet,
+  funcApiConfig,
+};

package/api/figma/figmaFileNodesGet.js

@@ -0,0 +1,48 @@
+// https://developers.figma.com/docs/rest-api/file-endpoints/
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { figmaClient } = require('../figma/figma.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['fileKey'],
+]);
+
+const figmaFileNodesGet = async (
+  credsPayload,
+  fileKey,
+  {
+    params,
+    fetchClient = figmaClient,
+  } = {},
+) => {
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    fileKey,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  return fetchClient.fetch({
+    requestPayload: {
+      method: 'get',
+      url: `/v1/files/${ fileKey }/nodes`,
+      params,
+      
+    },
+    context: {
+      credsPayload,
+    },
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  figmaFileNodesGet,
+  funcApiConfig,
+};

package/api/figma/figmaFileStylesGet.js

@@ -0,0 +1,48 @@
+// https://developers.figma.com/docs/rest-api/component-endpoints/
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { figmaClient } = require('../figma/figma.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['fileKey'],
+]);
+
+const figmaFileStylesGet = async (
+  credsPayload,
+  fileKey,
+  {
+    params,
+    fetchClient = figmaClient,
+  } = {},
+) => {
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    fileKey,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  return fetchClient.fetch({
+    requestPayload: {
+      method: 'get',
+      url: `/v1/files/${ fileKey }/styles`,
+      params,
+      
+    },
+    context: {
+      credsPayload,
+    },
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  figmaFileStylesGet,
+  funcApiConfig,
+};

package/api/figma/figmaFileVersionsGet.js

@@ -0,0 +1,48 @@
+// https://developers.figma.com/docs/rest-api/version-history-endpoints/
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { figmaClient } = require('../figma/figma.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['fileKey'],
+]);
+
+const figmaFileVersionsGet = async (
+  credsPayload,
+  fileKey,
+  {
+    params,
+    fetchClient = figmaClient,
+  } = {},
+) => {
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    fileKey,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  return fetchClient.fetch({
+    requestPayload: {
+      method: 'get',
+      url: `/v1/files/${ fileKey }/versions`,
+      params,
+      
+    },
+    context: {
+      credsPayload,
+    },
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  figmaFileVersionsGet,
+  funcApiConfig,
+};

package/api/figma/figmaFolderFilesGet.js

@@ -0,0 +1,48 @@
+// https://developers.figma.com/docs/rest-api/projects-endpoints/
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { figmaClient } = require('../figma/figma.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['folderId'],
+]);
+
+const figmaFolderFilesGet = async (
+  credsPayload,
+  folderId,
+  {
+    params,
+    fetchClient = figmaClient,
+  } = {},
+) => {
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    folderId,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  return fetchClient.fetch({
+    requestPayload: {
+      method: 'get',
+      url: `/v2/folders/${ folderId }/files`,
+      params,
+      
+    },
+    context: {
+      credsPayload,
+    },
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  figmaFolderFilesGet,
+  funcApiConfig,
+};

package/api/figma/figmaFolderFoldersGet.js

@@ -0,0 +1,48 @@
+// https://developers.figma.com/docs/rest-api/projects-endpoints/
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { figmaClient } = require('../figma/figma.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['folderId'],
+]);
+
+const figmaFolderFoldersGet = async (
+  credsPayload,
+  folderId,
+  {
+    params,
+    fetchClient = figmaClient,
+  } = {},
+) => {
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    folderId,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  return fetchClient.fetch({
+    requestPayload: {
+      method: 'get',
+      url: `/v2/folders/${ folderId }/folders`,
+      params,
+      
+    },
+    context: {
+      credsPayload,
+    },
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  figmaFolderFoldersGet,
+  funcApiConfig,
+};

package/api/figma/figmaFolderMetaGet.js

@@ -0,0 +1,48 @@
+// https://developers.figma.com/docs/rest-api/projects-endpoints/
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { figmaClient } = require('../figma/figma.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['folderId'],
+]);
+
+const figmaFolderMetaGet = async (
+  credsPayload,
+  folderId,
+  {
+    params,
+    fetchClient = figmaClient,
+  } = {},
+) => {
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    folderId,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  return fetchClient.fetch({
+    requestPayload: {
+      method: 'get',
+      url: `/v2/folders/${ folderId }/meta`,
+      params,
+      
+    },
+    context: {
+      credsPayload,
+    },
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  figmaFolderMetaGet,
+  funcApiConfig,
+};

package/api/figma/figmaGet.js

@@ -1,6 +1,6 @@
-// https://www.figma.com/developers/api#get-me-endpoint
+// https://developers.figma.com/docs/rest-api/
 
-const { ArgsWarden, Getter } = require('../utils');
+const { ArgsWarden } = require('../utils');
 const { credsValidator } = require('../validators');
 const { figmaClient } = require('../figma/figma.utils');
 
@@ -9,43 +9,14 @@ const argsWarden = new ArgsWarden([
   ['url'],
 ]);
 
-const figmaGetPacket = async (
-  credsPayload,
-  url,
-  {
-    params,
-  } = {},
-) => {
-  return figmaClient.fetch({
-    requestPayload: {
-      url,
-      params,
-    },
-    context: {
-      credsPayload,
-    },
-  });
-};
-
-const figmaGetPaginator = async (currentParams, response) => {
-  if (!response?.ok) {
-    return [true];
-  }
-
-  return [true];
-};
-
 const figmaGet = async (
-  returnGetter,
-
   credsPayload,
   url,
   {
     params,
-    ...getterOptions
+    fetchClient = figmaClient,
   } = {},
 ) => {
-
   const rejectResponse = await argsWarden.responseIfRejectingArgs({
     credsPayload,
     url,
@@ -54,37 +25,19 @@ const figmaGet = async (
     return rejectResponse;
   }
 
-  const getter = new Getter(
-    {
-      args: [credsPayload, url],
-      options: {
-        params,
-      },
-    },
-    {
-      func: figmaGetPacket,
-      digester: (response) => {
-        if (!response?.ok) {
-          return [];
-        }
+  const resolvedUrl = url.startsWith('/v1/') || url.startsWith('/v2/') || url.startsWith('http')
+    ? url
+    : `/v1${ url.startsWith('/') ? url : `/${ url }` }`;
 
-        return Array.isArray(response.data) ? response.data : [];
-      },
-      paginator: figmaGetPaginator,
-      ...getterOptions,
+  return fetchClient.fetch({
+    requestPayload: {
+      url: resolvedUrl,
+      params,
     },
-  );
-
-  if (returnGetter) {
-    return getter;
-  }
-
-  const data = await getter.run({ returnAll: true });
-
-  return {
-    ok: true,
-    data,
-  };
+    context: {
+      credsPayload,
+    },
+  });
 };
 
 const funcApiConfig = {
@@ -92,8 +45,7 @@ const funcApiConfig = {
 };
 
 module.exports = {
-  figmaGet: (...args) => figmaGet(false, ...args),
-  figmaGetter: (...args) => figmaGet(true, ...args),
+  figmaGet,
   funcApiConfig,
 };
 

package/api/figma/figmaMeGet.js

@@ -0,0 +1,53 @@
+// https://developers.figma.com/docs/rest-api/users-endpoints/
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { figmaClient } = require('../figma/figma.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+]);
+
+const figmaMeGet = async (
+  credsPayload,
+  
+  {
+    params,
+    fetchClient = figmaClient,
+  } = {},
+) => {
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  return fetchClient.fetch({
+    requestPayload: {
+      method: 'get',
+      url: `/v1/me`,
+    },
+    context: {
+      credsPayload,
+    },
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  figmaMeGet,
+  funcApiConfig,
+};
+
+/*
+  curl -X GET "http://localhost:8000/figmaMeGet" \
+    -H "Content-Type: application/json" \
+    -d '{
+      "credsPayload": { "credsPath": "figma" }
+    }'
+*/

package/api/figma/figmaOembedGet.js

@@ -0,0 +1,44 @@
+// https://developers.figma.com/docs/rest-api/oembed-endpoints/
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { figmaClient } = require('../figma/figma.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+]);
+
+const figmaOembedGet = async (
+  credsPayload,
+  {
+    params,
+    fetchClient = figmaClient,
+  } = {},
+) => {
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  return fetchClient.fetch({
+    requestPayload: {
+      method: 'get',
+      url: `/v1/oembed`,
+      params,
+    },
+    context: {
+      credsPayload,
+    },
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  figmaOembedGet,
+  funcApiConfig,
+};