@medialane/sdk 0.137.0 → 0.139.0

package/README.md

@@ -280,11 +280,12 @@ token.balances?.forEach((b: ApiTokenBalance) => {
 
 ```typescript
 // All collections: newest first by default
-const collections = await client.api.getCollections();
+const collections = await client.api.listCollections();
 
-// With sort and pagination
-const byVolume = await client.api.getCollections(1, 20, undefined, "volume");
-const verified = await client.api.getCollections(1, 18, true, "recent");
+// Filter, sort and paginate in one query
+const byVolume = await client.api.listCollections({ page: 1, limit: 20, sort: "volume" });
+const featured = await client.api.listCollections({ limit: 18, isFeatured: true, sort: "recent" });
+const myDrops = await client.api.listCollections({ owner: "0x...", service: "drop-collection" });
 
 // Sort options: "recent" | "supply" | "floor" | "volume" | "name"
 const collection = await client.api.getCollection(contract);

package/dist/{errors-Ca-A70L7.d.cts → errors-CMjZp66y.d.cts}

@@ -967,15 +967,8 @@ interface ApiAdminCollectionClaim extends ApiCollectionClaim {
     updatedAt: string;
 }
 interface ApiBusinessProvisioning {
-    id: string;
-    accountId: string;
     chain: string;
     walletAddress: string;
-    recipientScheme: string;
-    recipientValue: string;
-    interimOwnerPubkey: string | null;
-    newOwnerPubkey: string | null;
-    status: "DEPLOYED" | "REUSED" | "TRANSFERRED";
 }
 interface ApiWalletActivity {
     id: string;
@@ -1238,6 +1231,7 @@ interface ApiCollectionsListQuery {
     sort?: CollectionSort;
     isFeatured?: boolean;
     hideEmpty?: boolean;
+    standard?: string;
     chain?: ChainFilter;
 }
 interface ApiPricingRule {
@@ -1296,8 +1290,6 @@ declare class ApiClient {
     getToken(contract: string, tokenId: string, wait?: boolean): Promise<ApiResponse<ApiToken>>;
     getTokensByOwner(address: string, page?: number, limit?: number): Promise<ApiResponse<ApiToken[]>>;
     getTokenHistory(contract: string, tokenId: string, page?: number, limit?: number): Promise<ApiResponse<ApiActivity[]>>;
-    getCollections(page?: number, limit?: number, isKnown?: boolean, sort?: CollectionSort, service?: string, chain?: ChainFilter, standard?: string): Promise<ApiResponse<ApiCollection[]>>;
-    getCollectionsByOwner(owner: string, page?: number, limit?: number): Promise<ApiResponse<ApiCollection[]>>;
     getCollection(contract: string): Promise<ApiResponse<ApiCollection>>;
     getCollectionTokens(contract: string, page?: number, limit?: number, sort?: CollectionTokensSort): Promise<ApiResponse<ApiToken[]>>;
     getActivities(query?: ApiActivitiesQuery): Promise<ApiResponse<ApiActivity[]>>;
@@ -1404,7 +1396,7 @@ declare class ApiClient {
     }>;
     registerBusinessProvisioning(params: {
         chain?: "STARKNET";
-        recipientScheme: string;
+        recipientScheme: "email";
         recipientValue: string;
     }): Promise<ApiResponse<ApiBusinessProvisioning> & {
         reusedExistingWallet?: boolean;
@@ -1456,24 +1448,26 @@ declare class ApiClient {
     }): Promise<ApiUserWallet>;
     checkEmail(email: string): Promise<{
         exists: boolean;
-        walletWaiting: boolean;
     }>;
     requestEmailCode(email: string): Promise<void>;
     registerEmailAccount(email: string): Promise<void>;
-    verifyEmailCode(email: string, code: string): Promise<{
-        waitingWallets: string[];
-    }>;
-    claimWallet(params: {
+    verifyEmailCode(email: string, code: string): Promise<void>;
+    /**
+     * Makes the passkey the only owner of the session account's wallet. `signature` is the passkey's owner-alive
+     * proof for the wallet. Answers 409 when the wallet is already set up.
+     */
+    setupWalletKey(params: {
         newOwnerPubkey: string;
-        proofs: {
-            walletAddress: string;
-            signature: string[];
-            expiration: number;
-        }[];
+        signature: string[];
+        expiration: number;
     }): Promise<{
-        claimed: string[];
+        walletAddress: string;
     }>;
-    getSessionWallet(): Promise<string | null>;
+    /** The session account's wallet, and whether its passkey still has to be set up (`setupWalletKey`). */
+    getSessionWallet(): Promise<{
+        walletAddress: string;
+        needsKeySetup: boolean;
+    } | null>;
     getMyWallet(siwsToken: string): Promise<ApiUserWallet | null>;
     changeMyEmail(email: string, siwsToken: string): Promise<{
         email: string;
@@ -1491,11 +1485,6 @@ declare class ApiClient {
     confirmRemixOffer(id: string, params: ConfirmRemixOfferParams, siwsToken: string): Promise<ApiResponse<ApiRemixOffer>>;
     rejectRemixOffer(id: string, siwsToken: string): Promise<ApiResponse<ApiRemixOffer>>;
     extendRemixOffer(id: string, days: number, siwsToken: string): Promise<ApiResponse<ApiRemixOffer>>;
-    getPopCollections(opts?: {
-        page?: number;
-        limit?: number;
-        sort?: CollectionSort;
-    }): Promise<ApiResponse<ApiCollection[]>>;
     getPopEligibility(collection: string, wallet: string): Promise<PopClaimStatus>;
     getPopEligibilityBatch(collection: string, wallets: string[]): Promise<PopBatchEligibilityItem[]>;
     getCoins(opts?: ApiCoinsQuery): Promise<ApiResponse<ApiCoin[]>>;
@@ -1509,16 +1498,12 @@ declare class ApiClient {
         image?: string | null;
         description?: string | null;
     }, siwsToken: string): Promise<ApiResponse<ApiCoin>>;
-    getDropCollections(opts?: {
-        page?: number;
-        limit?: number;
-        sort?: CollectionSort;
-    }): Promise<ApiResponse<ApiCollection[]>>;
     getDropMintStatus(collection: string, wallet: string): Promise<DropMintStatus>;
     getDropInfo(contract: string): Promise<ApiDropInfo | null>;
     getDropState(contract: string): Promise<ApiDropState>;
     getTicket(contract: string, tokenId: string): Promise<ApiTierOnchain>;
     getTicketCount(contract: string): Promise<number>;
+    getClubMembershipCount(contract: string): Promise<number>;
     getClubMembership(contract: string, tokenId: string): Promise<ApiTierOnchain>;
     isClubMember(contract: string, tokenId: string, wallet: string): Promise<boolean>;
     getIpNftTokenData(contract: string, tokenId: string): Promise<ApiIpNftTokenData | null>;

package/dist/{errors-CC1H8Usc.d.ts → errors-CtXjdRsL.d.ts}

@@ -967,15 +967,8 @@ interface ApiAdminCollectionClaim extends ApiCollectionClaim {
     updatedAt: string;
 }
 interface ApiBusinessProvisioning {
-    id: string;
-    accountId: string;
     chain: string;
     walletAddress: string;
-    recipientScheme: string;
-    recipientValue: string;
-    interimOwnerPubkey: string | null;
-    newOwnerPubkey: string | null;
-    status: "DEPLOYED" | "REUSED" | "TRANSFERRED";
 }
 interface ApiWalletActivity {
     id: string;
@@ -1238,6 +1231,7 @@ interface ApiCollectionsListQuery {
     sort?: CollectionSort;
     isFeatured?: boolean;
     hideEmpty?: boolean;
+    standard?: string;
     chain?: ChainFilter;
 }
 interface ApiPricingRule {
@@ -1296,8 +1290,6 @@ declare class ApiClient {
     getToken(contract: string, tokenId: string, wait?: boolean): Promise<ApiResponse<ApiToken>>;
     getTokensByOwner(address: string, page?: number, limit?: number): Promise<ApiResponse<ApiToken[]>>;
     getTokenHistory(contract: string, tokenId: string, page?: number, limit?: number): Promise<ApiResponse<ApiActivity[]>>;
-    getCollections(page?: number, limit?: number, isKnown?: boolean, sort?: CollectionSort, service?: string, chain?: ChainFilter, standard?: string): Promise<ApiResponse<ApiCollection[]>>;
-    getCollectionsByOwner(owner: string, page?: number, limit?: number): Promise<ApiResponse<ApiCollection[]>>;
     getCollection(contract: string): Promise<ApiResponse<ApiCollection>>;
     getCollectionTokens(contract: string, page?: number, limit?: number, sort?: CollectionTokensSort): Promise<ApiResponse<ApiToken[]>>;
     getActivities(query?: ApiActivitiesQuery): Promise<ApiResponse<ApiActivity[]>>;
@@ -1404,7 +1396,7 @@ declare class ApiClient {
     }>;
     registerBusinessProvisioning(params: {
         chain?: "STARKNET";
-        recipientScheme: string;
+        recipientScheme: "email";
         recipientValue: string;
     }): Promise<ApiResponse<ApiBusinessProvisioning> & {
         reusedExistingWallet?: boolean;
@@ -1456,24 +1448,26 @@ declare class ApiClient {
     }): Promise<ApiUserWallet>;
     checkEmail(email: string): Promise<{
         exists: boolean;
-        walletWaiting: boolean;
     }>;
     requestEmailCode(email: string): Promise<void>;
     registerEmailAccount(email: string): Promise<void>;
-    verifyEmailCode(email: string, code: string): Promise<{
-        waitingWallets: string[];
-    }>;
-    claimWallet(params: {
+    verifyEmailCode(email: string, code: string): Promise<void>;
+    /**
+     * Makes the passkey the only owner of the session account's wallet. `signature` is the passkey's owner-alive
+     * proof for the wallet. Answers 409 when the wallet is already set up.
+     */
+    setupWalletKey(params: {
         newOwnerPubkey: string;
-        proofs: {
-            walletAddress: string;
-            signature: string[];
-            expiration: number;
-        }[];
+        signature: string[];
+        expiration: number;
     }): Promise<{
-        claimed: string[];
+        walletAddress: string;
     }>;
-    getSessionWallet(): Promise<string | null>;
+    /** The session account's wallet, and whether its passkey still has to be set up (`setupWalletKey`). */
+    getSessionWallet(): Promise<{
+        walletAddress: string;
+        needsKeySetup: boolean;
+    } | null>;
     getMyWallet(siwsToken: string): Promise<ApiUserWallet | null>;
     changeMyEmail(email: string, siwsToken: string): Promise<{
         email: string;
@@ -1491,11 +1485,6 @@ declare class ApiClient {
     confirmRemixOffer(id: string, params: ConfirmRemixOfferParams, siwsToken: string): Promise<ApiResponse<ApiRemixOffer>>;
     rejectRemixOffer(id: string, siwsToken: string): Promise<ApiResponse<ApiRemixOffer>>;
     extendRemixOffer(id: string, days: number, siwsToken: string): Promise<ApiResponse<ApiRemixOffer>>;
-    getPopCollections(opts?: {
-        page?: number;
-        limit?: number;
-        sort?: CollectionSort;
-    }): Promise<ApiResponse<ApiCollection[]>>;
     getPopEligibility(collection: string, wallet: string): Promise<PopClaimStatus>;
     getPopEligibilityBatch(collection: string, wallets: string[]): Promise<PopBatchEligibilityItem[]>;
     getCoins(opts?: ApiCoinsQuery): Promise<ApiResponse<ApiCoin[]>>;
@@ -1509,16 +1498,12 @@ declare class ApiClient {
         image?: string | null;
         description?: string | null;
     }, siwsToken: string): Promise<ApiResponse<ApiCoin>>;
-    getDropCollections(opts?: {
-        page?: number;
-        limit?: number;
-        sort?: CollectionSort;
-    }): Promise<ApiResponse<ApiCollection[]>>;
     getDropMintStatus(collection: string, wallet: string): Promise<DropMintStatus>;
     getDropInfo(contract: string): Promise<ApiDropInfo | null>;
     getDropState(contract: string): Promise<ApiDropState>;
     getTicket(contract: string, tokenId: string): Promise<ApiTierOnchain>;
     getTicketCount(contract: string): Promise<number>;
+    getClubMembershipCount(contract: string): Promise<number>;
     getClubMembership(contract: string, tokenId: string): Promise<ApiTierOnchain>;
     isClubMember(contract: string, tokenId: string, wallet: string): Promise<boolean>;
     getIpNftTokenData(contract: string, tokenId: string): Promise<ApiIpNftTokenData | null>;

package/dist/index.cjs

@@ -239,7 +239,13 @@ var DEFAULT_MAX_DELAY_MS = 5e3;
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
-async function withRetry(fn, opts) {
+function isRetryableFor(method, err) {
+  if (err instanceof MedialaneApiError && err.status === 429) return true;
+  const isRead = method === "GET" || method === "HEAD";
+  if (!isRead) return false;
+  return err instanceof MedialaneApiError && err.status >= 500 || err instanceof TypeError;
+}
+async function withRetry(fn, opts, method = "GET") {
   const maxAttempts = opts?.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;
   const baseDelayMs = opts?.baseDelayMs ?? DEFAULT_BASE_DELAY_MS;
   const maxDelayMs = opts?.maxDelayMs ?? DEFAULT_MAX_DELAY_MS;
@@ -249,11 +255,7 @@ async function withRetry(fn, opts) {
       return await fn();
     } catch (err) {
       lastError = err;
-      if (err instanceof MedialaneApiError && err.status < 500 && err.status !== 429) {
-        throw err;
-      }
-      const isRetryable = err instanceof MedialaneApiError && (err.status >= 500 || err.status === 429) || err instanceof TypeError;
-      if (!isRetryable || attempt === maxAttempts - 1) {
+      if (!isRetryableFor(method, err) || attempt === maxAttempts - 1) {
         throw err;
       }
       const retryAfterMs = err instanceof MedialaneApiError ? err.retryAfterMs : void 0;
@@ -334,7 +336,7 @@ var ApiClient = class {
         );
       }
       return response;
-    }, this.retryOptions);
+    }, this.retryOptions, (init?.method ?? "GET").toUpperCase());
     if (allowed(res.status)) return null;
     return res.json();
   }
@@ -402,19 +404,6 @@ var ApiClient = class {
       `/v1/tokens/${contract}/${tokenId}/history?page=${page}&limit=${limit}`
     );
   }
-  getCollections(page = 1, limit = 20, isKnown, sort, service, chain, standard) {
-    const params = new URLSearchParams({ page: String(page), limit: String(limit) });
-    if (isKnown !== void 0) params.set("isKnown", String(isKnown));
-    if (sort) params.set("sort", sort);
-    if (service) params.set("service", service);
-    if (chain) params.set("chain", chain);
-    if (standard) params.set("standard", standard);
-    return this.get(`/v1/collections?${params}`);
-  }
-  getCollectionsByOwner(owner, page = 1, limit = 50) {
-    const params = new URLSearchParams({ owner: this.addr(owner), page: String(page), limit: String(limit) });
-    return this.get(`/v1/collections?${params}`);
-  }
   getCollection(contract) {
     return this.get(`/v1/collections/${this.addr(contract)}`);
   }
@@ -783,10 +772,8 @@ var ApiClient = class {
     });
   }
   async checkEmail(email) {
-    const body = await this.get(
-      `/v1/auth/email/exists?email=${encodeURIComponent(email)}`
-    );
-    return { exists: body.exists, walletWaiting: body.walletWaiting === true };
+    const body = await this.get(`/v1/auth/email/exists?email=${encodeURIComponent(email)}`);
+    return { exists: body.exists };
   }
   async requestEmailCode(email) {
     await this.post("/v1/auth/email/request-code", { email });
@@ -795,15 +782,19 @@ var ApiClient = class {
     await this.post("/v1/auth/email/register-account", { email });
   }
   async verifyEmailCode(email, code) {
-    const body = await this.post("/v1/auth/email/verify-code", { email, code });
-    return { waitingWallets: body.waitingWallets ?? [] };
+    await this.post("/v1/auth/email/verify-code", { email, code });
   }
-  claimWallet(params) {
-    return this.post("/v1/users/me/claim-wallet", params);
+  /**
+   * Makes the passkey the only owner of the session account's wallet. `signature` is the passkey's owner-alive
+   * proof for the wallet. Answers 409 when the wallet is already set up.
+   */
+  setupWalletKey(params) {
+    return this.post("/v1/users/me/wallet/key", params);
   }
+  /** The session account's wallet, and whether its passkey still has to be set up (`setupWalletKey`). */
   async getSessionWallet() {
     const body = await this.post("/v1/users/me/wallet", {});
-    return body.walletAddress ?? null;
+    return body.walletAddress ? { walletAddress: body.walletAddress, needsKeySetup: body.needsKeySetup === true } : null;
   }
   getMyWallet(siwsToken) {
     return this.request(
@@ -886,9 +877,6 @@ var ApiClient = class {
       headers: { "Authorization": `Bearer ${siwsToken}` }
     });
   }
-  getPopCollections(opts = {}) {
-    return this.getCollections(opts.page ?? 1, opts.limit ?? 20, void 0, opts.sort, "pop-protocol");
-  }
   async getPopEligibility(collection, wallet) {
     const res = await this.get(
       `/v1/pop/eligibility/${this.addr(collection)}/${this.addr(wallet)}`
@@ -938,9 +926,6 @@ var ApiClient = class {
       headers: this.bearer(siwsToken)
     });
   }
-  getDropCollections(opts = {}) {
-    return this.getCollections(opts.page ?? 1, opts.limit ?? 20, void 0, opts.sort, "drop-collection");
-  }
   async getDropMintStatus(collection, wallet) {
     const res = await this.get(
       `/v1/drop/mint-status/${this.addr(collection)}/${this.addr(wallet)}`
@@ -967,6 +952,10 @@ var ApiClient = class {
     const res = await this.get(`/v1/tickets/${this.addr(contract)}/count`);
     return res.data.count;
   }
+  async getClubMembershipCount(contract) {
+    const res = await this.get(`/v1/club/${this.addr(contract)}/count`);
+    return res.data.count;
+  }
   async getClubMembership(contract, tokenId) {
     const res = await this.get(`/v1/club/${this.addr(contract)}/${tokenId}`);
     return res.data;
@@ -1050,6 +1039,7 @@ var ApiClient = class {
     if (query.sort) params.set("sort", query.sort);
     if (query.isFeatured !== void 0) params.set("isFeatured", String(query.isFeatured));
     if (query.hideEmpty !== void 0) params.set("hideEmpty", String(query.hideEmpty));
+    if (query.standard) params.set("standard", query.standard);
     if (query.chain) params.set("chain", query.chain);
     const qs = params.toString();
     return this.get(`/v1/collections${qs ? `?${qs}` : ""}`);