@ampless/runtime 1.0.0-beta.68 → 1.0.0-beta.69

package/README.ja.md

@@ -92,6 +92,9 @@ middleware はリクエストごとに AppSync から `post.format` /
   `app/raw/[slug]/route.ts` で配信
 - `format: 'static'` → `/static/<slug>(/<path>)`、
   `app/static/[slug]/[[...path]]/route.ts` で配信
+- `/<slug>.md`（フォーマット不問） → `/md/<slug>`、
+  `app/md/[slug]/route.ts` で配信 — `ampless.postToMarkdown()` による
+  Markdown 投影。`cms.config.ai.markdownRoutes: false` で無効化できます。
 
 また、`post.metadata.cache`（auto / deep / hot）+ `post.updatedAt` +
 `cms.config.cache.{cooldownMs, freshTtlSeconds, deepTtlSeconds}` から
@@ -102,7 +105,7 @@ middleware はリクエストごとに AppSync から `post.format` /
 
 - `@ampless/runtime` — `createAmpless`、ランタイム型、`renderBody`・`renderThemeCss`・フォーマットコンバーターの再エクスポート
 - `@ampless/runtime/middleware` — `createAmplessMiddleware`、`defaultMatcherConfig`
-- `@ampless/runtime/routes` — `createOgRouteHandler`、`createSitemapRouteHandler`、`createFeedRouteHandler`、`createRawRouteHandler`、`createStaticRouteHandler`
+- `@ampless/runtime/routes` — `createOgRouteHandler`、`createSitemapRouteHandler`、`createFeedRouteHandler`、`createRawRouteHandler`、`createStaticRouteHandler`、`createMarkdownRouteHandler`
 - `@ampless/runtime/dispatchers` — `createThemeHomeDispatcher`、`createThemePostDispatcher`、`createThemeTagDispatcher`（それぞれ対応する `*Metadata` ファクトリーあり）
 
 ## テンプレートに残るもの

package/README.md

@@ -92,6 +92,9 @@ rewrites the request to the right internal handler:
   `app/raw/[slug]/route.ts`
 - `format: 'static'` → `/static/<slug>(/<path>)`, served by
   `app/static/[slug]/[[...path]]/route.ts`
+- `/<slug>.md` (any format) → `/md/<slug>`, served by
+  `app/md/[slug]/route.ts` — Markdown projection via
+  `ampless.postToMarkdown()`. Disable with `cms.config.ai.markdownRoutes: false`.
 
 It also computes `Cache-Control` from `post.metadata.cache` (auto /
 deep / hot) + `post.updatedAt` + `cms.config.cache.{cooldownMs,
@@ -102,7 +105,7 @@ See `docs/CONTENT.md` for the cache strategy contract.
 
 - `@ampless/runtime` — `createAmpless`, runtime types, and re-exports of `renderBody`, `renderThemeCss`, format converters
 - `@ampless/runtime/middleware` — `createAmplessMiddleware`, `defaultMatcherConfig`
-- `@ampless/runtime/routes` — `createOgRouteHandler`, `createSitemapRouteHandler`, `createFeedRouteHandler`, `createRawRouteHandler`, `createStaticRouteHandler`
+- `@ampless/runtime/routes` — `createOgRouteHandler`, `createSitemapRouteHandler`, `createFeedRouteHandler`, `createRawRouteHandler`, `createStaticRouteHandler`, `createMarkdownRouteHandler`
 - `@ampless/runtime/dispatchers` — `createThemeHomeDispatcher`, `createThemePostDispatcher`, `createThemeTagDispatcher` (each with a matching `*Metadata` factory)
 
 ## What's still in the template

package/dist/middleware.d.ts

@@ -32,6 +32,8 @@ declare function computeCacheControl(flags: {
  *  - Rewrite to `/static/<slug>(/<path>)` when the post is a static
  *    bundle (`format='static'`). Themed posts (default) get no
  *    rewrite — `app/[slug]/page.tsx` serves them directly.
+ *  - Rewrite `/<slug>.md` → `/md/<slug>` (any format) unless
+ *    `cms.config.ai.markdownRoutes` is explicitly `false`.
  *  - `Cache-Control` header computed from `post.metadata.cache` +
  *    `post.updatedAt` + `cms.config.cache.*` and set on the response.
  *  - `?previewTheme` / `?previewColorScheme` → `x-preview-theme` /

package/dist/middleware.js

@@ -135,7 +135,8 @@ var RESERVED_PREFIXES = /* @__PURE__ */ new Set([
   "tag",
   // internal rewrite targets — direct hits should not be middleware-driven
   "raw",
-  "static"
+  "static",
+  "md"
 ]);
 function createAmplessMiddleware(opts) {
   return async function middleware(request) {
@@ -160,9 +161,11 @@ function createAmplessMiddleware(opts) {
       return passthrough();
     }
     const restPath = segments.slice(1);
-    const flags = await getCachedFlags(opts, slug);
+    const isMdRequest = restPath.length === 0 && slug.endsWith(".md") && slug.length > 3 && opts.cmsConfig.ai?.markdownRoutes !== false;
+    const lookupSlug = isMdRequest ? slug.slice(0, -3) : slug;
+    const flags = await getCachedFlags(opts, lookupSlug);
     if (!flags) {
-      if (restPath.length > 0) {
+      if (restPath.length > 0 || isMdRequest) {
         return new NextResponse("Not Found", { status: 404 });
       }
       return passthrough();
@@ -170,7 +173,12 @@ function createAmplessMiddleware(opts) {
     const cacheControl = computeCacheControl(flags, opts.cmsConfig);
     let response;
     if (restPath.length === 0) {
-      if (flags.format === "html" && flags.metadata?.no_layout === true) {
+      if (isMdRequest) {
+        url.pathname = `/md/${lookupSlug}`;
+        response = NextResponse.rewrite(url, {
+          request: { headers: requestHeaders }
+        });
+      } else if (flags.format === "html" && flags.metadata?.no_layout === true) {
         url.pathname = `/raw/${slug}`;
         response = NextResponse.rewrite(url, {
           request: { headers: requestHeaders }

package/dist/routes/index.d.ts

@@ -5,18 +5,18 @@ import 'react';
 import 'aws-amplify/storage/server';
 import 'next/headers';
 
-interface Ctx$4 {
+interface Ctx$5 {
     params: Promise<{
         slug: string;
     }>;
 }
-type OgRouteHandler = (req: Request, ctx: Ctx$4) => Promise<Response>;
+type OgRouteHandler = (req: Request, ctx: Ctx$5) => Promise<Response>;
 declare function createOgRouteHandler(ampless: Ampless): OgRouteHandler;
 
-interface Ctx$3 {
+interface Ctx$4 {
     params: Promise<Record<string, never>>;
 }
-type SitemapRouteHandler = (req: Request, ctx: Ctx$3) => Promise<Response>;
+type SitemapRouteHandler = (req: Request, ctx: Ctx$4) => Promise<Response>;
 /**
  * Sitemap route delegate. Looks up the active theme and forwards to
  * whichever `routes.sitemap` handler the theme provides. Themes
@@ -24,10 +24,10 @@ type SitemapRouteHandler = (req: Request, ctx: Ctx$3) => Promise<Response>;
  */
 declare function createSitemapRouteHandler(ampless: Ampless): SitemapRouteHandler;
 
-interface Ctx$2 {
+interface Ctx$3 {
     params: Promise<Record<string, never>>;
 }
-type FeedRouteHandler = (req: Request, ctx: Ctx$2) => Promise<Response>;
+type FeedRouteHandler = (req: Request, ctx: Ctx$3) => Promise<Response>;
 /**
  * Feed route delegate. Looks up the active theme and forwards to
  * whichever `routes.feed` handler the theme provides. Themes without
@@ -35,12 +35,12 @@ type FeedRouteHandler = (req: Request, ctx: Ctx$2) => Promise<Response>;
  */
 declare function createFeedRouteHandler(ampless: Ampless): FeedRouteHandler;
 
-interface Ctx$1 {
+interface Ctx$2 {
     params: Promise<{
         slug: string;
     }>;
 }
-type RawRouteHandler = (req: Request, ctx: Ctx$1) => Promise<Response>;
+type RawRouteHandler = (req: Request, ctx: Ctx$2) => Promise<Response>;
 /**
  * Internal route handler for `format: 'html'` posts whose
  * `metadata.no_layout === true` — the body is its own complete HTML
@@ -63,13 +63,13 @@ type RawRouteHandler = (req: Request, ctx: Ctx$1) => Promise<Response>;
  */
 declare function createRawRouteHandler(ampless: Ampless): RawRouteHandler;
 
-interface Ctx {
+interface Ctx$1 {
     params: Promise<{
         slug: string;
         path?: string[];
     }>;
 }
-type StaticRouteHandler = (req: Request, ctx: Ctx) => Promise<Response>;
+type StaticRouteHandler = (req: Request, ctx: Ctx$1) => Promise<Response>;
 /**
  * Internal route handler for `format: 'static'` posts — the body is a
  * manifest describing a bundle of files in S3 at
@@ -97,4 +97,26 @@ type StaticRouteHandler = (req: Request, ctx: Ctx) => Promise<Response>;
  */
 declare function createStaticRouteHandler(ampless: Ampless): StaticRouteHandler;
 
-export { type FeedRouteHandler, type OgRouteHandler, type RawRouteHandler, type SitemapRouteHandler, type StaticRouteHandler, createFeedRouteHandler, createOgRouteHandler, createRawRouteHandler, createSitemapRouteHandler, createStaticRouteHandler };
+interface Ctx {
+    params: Promise<{
+        slug: string;
+    }>;
+}
+type MarkdownRouteHandler = (req: Request, ctx: Ctx) => Promise<Response>;
+/**
+ * Route handler serving the per-post Markdown projection
+ * (`ampless.postToMarkdown()`) for published posts of any format.
+ *
+ * Mounted at `app/md/[slug]/route.ts`; reached via middleware rewrite
+ * of `/<slug>.md` → `/md/<slug>` internally — the public/canonical URL
+ * is `/<slug>.md`. Middleware adds `md` to its reserved-prefix list so
+ * a user post with slug `md` passes through to a 404 rather than
+ * reaching this handler with the wrong content.
+ *
+ * Cache-Control: deliberately omitted from the response. Middleware
+ * computes the strategy from `post.metadata.cache` + `post.updatedAt`
+ * and sets the header on the rewritten response.
+ */
+declare function createMarkdownRouteHandler(ampless: Ampless): MarkdownRouteHandler;
+
+export { type FeedRouteHandler, type MarkdownRouteHandler, type OgRouteHandler, type RawRouteHandler, type SitemapRouteHandler, type StaticRouteHandler, createFeedRouteHandler, createMarkdownRouteHandler, createOgRouteHandler, createRawRouteHandler, createSitemapRouteHandler, createStaticRouteHandler };

package/dist/routes/index.js

@@ -184,8 +184,31 @@ async function signStaticAsset({
     return null;
   }
 }
+
+// src/routes/md.ts
+function createMarkdownRouteHandler(ampless) {
+  return async function GET(_request, { params }) {
+    const { slug } = await params;
+    const cleanSlug = slug.replace(/\.md$/, "");
+    if (ampless.cmsConfig.ai?.markdownRoutes === false) {
+      return new Response("Not Found", { status: 404 });
+    }
+    const post = await ampless.getPublishedPost(cleanSlug);
+    if (!post) {
+      return new Response("Not Found", { status: 404 });
+    }
+    return new Response(await ampless.postToMarkdown(post), {
+      status: 200,
+      headers: {
+        "Content-Type": "text/markdown; charset=utf-8"
+        // Cache-Control set by middleware.
+      }
+    });
+  };
+}
 export {
   createFeedRouteHandler,
+  createMarkdownRouteHandler,
   createOgRouteHandler,
   createRawRouteHandler,
   createSitemapRouteHandler,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ampless/runtime",
-  "version": "1.0.0-beta.68",
+  "version": "1.0.0-beta.69",
   "description": "Public-side runtime for ampless: post fetching, theme dispatch, middleware, public route handlers",
   "license": "MIT",
   "type": "module",
@@ -51,8 +51,8 @@
     "marked": "^18.0.4",
     "sanitize-html": "^2.17.4",
     "tailwind-merge": "^3.6.0",
-    "@ampless/plugin-og-image": "0.2.0-beta.55",
-    "ampless": "1.0.0-beta.55"
+    "@ampless/plugin-og-image": "0.2.0-beta.56",
+    "ampless": "1.0.0-beta.56"
   },
   "peerDependencies": {
     "@aws-amplify/adapter-nextjs": "^1",