@awesomeness-js/server 1.0.0

package/.editorconfig

@@ -0,0 +1,4 @@
+[*]
+indent_style = tab
+indent_size = tab
+tab_width = 4

package/.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

package/.jshintrc

@@ -0,0 +1,3 @@
+{
+  "esversion":6
+}

package/.vscode/settings.json

@@ -0,0 +1,17 @@
+{
+	"editor.tabSize": 4,
+	"editor.detectIndentation": false,
+	"editor.codeActionsOnSave": {
+		"source.fixAll": "explicit",
+		"source.fixAll.eslint": "explicit"
+	},
+	"eslint.workingDirectories": [
+		{
+			"mode": "auto"
+		}
+	],
+	"github.copilot.chat.codeGeneration.useInstructionFiles": true,
+	"code-runner.runInTerminal": true,
+	"code-runner.fileDirectoryAsCwd": true,
+	"terminal.integrated.defaultProfile.windows": "Git Bash",
+}

package/CLA.md

@@ -0,0 +1,9 @@
+# Contributor License Agreement
+
+By contributing to this repository, you agree that:
+
+1. You have the right to submit the contribution
+2. You grant the project owner a perpetual, worldwide, royalty-free license to use, modify, distribute, and relicense your contribution
+3. Your contribution does not infringe on third-party rights
+
+This agreement applies to all contributions submitted via pull request, issue, or other means.

package/CONTRIBUTING.md

@@ -0,0 +1,18 @@
+# Contributing
+
+Thank you for your interest in contributing!
+
+## License of Contributions
+
+By submitting a contribution to this project, you agree that:
+
+- Your contribution is licensed under the Apache License 2.0
+- You grant the project owner the right to relicense your contribution as part of future versions of the project
+
+If you do not agree to these terms, please do not submit a contribution.
+
+## How to Contribute
+
+- Fork the repository
+- Create a feature branch
+- Submit a pull request

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2026 Scott Forte
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/NOTICE

@@ -0,0 +1,15 @@
+Copyright © 2026 Scott Forte
+
+This product includes software developed by Scott Forte.
+
+This product includes software developed by third parties.
+
+- @awesomeness-js/server (Apache License 2.0)
+  Copyright © 2026 Scott Forte
+
+- busboy (MIT License)
+- koa (MIT License)
+- koa-compress (MIT License)
+- koa-send (MIT License)
+- ws (MIT License)
+- zlib (zlib License)

package/README.md

@@ -0,0 +1,15 @@
+# Awesomeness JS Configuration
+
+Most configurations for Awesomeness JS are done through the `.awesomeness/config.js` file.
+
+The `./awesomeness/` folder and you can customize the location by modifying the import paths in `package.json`.
+
+## For an Example Application see the repo
+
+[@awesomeness-js/app-template](https://github.com/awesomeness-js/app-template)
+
+## License
+
+This project is licensed under the Apache License 2.0.
+
+© 2026 Your Name. All rights reserved.

package/SECURITY.md

@@ -0,0 +1,7 @@
+# Security Policy
+
+If you discover a security issue, please report it privately.
+
+Email: security@email.awesomenessjs.com
+
+Do not open public issues for security vulnerabilities.

package/config.js

@@ -0,0 +1,29 @@
+let _config = Object.freeze({}); 
+
+export function init(userConfig = {}) {
+
+	const defaults = {
+		applicationMap: {},
+		beforeRouteMiddleware: [],
+		checkSession: null,
+		hostMap: null,
+		initDB: null,
+		specialRoutes: {},
+		wsHandler: null,
+		componentLocations: [],
+	};
+
+	_config = Object.freeze({
+		...defaults,
+		...userConfig,
+	});
+
+	return _config;
+
+}
+
+export function getConfig() {
+
+	return _config;
+
+}

package/eslint.config.js

@@ -0,0 +1,101 @@
+export default [
+	{
+		rules: {
+			// Ignore ALL line-break rules around import statements ONLY
+			'padding-line-between-statements': [
+				'error',
+
+				// imports are exempt
+				{
+					blankLine: 'any',
+					prev: 'import',
+					next: '*' 
+				},
+				{
+					blankLine: 'any',
+					prev: '*',
+					next: 'import' 
+				},
+
+				// everything else still padded like before
+				{
+					blankLine: 'always',
+					prev: '*',
+					next: 'block-like' 
+				},
+				{
+					blankLine: 'always',
+					prev: 'block-like',
+					next: '*' 
+				},
+				{
+					blankLine: 'always',
+					prev: '*',
+					next: 'function' 
+				},
+				{
+					blankLine: 'always',
+					prev: 'function',
+					next: '*' 
+				},
+				{
+					blankLine: 'always',
+					prev: '*',
+					next: 'throw' 
+				}
+			],
+
+			// ✅ This enforces ONE blank line at top + bottom of function bodies
+			// (and other normal blocks), matching your "inside curly braces" requirement.
+			'padded-blocks': [
+				'error',
+				{
+					blocks: 'always',
+					classes: 'always',
+					switches: 'always'
+				}
+			],
+
+			// Keep brace-newline rules, BUT disable them for imports only
+			'object-curly-newline': [
+				'error',
+				{
+					ObjectExpression: {
+						minProperties: 2,
+						multiline: true,
+						consistent: true
+					},
+					ObjectPattern: {
+						minProperties: 2,
+						multiline: true,
+						consistent: true
+					},
+
+					// imports ignore curly newline formatting
+					ImportDeclaration: {
+						multiline: false,
+						minProperties: 99999,
+						consistent: false
+					},
+
+					ExportDeclaration: {
+						multiline: true,
+						minProperties: 2
+					}
+				}
+			],
+
+			'object-property-newline': [ 'error', { allowAllPropertiesOnSameLine: false } ],
+			indent: [ 'error', 'tab', { SwitchCase: 1 } ],
+			semi: [ 'error', 'always' ],
+			'arrow-parens': [ 'error', 'always' ],
+			'object-curly-spacing': [ 'error', 'always' ],
+			'array-bracket-spacing': [ 'error', 'always' ],
+			'lines-between-class-members': [ 'error', 'always' ],
+			'newline-after-var': [ 'error', 'always' ],
+			'newline-before-return': 'error',
+			'brace-style': [ 'error', '1tbs', { allowSingleLine: false } ],
+			"no-unreachable": "off"
+		}
+	}
+];

package/example-.awesomeness/applicationMap.js

@@ -0,0 +1,4 @@
+// KV using awesomenessRequest.host (after mapping) to get set v on awesomenessRequest.applicationName
+export default {
+	'some.known.host.com': 'exampleApplicationName',
+};

package/example-.awesomeness/beforeRouteMiddleware.js

@@ -0,0 +1,15 @@
+// All functions called before request routing
+
+async function customMiddleware1(ctx, next) {
+
+	// console.log('Custom middleware before routeRequest', ctx.awesomenessRequest.path);
+	
+	// custom logic here
+
+	await next();
+
+}
+
+export default [ 
+	customMiddleware1 
+];

package/example-.awesomeness/checkSession.js

@@ -0,0 +1,15 @@
+import app from '#app';
+
+export default async (awesomenessRequest) => {
+
+	//console.log('checking session');
+	
+	const session = await app.session.check(awesomenessRequest);	
+
+	const user = await app.user.get({ id: session.userId });
+
+	awesomenessRequest.user = user;
+
+	//console.log('session valid', { user });
+
+};

package/example-.awesomeness/config.js

@@ -0,0 +1,40 @@
+import hostMap from './hostMap.js';
+import initDB from './initDB.js';
+import specialRoutes from './specialRoutes.js';
+import wsHandler from './wsHandler.js';
+import beforeRouteMiddleware from './beforeRouteMiddleware.js';
+import checkSession from './checkSession.js';
+import applicationMap from './applicationMap.js';
+
+export default {
+
+	configURL: new URL(import.meta.url),
+	siteURL: new URL("../sites/", import.meta.url),
+	commonPublicDir: new URL("../awesomeness-ui/core/public/", import.meta.url),
+
+	componentLocations: (awesomenessRequest) => {
+
+		const siteURL = new URL(`../sites/${awesomenessRequest.site}/`, import.meta.url);
+
+		return [
+
+			// first match wins (site first)
+			new URL('./components/', siteURL),
+
+			// last item is the default
+			new URL('../awesomeness-ui/components/', import.meta.url),
+		];
+
+	},
+
+	debug: true,
+	byPassAccessRequirementsInDev: true,
+
+	applicationMap,
+	beforeRouteMiddleware,
+	checkSession,
+	hostMap,
+	initDB, 
+	specialRoutes,
+	wsHandler, 
+};

package/example-.awesomeness/hostMap.js

@@ -0,0 +1,44 @@
+import * as fs from 'fs/promises';
+const sites = await fs.readdir('sites');
+
+export default function({
+	host, // already lower case - starts as req.headers.host (lower case)
+	mainDomain // already lower case 
+}){
+
+	const simpleMap = {
+		"localhost:3000": "example.awesomenessjs.com",
+	};
+
+	if (simpleMap[host]) { 
+
+		host = simpleMap[host]; 
+
+	} else {
+
+		if (simpleMap[mainDomain]) {
+		
+			host = simpleMap[mainDomain];
+
+		}
+
+	}
+
+	if (!sites.includes(host)) {
+
+		// try the root
+		if (sites.includes(mainDomain)) { 
+
+			host = mainDomain;
+
+		} else {
+
+			host = 'awesomenessjs.com';
+		
+		}
+
+	}
+
+	return host;
+
+}

package/example-.awesomeness/initDB.js

@@ -0,0 +1,65 @@
+import graph from '@awesomeness-js/graph-postgres';
+import setupApplication from './setupDB/applications.js';
+import setupUsers from './setupDB/users.js';
+import setupWebsites from './setupDB/websites.js';
+
+async function setup(){
+
+	let applications = await setupApplication();
+	let users = await setupUsers(applications);
+	let websites = await setupWebsites();
+
+}
+
+export default async ()=>{
+
+	
+	// is graph available?
+	try {
+
+		graph.config.init({
+			host: process.env.AWESOMENESS_GRAPH_POSTGRES_HOST,
+			port: process.env.AWESOMENESS_GRAPH_POSTGRES_PORT,
+			user: process.env.AWESOMENESS_GRAPH_POSTGRES_USER,
+			password: process.env.AWESOMENESS_GRAPH_POSTGRES_PASSWORD,
+			database: process.env.AWESOMENESS_GRAPH_POSTGRES_DB,
+			ssl: {
+				rejectUnauthorized: false
+			}
+		});
+
+		// await graph.utils.createDB();
+
+		await graph.kv.add('serverStarted', new Date().toISOString());
+
+		let testGet = await graph.kv.get('serverStarted');
+
+		if (testGet) {
+
+			console.log('Graph is available:');
+	
+			try {
+
+				await setup();
+
+			} catch (err) {
+
+				console.log('Setup failed:');
+
+			}
+
+
+		} else {
+
+			console.error('Graph is not available ... testGet');
+	
+		}
+
+	} catch (err) {
+
+		console.error('Graph is not available:');
+
+	}
+
+
+};

package/example-.awesomeness/setupDB/applications.js

@@ -0,0 +1,47 @@
+import app from '#app';
+import utils from '@awesomeness-js/utils';
+
+export default async function setup(){
+
+	let applications = {
+		'scottmforte.com': {}
+	};
+	
+	
+	await utils.eachAsync(applications, async ( d, site ) => {
+
+		let application;
+
+		try {
+		
+			application = await app.application.get({ name: site });
+			
+		} catch(e) {
+	
+			try {
+	
+				if(e.applicationDoesNotExist){
+
+					application = await app.application.create({ name: site });
+				
+				}
+	
+			} catch (e2){
+	
+				throw {
+					couldNotCreateApplication: e2
+				};
+	
+			}
+	
+		}
+
+		applications[site] = application;
+
+	});
+
+	console.log('✔️  Applications exist');
+
+	return applications;
+
+}

package/example-.awesomeness/setupDB/users.js

@@ -0,0 +1,65 @@
+import app from '#app';
+import utils from '@awesomeness-js/utils';
+
+export default async function(applications){
+
+	let me = {
+		first: 'Scott',
+		last: 'Forte',
+		email: 'scott@scottmforte.com',
+		password: 'Profile4-Unfitted4-Next3-Lesser2-Gains8-Seizing3-Wireless2-Thinning6-Disclose0-Provider9'
+	};
+
+	let usersPerApplication = {
+		'scottmforte.com': [ me ]
+	};
+
+	await utils.eachAsync(usersPerApplication, async ( users, site )=>{
+
+		await utils.eachAsync(users, async (user,k) => {
+
+			try {
+
+				user = await app.user.get({
+					email: user.email,
+					applicationId: applications[site].id
+				 });
+		
+				 users[k] = user;
+	
+			} catch(e) {
+		
+				try { 
+	
+					users[k] = await app.user.create({
+						...user,
+						applicationId: applications[site].id
+					});
+	
+				} catch(e){
+	
+					console.log('❌  User does not exist and could not be created', e);
+
+					throw {
+						couldNotCreateUser: {
+							application: k,
+							email: user.email,
+							error: e
+						}
+					};
+	
+				}
+	
+	
+			}
+
+		});
+
+	});
+
+
+	console.log('✔️  Users exist');
+
+	return usersPerApplication;
+
+}

package/example-.awesomeness/setupDB/websites.js

@@ -0,0 +1,49 @@
+import app from '#app';
+import utils from '@awesomeness-js/utils';
+
+export default async function setup(){
+
+	let websites = {
+		'scottmforte.com': {
+			id: '5aaa5f12-4223-4801-b6a3-c7e0630f99a2'
+		}
+	};
+	
+	
+	await utils.eachAsync(websites, async ( d, site ) => {
+
+		let website;
+
+		try {
+		
+			website = await app.website.get({ name: site });
+			
+		} catch(e) {
+	
+			try {
+	
+				website = await app.website.create({
+					name: site,
+					... d 
+				});
+				
+	
+			} catch (e2){
+	
+				throw {
+					couldNotCreateWebsite: e2
+				};
+	
+			}
+	
+		}
+
+		websites[site] = website;
+
+	});
+
+	console.log('✔️  websites exist');
+
+	return websites;
+
+}

package/example-.awesomeness/specialRoutes.js

@@ -0,0 +1,7 @@
+import example from '#sites/example.awesomenessjs.com/specialRoutes.js';
+
+const specialRoutes = {
+	'example.awesomenessjs.com': example
+};
+
+export default specialRoutes;

package/example-.awesomeness/wsHandler.js

@@ -0,0 +1,13 @@
+export default async ({
+	socket,
+	message,
+})=>{
+
+	socket.send(JSON.stringify({
+		type: message.type ?? "echo",
+		clientId: socket.clientId,
+		echo: message,
+		ts: Date.now()
+	}));
+
+};

package/index.js

@@ -0,0 +1,22 @@
+import checkAccess from "./server/checkAccess.js";
+import reRoute from "./server/reRoute.js";
+import { init, getConfig } from "./config.js";
+import start from "./start.js";
+
+export { 
+	init,
+	getConfig,
+	checkAccess,
+	reRoute,
+	start
+};
+
+const server = {
+	init,
+	getConfig,
+	checkAccess,
+	reRoute,
+	start
+};
+
+export default server;

package/package.json

@@ -0,0 +1,34 @@
+{
+	"name": "@awesomeness-js/server",
+	"version": "1.0.0",
+	"description": "Awesomeness Multi-Site Server",
+	"author": "Scott Forte",
+	"type": "module",
+	"main": "start.js",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/awesomeness-js/server.git"
+	},
+	"scripts": {
+		"test": "vitest"
+	},
+	"exports": {
+		".": {
+			"import": "./index.js"
+		}
+	},
+	"dependencies": {
+		"@awesomeness-js/utils": "latest",
+		"busboy": "^1.6.0",
+		"koa": "^3.0.1",
+		"koa-compress": "^5.1.1",
+		"koa-send": "^5.0.1",
+		"ws": "^8.18.3",
+		"zlib": "^1.0.5"
+	},
+	"license": "none",
+	"devDependencies": {
+		"eslint": "^9.23.0",
+		"vitest": "^3.0.9"
+	}
+}