@lotics/app-sdk 0.101.0 → 0.101.1

package/dist/index.js

@@ -27408,14 +27408,22 @@ var appWriteModelSchema = zod_default.object({
   tables: zod_default.array(zod_default.object({ id: zod_default.string(), name: zod_default.string(), fields: tableFieldsSchema })).describe("The tables the plans and queries touch, with only the fields they name.")
 });
 var PREDICTION_MISSES_MAX = 50;
-var predictionMissSchema = zod_default.object({
-  workflow: zod_default.string().max(200).describe("The alias of the workflow whose run was predicted."),
-  table_id: zod_default.string().max(64),
-  field_key: zod_default.string().max(64).nullable().describe("The field that missed; null for a whole row."),
-  column: zod_default.enum(["own", "via", "row"]).describe("A field of the row itself, one read through its link, or the row."),
-  kind: zod_default.enum(["cell", "not_removed"]).describe("A predicted value the stored one differs from, or a row predicted gone that the server still holds."),
-  count: zod_default.number().int().min(1).max(1e3)
-});
+var predictionMissSchema = zod_default.union([
+  zod_default.object({
+    kind: zod_default.enum(["cell", "not_removed"]).describe("A predicted value the stored one differs from, or a row predicted gone that the server still holds."),
+    workflow: zod_default.string().max(200).describe("The alias of the workflow whose run was predicted."),
+    table_id: zod_default.string().max(64),
+    field_key: zod_default.string().max(64).nullable().describe("The field that missed; null for a whole row."),
+    column: zod_default.enum(["own", "via", "row"]).describe("A field of the row itself, one read through its link, or the row."),
+    count: zod_default.number().int().min(1).max(1e3)
+  }).strict(),
+  zod_default.object({
+    kind: zod_default.enum(["model_unavailable", "predict_error"]).describe("The app's write model could not be read, or predicting a run threw: its writes wait for the server."),
+    workflow: zod_default.string().max(200).nullable().describe("The workflow whose run was not predicted; null for the model."),
+    error: zod_default.string().regex(/^[A-Za-z_$][\w$]{0,63}$/).describe("The error's class name alone (`TypeError`, `WorkflowEvalError`)."),
+    count: zod_default.number().int().min(1).max(1e3)
+  }).strict()
+]);
 var predictionMissesBodySchema = zod_default.object({ misses: zod_default.array(predictionMissSchema).min(1).max(PREDICTION_MISSES_MAX) });
 
 // src/new_record.ts
@@ -27526,6 +27534,7 @@ function loadModel() {
   attempt2.catch((cause) => {
     console.error("The app's write model could not be read; writes show once the server answers", cause);
     if (modelPromise === attempt2) failedAtMs = Date.now();
+    reportMisses([{ kind: "model_unavailable", workflow: null, error: errorName(cause), count: 1 }]);
   });
   modelPromise = attempt2;
 }
@@ -27687,7 +27696,7 @@ async function stageWrite(workflow, inputs) {
     });
   } catch (cause) {
     if (cause instanceof UnknownValue) return null;
-    console.error(`The write "${workflow}" could not be predicted; it shows once the server answers`, cause);
+    unpredicted(workflow, cause);
     return null;
   }
   if (prediction.outcome === "refused") return null;
@@ -27788,8 +27797,21 @@ function judgePredictions(shape, rows, askedAt) {
   }
   if (checked.size > 0) entries2 = entries2.map((entry) => checked.has(entry.token) ? { ...entry, checked: /* @__PURE__ */ new Set([...entry.checked, ...checked.get(entry.token) ?? []]) } : entry);
   if (counts.size === 0) return;
-  const misses = [...counts.values()].slice(0, PREDICTION_MISSES_MAX);
-  rpc("prediction_miss", { misses }).catch((cause) => console.warn("A drawn write the server stored differently could not be reported", cause));
+  reportMisses([...counts.values()]);
+}
+function errorName(cause) {
+  const name = cause instanceof Error ? cause.name : "";
+  return /^[A-Za-z_$][\w$]{0,63}$/.test(name) ? name : "Error";
+}
+function unpredicted(workflow, cause) {
+  console.error(`The write "${workflow}" could not be predicted; it shows once the server answers`, cause);
+  reportMisses([{ kind: "predict_error", workflow, error: errorName(cause), count: 1 }]);
+}
+function reportMisses(misses) {
+  if (misses.length === 0 || hasMockFlag()) return;
+  rpc("prediction_miss", { misses: misses.slice(0, PREDICTION_MISSES_MAX) }).catch(
+    (cause) => console.warn("Where the app's writes were drawn wrong or not at all could not be reported", cause)
+  );
 }
 function readsAfter(workflow, token2) {
   const described = loaded?.model.workflows[workflow];
@@ -27893,7 +27915,7 @@ async function runStaged(alias, inputs) {
   }
   const given = inputs ?? {};
   const staged = await stageWrite(alias, given).catch((cause) => {
-    console.error(`The write "${alias}" could not be shown before the server answers`, cause);
+    unpredicted(alias, cause);
     return null;
   });
   const token2 = staged?.token ?? null;

package/dist/written.d.ts

@@ -44,6 +44,8 @@ export declare function writesRecords(workflow: string): boolean;
  * different times, when its oldest was (`since`).
  */
 export declare function noteAnswer(key: string, alias: string, askedAt: number, rows: readonly Row[], since?: number): void;
+/** A run whose writes wait for the server because predicting it threw: said in the console, reported by class. */
+export declare function unpredicted(workflow: string, cause: unknown): void;
 /**
  * The queries a successful run of `workflow` re-reads: those over a table its body names. Undefined — every
  * mounted query — until the model is read, or where a write names a table only at run time.

package/docs/mutations.md

@@ -539,7 +539,8 @@ every read before the request answers:
   asked after the write settled answers — the stored value then replaces the prediction, whatever
   it said, so a server that rounds or trims wins with no flicker back to the old value. Where the
   stored value differs from the one drawn, the SDK tells the server where — the workflow, table,
-  field and kind of miss, never the value.
+  field and kind of miss, never the value. A write model that cannot be read and a prediction that
+  throws are reported too, by the error's class name alone.
 
 What the steps cannot tell before they run is never guessed:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/app-sdk",
-  "version": "0.101.0",
+  "version": "0.101.1",
   "description": "The SDK a Lotics custom-code app reads and writes through \u2014 typed hooks over the host bridge, cell readers, mount() and AppRouter",
   "type": "module",
   "exports": {