@uniformdev/canvas-next 20.56.0 → 20.56.1-alpha.5

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 { ParsedUrlQuery } from 'querystring';
-export { U as UniformCompositionNextPage, c as UniformGetServerSideProps, b as UniformGetStaticProps, a as UniformPreviewData } from './models-CupnCqnn.mjs';
+export { U as UniformCompositionNextPage, c as UniformGetServerSideProps, b as UniformGetStaticProps, a as UniformPreviewData } from './models-r9gINwBs.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 { ParsedUrlQuery } from 'querystring';
-export { U as UniformCompositionNextPage, c as UniformGetServerSideProps, b as UniformGetStaticProps, a as UniformPreviewData } from './models-CupnCqnn.js';
+export { U as UniformCompositionNextPage, c as UniformGetServerSideProps, b as UniformGetStaticProps, a as UniformPreviewData } from './models-r9gINwBs.js';
 import { NextApiHandler, NextApiRequest } from 'next';
 import { RootComponentInstance } from '@uniformdev/canvas';
 

package/dist/index.esm.js

@@ -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);

package/dist/index.js

@@ -140,6 +140,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 +168,7 @@ var createPreviewHandlerGet = ({ secret, resolveFullPath = resolveFullPathDefaul
       compositionSlug: slug,
       compositionPath: path,
       locale,
+      releaseId,
       isPlayground,
       patternType: !isPlayground ? void 0 : getQueryParam(req, "patternType")
     },
@@ -185,6 +187,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);

package/dist/index.mjs

@@ -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);

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

@@ -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`.

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

@@ -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`.

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

@@ -1,6 +1,6 @@
 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 { c as UniformGetServerSideProps, a as UniformPreviewData, b as UniformGetStaticProps } from '../models-r9gINwBs.mjs';
 import * as querystring from 'querystring';
 import { ParsedUrlQuery } from 'querystring';
 import { CanvasClient, CompositionGetByNodePathParameters, DataResolutionOption } from '@uniformdev/canvas';

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

@@ -1,6 +1,6 @@
 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 { c as UniformGetServerSideProps, a as UniformPreviewData, b as UniformGetStaticProps } from '../models-r9gINwBs.js';
 import * as querystring from 'querystring';
 import { ParsedUrlQuery } from 'querystring';
 import { CanvasClient, CompositionGetByNodePathParameters, DataResolutionOption } from '@uniformdev/canvas';

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,6 +1,6 @@
 import * as next from 'next';
 import { GetServerSidePropsContext, GetServerSidePropsResult, GetServerSideProps, GetStaticPropsContext, GetStaticPropsResult, GetStaticProps } from 'next';
-import { a as UniformPreviewData } from '../models-CupnCqnn.mjs';
+import { a as UniformPreviewData } from '../models-r9gINwBs.mjs';
 import * as querystring from 'querystring';
 import { ParsedUrlQuery } from 'querystring';
 import * as _uniformdev_context__ from '@uniformdev/context/*';

package/dist/route/index.d.ts

@@ -1,6 +1,6 @@
 import * as next from 'next';
 import { GetServerSidePropsContext, GetServerSidePropsResult, GetServerSideProps, GetStaticPropsContext, GetStaticPropsResult, GetStaticProps } from 'next';
-import { a as UniformPreviewData } from '../models-CupnCqnn.js';
+import { a as UniformPreviewData } from '../models-r9gINwBs.js';
 import * as querystring from 'querystring';
 import { ParsedUrlQuery } from 'querystring';
 import * as _uniformdev_context__ from '@uniformdev/context/*';

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") {
@@ -218,7 +233,9 @@ function createRouteFetcher(options) {
       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";
@@ -96,7 +97,9 @@ function createRouteFetcher(options) {
       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,6 +1,6 @@
 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 { a as UniformPreviewData, c as UniformGetServerSideProps, b as UniformGetStaticProps } from '../models-r9gINwBs.mjs';
 import * as querystring from 'querystring';
 import { ParsedUrlQuery } from 'querystring';
 import { CanvasClient, CompositionGetBySlugParameters, DataResolutionOption, CompositionGetParameters, CompositionGetResponse } from '@uniformdev/canvas';

package/dist/slug/index.d.ts

@@ -1,6 +1,6 @@
 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 { a as UniformPreviewData, c as UniformGetServerSideProps, b as UniformGetStaticProps } from '../models-r9gINwBs.js';
 import * as querystring from 'querystring';
 import { ParsedUrlQuery } from 'querystring';
 import { CanvasClient, CompositionGetBySlugParameters, DataResolutionOption, CompositionGetParameters, CompositionGetResponse } from '@uniformdev/canvas';

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.56.0",
+  "version": "20.56.1-alpha.5+1bce2eca70",
   "description": "Next.js SDK for Uniform Canvas",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "./dist/index.js",
@@ -67,12 +67,12 @@
     "document:prebuild": "api-extractor run --local"
   },
   "dependencies": {
-    "@uniformdev/canvas": "20.56.0",
-    "@uniformdev/canvas-react": "20.56.0",
-    "@uniformdev/context": "20.56.0",
-    "@uniformdev/project-map": "20.56.0",
-    "@uniformdev/redirect": "20.56.0",
-    "@uniformdev/richtext": "20.56.0",
+    "@uniformdev/canvas": "20.56.1-alpha.5+1bce2eca70",
+    "@uniformdev/canvas-react": "20.56.1-alpha.5+1bce2eca70",
+    "@uniformdev/context": "20.56.1-alpha.5+1bce2eca70",
+    "@uniformdev/project-map": "20.56.1-alpha.5+1bce2eca70",
+    "@uniformdev/redirect": "20.56.1-alpha.5+1bce2eca70",
+    "@uniformdev/richtext": "20.56.1-alpha.5+1bce2eca70",
     "colorette": "2.0.20"
   },
   "peerDependencies": {
@@ -92,5 +92,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "45d5acb6435efe756dae0c7f211ad86e2596d9fb"
+  "gitHead": "1bce2eca70191de304d93909e5cf08740b01fb5a"
 }