@oondemand/oon-core-back 0.7.14 → 0.7.17

package/README.md

@@ -57,6 +57,12 @@ O comando de delivery preserva `central.app.json` em dois pontos da imagem:
 
 Centrais legadas sem o manifesto continuam suportadas. O empacotador cria uma pasta intermediária vazia, evitando tornar `central.app.json` obrigatório para aplicações que ainda usam somente `central.config.js`.
 
+### `bin/delivery.js deploy` (legado)
+
+O subcomando `deploy` de `bin/delivery.js` é legado. Ele provisiona e aplica o runtime diretamente, mas não injeta capabilities no runtime. Não o use em publicações novas; os subcomandos `context` e `state` continuam disponíveis.
+
+Na falha de inicialização da imagem, o runtime registra as issues do manifesto, uma por linha, no formato ` - <path>: <mensagem>`, antes da linha `OON_STARTUP_FAILURE`. As mensagens passam pela mesma sanitização do CLI e o stack não é impresso.
+
 ## Rótulos de campos relacionados
 
 Por padrão, campos declarados com `fields.ref(...)` continuam sendo devolvidos pelo CRUD como `ObjectId`. Uma model pode optar pela população segura das referências usadas em grids e cards:

package/bin/cli.js

@@ -134,4 +134,11 @@ Códigos de saída: ${Object.entries(EXIT_CODES).map(([key, value]) => `${value}
   }
 }
 
-main().catch((err) => { console.error(sanitizeMessage(err?.message || err)); process.exit(1); });
+main().catch((err) => {
+  console.error(sanitizeMessage(err?.message || err));
+  // Manifest errors (e.g. AppManifestError) carry the actionable detail in issues.
+  if (Array.isArray(err?.issues)) {
+    for (const issue of err.issues) console.error(` - ${issue?.path || "$"}: ${sanitizeMessage(issue?.message)}`);
+  }
+  process.exit(1);
+});

package/bin/delivery.js

@@ -37,6 +37,7 @@ async function main() {
     });
     return;
   }
+  // Legado: "deploy" não injeta capabilities no runtime. Ver README.
   if (command === "deploy") {
     const contextFile = required(flag("--context"), "--context");
     const imageDigest = required(flag("--image-digest"), "--image-digest");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oondemand/oon-core-back",
-  "version": "0.7.14",
+  "version": "0.7.17",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/oondemand/oon-platform.git",

package/src/delivery/buildImage.js

@@ -32,6 +32,7 @@ COPY --from=frontend /src/frontend/dist /usr/share/nginx/html
 COPY .oon-delivery/nginx.conf /etc/nginx/oon.conf
 COPY .oon-delivery/supervisor.js /supervisor.js
 COPY .oon-delivery/launchRuntime.js .oon-delivery/validateImage.js /oon-delivery/
+COPY .oon-delivery/errors.js /deploy/contracts/errors.js
 COPY .oon-delivery/entrypoint.sh /entrypoint.sh
 RUN chmod +x /entrypoint.sh && mkdir -p /app/backend/uploads /run/nginx && chown -R node:node /app/backend/uploads
 EXPOSE 8080
@@ -111,6 +112,8 @@ function prepareDeliveryFiles(workspace) {
   fs.mkdirSync(target, { recursive: true });
   prepareAppManifest(workspace, target);
   for (const file of ["supervisor.js", "launchRuntime.js", "validateImage.js"]) fs.copyFileSync(path.join(__dirname, file), path.join(target, file));
+  // launchRuntime.js requires ../deploy/contracts/errors (sanitizeMessage).
+  fs.copyFileSync(path.join(__dirname, "../deploy/contracts/errors.js"), path.join(target, "errors.js"));
   fs.writeFileSync(path.join(target, "Dockerfile"), DOCKERFILE);
   fs.writeFileSync(path.join(target, "nginx.conf"), NGINX);
   fs.writeFileSync(path.join(target, "entrypoint.sh"), ENTRYPOINT, {

package/src/delivery/launchRuntime.js

@@ -1,13 +1,31 @@
 "use strict";
 const { createRequire } = require("node:module");
 const { classify } = require("./validateImage");
-const runtimeRequire = createRequire("/app/backend/package.json");
-// Invoke the public API of the SDK INSIDE the image; do not replace the app's
-// dependency version. Include the error class so SyntaxError is not lost by an
-// older CLI that prints only error.message. Never print the raw error/stack.
-Promise.resolve().then(() => runtimeRequire("@oondemand/oon-core-back").start({ cwd: "/app/backend" }))
-  .catch((error) => {
-    const diagnostic = classify(`${error?.name || "Error"}: ${error?.message || ""}`);
-    console.error(`OON_STARTUP_FAILURE ${JSON.stringify(diagnostic)}`);
-    process.exit(1);
-  });
+// Copied next to this file in the image (/deploy/contracts/errors.js) so the
+// same relative path resolves in the repository and inside the image.
+const { sanitizeMessage } = require("../deploy/contracts/errors");
+
+// Manifest errors (e.g. AppManifestError) carry the actionable detail in
+// issues. Print only path and sanitized message; never the stack or raw error.
+function startupIssueLines(error) {
+  if (!Array.isArray(error?.issues)) return [];
+  return error.issues.map((issue) => ` - ${sanitizeMessage(issue?.path || "$")}: ${sanitizeMessage(issue?.message)}`);
+}
+
+function launch() {
+  const runtimeRequire = createRequire("/app/backend/package.json");
+  // Invoke the public API of the SDK INSIDE the image; do not replace the app's
+  // dependency version. Include the error class so SyntaxError is not lost by an
+  // older CLI that prints only error.message. Never print the raw error/stack.
+  Promise.resolve().then(() => runtimeRequire("@oondemand/oon-core-back").start({ cwd: "/app/backend" }))
+    .catch((error) => {
+      for (const line of startupIssueLines(error)) console.error(line);
+      const diagnostic = classify(`${error?.name || "Error"}: ${error?.message || ""}`);
+      console.error(`OON_STARTUP_FAILURE ${JSON.stringify(diagnostic)}`);
+      process.exit(1);
+    });
+}
+
+if (require.main === module) launch();
+
+module.exports = { startupIssueLines };