@lotics/app-sdk 0.27.0 → 0.28.0

package/dist/src/comments.js

@@ -24,6 +24,7 @@ import { useCallback } from "react";
 import useSWR from "swr";
 import { rpc } from "./rpc.js";
 import { captureAppEvent } from "./analytics.js";
+import { useAppContext } from "./viewer.js";
 /** The reduced storage shape the update endpoint accepts for `files`. */
 function toStorageFiles(files) {
     return (files ?? []).map((f) => ({
@@ -33,24 +34,6 @@ function toStorageFiles(files) {
         mime_type: f.mime_type,
     }));
 }
-/**
- * Read the app's context once, shared across every hook via a stable SWR key.
- * Comments need a signed-in member (members-only) AND the app's declared
- * `comments` capability — both come from here.
- */
-function useAppContext() {
-    const { data } = useSWR("app-context", () => rpc("context", {}), {
-        revalidateOnFocus: false,
-        revalidateIfStale: false,
-        revalidateOnReconnect: false,
-        shouldRetryOnError: false,
-    });
-    return {
-        memberId: data?.member_id ?? null,
-        commentsEnabled: data?.comments_enabled ?? false,
-        resolved: data !== undefined,
-    };
-}
 let optimisticCounter = 0;
 /**
  * ```tsx

package/dist/src/index.d.ts

@@ -20,6 +20,7 @@ export { useWorkflow, useQuery, useInfiniteQuery, usePaginatedQuery, useFileUplo
 export type { UploadedFile, BaseQueryOptions, QueryOptions, InfiniteQueryOptions, PaginatedQueryOptions, QuerySortKey, QueryFilter, QueryFilterCondition, QueryFilterGroup, WorkflowResult, MembersOptions, } from "./hooks.js";
 export { useComments } from "./comments.js";
 export type { AppComment, AppCommentFile, CommentsState, UseCommentsArgs } from "./comments.js";
+export { useViewer } from "./viewer.js";
 export { rpc } from "./rpc.js";
 export type { RpcOp } from "./rpc.js";
 export { openExternal } from "./open_external.js";

package/dist/src/index.js

@@ -17,6 +17,7 @@
 export { mount } from "./mount.js";
 export { useWorkflow, useQuery, useInfiniteQuery, usePaginatedQuery, useFileUpload, useMembers, } from "./hooks.js";
 export { useComments } from "./comments.js";
+export { useViewer } from "./viewer.js";
 export { rpc } from "./rpc.js";
 export { openExternal } from "./open_external.js";
 export { readMembers } from "./members.js";

package/dist/src/viewer.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Read the app's context once, shared across every hook via a stable SWR key.
+ * The host (the product iframe, or `lotics app dev`) supplies the signed-in
+ * member and the app's declared capabilities.
+ */
+export declare function useAppContext(): {
+    memberId: string | null;
+    commentsEnabled: boolean;
+    resolved: boolean;
+};
+/**
+ * The signed-in member currently viewing the app — the **view-as target** under
+ * an admin's "View as" (product UI or `lotics app dev --view-as`), the
+ * authenticated member otherwise, and `null` for a public/standalone visitor or
+ * until the context resolves (gate viewer-dependent UI on `loading`).
+ *
+ * Use it to personalize (greet the member, default an assignment to them) or to
+ * pass the viewer into a workflow that must attribute to them. **Per-row data
+ * scoping does NOT need this** — put an `is_current_member` filter in the query
+ * template and the server resolves it to the same member (honoring view-as).
+ */
+export declare function useViewer(): {
+    memberId: string | null;
+    loading: boolean;
+};

package/dist/src/viewer.js

@@ -0,0 +1,35 @@
+import useSWR from "swr";
+import { rpc } from "./rpc.js";
+/**
+ * Read the app's context once, shared across every hook via a stable SWR key.
+ * The host (the product iframe, or `lotics app dev`) supplies the signed-in
+ * member and the app's declared capabilities.
+ */
+export function useAppContext() {
+    const { data } = useSWR("app-context", () => rpc("context", {}), {
+        revalidateOnFocus: false,
+        revalidateIfStale: false,
+        revalidateOnReconnect: false,
+        shouldRetryOnError: false,
+    });
+    return {
+        memberId: data?.member_id ?? null,
+        commentsEnabled: data?.comments_enabled ?? false,
+        resolved: data !== undefined,
+    };
+}
+/**
+ * The signed-in member currently viewing the app — the **view-as target** under
+ * an admin's "View as" (product UI or `lotics app dev --view-as`), the
+ * authenticated member otherwise, and `null` for a public/standalone visitor or
+ * until the context resolves (gate viewer-dependent UI on `loading`).
+ *
+ * Use it to personalize (greet the member, default an assignment to them) or to
+ * pass the viewer into a workflow that must attribute to them. **Per-row data
+ * scoping does NOT need this** — put an `is_current_member` filter in the query
+ * template and the server resolves it to the same member (honoring view-as).
+ */
+export function useViewer() {
+    const ctx = useAppContext();
+    return { memberId: ctx.memberId, loading: !ctx.resolved };
+}

package/package.json

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