@capixjs/transport-rest 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Capix Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,180 @@
+# @capixjs/transport-rest
+
+HTTP/1.1 REST transport for Capix. Mounts your capabilities as REST endpoints with automatic route inference.
+
+## Install
+
+```bash
+npm install @capixjs/core @capixjs/transport-rest zod
+```
+
+## Usage
+
+```ts
+import { createServer } from '@capixjs/core';
+import { restTransport } from '@capixjs/transport-rest';
+
+createServer({
+  capabilities: {
+    users: { getUser, listUsers, createUser, updateUser, deleteUser },
+  },
+  transports: [restTransport({ port: 3000 })],
+}).start();
+```
+
+## Route inference
+
+Routes are inferred from capability names — no decorators or annotations needed:
+
+| Capability | Group | Method | Path |
+|---|---|---|---|
+| `getUser` (with `id` field) | `users` | GET | `/users/:id` |
+| `listUsers` | `users` | GET | `/users` |
+| `getUsers` | `users` | GET | `/users` |
+| `getMe` | `users` | GET | `/users/me` |
+| `getStats` | `users` | GET | `/users/stats` |
+| `findByEmail` | `users` | GET | `/users` |
+| `searchUsers` | `users` | GET | `/users` |
+| `createUser` | `users` | POST | `/users` |
+| `addUser` | `users` | POST | `/users` |
+| `updateUser` | `users` | PATCH | `/users/:id` |
+| `replaceUser` | `users` | PUT | `/users/:id` |
+| `deleteUser` | `users` | DELETE | `/users/:id` |
+| `removeUser` | `users` | DELETE | `/users/:id` |
+| `unfollow` | `users` | DELETE | `/users/:id/follow` |
+| `bulkStatus` | `users` | POST | `/users/bulk-status` |
+| `register` | `auth` | POST | `/auth/register` |
+
+Rules:
+- The path prefix comes from the capability's group key (`users`, `auth`, etc.)
+- `get*` with an `id` field in the input schema → `GET /group/:id`
+- `list*`, `find*`, `fetch*`, `read*`, `search*`, `filter*`, `all*` → `GET /group`
+- `get*` without `id` field → collection (`GET /group`) only when the remainder matches the group name (e.g. `getUsers` in `users`); otherwise named endpoint (`GET /group/remainder`)
+- `create*`, `add*`, `new*` → `POST /group`
+- `un*` → `DELETE /group/:id/verb` (inverse sub-resource)
+- `update*`, `edit*`, `patch*`, `modify*` → `PATCH /group/:id`
+- `replace*`, `set*`, `put*` → `PUT /group/:id`
+- `delete*`, `remove*`, `destroy*`, `cancel*` → `DELETE /group/:id`
+- Anything else with `query` intent → `GET /group/key`
+- Anything else with `mutation` intent → `POST /group/key`
+
+Capability keys are converted to kebab-case by default: `bulkStatus` → `bulk-status`. Override with `urlCase: 'camel' | 'snake'`.
+
+For nested resource routes (`/projects/:projectId/tasks`), use `overrides`:
+
+```ts
+restTransport({
+  port: 3000,
+  overrides: {
+    'tasks.listTasks':  { method: 'GET',  path: '/projects/:projectId/tasks' },
+    'tasks.createTask': { method: 'POST', path: '/projects/:projectId/tasks' },
+  },
+})
+```
+
+## HTTP override
+
+Override the inferred route when needed:
+
+```ts
+const importUsers = capability(
+  z.object({ file: z.string() }),
+  handler,
+  { http: { method: 'POST', path: '/admin/import' } },
+);
+```
+
+## CORS
+
+```ts
+restTransport({
+  port: 3000,
+  cors: {
+    origin: (origin) => origin.endsWith('.example.com'),
+    methods: ['GET', 'POST', 'PATCH', 'DELETE'],
+    headers: ['Content-Type', 'Authorization'],
+    credentials: true,
+  },
+})
+```
+
+`origin` can be a string, string array, or `(origin: string) => boolean` function.
+
+## Request hooks
+
+```ts
+restTransport({
+  port: 3000,
+  onRequest: (req, res) => {
+    res.setHeader('X-Request-Id', crypto.randomUUID());
+  },
+})
+```
+
+## File uploads
+
+Use `UploadedFile` from the transport for typed file handling:
+
+```ts
+import type { UploadedFile } from '@capixjs/transport-rest';
+import { z } from 'zod';
+
+const uploadAvatar = capability(
+  z.object({
+    file: z.custom<UploadedFile>(),
+    userId: z.string(),
+  }),
+  async ({ file, userId }) => {
+    await storage.save(`avatars/${userId}`, file.buffer);
+    return { url: `/avatars/${userId}` };
+  },
+);
+```
+
+Send multipart/form-data. Non-file fields are merged alongside file fields in the parsed input.
+
+## Options
+
+```ts
+restTransport({
+  port: 3000,                  // required
+  host: '0.0.0.0',             // default: '0.0.0.0'
+  maxBodySize: 1_048_576,      // bytes, default: 1 MiB
+  urlCase: 'kebab',            // 'kebab' (default) | 'camel' | 'snake'
+  cors: { ... },
+  onRequest: (req, res) => void,
+  multipart: { maxFileSize, maxFiles, allowedMimeTypes },
+})
+```
+
+## Per-transport capabilities
+
+Pass `capabilities` directly to the transport to expose only a subset on REST, independent of other transports:
+
+```ts
+const publicAPI = { items: { list: listItems, get: getItem } };
+const memberAPI = { items: { create: createItem, update: updateItem } };
+
+createServer({
+  context: buildContext,
+  transports: [
+    restTransport({ port: 3000, capabilities: { ...publicAPI, ...memberAPI } }),
+  ],
+});
+```
+
+## Exports
+
+| Export | Description |
+|---|---|
+| `restTransport(opts)` | Creates an HTTP/REST transport |
+| `generateRoutes(registry, opts?)` | Returns route definitions for a registry |
+| `compileRouter(routes)` | Compiles routes into a radix-tree router |
+| `uploadedFile()` | Zod schema for file upload fields |
+| `UploadedFile` | Type for uploaded file objects |
+| `RestTransportOptions` | Options type for `restTransport` |
+| `GenerateRoutesOptions` | Options type for `generateRoutes` |
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * index.ts — public API for capix-transport-rest
+ */
+export { restTransport } from './transport.js';
+export type { RestTransportOptions } from './transport.js';
+export { compileRouter, generateRoutes } from './router.js';
+export type { RouteDefinition, RouterMatch, Router, GenerateRoutesOptions, HttpOverride } from './router.js';
+export { uploadedFile } from './multipart.js';
+export type { UploadedFile, MultipartOptions } from './multipart.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5D,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7G,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+/**
+ * index.ts — public API for capix-transport-rest
+ */
+export { restTransport } from './transport.js';
+export { compileRouter, generateRoutes } from './router.js';
+export { uploadedFile } from './multipart.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/multipart-parser.d.ts

@@ -0,0 +1,17 @@
+/**
+ * multipart-parser.ts — busboy-based multipart/form-data parser
+ * Depends on: busboy, multipart.ts
+ */
+import type { IncomingHttpHeaders } from 'node:http';
+import type { UploadedFile, MultipartOptions } from './multipart.js';
+export type ParsedMultipart = {
+    fields: Record<string, string>;
+    files: Record<string, UploadedFile>;
+};
+/**
+ * Parses a multipart/form-data body from an already-read Buffer.
+ * Fields are returned as strings; files as UploadedFile objects.
+ * Rejects with an error that has a `.status` property on limit violations.
+ */
+export declare function parseMultipart(headers: IncomingHttpHeaders, body: Buffer, options?: MultipartOptions): Promise<ParsedMultipart>;
+//# sourceMappingURL=multipart-parser.d.ts.map

package/dist/multipart-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipart-parser.d.ts","sourceRoot":"","sources":["../src/multipart-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAErE,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACrC,CAAC;AAQF;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAgE1B"}

package/dist/multipart-parser.js

@@ -0,0 +1,69 @@
+/**
+ * multipart-parser.ts — busboy-based multipart/form-data parser
+ * Depends on: busboy, multipart.ts
+ */
+import Busboy from 'busboy';
+function parseError(message, status) {
+    return Object.assign(new Error(message), { status });
+}
+/**
+ * Parses a multipart/form-data body from an already-read Buffer.
+ * Fields are returned as strings; files as UploadedFile objects.
+ * Rejects with an error that has a `.status` property on limit violations.
+ */
+export function parseMultipart(headers, body, options = {}) {
+    const maxFileSize = options.maxFileSize ?? 5 * 1024 * 1024;
+    const maxFiles = options.maxFiles ?? 1;
+    return new Promise((resolve, reject) => {
+        const fields = {};
+        const files = {};
+        let settled = false;
+        function fail(err) {
+            if (settled)
+                return;
+            settled = true;
+            reject(err);
+        }
+        const busboy = Busboy({
+            headers,
+            limits: { fileSize: maxFileSize, files: maxFiles },
+        });
+        busboy.on('field', (name, value) => {
+            fields[name] = value;
+        });
+        // Fired when the files limit is reached — busboy stops emitting 'file' events beyond this.
+        busboy.on('filesLimit', () => {
+            fail(parseError(`Too many files. Maximum is ${maxFiles}.`, 400));
+        });
+        busboy.on('file', (fieldName, stream, info) => {
+            const chunks = [];
+            let truncated = false;
+            stream.on('data', (chunk) => { chunks.push(chunk); });
+            stream.on('limit', () => { truncated = true; });
+            stream.on('end', () => {
+                if (truncated) {
+                    fail(parseError(`File '${info.filename || fieldName}' exceeds ${maxFileSize} bytes.`, 413));
+                    return;
+                }
+                const buffer = Buffer.concat(chunks);
+                files[fieldName] = {
+                    filename: info.filename || fieldName,
+                    contentType: info.mimeType || 'application/octet-stream',
+                    sizeBytes: buffer.byteLength,
+                    buffer,
+                };
+            });
+            stream.on('error', (err) => fail(Object.assign(err, { status: 400 })));
+        });
+        busboy.on('finish', () => {
+            if (!settled) {
+                settled = true;
+                resolve({ fields, files });
+            }
+        });
+        busboy.on('error', (err) => fail(Object.assign(err, { status: 400 })));
+        busboy.write(body);
+        busboy.end();
+    });
+}
+//# sourceMappingURL=multipart-parser.js.map

package/dist/multipart-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipart-parser.js","sourceRoot":"","sources":["../src/multipart-parser.ts"],"names":[],"mappings":"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"}

package/dist/multipart.d.ts

@@ -0,0 +1,36 @@
+/**
+ * multipart.ts — UploadedFile type and Zod schema factory
+ * Depends on: zod
+ */
+import type { ZodType } from 'zod';
+export type UploadedFile = {
+    filename: string;
+    contentType: string;
+    sizeBytes: number;
+    buffer: Buffer;
+};
+export type MultipartOptions = {
+    /** Max bytes per file. Default 5MB. */
+    maxFileSize?: number;
+    /** Max number of files per request. Default 1. */
+    maxFiles?: number;
+};
+type UploadedFileOptions = {
+    /** Max bytes for this specific field. Default 5MB. */
+    maxSize?: number;
+    /** Allowed MIME types. If omitted, all types are accepted. */
+    accept?: string[];
+};
+/**
+ * Zod schema for a file uploaded via multipart/form-data.
+ * Use inside z.object() alongside regular fields.
+ *
+ * @example
+ * z.object({
+ *   file: uploadedFile({ maxSize: 2 * 1024 * 1024, accept: ['image/jpeg', 'image/png'] }),
+ *   title: z.string(),
+ * })
+ */
+export declare function uploadedFile(options?: UploadedFileOptions): ZodType<UploadedFile>;
+export {};
+//# sourceMappingURL=multipart.d.ts.map

package/dist/multipart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipart.d.ts","sourceRoot":"","sources":["../src/multipart.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAK,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAI,MAAM,CAAC;IACpB,MAAM,EAAO,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACzB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC,CA4BrF"}

package/dist/multipart.js

@@ -0,0 +1,40 @@
+/**
+ * multipart.ts — UploadedFile type and Zod schema factory
+ * Depends on: zod
+ */
+import { z } from 'zod';
+/**
+ * Zod schema for a file uploaded via multipart/form-data.
+ * Use inside z.object() alongside regular fields.
+ *
+ * @example
+ * z.object({
+ *   file: uploadedFile({ maxSize: 2 * 1024 * 1024, accept: ['image/jpeg', 'image/png'] }),
+ *   title: z.string(),
+ * })
+ */
+export function uploadedFile(options = {}) {
+    const maxSize = options.maxSize ?? 5 * 1024 * 1024;
+    return z
+        .custom((val) => typeof val === 'object' &&
+        val !== null &&
+        typeof val.filename === 'string' &&
+        typeof val.contentType === 'string' &&
+        typeof val.sizeBytes === 'number' &&
+        Buffer.isBuffer(val.buffer), { message: 'Expected an uploaded file' })
+        .superRefine((file, ctx) => {
+        if (file.sizeBytes > maxSize) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `File size ${file.sizeBytes} bytes exceeds maximum ${maxSize} bytes`,
+            });
+        }
+        if (options.accept !== undefined && !options.accept.includes(file.contentType)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `File type '${file.contentType}' not accepted. Allowed: ${options.accept.join(', ')}`,
+            });
+        }
+    });
+}
+//# sourceMappingURL=multipart.js.map

package/dist/multipart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipart.js","sourceRoot":"","sources":["../src/multipart.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwBxB;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,UAA+B,EAAE;IAC5D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IAEnD,OAAO,CAAC;SACL,MAAM,CACL,CAAC,GAAY,EAAuB,EAAE,CACpC,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,OAAQ,GAAoB,CAAC,QAAQ,KAAK,QAAQ;QAClD,OAAQ,GAAoB,CAAC,WAAW,KAAK,QAAQ;QACrD,OAAQ,GAAoB,CAAC,SAAS,KAAK,QAAQ;QACnD,MAAM,CAAC,QAAQ,CAAE,GAAoB,CAAC,MAAM,CAAC,EAC/C,EAAE,OAAO,EAAE,2BAA2B,EAAE,CACzC;SACA,WAAW,CAAC,CAAC,IAAkB,EAAE,GAAoB,EAAE,EAAE;QACxD,IAAI,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,CAAC;YAC7B,GAAG,CAAC,QAAQ,CAAC;gBACX,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM;gBAC3B,OAAO,EAAE,aAAa,IAAI,CAAC,SAAS,0BAA0B,OAAO,QAAQ;aAC9E,CAAC,CAAC;QACL,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YAC/E,GAAG,CAAC,QAAQ,CAAC;gBACX,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM;gBAC3B,OAAO,EAAE,cAAc,IAAI,CAAC,WAAW,4BAA4B,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aAC/F,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/router.d.ts

@@ -0,0 +1,40 @@
+/**
+ * router.ts — radix-tree router for the REST transport
+ * No core dependency except types (CapabilityRegistry, AnyCapability).
+ */
+import type { CapabilityRegistry } from '@capixjs/core';
+export type RouteDefinition = {
+    readonly method: string;
+    readonly path: string;
+    readonly capability: string;
+};
+export type RouterMatch = {
+    readonly found: true;
+    readonly capability: string;
+    readonly params: Record<string, string> | null;
+} | {
+    readonly found: false;
+    readonly allowedMethods?: string[];
+};
+export type Router = {
+    match(method: string, path: string): RouterMatch;
+    readonly routes: ReadonlyArray<RouteDefinition>;
+};
+export type HttpOverride = {
+    readonly method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+    readonly path: string;
+};
+export type GenerateRoutesOptions = {
+    /** Case style for URL path segments. Default: 'kebab' (bulkStatus → bulk-status). */
+    urlCase?: 'kebab' | 'camel' | 'snake';
+    /** Per-capability HTTP route overrides keyed by dot-path. Takes full precedence over URL inference. */
+    overrides?: Record<string, HttpOverride>;
+};
+/** Builds a Router from route definitions. Throws on duplicate routes. */
+export declare function compileRouter(routes: RouteDefinition[]): Router;
+/**
+ * Generates route definitions from a compiled capability registry.
+ * Transport-level overrides take full precedence over URL inference.
+ */
+export declare function generateRoutes(registry: CapabilityRegistry, options?: GenerateRoutesOptions): RouteDefinition[];
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAiB,MAAM,eAAe,CAAC;AAGvE,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;CAAE,GACrG;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAElE,MAAM,MAAM,MAAM,GAAG;IACnB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IAClF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,qFAAqF;IACrF,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IACtC,uGAAuG;IACvG,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC1C,CAAC;AA0IF,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAmB/D;AA0BD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,GAAE,qBAA0B,GAClC,eAAe,EAAE,CAqBnB"}

package/dist/router.js

@@ -0,0 +1,255 @@
+/**
+ * router.ts — radix-tree router for the REST transport
+ * No core dependency except types (CapabilityRegistry, AnyCapability).
+ */
+import { inferIntent } from '@capixjs/core';
+function newNode() {
+    return { handlers: new Map(), staticChildren: new Map() };
+}
+/** Splits a URL path into segments in a single pass (no intermediate array from filter). */
+function splitPath(path) {
+    const segments = [];
+    let start = path.charCodeAt(0) === 47 ? 1 : 0; // skip leading /
+    for (let i = start; i <= path.length; i++) {
+        if (i === path.length || path.charCodeAt(i) === 47) { // 47 = '/'
+            if (i > start)
+                segments.push(path.slice(start, i));
+            start = i + 1;
+        }
+    }
+    return segments;
+}
+function insertRoute(root, method, path, capability) {
+    const segments = splitPath(path);
+    // method is already uppercase — compileRouter calls toUpperCase() before insertRoute
+    const upperMethod = method;
+    let node = root;
+    for (const seg of segments) {
+        if (seg.startsWith(':')) {
+            const paramName = seg.slice(1);
+            if (!node.paramChild) {
+                node.paramChild = { node: newNode(), methodNames: new Map([[upperMethod, paramName]]) };
+            }
+            else {
+                // Allow different param names per method — only error on same method with conflicting names
+                const existing = node.paramChild.methodNames.get(upperMethod);
+                if (existing !== undefined && existing !== paramName) {
+                    throw new Error(`[capix] Router conflict: param name mismatch for ${upperMethod} at same level ` +
+                        `(':${existing}' vs ':${paramName}') for capability '${capability}'`);
+                }
+                node.paramChild.methodNames.set(upperMethod, paramName);
+            }
+            node = node.paramChild.node;
+        }
+        else {
+            if (!node.staticChildren.has(seg)) {
+                node.staticChildren.set(seg, newNode());
+            }
+            node = node.staticChildren.get(seg);
+        }
+    }
+    if (node.handlers.has(upperMethod)) {
+        throw new Error(`[capix] Duplicate route: ${upperMethod} ${path} (capability: ${capability})`);
+    }
+    node.handlers.set(upperMethod, capability);
+}
+function matchRoute(root, method, segments, index, params) {
+    if (index === segments.length) {
+        if (node_hasAnyHandler(root)) {
+            const cap = root.handlers.get(method);
+            if (cap !== undefined) {
+                // null params means no path params were encountered — skip allocation.
+                return { found: true, capability: cap, params };
+            }
+            return { found: false, allowedMethods: [...root.handlers.keys()] };
+        }
+        return { found: false };
+    }
+    const seg = segments[index];
+    if (seg === undefined)
+        return { found: false };
+    // Static match preferred over param match
+    const staticChild = root.staticChildren.get(seg);
+    if (staticChild !== undefined) {
+        const result = matchRoute(staticChild, method, segments, index + 1, params);
+        if (result.found)
+            return result;
+        // If static matched path but not method, return that result
+        if (!result.found && result.allowedMethods !== undefined)
+            return result;
+    }
+    // Param match — look up the param name for the current method
+    if (root.paramChild !== undefined) {
+        // Conditional decode: skip when there are no percent-encoded chars
+        const decoded = seg.includes('%') ? decodeURIComponent(seg) : seg;
+        const paramName = root.paramChild.methodNames.get(method) ??
+            root.paramChild.methodNames.values().next().value ??
+            'id';
+        // Lazily allocate params object (only when first param encountered).
+        // Mutate in place and restore on backtrack.
+        const actualParams = params ?? {};
+        const prev = actualParams[paramName];
+        actualParams[paramName] = decoded;
+        const result = matchRoute(root.paramChild.node, method, segments, index + 1, actualParams);
+        if (!result.found) {
+            if (prev === undefined)
+                delete actualParams[paramName];
+            else
+                actualParams[paramName] = prev;
+        }
+        return result;
+    }
+    return { found: false };
+}
+function node_hasAnyHandler(node) {
+    return node.handlers.size > 0;
+}
+// ---------------------------------------------------------------------------
+// compileRouter
+// ---------------------------------------------------------------------------
+/** Builds a Router from route definitions. Throws on duplicate routes. */
+export function compileRouter(routes) {
+    const root = newNode();
+    for (const route of routes) {
+        insertRoute(root, route.method.toUpperCase(), route.path, route.capability);
+    }
+    return {
+        routes,
+        // Callers must pass method in uppercase — transport guarantees this via req.method.
+        match(method, rawPath) {
+            // Strip query string without creating an intermediate array.
+            const qIdx = rawPath.indexOf('?');
+            const pathOnly = qIdx !== -1 ? rawPath.slice(0, qIdx) : rawPath;
+            const segments = splitPath(pathOnly);
+            // Start with null params; allocate only if a route param is matched.
+            return matchRoute(root, method, segments, 0, null);
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// URL case conversion
+// ---------------------------------------------------------------------------
+function toKebabCase(s) {
+    return s.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();
+}
+function toSnakeCase(s) {
+    return s.replace(/([a-z])([A-Z])/g, '$1_$2').toLowerCase();
+}
+function applyUrlCase(s, urlCase) {
+    switch (urlCase) {
+        case 'kebab': return toKebabCase(s);
+        case 'snake': return toSnakeCase(s);
+        case 'camel': return s;
+    }
+}
+// ---------------------------------------------------------------------------
+// generateRoutes
+// ---------------------------------------------------------------------------
+/**
+ * Generates route definitions from a compiled capability registry.
+ * Transport-level overrides take full precedence over URL inference.
+ */
+export function generateRoutes(registry, options = {}) {
+    const urlCase = options.urlCase ?? 'kebab';
+    const overrides = options.overrides ?? {};
+    const routes = [];
+    for (const key of Object.keys(overrides)) {
+        if (!registry.has(key)) {
+            console.warn(`[capix] REST transport: override for '${key}' does not match any registered capability.`);
+        }
+    }
+    for (const [dotPath, cap] of registry) {
+        const override = overrides[dotPath];
+        if (override !== undefined) {
+            routes.push({ method: override.method, path: override.path, capability: dotPath });
+            continue;
+        }
+        routes.push(...inferRoutes(dotPath, cap, urlCase));
+    }
+    return routes;
+}
+function inferRoutes(dotPath, cap, urlCase) {
+    const segments = dotPath.split('.');
+    const key = segments[segments.length - 1] ?? dotPath;
+    // Group path = all segments except the last one, with case conversion applied
+    const groupSegments = segments.slice(0, -1).map((s) => applyUrlCase(s, urlCase));
+    const groupPath = '/' + groupSegments.join('/');
+    // Use cap.intent when the user set it explicitly; otherwise infer from key name
+    const intent = cap._intentExplicit ? cap.intent : inferIntent(key);
+    const hasIdField = cap.inputSchema
+        ? 'shape' in cap.inputSchema &&
+            typeof cap.inputSchema.shape === 'object' &&
+            cap.inputSchema.shape !== null &&
+            'id' in cap.inputSchema.shape
+        : false;
+    // Key after case conversion (used when key appears in the URL)
+    const urlKey = applyUrlCase(key, urlCase);
+    switch (intent) {
+        case 'query':
+            if (hasIdField) {
+                // get* with id → GET /group/:id
+                return [{ method: 'GET', path: groupPath + '/:id', capability: dotPath }];
+            }
+            // list*, find*, fetch*, read*, search*, filter*, all* → always collection → GET /group
+            if (/^(list|find|fetch|read|search|filter|all)/i.test(key)) {
+                return [{ method: 'GET', path: groupPath || '/', capability: dotPath }];
+            }
+            {
+                // get* without id field: collection only when the remainder matches the parent
+                // group name. getMe → GET /group/me, getStats → GET /group/stats,
+                // getUsers (in users group) → GET /group.
+                const getMatch = /^get([A-Z].*)?/.exec(key);
+                if (getMatch) {
+                    const remainder = getMatch[1] ?? '';
+                    const lastGroup = groupSegments[groupSegments.length - 1] ?? '';
+                    const rLow = remainder.toLowerCase();
+                    const gLow = lastGroup.toLowerCase();
+                    const matchesGroup = !remainder ||
+                        rLow === gLow ||
+                        rLow === gLow.replace(/s$/, '') || // "User" matches "users"
+                        gLow === rLow.replace(/s$/, ''); // "Users" matches "user"
+                    if (matchesGroup) {
+                        return [{ method: 'GET', path: groupPath || '/', capability: dotPath }];
+                    }
+                    // Named: getMe → /group/me, getStats → /group/stats
+                    const namedKey = applyUrlCase(remainder || key, urlCase);
+                    const namedPath = groupSegments.length > 0
+                        ? '/' + [...groupSegments, namedKey].join('/')
+                        : remainder
+                            ? '/' + namedKey
+                            : '/' + applyUrlCase(key, urlCase);
+                    return [{ method: 'GET', path: namedPath, capability: dotPath }];
+                }
+            }
+            // Named query (me, status, health, etc.) — no collection prefix → GET /group/key
+            {
+                const namedPath = groupSegments.length > 0 ? '/' + [...groupSegments, urlKey].join('/') : '/' + urlKey;
+                return [{ method: 'GET', path: namedPath, capability: dotPath }];
+            }
+        case 'mutation': {
+            // create* → POST /group (drop capability key from path)
+            // 'register' intentionally excluded — it's a named action (POST /auth/register), not a resource creation
+            const isCreate = /^(create|add|new)/i.test(key);
+            if (isCreate) {
+                return [{ method: 'POST', path: groupPath || '/', capability: dotPath }];
+            }
+            // un* → DELETE /group/:id/verb (inverse sub-resource action)
+            const unMatch = /^un([A-Za-z].*)/.exec(key);
+            if (unMatch) {
+                const verb = applyUrlCase(unMatch[1], urlCase);
+                const basePath = groupSegments.length > 0 ? groupPath : '';
+                return [{ method: 'DELETE', path: basePath + '/:id/' + verb, capability: dotPath }];
+            }
+            // Named action → POST /group/key
+            const actionPath = groupSegments.length > 0 ? '/' + [...groupSegments, urlKey].join('/') : '/' + urlKey;
+            return [{ method: 'POST', path: actionPath, capability: dotPath }];
+        }
+        case 'update':
+            return [{ method: 'PATCH', path: groupPath + '/:id', capability: dotPath }];
+        case 'replace':
+            return [{ method: 'PUT', path: groupPath + '/:id', capability: dotPath }];
+        case 'delete':
+            return [{ method: 'DELETE', path: groupPath + '/:id', capability: dotPath }];
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AA8C5C,SAAS,OAAO;IACd,OAAO,EAAE,QAAQ,EAAE,IAAI,GAAG,EAAE,EAAE,cAAc,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;AAC5D,CAAC;AAED,4FAA4F;AAC5F,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB;IAChE,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,WAAW;YAC/D,IAAI,CAAC,GAAG,KAAK;gBAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;YACnD,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,WAAW,CAAC,IAAe,EAAE,MAAc,EAAE,IAAY,EAAE,UAAkB;IACpF,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACjC,qFAAqF;IACrF,MAAM,WAAW,GAAG,MAAM,CAAC;IAC3B,IAAI,IAAI,GAAG,IAAI,CAAC;IAEhB,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;gBACrB,IAAI,CAAC,UAAU,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1F,CAAC;iBAAM,CAAC;gBACN,4FAA4F;gBAC5F,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBAC9D,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;oBACrD,MAAM,IAAI,KAAK,CACb,oDAAoD,WAAW,iBAAiB;wBAC9E,MAAM,QAAQ,UAAU,SAAS,sBAAsB,UAAU,GAAG,CACvE,CAAC;gBACJ,CAAC;gBACD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;YAC1D,CAAC;YACD,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;YAC1C,CAAC;YACD,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;QACvC,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CACb,4BAA4B,WAAW,IAAI,IAAI,iBAAiB,UAAU,GAAG,CAC9E,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,UAAU,CACjB,IAAe,EACf,MAAc,EACd,QAAkB,EAClB,KAAa,EACb,MAAqC;IAErC,IAAI,KAAK,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC9B,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACtC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,uEAAuE;gBACvE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;YAClD,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACrE,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAE/C,0CAA0C;IAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;QAC5E,IAAI,MAAM,CAAC,KAAK;YAAE,OAAO,MAAM,CAAC;QAChC,4DAA4D;QAC5D,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;IAC1E,CAAC;IAED,8DAA8D;IAC9D,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAClC,mEAAmE;QACnE,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAClE,MAAM,SAAS,GACb,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC;YACvC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK;YACjD,IAAI,CAAC;QACP,qEAAqE;QACrE,4CAA4C;QAC5C,MAAM,YAAY,GAAG,MAAM,IAAI,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;QACrC,YAAY,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;QAClC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE,YAAY,CAAC,CAAC;QAC3F,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO,YAAY,CAAC,SAAS,CAAC,CAAC;;gBAClD,YAAY,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;QACtC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAe;IACzC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC;AAChC,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,0EAA0E;AAC1E,MAAM,UAAU,aAAa,CAAC,MAAyB;IACrD,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IAEvB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO;QACL,MAAM;QACN,oFAAoF;QACpF,KAAK,CAAC,MAAc,EAAE,OAAe;YACnC,6DAA6D;YAC7D,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAClC,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YAChE,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;YACrC,qEAAqE;YACrE,OAAO,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QACrD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,SAAS,WAAW,CAAC,CAAS;IAC5B,OAAO,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;AAC7D,CAAC;AAED,SAAS,WAAW,CAAC,CAAS;IAC5B,OAAO,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;AAC7D,CAAC;AAED,SAAS,YAAY,CAAC,CAAS,EAAE,OAAoC;IACnE,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO,CAAC,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC;QACpC,KAAK,OAAO,CAAC,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC;QACpC,KAAK,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,QAA4B,EAC5B,UAAiC,EAAE;IAEnC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC;IAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAsB,EAAE,CAAC;IAErC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,yCAAyC,GAAG,6CAA6C,CAAC,CAAC;QAC1G,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,QAAQ,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;YACnF,SAAS;QACX,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAClB,OAAe,EACf,GAAkB,EAClB,OAAoC;IAEpC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC;IAErD,8EAA8E;IAC9E,MAAM,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACjF,MAAM,SAAS,GAAG,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEhD,gFAAgF;IAChF,MAAM,MAAM,GAAG,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW;QAChC,CAAC,CAAC,OAAO,IAAI,GAAG,CAAC,WAAW;YAC1B,OAAO,GAAG,CAAC,WAAW,CAAC,KAAK,KAAK,QAAQ;YACzC,GAAG,CAAC,WAAW,CAAC,KAAK,KAAK,IAAI;YAC9B,IAAI,IAAK,GAAG,CAAC,WAAW,CAAC,KAAgB;QAC3C,CAAC,CAAC,KAAK,CAAC;IAEV,+DAA+D;IAC/D,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAE1C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,OAAO;YACV,IAAI,UAAU,EAAE,CAAC;gBACf,gCAAgC;gBAChC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;YAC5E,CAAC;YACD,uFAAuF;YACvF,IAAI,4CAA4C,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3D,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,IAAI,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;YAC1E,CAAC;YACD,CAAC;gBACC,+EAA+E;gBAC/E,kEAAkE;gBAClE,0CAA0C;gBAC1C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC5C,IAAI,QAAQ,EAAE,CAAC;oBACb,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;oBACpC,MAAM,SAAS,GAAG,aAAa,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;oBAChE,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;oBACrC,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;oBACrC,MAAM,YAAY,GAChB,CAAC,SAAS;wBACV,IAAI,KAAK,IAAI;wBACb,IAAI,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,IAAK,yBAAyB;wBAC7D,IAAI,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAK,yBAAyB;oBAEhE,IAAI,YAAY,EAAE,CAAC;wBACjB,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,IAAI,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;oBAC1E,CAAC;oBACD,oDAAoD;oBACpD,MAAM,QAAQ,GAAG,YAAY,CAAC,SAAS,IAAI,GAAG,EAAE,OAAO,CAAC,CAAC;oBACzD,MAAM,SAAS,GACb,aAAa,CAAC,MAAM,GAAG,CAAC;wBACtB,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,aAAa,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;wBAC9C,CAAC,CAAC,SAAS;4BACT,CAAC,CAAC,GAAG,GAAG,QAAQ;4BAChB,CAAC,CAAC,GAAG,GAAG,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;oBACzC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;gBACnE,CAAC;YACH,CAAC;YACD,iFAAiF;YACjF,CAAC;gBACC,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,aAAa,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC;gBACvG,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;YACnE,CAAC;QAEH,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,wDAAwD;YACxD,yGAAyG;YACzG,MAAM,QAAQ,GAAG,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChD,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,IAAI,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;YAC3E,CAAC;YACD,6DAA6D;YAC7D,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC5C,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAE,EAAE,OAAO,CAAC,CAAC;gBAChD,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3D,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;YACtF,CAAC;YACD,iCAAiC;YACjC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,aAAa,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC;YACxG,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,KAAK,QAAQ;YACX,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;QAE9E,KAAK,SAAS;YACZ,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;QAE5E,KAAK,QAAQ;YACX,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;IACjF,CAAC;AACH,CAAC"}

package/dist/serializer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * serializer.ts — compile fast-json-stringify serializers from Zod output schemas.
+ *
+ * Replaces the generic `JSON.stringify` call in the response path with a schema-compiled
+ * serializer for capabilities that declare an outputSchema. Compiled at mount time; zero
+ * per-request setup cost.
+ */
+import type { CapabilityRegistry } from '@capixjs/core';
+/** Pre-compiled response serializer: data → '{"data":<json>}' */
+export type ResponseSerializer = (data: unknown) => string;
+declare const DEFAULT: ResponseSerializer;
+export { DEFAULT as defaultSerializer };
+/**
+ * Builds per-capability serializers from compiled output schemas.
+ * Falls back to JSON.stringify for capabilities without an outputSchema or
+ * if zod-to-json-schema cannot convert the schema.
+ */
+export declare function buildSerializers(registry: CapabilityRegistry): Map<string, ResponseSerializer>;
+//# sourceMappingURL=serializer.d.ts.map

package/dist/serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../src/serializer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD,iEAAiE;AACjE,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,CAAC;AAE3D,QAAA,MAAM,OAAO,EAAE,kBAAsE,CAAC;AAEtF,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,CAAC;AAExC;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAwB9F"}

package/dist/serializer.js

@@ -0,0 +1,40 @@
+/**
+ * serializer.ts — compile fast-json-stringify serializers from Zod output schemas.
+ *
+ * Replaces the generic `JSON.stringify` call in the response path with a schema-compiled
+ * serializer for capabilities that declare an outputSchema. Compiled at mount time; zero
+ * per-request setup cost.
+ */
+import fastJsonStringify from 'fast-json-stringify';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+const DEFAULT = (data) => '{"data":' + JSON.stringify(data) + '}';
+export { DEFAULT as defaultSerializer };
+/**
+ * Builds per-capability serializers from compiled output schemas.
+ * Falls back to JSON.stringify for capabilities without an outputSchema or
+ * if zod-to-json-schema cannot convert the schema.
+ */
+export function buildSerializers(registry) {
+    const map = new Map();
+    for (const [dotPath, cap] of registry) {
+        if (cap.outputSchema === null)
+            continue;
+        try {
+            const jsonSchema = zodToJsonSchema(cap.outputSchema, {
+                target: 'jsonSchema7',
+                $refStrategy: 'none',
+            });
+            // Remove the $schema meta field — fjs doesn't need it
+            if (typeof jsonSchema === 'object' && jsonSchema !== null) {
+                delete jsonSchema['$schema'];
+            }
+            const serializeData = fastJsonStringify(jsonSchema);
+            map.set(dotPath, (data) => '{"data":' + serializeData(data) + '}');
+        }
+        catch {
+            // Schema type not supported by fjs (e.g. z.union with discriminants); fall back to JSON.stringify.
+        }
+    }
+    return map;
+}
+//# sourceMappingURL=serializer.js.map

package/dist/serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.js","sourceRoot":"","sources":["../src/serializer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAMrD,MAAM,OAAO,GAAuB,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;AAEtF,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,CAAC;AAExC;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAA4B;IAC3D,MAAM,GAAG,GAAG,IAAI,GAAG,EAA8B,CAAC;IAElD,KAAK,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,QAAQ,EAAE,CAAC;QACtC,IAAI,GAAG,CAAC,YAAY,KAAK,IAAI;YAAE,SAAS;QAExC,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,eAAe,CAAC,GAAG,CAAC,YAAY,EAAE;gBACnD,MAAM,EAAE,aAAa;gBACrB,YAAY,EAAE,MAAM;aACrB,CAAC,CAAC;YACH,sDAAsD;YACtD,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;gBAC1D,OAAQ,UAAsC,CAAC,SAAS,CAAC,CAAC;YAC5D,CAAC;YAED,MAAM,aAAa,GAAG,iBAAiB,CAAC,UAAqD,CAAC,CAAC;YAC/F,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QACrE,CAAC;QAAC,MAAM,CAAC;YACP,mGAAmG;QACrG,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/transport.d.ts

@@ -0,0 +1,60 @@
+/**
+ * transport.ts — HTTP/REST transport
+ *
+ * Uses node:http for HTTP/1.1. node:http2 requires TLS for HTTP/2 browser support
+ * (ALPN negotiation); plain h2c is not usable by curl or browsers. For production
+ * HTTP/2, wrap with http2.createSecureServer and pass your TLS certificates.
+ *
+ * Depends on: router.ts, capix core
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { GroupTree, TransportWithCapabilities } from '@capixjs/core';
+import type { HttpOverride } from './router.js';
+import type { MultipartOptions } from './multipart.js';
+export type RestTransportHooks = {
+    /** Called on every response before headers are written. Use to inject additional headers. */
+    readonly onRequest?: (req: IncomingMessage, res: ServerResponse) => void;
+};
+export type RestTransportOptions = {
+    readonly port: number;
+    readonly host?: string;
+    readonly cors?: {
+        readonly origin?: string | ((origin: string) => boolean);
+        readonly methods?: string;
+        readonly headers?: string;
+    };
+    readonly maxBodySize?: number;
+    readonly hooks?: RestTransportHooks;
+    /** Enable multipart/form-data parsing. Pass true or an options object. */
+    readonly multipart?: boolean | MultipartOptions;
+    /** Case style for inferred URL segments. Default: 'kebab' (bulkStatus → bulk-status). */
+    readonly urlCase?: 'kebab' | 'camel' | 'snake';
+    /**
+     * Per-request timeout in milliseconds. Default: 30_000 (30 seconds).
+     *
+     * Set to `false` to disable timeouts entirely. **Only use this in benchmarks
+     * or tests — never in production.** A hung capability will hold its connection
+     * and resources indefinitely, causing connection exhaustion under load.
+     */
+    readonly timeout?: number | false;
+    /**
+     * HTTP route overrides keyed by capability dot-path.
+     * Use for nested resource routes that URL inference cannot produce.
+     *
+     * @example
+     * overrides: {
+     *   'tasks.listProjectTasks': { method: 'GET', path: '/v1/projects/:projectId/tasks' },
+     *   'tasks.createProjectTask': { method: 'POST', path: '/v1/projects/:projectId/tasks' },
+     * }
+     */
+    readonly overrides?: Record<string, HttpOverride>;
+    /**
+     * Capability registry for this transport only.
+     * When set, overrides the server-level `capabilities` default for REST routes.
+     * Use to prevent non-REST capabilities from getting HTTP endpoints.
+     */
+    readonly capabilities?: GroupTree;
+};
+/** Creates a REST transport using node:http. */
+export declare function restTransport(options: RestTransportOptions): TransportWithCapabilities;
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAyD,SAAS,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAEjI,OAAO,KAAK,EAAU,YAAY,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAOvD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,6FAA6F;IAC7F,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,CAAC;CAC1E,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE;QACd,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;QACzD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;IACpC,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;IAChD,yFAAyF;IACzF,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IAC/C;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAClC;;;;;;;;;OASG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAClD;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC;CACnC,CAAC;AAEF,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,yBAAyB,CAsStF"}

package/dist/transport.js

@@ -0,0 +1,303 @@
+/**
+ * transport.ts — HTTP/REST transport
+ *
+ * Uses node:http for HTTP/1.1. node:http2 requires TLS for HTTP/2 browser support
+ * (ALPN negotiation); plain h2c is not usable by curl or browsers. For production
+ * HTTP/2, wrap with http2.createSecureServer and pass your TLS certificates.
+ *
+ * Depends on: router.ts, capix core
+ */
+import * as http from 'node:http';
+import { compileRouter, generateRoutes } from './router.js';
+import { parseMultipart } from './multipart-parser.js';
+import { buildSerializers, defaultSerializer } from './serializer.js';
+const DEFAULT_MAX_BODY_SIZE = 1024 * 1024; // 1MB
+const EMPTY_INPUT = {};
+/** Creates a REST transport using node:http. */
+export function restTransport(options) {
+    let server = null;
+    let router = null;
+    let invokeFn = null;
+    let serializers = null;
+    const corsOriginOpt = options.cors?.origin ?? '*';
+    const maxBodySize = options.maxBodySize ?? DEFAULT_MAX_BODY_SIZE;
+    const corsMethodsValue = options.cors?.methods ?? 'GET, POST, PATCH, PUT, DELETE, OPTIONS';
+    const corsHeadersValue = options.cors?.headers ?? 'Content-Type, Authorization';
+    const hasDynamicOrigin = typeof corsOriginOpt === 'function';
+    const requestTimeout = options.timeout === undefined ? 30_000 : options.timeout;
+    // When timeout: false — share one never-aborted signal per transport instance.
+    const _noTimeoutSignal = requestTimeout === false ? new AbortController().signal : null;
+    if (requestTimeout === false) {
+        console.warn('[capix] WARNING: timeout: false disables request timeouts. ' +
+            'Hung capabilities will hold resources indefinitely. ' +
+            'Do not use this in production.');
+    }
+    // Pre-built headers for the fast path (static CORS origin).
+    // When origin is a function, fall back to per-request setCorsHeaders.
+    let _jsonHeaders200 = null;
+    let _jsonHeadersErr = null;
+    let _preflightHeaders = null;
+    if (!hasDynamicOrigin) {
+        const corsBase = {
+            'Access-Control-Allow-Methods': corsMethodsValue,
+            'Access-Control-Allow-Headers': corsHeadersValue,
+        };
+        if (corsOriginOpt)
+            corsBase['Access-Control-Allow-Origin'] = corsOriginOpt;
+        _jsonHeaders200 = { 'Content-Type': 'application/json', ...corsBase };
+        _jsonHeadersErr = { 'Content-Type': 'application/json', ...corsBase };
+        _preflightHeaders = { ...corsBase };
+    }
+    function setCorsHeaders(req, res) {
+        const reqOrigin = req.headers['origin'] ?? '';
+        const allowOrigin = corsOriginOpt(reqOrigin) ? reqOrigin : '';
+        if (allowOrigin)
+            res.setHeader('Access-Control-Allow-Origin', allowOrigin);
+        res.setHeader('Access-Control-Allow-Methods', corsMethodsValue);
+        res.setHeader('Access-Control-Allow-Headers', corsHeadersValue);
+    }
+    async function readBody(req) {
+        return new Promise((resolve, reject) => {
+            const chunks = [];
+            let size = 0;
+            req.on('data', (chunk) => {
+                size += chunk.byteLength;
+                if (size > maxBodySize) {
+                    req.resume(); // drain remaining data without closing socket so we can still respond
+                    reject(new Error('PAYLOAD_TOO_LARGE'));
+                    return;
+                }
+                chunks.push(chunk);
+            });
+            req.on('end', () => resolve(Buffer.concat(chunks)));
+            req.on('error', reject);
+        });
+    }
+    function coerceQueryValue(val) {
+        if (val === 'true')
+            return true;
+        if (val === 'false')
+            return false;
+        if (val !== '' && !isNaN(Number(val)))
+            return Number(val);
+        return val;
+    }
+    function parseQueryString(url) {
+        const idx = url.indexOf('?');
+        if (idx === -1)
+            return null;
+        const qs = url.slice(idx + 1);
+        const result = {};
+        for (const part of qs.split('&')) {
+            const eqIdx = part.indexOf('=');
+            if (eqIdx === -1)
+                continue;
+            const key = decodeURIComponent(part.slice(0, eqIdx));
+            const val = decodeURIComponent(part.slice(eqIdx + 1));
+            result[key] = coerceQueryValue(val);
+        }
+        return result;
+    }
+    function sendJson(res, status, body) {
+        const json = JSON.stringify(body);
+        res.writeHead(status, _jsonHeadersErr ?? { 'Content-Type': 'application/json' });
+        res.end(json);
+    }
+    function handler(req, res) {
+        // Fast path: pre-built static headers avoid per-request setHeader calls.
+        // Dynamic origin functions still use setCorsHeaders.
+        if (hasDynamicOrigin)
+            setCorsHeaders(req, res);
+        options.hooks?.onRequest?.(req, res);
+        // CORS preflight
+        if (req.method === 'OPTIONS') {
+            if (_preflightHeaders) {
+                res.writeHead(204, _preflightHeaders);
+            }
+            else {
+                res.writeHead(204);
+            }
+            res.end();
+            return;
+        }
+        if (!router || !invokeFn) {
+            sendJson(res, 503, { error: 'ServiceUnavailable', message: 'Server not ready' });
+            return;
+        }
+        const url = req.url ?? '/';
+        // Node.js provides uppercase methods per RFC 7230; explicit toUpperCase() documents the contract.
+        const method = (req.method ?? 'GET').toUpperCase();
+        const match = router.match(method, url);
+        if (!match.found) {
+            if (match.allowedMethods !== undefined) {
+                res.setHeader('Allow', match.allowedMethods.join(', '));
+                sendJson(res, 405, { error: 'MethodNotAllowed', message: 'Method not allowed' });
+            }
+            else {
+                sendJson(res, 404, { error: 'NotFound', message: 'Not found' });
+            }
+            return;
+        }
+        const queryParams = parseQueryString(url);
+        const pathParams = match.params;
+        const noBody = method === 'GET' || method === 'HEAD' || method === 'DELETE';
+        // Async continuation to keep handler signature synchronous (avoids unhandled rejection)
+        const finish = async () => {
+            let bodyParams = {};
+            let rawBodyForContext;
+            if (!noBody) {
+                let rawBody;
+                try {
+                    rawBody = await readBody(req);
+                }
+                catch (err) {
+                    if (err instanceof Error && err.message === 'PAYLOAD_TOO_LARGE') {
+                        sendJson(res, 413, { error: 'PayloadTooLarge', message: 'Request body exceeds size limit' });
+                        return;
+                    }
+                    sendJson(res, 400, { error: 'BadRequest', message: 'Failed to read request body' });
+                    return;
+                }
+                if (rawBody.length > 0) {
+                    rawBodyForContext = rawBody;
+                    const contentType = req.headers['content-type'] ?? '';
+                    if (contentType.includes('multipart/form-data') && options.multipart) {
+                        const multipartOpts = typeof options.multipart === 'object' ? options.multipart : {};
+                        try {
+                            const parsed = await parseMultipart(req.headers, rawBody, multipartOpts);
+                            for (const [k, v] of Object.entries(parsed.fields))
+                                bodyParams[k] = coerceQueryValue(v);
+                            for (const [k, f] of Object.entries(parsed.files))
+                                bodyParams[k] = f;
+                        }
+                        catch (err) {
+                            const status = err.status ?? 400;
+                            const message = err instanceof Error ? err.message : 'Failed to parse multipart body';
+                            sendJson(res, status, { error: status === 413 ? 'PayloadTooLarge' : 'BadRequest', message });
+                            return;
+                        }
+                    }
+                    else if (contentType.includes('application/json')) {
+                        try {
+                            bodyParams = JSON.parse(rawBody.toString('utf8'));
+                        }
+                        catch {
+                            sendJson(res, 400, { error: 'BadRequest', message: 'Invalid JSON body' });
+                            return;
+                        }
+                    }
+                }
+            }
+            // Merge: query params < body params < path params (path wins).
+            // Router returns null for params when no path params exist (avoids allocation).
+            // For the common case (GET with no query and no path params), reuse EMPTY_INPUT.
+            let input;
+            if (pathParams === null && noBody && queryParams === null) {
+                input = EMPTY_INPUT;
+            }
+            else {
+                input = {};
+                if (queryParams !== null)
+                    Object.assign(input, queryParams);
+                Object.assign(input, bodyParams);
+                if (pathParams !== null)
+                    Object.assign(input, pathParams);
+            }
+            // Build flat headers map using for..in (avoids Object.entries array allocation).
+            const headers = {};
+            for (const k in req.headers) {
+                const v = req.headers[k];
+                if (v !== undefined)
+                    headers[k] = Array.isArray(v) ? v.join(', ') : v;
+            }
+            const signal = _noTimeoutSignal ?? AbortSignal.timeout(requestTimeout);
+            const invocation = invokeFn({
+                capability: match.capability,
+                input,
+                headers,
+                signal,
+                ...(rawBodyForContext !== undefined ? { rawBody: rawBodyForContext } : {}),
+            });
+            // Race invocation against the abort signal so hung capabilities don't hold resources.
+            // When timeout: false the signal never fires, so we await directly.
+            const response = requestTimeout === false
+                ? await invocation
+                : await Promise.race([
+                    invocation,
+                    new Promise((resolve) => {
+                        signal.addEventListener('abort', () => resolve({
+                            ok: false,
+                            error: { status: 504, error: 'GatewayTimeout', message: 'Request timed out' },
+                        }), { once: true });
+                    }),
+                ]);
+            if (response.ok) {
+                if (response.data === null || response.data === undefined) {
+                    res.writeHead(204, _preflightHeaders ?? undefined);
+                    res.end();
+                }
+                else {
+                    const serialize = serializers?.get(match.capability) ?? defaultSerializer;
+                    const json = serialize(response.data);
+                    res.writeHead(200, _jsonHeaders200 ?? { 'Content-Type': 'application/json' });
+                    res.end(json);
+                }
+            }
+            else {
+                const { status, error, message, meta } = response.error;
+                const body = { error, message };
+                if (meta !== undefined)
+                    body['meta'] = meta;
+                // Add Retry-After header for rate limit responses per RFC 6585
+                if (status === 429 && typeof meta?.retryAfter === 'number') {
+                    res.setHeader('Retry-After', String(meta.retryAfter));
+                }
+                sendJson(res, status, body);
+            }
+        };
+        finish().catch((err) => {
+            console.error('[capix:rest] Unhandled error in handler:', err);
+            if (!res.headersSent) {
+                sendJson(res, 500, { error: 'Internal', message: 'Internal server error' });
+            }
+        });
+    }
+    return {
+        ...(options.capabilities !== undefined ? { _capabilities: options.capabilities } : {}),
+        async mount(invoke, mountOptions) {
+            invokeFn = invoke;
+            const routeOpts = {
+                ...(options.urlCase !== undefined ? { urlCase: options.urlCase } : {}),
+                ...(options.overrides !== undefined ? { overrides: options.overrides } : {}),
+            };
+            const routes = generateRoutes(mountOptions.registry, routeOpts);
+            router = compileRouter(routes);
+            serializers = buildSerializers(mountOptions.registry);
+            console.log('\nCapix REST transport starting...');
+            for (const route of routes) {
+                console.log(`  ✓ ${route.method.padEnd(7)} ${route.path}`);
+            }
+            return new Promise((resolve, reject) => {
+                server = http.createServer(handler);
+                server.on('error', reject);
+                server.listen(options.port, options.host ?? '0.0.0.0', () => {
+                    console.log(`\n  Listening on http://localhost:${options.port}\n`);
+                    resolve();
+                });
+            });
+        },
+        async unmount() {
+            return new Promise((resolve, reject) => {
+                if (!server)
+                    return resolve();
+                server.close((err) => {
+                    if (err)
+                        reject(err);
+                    else
+                        resolve();
+                });
+            });
+        },
+    };
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@capixjs/transport-rest",
+  "version": "0.1.0-alpha.1",
+  "description": "Capix HTTP/REST transport",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "LICENSE"
+  ],
+  "keywords": [
+    "capix",
+    "rest",
+    "http",
+    "transport",
+    "router",
+    "multipart",
+    "file-upload",
+    "typescript"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "busboy": "^1.6.0",
+    "fast-json-stringify": "^6.4.0",
+    "zod": "^3.23.0",
+    "zod-to-json-schema": "^3.25.2"
+  },
+  "peerDependencies": {
+    "@capixjs/core": ">=0.1.0-0"
+  },
+  "devDependencies": {
+    "@types/busboy": "^1.5.0",
+    "@types/form-data": "^2.5.2",
+    "@types/node": "^20.0.0",
+    "form-data": "^4.0.5",
+    "typescript": "^5.5.0",
+    "vitest": "^1.6.0",
+    "@capixjs/core": "workspace:*"
+  }
+}