@fc3/mmcadi 0.1.0

package/bin/compile

@@ -0,0 +1,63 @@
+#!/usr/bin/env bash
+
+if [[ $1 == '--help' ]]; then
+	echo "Triggers recompilation of the source code for the current project."
+	echo "Supported flags:"
+	echo "--force : Bypasses any precompilation checks (cache, mutex, etc)"
+	echo "          Use this if you want to recompile no matter what."
+	echo " "
+	exit 0
+fi
+
+if [[ $1 != '--force' ]]; then
+	./bin/precompile
+
+	case $? in
+		1)
+			exit 1
+			;;
+		3)
+			exit 0
+			;;
+	esac
+fi
+
+echo "Recompiling..."
+mkdir -p dist
+echo $$ > dist/.compile-lock
+rm -f dist/.last-compile-time
+
+project_dir="$(dirname $(dirname "$0"))"
+
+if [[ $1 == '--force' ]]; then
+	rm -rf dist/src
+	rm -rf dist/test
+	./node_modules/.bin/tsc --declaration --project "$project_dir/config/tsconfig.json"
+else
+	./node_modules/.bin/tsc --declaration --incremental --project "$project_dir/config/tsconfig.json"
+fi
+
+exit_status=$?
+
+if [[ $exit_status -eq 0 ]]; then
+	./bin/remap-paths
+	./bin/copy-static-files
+	echo $(date +%s) > dist/.last-compile-time
+
+	./node_modules/.bin/esbuild "$project_dir/src/client/bootstrap.ts" \
+		--bundle \
+		--tsconfig="$project_dir/config/tsconfig.json" \
+		--outfile="$project_dir/dist/client.js" \
+		--alias:lib/logger/logger=client/shim/logger.ts \
+		--alias:lib/process/execute=client/shim/execute.ts
+fi
+
+pid=$(cat dist/.compile-lock)
+
+if [[ $pid == $$ ]]; then
+	rm dist/.compile-lock
+	exit $exit_status
+else
+	echo "Detected a conflicting compile lock..."
+	exit 1
+fi

package/bin/copy-static-files

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+
+set -e
+
+echo "Copying static files to dist..."
+
+find "src" -type f ! -name '*.ts' | while read -r file; do
+	# Ignore vim swapfiles too:
+	if [[ ! "$file" == *"swp"* ]]; then
+		echo "$file --> dist/$file"
+		cp "$file" "dist/$file"
+	fi
+done

package/bin/install

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+
+set -e
+
+./bin/compile

package/bin/precompile

@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+
+mkdir -p dist
+
+if [ -f dist/.compile-lock ]; then
+	pid=$(cat dist/.compile-lock)
+	ticks=0
+	max_ticks=10
+
+	if ! ps -p $pid > /dev/null; then
+		echo "Detected a stale compile lock; deleting..."
+		rm -f dist/.compile-lock
+	else
+		echo "Compilation already in progress; waiting up to $max_ticks seconds..."
+	fi
+
+	while [ -f dist/.compile-lock ]; do
+		sleep 1
+		let ticks=ticks+1
+
+		if [ $ticks -ge $max_ticks ]; then
+			echo "Timed out waiting for compilation to clear"
+			exit 1
+		fi
+	done
+fi
+
+if [[ -f ./dist/.last-publish-time ]]; then
+	echo "Found publication compile artifact; skipping recompilation."
+	exit 3
+fi
+
+if [ -f dist/.last-compile-time ]; then
+	if [ ! -d src ]; then
+		# TODO: Confirm we're within a deploy environment
+		echo "src folder does not exist; skipping recompilation."
+		exit 3
+	fi
+
+	typeset -i last_modification_time=$(find src test -type f -print0 |
+		xargs -0 stat -c "%X %N" |
+		sort -rn |
+		head -1 |
+		awk '{ print $1 }')
+
+	typeset -i last_compile_time=$(cat dist/.last-compile-time)
+
+	if (( $last_compile_time > $last_modification_time )); then
+		echo "No changes since last compile; skipping recompilation."
+		exit 3
+	fi
+fi
+
+# Compilation should occur.
+exit 0

package/bin/prepublish

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+
+set -e
+
+./bin/compile
+
+date +%s > ./dist/.last-publish-time

package/bin/remap-paths

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+
+const FS = require('fs');
+const Path = require('path');
+
+const JAVASCRIPT_EXTENSION = '.js';
+const DECLARATION_EXTENSION = '.d.ts';
+const UTF8_ENCODING = 'utf8';
+const DIST_PATH = Path.resolve(__dirname, '../dist');
+
+function processDirectory(directoryPath) {
+	const children = FS.readdirSync(directoryPath);
+
+	children.forEach(function each(child) {
+		// Ignore hidden files.
+		if (child[0] === '.') {
+			return;
+		}
+
+		const
+			childPath  = Path.resolve(directoryPath, child),
+			parsedPath = Path.parse(childPath);
+
+		if (!parsedPath.ext) {
+			processDirectory(childPath);
+		} else if (parsedPath.ext === JAVASCRIPT_EXTENSION) {
+			processSourceFile(childPath);
+		} else if (childPath.slice(-5) === DECLARATION_EXTENSION) {
+			processDeclarationFile(childPath);
+		}
+	});
+}
+
+function processSourceFile(filePath) {
+	const contents = FS.readFileSync(filePath, UTF8_ENCODING);
+
+	const lines = contents.split('\n').map(function map(line) {
+		return line.replace(/require\("([^"]+)/g, function replacer(match, path) {
+			if (path[0] === '.') {
+				return match;
+			}
+
+			let dependencyPath = DIST_PATH + '/src/' + path + '.js';
+
+			if (!FS.existsSync(dependencyPath)) {
+				// Fall back to checking whether there's an index.js in a directory
+				// of this name, instead of a toplevel .js source file directly.
+				dependencyPath = DIST_PATH + '/src/' + path + '/index.js';
+
+				if (!FS.existsSync(dependencyPath)) {
+					// Well, we tried.
+					return match;
+				}
+			}
+
+			const parsedFile = Path.parse(filePath);
+			const parsedDependency = Path.parse(dependencyPath);
+
+			let relativeDirectory = Path.relative(parsedFile.dir, parsedDependency.dir);
+
+			if (relativeDirectory === '') {
+				relativeDirectory = '.';
+			} else {
+				relativeDirectory = './' + relativeDirectory;
+			}
+
+			const relativePath = relativeDirectory + '/' + parsedDependency.base;
+
+			return 'require("' + relativePath;
+		});
+	});
+
+	FS.writeFileSync(filePath, lines.join('\n'), UTF8_ENCODING);
+}
+
+function processDeclarationFile(filePath) {
+	const contents = FS.readFileSync(filePath, UTF8_ENCODING);
+
+	const lines = contents.split('\n').map(function map(line) {
+		return line.replace(/from '([^']+)/g, function replacer(match, path) {
+			if (path[0] === '.') {
+				return match;
+			}
+
+			const dependencyPath = DIST_PATH + '/src/' + path + '.d.ts';
+
+			if (!FS.existsSync(dependencyPath)) {
+				return match;
+			}
+
+			const parsedFile = Path.parse(filePath);
+			const parsedDependency = Path.parse(dependencyPath);
+
+			let relativeDirectory = Path.relative(parsedFile.dir, parsedDependency.dir);
+
+			if (relativeDirectory === '') {
+				relativeDirectory = '.';
+			} else {
+				relativeDirectory = './' + relativeDirectory;
+			}
+
+			let relativePath = relativeDirectory + '/' + parsedDependency.base;
+
+			relativePath = relativePath.replace(DECLARATION_EXTENSION, '');
+
+			return "from '" + relativePath;
+		});
+	});
+
+	FS.writeFileSync(filePath, lines.join('\n'), UTF8_ENCODING);
+}
+
+processDirectory('./dist', 0);

package/bin/test

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+
+set -e
+
+bin/compile
+
+# It's important that the glob be quoted so that the Node engine
+# can evaluate it rather than it being done by the shell.
+NODE_ENV=test node --test "dist/test/**/*.js"

package/config/tsconfig.json

@@ -0,0 +1,37 @@
+{
+	"compilerOptions": {
+		"strict": true,
+		"noImplicitReturns": true,
+		"noImplicitAny": true,
+		"strictNullChecks": true,
+		"noUnusedLocals": true,
+		"strictPropertyInitialization": true,
+		"forceConsistentCasingInFileNames": true,
+		"baseUrl": "../src",
+		"target": "es2020",
+		"module": "commonjs",
+		"outDir": "../dist",
+		"sourceMap": true,
+		"esModuleInterop": true,
+		"jsx": "react",
+		"lib": [
+			"esnext",
+			"dom"
+		],
+		"typeRoots": [
+			"../node_modules/@types"
+		]
+	},
+	"include": [
+		"../src/**/*.ts",
+		"../src/**/*.tsx",
+		"../test/unit/**/*.ts",
+		"../test/unit/**/*.tsx",
+		"../test/integration/**/*.ts",
+		"../test/integration/**/*.tsx"
+	],
+	"exclude": [
+		"../node_modules",
+		"../**/dist/**/*"
+	]
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+	"name": "@fc3/mmcadi",
+	"description": "multimedia calendar + diary",
+	"version": "0.1.0",
+	"author": "fc3",
+	"private": false,
+	"homepage": "https://0xfc3/software/mmcadi",
+	"repository": "https://git.sr.ht/~fc3/mmcadi",
+	"license": "GPL-3.0-or-later",
+	"dependencies": {
+		"formidable": "^3.5.2",
+		"marked": "^16.3.0",
+		"node-statsd": "0.1.1",
+		"ws": "^8.18.0"
+	},
+	"devDependencies": {
+		"@types/formidable": "^3.4.5",
+		"@types/node": "22.13.10",
+		"@types/node-statsd": "0.1.6",
+		"@types/ws": "^8.18.0",
+		"esbuild": "^0.25.10",
+		"typescript": "5.7.2"
+	},
+	"engines": {
+		"npm": ">= 10.2.0",
+		"node": ">= v20.0.0"
+	},
+	"scripts": {
+		"install": "./bin/install",
+		"test": "./bin/test",
+		"prepublishOnly": "./bin/prepublish"
+	}
+}

package/src/bootstrap/start.ts

@@ -0,0 +1,12 @@
+import Server from 'server';
+import ServerSettings from 'type/server-settings';
+
+async function start(settings: ServerSettings): Promise<Server> {
+	const server = new Server(settings);
+
+	await server.start();
+
+	return server;
+}
+
+export default start;

package/src/client/bootstrap.ts

@@ -0,0 +1,5 @@
+import Client from 'client/client';
+
+const client = new Client();
+
+client.start();

package/src/client/client.ts

@@ -0,0 +1,54 @@
+import {InvariantViolation} from 'lib/errors';
+
+import PageFactory from 'client/factory/page';
+import Page from 'client/page';
+import getMetaValue from 'client/utility/get-meta-value';
+import PageType from 'client/enum/page-type';
+
+class Client {
+	public start(): void {
+		try {
+			const page = this.buildPage();
+
+			page.start();
+		} catch (error) {
+			if (!(error instanceof Error)) {
+				throw error;
+			}
+
+			document.body.innerHTML = `
+				<main>
+					<section class="red">
+						<strong>ERROR:</strong>
+						${error.message}
+						<pre>${error.stack}</pre>
+					</section>
+				</main>
+			`;
+		}
+	}
+
+	private buildPage(): Page {
+		const page_type = this.determinePageType();
+		const factory = new PageFactory(page_type);
+		const page = factory.create();
+
+		return page;
+	}
+
+	private determinePageType(): PageType {
+		const meta_value = getMetaValue('page_type');
+		const page_type = meta_value as PageType;
+		const page_types = Object.values(PageType);
+
+		if (!page_types.includes(page_type)) {
+			throw new InvariantViolation(`
+				Invalid page type: ${page_type}
+			`);
+		}
+
+		return page_type;
+	}
+}
+
+export default Client;

package/src/client/enum/key-code.ts

@@ -0,0 +1,34 @@
+enum KeyCode {
+	ENTER = 13,
+	SHIFT = 16,
+	ESCAPE = 27,
+	ONE = 49,
+	A = 65,
+	B = 66,
+	C = 67,
+	D = 68,
+	E = 69,
+	F = 70,
+	G = 71,
+	H = 72,
+	I = 73,
+	J = 74,
+	K = 75,
+	L = 76,
+	M = 77,
+	N = 78,
+	O = 79,
+	P = 80,
+	Q = 81,
+	R = 82,
+	S = 83,
+	T = 84,
+	U = 85,
+	V = 86,
+	W = 87,
+	X = 88,
+	Y = 89,
+	Z = 90
+}
+
+export default KeyCode;

package/src/client/enum/page-type.ts

@@ -0,0 +1,19 @@
+enum PageType {
+	HOME = 'home',
+	LOGIN = 'login',
+	LOGOUT = 'logout',
+	DAY = 'day',
+	WEEK = 'week',
+	MONTH = 'month',
+	YEAR = 'year',
+	SELECT_BLOCK_TYPE = 'select_block_type',
+	CREATE_BLOCK = 'create_block',
+	EDIT_BLOCK = 'edit_block',
+	VIEW_CUSTOM = 'view_custom',
+	EDIT_CUSTOM = 'edit_custom',
+	CONFIRM_DELETE_BLOCK = 'confirm_delete_block',
+	MOVE_BLOCK = 'move_block',
+	SETTINGS = 'settings'
+}
+
+export default PageType;

package/src/client/factory/page.ts

@@ -0,0 +1,61 @@
+import Page from 'client/page';
+import PageType from 'client/enum/page-type';
+
+import HomePage from 'client/page/home';
+import LoginPage from 'client/page/login';
+import LogoutPage from 'client/page/logout';
+import DayPage from 'client/page/day';
+import MonthPage from 'client/page/month';
+import WeekPage from 'client/page/week';
+import YearPage from 'client/page/year';
+import SelectBlockTypePage from 'client/page/select-block-type';
+import CreateBlockPage from 'client/page/create-block';
+import EditBlockPage from 'client/page/edit-block';
+import ViewCustomPage from 'client/page/view-custom';
+import EditCustomPage from 'client/page/edit-custom';
+import ConfirmDeleteBlockPage from 'client/page/confirm-delete-block';
+import MoveBlockPage from 'client/page/move-block';
+import SettingsPage from 'client/page/settings';
+
+interface PageConstructor {
+	new(): Page;
+}
+
+const PageConstructors: Record<PageType, PageConstructor> = {
+	[PageType.HOME]: HomePage,
+	[PageType.LOGIN]: LoginPage,
+	[PageType.LOGOUT]: LogoutPage,
+	[PageType.DAY]: DayPage,
+	[PageType.WEEK]: WeekPage,
+	[PageType.MONTH]: MonthPage,
+	[PageType.YEAR]: YearPage,
+	[PageType.SELECT_BLOCK_TYPE]: SelectBlockTypePage,
+	[PageType.CREATE_BLOCK]: CreateBlockPage,
+	[PageType.EDIT_BLOCK]: EditBlockPage,
+	[PageType.VIEW_CUSTOM]: ViewCustomPage,
+	[PageType.EDIT_CUSTOM]: EditCustomPage,
+	[PageType.CONFIRM_DELETE_BLOCK]: ConfirmDeleteBlockPage,
+	[PageType.MOVE_BLOCK]: MoveBlockPage,
+	[PageType.SETTINGS]: SettingsPage
+};
+
+class PageFactory {
+	private page_type: PageType;
+
+	public constructor(page_type: PageType) {
+		this.page_type = page_type;
+	}
+
+	public create(): Page {
+		const page_type = this.getPageType();
+		const page_constructor = PageConstructors[page_type];
+
+		return new page_constructor;
+	}
+
+	private getPageType(): PageType {
+		return this.page_type;
+	}
+}
+
+export default PageFactory;

package/src/client/page/confirm-delete-block.ts

@@ -0,0 +1,30 @@
+import {InvariantViolation} from 'lib/errors';
+
+import Page from 'client/page';
+import KeyCode from 'client/enum/key-code';
+
+class ConfirmDeleteBlockPage extends Page {
+	protected handleKey(key_code: KeyCode): void {
+		switch (key_code) {
+			case KeyCode.D:
+				return this.submitDeletionForm();
+
+			default:
+				return super.handleKey(key_code);
+		}
+	}
+
+	private submitDeletionForm(): void {
+		const element = document.getElementById('deletion-form');
+
+		if (element === null) {
+			throw new InvariantViolation('Could not find deletion form element');
+		}
+
+		const form = element as HTMLFormElement;
+
+		form.submit();
+	}
+}
+
+export default ConfirmDeleteBlockPage;

package/src/client/page/create-block.ts

@@ -0,0 +1,6 @@
+import Page from 'client/page';
+
+class CreateBlockPage extends Page {
+}
+
+export default CreateBlockPage;

package/src/client/page/day.ts

@@ -0,0 +1,8 @@
+import Page from 'client/page';
+
+class DayPage extends Page {
+	protected initEvents(): void {
+	}
+}
+
+export default DayPage;

package/src/client/page/edit-block.ts

@@ -0,0 +1,43 @@
+import {InvariantViolation} from 'lib/errors';
+
+import KeyCode from 'client/enum/key-code';
+import Page from 'client/page';
+
+class EditBlockPage extends Page {
+	protected initEvents(): void {
+		super.initEvents();
+
+		const textarea_nodes = document.getElementsByTagName('textarea');
+		const textareas = Array.from(textarea_nodes);
+
+		textareas.forEach((textarea) => {
+			let form: HTMLFormElement | undefined;
+			let current_node: ParentNode | null = textarea;
+
+			while (current_node) {
+				current_node = current_node.parentNode;
+
+				if (current_node instanceof HTMLFormElement) {
+					form = current_node;
+					break;
+				}
+			}
+
+			if (form === undefined) {
+				throw new InvariantViolation(`
+					Tried to read form for textarea, but it was not set
+				`);
+			}
+
+			textarea.addEventListener('keydown', (event: KeyboardEvent) => {
+				const key_code = event.keyCode || event.charCode;
+
+				if (key_code === KeyCode.ENTER && event.shiftKey) {
+					event.preventDefault();
+				}
+			});
+		});
+	}
+}
+
+export default EditBlockPage;

package/src/client/page/edit-custom.ts

@@ -0,0 +1,16 @@
+import KeyCode from 'client/enum/key-code';
+import ViewCustomPage from 'client/page/view-custom';
+
+class EditCustomPage extends ViewCustomPage {
+	protected handleKey(key_code: KeyCode): void {
+		switch (key_code) {
+			case KeyCode.U:
+				return this.toggleEditMode();
+
+			default:
+				return super.handleKey(key_code);
+		}
+	}
+}
+
+export default EditCustomPage;

package/src/client/page/home.ts

@@ -0,0 +1,8 @@
+import Page from 'client/page';
+
+class HomePage extends Page {
+	protected initEvents(): void {
+	}
+}
+
+export default HomePage;

package/src/client/page/login.ts

@@ -0,0 +1,8 @@
+import Page from 'client/page';
+
+class LoginPage extends Page {
+	protected initEvents(): void {
+	}
+}
+
+export default LoginPage;

package/src/client/page/logout.ts

@@ -0,0 +1,8 @@
+import Page from 'client/page';
+
+class LogoutPage extends Page {
+	protected initEvents(): void {
+	}
+}
+
+export default LogoutPage;

package/src/client/page/month.ts

@@ -0,0 +1,8 @@
+import Page from 'client/page';
+
+class MonthPage extends Page {
+	protected initEvents(): void {
+	}
+}
+
+export default MonthPage;