@farcaster/frame-core 0.0.23 → 0.0.25

package/esm/types.d.ts

@@ -1,140 +1,117 @@
-import type { Address, Provider, RpcRequest, RpcResponse, RpcSchema } from 'ox'
-import type { AddFrame, SignIn } from './actions'
-import type { FrameContext } from './context'
-import type {
-  EventFrameAdded,
-  EventFrameRemoved,
-  EventNotificationsDisabled,
-  EventNotificationsEnabled,
-} from './schemas'
+import type { Address, Provider, RpcRequest, RpcResponse, RpcSchema } from 'ox';
+import type { AddFrame, SignIn, ViewProfile } from './actions';
+import type { FrameContext } from './context';
+import type { EventFrameAdded, EventFrameRemoved, EventNotificationsDisabled, EventNotificationsEnabled } from './schemas';
 export type SetPrimaryButtonOptions = {
-  text: string
-  loading?: boolean
-  disabled?: boolean
-  hidden?: boolean
-}
-export type SetPrimaryButton = (options: SetPrimaryButtonOptions) => void
-export type EthProviderRequest = Provider.RequestFn<RpcSchema.Default>
+    text: string;
+    loading?: boolean;
+    disabled?: boolean;
+    hidden?: boolean;
+};
+export type SetPrimaryButton = (options: SetPrimaryButtonOptions) => void;
+export type EthProviderRequest = Provider.RequestFn<RpcSchema.Default>;
 export type ReadyOptions = {
-  /**
-   * Disable native gestures. Use this option if your frame uses gestures
-   * that conflict with native gestures.
-   *
-   * @defaultValue false
-   */
-  disableNativeGestures: boolean
-}
-export declare const DEFAULT_READY_OPTIONS: ReadyOptions
+    /**
+     * Disable native gestures. Use this option if your frame uses gestures
+     * that conflict with native gestures.
+     *
+     * @defaultValue false
+     */
+    disableNativeGestures: boolean;
+};
+export declare const DEFAULT_READY_OPTIONS: ReadyOptions;
 export type SignInOptions = {
-  /**
-   * A random string used to prevent replay attacks.
-   */
-  nonce: string
-  /**
-   * Start time at which the signature becomes valid.
-   * ISO 8601 datetime.
-   */
-  notBefore?: string
-  /**
-   * Expiration time at which the signature is no longer valid.
-   * ISO 8601 datetime.
-   */
-  expirationTime?: string
-}
+    /**
+     * A random string used to prevent replay attacks.
+     */
+    nonce: string;
+    /**
+     * Start time at which the signature becomes valid.
+     * ISO 8601 datetime.
+     */
+    notBefore?: string;
+    /**
+     * Expiration time at which the signature is no longer valid.
+     * ISO 8601 datetime.
+     */
+    expirationTime?: string;
+};
 export type WireFrameHost = {
-  context: FrameContext
-  close: () => void
-  ready: (options?: Partial<ReadyOptions>) => void
-  openUrl: (url: string) => void
-  signIn: SignIn.WireSignIn
-  setPrimaryButton: SetPrimaryButton
-  ethProviderRequest: EthProviderRequest
-  ethProviderRequestV2: RpcTransport
-  eip6963RequestProvider: () => void
-  addFrame: AddFrame.WireAddFrame
-}
+    context: FrameContext;
+    close: () => void;
+    ready: (options?: Partial<ReadyOptions>) => void;
+    openUrl: (url: string) => void;
+    signIn: SignIn.WireSignIn;
+    setPrimaryButton: SetPrimaryButton;
+    ethProviderRequest: EthProviderRequest;
+    ethProviderRequestV2: RpcTransport;
+    eip6963RequestProvider: () => void;
+    addFrame: AddFrame.WireAddFrame;
+    viewProfile: ViewProfile.ViewProfile;
+};
 export type FrameHost = {
-  context: FrameContext
-  close: () => void
-  ready: (options?: Partial<ReadyOptions>) => void
-  openUrl: (url: string) => void
-  signIn: SignIn.SignIn
-  setPrimaryButton: SetPrimaryButton
-  ethProviderRequest: EthProviderRequest
-  ethProviderRequestV2: RpcTransport
-  /**
-   * Receive forwarded eip6963:requestProvider events from the frame document.
-   * Hosts must emit an EventEip6963AnnounceProvider in response.
-   */
-  eip6963RequestProvider: () => void
-  addFrame: AddFrame.AddFrame
-}
+    context: FrameContext;
+    close: () => void;
+    ready: (options?: Partial<ReadyOptions>) => void;
+    openUrl: (url: string) => void;
+    signIn: SignIn.SignIn;
+    setPrimaryButton: SetPrimaryButton;
+    ethProviderRequest: EthProviderRequest;
+    ethProviderRequestV2: RpcTransport;
+    /**
+     * Receive forwarded eip6963:requestProvider events from the frame document.
+     * Hosts must emit an EventEip6963AnnounceProvider in response.
+     */
+    eip6963RequestProvider: () => void;
+    addFrame: AddFrame.AddFrame;
+    viewProfile: ViewProfile.ViewProfile;
+};
 export type FrameEthProviderEventData = {
-  type: 'frame_eth_provider_event'
-} & EthProviderWireEvent
-export type RpcTransport = (
-  request: RpcRequest.RpcRequest,
-) => Promise<RpcResponse.RpcResponse>
+    type: 'frame_eth_provider_event';
+} & EthProviderWireEvent;
+export type RpcTransport = (request: RpcRequest.RpcRequest) => Promise<RpcResponse.RpcResponse>;
 export type ProviderRpcError = {
-  code: number
-  details?: string
-  message?: string
-}
-export type EthProviderWireEvent =
-  | {
-      event: 'accountsChanged'
-      params: [readonly Address.Address[]]
-    }
-  | {
-      event: 'chainChanged'
-      params: [string]
-    }
-  | {
-      event: 'connect'
-      params: [Provider.ConnectInfo]
-    }
-  | {
-      event: 'disconnect'
-      params: [ProviderRpcError]
-    }
-  | {
-      event: 'message'
-      params: [Provider.Message]
-    }
-export type EmitEthProvider = <event extends EthProviderWireEvent['event']>(
-  event: event,
-  params: Extract<
-    EthProviderWireEvent,
-    {
-      event: event
-    }
-  >['params'],
-) => void
+    code: number;
+    details?: string;
+    message?: string;
+};
+export type EthProviderWireEvent = {
+    event: 'accountsChanged';
+    params: [readonly Address.Address[]];
+} | {
+    event: 'chainChanged';
+    params: [string];
+} | {
+    event: 'connect';
+    params: [Provider.ConnectInfo];
+} | {
+    event: 'disconnect';
+    params: [ProviderRpcError];
+} | {
+    event: 'message';
+    params: [Provider.Message];
+};
+export type EmitEthProvider = <event extends EthProviderWireEvent['event']>(event: event, params: Extract<EthProviderWireEvent, {
+    event: event;
+}>['params']) => void;
 export type EventFrameAddRejected = {
-  event: 'frame_add_rejected'
-  reason: AddFrame.AddFrameRejectedReason
-}
+    event: 'frame_add_rejected';
+    reason: AddFrame.AddFrameRejectedReason;
+};
 export type EventPrimaryButtonClicked = {
-  event: 'primary_button_clicked'
-}
+    event: 'primary_button_clicked';
+};
 /**
  * Metadata of the EIP-1193 Provider.
  */
 export interface EIP6963ProviderInfo {
-  icon: `data:image/${string}`
-  name: string
-  rdns: string
-  uuid: string
+    icon: `data:image/${string}`;
+    name: string;
+    rdns: string;
+    uuid: string;
 }
 export type EventEip6963AnnounceProvider = {
-  event: 'eip6963:announceProvider'
-  info: EIP6963ProviderInfo
-}
-export type FrameClientEvent =
-  | EventFrameAdded
-  | EventFrameAddRejected
-  | EventFrameRemoved
-  | EventNotificationsEnabled
-  | EventNotificationsDisabled
-  | EventPrimaryButtonClicked
-  | EventEip6963AnnounceProvider
+    event: 'eip6963:announceProvider';
+    info: EIP6963ProviderInfo;
+};
+export type FrameClientEvent = EventFrameAdded | EventFrameAddRejected | EventFrameRemoved | EventNotificationsEnabled | EventNotificationsDisabled | EventPrimaryButtonClicked | EventEip6963AnnounceProvider;

package/esm/types.js

@@ -1,3 +1,3 @@
 export const DEFAULT_READY_OPTIONS = {
-  disableNativeGestures: false,
-}
+    disableNativeGestures: false,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farcaster/frame-core",
-  "version": "0.0.23",
+  "version": "0.0.25",
   "main": "dist/index.js",
   "module": "esm/index.js",
   "files": [
@@ -9,7 +9,9 @@
     "src"
   ],
   "devDependencies": {
+    "@vitest/coverage-v8": "^2.1.8",
     "typescript": "^5.7.2",
+    "vitest": "^2.1.8",
     "@farcaster/tsconfig": "0.0.2"
   },
   "dependencies": {
@@ -25,6 +27,9 @@
     "build": "pnpm build:cjs & pnpm build:esm",
     "build:cjs": "tsc -p tsconfig.node.json",
     "build:esm": "tsc -p tsconfig.json",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest --coverage"
   }
 }

package/src/actions/ViewProfile.ts

@@ -0,0 +1,5 @@
+export type ViewProfileOptions = {
+  fid: number
+}
+
+export type ViewProfile = (options: ViewProfileOptions) => Promise<void>

package/src/actions/index.ts

@@ -1,2 +1,3 @@
 export * as AddFrame from './AddFrame'
+export * as ViewProfile from './ViewProfile'
 export * as SignIn from './SignIn'

package/src/schemas/embeds.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod'
 import {
   buttonTitleSchema,
+  caip19TokenSchema,
   frameNameSchema,
   hexColorSchema,
   secureUrlSchema,
@@ -14,8 +15,14 @@ export const actionLaunchFrameSchema = z.object({
   splashBackgroundColor: hexColorSchema.optional(),
 })
 
+export const actionViewTokenSchema = z.object({
+  type: z.literal('view_token'),
+  token: caip19TokenSchema,
+})
+
 export const actionSchema = z.discriminatedUnion('type', [
   actionLaunchFrameSchema,
+  actionViewTokenSchema,
 ])
 
 export const buttonSchema = z.object({

package/src/schemas/shared.ts

@@ -9,6 +9,13 @@ export const secureUrlSchema = z
 export const frameNameSchema = z.string().max(32)
 export const buttonTitleSchema = z.string().max(32)
 
+const CAIP_19_REGEX =
+  /^[-a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}\/(?:[-a-z0-9]{3,8}:[-.%a-zA-Z0-9]{1,128}(?:\/[-.%a-zA-Z0-9]{1,78})?|native)$/
+
+export const caip19TokenSchema = z
+  .string()
+  .regex(CAIP_19_REGEX, { message: 'Invalid CAIP-19 asset ID' })
+
 export const hexColorSchema = z
   .string()
   .regex(/^#([0-9A-F]{3}|[0-9A-F]{6})$/i, {

package/src/types.ts

@@ -1,5 +1,5 @@
 import type { Address, Provider, RpcRequest, RpcResponse, RpcSchema } from 'ox'
-import type { AddFrame, SignIn } from './actions'
+import type { AddFrame, SignIn, ViewProfile } from './actions'
 import type { FrameContext } from './context'
 import type {
   EventFrameAdded,
@@ -63,6 +63,7 @@ export type WireFrameHost = {
   ethProviderRequestV2: RpcTransport
   eip6963RequestProvider: () => void
   addFrame: AddFrame.WireAddFrame
+  viewProfile: ViewProfile.ViewProfile
 }
 
 export type FrameHost = {
@@ -80,6 +81,7 @@ export type FrameHost = {
    */
   eip6963RequestProvider: () => void
   addFrame: AddFrame.AddFrame
+  viewProfile: ViewProfile.ViewProfile
 }
 
 export type FrameEthProviderEventData = {