@spfn/core 0.2.0-beta.69 → 0.2.0-beta.71

package/README.md

@@ -7,6 +7,12 @@ feature — an entity, a repository, a route, a router registration — so that
 nor your coding agent has to invent one per feature. Everything else in SPFN
 (`@spfn/auth`, `@spfn/mcp`, `@spfn/storage`, …) plugs into it.
 
+Fixing the shape is an answer to [architecture drift](https://superfunction.xyz/architecture-drift)
+— a codebase acquiring several structures because each feature was arranged freshly. The
+usual answers detect it after the fact; this one leaves nothing to decide. It removes
+drift that comes from structural choice, and nothing else: two services can still
+implement the same rule differently inside a correct shape.
+
 📖 **[superfunction.xyz](https://superfunction.xyz)** — docs and the full-stack tutorial ·
 [repository README](https://github.com/fxylabs/spfn) for the whole framework.
 
@@ -40,7 +46,7 @@ pnpm add @spfn/core@beta drizzle-orm@1.0.0-rc.4 postgres pg
 # optional peer: next ^16.2.11   (only for the Next.js bridge)
 ```
 
-Node `>=18.18.0`. ESM only.
+Node `>=20.0.0`. ESM only.
 
 > **Declare Drizzle and the Postgres drivers in your own app, not just in SPFN.**
 > `@spfn/core` takes `drizzle-orm` as a peer dependency, and Drizzle changes how it
@@ -373,7 +379,7 @@ There is no `.` entry in `exports` — by design. Subpaths keep server-only code
 client bundles, which a single barrel file cannot do.
 
 **Which Node version?**
-`>=18.18.0`. The package is ESM only.
+`>=20.0.0`. The package is ESM only.
 
 **Where do my business rules go?**
 In services and repositories, not in route handlers. A handler validates, calls, and

package/dist/{boss-gXhgctn6.d.ts → boss-D16fO2oG.d.ts}

@@ -281,4 +281,4 @@ declare function isBossRunning(): boolean;
  */
 declare function shouldClearOnStart(): boolean;
 
-export { type BossOptions as B, type CompensateHandler as C, type InferJobInput as I, type JobRouter as J, type JobOptions as a, type JobHandler as b, type JobDef as c, type JobRouterEntry as d, type JobSendOptions as e, type InferJobOutput as f, getBoss as g, isBossRunning as h, initBoss as i, shouldClearOnStart as j, type BossConfig as k, stopBoss as s };
+export { type BossConfig as B, type CompensateHandler as C, type InferJobInput as I, type JobOptions as J, type JobHandler as a, type JobDef as b, type JobRouter as c, type JobRouterEntry as d, type BossOptions as e, type InferJobOutput as f, type JobSendOptions as g, getBoss as h, initBoss as i, isBossRunning as j, stopBoss as k, shouldClearOnStart as s };

package/dist/contract/index.d.ts

@@ -1,6 +1,6 @@
-import { f as RouteAuthProfile, a as Router } from '../router-HDVa6gfc.js';
+import { R as RouteAuthProfile, a as Router } from '../router-BgZUDHp5.js';
 import { HttpMethod } from '../route/types.js';
-import '../define-middleware-B9bFuXVU.js';
+import '../define-middleware-DfDP39Nq.js';
 import 'hono';
 import '@sinclair/typebox';
 import 'hono/utils/http-status';

package/dist/{define-middleware-B9bFuXVU.d.ts → define-middleware-DfDP39Nq.d.ts}

@@ -164,4 +164,4 @@ declare function defineMiddlewareFactory<TName extends string, TArgs extends unk
  */
 type ExtractMiddlewareNames<T extends readonly NamedMiddleware<string>[]> = T[number]['_name'];
 
-export { type ExtractMiddlewareNames as E, type NamedMiddlewareFactory as N, defineMiddlewareFactory as a, type NamedMiddleware as b, defineMiddleware as d };
+export { type ExtractMiddlewareNames as E, type NamedMiddlewareFactory as N, type NamedMiddleware as a, defineMiddlewareFactory as b, defineMiddleware as d };

package/dist/event/index.d.ts

@@ -1,8 +1,8 @@
 import { TSchema, Static } from '@sinclair/typebox';
-import { a as EventDef } from '../token-manager-vZeqBbtA.js';
-export { e as EventHandler, E as EventRouterDef, I as InferEventNames, f as InferEventPayload, c as InferEventPayloads, b as InferRouterEventPayload, J as JobQueueSender, P as PubSubCache, d as defineEventRouter } from '../token-manager-vZeqBbtA.js';
+import { E as EventDef } from '../token-manager-BT5EnUAR.js';
+export { a as EventHandler, b as EventRouterDef, I as InferEventNames, c as InferEventPayload, d as InferEventPayloads, e as InferRouterEventPayload, J as JobQueueSender, P as PubSubCache, f as defineEventRouter } from '../token-manager-BT5EnUAR.js';
 export { defineWSRouter } from './ws/index.js';
-import '../types-CF-37KAG.js';
+import '../types-2AbaW4Ie.js';
 import 'hono';
 import 'node:http';
 

package/dist/event/sse/client.d.ts

@@ -1,5 +1,5 @@
-import { E as EventRouterDef, I as InferEventNames } from '../../token-manager-vZeqBbtA.js';
-import { g as SSESubscribeOptions, i as SSEUnsubscribe, h as SSEConnectionState, d as SSEClientConfig } from '../../types-D9uMxeQS.js';
+import { b as EventRouterDef, I as InferEventNames } from '../../token-manager-BT5EnUAR.js';
+import { S as SSEClientConfig, a as SSESubscribeOptions, b as SSEUnsubscribe, c as SSEConnectionState } from '../../types-ZQODsBft.js';
 import '@sinclair/typebox';
 import 'hono';
 

package/dist/event/sse/index.d.ts

@@ -1,8 +1,8 @@
 import { Context } from 'hono';
-import { E as EventRouterDef, S as SSETokenManager } from '../../token-manager-vZeqBbtA.js';
-export { C as CacheTokenStore, g as SSEToken, i as SSETokenManagerConfig, h as SSETokenStore } from '../../token-manager-vZeqBbtA.js';
-import { S as SSEHandlerConfig } from '../../types-D9uMxeQS.js';
-export { a as SSEAuthConfig, d as SSEClientConfig, h as SSEConnectionState, e as SSEEventHandler, f as SSEEventHandlers, c as SSEHandlerAuthConfig, b as SSEMessage, g as SSESubscribeOptions, i as SSEUnsubscribe } from '../../types-D9uMxeQS.js';
+import { b as EventRouterDef, S as SSETokenManager } from '../../token-manager-BT5EnUAR.js';
+export { C as CacheTokenStore, g as SSEToken, h as SSETokenManagerConfig, i as SSETokenStore } from '../../token-manager-BT5EnUAR.js';
+import { d as SSEHandlerConfig } from '../../types-ZQODsBft.js';
+export { e as SSEAuthConfig, S as SSEClientConfig, c as SSEConnectionState, f as SSEEventHandler, g as SSEEventHandlers, h as SSEHandlerAuthConfig, i as SSEMessage, a as SSESubscribeOptions, b as SSEUnsubscribe } from '../../types-ZQODsBft.js';
 import '@sinclair/typebox';
 
 /**

package/dist/event/ws/client.d.ts

@@ -1,6 +1,6 @@
-import { W as WSRouterDef, k as WSSubscribeOptions, l as WSUnsubscribe, i as WSConnectionState, h as WSClientConfig } from '../../types-CF-37KAG.js';
+import { W as WSRouterDef, a as WSSubscribeOptions, b as WSUnsubscribe, c as WSConnectionState, d as WSClientConfig } from '../../types-2AbaW4Ie.js';
 import 'hono';
-import '../../token-manager-vZeqBbtA.js';
+import '../../token-manager-BT5EnUAR.js';
 import '@sinclair/typebox';
 
 /**

package/dist/event/ws/index.d.ts

@@ -1,6 +1,6 @@
-import { a as EventDef, S as SSETokenManager } from '../../token-manager-vZeqBbtA.js';
-import { b as WSMessageHandlers, W as WSRouterDef, a as WSHandlerConfig } from '../../types-CF-37KAG.js';
-export { c as WSAuthConfig, h as WSClientConfig, i as WSConnectionState, j as WSEventHandlers, d as WSHandlerAuthConfig, e as WSMessageContext, f as WSMessageHandlerFn, g as WSRawConnection, k as WSSubscribeOptions, l as WSUnsubscribe } from '../../types-CF-37KAG.js';
+import { E as EventDef, S as SSETokenManager } from '../../token-manager-BT5EnUAR.js';
+import { e as WSMessageHandlers, W as WSRouterDef, f as WSHandlerConfig } from '../../types-2AbaW4Ie.js';
+export { g as WSAuthConfig, d as WSClientConfig, c as WSConnectionState, h as WSEventHandlers, i as WSHandlerAuthConfig, j as WSMessageContext, k as WSMessageHandlerFn, l as WSRawConnection, a as WSSubscribeOptions, b as WSUnsubscribe } from '../../types-2AbaW4Ie.js';
 import { Server } from 'node:http';
 import '@sinclair/typebox';
 import 'hono';

package/dist/job/index.d.ts

@@ -1,5 +1,5 @@
-import { a as JobOptions, C as CompensateHandler, b as JobHandler, c as JobDef, d as JobRouterEntry, J as JobRouter } from '../boss-gXhgctn6.js';
-export { k as BossConfig, B as BossOptions, I as InferJobInput, f as InferJobOutput, e as JobSendOptions, g as getBoss, i as initBoss, h as isBossRunning, j as shouldClearOnStart, s as stopBoss } from '../boss-gXhgctn6.js';
+import { J as JobOptions, C as CompensateHandler, a as JobHandler, b as JobDef, c as JobRouter, d as JobRouterEntry } from '../boss-D16fO2oG.js';
+export { B as BossConfig, e as BossOptions, I as InferJobInput, f as InferJobOutput, g as JobSendOptions, h as getBoss, i as initBoss, j as isBossRunning, s as shouldClearOnStart, k as stopBoss } from '../boss-D16fO2oG.js';
 import * as _sinclair_typebox from '@sinclair/typebox';
 import { Static } from '@sinclair/typebox';
 import { EventDef, InferEventPayload } from '@spfn/core/event';

package/dist/middleware/index.d.ts

@@ -1,5 +1,5 @@
 import { Context, Next, MiddlewareHandler } from 'hono';
-import { N as NamedMiddlewareFactory, b as NamedMiddleware } from '../define-middleware-B9bFuXVU.js';
+import { N as NamedMiddlewareFactory, a as NamedMiddleware } from '../define-middleware-DfDP39Nq.js';
 import { Redis, Cluster } from 'ioredis';
 
 /**

package/dist/nextjs/index.d.ts

@@ -1,6 +1,6 @@
 import { Router, RouteDef } from '@spfn/core/route';
-import { R as RequestInterceptor, a as ResponseInterceptor, I as InferRouteInput, b as InferRouteOutput, A as ApiConfig } from '../types-7Mhoxnnt.js';
-export { C as CallOptions, e as CookieOptions, c as RouterInput, d as RouterOutput, f as SetCookie, S as StructuredInput } from '../types-7Mhoxnnt.js';
+import { R as RequestInterceptor, a as ResponseInterceptor, I as InferRouteInput, b as InferRouteOutput, A as ApiConfig } from '../types-9oszaJqp.js';
+export { C as CallOptions, c as CookieOptions, d as RouterInput, e as RouterOutput, S as SetCookie, f as StructuredInput } from '../types-9oszaJqp.js';
 import '@sinclair/typebox';
 import '@spfn/core/errors';
 

package/dist/nextjs/server.d.ts

@@ -1,7 +1,7 @@
 import { NextRequest, NextResponse } from 'next/server';
 import { HttpMethod } from '@spfn/core/route';
 import { InterceptorRule as InterceptorRule$1 } from '@spfn/core/nextjs/server';
-import { f as SetCookie } from '../types-7Mhoxnnt.js';
+import { S as SetCookie } from '../types-9oszaJqp.js';
 import '@sinclair/typebox';
 import '@spfn/core/errors';
 

package/dist/route/index.d.ts

@@ -1,8 +1,8 @@
-import { R as RouteDef, a as Router } from '../router-HDVa6gfc.js';
-export { M as MergedInput, P as PaginatedResult, f as RouteAuthProfile, c as RouteBuilderContext, e as RouteContract, d as RouteHandlerFn, b as RouteInput, g as defineRouter, r as route } from '../router-HDVa6gfc.js';
+import { b as RouteDef, a as Router } from '../router-BgZUDHp5.js';
+export { M as MergedInput, P as PaginatedResult, R as RouteAuthProfile, c as RouteBuilderContext, d as RouteContract, e as RouteHandlerFn, f as RouteInput, g as defineRouter, r as route } from '../router-BgZUDHp5.js';
 import { Hono, MiddlewareHandler } from 'hono';
 import { HttpMethod } from './types.js';
-export { E as ExtractMiddlewareNames, b as NamedMiddleware, N as NamedMiddlewareFactory, d as defineMiddleware, a as defineMiddlewareFactory } from '../define-middleware-B9bFuXVU.js';
+export { E as ExtractMiddlewareNames, a as NamedMiddleware, N as NamedMiddlewareFactory, d as defineMiddleware, b as defineMiddlewareFactory } from '../define-middleware-DfDP39Nq.js';
 import * as _sinclair_typebox from '@sinclair/typebox';
 import { TSchema, Kind } from '@sinclair/typebox';
 import 'hono/utils/http-status';

package/dist/route/index.js

@@ -638,7 +638,7 @@ function registerRoutes(app, router, namedMiddlewares, collectedRoutes) {
   return routes;
 }
 function registerRoute(app, name, routeDef, namedMiddlewares) {
-  const { method, path, input, middlewares = [], skipMiddlewares, handler } = routeDef;
+  const { method, path, input, interceptor, middlewares = [], skipMiddlewares, handler } = routeDef;
   if (!method || !path) {
     logger.warn(`Route "${name}" is missing method or path - skipping`, {
       method,
@@ -647,7 +647,7 @@ function registerRoute(app, name, routeDef, namedMiddlewares) {
     return null;
   }
   const wrappedHandler = async (c) => {
-    const { context, responseMeta } = await createRouteBuilderContext(c, input || {});
+    const { context, responseMeta } = await createRouteBuilderContext(c, input || {}, interceptor);
     const result = await handler(context);
     if (result instanceof Response) {
       return result;
@@ -683,6 +683,8 @@ function registerRoute(app, name, routeDef, namedMiddlewares) {
           logger.debug(`\u23ED\uFE0F  Skipping middleware '${middleware.name}' for route: ${method} ${path}`, { name });
         } else if (autoSkips.has(middleware.name)) {
           logger.debug(`\u23ED\uFE0F  Auto-skipping middleware '${middleware.name}' for route: ${method} ${path}`, { name });
+        } else if (middleware.name && registeredNames.has(middleware.name)) {
+          logger.debug(`\u{1F504} Skipping duplicate middleware '${middleware.name}' for route: ${method} ${path}`, { name });
         } else {
           allMiddlewares.push(middleware.handler);
           registeredNames.add(middleware.name);
@@ -714,21 +716,27 @@ function registerRoute(app, name, routeDef, namedMiddlewares) {
   logger.debug(`Registered route: ${method} ${path}`, { name });
   return { method, path, name };
 }
-async function createRouteBuilderContext(c, input) {
+function methodCarriesBody(method) {
+  return method !== "GET" && method !== "HEAD";
+}
+async function createRouteBuilderContext(c, input, interceptor) {
   const params = validateField(input.params, c.req.param(), "path parameters");
   const query = validateField(input.query, extractQueryParams(c), "query parameters");
   const headers = validateField(input.headers, extractHeaders(c), "headers");
   const cookies = validateField(input.cookies, extractCookies(c), "cookies");
   let body = {};
   let formData = {};
-  if (input.body || input.formData) {
+  const injected = methodCarriesBody(c.req.method) ? interceptor : void 0;
+  const expectsBody = input.body ?? injected?.body;
+  const expectsFormData = input.formData ?? injected?.formData;
+  if (expectsBody || expectsFormData) {
     const contentType = c.req.header("content-type") || "";
-    if (contentType.includes("multipart/form-data") && input.formData) {
+    if (contentType.includes("multipart/form-data") && expectsFormData) {
       const rawFormData = await parseFormData(c);
-      formData = validateFormData(input.formData, rawFormData, "form data");
-    } else if (input.body) {
+      formData = input.formData ? validateFormData(input.formData, rawFormData, "form data") : rawFormData;
+    } else if (expectsBody) {
       const rawBody = await parseJsonBody(c);
-      body = validateField(input.body, rawBody, "request body");
+      body = input.body ? validateField(input.body, rawBody, "request body") : rawBody;
     }
   }
   let cachedData = null;