@lotics/app-sdk 0.122.2 → 0.122.4

package/dist/{chunk-I2BOTPL6.js → chunk-GXEBJ3RC.js}

@@ -173,6 +173,13 @@ function transportErrorMessage(status, parsed) {
   const authored = typeof parsed.code === "string" && parsed.code.length > 0;
   return status < 500 || authored ? jsonMessage : gatewayErrorMessage(status);
 }
+function telemetryErrorMessage(status, parsed) {
+  if (parsed === null || typeof parsed !== "object") return gatewayErrorMessage(status);
+  const code = "code" in parsed && typeof parsed.code === "string" && parsed.code.length > 0 ? parsed.code : null;
+  const system = "message_source" in parsed && parsed.message_source === "system";
+  if (system && "message" in parsed && typeof parsed.message === "string") return parsed.message;
+  return code ?? gatewayErrorMessage(status);
+}
 
 // ../shared/src/schemas/app_spec_rules.ts
 function tiersAscend(tiers) {
@@ -1521,11 +1528,13 @@ async function boot() {
   return attempt;
 }
 var ApiRefusal = class extends Error {
-  constructor(message, field_errors) {
-    super(message);
+  constructor(status, parsed, field_errors) {
+    super(transportErrorMessage(status, parsed));
     this.field_errors = field_errors;
+    this.telemetryMessage = telemetryErrorMessage(status, parsed);
   }
   field_errors;
+  telemetryMessage;
 };
 function readFieldErrors(parsed) {
   if (parsed === null || typeof parsed !== "object" || !("field_errors" in parsed)) {
@@ -1547,7 +1556,7 @@ async function streamStartError(res) {
     } catch {
     }
   }
-  return new Error(transportErrorMessage(res.status, parsed));
+  return new ApiRefusal(res.status, parsed);
 }
 var API_TIMEOUT_MS = 3e4;
 async function apiCall(method, path, body, opts) {
@@ -1597,7 +1606,7 @@ async function apiCall(method, path, body, opts) {
       return new Promise(() => {
       });
     }
-    throw new ApiRefusal(transportErrorMessage(res.status, parsed), readFieldErrors(parsed));
+    throw new ApiRefusal(res.status, parsed, readFieldErrors(parsed));
   }
   return parsed ?? (text ? text : {});
 }
@@ -1766,7 +1775,7 @@ async function sendAskedReads() {
         const answer = results[k];
         if (answer === void 0) read.reject(new Error(`The server answered ${results.length} of ${chunk.length} reads.`));
         else if ("result" in answer) read.resolve(answer.result);
-        else read.reject(new ApiRefusal(transportErrorMessage(answer.error.status, answer.error)));
+        else read.reject(new ApiRefusal(answer.error.status, answer.error));
       });
     }).catch((error) => chunk.forEach((read) => read.reject(error)));
   }
@@ -1779,7 +1788,14 @@ function batchResults(answered) {
     if (answer !== null && typeof answer === "object" && "result" in answer) return { result: answer.result };
     const error = answer !== null && typeof answer === "object" && "error" in answer ? answer.error : void 0;
     if (error !== null && typeof error === "object" && "status" in error && typeof error.status === "number" && "message" in error && typeof error.message === "string") {
-      return { error: { status: error.status, message: error.message, code: "code" in error ? error.code : void 0 } };
+      return {
+        error: {
+          status: error.status,
+          message: error.message,
+          code: "code" in error ? error.code : void 0,
+          message_source: "message_source" in error ? error.message_source : void 0
+        }
+      };
     }
     throw new Error(`The server's batch answer ${at} is neither a result nor a refusal.`);
   });

package/dist/index.js

@@ -40,7 +40,7 @@ import {
   sumDecimal,
   tiersAscend,
   urlParam
-} from "./chunk-I2BOTPL6.js";
+} from "./chunk-GXEBJ3RC.js";
 
 // src/mount.tsx
 import { createRoot } from "react-dom/client";
@@ -94,6 +94,14 @@ function getMockRecordings() {
 // ../shared/src/app_host/app_spec_inline.ts
 var APP_SPEC_ELEMENT_ID = "lotics-app-spec";
 
+// ../shared/src/customer_worded.ts
+function isCustomerWorded(error51) {
+  return "telemetryMessage" in error51 && typeof error51.telemetryMessage === "string";
+}
+function telemetryMessage(error51) {
+  return isCustomerWorded(error51) ? error51.telemetryMessage : error51.message;
+}
+
 // src/error_report.ts
 var REPORTS_PER_PAGE = 5;
 var MESSAGE_LIMIT = 300;
@@ -107,7 +115,8 @@ function reportAppError(kind, error51) {
     kind,
     served: document.getElementById(APP_SPEC_ELEMENT_ID) === null ? "bundle" : "spec",
     name: known ? error51.name : typeof error51,
-    message: withoutOrigins(known ? error51.message : String(error51)).slice(0, MESSAGE_LIMIT),
+    // A refusal's own sentence can be a customer's (a table check's); the report says it in ours.
+    message: withoutOrigins(known ? telemetryMessage(error51) : String(error51)).slice(0, MESSAGE_LIMIT),
     stack_top: known && error51.stack !== void 0 ? firstFrame(error51, error51.stack) : null
   });
 }

package/dist/router.js

@@ -2,7 +2,7 @@ import {
   isEmbedded,
   postHostNotification,
   setUrlParams
-} from "./chunk-I2BOTPL6.js";
+} from "./chunk-GXEBJ3RC.js";
 
 // src/router.tsx
 import { useEffect } from "react";

package/docs/ai.md

@@ -358,7 +358,7 @@ workflows (run_app_workflow):
 `?` marks an input the caller may omit, `[]` one that takes a list, a
 `select` spells out every legal value as `label=value` — **the agent sends the
 value** — and a `record_link` names the table an id must come from. Both tools
-take an opaque inputs object, so this listing is the only place any of it is
+take an opaque object (a query's `params`, a workflow's `inputs`), so this listing is the only place any of it is
 legible.
 
 The app's own `description` heads that listing as `about:`, on both surfaces. It

package/docs/data_fetching.md

@@ -369,7 +369,7 @@ Wire shapes per output column type:
 | Column type | Cell value on the wire |
 |---|---|
 | `text` | `string` |
-| `number` | `number` (numeric database strings are normalized server-side; a rare decimal too precise for float64 stays a string — `row.num` parses both) |
+| `number` | `number` (numeric database strings are normalized server-side; a decimal with more digits than a double holds rounds to the double) |
 | `boolean` | `boolean` |
 | `date` | `"YYYY-MM-DD"` — a calendar day, no time component (a reduced-precision date field may also carry `"YYYY-MM"` or `"YYYY"`; see below) |
 | `datetime` | `"YYYY-MM-DDTHH:mm"` — workspace wall-clock, minute precision |

package/docs/members_and_options.md

@@ -424,7 +424,7 @@ const { reverted, kept } = await undoRecordChange("job", recordId, entry.id);
   the call arrives, on a row their own row rule covers, and the record's lock, the table's checks
   and its write rules answer as for any save of theirs. `undoable` is `false`, and the call
   refused, for the entry that made the record, an entry that is an undo, one already put back, and
-  a viewer who may not write the record.
+  a viewer who may not write the record; a record in the trash is refused until it is restored.
   The undo is an entry of its own; the answer arrives once the record's reads are read anew.
 - **Pages**: newest first, about thirty entries each; `next` is where the trail goes on —
   `undefined` at its end. A page may hold fewer entries and still say `next` where the trail it read

package/package.json

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