@misofm/sdk 0.6.0 → 0.7.1

package/src/credits.ts

@@ -605,9 +605,7 @@ const RELEASE_CREDITS_KEY_BYTES = releaseCredits.ExtensionKey.serialize([
 
 type CreditFieldKind =
   | "composition"
-  | "compositionLegacy"
   | "recording"
-  | "recordingLegacy"
   | "release";
 
 interface CreditFieldTarget {
@@ -616,13 +614,7 @@ interface CreditFieldTarget {
   fieldId: string;
 }
 
-/**
- * Fetch many derived credit fields through one Core bulk request.
- *
- * Composition and recording extensions have one legacy key spelling. Both IDs
- * ride in the same request, so fallback compatibility does not add a sequential
- * round trip when the current key is absent.
- */
+/** Fetch many derived credit fields through one Core bulk request. */
 async function fetchCreditFields(
   client: ClientWithCoreApi,
   targets: readonly CreditFieldTarget[],
@@ -645,52 +637,30 @@ function compositionCreditTargets(
   compositionIds: readonly string[],
   packageId: string,
 ): CreditFieldTarget[] {
-  return compositionIds.flatMap((workId) => [
-    {
-      workId,
-      kind: "composition" as const,
-      fieldId: deriveDynamicFieldID(
-        workId,
-        `${packageId}::composition_credits::ExtensionKey`,
-        COMPOSITION_CREDITS_KEY_BYTES,
-      ),
-    },
-    {
+  return compositionIds.map((workId) => ({
+    workId,
+    kind: "composition" as const,
+    fieldId: deriveDynamicFieldID(
       workId,
-      kind: "compositionLegacy" as const,
-      fieldId: deriveDynamicFieldID(
-        workId,
-        `${packageId}::composition_credits::CompositionCreditsKey`,
-        COMPOSITION_CREDITS_KEY_BYTES,
-      ),
-    },
-  ]);
+      `${packageId}::composition_credits::ExtensionKey`,
+      COMPOSITION_CREDITS_KEY_BYTES,
+    ),
+  }));
 }
 
 function recordingCreditTargets(
   recordingIds: readonly string[],
   packageId: string,
 ): CreditFieldTarget[] {
-  return recordingIds.flatMap((workId) => [
-    {
-      workId,
-      kind: "recording" as const,
-      fieldId: deriveDynamicFieldID(
-        workId,
-        `${packageId}::recording_credits::ExtensionKey`,
-        RECORDING_CREDITS_KEY_BYTES,
-      ),
-    },
-    {
+  return recordingIds.map((workId) => ({
+    workId,
+    kind: "recording" as const,
+    fieldId: deriveDynamicFieldID(
       workId,
-      kind: "recordingLegacy" as const,
-      fieldId: deriveDynamicFieldID(
-        workId,
-        `${packageId}::recording_credits::RecordingCreditsKey`,
-        RECORDING_CREDITS_KEY_BYTES,
-      ),
-    },
-  ]);
+      `${packageId}::recording_credits::ExtensionKey`,
+      RECORDING_CREDITS_KEY_BYTES,
+    ),
+  }));
 }
 
 function releaseCreditTargets(
@@ -825,15 +795,10 @@ export async function getCompositionCreditsByIds(
   );
   const contents = await fetchCreditFields(client, targets);
   const out: Partial<Record<string, CreditView[]>> = {};
-  for (const compositionId of compositionIds) {
-    const candidates = targets.filter(
-      (target) => target.workId === compositionId,
-    );
-    const content = candidates
-      .map((target) => contents.get(target.fieldId))
-      .find((value): value is Uint8Array => value !== undefined);
+  for (const target of targets) {
+    const content = contents.get(target.fieldId);
     if (content) {
-      out[compositionId] = creditViews(
+      out[target.workId] = creditViews(
         CompositionCreditsField.parse(content).value.credits,
         compositionRoleLabel,
       );
@@ -875,16 +840,11 @@ export async function getRecordingCreditsByIds(
   );
   const contents = await fetchCreditFields(client, targets);
   const out: Partial<Record<string, RecordingCreditsView>> = {};
-  for (const recordingId of recordingIds) {
-    const candidates = targets.filter(
-      (target) => target.workId === recordingId,
-    );
-    const content = candidates
-      .map((target) => contents.get(target.fieldId))
-      .find((value): value is Uint8Array => value !== undefined);
+  for (const target of targets) {
+    const content = contents.get(target.fieldId);
     if (!content) continue;
     const value = RecordingCreditsField.parse(content).value;
-    out[recordingId] = {
+    out[target.workId] = {
       credits: creditViews(value.credits, recordingRoleLabel),
       primaryArtistIds: value.primary_artist_ids.contents,
       featuredArtistIds: value.featured_artist_ids.contents,

package/src/index.ts

@@ -14,7 +14,9 @@
 //
 // A release is protocol. Pressing a record off it and selling that record is
 // platform. Keeping the split at the package boundary is what stops the protocol
-// from quietly growing a storefront.
+// from quietly growing a storefront. Core's `release::new` is the sole practical
+// exception: it needs `&mut UID`, which cannot cross a PTB command boundary, so
+// the platform's `release_registry` extension owns the PTB-callable minting path.
 //
 // Extensions live on this side of the line for the same reason. An extension is
 // not part of what a Composition or Recording IS — it is a choice Miso makes

package/src/read/catalog.ts

@@ -161,24 +161,16 @@ function toTracks(
 
 // ── Cover ────────────────────────────────────────────────────────────────────
 
-/**
- * A release's cover, trying the current `release_cover_art` package and then each
- * legacy one in turn.
- *
- * Covers set before the cover_art package split live under a different
- * `CoverArtKey` TYPE (different package address), so a current-package read
- * simply misses them rather than failing. Ported verbatim from miso-app's
- * `lib/pressing.ts:readReleaseCover`.
- */
+/** A release's cover from the configured `release_cover_art` package. */
 export async function readReleaseCover(
   client: MisoClient,
   releaseId: string,
 ): Promise<Cover | null> {
-  const { releaseCoverArt, legacyReleaseCoverArt } = client.config.protocol;
+  const { releaseCoverArt } = client.config.protocol;
   const covers = await getReleaseCoversByIds(
     client.protocol,
     [releaseId],
-    [releaseCoverArt, ...legacyReleaseCoverArt],
+    releaseCoverArt,
   ).catch(() => ({}) as Partial<Record<string, ReleaseCoverView>>);
   return toCover(client.config.walrusAggregatorUrl, covers[releaseId] ?? null);
 }
@@ -203,15 +195,9 @@ export async function getReleaseResources(
 ): Promise<ReleaseResources> {
   const wantsCover = include.includes("cover");
   const wantsCredits = include.includes("credits");
-  const coverPackages = wantsCover
-    ? [
-        client.config.protocol.releaseCoverArt,
-        ...client.config.protocol.legacyReleaseCoverArt,
-      ]
+  const coverFieldIds = wantsCover
+    ? [releaseCoverFieldId(releaseId, client.config.protocol.releaseCoverArt)]
     : [];
-  const coverFieldIds = coverPackages.map((packageId) =>
-    releaseCoverFieldId(releaseId, packageId),
-  );
   const creditsFieldId = wantsCredits
     ? releaseCreditsFieldId(releaseId, client.config.protocol.releaseCredits)
     : null;
@@ -222,7 +208,7 @@ export async function getReleaseResources(
   ];
   const { objects } = await client.protocol.core.getObjects({
     objectIds,
-    include: { content: true, json: true },
+    include: { content: true },
   });
   const releaseObject = objects[0];
   if (!releaseObject) throw new Error(`Release not found: ${releaseId}`);
@@ -232,7 +218,6 @@ export async function getReleaseResources(
   const release = parseReleaseObject(
     releaseObject.objectId,
     releaseObject.content,
-    releaseObject.json,
   );
 
   let cover: Cover | null | undefined;
@@ -440,10 +425,7 @@ export async function getDiscoverShelf(
 
   const [releases, coverViews, credits] = await Promise.all([
     getReleasesByIds(client.protocol, releaseIds),
-    getReleaseCoversByIds(client.protocol, releaseIds, [
-      client.config.protocol.releaseCoverArt,
-      ...client.config.protocol.legacyReleaseCoverArt,
-    ]).catch(() => ({}) as Partial<Record<string, ReleaseCoverView>>),
+    getReleaseCoversByIds(client.protocol, releaseIds, client.config.protocol.releaseCoverArt).catch(() => ({}) as Partial<Record<string, ReleaseCoverView>>),
     getReleaseCreditsByIds(
       client.protocol,
       releaseIds,
@@ -476,9 +458,7 @@ export async function getDiscoverShelf(
 // ── Record → release ─────────────────────────────────────────────────────────
 
 /**
- * A record's parent release. Both live `Record` struct layouts expose it — card
- * checkout's `{ release_id, number }` and the SDK view's
- * `{ release_id, edition, variant }` — so we probe both spellings.
+ * A record's parent release. Fresh `Record` objects expose `release_id`.
  *
  * This answer is IMMUTABLE for the life of the record, which is what lets the
  * endpoint in front of it cache for a year.
@@ -500,7 +480,7 @@ export async function getRecordAlbum(
       include: { json: true },
     });
     const json = (object?.json ?? {}) as Record<string, unknown>;
-    const raw = json.release_id ?? json.releaseId;
+    const raw = json.release_id;
     const releaseId = typeof raw === "string" && raw ? raw : null;
     const includeRelease =
       options.include?.some(

package/src/read/config.ts

@@ -7,9 +7,8 @@
 // `lib/money.ts`, `lib/drops.ts`) lives here instead, so a redeploy is a change
 // in ONE file that every surface picks up.
 //
-// Testnet values are the deployed ones (verified against chain 2026-08-09).
-// Mainnet is deliberately EMPTY: `misoConfig("mainnet")` throws rather than
-// silently reading testnet ids on a mainnet deployment.
+// Both networks stay unavailable until the fresh protocol publish is configured;
+// pre-launch has no compatibility lane for the old deployment.
 
 export type Network = "testnet" | "mainnet";
 
@@ -24,17 +23,12 @@ export interface ProtocolIds {
   miso: string;
   /** `miso_drop` — `drop::buy` and the `Drop` objects the pressing pages read. */
   drop: string;
+  /** `miso_record` package — the exact owner/type namespace for `record::Record`. */
+  record: string;
   /** `miso_record` shared `Settings` object — the mint witness authorizer. */
   recordSettings: string;
-  /** `release_cover_art` — the release cover extension currently written to. */
+  /** `release_cover_art` — the release cover extension. */
   releaseCoverArt: string;
-  /**
-   * Cover-art packages from before the `cover_art` package split. A cover set
-   * under one of these is invisible to a current-package read, so cover reads
-   * fall back through this list in order. Drop an entry once every cover it
-   * holds has been re-set under `releaseCoverArt`.
-   */
-  legacyReleaseCoverArt: readonly string[];
   /** `composition_credits` / `recording_credits` / `release_credits` extensions. */
   compositionCredits: string;
   recordingCredits: string;
@@ -94,51 +88,17 @@ export interface MisoConfig {
   discoverReleaseIds: readonly string[];
 }
 
-const TESTNET: MisoConfig = {
-  network: "testnet",
-  protocol: {
-    miso: "0x648c9dfba8c800ebd5e608599551f51e1a157942e29d59a1c35e14c44367acf0",
-    drop: "0xfc2b51f068dee9d5482d39fa017164f6a8c3601cabb59084a518de5f609ef1c7",
-    recordSettings: "0xadf53b5be0d9eea43712b0c73d0ce55d1fb990ba06e35e12a9a371b2dfe3fd35",
-    releaseCoverArt: "0x1ee2cae0da7595d7973c310c912434ef531589b468cc57839296810c1385f7f6",
-    legacyReleaseCoverArt: ["0x7d4a205a68f8e768a408c9f4c45a4d4076722c5edeba9068c0ac058f554e964e"],
-    compositionCredits: "0x25ba72b5737cac577ca8c92d0f1962efbe5d688a1088cfdc580740605086b366",
-    recordingCredits: "0xd272b1960e5fae15ae2a5425b910a96619727c85acd0c0095b6089531fdb32a9",
-    releaseCredits: "0xed764634b9c9a6af04e3c7f60f657c8e2129baf9b43fb9aee6f3523a423228e4",
-    credit: "0x96c82da135bbd534850ca0a2445fdd2531dd4e0947ffa14645a2eb6636d83646",
-  },
-  party: {
-    partyPackageId: "0xd1c0253f837c57bd0a572673a28374e32c118059356e0c9db26784897175197e",
-    partyProfilePackageId: "0x6f8841bb252d3ba0f59f9027546be7a0e0a59d84757214df216eb14ef8a9719e",
-    countryCodePackageId: "0x6c3a53f228ccd089825d0fb5ee1f0465a4b7a438bc1b1735b4e2f01df8d056e9",
-    languageCodePackageId: "0xa18b786807cfc45488691f93aa647800b77cf9993e420d110afd7024c5b15948",
-    partyMediaPackageId: "0xc04dbdc05076f642fa8dc79257de9d45ee71fc8fee4a4fe1c05c6bb27e8982ee",
-    partyRolesPackageId: "0x18e6d59fe3a6496bd42273fd97e6e4b0ae7d3a8a876a6bbe4f6ae1b6057a6f38",
-    partyTagsPackageId: "0x5a5ed50aac1146b34490949ab33fd29dc2ba13ddf1b8f90b4797e67e1301609d",
-    partyGenrePackageId: "0x2d489291ce41392ae887e2e048f752a9bd6bea9f540b2c3d2356e36f0e624e29",
-    partyCtaPackageId: "0xbf4b04afa5b9c87b7385c6a1f116165a6e3f9bed3e16ea064fed7be4da14db7f",
-    partyPlatformLinkPackageId: "0x2bf95053493e640e3641abef2a9d6080ac563da62a5ca8e878e6d3459fdf27c8",
-    partySocialPackageId: "0x24bdc5f4cdf68d5cbd6f2b4b791f8b0311060a7fac7e54c10d3a101aa7d6b56d",
-    partyMusicPackageId: "0x40d8c48aa7cd8ade4ccfc7eb68de958403b08a897589934c191993b25961c453",
-    partyProLinkPackageId: "0xe2f0160eeac627378538b82209c2cd58b6a73827dae46f5f92368a6c7e84ee8d",
-    partyFeaturedDropPackageId: "0x5205a9f88702ed2dadd95e4d0096c691a40c96d8bb05d77127f1a62a6eb72cf7",
-    genrePackageId: "0x7ee69a2f1440152ecdacad997364fb28fe1fc140fd720e4c6d37ad78e29a376d",
-  },
-  money: {
-    usdCoinType: "0x77774cb7b8cb5622b4ef2658101bf5f1e965418297fe874b683df8f760b6e749::fakeusd::FakeUsd",
-    usdDecimals: 6,
-  },
-  grpcUrl: "https://fullnode.testnet.sui.io",
-  graphqlUrl: "https://graphql.testnet.sui.io/graphql",
-  walrusAggregatorUrl: "https://aggregator.walrus-testnet.walrus.space",
-  apiBaseUrl: "https://api.testnet.miso.fm",
-  discoverReleaseIds: [
-    // AMIANGELIKA — BLCK SUN
-    "0xa16e7ef7af5104690117321c749995db1164db668a5559cf6a0706b26141c327",
-    // Gateway Girl — Between the Doors
-    "0x7144600de3bb037f23b9371a2bcd5c0d84a80abc381a9d03b00ff7e03f412623",
-  ],
-};
+// TODO(publish): replace this guard with a fresh `TESTNET: MisoConfig` after
+// republishing every protocol package. Set every `protocol` package/object id
+// from that publish; do not reuse any id from the retired deployment.
+// TODO(publish): set `protocol.record` to the fresh `miso_record` package id;
+// it is distinct from the `protocol.recordSettings` shared object id.
+// TODO(publish): at the `ProtocolIds` declaration above, add `releaseRegistry`
+// and `releaseRegistryId`; set the latter from
+// `ReleaseRegistryCreatedEvent.registry_id` in the release_registry publish tx.
+// TODO(publish): recreate Discover content under the fresh packages, then add
+// only those release ids to `discoverReleaseIds`.
+const TESTNET: MisoConfig | null = null;
 
 /** Fields a deployment may override without forking the whole config (endpoints, shelf). */
 export type MisoConfigOverrides = Partial<
@@ -150,9 +110,9 @@ export type MisoConfigOverrides = Partial<
  * filled in here — a mainnet worker must fail loudly, never read testnet ids.
  */
 export function misoConfig(network: Network, overrides: MisoConfigOverrides = {}): MisoConfig {
-  if (network === "mainnet") {
+  if (network === "mainnet" || !TESTNET) {
     throw new Error(
-      "@misofm/sdk/read: no mainnet configuration yet. Deploy the Move packages, then fill in the mainnet block in src/read/config.ts.",
+      "@misofm/sdk/read: no fresh deployment configuration yet. Publish the protocol packages, then fill in src/read/config.ts.",
     );
   }
   return { ...TESTNET, ...stripUndefined(overrides) };

package/src/read/index.ts

@@ -59,7 +59,6 @@ export type { ArtistInclude, GetArtistOptions } from "./artist.ts";
 export { resolveGenreNames } from "./genres.ts";
 
 export {
-  RECORD_TYPE_SUFFIX,
   getBalance,
   getOwnedParties,
   getPendingMemberships,

package/src/read/types.ts

@@ -270,7 +270,7 @@ export interface PartySummary {
 export interface OwnedRecord {
   /** Canonical object id — the `recordId` route param. */
   id: string;
-  /** Full on-chain type, e.g. `0xfc2b51…::record::Record`. */
+  /** Full on-chain type, e.g. `<miso_record>::record::Record`. */
   type: string;
   releaseId: string | null;
   /** Copy / edition number, when the struct exposes one. */

package/src/read/wallet.ts

@@ -32,9 +32,6 @@ import type {
 } from "./types.ts";
 import { getRecordingTitles, getWorkAddressesByShareTypes, getWorksByIds } from "./works.ts";
 
-/** The on-chain type suffix every record object shares, across both live packages. */
-export const RECORD_TYPE_SUFFIX = "::record::Record";
-
 /**
  * Page cap on the owned-objects scan, so a wallet holding a huge unrelated object
  * set can't spin forever. 50/page × 20 = 1000 objects — far beyond any realistic
@@ -52,53 +49,29 @@ function coerceNumber(v: unknown): number | null {
 }
 
 /**
- * This copy's number in its run, across both record struct layouts: card
- * checkout's `{ release_id, number }` and the SDK view's
- * `{ release_id, edition, variant: { Prototype|Production: { number } } }`.
- * The gRPC JSON enum shape varies by transport, so this probes defensively.
- *
- * Precedence is MOST SPECIFIC FIRST — a top-level `number`, then the variant's
- * `number`, and only then `edition`. miso-app's original
- * (`lib/records.ts:readRecordNumber`) checked `edition` before descending into
- * the variant, so an SDK-view record reported which EDITION it came from (2)
- * where the field means which COPY it is (12). `edition` survives as the last
- * resort for a layout that carries nothing better.
+ * This copy's number in its run. Fresh records expose the canonical
+ * `{ release_id, number }` shape; pre-publish layouts are intentionally not
+ * accepted by the pre-launch SDK.
  */
 function readRecordNumber(json: Record<string, unknown>): number | null {
-  const direct = coerceNumber(json.number);
-  if (direct != null) return direct;
-
-  const variant = json.variant;
-  if (variant && typeof variant === "object") {
-    const v = variant as Record<string, unknown>;
-    const top = coerceNumber(v.number);
-    if (top != null) return top;
-    for (const inner of Object.values(v)) {
-      if (inner && typeof inner === "object") {
-        const n = coerceNumber((inner as Record<string, unknown>).number);
-        if (n != null) return n;
-      }
-    }
-  }
-  return coerceNumber(json.edition);
+  return coerceNumber(json.number);
 }
 
 function readReleaseId(json: Record<string, unknown>): string | null {
-  const r = json.release_id ?? json.releaseId;
+  const r = json.release_id;
   return typeof r === "string" && r ? r : null;
 }
 
 /**
  * The records `owner` holds. Ownership is DIRECT — a record is an address-owned
- * `<pkg>::record::Record` with no pressing/license/receipt intermediary.
- *
- * There is deliberately no `type` filter on the listing: two record packages are
- * live, so we match the `::record::Record` SUFFIX client-side and catch both with
- * no package-id config. Objects that fail to parse are skipped, never thrown.
+ * `<miso_record>::record::Record` with no pressing/license/receipt intermediary.
+ * The server-side type filter and exact local check deliberately exclude records
+ * from any retired package namespace.
  */
 export async function getOwnedRecords(client: MisoClient, owner: string): Promise<OwnedRecord[]> {
   const out: OwnedRecord[] = [];
   let cursor: string | null = null;
+  const recordType = `${client.config.protocol.record}::record::Record`;
 
   for (let page = 0; page < MAX_PAGES; page++) {
     // Annotated: `cursor` is both an input and assigned from the result, which
@@ -106,12 +79,13 @@ export async function getOwnedRecords(client: MisoClient, owner: string): Promis
     const res: Awaited<ReturnType<typeof client.protocol.core.listOwnedObjects>> =
       await client.protocol.core.listOwnedObjects({
         owner,
+        type: recordType,
         cursor,
         limit: 50,
         include: { json: true },
       });
     for (const obj of res.objects) {
-      if (!obj.type || !obj.type.endsWith(RECORD_TYPE_SUFFIX)) continue;
+      if (obj.type !== recordType) continue;
       const json = (obj.json ?? {}) as Record<string, unknown>;
       out.push({
         id: obj.objectId,

package/src/read/works.ts

@@ -179,31 +179,7 @@ function parseRecording(id: string, content: Uint8Array): Recording {
 export function parseReleaseObject(
   id: string,
   content: Uint8Array,
-  json: unknown,
 ): Release {
-  const deployed = json as {
-    discs?: Parsed[];
-    state?: Parsed;
-    title?: unknown;
-  } | null;
-  if (deployed?.discs) {
-    const tracks = deployed.discs.flatMap((disc) => disc.tracks ?? []);
-    const publishedAt =
-      deployed.state?.["@variant"] === "Published" ? deployed.state.pos0 : null;
-    return {
-      id,
-      state:
-        publishedAt == null
-          ? { type: "Initialized" }
-          : { type: "Published", timestampMs: Number(publishedAt) },
-      title: String(deployed.title ?? ""),
-      tracks: tracks.map((track) => ({
-        state: (track.state?.["@variant"] ?? "Unassigned") as TrackState,
-        recordingId: String(track.recording_id),
-        splitBps: { value: Number(track.split_bps?.pos0 ?? track.split_bps) },
-      })),
-    };
-  }
   const value = contracts.release.Release.parse(content) as Parsed;
   return {
     id,
@@ -245,7 +221,7 @@ export async function getWorksByIds(
   if (kinds.size === 0) return out;
   const { objects } = await client.core.getObjects({
     objectIds: [...kinds.keys()],
-    include: { content: true, json: true },
+    include: { content: true },
   });
   for (const object of objects) {
     if (object instanceof Error || !object.content) continue;
@@ -264,16 +240,12 @@ export async function getWorksByIds(
       out.releases[object.objectId] = parseReleaseObject(
         object.objectId,
         object.content,
-        object.json,
       );
   }
   return out;
 }
 
-/**
- * Resolve display titles for both deployed recording layouts. Older recordings
- * carry `title` in JSON; current recordings inherit it from their composition.
- */
+/** Resolve recording titles through each recording's canonical composition type. */
 export async function getRecordingTitles(
   client: ClientWithCoreApi,
   graphql: SuiGraphQLClient,
@@ -285,24 +257,15 @@ export async function getRecordingTitles(
 
   const { objects } = await client.core.getObjects({
     objectIds: ids,
-    include: { json: true },
+    include: {},
   });
   const titles: Record<string, string> = {};
   const compositionShareByRecording: Record<string, string> = {};
 
   for (const object of objects) {
     if (object instanceof Error) continue;
-    const json = object.json as { title?: unknown } | null;
-    if (typeof json?.title === "string" && json.title) {
-      titles[object.objectId] = json.title;
-      continue;
-    }
-    try {
-      const [, compositionShareType] = extractTypeParams2(object.type);
-      compositionShareByRecording[object.objectId] = compositionShareType;
-    } catch {
-      // A deployed layout with no composition type and no JSON title remains Untitled.
-    }
+    const [, compositionShareType] = extractTypeParams2(object.type);
+    compositionShareByRecording[object.objectId] = compositionShareType;
   }
 
   const compositionShareTypes = Object.values(compositionShareByRecording);