@snagsolutions/sdk 0.1.0-alpha.20 → 0.1.0-alpha.201

package/src/resources/loyalty/transactions.ts

@@ -1,332 +1,3 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../resource';
-import { isRequestOptions } from '../../core';
-import * as Core from '../../core';
-
-export class Transactions extends APIResource {
-  /**
-   * Create a loyalty transaction to update account balances.
-   */
-  createTransaction(
-    body: TransactionCreateTransactionParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<TransactionCreateTransactionResponse> {
-    return this._client.post('/api/loyalty/transactions', { body, ...options });
-  }
-
-  /**
-   * Fetch loyalty transaction entries for wallets or users, representing account
-   * balance changes.
-   */
-  getTransactionEntries(
-    query?: TransactionGetTransactionEntriesParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<TransactionGetTransactionEntriesResponse>;
-  getTransactionEntries(
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<TransactionGetTransactionEntriesResponse>;
-  getTransactionEntries(
-    query: TransactionGetTransactionEntriesParams | Core.RequestOptions = {},
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<TransactionGetTransactionEntriesResponse> {
-    if (isRequestOptions(query)) {
-      return this.getTransactionEntries({}, query);
-    }
-    return this._client.get('/api/loyalty/transaction_entries', { query, ...options });
-  }
-}
-
-export interface TransactionCreateTransactionResponse {
-  id: string;
-
-  createdAt: string;
-
-  description: string;
-
-  entries: Array<TransactionCreateTransactionResponse.Entry>;
-
-  updatedAt: string;
-}
-
-export namespace TransactionCreateTransactionResponse {
-  export interface Entry {
-    amount: number;
-
-    /**
-     * Direction of the transaction entry
-     */
-    direction: 'credit' | 'debit';
-
-    walletAddress: string;
-
-    idempotencyKey?: string;
-  }
-}
-
-export interface TransactionGetTransactionEntriesResponse {
-  data: Array<TransactionGetTransactionEntriesResponse.Data>;
-
-  hasNextPage: boolean;
-}
-
-export namespace TransactionGetTransactionEntriesResponse {
-  /**
-   * Schema for a loyalty transaction entry
-   */
-  export interface Data {
-    /**
-     * Unique identifier for the transaction entry
-     */
-    id: string;
-
-    /**
-     * Amount involved in the transaction
-     */
-    amount: number;
-
-    /**
-     * Timestamp when the transaction entry was created
-     */
-    createdAt: string;
-
-    /**
-     * Direction of the transaction entry
-     */
-    direction: 'credit' | 'debit';
-
-    /**
-     * Unique identifier for the loyalty account
-     */
-    loyaltyAccountId: string;
-
-    /**
-     * Details of the loyalty transaction
-     */
-    loyaltyTransaction: Data.LoyaltyTransaction;
-
-    /**
-     * Unique identifier for the organization
-     */
-    organizationId: string;
-
-    /**
-     * Type of the loyalty transaction
-     */
-    type: 'auction_bid' | 'direct_mint' | 'loyalty_rule' | 'api_key' | 'order';
-
-    /**
-     * Timestamp when the transaction entry was last updated
-     */
-    updatedAt: string;
-
-    /**
-     * Unique identifier for the website
-     */
-    websiteId: string;
-
-    /**
-     * Optional metadata for the transaction entry
-     */
-    metadata?: Record<string, unknown>;
-  }
-
-  export namespace Data {
-    /**
-     * Details of the loyalty transaction
-     */
-    export interface LoyaltyTransaction {
-      /**
-       * Unique identifier for the loyalty transaction
-       */
-      id: string;
-
-      /**
-       * Type of the loyalty transaction
-       */
-      type: 'auction_bid' | 'direct_mint' | 'loyalty_rule' | 'api_key' | 'order';
-
-      /**
-       * Details of the loyalty rule associated with the transaction
-       */
-      loyaltyRule?: LoyaltyTransaction.LoyaltyRule;
-    }
-
-    export namespace LoyaltyTransaction {
-      /**
-       * Details of the loyalty rule associated with the transaction
-       */
-      export interface LoyaltyRule {
-        /**
-         * Unique identifier for the loyalty rule
-         */
-        id: string;
-
-        /**
-         * Type of the loyalty rule
-         */
-        type: string;
-
-        /**
-         * Description of the loyalty rule
-         */
-        description?: string;
-
-        /**
-         * Optional metadata for the loyalty rule
-         */
-        metadata?: Record<string, unknown>;
-
-        /**
-         * Name of the loyalty rule
-         */
-        name?: string;
-      }
-    }
-  }
-}
-
-export interface TransactionCreateTransactionParams {
-  /**
-   * Description of the loyalty transaction
-   */
-  description: string;
-
-  /**
-   * Array of transaction entries
-   */
-  entries: Array<TransactionCreateTransactionParams.Entry>;
-
-  /**
-   * Unique identifier for the loyalty currency
-   */
-  loyaltyCurrencyId?: string;
-}
-
-export namespace TransactionCreateTransactionParams {
-  export interface Entry {
-    /**
-     * Transaction entry amount.
-     */
-    amount: number;
-
-    /**
-     * Direction of the transaction entry for this wallet address
-     */
-    direction?: 'credit' | 'debit';
-
-    /**
-     * Idempotency key for the transaction entry. Creation will fail if already exists
-     * for this wallet address.
-     */
-    idempotencyKey?: string;
-
-    /**
-     * The wallet address of the user
-     */
-    walletAddress?: string;
-  }
-}
-
-export interface TransactionGetTransactionEntriesParams {
-  /**
-   * End date to filter by (exclusive, less than)
-   */
-  createdAtEnd?: string;
-
-  /**
-   * Start date to filter by (inclusive, greater than or equal to)
-   */
-  createdAtStart?: string;
-
-  /**
-   * Direction of the transaction entry to filter by
-   */
-  direction?: 'credit' | 'debit';
-
-  /**
-   * Key to ensure idempotency of the request
-   */
-  idempotencyKey?: string;
-
-  /**
-   * Maximum number of records to return (max 1000)
-   */
-  limit?: number;
-
-  /**
-   * Unique identifier for the loyalty rule to filter by
-   */
-  loyaltyRuleId?: string;
-
-  /**
-   * Unique identifier for the loyalty transaction to filter by
-   */
-  loyaltyTransactionId?: string;
-
-  /**
-   * Field to order the results by
-   */
-  orderBy?: 'createdAt' | 'updatedAt' | 'loyaltyAccountLockVersion';
-
-  /**
-   * Unique identifier for the organization to filter by
-   */
-  organizationId?: string;
-
-  /**
-   * Pagination cursor to start after a specific resource ID
-   */
-  startingAfter?: string;
-
-  /**
-   * Type of the loyalty transaction to filter by
-   */
-  type?: 'auction_bid' | 'direct_mint' | 'loyalty_rule' | 'api_key' | 'order';
-
-  /**
-   * When passed in return the list of fulfilled entries for loyalty rules. If a
-   * loyalty rule has a fulfilled entry this means the user cannot currently complete
-   * the rule. Must be passed in with userId or walletAddress.
-   */
-  userCompletedLoyaltyRuleId?: string | Array<string>;
-
-  /**
-   * External identifier for the user group controlled by you
-   */
-  userGroupExternalIdentifier?: string;
-
-  /**
-   * Unique identifier for the user group
-   */
-  userGroupId?: string;
-
-  /**
-   * User ID or array of User IDs to filter by
-   */
-  userId?: string | Array<string>;
-
-  /**
-   * Wallet address or array of wallet addresses to filter by
-   */
-  walletAddress?: string | Array<string>;
-
-  /**
-   * Identifier for the wallet group to filter by
-   */
-  walletGroupIdentifier?: string;
-
-  /**
-   * Unique identifier for the website to filter by
-   */
-  websiteId?: string;
-}
-
-export declare namespace Transactions {
-  export {
-    type TransactionCreateTransactionResponse as TransactionCreateTransactionResponse,
-    type TransactionGetTransactionEntriesResponse as TransactionGetTransactionEntriesResponse,
-    type TransactionCreateTransactionParams as TransactionCreateTransactionParams,
-    type TransactionGetTransactionEntriesParams as TransactionGetTransactionEntriesParams,
-  };
-}
+export * from './transactions/index';

package/src/resources/minting.ts

@@ -89,13 +89,17 @@ export interface MintingGetAssetsParams {
    * Network
    */
   network?:
+    | 'abstract'
+    | 'abstractTestnet'
     | 'apechain'
     | 'arbitrum'
     | 'avalanche'
     | 'avalancheFuji'
     | 'base'
     | 'baseSepolia'
+    | 'berachain'
     | 'berachainArtio'
+    | 'berachainBepolia'
     | 'binance'
     | 'bscTestnet'
     | 'campTestnet'
@@ -103,18 +107,30 @@ export interface MintingGetAssetsParams {
     | 'fantomTestnet'
     | 'flowMainnet'
     | 'mainnet'
+    | 'nexusTestnet'
     | 'optimism'
     | 'polygon'
     | 'polygon_mumbai'
     | 'skaleNebula'
+    | 'skaleEuropa'
+    | 'skaleCalypso'
     | 'solana'
     | 'sophon'
+    | 'sophonTestnet'
     | 'sui'
     | 'superseed'
     | 'superseedSepolia'
     | 'vanar'
     | 'xai'
     | 'zksync'
+    | 'coti'
+    | 'cotiTestnet'
+    | 'morph'
+    | 'morphTestnet'
+    | 'morphHolesky'
+    | 'ultra'
+    | 'ultraTestnet'
+    | 'nitrograph'
     | 'sepolia'
     | 'optimism_sepolia'
     | 'arbitrumSepolia'
@@ -122,17 +138,21 @@ export interface MintingGetAssetsParams {
     | 'optimism_goerli'
     | 'arbitrumGoerli'
     | 'basecamp'
-    | 'abstract';
+    | 'somnia'
+    | 'zkverify'
+    | 'polkadot'
+    | 'kusama'
+    | 'flow_cadence';
 
   /**
-   * Sort Dir
+   * Sort Key
    */
-  sortDir?: 'asc' | 'desc' | null;
+  sortBy?: 'price' | 'startsAt' | 'assetNr' | null;
 
   /**
-   * Sort Key
+   * Sort Dir
    */
-  sortKey?: 'price' | 'startsAt' | 'assetNr' | null;
+  sortDir?: 'asc' | 'desc' | null;
 
   /**
    * Status

package/src/resources/referral/referral.ts

@@ -1,7 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../resource';
-import { isRequestOptions } from '../../core';
 import * as Core from '../../core';
 import * as UsersAPI from './users';
 import { UserCreateParams, UserCreateResponse, UserListParams, UserListResponse, Users } from './users';
@@ -11,19 +10,18 @@ export class Referral extends APIResource {
 
   /**
    * This endpoint allows you to create a referral code
+   *
+   * @example
+   * ```ts
+   * const response = await client.referral.createCode({
+   *   loyaltyRuleId: '558bcf56-24f1-4ef4-9787-043086295780',
+   * });
+   * ```
    */
   createCode(
-    body?: ReferralCreateCodeParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<ReferralCreateCodeResponse>;
-  createCode(options?: Core.RequestOptions): Core.APIPromise<ReferralCreateCodeResponse>;
-  createCode(
-    body: ReferralCreateCodeParams | Core.RequestOptions = {},
+    body: ReferralCreateCodeParams,
     options?: Core.RequestOptions,
   ): Core.APIPromise<ReferralCreateCodeResponse> {
-    if (isRequestOptions(body)) {
-      return this.createCode({}, body);
-    }
     return this._client.post('/api/referral/codes', { body, ...options });
   }
 }
@@ -47,9 +45,13 @@ export interface ReferralCreateCodeResponse {
 }
 
 export interface ReferralCreateCodeParams {
-  loyaltyRuleId?: string;
+  loyaltyRuleId: string;
+
+  organizationId?: string;
 
   userId?: string;
+
+  websiteId?: string;
 }
 
 Referral.Users = Users;

package/src/resources/referral/users.ts

@@ -1,11 +1,19 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../resource';
+import { isRequestOptions } from '../../core';
 import * as Core from '../../core';
 
 export class Users extends APIResource {
   /**
    * This endpoint allows you to create a referral user
+   *
+   * @example
+   * ```ts
+   * const user = await client.referral.users.create({
+   *   userIds: ['182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e'],
+   * });
+   * ```
    */
   create(body: UserCreateParams, options?: Core.RequestOptions): Core.APIPromise<UserCreateResponse> {
     return this._client.post('/api/referral/users', { body, ...options });
@@ -13,8 +21,21 @@ export class Users extends APIResource {
 
   /**
    * This endpoint allows you to get referrals
+   *
+   * @example
+   * ```ts
+   * const users = await client.referral.users.list();
+   * ```
    */
-  list(query: UserListParams, options?: Core.RequestOptions): Core.APIPromise<UserListResponse> {
+  list(query?: UserListParams, options?: Core.RequestOptions): Core.APIPromise<UserListResponse>;
+  list(options?: Core.RequestOptions): Core.APIPromise<UserListResponse>;
+  list(
+    query: UserListParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<UserListResponse> {
+    if (isRequestOptions(query)) {
+      return this.list({}, query);
+    }
     return this._client.get('/api/referral/users', { query, ...options });
   }
 }
@@ -36,18 +57,35 @@ export namespace UserListResponse {
     referralCode: Data.ReferralCode;
 
     user: Data.User;
+
+    eligible?: boolean | null;
   }
 
   export namespace Data {
     export interface ReferralCode {
       id: string;
 
+      /**
+       * This will only return data for earnings after 2025-04-24
+       */
+      amount: number;
+
       createdAt: string;
 
       deletedAt: string | null;
 
       referralCode: string;
 
+      /**
+       * This will only return data for earnings after 2025-04-24
+       */
+      tier1Amount: number;
+
+      /**
+       * This will only return data for earnings after 2025-04-24
+       */
+      tier2Amount: number;
+
       updatedAt: string;
 
       userId: string;
@@ -70,16 +108,16 @@ export interface UserCreateParams {
 }
 
 export interface UserListParams {
-  walletAddress: string | Array<string>;
-
-  includeEligibility?: boolean | null;
-
   limit?: number;
 
+  loyaltyRuleId?: string;
+
   organizationId?: string;
 
   startingAfter?: string;
 
+  walletAddress?: string | Array<string>;
+
   websiteId?: string;
 }
 

package/src/resources/users/index.ts

@@ -12,9 +12,13 @@ export {
   type UserListResponse,
   type UserConnectResponse,
   type UserCountResponse,
+  type UserCreateDeviceResponse,
   type UserDisconnectResponse,
+  type UserVerifyResponse,
   type UserListParams,
   type UserConnectParams,
   type UserCountParams,
+  type UserCreateDeviceParams,
   type UserDisconnectParams,
+  type UserVerifyParams,
 } from './users';

package/src/resources/users/metadatas.ts

@@ -7,6 +7,11 @@ import * as Core from '../../core';
 export class Metadatas extends APIResource {
   /**
    * This endpoint is used to create user metadata
+   *
+   * @example
+   * ```ts
+   * const metadata = await client.users.metadatas.create();
+   * ```
    */
   create(body?: MetadataCreateParams, options?: Core.RequestOptions): Core.APIPromise<MetadataCreateResponse>;
   create(options?: Core.RequestOptions): Core.APIPromise<MetadataCreateResponse>;
@@ -22,6 +27,11 @@ export class Metadatas extends APIResource {
 
   /**
    * This endpoint is used to get user metadata
+   *
+   * @example
+   * ```ts
+   * const metadatas = await client.users.metadatas.list();
+   * ```
    */
   list(query?: MetadataListParams, options?: Core.RequestOptions): Core.APIPromise<MetadataListResponse>;
   list(options?: Core.RequestOptions): Core.APIPromise<MetadataListResponse>;
@@ -57,7 +67,10 @@ export interface MetadataCreateResponse {
 
   user: MetadataCreateResponse.User;
 
-  userGroup: MetadataCreateResponse.UserGroup;
+  /**
+   * User group associated with the user
+   */
+  userGroup: MetadataCreateResponse.UserGroup | null;
 
   /**
    * Identifier for the user group set via api
@@ -88,6 +101,9 @@ export namespace MetadataCreateResponse {
     walletAddress: string;
   }
 
+  /**
+   * User group associated with the user
+   */
   export interface UserGroup {
     /**
      * id for the user group
@@ -123,6 +139,18 @@ export namespace MetadataListResponse {
 }
 
 export interface MetadataCreateParams {
+  bio?: string | null;
+
+  blockStatusReason?:
+    | 'sybil_and_multi_account'
+    | 'account_migration'
+    | 'abuse_manipulation'
+    | 'not_sybil'
+    | 'issue_resolved'
+    | 'twitter_suspended'
+    | 'other'
+    | null;
+
   discordUser?: string | null;
 
   discordUserId?: string | null;
@@ -135,22 +163,48 @@ export interface MetadataCreateParams {
 
   externalIdentifier?: string | null;
 
+  externalLoyaltyScore?: string | null;
+
+  githubUser?: string | null;
+
+  githubUserId?: string | null;
+
+  googleUser?: string | null;
+
+  googleUserId?: string | null;
+
+  internalNotes?: string | null;
+
   isBlocked?: boolean;
 
+  isBlockExempt?: boolean;
+
+  location?: string | null;
+
   logoUrl?: string | null;
 
   organizationId?: string;
 
-  stardustProfileIdentifier?: string | null;
+  portfolioUrl?: string | null;
+
+  steamUserId?: string | null;
+
+  steamUsername?: string | null;
 
-  stardustWalletIdentifier?: string | null;
+  sybilScore?: number | null;
 
   telegramUserId?: string | null;
 
   telegramUsername?: string | null;
 
+  tiktokUser?: string | null;
+
+  tiktokUserId?: string | null;
+
   twitterUser?: string | null;
 
+  twitterUserFollowersCount?: number | null;
+
   twitterUserId?: string | null;
 
   userGroupExternalIdentifier?: string | null;
@@ -164,6 +218,8 @@ export interface MetadataCreateParams {
   walletGroupIdentifier?: string | null;
 
   websiteId?: string;
+
+  YTChannelId?: string | null;
 }
 
 export interface MetadataListParams {
@@ -192,6 +248,8 @@ export interface MetadataListParams {
    */
   userId?: string;
 
+  userSearch?: string;
+
   /**
    * Wallet address of the user
    */