@weconjs/core 0.1.1

package/dist/socket/index.d.ts

@@ -0,0 +1,115 @@
+/**
+ * @weconjs/core - Socket.IO Integration
+ *
+ * Provides Socket.IO server setup, handler discovery, and middleware loading.
+ * Auto-discovers `*.socket.ts` files from module directories.
+ *
+ * @example
+ * ```typescript
+ * // src/modules/chat/socket/chat.socket.ts
+ * import { SocketHandler } from '@weconjs/core';
+ *
+ * const chatHandler: SocketHandler = (io, socket) => {
+ *   socket.on('message', (data) => {
+ *     io.emit('message', data);
+ *   });
+ * };
+ *
+ * export default chatHandler;
+ * ```
+ */
+import type { Server as HttpServer } from "http";
+import type { Server as HttpsServer } from "https";
+/**
+ * Socket.IO Server instance type
+ */
+export type SocketServer = import("socket.io").Server;
+/**
+ * Socket.IO Socket instance type
+ */
+export type SocketInstance = import("socket.io").Socket;
+/**
+ * Socket handler function signature
+ *
+ * Called when a client connects. Use this to set up event listeners.
+ */
+export type SocketHandler = (io: SocketServer, socket: SocketInstance) => void;
+/**
+ * Socket middleware function signature
+ *
+ * Called before the connection handler. Can be used for authentication.
+ */
+export type SocketMiddleware = (socket: SocketInstance, next: (err?: Error) => void) => void;
+/**
+ * Discovered socket handler with metadata
+ */
+export interface DiscoveredSocketHandler {
+    name: string;
+    namespace: string;
+    handler: SocketHandler;
+}
+/**
+ * Socket configuration options
+ */
+export interface SocketOptions {
+    /**
+     * Enable Socket.IO
+     */
+    enabled?: boolean;
+    /**
+     * CORS configuration
+     */
+    cors?: {
+        origin: string | string[];
+        methods?: string[];
+        credentials?: boolean;
+    };
+    /**
+     * Path for the Socket.IO endpoint
+     */
+    path?: string;
+}
+/**
+ * Create a Socket.IO server attached to an HTTP server
+ *
+ * @param httpServer - The HTTP/HTTPS server to attach to
+ * @param options - Socket configuration options
+ * @returns Socket.IO server instance
+ */
+export declare function createSocketServer(httpServer: HttpServer | HttpsServer, options?: SocketOptions): Promise<SocketServer>;
+/**
+ * Discover socket handlers in module directories
+ *
+ * Scans for `socket/*.socket.ts` files in each module.
+ *
+ * @param modulesDir - Path to the modules directory
+ * @returns Array of discovered socket handlers
+ */
+export declare function discoverSocketHandlers(modulesDir: string): Promise<DiscoveredSocketHandler[]>;
+/**
+ * Discover socket middleware in module directories
+ *
+ * Looks for `socket/socket.middleware.ts` in each module.
+ *
+ * @param modulesDir - Path to the modules directory
+ * @returns Array of socket middleware functions
+ */
+export declare function discoverSocketMiddleware(modulesDir: string): Promise<SocketMiddleware[]>;
+/**
+ * Initialize Socket.IO with discovered handlers and middleware
+ *
+ * @param io - Socket.IO server instance
+ * @param handlers - Discovered socket handlers
+ * @param middleware - Socket middleware functions
+ */
+export declare function initializeSocket(io: SocketServer, handlers: DiscoveredSocketHandler[], middleware?: SocketMiddleware[]): void;
+/**
+ * Full Socket.IO setup for a Wecon application
+ *
+ * @param httpServer - HTTP server to attach to
+ * @param modulesDir - Path to modules directory
+ * @param options - Socket configuration
+ * @returns Socket.IO server instance
+ */
+export declare function setupSocketIO(httpServer: HttpServer | HttpsServer, modulesDir: string, options?: SocketOptions): Promise<SocketServer | null>;
+//# sourceMappingURL=index.d.ts.map

package/dist/socket/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/socket/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,OAAO,CAAC;AAInD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,WAAW,EAAE,MAAM,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,WAAW,EAAE,MAAM,CAAC;AAExD;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;AAE/E;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,KAAK,IAAI,KACxB,IAAI,CAAC;AAEV;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,aAAa,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,IAAI,CAAC,EAAE;QACL,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;IAEF;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,UAAU,GAAG,WAAW,EACpC,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAavB;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,uBAAuB,EAAE,CAAC,CA2CpC;AAED;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAiC7B;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,YAAY,EAChB,QAAQ,EAAE,uBAAuB,EAAE,EACnC,UAAU,GAAE,gBAAgB,EAAO,GAClC,IAAI,CAyBN;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,UAAU,GAAG,WAAW,EACpC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAmB9B"}

package/dist/socket/index.js

@@ -0,0 +1,181 @@
+/**
+ * @weconjs/core - Socket.IO Integration
+ *
+ * Provides Socket.IO server setup, handler discovery, and middleware loading.
+ * Auto-discovers `*.socket.ts` files from module directories.
+ *
+ * @example
+ * ```typescript
+ * // src/modules/chat/socket/chat.socket.ts
+ * import { SocketHandler } from '@weconjs/core';
+ *
+ * const chatHandler: SocketHandler = (io, socket) => {
+ *   socket.on('message', (data) => {
+ *     io.emit('message', data);
+ *   });
+ * };
+ *
+ * export default chatHandler;
+ * ```
+ */
+import { glob } from "glob";
+import { basename, dirname } from "path";
+/**
+ * Create a Socket.IO server attached to an HTTP server
+ *
+ * @param httpServer - The HTTP/HTTPS server to attach to
+ * @param options - Socket configuration options
+ * @returns Socket.IO server instance
+ */
+export async function createSocketServer(httpServer, options = {}) {
+    // Dynamic import to avoid bundling issues
+    const { Server } = await import("socket.io");
+    const io = new Server(httpServer, {
+        path: options.path || "/socket.io",
+        cors: options.cors || {
+            origin: "*",
+            methods: ["GET", "POST"],
+        },
+    });
+    return io;
+}
+/**
+ * Discover socket handlers in module directories
+ *
+ * Scans for `socket/*.socket.ts` files in each module.
+ *
+ * @param modulesDir - Path to the modules directory
+ * @returns Array of discovered socket handlers
+ */
+export async function discoverSocketHandlers(modulesDir) {
+    const handlers = [];
+    try {
+        // Find all *.socket.ts files
+        const files = await glob("**/socket/*.socket.{ts,js}", {
+            cwd: modulesDir,
+            absolute: true,
+        });
+        for (const file of files) {
+            try {
+                const module = await import(file);
+                const handler = module.default;
+                if (typeof handler !== "function") {
+                    console.warn(`[Wecon] Socket file ${basename(file)} must export a default function`);
+                    continue;
+                }
+                // Extract handler name and module namespace
+                const fileName = basename(file).replace(/\.socket\.(ts|js)$/, "");
+                const moduleDir = dirname(dirname(file)); // Go up from socket/
+                const namespace = basename(moduleDir);
+                handlers.push({
+                    name: fileName,
+                    namespace,
+                    handler,
+                });
+                console.log(`[Wecon] Discovered socket handler: ${namespace}/${fileName}`);
+            }
+            catch (err) {
+                console.error(`[Wecon] Failed to load socket handler ${file}:`, err);
+            }
+        }
+    }
+    catch (err) {
+        console.warn("[Wecon] Failed to discover socket handlers:", err);
+    }
+    return handlers;
+}
+/**
+ * Discover socket middleware in module directories
+ *
+ * Looks for `socket/socket.middleware.ts` in each module.
+ *
+ * @param modulesDir - Path to the modules directory
+ * @returns Array of socket middleware functions
+ */
+export async function discoverSocketMiddleware(modulesDir) {
+    const middleware = [];
+    try {
+        // Find all socket.middleware.ts files
+        const files = await glob("**/socket/socket.middleware.{ts,js}", {
+            cwd: modulesDir,
+            absolute: true,
+        });
+        for (const file of files) {
+            try {
+                const module = await import(file);
+                const mw = module.default;
+                if (Array.isArray(mw)) {
+                    middleware.push(...mw.filter((m) => typeof m === "function"));
+                }
+                else if (typeof mw === "function") {
+                    middleware.push(mw);
+                }
+                else {
+                    console.warn(`[Wecon] ${file} must export a middleware function or array`);
+                }
+            }
+            catch (err) {
+                // File doesn't exist or error - skip
+            }
+        }
+    }
+    catch (err) {
+        console.warn("[Wecon] Failed to discover socket middleware:", err);
+    }
+    return middleware;
+}
+/**
+ * Initialize Socket.IO with discovered handlers and middleware
+ *
+ * @param io - Socket.IO server instance
+ * @param handlers - Discovered socket handlers
+ * @param middleware - Socket middleware functions
+ */
+export function initializeSocket(io, handlers, middleware = []) {
+    // Apply middleware
+    for (const mw of middleware) {
+        io.use(mw);
+    }
+    // Set up connection handler
+    io.on("connection", (socket) => {
+        console.log(`[Wecon] Socket connected: ${socket.id}`);
+        // Call all discovered handlers
+        for (const { handler, namespace, name } of handlers) {
+            try {
+                handler(io, socket);
+            }
+            catch (err) {
+                console.error(`[Wecon] Error in socket handler ${namespace}/${name}:`, err);
+            }
+        }
+        socket.on("disconnect", () => {
+            console.log(`[Wecon] Socket disconnected: ${socket.id}`);
+        });
+    });
+    console.log(`[Wecon] Socket.IO initialized with ${handlers.length} handlers`);
+}
+/**
+ * Full Socket.IO setup for a Wecon application
+ *
+ * @param httpServer - HTTP server to attach to
+ * @param modulesDir - Path to modules directory
+ * @param options - Socket configuration
+ * @returns Socket.IO server instance
+ */
+export async function setupSocketIO(httpServer, modulesDir, options = {}) {
+    if (options.enabled === false) {
+        console.log("[Wecon] Socket.IO disabled");
+        return null;
+    }
+    // Create Socket.IO server
+    const io = await createSocketServer(httpServer, options);
+    // Discover handlers and middleware
+    const [handlers, middleware] = await Promise.all([
+        discoverSocketHandlers(modulesDir),
+        discoverSocketMiddleware(modulesDir),
+    ]);
+    // Initialize
+    initializeSocket(io, handlers, middleware);
+    return io;
+}
+//# sourceMappingURL=index.js.map

package/dist/socket/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/socket/index.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,294 @@
+/**
+ * @wecon/core - Core Types
+ *
+ * Type definitions for the Wecon framework configuration and modules.
+ */
+import type { Application, Request, Response, NextFunction } from "express";
+import type { Server, Socket } from "socket.io";
+import type { z } from "zod";
+/**
+ * App metadata configuration
+ */
+export interface AppConfig {
+    name: string;
+    version?: string;
+}
+/**
+ * Database configuration
+ */
+export interface DatabaseConfig {
+    debug?: boolean;
+    mongoose?: {
+        protocol?: string;
+        host?: string;
+        port?: number;
+        database?: string;
+        auth?: {
+            username?: string;
+            password?: string;
+        };
+    };
+}
+/**
+ * Logging configuration
+ */
+export interface LoggingConfig {
+    level?: "debug" | "info" | "warn" | "error";
+    format?: string;
+    enableConsole?: boolean;
+    enableFile?: boolean;
+    filePath?: string;
+}
+/**
+ * HTTPS configuration
+ */
+export interface HttpsConfig {
+    enabled?: boolean;
+    port?: number;
+    keyPath?: string;
+    certPath?: string;
+}
+/**
+ * Socket configuration
+ */
+export interface SocketConfig {
+    enabled?: boolean;
+    path?: string;
+    cors?: {
+        origin?: string | string[];
+        methods?: string[];
+        credentials?: boolean;
+    };
+}
+/**
+ * Feature flags configuration
+ */
+export interface FeaturesConfig {
+    fieldShield?: {
+        enabled?: boolean;
+        strict?: boolean;
+    };
+    i18n?: {
+        enabled?: boolean;
+        defaultLocale?: string;
+        supported?: string[];
+    };
+    swagger?: {
+        enabled?: boolean;
+        path?: string;
+    };
+    socket?: SocketConfig;
+}
+/**
+ * Mode-specific configuration
+ */
+export interface ModeConfig {
+    extends?: string;
+    port?: number;
+    database?: DatabaseConfig;
+    logging?: LoggingConfig;
+    https?: HttpsConfig;
+    [key: string]: unknown;
+}
+/**
+ * Lifecycle hooks
+ */
+export interface WeconHooks {
+    onBoot?: (app: Application, ctx: WeconContext) => Promise<void> | void;
+    onShutdown?: (ctx: WeconContext) => Promise<void> | void;
+    onModuleInit?: (moduleName: string, ctx: WeconContext) => Promise<void> | void;
+}
+/**
+ * Main Wecon configuration
+ */
+export interface WeconConfig {
+    app: AppConfig;
+    modes?: Record<string, ModeConfig>;
+    modules?: string[];
+    features?: FeaturesConfig;
+    hooks?: WeconHooks;
+}
+/**
+ * Resolved configuration (after mode merging)
+ */
+export interface ResolvedConfig {
+    app: Required<AppConfig>;
+    mode: string;
+    port: number;
+    database: DatabaseConfig;
+    logging: LoggingConfig;
+    https: HttpsConfig;
+    features: FeaturesConfig;
+    modules: string[];
+}
+/**
+ * Module-specific configuration with Zod schema
+ */
+export interface ModuleConfigDefinition<T extends z.ZodType = z.ZodType> {
+    schema: T;
+    defaults?: Partial<z.infer<T>>;
+}
+/**
+ * Module definition input
+ */
+export interface ModuleDefinition {
+    name: string;
+    namespace?: string;
+    description?: string;
+    config?: ModuleConfigDefinition;
+    routes?: unknown;
+    imports?: string[];
+    exports?: string[];
+    onInit?: (ctx: WeconContext) => Promise<void> | void;
+    onDestroy?: (ctx: WeconContext) => Promise<void> | void;
+}
+/**
+ * Registered module (with computed defaults)
+ */
+export interface WeconModule extends ModuleDefinition {
+    namespace: string;
+    description: string;
+    socketHandlers?: SocketHandler[];
+    socketMiddleware?: SocketMiddleware[];
+}
+/**
+ * Socket handler function signature
+ */
+export type SocketHandler = (socket: Socket, ctx: WeconContext) => void;
+/**
+ * Socket middleware function signature
+ */
+export type SocketMiddleware = (socket: Socket, next: (err?: Error) => void, ctx: WeconContext) => void | Promise<void>;
+/**
+ * Logger interface
+ */
+export interface WeconLogger {
+    debug(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, meta?: Record<string, unknown>): void;
+}
+/**
+ * Services container
+ */
+export interface WeconServices {
+    [key: string]: unknown;
+}
+/**
+ * Application context passed to handlers, middleware, and hooks
+ */
+export interface WeconContext {
+    /** Resolved configuration */
+    config: ResolvedConfig;
+    /** Logger instance */
+    logger: WeconLogger;
+    /** Registered services */
+    services: WeconServices;
+    /** Express application */
+    app: Application;
+    /** Socket.IO server (if enabled) */
+    io?: Server;
+    /** Get a specific service */
+    getService<T>(name: string): T | undefined;
+    /** Register a service */
+    registerService(name: string, service: unknown): void;
+}
+/**
+ * Base interface for all authenticable models.
+ *
+ * Any model that can be used for authentication (User, Admin, ServiceAccount, etc.)
+ * must implement this interface.
+ *
+ * @example
+ * ```typescript
+ * interface User extends Authenticable {
+ *   email: string;
+ *   name: { first: string; last: string };
+ * }
+ *
+ * interface Admin extends Authenticable {
+ *   permissions: string[];
+ *   department: string;
+ * }
+ * ```
+ */
+export interface Authenticable {
+    /** Unique identifier (MongoDB ObjectId or string) */
+    _id: unknown;
+    /** Primary role of the user */
+    role: string;
+    /** All roles assigned to the user */
+    roles: string[];
+    /** Model name for role-agnostic auth (e.g., 'User', 'Admin') */
+    __modelName?: string;
+}
+/**
+ * Authentication configuration for features
+ */
+export interface AuthConfig {
+    /** List of authenticable model names */
+    authenticables?: string[];
+    /** Default model to use for authentication */
+    defaultModel?: string;
+    /** JWT configuration */
+    jwt?: {
+        secret?: string;
+        expiresIn?: number;
+        algorithm?: string;
+    };
+    /** Session configuration */
+    session?: {
+        name?: string;
+        maxAge?: number;
+        secure?: boolean;
+    };
+}
+/**
+ * Extended Express Request with Wecon context and typed user.
+ *
+ * The `TUser` generic parameter allows type-safe access to the authenticated user.
+ *
+ * @example
+ * ```typescript
+ * // Single model
+ * app.get('/profile', (req: WeconRequest<User>, res) => {
+ *   req.user?.email; // ✅ TypeScript knows about email
+ * });
+ *
+ * // Multiple models (union type)
+ * type AuthUser = User | Admin;
+ * app.get('/dashboard', (req: WeconRequest<AuthUser>, res) => {
+ *   if (req.user && 'permissions' in req.user) {
+ *     // It's an Admin
+ *   }
+ * });
+ * ```
+ */
+export interface WeconRequest<TUser extends Authenticable = Authenticable> extends Request {
+    /** Wecon application context */
+    ctx: WeconContext;
+    /** Authenticated user (typed based on TUser generic) */
+    user?: TUser;
+    /** i18n translation function */
+    t: (key: string, options?: Record<string, unknown>) => string;
+}
+/**
+ * Extended Express Response with helpers
+ */
+export interface WeconResponse extends Response {
+    respond: (data: {
+        data?: unknown;
+        message?: string;
+        status?: number;
+        meta?: Record<string, unknown>;
+    }) => void;
+}
+/**
+ * Route handler type with generic user
+ */
+export type RouteHandler<TUser extends Authenticable = Authenticable> = (req: WeconRequest<TUser>, res: WeconResponse, next: NextFunction) => void | Promise<void>;
+/**
+ * Middleware type with generic user
+ */
+export type WeconMiddleware<TUser extends Authenticable = Authenticable> = (req: WeconRequest<TUser>, res: WeconResponse, next: NextFunction) => void | Promise<void>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * @wecon/core - Core Types
+ *
+ * Type definitions for the Wecon framework configuration and modules.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@weconjs/core",
+  "version": "0.1.1",
+  "description": "Wecon Framework Core - defineConfig, defineModule, and runtime utilities",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "glob": "^10.3.10",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^20.10.0",
+    "express": "^5.0.1",
+    "mongoose": "^8.0.0",
+    "socket.io": "^4.8.1",
+    "typescript": "^5.3.3",
+    "vitest": "^4.0.15"
+  },
+  "peerDependencies": {
+    "express": "^5.0.0",
+    "mongoose": "^8.0.0",
+    "socket.io": "^4.6.0"
+  },
+  "peerDependenciesMeta": {
+    "socket.io": {
+      "optional": true
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "wecon",
+    "framework",
+    "express",
+    "typescript",
+    "modular"
+  ],
+  "author": "kemora13conf",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/weconjs/core.git"
+  },
+  "homepage": "https://github.com/weconjs/core#readme",
+  "bugs": {
+    "url": "https://github.com/weconjs/core/issues"
+  }
+}