@nano-app/backend 0.12.1 → 0.12.3

package/README.md

@@ -34,7 +34,7 @@ createNanoApp({ port: 3000 });
 import { createRoute } from '@nano-app/backend';
 
 export default createRoute({
-  GET: async () => ({ success: true, result: { status: 'ok' } }),
+  GET: async () => ({ result: { status: 'ok' } }),
 });
 ```
 
@@ -53,16 +53,17 @@ Each `*.route.ts` under `mainPlugin.routesDir` default-exports an object with th
 ```ts
 export default createRoute({
   expression: '/:id',                                  // → /users/:id
-  GET:    async req => ({ success: true, result: { id: req.params.id } }),
-  DELETE: async req => ({ success: true, message: 'Deleted' }),
+  GET:    async req => ({ result: { id: req.params.id } }),
+  DELETE: async req => ({ message: 'Deleted' }),
 });
 ```
 
-Each handler receives `(req, params)` and returns an `ApiResponse`. `params` holds the plugin's `options`, `db` (the Prisma client when a database is enabled, see [Database](#database)) and `onBeforeResult` (see [Callbacks](#callbacks)):
+Each handler receives `(req, params)` and returns an `ApiResponse` without `success`: its `status` is the HTTP status (`200` by default) and the framework sets `success` to `status < 400`. `params` holds the plugin's `options`, `db` (the Prisma client when a database is enabled, see [Database](#database)) and `onBeforeResult` (see [Callbacks](#callbacks)):
 
 ```ts
 type ApiResponse<T> = {
-  success?: boolean;   // true → HTTP 200, any other value → HTTP 400
+  status?: number;     // HTTP status, 200 by default; not sent in the body
+  success?: boolean;   // set by the framework: status < 400
   result?: T;
   message?: string;
   warning?: boolean;
@@ -137,7 +138,7 @@ import { createRoute } from '@nano-app/backend';
 import type { PrismaClient } from '../../.nano-app/prisma-clients/app/generated/client';
 
 export default createRoute<PrismaClient>({
-  GET: async (_req, { db }) => ({ success: true, result: await db!.user.findMany() }),
+  GET: async (_req, { db }) => ({ result: await db!.user.findMany() }),
 });
 ```
 
@@ -222,7 +223,7 @@ export default createPlugin((options?: { basePath?: string }) => ({
 import { createRoute } from '@nano-app/backend';
 
 export default createRoute({
-  GET: async () => ({ success: true, result: { ok: true } }),
+  GET: async () => ({ result: { ok: true } }),
 });
 ```
 
@@ -263,7 +264,7 @@ The endpoints of one plugin have no guaranteed order: one route's `onInit` must
 
 Everything is mounted on one Express application, in this order: base middlewares → `before` plugins → your routes → `after` plugins → 404 → error handler.
 
-A plugin with a database follows the same rules, with its client in `.nano-app/prisma-clients/<name>`: a plugin of yours points `database.schemaPath` at its schema and you apply it with Prisma. Two plugins with the same name and a database fail at startup. If that folder holds the client of another schema from an earlier start, the startup warns and replaces it. An official plugin of `@nano-app/plugins` needs nothing from you: at startup nano-app applies its migrations to its own `nano_*` schema. See [PLUGINS.md](https://github.com/Nano-Nathan/nano-app/blob/main/PLUGINS.md).
+A plugin with a database follows the same rules, with its client in `.nano-app/prisma-clients/<name>`: a plugin of yours points `database.schemaPath` at its schema and you apply it with Prisma. Two plugins with the same name and a database fail at startup. If that folder holds the client of another schema from an earlier start, the startup warns and replaces it. An official plugin of `@nano-app/plugins` needs nothing from you: at startup nano-app applies its migrations to its own `nano_*` schema. See [`@nano-app/plugins`](https://github.com/Nano-Nathan/nano-app/blob/main/plugins/README.md#database).
 
 ## Errors
 

package/build/index.d.ts

@@ -4,9 +4,9 @@ import { Options } from "express-rate-limit";
 import "dotenv/config";
 import "jiti";
 import { BetterAuthOptions } from "better-auth";
-//#region ../core/types/api.d.ts
 /** API response */
 type ApiResponse<T = any> = {
+  status?: number;
   success?: boolean;
   result?: T;
   message?: string;
@@ -22,8 +22,6 @@ type QueryParams = {
   orderby?: NanoObject<'asc' | 'desc'>;
   select?: string;
 };
-//#endregion
-//#region ../core/types/objects.d.ts
 /** Extra params of handlers and callbacks */
 type Params<DB = any> = Partial<NanoObject & {
   db?: DB;
@@ -67,8 +65,6 @@ type RouteEntry<DB = any> = {
 } & Handlers<DB>;
 /** Generic object */
 type NanoObject<T = any> = Record<string, T>;
-//#endregion
-//#region src/types/database.d.ts
 /** Database client configuration. */
 type DatabaseConfig = {
   /** Whether the database is enabled. Defaults to false */
@@ -76,8 +72,6 @@ type DatabaseConfig = {
   /** Prisma schema file (`.prisma`), relative to `cwd` */
   schemaPath: string;
 };
-//#endregion
-//#region src/types/plugin.d.ts
 /** When a plugin is mounted, relative to the consumer routes */
 type PluginStage = 'before' | 'after';
 /** Plugin configuration: a group of endpoints */
@@ -115,8 +109,6 @@ type MainPluginConfig<Options = NanoObject> = {
   /** Plugin callbacks */
   callbacks?: PluginCallbacks;
 };
-//#endregion
-//#region src/types/app.d.ts
 /** Configuration of the framework's built-in packages */
 type PackagesConfig = {
   /** Morgan configuration */
@@ -156,14 +148,10 @@ type NanoAppConfig = {
   /** Main plugin to mount. */
   mainPlugin?: MainPluginConfig;
 };
-//#endregion
-//#region src/app/config.d.ts
 /** Merges the consumer configuration over the initial one; the main plugin is always named "app" */
 declare function mergeConfig(oConfig?: NanoAppConfig): NanoAppConfig & Required<Pick<NanoAppConfig, 'settings' | 'plugins' | 'packages'>> & {
   mainPlugin: PluginConfig;
 };
-//#endregion
-//#region src/app/NanoApp.d.ts
 /** Main NanoApp class */
 declare class NanoApp {
   protected oApp: Express;
@@ -176,8 +164,6 @@ declare class NanoApp {
   /** Adds the packages according to the configuration */
   private setPackages;
 }
-//#endregion
-//#region src/app/creators.d.ts
 /** Creates a new NanoApp instance */
 export declare function createNanoApp(oConfig?: NanoAppConfig): NanoApp;
 /** Creates and types a route object. */
@@ -187,5 +173,4 @@ type Creator<Options> = (options?: Options) => PluginConfig<Options>;
 export declare function createPlugin<Options>(fnCreator: Creator<Options>): Creator<Options>;
 /** Creates and types the callbacks of a plugin. */
 export declare function createPluginCallbacks<DB>(oCallbacks: PluginCallbacks<DB>): PluginCallbacks<DB>;
-//#endregion
 export { type ApiPromise, type ApiResponse, type Callbacks, type DatabaseConfig, type Handler, type Handlers, type MainPluginConfig, NanoApp, type NanoAppConfig, type NanoObject, type PackagesConfig, type Params, type PluginCallbacks, type PluginConfig, type PluginStage, type QueryParams, type Request, type RouteEntry };

package/build/index.js

@@ -12,7 +12,7 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { createJiti } from "jiti";
 import { execFileSync } from "node:child_process";
 import { createHash } from "node:crypto";
-//#region ../core/const.ts
+// ../core/const.ts
 /** HTTP methods a route can handle */
 const HTTP_METHODS = [
 	"GET",
@@ -25,8 +25,7 @@ const HTTP_METHODS = [
 const OFFICIAL_PLUGINS = "@nano-app/plugins";
 /** Error when the database URL is missing at startup */
 const MISSING_DATABASE_URL = "[nano-app] [ERROR] The DATABASE_URL environment variable is not defined.";
-//#endregion
-//#region ../core/loader/Validator.ts
+// ../core/loader/Validator.ts
 const STORE_TYPES = ["app", "api"];
 /** Checks the consumer's files: invalid ones are warned about and discarded */
 var Validator = class Validator {
@@ -83,8 +82,7 @@ var Validator = class Validator {
 		return this.oValidators[sExtension]?.()(oEntry, sFilePath) ? oEntry : void 0;
 	}
 };
-//#endregion
-//#region ../core/loader/FileReader.ts
+// ../core/loader/FileReader.ts
 /** Reads and loads files from disk, resolved from `cwd` */
 var FileReader = class {
 	/** Loader of the consumer's modules; the Prisma runtime is loaded natively */
@@ -110,8 +108,7 @@ var FileReader = class {
 		return sAbsolutePath;
 	}
 };
-//#endregion
-//#region ../core/utils/Formatter.ts
+// ../core/utils/Formatter.ts
 /** Formats values for logs and messages */
 var Formatter = class {
 	/** Message of anything thrown: its `message` when it has one, else the value itself */
@@ -124,8 +121,7 @@ var Formatter = class {
 		return oDate.toISOString().slice(0, 19).replace("T", " ");
 	}
 };
-//#endregion
-//#region ../core/loader/FileLoader.ts
+// ../core/loader/FileLoader.ts
 /** Finds, loads and validates the consumer's files */
 var FileLoader = class {
 	/**
@@ -157,8 +153,7 @@ var FileLoader = class {
 		return Validator.validate(oEntries, extension);
 	}
 };
-//#endregion
-//#region src/routes/Endpoint.ts
+// src/routes/Endpoint.ts
 /** Base class for all endpoints */
 var Endpoint = class {
 	oMethods;
@@ -191,13 +186,17 @@ var Endpoint = class {
 				...oRequestParams,
 				onBeforeResult
 			})).then((oResponse) => {
-				oRes.status(oResponse.success ? 200 : 400).json(oResponse);
+				const { status, ...oBody } = oResponse;
+				const iStatus = status ?? 200;
+				oRes.status(iStatus).json({
+					...oBody,
+					success: iStatus < 400
+				});
 			}).catch(fnNext);
 		};
 	}
 };
-//#endregion
-//#region src/routes/Router.ts
+// src/routes/Router.ts
 /** Turns a folder of `*.route.ts` files into Express paths and endpoints */
 var Router = class {
 	oRoutes = {};
@@ -227,8 +226,7 @@ var Router = class {
 		return `${this.sBasePath}${sEndpoint.replace(/\/index$/, "")}${sExpression}` || "/";
 	}
 };
-//#endregion
-//#region src/auth/BetterAuth.ts
+// src/auth/BetterAuth.ts
 /** Better Auth on the app's Prisma client: the instance, its handler and a session guard */
 var BetterAuth = class {
 	/** Creates the instance on the app's client, its handler and the guard */
@@ -260,8 +258,7 @@ var BetterAuth = class {
 		};
 	}
 };
-//#endregion
-//#region src/database/Prisma.ts
+// src/database/Prisma.ts
 /** Runs the consumer's Prisma CLI: generates clients and applies official plugins' migrations */
 var Prisma = class {
 	/** Folder of a client and its files, in the project */
@@ -336,8 +333,7 @@ var Prisma = class {
 		}
 	}
 };
-//#endregion
-//#region src/database/Database.ts
+// src/database/Database.ts
 /** Prisma clients of the app and its plugins, one per name */
 var Database = class {
 	static oAdapter;
@@ -396,8 +392,7 @@ var Database = class {
 		return JSON.parse(readFileSync(join(sDir, "package.json"), "utf-8")).name === OFFICIAL_PLUGINS;
 	}
 };
-//#endregion
-//#region src/routes/Plugin.ts
+// src/routes/Plugin.ts
 /** A group of routes, with its options, callbacks and database */
 var Plugin = class {
 	oConfig;
@@ -426,8 +421,7 @@ var Plugin = class {
 		for (const { path, endpoint } of await oRouter.mount()) oApp.all(path, await endpoint.mount(oParams));
 	}
 };
-//#endregion
-//#region src/app/config.ts
+// src/app/config.ts
 /** Initial application configuration */
 const INITIAL_CONFIG = {
 	/** Application port */
@@ -505,8 +499,7 @@ function mergeConfig(oConfig = {}) {
 		}
 	};
 }
-//#endregion
-//#region src/app/errors.ts
+// src/app/errors.ts
 /** Whether anything thrown is an object, read as a HandlerError */
 function isHandlerError(oError) {
 	return typeof oError === "object" && oError !== null;
@@ -543,8 +536,7 @@ const errorHandler = (oError, _oReq, oRes, _fnNext) => {
 	if (status >= 500) console.error("[nano-app] [ERROR]", oError);
 	oRes.status(status).json(body);
 };
-//#endregion
-//#region src/app/NanoApp.ts
+// src/app/NanoApp.ts
 /** Main NanoApp class */
 var NanoApp = class {
 	oApp;
@@ -598,8 +590,7 @@ var NanoApp = class {
 		if (oConfig.urlencoded) this.oApp.use(express.urlencoded(oConfig.urlencoded));
 	}
 };
-//#endregion
-//#region src/app/creators.ts
+// src/app/creators.ts
 /** Creates a new NanoApp instance */
 function createNanoApp(oConfig) {
 	return new NanoApp(oConfig);
@@ -615,5 +606,4 @@ function createPlugin(fnCreator) {
 function createPluginCallbacks(oCallbacks) {
 	return oCallbacks;
 }
-//#endregion
 export { NanoApp, createNanoApp, createPlugin, createPluginCallbacks, createRoute };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nano-app/backend",
-  "version": "0.12.1",
+  "version": "0.12.3",
   "description": "Express server with file-convention routes, plugins and an optional PostgreSQL layer",
   "type": "module",
   "main": "build/index.js",
@@ -45,9 +45,9 @@
   "dependencies": {
     "compression": "^1.8.2",
     "cors": "^2.8.6",
-    "dotenv": "^18.0.8",
+    "dotenv": "^18.0.9",
     "express": "^5.3.0",
-    "express-rate-limit": "^8.7.1",
+    "express-rate-limit": "^8.7.2",
     "glob": "^13.0.6",
     "helmet": "^8.3.0",
     "jiti": "^2.7.0",
@@ -56,7 +56,7 @@
   "peerDependencies": {
     "@prisma/adapter-pg": "^7.10.1",
     "@prisma/client": "^7.10.1",
-    "better-auth": "^1.7.12",
+    "better-auth": "^1.7.15",
     "pg": "^8.23.1"
   },
   "peerDependenciesMeta": {
@@ -80,12 +80,12 @@
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.6",
     "@types/morgan": "^1.9.10",
-    "@types/node": "^26.6.5",
+    "@types/node": "^26.6.6",
     "@types/pg": "^8.20.0",
-    "better-auth": "^1.7.12",
+    "better-auth": "^1.7.15",
     "pg": "^8.23.1",
     "prisma": "^7.10.1",
-    "tsdown": "^0.23.1",
+    "tsdown": "^0.23.4",
     "tsx": "^4.23.15",
     "typescript": "^7.0.2"
   }