@krantho/server-next 0.0.0-stage → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Descoped
+
+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/dist/cache-handler.d.ts

@@ -0,0 +1,34 @@
+import type { CacheHandler, CacheHandlerContext, CacheHandlerValue } from 'next/dist/server/lib/incremental-cache';
+import type { GetIncrementalFetchCacheContext, GetIncrementalResponseCacheContext, IncrementalCacheValue, SetIncrementalFetchCacheContext, SetIncrementalResponseCacheContext } from 'next/dist/server/response-cache/types';
+/**
+ * Next.js's cache — rendered pages, route responses and data cache entries —
+ * kept in the site's own database, so every instance of a multi-instance site
+ * serves and invalidates one cache.
+ *
+ * An entry is not served when one of its tags was expired after it was
+ * written, and is served stale while Next re-renders it when a tag was only
+ * marked stale. The tags are a fetch entry's own and implicit tags, and the
+ * `x-next-cache-tags` header of a page or route.
+ *
+ * Enable it in `next.config.ts` with `cacheHandler:
+ * require.resolve('@krantho/server-next/cache-handler')` and
+ * `cacheMaxMemorySize: 0`, so no instance keeps a private copy.
+ */
+declare class KranthoCacheHandler implements CacheHandler {
+    private readonly revalidatedTags;
+    constructor(context: CacheHandlerContext);
+    get(key: string, context: GetIncrementalFetchCacheContext | GetIncrementalResponseCacheContext): Promise<CacheHandlerValue | null>;
+    set(key: string, data: IncrementalCacheValue | null, context: SetIncrementalFetchCacheContext | SetIncrementalResponseCacheContext): Promise<void>;
+    /**
+     * No durations, or an expiry of zero, expires the tags now. Any later expiry
+     * — the `'max'` profile, a `cacheLife` profile — marks them stale now: the
+     * next read serves the entry and re-renders it.
+     */
+    revalidateTag(tags: string | string[], durations?: {
+        expire?: number;
+    }): Promise<void>;
+    /** Nothing is kept per request */
+    resetRequestCache(): void;
+}
+export default KranthoCacheHandler;
+//# sourceMappingURL=cache-handler.d.ts.map

package/dist/cache-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-handler.d.ts","sourceRoot":"","sources":["../src/cache-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,wCAAwC,CAAA;AAC/C,OAAO,KAAK,EACV,+BAA+B,EAC/B,kCAAkC,EAClC,qBAAqB,EACrB,+BAA+B,EAC/B,kCAAkC,EACnC,MAAM,uCAAuC,CAAA;AA2B9C;;;;;;;;;;;;;GAaG;AACH,cAAM,mBAAoB,YAAW,YAAY;IAC/C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmB;gBAEvC,OAAO,EAAE,mBAAmB;IAIlC,GAAG,CACP,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,+BAA+B,GAAG,kCAAkC,GAC5E,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAgB9B,GAAG,CACP,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,qBAAqB,GAAG,IAAI,EAClC,OAAO,EAAE,+BAA+B,GAAG,kCAAkC,GAC5E,OAAO,CAAC,IAAI,CAAC;IAMhB;;;;OAIG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,SAAS,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5F,kCAAkC;IAClC,iBAAiB,IAAI,IAAI;CAC1B;AAYD,eAAe,mBAAmB,CAAA"}

package/dist/cache-handler.js

@@ -0,0 +1,90 @@
+import { resolvePersistence } from '@krantho/config';
+import { openPageCacheStore } from '@krantho/server';
+import { FETCH_KIND, fromStoredValue, responseTags, toStoredValue } from './cache-value.js';
+/**
+ * `lastModified` of an entry whose tags were marked stale. Next reads it as
+ * `isStale: -1` and renders the page again before it responds, so a visitor
+ * never gets a page older than its tags. A fetch entry's age then exceeds any
+ * revalidate period, so Next re-fetches it. Next does not read `cacheState` from
+ * a custom handler.
+ */
+const STALE_LAST_MODIFIED = -1;
+let opening;
+/**
+ * The store is opened once per process. Next loads this module by path with no
+ * access to `krantho.config.ts`, so the database comes from the environment.
+ * A failed open is not kept: the next call tries again.
+ */
+function pageCacheStore() {
+    opening ??= openPageCacheStore(resolvePersistence(process.env)).catch((error) => {
+        opening = undefined;
+        throw error;
+    });
+    return opening;
+}
+/**
+ * Next.js's cache — rendered pages, route responses and data cache entries —
+ * kept in the site's own database, so every instance of a multi-instance site
+ * serves and invalidates one cache.
+ *
+ * An entry is not served when one of its tags was expired after it was
+ * written, and is served stale while Next re-renders it when a tag was only
+ * marked stale. The tags are a fetch entry's own and implicit tags, and the
+ * `x-next-cache-tags` header of a page or route.
+ *
+ * Enable it in `next.config.ts` with `cacheHandler:
+ * require.resolve('@krantho/server-next/cache-handler')` and
+ * `cacheMaxMemorySize: 0`, so no instance keeps a private copy.
+ */
+class KranthoCacheHandler {
+    revalidatedTags;
+    constructor(context) {
+        this.revalidatedTags = context.revalidatedTags;
+    }
+    async get(key, context) {
+        const store = await pageCacheStore();
+        const entry = await store.get(key);
+        if (!entry)
+            return null;
+        const value = fromStoredValue(entry.value);
+        const tags = [...new Set([...entry.tags, ...requestTags(context), ...responseTags(value)])];
+        // In minimal mode Next passes the tags revalidated during this request
+        if (context.kind === FETCH_KIND && tags.some((tag) => this.revalidatedTags.includes(tag))) {
+            return null;
+        }
+        const state = tags.length > 0 ? await store.tagsRevalidatedSince(tags, entry.lastModified) : 'fresh';
+        if (state === 'expired')
+            return null;
+        return { lastModified: state === 'stale' ? STALE_LAST_MODIFIED : entry.lastModified, value };
+    }
+    async set(key, data, context) {
+        const store = await pageCacheStore();
+        const tags = context.fetchCache ? (context.tags ?? []) : responseTags(data);
+        await store.set(key, toStoredValue(data), tags);
+    }
+    /**
+     * No durations, or an expiry of zero, expires the tags now. Any later expiry
+     * — the `'max'` profile, a `cacheLife` profile — marks them stale now: the
+     * next read serves the entry and re-renders it.
+     */
+    async revalidateTag(tags, durations) {
+        const list = typeof tags === 'string' ? [tags] : tags;
+        if (list.length === 0)
+            return;
+        const expire = durations === undefined || (durations.expire !== undefined && durations.expire <= 0);
+        const store = await pageCacheStore();
+        await store.markTags(list, { expire });
+    }
+    /** Nothing is kept per request */
+    resetRequestCache() { }
+}
+/** A fetch entry's tags and the implicit tags of the page reading it */
+function requestTags(context) {
+    if (context.kind !== FETCH_KIND)
+        return [];
+    return [...(context.tags ?? []), ...(context.softTags ?? [])];
+}
+// Next loads a cache handler by path and constructs the module's default export,
+// so this entry point is the one module with a default export.
+export default KranthoCacheHandler;
+//# sourceMappingURL=cache-handler.js.map

package/dist/cache-handler.js.map

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

package/dist/cache-value.d.ts

@@ -0,0 +1,23 @@
+import type { PageCacheValue } from '@krantho/server';
+import type { IncrementalCacheKind, IncrementalCacheValue } from 'next/dist/server/response-cache/types';
+export declare const FETCH_KIND: IncrementalCacheKind.FETCH;
+/**
+ * Convert a value Next caches into one the page cache store keeps.
+ *
+ * Binary fields (`rscData`, a route's `body`, an image's `buffer`) are Buffers,
+ * which the store keeps as bytes. A page's `segmentData` Map becomes a list of
+ * `[segmentPath, bytes]` pairs. `pageData` and redirect `props` are JSON, as
+ * Next itself writes them to disk.
+ */
+export declare function toStoredValue(value: IncrementalCacheValue | null): PageCacheValue;
+/**
+ * Restore a stored value into the shape Next reads: bytes back to Buffers and
+ * a page's segment pairs back to a Map.
+ */
+export declare function fromStoredValue(stored: PageCacheValue): IncrementalCacheValue | null;
+/**
+ * The tags Next stamped on a rendered page or route, from its
+ * `x-next-cache-tags` header — Next's implicit path tags included.
+ */
+export declare function responseTags(value: IncrementalCacheValue | null): string[];
+//# sourceMappingURL=cache-value.d.ts.map

package/dist/cache-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-value.d.ts","sourceRoot":"","sources":["../src/cache-value.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,KAAK,EAIV,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,uCAAuC,CAAA;AAe9C,eAAO,MAAM,UAAU,EAAc,oBAAoB,CAAC,KAAK,CAAA;AAO/D;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI,GAAG,cAAc,CAsBjF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,qBAAqB,GAAG,IAAI,CAYpF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI,GAAG,MAAM,EAAE,CAW1E"}

package/dist/cache-value.js

@@ -0,0 +1,121 @@
+/**
+ * Next's cache kinds, restated. Next declares them as ambient `const enum`s,
+ * which isolated modules cannot read as values; the strings are the enums' own.
+ */
+const CACHED_KIND = {
+    APP_PAGE: 'APP_PAGE',
+    APP_ROUTE: 'APP_ROUTE',
+    PAGES: 'PAGES',
+    FETCH: 'FETCH',
+    REDIRECT: 'REDIRECT',
+    IMAGE: 'IMAGE',
+};
+export const FETCH_KIND = 'FETCH';
+/** The response header Next records a rendered page's or route's cache tags in */
+const CACHE_TAGS_HEADER = 'x-next-cache-tags';
+/**
+ * Convert a value Next caches into one the page cache store keeps.
+ *
+ * Binary fields (`rscData`, a route's `body`, an image's `buffer`) are Buffers,
+ * which the store keeps as bytes. A page's `segmentData` Map becomes a list of
+ * `[segmentPath, bytes]` pairs. `pageData` and redirect `props` are JSON, as
+ * Next itself writes them to disk.
+ */
+export function toStoredValue(value) {
+    if (value === null)
+        return null;
+    switch (value.kind) {
+        case CACHED_KIND.APP_PAGE:
+            return {
+                kind: value.kind,
+                html: value.html,
+                rscData: value.rscData,
+                headers: value.headers,
+                postponed: value.postponed,
+                status: value.status,
+                segmentData: value.segmentData ? [...value.segmentData] : undefined,
+            };
+        case CACHED_KIND.PAGES:
+            return { ...value, pageData: value.pageData };
+        case CACHED_KIND.REDIRECT:
+            return { ...value, props: value.props };
+        case CACHED_KIND.APP_ROUTE:
+        case CACHED_KIND.IMAGE:
+        case CACHED_KIND.FETCH:
+            return { ...value };
+    }
+}
+/**
+ * Restore a stored value into the shape Next reads: bytes back to Buffers and
+ * a page's segment pairs back to a Map.
+ */
+export function fromStoredValue(stored) {
+    if (!isRecord(stored))
+        return null;
+    switch (stored.kind) {
+        case CACHED_KIND.APP_PAGE:
+            return toAppPage(stored);
+        case CACHED_KIND.APP_ROUTE:
+            return restore({ ...stored, body: toBuffer(stored.body) });
+        case CACHED_KIND.IMAGE:
+            return restore({ ...stored, buffer: toBuffer(stored.buffer) });
+        default:
+            return restore(stored);
+    }
+}
+/**
+ * The tags Next stamped on a rendered page or route, from its
+ * `x-next-cache-tags` header — Next's implicit path tags included.
+ */
+export function responseTags(value) {
+    if (value?.kind !== CACHED_KIND.APP_PAGE &&
+        value?.kind !== CACHED_KIND.APP_ROUTE &&
+        value?.kind !== CACHED_KIND.PAGES) {
+        return [];
+    }
+    const header = value.headers?.[CACHE_TAGS_HEADER];
+    if (typeof header !== 'string')
+        return [];
+    return header.split(',').filter((tag) => tag.length > 0);
+}
+function toAppPage(stored) {
+    return {
+        kind: CACHED_KIND.APP_PAGE,
+        html: stored.html,
+        rscData: stored.rscData === undefined ? undefined : toBuffer(stored.rscData),
+        headers: stored.headers,
+        postponed: stored.postponed,
+        status: stored.status,
+        segmentData: toSegmentData(stored.segmentData),
+    };
+}
+function toSegmentData(stored) {
+    if (!Array.isArray(stored))
+        return undefined;
+    const segments = new Map();
+    for (const pair of stored) {
+        segments.set(pair[0], toBuffer(pair[1]));
+    }
+    return segments;
+}
+/** The store hands bytes back as `Uint8Array`; Next reads Buffers */
+function toBuffer(bytes) {
+    if (!(bytes instanceof Uint8Array)) {
+        throw new Error('A cached binary field did not come back from the page cache store as bytes');
+    }
+    return Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+}
+/**
+ * A stored record is the value Next handed to `set`, binary fields restored;
+ * the store validated nothing of its shape, Next wrote it.
+ */
+function restore(record) {
+    return record;
+}
+function isRecord(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        !Array.isArray(value) &&
+        !(value instanceof Uint8Array));
+}
+//# sourceMappingURL=cache-value.js.map

package/dist/cache-value.js.map

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

package/dist/content-loader.d.ts

@@ -0,0 +1,18 @@
+import type { IPublishedContentLoader, IPublishedSeoLoader } from '@krantho/core';
+import { createContentLoader as createStoreLoader } from '@krantho/server';
+type LoaderOptions = Parameters<typeof createStoreLoader>[0];
+/**
+ * Create the content loader server components read through.
+ *
+ * It reads the database the API route opens (see `createContentLoader()` in
+ * `@krantho/server`). With `cache.pages: 'next-isr'`, every read goes through
+ * the Next.js data cache, tagged with what it read — the document, the
+ * collection, the SEO configuration — so a page rendered from it stays cached
+ * until the API route invalidates one of those tags (in production; `next dev`
+ * reads the database every time). This is the one place krantho touches
+ * `unstable_cache`. In an editor's preview (draft mode, `isPreview()`), every
+ * read comes from the current versions, drafts included, uncached.
+ */
+export declare function createContentLoader(options: LoaderOptions): IPublishedContentLoader & IPublishedSeoLoader;
+export {};
+//# sourceMappingURL=content-loader.d.ts.map

package/dist/content-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-loader.d.ts","sourceRoot":"","sources":["../src/content-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,uBAAuB,EACvB,mBAAmB,EAGpB,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,mBAAmB,IAAI,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAK1E,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAA;AAQ5D;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,GACrB,uBAAuB,GAAG,mBAAmB,CAwD/C"}

package/dist/content-loader.js

@@ -0,0 +1,85 @@
+import { documentReadTags, jsonLdTags, listReadTags, seoReadTags } from '@krantho/core';
+import { createContentLoader as createStoreLoader } from '@krantho/server';
+import { unstable_cache } from 'next/cache.js';
+import { pageCacheSwitch } from './page-cache.js';
+import { isPreview } from './site-preview.js';
+/**
+ * Create the content loader server components read through.
+ *
+ * It reads the database the API route opens (see `createContentLoader()` in
+ * `@krantho/server`). With `cache.pages: 'next-isr'`, every read goes through
+ * the Next.js data cache, tagged with what it read — the document, the
+ * collection, the SEO configuration — so a page rendered from it stays cached
+ * until the API route invalidates one of those tags (in production; `next dev`
+ * reads the database every time). This is the one place krantho touches
+ * `unstable_cache`. In an editor's preview (draft mode, `isPreview()`), every
+ * read comes from the current versions, drafts included, uncached.
+ */
+export function createContentLoader(options) {
+    const store = createStoreLoader(options);
+    const cached = pageCacheSwitch(options.config);
+    return {
+        isPreview,
+        getPublished: async (ref) => {
+            if (await isPreview())
+                return store.preview.getPublished(ref);
+            if (!cached())
+                return store.getPublished(ref);
+            return unstable_cache(async () => toStored(await store.getPublished(ref)), ['krantho', 'doc', ...refKey(ref)], { tags: documentReadTags(ref.collection, ref.slug) })().then(fromStored);
+        },
+        listPublished: async (collection, locale) => {
+            if (await isPreview())
+                return store.preview.listPublished(collection, locale);
+            if (!cached())
+                return store.listPublished(collection, locale);
+            return unstable_cache(async () => (await store.listPublished(collection, locale)).map(toStoredDoc), ['krantho', 'list', collection, locale ?? ''], { tags: listReadTags(collection) })().then((docs) => docs.map(fromStoredDoc));
+        },
+        listPublishedSummaries: async (collection, locale) => {
+            if (await isPreview())
+                return store.preview.listPublishedSummaries(collection, locale);
+            if (!cached())
+                return store.listPublishedSummaries(collection, locale);
+            return unstable_cache(async () => (await store.listPublishedSummaries(collection, locale)).map(toStoredSummary), ['krantho', 'summaries', collection, locale ?? ''], { tags: listReadTags(collection) })().then((docs) => docs.map(fromStoredSummary));
+        },
+        seoProperties: async (configId, locale) => {
+            if (await isPreview())
+                return store.preview.seoProperties(configId, locale);
+            if (!cached())
+                return store.seoProperties(configId, locale);
+            return unstable_cache(() => store.seoProperties(configId, locale), ['krantho', 'seo', configId, locale ?? ''], {
+                tags: seoReadTags(configId),
+            })();
+        },
+        // The page's structure is part of what the graph states, so it is part of the cache key
+        jsonLd: async (ref, structure) => {
+            if (await isPreview())
+                return store.preview.jsonLd(ref, structure);
+            if (!cached())
+                return store.jsonLd(ref, structure);
+            const shape = structure ? [JSON.stringify(structure)] : [];
+            return unstable_cache(() => store.jsonLd(ref, structure), ['krantho', 'jsonld', ...refKey(ref), ...shape], { tags: jsonLdTags(ref.collection, ref.slug) })();
+        },
+    };
+}
+function refKey(ref) {
+    return [ref.collection, ref.slug, ref.locale ?? ''];
+}
+function toStored(doc) {
+    return doc ? toStoredDoc(doc) : null;
+}
+function toStoredDoc(doc) {
+    return { ...doc, publishedAt: doc.publishedAt.toISOString() };
+}
+function fromStored(doc) {
+    return doc ? fromStoredDoc(doc) : null;
+}
+function fromStoredDoc(doc) {
+    return { ...doc, publishedAt: new Date(doc.publishedAt) };
+}
+function toStoredSummary(doc) {
+    return { ...doc, publishedAt: doc.publishedAt.toISOString() };
+}
+function fromStoredSummary(doc) {
+    return { ...doc, publishedAt: new Date(doc.publishedAt) };
+}
+//# sourceMappingURL=content-loader.js.map

package/dist/content-loader.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+import type { KranthoHandlerOptions } from '@krantho/server';
+export { createContentLoader } from './content-loader.js';
+export { showPreviewBanner } from './site-preview.js';
+export type { KranthoHandlerOptions };
+type RouteHandler = (request: Request) => Promise<Response>;
+/** The second argument Next.js passes a route handler: the matched dynamic segments */
+interface RouteContext {
+    params: Promise<Record<string, string | string[] | undefined>>;
+}
+type ApiRouteHandler = (request: Request, context: RouteContext) => Promise<Response>;
+interface ApiRouteHandlers {
+    GET: ApiRouteHandler;
+    POST: ApiRouteHandler;
+    PUT: ApiRouteHandler;
+    DELETE: ApiRouteHandler;
+    PATCH: ApiRouteHandler;
+}
+/**
+ * Create Next.js App Router route handlers from krantho config.
+ *
+ * Returns { GET, POST, PUT, DELETE, PATCH } matching the export convention
+ * for `app/api/[...path]/route.ts`.
+ *
+ * The handler is initialized lazily on first request and reused across
+ * subsequent requests (singleton pattern for serverless). Background jobs run
+ * under `after()`, so the platform keeps them alive past the response. With
+ * `cache.pages: 'next-isr'`, every committed write invalidates the cached pages
+ * that read what it changed, and a published document's page is rendered
+ * again right after the request.
+ */
+export declare function createApiRouteHandlers(options: KranthoHandlerOptions): ApiRouteHandlers;
+/**
+ * Create Next.js App Router route handlers for Studio.
+ *
+ * Serves the @krantho/studio built SPA from the package's dist directory.
+ * Pass the app's configuration to apply `auth.oidc.studioEntry`.
+ * Use in `app/studio/[[...slug]]/route.ts`.
+ */
+export declare function createStudioRouteHandler(options?: {
+    config?: KranthoHandlerOptions['config'];
+}): {
+    GET: RouteHandler;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAO5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,YAAY,EAAE,qBAAqB,EAAE,CAAA;AAErC,KAAK,YAAY,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAE3D,uFAAuF;AACvF,UAAU,YAAY;IACpB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAA;CAC/D;AAED,KAAK,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAErF,UAAU,gBAAgB;IACxB,GAAG,EAAE,eAAe,CAAA;IACpB,IAAI,EAAE,eAAe,CAAA;IACrB,GAAG,EAAE,eAAe,CAAA;IACpB,MAAM,EAAE,eAAe,CAAA;IACvB,KAAK,EAAE,eAAe,CAAA;CACvB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,qBAAqB,GAAG,gBAAgB,CA+BvF;AAgBD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,qBAAqB,CAAC,QAAQ,CAAC,CAAA;CAAO,GACzD;IACD,GAAG,EAAE,YAAY,CAAA;CAClB,CAUA"}

package/dist/index.js

@@ -0,0 +1,86 @@
+import { createLazyHandler, createStudioServer } from '@krantho/server';
+import { after } from 'next/server.js';
+import { pageCacheSwitch } from './page-cache.js';
+import { invalidatePages, withPageRefresh } from './page-refresh.js';
+import { handleSitePreview } from './site-preview.js';
+export { createContentLoader } from './content-loader.js';
+export { showPreviewBanner } from './site-preview.js';
+/**
+ * Create Next.js App Router route handlers from krantho config.
+ *
+ * Returns { GET, POST, PUT, DELETE, PATCH } matching the export convention
+ * for `app/api/[...path]/route.ts`.
+ *
+ * The handler is initialized lazily on first request and reused across
+ * subsequent requests (singleton pattern for serverless). Background jobs run
+ * under `after()`, so the platform keeps them alive past the response. With
+ * `cache.pages: 'next-isr'`, every committed write invalidates the cached pages
+ * that read what it changed, and a published document's page is rendered
+ * again right after the request.
+ */
+export function createApiRouteHandlers(options) {
+    const cachesPages = pageCacheSwitch(options.config);
+    const getHandler = createLazyHandler({
+        ...options,
+        onContentChange: async (change) => {
+            if (cachesPages())
+                invalidatePages(change, options.collections);
+            await options.onContentChange?.(change);
+        },
+        // Called only by a handler, inside its request, where after() is available
+        waitUntil: (work) => after(() => work),
+        sitePreview: 'draft-mode',
+        framework: 'next',
+    });
+    async function handle(request, context) {
+        const handler = await getHandler();
+        const apiRequest = await withApiPath(request, context);
+        const preview = await handleSitePreview(apiRequest, () => handler.handle(apiRequest));
+        if (preview)
+            return preview;
+        if (!cachesPages())
+            return handler.handle(apiRequest);
+        return withPageRefresh(request, () => handler.handle(apiRequest));
+    }
+    return {
+        GET: handle,
+        POST: handle,
+        PUT: handle,
+        DELETE: handle,
+        PATCH: handle,
+    };
+}
+/**
+ * A rewrite such as `/robots.txt` → `/api/seo/robots.txt` reaches the catch-all
+ * route with the visitor's URL. The catch-all segments carry the path it was
+ * rewritten to, so rebuild the `/api` path the router expects from them.
+ */
+async function withApiPath(request, context) {
+    const url = new URL(request.url);
+    if (url.pathname.startsWith('/api/'))
+        return request;
+    const segments = Object.values(await context.params).find(Array.isArray);
+    if (!segments)
+        return request;
+    url.pathname = `/api/${segments.map(encodeURIComponent).join('/')}`;
+    return new Request(url, request);
+}
+/**
+ * Create Next.js App Router route handlers for Studio.
+ *
+ * Serves the @krantho/studio built SPA from the package's dist directory.
+ * Pass the app's configuration to apply `auth.oidc.studioEntry`.
+ * Use in `app/studio/[[...slug]]/route.ts`.
+ */
+export function createStudioRouteHandler(options = {}) {
+    const serve = createStudioServer(options.config);
+    return {
+        async GET(request) {
+            return serve({
+                url: new URL(request.url),
+                cookie: request.headers.get('cookie') ?? undefined,
+            });
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/page-cache.d.ts

@@ -0,0 +1,9 @@
+import type { KranthoConfigInput } from '@krantho/config';
+/**
+ * Whether Next.js caches this app's pages: `cache.pages: 'next-isr'`, outside
+ * `next dev`. The dev server renders every request, and a file edit synced by
+ * the watcher arrives outside any request, where no cache tag can be
+ * invalidated — so in development every read goes to the database.
+ */
+export declare function pageCacheSwitch(config: KranthoConfigInput): () => boolean;
+//# sourceMappingURL=page-cache.d.ts.map

package/dist/page-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-cache.d.ts","sourceRoot":"","sources":["../src/page-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAGzD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,OAAO,CAQzE"}

package/dist/page-cache.js

@@ -0,0 +1,17 @@
+import { loadConfig } from '@krantho/config/node';
+/**
+ * Whether Next.js caches this app's pages: `cache.pages: 'next-isr'`, outside
+ * `next dev`. The dev server renders every request, and a file edit synced by
+ * the watcher arrives outside any request, where no cache tag can be
+ * invalidated — so in development every read goes to the database.
+ */
+export function pageCacheSwitch(config) {
+    let enabled;
+    return () => {
+        enabled ??=
+            process.env.NODE_ENV !== 'development' &&
+                loadConfig({ code: config, env: process.env }).cache.pages === 'next-isr';
+        return enabled;
+    };
+}
+//# sourceMappingURL=page-cache.js.map

package/dist/page-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-cache.js","sourceRoot":"","sources":["../src/page-cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEjD;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAA0B;IACxD,IAAI,OAA4B,CAAA;IAChC,OAAO,GAAG,EAAE;QACV,OAAO;YACL,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa;gBACtC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,KAAK,UAAU,CAAA;QAC3E,OAAO,OAAO,CAAA;IAChB,CAAC,CAAA;AACH,CAAC"}

package/dist/page-refresh.d.ts

@@ -0,0 +1,16 @@
+import type { ContentChange, PageCollection } from '@krantho/core';
+/**
+ * Handle an API request, then render again the pages its writes published, so
+ * neither the editor nor the next visitor waits for the render. Next.js applies
+ * the request's invalidations before `after()` callbacks run.
+ */
+export declare function withPageRefresh(request: Request, handle: () => Promise<Response>): Promise<Response>;
+/**
+ * Invalidate the Next.js cache for a change: the edited document expires, so
+ * its page is fresh on the next request; broad tags go stale, so their pages
+ * are served once more while they render again in the background. A published
+ * document's page — at `documentPath()`, from its collection's declared path —
+ * is rendered again after the request; a document without a page is not.
+ */
+export declare function invalidatePages(change: ContentChange, collections: Readonly<Record<string, PageCollection>>): void;
+//# sourceMappingURL=page-refresh.d.ts.map

package/dist/page-refresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-refresh.d.ts","sourceRoot":"","sources":["../src/page-refresh.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAgBlE;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GAC9B,OAAO,CAAC,QAAQ,CAAC,CAiBnB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,GACpD,IAAI,CASN"}

package/dist/page-refresh.js

@@ -0,0 +1,61 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { documentPath, invalidationsFor, pageCollection } from '@krantho/core';
+import { revalidateTag } from 'next/cache.js';
+import { after } from 'next/server.js';
+const scopes = new AsyncLocalStorage();
+/**
+ * Handle an API request, then render again the pages its writes published, so
+ * neither the editor nor the next visitor waits for the render. Next.js applies
+ * the request's invalidations before `after()` callbacks run.
+ */
+export async function withPageRefresh(request, handle) {
+    // The origin the request reached: the public host on Vercel, the server itself
+    // behind a proxy — either way, the one whose cache holds the page
+    const scope = {
+        origin: new URL(request.url).origin,
+        open: true,
+        rerender: new Set(),
+    };
+    try {
+        return await scopes.run(scope, handle);
+    }
+    finally {
+        scope.open = false;
+        if (scope.rerender.size > 0) {
+            const paths = [...scope.rerender];
+            after(() => renderPages(scope.origin, paths));
+        }
+    }
+}
+/**
+ * Invalidate the Next.js cache for a change: the edited document expires, so
+ * its page is fresh on the next request; broad tags go stale, so their pages
+ * are served once more while they render again in the background. A published
+ * document's page — at `documentPath()`, from its collection's declared path —
+ * is rendered again after the request; a document without a page is not.
+ */
+export function invalidatePages(change, collections) {
+    for (const { tags, mode } of invalidationsFor(change)) {
+        for (const tag of tags)
+            revalidateTag(tag, mode === 'expire' ? { expire: 0 } : 'max');
+    }
+    const scope = scopes.getStore();
+    if (change.kind !== 'document' || !change.live || !scope?.open)
+        return;
+    const collection = pageCollection(collections, change.collection);
+    const path = documentPath(collection, change.slug);
+    if (path)
+        scope.rerender.add(path);
+}
+async function renderPages(origin, paths) {
+    await Promise.all(paths.map(async (path) => {
+        try {
+            // Read the whole body: the page is stored once its render completes
+            await (await fetch(new URL(path, origin))).arrayBuffer();
+        }
+        catch (err) {
+            console.warn(`[krantho] rendering ${path} after a publish failed:`, err);
+        }
+    }));
+}
+//# sourceMappingURL=page-refresh.js.map

package/dist/page-refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-refresh.js","sourceRoot":"","sources":["../src/page-refresh.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEpD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAWtC,MAAM,MAAM,GAAG,IAAI,iBAAiB,EAAgB,CAAA;AAEpD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAgB,EAChB,MAA+B;IAE/B,+EAA+E;IAC/E,kEAAkE;IAClE,MAAM,KAAK,GAAiB;QAC1B,MAAM,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM;QACnC,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,IAAI,GAAG,EAAE;KACpB,CAAA;IACD,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACxC,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,IAAI,GAAG,KAAK,CAAA;QAClB,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAA;YACjC,KAAK,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;QAC/C,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAqB,EACrB,WAAqD;IAErD,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;QACtD,KAAK,MAAM,GAAG,IAAI,IAAI;YAAE,aAAa,CAAC,GAAG,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IACvF,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;IAC/B,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,IAAI;QAAE,OAAM;IACtE,MAAM,UAAU,GAAG,cAAc,CAAC,WAAW,EAAE,MAAM,CAAC,UAAU,CAAC,CAAA;IACjE,MAAM,IAAI,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;IAClD,IAAI,IAAI;QAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;AACpC,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,MAAc,EAAE,KAAwB;IACjE,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACvB,IAAI,CAAC;YACH,oEAAoE;YACpE,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;QAC1D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,uBAAuB,IAAI,0BAA0B,EAAE,GAAG,CAAC,CAAA;QAC1E,CAAC;IACH,CAAC,CAAC,CACH,CAAA;AACH,CAAC"}

package/dist/site-preview.d.ts

@@ -0,0 +1,24 @@
+/** Where Studio sends an editor to preview a document on the site */
+export declare const PREVIEW_PATH = "/api/preview";
+/** Where a previewing editor leaves draft mode */
+export declare const PREVIEW_EXIT_PATH = "/api/preview/exit";
+/**
+ * Whether this render is an editor's preview (Next.js draft mode). Outside a
+ * request — a build, a test — it is not.
+ */
+export declare function isPreview(): Promise<boolean>;
+/**
+ * Whether the site's own "Previewing drafts" notice belongs on this render: it
+ * does for an editor's preview, and not when a frame shows the page — Studio's
+ * Live mode does, and it has its own way out of the preview. The browser says so
+ * itself (`Sec-Fetch-Dest: iframe`), so the site needs no flag of its own.
+ */
+export declare function showPreviewBanner(): Promise<boolean>;
+/**
+ * Handle the preview routes, or return null for any other request. The API
+ * decides who may preview (`GET /api/preview` answers the page's path to an
+ * editor); this turns its answer into draft mode and sends the editor to the
+ * page, where every read comes from the current version, uncached.
+ */
+export declare function handleSitePreview(request: Request, apiResponse: () => Promise<Response>): Promise<Response | null>;
+//# sourceMappingURL=site-preview.d.ts.map

package/dist/site-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-preview.d.ts","sourceRoot":"","sources":["../src/site-preview.ts"],"names":[],"mappings":"AAGA,qEAAqE;AACrE,eAAO,MAAM,YAAY,iBAAiB,CAAA;AAC1C,kDAAkD;AAClD,eAAO,MAAM,iBAAiB,sBAAsB,CAAA;AAEpD;;;GAGG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAMlD;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAO1D;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GACnC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAe1B"}

package/dist/site-preview.js

@@ -0,0 +1,70 @@
+import { resolveSitePath } from '@krantho/core';
+import { draftMode, headers } from 'next/headers.js';
+/** Where Studio sends an editor to preview a document on the site */
+export const PREVIEW_PATH = '/api/preview';
+/** Where a previewing editor leaves draft mode */
+export const PREVIEW_EXIT_PATH = '/api/preview/exit';
+/**
+ * Whether this render is an editor's preview (Next.js draft mode). Outside a
+ * request — a build, a test — it is not.
+ */
+export async function isPreview() {
+    try {
+        return (await draftMode()).isEnabled;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Whether the site's own "Previewing drafts" notice belongs on this render: it
+ * does for an editor's preview, and not when a frame shows the page — Studio's
+ * Live mode does, and it has its own way out of the preview. The browser says so
+ * itself (`Sec-Fetch-Dest: iframe`), so the site needs no flag of its own.
+ */
+export async function showPreviewBanner() {
+    if (!(await isPreview()))
+        return false;
+    try {
+        return (await headers()).get('sec-fetch-dest') !== 'iframe';
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * Handle the preview routes, or return null for any other request. The API
+ * decides who may preview (`GET /api/preview` answers the page's path to an
+ * editor); this turns its answer into draft mode and sends the editor to the
+ * page, where every read comes from the current version, uncached.
+ */
+export async function handleSitePreview(request, apiResponse) {
+    if (request.method !== 'GET')
+        return null;
+    const url = new URL(request.url);
+    if (url.pathname === PREVIEW_EXIT_PATH) {
+        ;
+        (await draftMode()).disable();
+        return redirect(sameSitePath(url.searchParams.get('path'), url), url);
+    }
+    if (url.pathname !== PREVIEW_PATH)
+        return null;
+    const response = await apiResponse();
+    if (!response.ok)
+        return response;
+    const { path } = (await response.json());
+    (await draftMode()).enable();
+    return redirect(sameSitePath(path, url), url);
+}
+/** A path on this site; anything else falls back to the home page */
+function sameSitePath(path, base) {
+    const target = path ? resolveSitePath(path, base) : null;
+    return target ? `${target.pathname}${target.search}` : '/';
+}
+function redirect(path, base) {
+    return new Response(null, {
+        status: 307,
+        headers: { location: new URL(path, base).toString(), 'cache-control': 'no-store' },
+    });
+}
+//# sourceMappingURL=site-preview.js.map

package/dist/site-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-preview.js","sourceRoot":"","sources":["../src/site-preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAEpD,qEAAqE;AACrE,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAA;AAC1C,kDAAkD;AAClD,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAA;AAEpD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,SAAS,EAAE,CAAC,CAAC,SAAS,CAAA;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,IAAI,CAAC,CAAC,MAAM,SAAS,EAAE,CAAC;QAAE,OAAO,KAAK,CAAA;IACtC,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,QAAQ,CAAA;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAgB,EAChB,WAAoC;IAEpC,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK;QAAE,OAAO,IAAI,CAAA;IACzC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAEhC,IAAI,GAAG,CAAC,QAAQ,KAAK,iBAAiB,EAAE,CAAC;QACvC,CAAC;QAAA,CAAC,MAAM,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAA;QAC9B,OAAO,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAA;IACvE,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,KAAK,YAAY;QAAE,OAAO,IAAI,CAAA;IAE9C,MAAM,QAAQ,GAAG,MAAM,WAAW,EAAE,CAAA;IACpC,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,QAAQ,CAAA;IACjC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAqB,CAC3D;IAAA,CAAC,MAAM,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAA;IAC7B,OAAO,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAA;AAC/C,CAAC;AAED,qEAAqE;AACrE,SAAS,YAAY,CAAC,IAAmB,EAAE,IAAS;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACxD,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;AAC5D,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,IAAS;IACvC,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE;QACxB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,eAAe,EAAE,UAAU,EAAE;KACnF,CAAC,CAAA;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "@krantho/server-next",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.1",
+  "description": "The krantho adapter for the Next.js App Router: API and Studio route handlers, the content loader and page caching.",
+  "license": "MIT",
+  "homepage": "https://krantho.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/descoped/krantho.git",
+    "directory": "packages/server-next"
+  },
+  "bugs": {
+    "url": "https://github.com/descoped/krantho/issues"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./cache-handler": {
+      "types": "./dist/cache-handler.d.ts",
+      "import": "./dist/cache-handler.js",
+      "default": "./dist/cache-handler.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@krantho/core": "1.0.1",
+    "@krantho/server": "1.0.1",
+    "@krantho/config": "1.0.1"
+  },
+  "peerDependencies": {
+    "next": ">=16.3.8"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.9",
+    "next": "~16.4.6",
+    "react": "^19.3.1",
+    "react-dom": "^19.3.1",
+    "typescript": "^6.0.3",
+    "zod": "^4.6.7",
+    "@krantho/schema": "1.0.1"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.