titanpl 4.0.2 → 7.0.0-beta

package/packages/native/index.d.ts

@@ -22,8 +22,17 @@ export function defineAction<T = any>(handler: (req: Request) => T | Promise<T>)
 export function fetch(url: string, options?: any): any;
 export function drift<T>(op: any): T;
 
+export interface ShareContext {
+    get(key: string): any;
+    set(key: string, value: any): void;
+    delete(key: string): void;
+    keys(): string[];
+    broadcast(event: string, payload: any): void;
+}
+
 // Add more as needed based on native/index.js
 export const db: any;
+export const ws: any;
 export const path: any;
 export const jwt: any;
 export const password: any;
@@ -32,6 +41,7 @@ export const buffer: any;
 export const ls: any;
 export const session: any;
 export const cookies: any;
+export const shareContext: ShareContext;
 export const os: any;
 export const net: any;
 export const proc: any;

package/packages/native/index.js

@@ -11,6 +11,9 @@ export const password = t.password;
 // Database
 export const db = t.db;
 
+// WebSockets
+export const ws = t.ws;
+
 // File System & Path
 export const fs = t.fs;
 export const path = t.path;
@@ -24,6 +27,7 @@ export const ls = t.ls;
 export const localStorage = t.localStorage;
 export const session = t.session;
 export const cookies = t.cookies;
+export const shareContext = t.shareContext;
 
 // System
 export const os = t.os;

package/packages/native/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@titanpl/native",
-  "version": "2.0.4",
+  "version": "7.0.0-beta",
   "description": "Titan native utilities package",
   "type": "module",
   "keywords": [

package/packages/native/t.native.d.ts

@@ -2,7 +2,7 @@
 //  Titan Planet — Type Definitions
 //  Framework: JavaScript-first backend compiled to native Rust + Axum binary
 //  Version:   v26 (Stable)
-//  Docs:      https://titan-docs-ez.vercel.app/docs
+//  Docs:      https://titanpl.vercel.app/docs
 //  GitHub:    https://github.com/ezet-galaxy/titanpl
 // =============================================================================
 
@@ -28,8 +28,8 @@
  * }
  * ```
  *
- * @see https://titan-docs-ez.vercel.app/docs/03-actions — Actions documentation
- * @see https://titan-docs-ez.vercel.app/docs/02-routes  — Routes & parameters
+ * @see https://titanpl.vercel.app/docs/how-to-use/02-actions — Actions documentation
+ * @see https://titanpl.vercel.app/docs/how-to-use/01-routes  — Routes & parameters
  */
 export interface TitanRequest {
     /**
@@ -106,7 +106,7 @@ export interface TitanRequest {
      * }
      * ```
      *
-     * @see https://titan-docs-ez.vercel.app/docs/02-routes — Dynamic routes
+     * @see https://titanpl.vercel.app/docs/how-to-use/01-routes#dynamic-routes-useridnumber — Dynamic routes
      */
     params: Record<string, string>;
 
@@ -130,6 +130,18 @@ export interface TitanRequest {
      * ```
      */
     query: Record<string, string>;
+
+    /**
+     * The unique ID of the WebSocket connection.
+     * Only present during WebSocket events (`open`, `message`, `close`).
+     */
+    socketId?: string;
+
+    /**
+     * The type of WebSocket event: "open", "message", or "close".
+     * Only present during WebSocket execution.
+     */
+    event?: "open" | "message" | "close";
 }
 
 /**
@@ -167,7 +179,7 @@ export interface TitanRequest {
  * });
  * ```
  *
- * @see https://titan-docs-ez.vercel.app/docs/03-actions — Action definition patterns
+ * @see https://titanpl.vercel.app/docs/how-to-use/02-actions — Action definition patterns
  */
 export function defineAction<T>(
     handler: (req: TitanRequest) => T
@@ -285,6 +297,14 @@ export const session: typeof t.session;
  */
 export const cookies: typeof t.cookies;
 
+/**
+ * Titan Shared Context (Shared In-Memory State) shorthand.
+ *
+ * Re-exported from the `t` global for module-style imports.
+ * @see {@link TitanCore.ShareContext} for full documentation.
+ */
+export const shareContext: typeof t.shareContext;
+
 /**
  * Operating system information (platform, CPU count, memory).
  *
@@ -331,7 +351,6 @@ export const url: typeof t.url;
  * Provides schema-based validation for request data. Works with
  * the `@titanpl/valid` package for advanced validation rules.
  *
- * @see https://titan-docs-ez.vercel.app/docs/12-sdk — TitanPl SDK
  */
 export const valid: any;
 
@@ -406,8 +425,8 @@ declare global {
      * }
      * ```
      *
-     * @see https://titan-docs-ez.vercel.app/docs/14-drift — Drift documentation
-     * @see https://titan-docs-ez.vercel.app/docs/runtime-architecture — Gravity Runtime
+     * @see https://titanpl.vercel.app/docs/knowledge/04-drift — Drift documentation
+     * @see https://titanpl.vercel.app/docs/knowledge/02-runtime-architecture — Gravity Runtime
      */
     var drift: <T>(promise: Promise<T> | T) => T;
 
@@ -440,7 +459,7 @@ declare global {
      * }
      * ```
      *
-     * @see https://titan-docs-ez.vercel.app/docs/04-runtime-apis — Runtime APIs
+     * @see https://titanpl.vercel.app/docs/how-to-use/05-runtime-apis — Runtime APIs
      */
     interface DbConnection {
         /**
@@ -500,7 +519,7 @@ declare global {
      * }
      * ```
      *
-     * @see https://titan-docs-ez.vercel.app/docs/04-runtime-apis — Complete Runtime APIs reference
+     * @see https://titanpl.vercel.app/docs/how-to-use/05-runtime-apis — Complete Runtime APIs reference
      */
     interface TitanRuntimeUtils {
 
@@ -530,7 +549,7 @@ declare global {
          * t.log("Multiple", "values", { are: "supported" }, 42);
          * ```
          *
-         * @see https://titan-docs-ez.vercel.app/docs/06-logs — Gravity Logs
+         * @see https://titanpl.vercel.app/docs/how-to-use/07-logs — Gravity Logs
          */
         log(...args: any[]): void;
 
@@ -553,7 +572,7 @@ declare global {
          * }
          * ```
          *
-         * @see https://titan-docs-ez.vercel.app/docs/04-runtime-apis — Runtime APIs
+         * @see https://titanpl.vercel.app/docs/how-to-use/05-runtime-apis — Runtime APIs
          */
         read(path: string): string;
 
@@ -616,7 +635,7 @@ declare global {
          * }
          * ```
          *
-         * @see https://titan-docs-ez.vercel.app/docs/04-runtime-apis — Runtime APIs (t.fetch)
+         * @see https://titanpl.vercel.app/docs/how-to-use/05-runtime-apis — Runtime APIs (t.fetch)
          */
         fetch(url: string, options?: {
             method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
@@ -629,6 +648,38 @@ declare global {
             error?: string;
         }>;
 
+        /**
+         * WebSocket communication utilities.
+         *
+         * Allows sending direct messages or broadcasting to all active sockets.
+         *
+         * @example
+         * ```js
+         * export default function chat(req) {
+         *   if (req.event === "open") {
+         *     t.ws.send(req.socketId, "Welcome!");
+         *     t.ws.broadcast("Someone joined.");
+         *   }
+         * }
+         * ```
+         */
+        ws: {
+            /**
+             * Send a text message to a specific WebSocket client.
+             *
+             * @param socketId - The unique ID of the target connection.
+             * @param message - The text message to send.
+             */
+            send(socketId: string, message: string): void;
+
+            /**
+             * Broadcast a text message to ALL active WebSocket connections.
+             *
+             * @param message - The text message to broadcast.
+             */
+            broadcast(message: string): void;
+        };
+
 
         // -------------------------------------------------------------------
         //  Authentication & Security
@@ -669,7 +720,7 @@ declare global {
          * }
          * ```
          *
-         * @see https://titan-docs-ez.vercel.app/docs/04-runtime-apis — Runtime APIs (t.jwt)
+         * @see https://titanpl.vercel.app/docs/how-to-use/05-runtime-apis — Runtime APIs (t.jwt)
          */
         jwt: {
             /**
@@ -737,7 +788,7 @@ declare global {
          * }
          * ```
          *
-         * @see https://titan-docs-ez.vercel.app/docs/04-runtime-apis — Runtime APIs (t.password)
+         * @see https://titanpl.vercel.app/docs/how-to-use/05-runtime-apis — Runtime APIs (t.password)
          */
         password: {
             /**
@@ -811,7 +862,7 @@ declare global {
          * }
          * ```
          *
-         * @see https://titan-docs-ez.vercel.app/docs/04-runtime-apis — Runtime APIs (t.db)
+         * @see https://titanpl.vercel.app/docs/how-to-use/05-runtime-apis — Runtime APIs (t.db)
          */
         db: {
             /**
@@ -884,7 +935,7 @@ declare global {
          * directories. All methods return `Promise` — use `drift()` to resolve.
          *
          * @see {@link TitanCore.FileSystem} for method signatures.
-         * @see https://titan-docs-ez.vercel.app/docs/13-titan-core — TitanCore Runtime APIs (t.fs)
+         * @see https://titanpl.vercel.app/docs/knowledge/05-titan-core — TitanCore Runtime APIs (t.fs)
          */
         fs: TitanCore.FileSystem;
 
@@ -895,7 +946,7 @@ declare global {
          * cross-platform path joining, resolving, and component extraction.
          *
          * @see {@link TitanCore.Path} for method signatures.
-         * @see https://titan-docs-ez.vercel.app/docs/13-titan-core — TitanCore Runtime APIs (t.path)
+         * @see https://titanpl.vercel.app/docs/knowledge/05-titan-core — TitanCore Runtime APIs (t.path)
          */
         path: TitanCore.Path;
 
@@ -911,7 +962,7 @@ declare global {
          * random bytes generation, and UUID creation. Async methods require `drift()`.
          *
          * @see {@link TitanCore.Crypto} for method signatures.
-         * @see https://titan-docs-ez.vercel.app/docs/13-titan-core — TitanCore Runtime APIs (t.crypto)
+         * @see https://titanpl.vercel.app/docs/knowledge/05-titan-core — TitanCore Runtime APIs (t.crypto)
          */
         crypto: TitanCore.Crypto;
 
@@ -921,7 +972,7 @@ declare global {
          * All methods are **synchronous** — no `drift()` needed.
          *
          * @see {@link TitanCore.BufferModule} for method signatures.
-         * @see https://titan-docs-ez.vercel.app/docs/13-titan-core — TitanCore Runtime APIs (t.buffer)
+         * @see https://titanpl.vercel.app/docs/knowledge/05-titan-core — TitanCore Runtime APIs (t.buffer)
          */
         buffer: TitanCore.BufferModule;
 
@@ -940,7 +991,7 @@ declare global {
          * @suggestion Use `setObject`/`getObject` for complex data structures to maintain types.
 
          * @see {@link TitanCore.LocalStorage} for method signatures.
-         * @see https://titan-docs-ez.vercel.app/docs/13-titan-core — TitanCore Runtime APIs (t.ls)
+         * @see https://titanpl.vercel.app/docs/knowledge/05-titan-core — TitanCore Runtime APIs (t.ls)
          */
         ls: TitanCore.LocalStorage;
 
@@ -951,7 +1002,7 @@ declare global {
          * **synchronous**. Identical to `t.ls` — use whichever alias you prefer.
          *
          * @see {@link TitanCore.LocalStorage} for method signatures.
-         * @see https://titan-docs-ez.vercel.app/docs/13-titan-core — TitanCore Runtime APIs (t.localStorage)
+         * @see https://titanpl.vercel.app/docs/knowledge/05-titan-core — TitanCore Runtime APIs (t.localStorage)
          */
         localStorage: TitanCore.LocalStorage;
 
@@ -965,15 +1016,28 @@ declare global {
          * All methods are **synchronous**.
          *
          * @see {@link TitanCore.Session} for method signatures.
-         * @see https://titan-docs-ez.vercel.app/docs/13-titan-core — TitanCore Runtime APIs (t.session)
+         * @see https://titanpl.vercel.app/docs/knowledge/05-titan-core — TitanCore Runtime APIs (t.session)
          */
         session: TitanCore.Session;
 
+        /**
+         * Titan Shared Context — Cross-isolate Shared In-Memory State.
+         *
+         * Provides a mechanism for sharing data across different isolates (requests)
+         * and broadcasting events within the same server process.
+         * 
+         * Data in `shareContext` is volatile and lost when the server exits.
+         * 
+         * @see {@link TitanCore.ShareContext} for method signatures.
+         * @see https://titanpl.vercel.app/docs/knowledge/05-titan-core — TitanCore Runtime APIs (t.shareContext)
+         */
+        shareContext: TitanCore.ShareContext;
+
         /**
          * HTTP cookie utilities for reading, setting, and deleting cookies.
          *
          * @see {@link TitanCore.Cookies} for method signatures.
-         * @see https://titan-docs-ez.vercel.app/docs/13-titan-core — TitanCore Runtime APIs (t.cookies)
+         * @see https://titanpl.vercel.app/docs/knowledge/05-titan-core — TitanCore Runtime APIs (t.cookies)
          */
         cookies: TitanCore.Cookies;
 
@@ -989,7 +1053,7 @@ declare global {
          * host machine running the Titan server.
          *
          * @see {@link TitanCore.OS} for method signatures.
-         * @see https://titan-docs-ez.vercel.app/docs/13-titan-core — TitanCore Runtime APIs (t.os)
+         * @see https://titanpl.vercel.app/docs/knowledge/05-titan-core — TitanCore Runtime APIs (t.os)
          */
         os: TitanCore.OS;
 
@@ -999,7 +1063,7 @@ declare global {
          * All methods return `Promise` — use `drift()` to resolve.
          *
          * @see {@link TitanCore.Net} for method signatures.
-         * @see https://titan-docs-ez.vercel.app/docs/13-titan-core — TitanCore Runtime APIs (t.net)
+         * @see https://titanpl.vercel.app/docs/knowledge/05-titan-core — TitanCore Runtime APIs (t.net)
          */
         net: TitanCore.Net;
 
@@ -1009,7 +1073,7 @@ declare global {
          * All methods are **synchronous**.
          *
          * @see {@link TitanCore.Process} for method signatures.
-         * @see https://titan-docs-ez.vercel.app/docs/13-titan-core — TitanCore Runtime APIs (t.proc)
+         * @see https://titanpl.vercel.app/docs/knowledge/05-titan-core — TitanCore Runtime APIs (t.proc)
          */
         proc: TitanCore.Process;
 
@@ -1024,7 +1088,7 @@ declare global {
          * `t.time.sleep()` is async (requires `drift()`); other methods are synchronous.
          *
          * @see {@link TitanCore.Time} for method signatures.
-         * @see https://titan-docs-ez.vercel.app/docs/13-titan-core — TitanCore Runtime APIs (t.time)
+         * @see https://titanpl.vercel.app/docs/knowledge/05-titan-core — TitanCore Runtime APIs (t.time)
          */
         time: TitanCore.Time;
 
@@ -1032,7 +1096,7 @@ declare global {
          * URL parsing and formatting utilities.
          *
          * @see {@link TitanCore.URLModule} for method signatures.
-         * @see https://titan-docs-ez.vercel.app/docs/13-titan-core — TitanCore Runtime APIs (t.url)
+         * @see https://titanpl.vercel.app/docs/knowledge/05-titan-core — TitanCore Runtime APIs (t.url)
          */
         url: TitanCore.URLModule;
 
@@ -1055,7 +1119,7 @@ declare global {
          * Custom extensions attach their methods to the `t` object at runtime,
          * making them available as `t.myExtension.someMethod()`.
          *
-         * @see https://titan-docs-ez.vercel.app/docs/10-extensions — Extensions documentation
+         * @see https://titanpl.vercel.app/docs/10-extensions — Extensions documentation
          */
         [key: string]: any;
 
@@ -1077,8 +1141,8 @@ declare global {
      * }
      * ```
      *
-     * @see https://titan-docs-ez.vercel.app/docs/04-runtime-apis — Full API reference
-     * @see https://titan-docs-ez.vercel.app/docs/13-titan-core — TitanCore Runtime APIs
+     * @see https://titanpl.vercel.app/docs/how-to-use/05-runtime-apis — Full API reference
+     * @see https://titanpl.vercel.app/docs/knowledge/05-titan-core — TitanCore Runtime APIs
      */
     const t: TitanRuntimeUtils;
 
@@ -1142,7 +1206,7 @@ declare global {
          * }
          * ```
          *
-         * @see https://titan-docs-ez.vercel.app/docs/04-runtime-apis — Runtime APIs (t.fs)
+         * @see https://titanpl.vercel.app/docs/how-to-use/05-runtime-apis — Runtime APIs (t.fs)
          */
         interface FileSystem {
             /**
@@ -1232,7 +1296,7 @@ declare global {
          * t.path.basename("/a/b/c.txt");  // → "c.txt"
          * ```
          *
-         * @see https://titan-docs-ez.vercel.app/docs/04-runtime-apis — Runtime APIs (t.path)
+         * @see https://titanpl.vercel.app/docs/how-to-use/05-runtime-apis — Runtime APIs (t.path)
          */
         interface Path {
             /**
@@ -1320,7 +1384,7 @@ declare global {
          * }
          * ```
          *
-         * @see https://titan-docs-ez.vercel.app/docs/04-runtime-apis — Runtime APIs (t.crypto)
+         * @see https://titanpl.vercel.app/docs/how-to-use/05-runtime-apis — Runtime APIs (t.crypto)
          */
         interface Crypto {
             /**
@@ -1463,7 +1527,7 @@ declare global {
          * const bytes = t.buffer.fromHex(hex);
          * ```
          *
-         * @see https://titan-docs-ez.vercel.app/docs/04-runtime-apis — Runtime APIs (t.buffer)
+         * @see https://titanpl.vercel.app/docs/how-to-use/05-runtime-apis — Runtime APIs (t.buffer)
          */
         interface BufferModule {
             /**
@@ -1546,7 +1610,7 @@ declare global {
          * t.ls.clear();
          * ```
          *
-         * @see https://titan-docs-ez.vercel.app/docs/04-runtime-apis — Runtime APIs (t.ls / t.localStorage)
+         * @see https://titanpl.vercel.app/docs/how-to-use/05-runtime-apis — Runtime APIs (t.ls / t.localStorage)
          */
         interface LocalStorage {
             /**
@@ -1651,7 +1715,7 @@ declare global {
          * }
          * ```
          *
-         * @see https://titan-docs-ez.vercel.app/docs/04-runtime-apis — Runtime APIs (t.session)
+         * @see https://titanpl.vercel.app/docs/how-to-use/05-runtime-apis — Runtime APIs (t.session)
          */
         interface Session {
             /**
@@ -1688,6 +1752,73 @@ declare global {
             clear(sessionId: string): void;
         }
 
+        /**
+         * Titan Shared Context — Cross-isolate Shared In-Memory State.
+         *
+         * Provides a mechanism for sharing data across different isolates (requests)
+         * and broadcasting events within the same server process.
+         * 
+         * Data in `shareContext` is in-memory only and is lost when the server process exits.
+         * 
+         * @example
+         * ```js
+         * export function getStats(req) {
+         *   // Store a value common to all requests
+         *   t.shareContext.set("last_login", t.time.now());
+         *   
+         *   // Retrieve a value
+         *   const users = t.shareContext.get("active_users");
+         *   
+         *   // Broadcast a message to other workers
+         *   t.shareContext.broadcast("user_login", { user: "Titan" });
+         * }
+         * ```
+         * 
+         * @see https://titanpl.vercel.app/docs/knowledge/05-titan-core — TitanCore Runtime APIs (t.shareContext)
+         */
+        interface ShareContext {
+            /**
+             * Retrieve a value from the shared context.
+             * 
+             * @param key - The key of the value to retrieve.
+             * @returns The parsed value, or `null` if the key does not exist.
+             */
+            get(key: string): any;
+
+            /**
+             * Store a value in the shared context.
+             * 
+             * Values are serialized as JSON and must be serializable.
+             * 
+             * @param key - The key to store under.
+             * @param value - The JSON-serializable value to store.
+             */
+            set(key: string, value: any): void;
+
+            /**
+             * Remove a key and its value from the shared context.
+             * 
+             * @param key - The key to remove.
+             */
+            delete(key: string): void;
+
+            /**
+             * Get a list of all keys currently in the shared context.
+             * 
+             * @returns An array of string keys.
+             */
+            keys(): string[];
+
+            /**
+             * Broadcast an event and payload to other active isolates (requests) 
+             * and workers in this server process.
+             * 
+             * @param event - The name of the event to broadcast.
+             * @param payload - The payload of the event.
+             */
+            broadcast(event: string, payload: any): void;
+        }
+
         /**
          * HTTP cookie management utilities.
          *
@@ -1713,7 +1844,7 @@ declare global {
          * }
          * ```
          *
-         * @see https://titan-docs-ez.vercel.app/docs/04-runtime-apis — Runtime APIs (t.cookies)
+         * @see https://titanpl.vercel.app/docs/how-to-use/05-runtime-apis — Runtime APIs (t.cookies)
          */
         interface Cookies {
             /**
@@ -1762,7 +1893,7 @@ declare global {
          * }
          * ```
          *
-         * @see https://titan-docs-ez.vercel.app/docs/04-runtime-apis — Runtime APIs (t.os)
+         * @see https://titanpl.vercel.app/docs/how-to-use/05-runtime-apis — Runtime APIs (t.os)
          */
         interface OS {
             /**
@@ -1816,7 +1947,7 @@ declare global {
          * }
          * ```
          *
-         * @see https://titan-docs-ez.vercel.app/docs/04-runtime-apis — Runtime APIs (t.net)
+         * @see https://titanpl.vercel.app/docs/how-to-use/05-runtime-apis — Runtime APIs (t.net)
          */
         interface Net {
             /**
@@ -1859,7 +1990,7 @@ declare global {
          * }
          * ```
          *
-         * @see https://titan-docs-ez.vercel.app/docs/04-runtime-apis — Runtime APIs (t.proc)
+         * @see https://titanpl.vercel.app/docs/how-to-use/05-runtime-apis — Runtime APIs (t.proc)
          */
         interface Process {
             /**
@@ -1900,7 +2031,7 @@ declare global {
          * }
          * ```
          *
-         * @see https://titan-docs-ez.vercel.app/docs/04-runtime-apis — Runtime APIs (t.time)
+         * @see https://titanpl.vercel.app/docs/how-to-use/05-runtime-apis — Runtime APIs (t.time)
          */
         interface Time {
             /**
@@ -1954,7 +2085,7 @@ declare global {
          * // → "https://api.example.com/v2/users"
          * ```
          *
-         * @see https://titan-docs-ez.vercel.app/docs/04-runtime-apis — Runtime APIs (t.url)
+         * @see https://titanpl.vercel.app/docs/how-to-use/05-runtime-apis — Runtime APIs (t.url)
          */
         interface URLModule {
             /**

package/packages/packet/README.md

@@ -8,4 +8,3 @@ This library parses all your app routes, components, middleware, and logic paths
 ## How it works
 This package is triggered whenever you run `titan init` or `titan build` from the `@titanpl/cli`. It hooks into tools like `esbuild` to optimize your scripts efficiently. It strips unnecessary pieces out so that only explicit route actions make their way aggressively over to the Titan runtime engine.
 
-**Important Note:** Currently, Titan Planet and its entire package ecosystem are only for Windows. The Linux version is in development (dev only) for the new architecture and will be launched later.

package/packages/packet/index.js

@@ -67,6 +67,15 @@ export async function build(root = process.cwd()) {
     outDir: dist,
   });
 
+  const tanfigPath = path.join(root, "tanfig.json");
+  if (fs.existsSync(tanfigPath)) {
+    fs.copyFileSync(tanfigPath, path.join(dist, "tanfig.json"));
+  }
+  const titanExtPath = path.join(root, "titan.json");
+  if (fs.existsSync(titanExtPath)) {
+    fs.copyFileSync(titanExtPath, path.join(dist, "titan.json"));
+  }
+
   return dist;
 }
 
@@ -91,7 +100,7 @@ export async function release(root = process.cwd()) {
     } catch (e) { }
   }
 
-  const filesToCopy = config.build && config.build.files ? config.build.files : ["public", "static", "db", "config"];
+  const filesToCopy = config.build && config.build.files ? config.build.files : ["public", "static", "db", "config", "tanfig.json", "titan.json"];
 
   // Clear or ensure build dir
   if (fs.existsSync(buildDir)) {
@@ -111,11 +120,19 @@ export async function release(root = process.cwd()) {
     }
   }
 
-  // 3. Copy package.json
+  // 3. Copy package.json & tanfig.json
   const pkgPath = path.join(root, "package.json");
   if (fs.existsSync(pkgPath)) {
     fs.copyFileSync(pkgPath, path.join(buildDir, "package.json"));
   }
+  const tanfigPath = path.join(root, "tanfig.json");
+  if (fs.existsSync(tanfigPath)) {
+    fs.copyFileSync(tanfigPath, path.join(buildDir, "tanfig.json"));
+  }
+  const titanConfigPath = path.join(root, "titan.json");
+  if (fs.existsSync(titanConfigPath)) {
+    fs.copyFileSync(titanConfigPath, path.join(buildDir, "titan.json"));
+  }
 
   // 4. Create .env
   fs.writeFileSync(path.join(buildDir, ".env"), "TITAN_DEV=0\n");

package/packages/packet/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@titanpl/packet",
-  "version": "4.0.2",
+  "version": "7.0.0-beta",
   "description": "The bundler for TitanPl servers.",
   "keywords": [
     "bundler",

package/packages/route/README.md

@@ -14,6 +14,9 @@ import t from "@titanpl/route";
 // Define an action-based route
 t.post("/hello").action("hello"); // pass a json payload { "name": "titan" }
 
+// Define a WebSocket route
+t.ws("/chat").action("chat");
+
 // Define a direct reply route
 t.get("/").reply("Ready to land on Titan Planet 🚀");
 
@@ -21,4 +24,22 @@ t.get("/").reply("Ready to land on Titan Planet 🚀");
 t.start(5100, "Titan Running!");
 ```
 
+### WebSocket Action Handling
+When using `t.ws()`, your action receives the `event`, `socketId`, and `body`:
+
+```javascript
+export const chat = (req) => {
+    const { event, socketId, body } = req;
+
+    if (event === "open") {
+        t.ws.send(socketId, "Connected to Titan Orbital Hub!");
+        t.ws.broadcast(`User ${socketId} has docked.`);
+    }
+
+    if (event === "message") {
+        t.ws.broadcast(`${socketId}: ${body}`);
+    }
+};
+```
+
 **Important Note:** Currently, Titan Planet and its entire package ecosystem are only for Windows. The Linux version is in development (dev only) for the new architecture and will be launched later.

package/packages/route/index.d.ts

@@ -8,6 +8,7 @@ export interface TitanRoute {
     post(route: string): RouteBuilder;
     put(route: string): RouteBuilder;
     delete(route: string): RouteBuilder;
+    ws(route: string): { action(name: string): void };
     log(module: string, msg: string): void;
     start(port?: number, msg?: string, threads?: number, stack_mb?: number): void;
 }