@snagsolutions/sdk 0.1.0-alpha.14 → 0.1.0-alpha.16

package/src/resources/auctions.ts

@@ -0,0 +1,209 @@
+// 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 Auctions extends APIResource {
+  /**
+   * Returns a list of auction bids with optional filtering and pagination.
+   */
+  listAuctionBids(query?: AuctionListAuctionBidsParams, options?: Core.RequestOptions): Core.APIPromise<void>;
+  listAuctionBids(options?: Core.RequestOptions): Core.APIPromise<void>;
+  listAuctionBids(
+    query: AuctionListAuctionBidsParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<void> {
+    if (isRequestOptions(query)) {
+      return this.listAuctionBids({}, query);
+    }
+    return this._client.get('/api/auction_bids', {
+      query,
+      ...options,
+      headers: { Accept: '*/*', ...options?.headers },
+    });
+  }
+
+  /**
+   * Returns a list of auctions with optional filtering and pagination.
+   */
+  listAuctions(options?: Core.RequestOptions): Core.APIPromise<AuctionListAuctionsResponse> {
+    return this._client.get('/api/auctions', options);
+  }
+}
+
+/**
+ * Schema for the response when fetching auctions
+ */
+export interface AuctionListAuctionsResponse {
+  data: Array<AuctionListAuctionsResponse.Data>;
+
+  hasNextPage: boolean;
+}
+
+export namespace AuctionListAuctionsResponse {
+  export interface Data {
+    id: string;
+
+    auctionBids: Array<Data.AuctionBid>;
+
+    auctionItems: Array<Data.AuctionItem>;
+
+    biddersOwnCollectionAddresses: Array<string>;
+
+    createdAt: string;
+
+    currencyAddress: string | null;
+
+    currencyDecimals: number;
+
+    deletedAt: string | null;
+
+    description: string;
+
+    endsAt: string;
+
+    extendedDurationInSeconds: number | null;
+
+    hideBids: boolean;
+
+    /**
+     * Schema representing a loyalty currency
+     */
+    loyaltyCurrency: Data.LoyaltyCurrency | null;
+
+    loyaltyCurrencyId: string | null;
+
+    minBidAmount: string;
+
+    minBidIncrement: string | null;
+
+    mintingContractId: string;
+
+    name: string;
+
+    network: 'ethereum' | 'zksync';
+
+    organizationId: string;
+
+    reservePrice: string | null;
+
+    signature: string;
+
+    startsAt: string;
+
+    status: 'in_progress' | 'completed' | 'cancelled';
+
+    type: 'first_price' | 'second_price' | 'english';
+
+    updatedAt: string;
+
+    userId: string;
+
+    websiteId: string;
+  }
+
+  export namespace Data {
+    /**
+     * Schema representing an auction bid
+     */
+    export interface AuctionBid {
+      id: string;
+
+      amount: string;
+
+      createdAt: string;
+    }
+
+    export interface AuctionItem {
+      id: string;
+
+      /**
+       * Schema representing a minting contract asset
+       */
+      mintingContractAsset: AuctionItem.MintingContractAsset;
+
+      quantity: number;
+
+      sortId: number;
+    }
+
+    export namespace AuctionItem {
+      /**
+       * Schema representing a minting contract asset
+       */
+      export interface MintingContractAsset {
+        id: string;
+      }
+    }
+
+    /**
+     * Schema representing a loyalty currency
+     */
+    export interface LoyaltyCurrency {
+      id: string;
+
+      decimals: number;
+
+      imageUrl: string | null;
+
+      name: string;
+
+      symbol: string;
+    }
+  }
+}
+
+export interface AuctionListAuctionBidsParams {
+  /**
+   * The bid ID
+   */
+  id?: string;
+
+  /**
+   * ID of the auction
+   */
+  auctionId?: string;
+
+  /**
+   * Maximum number of bids to return
+   */
+  limit?: number;
+
+  /**
+   * ID of the organization
+   */
+  organizationId?: string;
+
+  /**
+   * Pagination cursor to start after a specific bid ID
+   */
+  startingAfter?: string;
+
+  /**
+   * Status of the bid
+   */
+  status?: 'submitted' | 'accepted' | 'rejected' | 'fulfilled';
+
+  /**
+   * ID of the user who made the bid
+   */
+  userId?: string;
+
+  /**
+   * Wallet address of the bidder
+   */
+  walletAddress?: string;
+
+  /**
+   * ID of the website
+   */
+  websiteId?: string;
+}
+
+export declare namespace Auctions {
+  export {
+    type AuctionListAuctionsResponse as AuctionListAuctionsResponse,
+    type AuctionListAuctionBidsParams as AuctionListAuctionBidsParams,
+  };
+}

package/src/resources/auth.ts

@@ -0,0 +1,69 @@
+// 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 Auth extends APIResource {
+  /**
+   * This endpoint allows you to connect your Twitter account to a Snag account
+   */
+  connectAuth(
+    authType: 'twitter' | 'discord' | 'telegram' | 'epic' | 'steam',
+    query?: AuthConnectAuthParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<AuthConnectAuthResponse>;
+  connectAuth(
+    authType: 'twitter' | 'discord' | 'telegram' | 'epic' | 'steam',
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<AuthConnectAuthResponse>;
+  connectAuth(
+    authType: 'twitter' | 'discord' | 'telegram' | 'epic' | 'steam',
+    query: AuthConnectAuthParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<AuthConnectAuthResponse> {
+    if (isRequestOptions(query)) {
+      return this.connectAuth(authType, {}, query);
+    }
+    return this._client.get(`/api/${authType}/auth`, { query, ...options });
+  }
+}
+
+/**
+ * Schema for a connect social auth response schema
+ */
+export interface AuthConnectAuthResponse {
+  /**
+   * The URL to redirect to
+   */
+  url: string;
+}
+
+export interface AuthConnectAuthParams {
+  /**
+   * The redirect URL where the user will land after completing the auth
+   */
+  redirect?: string;
+
+  /**
+   * The type of response to return
+   */
+  responseType?: 'redirect' | 'json';
+
+  /**
+   * The ID of the user
+   */
+  userId?: string;
+
+  /**
+   * The ID of the website
+   */
+  websiteId?: string;
+}
+
+export declare namespace Auth {
+  export {
+    type AuthConnectAuthResponse as AuthConnectAuthResponse,
+    type AuthConnectAuthParams as AuthConnectAuthParams,
+  };
+}

package/src/resources/index.ts

@@ -1,19 +1,30 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export {
-  Assets,
-  type AssetCreateResponse,
-  type AssetGetAuctionsResponse,
-  type AssetCreateParams,
-} from './assets/assets';
-export { AuctionBids, type AuctionBidListParams } from './auction-bids';
-export { Drip } from './drip/drip';
+export { Assets, type AssetCreateAssetResponse, type AssetCreateAssetParams } from './assets';
+export { Auctions, type AuctionListAuctionsResponse, type AuctionListAuctionBidsParams } from './auctions';
+export { Auth, type AuthConnectAuthResponse, type AuthConnectAuthParams } from './auth';
 export { Loyalty } from './loyalty/loyalty';
-export { Users } from './users/users';
+export { Minting, type MintingGetAssetsResponse, type MintingGetAssetsParams } from './minting';
+export {
+  Referral,
+  type ReferralCreateCodeResponse,
+  type ReferralCreateCodeParams,
+} from './referral/referral';
+export {
+  Users,
+  type UserListResponse,
+  type UserConnectResponse,
+  type UserCountResponse,
+  type UserDisconnectResponse,
+  type UserListParams,
+  type UserConnectParams,
+  type UserCountParams,
+  type UserDisconnectParams,
+} from './users/users';
 export {
   Websites,
   type WebsiteCreateResponse,
   type WebsiteListResponse,
   type WebsiteCreateParams,
   type WebsiteListParams,
-} from './websites';
+} from './websites/websites';

package/src/resources/loyalty/accounts.ts

@@ -1,5 +1,254 @@
 // 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 Accounts extends APIResource {}
+export class Accounts extends APIResource {
+  /**
+   * Get loyalty accounts
+   */
+  list(query?: AccountListParams, options?: Core.RequestOptions): Core.APIPromise<AccountListResponse>;
+  list(options?: Core.RequestOptions): Core.APIPromise<AccountListResponse>;
+  list(
+    query: AccountListParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<AccountListResponse> {
+    if (isRequestOptions(query)) {
+      return this.list({}, query);
+    }
+    return this._client.get('/api/loyalty/accounts', { query, ...options });
+  }
+
+  /**
+   * Returns the user's rank determined by their loyalty points for the specified
+   * loyalty currency. This can be a slow operation for large organizations. We
+   * recommend caching when possible.
+   */
+  retrieveRank(
+    id: string,
+    query: AccountRetrieveRankParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<AccountRetrieveRankResponse> {
+    return this._client.get(`/api/loyalty/accounts/${id}/rank`, { query, ...options });
+  }
+}
+
+/**
+ * Schema for the response of getting loyalty accounts
+ */
+export interface AccountListResponse {
+  /**
+   * Array of loyalty accounts
+   */
+  data: Array<AccountListResponse.Data>;
+
+  /**
+   * Indicates if there is a next page of results
+   */
+  hasNextPage: boolean;
+
+  /**
+   * Optional message
+   */
+  message?: string;
+}
+
+export namespace AccountListResponse {
+  /**
+   * Schema for a loyalty account
+   */
+  export interface Data {
+    /**
+     * Unique identifier for the loyalty account
+     */
+    id: string;
+
+    /**
+     * Unique identifier for the loyalty currency
+     */
+    loyaltyCurrencyId: string;
+
+    /**
+     * User associated with the loyalty account
+     */
+    user: Data.User | null;
+
+    /**
+     * Unique identifier for the user
+     */
+    userId: string | null;
+
+    /**
+     * Balance amount in the loyalty account
+     */
+    amount?: unknown;
+
+    /**
+     * Version number used for optimistic locking
+     */
+    lockVersion?: unknown;
+  }
+
+  export namespace Data {
+    /**
+     * Schema for a user
+     */
+    export interface User {
+      /**
+       * Unique identifier for the user
+       */
+      id: string;
+
+      /**
+       * Array of metadata associated with the user
+       */
+      userMetadata: Array<User.UserMetadata>;
+
+      /**
+       * Ethereum wallet address of the user
+       */
+      walletAddress: string | null;
+    }
+
+    export namespace User {
+      /**
+       * Schema for user metadata
+       */
+      export interface UserMetadata {
+        /**
+         * Discord username associated with the user
+         */
+        discordUser: string | null;
+
+        /**
+         * Display name of the user
+         */
+        displayName: string | null;
+
+        /**
+         * URL of the user's logo
+         */
+        logoUrl: string | null;
+
+        /**
+         * Twitter username associated with the user
+         */
+        twitterUser: string | null;
+
+        /**
+         * Identifier for the wallet group
+         */
+        walletGroupIdentifier: string | null;
+      }
+    }
+  }
+}
+
+/**
+ * Schema for a get account rank response
+ */
+export interface AccountRetrieveRankResponse {
+  /**
+   * Rank of the user
+   */
+  rank: number;
+}
+
+export interface AccountListParams {
+  /**
+   * Discord username to filter accounts by
+   */
+  discordUser?: string;
+
+  /**
+   * External identifier for the user
+   */
+  externalIdentifier?: string;
+
+  /**
+   * Maximum number of accounts to return
+   */
+  limit?: number;
+
+  /**
+   * Unique identifier for the loyalty currency
+   */
+  loyaltyCurrencyId?: string;
+
+  /**
+   * Order the accounts by amount in ascending or descending order
+   */
+  'orderBy[amount]'?: 'asc' | 'desc';
+
+  /**
+   * Unique identifier for the organization to filter by
+   */
+  organizationId?: string;
+
+  /**
+   * Pagination cursor to start after a specific account ID
+   */
+  startingAfter?: string;
+
+  /**
+   * Twitter username to filter accounts by
+   */
+  twitterUser?: string;
+
+  /**
+   * External identifier for the user group controlled by you
+   */
+  userGroupExternalIdentifier?: string;
+
+  /**
+   * Unique identifier for the user group
+   */
+  userGroupId?: string;
+
+  /**
+   * User ID(s) to filter accounts by
+   */
+  userId?: string | Array<string>;
+
+  /**
+   * Wallet address(es) to filter accounts by
+   */
+  walletAddress?: string | Array<string>;
+
+  /**
+   * Wallet group identifier to filter accounts by
+   */
+  walletGroupIdentifier?: string;
+
+  /**
+   * Unique identifier for the website to filter by
+   */
+  websiteId?: string;
+}
+
+export interface AccountRetrieveRankParams {
+  /**
+   * UUID of the loyalty currency
+   */
+  loyaltyCurrencyId: string;
+
+  /**
+   * UUID of the organization
+   */
+  organizationId: string;
+
+  /**
+   * UUID of the website
+   */
+  websiteId: string;
+}
+
+export declare namespace Accounts {
+  export {
+    type AccountListResponse as AccountListResponse,
+    type AccountRetrieveRankResponse as AccountRetrieveRankResponse,
+    type AccountListParams as AccountListParams,
+    type AccountRetrieveRankParams as AccountRetrieveRankParams,
+  };
+}

package/src/resources/loyalty/badges.ts

@@ -1020,6 +1020,11 @@ export namespace BadgeCreateParams {
      */
     loyaltyLeaderboardViewIds?: Array<string>;
 
+    /**
+     * UUID of the loyalty rule chain (optional, converted to lowercase)
+     */
+    loyaltyRuleChainId?: string;
+
     /**
      * Array of UUIDs of the rule group (optional, converted to lowercase)
      */

package/src/resources/loyalty/currencies.ts

@@ -19,6 +19,9 @@ export class Currencies extends APIResource {
   }
 }
 
+/**
+ * Schema for a loyalty currency
+ */
 export interface CurrencyCreateResponse {
   /**
    * Unique identifier for the loyalty currency
@@ -118,6 +121,9 @@ export interface CurrencyListResponse {
 }
 
 export namespace CurrencyListResponse {
+  /**
+   * Schema for a loyalty currency
+   */
   export interface Data {
     /**
      * Unique identifier for the loyalty currency

package/src/resources/loyalty/index.ts

@@ -1,6 +1,12 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Accounts } from './accounts';
+export {
+  Accounts,
+  type AccountListResponse,
+  type AccountRetrieveRankResponse,
+  type AccountListParams,
+  type AccountRetrieveRankParams,
+} from './accounts';
 export {
   Badges,
   type BadgeCreateResponse,
@@ -29,18 +35,40 @@ export {
   type MultiplierUpdateResponse,
   type MultiplierListResponse,
   type MultiplierDeleteResponse,
+  type MultiplierDeleteByExternalIDResponse,
   type MultiplierCreateParams,
   type MultiplierUpdateParams,
   type MultiplierListParams,
-  type MultiplierDeleteParams,
+  type MultiplierDeleteByExternalIDParams,
 } from './multipliers';
+export {
+  Questions,
+  type QuestionCreateResponse,
+  type QuestionUpdateResponse,
+  type QuestionListResponse,
+  type QuestionCreateParams,
+  type QuestionUpdateParams,
+  type QuestionListParams,
+} from './questions';
+export {
+  QuestionsResponses,
+  type QuestionsResponseListResponse,
+  type QuestionsResponseSubmitResponse,
+  type QuestionsResponseListParams,
+  type QuestionsResponseSubmitParams,
+} from './questions-responses';
 export {
   RuleEdits,
-  type RuleEditRetrieveResponse,
+  type RuleEditListResponse,
   type RuleEditRestoreResponse,
-  type RuleEditRetrieveParams,
+  type RuleEditListParams,
   type RuleEditRestoreParams,
 } from './rule-edits';
+export {
+  RuleGroups,
+  type RuleGroupGetRuleGroupsResponse,
+  type RuleGroupGetRuleGroupsParams,
+} from './rule-groups';
 export {
   Rules,
   type RuleCreateResponse,
@@ -48,19 +76,17 @@ export {
   type RuleListResponse,
   type RuleDeleteResponse,
   type RuleCompleteResponse,
-  type RuleStatusResponse,
+  type RuleGetStatusResponse,
   type RuleCreateParams,
   type RuleUpdateParams,
   type RuleListParams,
   type RuleCompleteParams,
-  type RuleStatusParams,
+  type RuleGetStatusParams,
 } from './rules';
 export {
-  TransactionEntries,
-  type TransactionEntryListResponse,
-  type TransactionEntryCreateTransactionResponse,
-  type TransactionEntryListRuleGroupsResponse,
-  type TransactionEntryListParams,
-  type TransactionEntryCreateTransactionParams,
-  type TransactionEntryListRuleGroupsParams,
-} from './transaction-entries/index';
+  Transactions,
+  type TransactionCreateTransactionResponse,
+  type TransactionGetTransactionEntriesResponse,
+  type TransactionCreateTransactionParams,
+  type TransactionGetTransactionEntriesParams,
+} from './transactions';