@misofm/sdk 0.2.1 → 0.4.0

package/dist/drop.d.ts

@@ -0,0 +1,120 @@
+import type { ClientWithCoreApi } from "@mysten/sui/client";
+import type { TxThunk } from "./transactions.ts";
+/** Pricing policy: pay exactly `amount` (fixed) or at least `amount` (floor). */
+export type DropPrice = {
+    kind: "fixed" | "floor";
+    amount: bigint | number | string;
+};
+export interface CreateDropParams {
+    /** The `Release` object the drop sells copies of — also the drop's derivation
+     *  parent and the home of the live-drop pointer. */
+    releaseId: string;
+    /** The release's `ReleaseAdminCap` — authorizes the drop. */
+    releaseAdminCapId: string;
+    /** Fixed or floor price, in the currency's smallest unit. */
+    price: DropPrice;
+    /** The `Currency` type argument, e.g. `0x2::sui::SUI`. */
+    currencyType: string;
+    /** Copies this edition may ever sell; `null`/omitted = uncapped (an open edition). */
+    maxSupply?: bigint | number | null;
+    /** Unix ms the sale opens. Default 0 (open immediately). */
+    startTimestampMs?: bigint | number;
+    /** Unix ms the sale closes; `null`/omitted = evergreen. */
+    endTimestampMs?: bigint | number | null;
+    misoDropPackageId: string;
+}
+/**
+ * Creates and shares a release's FIRST drop — edition 0. A release's edition
+ * sequence can only ever start once; later terms changes go through `newEdition`.
+ * The `Clock` is auto-supplied by the generated binding.
+ */
+export declare function createDrop(p: CreateDropParams): TxThunk;
+export interface NewEditionParams {
+    /** The `Release` whose drop is being superseded. */
+    releaseId: string;
+    /** The release's CURRENT drop — consumed (destroyed) by this call. */
+    oldDropId: string;
+    /** The current drop's `Currency` type. */
+    oldCurrencyType: string;
+    /** The release's `ReleaseAdminCap`. */
+    releaseAdminCapId: string;
+    /** The successor's price. */
+    price: DropPrice;
+    /** The successor's `Currency` type (may differ from the old one). */
+    currencyType: string;
+    /** Successor's supply cap; `null`/omitted = uncapped. */
+    maxSupply?: bigint | number | null;
+    /** Unix ms the successor opens. Default 0 (open immediately). */
+    startTimestampMs?: bigint | number;
+    /** Unix ms the successor closes; `null`/omitted = evergreen. */
+    endTimestampMs?: bigint | number | null;
+    misoDropPackageId: string;
+}
+/**
+ * Opens edition n+1 of a release's drop, CONSUMING the current one — the one way to
+ * change price, currency, cap, or window (or start a fresh run after a sell-out).
+ * Serial numbers restart at 1 for the new edition. The `Clock` is auto-supplied.
+ */
+export declare function newEdition(p: NewEditionParams): TxThunk;
+export interface BuyRecordParams {
+    /** The shared `Drop<Currency>` to buy from. */
+    dropId: string;
+    /** Buyer's `Coin<Currency>` object ids to pay from — merged, then split to `amount`. */
+    paymentCoinIds: string[];
+    /** Amount to pay in the currency's smallest unit (exact for `fixed`, ≥ for `floor`). */
+    amount: bigint | number | string;
+    /** The drop's `Currency` type, e.g. `0x2::sui::SUI`. */
+    currencyType: string;
+    /** The `miso_record` `Settings` shared object (authorizes the mint). */
+    settingsId: string;
+    /** Where to send the bought `Record` (usually the buyer). */
+    recipient: string;
+    misoDropPackageId: string;
+}
+/**
+ * Buys one record from a drop: merges the buyer's payment coins, splits the exact
+ * price, calls `buy`, and sends the minted `Record` to `recipient`. The buyer selects
+ * which of their coins to spend (see the app's coin selection); this builder only
+ * assembles the PTB. The `Clock` is auto-supplied.
+ */
+export declare function buyRecord(p: BuyRecordParams): TxThunk;
+/** A parsed drop, in the shape the featured-drop card renders. */
+export interface DropView {
+    id: string;
+    releaseId: string;
+    edition: number;
+    price: {
+        kind: "fixed" | "floor";
+        amount: bigint;
+    };
+    /** `null` = uncapped (an open edition). */
+    maxSupply: bigint | null;
+    quantitySold: bigint;
+    startTimestampMs: bigint;
+    /** `null` = evergreen. */
+    endTimestampMs: bigint | null;
+    /** The drop's `Currency` type, parsed from its object type tag (`null` if unavailable). */
+    currencyType: string | null;
+}
+/**
+ * Fetches and parses a shared `Drop` object, or `null` if it doesn't exist.
+ *
+ * NOTE: this deliberately deviates from the core-getter convention in
+ * `./queries.ts` (throw on missing object). Consumers probe pasted or stored
+ * drop ids — a party's featured drop, a superseded edition — where "no such
+ * drop" is a normal state, so absence is `null` and only transport failures throw.
+ */
+export declare function getDrop(client: ClientWithCoreApi, dropId: string): Promise<DropView | null>;
+export interface GetCurrentDropParams {
+    /** The release whose live drop to resolve. */
+    releaseId: string;
+    misoDropPackageId: string;
+}
+/**
+ * Resolves a release's LIVE drop through the `CurrentDropKey` pointer on the
+ * release's UID, or `null` if the release has never dropped. Superseded drops are
+ * destroyed, so this — not derived-address probing — is how the current edition is
+ * found.
+ */
+export declare function getCurrentDrop(client: ClientWithCoreApi, p: GetCurrentDropParams): Promise<DropView | null>;
+//# sourceMappingURL=drop.d.ts.map

package/dist/drop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop.d.ts","sourceRoot":"","sources":["../src/drop.ts"],"names":[],"mappings":"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"}

package/dist/drop.js

@@ -0,0 +1,152 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+import { deriveDynamicFieldID } from "@mysten/sui/utils";
+import { bcs } from "@mysten/sui/bcs";
+import { isNotFound } from "./queries.js";
+import * as drop from "./contracts/miso_drop/drop.js";
+/**
+ * Creates and shares a release's FIRST drop — edition 0. A release's edition
+ * sequence can only ever start once; later terms changes go through `newEdition`.
+ * The `Clock` is auto-supplied by the generated binding.
+ */
+export function createDrop(p) {
+    return (tx) => {
+        const terms = buildTerms(tx, p);
+        tx.add(drop._new({
+            package: p.misoDropPackageId,
+            arguments: [p.releaseId, p.releaseAdminCapId, terms.price, terms.supply, terms.window],
+            typeArguments: [p.currencyType],
+        }));
+    };
+}
+/**
+ * Opens edition n+1 of a release's drop, CONSUMING the current one — the one way to
+ * change price, currency, cap, or window (or start a fresh run after a sell-out).
+ * Serial numbers restart at 1 for the new edition. The `Clock` is auto-supplied.
+ */
+export function newEdition(p) {
+    return (tx) => {
+        const terms = buildTerms(tx, p);
+        tx.add(drop.newEdition({
+            package: p.misoDropPackageId,
+            arguments: [p.releaseId, p.oldDropId, p.releaseAdminCapId, terms.price, terms.supply, terms.window],
+            typeArguments: [p.oldCurrencyType, p.currencyType],
+        }));
+    };
+}
+/** Builds the three on-chain term values (`Price`, `Supply`, `Window`) from the flat
+ *  facade params — the flat shape stays the public API; the enums are a wire detail. */
+function buildTerms(tx, p) {
+    const pkg = { package: p.misoDropPackageId };
+    const makePrice = p.price.kind === "fixed" ? drop.newFixedPrice : drop.newFloorPrice;
+    const price = tx.add(makePrice({ ...pkg, arguments: [BigInt(p.price.amount)] }));
+    const supply = p.maxSupply == null
+        ? tx.add(drop.newUncappedSupply({ ...pkg, arguments: [] }))
+        : tx.add(drop.newCappedSupply({ ...pkg, arguments: [BigInt(p.maxSupply)] }));
+    const start = BigInt(p.startTimestampMs ?? 0);
+    const window = p.endTimestampMs == null
+        ? tx.add(drop.newUnboundedWindow({ ...pkg, arguments: [start] }))
+        : tx.add(drop.newBoundedWindow({ ...pkg, arguments: [start, BigInt(p.endTimestampMs)] }));
+    return { price, supply, window };
+}
+/**
+ * Buys one record from a drop: merges the buyer's payment coins, splits the exact
+ * price, calls `buy`, and sends the minted `Record` to `recipient`. The buyer selects
+ * which of their coins to spend (see the app's coin selection); this builder only
+ * assembles the PTB. The `Clock` is auto-supplied.
+ */
+export function buyRecord(p) {
+    return (tx) => {
+        const [first, ...rest] = p.paymentCoinIds;
+        if (!first)
+            throw new Error("buyRecord: no payment coins provided");
+        const primary = tx.object(first);
+        if (rest.length > 0)
+            tx.mergeCoins(primary, rest.map((id) => tx.object(id)));
+        const [payment] = tx.splitCoins(primary, [tx.pure.u64(BigInt(p.amount))]);
+        const record = tx.add(drop.buy({
+            package: p.misoDropPackageId,
+            arguments: [p.dropId, payment, p.settingsId],
+            typeArguments: [p.currencyType],
+        }));
+        tx.transferObjects([record], p.recipient);
+    };
+}
+/** Extracts `CURRENCY` from a `…::drop::Drop<CURRENCY>` type tag. */
+function currencyFromType(type) {
+    if (!type)
+        return null;
+    const lt = type.indexOf("<");
+    return lt >= 0 && type.endsWith(">") ? type.slice(lt + 1, -1) : null;
+}
+/**
+ * Fetches and parses a shared `Drop` object, or `null` if it doesn't exist.
+ *
+ * NOTE: this deliberately deviates from the core-getter convention in
+ * `./queries.ts` (throw on missing object). Consumers probe pasted or stored
+ * drop ids — a party's featured drop, a superseded edition — where "no such
+ * drop" is a normal state, so absence is `null` and only transport failures throw.
+ */
+export async function getDrop(client, dropId) {
+    let content;
+    let type;
+    try {
+        const { object } = await client.core.getObject({ objectId: dropId, include: { content: true } });
+        content = object?.content;
+        type = object?.type;
+    }
+    catch (e) {
+        if (isNotFound(e))
+            return null;
+        throw e;
+    }
+    if (!content)
+        return null;
+    const d = drop.Drop.parse(content);
+    const price = d.price;
+    const isFixed = price.$kind === "Fixed" || price.Fixed != null;
+    const amount = (isFixed ? price.Fixed?.amount : price.Floor?.amount) ?? "0";
+    const supply = d.supply;
+    const capped = supply.$kind === "Capped" || supply.Capped != null;
+    const window = d.window;
+    const bounded = window.$kind === "Bounded" || window.Bounded != null;
+    return {
+        id: dropId,
+        releaseId: d.release_id,
+        edition: d.edition,
+        price: { kind: isFixed ? "fixed" : "floor", amount: BigInt(amount) },
+        maxSupply: capped ? BigInt(supply.Capped?.max ?? "0") : null,
+        quantitySold: BigInt(d.quantity_sold),
+        startTimestampMs: BigInt((bounded ? window.Bounded?.start_timestamp_ms : window.Unbounded?.start_timestamp_ms) ?? "0"),
+        endTimestampMs: bounded ? BigInt(window.Bounded?.end_timestamp_ms ?? "0") : null,
+        currencyType: currencyFromType(type),
+    };
+}
+// The release's `CurrentDropKey` dynamic field holds a bare `ID`; the field object
+// serializes as `Field { id, name: CurrentDropKey (unit), value: ID }`.
+const CurrentDropField = bcs.struct("Field", { id: bcs.Address, name: bcs.bool(), value: bcs.Address });
+// Unit-struct key bytes (single `0x00` for the dummy bool field).
+const CURRENT_DROP_KEY_BYTES = drop.CurrentDropKey.serialize([false]).toBytes();
+/**
+ * Resolves a release's LIVE drop through the `CurrentDropKey` pointer on the
+ * release's UID, or `null` if the release has never dropped. Superseded drops are
+ * destroyed, so this — not derived-address probing — is how the current edition is
+ * found.
+ */
+export async function getCurrentDrop(client, p) {
+    const fieldId = deriveDynamicFieldID(p.releaseId, `${p.misoDropPackageId}::drop::CurrentDropKey`, CURRENT_DROP_KEY_BYTES);
+    let content;
+    try {
+        const { object } = await client.core.getObject({ objectId: fieldId, include: { content: true } });
+        content = object?.content;
+    }
+    catch (e) {
+        if (isNotFound(e))
+            return null;
+        throw e;
+    }
+    if (!content)
+        return null;
+    return getDrop(client, CurrentDropField.parse(content).value);
+}
+//# sourceMappingURL=drop.js.map

package/dist/drop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop.js","sourceRoot":"","sources":["../src/drop.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export * from "./share.ts";
 export * from "./share-template.ts";
 export * from "./release-graph.ts";
 export * from "./catalog.ts";
+export * as read from "./read/index.ts";
 export * from "./credits.ts";
 export * from "./cover.ts";
 export * from "./extensions/royalty-pool.ts";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA2BA,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC/D,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAI7B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAG7C,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA2BA,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC/D,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAK7B,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AAIxC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAG7C,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -31,6 +31,10 @@ export * from "./share.js";
 export * from "./share-template.js";
 export * from "./release-graph.js";
 export * from "./catalog.js";
+// High-level, JSON-safe platform projections used directly by clients and by
+// the thin HTTP read service. Namespaced because these composed view types are
+// intentionally distinct from the lower-level contract views above.
+export * as read from "./read/index.js";
 // First-party extensions — attached to a protocol work via its cap-gated
 // `uid_mut` hook.
 export * from "./credits.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AAEtC,sCAAsC;AACtC,EAAE;AACF,6EAA6E;AAC7E,oEAAoE;AACpE,EAAE;AACF,+EAA+E;AAC/E,oFAAoF;AACpF,8EAA8E;AAC9E,4EAA4E;AAC5E,kEAAkE;AAClE,EAAE;AACF,6EAA6E;AAC7E,iFAAiF;AACjF,qCAAqC;AACrC,EAAE;AACF,gFAAgF;AAChF,6EAA6E;AAC7E,gFAAgF;AAChF,gFAAgF;AAChF,iFAAiF;AACjF,gFAAgF;AAEhF,kFAAkF;AAClF,2EAA2E;AAC3E,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAE/D,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAE7B,yEAAyE;AACzE,kBAAkB;AAClB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAE7C,sEAAsE;AACtE,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AAEtC,sCAAsC;AACtC,EAAE;AACF,6EAA6E;AAC7E,oEAAoE;AACpE,EAAE;AACF,+EAA+E;AAC/E,oFAAoF;AACpF,8EAA8E;AAC9E,4EAA4E;AAC5E,kEAAkE;AAClE,EAAE;AACF,6EAA6E;AAC7E,iFAAiF;AACjF,qCAAqC;AACrC,EAAE;AACF,gFAAgF;AAChF,6EAA6E;AAC7E,gFAAgF;AAChF,gFAAgF;AAChF,iFAAiF;AACjF,gFAAgF;AAEhF,kFAAkF;AAClF,2EAA2E;AAC3E,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAE/D,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAE7B,6EAA6E;AAC7E,+EAA+E;AAC/E,oEAAoE;AACpE,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AAExC,yEAAyE;AACzE,kBAAkB;AAClB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAE7C,sEAAsE;AACtE,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC"}

package/dist/read/artist.d.ts

@@ -0,0 +1,24 @@
+import type { MisoClient } from "./client.ts";
+import type { ArtistProfile, FeaturedRelease, PartySummary } from "./types.ts";
+/** Optional sub-resources — read only when asked for. */
+export type ArtistInclude = "roles" | "tags";
+export interface GetArtistOptions {
+    include?: readonly ArtistInclude[];
+}
+/** Public avatar URL for a party (served from the API's R2 lane; 404 when unset). */
+export declare function partyAvatarUrl(apiBaseUrl: string, partyId: string): string;
+/**
+ * An artist page, fully resolved. Throws only if the PARTY itself can't be read —
+ * every extension is optional by design (a party with no profile set is a new
+ * party, not a broken one), so each decoration read falls back to its empty value.
+ */
+export declare function getArtistProfile(client: MisoClient, partyId: string, options?: GetArtistOptions): Promise<ArtistProfile>;
+/** Name + kind for many parties at once. Ids that don't resolve are omitted. */
+export declare function getPartySummaries(client: MisoClient, ids: readonly string[]): Promise<PartySummary[]>;
+/**
+ * The party's pinned pressing, resolved through to its release and cover.
+ * `null` — a successful empty — when nothing is pinned or the pin is dangling
+ * (the pressing it named has since been superseded and destroyed).
+ */
+export declare function getFeaturedRelease(client: MisoClient, partyId: string): Promise<FeaturedRelease | null>;
+//# sourceMappingURL=artist.d.ts.map

package/dist/read/artist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artist.d.ts","sourceRoot":"","sources":["../../src/read/artist.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAe,YAAY,EAAE,MAAM,YAAY,CAAC;AAE5F,yDAAyD;AACzD,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CACpC;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,aAAa,CAAC,CAuCxB;AAYD,gFAAgF;AAChF,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAO3G;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CA0B7G"}

package/dist/read/artist.js

@@ -0,0 +1,114 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+//
+// Artist reads: a `Party` plus every extension attached to its UID.
+//
+// The artist page is the clearest case for this whole layer. Its data lives in
+// EIGHT separate dynamic fields, each its own package, each its own read — party,
+// profile, ctas, genres, links, roles, tags, featured. miso-app fanned all eight
+// out from the browser (`lib/party-queries.ts`, plus a second identical fan-out in
+// `PartyEditSheet`). Here they are one call, resolved once, cached once.
+//
+// `roles` and `tags` are opt-in via `include`: only the owner's edit sheet reads
+// them, and leaving them out of the public read keeps the hot path to six.
+import { resolveGenreNames } from "./genres.js";
+import { readReleaseCover } from "./catalog.js";
+import { getDrop } from "../drop.js";
+import { getReleaseById } from "@misonetwork/sdk";
+import { getReleaseCredits } from "../credits.js";
+/** Public avatar URL for a party (served from the API's R2 lane; 404 when unset). */
+export function partyAvatarUrl(apiBaseUrl, partyId) {
+    return `${apiBaseUrl.replace(/\/$/, "")}/media/avatar/${partyId}`;
+}
+/**
+ * An artist page, fully resolved. Throws only if the PARTY itself can't be read —
+ * every extension is optional by design (a party with no profile set is a new
+ * party, not a broken one), so each decoration read falls back to its empty value.
+ */
+export async function getArtistProfile(client, partyId, options = {}) {
+    const include = new Set(options.include ?? []);
+    const { party } = client.sui;
+    const [profile, ctas, genreIds, links, roles, tags] = await Promise.all([
+        party.getProfile(partyId).catch(() => null),
+        party.getCtas(partyId).catch(() => []),
+        party.getGenres(partyId).catch(() => []),
+        party.getLinks(partyId).catch(() => []),
+        include.has("roles") ? party.getRoles(partyId).catch(() => []) : Promise.resolve(undefined),
+        include.has("tags") ? party.getTags(partyId).catch(() => []) : Promise.resolve(undefined),
+    ]);
+    // The party read is the one that may legitimately fail (no such party), so it
+    // is awaited on its own rather than being swallowed by the batch above.
+    const entity = await party.getPartyById(partyId);
+    const [genres, members] = await Promise.all([
+        resolveGenreNames(client, genreIds),
+        resolveMembers(client, entity.kind === "group" ? (entity.members ?? []) : []),
+    ]);
+    return {
+        id: entity.id,
+        kind: entity.kind,
+        name: entity.name,
+        createdAtMs: entity.createdAtMs,
+        bioShort: profile?.bioShort ?? null,
+        bioLong: profile?.bioLong ?? null,
+        country: profile?.country ?? null,
+        languages: profile?.languages ?? [],
+        genres,
+        links: links.map((l) => ({ platform: l.platform, value: l.value, url: l.url })),
+        ctas: ctas.map((c) => ({ label: c.label, url: c.url })),
+        members,
+        ...(roles !== undefined ? { roles } : {}),
+        ...(tags !== undefined ? { tags } : {}),
+        avatarUrl: partyAvatarUrl(client.config.apiBaseUrl, entity.id),
+    };
+}
+/** Group members with names resolved. A member that fails to read is dropped. */
+async function resolveMembers(client, memberIds) {
+    if (memberIds.length === 0)
+        return [];
+    const parties = await client.sui.party.getPartiesByIds([...memberIds]).catch(() => ({}));
+    return memberIds.flatMap((id) => {
+        const p = parties[id];
+        return p ? [{ id, name: p.name }] : [];
+    });
+}
+/** Name + kind for many parties at once. Ids that don't resolve are omitted. */
+export async function getPartySummaries(client, ids) {
+    if (ids.length === 0)
+        return [];
+    const parties = await client.sui.party.getPartiesByIds([...ids]);
+    return ids.flatMap((id) => {
+        const p = parties[id];
+        return p ? [{ id, name: p.name, kind: p.kind }] : [];
+    });
+}
+/**
+ * The party's pinned pressing, resolved through to its release and cover.
+ * `null` — a successful empty — when nothing is pinned or the pin is dangling
+ * (the pressing it named has since been superseded and destroyed).
+ */
+export async function getFeaturedRelease(client, partyId) {
+    const pressingId = await client.sui.party.getFeaturedDrop(partyId);
+    if (!pressingId)
+        return null;
+    const pressing = await getDrop(client.protocol, pressingId);
+    if (!pressing)
+        return null;
+    const [release, cover, credits, entity] = await Promise.all([
+        getReleaseById(client.protocol, pressing.releaseId),
+        readReleaseCover(client, pressing.releaseId),
+        getReleaseCredits(client.protocol, pressing.releaseId, client.config.protocol.releaseCredits).catch(() => null),
+        client.sui.party.getPartyById(partyId),
+    ]);
+    // The artist line prefers the release's own PRIMARY credits and falls back to
+    // the party whose page this is — a release with no credits set still shows an
+    // artist, which is the behavior the featured card has always had.
+    const primary = (credits ?? []).filter((c) => c.roles.includes("Primary")).map((c) => c.displayName);
+    return {
+        pressingId,
+        releaseId: pressing.releaseId,
+        title: release.title,
+        artist: primary.length ? primary.join(", ") : entity.name,
+        coverUrl: cover?.still.url ?? null,
+    };
+}
+//# sourceMappingURL=artist.js.map

package/dist/read/artist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artist.js","sourceRoot":"","sources":["../../src/read/artist.ts"],"names":[],"mappings":"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"}

package/dist/read/catalog.d.ts

@@ -0,0 +1,63 @@
+import type { MisoClient } from "./client.ts";
+import type { Cover, Credit, Currency, DiscoverItem, DropPreview, PressingDetail, RecordAlbum, ReleaseDetail, TrackCredits } from "./types.ts";
+/**
+ * Symbol + decimals for a coin type. FakeUsd (the testnet dollar) is 6dp; SUI is
+ * 9dp; anything else falls back to its module name at 9dp, which is the Sui
+ * default and the honest guess for a coin we have no table entry for.
+ */
+export declare function currencyInfo(type: string | null): Currency;
+/** The release's PRIMARY credits, in chain order — a release's artist line. */
+export declare function primaryArtistNames(credits: Credit[]): string[];
+/**
+ * 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`.
+ */
+export declare function readReleaseCover(client: MisoClient, releaseId: string): Promise<Cover | null>;
+/**
+ * A release with its cover, credits, and resolved tracklist.
+ *
+ * Identity (the release object) is HARD — a failure here is a failed read.
+ * Decoration (cover, credits) is SOFT: a release with no cover extension set is a
+ * normal state, not a broken page, so those reads swallow their errors. That
+ * split is inherited from `lib/drops.ts` and is what keeps a half-configured
+ * release renderable.
+ */
+export declare function getReleaseDetail(client: MisoClient, releaseId: string): Promise<ReleaseDetail>;
+/**
+ * Per-track credits for a release, keyed by recording id. A track with no credits
+ * set maps to an empty entry rather than being absent, so a caller can tell
+ * "nothing credited" from "no such track".
+ */
+export declare function getTrackCredits(client: MisoClient, releaseId: string): Promise<Record<string, TrackCredits>>;
+/** Everything the pressing buy page renders. `null` when no such pressing exists. */
+export declare function getPressingDetail(client: MisoClient, pressingId: string): Promise<PressingDetail | null>;
+/**
+ * The confirmation preview behind "paste a pressing id to pin it". Verifies the
+ * object really is a `Drop` before spending reads on it — a release id or a
+ * record id pasted by mistake must come back as `null`, not as a half-built card.
+ */
+export declare function getDropPreview(client: MisoClient, dropId: string): Promise<DropPreview | null>;
+/**
+ * The records currently on sale.
+ *
+ * Configured by RELEASE id, never by drop id: a release id is permanent, while a
+ * drop is superseded (and the old `Drop` destroyed) whenever a new edition opens.
+ * Following the release's `CurrentDropKey` pointer keeps this list pointing at the
+ * live edition without anyone touching the config.
+ */
+export declare function getDiscoverShelf(client: MisoClient): Promise<DiscoverItem[]>;
+/**
+ * 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.
+ *
+ * This answer is IMMUTABLE for the life of the record, which is what lets the
+ * endpoint in front of it cache for a year.
+ */
+export declare function getRecordAlbum(client: MisoClient, recordId: string): Promise<RecordAlbum | null>;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/read/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/read/catalog.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9C,OAAO,KAAK,EACV,KAAK,EAEL,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,cAAc,EAGd,WAAW,EACX,aAAa,EACb,YAAY,EAGb,MAAM,YAAY,CAAC;AAoBpB;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAK1D;AA8BD,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAE9D;AAkBD;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAOnG;AAID;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAyBpG;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAiBlH;AAID,qFAAqF;AACrF,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAK9G;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAqBpG;AAID;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAGlF;AA0BD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAUtG"}