@pradip1995/framework-runtime 0.2.1 → 0.2.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pradip1995/framework-runtime",
-  "version": "0.2.1",
+  "version": "0.2.5",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -16,7 +16,7 @@
   "dependencies": {
     "@pradip1995/framework-core": "0.2.1",
     "@pradip1995/plugin-sdk": "0.2.1",
-    "@pradip1995/medusa-connector": "0.2.1"
+    "@pradip1995/medusa-connector": "0.2.2"
   },
   "peerDependencies": {
     "next": ">=15",

package/src/builder-data.ts

@@ -0,0 +1,37 @@
+export type BuilderSegmentDataFile = {
+  version: string
+  updatedAt: string
+  data: Record<string, Record<string, unknown>>
+}
+
+function isPlainObject(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value)
+}
+
+/** Deep-merge builder CMS values over workflow output (builder wins on conflicts). */
+export function mergeBuilderSegmentData(
+  workflowData: Record<string, unknown>,
+  builderData: BuilderSegmentDataFile | null | undefined
+): Record<string, unknown> {
+  if (!builderData?.data || Object.keys(builderData.data).length === 0) {
+    return workflowData
+  }
+
+  const merged = { ...workflowData }
+
+  for (const [key, overlay] of Object.entries(builderData.data)) {
+    if (!isPlainObject(overlay)) {
+      merged[key] = overlay
+      continue
+    }
+
+    const existing = merged[key]
+    if (isPlainObject(existing)) {
+      merged[key] = { ...existing, ...overlay }
+    } else {
+      merged[key] = { ...overlay }
+    }
+  }
+
+  return merged
+}

package/src/index.ts

@@ -1,4 +1,11 @@
 export { renderPage, registerServices, resolveServices, getSegmentProps } from "./render-page"
 export { renderConfiguredPage } from "./render-configured-page"
+export {
+  applyBuilderDataToWorkflow,
+  getSegmentDataKey,
+  SEGMENT_DATA_KEYS,
+} from "./segment-props"
+export { mergeBuilderSegmentData } from "./builder-data"
 export type { RenderPageInput } from "./render-page"
 export type { ConfiguredPage, RenderConfiguredPageInput, SegmentEntry } from "./render-configured-page"
+export type { BuilderSegmentDataFile } from "./builder-data"

package/src/render-configured-page.tsx

@@ -1,11 +1,19 @@
 import { buildRouteContext } from "@pradip1995/framework-core"
 import { resolveServices } from "./register-services"
-import { getSegmentProps } from "./segment-props"
+import {
+  applyChromeSegmentData,
+  applyBuilderDataToWorkflow,
+  resolveSegmentProps,
+  type ChromeSegmentRef,
+} from "./segment-props"
+import type { BuilderSegmentDataFile } from "./builder-data"
 import type { ComponentType, ReactNode } from "react"
 
 export type SegmentEntry = {
   pkg: string
   Component: ComponentType<Record<string, unknown>>
+  /** CMS values from pages.config.json, shaped by segment builder.settings.json */
+  data?: Record<string, unknown>
 }
 
 export type ConfiguredPage = {
@@ -24,6 +32,12 @@ export type RenderConfiguredPageInput = {
   countryCode: string
   slug: string[]
   searchParams: Record<string, string | string[] | undefined>
+  /** Global layout chrome from pages.config.json chrome[] */
+  chrome?: ChromeSegmentRef[] | null
+  /** @deprecated legacy global overlay */
+  pageSegmentData?: BuilderSegmentDataFile | null
+  /** @deprecated use chrome + inline segment data */
+  builderSegmentData?: BuilderSegmentDataFile | null
 }
 
 function NotFoundPanel({ message }: { message: string }) {
@@ -42,7 +56,14 @@ export async function renderConfiguredPage(input: RenderConfiguredPageInput): Pr
   try {
     const route = buildRouteContext(input.countryCode, input.slug, input.searchParams)
     const services = await resolveServices()
-    const data = await input.page.workflow.execute({ route, services })
+    const workflowData = await input.page.workflow.execute({ route, services })
+
+    const legacyOverlay = input.pageSegmentData ?? input.builderSegmentData
+    let data = legacyOverlay
+      ? applyBuilderDataToWorkflow(workflowData, legacyOverlay)
+      : workflowData
+    data = applyChromeSegmentData(data, input.chrome)
+
     const Layout = input.page.layout
 
     if (data.notFound) {
@@ -58,8 +79,8 @@ export async function renderConfiguredPage(input: RenderConfiguredPageInput): Pr
       )
     }
 
-    const segmentElements = input.page.segments.map(({ pkg, Component: Segment }) => {
-      const props = getSegmentProps(pkg, data)
+    const segmentElements = input.page.segments.map(({ pkg, Component: Segment, data: inline }) => {
+      const props = resolveSegmentProps(pkg, data, inline)
       return <Segment key={pkg} {...props} />
     })
 

package/src/render-page.tsx

@@ -1,6 +1,7 @@
 import { matchRoute, buildRouteContext } from "@pradip1995/framework-core"
 import { resolveServices } from "./register-services"
-import { getSegmentProps } from "./segment-props"
+import { applyBuilderDataToWorkflow, getSegmentProps } from "./segment-props"
+import type { BuilderSegmentDataFile } from "./builder-data"
 import type { ComponentType, ReactNode } from "react"
 import type { PageConfigEntry } from "@pradip1995/plugin-sdk"
 
@@ -12,6 +13,10 @@ export type RenderPageInput = {
   searchParams: Record<string, string | string[] | undefined>
   routeManifest: PageConfigEntry[]
   importMap: ImportMap
+  /** CMS values from pages.config.json segmentData */
+  pageSegmentData?: BuilderSegmentDataFile | null
+  /** @deprecated use pageSegmentData */
+  builderSegmentData?: BuilderSegmentDataFile | null
 }
 
 async function resolvePlugin(importMap: ImportMap, pkg: string) {
@@ -42,7 +47,9 @@ export async function renderPage(input: RenderPageInput): Promise<ReactNode> {
       }
     }
 
-    const data = await workflowMod.default.execute({ route, services })
+    const workflowData = await workflowMod.default.execute({ route, services })
+    const pageSegmentData = input.pageSegmentData ?? input.builderSegmentData
+    const data = applyBuilderDataToWorkflow(workflowData, pageSegmentData)
 
     const layoutMod = (await resolvePlugin(input.importMap, page!.layout)) as {
       default: ComponentType<{ data: Record<string, unknown>; children: ReactNode }>

package/src/segment-props.ts

@@ -1,5 +1,7 @@
+import { mergeBuilderSegmentData, type BuilderSegmentDataFile } from "./builder-data"
+
 /** Maps segment package name → workflow output key(s) */
-const SEGMENT_DATA_KEYS: Record<string, string> = {
+export const SEGMENT_DATA_KEYS: Record<string, string> = {
   "@pradip1995/segment-hero": "hero",
   "@pradip1995/segment-shop-by-age": "shopByAge",
   "@pradip1995/segment-shop-by-category": "shopByCategory",
@@ -36,6 +38,10 @@ const SEGMENT_DATA_KEYS: Record<string, string> = {
   "@pradip1995/segment-help": "helpPage",
 }
 
+export function getSegmentDataKey(segmentPkg: string): string | undefined {
+  return SEGMENT_DATA_KEYS[segmentPkg]
+}
+
 export function getSegmentProps(
   segmentPkg: string,
   data: Record<string, unknown>
@@ -48,3 +54,93 @@ export function getSegmentProps(
   }
   return { [key]: value }
 }
+
+function mergeSegmentRecords(
+  base: Record<string, unknown>,
+  overlay: Record<string, unknown>
+): Record<string, unknown> {
+  const result = { ...base }
+  for (const [key, value] of Object.entries(overlay)) {
+    const existing = result[key]
+    if (
+      value &&
+      typeof value === "object" &&
+      !Array.isArray(value) &&
+      existing &&
+      typeof existing === "object" &&
+      !Array.isArray(existing)
+    ) {
+      result[key] = mergeSegmentRecords(
+        existing as Record<string, unknown>,
+        value as Record<string, unknown>
+      )
+    } else {
+      result[key] = value
+    }
+  }
+  return result
+}
+
+export function resolveSegmentProps(
+  segmentPkg: string,
+  workflowData: Record<string, unknown>,
+  inlineData?: Record<string, unknown> | null
+): Record<string, unknown> {
+  const base = getSegmentProps(segmentPkg, workflowData)
+
+  const layoutCart = workflowData.cart
+  if (
+    layoutCart &&
+    typeof layoutCart === "object" &&
+    (segmentPkg === "@pradip1995/segment-product-actions" ||
+      segmentPkg === "@pradip1995/segment-product-info") &&
+    !("cart" in base)
+  ) {
+    base.cart = layoutCart
+  }
+
+  if (!inlineData || Object.keys(inlineData).length === 0) return base
+  return mergeSegmentRecords(base, inlineData)
+}
+
+export type ChromeSegmentRef = string | { package: string; data?: Record<string, unknown> }
+
+function chromePackageName(ref: ChromeSegmentRef): string {
+  return typeof ref === "string" ? ref : ref.package
+}
+
+function chromeInlineData(ref: ChromeSegmentRef): Record<string, unknown> | undefined {
+  return typeof ref === "string" ? undefined : ref.data
+}
+
+/** Merge global chrome segment data (nav, footer, promo) into workflow output for layout. */
+export function applyChromeSegmentData(
+  workflowData: Record<string, unknown>,
+  chrome: ChromeSegmentRef[] | null | undefined
+): Record<string, unknown> {
+  if (!chrome?.length) return workflowData
+  const merged = { ...workflowData }
+
+  for (const ref of chrome) {
+    const pkg = chromePackageName(ref)
+    const data = chromeInlineData(ref)
+    const key = SEGMENT_DATA_KEYS[pkg]
+    if (!key || !data || Object.keys(data).length === 0) continue
+
+    const existing = merged[key]
+    if (existing && typeof existing === "object" && !Array.isArray(existing)) {
+      merged[key] = mergeSegmentRecords(existing as Record<string, unknown>, data)
+    } else {
+      merged[key] = { ...data }
+    }
+  }
+
+  return merged
+}
+
+export function applyBuilderDataToWorkflow(
+  workflowData: Record<string, unknown>,
+  builderData: BuilderSegmentDataFile | null | undefined
+): Record<string, unknown> {
+  return mergeBuilderSegmentData(workflowData, builderData)
+}