@lotics/app-sdk 0.9.0 → 0.11.0

package/dist/src/download.d.ts

@@ -0,0 +1 @@
+export declare function downloadFileFromUrl(url: string, filename: string): Promise<void>;

package/dist/src/download.js

@@ -0,0 +1,30 @@
+// File download primitive for Lotics custom-code apps. Uses fetch+blob+anchor
+// because the app runs inside a sandboxed iframe — `window.open(url, "_blank")`
+// is silently dropped without `allow-popups`, and direct anchor navigation
+// without the `download` attribute doesn't trigger a save dialog for inline
+// MIME types (HTML, JSON, PDFs, etc.).
+//
+// `cache: "no-store"` matches the frontend convention — avoids CORS cache
+// collisions where a prior <img> load cached the response without an
+// `Access-Control-Allow-Origin` header, breaking subsequent fetches.
+export async function downloadFileFromUrl(url, filename) {
+    if (!url)
+        throw new Error("downloadFileFromUrl: empty url");
+    const response = await fetch(url, { cache: "no-store" });
+    if (!response.ok) {
+        throw new Error(`File download failed: ${response.status} ${response.statusText}`);
+    }
+    const blob = await response.blob();
+    const blobUrl = URL.createObjectURL(blob);
+    try {
+        const link = document.createElement("a");
+        link.href = blobUrl;
+        link.download = filename;
+        document.body.appendChild(link);
+        link.click();
+        link.remove();
+    }
+    finally {
+        URL.revokeObjectURL(blobUrl);
+    }
+}

package/dist/src/index.d.ts

@@ -13,7 +13,10 @@ export { mount } from "./mount.js";
 export type { MountOptions } from "./mount.js";
 export { useWorkflow, useQuery, useFileUpload } from "./hooks.js";
 export type { UploadedFile } from "./hooks.js";
+export { downloadFileFromUrl } from "./download.js";
 export { rpc } from "./rpc.js";
 export type { RpcOp } from "./rpc.js";
+export { readMembers } from "./members.js";
+export type { ResolvedMember } from "./members.js";
 export type { AppFixture } from "./mock.js";
 export type { AppWorkflows, AppQueries } from "./types.js";

package/dist/src/index.js

@@ -11,4 +11,6 @@
  */
 export { mount } from "./mount.js";
 export { useWorkflow, useQuery, useFileUpload } from "./hooks.js";
+export { downloadFileFromUrl } from "./download.js";
 export { rpc } from "./rpc.js";
+export { readMembers } from "./members.js";

package/dist/src/members.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Reader for `select_member` cells in `useQuery` rows.
+ *
+ * The server (`backend/lib/select_member_resolver.ts`) rewrites every
+ * `select_member` column from its storage shape (`string[]` of bare member
+ * IDs) into `ResolvedMember[]` before the row reaches the app. Apps used to
+ * hardcode an id→name fallback map because the SDK didn't expose the
+ * resolved shape; this helper makes the right shape the obvious one.
+ *
+ * If the wire format changes, the resolver and this reader move together.
+ */
+export interface ResolvedMember {
+    id: string;
+    /** `null` when the id resolves outside the app's org (e.g. removed
+     *  member) — surfaces the missing state explicitly instead of an
+     *  empty string. */
+    name: string | null;
+    /** Present only on authenticated responses. Omitted on public-app
+     *  responses (no PII exposure to anonymous visitors). */
+    email?: string | null;
+}
+/**
+ * Parse a `useQuery` cell value into `ResolvedMember[]`. Returns `[]` for
+ * null/undefined/empty cells and for any unexpected shape — callers iterate
+ * uniformly without null-checks. Entries that fail the shape check are
+ * dropped silently rather than corrupting the array with partial data.
+ */
+export declare function readMembers(value: unknown): ResolvedMember[];

package/dist/src/members.js

@@ -0,0 +1,42 @@
+/**
+ * Reader for `select_member` cells in `useQuery` rows.
+ *
+ * The server (`backend/lib/select_member_resolver.ts`) rewrites every
+ * `select_member` column from its storage shape (`string[]` of bare member
+ * IDs) into `ResolvedMember[]` before the row reaches the app. Apps used to
+ * hardcode an id→name fallback map because the SDK didn't expose the
+ * resolved shape; this helper makes the right shape the obvious one.
+ *
+ * If the wire format changes, the resolver and this reader move together.
+ */
+/**
+ * Parse a `useQuery` cell value into `ResolvedMember[]`. Returns `[]` for
+ * null/undefined/empty cells and for any unexpected shape — callers iterate
+ * uniformly without null-checks. Entries that fail the shape check are
+ * dropped silently rather than corrupting the array with partial data.
+ */
+export function readMembers(value) {
+    if (!Array.isArray(value))
+        return [];
+    const out = [];
+    for (const entry of value) {
+        if (!entry || typeof entry !== "object")
+            continue;
+        const obj = entry;
+        const id = obj.id;
+        if (typeof id !== "string" || id === "")
+            continue;
+        const name = typeof obj.name === "string" ? obj.name : obj.name === null ? null : null;
+        const m = { id, name };
+        if ("email" in obj) {
+            m.email =
+                typeof obj.email === "string"
+                    ? obj.email
+                    : obj.email === null
+                        ? null
+                        : null;
+        }
+        out.push(m);
+    }
+    return out;
+}

package/package.json

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