@misofm/sdk 0.2.1 → 0.3.0

package/dist/read/internal/scalars.d.ts

@@ -0,0 +1,23 @@
+/** A u64/u128 as it may arrive off the wire, in BCS, or from a JSON projection. */
+export type NumericLike = bigint | number | string | null | undefined;
+/**
+ * Base-unit scalar → decimal string. Returns `"0"` for anything unreadable, which
+ * is the honest projection of "the chain gave us no number" for quantities and
+ * amounts. Use {@link u64OrNull} where absent must stay distinguishable from zero.
+ */
+export declare function u64(v: NumericLike): string;
+/** Base-unit scalar → decimal string, or `null` when absent/unparseable. */
+export declare function u64OrNull(v: NumericLike): string | null;
+/**
+ * A millisecond timestamp → `number`. Milliseconds stay numbers (they are far
+ * inside Number.MAX_SAFE_INTEGER and `new Date()` wants one), unlike token
+ * amounts which must not lose precision.
+ */
+export declare function msOrNull(v: NumericLike): number | null;
+/** As {@link msOrNull}, defaulting to `0` (the epoch) when absent. */
+export declare function ms(v: NumericLike): number;
+/** A plain integer field (bps, edition, counts) → `number`, defaulting to `0`. */
+export declare function int(v: NumericLike): number;
+/** Integer comparison over two decimal strings — `a >= b` without going through Number. */
+export declare function gte(a: string, b: string): boolean;
+//# sourceMappingURL=scalars.d.ts.map

package/dist/read/internal/scalars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scalars.d.ts","sourceRoot":"","sources":["../../../src/read/internal/scalars.ts"],"names":[],"mappings":"AAOA,mFAAmF;AACnF,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAEtE;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAE1C;AAED,4EAA4E;AAC5E,wBAAgB,SAAS,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAMvD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAKtD;AAED,sEAAsE;AACtE,wBAAgB,EAAE,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAEzC;AAED,kFAAkF;AAClF,wBAAgB,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAK1C;AAED,2FAA2F;AAC3F,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAEjD"}

package/dist/read/internal/scalars.js

@@ -0,0 +1,56 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+//
+// The bigint→JSON boundary. Every u64/u128 the protocol SDKs hand back arrives as
+// a `bigint`, which `JSON.stringify` throws on; these convert once, here, so no
+// view type can carry one out of the SDK (see the header of ../types.ts).
+/**
+ * Base-unit scalar → decimal string. Returns `"0"` for anything unreadable, which
+ * is the honest projection of "the chain gave us no number" for quantities and
+ * amounts. Use {@link u64OrNull} where absent must stay distinguishable from zero.
+ */
+export function u64(v) {
+    return u64OrNull(v) ?? "0";
+}
+/** Base-unit scalar → decimal string, or `null` when absent/unparseable. */
+export function u64OrNull(v) {
+    if (v == null)
+        return null;
+    if (typeof v === "bigint")
+        return v.toString();
+    if (typeof v === "number")
+        return Number.isFinite(v) ? BigInt(Math.trunc(v)).toString() : null;
+    const s = v.trim();
+    return /^\d+$/.test(s) ? BigInt(s).toString() : null;
+}
+/**
+ * A millisecond timestamp → `number`. Milliseconds stay numbers (they are far
+ * inside Number.MAX_SAFE_INTEGER and `new Date()` wants one), unlike token
+ * amounts which must not lose precision.
+ */
+export function msOrNull(v) {
+    const s = u64OrNull(v);
+    if (s === null)
+        return null;
+    const n = Number(s);
+    return Number.isSafeInteger(n) ? n : null;
+}
+/** As {@link msOrNull}, defaulting to `0` (the epoch) when absent. */
+export function ms(v) {
+    return msOrNull(v) ?? 0;
+}
+/** A plain integer field (bps, edition, counts) → `number`, defaulting to `0`. */
+export function int(v) {
+    if (typeof v === "number" && Number.isFinite(v))
+        return Math.trunc(v);
+    if (typeof v === "bigint")
+        return Number(v);
+    if (typeof v === "string" && /^-?\d+$/.test(v.trim()))
+        return Number(v.trim());
+    return 0;
+}
+/** Integer comparison over two decimal strings — `a >= b` without going through Number. */
+export function gte(a, b) {
+    return BigInt(a) >= BigInt(b);
+}
+//# sourceMappingURL=scalars.js.map

package/dist/read/internal/scalars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scalars.js","sourceRoot":"","sources":["../../../src/read/internal/scalars.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AACtC,EAAE;AACF,kFAAkF;AAClF,gFAAgF;AAChF,0EAA0E;AAK1E;;;;GAIG;AACH,MAAM,UAAU,GAAG,CAAC,CAAc;IAChC,OAAO,SAAS,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;AAC7B,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,SAAS,CAAC,CAAc;IACtC,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC/C,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/F,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACnB,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACvD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,CAAc;IACrC,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5C,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,EAAE,CAAC,CAAc;IAC/B,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,GAAG,CAAC,CAAc;IAChC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACtE,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/E,OAAO,CAAC,CAAC;AACX,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,GAAG,CAAC,CAAS,EAAE,CAAS;IACtC,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC"}

package/dist/read/internal/walrus.d.ts

@@ -0,0 +1,4 @@
+export declare function u256ToB64Url(value: bigint | string): string;
+/** Build Walrus's 37-byte quilt-patch id. All fields use BCS little-endian. */
+export declare function quiltPatchId(quiltId: bigint | string, version: number, startIndex: number, endIndex: number): string;
+//# sourceMappingURL=walrus.d.ts.map

package/dist/read/internal/walrus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walrus.d.ts","sourceRoot":"","sources":["../../../src/read/internal/walrus.ts"],"names":[],"mappings":"AAYA,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAE3D;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,CASR"}

package/dist/read/internal/walrus.js

@@ -0,0 +1,23 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+import { bcs } from "@mysten/sui/bcs";
+import { toBase64 } from "@mysten/sui/utils";
+const u256 = bcs.u256();
+function toBase64Url(bytes) {
+    return toBase64(bytes).replace(/=*$/, "").replaceAll("+", "-").replaceAll("/", "_");
+}
+export function u256ToB64Url(value) {
+    return toBase64Url(u256.serialize(BigInt(value)).toBytes());
+}
+/** Build Walrus's 37-byte quilt-patch id. All fields use BCS little-endian. */
+export function quiltPatchId(quiltId, version, startIndex, endIndex) {
+    const bytes = new Uint8Array(37);
+    bytes.set(u256.serialize(BigInt(quiltId)).toBytes(), 0);
+    bytes[32] = version;
+    bytes[33] = startIndex & 0xff;
+    bytes[34] = (startIndex >> 8) & 0xff;
+    bytes[35] = endIndex & 0xff;
+    bytes[36] = (endIndex >> 8) & 0xff;
+    return toBase64Url(bytes);
+}
+//# sourceMappingURL=walrus.js.map

package/dist/read/internal/walrus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walrus.js","sourceRoot":"","sources":["../../../src/read/internal/walrus.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AAEtC,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;AAExB,SAAS,WAAW,CAAC,KAAiB;IACpC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAsB;IACjD,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAC1B,OAAwB,EACxB,OAAe,EACf,UAAkB,EAClB,QAAgB;IAEhB,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IACjC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IACxD,KAAK,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,CAAC,GAAG,UAAU,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IACrC,KAAK,CAAC,EAAE,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IACnC,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC"}

package/dist/read/receipts.d.ts

@@ -0,0 +1,22 @@
+import type { MisoClient } from "./client.ts";
+import type { PressingDetail, PurchaseReceipt, TrackRoyalty } from "./types.ts";
+/** Composition royalty rate (bps) per recording id. Sparse — an unresolved parent has no entry. */
+type CompositionRates = Record<string, number | undefined>;
+/**
+ * Split `paid` across the release's tracks by their `splitBps`, then split each
+ * track's share between its composition and its recording. All BigInt — the same
+ * truncating integer math the on-chain royalty layer does, so the numbers shown
+ * are the numbers paid.
+ */
+export declare function breakdown(tracks: PressingDetail["release"]["tracks"], paid: string, compositionRates: CompositionRates): TrackRoyalty[];
+/**
+ * The receipt for `txDigest`, a purchase from `pressingId`.
+ *
+ * The sale and the pressing detail are fetched together — arriving from the buy
+ * button costs one round of work, not two. `null` when the pressing no longer
+ * exists (a superseded edition), which the caller renders as "not found" rather
+ * than as an error.
+ */
+export declare function getPurchaseReceipt(client: MisoClient, pressingId: string, txDigest: string): Promise<PurchaseReceipt | null>;
+export {};
+//# sourceMappingURL=receipts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"receipts.d.ts","sourceRoot":"","sources":["../../src/read/receipts.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAc,YAAY,EAAE,MAAM,YAAY,CAAC;AAe5F,mGAAmG;AACnG,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAgK3D;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,EAC3C,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,gBAAgB,GACjC,YAAY,EAAE,CAgBhB;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAmBjC"}

package/dist/read/receipts.js

@@ -0,0 +1,233 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+//
+// What one record sale actually was, read back from its transaction.
+//
+// The transaction digest is the receipt's identity: everything shown is
+// re-derived from chain state, so a receipt link survives a refresh, a deep link,
+// or a share to another device. `drop::buy` emits ONE `RecordSoldEvent` carrying
+// the copy that was minted, its number in the run, and what the buyer paid.
+//
+// Two reads, in order, because a receipt is opened at two very different ages:
+//   fullnode  the fresh path — usually the instant the transaction lands, possibly
+//             before this node has it, hence `waitForTransaction`.
+//   indexer   the old path — GraphQL keeps transactions the fullnode has pruned.
+//             This is what makes a months-old receipt link still open.
+//
+// Where the money goes is PRESENTATIONAL, not a second on-chain fact: `buy`
+// forwards the whole payment to the release's funds accumulator (there is no
+// platform fee), and the royalty layer splits it downstream by the same terms this
+// read walks. We show the buyer that arithmetic, in the same truncating integer
+// math the chain does.
+import * as dropContract from "../contracts/miso_drop/drop.js";
+import { extractTypeParams2, getCompositionsByIds, } from "@misonetwork/sdk";
+import { getPressingDetail } from "./catalog.js";
+import { int, u64 } from "./internal/scalars.js";
+import { getWorkAddressesByShareTypes } from "./works.js";
+const BPS = 10000n;
+/** `…::drop::RecordSoldEvent<Currency>` — the one event `drop::buy` emits. */
+const RECORD_SOLD_EVENT = "::drop::RecordSoldEvent";
+/**
+ * How long to wait for the fullnode to have the transaction before falling back
+ * to the indexer. Propagation is p95 ~330ms, so this only ever runs long for a
+ * digest the node genuinely doesn't have.
+ */
+const FULLNODE_WAIT_MS = 5_000;
+function coerceBigInt(v) {
+    if (typeof v === "bigint")
+        return v;
+    if (typeof v === "number" && Number.isFinite(v))
+        return BigInt(Math.trunc(v));
+    if (typeof v === "string" && /^\d+$/.test(v))
+        return BigInt(v);
+    return null;
+}
+/**
+ * The event's JSON projection — the fallback for transports that surface `json`
+ * but no BCS. Field names are the Move ones (snake_case).
+ */
+function saleFromJson(json) {
+    const number = coerceBigInt(json.number);
+    const paid = coerceBigInt(json.paid);
+    const recordId = json.record_id;
+    if (number == null || paid == null || typeof recordId !== "string")
+        return null;
+    return {
+        dropId: typeof json.drop_id === "string" ? json.drop_id : "",
+        releaseId: typeof json.release_id === "string" ? json.release_id : "",
+        edition: int(coerceBigInt(json.edition) ?? 0n),
+        recordId,
+        number: number.toString(),
+        paid: paid.toString(),
+        buyer: typeof json.buyer === "string" ? json.buyer : "",
+    };
+}
+/**
+ * The sale a transaction recorded, or null if it emitted none. BCS is the stable
+ * shape (a JSON projection's field names vary by transport), so it is tried first.
+ */
+function findSale(events) {
+    for (const e of events) {
+        if (!e.eventType.includes(RECORD_SOLD_EVENT))
+            continue;
+        try {
+            // The generated struct decodes addresses to 0x-hex and u64s to decimal strings.
+            const s = dropContract.RecordSoldEvent.parse(e.bcs);
+            return {
+                dropId: s.drop_id,
+                releaseId: s.release_id,
+                edition: int(s.edition),
+                recordId: s.record_id,
+                number: u64(s.number),
+                paid: u64(s.paid),
+                buyer: s.buyer,
+            };
+        }
+        catch {
+            // Unparseable BCS (or none surfaced) — fall through to the JSON view.
+        }
+        const fromJson = e.json && saleFromJson(e.json);
+        if (fromJson)
+            return fromJson;
+    }
+    return null;
+}
+/** The sale, read from the fullnode. */
+async function saleFromFullnode(client, txDigest) {
+    const result = await client.sui.waitForTransaction({
+        digest: txDigest,
+        include: { events: true },
+        timeout: FULLNODE_WAIT_MS,
+    });
+    if (result.$kind !== "Transaction" || !result.Transaction.status.success) {
+        throw new Error(`Transaction did not succeed: ${txDigest}`);
+    }
+    const sale = findSale(result.Transaction.events);
+    if (!sale)
+        throw new Error(`No record purchase in transaction ${txDigest}`);
+    return sale;
+}
+const TX_EVENTS_QUERY = `query TransactionEvents($digest: String!) {
+  transaction(digest: $digest) {
+    effects {
+      status
+      events { nodes { contents { type { repr } json } } }
+    }
+  }
+}`;
+/** The sale, read from the GraphQL indexer — the path for a pruned transaction. */
+async function saleFromIndexer(client, txDigest) {
+    const { data, errors } = await client.graphqlRaw.query({
+        query: TX_EVENTS_QUERY,
+        variables: { digest: txDigest },
+    });
+    if (errors?.length)
+        throw new Error(errors[0].message);
+    const effects = data?.transaction?.effects;
+    if (!effects)
+        throw new Error(`Transaction not found: ${txDigest}`);
+    if (effects.status !== "SUCCESS")
+        throw new Error(`Transaction did not succeed: ${txDigest}`);
+    for (const node of effects.events?.nodes ?? []) {
+        const contents = node.contents;
+        if (!contents?.type.repr.includes(RECORD_SOLD_EVENT))
+            continue;
+        const sale = typeof contents.json === "object" && contents.json !== null
+            ? saleFromJson(contents.json)
+            : null;
+        if (sale)
+            return sale;
+    }
+    throw new Error(`No record purchase in transaction ${txDigest}`);
+}
+/**
+ * Each recording's parent composition royalty rate, in basis points, keyed by
+ * recording id.
+ *
+ * A `Recording<RecordingShare, CompositionShare>` names its parent by SHARE TYPE,
+ * not by id, so the hop is: recording type tag → composition share type →
+ * (GraphQL) composition id → (Core) the composition's `royaltyRate`.
+ *
+ * Best-effort by design: any failure returns the rates resolved so far, and the
+ * receipt drops to a track-level breakdown rather than failing the whole page.
+ */
+async function compositionRatesByRecording(client, recordingIds) {
+    if (recordingIds.length === 0)
+        return {};
+    const shareTypeByRecording = {};
+    const { objects } = await client.protocol.core.getObjects({ objectIds: [...new Set(recordingIds)] });
+    for (const obj of objects) {
+        if (obj instanceof Error || !obj.type)
+            continue;
+        try {
+            const [, compositionShareType] = extractTypeParams2(obj.type);
+            shareTypeByRecording[obj.objectId] = compositionShareType;
+        }
+        catch {
+            // A recording type we can't read the parent off — skip this track.
+        }
+    }
+    const shareTypes = Object.values(shareTypeByRecording);
+    if (shareTypes.length === 0)
+        return {};
+    const addresses = await getWorkAddressesByShareTypes(client.graphql, { compositions: shareTypes, recordings: [] }, client.config.protocol.miso);
+    const compositionIds = Object.values(addresses.compositions).filter((id) => !!id);
+    const compositions = await getCompositionsByIds(client.protocol, compositionIds);
+    const rates = {};
+    for (const [recordingId, shareType] of Object.entries(shareTypeByRecording)) {
+        const compositionId = addresses.compositions[shareType];
+        const composition = compositionId ? compositions[compositionId] : undefined;
+        if (composition)
+            rates[recordingId] = int(composition.royaltyRate.value);
+    }
+    return rates;
+}
+/**
+ * Split `paid` across the release's tracks by their `splitBps`, then split each
+ * track's share between its composition and its recording. All BigInt — the same
+ * truncating integer math the on-chain royalty layer does, so the numbers shown
+ * are the numbers paid.
+ */
+export function breakdown(tracks, paid, compositionRates) {
+    const paidUnits = BigInt(paid);
+    return tracks.map((track) => {
+        const amount = (paidUnits * BigInt(track.splitBps)) / BPS;
+        const rate = compositionRates[track.recordingId];
+        const base = {
+            no: track.no,
+            title: track.title,
+            recordingId: track.recordingId,
+            splitBps: track.splitBps,
+            amount: amount.toString(),
+        };
+        if (rate == null)
+            return { ...base, composition: null, recording: null };
+        const composition = (amount * BigInt(rate)) / BPS;
+        return { ...base, composition: composition.toString(), recording: (amount - composition).toString() };
+    });
+}
+/**
+ * The receipt for `txDigest`, a purchase from `pressingId`.
+ *
+ * The sale and the pressing detail are fetched together — arriving from the buy
+ * button costs one round of work, not two. `null` when the pressing no longer
+ * exists (a superseded edition), which the caller renders as "not found" rather
+ * than as an error.
+ */
+export async function getPurchaseReceipt(client, pressingId, txDigest) {
+    const [sale, detail] = await Promise.all([
+        saleFromFullnode(client, txDigest).catch(() => saleFromIndexer(client, txDigest)),
+        getPressingDetail(client, pressingId),
+    ]);
+    if (!detail)
+        return null;
+    // Best-effort: a failed composition lookup costs the sub-rows, not the page.
+    const rates = await compositionRatesByRecording(client, detail.release.tracks.map((t) => t.recordingId)).catch(() => ({}));
+    return {
+        sale,
+        detail,
+        price: detail.pressing.price.amount,
+        tracks: breakdown(detail.release.tracks, sale.paid, rates),
+    };
+}
+//# sourceMappingURL=receipts.js.map

package/dist/read/receipts.js.map

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