@snagsolutions/sdk 0.1.0-alpha.43 → 0.1.0-alpha.45

package/resources/loyalty/rules.d.ts

@@ -30,7 +30,8 @@ export declare class Rules extends APIResource {
     /**
      * This will return the processing status of quests for a specific user
      */
-    getStatus(query: RuleGetStatusParams, options?: Core.RequestOptions): Core.APIPromise<RuleGetStatusResponse>;
+    getStatus(query?: RuleGetStatusParams, options?: Core.RequestOptions): Core.APIPromise<RuleGetStatusResponse>;
+    getStatus(options?: Core.RequestOptions): Core.APIPromise<RuleGetStatusResponse>;
 }
 export interface RuleCreateResponse {
     id: string;
@@ -364,6 +365,11 @@ export declare namespace RuleCreateResponse {
          * Flag indicating if all contracts are tracked.
          */
         trackAllContracts?: boolean | null;
+        /**
+         * Flag indicating if the progress is tracked. If enabled, the rule can only be
+         * completed once the progress is 100%.
+         */
+        trackProgress?: boolean | null;
         /**
          * URL of the associated Twitter account.
          */
@@ -977,6 +983,11 @@ export declare namespace RuleUpdateResponse {
          * Flag indicating if all contracts are tracked.
          */
         trackAllContracts?: boolean | null;
+        /**
+         * Flag indicating if the progress is tracked. If enabled, the rule can only be
+         * completed once the progress is 100%.
+         */
+        trackProgress?: boolean | null;
         /**
          * URL of the associated Twitter account.
          */
@@ -1327,10 +1338,518 @@ export declare namespace RuleListResponse {
          * Optional address of the collection
          */
         collectionAddress?: string;
+        /**
+         * URL of the media associated with the loyalty rule
+         */
+        mediaUrl?: string | null;
         /**
          * Optional metadata for the loyalty rule
          */
-        metadata?: Record<string, unknown>;
+        metadata?: Record<string, Data.Metadata>;
+    }
+    namespace Data {
+        interface Metadata {
+            /**
+             * Text displayed on the action button.
+             */
+            buttonText?: string | null;
+            /**
+             * Flag indicating if commenting is required.
+             */
+            checkComment?: boolean | null;
+            /**
+             * Flag indicating if liking the post is required.
+             */
+            checkLike?: boolean | null;
+            /**
+             * Flag indicating if reposting is required.
+             */
+            checkRepost?: boolean | null;
+            /**
+             * Text to check in the Twitter post, username, or bio.
+             */
+            checkText?: string | null;
+            /**
+             * Array of collections associated with the rule.
+             */
+            collection?: Array<Metadata.Collection>;
+            /**
+             * Conditions for completing the profile.
+             */
+            completeProfileConditions?: Record<string, boolean> | null;
+            /**
+             * Object containing details for the call-to-action.
+             */
+            cta?: Metadata.Cta | null;
+            /**
+             * API key for custom rewards integration.
+             */
+            customRewardsApiKey?: string;
+            /**
+             * Array of Discord servers, channels, and roles to join.
+             */
+            discordServersToJoin?: Array<Metadata.DiscordServersToJoin> | null;
+            /**
+             * Array of drip quests required to complete the rule.
+             */
+            dripQuestsToComplete?: Array<Metadata.DripQuestsToComplete> | null;
+            /**
+             * Flag indicating whether joining Discord servers is required.
+             */
+            enableJoinDiscordServers?: boolean | null;
+            /**
+             * Flag indicating whether streaks are enabled.
+             */
+            enableStreaks?: boolean | null;
+            /**
+             * Flag indicating whether the verified multiplier is enabled.
+             */
+            enableVerifiedMultiplier?: boolean;
+            /**
+             * Fill source of the order for the token sale
+             */
+            fillSource?: string;
+            /**
+             * Percentage reward given to a user for their first referral.
+             */
+            firstReferralReward?: number | null;
+            /**
+             * Flag indicating whether the fill source is included.
+             */
+            hasFillSource?: boolean;
+            /**
+             * Indicates if the item has never been sold.
+             */
+            hasNeverSold?: boolean;
+            /**
+             * Flag indicating whether the order source is included.
+             */
+            hasOrderSource?: boolean;
+            /**
+             * Indicates if the full royalty has been paid for items.
+             */
+            hasPaidFullRoyalty?: boolean;
+            /**
+             * Flag indicating if the sale currency is included.
+             */
+            hasSaleCurrency?: boolean;
+            /**
+             * Indicates if the user has a verified Twitter account.
+             */
+            hasVerifiedTwitter?: boolean;
+            /**
+             * URL of the image associated with the rule.
+             */
+            imageUrl?: string | null;
+            /**
+             * Indicates if the multiplier has been applied to rewards.
+             */
+            isMultiplierApplied?: boolean;
+            /**
+             * Flag indicating if rewards are applied retroactively.
+             */
+            isRetroactive?: boolean | null;
+            /**
+             * Flag indicating if the token hold multiplier is applied.
+             */
+            isTokenHoldMultiplier?: boolean;
+            /**
+             * Optional link associated with the metadata.
+             */
+            link?: string | null;
+            /**
+             * Maximum quantity constraint for token holding.
+             */
+            maxQty?: number | null;
+            /**
+             * Minimum quantity constraint for token holding.
+             */
+            minQty?: number | null;
+            /**
+             * Array of loyalty currency IDs used for multipliers.
+             */
+            multiplierLoyaltyCurrencyIds?: Array<string> | null;
+            /**
+             * Flag indicating whether to include only known users.
+             */
+            onlyKnownUsers?: boolean;
+            /**
+             * Flag indicating whether to include only native tokens.
+             */
+            onlyNative?: boolean;
+            /**
+             * Flag indicating whether to include only non-listed items.
+             */
+            onlyNonListed?: boolean;
+            /**
+             * Indicates if only existing users are rewarded.
+             */
+            onlyRewardExistingUser?: boolean;
+            /**
+             * give points for only one token ownership per contract
+             */
+            onlyRewardSingleTokenOwnership?: boolean | null;
+            /**
+             * Order source of the order for the token sale
+             */
+            orderSource?: string;
+            /**
+             * Promotional code associated with the rule.
+             */
+            promoCode?: string;
+            /**
+             * Array defining ranges and corresponding rewards.
+             */
+            range?: Array<Metadata.Range>;
+            /**
+             * Object defining referral requirements.
+             */
+            referralRequirements?: Metadata.ReferralRequirements | null;
+            /**
+             * Lump sum reward given to a referrer.
+             */
+            referrerReward?: number | null;
+            /**
+             * Flag indicating if rewards are given per impression.
+             */
+            rewardPerImpression?: boolean | null;
+            /**
+             * Currency associated with sales.
+             */
+            saleCurrency?: string;
+            /**
+             * Percentage reward given for a second-level referral.
+             */
+            secondReferralReward?: number | null;
+            /**
+             * Flag indicating if the multiplier is skipped.
+             */
+            skipMultiplier?: boolean | null;
+            /**
+             * Object containing details of the associated smart contract.
+             */
+            smartContract?: Metadata.SmartContract;
+            /**
+             * Array of snapshot proposals for the rule.
+             */
+            snapshotProposals?: Array<Metadata.SnapshotProposal> | null;
+            /**
+             * Social media platform associated with the rule.
+             */
+            socialPlatform?: 'Custom' | 'Discord' | 'EpicGames' | 'Instagram' | 'Steam' | 'Telegram' | 'TikTok' | 'Twitch' | 'X(Twitter)' | 'YouTube' | null;
+            /**
+             * URL of the social platform's logo.
+             */
+            socialPlatformLogo?: string | null;
+            /**
+             * Name of the social platform.
+             */
+            socialPlatformName?: string | null;
+            /**
+             * ID of the Steam app.
+             */
+            steamAppId?: string | null;
+            /**
+             * Array of streak milestones and corresponding rewards.
+             */
+            streakArray?: Array<Metadata.StreakArray> | null;
+            /**
+             * ID of the Telegram channel.
+             */
+            telegramChannelId?: string | null;
+            /**
+             * Time delay in seconds to verify actions.
+             */
+            timeDelayToVerifySeconds?: string | number | null;
+            /**
+             * Flag indicating if all contracts are tracked.
+             */
+            trackAllContracts?: boolean | null;
+            /**
+             * Flag indicating if the progress is tracked. If enabled, the rule can only be
+             * completed once the progress is 100%.
+             */
+            trackProgress?: boolean | null;
+            /**
+             * URL of the associated Twitter account.
+             */
+            twitterAccountUrl?: string;
+            /**
+             * Hashtag associated with the Twitter post.
+             */
+            twitterHashtag?: string;
+            /**
+             * URL of the associated Twitter post.
+             */
+            twitterPostUrl?: string;
+            /**
+             * Unique identifier of the Twitter user.
+             */
+            twitterUserId?: string;
+            /**
+             * Twitter username of the user.
+             */
+            twitterUsername?: string;
+            /**
+             * Minimum length of the verification text.
+             */
+            verificationTextMinimumLength?: number | null;
+            /**
+             * Multiplier applied to rewards for verified users.
+             */
+            verifiedMultiplier?: number | null;
+            /**
+             * Placeholder text for verification input fields.
+             */
+            verifyPlaceHolderText?: string | null;
+            /**
+             * Type of wallet associated with the rule.
+             */
+            walletType?: 'evm' | 'solana' | 'imx' | 'sui' | 'ton' | null;
+        }
+        namespace Metadata {
+            interface Collection {
+                /**
+                 * Blockchain address of the collection.
+                 */
+                address?: string;
+                /**
+                 * Multiplier applied to the rewards for this collection.
+                 */
+                multiplier?: number;
+                /**
+                 * Blockchain network of the collection.
+                 */
+                network?: 'abstract' | 'abstractTestnet' | 'apechain' | 'arbitrum' | 'avalanche' | 'avalancheFuji' | 'base' | 'baseSepolia' | 'berachainArtio' | 'binance' | 'bscTestnet' | 'campTestnet' | 'fantom' | 'fantomTestnet' | 'flowMainnet' | 'mainnet' | 'optimism' | 'polygon' | 'polygon_mumbai' | 'skaleNebula' | 'solana' | 'sophon' | 'sui' | 'superseed' | 'superseedSepolia' | 'vanar' | 'xai' | 'zksync' | 'sepolia' | 'optimism_sepolia' | 'arbitrumSepolia' | 'goerli' | 'optimism_goerli' | 'arbitrumGoerli' | 'basecamp';
+            }
+            /**
+             * Object containing details for the call-to-action.
+             */
+            interface Cta {
+                /**
+                 * Link for the call-to-action.
+                 */
+                href?: string | null;
+                /**
+                 * Label for the call-to-action.
+                 */
+                label?: string | null;
+            }
+            interface DiscordServersToJoin {
+                /**
+                 * ID of the Discord server to join.
+                 */
+                id?: string;
+                /**
+                 * Array of Discord channels to join.
+                 */
+                channels?: Array<DiscordServersToJoin.Channel>;
+                /**
+                 * Array of roles to assign in the Discord server.
+                 */
+                roles?: Array<DiscordServersToJoin.Role>;
+            }
+            namespace DiscordServersToJoin {
+                interface Channel {
+                    /**
+                     * ID of the Discord channel.
+                     */
+                    id?: string;
+                    /**
+                     * Array of emojis used in the channel.
+                     */
+                    emojis?: Array<Channel.Emoji>;
+                    /**
+                     * Phrase of text to be present in the discord message
+                     */
+                    text?: string;
+                }
+                namespace Channel {
+                    interface Emoji {
+                        /**
+                         * ID of the emoji used in the channel.
+                         */
+                        id?: string;
+                    }
+                }
+                interface Role {
+                    /**
+                     * ID of the role in the Discord server.
+                     */
+                    id: string;
+                }
+            }
+            interface DripQuestsToComplete {
+                /**
+                 * ID of the drip quest to complete.
+                 */
+                id: string;
+            }
+            interface Range {
+                /**
+                 * Reward amount for this range.
+                 */
+                amount: number;
+                /**
+                 * End value of the range.
+                 */
+                endRange: number;
+                /**
+                 * Start value of the range.
+                 */
+                startRange: number;
+            }
+            /**
+             * Object defining referral requirements.
+             */
+            interface ReferralRequirements {
+                /**
+                 * Flag indicating if achieving points is required.
+                 */
+                achievePoints?: boolean | null;
+                /**
+                 * Flag indicating if completing the profile is required.
+                 */
+                completeProfile?: boolean | null;
+                /**
+                 * Flag indicating if connecting Discord is required.
+                 */
+                connectDiscord?: boolean | null;
+                /**
+                 * Flag indicating if connecting email is required.
+                 */
+                connectEmail?: boolean | null;
+                /**
+                 * Flag indicating if connecting Twitter is required.
+                 */
+                connectTwitter?: boolean | null;
+                points?: ReferralRequirements.Points | null;
+            }
+            namespace ReferralRequirements {
+                interface Points {
+                    /**
+                     * Points required for referral.
+                     */
+                    amount?: number | null;
+                    /**
+                     * ID of the loyalty currency for referral.
+                     */
+                    loyaltyCurrecyId?: string | null;
+                }
+            }
+            /**
+             * Object containing details of the associated smart contract.
+             */
+            interface SmartContract {
+                /**
+                 * ABI of the smart contract.
+                 */
+                abi?: string | null;
+                /**
+                 * Mapping of addresses for the smart contract.
+                 */
+                addressMapping?: string | null;
+                /**
+                 * Array of bonus details applied to the rule.
+                 */
+                bonus?: Array<SmartContract.Bonus> | null;
+                /**
+                 * ID of the smart contract.
+                 */
+                contractId?: string | null;
+                /**
+                 * Criteria to evaluate the smart contract event.
+                 */
+                criteria?: 'everyEvent' | 'byParameter' | null;
+                /**
+                 * Time range applied to the rule.
+                 */
+                customRange?: SmartContract.CustomRange | null;
+                /**
+                 * Event emitted by the smart contract.
+                 */
+                event?: string | null;
+                /**
+                 * Maximum value allowed for the parameter.
+                 */
+                max?: number | null;
+                /**
+                 * Array of parameters for the smart contract.
+                 */
+                params?: Array<SmartContract.Param> | null;
+                /**
+                 * Flag indicating if a bonus is applied.
+                 */
+                withBonus?: boolean | null;
+                /**
+                 * Flag indicating if a custom range is applied.
+                 */
+                withCustomRange?: boolean | null;
+                /**
+                 * Flag indicating if a maximum limit is applied.
+                 */
+                withMax?: boolean | null;
+            }
+            namespace SmartContract {
+                interface Bonus {
+                    /**
+                     * Amount of the bonus.
+                     */
+                    amount?: number | null;
+                    /**
+                     * Number of times the bonus is applied.
+                     */
+                    count?: number | null;
+                }
+                /**
+                 * Time range applied to the rule.
+                 */
+                interface CustomRange {
+                    /**
+                     * End time of the custom range.
+                     */
+                    endsAt?: string | null;
+                    /**
+                     * Start time of the custom range.
+                     */
+                    startsAt?: string | null;
+                }
+                interface Param {
+                    /**
+                     * Condition to check for the parameter.
+                     */
+                    condition?: string | null;
+                    /**
+                     * Name of the smart contract parameter.
+                     */
+                    name?: string | null;
+                    /**
+                     * Value of the parameter.
+                     */
+                    value?: string | null;
+                }
+            }
+            interface SnapshotProposal {
+                /**
+                 * ID of the snapshot proposal.
+                 */
+                id: string;
+                /**
+                 * Space associated with the snapshot proposal.
+                 */
+                space: string;
+            }
+            interface StreakArray {
+                /**
+                 * Reward amount for achieving the streak milestone.
+                 */
+                streakAmount: number;
+                /**
+                 * Milestone required to achieve the streak.
+                 */
+                streakMilestone: number;
+            }
+        }
     }
 }
 export interface RuleDeleteResponse {
@@ -1682,6 +2201,11 @@ export declare namespace RuleCreateParams {
          * Flag indicating if all contracts are tracked.
          */
         trackAllContracts?: boolean | null;
+        /**
+         * Flag indicating if the progress is tracked. If enabled, the rule can only be
+         * completed once the progress is 100%.
+         */
+        trackProgress?: boolean | null;
         /**
          * URL of the associated Twitter account.
          */
@@ -2294,6 +2818,11 @@ export declare namespace RuleUpdateParams {
          * Flag indicating if all contracts are tracked.
          */
         trackAllContracts?: boolean | null;
+        /**
+         * Flag indicating if the progress is tracked. If enabled, the rule can only be
+         * completed once the progress is 100%.
+         */
+        trackProgress?: boolean | null;
         /**
          * URL of the associated Twitter account.
          */
@@ -2580,6 +3109,11 @@ export interface RuleListParams {
      * Address of the collection to filter by
      */
     collectionAddress?: string;
+    /**
+     * If true this will only return active rules, the rules for which the startTime is
+     * in the past and the endTime is in the future
+     */
+    isActive?: 'true' | 'false';
     /**
      * Maximum number of records to return (max 1000)
      */
@@ -2642,9 +3176,10 @@ export interface RuleCompleteParams {
     walletAddress?: string;
 }
 export interface RuleGetStatusParams {
-    organizationId: string;
-    websiteId: string;
+    organizationId?: string;
     userId?: string;
+    walletAddress?: string;
+    websiteId?: string;
 }
 export declare namespace Rules {
     export { type RuleCreateResponse as RuleCreateResponse, type RuleUpdateResponse as RuleUpdateResponse, type RuleListResponse as RuleListResponse, type RuleDeleteResponse as RuleDeleteResponse, type RuleCompleteResponse as RuleCompleteResponse, type RuleGetStatusResponse as RuleGetStatusResponse, type RuleCreateParams as RuleCreateParams, type RuleUpdateParams as RuleUpdateParams, type RuleListParams as RuleListParams, type RuleCompleteParams as RuleCompleteParams, type RuleGetStatusParams as RuleGetStatusParams, };