@frontera-sdk/core 1.52.38 → 1.52.40

package/package.json

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

package/src/app-session.ts

@@ -64,7 +64,17 @@ async function fetchSession(
     credentials: 'include',
     headers: { accept: 'application/json' },
   })
-  if (!response.ok) throw new Error(`Frontera session request failed with ${response.status}`)
+  if (!response.ok) {
+    // The local dev server says why (`{ error }`): the runtime no longer has the App, or its credential.
+    let reason = ''
+    try {
+      const body = (await response.json()) as { error?: unknown }
+      if (typeof body?.error === 'string' && body.error) reason = `: ${body.error}`
+    } catch {
+      // No JSON body: the status is all there is.
+    }
+    throw new Error(`Frontera session request failed with ${response.status}${reason}`)
+  }
   return parseSessionResponse(await response.json())
 }
 

package/src/bridge-protocol.ts

@@ -45,6 +45,14 @@ export interface BridgeInit {
    * may do is decided server-side from the token.
    */
   viewer?: FronteraViewer | null
+  /**
+   * Whether the frame shows the App's production deployment or a preview (a
+   * branch or session link, or one deployment opened by its own link). A
+   * preview reads and writes the same workspace data as production; Action
+   * requests it raises are labelled as coming from a preview. Absent on a
+   * host that predates it: treat that as production.
+   */
+  deployment?: 'production' | 'preview'
 }
 
 export interface FronteraViewer {

package/src/create-frontera-app.tsx

@@ -62,6 +62,11 @@ export interface FronteraAppValue {
    * show and prefill; never to decide what the person may do.
    */
   viewer: FronteraViewer | null
+  /**
+   * True when the host says this frame shows a preview deployment rather than
+   * production. Data is real either way; use it to show a "Preview" marker.
+   */
+  isPreview: boolean
 }
 
 const FronteraAppReactContext = createContext<FronteraAppValue | null>(null)
@@ -86,6 +91,14 @@ export function useViewer(): FronteraViewer | null {
   return useFronteraApp().viewer
 }
 
+/**
+ * Whether the App is open from a preview deployment, as the host said at
+ * handshake. Shorthand for `useFronteraApp().isPreview`.
+ */
+export function useIsPreview(): boolean {
+  return useFronteraApp().isPreview
+}
+
 /**
  * A wrapper contributed by a domain package.
  *
@@ -519,6 +532,7 @@ function FronteraRoot({
       if (mode === 'embedded') session.send({ type: 'frontera:navigate', path })
     },
     viewer: viewerOf(init.viewer),
+    isPreview: init.deployment === 'preview',
   }
 
   let tree: ReactNode = children

package/src/react.ts

@@ -2,6 +2,7 @@ export {
   FronteraAppProvider,
   useFronteraApp,
   useViewer,
+  useIsPreview,
   type FronteraAppProviderProps,
   type FronteraAppValue,
   type FronteraProvider,