@cruxjs/base 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Maysara Elshewehy (https://github.com/maysara-elshewehy)
+
+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/README.md

@@ -0,0 +1,516 @@
+<!-- ╔══════════════════════════════ BEG ══════════════════════════════╗ -->
+
+<br>
+<div align="center">
+    <p>
+        <img src="./assets/img/logo.png" alt="logo" style="" height="60" />
+    </p>
+</div>
+
+<div align="center">
+    <img src="https://img.shields.io/badge/v-0.0.1-black"/>
+    <img src="https://img.shields.io/badge/🔥-@cruxjs-black"/>
+    <br>
+    <img src="https://img.shields.io/github/issues/crux/base?style=flat" alt="Github Repo Issues" />
+    <img src="https://img.shields.io/github/stars/crux/base?style=social" alt="GitHub Repo stars" />
+</div>
+<br>
+
+<!-- ╚═════════════════════════════════════════════════════════════════╝ -->
+
+<br>
+
+- ## Quick Start 🔥
+
+    > **_Core types and utilities for building CruxJS applications and plugins. A shared foundation for @cruxjs/app and plugin packages._**
+
+    - ### Overview
+
+        > `@cruxjs/base` is the **shared foundation** for the entire CruxJS ecosystem. It provides:
+
+        - **Type Definitions**: Core interfaces for plugins, app configuration, lifecycle management, and routing
+
+        - **Logger**: Debug-aware logging for CruxJS operations and plugins
+
+        - **PluginRegistry**: Plugin registration and lifecycle hook management
+
+        - **ResourceMerger**: Smart merging of routes, schemas, and static configs with user priority
+
+        > This package enables clean separation between **@cruxjs/app** (the framework) and **@cruxjs-plugins/** (domain-specific plugins), allowing plugins to be created independently without importing the entire app framework.
+
+    <div align="center"> <img src="./assets/img/line.png" alt="line" style="display: block; margin-top:20px;margin-bottom:20px;width:500px;"/> <br> </div>
+
+    - ### Setup
+
+        > install [`hmm`](https://github.com/minejs-org/hmm) first.
+
+        ```bash
+        hmm i @cruxjs/base
+        ```
+
+    <div align="center"> <img src="./assets/img/line.png" alt="line" style="display: block; margin-top:20px;margin-bottom:20px;width:500px;"/> <br> </div>
+
+    - ### Usage
+
+        - ### 1. Type Definitions (Core Types)
+
+            > Import shared types for building apps and plugins:
+
+            ```typescript
+            import {
+                // App Configuration & Instance
+                AppConfig,
+                AppInstance,
+                AppContext,
+                AppMiddleware,
+
+                // Plugin System
+                CruxPlugin,
+                MiddlewareExport,
+
+                // Lifecycle
+                LifecycleContext,
+                LifecycleHooks,
+
+                // Routing & Resources
+                RouteDefinition,
+                StaticConfig,
+                TableSchema
+            } from '@cruxjs/base'
+            ```
+
+            **Key Types:**
+
+            ```typescript
+            // Plugin Interface - what every plugin must implement
+            export interface CruxPlugin {
+                name            : string
+                version         : string
+
+                // Resources the plugin provides
+                routes?         : RouteDefinition[]
+                schemas?        : TableSchema[]
+                middlewares?    : MiddlewareExport[]
+                static?         : StaticConfig[]
+
+                // Lifecycle hooks
+                onRegister?     : (app: AppInstance)      => Promise<void>
+                onAwake?        : (ctx: LifecycleContext) => Promise<void>
+                onStart?        : (ctx: LifecycleContext) => Promise<void>
+                onReady?        : (ctx: LifecycleContext) => Promise<void>
+                onShutdown?     : (ctx: LifecycleContext) => Promise<void>
+            }
+
+            // App Configuration
+            export interface AppConfig {
+                server?: {
+                    port?       : number
+                    host?       : string
+                    logging?    : boolean | LoggingConfig
+                }
+                client?: {
+                    entry       : string
+                    output      : string
+                    minify?     : boolean
+                    sourcemap?  : boolean
+                }
+                database?       : DatabaseConfig | DatabaseConfig[]
+                i18n?           : I18nConfig
+                static?         : StaticConfig | StaticConfig[]
+                api?            : ApiConfig
+                security?       : SecurityConfig
+                routes?         : RouteDefinition[]
+                middlewares?    : AppMiddleware[]
+                plugins?        : CruxPlugin[]
+                debug?          : boolean
+            }
+
+            // Route Definition
+            export interface RouteDefinition {
+                method          : 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'OPTIONS' | 'HEAD'
+                path            : string
+                handler         : (c: AppContext) => any
+                middlewares?    : AppMiddleware[]
+            }
+            ```
+
+        <div align="center"> <img src="./assets/img/line.png" alt="line" style="display: block; margin-top:20px;margin-bottom:20px;width:500px;"/> <br> </div>
+
+        - ### 2. Logger Utility
+
+            Unified logging for CruxJS operations and plugins with debug mode support:
+
+            ```typescript
+            import { Logger } from '@cruxjs/base'
+
+            // Initialize logger (second param: debug mode)
+            const logger = new Logger(true)
+
+            // Log lifecycle phases
+            logger.phase('Database Setup')
+
+            // General info logs (only shown in debug mode)
+            logger.info('Loading configuration...')
+
+            // Success logs (only shown in debug mode)
+            logger.success('Server running on port 3000')
+
+            // Error logs (always shown)
+            logger.error('Failed to connect to database', err)
+
+            // Plugin-specific logs
+            logger.plugin('@cruxjs-plugins/auth', 'Initializing JWT strategy')
+            ```
+
+            **Output Example:**
+            ```
+            [CruxJS] ⚡ Phase: Database Setup
+            [CruxJS] Loading configuration...
+            [CruxJS] ✓ Server running on port 3000
+            [CruxJS:@cruxjs-plugins/auth] Initializing JWT strategy
+            [CruxJS] ✗ Failed to connect to database
+            Error: Connection timeout
+            ```
+
+        <div align="center"> <img src="./assets/img/line.png" alt="line" style="display: block; margin-top:20px;margin-bottom:20px;width:500px;"/> <br> </div>
+
+        - ### 3. Plugin Registry
+
+            Manage plugin registration and lifecycle hooks:
+
+            ```typescript
+            import { PluginRegistry, Logger } from '@cruxjs/base'
+            import type { AppInstance, LifecycleContext } from '@cruxjs/base'
+
+            const logger = new Logger(true)
+            const registry = new PluginRegistry(logger)
+
+            // Register a plugin
+            const myPlugin = {
+                name: '@cruxjs-plugins/auth',
+                version: '1.0.0',
+                routes: [{ method: 'POST', path: '/login', handler: (c) => c.json({}) }],
+                async onRegister(app: AppInstance) {
+                    console.log('Plugin registered!')
+                }
+            }
+
+            await registry.register(myPlugin, appInstance)
+
+            // Collect resources from all registered plugins
+            const allRoutes = registry.collectRoutes()
+            const allSchemas = registry.collectSchemas()
+            const allMiddlewares = registry.collectMiddlewares()
+            const allStatic = registry.collectStatic()
+
+            // Call lifecycle hooks across all plugins
+            await registry.callHook('onStart', lifecycleContext)
+            await registry.callHook('onReady', lifecycleContext)
+            ```
+
+            **Registry Methods:**
+
+            ```typescript
+            // Register a plugin and call its onRegister hook
+            register(plugin: CruxPlugin, app: AppInstance): Promise<void>
+
+            // Get all registered plugins
+            getAll(): CruxPlugin[]
+
+            // Call a lifecycle hook on all plugins that have it
+            callHook(hook: 'onAwake' | 'onStart' | 'onReady' | 'onShutdown', ctx: LifecycleContext): Promise<void>
+
+            // Collect resources from all plugins
+            collectRoutes(): RouteDefinition[]
+            collectSchemas(): TableSchema[]
+            collectMiddlewares(): Map<string, AppMiddleware>
+            collectStatic(): StaticConfig[]
+            ```
+
+        <div align="center"> <img src="./assets/img/line.png" alt="line" style="display: block; margin-top:20px;margin-bottom:20px;width:500px;"/> <br> </div>
+
+        - ### 4. Resource Merger
+
+            Intelligently merge routes, schemas, and static configs with user-defined resources taking priority:
+
+            ```typescript
+            import { ResourceMerger, Logger } from '@cruxjs/base'
+            import type { RouteDefinition, TableSchema, StaticConfig } from '@cruxjs/base'
+
+            const logger = new Logger(false)
+            const merger = new ResourceMerger(logger)
+
+            // User routes have priority over plugin routes
+            const userRoutes: RouteDefinition[] = [
+                { method: 'GET', path: '/api/users', handler: (c) => c.json([]) }
+            ]
+            const pluginRoutes: RouteDefinition[] = [
+                { method: 'GET', path: '/api/users', handler: (c) => c.json({}) },
+                { method: 'POST', path: '/api/users', handler: (c) => c.json({}) }
+            ]
+
+            const merged = merger.mergeRoutes(userRoutes, pluginRoutes)
+            // Result: GET /api/users uses user handler, POST /api/users uses plugin handler
+
+            // Same priority system for schemas
+            const schemas = merger.mergeSchemas(userSchemas, pluginSchemas)
+
+            // Static files are simply concatenated
+            const statics = merger.mergeStatic(userStatic, pluginStatic)
+            ```
+
+            **Merge Behavior:**
+
+            | Resource | Priority   | Behavior                                                |
+            | -------- | ---------- | ------------------------------------------------------- |
+            | Routes   | User first | Duplicate routes (method + path) override plugin routes |
+            | Schemas  | User first | Duplicate schemas (by name) override plugin schemas     |
+            | Static   | Both       | All configs are included (no deduplication)             |
+
+        <div align="center"> <img src="./assets/img/line.png" alt="line" style="display: block; margin-top:20px;margin-bottom:20px;width:500px;"/> <br> </div>
+
+        - ### 5. Creating a Plugin
+
+            Here's a complete example of creating a plugin using `@cruxjs/base`:
+
+            ```typescript
+            // plugins/auth/index.ts
+            import type { CruxPlugin, AppInstance, LifecycleContext } from '@cruxjs/base'
+
+            export function authPlugin(): CruxPlugin {
+                return {
+                    name: '@cruxjs-plugins/auth',
+                    version: '1.0.0',
+
+                    // Routes provided by this plugin
+                    routes: [
+                        {
+                            method: 'POST',
+                            path: '/api/auth/login',
+                            handler: async (c) => {
+                                const { email, password } = await c.req.json()
+                                // Authentication logic
+                                return c.json({ token: 'jwt-token' })
+                            }
+                        },
+                        {
+                            method: 'POST',
+                            path: '/api/auth/logout',
+                            handler: (c) => c.json({ success: true })
+                        }
+                    ],
+
+                    // Database schemas
+                    schemas: [
+                        {
+                            name: 'users',
+                            columns: [
+                                { name: 'id', type: 'INTEGER', primaryKey: true },
+                                { name: 'email', type: 'TEXT', unique: true },
+                                { name: 'password_hash', type: 'TEXT' }
+                            ]
+                        }
+                    ],
+
+                    // Middleware exports
+                    middlewares: [
+                        {
+                            name: 'authRequired',
+                            handler: async (c, next) => {
+                                const token = c.req.header('Authorization')
+                                if (!token) return c.json({ error: 'Unauthorized' }, 401)
+                                await next()
+                            }
+                        }
+                    ],
+
+                    // Static files (e.g., docs)
+                    static: [
+                        { path: '/auth-docs', directory: './docs/auth' }
+                    ],
+
+                    // Lifecycle hooks
+                    async onRegister(app: AppInstance) {
+                        console.log('Auth plugin registered')
+                    },
+
+                    async onStart(ctx: LifecycleContext) {
+                        console.log('Auth plugin started - creating tables...')
+                        // Initialize database tables
+                    },
+
+                    async onReady(ctx: LifecycleContext) {
+                        console.log('Auth plugin ready!')
+                    }
+                }
+            }
+            ```
+
+            **Export from your plugin:**
+
+            ```typescript
+            // plugins/auth/package.json
+            {
+                "name": "@cruxjs-plugins/auth",
+                "version": "1.0.0",
+                "main": "./dist/index.js",
+                "types": "./dist/index.d.ts",
+                "exports": {
+                    ".": {
+                        "import": "./dist/index.js",
+                        "types": "./dist/index.d.ts"
+                    }
+                }
+            }
+            ```
+
+        <div align="center"> <img src="./assets/img/line.png" alt="line" style="display: block; margin-top:20px;margin-bottom:20px;width:500px;"/> <br> </div>
+
+        - ### 6. Using Plugins in @cruxjs/app
+
+            ```typescript
+            import { createApp } from '@cruxjs/app'
+            import { authPlugin } from '@cruxjs-plugins/auth'
+            import { blogPlugin } from '@cruxjs-plugins/blog'
+
+            const app = createApp({
+                server: { port: 3000 },
+                database: { connection: './app.db' },
+                plugins: [
+                    authPlugin(),
+                    blogPlugin({ defaultLanguage: 'en' })
+                ]
+            })
+
+            await app.start()
+            ```
+
+            All plugins are automatically:
+            - ✅ Registered with their `onRegister` hooks called
+            - ✅ Resources (routes, schemas, middlewares, static) merged intelligently
+            - ✅ Lifecycle hooks called in correct sequence
+            - ✅ Available in the app instance
+
+        <div align="center"> <img src="./assets/img/line.png" alt="line" style="display: block; margin-top:20px;margin-bottom:20px;width:500px;"/> <br> </div>
+
+    - ### Architecture
+
+        **The Three-Layer CruxJS Architecture:**
+
+        ```
+        ┌───────────────────────────────────┐
+        │     @cruxjs/app (Framework)       │
+        │  - Creates HTTP server            │
+        │  - Manages lifecycle              │
+        │  - Orchestrates plugins           │
+        └───────────────────────────────────┘
+                         ↓
+        ┌───────────────────────────────────┐
+        │  @cruxjs-plugins/* (Logic Layer)  │
+        │  - Business logic                 │
+        │  - API routes & schemas           │
+        │  - Independent plugins            │
+        │  (Uses @cruxjs/base types only)   │
+        └───────────────────────────────────┘
+                         ↓
+        ┌───────────────────────────────────┐
+        │  @cruxjs-kit/* (UI Layer)         │
+        │  - JSX components + @mineui style │
+        │  - Client-side logic              │
+        │  - No business logic              │
+        └───────────────────────────────────┘
+        ```
+
+    <div align="center"> <img src="./assets/img/line.png" alt="line" style="display: block; margin-top:20px;margin-bottom:20px;width:500px;"/> <br> </div>
+
+    - ### API Reference
+
+        - #### Logger
+
+            ```typescript
+            class Logger {
+                constructor(debug: boolean = false)
+
+                phase(name: string): void
+                info(msg: string): void
+                success(msg: string): void
+                error(msg: string, err?: Error): void
+                plugin(name: string, msg: string): void
+            }
+            ```
+
+        - #### PluginRegistry
+
+            ```typescript
+            class PluginRegistry {
+                constructor(logger: Logger)
+
+                register(plugin: CruxPlugin, app: AppInstance): Promise<void>
+                getAll(): CruxPlugin[]
+                callHook(hook: HookName, ctx: LifecycleContext): Promise<void>
+                collectRoutes(): RouteDefinition[]
+                collectSchemas(): TableSchema[]
+                collectMiddlewares(): Map<string, AppMiddleware>
+                collectStatic(): StaticConfig[]
+            }
+            ```
+
+        - #### ResourceMerger
+
+            ```typescript
+            class ResourceMerger {
+                constructor(logger: Logger)
+
+                mergeRoutes(userRoutes?: RouteDefinition[], pluginRoutes?: RouteDefinition[]): RouteDefinition[]
+                mergeSchemas(userSchemas?: TableSchema[], pluginSchemas?: TableSchema[]): TableSchema[]
+                mergeStatic(userStatic?: StaticConfig[], pluginStatic?: StaticConfig[]): StaticConfig[]
+            }
+            ```
+
+    <div align="center"> <img src="./assets/img/line.png" alt="line" style="display: block; margin-top:20px;margin-bottom:20px;width:500px;"/> <br> </div>
+
+    - ### FAQ
+
+        - #### Q: When should I use @cruxjs/base vs @cruxjs/app?
+
+            - Use `@cruxjs/base` when:
+
+                > Creating a plugin for the CruxJS ecosystem
+
+                > You only need types and utilities, not the full framework
+
+                > You want minimal dependencies in your plugin package
+
+            - Use `@cruxjs/app` when:
+
+              > Building a complete CruxJS application
+
+              > You need to orchestrate plugins and start a server
+
+        - #### Q: Can I use @cruxjs/base without @cruxjs/app?
+
+            > Absolutely! `@cruxjs/base` is a standalone package with no dependency on `@cruxjs/app`. Plugins can use it independently.
+
+        - #### Q: How does resource merging prioritize user-defined resources?
+
+            > **Routes & Schemas**: User-defined resources override plugins. If both define the same route (method + path) or schema (by name), user wins.
+
+            > **Static**: All configs are combined without deduplication.
+
+        - #### Q: What if two plugins define the same route?
+
+            > The first plugin to register wins. However, if the user defines the same route, the user's definition takes priority. Use the `debug` flag to see what's being merged.
+
+<!-- ╚═════════════════════════════════════════════════════════════════╝ -->
+
+<!-- ╔══════════════════════════════ END ══════════════════════════════╗ -->
+
+<br>
+
+---
+
+<div align="center">
+    <a href="https://github.com/maysara-elshewehy"><img src="https://img.shields.io/badge/by-Maysara-black"/></a>
+</div>
+
+<!-- ╚═════════════════════════════════════════════════════════════════╝ -->

package/dist/index.cjs

@@ -0,0 +1,3 @@
+'use strict';var g=class{constructor(e=false){this.debug=e;}phase(e){this.debug&&console.log(`
+[CruxJS] \u26A1 Phase: ${e}`);}info(e){this.debug&&console.log(`[CruxJS] ${e}`);}success(e){this.debug&&console.log(`[CruxJS] \u2713 ${e}`);}error(e,t){console.error(`[CruxJS] \u2717 ${e}`),t&&console.error(t);}plugin(e,t){this.debug&&console.log(`[CruxJS:${e}] ${t}`);}};var a=class{constructor(e){this.logger=e;}mergeRoutes(e=[],t=[]){let o=[...e],i=new Set(e.map(s=>`${s.method}:${s.path}`));for(let s of t){let n=`${s.method}:${s.path}`;i.has(n)?this.logger.info(`Skipping plugin route ${n} (overridden by user)`):o.push(s);}return o}mergeSchemas(e=[],t=[]){let o=[...e],i=new Set(e.map(s=>s.name));for(let s of t)i.has(s.name)?this.logger.info(`Skipping plugin schema ${s.name} (overridden by user)`):o.push(s);return o}mergeStatic(e=[],t=[]){return [...e,...t]}};var l=class{constructor(e){this.plugins=[];this.logger=e;}async register(e,t){this.logger.info(`Registering plugin: ${e.name}`),this.plugins.push(e),e.onRegister&&await e.onRegister(t),this.logger.success(`Plugin registered: ${e.name} v${e.version}`);}getAll(){return this.plugins}async callHook(e,t){for(let o of this.plugins)o[e]&&(this.logger.plugin(o.name,`Calling ${e}`),await o[e](t));}collectRoutes(){let e=[];for(let t of this.plugins)t.routes&&(e.push(...t.routes),this.logger.plugin(t.name,`Provided ${t.routes.length} routes`));return e}collectSchemas(){let e=[];for(let t of this.plugins)t.schemas&&(e.push(...t.schemas),this.logger.plugin(t.name,`Provided ${t.schemas.length} schemas`));return e}collectMiddlewares(){let e=new Map;for(let t of this.plugins)if(t.middlewares)for(let o of t.middlewares)e.set(`${t.name}:${o.name}`,o.handler),this.logger.plugin(t.name,`Provided middleware: ${o.name}`);return e}collectStatic(){let e=[];for(let t of this.plugins)t.static&&(e.push(...t.static),this.logger.plugin(t.name,`Provided ${t.static.length} static configs`));return e}};exports.Logger=g;exports.PluginRegistry=l;exports.ResourceMerger=a;//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mod/logger.ts","../src/mod/resource_merger.ts","../src/mod/plugin_registry.ts"],"names":["Logger","debug","name","msg","err","ResourceMerger","logger","userRoutes","pluginRoutes","merged","userPaths","r","route","key","userSchemas","pluginSchemas","userTables","schema","userStatic","pluginStatic","PluginRegistry","plugin","app","hook","ctx","routes","schemas","middlewares","mw","statics"],"mappings":"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","file":"index.cjs","sourcesContent":["// src/mod/logger.ts\r\n//\r\n// Made with ❤️ by Maysara.\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗\r\n\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ CORE ════════════════════════════════════════╗\r\n\r\n    export class Logger {\r\n        constructor(private debug: boolean = false) {}\r\n\r\n        phase(name: string) {\r\n            if (!this.debug) return;\r\n            console.log(`\\n[CruxJS] ⚡ Phase: ${name}`);\r\n        }\r\n\r\n        info(msg: string) {\r\n            if (!this.debug) return;\r\n            console.log(`[CruxJS] ${msg}`);\r\n        }\r\n\r\n        success(msg: string) {\r\n            if (!this.debug) return;\r\n            console.log(`[CruxJS] ✓ ${msg}`);\r\n        }\r\n\r\n        error(msg: string, err?: Error) {\r\n            console.error(`[CruxJS] ✗ ${msg}`);\r\n            if (err) console.error(err);\r\n        }\r\n\r\n        plugin(name: string, msg: string) {\r\n            if (!this.debug) return;\r\n            console.log(`[CruxJS:${name}] ${msg}`);\r\n        }\r\n    }\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝","// src/mod/resource_merger.ts\r\n//\r\n// Made with ❤️ by Maysara.\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗\r\n\r\n    import { RouteDefinition, TableSchema, StaticConfig } from '../types';\r\n    import { Logger } from './logger';\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ CORE ════════════════════════════════════════╗\r\n\r\n    export class ResourceMerger {\r\n        private logger: Logger;\r\n\r\n        constructor(logger: Logger) {\r\n            this.logger = logger;\r\n        }\r\n\r\n        mergeRoutes(\r\n            userRoutes: RouteDefinition[] = [],\r\n            pluginRoutes: RouteDefinition[] = []\r\n        ): RouteDefinition[] {\r\n            // User routes have priority\r\n            const merged = [...userRoutes];\r\n            const userPaths = new Set(userRoutes.map(r => `${r.method}:${r.path}`));\r\n\r\n            for (const route of pluginRoutes) {\r\n                const key = `${route.method}:${route.path}`;\r\n\r\n                if (!userPaths.has(key)) {\r\n                    merged.push(route);\r\n                } else {\r\n                    this.logger.info(`Skipping plugin route ${key} (overridden by user)`);\r\n                }\r\n            }\r\n\r\n            return merged;\r\n        }\r\n\r\n        mergeSchemas(\r\n            userSchemas: TableSchema[] = [],\r\n            pluginSchemas: TableSchema[] = []\r\n        ): TableSchema[] {\r\n            // User schemas have priority\r\n            const merged = [...userSchemas];\r\n            const userTables = new Set(userSchemas.map(s => s.name));\r\n\r\n            for (const schema of pluginSchemas) {\r\n                if (!userTables.has(schema.name)) {\r\n                    merged.push(schema);\r\n                } else {\r\n                    this.logger.info(`Skipping plugin schema ${schema.name} (overridden by user)`);\r\n                }\r\n            }\r\n\r\n            return merged;\r\n        }\r\n\r\n        mergeStatic(\r\n            userStatic: StaticConfig[] = [],\r\n            pluginStatic: StaticConfig[] = []\r\n        ): StaticConfig[] {\r\n            return [...userStatic, ...pluginStatic];\r\n        }\r\n    }\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝","// src/mod/plugin_registry.ts\r\n//\r\n// Made with ❤️ by Maysara.\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗\r\n\r\n    import * as types from '../types';\r\n    import { Logger } from './logger';\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ CORE ════════════════════════════════════════╗\r\n\r\n    export class PluginRegistry {\r\n        private plugins: types.CruxPlugin[] = [];\r\n        private logger: Logger;\r\n\r\n        constructor(logger: Logger) {\r\n            this.logger = logger;\r\n        }\r\n\r\n        async register(plugin: types.CruxPlugin, app: types.AppInstance) {\r\n            this.logger.info(`Registering plugin: ${plugin.name}`);\r\n\r\n            this.plugins.push(plugin);\r\n\r\n            // Call plugin's onRegister hook\r\n            if (plugin.onRegister) {\r\n                await plugin.onRegister(app);\r\n            }\r\n\r\n            this.logger.success(`Plugin registered: ${plugin.name} v${plugin.version}`);\r\n        }\r\n\r\n        getAll(): types.CruxPlugin[] {\r\n            return this.plugins;\r\n        }\r\n\r\n        async callHook(\r\n            hook: keyof Pick<types.CruxPlugin, 'onAwake' | 'onStart' | 'onReady' | 'onShutdown'>,\r\n            ctx: types.LifecycleContext\r\n        ) {\r\n            for (const plugin of this.plugins) {\r\n                if (plugin[hook]) {\r\n                    this.logger.plugin(plugin.name, `Calling ${hook}`);\r\n                    await plugin[hook]!(ctx);\r\n                }\r\n            }\r\n        }\r\n\r\n        collectRoutes(): types.RouteDefinition[] {\r\n            const routes: types.RouteDefinition[] = [];\r\n\r\n            for (const plugin of this.plugins) {\r\n                if (plugin.routes) {\r\n                    routes.push(...plugin.routes);\r\n                    this.logger.plugin(plugin.name, `Provided ${plugin.routes.length} routes`);\r\n                }\r\n            }\r\n\r\n            return routes;\r\n        }\r\n\r\n        collectSchemas(): types.TableSchema[] {\r\n            const schemas: types.TableSchema[] = [];\r\n\r\n            for (const plugin of this.plugins) {\r\n                if (plugin.schemas) {\r\n                    schemas.push(...plugin.schemas);\r\n                    this.logger.plugin(plugin.name, `Provided ${plugin.schemas.length} schemas`);\r\n                }\r\n            }\r\n\r\n            return schemas;\r\n        }\r\n\r\n        collectMiddlewares(): Map<string, types.AppMiddleware> {\r\n            const middlewares = new Map<string, types.AppMiddleware>();\r\n\r\n            for (const plugin of this.plugins) {\r\n            if (plugin.middlewares) {\r\n                for (const mw of plugin.middlewares) {\r\n                    middlewares.set(`${plugin.name}:${mw.name}`, mw.handler);\r\n                    this.logger.plugin(plugin.name, `Provided middleware: ${mw.name}`);\r\n                }\r\n            }\r\n            }\r\n\r\n            return middlewares;\r\n        }\r\n\r\n        collectStatic(): types.StaticConfig[] {\r\n            const statics: types.StaticConfig[] = [];\r\n\r\n            for (const plugin of this.plugins) {\r\n                if (plugin.static) {\r\n                    statics.push(...plugin.static);\r\n                    this.logger.plugin(plugin.name, `Provided ${plugin.static.length} static configs`);\r\n                }\r\n            }\r\n\r\n            return statics;\r\n        }\r\n    }\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝"]}

package/dist/index.d.cts

@@ -0,0 +1,164 @@
+import { TableSchema as TableSchema$1, DB } from '@minejs/db';
+import { AppContext as AppContext$1 } from '@minejs/server';
+
+type AppContext = AppContext$1;
+type TableSchema = TableSchema$1;
+interface CruxPlugin {
+    name: string;
+    version: string;
+    routes?: RouteDefinition[];
+    schemas?: TableSchema$1[];
+    middlewares?: MiddlewareExport[];
+    static?: StaticConfig[];
+    onRegister?: (app: AppInstance) => void | Promise<void>;
+    onAwake?: (ctx: LifecycleContext) => void | Promise<void>;
+    onStart?: (ctx: LifecycleContext) => void | Promise<void>;
+    onReady?: (ctx: LifecycleContext) => void | Promise<void>;
+    onShutdown?: (ctx: LifecycleContext) => void | Promise<void>;
+}
+interface MiddlewareExport {
+    name: string;
+    handler: AppMiddleware;
+}
+type AppMiddleware = (c: AppContext$1, next: () => void | Promise<void>) => any;
+interface AppConfig {
+    server?: {
+        port?: number;
+        host?: string;
+        logging?: boolean | {
+            level?: 'debug' | 'info' | 'warn' | 'error';
+            pretty?: boolean;
+        };
+    };
+    client?: {
+        entry: string;
+        output: string;
+        minify?: boolean;
+        sourcemap?: boolean;
+        target?: 'browser' | 'bun';
+        external?: string[];
+    };
+    database?: {
+        connection: string;
+        schema?: string;
+        name?: string;
+        timeout?: number;
+    } | {
+        connection: string;
+        schema?: string;
+        name?: string;
+        timeout?: number;
+    }[];
+    i18n?: {
+        defaultLanguage: string;
+        supportedLanguages: string[];
+        basePath: string;
+        fileExtension?: string;
+    };
+    static?: {
+        path: string;
+        directory: string;
+        maxAge?: number;
+        index?: string[];
+    } | {
+        path: string;
+        directory: string;
+        maxAge?: number;
+        index?: string[];
+    }[];
+    api?: {
+        path: string;
+        directory: string;
+        autoLoad?: boolean;
+    };
+    security?: {
+        cors?: boolean | {
+            origin?: string | string[];
+            credentials?: boolean;
+            maxAge?: number;
+        };
+        rateLimit?: boolean | {
+            windowMs?: number;
+            max?: number;
+        };
+    };
+    routes?: RouteDefinition[];
+    middlewares?: AppMiddleware[];
+    plugins?: CruxPlugin[];
+    debug?: boolean;
+}
+interface RouteDefinition {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'OPTIONS' | 'HEAD' | ('GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'OPTIONS' | 'HEAD')[];
+    path: string;
+    handler: (c: AppContext$1) => any;
+    middlewares?: AppMiddleware[];
+}
+interface StaticConfig {
+    path: string;
+    directory: string;
+    maxAge?: number;
+    index?: string[];
+}
+interface LifecycleContext {
+    config: AppConfig;
+    databases: Map<string, DB>;
+    plugins: CruxPlugin[];
+    server?: any;
+    clientBuild?: {
+        success: boolean;
+        outputs: string[];
+    };
+}
+interface LifecycleHooks {
+    onConfig?: (config: AppConfig) => AppConfig | Promise<AppConfig>;
+    onAwake?: (ctx: LifecycleContext) => void | Promise<void>;
+    onStart?: (ctx: LifecycleContext) => void | Promise<void>;
+    onReady?: (ctx: LifecycleContext) => void | Promise<void>;
+    onFinish?: (ctx: LifecycleContext) => void | Promise<void>;
+    onError?: (ctx: LifecycleContext, phase: string, error: Error) => void | Promise<void>;
+}
+interface AppInstance {
+    config: AppConfig;
+    server: any;
+    databases: Map<string, DB>;
+    plugins: CruxPlugin[];
+    middlewares: Map<string, AppMiddleware>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    restart(): Promise<void>;
+    getContext(): LifecycleContext;
+    getMiddleware(name: string): AppMiddleware | undefined;
+}
+
+declare class Logger {
+    private debug;
+    constructor(debug?: boolean);
+    phase(name: string): void;
+    info(msg: string): void;
+    success(msg: string): void;
+    error(msg: string, err?: Error): void;
+    plugin(name: string, msg: string): void;
+}
+
+declare class ResourceMerger {
+    private logger;
+    constructor(logger: Logger);
+    mergeRoutes(userRoutes?: RouteDefinition[], pluginRoutes?: RouteDefinition[]): RouteDefinition[];
+    mergeSchemas(userSchemas?: TableSchema[], pluginSchemas?: TableSchema[]): TableSchema[];
+    mergeStatic(userStatic?: StaticConfig[], pluginStatic?: StaticConfig[]): StaticConfig[];
+}
+
+declare class PluginRegistry {
+    private plugins;
+    private logger;
+    constructor(logger: Logger);
+    register(plugin: CruxPlugin, app: AppInstance): Promise<void>;
+    getAll(): CruxPlugin[];
+    callHook(hook: keyof Pick<CruxPlugin, 'onAwake' | 'onStart' | 'onReady' | 'onShutdown'>, ctx: LifecycleContext): Promise<void>;
+    collectRoutes(): RouteDefinition[];
+    collectSchemas(): TableSchema[];
+    collectMiddlewares(): Map<string, AppMiddleware>;
+    collectStatic(): StaticConfig[];
+}
+
+export { type AppConfig, type AppContext, type AppInstance, type AppMiddleware, type CruxPlugin, type LifecycleContext, type LifecycleHooks, Logger, type MiddlewareExport, PluginRegistry, ResourceMerger, type RouteDefinition, type StaticConfig, type TableSchema };

package/dist/index.d.ts

@@ -0,0 +1,164 @@
+import { TableSchema as TableSchema$1, DB } from '@minejs/db';
+import { AppContext as AppContext$1 } from '@minejs/server';
+
+type AppContext = AppContext$1;
+type TableSchema = TableSchema$1;
+interface CruxPlugin {
+    name: string;
+    version: string;
+    routes?: RouteDefinition[];
+    schemas?: TableSchema$1[];
+    middlewares?: MiddlewareExport[];
+    static?: StaticConfig[];
+    onRegister?: (app: AppInstance) => void | Promise<void>;
+    onAwake?: (ctx: LifecycleContext) => void | Promise<void>;
+    onStart?: (ctx: LifecycleContext) => void | Promise<void>;
+    onReady?: (ctx: LifecycleContext) => void | Promise<void>;
+    onShutdown?: (ctx: LifecycleContext) => void | Promise<void>;
+}
+interface MiddlewareExport {
+    name: string;
+    handler: AppMiddleware;
+}
+type AppMiddleware = (c: AppContext$1, next: () => void | Promise<void>) => any;
+interface AppConfig {
+    server?: {
+        port?: number;
+        host?: string;
+        logging?: boolean | {
+            level?: 'debug' | 'info' | 'warn' | 'error';
+            pretty?: boolean;
+        };
+    };
+    client?: {
+        entry: string;
+        output: string;
+        minify?: boolean;
+        sourcemap?: boolean;
+        target?: 'browser' | 'bun';
+        external?: string[];
+    };
+    database?: {
+        connection: string;
+        schema?: string;
+        name?: string;
+        timeout?: number;
+    } | {
+        connection: string;
+        schema?: string;
+        name?: string;
+        timeout?: number;
+    }[];
+    i18n?: {
+        defaultLanguage: string;
+        supportedLanguages: string[];
+        basePath: string;
+        fileExtension?: string;
+    };
+    static?: {
+        path: string;
+        directory: string;
+        maxAge?: number;
+        index?: string[];
+    } | {
+        path: string;
+        directory: string;
+        maxAge?: number;
+        index?: string[];
+    }[];
+    api?: {
+        path: string;
+        directory: string;
+        autoLoad?: boolean;
+    };
+    security?: {
+        cors?: boolean | {
+            origin?: string | string[];
+            credentials?: boolean;
+            maxAge?: number;
+        };
+        rateLimit?: boolean | {
+            windowMs?: number;
+            max?: number;
+        };
+    };
+    routes?: RouteDefinition[];
+    middlewares?: AppMiddleware[];
+    plugins?: CruxPlugin[];
+    debug?: boolean;
+}
+interface RouteDefinition {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'OPTIONS' | 'HEAD' | ('GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'OPTIONS' | 'HEAD')[];
+    path: string;
+    handler: (c: AppContext$1) => any;
+    middlewares?: AppMiddleware[];
+}
+interface StaticConfig {
+    path: string;
+    directory: string;
+    maxAge?: number;
+    index?: string[];
+}
+interface LifecycleContext {
+    config: AppConfig;
+    databases: Map<string, DB>;
+    plugins: CruxPlugin[];
+    server?: any;
+    clientBuild?: {
+        success: boolean;
+        outputs: string[];
+    };
+}
+interface LifecycleHooks {
+    onConfig?: (config: AppConfig) => AppConfig | Promise<AppConfig>;
+    onAwake?: (ctx: LifecycleContext) => void | Promise<void>;
+    onStart?: (ctx: LifecycleContext) => void | Promise<void>;
+    onReady?: (ctx: LifecycleContext) => void | Promise<void>;
+    onFinish?: (ctx: LifecycleContext) => void | Promise<void>;
+    onError?: (ctx: LifecycleContext, phase: string, error: Error) => void | Promise<void>;
+}
+interface AppInstance {
+    config: AppConfig;
+    server: any;
+    databases: Map<string, DB>;
+    plugins: CruxPlugin[];
+    middlewares: Map<string, AppMiddleware>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    restart(): Promise<void>;
+    getContext(): LifecycleContext;
+    getMiddleware(name: string): AppMiddleware | undefined;
+}
+
+declare class Logger {
+    private debug;
+    constructor(debug?: boolean);
+    phase(name: string): void;
+    info(msg: string): void;
+    success(msg: string): void;
+    error(msg: string, err?: Error): void;
+    plugin(name: string, msg: string): void;
+}
+
+declare class ResourceMerger {
+    private logger;
+    constructor(logger: Logger);
+    mergeRoutes(userRoutes?: RouteDefinition[], pluginRoutes?: RouteDefinition[]): RouteDefinition[];
+    mergeSchemas(userSchemas?: TableSchema[], pluginSchemas?: TableSchema[]): TableSchema[];
+    mergeStatic(userStatic?: StaticConfig[], pluginStatic?: StaticConfig[]): StaticConfig[];
+}
+
+declare class PluginRegistry {
+    private plugins;
+    private logger;
+    constructor(logger: Logger);
+    register(plugin: CruxPlugin, app: AppInstance): Promise<void>;
+    getAll(): CruxPlugin[];
+    callHook(hook: keyof Pick<CruxPlugin, 'onAwake' | 'onStart' | 'onReady' | 'onShutdown'>, ctx: LifecycleContext): Promise<void>;
+    collectRoutes(): RouteDefinition[];
+    collectSchemas(): TableSchema[];
+    collectMiddlewares(): Map<string, AppMiddleware>;
+    collectStatic(): StaticConfig[];
+}
+
+export { type AppConfig, type AppContext, type AppInstance, type AppMiddleware, type CruxPlugin, type LifecycleContext, type LifecycleHooks, Logger, type MiddlewareExport, PluginRegistry, ResourceMerger, type RouteDefinition, type StaticConfig, type TableSchema };

package/dist/index.js

@@ -0,0 +1,3 @@
+var g=class{constructor(e=false){this.debug=e;}phase(e){this.debug&&console.log(`
+[CruxJS] \u26A1 Phase: ${e}`);}info(e){this.debug&&console.log(`[CruxJS] ${e}`);}success(e){this.debug&&console.log(`[CruxJS] \u2713 ${e}`);}error(e,t){console.error(`[CruxJS] \u2717 ${e}`),t&&console.error(t);}plugin(e,t){this.debug&&console.log(`[CruxJS:${e}] ${t}`);}};var a=class{constructor(e){this.logger=e;}mergeRoutes(e=[],t=[]){let o=[...e],i=new Set(e.map(s=>`${s.method}:${s.path}`));for(let s of t){let n=`${s.method}:${s.path}`;i.has(n)?this.logger.info(`Skipping plugin route ${n} (overridden by user)`):o.push(s);}return o}mergeSchemas(e=[],t=[]){let o=[...e],i=new Set(e.map(s=>s.name));for(let s of t)i.has(s.name)?this.logger.info(`Skipping plugin schema ${s.name} (overridden by user)`):o.push(s);return o}mergeStatic(e=[],t=[]){return [...e,...t]}};var l=class{constructor(e){this.plugins=[];this.logger=e;}async register(e,t){this.logger.info(`Registering plugin: ${e.name}`),this.plugins.push(e),e.onRegister&&await e.onRegister(t),this.logger.success(`Plugin registered: ${e.name} v${e.version}`);}getAll(){return this.plugins}async callHook(e,t){for(let o of this.plugins)o[e]&&(this.logger.plugin(o.name,`Calling ${e}`),await o[e](t));}collectRoutes(){let e=[];for(let t of this.plugins)t.routes&&(e.push(...t.routes),this.logger.plugin(t.name,`Provided ${t.routes.length} routes`));return e}collectSchemas(){let e=[];for(let t of this.plugins)t.schemas&&(e.push(...t.schemas),this.logger.plugin(t.name,`Provided ${t.schemas.length} schemas`));return e}collectMiddlewares(){let e=new Map;for(let t of this.plugins)if(t.middlewares)for(let o of t.middlewares)e.set(`${t.name}:${o.name}`,o.handler),this.logger.plugin(t.name,`Provided middleware: ${o.name}`);return e}collectStatic(){let e=[];for(let t of this.plugins)t.static&&(e.push(...t.static),this.logger.plugin(t.name,`Provided ${t.static.length} static configs`));return e}};export{g as Logger,l as PluginRegistry,a as ResourceMerger};//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mod/logger.ts","../src/mod/resource_merger.ts","../src/mod/plugin_registry.ts"],"names":["Logger","debug","name","msg","err","ResourceMerger","logger","userRoutes","pluginRoutes","merged","userPaths","r","route","key","userSchemas","pluginSchemas","userTables","schema","userStatic","pluginStatic","PluginRegistry","plugin","app","hook","ctx","routes","schemas","middlewares","mw","statics"],"mappings":"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","file":"index.js","sourcesContent":["// src/mod/logger.ts\r\n//\r\n// Made with ❤️ by Maysara.\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗\r\n\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ CORE ════════════════════════════════════════╗\r\n\r\n    export class Logger {\r\n        constructor(private debug: boolean = false) {}\r\n\r\n        phase(name: string) {\r\n            if (!this.debug) return;\r\n            console.log(`\\n[CruxJS] ⚡ Phase: ${name}`);\r\n        }\r\n\r\n        info(msg: string) {\r\n            if (!this.debug) return;\r\n            console.log(`[CruxJS] ${msg}`);\r\n        }\r\n\r\n        success(msg: string) {\r\n            if (!this.debug) return;\r\n            console.log(`[CruxJS] ✓ ${msg}`);\r\n        }\r\n\r\n        error(msg: string, err?: Error) {\r\n            console.error(`[CruxJS] ✗ ${msg}`);\r\n            if (err) console.error(err);\r\n        }\r\n\r\n        plugin(name: string, msg: string) {\r\n            if (!this.debug) return;\r\n            console.log(`[CruxJS:${name}] ${msg}`);\r\n        }\r\n    }\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝","// src/mod/resource_merger.ts\r\n//\r\n// Made with ❤️ by Maysara.\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗\r\n\r\n    import { RouteDefinition, TableSchema, StaticConfig } from '../types';\r\n    import { Logger } from './logger';\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ CORE ════════════════════════════════════════╗\r\n\r\n    export class ResourceMerger {\r\n        private logger: Logger;\r\n\r\n        constructor(logger: Logger) {\r\n            this.logger = logger;\r\n        }\r\n\r\n        mergeRoutes(\r\n            userRoutes: RouteDefinition[] = [],\r\n            pluginRoutes: RouteDefinition[] = []\r\n        ): RouteDefinition[] {\r\n            // User routes have priority\r\n            const merged = [...userRoutes];\r\n            const userPaths = new Set(userRoutes.map(r => `${r.method}:${r.path}`));\r\n\r\n            for (const route of pluginRoutes) {\r\n                const key = `${route.method}:${route.path}`;\r\n\r\n                if (!userPaths.has(key)) {\r\n                    merged.push(route);\r\n                } else {\r\n                    this.logger.info(`Skipping plugin route ${key} (overridden by user)`);\r\n                }\r\n            }\r\n\r\n            return merged;\r\n        }\r\n\r\n        mergeSchemas(\r\n            userSchemas: TableSchema[] = [],\r\n            pluginSchemas: TableSchema[] = []\r\n        ): TableSchema[] {\r\n            // User schemas have priority\r\n            const merged = [...userSchemas];\r\n            const userTables = new Set(userSchemas.map(s => s.name));\r\n\r\n            for (const schema of pluginSchemas) {\r\n                if (!userTables.has(schema.name)) {\r\n                    merged.push(schema);\r\n                } else {\r\n                    this.logger.info(`Skipping plugin schema ${schema.name} (overridden by user)`);\r\n                }\r\n            }\r\n\r\n            return merged;\r\n        }\r\n\r\n        mergeStatic(\r\n            userStatic: StaticConfig[] = [],\r\n            pluginStatic: StaticConfig[] = []\r\n        ): StaticConfig[] {\r\n            return [...userStatic, ...pluginStatic];\r\n        }\r\n    }\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝","// src/mod/plugin_registry.ts\r\n//\r\n// Made with ❤️ by Maysara.\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗\r\n\r\n    import * as types from '../types';\r\n    import { Logger } from './logger';\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ CORE ════════════════════════════════════════╗\r\n\r\n    export class PluginRegistry {\r\n        private plugins: types.CruxPlugin[] = [];\r\n        private logger: Logger;\r\n\r\n        constructor(logger: Logger) {\r\n            this.logger = logger;\r\n        }\r\n\r\n        async register(plugin: types.CruxPlugin, app: types.AppInstance) {\r\n            this.logger.info(`Registering plugin: ${plugin.name}`);\r\n\r\n            this.plugins.push(plugin);\r\n\r\n            // Call plugin's onRegister hook\r\n            if (plugin.onRegister) {\r\n                await plugin.onRegister(app);\r\n            }\r\n\r\n            this.logger.success(`Plugin registered: ${plugin.name} v${plugin.version}`);\r\n        }\r\n\r\n        getAll(): types.CruxPlugin[] {\r\n            return this.plugins;\r\n        }\r\n\r\n        async callHook(\r\n            hook: keyof Pick<types.CruxPlugin, 'onAwake' | 'onStart' | 'onReady' | 'onShutdown'>,\r\n            ctx: types.LifecycleContext\r\n        ) {\r\n            for (const plugin of this.plugins) {\r\n                if (plugin[hook]) {\r\n                    this.logger.plugin(plugin.name, `Calling ${hook}`);\r\n                    await plugin[hook]!(ctx);\r\n                }\r\n            }\r\n        }\r\n\r\n        collectRoutes(): types.RouteDefinition[] {\r\n            const routes: types.RouteDefinition[] = [];\r\n\r\n            for (const plugin of this.plugins) {\r\n                if (plugin.routes) {\r\n                    routes.push(...plugin.routes);\r\n                    this.logger.plugin(plugin.name, `Provided ${plugin.routes.length} routes`);\r\n                }\r\n            }\r\n\r\n            return routes;\r\n        }\r\n\r\n        collectSchemas(): types.TableSchema[] {\r\n            const schemas: types.TableSchema[] = [];\r\n\r\n            for (const plugin of this.plugins) {\r\n                if (plugin.schemas) {\r\n                    schemas.push(...plugin.schemas);\r\n                    this.logger.plugin(plugin.name, `Provided ${plugin.schemas.length} schemas`);\r\n                }\r\n            }\r\n\r\n            return schemas;\r\n        }\r\n\r\n        collectMiddlewares(): Map<string, types.AppMiddleware> {\r\n            const middlewares = new Map<string, types.AppMiddleware>();\r\n\r\n            for (const plugin of this.plugins) {\r\n            if (plugin.middlewares) {\r\n                for (const mw of plugin.middlewares) {\r\n                    middlewares.set(`${plugin.name}:${mw.name}`, mw.handler);\r\n                    this.logger.plugin(plugin.name, `Provided middleware: ${mw.name}`);\r\n                }\r\n            }\r\n            }\r\n\r\n            return middlewares;\r\n        }\r\n\r\n        collectStatic(): types.StaticConfig[] {\r\n            const statics: types.StaticConfig[] = [];\r\n\r\n            for (const plugin of this.plugins) {\r\n                if (plugin.static) {\r\n                    statics.push(...plugin.static);\r\n                    this.logger.plugin(plugin.name, `Provided ${plugin.static.length} static configs`);\r\n                }\r\n            }\r\n\r\n            return statics;\r\n        }\r\n    }\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝"]}

package/package.json

@@ -0,0 +1,58 @@
+{
+	"name": "@cruxjs/base",
+	"version": "0.0.1",
+	"description": "Core types and utilities for building CruxJS applications and plugins. A shared foundation for @cruxjs/app and plugin packages.",
+	"keywords": ["cruxjs", "base", "types"],
+	"license": "MIT",
+	"homepage": "https://github.com/cruxjs-org/base#readme",
+	"bugs": {
+		"url": "https://github.com/cruxjs-org/base/issues"
+	},
+	"author": {
+		"name": "Maysara",
+		"email": "maysara.elshewehy@gmail.com",
+		"url": "https://github.com/maysara-elshewehy"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/cruxjs-org/base.git"
+	},
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": ["dist"],
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"require": "./dist/index.js"
+		}
+	},
+	"scripts": {
+		"build": "tsup",
+		"lint": "eslint src --ext .ts",
+		"test": "bun test"
+	},
+	"engines": {
+		"bun": ">=1.3.3"
+	},
+	"peerDependencies": {
+		"bun": "^1.3.3"
+	},
+	"dependencies": {
+		"@minejs/db": "^0.0.3",
+		"@minejs/server": "^0.0.5"
+	},
+	"devDependencies": {
+		"@eslint/js": "^9.39.2",
+		"@stylistic/eslint-plugin": "^5.6.1",
+		"@types/bun": "^1.3.5",
+		"@types/node": "^20.19.27",
+		"bun-plugin-dts": "^0.3.0",
+		"bun-types": "^1.3.5",
+		"ts-node": "^10.9.2",
+		"tsup": "^8.5.1",
+		"typescript": "^5.9.3",
+		"typescript-eslint": "^8.51.0"
+	}
+}