@snagsolutions/sdk 0.1.0-alpha.26 → 0.1.0-alpha.260

package/src/resources/minting/status.ts

@@ -0,0 +1,70 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../resource';
+import * as Core from '../../core';
+
+export class Status extends APIResource {
+  /**
+   * Get the status of a mint
+   *
+   * @example
+   * ```ts
+   * const status = await client.minting.status.retrieve('id');
+   * ```
+   */
+  retrieve(id: string, options?: Core.RequestOptions): Core.APIPromise<StatusRetrieveResponse> {
+    return this._client.get(`/api/minting/status/${id}`, options);
+  }
+
+  /**
+   * Update the status of a mint
+   *
+   * @example
+   * ```ts
+   * const status = await client.minting.status.update('id', {
+   *   status: 'failed',
+   * });
+   * ```
+   */
+  update(
+    id: string,
+    body: StatusUpdateParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<StatusUpdateResponse> {
+    return this._client.post(`/api/minting/status/${id}`, { body, ...options });
+  }
+}
+
+export interface StatusRetrieveResponse {
+  errorCode: number | null;
+
+  errorMessage: string | null;
+
+  price: number | null;
+
+  relayerTxId: string | null;
+
+  status: 'minted' | 'minting' | 'failed' | 'generatingSignature';
+
+  txHash: string | null;
+
+  signature?: unknown;
+}
+
+export interface StatusUpdateResponse {
+  message: string;
+}
+
+export interface StatusUpdateParams {
+  status: 'failed' | 'minted';
+
+  txHash?: string;
+}
+
+export declare namespace Status {
+  export {
+    type StatusRetrieveResponse as StatusRetrieveResponse,
+    type StatusUpdateResponse as StatusUpdateResponse,
+    type StatusUpdateParams as StatusUpdateParams,
+  };
+}

package/src/resources/minting.ts

@@ -1,159 +1,3 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../resource';
-import * as Core from '../core';
-
-export class Minting extends APIResource {
-  /**
-   * Returns minting assets and any relevant context
-   */
-  getAssets(
-    query: MintingGetAssetsParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<MintingGetAssetsResponse> {
-    return this._client.get('/api/minting/assets', { query, ...options });
-  }
-}
-
-/**
- * Schema for getting minting assets response
- */
-export interface MintingGetAssetsResponse {
-  /**
-   * Array of minting assets
-   */
-  data: Array<MintingGetAssetsResponse.Data>;
-
-  /**
-   * Indicates if more pages are available
-   */
-  hasNextPage: boolean;
-}
-
-export namespace MintingGetAssetsResponse {
-  export interface Data {
-    /**
-     * UUID of the minting asset
-     */
-    id: string;
-  }
-}
-
-export interface MintingGetAssetsParams {
-  /**
-   * Organization ID
-   */
-  organizationId: string;
-
-  /**
-   * Website ID
-   */
-  websiteId: string;
-
-  /**
-   * Contract Address
-   */
-  contractAddress?: string;
-
-  /**
-   * Currency Type
-   */
-  currencyType?: 'loyalty' | 'native' | null;
-
-  /**
-   * Whether to include deleted assets in the response
-   */
-  includeDeleted?: boolean | null;
-
-  /**
-   * Whether to include metadata in the response
-   */
-  includeMetadata?: boolean | null;
-
-  /**
-   * Whether to include listed assets in the response
-   */
-  isListed?: boolean | null;
-
-  /**
-   * Minting Contract Asset ID
-   */
-  mintingContractAssetId?: string | null;
-
-  /**
-   * Comma-separated list of Minting Contract UUIDs
-   */
-  mintingContractIds?: string | null;
-
-  /**
-   * Network
-   */
-  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';
-
-  /**
-   * Sort Dir
-   */
-  sortDir?: 'asc' | 'desc' | null;
-
-  /**
-   * Sort Key
-   */
-  sortKey?: 'price' | 'startsAt' | 'assetNr' | null;
-
-  /**
-   * Status
-   */
-  status?: 'active' | 'past' | null;
-
-  /**
-   * Token ID
-   */
-  tokenId?: string | Array<number> | null;
-
-  /**
-   * Wallet Address
-   */
-  walletAddress?: string | Array<string>;
-}
-
-export declare namespace Minting {
-  export {
-    type MintingGetAssetsResponse as MintingGetAssetsResponse,
-    type MintingGetAssetsParams as MintingGetAssetsParams,
-  };
-}
+export * from './minting/index';

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,15 @@ export interface ReferralCreateCodeResponse {
 }
 
 export interface ReferralCreateCodeParams {
-  loyaltyRuleId?: string;
+  loyaltyRuleId: string;
+
+  customReferralCode?: 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 });
   }
 }
@@ -33,9 +54,26 @@ export namespace UserListResponse {
   export interface Data {
     id: string;
 
+    /**
+     * This will only return data for earnings after 2025-04-24
+     */
+    amount: number;
+
     referralCode: Data.ReferralCode;
 
+    /**
+     * 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;
+
     user: Data.User;
+
+    eligible?: boolean | null;
   }
 
   export namespace Data {
@@ -51,6 +89,8 @@ export namespace UserListResponse {
       updatedAt: string;
 
       userId: string;
+
+      loyaltyRuleId?: string;
     }
 
     export interface User {
@@ -70,16 +110,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/token-claims.ts

@@ -0,0 +1,311 @@
+// 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 TokenClaims extends APIResource {
+  /**
+   * Get a token claim by id
+   */
+  retrieve(
+    id: string,
+    query: TokenClaimRetrieveParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<TokenClaimRetrieveResponse> {
+    return this._client.get(`/api/token_claims/${id}`, { query, ...options });
+  }
+
+  /**
+   * Get all available token claims for a given website and organization
+   */
+  list(query?: TokenClaimListParams, options?: Core.RequestOptions): Core.APIPromise<TokenClaimListResponse>;
+  list(options?: Core.RequestOptions): Core.APIPromise<TokenClaimListResponse>;
+  list(
+    query: TokenClaimListParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<TokenClaimListResponse> {
+    if (isRequestOptions(query)) {
+      return this.list({}, query);
+    }
+    return this._client.get('/api/token_claims', { query, ...options });
+  }
+
+  /**
+   * Check if a wallet address is eligible for a token claim
+   */
+  checkEligibility(
+    id: string,
+    query: TokenClaimCheckEligibilityParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<TokenClaimCheckEligibilityResponse> {
+    return this._client.get(`/api/token_claims/${id}/eligibility`, { query, ...options });
+  }
+
+  /**
+   * Get a token claim proof for a given wallet address
+   */
+  getProof(
+    id: string,
+    query: TokenClaimGetProofParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<TokenClaimGetProofResponse> {
+    return this._client.get(`/api/token_claims/${id}/proof`, { query, ...options });
+  }
+
+  /**
+   * Get all users part of a token claim
+   */
+  listUsers(
+    id: string,
+    query?: TokenClaimListUsersParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<TokenClaimListUsersResponse>;
+  listUsers(id: string, options?: Core.RequestOptions): Core.APIPromise<TokenClaimListUsersResponse>;
+  listUsers(
+    id: string,
+    query: TokenClaimListUsersParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<TokenClaimListUsersResponse> {
+    if (isRequestOptions(query)) {
+      return this.listUsers(id, {}, query);
+    }
+    return this._client.get(`/api/token_claims/${id}/users`, { query, ...options });
+  }
+
+  /**
+   * Update a user claim status after a user has claimed
+   */
+  updateClaim(
+    id: string,
+    body: TokenClaimUpdateClaimParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<TokenClaimUpdateClaimResponse> {
+    return this._client.post(`/api/token_claims/${id}/claim`, { body, ...options });
+  }
+}
+
+export interface TokenClaimRetrieveResponse {
+  tokenClaimId: string;
+
+  totalAllocation: number;
+
+  walletAddress: string;
+
+  proof?: unknown;
+}
+
+export interface TokenClaimListResponse {
+  data: Array<TokenClaimListResponse.Data>;
+}
+
+export namespace TokenClaimListResponse {
+  export interface Data {
+    id: string;
+
+    claimContractAddress: string | null;
+
+    contract: Data.Contract;
+
+    csvUrl: string | null;
+
+    dataJobId: string | null;
+
+    endTime: string | null;
+
+    erc20Decimals: number | null;
+
+    geoBlock: Array<string>;
+
+    isDraft: boolean;
+
+    name: string;
+
+    relayerId: string | null;
+
+    stakingContractAddress: string | null;
+
+    startTime: string | null;
+
+    totalAllocatedAmount: number;
+
+    totalClaimedAmount: number;
+
+    totalWalletsAllocated: number;
+
+    updatedAt: string;
+
+    claimAndStake?: boolean;
+
+    isStakingOptional?: boolean;
+
+    maxBonus?: number;
+
+    minLockup?: number;
+
+    minLockupForMultiplier?: number;
+
+    minPercentageToStake?: number;
+
+    multiplier?: number;
+
+    stakingContractType?: 'linear' | 'timelock' | null;
+  }
+
+  export namespace Data {
+    export interface Contract {
+      id: string;
+
+      address: string;
+
+      chainId: number;
+
+      name: string | null;
+    }
+  }
+}
+
+export interface TokenClaimCheckEligibilityResponse {
+  alreadyClaimed: boolean;
+
+  amount: number;
+
+  claimContractAddress: string | null;
+
+  claimedAt: string | null;
+
+  eligible: boolean;
+
+  stakes: Array<TokenClaimCheckEligibilityResponse.Stake>;
+
+  tokenClaimId: string;
+}
+
+export namespace TokenClaimCheckEligibilityResponse {
+  export interface Stake {
+    amount: string;
+
+    claimable: string;
+
+    claimed: string;
+
+    duration: number;
+
+    stakeId: string;
+
+    startTime: string;
+  }
+}
+
+export interface TokenClaimGetProofResponse {
+  tokenClaimId: string;
+
+  totalAllocation: number;
+
+  walletAddress: string;
+
+  proof?: unknown;
+}
+
+export interface TokenClaimListUsersResponse {
+  data: Array<TokenClaimListUsersResponse.Data>;
+
+  hasNextPage: boolean;
+}
+
+export namespace TokenClaimListUsersResponse {
+  export interface Data {
+    id: string;
+
+    amount: number;
+
+    claimedAt: string | null;
+
+    user: Data.User;
+  }
+
+  export namespace Data {
+    export interface User {
+      id: string;
+
+      walletAddress: string;
+    }
+  }
+}
+
+export interface TokenClaimUpdateClaimResponse {
+  data: TokenClaimUpdateClaimResponse.Data;
+
+  message: string;
+}
+
+export namespace TokenClaimUpdateClaimResponse {
+  export interface Data {
+    claimedAt: string;
+
+    tokenClaimId: string;
+
+    totalAllocation: number;
+
+    walletAddress: string;
+  }
+}
+
+export interface TokenClaimRetrieveParams {
+  id: string;
+}
+
+export interface TokenClaimListParams {
+  contractId?: string;
+
+  organizationId?: string;
+
+  websiteId?: string;
+}
+
+export interface TokenClaimCheckEligibilityParams {
+  id: string;
+
+  walletAddress: string;
+}
+
+export interface TokenClaimGetProofParams {
+  id: string;
+
+  walletAddress: string;
+}
+
+export interface TokenClaimListUsersParams {
+  limit?: number;
+
+  sortBy?: 'claimedAt' | 'amount';
+
+  sortOrder?: 'asc' | 'desc';
+
+  startingAfter?: string;
+
+  walletAddress?: string;
+}
+
+export interface TokenClaimUpdateClaimParams {
+  txHash: string;
+
+  walletAddress: string;
+}
+
+export declare namespace TokenClaims {
+  export {
+    type TokenClaimRetrieveResponse as TokenClaimRetrieveResponse,
+    type TokenClaimListResponse as TokenClaimListResponse,
+    type TokenClaimCheckEligibilityResponse as TokenClaimCheckEligibilityResponse,
+    type TokenClaimGetProofResponse as TokenClaimGetProofResponse,
+    type TokenClaimListUsersResponse as TokenClaimListUsersResponse,
+    type TokenClaimUpdateClaimResponse as TokenClaimUpdateClaimResponse,
+    type TokenClaimRetrieveParams as TokenClaimRetrieveParams,
+    type TokenClaimListParams as TokenClaimListParams,
+    type TokenClaimCheckEligibilityParams as TokenClaimCheckEligibilityParams,
+    type TokenClaimGetProofParams as TokenClaimGetProofParams,
+    type TokenClaimListUsersParams as TokenClaimListUsersParams,
+    type TokenClaimUpdateClaimParams as TokenClaimUpdateClaimParams,
+  };
+}

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';