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

package/src/resources/loyalty/rules.ts

@@ -73,9 +73,17 @@ export class Rules extends APIResource {
    * This will return the processing status of quests for a specific user
    */
   getStatus(
-    query: RuleGetStatusParams,
+    query?: RuleGetStatusParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<RuleGetStatusResponse>;
+  getStatus(options?: Core.RequestOptions): Core.APIPromise<RuleGetStatusResponse>;
+  getStatus(
+    query: RuleGetStatusParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
   ): Core.APIPromise<RuleGetStatusResponse> {
+    if (isRequestOptions(query)) {
+      return this.getStatus({}, query);
+    }
     return this._client.get('/api/loyalty/rules/status', { query, ...options });
   }
 }
@@ -594,6 +602,12 @@ export namespace RuleCreateResponse {
      */
     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.
      */
@@ -1496,6 +1510,12 @@ export namespace RuleUpdateResponse {
      */
     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.
      */
@@ -1955,10 +1975,677 @@ export namespace RuleListResponse {
      */
     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>;
+  }
+
+  export namespace Data {
+    export 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;
+    }
+
+    export namespace Metadata {
+      export 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.
+       */
+      export interface Cta {
+        /**
+         * Link for the call-to-action.
+         */
+        href?: string | null;
+
+        /**
+         * Label for the call-to-action.
+         */
+        label?: string | null;
+      }
+
+      export 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>;
+      }
+
+      export namespace DiscordServersToJoin {
+        export 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;
+        }
+
+        export namespace Channel {
+          export interface Emoji {
+            /**
+             * ID of the emoji used in the channel.
+             */
+            id?: string;
+          }
+        }
+
+        export interface Role {
+          /**
+           * ID of the role in the Discord server.
+           */
+          id: string;
+        }
+      }
+
+      export interface DripQuestsToComplete {
+        /**
+         * ID of the drip quest to complete.
+         */
+        id: string;
+      }
+
+      export 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.
+       */
+      export 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;
+      }
+
+      export namespace ReferralRequirements {
+        export 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.
+       */
+      export 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;
+      }
+
+      export namespace SmartContract {
+        export 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.
+         */
+        export interface CustomRange {
+          /**
+           * End time of the custom range.
+           */
+          endsAt?: string | null;
+
+          /**
+           * Start time of the custom range.
+           */
+          startsAt?: string | null;
+        }
+
+        export 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;
+        }
+      }
+
+      export interface SnapshotProposal {
+        /**
+         * ID of the snapshot proposal.
+         */
+        id: string;
+
+        /**
+         * Space associated with the snapshot proposal.
+         */
+        space: string;
+      }
+
+      export interface StreakArray {
+        /**
+         * Reward amount for achieving the streak milestone.
+         */
+        streakAmount: number;
+
+        /**
+         * Milestone required to achieve the streak.
+         */
+        streakMilestone: number;
+      }
+    }
   }
 }
 
@@ -2500,6 +3187,12 @@ export namespace RuleCreateParams {
      */
     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.
      */
@@ -3400,6 +4093,12 @@ export namespace RuleUpdateParams {
      */
     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.
      */
@@ -3779,6 +4478,12 @@ export interface RuleListParams {
    */
   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)
    */
@@ -3855,11 +4560,13 @@ export interface RuleCompleteParams {
 }
 
 export interface RuleGetStatusParams {
-  organizationId: string;
-
-  websiteId: string;
+  organizationId?: string;
 
   userId?: string;
+
+  walletAddress?: string;
+
+  websiteId?: string;
 }
 
 export declare namespace Rules {