@0xsequence/marketplace-sdk 1.1.0 → 1.1.1

package/src/react/_internal/api/query-keys.ts

@@ -28,6 +28,7 @@ class CollectableKeys {
 	static listings = [...CollectableKeys.all, 'listings'] as const;
 	static listingsCount = [...CollectableKeys.all, 'listingsCount'] as const;
 	static listPrimarySaleItems = ['listPrimarySaleItems'] as const;
+	static primarySaleItemsCount = ['primarySaleItemsCount'] as const;
 	static filter = [...CollectableKeys.all, 'filter'] as const;
 	static counts = [...CollectableKeys.all, 'counts'] as const;
 	static collectibleActivities = [
@@ -45,6 +46,18 @@ class CollectionKeys {
 		...CollectionKeys.all,
 		'collectionActivities',
 	] as const;
+	static collectionItemsOrders = [
+		...CollectionKeys.all,
+		'collectionItemsOrders',
+	] as const;
+	static collectionItemsOrdersCount = [
+		...CollectionKeys.all,
+		'collectionItemsOrdersCount',
+	] as const;
+	static getCountOfFilteredOrders = [
+		...CollectionKeys.all,
+		'getCountOfFilteredOrders',
+	] as const;
 }
 
 // biome-ignore lint/complexity/noStaticOnlyClass: static class provides better organization and type safety for query keys
@@ -84,6 +97,7 @@ class TokenKeys {
 	static all = ['tokens'] as const;
 	static metadata = [...TokenKeys.all, 'metadata'] as const;
 	static supplies = [...TokenKeys.all, 'supplies'] as const;
+	static ranges = [...TokenKeys.all, 'ranges'] as const;
 }
 
 // biome-ignore lint/complexity/noStaticOnlyClass: static class provides better organization and type safety for query keys

package/src/react/_internal/api/services.ts

@@ -33,7 +33,7 @@ const indexerURL = (chain: ChainNameOrId, env: Env = 'production') => {
 	return stringTemplate(SERVICES.indexer, { network: network, prefix });
 };
 
-const marketplaceApiURL = (env: Env = 'production') => {
+export const marketplaceApiURL = (env: Env = 'production') => {
 	const prefix = getPrefix(env);
 	return stringTemplate(SERVICES.marketplaceApi, { prefix });
 };

package/src/react/_internal/databeat/types.ts

@@ -51,6 +51,7 @@ type BuyModalOpenedProps = Omit<
 	| 'skipNativeBalanceCheck'
 	| 'nativeTokenAddress'
 	| 'successActionButtons'
+	| 'hideQuantitySelector'
 > & {
 	buyAnalyticsId: string;
 };

package/src/react/_internal/types.ts

@@ -61,4 +61,18 @@ export type ValuesOptional<T> = {
 	[K in keyof T]: T[K] | undefined;
 };
 
+export type RequiredKeys<T> = {
+	[K in keyof T]-?: T[K];
+};
+
+export type QueryKeyArgs<T> = {
+	[K in keyof Required<T>]: T[K] | undefined;
+};
+
 export type Optional<T, K extends keyof T> = Pick<Partial<T>, K> & Omit<T, K>;
+
+/**
+ * Extracts only API-relevant fields from query params, excluding SDK config and query options
+ * Converts optional properties (prop?: T) to explicit union types (prop: T | undefined)
+ */
+export type ApiArgs<T> = ValuesOptional<Omit<T, 'config' | 'query'>>;

package/src/react/_internal/utils.ts

@@ -52,3 +52,6 @@ export function isTransactionStep(step: Step): step is TransactionStep {
 		StepType.createListing,
 	].includes(step.id);
 }
+
+export const clamp = (val: number, min: number, max: number) =>
+	Math.max(min, Math.min(max, val));

package/src/react/hooks/config/useMarketplaceConfig.tsx

@@ -1,5 +1,5 @@
 import { useQuery } from '@tanstack/react-query';
-import { marketplaceConfigOptions } from '../../queries/marketplaceConfig';
+import { marketplaceConfigOptions } from '../../queries/market/marketplaceConfig';
 import { useConfig } from '../config/useConfig';
 
 export const useMarketplaceConfig = () => {

package/src/react/hooks/data/collectibles/useBalanceOfCollectible.tsx

@@ -3,7 +3,7 @@ import { ContractType } from '../../../_internal';
 import {
 	balanceOfCollectibleOptions,
 	type UseBalanceOfCollectibleArgs,
-} from '../../../queries/balanceOfCollectible';
+} from '../../../queries/collectibles/balanceOfCollectible';
 import { useConfig } from '../../config/useConfig';
 import { useMarketplaceConfig } from '../../config/useMarketplaceConfig';
 

package/src/react/hooks/data/collectibles/useCollectible.tsx

@@ -6,7 +6,7 @@ import {
 	type CollectibleQueryOptions,
 	collectibleQueryOptions,
 	type FetchCollectibleParams,
-} from '../../../queries/collectible';
+} from '../../../queries/collectibles/collectible';
 import { useConfig } from '../../config/useConfig';
 
 export type UseCollectibleParams = Optional<CollectibleQueryOptions, 'config'>;

package/src/react/hooks/data/collectibles/useCountOfCollectables.tsx

@@ -6,7 +6,7 @@ import {
 	type CountOfCollectablesQueryOptions,
 	countOfCollectablesQueryOptions,
 	type FetchCountOfCollectablesParams,
-} from '../../../queries/countOfCollectables';
+} from '../../../queries/collectibles/countOfCollectables';
 import { useConfig } from '../../config/useConfig';
 
 export type UseCountOfCollectablesParams = Optional<

package/src/react/hooks/data/collectibles/useListCollectibleActivities.tsx

@@ -7,7 +7,7 @@ import {
 	type fetchListCollectibleActivities,
 	type ListCollectibleActivitiesQueryOptions,
 	listCollectibleActivitiesQueryOptions,
-} from '../../../queries/listCollectibleActivities';
+} from '../../../queries/collectibles/listCollectibleActivities';
 import { useConfig } from '../../config/useConfig';
 
 export type UseListCollectibleActivitiesParams = Optional<

package/src/react/hooks/data/collectibles/useListCollectibles.tsx

@@ -6,7 +6,7 @@ import {
 	type FetchListCollectiblesParams,
 	type ListCollectiblesQueryOptions,
 	listCollectiblesQueryOptions,
-} from '../../../queries/listCollectibles';
+} from '../../../queries/collectibles/listCollectibles';
 import { useConfig } from '../../config/useConfig';
 
 export type UseListCollectiblesParams = Optional<

package/src/react/hooks/data/collectibles/useListCollectiblesPaginated.tsx

@@ -7,7 +7,7 @@ import {
 	type fetchListCollectiblesPaginated,
 	type ListCollectiblesPaginatedQueryOptions,
 	listCollectiblesPaginatedQueryOptions,
-} from '../../../queries/listCollectiblesPaginated';
+} from '../../../queries/collectibles/listCollectiblesPaginated';
 import { useConfig } from '../../config/useConfig';
 
 export type UseListCollectiblesPaginatedParams = Optional<

package/src/react/hooks/data/collectibles/useTokenBalances.tsx

@@ -3,7 +3,7 @@ import { ContractType } from '../../../_internal';
 import {
 	tokenBalancesOptions,
 	type UseTokenBalancesArgs,
-} from '../../../queries/tokenBalances';
+} from '../../../queries/collectibles/tokenBalances';
 import { useConfig } from '../../config/useConfig';
 import { useMarketplaceConfig } from '../../config/useMarketplaceConfig';
 

package/src/react/hooks/data/collections/useCollection.tsx

@@ -6,7 +6,7 @@ import {
 	type CollectionQueryOptions,
 	collectionQueryOptions,
 	type FetchCollectionParams,
-} from '../../../queries/collection';
+} from '../../../queries/collections/collection';
 import { useConfig } from '../../config/useConfig';
 
 export type UseCollectionParams = Optional<CollectionQueryOptions, 'config'>;

package/src/react/hooks/data/collections/useCollectionBalanceDetails.tsx

@@ -8,7 +8,7 @@ import {
 	collectionBalanceDetailsQueryOptions,
 	type FetchCollectionBalanceDetailsParams,
 	type fetchCollectionBalanceDetails,
-} from '../../../queries/collectionBalanceDetails';
+} from '../../../queries/collections/collectionBalanceDetails';
 import { useConfig } from '../../config/useConfig';
 
 export type UseCollectionBalanceDetailsParams = Optional<

package/src/react/hooks/data/collections/useCollectionDetails.ts

@@ -6,7 +6,7 @@ import {
 	type CollectionDetailsQueryOptions,
 	collectionDetailsQueryOptions,
 	type FetchCollectionDetailsParams,
-} from '../../../queries/collectionDetails';
+} from '../../../queries/collections/collectionDetails';
 import { useConfig } from '../../config/useConfig';
 
 export type UseCollectionDetailsParams = Optional<

package/src/react/hooks/data/collections/useListCollectionActivities.tsx

@@ -7,7 +7,7 @@ import {
 	type fetchListCollectionActivities,
 	type ListCollectionActivitiesQueryOptions,
 	listCollectionActivitiesQueryOptions,
-} from '../../../queries/listCollectionActivities';
+} from '../../../queries/collections/listCollectionActivities';
 import { useConfig } from '../../config/useConfig';
 
 export type UseListCollectionActivitiesParams = Optional<

package/src/react/hooks/data/collections/useListCollections.tsx

@@ -6,7 +6,7 @@ import {
 	type FetchListCollectionsParams,
 	type ListCollectionsQueryOptions,
 	listCollectionsQueryOptions,
-} from '../../../queries/listCollections';
+} from '../../../queries/collections/listCollections';
 import { useConfig } from '../../config/useConfig';
 import { useMarketplaceConfig } from '../../config/useMarketplaceConfig';
 

package/src/react/hooks/data/inventory/useInventory.tsx

@@ -3,7 +3,7 @@ import { ContractType } from '../../../_internal';
 import {
 	inventoryOptions,
 	type UseInventoryArgs,
-} from '../../../queries/inventory';
+} from '../../../queries/inventory/inventory';
 import { useConfig } from '../../config/useConfig';
 import { useMarketplaceConfig } from '../../config/useMarketplaceConfig';
 

package/src/react/hooks/data/market/useCurrency.tsx

@@ -6,7 +6,7 @@ import {
 	type CurrencyQueryOptions,
 	currencyQueryOptions,
 	type FetchCurrencyParams,
-} from '../../../queries/currency';
+} from '../../../queries/market/currency';
 import { useConfig } from '../../config/useConfig';
 
 export type UseCurrencyParams = Optional<CurrencyQueryOptions, 'config'>;

package/src/react/hooks/data/market/useListMarketCardData.tsx

@@ -11,6 +11,7 @@ import type {
 	PropertyFilter,
 } from '../../../../types';
 import { OrderSide } from '../../../../types';
+import type { PriceFilter } from '../../../_internal';
 import type { MarketCollectibleCardProps } from '../../../ui/components/marketplace-collectible-card/types';
 import { useSellModal } from '../../../ui/modals/SellModal';
 import { useListCollectibles } from '../collectibles/useListCollectibles';
@@ -25,10 +26,12 @@ interface UseListMarketCardDataProps {
 	filterOptions?: PropertyFilter[];
 	searchText?: string;
 	showListedOnly?: boolean;
+	priceFilters?: PriceFilter[];
 	onCollectibleClick?: (tokenId: string) => void;
 	onCannotPerformAction?: (action: CollectibleCardAction) => void;
 	prioritizeOwnerActions?: boolean;
 	assetSrcPrefixUrl?: string;
+	hideQuantitySelector?: boolean;
 }
 
 export function useListMarketCardData({
@@ -39,10 +42,12 @@ export function useListMarketCardData({
 	filterOptions,
 	searchText,
 	showListedOnly = false,
+	priceFilters,
 	onCollectibleClick,
 	onCannotPerformAction,
 	prioritizeOwnerActions,
 	assetSrcPrefixUrl,
+	hideQuantitySelector,
 }: UseListMarketCardDataProps) {
 	const { address: accountAddress } = useAccount();
 	const { show: showSellModal } = useSellModal();
@@ -63,6 +68,7 @@ export function useListMarketCardData({
 			includeEmpty: !showListedOnly,
 			searchText,
 			properties: filterOptions,
+			prices: priceFilters,
 		},
 		query: {
 			enabled: !!collectionAddress && !!chainId,
@@ -111,6 +117,7 @@ export function useListMarketCardData({
 				onCannotPerformAction,
 				prioritizeOwnerActions,
 				assetSrcPrefixUrl,
+				hideQuantitySelector,
 				onOfferClick: ({ order }) => {
 					if (!accountAddress) return;
 

package/src/react/hooks/data/market/useMarketCurrencies.tsx

@@ -6,7 +6,7 @@ import {
 	type FetchMarketCurrenciesParams,
 	type MarketCurrenciesQueryOptions,
 	marketCurrenciesQueryOptions,
-} from '../../../queries/marketCurrencies';
+} from '../../../queries/market/marketCurrencies';
 import { useConfig } from '../../config/useConfig';
 
 export type UseMarketCurrenciesParams = Optional<

package/src/react/hooks/data/orders/index.ts

@@ -1,7 +1,11 @@
+export * from './useCountItemsOrdersForCollection';
 export * from './useCountListingsForCollectible';
 export * from './useCountOffersForCollectible';
 export * from './useFloorOrder';
+export * from './useGetCountOfFilteredOrders';
 export * from './useHighestOffer';
+export * from './useListItemsOrdersForCollection';
+export * from './useListItemsOrdersForCollectionPaginated';
 export * from './useListListingsForCollectible';
 export * from './useListOffersForCollectible';
 export * from './useLowestListing';

package/src/react/hooks/data/orders/useCountItemsOrdersForCollection.tsx

@@ -0,0 +1,90 @@
+'use client';
+
+import { useQuery } from '@tanstack/react-query';
+import type { Optional } from '../../../_internal';
+import {
+	type CountItemsOrdersForCollectionQueryOptions,
+	countItemsOrdersForCollectionQueryOptions,
+	type FetchCountItemsOrdersForCollectionParams,
+} from '../../../queries/orders/countItemsOrdersForCollection';
+import { useConfig } from '../../config/useConfig';
+
+export type UseCountItemsOrdersForCollectionParams = Optional<
+	CountItemsOrdersForCollectionQueryOptions,
+	'config'
+>;
+
+/**
+ * Hook to get the count of orders for a collection
+ *
+ * Counts the total number of active orders (listings) for all tokens
+ * in a collection. Useful for displaying order counts in collection UI.
+ *
+ * @param params - Configuration parameters
+ * @param params.chainId - The chain ID (must be number, e.g., 1 for Ethereum, 137 for Polygon)
+ * @param params.collectionAddress - The collection contract address
+ * @param params.filter - Optional filter criteria for orders
+ * @param params.query - Optional React Query configuration
+ *
+ * @returns Query result containing the count of orders
+ *
+ * @example
+ * Basic usage:
+ * ```typescript
+ * const { data: orderCount, isLoading } = useCountItemsOrdersForCollection({
+ *   chainId: 137,
+ *   collectionAddress: '0x...'
+ * })
+ * ```
+ *
+ * @example
+ * With filter:
+ * ```typescript
+ * const { data: filteredCount } = useCountItemsOrdersForCollection({
+ *   chainId: 137,
+ *   collectionAddress: '0x...',
+ *   filter: {
+ *     marketplace: [MarketplaceKind.sequence_marketplace_v2]
+ *   }
+ * })
+ * ```
+ *
+ * @example
+ * Combined with list hook:
+ * ```typescript
+ * const { data: totalCount } = useCountItemsOrdersForCollection({
+ *   chainId: 137,
+ *   collectionAddress: '0x...'
+ * })
+ *
+ * const { data: orders } = useListItemsOrdersForCollection({
+ *   chainId: 137,
+ *   collectionAddress: '0x...'
+ * })
+ *
+ * return <div>Showing {orders?.pages[0]?.listings.length ?? 0} of {totalCount} orders</div>
+ * ```
+ */
+export function useCountItemsOrdersForCollection(
+	params: UseCountItemsOrdersForCollectionParams,
+) {
+	const defaultConfig = useConfig();
+
+	const { config = defaultConfig, ...rest } = params;
+
+	const queryOptions = countItemsOrdersForCollectionQueryOptions({
+		config,
+		...rest,
+	});
+
+	return useQuery({
+		...queryOptions,
+	});
+}
+
+export { countItemsOrdersForCollectionQueryOptions };
+
+export type {
+	FetchCountItemsOrdersForCollectionParams,
+	CountItemsOrdersForCollectionQueryOptions,
+};

package/src/react/hooks/data/orders/useCountListingsForCollectible.tsx

@@ -6,7 +6,7 @@ import {
 	type CountListingsForCollectibleQueryOptions,
 	countListingsForCollectibleQueryOptions,
 	type FetchCountListingsForCollectibleParams,
-} from '../../../queries/countListingsForCollectible';
+} from '../../../queries/orders/countListingsForCollectible';
 import { useConfig } from '../../config/useConfig';
 
 export type UseCountListingsForCollectibleParams = Optional<

package/src/react/hooks/data/orders/useCountOffersForCollectible.tsx

@@ -6,7 +6,7 @@ import {
 	type CountOffersForCollectibleQueryOptions,
 	countOffersForCollectibleQueryOptions,
 	type FetchCountOffersForCollectibleParams,
-} from '../../../queries/countOffersForCollectible';
+} from '../../../queries/orders/countOffersForCollectible';
 import { useConfig } from '../../config/useConfig';
 
 export type UseCountOffersForCollectibleParams = Optional<

package/src/react/hooks/data/orders/useFloorOrder.tsx

@@ -6,7 +6,7 @@ import {
 	type FetchFloorOrderParams,
 	type FloorOrderQueryOptions,
 	floorOrderQueryOptions,
-} from '../../../queries/floorOrder';
+} from '../../../queries/orders/floorOrder';
 import { useConfig } from '../../config/useConfig';
 
 export type UseFloorOrderParams = Optional<FloorOrderQueryOptions, 'config'>;

package/src/react/hooks/data/orders/useGetCountOfFilteredOrders.tsx

@@ -0,0 +1,39 @@
+'use client';
+
+import { useQuery } from '@tanstack/react-query';
+import type { Optional } from '../../../_internal';
+import {
+	type FetchGetCountOfFilteredOrdersParams,
+	type GetCountOfFilteredOrdersQueryOptions,
+	getCountOfFilteredOrdersQueryOptions,
+} from '../../../queries/orders/getCountOfFilteredOrders';
+import { useConfig } from '../../config/useConfig';
+
+export type UseGetCountOfFilteredOrdersParams = Optional<
+	GetCountOfFilteredOrdersQueryOptions,
+	'config'
+>;
+
+export function useGetCountOfFilteredOrders(
+	params: UseGetCountOfFilteredOrdersParams,
+) {
+	const defaultConfig = useConfig();
+
+	const { config = defaultConfig, ...rest } = params;
+
+	const queryOptions = getCountOfFilteredOrdersQueryOptions({
+		config,
+		...rest,
+	});
+
+	return useQuery({
+		...queryOptions,
+	});
+}
+
+export { getCountOfFilteredOrdersQueryOptions };
+
+export type {
+	FetchGetCountOfFilteredOrdersParams,
+	GetCountOfFilteredOrdersQueryOptions,
+};

package/src/react/hooks/data/orders/useHighestOffer.tsx

@@ -6,7 +6,7 @@ import {
 	type FetchHighestOfferParams,
 	type HighestOfferQueryOptions,
 	highestOfferQueryOptions,
-} from '../../../queries/highestOffer';
+} from '../../../queries/orders/highestOffer';
 import { useConfig } from '../../config/useConfig';
 
 export type UseHighestOfferParams = Optional<

package/src/react/hooks/data/orders/useListItemsOrdersForCollection.tsx

@@ -0,0 +1,93 @@
+'use client';
+
+import { useInfiniteQuery } from '@tanstack/react-query';
+import type { Optional } from '../../../_internal';
+import {
+	type FetchListItemsOrdersForCollectionParams,
+	type fetchListItemsOrdersForCollection,
+	type ListItemsOrdersForCollectionQueryOptions,
+	listItemsOrdersForCollectionQueryOptions,
+} from '../../../queries/orders/listItemsOrdersForCollection';
+import { useConfig } from '../../config/useConfig';
+
+export type UseListItemsOrdersForCollectionParams = Optional<
+	ListItemsOrdersForCollectionQueryOptions,
+	'config'
+>;
+
+/**
+ * Hook to fetch all listings for a collection with infinite pagination support
+ *
+ * Fetches active listings (sales) for all tokens in a collection from the marketplace
+ * with support for filtering and infinite scroll pagination.
+ *
+ * @param params - Configuration parameters
+ * @param params.chainId - The chain ID (must be number, e.g., 1 for Ethereum, 137 for Polygon)
+ * @param params.collectionAddress - The collection contract address
+ * @param params.filter - Optional filtering parameters (marketplace, currencies, etc.)
+ * @param params.query - Optional React Query configuration
+ *
+ * @returns Infinite query result containing listings data with pagination
+ *
+ * @example
+ * Basic usage:
+ * ```typescript
+ * const { data, isLoading, fetchNextPage, hasNextPage } = useListItemsOrdersForCollection({
+ *   chainId: 137,
+ *   collectionAddress: '0x...'
+ * })
+ * ```
+ *
+ * @example
+ * With filtering:
+ * ```typescript
+ * const { data, fetchNextPage } = useListItemsOrdersForCollection({
+ *   chainId: 1,
+ *   collectionAddress: '0x...',
+ *   filter: {
+ *     marketplace: [MarketplaceKind.sequence_marketplace_v2],
+ *     currencies: ['0x...']
+ *   }
+ * })
+ * ```
+ *
+ * @example
+ * Accessing paginated data:
+ * ```typescript
+ * const { data } = useListItemsOrdersForCollection({
+ *   chainId: 137,
+ *   collectionAddress: '0x...'
+ * })
+ *
+ * const allListings = data?.pages.flatMap(page => page.listings) ?? []
+ * ```
+ */
+export function useListItemsOrdersForCollection(
+	params: UseListItemsOrdersForCollectionParams,
+) {
+	const defaultConfig = useConfig();
+
+	const { config = defaultConfig, ...rest } = params;
+
+	const queryOptions = listItemsOrdersForCollectionQueryOptions({
+		config,
+		...rest,
+	});
+
+	return useInfiniteQuery({
+		...queryOptions,
+	});
+}
+
+export { listItemsOrdersForCollectionQueryOptions };
+
+export type {
+	FetchListItemsOrdersForCollectionParams,
+	ListItemsOrdersForCollectionQueryOptions,
+};
+
+export type UseListItemsOrdersForCollectionArgs =
+	UseListItemsOrdersForCollectionParams;
+export type UseListItemsOrdersForCollectionReturn = Awaited<
+	ReturnType<typeof fetchListItemsOrdersForCollection>
+>;