npm - yaml-flow - Versions diffs - 8.4.7 → 8.4.9 - Mend

yaml-flow 8.4.7 → 8.4.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (43) hide show

package/cli/{types-BkJvnXVD.d.ts → types-BbQ75HLf.d.ts} RENAMED Viewed

@@ -219,7 +219,7 @@ interface BoardNonCorePlatformAdapter extends BoardPlatformAdapter {
      * Each field can also be overridden per-source via source_def.timeout.
      *
      *   validationMs — validate-source-def, validate-card-preflight (structural, fast). Default: 10_000.
-     *   preflightMs  — probe-source-preflight (runs a real source fetch). Default: 60_000.
+    *   preflightMs  — source preflight executor hooks (probe-source-preflight / run-source-preflight). Default: 60_000.
      *   probeMs      — run-source-fetch in probe/simulation paths. Default: 60_000.
      *   describeMs   — describe-capabilities introspection. Default: 10_000.
      */
@@ -249,6 +249,8 @@ interface BoardLiveCardsNonCorePublic {
     probeTmpSource(input: CommandInput): CommandResult;
     /** body: { "card-content": <card>, "mock-projections"?: {} }; params: sourceIdx, outRef? — card JSON arrives via stdin; no board state needed */
     probeSourcePreflight(input: CommandInput): CommandResult;
+    /** body: { "card-content": <card>, "mock-projections"?: {} }; params: sourceIdx, outRef? — runs the real source fetch flow as a preflight */
+    runSourcePreflight(input: CommandInput): CommandResult;
     /** body: { "card-content": <card>, "mock-fetched-sources"?: {}, "mock-requires"?: {} } — evaluates compute expressions with supplied data; no board state needed */
     evalCardCompute(input: CommandInput): CommandResult<{
         cardId: string;

package/examples/board/demo-shell-with-server.html CHANGED Viewed

@@ -19,8 +19,8 @@
   <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/dompurify/dist/purify.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/leader-line/leader-line.min.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.4.7/browser/live-cards.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.4.7/browser/board-livecards-client.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.4.9/browser/live-cards.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.4.9/browser/board-livecards-client.js"></script>
 </head>
 <body class="bg-light">
   <div class="container-fluid py-3">

package/examples/board/doc.html CHANGED Viewed

@@ -37,8 +37,8 @@
   <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/dompurify/dist/purify.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/leader-line/leader-line.min.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.4.7/browser/live-cards.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.4.7/browser/board-livecards-client.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.4.9/browser/live-cards.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.4.9/browser/board-livecards-client.js"></script>
 </head>
 <body class="bg-light">
   <div class="container-fluid py-3">

package/examples/board/server/board-worker/source_def_flows.json CHANGED Viewed

@@ -7,7 +7,8 @@
     "describe-capabilities",
     "validate-source-def",
     "validate-card-preflight",
-    "probe-source-preflight"
+    "probe-source-preflight",
+    "run-source-preflight"
   ],
   "extraSchema": {
     "description": "Board topology context passed via --extra (base64-encoded JSON, baked at init).",

package/examples/board/server/board-worker/task-executor.js CHANGED Viewed

@@ -8,11 +8,13 @@
  *   describe-capabilities    — emit registry-derived kinds, schemas, and probe info as JSON
  *   validate-source-def      — validate one source_def against registry rules from stdin
  *   probe-source-preflight   — perform a lightweight preflight for one source_def from stdin
+ *   run-source-preflight     — execute one source_def through its real fetch flow from stdin
  *
  * Runtime invocation shapes used by board-live-cards:
  *   run-source-fetch --in-ref <b64ref> --out-ref <b64ref> [--err-ref <b64ref>] [--extra <base64json>]
  *   validate-source-def       <stdin: source JSON>
  *   probe-source-preflight    <stdin: source JSON> [--extra <base64json>]
+ *   run-source-preflight      <stdin: source JSON> [--extra <base64json>]
  *
  * Payload read from --in-ref (raw source definition or { source_def, callback } envelope):
  *   {
@@ -322,7 +324,7 @@ async function probeSourcePreflightSubcommand(argv) {
       ok: true,
       reachable: true,
       latencyMs: Date.now() - startedAt,
-      ...(mockProjectionWarning ? { error: mockProjectionWarning } : {}),
+      ...(mockProjectionWarning ? { note: mockProjectionWarning } : {}),
       ...(!mockProjectionWarning ? { resultValue: flowResult?.resultValue } : {}),
     }));
     return;
@@ -333,6 +335,86 @@ async function probeSourcePreflightSubcommand(argv) {
   }
 }
+function validateRunSourcePreflightProjections(sourceDef) {
+  const projections = sourceDef?._projections;
+  if (!projections || typeof projections !== 'object' || Array.isArray(projections)) {
+    throw new Error('Missing _projections object for run-source-preflight');
+  }
+  const declared = sourceDef?.projections;
+  if (!declared || typeof declared !== 'object' || Array.isArray(declared)) return;
+  for (const key of Object.keys(declared)) {
+    if (!Object.prototype.hasOwnProperty.call(projections, key)) {
+      throw new Error(`Required projection "${key}" is missing`);
+    }
+    if (projections[key] === undefined) {
+      throw new Error(`Projection "${key}" resolved to undefined`);
+    }
+  }
+}
+async function runSourcePreflightSubcommand(argv) {
+  const extraIdx = argv.indexOf('--extra');
+  const extraB64 = extraIdx !== -1 ? argv[extraIdx + 1] : undefined;
+  let extra = {};
+  if (extraB64) {
+    try { extra = JSON.parse(Buffer.from(extraB64, 'base64').toString('utf-8')); }
+    catch { /* ignore malformed extra */ }
+  }
+  const startedAt = Date.now();
+  let bindTo;
+  let kind;
+  try {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+      chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    const raw = Buffer.concat(chunks).toString('utf-8').trim();
+    if (!raw) {
+      console.log(JSON.stringify({ ok: false, reachable: false, latencyMs: Date.now() - startedAt, error: 'Missing run-source-preflight input JSON on stdin' }));
+      return;
+    }
+    let sourceDef;
+    try {
+      sourceDef = JSON.parse(raw);
+    } catch (err) {
+      console.log(JSON.stringify({ ok: false, reachable: false, latencyMs: Date.now() - startedAt, error: `Invalid run-source-preflight JSON: ${String(err && err.message || err)}` }));
+      return;
+    }
+    bindTo = typeof sourceDef?.bindTo === 'string' ? sourceDef.bindTo : undefined;
+    validateRunSourcePreflightProjections(sourceDef);
+    const resolved = await resolveAndExecuteSourceFlow(sourceDef, extra);
+    kind = resolved.kind;
+    console.log(JSON.stringify({
+      ok: true,
+      reachable: true,
+      latencyMs: Date.now() - startedAt,
+      ...(bindTo ? { bindTo } : {}),
+      ...(kind ? { kind } : {}),
+      resultValue: resolved.flowResult?.resultValue,
+      note: 'Actual fetch preflight passed',
+    }));
+    return;
+  } catch (err) {
+    const detail = (err && (err.stderr || err.stdout)) ? `\n${err.stderr || err.stdout}`.trimEnd() : '';
+    console.log(JSON.stringify({
+      ok: false,
+      reachable: false,
+      latencyMs: Date.now() - startedAt,
+      ...(bindTo ? { bindTo } : {}),
+      ...(kind ? { kind } : {}),
+      error: `${String(err && err.message || err)}${detail}`,
+    }));
+    return;
+  }
+}
 function getByPath(obj, dottedPath) {
   if (!dottedPath) return undefined;
   return String(dottedPath).split('.').reduce((acc, key) => {
@@ -439,7 +521,7 @@ function describeCapabilities() {
     executor: registry?.executor || EXECUTOR_NAME,
     subcommands: Array.isArray(registry?.subcommands)
       ? registry.subcommands
-      : ['run-source-fetch', 'probe-source-preflight', 'describe-capabilities', 'validate-source-def'],
+      : ['run-source-fetch', 'probe-source-preflight', 'run-source-preflight', 'describe-capabilities', 'validate-source-def'],
     sourceKinds,
     ...(registry?.extraSchema ? { extraSchema: registry.extraSchema } : {}),
   };
@@ -456,6 +538,10 @@ async function main() {
     await probeSourcePreflightSubcommand(process.argv.slice(3));
     return;
   }
+  if (sub === 'run-source-preflight') {
+    await runSourcePreflightSubcommand(process.argv.slice(3));
+    return;
+  }
   if (sub === 'describe' || sub === 'describe-capabilities') {
     describeCapabilities();
     return;

package/examples/board-local/demo-shell-localstorage.html CHANGED Viewed

@@ -6,13 +6,13 @@
   <title>Example Board Demo (LocalStorage Runtime)</title>
   <link rel="icon" type="image/svg+xml" href="../../browser/favicon.svg" />
   <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet" />
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.4.7/browser/compute-jsonata.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.4.9/browser/compute-jsonata.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/dompurify/dist/purify.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/leader-line/leader-line.min.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.4.7/browser/live-cards.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.4.7/browser/board-livecards-localstorage.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.4.9/browser/live-cards.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.4.9/browser/board-livecards-localstorage.js"></script>
 </head>
 <body class="bg-light">
   <div class="container-fluid py-3">

package/lib/{artifacts-store-lib-454TAuov.d.ts → artifacts-store-lib-CXgRA5J7.d.ts} RENAMED Viewed

@@ -38,8 +38,8 @@ interface CardFileMetadata {
     stored_name: string;
     size: number | null;
     mime_type: string | null;
-    path: string | null;
     uploaded_at: string | null;
+    chat: boolean;
 }
 type CardFileLookupResult = {
     ok: true;

package/lib/{artifacts-store-lib-zsGFbBV8.d.cts → artifacts-store-lib-WdoKNAF0.d.cts} RENAMED Viewed

@@ -38,8 +38,8 @@ interface CardFileMetadata {
     stored_name: string;
     size: number | null;
     mime_type: string | null;
-    path: string | null;
     uploaded_at: string | null;
+    chat: boolean;
 }
 type CardFileLookupResult = {
     ok: true;

package/lib/artifacts-store-public.d.cts CHANGED Viewed

@@ -1,5 +1,5 @@
-import { C as CommandInput, a as CommandResult } from './board-live-cards-public-CU8VVw3v.cjs';
-import { A as ArtifactInfo, a as ArtifactsStore } from './artifacts-store-lib-zsGFbBV8.cjs';
+import { C as CommandInput, a as CommandResult } from './board-live-cards-public-wbWRD1nO.cjs';
+import { A as ArtifactInfo, a as ArtifactsStore } from './artifacts-store-lib-WdoKNAF0.cjs';
 import './storage-interface-B-7pDHwD.cjs';
 import './execution-refs.cjs';
 import './types-BBhqYGhE.cjs';

package/lib/artifacts-store-public.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
-import { C as CommandInput, a as CommandResult } from './board-live-cards-public-Crjm8KWn.js';
-import { A as ArtifactInfo, a as ArtifactsStore } from './artifacts-store-lib-454TAuov.js';
+import { C as CommandInput, a as CommandResult } from './board-live-cards-public-C81ZEkF-.js';
+import { A as ArtifactInfo, a as ArtifactsStore } from './artifacts-store-lib-CXgRA5J7.js';
 import './storage-interface-B-7pDHwD.js';
 import './execution-refs.js';
 import './types-BBhqYGhE.js';