@lotics/app-sdk 0.123.6 → 0.123.8

package/dist/index.js

@@ -802,6 +802,7 @@ var MAX_STRING_LENGTH = 1e7;
 var MAX_RANDOM_LENGTH = 1e3;
 var MAX_RUN_BUILT_BYTES = 512 * 1024 * 1024;
 var MAX_IN_PLACE_BYTES = 1024 * 1024;
+var MAX_IN_PLACE_HELPER_BYTES = 8 * 1024;
 var MAX_PERSISTED_JSON_LENGTH = 64 * 1024 * 1024;
 var ExpressionLimitError = class extends Error {
   constructor(message2) {
@@ -7385,7 +7386,7 @@ var WorkflowExpressionBudgetError = class extends Error {
 };
 var ExpressionNotCheapError = class extends Error {
   constructor() {
-    super(`The expression walks or builds more than ${MAX_IN_PLACE_BYTES / 1024 / 1024}MB at once, past what an evaluation in place may.`);
+    super(`The expression walks or builds more than ${MAX_IN_PLACE_BYTES / 1024 / 1024}MB at once, or hands a helper more than ${MAX_IN_PLACE_HELPER_BYTES / 1024}KB, past what an evaluation in place may.`);
     this.name = "ExpressionNotCheapError";
   }
 };
@@ -7510,11 +7511,14 @@ function parsedSize(text2) {
   return text2.length * CHAR_BYTES + nodes * PARSED_NODE_BYTES;
 }
 function assertCheap(budget, ...values2) {
+  assertWithin(budget, MAX_IN_PLACE_BYTES, values2);
+}
+function assertWithin(budget, limit, values2) {
   if (!budget.bounded) return;
   let bytes = 0;
   for (const value of values2) {
-    bytes += writtenSize(value, MAX_IN_PLACE_BYTES - bytes);
-    if (bytes > MAX_IN_PLACE_BYTES) throw new ExpressionNotCheapError();
+    bytes += writtenSize(value, limit - bytes);
+    if (bytes > limit) throw new ExpressionNotCheapError();
   }
 }
 function charge(ctx, bytes) {
@@ -8116,6 +8120,7 @@ async function callAfter(helper, pending, ctx) {
   return callHelper(helper, values2, ctx);
 }
 function callHelper({ call, cost }, values2, ctx) {
+  assertWithin(ctx.evaluation_budget, MAX_IN_PLACE_HELPER_BYTES, values2);
   if (cost === "parses") charge(ctx, parsedSize(values2[0]));
   const answer = Reflect.apply(call, void 0, values2);
   return answer instanceof Promise ? chargeAnswerAfter(cost, answer, values2, ctx) : chargeAnswer(cost, answer, values2, ctx);
@@ -11365,27 +11370,28 @@ function evaluateCondition(record, fieldByKey, looseCondition, memberContext, fi
   const columnValue = data[fieldKey];
   const field = fieldByKey[fieldKey];
   const resolvedType = field ? resolveFilterType(field) : looseCondition.type;
-  const filterCondition = {
+  let filterCondition = {
     ...looseCondition,
     type: resolvedType
   };
+  let figureFactor = 1;
   if (field !== void 0 && filterCondition.type === "number") {
     const reading = conditionUnit(looseCondition, field, (key) => fieldByKey[key]);
     if (!reading.ok) throw new Error(`Filter on "${fieldKey}": ${reading.reason}`);
     if (reading.unit !== void 0 && filterCondition.value !== null && filterCondition.value !== void 0) {
       const factor = rowUnitFactor(reading.unit, data);
       if (factor === void 0) return false;
-      const inBase = { ...filterCondition, value: multiplyExactly(filterCondition.value, reading.unit.factor) };
-      return matchCell(columnValue, field, inBase, looseCondition, memberContext, fileFacts, factor);
+      figureFactor = factor;
+      filterCondition = { ...filterCondition, value: multiplyExactly(filterCondition.value, reading.unit.factor) };
     }
   }
   if (field?.type === "lookup" && (Array.isArray(columnValue) || columnValue == null)) {
     const values2 = Array.isArray(columnValue) ? columnValue : [];
-    return matchLookup(values2, field, filterCondition, looseCondition, memberContext, fileFacts);
+    return matchLookup(values2, field, filterCondition, looseCondition, memberContext, fileFacts, figureFactor);
   }
-  return matchCell(columnValue, field, filterCondition, looseCondition, memberContext, fileFacts);
+  return matchCell(columnValue, field, filterCondition, looseCondition, memberContext, fileFacts, figureFactor);
 }
-function matchLookup(cell, field, filterCondition, looseCondition, memberContext, fileFacts) {
+function matchLookup(cell, field, filterCondition, looseCondition, memberContext, fileFacts, figureFactor) {
   switch (filterCondition.type) {
     case "select":
     case "select_member":
@@ -11412,7 +11418,7 @@ function matchLookup(cell, field, filterCondition, looseCondition, memberContext
   let anyMatched = false;
   for (const value of values2) {
     const element = filterCondition.type === "text" && typeof value !== "string" && value !== null && value !== void 0 ? String(value) : value;
-    const result = matchCell(element, field, positive, looseCondition, memberContext, fileFacts);
+    const result = matchCell(element, field, positive, looseCondition, memberContext, fileFacts, figureFactor);
     if (result !== null) allSkipped = false;
     if (result === true) {
       anyMatched = true;

package/dist/queries.d.ts

@@ -228,6 +228,17 @@ export interface ExportTab {
     label: string;
     filter?: QueryFilter;
     sort?: readonly QuerySortKey[];
+    /** A tab of totals over the period: the declared query `query` read again under `params` (the period's two days), its
+     *  rows joined to the tab's by the link column `via`, and the columns `columns` each one's `alias` and header. */
+    totals?: {
+        query: string;
+        params: Record<string, string>;
+        via: string;
+        columns: {
+            alias: string;
+            label: string;
+        }[];
+    };
 }
 /** The file an export makes: the default report workbook — its words in `language`, the rows under `columns` on the
  *  tab `sheet` — or a template the query declares under `templates`, by its name there. */

package/docs/data_fetching.md

@@ -24,7 +24,7 @@ untyped. It is written from the app's live bindings by `lotics app create --cust
 | `useQuery(alias, params?, { rows: false, total: true })` | `total` only, no rows (`total: { by: column }` or `total: { where: { name: filter } }` adds `counts`) | a facet chip, a queue badge, an "N awaiting approval" tile — the size of a set you are not listing |
 | `useQueries(calls, opts?)` | one state per `{ alias, params?, filter?, sort?, aggregate?, total?, rows? }`, in order — a `sort` orders that call's rows before the cap cuts them | reads that are DATA — a list known only at render, one read per item, or one count per stage (`rows: false, total: true`, each state's `.total`); the deploy's alias scan reads a list as dynamic, so every alias in it is still declared. With `aggregate` a call answers the groups of its filtered rows instead of the rows ([queries](./queries.md)) |
 | `queryAll(alias, params?, { filter, sort })` | a promise of every row | outside React, for a job that must hold the whole narrowed set in the browser (the ids an act runs on): it asks page after page until the server says the set ended, never stopping at the 10,000-row cap. The server's rows as stored — no write of this app is drawn over them |
-| `exportQuery(alias, { params, filter, sort, tabs?, report, file, labels? })` | a promise of an `ExportedFile`: `{ filename, mime_type, url, size, created_at }` | every row the narrowed set holds, made into one file by the server — no row reaches the browser. `tabs` (2 to 5, each `{ tab, label, filter?, sort? }`) are each read as the export's own rows are — same query and params, under the tab's own filter and sort (absent, the declared order) — and a template reads each one's rows under its `tab`, a name none of the report's keys nor the template's `rows` key holds. `report` is `{ title, lines, readings, dates?, period?, per?, filename? }` — `dates` each date filter's `{ from?, to? }` by field alias, each bound a day (`yyyy-MM-dd`) or a minute of one (`yyyy-MM-ddTHH:mm`) with no zone; `period` the tabs' `{ from, to }`, bounds of the same form; `per` the value the report was picked for, in the reader's words; `filename` the file's name in the template grammar over one value each — `title`, `at` (the moment the server made the file), `dates.<field>.from` or `.to`, `period.from` or `.to`, `per`, `lines | lookup:<n>` — at most 200 bytes once filled (absent, the template's name, or `title`); `file` is `{ kind: "workbook", language, sheet, columns }` (the default report workbook, its head closing with the moment the server made it, each column `{ key, header, type }` an output column of the query — a `number` one on a number column, a `date` one on a date or datetime; with `tabs`, one sheet per tab named by its `label` in place of `sheet`) or `{ kind: "template", template }`, one the query declares under `templates` by name ([queries](./queries.md)). `labels`, by `select` output column, the words each option key prints as in either file — a cell no field of the query names (a union's literal column) arrives as its bare key; a cell its field's option names prints as that, a key the map lacks as itself, and a column no select of the query holds as it is. Past 20,000 rows, in any tab, it rejects, never cuts; each caller makes at most 60 exports a minute. The file has no `id` — it is a download, not a workspace file a workflow or a field takes: its `url` is signed for the caller for at most an hour, so download it with `downloadFileFromUrl(url, filename)` (`@lotics/ui/download`) when the promise resolves — a tab `openExternal` opens seconds after the click is a pop-up the browser blocks; the server deletes the file a day after it is made |
+| `exportQuery(alias, { params, filter, sort, tabs?, report, file, labels? })` | a promise of an `ExportedFile`: `{ filename, mime_type, url, size, created_at }` | every row the narrowed set holds, made into one file by the server — no row reaches the browser. `tabs` (2 to 5, each `{ tab, label, filter?, sort?, totals? }`; `totals` is `{ query, params, via, columns }`, the read of a totals tab beside its rows, joined on the link column `via`, refused where that read lacks `via` or a column or answers two groups for one row) are each read as the export's own rows are — same query and params, under the tab's own filter and sort (absent, the declared order) — and a template reads each one's rows under its `tab`, a name none of the report's keys nor the template's `rows` key holds. `report` is `{ title, lines, readings, dates?, period?, per?, filename? }` — `dates` each date filter's `{ from?, to? }` by field alias, each bound a day (`yyyy-MM-dd`) or a minute of one (`yyyy-MM-ddTHH:mm`) with no zone; `period` the tabs' `{ from, to }`, bounds of the same form; `per` the value the report was picked for, in the reader's words; `filename` the file's name in the template grammar over one value each — `title`, `at` (the moment the server made the file), `dates.<field>.from` or `.to`, `period.from` or `.to`, `per`, `lines | lookup:<n>` — at most 200 bytes once filled (absent, the template's name, or `title`); `file` is `{ kind: "workbook", language, sheet, columns }` (the default report workbook, its head closing with the moment the server made it, each column `{ key, header, type }` an output column of the query — a `number` one on a number column, a `date` one on a date or datetime; with `tabs`, one sheet per tab named by its `label` in place of `sheet`) or `{ kind: "template", template }`, one the query declares under `templates` by name ([queries](./queries.md)). `labels`, by `select` output column, the words each option key prints as in either file — a cell no field of the query names (a union's literal column) arrives as its bare key; a cell its field's option names prints as that, a key the map lacks as itself, and a column no select of the query holds as it is. Past 20,000 rows, in any tab, it rejects, never cuts; each caller makes at most 60 exports a minute. The file has no `id` — it is a download, not a workspace file a workflow or a field takes: its `url` is signed for the caller for at most an hour, so download it with `downloadFileFromUrl(url, filename)` (`@lotics/ui/download`) when the promise resolves — a tab `openExternal` opens seconds after the click is a pop-up the browser blocks; the server deletes the file a day after it is made |
 
 Every hook answers the same `QueryState`: `rows`, `truncated`, `total`, `counts`, `loading`,
 `isValidating`, `answeredAt`, `error`, `pending`, `refetch`, `page`, `setPage`, `pageCount`, `hasMore`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/app-sdk",
-  "version": "0.123.6",
+  "version": "0.123.8",
   "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": {