@medialane/sdk 0.70.0 → 0.70.1

package/dist/{index-DRoaqZ2T.d.ts → index-BayGCrpT.d.ts}

@@ -982,12 +982,20 @@ declare class ApiClient {
     constructor(baseUrl: string, apiKey?: string, retryOptions?: RetryOptions, chain?: Chain);
     /** Normalize an address for this client's chain (chain-scoped — Decision B). */
     private addr;
+    /**
+     * The one HTTP path for the whole client: base headers (incl. x-api-key),
+     * JSON error unwrapping, and `withRetry` (5xx/network only — 4xx never
+     * retried). `allow404`/`allow403` turn those statuses into a `null` result
+     * instead of a throw, for "profile may not exist" / "not a holder" reads —
+     * so no method needs to hand-roll `fetch` to get that behavior.
+     */
     private request;
     private get;
     private post;
     private patch;
     private del;
-    private checkResponse;
+    /** Bearer header for Clerk-JWT-authenticated routes. */
+    private bearer;
     getOrders(query?: ApiOrdersQuery): Promise<ApiResponse<ApiOrder[]>>;
     getOrder(orderHash: string): Promise<ApiResponse<ApiOrder>>;
     getActiveOrdersForToken(contract: string, tokenId: string): Promise<ApiResponse<ApiOrder[]>>;

package/dist/{index-C6dV4UYm.d.cts → index-D-ugU7Tw.d.cts}

@@ -982,12 +982,20 @@ declare class ApiClient {
     constructor(baseUrl: string, apiKey?: string, retryOptions?: RetryOptions, chain?: Chain);
     /** Normalize an address for this client's chain (chain-scoped — Decision B). */
     private addr;
+    /**
+     * The one HTTP path for the whole client: base headers (incl. x-api-key),
+     * JSON error unwrapping, and `withRetry` (5xx/network only — 4xx never
+     * retried). `allow404`/`allow403` turn those statuses into a `null` result
+     * instead of a throw, for "profile may not exist" / "not a holder" reads —
+     * so no method needs to hand-roll `fetch` to get that behavior.
+     */
     private request;
     private get;
     private post;
     private patch;
     private del;
-    private checkResponse;
+    /** Bearer header for Clerk-JWT-authenticated routes. */
+    private bearer;
     getOrders(query?: ApiOrdersQuery): Promise<ApiResponse<ApiOrder[]>>;
     getOrder(orderHash: string): Promise<ApiResponse<ApiOrder>>;
     getActiveOrdersForToken(contract: string, tokenId: string): Promise<ApiResponse<ApiOrder[]>>;

package/dist/index.cjs

@@ -275,18 +275,26 @@ var ApiClient = class {
   addr(a) {
     return normalizeAddress(this.chain, a);
   }
-  async request(path, init) {
+  /**
+   * The one HTTP path for the whole client: base headers (incl. x-api-key),
+   * JSON error unwrapping, and `withRetry` (5xx/network only — 4xx never
+   * retried). `allow404`/`allow403` turn those statuses into a `null` result
+   * instead of a throw, for "profile may not exist" / "not a holder" reads —
+   * so no method needs to hand-roll `fetch` to get that behavior.
+   */
+  async request(path, init, opts) {
     const url = `${this.baseUrl.replace(/\/$/, "")}${path}`;
     const headers = { ...this.baseHeaders };
     if (!(init?.body instanceof FormData)) {
       headers["Content-Type"] = "application/json";
     }
+    const allowed = (status) => opts?.allow404 === true && status === 404 || opts?.allow403 === true && status === 403;
     const res = await withRetry(async () => {
       const response = await fetch(url, {
         ...init,
         headers: { ...headers, ...init?.headers }
       });
-      if (!response.ok) {
+      if (!response.ok && !allowed(response.status)) {
         const text = await response.text().catch(() => response.statusText);
         let message = text;
         try {
@@ -298,6 +306,7 @@ var ApiClient = class {
       }
       return response;
     }, this.retryOptions);
+    if (allowed(res.status)) return null;
     return res.json();
   }
   get(path) {
@@ -312,20 +321,9 @@ var ApiClient = class {
   del(path) {
     return this.request(path, { method: "DELETE" });
   }
-  async checkResponse(res, options) {
-    if (options?.allow404 && res.status === 404) return null;
-    if (options?.allow403 && res.status === 403) return null;
-    if (!res.ok) {
-      const text = await res.text().catch(() => res.statusText);
-      let message = text;
-      try {
-        const body = JSON.parse(text);
-        if (body.error) message = body.error;
-      } catch {
-      }
-      throw new MedialaneApiError(res.status, message);
-    }
-    return res.json();
+  /** Bearer header for Clerk-JWT-authenticated routes. */
+  bearer(clerkToken) {
+    return { Authorization: `Bearer ${clerkToken}` };
   }
   // ─── Orders ────────────────────────────────────────────────────────────────
   getOrders(query = {}) {
@@ -529,17 +527,11 @@ var ApiClient = class {
    * Authorization: Bearer (Clerk JWT) simultaneously.
    */
   async claimCollection(contractAddress, walletAddress, clerkToken) {
-    const url = `${this.baseUrl.replace(/\/$/, "")}/v1/collections/claim`;
-    const res = await fetch(url, {
+    return this.request("/v1/collections/claim", {
       method: "POST",
-      headers: {
-        "x-api-key": this.baseHeaders["x-api-key"] ?? "",
-        "Content-Type": "application/json",
-        "Authorization": `Bearer ${clerkToken}`
-      },
-      body: JSON.stringify({ contractAddress, walletAddress })
+      body: JSON.stringify({ contractAddress, walletAddress }),
+      headers: this.bearer(clerkToken)
     });
-    return this.checkResponse(res);
   }
   /**
    * Path 3: Manual off-chain claim request (email-based).
@@ -551,106 +543,92 @@ var ApiClient = class {
     });
   }
   // ─── Collection Profiles ────────────────────────────────────────────────────
-  async getCollectionProfile(contractAddress) {
-    const url = `${this.baseUrl.replace(/\/$/, "")}/v1/collections/${this.addr(contractAddress)}/profile`;
-    const res = await fetch(url, { headers: this.baseHeaders });
-    return this.checkResponse(res, { allow404: true });
+  getCollectionProfile(contractAddress) {
+    return this.request(
+      `/v1/collections/${this.addr(contractAddress)}/profile`,
+      { method: "GET" },
+      { allow404: true }
+    );
   }
   /**
    * Update collection profile. Requires Clerk JWT for ownership check.
    */
-  async updateCollectionProfile(contractAddress, data, clerkToken) {
-    const url = `${this.baseUrl.replace(/\/$/, "")}/v1/collections/${this.addr(contractAddress)}/profile`;
-    const res = await fetch(url, {
-      method: "PATCH",
-      headers: {
-        "x-api-key": this.baseHeaders["x-api-key"] ?? "",
-        "Content-Type": "application/json",
-        "Authorization": `Bearer ${clerkToken}`
-      },
-      body: JSON.stringify(data)
-    });
-    return this.checkResponse(res);
+  updateCollectionProfile(contractAddress, data, clerkToken) {
+    return this.request(
+      `/v1/collections/${this.addr(contractAddress)}/profile`,
+      { method: "PATCH", body: JSON.stringify(data), headers: this.bearer(clerkToken) }
+    );
   }
-  async getGatedContent(contractAddress, clerkToken) {
-    const url = `${this.baseUrl.replace(/\/$/, "")}/v1/collections/${this.addr(contractAddress)}/gated-content`;
-    const res = await fetch(url, {
-      headers: { ...this.baseHeaders, "Authorization": `Bearer ${clerkToken}` }
-    });
-    return this.checkResponse(res, { allow404: true, allow403: true });
+  getGatedContent(contractAddress, clerkToken) {
+    return this.request(
+      `/v1/collections/${this.addr(contractAddress)}/gated-content`,
+      { method: "GET", headers: this.bearer(clerkToken) },
+      { allow404: true, allow403: true }
+    );
   }
   // ─── Creator Profiles ───────────────────────────────────────────────────────
   /** List all creators with an approved username. */
-  async getCreators(opts = {}) {
+  getCreators(opts = {}) {
     const params = new URLSearchParams();
     if (opts.search) params.set("search", opts.search);
     if (opts.page) params.set("page", String(opts.page));
     if (opts.limit) params.set("limit", String(opts.limit));
-    const url = `${this.baseUrl.replace(/\/$/, "")}/v1/creators?${params}`;
-    const res = await fetch(url, { headers: this.baseHeaders });
-    return this.checkResponse(res);
+    const qs = params.toString();
+    return this.get(`/v1/creators${qs ? `?${qs}` : ""}`);
   }
-  async getCreatorProfile(walletAddress) {
-    const url = `${this.baseUrl.replace(/\/$/, "")}/v1/creators/${this.addr(walletAddress)}/profile`;
-    const res = await fetch(url, { headers: this.baseHeaders });
-    return this.checkResponse(res, { allow404: true });
+  getCreatorProfile(walletAddress) {
+    return this.request(
+      `/v1/creators/${this.addr(walletAddress)}/profile`,
+      { method: "GET" },
+      { allow404: true }
+    );
   }
   /** Resolve a username slug to a creator profile (public). */
-  async getCreatorByUsername(username) {
-    const url = `${this.baseUrl.replace(/\/$/, "")}/v1/creators/by-username/${encodeURIComponent(username.toLowerCase().trim())}`;
-    const res = await fetch(url, { headers: this.baseHeaders });
-    return this.checkResponse(res, { allow404: true });
+  getCreatorByUsername(username) {
+    return this.request(
+      `/v1/creators/by-username/${encodeURIComponent(username.toLowerCase().trim())}`,
+      { method: "GET" },
+      { allow404: true }
+    );
   }
   /**
    * Update creator profile. Requires Clerk JWT; wallet must match authenticated user.
    */
-  async updateCreatorProfile(walletAddress, data, clerkToken) {
-    const url = `${this.baseUrl.replace(/\/$/, "")}/v1/creators/${this.addr(walletAddress)}/profile`;
-    const res = await fetch(url, {
-      method: "PATCH",
-      headers: {
-        "x-api-key": this.baseHeaders["x-api-key"] ?? "",
-        "Content-Type": "application/json",
-        "Authorization": `Bearer ${clerkToken}`
-      },
-      body: JSON.stringify(data)
-    });
-    return this.checkResponse(res);
+  updateCreatorProfile(walletAddress, data, clerkToken) {
+    return this.request(
+      `/v1/creators/${this.addr(walletAddress)}/profile`,
+      { method: "PATCH", body: JSON.stringify(data), headers: this.bearer(clerkToken) }
+    );
   }
   // ─── Collection Slug Claims ───────────────────────────────────────────────────
   /** Check if a collection slug is available (public, no auth). */
-  async checkCollectionSlugAvailability(slug) {
-    const url = `${this.baseUrl.replace(/\/$/, "")}/v1/collection-slug-claims/check/${encodeURIComponent(slug.toLowerCase().trim())}`;
-    const res = await fetch(url, { headers: this.baseHeaders });
-    return this.checkResponse(res);
+  checkCollectionSlugAvailability(slug) {
+    return this.get(
+      `/v1/collection-slug-claims/check/${encodeURIComponent(slug.toLowerCase().trim())}`
+    );
   }
   /** Submit a slug claim for a collection. Requires Clerk JWT — caller must be the collection owner. */
-  async submitCollectionSlugClaim(contractAddress, slug, clerkToken, notifyEmail) {
-    const url = `${this.baseUrl.replace(/\/$/, "")}/v1/collection-slug-claims`;
-    const res = await fetch(url, {
+  submitCollectionSlugClaim(contractAddress, slug, clerkToken, notifyEmail) {
+    return this.request("/v1/collection-slug-claims", {
       method: "POST",
-      headers: {
-        "x-api-key": this.baseHeaders["x-api-key"] ?? "",
-        "Content-Type": "application/json",
-        Authorization: `Bearer ${clerkToken}`
-      },
-      body: JSON.stringify({ contractAddress, slug, notifyEmail })
+      body: JSON.stringify({ contractAddress, slug, notifyEmail }),
+      headers: this.bearer(clerkToken)
     });
-    return this.checkResponse(res);
   }
   /** Returns all slug claims submitted by the authenticated wallet. Requires Clerk JWT. */
-  async getMyCollectionSlugClaims(clerkToken) {
-    const url = `${this.baseUrl.replace(/\/$/, "")}/v1/collection-slug-claims/me`;
-    const res = await fetch(url, {
-      headers: { ...this.baseHeaders, Authorization: `Bearer ${clerkToken}` }
+  getMyCollectionSlugClaims(clerkToken) {
+    return this.request("/v1/collection-slug-claims/me", {
+      method: "GET",
+      headers: this.bearer(clerkToken)
     });
-    return this.checkResponse(res);
   }
   /** Resolve a collection slug to a full collection. Returns null if not found. */
-  async getCollectionBySlug(slug) {
-    const url = `${this.baseUrl.replace(/\/$/, "")}/v1/collections/by-slug/${encodeURIComponent(slug.toLowerCase().trim())}`;
-    const res = await fetch(url, { headers: this.baseHeaders });
-    return this.checkResponse(res, { allow404: true });
+  getCollectionBySlug(slug) {
+    return this.request(
+      `/v1/collections/by-slug/${encodeURIComponent(slug.toLowerCase().trim())}`,
+      { method: "GET" },
+      { allow404: true }
+    );
   }
   // ─── User Wallet ─────────────────────────────────────────────────────────────
   /**
@@ -667,33 +645,28 @@ var ApiClient = class {
     return this.post("/v1/users/register", params);
   }
   async upsertMyWallet(clerkToken, options = {}) {
-    const url = `${this.baseUrl.replace(/\/$/, "")}/v1/users/me`;
     const body = {
       walletType: options.walletType ?? "UNKNOWN",
       appSource: options.appSource ?? "MEDIALANE_SDK"
     };
     if (options.chain) body.chain = options.chain;
-    const res = await fetch(url, {
+    return this.request("/v1/users/me", {
       method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "Authorization": `Bearer ${clerkToken}`
-      },
-      body: JSON.stringify(body)
+      body: JSON.stringify(body),
+      headers: this.bearer(clerkToken)
     });
-    return this.checkResponse(res);
   }
   /**
    * Get the authenticated user's stored wallet address from the backend DB.
    * Returns null if the user has not completed onboarding yet.
    * Requires Clerk JWT; no tenant API key needed.
    */
-  async getMyWallet(clerkToken) {
-    const url = `${this.baseUrl.replace(/\/$/, "")}/v1/users/me`;
-    const res = await fetch(url, {
-      headers: { "Authorization": `Bearer ${clerkToken}` }
-    });
-    return this.checkResponse(res, { allow404: true });
+  getMyWallet(clerkToken) {
+    return this.request(
+      "/v1/users/me",
+      { method: "GET", headers: this.bearer(clerkToken) },
+      { allow404: true }
+    );
   }
   // ─── Remix Licensing ─────────────────────────────────────────────────────────
   /**
@@ -743,25 +716,23 @@ var ApiClient = class {
    * role="creator" — offers where you are the original creator.
    * role="requester" — offers you made.
    */
-  async getRemixOffers(query, clerkToken) {
+  getRemixOffers(query, clerkToken) {
     const params = new URLSearchParams({ role: query.role });
     if (query.page !== void 0) params.set("page", String(query.page));
     if (query.limit !== void 0) params.set("limit", String(query.limit));
-    const url = `${this.baseUrl.replace(/\/$/, "")}/v1/remix-offers?${params}`;
-    const res = await fetch(url, {
-      headers: { ...this.baseHeaders, "Authorization": `Bearer ${clerkToken}` }
+    return this.request(`/v1/remix-offers?${params}`, {
+      method: "GET",
+      headers: this.bearer(clerkToken)
     });
-    return this.checkResponse(res);
   }
   /**
    * Get a single remix offer. Clerk JWT optional (price/currency hidden for non-participants).
    */
-  async getRemixOffer(id, clerkToken) {
-    const url = `${this.baseUrl.replace(/\/$/, "")}/v1/remix-offers/${id}`;
-    const headers = { ...this.baseHeaders };
-    if (clerkToken) headers["Authorization"] = `Bearer ${clerkToken}`;
-    const res = await fetch(url, { headers });
-    return this.checkResponse(res);
+  getRemixOffer(id, clerkToken) {
+    return this.request(`/v1/remix-offers/${id}`, {
+      method: "GET",
+      headers: clerkToken ? this.bearer(clerkToken) : void 0
+    });
   }
   /**
    * Creator approves a remix offer (authorises the requester to mint). Requires Clerk JWT.
@@ -1226,15 +1197,28 @@ function parseAmount(human, decimals) {
 }
 function formatAmount(raw, decimals) {
   const value = BigInt(raw);
-  const factor = BigInt(Math.pow(10, decimals));
+  const factor = 10n ** BigInt(decimals);
   const whole = value / factor;
   const remainder = value % factor;
   const fractional = remainder.toString().padStart(decimals, "0");
   return `${whole}.${fractional}`;
 }
 function getTokenByAddress(address) {
-  const lower = address.toLowerCase();
-  return SUPPORTED_TOKENS.find((t) => t.address.toLowerCase() === lower);
+  let target = null;
+  try {
+    target = BigInt(address);
+  } catch {
+    target = null;
+  }
+  return SUPPORTED_TOKENS.find((t) => {
+    if (target !== null) {
+      try {
+        return BigInt(t.address) === target;
+      } catch {
+      }
+    }
+    return t.address.toLowerCase() === address.toLowerCase();
+  });
 }
 function getTokenBySymbol(symbol) {
   const upper = symbol.toUpperCase();