@farcaster/frame-sdk 0.0.36 → 0.0.38

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { AddFrame, ComposeCast, Context, FrameNotificationDetails, Ready, SetPrimaryButtonOptions, SignIn, Swap, ViewProfile, ViewToken } from '@farcaster/frame-core';
+import type { AddFrame, ComposeCast, Context, FrameNotificationDetails, Ready, SendToken, SetPrimaryButtonOptions, SignIn, SwapToken, ViewProfile, ViewToken } from '@farcaster/frame-core';
 import type { EventEmitter } from 'eventemitter3';
 import type * as Provider from 'ox/Provider';
 declare global {
@@ -29,6 +29,7 @@ export type EventMap = {
 export type Emitter = Compute<EventEmitter<EventMap>>;
 type SetPrimaryButton = (options: SetPrimaryButtonOptions) => Promise<void>;
 export type FrameSDK = {
+    isInMiniApp: () => Promise<boolean>;
     context: Promise<Context.FrameContext>;
     actions: {
         ready: (options?: Partial<Ready.ReadyOptions>) => Promise<void>;
@@ -38,10 +39,13 @@ export type FrameSDK = {
         addFrame: AddFrame.AddFrame;
         signIn: SignIn.SignIn;
         viewProfile: ViewProfile.ViewProfile;
-        viewToken: ViewToken.ViewToken;
-        swap: Swap.Swap;
         composeCast: <close extends boolean | undefined = undefined>(options?: ComposeCast.Options<close>) => Promise<ComposeCast.Result<close>>;
     };
+    experimental: {
+        viewToken: ViewToken.ViewToken;
+        sendToken: SendToken.SendToken;
+        swapToken: SwapToken.SwapToken;
+    };
     wallet: {
         ethProvider: Provider.Provider;
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farcaster/frame-sdk",
-  "version": "0.0.36",
+  "version": "0.0.38",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -22,7 +22,7 @@
     "comlink": "^4.4.2",
     "eventemitter3": "^5.0.1",
     "ox": "^0.4.4",
-    "@farcaster/frame-core": "0.0.33"
+    "@farcaster/frame-core": "0.0.34"
   },
   "scripts": {
     "clean": "rm -rf dist",

package/src/sdk.ts

@@ -28,17 +28,58 @@ export function createEmitter(): Emitter {
 }
 
 const emitter = createEmitter()
+let cachedIsInMiniAppResult: boolean | null = null
+
+/**
+ * Determines if the current environment is a MiniApp context.
+ *
+ * @param timeoutMs - Optional timeout in milliseconds (default: 50)
+ * @returns Promise resolving to boolean indicating if in MiniApp context
+ */
+async function isInMiniApp(timeoutMs = 50): Promise<boolean> {
+  // Return cached result if we've already determined we are in a MiniApp
+  if (cachedIsInMiniAppResult === true) {
+    return true
+  }
+
+  // Check for SSR environment - definitely not a MiniApp
+  if (typeof window === 'undefined') {
+    return false
+  }
+
+  // Short-circuit: definitely NOT a MiniApp
+  if (!window.ReactNativeWebView && window === window.parent) {
+    return false
+  }
+
+  // At this point, we MIGHT be in a MiniApp (iframe or RN WebView)
+  // but need to verify by checking for context communication.
+  const isInMiniApp = await Promise.race([
+    frameHost.context.then((context) => !!context), // Check if context resolves to truthy
+    new Promise<boolean>((resolve) => {
+      setTimeout(() => resolve(false), timeoutMs) // Timeout resolves to false
+    }),
+  ]).catch(() => {
+    return false
+  })
+
+  // Cache the result ONLY if true (we are confirmed to be in a MiniApp)
+  if (isInMiniApp) {
+    cachedIsInMiniAppResult = true
+  }
+
+  return isInMiniApp
+}
 
 export const sdk: FrameSDK = {
   ...emitter,
+  isInMiniApp,
   context: frameHost.context,
   actions: {
     setPrimaryButton: frameHost.setPrimaryButton.bind(frameHost),
     ready: frameHost.ready.bind(frameHost),
     close: frameHost.close.bind(frameHost),
     viewProfile: frameHost.viewProfile.bind(frameHost),
-    viewToken: frameHost.viewToken.bind(frameHost),
-    swap: frameHost.swap.bind(frameHost),
     signIn: async (options) => {
       const response = await frameHost.signIn(options)
       if (response.result) {
@@ -75,6 +116,11 @@ export const sdk: FrameSDK = {
       return frameHost.composeCast(options) as never
     },
   },
+  experimental: {
+    viewToken: frameHost.viewToken.bind(frameHost),
+    sendToken: frameHost.sendToken.bind(frameHost),
+    swapToken: frameHost.swapToken.bind(frameHost),
+  },
   wallet: {
     ethProvider: provider,
   },

package/src/types.ts

@@ -4,9 +4,10 @@ import type {
   Context,
   FrameNotificationDetails,
   Ready,
+  SendToken,
   SetPrimaryButtonOptions,
   SignIn,
-  Swap,
+  SwapToken,
   ViewProfile,
   ViewToken,
 } from '@farcaster/frame-core'
@@ -50,6 +51,7 @@ export type Emitter = Compute<EventEmitter<EventMap>>
 type SetPrimaryButton = (options: SetPrimaryButtonOptions) => Promise<void>
 
 export type FrameSDK = {
+  isInMiniApp: () => Promise<boolean>
   context: Promise<Context.FrameContext>
   actions: {
     ready: (options?: Partial<Ready.ReadyOptions>) => Promise<void>
@@ -59,12 +61,15 @@ export type FrameSDK = {
     addFrame: AddFrame.AddFrame
     signIn: SignIn.SignIn
     viewProfile: ViewProfile.ViewProfile
-    viewToken: ViewToken.ViewToken
-    swap: Swap.Swap
     composeCast: <close extends boolean | undefined = undefined>(
       options?: ComposeCast.Options<close>,
     ) => Promise<ComposeCast.Result<close>>
   }
+  experimental: {
+    viewToken: ViewToken.ViewToken
+    sendToken: SendToken.SendToken
+    swapToken: SwapToken.SwapToken
+  }
   wallet: {
     ethProvider: Provider.Provider
   }