@abs-test/absolutejs-test 0.1.0

package/README.md

@@ -0,0 +1,163 @@
+# AbsoluteJS
+
+Full‑stack, **type‑safe** batteries‑included platform that lets you **server‑side render _any_ modern front‑end**—React, Svelte, plain HTML, HTMX (Vue & Angular coming)—with a single Bun‑powered build step.
+
+[![bun-required](https://img.shields.io/badge/runtime-bun%401.x-yellowgreen?logo=bun)](https://bun.sh)
+[![elysia-required](https://img.shields.io/badge/server-elysia%40latest-blue?logo=elysia)](https://elysiajs.com)
+![license](https://img.shields.io/badge/license-BSL--1.1-lightgrey)
+
+---
+
+## Why Absolute JS?
+
+- **Universal SSR.** Bring your favourite UI layer; Absolute JS handles bundling, hydration, and HTML streaming.
+- **One build, one manifest.** Call `build()` once—get a manifest mapping every page’s client and server assets, ready to wire into routes.
+- **End‑to‑end type safety.** A unified source of truth for your types—from the database, through the server, and all the way to the client—so you can be certain of the data shape at every step.
+- **Zero‑config philosophy.** Point the build at your folders; sane defaults light up everything else.
+- **Plugin power.** Extend with standard Elysia plugins—ship auth, logging, i18n, and more. First‑party: `absolute-auth`, `networkingPlugin`.
+
+---
+
+## Requirements
+
+| Tool       | Version | Purpose                                     |
+| ---------- | ------- | ------------------------------------------- |
+| **Bun**    | ≥ 1.2   | Runtime, bundler, and TypeScript transpiler |
+| **Elysia** | latest  | Web server & middleware platform            |
+
+---
+
+## Installation
+
+```bash
+bun add @absolutejs/absolute
+```
+
+---
+
+## Quick Start
+
+```ts
+// example/server.ts
+import { staticPlugin } from '@elysiajs/static';
+import { Elysia } from 'elysia';
+import { file } from 'bun';
+import { build } from 'absolutejs/core/build';
+import {
+	handleHTMLPageRequest,
+	handleReactPageRequest,
+	handleSveltePageRequest
+} from 'absolutejs/core/pageHandlers';
+
+import { ReactExample } from './react/pages/ReactExample';
+import SvelteExample from './svelte/pages/SvelteExample.svelte';
+import { networkingPlugin } from 'absolutejs';
+
+const manifest = await build({
+	assetsDirectory: 'example/assets',
+	buildDirectory: 'example/build',
+	htmlDirectory: 'example/html',
+	htmxDirectory: 'example/htmx',
+	reactDirectory: 'example/react',
+	svelteDirectory: 'example/svelte',
+	options: { preserveIntermediateFiles: true }
+});
+
+if (!manifest) throw new Error('Manifest generation failed');
+
+let counter = 0;
+
+export const server = new Elysia()
+	.use(staticPlugin({ assets: './example/build', prefix: '' }))
+
+	// HTML
+	.get('/', () =>
+		handleHTMLPageRequest('./example/build/html/pages/HtmlExample.html')
+	)
+
+	// React
+	.get('/react', () =>
+		handleReactPageRequest(ReactExample, manifest['ReactExampleIndex'], {
+			test: 123
+		})
+	)
+
+	// Svelte
+	.get('/svelte', () =>
+		handleSveltePageRequest(SvelteExample, manifest, { test: 456 })
+	)
+
+	// HTMX demo
+	.get('/htmx', () => file('./example/build/htmx/HtmxHome.html'))
+	.get('/htmx/increment', () => new Response(String(++counter)))
+
+	.use(networkingPlugin)
+	.on('error', (error) => {
+		const { request } = error;
+		console.error(
+			`Server error on ${request.method} ${request.url}: ${error.message}`
+		);
+	});
+```
+
+### How it works
+
+1. **`build()`** scans your project, bundles each framework, and returns a **manifest** that has the server, and client assets required to serve each route.
+2. Route handlers (`handleReactPageRequest`, `handleSveltePageRequest`, …) stream HTML and inject scripts/assets based on that manifest.
+3. The static plugin serves all compiled files from `/build`.
+
+---
+
+## Plugin System
+
+Absolute JS piggybacks on the [Elysia plugin API](https://elysiajs.com/plugins). Any Elysia plugin works out of the box; Absolute adds helpers for:
+
+| Plugin                 | Description                                                                                       |
+| ---------------------- | ------------------------------------------------------------------------------------------------- |
+| **`absolute-auth`**    | Full OAuth2 flow configured with 66 providers and allows full customizability with event handlers |
+| **`networkingPlugin`** | Starts your Elysia server with HOST/PORT defaults from environment variables                      |
+
+---
+
+## Configuration Philosophy
+
+Everything funnels through a single `build()` call:
+
+```ts
+await build({
+	reactDirectory: 'src/react',
+	svelteDirectory: 'src/svelte',
+	htmlDirectory: 'src/html',
+	htmxDirectory: 'src/htmx',
+	assetsDirectory: 'public/assets',
+	options: { preserveIntermediateFiles: false }
+});
+```
+
+No separate config files or environment variables—just explicit arguments with sensible defaults.
+
+---
+
+## Roadmap
+
+- **Angular** handlers
+- Prisma support
+- Biome support
+- Hot‑reload development server
+- First‑class Docker images & hosting recipes
+
+---
+
+## Contributing
+
+Pull requests and issues are welcome! Whether it’s a new plugin, framework handler, or docs improvement:
+
+1. Fork & branch.
+2. `bun install && bun test`.
+3. Submit a PR with a clear description.
+
+---
+
+## License
+
+**Business Source License 1.1 (BSL-1.1)** – see [`LICENSE`](./LICENSE) for details.

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,61 @@
+# Third-Party Notices
+
+This product includes the following third-party software:
+
+---
+
+## Bun
+
+- **Source:** https://github.com/oven-sh/bun
+- **License:** MIT
+
+MIT License
+
+Copyright (c) 2024 Bun
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+## Elysia
+
+- **Source:** https://github.com/elysiajs/elysia
+- **License:** MIT
+
+MIT License
+
+Copyright (c) 2022 SaltyAom
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cli/index.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env bun
+// @bun
+
+// src/cli/index.ts
+var {$ } = globalThis.Bun;
+import { existsSync } from "fs";
+import { resolve } from "path";
+var COMPOSE_PATH = "db/docker-compose.db.yml";
+var DEFAULT_SERVER_ENTRY = "src/backend/server.ts";
+var readDbScripts = async () => {
+  const pkgPath = resolve("package.json");
+  if (!existsSync(pkgPath))
+    return null;
+  const pkg = await Bun.file(pkgPath).json();
+  const upCommand = pkg.scripts?.["db:up"];
+  const downCommand = pkg.scripts?.["db:down"];
+  if (!upCommand || !downCommand)
+    return null;
+  return { upCommand, downCommand };
+};
+var timed = async (label, fn) => {
+  process.stdout.write(label);
+  const start = performance.now();
+  await fn();
+  const duration = ((performance.now() - start) / 1000).toFixed(2);
+  process.stdout.write(` \x1B[90m${duration}s\x1B[0m
+`);
+};
+var startDatabase = async (scripts) => {
+  await timed("Starting database container...", async () => {
+    const { exitCode } = await $`${{ raw: scripts.upCommand }}`.quiet().nothrow();
+    if (exitCode !== 0)
+      process.exit(exitCode);
+  });
+};
+var stopDatabase = async (scripts) => {
+  console.log(`
+Stopping database container...`);
+  await $`${{ raw: scripts.downCommand }}`.quiet().nothrow();
+};
+var dev = async (serverEntry) => {
+  const usesDocker = existsSync(resolve(COMPOSE_PATH));
+  const scripts = usesDocker ? await readDbScripts() : null;
+  if (scripts)
+    await startDatabase(scripts);
+  const spawnServer = () => Bun.spawn(["bun", "--hot", "--no-clear-screen", serverEntry], {
+    cwd: process.cwd(),
+    env: {
+      ...process.env,
+      NODE_ENV: "development"
+    },
+    stdin: "inherit",
+    stdout: "inherit",
+    stderr: "inherit"
+  });
+  let serverProcess = spawnServer();
+  let cleaning = false;
+  const cleanup = async (exitCode = 0) => {
+    if (cleaning)
+      return;
+    cleaning = true;
+    try {
+      serverProcess.kill();
+    } catch {}
+    await serverProcess.exited;
+    if (scripts)
+      await stopDatabase(scripts);
+    process.exit(exitCode);
+  };
+  process.on("SIGINT", () => cleanup(0));
+  process.on("SIGTERM", () => cleanup(0));
+  const monitorServer = async () => {
+    while (!cleaning) {
+      const exitCode = await serverProcess.exited;
+      if (cleaning)
+        continue;
+      if (exitCode === 130 || exitCode === 143) {
+        await cleanup(0);
+        return;
+      }
+      console.error(`\x1B[31m[cli] Server exited (code ${exitCode}), restarting...\x1B[0m`);
+      serverProcess = spawnServer();
+    }
+  };
+  await monitorServer();
+};
+var command = process.argv[2];
+if (command === "dev") {
+  const serverEntry = process.argv[3] ?? DEFAULT_SERVER_ENTRY;
+  await dev(serverEntry);
+} else {
+  const message = command ? `Unknown command: ${command}` : "No command specified";
+  console.error(message);
+  console.error("Usage: absolutejs <command>");
+  console.error("Commands:");
+  console.error("  dev [entry]  Start development server");
+  process.exit(1);
+}

package/dist/dev/client/cssUtils.ts

@@ -0,0 +1,288 @@
+/* CSS reload/preload utilities for HMR */
+
+import type { CSSUpdateResult } from '../../../types/client';
+import { hmrState } from '../../../types/client';
+
+export const getCSSBaseName = (href: string) => {
+	const fileName = href.split('?')[0]!.split('/').pop() || '';
+	return fileName.split('.')[0]!;
+};
+
+export const reloadCSSStylesheets = (manifest: Record<string, string>) => {
+	const stylesheets = document.querySelectorAll('link[rel="stylesheet"]');
+	stylesheets.forEach(function (link) {
+		const href = (link as HTMLLinkElement).getAttribute('href');
+		if (!href || href.includes('htmx.min.js')) return;
+
+		let newHref: string | null = null;
+		if (manifest) {
+			const baseName = href
+				.split('/')
+				.pop()!
+				.replace(/\.[^.]*$/, '');
+			const manifestKey =
+				baseName
+					.split('-')
+					.map(function (part) {
+						return part.charAt(0).toUpperCase() + part.slice(1);
+					})
+					.join('') + 'CSS';
+
+			if (manifest[manifestKey]) {
+				newHref = manifest[manifestKey]!;
+			} else {
+				for (const [key, value] of Object.entries(manifest)) {
+					if (key.endsWith('CSS') && value.includes(baseName)) {
+						newHref = value;
+						break;
+					}
+				}
+			}
+		}
+
+		if (newHref && newHref !== href) {
+			(link as HTMLLinkElement).href = newHref + '?t=' + Date.now();
+		} else {
+			const url = new URL(href, window.location.origin);
+			url.searchParams.set('t', Date.now().toString());
+			(link as HTMLLinkElement).href = url.toString();
+		}
+	});
+};
+
+/* Shared CSS preload/swap logic used by HTML and HTMX handlers.
+   Returns tracking arrays for coordinating CSS load with body patching. */
+export const processCSSLinks = (headHTML: string) => {
+	const tempDiv = document.createElement('div');
+	tempDiv.innerHTML = headHTML;
+	const newStylesheets = tempDiv.querySelectorAll('link[rel="stylesheet"]');
+	const existingStylesheets = Array.from(
+		document.head.querySelectorAll<HTMLLinkElement>(
+			'link[rel="stylesheet"]'
+		)
+	);
+
+	const newHrefs = Array.from(newStylesheets).map(function (link) {
+		const href = link.getAttribute('href') || '';
+		return getCSSBaseName(href);
+	});
+
+	const linksToRemove: HTMLLinkElement[] = [];
+	const linksToWaitFor: Promise<void>[] = [];
+	const linksToActivate: HTMLLinkElement[] = [];
+
+	newStylesheets.forEach(function (newLink) {
+		const href = newLink.getAttribute('href');
+		if (!href) return;
+
+		const baseNew = getCSSBaseName(href);
+
+		let existingLink: HTMLLinkElement | null = null;
+		document.head
+			.querySelectorAll('link[rel="stylesheet"]')
+			.forEach(function (existing) {
+				const existingHref =
+					(existing as HTMLLinkElement).getAttribute('href') || '';
+				const baseExisting = getCSSBaseName(existingHref);
+				if (
+					baseExisting === baseNew ||
+					baseExisting.includes(baseNew) ||
+					baseNew.includes(baseExisting)
+				) {
+					existingLink = existing as HTMLLinkElement;
+				}
+			});
+
+		if (existingLink) {
+			const existingHrefAttr = (
+				existingLink as HTMLLinkElement
+			).getAttribute('href');
+			const existingHref = existingHrefAttr
+				? existingHrefAttr.split('?')[0]
+				: '';
+			const newHrefBase = href.split('?')[0];
+			if (existingHref !== newHrefBase) {
+				const newLinkElement = document.createElement('link');
+				newLinkElement.rel = 'stylesheet';
+				newLinkElement.media = 'print';
+				const newHref =
+					href + (href.includes('?') ? '&' : '?') + 't=' + Date.now();
+				newLinkElement.href = newHref;
+
+				linksToRemove.push(existingLink as HTMLLinkElement);
+				linksToActivate.push(newLinkElement);
+
+				const loadPromise = createCSSLoadPromise(
+					newLinkElement,
+					newHref
+				);
+				document.head.appendChild(newLinkElement);
+				linksToWaitFor.push(loadPromise);
+			}
+		} else {
+			const newLinkElement = document.createElement('link');
+			newLinkElement.rel = 'stylesheet';
+			newLinkElement.media = 'print';
+			const newHref =
+				href + (href.includes('?') ? '&' : '?') + 't=' + Date.now();
+			newLinkElement.href = newHref;
+
+			linksToActivate.push(newLinkElement);
+
+			const loadPromise = createCSSLoadPromise(newLinkElement, newHref);
+			document.head.appendChild(newLinkElement);
+			linksToWaitFor.push(loadPromise);
+		}
+	});
+
+	existingStylesheets.forEach(function (existingLink) {
+		const existingHref = existingLink.getAttribute('href') || '';
+		const baseExisting = getCSSBaseName(existingHref);
+		const stillExists = newHrefs.some(function (newBase) {
+			return (
+				baseExisting === newBase ||
+				baseExisting.includes(newBase) ||
+				newBase.includes(baseExisting)
+			);
+		});
+
+		if (!stillExists) {
+			const wasHandled = Array.from(newStylesheets).some(
+				function (newLink) {
+					const newHref = newLink.getAttribute('href') || '';
+					const baseNewLocal = getCSSBaseName(newHref);
+					return (
+						baseExisting === baseNewLocal ||
+						baseExisting.includes(baseNewLocal) ||
+						baseNewLocal.includes(baseExisting)
+					);
+				}
+			);
+
+			if (!wasHandled) {
+				linksToRemove.push(existingLink);
+			}
+		}
+	});
+
+	return { linksToActivate, linksToRemove, linksToWaitFor };
+};
+
+const createCSSLoadPromise = (
+	linkElement: HTMLLinkElement,
+	newHref: string
+) => {
+	return new Promise<void>(function (resolve) {
+		let resolved = false;
+		const doResolve = function () {
+			if (resolved) return;
+			resolved = true;
+			resolve();
+		};
+
+		const verifyCSSOM = function () {
+			try {
+				const sheets = Array.from(document.styleSheets);
+				return sheets.some(function (sheet) {
+					return (
+						sheet.href &&
+						sheet.href.includes(newHref.split('?')[0]!)
+					);
+				});
+			} catch {
+				return false;
+			}
+		};
+
+		linkElement.onload = function () {
+			let checkCount = 0;
+			const checkCSSOM = function () {
+				checkCount++;
+				if (verifyCSSOM() || checkCount > 10) {
+					doResolve();
+				} else {
+					requestAnimationFrame(checkCSSOM);
+				}
+			};
+			requestAnimationFrame(checkCSSOM);
+		};
+
+		linkElement.onerror = function () {
+			setTimeout(function () {
+				doResolve();
+			}, 50);
+		};
+
+		setTimeout(function () {
+			if (linkElement.sheet && !resolved) {
+				doResolve();
+			}
+		}, 100);
+
+		setTimeout(function () {
+			if (!resolved) {
+				doResolve();
+			}
+		}, 500);
+	});
+};
+
+/* Coordinate CSS load with body update: waits for CSS, patches body,
+   activates new CSS, removes old CSS. Handles first-update delay. */
+export const waitForCSSAndUpdate = (
+	cssResult: CSSUpdateResult,
+	updateBody: () => void
+) => {
+	const { linksToActivate, linksToRemove, linksToWaitFor } = cssResult;
+
+	if (linksToWaitFor.length > 0) {
+		Promise.all(linksToWaitFor).then(function () {
+			setTimeout(function () {
+				requestAnimationFrame(function () {
+					requestAnimationFrame(function () {
+						requestAnimationFrame(function () {
+							updateBody();
+							linksToActivate.forEach(function (link) {
+								link.media = 'all';
+							});
+							requestAnimationFrame(function () {
+								linksToRemove.forEach(function (link) {
+									if (link.parentNode) {
+										link.remove();
+									}
+								});
+								if (hmrState.isFirstHMRUpdate) {
+									hmrState.isFirstHMRUpdate = false;
+								}
+							});
+						});
+					});
+				});
+			}, 50);
+		});
+	} else {
+		const doUpdate = function () {
+			requestAnimationFrame(function () {
+				requestAnimationFrame(function () {
+					requestAnimationFrame(function () {
+						updateBody();
+						requestAnimationFrame(function () {
+							linksToRemove.forEach(function (link) {
+								if (link.parentNode) {
+									link.remove();
+								}
+							});
+						});
+					});
+				});
+			});
+		};
+
+		if (hmrState.isFirstHMRUpdate) {
+			hmrState.isFirstHMRUpdate = false;
+			setTimeout(doUpdate, 50);
+		} else {
+			doUpdate();
+		}
+	}
+};