@medialane/sdk 0.85.2 → 0.85.4

package/README.md

@@ -210,7 +210,7 @@ const result = await client.marketplace1155.cancelOrder(account, {
 });
 ```
 
-### SNIP-12 Typed Data Builders (ChipiPay / custom flows)
+### SNIP-12 Typed Data Builders (custodial-wallet / custom flows)
 
 Listing/offer and cancellation are signed; fulfilment is an **unsigned** call (the buyer is
 the fulfiller, since v0.26.0) — there is no fulfillment typed-data builder.
@@ -486,7 +486,7 @@ try {
 
 ## Advanced: SNIP-12 Typed Data Builders
 
-For integrations that handle signing externally (e.g. ChipiPay, Cartridge Controller):
+For integrations that handle signing externally (e.g. a custodial wallet service, Cartridge Controller):
 
 ```typescript
 import {
@@ -562,7 +562,7 @@ Built with:
 - **`ApiCollectionProfile.gatedContentTitle: string | null`** — public title of gated content (shown to all users; URL is accessible to holders only via the backend gated-content endpoint)
 
 ### v0.5.5
-- **`extendRemixOffer(id, days, clerkToken)`** — requester extends expiry of a PENDING/AUTO_PENDING remix offer by 1–30 days (`POST /v1/remix-offers/:id/extend`)
+- **`extendRemixOffer(id, days, siwsToken)`** — requester extends expiry of a PENDING/AUTO_PENDING remix offer by 1–30 days (`POST /v1/remix-offers/:id/extend`)
 - **`ApiRemixOfferPrice`** type — `{ raw, formatted, currency, decimals }` replaces flat `proposedPrice`/`proposedCurrency` fields on `ApiRemixOffer.price` (visible to participants only)
 
 ### v0.5.4
@@ -573,17 +573,17 @@ Built with:
 - **`ApiComment`** type — `{ id, author, content, txHash, blockNumber, blockTimestamp, isHidden, createdAt }`
 
 ### v0.5.0
-- **Counter-offer support** — `createCounterOfferIntent(params, clerkToken)`, `getCounterOffers(query)`, `ApiCounterOffersQuery`, `CreateCounterOfferIntentParams`
+- **Counter-offer support** — `createCounterOfferIntent(params, siwsToken)`, `getCounterOffers(query)`, `ApiCounterOffersQuery`, `CreateCounterOfferIntentParams`
 - **`OrderStatus`** extended with `"COUNTER_OFFERED"`; **`IntentType`** with `"COUNTER_OFFER"`
 - **`ApiOrder`** extended: `parentOrderHash?: string | null`, `counterOfferMessage?: string | null`
 - **Remix licensing** — full set of remix offer methods and types:
-  - `submitRemixOffer(params, clerkToken)` — custom offer
-  - `submitAutoRemixOffer(params, clerkToken)` — auto offer for open-license tokens
-  - `confirmSelfRemix(params, clerkToken)` — record owner self-remix
-  - `getRemixOffers(query, clerkToken)` — list by role
-  - `getRemixOffer(id, clerkToken?)` — single offer
-  - `confirmRemixOffer(id, params, clerkToken)` — creator approves
-  - `rejectRemixOffer(id, clerkToken)` — creator rejects
+  - `submitRemixOffer(params, siwsToken)` — custom offer
+  - `submitAutoRemixOffer(params, siwsToken)` — auto offer for open-license tokens
+  - `confirmSelfRemix(params, siwsToken)` — record owner self-remix
+  - `getRemixOffers(query, siwsToken)` — list by role
+  - `getRemixOffer(id, siwsToken?)` — single offer
+  - `confirmRemixOffer(id, params, siwsToken)` — creator approves
+  - `rejectRemixOffer(id, siwsToken)` — creator rejects
   - `getTokenRemixes(contract, tokenId, opts?)` — public remix list
 - **New types** — `RemixOfferStatus`, `ApiRemixOffer`, `ApiPublicRemix`, `OPEN_LICENSES`, `OpenLicense`, `CreateRemixOfferParams`, `AutoRemixOfferParams`, `ConfirmSelfRemixParams`, `ConfirmRemixOfferParams`, `ApiRemixOffersQuery`
 
@@ -594,7 +594,7 @@ Built with:
 - **`IPType`** union type exported — `"Audio" | "Art" | "Documents" | "NFT" | "Video" | "Photography" | "Patents" | "Posts" | "Publications" | "RWA" | "Software" | "Custom"`
 
 ### v0.4.6
-- **`ApiUserWallet`** type + `upsertMyWallet(clerkToken)` / `getMyWallet(clerkToken)` for ChipiPay wallet registration fallback (`POST/GET /v1/users/me`)
+- **`ApiUserWallet`** type + `upsertMyWallet(siwsToken)` / `getMyWallet(siwsToken)` for wallet registration fallback (`POST/GET /v1/users/me`)
 
 ### v0.4.5
 - **`ApiSearchCreatorResult`** type + `ApiSearchResult.creators` — creator profiles now included in search results
@@ -613,9 +613,9 @@ Built with:
 - **USDC.e removed** — bridged USDC (`0x053c91...`) removed entirely; only Circle-native USDC remains, to avoid user confusion
 
 ### v0.4.1
-- **Collection claims** — `claimCollection(contractAddress, walletAddress, clerkToken)` for on-chain ownership verification; `requestCollectionClaim({ contractAddress, walletAddress?, email, notes? })` for manual review
-- **Collection profiles** — `getCollectionProfile(contractAddress)` and `updateCollectionProfile(contractAddress, data, clerkToken)` for enriched display metadata (displayName, description, image, bannerImage, social links)
-- **Creator profiles** — `getCreatorProfile(walletAddress)` and `updateCreatorProfile(walletAddress, data, clerkToken)` for creator display metadata
+- **Collection claims** — `claimCollection(contractAddress, walletAddress, siwsToken)` for on-chain ownership verification; `requestCollectionClaim({ contractAddress, walletAddress?, email, notes? })` for manual review
+- **Collection profiles** — `getCollectionProfile(contractAddress)` and `updateCollectionProfile(contractAddress, data, siwsToken)` for enriched display metadata (displayName, description, image, bannerImage, social links)
+- **Creator profiles** — `getCreatorProfile(walletAddress)` and `updateCreatorProfile(walletAddress, data, siwsToken)` for creator display metadata
 - **New types** — `ApiCollectionClaim`, `ApiAdminCollectionClaim`, `ApiCollectionProfile`, `ApiCreatorProfile`
 - **`ApiCollection`** extended with `source` (`"MEDIALANE_REGISTRY" | "EXTERNAL" | "PARTNERSHIP" | "IP_TICKET" | "IP_CLUB" | "GAME"`) and `claimedBy: string | null`
 - `profile?: ApiCollectionProfile | null` optionally embedded on `ApiCollection` when `?include=profile`

package/dist/index.cjs

@@ -333,9 +333,9 @@ var ApiClient = class {
   del(path) {
     return this.request(path, { method: "DELETE" });
   }
-  /** Bearer header for Clerk-JWT-authenticated routes. */
-  bearer(clerkToken) {
-    return { Authorization: `Bearer ${clerkToken}` };
+  /** Bearer header for SIWS-token-authenticated routes. */
+  bearer(siwsToken) {
+    return { Authorization: `Bearer ${siwsToken}` };
   }
   // ─── Orders ────────────────────────────────────────────────────────────────
   getOrders(query = {}) {
@@ -405,6 +405,7 @@ var ApiClient = class {
   getActivities(query = {}) {
     const params = new URLSearchParams();
     if (query.type) params.set("type", query.type);
+    if (query.contract) params.set("contract", query.contract);
     if (query.page !== void 0) params.set("page", String(query.page));
     if (query.limit !== void 0) params.set("limit", String(query.limit));
     if (query.chain) params.set("chain", query.chain);
@@ -503,11 +504,11 @@ var ApiClient = class {
   }
   /**
    * Create a counter-offer intent. The seller proposes a new price in response
-   * to a buyer's active bid. clerkToken is optional — the endpoint authenticates
-   * via the tenant API key; pass a Clerk JWT only if your backend requires it.
+   * to a buyer's active bid. siwsToken is optional — the endpoint authenticates
+   * via the tenant API key; pass a SIWS token only if your backend requires it.
    */
-  createCounterOfferIntent(params, clerkToken) {
-    const extraHeaders = clerkToken ? { "Authorization": `Bearer ${clerkToken}` } : {};
+  createCounterOfferIntent(params, siwsToken) {
+    const extraHeaders = siwsToken ? { "Authorization": `Bearer ${siwsToken}` } : {};
     return this.request("/v1/intents/counter-offer", {
       method: "POST",
       body: JSON.stringify(params),
@@ -575,13 +576,13 @@ var ApiClient = class {
   // ─── Collection Claims ──────────────────────────────────────────────────────
   /**
    * Path 1: On-chain auto claim. Sends both x-api-key (tenant auth) and
-   * Authorization: Bearer (Clerk JWT) simultaneously.
+   * Authorization: Bearer (SIWS token) simultaneously.
    */
-  async claimCollection(contractAddress, walletAddress, clerkToken) {
+  async claimCollection(contractAddress, walletAddress, siwsToken) {
     return this.request("/v1/collections/claim", {
       method: "POST",
       body: JSON.stringify({ contractAddress, walletAddress }),
-      headers: this.bearer(clerkToken)
+      headers: this.bearer(siwsToken)
     });
   }
   /**
@@ -609,12 +610,12 @@ var ApiClient = class {
     );
   }
   /**
-   * Update collection profile. Requires Clerk JWT for ownership check.
+   * Update collection profile. Requires SIWS token for ownership check.
    */
-  updateCollectionProfile(contractAddress, data, clerkToken) {
+  updateCollectionProfile(contractAddress, data, siwsToken) {
     return this.request(
       `/v1/collections/${this.addr(contractAddress)}/profile`,
-      { method: "PATCH", body: JSON.stringify(data), headers: this.bearer(clerkToken) }
+      { method: "PATCH", body: JSON.stringify(data), headers: this.bearer(siwsToken) }
     );
   }
   /** No signature required — wallet activity is public on-chain data, read like any other /v1 GET. */
@@ -623,10 +624,10 @@ var ApiClient = class {
       `/v1/wallet-activity?address=${this.addr(address)}&chain=${chain}`
     );
   }
-  getGatedContent(contractAddress, clerkToken) {
+  getGatedContent(contractAddress, siwsToken) {
     return this.request(
       `/v1/collections/${this.addr(contractAddress)}/gated-content`,
-      { method: "GET", headers: this.bearer(clerkToken) },
+      { method: "GET", headers: this.bearer(siwsToken) },
       { allow404: true, allow403: true }
     );
   }
@@ -656,12 +657,12 @@ var ApiClient = class {
     );
   }
   /**
-   * Update creator profile. Requires Clerk JWT; wallet must match authenticated user.
+   * Update creator profile. Requires SIWS token; wallet must match authenticated user.
    */
-  updateCreatorProfile(walletAddress, data, clerkToken) {
+  updateCreatorProfile(walletAddress, data, siwsToken) {
     return this.request(
       `/v1/creators/${this.addr(walletAddress)}/profile`,
-      { method: "PATCH", body: JSON.stringify(data), headers: this.bearer(clerkToken) }
+      { method: "PATCH", body: JSON.stringify(data), headers: this.bearer(siwsToken) }
     );
   }
   // ─── Collection Slug Claims ───────────────────────────────────────────────────
@@ -671,19 +672,19 @@ var ApiClient = class {
       `/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. */
-  submitCollectionSlugClaim(contractAddress, slug, clerkToken, notifyEmail) {
+  /** Submit a slug claim for a collection. Requires SIWS token — caller must be the collection owner. */
+  submitCollectionSlugClaim(contractAddress, slug, siwsToken, notifyEmail) {
     return this.request("/v1/collection-slug-claims", {
       method: "POST",
       body: JSON.stringify({ contractAddress, slug, notifyEmail }),
-      headers: this.bearer(clerkToken)
+      headers: this.bearer(siwsToken)
     });
   }
-  /** Returns all slug claims submitted by the authenticated wallet. Requires Clerk JWT. */
-  getMyCollectionSlugClaims(clerkToken) {
+  /** Returns all slug claims submitted by the authenticated wallet. Requires SIWS token. */
+  getMyCollectionSlugClaims(siwsToken) {
     return this.request("/v1/collection-slug-claims/me", {
       method: "GET",
-      headers: this.bearer(clerkToken)
+      headers: this.bearer(siwsToken)
     });
   }
   /** Resolve a collection slug to a full collection. Returns null if not found. */
@@ -696,19 +697,14 @@ var ApiClient = class {
   }
   // ─── User Wallet ─────────────────────────────────────────────────────────────
   /**
-   * Upsert the authenticated user's wallet address in the backend DB.
-   * Call after onboarding when ChipiPay confirms the wallet address.
-   * Requires Clerk JWT; no tenant API key needed.
-   */
-  /**
-   * Frictionless wallet registration. Tenant API key only (no Clerk JWT required).
+   * Frictionless wallet registration. Tenant API key only (no SIWS token required).
    * Idempotent — backend's ensureAccountForWallet upserts and upgrades existing
    * UNKNOWN walletType rows when a more specific value is supplied.
    */
   async registerUser(params) {
     return this.post("/v1/users/register", params);
   }
-  async upsertMyWallet(clerkToken, options = {}) {
+  async upsertMyWallet(siwsToken, options = {}) {
     const body = {
       walletType: options.walletType ?? "UNKNOWN",
       appSource: options.appSource ?? "MEDIALANE_SDK"
@@ -716,10 +712,11 @@ var ApiClient = class {
     if (options.chain) body.chain = options.chain;
     if (options.emailVerificationToken) body.emailVerificationToken = options.emailVerificationToken;
     if (options.email) body.email = options.email;
+    if (options.accountToken) body.accountToken = options.accountToken;
     return this.request("/v1/users/me", {
       method: "POST",
       body: JSON.stringify(body),
-      headers: this.bearer(clerkToken)
+      headers: this.bearer(siwsToken)
     });
   }
   /** Whether an email already has an account attached — used by io's onboarding to branch into an "already exists" message instead of creating a duplicate account. */
@@ -732,12 +729,12 @@ var ApiClient = class {
   /**
    * 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.
+   * Requires SIWS token; no tenant API key needed.
    */
-  getMyWallet(clerkToken) {
+  getMyWallet(siwsToken) {
     return this.request(
       "/v1/users/me",
-      { method: "GET", headers: this.bearer(clerkToken) },
+      { method: "GET", headers: this.bearer(siwsToken) },
       { allow404: true }
     );
   }
@@ -755,87 +752,87 @@ var ApiClient = class {
     );
   }
   /**
-   * Submit a custom remix offer for a token. Requires Clerk JWT.
+   * Submit a custom remix offer for a token. Requires SIWS token.
    */
-  submitRemixOffer(params, clerkToken) {
+  submitRemixOffer(params, siwsToken) {
     return this.request("/v1/remix-offers", {
       method: "POST",
       body: JSON.stringify(params),
-      headers: { "Authorization": `Bearer ${clerkToken}` }
+      headers: { "Authorization": `Bearer ${siwsToken}` }
     });
   }
   /**
-   * Submit an auto remix offer for a token with an open license. Requires Clerk JWT.
+   * Submit an auto remix offer for a token with an open license. Requires SIWS token.
    */
-  submitAutoRemixOffer(params, clerkToken) {
+  submitAutoRemixOffer(params, siwsToken) {
     return this.request("/v1/remix-offers/auto", {
       method: "POST",
       body: JSON.stringify(params),
-      headers: { "Authorization": `Bearer ${clerkToken}` }
+      headers: { "Authorization": `Bearer ${siwsToken}` }
     });
   }
   /**
-   * Record a self-remix (owner remixing their own token). Requires Clerk JWT.
+   * Record a self-remix (owner remixing their own token). Requires SIWS token.
    */
-  confirmSelfRemix(params, clerkToken) {
+  confirmSelfRemix(params, siwsToken) {
     return this.request("/v1/remix-offers/self/confirm", {
       method: "POST",
       body: JSON.stringify(params),
-      headers: { "Authorization": `Bearer ${clerkToken}` }
+      headers: { "Authorization": `Bearer ${siwsToken}` }
     });
   }
   /**
-   * List remix offers by role. Requires Clerk JWT.
+   * List remix offers by role. Requires SIWS token.
    * role="creator" — offers where you are the original creator.
    * role="requester" — offers you made.
    */
-  getRemixOffers(query, clerkToken) {
+  getRemixOffers(query, siwsToken) {
     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));
     return this.request(`/v1/remix-offers?${params}`, {
       method: "GET",
-      headers: this.bearer(clerkToken)
+      headers: this.bearer(siwsToken)
     });
   }
   /**
-   * Get a single remix offer. Clerk JWT optional (price/currency hidden for non-participants).
+   * Get a single remix offer. SIWS token optional (price/currency hidden for non-participants).
    */
-  getRemixOffer(id, clerkToken) {
+  getRemixOffer(id, siwsToken) {
     return this.request(`/v1/remix-offers/${id}`, {
       method: "GET",
-      headers: clerkToken ? this.bearer(clerkToken) : void 0
+      headers: siwsToken ? this.bearer(siwsToken) : void 0
     });
   }
   /**
-   * Creator approves a remix offer (authorises the requester to mint). Requires Clerk JWT.
+   * Creator approves a remix offer (authorises the requester to mint). Requires SIWS token.
    */
-  confirmRemixOffer(id, params, clerkToken) {
+  confirmRemixOffer(id, params, siwsToken) {
     return this.request(`/v1/remix-offers/${id}/confirm`, {
       method: "POST",
       body: JSON.stringify(params),
-      headers: { "Authorization": `Bearer ${clerkToken}` }
+      headers: { "Authorization": `Bearer ${siwsToken}` }
     });
   }
   /**
-   * Creator rejects a remix offer. Requires Clerk JWT.
+   * Creator rejects a remix offer. Requires SIWS token.
    */
-  rejectRemixOffer(id, clerkToken) {
+  rejectRemixOffer(id, siwsToken) {
     return this.request(`/v1/remix-offers/${id}/reject`, {
       method: "POST",
       body: JSON.stringify({}),
-      headers: { "Authorization": `Bearer ${clerkToken}` }
+      headers: { "Authorization": `Bearer ${siwsToken}` }
     });
   }
   /**
    * Requester extends the expiry of a pending remix offer by 1–30 days.
-   * Requires Clerk JWT.
+   * Requires SIWS token.
    */
-  extendRemixOffer(id, days, clerkToken) {
+  extendRemixOffer(id, days, siwsToken) {
     return this.request(`/v1/remix-offers/${id}/extend`, {
       method: "POST",
       body: JSON.stringify({ days }),
-      headers: { "Authorization": `Bearer ${clerkToken}` }
+      headers: { "Authorization": `Bearer ${siwsToken}` }
     });
   }
   // ─── POP Protocol ──────────────────────────────────────────────────────────
@@ -873,7 +870,7 @@ var ApiClient = class {
   /**
    * Creator-authed coin profile edit (image/description). Backend authorizes
    * via `coin.creator` (trustless — from the factory event), not a body param;
-   * `siwsToken` is the caller's SIWS/Clerk bearer token for `identityAuth`.
+   * `siwsToken` is the caller's SIWS bearer token for `identityAuth`.
    */
   updateCoinProfile(contract, data, siwsToken) {
     return this.request(`/v1/coins/${this.addr(contract)}`, {