@ossy/platform 1.38.6 → 1.39.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ossy/platform",
-  "version": "1.38.6",
+  "version": "1.39.0",
   "description": "Ossy application server runtime",
   "repository": {
     "type": "git",
@@ -22,8 +22,10 @@
     "./definition": "./src/Definition.js",
     "./integrations": "./src/integration.service.js",
     "./test": "./src/test/index.js",
+    "./test/jest.setup.js": "./src/test/jest.setup.js",
     "./test/e2e-runner.js": "./src/test/e2e-runner.js",
-    "./test/playwright.config.js": "./src/test/playwright.config.js"
+    "./test/playwright.config.js": "./src/test/playwright.config.js",
+    "./locale": "./src/locale.js"
   },
   "scripts": {
     "start": "PORT=3003 node -e \"import('./src/server.js').then(m => m.startServer())\"",
@@ -38,13 +40,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.6",
-    "@ossy/observability": "^1.7.6",
-    "@ossy/policies": "^1.12.6",
-    "@ossy/router": "^1.39.6",
-    "@ossy/sdk": "^1.39.6",
-    "@ossy/tokens": "^1.12.6",
-    "@ossy/users": "^1.12.6",
+    "@ossy/event-store": "^1.8.0",
+    "@ossy/locale": "^1.40.0",
+    "@ossy/observability": "^1.8.0",
+    "@ossy/policies": "^1.13.0",
+    "@ossy/sdk": "^1.40.0",
+    "@ossy/tokens": "^1.13.0",
+    "@ossy/users": "^1.13.0",
     "cookie-parser": "^1.4.7",
     "dotenv": ">=16.0.0 <18.0.0",
     "express": ">=5.0.0 <6.0.0",
@@ -62,5 +64,5 @@
     "src",
     "Dockerfile"
   ],
-  "gitHead": "72d150cf20ff7ba25b328bc5b429b065c2840b2b"
+  "gitHead": "d9d31182be64a448d575da432af2830d909ad4b9"
 }

package/src/Definition.js

@@ -2,12 +2,6 @@ export const Definition = {
   id: 'platform',
   title: 'Platform',
   description: 'Deployment platform configuration aligned with deployment-tools S3 platform-config.json.',
-  module: {
-    id: 'platform',
-    enabled: true
-  },
+  icon: 'controller',
   statuses: ['beta'],
-  actions: ['resources.create', 'resources.update-content', 'resources.rename', 'resources.remove'],
-  views: ['home.page', 'resources.search', 'resources.get'],
-  tasks: []
 }

package/src/PlatformShell.jsx

@@ -13,24 +13,24 @@ import { ComponentSlotsProvider, Slot } from '@ossy/design-system'
  * 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)
+ * Slot regions rendered here (namespaced keys from app `export const slots`):
+ *   shell:header           — top bar across full width
+ *   shell:sidebar          — left column, full height
+ *   shell:toolbar          — below header, above content (contextual actions)
+ *   shell:notifications    — floating / bottom corner (toasts, badges)
+ *   shell: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" />
+      <Slot name="shell:system-messages" />
+      <Slot name="shell:header" />
+      <Slot name="shell:sidebar" />
+      <Slot name="shell:toolbar" />
       {children}
-      <Slot name="notifications" />
+      <Slot name="shell:notifications" />
     </ComponentSlotsProvider>
   )
 }

package/src/locale.js

@@ -0,0 +1,90 @@
+import fs from 'node:fs'
+import path from 'node:path'
+
+import { createTranslator } from '@ossy/locale'
+
+/**
+ * @param {string} buildDir
+ * @param {string} language
+ * @returns {Record<string, string>}
+ */
+export function loadMessagesForLanguage (buildDir, language) {
+  const filePath = path.join(buildDir, 'public', `${language}.translations.json`)
+  if (!fs.existsSync(filePath)) return {}
+  try {
+    const raw = fs.readFileSync(filePath, 'utf8')
+    const parsed = JSON.parse(raw)
+    return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {}
+  } catch {
+    return {}
+  }
+}
+
+/**
+ * @param {string} buildDir
+ * @param {string} language
+ * @param {{ defaultLanguage?: string }} [config]
+ * @returns {Record<string, string> | undefined}
+ */
+export function loadFallbackMessagesForLanguage (buildDir, language, config = {}) {
+  const defaultLanguage = config.defaultLanguage || 'en'
+  if (language === defaultLanguage) return undefined
+  return loadMessagesForLanguage(buildDir, defaultLanguage)
+}
+
+/**
+ * @param {{ getParamsFromUrl: (url: string) => Record<string, string> }} pageRouter
+ * @param {string} requestUrl
+ * @param {{ defaultLanguage?: string }} config
+ * @returns {string}
+ */
+export function resolveRequestLanguage (pageRouter, requestUrl, config) {
+  const params = pageRouter.getParamsFromUrl(requestUrl)
+  return params.language || config.defaultLanguage || 'en'
+}
+
+/**
+ * @param {{ getParamsFromUrl: (url: string) => Record<string, string> }} pageRouter
+ * @param {string} requestUrl
+ * @param {string} buildDir
+ * @param {{ defaultLanguage?: string }} config
+ * @returns {{ language: string, messages: Record<string, string>, fallbackMessages?: Record<string, string> }}
+ */
+export function resolveRequestLocale (pageRouter, requestUrl, buildDir, config) {
+  const language = resolveRequestLanguage(pageRouter, requestUrl, config)
+  const messages = loadMessagesForLanguage(buildDir, language)
+  const fallbackMessages = loadFallbackMessagesForLanguage(buildDir, language, config)
+  return {
+    language,
+    messages,
+    ...(fallbackMessages ? { fallbackMessages } : {}),
+  }
+}
+
+/**
+ * Server-side `t()` for actions, tasks, and email — reads merged catalogs from build output.
+ *
+ * @param {string} buildDir Absolute path to app `build/`
+ * @param {string} [language] Active locale
+ * @param {{ defaultLanguage?: string, warnOnMissingKey?: boolean }} [config]
+ * @returns {(key: string, params?: Record<string, string | number>) => string}
+ */
+export function createTranslatorForBuild (buildDir, language, config = {}) {
+  const defaultLanguage = config.defaultLanguage || 'en'
+  const activeLanguage = language || defaultLanguage
+  const messages = loadMessagesForLanguage(buildDir, activeLanguage)
+  const fallbackCatalog = activeLanguage !== defaultLanguage
+    ? loadMessagesForLanguage(buildDir, defaultLanguage)
+    : undefined
+
+  const warnOnMissingKey = config.warnOnMissingKey ?? process.env.NODE_ENV !== 'production'
+  const onMissingKey = warnOnMissingKey
+    ? (key) => {
+        if (typeof console !== 'undefined' && typeof console.warn === 'function') {
+          console.warn(`[@ossy/locale] Missing translation key: ${key}`)
+        }
+      }
+    : undefined
+
+  return createTranslator(messages, { fallbackCatalog, onMissingKey })
+}

package/src/runtime.js

@@ -5,6 +5,8 @@ import cookieParser from 'cookie-parser'
 import morgan from 'morgan'
 import { Router as OssyRouter } from '@ossy/router'
 import { loadManifest, resolveEntryUrl } from './server.js'
+import { resolveRequestLocale } from './locale.js'
+import { buildManifestSummary } from '@ossy/app/manifest/build-manifest-summary'
 import { ProxyInternal } from './proxy-internal.js'
 import { loadSite, invalidateSite } from './site-loader.js'
 import { createLogger } from '@ossy/observability'
@@ -48,7 +50,7 @@ function buildSiteContext (manifest, buildDir) {
     return promise
   }
 
-  return { pageRouter, apiRouter, manifest, loadEntry }
+  return { pageRouter, apiRouter, manifest, manifestSummary: buildManifestSummary(manifest), loadEntry, buildDir }
 }
 
 async function getSiteContext (domain) {
@@ -127,7 +129,7 @@ export async function startRuntime ({ port } = {}) {
       return
     }
 
-    const { pageRouter, apiRouter, manifest, loadEntry } = context
+    const { pageRouter, apiRouter, manifest, manifestSummary, loadEntry, buildDir } = context
 
     try {
       const apiRoute = apiRouter.getPageByUrl(requestUrl)
@@ -166,15 +168,24 @@ export async function startRuntime ({ port } = {}) {
       }
 
       const config = manifest.config
+      const { language, messages, fallbackMessages } = resolveRequestLocale(pageRouter, requestUrl, buildDir, config)
       const props = {
         ...config,
         ...(req.userAppSettings || {}),
         theme: req.userAppSettings?.theme || cloneSerializable(config?.theme),
         themes: cloneSerializable(config?.themes),
         resourceTemplates: cloneSerializable(manifest.resourceTemplates),
+        manifestSummary: cloneSerializable(manifestSummary),
         url: requestUrl,
         isAuthenticated: !!req.isAuthenticated,
-        pages: manifest.pages.map((page) => ({ id: page.id, path: page.path })),
+        language,
+        messages: cloneSerializable(messages),
+        ...(fallbackMessages ? { fallbackMessages: cloneSerializable(fallbackMessages) } : {}),
+        pages: manifest.pages.map((page) => ({
+          id: page.id,
+          path: page.path,
+          ...(page.package ? { package: page.package } : {}),
+        })),
         pageId: pageRoute.id,
       }
       const html = await mod.render(props)

package/src/server.js

@@ -10,6 +10,8 @@ import { SDK } from '@ossy/sdk'
 import { AggregateRebuild } from '@ossy/event-store'
 import { TaskService } from './tasks/task-service.js'
 import { ChangeStream } from './tasks/change-stream.js'
+import { CONTENT_SLOT_NAME } from '@ossy/app/runtime/resolve-shell-slots'
+import { buildManifestSummary } from '@ossy/app/manifest/build-manifest-summary'
 import { registerResourceTemplate } from './resources/resource-template.registry.js'
 import { IntegrationService } from './integration.service.js'
 import { ActionService } from './actions/action.service.js'
@@ -17,6 +19,7 @@ import { createLogger } from '@ossy/observability'
 import { ConfigService } from './config.service.js'
 import { UsersMiddleware } from './users.middleware.js'
 import { WorkspacesMiddleware } from './workspaces.middleware.js'
+import { resolveRequestLocale } from './locale.js'
 const log = createLogger('@ossy/platform')
 
 const DEFAULT_PORT = 3000
@@ -55,12 +58,12 @@ 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 : []
   const startups = Array.isArray(manifest.startups) ? manifest.startups : []
   const actions = Array.isArray(manifest.actions) ? manifest.actions : []
+  const emails = Array.isArray(manifest.emails) ? manifest.emails : []
   const layouts = Array.isArray(manifest.layouts) ? manifest.layouts : []
   for (const e of entries) {    if ((e.type === 'page' || e.type === 'api') && !validRoutable(e)) {
       log.warn(`Skipping ${e.type} "${e.id}" — manifest entry has no path.`)
@@ -72,14 +75,16 @@ export function loadManifest (buildDir) {
     apis,
     tasks,
     components,
-    slots,
     resourceTemplates,
     aggregates,
     integrations,
     startups,
     actions,
+    emails,
     layouts,
     config: manifest.config || {},
+    definitions: manifest.definitions || {},
+    translations: manifest.translations || {},
   }
 }
 
@@ -108,6 +113,7 @@ export async function startServer (options = {}) {
   }
 
   const manifest = loadManifest(buildDir)
+  const manifestSummary = buildManifestSummary(manifest)
   const config = manifest.config
   const supportedLanguages = Array.isArray(config.supportedLanguages) ? config.supportedLanguages : []
   const defaultLanguage = config.defaultLanguage
@@ -201,25 +207,12 @@ 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)
-    }
-  }
+  // App-controlled shell slots: `export const slots` in `*.layout.jsx` is recorded
+  // on `manifest.layouts[0].slots` at build time and resolved at render in page-runtime.
+  const layoutSlots =
+    layoutEntry && typeof layoutEntry.slots === 'object' && !Array.isArray(layoutEntry.slots)
+      ? layoutEntry.slots
+      : {}
 
   // Register the SDK so all tasks receive it as `sdk`.
   // Priority: explicit options.sdk → SDK.of() from env vars → null (direct-DB fallback in tasks).
@@ -332,19 +325,29 @@ export async function startServer (options = {}) {
         }
         const Layout = appLayout?.component ?? null
         const layoutEntry = appLayout?.entry ?? null
+        const { language, messages, fallbackMessages } = resolveRequestLocale(pageRouter, requestUrl, buildDir, config)
+        // Page component → `shell:content` is resolved in page-runtime (SSR + hydrate).
         const props = {
           ...config,
           ...(req.userAppSettings || {}),
           theme: req.userAppSettings?.theme || cloneSerializable(config?.theme),
           themes: cloneSerializable(config?.themes),
           resourceTemplates: cloneSerializable(manifest.resourceTemplates),
+          manifestSummary: cloneSerializable(manifestSummary),
           url: requestUrl,
           isAuthenticated: !!req.isAuthenticated,
-          pages: manifest.pages.map((page) => ({ id: page.id, path: page.path })),
+          language,
+          messages: cloneSerializable(messages),
+          ...(fallbackMessages ? { fallbackMessages: cloneSerializable(fallbackMessages) } : {}),
+          pages: manifest.pages.map((page) => ({
+            id: page.id,
+            path: page.path,
+            ...(page.package ? { package: page.package } : {}),
+          })),
           pageId: pageRoute.id,
-          // Slot component entries are prepended so that layout-level
-          // ComponentSlotsProviders (which merge on top) can override them.
-          componentEntries: [...slotComponentEntries, ...manifest.components],
+          componentEntries: manifest.components,
+          layoutSlots,
+          contentSlotName: CONTENT_SLOT_NAME,
           Layout,
           layoutEntry,
         }

package/src/test/jest.setup.js

@@ -1,3 +1,5 @@
+import { TestUtil } from './test.util.js'
+
 /**
  * Integration tests run in Node on the host. Mongo in Docker is often a single-node replica set
  * whose persisted config advertises a hostname that only resolves inside Docker (e.g.
@@ -22,3 +24,7 @@ function jestMongoUrl() {
 }
 
 process.env.DB_URL = jestMongoUrl()
+
+afterAll(async () => {
+  await TestUtil.CloseDbConnection()
+})