Beta release.

.env.template

@@ -0,0 +1 @@
+HOST_URL="http://localhost:40500"

.gitignore

@@ -0,0 +1,3 @@
+/node_modules
+.env
+data/**

.vscode/settings.json

@@ -0,0 +1,92 @@
+{
+	"psi-header.config": {
+		"forceToTop": true,
+		"blankLinesAfter": 1,
+		"spacesBetweenYears": false,
+		"license": "MIT",
+		"company": "OpenMinerva",
+		"creationDateZero": "asIs",
+	},
+	"psi-header.lang-config": [
+		{
+			"language": "javascript",
+			"begin": "/* --- License",
+			"prefix": "* ",
+			"lineLength": 80,
+			"end": "* --- License */",
+			"forceToTop": true,
+			"blankLinesAfter": 1,
+			"beforeHeader": [],
+			"afterHeader": [],
+			"rootDirFileName": "session-server",
+			"modAuthor": "Modified By:",
+			"modDate": "Last Modified:",
+			"modDateFormat": "dd/MM/yyyy hh:nn:ss",
+			"replace": [
+				"Filename:",
+				"Project"
+			],
+			"ignoreLines": []
+		},
+		{
+			"language": "scss",
+			"begin": "/* --- License",
+			"prefix": "* ",
+			"lineLength": 80,
+			"end": "* --- License */",
+			"forceToTop": true,
+			"blankLinesAfter": 1,
+			"beforeHeader": [],
+			"afterHeader": [],
+			"rootDirFileName": "session-server",
+			"modAuthor": "Modified By:",
+			"modDate": "Last Modified:",
+			"modDateFormat": "dd/MM/yyyy hh:nn:ss",
+			"replace": [
+				"Filename:",
+				"Project"
+			],
+			"ignoreLines": []
+		}
+	],
+	"psi-header.templates": [
+		{
+			"language": "javascript",
+			"template": [
+				"File: <<filerelativepath>>",
+				"Project: <<projectname>>",
+				"Created Date: <<filecreated('DD MMMM YYYY')>>",
+				"Copyright (c) <<yeartoyear(fc, now)>> <<company>>",
+				"License: <<licensename>>",
+				"Authors: <<author>>",
+			],
+			"changeLogCaption": "HISTORY",
+			"changeLogHeaderLineCount": 2,
+			"changeLogEntryTemplate": [
+				"",
+				"<<dateformat(DD-MM-YYYY)>>\t<<initials>>\t"
+			],
+			"changeLogNaturalOrder": false,
+			"changeLogFooterLineCount": 0
+		},
+		{
+			"language": "scss",
+			"template": [
+				"File: <<filerelativepath>>",
+				"Project: <<projectname>>",
+				"Created Date: <<filecreated('DD MMMM YYYY')>>",
+				"Copyright (c) <<yeartoyear(fc, now)>> <<company>>",
+				"License: <<licensename>>",
+				"Authors: <<author>>",
+			],
+			"changeLogCaption": "HISTORY",
+			"changeLogHeaderLineCount": 2,
+			"changeLogEntryTemplate": [
+				"",
+				"<<dateformat(DD-MM-YYYY)>>\t<<initials>>\t"
+			],
+			"changeLogNaturalOrder": false,
+			"changeLogFooterLineCount": 0
+		}
+	]
+}

Containerfile

@@ -0,0 +1,9 @@
+FROM node:24-slim
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci --omit=dev
+COPY . .
+EXPOSE 40500
+CMD sh -c 'npx drizzle-kit generate \
+        && npx drizzle-kit migrate \
+        && node server.js'

README.md

@@ -1,2 +1,43 @@
-# session-server
-The server for listing and advertising active sessions 
+> [!WARNING] 
+> This repository is currently pre-alpha, breaking changes happen frequently, there have not been any security audits, and data loss is expected.
+
+<p align="center">
+  <img height="150" src="https://github.com/openminerva/session-server/blob/alpha/docs/logos/om-logo-big.webp?raw=true" />
+</p>
+
+[![](https://dcbadge.limes.pink/api/server/https://discord.gg/Kx6avB52gK)](https://discord.gg/Kx6avB52gK)
+
+# Session Server
+
+Session Server is the session discovery service for the OpenMinerva client.
+
+## Overview
+
+Session Server is a self hostable microservice for the OpenMinerva project that allows users to advertise their open sessions, and have their sessions be found by others. This service only serves as an advertisement board for open sessions, and does not facilitate any connection between any parties. 
+
+## Quick Start
+Installation and running on Linux.
+```bash
+# Clone this repository.
+git clone https://github.com/OpenMinerva/session-server
+
+# Navigate to the repository.
+cd session-server
+
+# Create the .env file from the template.
+cp .env.template .env
+```
+From here you have two directions. For production use, you probably want to run the command 
+```bash
+./podman-run.sh # For production environments.
+```
+This will firstly compile all [SASS](https://sass-lang.com/) files to regular css, then it will use [Podman](https://podman.io/) to build a container using the [Containerfile](https://github.com/OpenMinerva/session-server/blob/alpha/Containerfile) using the default port `40500`.
+
+Alternatively for development, you can simply run 
+```bash
+node server.js # For development.
+```
+to start the server on your local machine without a container.
+
+## Contributing
+See [CONTRIBUTING.md](https://github.com/OpenMinerva/session-server/blob/alpha/CONTRIBUTING.md) for guidelines, and information.

drizzle.config.js

@@ -0,0 +1,8 @@
+const { defineConfig } = require("drizzle-kit");
+
+module.exports = defineConfig({
+	dialect: "sqlite",
+	schema: "./src/db/schema.js",
+	out: "./data/drizzle",
+	dbCredentials: { url: "./data/openminerva-session-server.db" },
+});

eslint.config.mjs

@@ -0,0 +1,14 @@
+import { defineConfig } from "eslint/config";
+
+export default defineConfig([
+	{
+		"rules": {
+			"no-unused-vars": ["error"],
+			"indent": ["error", "tab"],
+			"no-extra-semi": ["error"],
+			"semi": ["error"],
+			"semi-spacing": ["error"],
+			"semi-style": ["error"],
+		}
+	}
+]);