@pantheon-systems/p1-next-sdk 0.13.0 → 0.14.0

package/bin/lib/transform.js

@@ -245,13 +245,112 @@ export function rewriteLoadingOverlay(source) {
   return out;
 }
 
-/** Full editor-client transform: deepen imports, add the named imports, rewrite the signature, adopt the SDK overlay. */
+/**
+ * The auto-create-on-404 behaviour is gone. It POSTed to `/p1/api/structure/page`,
+ * a route no SDK handler ever served, so opening an editor path for a page that
+ * did not exist silently did nothing. The editor now renders a page-not-found
+ * panel in the canvas — chrome and all — offering to create the page, and both
+ * halves of that live in the SDK so they version together. Every trace of the old
+ * client-side half comes out.
+ *
+ * Every anchor has to match: an app already on the SDK flow is left alone, and an
+ * app that edited part of this region keeps its own version rather than being left
+ * with a broken mix of the two.
+ */
+const NOT_FOUND_EDITS = [
+  [
+    `const DEFAULT_PAGE_DATA = {
+  root: { props: { title: "New page" } },
+  content: [],
+  zones: {},
+};
+
+const DEFAULT_ROOT_PAGE_DATA = {
+  root: { props: { title: "Welcome | P1 site" } },
+  content: [
+    {
+      type: "P1WelcomeBlock",
+      props: {
+        id: "seed-welcome",
+        heading: "Welcome to your new Pantheon P1 Site.",
+        description: "You just created this new site from Pantheon P1 starter kit, congrats! You'll need a Pantheon P1 user account to edit it and create new pages.",
+        ctaLabel: "Sign-in to P1",
+        ctaHref: "/p1",
+        footnote: "Visit [P1 documentation](https://docs.pantheon.io) for more information.",
+        loggedInHeading: "Welcome to your new Pantheon P1 Site.",
+        loggedInDescription: "You just created this new site from Pantheon P1 starter kit, congrats! Start editing this page or visit the P1 dashboard to manage your site.",
+        loggedInCtaLabel: "Edit this page with P1 Visual Editor",
+        loggedInCtaHref: "/p1",
+        loggedInSecondaryLabel: "Go to P1 Dashboard",
+        loggedInFootnote: "Visit [P1 documentation](https://docs.pantheon.io) for more information.",
+        showLogo: true,
+      },
+    },
+  ],
+  zones: {},
+};
+
+`,
+    ``,
+  ],
+  [
+    `  const router = useRouter();
+  const { getToken } = useP1Auth();
+`,
+    `  const router = useRouter();
+`,
+  ],
+  [
+    `  const handleDocumentNotFound = useCallback(
+    async (docPath: string, _error: Error) => {
+      const initialData = docPath === "/" ? DEFAULT_ROOT_PAGE_DATA : DEFAULT_PAGE_DATA;
+      const token = await getToken();
+      const headers: Record<string, string> = { "Content-Type": "application/json" };
+      if (token) headers["Authorization"] = \`Bearer \${token}\`;
+      const res = await fetch("/p1/api/structure/page", {
+        method: "POST",
+        headers,
+        body: JSON.stringify({ path: docPath, initialData }),
+      });
+      return res.ok;
+    },
+    [getToken],
+  );
+
+`,
+    ``,
+  ],
+  [
+    `    additionalPlugins,
+    onDocumentNotFound: handleDocumentNotFound,
+`,
+    `    additionalPlugins,
+`,
+  ],
+];
+
+/** Strip the dead auto-create-on-404 call; the SDK owns the page-not-found flow now. */
+export function rewriteDocumentNotFound(source) {
+  const found = NOT_FOUND_EDITS.filter(([find]) => source.includes(find));
+  if (found.length === 0) return source;
+  if (found.length !== NOT_FOUND_EDITS.length) {
+    throw new BailError(
+      "editor-client.tsx has a partly-customized page-not-found flow; migrate this file by hand.",
+    );
+  }
+  let out = source;
+  for (const [find, replace] of NOT_FOUND_EDITS) out = out.replace(find, replace);
+  return out;
+}
+
+/** Full editor-client transform: deepen imports, add the named imports, rewrite the signature, adopt the SDK overlay and page-not-found flow. */
 export function rewriteEditorClient(source) {
   let out = deepenRelativeImports(source);
   out = addNamedImport(out, "next/navigation", "usePathname", "prepend");
   out = addNamedImport(out, "@pantheon-systems/p1-next-sdk", "editorPagePathFromUrlPath", "append");
   out = rewriteWrapperSignature(out);
   out = rewriteLoadingOverlay(out);
+  out = rewriteDocumentNotFound(out);
   return out;
 }
 

package/dist/create-published-page.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Route builders for the published-page render pipeline.
+ *
+ * The pipeline itself — read the page, branch on the outcome, resolve route
+ * templates and remote datasources, render — is the same for every P1 site, and
+ * carries the invariants documented in published-page.ts. Hand-assembling it in
+ * each app's route files froze a copy of it into every scaffold, so improvements
+ * to caching or datasource resolution could never reach a project once it was
+ * created. It lives here instead, and the routes become shims.
+ *
+ * What genuinely differs per app flows in as options: the render client (which
+ * holds that app's puck.config), the components shown when content is
+ * unavailable or the home page has no document yet, the app's datasource
+ * fetcher registry, and how it turns page data into <head> metadata.
+ *
+ * Usage:
+ *   // app/published-pages.tsx (shared module — one instance, both routes)
+ *   import { createPublishedPage } from "@pantheon-systems/p1-next-sdk/server";
+ *   export const published = createPublishedPage({ ... });
+ *
+ *   // app/[...puckPath]/page.tsx
+ *   export const revalidate = 300;
+ *   export default published.Page;
+ *   export const generateMetadata = published.generateMetadata;
+ *   export const generateStaticParams = published.generateStaticParams;
+ *
+ *   // app/page.tsx
+ *   export const revalidate = 300;
+ *   export default published.HomePage;
+ *   export const generateMetadata = published.generateHomeMetadata;
+ *
+ * `revalidate` must stay a literal in the route file. Next.js statically
+ * analyzes segment-config exports, so re-exporting one through the factory
+ * leaves it undetected and the route silently loses its revalidation window —
+ * the same constraint that keeps `dynamic` in the route file for createP1Pages.
+ */
+import type { Metadata } from "next";
+import { type RemoteDatasourceFetcher } from "@pantheon-systems/puck-css/server";
+import type { Data } from "@puckeditor/core";
+/**
+ * Describes the rendered document to the render client, which uses it for the
+ * edit affordances that only make sense once a real document is on screen.
+ */
+export type PublishedPageMetadata = {
+    route: string;
+    documentName?: string;
+    pageType?: "page" | "template" | "override";
+};
+export type PublishedPageClientProps = {
+    data: Data;
+    pageMetadata: PublishedPageMetadata;
+};
+export type CreatePublishedPageConfig = {
+    /**
+     * Renders resolved Puck data. Holds the app's puck.config, which is why this
+     * cannot live in the SDK.
+     */
+    Client: React.ComponentType<PublishedPageClientProps>;
+    /**
+     * Rendered instead of a 404 when the backend could not be reached. A
+     * published page must not 404 over a blip — that deindexes live content — so
+     * this is a 200 holding page on a render the SDK has already made uncacheable.
+     */
+    Unavailable: React.ComponentType;
+    /**
+     * Rendered at "/" when no home document exists. Unlike the catch-all, "/"
+     * never 404s: it is a single fixed URL rather than an unbounded crawler
+     * surface, and a welcome state is the right answer for a freshly scaffolded
+     * site — including one with no backend configured yet.
+     */
+    Fallback: React.ComponentType;
+    /** The app's remote-datasource fetcher registry. */
+    fetchers?: RemoteDatasourceFetcher[];
+    /**
+     * Turns published page data into <head> metadata. Called only for a page that
+     * actually resolved; the miss and outage titles come from `titles`.
+     */
+    resolveMetadata?: (args: {
+        pageData: Data;
+        path: string;
+    }) => Metadata | Promise<Metadata>;
+    titles?: {
+        /** Catch-all, no such page. Default "Not Found". */
+        notFound?: string;
+        /** Backend unreachable. Default "Temporarily unavailable". */
+        unavailable?: string;
+        /** "/" with no home document yet — pairs with `Fallback`. Default "Home". */
+        home?: string;
+    };
+    /** Extra internal path prefixes to refuse, on top of the SDK's own list. */
+    internalPathPrefixes?: readonly string[];
+};
+export declare function createPublishedPage(config: CreatePublishedPageConfig): {
+    Page: ({ params, }: {
+        params: Promise<{
+            puckPath: string[];
+        }>;
+    }) => Promise<import("react").JSX.Element>;
+    HomePage: () => Promise<import("react").JSX.Element>;
+    generateMetadata: ({ params, }: {
+        params: Promise<{
+            puckPath: string[];
+        }>;
+    }) => Promise<Metadata>;
+    generateHomeMetadata: () => Promise<Metadata>;
+    generateStaticParams: () => {
+        puckPath: string[];
+    }[];
+};
+//# sourceMappingURL=create-published-page.d.ts.map

package/dist/create-published-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-published-page.d.ts","sourceRoot":"","sources":["../src/create-published-page.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAErC,OAAO,EAKL,KAAK,uBAAuB,EAC7B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAS7C;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,IAAI,CAAC;IACX,YAAY,EAAE,qBAAqB,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC;;;OAGG;IACH,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,wBAAwB,CAAC,CAAC;IACtD;;;;OAIG;IACH,WAAW,EAAE,KAAK,CAAC,aAAa,CAAC;IACjC;;;;;OAKG;IACH,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC;IAC9B,oDAAoD;IACpD,QAAQ,CAAC,EAAE,uBAAuB,EAAE,CAAC;IACrC;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE;QACvB,QAAQ,EAAE,IAAI,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE;QACP,oDAAoD;QACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,8DAA8D;QAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,6EAA6E;QAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,4EAA4E;IAC5E,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,yBAAyB;wBAuFhE;QACD,MAAM,EAAE,OAAO,CAAC;YAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAC;KACzC;;oCAZE;QACD,MAAM,EAAE,OAAO,CAAC;YAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAC;KACzC,KAAG,OAAO,CAAC,QAAQ,CAAC;gCA2BkB,OAAO,CAAC,QAAQ,CAAC;gCAnCvB;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE;EA0D1D"}

package/dist/create-published-page.js

@@ -0,0 +1,86 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { cache } from "react";
+import { notFound } from "next/navigation";
+import { loadRemoteDatasourceContext, extractReferencedDatasourceIds, resolveDataTemplates, pagePathFromCatchAllSegments, } from "@pantheon-systems/puck-css/server";
+import { createCssQueryFetchers } from "./css-query-fetchers";
+import { loadPublishedPage, loadRouteTemplateKeys, } from "./published-page";
+export function createPublishedPage(config) {
+    const { Client, Unavailable, Fallback, fetchers = [], resolveMetadata, titles, internalPathPrefixes, } = config;
+    const loadOptions = internalPathPrefixes ? { internalPathPrefixes } : undefined;
+    const getCssQueryFetchers = cache(() => createCssQueryFetchers());
+    async function resolve(path, data) {
+        const [routeTemplateKeys, cssQueryFetchers] = await Promise.all([
+            loadRouteTemplateKeys(),
+            getCssQueryFetchers(),
+        ]);
+        const context = await loadRemoteDatasourceContext({
+            fetchImpl: fetch,
+            pagePath: path,
+            routeTemplateKeys,
+            builtinFetchers: [...fetchers, ...cssQueryFetchers],
+            referencedDatasourceIds: extractReferencedDatasourceIds(data),
+        });
+        return resolveDataTemplates(data, context);
+    }
+    async function render(path, data) {
+        const resolvedData = await resolve(path, data);
+        return (_jsx(Client, { data: resolvedData, pageMetadata: {
+                route: path,
+                documentName: data.root.props?.title,
+                pageType: "page",
+            } }));
+    }
+    async function metadataFor(result, path) {
+        if (result.status === "missing") {
+            return { title: titles?.notFound ?? "Not Found" };
+        }
+        if (result.status === "unavailable") {
+            return { title: titles?.unavailable ?? "Temporarily unavailable" };
+        }
+        return resolveMetadata
+            ? resolveMetadata({ pageData: result.data, path })
+            : {};
+    }
+    function generateStaticParams() {
+        return [];
+    }
+    async function generateMetadata({ params, }) {
+        const { puckPath = [] } = await params;
+        const path = pagePathFromCatchAllSegments(puckPath);
+        return metadataFor(await loadPublishedPage(path, loadOptions), path);
+    }
+    async function Page({ params, }) {
+        const { puckPath = [] } = await params;
+        const path = pagePathFromCatchAllSegments(puckPath);
+        const result = await loadPublishedPage(path, loadOptions);
+        if (result.status === "missing") {
+            notFound();
+        }
+        if (result.status === "unavailable") {
+            return _jsx(Unavailable, {});
+        }
+        return render(path, result.data);
+    }
+    async function generateHomeMetadata() {
+        const result = await loadPublishedPage("/", loadOptions);
+        if (result.status !== "ok") {
+            return { title: titles?.home ?? "Home" };
+        }
+        return metadataFor(result, "/");
+    }
+    async function HomePage() {
+        const result = await loadPublishedPage("/", loadOptions);
+        if (result.status !== "ok") {
+            return _jsx(Fallback, {});
+        }
+        return render("/", result.data);
+    }
+    return {
+        Page,
+        HomePage,
+        generateMetadata,
+        generateHomeMetadata,
+        generateStaticParams,
+    };
+}
+//# sourceMappingURL=create-published-page.js.map

package/dist/create-published-page.js.map

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

package/dist/published-page.d.ts

@@ -5,9 +5,10 @@
  * invariants that keep public routes cacheable and correct: initialization is
  * awaited per read so a failed cold start can recover, a miss is reported
  * distinctly from an outage so it can become a real 404 instead of a cached
- * 200, and prerendering is aborted rather than baking an empty page into the
- * build. A renderer that gets any of those wrong fails in ways that only show
- * up under CDN caching or a backend blip.
+ * 200, internal document namespaces are refused before they can render as
+ * public pages, and prerendering is aborted rather than baking an empty page
+ * into the build. A renderer that gets any of those wrong fails in ways that
+ * only show up under CDN caching or a backend blip.
  *
  * How a miss is presented — the copy, the styling, the editor links — is the
  * app's business, and stays in the app.
@@ -30,13 +31,25 @@ export type PublishedPageResult = {
 } | {
     status: "unavailable";
 };
+/**
+ * Options for a published-page read.
+ */
+export type LoadPublishedPageOptions = {
+    /**
+     * Extra path prefixes to refuse, added to the built-in list rather than
+     * replacing it. Additive on purpose: a site that needs its own internal
+     * namespace should not be able to un-block `/_registry` by supplying a
+     * shorter list.
+     */
+    internalPathPrefixes?: readonly string[];
+};
 /**
  * Published Puck data for `path`.
  *
- * Memoized with cache(): generateMetadata and the page body both need the same
- * page, and without this every render reads it from the backend twice.
+ * Internal namespaces report `missing` without reaching the backend, so a
+ * renderer that carries no denylist of its own still 404s them.
  */
-export declare const loadPublishedPage: (path: string) => Promise<PublishedPageResult>;
+export declare function loadPublishedPage(path: string, options?: LoadPublishedPageOptions): Promise<PublishedPageResult>;
 /**
  * Collection template keys for the current render.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"published-page.d.ts","sourceRoot":"","sources":["../src/published-page.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AASH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAC5B;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC;AAkC9B;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,SACf,MAAM,KAAG,OAAO,CAAC,mBAAmB,CASlD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,QAAmB,OAAO,CAAC,MAAM,EAAE,CAGnE,CAAC"}
+{"version":3,"file":"published-page.d.ts","sourceRoot":"","sources":["../src/published-page.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AASH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAC5B;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC;AAE9B;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C,CAAC;AAuEF;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAK9B;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,QAAmB,OAAO,CAAC,MAAM,EAAE,CAGnE,CAAC"}

package/dist/published-page.js

@@ -1,6 +1,14 @@
 import { cache } from "react";
 import { connection } from "next/server";
 import { ensureInitialized, getPage, listRouteTemplateKeysFromDatabase, } from "@pantheon-systems/puck-css/server";
+const INTERNAL_PATH_PREFIXES = ["/_registry", "/_redirects"];
+function isInternalPath(path, extra) {
+    const normalized = path.toLowerCase();
+    return [...INTERNAL_PATH_PREFIXES, ...(extra ?? [])].some((prefix) => {
+        const target = prefix.toLowerCase();
+        return normalized === target || normalized.startsWith(`${target}/`);
+    });
+}
 const initP1 = () => ensureInitialized({
     p1BaseUrl: process.env.NEXT_PUBLIC_CSS_BASE_URL,
     p1ApiKey: process.env.CSS_API_KEY,
@@ -12,7 +20,7 @@ async function unavailable(path, error) {
     await connection();
     return { status: "unavailable" };
 }
-export const loadPublishedPage = cache(async (path) => {
+const readPublishedPage = cache(async (path) => {
     try {
         await initP1();
         const data = await getPage(path);
@@ -22,6 +30,12 @@ export const loadPublishedPage = cache(async (path) => {
         return unavailable(path, error);
     }
 });
+export async function loadPublishedPage(path, options) {
+    if (isInternalPath(path, options?.internalPathPrefixes)) {
+        return { status: "missing" };
+    }
+    return readPublishedPage(path);
+}
 export const loadRouteTemplateKeys = cache(async () => {
     await initP1();
     return listRouteTemplateKeysFromDatabase();

package/dist/published-page.js.map

@@ -1 +1 @@
-{"version":3,"file":"published-page.js","sourceRoot":"","sources":["../src/published-page.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,iBAAiB,EACjB,OAAO,EACP,iCAAiC,GAClC,MAAM,mCAAmC,CAAC;AAuB3C,MAAM,MAAM,GAAG,GAAG,EAAE,CAClB,iBAAiB,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB;IAC/C,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW;IACjC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB;IAG7C,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,MAAM;CAC5D,CAAC,CAAC;AAEL,KAAK,UAAU,WAAW,CACxB,IAAY,EACZ,KAAc;IAEd,OAAO,CAAC,IAAI,CACV,mDAAmD,IAAI,GAAG,EAC1D,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;IAKF,MAAM,UAAU,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;AACnC,CAAC;AAQD,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,CACpC,KAAK,EAAE,IAAY,EAAgC,EAAE;IACnD,IAAI,CAAC;QACH,MAAM,MAAM,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;AACH,CAAC,CACF,CAAC;AAQF,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC,KAAK,IAAuB,EAAE;IACvE,MAAM,MAAM,EAAE,CAAC;IACf,OAAO,iCAAiC,EAAE,CAAC;AAC7C,CAAC,CAAC,CAAC"}
+{"version":3,"file":"published-page.js","sourceRoot":"","sources":["../src/published-page.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,iBAAiB,EACjB,OAAO,EACP,iCAAiC,GAClC,MAAM,mCAAmC,CAAC;AAiC3C,MAAM,sBAAsB,GAAG,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;AAO7D,SAAS,cAAc,CAAC,IAAY,EAAE,KAAyB;IAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACtC,OAAO,CAAC,GAAG,sBAAsB,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QACnE,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QACpC,OAAO,UAAU,KAAK,MAAM,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;AACL,CAAC;AAQD,MAAM,MAAM,GAAG,GAAG,EAAE,CAClB,iBAAiB,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB;IAC/C,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW;IACjC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB;IAG7C,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,MAAM;CAC5D,CAAC,CAAC;AAEL,KAAK,UAAU,WAAW,CACxB,IAAY,EACZ,KAAc;IAEd,OAAO,CAAC,IAAI,CACV,mDAAmD,IAAI,GAAG,EAC1D,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;IAKF,MAAM,UAAU,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;AACnC,CAAC;AASD,MAAM,iBAAiB,GAAG,KAAK,CAC7B,KAAK,EAAE,IAAY,EAAgC,EAAE;IACnD,IAAI,CAAC;QACH,MAAM,MAAM,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;AACH,CAAC,CACF,CAAC;AAQF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAY,EACZ,OAAkC;IAElC,IAAI,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,oBAAoB,CAAC,EAAE,CAAC;QACxD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;IACD,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAQD,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC,KAAK,IAAuB,EAAE;IACvE,MAAM,MAAM,EAAE,CAAC;IACf,OAAO,iCAAiC,EAAE,CAAC;AAC7C,CAAC,CAAC,CAAC"}

package/dist/routes/remote-datasources-api.d.ts

@@ -14,7 +14,7 @@ export declare function postRemoteDatasources(request: Request): Promise<NextRes
     error: string;
 }> | NextResponse<{
     ok: boolean;
-    scope: "global" | "page";
+    scope: "page" | "global";
     path: string;
     id: string;
 }>>;
@@ -23,7 +23,7 @@ export declare function deleteRemoteDatasources(request: Request): Promise<NextR
     error: string;
 }> | NextResponse<{
     ok: boolean;
-    scope: "global" | "page";
+    scope: "page" | "global";
     path: string;
     id: string;
 }>>;

package/dist/server.d.ts

@@ -3,5 +3,6 @@ export { createP1AuthHandler, type P1AuthHandlerConfig } from "./auth-handler";
 export { createP1Pages, type P1PagesConfig } from "./pages-handler";
 export { createCssQueryFetchers, type CreateCssQueryFetchersOptions } from "./css-query-fetchers";
 export { createP1Middleware, type P1MiddlewareConfig } from "./middleware";
-export { loadPublishedPage, loadRouteTemplateKeys, type PublishedPageResult, } from "./published-page";
+export { createPublishedPage, type CreatePublishedPageConfig, type PublishedPageClientProps, type PublishedPageMetadata, } from "./create-published-page";
+export { loadPublishedPage, loadRouteTemplateKeys, type LoadPublishedPageOptions, type PublishedPageResult, } from "./published-page";
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,KAAK,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAClG,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,KAAK,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAClG,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EACL,mBAAmB,EACnB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,GAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAC"}

package/dist/server.js

@@ -3,5 +3,6 @@ export { createP1AuthHandler } from "./auth-handler";
 export { createP1Pages } from "./pages-handler";
 export { createCssQueryFetchers } from "./css-query-fetchers";
 export { createP1Middleware } from "./middleware";
+export { createPublishedPage, } from "./create-published-page";
 export { loadPublishedPage, loadRouteTemplateKeys, } from "./published-page";
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAwB,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAA4B,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAsB,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAsC,MAAM,sBAAsB,CAAC;AAClG,OAAO,EAAE,kBAAkB,EAA2B,MAAM,cAAc,CAAC;AAC3E,OAAO,EACL,iBAAiB,EACjB,qBAAqB,GAEtB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAwB,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAA4B,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAsB,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAsC,MAAM,sBAAsB,CAAC;AAClG,OAAO,EAAE,kBAAkB,EAA2B,MAAM,cAAc,CAAC;AAC3E,OAAO,EACL,mBAAmB,GAIpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,iBAAiB,EACjB,qBAAqB,GAGtB,MAAM,kBAAkB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pantheon-systems/p1-next-sdk",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "license": "UNLICENSED",
   "description": "Next.js SDK for P1 editor integration",
   "publishConfig": {
@@ -35,8 +35,8 @@
   ],
   "dependencies": {
     "server-only": "^0.0.1",
-    "@pantheon-systems/css-client": "0.13.0",
-    "@pantheon-systems/puck-css": "0.13.0"
+    "@pantheon-systems/css-client": "0.14.0",
+    "@pantheon-systems/puck-css": "0.14.0"
   },
   "peerDependencies": {
     "@puckeditor/core": ">=0.21.0",
@@ -47,6 +47,7 @@
   "devDependencies": {
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
+    "@types/node": "^20.19.30",
     "@types/react": "^19.2.14",
     "eslint": "^9.27.0",
     "jsdom": "^24.1.3",