Version Packages (integrations/makeswift) (#2864)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Author: github-actions[bot]

.changeset/fix-layout-shift.md

@@ -1,5 +1,99 @@
 # Changelog
 
+## 1.5.0
+
+### Minor Changes
+
+- Pulls in changes from the `@bigcommerce/[email protected]` release. For more information about what was included in the `@bigcommerce/[email protected]` release, see the [changelog entry](https://github.com/bigcommerce/catalyst/blob/0d951ab190c6bf1573ca7de925ecb0017d954cb7/core/CHANGELOG.md#150).
+
+### Patch Changes
+
+- [#2919](https://github.com/bigcommerce/catalyst/pull/2919) [`32be644`](https://github.com/bigcommerce/catalyst/commit/32be6443457965467fb793e524347a9e43a9338e) Thanks [@matthewvolk](https://github.com/matthewvolk)! - Upgrade `@makeswift/runtime` to `0.26.3`, which uses the `<Activity>` API instead of `<Suspense>`. This fixes layout shift both when loading a Makeswift page directly and when client-side navigating from a non-Makeswift page to a Makeswift page after a hard refresh.
+
+- [#2862](https://github.com/bigcommerce/catalyst/pull/2862) [`52207b6`](https://github.com/bigcommerce/catalyst/commit/52207b69c50f58027400f716bf18c53cac82189b) Thanks [@Codeseph](https://github.com/Codeseph)! - fix: handle OPTIONS requests via MakeswiftApiHandler
+
+- [#2860](https://github.com/bigcommerce/catalyst/pull/2860) [`5097034`](https://github.com/bigcommerce/catalyst/commit/5097034e93a9135b646f53445c83c8716fbeb76f) Thanks [@jorgemoya](https://github.com/jorgemoya)! - Add explicit Makeswift SEO metadata support to public-facing pages. When configured in Makeswift, the SEO title and description will take priority over the default values from BigCommerce or static translations.
+
+  The following pages now support Makeswift SEO metadata:
+  - Home page (`/`)
+  - Catch-all page (`/[...rest]`)
+  - Product page (`/product/[slug]`)
+  - Brand page (`/brand/[slug]`)
+  - Category page (`/category/[slug]`)
+  - Blog list page (`/blog`)
+  - Blog post page (`/blog/[blogId]`)
+  - Search page (`/search`)
+  - Cart page (`/cart`)
+  - Compare page (`/compare`)
+  - Gift certificates page (`/gift-certificates`)
+  - Gift certificates balance page (`/gift-certificates/balance`)
+  - Contact webpage (`/webpages/[id]/contact`)
+  - Normal webpage (`/webpages/[id]/normal`)
+
+  ## Migration steps
+
+  ### Step 1: Add `getMakeswiftPageMetadata` function
+
+  Add the `getMakeswiftPageMetadata` function to `core/lib/makeswift/client.ts`:
+
+  ```diff
+  + export async function getMakeswiftPageMetadata({ path, locale }: { path: string; locale: string }) {
+  +   const { data: pages } = await client.getPages({
+  +     pathPrefix: path,
+  +     locale: normalizeLocale(locale),
+  +     siteVersion: await getSiteVersion(),
+  +   });
+  +
+  +   if (pages.length === 0 || !pages[0]) {
+  +     return null;
+  +   }
+  +
+  +   const { title, description } = pages[0];
+  +
+  +   return {
+  +     ...(title && { title }),
+  +     ...(description && { description }),
+  +   };
+  + }
+  ```
+
+  Export the function from `core/lib/makeswift/index.ts`:
+
+  ```diff
+    export { Page } from './page';
+  - export { client } from './client';
+  + export { client, getMakeswiftPageMetadata } from './client';
+  ```
+
+  ### Step 2: Update page metadata
+
+  Each page's `generateMetadata` function has been updated to fetch Makeswift metadata and use it as the primary source, falling back to existing values. Here's an example using the cart page:
+
+  Update `core/app/[locale]/(default)/cart/page.tsx`:
+
+  ```diff
+    import { getPreferredCurrencyCode } from '~/lib/currency';
+  + import { getMakeswiftPageMetadata } from '~/lib/makeswift';
+    import { Slot } from '~/lib/makeswift/slot';
+  ```
+
+  ```diff
+    export async function generateMetadata({ params }: Props): Promise<Metadata> {
+      const { locale } = await params;
+
+      const t = await getTranslations({ locale, namespace: 'Cart' });
+  +   const makeswiftMetadata = await getMakeswiftPageMetadata({ path: '/cart', locale });
+
+      return {
+  -     title: t('title'),
+  +     title: makeswiftMetadata?.title || t('title'),
+  +     description: makeswiftMetadata?.description || undefined,
+      };
+    }
+  ```
+
+  Apply the same pattern to the other pages listed above, using the appropriate path for each page (e.g., `/blog`, `/search`, `/compare`, etc.).
+
 ## 1.4.2
 
 ### Patch Changes

.changeset/heavy-cups-train.md

@@ -1,7 +1,7 @@
 {
   "name": "@bigcommerce/catalyst-makeswift",
   "description": "BigCommerce Catalyst is a Next.js starter kit for building headless BigCommerce storefronts.",
-  "version": "1.4.2",
+  "version": "1.5.0",
   "private": true,
   "engines": {
     "node": ">=24.0.0"