Merge pull request #637 from contentful/next

release@main

.github/workflows/main.yml

@@ -5,6 +5,12 @@ on:
     branches:
       - '**'
   workflow_dispatch:
+    inputs:
+      publish-prerelease:
+        description: 'Publish prerelease version of the selected branch'
+        required: false
+        default: false
+        type: boolean
 
 jobs:
   install-build:
@@ -21,14 +27,18 @@ jobs:
     if: >-
       (github.ref_name == 'main' ||
         github.ref_name == 'development' ||
-        github.ref_name == 'next') &&
+        github.ref_name == 'next' ||
+        inputs.publish-prerelease 
+      ) &&
       !contains(github.event.head_commit.message, 'skip-release') &&
       github.actor != 'dependabot[bot]' &&
       github.actor != 'contentful-automation[bot]'
     permissions:
       contents: write
       id-token: write
     uses: ./.github/workflows/publish.yaml
+    with:
+      publish-prelease: ${{ inputs.publish-prerelease }}
     secrets:
       VAULT_URL: ${{ secrets.VAULT_URL }}
   upload-artifact-cleanup:

.github/workflows/publish.yaml

@@ -2,6 +2,12 @@ name: Publish packages
 
 on:
   workflow_call:
+    inputs:
+      publish-prelease:
+        description: 'Publish prerelease version of the current ref'
+        default: false
+        required: false
+        type: boolean
     secrets:
       VAULT_URL:
         required: true
@@ -73,14 +79,17 @@ jobs:
           git config user.name "${{ github.actor }}"
           git config user.email "${{ github.actor}}@users.noreply.github.com"
 
-          if [ ${{ github.ref_name }} = development ]; then
-            npx lerna publish --conventional-commits --conventional-prerelease --exact --force-publish --preid dev-$(date +%Y%m%dT%H%M)-$(git rev-parse HEAD  | cut -c1-7) --dist-tag dev --no-changelog --no-push --yes --no-private 
+          if [ ${{ inputs.publish-prerelease }} ]; then
+            npx lerna publish --conventional-commits --conventional-prerelease --exact --force-publish --preid prerelease-$(date +%Y%m%dT%H%M)-$(git rev-parse HEAD | cut -c1-7) --no-changelog --no-push --yes --no-private --dist-tag prerelease --allow-branch ${{ github.ref_name }}
+          elif [ ${{ github.ref_name }} = development ]; then
+            npx lerna publish --conventional-commits --conventional-prerelease --exact --force-publish --preid dev-$(date +%Y%m%dT%H%M)-$(git rev-parse HEAD | cut -c1-7) --dist-tag dev --no-changelog --no-push --yes --no-private 
           elif [ ${{ github.ref_name }} = next ]; then
             npx lerna publish --conventional-commits --conventional-prerelease --exact --force-publish --preid beta --dist-tag next --no-changelog --yes --no-private
           else
             npx lerna publish --conventional-commits --conventional-graduate --exact --force-publish --yes --no-private --dist-tag latest --create-release github
           fi
       - name: 'Merge changes downstream'
+        if: ${{ !inputs.publish-prerelease }}
         env:
           GH_TOKEN: ${{ secrets.GH_TOKEN }}
         run: |

README.md

@@ -63,6 +63,10 @@ When a PR is merged into `main`, the CI/CD pipeline will automatically publish a
 
 To fix a critical bug that is in `main`, branch of the `main` branch. When your work is complete open a PR against `main`, and when it is approved, merge it back into `main` using the "Squash and merge" option. The change will be automatically merged back into `next` and `development`. However, if there is a merge conflict doing so, you will have to resolve it manually.
 
+### "Prerelease" packages
+
+An option exists for developers to publish specific feature branches as an installable "prerelease" version for testing purposes. This option is presented when [manually triggering the main workflow](https://github.com/contentful/experience-builder/actions/workflows/main.yml). If the "Publish prerelease version of the selected branch" checkbox is selected, a package version for that work-in-progress feature branch will be published to the public NPM repository.
+
 ## Commit Message Guidelines
 
 We follow the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) specification for our commit messages. This allows us to automatically generate changelogs and version bumps based on the commit messages. Please take care in your commit messages that make it into the main branches (`development`, `next`, and `main`) to follow this specification, as it helps with the release process.

packages/core/src/constants.ts

@@ -25,6 +25,7 @@ export const OUTGOING_EVENTS = {
   ComponentMoveStarted: 'componentMoveStarted',
   ComponentMoveEnded: 'componentMoveEnded',
   OutsideCanvasClick: 'outsideCanvasClick',
+  SDKFeatures: 'sdkFeatures',
 };
 
 export const INCOMING_EVENTS = {

packages/core/src/registries/breakpointsRegistry.ts

@@ -12,6 +12,8 @@ export const defineBreakpoints = (breakpoints: Breakpoint[]) => {
 };
 
 export const runBreakpointsValidation = () => {
+  if (!breakpointsRegistry.length) return;
+
   const validation = validateBreakpointsDefinition(breakpointsRegistry);
   if (!validation.success) {
     throw new Error(

packages/experience-builder-sdk/src/core/sdkFeatures.ts

@@ -0,0 +1,2 @@
+// Object to store the SDK features that are enabled/disabled
+export const sdkFeatures: Record<string, unknown> = {};

packages/experience-builder-sdk/src/hooks/useDetectEditorMode.tsx

@@ -5,6 +5,7 @@ import {
   tryParseMessage,
 } from '@contentful/experiences-core';
 import { INCOMING_EVENTS, OUTGOING_EVENTS } from '@contentful/experiences-core/constants';
+import { sdkFeatures } from '../core/sdkFeatures';
 
 type UseDetectEditorModeArgs = {
   /** If running from a known client side only situation (ie: useFetchBySlug),
@@ -42,6 +43,7 @@ export const useDetectEditorMode = ({ isClientSide = false }: UseDetectEditorMod
       if (typeof window !== 'undefined' && !window.__EB__?.isEditorMode) {
         window.addEventListener('message', onMessage);
         sendMessage(OUTGOING_EVENTS.Connected);
+        sendMessage(OUTGOING_EVENTS.SDKFeatures, sdkFeatures);
 
         setTimeout(() => {
           if (!receivedMessage.current) {