raiton 3.1.0 → 4.0.0

package/README.md

@@ -30,7 +30,7 @@ npm install raiton reflect-metadata
 ### 1. Créez un contrôleur (`source/controllers/hello.controller.ts`)
 
 ```typescript
-import { Controllable, Get, Param } from "raiton/sdk";
+import { Controllable, Get, Param } from "raiton/framework";
 
 @Controllable('/hello')
 export class HelloController {

package/build/bin/index.mjs

@@ -3873,13 +3873,13 @@ var require_Reflect2 = __commonJS(() => {
             }
             return { value: undefined, done: true };
           };
-          MapIterator2.prototype.throw = function(error) {
+          MapIterator2.prototype.throw = function(error2) {
             if (this._index >= 0) {
               this._index = -1;
               this._keys = arraySentinel;
               this._values = arraySentinel;
             }
-            throw error;
+            throw error2;
           };
           MapIterator2.prototype.return = function(value) {
             if (this._index >= 0) {
@@ -4799,7 +4799,7 @@ var require_bcrypt = __commonJS((exports, module) => {
 });
 
 // source/bin/index.ts
-var import_reflect_metadata5 = __toESM(require_Reflect(), 1);
+var import_reflect_metadata6 = __toESM(require_Reflect(), 1);
 
 // node_modules/commander/esm.mjs
 var import__ = __toESM(require_commander(), 1);
@@ -4817,7 +4817,7 @@ var {
   Help
 } = import__.default;
 // package.json
-var version = "3.1.0";
+var version = "4.0.0";
 
 // source/bin/cli.ts
 var CLI = new Command;
@@ -6211,7 +6211,7 @@ class RaitonConfig {
     }
   }
 }
-// source/sdk/utilities/artifact.util.ts
+// source/framework/utilities/artifact.util.ts
 function isControllerArtifact(filename) {
   return isArtifact(filename, "controller");
 }
@@ -6223,7 +6223,7 @@ function isArtifact(filename, artifact) {
     filename.endsWith(`.${artifact}.cjs`)
   ].some(Boolean);
 }
-// source/sdk/utilities/path.util.ts
+// source/framework/utilities/path.util.ts
 import path2 from "node:path";
 import { fileURLToPath } from "node:url";
 function getDirname(importMetaUrl) {
@@ -6257,16 +6257,121 @@ class RaitonDirectories {
     return path4.join(Raiton.thread?.builder.workdir || "", RaitonConfig.get("rootDir") || "./");
   }
 }
-// source/sdk/constants/decorators.constant.ts
+// source/framework/constants/decorators.constant.ts
 var METADATA_KEYS = {
   CONTROLLERS: Symbol("controller:meta"),
+  SOCKETS: Symbol("socket:meta"),
+  SOCKET_EVENTS: Symbol("socket:event:meta"),
   ROUTE_PARAMETERS: Symbol("route:meta"),
   GRAFTS: Symbol("graft:meta"),
   CONTAINER: Symbol("container:meta"),
   INJECT_PARAMETERS: Symbol("inject:parameters"),
   INJECT_PROPERTIES: Symbol("inject:properties")
 };
-// source/sdk/decorators/routable.decorator.ts
+// source/framework/responses/http.ts
+class HttpResponse {
+  response;
+  static push(response) {
+    throw new ThrowableResponse({
+      statusCode: response.statusCode || 400 /* BAD_REQUEST */,
+      message: response.message || "No response message provided",
+      data: response.data,
+      error: response.error,
+      errorStack: response.errorStack
+    });
+  }
+  constructor(response) {
+    this.response = response;
+  }
+  status(statusCode) {
+    this.response.statusCode = statusCode;
+    return this;
+  }
+  message(message) {
+    this.response.message = message;
+    return this;
+  }
+  data(data) {
+    this.response.data = data;
+    return this;
+  }
+  error(error) {
+    this.response.error = error;
+    return this;
+  }
+  stack(stack) {
+    this.response.errorStack = stack;
+    return this;
+  }
+  render() {
+    return new ThrowableResponse({ ...this.response }).render();
+  }
+}
+
+// source/framework/responses/error.ts
+class HttpErrorResponse {
+  stack = new Map;
+  get entries() {
+    return [...this.stack.values()];
+  }
+  add(input) {
+    this.stack.set(input.id, input);
+    return this;
+  }
+  remove(id) {
+    this.stack.delete(id);
+    return this;
+  }
+  get(id) {
+    return this.stack.get(id);
+  }
+  has(id) {
+    return this.stack.has(id);
+  }
+  clear() {
+    this.stack.clear();
+    return this;
+  }
+  get empty() {
+    return this.stack.size === 0;
+  }
+  get existence() {
+    return this.stack.size;
+  }
+  push() {
+    const first = this.stack.values().next().value;
+    HttpResponse.push({
+      statusCode: 500,
+      message: first?.message || "Internal server error",
+      error: true,
+      errorStack: this.entries
+    });
+  }
+}
+// source/framework/responses/http-throwable.ts
+class ThrowableResponse extends Error {
+  input;
+  statusCode;
+  constructor(input, statusCode = 500 /* INTERNAL_SERVER_ERROR */) {
+    super(typeof input === "string" ? input : input.message);
+    this.input = input;
+    this.statusCode = statusCode;
+  }
+  render() {
+    const stack = typeof this.input === "object" ? this.input.errorStack : undefined;
+    return {
+      message: this.message,
+      statusCode: this.statusCode,
+      data: typeof this.input === "object" ? this.input.data : undefined,
+      error: typeof this.input === "object" ? this.input.error : false,
+      stack: stack instanceof Error ? Raiton.thread?.builder?.options?.development ? this.stack?.split(`
+`).map((e) => e.trim()) : undefined : stack
+    };
+  }
+}
+// source/core/socket/metadata.ts
+var import_reflect_metadata = __toESM(require_Reflect2(), 1);
+// source/framework/decorators/routable.decorator.ts
 function stabilizeRoute(meta, { path: path5, method, propertyKey }) {
   return {
     ...meta.routes.filter((route) => route.path === path5 && route.method === method || route.propertyKey === propertyKey)[0] || {},
@@ -6294,8 +6399,8 @@ var Options = createRoutableDecorator("OPTIONS" /* OPTIONS */);
 var Trace = createRoutableDecorator("TRACE" /* TRACE */);
 var Delete = createRoutableDecorator("DELETE" /* DELETE */);
 var Head = createRoutableDecorator("HEAD" /* HEAD */);
-// source/sdk/decorators/parametrable.ts
-var import_reflect_metadata = __toESM(require_Reflect2(), 1);
+// source/framework/decorators/parametrable.ts
+var import_reflect_metadata2 = __toESM(require_Reflect2(), 1);
 function createRouteParametrableDecorator(type, callable2) {
   return (key) => {
     return (target, propertyKey, index) => {
@@ -6317,12 +6422,12 @@ var UploadedFile = createRouteParametrableDecorator("upload" /* UPLOAD_FILE */);
 var Headers2 = createRouteParametrableDecorator("header" /* HEADER */);
 var Req = createRouteParametrableDecorator("req" /* REQ */);
 var Reply = createRouteParametrableDecorator("reply" /* REPLY */);
-// source/sdk/decorators/injection.decorator.ts
-var import_reflect_metadata3 = __toESM(require_Reflect2(), 1);
+// source/framework/decorators/injection.decorator.ts
+var import_reflect_metadata4 = __toESM(require_Reflect2(), 1);
 
 // source/core/injection/injection.ts
-var import_reflect_metadata2 = __toESM(require_Reflect2(), 1);
-// source/sdk/exceptions/throwable.ts
+var import_reflect_metadata3 = __toESM(require_Reflect2(), 1);
+// source/framework/exceptions/throwable.ts
 class Throwable extends Error {
   statusCode;
   constructor(message, statusCode = 500, label) {
@@ -6418,16 +6523,16 @@ class Injection {
             continue;
           }
           if (typeof param === "function") {
-            const metadata = Reflect.getMetadata(METADATA_KEYS.CONTAINER, param);
-            const token2 = metadata?.name || param.name;
+            const metadata2 = Reflect.getMetadata(METADATA_KEYS.CONTAINER, param);
+            const token2 = metadata2?.name || param.name;
             this.addDependent(token2, definition.name);
             args.push(this.get(token2, effectiveScope));
             continue;
           }
         }
         if (designParam && typeof designParam === "function" && designParam.name) {
-          const metadata = Reflect.getMetadata(METADATA_KEYS.CONTAINER, designParam);
-          const token = metadata?.name || designParam.name;
+          const metadata2 = Reflect.getMetadata(METADATA_KEYS.CONTAINER, designParam);
+          const token = metadata2?.name || designParam.name;
           this.addDependent(token, definition.name);
           args.push(this.get(token, effectiveScope));
           continue;
@@ -6492,8 +6597,8 @@ class Injection {
           this.addDependent(token, definition.name);
           instance[propertyKey] = this.get(token, scope);
         } else if (typeof type === "function") {
-          const metadata = Reflect.getMetadata(METADATA_KEYS.CONTAINER, type);
-          const token_ = metadata?.name || type.name;
+          const metadata2 = Reflect.getMetadata(METADATA_KEYS.CONTAINER, type);
+          const token_ = metadata2?.name || type.name;
           this.addDependent(token_, definition.name);
           instance[propertyKey] = this.get(token_, scope);
         }
@@ -6519,10 +6624,10 @@ class Injection {
     this.clear();
   }
   static resolve(construct) {
-    const metadata = Reflect.getMetadata(METADATA_KEYS.CONTAINER, construct);
-    if (!metadata)
+    const metadata2 = Reflect.getMetadata(METADATA_KEYS.CONTAINER, construct);
+    if (!metadata2)
       throw new Throwable(`Cannot resolve ${construct.name} as dependency`);
-    return this.get(metadata.name);
+    return this.get(metadata2.name);
   }
 }
 // source/core/guards.ts
@@ -6561,107 +6666,6 @@ class RaitonGuards {
     return this;
   }
 }
-// source/sdk/responses/http.ts
-class HttpResponse {
-  response;
-  static push(response) {
-    throw new ThrowableResponse({
-      statusCode: response.statusCode || 400 /* BAD_REQUEST */,
-      message: response.message || "No response message provided",
-      data: response.data,
-      error: response.error,
-      errorStack: response.errorStack
-    });
-  }
-  constructor(response) {
-    this.response = response;
-  }
-  status(statusCode) {
-    this.response.statusCode = statusCode;
-    return this;
-  }
-  message(message) {
-    this.response.message = message;
-    return this;
-  }
-  data(data) {
-    this.response.data = data;
-    return this;
-  }
-  error(error) {
-    this.response.error = error;
-    return this;
-  }
-  stack(stack) {
-    this.response.errorStack = stack;
-    return this;
-  }
-  render() {
-    return new ThrowableResponse({ ...this.response }).render();
-  }
-}
-
-// source/sdk/responses/error.ts
-class HttpErrorResponse {
-  stack = new Map;
-  get entries() {
-    return [...this.stack.values()];
-  }
-  add(input) {
-    this.stack.set(input.id, input);
-    return this;
-  }
-  remove(id) {
-    this.stack.delete(id);
-    return this;
-  }
-  get(id) {
-    return this.stack.get(id);
-  }
-  has(id) {
-    return this.stack.has(id);
-  }
-  clear() {
-    this.stack.clear();
-    return this;
-  }
-  get empty() {
-    return this.stack.size === 0;
-  }
-  get existence() {
-    return this.stack.size;
-  }
-  push() {
-    const first = this.stack.values().next().value;
-    HttpResponse.push({
-      statusCode: 500,
-      message: first?.message || "Internal server error",
-      error: true,
-      errorStack: this.entries
-    });
-  }
-}
-// source/sdk/responses/http-throwable.ts
-class ThrowableResponse extends Error {
-  input;
-  statusCode;
-  constructor(input, statusCode = 500 /* INTERNAL_SERVER_ERROR */) {
-    super(typeof input === "string" ? input : input.message);
-    this.input = input;
-    this.statusCode = statusCode;
-  }
-  render() {
-    const stack = typeof this.input === "object" ? this.input.errorStack : undefined;
-    return {
-      message: this.message,
-      statusCode: this.statusCode,
-      data: typeof this.input === "object" ? this.input.data : undefined,
-      error: typeof this.input === "object" ? this.input.error : false,
-      stack: stack instanceof Error ? Raiton.thread?.builder?.options?.development ? this.stack?.split(`
-`).map((e) => e.trim()) : undefined : stack
-    };
-  }
-}
 // source/core/hooks.ts
 class HookStore {
   hooks = new Map;
@@ -6889,7 +6893,7 @@ class PluginScope {
 function definePlugin(setup, name) {
   return { setup, name };
 }
-// source/sdk/plugins/security/headers.ts
+// source/framework/plugins/security/headers.ts
 var secureHeaders = definePlugin((scope2) => {
   scope2.use(async ({ context, next }) => {
     context.reply.header("X-Content-Type-Options", "nosniff");
@@ -6899,20 +6903,20 @@ var secureHeaders = definePlugin((scope2) => {
     await next();
   });
 }, "security-headers");
-// source/sdk/encryption.ts
+// source/framework/encryption.ts
 var import_argon2 = __toESM(require_argon2(), 1);
 var import_bcrypt = __toESM(require_bcrypt(), 1);
 // source/core/controller/metadata.ts
-var import_reflect_metadata4 = __toESM(require_Reflect2(), 1);
+var import_reflect_metadata5 = __toESM(require_Reflect2(), 1);
 function getControllerMetadata(target) {
-  let metadata = Reflect.getMetadata(METADATA_KEYS.CONTROLLERS, target);
-  if (!metadata) {
-    metadata = { routes: [], middlewares: {} };
-    Reflect.defineMetadata(METADATA_KEYS.CONTROLLERS, metadata, target);
+  let metadata2 = Reflect.getMetadata(METADATA_KEYS.CONTROLLERS, target);
+  if (!metadata2) {
+    metadata2 = { routes: [], middlewares: {} };
+    Reflect.defineMetadata(METADATA_KEYS.CONTROLLERS, metadata2, target);
   }
-  return metadata;
+  return metadata2;
 }
-// source/sdk/artifacts.ts
+// source/framework/artifacts.ts
 class Artifacts {
   static types = new Set;
   static defaultTypes = [
@@ -6926,6 +6930,7 @@ class Artifacts {
     "utility",
     "source",
     "controller",
+    "socket",
     "middleware",
     "hook",
     "event",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "raiton",
-  "version": "3.1.0",
+  "version": "4.0.0",
   "private": false,
   "type": "module",
   "description": "Modular TypeScript Backend Framework with Dependency Injection, Plugins, Controllers, Middleware and Hot Reloading.",
@@ -30,8 +30,8 @@
     ".": "./source/core/index.ts",
     "./core/*": "./source/core/*.ts",
     "./commands/*": "./source/commands/*.ts",
-    "./sdk": "./source/sdk/index.ts",
-    "./sdk/*": "./source/sdk/*.ts",
+    "./framework": "./source/framework/index.ts",
+    "./framework/*": "./source/framework/*.ts",
     "./types": "./source/types/index.ts",
     "./types/*": "./source/types/*.ts"
   },

package/scripts/update-version.ts

@@ -10,6 +10,14 @@ function getLatestTag() {
   }
 }
 
+function getCurrentBranch() {
+  try {
+    return execSync("git rev-parse --abbrev-ref HEAD").toString().trim();
+  } catch {
+    return "main";
+  }
+}
+
 function getCommitsSince(tag: string | null) {
   const range = tag ? `${tag}..HEAD` : "HEAD";
   try {
@@ -35,13 +43,13 @@ function determineIncrement(commits: string[]) {
     }
     if (
         commit.startsWith("feat") ||
+        commit.startsWith("update") ||
         commit.startsWith("add")
     ) {
       increment = "minor";
     } else if (
         !increment &&
         commit.startsWith("fix") ||
-        commit.startsWith("update") ||
         commit.startsWith("remove")
     ) {
       increment = "patch";
@@ -51,11 +59,21 @@ function determineIncrement(commits: string[]) {
   return increment;
 }
 
-function updateVersion(increment: "major" | "minor" | "patch") {
+function updateVersion(increment: "major" | "minor" | "patch", branch: string) {
   const packageJsonPath = path.resolve(process.cwd(), "package.json");
   const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
   const currentVersion = packageJson.version;
-  const [major, minor, patch] = currentVersion.split(".").map(Number);
+
+  // Identification du suffixe de branche (alpha, beta, rc)
+  let preReleaseType: string | null = null;
+  if (branch.startsWith("alpha")) preReleaseType = "alpha";
+  else if (branch.startsWith("beta")) preReleaseType = "beta";
+  else if (branch.startsWith("rc")) preReleaseType = "rc";
+
+  // Extraction de la version de base et de la pre-release
+  // Format: major.minor.patch-type.num
+  const [versionPart, preReleasePart] = currentVersion.split("-");
+  const [major, minor, patch] = versionPart.split(".").map(Number);
 
   let nextVersion = "";
   if (increment === "major") {
@@ -66,9 +84,27 @@ function updateVersion(increment: "major" | "minor" | "patch") {
     nextVersion = `${major}.${minor}.${patch + 1}`;
   }
 
+  // Si nous sommes sur une branche de pre-release
+  if (preReleaseType) {
+    let preReleaseCount = 0;
+    if (preReleasePart && preReleasePart.startsWith(preReleaseType)) {
+      // Si on était déjà sur le même type de pre-release, on incrémente le compteur
+      // Si la version de base a changé suite à l'incrément, on repart à 0 ?
+      // Généralement si on fait un "feat" sur une branche alpha, on incrémente le patch ou le minor
+      // MAIS on garde le suffixe alpha.
+      const match = preReleasePart.match(/\d+$/);
+      preReleaseCount = match ? parseInt(match[0], 10) + 1 : 0;
+
+      // Si la version de base a été incrémentée, on pourrait vouloir repartir de 0,
+      // mais ici on suit la logique demandée : ajouter le nom de la branche.
+    }
+
+    nextVersion = `${nextVersion}-${preReleaseType}.${preReleaseCount}`;
+  }
+
   packageJson.version = nextVersion;
   writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + "\n");
-  console.log(`Version updated from ${currentVersion} to ${nextVersion}`);
+  console.log(`Version updated from ${currentVersion} to ${nextVersion} (branch: ${branch})`);
   return nextVersion;
 }
 
@@ -91,7 +127,8 @@ function main() {
   }
 
   console.log(`Determined increment: ${increment}`);
-  updateVersion(increment);
+  const branch = getCurrentBranch();
+  updateVersion(increment, branch);
 }
 
 main();

package/source/bin/bootstrapper.ts

@@ -1,6 +1,6 @@
 import {Command} from 'commander';
 import {RaitonCommands, RaitonConfig} from "../core";
-import {getPackageRoot} from "../sdk";
+import {getPackageRoot} from "../framework";
 import {CliTools} from "./cli-tools";
 
 

package/source/commands/develop.command.ts

@@ -1,7 +1,7 @@
 import {Raiton, RaitonCommand} from "../core";
 import {ChildProcess, ChildProcessWithoutNullStreams} from 'node:child_process';
 import {Logger} from "@protorians/logger";
-import {EventMessageEnum} from "../sdk";
+import {EventMessageEnum} from "../framework";
 import {CliTools} from "../bin/cli-tools";
 import path from "node:path";
 

package/source/core/application.ts

@@ -1,11 +1,11 @@
 import {PluginScope} from './plugins/scope'
 import {RequestContext} from './context'
 import {ApplicationConfigInterface, ApplicationInterface} from "../types/application";
-import {HttpMethod} from "../sdk";
+import {HttpMethod} from "../framework";
 import {RouteHandlerCallable} from "../types";
 import {Logger} from "@protorians/logger";
 import {RaitonConfig} from "./config";
-import {Artifacts} from "../sdk/artifacts";
+import {Artifacts} from "../framework/artifacts";
 import {Injection} from "./injection";
 
 export class Application implements ApplicationInterface {

package/source/core/builder.ts

@@ -5,13 +5,13 @@ import fs, {WatchEventType} from "node:fs";
 import type {BuilderConfigInterface, BuilderInterface,} from "../types";
 import {RaitonThread} from "./thread";
 import {Raiton} from "./raiton";
-import {isControllerArtifact, isServiceArtifact} from "../sdk";
+import {isControllerArtifact, isServiceArtifact} from "../framework";
 import {ControllerBuilder} from "./controller";
 import {watch} from "fs";
 import {LBadge, Logger} from "@protorians/logger";
-import {Throwable} from "../sdk/exceptions";
+import {Throwable} from "../framework/exceptions";
 import {Injection} from "./injection";
-import {Artifacts} from "../sdk/artifacts";
+import {Artifacts} from "../framework/artifacts";
 
 export class RaitonBuilder implements BuilderInterface {
     protected _source: string | null = null;

package/source/core/config/define.ts

@@ -1,5 +1,5 @@
 import {ConfigurableInterface} from "../../types/config";
-import {JsonUtil} from "../../sdk/utilities";
+import {JsonUtil} from "../../framework/utilities";
 
 export async function defineConfig(config?: ConfigurableInterface) {
     const workdir = process.cwd();

package/source/core/controller/builder.ts

@@ -4,7 +4,7 @@ import {LBadge, Logger} from "@protorians/logger";
 import {compileController} from "./compiler";
 import {RaitonThread} from "../thread";
 import {Injection} from "../injection";
-import {isControllerArtifact} from "../../sdk";
+import {isControllerArtifact} from "../../framework";
 import path from "node:path";
 
 export class ControllerBuilder {

package/source/core/controller/metadata.ts

@@ -1,5 +1,5 @@
 import {ControllerMetaInterface} from "../../types";
-import {METADATA_KEYS} from "../../sdk";
+import {METADATA_KEYS} from "../../framework";
 import "reflect-metadata";
 
 export function getControllerMetadata(target: any): ControllerMetaInterface {

package/source/core/index.ts

@@ -9,6 +9,7 @@ export * from "./raiton"
 export * from "./thread"
 export * from "./application"
 export * from "./controller"
+export * from "./socket"
 export * from "./plugins"
 export * from "./middleware"
 export * from "./router"

package/source/core/injection/injection.ts

@@ -2,8 +2,8 @@ import "reflect-metadata";
 import type {ConstructorType, ContainerDefinitionInterface} from "../../types";
 import {LifetimeEnum, TextUtility} from "@protorians/core";
 import {Logger} from "@protorians/logger";
-import {METADATA_KEYS} from "../../sdk/constants";
-import {Throwable} from "../../sdk/exceptions";
+import {METADATA_KEYS} from "../../framework/constants";
+import {Throwable} from "../../framework/exceptions";
 
 const camelCase = TextUtility.camelCase;
 

package/source/core/middleware/compose.ts

@@ -1,5 +1,5 @@
 import {MiddlewareType} from '../../types'
-import {Throwable} from "../../sdk/exceptions";
+import {Throwable} from "../../framework/exceptions";
 
 export function middlewareCompose(middlewares: MiddlewareType[]) {
     return function (request: any) {

package/source/core/router/handler.ts

@@ -1,11 +1,11 @@
 import {ControllerMetaInterface, MiddlewareCallable, ParamMetaInterface, RouteMetaInterface} from "../../types";
-import {METADATA_KEYS, Parametrable} from "../../sdk";
+import {METADATA_KEYS, Parametrable} from "../../framework";
 import {Logger} from "@protorians/logger";
 import {middlewareCompose, Raiton} from "..";
-import {DataTransferObject} from "../../sdk/data-transfer-object";
-import {Throwable} from "../../sdk/exceptions/throwable";
-import {HttpException} from "../../sdk/exceptions";
-import {ThrowableResponse} from "../../sdk/responses/http-throwable";
+import {DataTransferObject} from "../../framework/data-transfer-object";
+import {Throwable} from "../../framework/exceptions/throwable";
+import {HttpException} from "../../framework/exceptions";
+import {ThrowableResponse} from "../../framework/responses/http-throwable";
 
 export function createHandler(
     instance: any,

package/source/core/router/router.ts

@@ -1,5 +1,5 @@
 import {RouteHandlerCallable} from '../../types'
-import {HttpMethod} from "../../sdk/enums";
+import {HttpMethod} from "../../framework/enums";
 import {Route} from './route'
 import {RouteMatcher} from './matcher'
 

package/source/core/socket/index.ts

@@ -0,0 +1 @@
+export * from "./metadata"

package/source/core/socket/metadata.ts

@@ -0,0 +1,13 @@
+import {SocketMetaInterface} from "../../types";
+import {METADATA_KEYS} from "../../framework";
+import "reflect-metadata";
+
+export function getSocketMetadata(target: any): SocketMetaInterface {
+    let metadata = Reflect.getMetadata(METADATA_KEYS.SOCKETS, target);
+    if (!metadata) {
+        metadata = { namespace: '/', events: [] };
+        Reflect.defineMetadata(METADATA_KEYS.SOCKETS, metadata, target);
+    }
+
+    return metadata;
+}

package/source/core/thread.ts

@@ -7,16 +7,16 @@ import type {
     ThreadSetupOptionsInterface,
     ThreadWaitCallable,
 } from "../types";
-import {EventMessageEnum, RuntimeType} from "../sdk/enums";
+import {EventMessageEnum, RuntimeType} from "../framework/enums";
 import {ProcessUtility} from "@protorians/core";
 import {until} from "./process.util";
 import {ApplicationInterface} from "../types/application";
-import {Runtime} from "../sdk/runtime";
+import {Runtime} from "../framework/runtime";
 import {LBadge, Logger} from "@protorians/logger";
 import {ControllerBuilder} from "./controller";
-import {bodyParserPlugin} from "../sdk/plugins/body-parser.plugin";
+import {bodyParserPlugin} from "../framework/plugins/body-parser.plugin";
 import {Injection} from "./injection/injection";
-import {Throwable} from "../sdk/exceptions";
+import {Throwable} from "../framework/exceptions";
 import os from "os";
 
 

package/source/{sdk → framework}/artifacts.ts

@@ -19,6 +19,7 @@ export class Artifacts {
         'utility',
         'source',
         'controller',
+        'socket',
         'middleware',
         'hook',
         'event',

package/source/{sdk → framework}/constants/decorators.constant.ts

@@ -1,5 +1,7 @@
 export const METADATA_KEYS = {
     CONTROLLERS: Symbol('controller:meta'),
+    SOCKETS: Symbol('socket:meta'),
+    SOCKET_EVENTS: Symbol('socket:event:meta'),
     ROUTE_PARAMETERS: Symbol('route:meta'),
     GRAFTS: Symbol('graft:meta'),
     CONTAINER: Symbol('container:meta'),

package/source/{sdk → framework}/decorators/index.ts

@@ -1,4 +1,5 @@
 export * from "./controllable.decorator"
+export * from "./socket.decorator"
 export * from "./middleware.decorator"
 export * from "./routable.decorator"
 export * from "./parametrable"

package/source/framework/decorators/socket.decorator.ts

@@ -0,0 +1,41 @@
+import {getSocketMetadata} from "../../core/socket";
+import {Injectable} from "..";
+import {LifetimeEnum} from "@protorians/core";
+import {SocketEventType} from "../../types";
+
+export function Socket(namespace = '/') {
+    return (target: any) => {
+        const name = target.name;
+        Injectable(LifetimeEnum.TRANSIENT, name)(target)
+
+        const meta = getSocketMetadata(target.prototype || target)
+        meta.namespace = namespace;
+    }
+}
+
+function createSocketEventDecorator(type: SocketEventType, name?: string) {
+    return (target: any, propertyKey: string) => {
+        const meta = getSocketMetadata(target)
+        meta.events.push({
+            type,
+            name: name || propertyKey,
+            propertyKey
+        })
+    }
+}
+
+export function OnConnect() {
+    return createSocketEventDecorator('connect')
+}
+
+export function OnDisconnect() {
+    return createSocketEventDecorator('disconnect')
+}
+
+export function OnMessage(name?: string) {
+    return createSocketEventDecorator('message', name)
+}
+
+export function OnEvent(name: string) {
+    return createSocketEventDecorator('event', name)
+}

package/source/{sdk → framework}/utilities/artifact.util.ts

@@ -2,6 +2,9 @@ export function isControllerArtifact(filename: string) {
     return isArtifact(filename, 'controller')
 }
 
+export function isSocketArtifact(filename: string) {
+    return isArtifact(filename, 'socket')
+}
 
 export function isServiceArtifact(filename: string) {
     return isArtifact(filename, 'service')

package/source/types/application.ts

@@ -1,4 +1,4 @@
-import {HttpMethod} from "../sdk";
+import {HttpMethod} from "../framework";
 
 export interface ApplicationConfigInterface {
     workdir?: string;

package/source/types/controller.ts

@@ -1,4 +1,4 @@
-import {HttpMethod, Parametrable} from "../sdk/enums";
+import {HttpMethod, Parametrable} from "../framework/enums";
 import {ContextInterface} from "./core";
 import {MiddlewareCallable, MiddlewareType} from "./middleware";
 

package/source/types/index.ts

@@ -16,6 +16,7 @@ export type * from "./plugin"
 export type * from "./runtime"
 export type * from "./router"
 export type * from "./controller"
+export type * from "./socket"
 export type * from "./injection"
 export type * from "./responses"
 export type * from "./server"

package/source/types/responses.ts

@@ -1,4 +1,4 @@
-import {HttpStatus} from "../sdk/enums/http-status.enum";
+import {HttpStatus} from "../framework/enums/http-status.enum";
 import {ParseableEntriesType, ParseableType} from "./parseable";
 
 export interface HttpResponseBaseInterface {

package/source/types/router.ts

@@ -1,5 +1,5 @@
 import {RequestContext} from "../core/context";
-import {HttpMethod} from "../sdk";
+import {HttpMethod} from "../framework";
 
 export type RouteHandlerCallable = (ctx: RequestContext) => Promise<any> | any
 

package/source/types/runtime.ts

@@ -1,4 +1,4 @@
-import {RuntimeType} from "../sdk/enums/runtime.enum";
+import {RuntimeType} from "../framework/enums/runtime.enum";
 
 export interface RuntimeServerInterface {
     listen(port: number, hostname?: string): Promise<void>

package/source/types/socket.ts

@@ -0,0 +1,15 @@
+
+export interface SocketMetaInterface {
+    namespace: string;
+    events: SocketEventMetaInterface[];
+}
+
+export interface SocketEventMetaInterface {
+    name: string;
+    propertyKey: string;
+    type: SocketEventType;
+}
+
+export type SocketEventType = 'message' | 'connect' | 'disconnect' | 'event';
+
+export type SocketDecoratorCallable = (metadata: SocketMetaInterface) => void;

package/source/types/thread.ts

@@ -1,7 +1,7 @@
 import {BuilderInterface} from "./builder";
 import {RuntimeAdapterInterface} from "./runtime";
 import {ApplicationInterface} from "./application";
-import {RuntimeType} from "../sdk/enums/runtime.enum";
+import {RuntimeType} from "../framework/enums/runtime.enum";
 
 export interface ThreadSetupOptionsInterface {
     application: ApplicationInterface;

package/source/{sdk → framework}/index.ts

@@ -1,9 +1,9 @@
 export * from "./enums/index"
 export * from "./constants/index"
-export * from "./decorators/index"
+export * from "./utilities/index"
 export * from "./responses/index"
+export * from "./decorators/index"
 export * from "./plugins/index"
-export * from "./utilities/index"
 export * from "./runtime/index"
 export * from "./exceptions/index"
 export * from "./controllers"