@farcaster/snap 1.20.0 → 1.21.0

package/dist/react/components/action-button.js

@@ -10,9 +10,9 @@ function isExternalLinkAction(on) {
     if (!on)
         return false;
     const press = on.press;
-    if (!press || press.action !== "open_url")
+    if (!press)
         return false;
-    return press.params?.isSnap !== true;
+    return press.action === "open_url";
 }
 export function SnapActionButton({ element, emit, }) {
     const { props } = element;

package/dist/react/index.d.ts

@@ -15,6 +15,7 @@ export type SnapPage = {
 export type SnapActionHandlers = {
     submit: (target: string, inputs: Record<string, JsonValue>) => void;
     open_url: (target: string) => void;
+    open_snap: (target: string) => void;
     open_mini_app: (target: string) => void;
     view_cast: (params: {
         hash: string;

package/dist/react-native/components/snap-action-button.js

@@ -8,9 +8,9 @@ function isExternalLinkAction(on) {
     if (!on)
         return false;
     const press = on.press;
-    if (!press || press.action !== "open_url")
+    if (!press)
         return false;
-    return press.params?.isSnap !== true;
+    return press.action === "open_url";
 }
 export function SnapActionButton({ element, emit, }) {
     const { accentHex } = useSnapPalette();

package/dist/react-native/types.d.ts

@@ -13,6 +13,7 @@ export type SnapPage = {
 export type SnapActionHandlers = {
     submit: (target: string, inputs: Record<string, JsonValue>) => void;
     open_url: (target: string) => void;
+    open_snap: (target: string) => void;
     open_mini_app: (target: string) => void;
     view_cast: (params: {
         hash: string;

package/dist/ui/catalog.d.ts

@@ -420,6 +420,12 @@ export declare const snapJsonRenderCatalog: import("@json-render/core").Catalog<
                 target: z.ZodString;
             }, z.core.$strip>;
         };
+        open_snap: {
+            description: string;
+            params: z.ZodObject<{
+                target: z.ZodString;
+            }, z.core.$strip>;
+        };
         open_mini_app: {
             description: string;
             params: z.ZodObject<{

package/dist/ui/catalog.js

@@ -99,10 +99,12 @@ export const snapJsonRenderCatalog = defineCatalog(snapJsonRenderSchema, {
             params: z.object({ target: z.string() }),
         },
         open_url: {
-            description: "Open URL in browser.",
-            params: z.object({
-                target: z.string(),
-            }),
+            description: "Open external URL in browser.",
+            params: z.object({ target: z.string() }),
+        },
+        open_snap: {
+            description: "Open a snap URL inline. The client renders the target as a snap rather than opening a browser.",
+            params: z.object({ target: z.string() }),
         },
         open_mini_app: {
             description: "Open target URL as a Farcaster mini app.",

package/llms.txt

@@ -153,14 +153,15 @@ Field values are sent in POST `inputs[name]` when a `submit` action fires.
 - `label` (string, optional, max 60)
 - POST value: string (single) or string[] (multiple)
 
-## Actions (9 types)
+## Actions (10 types)
 
 Bound to buttons via `on.press`:
 
 | Action | Params | Description |
 |--------|--------|-------------|
 | `submit` | `target` (URL) | POST to server, get next page |
-| `open_url` | `target` (URL) | Open in system browser |
+| `open_url` | `target` (URL) | Open external URL in browser |
+| `open_snap` | `target` (URL) | Open a snap URL inline |
 | `open_mini_app` | `target` (URL) | Open as Farcaster mini app |
 | `view_cast` | `hash` (string) | Navigate to a cast |
 | `view_profile` | `fid` (number) | Navigate to a profile |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farcaster/snap",
-  "version": "1.20.0",
+  "version": "1.21.0",
   "description": "Farcaster Snaps 🫰",
   "repository": {
     "type": "git",

package/src/react/components/action-button.tsx

@@ -14,8 +14,8 @@ function isExternalLinkAction(
   const press = on.press as
     | { action?: string; params?: Record<string, unknown> }
     | undefined;
-  if (!press || press.action !== "open_url") return false;
-  return press.params?.isSnap !== true;
+  if (!press) return false;
+  return press.action === "open_url";
 }
 
 export function SnapActionButton({

package/src/react/index.tsx

@@ -27,6 +27,7 @@ export type SnapPage = {
 export type SnapActionHandlers = {
   submit: (target: string, inputs: Record<string, JsonValue>) => void;
   open_url: (target: string) => void;
+  open_snap: (target: string) => void;
   open_mini_app: (target: string) => void;
   view_cast: (params: { hash: string }) => void;
   view_profile: (params: { fid: number }) => void;

package/src/react-native/components/snap-action-button.tsx

@@ -14,8 +14,8 @@ function isExternalLinkAction(
   const press = on.press as
     | { action?: string; params?: Record<string, unknown> }
     | undefined;
-  if (!press || press.action !== "open_url") return false;
-  return press.params?.isSnap !== true;
+  if (!press) return false;
+  return press.action === "open_url";
 }
 
 export function SnapActionButton({

package/src/react-native/types.ts

@@ -18,6 +18,7 @@ export type SnapPage = {
 export type SnapActionHandlers = {
   submit: (target: string, inputs: Record<string, JsonValue>) => void;
   open_url: (target: string) => void;
+  open_snap: (target: string) => void;
   open_mini_app: (target: string) => void;
   view_cast: (params: { hash: string }) => void;
   view_profile: (params: { fid: number }) => void;

package/src/ui/catalog.ts

@@ -117,10 +117,12 @@ export const snapJsonRenderCatalog = defineCatalog(snapJsonRenderSchema, {
       params: z.object({ target: z.string() }),
     },
     open_url: {
-      description: "Open URL in browser.",
-      params: z.object({
-        target: z.string(),
-      }),
+      description: "Open external URL in browser.",
+      params: z.object({ target: z.string() }),
+    },
+    open_snap: {
+      description: "Open a snap URL inline. The client renders the target as a snap rather than opening a browser.",
+      params: z.object({ target: z.string() }),
     },
     open_mini_app: {
       description: "Open target URL as a Farcaster mini app.",