@frontera-sdk/core 1.50.82 → 1.50.83

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontera-sdk/core",
-  "version": "1.50.82",
+  "version": "1.50.83",
   "description": "Frontera app runtime: the platform bridge client, app bootstrap and typed platform client.",
   "keywords": [
     "frontera",

package/src/bridge-protocol.ts

@@ -36,6 +36,33 @@ export interface BridgeInit {
    */
   path?: string
   active?: boolean
+  /**
+   * The person who opened the app: what it may SHOW and use as a default —
+   * "you", "assigned to me", an owner field — without asking them to type
+   * who they are. `email` is the account email and may be null. Absent on a
+   * host that predates it and for an app hosted outside Frontera; null when no
+   * person is involved (a CLI key). Never an authorization input: what the app
+   * may do is decided server-side from the token.
+   */
+  viewer?: FronteraViewer | null
+}
+
+export interface FronteraViewer {
+  userId: string
+  name: string | null
+  email: string | null
+}
+
+/** A well-formed viewer, or null. The host is trusted; the shape still is not assumed. */
+export function viewerOf(value: unknown): FronteraViewer | null {
+  if (!value || typeof value !== 'object') return null
+  const v = value as Record<string, unknown>
+  if (typeof v.userId !== 'string' || !v.userId) return null
+  return {
+    userId: v.userId,
+    name: typeof v.name === 'string' && v.name.trim() ? v.name : null,
+    email: typeof v.email === 'string' && v.email.includes('@') ? v.email : null,
+  }
 }
 
 export type HostMessage =

package/src/create-frontera-app.tsx

@@ -13,7 +13,7 @@ import { createRoot } from 'react-dom/client'
 import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
 
 import { connectToHost, type BridgeSession } from './bridge-client'
-import type { BridgeInit } from './bridge-protocol'
+import { viewerOf, type BridgeInit, type FronteraViewer } from './bridge-protocol'
 import { FronteraClient } from './client'
 import { readRuntimeGlobal } from './config'
 import {
@@ -50,6 +50,12 @@ export interface FronteraAppValue {
   setUnsavedChanges(dirty: boolean): void
   /** Ask the platform to change its URL — the counterpart to `init.path`. */
   navigate(path: string): void
+  /**
+   * Who opened the app, from the host at handshake — or null when the host
+   * did not say (an older host, or no person, as with a CLI key). Use it to
+   * show and prefill; never to decide what the person may do.
+   */
+  viewer: FronteraViewer | null
 }
 
 const FronteraAppReactContext = createContext<FronteraAppValue | null>(null)
@@ -64,6 +70,16 @@ export function useFronteraApp(): FronteraAppValue {
   return value
 }
 
+/**
+ * The person who opened the app, or null when the host did not say.
+ *
+ * Shorthand for `useFronteraApp().viewer`: the common read, so an app does not
+ * have to ask a person to type who they are.
+ */
+export function useViewer(): FronteraViewer | null {
+  return useFronteraApp().viewer
+}
+
 /**
  * A wrapper contributed by a domain package.
  *
@@ -404,6 +420,7 @@ function FronteraRoot({
     navigate: (path) => {
       if (mode === 'embedded') session.send({ type: 'frontera:navigate', path })
     },
+    viewer: viewerOf(init.viewer),
   }
 
   let tree: ReactNode = children

package/src/react.ts

@@ -1,11 +1,13 @@
 export {
   FronteraAppProvider,
   useFronteraApp,
+  useViewer,
   type FronteraAppProviderProps,
   type FronteraAppValue,
   type FronteraProvider,
 } from './create-frontera-app'
 export type { FronteraAppMode } from './app-session'
+export type { FronteraViewer } from './bridge-protocol'
 export {
   AppUserSignInError,
   exchangeCustomerToken,