@lotics/app-sdk 0.31.0 → 0.32.0

package/dist/src/index.d.ts

@@ -32,7 +32,7 @@ export { readSelect } from "./select.js";
 export type { ResolvedOption } from "./select.js";
 export type { AppFixture } from "./mock.js";
 export type { AppWorkflows, AppQueries } from "./types.js";
-export { row, readLinks, readFiles } from "./row.js";
+export { row, readLinks, readFiles, readLocked } from "./row.js";
 export type { ResolvedLink, AppFile } from "./row.js";
 export { useOptimistic } from "./use_optimistic.js";
 export type { OptimisticApi } from "./use_optimistic.js";

package/dist/src/index.js

@@ -23,6 +23,6 @@ export { rpc } from "./rpc.js";
 export { openExternal } from "./open_external.js";
 export { readMembers } from "./members.js";
 export { readSelect } from "./select.js";
-export { row, readLinks, readFiles } from "./row.js";
+export { row, readLinks, readFiles, readLocked } from "./row.js";
 export { useOptimistic } from "./use_optimistic.js";
 export { useRecents } from "./use_recents.js";

package/dist/src/row.d.ts

@@ -65,6 +65,15 @@ export interface AppFile {
  * an unservable file. Map to `@lotics/ui` `DisplayFile` for FileThumbnail/Gallery.
  */
 export declare function readFiles(v: unknown): AppFile[];
+/**
+ * Record lock state for a `useQuery` row. The query layer emits a row-level
+ * `__source_locked` addressing column (alongside `__source_record_id`). A locked
+ * record rejects direct writes, so an app reads this to show a locked state and
+ * route edits through a `request_locked_field_change` workflow instead of an
+ * `update_records` save. Pass the whole row (not a cell). False for any
+ * non-object / absent flag.
+ */
+export declare function readLocked(rowValue: unknown): boolean;
 export declare const row: {
     opt: typeof opt;
     text: typeof text;

package/dist/src/row.js

@@ -118,4 +118,17 @@ export function readFiles(v) {
     }
     return out;
 }
+/**
+ * Record lock state for a `useQuery` row. The query layer emits a row-level
+ * `__source_locked` addressing column (alongside `__source_record_id`). A locked
+ * record rejects direct writes, so an app reads this to show a locked state and
+ * route edits through a `request_locked_field_change` workflow instead of an
+ * `update_records` save. Pass the whole row (not a cell). False for any
+ * non-object / absent flag.
+ */
+export function readLocked(rowValue) {
+    if (!rowValue || typeof rowValue !== "object")
+        return false;
+    return bool(rowValue["__source_locked"]);
+}
 export const row = { opt, text, num, bool, date, link };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/app-sdk",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "description": "Runtime SDK for Lotics custom-code apps — typed hooks, postMessage bridge, mount entry point",
   "type": "module",
   "exports": {
@@ -46,4 +46,4 @@
     "url": "https://github.com/lotics/lotics.git",
     "directory": "packages/app-sdk"
   }
-}
+}