nextrush 3.0.7 → 4.0.0-beta.1

package/dist/index.js

@@ -1,6 +1,11 @@
+import {
+  __name
+} from "./chunk-7QVYU63E.js";
+
 // src/index.ts
-import { Application, compose, createApp } from "@nextrush/core";
-import { Router, createRouter } from "@nextrush/router";
+import { Application, compose, createApp as createBareApp } from "@nextrush/core";
+import { createRouter as createDefaultRouter } from "@nextrush/router";
+import { Router, createRouter, endpoint } from "@nextrush/router";
 import { createHandler, listen, serve } from "@nextrush/adapter-node";
 import {
   BadGatewayError,
@@ -18,19 +23,30 @@ import {
   TooManyRequestsError,
   UnauthorizedError,
   UnprocessableEntityError,
-  catchAsync,
   createError,
   errorHandler,
   isHttpError,
-  notFoundHandler
+  notFoundHandler,
+  ERROR_CODES,
+  codeForStatus,
+  ValidationError
 } from "@nextrush/errors";
 import { ContentType, HttpStatus } from "@nextrush/types";
+function createApp(options) {
+  const router = options?.router ?? createDefaultRouter();
+  return createBareApp({
+    ...options,
+    router
+  });
+}
+__name(createApp, "createApp");
 export {
   Application,
   BadGatewayError,
   BadRequestError,
   ConflictError,
   ContentType,
+  ERROR_CODES,
   ForbiddenError,
   GatewayTimeoutError,
   HttpError,
@@ -45,12 +61,14 @@ export {
   TooManyRequestsError,
   UnauthorizedError,
   UnprocessableEntityError,
-  catchAsync,
+  ValidationError,
+  codeForStatus,
   compose,
   createApp,
   createError,
   createHandler,
   createRouter,
+  endpoint,
   errorHandler,
   isHttpError,
   listen,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * NextRush - Minimal, Modular, Blazing Fast Node.js Framework\n *\n * This meta package provides the **functional** API for building Node.js APIs:\n * - Application creation (createApp)\n * - Routing (createRouter)\n * - Server start (listen)\n * - HTTP errors\n * - Essential types\n *\n * For the class-based paradigm (DI, decorators, controllers),\n * import from `nextrush/class` instead.\n *\n * For middleware, install separately:\n * - @nextrush/cors\n * - @nextrush/helmet\n * - @nextrush/body-parser\n * - @nextrush/rate-limit\n * - @nextrush/logger\n *\n * For other runtimes, install the appropriate adapter:\n * - @nextrush/adapter-bun\n * - @nextrush/adapter-deno\n * - @nextrush/adapter-edge\n *\n * @packageDocumentation\n * @module nextrush\n *\n * @example Quick Start (Functional)\n * ```typescript\n * import { createApp, createRouter, listen } from 'nextrush';\n *\n * const app = createApp();\n * const router = createRouter();\n *\n * router.get('/', (ctx) => {\n *   ctx.json({ message: 'Hello NextRush!' });\n * });\n *\n * app.route('/', router);\n * listen(app, 3000);\n * ```\n *\n * @example With Middleware (install separately)\n * ```typescript\n * import { createApp, listen } from 'nextrush';\n * import { cors } from '@nextrush/cors';\n * import { json } from '@nextrush/body-parser';\n *\n * const app = createApp();\n * app.use(cors());\n * app.use(json());\n *\n * listen(app, 3000);\n * ```\n *\n * @example Class-Based (import from nextrush/class)\n * ```typescript\n * import { createApp, listen } from 'nextrush';\n * import { Controller, Get, Service, controllersPlugin } from 'nextrush/class';\n *\n * @Service()\n * class UserService {\n *   findAll() { return [{ id: 1, name: 'Alice' }]; }\n * }\n *\n * @Controller('/users')\n * class UserController {\n *   constructor(private users: UserService) {}\n *\n *   @Get()\n *   findAll() { return this.users.findAll(); }\n * }\n *\n * const app = createApp();\n * app.plugin(controllersPlugin({ root: './src' }));\n * listen(app, 3000);\n * ```\n */\n\n// ============================================\n// CORE: Application & Middleware Composition\n// ============================================\nexport { Application, compose, createApp } from '@nextrush/core';\nexport type { ApplicationOptions, ComposedMiddleware } from '@nextrush/core';\n\n// ============================================\n// ROUTER: Radix Tree Routing\n// ============================================\nexport { Router, createRouter } from '@nextrush/router';\nexport type { RouterOptions } from '@nextrush/router';\n\n// ============================================\n// ADAPTER: Node.js HTTP (Default Runtime)\n// ============================================\nexport { createHandler, listen, serve } from '@nextrush/adapter-node';\nexport type { ServeOptions, ServerInstance } from '@nextrush/adapter-node';\n\n// ============================================\n// ERRORS: HTTP Error Classes & Factory\n// ============================================\nexport {\n    BadGatewayError,\n    // 4xx Client Errors\n    BadRequestError, ConflictError, ForbiddenError,\n    GatewayTimeoutError,\n    // Base\n    HttpError,\n    // 5xx Server Errors\n    InternalServerError, MethodNotAllowedError,\n    NextRushError,\n    NotFoundError, NotImplementedError,\n    ServiceUnavailableError,\n    TooManyRequestsError,\n    UnauthorizedError,\n    UnprocessableEntityError, catchAsync,\n    // Factory functions\n    createError,\n    // Error handling middleware\n    errorHandler, isHttpError, notFoundHandler\n} from '@nextrush/errors';\n\nexport type { ErrorHandlerOptions, HttpErrorOptions } from '@nextrush/errors';\n\n// ============================================\n// TYPES: Essential TypeScript Types\n// ============================================\nexport type {\n    // Core types\n    Context,\n    // HTTP types\n    HttpMethod,\n    HttpStatusCode,\n    Middleware,\n    Next,\n    Plugin,\n    RouteHandler,\n    // Runtime\n    Runtime\n} from '@nextrush/types';\n\n// HTTP constants\nexport { ContentType, HttpStatus } from '@nextrush/types';\n\n// NOTE: VERSION is not exported from the core package to maintain\n// Edge runtime compatibility (no node:fs). Use @nextrush/dev or\n// check package.json directly if you need the version.\n"],"mappings":";AAmFA,SAASA,aAAaC,SAASC,iBAAiB;AAMhD,SAASC,QAAQC,oBAAoB;AAMrC,SAASC,eAAeC,QAAQC,aAAa;AAM7C;EACIC;EAEAC;EAAiBC;EAAeC;EAChCC;EAEAC;EAEAC;EAAqBC;EACrBC;EACAC;EAAeC;EACfC;EACAC;EACAC;EACAC;EAA0BC;EAE1BC;EAEAC;EAAcC;EAAaC;OACxB;AAsBP,SAASC,aAAaC,kBAAkB;","names":["Application","compose","createApp","Router","createRouter","createHandler","listen","serve","BadGatewayError","BadRequestError","ConflictError","ForbiddenError","GatewayTimeoutError","HttpError","InternalServerError","MethodNotAllowedError","NextRushError","NotFoundError","NotImplementedError","ServiceUnavailableError","TooManyRequestsError","UnauthorizedError","UnprocessableEntityError","catchAsync","createError","errorHandler","isHttpError","notFoundHandler","ContentType","HttpStatus"]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * NextRush - Minimal, Modular, Blazing Fast Node.js Framework\n *\n * This meta package provides the **functional** API for building Node.js APIs:\n * - Application creation (createApp)\n * - Routing (createRouter)\n * - Server start (listen)\n * - HTTP errors\n * - Essential types\n *\n * For the class-based paradigm (DI, decorators, controllers),\n * import from `nextrush/class` instead.\n *\n * For middleware, install separately:\n * - @nextrush/cors\n * - @nextrush/helmet\n * - @nextrush/body-parser\n * - @nextrush/rate-limit\n * - @nextrush/logger\n *\n * For other runtimes, install the appropriate adapter:\n * - @nextrush/adapter-bun\n * - @nextrush/adapter-deno\n * - @nextrush/adapter-edge\n *\n * @packageDocumentation\n * @module nextrush\n *\n * @example Quick Start (Functional)\n * ```typescript\n * import { createApp, createRouter, listen } from 'nextrush';\n *\n * const app = createApp();\n * const router = createRouter();\n *\n * router.get('/', (ctx) => {\n *   ctx.json({ message: 'Hello NextRush!' });\n * });\n *\n * app.route('/', router);\n * listen(app, 8080);\n * ```\n *\n * @example With Middleware (install separately)\n * ```typescript\n * import { createApp, listen } from 'nextrush';\n * import { cors } from '@nextrush/cors';\n * import { json } from '@nextrush/body-parser';\n *\n * const app = createApp();\n * app.use(cors());\n * app.use(json());\n *\n * listen(app, 8080);\n * ```\n *\n * @example Class-Based (import from nextrush/class)\n * ```typescript\n * import { createApp, listen } from 'nextrush';\n * import { Controller, Get, Service, registerControllers } from 'nextrush/class';\n *\n * @Service()\n * class UserService {\n *   findAll() { return [{ id: 1, name: 'Alice' }]; }\n * }\n *\n * @Controller('/users')\n * class UserController {\n *   constructor(private users: UserService) {}\n *\n *   @Get()\n *   findAll() { return this.users.findAll(); }\n * }\n *\n * const app = createApp();\n * await registerControllers(app, { root: './src' });\n * await listen(app, 8080);\n * ```\n */\n\n// ============================================\n// CORE: Application & Middleware Composition\n// ============================================\nimport {\n  Application,\n  compose,\n  createApp as createBareApp,\n  type ApplicationOptions,\n} from '@nextrush/core';\nimport { createRouter as createDefaultRouter } from '@nextrush/router';\n\n/**\n * Create an application with a default router wired in, so `app.get`/`app.post`\n * work out of the box.\n *\n * The functional `nextrush` entry is deliberately DI-free: it does NOT import or\n * attach a `@nextrush/di` container. Doing so would transitively load\n * `reflect-metadata` + tsyringe, making functional users pay a cost that belongs\n * only to the class-based paradigm (see NEW-1 in\n * docs/audits/class-based-master-audit.md).\n *\n * The container is bring-your-own: pass `options.container` to attach one. Class\n * users are unaffected — they import from `nextrush/class`, and\n * `registerControllers` supplies the global `@nextrush/di` container fallback\n * itself (`options.container ?? app.container ?? globalContainer`). See\n * docs/RFC/class-runtime/006-di-container-ownership.md.\n *\n * Import `createApp` from `@nextrush/core` for a minimal engine where the router\n * is also bring-your-own.\n */\nexport function createApp(options?: ApplicationOptions): Application {\n  const router = options?.router ?? createDefaultRouter();\n  return createBareApp({ ...options, router });\n}\n\nexport { Application, compose };\nexport type { ApplicationOptions, ComposedMiddleware } from '@nextrush/core';\n\n// ============================================\n// ROUTER: Segment Trie Routing + Route Metadata\n// ============================================\nexport { Router, createRouter, endpoint } from '@nextrush/router';\nexport type { RouterOptions } from '@nextrush/router';\n\n// ============================================\n// ADAPTER: Node.js HTTP (Default Runtime)\n// ============================================\nexport { createHandler, listen, serve } from '@nextrush/adapter-node';\nexport type { ServeOptions, ServerInstance } from '@nextrush/adapter-node';\n\n// ============================================\n// ERRORS: HTTP Error Classes & Factory\n// ============================================\nexport {\n    BadGatewayError,\n    // 4xx Client Errors\n    BadRequestError, ConflictError, ForbiddenError,\n    GatewayTimeoutError,\n    // Base\n    HttpError,\n    // 5xx Server Errors\n    InternalServerError, MethodNotAllowedError,\n    NextRushError,\n    NotFoundError, NotImplementedError,\n    ServiceUnavailableError,\n    TooManyRequestsError,\n    UnauthorizedError,\n    UnprocessableEntityError,\n    // Factory functions\n    createError,\n    // Error handling middleware\n    errorHandler, isHttpError, notFoundHandler,\n    // Central error-code registry + validation (audit N-4)\n    ERROR_CODES,\n    codeForStatus,\n    ValidationError\n} from '@nextrush/errors';\n\nexport type { ErrorHandlerOptions, HttpErrorOptions, ValidationIssue } from '@nextrush/errors';\n\n// ============================================\n// TYPES: Essential TypeScript Types\n// ============================================\nexport type {\n    // Core types\n    Context,\n    // Extension model\n    Extension,\n    ExtensionContext,\n    // HTTP types\n    HttpMethod,\n    HttpStatusCode,\n    Middleware,\n    Next,\n    RouteHandler,\n    // Route metadata (author with endpoint(); read by @nextrush/openapi)\n    RouteDefinition,\n    RouteMetadata,\n    // Runtime\n    Runtime\n} from '@nextrush/types';\n\n// HTTP constants\nexport { ContentType, HttpStatus } from '@nextrush/types';\n\n// NOTE: VERSION is not exported from the core package to maintain\n// Edge runtime compatibility (no node:fs). Use @nextrush/dev or\n// check package.json directly if you need the version.\n"],"mappings":";;;;;AAmFA,SACEA,aACAC,SACAC,aAAaC,qBAER;AACP,SAASC,gBAAgBC,2BAA2B;AAgCpD,SAASC,QAAQF,cAAcG,gBAAgB;AAM/C,SAASC,eAAeC,QAAQC,aAAa;AAM7C;EACIC;EAEAC;EAAiBC;EAAeC;EAChCC;EAEAC;EAEAC;EAAqBC;EACrBC;EACAC;EAAeC;EACfC;EACAC;EACAC;EACAC;EAEAC;EAEAC;EAAcC;EAAaC;EAE3BC;EACAC;EACAC;OACG;AA2BP,SAASC,aAAaC,kBAAkB;AAzEjC,SAASC,UAAUC,SAA4B;AACpD,QAAMC,SAASD,SAASC,UAAUC,oBAAAA;AAClC,SAAOC,cAAc;IAAE,GAAGH;IAASC;EAAO,CAAA;AAC5C;AAHgBF;","names":["Application","compose","createApp","createBareApp","createRouter","createDefaultRouter","Router","endpoint","createHandler","listen","serve","BadGatewayError","BadRequestError","ConflictError","ForbiddenError","GatewayTimeoutError","HttpError","InternalServerError","MethodNotAllowedError","NextRushError","NotFoundError","NotImplementedError","ServiceUnavailableError","TooManyRequestsError","UnauthorizedError","UnprocessableEntityError","createError","errorHandler","isHttpError","notFoundHandler","ERROR_CODES","codeForStatus","ValidationError","ContentType","HttpStatus","createApp","options","router","createDefaultRouter","createBareApp"]}

package/dist/nextjs.d.ts

@@ -0,0 +1 @@
+export { AppSource, NextHandlerOptions, NextRouteContext, NextRouteHandler, NextRouteHandlers, NextRouteParams, handle } from '@nextrush/adapter-nextjs';

package/dist/nextjs.js

@@ -0,0 +1,8 @@
+import "./chunk-7QVYU63E.js";
+
+// src/nextjs.ts
+import { handle } from "@nextrush/adapter-nextjs";
+export {
+  handle
+};
+//# sourceMappingURL=nextjs.js.map

package/dist/nextjs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/nextjs.ts"],"sourcesContent":["/**\n * NextRush Next.js Adapter — mount a NextRush app in a Next.js App Router\n * route handler\n *\n * Import from `nextrush/nextjs` when building an API route inside a Next.js\n * (App Router) project. This entry is a plain re-export — unlike\n * `nextrush/class`, `@nextrush/adapter-nextjs` never imports `next` at module\n * scope (its one `next/server` import, resolving `after()`, is deferred to\n * the first request), so no dynamic-import peer guard is needed here.\n *\n * @packageDocumentation\n * @module nextrush/nextjs\n *\n * @example\n * ```typescript\n * // app/api/[[...route]]/route.ts\n * import { createApp, createRouter } from 'nextrush';\n * import { handle } from 'nextrush/nextjs';\n *\n * const app = createApp();\n * const api = createRouter();\n * api.get('/hello', (ctx) => ctx.json({ message: 'Hello Next.js!' }));\n * app.route('/api', api);\n *\n * export const { GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS } = handle(app);\n * ```\n */\n\nexport { handle } from '@nextrush/adapter-nextjs';\nexport type {\n  AppSource,\n  NextHandlerOptions,\n  NextRouteContext,\n  NextRouteHandler,\n  NextRouteHandlers,\n  NextRouteParams,\n} from '@nextrush/adapter-nextjs';\n"],"mappings":";;;AA4BA,SAASA,cAAc;","names":["handle"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nextrush",
-  "version": "3.0.7",
+  "version": "4.0.0-beta.1",
   "description": "Minimal, modular, blazing fast Node.js framework",
   "type": "module",
   "main": "./dist/index.js",
@@ -14,13 +14,20 @@
     "./class": {
       "types": "./dist/class.d.ts",
       "import": "./dist/class.js"
+    },
+    "./nextjs": {
+      "types": "./dist/nextjs.d.ts",
+      "import": "./dist/nextjs.js"
     }
   },
   "files": [
     "dist",
-    "scripts",
+    "bin",
     "README.md"
   ],
+  "bin": {
+    "nextrush": "./bin/nextrush.js"
+  },
   "keywords": [
     "framework",
     "web",
@@ -59,27 +66,46 @@
     "./dist/class.js"
   ],
   "dependencies": {
+    "@nextrush/adapter-node": "4.0.0-beta.1",
+    "@nextrush/core": "4.0.0-beta.1",
+    "@nextrush/errors": "4.0.0-beta.1",
+    "@nextrush/router": "4.0.0-beta.1",
+    "@nextrush/types": "4.0.0-beta.1"
+  },
+  "peerDependencies": {
     "reflect-metadata": "^0.2.2",
-    "@nextrush/adapter-node": "3.0.7",
-    "@nextrush/controllers": "3.0.7",
-    "@nextrush/core": "3.0.7",
-    "@nextrush/decorators": "3.0.7",
-    "@nextrush/di": "3.0.7",
-    "@nextrush/errors": "3.0.7",
-    "@nextrush/router": "3.0.7",
-    "@nextrush/types": "3.0.7"
+    "@nextrush/adapter-nextjs": "1.0.0-beta.0",
+    "@nextrush/class": "1.0.0-beta.1",
+    "@nextrush/di": "4.0.0-beta.1"
+  },
+  "peerDependenciesMeta": {
+    "@nextrush/adapter-nextjs": {
+      "optional": true
+    },
+    "@nextrush/class": {
+      "optional": true
+    },
+    "@nextrush/di": {
+      "optional": true
+    },
+    "reflect-metadata": {
+      "optional": true
+    }
   },
   "devDependencies": {
+    "reflect-metadata": "^0.2.2",
     "tsup": "^8.5.1",
-    "typescript": "^6.0.2",
-    "vitest": "^4.1.4",
-    "@nextrush/body-parser": "3.0.5",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10",
+    "@nextrush/adapter-nextjs": "1.0.0-beta.0",
+    "@nextrush/class": "1.0.0-beta.1",
+    "@nextrush/body-parser": "4.0.0-beta.0",
+    "@nextrush/cors": "4.0.0-beta.0",
     "@nextrush/compression": "3.0.5",
-    "@nextrush/cors": "3.0.5",
-    "@nextrush/helmet": "3.0.5"
+    "@nextrush/di": "4.0.0-beta.1",
+    "@nextrush/helmet": "4.0.0-beta.0"
   },
   "scripts": {
-    "postinstall": "node scripts/postinstall.js",
     "build": "tsup",
     "clean": "rm -rf dist",
     "typecheck": "tsc --noEmit",

package/scripts/postinstall.d.ts

@@ -1,5 +0,0 @@
-export function shouldSkip(): boolean;
-export function isDevInstalled(): boolean;
-export function detectPackageManager(): string;
-export function getInstallCommand(pm: string): string[];
-export function installDevPackage(pm: string): void;

package/scripts/postinstall.js

@@ -1,84 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * nextrush postinstall script
- *
- * Automatically installs @nextrush/dev (dev server & build CLI) when
- * a user installs the `nextrush` meta package. This ensures `nextrush dev`
- * and `nextrush build` commands work out of the box.
- *
- * Skips installation when:
- * - Running in CI (process.env.CI is set)
- * - NEXTRUSH_SKIP_POSTINSTALL=1 is set
- * - @nextrush/dev is already resolvable
- */
-
-import { createRequire } from 'node:module';
-import { execSync } from 'node:child_process';
-
-export function shouldSkip() {
-  if (process.env.CI) return true;
-  if (process.env.NEXTRUSH_SKIP_POSTINSTALL === '1') return true;
-  return false;
-}
-
-export function isDevInstalled() {
-  const require = createRequire(import.meta.url);
-  try {
-    require.resolve('@nextrush/dev');
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-export function detectPackageManager() {
-  const userAgent = process.env.npm_config_user_agent || '';
-
-  if (userAgent.includes('pnpm')) return 'pnpm';
-  if (userAgent.includes('yarn')) return 'yarn';
-  if (userAgent.includes('bun')) return 'bun';
-  return 'npm';
-}
-
-export function getInstallCommand(packageManager) {
-  const cmds = {
-    pnpm: 'pnpm add -D @nextrush/dev@latest',
-    yarn: 'yarn add -D @nextrush/dev@latest',
-    bun: 'bun add -D @nextrush/dev@latest',
-    npm: 'npm install -D @nextrush/dev@latest',
-  };
-  return cmds[packageManager];
-}
-
-export function installDevPackage(packageManager) {
-  const cmd = getInstallCommand(packageManager);
-  console.log('\n[nextrush] Installing @nextrush/dev (dev server & build CLI)...');
-  try {
-    execSync(cmd, { stdio: 'inherit' });
-    console.log('[nextrush] @nextrush/dev installed successfully.');
-    return true;
-  } catch {
-    console.warn('[nextrush] Warning: Failed to auto-install @nextrush/dev.');
-    console.warn(`[nextrush] Run manually: ${cmd}`);
-    return false;
-  }
-}
-
-// Only run when executed directly (not imported for testing)
-const isMainModule = process.argv[1] &&
-  (process.argv[1].endsWith('postinstall.js') || process.argv[1].endsWith('postinstall'));
-
-if (isMainModule) {
-  if (shouldSkip()) {
-    process.exit(0);
-  }
-
-  if (isDevInstalled()) {
-    process.exit(0);
-  }
-
-  const pm = detectPackageManager();
-  const success = installDevPackage(pm);
-  process.exit(success ? 0 : 0); // Don't fail the parent install
-}