h3ravel-monorepo 0.1.1

package/packages/core/src/Contracts/BindingsContract.ts

@@ -0,0 +1,37 @@
+import { DotNestedKeys, DotNestedValue } from "@h3ravel/support";
+import type { H3, serve } from "h3";
+
+import type { Edge } from "edge.js";
+import { PathLoader } from "../Utils/PathLoader";
+import type { Router } from "@h3ravel/router";
+
+type RemoveIndexSignature<T> = {
+    [K in keyof T as string extends K
+    ? never
+    : number extends K
+    ? never
+    : K]: T[K]
+}
+
+export type Bindings = {
+    [key: string]: any;
+    env<T extends string> (): NodeJS.ProcessEnv
+    env<T extends string> (key: T, def?: any): any
+    view: Edge,
+    asset (key: string, def?: string): string,
+    router: Router
+    config: {
+        // get<X extends Record<string, any>> (): X
+        // get<X extends Record<string, any>, K extends DotNestedKeys<X>> (key: K, def?: any): DotNestedValue<X, K>
+        get<X extends Record<string, any>> (): X
+        get<X extends Record<string, any>, T extends Extract<keyof X, string>> (key: T, def?: any): X[T]
+        set<T extends string> (key: T, value: any): void
+        load?(): any
+    }
+    'http.app': H3
+    'path.base': string
+    'app.paths': PathLoader
+    'http.serve': typeof serve
+}
+
+export type UseKey = keyof RemoveIndexSignature<Bindings>

package/packages/core/src/Controller.ts

@@ -0,0 +1,20 @@
+import { HttpContext, IController } from '@h3ravel/http'
+
+import { Application } from '.'
+
+/**
+ * Base controller class
+ */
+export abstract class Controller implements IController {
+    protected app: Application
+
+    constructor(app: Application) {
+        this.app = app
+    }
+
+    public show (_ctx: HttpContext): any { return }
+    public index (_ctx: HttpContext): any { return }
+    public store (_ctx: HttpContext): any { return }
+    public update (_ctx: HttpContext): any { return }
+    public destroy (_ctx: HttpContext): any { return }
+}

package/packages/core/src/Exceptions/Handler.ts

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

package/packages/core/src/Http/Kernel.ts

@@ -0,0 +1,47 @@
+import { HttpContext, Middleware, Request, Response } from '@h3ravel/http'
+
+import type { H3Event } from 'h3'
+
+export class Kernel {
+    constructor(private middleware: Middleware[] = []) { }
+
+    async handle (event: H3Event, next: (ctx: HttpContext) => Promise<unknown>): Promise<unknown> {
+        const context: HttpContext = {
+            request: new Request(event),
+            response: new Response(event)
+        }
+
+        const result = await this.runMiddleware(context, () => next(context))
+
+        // Auto-set JSON header if plain object returned
+        if (result !== undefined && this.isPlainObject(result)) {
+            event.res.headers.set('Content-Type', 'application/json; charset=UTF-8')
+        }
+
+        return result
+    }
+
+    private async runMiddleware (context: HttpContext, next: (ctx: HttpContext) => Promise<unknown>) {
+        let index = -1
+
+        const runner = async (i: number): Promise<unknown> => {
+            if (i <= index) throw new Error('next() called multiple times')
+            index = i
+            const middleware = this.middleware[i]
+
+            if (middleware) {
+                return middleware.handle(context, () => runner(i + 1))
+            } else {
+                return next(context)
+            }
+        }
+
+        return runner(0)
+    }
+
+    private isPlainObject (value: unknown): value is Record<string, unknown> {
+        return typeof value === 'object' &&
+            value !== null &&
+            (value.constructor === Object || value.constructor === Array)
+    }
+}

package/packages/core/src/Providers/AppServiceProvider.ts

@@ -0,0 +1,18 @@
+import 'reflect-metadata'
+
+import { ServiceProvider } from '../ServiceProvider'
+
+/**
+ * Bootstraps core services and bindings.
+ * 
+ * Bind essential services to the container (logger, config repository).
+ * Register app-level singletons.
+ * Set up exception handling.
+ * 
+ * Auto-Registered
+ */
+export class AppServiceProvider extends ServiceProvider {
+    register () {
+        // Core bindings
+    }
+}

package/packages/core/src/Providers/ViewServiceProvider.ts

@@ -0,0 +1,19 @@
+import { Edge } from 'edge.js'
+import { ServiceProvider } from '@h3ravel/core'
+
+export class ViewServiceProvider extends ServiceProvider {
+    register (): void {
+        const config = this.app.make('config')
+        const edge = Edge.create({
+            cache: process.env.NODE_ENV === 'production'
+        })
+
+        edge.mount(this.app.getPath('views'))
+
+        edge.global('asset', this.app.make('asset'))
+        edge.global('config', config.get)
+        edge.global('app', this.app)
+
+        this.app.bind('view', () => edge)
+    }
+}

package/packages/core/src/ServiceProvider.ts

@@ -0,0 +1,21 @@
+import { Application } from './Application'
+
+export abstract class ServiceProvider {
+    protected app: Application
+
+    constructor(app: Application) {
+        this.app = app
+    }
+
+    /**
+     * Register bindings to the container.
+     * Runs before boot().
+     */
+    abstract register (): void | Promise<void>
+
+    /**
+     * Perform post-registration booting of services.
+     * Runs after all providers have been registered.
+     */
+    boot?(): void | Promise<void>
+}

package/packages/core/src/Utils/PathLoader.ts

@@ -0,0 +1,46 @@
+import nodepath from "path"
+
+type PathName = 'views' | 'routes' | 'assets' | 'base' | 'public' | 'storage' | 'config'
+
+export class PathLoader {
+    private paths = {
+        base: '',
+        views: '/src/resources/views',
+        assets: '/public/assets',
+        routes: '/src/routes',
+        config: '/src/config',
+        public: '/public',
+        storage: '/src/storage',
+    }
+
+    /**
+     * Dynamically retrieves a path property from the class.
+     * Any property ending with "Path" is accessible automatically.
+     *
+     * @param name - The base name of the path property
+     * @param base - The base path to include to the path
+     * @returns 
+     */
+    getPath (name: PathName, base?: string): string {
+        if (base && name !== 'base') {
+            return nodepath.join(base, this.paths[name])
+        }
+
+        return this.paths[name]
+    }
+
+    /**
+     * Programatically set the paths.
+     *
+     * @param name - The base name of the path property
+     * @param path - The new path
+     * @param base - The base path to include to the path
+     */
+    setPath (name: PathName, path: string, base?: string) {
+        if (base && name !== 'base') {
+            this.paths[name] = nodepath.join(base, path)
+        }
+
+        this.paths[name] = path
+    }
+}

package/packages/core/src/index.ts

@@ -0,0 +1,14 @@
+/**
+ * @file Automatically generated by barrelsby.
+ */
+
+export * from './Application';
+export * from './Container';
+export * from './Controller';
+export * from './ServiceProvider';
+export * from './Contracts/BindingsContract';
+export * from './Exceptions/Handler';
+export * from './Http/Kernel';
+export * from './Providers/AppServiceProvider';
+export * from './Providers/ViewServiceProvider';
+export * from './Utils/PathLoader';

package/packages/core/tsconfig.json

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

package/packages/core/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/database/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/database/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/database/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@h3ravel/database",
+  "version": "0.1.1",
+  "description": "Modeling data and migration 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:*",
+    "h3": "^2.0.0-beta.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  }
+}

package/packages/database/src/Model.ts

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

package/packages/database/src/Providers/DatabaseServiceProvider.ts

@@ -0,0 +1,16 @@
+import { ServiceProvider } from '@h3ravel/core'
+
+/**
+ * Database connection, ORM, migrations.
+ * 
+ * Register DatabaseManager and QueryBuilder if required.
+ * Set up ORM models and relationships.
+ * Register migration and seeder commands.
+ * 
+ * Auto-Registered if @h3ravel/database is installed
+ */
+export class DatabaseServiceProvider extends ServiceProvider {
+    register () {
+        // Core bindings
+    }
+}

package/packages/database/src/index.ts

@@ -0,0 +1,6 @@
+/**
+ * @file Automatically generated by barrelsby.
+ */
+
+export * from './Model';
+export * from './Providers/DatabaseServiceProvider';

package/packages/database/tsconfig.json

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

package/packages/database/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/http/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/http/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/http/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@h3ravel/http",
+  "version": "0.1.1",
+  "description": "HTTP kernel, middleware pipeline, request/response classes 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:*",
+    "srvx": "^0.8.2",
+    "h3": "^2.0.0-beta.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  }
+}

package/packages/http/src/Contracts/ControllerContracts.ts

@@ -0,0 +1,13 @@
+import { HttpContext } from "./HttpContract"
+
+/**
+ * Defines the contract for all controllers.
+ * Any controller implementing this must define these methods.
+ */
+export interface IController {
+    show (ctx: HttpContext): any
+    index (ctx: HttpContext): any
+    store (ctx: HttpContext): any
+    update (ctx: HttpContext): any
+    destroy (ctx: HttpContext): any
+}

package/packages/http/src/Contracts/HttpContract.ts

@@ -0,0 +1,7 @@
+import { Request } from "../Request"
+import { Response } from "../Response"
+
+export interface HttpContext {
+    request: Request
+    response: Response
+}

package/packages/http/src/Middleware/LogRequests.ts

@@ -0,0 +1,9 @@
+import { HttpContext, Middleware } from '@h3ravel/http'
+
+export class LogRequests extends Middleware {
+    async handle ({ request }: HttpContext, next: () => Promise<unknown>): Promise<unknown> {
+        const url = request.getEvent('url')
+        console.log(`[${request.getEvent('method')}] ${url.pathname + url.search}`)
+        return next()
+    }
+}

package/packages/http/src/Middleware.ts

@@ -0,0 +1,5 @@
+import { HttpContext } from './Contracts/HttpContract';
+
+export abstract class Middleware {
+    abstract handle (context: HttpContext, next: () => Promise<unknown>): Promise<unknown>
+}

package/packages/http/src/Providers/HttpServiceProvider.ts

@@ -0,0 +1,22 @@
+import { H3, serve } from 'h3'
+
+import { ServiceProvider } from '@h3ravel/core'
+
+/**
+ * Sets up HTTP kernel and request lifecycle.
+ * 
+ * Register Request, Response, and Middleware classes.
+ * Configure global middleware stack.
+ * Boot HTTP kernel.
+ * 
+ * Auto-Registered
+ */
+export class HttpServiceProvider extends ServiceProvider {
+    register () {
+        this.app.singleton('http.app', () => {
+            return new H3()
+        })
+
+        this.app.singleton('http.serve', () => serve)
+    }
+}

package/packages/http/src/Request.ts

@@ -0,0 +1,59 @@
+import { getQuery, getRouterParams, readBody, type H3Event } from 'h3'
+import { DotNestedKeys, DotNestedValue, safeDot } from '@h3ravel/support'
+
+export class Request {
+    private readonly event: H3Event
+
+    constructor(event: H3Event) {
+        this.event = event
+    }
+
+    /**
+     * Get all input data (query + body).
+     */
+    async all<T = Record<string, unknown>> (): Promise<T> {
+        let data = {
+            ...getRouterParams(this.event),
+            ...getQuery(this.event),
+        } as T
+
+        if (this.event.req.method === 'POST') {
+            data = Object.assign({}, data, Object.fromEntries((await this.event.req.formData()).entries()))
+        } else if (this.event.req.method === 'PUT') {
+            data = <never>Object.fromEntries(Object.entries(<never>await readBody(this.event)))
+        }
+
+        return data
+    }
+
+    /**
+     * Get a single input field from query or body.
+     */
+    async input<T = unknown> (key: string, defaultValue?: T): Promise<T> {
+        const data = await this.all<Record<string, T>>()
+        return (data[key] ?? defaultValue) as T
+    }
+
+    /**
+     * Get route parameters.
+     */
+    params<T = Record<string, string>> (): T {
+        return getRouterParams(this.event) as T
+    }
+
+    /**
+     * Get query parameters.
+     */
+    query<T = Record<string, string>> (): T {
+        return getQuery(this.event) as T
+    }
+
+    /**
+     * Get the base event
+     */
+    getEvent (): H3Event
+    getEvent<K extends DotNestedKeys<H3Event>> (key: K): DotNestedValue<H3Event, K>
+    getEvent<K extends DotNestedKeys<H3Event>> (key?: K): any {
+        return safeDot(this.event, key)
+    }
+}

package/packages/http/src/Resources/ApiResource.ts

@@ -0,0 +1,39 @@
+import { JsonResource, Resource } from "./JsonResource";
+
+import { H3Event } from "h3";
+
+export function ApiResource (
+    instance: JsonResource
+) {
+    return new Proxy(instance, {
+        get (target, prop, receiver) {
+            const value = Reflect.get(target, prop, receiver);
+            if (typeof value === 'function') {
+                // Intercept json, additional, and send methods
+                if (prop === 'json' || prop === 'additional') {
+                    return (...args: any[]) => {
+                        const result = value.apply(target, args);
+                        // Schedule checkSend after json or additional
+                        setImmediate(() => target['checkSend']());
+                        return result;
+                    };
+                } else if (prop === 'send') {
+                    return (...args: any[]) => {
+                        // Prevent checkSend from firing
+                        target['shouldSend'] = false;
+
+                        return value.apply(target, args);
+                    };
+                }
+            }
+            return value;
+        },
+    });
+}
+
+export default function BaseResource<R extends Resource> (
+    evt: H3Event,
+    rsc: R
+) {
+    return ApiResource(new JsonResource<R>(evt, rsc))
+}