adorn-api 1.1.11 → 1.1.13

package/dist/core/streaming.js

@@ -20,9 +20,11 @@ class SseEmitter {
         if (keepAlive) {
             this.startKeepAlive(keepAliveInterval);
         }
-        res.on("close", () => {
-            this.close();
-        });
+        if (res.on) {
+            res.on("close", () => {
+                this.close();
+            });
+        }
     }
     /**
      * Send an SSE event to the client.
@@ -73,11 +75,15 @@ class SseEmitter {
         return this.closed;
     }
     setupSseHeaders() {
-        this.res.setHeader("Content-Type", "text/event-stream");
-        this.res.setHeader("Cache-Control", "no-cache, no-transform");
-        this.res.setHeader("Connection", "keep-alive");
-        this.res.setHeader("X-Accel-Buffering", "no");
-        this.res.flushHeaders();
+        if (this.res.setHeader) {
+            this.res.setHeader("Content-Type", "text/event-stream");
+            this.res.setHeader("Cache-Control", "no-cache, no-transform");
+            this.res.setHeader("Connection", "keep-alive");
+            this.res.setHeader("X-Accel-Buffering", "no");
+        }
+        if (this.res.flushHeaders) {
+            this.res.flushHeaders();
+        }
     }
     startKeepAlive(interval) {
         this.keepAliveTimer = setInterval(() => {
@@ -135,9 +141,11 @@ class StreamWriter {
     constructor(res, options = {}) {
         this.res = res;
         this.setupHeaders(options);
-        res.on("close", () => {
-            this.closed = true;
-        });
+        if (res.on) {
+            res.on("close", () => {
+                this.closed = true;
+            });
+        }
     }
     /**
      * Write data to the stream.
@@ -186,16 +194,20 @@ class StreamWriter {
     }
     setupHeaders(options) {
         const contentType = options.contentType ?? "application/octet-stream";
-        this.res.setHeader("Content-Type", contentType);
-        this.res.setHeader("Transfer-Encoding", "chunked");
-        this.res.setHeader("Cache-Control", "no-cache, no-transform");
-        this.res.setHeader("X-Accel-Buffering", "no");
-        if (options.headers) {
-            for (const [key, value] of Object.entries(options.headers)) {
-                this.res.setHeader(key, value);
+        if (this.res.setHeader) {
+            this.res.setHeader("Content-Type", contentType);
+            this.res.setHeader("Transfer-Encoding", "chunked");
+            this.res.setHeader("Cache-Control", "no-cache, no-transform");
+            this.res.setHeader("X-Accel-Buffering", "no");
+            if (options.headers) {
+                for (const [key, value] of Object.entries(options.headers)) {
+                    this.res.setHeader(key, value);
+                }
             }
         }
-        this.res.flushHeaders();
+        if (this.res.flushHeaders) {
+            this.res.flushHeaders();
+        }
     }
 }
 exports.StreamWriter = StreamWriter;

package/dist/core/types.d.ts

@@ -10,3 +10,105 @@ export type DtoConstructor<T = any> = new (...args: any[]) => T;
  * HTTP method types.
  */
 export type HttpMethod = "get" | "post" | "put" | "patch" | "delete";
+/**
+ * Uploaded file information from multipart form data.
+ */
+export interface UploadedFileInfo {
+    /** Original filename as provided by the client */
+    originalName: string;
+    /** MIME type of the file */
+    mimeType: string;
+    /** Size of the file in bytes */
+    size: number;
+    /** File buffer (when using memory storage) */
+    buffer?: Buffer;
+    /** Path to the file on disk (when using disk storage) */
+    path?: string;
+    /** Field name from the form */
+    fieldName: string;
+}
+/**
+ * Generic request interface.
+ */
+export interface HttpRequest {
+    method: string;
+    url: string;
+    originalUrl?: string;
+    path?: string;
+    params: Record<string, any>;
+    query: Record<string, any>;
+    body: any;
+    headers: Record<string, any>;
+    ip?: string;
+    protocol?: string;
+    secure?: boolean;
+}
+/**
+ * Generic response interface.
+ */
+export interface HttpResponseHeaders {
+    [key: string]: string | string[] | undefined;
+}
+/**
+ * Generic response interface.
+ */
+export interface HttpResponseWriter {
+    statusCode: number;
+    headersSent: boolean;
+    setHeader(name: string, value: string | string[]): void;
+    getHeader(name: string): string | string[] | undefined;
+    removeHeader(name: string): void;
+    status(code: number): this;
+    send(body?: any): this;
+    end(): void;
+}
+/**
+ * Server-Sent Event emitter interface.
+ */
+export interface SseEmitterInterface {
+    send(data: any): void;
+    emit(event: string, data: any): void;
+    comment(text: string): void;
+    close(): void;
+    isClosed(): boolean;
+}
+/**
+ * Stream writer interface.
+ */
+export interface StreamWriterInterface {
+    write(data: string | Buffer): boolean;
+    writeLine(data: string): boolean;
+    writeJson(data: any): boolean;
+    writeJsonLine(data: any): boolean;
+    close(): void;
+    isClosed(): boolean;
+}
+/**
+ * Request context provided to route handlers.
+ */
+export interface RequestContext<TBody = any, TQuery extends object | undefined = Record<string, any>, TParams extends object | undefined = Record<string, any>, THeaders extends object | undefined = Record<string, any>, TFiles extends Record<string, UploadedFileInfo | UploadedFileInfo[]> | undefined = any> {
+    /** Raw request object */
+    req: any;
+    /** Raw response object */
+    res: any;
+    /** Parsed request body */
+    body: TBody;
+    /** Parsed query parameters */
+    query: TQuery;
+    /** Parsed path parameters */
+    params: TParams;
+    /** Request headers */
+    headers: THeaders;
+    /** Uploaded files (when using multipart handling) */
+    files: TFiles;
+    /**
+     * Server-Sent Events emitter for streaming events to client.
+     * Only available on routes marked with @Sse decorator.
+     */
+    sse?: SseEmitterInterface;
+    /**
+     * Stream writer for streaming responses.
+     * Available on routes marked with @Streaming or @Sse decorator.
+     */
+    stream?: StreamWriterInterface;
+}

package/dist/index.d.ts

@@ -12,6 +12,11 @@ export * from "./core/serialization";
 export * from "./core/auth";
 export * from "./core/lifecycle";
 export * from "./core/streaming";
-export * from "./adapter/express/index";
+export { createExpressApp, attachControllers as attachExpressControllers, attachOpenApi as attachExpressOpenApi, shutdownApp as shutdownExpressApp } from "./adapter/express/index";
+export type { ExpressAdapterOptions, RequestContext as ExpressRequestContext } from "./adapter/express/index";
+export { createFastifyApp, attachControllers as attachFastifyControllers, attachOpenApi as attachFastifyOpenApi, shutdownApp as shutdownFastifyApp } from "./adapter/fastify/index";
+export type { FastifyAdapterOptions, RequestContext as FastifyRequestContext } from "./adapter/fastify/index";
+export { createNativeApp, attachControllers as attachNativeControllers, attachOpenApi as attachNativeOpenApi, shutdownApp as shutdownNativeApp } from "./adapter/native/index";
+export type { NativeAdapterOptions, RequestContext as NativeRequestContext, NativeApp } from "./adapter/native/index";
 export * from "./adapter/metal-orm/index";
 export * from "./core/types";

package/dist/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.shutdownNativeApp = exports.attachNativeOpenApi = exports.attachNativeControllers = exports.createNativeApp = exports.shutdownFastifyApp = exports.attachFastifyOpenApi = exports.attachFastifyControllers = exports.createFastifyApp = exports.shutdownExpressApp = exports.attachExpressOpenApi = exports.attachExpressControllers = exports.createExpressApp = void 0;
 __exportStar(require("./core/decorators"), exports);
 __exportStar(require("./core/schema"), exports);
 __exportStar(require("./core/openapi"), exports);
@@ -28,6 +29,20 @@ __exportStar(require("./core/serialization"), exports);
 __exportStar(require("./core/auth"), exports);
 __exportStar(require("./core/lifecycle"), exports);
 __exportStar(require("./core/streaming"), exports);
-__exportStar(require("./adapter/express/index"), exports);
+var index_1 = require("./adapter/express/index");
+Object.defineProperty(exports, "createExpressApp", { enumerable: true, get: function () { return index_1.createExpressApp; } });
+Object.defineProperty(exports, "attachExpressControllers", { enumerable: true, get: function () { return index_1.attachControllers; } });
+Object.defineProperty(exports, "attachExpressOpenApi", { enumerable: true, get: function () { return index_1.attachOpenApi; } });
+Object.defineProperty(exports, "shutdownExpressApp", { enumerable: true, get: function () { return index_1.shutdownApp; } });
+var index_2 = require("./adapter/fastify/index");
+Object.defineProperty(exports, "createFastifyApp", { enumerable: true, get: function () { return index_2.createFastifyApp; } });
+Object.defineProperty(exports, "attachFastifyControllers", { enumerable: true, get: function () { return index_2.attachControllers; } });
+Object.defineProperty(exports, "attachFastifyOpenApi", { enumerable: true, get: function () { return index_2.attachOpenApi; } });
+Object.defineProperty(exports, "shutdownFastifyApp", { enumerable: true, get: function () { return index_2.shutdownApp; } });
+var index_3 = require("./adapter/native/index");
+Object.defineProperty(exports, "createNativeApp", { enumerable: true, get: function () { return index_3.createNativeApp; } });
+Object.defineProperty(exports, "attachNativeControllers", { enumerable: true, get: function () { return index_3.attachControllers; } });
+Object.defineProperty(exports, "attachNativeOpenApi", { enumerable: true, get: function () { return index_3.attachOpenApi; } });
+Object.defineProperty(exports, "shutdownNativeApp", { enumerable: true, get: function () { return index_3.shutdownApp; } });
 __exportStar(require("./adapter/metal-orm/index"), exports);
 __exportStar(require("./core/types"), exports);

package/examples/fastify/app.ts

@@ -0,0 +1,16 @@
+import { createFastifyApp } from "../../src";
+import { UserController } from "../basic/user.controller";
+
+export async function createApp() {
+  const app = await createFastifyApp({
+    controllers: [UserController],
+    openApi: {
+      info: {
+        title: "Adorn API (Fastify)",
+        version: "1.0.0"
+      },
+      docs: true
+    }
+  });
+  return app;
+}

package/examples/fastify/index.ts

@@ -0,0 +1,21 @@
+import { createApp } from "./app";
+
+async function start() {
+  const app = await createApp();
+  const PORT = 3000;
+
+  app.listen({ port: PORT }, (err, address) => {
+    if (err) {
+      console.error(err);
+      process.exit(1);
+    }
+    console.log(`Server running at ${address}`);
+    console.log(`OpenAPI documentation: ${address}/openapi.json`);
+    console.log(`Swagger UI: ${address}/docs`);
+  });
+}
+
+start().catch(error => {
+  console.error("Failed to start server:", error);
+  process.exit(1);
+});

package/package.json

@@ -1,37 +1,43 @@
 {
   "name": "adorn-api",
-  "version": "1.1.11",
+  "version": "1.1.13",
   "description": "Decorator-first web framework with OpenAPI 3.1 schema generation.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "tsc -p tsconfig.json",
+    "pretest": "npm run build",
     "dev": "tsx examples/basic/index.ts",
     "test": "vitest run",
     "test:watch": "vitest",
+    "typecheck:tests": "tsc -p tsconfig.typecheck.json --noEmit",
     "example": "node scripts/run-example.js",
     "check": "tsc -p tsconfig.json --noEmit && npm test",
     "lint": "eslint . --ext .ts,.tsx,.js"
   },
   "dependencies": {
-    "express": "^4.19.2",
-    "metal-orm": "^1.1.2"
+    "@fastify/cors": "^11.2.0",
+    "@fastify/multipart": "^9.4.0",
+    "express": "^5.2.1",
+    "fastify": "^5.8.4",
+    "metal-orm": "^1.1.10"
   },
   "devDependencies": {
-    "@electric-sql/pglite": "^0.3.15",
-    "@types/express": "^4.17.21",
-    "@types/sqlite3": "^3.1.11",
-    "@types/supertest": "^2.0.16",
-    "@typescript-eslint/eslint-plugin": "^8.53.0",
-    "@typescript-eslint/parser": "^8.53.0",
-    "@vitest/mocker": "^4.0.18",
-    "eslint": "^8.57.1",
-    "sqlite3": "^5.1.7",
-    "supertest": "^6.3.4",
-    "tedious": "^19.0.0",
-    "tsx": "^4.7.0",
-    "typescript": "^5.4.5",
-    "vite": "^7.3.1",
-    "vitest": "^4.0.18"
+    "@electric-sql/pglite": "^0.4.2",
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.5.0",
+    "@types/sqlite3": "^5.1.0",
+    "@types/supertest": "^7.2.0",
+    "@typescript-eslint/eslint-plugin": "^8.58.0",
+    "@typescript-eslint/parser": "^8.58.0",
+    "@vitest/mocker": "^4.1.2",
+    "eslint": "^10.1.0",
+    "sqlite3": "^6.0.1",
+    "supertest": "^7.2.2",
+    "tedious": "^19.2.1",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2",
+    "vite": "^8.0.3",
+    "vitest": "^4.1.2"
   }
 }