@razvan11/paladin 1.0.8 → 1.1.0

package/dist/app/app.d.ts

@@ -4,6 +4,7 @@ import { Hono } from 'hono';
 import '../container/container';
 import type { AppConfigOptions, ValidatorType } from '../types';
 type ControllerClass = new (...args: any[]) => any;
+type WebSocketClass = new (...args: any[]) => any;
 export interface StaticOptions {
     /** URL path prefix (e.g., '/static') */
     path?: string;
@@ -17,6 +18,8 @@ export declare class App {
     readonly validators?: ValidatorType;
     private cors;
     private logger;
+    private wsHandlers;
+    private server;
     constructor(options: AppConfigOptions);
     init(): void;
     /**
@@ -33,6 +36,15 @@ export declare class App {
      * Register multiple controllers at once
      */
     registerControllers(...controllers: ControllerClass[]): this;
+    /**
+     * Register a WebSocket handler with the app
+     * Reads handler metadata and stores event handlers
+     */
+    registerWebSocket(WSClass: WebSocketClass): this;
+    /**
+     * Register multiple WebSocket handlers at once
+     */
+    registerWebSockets(...handlers: WebSocketClass[]): this;
     /**
      * Normalize and combine path segments
      */

package/dist/container/container.d.ts

@@ -1,8 +1,6 @@
 import { Container } from 'inversify';
 export declare const CONTAINER_KEYS: {
     readonly APP_NAME: symbol;
-    readonly APP_DATABASE_URL: symbol;
-    readonly APP_URL: symbol;
     readonly APP_SECRET: symbol;
     readonly APP_CWD: symbol;
     readonly APP_PUBLIC_DIR: symbol;
@@ -11,7 +9,6 @@ export declare const CONTAINER_KEYS: {
     readonly APP_IS_STAGING: symbol;
     readonly APP_IS_PRODUCTION: symbol;
     readonly APP_DEBUG: symbol;
-    readonly APP_ENV: symbol;
 };
 declare const container: Container;
 export { container };

package/dist/functions/middleware.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/functions/websocket.d.ts

@@ -0,0 +1,29 @@
+export declare const WEBSOCKET_METADATA: unique symbol;
+export declare const WS_HANDLERS_METADATA: unique symbol;
+export interface WSHandlerDefinition {
+    event: 'message' | 'open' | 'close' | 'drain';
+    handlerName: string | symbol;
+}
+/**
+ * @websocket decorator
+ * Marks a class as a WebSocket handler and registers it with the DI container
+ *
+ * @param path - The WebSocket endpoint path (e.g., '/chat')
+ */
+export declare function websocket(path?: string): <T extends new (...args: any[]) => any>(constructor: T) => T;
+/**
+ * @onMessage decorator - Handles incoming WebSocket messages
+ */
+export declare const onMessage: () => MethodDecorator;
+/**
+ * @onOpen decorator - Handles WebSocket connection open
+ */
+export declare const onOpen: () => MethodDecorator;
+/**
+ * @onClose decorator - Handles WebSocket connection close
+ */
+export declare const onClose: () => MethodDecorator;
+/**
+ * @onDrain decorator - Handles WebSocket backpressure drain
+ */
+export declare const onDrain: () => MethodDecorator;

package/dist/index.d.ts

@@ -15,6 +15,7 @@ export { default as config } from './functions/config';
 export { default as validator } from './functions/validator';
 export { default as env } from './functions/env';
 export { getDataSourceForCLI } from './functions/database';
+export { websocket, onMessage, onOpen, onClose, onDrain, WEBSOCKET_METADATA, WS_HANDLERS_METADATA, type WSHandlerDefinition, } from './functions/websocket';
 export { render, renderElement, createRenderer } from './functions/render';
 export { LayoutView, PageLoader, type LayoutViewProps, } from './components/LayoutView';
 export { asset, publicAsset, setAssetBasePath, getAssetBasePath, } from './functions/asset';

package/dist/index.js

@@ -15026,10 +15026,10 @@ var require_PrettyError = __commonJS((exports, module) => {
   }
 });
 
-// src/index.ts
+// framework/index.ts
 var import_reflect_metadata2 = __toESM(require_Reflect(), 1);
 
-// src/app/app.ts
+// framework/app/app.ts
 var import_reflect_metadata = __toESM(require_Reflect(), 1);
 
 // node_modules/hono/dist/compose.js
@@ -18893,11 +18893,9 @@ class ne {
     return a3.#h.planResultCacheService.subscribe(r2), new W2(v.build(() => a3.#h.activationService), T.build(() => a3.#h.bindingService, t4), j.build(() => a3.#h.deactivationService), r2);
   }
 }
-// src/container/container.ts
+// framework/container/container.ts
 var CONTAINER_KEYS = {
   APP_NAME: Symbol.for("app.name"),
-  APP_DATABASE_URL: Symbol.for("app.databaseUrl"),
-  APP_URL: Symbol.for("app.url"),
   APP_SECRET: Symbol.for("app.secret"),
   APP_CWD: Symbol.for("app.cwd"),
   APP_PUBLIC_DIR: Symbol.for("app.publicDir"),
@@ -18905,8 +18903,7 @@ var CONTAINER_KEYS = {
   APP_IS_DEVELOPMENT: Symbol.for("app.isDevelopment"),
   APP_IS_STAGING: Symbol.for("app.isStaging"),
   APP_IS_PRODUCTION: Symbol.for("app.isProduction"),
-  APP_DEBUG: Symbol.for("app.debug"),
-  APP_ENV: Symbol.for("app.env")
+  APP_DEBUG: Symbol.for("app.debug")
 };
 var container = new ne({
   defaultScope: "Singleton"
@@ -19402,7 +19399,7 @@ var chalk = createChalk();
 var chalkStderr = createChalk({ level: stderrColor ? stderrColor.level : 0 });
 var source_default = chalk;
 
-// src/logger/logger.ts
+// framework/logger/logger.ts
 var import_pretty_error = __toESM(require_PrettyError(), 1);
 
 class Logger {
@@ -19784,7 +19781,7 @@ var upgradeWebSocket = defineWebSocketHelper((c3, events) => {
   return;
 });
 
-// src/functions/controller.ts
+// framework/functions/controller.ts
 var getContainer = () => globalThis.container;
 var CONTROLLER_METADATA = Symbol("controller:prefix");
 var ROUTES_METADATA = Symbol("controller:routes");
@@ -19825,7 +19822,7 @@ var del = createMethodDecorator("delete");
 var options = createMethodDecorator("options");
 var all = createMethodDecorator("all");
 
-// src/functions/asset.ts
+// framework/functions/asset.ts
 var assetBasePath = "/static";
 function setAssetBasePath(basePath) {
   assetBasePath = basePath.startsWith("/") ? basePath : `/${basePath}`;
@@ -19843,8 +19840,44 @@ function publicAsset(filename) {
   return `${assetBasePath}/${normalizedFilename}`.replace(/\/+/g, "/");
 }
 
-// src/app/app.ts
+// framework/functions/websocket.ts
 var getContainer2 = () => globalThis.container;
+var WEBSOCKET_METADATA = Symbol("websocket:path");
+var WS_HANDLERS_METADATA = Symbol("websocket:handlers");
+function websocket2(path = "/ws") {
+  return (constructor) => {
+    W()(constructor);
+    Reflect.defineMetadata(WEBSOCKET_METADATA, path, constructor);
+    if (!Reflect.hasMetadata(WS_HANDLERS_METADATA, constructor)) {
+      Reflect.defineMetadata(WS_HANDLERS_METADATA, [], constructor);
+    }
+    const container2 = getContainer2();
+    if (container2 && !container2.isBound(constructor)) {
+      container2.bind(constructor).toSelf().inSingletonScope();
+    }
+    return constructor;
+  };
+}
+function createWSEventDecorator(event) {
+  return () => {
+    return (target, propertyKey, _descriptor) => {
+      const constructor = target.constructor;
+      const handlers = Reflect.getMetadata(WS_HANDLERS_METADATA, constructor) || [];
+      handlers.push({
+        event,
+        handlerName: propertyKey
+      });
+      Reflect.defineMetadata(WS_HANDLERS_METADATA, handlers, constructor);
+    };
+  };
+}
+var onMessage = createWSEventDecorator("message");
+var onOpen = createWSEventDecorator("open");
+var onClose = createWSEventDecorator("close");
+var onDrain = createWSEventDecorator("drain");
+
+// framework/app/app.ts
+var getContainer3 = () => globalThis.container;
 
 class App {
   app;
@@ -19853,17 +19886,18 @@ class App {
   validators;
   cors;
   logger;
+  wsHandlers = new Map;
+  server = null;
   constructor(options2) {
     this.app = new Hono2;
     this.name = options2.name;
-    this.container = getContainer2();
+    this.container = getContainer3();
     this.validators = options2.validators;
     this.logger = new Logger;
     this.cors = options2.cors || ["*"];
     this.init();
   }
   init() {
-    console.log(this.cors);
     this.app.use("/*", cors({
       origin: this.cors,
       allowHeaders: ["Content-Type", "Authorization"],
@@ -19902,6 +19936,26 @@ class App {
     }
     return this;
   }
+  registerWebSocket(WSClass) {
+    const path = Reflect.getMetadata(WEBSOCKET_METADATA, WSClass) || "/ws";
+    const handlers = Reflect.getMetadata(WS_HANDLERS_METADATA, WSClass) || [];
+    const instance = this.container.get(WSClass);
+    const handlerMap = {};
+    for (const handler of handlers) {
+      handlerMap[handler.event] = instance[handler.handlerName].bind(instance);
+    }
+    this.wsHandlers.set(path, handlerMap);
+    if (Bun.env.APP_ENV === "local") {
+      this.logger.info(`  WS      ${path}`);
+    }
+    return this;
+  }
+  registerWebSockets(...handlers) {
+    for (const handler of handlers) {
+      this.registerWebSocket(handler);
+    }
+    return this;
+  }
   normalizePath(prefix, path) {
     const normalizedPrefix = prefix.startsWith("/") ? prefix : `/${prefix}`;
     const normalizedPath = path.startsWith("/") ? path : `/${path}`;
@@ -19914,6 +19968,18 @@ class App {
     return this.app;
   }
   async run() {
+    const self2 = this;
+    this.wsHandlers.forEach((_3, path) => {
+      this.app.get(path, (c3) => {
+        const upgraded = self2.server?.upgrade(c3.req.raw, {
+          data: { path }
+        });
+        if (upgraded) {
+          return new Response(null, { status: 101 });
+        }
+        return c3.text("WebSocket upgrade failed", 400);
+      });
+    });
     try {
       const server = Bun.serve({
         port: 3000,
@@ -19921,12 +19987,29 @@ class App {
         development: false,
         fetch: this.app.fetch,
         websocket: {
-          message(ws, message) {},
-          open(ws) {},
-          close(ws, code, message) {},
-          drain(ws) {}
+          message(ws, message) {
+            const wsPath = ws.data?.path;
+            const handlers = self2.wsHandlers.get(wsPath);
+            handlers?.message?.(ws, message);
+          },
+          open(ws) {
+            const wsPath = ws.data?.path;
+            const handlers = self2.wsHandlers.get(wsPath);
+            handlers?.open?.(ws);
+          },
+          close(ws, code, message) {
+            const wsPath = ws.data?.path;
+            const handlers = self2.wsHandlers.get(wsPath);
+            handlers?.close?.(ws, code, message);
+          },
+          drain(ws) {
+            const wsPath = ws.data?.path;
+            const handlers = self2.wsHandlers.get(wsPath);
+            handlers?.drain?.(ws);
+          }
         }
       });
+      this.server = server;
       this.logger.success(`Server started on port ${server.port}`);
       return server;
     } catch (error) {
@@ -19939,42 +20022,42 @@ class App {
     }
   }
 }
-// src/functions/inject.ts
+// framework/functions/inject.ts
 function inject(identifier) {
   return U(identifier);
 }
-// src/functions/service.ts
-var getContainer3 = () => globalThis.container;
+// framework/functions/service.ts
+var getContainer4 = () => globalThis.container;
 function service() {
   return (constructor) => {
     W()(constructor);
-    const container2 = getContainer3();
+    const container2 = getContainer4();
     if (container2 && !container2.isBound(constructor)) {
       container2.bind(constructor).toSelf().inSingletonScope();
     }
     return constructor;
   };
 }
-// src/functions/repository.ts
-var getContainer4 = () => globalThis.container;
+// framework/functions/repository.ts
+var getContainer5 = () => globalThis.container;
 function repository() {
   return (constructor) => {
     W()(constructor);
-    const container2 = getContainer4();
+    const container2 = getContainer5();
     if (container2 && !container2.isBound(constructor)) {
       container2.bind(constructor).toSelf().inSingletonScope();
     }
     return constructor;
   };
 }
-// src/functions/database.ts
-var getContainer5 = () => globalThis.container;
+// framework/functions/database.ts
+var getContainer6 = () => globalThis.container;
 var databaseRegistry = new Map;
 function database(options2 = {}) {
   return (constructor) => {
     W()(constructor);
     databaseRegistry.set(constructor, options2);
-    const container2 = getContainer5();
+    const container2 = getContainer6();
     if (container2 && !container2.isBound(constructor)) {
       container2.bind(constructor).toSelf().inSingletonScope();
     }
@@ -19993,12 +20076,12 @@ function getDataSourceForCLI(DatabaseClass, url) {
   }
   return source;
 }
-// src/functions/config.ts
-var getContainer6 = () => globalThis.container;
+// framework/functions/config.ts
+var getContainer7 = () => globalThis.container;
 function config() {
   return (_target) => {
     for (const [key, value] of Object.entries(CONTAINER_KEYS)) {
-      getContainer6().bind(value).toConstantValue(Bun.env[key]);
+      getContainer7().bind(value).toConstantValue(Bun.env[key]);
     }
   };
 }
@@ -20869,14 +20952,14 @@ function validate(schemaNameOrObject, objectOrValidationOptions, maybeValidatorO
   }
 }
 
-// src/utils/pretty-error.ts
+// framework/utils/pretty-error.ts
 var import_pretty_error2 = __toESM(require_PrettyError(), 1);
 var pe2 = new import_pretty_error2.default;
 pe2.skipNodeFiles();
 pe2.skipPackage("typescript", "bun");
 pe2.start();
 
-// src/functions/validator.ts
+// framework/functions/validator.ts
 function validator() {
   return (target) => {
     const instance = new target;
@@ -20889,14 +20972,14 @@ function validator() {
     });
   };
 }
-// src/functions/env.ts
-var getContainer7 = () => globalThis.container;
+// framework/functions/env.ts
+var getContainer8 = () => globalThis.container;
 function env2() {
   return (target, propertyKey) => {
     const envVar = String(propertyKey).toUpperCase();
     const value = Bun.env[envVar];
     if (value) {
-      const container3 = getContainer7();
+      const container3 = getContainer8();
       container3.bind(propertyKey).toConstantValue(value);
     }
     Object.defineProperty(target, propertyKey, {
@@ -20907,7 +20990,7 @@ function env2() {
     });
   };
 }
-// src/functions/render.tsx
+// framework/functions/render.tsx
 import { renderToString } from "react-dom/server";
 import { jsxDEV } from "react/jsx-dev-runtime";
 function render(c3, Component, props) {
@@ -20927,7 +21010,7 @@ function createRenderer(c3) {
     renderElement: (element) => renderElement(c3, element)
   };
 }
-// src/components/LayoutView.tsx
+// framework/components/LayoutView.tsx
 import { jsxDEV as jsxDEV2 } from "react/jsx-dev-runtime";
 var LayoutView = ({
   title,
@@ -21023,6 +21106,7 @@ var PageLoader = ({
   }, undefined, false, undefined, this);
 };
 export {
+  websocket2 as websocket,
   validator,
   setAssetBasePath,
   service,
@@ -21034,6 +21118,10 @@ export {
   post,
   patch,
   options,
+  onOpen,
+  onMessage,
+  onDrain,
+  onClose,
   logger,
   inject,
   getDataSourceForCLI,
@@ -21048,6 +21136,8 @@ export {
   config,
   asset,
   all,
+  WS_HANDLERS_METADATA,
+  WEBSOCKET_METADATA,
   ROUTES_METADATA,
   PageLoader,
   Logger,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@razvan11/paladin",
-  "version": "1.0.8",
+  "version": "1.1.0",
   "description": "A Bun-based backend framework with decorators, dependency injection, and controller registration",
   "keywords": [
     "bun",
@@ -32,7 +32,7 @@
   ],
   "scripts": {
     "dev": "bun run ./example/index.ts",
-    "build": "    bun build ./src/index.ts --outdir ./dist --target bun --external react --external react-dom && bun run build:types",
+    "build": "bun build ./framework/index.ts --outdir ./dist --target bun --external react --external react-dom && bun run build:types",
     "build:types": "tsc -p tsconfig.build.json",
     "prepublishOnly": "bun run build",
     "fmt": "bunx @biomejs/biome format --write",
@@ -64,4 +64,4 @@
     "reflect-metadata": "^0.2.2",
     "zod": "^4.2.1"
   }
-}
+}