@pradip1995/framework-runtime 0.2.1 → 0.2.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pradip1995/framework-runtime",
-  "version": "0.2.1",
+  "version": "0.2.4",
   "license": "MIT",
   "publishConfig": {
     "access": "public"

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,6 +1,7 @@
 import { 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"
 
 export type SegmentEntry = {
@@ -24,6 +25,8 @@ export type RenderConfiguredPageInput = {
   countryCode: string
   slug: string[]
   searchParams: Record<string, string | string[] | undefined>
+  /** CMS overrides from storefront/builder/segment-data.json */
+  builderSegmentData?: BuilderSegmentDataFile | null
 }
 
 function NotFoundPanel({ message }: { message: string }) {
@@ -42,7 +45,8 @@ 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 data = applyBuilderDataToWorkflow(workflowData, input.builderSegmentData)
     const Layout = input.page.layout
 
     if (data.notFound) {

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,8 @@ export type RenderPageInput = {
   searchParams: Record<string, string | string[] | undefined>
   routeManifest: PageConfigEntry[]
   importMap: ImportMap
+  /** CMS overrides from storefront/builder/segment-data.json */
+  builderSegmentData?: BuilderSegmentDataFile | null
 }
 
 async function resolvePlugin(importMap: ImportMap, pkg: string) {
@@ -42,7 +45,8 @@ 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 data = applyBuilderDataToWorkflow(workflowData, input.builderSegmentData)
 
     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,10 @@ export function getSegmentProps(
   }
   return { [key]: value }
 }
+
+export function applyBuilderDataToWorkflow(
+  workflowData: Record<string, unknown>,
+  builderData: BuilderSegmentDataFile | null | undefined
+): Record<string, unknown> {
+  return mergeBuilderSegmentData(workflowData, builderData)
+}