@lotics/app-sdk 0.23.0 → 0.24.0

package/dist/src/index.d.ts

@@ -27,8 +27,8 @@ 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 } from "./row.js";
-export type { ResolvedLink } from "./row.js";
+export { row, readLinks, readFiles } from "./row.js";
+export type { ResolvedLink, AppFile } from "./row.js";
 export { useOptimistic } from "./use_optimistic.js";
 export type { OptimisticApi } from "./use_optimistic.js";
 export { useRecents } from "./use_recents.js";

package/dist/src/index.js

@@ -20,6 +20,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 } from "./row.js";
+export { row, readLinks, readFiles } from "./row.js";
 export { useOptimistic } from "./use_optimistic.js";
 export { useRecents } from "./use_recents.js";

package/dist/src/row.d.ts

@@ -44,6 +44,27 @@ export interface ResolvedLink {
 declare function link(v: unknown): ResolvedLink | null;
 /** select_record_link → ALL linked records as `{ id, display }[]` (empty if none). */
 export declare function readLinks(v: unknown): ResolvedLink[];
+/**
+ * A `files`-field cell entry, as the app query serializes it. The server
+ * presigns each file (24h) so `url`/`thumbnail_url` load directly — including
+ * from the sandboxed app iframe and for public apps — so the app can preview or
+ * download without deriving its own URL.
+ */
+export interface AppFile {
+    id: string;
+    filename: string;
+    mime_type: string;
+    /** Presigned serving URL — render in an <Image>/preview or pass to openExternal. */
+    url: string;
+    /** Presigned thumbnail URL for images, when the server produced one. */
+    thumbnail_url?: string;
+}
+/**
+ * files field → the attached files with their presigned `url` (empty if none).
+ * Skips entries the server didn't presign (no `url`) so a consumer never renders
+ * an unservable file. Map to `@lotics/ui` `DisplayFile` for FileThumbnail/Gallery.
+ */
+export declare function readFiles(v: unknown): AppFile[];
 export declare const row: {
     opt: typeof opt;
     text: typeof text;

package/dist/src/row.js

@@ -89,4 +89,33 @@ export function readLinks(v) {
     }
     return v.map(asLink).filter((x) => x !== null);
 }
+/**
+ * files field → the attached files with their presigned `url` (empty if none).
+ * Skips entries the server didn't presign (no `url`) so a consumer never renders
+ * an unservable file. Map to `@lotics/ui` `DisplayFile` for FileThumbnail/Gallery.
+ */
+export function readFiles(v) {
+    if (!Array.isArray(v))
+        return [];
+    const out = [];
+    for (const f of v) {
+        if (!f || typeof f !== "object")
+            continue;
+        const id = f.id;
+        const url = f.url;
+        if (typeof id !== "string" || !id || typeof url !== "string" || !url)
+            continue;
+        const filename = f.filename;
+        const mime = f.mime_type;
+        const thumb = f.thumbnail_url;
+        out.push({
+            id,
+            filename: typeof filename === "string" ? filename : "",
+            mime_type: typeof mime === "string" ? mime : "",
+            url,
+            thumbnail_url: typeof thumb === "string" ? thumb : undefined,
+        });
+    }
+    return out;
+}
 export const row = { opt, text, num, bool, date, link };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/app-sdk",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "Runtime SDK for Lotics custom-code apps — typed hooks, postMessage bridge, mount entry point",
   "type": "module",
   "exports": {