@engjts/nexus 0.1.7 → 0.1.9

package/dist/core/performance/fast-json.js

@@ -0,0 +1,473 @@
+"use strict";
+/**
+ * Fast JSON Serialization
+ *
+ * Provides optimized JSON serialization for common response patterns.
+ * Inspired by fast-json-stringify but zero dependencies.
+ *
+ * Key optimizations:
+ * 1. Schema-based serialization with pre-compiled serializers
+ * 2. Avoids JSON.stringify overhead for simple objects
+ * 3. Caches stringified templates for known schemas
+ * 4. Fast path for primitives and simple objects
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FastSerializers = void 0;
+exports.createSerializer = createSerializer;
+exports.fastStringify = fastStringify;
+exports.createRouteSerializer = createRouteSerializer;
+/**
+ * Pre-compiled serializer cache
+ */
+const serializerCache = new Map();
+/**
+ * Create a fast serializer from a JSON schema
+ * Pre-compiles the serialization logic for maximum performance
+ */
+function createSerializer(schema) {
+    const schemaKey = JSON.stringify(schema);
+    // Check cache first
+    const cached = serializerCache.get(schemaKey);
+    if (cached) {
+        return cached;
+    }
+    // Compile new serializer
+    const serializer = compileSerializer(schema);
+    serializerCache.set(schemaKey, serializer);
+    return serializer;
+}
+/**
+ * Compile a serializer function from schema
+ */
+function compileSerializer(schema) {
+    switch (schema.type) {
+        case 'string':
+            return serializeString;
+        case 'number':
+            return serializeNumber;
+        case 'boolean':
+            return serializeBoolean;
+        case 'null':
+            return () => 'null';
+        case 'array':
+            return compileSchemaArraySerializer(schema);
+        case 'object':
+            return compileObjectSerializer(schema);
+        default:
+            // Fallback to JSON.stringify
+            return JSON.stringify;
+    }
+}
+/**
+ * Fast string serialization with escape handling
+ */
+function serializeString(value) {
+    // Fast path: no special characters
+    if (!needsEscape(value)) {
+        return `"${value}"`;
+    }
+    return JSON.stringify(value);
+}
+/**
+ * Check if string needs escaping
+ * Avoids full escape processing for simple strings (90%+ of cases)
+ */
+function needsEscape(str) {
+    for (let i = 0; i < str.length; i++) {
+        const c = str.charCodeAt(i);
+        // Check for: " \ and control characters (< 32)
+        if (c === 34 || c === 92 || c < 32) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Fast number serialization
+ */
+function serializeNumber(value) {
+    // Fast path for integers
+    if (Number.isInteger(value)) {
+        return String(value);
+    }
+    // Handle special cases
+    if (!Number.isFinite(value)) {
+        return 'null';
+    }
+    return String(value);
+}
+/**
+ * Fast boolean serialization
+ */
+function serializeBoolean(value) {
+    return value ? 'true' : 'false';
+}
+/**
+ * Compile array serializer for schema-based compilation
+ * This is used when a schema is provided
+ */
+function compileSchemaArraySerializer(schema) {
+    if (!schema.items) {
+        // Unknown item type, use fast runtime detection
+        return fastStringifyArray;
+    }
+    const itemSerializer = compileSerializer(schema.items);
+    return (arr) => {
+        if (!arr || arr.length === 0) {
+            return '[]';
+        }
+        let result = '[';
+        for (let i = 0; i < arr.length; i++) {
+            if (i > 0)
+                result += ',';
+            result += itemSerializer(arr[i]);
+        }
+        result += ']';
+        return result;
+    };
+}
+/**
+ * Ultra-fast array serialization
+ * Detects array content type and uses optimized path
+ */
+function fastStringifyArray(arr) {
+    if (arr.length === 0)
+        return '[]';
+    // Sample first item to detect type
+    const firstItem = arr[0];
+    const firstType = typeof firstItem;
+    // Fast path: array of primitives
+    if (firstType === 'string' || firstType === 'number' || firstType === 'boolean') {
+        let result = '[';
+        for (let i = 0; i < arr.length; i++) {
+            if (i > 0)
+                result += ',';
+            const item = arr[i];
+            const itemType = typeof item;
+            if (itemType === 'string') {
+                result += serializeString(item);
+            }
+            else if (itemType === 'number') {
+                result += serializeNumber(item);
+            }
+            else if (itemType === 'boolean') {
+                result += serializeBoolean(item);
+            }
+            else {
+                result += 'null';
+            }
+        }
+        result += ']';
+        return result;
+    }
+    // Fast path: array of simple objects (like user list)
+    if (firstType === 'object' && firstItem !== null && !Array.isArray(firstItem)) {
+        // Detect object shape from first item
+        const keys = Object.keys(firstItem);
+        const keyCount = keys.length;
+        // Only optimize small objects (< 20 properties)
+        if (keyCount > 0 && keyCount <= 20) {
+            // Check if all items have same shape
+            let sameShape = true;
+            for (let i = 1; i < Math.min(arr.length, 5); i++) {
+                const item = arr[i];
+                if (!item || typeof item !== 'object' || Object.keys(item).length !== keyCount) {
+                    sameShape = false;
+                    break;
+                }
+            }
+            if (sameShape) {
+                // Use optimized serialization for uniform objects
+                let result = '[';
+                for (let i = 0; i < arr.length; i++) {
+                    if (i > 0)
+                        result += ',';
+                    result += fastStringifyObject(arr[i], keys);
+                }
+                result += ']';
+                return result;
+            }
+        }
+    }
+    // Fallback for complex/mixed arrays
+    return JSON.stringify(arr);
+}
+/**
+ * Fast object serialization with known keys
+ * Used for array of objects with uniform shape
+ */
+function fastStringifyObject(obj, keys) {
+    if (obj === null || obj === undefined)
+        return 'null';
+    const objKeys = keys || Object.keys(obj);
+    let result = '{';
+    let first = true;
+    for (const key of objKeys) {
+        const value = obj[key];
+        if (value === undefined)
+            continue;
+        if (!first)
+            result += ',';
+        first = false;
+        // Pre-computed key (avoid multiple escapes)
+        result += `"${key}":`;
+        const valueType = typeof value;
+        if (valueType === 'string') {
+            result += serializeString(value);
+        }
+        else if (valueType === 'number') {
+            result += serializeNumber(value);
+        }
+        else if (valueType === 'boolean') {
+            result += serializeBoolean(value);
+        }
+        else if (value === null) {
+            result += 'null';
+        }
+        else if (Array.isArray(value)) {
+            // Nested arrays - use fast path if simple
+            result += fastStringifyArray(value);
+        }
+        else if (valueType === 'object') {
+            // Nested object - recurse with fast path
+            result += fastStringifyObject(value);
+        }
+        else {
+            result += JSON.stringify(value);
+        }
+    }
+    result += '}';
+    return result;
+}
+/**
+ * Compile object serializer - the key optimization!
+ * Pre-computes property order and serializers
+ */
+function compileObjectSerializer(schema) {
+    const properties = schema.properties;
+    if (!properties || Object.keys(properties).length === 0) {
+        // No schema, use JSON.stringify
+        return JSON.stringify;
+    }
+    const keys = Object.keys(properties);
+    const propSerializers = [];
+    // Pre-compile each property's serializer
+    for (const key of keys) {
+        propSerializers.push({
+            key,
+            serializer: compileSerializer(properties[key]),
+            jsonKey: `"${key}":` // Pre-compute the key string
+        });
+    }
+    // Return optimized serializer
+    return (obj) => {
+        if (obj === null || obj === undefined) {
+            return 'null';
+        }
+        let result = '{';
+        let first = true;
+        for (const prop of propSerializers) {
+            const value = obj[prop.key];
+            if (value !== undefined) {
+                if (!first)
+                    result += ',';
+                first = false;
+                result += prop.jsonKey;
+                result += prop.serializer(value);
+            }
+        }
+        // Handle additional properties if schema allows
+        if (schema.additionalProperties !== false) {
+            for (const key in obj) {
+                if (!properties[key] && obj[key] !== undefined) {
+                    if (!first)
+                        result += ',';
+                    first = false;
+                    result += `"${key}":`;
+                    result += JSON.stringify(obj[key]);
+                }
+            }
+        }
+        result += '}';
+        return result;
+    };
+}
+/**
+ * Ultra-fast serializers for common response patterns
+ * These are hand-optimized for maximum performance
+ */
+exports.FastSerializers = {
+    /**
+     * { "message": string }
+     * Common for simple JSON responses like "Hello, World!"
+     */
+    message: (data) => {
+        const msg = data.message;
+        if (!needsEscape(msg)) {
+            return `{"message":"${msg}"}`;
+        }
+        return `{"message":${JSON.stringify(msg)}}`;
+    },
+    /**
+     * { "echo": string }
+     * Common for echo endpoints
+     */
+    echo: (data) => {
+        const echo = data.echo;
+        if (!needsEscape(echo)) {
+            return `{"echo":"${echo}"}`;
+        }
+        return `{"echo":${JSON.stringify(echo)}}`;
+    },
+    /**
+     * { "success": boolean, "data": any }
+     * Common API response wrapper
+     */
+    successResponse: (data) => {
+        if (data.data === undefined) {
+            return data.success ? '{"success":true}' : '{"success":false}';
+        }
+        return `{"success":${data.success},"data":${JSON.stringify(data.data)}}`;
+    },
+    /**
+     * { "error": string }
+     * Common error response
+     */
+    error: (data) => {
+        const err = data.error;
+        if (!needsEscape(err)) {
+            return `{"error":"${err}"}`;
+        }
+        return `{"error":${JSON.stringify(err)}}`;
+    },
+    /**
+     * { "received": any, "processed": boolean }
+     * Common for POST echo endpoints
+     * OPTIMIZED: Use fast path for nested data
+     */
+    received: (data) => {
+        const receivedType = typeof data.received;
+        let receivedStr;
+        // Fast path for primitives and simple objects
+        if (receivedType === 'string') {
+            receivedStr = serializeString(data.received);
+        }
+        else if (receivedType === 'number') {
+            receivedStr = serializeNumber(data.received);
+        }
+        else if (receivedType === 'boolean') {
+            receivedStr = serializeBoolean(data.received);
+        }
+        else if (data.received === null) {
+            receivedStr = 'null';
+        }
+        else if (Array.isArray(data.received)) {
+            receivedStr = fastStringifyArray(data.received);
+        }
+        else if (receivedType === 'object') {
+            receivedStr = fastStringifyObject(data.received);
+        }
+        else {
+            receivedStr = JSON.stringify(data.received);
+        }
+        return `{"received":${receivedStr},"processed":${data.processed}}`;
+    }
+};
+/**
+ * Smart JSON stringify that uses fast paths when possible
+ * Falls back to JSON.stringify for complex objects
+ *
+ * OPTIMIZED: Now handles arrays efficiently!
+ */
+function fastStringify(data) {
+    if (data === null)
+        return 'null';
+    if (data === undefined)
+        return 'undefined';
+    const type = typeof data;
+    // Fast paths for primitives
+    if (type === 'string')
+        return serializeString(data);
+    if (type === 'number')
+        return serializeNumber(data);
+    if (type === 'boolean')
+        return serializeBoolean(data);
+    // Check for known patterns (hot path optimization)
+    if (type === 'object') {
+        // Handle arrays with optimized path - BIG WIN for /users endpoint!
+        if (Array.isArray(data)) {
+            return fastStringifyArray(data);
+        }
+        // Single property objects - very common in APIs
+        const keys = Object.keys(data);
+        const keyCount = keys.length;
+        if (keyCount === 1) {
+            const key = keys[0];
+            const value = data[key];
+            // { "message": "..." } pattern
+            if (key === 'message' && typeof value === 'string') {
+                return exports.FastSerializers.message(data);
+            }
+            // { "echo": "..." } pattern
+            if (key === 'echo' && typeof value === 'string') {
+                return exports.FastSerializers.echo(data);
+            }
+            // { "error": "..." } pattern
+            if (key === 'error' && typeof value === 'string') {
+                return exports.FastSerializers.error(data);
+            }
+        }
+        // Two property patterns - common API responses
+        if (keyCount === 2) {
+            // { "success": boolean, "data": any }
+            if ('success' in data && 'data' in data) {
+                return exports.FastSerializers.successResponse(data);
+            }
+            // { "received": any, "processed": boolean } - POST echo pattern!
+            if ('received' in data && 'processed' in data) {
+                return exports.FastSerializers.received(data);
+            }
+        }
+        // Multi-property objects - use fast path
+        if (keyCount > 2 && keyCount <= 50) {
+            return fastStringifyObject(data);
+        }
+    }
+    // Fallback to native JSON.stringify for very complex objects
+    return JSON.stringify(data);
+}
+/**
+ * Create a route-specific serializer based on schema
+ * Use this in route registration to pre-compile serializers
+ *
+ * @example
+ * ```typescript
+ * const serialize = createRouteSerializer({
+ *   type: 'object',
+ *   properties: {
+ *     id: { type: 'number' },
+ *     name: { type: 'string' },
+ *     email: { type: 'string' }
+ *   }
+ * });
+ *
+ * app.get('/user/:id', async (ctx) => {
+ *   const user = await getUser(ctx.params.id);
+ *   return {
+ *     statusCode: 200,
+ *     headers: { 'Content-Type': 'application/json' },
+ *     body: serialize(user)  // 2-3x faster than JSON.stringify!
+ *   };
+ * });
+ * ```
+ */
+function createRouteSerializer(schema) {
+    return createSerializer(schema);
+}
+exports.default = {
+    createSerializer,
+    createRouteSerializer,
+    fastStringify,
+    FastSerializers: exports.FastSerializers
+};
+//# sourceMappingURL=fast-json.js.map

package/dist/core/performance/fast-json.js.map

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

package/dist/core/router/file-router.d.ts

@@ -4,20 +4,26 @@
  * Automatically scans a directory and registers routes based on file/folder structure.
  * Designed for class-based routing: 1 file = 1 class = 1 route.
  *
- * Smart filename conventions:
+ * Smart filename conventions (only if no body schema):
  * - `index.ts`  → GET (default), maps to parent path
  * - `create.ts` → POST, maps to parent path (not /create)
  * - `update.ts` → PUT, maps to parent path (not /update)
  * - `delete.ts` → DELETE, maps to parent path (not /delete)
  * - `patch.ts`  → PATCH, maps to parent path (not /patch)
- * - Other files → GET (or specify `method` in class)
+ * - Other files → GET (default)
+ *
+ * Smart body detection (HIGHEST PRIORITY after explicit method):
+ * - If schema() returns object with `body` property → POST
+ * - Works with inheritance (parent class schema is checked too)
+ * - Overrides smart filename detection!
+ * - Override by explicitly setting `method` property in class
  *
  * @example
  * ```
  * routes/
  *   api/
  *     auth/
- *       register.ts       → POST /api/auth/register (method = 'POST' in class)
+ *       register.ts       → POST /api/auth/register (auto-detected via ctx.body!)
  *       login.ts          → POST /api/auth/login
  *     users/
  *       index.ts          → GET /api/users
@@ -31,11 +37,18 @@
  * Each file exports a class:
  * ```typescript
  * export default class RegisterRoute {
- *   method = 'POST'  // Optional if filename is create/update/delete
+ *   // No need to specify method = 'POST' if schema has body!
+ *
+ *   schema() {
+ *     return {
+ *       body: z.object({ ... })  // ← auto-detects POST!
+ *     };
+ *   }
  *
- *   schema() { ... }
- *   meta() { ... }
- *   async handler(ctx: Context) { ... }
+ *   async handler(ctx: Context) {
+ *     const data = ctx.body;
+ *     ...
+ *   }
  * }
  * ```
  */

package/dist/core/router/file-router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-router.d.ts","sourceRoot":"","sources":["../../../src/core/router/file-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAKH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EACH,UAAU,EACV,OAAO,EAEP,YAAY,EACZ,SAAS,EACT,UAAU,EAGb,MAAM,UAAU,CAAC;AAsClB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,uEAAuE;IACvE,GAAG,EAAE,MAAM,CAAC;IACZ,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2DAA2D;IAC3D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,kDAAkD;IAClD,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,YAAY,CAAC;IAC5B,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,SAAS,CAAC;IACvB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,UAAU,EAAE,CAAC;IACjC,wBAAwB;IACxB,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,sCAAsC;IACtC,OAAO,CAAC,EAAE,cAAc,GAAG,CAAC,UAAU,cAAc,CAAC,CAAC;CACzD;AAED;;GAEG;AACH,UAAU,WAAW;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAUD;;;;;;;;GAQG;AACH,qBAAa,UAAU;IACnB,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,eAAe,CAAyB;gBAEpC,OAAO,EAAE,iBAAiB;IAWtC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAoBpC;;OAEG;IACG,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B/C;;OAEG;YACW,aAAa;IA4C3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAYnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAgCpB;;OAEG;IACH,OAAO,CAAC,cAAc;IA+BtB;;OAEG;YACW,aAAa;IAgJ3B;;OAEG;YACW,cAAc;IAwB5B;;OAEG;IACH,OAAO,CAAC,wBAAwB;CAKnC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAEvE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,aAAa,CAC/B,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,iBAAiB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAGf"}
+{"version":3,"file":"file-router.d.ts","sourceRoot":"","sources":["../../../src/core/router/file-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAKH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EACH,UAAU,EACV,OAAO,EAEP,YAAY,EACZ,SAAS,EACT,UAAU,EAGb,MAAM,UAAU,CAAC;AAsClB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,uEAAuE;IACvE,GAAG,EAAE,MAAM,CAAC;IACZ,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2DAA2D;IAC3D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,kDAAkD;IAClD,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,YAAY,CAAC;IAC5B,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,SAAS,CAAC;IACvB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,UAAU,EAAE,CAAC;IACjC,wBAAwB;IACxB,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,sCAAsC;IACtC,OAAO,CAAC,EAAE,cAAc,GAAG,CAAC,UAAU,cAAc,CAAC,CAAC;CACzD;AAED;;GAEG;AACH,UAAU,WAAW;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAUD;;;;;;;;GAQG;AACH,qBAAa,UAAU;IACnB,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,eAAe,CAAyB;gBAEpC,OAAO,EAAE,iBAAiB;IAWtC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAoBpC;;OAEG;IACG,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B/C;;OAEG;YACW,aAAa;IA4C3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAYnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAgCpB;;OAEG;IACH,OAAO,CAAC,cAAc;IA+BtB;;OAEG;YACW,aAAa;IAgK3B;;OAEG;YACW,cAAc;IAwB5B;;OAEG;IACH,OAAO,CAAC,wBAAwB;CAKnC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAEvE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,aAAa,CAC/B,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,iBAAiB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/core/router/file-router.js

@@ -5,20 +5,26 @@
  * Automatically scans a directory and registers routes based on file/folder structure.
  * Designed for class-based routing: 1 file = 1 class = 1 route.
  *
- * Smart filename conventions:
+ * Smart filename conventions (only if no body schema):
  * - `index.ts`  → GET (default), maps to parent path
  * - `create.ts` → POST, maps to parent path (not /create)
  * - `update.ts` → PUT, maps to parent path (not /update)
  * - `delete.ts` → DELETE, maps to parent path (not /delete)
  * - `patch.ts`  → PATCH, maps to parent path (not /patch)
- * - Other files → GET (or specify `method` in class)
+ * - Other files → GET (default)
+ *
+ * Smart body detection (HIGHEST PRIORITY after explicit method):
+ * - If schema() returns object with `body` property → POST
+ * - Works with inheritance (parent class schema is checked too)
+ * - Overrides smart filename detection!
+ * - Override by explicitly setting `method` property in class
  *
  * @example
  * ```
  * routes/
  *   api/
  *     auth/
- *       register.ts       → POST /api/auth/register (method = 'POST' in class)
+ *       register.ts       → POST /api/auth/register (auto-detected via ctx.body!)
  *       login.ts          → POST /api/auth/login
  *     users/
  *       index.ts          → GET /api/users
@@ -32,11 +38,18 @@
  * Each file exports a class:
  * ```typescript
  * export default class RegisterRoute {
- *   method = 'POST'  // Optional if filename is create/update/delete
+ *   // No need to specify method = 'POST' if schema has body!
+ *
+ *   schema() {
+ *     return {
+ *       body: z.object({ ... })  // ← auto-detects POST!
+ *     };
+ *   }
  *
- *   schema() { ... }
- *   meta() { ... }
- *   async handler(ctx: Context) { ... }
+ *   async handler(ctx: Context) {
+ *     const data = ctx.body;
+ *     ...
+ *   }
  * }
  * ```
  */
@@ -347,18 +360,33 @@ class FileRouter {
             }
             // Determine HTTP method:
             // 1. If class explicitly defines method → use it
-            // 2. If filename is smart (create/update/delete/patch/index) → auto-detect
-            // 3. Otherwise → default GET
+            // 2. If schema has body definition → auto-detect as POST (highest priority for body!)
+            // 3. If filename is smart (create/update/delete/patch/index) → auto-detect from filename
+            // 4. Otherwise → default GET
             let method;
             if (route.method) {
                 // Handle both single method and array of methods (use first one for file-based routing)
                 method = Array.isArray(route.method) ? route.method[0] : route.method;
             }
-            else if (isSmartFilename(nameWithoutExt)) {
-                method = getSmartMethod(nameWithoutExt);
-            }
             else {
-                method = DEFAULT_METHOD;
+                // Check schema for body definition first (works with inheritance!)
+                const schema = route.schema?.();
+                if (this.options.debug) {
+                    console.log(`🔍 Smart detection for ${filePath}:`);
+                    console.log(`   - schema:`, schema);
+                    console.log(`   - has body:`, !!schema?.body);
+                }
+                if (schema?.body) {
+                    // Schema has body → POST (overrides smart filename!)
+                    method = 'POST';
+                }
+                else if (isSmartFilename(nameWithoutExt)) {
+                    // Smart filename detection (create→POST, update→PUT, etc.)
+                    method = getSmartMethod(nameWithoutExt);
+                }
+                else {
+                    method = DEFAULT_METHOD;
+                }
             }
             // Validate method
             if (!HTTP_METHODS.includes(method)) {