h3ravel-monorepo 0.1.1

package/packages/router/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@h3ravel/router",
+  "version": "0.1.1",
+  "description": "Route facade, decorators and controller system for H3ravel.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "barrel": "barrelsby --directory src --delete --singleQuotes",
+    "build": "tsup",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "lint": "eslint . --ext .ts",
+    "test": "vitest"
+  },
+  "dependencies": {
+    "@h3ravel/core": "workspace:*",
+    "@h3ravel/support": "workspace:*",
+    "h3": "^2.0.0-beta.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  }
+}

package/packages/router/src/Controller.ts

@@ -0,0 +1 @@
+export default class { }

package/packages/router/src/Decorators/ApiResource.ts

@@ -0,0 +1 @@
+export default class { }

package/packages/router/src/Decorators/Controller.ts

@@ -0,0 +1 @@
+export default class { }

package/packages/router/src/Decorators/Get.ts

@@ -0,0 +1 @@
+export default class { }

package/packages/router/src/Decorators/Middleware.ts

@@ -0,0 +1 @@
+export default class { }

package/packages/router/src/Decorators/Post.ts

@@ -0,0 +1 @@
+export default class { }

package/packages/router/src/Providers/AssetsServiceProvider.ts

@@ -0,0 +1,53 @@
+import { readFile, stat } from "node:fs/promises";
+
+import { ServiceProvider } from '@h3ravel/core'
+import { before } from "@h3ravel/support";
+import { join } from "node:path";
+import { serveStatic } from 'h3'
+import { statSync } from "node:fs";
+
+/**
+ * Handles public assets loading
+ * 
+ * Auto-Registered
+ */
+export class AssetsServiceProvider extends ServiceProvider {
+    register () {
+        const app = this.app.make('router')
+        const config = this.app.make('config')
+        const fsconfig = config.get('filesystem')
+        const publicPath = this.app.getPath('public')
+
+        app.middleware(`/${fsconfig.public_mask}/**`, (event) => {
+            return serveStatic(event, {
+                indexNames: ["/index.html"],
+                getContents: (id) => {
+                    const newId = id.replace(`/${fsconfig.public_mask}/`, '')
+                    return readFile(join(before(publicPath, newId), newId))
+                },
+                getMeta: async (id) => {
+                    const newId = id.replace(`/${fsconfig.public_mask}/`, '')
+                    const stats = await stat(join(before(publicPath, newId), newId)).catch(() => { });
+                    if (stats?.isFile()) {
+                        return {
+                            size: stats.size,
+                            mtime: stats.mtimeMs,
+                        };
+                    }
+                },
+            });
+        })
+
+        this.app.singleton('asset', () => {
+            return (key: string, def = '') => {
+                try {
+                    statSync(join(before(publicPath, key), key))
+                } catch {
+                    key = def
+                }
+
+                return join(fsconfig.public_mask, key)
+            }
+        })
+    }
+}

package/packages/router/src/Providers/RouteServiceProvider.ts

@@ -0,0 +1,44 @@
+import { Router } from '../Router'
+import { ServiceProvider } from '@h3ravel/core'
+import path from 'node:path'
+import { readdir } from 'node:fs/promises'
+
+/**
+ * Handles routing registration
+ * 
+ * Load route files (web.ts, api.ts).
+ * Map controllers to routes.
+ * Register route-related middleware.
+ * 
+ * Auto-Registered
+ */
+export class RouteServiceProvider extends ServiceProvider {
+    register () {
+        this.app.singleton('router', () => {
+            const h3App = this.app.make('http.app')
+            return new Router(h3App, this.app)
+        })
+    }
+
+    /**
+     * Load routes from src/routes
+     */
+    async boot () {
+        try {
+            const routePath = this.app.getPath('routes')
+
+            const files = await readdir(routePath);
+
+            for (let i = 0; i < files.length; i++) {
+                const routesModule = await import(path.join(routePath, files[i]))
+
+                if (typeof routesModule.default === 'function') {
+                    const router = this.app.make('router')
+                    routesModule.default(router)
+                }
+            }
+        } catch (e) {
+            console.warn('No web routes found or failed to load:', e)
+        }
+    }
+}

package/packages/router/src/Route.ts

@@ -0,0 +1 @@
+export default class { }

package/packages/router/src/Router.ts

@@ -0,0 +1,180 @@
+import { H3Event, Middleware, MiddlewareOptions, type H3 } from 'h3'
+import { Application, Controller, Kernel } from '@h3ravel/core'
+import { Middleware as HttpMiddleware } from '@h3ravel/http'
+import { HttpContext } from '@h3ravel/http'
+import { afterLast } from '@h3ravel/support'
+
+type EventHandler = (ctx: HttpContext) => unknown
+
+interface RouteDefinition {
+    method: string
+    path: string
+    name?: string
+    handler: EventHandler
+}
+
+export class Router {
+    private routes: RouteDefinition[] = []
+    private groupPrefix = ''
+    private groupMiddleware: EventHandler[] = []
+
+    constructor(private h3App: H3, private app: Application) { }
+
+    /**
+     * Route Resolver
+     * 
+     * @param handler 
+     * @param middleware 
+     * @returns 
+     */
+    private resolveHandler (handler: EventHandler, middleware: HttpMiddleware[] = []) {
+        return async (event: H3Event) => {
+            const kernel = new Kernel(middleware)
+            return kernel.handle(event, (ctx) => Promise.resolve(handler(ctx)))
+        }
+    }
+
+    /**
+     * Add a route to the stack
+     * 
+     * @param method 
+     * @param path 
+     * @param handler 
+     * @param name 
+     * @param middleware 
+     */
+    private addRoute (
+        method: string,
+        path: string,
+        handler: EventHandler,
+        name?: string,
+        middleware: HttpMiddleware[] = []
+    ) {
+        const fullPath = `${this.groupPrefix}${path}`.replace(/\/+/g, '/')
+        this.routes.push({ method, path: fullPath, name, handler })
+        this.h3App[method as 'get'](fullPath, this.resolveHandler(handler, middleware))
+    }
+
+    private resolveControllerOrHandler (
+        handler: EventHandler | (new (...args: any[]) => Controller),
+        methodName?: string
+    ): EventHandler {
+        if (typeof handler === 'function' && (handler as any).prototype instanceof Controller) {
+            return (ctx) => {
+                const controller = new (handler as new (...args: any[]) => Controller)(this.app)
+                const action = (methodName || 'index') as keyof Controller
+
+                if (typeof controller[action] !== 'function') {
+                    throw new Error(`Method "${action}" not found on controller ${handler.name}`)
+                }
+
+                return controller[action](ctx)
+            }
+        }
+
+        return handler as EventHandler
+    }
+
+
+    get (
+        path: string,
+        handler: EventHandler | (new (...args: any[]) => Controller),
+        methodName?: string, name?: string, middleware: HttpMiddleware[] = []
+    ) {
+        this.addRoute('get', path, this.resolveControllerOrHandler(handler, methodName), name, middleware)
+    }
+
+    post (
+        path: string,
+        handler: EventHandler | (new (...args: any[]) => Controller),
+        methodName?: string, name?: string, middleware: HttpMiddleware[] = []
+    ) {
+        this.addRoute('post', path, this.resolveControllerOrHandler(handler, methodName), name, middleware)
+    }
+
+    put (
+        path: string,
+        handler: EventHandler | (new (...args: any[]) => Controller),
+        methodName?: string, name?: string, middleware: HttpMiddleware[] = []
+    ) {
+        this.addRoute('put', path, this.resolveControllerOrHandler(handler, methodName), name, middleware)
+    }
+
+    delete (
+        path: string,
+        handler: EventHandler | (new (...args: any[]) => Controller),
+        methodName?: string, name?: string, middleware: HttpMiddleware[] = []
+    ) {
+        this.addRoute('delete', path, this.resolveControllerOrHandler(handler, methodName), name, middleware)
+    }
+
+    /**
+     * API Resource support  
+     * 
+     * @param path 
+     * @param controller 
+     */
+    apiResource (
+        path: string,
+        Controller: new (app: Application) => Controller,
+        middleware: HttpMiddleware[] = []
+    ) {
+        path = path.replace(/\//g, '/')
+
+        const name = afterLast(path, '/')
+        const basePath = `/${path}`.replace(/\/+/g, '/')
+
+        const controller = new Controller(this.app)
+
+        this.addRoute('get', basePath, controller.index.bind(controller), `${name}.index`, middleware)
+        this.addRoute('post', basePath, controller.store.bind(controller), `${name}.store`, middleware)
+        this.addRoute('get', `${basePath}/:id`, controller.show.bind(controller), `${name}.show`, middleware)
+        this.addRoute('put', `${basePath}/:id`, controller.update.bind(controller), `${name}.update`, middleware)
+        this.addRoute('patch', `${basePath}/:id`, controller.update.bind(controller), `${name}.update`, middleware)
+        this.addRoute('delete', `${basePath}/:id`, controller.destroy.bind(controller), `${name}.destroy`, middleware)
+    }
+
+    /**
+     * Named route URL generator
+     * 
+     * @param name 
+     * @param params 
+     * @returns 
+     */
+    route (name: string, params: Record<string, string> = {}): string | undefined {
+        const found = this.routes.find(r => r.name === name)
+        if (!found) return undefined
+
+        let url = found.path
+        for (const [key, value] of Object.entries(params)) {
+            url = url.replace(`:${key}`, value)
+        }
+        return url
+    }
+
+    /**
+     * Grouping
+     * 
+     * @param options 
+     * @param callback 
+     */
+    group (options: { prefix?: string; middleware?: EventHandler[] }, callback: () => void) {
+        const prevPrefix = this.groupPrefix
+        const prevMiddleware = [...this.groupMiddleware]
+
+        this.groupPrefix += options.prefix || ''
+        this.groupMiddleware.push(...(options.middleware || []))
+
+        callback()
+
+        /**
+         * Restore state after group
+         */
+        this.groupPrefix = prevPrefix
+        this.groupMiddleware = prevMiddleware
+    }
+
+    middleware (path: string, handler: Middleware, opts?: MiddlewareOptions) {
+        this.h3App.use(path, handler, opts)
+    }
+}

package/packages/router/src/index.ts

@@ -0,0 +1,14 @@
+/**
+ * @file Automatically generated by barrelsby.
+ */
+
+export * from './Controller';
+export * from './Route';
+export * from './Router';
+export * from './Decorators/ApiResource';
+export * from './Decorators/Controller';
+export * from './Decorators/Get';
+export * from './Decorators/Middleware';
+export * from './Decorators/Post';
+export * from './Providers/AssetsServiceProvider';
+export * from './Providers/RouteServiceProvider';

package/packages/router/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "dist"
+  },
+  "include": ["src"],
+  "exclude": ["dist", "node_modules"]
+}

package/packages/router/vite.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'tsup'
+
+export default defineConfig({
+    entry: ['src/index.ts'],
+    format: ['esm', 'cjs'],
+    dts: true,
+    sourcemap: true,
+    clean: true
+}) 

package/packages/support/node_modules/.bin/tsc

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/ralph/Documents/Marx/Toneflix/OpenSource/H3ravel/framework/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/node_modules:/Users/ralph/Documents/Marx/Toneflix/OpenSource/H3ravel/framework/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/node_modules:/Users/ralph/Documents/Marx/Toneflix/OpenSource/H3ravel/framework/node_modules/.pnpm/typescript@5.8.3/node_modules:/Users/ralph/Documents/Marx/Toneflix/OpenSource/H3ravel/framework/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/ralph/Documents/Marx/Toneflix/OpenSource/H3ravel/framework/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/node_modules:/Users/ralph/Documents/Marx/Toneflix/OpenSource/H3ravel/framework/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/node_modules:/Users/ralph/Documents/Marx/Toneflix/OpenSource/H3ravel/framework/node_modules/.pnpm/typescript@5.8.3/node_modules:/Users/ralph/Documents/Marx/Toneflix/OpenSource/H3ravel/framework/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsc" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsc" "$@"
+fi

package/packages/support/node_modules/.bin/tsserver

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/ralph/Documents/Marx/Toneflix/OpenSource/H3ravel/framework/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/node_modules:/Users/ralph/Documents/Marx/Toneflix/OpenSource/H3ravel/framework/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/node_modules:/Users/ralph/Documents/Marx/Toneflix/OpenSource/H3ravel/framework/node_modules/.pnpm/typescript@5.8.3/node_modules:/Users/ralph/Documents/Marx/Toneflix/OpenSource/H3ravel/framework/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/ralph/Documents/Marx/Toneflix/OpenSource/H3ravel/framework/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/node_modules:/Users/ralph/Documents/Marx/Toneflix/OpenSource/H3ravel/framework/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/node_modules:/Users/ralph/Documents/Marx/Toneflix/OpenSource/H3ravel/framework/node_modules/.pnpm/typescript@5.8.3/node_modules:/Users/ralph/Documents/Marx/Toneflix/OpenSource/H3ravel/framework/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsserver" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsserver" "$@"
+fi

package/packages/support/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@h3ravel/support",
+  "version": "0.1.1",
+  "description": "Shared helpers, facades and utilities for H3ravel.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "barrel": "barrelsby --directory src --delete --singleQuotes",
+    "build": "tsup",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "lint": "eslint . --ext .ts",
+    "test": "vitest"
+  },
+  "dependencies": {
+    "@h3ravel/core": "workspace:*",
+    "h3": "^2.0.0-beta.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  }
+}

package/packages/support/src/Contracts/ObjContract.ts

@@ -0,0 +1,53 @@
+import { CamelToSnakeCase } from "./StrContract"
+
+/**
+ * Adds a dot prefix to nested keys
+ */
+type DotPrefix<T extends string, U extends string> =
+    T extends '' ? U : `${T}.${U}`
+
+/**
+ * Converts a union of objects into a single merged object
+ */
+type MergeUnion<T> =
+    (T extends any ? (k: T) => void : never) extends
+    (k: infer I) => void ? { [K in keyof I]: I[K] } : never
+
+/**
+ * Flattens nested objects into dotted keys
+ */
+export type DotFlatten<T, Prefix extends string = ''> = MergeUnion<{
+    [K in keyof T & string]:
+    T[K] extends Record<string, any>
+    ? DotFlatten<T[K], DotPrefix<Prefix, K>>
+    : { [P in DotPrefix<Prefix, K>]: T[K] }
+}[keyof T & string]>
+
+/**
+ * Builds "nested.key" paths for autocompletion
+ */
+export type DotNestedKeys<T> = {
+    [K in keyof T & string]:
+    T[K] extends object
+    ? `${K}` | `${K}.${DotNestedKeys<T[K]>}`
+    : `${K}`
+}[keyof T & string]
+
+/**
+ * Retrieves type at a given dot-path
+ */
+export type DotNestedValue<T, Path extends string> =
+    Path extends `${infer Key}.${infer Rest}`
+    ? Key extends keyof T
+    ? DotNestedValue<T[Key], Rest>
+    : never
+    : Path extends keyof T
+    ? T[Path]
+    : never
+
+/**
+ * Convert CamelCased Object keys to snake_case
+ */
+export type KeysToSnakeCase<T> = {
+    [K in keyof T as CamelToSnakeCase<string & K>]: T[K]
+}

package/packages/support/src/Contracts/StrContract.ts

@@ -0,0 +1,6 @@
+/**
+ * Converts CamelCased strings to snake_case
+ */
+export type CamelToSnakeCase<S extends string> = S extends `${infer T}${infer U}` ?
+    `${T extends Capitalize<T> ? '_' : ''}${Lowercase<T>}${CamelToSnakeCase<U>}` :
+    S 

package/packages/support/src/Helpers/Arr.ts

@@ -0,0 +1,33 @@
+/**
+ * Splits an array into chunks of a specified size.
+ *
+ * @template T - Type of elements in the array
+ * @param arr - The input array
+ * @param size - Size of each chunk (default: 2)
+ * @returns An array of chunks (arrays)
+ */
+export const chunk = <T> (arr: T[], size: number = 2): T[][] => {
+    if (size <= 0) throw new Error("Chunk size must be greater than 0")
+
+    const chunks: T[][] = []
+
+    for (let i = 0; i < arr.length; i += size) {
+        chunks.push(arr.slice(i, i + size))
+    }
+
+    return chunks
+}
+
+
+/**
+ * Generates an array of sequential numbers.
+ *
+ * @param size - Number of elements in the range
+ * @param startAt - Starting number (default: 0)
+ * @returns An array of numbers from startAt to startAt + size - 1
+ */
+export const range = (size: number, startAt: number = 0): number[] => {
+    if (size <= 0 || !Number.isFinite(size)) return []
+
+    return Array.from({ length: size }, (_, i) => startAt + i)
+}