sliccy 6.256.0 → 6.256.1

package/dist/node-server/cloud-status.d.ts

@@ -6,6 +6,14 @@ export declare const DEFAULT_JOIN_FILE_PATH = "/tmp/slicc-join.json";
  * leader on one host writes its own file; unset keeps the sandbox default.
  */
 export declare function resolveJoinFilePath(env?: NodeJS.ProcessEnv): string;
+/**
+ * Sibling of the join file for a leader that could not mint a tray (#4112).
+ * start-leader polls it so a failed boot reports the cause, not a timeout.
+ * A separate file keeps the join file's `joinUrl` contract untouched.
+ */
+export declare function joinErrorFilePath(joinFilePath: string): string;
+/** Leader-log prefix for a failed mint. Mirrored by start-leader's lib.mjs. */
+export declare const MINT_FAILURE_LOG_PREFIX = "[cloud-status] leader failed to mint a tray: ";
 export interface CloudStatusEndpointOptions {
     joinFilePath: string;
 }

package/dist/node-server/cloud-status.js

@@ -11,6 +11,18 @@ export function resolveJoinFilePath(env = process.env) {
     const configured = env.SLICC_JOIN_FILE?.trim();
     return configured || DEFAULT_JOIN_FILE_PATH;
 }
+/**
+ * Sibling of the join file for a leader that could not mint a tray (#4112).
+ * start-leader polls it so a failed boot reports the cause, not a timeout.
+ * A separate file keeps the join file's `joinUrl` contract untouched.
+ */
+export function joinErrorFilePath(joinFilePath) {
+    return `${joinFilePath}.error.json`;
+}
+/** Leader-log prefix for a failed mint. Mirrored by start-leader's lib.mjs. */
+export const MINT_FAILURE_LOG_PREFIX = '[cloud-status] leader failed to mint a tray: ';
+/** Longest error string persisted; the webapp's messages are far shorter. */
+const MAX_ERROR_LENGTH = 2000;
 /** The optional string fields validated when present but never required. */
 const OPTIONAL_STRING_FIELDS = [
     'trayId',
@@ -66,6 +78,32 @@ export function registerCloudStatusEndpoint(app, options) {
             updatedAt: new Date().toISOString(),
         };
         await fs.writeFile(options.joinFilePath, JSON.stringify(payload, null, 2));
+        await fs.rm(joinErrorFilePath(options.joinFilePath), { force: true });
+        res.json({ ok: true });
+    });
+    app.post('/api/cloud-status/error', requireLoopback, express.json(), async (req, res) => {
+        const body = req.body;
+        if (typeof body?.error !== 'string' || body.error.length === 0) {
+            res.status(400).json({ error: 'invalid cloud-status error payload' });
+            return;
+        }
+        const error = body.error.slice(0, MAX_ERROR_LENGTH);
+        // The leader log line names the cause even when the file write fails;
+        // start-leader reads it as a fallback (`MINT_FAILURE_LOG_PREFIX`).
+        console.error(`${MINT_FAILURE_LOG_PREFIX}${error.replace(/\s+/g, ' ')}`);
+        const payload = {
+            error,
+            sliccVersion: typeof body.sliccVersion === 'string' ? body.sliccVersion : null,
+            updatedAt: new Date().toISOString(),
+        };
+        try {
+            await fs.writeFile(joinErrorFilePath(options.joinFilePath), JSON.stringify(payload, null, 2));
+        }
+        catch (writeError) {
+            console.error('[cloud-status] could not write the join error file', String(writeError));
+            res.status(500).json({ error: 'could not record the leader failure' });
+            return;
+        }
         res.json({ ok: true });
     });
 }