@weconjs/core 0.2.0 → 1.1.0

package/dist/routing/RoutesParam.js

@@ -0,0 +1,113 @@
+import { randomUUID } from "crypto";
+import ErrorCatcher from "./ErrorCatcher.js";
+import errors from "../errors/index.js";
+/**
+ * Parameter handler with optional validation rules.
+ * Attached to Routes to validate and process URL params (e.g. :userId).
+ */
+class RoutesParam extends ErrorCatcher {
+    uuid;
+    path;
+    middleware;
+    validate;
+    constructor(path, middleware, validate) {
+        super();
+        this.uuid = randomUUID();
+        this.path = path;
+        this.middleware = middleware;
+        this.validate = validate;
+        try {
+            this.validateParam();
+        }
+        catch (err) {
+            const errInfo = ErrorCatcher.getCallerInfo();
+            this.handleConfigError(err, errInfo);
+        }
+    }
+    validateParam() {
+        if (!this.path) {
+            throw new errors.ConfigError("ROUTES_PARAM:MISSING_PATH");
+        }
+        if (!this.middleware) {
+            throw new errors.ConfigError("ROUTES_PARAM:MISSING_MIDDLEWARE");
+        }
+        if (this.validate) {
+            if (typeof this.validate !== "object" || Array.isArray(this.validate)) {
+                throw new errors.ConfigError("ROUTES_PARAM:INVALID_VALIDATE_TYPE");
+            }
+            if (this.validate.pattern && !(this.validate.pattern instanceof RegExp)) {
+                throw new errors.ConfigError("ROUTES_PARAM:INVALID_PATTERN_TYPE");
+            }
+            if (this.validate.minLength !== undefined && typeof this.validate.minLength !== "number") {
+                throw new errors.ConfigError("ROUTES_PARAM:INVALID_MIN_LENGTH_TYPE");
+            }
+            if (this.validate.maxLength !== undefined && typeof this.validate.maxLength !== "number") {
+                throw new errors.ConfigError("ROUTES_PARAM:INVALID_MAX_LENGTH_TYPE");
+            }
+            if (this.validate.validatorFn && typeof this.validate.validatorFn !== "function") {
+                throw new errors.ConfigError("ROUTES_PARAM:INVALID_VALIDATOR_FN_TYPE");
+            }
+        }
+    }
+    handleConfigError(err, errInfo) {
+        const POSSIBLE_ERRORS = {
+            "ROUTES_PARAM:INVALID_VALIDATE_TYPE": {
+                title: "Invalid 'validate' property type",
+                details: "The 'validate' property must be an object, but received: " + typeof this.validate,
+                fix: "Ensure validate is an object:\n    validate: { pattern: /regex/, minLength: 3 }",
+            },
+            "ROUTES_PARAM:MISSING_PATH": {
+                title: "Missing required 'path' parameter",
+                details: "The RoutesParam instance requires a 'path' to be defined",
+                fix: "Provide a path parameter:\n    new RoutesParam('userId', middleware)",
+            },
+            "ROUTES_PARAM:MISSING_MIDDLEWARE": {
+                title: "Missing required 'middleware' parameter",
+                details: "The RoutesParam instance requires a 'middleware' function",
+                fix: "Provide a middleware function:\n    new RoutesParam('userId', (req, res, next, id) => { next() })",
+            },
+            "ROUTES_PARAM:INVALID_PATTERN_TYPE": {
+                title: "Invalid 'validate.pattern' property type",
+                details: "The 'validate.pattern' must be a RegExp, but received: " + typeof this.validate?.pattern,
+                fix: "Ensure pattern is a RegExp:\n    validate: { pattern: /^[0-9]+$/ }",
+            },
+            "ROUTES_PARAM:INVALID_MIN_LENGTH_TYPE": {
+                title: "Invalid 'validate.minLength' property type",
+                details: "The 'validate.minLength' must be a number, but received: " + typeof this.validate?.minLength,
+                fix: "Ensure minLength is a number:\n    validate: { minLength: 3 }",
+            },
+            "ROUTES_PARAM:INVALID_MAX_LENGTH_TYPE": {
+                title: "Invalid 'validate.maxLength' property type",
+                details: "The 'validate.maxLength' must be a number, but received: " + typeof this.validate?.maxLength,
+                fix: "Ensure maxLength is a number:\n    validate: { maxLength: 50 }",
+            },
+            "ROUTES_PARAM:INVALID_VALIDATOR_FN_TYPE": {
+                title: "Invalid 'validate.validatorFn' property type",
+                details: "The 'validate.validatorFn' must be a function, but received: " + typeof this.validate?.validatorFn,
+                fix: "Ensure validatorFn is a function:\n    validate: { validatorFn: (value) => value.startsWith('user-') }",
+            },
+        };
+        const errorConfig = POSSIBLE_ERRORS[err.message] || {
+            title: err.message,
+            details: "An unexpected error occurred",
+            fix: "Please check your RoutesParam configuration",
+        };
+        ErrorCatcher.logError(errorConfig, errInfo);
+    }
+    /** Run all validation rules against a param value */
+    validateValue(value) {
+        if (!this.validate)
+            return true;
+        if (this.validate.pattern && !this.validate.pattern.test(value))
+            return false;
+        if (this.validate.minLength !== undefined && value.length < this.validate.minLength)
+            return false;
+        if (this.validate.maxLength !== undefined && value.length > this.validate.maxLength)
+            return false;
+        if (this.validate.validatorFn && !this.validate.validatorFn(value))
+            return false;
+        return true;
+    }
+}
+export default RoutesParam;
+//# sourceMappingURL=RoutesParam.js.map

package/dist/routing/RoutesParam.js.map

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

package/dist/routing/Wecon.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Wecon - Express.js routing with built-in RBAC
+ *
+ * Two-layer request processing:
+ * 1. Intelligence Layer: RaiMatcher validates and authorizes requests
+ * 2. Execution Layer: Single master Express Router handles the request
+ */
+import type { RequestHandler } from "express";
+import type { RAI, DefaultRole } from "../types.js";
+import Routes from "./Routes.js";
+import Route from "./Route.js";
+/** Development mode configuration */
+export interface WeconDevConfig {
+    /** Enable debug mode with verbose logging */
+    debugMode?: boolean;
+    /** Provide helpful error suggestions */
+    helpfulErrors?: boolean;
+    /** Log registered routes on startup */
+    logRoutes?: boolean;
+}
+/**
+ * Main Wecon class with fluent API.
+ * Compiles routes into a single master router with RBAC enforcement.
+ */
+declare class Wecon<TRole extends string = DefaultRole> {
+    private _routes?;
+    private _roles;
+    private _guestRole;
+    private _onRoutesPrepared?;
+    private _dev?;
+    private _raiMatcher?;
+    private _masterRouter?;
+    private _built;
+    private _raisMap?;
+    private _middleware?;
+    constructor();
+    /** Set the root routes */
+    routes(routes: Routes<TRole>): this;
+    /** Define available roles */
+    roles<T extends string>(roles: readonly T[]): Wecon<T>;
+    /** Set guest role for unauthenticated users */
+    guestRole(guestRole: string): this;
+    /** Set callback for when routes are compiled */
+    onRoutesPrepared(callback: (routes: Route[]) => void | Promise<void>): this;
+    /** Configure development mode options */
+    dev(config: WeconDevConfig): this;
+    /**
+     * Compile all routes into the middleware.
+     * Must be called before using the Wecon instance.
+     */
+    build(): this;
+    /** Sort routes: static segments before dynamic */
+    private compareRoutes;
+    /** Create the main Express middleware (intelligence + execution layers) */
+    private createMiddleware;
+    private createHelpfulNotFoundError;
+    private createHelpfulUnauthorizedError;
+    /** Get all registered routes (must call build() first) */
+    getRoutes(): Route[];
+    /** Get a route by RAI */
+    getRoute(rai: RAI): Route | undefined;
+    /** Get the Express middleware function */
+    handler(): RequestHandler;
+}
+export default Wecon;
+//# sourceMappingURL=Wecon.d.ts.map

package/dist/routing/Wecon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Wecon.d.ts","sourceRoot":"","sources":["../../src/routing/Wecon.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAGV,cAAc,EAGf,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,KAAK,MAAM,YAAY,CAAC;AAI/B,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wCAAwC;IACxC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uCAAuC;IACvC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,cAAM,KAAK,CAAC,KAAK,SAAS,MAAM,GAAG,WAAW;IAC5C,OAAO,CAAC,OAAO,CAAC,CAAgB;IAChC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,iBAAiB,CAAC,CAAmD;IAC7E,OAAO,CAAC,IAAI,CAAC,CAAiB;IAE9B,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,aAAa,CAAC,CAAS;IAE/B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAAC,CAAyB;IAC1C,OAAO,CAAC,WAAW,CAAC,CAAiB;;IAIrC,0BAA0B;IACnB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI;IAW1C,6BAA6B;IACtB,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;IAW7D,+CAA+C;IACxC,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAWzC,gDAAgD;IACzC,gBAAgB,CACrB,QAAQ,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAClD,IAAI;IAWP,yCAAyC;IAClC,GAAG,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAQxC;;;OAGG;IACI,KAAK,IAAI,IAAI;IA+EpB,kDAAkD;IAClD,OAAO,CAAC,aAAa;IAsBrB,2EAA2E;IAC3E,OAAO,CAAC,gBAAgB;IAiDxB,OAAO,CAAC,0BAA0B;IAelC,OAAO,CAAC,8BAA8B;IAatC,0DAA0D;IACnD,SAAS,IAAI,KAAK,EAAE;IAO3B,yBAAyB;IAClB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,KAAK,GAAG,SAAS;IAO5C,0CAA0C;IACnC,OAAO,IAAI,cAAc;CAMjC;AAED,eAAe,KAAK,CAAC"}

package/dist/routing/Wecon.js

@@ -0,0 +1,248 @@
+/**
+ * Wecon - Express.js routing with built-in RBAC
+ *
+ * Two-layer request processing:
+ * 1. Intelligence Layer: RaiMatcher validates and authorizes requests
+ * 2. Execution Layer: Single master Express Router handles the request
+ */
+import Routes from "./Routes.js";
+import errors from "../errors/index.js";
+import RaiMatcher from "./RaiMatcher.js";
+/**
+ * Main Wecon class with fluent API.
+ * Compiles routes into a single master router with RBAC enforcement.
+ */
+class Wecon {
+    _routes;
+    _roles = [];
+    _guestRole = "guest";
+    _onRoutesPrepared;
+    _dev;
+    _raiMatcher;
+    _masterRouter;
+    _built = false;
+    _raisMap;
+    _middleware;
+    constructor() { }
+    /** Set the root routes */
+    routes(routes) {
+        if (this._built) {
+            throw new Error("Cannot modify Wecon after build() has been called");
+        }
+        if (!(routes instanceof Routes)) {
+            throw new Error("routes() must receive an instance of the Routes class");
+        }
+        this._routes = routes;
+        return this;
+    }
+    /** Define available roles */
+    roles(roles) {
+        if (this._built) {
+            throw new Error("Cannot modify Wecon after build() has been called");
+        }
+        if (!Array.isArray(roles)) {
+            throw new Error("roles() must receive an array of strings");
+        }
+        this._roles = [...roles];
+        return this;
+    }
+    /** Set guest role for unauthenticated users */
+    guestRole(guestRole) {
+        if (this._built) {
+            throw new Error("Cannot modify Wecon after build() has been called");
+        }
+        if (typeof guestRole !== "string") {
+            throw new Error("guestRole() must receive a string");
+        }
+        this._guestRole = guestRole;
+        return this;
+    }
+    /** Set callback for when routes are compiled */
+    onRoutesPrepared(callback) {
+        if (this._built) {
+            throw new Error("Cannot modify Wecon after build() has been called");
+        }
+        if (typeof callback !== "function") {
+            throw new Error("onRoutesPrepared() must receive a function");
+        }
+        this._onRoutesPrepared = callback;
+        return this;
+    }
+    /** Configure development mode options */
+    dev(config) {
+        if (this._built) {
+            throw new Error("Cannot modify Wecon after build() has been called");
+        }
+        this._dev = config;
+        return this;
+    }
+    /**
+     * Compile all routes into the middleware.
+     * Must be called before using the Wecon instance.
+     */
+    build() {
+        if (this._built)
+            throw new Error("build() can only be called once");
+        if (!this._routes)
+            throw new Error("routes() must be called before build()");
+        if (this._roles.length === 0)
+            throw new Error("roles() missing");
+        this._built = true;
+        this._raisMap = this._routes.groupRoutesByRai();
+        // 1. Initialize RAI Matcher
+        const routesList = Array.from(this._raisMap.values()).map((r) => ({
+            path: r.path,
+            method: r.method,
+            rai: r.rai,
+        }));
+        this._raiMatcher = new RaiMatcher(routesList);
+        // 2. Create master router (dynamic import would be async, so we use require-style)
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { Router: ExpressRouter } = require("express");
+        this._masterRouter = ExpressRouter({ mergeParams: true });
+        // 3. Sort routes by specificity (static before dynamic)
+        const sortedRoutes = Array.from(this._raisMap.values()).sort(this.compareRoutes);
+        // 4. Register all routes on the master router
+        sortedRoutes.forEach((route) => {
+            // Register param handlers
+            route.params?.forEach((param) => {
+                this._masterRouter.param(param.path, param.middleware);
+                if (param.validate) {
+                    this._masterRouter.param(param.path, (_req, _res, next, val) => {
+                        if (!param.validateValue(val)) {
+                            return next(new errors.RequestError("Invalid Parameter", {
+                                code: "INVALID_PARAM",
+                            }));
+                        }
+                        next();
+                    });
+                }
+            });
+            // Register route by method
+            switch (route.method) {
+                case "GET":
+                    this._masterRouter.get(route.path, ...route.middlewares);
+                    break;
+                case "POST":
+                    this._masterRouter.post(route.path, ...route.middlewares);
+                    break;
+                case "PUT":
+                    this._masterRouter.put(route.path, ...route.middlewares);
+                    break;
+                case "DELETE":
+                    this._masterRouter.delete(route.path, ...route.middlewares);
+                    break;
+            }
+        });
+        // 5. Create the intelligence layer middleware
+        this._middleware = this.createMiddleware();
+        // 6. Notify callback
+        if (this._onRoutesPrepared) {
+            const result = this._onRoutesPrepared(sortedRoutes);
+            if (result instanceof Promise) {
+                result.catch((err) => {
+                    console.error("Error in onRoutesPrepared callback:", err);
+                });
+            }
+        }
+        return this;
+    }
+    /** Sort routes: static segments before dynamic */
+    compareRoutes(a, b) {
+        const aSegments = a.path.split("/").filter(Boolean);
+        const bSegments = b.path.split("/").filter(Boolean);
+        const len = Math.max(aSegments.length, bSegments.length);
+        for (let i = 0; i < len; i++) {
+            const segA = aSegments[i];
+            const segB = bSegments[i];
+            if (segA === undefined)
+                return 1;
+            if (segB === undefined)
+                return -1;
+            const aIsDynamic = segA.startsWith(":");
+            const bIsDynamic = segB.startsWith(":");
+            if (aIsDynamic && !bIsDynamic)
+                return 1;
+            if (!aIsDynamic && bIsDynamic)
+                return -1;
+        }
+        return b.path.length - a.path.length;
+    }
+    /** Create the main Express middleware (intelligence + execution layers) */
+    createMiddleware() {
+        return async (req, res, next) => {
+            try {
+                // Intelligence Layer: match RAI and check authorization
+                const path = req.path;
+                const reqRai = this._raiMatcher.findRai(path, req.method);
+                if (!reqRai) {
+                    const errorPath = req.originalUrl.split("?")[0];
+                    res.status(404);
+                    return next(new errors.RequestError(this._dev?.helpfulErrors
+                        ? this.createHelpfulNotFoundError(errorPath, req.method)
+                        : `Route not found`, { code: "RAI_NOT_FOUND" }));
+                }
+                const route = this._raisMap.get(reqRai);
+                req.rai = reqRai;
+                req.route_instance = route;
+                const user = req.user;
+                const userRoles = user?.roles || [this._guestRole];
+                if (!route.isAuthorized(userRoles)) {
+                    const isGuest = userRoles.includes(this._guestRole) && userRoles.length === 1;
+                    res.status(isGuest ? 401 : 403);
+                    return next(new errors.RequestError(this._dev?.helpfulErrors
+                        ? this.createHelpfulUnauthorizedError(route, userRoles)
+                        : `Unauthorized`, { code: "UNAUTHORIZED" }));
+                }
+                // Execution Layer: delegate to master router
+                return this._masterRouter(req, res, next);
+            }
+            catch (error) {
+                return next(error);
+            }
+        };
+    }
+    createHelpfulNotFoundError(path, method) {
+        const availableRoutes = Array.from(this._raisMap.values())
+            .filter((r) => r.method === method)
+            .map((r) => r.path);
+        let message = `No route found for ${method} ${path}`;
+        if (availableRoutes.length > 0) {
+            message += `\n\nAvailable ${method} routes:\n`;
+            availableRoutes.forEach((route) => {
+                message += `  - ${route}\n`;
+            });
+        }
+        return message;
+    }
+    createHelpfulUnauthorizedError(route, userRoles) {
+        const isGuest = userRoles.length === 1 && userRoles[0] === this._guestRole;
+        if (isGuest) {
+            return `Authentication required to access ${route.method} ${route.path}\n\nThis route requires one of the following roles: ${route.roles.join(", ")}`;
+        }
+        return `Insufficient permissions to access ${route.method} ${route.path}\n\nRequired roles: ${route.roles.join(", ")}\nYour roles: ${userRoles.join(", ")}`;
+    }
+    /** Get all registered routes (must call build() first) */
+    getRoutes() {
+        if (!this._built) {
+            throw new Error("Cannot get routes before build() is called");
+        }
+        return Array.from(this._raisMap.values());
+    }
+    /** Get a route by RAI */
+    getRoute(rai) {
+        if (!this._built) {
+            throw new Error("Cannot get route before build() is called");
+        }
+        return this._raisMap.get(rai);
+    }
+    /** Get the Express middleware function */
+    handler() {
+        if (!this._built) {
+            throw new Error("Cannot get handler before build() is called. Make sure to call build() first.");
+        }
+        return this._middleware;
+    }
+}
+export default Wecon;
+//# sourceMappingURL=Wecon.js.map

package/dist/routing/Wecon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Wecon.js","sourceRoot":"","sources":["../../src/routing/Wecon.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,UAAU,MAAM,iBAAiB,CAAC;AAYzC;;;GAGG;AACH,MAAM,KAAK;IACD,OAAO,CAAiB;IACxB,MAAM,GAAY,EAAE,CAAC;IACrB,UAAU,GAAW,OAAO,CAAC;IAC7B,iBAAiB,CAAoD;IACrE,IAAI,CAAkB;IAEtB,WAAW,CAAc;IACzB,aAAa,CAAU;IAEvB,MAAM,GAAY,KAAK,CAAC;IACxB,QAAQ,CAA0B;IAClC,WAAW,CAAkB;IAErC,gBAAe,CAAC;IAEhB,0BAA0B;IACnB,MAAM,CAAC,MAAqB;QACjC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,CAAC,MAAM,YAAY,MAAM,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6BAA6B;IACtB,KAAK,CAAmB,KAAmB;QAChD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACA,IAA4B,CAAC,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;QAClD,OAAO,IAA2B,CAAC;IACrC,CAAC;IAED,+CAA+C;IACxC,SAAS,CAAC,SAAiB;QAChC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gDAAgD;IACzC,gBAAgB,CACrB,QAAmD;QAEnD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,CAAC,iBAAiB,GAAG,QAAQ,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,yCAAyC;IAClC,GAAG,CAAC,MAAsB;QAC/B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACI,KAAK;QACV,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC7E,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAEjE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAEhD,4BAA4B;QAC5B,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAChE,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,GAAG,EAAE,CAAC,CAAC,GAAG;SACX,CAAC,CAAC,CAAC;QACJ,IAAI,CAAC,WAAW,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;QAE9C,mFAAmF;QACnF,iEAAiE;QACjE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QACrD,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAW,CAAC;QAEpE,wDAAwD;QACxD,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAC1D,IAAI,CAAC,aAAa,CACnB,CAAC;QAEF,8CAA8C;QAC9C,YAAY,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YAC7B,0BAA0B;YAC1B,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC9B,IAAI,CAAC,aAAc,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;gBAExD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACnB,IAAI,CAAC,aAAc,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;wBAC9D,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;4BAC9B,OAAO,IAAI,CACT,IAAI,MAAM,CAAC,YAAY,CAAC,mBAAmB,EAAE;gCAC3C,IAAI,EAAE,eAAe;6BACtB,CAAC,CACH,CAAC;wBACJ,CAAC;wBACD,IAAI,EAAE,CAAC;oBACT,CAAC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,2BAA2B;YAC3B,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;gBACrB,KAAK,KAAK;oBACR,IAAI,CAAC,aAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;oBAC1D,MAAM;gBACR,KAAK,MAAM;oBACT,IAAI,CAAC,aAAc,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;oBAC3D,MAAM;gBACR,KAAK,KAAK;oBACR,IAAI,CAAC,aAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;oBAC1D,MAAM;gBACR,KAAK,QAAQ;oBACX,IAAI,CAAC,aAAc,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;oBAC7D,MAAM;YACV,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,8CAA8C;QAC9C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAE3C,qBAAqB;QACrB,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;YACpD,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;gBAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;oBACnB,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,GAAG,CAAC,CAAC;gBAC5D,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kDAAkD;IAC1C,aAAa,CAAC,CAAQ,EAAE,CAAQ;QACtC,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;QAEzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAE1B,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO,CAAC,CAAC;YACjC,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO,CAAC,CAAC,CAAC;YAElC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACxC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YAExC,IAAI,UAAU,IAAI,CAAC,UAAU;gBAAE,OAAO,CAAC,CAAC;YACxC,IAAI,CAAC,UAAU,IAAI,UAAU;gBAAE,OAAO,CAAC,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;IACvC,CAAC;IAED,2EAA2E;IACnE,gBAAgB;QACtB,OAAO,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAE,EAAE;YAC/D,IAAI,CAAC;gBACH,wDAAwD;gBACxD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;gBACtB,MAAM,MAAM,GAAG,IAAI,CAAC,WAAY,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;gBAE3D,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,MAAM,SAAS,GAAG,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;oBAChD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;oBAChB,OAAO,IAAI,CACT,IAAI,MAAM,CAAC,YAAY,CACrB,IAAI,CAAC,IAAI,EAAE,aAAa;wBACtB,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC;wBACxD,CAAC,CAAC,iBAAiB,EACrB,EAAE,IAAI,EAAE,eAAe,EAAE,CAC1B,CACF,CAAC;gBACJ,CAAC;gBAED,MAAM,KAAK,GAAG,IAAI,CAAC,QAAS,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC;gBAC1C,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC;gBACjB,GAAG,CAAC,cAAc,GAAG,KAAK,CAAC;gBAE3B,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;gBACtB,MAAM,SAAS,GAAa,IAAI,EAAE,KAAK,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAE7D,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,CAAC;oBACnC,MAAM,OAAO,GACX,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC;oBAChE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;oBAChC,OAAO,IAAI,CACT,IAAI,MAAM,CAAC,YAAY,CACrB,IAAI,CAAC,IAAI,EAAE,aAAa;wBACtB,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,KAAK,EAAE,SAAS,CAAC;wBACvD,CAAC,CAAC,cAAc,EAClB,EAAE,IAAI,EAAE,cAAc,EAAE,CACzB,CACF,CAAC;gBACJ,CAAC;gBAED,6CAA6C;gBAC7C,OAAO,IAAI,CAAC,aAAc,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAEO,0BAA0B,CAAC,IAAY,EAAE,MAAc;QAC7D,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAS,CAAC,MAAM,EAAE,CAAC;aACxD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC;aAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAEtB,IAAI,OAAO,GAAG,sBAAsB,MAAM,IAAI,IAAI,EAAE,CAAC;QACrD,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,iBAAiB,MAAM,YAAY,CAAC;YAC/C,eAAe,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;gBAChC,OAAO,IAAI,OAAO,KAAK,IAAI,CAAC;YAC9B,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,8BAA8B,CACpC,KAAY,EACZ,SAAmB;QAEnB,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,UAAU,CAAC;QAE3E,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,qCAAqC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,uDAAuD,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACxJ,CAAC;QAED,OAAO,sCAAsC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,uBAAuB,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAC9J,CAAC;IAED,0DAA0D;IACnD,SAAS;QACd,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,yBAAyB;IAClB,QAAQ,CAAC,GAAQ;QACtB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,IAAI,CAAC,QAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,0CAA0C;IACnC,OAAO;QACZ,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC;QACnG,CAAC;QACD,OAAO,IAAI,CAAC,WAAY,CAAC;IAC3B,CAAC;CACF;AAED,eAAe,KAAK,CAAC"}

package/dist/routing/index.d.ts

@@ -0,0 +1,9 @@
+export { default as Wecon } from "./Wecon.js";
+export type { WeconDevConfig } from "./Wecon.js";
+export { default as Route } from "./Route.js";
+export { default as Routes } from "./Routes.js";
+export { default as RoutesParam } from "./RoutesParam.js";
+export { default as RaiMatcher } from "./RaiMatcher.js";
+export type { RaiRoutesList } from "./RaiMatcher.js";
+export { ErrorCatcher } from "./ErrorCatcher.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/routing/index.js

@@ -0,0 +1,7 @@
+export { default as Wecon } from "./Wecon.js";
+export { default as Route } from "./Route.js";
+export { default as Routes } from "./Routes.js";
+export { default as RoutesParam } from "./RoutesParam.js";
+export { default as RaiMatcher } from "./RaiMatcher.js";
+export { ErrorCatcher } from "./ErrorCatcher.js";
+//# sourceMappingURL=index.js.map

package/dist/routing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/server/index.d.ts

@@ -24,7 +24,9 @@ import http from "http";
 import https from "https";
 import type { Application, RequestHandler } from "express";
 import type { ResolvedConfig, WeconModule, WeconContext } from "../types.js";
+import type Wecon from "../routing/Wecon.js";
 import { type DatabaseConnection } from "../database/index.js";
+import { type DevToolsOptions } from "../devtools/index.js";
 /**
  * API Error format
  */
@@ -64,12 +66,10 @@ export interface CreateWeconOptions {
      */
     modules: WeconModule[];
     /**
-     * The @weconjs/lib Wecon instance (for route handling)
-     * If provided, wecon.handler() is mounted automatically
+     * The Wecon routing instance (for route handling).
+     * If provided, wecon.handler() is mounted automatically.
      */
-    wecon?: {
-        handler: () => RequestHandler;
-    };
+    wecon?: Wecon;
     /**
      * Custom middleware to apply before routes
      */
@@ -140,6 +140,30 @@ export interface CreateWeconOptions {
          */
         logDir?: string;
     };
+    /**
+     * Module dependency options
+     */
+    moduleDeps?: {
+        /**
+         * Auto-install missing module dependencies
+         * @default true in development, false in production
+         */
+        autoInstall?: boolean;
+        /**
+         * Root directory for resolving module paths and node_modules
+         * @default process.cwd()
+         */
+        rootDir?: string;
+        /**
+         * Module paths (keyed by module name) for dependency checking.
+         * If not provided, dependency checking is skipped.
+         */
+        paths?: Record<string, string>;
+    };
+    /**
+     * DevTools REST API options
+     */
+    devtools?: DevToolsOptions;
     /**
      * Lifecycle hooks
      */

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

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

package/dist/server/index.js

@@ -28,6 +28,8 @@ import { createWinstonLogger, createConsoleLogger } from "../logger/index.js";
 import { createDatabaseConnection, buildUriFromConfig } from "../database/index.js";
 import { initI18n } from "../i18n/index.js";
 import { createContext } from "../context.js";
+import { resolveAllModuleDeps } from "../module/index.js";
+import { createDevToolsRouter } from "../devtools/index.js";
 /**
  * Install respond helper on Express Response prototype
  */
@@ -180,11 +182,31 @@ export async function createWecon(options) {
     // Dynamic import Express
     const express = (await import("express")).default;
     const app = express();
-    // Create context (will update with app/io later)
+    // Validate and inject module configs
+    const moduleSchemas = new Map();
+    if (!config.moduleConfigs) {
+        config.moduleConfigs = {};
+    }
+    for (const mod of modules) {
+        if (mod.config?.schema) {
+            moduleSchemas.set(mod.name, mod.config.schema);
+            // Merge defaults with user-provided config, then validate
+            const userConfig = config.moduleConfigs[mod.name] ?? {};
+            const merged = { ...(mod.config.defaults ?? {}), ...userConfig };
+            const result = mod.config.schema.safeParse(merged);
+            if (!result.success) {
+                throw new Error(`[Wecon] Invalid config for module "${mod.name}": ${result.error.message}`);
+            }
+            config.moduleConfigs[mod.name] = result.data;
+            logger.debug(`Module config validated: ${mod.name}`);
+        }
+    }
+    // Create context with module schemas for runtime validation
     const ctx = createContext({
         config,
         app,
         logger,
+        moduleSchemas,
     });
     // Connect database if enabled
     let db;
@@ -264,11 +286,28 @@ export async function createWecon(options) {
             });
         }
     });
+    // Mount DevTools before Wecon RBAC routes (bypasses role checks)
+    const devToolsRouter = createDevToolsRouter(ctx, modules, options.devtools, wecon);
+    if (devToolsRouter) {
+        const prefix = options.devtools?.prefix ?? "/dev/devtools";
+        app.use(prefix, devToolsRouter);
+    }
     // Mount Wecon router if provided
     if (wecon) {
         app.use(wecon.handler());
         logger.debug("Wecon routes mounted");
     }
+    // Check and install module dependencies
+    if (options.moduleDeps?.paths) {
+        const rootDir = options.moduleDeps.rootDir ?? process.cwd();
+        const isDev = config.mode !== "production";
+        const autoInstall = options.moduleDeps.autoInstall ?? isDev;
+        const modulePaths = Object.entries(options.moduleDeps.paths).map(([name, p]) => ({
+            name,
+            path: p,
+        }));
+        await resolveAllModuleDeps(modulePaths, rootDir, logger, autoInstall);
+    }
     // Initialize modules
     for (const mod of modules) {
         if (mod.onInit) {