@farcaster/frame-core 0.1.10 → 0.3.0

package/src/actions/SendToken.ts

@@ -1,57 +0,0 @@
-export type SendTokenOptions = {
-  /**
-   * CAIP-19 asset ID
-   * For example, Base USDC:
-   * eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
-   */
-  token?: string
-
-  /**
-   * Token amount, as numeric string.
-   * For example, 10 USDC: 1000000
-   */
-  amount?: string
-
-  /**
-   * Recipient address.
-   */
-  recipientAddress?: string
-
-  /**
-   * Recipient fid.
-   */
-  recipientFid?: number
-}
-
-type SendTokenDetails = {
-  /**
-   * Tx identifier.
-   */
-  transaction: `0x${string}`
-}
-
-type SendTokenErrorDetails = {
-  /**
-   * Error code.
-   */
-  error: string
-  /**
-   * Error message.
-   */
-  message?: string
-}
-
-export type SendTokenErrorReason = 'rejected_by_user' | 'send_failed'
-
-export type SendTokenResult =
-  | {
-      success: true
-      send: SendTokenDetails
-    }
-  | {
-      success: false
-      reason: SendTokenErrorReason
-      error?: SendTokenErrorDetails
-    }
-
-export type SendToken = (options: SendTokenOptions) => Promise<SendTokenResult>

package/src/actions/SignIn.ts

@@ -1,67 +0,0 @@
-import * as Errors from '../errors.ts'
-import type { OneOf } from '../internal/types.ts'
-
-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
-
-  /**
-   * Whether an [Auth
-   * Address](https://github.com/farcasterxyz/protocol/discussions/225) signed
-   * message is acceptable. Defaults to `false` to maintain backwards
-   * compatibility, though applications should set this to `true` for the best
-   * user experience assuming their verification method supports it.
-   *
-   * @default false
-   */
-  acceptAuthAddress?: boolean
-}
-
-export type SignInResult = {
-  signature: string
-  message: string
-
-  /**
-   * Indicates if the signature was produced by a custody or auth address.
-   */
-  authMethod: 'custody' | 'authAddress'
-}
-
-export type SignIn = (options: SignInOptions) => Promise<SignInResult>
-
-type RejectedByUserJsonError = {
-  type: 'rejected_by_user'
-}
-
-export type SignInJsonError = RejectedByUserJsonError
-
-export type SignInJsonResult = OneOf<
-  { result: SignInResult } | { error: SignInJsonError }
->
-
-export type WireSignIn = (options: SignInOptions) => Promise<SignInJsonResult>
-
-/**
- * Thrown when a sign in action was rejected.
- */
-export class RejectedByUser extends Errors.BaseError {
-  override readonly name = 'SignIn.RejectedByUser'
-
-  constructor() {
-    super('Sign in rejected by user')
-  }
-}

package/src/actions/SwapToken.ts

@@ -1,54 +0,0 @@
-export type SwapTokenOptions = {
-  /**
-   * CAIP-19 asset ID
-   * For example, Base USDC:
-   * eip155:8453/erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
-   */
-  sellToken?: string
-
-  /**
-   * CAIP-19 token ID. For example, OP ETH:
-   * eip155:10/native
-   */
-  buyToken?: string
-
-  /**
-   * Sell token amount, as numeric string.
-   * For example, 1 USDC: 1000000
-   */
-  sellAmount?: string
-}
-
-type SwapTokenDetails = {
-  /**
-   * Array of tx identifiers in order of execution.
-   * Some swaps will have both an approval and swap tx.
-   */
-  transactions: `0x${string}`[]
-}
-
-type SwapTokenErrorDetails = {
-  /**
-   * Error code.
-   */
-  error: string
-  /**
-   * Error message.
-   */
-  message?: string
-}
-
-export type SwapErrorReason = 'rejected_by_user' | 'swap_failed'
-
-export type SwapTokenResult =
-  | {
-      success: true
-      swap: SwapTokenDetails
-    }
-  | {
-      success: false
-      reason: SwapErrorReason
-      error?: SwapTokenErrorDetails
-    }
-
-export type SwapToken = (options: SwapTokenOptions) => Promise<SwapTokenResult>

package/src/actions/ViewCast.ts

@@ -1,27 +0,0 @@
-export type ViewCastOptions = {
-  /**
-   * The hash of the cast to view.
-   * @example "0x6a112e2d35e2d2008e25dd29811e8769d1edd9ca"
-   */
-  hash: string
-
-  /**
-   * Whether the app should be closed when this action is called.
-   * If true, the app will be closed after opening the cast view.
-   */
-  close?: boolean
-}
-
-/**
- * Opens a cast view in the Farcaster client.
- *
- * @example
- * ```ts
- * await sdk.actions.viewCast({
- *   hash: "0x6a112e2d35e2d2008e25dd29811e8769d1edd9ca"
- * })
- * ```
- *
- * @see {@link https://miniapps.farcaster.xyz/docs/sdk/actions/view-cast | View Cast Documentation}
- */
-export type ViewCast = (options: ViewCastOptions) => Promise<void>

package/src/actions/ViewProfile.ts

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

package/src/actions/ViewToken.ts

@@ -1,5 +0,0 @@
-export type ViewTokenOptions = {
-  token: string
-}
-
-export type ViewToken = (options: ViewTokenOptions) => Promise<void>

package/src/actions/index.ts

@@ -1,10 +0,0 @@
-export * as AddMiniApp from './AddMiniApp.ts'
-export * as ComposeCast from './ComposeCast.ts'
-export * as Haptics from './Haptics.ts'
-export * as Ready from './Ready.ts'
-export * as SignIn from './SignIn.ts'
-export * as SendToken from './SendToken.ts'
-export * as SwapToken from './SwapToken.ts'
-export * as ViewCast from './ViewCast.ts'
-export * as ViewProfile from './ViewProfile.ts'
-export * as ViewToken from './ViewToken.ts'

package/src/back.ts

@@ -1,15 +0,0 @@
-export type BackState = {
-  /**
-   * Is the back control visible. Note that on mobile devices Farcaster clients
-   * may support a gesture based control rather than button control.
-   *
-   * @default false
-   */
-  visible: boolean
-}
-
-export const DEFAULT_BACK_STATE = {
-  visible: false,
-} satisfies BackState
-
-export type UpdateBackState = (state: BackState) => Promise<void>

package/src/context.ts

@@ -1,117 +0,0 @@
-import type { FrameNotificationDetails } from './schemas/index.ts'
-
-export type MiniappUser = {
-  fid: number
-  username?: string
-  displayName?: string
-  pfpUrl?: string
-}
-
-export interface MiniappCast {
-  author: MiniappUser
-  hash: string
-  parentHash?: string
-  parentFid?: number
-  timestamp?: number
-  mentions?: MiniappUser[]
-  text: string
-  embeds?: string[]
-  channelKey?: string
-}
-
-export type CastEmbedLocationContext = {
-  type: 'cast_embed'
-  embed: string
-  cast: MiniappCast
-}
-
-export type CastShareLocationContext = {
-  type: 'cast_share'
-  cast: MiniappCast
-}
-
-export type NotificationLocationContext = {
-  type: 'notification'
-  notification: {
-    notificationId: string
-    title: string
-    body: string
-  }
-}
-
-export type LauncherLocationContext = {
-  type: 'launcher'
-}
-
-export type ChannelLocationContext = {
-  type: 'channel'
-  channel: {
-    /**
-     * Channel key identifier
-     */
-    key: string
-
-    /**
-     * Channel name
-     */
-    name: string
-
-    /**
-     * Channel profile image URL
-     */
-    imageUrl?: string
-  }
-}
-
-export type LocationContext =
-  | CastEmbedLocationContext
-  | CastShareLocationContext
-  | NotificationLocationContext
-  | LauncherLocationContext
-  | ChannelLocationContext
-
-export type AccountLocation = {
-  placeId: string
-
-  /**
-   * Human-readable string describing the location
-   */
-  description: string
-}
-
-export type UserContext = {
-  fid: number
-  username?: string
-  displayName?: string
-
-  /**
-   * Profile image URL
-   */
-  pfpUrl?: string
-  location?: AccountLocation
-}
-
-export type SafeAreaInsets = {
-  top: number
-  bottom: number
-  left: number
-  right: number
-}
-
-export type ClientContext = {
-  clientFid: number
-  added: boolean
-  notificationDetails?: FrameNotificationDetails
-  safeAreaInsets?: SafeAreaInsets
-}
-
-export type ClientFeatures = {
-  haptics: boolean
-}
-
-export type FrameContext = {
-  client: ClientContext
-  user: UserContext
-  location?: LocationContext
-  features?: ClientFeatures
-}

package/src/errors.ts

@@ -1,21 +0,0 @@
-export type GlobalErrorType<name extends string = 'Error'> = Error & {
-  name: name
-}
-
-export class BaseError<
-  cause extends Error | undefined = undefined,
-> extends Error {
-  override name = 'BaseError'
-  cause: cause
-
-  constructor(message: string, options: BaseError.Options<cause> = {}) {
-    super(message, options.cause ? { cause: options.cause } : undefined)
-    this.cause = options.cause as any
-  }
-}
-
-export declare namespace BaseError {
-  type Options<cause extends Error | undefined = Error | undefined> = {
-    cause?: cause | undefined
-  }
-}

package/src/internal/types.ts

@@ -1,20 +0,0 @@
-type Compute<type> = { [key in keyof type]: type[key] } & unknown
-
-type KeyofUnion<type> = type extends type ? keyof type : never
-
-export type OneOf<
-  union extends object,
-  fallback extends object | undefined = undefined,
-  ///
-  keys extends KeyofUnion<union> = KeyofUnion<union>,
-> = union extends infer item
-  ? Compute<
-      item & {
-        [key in Exclude<keys, keyof item>]?: fallback extends object
-          ? key extends keyof fallback
-            ? fallback[key]
-            : undefined
-          : undefined
-      }
-    >
-  : never

package/src/manifest.ts

@@ -1,113 +0,0 @@
-/**
- * Farcaster manifest for a domain hosted at `/.well-known/farcaster.json`
- */
-export type Manifest = {
-  accountAssociation: AccountAssociation
-  frame: FrameConfig
-}
-
-/**
- * Signed domain association linking this frame to a Farcaster account
- *
- * A DomainAssociation can be generated using the {@link https://farcaster.xyz/~/developers/domains | Warpcast
- * Domains Developer} tool.
- */
-export type AccountAssociation = {
-  /**
-   * Base64URL encoded JFS signature
-   */
-  header: string
-
-  /**
-   * Base64URL encoded payload signature
-   */
-  payload: string
-
-  /**
-   * Base64URL encoded signature
-   */
-  signature: string
-}
-
-/**
- * Frame configuration
- *
- * @example
- * ``ts
- * const frame: FrameConfig = {
- *   version: '1',
- *   name: 'Yoink!',
- *   homeUrl: 'https://yoink.party',
- *   iconUrl: 'https://yoink.party/img/icon.png',
- *   imageUrl: 'https://yoink.party/framesV2/opengraph-image',
- *   buttonTitle: '🚩 Start',
- *   splashImageUrl: 'https://yoink.party/img/splash.png',
- *   splashImageBackgroundColor: '#eeeee4',
- *   webhookUrl: 'https://yoink.party/webhook'
- * };
- * ``
- */
-export type FrameConfig = {
-  /**
-   * Manifest version
-   *
-   * Must be the literal '1'.
-   */
-  version: '1'
-
-  /**
-   * App name that will be displayed to users
-   *
-   * Max length of 32 characters.
-   */
-  name: string
-
-  /**
-   * Default launch URL
-   *
-   * Max length of 1024 characters.
-   */
-  homeUrl: string
-
-  /**
-   * Icon URL
-   *
-   * Max length of 1024 characters. Image must be 200x200px and less than 1MB.
-   */
-  iconUrl: string
-
-  /**
-   * Image URL
-   *
-   * Max length of 1024 characters. Image must have a 3:2 ratio.
-   */
-  imageUrl: string
-
-  /**
-   * Default button title to use when frame is rendered.
-   *
-   * Max length of 32 characters.
-   */
-  buttonTitle: string
-
-  /**
-   * Splash image URL
-   *
-   * Max length of 1024 characters. Image must be 200x200px and less than 1MB.
-   */
-  splashImageUrl?: string
-
-  /**
-   * Splash background color
-   *
-   * Must be a hex color code.
-   */
-  splashBackgroundColor?: string
-
-  /**
-   * URL to which clients will POST server events.
-   * Max length of 1024 characters.
-   * Required if the frame application uses notifications.
-   */
-  webhookUrl?: string
-}

package/src/schemas/embeds.ts

@@ -1,44 +0,0 @@
-import { z } from 'zod'
-import {
-  aspectRatioSchema,
-  buttonTitleSchema,
-  caip19TokenSchema,
-  frameNameSchema,
-  hexColorSchema,
-  secureUrlSchema,
-} from './shared.ts'
-
-export const actionLaunchFrameSchema = z.object({
-  type: z.literal('launch_frame'),
-  name: frameNameSchema,
-  url: secureUrlSchema.optional(),
-  splashImageUrl: secureUrlSchema.optional(),
-  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({
-  title: buttonTitleSchema,
-  action: actionSchema,
-})
-
-export const frameEmbedNextSchema = z.object({
-  version: z.literal('next'),
-  imageUrl: secureUrlSchema,
-  aspectRatio: aspectRatioSchema.optional(),
-  button: buttonSchema,
-})
-
-export const safeParseFrameEmbed = (rawResponse: unknown) =>
-  frameEmbedNextSchema.safeParse(rawResponse)
-
-export type FrameEmbedNext = z.infer<typeof frameEmbedNextSchema>

package/src/schemas/events.ts

@@ -1,41 +0,0 @@
-import { z } from 'zod'
-import { notificationDetailsSchema } from './notifications.ts'
-
-export const eventFrameAddedSchema = z.object({
-  event: z.literal('frame_added'),
-  notificationDetails: notificationDetailsSchema.optional(),
-})
-
-export type EventFrameAdded = z.infer<typeof eventFrameAddedSchema>
-
-export const eventFrameRemovedSchema = z.object({
-  event: z.literal('frame_removed'),
-})
-
-export type EventFrameRemoved = z.infer<typeof eventFrameRemovedSchema>
-
-export const eventNotificationsEnabledSchema = z.object({
-  event: z.literal('notifications_enabled'),
-  notificationDetails: notificationDetailsSchema.required(),
-})
-
-export type EventNotificationsEnabled = z.infer<
-  typeof eventNotificationsEnabledSchema
->
-
-export const notificationsDisabledSchema = z.object({
-  event: z.literal('notifications_disabled'),
-})
-
-export type EventNotificationsDisabled = z.infer<
-  typeof notificationsDisabledSchema
->
-
-export const serverEventSchema = z.discriminatedUnion('event', [
-  eventFrameAddedSchema,
-  eventFrameRemovedSchema,
-  eventNotificationsEnabledSchema,
-  notificationsDisabledSchema,
-])
-
-export type FrameServerEvent = z.infer<typeof serverEventSchema>

package/src/schemas/index.ts

@@ -1,5 +0,0 @@
-export * from './embeds.ts'
-export * from './events.ts'
-export * from './shared.ts'
-export * from './manifest.ts'
-export * from './notifications.ts'