.all-contributorsrc

@@ -17,6 +17,25 @@
         "security",
         "bug"
       ]
+    },
+    {
+      "login": "AlexandreMalaj",
+      "name": "Alexandre Malaj",
+      "avatar_url": "https://avatars.githubusercontent.com/u/32218832?v=4",
+      "profile": "https://github.com/AlexandreMalaj",
+      "contributions": [
+        "code",
+        "doc"
+      ]
+    },
+    {
+      "login": "Rossb0b",
+      "name": "Nicolas Hallaert",
+      "avatar_url": "https://avatars.githubusercontent.com/u/39910164?v=4",
+      "profile": "https://www.linkedin.com/in/nicolas-hallaert/",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 7,

CONTRIBUTING.md

@@ -0,0 +1,46 @@
+# Contributing to NodeSecure
+
+Contributions to NodeSecure include code, documentation, answering user questions and
+running the project's infrastructure
+
+The NodeSecure project welcomes all contributions from anyone willing to work in
+good faith with other contributors and the community. No contribution is too
+small and all contributions are valued.
+
+This guide explains the process for contributing to the NodeSecure project's.
+
+## [Code of Conduct](https://github.com/NodeSecure/Governance/blob/main/CODE_OF_CONDUCT.md)
+
+The NodeSecure project has a
+[Code of Conduct](https://github.com/NodeSecure/Governance/blob/main/CODE_OF_CONDUCT.md)
+that *all* contributors are expected to follow. This code describes the
+*minimum* behavior expectations for all contributors.
+
+See [details on our policy on Code of Conduct](https://github.com/NodeSecure/Governance/blob/main/COC_POLICY.md).
+
+<a id="developers-certificate-of-origin"></a>
+## Developer's Certificate of Origin 1.1
+
+By making a contribution to this project, I certify that:
+
+* (a) The contribution was created in whole or in part by me and I
+  have the right to submit it under the open source license
+  indicated in the file; or
+
+* (b) The contribution is based upon previous work that, to the best
+  of my knowledge, is covered under an appropriate open source
+  license and I have the right under that license to submit that
+  work with modifications, whether created in whole or in part
+  by me, under the same open source license (unless I am
+  permitted to submit under a different license), as indicated
+  in the file; or
+
+* (c) The contribution was provided directly to me by some other
+  person who certified (a), (b) or (c) and I have not modified
+  it.
+
+* (d) I understand and agree that this project and the contribution
+  are public and that a record of the contribution (including all
+  personal information I submit with it, including my sign-off) is
+  maintained indefinitely and may be redistributed consistent with
+  this project or the open source license(s) involved.

README.md

@@ -30,6 +30,9 @@ console.log(utils.location);
 
 const scanner = await github.downloadAndExtract("NodeSecure.scanner");
 console.log(scanner.location);
+
+const contributors = await github.getContributorsLastActivities("NodeSecure", "scanner");
+console.log(contributors);
 ```
 
 ## API
@@ -74,8 +77,24 @@ export interface DownloadResult {
   organization: string;
 }
 
+export interface GetContributorsLastActivities {
+  token?: string;
+}
+
+export interface GetContributorsLastActivitiesResult {
+  [key: string]: {
+    repository: string;
+    actualRepo: boolean,
+    lastActivity: string;
+  }[];
+}
 export function download(repo: string, options?: DownloadOptions): Promise<DownloadResult>;
 export function downloadAndExtract(repo: string, options?: ExtractOptions): Promise<DownloadResult>;
+export function getContributorsLastActivities(
+  owner: string,
+  repository: string,
+  options?: GetContributorsLastActivities
+): Promise<GetContributorsLastActivitiesResult | null>;
 export function setToken(githubToken: string): void;
 ```
 
@@ -91,7 +110,7 @@ github.setToken("...");
 ## Contributors ✨
 
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-1-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-3-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
@@ -102,6 +121,8 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
 <table>
   <tr>
     <td align="center"><a href="https://www.linkedin.com/in/thomas-gentilhomme/"><img src="https://avatars.githubusercontent.com/u/4438263?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Gentilhomme</b></sub></a><br /><a href="https://github.com/NodeSecure/github/commits?author=fraxken" title="Code">💻</a> <a href="https://github.com/NodeSecure/github/commits?author=fraxken" title="Documentation">📖</a> <a href="https://github.com/NodeSecure/github/pulls?q=is%3Apr+reviewed-by%3Afraxken" title="Reviewed Pull Requests">👀</a> <a href="#security-fraxken" title="Security">🛡️</a> <a href="https://github.com/NodeSecure/github/issues?q=author%3Afraxken" title="Bug reports">🐛</a></td>
+    <td align="center"><a href="https://github.com/AlexandreMalaj"><img src="https://avatars.githubusercontent.com/u/32218832?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Alexandre Malaj</b></sub></a><br /><a href="https://github.com/NodeSecure/github/commits?author=AlexandreMalaj" title="Code">💻</a> <a href="https://github.com/NodeSecure/github/commits?author=AlexandreMalaj" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://www.linkedin.com/in/nicolas-hallaert/"><img src="https://avatars.githubusercontent.com/u/39910164?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Nicolas Hallaert</b></sub></a><br /><a href="https://github.com/NodeSecure/github/commits?author=Rossb0b" title="Code">💻</a></td>
   </tr>
 </table>
 

index.d.ts

@@ -37,6 +37,23 @@ export interface DownloadResult {
   organization: string;
 }
 
+export interface GetContributorsLastActivities {
+  token?: string;
+}
+
+export interface GetContributorsLastActivitiesResult {
+  [key: string]: {
+    repository: string;
+    actualRepo: boolean,
+    lastActivity: string;
+  }[];
+}
+
 export function download(repo: string, options?: DownloadOptions): Promise<DownloadResult>;
 export function downloadAndExtract(repo: string, options?: ExtractOptions): Promise<DownloadResult>;
+export function getContributorsLastActivities(
+  owner: string,
+  repository: string,
+  options?: GetContributorsLastActivities
+): Promise<GetContributorsLastActivitiesResult | null>;
 export function setToken(githubToken: string): void;

index.js

@@ -11,6 +11,7 @@ import httpie from "@myunisoft/httpie";
 
 // CONSTANTS
 const kGithubURL = new URL("https://github.com/");
+const kGithubApi = new URL("https://api.github.com/");
 const kDefaultBranch = "main";
 
 // VARS
@@ -78,6 +79,77 @@ export async function downloadAndExtract(repository, options = Object.create(nul
   return result;
 }
 
+export async function getContributorsLastActivities(owner, repository, options = Object.create(null)) {
+  if (typeof owner !== "string") {
+    throw new TypeError(`owner must be a string, but got ${owner}`);
+  }
+
+  if (typeof repository !== "string") {
+    throw new TypeError(`repository must be a string, but got ${repository}`);
+  }
+
+  const { token } = options;
+
+  const contributorsUrl = new URL(`repos/${owner}/${repository}/contributors`, kGithubApi);
+
+  try {
+    const { data } = await httpie.get(contributorsUrl, {
+      headers: {
+        "User-Agent": "NodeSecure",
+        Authorization: typeof token === "string" ? `token ${token}` : GITHUB_TOKEN
+      },
+      maxRedirections: 1
+    });
+
+    const contributors = data.filter((contributor) => !/bot/.test(contributor.login))
+      .map((contributor) => hydrateLastActivities(contributor.login, owner, repository));
+
+    const lastActivities = new Map(await Promise.all(contributors));
+
+    return lastActivities;
+  }
+  catch (error) {
+    return null;
+  }
+}
+
+async function hydrateLastActivities(contributor, owner, repository) {
+  const formatedRepositoryName = `${owner}/${repository}`;
+
+  const eventsUrl = new URL(`users/${contributor}/events`, kGithubApi);
+
+  const { data } = await httpie.get(eventsUrl, {
+    headers: {
+      "User-Agent": "NodeSecure",
+      Authorization: typeof token === "string" ? `token ${token}` : GITHUB_TOKEN
+    },
+    maxRedirections: 1
+  });
+
+  function getLastEvents(events) {
+    const lastEvent = events[0];
+    const lastRelatedEvent = events.find((event) => event.repo.name === formatedRepositoryName);
+
+    if (lastEvent.repo.name === formatedRepositoryName) {
+      return [lastEvent];
+    }
+
+    return lastRelatedEvent ?
+      [lastEvent, lastRelatedEvent] : [lastEvent];
+  }
+
+  return [contributor,
+    [...getLastEvents(data)]
+      .map((event) => {
+        return {
+          repository: event.repo.name,
+          actualRepo: event.repo.name === formatedRepositoryName,
+          lastActivity: event.created_at
+        };
+      })
+  ];
+}
+
 export function setToken(githubToken) {
   GITHUB_TOKEN = githubToken;
 }