next-ai-discovery 0.1.0

package/dist/markdown-route.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-route.d.ts","sourceRoot":"","sources":["../src/markdown-route.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,CACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,KACjB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,eAAe,GAAG,IAAI,CAAC;AAE9D,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,EAAE,WAAW,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAClE,CAAC;AAmCF,eAAO,MAAM,mBAAmB,GAAI,SAAS,oBAAoB,MAGjD,SAAS,WAAW,sBA6BnC,CAAC"}

package/dist/markdown-route.d.ts

@@ -0,0 +1,16 @@
+import type { NextRequest } from 'next/server.js';
+export type MarkdownContent = {
+    body: string;
+    frontmatter?: Record<string, unknown>;
+};
+export type GetMarkdown = (pathname: string, request: NextRequest) => Promise<MarkdownContent | null> | MarkdownContent | null;
+export type MarkdownRouteOptions = {
+    getMarkdown: GetMarkdown;
+    includeFrontmatter?: boolean;
+    onServed?: (event: {
+        pathname: string;
+        status: number;
+    }) => void;
+};
+export declare const createMarkdownRoute: (options: MarkdownRouteOptions) => (request: NextRequest) => Promise<Response>;
+//# sourceMappingURL=markdown-route.d.ts.map

package/dist/markdown-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-route.d.ts","sourceRoot":"","sources":["../src/markdown-route.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,CACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,KACjB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,eAAe,GAAG,IAAI,CAAC;AAE9D,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,EAAE,WAAW,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAClE,CAAC;AAmCF,eAAO,MAAM,mBAAmB,GAAI,SAAS,oBAAoB,MAGjD,SAAS,WAAW,sBA6BnC,CAAC"}

package/dist/markdown-route.js

@@ -0,0 +1,55 @@
+import { normalizePathname } from "./pathname.js";
+const DEFAULT_HEADERS = {
+    'Content-Type': 'text/markdown; charset=utf-8',
+    Vary: 'Accept',
+};
+const toFrontmatter = (frontmatter) => {
+    const lines = ['---'];
+    for (const [key, value] of Object.entries(frontmatter)) {
+        lines.push(`${key}: ${JSON.stringify(value)}`);
+    }
+    lines.push('---');
+    return lines.join('\n');
+};
+const buildBody = (content, includeFrontmatter) => {
+    if (!(includeFrontmatter && content.frontmatter)) {
+        return content.body;
+    }
+    return `${toFrontmatter(content.frontmatter)}\n\n${content.body}`;
+};
+const handleError = (error) => {
+    console.error('[next-ai-discovery] markdown route error', error);
+    return new Response('Internal Server Error', {
+        status: 500,
+        headers: DEFAULT_HEADERS,
+    });
+};
+export const createMarkdownRoute = (options) => {
+    const includeFrontmatter = options.includeFrontmatter ?? true;
+    return async (request) => {
+        const url = new URL(request.url);
+        const rawPath = url.searchParams.get('path') ?? '/';
+        const pathname = normalizePathname(rawPath);
+        try {
+            const content = await options.getMarkdown(pathname, request);
+            const isHead = request.method === 'HEAD';
+            if (!content) {
+                options.onServed?.({ pathname, status: 404 });
+                return new Response(isHead ? null : 'Not Found', {
+                    status: 404,
+                    headers: DEFAULT_HEADERS,
+                });
+            }
+            const body = buildBody(content, includeFrontmatter);
+            options.onServed?.({ pathname, status: 200 });
+            return new Response(isHead ? null : body, {
+                status: 200,
+                headers: DEFAULT_HEADERS,
+            });
+        }
+        catch (error) {
+            options.onServed?.({ pathname, status: 500 });
+            return handleError(error);
+        }
+    };
+};

package/dist/metadata.cjs

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withMarkdownAlternate = void 0;
+const pathname_js_1 = require("./pathname.cjs");
+const mergeMarkdownAlternate = (metadata, mdPath) => {
+    const alternates = metadata.alternates ?? {};
+    const types = alternates.types ?? {};
+    return {
+        ...metadata,
+        alternates: {
+            ...alternates,
+            types: {
+                ...types,
+                'text/markdown': mdPath,
+            },
+        },
+    };
+};
+const withMarkdownAlternate = (metadata, pathname, options = {}) => {
+    if (options.shouldAdd === false) {
+        return metadata;
+    }
+    const mdPath = (0, pathname_js_1.pathnameToMd)(pathname);
+    return mergeMarkdownAlternate(metadata, mdPath);
+};
+exports.withMarkdownAlternate = withMarkdownAlternate;

package/dist/metadata.d.cts

@@ -0,0 +1,57 @@
+import type { Metadata } from 'next';
+export type MarkdownAlternateOptions = {
+    shouldAdd?: boolean;
+};
+export declare const withMarkdownAlternate: (metadata: Metadata, pathname: string, options?: MarkdownAlternateOptions) => Metadata | {
+    alternates: {
+        types: {
+            'text/markdown': string;
+        };
+        canonical?: null | string | URL | import("next/dist/lib/metadata/types/alternative-urls-types.js").AlternateLinkDescriptor | undefined;
+        languages?: import("next/dist/lib/metadata/types/alternative-urls-types.js").Languages<null | string | URL | import("next/dist/lib/metadata/types/alternative-urls-types.js").AlternateLinkDescriptor[]> | undefined;
+        media?: {
+            [media: string]: null | string | URL | import("next/dist/lib/metadata/types/alternative-urls-types.js").AlternateLinkDescriptor[];
+        } | undefined;
+    };
+    metadataBase?: null | string | URL | undefined;
+    title?: null | string | import("next/dist/lib/metadata/types/metadata-types.js").TemplateString | undefined;
+    description?: null | string | undefined;
+    applicationName?: null | string | undefined;
+    authors?: null | import("next/dist/lib/metadata/types/metadata-types.js").Author | Array<import("next/dist/lib/metadata/types/metadata-types.js").Author> | undefined;
+    generator?: null | string | undefined;
+    keywords?: null | string | Array<string> | undefined;
+    referrer?: null | import("next/dist/lib/metadata/types/metadata-types.js").ReferrerEnum | undefined;
+    themeColor?: null | string | import("next/dist/lib/metadata/types/metadata-types.js").ThemeColorDescriptor | import("next/dist/lib/metadata/types/metadata-types.js").ThemeColorDescriptor[] | undefined;
+    colorScheme?: null | import("next/dist/lib/metadata/types/metadata-types.js").ColorSchemeEnum | undefined;
+    viewport?: null | string | import("next/dist/lib/metadata/types/extra-types.js").ViewportLayout | undefined;
+    creator?: null | string | undefined;
+    publisher?: null | string | undefined;
+    robots?: null | string | import("next/dist/lib/metadata/types/metadata-types.js").Robots | undefined;
+    icons?: null | import("next/dist/lib/metadata/types/metadata-types.js").IconURL | Array<import("next/dist/lib/metadata/types/metadata-types.js").Icon> | import("next/dist/lib/metadata/types/metadata-types.js").Icons | undefined;
+    manifest?: null | string | URL | undefined;
+    openGraph?: null | import("next/dist/lib/metadata/types/opengraph-types.js").OpenGraph | undefined;
+    twitter?: null | import("next/dist/lib/metadata/types/twitter-types.js").Twitter | undefined;
+    facebook?: null | import("next/dist/lib/metadata/types/extra-types.js").Facebook | undefined;
+    pinterest?: null | import("next/dist/lib/metadata/types/extra-types.js").Pinterest;
+    verification?: import("next/dist/lib/metadata/types/metadata-types.js").Verification | undefined;
+    appleWebApp?: null | boolean | import("next/dist/lib/metadata/types/extra-types.js").AppleWebApp | undefined;
+    formatDetection?: null | import("next/dist/lib/metadata/types/extra-types.js").FormatDetection | undefined;
+    itunes?: null | import("next/dist/lib/metadata/types/extra-types.js").ItunesApp | undefined;
+    abstract?: null | string | undefined;
+    appLinks?: null | import("next/dist/lib/metadata/types/extra-types.js").AppLinks | undefined;
+    archives?: null | string | Array<string> | undefined;
+    assets?: null | string | Array<string> | undefined;
+    bookmarks?: null | string | Array<string> | undefined;
+    pagination?: {
+        previous?: null | string | URL | undefined;
+        next?: null | string | URL | undefined;
+    };
+    category?: null | string | undefined;
+    classification?: null | string | undefined;
+    other?: ({
+        [name: string]: string | number | Array<string | number>;
+    } & import("next/dist/lib/metadata/types/metadata-types.js").DeprecatedMetadataFields) | undefined;
+    'apple-touch-fullscreen'?: never | undefined;
+    'apple-touch-icon-precomposed'?: never | undefined;
+};
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAErC,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAkBF,eAAO,MAAM,qBAAqB,GAChC,UAAU,QAAQ,EAClB,UAAU,MAAM,EAChB,UAAS,wBAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBASwhb,CAAC;YAA+C,CAAC;;;;;;;;;CADhnb,CAAC"}

package/dist/metadata.d.ts

@@ -0,0 +1,57 @@
+import type { Metadata } from 'next';
+export type MarkdownAlternateOptions = {
+    shouldAdd?: boolean;
+};
+export declare const withMarkdownAlternate: (metadata: Metadata, pathname: string, options?: MarkdownAlternateOptions) => Metadata | {
+    alternates: {
+        types: {
+            'text/markdown': string;
+        };
+        canonical?: null | string | URL | import("next/dist/lib/metadata/types/alternative-urls-types.js").AlternateLinkDescriptor | undefined;
+        languages?: import("next/dist/lib/metadata/types/alternative-urls-types.js").Languages<null | string | URL | import("next/dist/lib/metadata/types/alternative-urls-types.js").AlternateLinkDescriptor[]> | undefined;
+        media?: {
+            [media: string]: null | string | URL | import("next/dist/lib/metadata/types/alternative-urls-types.js").AlternateLinkDescriptor[];
+        } | undefined;
+    };
+    metadataBase?: null | string | URL | undefined;
+    title?: null | string | import("next/dist/lib/metadata/types/metadata-types.js").TemplateString | undefined;
+    description?: null | string | undefined;
+    applicationName?: null | string | undefined;
+    authors?: null | import("next/dist/lib/metadata/types/metadata-types.js").Author | Array<import("next/dist/lib/metadata/types/metadata-types.js").Author> | undefined;
+    generator?: null | string | undefined;
+    keywords?: null | string | Array<string> | undefined;
+    referrer?: null | import("next/dist/lib/metadata/types/metadata-types.js").ReferrerEnum | undefined;
+    themeColor?: null | string | import("next/dist/lib/metadata/types/metadata-types.js").ThemeColorDescriptor | import("next/dist/lib/metadata/types/metadata-types.js").ThemeColorDescriptor[] | undefined;
+    colorScheme?: null | import("next/dist/lib/metadata/types/metadata-types.js").ColorSchemeEnum | undefined;
+    viewport?: null | string | import("next/dist/lib/metadata/types/extra-types.js").ViewportLayout | undefined;
+    creator?: null | string | undefined;
+    publisher?: null | string | undefined;
+    robots?: null | string | import("next/dist/lib/metadata/types/metadata-types.js").Robots | undefined;
+    icons?: null | import("next/dist/lib/metadata/types/metadata-types.js").IconURL | Array<import("next/dist/lib/metadata/types/metadata-types.js").Icon> | import("next/dist/lib/metadata/types/metadata-types.js").Icons | undefined;
+    manifest?: null | string | URL | undefined;
+    openGraph?: null | import("next/dist/lib/metadata/types/opengraph-types.js").OpenGraph | undefined;
+    twitter?: null | import("next/dist/lib/metadata/types/twitter-types.js").Twitter | undefined;
+    facebook?: null | import("next/dist/lib/metadata/types/extra-types.js").Facebook | undefined;
+    pinterest?: null | import("next/dist/lib/metadata/types/extra-types.js").Pinterest;
+    verification?: import("next/dist/lib/metadata/types/metadata-types.js").Verification | undefined;
+    appleWebApp?: null | boolean | import("next/dist/lib/metadata/types/extra-types.js").AppleWebApp | undefined;
+    formatDetection?: null | import("next/dist/lib/metadata/types/extra-types.js").FormatDetection | undefined;
+    itunes?: null | import("next/dist/lib/metadata/types/extra-types.js").ItunesApp | undefined;
+    abstract?: null | string | undefined;
+    appLinks?: null | import("next/dist/lib/metadata/types/extra-types.js").AppLinks | undefined;
+    archives?: null | string | Array<string> | undefined;
+    assets?: null | string | Array<string> | undefined;
+    bookmarks?: null | string | Array<string> | undefined;
+    pagination?: {
+        previous?: null | string | URL | undefined;
+        next?: null | string | URL | undefined;
+    };
+    category?: null | string | undefined;
+    classification?: null | string | undefined;
+    other?: ({
+        [name: string]: string | number | Array<string | number>;
+    } & import("next/dist/lib/metadata/types/metadata-types.js").DeprecatedMetadataFields) | undefined;
+    'apple-touch-fullscreen'?: never | undefined;
+    'apple-touch-icon-precomposed'?: never | undefined;
+};
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAErC,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAkBF,eAAO,MAAM,qBAAqB,GAChC,UAAU,QAAQ,EAClB,UAAU,MAAM,EAChB,UAAS,wBAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBASwhb,CAAC;YAA+C,CAAC;;;;;;;;;CADhnb,CAAC"}

package/dist/metadata.js

@@ -0,0 +1,22 @@
+import { pathnameToMd } from "./pathname.js";
+const mergeMarkdownAlternate = (metadata, mdPath) => {
+    const alternates = metadata.alternates ?? {};
+    const types = alternates.types ?? {};
+    return {
+        ...metadata,
+        alternates: {
+            ...alternates,
+            types: {
+                ...types,
+                'text/markdown': mdPath,
+            },
+        },
+    };
+};
+export const withMarkdownAlternate = (metadata, pathname, options = {}) => {
+    if (options.shouldAdd === false) {
+        return metadata;
+    }
+    const mdPath = pathnameToMd(pathname);
+    return mergeMarkdownAlternate(metadata, mdPath);
+};

package/dist/pathname.cjs

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pathnameToMd = exports.normalizePathname = exports.DEFAULT_INDEX_PATH = void 0;
+exports.DEFAULT_INDEX_PATH = '/index';
+const stripHashAndQuery = (pathname) => {
+    const queryIndex = pathname.indexOf('?');
+    const hashIndex = pathname.indexOf('#');
+    let cutIndex = -1;
+    if (queryIndex === -1) {
+        cutIndex = hashIndex;
+    }
+    else if (hashIndex === -1) {
+        cutIndex = queryIndex;
+    }
+    else {
+        cutIndex = Math.min(queryIndex, hashIndex);
+    }
+    return cutIndex === -1 ? pathname : pathname.slice(0, cutIndex);
+};
+const normalizePathname = (pathname) => {
+    const cleaned = stripHashAndQuery(pathname.trim());
+    const withLeadingSlash = cleaned.startsWith('/') ? cleaned : `/${cleaned}`;
+    const mdSuffix = '.md';
+    const withoutMd = withLeadingSlash.endsWith(mdSuffix)
+        ? withLeadingSlash.slice(0, -mdSuffix.length)
+        : withLeadingSlash;
+    if (withoutMd === '/' || withoutMd === '') {
+        return exports.DEFAULT_INDEX_PATH;
+    }
+    return withoutMd.endsWith('/') ? withoutMd.slice(0, -1) : withoutMd;
+};
+exports.normalizePathname = normalizePathname;
+const pathnameToMd = (pathname) => {
+    const normalized = (0, exports.normalizePathname)(pathname);
+    return `${normalized}.md`;
+};
+exports.pathnameToMd = pathnameToMd;

package/dist/pathname.d.cts

@@ -0,0 +1,4 @@
+export declare const DEFAULT_INDEX_PATH = "/index";
+export declare const normalizePathname: (pathname: string) => string;
+export declare const pathnameToMd: (pathname: string) => string;
+//# sourceMappingURL=pathname.d.ts.map

package/dist/pathname.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathname.d.ts","sourceRoot":"","sources":["../src/pathname.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAkB3C,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,WAajD,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,UAAU,MAAM,WAG5C,CAAC"}

package/dist/pathname.d.ts

@@ -0,0 +1,4 @@
+export declare const DEFAULT_INDEX_PATH = "/index";
+export declare const normalizePathname: (pathname: string) => string;
+export declare const pathnameToMd: (pathname: string) => string;
+//# sourceMappingURL=pathname.d.ts.map

package/dist/pathname.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathname.d.ts","sourceRoot":"","sources":["../src/pathname.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAkB3C,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,WAajD,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,UAAU,MAAM,WAG5C,CAAC"}

package/dist/pathname.js

@@ -0,0 +1,32 @@
+export const DEFAULT_INDEX_PATH = '/index';
+const stripHashAndQuery = (pathname) => {
+    const queryIndex = pathname.indexOf('?');
+    const hashIndex = pathname.indexOf('#');
+    let cutIndex = -1;
+    if (queryIndex === -1) {
+        cutIndex = hashIndex;
+    }
+    else if (hashIndex === -1) {
+        cutIndex = queryIndex;
+    }
+    else {
+        cutIndex = Math.min(queryIndex, hashIndex);
+    }
+    return cutIndex === -1 ? pathname : pathname.slice(0, cutIndex);
+};
+export const normalizePathname = (pathname) => {
+    const cleaned = stripHashAndQuery(pathname.trim());
+    const withLeadingSlash = cleaned.startsWith('/') ? cleaned : `/${cleaned}`;
+    const mdSuffix = '.md';
+    const withoutMd = withLeadingSlash.endsWith(mdSuffix)
+        ? withLeadingSlash.slice(0, -mdSuffix.length)
+        : withLeadingSlash;
+    if (withoutMd === '/' || withoutMd === '') {
+        return DEFAULT_INDEX_PATH;
+    }
+    return withoutMd.endsWith('/') ? withoutMd.slice(0, -1) : withoutMd;
+};
+export const pathnameToMd = (pathname) => {
+    const normalized = normalizePathname(pathname);
+    return `${normalized}.md`;
+};

package/dist/proxy.cjs

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMarkdownProxy = exports.DEFAULT_ENDPOINT_PATH = exports.DEFAULT_MARKDOWN_ACCEPT = exports.DEFAULT_PROXY_EXCLUDE_EXACT = exports.DEFAULT_PROXY_EXCLUDE_PREFIXES = void 0;
+const server_js_1 = require("next/server.js");
+const pathname_js_1 = require("./pathname.cjs");
+exports.DEFAULT_PROXY_EXCLUDE_PREFIXES = ['/_next', '/api'];
+exports.DEFAULT_PROXY_EXCLUDE_EXACT = ['/robots.txt', '/sitemap.xml'];
+exports.DEFAULT_MARKDOWN_ACCEPT = 'text/markdown';
+exports.DEFAULT_ENDPOINT_PATH = '/__aid/md';
+const hasAssetExtension = (pathname) => {
+    const lastSlash = pathname.lastIndexOf('/');
+    const lastDot = pathname.lastIndexOf('.');
+    return lastDot > lastSlash;
+};
+const shouldExcludePath = (pathname, options) => {
+    if (options.exclude?.(pathname)) {
+        return true;
+    }
+    const excludePrefixes = options.excludePrefixes ?? exports.DEFAULT_PROXY_EXCLUDE_PREFIXES;
+    for (const prefix of excludePrefixes) {
+        if (pathname.startsWith(prefix)) {
+            return true;
+        }
+    }
+    const excludeExact = options.excludeExact ?? exports.DEFAULT_PROXY_EXCLUDE_EXACT;
+    return excludeExact.includes(pathname);
+};
+const isMarkdownAccept = (request, acceptHeader) => {
+    const header = request.headers.get('accept') ?? '';
+    return header
+        .split(',')
+        .some((value) => value.trim().startsWith(acceptHeader));
+};
+const buildRewriteUrl = (request, pathname, endpoint) => {
+    const url = new URL(endpoint, request.url);
+    url.searchParams.set('path', pathname);
+    return url;
+};
+const createMarkdownProxy = (options = {}) => {
+    const endpointPath = options.endpointPath ?? exports.DEFAULT_ENDPOINT_PATH;
+    const enableDotMd = options.enableDotMd ?? true;
+    const enableAcceptNegotiation = options.enableAcceptNegotiation ?? true;
+    const acceptHeader = options.acceptHeader ?? exports.DEFAULT_MARKDOWN_ACCEPT;
+    const endpointPrefix = endpointPath.startsWith('/')
+        ? endpointPath
+        : `/${endpointPath}`;
+    const shouldSkipRequest = (request) => request.method !== 'GET' && request.method !== 'HEAD';
+    const isInternalEndpoint = (pathname) => pathname === endpointPrefix || pathname.startsWith(`${endpointPrefix}/`);
+    return (request, _event) => {
+        if (shouldSkipRequest(request)) {
+            return server_js_1.NextResponse.next();
+        }
+        const pathname = request.nextUrl.pathname;
+        // Avoid rewrite loops: the internal endpoint must never be rewritten.
+        if (isInternalEndpoint(pathname) || shouldExcludePath(pathname, options)) {
+            return server_js_1.NextResponse.next();
+        }
+        const isDotMd = enableDotMd && pathname.endsWith('.md');
+        // Don't rewrite "asset" paths like /logo.png, but do allow the explicit
+        // `.md` endpoint to pass through this check.
+        if (!isDotMd && hasAssetExtension(pathname)) {
+            return server_js_1.NextResponse.next();
+        }
+        const isAcceptMd = enableAcceptNegotiation && isMarkdownAccept(request, acceptHeader);
+        if (!(isDotMd || isAcceptMd)) {
+            return server_js_1.NextResponse.next();
+        }
+        const normalized = (0, pathname_js_1.normalizePathname)(pathname);
+        const rewriteUrl = buildRewriteUrl(request, normalized, endpointPath);
+        options.onRewrite?.({
+            type: isDotMd ? 'dotmd' : 'accept',
+            pathname: normalized,
+        });
+        const response = server_js_1.NextResponse.rewrite(rewriteUrl);
+        response.headers.set('Vary', 'Accept');
+        return response;
+    };
+};
+exports.createMarkdownProxy = createMarkdownProxy;

package/dist/proxy.d.cts

@@ -0,0 +1,22 @@
+import { NextResponse } from 'next/server.js';
+import type { NextFetchEvent, NextRequest } from 'next/server.js';
+export type MarkdownRewriteType = 'accept' | 'dotmd';
+export type MarkdownProxyOptions = {
+    endpointPath?: string;
+    enableDotMd?: boolean;
+    enableAcceptNegotiation?: boolean;
+    acceptHeader?: string;
+    exclude?: (pathname: string) => boolean;
+    excludePrefixes?: Array<string>;
+    excludeExact?: Array<string>;
+    onRewrite?: (event: {
+        type: MarkdownRewriteType;
+        pathname: string;
+    }) => void;
+};
+export declare const DEFAULT_PROXY_EXCLUDE_PREFIXES: string[];
+export declare const DEFAULT_PROXY_EXCLUDE_EXACT: string[];
+export declare const DEFAULT_MARKDOWN_ACCEPT = "text/markdown";
+export declare const DEFAULT_ENDPOINT_PATH = "/__aid/md";
+export declare const createMarkdownProxy: (options?: MarkdownProxyOptions) => (request: NextRequest, _event: NextFetchEvent) => NextResponse<unknown>;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/proxy.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElE,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAErD,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IACxC,eAAe,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,mBAAmB,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC9E,CAAC;AAEF,eAAO,MAAM,8BAA8B,UAAqB,CAAC;AACjE,eAAO,MAAM,2BAA2B,UAAkC,CAAC;AAC3E,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AACvD,eAAO,MAAM,qBAAqB,cAAc,CAAC;AA2CjD,eAAO,MAAM,mBAAmB,GAAI,UAAS,oBAAyB,MAgB5D,SAAS,WAAW,EAAE,QAAQ,cAAc,0BAqCrD,CAAC"}

package/dist/proxy.d.ts

@@ -0,0 +1,22 @@
+import { NextResponse } from 'next/server.js';
+import type { NextFetchEvent, NextRequest } from 'next/server.js';
+export type MarkdownRewriteType = 'accept' | 'dotmd';
+export type MarkdownProxyOptions = {
+    endpointPath?: string;
+    enableDotMd?: boolean;
+    enableAcceptNegotiation?: boolean;
+    acceptHeader?: string;
+    exclude?: (pathname: string) => boolean;
+    excludePrefixes?: Array<string>;
+    excludeExact?: Array<string>;
+    onRewrite?: (event: {
+        type: MarkdownRewriteType;
+        pathname: string;
+    }) => void;
+};
+export declare const DEFAULT_PROXY_EXCLUDE_PREFIXES: string[];
+export declare const DEFAULT_PROXY_EXCLUDE_EXACT: string[];
+export declare const DEFAULT_MARKDOWN_ACCEPT = "text/markdown";
+export declare const DEFAULT_ENDPOINT_PATH = "/__aid/md";
+export declare const createMarkdownProxy: (options?: MarkdownProxyOptions) => (request: NextRequest, _event: NextFetchEvent) => NextResponse<unknown>;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElE,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAErD,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IACxC,eAAe,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,mBAAmB,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC9E,CAAC;AAEF,eAAO,MAAM,8BAA8B,UAAqB,CAAC;AACjE,eAAO,MAAM,2BAA2B,UAAkC,CAAC;AAC3E,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AACvD,eAAO,MAAM,qBAAqB,cAAc,CAAC;AA2CjD,eAAO,MAAM,mBAAmB,GAAI,UAAS,oBAAyB,MAgB5D,SAAS,WAAW,EAAE,QAAQ,cAAc,0BAqCrD,CAAC"}

package/dist/proxy.js

@@ -0,0 +1,75 @@
+import { NextResponse } from 'next/server.js';
+import { normalizePathname } from "./pathname.js";
+export const DEFAULT_PROXY_EXCLUDE_PREFIXES = ['/_next', '/api'];
+export const DEFAULT_PROXY_EXCLUDE_EXACT = ['/robots.txt', '/sitemap.xml'];
+export const DEFAULT_MARKDOWN_ACCEPT = 'text/markdown';
+export const DEFAULT_ENDPOINT_PATH = '/__aid/md';
+const hasAssetExtension = (pathname) => {
+    const lastSlash = pathname.lastIndexOf('/');
+    const lastDot = pathname.lastIndexOf('.');
+    return lastDot > lastSlash;
+};
+const shouldExcludePath = (pathname, options) => {
+    if (options.exclude?.(pathname)) {
+        return true;
+    }
+    const excludePrefixes = options.excludePrefixes ?? DEFAULT_PROXY_EXCLUDE_PREFIXES;
+    for (const prefix of excludePrefixes) {
+        if (pathname.startsWith(prefix)) {
+            return true;
+        }
+    }
+    const excludeExact = options.excludeExact ?? DEFAULT_PROXY_EXCLUDE_EXACT;
+    return excludeExact.includes(pathname);
+};
+const isMarkdownAccept = (request, acceptHeader) => {
+    const header = request.headers.get('accept') ?? '';
+    return header
+        .split(',')
+        .some((value) => value.trim().startsWith(acceptHeader));
+};
+const buildRewriteUrl = (request, pathname, endpoint) => {
+    const url = new URL(endpoint, request.url);
+    url.searchParams.set('path', pathname);
+    return url;
+};
+export const createMarkdownProxy = (options = {}) => {
+    const endpointPath = options.endpointPath ?? DEFAULT_ENDPOINT_PATH;
+    const enableDotMd = options.enableDotMd ?? true;
+    const enableAcceptNegotiation = options.enableAcceptNegotiation ?? true;
+    const acceptHeader = options.acceptHeader ?? DEFAULT_MARKDOWN_ACCEPT;
+    const endpointPrefix = endpointPath.startsWith('/')
+        ? endpointPath
+        : `/${endpointPath}`;
+    const shouldSkipRequest = (request) => request.method !== 'GET' && request.method !== 'HEAD';
+    const isInternalEndpoint = (pathname) => pathname === endpointPrefix || pathname.startsWith(`${endpointPrefix}/`);
+    return (request, _event) => {
+        if (shouldSkipRequest(request)) {
+            return NextResponse.next();
+        }
+        const pathname = request.nextUrl.pathname;
+        // Avoid rewrite loops: the internal endpoint must never be rewritten.
+        if (isInternalEndpoint(pathname) || shouldExcludePath(pathname, options)) {
+            return NextResponse.next();
+        }
+        const isDotMd = enableDotMd && pathname.endsWith('.md');
+        // Don't rewrite "asset" paths like /logo.png, but do allow the explicit
+        // `.md` endpoint to pass through this check.
+        if (!isDotMd && hasAssetExtension(pathname)) {
+            return NextResponse.next();
+        }
+        const isAcceptMd = enableAcceptNegotiation && isMarkdownAccept(request, acceptHeader);
+        if (!(isDotMd || isAcceptMd)) {
+            return NextResponse.next();
+        }
+        const normalized = normalizePathname(pathname);
+        const rewriteUrl = buildRewriteUrl(request, normalized, endpointPath);
+        options.onRewrite?.({
+            type: isDotMd ? 'dotmd' : 'accept',
+            pathname: normalized,
+        });
+        const response = NextResponse.rewrite(rewriteUrl);
+        response.headers.set('Vary', 'Accept');
+        return response;
+    };
+};

package/package.json

@@ -0,0 +1,66 @@
+{
+	"name": "next-ai-discovery",
+	"description": "next.js 16 helpers for markdown variants, auto-discovery links, and llms.txt",
+	"type": "module",
+	"version": "0.1.0",
+	"license": "MIT",
+	"packageManager": "bun@1.3.5",
+	"publishConfig": {
+		"access": "public"
+	},
+	"keywords": [
+		"nextjs",
+		"next",
+		"markdown",
+		"llms.txt",
+		"ai",
+		"discoverability"
+	],
+	"homepage": "https://github.com/nivalis-studio/next-ai-discovery#readme",
+	"repository": {
+		"url": "git+https://github.com/nivalis-studio/next-ai-discovery.git"
+	},
+	"scripts": {
+		"dev": "bun run --watch src/index.ts",
+		"lint": "biome check",
+		"lint:fix": "biome check --write",
+		"test": "bun test",
+		"build": "bunx zshy",
+		"prepack": "bunx zshy",
+		"prepare": "bunx lefthook install",
+		"ts": "tsc --noEmit --incremental"
+	},
+	"dependencies": {},
+	"peerDependencies": {
+		"next": "^16",
+		"typescript": "^5"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "2.3.11",
+		"@commitlint/cli": "20.3.1",
+		"@commitlint/config-conventional": "20.3.1",
+		"@nivalis/biome-config": "2.3.11",
+		"@total-typescript/ts-reset": "0.6.1",
+		"@types/bun": "1.3.5",
+		"@types/node": "24.2.0",
+		"lefthook": "2.0.13",
+		"next": "^16.1.3",
+		"typescript": "5.9.3",
+		"zshy": "0.7.0"
+	},
+	"zshy": {
+		"exports": "./src/index.ts",
+		"noEdit": true
+	},
+	"files": ["dist"],
+	"main": "./dist/index.cjs",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.cts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.cts",
+			"import": "./dist/index.js",
+			"require": "./dist/index.cjs"
+		}
+	}
+}