@weaverse/next 0.1.0-alpha.1 → 0.1.0-alpha.10

package/dist/server.d.mts

@@ -1,7 +1,7 @@
-import { q as WeaverseNextRequestContext, a as WeaverseNextBaseConfigs, v as WeaverseNextServerClientConfig, u as WeaverseNextServerClient } from './types-DvEeLX6L.mjs';
-export { b as WeaverseNextCacheConfig, j as WeaverseNextConfigs, k as WeaverseNextFetchOptions, p as WeaverseNextProjectId, w as WeaverseNextServerLoadPageInput, y as WeaverseNextThemeSettingsOptions, z as WeaverseNextThemeSettingsResponse } from './types-DvEeLX6L.mjs';
-import '@weaverse/react';
+import { x as WeaverseNextRequestContext, e as WeaverseNextBaseConfigs, C as WeaverseNextServerClient, k as WeaverseNextComponentData, D as WeaverseNextServerClientConfig } from './seo-CgO21rLg.mjs';
+export { f as WeaverseNextCacheConfig, n as WeaverseNextConfigs, o as WeaverseNextCustomPageEntry, p as WeaverseNextFetchCustomPagesOptions, q as WeaverseNextFetchOptions, w as WeaverseNextProjectId, B as WeaverseNextSeoMetadata, E as WeaverseNextServerLoadPageInput, H as WeaverseNextThemeSettingsOptions, I as WeaverseNextThemeSettingsResponse, Q as formatWeaverseNextSeoMetadata, R as getWeaverseNextSeoMetadata } from './seo-CgO21rLg.mjs';
 import '@weaverse/schema';
+import '@weaverse/react';
 import 'react';
 
 interface ResolveConfigsOptions {
@@ -38,6 +38,45 @@ declare function normalizeNextPageUrl(url: string): string;
  */
 declare function resolveRequestUrl(context?: WeaverseNextRequestContext): string;
 
+interface WeaverseNextRevalidateHandlerConfig {
+    /**
+     * Reuse the app's server-client factory so the loader runs with the same
+     * component registry and commerce (storefront) context as page loads.
+     */
+    getClient: (request: Request) => Promise<WeaverseNextServerClient> | WeaverseNextServerClient;
+}
+/** POST body accepted by the revalidate route. */
+interface WeaverseNextRevalidateRequestBody {
+    draftItem: WeaverseNextComponentData;
+}
+/**
+ * Create the Studio per-item revalidation route handler.
+ *
+ * Studio design-mode edits to loader-backed inputs (e.g. resource pickers) need
+ * fresh server loader data for a single item. Re-running it through
+ * `router.refresh()` re-applies the whole RSC tree — and the draft-item query
+ * rewrite changes the App Router page segment key, remounting the page and
+ * resetting scroll. This handler runs just the edited component's `loader`
+ * with the unsaved draft settings and returns the payload for an in-place
+ * client update (see the `2026-07-02--next-item-revalidation` spec).
+ *
+ * Security: only registered component types are executable, the handler never
+ * persists anything, and responses are `no-store`. Exposure is equivalent to
+ * the existing `weaverseDraftItem` URL param, which already lets any visitor
+ * run design-mode loaders with arbitrary draft settings.
+ *
+ * @example
+ * ```ts
+ * // app/api/weaverse/revalidate/route.ts
+ * export const { POST } = createWeaverseNextRevalidateHandler({
+ *   getClient: () => getWeaverseServerClient(Promise.resolve({})),
+ * })
+ * ```
+ */
+declare function createWeaverseNextRevalidateHandler(config: WeaverseNextRevalidateHandlerConfig): {
+    POST: (request: Request) => Promise<Response>;
+};
+
 /**
  * Create a server-side {@link WeaverseNextServerClient} for Next.js App Router
  * routes / server components.
@@ -57,4 +96,4 @@ declare function resolveRequestUrl(context?: WeaverseNextRequestContext): string
  */
 declare function createWeaverseNextServerClient(config: WeaverseNextServerClientConfig): WeaverseNextServerClient;
 
-export { WeaverseNextBaseConfigs, WeaverseNextServerClient, WeaverseNextServerClientConfig, createWeaverseNextServerClient, getWeaverseNextConfigs, normalizeNextPageUrl, resolveRequestUrl };
+export { WeaverseNextBaseConfigs, type WeaverseNextRevalidateHandlerConfig, type WeaverseNextRevalidateRequestBody, WeaverseNextServerClient, WeaverseNextServerClientConfig, createWeaverseNextRevalidateHandler, createWeaverseNextServerClient, getWeaverseNextConfigs, normalizeNextPageUrl, resolveRequestUrl };

package/dist/server.d.ts

@@ -1,7 +1,7 @@
-import { q as WeaverseNextRequestContext, a as WeaverseNextBaseConfigs, v as WeaverseNextServerClientConfig, u as WeaverseNextServerClient } from './types-DvEeLX6L.js';
-export { b as WeaverseNextCacheConfig, j as WeaverseNextConfigs, k as WeaverseNextFetchOptions, p as WeaverseNextProjectId, w as WeaverseNextServerLoadPageInput, y as WeaverseNextThemeSettingsOptions, z as WeaverseNextThemeSettingsResponse } from './types-DvEeLX6L.js';
-import '@weaverse/react';
+import { x as WeaverseNextRequestContext, e as WeaverseNextBaseConfigs, C as WeaverseNextServerClient, k as WeaverseNextComponentData, D as WeaverseNextServerClientConfig } from './seo-CgO21rLg.js';
+export { f as WeaverseNextCacheConfig, n as WeaverseNextConfigs, o as WeaverseNextCustomPageEntry, p as WeaverseNextFetchCustomPagesOptions, q as WeaverseNextFetchOptions, w as WeaverseNextProjectId, B as WeaverseNextSeoMetadata, E as WeaverseNextServerLoadPageInput, H as WeaverseNextThemeSettingsOptions, I as WeaverseNextThemeSettingsResponse, Q as formatWeaverseNextSeoMetadata, R as getWeaverseNextSeoMetadata } from './seo-CgO21rLg.js';
 import '@weaverse/schema';
+import '@weaverse/react';
 import 'react';
 
 interface ResolveConfigsOptions {
@@ -38,6 +38,45 @@ declare function normalizeNextPageUrl(url: string): string;
  */
 declare function resolveRequestUrl(context?: WeaverseNextRequestContext): string;
 
+interface WeaverseNextRevalidateHandlerConfig {
+    /**
+     * Reuse the app's server-client factory so the loader runs with the same
+     * component registry and commerce (storefront) context as page loads.
+     */
+    getClient: (request: Request) => Promise<WeaverseNextServerClient> | WeaverseNextServerClient;
+}
+/** POST body accepted by the revalidate route. */
+interface WeaverseNextRevalidateRequestBody {
+    draftItem: WeaverseNextComponentData;
+}
+/**
+ * Create the Studio per-item revalidation route handler.
+ *
+ * Studio design-mode edits to loader-backed inputs (e.g. resource pickers) need
+ * fresh server loader data for a single item. Re-running it through
+ * `router.refresh()` re-applies the whole RSC tree — and the draft-item query
+ * rewrite changes the App Router page segment key, remounting the page and
+ * resetting scroll. This handler runs just the edited component's `loader`
+ * with the unsaved draft settings and returns the payload for an in-place
+ * client update (see the `2026-07-02--next-item-revalidation` spec).
+ *
+ * Security: only registered component types are executable, the handler never
+ * persists anything, and responses are `no-store`. Exposure is equivalent to
+ * the existing `weaverseDraftItem` URL param, which already lets any visitor
+ * run design-mode loaders with arbitrary draft settings.
+ *
+ * @example
+ * ```ts
+ * // app/api/weaverse/revalidate/route.ts
+ * export const { POST } = createWeaverseNextRevalidateHandler({
+ *   getClient: () => getWeaverseServerClient(Promise.resolve({})),
+ * })
+ * ```
+ */
+declare function createWeaverseNextRevalidateHandler(config: WeaverseNextRevalidateHandlerConfig): {
+    POST: (request: Request) => Promise<Response>;
+};
+
 /**
  * Create a server-side {@link WeaverseNextServerClient} for Next.js App Router
  * routes / server components.
@@ -57,4 +96,4 @@ declare function resolveRequestUrl(context?: WeaverseNextRequestContext): string
  */
 declare function createWeaverseNextServerClient(config: WeaverseNextServerClientConfig): WeaverseNextServerClient;
 
-export { WeaverseNextBaseConfigs, WeaverseNextServerClient, WeaverseNextServerClientConfig, createWeaverseNextServerClient, getWeaverseNextConfigs, normalizeNextPageUrl, resolveRequestUrl };
+export { WeaverseNextBaseConfigs, type WeaverseNextRevalidateHandlerConfig, type WeaverseNextRevalidateRequestBody, WeaverseNextServerClient, WeaverseNextServerClientConfig, createWeaverseNextRevalidateHandler, createWeaverseNextServerClient, getWeaverseNextConfigs, normalizeNextPageUrl, resolveRequestUrl };

package/dist/server.js

@@ -1,5 +1,61 @@
 'use strict';
 
+// src/seo.ts
+function hasOpenGraphContent(seo) {
+  return Boolean(seo?.title || seo?.description || seo?.image || seo?.type);
+}
+function hasTwitterContent(seo) {
+  return Boolean(seo?.title || seo?.description || seo?.image || seo?.cardType);
+}
+function formatWeaverseNextSeoMetadata(seo) {
+  let index = seo?.robots?.index !== false;
+  let follow = seo?.robots?.follow !== false;
+  let metadata = {
+    robots: { index, follow }
+  };
+  if (!seo) {
+    return metadata;
+  }
+  if (seo.title) {
+    metadata.title = seo.title;
+  }
+  if (seo.description) {
+    metadata.description = seo.description;
+  }
+  if (seo.keywords) {
+    metadata.keywords = seo.keywords;
+  }
+  if (seo.canonicalUrl) {
+    metadata.alternates = { canonical: seo.canonicalUrl };
+  }
+  let openGraph = seo.openGraph;
+  if (hasOpenGraphContent(openGraph)) {
+    metadata.openGraph = {
+      title: openGraph?.title,
+      description: openGraph?.description,
+      images: openGraph?.image ? [openGraph.image] : void 0,
+      type: openGraph?.type || "website"
+    };
+  }
+  let twitter = seo.twitter;
+  if (hasTwitterContent(twitter)) {
+    metadata.twitter = {
+      card: twitter?.cardType || "summary",
+      title: twitter?.title,
+      description: twitter?.description,
+      images: twitter?.image ? [twitter.image] : void 0
+    };
+  }
+  return metadata;
+}
+function getWeaverseNextSeoMetadata(data) {
+  if (!data) {
+    return formatWeaverseNextSeoMetadata(null);
+  }
+  let page = "items" in data && "id" in data ? data : data.page ?? null;
+  return formatWeaverseNextSeoMetadata(page?.seo ?? null);
+}
+
 // src/server/configs.ts
 var DEFAULT_WEAVERSE_HOST = "https://studio.weaverse.io";
 var DEFAULT_WEAVERSE_API_BASE = "https://api.weaverse.io";
@@ -85,7 +141,7 @@ function getWeaverseNextConfigs(context, options = {}) {
 }
 
 // src/server/normalize-page-url.ts
-var KEPT_PARAM_RE = /^(?:__revisionId|isDesignMode|weaverse)/;
+var KEPT_PARAM_RE = /^(?:__revisionId|__weaverseDraftItem|isDesignMode|weaverse)/;
 var DATA_SUFFIX = ".data";
 function normalizeNextPageUrl(url) {
   let parsed;
@@ -134,6 +190,89 @@ function generateDataFromSchema(schema) {
   return data;
 }
 
+// src/server/revalidate-handler.ts
+var NO_STORE_HEADERS = {
+  "Content-Type": "application/json",
+  "Cache-Control": "no-store"
+};
+var STATUS_OK = 200;
+var STATUS_BAD_REQUEST = 400;
+var STATUS_NOT_FOUND = 404;
+var STATUS_UNPROCESSABLE = 422;
+var STATUS_SERVER_ERROR = 500;
+function json(body, status) {
+  return new Response(JSON.stringify(body), {
+    status,
+    headers: NO_STORE_HEADERS
+  });
+}
+function parseDraftItem(payload) {
+  if (typeof payload !== "object" || payload === null) {
+    return null;
+  }
+  let draftItem = payload.draftItem;
+  if (typeof draftItem !== "object" || draftItem === null) {
+    return null;
+  }
+  let { id, type } = draftItem;
+  if (typeof id !== "string" || !id || typeof type !== "string" || !type) {
+    return null;
+  }
+  return draftItem;
+}
+function createWeaverseNextRevalidateHandler(config) {
+  return {
+    POST: async (request) => {
+      let payload;
+      try {
+        payload = await request.json();
+      } catch {
+        return json({ error: "invalid-payload" }, STATUS_BAD_REQUEST);
+      }
+      let draftItem = parseDraftItem(payload);
+      if (!draftItem) {
+        return json({ error: "invalid-payload" }, STATUS_BAD_REQUEST);
+      }
+      let client;
+      try {
+        client = await config.getClient(request);
+      } catch (error) {
+        console.error("\u274C Revalidate handler getClient failed.", error);
+        return json({ error: "client-init-failed" }, STATUS_SERVER_ERROR);
+      }
+      let component = client.components.find(
+        (candidate) => candidate?.schema?.type === draftItem.type
+      );
+      if (!component) {
+        return json({ error: "unknown-component-type" }, STATUS_NOT_FOUND);
+      }
+      if (typeof component.loader !== "function") {
+        return json({ error: "missing-loader" }, STATUS_UNPROCESSABLE);
+      }
+      try {
+        let loaderData = await component.loader({
+          data: {
+            ...generateDataFromSchema(component.schema),
+            ...draftItem.data
+          },
+          weaverse: client,
+          context: client.requestContext,
+          commerce: client.commerce
+        });
+        return json({ loaderData: loaderData ?? null }, STATUS_OK);
+      } catch (error) {
+        console.error(
+          "\u274C Item loader revalidation failed.",
+          draftItem.type,
+          draftItem.id,
+          error
+        );
+        return json({ error: "loader-failed" }, STATUS_SERVER_ERROR);
+      }
+    }
+  };
+}
+
 // src/loader.ts
 function isItemNode(node) {
   return typeof node === "object" && node !== null && typeof node.type === "string";
@@ -251,8 +390,22 @@ function toQueryRecord(searchParams) {
   }
   return queries;
 }
+var TRANSIENT_STUDIO_PARAMS = /* @__PURE__ */ new Set([
+  "weaverseDraftItem",
+  // Legacy name from the original design-mode draft-item spike. Keep it out of
+  // runtime requestInfo too, in case an older Builder bundle is in front of a
+  // newer Next storefront.
+  "__weaverseDraftItem"
+]);
+function getRequestInfoSearchParams(context) {
+  let searchParams = new URLSearchParams(getSearchParamsFromContext(context));
+  for (let key of TRANSIENT_STUDIO_PARAMS) {
+    searchParams.delete(key);
+  }
+  return searchParams;
+}
 function buildWeaverseNextRequestInfo(context) {
-  let searchParams = getSearchParamsFromContext(context);
+  let searchParams = getRequestInfoSearchParams(context);
   let search = searchParams.toString();
   return {
     pathname: getPathnameFromContext(context),
@@ -266,6 +419,7 @@ function buildWeaverseNextRequestInfo(context) {
 var DEFAULT_FETCH_TIMEOUT_MS = 1e4;
 var RANDOM_ID_RADIX = 36;
 var RANDOM_ID_SLICE_START = 2;
+var MAX_CUSTOM_PAGE_PAGES = 100;
 var JSON_HEADERS = {
   "Content-Type": "application/json",
   Accept: "application/json",
@@ -280,6 +434,25 @@ function generateUuid() {
   }
   return `id-${Math.random().toString(RANDOM_ID_RADIX).slice(RANDOM_ID_SLICE_START)}`;
 }
+function normalizeWeaverseNextPageAssignment(input) {
+  if (!input || typeof input !== "object") {
+    return;
+  }
+  let { projectId, type, handle, locale, meta } = input;
+  if (typeof projectId !== "string" || typeof type !== "string" || typeof handle !== "string") {
+    return;
+  }
+  let normalized = {
+    projectId,
+    type,
+    handle,
+    locale: typeof locale === "string" ? locale : ""
+  };
+  if (meta && typeof meta === "object") {
+    normalized.meta = meta;
+  }
+  return normalized;
+}
 var NextServerClient = class {
   components;
   commerce;
@@ -399,6 +572,59 @@ var NextServerClient = class {
       clearTimeout(timeoutId);
     }
   };
+  _buildCustomPagesUrl(projectId, options, cursor) {
+    let params = new URLSearchParams();
+    if (options.locale) {
+      params.set("locale", options.locale);
+    }
+    if (options.limit) {
+      params.set("limit", String(options.limit));
+    }
+    if (cursor) {
+      params.set("cursor", cursor);
+    }
+    let qs = params.toString();
+    return `${this._baseConfigs.weaverseApiBase}/api/public/v1/projects/${projectId}/custom-pages${qs ? `?${qs}` : ""}`;
+  }
+  /**
+   * Fetch all published custom pages for sitemap generation. Mirrors Hydrogen's
+   * helper but uses Next's fetch cache knobs (`revalidate` / `tags`). It returns
+   * accumulated results on partial pagination failure so a single API hiccup
+   * does not break sitemap generation entirely.
+   */
+  fetchCustomPages = async (options = {}) => {
+    let projectId = await this.resolveProjectId();
+    let entries = [];
+    if (!projectId) {
+      console.warn(
+        "[WeaverseNext] Failed to fetch custom pages: missing projectId"
+      );
+      return entries;
+    }
+    let cursor = null;
+    for (let page = 0; page < MAX_CUSTOM_PAGE_PAGES; page += 1) {
+      let url = this._buildCustomPagesUrl(projectId, options, cursor);
+      try {
+        let result = await this.fetchWithCache(url, {
+          revalidate: options.revalidate,
+          tags: options.tags
+        });
+        entries.push(...result.data ?? []);
+        if (!result.nextCursor) {
+          return entries;
+        }
+        cursor = result.nextCursor;
+      } catch (error) {
+        let message = error instanceof Error ? error.message : String(error);
+        console.warn(
+          entries.length === 0 ? `[WeaverseNext] Failed to fetch custom pages: ${message}` : `[WeaverseNext] Custom pages pagination interrupted: ${message}`
+        );
+        return entries;
+      }
+    }
+    console.warn("[WeaverseNext] Custom pages pagination cap reached");
+    return entries;
+  };
   _generateFallbackPage(message) {
     let rootId = generateUuid();
     return {
@@ -526,7 +752,9 @@ var NextServerClient = class {
     this._assertNoPageError(payload);
     let page = payload.page;
     let project = payload.project;
-    let pageAssignment = payload.pageAssignment;
+    let pageAssignment = normalizeWeaverseNextPageAssignment(
+      payload.pageAssignment
+    );
     page ??= this._generateFallbackPage(
       '<div style="text-align: center;">Please add new section to start.</div>'
     );
@@ -585,9 +813,7 @@ var NextServerClient = class {
   loadThemeSettings = async (optionsInput = {}) => {
     let options = optionsInput;
     let themeSchema = asThemeSchema(this.themeSchema);
-    let defaultThemeSettings = generateDataFromSchema(
-      this.themeSchema
-    );
+    let defaultThemeSettings = generateDataFromSchema(this.themeSchema);
     let staticContent = themeSchema?.i18n?.staticContent;
     try {
       let projectId = await this.resolveProjectId();
@@ -620,20 +846,21 @@ var NextServerClient = class {
         result.staticContent = staticContent;
       }
       if (isDesignMode) {
+        let serializableSchema = themeSchema ? {
+          ...themeSchema,
+          settings: themeSchema.settings?.map((group) => ({
+            ...group,
+            inputs: group?.inputs?.map(
+              (inputItem) => typeof inputItem?.condition === "function" ? {
+                ...inputItem,
+                condition: inputItem.condition.toString()
+              } : inputItem
+            )
+          }))
+        } : void 0;
         result = {
           ...result,
-          schema: themeSchema ? {
-            ...themeSchema,
-            settings: themeSchema.settings?.map((group) => ({
-              ...group,
-              inputs: group?.inputs?.map(
-                (inputItem) => typeof inputItem?.condition === "function" ? {
-                  ...inputItem,
-                  condition: inputItem.condition.toString()
-                } : inputItem
-              )
-            }))
-          } : void 0,
+          schema: serializableSchema,
           publicEnv: this._baseConfigs.publicEnv
         };
       }
@@ -654,8 +881,11 @@ function createWeaverseNextServerClient(config) {
   return new NextServerClient(config);
 }
 
+exports.createWeaverseNextRevalidateHandler = createWeaverseNextRevalidateHandler;
 exports.createWeaverseNextServerClient = createWeaverseNextServerClient;
+exports.formatWeaverseNextSeoMetadata = formatWeaverseNextSeoMetadata;
 exports.getWeaverseNextConfigs = getWeaverseNextConfigs;
+exports.getWeaverseNextSeoMetadata = getWeaverseNextSeoMetadata;
 exports.normalizeNextPageUrl = normalizeNextPageUrl;
 exports.resolveRequestUrl = resolveRequestUrl;
 //# sourceMappingURL=server.js.map