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

package/src/resources/assets.ts

@@ -8,6 +8,14 @@ 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.
+   *
+   * @example
+   * ```ts
+   * const response = await client.assets.createAsset({
+   *   fileName: 'example.png',
+   *   fileSize: 1024,
+   * });
+   * ```
    */
   createAsset(
     body: AssetCreateAssetParams,
@@ -35,10 +43,17 @@ export interface AssetCreateAssetResponse {
 
 export interface AssetCreateAssetParams {
   /**
-   * The name of the file, must match the regex pattern (converted to lowercase)
+   * The name of the file, must match the regex pattern (converted to lowercase) and
+   * have a valid extension.
    */
   fileName: string;
 
+  /**
+   * Size of the file in bytes. Uploaded file must match this file size. 1mb for
+   * images and 10mb for videos.
+   */
+  fileSize: number;
+
   /**
    * The file path, must be a valid enum value.
    */
@@ -51,7 +66,8 @@ export interface AssetCreateAssetParams {
     | 'posts'
     | 'profiles'
     | 'minting'
-    | 'loyalty';
+    | 'loyalty'
+    | 'tokenClaims';
 
   /**
    * UUID of the organization (optional, converted to lowercase)

package/src/resources/auctions/auctions.ts

@@ -0,0 +1,432 @@
+// 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 WebsiteUserAttributesAPI from './website-user-attributes/website-user-attributes';
+import {
+  WebsiteUserAttributeCreateParams,
+  WebsiteUserAttributeCreateResponse,
+  WebsiteUserAttributeDeleteParams,
+  WebsiteUserAttributeDeleteResponse,
+  WebsiteUserAttributes,
+} from './website-user-attributes/website-user-attributes';
+
+export class Auctions extends APIResource {
+  websiteUserAttributes: WebsiteUserAttributesAPI.WebsiteUserAttributes =
+    new WebsiteUserAttributesAPI.WebsiteUserAttributes(this._client);
+
+  /**
+   * This endpoint allows you to fetch page sections
+   *
+   * @example
+   * ```ts
+   * const response = await client.auctions.getPageSections({
+   *   organizationId: '123e4567-e89b-12d3-a456-426614174334',
+   *   placement: 'page',
+   *   websiteId: '123e4567-e89b-12d3-a456-426614174333',
+   * });
+   * ```
+   */
+  getPageSections(
+    query: AuctionGetPageSectionsParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<AuctionGetPageSectionsResponse> {
+    return this._client.get('/api/page_sections', { query, ...options });
+  }
+
+  /**
+   * Returns a list of auction bids with optional filtering and pagination.
+   *
+   * @example
+   * ```ts
+   * await client.auctions.listAuctionBids();
+   * ```
+   */
+  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.
+   *
+   * @example
+   * ```ts
+   * const response = await client.auctions.listAuctions();
+   * ```
+   */
+  listAuctions(options?: Core.RequestOptions): Core.APIPromise<AuctionListAuctionsResponse> {
+    return this._client.get('/api/auctions', options);
+  }
+}
+
+export interface AuctionGetPageSectionsResponse {
+  /**
+   * Unique identifier for the page section
+   */
+  id: string;
+
+  /**
+   * Start time of the page section visibility
+   */
+  durationStart: string;
+
+  /**
+   * Unique identifier for the organization
+   */
+  organizationId: string;
+
+  /**
+   * Placement of the page section
+   */
+  placement: 'global' | 'page';
+
+  /**
+   * Unique identifier for the website
+   */
+  websiteId: string;
+
+  banner?: AuctionGetPageSectionsResponse.Banner | null;
+
+  discoveryItems?: Array<AuctionGetPageSectionsResponse.DiscoveryItem>;
+
+  /**
+   * End time of the page section visibility
+   */
+  durationEnd?: string | null;
+
+  itemsGrids?: Array<AuctionGetPageSectionsResponse.ItemsGrid>;
+
+  /**
+   * ID of the page this section belongs to
+   */
+  pageId?: string;
+
+  /**
+   * Type of the page section
+   */
+  pageSectionType?: 'all_items' | 'discovery_item' | 'discovery_items_grid' | null;
+
+  /**
+   * Order of the page section
+   */
+  sortId?: number;
+
+  /**
+   * Title of the page section
+   */
+  title?: string | null;
+}
+
+export namespace AuctionGetPageSectionsResponse {
+  export interface Banner {
+    id: string;
+
+    websiteCollectionBanners: Array<Banner.WebsiteCollectionBanner>;
+
+    carousel?: Banner.Carousel | null;
+  }
+
+  export namespace Banner {
+    export interface WebsiteCollectionBanner {
+      id: string;
+
+      websiteCollectionId: string;
+    }
+
+    export interface Carousel {
+      id: string;
+
+      carouselItems: Array<Carousel.CarouselItem>;
+    }
+
+    export namespace Carousel {
+      export interface CarouselItem {
+        id: string;
+
+        sortId: number;
+      }
+    }
+  }
+
+  export interface DiscoveryItem {
+    id: string;
+
+    title: string;
+
+    buttonText?: string | null;
+
+    description?: string | null;
+
+    externalLink?: string | null;
+
+    hideQuestInfo?: boolean;
+
+    layout?: 'container_style' | 'full_width_hero' | null;
+
+    loyaltyRuleGroupId?: string | null;
+
+    loyaltySection?: string | null;
+
+    mediaLink?: string | null;
+
+    pageMediaLink?: string | null;
+
+    sortId?: number;
+
+    twitter?: string | null;
+
+    website?: string | null;
+  }
+
+  export interface ItemsGrid {
+    id: string;
+
+    websiteCollection: ItemsGrid.WebsiteCollection;
+  }
+
+  export namespace ItemsGrid {
+    export interface WebsiteCollection {
+      id: string;
+
+      mintingContractId?: string | null;
+    }
+  }
+}
+
+/**
+ * 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 AuctionGetPageSectionsParams {
+  /**
+   * Unique identifier for the organization to filter by
+   */
+  organizationId: string;
+
+  /**
+   * Placement of the page section
+   */
+  placement: 'global' | 'page';
+
+  /**
+   * Unique identifier for the website to filter by
+   */
+  websiteId: string;
+
+  /**
+   * Whether to get all sections regardless of duration
+   */
+  all?: '1';
+
+  /**
+   * Unique identifier for the page to filter by
+   */
+  pageId?: string;
+
+  /**
+   * Type of the page section to filter by
+   */
+  pageSectionType?: 'all_items' | 'discovery_item' | 'discovery_items_grid' | null;
+
+  /**
+   * Unique identifier for the website collection to filter by
+   */
+  websiteCollectionId?: 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;
+}
+
+Auctions.WebsiteUserAttributes = WebsiteUserAttributes;
+
+export declare namespace Auctions {
+  export {
+    type AuctionGetPageSectionsResponse as AuctionGetPageSectionsResponse,
+    type AuctionListAuctionsResponse as AuctionListAuctionsResponse,
+    type AuctionGetPageSectionsParams as AuctionGetPageSectionsParams,
+    type AuctionListAuctionBidsParams as AuctionListAuctionBidsParams,
+  };
+
+  export {
+    WebsiteUserAttributes as WebsiteUserAttributes,
+    type WebsiteUserAttributeCreateResponse as WebsiteUserAttributeCreateResponse,
+    type WebsiteUserAttributeDeleteResponse as WebsiteUserAttributeDeleteResponse,
+    type WebsiteUserAttributeCreateParams as WebsiteUserAttributeCreateParams,
+    type WebsiteUserAttributeDeleteParams as WebsiteUserAttributeDeleteParams,
+  };
+}

package/src/resources/auctions/index.ts

@@ -0,0 +1,16 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Auctions,
+  type AuctionGetPageSectionsResponse,
+  type AuctionListAuctionsResponse,
+  type AuctionGetPageSectionsParams,
+  type AuctionListAuctionBidsParams,
+} from './auctions';
+export {
+  WebsiteUserAttributes,
+  type WebsiteUserAttributeCreateResponse,
+  type WebsiteUserAttributeDeleteResponse,
+  type WebsiteUserAttributeCreateParams,
+  type WebsiteUserAttributeDeleteParams,
+} from './website-user-attributes/index';

package/src/resources/auctions/website-user-attributes/index.ts

@@ -0,0 +1,10 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Values, type ValueCreateResponse, type ValueCreateParams } from './values';
+export {
+  WebsiteUserAttributes,
+  type WebsiteUserAttributeCreateResponse,
+  type WebsiteUserAttributeDeleteResponse,
+  type WebsiteUserAttributeCreateParams,
+  type WebsiteUserAttributeDeleteParams,
+} from './website-user-attributes';

package/src/resources/auctions/website-user-attributes/values.ts

@@ -0,0 +1,97 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../resource';
+import * as Core from '../../../core';
+
+export class Values extends APIResource {
+  /**
+   * Create a new website user attribute value
+   *
+   * @example
+   * ```ts
+   * const values =
+   *   await client.auctions.websiteUserAttributes.values.create(
+   *     {
+   *       data: [
+   *         {
+   *           userId: '123e4567-e89b-12d3-a456-426614174005',
+   *           value: 'Website User Attribute Value',
+   *           websiteUserAttributeId:
+   *             '123e4567-e89b-12d3-a456-426614174004',
+   *         },
+   *       ],
+   *       organizationId:
+   *         '123e4567-e89b-12d3-a456-426614174002',
+   *       websiteId: '123e4567-e89b-12d3-a456-426614174001',
+   *     },
+   *   );
+   * ```
+   */
+  create(body: ValueCreateParams, options?: Core.RequestOptions): Core.APIPromise<ValueCreateResponse> {
+    return this._client.post('/api/website_user_attributes/values', { body, ...options });
+  }
+}
+
+export type ValueCreateResponse = Array<ValueCreateResponse.ValueCreateResponseItem>;
+
+export namespace ValueCreateResponse {
+  export interface ValueCreateResponseItem {
+    id: string;
+
+    createdAt: string;
+
+    organizationId: string;
+
+    updatedAt: string;
+
+    userId: string;
+
+    value: string;
+
+    websiteId: string;
+
+    websiteUserAttributeId: string;
+  }
+}
+
+export interface ValueCreateParams {
+  data: Array<ValueCreateParams.Data>;
+
+  /**
+   * Unique identifier for the organization
+   */
+  organizationId: string;
+
+  /**
+   * Unique identifier for the website
+   */
+  websiteId: string;
+}
+
+export namespace ValueCreateParams {
+  export interface Data {
+    /**
+     * Unique identifier for the user
+     */
+    userId: string;
+
+    /**
+     * Value for the website user attribute
+     */
+    value: string;
+
+    /**
+     * Unique identifier for the website user attribute
+     */
+    websiteUserAttributeId: string;
+
+    /**
+     * Unique identifier for the website user attribute value
+     */
+    id?: string;
+  }
+}
+
+export declare namespace Values {
+  export { type ValueCreateResponse as ValueCreateResponse, type ValueCreateParams as ValueCreateParams };
+}