@foxtware/mineral 0.1.17 → 0.1.18

package/api/linear/linearCommentUpdate.js

@@ -0,0 +1,87 @@
+// https://linear.app/developers/graphql
+
+const { ArgsWarden, valueProvided } = require('../utils');
+const { credsValidator } = require('../validators');
+const { linearClient } = require('../linear/linear.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['id'],
+  ['input', valueProvided],
+]);
+
+const linearCommentUpdate = async (
+  credsPayload,
+  id,
+  input,
+  {
+    skipEditedAt,
+    inspect = false,
+    fetchClient = linearClient,
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    id,
+    input,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  return fetchClient.fetch({
+    requestPayload: {
+      body: {
+        query: `
+          mutation CommentUpdate(
+            $id: String!
+            $input: CommentUpdateInput!
+            $skipEditedAt: Boolean
+          ) {
+            commentUpdate(id: $id, input: $input, skipEditedAt: $skipEditedAt) {
+              success
+              comment {
+                id
+                body
+                createdAt
+                updatedAt
+              }
+            }
+          }
+        `,
+        variables: {
+          id,
+          input,
+          skipEditedAt,
+        },
+      },
+    },
+    context: {
+      credsPayload,
+      resultPath: 'data.commentUpdate',
+    },
+    inspect,
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  linearCommentUpdate,
+  funcApiConfig,
+};
+
+/*
+curl -X POST "http://localhost:8000/linearCommentUpdate" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "linear" },
+    "id": "COMMENT_ID",
+    "input": {
+      "body": "Updated"
+    }
+  }'
+*/

package/api/linear/linearCommentsGet.js

@@ -0,0 +1,70 @@
+// https://linear.app/developers/graphql
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { linearGet, linearGetter } = require('./linearGet');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+]);
+
+const linearCommentsGet = async (
+  returnGetter,
+
+  credsPayload,
+  {
+    attrs = `
+      id
+      body
+      createdAt
+      updatedAt
+      user {
+        id
+        name
+      }
+    `,
+    ...getterOptions
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  const getterArgs = [
+    credsPayload,
+    'comment',
+    {
+      attrs,
+      ...getterOptions,
+    },
+  ];
+
+  return returnGetter
+    ? linearGetter(...getterArgs)
+    : linearGet(...getterArgs);
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  linearCommentsGet: linearCommentsGet.bind(null, false),
+  linearCommentsGetter: linearCommentsGet.bind(null, true),
+  funcApiConfig,
+};
+
+/*
+curl -X POST "http://localhost:8000/linearCommentsGet" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "linear" },
+    "options": {
+      "limit": 10
+    }
+  }'
+*/

package/api/linear/linearCyclesGet.js

@@ -0,0 +1,67 @@
+// https://linear.app/developers/graphql
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { linearGet, linearGetter } = require('./linearGet');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+]);
+
+const linearCyclesGet = async (
+  returnGetter,
+
+  credsPayload,
+  {
+    attrs = `
+      id
+      name
+      number
+      startsAt
+      endsAt
+    `,
+    ...getterOptions
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  const getterArgs = [
+    credsPayload,
+    'cycle',
+    {
+      attrs,
+      ...getterOptions,
+    },
+  ];
+
+  return returnGetter
+    ? linearGetter(...getterArgs)
+    : linearGet(...getterArgs);
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  linearCyclesGet: linearCyclesGet.bind(null, false),
+  linearCyclesGetter: linearCyclesGet.bind(null, true),
+  funcApiConfig,
+};
+
+/*
+curl -X POST "http://localhost:8000/linearCyclesGet" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "linear" },
+    "options": {
+      "limit": 5
+    }
+  }'
+*/

package/api/linear/linearGet.js

@@ -0,0 +1,218 @@
+// https://linear.app/developers/graphql
+
+const { ArgsWarden, Getter, capitaliseString } = require('../utils');
+const { credsValidator } = require('../validators');
+const { MAX_PER_PAGE } = require('../linear/linear.constants');
+const {
+  linearClient,
+  linearConnectionDigester,
+  linearConnectionPaginator,
+} = require('../linear/linear.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['resource'],
+]);
+
+const linearGetPacket = async (
+  credsPayload,
+  resource,
+  resources,
+  attrs,
+  {
+    filter,
+    filterType,
+    before,
+    after,
+    last,
+    includeArchived,
+    orderBy,
+    sort,
+    sortType,
+    includeDisabled,
+    supportsIncludeDisabled = false,
+    perPage = MAX_PER_PAGE,
+    inspect = false,
+    fetchClient = linearClient,
+  } = {},
+) => {
+  const Resource = capitaliseString(resource);
+  const Resources = capitaliseString(resources);
+  const resolvedFilterType = filterType === undefined
+    ? `${ Resource }Filter`
+    : filterType;
+  const resolvedSortType = sortType === true
+    ? `${ Resource }SortInput`
+    : sortType;
+  const includeFilter = Boolean(resolvedFilterType);
+  const includeSort = Boolean(resolvedSortType);
+  const includeIncludeDisabled = supportsIncludeDisabled || includeDisabled !== undefined;
+
+  const queryTypeDeclaration = [
+    ...includeFilter ? [`$filter: ${ resolvedFilterType }`] : [],
+    ...includeIncludeDisabled ? ['$includeDisabled: Boolean'] : [],
+    '$before: String',
+    '$after: String',
+    '$first: Int',
+    '$last: Int',
+    '$includeArchived: Boolean',
+    '$orderBy: PaginationOrderBy',
+    ...includeSort ? [`$sort: [${ resolvedSortType }!]`] : [],
+  ].join('\n');
+
+  const queryVariableDeclaration = [
+    ...includeFilter ? ['filter: $filter'] : [],
+    ...includeIncludeDisabled ? ['includeDisabled: $includeDisabled'] : [],
+    'before: $before',
+    'after: $after',
+    'first: $first',
+    'last: $last',
+    'includeArchived: $includeArchived',
+    'orderBy: $orderBy',
+    ...includeSort ? ['sort: $sort'] : [],
+  ].join('\n');
+
+  return fetchClient.fetch({
+    requestPayload: {
+      body: {
+        query: `
+          query ${ Resources }Get(
+            ${ queryTypeDeclaration }
+          ) {
+            ${ resources }(
+              ${ queryVariableDeclaration }
+            ) {
+              nodes {
+                ${ attrs }
+              }
+              pageInfo {
+                hasNextPage
+                endCursor
+                hasPreviousPage
+                startCursor
+              }
+            }
+          }
+        `,
+        variables: {
+          ...includeFilter && { filter },
+          ...includeIncludeDisabled && { includeDisabled },
+          before,
+          after,
+          first: Math.min(perPage, MAX_PER_PAGE),
+          last,
+          includeArchived,
+          orderBy,
+          ...includeSort && { sort },
+        },
+      },
+    },
+    context: {
+      credsPayload,
+      resultPath: `data.${ resources }`,
+    },
+    inspect,
+  });
+};
+
+const linearGet = async (
+  returnGetter, // Always bound
+
+  credsPayload,
+  resource,
+  {
+    attrs = 'id',
+    resources = `${ resource }s`,
+    filter,
+    filterType,
+    before,
+    after,
+    last,
+    includeArchived,
+    orderBy,
+    sort,
+    sortType,
+    includeDisabled,
+    supportsIncludeDisabled = false,
+    perPage = MAX_PER_PAGE,
+    inspect = false,
+    ...getterOptions
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    resource,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  const getter = new Getter(
+    {
+      args: [
+        credsPayload,
+        resource,
+        resources,
+        attrs,
+      ],
+      options: {
+        filter,
+        filterType,
+        before,
+        after,
+        last,
+        includeArchived,
+        orderBy,
+        sort,
+        sortType,
+        includeDisabled,
+        supportsIncludeDisabled,
+        perPage,
+        inspect,
+        ...getterOptions,
+      },
+    },
+    {
+      func: linearGetPacket,
+      digester: linearConnectionDigester,
+      paginator: linearConnectionPaginator,
+      ...getterOptions,
+    },
+  );
+
+  if (returnGetter) {
+    return getter;
+  }
+
+  const data = await getter.run({ returnAll: true });
+
+  return {
+    ok: true,
+    data,
+  };
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  linearGet: linearGet.bind(null, false),
+  linearGetter: linearGet.bind(null, true),
+  funcApiConfig,
+};
+
+/*
+curl -X POST "http://localhost:8000/linearGet" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "linear" },
+    "resource": "issue",
+    "options": {
+      "limit": 5,
+      "attrs": "id identifier title",
+      "sortType": true
+    }
+  }'
+*/

package/api/linear/linearIssueAddLabel.js

@@ -0,0 +1,77 @@
+// https://linear.app/developers/graphql
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { linearClient } = require('../linear/linear.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['id'],
+  ['labelId'],
+]);
+
+const linearIssueAddLabel = async (
+  credsPayload,
+  id,
+  labelId,
+  {
+    inspect = false,
+    fetchClient = linearClient,
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    id,
+    labelId,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  return fetchClient.fetch({
+    requestPayload: {
+      body: {
+        query: `
+          mutation IssueAddLabel($id: String!, $labelId: String!) {
+            issueAddLabel(id: $id, labelId: $labelId) {
+              success
+              issue {
+                id
+                identifier
+              }
+            }
+          }
+        `,
+        variables: {
+          id,
+          labelId,
+        },
+      },
+    },
+    context: {
+      credsPayload,
+      resultPath: 'data.issueAddLabel',
+    },
+    inspect,
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  linearIssueAddLabel,
+  funcApiConfig,
+};
+
+/*
+curl -X POST "http://localhost:8000/linearIssueAddLabel" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "linear" },
+    "id": "WHI-267",
+    "labelId": "LABEL_ID"
+  }'
+*/

package/api/linear/linearIssueArchive.js

@@ -0,0 +1,74 @@
+// https://linear.app/developers/graphql
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { linearClient } = require('../linear/linear.utils');
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['id'],
+]);
+
+const linearIssueArchive = async (
+  credsPayload,
+  id,
+  {
+    trash,
+    inspect = false,
+    fetchClient = linearClient,
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    id,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  return fetchClient.fetch({
+    requestPayload: {
+      body: {
+        query: `
+          mutation IssueArchive($id: String!, $trash: Boolean) {
+            issueArchive(id: $id, trash: $trash) {
+              success
+              entity {
+                id
+                identifier
+              }
+            }
+          }
+        `,
+        variables: {
+          id,
+          trash,
+        },
+      },
+    },
+    context: {
+      credsPayload,
+      resultPath: 'data.issueArchive',
+    },
+    inspect,
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  linearIssueArchive,
+  funcApiConfig,
+};
+
+/*
+curl -X POST "http://localhost:8000/linearIssueArchive" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "linear" },
+    "id": "WHI-267"
+  }'
+*/

package/api/linear/linearIssueCreate.js

@@ -0,0 +1,94 @@
+// https://linear.app/developers/graphql
+
+const { ArgsWarden } = require('../utils');
+const { credsValidator } = require('../validators');
+const { linearClient } = require('../linear/linear.utils');
+
+const inputValidator = (input) => Boolean(input?.title && input?.teamId);
+
+const argsWarden = new ArgsWarden([
+  ['credsPayload', credsValidator],
+  ['input', inputValidator],
+]);
+
+const linearIssueCreate = async (
+  credsPayload,
+  input,
+  {
+    inspect = false,
+    fetchClient = linearClient,
+  } = {},
+) => {
+
+  const rejectResponse = await argsWarden.responseIfRejectingArgs({
+    credsPayload,
+    input,
+  });
+  if (rejectResponse) {
+    return rejectResponse;
+  }
+
+  return fetchClient.fetch({
+    requestPayload: {
+      body: {
+        query: `
+          mutation IssueCreate($input: IssueCreateInput!) {
+            issueCreate(input: $input) {
+              success
+              issue {
+                id
+                identifier
+                title
+                url
+                priority
+                createdAt
+                updatedAt
+                state {
+                  id
+                  name
+                }
+                team {
+                  id
+                  name
+                }
+                assignee {
+                  id
+                  name
+                }
+              }
+            }
+          }
+        `,
+        variables: {
+          input,
+        },
+      },
+    },
+    context: {
+      credsPayload,
+      resultPath: 'data.issueCreate',
+    },
+    inspect,
+  });
+};
+
+const funcApiConfig = {
+  argsWarden,
+};
+
+module.exports = {
+  linearIssueCreate,
+  funcApiConfig,
+};
+
+/*
+curl -X POST "http://localhost:8000/linearIssueCreate" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "credsPayload": { "credsPath": "linear" },
+    "input": {
+      "title": "Example issue",
+      "teamId": "f2387dcd-61ac-49aa-8d7a-7f62a0b5cca0"
+    }
+  }'
+*/