@misofm/platform 0.0.0 → 0.18.0

package/dist/read/config.js

@@ -0,0 +1,63 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+//
+// Per-network on-chain identity: which packages the reads address, which objects
+// they read, and which endpoints they read through. Every id that used to be a
+// hard-coded constant inside miso-app (`lib/party.ts`, `lib/release.ts`,
+// `lib/money.ts`, `lib/pressing.ts`) lives here instead, so a redeploy is a change
+// in ONE file that every surface picks up.
+//
+// Testnet values are derived from the same verified deployment record exported
+// by the platform SDK. Mainnet remains deliberately unavailable until a complete
+// deployment is bundled for it.
+import { getMisoPlatformDeployment } from "../deployments.js";
+/** Missing defaults to Testnet for local development; invalid values fail closed. */
+export function networkFrom(value) {
+    if (value === undefined || value === "testnet")
+        return "testnet";
+    if (value === "mainnet")
+        return "mainnet";
+    throw new Error(`@misofm/platform/read: unsupported network "${value}".`);
+}
+/** The config for `network`, derived from this SDK's verified deployment map. */
+export function misoConfig(network, overrides = {}) {
+    const platform = getMisoPlatformDeployment(network);
+    const vaultPackageId = platform.operations.status === "available"
+        ? platform.operations.vault.packageId
+        : platform.operations.legacy?.vaultPackageId;
+    if (!vaultPackageId) {
+        throw new Error(`@misofm/platform/read: no current or legacy Vault type metadata for "${network}".`);
+    }
+    const config = {
+        network,
+        deployment: platform.protocol,
+        recordSales: platform.recordSales,
+        protocol: {
+            // Read-only legacy type discovery does not make this package an
+            // executable operations ABI; client call surfaces remain fail closed.
+            vault: vaultPackageId,
+            releaseCoverArt: platform.packages.releaseCoverArt,
+            releaseKind: platform.packages.releaseKind,
+            recordingMasterReference: platform.packages.recordingMasterReference,
+            compositionCredits: platform.packages.compositionCredits,
+            recordingCredits: platform.packages.recordingCredits,
+            releaseCredits: platform.packages.releaseCredits,
+            credit: platform.packages.credit,
+        },
+        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",
+        discoverSales: [],
+    };
+    return { ...config, ...stripUndefined(overrides) };
+}
+/** `{ a: undefined }` must not clobber a real default when spread. */
+function stripUndefined(o) {
+    return Object.fromEntries(Object.entries(o).filter(([, v]) => v !== undefined));
+}
+//# sourceMappingURL=config.js.map

package/dist/read/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/read/config.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AACtC,EAAE;AACF,iFAAiF;AACjF,+EAA+E;AAC/E,yEAAyE;AACzE,mFAAmF;AACnF,2CAA2C;AAC3C,EAAE;AACF,+EAA+E;AAC/E,iFAAiF;AACjF,gCAAgC;AAGhC,OAAO,EAAE,yBAAyB,EAA8B,MAAM,mBAAmB,CAAC;AAI1F,qFAAqF;AACrF,MAAM,UAAU,WAAW,CAAC,KAAyB;IACnD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACjE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,IAAI,KAAK,CAAC,+CAA+C,KAAK,IAAI,CAAC,CAAC;AAC5E,CAAC;AAqED,iFAAiF;AACjF,MAAM,UAAU,UAAU,CAAC,OAAgB,EAAE,SAAS,GAAwB,EAAE;IAC9E,MAAM,QAAQ,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,cAAc,GAClB,QAAQ,CAAC,UAAU,CAAC,MAAM,KAAK,WAAW;QACxC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS;QACrC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,cAAc,CAAC;IACjD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,wEAAwE,OAAO,IAAI,CACpF,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAe;QACzB,OAAO;QACP,UAAU,EAAE,QAAQ,CAAC,QAAQ;QAC7B,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,QAAQ,EAAE;YACR,gEAAgE;YAChE,sEAAsE;YACtE,KAAK,EAAE,cAAc;YACrB,eAAe,EAAE,QAAQ,CAAC,QAAQ,CAAC,eAAe;YAClD,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,WAAW;YAC1C,wBAAwB,EAAE,QAAQ,CAAC,QAAQ,CAAC,wBAAwB;YACpE,kBAAkB,EAAE,QAAQ,CAAC,QAAQ,CAAC,kBAAkB;YACxD,gBAAgB,EAAE,QAAQ,CAAC,QAAQ,CAAC,gBAAgB;YACpD,cAAc,EAAE,QAAQ,CAAC,QAAQ,CAAC,cAAc;YAChD,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM;SACjC;QACD,KAAK,EAAE;YACL,WAAW,EACT,sFAAsF;YACxF,WAAW,EAAE,CAAC;SACf;QACD,OAAO,EAAE,iCAAiC;QAC1C,UAAU,EAAE,wCAAwC;QACpD,mBAAmB,EAAE,gDAAgD;QACrE,UAAU,EAAE,6BAA6B;QACzC,aAAa,EAAE,EAAE;KAClB,CAAC;IACF,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC;AACrD,CAAC;AAED,sEAAsE;AACtE,SAAS,cAAc,CAAmB,CAAI;IAC5C,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAe,CAAC;AAChG,CAAC"}

package/dist/read/genres.d.ts

@@ -0,0 +1,7 @@
+import type { MisoClient } from "./client.ts";
+/**
+ * Resolve `Genre` object ids to display names. Best-effort: an id that fails to
+ * read is dropped rather than failing the artist page around it.
+ */
+export declare function resolveGenreNames(client: MisoClient, ids: string[]): Promise<string[]>;
+//# sourceMappingURL=genres.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"genres.d.ts","sourceRoot":"","sources":["../../src/read/genres.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAW9C;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAc5F"}

package/dist/read/genres.js

@@ -0,0 +1,38 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+//
+// Genre name resolution. `party.getGenres` returns `Genre` OBJECT IDS; each Genre
+// object carries a screaming-snake name ("HIP_HOP"). There is no id→name table
+// anywhere off-chain, so the names are read from the objects and humanized.
+/** "HIP_HOP" → "Hip Hop". */
+function humanize(name) {
+    return name
+        .split("_")
+        .filter(Boolean)
+        .map((w) => w.charAt(0) + w.slice(1).toLowerCase())
+        .join(" ");
+}
+/**
+ * Resolve `Genre` object ids to display names. Best-effort: an id that fails to
+ * read is dropped rather than failing the artist page around it.
+ */
+export async function resolveGenreNames(client, ids) {
+    if (ids.length === 0)
+        return [];
+    try {
+        const { objects } = await client.protocol.core.getObjects({ objectIds: ids, include: { json: true } });
+        const out = [];
+        for (const o of objects) {
+            if (o instanceof Error)
+                continue;
+            const name = o.json?.name;
+            if (typeof name === "string" && name)
+                out.push(humanize(name));
+        }
+        return out;
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=genres.js.map

package/dist/read/genres.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genres.js","sourceRoot":"","sources":["../../src/read/genres.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AACtC,EAAE;AACF,kFAAkF;AAClF,+EAA+E;AAC/E,4EAA4E;AAI5E,6BAA6B;AAC7B,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI;SACR,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAClD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAkB,EAAE,GAAa;IACvE,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACvG,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,YAAY,KAAK;gBAAE,SAAS;YACjC,MAAM,IAAI,GAAI,CAAC,CAAC,IAAkC,EAAE,IAAI,CAAC;YACzD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI;gBAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/read/index.d.ts

@@ -0,0 +1,14 @@
+export { createMisoClient } from "./client.ts";
+export type { MisoClient, CreateMisoClientOptions } from "./client.ts";
+export { misoConfig, networkFrom } from "./config.ts";
+export type { MisoConfig, MisoConfigOverrides, DiscoverSale, MoneyIds, Network, ProtocolIds, } from "./config.ts";
+export { currencyInfo, getDiscoverShelf, getListingView, getPressingDetail, getPressingView, getPressingSaleDetail, getPressingPreview, getRecordAlbum, getReleaseDetail, getReleaseResources, getTrackCredits, getSaleDetail, primaryArtistNames, readReleaseCover, } from "./catalog.ts";
+export type { GetRecordAlbumOptions, GetReleaseOptions, RecordAlbumInclude, ReleaseInclude, ReleaseResourceInclude, } from "./catalog.ts";
+export type { ReleaseResources } from "./catalog.ts";
+export { getArtistProfile, getPartySummaries, partyAvatarUrl, } from "./artist.ts";
+export type { ArtistInclude, GetArtistOptions } from "./artist.ts";
+export { resolveGenreNames } from "./genres.ts";
+export { getBalance, getOwnedParties, getPendingMemberships, getOwnedRecords, getOwnedWorks, getWorkByCap, ownsParty, ownsRecord, } from "./wallet.ts";
+export { breakdown, findRecordSale, findRecordSales, getPurchaseReceipt, getPurchaseReceipts, isRecordSoldEventType, recordSoldCurrencyType, } from "./receipts.ts";
+export type * from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/read/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEvE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtD,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EACL,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,YAAY,EACZ,SAAS,EACT,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,SAAS,EACT,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAEvB,mBAAmB,YAAY,CAAC"}

package/dist/read/index.js

@@ -0,0 +1,23 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+//
+// @misofm/platform/read — Miso's high-level platform read surface.
+//
+// One place that knows how to turn Sui objects into the things Miso talks about:
+// a pressing, a release, an artist, a library, a receipt. It composes
+// @misofm/protocol, owns the per-network id manifest, and returns view types that
+// survive JSON.
+//
+// Browser- and server-compatible. The HTTP API is a thin cached transport over
+// this same surface; direct clients can use it without going through the API.
+//
+//   const miso = createMisoClient({ network: "testnet" })
+//   const pressing = await getPressingDetail(miso, pressingId)
+export { createMisoClient } from "./client.js";
+export { misoConfig, networkFrom } from "./config.js";
+export { currencyInfo, getDiscoverShelf, getListingView, getPressingDetail, getPressingView, getPressingSaleDetail, getPressingPreview, getRecordAlbum, getReleaseDetail, getReleaseResources, getTrackCredits, getSaleDetail, primaryArtistNames, readReleaseCover, } from "./catalog.js";
+export { getArtistProfile, getPartySummaries, partyAvatarUrl, } from "./artist.js";
+export { resolveGenreNames } from "./genres.js";
+export { getBalance, getOwnedParties, getPendingMemberships, getOwnedRecords, getOwnedWorks, getWorkByCap, ownsParty, ownsRecord, } from "./wallet.js";
+export { breakdown, findRecordSale, findRecordSales, getPurchaseReceipt, getPurchaseReceipts, isRecordSoldEventType, recordSoldCurrencyType, } from "./receipts.js";
+//# sourceMappingURL=index.js.map

package/dist/read/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/read/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AACtC,EAAE;AACF,mEAAmE;AACnE,EAAE;AACF,iFAAiF;AACjF,sEAAsE;AACtE,kFAAkF;AAClF,gBAAgB;AAChB,EAAE;AACF,+EAA+E;AAC/E,8EAA8E;AAC9E,EAAE;AACF,0DAA0D;AAC1D,+DAA+D;AAE/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAUtD,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAUtB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EACL,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,YAAY,EACZ,SAAS,EACT,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,SAAS,EACT,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,eAAe,CAAC"}

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,CAQvD;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,57 @@
+// 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 >= 0n ? v.toString() : null;
+    if (typeof v === "number") {
+        return Number.isSafeInteger(v) && v >= 0 ? BigInt(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,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACzE,CAAC;IACD,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,6 @@
+export declare function u256ToB64Url(value: bigint | string): string;
+/** Build a blob URL with Walrus's non-strict default made explicit. */
+export declare function walrusBlobReadUrl(aggregator: string, blobId: 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":"AAaA,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAE3D;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GAAG,MAAM,GACtB,MAAM,CAGR;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,29 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+import { bcs } from "@mysten/sui/bcs";
+import { toBase64 } from "@mysten/sui/utils";
+import { walrusBlobIdFromU256 } from "../../mix.js";
+const u256 = bcs.u256();
+function toBase64Url(bytes) {
+    return toBase64(bytes).replace(/=*$/, "").replaceAll("+", "-").replaceAll("/", "_");
+}
+export function u256ToB64Url(value) {
+    return walrusBlobIdFromU256(value);
+}
+/** Build a blob URL with Walrus's non-strict default made explicit. */
+export function walrusBlobReadUrl(aggregator, blobId) {
+    const base = aggregator.replace(/\/$/, "");
+    return `${base}/v1/blobs/${u256ToB64Url(blobId)}?strict_consistency_check=false`;
+}
+/** 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;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,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,oBAAoB,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,iBAAiB,CAC/B,UAAkB,EAClB,MAAuB;IAEvB,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC3C,OAAO,GAAG,IAAI,aAAa,YAAY,CAAC,MAAM,CAAC,iCAAiC,CAAC;AACnF,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,41 @@
+import type { MisoClient } from "./client.ts";
+import type { PressingDetail, PurchaseReceipt, RecordSale, TrackRoyalty } from "./types.ts";
+export declare class MalformedRecordSoldEventError extends Error {
+    readonly name = "MalformedRecordSoldEventError";
+}
+/** Composition royalty rate (bps) per recording id. Sparse — an unresolved parent has no entry. */
+type CompositionRates = Record<string, number | undefined>;
+/**
+ * Whether `eventType` is this deployment's `listing::RecordSoldEvent<Currency>`.
+ *
+ * Event BCS is structural, so a same-shaped event from another package must never
+ * be decoded as a Miso sale. Normalize both package/type tags and require exactly
+ * one (possibly nested) currency type argument.
+ */
+export declare function recordSoldCurrencyType(eventType: string, recordShopPackageId: string): string | null;
+export declare function isRecordSoldEventType(eventType: string, recordShopPackageId: string): boolean;
+/**
+ * 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.
+ */
+export declare function findRecordSales(events: {
+    eventType: string;
+    bcs: Uint8Array;
+    json: Record<string, unknown> | null;
+}[], recordShopPackageId: string): RecordSale[];
+/** Select one canonical sale by its Record ID. Selection is always explicit. */
+export declare function findRecordSale(events: Parameters<typeof findRecordSales>[0], recordShopPackageId: string, recordId: string): RecordSale | null;
+/**
+ * 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[];
+/** Read and hydrate every canonical Record sale in transaction event order. */
+export declare function getPurchaseReceipts(client: MisoClient, txDigest: string): Promise<PurchaseReceipt[]>;
+/** Read one canonical receipt selected by its Record ID. Selection is mandatory:
+ * one transaction may purchase multiple Records from the same Pressing. */
+export declare function getPurchaseReceipt(client: MisoClient, txDigest: string, recordId: 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":"AA6BA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,OAAO,KAAK,EAAS,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAgBnG,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,SAAkB,IAAI,mCAAmC;CAC1D;AAED,mGAAmG;AACnG,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAsG3D;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,mBAAmB,EAAE,MAAM,GAC1B,MAAM,GAAG,IAAI,CAwBf;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,mBAAmB,EAAE,MAAM,GAC1B,OAAO,CAET;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE;IACN,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,UAAU,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACtC,EAAE,EACH,mBAAmB,EAAE,MAAM,GAC1B,UAAU,EAAE,CAgDd;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAC5B,MAAM,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC,EAC7C,mBAAmB,EAAE,MAAM,EAC3B,QAAQ,EAAE,MAAM,GACf,UAAU,GAAG,IAAI,CAKnB;AA6HD;;;;;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;AA+BD,+EAA+E;AAC/E,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,EAAE,CAAC,CAO5B;AAED;2EAC2E;AAC3E,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAKjC"}