@nano-app/backend 0.17.0 → 0.18.0

package/README.md

@@ -4,7 +4,7 @@
 
 Preconfigured Express server with **file-convention routes** and **plugins**: it mounts the base middlewares, discovers your routes, formats every error as JSON, and groups extra endpoints in plugins.
 
-- Node.js 22.23.4, 24.22.1 or 26.12.1 and newer. ESM only.
+- Node.js 22.23.4, 24.22.1 or 26.12.1 and newer, or Bun 1.4.4 and newer (`bun src/app.ts`). ESM only.
 - Optional PostgreSQL layer through Drizzle. Off by default: without it no database code is loaded.
 
 ```bash
@@ -262,7 +262,7 @@ Two levels. Only the plugin's receives the Express app, so nothing app-wide depe
 |---|---|---|---|---|
 | Plugin (`callbacks` in its config) | `onMount` | Once, after its database and before its endpoints | `(app, params)` | App-level middlewares (a guard), shared setup |
 | Endpoint (`callbacks` in `createRoute`) | `onInit` | Once, when the endpoint is mounted | `(params)` | Setup of that route |
-| Endpoint | `onBefore` | Before every request the endpoint handles | `(req, method, params)` | Validate or load; its return value reaches the handler as `params.onBeforeResult` |
+| Endpoint | `onBefore` | Before every request the endpoint handles | `(req, method, params)` | Validate or load; its return value reaches the handler as `params.onBeforeResult` (`{}` without `onBefore`) |
 
 ```ts
 export default createPlugin((options?: { publicPaths?: string[] }) => ({
@@ -305,7 +305,7 @@ GET /unknown                                        // → 404 { success: false,
 | `createPlugin(creator)` | Types a plugin factory and its options. |
 | `createPluginCallbacks(callbacks)` | Types the callbacks of a plugin (`createPluginCallbacks<{ db: MyDb }>` types `db`), e.g. to keep them in their own file. |
 
-Also exported: the `NanoApp` class that `createNanoApp` returns, the configuration types (`NanoAppConfig`, `PackagesConfig`, `PluginConfig`, `PluginStage`, `MainPluginConfig`, `DatabaseConfig`), the Express `Request` type and the HTTP contract (`ApiResponse`, `ApiPromise`, `QueryParams`, `RouteEntry`, `Handler`, `Handlers`, `NanoObject`) and the callback types (`Params`, `Callbacks`, `PluginCallbacks`).
+Also exported: the `NanoApp` class that `createNanoApp` returns, the configuration types (`NanoAppConfig`, `PackagesConfig`, `PluginConfig`, `PluginStage`, `MainPluginConfig`, `DatabaseConfig`), the Express `Request` type and the HTTP contract (`ApiResponse`, `ApiPromise`, `QueryParams`, `RouteEntry`, `Handler`, `HandlerParams`, `Handlers`, `NanoObject`) and the callback types (`Params`, `Callbacks`, `PluginCallbacks`).
 
 ## Development
 

package/build/index.d.ts

@@ -30,12 +30,15 @@ type QueryParams = {
 type Params<Deps = NanoObject<any>> = Deps & {
   /** Better Auth's instance, when it is on */
   auth?: NanoObject;
-  onBeforeResult?: NanoObject;
   /** `{ user, session }` of Better Auth, when the request has one */
   session?: NanoObject;
 };
+/** Params of a handler: also what `onBefore` returned, `{}` without it */
+type HandlerParams<Deps = NanoObject<any>> = Params<Deps> & {
+  onBeforeResult: NanoObject;
+};
 /** Endpoint handler */
-type Handler<Deps> = (req: Request$1, params: Params<Deps>) => ApiPromise;
+type Handler<Deps> = (req: Request$1, params: HandlerParams<Deps>) => ApiPromise;
 /** A method with its own permissions, instead of those of the route */
 type MethodEntry<Deps = NanoObject<any>> = {
   handler: Handler<Deps>;
@@ -176,4 +179,4 @@ export declare function createPlugin<Options>(fnCreator: Creator<Options>): Crea
 export declare function createPluginCallbacks<Deps = NanoObject<any>>(oCallbacks: PluginCallbacks<Deps>): PluginCallbacks<Deps>;
 /** Whether the session's user has the permissions; always without Better Auth or permissions */
 declare function isGranted({ auth, session }: Params, oPermissions?: NanoObject<string[]>): Promise<boolean>;
-export { type ApiPromise, type ApiResponse, type Callbacks, type DatabaseConfig, type Handler, type Handlers, type MainPluginConfig, type MethodEntry, NanoApp, type NanoAppConfig, NanoError, type NanoObject, type PackagesConfig, type Params, type PluginCallbacks, type PluginConfig, type PluginStage, type QueryParams, type Request, type RouteEntry, isGranted };
+export { type ApiPromise, type ApiResponse, type Callbacks, type DatabaseConfig, type Handler, type HandlerParams, type Handlers, type MainPluginConfig, type MethodEntry, NanoApp, type NanoAppConfig, NanoError, type NanoObject, type PackagesConfig, type Params, type PluginCallbacks, type PluginConfig, type PluginStage, type QueryParams, type Request, type RouteEntry, isGranted };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nano-app/backend",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "Express server with file-convention routes, plugins and an optional PostgreSQL layer",
   "type": "module",
   "main": "build/index.js",
@@ -40,7 +40,8 @@
     "access": "public"
   },
   "engines": {
-    "node": "^22.23.4 || ^24.22.1 || >=26.12.1"
+    "node": "^22.23.4 || ^24.22.1 || >=26.12.1",
+    "bun": ">=1.4.4"
   },
   "dependencies": {
     "compression": "^1.8.2",