@uniformdev/canvas-next 20.49.2 → 20.49.3-alpha.47

package/dist/{chunk-JQWYBVLI.mjs → chunk-4YXXKXP3.mjs}

@@ -1,3 +1,18 @@
+// src/helpers/resolvePreviewReleaseId.ts
+function resolvePreviewReleaseId({
+  explicitReleaseId,
+  isPreview,
+  previewReleaseId
+}) {
+  if (typeof explicitReleaseId !== "undefined") {
+    return explicitReleaseId;
+  }
+  if (!isPreview) {
+    return void 0;
+  }
+  return previewReleaseId;
+}
+
 // src/logging/logCompositionResponse.ts
 import { white as white2 } from "colorette";
 
@@ -104,5 +119,6 @@ function resolveDiagnosticsDuration(data) {
 }
 
 export {
+  resolvePreviewReleaseId,
   logCompositionResponse
 };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { RichTextRendererComponent, RenderRichTextComponentResolver, UniformRichText as UniformRichText$1, UniformRichTextNode as UniformRichTextNode$1 } from '@uniformdev/canvas-react';
+import { RichTextRendererComponent, UniformRichText as UniformRichText$1, UniformRichTextNode as UniformRichTextNode$1, RenderRichTextComponentResolver } from '@uniformdev/canvas-react';
 import { ParsedUrlQuery } from 'querystring';
-export { U as UniformCompositionNextPage, c as UniformGetServerSideProps, b as UniformGetStaticProps, a as UniformPreviewData } from './models-CupnCqnn.mjs';
+export { U as UniformCompositionNextPage, a as UniformGetServerSideProps, b as UniformGetStaticProps, c as UniformPreviewData } from './models-BGg_qtcM.mjs';
 import { NextApiHandler, NextApiRequest } from 'next';
 import { RootComponentInstance } from '@uniformdev/canvas';
 

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { RichTextRendererComponent, RenderRichTextComponentResolver, UniformRichText as UniformRichText$1, UniformRichTextNode as UniformRichTextNode$1 } from '@uniformdev/canvas-react';
+import { RichTextRendererComponent, UniformRichText as UniformRichText$1, UniformRichTextNode as UniformRichTextNode$1, RenderRichTextComponentResolver } from '@uniformdev/canvas-react';
 import { ParsedUrlQuery } from 'querystring';
-export { U as UniformCompositionNextPage, c as UniformGetServerSideProps, b as UniformGetStaticProps, a as UniformPreviewData } from './models-CupnCqnn.js';
+export { U as UniformCompositionNextPage, a as UniformGetServerSideProps, b as UniformGetStaticProps, c as UniformPreviewData } from './models-BGg_qtcM.js';
 import { NextApiHandler, NextApiRequest } from 'next';
 import { RootComponentInstance } from '@uniformdev/canvas';
 

package/dist/index.esm.js

@@ -4,17 +4,17 @@ import {
 
 // src/components/UniformRichText.tsx
 import {
+  linkParamValueToAnchorProps,
   UniformRichText as ReactUniformRichText,
   UniformRichTextNode as ReactUniformRichTextNode
 } from "@uniformdev/canvas-react";
-import { linkParamValueToHref } from "@uniformdev/richtext";
 import NextLink from "next/link.js";
 import React, { useCallback } from "react";
 var NextLinkRichTextNode = ({ children, node }) => {
   const { link } = node;
-  const href = linkParamValueToHref(link);
+  const { href, ...rest } = linkParamValueToAnchorProps(link);
   if (href) {
-    return /* @__PURE__ */ React.createElement(NextLink, { href }, children);
+    return /* @__PURE__ */ React.createElement(NextLink, { href, ...rest }, children);
   } else {
     return null;
   }
@@ -98,6 +98,7 @@ var createPreviewHandlerGet = ({ secret, resolveFullPath = resolveFullPathDefaul
   const slug = getQueryParam(req, compositionQueryParam.slug);
   const path = getQueryParam(req, compositionQueryParam.path);
   const locale = getQueryParam(req, compositionQueryParam.locale);
+  const releaseId = getQueryParam(req, "releaseId") || void 0;
   if (typeof pathToRedirectTo === "undefined") {
     pathToRedirectTo = resolveFullPath({ id, slug, path, locale });
   }
@@ -125,6 +126,7 @@ var createPreviewHandlerGet = ({ secret, resolveFullPath = resolveFullPathDefaul
       compositionSlug: slug,
       compositionPath: path,
       locale,
+      releaseId,
       isPlayground,
       patternType: !isPlayground ? void 0 : getQueryParam(req, "patternType")
     },
@@ -143,6 +145,9 @@ var createPreviewHandlerGet = ({ secret, resolveFullPath = resolveFullPathDefaul
   );
   const redirectionUrl = new URL(pathToRedirectTo, BASE_URL_EXAMPLE);
   assignRequestQueryToSearchParams(redirectionUrl.searchParams, req.query);
+  if (releaseId) {
+    redirectionUrl.searchParams.set("releaseId", releaseId);
+  }
   if (!isUniformContextualEditing) {
     contextualEditingQueryParams.forEach((param) => {
       redirectionUrl.searchParams.delete(param);
@@ -155,8 +160,17 @@ var resolveFullPathDefault = ({ slug, path }) => {
   return path || slug;
 };
 function validateLocalRedirectUrl(pathToRedirectTo) {
-  if (pathToRedirectTo == null ? void 0 : pathToRedirectTo.match(/^[a-z]+:\/\//g)) {
-    throw new Error("Tried to redirect to absolute URL with protocol. Disallowing open redirect.");
+  if (!pathToRedirectTo) {
+    return;
+  }
+  let resolved;
+  try {
+    resolved = new URL(pathToRedirectTo, BASE_URL_EXAMPLE);
+  } catch (e) {
+    throw new Error("Invalid redirect path. Disallowing open redirect.");
+  }
+  if (resolved.origin !== BASE_URL_EXAMPLE) {
+    throw new Error("Tried to redirect off-origin. Disallowing open redirect.");
   }
 }
 var assignRequestQueryToSearchParams = (searchParams, query) => {

package/dist/index.js

@@ -28,8 +28,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
-var src_exports = {};
-__export(src_exports, {
+var index_exports = {};
+__export(index_exports, {
   NextLinkRichTextNode: () => NextLinkRichTextNode,
   UniformRichText: () => UniformRichText,
   UniformRichTextNode: () => UniformRichTextNode,
@@ -39,18 +39,17 @@ __export(src_exports, {
   resolveSlugFromParams: () => resolveSlugFromParams,
   useResolveNextRichTextRenderer: () => useResolveNextRichTextRenderer
 });
-module.exports = __toCommonJS(src_exports);
+module.exports = __toCommonJS(index_exports);
 
 // src/components/UniformRichText.tsx
 var import_canvas_react = require("@uniformdev/canvas-react");
-var import_richtext = require("@uniformdev/richtext");
 var import_link = __toESM(require("next/link.js"));
 var import_react = __toESM(require("react"));
 var NextLinkRichTextNode = ({ children, node }) => {
   const { link } = node;
-  const href = (0, import_richtext.linkParamValueToHref)(link);
+  const { href, ...rest } = (0, import_canvas_react.linkParamValueToAnchorProps)(link);
   if (href) {
-    return /* @__PURE__ */ import_react.default.createElement(import_link.default, { href }, children);
+    return /* @__PURE__ */ import_react.default.createElement(import_link.default, { href, ...rest }, children);
   } else {
     return null;
   }
@@ -140,6 +139,7 @@ var createPreviewHandlerGet = ({ secret, resolveFullPath = resolveFullPathDefaul
   const slug = getQueryParam(req, compositionQueryParam.slug);
   const path = getQueryParam(req, compositionQueryParam.path);
   const locale = getQueryParam(req, compositionQueryParam.locale);
+  const releaseId = getQueryParam(req, "releaseId") || void 0;
   if (typeof pathToRedirectTo === "undefined") {
     pathToRedirectTo = resolveFullPath({ id, slug, path, locale });
   }
@@ -167,6 +167,7 @@ var createPreviewHandlerGet = ({ secret, resolveFullPath = resolveFullPathDefaul
       compositionSlug: slug,
       compositionPath: path,
       locale,
+      releaseId,
       isPlayground,
       patternType: !isPlayground ? void 0 : getQueryParam(req, "patternType")
     },
@@ -185,6 +186,9 @@ var createPreviewHandlerGet = ({ secret, resolveFullPath = resolveFullPathDefaul
   );
   const redirectionUrl = new URL(pathToRedirectTo, BASE_URL_EXAMPLE);
   assignRequestQueryToSearchParams(redirectionUrl.searchParams, req.query);
+  if (releaseId) {
+    redirectionUrl.searchParams.set("releaseId", releaseId);
+  }
   if (!isUniformContextualEditing) {
     contextualEditingQueryParams.forEach((param) => {
       redirectionUrl.searchParams.delete(param);
@@ -197,8 +201,17 @@ var resolveFullPathDefault = ({ slug, path }) => {
   return path || slug;
 };
 function validateLocalRedirectUrl(pathToRedirectTo) {
-  if (pathToRedirectTo == null ? void 0 : pathToRedirectTo.match(/^[a-z]+:\/\//g)) {
-    throw new Error("Tried to redirect to absolute URL with protocol. Disallowing open redirect.");
+  if (!pathToRedirectTo) {
+    return;
+  }
+  let resolved;
+  try {
+    resolved = new URL(pathToRedirectTo, BASE_URL_EXAMPLE);
+  } catch (e) {
+    throw new Error("Invalid redirect path. Disallowing open redirect.");
+  }
+  if (resolved.origin !== BASE_URL_EXAMPLE) {
+    throw new Error("Tried to redirect off-origin. Disallowing open redirect.");
   }
 }
 var assignRequestQueryToSearchParams = (searchParams, query) => {

package/dist/index.mjs

@@ -4,17 +4,17 @@ import {
 
 // src/components/UniformRichText.tsx
 import {
+  linkParamValueToAnchorProps,
   UniformRichText as ReactUniformRichText,
   UniformRichTextNode as ReactUniformRichTextNode
 } from "@uniformdev/canvas-react";
-import { linkParamValueToHref } from "@uniformdev/richtext";
 import NextLink from "next/link.js";
 import React, { useCallback } from "react";
 var NextLinkRichTextNode = ({ children, node }) => {
   const { link } = node;
-  const href = linkParamValueToHref(link);
+  const { href, ...rest } = linkParamValueToAnchorProps(link);
   if (href) {
-    return /* @__PURE__ */ React.createElement(NextLink, { href }, children);
+    return /* @__PURE__ */ React.createElement(NextLink, { href, ...rest }, children);
   } else {
     return null;
   }
@@ -98,6 +98,7 @@ var createPreviewHandlerGet = ({ secret, resolveFullPath = resolveFullPathDefaul
   const slug = getQueryParam(req, compositionQueryParam.slug);
   const path = getQueryParam(req, compositionQueryParam.path);
   const locale = getQueryParam(req, compositionQueryParam.locale);
+  const releaseId = getQueryParam(req, "releaseId") || void 0;
   if (typeof pathToRedirectTo === "undefined") {
     pathToRedirectTo = resolveFullPath({ id, slug, path, locale });
   }
@@ -125,6 +126,7 @@ var createPreviewHandlerGet = ({ secret, resolveFullPath = resolveFullPathDefaul
       compositionSlug: slug,
       compositionPath: path,
       locale,
+      releaseId,
       isPlayground,
       patternType: !isPlayground ? void 0 : getQueryParam(req, "patternType")
     },
@@ -143,6 +145,9 @@ var createPreviewHandlerGet = ({ secret, resolveFullPath = resolveFullPathDefaul
   );
   const redirectionUrl = new URL(pathToRedirectTo, BASE_URL_EXAMPLE);
   assignRequestQueryToSearchParams(redirectionUrl.searchParams, req.query);
+  if (releaseId) {
+    redirectionUrl.searchParams.set("releaseId", releaseId);
+  }
   if (!isUniformContextualEditing) {
     contextualEditingQueryParams.forEach((param) => {
       redirectionUrl.searchParams.delete(param);
@@ -155,8 +160,17 @@ var resolveFullPathDefault = ({ slug, path }) => {
   return path || slug;
 };
 function validateLocalRedirectUrl(pathToRedirectTo) {
-  if (pathToRedirectTo == null ? void 0 : pathToRedirectTo.match(/^[a-z]+:\/\//g)) {
-    throw new Error("Tried to redirect to absolute URL with protocol. Disallowing open redirect.");
+  if (!pathToRedirectTo) {
+    return;
+  }
+  let resolved;
+  try {
+    resolved = new URL(pathToRedirectTo, BASE_URL_EXAMPLE);
+  } catch (e) {
+    throw new Error("Invalid redirect path. Disallowing open redirect.");
+  }
+  if (resolved.origin !== BASE_URL_EXAMPLE) {
+    throw new Error("Tried to redirect off-origin. Disallowing open redirect.");
   }
 }
 var assignRequestQueryToSearchParams = (searchParams, query) => {

package/dist/{models-CupnCqnn.d.mts → models-BGg_qtcM.d.mts}

@@ -1,6 +1,6 @@
-import { CompositionGetParameters, RootComponentInstance } from '@uniformdev/canvas';
+import { RootComponentInstance, CompositionGetParameters } from '@uniformdev/canvas';
 import { UniformCompositionProps } from '@uniformdev/canvas-react';
-import { NextPage, PreviewData, GetStaticPropsContext, GetStaticPropsResult, GetServerSidePropsContext, GetServerSidePropsResult } from 'next';
+import { NextPage, PreviewData, GetServerSidePropsContext, GetServerSidePropsResult, GetStaticPropsContext, GetStaticPropsResult } from 'next';
 import { ParsedUrlQuery } from 'querystring';
 
 type UniformCompositionNextPage<TProps = unknown> = NextPage<TProps & UniformCompositionProps>;
@@ -10,6 +10,7 @@ type UniformPreviewData = PreviewData & {
     compositionSlug?: string;
     compositionPath?: string;
     locale?: string;
+    releaseId?: string;
     isPlayground?: boolean;
     /**
      * The type of pattern being previewed in Canvas editor. This value is only set when `isPlayground` is `true`.
@@ -28,4 +29,4 @@ type UniformGetServerSideProps<P extends {
     [key: string]: any;
 }, Q extends ParsedUrlQuery = ParsedUrlQuery, D extends PreviewData = PreviewData> = (context: GetServerSidePropsContext<Q, D>, composition: RootComponentInstance | undefined) => Promise<GetServerSidePropsResult<P>> | GetServerSidePropsResult<P>;
 
-export type { UniformCompositionNextPage as U, UniformPreviewData as a, UniformGetStaticProps as b, UniformGetServerSideProps as c };
+export type { UniformCompositionNextPage as U, UniformGetServerSideProps as a, UniformGetStaticProps as b, UniformPreviewData as c };

package/dist/{models-CupnCqnn.d.ts → models-BGg_qtcM.d.ts}

@@ -1,6 +1,6 @@
-import { CompositionGetParameters, RootComponentInstance } from '@uniformdev/canvas';
+import { RootComponentInstance, CompositionGetParameters } from '@uniformdev/canvas';
 import { UniformCompositionProps } from '@uniformdev/canvas-react';
-import { NextPage, PreviewData, GetStaticPropsContext, GetStaticPropsResult, GetServerSidePropsContext, GetServerSidePropsResult } from 'next';
+import { NextPage, PreviewData, GetServerSidePropsContext, GetServerSidePropsResult, GetStaticPropsContext, GetStaticPropsResult } from 'next';
 import { ParsedUrlQuery } from 'querystring';
 
 type UniformCompositionNextPage<TProps = unknown> = NextPage<TProps & UniformCompositionProps>;
@@ -10,6 +10,7 @@ type UniformPreviewData = PreviewData & {
     compositionSlug?: string;
     compositionPath?: string;
     locale?: string;
+    releaseId?: string;
     isPlayground?: boolean;
     /**
      * The type of pattern being previewed in Canvas editor. This value is only set when `isPlayground` is `true`.
@@ -28,4 +29,4 @@ type UniformGetServerSideProps<P extends {
     [key: string]: any;
 }, Q extends ParsedUrlQuery = ParsedUrlQuery, D extends PreviewData = PreviewData> = (context: GetServerSidePropsContext<Q, D>, composition: RootComponentInstance | undefined) => Promise<GetServerSidePropsResult<P>> | GetServerSidePropsResult<P>;
 
-export type { UniformCompositionNextPage as U, UniformPreviewData as a, UniformGetStaticProps as b, UniformGetServerSideProps as c };
+export type { UniformCompositionNextPage as U, UniformGetServerSideProps as a, UniformGetStaticProps as b, UniformPreviewData as c };

package/dist/project-map/index.d.mts

@@ -1,9 +1,9 @@
 import * as next from 'next';
 import { GetServerSidePropsContext, PreviewData, GetServerSideProps, GetStaticPropsContext, GetStaticProps } from 'next';
-import { c as UniformGetServerSideProps, a as UniformPreviewData, b as UniformGetStaticProps } from '../models-CupnCqnn.mjs';
-import * as querystring from 'querystring';
-import { ParsedUrlQuery } from 'querystring';
+import { a as UniformGetServerSideProps, c as UniformPreviewData, b as UniformGetStaticProps } from '../models-BGg_qtcM.mjs';
+import * as node_querystring from 'node:querystring';
 import { CanvasClient, CompositionGetByNodePathParameters, DataResolutionOption } from '@uniformdev/canvas';
+import { ParsedUrlQuery } from 'querystring';
 import { ProjectMapNodeGetRequest, ProjectMapNodeGetResponse, ProjectMapClient } from '@uniformdev/project-map';
 import '@uniformdev/canvas-react';
 
@@ -72,11 +72,11 @@ declare const withUniformGetStaticProps: <TProps extends {
 
 declare const getServerSideProps: next.GetServerSideProps<{
     [key: string]: any;
-}, querystring.ParsedUrlQuery, UniformPreviewData>;
+}, node_querystring.ParsedUrlQuery, UniformPreviewData>;
 /** Ready to go getStaticProps for dynamic route with 'path' param for [[...path]].jsx */
 declare const getStaticProps: next.GetStaticProps<{
     [key: string]: any;
-}, querystring.ParsedUrlQuery, UniformPreviewData>;
+}, node_querystring.ParsedUrlQuery, UniformPreviewData>;
 declare const getStaticPaths: () => Promise<{
     paths: string[] | undefined;
     fallback: boolean;

package/dist/project-map/index.d.ts

@@ -1,9 +1,9 @@
 import * as next from 'next';
 import { GetServerSidePropsContext, PreviewData, GetServerSideProps, GetStaticPropsContext, GetStaticProps } from 'next';
-import { c as UniformGetServerSideProps, a as UniformPreviewData, b as UniformGetStaticProps } from '../models-CupnCqnn.js';
-import * as querystring from 'querystring';
-import { ParsedUrlQuery } from 'querystring';
+import { a as UniformGetServerSideProps, c as UniformPreviewData, b as UniformGetStaticProps } from '../models-BGg_qtcM.js';
+import * as node_querystring from 'node:querystring';
 import { CanvasClient, CompositionGetByNodePathParameters, DataResolutionOption } from '@uniformdev/canvas';
+import { ParsedUrlQuery } from 'querystring';
 import { ProjectMapNodeGetRequest, ProjectMapNodeGetResponse, ProjectMapClient } from '@uniformdev/project-map';
 import '@uniformdev/canvas-react';
 
@@ -72,11 +72,11 @@ declare const withUniformGetStaticProps: <TProps extends {
 
 declare const getServerSideProps: next.GetServerSideProps<{
     [key: string]: any;
-}, querystring.ParsedUrlQuery, UniformPreviewData>;
+}, node_querystring.ParsedUrlQuery, UniformPreviewData>;
 /** Ready to go getStaticProps for dynamic route with 'path' param for [[...path]].jsx */
 declare const getStaticProps: next.GetStaticProps<{
     [key: string]: any;
-}, querystring.ParsedUrlQuery, UniformPreviewData>;
+}, node_querystring.ParsedUrlQuery, UniformPreviewData>;
 declare const getStaticPaths: () => Promise<{
     paths: string[] | undefined;
     fallback: boolean;

package/dist/project-map/index.js

@@ -32,6 +32,21 @@ module.exports = __toCommonJS(project_map_exports);
 // src/project-map/withUniformGetServerSideProps.ts
 var import_canvas = require("@uniformdev/canvas");
 
+// src/helpers/resolvePreviewReleaseId.ts
+function resolvePreviewReleaseId({
+  explicitReleaseId,
+  isPreview,
+  previewReleaseId
+}) {
+  if (typeof explicitReleaseId !== "undefined") {
+    return explicitReleaseId;
+  }
+  if (!isPreview) {
+    return void 0;
+  }
+  return previewReleaseId;
+}
+
 // src/logging/logCompositionIssues.ts
 var import_colorette = require("colorette");
 function logCompositionIssues(prefix, issues, colour = "red") {
@@ -144,16 +159,21 @@ var withUniformGetServerSideProps = (options) => {
     edgeApiHost: process.env.UNIFORM_CLI_BASE_EDGE_URL
   });
   return async function wrappedGetServerSideProps(context) {
-    var _a, _b;
+    var _a, _b, _c;
     const projectMapId = (_a = options == null ? void 0 : options.projectMapId) != null ? _a : process.env.UNIFORM_PROJECT_MAP_ID;
     const { preview, previewData } = context;
+    const releaseId = resolvePreviewReleaseId({
+      explicitReleaseId: (_b = options == null ? void 0 : options.requestOptions) == null ? void 0 : _b.releaseId,
+      isPreview: preview || (options == null ? void 0 : options.preview),
+      previewReleaseId: previewData == null ? void 0 : previewData.releaseId
+    });
     let composition = void 0;
     let nodePath = (options == null ? void 0 : options.prefix) ? context.resolvedUrl.replace(new RegExp(`^${options.prefix}`), "") : context.resolvedUrl;
     if (options == null ? void 0 : options.modifyPath) {
       nodePath = options.modifyPath(nodePath, context);
     }
     if (previewData == null ? void 0 : previewData.isUniformContextualEditing) {
-      composition = { ...import_canvas.EMPTY_COMPOSITION, _id: (_b = previewData.compositionId) != null ? _b : import_canvas.EMPTY_COMPOSITION._id };
+      composition = { ...import_canvas.EMPTY_COMPOSITION, _id: (_c = previewData.compositionId) != null ? _c : import_canvas.EMPTY_COMPOSITION._id };
     } else {
       try {
         const time = Date.now();
@@ -161,7 +181,8 @@ var withUniformGetServerSideProps = (options) => {
           ...options == null ? void 0 : options.requestOptions,
           projectMapId,
           projectMapNodePath: nodePath,
-          state: preview || (options == null ? void 0 : options.preview) ? import_canvas.CANVAS_DRAFT_STATE : import_canvas.CANVAS_PUBLISHED_STATE
+          state: preview || (options == null ? void 0 : options.preview) ? import_canvas.CANVAS_DRAFT_STATE : import_canvas.CANVAS_PUBLISHED_STATE,
+          releaseId
         });
         const duration = Date.now() - time;
         composition = response.composition;
@@ -237,7 +258,7 @@ var withUniformGetStaticProps = (options) => {
     edgeApiHost: process.env.UNIFORM_CLI_BASE_EDGE_URL
   });
   return async function wrappedGetStaticProps(context) {
-    var _a2, _b;
+    var _a2, _b, _c;
     const projectMapId = (_a2 = options == null ? void 0 : options.projectMapId) != null ? _a2 : process.env.UNIFORM_PROJECT_MAP_ID;
     let pathString = resolveSlugFromParams({
       param: options == null ? void 0 : options.param,
@@ -247,9 +268,14 @@ var withUniformGetStaticProps = (options) => {
       pathString = options.modifyPath(pathString, context);
     }
     const { preview, previewData } = context;
+    const releaseId = resolvePreviewReleaseId({
+      explicitReleaseId: (_b = options == null ? void 0 : options.requestOptions) == null ? void 0 : _b.releaseId,
+      isPreview: preview || (options == null ? void 0 : options.preview),
+      previewReleaseId: previewData == null ? void 0 : previewData.releaseId
+    });
     let composition = void 0;
     if (previewData == null ? void 0 : previewData.isUniformContextualEditing) {
-      composition = { ...import_canvas3.EMPTY_COMPOSITION, _id: (_b = previewData.compositionId) != null ? _b : import_canvas3.EMPTY_COMPOSITION._id };
+      composition = { ...import_canvas3.EMPTY_COMPOSITION, _id: (_c = previewData.compositionId) != null ? _c : import_canvas3.EMPTY_COMPOSITION._id };
     } else {
       try {
         const time = Date.now();
@@ -257,7 +283,8 @@ var withUniformGetStaticProps = (options) => {
           ...options == null ? void 0 : options.requestOptions,
           projectMapId,
           projectMapNodePath: pathString,
-          state: preview || (options == null ? void 0 : options.preview) ? import_canvas3.CANVAS_DRAFT_STATE : import_canvas3.CANVAS_PUBLISHED_STATE
+          state: preview || (options == null ? void 0 : options.preview) ? import_canvas3.CANVAS_DRAFT_STATE : import_canvas3.CANVAS_PUBLISHED_STATE,
+          releaseId
         });
         const duration = Date.now() - time;
         composition = response.composition;

package/dist/project-map/index.mjs

@@ -1,6 +1,7 @@
 import {
-  logCompositionResponse
-} from "../chunk-JQWYBVLI.mjs";
+  logCompositionResponse,
+  resolvePreviewReleaseId
+} from "../chunk-4YXXKXP3.mjs";
 import {
   resolveSlugFromParams
 } from "../chunk-TR7V6ABJ.mjs";
@@ -20,16 +21,21 @@ var withUniformGetServerSideProps = (options) => {
     edgeApiHost: process.env.UNIFORM_CLI_BASE_EDGE_URL
   });
   return async function wrappedGetServerSideProps(context) {
-    var _a, _b;
+    var _a, _b, _c;
     const projectMapId = (_a = options == null ? void 0 : options.projectMapId) != null ? _a : process.env.UNIFORM_PROJECT_MAP_ID;
     const { preview, previewData } = context;
+    const releaseId = resolvePreviewReleaseId({
+      explicitReleaseId: (_b = options == null ? void 0 : options.requestOptions) == null ? void 0 : _b.releaseId,
+      isPreview: preview || (options == null ? void 0 : options.preview),
+      previewReleaseId: previewData == null ? void 0 : previewData.releaseId
+    });
     let composition = void 0;
     let nodePath = (options == null ? void 0 : options.prefix) ? context.resolvedUrl.replace(new RegExp(`^${options.prefix}`), "") : context.resolvedUrl;
     if (options == null ? void 0 : options.modifyPath) {
       nodePath = options.modifyPath(nodePath, context);
     }
     if (previewData == null ? void 0 : previewData.isUniformContextualEditing) {
-      composition = { ...EMPTY_COMPOSITION, _id: (_b = previewData.compositionId) != null ? _b : EMPTY_COMPOSITION._id };
+      composition = { ...EMPTY_COMPOSITION, _id: (_c = previewData.compositionId) != null ? _c : EMPTY_COMPOSITION._id };
     } else {
       try {
         const time = Date.now();
@@ -37,7 +43,8 @@ var withUniformGetServerSideProps = (options) => {
           ...options == null ? void 0 : options.requestOptions,
           projectMapId,
           projectMapNodePath: nodePath,
-          state: preview || (options == null ? void 0 : options.preview) ? CANVAS_DRAFT_STATE : CANVAS_PUBLISHED_STATE
+          state: preview || (options == null ? void 0 : options.preview) ? CANVAS_DRAFT_STATE : CANVAS_PUBLISHED_STATE,
+          releaseId
         });
         const duration = Date.now() - time;
         composition = response.composition;
@@ -108,7 +115,7 @@ var withUniformGetStaticProps = (options) => {
     edgeApiHost: process.env.UNIFORM_CLI_BASE_EDGE_URL
   });
   return async function wrappedGetStaticProps(context) {
-    var _a2, _b;
+    var _a2, _b, _c;
     const projectMapId = (_a2 = options == null ? void 0 : options.projectMapId) != null ? _a2 : process.env.UNIFORM_PROJECT_MAP_ID;
     let pathString = resolveSlugFromParams({
       param: options == null ? void 0 : options.param,
@@ -118,9 +125,14 @@ var withUniformGetStaticProps = (options) => {
       pathString = options.modifyPath(pathString, context);
     }
     const { preview, previewData } = context;
+    const releaseId = resolvePreviewReleaseId({
+      explicitReleaseId: (_b = options == null ? void 0 : options.requestOptions) == null ? void 0 : _b.releaseId,
+      isPreview: preview || (options == null ? void 0 : options.preview),
+      previewReleaseId: previewData == null ? void 0 : previewData.releaseId
+    });
     let composition = void 0;
     if (previewData == null ? void 0 : previewData.isUniformContextualEditing) {
-      composition = { ...EMPTY_COMPOSITION2, _id: (_b = previewData.compositionId) != null ? _b : EMPTY_COMPOSITION2._id };
+      composition = { ...EMPTY_COMPOSITION2, _id: (_c = previewData.compositionId) != null ? _c : EMPTY_COMPOSITION2._id };
     } else {
       try {
         const time = Date.now();
@@ -128,7 +140,8 @@ var withUniformGetStaticProps = (options) => {
           ...options == null ? void 0 : options.requestOptions,
           projectMapId,
           projectMapNodePath: pathString,
-          state: preview || (options == null ? void 0 : options.preview) ? CANVAS_DRAFT_STATE3 : CANVAS_PUBLISHED_STATE3
+          state: preview || (options == null ? void 0 : options.preview) ? CANVAS_DRAFT_STATE3 : CANVAS_PUBLISHED_STATE3,
+          releaseId
         });
         const duration = Date.now() - time;
         composition = response.composition;

package/dist/route/index.d.mts

@@ -1,12 +1,12 @@
 import * as next from 'next';
 import { GetServerSidePropsContext, GetServerSidePropsResult, GetServerSideProps, GetStaticPropsContext, GetStaticPropsResult, GetStaticProps } from 'next';
-import { a as UniformPreviewData } from '../models-CupnCqnn.mjs';
-import * as querystring from 'querystring';
-import { ParsedUrlQuery } from 'querystring';
-import * as _uniformdev_context__ from '@uniformdev/context/*';
-import * as _uniformdev_canvas from '@uniformdev/canvas';
-import { RouteGetResponseEdgehancedComposition, RouteGetResponseNotFound, RouteGetResponseRedirect, RouteClient, RouteGetParameters, RootComponentInstance } from '@uniformdev/canvas';
+import { c as UniformPreviewData } from '../models-BGg_qtcM.mjs';
+import * as node_querystring from 'node:querystring';
+import * as _uniformdev_context from '@uniformdev/context';
 import { CompositionMetadata } from '@uniformdev/context';
+import * as _uniformdev_canvas from '@uniformdev/canvas';
+import { RouteGetResponseEdgehancedComposition, RouteGetResponseNotFound, RouteGetResponseRedirect, RootComponentInstance, RouteClient, RouteGetParameters } from '@uniformdev/canvas';
+import { ParsedUrlQuery } from 'querystring';
 import { ProjectMapNodeGetRequest, ProjectMapNodeGetResponse, ProjectMapClient } from '@uniformdev/project-map';
 import { RedirectClient } from '@uniformdev/redirect';
 import { GetStaticPropsContext as GetStaticPropsContext$1, GetServerSidePropsContext as GetServerSidePropsContext$1 } from 'next/types';
@@ -112,7 +112,7 @@ declare const prependLocale: (path: string, { locale, defaultLocale, locales }:
  */
 declare const getServerSideProps: next.GetServerSideProps<{
     data: _uniformdev_canvas.RootComponentInstance;
-} & Omit<_uniformdev_context__.CompositionMetadata, "compositionId">, querystring.ParsedUrlQuery, UniformPreviewData>;
+} & Omit<_uniformdev_context.CompositionMetadata, "compositionId">, node_querystring.ParsedUrlQuery, UniformPreviewData>;
 /**
  * Default implementation of getStaticProps with routes
  * To configure custom behavior, use:
@@ -120,7 +120,7 @@ declare const getServerSideProps: next.GetServerSideProps<{
  */
 declare const getStaticProps: next.GetStaticProps<{
     data: _uniformdev_canvas.RootComponentInstance;
-} & Omit<_uniformdev_context__.CompositionMetadata, "compositionId">, querystring.ParsedUrlQuery, UniformPreviewData>;
+} & Omit<_uniformdev_context.CompositionMetadata, "compositionId">, node_querystring.ParsedUrlQuery, UniformPreviewData>;
 /**
  * Default implementation of getStaticPaths with routes
  * To configure custom behavior, use:

package/dist/route/index.d.ts

@@ -1,12 +1,12 @@
 import * as next from 'next';
 import { GetServerSidePropsContext, GetServerSidePropsResult, GetServerSideProps, GetStaticPropsContext, GetStaticPropsResult, GetStaticProps } from 'next';
-import { a as UniformPreviewData } from '../models-CupnCqnn.js';
-import * as querystring from 'querystring';
-import { ParsedUrlQuery } from 'querystring';
-import * as _uniformdev_context__ from '@uniformdev/context/*';
-import * as _uniformdev_canvas from '@uniformdev/canvas';
-import { RouteGetResponseEdgehancedComposition, RouteGetResponseNotFound, RouteGetResponseRedirect, RouteClient, RouteGetParameters, RootComponentInstance } from '@uniformdev/canvas';
+import { c as UniformPreviewData } from '../models-BGg_qtcM.js';
+import * as node_querystring from 'node:querystring';
+import * as _uniformdev_context from '@uniformdev/context';
 import { CompositionMetadata } from '@uniformdev/context';
+import * as _uniformdev_canvas from '@uniformdev/canvas';
+import { RouteGetResponseEdgehancedComposition, RouteGetResponseNotFound, RouteGetResponseRedirect, RootComponentInstance, RouteClient, RouteGetParameters } from '@uniformdev/canvas';
+import { ParsedUrlQuery } from 'querystring';
 import { ProjectMapNodeGetRequest, ProjectMapNodeGetResponse, ProjectMapClient } from '@uniformdev/project-map';
 import { RedirectClient } from '@uniformdev/redirect';
 import { GetStaticPropsContext as GetStaticPropsContext$1, GetServerSidePropsContext as GetServerSidePropsContext$1 } from 'next/types';
@@ -112,7 +112,7 @@ declare const prependLocale: (path: string, { locale, defaultLocale, locales }:
  */
 declare const getServerSideProps: next.GetServerSideProps<{
     data: _uniformdev_canvas.RootComponentInstance;
-} & Omit<_uniformdev_context__.CompositionMetadata, "compositionId">, querystring.ParsedUrlQuery, UniformPreviewData>;
+} & Omit<_uniformdev_context.CompositionMetadata, "compositionId">, node_querystring.ParsedUrlQuery, UniformPreviewData>;
 /**
  * Default implementation of getStaticProps with routes
  * To configure custom behavior, use:
@@ -120,7 +120,7 @@ declare const getServerSideProps: next.GetServerSideProps<{
  */
 declare const getStaticProps: next.GetStaticProps<{
     data: _uniformdev_canvas.RootComponentInstance;
-} & Omit<_uniformdev_context__.CompositionMetadata, "compositionId">, querystring.ParsedUrlQuery, UniformPreviewData>;
+} & Omit<_uniformdev_context.CompositionMetadata, "compositionId">, node_querystring.ParsedUrlQuery, UniformPreviewData>;
 /**
  * Default implementation of getStaticPaths with routes
  * To configure custom behavior, use:

package/dist/route/index.js

@@ -38,6 +38,21 @@ var import_redirect = require("@uniformdev/redirect");
 var import_canvas = require("@uniformdev/canvas");
 var import_colorette6 = require("colorette");
 
+// src/helpers/resolvePreviewReleaseId.ts
+function resolvePreviewReleaseId({
+  explicitReleaseId,
+  isPreview,
+  previewReleaseId
+}) {
+  if (typeof explicitReleaseId !== "undefined") {
+    return explicitReleaseId;
+  }
+  if (!isPreview) {
+    return void 0;
+  }
+  return previewReleaseId;
+}
+
 // src/logging/logCompositionIssues.ts
 var import_colorette = require("colorette");
 function logCompositionIssues(prefix, issues, colour = "red") {
@@ -211,14 +226,16 @@ function createRouteFetcher(options) {
     projectId: process.env.UNIFORM_PROJECT_ID,
     edgeApiHost: process.env.UNIFORM_CLI_BASE_EDGE_URL
   });
-  const handleModifyPath = modifyPath != null ? modifyPath : (path) => decodeURI(path);
+  const handleModifyPath = modifyPath != null ? modifyPath : ((path) => decodeURI(path));
   return async function fetcher(context) {
     var _a, _b;
     const {
       contextualEditingCompositionId,
       contextualEditingPath,
       resolvedUrl,
-      defaultFetchState: defaultPreviewState
+      defaultFetchState: defaultPreviewState,
+      isPreview,
+      previewReleaseId
     } = parseContext(context);
     let nodePath = prefix ? resolvedUrl.replace(new RegExp(`^${prefix}`), "") : resolvedUrl;
     nodePath = handleModifyPath(nodePath, context);
@@ -286,6 +303,11 @@ function createRouteFetcher(options) {
           console.log("Fetch route", nodePath);
         }
         const resolvedOptions = typeof requestOptions === "function" ? requestOptions(context) : requestOptions;
+        const releaseId = resolvePreviewReleaseId({
+          explicitReleaseId: resolvedOptions == null ? void 0 : resolvedOptions.releaseId,
+          isPreview,
+          previewReleaseId
+        });
         const time = Date.now();
         const response = await routeClient.getRoute({
           ...resolvedOptions,
@@ -295,7 +317,8 @@ function createRouteFetcher(options) {
             defaultPreviewState
           ),
           projectMapId,
-          path: nodePath
+          path: nodePath,
+          releaseId
         });
         const duration = Date.now() - time;
         if (!silent) {
@@ -361,14 +384,16 @@ var withUniformGetServerSideProps = (options) => {
     defaultHandleNotFound,
     defaultHandleRedirect,
     parseContext(context) {
-      var _a, _b, _c, _d;
+      var _a, _b, _c, _d, _e;
       return {
         contextualEditingCompositionId: ((_a = context.previewData) == null ? void 0 : _a.isUniformContextualEditing) ? (_b = context.previewData) == null ? void 0 : _b.compositionId : void 0,
         contextualEditingPath: ((_c = context.previewData) == null ? void 0 : _c.isUniformContextualEditing) ? (_d = context.previewData) == null ? void 0 : _d.compositionPath : void 0,
         resolvedUrl: context.resolvedUrl,
         // auto engage draft content when in next preview mode
         // (can override with explicit setting of request options)'
-        defaultFetchState: context.preview ? import_canvas2.CANVAS_DRAFT_STATE : void 0
+        defaultFetchState: context.preview ? import_canvas2.CANVAS_DRAFT_STATE : void 0,
+        isPreview: context.preview,
+        previewReleaseId: (_e = context.previewData) == null ? void 0 : _e.releaseId
       };
     }
   });
@@ -471,7 +496,7 @@ var withUniformGetStaticProps = (options) => {
     defaultHandleNotFound,
     defaultHandleRedirect,
     parseContext(context) {
-      var _a, _b, _c, _d, _e;
+      var _a, _b, _c, _d, _e, _f;
       return {
         contextualEditingCompositionId: ((_a = context.previewData) == null ? void 0 : _a.isUniformContextualEditing) ? (_b = context.previewData) == null ? void 0 : _b.compositionId : void 0,
         contextualEditingPath: ((_c = context.previewData) == null ? void 0 : _c.isUniformContextualEditing) ? (_d = context.previewData) == null ? void 0 : _d.compositionPath : void 0,
@@ -481,7 +506,9 @@ var withUniformGetStaticProps = (options) => {
         }),
         // auto engage draft content when in next preview mode
         // (can override with explicit setting of request options)
-        defaultFetchState: context.preview ? import_canvas4.CANVAS_DRAFT_STATE : void 0
+        defaultFetchState: context.preview ? import_canvas4.CANVAS_DRAFT_STATE : void 0,
+        isPreview: context.preview,
+        previewReleaseId: (_f = context.previewData) == null ? void 0 : _f.releaseId
       };
     }
   });

package/dist/route/index.mjs

@@ -1,6 +1,7 @@
 import {
-  logCompositionResponse
-} from "../chunk-JQWYBVLI.mjs";
+  logCompositionResponse,
+  resolvePreviewReleaseId
+} from "../chunk-4YXXKXP3.mjs";
 import {
   resolveSlugFromParams
 } from "../chunk-TR7V6ABJ.mjs";
@@ -89,14 +90,16 @@ function createRouteFetcher(options) {
     projectId: process.env.UNIFORM_PROJECT_ID,
     edgeApiHost: process.env.UNIFORM_CLI_BASE_EDGE_URL
   });
-  const handleModifyPath = modifyPath != null ? modifyPath : (path) => decodeURI(path);
+  const handleModifyPath = modifyPath != null ? modifyPath : ((path) => decodeURI(path));
   return async function fetcher(context) {
     var _a, _b;
     const {
       contextualEditingCompositionId,
       contextualEditingPath,
       resolvedUrl,
-      defaultFetchState: defaultPreviewState
+      defaultFetchState: defaultPreviewState,
+      isPreview,
+      previewReleaseId
     } = parseContext(context);
     let nodePath = prefix ? resolvedUrl.replace(new RegExp(`^${prefix}`), "") : resolvedUrl;
     nodePath = handleModifyPath(nodePath, context);
@@ -164,6 +167,11 @@ function createRouteFetcher(options) {
           console.log("Fetch route", nodePath);
         }
         const resolvedOptions = typeof requestOptions === "function" ? requestOptions(context) : requestOptions;
+        const releaseId = resolvePreviewReleaseId({
+          explicitReleaseId: resolvedOptions == null ? void 0 : resolvedOptions.releaseId,
+          isPreview,
+          previewReleaseId
+        });
         const time = Date.now();
         const response = await routeClient.getRoute({
           ...resolvedOptions,
@@ -173,7 +181,8 @@ function createRouteFetcher(options) {
             defaultPreviewState
           ),
           projectMapId,
-          path: nodePath
+          path: nodePath,
+          releaseId
         });
         const duration = Date.now() - time;
         if (!silent) {
@@ -239,14 +248,16 @@ var withUniformGetServerSideProps = (options) => {
     defaultHandleNotFound,
     defaultHandleRedirect,
     parseContext(context) {
-      var _a, _b, _c, _d;
+      var _a, _b, _c, _d, _e;
       return {
         contextualEditingCompositionId: ((_a = context.previewData) == null ? void 0 : _a.isUniformContextualEditing) ? (_b = context.previewData) == null ? void 0 : _b.compositionId : void 0,
         contextualEditingPath: ((_c = context.previewData) == null ? void 0 : _c.isUniformContextualEditing) ? (_d = context.previewData) == null ? void 0 : _d.compositionPath : void 0,
         resolvedUrl: context.resolvedUrl,
         // auto engage draft content when in next preview mode
         // (can override with explicit setting of request options)'
-        defaultFetchState: context.preview ? CANVAS_DRAFT_STATE : void 0
+        defaultFetchState: context.preview ? CANVAS_DRAFT_STATE : void 0,
+        isPreview: context.preview,
+        previewReleaseId: (_e = context.previewData) == null ? void 0 : _e.releaseId
       };
     }
   });
@@ -339,7 +350,7 @@ var withUniformGetStaticProps = (options) => {
     defaultHandleNotFound,
     defaultHandleRedirect,
     parseContext(context) {
-      var _a, _b, _c, _d, _e;
+      var _a, _b, _c, _d, _e, _f;
       return {
         contextualEditingCompositionId: ((_a = context.previewData) == null ? void 0 : _a.isUniformContextualEditing) ? (_b = context.previewData) == null ? void 0 : _b.compositionId : void 0,
         contextualEditingPath: ((_c = context.previewData) == null ? void 0 : _c.isUniformContextualEditing) ? (_d = context.previewData) == null ? void 0 : _d.compositionPath : void 0,
@@ -349,7 +360,9 @@ var withUniformGetStaticProps = (options) => {
         }),
         // auto engage draft content when in next preview mode
         // (can override with explicit setting of request options)
-        defaultFetchState: context.preview ? CANVAS_DRAFT_STATE3 : void 0
+        defaultFetchState: context.preview ? CANVAS_DRAFT_STATE3 : void 0,
+        isPreview: context.preview,
+        previewReleaseId: (_f = context.previewData) == null ? void 0 : _f.releaseId
       };
     }
   });

package/dist/slug/index.d.mts

@@ -1,9 +1,9 @@
 import * as next from 'next';
 import { GetServerSidePropsContext, GetServerSideProps, GetStaticPropsContext, GetStaticProps } from 'next';
-import { a as UniformPreviewData, c as UniformGetServerSideProps, b as UniformGetStaticProps } from '../models-CupnCqnn.mjs';
-import * as querystring from 'querystring';
-import { ParsedUrlQuery } from 'querystring';
+import { c as UniformPreviewData, a as UniformGetServerSideProps, b as UniformGetStaticProps } from '../models-BGg_qtcM.mjs';
+import * as node_querystring from 'node:querystring';
 import { CanvasClient, CompositionGetBySlugParameters, DataResolutionOption, CompositionGetParameters, CompositionGetResponse } from '@uniformdev/canvas';
+import { ParsedUrlQuery } from 'querystring';
 import '@uniformdev/canvas-react';
 
 declare const withUniformGetServerSideProps: <TProps extends {
@@ -65,11 +65,11 @@ declare const withUniformGetStaticProps: <TProps extends {
 
 declare const getServerSideProps: next.GetServerSideProps<{
     [key: string]: any;
-}, querystring.ParsedUrlQuery, UniformPreviewData>;
+}, node_querystring.ParsedUrlQuery, UniformPreviewData>;
 /** Ready to go getStaticProps for dynamic route with 'slug' param for [[...slug]].jsx */
 declare const getStaticProps: next.GetStaticProps<{
     [key: string]: any;
-}, querystring.ParsedUrlQuery, UniformPreviewData>;
+}, node_querystring.ParsedUrlQuery, UniformPreviewData>;
 declare const getStaticPaths: () => Promise<{
     paths: string[];
     fallback: boolean;

package/dist/slug/index.d.ts

@@ -1,9 +1,9 @@
 import * as next from 'next';
 import { GetServerSidePropsContext, GetServerSideProps, GetStaticPropsContext, GetStaticProps } from 'next';
-import { a as UniformPreviewData, c as UniformGetServerSideProps, b as UniformGetStaticProps } from '../models-CupnCqnn.js';
-import * as querystring from 'querystring';
-import { ParsedUrlQuery } from 'querystring';
+import { c as UniformPreviewData, a as UniformGetServerSideProps, b as UniformGetStaticProps } from '../models-BGg_qtcM.js';
+import * as node_querystring from 'node:querystring';
 import { CanvasClient, CompositionGetBySlugParameters, DataResolutionOption, CompositionGetParameters, CompositionGetResponse } from '@uniformdev/canvas';
+import { ParsedUrlQuery } from 'querystring';
 import '@uniformdev/canvas-react';
 
 declare const withUniformGetServerSideProps: <TProps extends {
@@ -65,11 +65,11 @@ declare const withUniformGetStaticProps: <TProps extends {
 
 declare const getServerSideProps: next.GetServerSideProps<{
     [key: string]: any;
-}, querystring.ParsedUrlQuery, UniformPreviewData>;
+}, node_querystring.ParsedUrlQuery, UniformPreviewData>;
 /** Ready to go getStaticProps for dynamic route with 'slug' param for [[...slug]].jsx */
 declare const getStaticProps: next.GetStaticProps<{
     [key: string]: any;
-}, querystring.ParsedUrlQuery, UniformPreviewData>;
+}, node_querystring.ParsedUrlQuery, UniformPreviewData>;
 declare const getStaticPaths: () => Promise<{
     paths: string[];
     fallback: boolean;

package/dist/slug/index.js

@@ -32,6 +32,21 @@ module.exports = __toCommonJS(slug_exports);
 // src/slug/withUniformGetServerSideProps.ts
 var import_canvas = require("@uniformdev/canvas");
 
+// src/helpers/resolvePreviewReleaseId.ts
+function resolvePreviewReleaseId({
+  explicitReleaseId,
+  isPreview,
+  previewReleaseId
+}) {
+  if (typeof explicitReleaseId !== "undefined") {
+    return explicitReleaseId;
+  }
+  if (!isPreview) {
+    return void 0;
+  }
+  return previewReleaseId;
+}
+
 // src/logging/logCompositionIssues.ts
 var import_colorette = require("colorette");
 function logCompositionIssues(prefix, issues, colour = "red") {
@@ -144,15 +159,20 @@ var withUniformGetServerSideProps = (options) => {
     edgeApiHost: process.env.UNIFORM_CLI_BASE_EDGE_URL
   });
   return async function wrappedGetServerSideProps(context) {
-    var _a;
+    var _a, _b;
     const { preview, previewData } = context;
+    const releaseId = resolvePreviewReleaseId({
+      explicitReleaseId: (_a = options == null ? void 0 : options.requestOptions) == null ? void 0 : _a.releaseId,
+      isPreview: preview || (options == null ? void 0 : options.preview),
+      previewReleaseId: previewData == null ? void 0 : previewData.releaseId
+    });
     let composition = void 0;
     let slug = (options == null ? void 0 : options.prefix) ? context.resolvedUrl.replace(new RegExp(`^${options.prefix}`), "") : context.resolvedUrl;
     if (options == null ? void 0 : options.modifySlug) {
       slug = options.modifySlug(slug, context);
     }
     if (previewData == null ? void 0 : previewData.isUniformContextualEditing) {
-      composition = { ...import_canvas.EMPTY_COMPOSITION, _id: (_a = previewData.compositionId) != null ? _a : import_canvas.EMPTY_COMPOSITION._id };
+      composition = { ...import_canvas.EMPTY_COMPOSITION, _id: (_b = previewData.compositionId) != null ? _b : import_canvas.EMPTY_COMPOSITION._id };
     } else {
       try {
         const time = Date.now();
@@ -160,7 +180,8 @@ var withUniformGetServerSideProps = (options) => {
           ...options == null ? void 0 : options.requestOptions,
           slug,
           state: preview || (options == null ? void 0 : options.preview) ? import_canvas.CANVAS_DRAFT_STATE : import_canvas.CANVAS_PUBLISHED_STATE,
-          diagnostics: true
+          diagnostics: true,
+          releaseId
         });
         const duration = Date.now() - time;
         composition = response.composition;
@@ -233,7 +254,7 @@ var withUniformGetStaticProps = (options) => {
     edgeApiHost: process.env.UNIFORM_CLI_BASE_EDGE_URL
   });
   return async function wrappedGetStaticProps(context) {
-    var _a2;
+    var _a2, _b;
     let slugString = resolveSlugFromParams({
       param: options == null ? void 0 : options.param,
       params: context == null ? void 0 : context.params
@@ -242,16 +263,22 @@ var withUniformGetStaticProps = (options) => {
       slugString = options.modifySlug(slugString, context);
     }
     const { preview, previewData } = context;
+    const releaseId = resolvePreviewReleaseId({
+      explicitReleaseId: (_a2 = options == null ? void 0 : options.requestOptions) == null ? void 0 : _a2.releaseId,
+      isPreview: preview || (options == null ? void 0 : options.preview),
+      previewReleaseId: previewData == null ? void 0 : previewData.releaseId
+    });
     let composition = void 0;
     if (previewData == null ? void 0 : previewData.isUniformContextualEditing) {
-      composition = { ...import_canvas3.EMPTY_COMPOSITION, _id: (_a2 = previewData.compositionId) != null ? _a2 : import_canvas3.EMPTY_COMPOSITION._id };
+      composition = { ...import_canvas3.EMPTY_COMPOSITION, _id: (_b = previewData.compositionId) != null ? _b : import_canvas3.EMPTY_COMPOSITION._id };
     } else {
       try {
         const time = Date.now();
         const response = await canvasClient.getCompositionBySlug({
           slug: slugString,
           state: preview || (options == null ? void 0 : options.preview) ? import_canvas3.CANVAS_DRAFT_STATE : import_canvas3.CANVAS_PUBLISHED_STATE,
-          ...options == null ? void 0 : options.requestOptions
+          ...options == null ? void 0 : options.requestOptions,
+          releaseId
         });
         const duration = Date.now() - time;
         composition = response.composition;

package/dist/slug/index.mjs

@@ -1,6 +1,7 @@
 import {
-  logCompositionResponse
-} from "../chunk-JQWYBVLI.mjs";
+  logCompositionResponse,
+  resolvePreviewReleaseId
+} from "../chunk-4YXXKXP3.mjs";
 import {
   resolveSlugFromParams
 } from "../chunk-TR7V6ABJ.mjs";
@@ -20,15 +21,20 @@ var withUniformGetServerSideProps = (options) => {
     edgeApiHost: process.env.UNIFORM_CLI_BASE_EDGE_URL
   });
   return async function wrappedGetServerSideProps(context) {
-    var _a;
+    var _a, _b;
     const { preview, previewData } = context;
+    const releaseId = resolvePreviewReleaseId({
+      explicitReleaseId: (_a = options == null ? void 0 : options.requestOptions) == null ? void 0 : _a.releaseId,
+      isPreview: preview || (options == null ? void 0 : options.preview),
+      previewReleaseId: previewData == null ? void 0 : previewData.releaseId
+    });
     let composition = void 0;
     let slug = (options == null ? void 0 : options.prefix) ? context.resolvedUrl.replace(new RegExp(`^${options.prefix}`), "") : context.resolvedUrl;
     if (options == null ? void 0 : options.modifySlug) {
       slug = options.modifySlug(slug, context);
     }
     if (previewData == null ? void 0 : previewData.isUniformContextualEditing) {
-      composition = { ...EMPTY_COMPOSITION, _id: (_a = previewData.compositionId) != null ? _a : EMPTY_COMPOSITION._id };
+      composition = { ...EMPTY_COMPOSITION, _id: (_b = previewData.compositionId) != null ? _b : EMPTY_COMPOSITION._id };
     } else {
       try {
         const time = Date.now();
@@ -36,7 +42,8 @@ var withUniformGetServerSideProps = (options) => {
           ...options == null ? void 0 : options.requestOptions,
           slug,
           state: preview || (options == null ? void 0 : options.preview) ? CANVAS_DRAFT_STATE : CANVAS_PUBLISHED_STATE,
-          diagnostics: true
+          diagnostics: true,
+          releaseId
         });
         const duration = Date.now() - time;
         composition = response.composition;
@@ -106,7 +113,7 @@ var withUniformGetStaticProps = (options) => {
     edgeApiHost: process.env.UNIFORM_CLI_BASE_EDGE_URL
   });
   return async function wrappedGetStaticProps(context) {
-    var _a2;
+    var _a2, _b;
     let slugString = resolveSlugFromParams({
       param: options == null ? void 0 : options.param,
       params: context == null ? void 0 : context.params
@@ -115,16 +122,22 @@ var withUniformGetStaticProps = (options) => {
       slugString = options.modifySlug(slugString, context);
     }
     const { preview, previewData } = context;
+    const releaseId = resolvePreviewReleaseId({
+      explicitReleaseId: (_a2 = options == null ? void 0 : options.requestOptions) == null ? void 0 : _a2.releaseId,
+      isPreview: preview || (options == null ? void 0 : options.preview),
+      previewReleaseId: previewData == null ? void 0 : previewData.releaseId
+    });
     let composition = void 0;
     if (previewData == null ? void 0 : previewData.isUniformContextualEditing) {
-      composition = { ...EMPTY_COMPOSITION2, _id: (_a2 = previewData.compositionId) != null ? _a2 : EMPTY_COMPOSITION2._id };
+      composition = { ...EMPTY_COMPOSITION2, _id: (_b = previewData.compositionId) != null ? _b : EMPTY_COMPOSITION2._id };
     } else {
       try {
         const time = Date.now();
         const response = await canvasClient.getCompositionBySlug({
           slug: slugString,
           state: preview || (options == null ? void 0 : options.preview) ? CANVAS_DRAFT_STATE3 : CANVAS_PUBLISHED_STATE3,
-          ...options == null ? void 0 : options.requestOptions
+          ...options == null ? void 0 : options.requestOptions,
+          releaseId
         });
         const duration = Date.now() - time;
         composition = response.composition;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniformdev/canvas-next",
-  "version": "20.49.2",
+  "version": "20.49.3-alpha.47+9aed70a64d",
   "description": "Next.js SDK for Uniform Canvas",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "./dist/index.js",
@@ -61,18 +61,17 @@
     "build": "tsup",
     "dev": "tsup --watch",
     "clean": "rimraf dist",
-    "test": "jest --maxWorkers=1 --passWithNoTests",
-    "lint": "eslint \"src/**/*.{js,ts,tsx}\"",
+    "test": "vitest run",
     "format": "prettier --write \"src/**/*.{js,ts,tsx}\"",
-    "document:prebuild": "api-extractor run --local"
+    "apidocs-extract": "api-extractor run --local"
   },
   "dependencies": {
-    "@uniformdev/canvas": "20.49.2",
-    "@uniformdev/canvas-react": "20.49.2",
-    "@uniformdev/context": "20.49.2",
-    "@uniformdev/project-map": "20.49.2",
-    "@uniformdev/redirect": "20.49.2",
-    "@uniformdev/richtext": "20.49.2",
+    "@uniformdev/canvas": "20.49.3-alpha.47+9aed70a64d",
+    "@uniformdev/canvas-react": "20.49.3-alpha.47+9aed70a64d",
+    "@uniformdev/context": "20.49.3-alpha.47+9aed70a64d",
+    "@uniformdev/project-map": "20.49.3-alpha.47+9aed70a64d",
+    "@uniformdev/redirect": "20.49.3-alpha.47+9aed70a64d",
+    "@uniformdev/richtext": "20.49.3-alpha.47+9aed70a64d",
     "colorette": "2.0.20"
   },
   "peerDependencies": {
@@ -81,8 +80,8 @@
     "react-dom": ">=16"
   },
   "devDependencies": {
-    "@types/react": "19.2.2",
-    "next": "16.0.10",
+    "@types/react": "19.2.17",
+    "next": "16.2.9",
     "react": "19.2.1",
     "react-dom": "19.2.1"
   },
@@ -92,5 +91,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "6236dd13bff34cc8ec526d2e93e344428c1c9541"
+  "gitHead": "9aed70a64de0ca177d27ea99dc25f1ad053f87ad"
 }