@lotics/app-sdk 0.123.1 → 0.123.2

package/dist/index.js

@@ -24784,24 +24784,16 @@ var tableRecordSelectMemberFieldFilterSchema = zod_default.object({
   ]),
   value: zod_default.array(zod_default.string()).nullable()
 });
+var LINK_MEMBERSHIP = ["has_any_of", "has_none_of", "has_all_of"];
+var LINK_TEXT = ["contains", "not_contains", "starts_with", "ends_with"];
 var tableRecordSelectRecordLinkFieldFilterSchema = zod_default.object({
   type: zod_default.literal("select_record_link"),
   field_key: zod_default.string(),
-  operator: zod_default.enum([
-    // Membership operators — match linked record IDs. value: string[].
-    "has_any_of",
-    "has_none_of",
-    "has_all_of",
-    // Text operators — match the cached display text. value: string.
-    "contains",
-    "not_contains",
-    "starts_with",
-    "ends_with",
-    "is_empty",
-    "is_not_empty"
-  ]),
+  operator: zod_default.enum([...LINK_MEMBERSHIP, ...LINK_TEXT, "is_empty", "is_not_empty"]),
   value: zod_default.union([zod_default.string(), zod_default.array(zod_default.string())]).nullable()
 });
+var SELECT_RECORD_LINK_MEMBERSHIP_OPERATORS = new Set(LINK_MEMBERSHIP);
+var SELECT_RECORD_LINK_TEXT_OPERATORS = new Set(LINK_TEXT);
 var tableRecordFilesFieldFilterSchema = zod_default.object({
   type: zod_default.literal("files"),
   field_key: zod_default.string(),

package/docs/queries.md

@@ -398,14 +398,14 @@ as one. `record_id` is the sole exception, and declaring anything but `text` on
 
 `{ link: { source, field } }` requires a direct `from_table` parent, and `source` must be a
 `select_record_link` field on it. `field` names a field on the **link target table** —
-resolved **by display name first, then by key**. The target row is pinned to the declared
+resolved **by display name first, then by key** (exactly: `SIZE` is not `Size`). A save refuses a
+`field` the target holds under neither, naming its fields. The target row is pinned to the declared
 table, the workspace, live (non-archived, non-draft) rows, and the target table's row scope —
 a scoped-out or stale link extracts as NULL.
 
 **Warning:** only the **first** link in the cell is followed. Multi-link analytics go through
-`unnest` + join (§8). And because `field` resolves by name first, renaming a field on the
-target table can silently re-point (or break) the extraction — prefer field **keys** when the
-target's names are volatile.
+`unnest` + join (§8). Renaming the field a `field` names by its name rewrites that `field` to
+the field's key; a field renamed to a name another read uses re-points that read — prefer keys.
 
 **Cost.** Every `link` column over one `source` shares one read of the linked record per row, and
 every `link_agg` column over one `source` shares one aggregate, so ten columns through `customer` cost
@@ -487,7 +487,7 @@ derived surfaces share one implementation.
 | boolean | `boolean` | `equals` (value `true`/`false`; `false` matches NULL/missing) | same | `checked`/`unchecked`/`percent_*` aggregate (`unchecked` counts false **or** empty). |
 | select (single & multi) | `select` | `has_any_of`, `has_none_of`, `has_all_of`, `is_empty`, `is_not_empty` — values are **option keys** (`opt_*`), never labels | the **runtime** `filter` (§9) also takes option **names**, resolving each to its key — an unknown one is refused rather than matching nothing, and the value stays an array either way; a select column the query DERIVES instead of projecting from a field or a select literal carries no option set, so addressing one there is refused | Cells are arrays even for single-selects. Sorting a select column orders by its options' order (a multi-select by its first option), an empty cell last, on every page, keyset included; through a `union` whose arms project different selects, each row by its own select's order (§2 `union`); a select the query derives carries no options and orders by raw JSON. `unnest` fans option keys. |
 | select_member | `select_member` | select ops + `is_current_member`, `is_not_current_member` (field-scoped, no value; `is_not_current_member` matches every cell not holding the requester, an empty one included) | same — `is_current_member` **works at the runtime layer** too | Sorting orders by the first member's name as a reader is shown it (the one the organization gave, else their profile's; a member it does not name reads as empty text), folded like text, then by member id; an empty cell last, on every page, keyset included. `unnest` fans member ids. Anonymous public request: current-member binds the app owner (§1). |
-| select_record_link | `select_record_link` | membership by linked-record **id**: `has_any_of`, `has_none_of`, `has_all_of`; text over the cached **display**: `contains`, `not_contains`, `starts_with`, `ends_with`; `is_empty`, `is_not_empty` | same — id-membership works at the runtime layer (converged `[{id}]` containment) | Sorting orders by the first linked record's display, folded like text, then by its id; an empty cell last, on every page, keyset included. `unnest` fans link ids (+ display). |
+| select_record_link | `select_record_link` | membership by linked-record **id**: `has_any_of`, `has_none_of`, `has_all_of`; text over the cached **display** (deprecated — filter by id, and a linked record's field through a lookup): `contains`, `not_contains`, `starts_with`, `ends_with`; `is_empty`, `is_not_empty` | same — id-membership works at the runtime layer (converged `[{id}]` containment) | Sorting orders by the first linked record's display, folded like text, then by its id; an empty cell last, on every page, keyset included. `unnest` fans link ids (+ display). |
 | files | `files` | `has_filename`, `has_mime_type` (substring), `has_file_count` (exact count), `is_empty`, `is_not_empty` | same | Presign-enriched at delivery (§1); `unnest` fans file ids. Only presence-counting aggregates. |
 | formula | its declared output type (`number`/`text`/`boolean`/`date`/`datetime`, or `select` for one stating its own options, its cell a single select's; `json` until inferred) | filtered by the output type's operators; a cell holding an error (`#ERROR: …`) holds no value — it projects as `null` whatever the output type, and matches what an empty cell matches (`is_empty`, a negation such as `not_equals`) and nothing that needs a value | same | Extracted as a real scalar, so numeric formulas feed `sum`/`avg`/sorts. A **datetime-output** formula matches day-level date filters (full-day expansion). |
 | rollup | decided by the OPERATION, never by the aggregated field: `earliest`/`latest` → `date`/`datetime` per that field's format; **every** other op → `number` | number or date operators per output type; text operators route as text | same | Datetime-format rollups match day-level date filters. `date_range` counts DAYS between the extremes, so it is a number despite its date input. A presence count (`filled`/`empty`/`percent_*`) is a number whatever it counts — including over `files`. |

package/package.json

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