adorn-api 1.0.0

package/dist/tests/example-app/controllers/controllers/advanced.controller.js

@@ -0,0 +1,131 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+// src/controllers/advanced.controller.ts
+import { Controller, Get, Post, FromBody, FromPath } from "../lib/decorators.js";
+import { PaginationQuery } from "../lib/common.js";
+// --- 1. Advanced Request DTOs ---
+// INHERITANCE: UserListRequest automatically gets 'page' and 'limit' from PaginationQuery
+// AND the generator will find them because we scan the Type properties.
+let UserListRequest = (() => {
+    let _classSuper = PaginationQuery;
+    let _tenantId_decorators;
+    let _tenantId_initializers = [];
+    let _tenantId_extraInitializers = [];
+    return class UserListRequest extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _tenantId_decorators = [FromPath()];
+            __esDecorate(null, null, _tenantId_decorators, { kind: "field", name: "tenantId", static: false, private: false, access: { has: obj => "tenantId" in obj, get: obj => obj.tenantId, set: (obj, value) => { obj.tenantId = value; } }, metadata: _metadata }, _tenantId_initializers, _tenantId_extraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        // Implicitly @FromQuery because it's a GET request and extends a class
+        search;
+        tenantId = __runInitializers(this, _tenantId_initializers, void 0);
+        constructor() {
+            super(...arguments);
+            __runInitializers(this, _tenantId_extraInitializers);
+        }
+    };
+})();
+export { UserListRequest };
+// COMPOSITION: Using the Type Helper for safety, but class for Decorators
+// We implement the Type Helper to ensure our Class matches the Entity rule
+let CreateUserDto = (() => {
+    let _name_decorators;
+    let _name_initializers = [];
+    let _name_extraInitializers = [];
+    let _email_decorators;
+    let _email_initializers = [];
+    let _email_extraInitializers = [];
+    return class CreateUserDto {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _name_decorators = [FromBody()];
+            _email_decorators = [FromBody()];
+            __esDecorate(null, null, _name_decorators, { kind: "field", name: "name", static: false, private: false, access: { has: obj => "name" in obj, get: obj => obj.name, set: (obj, value) => { obj.name = value; } }, metadata: _metadata }, _name_initializers, _name_extraInitializers);
+            __esDecorate(null, null, _email_decorators, { kind: "field", name: "email", static: false, private: false, access: { has: obj => "email" in obj, get: obj => obj.email, set: (obj, value) => { obj.email = value; } }, metadata: _metadata }, _email_initializers, _email_extraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        name = __runInitializers(this, _name_initializers, void 0);
+        email = (__runInitializers(this, _name_extraInitializers), __runInitializers(this, _email_initializers, void 0));
+        constructor() {
+            __runInitializers(this, _email_extraInitializers);
+        }
+    };
+})();
+export { CreateUserDto };
+// --- 2. The Controller ---
+let AdvancedController = (() => {
+    let _classDecorators = [Controller("advanced")];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _instanceExtraInitializers = [];
+    let _listUsers_decorators;
+    let _create_decorators;
+    var AdvancedController = class {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _listUsers_decorators = [Get("/{tenantId}/users")];
+            _create_decorators = [Post("/")];
+            __esDecorate(this, null, _listUsers_decorators, { kind: "method", name: "listUsers", static: false, private: false, access: { has: obj => "listUsers" in obj, get: obj => obj.listUsers }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _create_decorators, { kind: "method", name: "create", static: false, private: false, access: { has: obj => "create" in obj, get: obj => obj.create }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            AdvancedController = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        async listUsers(req) {
+            return [
+                { id: "1", name: "Alice", email: "a@a.com", isActive: true, createdAt: "now" }
+            ];
+        }
+        async create(req) {
+            return {
+                id: "123",
+                name: req.name,
+                email: req.email,
+                isActive: true,
+                createdAt: "now"
+            };
+        }
+        constructor() {
+            __runInitializers(this, _instanceExtraInitializers);
+        }
+    };
+    return AdvancedController = _classThis;
+})();
+export { AdvancedController };

package/dist/tests/example-app/controllers/controllers/user.controller.js

@@ -0,0 +1,121 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+// src/controllers/user.controller.ts
+import { Controller, Get, Post, FromQuery, FromPath, FromBody } from "../lib/decorators.js";
+// --- DTO Definitions (The substitute for Parameter Decorators) ---
+let GetUserRequest = (() => {
+    let _userId_decorators;
+    let _userId_initializers = [];
+    let _userId_extraInitializers = [];
+    let _details_decorators;
+    let _details_initializers = [];
+    let _details_extraInitializers = [];
+    return class GetUserRequest {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _userId_decorators = [FromPath()];
+            _details_decorators = [FromQuery()];
+            __esDecorate(null, null, _userId_decorators, { kind: "field", name: "userId", static: false, private: false, access: { has: obj => "userId" in obj, get: obj => obj.userId, set: (obj, value) => { obj.userId = value; } }, metadata: _metadata }, _userId_initializers, _userId_extraInitializers);
+            __esDecorate(null, null, _details_decorators, { kind: "field", name: "details", static: false, private: false, access: { has: obj => "details" in obj, get: obj => obj.details, set: (obj, value) => { obj.details = value; } }, metadata: _metadata }, _details_initializers, _details_extraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        userId = __runInitializers(this, _userId_initializers, void 0);
+        details = (__runInitializers(this, _userId_extraInitializers), __runInitializers(this, _details_initializers, void 0));
+        constructor() {
+            __runInitializers(this, _details_extraInitializers);
+        }
+    };
+})();
+export { GetUserRequest };
+let CreateUserRequest = (() => {
+    let _name_decorators;
+    let _name_initializers = [];
+    let _name_extraInitializers = [];
+    let _email_decorators;
+    let _email_initializers = [];
+    let _email_extraInitializers = [];
+    return class CreateUserRequest {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _name_decorators = [FromBody()];
+            _email_decorators = [FromBody()];
+            __esDecorate(null, null, _name_decorators, { kind: "field", name: "name", static: false, private: false, access: { has: obj => "name" in obj, get: obj => obj.name, set: (obj, value) => { obj.name = value; } }, metadata: _metadata }, _name_initializers, _name_extraInitializers);
+            __esDecorate(null, null, _email_decorators, { kind: "field", name: "email", static: false, private: false, access: { has: obj => "email" in obj, get: obj => obj.email, set: (obj, value) => { obj.email = value; } }, metadata: _metadata }, _email_initializers, _email_extraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        name = __runInitializers(this, _name_initializers, void 0);
+        email = (__runInitializers(this, _name_extraInitializers), __runInitializers(this, _email_initializers, void 0));
+        constructor() {
+            __runInitializers(this, _email_extraInitializers);
+        }
+    };
+})();
+export { CreateUserRequest };
+// --- The Controller ---
+let UserController = (() => {
+    let _classDecorators = [Controller("users")];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _instanceExtraInitializers = [];
+    let _getUser_decorators;
+    let _createUser_decorators;
+    var UserController = class {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _getUser_decorators = [Get("/{userId}")];
+            _createUser_decorators = [Post("/")];
+            __esDecorate(this, null, _getUser_decorators, { kind: "method", name: "getUser", static: false, private: false, access: { has: obj => "getUser" in obj, get: obj => obj.getUser }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _createUser_decorators, { kind: "method", name: "createUser", static: false, private: false, access: { has: obj => "createUser" in obj, get: obj => obj.createUser }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            UserController = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        // Strong typing: 'req' is checked at edit time.
+        async getUser(req) {
+            return `Getting user ${req.userId} with details: ${req.details}`;
+        }
+        async createUser(req) {
+            console.log(`Creating user ${req.name}`);
+        }
+        constructor() {
+            __runInitializers(this, _instanceExtraInitializers);
+        }
+    };
+    return UserController = _classThis;
+})();
+export { UserController };

package/dist/tests/example-app/controllers/user.controller.js

@@ -0,0 +1,121 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+// src/controllers/user.controller.ts
+import { Controller, Get, Post, FromQuery, FromPath, FromBody } from "../../../src/index.js";
+// --- DTO Definitions (The substitute for Parameter Decorators) ---
+let GetUserRequest = (() => {
+    let _userId_decorators;
+    let _userId_initializers = [];
+    let _userId_extraInitializers = [];
+    let _details_decorators;
+    let _details_initializers = [];
+    let _details_extraInitializers = [];
+    return class GetUserRequest {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _userId_decorators = [FromPath()];
+            _details_decorators = [FromQuery()];
+            __esDecorate(null, null, _userId_decorators, { kind: "field", name: "userId", static: false, private: false, access: { has: obj => "userId" in obj, get: obj => obj.userId, set: (obj, value) => { obj.userId = value; } }, metadata: _metadata }, _userId_initializers, _userId_extraInitializers);
+            __esDecorate(null, null, _details_decorators, { kind: "field", name: "details", static: false, private: false, access: { has: obj => "details" in obj, get: obj => obj.details, set: (obj, value) => { obj.details = value; } }, metadata: _metadata }, _details_initializers, _details_extraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        userId = __runInitializers(this, _userId_initializers, void 0);
+        details = (__runInitializers(this, _userId_extraInitializers), __runInitializers(this, _details_initializers, void 0));
+        constructor() {
+            __runInitializers(this, _details_extraInitializers);
+        }
+    };
+})();
+export { GetUserRequest };
+let CreateUserRequest = (() => {
+    let _name_decorators;
+    let _name_initializers = [];
+    let _name_extraInitializers = [];
+    let _email_decorators;
+    let _email_initializers = [];
+    let _email_extraInitializers = [];
+    return class CreateUserRequest {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _name_decorators = [FromBody()];
+            _email_decorators = [FromBody()];
+            __esDecorate(null, null, _name_decorators, { kind: "field", name: "name", static: false, private: false, access: { has: obj => "name" in obj, get: obj => obj.name, set: (obj, value) => { obj.name = value; } }, metadata: _metadata }, _name_initializers, _name_extraInitializers);
+            __esDecorate(null, null, _email_decorators, { kind: "field", name: "email", static: false, private: false, access: { has: obj => "email" in obj, get: obj => obj.email, set: (obj, value) => { obj.email = value; } }, metadata: _metadata }, _email_initializers, _email_extraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        name = __runInitializers(this, _name_initializers, void 0);
+        email = (__runInitializers(this, _name_extraInitializers), __runInitializers(this, _email_initializers, void 0));
+        constructor() {
+            __runInitializers(this, _email_extraInitializers);
+        }
+    };
+})();
+export { CreateUserRequest };
+// --- The Controller ---
+let UserController = (() => {
+    let _classDecorators = [Controller("users")];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _instanceExtraInitializers = [];
+    let _getUser_decorators;
+    let _createUser_decorators;
+    var UserController = class {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _getUser_decorators = [Get("/{userId}")];
+            _createUser_decorators = [Post("/")];
+            __esDecorate(this, null, _getUser_decorators, { kind: "method", name: "getUser", static: false, private: false, access: { has: obj => "getUser" in obj, get: obj => obj.getUser }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _createUser_decorators, { kind: "method", name: "createUser", static: false, private: false, access: { has: obj => "createUser" in obj, get: obj => obj.createUser }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            UserController = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        // Strong typing: 'req' is checked at edit time.
+        async getUser(req) {
+            return `Getting user ${req.userId} with details: ${req.details}`;
+        }
+        async createUser(req) {
+            console.log(`Creating user ${req.name}`);
+        }
+        constructor() {
+            __runInitializers(this, _instanceExtraInitializers);
+        }
+    };
+    return UserController = _classThis;
+})();
+export { UserController };

package/dist/tests/example-app/entities/entities/user.entity.js

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

package/dist/tests/example-app/entities/user.entity.js

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

package/dist/tests/example-app/middleware/auth.middleware.js

@@ -0,0 +1,13 @@
+export function authenticationMiddleware(req, res, next) {
+    const token = req.headers.authorization;
+    if (!token) {
+        res.status(401).json({ message: "No token provided" });
+        return;
+    }
+    if (token === "Bearer secret") {
+        next();
+    }
+    else {
+        res.status(403).json({ message: "Invalid token" });
+    }
+}

package/dist/tests/example-app/middleware/middleware/auth.middleware.js

@@ -0,0 +1,13 @@
+export function authenticationMiddleware(req, res, next) {
+    const token = req.headers.authorization;
+    if (!token) {
+        res.status(401).json({ message: "No token provided" });
+        return;
+    }
+    if (token === "Bearer secret") {
+        next();
+    }
+    else {
+        res.status(403).json({ message: "Invalid token" });
+    }
+}

package/dist/tests/example-app/routes.js

@@ -0,0 +1,80 @@
+import { AdvancedController } from './controllers/advanced.controller.js';
+import { UserController } from './controllers/user.controller.js';
+export function RegisterRoutes(app) {
+    app.get('/advanced/:tenantId/users', async (req, res) => {
+        const controller = new AdvancedController();
+        try {
+            const input = {};
+            // Map Query
+            Object.assign(input, req.query);
+            // Map Params
+            Object.assign(input, req.params);
+            // Map Body
+            Object.assign(input, req.body);
+            // In a real app, you would run 'zod' or 'class-validator' here on 'input'
+            const response = await controller.listUsers(input);
+            res.status(200).json(response);
+        }
+        catch (err) {
+            console.error(err);
+            res.status(500).send(err.message);
+        }
+    });
+    app.post('/advanced/', async (req, res) => {
+        const controller = new AdvancedController();
+        try {
+            const input = {};
+            // Map Query
+            Object.assign(input, req.query);
+            // Map Params
+            Object.assign(input, req.params);
+            // Map Body
+            Object.assign(input, req.body);
+            // In a real app, you would run 'zod' or 'class-validator' here on 'input'
+            const response = await controller.create(input);
+            res.status(200).json(response);
+        }
+        catch (err) {
+            console.error(err);
+            res.status(500).send(err.message);
+        }
+    });
+    app.get('/users/:userId', async (req, res) => {
+        const controller = new UserController();
+        try {
+            const input = {};
+            // Map Query
+            Object.assign(input, req.query);
+            // Map Params
+            Object.assign(input, req.params);
+            // Map Body
+            Object.assign(input, req.body);
+            // In a real app, you would run 'zod' or 'class-validator' here on 'input'
+            const response = await controller.getUser(input);
+            res.status(200).json(response);
+        }
+        catch (err) {
+            console.error(err);
+            res.status(500).send(err.message);
+        }
+    });
+    app.post('/users/', async (req, res) => {
+        const controller = new UserController();
+        try {
+            const input = {};
+            // Map Query
+            Object.assign(input, req.query);
+            // Map Params
+            Object.assign(input, req.params);
+            // Map Body
+            Object.assign(input, req.body);
+            // In a real app, you would run 'zod' or 'class-validator' here on 'input'
+            const response = await controller.createUser(input);
+            res.status(200).json(response);
+        }
+        catch (err) {
+            console.error(err);
+            res.status(500).send(err.message);
+        }
+    });
+}

package/dist/tests/example-app/server.js

@@ -0,0 +1,23 @@
+// tests/example-app/server.ts
+// Example Express server using adorn-api
+import express from "express";
+import bodyParser from "body-parser";
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+import swaggerUi from "swagger-ui-express";
+// Import generated routes
+import { RegisterRoutes } from "./routes.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const app = express();
+app.use(bodyParser.json());
+// Register the Generated Routes
+RegisterRoutes(app);
+// Serve Swagger UI
+const swaggerDoc = JSON.parse(readFileSync(join(__dirname, "../../swagger.json"), "utf-8"));
+app.use("/docs", swaggerUi.serve, swaggerUi.setup(swaggerDoc));
+app.listen(3000, () => {
+    console.log("🚀 Example server running on http://localhost:3000");
+    console.log("📄 Swagger running on http://localhost:3000/docs");
+});

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "adorn-api",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc",
+    "gen:spec": "ts-node --esm src/cli/generate-swagger.ts",
+    "gen:routes": "ts-node --esm src/cli/generate-routes.ts",
+    "gen": "npm run gen:spec && npm run gen:routes",
+    "example": "node scripts/run-example.js",
+    "test": "vitest run"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "module",
+  "dependencies": {
+    "body-parser": "^2.2.0",
+    "express": "^4.21.1",
+    "reflect-metadata": "^0.2.2",
+    "swagger-ui-express": "^5.0.1",
+    "ts-morph": "^27.0.2",
+    "typescript": "^5.9.3",
+    "zod": "^4.2.1"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/node": "^25.0.3",
+    "@types/swagger-ui-express": "^4.1.8",
+    "ts-node": "^10.9.2",
+    "vitest": "^2.1.8"
+  }
+}

package/scripts/run-example.js

@@ -0,0 +1,32 @@
+import { spawn } from "node:child_process";
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+const projectRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const loader = pathToFileURL(path.join(projectRoot, "node_modules", "ts-node", "esm.mjs")).toString();
+const server = path.join(projectRoot, "tests", "example-app", "server.ts");
+
+const child = spawn(
+  process.execPath,
+  ["--loader", loader, server],
+  {
+    stdio: "inherit",
+    env: {
+      ...process.env,
+      TS_NODE_PROJECT: path.join(projectRoot, "tsconfig.json"),
+      TS_NODE_PREFER_TS_EXTS: "true",
+    },
+  }
+);
+
+["SIGINT", "SIGTERM"].forEach(signal => {
+  process.on(signal, () => {
+    if (!child.killed) {
+      child.kill(signal);
+    }
+  });
+});
+
+child.on("exit", code => {
+  process.exitCode = code ?? 0;
+});