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

package/dist/server.d.ts

@@ -0,0 +1,8 @@
+import 'server-only';
+export { PublicDeliveryReceipt } from './public-delivery.js';
+export { StorystickError } from '@storystick/client';
+export type { StorystickErrorCategory, StorystickErrorOptions, ResolveRouteInput, ResolvedRoute } from '@storystick/client';
+export { stripPreviewProvenance } from './clean.js';
+export { STORYSTICK_PREVIEW_ROBOTS } from './preview-metadata.js';
+export { createSite, createServerClient, resolvePage, buildStorystickSitemap, buildStorystickSitemapShards, STORYSTICK_SITEMAP_MAX_URLS, storystickAlternates, } from './server-runtime.js';
+export type { SiteDefinition, CreateSiteOptions, StorystickSitemapBuildOptions, ResolvePageDataCondition, ResolvePageDataDeclaration, ResolvePageDataDeclarations, ResolvedPageData, ResolvePageRouteInput, ResolvePageInput, ResolvedRouteForSchema, ResolvedRouteWithPageData, TypedResolvePageInput, ResolvedDocumentRoute, StorystickAlternatesOptions, StorystickPublishedLocaleRoute, StorystickSitemapOptions, } from './server-runtime.js';

package/dist/server.js

@@ -0,0 +1,6 @@
+import 'server-only';
+export { PublicDeliveryReceipt } from './public-delivery.js';
+export { StorystickError } from '@storystick/client';
+export { stripPreviewProvenance } from './clean.js';
+export { STORYSTICK_PREVIEW_ROBOTS } from './preview-metadata.js';
+export { createSite, createServerClient, resolvePage, buildStorystickSitemap, buildStorystickSitemapShards, STORYSTICK_SITEMAP_MAX_URLS, storystickAlternates, } from './server-runtime.js';

package/dist/slice-zone.d.ts

@@ -0,0 +1,2 @@
+export { SliceZone, ZoneSlot } from '@storystick/react/slice-zone';
+export type { SliceComponentProps, SliceComponentRegistry, SliceData, SliceFallback, SliceRenderFailure, SliceZoneProps, ZoneSlotDescriptor, ZoneSlotKind, ZoneSlotProps, } from '@storystick/react/slice-zone';

package/dist/slice-zone.js

@@ -0,0 +1 @@
+export { SliceZone, ZoneSlot } from '@storystick/react/slice-zone';

package/dist/storystick-component-types.d.ts

@@ -0,0 +1,26 @@
+export interface StorystickClientProps {
+    /** Defaults to `process.env.NEXT_PUBLIC_STORYSTICK_PROJECT_ID`. */
+    projectId?: string;
+    /** Deploy/build signature exposed to the Preview iframe runtime. */
+    codeVersion?: string;
+    /** Explicit iframe Convex sync URL for self-hosted deployments. */
+    gatewaySyncUrl?: string;
+    /** Explicit iframe HTTP gateway URL for self-hosted deployments. */
+    endpoint?: string;
+    /** Publishable key used to construct the Preview HTTP client. */
+    publishableKey?: string;
+    /** Customer Next.js basePath, for example `/admin`. */
+    basePath?: string;
+}
+/** @internal Props resolved by the server wrapper before the iframe runtime loads. */
+export interface StorystickPreviewRuntimeProps extends StorystickClientProps {
+    readonly previewServerRenderReceipt?: import('@storystick/preview/framework/render-receipt').PreviewFrameworkRenderReceipt | null;
+    /** @internal Client error-boundary reset; never passed across an RSC boundary. */
+    readonly resetRenderError?: () => void;
+    /** @internal Safe Next server-error classification, including production redaction. */
+    readonly renderErrorDigest?: string;
+    readonly previewProvenanceRuntimeEnabled?: boolean;
+    readonly previewProvenanceRuntimeSrc?: string;
+    /** @internal Bilateral dogfood gate; false unless the server wrapper arms it. */
+    readonly previewLiveQueryOverlayEnabled?: boolean;
+}

package/dist/storystick-component-types.js

@@ -0,0 +1 @@
+export {};

package/dist/storystick-component.d.ts

@@ -0,0 +1,10 @@
+import type { ReactElement } from "react";
+import type { StorystickClientProps, StorystickPreviewRuntimeProps } from "./storystick-component-types.js";
+export type StorystickProps = StorystickClientProps;
+/**
+ * Tiny client boundary present in every customer layout. The Preview runtime
+ * is loaded only inside an iframe or an explicitly activated standalone
+ * preview tab. A normal top-level customer page still returns `null` and never
+ * downloads the runtime chunk.
+ */
+export declare function Storystick(props?: StorystickPreviewRuntimeProps): ReactElement | null;

package/dist/storystick-component.js

@@ -0,0 +1,45 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { isPreviewBrowserContext } from "@storystick/preview/framework/browser-context";
+import { useEffect, useLayoutEffect, useState, useSyncExternalStore } from "react";
+import { commitPreviewRenderReceipt } from '@storystick/preview/framework/render-receipt';
+function subscribeEmbeddingContext() {
+    // A browsing context cannot move in or out of its parent without a new
+    // document, so there is no live event source to subscribe to.
+    return () => { };
+}
+function getServerEmbeddingContext() {
+    return false;
+}
+// The mount-time gate knows the project supplied through props. A module-scope
+// preload cannot safely identify a stored view when that prop overrides env.
+/**
+ * Tiny client boundary present in every customer layout. The Preview runtime
+ * is loaded only inside an iframe or an explicitly activated standalone
+ * preview tab. A normal top-level customer page still returns `null` and never
+ * downloads the runtime chunk.
+ */
+export function Storystick(props = {}) {
+    useLayoutEffect(() => {
+        if (props.previewServerRenderReceipt)
+            return commitPreviewRenderReceipt(props.previewServerRenderReceipt);
+    }, [props.previewServerRenderReceipt]);
+    const active = useSyncExternalStore(subscribeEmbeddingContext, () => isPreviewBrowserContext(props.projectId ?? process.env.NEXT_PUBLIC_STORYSTICK_PROJECT_ID), getServerEmbeddingContext);
+    const [runtime, setRuntime] = useState({ module: null, failed: false });
+    useEffect(() => {
+        if (!active)
+            return;
+        let mounted = true;
+        // The ESM module loader owns download deduplication. No second module store.
+        void import("./storystick-preview-runtime.js").then(module => { if (mounted)
+            setRuntime({ module, failed: false }); }, () => { if (mounted)
+            setRuntime({ module: null, failed: true }); });
+        return () => { mounted = false; };
+    }, [active]);
+    if (!active)
+        return null;
+    if (runtime.failed)
+        return (_jsxs("aside", { role: "alert", children: ["Preview could not start because its runtime could not be loaded.", _jsx("button", { type: "button", onClick: () => window.location.reload(), children: "Reload Preview" })] }));
+    const Runtime = runtime.module?.StorystickPreviewRuntime;
+    return Runtime ? _jsx(Runtime, { ...props }) : null;
+}

package/dist/storystick-error-recovery.d.ts

@@ -0,0 +1,12 @@
+import type { StorystickClientProps } from './storystick-component-types.js';
+/**
+ * Mount beside the customer's error UI in Next's error.tsx. Keeps Preview
+ * controllable even when that boundary replaces the layout's Storystick.
+ * A normal public visit does not load the Preview runtime.
+ */
+export declare function StorystickErrorRecovery({ error, reset, ...props }: StorystickClientProps & {
+    error: Error & {
+        digest?: string;
+    };
+    reset: () => void;
+}): import("react").JSX.Element;

package/dist/storystick-error-recovery.js

@@ -0,0 +1,11 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Storystick } from './storystick-component.js';
+/**
+ * Mount beside the customer's error UI in Next's error.tsx. Keeps Preview
+ * controllable even when that boundary replaces the layout's Storystick.
+ * A normal public visit does not load the Preview runtime.
+ */
+export function StorystickErrorRecovery({ error, reset, ...props }) {
+    return _jsx(Storystick, { ...props, resetRenderError: reset, renderErrorDigest: error.digest });
+}

package/dist/storystick-preview-runtime.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `<Storystick />` — Client Component sibling that initializes the
+ * preview runtime singleton (ADR-099 D11).
+ *
+ * Customer layouts keep their native children and mount <Storystick /> once.
+ * Independent layout reads use site.client(); they never replace the page subtree.
+ *
+ * Responsibilities:
+ *   - Initialize the singleton on mount (idempotent under StrictMode).
+ *   - Subscribe via `useSyncExternalStore` to surface state changes
+ *     (mainly so React tears the fence on `'error'` for adapters that
+ *     consume the state via context, future-compat).
+ *   - Coalesce ready projected generations into native server refreshes,
+ *     preserving the current tree while a React transition is pending.
+ *   - Render nothing in non-preview mode (state stays `'idle'`).
+ *   - Render the self-contained error UI when state goes terminal
+ *     (CSO-PREVIEW-1 visible failure).
+ *
+ * The component is `'use client'` — server contexts that import it
+ * via the Next package's main entry get the client boundary
+ * automatically. Server-only helpers (`resolvePreviewDraft`,
+ * `isPreviewDraftActive`) live behind the `./server` subpath which
+ * is `'server-only'`. The two paths cannot be imported into the
+ * same module, but the customer's layout (a Server Component) imports
+ * `Storystick` from the main entry and Next renders it as a Client
+ * Boundary at runtime.
+ */
+import type { ReactElement } from "react";
+import type { StorystickPreviewRuntimeProps } from "./storystick-component-types.js";
+export declare function StorystickPreviewRuntime(props?: StorystickPreviewRuntimeProps): ReactElement | null;