@lotics/app-sdk 0.113.1 → 0.114.0

package/dist/{chunk-CRJQYSDI.js → chunk-EWCMZCKA.js}

@@ -174,6 +174,42 @@ function transportErrorMessage(status, parsed) {
   return status < 500 || authored ? jsonMessage : gatewayErrorMessage(status);
 }
 
+// ../shared/src/schemas/read_row.ts
+var RECORD_ID_COLUMN = "__source_record_id";
+
+// ../shared/src/schemas/app_query_aggregate.ts
+var APP_QUERY_BATCH_MAX = 16;
+var AGGREGATE_COUNT_COLUMN = "__count";
+var AGGREGATE_SUM_COLUMN = "__sum";
+var AGGREGATE_DAY_COLUMN = "__day";
+function dayOf(cell) {
+  return typeof cell === "string" && cell !== "" ? cell.slice(0, 10) : null;
+}
+function aggregateRows(rows, aggregate) {
+  const by = aggregate.by ?? [];
+  const day = aggregate.day;
+  const sum = aggregate.sum;
+  const keyed = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    const key = JSON.stringify([...by.map((column) => row[column] ?? null), ...day === void 0 ? [] : [dayOf(row[day])]]);
+    keyed.set(key, [...keyed.get(key) ?? [], row]);
+  }
+  return [...keyed.values()].map((members) => {
+    const [first2] = members;
+    const figures = members.flatMap((member) => {
+      const value = sum === void 0 ? void 0 : member[sum];
+      return typeof value === "number" ? [value] : [];
+    });
+    return {
+      [RECORD_ID_COLUMN]: null,
+      ...Object.fromEntries(by.map((column) => [column, first2?.[column] ?? null])),
+      ...day === void 0 ? {} : { [AGGREGATE_DAY_COLUMN]: dayOf(first2?.[day]) },
+      [AGGREGATE_COUNT_COLUMN]: members.length,
+      ...sum === void 0 ? {} : { [AGGREGATE_SUM_COLUMN]: figures.length === 0 ? null : figures.reduce((total, value) => total + value, 0) }
+    };
+  });
+}
+
 // src/upload/optimize.ts
 var DEFAULT_IMAGE_FIDELITY = "high";
 var IMAGE_POLICIES = {
@@ -1032,9 +1068,47 @@ async function standaloneWriteModel() {
   const { app_id } = await boot();
   return apiCall("GET", `/v1/apps/${app_id}/write_model`, void 0, { appId: app_id });
 }
-async function standaloneQuery(payload) {
-  const { app_id } = await boot();
-  return apiCall("POST", `/v1/apps/${app_id}/query`, payload, { appId: app_id });
+var READ_BATCH_WINDOW_MS = 5;
+var askedReads = [];
+function standaloneQuery(payload) {
+  return new Promise((resolve, reject) => {
+    askedReads = [...askedReads, { payload, resolve, reject }];
+    if (askedReads.length === 1) setTimeout(() => void sendAskedReads(), READ_BATCH_WINDOW_MS);
+  });
+}
+async function sendAskedReads() {
+  const asked = askedReads;
+  askedReads = [];
+  const booted = await boot().catch((error) => {
+    asked.forEach((read) => read.reject(error));
+    return void 0;
+  });
+  if (booted === void 0) return;
+  for (let at = 0; at < asked.length; at += APP_QUERY_BATCH_MAX) {
+    const chunk = asked.slice(at, at + APP_QUERY_BATCH_MAX);
+    apiCall("POST", `/v1/apps/${booted.app_id}/query_batch`, { reads: chunk.map((read) => read.payload) }, { appId: booted.app_id }).then((answered) => {
+      const results = batchResults(answered);
+      chunk.forEach((read, k) => {
+        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)));
+      });
+    }).catch((error) => chunk.forEach((read) => read.reject(error)));
+  }
+}
+function batchResults(answered) {
+  if (answered === null || typeof answered !== "object" || !("results" in answered) || !Array.isArray(answered.results)) {
+    throw new Error("The server's batch answer carried no results.");
+  }
+  return answered.results.map((answer, at) => {
+    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 } };
+    }
+    throw new Error(`The server's batch answer ${at} is neither a result nor a refusal.`);
+  });
 }
 async function standaloneExport(payload) {
   const { app_id } = await boot();
@@ -1119,6 +1193,9 @@ async function standaloneUpload(file, fidelity) {
 
 export {
   __export,
+  AGGREGATE_COUNT_COLUMN,
+  AGGREGATE_SUM_COLUMN,
+  aggregateRows,
   DEFAULT_IMAGE_FIDELITY,
   recordingsVersion,
   subscribeRecordings,

package/dist/index.js

@@ -1,6 +1,9 @@
 import {
+  AGGREGATE_COUNT_COLUMN,
+  AGGREGATE_SUM_COLUMN,
   DEFAULT_IMAGE_FIDELITY,
   __export,
+  aggregateRows,
   anyRecordingLive,
   applyPatch,
   decodeAll,
@@ -22,7 +25,7 @@ import {
   subscribeRecordings,
   subscribeUrlParams,
   urlParam
-} from "./chunk-CRJQYSDI.js";
+} from "./chunk-EWCMZCKA.js";
 
 // src/mount.tsx
 import { createRoot } from "react-dom/client";
@@ -29066,41 +29069,6 @@ function useAgentRuns(sessionId, opts) {
 // src/queries.ts
 import { useCallback as useCallback5, useMemo as useMemo3, useState as useState3 } from "react";
 
-// ../shared/src/schemas/read_row.ts
-var RECORD_ID_COLUMN = "__source_record_id";
-
-// ../shared/src/schemas/app_query_aggregate.ts
-var AGGREGATE_COUNT_COLUMN = "__count";
-var AGGREGATE_SUM_COLUMN = "__sum";
-var AGGREGATE_DAY_COLUMN = "__day";
-function dayOf(cell) {
-  return typeof cell === "string" && cell !== "" ? cell.slice(0, 10) : null;
-}
-function aggregateRows(rows, aggregate) {
-  const by = aggregate.by ?? [];
-  const day = aggregate.day;
-  const sum2 = aggregate.sum;
-  const keyed = /* @__PURE__ */ new Map();
-  for (const row2 of rows) {
-    const key = JSON.stringify([...by.map((column) => row2[column] ?? null), ...day === void 0 ? [] : [dayOf(row2[day])]]);
-    keyed.set(key, [...keyed.get(key) ?? [], row2]);
-  }
-  return [...keyed.values()].map((members2) => {
-    const [first2] = members2;
-    const figures = members2.flatMap((member) => {
-      const value = sum2 === void 0 ? void 0 : member[sum2];
-      return typeof value === "number" ? [value] : [];
-    });
-    return {
-      [RECORD_ID_COLUMN]: null,
-      ...Object.fromEntries(by.map((column) => [column, first2?.[column] ?? null])),
-      ...day === void 0 ? {} : { [AGGREGATE_DAY_COLUMN]: dayOf(first2?.[day]) },
-      [AGGREGATE_COUNT_COLUMN]: members2.length,
-      ...sum2 === void 0 ? {} : { [AGGREGATE_SUM_COLUMN]: figures.length === 0 ? null : figures.reduce((total, value) => total + value, 0) }
-    };
-  });
-}
-
 // src/row.ts
 var PENDING = "__pending";
 function opt(v) {

package/dist/router.js

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

package/docs/data_fetching.md

@@ -143,7 +143,7 @@ write it as `{ node_type: "condition", type: "record_id", operator, value }`.
   inline `{ status: "open" }` each render is the same key; you never need to memoize params.
 - **The cache survives unmount/remount**, and **arrival is a refresh event**: returning to a screen
   renders the cached rows instantly *and* re-reads them in the background, so a list reflects what
-  another screen changed while you were away. Identical concurrent reads share one request.
+  another screen changed while you were away. Identical concurrent reads share one request, and reads asked within a few milliseconds of each other go to the server together, each answered or refused on its own.
   Freshness comes from four places — arrival, window focus / tab return / network reconnect
   (`revalidateOnFocus`, default on; a read asked within the last few seconds is not asked again),
   a **realtime push**, and **this app's own successful write**, which re-reads the mounted queries

package/package.json

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