@trokky/trokky 2.0.3

package/dist/integrations/express/middleware.js

@@ -0,0 +1,130 @@
+import express from 'express';
+// Removed multer import - using edge-compatible busboy in adapter instead
+import { createLogger } from '../../core/index.js';
+/**
+ * Creates Express middleware stack for Trokky integration
+ */
+export class TrokkyExpressMiddleware {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Get all required middleware in correct order
+     */
+    getMiddleware() {
+        const middleware = [];
+        // Security headers
+        if (this.config.security?.customHeaders) {
+            middleware.push(this.createSecurityHeaders());
+        }
+        // Body parsing middleware
+        middleware.push(...this.createBodyParsers());
+        // Note: File upload is now handled directly in the adapter using busboy
+        // No middleware needed for edge-compatible upload handling
+        // Error handling should be added by the user as the last middleware
+        return middleware;
+    }
+    /**
+     * Create security headers middleware
+     */
+    createSecurityHeaders() {
+        const headers = this.config.security?.customHeaders || {};
+        return (req, res, next) => {
+            // Apply custom security headers
+            for (const [header, value] of Object.entries(headers)) {
+                res.setHeader(header, value);
+            }
+            // Basic security headers if not already set
+            if (!res.getHeader('X-Content-Type-Options')) {
+                res.setHeader('X-Content-Type-Options', 'nosniff');
+            }
+            if (!res.getHeader('X-Frame-Options')) {
+                res.setHeader('X-Frame-Options', 'DENY');
+            }
+            if (!res.getHeader('X-XSS-Protection')) {
+                res.setHeader('X-XSS-Protection', '1; mode=block');
+            }
+            next();
+        };
+    }
+    /**
+     * Create body parsing middleware with conditional parsing optimization
+     */
+    createBodyParsers() {
+        const middleware = [];
+        // Get limits from config, with reasonable defaults
+        const jsonConfig = this.config.bodyParser?.json || {};
+        const urlencodedConfig = this.config.bodyParser?.urlencoded || {};
+        const jsonLimit = jsonConfig.limit || '10mb';
+        const urlencodedLimit = urlencodedConfig.limit || '10mb';
+        // Conditional body parsing middleware - skip multipart requests for efficiency
+        const conditionalBodyParser = (req, res, next) => {
+            // Skip body parsing for multipart/form-data requests - they're handled by busboy in the adapter
+            const contentType = req.get('content-type') || '';
+            if (contentType.includes('multipart/form-data')) {
+                return next();
+            }
+            // Apply JSON parsing first
+            express.json({
+                limit: jsonLimit,
+                strict: jsonConfig.strict !== false,
+                ...jsonConfig
+            })(req, res, (err) => {
+                if (err)
+                    return next(err);
+                // Then apply URL-encoded parsing
+                express.urlencoded({
+                    limit: urlencodedLimit,
+                    extended: urlencodedConfig.extended !== false,
+                    ...urlencodedConfig
+                })(req, res, next);
+            });
+        };
+        middleware.push(conditionalBodyParser);
+        return middleware;
+    }
+    // File upload is now handled directly in the adapter using busboy for edge compatibility
+    /**
+     * Create error handling middleware
+     */
+    static createErrorHandler() {
+        const logger = createLogger('express', 'ErrorHandler');
+        return (err, req, res, next) => {
+            // Log error for debugging (skip in test environment)
+            if (process.env.NODE_ENV !== 'test') {
+                logger.error('Express middleware error', err);
+            }
+            // Don't handle if response already sent
+            if (res.headersSent) {
+                return next(err);
+            }
+            // Determine error status and message
+            let status = 500;
+            let message = err.message || 'Internal Server Error';
+            if (err.message.includes('not allowed') || err.message.includes('Invalid')) {
+                status = 400;
+                message = err.message;
+            }
+            else if (err.message.includes('too large') || err.message.includes('Too many')) {
+                status = 413;
+                message = err.message;
+            }
+            else if (err.message.includes('not found')) {
+                status = 404;
+                message = err.message;
+            }
+            // Send error response
+            res.status(status).json({
+                success: false,
+                error: {
+                    code: status === 400 ? 'BAD_REQUEST' :
+                        status === 404 ? 'NOT_FOUND' :
+                            status === 413 ? 'PAYLOAD_TOO_LARGE' : 'INTERNAL_ERROR',
+                    message
+                }
+            });
+        };
+    }
+}
+//# sourceMappingURL=middleware.js.map

package/dist/integrations/express/middleware.js.map

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

package/dist/integrations/express/server.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Trokky Express Server
+ *
+ * High-level server creation and lifecycle management.
+ * This is the recommended entry point for Trokky applications.
+ *
+ * @example
+ * ```typescript
+ * import config from './trokky.config.js'
+ * import { startServer } from '@trokky/express'
+ *
+ * await startServer(config)
+ * ```
+ */
+import { Express } from 'express';
+import { MailService, MailNotificationService } from '../../mail/index.js';
+import type { TrokkyConfig, TrokkyConfigWithDefaults } from './config.js';
+import type { ExpressIntegration } from './types.js';
+import type { Server } from 'http';
+/**
+ * Result of starting the Trokky server
+ */
+export interface TrokkyServerInstance {
+    /** The Express application instance */
+    app: Express;
+    /** The HTTP server instance */
+    server: Server;
+    /** The Trokky Express integration */
+    integration: ExpressIntegration;
+    /** Mail service instance (if configured) */
+    mailService?: MailService;
+    /** Mail notification service instance (if configured) */
+    mailNotificationService?: MailNotificationService;
+    /** Gracefully stop the server */
+    stop: () => Promise<void>;
+    /** Get server info */
+    getInfo: () => ServerInfo;
+}
+export interface ServerInfo {
+    port: number;
+    env: string;
+    apiPath: string;
+    studioPath: string;
+    studioEnabled: boolean;
+    mailEnabled: boolean;
+    customRoutesCount: number;
+    hooksCount: number;
+}
+/**
+ * Start a Trokky server with the provided configuration.
+ *
+ * This is the recommended way to create a Trokky application.
+ * It handles all initialization, including:
+ * - Express app creation
+ * - Trokky core initialization
+ * - Mail service setup (if configured)
+ * - Event hooks registration
+ * - Custom routes mounting
+ * - Server lifecycle management
+ *
+ * @param config - Trokky configuration object
+ * @returns Server instance with control methods
+ *
+ * @example
+ * ```typescript
+ * const server = await startServer({
+ *   schemas: mySchemas,
+ *   storage: { data: {...}, media: {...} },
+ *   security: { adminUser: {...} },
+ *   mail: { adapter: resendAdapter },
+ *   routes: [
+ *     { path: '/api/contact', method: 'POST', handler: contactHandler }
+ *   ]
+ * })
+ *
+ * // Later, gracefully stop
+ * await server.stop()
+ * ```
+ */
+export declare function startServer(config: TrokkyConfig): Promise<TrokkyServerInstance>;
+/**
+ * Exported for tests only — the package index deliberately exposes just `startServer` and
+ * `createServer`, and the ordering this function enforces (drain, then release handles) is
+ * worth asserting directly.
+ */
+export declare function createShutdownHandler(server: Server, config: TrokkyConfigWithDefaults, integration: ExpressIntegration, mailService?: MailService): () => Promise<void>;
+/**
+ * Create a Trokky server without starting it.
+ * Useful for testing or custom server management.
+ *
+ * @param config - Trokky configuration object
+ * @returns Object with app, integration, and start function
+ */
+export declare function createServer(config: TrokkyConfig): Promise<{
+    app: Express;
+    integration: ExpressIntegration;
+    start: (port?: number) => Promise<TrokkyServerInstance>;
+}>;
+//# sourceMappingURL=server.d.ts.map

package/dist/integrations/express/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/integrations/express/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAgB,EAAE,OAAO,EAAU,MAAM,SAAS,CAAA;AAElD,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAA2B,MAAM,qBAAqB,CAAA;AAGnG,OAAO,KAAK,EACV,YAAY,EACZ,wBAAwB,EAOzB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAMlC;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,uCAAuC;IACvC,GAAG,EAAE,OAAO,CAAA;IACZ,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,qCAAqC;IACrC,WAAW,EAAE,kBAAkB,CAAA;IAC/B,4CAA4C;IAC5C,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,yDAAyD;IACzD,uBAAuB,CAAC,EAAE,uBAAuB,CAAA;IACjD,iCAAiC;IACjC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB,sBAAsB;IACtB,OAAO,EAAE,MAAM,UAAU,CAAA;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,OAAO,CAAA;IACtB,WAAW,EAAE,OAAO,CAAA;IACpB,iBAAiB,EAAE,MAAM,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;CACnB;AAQD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,oBAAoB,CAAC,CAgH/B;AAoVD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,wBAAwB,EAChC,WAAW,EAAE,kBAAkB,EAC/B,WAAW,CAAC,EAAE,WAAW,GACxB,MAAM,OAAO,CAAC,IAAI,CAAC,CAiDrB;AAwFD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC;IAChE,GAAG,EAAE,OAAO,CAAA;IACZ,WAAW,EAAE,kBAAkB,CAAA;IAC/B,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAA;CACxD,CAAC,CA4DD"}