@misofm/sdk 0.12.3 → 0.13.0

package/src/read/catalog.ts

@@ -456,8 +456,8 @@ export async function getPressingPreview(
 
 /**
  * Everything a currency-specific buy page renders. The Listing is derived from
- * the release's Pressing and the requested currency, never found through an old
- * drop pointer.
+ * the release's Pressing and the requested currency, never found through mutable
+ * lookup state.
  */
 export async function getSaleDetail(
   client: MisoClient,
@@ -481,7 +481,7 @@ export async function getSaleDetail(
  * The records currently on sale.
  *
  * Configured by release + currency: Pressing and Listing ids are deterministic,
- * permanent derived addresses. There is no `CurrentDropKey` pointer or edition
+ * permanent derived addresses. There is no mutable Pressing pointer or edition
  * replacement in the current ABI.
  */
 export async function getDiscoverShelf(

package/src/read/receipts.ts

@@ -325,8 +325,8 @@ export function breakdown(
 
 /**
  * The receipt for `txDigest`. The event identifies the exact immutable Pressing
- * and Listing; callers cannot accidentally reinterpret a Pressing id as a
- * retired drop id.
+ * and Listing; callers cannot accidentally reinterpret a Pressing id as an
+ * obsolete sale-object id.
  *
  * The sale identifies the Pressing before its detail is fetched. `null` only when
  * that immutable Pressing cannot be read; it is never superseded or destroyed.

package/src/recording-extensions.ts

@@ -3,21 +3,25 @@
 
 /** Cap-authorized builders for data-only Recording metadata extensions. */
 
-import type { TransactionArgument } from "@mysten/sui/transactions";
+import type { Transaction, TransactionArgument, TransactionObjectArgument } from "@mysten/sui/transactions";
 import type { TxThunk } from "./transactions.ts";
-import { invokeWithAdminCap, type AdminCapAuthority } from "./vault.ts";
+import { invokeWithAdminCap, type AdminCapAuthority, type ObjectInput } from "./vault.ts";
 import * as advisory from "./contracts/recording_advisory/recording_advisory.ts";
 import * as language from "./contracts/recording_language/recording_language.ts";
 import * as masterReference from "./contracts/recording_master_reference/recording_master_reference.ts";
 import * as preview from "./contracts/recording_preview/recording_preview.ts";
 
 export interface RecordingExtensionTarget {
-  readonly recordingId: string;
+  readonly recordingId: ObjectInput;
   readonly authority: AdminCapAuthority;
   readonly recordingShareType: string;
   readonly compositionShareType: string;
 }
 
+function object(tx: Transaction, value: ObjectInput): TransactionObjectArgument {
+  return typeof value === "string" ? tx.object(value) : value;
+}
+
 type Rating = "Explicit" | "NotExplicit" | "Cleaned";
 export interface SetRecordingAdvisoryParams extends RecordingExtensionTarget {
   readonly recordingAdvisoryPackageId: string;
@@ -34,7 +38,7 @@ export function setRecordingAdvisory(p: SetRecordingAdvisoryParams): TxThunk {
     invokeWithAdminCap(tx, p.authority, {
       target: `${p.recordingAdvisoryPackageId}::recording_advisory::set_rating`,
       typeArguments: [p.recordingShareType, p.compositionShareType],
-      arguments: [tx.object(p.recordingId), rating],
+      arguments: [object(tx, p.recordingId), rating],
       adminCapIndex: 1,
     });
   };
@@ -51,7 +55,7 @@ export function setRecordingLanguages(p: SetRecordingLanguagesParams): TxThunk {
     invokeWithAdminCap(tx, p.authority, {
       target: `${p.recordingLanguagePackageId}::recording_language::set_languages`,
       typeArguments: [p.recordingShareType, p.compositionShareType],
-      arguments: [tx.object(p.recordingId), p.languages],
+      arguments: [object(tx, p.recordingId), p.languages],
       adminCapIndex: 1,
     });
   };
@@ -62,7 +66,7 @@ export function setRecordingInstrumental(p: Omit<SetRecordingLanguagesParams, "l
     invokeWithAdminCap(tx, p.authority, {
       target: `${p.recordingLanguagePackageId}::recording_language::set_instrumental`,
       typeArguments: [p.recordingShareType, p.compositionShareType],
-      arguments: [tx.object(p.recordingId)],
+      arguments: [object(tx, p.recordingId)],
       adminCapIndex: 1,
     });
   };
@@ -81,7 +85,7 @@ export function setRecordingMasterReference(p: SetRecordingMasterReferenceParams
     invokeWithAdminCap(tx, p.authority, {
       target: `${p.recordingMasterReferencePackageId}::recording_master_reference::set_master_reference`,
       typeArguments: [p.recordingShareType, p.compositionShareType],
-      arguments: [tx.object(p.recordingId), p.reference],
+      arguments: [object(tx, p.recordingId), p.reference],
       adminCapIndex: 1,
     });
   };
@@ -95,7 +99,7 @@ export function setRecordingPreview(p: SetRecordingPreviewParams): TxThunk {
     invokeWithAdminCap(tx, p.authority, {
       target: `${p.recordingPreviewPackageId}::recording_preview::set_preview`,
       typeArguments: [p.recordingShareType, p.compositionShareType],
-      arguments: [tx.object(p.recordingId), p.reference],
+      arguments: [object(tx, p.recordingId), p.reference],
       adminCapIndex: 1,
     });
   };

package/src/release-extensions.ts

@@ -9,6 +9,7 @@ import { deriveObjectID } from "@mysten/sui/utils";
 import type {
   Transaction,
   TransactionArgument,
+  TransactionObjectArgument,
 } from "@mysten/sui/transactions";
 import type { TxThunk } from "./transactions.ts";
 import * as genre from "./contracts/genre/genre.ts";
@@ -16,13 +17,17 @@ import * as releaseDescription from "./contracts/release_description/release_des
 import * as releaseDspLink from "./contracts/release_dsp_link/release_dsp_link.ts";
 import * as releaseGenre from "./contracts/release_genre/release_genre.ts";
 import * as releaseKind from "./contracts/release_kind/release_kind.ts";
-import { asU64, directAdminCap, invokeWithAdminCap, type AdminCapAuthority, type U64Input } from "./vault.ts";
+import { asU64, directAdminCap, invokeWithAdminCap, type AdminCapAuthority, type ObjectInput, type U64Input } from "./vault.ts";
+
+function object(tx: Transaction, value: ObjectInput): TransactionObjectArgument {
+  return typeof value === "string" ? tx.object(value) : value;
+}
 
 type ReleaseAuthorityInput =
   | { readonly authority: AdminCapAuthority; readonly releaseAdminCapId?: never }
   | { readonly authority?: never; readonly releaseAdminCapId: string };
 interface ReleaseExtensionTargetBase {
-  releaseId: string;
+  releaseId: ObjectInput;
 }
 export type ReleaseExtensionTarget = ReleaseExtensionTargetBase & ReleaseAuthorityInput;
 function authority(p: ReleaseExtensionTarget): AdminCapAuthority {
@@ -48,7 +53,7 @@ export function setReleaseKind(p: SetReleaseKindParams): TxThunk {
   return (tx) => {
     invokeWithAdminCap(tx, authority(p), {
       target: `${p.releaseKindPackageId}::release_kind::set_kind`,
-      arguments: [tx.object(p.releaseId), tx.pure.string(p.kind)],
+      arguments: [object(tx, p.releaseId), tx.pure.string(p.kind)],
       adminCapIndex: 1,
     });
   };
@@ -73,7 +78,7 @@ export function setReleaseDescription(p: SetReleaseDescriptionParams): TxThunk {
   return (tx) => {
     invokeWithAdminCap(tx, authority(p), {
       target: `${p.releaseDescriptionPackageId}::release_description::set_description`,
-      arguments: [tx.object(p.releaseId), tx.pure.string(p.description)],
+      arguments: [object(tx, p.releaseId), tx.pure.string(p.description)],
       adminCapIndex: 1,
     });
   };
@@ -124,13 +129,13 @@ export function setReleaseGenres(p: SetReleaseGenresParams): TxThunk {
   return (tx) => {
     invokeWithAdminCap(tx, authority(p), {
       target: `${p.releaseGenrePackageId}::release_genre::set_primary_genre`,
-      arguments: [tx.object(p.releaseId), tx.object(p.primaryGenreId)],
+      arguments: [object(tx, p.releaseId), tx.object(p.primaryGenreId)],
       adminCapIndex: 1,
     });
     for (const genreId of p.secondaryGenreIds ?? []) {
       invokeWithAdminCap(tx, authority(p), {
         target: `${p.releaseGenrePackageId}::release_genre::add_secondary_genre`,
-        arguments: [tx.object(p.releaseId), tx.object(genreId)],
+        arguments: [object(tx, p.releaseId), tx.object(genreId)],
         adminCapIndex: 1,
       });
     }
@@ -138,7 +143,7 @@ export function setReleaseGenres(p: SetReleaseGenresParams): TxThunk {
       invokeWithAdminCap(tx, authority(p), {
         target: `${p.releaseGenrePackageId}::release_genre::set_track_primary_genre`,
         arguments: [
-          tx.object(p.releaseId),
+          object(tx, p.releaseId),
           tx.pure.u64(asU64("trackIndex", assignment.trackIndex)),
           tx.object(assignment.genreId),
         ],
@@ -247,7 +252,7 @@ export function setReleaseDspLinks(p: SetReleaseDspLinksParams): TxThunk {
       const value = buildDspLink(tx, p.releaseDspLinkPackageId, link);
       invokeWithAdminCap(tx, authority(p), {
         target: `${p.releaseDspLinkPackageId}::release_dsp_link::set_release_link`,
-        arguments: [tx.object(p.releaseId), value],
+        arguments: [object(tx, p.releaseId), value],
         adminCapIndex: 1,
       });
     }
@@ -255,7 +260,7 @@ export function setReleaseDspLinks(p: SetReleaseDspLinksParams): TxThunk {
       const value = buildDspLink(tx, p.releaseDspLinkPackageId, item.link);
       invokeWithAdminCap(tx, authority(p), {
         target: `${p.releaseDspLinkPackageId}::release_dsp_link::set_track_link`,
-        arguments: [tx.object(p.releaseId), tx.pure.u64(asU64("trackIndex", item.trackIndex)), value],
+        arguments: [object(tx, p.releaseId), tx.pure.u64(asU64("trackIndex", item.trackIndex)), value],
         adminCapIndex: 1,
       });
     }

package/src/vault.ts

@@ -21,6 +21,7 @@ import { normalizeStructTag } from "@mysten/sui/utils";
 import * as vault from "./contracts/vault/vault.ts";
 import * as compositionRoyaltyPool from "./contracts/composition_royalty_pool/composition_royalty_pool.ts";
 import * as recordingRoyaltyPool from "./contracts/recording_royalty_pool/recording_royalty_pool.ts";
+import * as partyWallet from "./contracts/party_wallet/party_wallet.ts";
 import * as compositionRoutedStake from "./contracts/composition_routed_stake/composition_routed_stake.ts";
 import * as releaseRevenueDistributor from "./contracts/release_revenue_distributor/release_revenue_distributor.ts";
 import * as routedStake from "./contracts/routed_stake/routed_stake.ts";
@@ -150,8 +151,8 @@ export interface CustodyNewAdminCapParams {
   readonly owner: string | TransactionArgument;
   /** Optional installation/configuration while the new Vault is still owned. */
   readonly configure?: (
-    vaultObject: TransactionArgument,
-    vaultAdminCapObject: TransactionArgument,
+    vaultObject: TransactionObjectArgument,
+    vaultAdminCapObject: TransactionObjectArgument,
   ) => void;
 }
 
@@ -360,6 +361,23 @@ export function installRecordingRoyaltyPoolPlugin(
   );
 }
 
+/** Install the Party wallet plugin; its canonical witness stays internal. */
+export function installPartyWalletPlugin(
+  tx: Transaction,
+  params: {
+    readonly vault: TransactionObjectArgument;
+    readonly vaultAdminCap: TransactionObjectArgument;
+    readonly pluginPackageId: string;
+  },
+): void {
+  tx.add(
+    partyWallet.install({
+      package: params.pluginPackageId,
+      arguments: [params.vault, params.vaultAdminCap],
+    }),
+  );
+}
+
 export function uninstallRecordingRoyaltyPoolPlugin(
   tx: Transaction,
   params: RecordingRoyaltyPoolPluginParams,