@ossy/platform 1.38.7 → 1.39.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ossy/platform",
-  "version": "1.38.7",
+  "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.7",
-    "@ossy/observability": "^1.7.7",
-    "@ossy/policies": "^1.12.7",
-    "@ossy/router": "^1.39.7",
-    "@ossy/sdk": "^1.39.7",
-    "@ossy/tokens": "^1.12.7",
-    "@ossy/users": "^1.12.7",
+    "@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": "f65df0cd6da864c314c4f424112e05e8e2dec0ff"
+  "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/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,7 @@ 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'
@@ -49,7 +50,7 @@ function buildSiteContext (manifest, buildDir) {
     return promise
   }
 
-  return { pageRouter, apiRouter, manifest, manifestSummary: buildManifestSummary(manifest), loadEntry }
+  return { pageRouter, apiRouter, manifest, manifestSummary: buildManifestSummary(manifest), loadEntry, buildDir }
 }
 
 async function getSiteContext (domain) {
@@ -128,7 +129,7 @@ export async function startRuntime ({ port } = {}) {
       return
     }
 
-    const { pageRouter, apiRouter, manifest, manifestSummary, loadEntry } = context
+    const { pageRouter, apiRouter, manifest, manifestSummary, loadEntry, buildDir } = context
 
     try {
       const apiRoute = apiRouter.getPageByUrl(requestUrl)
@@ -167,6 +168,7 @@ export async function startRuntime ({ port } = {}) {
       }
 
       const config = manifest.config
+      const { language, messages, fallbackMessages } = resolveRequestLocale(pageRouter, requestUrl, buildDir, config)
       const props = {
         ...config,
         ...(req.userAppSettings || {}),
@@ -176,6 +178,9 @@ export async function startRuntime ({ port } = {}) {
         manifestSummary: cloneSerializable(manifestSummary),
         url: requestUrl,
         isAuthenticated: !!req.isAuthenticated,
+        language,
+        messages: cloneSerializable(messages),
+        ...(fallbackMessages ? { fallbackMessages: cloneSerializable(fallbackMessages) } : {}),
         pages: manifest.pages.map((page) => ({
           id: page.id,
           path: page.path,

package/src/server.js

@@ -19,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
@@ -82,6 +83,8 @@ export function loadManifest (buildDir) {
     emails,
     layouts,
     config: manifest.config || {},
+    definitions: manifest.definitions || {},
+    translations: manifest.translations || {},
   }
 }
 
@@ -322,6 +325,7 @@ 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,
@@ -332,6 +336,9 @@ export async function startServer (options = {}) {
           manifestSummary: cloneSerializable(manifestSummary),
           url: requestUrl,
           isAuthenticated: !!req.isAuthenticated,
+          language,
+          messages: cloneSerializable(messages),
+          ...(fallbackMessages ? { fallbackMessages: cloneSerializable(fallbackMessages) } : {}),
           pages: manifest.pages.map((page) => ({
             id: page.id,
             path: page.path,

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()
+})