chore: release v0.0.13

* chore: worked on the api and lint

* chore: small fixes

* chore: uhm I think this sort is broken

* chore: worked on the api and lint

* chore: small fixes

* chore: uhm I think this sort is broken

* feat: heartbeat

* chore: add prettier ignore

* feat: websocket

* chore: update tsconfig

* chore: lint

* chore: dont require unused fields

* chore: use djs rest

* fix: websocket

* chore: v5

* chore: fix build

---------

Co-authored-by: Florian Metz <me@timeraa.dev>

.devcontainer/Dockerfile

@@ -0,0 +1 @@
+FROM mcr.microsoft.com/devcontainers/base:bullseye

.devcontainer/devcontainer.json

@@ -0,0 +1,24 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/docker-existing-docker-compose
+{
+	"name": "PreMiD",
+	"dockerComposeFile": ["docker-compose.yml"],
+	"service": "app",
+	"workspaceFolder": "/workspaces",
+	"features": {
+		"ghcr.io/devcontainers/features/node:1": {
+			"version": "lts",
+			"nvmVersion": "latest"
+		},
+		"ghcr.io/joshuanianji/devcontainer-features/mount-pnpm-store:1": {},
+		"ghcr.io/dhoeric/features/act:1": {}
+	},
+	"overrideFeatureInstallOrder": ["ghcr.io/devcontainers/features/node:1", "ghcr.io/joshuanianji/devcontainer-features/mount-pnpm-store:1"],
+	"postCreateCommand": "pnpm i --frozen-lockfile",
+	"customizations": {
+		"vscode": {
+			"extensions": ["Gruntfuggly.todo-tree", "YoavBls.pretty-ts-errors", "EditorConfig.EditorConfig", "DeepScan.vscode-deepscan", "esbenp.prettier-vscode"]
+		}
+	},
+	"shutdownAction": "stopCompose"
+}

.devcontainer/docker-compose.yml

@@ -0,0 +1,32 @@
+version: "3.8"
+services:
+  # Update this to the name of the service you want to work with in your docker-compose.yml file
+  app:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    # Uncomment if you want to override the service's Dockerfile to one in the .devcontainer
+    # folder. Note that the path of the Dockerfile and context is relative to the *primary*
+    # docker-compose.yml file (the first in the devcontainer.json "dockerComposeFile"
+    # array). The sample below assumes your primary file is in the root of your project.
+    #
+    # build:
+    #   context: .
+    #   dockerfile: .devcontainer/Dockerfile
+
+    volumes:
+      # Update this to wherever you want VS Code to mount the folder of your project
+      - ..:/workspaces:cached
+
+    # Uncomment the next four lines if you will use a ptrace-based debugger like C++, Go, and Rust.
+    # cap_add:
+    #   - SYS_PTRACE
+    # security_opt:
+    #   - seccomp:unconfined
+
+    # Overrides default command so things don't shut down after the process ends.
+    command: /bin/sh -c "while sleep 1000; do :; done"
+  redis:
+    image: redis
+    ports:
+      - "6379:6379"

.dockerignore

@@ -0,0 +1,11 @@
+.vscode
+.DS_Store
+.Trashes
+.nuxt
+.output
+dist
+node_modules
+.env
+Dockerfile
+.dockerignore
+generated

.gitattributes

@@ -0,0 +1,13 @@
+* text eol=lf
+
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.mp4 binary
+*.mp3 binary
+*.gz binary
+*.zip binary
+*.ttf binary
+*.woff binary

.github/FUNDING.yml

@@ -0,0 +1,3 @@
+github: [PreMiD, Timeraa]
+patreon: Timeraa
+ko_fi: Timeraa

.github/actions/build-and-push-docker/action.yaml

@@ -0,0 +1,36 @@
+name: Build and Push Docker Image
+description: Builds a Docker image and pushes it to GitHub Container Registry
+inputs:
+  app:
+    description: Name of the app
+    required: true
+  token:
+    description: GitHub token
+    required: true
+outputs:
+  version:
+    description: Version of the app
+    value: ${{ steps.get_version.outputs.version }}
+runs:
+  using: composite
+  steps:
+    - name: Checkout Repository
+      uses: actions/checkout@v4
+
+    - name: Get package.json version
+      id: get_version
+      run: echo ::set-output name=version::$(node -p "require('./apps/${{ inputs.app }}/package.json').version")
+      shell: bash
+
+    - name: Convert repository owner to lowercase
+      id: repo
+      run: echo "::set-output name=lowercase::$(echo ${{ github.repository_owner }} | awk '{print tolower($0)}')"
+      shell: bash
+
+    - name: Build and Push Docker Image
+      uses: premid/premid/.github/actions/build-docker@monorepo
+      with:
+        dockerfile: ./apps/${{ inputs.app }}/Dockerfile
+        push: true
+        token: ${{ inputs.token }}
+        tags: ghcr.io/${{ steps.repo.outputs.lowercase }}/${{ inputs.app }}:${{ steps.get_version.outputs.version }},ghcr.io/${{ steps.repo.outputs.lowercase }}/${{ inputs.app }}:latest

.github/actions/build-docker/action.yaml

@@ -0,0 +1,46 @@
+name: Build Docker Image
+description: Builds a Docker image using Docker Buildx
+inputs:
+  dockerfile:
+    description: Path to the Dockerfile
+    required: true
+  tags:
+    description: Comma-separated list of tags for the Docker image
+    required: true
+  push:
+    description: Whether to push the Docker image to the registry
+    required: false
+    default: "false"
+  token:
+    description: GitHub Token
+    required: false
+runs:
+  using: composite
+  steps:
+    - name: Checkout Repository
+      uses: actions/checkout@v4
+
+    - name: Setup QEMU
+      uses: docker/setup-qemu-action@v3
+
+    - name: Setup Docker Buildx
+      uses: docker/setup-buildx-action@v3
+
+    - name: Login to GitHub Container Registry
+      if: ${{ inputs.push == 'true' }}
+      uses: docker/login-action@v3
+      with:
+        registry: ghcr.io
+        username: ${{ github.actor }}
+        password: ${{ inputs.token }}
+
+    - name: Build Docker Image
+      uses: docker/build-push-action@v5
+      with:
+        context: .
+        file: ${{ inputs.dockerfile }}
+        platforms: linux/amd64,linux/arm64
+        push: ${{ inputs.push }}
+        tags: ${{ inputs.tags }}
+        cache-from: type=gha
+        cache-to: type=gha,mode=max

.github/renovate.json

@@ -0,0 +1,5 @@
+{
+	"$schema": "https://docs.renovatebot.com/renovate-schema.json",
+	"extends": ["github>Recodive/Recodive:renovate-config"],
+	"automerge": false
+}

.github/workflows/cd.yaml

@@ -0,0 +1,68 @@
+name: CD
+on:
+  push:
+    branches:
+      - monorepo
+    tags:
+      - "*"
+permissions:
+  packages: write
+jobs:
+  build:
+    name: Build Docker Images
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        target:
+          - pd
+          - schema-server
+          - website
+          - api-worker
+          - api-master
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.repository_owner }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build and Push website
+        uses: docker/build-push-action@v6
+        if: matrix.target == 'website'
+        with:
+          push: true
+          platforms: linux/amd64,linux/arm64
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+          build-args: SERVICE=${{ matrix.target }}
+          target: website
+          tags: ghcr.io/premid/${{ matrix.target }}:beta-${{ github.sha }}-${{ github.run_number }}
+
+      - name: Get package.json version
+        if: matrix.target != 'website'
+        id: get_version
+        run: echo ::set-output name=version::$(node -p "require('./apps/${{ matrix.target }}/package.json').version")
+        shell: bash
+
+      - name: Build and push other images
+        uses: docker/build-push-action@v6
+        if: matrix.target != 'website' && startsWith(github.ref, 'refs/tags/')
+        with:
+          push: true
+          platforms: linux/amd64,linux/arm64
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+          target: prod
+          build-args: SERVICE=${{ matrix.target }}
+          tags: ghcr.io/premid/${{ matrix.target }}:latest,ghcr.io/premid/${{ matrix.target }}:${{ steps.get_version.outputs.version }}

.github/workflows/ci.yaml

@@ -0,0 +1,71 @@
+name: Build, Lint and Test
+on:
+  push:
+    branches:
+      - monorepo
+  pull_request:
+jobs:
+  build:
+    name: Build, Lint and Test
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v3
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          cache: pnpm
+          node-version-file: package.json
+
+      - name: Install Dependencies
+        run: pnpm install
+
+      - name: Codegen
+        run: pnpm -r codegen
+
+      - name: Lint
+        run: pnpm run lint
+
+      - name: Build
+        run: pnpm run build
+
+      - name: Test
+        run: pnpm test
+
+  build-docker:
+    name: Build Docker Images
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        target:
+          - pd
+          - schema-server
+          - api-worker
+          - api-master
+          - website
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Get Target
+        id: get_target
+        run: echo "target=$([[ ${{ matrix.target }} == 'website' ]] && echo 'website' || echo 'prod')" >> $GITHUB_OUTPUT
+
+      - name: Build
+        uses: docker/build-push-action@v6
+        with:
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+          target: ${{ steps.get_target.outputs.target }}
+          build-args: SERVICE=${{ matrix.target }}

.gitignore

@@ -1,2 +1,25 @@
 node_modules
 out
+dist
+tmp
+lib
+
+.vscode
+.env
+.yarn/*
+!.yarn/releases
+!.yarn/plugins
+.pnp.*
+
+src/package-lock.json
+src/package.json
+src/update.ini
+
+*.exe
+*.app
+*.xml.backup
+*.js
+!eslint.config.js
+
+coverage
+*.tsbuildinfo

.husky/commit-msg

@@ -0,0 +1,2 @@
+#!/bin/sh
+pnpm exec commitlint --edit $1

.npmrc

@@ -0,0 +1 @@
+shamefully-hoist=true

.prettierignore

@@ -0,0 +1,2 @@
+*.js
+*.ts

CODEOWNERS

@@ -0,0 +1 @@
+* @Timeraa

CODE_OF_CONDUCT.md

@@ -0,0 +1,39 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment include:
+
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints and experiences
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+- Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+- The use of sexualized language or imagery and unwelcome sexual attention or advances
+- Trolling, insulting/derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or electronic address, without explicit permission
+- Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at contact@premid.app or by contacting a staff member on our [Discord server](https://discord.premid.app). All complaints will be reviewed and investigated and will result in a response that is deemed necessary and appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.

Dockerfile

@@ -0,0 +1,36 @@
+FROM gplane/pnpm:node20-alpine AS base
+RUN corepack enable
+ARG SERVICE
+
+FROM base AS build
+WORKDIR /app
+
+COPY . /app
+
+RUN pnpm i --frozen-lockfile
+
+RUN if [ "$SERVICE" != "website" ]; then pnpm run -r codegen; fi
+RUN if [ "$SERVICE" != "website" ]; then pnpm run build; fi
+RUN if [ "$SERVICE" == "website" ]; then pnpm --filter @premid/website run build; fi
+RUN if [ "$SERVICE" != "website" ]; then pnpm --filter @premid/${SERVICE} deploy --prod /prod/${SERVICE}; fi
+
+FROM node:20-alpine AS prod
+ARG SERVICE
+
+WORKDIR /app
+
+COPY --from=build /prod/${SERVICE} ./
+ENV PORT=80
+EXPOSE 80
+
+CMD ["npm", "start"]
+
+FROM node:20-alpine AS website
+WORKDIR /app
+ENV PORT=80
+
+COPY --from=build /app/apps/website/.output /app
+
+EXPOSE 80
+
+CMD ["node", "server/index.mjs"]

LICENSE

@@ -0,0 +1,373 @@
+Mozilla Public License Version 2.0
+==================================
+
+1. Definitions
+--------------
+
+1.1. "Contributor"
+    means each individual or legal entity that creates, contributes to
+    the creation of, or owns Covered Software.
+
+1.2. "Contributor Version"
+    means the combination of the Contributions of others (if any) used
+    by a Contributor and that particular Contributor's Contribution.
+
+1.3. "Contribution"
+    means Covered Software of a particular Contributor.
+
+1.4. "Covered Software"
+    means Source Code Form to which the initial Contributor has attached
+    the notice in Exhibit A, the Executable Form of such Source Code
+    Form, and Modifications of such Source Code Form, in each case
+    including portions thereof.
+
+1.5. "Incompatible With Secondary Licenses"
+    means
+
+    (a) that the initial Contributor has attached the notice described
+        in Exhibit B to the Covered Software; or
+
+    (b) that the Covered Software was made available under the terms of
+        version 1.1 or earlier of the License, but not also under the
+        terms of a Secondary License.
+
+1.6. "Executable Form"
+    means any form of the work other than Source Code Form.
+
+1.7. "Larger Work"
+    means a work that combines Covered Software with other material, in
+    a separate file or files, that is not Covered Software.
+
+1.8. "License"
+    means this document.
+
+1.9. "Licensable"
+    means having the right to grant, to the maximum extent possible,
+    whether at the time of the initial grant or subsequently, any and
+    all of the rights conveyed by this License.
+
+1.10. "Modifications"
+    means any of the following:
+
+    (a) any file in Source Code Form that results from an addition to,
+        deletion from, or modification of the contents of Covered
+        Software; or
+
+    (b) any new file in Source Code Form that contains any Covered
+        Software.
+
+1.11. "Patent Claims" of a Contributor
+    means any patent claim(s), including without limitation, method,
+    process, and apparatus claims, in any patent Licensable by such
+    Contributor that would be infringed, but for the grant of the
+    License, by the making, using, selling, offering for sale, having
+    made, import, or transfer of either its Contributions or its
+    Contributor Version.
+
+1.12. "Secondary License"
+    means either the GNU General Public License, Version 2.0, the GNU
+    Lesser General Public License, Version 2.1, the GNU Affero General
+    Public License, Version 3.0, or any later versions of those
+    licenses.
+
+1.13. "Source Code Form"
+    means the form of the work preferred for making modifications.
+
+1.14. "You" (or "Your")
+    means an individual or a legal entity exercising rights under this
+    License. For legal entities, "You" includes any entity that
+    controls, is controlled by, or is under common control with You. For
+    purposes of this definition, "control" means (a) the power, direct
+    or indirect, to cause the direction or management of such entity,
+    whether by contract or otherwise, or (b) ownership of more than
+    fifty percent (50%) of the outstanding shares or beneficial
+    ownership of such entity.
+
+2. License Grants and Conditions
+--------------------------------
+
+2.1. Grants
+
+Each Contributor hereby grants You a world-wide, royalty-free,
+non-exclusive license:
+
+(a) under intellectual property rights (other than patent or trademark)
+    Licensable by such Contributor to use, reproduce, make available,
+    modify, display, perform, distribute, and otherwise exploit its
+    Contributions, either on an unmodified basis, with Modifications, or
+    as part of a Larger Work; and
+
+(b) under Patent Claims of such Contributor to make, use, sell, offer
+    for sale, have made, import, and otherwise transfer either its
+    Contributions or its Contributor Version.
+
+2.2. Effective Date
+
+The licenses granted in Section 2.1 with respect to any Contribution
+become effective for each Contribution on the date the Contributor first
+distributes such Contribution.
+
+2.3. Limitations on Grant Scope
+
+The licenses granted in this Section 2 are the only rights granted under
+this License. No additional rights or licenses will be implied from the
+distribution or licensing of Covered Software under this License.
+Notwithstanding Section 2.1(b) above, no patent license is granted by a
+Contributor:
+
+(a) for any code that a Contributor has removed from Covered Software;
+    or
+
+(b) for infringements caused by: (i) Your and any other third party's
+    modifications of Covered Software, or (ii) the combination of its
+    Contributions with other software (except as part of its Contributor
+    Version); or
+
+(c) under Patent Claims infringed by Covered Software in the absence of
+    its Contributions.
+
+This License does not grant any rights in the trademarks, service marks,
+or logos of any Contributor (except as may be necessary to comply with
+the notice requirements in Section 3.4).
+
+2.4. Subsequent Licenses
+
+No Contributor makes additional grants as a result of Your choice to
+distribute the Covered Software under a subsequent version of this
+License (see Section 10.2) or under the terms of a Secondary License (if
+permitted under the terms of Section 3.3).
+
+2.5. Representation
+
+Each Contributor represents that the Contributor believes its
+Contributions are its original creation(s) or it has sufficient rights
+to grant the rights to its Contributions conveyed by this License.
+
+2.6. Fair Use
+
+This License is not intended to limit any rights You have under
+applicable copyright doctrines of fair use, fair dealing, or other
+equivalents.
+
+2.7. Conditions
+
+Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted
+in Section 2.1.
+
+3. Responsibilities
+-------------------
+
+3.1. Distribution of Source Form
+
+All distribution of Covered Software in Source Code Form, including any
+Modifications that You create or to which You contribute, must be under
+the terms of this License. You must inform recipients that the Source
+Code Form of the Covered Software is governed by the terms of this
+License, and how they can obtain a copy of this License. You may not
+attempt to alter or restrict the recipients' rights in the Source Code
+Form.
+
+3.2. Distribution of Executable Form
+
+If You distribute Covered Software in Executable Form then:
+
+(a) such Covered Software must also be made available in Source Code
+    Form, as described in Section 3.1, and You must inform recipients of
+    the Executable Form how they can obtain a copy of such Source Code
+    Form by reasonable means in a timely manner, at a charge no more
+    than the cost of distribution to the recipient; and
+
+(b) You may distribute such Executable Form under the terms of this
+    License, or sublicense it under different terms, provided that the
+    license for the Executable Form does not attempt to limit or alter
+    the recipients' rights in the Source Code Form under this License.
+
+3.3. Distribution of a Larger Work
+
+You may create and distribute a Larger Work under terms of Your choice,
+provided that You also comply with the requirements of this License for
+the Covered Software. If the Larger Work is a combination of Covered
+Software with a work governed by one or more Secondary Licenses, and the
+Covered Software is not Incompatible With Secondary Licenses, this
+License permits You to additionally distribute such Covered Software
+under the terms of such Secondary License(s), so that the recipient of
+the Larger Work may, at their option, further distribute the Covered
+Software under the terms of either this License or such Secondary
+License(s).
+
+3.4. Notices
+
+You may not remove or alter the substance of any license notices
+(including copyright notices, patent notices, disclaimers of warranty,
+or limitations of liability) contained within the Source Code Form of
+the Covered Software, except that You may alter any license notices to
+the extent required to remedy known factual inaccuracies.
+
+3.5. Application of Additional Terms
+
+You may choose to offer, and to charge a fee for, warranty, support,
+indemnity or liability obligations to one or more recipients of Covered
+Software. However, You may do so only on Your own behalf, and not on
+behalf of any Contributor. You must make it absolutely clear that any
+such warranty, support, indemnity, or liability obligation is offered by
+You alone, and You hereby agree to indemnify every Contributor for any
+liability incurred by such Contributor as a result of warranty, support,
+indemnity or liability terms You offer. You may include additional
+disclaimers of warranty and limitations of liability specific to any
+jurisdiction.
+
+4. Inability to Comply Due to Statute or Regulation
+---------------------------------------------------
+
+If it is impossible for You to comply with any of the terms of this
+License with respect to some or all of the Covered Software due to
+statute, judicial order, or regulation then You must: (a) comply with
+the terms of this License to the maximum extent possible; and (b)
+describe the limitations and the code they affect. Such description must
+be placed in a text file included with all distributions of the Covered
+Software under this License. Except to the extent prohibited by statute
+or regulation, such description must be sufficiently detailed for a
+recipient of ordinary skill to be able to understand it.
+
+5. Termination
+--------------
+
+5.1. The rights granted under this License will terminate automatically
+if You fail to comply with any of its terms. However, if You become
+compliant, then the rights granted under this License from a particular
+Contributor are reinstated (a) provisionally, unless and until such
+Contributor explicitly and finally terminates Your grants, and (b) on an
+ongoing basis, if such Contributor fails to notify You of the
+non-compliance by some reasonable means prior to 60 days after You have
+come back into compliance. Moreover, Your grants from a particular
+Contributor are reinstated on an ongoing basis if such Contributor
+notifies You of the non-compliance by some reasonable means, this is the
+first time You have received notice of non-compliance with this License
+from such Contributor, and You become compliant prior to 30 days after
+Your receipt of the notice.
+
+5.2. If You initiate litigation against any entity by asserting a patent
+infringement claim (excluding declaratory judgment actions,
+counter-claims, and cross-claims) alleging that a Contributor Version
+directly or indirectly infringes any patent, then the rights granted to
+You by any and all Contributors for the Covered Software under Section
+2.1 of this License shall terminate.
+
+5.3. In the event of termination under Sections 5.1 or 5.2 above, all
+end user license agreements (excluding distributors and resellers) which
+have been validly granted by You or Your distributors under this License
+prior to termination shall survive termination.
+
+************************************************************************
+*                                                                      *
+*  6. Disclaimer of Warranty                                           *
+*  -------------------------                                           *
+*                                                                      *
+*  Covered Software is provided under this License on an "as is"       *
+*  basis, without warranty of any kind, either expressed, implied, or  *
+*  statutory, including, without limitation, warranties that the       *
+*  Covered Software is free of defects, merchantable, fit for a        *
+*  particular purpose or non-infringing. The entire risk as to the     *
+*  quality and performance of the Covered Software is with You.        *
+*  Should any Covered Software prove defective in any respect, You     *
+*  (not any Contributor) assume the cost of any necessary servicing,   *
+*  repair, or correction. This disclaimer of warranty constitutes an   *
+*  essential part of this License. No use of any Covered Software is   *
+*  authorized under this License except under this disclaimer.         *
+*                                                                      *
+************************************************************************
+
+************************************************************************
+*                                                                      *
+*  7. Limitation of Liability                                          *
+*  --------------------------                                          *
+*                                                                      *
+*  Under no circumstances and under no legal theory, whether tort      *
+*  (including negligence), contract, or otherwise, shall any           *
+*  Contributor, or anyone who distributes Covered Software as          *
+*  permitted above, be liable to You for any direct, indirect,         *
+*  special, incidental, or consequential damages of any character      *
+*  including, without limitation, damages for lost profits, loss of    *
+*  goodwill, work stoppage, computer failure or malfunction, or any    *
+*  and all other commercial damages or losses, even if such party      *
+*  shall have been informed of the possibility of such damages. This   *
+*  limitation of liability shall not apply to liability for death or   *
+*  personal injury resulting from such party's negligence to the       *
+*  extent applicable law prohibits such limitation. Some               *
+*  jurisdictions do not allow the exclusion or limitation of           *
+*  incidental or consequential damages, so this exclusion and          *
+*  limitation may not apply to You.                                    *
+*                                                                      *
+************************************************************************
+
+8. Litigation
+-------------
+
+Any litigation relating to this License may be brought only in the
+courts of a jurisdiction where the defendant maintains its principal
+place of business and such litigation shall be governed by laws of that
+jurisdiction, without reference to its conflict-of-law provisions.
+Nothing in this Section shall prevent a party's ability to bring
+cross-claims or counter-claims.
+
+9. Miscellaneous
+----------------
+
+This License represents the complete agreement concerning the subject
+matter hereof. If any provision of this License is held to be
+unenforceable, such provision shall be reformed only to the extent
+necessary to make it enforceable. Any law or regulation which provides
+that the language of a contract shall be construed against the drafter
+shall not be used to construe this License against a Contributor.
+
+10. Versions of the License
+---------------------------
+
+10.1. New Versions
+
+Mozilla Foundation is the license steward. Except as provided in Section
+10.3, no one other than the license steward has the right to modify or
+publish new versions of this License. Each version will be given a
+distinguishing version number.
+
+10.2. Effect of New Versions
+
+You may distribute the Covered Software under the terms of the version
+of the License under which You originally received the Covered Software,
+or under the terms of any subsequent version published by the license
+steward.
+
+10.3. Modified Versions
+
+If you create software not governed by this License, and you want to
+create a new license for such software, you may create and use a
+modified version of this License if you rename the license and remove
+any references to the name of the license steward (except to note that
+such modified license differs from this License).
+
+10.4. Distributing Source Code Form that is Incompatible With Secondary
+Licenses
+
+If You choose to distribute Source Code Form that is Incompatible With
+Secondary Licenses under the terms of this version of the License, the
+notice described in Exhibit B of this License must be attached.
+
+Exhibit A - Source Code Form License Notice
+-------------------------------------------
+
+  This Source Code Form is subject to the terms of the Mozilla Public
+  License, v. 2.0. If a copy of the MPL was not distributed with this
+  file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+If it is not possible or desirable to put the notice in a particular
+file, then You may include the notice in a location (such as a LICENSE
+file in a relevant directory) where a recipient would be likely to look
+for such a notice.
+
+You may add additional accurate notices of copyright ownership.
+
+Exhibit B - "Incompatible With Secondary Licenses" Notice
+---------------------------------------------------------
+
+  This Source Code Form is "Incompatible With Secondary Licenses", as
+  defined by the Mozilla Public License, v. 2.0.

README.md

@@ -0,0 +1,54 @@
+<img src="https://cdn.rcd.gg/PreMiD.png" width="150px" />
+
+# PreMiD
+
+[![Open in Dev Containers](https://img.shields.io/static/v1?label=Dev%20Containers&message=Open&color=blue&logo=visualstudiocode)](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/PreMiD/PreMiD)
+[![Crowdin](https://badges.crowdin.net/premid/localized.svg)](https://crowdin.com/project/premid)
+
+This is the monorepo for PreMiD. PreMiD is a simple, configurable utility that allows you to show what you're watching/listening to on your Discord profile.
+
+## Getting Started
+
+**If you are a user looking to install PreMiD, please visit the [official website](https://premid.app).**
+
+If you are a developer looking to contribute to PreMiD, read along.
+
+## Table of Contents
+
+- [Packages](#packages)
+- [License](#license)
+
+## Packages
+
+This monorepo is split into multiple packages / projects. Here's a list of them:
+
+- [apps/api](apps/api) - The API for PreMiD.
+- [apps/website](apps/website) - The website for PreMiD.
+- [apps/docs](apps/docs) - The official documentation for PreMiD.
+- [apps/pd](apps/pd/README.md) - A simple url shortener service to shorten urls longer than 256 characters.
+- [apps/schema-server](apps/schema-server) - Simple Schema server for the Presence manifest.
+- [packages/db](packages/db) - Database schema for PreMiD.
+
+## Development
+
+### Release
+
+To release a new version of a package, run the following command:
+
+```bash
+cd apps/<app>
+pnpm bumpp -y -t <app>-v
+```
+
+Replace `<app>` with the name of the package you want to release. For example, to release a new version of the `schema-server` package, you would run:
+
+```bash
+cd apps/schema-server
+pnpm bumpp -y -t schema-server-v
+```
+
+This will use bumpp to bump the version of the package in the `package.json` file, create a tag for the new version, and push the changes to the remote repository.
+
+## License
+
+This project is licensed under the [MPL-2.0 License](LICENSE).

apps/api-master/package.json

@@ -0,0 +1,31 @@
+{
+	"name": "@premid/api-master",
+	"type": "module",
+	"version": "0.0.24",
+	"private": true,
+	"description": "PreMiD's api master",
+	"license": "MPL-2.0",
+	"main": "dist/index.js",
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"start": "node --enable-source-maps .",
+		"dev": "node --watch --env-file .env --enable-source-maps ."
+	},
+	"dependencies": {
+		"@envelop/sentry": "^9.0.0",
+		"@opentelemetry/api": "^1.9.0",
+		"@opentelemetry/exporter-prometheus": "^0.52.1",
+		"@opentelemetry/node": "^0.24.0",
+		"@sentry/node": "^8.17.0",
+		"cron": "^3.1.7",
+		"debug": "^4.3.6",
+		"ioredis": "^5.3.2",
+		"ky": "^1.7.2",
+		"p-limit": "^6.1.0"
+	},
+	"devDependencies": {
+		"@types/debug": "^4.1.12"
+	}
+}

apps/api-master/src/functions/clearOldSessions.ts

@@ -0,0 +1,105 @@
+import pLimit from "p-limit";
+import ky, { HTTPError, TimeoutError } from "ky";
+import { mainLog, redis } from "../index.js";
+
+let inProgress = false;
+export async function clearOldSessions() {
+	if (inProgress) {
+		mainLog("Session cleanup already in progress");
+		return;
+	}
+
+	inProgress = true;
+	const now = Date.now();
+	let cursor = "0";
+	let totalSessions = 0;
+	let cleared = 0;
+	const batchSize = 100;
+	let keysToDelete: string[] = [];
+
+	mainLog("Starting session cleanup");
+
+	const limit = pLimit(100); // Create a limit of 100 concurrent operations
+
+	do {
+		const [nextCursor, result] = await redis.hscan("pmd-api.sessions", cursor, "COUNT", batchSize);
+		cursor = nextCursor;
+		totalSessions += result.length / 2;
+
+		const deletePromises = [];
+
+		for (let i = 0; i < result.length; i += 2) {
+			const key = result[i];
+			const value = result[i + 1];
+
+			if (!key || !value) {
+				continue;
+			}
+
+			const session = JSON.parse(value) as {
+				token: string;
+				session: string;
+				lastUpdated: number;
+			};
+
+			if (now - session.lastUpdated < 30000)
+				continue;
+
+			deletePromises.push(limit(() => deleteSession(session, key)));
+		}
+
+		const results = await Promise.allSettled(deletePromises);
+		results.forEach((result) => {
+			if (result.status === "fulfilled" && result.value) {
+				keysToDelete.push(result.value);
+				cleared++;
+			}
+		});
+
+		if (keysToDelete.length >= batchSize) {
+			await redis.hdel("pmd-api.sessions", ...keysToDelete);
+			keysToDelete = [];
+		}
+	} while (cursor !== "0");
+
+	if (keysToDelete.length > 0) {
+		await redis.hdel("pmd-api.sessions", ...keysToDelete);
+	}
+
+	if (totalSessions === 0) {
+		mainLog("No sessions to clear");
+	}
+	else {
+		mainLog(`Checked ${totalSessions} sessions, cleared ${cleared}`);
+	}
+
+	inProgress = false;
+}
+
+async function deleteSession(session: { token: string; session: string }, key: string): Promise<string> {
+	try {
+		await ky.post("https://discord.com/api/v10/users/@me/headless-sessions/delete", {
+			json: {
+				token: session.session,
+			},
+			headers: {
+				Authorization: `Bearer ${session.token}`,
+			},
+			retry: 3,
+			timeout: 5000,
+		});
+	}
+	catch (error) {
+		if (error instanceof TimeoutError) {
+			mainLog(`Session deletion aborted due to timeout for key ${key}`);
+		}
+		else if (error instanceof HTTPError) {
+			mainLog(`Failed to delete session for key ${key}: [${error.name}] ${error.message} ${JSON.stringify(await error.response.json())}`);
+		}
+		else {
+			mainLog(`Failed to delete session for key ${key}: Unknown error`);
+		}
+	}
+
+	return key;
+}

apps/api-master/src/functions/createRedis.ts

@@ -0,0 +1,30 @@
+import { hostname } from "node:os";
+import process from "node:process";
+
+import { Redis } from "ioredis";
+
+/* c8 ignore start */
+export default function createRedis(): Redis {
+	const redis = new Redis({
+		connectionName: `api-master-${hostname()}-${process.pid.toString()}`,
+		lazyConnect: true,
+		name: "mymaster",
+		sentinels: process.env.REDIS_SENTINELS?.split(",").map(s => ({
+			host: s,
+			port: 26_379,
+		})),
+	});
+
+	/* c8 ignore next 3 */
+	redis.on("error", (error) => {
+		console.error("Redis error", error);
+	});
+
+	/* c8 ignore next 4 */
+	redis.on("connect", () => {
+		// eslint-disable-next-line no-console
+		console.log("Redis connected");
+	});
+
+	return redis;
+}

apps/api-master/src/functions/setCounter.ts

@@ -0,0 +1,13 @@
+import { redis } from "../index.js";
+import { counter } from "../tracing.js";
+
+let activeActivities = 0;
+counter.add(0);
+export async function setCounter() {
+	const length = await redis.hlen("pmd-api.sessions");
+	if (length === activeActivities)
+		return;
+	const diff = length - activeActivities;
+	activeActivities = length;
+	counter.add(diff);
+}

apps/api-master/src/functions/updateActivePresenceGauge.ts

@@ -0,0 +1,39 @@
+import { redis } from "../index.js";
+import { activePresenceGauge } from "../tracing.js";
+
+//* Track previously recorded services
+const previousServices = new Set<string>();
+
+//* Function to update the gauge with per-service counts
+export async function updateActivePresenceGauge() {
+	const pattern = "pmd-api.heartbeatUpdates.*";
+	let cursor: string = "0";
+	const serviceCounts = new Map<string, number>();
+
+	do {
+		const [newCursor, keys] = await redis.scan(cursor, "MATCH", pattern, "COUNT", 1000); //* Use SCAN with COUNT for memory efficiency
+		cursor = newCursor;
+		for (const key of keys) {
+			const hash = await redis.hgetall(key);
+			const service = hash.service;
+			const version = hash.version; //* Get version from hash
+			serviceCounts.set(`${service}:${version}`, (serviceCounts.get(`${service}:${version}`) || 0) + 1);
+		}
+	} while (cursor !== "0");
+
+	// Set current counts and remove from previousServices
+	serviceCounts.forEach((count, serviceVersion) => {
+		const [presence_name, version] = serviceVersion.split(":");
+		activePresenceGauge.record(count, { presence_name, version });
+		previousServices.delete(serviceVersion);
+	});
+
+	// Set gauge to 0 for services that are no longer active
+	previousServices.forEach((serviceVersion) => {
+		const [presence_name, version] = serviceVersion.split(":");
+		activePresenceGauge.record(0, { presence_name, version });
+	});
+
+	// Update the set of previous services
+	serviceCounts.forEach((_, serviceVersion) => previousServices.add(serviceVersion));
+}

apps/api-master/src/index.ts

@@ -0,0 +1,44 @@
+import { CronJob } from "cron";
+
+import debug from "debug";
+import { clearOldSessions } from "./functions/clearOldSessions.js";
+import createRedis from "./functions/createRedis.js";
+import { setCounter } from "./functions/setCounter.js";
+import "./tracing.js";
+import { updateActivePresenceGauge } from "./functions/updateActivePresenceGauge.js"; //* Added import
+
+export const redis = createRedis();
+
+export const mainLog = debug("api-master");
+
+debug("Starting cron jobs");
+
+void new CronJob(
+	// Every 5 seconds
+	"*/5 * * * * *",
+	() => {
+		clearOldSessions();
+	},
+	undefined,
+	true,
+);
+
+void new CronJob(
+	// Every second
+	"* * * * * *",
+	() => {
+		setCounter();
+	},
+	undefined,
+	true,
+);
+
+void new CronJob(
+	// Every 5 seconds
+	"*/5 * * * * *",
+	() => {
+		updateActivePresenceGauge();
+	},
+	undefined,
+	true,
+);

apps/api-master/src/tracing.ts

@@ -0,0 +1,24 @@
+import { ValueType } from "@opentelemetry/api";
+import { PrometheusExporter } from "@opentelemetry/exporter-prometheus";
+import { MeterProvider } from "@opentelemetry/sdk-metrics";
+
+const prometheusExporter = new PrometheusExporter();
+
+const provider = new MeterProvider({
+	readers: [prometheusExporter],
+});
+
+const meter = provider.getMeter("nice");
+
+export const counter = meter.createUpDownCounter("active_activites", {
+	description: "Number of active activities",
+	valueType: ValueType.INT,
+});
+
+// * Replace Observable Gauge with regular Gauge
+export const activePresenceGauge = meter.createGauge("active_presence_names", {
+	description: "Number of active presence names per service",
+	valueType: ValueType.INT,
+});
+
+prometheusExporter.startServer();

apps/api-master/tsconfig.app.json

@@ -0,0 +1,9 @@
+{
+	"extends": "../../tsconfig.base.json",
+	"compilerOptions": {
+		"composite": true,
+		"rootDir": "src",
+		"outDir": "dist"
+	},
+	"include": ["src/**/*"]
+}

apps/api-master/tsconfig.json

@@ -0,0 +1,8 @@
+{
+	"extends": "./tsconfig.app.json",
+	"compilerOptions": {
+		"rootDir": ".",
+		"noEmit": true
+	},
+	"include": ["environment.d.ts", "src", "codegen.ts"]
+}

apps/api-worker/.gitignore

@@ -0,0 +1 @@
+generated

apps/api-worker/codegen.ts

@@ -0,0 +1,26 @@
+import type { CodegenConfig } from "@graphql-codegen/cli";
+
+const config: CodegenConfig = {
+	generates: {
+		"dist/generated/schema-v5.graphql": {
+			plugins: ["schema-ast"],
+			schema: "src/graphql/schema/v5/**/*.gql",
+		},
+		"src/generated/graphql-v5.ts": {
+			config: {
+				scalars: {
+					StringOrStringArray: "string | string[]",
+				},
+			},
+			plugins: ["typescript", "typescript-resolvers"],
+			schema: "src/graphql/schema/v5/**/*.gql",
+		},
+		"src/generated/schema-v5.graphql": {
+			plugins: ["schema-ast"],
+			schema: "src/graphql/schema/v5/**/*.gql",
+		},
+	},
+	overwrite: true,
+};
+
+export default config;

apps/api-worker/environment.d.ts

@@ -0,0 +1,7 @@
+declare namespace NodeJS {
+	export interface ProcessEnv {
+		NODE_ENV?: "development" | "production" | "test";
+		DATABASE_URL?: string;
+		SESSION_KEEP_ALIVE_INTERVAL?: string;
+	}
+}

apps/api-worker/package.json

@@ -0,0 +1,49 @@
+{
+	"name": "@premid/api-worker",
+	"type": "module",
+	"version": "0.0.13",
+	"private": true,
+	"description": "PreMiD's api",
+	"license": "MPL-2.0",
+	"main": "dist/index.js",
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"start": "node --enable-source-maps .",
+		"dev": "node --watch --env-file .env --enable-source-maps .",
+		"build": "pnpm codegen",
+		"codegen": "graphql-codegen --config codegen.ts"
+	},
+	"dependencies": {
+		"@discordjs/rest": "^2.3.0",
+		"@envelop/sentry": "^9.0.0",
+		"@escape.tech/graphql-armor-max-aliases": "^2.5.0",
+		"@escape.tech/graphql-armor-max-depth": "^2.3.0",
+		"@escape.tech/graphql-armor-max-directives": "^2.2.0",
+		"@escape.tech/graphql-armor-max-tokens": "^2.4.0",
+		"@fastify/websocket": "^10.0.1",
+		"@opentelemetry/api": "^1.9.0",
+		"@opentelemetry/exporter-prometheus": "^0.52.1",
+		"@opentelemetry/node": "^0.24.0",
+		"@premid/db": "workspace:*",
+		"@sentry/node": "^8.17.0",
+		"arktype": "2.0.0-rc.6",
+		"defu": "^6.1.4",
+		"discord-api-types": "^0.37.92",
+		"fastify": "^4.28.1",
+		"graphql": "^16.9.0",
+		"graphql-parse-resolve-info": "^4.13.0",
+		"graphql-yoga": "^5.6.0",
+		"ioredis": "^5.3.2",
+		"mongoose": "^8.5.1"
+	},
+	"devDependencies": {
+		"@graphql-codegen/cli": "5.0.2",
+		"@graphql-codegen/schema-ast": "^4.1.0",
+		"@graphql-codegen/typescript": "4.0.9",
+		"@graphql-codegen/typescript-resolvers": "4.2.1",
+		"@parcel/watcher": "^2.4.1",
+		"@types/ws": "^8.5.12"
+	}
+}

apps/api-worker/src/classes/Socket.ts

@@ -0,0 +1,110 @@
+import { REST } from "@discordjs/rest";
+import { scope, type } from "arktype";
+import { Routes } from "discord-api-types/v10";
+import WebSocket from "ws";
+import type { FastifyRequest } from "fastify";
+import type { RawData } from "ws";
+import { redis } from "../functions/createServer.js";
+import { counter } from "../tracing.js";
+
+const schema = scope({
+	token: {
+		"+": "delete",
+		"type": "'token'",
+		"token": "string.trim",
+		"expires": "number.epoch",
+	},
+	session: {
+		"+": "delete",
+		"type": "'session'",
+		"token": "string.trim",
+	},
+	validMessages: "token | session",
+}).export();
+
+export class Socket {
+	currentToken: typeof schema.token.infer | undefined;
+	currentSession: typeof schema.session.infer | undefined;
+	discord = new REST({ version: "10", authPrefix: "Bearer" });
+
+	constructor(
+		public readonly socket: WebSocket.WebSocket,
+		public readonly request: FastifyRequest,
+	) {
+		counter.add(1);
+		socket.on("message", this.onMessage.bind(this));
+		socket.on("close", () => this.onClose());
+	}
+
+	async onMessage(message: RawData) {
+		try {
+			const out = schema.validMessages(JSON.parse(message.toString()));
+
+			if (out instanceof type.errors) {
+				return this.close(1003, out.summary);
+			}
+
+			switch (out.type) {
+				case "token": {
+					this.discord.setToken(out.token);
+					if (!await this.isTokenValid(out)) {
+						return this.close(1003, "Invalid token");
+					}
+					this.currentToken = out;
+					break;
+				}
+				case "session": {
+					await redis.hdel("pmd-api.sessions", out.token);
+					this.currentSession = out;
+					break;
+				}
+			}
+		}
+		catch (error) {
+			console.error(error);
+			this.close(1011, "Internal Error");
+		}
+	}
+
+	async onClose() {
+		counter.add(-1);
+
+		if (!this.currentToken || !this.currentSession)
+			return;
+
+		await redis.hset(
+			"pmd-api.sessions",
+			this.currentSession.token,
+			JSON.stringify({
+				session: this.currentSession.token,
+				token: this.currentToken.token,
+				lastUpdated: Date.now(),
+			}),
+		);
+	}
+
+	async isTokenValid(token: typeof schema.token.infer) {
+		// ? Check the expiration date of the token
+		if (token.expires < Date.now())
+			return false;
+
+		// ? See if we can get the user's information
+		try {
+			await this.discord.get(Routes.user());
+			return true;
+		}
+		catch {
+			return false;
+		}
+	}
+
+	send(data: any) {
+		this.socket.send(JSON.stringify(data));
+	}
+
+	close(code: number = 1000, message?: string) {
+		if (this.socket.readyState === WebSocket.CLOSED)
+			return;
+		this.socket.close(code, message);
+	}
+}

apps/api-worker/src/constants.ts

@@ -0,0 +1,10 @@
+import process from "node:process";
+import { defu } from "defu";
+
+const disabledFlags = process.env.DISABLED_FEATURE_FLAGS?.split(",") ?? [];
+const flags = Object.fromEntries(disabledFlags.map(flag => [flag, false]));
+
+export const featureFlags = defu(flags, {
+	WebSocketManager: true,
+	SessionKeepAlive: true,
+});

apps/api-worker/src/functions/createRedis.ts

@@ -0,0 +1,30 @@
+import { hostname } from "node:os";
+import process from "node:process";
+
+import { Redis } from "ioredis";
+
+/* c8 ignore start */
+export default function createRedis(): Redis {
+	const redis = new Redis({
+		connectionName: `api-${hostname()}-${process.pid.toString()}`,
+		lazyConnect: true,
+		name: "mymaster",
+		sentinels: process.env.REDIS_SENTINELS?.split(",").map(s => ({
+			host: s,
+			port: 26_379,
+		})),
+	});
+
+	/* c8 ignore next 3 */
+	redis.on("error", (error) => {
+		console.error("Redis error", error);
+	});
+
+	/* c8 ignore next 4 */
+	redis.on("connect", () => {
+		// eslint-disable-next-line no-console
+		console.log("Redis connected");
+	});
+
+	return redis;
+}

apps/api-worker/src/functions/createServer.test.ts

@@ -0,0 +1,25 @@
+import { describe, expect, it } from "vitest";
+
+describe.concurrent("createServer", () => {
+	it("should create a server", async () => {
+		const createServer = await import("./createServer.js");
+		const server = await createServer.default();
+		expect(server).toBeDefined();
+		expect(server).toHaveProperty("listen");
+	});
+
+	it("should handle graphql requests", async () => {
+		const createServer = await import("./createServer.js");
+		const server = await createServer.default();
+		expect(server).toBeDefined();
+		expect(server).toHaveProperty("listen");
+
+		const response = await server.inject({
+			method: "GET",
+			url: "/v5/graphql",
+		});
+
+		expect(response).toBeDefined();
+		expect(response.statusCode).toBe(200);
+	});
+});

apps/api-worker/src/functions/createServer.ts

@@ -0,0 +1,97 @@
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { useSentry } from "@envelop/sentry";
+import { maxAliasesPlugin } from "@escape.tech/graphql-armor-max-aliases";
+import { maxDepthPlugin } from "@escape.tech/graphql-armor-max-depth";
+import { maxDirectivesPlugin } from "@escape.tech/graphql-armor-max-directives";
+import { maxTokensPlugin } from "@escape.tech/graphql-armor-max-tokens";
+import fastifyWebsocket from "@fastify/websocket";
+import fastify from "fastify";
+
+import { createSchema, createYoga } from "graphql-yoga";
+import type { FastifyReply, FastifyRequest } from "fastify";
+import { Socket } from "../classes/Socket.js";
+import { resolvers } from "../graphql/resolvers/v5/index.js";
+import { sessionKeepAlive } from "../routes/sessionKeepAlive.js";
+import { featureFlags } from "../constants.js";
+import createRedis from "./createRedis.js";
+
+export interface FastifyContext {
+	request: FastifyRequest;
+	reply: FastifyReply;
+}
+
+const __dirname = new URL(".", import.meta.url).pathname;
+
+export default async function createServer() {
+	const app = fastify({ logger: true });
+	const yoga = createYoga<FastifyContext>({
+		graphqlEndpoint: "/v5/graphql",
+		logging: {
+			/* c8 ignore next 12 */
+			debug: (...arguments_) => {
+				for (const argument of arguments_) app.log.debug(argument);
+			},
+			error: (...arguments_) => {
+				for (const argument of arguments_) app.log.error(argument);
+			},
+			info: (...arguments_) => {
+				for (const argument of arguments_) app.log.info(argument);
+			},
+			warn: (...arguments_) => {
+				for (const argument of arguments_) app.log.warn(argument);
+			},
+		},
+		plugins: [
+			maxAliasesPlugin(),
+			maxDepthPlugin(),
+			maxDirectivesPlugin(),
+			maxTokensPlugin(),
+			/* useSentry(), */
+		],
+		schema: createSchema<FastifyContext>({
+			resolvers,
+			typeDefs: await readFile(
+				resolve(__dirname, "../generated/schema-v5.graphql"),
+				"utf8",
+			),
+		}),
+	});
+
+	app.route({
+		handler: async (request, reply) => {
+			const response = await yoga.handleNodeRequest(request, {
+				reply,
+				request,
+			});
+			for (const [key, value] of response.headers.entries())
+				void reply.header(key, value);
+
+			void reply.status(response.status);
+
+			void reply.send(response.body);
+
+			return reply;
+		},
+		method: ["GET", "POST", "OPTIONS"],
+		url: "/v5/graphql",
+	});
+
+	app.register(fastifyWebsocket);
+
+	app.register(async (app) => {
+		app.get("/v5/ws", { websocket: true }, (websocket, request) => {
+			void new Socket(websocket, request);
+		});
+	});
+
+	app.get("/v5/feature-flags", async (request, reply) => {
+		void reply.send(featureFlags);
+	});
+
+	app.post("/v5/session-keep-alive", sessionKeepAlive);
+
+	return app;
+}
+
+export const redis = createRedis();

apps/api-worker/src/graphql/resolvers/v5/Mutation/addScience.ts

@@ -0,0 +1,32 @@
+import { type } from "arktype";
+import { redis } from "../../../../functions/createServer.js";
+import type { MutationResolvers } from "../../../../generated/graphql-v5.js";
+
+const addScienceSchema = type({
+	identifier: "string.uuid & string.lower",
+	presences: "string.trim[]",
+	platform: {
+		arch: "string.trim",
+		os: "string.trim",
+	},
+});
+
+const mutation: MutationResolvers["addScience"] = async (_parent, input) => {
+	const out = addScienceSchema(input);
+
+	if (out instanceof type.errors)
+		throw new Error(out.summary);
+
+	await redis.hset(
+		"pmd-api.scienceUpdates",
+		out.identifier,
+		JSON.stringify(out),
+	);
+
+	return {
+		__typename: "AddScienceResult",
+		...out,
+	};
+};
+
+export default mutation;

apps/api-worker/src/graphql/resolvers/v5/Mutation/heartbeat.ts

@@ -0,0 +1,49 @@
+import { type } from "arktype";
+import type { MutationResolvers } from "../../../../generated/graphql-v5.js";
+import { redis } from "../../../../functions/createServer.js";
+
+const heartbeatSchema = type({
+	identifier: "string.uuid & string.lower",
+	presence: {
+		service: "string.trim",
+		version: "string.semver",
+		language: "string.trim",
+		since: "number.epoch",
+	},
+	extension: {
+		"version": "string.semver",
+		"language": "string.trim",
+		"connected?": {
+			app: "number.integer",
+			discord: "boolean",
+		},
+	},
+});
+
+const mutation: MutationResolvers["heartbeat"] = async (_parent, input) => {
+	const out = heartbeatSchema(input);
+
+	if (out instanceof type.errors)
+		throw new Error(out.summary);
+
+	// * Use Redis Hash with 'service' in the key to store heartbeat data
+	const redisKey = `pmd-api.heartbeatUpdates.${out.identifier}`;
+	await redis.hset(redisKey, {
+		service: out.presence.service,
+		version: out.presence.version,
+		language: out.presence.language,
+		since: out.presence.since.toString(),
+		extension_version: out.extension.version,
+		extension_language: out.extension.language,
+		extension_connected_app: out.extension.connected?.app?.toString(),
+		extension_connected_discord: out.extension.connected?.discord?.toString(),
+	});
+	await redis.expire(redisKey, 300);
+
+	return {
+		__typename: "HeartbeatResult",
+		...out,
+	};
+};
+
+export default mutation;

apps/api-worker/src/graphql/resolvers/v5/Mutation/index.ts

@@ -0,0 +1,8 @@
+import type { MutationResolvers } from "../../../../generated/graphql-v5.js";
+import addScience from "./addScience.js";
+import heartbeat from "./heartbeat.js";
+
+export const Mutation: MutationResolvers = {
+	addScience,
+	heartbeat,
+};

apps/api-worker/src/graphql/resolvers/v5/Query/index.ts

@@ -0,0 +1,6 @@
+import type { QueryResolvers } from "../../../../generated/graphql-v5.js";
+import presences from "./presences.js";
+
+export const Query: QueryResolvers = {
+	presences,
+};

apps/api-worker/src/graphql/resolvers/v5/Query/presences.ts

@@ -0,0 +1,58 @@
+import { Presence } from "@premid/db";
+import { parseResolveInfo } from "graphql-parse-resolve-info";
+import type { PresenceSchema } from "@premid/db/Presence.js";
+import type { FilterQuery } from "mongoose";
+
+import type { QueryResolvers } from "../../../../generated/graphql-v5.js";
+
+const resolver: QueryResolvers["presences"] = async (
+	_parent,
+	{ author, contributor, limit, query, service, start, tag },
+	_context,
+	info,
+) => {
+	const authorFilter: FilterQuery<PresenceSchema> = author
+		? { "metadata.author.name": author }
+		: {};
+	const contributorFilter: FilterQuery<PresenceSchema> = contributor
+		? { "metadata.contributors.name": contributor }
+		: {};
+	const serviceFilter: FilterQuery<PresenceSchema> = service
+		? Array.isArray(service)
+			? { "metadata.service": { $in: service } }
+			: { "metadata.service": service }
+		: {};
+	const queryFilter: FilterQuery<PresenceSchema> = query
+		? { "metadata.service": { $options: "i", $regex: query } }
+		: {};
+	const tagFilter: FilterQuery<PresenceSchema> = tag
+		? { "metadata.tags": tag }
+		: {};
+
+	const presences = await Presence.find(
+		{
+			...authorFilter,
+			...contributorFilter,
+			...serviceFilter,
+			...queryFilter,
+			...tagFilter,
+		},
+		Object.assign(
+			{},
+			...Object.keys(parseResolveInfo(info)!.fieldsByTypeName.Presence!).map(
+				fieldName => ({ [fieldName]: true }),
+			),
+		) as Record<string, boolean>,
+		{ ...(limit ? { limit } : {}), ...(start ? { skip: start } : {}) },
+	);
+
+	return presences.map(presence => ({
+		iframeJs: presence.iframeJs,
+		metadata: presence.metadata,
+		presenceJs: presence.presenceJs,
+		url: presence.url,
+		users: 0,
+	}));
+};
+
+export default resolver;

apps/api-worker/src/graphql/resolvers/v5/index.ts

@@ -0,0 +1,8 @@
+import type { Resolvers } from "../../../generated/graphql-v5.js";
+import { Mutation } from "./Mutation/index.js";
+import { Query } from "./Query/index.js";
+
+export const resolvers: Resolvers = {
+	Query,
+	Mutation,
+};

apps/api-worker/src/graphql/schema/v5/addScience.gql

@@ -0,0 +1,19 @@
+type Mutation {
+	addScience(identifier: String!, presences: [String!]!, platform: PlatformInput!): AddScienceResult
+}
+
+input PlatformInput {
+	arch: String!
+	os: String!
+}
+
+type AddScienceResult {
+	identifier: String!
+	presences: [String!]!
+	platform: Platform!
+}
+
+type Platform {
+	arch: String!
+	os: String!
+}

apps/api-worker/src/graphql/schema/v5/availableLanguages.gql

@@ -0,0 +1,21 @@
+type Query {
+	"""
+	Get the available languages
+	"""
+	availableLanguages: [Language!]!
+}
+
+type Language {
+	"""
+	Language code
+	"""
+	lang: String!
+	"""
+	Native name of the language, eg. 'English', 'Deutsch', 'Español', etc.
+	"""
+	nativeName: String!
+	"""
+	'ltr' or 'rtl'
+	"""
+	direction: String!
+}

apps/api-worker/src/graphql/schema/v5/availablePresenceLanguages.gql

@@ -0,0 +1,22 @@
+type Query {
+	"""
+	Get the available presence languages for a specific presence
+	"""
+	availablePresenceLanguages(
+		"""
+		Presence, e.g. 'Netflix'
+		"""
+		presence: StringOrStringArray
+	): [PresenceLanguage!]!
+}
+
+type PresenceLanguage {
+	"""
+	Presence, e.g. 'Netflix'
+	"""
+	presence: String!
+	"""
+	The available languages for the presence
+	"""
+	languages: [Language!]!
+}

apps/api-worker/src/graphql/schema/v5/heartbeat.gql

@@ -0,0 +1,49 @@
+type Mutation {
+	heartbeat(
+		identifier: String!
+		presence: HeartbeatPresenceInput
+		extension: HeartbeatExtensionInput!
+	): HeartbeatResult!
+}
+
+input HeartbeatPresenceInput {
+	service: String!
+	version: String!
+	language: String!
+	since: Float!
+}
+
+input HeartbeatExtensionInput {
+	version: String!
+	language: String!
+	connected: HeartbeatConnectedInput
+}
+
+input HeartbeatConnectedInput {
+	app: Int!
+	discord: Boolean!
+}
+
+type HeartbeatResult {
+	identifier: String!
+	presence: HeartbeatPresence
+	extension: HeartbeatExtension!
+}
+
+type HeartbeatPresence {
+	service: String!
+	version: String!
+	language: String!
+	since: Float!
+}
+
+type HeartbeatExtension {
+	version: String!
+	language: String!
+	connected: HeartbeatConnected
+}
+
+type HeartbeatConnected {
+	app: Int!
+	discord: Boolean!
+}

apps/api-worker/src/graphql/schema/v5/presences.gql

@@ -0,0 +1,62 @@
+type Query {
+	presences(
+		service: StringOrStringArray
+		author: String
+		contributor: String
+		start: Int
+		limit: Int
+		query: String
+		tag: String
+	): [Presence!]!
+}
+
+type Presence {
+	url: String!
+	metadata: PresenceMetadata!
+	presenceJs: String!
+	iframeJs: String
+	users: Int!
+}
+
+type PresenceMetadata {
+	author: PresenceMetadataUser!
+	contributors: [PresenceMetadataUser!]
+	altnames: [String!]
+	service: String!
+	description: Scalar! # serialize
+	url: Scalar! # serialize
+	version: String!
+	logo: String!
+	thumbnail: String!
+	color: String!
+	tags: [String!]!
+	category: String!
+	iframe: Boolean
+	regExp: String
+	iFrameRegExp: String
+	readLogs: Boolean
+	button: Boolean
+	warning: Boolean
+	settings: [PresenceMetadataSettings!]
+}
+
+type PresenceMetadataUser {
+	id: String!
+	name: String!
+}
+
+type PresenceMetadataSettings {
+	id: String!
+	title: String
+	icon: String
+	if: PresenceMetadataSettingsIf # serialize
+	placeholder: String
+	value: Scalar # serialize
+	values: Scalar # serialize
+	multiLanguage: Scalar # serialize
+}
+
+type PresenceMetadataSettingsIf {
+	propertyNames: String
+	patternProperties: Scalar
+}

apps/api-worker/src/graphql/schema/v5/scalar/Scalar.gql

@@ -0,0 +1 @@
+scalar Scalar

apps/api-worker/src/graphql/schema/v5/scalar/StringOrStringArray.gql

@@ -0,0 +1 @@
+scalar StringOrStringArray

apps/api-worker/src/index.ts

@@ -0,0 +1,27 @@
+/* eslint-disable no-console */
+import process from "node:process";
+import * as Sentry from "@sentry/node";
+import { connect } from "mongoose";
+import "./tracing.js";
+import createServer from "./functions/createServer.js";
+
+// TODO SETUP SENTRY
+Sentry.init({
+	integrations: [
+		Sentry.graphqlIntegration(),
+		Sentry.mongooseIntegration(),
+	],
+});
+
+if (!process.env.DATABASE_URL)
+	throw new Error("DATABASE_URL is not set");
+
+await connect(process.env.DATABASE_URL, { appName: "PreMiD API" });
+
+const server = await createServer();
+const url = await server.listen({
+	port: Number.parseInt(process.env.PORT ?? "3001"),
+	host: process.env.HOST ?? "0.0.0.0",
+});
+
+console.log(`Server listening at ${url}`);

apps/api-worker/src/routes/sessionKeepAlive.ts

@@ -0,0 +1,64 @@
+import process from "node:process";
+import { REST } from "@discordjs/rest";
+import { type } from "arktype";
+import { Routes } from "discord-api-types/v10";
+import type { FastifyReply, FastifyRequest } from "fastify";
+import { redis } from "../functions/createServer.js";
+import { featureFlags } from "../constants.js";
+
+const schema = type({
+	token: "string.trim",
+	session: "string.trim",
+	version: "string.semver & string.trim",
+	scienceId: "string.trim",
+});
+
+export async function sessionKeepAlive(request: FastifyRequest, reply: FastifyReply) {
+	if (!featureFlags.SessionKeepAlive)
+		return reply.status(202).send();
+
+	//* Get the headers
+	const out = schema({
+		token: request.headers["x-token"],
+		session: request.headers["x-session"],
+		version: request.headers["x-version"] ?? "2.6.8",
+		scienceId: request.headers["x-science-id"] ?? request.headers["x-token"],
+	});
+
+	if (out instanceof type.errors)
+		return reply.status(400).send({ code: "MISSING_HEADERS", message: out.message });
+
+	if (!await isTokenValid(out.token))
+		return reply.status(400).send({ code: "INVALID_TOKEN", message: "The token is invalid" });
+
+	await redis.hset(
+		"pmd-api.sessions",
+		out.scienceId,
+		JSON.stringify({
+			session: out.session,
+			token: out.token,
+			lastUpdated: Date.now(),
+		}),
+	);
+
+	const interval = Number.parseInt(process.env.SESSION_KEEP_ALIVE_INTERVAL ?? "5000");
+
+	return reply.status(200).send({
+		code: "OK",
+		message: "Session updated",
+		nextUpdate: interval,
+	});
+}
+
+async function isTokenValid(token: string) {
+	const discord = new REST({ version: "10", authPrefix: "Bearer" });
+
+	discord.setToken(token);
+	try {
+		await discord.get(Routes.user());
+		return true;
+	}
+	catch {
+		return false;
+	}
+}

apps/api-worker/src/tracing.ts

@@ -0,0 +1,18 @@
+import { ValueType } from "@opentelemetry/api";
+import { PrometheusExporter } from "@opentelemetry/exporter-prometheus";
+import { MeterProvider } from "@opentelemetry/sdk-metrics";
+
+const prometheusExporter = new PrometheusExporter();
+
+const provider = new MeterProvider({
+	readers: [prometheusExporter],
+});
+
+const meter = provider.getMeter("nice");
+
+export const counter = meter.createUpDownCounter("active_activites", {
+	description: "Number of active activities",
+	valueType: ValueType.INT,
+});
+
+prometheusExporter.startServer();

apps/api-worker/tsconfig.app.json

@@ -0,0 +1,10 @@
+{
+	"extends": "../../tsconfig.base.json",
+	"compilerOptions": {
+		"composite": true,
+		"rootDir": "src",
+		"types": ["@ark/schema"],
+		"outDir": "dist"
+	},
+	"include": ["src/**/*"]
+}

apps/api-worker/tsconfig.json

@@ -0,0 +1,8 @@
+{
+	"extends": "./tsconfig.app.json",
+	"compilerOptions": {
+		"rootDir": ".",
+		"noEmit": true
+	},
+	"include": ["environment.d.ts", "src", "codegen.ts"]
+}

apps/docs/.vitepress/.gitignore

@@ -0,0 +1 @@
+cache

apps/docs/.vitepress/config.mts

@@ -0,0 +1,129 @@
+import { defineConfig } from "vitepress";
+
+// https://vitepress.dev/reference/site-config
+export default defineConfig({
+	title: "Documentation",
+	description: "Official Documentation",
+	locales: {
+		root: {
+			label: "English",
+			lang: "en-US",
+		},
+		de: {
+			label: "Deutsch",
+			lang: "de-DE",
+		},
+	},
+	themeConfig: {
+		nav: [
+			{
+				text: "Presence Development",
+				link: "/dev/getting-started",
+			},
+			{
+				text: "Reference",
+				link: "/reference/presence",
+			},
+		],
+		sidebar: {
+			"/default": {
+				base: "/",
+				items: [
+					{
+						text: "Getting Started",
+						link: "/",
+						items: [
+							{
+								text: "Introduction",
+								link: "/introduction/",
+							},
+							{
+								text: "Installation",
+								link: "/installation/",
+							},
+							{
+								text: "Setup",
+								link: "/setup/",
+							},
+							{
+								text: "FAQ",
+								link: "/faq/",
+							},
+						],
+					},
+					{
+						text: "Development",
+						link: "/development/",
+						items: [
+							{
+								text: "Presence Development",
+								link: "/presence-development/",
+								collapsed: true,
+								items: [
+									{
+										text: "Getting Started",
+										link: "/presence-development/getting-started/",
+									},
+									{
+										text: "Creating a Presence",
+										link: "/presence-development/creating-a-presence/",
+									},
+								],
+							},
+						],
+					},
+					{
+						text: "Contribute",
+						link: "/contribute/",
+						items: [
+							{
+								text: "Report a Bug",
+								link: "https://github.com/PreMiD",
+							},
+							{
+								text: "Submit a Feature",
+								link: "https://discord.premid.app",
+							},
+							{
+								text: "Donate",
+								link: "https://patreon.com/Timeraa",
+							},
+							{
+								text: "Translate",
+								link: "https://crowdin.com/project/premid",
+							},
+						],
+					},
+				],
+			},
+			"/reference/": {
+				base: "/reference",
+				items: [
+					{
+						text: "Reference",
+						link: "/presence",
+						items: [
+							{
+								text: "Presence",
+								link: "/presence",
+							},
+							{
+								text: "Iframe",
+								link: "/iframe",
+							},
+						],
+					},
+				],
+			},
+		},
+		socialLinks: [
+			{ icon: "github", link: "https://github.com/PreMiD" },
+			{ icon: "discord", link: "https://discord.premid.app" },
+			{ icon: "x", link: "https://x.com/PreMiDapp" },
+		],
+		i18nRouting: true,
+		logo: "/logo.svg",
+		search: { provider: "local" },
+	},
+	lastUpdated: true,
+});

apps/docs/dev/creating-a-presence.md

@@ -0,0 +1,77 @@
+# Creating a Presence
+
+## Introduction
+
+PreMiD Presences are the core of the PreMiD application. They allow you to add support for your favorite websites and services, or create your own custom Presences. This guide will walk you through the process of creating a Presence for PreMiD.
+
+Please go through the [Getting Started](./getting-started) guide before proceeding with this guide. It will help you set up your development environment and install the necessary tools.
+
+To make the process of creating a Presence easier, we have provided a command-line interface (CLI) tool. This tool will help you generate a new Presence project with all the necessary files and configurations, so you can start coding your Presence right away.
+
+The CLI will also help you build and test your Presence before submitting it to the PreMiD Store. Testing is required to ensure your Presence works as expected and meets the quality standards. Proof that your Presence works is required for it to be approved. This is usually done by providing a video or a screenshot of your Presence in action.
+
+## Creating a New Presence
+
+To create a new Presence, we will run some scripts. This will generate a new Presence project with all the necessary files and configurations. To create a new Presence, follow these steps:
+
+1. Open your terminal and run the following command:
+
+```sh
+pnpm create
+```
+
+2. Follow the on-screen instructions to create a new Presence project.
+
+### Coding your Presence
+
+Once you have created a new Presence project, you can start coding your Presence. First of all, you need to understand the structure of a Presence project.
+
+#### Presence Structure
+
+A Presence project consists of the following files and directories:
+
+- `metadata.json`: This file contains the metadata for your Presence, such as the name, description, and version.
+- `presence.ts`: This file contains the code for your Presence. This is where you will write the logic to detect the presence of your website or service.
+- `iframe.ts` (optional): This file contains the code for the Presence's iframe. This is where we will be able to interact with embedded iframes on the website.
+
+#### Development Server
+
+Let's start a Development Server to build and test your Presence. Follow these steps:
+
+1. Start a development server to be able to build and test your Presence:
+
+```sh
+pnpm dev "Your Presence Name"
+```
+
+2. Open your browser and go to the PreMiD Extension settings page, then enable Developer Mode.
+3. You should now see your new Presence in the list of Presences.
+
+#### Editing the `presence.ts` File
+
+In order to fetch the data from the website, you need to write the logic in the `presence.ts` file. We will use native JavaScript functions to fetch the data from the website. Let's see an example:
+
+```ts
+const presence = new Presence({
+	clientId: "Your Client ID",
+});
+
+const enum Asset {
+	Logo = "https://cdn.rcd.gg/PreMiD.png",
+}
+
+presence.on("UpdateData", async () => {
+	const title = document.querySelector("title");
+	const description = document.querySelector("meta[name=\"description\"]");
+
+	const data: PresenceData = {
+		details: title.textContent,
+		state: description.getAttribute("content"),
+		largeImageKey: Asset.Logo,
+	};
+
+	presence.setActivity(data);
+});
+```
+
+In this example, we are fetching the title and description of the website and setting them as the Presence details and state, respectively. We are also setting a custom logo as the large image key.

apps/docs/dev/getting-started.md

@@ -0,0 +1,50 @@
+# Getting Started
+
+## Installation
+
+### Prerequisites
+
+- [Git](https://git-scm.com/).
+- [Node.js](https://nodejs.org/) version 18 or higher, includes [Corepack](https://github.com/nodejs/corepack) by default.
+- Terminal for accessing PreMiD's Developer Tools via its command-line interface (CLI).
+- Text Editor with [TypeScript](https://www.typescriptlang.org/) syntax highlighting support.
+  - [Visual Studio Code](https://code.visualstudio.com/) is recommended, as it includes TypeScript support out-of-the-box.
+
+### Clone the Repository
+
+- Open your terminal and run the following command:
+  ```sh
+  git clone https://github.com/PreMiD/Presences.git
+  ```
+- Change your working directory to the repository:
+  ```sh
+  cd Presences
+  ```
+
+### Install Dependencies
+
+- Ensure you have Node.js installed by running:
+  ```sh
+  node -v
+  ```
+  If you see a version number, Node.js is installed. Make sure you have Node.js version 18 or higher.
+- Enable Corepack by running:
+  ```sh
+  corepack enable
+  ```
+- Install the project dependencies:
+  ```sh
+  pnpm install
+  ```
+
+## Coding your Presence
+
+Follow the [Creating a Presence](./creating-a-presence) guide to get started with coding your own Presence.
+
+## Submitting your Presence
+
+Once you've finished coding your Presence, you can submit it to the PreMiD Store for others to use. Follow the [Submitting a Presence](./submitting-a-presence) guide to learn how to submit your Presence.
+
+A member of the PreMiD Team will review your submission and if it meets the guidelines, it will be added to the PreMiD Store for everyone to use. If your submission is rejected, you will receive feedback on how to improve it.
+
+Please note that all submissions are subject to review and approval by the PreMiD Team. We reserve the right to reject any submission that does not meet our guidelines or quality standards. Reviews may take up to 7 days to complete.

apps/docs/getting-started.md

@@ -0,0 +1,5 @@
+# Getting Started
+
+Welcome to the official documentation for PreMiD! This guide will help you get started with PreMiD.
+
+## Installation

apps/docs/index.md

@@ -0,0 +1,51 @@
+---
+# https://vitepress.dev/reference/default-theme-home-page
+layout: home
+
+hero:
+  name: "PreMiD"
+  text: "Documentation"
+  tagline: "The official documentation for PreMiD."
+  image:
+    src: /logo.svg
+    alt: PreMiD Logo
+  actions:
+    - theme: brand
+      text: Get Started
+      link: /getting-started
+    - theme: alt
+      text: Presence Development
+      link: /dev/getting-started
+features:
+  - icon: 🛠️
+    title: Extensible
+    details: Add Presences for your favorite websites and services. Or create your own!
+  - icon: 🌐
+    title: Cross-Platform
+    details: PreMiD is available for all major browsers and platforms.
+  - icon: 🚀
+    title: Lightweight
+    details: PreMiD is designed to be as lightweight as possible, so it won't slow down your system.
+---
+
+<style>
+:root {
+  --vp-home-hero-name-color: transparent;
+  --vp-home-hero-name-background: -webkit-linear-gradient(120deg, rgb(209, 122, 254) 30%, rgb(89, 195, 246));
+
+  --vp-home-hero-image-background-image: linear-gradient(-45deg, rgb(209, 122, 254) 50%, rgb(89, 195, 246) 50%);
+  --vp-home-hero-image-filter: blur(44px);
+}
+
+@media (min-width: 640px) {
+  :root {
+    --vp-home-hero-image-filter: blur(56px);
+  }
+}
+
+@media (min-width: 960px) {
+  :root {
+    --vp-home-hero-image-filter: blur(68px);
+  }
+}
+</style>

apps/docs/package.json

@@ -0,0 +1,14 @@
+{
+	"name": "@premid/docs",
+	"version": "0.0.0",
+	"private": true,
+	"description": "Documentation for Premid",
+	"scripts": {
+		"dev": "vitepress dev",
+		"build": "vitepress build",
+		"preview": "vitepress preview"
+	},
+	"devDependencies": {
+		"vitepress": "1.3.1"
+	}
+}

apps/docs/reference/presence.md

@@ -0,0 +1,68 @@
+# Presence Class
+
+The `Presence` class is the main class used to create a Presence.
+
+## Overview
+
+The `Presence` class is the main class used to create a Presence. It is used to interact with the PreMiD Extension.
+
+### Example
+
+```javascript
+const presence = new Presence({
+	clientId: "<Your Client ID>",
+});
+
+presence.on("UpdateData", () => {
+	// Logic to update the presence data
+
+	presence.setActivity({
+		details: "Example Presence",
+		state: "Example State",
+	});
+});
+```
+
+## Constructor
+
+### `new Presence(options: PresenceOptions)`
+
+Creates a new `Presence` instance.
+
+#### Parameters
+
+- `options` (`PresenceOptions`): The options for the Presence.
+
+#### Returns
+
+- `Presence`: The new `Presence` instance.
+
+## Properties
+
+### `clientId: string`
+
+The Client ID of the Presence.
+
+## Methods
+
+### `setActivity(activity: PresenceActivity)`
+
+Sets the activity of the Presence.
+
+#### Parameters
+
+- `activity` (`PresenceActivity`): The activity to set.
+
+### `clearActivity()`
+
+Clears the activity of the Presence.
+
+### `on(event: string, listener: Function)`
+
+Adds a listener to an event.
+
+#### Parameters
+
+- `event` (`string`): The event to listen to.
+
+- `listener` (`Function`): The listener to add.

apps/pd/README.md

@@ -0,0 +1,3 @@
+# @premid/pd
+
+A simple url shortener service to shorten urls longer than 256 characters.

apps/pd/environment.d.ts

@@ -0,0 +1,12 @@
+declare namespace NodeJS {
+	export interface ProcessEnv {
+		NODE_ENV?: "development" | "production" | "test";
+		REDIS_URL?: string;
+		MAX_FILE_SIZE?: string;
+		PORT?: string;
+		HOST?: string;
+		RATELIMIT_MAX?: string;
+		RATELIMIT_WINDOW?: string;
+		BASE_URL?: string;
+	}
+}

apps/pd/package.json

@@ -0,0 +1,34 @@
+{
+	"name": "@premid/pd",
+	"type": "module",
+	"version": "1.1.9",
+	"private": true,
+	"description": "A small service to shorten image urls to get around Discord's 256 character limit",
+	"license": "MPL-2.0",
+	"main": "dist/index.js",
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"start": "node --enable-source-maps .",
+		"dev": "node --watch --enable-source-maps ."
+	},
+	"dependencies": {
+		"@fastify/cors": "^9.0.1",
+		"@fastify/multipart": "^8.1.0",
+		"@fastify/rate-limit": "^9.1.0",
+		"@keyv/redis": "^2.8.4",
+		"fastify": "^4.26.0",
+		"file-type": "^19.0.0",
+		"got": "^14.2.0",
+		"ioredis": "^5.3.2",
+		"ipaddr.js": "^2.1.0",
+		"keyv": "^4.5.4",
+		"mime-types": "^2.1.35",
+		"nanoid": "^5.0.5"
+	},
+	"devDependencies": {
+		"@types/mime-types": "^2.1.4",
+		"form-data": "^4.0.0"
+	}
+}

apps/pd/src/functions/createKeyv.test.ts

@@ -0,0 +1,9 @@
+import { expect, it } from "vitest";
+
+import createKeyv from "./createKeyv.js";
+
+it("should return keyv instance", () => {
+	const keyv = createKeyv();
+
+	expect(keyv).toStrictEqual(expect.any(Object));
+});

apps/pd/src/functions/createKeyv.ts

@@ -0,0 +1,28 @@
+import process from "node:process";
+import KeyvRedis from "@keyv/redis";
+import Keyv from "keyv";
+
+import redis from "../redis.js";
+
+export default function createKeyv() {
+	let options: Keyv.Options<string> | undefined;
+
+	/* c8 ignore next 8 */
+	if (process.env.REDIS_SENTINELS) {
+		options = {
+			namespace: "pd",
+			store: new KeyvRedis(redis),
+		};
+	}
+
+	const keyv = new Keyv<string>(
+		options,
+	);
+
+	/* c8 ignore next 3 */
+	keyv.on("error", (error) => {
+		console.error("Keyv connection error:", error);
+	});
+
+	return keyv;
+}

apps/pd/src/functions/createRedis.ts

@@ -0,0 +1,30 @@
+/* eslint-disable no-console */
+import { hostname } from "node:os";
+
+import process from "node:process";
+import { Redis } from "ioredis";
+
+/* c8 ignore start */
+export default function createRedis(): Redis {
+	const redis = new Redis({
+		connectionName: `pd-${hostname()}-${process.pid.toString()}`,
+		lazyConnect: true,
+		name: "mymaster",
+		sentinels: process.env.REDIS_SENTINELS?.split(",").map(s => ({
+			host: s,
+			port: 26_379,
+		})),
+	});
+
+	/* c8 ignore next 3 */
+	redis.on("error", (error) => {
+		console.error("Redis error", error);
+	});
+
+	/* c8 ignore next 3 */
+	redis.on("connect", () => {
+		console.log("Redis connected");
+	});
+
+	return redis;
+}

apps/pd/src/functions/createServer.test.ts

@@ -0,0 +1,10 @@
+import { describe, expect, it } from "vitest";
+
+import { createServer } from "../functions/createServer.js";
+
+describe("createServer", () => {
+	it("should return a fastify instance", async () => {
+		const server = await createServer();
+		expect(server).toBeDefined();
+	});
+});

apps/pd/src/functions/createServer.ts

@@ -0,0 +1,62 @@
+import process from "node:process";
+import cors from "@fastify/cors";
+import fastifyMultipart from "@fastify/multipart";
+import ratelimit from "@fastify/rate-limit";
+import fastify from "fastify";
+import type { Redis } from "ioredis";
+
+import createFromBase64 from "../routes/createFromBase64.js";
+import createFromImage from "../routes/createFromImage.js";
+import createShortenedLink from "../routes/createShortenedLink.js";
+import getFullLink from "../routes/getFullLink.js";
+
+export async function createServer(redis?: Redis) {
+	const server = fastify({
+		trustProxy: true,
+	});
+
+	await server.register(cors, {
+		methods: ["GET"],
+		origin: "*",
+	});
+
+	await server.register(ratelimit, {
+		max: Number.parseInt(process.env.RATELIMIT_MAX ?? "25"),
+		nameSpace: "pd-ratelimit-",
+		redis,
+		timeWindow: process.env.RATELIMIT_WINDOW ?? "1 minute",
+	});
+
+	await server.register(fastifyMultipart, {
+		limits: {
+			fileSize: Number.parseInt(process.env.MAX_FILE_SIZE ?? (5 * 1024 * 1024).toString()),
+			files: 1,
+		},
+	});
+
+	server.post("/create/image", createFromImage);
+	server.post("/create/base64", createFromBase64);
+	server.get("/create/*", createShortenedLink);
+
+	server.get(
+		"/*",
+		{
+			config: {
+				rateLimit: false,
+			},
+		},
+		getFullLink,
+	);
+
+	server.get(
+		"/health",
+		{
+			config: {
+				rateLimit: false,
+			},
+		},
+		(_, reply) => reply.status(204).send(),
+	);
+
+	return server;
+}

apps/pd/src/functions/getGoogleAddresses.test.ts

@@ -0,0 +1,30 @@
+import got from "got";
+import { describe, expect, it, vi } from "vitest";
+
+describe.concurrent("getGoogleAddresses", () => {
+	it("should return an array of CIDR objects", async () => {
+		const { default: getGoogleAddresses } = await import("./getGoogleAddresses.js");
+
+		vi.spyOn(got, "get").mockResolvedValue({
+			body: JSON.stringify({
+				prefixes: [
+					{ ipv4Prefix: "0.0.0.0" },
+					{ ipv6Prefix: "0000:0000:0000::/16" },
+				],
+			}),
+		});
+
+		const result = await getGoogleAddresses();
+
+		expect(result).toMatchInlineSnapshot(`
+			[
+			  {
+			    "ipv4Prefix": "0.0.0.0",
+			  },
+			  {
+			    "ipv6Prefix": "0000:0000:0000::/16",
+			  },
+			]
+		`);
+	});
+});

apps/pd/src/functions/getGoogleAddresses.ts

@@ -0,0 +1,24 @@
+import got from "got";
+
+import type { CIDR } from "./isInCidRange.js";
+
+export default async function getGoogleAddresses(): Promise<CIDR> {
+	const { body } = await got.get("https://www.gstatic.com/ipranges/cloud.json");
+	const result = JSON.parse(body) as GoogleResult;
+	return result.prefixes.map(({ ipv4Prefix, ipv6Prefix }) => {
+		return ipv6Prefix ? { ipv6Prefix } : { ipv4Prefix };
+	});
+}
+
+interface GoogleResult {
+	syncToken: string;
+	creationTime: string;
+	prefixes: GoogleIP[];
+}
+
+interface GoogleIP {
+	ipv6Prefix: string;
+	ipv4Prefix: string;
+	service: string;
+	scope: string;
+}

apps/pd/src/functions/isInCidRange.test.ts

@@ -0,0 +1,31 @@
+import { expect, it } from "vitest";
+
+import isInCIDRRange from "./isInCidRange.js";
+
+it("isInCIDRRange - IPv4 - in range", () => {
+	const CIDRs = [{ ipv4Prefix: "192.0.2.0/24" }];
+	const ip = "192.0.2.123";
+	const result = isInCIDRRange(CIDRs, ip);
+	expect(result).toBe(true);
+});
+
+it("isInCIDRRange - IPv4 - not in range", () => {
+	const CIDRs = [{ ipv4Prefix: "192.0.2.0/24" }];
+	const ip = "192.0.3.123";
+	const result = isInCIDRRange(CIDRs, ip);
+	expect(result).toBe(false);
+});
+
+it("isInCIDRRange - IPv6 - in range", () => {
+	const CIDRs = [{ ipv6Prefix: "2001:db8::/32" }];
+	const ip = "2001:db8::1234";
+	const result = isInCIDRRange(CIDRs, ip);
+	expect(result).toBe(true);
+});
+
+it("isInCIDRRange - IPv6 - not in range", () => {
+	const CIDRs = [{ ipv6Prefix: "2001:db8::/32" }];
+	const ip = "2001:db9::1234";
+	const result = isInCIDRRange(CIDRs, ip);
+	expect(result).toBe(false);
+});

apps/pd/src/functions/isInCidRange.ts

@@ -0,0 +1,29 @@
+import ipaddr from "ipaddr.js";
+
+export default function isInCIDRRange(CIDRs: CIDR, ip: string) {
+	const parsed = ipaddr.parse(ip);
+
+	for (const CIDR of CIDRs.filter((c) => {
+		if (parsed.kind() === "ipv4" && "ipv4Prefix" in c)
+			return true;
+		else if (parsed.kind() === "ipv6" && "ipv6Prefix" in c)
+			return true;
+		else return false;
+	})) {
+		const check = parsed.match(ipaddr.parseCIDR("ipv4Prefix" in CIDR ? CIDR.ipv4Prefix : CIDR.ipv6Prefix));
+
+		if (check)
+			return check;
+	}
+
+	return false;
+}
+
+export type CIDR = (
+	| {
+		ipv4Prefix: string;
+	}
+	| {
+		ipv6Prefix: string;
+	}
+)[];

apps/pd/src/googleCIDRs.ts

@@ -0,0 +1,3 @@
+import getGoogleAddresses from "./functions/getGoogleAddresses.js";
+
+export default await getGoogleAddresses();

apps/pd/src/index.test.ts

@@ -0,0 +1,14 @@
+import { expect, it } from "vitest";
+
+import { createServer } from "./functions/createServer.js";
+
+it("/health", async () => {
+	const server = await createServer();
+	const result = await server.inject({
+		method: "GET",
+		url: "/health",
+	});
+
+	expect(result.statusCode).toBe(204);
+	expect(result.body).toBe("");
+});

apps/pd/src/index.ts

@@ -0,0 +1,20 @@
+/* eslint-disable no-console */
+/* c8 ignore start */
+import process from "node:process";
+import { createServer } from "./functions/createServer.js";
+import redis from "./redis.js";
+
+if (!process.env.REDIS_SENTINELS)
+	console.log("WARNING: No REDIS_SENTINELS environment variable set");
+if (process.env.NODE_ENV === "production" && !process.env.BASE_URL)
+	throw new Error("BASE_URL environment variable is required in production");
+
+export const server = await createServer(redis);
+
+const url = await server.listen({
+	host: process.env.HOST ?? "0.0.0.0",
+	port: Number.parseInt(process.env.PORT ?? "80"),
+});
+
+console.log(`Server listening at ${url}`);
+// TODO Make proper error codes & json responses

apps/pd/src/keyv.ts

@@ -0,0 +1,3 @@
+import createKeyv from "./functions/createKeyv.js";
+
+export default createKeyv();

apps/pd/src/redis.ts

@@ -0,0 +1,3 @@
+import createRedis from "./functions/createRedis.js";
+
+export default createRedis();

apps/pd/src/routes/createFromBase64.test.ts

@@ -0,0 +1,94 @@
+import { describe, it } from "vitest";
+
+import { createServer } from "../functions/createServer.js";
+
+describe.concurrent("createFromBase64", async () => {
+	const server = await createServer();
+
+	it("should return a 400 when the body is not present", async ({ expect }) => {
+		const result = await server.inject({
+			method: "POST",
+			url: "/create/base64",
+		});
+
+		expect(result.statusCode).toBe(400);
+		expect(result.body).toMatchInlineSnapshot("\"Invalid body\"");
+	});
+
+	it("should return a 400 when the body is not a string", async ({ expect }) => {
+		const result = await server.inject({
+			method: "POST",
+			payload: new Blob([]),
+			url: "/create/base64",
+		});
+
+		expect(result.statusCode).toBe(400);
+		expect(result.body).toMatchInlineSnapshot("\"Invalid body\"");
+	});
+
+	it("should return a 400 when the body is not a valid base64 string", async ({ expect }) => {
+		const result = await server.inject({
+			headers: {
+				"Content-Type": "text/plain",
+			},
+			method: "POST",
+			payload: "data:image/png;base64t",
+			url: "/create/base64",
+		});
+
+		expect(result.statusCode).toBe(400);
+		expect(result.body).toMatchInlineSnapshot("\"Invalid base64 string\"");
+	});
+
+	it("should return a 400 when the base64 string is not a valid image", async ({ expect }) => {
+		const result = await server.inject({
+			headers: {
+				"Content-Type": "text/plain",
+			},
+			method: "POST",
+			payload: "data:image/sv;base64,a",
+			url: "/create/base64",
+		});
+
+		expect(result.statusCode).toBe(400);
+		expect(result.body).toMatchInlineSnapshot("\"Invalid base64 string\"");
+
+		const result2 = await server.inject({
+			headers: {
+				"Content-Type": "text/plain",
+			},
+			method: "POST",
+			payload: "data:image/svg+xml;base64,s",
+			url: "/create/base64",
+		});
+
+		expect(result2.statusCode).toBe(400);
+		expect(result2.body).toMatchInlineSnapshot("\"Supported types: png, jpeg, jpg, gif, webp\"");
+	});
+
+	it("should return a 200 when the base64 string is valid", async ({ expect }) => {
+		const result = await server.inject({
+			headers: {
+				"Content-Type": "text/plain",
+			},
+			method: "POST",
+			payload: "data:image/png;base64,s",
+			url: "/create/base64",
+		});
+
+		expect(result.statusCode).toBe(200);
+		expect(result.body).toStrictEqual(expect.any(String));
+
+		const result2 = await server.inject({
+			headers: {
+				"Content-Type": "text/plain",
+			},
+			method: "POST",
+			payload: "data:image/png;base64,s",
+			url: "/create/base64",
+		});
+
+		expect(result2.statusCode).toBe(200);
+		expect(result2.body).toStrictEqual(expect.any(String));
+	});
+});

apps/pd/src/routes/createFromBase64.ts

@@ -0,0 +1,49 @@
+import crypto from "node:crypto";
+
+import process from "node:process";
+import mime from "mime-types";
+import { nanoid } from "nanoid";
+import type { RouteHandlerMethod } from "fastify";
+
+import keyv from "../keyv.js";
+
+const	handler: RouteHandlerMethod = async (request, reply) => {
+	const { body } = request;
+
+	if (!body)
+		return reply.status(400).send("Invalid body");
+
+	if (typeof body !== "string")
+		return reply.status(400).send("Invalid body");
+
+	const matches = body.match(/^data:(.+);base64,(.+)/);
+
+	if (!matches || matches.length === 0)
+		return reply.status(400).send("Invalid base64 string");
+
+	const type = mime.extension(matches.at(1)!);
+
+	if (!type)
+		return reply.status(400).send("Invalid base64 string");
+
+	if (!["png", "jpeg", "jpg", "gif", "webp"].includes(type))
+		return reply.status(400).send("Supported types: png, jpeg, jpg, gif, webp");
+
+	const hash = crypto.createHash("sha256").update(body).digest("hex");
+	const existingUrl = await keyv.get(hash);
+
+	if (existingUrl) {
+		void reply.header("Cache-control", `public, max-age=${(30 * 60).toString()}`);
+		return reply.send(process.env.BASE_URL! + existingUrl);
+	}
+
+	const uniqueId = `${nanoid(10)}.${type}`;
+
+	await keyv.set(hash, uniqueId, 30 * 60 * 1000);
+	await keyv.set(uniqueId, body, 30 * 60 * 1000);
+
+	void reply.header("Cache-control", `public, max-age=${(30 * 60).toString()}`);
+	return reply.send(process.env.BASE_URL! + uniqueId);
+};
+
+export default handler;

apps/pd/src/routes/createFromImage.test.ts

@@ -0,0 +1,106 @@
+import { Buffer } from "node:buffer";
+import { readFile } from "node:fs/promises";
+
+import type { RequestOptions } from "node:http";
+import type { AddressInfo } from "node:net";
+import { afterAll, beforeAll, describe, it } from "vitest";
+
+import { createServer } from "../functions/createServer.js";
+
+describe.concurrent("createFromImage", async () => {
+	const server = await createServer();
+	const form = new FormData();
+	const defaultRequestOptions: RequestOptions = {
+		hostname: "localhost",
+		method: "POST",
+		path: "/create/image",
+		protocol: "http:",
+	};
+
+	let url: string;
+
+	beforeAll(async () => {
+		url = await server.listen();
+		defaultRequestOptions.port = (server.server.address() as AddressInfo).port;
+	});
+
+	afterAll(() => {
+		void server.close();
+	});
+
+	it("should return a 400 when request is not multipart", async ({ expect }) => {
+		const result = await fetch(`${url}/create/image`, {
+			method: "POST",
+		});
+
+		expect(result.status).toBe(400);
+		expect(await result.text()).toMatchInlineSnapshot("\"Request is not multipart\"");
+	});
+
+	it("should return a 400 status code when no file is provided", async ({ expect }) => {
+		const result = await fetch(`${url}/create/image`, {
+			body: form,
+			method: "POST",
+		});
+
+		expect(result.status).toBe(400);
+		expect(await result.text()).toMatchInlineSnapshot("\"Invalid file\"");
+	});
+	it("should return a 400 status code when the file is invalid", async ({ expect }) => {
+		form.set("file", Buffer.alloc(1024 * 1024 * 2));
+
+		const result = await fetch(`${url}/create/image`, {
+			body: form,
+			method: "POST",
+		});
+
+		expect(result.status).toBe(400);
+		expect(await result.text()).toMatchInlineSnapshot("\"Invalid file\"");
+
+		form.set("file", new Blob([new Uint8Array(1024 * 1024 * 2)]));
+
+		const result2 = await fetch(`${url}/create/image`, {
+			body: form,
+			method: "POST",
+		});
+
+		expect(result2.status).toBe(400);
+		expect(await result2.text()).toMatchInlineSnapshot("\"Invalid file\"");
+	});
+
+	it("should return a 400 status code when the file is not an image", async ({ expect }) => {
+		form.set("file", new Blob([await readFile(new URL("../../fixtures/test.mp4", import.meta.url))]));
+
+		const result = await fetch(`${url}/create/image`, {
+			body: form,
+			method: "POST",
+		});
+
+		expect(result.status).toBe(400);
+		expect(await result.text()).toMatchInlineSnapshot("\"Only png, jpeg, jpg, gif and webp are supported\"");
+	});
+
+	it("should return a 200 status code when the file is valid", async ({ expect }) => {
+		form.set("file", new Blob([await readFile(new URL("../../fixtures/1x1.png", import.meta.url))]));
+
+		const result = await fetch(`${url}/create/image`, {
+			body: form,
+			method: "POST",
+		});
+
+		expect(result.status).toBe(200);
+		expect(await result.text()).toStrictEqual(expect.any(String));
+	});
+
+	it("should return a 200 status code when the file is valid and the same file is uploaded again", async ({ expect }) => {
+		form.set("file", new Blob([await readFile(new URL("../../fixtures/1x1.png", import.meta.url))]));
+
+		const result = await fetch(`${url}/create/image`, {
+			body: form,
+			method: "POST",
+		});
+
+		expect(result.status).toBe(200);
+		expect(await result.text()).toStrictEqual(expect.any(String));
+	});
+});

apps/pd/src/routes/createFromImage.ts

@@ -0,0 +1,55 @@
+import crypto from "node:crypto";
+
+import process from "node:process";
+import { fileTypeFromBuffer } from "file-type";
+import { nanoid } from "nanoid";
+import type { RouteHandlerMethod } from "fastify";
+
+import keyv from "../keyv.js";
+
+const handler: RouteHandlerMethod = async (request, reply) => {
+	if (!request.isMultipart())
+		return reply.status(400).send("Request is not multipart");
+
+	const file = await request.file();
+
+	if (!file)
+		return reply.status(400).send("Invalid file");
+
+	const type = await fileTypeFromBuffer(await file.toBuffer());
+
+	if (!type)
+		return reply.status(400).send("Invalid file");
+
+	if (![
+		"image/png",
+		"image/jpeg",
+		"image/jpg",
+		"image/gif",
+		"image/webp",
+	].includes(type.mime)) {
+		return reply.status(400).send("Only png, jpeg, jpg, gif and webp are supported");
+	}
+
+	const buffer = await file.toBuffer();
+	const body = `data:${type.mime};base64,${buffer.toString("base64")}`;
+	const hash = crypto.createHash("sha256").update(body).digest("hex");
+	const existingUrl = await keyv.get(hash);
+
+	if (existingUrl) {
+		void reply.header("Cache-control", `public, max-age=${(30 * 60).toString()}`);
+		return reply.send(process.env.BASE_URL! + existingUrl);
+	}
+
+	const uniqueId = `${nanoid(10)}.${type.ext}`;
+
+	await Promise.all([
+		keyv.set(hash, uniqueId, 30 * 60 * 1000),
+		keyv.set(uniqueId, body, 30 * 60 * 1000),
+	]);
+
+	void reply.header("Cache-control", `public, max-age=${(30 * 60).toString()}`);
+	return reply.send(process.env.BASE_URL! + uniqueId);
+};
+
+export default handler;

apps/pd/src/routes/createShortenedLink.test.ts

@@ -0,0 +1,64 @@
+import { describe, expect, it } from "vitest";
+
+import { createServer } from "../functions/createServer.js";
+
+describe.concurrent("/create", async () => {
+	const server = await createServer();
+
+	it("should return a 400 status code when no URL is provided", async () => {
+		const result = await server.inject({
+			method: "GET",
+			url: "/create/",
+		});
+
+		expect(result.statusCode).toBe(400);
+		expect(result.body).toMatchInlineSnapshot("\"Invalid URL\"");
+	});
+
+	it("should return a 400 status code when the URL is too short", async () => {
+		const result = await server.inject({
+			method: "GET",
+			url: "/create/https://www.google.com",
+		});
+		expect(result.statusCode).toBe(400);
+		expect(result.body).toMatchInlineSnapshot("\"URL is too short\"");
+	});
+
+	it("should return a 400 status code when the URL is invalid", async () => {
+		const result = await server.inject({
+			method: "GET",
+			url: `/create/file://www.googl${"e".repeat(256)}`,
+		});
+
+		expect(result.statusCode).toBe(400);
+		expect(result.body).toMatchInlineSnapshot("\"Invalid URL\"");
+	});
+
+	it("should return a 200 status code when the URL is valid", async () => {
+		const result = await server.inject({
+			method: "GET",
+			url: `/create/https://www.googl${"e".repeat(256)}.com`,
+		});
+
+		expect(result.statusCode).toBe(200);
+		expect(result.body).toStrictEqual(expect.any(String));
+	});
+
+	it("should return a 200 status code when the URL is valid and already exists", async () => {
+		const result = await server.inject({
+			method: "GET",
+			url: `/create/https://www.googl${"d".repeat(256)}.com`,
+		});
+
+		expect(result.statusCode).toBe(200);
+		expect(result.body).toStrictEqual(expect.any(String));
+		const { body } = result;
+		const result2 = await server.inject({
+			method: "GET",
+			url: `/create/https://www.googl${"d".repeat(256)}.com`,
+		});
+
+		expect(result2.statusCode).toBe(200);
+		expect(result2.body).toStrictEqual(body);
+	});
+});

apps/pd/src/routes/createShortenedLink.ts

@@ -0,0 +1,39 @@
+import crypto from "node:crypto";
+
+import process from "node:process";
+import { nanoid } from "nanoid";
+import type { RouteHandlerMethod } from "fastify";
+
+import keyv from "../keyv.js";
+
+const handler: RouteHandlerMethod = async (request, reply) => {
+	const url = request.url.replace("/create/", "").trim();
+
+	if (url.length === 0)
+		return reply.status(400).send("Invalid URL");
+
+	if (url.length < 256)
+		return reply.status(400).send("URL is too short");
+
+	const urlObject = new URL(url);
+	if (!["http:", "https:"].includes(urlObject.protocol))
+		return reply.status(400).send("Invalid URL");
+
+	const hash = crypto.createHash("sha256").update(url).digest("hex");
+	const existingShortenedUrl = await keyv.get(hash);
+
+	void reply.header("Cache-control", "public, max-age=1800");
+
+	if (existingShortenedUrl) {
+		await Promise.all([keyv.set(hash, existingShortenedUrl, 1800), keyv.set(existingShortenedUrl, url, 1800)]);
+		return reply.send(process.env.BASE_URL! + existingShortenedUrl);
+	}
+
+	const uniqueId = nanoid(10);
+
+	await Promise.all([keyv.set(hash, uniqueId, 1800), keyv.set(uniqueId, url, 1800)]);
+
+	return reply.send(process.env.BASE_URL! + uniqueId);
+};
+
+export default handler;

apps/pd/src/routes/getFullLink.test.ts

@@ -0,0 +1,101 @@
+import { Buffer } from "node:buffer";
+
+import { readFile } from "node:fs/promises";
+import { afterAll, beforeAll, describe, expect, it, vi } from "vitest";
+
+import { createServer } from "../functions/createServer.js";
+import * as isInCIDRRange from "../functions/isInCidRange.js";
+
+describe("getFullLink", async () => {
+	const server = await createServer();
+	let url: string;
+
+	beforeAll(async () => {
+		url = await server.listen();
+	});
+
+	afterAll(async () => {
+		await server.close();
+	});
+
+	it("should fail if not a Google Cloud IP", async () => {
+		const result = await server.inject({
+			headers: {
+				"cf-connecting-ip": "",
+			},
+			url: "/1234567890",
+		});
+
+		expect(result.statusCode).toBe(401);
+	});
+
+	it("should fail if not a valid ID", async () => {
+		vi.spyOn(isInCIDRRange, "default").mockReturnValueOnce(true);
+
+		const result = await server.inject({
+			headers: {
+				"cf-connecting-ip": "",
+			},
+			url: "/123",
+		});
+
+		vi.spyOn(isInCIDRRange, "default").mockReturnValueOnce(true);
+		const result2 = await server.inject({
+			headers: {
+				"cf-connecting-ip": "",
+			},
+			url: "/1234567890.",
+		});
+
+		expect(result.statusCode).toBe(404);
+		expect(result2.statusCode).toBe(404);
+	});
+
+	it("should redirect to the correct URL", async () => {
+		vi.spyOn(isInCIDRRange, "default").mockReturnValueOnce(true);
+
+		const { body } = await server.inject({
+			url: `/create/https://${"a".repeat(256)}`,
+		});
+
+		expect(body).toStrictEqual(expect.any(String));
+
+		const result = await server.inject({
+			headers: {
+				"cf-connecting-ip": "",
+			},
+			url: body,
+		});
+
+		expect(result.statusCode).toBe(302);
+		expect(result.headers.location).toBe(`https://${"a".repeat(256)}`);
+	});
+
+	it("should return the correct image", async () => {
+		const imageBuffer = await readFile(new URL("../../fixtures/test.mp4", import.meta.url));
+		const imageBase64 = `data:image/png;base64,${imageBuffer.toString("base64")}`;
+
+		const { body } = await server.inject({
+			headers: {
+				"Content-Type": "text/plain",
+			},
+			method: "POST",
+			payload: imageBase64,
+			url: "/create/base64",
+		});
+
+		expect(body).toStrictEqual(expect.any(String));
+
+		vi.spyOn(isInCIDRRange, "default").mockReturnValueOnce(true);
+
+		const result = await fetch(`${url}${body}`, {
+			headers: {
+				"cf-connecting-ip": "",
+			},
+		});
+
+		expect(result.status).toBe(200);
+		expect(result.headers.get("content-type")).toBe("image/png");
+		expect(Buffer.from(await result.arrayBuffer())).toStrictEqual(imageBuffer);
+	});
+});

apps/pd/src/routes/getFullLink.ts

@@ -0,0 +1,51 @@
+import { Buffer } from "node:buffer";
+
+import crypto from "node:crypto";
+import type { RouteHandlerMethod } from "fastify";
+
+import isInCIDRRange from "../functions/isInCidRange.js";
+import googleCIDRs from "../googleCIDRs.js";
+import keyv from "../keyv.js";
+
+const handler: RouteHandlerMethod = async (request, reply) => {
+	/* c8 ignore next 2 */
+	const ip = request.headers["cf-connecting-ip"]?.toString() || request.socket.remoteAddress || request.ip;
+
+	if (
+		!isInCIDRRange(
+			googleCIDRs,
+			ip,
+		)
+	) {
+		return reply.status(401).send("Not a Google Cloud IP");
+	}
+
+	const id = (request.params as { "*": string })["*"].trim();
+
+	if (id.split(".")[0]?.length !== 10)
+		return reply.code(404).send("Invalid ID");
+
+	const url = await keyv.get(id);
+	if (!url)
+		return reply.code(404).send("Unknown ID");
+
+	const hash = crypto.createHash("sha256").update(url).digest("hex");
+
+	await Promise.all([keyv.set(hash, id, 30 * 60 * 1000), keyv.set(id, url, 30 * 60 * 1000)]);
+	void reply.header("Cache-control", "public, max-age=1800");
+
+	//* If it is not a base64 string, redirect to it
+	if (!url.startsWith("data:image"))
+		return reply.redirect(url);
+
+	const image = Buffer.from(
+		url.replace(/^data:image\/\w+;base64,/, ""),
+		"base64",
+	);
+
+	const mime = url.split(";")[0]!.split(":")[1]!;
+
+	return reply.type(mime).send(image);
+};
+
+export default handler;

apps/pd/tsconfig.app.json

@@ -0,0 +1,8 @@
+{
+	"extends": "../../tsconfig.base.json",
+	"compilerOptions": {
+		"composite": true,
+		"rootDir": "src",
+		"outDir": "dist"
+	}
+}

apps/pd/tsconfig.json

@@ -0,0 +1,8 @@
+{
+	"extends": "./tsconfig.app.json",
+	"compilerOptions": {
+		"types": ["@types/node"],
+		"noEmit": true
+	},
+	"include": ["environment.d.ts", "src"]
+}

apps/schema-server/.eslintrc.yaml

@@ -0,0 +1,2 @@
+rules:
+  no-console: off

apps/schema-server/Readme.md

@@ -0,0 +1,3 @@
+# @premid/schema-server
+
+This is a simple schema server which serves JSON schemas for Presence Developers.

apps/schema-server/environment.d.ts

@@ -0,0 +1,7 @@
+declare namespace NodeJS {
+	export interface ProcessEnv {
+		NODE_ENV?: "development" | "production" | "test";
+		PORT?: string;
+		HOST?: string;
+	}
+}

apps/schema-server/package.json

@@ -0,0 +1,22 @@
+{
+	"name": "@premid/schema-server",
+	"type": "module",
+	"version": "1.0.3",
+	"private": true,
+	"description": "A small service to serve the JSON schemas for PreMiD",
+	"license": "MPL-2.0",
+	"main": "dist/index.js",
+	"files": [
+		"dist",
+		"schemas"
+	],
+	"scripts": {
+		"start": "node --enable-source-maps .",
+		"dev": "node --watch --enable-source-maps ."
+	},
+	"dependencies": {
+		"@fastify/helmet": "^11.1.1",
+		"fastify": "^4.26.0",
+		"globby": "^14.0.1"
+	}
+}

apps/schema-server/schemas/metadata/1.0.json

@@ -0,0 +1,241 @@
+{
+	"$schema": "http://json-schema.org/draft-07/schema",
+	"$id": "https://schemas.premid.app/metadata/1.0",
+
+	"title": "Metadata",
+	"type": "object",
+	"description": "Metadata that describes a presence.",
+
+	"definitions": {
+		"user": {
+			"type": "object",
+			"description": "User information.",
+
+			"properties": {
+				"name": {
+					"type": "string",
+					"description": "The name of the user."
+				},
+
+				"id": {
+					"type": "string",
+					"description": "The Discord snowflake of the user.",
+					"pattern": "^\\d+$"
+				}
+			},
+
+			"additionalProperties": false,
+			"required": ["name", "id"]
+		}
+	},
+
+	"properties": {
+		"$schema": {
+			"$comment": "This is required otherwise the schema will fail itself when it is applied to a document via $schema. This is optional so that validators that use this schema don't fail if the metadata doesn't have the $schema property.",
+
+			"type": "string",
+			"description": "The metadata schema URL."
+		},
+
+		"author": {
+			"$ref": "#/definitions/user",
+			"description": "The author of this presence."
+		},
+
+		"contributors": {
+			"type": "array",
+			"description": "Any extra contributors to this presence.",
+
+			"items": {
+				"$ref": "#/definitions/user"
+			}
+		},
+
+		"service": {
+			"type": "string",
+			"description": "The service this presence is for."
+		},
+
+		"description": {
+			"type": "object",
+			"description": "A description of the presence in multiple languages.",
+
+			"propertyNames": {
+				"type": "string",
+				"description": "The language key. The key must be languagecode(_REGIONCODE).",
+				"pattern": "^[a-z]{2}(_[A-Z]{2})?$"
+			},
+			"patternProperties": {
+				"^[a-z]{2}(_[A-Z]{2})?$": {
+					"type": "string",
+					"description": "The description of the presence in the key's language."
+				}
+			},
+
+			"additionalProperties": false,
+			"required": ["en"]
+		},
+
+		"url": {
+			"type": ["string", "array"],
+			"description": "The service's website URL, or an array of URLs. Protocols should not be added.",
+			"pattern": "^(([a-z0-9-]+\\.)*[0-9a-z_-]+(\\.[a-z]+)+|(\\d{1,3}\\.){3}\\d{1,3}|localhost)$",
+
+			"items": {
+				"type": "string",
+				"description": "One of the service's website URLs.",
+				"pattern": "^(([a-z0-9-]+\\.)*[0-9a-z_-]+(\\.[a-z]+)+|(\\d{1,3}\\.){3}\\d{1,3}|localhost)$"
+			},
+			"minItems": 2
+		},
+
+		"version": {
+			"type": "string",
+			"description": "The SemVer version of the presence. Must just be major.minor.patch.",
+			"pattern": "^\\d+\\.\\d+\\.\\d+$"
+		},
+
+		"logo": {
+			"type": "string",
+			"description": "The logo of the service this presence is for.",
+			"pattern": "^https?:\\/\\/?(?:[a-z0-9-]+\\.)*[0-9a-z_-]+(?:\\.[a-z]+)+\\/.*$"
+		},
+
+		"thumbnail": {
+			"type": "string",
+			"description": "A thumbnail of the service this presence is for.",
+			"pattern": "^https?:\\/\\/?([a-z0-9-]+\\.)*[0-9a-z_-]+(\\.[a-z]+)+\\/.*$"
+		},
+
+		"color": {
+			"type": "string",
+			"description": "The theme color of the service this presence is for. Must be either a 6 digit or a 3 digit hex code.",
+			"pattern": "^#([A-Fa-f0-9]{3}){1,2}$"
+		},
+
+		"tags": {
+			"type": ["array"],
+			"description": "The tags for the presence.",
+
+			"items": {
+				"type": "string",
+				"description": "A tag.",
+				"pattern": "^[^A-Z\\s!\"#$%&'()*+,./:;<=>?@\\[\\\\\\]^_`{|}~]+$"
+			},
+			"minItems": 1
+		},
+
+		"category": {
+			"type": "string",
+			"description": "The category the presence falls under.",
+			"enum": ["anime", "games", "music", "socials", "videos", "other"]
+		},
+
+		"iframe": {
+			"type": "boolean",
+			"description": "Whether or not the presence should run in IFrames."
+		},
+
+		"regExp": {
+			"type": "string",
+			"description": "A regular expression used to match URLs for the presence to inject into."
+		},
+
+		"iFrameRegExp": {
+			"type": "string",
+			"description": "A regular expression used to match IFrames for the presence to inject into."
+		},
+
+		"button": {
+			"type": "boolean",
+			"description": "Controls whether the presence is automatically added when the extension is installed. For partner presences only."
+		},
+
+		"warning": {
+			"type": "boolean",
+			"description": "Shows a warning saying that it requires additional steps for the presence to function correctly."
+		},
+
+		"settings": {
+			"type": "array",
+			"description": "An array of settings the user can change in the presence.",
+
+			"items": {
+				"type": "object",
+				"description": "A setting.",
+
+				"properties": {
+					"id": {
+						"type": "string",
+						"description": "The ID of the setting."
+					},
+
+					"title": {
+						"type": "string",
+						"description": "The title of the setting. Required only if `multiLanguage` is disabled."
+					},
+
+					"icon": {
+						"type": "string",
+						"description": "The icon of the setting. Required only if `multiLanguage` is disabled.",
+						"pattern": "^fa[bs] fa-[0-9a-z-]+$"
+					},
+
+					"if": {
+						"type": "object",
+						"description": "Restrict showing this setting if another setting is the defined value.",
+
+						"propertyNames": {
+							"type": "string",
+							"description": "The ID of the setting."
+						},
+
+						"patternProperties": {
+							"": {
+								"type": ["string", "number", "boolean"],
+								"description": "The value of the setting."
+							}
+						},
+
+						"additionalProperties": false
+					},
+
+					"placeholder": {
+						"type": "string",
+						"description": "The placeholder for settings that require input. Shown when the input is empty."
+					},
+
+					"value": {
+						"type": ["string", "number", "boolean"],
+						"description": "The default value of the setting. Not compatible with `values`."
+					},
+
+					"values": {
+						"type": "array",
+						"description": "The default values of the setting. Not compatible with `value`.",
+
+						"items": {
+							"type": ["string", "number", "boolean"],
+							"description": "The value of the setting."
+						}
+					},
+
+					"multiLanguage": {
+						"type": ["string", "boolean", "array"],
+						"description": "When false, multi-localization is disabled. When true, strings from the `general.json` file are available for use. When a string, it is the name of a file (excluding .json) of a used language from the localization GitHub repo. When an array of strings, it is all of the file names (excluding .json) of used languages from the localization GitHub repo.",
+
+						"items": {
+							"type": "string",
+							"description": "The name of a file from the localization GitHub repository."
+						}
+					}
+				},
+
+				"additionalProperties": false
+			}
+		}
+	},
+
+	"additionalProperties": false,
+	"required": ["author", "service", "description", "url", "version", "logo", "thumbnail", "color", "tags", "category"]
+}