@misofm/platform 0.23.0 → 0.25.0

package/src/credits.ts

@@ -38,12 +38,12 @@ import type {
 } from "@mysten/sui/transactions";
 import type { TxThunk } from "./transactions.ts";
 import { OPTION_NONE, OPTION_SOME } from "./internal.ts";
-import * as compositionCredits from "@misofm/protocol/contracts/composition_credits/composition_credits";
-import * as compositionPartyRole from "@misofm/protocol/contracts/composition_credits/composition_party_role";
-import * as recordingCredits from "@misofm/protocol/contracts/recording_credits/recording_credits";
-import * as recordingPartyRole from "@misofm/protocol/contracts/recording_credits/recording_party_role";
-import * as releaseCredits from "@misofm/protocol/contracts/release_credits/release_credits";
-import * as releasePartyRole from "@misofm/protocol/contracts/release_credits/release_party_role";
+import * as compositionCredits from "./contracts/composition_credits/composition_credits.ts";
+import * as compositionPartyRole from "./contracts/composition_credits/composition_party_role.ts";
+import * as recordingCredits from "./contracts/recording_credits/recording_credits.ts";
+import * as recordingPartyRole from "./contracts/recording_credits/recording_party_role.ts";
+import * as releaseCredits from "./contracts/release_credits/release_credits.ts";
+import * as releasePartyRole from "./contracts/release_credits/release_party_role.ts";
 import { directAdminCap, invokeWithAdminCap, type AdminCapAuthority, type ObjectInput } from "./vault.ts";
 
 function object(tx: Transaction, value: ObjectInput): TransactionObjectArgument {

package/src/deployments.ts

@@ -1,11 +1,54 @@
 // Copyright (c) Miso Labs, Inc.
 // SPDX-License-Identifier: Apache-2.0
 
-import type { MisoDeployment, MisoNetwork } from "@misofm/protocol/deployments";
-import { MISO_DEPLOYMENTS } from "@misofm/protocol/deployments";
-import { normalizeSuiObjectId } from "@mysten/sui/utils";
+import type { MisoDeployment, MisoNetwork } from "@misofm/musicos/deployments";
+import { MISO_DEPLOYMENTS } from "@misofm/musicos/deployments";
+import type { PartyDeployment } from "@misofm/partyos/deployments";
+import { PARTYOS_DEPLOYMENTS } from "@misofm/partyos/deployments";
+import { normalizeSuiAddress, normalizeSuiObjectId } from "@mysten/sui/utils";
 import { immutableSnapshot } from "./internal.ts";
 
+/** Every package address a platform deployment must supply, for canonical-id
+ * and pairwise-distinctness validation in {@link assertMisoPlatformDeployment}. */
+const REQUIRED_PLATFORM_PACKAGE_KEYS = [
+  "minato",
+  "credit",
+  "compositionCredits",
+  "recordingCredits",
+  "releaseCredits",
+  "royaltyPool",
+  "routedStake",
+  "coverArt",
+  "releaseCoverArt",
+  "genre",
+  "releaseDescription",
+  "releaseDspLink",
+  "releaseGenre",
+  "releaseKind",
+  "recordingAdvisory",
+  "recordingLanguage",
+  "recordingMasterReference",
+  "ori",
+  "countryCode",
+  "languageCode",
+] as const;
+
+/** Every first-party Party extension package (the PartyOS core lives in `@misofm/partyos`). */
+const REQUIRED_PARTY_PACKAGE_KEYS = [
+  "partyCta",
+  "partyGenre",
+  "partyMedia",
+  "partyMusic",
+  "partyPlatformLink",
+  "partyProLink",
+  "partyProfile",
+  "partyRoles",
+  "partySocial",
+  "partyTags",
+  "countryCode",
+  "languageCode",
+] as const;
+
 /** Primary Record sales are unavailable on legacy deployments until both new
  * immutable packages have been freshly published and verified. */
 export type RecordSalesDeployment =
@@ -175,20 +218,48 @@ export function requireOperationsDeployment(
   ];
   if (new Set(identities).size !== identities.length) {
     throw new OperationsUnavailableError(
-      "the Vault registry object and all nine package IDs must be distinct",
+      `the Vault registry object and all ${packageEntries.length} package IDs must be distinct`,
     );
   }
   return deployment;
 }
 
+/**
+ * The first-party Party EXTENSION packages (profile, media, roles, tags,
+ * genres, CTAs, platform links). The Party object model core (`partyos`) is
+ * owned by `@misofm/partyos` — see {@link MisoPlatformDeployment.partyos}.
+ * Platform-internal: not re-exported by `@misofm/musicos`, which only ever
+ * knew the object-model core.
+ */
+export interface PartyExtensionsDeployment {
+  readonly partyCta: string;
+  readonly partyGenre: string;
+  readonly partyMedia: string;
+  readonly partyMusic: string;
+  readonly partyPlatformLink: string;
+  readonly partyProLink: string;
+  readonly partyProfile: string;
+  readonly partyRoles: string;
+  readonly partySocial: string;
+  readonly partyTags: string;
+  /** `country_code` — dependency of `party_profile`. */
+  readonly countryCode: string;
+  /** `language_code` — dependency of `party_profile` (and, via `packages`, `recording_language`). */
+  readonly languageCode: string;
+}
+
 /** Complete on-chain identity used by the Miso platform SDK on one network. */
 export interface MisoPlatformDeployment {
   /** Network name this immutable deployment set belongs to. */
   readonly network: MisoNetwork;
   /** Full ledger genesis digest used to reject a mislabeled RPC endpoint. */
   readonly chainIdentifier: string;
-  /** The complete protocol and Party deployment this platform build targets. */
+  /** The object-model deployment (`@misofm/musicos`) this platform build targets. */
   readonly protocol: MisoDeployment;
+  /** The Party object model deployment (`@misofm/partyos`) this platform build targets. */
+  readonly partyos: PartyDeployment;
+  /** The first-party Party extension packages. */
+  readonly party: PartyExtensionsDeployment;
   readonly recordSales: RecordSalesDeployment;
   /** Fail-closed, structurally complete Vault/Action/plugin identity set. */
   readonly operations: OperationsDeployment;
@@ -205,7 +276,7 @@ export interface MisoPlatformDeployment {
     /** Cover-art value type used by the release cover extension. */
     readonly coverArt: string;
     readonly releaseCoverArt: string;
-    /** Curated Genre vocabulary package used by release_genre. */
+    /** Curated Genre vocabulary package used by release_genre and recording_genre. */
     readonly genre: string;
     readonly releaseDescription: string;
     readonly releaseDspLink: string;
@@ -213,6 +284,8 @@ export interface MisoPlatformDeployment {
     readonly releaseKind: string;
     readonly recordingAdvisory: string;
     readonly recordingLanguage: string;
+    /** Ordered recording genre list (primary first). Optional until first published. */
+    readonly recordingGenre?: string;
     readonly recordingMasterReference: string;
     /** Complete Walrus Quilt containing the Recording's streaming transcodes. */
     readonly recordingStreamingTranscode?: string;
@@ -226,6 +299,10 @@ export interface MisoPlatformDeployment {
     readonly recordSealPolicy?: string;
     /** External `ori` package (`data::WalrusBlob`, `data::WalrusQuilt`) used by Walrus-backed extensions. */
     readonly ori: string;
+    /** `country_code` — dependency of `party_profile`. */
+    readonly countryCode: string;
+    /** `language_code` — dependency of `recording_language` (and, via `party`, `party_profile`). */
+    readonly languageCode: string;
   };
   readonly objects: {
     readonly releaseRegistry: string;
@@ -239,6 +316,110 @@ export interface MisoPlatformDeployment {
   };
 }
 
+export class MisoPlatformDeploymentInvalidError extends Error {
+  override readonly name = "MisoPlatformDeploymentInvalidError";
+}
+
+/**
+ * Validates the `packages` and `party` package-id sets before any Move target
+ * is constructed from them: every required id must be a canonical 32-byte Sui
+ * package ID, and no two of them (nor the core `musicos` package) may collide.
+ * Optional generation fields (`recordingGenre`, `recordingStreamingTranscode`,
+ * `recordingEngineSession`, `recordSealPolicy`) are validated only when present.
+ */
+export function assertMisoPlatformDeployment(
+  deployment: unknown,
+): asserts deployment is MisoPlatformDeployment {
+  if (!deployment || typeof deployment !== "object" || Array.isArray(deployment)) {
+    throw new MisoPlatformDeploymentInvalidError(
+      "@misofm/platform: deployment must be a complete MisoPlatformDeployment object.",
+    );
+  }
+  const candidate = deployment as Partial<MisoPlatformDeployment>;
+  const packages = candidate.packages as Partial<MisoPlatformDeployment["packages"]> | undefined;
+  const party = candidate.party as Partial<PartyExtensionsDeployment> | undefined;
+  const partyos = candidate.partyos as Partial<PartyDeployment> | undefined;
+  if (!packages || typeof packages !== "object") {
+    throw new MisoPlatformDeploymentInvalidError(
+      "@misofm/platform: deployment is missing its `packages` section.",
+    );
+  }
+  if (!party || typeof party !== "object") {
+    throw new MisoPlatformDeploymentInvalidError(
+      "@misofm/platform: deployment is missing its `party` section.",
+    );
+  }
+  if (!partyos || typeof partyos !== "object") {
+    throw new MisoPlatformDeploymentInvalidError(
+      "@misofm/platform: deployment is missing its `partyos` section.",
+    );
+  }
+
+  const seenPackageIds = new Set<string>();
+  /** `dedupeOk` lets `party.countryCode`/`party.languageCode` intentionally
+   * repeat `packages.countryCode`/`packages.languageCode` — both sections
+   * point the same shared dependency package at their own consumers — without
+   * tripping the distinctness check meant to catch a genuinely misconfigured
+   * manifest. */
+  const checkCanonical = (field: string, packageId: unknown, dedupeOk = false) => {
+    if (typeof packageId !== "string") {
+      throw new MisoPlatformDeploymentInvalidError(
+        `@misofm/platform: deployment is missing package ID for "${field}".`,
+      );
+    }
+    let normalized: string;
+    try {
+      normalized = normalizeSuiAddress(packageId);
+    } catch {
+      throw new MisoPlatformDeploymentInvalidError(
+        `@misofm/platform: deployment package ID for "${field}" is not a valid Sui address.`,
+      );
+    }
+    if (packageId !== normalized) {
+      throw new MisoPlatformDeploymentInvalidError(
+        `@misofm/platform: deployment package ID for "${field}" must be normalized (${normalized}).`,
+      );
+    }
+    if (!dedupeOk) {
+      if (seenPackageIds.has(packageId)) {
+        throw new MisoPlatformDeploymentInvalidError(
+          `@misofm/platform: deployment package ID for "${field}" duplicates another package. ` +
+            "Every package in a deployment manifest must have its own address.",
+        );
+      }
+      seenPackageIds.add(packageId);
+    }
+  };
+
+  for (const key of REQUIRED_PLATFORM_PACKAGE_KEYS) {
+    checkCanonical(`packages.${key}`, packages[key]);
+  }
+  checkCanonical("partyos.partyos", partyos.partyos);
+  for (const key of REQUIRED_PARTY_PACKAGE_KEYS) {
+    // `country_code`/`language_code` are shared dependency packages, deliberately
+    // repeated from `packages.*` above rather than distinct party-only ids.
+    checkCanonical(`party.${key}`, party[key], key === "countryCode" || key === "languageCode");
+  }
+  if (party.countryCode !== packages.countryCode) {
+    throw new MisoPlatformDeploymentInvalidError(
+      "@misofm/platform: party.countryCode must match packages.countryCode (the same shared dependency package).",
+    );
+  }
+  if (party.languageCode !== packages.languageCode) {
+    throw new MisoPlatformDeploymentInvalidError(
+      "@misofm/platform: party.languageCode must match packages.languageCode (the same shared dependency package).",
+    );
+  }
+}
+
+/** Validate and snapshot an untrusted manifest so later caller mutation is inert. */
+export function normalizeMisoPlatformDeployment(
+  deployment: unknown,
+): MisoPlatformDeployment {
+  assertMisoPlatformDeployment(deployment);
+  return immutableSnapshot(deployment);
+}
+
 /**
  * Platform deployments bundled with this SDK release.
  *
@@ -250,92 +431,125 @@ export const MISO_PLATFORM_DEPLOYMENTS = immutableSnapshot({
     network: "testnet",
     chainIdentifier: "69WiPg3DAQiwdxfncX6wYQ2siKwAe6L9BZthQea3JNMD",
     protocol: MISO_DEPLOYMENTS.testnet,
+    partyos: PARTYOS_DEPLOYMENTS.testnet,
     recordSales: {
       status: "available",
       recordPackageId:
-        "0xc9411d3e2cb9600081544572036bec049624db1707f9354c342090f440b6e1a2",
+        "0x8562a4c266b1229871551cec69c1a331f682920b9cad7685e42e7c6a5eba61d5",
       recordShopPackageId:
-        "0xc6d49266080b8f165b6c1fc48e1aa4a6d719183d78a8d1043bfe0f2d6c744ed1",
+        "0x5d1b79c312b5d2a2bc9aa0ce7ea6d41ecedd4a5d8698bc007000ca0c8a3459f9",
     },
     operations: {
       status: "available",
       vault: {
         packageId:
-          "0x77b74e9221874b9e29f6743a277810480bf89d71b5cb71741cd52dfcd83035d2",
+          "0xe7a5d1f895d7ca2571c2329a13a5703905d8903433b379db3aa987c7594a0198",
         registryId:
-          "0x0fcfe3bb47f0ee2fbf0dcb65b48741efd06b4d746f1df14fe6ac3c00e9e35287",
+          "0xebd40980edb30e425b80f7d65378246254cc5787e07d23faa46e6b9a2b9dd14d",
       },
       actions: {
         compositionRoyaltyPool:
-          "0x26c574e0aa01f504833b4f01dad44e2cd17b8718630e025d85ce05b843092085",
+          "0xa4655e8c1319655cbc0ad5da0d8bccbd528372fea2cb767235e89f2be6eb403c",
         recordingRoyaltyPool:
-          "0x84b3cc36907112da74c88c78d1ac20e17010a30e206dfa4322a300c87032d405",
+          "0xff510b24ddba7755dafeb3ceae65204ed6be058a83b482f98da92b3d19eefcd2",
         partyWallet:
-          "0xa3d6016f2da63b53546e3f9922e8f0c12c27ca532509ef8c0e778f3e7cd56ee6",
+          "0x493fa265fd7c8066cd80f644d22086fe36b2c8e26bd160d8a6f6f44743c42acc",
         compositionRoutedStake:
-          "0x8e32cdb08953afe0b72f46fde2b0fe1ab0ab3c12885c1e41883ccb5d8703e144",
+          "0xff5b7a4e1791210c36f2ea071a87e2e6212ddbe2acc922d324cf5436f8ca0b47",
         releaseRevenueDistributor:
-          "0x5ab255ed56c601c5d3c79502e81cfd4fd534c166fa731c2275a65d5fd2b34615",
+          "0x72b175f79cdb1df5d597cdb07007ac309994e6c3f99823b04400a48565dd3989",
       },
       plugins: {
         compositionRoyaltyPool:
-          "0x6969b98c0322a8a7ba2478d900fc88e1c9ba17903c310c7fdb133c0789bd5ba8",
+          "0x57b58eb53ade40a7e1e6e4be4bdd0fecdd57f709efe8021830b2e3519e800254",
         recordingRoyaltyPool:
-          "0x4ac310583eda99e148207f99618ce5d21d7e7680e7c92b58422113b155a97455",
+          "0x69c859aba359ca8fbeb1df4cff3de53cca3b4ce5ffaa1a7516bc9eb3e016cf71",
         releaseRevenueDistributor:
-          "0xf13e254b32cee1315d9c0af3c4ef6e3bb770c293eee90afe30a009cde30bb381",
+          "0x875a764569360ec7f4e676bcf5e30a50037229f33f2bae6d2acd205c0570e8b2",
       },
     },
     packages: {
       minato:
         "0xcdf58ed7e4580118a6a3f2a8077abffe633c551b2f19e95ce01685d42f90b8d9",
       credit:
-        "0xb82c6c2524ede481cfa3c1066c70c1e43b1a5f6f11e40d5633153c2c3150bba7",
+        "0xd77981b6872d975ccebeac1c639eebbcd1f7916f468df0242d4b26d9bf7293c1",
       compositionCredits:
-        "0x09434b8b65fb25a703b9c762abbb9075b5bfde6baffc923baac9353ab2191a65",
+        "0x924a5e87230cf1218be23484e4914d9c5515528c8ef032b1796ebdc71dd3830c",
       recordingCredits:
-        "0x598303437c97ab1ec232be884d041587f18647b71fb36f4cf76cbbcc3c276dd2",
+        "0x982d946a34bb342913c81441be1c702b29f2a83bc801c4fce9ed4f9d7833b8b1",
       releaseCredits:
-        "0xd6e9f090d581779099cc4beaf6c8843f1d569dea85fdde004748c8f03aadafcb",
+        "0xdc854106cb76733bb012db2369e0a39319fb79b0587e2a887814c7cb67134d77",
       royaltyPool:
-        "0xce4a1415255ac043301f3057b1dbd1095ad4959fcbe5bfceb9dbb7cf1144def1",
+        "0xf7be632d74f71574c2aa5ac2790a51e770b2cfbcf80233b875bdbe24ffe0b3b9",
       routedStake:
-        "0xaa37871d4ba3ce4a465c13c79d1a701941efbf33491633c744ad4b7035f7f894",
+        "0xfe3f0c0008823330d2e465a300b34eec50ab3c7444e655602ed2efc517c91824",
       coverArt:
-        "0x711f7041fc9e12d045b278c07ff9cf5047b69002e91e9dd881ad51c09ec389f6",
+        "0xc0b1421b32e287559ec29f6d7c71dd83778234cb62d4fe9d296577710411f6d4",
       releaseCoverArt:
-        "0xfb1dc55719142fb575c6242f338447fa87bf4618f6903c7a6e30489f4e810fb3",
+        "0x74c1708ff6016b5244f8d31559210ae6e5a2b5e52cb3c7996e1f630a7d4a87b2",
       genre:
-        "0x095c412a9e9846b091b8f93d9bd50bca5d98a2e65063cb6c20265dc307c4b319",
+        "0xeea93dd140ee2133d1baeeb71281846658b104d53403d4f89e75f65ade38f931",
       releaseDescription:
-        "0x957b633fd186f65f953e17caaeec2e3385431c6f55914cb31dfb775368f89d9e",
+        "0x8d59667b5e9476df33125153494246107a1384ecbea8862fa1b5c256588789fa",
       releaseDspLink:
-        "0x7bce4d548314d9cff3145732f19ad7e67b3c00e2cf4d6f295f8af6d02108884e",
+        "0xebcf0515a35c765ca89208162510bdddd2a9225866b9c66f33dc3cfa1e07bf8a",
       releaseGenre:
-        "0x9770bc7cf9d9b2fa35af194d14f0c36320fbf6541c5ee12b884f0db44d1b5a4f",
+        "0xc7269a52efa400b80009f8c9f7e31591a26c50c0ae925be31edaef8889e91c83",
       releaseKind:
-        "0x187f6f881623cc843d2c6dc98fe23203598fd3992b6a78c1b5990f3fd60a0f5b",
+        "0x48f1651e00572525fb2e59ebb37c5367d45258d62486984825c972a8ab2d0ce3",
       recordingAdvisory:
-        "0x8f745dac70fef5327e686b31acbe3f3504dc7eeb63da5f31a4660bb5aea5ee4b",
+        "0x4149faba212e3aca5440e5ea15bde535dca453f2701125a996d89188b0000ed0",
       recordingLanguage:
-        "0xd6b7f206f838018a28d33b77bade2b8476ccafab5fe526345c375d3b47bb892f",
+        "0x78e48de29be0b9dca4921dd0740cc12c88cb02599ee8554854b4e423a689fd19",
+      recordingGenre:
+        "0x3c017256c66c7d48f4c23ae40dd6d5a0470a4f85a750aadef388ef9ac8e71b36",
       recordingMasterReference:
-        "0x65309bf315f3e035b0f10c706eb5c327af5038be1637a0cee74f4ae62872f6ce",
+        "0x2638edd3c9fec5650eda561e77fb390add0110088ad54c470e83ea079108bb1a",
       // Stems generation (Session V1 blob + Stem { digest, data } vector).
       // 0x2fcb9ab9… was the retired single-blob generation.
       recordingEngineSession:
-        "0x0ec0227854f418a6accfbdcca5d41fd22b6906f5034c8ea1545dfe42a2a7f020",
+        "0xa3057f47e31683c1eba0afba56aa38af6734f6b9fc3fb679c2681a21ccfe3c24",
       recordingStreamingTranscode:
-        "0x622cd2a9e49ee2639f5c1d922d2fc75e89e810e80da8dd6d4a843bcefa0aacb0",
+        "0x67bde09257865521b221aebf83bc95e5a9ae9d38f2c77223772436bc9c70e8ec",
       recordSealPolicy:
-        "0x2b806033f31ed0af5a9118429111dd5c91f44d9229c41aa9d5cbaec7e3910c0a",
+        "0x7e1921715dbda4fbb73227d0764f4c0de55fdcf3892ddadc4ef1bf895453b2a2",
       ori: "0x51792b9adb9a5d05d7c4d74d7d0cb5aefc5639afa80c0089399cab8b99752e60",
+      countryCode:
+        "0x69fb214a74d5253971a45b2d07f83f13ae96992dd38198d7bacb21e1f5fb5f81",
+      languageCode:
+        "0xac318126565a2fab608984a091b3582ba9cda6c32232f567eef50277c5042c36",
+    },
+    party: {
+      partyCta:
+        "0x310bd64b4d32b547ad52128df9839702a3b74e144e920d04d00bb2bd488b2036",
+      partyGenre:
+        "0x6b66b793a13c899e41d812a3feccafc9078184f0bd74c4af474d23ef7fd35ec5",
+      partyMedia:
+        "0xb4479afae1f14c4cf7064908c29ccf698b5e10f2e48a31d63f861131476594c5",
+      partyMusic:
+        "0xe583826d1610a252769eddb4fa81e81040d40468fc99eec4bf72c52456ff7f79",
+      partyPlatformLink:
+        "0xe0990445758d27732928759a33e73bcddd2b06604dc0c552b958b6b0220b060b",
+      partyProLink:
+        "0xdbf8f3d1d12cf15e435d74bfb910e88eae7094064176661a85bc79a76e6ce674",
+      partyProfile:
+        "0x0cb11099892f9a583077408369a1d838ec888660ed31af7f7bd52a3794f147a6",
+      partyRoles:
+        "0x53227d2c8c36b6bae17e2cdfaff50cf7e52261c40cbda65a11fe9f9486cc6104",
+      partySocial:
+        "0xb691711983ad484e8caecc3091872a163a4cf6f93bfab3d3974ad94bb4b63d2f",
+      partyTags:
+        "0xcc0a53bfa1310758c02607a9ee95fa1553ef3d9431e3df25f38a16e09c3466c5",
+      countryCode:
+        "0x69fb214a74d5253971a45b2d07f83f13ae96992dd38198d7bacb21e1f5fb5f81",
+      languageCode:
+        "0xac318126565a2fab608984a091b3582ba9cda6c32232f567eef50277c5042c36",
     },
     objects: {
       releaseRegistry:
-        "0x40700d8fd9de26392d10c4a3c0759b08f60be43e2f80681650e87a4efdac5cf1",
+        "0xb0506d287b50a134a2773a5d4e0c9c4e3ef4aa3806cad6ff93d8b28be063c6df",
       genreRegistry:
-        "0x479a1f43c8118b24d10cba62d64ad782c19fad974cdbc5020c909ea943c857a8",
+        "0x9a5a7ce36906a0581e6e38a0dd6abc24093acc6ffd7c0d6a7f419c57b069d00e",
     },
     legacy: {
       releaseCoverArtPackages: [],

package/src/events.ts

@@ -0,0 +1,121 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+/**
+ * BCS decoders for extension and generic-primitive execution events. Core
+ * object-model events (release registry creation, …) decode through
+ * `@misofm/musicos`'s own `eventParsers`; this module covers everything Miso
+ * layers on top: work extensions, and the royalty-pool / routed-stake
+ * primitives. Each decoder preserves the generated Move field names and
+ * nested layouts exactly, which is the safe indexer boundary for
+ * independently versioned extension packages.
+ */
+
+import { decodeEvent } from "@misofm/musicos/events";
+import type { BcsParser } from "@misofm/musicos/queries";
+
+import * as compositionCredits from "./contracts/composition_credits/composition_credits.ts";
+import * as recordingAdvisory from "./contracts/recording_advisory/recording_advisory.ts";
+import * as recordingCredits from "./contracts/recording_credits/recording_credits.ts";
+import * as recordingGenre from "./contracts/recording_genre/recording_genre.ts";
+import * as recordingLanguage from "./contracts/recording_language/recording_language.ts";
+import * as recordingMasterReference from "./contracts/recording_master_reference/recording_master_reference.ts";
+import * as releaseCoverArt from "./contracts/release_cover_art/release_cover_art.ts";
+import * as releaseCredits from "./contracts/release_credits/release_credits.ts";
+import * as releaseDescription from "./contracts/release_description/release_description.ts";
+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 * as royaltyPool from "./contracts/royalty_pool/pool.ts";
+import * as royaltyStake from "./contracts/royalty_pool/stake.ts";
+import * as routedStake from "./contracts/routed_stake/routed_stake.ts";
+
+function decoder<T>(codec: BcsParser<T>) {
+  return (bytes: Uint8Array): T => decodeEvent(codec, bytes);
+}
+
+/**
+ * Platform event decoder registry, grouped by package responsibility:
+ * `extensions` (work extensions) and `primitives` (royalty pool / routed
+ * stake). Merge with `@misofm/musicos`'s `eventParsers.core` at the call site
+ * when a single indexer needs both.
+ */
+export const platformEventParsers = {
+  extensions: {
+    compositionCredits: {
+      creditAdded: decoder(compositionCredits.CreditAddedEvent),
+      creditRemoved: decoder(compositionCredits.CreditRemovedEvent),
+    },
+    recordingAdvisory: {
+      ratingSet: decoder(recordingAdvisory.AdvisoryRatingSetEvent),
+      ratingUnset: decoder(recordingAdvisory.AdvisoryRatingUnsetEvent),
+    },
+    recordingCredits: {
+      creditAdded: decoder(recordingCredits.CreditAddedEvent),
+      creditRemoved: decoder(recordingCredits.CreditRemovedEvent),
+      primaryArtistAdded: decoder(recordingCredits.PrimaryArtistAddedEvent),
+      primaryArtistRemoved: decoder(recordingCredits.PrimaryArtistRemovedEvent),
+      featuredArtistAdded: decoder(recordingCredits.FeaturedArtistAddedEvent),
+      featuredArtistRemoved: decoder(recordingCredits.FeaturedArtistRemovedEvent),
+    },
+    recordingGenre: {
+      genreAdded: decoder(recordingGenre.GenreAddedEvent),
+      genreRemoved: decoder(recordingGenre.GenreRemovedEvent),
+      genresCleared: decoder(recordingGenre.GenresClearedEvent),
+    },
+    recordingLanguage: {
+      languagesSet: decoder(recordingLanguage.LanguagesSetEvent),
+      languagesUnset: decoder(recordingLanguage.LanguagesUnsetEvent),
+    },
+    recordingMasterReference: {
+      masterReferenceSet: decoder(recordingMasterReference.MasterReferenceSetEvent),
+      masterReferenceUnset: decoder(recordingMasterReference.MasterReferenceUnsetEvent),
+    },
+    releaseCoverArt: {
+      coverSet: decoder(releaseCoverArt.CoverSetEvent),
+      coverUnset: decoder(releaseCoverArt.CoverUnsetEvent),
+      trackCoverSet: decoder(releaseCoverArt.TrackCoverSetEvent),
+      trackCoverUnset: decoder(releaseCoverArt.TrackCoverUnsetEvent),
+    },
+    releaseCredits: {
+      creditAdded: decoder(releaseCredits.CreditAddedEvent),
+      creditRemoved: decoder(releaseCredits.CreditRemovedEvent),
+    },
+    releaseDescription: {
+      descriptionSet: decoder(releaseDescription.DescriptionSetEvent),
+      descriptionCleared: decoder(releaseDescription.DescriptionClearedEvent),
+    },
+    releaseDspLink: {
+      releaseLinkSet: decoder(releaseDspLink.ReleaseLinkSetEvent),
+      releaseLinkCleared: decoder(releaseDspLink.ReleaseLinkClearedEvent),
+      trackLinkSet: decoder(releaseDspLink.TrackLinkSetEvent),
+      trackLinksCleared: decoder(releaseDspLink.TrackLinksClearedEvent),
+    },
+    releaseGenre: {
+      genreAdded: decoder(releaseGenre.GenreAddedEvent),
+      genreRemoved: decoder(releaseGenre.GenreRemovedEvent),
+      genresCleared: decoder(releaseGenre.GenresClearedEvent),
+    },
+    releaseKind: {
+      kindSet: decoder(releaseKind.KindSetEvent),
+      kindUnset: decoder(releaseKind.KindUnsetEvent),
+    },
+  },
+  primitives: {
+    royaltyPool: {
+      poolCreated: decoder(royaltyPool.RoyaltyPoolCreatedEvent),
+      deposited: decoder(royaltyPool.RoyaltyDepositedEvent),
+      stakeRegistered: decoder(royaltyPool.StakeRegisteredEvent),
+      stakeUnregistered: decoder(royaltyPool.StakeUnregisteredEvent),
+      royaltyClaimed: decoder(royaltyPool.RoyaltyClaimedEvent),
+      stakeCreated: decoder(royaltyStake.StakeCreatedEvent),
+      stakeDestroyed: decoder(royaltyStake.StakeDestroyedEvent),
+    },
+    routedStake: {
+      created: decoder(routedStake.RoutedStakeCreatedEvent),
+      swept: decoder(routedStake.RoutedStakeSweptEvent),
+      unstaked: decoder(routedStake.RoutedStakeUnstakedEvent),
+      restaked: decoder(routedStake.RoutedStakeRestakedEvent),
+    },
+  },
+} as const;

package/src/execute.ts

@@ -5,18 +5,18 @@
 // to this package's opinionated publish flows (batched, non-idempotent share-
 // currency publishing in `share.ts`). Everything else — `buildTx`,
 // `signAndExecute`, `toExecResult`, the object-change extractors — is generic
-// PTB execution plumbing that stays in `@misofm/protocol`'s `execute.ts` and is
+// PTB execution plumbing that stays in `@misofm/musicos`'s `execute.ts` and is
 // re-exported from there; this module builds on top of it.
 
 import type { ParallelTransactionExecutor } from "@mysten/sui/transactions";
 import type { SuiClientTypes } from "@mysten/sui/client";
-import { buildTx, toExecResult, FULL_INCLUDE, type ExecResult } from "@misofm/protocol";
+import { buildTx, toExecResult, FULL_INCLUDE, type ExecResult } from "@misofm/musicos";
 import type { TxThunk } from "./transactions.ts";
 
 // Consumers of the platform SDK should not need a second direct dependency on
 // the protocol SDK just to execute a composed PTB. Keep the generic execution
 // surface available through this platform-layer entry point as well.
-export * from "@misofm/protocol/execute";
+export * from "@misofm/musicos/execute";
 
 /** Publication execution also needs lifecycle events to associate same-typed
  * objects (notably several new Parties and Vaults) with their manifest refs. */