vinext 0.0.0 → 0.0.2

package/dist/server/isr-cache.js

@@ -0,0 +1,134 @@
+/**
+ * ISR (Incremental Static Regeneration) cache layer.
+ *
+ * Wraps the pluggable CacheHandler with stale-while-revalidate semantics:
+ * - Fresh hit: serve immediately
+ * - Stale hit: serve immediately + trigger background regeneration
+ * - Miss: render synchronously, cache, serve
+ *
+ * Background regeneration is deduped — only one regeneration per cache key
+ * runs at a time, preventing thundering herd on popular pages.
+ *
+ * This layer works with any CacheHandler backend (memory, Redis, KV, etc.)
+ * because it only uses the standard get/set interface.
+ */
+import { getCacheHandler, } from "../shims/cache.js";
+import { fnv1a64 } from "../utils/hash.js";
+/**
+ * Get a cache entry with staleness information.
+ *
+ * Returns { value, isStale: false } for fresh entries,
+ * { value, isStale: true } for expired-but-usable entries,
+ * or null for cache misses.
+ */
+export async function isrGet(key) {
+    const handler = getCacheHandler();
+    const result = await handler.get(key);
+    if (!result || !result.value)
+        return null;
+    return {
+        value: result,
+        isStale: result.cacheState === "stale",
+    };
+}
+/**
+ * Store a value in the ISR cache with a revalidation period.
+ */
+export async function isrSet(key, data, revalidateSeconds, tags) {
+    const handler = getCacheHandler();
+    await handler.set(key, data, {
+        revalidate: revalidateSeconds,
+        tags: tags ?? [],
+    });
+}
+// ---------------------------------------------------------------------------
+// Background regeneration dedup
+// ---------------------------------------------------------------------------
+const pendingRegenerations = new Map();
+/**
+ * Trigger a background regeneration for a cache key.
+ *
+ * If a regeneration for this key is already in progress, this is a no-op.
+ * The renderFn should produce the new cache value and call isrSet internally.
+ */
+export function triggerBackgroundRegeneration(key, renderFn) {
+    if (pendingRegenerations.has(key))
+        return;
+    const promise = renderFn()
+        .catch((err) => {
+        console.error(`[vinext] ISR background regeneration failed for ${key}:`, err);
+    })
+        .finally(() => {
+        pendingRegenerations.delete(key);
+    });
+    pendingRegenerations.set(key, promise);
+}
+// ---------------------------------------------------------------------------
+// Helpers for building ISR cache values
+// ---------------------------------------------------------------------------
+/**
+ * Build a CachedPagesValue for the Pages Router ISR cache.
+ */
+export function buildPagesCacheValue(html, pageData, status) {
+    return {
+        kind: "PAGES",
+        html,
+        pageData,
+        headers: undefined,
+        status,
+    };
+}
+/**
+ * Build a CachedAppPageValue for the App Router ISR cache.
+ */
+export function buildAppPageCacheValue(html, rscData, status) {
+    return {
+        kind: "APP_PAGE",
+        html,
+        rscData,
+        headers: undefined,
+        postponed: undefined,
+        status,
+    };
+}
+/**
+ * Compute an ISR cache key for a given router type and pathname.
+ * Long pathnames are hashed to stay within KV key-length limits (512 bytes).
+ */
+export function isrCacheKey(router, pathname) {
+    const normalized = pathname === "/" ? "/" : pathname.replace(/\/$/, "");
+    const key = `${router}:${normalized}`;
+    if (key.length <= 200)
+        return key;
+    return `${router}:__hash:${fnv1a64(normalized)}`;
+}
+// ---------------------------------------------------------------------------
+// Revalidate duration tracking — remembers how long each ISR key's TTL is
+// so we can emit correct Cache-Control headers on cache hits.
+// ---------------------------------------------------------------------------
+const MAX_REVALIDATE_ENTRIES = 10_000;
+const revalidateDurations = new Map();
+/**
+ * Store the revalidate duration for a cache key.
+ * Uses insertion-order LRU eviction to prevent unbounded growth.
+ */
+export function setRevalidateDuration(key, seconds) {
+    // Simple LRU: delete and re-insert to move to end (most recent)
+    revalidateDurations.delete(key);
+    revalidateDurations.set(key, seconds);
+    // Evict oldest entries if over limit
+    while (revalidateDurations.size > MAX_REVALIDATE_ENTRIES) {
+        const first = revalidateDurations.keys().next().value;
+        if (first !== undefined)
+            revalidateDurations.delete(first);
+        else
+            break;
+    }
+}
+/**
+ * Get the revalidate duration for a cache key.
+ */
+export function getRevalidateDuration(key) {
+    return revalidateDurations.get(key);
+}
+//# sourceMappingURL=isr-cache.js.map

package/dist/server/isr-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isr-cache.js","sourceRoot":"","sources":["../../src/server/isr-cache.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ISR (Incremental Static Regeneration) cache layer.\n *\n * Wraps the pluggable CacheHandler with stale-while-revalidate semantics:\n * - Fresh hit: serve immediately\n * - Stale hit: serve immediately + trigger background regeneration\n * - Miss: render synchronously, cache, serve\n *\n * Background regeneration is deduped — only one regeneration per cache key\n * runs at a time, preventing thundering herd on popular pages.\n *\n * This layer works with any CacheHandler backend (memory, Redis, KV, etc.)\n * because it only uses the standard get/set interface.\n */\n\nimport {\n  getCacheHandler,\n  type CacheHandlerValue,\n  type IncrementalCacheValue,\n  type CachedPagesValue,\n  type CachedAppPageValue,\n} from \"../shims/cache.js\";\nimport { fnv1a64 } from \"../utils/hash.js\";\n\nexport interface ISRCacheEntry {\n  value: CacheHandlerValue;\n  isStale: boolean;\n}\n\n/**\n * Get a cache entry with staleness information.\n *\n * Returns { value, isStale: false } for fresh entries,\n * { value, isStale: true } for expired-but-usable entries,\n * or null for cache misses.\n */\nexport async function isrGet(key: string): Promise<ISRCacheEntry | null> {\n  const handler = getCacheHandler();\n  const result = await handler.get(key);\n  if (!result || !result.value) return null;\n\n  return {\n    value: result,\n    isStale: result.cacheState === \"stale\",\n  };\n}\n\n/**\n * Store a value in the ISR cache with a revalidation period.\n */\nexport async function isrSet(\n  key: string,\n  data: IncrementalCacheValue,\n  revalidateSeconds: number,\n  tags?: string[],\n): Promise<void> {\n  const handler = getCacheHandler();\n  await handler.set(key, data, {\n    revalidate: revalidateSeconds,\n    tags: tags ?? [],\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Background regeneration dedup\n// ---------------------------------------------------------------------------\n\nconst pendingRegenerations = new Map<string, Promise<void>>();\n\n/**\n * Trigger a background regeneration for a cache key.\n *\n * If a regeneration for this key is already in progress, this is a no-op.\n * The renderFn should produce the new cache value and call isrSet internally.\n */\nexport function triggerBackgroundRegeneration(\n  key: string,\n  renderFn: () => Promise<void>,\n): void {\n  if (pendingRegenerations.has(key)) return;\n\n  const promise = renderFn()\n    .catch((err) => {\n      console.error(`[vinext] ISR background regeneration failed for ${key}:`, err);\n    })\n    .finally(() => {\n      pendingRegenerations.delete(key);\n    });\n\n  pendingRegenerations.set(key, promise);\n}\n\n// ---------------------------------------------------------------------------\n// Helpers for building ISR cache values\n// ---------------------------------------------------------------------------\n\n/**\n * Build a CachedPagesValue for the Pages Router ISR cache.\n */\nexport function buildPagesCacheValue(\n  html: string,\n  pageData: object,\n  status?: number,\n): CachedPagesValue {\n  return {\n    kind: \"PAGES\",\n    html,\n    pageData,\n    headers: undefined,\n    status,\n  };\n}\n\n/**\n * Build a CachedAppPageValue for the App Router ISR cache.\n */\nexport function buildAppPageCacheValue(\n  html: string,\n  rscData?: ArrayBuffer,\n  status?: number,\n): CachedAppPageValue {\n  return {\n    kind: \"APP_PAGE\",\n    html,\n    rscData,\n    headers: undefined,\n    postponed: undefined,\n    status,\n  };\n}\n\n/**\n * Compute an ISR cache key for a given router type and pathname.\n * Long pathnames are hashed to stay within KV key-length limits (512 bytes).\n */\nexport function isrCacheKey(router: \"pages\" | \"app\", pathname: string): string {\n  const normalized = pathname === \"/\" ? \"/\" : pathname.replace(/\\/$/, \"\");\n  const key = `${router}:${normalized}`;\n  if (key.length <= 200) return key;\n  return `${router}:__hash:${fnv1a64(normalized)}`;\n}\n\n// ---------------------------------------------------------------------------\n// Revalidate duration tracking — remembers how long each ISR key's TTL is\n// so we can emit correct Cache-Control headers on cache hits.\n// ---------------------------------------------------------------------------\n\nconst MAX_REVALIDATE_ENTRIES = 10_000;\nconst revalidateDurations = new Map<string, number>();\n\n/**\n * Store the revalidate duration for a cache key.\n * Uses insertion-order LRU eviction to prevent unbounded growth.\n */\nexport function setRevalidateDuration(key: string, seconds: number): void {\n  // Simple LRU: delete and re-insert to move to end (most recent)\n  revalidateDurations.delete(key);\n  revalidateDurations.set(key, seconds);\n  // Evict oldest entries if over limit\n  while (revalidateDurations.size > MAX_REVALIDATE_ENTRIES) {\n    const first = revalidateDurations.keys().next().value;\n    if (first !== undefined) revalidateDurations.delete(first);\n    else break;\n  }\n}\n\n/**\n * Get the revalidate duration for a cache key.\n */\nexport function getRevalidateDuration(key: string): number | undefined {\n  return revalidateDurations.get(key);\n}\n"]}

package/dist/server/metadata-routes.d.ts

@@ -0,0 +1,103 @@
+export interface SitemapEntry {
+    url: string;
+    lastModified?: string | Date;
+    changeFrequency?: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+    priority?: number;
+    alternates?: {
+        languages?: Record<string, string>;
+    };
+    images?: string[];
+    videos?: Array<{
+        title: string;
+        thumbnail_loc: string;
+        description: string;
+        content_loc?: string;
+        player_loc?: string;
+        duration?: number;
+        expiration_date?: string;
+        rating?: number;
+        view_count?: number;
+        publication_date?: string;
+        family_friendly?: "yes" | "no";
+        restriction?: {
+            relationship: "allow" | "deny";
+            content: string;
+        };
+        platform?: {
+            relationship: "allow" | "deny";
+            content: string;
+        };
+        live?: "yes" | "no";
+    }>;
+}
+export interface RobotsRule {
+    userAgent?: string | string[];
+    allow?: string | string[];
+    disallow?: string | string[];
+    crawlDelay?: number;
+}
+export interface RobotsConfig {
+    rules: RobotsRule | RobotsRule[];
+    sitemap?: string | string[];
+    host?: string;
+}
+export interface ManifestConfig {
+    name?: string;
+    short_name?: string;
+    description?: string;
+    start_url?: string;
+    display?: "fullscreen" | "standalone" | "minimal-ui" | "browser";
+    background_color?: string;
+    theme_color?: string;
+    icons?: Array<{
+        src: string;
+        sizes?: string;
+        type?: string;
+        purpose?: string;
+    }>;
+    [key: string]: unknown;
+}
+/** Map of metadata file base names to their URL path and content type. */
+export declare const METADATA_FILE_MAP: Record<string, {
+    /** URL path this file is served at */
+    urlPath: string;
+    /** Content type for the response */
+    contentType: string;
+    /** Whether this can be dynamic (.ts/.tsx/.js) */
+    canBeDynamic: boolean;
+    /** File extensions for static variants */
+    staticExtensions: string[];
+    /** File extensions for dynamic variants */
+    dynamicExtensions: string[];
+    /** Whether this can be nested in sub-segments */
+    nestable: boolean;
+}>;
+/**
+ * Convert a sitemap array to XML string.
+ */
+export declare function sitemapToXml(entries: SitemapEntry[]): string;
+/**
+ * Convert a robots config to text format.
+ */
+export declare function robotsToText(config: RobotsConfig): string;
+/**
+ * Convert a manifest config to JSON string.
+ */
+export declare function manifestToJson(config: ManifestConfig): string;
+export interface MetadataFileRoute {
+    /** Type of metadata file */
+    type: string;
+    /** Whether this is a dynamic (code-generated) route */
+    isDynamic: boolean;
+    /** Absolute file path */
+    filePath: string;
+    /** URL path this file is served at */
+    servedUrl: string;
+    /** Content type for the response */
+    contentType: string;
+}
+/**
+ * Scan an app directory for metadata files.
+ */
+export declare function scanMetadataFiles(appDir: string): MetadataFileRoute[];
+//# sourceMappingURL=metadata-routes.d.ts.map

package/dist/server/metadata-routes.d.ts.map

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

package/dist/server/metadata-routes.js

@@ -0,0 +1,270 @@
+/**
+ * File-based metadata route handling.
+ *
+ * Next.js supports special files in the app/ directory that auto-generate
+ * metadata routes:
+ *   - sitemap.ts/.xml → /sitemap.xml (application/xml)
+ *   - robots.ts/.txt  → /robots.txt  (text/plain)
+ *   - manifest.ts/.json/.webmanifest → /manifest.webmanifest (application/manifest+json)
+ *   - icon.tsx/.png   → /icon (image/*)
+ *   - opengraph-image.tsx/.png → /opengraph-image (image/*)
+ *   - twitter-image.tsx/.png → /twitter-image (image/*)
+ *   - apple-icon.tsx/.png → /apple-icon (image/*)
+ *   - favicon.ico → /favicon.ico (image/x-icon)
+ *
+ * Dynamic versions (ts/tsx/js) export a default function that returns the data.
+ * Static versions (xml/txt/json/png/etc.) are served as-is.
+ */
+import fs from "node:fs";
+import path from "node:path";
+// -------------------------------------------------------------------
+// Known metadata file patterns
+// -------------------------------------------------------------------
+/** Map of metadata file base names to their URL path and content type. */
+export const METADATA_FILE_MAP = {
+    sitemap: {
+        urlPath: "/sitemap.xml",
+        contentType: "application/xml",
+        canBeDynamic: true,
+        staticExtensions: [".xml"],
+        dynamicExtensions: [".ts", ".js"],
+        nestable: true,
+    },
+    robots: {
+        urlPath: "/robots.txt",
+        contentType: "text/plain",
+        canBeDynamic: true,
+        staticExtensions: [".txt"],
+        dynamicExtensions: [".ts", ".js"],
+        nestable: false,
+    },
+    manifest: {
+        urlPath: "/manifest.webmanifest",
+        contentType: "application/manifest+json",
+        canBeDynamic: true,
+        staticExtensions: [".json", ".webmanifest"],
+        dynamicExtensions: [".ts", ".js"],
+        nestable: false,
+    },
+    favicon: {
+        urlPath: "/favicon.ico",
+        contentType: "image/x-icon",
+        canBeDynamic: false,
+        staticExtensions: [".ico"],
+        dynamicExtensions: [],
+        nestable: false,
+    },
+    icon: {
+        urlPath: "/icon",
+        contentType: "image/png",
+        canBeDynamic: true,
+        staticExtensions: [".ico", ".jpg", ".jpeg", ".png", ".svg"],
+        dynamicExtensions: [".ts", ".tsx", ".js"],
+        nestable: true,
+    },
+    "opengraph-image": {
+        urlPath: "/opengraph-image",
+        contentType: "image/png",
+        canBeDynamic: true,
+        staticExtensions: [".jpg", ".jpeg", ".png", ".gif"],
+        dynamicExtensions: [".ts", ".tsx", ".js"],
+        nestable: true,
+    },
+    "twitter-image": {
+        urlPath: "/twitter-image",
+        contentType: "image/png",
+        canBeDynamic: true,
+        staticExtensions: [".jpg", ".jpeg", ".png", ".gif"],
+        dynamicExtensions: [".ts", ".tsx", ".js"],
+        nestable: true,
+    },
+    "apple-icon": {
+        urlPath: "/apple-icon",
+        contentType: "image/png",
+        canBeDynamic: true,
+        staticExtensions: [".jpg", ".jpeg", ".png"],
+        dynamicExtensions: [".ts", ".tsx", ".js"],
+        nestable: true,
+    },
+};
+// -------------------------------------------------------------------
+// Serializers
+// -------------------------------------------------------------------
+/**
+ * Convert a sitemap array to XML string.
+ */
+export function sitemapToXml(entries) {
+    const lines = [
+        '<?xml version="1.0" encoding="UTF-8"?>',
+        '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">',
+    ];
+    for (const entry of entries) {
+        lines.push("  <url>");
+        lines.push(`    <loc>${escapeXml(entry.url)}</loc>`);
+        if (entry.lastModified) {
+            const date = entry.lastModified instanceof Date
+                ? entry.lastModified.toISOString()
+                : entry.lastModified;
+            lines.push(`    <lastmod>${escapeXml(date)}</lastmod>`);
+        }
+        if (entry.changeFrequency) {
+            lines.push(`    <changefreq>${escapeXml(entry.changeFrequency)}</changefreq>`);
+        }
+        if (entry.priority !== undefined) {
+            lines.push(`    <priority>${entry.priority}</priority>`);
+        }
+        if (entry.images) {
+            for (const image of entry.images) {
+                lines.push("    <image:image>");
+                lines.push(`      <image:loc>${escapeXml(image)}</image:loc>`);
+                lines.push("    </image:image>");
+            }
+        }
+        lines.push("  </url>");
+    }
+    lines.push("</urlset>");
+    return lines.join("\n");
+}
+/**
+ * Convert a robots config to text format.
+ */
+export function robotsToText(config) {
+    const lines = [];
+    const rules = Array.isArray(config.rules) ? config.rules : [config.rules];
+    for (const rule of rules) {
+        const agents = Array.isArray(rule.userAgent)
+            ? rule.userAgent
+            : [rule.userAgent ?? "*"];
+        for (const agent of agents) {
+            lines.push(`User-Agent: ${agent}`);
+        }
+        if (rule.allow) {
+            const allows = Array.isArray(rule.allow) ? rule.allow : [rule.allow];
+            for (const allow of allows) {
+                lines.push(`Allow: ${allow}`);
+            }
+        }
+        if (rule.disallow) {
+            const disallows = Array.isArray(rule.disallow)
+                ? rule.disallow
+                : [rule.disallow];
+            for (const disallow of disallows) {
+                lines.push(`Disallow: ${disallow}`);
+            }
+        }
+        if (rule.crawlDelay !== undefined) {
+            lines.push(`Crawl-delay: ${rule.crawlDelay}`);
+        }
+        lines.push("");
+    }
+    if (config.sitemap) {
+        const sitemaps = Array.isArray(config.sitemap)
+            ? config.sitemap
+            : [config.sitemap];
+        for (const sitemap of sitemaps) {
+            lines.push(`Sitemap: ${sitemap}`);
+        }
+    }
+    if (config.host) {
+        lines.push(`Host: ${config.host}`);
+    }
+    return lines.join("\n").trim() + "\n";
+}
+/**
+ * Convert a manifest config to JSON string.
+ */
+export function manifestToJson(config) {
+    return JSON.stringify(config, null, 2);
+}
+function escapeXml(s) {
+    return s
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+/**
+ * Scan an app directory for metadata files.
+ */
+export function scanMetadataFiles(appDir) {
+    const routes = [];
+    // Scan the app directory recursively
+    function scan(dir, urlPrefix) {
+        if (!fs.existsSync(dir))
+            return;
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                // Skip route group parentheses from URL
+                const dirName = entry.name;
+                const isRouteGroup = dirName.startsWith("(") && dirName.endsWith(")");
+                const nextUrlPrefix = isRouteGroup
+                    ? urlPrefix
+                    : `${urlPrefix}/${dirName}`;
+                scan(path.join(dir, dirName), nextUrlPrefix);
+                continue;
+            }
+            // Check each metadata file pattern
+            const fileName = entry.name;
+            const baseName = fileName.replace(/\.[^.]+$/, "");
+            const ext = fileName.slice(baseName.length);
+            for (const [metaType, config] of Object.entries(METADATA_FILE_MAP)) {
+                // Check if the base name matches
+                if (baseName !== metaType)
+                    continue;
+                // Check nestability — non-nestable types only at root
+                if (!config.nestable && urlPrefix !== "")
+                    continue;
+                // Check if this is a static or dynamic variant
+                const isStatic = config.staticExtensions.includes(ext);
+                const isDynamic = config.dynamicExtensions.includes(ext);
+                if (!isStatic && !isDynamic)
+                    continue;
+                routes.push({
+                    type: metaType,
+                    isDynamic,
+                    filePath: path.join(dir, fileName),
+                    servedUrl: urlPrefix === ""
+                        ? config.urlPath
+                        : `${urlPrefix}${config.urlPath}`,
+                    contentType: isStatic
+                        ? getStaticContentType(ext, config.contentType)
+                        : config.contentType,
+                });
+            }
+        }
+    }
+    scan(appDir, "");
+    // Deduplicate: if both dynamic and static variants exist at the same URL,
+    // keep only the dynamic one (matches Next.js behavior).
+    const byUrl = new Map();
+    for (const route of routes) {
+        const existing = byUrl.get(route.servedUrl);
+        if (!existing) {
+            byUrl.set(route.servedUrl, route);
+        }
+        else if (route.isDynamic && !existing.isDynamic) {
+            // Dynamic takes priority over static
+            byUrl.set(route.servedUrl, route);
+        }
+        // If both are static or both dynamic, keep the first one found
+    }
+    return Array.from(byUrl.values());
+}
+function getStaticContentType(ext, fallback) {
+    const map = {
+        ".xml": "application/xml",
+        ".txt": "text/plain",
+        ".json": "application/json",
+        ".webmanifest": "application/manifest+json",
+        ".ico": "image/x-icon",
+        ".png": "image/png",
+        ".jpg": "image/jpeg",
+        ".jpeg": "image/jpeg",
+        ".gif": "image/gif",
+        ".svg": "image/svg+xml",
+    };
+    return map[ext] ?? fallback;
+}
+//# sourceMappingURL=metadata-routes.js.map

package/dist/server/metadata-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-routes.js","sourceRoot":"","sources":["../../src/server/metadata-routes.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * File-based metadata route handling.\n *\n * Next.js supports special files in the app/ directory that auto-generate\n * metadata routes:\n *   - sitemap.ts/.xml → /sitemap.xml (application/xml)\n *   - robots.ts/.txt  → /robots.txt  (text/plain)\n *   - manifest.ts/.json/.webmanifest → /manifest.webmanifest (application/manifest+json)\n *   - icon.tsx/.png   → /icon (image/*)\n *   - opengraph-image.tsx/.png → /opengraph-image (image/*)\n *   - twitter-image.tsx/.png → /twitter-image (image/*)\n *   - apple-icon.tsx/.png → /apple-icon (image/*)\n *   - favicon.ico → /favicon.ico (image/x-icon)\n *\n * Dynamic versions (ts/tsx/js) export a default function that returns the data.\n * Static versions (xml/txt/json/png/etc.) are served as-is.\n */\nimport fs from \"node:fs\";\nimport path from \"node:path\";\n\n// -------------------------------------------------------------------\n// Types matching Next.js MetadataRoute\n// -------------------------------------------------------------------\n\nexport interface SitemapEntry {\n  url: string;\n  lastModified?: string | Date;\n  changeFrequency?:\n    | \"always\"\n    | \"hourly\"\n    | \"daily\"\n    | \"weekly\"\n    | \"monthly\"\n    | \"yearly\"\n    | \"never\";\n  priority?: number;\n  alternates?: {\n    languages?: Record<string, string>;\n  };\n  images?: string[];\n  videos?: Array<{\n    title: string;\n    thumbnail_loc: string;\n    description: string;\n    content_loc?: string;\n    player_loc?: string;\n    duration?: number;\n    expiration_date?: string;\n    rating?: number;\n    view_count?: number;\n    publication_date?: string;\n    family_friendly?: \"yes\" | \"no\";\n    restriction?: { relationship: \"allow\" | \"deny\"; content: string };\n    platform?: { relationship: \"allow\" | \"deny\"; content: string };\n    live?: \"yes\" | \"no\";\n  }>;\n}\n\nexport interface RobotsRule {\n  userAgent?: string | string[];\n  allow?: string | string[];\n  disallow?: string | string[];\n  crawlDelay?: number;\n}\n\nexport interface RobotsConfig {\n  rules: RobotsRule | RobotsRule[];\n  sitemap?: string | string[];\n  host?: string;\n}\n\nexport interface ManifestConfig {\n  name?: string;\n  short_name?: string;\n  description?: string;\n  start_url?: string;\n  display?: \"fullscreen\" | \"standalone\" | \"minimal-ui\" | \"browser\";\n  background_color?: string;\n  theme_color?: string;\n  icons?: Array<{\n    src: string;\n    sizes?: string;\n    type?: string;\n    purpose?: string;\n  }>;\n  [key: string]: unknown;\n}\n\n// -------------------------------------------------------------------\n// Known metadata file patterns\n// -------------------------------------------------------------------\n\n/** Map of metadata file base names to their URL path and content type. */\nexport const METADATA_FILE_MAP: Record<\n  string,\n  {\n    /** URL path this file is served at */\n    urlPath: string;\n    /** Content type for the response */\n    contentType: string;\n    /** Whether this can be dynamic (.ts/.tsx/.js) */\n    canBeDynamic: boolean;\n    /** File extensions for static variants */\n    staticExtensions: string[];\n    /** File extensions for dynamic variants */\n    dynamicExtensions: string[];\n    /** Whether this can be nested in sub-segments */\n    nestable: boolean;\n  }\n> = {\n  sitemap: {\n    urlPath: \"/sitemap.xml\",\n    contentType: \"application/xml\",\n    canBeDynamic: true,\n    staticExtensions: [\".xml\"],\n    dynamicExtensions: [\".ts\", \".js\"],\n    nestable: true,\n  },\n  robots: {\n    urlPath: \"/robots.txt\",\n    contentType: \"text/plain\",\n    canBeDynamic: true,\n    staticExtensions: [\".txt\"],\n    dynamicExtensions: [\".ts\", \".js\"],\n    nestable: false,\n  },\n  manifest: {\n    urlPath: \"/manifest.webmanifest\",\n    contentType: \"application/manifest+json\",\n    canBeDynamic: true,\n    staticExtensions: [\".json\", \".webmanifest\"],\n    dynamicExtensions: [\".ts\", \".js\"],\n    nestable: false,\n  },\n  favicon: {\n    urlPath: \"/favicon.ico\",\n    contentType: \"image/x-icon\",\n    canBeDynamic: false,\n    staticExtensions: [\".ico\"],\n    dynamicExtensions: [],\n    nestable: false,\n  },\n  icon: {\n    urlPath: \"/icon\",\n    contentType: \"image/png\",\n    canBeDynamic: true,\n    staticExtensions: [\".ico\", \".jpg\", \".jpeg\", \".png\", \".svg\"],\n    dynamicExtensions: [\".ts\", \".tsx\", \".js\"],\n    nestable: true,\n  },\n  \"opengraph-image\": {\n    urlPath: \"/opengraph-image\",\n    contentType: \"image/png\",\n    canBeDynamic: true,\n    staticExtensions: [\".jpg\", \".jpeg\", \".png\", \".gif\"],\n    dynamicExtensions: [\".ts\", \".tsx\", \".js\"],\n    nestable: true,\n  },\n  \"twitter-image\": {\n    urlPath: \"/twitter-image\",\n    contentType: \"image/png\",\n    canBeDynamic: true,\n    staticExtensions: [\".jpg\", \".jpeg\", \".png\", \".gif\"],\n    dynamicExtensions: [\".ts\", \".tsx\", \".js\"],\n    nestable: true,\n  },\n  \"apple-icon\": {\n    urlPath: \"/apple-icon\",\n    contentType: \"image/png\",\n    canBeDynamic: true,\n    staticExtensions: [\".jpg\", \".jpeg\", \".png\"],\n    dynamicExtensions: [\".ts\", \".tsx\", \".js\"],\n    nestable: true,\n  },\n};\n\n// -------------------------------------------------------------------\n// Serializers\n// -------------------------------------------------------------------\n\n/**\n * Convert a sitemap array to XML string.\n */\nexport function sitemapToXml(entries: SitemapEntry[]): string {\n  const lines = [\n    '<?xml version=\"1.0\" encoding=\"UTF-8\"?>',\n    '<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">',\n  ];\n\n  for (const entry of entries) {\n    lines.push(\"  <url>\");\n    lines.push(`    <loc>${escapeXml(entry.url)}</loc>`);\n\n    if (entry.lastModified) {\n      const date =\n        entry.lastModified instanceof Date\n          ? entry.lastModified.toISOString()\n          : entry.lastModified;\n      lines.push(`    <lastmod>${escapeXml(date)}</lastmod>`);\n    }\n\n    if (entry.changeFrequency) {\n      lines.push(\n        `    <changefreq>${escapeXml(entry.changeFrequency)}</changefreq>`,\n      );\n    }\n\n    if (entry.priority !== undefined) {\n      lines.push(`    <priority>${entry.priority}</priority>`);\n    }\n\n    if (entry.images) {\n      for (const image of entry.images) {\n        lines.push(\"    <image:image>\");\n        lines.push(`      <image:loc>${escapeXml(image)}</image:loc>`);\n        lines.push(\"    </image:image>\");\n      }\n    }\n\n    lines.push(\"  </url>\");\n  }\n\n  lines.push(\"</urlset>\");\n  return lines.join(\"\\n\");\n}\n\n/**\n * Convert a robots config to text format.\n */\nexport function robotsToText(config: RobotsConfig): string {\n  const lines: string[] = [];\n  const rules = Array.isArray(config.rules) ? config.rules : [config.rules];\n\n  for (const rule of rules) {\n    const agents = Array.isArray(rule.userAgent)\n      ? rule.userAgent\n      : [rule.userAgent ?? \"*\"];\n\n    for (const agent of agents) {\n      lines.push(`User-Agent: ${agent}`);\n    }\n\n    if (rule.allow) {\n      const allows = Array.isArray(rule.allow) ? rule.allow : [rule.allow];\n      for (const allow of allows) {\n        lines.push(`Allow: ${allow}`);\n      }\n    }\n\n    if (rule.disallow) {\n      const disallows = Array.isArray(rule.disallow)\n        ? rule.disallow\n        : [rule.disallow];\n      for (const disallow of disallows) {\n        lines.push(`Disallow: ${disallow}`);\n      }\n    }\n\n    if (rule.crawlDelay !== undefined) {\n      lines.push(`Crawl-delay: ${rule.crawlDelay}`);\n    }\n\n    lines.push(\"\");\n  }\n\n  if (config.sitemap) {\n    const sitemaps = Array.isArray(config.sitemap)\n      ? config.sitemap\n      : [config.sitemap];\n    for (const sitemap of sitemaps) {\n      lines.push(`Sitemap: ${sitemap}`);\n    }\n  }\n\n  if (config.host) {\n    lines.push(`Host: ${config.host}`);\n  }\n\n  return lines.join(\"\\n\").trim() + \"\\n\";\n}\n\n/**\n * Convert a manifest config to JSON string.\n */\nexport function manifestToJson(config: ManifestConfig): string {\n  return JSON.stringify(config, null, 2);\n}\n\nfunction escapeXml(s: string): string {\n  return s\n    .replace(/&/g, \"&amp;\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\")\n    .replace(/\"/g, \"&quot;\")\n    .replace(/'/g, \"&apos;\");\n}\n\n// -------------------------------------------------------------------\n// Metadata route discovery\n// -------------------------------------------------------------------\n\nexport interface MetadataFileRoute {\n  /** Type of metadata file */\n  type: string;\n  /** Whether this is a dynamic (code-generated) route */\n  isDynamic: boolean;\n  /** Absolute file path */\n  filePath: string;\n  /** URL path this file is served at */\n  servedUrl: string;\n  /** Content type for the response */\n  contentType: string;\n}\n\n/**\n * Scan an app directory for metadata files.\n */\nexport function scanMetadataFiles(appDir: string): MetadataFileRoute[] {\n  const routes: MetadataFileRoute[] = [];\n\n  // Scan the app directory recursively\n  function scan(dir: string, urlPrefix: string): void {\n    if (!fs.existsSync(dir)) return;\n\n    const entries = fs.readdirSync(dir, { withFileTypes: true });\n    for (const entry of entries) {\n      if (entry.isDirectory()) {\n        // Skip route group parentheses from URL\n        const dirName = entry.name;\n        const isRouteGroup = dirName.startsWith(\"(\") && dirName.endsWith(\")\");\n        const nextUrlPrefix = isRouteGroup\n          ? urlPrefix\n          : `${urlPrefix}/${dirName}`;\n        scan(path.join(dir, dirName), nextUrlPrefix);\n        continue;\n      }\n\n      // Check each metadata file pattern\n      const fileName = entry.name;\n      const baseName = fileName.replace(/\\.[^.]+$/, \"\");\n      const ext = fileName.slice(baseName.length);\n\n      for (const [metaType, config] of Object.entries(METADATA_FILE_MAP)) {\n        // Check if the base name matches\n        if (baseName !== metaType) continue;\n\n        // Check nestability — non-nestable types only at root\n        if (!config.nestable && urlPrefix !== \"\") continue;\n\n        // Check if this is a static or dynamic variant\n        const isStatic = config.staticExtensions.includes(ext);\n        const isDynamic = config.dynamicExtensions.includes(ext);\n\n        if (!isStatic && !isDynamic) continue;\n\n        routes.push({\n          type: metaType,\n          isDynamic,\n          filePath: path.join(dir, fileName),\n          servedUrl:\n            urlPrefix === \"\"\n              ? config.urlPath\n              : `${urlPrefix}${config.urlPath}`,\n          contentType: isStatic\n            ? getStaticContentType(ext, config.contentType)\n            : config.contentType,\n        });\n      }\n    }\n  }\n\n  scan(appDir, \"\");\n\n  // Deduplicate: if both dynamic and static variants exist at the same URL,\n  // keep only the dynamic one (matches Next.js behavior).\n  const byUrl = new Map<string, MetadataFileRoute>();\n  for (const route of routes) {\n    const existing = byUrl.get(route.servedUrl);\n    if (!existing) {\n      byUrl.set(route.servedUrl, route);\n    } else if (route.isDynamic && !existing.isDynamic) {\n      // Dynamic takes priority over static\n      byUrl.set(route.servedUrl, route);\n    }\n    // If both are static or both dynamic, keep the first one found\n  }\n  return Array.from(byUrl.values());\n}\n\nfunction getStaticContentType(ext: string, fallback: string): string {\n  const map: Record<string, string> = {\n    \".xml\": \"application/xml\",\n    \".txt\": \"text/plain\",\n    \".json\": \"application/json\",\n    \".webmanifest\": \"application/manifest+json\",\n    \".ico\": \"image/x-icon\",\n    \".png\": \"image/png\",\n    \".jpg\": \"image/jpeg\",\n    \".jpeg\": \"image/jpeg\",\n    \".gif\": \"image/gif\",\n    \".svg\": \"image/svg+xml\",\n  };\n  return map[ext] ?? fallback;\n}\n"]}

package/dist/server/middleware.d.ts

@@ -0,0 +1,77 @@
+/**
+ * proxy.ts / middleware.ts runner
+ *
+ * Loads and executes the user's proxy.ts (Next.js 16) or middleware.ts file
+ * before routing. Runs in Node (not Edge Runtime), per the vinext design.
+ *
+ * In Next.js 16, proxy.ts replaces middleware.ts:
+ * - proxy.ts: default export function, runs on Node.js runtime
+ * - middleware.ts: deprecated but still supported for Edge runtime use cases
+ *
+ * The proxy/middleware receives a NextRequest and can:
+ * - Return NextResponse.next() to continue to the route
+ * - Return NextResponse.redirect() to redirect
+ * - Return NextResponse.rewrite() to rewrite the URL
+ * - Set/modify headers and cookies
+ * - Return a Response directly (e.g., for auth guards)
+ *
+ * Supports the `config.matcher` export for path filtering.
+ */
+import type { ViteDevServer } from "vite";
+/**
+ * Find the proxy or middleware file in the project root.
+ * Checks for proxy.ts (Next.js 16) first, then falls back to middleware.ts.
+ * If middleware.ts is found, logs a deprecation warning.
+ */
+export declare function findMiddlewareFile(root: string): string | null;
+/** Matcher pattern from middleware config export. */
+type MatcherConfig = string | string[] | {
+    source: string;
+    regexp?: string;
+    locale?: boolean;
+    has?: any[];
+    missing?: any[];
+}[];
+/**
+ * Check if a pathname matches the middleware matcher config.
+ * If no matcher is configured, middleware runs on all paths
+ * except static files and internal Next.js paths.
+ */
+export declare function matchesMiddleware(pathname: string, matcher: MatcherConfig | undefined): boolean;
+/**
+ * Match a single pattern against a pathname.
+ * Supports Next.js matcher patterns:
+ *   /about          -> exact match
+ *   /dashboard/:path*  -> prefix match with params
+ *   /api/:path+     -> one or more segments
+ *   /((?!api|_next).*)  -> regex patterns
+ */
+export declare function matchPattern(pathname: string, pattern: string): boolean;
+/** Result of running middleware. */
+export interface MiddlewareResult {
+    /** Whether to continue to the route handler. */
+    continue: boolean;
+    /** If set, redirect to this URL. */
+    redirectUrl?: string;
+    /** HTTP status for redirect (default 307). */
+    redirectStatus?: number;
+    /** If set, rewrite to this URL (internal). */
+    rewriteUrl?: string;
+    /** HTTP status for rewrite (e.g. 403 from NextResponse.rewrite(url, { status: 403 })). */
+    rewriteStatus?: number;
+    /** Headers to set on the response. */
+    responseHeaders?: Headers;
+    /** If the middleware returned a full Response, use it directly. */
+    response?: Response;
+}
+/**
+ * Load and execute middleware for a given request.
+ *
+ * @param server - Vite dev server (for SSR module loading)
+ * @param middlewarePath - Absolute path to the middleware file
+ * @param request - The incoming Request object
+ * @returns Middleware result describing what action to take
+ */
+export declare function runMiddleware(server: ViteDevServer, middlewarePath: string, request: Request): Promise<MiddlewareResult>;
+export {};
+//# sourceMappingURL=middleware.d.ts.map

package/dist/server/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/server/middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AA8B1C;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqB9D;AAED,qDAAqD;AACrD,KAAK,aAAa,GACd,MAAM,GACN,MAAM,EAAE,GACR;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,GAAG,EAAE,CAAA;CAAE,EAAE,CAAC;AAE1F;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,aAAa,GAAG,SAAS,GACjC,OAAO,CAyBT;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAwBvE;AAED,oCAAoC;AACpC,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,QAAQ,EAAE,OAAO,CAAC;IAClB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0FAA0F;IAC1F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,aAAa,EACrB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,gBAAgB,CAAC,CAiG3B"}