@pradip1995/framework-runtime 0.2.0

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@pradip1995/framework-runtime",
+  "version": "0.2.0",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "files": [
+    "src"
+  ],
+  "exports": {
+    ".": "./src/index.ts",
+    "./render-page": "./src/render-page.tsx"
+  },
+  "dependencies": {
+    "@pradip1995/framework-core": "0.2.0",
+    "@pradip1995/plugin-sdk": "0.2.0",
+    "@pradip1995/medusa-connector": "0.2.0"
+  },
+  "peerDependencies": {
+    "next": ">=15",
+    "react": ">=19"
+  },
+  "devDependencies": {
+    "@types/react": "^19",
+    "next": "15.3.8",
+    "react": "19.0.3",
+    "typescript": "^5.7.2"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "tsc --noEmit"
+  }
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export { renderPage, registerServices, resolveServices, getSegmentProps } from "./render-page"
+export { renderConfiguredPage } from "./render-configured-page"
+export type { RenderPageInput } from "./render-page"
+export type { ConfiguredPage, RenderConfiguredPageInput, SegmentEntry } from "./render-configured-page"

package/src/register-services.ts

@@ -0,0 +1,48 @@
+import { container } from "@pradip1995/framework-core"
+
+let registered = false
+
+export async function registerServices() {
+  if (registered) return
+  registered = true
+
+  const {
+    HomeModule,
+    LayoutModule,
+    ProductModule,
+    StoreModule,
+    CartModule,
+    CheckoutModule,
+    AccountModule,
+    OrderModule,
+    WishlistModule,
+    HelpModule,
+  } = await import("@pradip1995/medusa-connector")
+
+  container.register("homeModule", () => new HomeModule())
+  container.register("layoutModule", () => new LayoutModule())
+  container.register("productModule", () => new ProductModule())
+  container.register("storeModule", () => new StoreModule())
+  container.register("cartModule", () => new CartModule())
+  container.register("checkoutModule", () => new CheckoutModule())
+  container.register("accountModule", () => new AccountModule())
+  container.register("orderModule", () => new OrderModule())
+  container.register("wishlistModule", () => new WishlistModule())
+  container.register("helpModule", () => new HelpModule())
+}
+
+export async function resolveServices(): Promise<Record<string, unknown>> {
+  await registerServices()
+  return {
+    homeModule: container.resolve("homeModule"),
+    layoutModule: container.resolve("layoutModule"),
+    productModule: container.resolve("productModule"),
+    storeModule: container.resolve("storeModule"),
+    cartModule: container.resolve("cartModule"),
+    checkoutModule: container.resolve("checkoutModule"),
+    accountModule: container.resolve("accountModule"),
+    orderModule: container.resolve("orderModule"),
+    wishlistModule: container.resolve("wishlistModule"),
+    helpModule: container.resolve("helpModule"),
+  }
+}

package/src/render-configured-page.tsx

@@ -0,0 +1,77 @@
+import { buildRouteContext } from "@pradip1995/framework-core"
+import { resolveServices } from "./register-services"
+import { getSegmentProps } from "./segment-props"
+import type { ComponentType, ReactNode } from "react"
+
+export type SegmentEntry = {
+  pkg: string
+  Component: ComponentType<Record<string, unknown>>
+}
+
+export type ConfiguredPage = {
+  workflow: {
+    execute: (ctx: {
+      route: ReturnType<typeof buildRouteContext>
+      services: Record<string, unknown>
+    }) => Promise<Record<string, unknown>>
+  }
+  layout: ComponentType<{ data: Record<string, unknown>; children: ReactNode }>
+  segments: SegmentEntry[]
+}
+
+export type RenderConfiguredPageInput = {
+  page: ConfiguredPage
+  countryCode: string
+  slug: string[]
+  searchParams: Record<string, string | string[] | undefined>
+}
+
+function NotFoundPanel({ message }: { message: string }) {
+  return (
+    <section className="mx-auto max-w-lg px-4 py-20 text-center">
+      <h1 className="section-heading mb-3">Not found</h1>
+      <p className="text-muted text-sm">{message}</p>
+      <a href="/store" className="btn-primary inline-block mt-8">
+        Continue shopping
+      </a>
+    </section>
+  )
+}
+
+export async function renderConfiguredPage(input: RenderConfiguredPageInput): Promise<ReactNode> {
+  try {
+    const route = buildRouteContext(input.countryCode, input.slug, input.searchParams)
+    const services = await resolveServices()
+    const data = await input.page.workflow.execute({ route, services })
+    const Layout = input.page.layout
+
+    if (data.notFound) {
+      const message =
+        data.emptyCart === true
+          ? "Your cart is empty or checkout is unavailable."
+          : "The page you're looking for doesn't exist or is temporarily unavailable."
+
+      return (
+        <Layout data={data}>
+          <NotFoundPanel message={message} />
+        </Layout>
+      )
+    }
+
+    const segmentElements = input.page.segments.map(({ pkg, Component: Segment }) => {
+      const props = getSegmentProps(pkg, data)
+      return <Segment key={pkg} {...props} />
+    })
+
+    return <Layout data={data}>{segmentElements}</Layout>
+  } catch (error) {
+    console.error("[storefront] renderConfiguredPage error:", error)
+    const message = error instanceof Error ? error.message : "Unknown error"
+    return (
+      <main className="min-h-screen p-8 bg-page-bg">
+        <h1 className="text-xl font-semibold text-red-600 mb-2">Storefront error</h1>
+        <p className="text-sm text-body mb-4">{message}</p>
+      </main>
+    )
+  }
+}

package/src/render-page.tsx

@@ -0,0 +1,80 @@
+import { matchRoute, buildRouteContext } from "@pradip1995/framework-core"
+import { resolveServices } from "./register-services"
+import { getSegmentProps } from "./segment-props"
+import type { ComponentType, ReactNode } from "react"
+import type { PageConfigEntry } from "@pradip1995/plugin-sdk"
+
+type ImportMap = Record<string, () => Promise<{ default: unknown }>>
+
+export type RenderPageInput = {
+  countryCode: string
+  slug: string[]
+  searchParams: Record<string, string | string[] | undefined>
+  routeManifest: PageConfigEntry[]
+  importMap: ImportMap
+}
+
+async function resolvePlugin(importMap: ImportMap, pkg: string) {
+  const loader = importMap[pkg]
+  if (!loader) throw new Error(`Plugin not in import map: ${pkg}`)
+  return loader()
+}
+
+export async function renderPage(input: RenderPageInput): Promise<ReactNode> {
+  try {
+    const pathname = input.slug.length > 0 ? `/${input.slug.join("/")}` : "/"
+    const page = matchRoute(input.routeManifest, pathname)
+
+    if (!page) {
+      const { notFound } = await import("next/navigation")
+      notFound()
+    }
+
+    const route = buildRouteContext(input.countryCode, input.slug, input.searchParams)
+    const services = await resolveServices()
+
+    const workflowMod = (await resolvePlugin(input.importMap, page!.workflow)) as {
+      default: {
+        execute: (ctx: {
+          route: typeof route
+          services: Record<string, unknown>
+        }) => Promise<Record<string, unknown>>
+      }
+    }
+
+    const data = await workflowMod.default.execute({ route, services })
+
+    const layoutMod = (await resolvePlugin(input.importMap, page!.layout)) as {
+      default: ComponentType<{ data: Record<string, unknown>; children: ReactNode }>
+    }
+    const Layout = layoutMod.default
+
+    const segmentElements = await Promise.all(
+      page!.segments.map(async (segmentPkg) => {
+        const mod = (await resolvePlugin(input.importMap, segmentPkg)) as {
+          default: ComponentType<Record<string, unknown>>
+        }
+        const props = getSegmentProps(segmentPkg, data)
+        const Segment = mod.default
+        return <Segment key={segmentPkg} {...props} />
+      })
+    )
+
+    return <Layout data={data}>{segmentElements}</Layout>
+  } catch (error) {
+    console.error("[storefront] renderPage error:", error)
+    const message = error instanceof Error ? error.message : "Unknown error"
+    return (
+      <main className="min-h-screen p-8 bg-page-bg">
+        <h1 className="text-xl font-semibold text-red-600 mb-2">Storefront error</h1>
+        <p className="text-sm text-body mb-4">{message}</p>
+        <p className="text-xs text-muted">
+          Check MEDUSA_BACKEND_URL is reachable and NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY is set.
+        </p>
+      </main>
+    )
+  }
+}
+
+export { registerServices, resolveServices } from "./register-services"
+export { getSegmentProps } from "./segment-props"

package/src/segment-props.ts

@@ -0,0 +1,50 @@
+/** Maps segment package name → workflow output key(s) */
+const SEGMENT_DATA_KEYS: Record<string, string> = {
+  "@pradip1995/segment-hero": "hero",
+  "@pradip1995/segment-shop-by-age": "shopByAge",
+  "@pradip1995/segment-shop-by-category": "shopByCategory",
+  "@pradip1995/segment-why-choose-us": "whyChooseUs",
+  "@pradip1995/segment-new-arrivals": "newArrivals",
+  "@pradip1995/segment-loved-by-moms": "lovedByMoms",
+  "@pradip1995/segment-testimonials": "testimonials",
+  "@pradip1995/segment-features": "features",
+  "@pradip1995/segment-promotional-banners": "promotionalBanners",
+  "@pradip1995/segment-collections-showcase": "collectionsShowcase",
+  "@pradip1995/segment-bestsellers-carousel": "bestsellers",
+  "@pradip1995/segment-reviews-marquee": "testimonials",
+  "@pradip1995/segment-nav": "nav",
+  "@pradip1995/segment-footer": "footer",
+  "@pradip1995/segment-promo-bar": "promoBar",
+  "@pradip1995/segment-product-grid": "store",
+  "@pradip1995/segment-refinement-list": "store",
+  "@pradip1995/segment-mobile-filters": "store",
+  "@pradip1995/segment-product-gallery": "product",
+  "@pradip1995/segment-product-info": "product",
+  "@pradip1995/segment-product-actions": "product",
+  "@pradip1995/segment-related-products": "relatedProducts",
+  "@pradip1995/segment-cart-item": "cartPage",
+  "@pradip1995/segment-cart-summary": "cartPage",
+  "@pradip1995/segment-checkout-form": "checkout",
+  "@pradip1995/segment-checkout-summary": "checkout",
+  "@pradip1995/segment-login-template": "account",
+  "@pradip1995/segment-login": "account",
+  "@pradip1995/segment-register": "account",
+  "@pradip1995/segment-forgot-password": "account",
+  "@pradip1995/segment-google-login": "account",
+  "@pradip1995/segment-order-details": "orderPage",
+  "@pradip1995/segment-wishlist": "wishlistPage",
+  "@pradip1995/segment-help": "helpPage",
+}
+
+export function getSegmentProps(
+  segmentPkg: string,
+  data: Record<string, unknown>
+): Record<string, unknown> {
+  const key = SEGMENT_DATA_KEYS[segmentPkg]
+  if (!key) return data
+  const value = data[key]
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    return value as Record<string, unknown>
+  }
+  return { [key]: value }
+}