mates-fullstack 1.0.0-beta.1

package/dist/request-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-logger.d.ts","sourceRoot":"","sources":["../src/request-logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAKD,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,IAAI,CAwBtE"}

package/dist/request-logger.js

@@ -0,0 +1,55 @@
+/**
+ * mates-fullstack — request-logger.ts
+ *
+ * Drop-in request/response logging middleware.
+ * Logs every incoming request and framework-managed REST/RPC responses.
+ */
+import { onRequest, onResponse } from "./middleware.js";
+import { logger, generateRequestId } from "./logger.js";
+const _KEY_START = "__mates_log_start";
+const _KEY_ID = "__mates_log_id";
+export function requestLogger(options = {}) {
+    const skip = options.skip ?? [];
+    onRequest((c) => {
+        const url = new URL(c.req.raw.url);
+        if (skip.some((pattern) => pattern.test(url.pathname)))
+            return;
+        const requestId = generateRequestId();
+        c.set(_KEY_ID, requestId);
+        c.set(_KEY_START, performance.now());
+        c.resHeaders["x-request-id"] = requestId;
+        logger.withRequest(requestId).info(`→ ${c.req.method} ${url.pathname}`, {
+            method: c.req.method,
+            path: url.pathname,
+            ip: resolveIp(c),
+            ...(url.search ? { query: url.search } : {}),
+        });
+    });
+    onResponse((c) => {
+        const status = typeof c.resStatus === "number" ? c.resStatus : 200;
+        logOutcome(c, status);
+    });
+}
+function logOutcome(c, status) {
+    const requestId = c.get(_KEY_ID);
+    const startTime = c.get(_KEY_START);
+    if (!requestId || startTime === undefined)
+        return;
+    const ms = Number((performance.now() - startTime).toFixed(1));
+    const log = logger.withRequest(requestId);
+    if (status >= 500)
+        log.error(`← ${status}`, { status, ms });
+    else if (status >= 400)
+        log.warn(`← ${status}`, { status, ms });
+    else
+        log.info(`← ${status}`, { status, ms });
+}
+function resolveIp(c) {
+    return (c.reqHeaders["cf-connecting-ip"]?.trim() ??
+        c.reqHeaders["x-forwarded-for"]
+            ?.split(",")[0]
+            .trim() ??
+        c.reqHeaders["x-real-ip"]?.trim() ??
+        "unknown");
+}
+//# sourceMappingURL=request-logger.js.map

package/dist/request-logger.js.map

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

package/dist/rest.d.ts

@@ -0,0 +1,25 @@
+/**
+ * mates-fullstack — rest.ts
+ *
+ * REST router — Hono-style single-ctx per handler.
+ */
+import type { Context } from "./ctx.js";
+export type RestMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD";
+export type RestHandler = (c: Context) => Response | void | Promise<Response | void>;
+export declare function clearRestRoutes(): void;
+/**
+ * Match and run a REST route for the given request.
+ * Called by server.ts after request middleware, before RPC.
+ * @internal
+ */
+export declare function matchAndRunRest(c: Context): Promise<Response | null>;
+export declare const rest: {
+    get: (path: string, handler: RestHandler) => void;
+    post: (path: string, handler: RestHandler) => void;
+    put: (path: string, handler: RestHandler) => void;
+    patch: (path: string, handler: RestHandler) => void;
+    delete: (path: string, handler: RestHandler) => void;
+    options: (path: string, handler: RestHandler) => void;
+    head: (path: string, handler: RestHandler) => void;
+};
+//# sourceMappingURL=rest.d.ts.map

package/dist/rest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest.d.ts","sourceRoot":"","sources":["../src/rest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,MAAM,UAAU,GAClB,KAAK,GACL,MAAM,GACN,KAAK,GACL,OAAO,GACP,QAAQ,GACR,SAAS,GACT,MAAM,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CACxB,CAAC,EAAE,OAAO,KACP,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;AAchD,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAqB1E;AAaD,eAAO,MAAM,IAAI;gBACH,MAAM,WAAW,WAAW,KAAG,IAAI;iBAElC,MAAM,WAAW,WAAW,KAAG,IAAI;gBAEpC,MAAM,WAAW,WAAW,KAAG,IAAI;kBAEjC,MAAM,WAAW,WAAW,KAAG,IAAI;mBAElC,MAAM,WAAW,WAAW,KAAG,IAAI;oBAElC,MAAM,WAAW,WAAW,KAAG,IAAI;iBAEtC,MAAM,WAAW,WAAW,KAAG,IAAI;CAEjD,CAAC"}

package/dist/rest.js

@@ -0,0 +1,93 @@
+/**
+ * mates-fullstack — rest.ts
+ *
+ * REST router — Hono-style single-ctx per handler.
+ */
+let _restRoutes = [];
+export function clearRestRoutes() {
+    _restRoutes = [];
+}
+/**
+ * Match and run a REST route for the given request.
+ * Called by server.ts after request middleware, before RPC.
+ * @internal
+ */
+export async function matchAndRunRest(c) {
+    const method = c.req.method.toUpperCase();
+    for (const route of _restRoutes) {
+        if (route.method !== method)
+            continue;
+        const params = _matchRoute(route, c.req.path);
+        if (!params)
+            continue;
+        // Clone context with route params injected
+        const routeCtx = Object.assign(Object.create(Object.getPrototypeOf(c)), c, {
+            req: { ...c.req, params, param: (name) => params[name] },
+        });
+        const returned = await route.handler(routeCtx);
+        if (returned instanceof Response)
+            return returned;
+        const impl = routeCtx;
+        return impl._response?.() ?? new Response(null, { status: 204 });
+    }
+    return null;
+}
+// ─── Registration ─────────────────────────────────────────────────────────────
+function _register(method, pattern, handler) {
+    const compiled = _compileRoute(method, pattern, handler);
+    _restRoutes.push(compiled);
+}
+export const rest = {
+    get: (path, handler) => _register("GET", path, handler),
+    post: (path, handler) => _register("POST", path, handler),
+    put: (path, handler) => _register("PUT", path, handler),
+    patch: (path, handler) => _register("PATCH", path, handler),
+    delete: (path, handler) => _register("DELETE", path, handler),
+    options: (path, handler) => _register("OPTIONS", path, handler),
+    head: (path, handler) => _register("HEAD", path, handler),
+};
+// ─── Route compilation ────────────────────────────────────────────────────────
+function _compileRoute(method, pattern, handler) {
+    const normalized = _normalizePath(pattern);
+    const paramNames = [];
+    const parts = normalized.split("/").filter(Boolean);
+    const regexParts = parts.map((part) => {
+        if (part.startsWith(":")) {
+            const name = part.slice(1);
+            if (!name)
+                throw new Error(`Invalid REST route pattern: ${pattern}`);
+            paramNames.push(name);
+            return "([^/]+)";
+        }
+        if (part === "*") {
+            paramNames.push("*");
+            return "(.*)";
+        }
+        return _escapeRegex(part);
+    });
+    const regex = new RegExp(`^/${regexParts.join("/")}/?$`);
+    return { method, pattern: normalized, regex, paramNames, handler };
+}
+function _matchRoute(route, pathname) {
+    const match = route.regex.exec(_normalizePath(pathname));
+    if (!match)
+        return null;
+    const params = {};
+    for (let i = 0; i < route.paramNames.length; i += 1) {
+        try {
+            params[route.paramNames[i]] = decodeURIComponent(match[i + 1] ?? "");
+        }
+        catch {
+            // Malformed percent-encoding — treat as no match
+            return null;
+        }
+    }
+    return params;
+}
+function _normalizePath(path) {
+    return path.startsWith("/") ? path : `/${path}`;
+}
+function _escapeRegex(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=rest.js.map

package/dist/rest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest.js","sourceRoot":"","sources":["../src/rest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA2BH,IAAI,WAAW,GAAoB,EAAE,CAAC;AAEtC,MAAM,UAAU,eAAe;IAC7B,WAAW,GAAG,EAAE,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,CAAU;IAC9C,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAgB,CAAC;IAExD,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;YAAE,SAAS;QAEtC,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM;YAAE,SAAS;QAEtB,2CAA2C;QAC3C,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;YACzE,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;SACjE,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,QAAQ,YAAY,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAClD,MAAM,IAAI,GAAG,QAAe,CAAC;QAC7B,OAAO,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,iFAAiF;AAEjF,SAAS,SAAS,CAChB,MAAkB,EAClB,OAAe,EACf,OAAoB;IAEpB,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACzD,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,GAAG,EAAE,CAAC,IAAY,EAAE,OAAoB,EAAQ,EAAE,CAChD,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC;IACjC,IAAI,EAAE,CAAC,IAAY,EAAE,OAAoB,EAAQ,EAAE,CACjD,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC;IAClC,GAAG,EAAE,CAAC,IAAY,EAAE,OAAoB,EAAQ,EAAE,CAChD,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC;IACjC,KAAK,EAAE,CAAC,IAAY,EAAE,OAAoB,EAAQ,EAAE,CAClD,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC;IACnC,MAAM,EAAE,CAAC,IAAY,EAAE,OAAoB,EAAQ,EAAE,CACnD,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC;IACpC,OAAO,EAAE,CAAC,IAAY,EAAE,OAAoB,EAAQ,EAAE,CACpD,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC;IACrC,IAAI,EAAE,CAAC,IAAY,EAAE,OAAoB,EAAQ,EAAE,CACjD,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC;CACnC,CAAC;AAEF,iFAAiF;AAEjF,SAAS,aAAa,CACpB,MAAkB,EAClB,OAAe,EACf,OAAoB;IAEpB,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACpC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,OAAO,EAAE,CAAC,CAAC;YACrE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrB,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,KAAK,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AACrE,CAAC;AAED,SAAS,WAAW,CAClB,KAAoB,EACpB,QAAgB;IAEhB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACpD,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACvE,CAAC;QAAC,MAAM,CAAC;YACP,iDAAiD;YACjD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;AAClD,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC"}

package/dist/router.d.ts

@@ -0,0 +1,71 @@
+/**
+ * mates-ssr — router.ts
+ *
+ * Scans the pages directory and builds a route table.
+ * Matches incoming URL pathnames to a page file + extracted params.
+ *
+ * Routing rules:
+ *   src/pages/index.ts          →  /
+ *   src/pages/about.ts          →  /about
+ *   src/pages/blog/index.ts     →  /blog
+ *   src/pages/blog/[slug].ts    →  /blog/:slug   → params: { slug: "hello" }
+ *   src/pages/[...all].ts       →  /*  (catch-all / 404 fallback)
+ *
+ * Page file exports:
+ *   default export              →  the page Component (required)
+ *   export const layout         →  layout Component wrapping this page (optional)
+ *   export const meta           →  { title?, description? } for <head> (optional)
+ */
+export interface RouteEntry {
+    /** Absolute path to the page file on disk. */
+    filePath: string;
+    /**
+     * URL pattern used for matching, e.g. "/blog/:slug".
+     * Catch-all routes use the special pattern "/*".
+     */
+    pattern: string;
+    /**
+     * Ordered list of dynamic segment names, e.g. ["slug"] for /blog/:slug.
+     * Empty for static routes.
+     */
+    paramNames: string[];
+    /** True when this is a [...all] catch-all route. */
+    isCatchAll: boolean;
+}
+export interface MatchResult {
+    /** The matched route entry. */
+    route: RouteEntry;
+    /** Extracted URL params, e.g. { slug: "hello-world" }. */
+    params: Record<string, string>;
+}
+/**
+ * Recursively scan `pagesDir` and return a sorted route table.
+ *
+ * Sort order guarantees correct priority during matching:
+ *   1. Static routes before dynamic routes (e.g. /about before /:id)
+ *   2. Deeper (more specific) routes before shallower ones
+ *   3. Catch-all routes always last
+ */
+export declare function scanRoutes(pagesDir: string): RouteEntry[];
+/**
+ * Match a URL pathname against the route table.
+ * Returns the first match with extracted params, or null if nothing matches.
+ *
+ * Call this on every incoming request.
+ *
+ * @example
+ * const routes = scanRoutes('./src/pages');
+ * const match = matchRoute(routes, '/blog/hello-world');
+ * // match.route.pattern === '/blog/:slug'
+ * // match.params        === { slug: 'hello-world' }
+ */
+export declare function matchRoute(routes: RouteEntry[], pathname: string): MatchResult | null;
+/**
+ * Watch the pages directory for changes and call `onChange` when any
+ * page file is added, removed, or renamed (not on content edits — those
+ * are handled by re-importing the module).
+ *
+ * Returns a cleanup function that stops watching.
+ */
+export declare function watchRoutes(pagesDir: string, onChange: () => void): () => void;
+//# 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;;;;;;;;;;;;;;;;;GAiBG;AAOH,MAAM,WAAW,UAAU;IACzB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,oDAAoD;IACpD,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,+BAA+B;IAC/B,KAAK,EAAE,UAAU,CAAC;IAClB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAID;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE,CAazD;AA8HD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,UAAU,EAAE,EACpB,QAAQ,EAAE,MAAM,GACf,WAAW,GAAG,IAAI,CAepB;AAyCD;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,IAAI,GACnB,MAAM,IAAI,CAUZ"}

package/dist/router.js

@@ -0,0 +1,222 @@
+/**
+ * mates-ssr — router.ts
+ *
+ * Scans the pages directory and builds a route table.
+ * Matches incoming URL pathnames to a page file + extracted params.
+ *
+ * Routing rules:
+ *   src/pages/index.ts          →  /
+ *   src/pages/about.ts          →  /about
+ *   src/pages/blog/index.ts     →  /blog
+ *   src/pages/blog/[slug].ts    →  /blog/:slug   → params: { slug: "hello" }
+ *   src/pages/[...all].ts       →  /*  (catch-all / 404 fallback)
+ *
+ * Page file exports:
+ *   default export              →  the page Component (required)
+ *   export const layout         →  layout Component wrapping this page (optional)
+ *   export const meta           →  { title?, description? } for <head> (optional)
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+// ─── Scanner ──────────────────────────────────────────────────────────────────
+/**
+ * Recursively scan `pagesDir` and return a sorted route table.
+ *
+ * Sort order guarantees correct priority during matching:
+ *   1. Static routes before dynamic routes (e.g. /about before /:id)
+ *   2. Deeper (more specific) routes before shallower ones
+ *   3. Catch-all routes always last
+ */
+export function scanRoutes(pagesDir) {
+    const absDir = path.resolve(pagesDir);
+    if (!fs.existsSync(absDir)) {
+        throw new Error(`mates-ssr: pages directory not found at "${absDir}".\n` +
+            `Make sure pagesDir in your mates.config.ts points to the right folder.`);
+    }
+    const entries = [];
+    collectFiles(absDir, absDir, entries);
+    return sortRoutes(entries);
+}
+/**
+ * Walk the directory tree and push a RouteEntry for each page file.
+ */
+function collectFiles(baseDir, currentDir, entries) {
+    const items = fs.readdirSync(currentDir, { withFileTypes: true });
+    for (const item of items) {
+        const fullPath = path.join(currentDir, item.name);
+        if (item.isDirectory()) {
+            collectFiles(baseDir, fullPath, entries);
+            continue;
+        }
+        // Only .ts and .js files; skip non-page files
+        if (!isPageFile(item.name))
+            continue;
+        const entry = filePathToRoute(baseDir, fullPath);
+        if (entry)
+            entries.push(entry);
+    }
+}
+/**
+ * Returns true if the file should be treated as a page.
+ * Skips hidden files, test files, and non-TS/JS files.
+ */
+function isPageFile(filename) {
+    if (filename.startsWith('_'))
+        return false; // _layout.ts etc. — private
+    if (filename.startsWith('.'))
+        return false; // hidden files
+    if (filename.includes('.test.') || filename.includes('.spec.'))
+        return false;
+    return /\.(ts|js|tsx|jsx)$/.test(filename);
+}
+/**
+ * Convert an absolute file path to a RouteEntry.
+ *
+ * Examples (baseDir = /project/src/pages):
+ *   /project/src/pages/index.ts          → pattern: /
+ *   /project/src/pages/about.ts          → pattern: /about
+ *   /project/src/pages/blog/index.ts     → pattern: /blog
+ *   /project/src/pages/blog/[slug].ts    → pattern: /blog/:slug
+ *   /project/src/pages/[...all].ts       → pattern: /*  (catch-all)
+ */
+function filePathToRoute(baseDir, filePath) {
+    // Relative path from pages dir, e.g. "blog/[slug].ts"
+    const rel = path.relative(baseDir, filePath);
+    // Split into segments without extension
+    const withoutExt = rel.replace(/\.(ts|js|tsx|jsx)$/, '');
+    const rawSegments = withoutExt.split(path.sep);
+    // Drop trailing "index" segment — blog/index → /blog
+    const segments = rawSegments[rawSegments.length - 1] === 'index'
+        ? rawSegments.slice(0, -1)
+        : rawSegments;
+    const paramNames = [];
+    let isCatchAll = false;
+    const patternParts = [];
+    for (const seg of segments) {
+        if (seg.startsWith('[...') && seg.endsWith(']')) {
+            // [...all] — catch-all
+            isCatchAll = true;
+            paramNames.push(seg.slice(4, -1)); // extract "all"
+            patternParts.push('*');
+        }
+        else if (seg.startsWith('[') && seg.endsWith(']')) {
+            // [slug] — dynamic segment
+            const name = seg.slice(1, -1);
+            paramNames.push(name);
+            patternParts.push(`:${name}`);
+        }
+        else {
+            patternParts.push(seg);
+        }
+    }
+    const pattern = patternParts.length === 0
+        ? '/'
+        : '/' + patternParts.join('/');
+    return {
+        filePath,
+        pattern,
+        paramNames,
+        isCatchAll,
+    };
+}
+/**
+ * Sort routes so the most specific match wins:
+ *   1. Catch-all routes sink to the bottom
+ *   2. Static routes (no params) beat dynamic routes of the same depth
+ *   3. Deeper routes beat shallower routes (more segments = more specific)
+ */
+function sortRoutes(entries) {
+    return [...entries].sort((a, b) => {
+        // Catch-all always last
+        if (a.isCatchAll && !b.isCatchAll)
+            return 1;
+        if (!a.isCatchAll && b.isCatchAll)
+            return -1;
+        const aSegs = a.pattern.split('/').filter(Boolean).length;
+        const bSegs = b.pattern.split('/').filter(Boolean).length;
+        // More segments = more specific = higher priority
+        if (aSegs !== bSegs)
+            return bSegs - aSegs;
+        // Same depth: static beats dynamic
+        const aDynamic = a.paramNames.length;
+        const bDynamic = b.paramNames.length;
+        return aDynamic - bDynamic;
+    });
+}
+// ─── Matcher ──────────────────────────────────────────────────────────────────
+/**
+ * Match a URL pathname against the route table.
+ * Returns the first match with extracted params, or null if nothing matches.
+ *
+ * Call this on every incoming request.
+ *
+ * @example
+ * const routes = scanRoutes('./src/pages');
+ * const match = matchRoute(routes, '/blog/hello-world');
+ * // match.route.pattern === '/blog/:slug'
+ * // match.params        === { slug: 'hello-world' }
+ */
+export function matchRoute(routes, pathname) {
+    // Normalise: strip trailing slash except for "/"
+    const normalised = pathname.length > 1 && pathname.endsWith('/')
+        ? pathname.slice(0, -1)
+        : pathname;
+    for (const route of routes) {
+        const params = tryMatch(route, normalised);
+        if (params !== null) {
+            return { route, params };
+        }
+    }
+    return null;
+}
+/**
+ * Try to match a single route against a pathname.
+ * Returns extracted params on success, or null on no match.
+ */
+function tryMatch(route, pathname) {
+    // Catch-all matches everything
+    if (route.isCatchAll) {
+        return { [route.paramNames[0] ?? 'all']: pathname };
+    }
+    const routeSegments = route.pattern.split('/').filter(Boolean);
+    const pathSegments = pathname.split('/').filter(Boolean);
+    // Segment count must match exactly for non-catch-all routes
+    if (routeSegments.length !== pathSegments.length)
+        return null;
+    const params = {};
+    for (let i = 0; i < routeSegments.length; i++) {
+        const routeSeg = routeSegments[i];
+        const pathSeg = pathSegments[i];
+        if (routeSeg.startsWith(':')) {
+            // Dynamic segment — capture the value
+            params[routeSeg.slice(1)] = decodeURIComponent(pathSeg);
+        }
+        else if (routeSeg !== pathSeg) {
+            // Static segment mismatch
+            return null;
+        }
+    }
+    return params;
+}
+// ─── Hot-reload helper ────────────────────────────────────────────────────────
+/**
+ * Watch the pages directory for changes and call `onChange` when any
+ * page file is added, removed, or renamed (not on content edits — those
+ * are handled by re-importing the module).
+ *
+ * Returns a cleanup function that stops watching.
+ */
+export function watchRoutes(pagesDir, onChange) {
+    const absDir = path.resolve(pagesDir);
+    const watcher = fs.watch(absDir, { recursive: true }, (event, filename) => {
+        if (!filename)
+            return;
+        if (!isPageFile(path.basename(filename)))
+            return;
+        // Only re-scan on add/remove (rename events), not on content changes
+        if (event === 'rename')
+            onChange();
+    });
+    return () => watcher.close();
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

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

package/dist/rpc-registry.d.ts

@@ -0,0 +1,84 @@
+/**
+ * mates-fullstack — rpc-registry.ts
+ *
+ * Scans server/api/ and registers every exported async function as an RPC endpoint.
+ *
+ * URL derivation:
+ *   server/api/users.ts        + getUsers   → POST /api/users/getUsers
+ *   server/api/posts/index.ts  + getPosts   → POST /api/posts/getPosts
+ *   server/api/auth.ts         + login      → POST /api/auth/login
+ *
+ * The URL is also the test/Postman endpoint:
+ *   POST /api/users/getUsers
+ *   Content-Type: application/json
+ *   { "page": 0 }
+ *
+ * Rules for what gets registered:
+ *   ✅ Exported async functions
+ *   ✅ Plain exported functions (warned but registered)
+ *   ❌ default export (page component convention)
+ *   ❌ Non-function exports (types, constants)
+ *   ❌ Reserved names: loader, meta, layout, staticPaths, onConnect, onDisconnect
+ *   ❌ Functions named "then" or "catch" (conflicts with Promise protocol)
+ *   ❌ Files starting with _ or containing .test. / .spec.
+ *
+ * Dev mode:
+ *   Files are re-imported with a cache-busting timestamp on every rescan.
+ *   The watcher triggers a rescan on file add/remove/rename.
+ *   Content edits are picked up because the cache-bust forces a fresh import.
+ */
+export interface RpcEntry {
+    /** Full URL path, e.g. /api/users/getUsers */
+    url: string;
+    /** Absolute path to the source file */
+    filePath: string;
+    /** Exported function name */
+    fnName: string;
+    /** The actual function — never reaches the browser */
+    fn: (...args: any[]) => Promise<unknown>;
+}
+/**
+ * Scan server/api/ and populate the registry.
+ * Call once at startup. In dev mode, call again after file changes
+ * or use watchRpcFunctions() for automatic rescanning.
+ */
+export declare function scanRpcFunctions(apiDir: string, dev?: boolean): Promise<void>;
+/**
+ * Look up a registered RPC function by its URL.
+ * Returns null if not found.
+ *
+ * @example
+ * lookupRpcFn("/api/users/getUsers")
+ */
+export declare function lookupRpcFn(url: string): RpcEntry | null;
+/**
+ * Returns all registered RPC entries.
+ * Used by the docs generator and startup logging.
+ */
+export declare function listRpcFunctions(): RpcEntry[];
+/**
+ * Returns the number of registered RPC functions.
+ */
+export declare function rpcRegistrySize(): number;
+/**
+ * Clear the registry. Used before a rescan or in tests.
+ */
+export declare function clearRpcRegistry(): void;
+/**
+ * Watch server/api/ for file changes and trigger a rescan.
+ * Returns a cleanup function that stops the watcher.
+ *
+ * Only responds to file add/remove/rename events — content edits are
+ * handled by the cache-bust import in dev mode.
+ */
+export declare function watchRpcFunctions(apiDir: string, onChange: (event: string, filename: string) => void): () => void;
+/**
+ * Derive the RPC URL for a function exported from a file.
+ *
+ * Examples (apiDir = /project/server/api):
+ *   /project/server/api/users.ts        + getUsers  → /api/users/getUsers
+ *   /project/server/api/posts/index.ts  + getPosts  → /api/posts/getPosts
+ *   /project/server/api/auth.ts         + login     → /api/auth/login
+ */
+export declare function deriveRpcUrl(apiDir: string, filePath: string, fnName: string): string;
+//# sourceMappingURL=rpc-registry.d.ts.map

package/dist/rpc-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-registry.d.ts","sourceRoot":"","sources":["../src/rpc-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAQH,MAAM,WAAW,QAAQ;IACvB,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1C;AAgCD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,GAAG,UAAQ,GACV,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAIxD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,QAAQ,EAAE,CAE7C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,GAClD,MAAM,IAAI,CAoBZ;AAID;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,MAAM,CAoBR"}