@snagsolutions/sdk 0.1.0-alpha.11 → 0.1.0-alpha.111

package/src/resources/minting.ts

@@ -0,0 +1,170 @@
+// 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'
+    | 'berachain'
+    | 'berachainArtio'
+    | 'berachainBepolia'
+    | 'binance'
+    | 'bscTestnet'
+    | 'campTestnet'
+    | 'fantom'
+    | 'fantomTestnet'
+    | 'flowMainnet'
+    | 'mainnet'
+    | 'optimism'
+    | 'polygon'
+    | 'polygon_mumbai'
+    | 'skaleNebula'
+    | 'solana'
+    | 'sophon'
+    | 'sophonTestnet'
+    | 'sui'
+    | 'superseed'
+    | 'superseedSepolia'
+    | 'vanar'
+    | 'xai'
+    | 'zksync'
+    | 'coti'
+    | 'cotiTestnet'
+    | 'morph'
+    | 'morphTestnet'
+    | 'morphHolesky'
+    | 'ultra'
+    | 'ultraTestnet'
+    | 'nitrograph'
+    | 'sepolia'
+    | 'optimism_sepolia'
+    | 'arbitrumSepolia'
+    | 'goerli'
+    | 'optimism_goerli'
+    | 'arbitrumGoerli'
+    | 'basecamp';
+
+  /**
+   * Sort Key
+   */
+  sortBy?: 'price' | 'startsAt' | 'assetNr' | null;
+
+  /**
+   * Sort Dir
+   */
+  sortDir?: 'asc' | 'desc' | 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,
+  };
+}

package/src/resources/referral/index.ts

@@ -0,0 +1,10 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Referral, type ReferralCreateCodeResponse, type ReferralCreateCodeParams } from './referral';
+export {
+  Users,
+  type UserCreateResponse,
+  type UserListResponse,
+  type UserCreateParams,
+  type UserListParams,
+} from './users';

package/src/resources/referral/referral.ts

@@ -0,0 +1,72 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../resource';
+import * as Core from '../../core';
+import * as UsersAPI from './users';
+import { UserCreateParams, UserCreateResponse, UserListParams, UserListResponse, Users } from './users';
+
+export class Referral extends APIResource {
+  users: UsersAPI.Users = new UsersAPI.Users(this._client);
+
+  /**
+   * 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> {
+    return this._client.post('/api/referral/codes', { body, ...options });
+  }
+}
+
+export interface ReferralCreateCodeResponse {
+  id: string;
+
+  createdAt: string;
+
+  deletedAt: string | null;
+
+  organizationId: string;
+
+  referralCode: string;
+
+  updatedAt: string;
+
+  userId: string;
+
+  websiteId: string;
+}
+
+export interface ReferralCreateCodeParams {
+  loyaltyRuleId: string;
+
+  organizationId?: string;
+
+  userId?: string;
+
+  websiteId?: string;
+}
+
+Referral.Users = Users;
+
+export declare namespace Referral {
+  export {
+    type ReferralCreateCodeResponse as ReferralCreateCodeResponse,
+    type ReferralCreateCodeParams as ReferralCreateCodeParams,
+  };
+
+  export {
+    Users as Users,
+    type UserCreateResponse as UserCreateResponse,
+    type UserListResponse as UserListResponse,
+    type UserCreateParams as UserCreateParams,
+    type UserListParams as UserListParams,
+  };
+}

package/src/resources/referral/users.ts

@@ -0,0 +1,122 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../resource';
+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 });
+  }
+
+  /**
+   * This endpoint allows you to get referrals
+   *
+   * @example
+   * ```ts
+   * const users = await client.referral.users.list({
+   *   walletAddress: 'string',
+   * });
+   * ```
+   */
+  list(query: UserListParams, options?: Core.RequestOptions): Core.APIPromise<UserListResponse> {
+    return this._client.get('/api/referral/users', { query, ...options });
+  }
+}
+
+export interface UserCreateResponse {
+  message: string;
+}
+
+export interface UserListResponse {
+  data: Array<UserListResponse.Data>;
+
+  hasNextPage: boolean;
+}
+
+export namespace UserListResponse {
+  export interface Data {
+    id: string;
+
+    referralCode: Data.ReferralCode;
+
+    user: Data.User;
+  }
+
+  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;
+    }
+
+    export interface User {
+      id: string;
+
+      walletAddress: string;
+    }
+  }
+}
+
+export interface UserCreateParams {
+  userIds: Array<string>;
+
+  referralCode?: string;
+
+  referralCodeId?: string;
+}
+
+export interface UserListParams {
+  walletAddress: string | Array<string>;
+
+  limit?: number;
+
+  loyaltyRuleId?: string;
+
+  organizationId?: string;
+
+  startingAfter?: string;
+
+  websiteId?: string;
+}
+
+export declare namespace Users {
+  export {
+    type UserCreateResponse as UserCreateResponse,
+    type UserListResponse as UserListResponse,
+    type UserCreateParams as UserCreateParams,
+    type UserListParams as UserListParams,
+  };
+}

package/src/resources/referral.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './referral/index';

package/src/resources/users/index.ts

@@ -1,12 +1,24 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Metadatas, type MetadataCreateResponse, type MetadataCreateParams } from './metadatas';
-export { Users } from './users';
 export {
-  Wallets,
-  type WalletCreateResponse,
-  type WalletListResponse,
-  type WalletDeleteResponse,
-  type WalletCreateParams,
-  type WalletListParams,
-} from './wallets';
+  Metadatas,
+  type MetadataCreateResponse,
+  type MetadataListResponse,
+  type MetadataCreateParams,
+  type MetadataListParams,
+} from './metadatas';
+export {
+  Users,
+  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

@@ -6,7 +6,12 @@ import * as Core from '../../core';
 
 export class Metadatas extends APIResource {
   /**
-   * This endpoint allows you to create or edit a user metadata
+   * 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>;
@@ -19,10 +24,30 @@ export class Metadatas extends APIResource {
     }
     return this._client.post('/api/users/metadatas', { body, ...options });
   }
+
+  /**
+   * 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>;
+  list(
+    query: MetadataListParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<MetadataListResponse> {
+    if (isRequestOptions(query)) {
+      return this.list({}, query);
+    }
+    return this._client.get('/api/users/metadatas', { query, ...options });
+  }
 }
 
 /**
- * Schema for user metadata response
+ * Schema for a user metadata
  */
 export interface MetadataCreateResponse {
   /**
@@ -40,15 +65,14 @@ export interface MetadataCreateResponse {
    */
   organizationId: string;
 
-  /**
-   * Timestamp when the wallet was last updated
-   */
-  updatedAt: string;
+  user: MetadataCreateResponse.User;
+
+  userGroup: MetadataCreateResponse.UserGroup;
 
   /**
-   * Validated and formatted wallet address
+   * Identifier for the user group set via api
    */
-  walletAddress: string;
+  userGroupId: string | null;
 
   /**
    * Identifier for the user wallet group set via api
@@ -61,7 +85,65 @@ export interface MetadataCreateResponse {
   websiteId: string;
 }
 
+export namespace MetadataCreateResponse {
+  export interface User {
+    /**
+     * Id for the user
+     */
+    id: string;
+
+    /**
+     * Wallet address of the user
+     */
+    walletAddress: string;
+  }
+
+  export interface UserGroup {
+    /**
+     * id for the user group
+     */
+    id: string;
+
+    /**
+     * External identifier for the user group
+     */
+    externalIdentifier: string | null;
+  }
+}
+
+/**
+ * Response schema for fetching user metadata
+ */
+export interface MetadataListResponse {
+  data: Array<MetadataListResponse.Data>;
+
+  /**
+   * Indicates if there are more records available
+   */
+  hasNextPage: boolean;
+}
+
+export namespace MetadataListResponse {
+  export interface Data {
+    /**
+     * Unique identifier for the user metadata
+     */
+    id: string;
+  }
+}
+
 export interface MetadataCreateParams {
+  blockStatusReason?:
+    | 'sybil_and_multi_account'
+    | 'account_migration'
+    | 'abuse_manipulation'
+    | 'not_sybil'
+    | 'issue_resolved'
+    | 'twitter_suspended'
+    | 'block_exempt'
+    | 'other'
+    | null;
+
   discordUser?: string | null;
 
   discordUserId?: string | null;
@@ -72,32 +154,103 @@ export interface MetadataCreateParams {
 
   epicAccountIdentifier?: string | null;
 
+  externalIdentifier?: string | null;
+
+  externalLoyaltyScore?: string | null;
+
+  googleUser?: string | null;
+
+  googleUserId?: string | null;
+
+  internalNotes?: string | null;
+
   isBlocked?: boolean;
 
   logoUrl?: string | null;
 
+  organizationId?: string;
+
   stardustProfileIdentifier?: string | null;
 
   stardustWalletIdentifier?: string | null;
 
+  steamUserId?: string | null;
+
+  steamUsername?: string | 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;
+
+  userGroupId?: string;
+
   userId?: string;
 
   walletAddress?: string;
 
   walletGroupIdentifier?: string | null;
+
+  websiteId?: string;
+
+  YTChannelId?: string | null;
+}
+
+export interface MetadataListParams {
+  /**
+   * External identifier for the user
+   */
+  externalIdentifier?: string | null;
+
+  /**
+   * Number of records to fetch
+   */
+  limit?: number;
+
+  /**
+   * UUID of the organization
+   */
+  organizationId?: string;
+
+  /**
+   * Fetch records starting after this ID
+   */
+  startingAfter?: string;
+
+  /**
+   * UUID of the user
+   */
+  userId?: string;
+
+  userSearch?: string;
+
+  /**
+   * Wallet address of the user
+   */
+  walletAddress?: string;
+
+  /**
+   * UUID of the website
+   */
+  websiteId?: string;
 }
 
 export declare namespace Metadatas {
   export {
     type MetadataCreateResponse as MetadataCreateResponse,
+    type MetadataListResponse as MetadataListResponse,
     type MetadataCreateParams as MetadataCreateParams,
+    type MetadataListParams as MetadataListParams,
   };
 }