@snagsolutions/sdk 0.1.0-alpha.15 → 0.1.0-alpha.17

package/src/_shims/index.js

@@ -3,7 +3,9 @@
  */
 const shims = require('./registry');
 const auto = require('@snagsolutions/sdk/_shims/auto/runtime');
-if (!shims.kind) shims.setShims(auto.getRuntime(), { auto: true });
+exports.init = () => {
+  if (!shims.kind) shims.setShims(auto.getRuntime(), { auto: true });
+};
 for (const property of Object.keys(shims)) {
   Object.defineProperty(exports, property, {
     get() {
@@ -11,3 +13,5 @@ for (const property of Object.keys(shims)) {
     },
   });
 }
+
+exports.init();

package/src/_shims/index.mjs

@@ -3,5 +3,9 @@
  */
 import * as shims from './registry.mjs';
 import * as auto from "./auto/runtime";
-if (!shims.kind) shims.setShims(auto.getRuntime(), { auto: true });
+export const init = () => {
+  if (!shims.kind) shims.setShims(auto.getRuntime(), { auto: true });
+};
 export * from './registry.mjs';
+
+init();

package/src/core.ts

@@ -16,7 +16,12 @@ import {
   type RequestInit,
   type Response,
   type HeadersInit,
+  init,
 } from './_shims/index';
+
+// try running side effects outside of _shims/index to workaround https://github.com/vercel/next.js/issues/76881
+init();
+
 export { type Response };
 import { BlobLike, isBlobLike, isMultipartBody } from './uploads';
 export {
@@ -395,7 +400,7 @@ export abstract class APIClient {
       !headers ? {}
       : Symbol.iterator in headers ?
         Object.fromEntries(Array.from(headers as Iterable<string[]>).map((header) => [...header]))
-      : { ...headers }
+      : { ...(headers as any as Record<string, string>) }
     );
   }
 

package/src/index.ts

@@ -6,19 +6,38 @@ import * as Core from './core';
 import * as Errors from './error';
 import * as Uploads from './uploads';
 import * as API from './resources/index';
+import { AssetCreateAssetParams, AssetCreateAssetResponse, Assets } from './resources/assets';
+import { AuctionListAuctionBidsParams, AuctionListAuctionsResponse, Auctions } from './resources/auctions';
+import { Auth, AuthConnectAuthParams, AuthConnectAuthResponse } from './resources/auth';
+import { Minting, MintingGetAssetsParams, MintingGetAssetsResponse } from './resources/minting';
+import { Loyalty } from './resources/loyalty/loyalty';
 import {
-  API as ApiapiAPI,
-  APICreateAssetUploadURLParams,
-  APICreateAssetUploadURLResponse,
-  APIListAuctionBidsParams,
-  APIListAuctionsResponse,
-  APIListUsersParams,
-  APIListUsersResponse,
-} from './resources/api/api';
+  Referral,
+  ReferralCreateCodeParams,
+  ReferralCreateCodeResponse,
+} from './resources/referral/referral';
+import {
+  UserConnectParams,
+  UserConnectResponse,
+  UserCountParams,
+  UserCountResponse,
+  UserDisconnectParams,
+  UserDisconnectResponse,
+  UserListParams,
+  UserListResponse,
+  Users,
+} from './resources/users/users';
+import {
+  WebsiteCreateParams,
+  WebsiteCreateResponse,
+  WebsiteListParams,
+  WebsiteListResponse,
+  Websites,
+} from './resources/websites/websites';
 
 export interface ClientOptions {
   /**
-   * Defaults to process.env['SNAG_SOLUTIONS_API_KEY'].
+   * API key required to authenticate with the Snag Solutions API.
    */
   apiKey?: string | undefined;
 
@@ -90,8 +109,8 @@ export class SnagSolutions extends Core.APIClient {
   /**
    * API Client for interfacing with the Snag Solutions API.
    *
-   * @param {string | undefined} [opts.apiKey=process.env['SNAG_SOLUTIONS_API_KEY'] ?? undefined]
-   * @param {string} [opts.baseURL=process.env['SNAG_SOLUTIONS_BASE_URL'] ?? https://api.example.com] - Override the default base URL for the API.
+   * @param {string | undefined} [opts.apiKey=process.env['X_API_KEY'] ?? undefined]
+   * @param {string} [opts.baseURL=process.env['SNAG_SOLUTIONS_BASE_URL'] ?? https://admin.snagsolutions.io/] - Override the default base URL for the API.
    * @param {number} [opts.timeout=1 minute] - The maximum amount of time (in milliseconds) the client will wait for a response before timing out.
    * @param {number} [opts.httpAgent] - An HTTP agent used to manage HTTP(s) connections.
    * @param {Core.Fetch} [opts.fetch] - Specify a custom `fetch` function implementation.
@@ -101,19 +120,19 @@ export class SnagSolutions extends Core.APIClient {
    */
   constructor({
     baseURL = Core.readEnv('SNAG_SOLUTIONS_BASE_URL'),
-    apiKey = Core.readEnv('SNAG_SOLUTIONS_API_KEY'),
+    apiKey = Core.readEnv('X_API_KEY'),
     ...opts
   }: ClientOptions = {}) {
     if (apiKey === undefined) {
       throw new Errors.SnagSolutionsError(
-        "The SNAG_SOLUTIONS_API_KEY environment variable is missing or empty; either provide it, or instantiate the SnagSolutions client with an apiKey option, like new SnagSolutions({ apiKey: 'My API Key' }).",
+        "The X_API_KEY environment variable is missing or empty; either provide it, or instantiate the SnagSolutions client with an apiKey option, like new SnagSolutions({ apiKey: 'My API Key' }).",
       );
     }
 
     const options: ClientOptions = {
       apiKey,
       ...opts,
-      baseURL: baseURL || `https://api.example.com`,
+      baseURL: baseURL || `https://admin.snagsolutions.io/`,
     };
 
     super({
@@ -129,7 +148,14 @@ export class SnagSolutions extends Core.APIClient {
     this.apiKey = apiKey;
   }
 
-  api: API.API = new API.API(this);
+  assets: API.Assets = new API.Assets(this);
+  auth: API.Auth = new API.Auth(this);
+  auctions: API.Auctions = new API.Auctions(this);
+  users: API.Users = new API.Users(this);
+  loyalty: API.Loyalty = new API.Loyalty(this);
+  minting: API.Minting = new API.Minting(this);
+  referral: API.Referral = new API.Referral(this);
+  websites: API.Websites = new API.Websites(this);
 
   protected override defaultQuery(): Core.DefaultQuery | undefined {
     return this._options.defaultQuery;
@@ -171,18 +197,67 @@ export class SnagSolutions extends Core.APIClient {
   static fileFromPath = Uploads.fileFromPath;
 }
 
-SnagSolutions.API = ApiapiAPI;
+SnagSolutions.Assets = Assets;
+SnagSolutions.Auth = Auth;
+SnagSolutions.Auctions = Auctions;
+SnagSolutions.Users = Users;
+SnagSolutions.Loyalty = Loyalty;
+SnagSolutions.Minting = Minting;
+SnagSolutions.Referral = Referral;
+SnagSolutions.Websites = Websites;
 export declare namespace SnagSolutions {
   export type RequestOptions = Core.RequestOptions;
 
   export {
-    ApiapiAPI as API,
-    type APICreateAssetUploadURLResponse as APICreateAssetUploadURLResponse,
-    type APIListAuctionsResponse as APIListAuctionsResponse,
-    type APIListUsersResponse as APIListUsersResponse,
-    type APICreateAssetUploadURLParams as APICreateAssetUploadURLParams,
-    type APIListAuctionBidsParams as APIListAuctionBidsParams,
-    type APIListUsersParams as APIListUsersParams,
+    Assets as Assets,
+    type AssetCreateAssetResponse as AssetCreateAssetResponse,
+    type AssetCreateAssetParams as AssetCreateAssetParams,
+  };
+
+  export {
+    Auth as Auth,
+    type AuthConnectAuthResponse as AuthConnectAuthResponse,
+    type AuthConnectAuthParams as AuthConnectAuthParams,
+  };
+
+  export {
+    Auctions as Auctions,
+    type AuctionListAuctionsResponse as AuctionListAuctionsResponse,
+    type AuctionListAuctionBidsParams as AuctionListAuctionBidsParams,
+  };
+
+  export {
+    Users as Users,
+    type UserListResponse as UserListResponse,
+    type UserConnectResponse as UserConnectResponse,
+    type UserCountResponse as UserCountResponse,
+    type UserDisconnectResponse as UserDisconnectResponse,
+    type UserListParams as UserListParams,
+    type UserConnectParams as UserConnectParams,
+    type UserCountParams as UserCountParams,
+    type UserDisconnectParams as UserDisconnectParams,
+  };
+
+  export { Loyalty as Loyalty };
+
+  export {
+    Minting as Minting,
+    type MintingGetAssetsResponse as MintingGetAssetsResponse,
+    type MintingGetAssetsParams as MintingGetAssetsParams,
+  };
+
+  export {
+    Referral as Referral,
+    type ReferralCreateCodeResponse as ReferralCreateCodeResponse,
+    type ReferralCreateCodeParams as ReferralCreateCodeParams,
+  };
+
+  export {
+    Websites as Websites,
+    type WebsiteCreateResponse as WebsiteCreateResponse,
+    type WebsiteListResponse as WebsiteListResponse,
+    type WebsiteCreateParams as WebsiteCreateParams,
+    type WebsiteListParams as WebsiteListParams,
   };
 }
 

package/src/resources/assets.ts

@@ -0,0 +1,77 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../resource';
+import * as Core from '../core';
+
+export class Assets extends APIResource {
+  /**
+   * This endpoint enables you to upload a file to the resource. Returns a presigned
+   * URL and the asset's public URL. Call PUT with the file as the body to upload the
+   * asset using the presigned URL.
+   */
+  createAsset(
+    body: AssetCreateAssetParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<AssetCreateAssetResponse> {
+    return this._client.post('/api/assets', { body, ...options });
+  }
+}
+
+/**
+ * Response returned upon successful generation of the signed URL for uploading the
+ * file.
+ */
+export interface AssetCreateAssetResponse {
+  /**
+   * The pre-signed URL to be used for uploading the file.
+   */
+  signedUrl: string;
+
+  /**
+   * The URL of the uploaded file.
+   */
+  url: string;
+}
+
+export interface AssetCreateAssetParams {
+  /**
+   * The name of the file, must match the regex pattern (converted to lowercase)
+   */
+  fileName: string;
+
+  /**
+   * The file path, must be a valid enum value.
+   */
+  filePath?:
+    | 'announcements'
+    | 'images'
+    | 'videos'
+    | 'banners'
+    | 'fonts'
+    | 'posts'
+    | 'profiles'
+    | 'minting'
+    | 'loyalty';
+
+  /**
+   * UUID of the organization (optional, converted to lowercase)
+   */
+  organizationId?: string;
+
+  /**
+   * UUID of the user (optional, converted to lowercase)
+   */
+  userId?: string;
+
+  /**
+   * UUID of the website (optional, converted to lowercase)
+   */
+  websiteId?: string;
+}
+
+export declare namespace Assets {
+  export {
+    type AssetCreateAssetResponse as AssetCreateAssetResponse,
+    type AssetCreateAssetParams as AssetCreateAssetParams,
+  };
+}

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,11 +1,30 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+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 { Minting, type MintingGetAssetsResponse, type MintingGetAssetsParams } from './minting';
 export {
-  API,
-  type APICreateAssetUploadURLResponse,
-  type APIListAuctionsResponse,
-  type APIListUsersResponse,
-  type APICreateAssetUploadURLParams,
-  type APIListAuctionBidsParams,
-  type APIListUsersParams,
-} from './api/api';
+  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/websites';

package/src/resources/{api/loyalty → loyalty}/accounts.ts

@@ -1,8 +1,8 @@
 // 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 { APIResource } from '../../resource';
+import { isRequestOptions } from '../../core';
+import * as Core from '../../core';
 
 export class Accounts extends APIResource {
   /**
@@ -25,12 +25,12 @@ export class Accounts extends APIResource {
    * loyalty currency. This can be a slow operation for large organizations. We
    * recommend caching when possible.
    */
-  getRank(
-    pathId: string,
-    query: AccountGetRankParams,
+  retrieveRank(
+    id: string,
+    query: AccountRetrieveRankParams,
     options?: Core.RequestOptions,
-  ): Core.APIPromise<AccountGetRankResponse> {
-    return this._client.get(`/api/loyalty/accounts/${pathId}/rank`, { query, ...options });
+  ): Core.APIPromise<AccountRetrieveRankResponse> {
+    return this._client.get(`/api/loyalty/accounts/${id}/rank`, { query, ...options });
   }
 }
 
@@ -145,7 +145,10 @@ export namespace AccountListResponse {
   }
 }
 
-export interface AccountGetRankResponse {
+/**
+ * Schema for a get account rank response
+ */
+export interface AccountRetrieveRankResponse {
   /**
    * Rank of the user
    */
@@ -224,12 +227,7 @@ export interface AccountListParams {
   websiteId?: string;
 }
 
-export interface AccountGetRankParams {
-  /**
-   * UUID of the account
-   */
-  query_id: string;
-
+export interface AccountRetrieveRankParams {
   /**
    * UUID of the loyalty currency
    */
@@ -249,8 +247,8 @@ export interface AccountGetRankParams {
 export declare namespace Accounts {
   export {
     type AccountListResponse as AccountListResponse,
-    type AccountGetRankResponse as AccountGetRankResponse,
+    type AccountRetrieveRankResponse as AccountRetrieveRankResponse,
     type AccountListParams as AccountListParams,
-    type AccountGetRankParams as AccountGetRankParams,
+    type AccountRetrieveRankParams as AccountRetrieveRankParams,
   };
 }

package/src/resources/{api/loyalty → loyalty}/badges.ts

@@ -1,8 +1,8 @@
 // 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 { APIResource } from '../../resource';
+import { isRequestOptions } from '../../core';
+import * as Core from '../../core';
 
 export class Badges extends APIResource {
   /**