@ossy/platform 1.38.1 → 1.38.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ossy/platform",
-  "version": "1.38.1",
+  "version": "1.38.3",
   "description": "Ossy application server runtime",
   "repository": {
     "type": "git",
@@ -38,13 +38,13 @@
     "@aws-sdk/s3-request-presigner": "^3.1057.0",
     "@aws-sdk/util-create-request": "^3.972.26",
     "@aws-sdk/util-format-url": "^3.972.17",
-    "@ossy/event-store": "^1.7.1",
-    "@ossy/observability": "^1.7.1",
-    "@ossy/policies": "^1.12.1",
-    "@ossy/router": "^1.39.1",
-    "@ossy/sdk": "^1.39.1",
-    "@ossy/tokens": "^1.12.1",
-    "@ossy/users": "^1.12.1",
+    "@ossy/event-store": "^1.7.3",
+    "@ossy/observability": "^1.7.3",
+    "@ossy/policies": "^1.12.3",
+    "@ossy/router": "^1.39.3",
+    "@ossy/sdk": "^1.39.3",
+    "@ossy/tokens": "^1.12.3",
+    "@ossy/users": "^1.12.3",
     "cookie-parser": "^1.4.7",
     "dotenv": ">=16.0.0 <18.0.0",
     "express": ">=5.0.0 <6.0.0",
@@ -62,5 +62,5 @@
     "src",
     "Dockerfile"
   ],
-  "gitHead": "b9708c9c3f368bb642fc3bb76912a68107db24b9"
+  "gitHead": "501d2273560cb04d668afd32edf448019f3312aa"
 }

package/src/PlatformShell.jsx

@@ -0,0 +1,38 @@
+import React from 'react'
+import { ComponentSlotsProvider, Slot } from '@ossy/design-system'
+
+/**
+ * Platform shell — the outermost structural wrapper rendered on every request.
+ *
+ * Accepts a `slots` prop (plain object of slot-name → ComponentType) built
+ * at request time from the manifest's `slots` array. Wraps the entire tree
+ * with a `ComponentSlotsProvider` so that all five guaranteed slot regions
+ * are available to every descendant.
+ *
+ * The app's `*.layout.jsx` can nest a second `ComponentSlotsProvider` inside
+ * to override or fill these slots with layout-specific components — the inner
+ * provider shallow-merges on top.
+ *
+ * Slot regions rendered here:
+ *   header          — top bar across full width
+ *   sidebar         — left column, full height
+ *   toolbar         — below header, above content (contextual actions)
+ *   notifications   — floating / bottom corner (toasts, badges)
+ *   system-messages — banner above content (maintenance, errors)
+ *
+ * @param {{ slots?: Record<string, import('react').ComponentType | null>, children: import('react').ReactNode }} props
+ */
+export function PlatformShell({ slots = {}, children }) {
+  return (
+    <ComponentSlotsProvider slots={slots}>
+      <Slot name="system-messages" />
+      <Slot name="header" />
+      <Slot name="sidebar" />
+      <Slot name="toolbar" />
+      {children}
+      <Slot name="notifications" />
+    </ComponentSlotsProvider>
+  )
+}
+
+export default PlatformShell

package/src/server.js

@@ -57,6 +57,7 @@ export function loadManifest (buildDir) {
   const apis = entries.filter((e) => e.type === 'api' && validRoutable(e))
   const tasks = entries.filter((e) => e.type === 'task')
   const components = Array.isArray(manifest.components) ? manifest.components : []
+  const slots = Array.isArray(manifest.slots) ? manifest.slots : []
   const resourceTemplates = Array.isArray(manifest.resourceTemplates) ? manifest.resourceTemplates : []
   const aggregates = Array.isArray(manifest.aggregates) ? manifest.aggregates : []
   const integrations = Array.isArray(manifest.integrations) ? manifest.integrations : []
@@ -73,6 +74,7 @@ export function loadManifest (buildDir) {
     apis,
     tasks,
     components,
+    slots,
     resourceTemplates,
     aggregates,
     integrations,
@@ -192,6 +194,26 @@ export async function startServer (options = {}) {
     }
   }
 
+  // Slot loading — import each component that declares `export const slot` and
+  // build a map of slot-name → entry URL for the render pipeline. Components
+  // whose chunk fails to import are silently skipped so a broken slot never
+  // prevents the server from starting. The slot entries are appended to
+  // `componentEntries` at render time, keyed by slot name, so that the App's
+  // ComponentSlotsProvider makes them available to the entire React tree.
+  // Layout-level ComponentSlotsProviders can merge on top to override slots
+  // for their subtree (e.g. layout fills `header` with brand-specific chrome).
+  /** @type {Array<{ id: string, entry: string }>} */
+  const slotComponentEntries = []
+  for (const slotEntry of manifest.slots ?? []) {
+    try {
+      // Verify the chunk is importable at startup so we fail fast on bad builds.
+      await import(resolveEntryUrl(slotEntry.entry, buildDir))
+      slotComponentEntries.push({ id: slotEntry.slot, entry: slotEntry.entry })
+    } catch (err) {
+      log.warn(`Failed to load slot component "${slotEntry.slot}"`, undefined, err)
+    }
+  }
+
   function findLayoutForPage (pagePathOrPaths) {
     if (!layoutModuleMap.size) return null
     const paths = typeof pagePathOrPaths === 'string'
@@ -335,7 +357,9 @@ export async function startServer (options = {}) {
           isAuthenticated: !!req.isAuthenticated,
           pages: manifest.pages.map((page) => ({ id: page.id, path: page.path })),
           pageId: pageRoute.id,
-          componentEntries: manifest.components,
+          // Slot component entries are prepended so that layout-level
+          // ComponentSlotsProviders (which merge on top) can override them.
+          componentEntries: [...slotComponentEntries, ...manifest.components],
           Layout: Layout ?? null,
         }
         const html = await mod.render(props)