@jk2908/solas 0.1.0

package/dist/utils/logger.d.ts

@@ -0,0 +1,52 @@
+declare const LEVELS: {
+    readonly debug: 0;
+    readonly info: 1;
+    readonly warn: 2;
+    readonly error: 3;
+    readonly fatal: 4;
+};
+export type LogLevel = keyof typeof LEVELS;
+/**
+ * Log messages with different severity levels
+ */
+export declare class Logger {
+    #private;
+    constructor(level?: LogLevel);
+    static set defaultLevel(level: LogLevel);
+    static get defaultLevel(): "debug" | "error" | "fatal" | "info" | "warn";
+    /**
+     * Convert a value to an Error instance
+     */
+    static toError(err: unknown): Error;
+    /**
+     * Stringify the error for logging
+     */
+    static print(err: unknown): string;
+    set level(level: LogLevel);
+    get level(): "debug" | "error" | "fatal" | "info" | "warn";
+    /**
+     * Log a message with a specific level
+     */
+    log(level: LogLevel, message: string, error?: Error): void;
+    /**
+     * Log a debug message
+     */
+    debug(...messages: string[]): void;
+    /**
+     * Log an info message
+     */
+    info(...messages: string[]): void;
+    /**
+     * Log a warning message
+     */
+    warn(...messages: string[]): void;
+    /**
+     * Log an error message
+     */
+    error(message: string, error?: unknown): void;
+    /**
+     * Log a fatal error message
+     */
+    fatal(message: string, error?: unknown): void;
+}
+export {};

package/dist/utils/logger.js

@@ -0,0 +1,105 @@
+import { Solas } from '../solas';
+import { HttpException } from '../internal/navigation/http-exception';
+const LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    fatal: 4,
+};
+/**
+ * Log messages with different severity levels
+ */
+export class Logger {
+    static #defaultLevel = 'info';
+    #level;
+    constructor(level) {
+        this.#level = level;
+    }
+    static set defaultLevel(level) {
+        Logger.#defaultLevel = level;
+    }
+    static get defaultLevel() {
+        return Logger.#defaultLevel;
+    }
+    /**
+     * Convert a value to an Error instance
+     */
+    static toError(err) {
+        return err instanceof Error ? err : new Error(String(err), { cause: err });
+    }
+    /**
+     * Stringify the error for logging
+     */
+    static print(err) {
+        if (err instanceof Error || err instanceof HttpException) {
+            return err.message + (err.stack ? `\n${err.stack}` : '');
+        }
+        if (typeof err === 'object' && err !== null) {
+            return JSON.stringify(err, null, 2);
+        }
+        return String(err);
+    }
+    set level(level) {
+        this.#level = level;
+    }
+    get level() {
+        return this.#level ?? Logger.#defaultLevel;
+    }
+    /**
+     * Log a message with a specific level
+     */
+    log(level, message, error) {
+        if (LEVELS[level] < LEVELS[this.level])
+            return;
+        const entry = {
+            ts: Date.now(),
+            level,
+            message,
+        };
+        if (level === 'error' || level === 'fatal') {
+            entry.error = error ? Logger.toError(error) : new Error(message);
+        }
+        const line = `[${Solas.Config.NAME}] [${entry.ts}] [${level.toUpperCase()}] ${message}`;
+        const extra = entry.error ? `\n${Logger.print(entry.error)}` : '';
+        if (level === 'warn') {
+            console.warn(line, extra);
+            return;
+        }
+        if (level === 'error' || level === 'fatal') {
+            console.error(line, extra);
+            return;
+        }
+        console.log(line, extra);
+    }
+    /**
+     * Log a debug message
+     */
+    debug(...messages) {
+        this.log('debug', messages.join(' '));
+    }
+    /**
+     * Log an info message
+     */
+    info(...messages) {
+        this.log('info', messages.join(' '));
+    }
+    /**
+     * Log a warning message
+     */
+    warn(...messages) {
+        this.log('warn', messages.join(' '));
+    }
+    /**
+     * Log an error message
+     */
+    error(message, error) {
+        this.log('error', message, error === undefined ? undefined : Logger.toError(error));
+    }
+    /**
+     * Log a fatal error message
+     */
+    fatal(message, error) {
+        this.log('fatal', message, error === undefined ? undefined : Logger.toError(error));
+    }
+}

package/dist/utils/time.d.ts

@@ -0,0 +1,4 @@
+export declare namespace Time {
+    function debounce<T extends unknown[]>(fn: (...args: T) => void, wait: number): (...args: T) => void;
+    function timeout<T>(task: Promise<T>, timeoutMs: number, label: string): Promise<Awaited<T>>;
+}

package/dist/utils/time.js

@@ -0,0 +1,29 @@
+export { Time };
+var Time;
+(function (Time) {
+    function debounce(fn, wait) {
+        let timeoutId = null;
+        return (...args) => {
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+            }
+            timeoutId = setTimeout(() => {
+                fn.apply(null, args);
+            }, wait);
+        };
+    }
+    Time.debounce = debounce;
+    function timeout(task, timeoutMs, label) {
+        let timer;
+        const timeout = new Promise((_, reject) => {
+            timer = setTimeout(() => {
+                reject(new Error(`Timed out after ${timeoutMs}ms (${label})`));
+            }, timeoutMs);
+        });
+        return Promise.race([task, timeout]).finally(() => {
+            if (timer)
+                clearTimeout(timer);
+        });
+    }
+    Time.timeout = timeout;
+})(Time || (Time = {}));

package/package.json

@@ -0,0 +1,111 @@
+{
+	"name": "@jk2908/solas",
+	"version": "0.1.0",
+	"description": "A React Server Components meta-framework powered by Vite",
+	"keywords": [
+		"framework",
+		"ppr",
+		"react",
+		"rsc",
+		"ssr",
+		"vite"
+	],
+	"homepage": "https://github.com/jk2908/solas/tree/main/packages/solas#readme",
+	"bugs": {
+		"url": "https://github.com/jk2908/solas/issues"
+	},
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/jk2908/solas.git"
+	},
+	"bin": {
+		"solas": "./dist/cli.js"
+	},
+	"files": [
+		"dist"
+	],
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./env/rsc": {
+			"types": "./dist/internal/env/rsc.d.ts",
+			"import": "./dist/internal/env/rsc.js"
+		},
+		"./env/ssr": {
+			"types": "./dist/internal/env/ssr.d.ts",
+			"import": "./dist/internal/env/ssr.js"
+		},
+		"./env/browser": {
+			"types": "./dist/internal/env/browser.d.ts",
+			"import": "./dist/internal/env/browser.js"
+		},
+		"./router": {
+			"types": "./dist/router.d.ts",
+			"import": "./dist/router.js"
+		},
+		"./navigation": {
+			"types": "./dist/navigation.d.ts",
+			"import": "./dist/navigation.js"
+		},
+		"./prerender": {
+			"types": "./dist/prerender.d.ts",
+			"import": "./dist/prerender.js"
+		},
+		"./server": {
+			"types": "./dist/server.d.ts",
+			"import": "./dist/server.js"
+		},
+		"./error-boundary": {
+			"types": "./dist/error-boundary.d.ts",
+			"import": "./dist/error-boundary.js"
+		},
+		"./solas": {
+			"types": "./dist/solas.d.ts",
+			"import": "./dist/solas.js"
+		}
+	},
+	"scripts": {
+		"build": "rm -rf dist && tsgo && chmod +x dist/cli.js",
+		"lint": "bunx oxlint .",
+		"lint:fix": "bunx oxlint --fix .",
+		"format": "bunx oxfmt --write .",
+		"format:check": "bunx oxfmt --check .",
+		"pack:dry": "npm pack --dry-run",
+		"release:check": "npm run prepublishOnly",
+		"prepublishOnly": "npm run build && npm run pack:dry"
+	},
+	"dependencies": {
+		"@vitejs/plugin-rsc": "^0.5.20",
+		"path-to-regexp": "^8.3.0",
+		"rsc-html-stream": "^0.0.7"
+	},
+	"devDependencies": {
+		"@prettier/plugin-oxc": "^0.1.3",
+		"@types/bun": "^1.2.22",
+		"@typescript/native-preview": "^7.0.0-dev.20260224.1",
+		"network-information-types": "^0.1.1",
+		"typescript": "^5.9.3"
+	},
+	"peerDependencies": {
+		"@types/react": "^19.2.14",
+		"@types/react-dom": "^19.2.3",
+		"react": "^19.2.4",
+		"react-dom": "^19.2.4",
+		"react-server-dom-webpack": "^19.2.4",
+		"vite": "^7.3.1 || ^8.0.0"
+	},
+	"peerDependenciesMeta": {
+		"react-server-dom-webpack": {
+			"optional": true
+		}
+	},
+	"engines": {
+		"bun": ">=1.2.0"
+	}
+}