chore(release): 2.2.0 [skip ci]

# [2.2.0](https://github.com/simonecorsi/mawesome/compare/v2.1.0...v2.2.0) (2022-07-06)

### Bug Fixes

* compact by topic check ([49f6687](49f66875e3))
* compact by topic check ([01cfb39](01cfb39a41))
* docs ([4d7eef0](4d7eef0991))

### Features

* adds compacted by topics ([30fa351](30fa351b37))
* adds compacted by topics ([9dfa1f3](9dfa1f3dae))

.eslintrc

@@ -1,21 +0,0 @@
-{
-  "parser": "@typescript-eslint/parser",
-  "parserOptions": {
-    "ecmaVersion": 2020,
-    "sourceType": "module"
-  },
-  "env": {
-    "es6": true,
-    "node": true
-  },
-  "extends": [
-    "prettier/@typescript-eslint",
-    "plugin:@typescript-eslint/recommended",
-    "plugin:prettier/recommended"
-  ],
-  "rules": {
-    "@typescript-eslint/no-var-requires": "off",
-    "prefer-rest-params": "off",
-    "@typescript-eslint/no-non-null-assertion": "off"
-  }
-}

.eslintrc.js

@@ -0,0 +1,17 @@
+module.exports = {
+  root: true,
+  parserOptions: {
+    ecmaVersion: 2022,
+    sourceType: 'module',
+  },
+  env: {
+    node: true,
+  },
+  parser: '@typescript-eslint/parser',
+  plugins: ['@typescript-eslint'],
+  extends: [
+    'eslint:recommended',
+    'plugin:prettier/recommended',
+    'plugin:@typescript-eslint/recommended',
+  ],
+};

.github/CODEOWNERS

@@ -0,0 +1,13 @@
+# Lines starting with '#' are comments.
+# Each line is a file pattern followed by one or more owners.
+
+# These owners will be the default owners for everything in the repo.
+*       @simonecorsi
+
+# Order is important. The last matching pattern has the most precedence.
+# So if a pull request only touches javascript files, only these owners
+# will be requested to review.
+# *.js    @octocat @github/js
+
+# You can also use email addresses if you prefer.
+# docs/*  docs@example.com

.github/dependabot.yml

@@ -0,0 +1,18 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://help.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: 'npm' # See documentation for possible values
+    directory: '/' # Location of package manifests
+    schedule:
+      interval: 'daily'
+    open-pull-requests-limit: 10
+
+  - package-ecosystem: 'github-actions'
+    directory: '/'
+    schedule:
+      interval: 'daily'
+    open-pull-requests-limit: 10

.github/pull_request_template.md

@@ -0,0 +1,15 @@
+## 🚨 Proposed changes
+
+> Please review the [guidelines for contributing](../../CONTRIBUTING.md) to this repository.
+
+[[Describe the big picture of your changes here to communicate to the maintainers why we should accept this pull request. If it fixes a bug or resolves a feature request, be sure to link to that issue.]]
+
+## ⚙️ Types of changes
+
+What types of changes does your code introduce? _Put an `x` in the boxes that apply_
+
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Bugfix (non-breaking change which fixes an issue)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation Update (if none of the other choices apply)
+- [ ] Refactor

.github/workflows/release.yaml

@@ -1,44 +0,0 @@
-name: Publish workflow
-
-on:
-  push:
-    branches: main
-
-jobs:
-  version:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v2
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-
-      - uses: fregante/setup-git-user@v1
-
-      - uses: actions/cache@v2
-        with:
-          path: '**/node_modules'
-          key: ${{ runner.os }}-modules-${{ hashFiles('**/package-lock.json') }}
-
-      - name: build
-        run: npm ci && npm run build
-
-      - name: Bump version and push tag
-        id: changelog
-        uses: TriPSs/conventional-changelog-action@v2
-        with:
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-          git-message: 'chore(release): {version}'
-          preset: ''
-
-      - name: Create github Release
-        uses: actions/create-release@v1
-        if: ${{ steps.changelog.outputs.skipped == 'false' }}
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          tag_name: ${{ steps.changelog.outputs.tag }}
-          release_name: ${{ steps.changelog.outputs.tag }}
-          body: ${{ steps.changelog.outputs.changelog }}
-
-      - name: Latest tag
-        uses: EndBug/latest-tag@v1.4.0

.github/workflows/release.yml

@@ -0,0 +1,28 @@
+name: Release
+
+on: [workflow_dispatch]
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 16
+      - uses: actions/checkout@v3
+        with:
+          token: ${{ secrets.GH_TOKEN }}
+          persist-credentials: false
+
+      - name: Install dependencies
+        run: npm i
+
+      - name: Build
+        run: npm run build
+
+      - name: Semantic release
+        uses: codfish/semantic-release-action@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
+          GIT_AUTHOR_NAME: '${{ github.actor }}'
+          GIT_COMMITTER_NAME: '${{ github.actor }}'

.husky/.gitignore

@@ -0,0 +1 @@
+_

.husky/commit-msg

@@ -0,0 +1,4 @@
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
+
+npx --no-install commitlint --edit $1

.husky/pre-commit

@@ -0,0 +1,4 @@
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
+
+npx --no-install lint-staged

.huskyrc.js

@@ -1,7 +0,0 @@
-module.exports = {
-  hooks: {
-    'prepare-commit-msg': 'exec < /dev/tty && git cz --hook || true',
-    'pre-commit': 'lint-staged',
-    'commit-msg': 'commitlint -E HUSKY_GIT_PARAMS',
-  },
-};

.releaserc.json

@@ -0,0 +1,30 @@
+{
+  "branches": [
+    { "name": "main" },
+    { "name": "next", "channel": "next", "prerelease": true }
+  ],
+  "plugins": [
+    "@semantic-release/commit-analyzer",
+    "@semantic-release/release-notes-generator",
+    "@semantic-release/changelog",
+    [
+      "@semantic-release/git",
+      {
+        "assets": [
+          "index.js",
+          "CHANGELOG.md",
+          "package.json",
+          "package-lock.json"
+        ]
+      }
+    ],
+    "@semantic-release/github",
+    [
+      "@saithodev/semantic-release-backmerge",
+      {
+        "branches": [{ "from": "main", "to": "next" }],
+        "clearWorkspace": true
+      }
+    ]
+  ]
+}

CHANGELOG.md

@@ -1,86 +1,97 @@
-## <small>1.0.27 (2021-01-16)</small>
-
-* docs: typo ([46172a5](https://github.com/simonecorsi/mawesome/commit/46172a5))
+# [2.2.0](https://github.com/simonecorsi/mawesome/compare/v2.1.0...v2.2.0) (2022-07-06)
 
 
+### Bug Fixes
 
-## <small>1.0.26 (2021-01-16)</small>
-
-* chore: added link to project ([0543c05](https://github.com/simonecorsi/mawesome/commit/0543c05))
-* chore(release): v1.0.26 ([8bc2714](https://github.com/simonecorsi/mawesome/commit/8bc2714))
+* compact by topic check ([49f6687](https://github.com/simonecorsi/mawesome/commit/49f66875e34ef186f183e370979ef751694d08b2))
+* compact by topic check ([01cfb39](https://github.com/simonecorsi/mawesome/commit/01cfb39a41a2f60c709fd6dd6a46073149d96c20))
+* docs ([4d7eef0](https://github.com/simonecorsi/mawesome/commit/4d7eef0991d896027ac464a40edfc564ced6bdd2))
 
 
+### Features
 
-## <small>1.0.25 (2021-01-16)</small>
+* adds compacted by topics ([30fa351](https://github.com/simonecorsi/mawesome/commit/30fa351b37a04357303f59c79a90f92219f8072c))
+* adds compacted by topics ([9dfa1f3](https://github.com/simonecorsi/mawesome/commit/9dfa1f3dae6c69033c682211c0e6bd9dc5a81eaf))
 
-* chore: action name ([8f3ce98](https://github.com/simonecorsi/mawesome/commit/8f3ce98))
-* chore: moved helpers in own file ([29bcf41](https://github.com/simonecorsi/mawesome/commit/29bcf41))
-* chore: namings ([b16fdb0](https://github.com/simonecorsi/mawesome/commit/b16fdb0))
-* chore: post release script ([12dd0e4](https://github.com/simonecorsi/mawesome/commit/12dd0e4))
-* chore(action.yml): node downgrated to 12 ([f91b26b](https://github.com/simonecorsi/mawesome/commit/f91b26b))
-* chore(action.yml): updated ([7bdae48](https://github.com/simonecorsi/mawesome/commit/7bdae48))
-* chore(release): 1.0.1 ([4193d0e](https://github.com/simonecorsi/mawesome/commit/4193d0e))
-* chore(release): 1.0.2 ([00b27bf](https://github.com/simonecorsi/mawesome/commit/00b27bf))
-* chore(release): 1.0.3 ([bb5dd1f](https://github.com/simonecorsi/mawesome/commit/bb5dd1f))
-* chore(release): 1.0.4 ([be86777](https://github.com/simonecorsi/mawesome/commit/be86777))
-* chore(release): 1.0.5 ([a47a53f](https://github.com/simonecorsi/mawesome/commit/a47a53f))
-* chore(release): v1.0.1 ([e297342](https://github.com/simonecorsi/mawesome/commit/e297342))
-* chore(release): v1.0.10 ([c2a11da](https://github.com/simonecorsi/mawesome/commit/c2a11da))
-* chore(release): v1.0.11 ([ab4322e](https://github.com/simonecorsi/mawesome/commit/ab4322e))
-* chore(release): v1.0.12 ([0be94f1](https://github.com/simonecorsi/mawesome/commit/0be94f1))
-* chore(release): v1.0.13 ([ee21996](https://github.com/simonecorsi/mawesome/commit/ee21996))
-* chore(release): v1.0.14 ([91de25f](https://github.com/simonecorsi/mawesome/commit/91de25f))
-* chore(release): v1.0.15 ([03e1973](https://github.com/simonecorsi/mawesome/commit/03e1973))
-* chore(release): v1.0.16 ([f8cb892](https://github.com/simonecorsi/mawesome/commit/f8cb892))
-* chore(release): v1.0.17 ([380a0ec](https://github.com/simonecorsi/mawesome/commit/380a0ec))
-* chore(release): v1.0.18 ([d82b715](https://github.com/simonecorsi/mawesome/commit/d82b715))
-* chore(release): v1.0.19 ([7a46627](https://github.com/simonecorsi/mawesome/commit/7a46627))
-* chore(release): v1.0.2 ([3cba062](https://github.com/simonecorsi/mawesome/commit/3cba062))
-* chore(release): v1.0.20 ([738785e](https://github.com/simonecorsi/mawesome/commit/738785e))
-* chore(release): v1.0.21 ([3c3ab0a](https://github.com/simonecorsi/mawesome/commit/3c3ab0a))
-* chore(release): v1.0.22 ([3f66738](https://github.com/simonecorsi/mawesome/commit/3f66738))
-* chore(release): v1.0.23 ([f41befa](https://github.com/simonecorsi/mawesome/commit/f41befa))
-* chore(release): v1.0.24 ([9badeaf](https://github.com/simonecorsi/mawesome/commit/9badeaf))
-* chore(release): v1.0.25 ([14ccc97](https://github.com/simonecorsi/mawesome/commit/14ccc97))
-* chore(release): v1.0.3 ([71625bd](https://github.com/simonecorsi/mawesome/commit/71625bd))
-* chore(release): v1.0.4 ([46583c7](https://github.com/simonecorsi/mawesome/commit/46583c7))
-* chore(release): v1.0.5 ([ba24bdf](https://github.com/simonecorsi/mawesome/commit/ba24bdf))
-* chore(release): v1.0.6 ([6cb192b](https://github.com/simonecorsi/mawesome/commit/6cb192b))
-* chore(release): v1.0.7 ([410e2a7](https://github.com/simonecorsi/mawesome/commit/410e2a7))
-* chore(release): v1.0.8 ([324332b](https://github.com/simonecorsi/mawesome/commit/324332b))
-* chore(release): v1.0.9 ([7499f86](https://github.com/simonecorsi/mawesome/commit/7499f86))
-* fix: added latest tag at release ([6b8b525](https://github.com/simonecorsi/mawesome/commit/6b8b525))
-* fix: added missing info for action publishing ([3703b66](https://github.com/simonecorsi/mawesome/commit/3703b66))
-* fix: added required label ([173ce50](https://github.com/simonecorsi/mawesome/commit/173ce50))
-* fix: bad quotes in url ([76d0173](https://github.com/simonecorsi/mawesome/commit/76d0173))
-* fix: better errors ([f302126](https://github.com/simonecorsi/mawesome/commit/f302126))
-* fix: better template management ([9d06abc](https://github.com/simonecorsi/mawesome/commit/9d06abc))
-* fix: exit condition ([914a115](https://github.com/simonecorsi/mawesome/commit/914a115))
-* fix: git pull strategy ([edb4a38](https://github.com/simonecorsi/mawesome/commit/edb4a38))
-* fix: git push ([c8fb3f4](https://github.com/simonecorsi/mawesome/commit/c8fb3f4))
-* fix: if tempalte fail should exit(1) ([ee824d1](https://github.com/simonecorsi/mawesome/commit/ee824d1))
-* fix: imports ([2e421f0](https://github.com/simonecorsi/mawesome/commit/2e421f0))
-* fix: imports ([376451a](https://github.com/simonecorsi/mawesome/commit/376451a))
-* fix: should fix unshallow repo ([17c5d85](https://github.com/simonecorsi/mawesome/commit/17c5d85))
-* fix: somehow runner wont see template ([808c35c](https://github.com/simonecorsi/mawesome/commit/808c35c))
-* fix: splitting tokens ([bd47078](https://github.com/simonecorsi/mawesome/commit/bd47078))
-* fix: template cannot be loaded from ejs file ([78c0f37](https://github.com/simonecorsi/mawesome/commit/78c0f37))
-* fix: variable name ([13e1fd1](https://github.com/simonecorsi/mawesome/commit/13e1fd1))
-* fix(action.yml): output file now correct path ([98b17f8](https://github.com/simonecorsi/mawesome/commit/98b17f8))
-* fix(ci): bad syntax ([caaf6ab](https://github.com/simonecorsi/mawesome/commit/caaf6ab))
-* fix(index.ts): fs promise fixed path ([285e193](https://github.com/simonecorsi/mawesome/commit/285e193))
-* docs: added authors ([3de0e12](https://github.com/simonecorsi/mawesome/commit/3de0e12))
-* docs: added readme ([e1c9ca0](https://github.com/simonecorsi/mawesome/commit/e1c9ca0))
-* docs: readme updated ([192aa8a](https://github.com/simonecorsi/mawesome/commit/192aa8a))
-* feat: better errors ([1700aa3](https://github.com/simonecorsi/mawesome/commit/1700aa3))
-* feat: generate awesome list from stars ([0f6fa76](https://github.com/simonecorsi/mawesome/commit/0f6fa76))
-* feat: git user now is action ([aa70ac9](https://github.com/simonecorsi/mawesome/commit/aa70ac9))
-* ci: added github user setup ([a4bbd4b](https://github.com/simonecorsi/mawesome/commit/a4bbd4b))
-* ci: better release ([ea34727](https://github.com/simonecorsi/mawesome/commit/ea34727))
-* ci(version): prefixed now with v ([f3d2757](https://github.com/simonecorsi/mawesome/commit/f3d2757))
-* build: better releasing workflow ([ac6e274](https://github.com/simonecorsi/mawesome/commit/ac6e274))
-* build(index.js): build ([e007c3b](https://github.com/simonecorsi/mawesome/commit/e007c3b))
-* Initial commit ([e884018](https://github.com/simonecorsi/mawesome/commit/e884018))
+# [2.1.0](https://github.com/simonecorsi/mawesome/compare/v2.0.0...v2.1.0) (2022-05-11)
 
 
+### Bug Fixes
 
+* removes console.log ([7841262](https://github.com/simonecorsi/mawesome/commit/7841262e741f05debb7ffe6fed636a508a8f7c12))
+
+
+### Features
+
+* removes github-token need ([0dc2a51](https://github.com/simonecorsi/mawesome/commit/0dc2a51ddf3cf93414afd674ed3c34ec681f3e4b))
+
+# [2.0.0](https://github.com/simonecorsi/mawesome/compare/v1.0.45...v2.0.0) (2022-05-11)
+
+
+### Bug Fixes
+
+* fixes default template path ([6cd9c30](https://github.com/simonecorsi/mawesome/commit/6cd9c30b20acb0789668b9fd4cdbace2cb52d3ce))
+* fixes tsc build ([ec10b79](https://github.com/simonecorsi/mawesome/commit/ec10b79a91bc5894d35b80026d3e216420e0721a))
+* normalize template file loadup ([445f562](https://github.com/simonecorsi/mawesome/commit/445f562fb50567d995f0d080d4267fc8d494731b))
+* pre-tags ([d1d4edd](https://github.com/simonecorsi/mawesome/commit/d1d4edd104affc69984905c8408e859c25c58443))
+* removes unused tests ([a141d23](https://github.com/simonecorsi/mawesome/commit/a141d23972c31b3dbd7e9841168219ad42fa7a18))
+* reworking files ([19c4c8f](https://github.com/simonecorsi/mawesome/commit/19c4c8f761b244ddccbc445cc34078bf932559d2))
+* updates gh-star-fetch ([3ec4b7c](https://github.com/simonecorsi/mawesome/commit/3ec4b7cd53c1fe885a51fb64279047a201d535dc))
+
+
+### Features
+
+* release major ([51a4359](https://github.com/simonecorsi/mawesome/commit/51a4359d983be4c842410f0c62104fca1b28252f))
+* update to node16 ([e1f37af](https://github.com/simonecorsi/mawesome/commit/e1f37af978ebcb7f770949476ac7d6bc788a1fc2))
+* updates deps ([7ade95d](https://github.com/simonecorsi/mawesome/commit/7ade95df8566a59145652165400cddfd1afa4bed))
+* using gh-star-fetch ([346ba5d](https://github.com/simonecorsi/mawesome/commit/346ba5d4b7ba6a71bab99f2dbe3c2d010beb67d5))
+* **template:** adds templates ([2c742b8](https://github.com/simonecorsi/mawesome/commit/2c742b820558fd715de987178303c460f5871c29)), closes [#14](https://github.com/simonecorsi/mawesome/issues/14)
+
+
+### BREAKING CHANGES
+
+* refactored code
+
+# [1.1.0-next.2](https://github.com/simonecorsi/mawesome/compare/v1.1.0-next.1...v1.1.0-next.2) (2022-05-09)
+
+
+### Features
+
+* using gh-star-fetch ([a8b6577](https://github.com/simonecorsi/mawesome/commit/a8b657735b9879636cc039d79fddcdca33ccf38e))
+
+# [1.1.0-next.1](https://github.com/simonecorsi/mawesome/compare/v1.0.45...v1.1.0-next.1) (2022-04-13)
+
+
+### Bug Fixes
+
+* pre-tags ([602befc](https://github.com/simonecorsi/mawesome/commit/602befcb5494b5bfd74d2333899311b81ea9da6d))
+
+
+### Features
+
+* **template:** adds templates ([791de9a](https://github.com/simonecorsi/mawesome/commit/791de9ab504de50e2e9cb031b9e373d7cc0589c0)), closes [#14](https://github.com/simonecorsi/mawesome/issues/14)
+
+## <small>1.0.45 (2022-01-17)</small>
+
+- build(deps): bump shelljs from 0.8.4 to 0.8.5 ([1da350a](https://github.com/simonecorsi/mawesome/commit/1da350a))
+
+## <small>1.0.44 (2021-10-26)</small>
+
+- chore(release): v1.0.44 ([6ffe17f](https://github.com/simonecorsi/mawesome/commit/6ffe17f))
+- feat: git add multiple files at once ([4aef61f](https://github.com/simonecorsi/mawesome/commit/4aef61f))
+
+## <small>1.0.43 (2021-10-15)</small>
+
+- chore(release): v1.0.43 ([5e0ef82](https://github.com/simonecorsi/mawesome/commit/5e0ef82))
+- feat: reduce json output size ([94635fe](https://github.com/simonecorsi/mawesome/commit/94635fe))
+
+## <small>1.0.42 (2021-10-14)</small>
+
+- chore(release): v1.0.42 ([5b36813](https://github.com/simonecorsi/mawesome/commit/5b36813))
+- fix(paginator): last page now correctly matches rex ([dcf9898](https://github.com/simonecorsi/mawesome/commit/dcf9898))
+
+## <small>1.0.41 (2021-10-14)</small>
+
+- chore(release): v1.0.41 ([884fc90](https://github.com/simonecorsi/mawesome/commit/884fc90))
+- test: fixs suite ([b97833f](https://github.com/simonecorsi/mawesome/commit/b97833f))
+- fix: should avoid index lock ([1d6848c](https://github.com/simonecorsi/mawesome/commit/1d6848c))

README.md

@@ -1,31 +1,65 @@
-# My Awesome list
+# My Awesome List
 
-This action query the github api to get starred list of the user and then generates a list ordered by languages. 
+This action query the github api to get starred list of the user and then generates a list ordered by languages.
 
 You can see an example of the output at my own [simonecorsi/awesome](https://github.com/simonecorsi/awesome)
 
-## Setup
+## Table of Contents
 
-To use this action you have to create your own repository (eg: `yourname/awesome`), then create a new empty action in it and then use the [example workflow](#example-workflow) below as a starting point.
+<!-- toc -->
 
-## Inputs
+- [Documentation](#documentation)
+  - [Requirements](#requirements)
+  - [Configuration](#configuration)
+    - [`api-token`](#api-token)
+    - [`compact-by-topic`](#compact-by-topic)
+    - [`template-path`](#template-path)
+- [Example workflow](#example-workflow)
 
-### `github-token`
+<!-- tocstop -->
 
-The github workflow token is mandatory 
+## Documentation
 
-### `api-token`
+### Requirements
+
+- An empty repository
+- A personal github api key
+
+### Configuration
+
+The service can be configured setting the appropriate environment variables or writing an `.env` file.
+
+| Variable           | Description                                                         | Default                          |
+| ------------------ | ------------------------------------------------------------------- | -------------------------------- |
+| `api-token`        | Personal Token is used to avoid rate limit, [read more](#api-token) | `${{ secrets.API_TOKEN }}`       |
+| `compact-by-topic` | Render another list in `TOPICS.md` compacted by github topics       | `'false'`                        |
+| `github-name`      | Name used for the commit                                            | Github Action                    |
+| `github-email`     | email used for commit                                               | actions@users.noreply.github.com |
+| `template-path`    | Custom `README.md` template, [read more](#template-path)            |
+| `output-filename`  | Output filename                                                     | `README.md`                      |
+
+#### `api-token`
 
 The Personal API Access Token is mandatory to fetch stars from the API without incurring in Rate Limits.
 
-You'll have to generate a [personal api token](https://github.com/settings/tokens/new) and then add 
+You'll have to generate a [personal api token](https://github.com/settings/tokens/new) and then add
+
+#### `compact-by-topic`
+
+If `compact-by-topic` is `'true'` it will generate another markdown file `TOPICS.md` whith all stars compacted by their github topics, be aware that this list will be bigger since data is duplicated.
+
+#### `template-path`
+
+If you don't like the output (default example [here](./TEMPLATE.ejs) ), you can provide your custom template that will be rendered using [EJS](https://ejs.co/) template engine.
+
+Path provided is relative to your current repository directory, if file is not found it will default.
 
 ## Example workflow
 
 ```yml
 name: Update awesome list
 
-on: 
+on:
   workflow_dispatch:
   schedule:
     - cron: '0 0 * * *'
@@ -36,8 +70,10 @@ jobs:
     steps:
       - uses: actions/checkout@v2
       - name: Awesome generator
-        uses: simonecorsi/mawesome@lastest
+        uses: simonecorsi/mawesome@latest
         with:
           api-token: ${{ secrets.API_TOKEN }}
           github-token: ${{ secrets.GITHUB_TOKEN }}
+          github-email: ${{ secrets.USER_EMAIL }}
+          github-name: ${{ github.repository_owner }}
 ```

TEMPLATE.ejs

@@ -1,4 +1,4 @@
-export default `# <%= username %> Awesome List [![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/sindresorhus/awesome)
+# <%= username %> Awesome List [![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/sindresorhus/awesome)
 
 > :star: generated with [simonecorsi/mawesome](https://github.com/simonecorsi/mawesome)
 
@@ -11,4 +11,3 @@ export default `# <%= username %> Awesome List [![Awesome](https://cdn.rawgit.co
 <% } %>  
 
 <% } %>
-`;

action.yml

@@ -4,12 +4,29 @@ branding:
   icon: align-justify
   color: yellow
 inputs:
-  github-token:
-    description: 'Github token'
-    required: true
+  compact-by-topic:
+    description: 'Generate another page with output compacted by github topics'
+    default: 'false'
+    required: false
   api-token:
     description: 'Personal API Token'
     required: true
+  github-name:
+    description: 'Name shown in the commit'
+    default: 'GitHub Actions'
+    required: false
+  github-email:
+    description: 'Email shown in the commit'
+    default: 'actions@users.noreply.github.com'
+    required: false
+  template-path:
+    required: false
+    description: 'EJS template path relative to project root directory'
+    default: 'TEMPLATE.ejs'
+  output-filename:
+    description: 'The output file name, default to README.md'
+    required: false
+    default: 'README.md'
 runs:
-  using: 'node12'
+  using: 'node16'
   main: 'index.js'

package.json

@@ -1,17 +1,16 @@
 {
   "name": "mawesome",
-  "version": "1.0.27",
+  "version": "2.0.0-0",
   "description": "Generate awesome list from user starred repositories",
   "main": "index.js",
   "author": "Simone Corsi<simonecorsi.dev@gmail.com>",
   "license": "MIT",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
     "style:lint": "eslint src --ext .ts",
     "style:prettier": "prettier \"src/**/*.ts\" --list-different --write",
     "build": "./node_modules/.bin/ncc build src/index.ts -o ./",
     "dev": "ts-node-dev src/index.ts",
-    "prerelease": "npm run build && "
+    "prepare": "node prepare.js || echo 'Skipping prepare'"
   },
   "keywords": [
     "github",
@@ -23,44 +22,47 @@
     "javascript"
   ],
   "devDependencies": {
-    "@commitlint/cli": "^11.0.0",
-    "@commitlint/config-conventional": "^11.0.0",
-    "@octokit/rest": "^18.0.12",
-    "@octokit/types": "^6.2.1",
-    "@types/ejs": "^3.0.5",
-    "@types/got": "^9.6.11",
-    "@types/node": "^14.14.5",
-    "@typescript-eslint/eslint-plugin": "^4.6.0",
-    "@typescript-eslint/parser": "^4.6.0",
-    "@vercel/ncc": "^0.26.2",
-    "ava": "^3.8.2",
-    "benchmark": "^2.1.4",
-    "conventional-gitlab-releaser": "^4.0.1",
-    "cz-conventional-changelog": "^3.2.0",
-    "eslint": "^7.17.0",
-    "eslint-config-prettier": "^7.1.0",
+    "@commitlint/cli": "^17.0.3",
+    "@commitlint/config-conventional": "^17.0.3",
+    "@octokit/rest": "^18.12.0",
+    "@octokit/types": "^6.39.0",
+    "@saithodev/semantic-release-backmerge": "^2.1.2",
+    "@semantic-release/changelog": "^6.0.1",
+    "@semantic-release/commit-analyzer": "^9.0.2",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^8.0.4",
+    "@semantic-release/release-notes-generator": "^10.0.3",
+    "@types/ejs": "^3.1.1",
+    "@types/got": "^9.6.12",
+    "@types/node": "^18.0.3",
+    "@types/sinon": "^10.0.12",
+    "@typescript-eslint/eslint-plugin": "^5.30.5",
+    "@typescript-eslint/parser": "^5.30.5",
+    "@vercel/ncc": "^0.34.0",
+    "eslint": "^8.19.0",
+    "eslint-config-prettier": "^8.5.0",
     "eslint-plugin-node": "^11.1.0",
-    "eslint-plugin-prettier": "^3.3.1",
-    "husky": "^4.2.5",
-    "lint-staged": "^10.2.2",
+    "eslint-plugin-prettier": "^4.2.1",
+    "husky": "^8.0.1",
+    "lint-staged": "^13.0.3",
     "markdown-toc": "^1.2.0",
-    "ninos": "^3.0.0",
     "nyc": "^15.0.1",
-    "prettier": "^2.0.5",
-    "standard-version": "^9.0.0",
-    "ts-node-dev": "^1.1.1",
-    "typescript": "^4.1.3"
+    "prettier": "^2.7.1",
+    "sinon": "^14.0.0",
+    "ts-node-dev": "^2.0.0",
+    "typescript": "^4.7.4"
   },
   "dependencies": {
-    "@actions/exec": "^1.0.4",
-    "@actions/core": "^1.2.6",
-    "@actions/github": "^4.0.0",
-    "ejs": "^3.1.5",
+    "@actions/core": "^1.9.0",
+    "@actions/exec": "^1.1.1",
+    "ejs": "^3.1.8",
+    "gh-star-fetch": "^1.5.0",
     "got": "^11.8.1",
-    "remark": "^13.0.0",
-    "remark-toc": "^7.0.0"
+    "remark": "^14.0.2",
+    "remark-toc": "^8.0.1"
   },
   "volta": {
-    "node": "14.15.4"
+    "node": "16.14.2",
+    "npm": "8.6.0"
   }
-}
+}

prepare.js

@@ -0,0 +1,13 @@
+'use strict';
+
+let isCi = false;
+
+try {
+  isCi = require('is-ci');
+} catch (_) {
+  isCi = true;
+}
+
+if (!isCi) {
+  require('husky').install();
+}

src/api.ts

@@ -1,11 +0,0 @@
-import got from 'got';
-import * as core from '@actions/core';
-
-const GITHUB_TOKEN = core.getInput('api-token', { required: true });
-
-export default got.extend({
-  headers: {
-    Authorization: `token ${GITHUB_TOKEN}`,
-  },
-  responseType: 'json',
-});

src/git.ts

@@ -2,19 +2,29 @@
 
 import * as core from '@actions/core';
 import * as exec from '@actions/exec';
+import fs from 'fs/promises';
 
 const { GITHUB_REPOSITORY, GITHUB_REF } = process.env;
 
 const branch = GITHUB_REF?.replace('refs/heads/', '');
 
-export default new (class Git {
+type File = {
+  filename: string;
+  data: string;
+};
+
+class Git {
   constructor() {
-    const githubToken = core.getInput('github-token', { required: true });
+    const githubToken = core.getInput('api-token', { required: true });
     core.setSecret(githubToken);
 
+    const githubName = core.getInput('github-name') || 'GitHub Actions';
+    const githubEmail =
+      core.getInput('github-email') || 'actions@users.noreply.github.com';
+
     // Set config
-    this.config('user.name', 'GitHub Actions');
-    this.config('user.email', 'actions@users.noreply.github.com');
+    this.config('user.name', githubName);
+    this.config('user.email', githubEmail);
     this.config('pull.rebase', 'false');
 
     // Update the origin
@@ -31,33 +41,39 @@ export default new (class Git {
     return isShallow.trim().replace('\n', '') === 'true';
   };
 
-  exec = (command: string): Promise<string> => {
-    return new Promise(async (resolve, reject) => {
-      let execOutput = '';
+  async exec(command: string): Promise<string> {
+    let execOutput = '';
 
-      const options = {
-        listeners: {
-          stdout: (data: Buffer) => {
-            execOutput += data.toString();
-          },
+    const options = {
+      listeners: {
+        stdout: (data: Buffer) => {
+          execOutput += data.toString();
         },
-      };
+      },
+    };
 
-      const exitCode = await exec.exec(`git ${command}`, undefined, options);
+    const exitCode = await exec.exec(`git ${command}`, undefined, options);
 
-      if (exitCode === 0) {
-        return resolve(execOutput);
-      } else {
-        core.error(`Command "git ${command}" exited with code ${exitCode}.`);
-        return reject(`Command "git ${command}" exited with code ${exitCode}.`);
-      }
-    });
-  };
+    if (exitCode === 0) {
+      return execOutput;
+    } else {
+      core.error(`Command "git ${command}" exited with code ${exitCode}.`);
+      throw new Error(`Command "git ${command}" exited with code ${exitCode}.`);
+    }
+  }
 
   config = (prop: string, value: string) =>
     this.exec(`config ${prop} "${value}"`);
 
-  add = (file: string) => this.exec(`add ${file}`);
+  add = (file: string | string[]) => {
+    let str = '';
+    if (Array.isArray(file)) {
+      file.map((f) => (str += ` ${f}`));
+    } else {
+      str = file;
+    }
+    return this.exec(`add ${str}`);
+  };
 
   commit = (message: string) => this.exec(`commit -m "${message}"`);
 
@@ -80,4 +96,20 @@ export default new (class Git {
   updateOrigin = (repo: string) => this.exec(`remote set-url origin ${repo}`);
 
   createTag = (tag: string) => this.exec(`tag -a ${tag} -m "${tag}"`);
-})();
+
+  async pushNewFiles(files: File[] = []): Promise<any> {
+    if (!files.length) return;
+
+    await this.pull();
+
+    await Promise.all(
+      files.map(({ filename, data }) => fs.writeFile(filename, data))
+    );
+
+    await this.add(files.map(({ filename }) => filename));
+    await this.commit(`chore(updates): updated entries in files`);
+    await this.push();
+  }
+}
+
+export default new Git();

src/helpers.ts

@@ -1,30 +1,14 @@
 import ejs from 'ejs';
 import * as core from '@actions/core';
-import remark from 'remark';
+import { remark } from 'remark';
 import toc from 'remark-toc';
 
-import MD_TEMPLATE from './template';
-import GithubApi from './api';
-import link from './link';
-import git from './git';
-
-import type { PaginationLink, ApiGetStarResponse } from './types';
-
-import fs from 'fs';
-
-const fsp = fs.promises;
-
-export function wait(time = 200): Promise<void> {
-  return new Promise((resolve) => setTimeout(resolve, time));
-}
-
-export function isLastPage(links: PaginationLink): boolean {
-  return links.next === links.last;
-}
+export const REPO_USERNAME = process.env.GITHUB_REPOSITORY?.split('/')[0];
+export const API_STARRED_URL = `${process.env.GITHUB_API_URL}/users/${REPO_USERNAME}/starred`;
 
 export async function renderer(
   data: { [key: string]: any },
-  templateString = MD_TEMPLATE
+  templateString: string
 ): Promise<string> {
   try {
     return ejs.render(templateString, data);
@@ -34,34 +18,6 @@ export async function renderer(
   }
 }
 
-export async function apiGetStar(url: string): Promise<ApiGetStarResponse> {
-  const { headers, body }: any = await GithubApi.get(url);
-  return {
-    data: body,
-    links: link.parse(headers.link).refs.reduce(
-      (acc, val) => ({
-        ...acc,
-        [val.rel]: val.uri,
-      }),
-      {}
-    ),
-  };
-}
-
-export const REPO_USERNAME = process.env.GITHUB_REPOSITORY?.split('/')[0];
-export const API_STARRED_URL = `${process.env.GITHUB_API_URL}/users/${REPO_USERNAME}/starred`;
-
-let links: PaginationLink = {
-  next: API_STARRED_URL,
-  last: undefined,
-};
-export async function paginate(): Promise<ApiGetStarResponse | null> {
-  if (isLastPage(links)) return null;
-  const r = await apiGetStar(links.next);
-  links = r.links;
-  return r;
-}
-
 export function generateMd(data: string): Promise<string> {
   return new Promise((resolve) => {
     remark()
@@ -77,12 +33,4 @@ export function generateMd(data: string): Promise<string> {
   });
 }
 
-export const OUTPUT_FILENAME: string =
-  core.getInput('output-filename') || 'README.md';
-export async function pushNewFile(markdown: string): Promise<any> {
-  await fsp.writeFile(OUTPUT_FILENAME, markdown);
-  await git.pull();
-  await git.add(OUTPUT_FILENAME);
-  await git.commit(`chore(${OUTPUT_FILENAME}): updated ${OUTPUT_FILENAME}`);
-  await git.push();
-}
+export const MARKDOWN_FILENAME: string = core.getInput('output-filename');

src/index.ts

@@ -1,50 +1,85 @@
+import path from 'path';
 import * as core from '@actions/core';
+import { readFile } from 'fs/promises';
+import ghStarFetch, {
+  Options,
+  compactByLanguage,
+  compactByTopic,
+} from 'gh-star-fetch';
 
 import {
   renderer,
-  paginate,
   REPO_USERNAME,
   generateMd,
-  pushNewFile,
+  MARKDOWN_FILENAME,
 } from './helpers';
+import git from './git';
 
-import type { SortedLanguageList, Stars, Star } from './types';
-
-export async function main(): Promise<any> {
-  let results: Stars = [];
-
-  while (true) {
-    // sorry.
-    const r = await paginate();
-    if (!r || r === null) break;
-    results = results.concat(r.data);
-  }
-
-  const sortedByLanguages = results.reduce(
-    (acc: SortedLanguageList, val: Star) => {
-      const language = val.language || 'generic';
-      if (!acc[language]) {
-        acc[language] = [val];
-      } else {
-        acc[language].push(val);
-      }
-      return acc;
-    },
-    {}
+export async function main() {
+  // set default template
+  let template = await readFile(
+    path.resolve(__dirname, './TEMPLATE.ejs'),
+    'utf8'
   );
 
-  const rendered = await renderer({
-    username: REPO_USERNAME,
-    stars: Object.entries(sortedByLanguages),
-    updatedAt: Date.now(),
-  });
+  // get template if found in the repo
+  const customTemplatePath = core.getInput('template-path');
+  core.info(`check if customTemplatePath: ${customTemplatePath} exists`);
+  try {
+    template = await readFile(customTemplatePath, 'utf8');
+  } catch {
+    core.info("Couldn't find template file, using default");
+  }
 
-  const markdown: string = await generateMd(rendered);
+  const opts: Partial<Options> = {
+    accessToken: core.getInput('api-token', { required: true }),
+  };
 
-  await pushNewFile(markdown);
+  const results = await ghStarFetch(opts);
+
+  const files = [];
+
+  const compactedByLanguage = compactByLanguage(results);
+  const byLanguage = await renderer(
+    {
+      username: REPO_USERNAME,
+      stars: Object.entries(compactedByLanguage),
+      updatedAt: Date.now(),
+    },
+    template
+  );
+
+  files.push(
+    {
+      filename: MARKDOWN_FILENAME,
+      data: await generateMd(byLanguage),
+    },
+    {
+      filename: 'data.json',
+      data: JSON.stringify(compactedByLanguage, null, 2),
+    }
+  );
+
+  if (core.getInput('compact-by-topic') === 'true') {
+    const compactedByTopic = compactByTopic(results);
+    const byTopic = await renderer(
+      {
+        username: REPO_USERNAME,
+        stars: Object.entries(compactedByTopic),
+        updatedAt: Date.now(),
+      },
+      template
+    );
+    files.push({
+      filename: 'TOPICS.md',
+      data: await generateMd(byTopic),
+    });
+  }
+
+  await git.pushNewFiles(files);
 }
 
-export async function run(): Promise<any> {
+export async function run(): Promise<void> {
   try {
     await main();
   } catch (error) {
@@ -54,8 +89,9 @@ export async function run(): Promise<any> {
 
 const catchAll = (info: any) => {
   core.setFailed(`#catchAll: ${info}`);
+  core.error(info);
 };
 process.on('unhandledRejection', catchAll);
 process.on('uncaughtException', catchAll);
 
-run();
+run().catch(core.error);

src/link.js

@@ -1,383 +0,0 @@
-/**
- * Copyright (c) 2016 Jonas Hermsmeier
- * https://github.com/jhermsmeier/node-http-link-header
- */
-
-'use strict';
-
-var COMPATIBLE_ENCODING_PATTERN = /^utf-?8|ascii|utf-?16-?le|ucs-?2|base-?64|latin-?1$/i;
-var WS_TRIM_PATTERN = /^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g;
-var WS_CHAR_PATTERN = /\s|\uFEFF|\xA0/;
-var WS_FOLD_PATTERN = /\r?\n[\x20\x09]+/g;
-var DELIMITER_PATTERN = /[;,"]/;
-var WS_DELIMITER_PATTERN = /[;,"]|\s/;
-
-/**
- * Token character pattern
- * @type {RegExp}
- * @see https://tools.ietf.org/html/rfc7230#section-3.2.6
- */
-var TOKEN_PATTERN = /^[!#$%&'*+\-\.^_`|~\da-zA-Z]+$/;
-
-var STATE = {
-  IDLE: 1 << 0,
-  URI: 1 << 1,
-  ATTR: 1 << 2,
-};
-
-function trim(value) {
-  return value.replace(WS_TRIM_PATTERN, '');
-}
-
-function hasWhitespace(value) {
-  return WS_CHAR_PATTERN.test(value);
-}
-
-function skipWhitespace(value, offset) {
-  while (hasWhitespace(value[offset])) {
-    offset++;
-  }
-  return offset;
-}
-
-function needsQuotes(value) {
-  return WS_DELIMITER_PATTERN.test(value) || !TOKEN_PATTERN.test(value);
-}
-
-class Link {
-  /**
-   * Link
-   * @constructor
-   * @param {String} [value]
-   * @returns {Link}
-   */
-  constructor(value) {
-    /** @type {Array} URI references */
-    this.refs = [];
-
-    if (value) {
-      this.parse(value);
-    }
-  }
-
-  /**
-   * Get refs with given relation type
-   * @param {String} value
-   * @returns {Array<Object>}
-   */
-  rel(value) {
-    var links = [];
-    var type = value.toLowerCase();
-
-    for (var i = 0; i < this.refs.length; i++) {
-      if (this.refs[i].rel.toLowerCase() === type) {
-        links.push(this.refs[i]);
-      }
-    }
-
-    return links;
-  }
-
-  /**
-   * Get refs where given attribute has a given value
-   * @param {String} attr
-   * @param {String} value
-   * @returns {Array<Object>}
-   */
-  get(attr, value) {
-    attr = attr.toLowerCase();
-
-    var links = [];
-
-    for (var i = 0; i < this.refs.length; i++) {
-      if (this.refs[i][attr] === value) {
-        links.push(this.refs[i]);
-      }
-    }
-
-    return links;
-  }
-
-  set(link) {
-    this.refs.push(link);
-    return this;
-  }
-
-  has(attr, value) {
-    attr = attr.toLowerCase();
-
-    for (var i = 0; i < this.refs.length; i++) {
-      if (this.refs[i][attr] === value) {
-        return true;
-      }
-    }
-
-    return false;
-  }
-
-  parse(value, offset) {
-    offset = offset || 0;
-    value = offset ? value.slice(offset) : value;
-
-    // Trim & unfold folded lines
-    value = trim(value).replace(WS_FOLD_PATTERN, '');
-
-    var state = STATE.IDLE;
-    var length = value.length;
-    var offset = 0;
-    var ref = null;
-
-    while (offset < length) {
-      if (state === STATE.IDLE) {
-        if (hasWhitespace(value[offset])) {
-          offset++;
-          continue;
-        } else if (value[offset] === '<') {
-          if (ref != null) {
-            ref.rel != null
-              ? this.refs.push(...Link.expandRelations(ref))
-              : this.refs.push(ref);
-          }
-          var end = value.indexOf('>', offset);
-          if (end === -1)
-            throw new Error(
-              'Expected end of URI delimiter at offset ' + offset
-            );
-          ref = { uri: value.slice(offset + 1, end) };
-          // this.refs.push( ref )
-          offset = end;
-          state = STATE.URI;
-        } else {
-          throw new Error(
-            'Unexpected character "' + value[offset] + '" at offset ' + offset
-          );
-        }
-        offset++;
-      } else if (state === STATE.URI) {
-        if (hasWhitespace(value[offset])) {
-          offset++;
-          continue;
-        } else if (value[offset] === ';') {
-          state = STATE.ATTR;
-          offset++;
-        } else if (value[offset] === ',') {
-          state = STATE.IDLE;
-          offset++;
-        } else {
-          throw new Error(
-            'Unexpected character "' + value[offset] + '" at offset ' + offset
-          );
-        }
-      } else if (state === STATE.ATTR) {
-        if (value[offset] === ';' || hasWhitespace(value[offset])) {
-          offset++;
-          continue;
-        }
-        var end = value.indexOf('=', offset);
-        if (end === -1)
-          throw new Error('Expected attribute delimiter at offset ' + offset);
-        var attr = trim(value.slice(offset, end)).toLowerCase();
-        var attrValue = '';
-        offset = end + 1;
-        offset = skipWhitespace(value, offset);
-        if (value[offset] === '"') {
-          offset++;
-          while (offset < length) {
-            if (value[offset] === '"') {
-              offset++;
-              break;
-            }
-            if (value[offset] === '\\') {
-              offset++;
-            }
-            attrValue += value[offset];
-            offset++;
-          }
-        } else {
-          var end = offset + 1;
-          while (!DELIMITER_PATTERN.test(value[end]) && end < length) {
-            end++;
-          }
-          attrValue = value.slice(offset, end);
-          offset = end;
-        }
-        if (ref[attr] && Link.isSingleOccurenceAttr(attr)) {
-          // Ignore multiples of attributes which may only appear once
-        } else if (attr[attr.length - 1] === '*') {
-          ref[attr] = Link.parseExtendedValue(attrValue);
-        } else {
-          attrValue = attr === 'type' ? attrValue.toLowerCase() : attrValue;
-          if (ref[attr] != null) {
-            if (Array.isArray(ref[attr])) {
-              ref[attr].push(attrValue);
-            } else {
-              ref[attr] = [ref[attr], attrValue];
-            }
-          } else {
-            ref[attr] = attrValue;
-          }
-        }
-        switch (value[offset]) {
-          case ',':
-            state = STATE.IDLE;
-            break;
-          case ';':
-            state = STATE.ATTR;
-            break;
-        }
-        offset++;
-      } else {
-        throw new Error('Unknown parser state "' + state + '"');
-      }
-    }
-
-    if (ref != null) {
-      ref.rel != null
-        ? this.refs.push(...Link.expandRelations(ref))
-        : this.refs.push(ref);
-    }
-
-    ref = null;
-
-    return this;
-  }
-
-  toString() {
-    var refs = [];
-    var link = '';
-    var ref = null;
-
-    for (var i = 0; i < this.refs.length; i++) {
-      ref = this.refs[i];
-      link = Object.keys(this.refs[i]).reduce(function (link, attr) {
-        if (attr === 'uri') return link;
-        return link + '; ' + Link.formatAttribute(attr, ref[attr]);
-      }, '<' + ref.uri + '>');
-      refs.push(link);
-    }
-
-    return refs.join(', ');
-  }
-}
-
-/**
- * Determines whether an encoding can be
- * natively handled with a `Buffer`
- * @param {String} value
- * @returns {Boolean}
- */
-Link.isCompatibleEncoding = function (value) {
-  return COMPATIBLE_ENCODING_PATTERN.test(value);
-};
-
-Link.parse = function (value, offset) {
-  return new Link().parse(value, offset);
-};
-
-Link.isSingleOccurenceAttr = function (attr) {
-  return (
-    attr === 'rel' ||
-    attr === 'type' ||
-    attr === 'media' ||
-    attr === 'title' ||
-    attr === 'title*'
-  );
-};
-
-Link.isTokenAttr = function (attr) {
-  return attr === 'rel' || attr === 'type' || attr === 'anchor';
-};
-
-Link.escapeQuotes = function (value) {
-  return value.replace(/"/g, '\\"');
-};
-
-Link.expandRelations = function (ref) {
-  var rels = ref.rel.split(' ');
-  return rels.map(function (rel) {
-    var value = Object.assign({}, ref);
-    value.rel = rel;
-    return value;
-  });
-};
-
-/**
- * Parses an extended value and attempts to decode it
- * @internal
- * @param {String} value
- * @return {Object}
- */
-Link.parseExtendedValue = function (value) {
-  var parts = /([^']+)?(?:'([^']+)')?(.+)/.exec(value);
-  return {
-    language: parts[2].toLowerCase(),
-    encoding: Link.isCompatibleEncoding(parts[1])
-      ? null
-      : parts[1].toLowerCase(),
-    value: Link.isCompatibleEncoding(parts[1])
-      ? decodeURIComponent(parts[3])
-      : parts[3],
-  };
-};
-
-/**
- * Format a given extended attribute and it's value
- * @param {String} attr
- * @param {Object} data
- * @return {String}
- */
-Link.formatExtendedAttribute = function (attr, data) {
-  var encoding = (data.encoding || 'utf-8').toUpperCase();
-  var language = data.language || 'en';
-
-  var encodedValue = '';
-
-  if (Buffer.isBuffer(data.value) && Link.isCompatibleEncoding(encoding)) {
-    encodedValue = data.value.toString(encoding);
-  } else if (Buffer.isBuffer(data.value)) {
-    encodedValue = data.value.toString('hex').replace(/[0-9a-f]{2}/gi, '%$1');
-  } else {
-    encodedValue = encodeURIComponent(data.value);
-  }
-
-  return attr + '=' + encoding + "'" + language + "'" + encodedValue;
-};
-
-/**
- * Format a given attribute and it's value
- * @param {String} attr
- * @param {String|Object} value
- * @return {String}
- */
-Link.formatAttribute = function (attr, value) {
-  if (Array.isArray(value)) {
-    return value
-      .map((item) => {
-        return Link.formatAttribute(attr, item);
-      })
-      .join('; ');
-  }
-
-  if (attr[attr.length - 1] === '*' || typeof value !== 'string') {
-    return Link.formatExtendedAttribute(attr, value);
-  }
-
-  if (Link.isTokenAttr(attr)) {
-    value = needsQuotes(value)
-      ? '"' + Link.escapeQuotes(value) + '"'
-      : Link.escapeQuotes(value);
-  } else if (needsQuotes(value)) {
-    value = encodeURIComponent(value);
-    // We don't need to escape <SP> <,> <;> within quotes
-    value = value
-      .replace(/%20/g, ' ')
-      .replace(/%2C/g, ',')
-      .replace(/%3B/g, ';');
-
-    value = '"' + value + '"';
-  }
-
-  return attr + '=' + value;
-};
-
-module.exports = Link;

src/types.ts

@@ -5,14 +5,11 @@ export type SortedLanguageList = {
 };
 
 export type PaginationLink = {
-  next: string;
-  last: string | undefined | null;
+  uri: string;
+  rel: 'next' | 'last' | 'prev' | 'first';
 };
 
 export type Stars = Endpoints['GET /user/starred']['response']['data'];
 export type Star = Stars[number] | { language: string };
 
-export type ApiGetStarResponse = {
-  links: PaginationLink;
-  data: Stars;
-};
+export type ApiGetStarResponse = Stars;