@frak-labs/core-sdk 0.0.7 → 0.0.8

package/dist/context-rDsQbSgB.d.ts

@@ -1,813 +0,0 @@
-import { Address, Hex, RpcSchema } from 'viem';
-import { Prettify } from 'viem/chains';
-import { SiweMessage } from 'viem/siwe';
-import { P as PreparedInteraction, a as SendInteractionReturnType } from './interaction-CTQ5-kqe.js';
-
-/**
- * Configuration for the Nexus Wallet SDK
- */
-type FrakWalletSdkConfig = {
-    /**
-     * The Frak wallet url
-     * @defaultValue "https://wallet.frak.id"
-     */
-    walletUrl?: string;
-    /**
-     * Some metadata about your implementation of the Frak SDK
-     */
-    metadata: {
-        /**
-         * Your application name (will be displayed in a few modals and in SSO)
-         */
-        name: string;
-        /**
-         * Custom CSS styles to apply to the modals and components
-         */
-        css?: string;
-    };
-    /**
-     * The domain name of your application
-     * @defaultValue window.location.host
-     */
-    domain?: string;
-};
-
-/**
- * Event related to the iframe lifecycle
- * @ignore
- */
-type IFrameLifecycleEvent = {
-    iframeLifecycle: "connected" | "show" | "hide";
-    data?: never;
-} | DoBackupEvent | RemoveBackupEvent | HandshakeRequestEvent;
-type DoBackupEvent = {
-    iframeLifecycle: "do-backup";
-    data: {
-        backup?: string;
-    };
-};
-type RemoveBackupEvent = {
-    iframeLifecycle: "remove-backup";
-};
-type HandshakeRequestEvent = {
-    iframeLifecycle: "handshake";
-    data: {
-        token: string;
-    };
-};
-
-/**
- * Event related to the iframe lifecycle
- * @ignore
- */
-type ClientLifecycleEvent = CustomCssEvent | RestoreBackupEvent | HearbeatEvent | HandshakeResponse;
-type CustomCssEvent = {
-    clientLifecycle: "modal-css";
-    data: {
-        cssLink: string;
-    };
-};
-type RestoreBackupEvent = {
-    clientLifecycle: "restore-backup";
-    data: {
-        backup: string;
-    };
-};
-type HearbeatEvent = {
-    clientLifecycle: "heartbeat";
-};
-type HandshakeResponse = {
-    clientLifecycle: "handshake-response";
-    data: {
-        token: string;
-        currentUrl: string;
-    };
-};
-
-/**
- * The final keys for each interaction types (e.g. `openArticle`) -> interaction type
- * @inline
- */
-type InteractionTypesKey = {
-    [K in keyof typeof interactionTypes]: keyof (typeof interactionTypes)[K];
-}[keyof typeof interactionTypes];
-/**
- * The keys for each interaction types (e.g. `press.openArticle`) -> category_type.interaction_type
- * @inline
- */
-type FullInteractionTypesKey = {
-    [Category in keyof typeof interactionTypes]: `${Category & string}.${keyof (typeof interactionTypes)[Category] & string}`;
-}[keyof typeof interactionTypes];
-/**
- * Each interactions types according to the product types
- */
-declare const interactionTypes: {
-    readonly press: {
-        readonly openArticle: "0xc0a24ffb";
-        readonly readArticle: "0xd5bd0fbe";
-    };
-    readonly dapp: {
-        readonly proofVerifiableStorageUpdate: "0x2ab2aeef";
-        readonly callableVerifiableStorageUpdate: "0xa07da986";
-    };
-    readonly webshop: {
-        readonly open: "0xb311798f";
-    };
-    readonly referral: {
-        readonly referred: "0x010cc3b9";
-        readonly createLink: "0xb2c0f17c";
-    };
-    readonly purchase: {
-        readonly started: "0xd87e90c3";
-        readonly completed: "0x8403aeb4";
-        readonly unsafeCompleted: "0x4d5b14e0";
-    };
-    readonly retail: {
-        readonly customerMeeting: "0x74489004";
-    };
-};
-
-/**
- * SSO Metadata
- */
-type SsoMetadata = {
-    /**
-     * URL to your client, if provided will be displayed in the SSO header
-     */
-    logoUrl?: string;
-    /**
-     * Link to your homepage, if referenced your app name will contain a link on the sso page
-     */
-    homepageLink?: string;
-};
-/**
- * Params to start a SSO
- * @group RPC Schema
- */
-type OpenSsoParamsType = {
-    /**
-     * Redirect URL after the SSO (optional)
-     */
-    redirectUrl?: string;
-    /**
-     * If the SSO should directly exit after completion
-     * @defaultValue true
-     */
-    directExit?: boolean;
-    /**
-     * Language of the SSO page (optional)
-     * It will default to the current user language (or "en" if unsupported language)
-     */
-    lang?: "en" | "fr";
-    /**
-     * Custom SSO metadata
-     */
-    metadata: SsoMetadata;
-};
-
-/**
- * Represent a generic modal step type
- * @ignore
- * @inline
- */
-type GenericModalStepType<TKey, TParams, TReturns> = {
-    key: TKey;
-    params: TParams extends never ? ModalStepMetadata : ModalStepMetadata & TParams;
-    returns: TReturns;
-};
-/**
- * Metadata that can be used to customise a modal step
- * @group Modal Display
- */
-type ModalStepMetadata = {
-    metadata?: {
-        /**
-         * Custom title for the step
-         * If none provided, it will use an internationalised text
-         */
-        title?: string;
-        /**
-         * Custom description for the step
-         * If none provided, it will use an internationalised text
-         */
-        description?: string;
-        /**
-         * Custom text for the primary action of the step
-         * If none provided, it will use an internationalised text
-         */
-        primaryActionText?: string;
-        /**
-         * Custom text for the secondary action of the step
-         * If none provided, it will use an internationalised text
-         */
-        secondaryActionText?: string;
-    };
-};
-
-/** @inline */
-type LoginWithSso = {
-    allowSso: true;
-    ssoMetadata: SsoMetadata;
-};
-/** @inline */
-type LoginWithoutSso = {
-    allowSso?: false;
-    ssoMetadata?: never;
-};
-/**
- * The login step for a Modal
- *
- * **Input**: Do we allow SSO or not? Is yes then the SSO metadata
- * **Output**: The logged in wallet address
- *
- * @group Modal Display
- */
-type LoginModalStepType = GenericModalStepType<"login", LoginWithSso | LoginWithoutSso, {
-    wallet: Address;
-}>;
-
-/**
- * Parameters used send a SIWE rpc request
- */
-type SiweAuthenticationParams = Omit<SiweMessage, "address" | "chainId" | "expirationTime" | "issuedAt" | "notBefore"> & {
-    expirationTimeTimestamp?: number;
-    notBeforeTimestamp?: number;
-};
-/**
- * Return type of the Siwe transaction rpc request
- * @inline
- */
-type SiweAuthenticateReturnType = {
-    signature: Hex;
-    message: string;
-};
-/**
- * The SIWE authentication step for a Modal
- *
- * **Input**: SIWE message parameters
- * **Output**: SIWE result (message signed and wallet signature)
- *
- * @group Modal Display
- */
-type SiweAuthenticateModalStepType = GenericModalStepType<"siweAuthenticate", {
-    siwe: SiweAuthenticationParams;
-}, SiweAuthenticateReturnType>;
-
-/**
- * Generic format representing a tx to be sent
- */
-type SendTransactionTxType = {
-    to: Address;
-    data?: Hex;
-    value?: Hex;
-};
-/**
- * Return type of the send transaction rpc request
- * @inline
- */
-type SendTransactionReturnType = {
-    hash: Hex;
-};
-/**
- * The send transaction step for a Modal
- *
- * **Input**: Either a single tx or an array of tx to be sent
- * **Output**: The hash of the tx(s) hash (in case of multiple tx, still returns a single hash because it's bundled on the wallet level)
- *
- * @group Modal Display
- */
-type SendTransactionModalStepType = GenericModalStepType<"sendTransaction", {
-    tx: SendTransactionTxType | SendTransactionTxType[];
-}, SendTransactionReturnType>;
-
-/**
- * Return type of the open session modal step
- * @inline
- * @ignore
- */
-type OpenInteractionSessionReturnType = {
-    startTimestamp: number;
-    endTimestamp: number;
-};
-/**
- * The open interaction session step for a Modal
- *
- * **Input**: None
- * **Output**: The interactions session period (start and end timestamp)
- *
- * @group Modal Display
- */
-type OpenInteractionSessionModalStepType = GenericModalStepType<"openSession", object, OpenInteractionSessionReturnType>;
-
-/**
- * The final modal step type, could be used to display sharing options or a success reward screen.
- *
- * **Input**: What type final step to display?
- * **Output**: None
- *
- * @group Modal Display
- */
-type FinalModalStepType = GenericModalStepType<"final", {
-    dismissedMetadata?: ModalStepMetadata["metadata"];
-    action: FinalActionType;
-    autoSkip?: boolean;
-}, object>;
-/**
- * The different types of final actions we can display in the final step
- * @group Modal Display
- */
-type FinalActionType = {
-    key: "sharing";
-    options?: {
-        popupTitle?: string;
-        text?: string;
-        link?: string;
-    };
-} | {
-    key: "reward";
-    options?: never;
-};
-
-/**
- * Generic type of steps we will display in the modal to the end user
- * @group Modal Display
- */
-type ModalStepTypes = LoginModalStepType | SiweAuthenticateModalStepType | SendTransactionModalStepType | OpenInteractionSessionModalStepType | FinalModalStepType;
-/**
- * Type for the result of a modal request
- * Just the `returns` type of each `ModalStepTypes`
- * @typeParam T - The list of modal steps we expect to have in the modal
- * @group Modal Display
- * @group RPC Schema
- */
-type ModalRpcStepsResultType<T extends ModalStepTypes[] = ModalStepTypes[]> = {
-    [K in T[number]["key"]]: Extract<T[number], {
-        key: K;
-    }>["returns"];
-};
-/**
- * Type for the RPC input of a modal
- * Just the `params` type of each `ModalStepTypes`
- * @typeParam T - The list of modal steps we expect to have in the modal
- * @group Modal Display
- * @group RPC Schema
- */
-type ModalRpcStepsInput<T extends ModalStepTypes[] = ModalStepTypes[]> = {
-    [K in T[number]["key"]]?: Extract<T[number], {
-        key: K;
-    }>["params"];
-};
-/**
- * RPC metadata for the modal, used on top level modal configuration
- * @group Modal Display
- * @group RPC Schema
- */
-type ModalRpcMetadata = {
-    header?: {
-        title?: string;
-        icon?: string;
-    };
-    context?: string;
-    lang?: "en" | "fr";
-    targetInteraction?: FullInteractionTypesKey;
-} & ({
-    isDismissible: true;
-    dismissActionTxt?: string;
-} | {
-    isDismissible?: false;
-    dismissActionTxt?: never;
-});
-/**
- * Params used to display a modal
- * @typeParam T - The list of modal steps we expect to have in the modal
- * @group Modal Display
- */
-type DisplayModalParamsType<T extends ModalStepTypes[]> = {
-    steps: ModalRpcStepsInput<T>;
-    metadata?: ModalRpcMetadata;
-};
-
-/**
- * The different type of action we can have on the embeded view (once the user is logged in)
- *
- * @group Embeded wallet
- */
-type EmbededViewAction = {
-    key: "sharing";
-    /**
-     * Some sharing options
-     */
-    options?: {
-        /**
-         * The title that will be displayed on the system popup once the system sharing window is open
-         */
-        popupTitle?: string;
-        /**
-         * The text that will be shared alongside the link.
-         * Can contain the variable {LINK} to specify where the link is placed, otherwise it will be added at the end
-         */
-        text?: string;
-        /**
-         * The link to be shared (will be suffixed with the Frak sharing context)
-         */
-        link?: string;
-    };
-};
-/**
- * Some configuration options for the embeded view
- *
- * @group Embeded wallet
- */
-type LoggedInEmbededView = {
-    /**
-     * The main action to display on the logged in embeded view
-     *  If none specified, the user will see his wallet with the activation button
-     */
-    action?: EmbededViewAction;
-};
-
-/**
- * The view when a user is logged out
- * @group Embeded wallet
- */
-type LoggedOutEmbededView = {
-    /**
-     * Metadata option when displaying the embeded view
-     */
-    metadata?: {
-        /**
-         * The main CTA for the logged out view
-         *  - can include some variable, available ones are:
-         *      - {REWARD} -> The maximum reward a user can receive when itneracting on your website
-         *  - can be formatted in markdown
-         *
-         * If not sert, it will default to a internalised message
-         */
-        text?: string;
-        /**
-         * The text that will be displayed on the login button
-         *
-         * If not set, it will default to a internalised message
-         */
-        buttonText?: string;
-    };
-};
-
-/**
- * The params used to display the embeded wallet
- *
- * @group Embeded wallet
- */
-type DisplayEmbededWalletParamsType = {
-    /**
-     * The embeded view to display once the user is logged in
-     */
-    loggedIn?: LoggedInEmbededView;
-    /**
-     * The embeded view to display once the user is logged out
-     */
-    loggedOut?: LoggedOutEmbededView;
-    /**
-     * Some metadata to customise the embeded view
-     */
-    metadata?: {
-        /**
-         * Language of the embeded wallet
-         * If undefined, will default to the browser language
-         */
-        lang?: "fr" | "en";
-        /**
-         * The logo to display on the embeded wallet
-         * If undefined, will default to no logo displayed
-         */
-        logo?: string;
-        /**
-         * Link to the homepage of the calling website
-         * If unedfined, will default to the domain of the calling website
-         */
-        homepageLink?: string;
-        /**
-         * The target interaction behind this modal
-         */
-        targetInteraction?: FullInteractionTypesKey;
-        /**
-         * The position of the component
-         */
-        position?: "left" | "right";
-    };
-};
-
-/**
- * The keys for each product types
- * @inline
- */
-type ProductTypesKey = keyof typeof productTypes;
-/**
- * List of the product types per denominator
- */
-declare const productTypes: {
-    dapp: number;
-    press: number;
-    webshop: number;
-    retail: number;
-    referral: number;
-    purchase: number;
-};
-/**
- * Bitmask for each product types
- */
-declare const productTypesMask: Record<ProductTypesKey, bigint>;
-
-/**
- * Response of the `frak_getProductInformation` RPC method
- * @group RPC Schema
- */
-type GetProductInformationReturnType = {
-    /**
-     * Current product id
-     */
-    id: Hex;
-    /**
-     * Some metadata
-     */
-    onChainMetadata: {
-        /**
-         * Name of the product on-chain
-         */
-        name: string;
-        /**
-         * Domain of the product on-chain
-         */
-        domain: string;
-        /**
-         * The supported product types
-         */
-        productTypes: ProductTypesKey[];
-    };
-    /**
-     * The max potential reward in EUR for the given product
-     */
-    estimatedEurReward?: string;
-    /**
-     * List of all the potentials reward arround this product
-     */
-    rewards: {
-        token: Address;
-        campaign: Address;
-        interactionTypeKey: FullInteractionTypesKey;
-        referrer: {
-            amount: number;
-            eurAmount: number;
-            usdAmount: number;
-        };
-        referee: {
-            amount: number;
-            eurAmount: number;
-            usdAmount: number;
-        };
-    }[];
-};
-
-/**
- * RPC Response for the method `frak_listenToWalletStatus`
- * @group RPC Schema
- */
-type WalletStatusReturnType = WalletConnected | WalletNotConnected;
-/**
- * @ignore
- * @inline
- */
-type WalletConnected = {
-    key: "connected";
-    wallet: Address;
-    interactionToken?: string;
-    interactionSession?: {
-        startTimestamp: number;
-        endTimestamp: number;
-    };
-};
-/**
- * @ignore
- * @inline
- */
-type WalletNotConnected = {
-    key: "not-connected";
-    wallet?: never;
-    interactionToken?: never;
-    interactionSession?: never;
-};
-
-/**
- * RPC interface that's used for the iframe communication
- *
- * Define all the methods available within the iFrame RPC client
- *
- * @group RPC Schema
- *
- * @remarks
- * Here is the list of methods available:
- *
- * ### frak_listenToWalletStatus
- *  - Params: None
- *  - Returns: {@link WalletStatusReturnType}
- *
- * ### frak_displayModal
- * - Params: [{@link ModalRpcStepsInput}, name: string, metadata?: {@link ModalRpcMetadata}]
- * - Returns: {@link ModalRpcStepsResultType}
- *
- * ### frak_sendInteraction
- *  - Params: [productId: Hex, interaction: {@link PreparedInteraction}, signature?: Hex]
- *  - Returns: {@link SendInteractionReturnType}
- *
- * ### frak_sso
- *  - Params [params: {@link OpenSsoParamsType}, name: string, customCss?: string]
- *  - Returns: undefined
- *
- *  ### frak_getProductInformation
- *  - Params: None
- *  - Returns: {@link GetProductInformationReturnType}
- *
- * ### frak_displayEmbededWallet
- * - Params: [{@link DisplayEmbededWalletParamsType}]
- * - Returns: undefined
- */
-type IFrameRpcSchema = [
-    /**
-     * Method used to listen to the wallet status
-     */
-    {
-        Method: "frak_listenToWalletStatus";
-        Parameters?: undefined;
-        ReturnType: WalletStatusReturnType;
-    },
-    /**
-     * Method to display a modal with the provided steps
-     */
-    {
-        Method: "frak_displayModal";
-        Parameters: [
-            requests: ModalRpcStepsInput,
-            name: string,
-            metadata?: ModalRpcMetadata
-        ];
-        ReturnType: ModalRpcStepsResultType;
-    },
-    /**
-     * Method to transmit a user interaction
-     */
-    {
-        Method: "frak_sendInteraction";
-        Parameters: [
-            productId: Hex,
-            interaction: PreparedInteraction,
-            signature?: Hex
-        ];
-        ReturnType: SendInteractionReturnType;
-    },
-    /**
-     * Method to start a SSO
-     *  todo: Should also support direct tracking via a consumeKey
-     */
-    {
-        Method: "frak_sso";
-        Parameters: [
-            params: OpenSsoParamsType,
-            name: string,
-            customCss?: string
-        ];
-        ReturnType: undefined;
-    },
-    /**
-     * Method to get current product information's
-     *  - Is product minted?
-     *  - Does it have running campaign?
-     *  - Estimated reward on actions
-     */
-    {
-        Method: "frak_getProductInformation";
-        Parameters?: undefined;
-        ReturnType: GetProductInformationReturnType;
-    },
-    /**
-     * Method to show the embeded wallet, with potential customisation
-     */
-    {
-        Method: "frak_displayEmbededWallet";
-        Parameters: [DisplayEmbededWalletParamsType, name: string];
-        ReturnType: undefined;
-    }
-];
-
-/**
- * Type that extract the possible parameters from a RPC Schema
- * @ignore
- */
-type ExtractedParametersFromRpc<TRpcSchema extends RpcSchema> = {
-    [K in keyof TRpcSchema]: Prettify<{
-        method: TRpcSchema[K] extends TRpcSchema[number] ? TRpcSchema[K]["Method"] : string;
-    } & (TRpcSchema[K] extends TRpcSchema[number] ? TRpcSchema[K]["Parameters"] extends undefined ? {
-        params?: never;
-    } : {
-        params: TRpcSchema[K]["Parameters"];
-    } : never)>;
-}[number];
-/**
- * Type that extract the possible return type from a RPC Schema
- * @ignore
- */
-type ExtractedReturnTypeFromRpc<TRpcSchema extends RpcSchema, TParameters extends ExtractedParametersFromRpc<TRpcSchema> = ExtractedParametersFromRpc<TRpcSchema>> = ExtractedMethodFromRpc<TRpcSchema, TParameters["method"]>["ReturnType"];
-/**
- * Type that extract the possible return type from a RPC Schema
- * @ignore
- */
-type ExtractedMethodFromRpc<TRpcSchema extends RpcSchema, TMethod extends ExtractedParametersFromRpc<TRpcSchema>["method"] = ExtractedParametersFromRpc<TRpcSchema>["method"]> = Extract<TRpcSchema[number], {
-    Method: TMethod;
-}>;
-/**
- * Raw response that we will receive after an rpc request
- * @ignore
- */
-type RpcResponse<TRpcSchema extends RpcSchema, TMethod extends TRpcSchema[number]["Method"] = TRpcSchema[number]["Method"]> = {
-    result: Extract<TRpcSchema[number], {
-        Method: TMethod;
-    }>["ReturnType"];
-    error?: never;
-} | {
-    result?: never;
-    error: {
-        code: number;
-        message: string;
-        data?: unknown;
-    };
-};
-/**
- * Type used for a one shot request function
- * @inline
- */
-type RequestFn<TRpcSchema extends RpcSchema> = <TParameters extends ExtractedParametersFromRpc<TRpcSchema> = ExtractedParametersFromRpc<TRpcSchema>, _ReturnType = ExtractedReturnTypeFromRpc<TRpcSchema, TParameters>>(args: TParameters) => Promise<_ReturnType>;
-/**
- * Type used for a listening request
- * @inline
- */
-type ListenerRequestFn<TRpcSchema extends RpcSchema> = <TParameters extends ExtractedParametersFromRpc<TRpcSchema> = ExtractedParametersFromRpc<TRpcSchema>, _ReturnType = ExtractedReturnTypeFromRpc<TRpcSchema, TParameters>>(args: TParameters, callback: (result: _ReturnType) => void) => Promise<void>;
-/**
- * IFrame transport interface
- */
-type IFrameTransport = {
-    /**
-     * Wait for the connection to be established
-     */
-    waitForConnection: Promise<boolean>;
-    /**
-     * Wait for the setup to be done
-     */
-    waitForSetup: Promise<void>;
-    /**
-     * Function used to perform a single request via the iframe transport
-     */
-    request: RequestFn<IFrameRpcSchema>;
-    /**
-     * Function used to listen to a request response via the iframe transport
-     */
-    listenerRequest: ListenerRequestFn<IFrameRpcSchema>;
-    /**
-     * Function used to destroy the iframe transport
-     */
-    destroy: () => Promise<void>;
-};
-/**
- * Represent an iframe event
- */
-type IFrameEvent = IFrameRpcEvent | IFrameLifecycleEvent | ClientLifecycleEvent;
-/**
- * Represent an iframe rpc event
- */
-type IFrameRpcEvent = {
-    id: string;
-    topic: ExtractedParametersFromRpc<IFrameRpcSchema>["method"];
-    data: {
-        compressed: string;
-        compressedHash: string;
-    };
-};
-
-/**
- * Representing a Frak client, used to interact with the Frak Wallet
- */
-type FrakClient = {
-    config: FrakWalletSdkConfig;
-    debugInfo: {
-        formatDebugInfo: (error: Error | unknown | string) => string;
-    };
-} & IFrameTransport;
-
-/**
- * The current Frak Context
- *
- * For now, only contain a referrer address.
- */
-type FrakContext = {
-    r: Address;
-};
-
-export { type IFrameRpcEvent as A, type IFrameLifecycleEvent as B, type ClientLifecycleEvent as C, type DisplayEmbededWalletParamsType as D, type EmbededViewAction as E, type FrakWalletSdkConfig as F, type GetProductInformationReturnType as G, type ExtractedParametersFromRpc as H, type IFrameEvent as I, type ExtractedReturnTypeFromRpc as J, type LoggedOutEmbededView as L, type ModalStepTypes as M, type OpenSsoParamsType as O, type ProductTypesKey as P, type RpcResponse as R, type SsoMetadata as S, type WalletStatusReturnType as W, type FrakClient as a, type FrakContext as b, productTypesMask as c, type InteractionTypesKey as d, type FullInteractionTypesKey as e, type IFrameRpcSchema as f, type LoggedInEmbededView as g, type ModalRpcMetadata as h, interactionTypes as i, type DisplayModalParamsType as j, type ModalRpcStepsInput as k, type ModalRpcStepsResultType as l, type ModalStepMetadata as m, type LoginModalStepType as n, type SiweAuthenticateModalStepType as o, productTypes as p, type SiweAuthenticationParams as q, type SiweAuthenticateReturnType as r, type SendTransactionTxType as s, type SendTransactionModalStepType as t, type SendTransactionReturnType as u, type OpenInteractionSessionReturnType as v, type OpenInteractionSessionModalStepType as w, type FinalModalStepType as x, type FinalActionType as y, type IFrameTransport as z };