@xoxno/sdk-js 0.1.353 → 0.1.354

package/dist/nft/index.d.ts

@@ -1,4 +1,5 @@
-import type { ActivityChain, NftData } from '../types/nft';
+import type { NftDoc } from '@xoxno/types';
+import type { ActivityChain } from '../types/nft';
 import type { TradincActivityArgs, TradingActivityResponse } from '../types/trading';
 import type { UserOffers } from '../types/user';
 /**
@@ -16,7 +17,7 @@ export declare class NFTModule {
      * @async
      * @function getNFTByIdentifier
      * @param {string} identifier - The identifier of the NFT to fetch data for.
-     * @returns {Promise<NftData>} A promise that resolves to the fetched NFT data.
+     * @returns {Promise<NftDoc>} A promise that resolves to the fetched NFT data.
      *
      * This function fetches data for a given NFT by its identifier. It takes the following parameter:
      * - identifier (string): The identifier of the NFT to fetch data for.
@@ -25,13 +26,13 @@ export declare class NFTModule {
      * If it is valid, the function fetches the NFT data using the API.
      * Finally, it returns a promise that resolves to the fetched NFT data.
      */
-    getNFTByIdentifier: (identifier: string, extra?: RequestInit) => Promise<NftData>;
+    getNFTByIdentifier: (identifier: string, extra?: RequestInit) => Promise<NftDoc>;
     /**
      * @public
      * @async
      * @function getNFTByIdentifier
      * @param {string} identifier - The identifier of the NFT to fetch data for.
-     * @returns {Promise<NftData>} A promise that resolves to the fetched NFT data.
+     * @returns {Promise<NftDoc>} A promise that resolves to the fetched NFT data.
      *
      * This function fetches data for a given NFT by its identifier. It takes the following parameter:
      * - identifier (string): The identifier of the NFT to fetch data for.
@@ -45,25 +46,33 @@ export declare class NFTModule {
      * Gets an NFT by collection and nonce.
      * @param collection The collection ticker.
      * @param nonce The nonce of the NFT.
-     * @returns {Promise<NftData>} The NFT data.
+     * @returns {Promise<NftDoc>} The NFT data.
      * @throws Throws an error when the collection ticker is invalid.
      */
-    getNFTByCollectionAndNonce: (collection: string, nonce: number) => Promise<NftData>;
+    getNFTByCollectionAndNonce: (collection: string, nonce: number) => Promise<NftDoc>;
+    /**
+     * @public
+     * @async
+     * @function getDailyTrending
+     * @returns {Promise<NftDoc[]>} A promise that resolves to the array of trending NFTs.
+     * This function fetches the top NFTs that are trending today based on their floor and volumes
+     */
+    getDailyTrending: () => Promise<NftDoc[]>;
     /**
      * @public
      * @async
      * @function getPinnedNFTs
-     * @returns {Promise<NftData[]>} A promise that resolves to the fetched pinned collections.
+     * @returns {Promise<NftDoc[]>} A promise that resolves to the fetched pinned collections.
      */
-    getPinnedNFTs: (chain?: ActivityChain) => Promise<NftData[]>;
+    getPinnedNFTs: (chain?: ActivityChain) => Promise<NftDoc[]>;
     /**
      * Get NFT by collection and nonce hex
      *
      * @param collection - collection ticker
      * @param nonceHex - nonce hex
-     * @return {Promise<NftData>} NFT data
+     * @return {Promise<NftDoc>} NFT data
      */
-    getNFTByCollectionAndNonceHex: (collection: string, nonceHex: string) => Promise<NftData>;
+    getNFTByCollectionAndNonceHex: (collection: string, nonceHex: string) => Promise<NftDoc>;
     /**
      * Retrieves trading history based on the provided arguments.
      *

package/dist/types/index.d.ts

@@ -6,3 +6,6 @@ export * from './staking';
 export * from './user';
 export * from './common';
 export * from './event';
+export type PublicOnly<T> = {
+    [K in keyof T as T[K] extends Function ? never : K]: T[K];
+};

package/dist/types/trading.d.ts

@@ -114,6 +114,5 @@ export interface TradingActivityResponse {
     /** The total count of the results for the specific query */
     count?: number;
     resources: TradingActivity[];
-    getNextPagePayload: TradincActivityArgs;
     empty: boolean;
 }

package/dist/users/index.d.ts

@@ -1,4 +1,5 @@
-import type { CollectionCreatorInfo, CreatorInfo, EventCreatorInfo, GetNFTsArgs, SearchNFTsResponse, StakingStatus, StakingSummaryPools, StakingSummaryPoolsSlim, StatusResponse, SuggestNFTsArgs, SuggestResults, TradincActivityArgs, TradingActivityResponse } from '../types';
+import type { NftDocFilter } from '@xoxno/types';
+import type { CollectionCreatorInfo, CreatorInfo, EventCreatorInfo, PublicOnly, SearchNFTsResponse, StakingStatus, StakingSummaryPools, StakingSummaryPoolsSlim, StatusResponse, SuggestNFTsArgs, SuggestResults, TradincActivityArgs, TradingActivityResponse } from '../types';
 import type { ArgsUserOffers, BulkAccount, CreatorProfile, IApiShareholder, IOwnerInfo, IUserProfile, StakingCreatorInfo, UserAnalyticSummary, UserInventory, UserNetworkAccount, UserOffers, UserPoolStakingInfo, UserStats, UserTokenInventory, UserXOXNODrop } from '../types/user';
 export declare class UserModule {
     private api;
@@ -44,7 +45,7 @@ export declare class UserModule {
      * @param address - The user's address
      * @returns {UserInventory} - A list of token ids and the price
      */
-    getUserNFTs: (args: GetNFTsArgs) => Promise<SearchNFTsResponse>;
+    getUserNFTs: (args: PublicOnly<NftDocFilter>) => Promise<import("@xoxno/types").NftCosmosResponse>;
     /**
      * @name getUserOffers
      * @description Fetches all offers sent or received associated with a user address
@@ -141,7 +142,7 @@ export declare class UserModule {
      * @param {String} address - User's address
      * @param {number} top - Top
      * @param {number} skip - Skip
-     * @returns {NftData[]} Array of NFTs
+     * @returns {NftDoc[]} Array of NFTs
      * @throws {Error} Throws an error if the address is invalid
      *  */
     getUserFavoriteNFTs: (address: string, top: number, skip: number) => Promise<SearchNFTsResponse>;

package/dist/utils/api.d.ts

@@ -26,5 +26,7 @@ export declare class XOXNOClient {
         chain?: Chain;
     }>): XOXNOClient;
     static getInstance(): XOXNOClient;
-    fetchWithTimeout: <T>(path: string, options?: Record<string, any>) => Promise<T>;
+    fetchWithTimeout: <T>(path: string, options?: RequestInit & {
+        params?: Record<string, any>;
+    }) => Promise<T>;
 }

package/dist/utils/errors.d.ts

@@ -0,0 +1,6 @@
+export declare class CollectionNotFoundError extends Error {
+    constructor(item: string);
+}
+export declare class PaginatedTopError extends Error {
+    constructor(top: number);
+}

package/dist/utils/getActivity.d.ts

@@ -1,5 +1,5 @@
-import type { XOXNOClient } from '..';
 import type { TradincActivityArgs, TradingActivityResponse } from '../types/trading';
+import type { XOXNOClient } from './api';
 /**
  * Fetches the trading activity of the given collections
  * @param args - The trading activity arguments

package/dist/utils/guards.d.ts

@@ -0,0 +1,4 @@
+import type { CosmosDbGenericFilter } from '@xoxno/types';
+export declare function collectionGuard<T>(collection: string, callback: Promise<T>): Promise<T>;
+export declare function collectionGuardOnly(collection: string): Promise<void>;
+export declare function paginatedGuard<T, R>(filter: CosmosDbGenericFilter<T>, callback: (filter: string) => Promise<R>): Promise<R>;

package/dist/utils/types.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xoxno/sdk-js",
-  "version": "0.1.353",
+  "version": "0.1.354",
   "description": "The SDK to interact with the XOXNO Protocol!",
   "type": "module",
   "exports": {
@@ -98,6 +98,7 @@
   "dependencies": {
     "@multiversx/sdk-core": "^13.17.2",
     "@multiversx/sdk-network-providers": "^2.9.3",
+    "@xoxno/types": "^1.0.9",
     "axios": "^1.7.9",
     "protobufjs": "^7.4.0",
     "webpack-bundle-analyzer": "^4.10.2"