@storystick/next 0.0.0-stage → 0.2.0-rc.0

package/dist/preview-render-error.js

@@ -0,0 +1,36 @@
+// Next preserves only a server error's digest in production Flight responses.
+// Keep this marker closed and free of upstream messages, URLs, or credentials.
+export const PREVIEW_READ_UNAVAILABLE_DIGEST = 'storystick.preview.read-unavailable.v1';
+export const PREVIEW_CONTEXT_SUPERSEDED_DIGEST = 'storystick.preview.context-superseded.v1';
+export const CUSTOMER_RENDER_ERROR = 'runtime.customer_render_failed';
+export const PREVIEW_READ_UNAVAILABLE = 'runtime.preview_read_unavailable';
+export function previewReadUnavailableDigest(retryAfterMs, now) {
+    const retryNotBefore = now + (retryAfterMs ?? 0);
+    return retryAfterMs !== undefined && retryAfterMs >= 0 && Number.isSafeInteger(retryNotBefore)
+        ? `${PREVIEW_READ_UNAVAILABLE_DIGEST}:${retryNotBefore}`
+        : PREVIEW_READ_UNAVAILABLE_DIGEST;
+}
+export function previewRenderError(digest) {
+    const suffix = digest?.startsWith(`${PREVIEW_READ_UNAVAILABLE_DIGEST}:`)
+        ? digest.slice(PREVIEW_READ_UNAVAILABLE_DIGEST.length + 1) : undefined;
+    const retryNotBefore = suffix && /^\d+$/.test(suffix) && Number.isSafeInteger(Number(suffix))
+        ? Number(suffix) : undefined;
+    return digest === PREVIEW_CONTEXT_SUPERSEDED_DIGEST
+        ? {
+            code: 'runtime.preview_context_superseded',
+            message: 'The Preview selection changed while this page was loading. Retry to display the latest selection.',
+            retryable: true,
+        }
+        : digest === PREVIEW_READ_UNAVAILABLE_DIGEST || retryNotBefore !== undefined
+            ? {
+                code: PREVIEW_READ_UNAVAILABLE,
+                message: 'Preview content is temporarily unavailable. Retry when the content service is reachable again.',
+                retryable: true,
+                ...(retryNotBefore !== undefined ? { retryNotBefore } : {}),
+            }
+            : {
+                code: CUSTOMER_RENDER_ERROR,
+                message: 'The customer page could not render. Open another document or retry after correcting the page error.',
+                retryable: false,
+            };
+}

package/dist/preview-render-recovery.d.ts

@@ -0,0 +1,9 @@
+/** Retry the whole render once per accepted context, never individual queries
+ * under another revision. A persistently failing context stays inspectable. */
+export declare function recoverSupersededPreviewRender(contextKey: string, retry: () => void): boolean;
+export declare function registerPreviewRenderFailure(reset: () => void, code?: string): () => void;
+export declare function resetPreviewRenderFailure(): void;
+/** A layout receipt cannot attest a page currently replaced by an error boundary. */
+export declare function hasPreviewRenderFailure(): boolean;
+/** Called only at a framework commit, never merely after sending navigation. */
+export declare function confirmPreviewRender(): boolean;

package/dist/preview-render-recovery.js

@@ -0,0 +1,42 @@
+import { emitRuntimeRecovered } from '@storystick/preview/runtime/emit-runtime-error';
+import { CUSTOMER_RENDER_ERROR } from './preview-render-error.js';
+// The Next error fallback can replace the layout that owned the adapter.
+// Keep the failure across that handoff, but never let an old cleanup remove
+// the reset callback installed by a newer fallback.
+const boundaries = new Set();
+const failures = new Set();
+const supersededRetries = new Set();
+/** Retry the whole render once per accepted context, never individual queries
+ * under another revision. A persistently failing context stays inspectable. */
+export function recoverSupersededPreviewRender(contextKey, retry) {
+    if (supersededRetries.has(contextKey))
+        return false;
+    supersededRetries.add(contextKey);
+    retry();
+    return true;
+}
+export function registerPreviewRenderFailure(reset, code = CUSTOMER_RENDER_ERROR) {
+    const owner = { reset };
+    boundaries.add(owner);
+    failures.add(code);
+    return () => { boundaries.delete(owner); };
+}
+export function resetPreviewRenderFailure() {
+    for (const boundary of [...boundaries])
+        boundary.reset();
+}
+/** A layout receipt cannot attest a page currently replaced by an error boundary. */
+export function hasPreviewRenderFailure() {
+    return boundaries.size > 0;
+}
+/** Called only at a framework commit, never merely after sending navigation. */
+export function confirmPreviewRender() {
+    if (hasPreviewRenderFailure())
+        return false;
+    supersededRetries.clear();
+    const recovered = [...failures];
+    failures.clear();
+    for (const code of recovered)
+        emitRuntimeRecovered(code);
+    return true;
+}

package/dist/preview-session-recovery.d.ts

@@ -0,0 +1 @@
+export { appendSearchParamsToRedirect } from '@storystick/client/adapter';

package/dist/preview-session-recovery.js

@@ -0,0 +1 @@
+export { appendSearchParamsToRedirect } from '@storystick/client/adapter';

package/dist/preview-standalone-host.d.ts

@@ -0,0 +1,3 @@
+import { type PreviewStandaloneControlsProps } from '@storystick/react/internal/preview-host';
+/** The framework owns routing; the active Preview view owns its editor. */
+export declare function PreviewStandaloneHost(props: PreviewStandaloneControlsProps): null;

package/dist/preview-standalone-host.js

@@ -0,0 +1,55 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useLayoutEffect, useState } from 'react';
+import { createRoot } from 'react-dom/client';
+import { usePathname } from 'next/navigation';
+import { PreviewStandaloneControls, } from '@storystick/react/internal/preview-host';
+const attachments = new Map();
+let host = null;
+let scheduled = false;
+function renderHost() {
+    if (scheduled)
+        return;
+    scheduled = true;
+    // React can replace a layout (or its error boundary) in one commit. Transfer
+    // ownership after that commit, without tying the editor to either React tree.
+    queueMicrotask(() => {
+        scheduled = false;
+        const props = Array.from(attachments.values()).at(-1);
+        if (!props) {
+            host?.root.unmount();
+            host?.container.remove();
+            host = null;
+            return;
+        }
+        if (!host) {
+            const container = document.createElement('div');
+            container.dataset.storystickStandaloneHost = '';
+            host = { container, root: createRoot(container) };
+        }
+        // Only our own DOM is moved, including when a root layout replaces body.
+        if (!host.container.isConnected)
+            document.body.append(host.container);
+        const scope = JSON.stringify([
+            props.projectId, props.state.sessionId, props.basePath,
+        ]);
+        host.root.render(_jsx(PreviewStandaloneControls, { ...props }, scope));
+    });
+}
+/** The framework owns routing; the active Preview view owns its editor. */
+export function PreviewStandaloneHost(props) {
+    const pathname = usePathname();
+    const [owner] = useState(() => Symbol('standalone-preview'));
+    useLayoutEffect(() => {
+        return () => {
+            attachments.delete(owner);
+            renderHost();
+        };
+    }, [owner]);
+    useLayoutEffect(() => {
+        // Updating an older adapter must not take ownership from its replacement.
+        attachments.set(owner, { ...props, pathname });
+        renderHost();
+    }, [owner, props, pathname]);
+    return null;
+}

package/dist/preview-text.d.ts

@@ -0,0 +1,2 @@
+export { previewTextProps } from '@storystick/react/preview-text';
+export type { PreviewTextProps, PreviewTextValue } from '@storystick/react/preview-text';

package/dist/preview-text.js

@@ -0,0 +1 @@
+export { previewTextProps } from '@storystick/react/preview-text';

package/dist/preview-view-bootstrap.d.ts

@@ -0,0 +1,5 @@
+export declare class PreviewViewRecoveryError extends Error {
+}
+/** Ordinary navigation inherits the admitted perspective on the server. The
+ * tab's stored view is only for its toolbar/selection, never a reason to reload. */
+export declare function ensureStandalonePreviewView(projectId: string): Promise<void>;

package/dist/preview-view-bootstrap.js

@@ -0,0 +1,13 @@
+import { readStandalonePreviewSessionId } from '@storystick/preview/identity/browser-context';
+export class PreviewViewRecoveryError extends Error {
+}
+/** Ordinary navigation inherits the admitted perspective on the server. The
+ * tab's stored view is only for its toolbar/selection, never a reason to reload. */
+export async function ensureStandalonePreviewView(projectId) {
+    if (typeof window === 'undefined' || window.parent !== window)
+        return;
+    if (new URL(window.location.href).searchParams.has('_ss_session') &&
+        !readStandalonePreviewSessionId(projectId)) {
+        throw new PreviewViewRecoveryError('Open Preview from Studio again.');
+    }
+}

package/dist/public-delivery.d.ts

@@ -0,0 +1,6 @@
+import 'server-only';
+import { type PublicRenderReceiptV1 } from '@storystick/client';
+/** Explicit renderer-owned JSON; pass the receipt before crossing an RSC boundary. */
+export declare function PublicDeliveryReceipt({ receipt }: {
+    receipt: PublicRenderReceiptV1 | null;
+}): import("react").JSX.Element | null;

package/dist/public-delivery.js

@@ -0,0 +1,7 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import 'server-only';
+import { PUBLIC_RENDER_RECEIPT_ID, serializePublicRenderReceipt } from '@storystick/client';
+/** Explicit renderer-owned JSON; pass the receipt before crossing an RSC boundary. */
+export function PublicDeliveryReceipt({ receipt }) {
+    return receipt ? _jsx("script", { id: PUBLIC_RENDER_RECEIPT_ID, type: "application/json", dangerouslySetInnerHTML: { __html: serializePublicRenderReceipt(receipt) } }) : null;
+}

package/dist/query-fetch-options.d.ts

@@ -0,0 +1,7 @@
+import type { Transport, TransportRequest } from '@storystick/client/internal';
+export declare const NEXT_QUERY_TAG_MAX_LENGTH = 256;
+export declare const NEXT_QUERY_TAG_MAX_COUNT = 128;
+export declare function withNextQueryOptions(projectId: string, transport: Transport, isPreviewContextSuperseded?: () => Promise<boolean>, staticRendering?: boolean): Transport;
+export declare function normalizeNextQueryRequest(projectId: string, input: TransportRequest, staticRendering?: boolean): TransportRequest;
+/** Scope Next's persistent Data Cache without changing the upstream identity. */
+export declare function deploymentScopedFetch(deploymentId: string | undefined, fetchImpl?: typeof fetch): typeof fetch;

package/dist/query-fetch-options.js

@@ -0,0 +1,193 @@
+import { storystickCacheTag } from './cache-tags.js';
+import { StorystickError } from '@storystick/client';
+import { PREVIEW_CONTEXT_SUPERSEDED_DIGEST, previewReadUnavailableDigest } from './preview-render-error.js';
+export const NEXT_QUERY_TAG_MAX_LENGTH = 256;
+export const NEXT_QUERY_TAG_MAX_COUNT = 128;
+export function withNextQueryOptions(projectId, transport, isPreviewContextSuperseded, staticRendering = false) {
+    return {
+        async request(input) {
+            const normalized = normalizeNextQueryRequest(projectId, input, staticRendering);
+            try {
+                return await transport.request(normalized);
+            }
+            catch (error) {
+                // A context command may supersede an in-flight RSC read, including
+                // its final receipt write. A fresh authority check below keeps the
+                // failed render atomic: retry the render, never individual reads in a
+                // different perspective.
+                if (input.requestContext?.previewToken && isCacheableRead(input.udfPath) &&
+                    error instanceof StorystickError &&
+                    ['storystick/PREVIEW_CONTEXT_INVALID', 'storystick/PREVIEW_RECEIPT_UNAVAILABLE'].includes(error.code ?? '') &&
+                    await isPreviewContextSuperseded?.().catch(() => false)) {
+                    Object.assign(error, { digest: PREVIEW_CONTEXT_SUPERSEDED_DIGEST });
+                    throw error;
+                }
+                // Only SDK reads can attest to an upstream outage. Do not infer it
+                // from customer exception text or change public-page error handling.
+                if (input.requestContext?.previewToken && isCacheableRead(input.udfPath) &&
+                    error instanceof StorystickError &&
+                    error.category === 'system' && error.retryable === true) {
+                    Object.assign(error, { digest: previewReadUnavailableDigest(error.retryAfterMs, Date.now()) });
+                }
+                throw error;
+            }
+        },
+    };
+}
+export function normalizeNextQueryRequest(projectId, input, staticRendering = false) {
+    if (!isCacheableRead(input.udfPath))
+        return input;
+    if (input.requestContext?.previewToken || input.options?.deliveryCache === 'bypass') {
+        return {
+            ...input,
+            options: {
+                ...input.options,
+                cache: 'no-store',
+                next: undefined,
+            },
+        };
+    }
+    const next = input.options?.next;
+    if (next?.revalidate === false || (typeof next?.revalidate === 'number' &&
+        (!Number.isFinite(next.revalidate) || next.revalidate < 0))) {
+        throw queryInvalid('Public framework caching requires a finite positive revalidate TTL.');
+    }
+    if (input.options?.cache === 'force-cache' && (next?.revalidate === undefined || next.revalidate === 0)) {
+        throw queryInvalid('force-cache requires a finite positive revalidate TTL.');
+    }
+    if (input.options?.cache === 'no-store' && next?.revalidate !== undefined && next.revalidate !== 0) {
+        throw queryInvalid('no-store cannot be combined with a non-zero revalidate value.');
+    }
+    if (input.options?.cache === 'force-cache' && next?.revalidate === 0) {
+        throw queryInvalid('force-cache cannot be combined with revalidate: 0.');
+    }
+    // Auto preserves Next's build-time prerendering and draftMode. Static sites
+    // must also namespace their fetch cache by deployment (see server-runtime).
+    if (staticRendering && input.options?.cache === undefined && next?.revalidate === undefined) {
+        return { ...input, options: { ...input.options, next: undefined } };
+    }
+    if (input.options?.cache === 'no-store' || next?.revalidate === 0 || next?.revalidate === undefined) {
+        return {
+            ...input,
+            options: {
+                ...input.options,
+                cache: 'no-store',
+                next: undefined,
+            },
+        };
+    }
+    const automatic = automaticTags(projectId, input);
+    const custom = dedupeAndValidateTags(next?.tags ?? []);
+    const projectTag = storystickCacheTag(`storystick:project:${projectId}`);
+    // Every read must retain project invalidation. Extra automatic tags are
+    // optional precision; they must not make a large story set unreadable.
+    const required = dedupeAndValidateTags([...custom, projectTag]);
+    const tags = Array.from(new Set([...required, ...automatic.map(storystickCacheTag)]))
+        .slice(0, NEXT_QUERY_TAG_MAX_COUNT);
+    return {
+        ...input,
+        options: {
+            ...input.options,
+            cache: input.options?.cache ?? 'force-cache',
+            next: {
+                ...(next?.revalidate !== undefined ? { revalidate: next.revalidate } : {}),
+                tags,
+            },
+        },
+    };
+}
+/** Scope Next's persistent Data Cache without changing the upstream identity. */
+export function deploymentScopedFetch(deploymentId, fetchImpl = globalThis.fetch) {
+    if (!deploymentId)
+        return fetchImpl;
+    return (input, init) => {
+        const headers = new Headers(init?.headers ?? (input instanceof Request ? input.headers : undefined));
+        headers.set('x-storystick-deployment', deploymentId);
+        return fetchImpl(input, { ...init, headers });
+    };
+}
+function isCacheableRead(udfPath) {
+    return udfPath === 'queries:queryV2' ||
+        udfPath === 'queries:getRouteByPathname' ||
+        udfPath === 'queries:listPublishedLocaleRoutes' ||
+        udfPath === 'queries:schemas.current' ||
+        udfPath === 'locales:get';
+}
+function automaticTags(projectId, input) {
+    const tags = [`storystick:project:${projectId}`];
+    if (input.udfPath === 'queries:getRouteByPathname') {
+        if (typeof input.args.pathname === 'string') {
+            tags.push(`storystick:pathname:${input.args.pathname}`);
+        }
+        if (Array.isArray(input.args.storyTypes)) {
+            for (const storyType of input.args.storyTypes) {
+                if (typeof storyType === 'string') {
+                    tags.push(`storystick:type:${storyType}`);
+                }
+            }
+        }
+        return tags;
+    }
+    if (input.udfPath === 'queries:listPublishedLocaleRoutes') {
+        if (Array.isArray(input.args.storyTypes)) {
+            for (const storyType of input.args.storyTypes) {
+                if (typeof storyType === 'string') {
+                    tags.push(`storystick:type:${storyType}`);
+                }
+            }
+        }
+        return tags;
+    }
+    if (input.udfPath !== 'queries:queryV2')
+        return tags;
+    const query = input.args.query && typeof input.args.query === 'object'
+        ? input.args.query
+        : undefined;
+    const storyType = query?.target?.storyType;
+    if (typeof storyType === 'string') {
+        tags.push(`storystick:type:${storyType}`);
+    }
+    const locale = query?.locale?.code;
+    if (typeof locale === 'string') {
+        tags.push(`storystick:locale:${locale}`);
+    }
+    const addressKind = query?.address?.kind;
+    const addressValue = query?.address?.value;
+    if (typeof addressKind === 'string' && typeof addressValue === 'string') {
+        if (addressKind === 'id') {
+            tags.push(`storystick:doc:${addressValue}`);
+        }
+        else if (addressKind === 'pathname') {
+            tags.push(`storystick:pathname:${addressValue}`);
+        }
+        else if (addressKind === 'slug' && typeof storyType === 'string') {
+            tags.push(`storystick:slug:${storyType}:${addressValue}`);
+        }
+    }
+    return tags;
+}
+function dedupeAndValidateTags(tags) {
+    const output = [];
+    const seen = new Set();
+    for (const tag of tags) {
+        if (typeof tag !== 'string' || tag.length === 0 || tag.length > NEXT_QUERY_TAG_MAX_LENGTH) {
+            throw queryInvalid(`Next cache tags must contain 1-${NEXT_QUERY_TAG_MAX_LENGTH} characters.`);
+        }
+        if (seen.has(tag))
+            continue;
+        seen.add(tag);
+        output.push(tag);
+        if (output.length > NEXT_QUERY_TAG_MAX_COUNT) {
+            throw queryInvalid(`Next cache tags cannot exceed ${NEXT_QUERY_TAG_MAX_COUNT} entries.`);
+        }
+    }
+    return output;
+}
+function queryInvalid(message) {
+    return new StorystickError(message, {
+        code: 'storystick/QUERY_INVALID',
+        category: 'validation',
+        recoverable: true,
+        retryable: false,
+    });
+}

package/dist/query.d.ts

@@ -0,0 +1,2 @@
+export { useQuery } from '@storystick/react/query';
+export type { UseQueryOptions, UseQueryResult } from '@storystick/react/query';

package/dist/query.js

@@ -0,0 +1 @@
+export { useQuery } from '@storystick/react/query';

package/dist/rendering.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @storystick/next — Next.js rendering helpers and the global Preview runtime.
+ *
+ * Configure `createSite({ definition })` from `@storystick/next/server` once.
+ * Ordinary async components read with `await site.client()` and Query V2.
+ * Keep `<Storystick />` in a shared native layout and export `site.handlers`
+ * from the SDK HTTP route. CMS routing is optional: `site.resolvePage`,
+ * `site.metadata` and `site.params` compose with Next's native page exports.
+ *
+ * Server-only request APIs live at `./server` and `./preview`; this root stays
+ * client-compatible. See the README for the complete installation.
+ */
+export { createClient, QueryExecutionError, resolveReference, resolveReferences, resolveSafeHref, safeHref, StorystickError, } from '@storystick/client';
+export type { Client, ClientOptions, QueryResult, SelectedDocument, StorystickErrorCategory, StorystickErrorOptions, } from '@storystick/client';
+export { prefixHref, publicPathnameForLocale, readDocumentLocaleRouting, resolveLocalePathname, } from '@storystick/client/locale-routing';
+export type { DocumentLocaleRouting, LocalePathnameResolution, LocaleRouting, LocaleRoutingSettings, RoutingLocale, } from '@storystick/client/locale-routing';
+export { stripPreviewProvenance } from './clean.js';
+export { RichText } from './rich-text.js';
+export { SliceZone, ZoneSlot, Slice, previewTextProps, resolveLink, toText, } from '@storystick/react';
+export { StorystickImage, getNextImageProps, resolveImage, } from './image.js';
+export type { GetNextImagePropsOptions, ResolvedStorystickImage, StorystickAsset, StorystickAssetSidecar, StorystickImageComponentProps, StorystickImageField, StorystickImageFailure, StorystickImageFallback, } from './image.js';
+export { StorystickLink } from './link.js';
+export type { StorystickLinkDocument, StorystickLinkOptions, StorystickLinkProps, StorystickLinkValue, } from './link.js';
+export { StorystickFile, resolveFile } from './file.js';
+export type { StorystickFileComponentProps, StorystickFileFailure, StorystickFileFallback, } from './file.js';
+export { StorystickVideo, resolveVideo } from './video.js';
+export type { StorystickVideoComponentProps, StorystickVideoFailure, StorystickVideoFallback, } from './video.js';
+export type { UseQueryOptions, UseQueryResult } from './query.js';
+export type { PreviewTextProps, PreviewTextValue, SliceElements, SliceRootProps, LinkOptions, LinkProps, LinkStatus, LinkValue, ReferencedDocumentFailureReason, ReferencedDocumentPolicy, ReferencedDocumentSidecarEntry, ReferencedDocumentSidecarFailure, ReferencedDocumentsSidecar, ResolvedLink, RichTextCustomMarkComponentProps, RichTextBlockComponentProps, RichTextCodeComponentProps, RichTextComponents, RichTextInlineProps, RichTextLinkMarkComponentProps, RichTextListComponentProps, RichTextMark, RichTextMarkComponentProps, RichTextNode, RichTextOrderedListComponentProps, RichTextProps, RichTextRenderMode, SliceComponentRegistry, SliceComponentProps, SliceFallback, SliceData, SliceZoneProps, ZoneSlotDescriptor, ZoneSlotKind, ZoneSlotProps, } from '@storystick/react';
+export { Storystick } from './storystick.js';
+export { StorystickErrorRecovery } from './storystick-error-recovery.js';
+export type { StorystickProps } from './storystick.js';
+export { STORYSTICK_PREVIEW_ROBOTS } from './preview-metadata.js';

package/dist/rendering.js

@@ -0,0 +1,42 @@
+/**
+ * @storystick/next — Next.js rendering helpers and the global Preview runtime.
+ *
+ * Configure `createSite({ definition })` from `@storystick/next/server` once.
+ * Ordinary async components read with `await site.client()` and Query V2.
+ * Keep `<Storystick />` in a shared native layout and export `site.handlers`
+ * from the SDK HTTP route. CMS routing is optional: `site.resolvePage`,
+ * `site.metadata` and `site.params` compose with Next's native page exports.
+ *
+ * Server-only request APIs live at `./server` and `./preview`; this root stays
+ * client-compatible. See the README for the complete installation.
+ */
+// `StorystickError` is the source-compat re-export from `@storystick/client`
+// (ADR-091 Consequences > @storystick/next). `instanceof` checks resolve
+// to the same class identity across `@storystick/next` and `@storystick/client`
+// import paths.
+export { createClient, QueryExecutionError, resolveReference, resolveReferences, resolveSafeHref, safeHref, StorystickError, } from '@storystick/client';
+export { prefixHref, publicPathnameForLocale, readDocumentLocaleRouting, resolveLocalePathname, } from '@storystick/client/locale-routing';
+export { stripPreviewProvenance } from './clean.js';
+export { RichText } from './rich-text.js';
+// Re-export react bindings for convenience.
+export { SliceZone, ZoneSlot, Slice, previewTextProps, resolveLink, toText, } from '@storystick/react';
+export { StorystickImage, getNextImageProps, resolveImage, } from './image.js';
+export { StorystickLink } from './link.js';
+export { StorystickFile, resolveFile } from './file.js';
+export { StorystickVideo, resolveVideo } from './video.js';
+// Mount once in a shared layout, alongside its children. The Next wrapper
+// supplies the deploy code version without introducing a render provider.
+export { Storystick } from './storystick.js';
+export { StorystickErrorRecovery } from './storystick-error-recovery.js';
+export { STORYSTICK_PREVIEW_ROBOTS } from './preview-metadata.js';
+// ADR-087 Lane D' — the Next-specific preview navigation adapter
+// lives at the `@storystick/next/preview-nav` subpath. We do NOT
+// re-export it from this root entry because the root entry is
+// imported by client components and server components alike, and
+// the hook drags `next/compat/router` into both.
+//
+// Consumers import the hook explicitly :
+//
+//   import { useStorystickPreviewNavigation } from '@storystick/next/preview-nav'
+//
+// See `README.md` "Preview navigation" section for usage.

package/dist/revalidate.d.ts

@@ -0,0 +1,12 @@
+import 'server-only';
+import { signWebhookBody } from '@storystick/client/adapter';
+export interface StorystickRevalidateHandlerOptions {
+    secret?: string | (() => string | undefined);
+    projectId?: string | (() => string | undefined);
+    signatureHeader?: string;
+}
+/** Next 15 revalidateTag expires the project's Data Cache synchronously. This
+ * acknowledges the effect only; the publisher separately verifies rendered HTML. */
+export declare function createStorystickRevalidateHandler(options?: StorystickRevalidateHandlerOptions): (request: Request) => Promise<Response>;
+export declare const POST: (request: Request) => Promise<Response>;
+export declare const createStorystickWebhookSignature: typeof signWebhookBody;

package/dist/revalidate.js

@@ -0,0 +1,33 @@
+import 'server-only';
+import { storystickCacheTag } from './cache-tags.js';
+import { readSignedWebhook, signWebhookBody } from '@storystick/client/adapter';
+import { isPublicationEvent } from '@storystick/types/publication';
+import { revalidateTag } from 'next/cache';
+/** Next 15 revalidateTag expires the project's Data Cache synchronously. This
+ * acknowledges the effect only; the publisher separately verifies rendered HTML. */
+export function createStorystickRevalidateHandler(options = {}) {
+    return async (request) => {
+        const json = (value, status = 200) => Response.json(value, { status, headers: { 'Cache-Control': 'no-store' } });
+        if (request.method !== 'POST')
+            return new Response(null, { status: 405, headers: { Allow: 'POST', 'Cache-Control': 'no-store' } });
+        const secret = (typeof options.secret === 'function' ? options.secret() : options.secret) ?? process.env.STORYSTICK_WEBHOOK_SECRET;
+        const projectId = (typeof options.projectId === 'function' ? options.projectId() : options.projectId) ?? process.env.STORYSTICK_PROJECT_ID;
+        if (!secret || !projectId)
+            return json({ error: 'webhook_not_configured' }, 500);
+        const result = await readSignedWebhook(request, { secret, signatureHeader: options.signatureHeader });
+        if (!result.ok)
+            return json({ error: result.error }, result.status);
+        const event = result.payload;
+        if (!isPublicationEvent(event) || event.projectId !== projectId)
+            return json({ error: 'publication_invalid' }, 400);
+        try {
+            revalidateTag(storystickCacheTag(`storystick:project:${projectId}`));
+        }
+        catch {
+            return json({ error: 'publication_effect_failed' }, 503);
+        }
+        return json({ version: 2, projectId, id: event.id, effect: 'completed' });
+    };
+}
+export const POST = createStorystickRevalidateHandler();
+export const createStorystickWebhookSignature = signWebhookBody;

package/dist/rich-text.d.ts

@@ -0,0 +1,2 @@
+export { RichText, toText } from '@storystick/react/rich-text';
+export type { RichTextCustomMarkComponentProps, RichTextBlockComponentProps, RichTextCodeComponentProps, RichTextComponents, RichTextInlineProps, RichTextLinkMarkComponentProps, RichTextListComponentProps, RichTextMark, RichTextMarkComponentProps, RichTextNode, RichTextOrderedListComponentProps, RichTextProps, RichTextRenderMode, } from '@storystick/react/rich-text';

package/dist/rich-text.js

@@ -0,0 +1 @@
+export { RichText, toText } from '@storystick/react/rich-text';