@bhooai/nexus-core 0.1.0 → 0.1.5

package/package.json

@@ -1,7 +1,9 @@
 {
   "name": "@bhooai/nexus-core",
-  "version": "0.1.0",
-  "publishConfig": { "access": "public" },
+  "version": "0.1.5",
+  "publishConfig": {
+    "access": "public"
+  },
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/config/defaults.ts

@@ -128,7 +128,7 @@ export const defaults: NexusConfig = {
     enabled: true,
   },
   admin: {
-    port: 3001,
+    port: 3300,
     host: 'localhost',
     enabled: true,
   },

package/src/config/schema.ts

@@ -155,6 +155,7 @@ export const nexusConfigSchema = z.object({
   }),
   cluster: z.object({
     enabled: z.boolean(),
+    role: z.enum(['backend', 'files', 'database', 'ai']).optional(),
     failOpenSingleNode: z.boolean(),
     lbHost: z.string().min(1),
     lbPort: z.number().int().min(1).max(65535),
@@ -162,6 +163,11 @@ export const nexusConfigSchema = z.object({
     nodeAgentPort: z.number().int().min(1).max(65535),
     registryFile: z.string().min(1),
     token: z.string(),
+    pathPins: z.array(z.object({
+      prefix: z.string().min(1),
+      nodeId: z.string().min(1),
+      role: z.enum(['backend', 'files', 'database', 'ai']).optional(),
+    })).optional(),
     autoscale: z.object({
       enabled: z.boolean(),
       mode: z.enum(['auto', 'manual']),

package/src/config/types.ts

@@ -295,6 +295,10 @@ export interface ClusterAutoscaleConfig {
 export interface ClusterConfig {
   /** Turn the cluster (registry + LB + autoscaler) on. */
   enabled: boolean;
+  /** When set, this server is a cluster node (slave) of this role — `nexus dev`
+   *  auto-starts a node agent alongside the backend so a master can link it.
+   *  Undefined/empty on the root/central server. */
+  role?: NodeRole;
   /** When false, the LB fails open to a single direct node (no scaling). */
   failOpenSingleNode: boolean;
   /** Bind address of the central cluster's public load balancer. */
@@ -309,6 +313,12 @@ export interface ClusterConfig {
   registryFile: string;
   /** Shared pairing secret minted at node setup; pasted into the central. */
   token: string;
+  /** Path-prefix -> node-id pins: requests whose URL starts with `prefix` are
+   *  always routed to `nodeId` (fail-closed 503 when that node is down, instead
+   *  of round-robining). Used to allocate upload paths to specific file nodes,
+   *  e.g. `/upload/users` -> slave-1. Optional `role` guards that the pinned
+   *  node must be of that role (defensive). */
+  pathPins?: Array<{ prefix: string; nodeId: string; role?: NodeRole }>;
   autoscale: ClusterAutoscaleConfig;
 }
 

package/src/http/Server.ts

@@ -97,7 +97,7 @@ export class NexusServer {
     await next();
 
     if (!ctx.res.writableEnded) {
-      ctx.status(404);
+      ctx.json({ error: { code: 'NOT_FOUND', message: `No route for ${ctx.method} ${ctx.path}` } }, 404);
     }
   }
 

package/src/http/uploads.ts

@@ -41,7 +41,11 @@ export function registerUploadRoutes(router: Router, options: UploadRouteOptions
   const allowedTypes = new Set(options.allowedTypes ?? []);
   const directory = resolve(options.directory);
 
-  router.post(path, async (ctx) => {
+  // The upload handler accepts both the configured path (`/uploads`) and any
+  // sub-path (`/uploads/images`, `/uploads/files`, ...) so the cluster's
+  // upload-path allocation can route different prefixes to different file nodes
+  // while every node still serves the same multipart endpoint.
+  const handler = async (ctx: import('./index.js').RequestContext) => {
     const files = (ctx.state.files as UploadedFile[] | undefined) ?? [];
     if (files.length === 0) throw new ValidationError('At least one file is required');
     if (files.length > maxFiles) throw new ValidationError(`A maximum of ${maxFiles} files may be uploaded`);
@@ -71,7 +75,12 @@ export function registerUploadRoutes(router: Router, options: UploadRouteOptions
       });
     }
     ctx.json({ files: saved }, 201);
-  }, options.middleware ?? []);
+  };
+  const mw = options.middleware ?? [];
+  router.post(path, handler, mw);
+  // Also accept sub-paths (/uploads/images, /uploads/files, ...) so upload-path
+  // allocation in the cluster LB can target specific file nodes by prefix.
+  router.post(`${path}/*`, handler, mw);
 }
 
 function safeExtension(filename: string): string {