@lotics/app-sdk 0.106.1 → 0.108.0

package/AGENTS.md

@@ -43,7 +43,7 @@ This file is the index. The **exact type** of anything is its shipped declaratio
 - **`project` only what you render; filter server-side.** → [queries](./docs/queries.md)
 - **Never hand-roll the serialization contract** — decode cells with the typed readers, and read
   only the columns the alias projects. → [data_fetching](./docs/data_fetching.md)
-- **Narrow `__source_record_id` / `__source_table_id` before use** — a grouped query emits neither.
+- **Narrow `__source_record_id` / `__source_table_id` before use** — a grouped query answers both as null.
   → [data_fetching](./docs/data_fetching.md)
 - **A standalone app takes its API address from the page it was served in**, never from a
   constant. → [runtime](./docs/runtime.md)

package/dist/comments.d.ts

@@ -53,7 +53,7 @@ export interface UseCommentsArgs {
 }
 /**
  * `record_id` must be a real id — an empty string still fetches. Gate the
- * panel on a row's `__source_record_id`, which a grouped query lacks.
+ * panel on a row's `__source_record_id`, which a grouped query answers as null.
  *
  * ```tsx
  * // In a record screen, where an id definitionally exists:

package/dist/index.js

@@ -28316,6 +28316,9 @@ 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";
@@ -28339,6 +28342,7 @@ function aggregateRows(rows, aggregate) {
       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,

package/dist/queries.d.ts

@@ -12,10 +12,10 @@ import type { ReportColumn, ReportReading } from "./shared_types.js";
  */
 export interface QueryRow {
     [column: string]: unknown;
-    /** The record this row came from. Absent on a grouped/aggregated row. */
-    __source_record_id?: string;
-    /** The table that record lives in. Absent on a grouped/aggregated row. */
-    __source_table_id?: string;
+    /** The record this row came from: null on a grouped row, which stands for no one record. */
+    __source_record_id?: string | null;
+    /** The table that record lives in: null on a grouped row. */
+    __source_table_id?: string | null;
 }
 /**
  * The row type of alias `K`: its projected columns plus the two addressing

package/dist/shared_types.d.ts

@@ -4,7 +4,7 @@
  * tarball. Written at every build, never edited.
  */
 export type QueryAggregate = { by?: readonly string[]; day?: string; sum?: string; };
-export type ReportColumn = { key: string; header: string; type: "number" | "text" | "date"; };
+export type ReportColumn = { key: string; header: string; type: "number" | "text" | "date"; labels?: { readonly [x: string]: string; }; };
 export type ReportLanguage = "vi" | "en";
 export type ReportPart = { label: string; value: number; share: number | null; };
 export type ReportPivotColumn = { label: string; total: number | null; };

package/package.json

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