@reckona/mreact-router 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tatsuo Kaniwa
+
+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,101 @@
+# @reckona/mreact-router
+
+`@reckona/mreact-router` is the mreact app router. It covers file-system routes,
+loaders, metadata, server actions, prerendering, and deployment adapters.
+
+## Basic Usage
+
+```ts
+import { buildApp, renderBuiltAppRequest } from "@reckona/mreact-router";
+
+await buildApp({
+  projectRoot: process.cwd(),
+  routesDir: "src/app",
+  publicDir: "public",
+  allowedSourceDirs: ["src"],
+  outDir: ".mreact",
+});
+
+const response = await renderBuiltAppRequest({
+  outDir: ".mreact",
+  request: new Request("https://example.test/"),
+});
+```
+
+For application projects, configure the router explicitly in `vite.config.ts`:
+
+```ts
+import { defineConfig } from "vite";
+import { mreactRouter } from "@reckona/mreact-router/vite";
+
+export default defineConfig({
+  plugins: [
+    mreactRouter({
+      routesDir: "src/app",
+      publicDir: "public",
+      allowedSourceDirs: ["src"],
+    }),
+  ],
+});
+```
+
+`mreact-router build` reads this config. The legacy `appDir` shortcut remains
+available for tests and older direct programmatic usage, but it is deprecated.
+Use `projectRoot` + `routesDir` for new code. The shortcut is planned for
+removal after `0.1.0`.
+
+## Route Module Exports
+
+- `loader(context)` returns data passed to the page component.
+- `metadata` injects title, OpenGraph, viewport, and related head tags.
+- `generateStaticParams()` returns dynamic route params to prerender.
+- `prerender = true` emits HTML at build time.
+- `"use server"` modules and `<form action={...}>` provide server actions.
+
+## Deployment Adapters
+
+- `@reckona/mreact-router/adapters/node`: Node `http` server adapter.
+- `@reckona/mreact-router/adapters/static`: static export adapter for prerendered routes.
+- `@reckona/mreact-router/adapters/edge`: generic `Request` / `Response` runtime adapter.
+- `@reckona/mreact-router/adapters/cloudflare`: Cloudflare Workers adapter.
+- `@reckona/mreact-router/adapters/aws-lambda`: AWS Lambda HTTP API v2 adapter.
+
+For Cloudflare Workers, combine `createCloudflareBuiltRequestHandler`,
+`createCloudflareStaticAssetLoader`, `createCloudflarePrerenderStore`, and
+`createCloudflareRouteModuleRenderer`. Use `collectCloudflareRouteModules()` with
+`import.meta.glob()` to build the dynamic route registry from the server
+manifest. Client assets are served only when they appear in the generated
+manifest allow-list. Dynamic routes should resolve modules through a build-time
+registry keyed by `route.file`, not by constructing module ids from request
+input.
+
+For AWS Lambda, use `createAwsLambdaRequestHandler()` with API Gateway HTTP API
+v2 or Lambda Function URL payload format 2.0:
+
+```ts
+import { createAwsLambdaRequestHandler } from "@reckona/mreact-router/adapters/aws-lambda";
+
+export const handler = createAwsLambdaRequestHandler({
+  outDir: ".mreact",
+});
+```
+
+The Lambda adapter returns proxy responses with `cookies`, `headers`,
+`statusCode`, `body`, and `isBase64Encoded`. It buffers response bodies because
+API Gateway and Lambda Function URL proxy responses do not expose true streaming
+SSR. Prefer S3 + CloudFront for `.mreact/client` assets on production Lambda
+deployments.
+
+## Related APIs
+
+- `renderAppRequest`: development and test API for rendering a source app directory.
+- `renderBuiltAppRequest`: production API for rendering a `.mreact/` build artifact.
+- `startDevServer`: dev server that watches the app directory.
+- `startServer`: helper that serves a `.mreact/` build artifact with Node.
+
+## Sessions
+
+Application code should import session helpers from `@reckona/mreact-auth`:
+`createMemorySessionStore()`, `createSession()`, `getSession()`,
+`destroySession()`, and `rotateSession()`. The router still re-exports these
+helpers for older code, but those re-exports are deprecated.

package/dist/actions.d.ts

@@ -0,0 +1,43 @@
+import { type ServerActionHandlerOptions, type ServerActionReplayStore } from "@reckona/mreact-server";
+import { type AppRouterCache } from "./cache.js";
+import { type AppRouterImportPolicy } from "./import-policy.js";
+declare class BoundedReplayStore {
+    private readonly ttlMs;
+    private readonly maxEntries;
+    private readonly entries;
+    constructor(ttlMs: number, maxEntries: number);
+    has(value: string): boolean;
+    add(value: string): void;
+    size(): number;
+}
+export declare function __clearDefaultReplayStore(): void;
+export declare function __readDefaultReplayStore(): BoundedReplayStore;
+export interface AppRouterServerActionOptions {
+    authorize?: ServerActionHandlerOptions["authorize"] | undefined;
+    replayStore?: ServerActionReplayStore | undefined;
+}
+export interface PreparedRouteActions {
+    actionNonce?: string;
+    code: string;
+    csrfToken?: string;
+    csrfTokenIsNew?: boolean;
+    hasFormActions: boolean;
+}
+export declare function prepareRouteServerActions(options: {
+    appDir: string;
+    code: string;
+    pageFile: string;
+    request?: Request | undefined;
+}): Promise<PreparedRouteActions>;
+export declare function dispatchServerActionRequest(options: {
+    appDir: string;
+    importPolicy?: AppRouterImportPolicy | undefined;
+    request: Request;
+    routeCache?: AppRouterCache | undefined;
+    serverActionCacheVersion?: string | undefined;
+    serverActions?: AppRouterServerActionOptions | undefined;
+}): Promise<Response>;
+export declare function serverActionCookie(csrfToken: string): string;
+export declare function __clearServerActionRegistryCache(): void;
+export {};
+//# sourceMappingURL=actions.d.ts.map

package/dist/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,0BAA0B,EAE/B,KAAK,uBAAuB,EAG7B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,KAAK,cAAc,EAAyB,MAAM,YAAY,CAAC;AAExE,OAAO,EAAqC,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AA8CnG,cAAM,kBAAkB;IAIpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;gBAGlC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM;IAGrC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAU3B,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAqBxB,IAAI,IAAI,MAAM;CAGf;AAUD,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D;AAED,MAAM,WAAW,4BAA4B;IAC3C,SAAS,CAAC,EAAE,0BAA0B,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;IAChE,WAAW,CAAC,EAAE,uBAAuB,GAAG,SAAS,CAAC;CACnD;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IAKnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;CACzB;AAuBD,wBAAsB,yBAAyB,CAAC,OAAO,EAAE;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAoChC;AAMD,wBAAsB,2BAA2B,CAAC,OAAO,EAAE;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;IACjD,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACxC,wBAAwB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,aAAa,CAAC,EAAE,4BAA4B,GAAG,SAAS,CAAC;CAC1D,GAAG,OAAO,CAAC,QAAQ,CAAC,CAMpB;AAmMD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAc5D;AAuID,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD"}