monapi 0.1.0 → 1.0.0

package/README.md

@@ -2,7 +2,7 @@
 
 Auto-generate secure, extensible REST APIs for MongoDB collections using configuration only.
 
-Define a schema. Get a full CRUD API. No boilerplate.
+Define a schema. Get a full CRUD API. No boilerplate. **Works with Express and Hono** (Bun/Deno/Cloudflare Workers).
 
 ## Install
 
@@ -10,10 +10,14 @@ Define a schema. Get a full CRUD API. No boilerplate.
 npm install monapi
 ```
 
-**Peer dependencies:**
+**Peer dependencies (pick your framework):**
 
 ```bash
+# Express (default)
 npm install express mongoose
+
+# Hono (works on Bun, Deno, Cloudflare Workers, Node)
+npm install hono mongoose
 ```
 
 ## Quick Start
@@ -54,6 +58,33 @@ PATCH  /api/users/:id       Partial update user
 DELETE /api/users/:id       Delete user
 ```
 
+### Hono (Bun / Deno / Cloudflare Workers / Node)
+
+```ts
+import { Hono } from 'hono'
+import mongoose, { Schema } from 'mongoose'
+import { Monapi } from 'monapi'
+
+mongoose.connect('mongodb://localhost:27017/myapp')
+
+const UserSchema = new Schema({
+  name: { type: String, required: true },
+  email: { type: String, required: true },
+})
+
+const monapi = new Monapi({
+  connection: mongoose.connection,
+  framework: 'hono',
+})
+
+monapi.resource('users', { schema: UserSchema })
+
+const app = new Hono()
+app.route('/api', monapi.router())
+
+export default app // Works with Bun.serve, Deno.serve, etc.
+```
+
 ## Filtering
 
 ### Simple equality
@@ -358,6 +389,7 @@ monapi enforces safe defaults:
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
 | `connection` | `mongoose.Connection` | *required* | MongoDB connection |
+| `framework` | `'express' \| 'hono' \| FrameworkAdapter` | `'express'` | Framework to use |
 | `basePath` | `string` | `''` | Base path prefix for routes |
 | `auth` | `AuthConfig` | - | Auth configuration |
 | `defaults` | `DefaultConfig` | - | Global defaults |
@@ -378,7 +410,37 @@ monapi enforces safe defaults:
 
 ### `monapi.router()`
 
-Returns an Express `Router` with all registered collection routes.
+Returns a framework-specific router:
+- **Express**: Express `Router` instance
+- **Hono**: Hono app instance
+
+## Custom Framework Adapter
+
+You can bring your own framework by implementing the `FrameworkAdapter` interface:
+
+```ts
+import { Monapi, FrameworkAdapter } from 'monapi'
+
+const myAdapter: FrameworkAdapter = {
+  name: 'my-framework',
+  createRouter(collections, options) { /* ... */ },
+  wrapHandler(handler) { /* ... */ },
+  createErrorHandler(logger) { /* ... */ },
+}
+
+const monapi = new Monapi({
+  connection: mongoose.connection,
+  framework: myAdapter,
+})
+```
+
+## Contributing
+
+Contributions welcome! Areas that need help:
+- **Fastify adapter** - `src/adapters/framework/fastify.ts`
+- **NestJS adapter** - `src/adapters/framework/nestjs.ts`
+- **Koa adapter** - `src/adapters/framework/koa.ts`
+- **Zod/Joi/Yup schema adapters** - `src/adapters/schema/`
 
 ## License
 

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { Request, Response, NextFunction, RequestHandler, Router } from 'express';
 import { FilterQuery, SortOrder, Model, Schema, Connection } from 'mongoose';
+import { Request, Response, NextFunction, RequestHandler, Router } from 'express';
 
 type FilterOperator = 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'nin' | 'like' | 'exists';
 interface FilterCondition {
@@ -239,19 +239,83 @@ interface ErrorResponse {
     };
 }
 
+interface MonapiRequest {
+    params: Record<string, string>;
+    query: Record<string, any>;
+    body: any;
+    headers: Record<string, string | string[] | undefined>;
+    method: string;
+    path: string;
+    user?: any;
+    raw: any;
+}
+interface MonapiResponse {
+    status(code: number): MonapiResponse;
+    json(data: any): void;
+    setHeader(key: string, value: string): MonapiResponse;
+    raw: any;
+}
+type MonapiHandler = (req: MonapiRequest, res: MonapiResponse) => Promise<void> | void;
+interface OperationResult {
+    statusCode: number;
+    data: any;
+    meta?: {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages?: number;
+    };
+}
+interface CollectionContext {
+    name: string;
+    model: Model<any>;
+    adapter: SchemaAdapter;
+    config: CollectionConfig;
+    defaults?: DefaultConfig;
+    logger?: Logger;
+}
+interface FrameworkAdapter {
+    readonly name: string;
+    createRouter(collections: Map<string, CollectionContext>, options?: {
+        basePath?: string;
+        authMiddleware?: any;
+    }): any;
+    wrapHandler(handler: MonapiHandler): any;
+    createErrorHandler(logger?: Logger): any;
+}
+type BuiltinFramework = 'express' | 'hono';
+
 declare class Monapi {
     private config;
     private logger;
     private collections;
-    private authMiddleware?;
+    private frameworkAdapter;
     constructor(config: MonapiConfig);
     resource(name: string, collectionConfig: CollectionConfig): this;
-    router(): Router;
+    router(): any;
+    getFrameworkAdapter(): FrameworkAdapter;
     getModel(name: string): Model<any> | undefined;
     getAdapter(name: string): SchemaAdapter | undefined;
     private resolveModel;
 }
 
+interface OperationOptions {
+    collectionName: string;
+    model: Model<any>;
+    adapter: SchemaAdapter;
+    config: CollectionConfig;
+    defaults?: DefaultConfig;
+    logger?: Logger;
+}
+declare function listDocuments(req: MonapiRequest, res: MonapiResponse, opts: OperationOptions): Promise<OperationResult>;
+declare function getDocument(req: MonapiRequest, res: MonapiResponse, opts: OperationOptions): Promise<OperationResult>;
+declare function createDocument(req: MonapiRequest, res: MonapiResponse, opts: OperationOptions): Promise<OperationResult>;
+declare function updateDocument(req: MonapiRequest, res: MonapiResponse, opts: OperationOptions): Promise<OperationResult>;
+declare function patchDocument(req: MonapiRequest, res: MonapiResponse, opts: OperationOptions): Promise<OperationResult>;
+declare function deleteDocument(req: MonapiRequest, res: MonapiResponse, opts: OperationOptions): Promise<OperationResult>;
+
+declare function checkPermissions(req: MonapiRequest, collection: string, routeOp: string, permissions?: PermissionConfig): Promise<void>;
+
 declare class MongooseAdapter implements SchemaAdapter {
     private schema;
     private model?;
@@ -270,6 +334,31 @@ declare class MongooseAdapter implements SchemaAdapter {
 declare function detectSchemaType(schema: any): SchemaType;
 declare function createSchemaAdapter(schema: Schema | Model<any> | any): SchemaAdapter;
 
+declare class ExpressAdapter implements FrameworkAdapter {
+    readonly name = "express";
+    createRouter(collections: Map<string, CollectionContext>, options?: {
+        basePath?: string;
+        authMiddleware?: RequestHandler;
+    }): Router;
+    wrapHandler(handler: MonapiHandler): RequestHandler;
+    createErrorHandler(logger?: Logger): any;
+    private buildCollectionRouter;
+    private handleOp;
+}
+
+declare class HonoAdapter implements FrameworkAdapter {
+    readonly name = "hono";
+    createRouter(collections: Map<string, CollectionContext>, options?: {
+        basePath?: string;
+        authMiddleware?: any;
+    }): any;
+    wrapHandler(handler: MonapiHandler): any;
+    createErrorHandler(logger?: Logger): any;
+    private registerCollectionRoutes;
+}
+
+declare function resolveFrameworkAdapter(framework?: BuiltinFramework | FrameworkAdapter): FrameworkAdapter;
+
 declare class MonapiError extends Error {
     readonly statusCode: number;
     readonly code: string;
@@ -312,4 +401,4 @@ declare function buildPaginationMeta(total: number, page: number, limit: number)
 
 declare function createErrorHandler(logger?: Logger): (err: Error, _req: Request, res: Response, _next: NextFunction) => void;
 
-export { type AuthConfig, type AuthMiddleware, BadRequestError, type CRUDHandlers, type CRUDOperation, type CollectionConfig, type DefaultConfig, type ErrorResponse, type FieldMetadata, type FieldPermission, type FieldPermissions, FieldType, type FilterCondition, type FilterOperator, ForbiddenError, type Handler, type HookContext, type HookEntry, type HookFunction, type LifecycleHooks, type ListResponse, type Logger, type MiddlewareConfig, Monapi, type MonapiConfig, MonapiError, type MongoQuery, MongooseAdapter, NotFoundError, type PaginationMeta, type ParsedFilters, type Permission, type PermissionConfig, type PermissionContext, type PermissionFunction, type QueryConfig, type QueryOptions, type SchemaAdapter, type SchemaOptions, SchemaType, type ValidationError$1 as SchemaValidationError, type SingleResponse, UnauthorizedError, type User, ValidationError, type ValidationResult, buildPaginationMeta, buildQuery, createErrorHandler, createSchemaAdapter, detectSchemaType, parseFilters };
+export { type AuthConfig, type AuthMiddleware, BadRequestError, type BuiltinFramework, type CRUDHandlers, type CRUDOperation, type CollectionConfig, type CollectionContext, type DefaultConfig, type ErrorResponse, ExpressAdapter, type FieldMetadata, type FieldPermission, type FieldPermissions, FieldType, type FilterCondition, type FilterOperator, ForbiddenError, type FrameworkAdapter, type Handler, HonoAdapter, type HookContext, type HookEntry, type HookFunction, type LifecycleHooks, type ListResponse, type Logger, type MiddlewareConfig, Monapi, type MonapiConfig, MonapiError, type MonapiHandler, type MonapiRequest, type MonapiResponse, type MongoQuery, MongooseAdapter, NotFoundError, type OperationResult, type PaginationMeta, type ParsedFilters, type Permission, type PermissionConfig, type PermissionContext, type PermissionFunction, type QueryConfig, type QueryOptions, type SchemaAdapter, type SchemaOptions, SchemaType, type ValidationError$1 as SchemaValidationError, type SingleResponse, UnauthorizedError, type User, ValidationError, type ValidationResult, buildPaginationMeta, buildQuery, checkPermissions, createDocument, createErrorHandler, createSchemaAdapter, deleteDocument, detectSchemaType, getDocument, listDocuments, parseFilters, patchDocument, resolveFrameworkAdapter, updateDocument };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { Request, Response, NextFunction, RequestHandler, Router } from 'express';
 import { FilterQuery, SortOrder, Model, Schema, Connection } from 'mongoose';
+import { Request, Response, NextFunction, RequestHandler, Router } from 'express';
 
 type FilterOperator = 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'nin' | 'like' | 'exists';
 interface FilterCondition {
@@ -239,19 +239,83 @@ interface ErrorResponse {
     };
 }
 
+interface MonapiRequest {
+    params: Record<string, string>;
+    query: Record<string, any>;
+    body: any;
+    headers: Record<string, string | string[] | undefined>;
+    method: string;
+    path: string;
+    user?: any;
+    raw: any;
+}
+interface MonapiResponse {
+    status(code: number): MonapiResponse;
+    json(data: any): void;
+    setHeader(key: string, value: string): MonapiResponse;
+    raw: any;
+}
+type MonapiHandler = (req: MonapiRequest, res: MonapiResponse) => Promise<void> | void;
+interface OperationResult {
+    statusCode: number;
+    data: any;
+    meta?: {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages?: number;
+    };
+}
+interface CollectionContext {
+    name: string;
+    model: Model<any>;
+    adapter: SchemaAdapter;
+    config: CollectionConfig;
+    defaults?: DefaultConfig;
+    logger?: Logger;
+}
+interface FrameworkAdapter {
+    readonly name: string;
+    createRouter(collections: Map<string, CollectionContext>, options?: {
+        basePath?: string;
+        authMiddleware?: any;
+    }): any;
+    wrapHandler(handler: MonapiHandler): any;
+    createErrorHandler(logger?: Logger): any;
+}
+type BuiltinFramework = 'express' | 'hono';
+
 declare class Monapi {
     private config;
     private logger;
     private collections;
-    private authMiddleware?;
+    private frameworkAdapter;
     constructor(config: MonapiConfig);
     resource(name: string, collectionConfig: CollectionConfig): this;
-    router(): Router;
+    router(): any;
+    getFrameworkAdapter(): FrameworkAdapter;
     getModel(name: string): Model<any> | undefined;
     getAdapter(name: string): SchemaAdapter | undefined;
     private resolveModel;
 }
 
+interface OperationOptions {
+    collectionName: string;
+    model: Model<any>;
+    adapter: SchemaAdapter;
+    config: CollectionConfig;
+    defaults?: DefaultConfig;
+    logger?: Logger;
+}
+declare function listDocuments(req: MonapiRequest, res: MonapiResponse, opts: OperationOptions): Promise<OperationResult>;
+declare function getDocument(req: MonapiRequest, res: MonapiResponse, opts: OperationOptions): Promise<OperationResult>;
+declare function createDocument(req: MonapiRequest, res: MonapiResponse, opts: OperationOptions): Promise<OperationResult>;
+declare function updateDocument(req: MonapiRequest, res: MonapiResponse, opts: OperationOptions): Promise<OperationResult>;
+declare function patchDocument(req: MonapiRequest, res: MonapiResponse, opts: OperationOptions): Promise<OperationResult>;
+declare function deleteDocument(req: MonapiRequest, res: MonapiResponse, opts: OperationOptions): Promise<OperationResult>;
+
+declare function checkPermissions(req: MonapiRequest, collection: string, routeOp: string, permissions?: PermissionConfig): Promise<void>;
+
 declare class MongooseAdapter implements SchemaAdapter {
     private schema;
     private model?;
@@ -270,6 +334,31 @@ declare class MongooseAdapter implements SchemaAdapter {
 declare function detectSchemaType(schema: any): SchemaType;
 declare function createSchemaAdapter(schema: Schema | Model<any> | any): SchemaAdapter;
 
+declare class ExpressAdapter implements FrameworkAdapter {
+    readonly name = "express";
+    createRouter(collections: Map<string, CollectionContext>, options?: {
+        basePath?: string;
+        authMiddleware?: RequestHandler;
+    }): Router;
+    wrapHandler(handler: MonapiHandler): RequestHandler;
+    createErrorHandler(logger?: Logger): any;
+    private buildCollectionRouter;
+    private handleOp;
+}
+
+declare class HonoAdapter implements FrameworkAdapter {
+    readonly name = "hono";
+    createRouter(collections: Map<string, CollectionContext>, options?: {
+        basePath?: string;
+        authMiddleware?: any;
+    }): any;
+    wrapHandler(handler: MonapiHandler): any;
+    createErrorHandler(logger?: Logger): any;
+    private registerCollectionRoutes;
+}
+
+declare function resolveFrameworkAdapter(framework?: BuiltinFramework | FrameworkAdapter): FrameworkAdapter;
+
 declare class MonapiError extends Error {
     readonly statusCode: number;
     readonly code: string;
@@ -312,4 +401,4 @@ declare function buildPaginationMeta(total: number, page: number, limit: number)
 
 declare function createErrorHandler(logger?: Logger): (err: Error, _req: Request, res: Response, _next: NextFunction) => void;
 
-export { type AuthConfig, type AuthMiddleware, BadRequestError, type CRUDHandlers, type CRUDOperation, type CollectionConfig, type DefaultConfig, type ErrorResponse, type FieldMetadata, type FieldPermission, type FieldPermissions, FieldType, type FilterCondition, type FilterOperator, ForbiddenError, type Handler, type HookContext, type HookEntry, type HookFunction, type LifecycleHooks, type ListResponse, type Logger, type MiddlewareConfig, Monapi, type MonapiConfig, MonapiError, type MongoQuery, MongooseAdapter, NotFoundError, type PaginationMeta, type ParsedFilters, type Permission, type PermissionConfig, type PermissionContext, type PermissionFunction, type QueryConfig, type QueryOptions, type SchemaAdapter, type SchemaOptions, SchemaType, type ValidationError$1 as SchemaValidationError, type SingleResponse, UnauthorizedError, type User, ValidationError, type ValidationResult, buildPaginationMeta, buildQuery, createErrorHandler, createSchemaAdapter, detectSchemaType, parseFilters };
+export { type AuthConfig, type AuthMiddleware, BadRequestError, type BuiltinFramework, type CRUDHandlers, type CRUDOperation, type CollectionConfig, type CollectionContext, type DefaultConfig, type ErrorResponse, ExpressAdapter, type FieldMetadata, type FieldPermission, type FieldPermissions, FieldType, type FilterCondition, type FilterOperator, ForbiddenError, type FrameworkAdapter, type Handler, HonoAdapter, type HookContext, type HookEntry, type HookFunction, type LifecycleHooks, type ListResponse, type Logger, type MiddlewareConfig, Monapi, type MonapiConfig, MonapiError, type MonapiHandler, type MonapiRequest, type MonapiResponse, type MongoQuery, MongooseAdapter, NotFoundError, type OperationResult, type PaginationMeta, type ParsedFilters, type Permission, type PermissionConfig, type PermissionContext, type PermissionFunction, type QueryConfig, type QueryOptions, type SchemaAdapter, type SchemaOptions, SchemaType, type ValidationError$1 as SchemaValidationError, type SingleResponse, UnauthorizedError, type User, ValidationError, type ValidationResult, buildPaginationMeta, buildQuery, checkPermissions, createDocument, createErrorHandler, createSchemaAdapter, deleteDocument, detectSchemaType, getDocument, listDocuments, parseFilters, patchDocument, resolveFrameworkAdapter, updateDocument };