@farcaster/frame-core 0.0.29 → 0.0.32

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { AddFrame, Ready, SignIn, Swap, ViewProfile, ViewToken } from './actions';
+import type { AddFrame, ComposeCast, Ready, SignIn, Swap, ViewProfile, ViewToken } from './actions';
 import type { FrameContext } from './context';
 import type { EventFrameAdded, EventFrameRemoved, EventNotificationsDisabled, EventNotificationsEnabled } from './schemas';
 import type { Ethereum } from './wallet';
@@ -26,6 +26,7 @@ export type WireFrameHost = {
     viewProfile: ViewProfile.ViewProfile;
     viewToken: ViewToken.ViewToken;
     swap: Swap.Swap;
+    composeCast: <close extends boolean | undefined = undefined>(options: ComposeCast.Options<close>) => Promise<ComposeCast.Result<close>>;
 };
 export type FrameHost = {
     context: FrameContext;
@@ -45,6 +46,7 @@ export type FrameHost = {
     viewProfile: ViewProfile.ViewProfile;
     viewToken: ViewToken.ViewToken;
     swap: Swap.Swap;
+    composeCast: <close extends boolean | undefined = undefined>(options: ComposeCast.Options<close>) => Promise<ComposeCast.Result<close>>;
 };
 export type EventFrameAddRejected = {
     event: 'frame_add_rejected';

package/dist/wallet/ethereum.d.ts

@@ -1,4 +1,8 @@
-import type { Address, Provider, RpcRequest, RpcResponse, RpcSchema } from 'ox';
+import type * as Address from 'ox/Address';
+import type * as Provider from 'ox/Provider';
+import type * as RpcRequest from 'ox/RpcRequest';
+import type * as RpcResponse from 'ox/RpcResponse';
+import type * as RpcSchema from 'ox/RpcSchema';
 export type EthProvideRequest<schema extends RpcSchema.Generic = RpcSchema.Default> = Provider.RequestFn<schema>;
 export type FrameEthProviderEventData = {
     type: 'frame_eth_provider_event';

package/esm/actions/AddFrame.d.ts

@@ -1,40 +1,36 @@
-import * as Errors from '../errors'
-import type { OneOf } from '../internal/types'
-import type { FrameNotificationDetails } from '../schemas'
+import * as Errors from '../errors';
+import type { OneOf } from '../internal/types';
+import type { FrameNotificationDetails } from '../schemas';
 export type AddFrameResult = {
-  notificationDetails?: FrameNotificationDetails
-}
-export type AddFrame = () => Promise<AddFrameResult>
+    notificationDetails?: FrameNotificationDetails;
+};
+export type AddFrame = () => Promise<AddFrameResult>;
 type InvalidDomainManifestJsonError = {
-  type: 'invalid_domain_manifest'
-}
+    type: 'invalid_domain_manifest';
+};
 type RejectedByUserJsonError = {
-  type: 'rejected_by_user'
-}
-export type AddFrameJsonError =
-  | InvalidDomainManifestJsonError
-  | RejectedByUserJsonError
-export type AddFrameRejectedReason = AddFrameJsonError['type']
-export type AddFrameJsonResult = OneOf<
-  | {
-      result: AddFrameResult
-    }
-  | {
-      error: AddFrameJsonError
-    }
->
-export type WireAddFrame = () => Promise<AddFrameJsonResult>
+    type: 'rejected_by_user';
+};
+export type AddFrameJsonError = InvalidDomainManifestJsonError | RejectedByUserJsonError;
+export type AddFrameRejectedReason = AddFrameJsonError['type'];
+export type AddFrameJsonResult = OneOf<{
+    result: AddFrameResult;
+} | {
+    error: AddFrameJsonError;
+}>;
+export type WireAddFrame = () => Promise<AddFrameJsonResult>;
 /**
  * Thrown when the frame does not have a valid domain manifest.
  */
 export declare class InvalidDomainManifest extends Errors.BaseError {
-  readonly name = 'AddFrame.InvalidDomainManifest'
-  constructor()
+    readonly name = "AddFrame.InvalidDomainManifest";
+    constructor();
 }
 /**
  * Thrown when add frame action was rejected by the user.
  */
 export declare class RejectedByUser extends Errors.BaseError {
-  readonly name = 'AddFrame.RejectedByUser'
-  constructor()
+    readonly name = "AddFrame.RejectedByUser";
+    constructor();
 }
+export {};

package/esm/actions/AddFrame.js

@@ -1,19 +1,19 @@
-import * as Errors from '../errors'
+import * as Errors from '../errors';
 /**
  * Thrown when the frame does not have a valid domain manifest.
  */
 export class InvalidDomainManifest extends Errors.BaseError {
-  name = 'AddFrame.InvalidDomainManifest'
-  constructor() {
-    super('Invalid domain manifest')
-  }
+    name = 'AddFrame.InvalidDomainManifest';
+    constructor() {
+        super('Invalid domain manifest');
+    }
 }
 /**
  * Thrown when add frame action was rejected by the user.
  */
 export class RejectedByUser extends Errors.BaseError {
-  name = 'AddFrame.RejectedByUser'
-  constructor() {
-    super('Add frame rejected by user')
-  }
+    name = 'AddFrame.RejectedByUser';
+    constructor() {
+        super('Add frame rejected by user');
+    }
 }

package/esm/actions/ComposeCast.d.ts

@@ -0,0 +1,32 @@
+export type Options<close extends boolean | undefined = undefined> = {
+    /**
+     * Suggested text for the body of the cast.
+     *
+     * Mentions can be included using the human-writeable form (e.g. @farcaster).
+     **/
+    text?: string;
+    /** Suggested embeds. Max two. */
+    embeds?: [] | [string] | [string, string];
+    /** Suggested parent. */
+    parent?: {
+        type: 'cast';
+        hash: string;
+    };
+    /** Whether the app should be closed when this action is called. */
+    close?: close;
+};
+export type Result<close extends boolean | undefined = undefined> = close extends true ? undefined : {
+    cast: {
+        /** Cast of the created cast */
+        hash: string;
+        /** Text of the created cast */
+        text?: string;
+        /** Embeds of the created cast */
+        embeds?: [] | [string] | [string, string];
+        /** Parent of the created cast */
+        parent?: {
+            type: 'cast';
+            hash: string;
+        };
+    };
+};

package/esm/actions/ComposeCast.js

@@ -0,0 +1 @@
+export {};

package/esm/actions/Ready.d.ts

@@ -1,13 +1,13 @@
 export type ReadyOptions = {
-  /**
-   * Disable native gestures. Use this option if your frame uses gestures
-   * that conflict with native gestures.
-   *
-   * @defaultValue false
-   */
-  disableNativeGestures: boolean
-}
+    /**
+     * 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: {
-  disableNativeGestures: false
-}
-export type Ready = (options?: Partial<ReadyOptions>) => void
+    disableNativeGestures: false;
+};
+export type Ready = (options?: Partial<ReadyOptions>) => void;

package/esm/actions/Ready.js

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

package/esm/actions/SignIn.d.ts

@@ -1,43 +1,41 @@
-import * as Errors from '../errors'
-import type { OneOf } from '../internal/types'
+import * as Errors from '../errors';
+import type { OneOf } from '../internal/types';
 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 SignInResult = {
-  signature: string
-  message: string
-}
-export type SignIn = (options: SignInOptions) => Promise<SignInResult>
+    signature: string;
+    message: string;
+};
+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>
+    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 declare class RejectedByUser extends Errors.BaseError {
-  readonly name = 'SignIn.RejectedByUser'
-  constructor()
+    readonly name = "SignIn.RejectedByUser";
+    constructor();
 }
+export {};

package/esm/actions/SignIn.js

@@ -1,10 +1,10 @@
-import * as Errors from '../errors'
+import * as Errors from '../errors';
 /**
  * Thrown when a sign in action was rejected.
  */
 export class RejectedByUser extends Errors.BaseError {
-  name = 'SignIn.RejectedByUser'
-  constructor() {
-    super('Sign in rejected by user')
-  }
+    name = 'SignIn.RejectedByUser';
+    constructor() {
+        super('Sign in rejected by user');
+    }
 }

package/esm/actions/Swap.d.ts

@@ -1,47 +1,46 @@
 export type SwapOptions = {
-  /**
-   * 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, 10 USDC: 1000000
-   */
-  sellAmount?: string
-}
+    /**
+     * 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, 10 USDC: 1000000
+     */
+    sellAmount?: string;
+};
 type SwapDetails = {
-  /**
-   * Array of tx identifiers in order of execution.
-   * Some swaps will have both an approval and swap tx.
-   */
-  transactions: `0x${string}`[]
-}
+    /**
+     * Array of tx identifiers in order of execution.
+     * Some swaps will have both an approval and swap tx.
+     */
+    transactions: `0x${string}`[];
+};
 type SwapErrorDetails = {
-  /**
-   * Error code.
-   */
-  error: string
-  /**
-   * Error message.
-   */
-  message?: string
-}
-export type SwapErrorReason = 'rejected_by_user' | 'swap_failed'
-export type SwapResult =
-  | {
-      success: true
-      swap: SwapDetails
-    }
-  | {
-      success: false
-      reason: SwapErrorReason
-      error?: SwapErrorDetails
-    }
-export type Swap = (options: SwapOptions) => Promise<SwapResult>
+    /**
+     * Error code.
+     */
+    error: string;
+    /**
+     * Error message.
+     */
+    message?: string;
+};
+export type SwapErrorReason = 'rejected_by_user' | 'swap_failed';
+export type SwapResult = {
+    success: true;
+    swap: SwapDetails;
+} | {
+    success: false;
+    reason: SwapErrorReason;
+    error?: SwapErrorDetails;
+};
+export type Swap = (options: SwapOptions) => Promise<SwapResult>;
+export {};

package/esm/actions/Swap.js

@@ -1 +1 @@
-export {}
+export {};

package/esm/actions/ViewProfile.d.ts

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

package/esm/actions/ViewProfile.js

@@ -1 +1 @@
-export {}
+export {};

package/esm/actions/ViewToken.d.ts

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

package/esm/actions/ViewToken.js

@@ -1 +1 @@
-export {}
+export {};

package/esm/actions/index.d.ts

@@ -1,6 +1,7 @@
-export * as AddFrame from './AddFrame'
-export * as Ready from './Ready'
-export * as SignIn from './SignIn'
-export * as Swap from './Swap'
-export * as ViewProfile from './ViewProfile'
-export * as ViewToken from './ViewToken'
+export * as AddFrame from './AddFrame';
+export * as ComposeCast from './ComposeCast';
+export * as Ready from './Ready';
+export * as SignIn from './SignIn';
+export * as Swap from './Swap';
+export * as ViewProfile from './ViewProfile';
+export * as ViewToken from './ViewToken';

package/esm/actions/index.js

@@ -1,6 +1,7 @@
-export * as AddFrame from './AddFrame'
-export * as Ready from './Ready'
-export * as SignIn from './SignIn'
-export * as Swap from './Swap'
-export * as ViewProfile from './ViewProfile'
-export * as ViewToken from './ViewToken'
+export * as AddFrame from './AddFrame';
+export * as ComposeCast from './ComposeCast';
+export * as Ready from './Ready';
+export * as SignIn from './SignIn';
+export * as Swap from './Swap';
+export * as ViewProfile from './ViewProfile';
+export * as ViewToken from './ViewToken';

package/esm/context.d.ts

@@ -1,76 +1,72 @@
-import type { FrameNotificationDetails } from './schemas'
+import type { FrameNotificationDetails } from './schemas';
 export type CastEmbedLocationContext = {
-  type: 'cast_embed'
-  embed: string
-  cast: {
-    fid: number
-    hash: string
-  }
-}
+    type: 'cast_embed';
+    embed: string;
+    cast: {
+        fid: number;
+        hash: string;
+    };
+};
 export type NotificationLocationContext = {
-  type: 'notification'
-  notification: {
-    notificationId: string
-    title: string
-    body: string
-  }
-}
+    type: 'notification';
+    notification: {
+        notificationId: string;
+        title: string;
+        body: string;
+    };
+};
 export type LauncherLocationContext = {
-  type: 'launcher'
-}
+    type: 'launcher';
+};
 export type ChannelLocationContext = {
-  type: 'channel'
-  channel: {
-    /**
-     * Channel key identifier
-     */
-    key: string
+    type: 'channel';
+    channel: {
+        /**
+         * Channel key identifier
+         */
+        key: string;
+        /**
+         * Channel name
+         */
+        name: string;
+        /**
+         * Channel profile image URL
+         */
+        imageUrl?: string;
+    };
+};
+export type LocationContext = CastEmbedLocationContext | NotificationLocationContext | LauncherLocationContext | ChannelLocationContext;
+export type AccountLocation = {
+    placeId: string;
     /**
-     * Channel name
+     * Human-readable string describing the location
      */
-    name: string
+    description: string;
+};
+export type UserContext = {
+    fid: number;
+    username?: string;
+    displayName?: string;
     /**
-     * Channel profile image URL
+     * Profile image URL
      */
-    imageUrl?: string
-  }
-}
-export type LocationContext =
-  | CastEmbedLocationContext
-  | 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
-}
+    pfpUrl?: string;
+    location?: AccountLocation;
+};
 export type SafeAreaInsets = {
-  top: number
-  bottom: number
-  left: number
-  right: number
-}
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+};
 export type ClientContext = {
-  clientFid: number
-  added: boolean
-  notificationDetails?: FrameNotificationDetails
-  safeAreaInsets?: SafeAreaInsets
-}
+    clientFid: number;
+    added: boolean;
+    notificationDetails?: FrameNotificationDetails;
+    safeAreaInsets?: SafeAreaInsets;
+};
 export type FrameContext = {
-  client: ClientContext
-  user: UserContext
-  location?: LocationContext
-}
+    client: ClientContext;
+    user: UserContext;
+    location?: LocationContext;
+};

package/esm/context.js

@@ -1 +1 @@
-export {}
+export {};

package/esm/errors.d.ts

@@ -1,12 +1,13 @@
-export declare class BaseError<
-  cause extends Error | undefined = undefined,
-> extends Error {
-  name: string
-  cause: cause
-  constructor(message: string, options?: BaseError.Options<cause>)
+export type GlobalErrorType<name extends string = 'Error'> = Error & {
+    name: name;
+};
+export declare class BaseError<cause extends Error | undefined = undefined> extends Error {
+    name: string;
+    cause: cause;
+    constructor(message: string, options?: BaseError.Options<cause>);
 }
 export declare namespace BaseError {
-  type Options<cause extends Error | undefined = Error | undefined> = {
-    cause?: cause | undefined
-  }
+    type Options<cause extends Error | undefined = Error | undefined> = {
+        cause?: cause | undefined;
+    };
 }

package/esm/errors.js

@@ -1,8 +1,8 @@
 export class BaseError extends Error {
-  name = 'BaseError'
-  cause
-  constructor(message, options = {}) {
-    super(message, options.cause ? { cause: options.cause } : undefined)
-    this.cause = options.cause
-  }
+    name = 'BaseError';
+    cause;
+    constructor(message, options = {}) {
+        super(message, options.cause ? { cause: options.cause } : undefined);
+        this.cause = options.cause;
+    }
 }

package/esm/index.d.ts

@@ -1,5 +1,7 @@
-export * from './actions'
-export * from './wallet'
-export * as Context from './context'
-export * from './types'
-export * from './schemas'
+export * from './actions';
+export * from './wallet';
+export * as Errors from './errors';
+export * as Context from './context';
+export * as Manifest from './manifest';
+export * from './types';
+export * from './schemas';

package/esm/index.js

@@ -1,5 +1,7 @@
-export * from './actions'
-export * from './wallet'
-export * as Context from './context'
-export * from './types'
-export * from './schemas'
+export * from './actions';
+export * from './wallet';
+export * as Errors from './errors';
+export * as Context from './context';
+export * as Manifest from './manifest';
+export * from './types';
+export * from './schemas';