@misofm/platform 0.0.0 → 0.19.0

package/dist/read/works.js

@@ -0,0 +1,191 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+import { normalizeSuiAddress } from "@mysten/sui/utils";
+import { contracts, extractTypeParams2, getCompositionsByIds, } from "@misofm/protocol";
+/** Resolve all work share types in one aliased GraphQL request. */
+export async function getWorkAddressesByShareTypes(client, shareTypes, misoPackageId) {
+    const compositions = [...new Set(shareTypes.compositions)];
+    const recordings = new Set(shareTypes.recordings);
+    const out = { compositions: {}, recordings: {} };
+    if (compositions.length === 0 && recordings.size === 0)
+        return out;
+    const declarations = [];
+    const selections = [];
+    const variables = {};
+    compositions.forEach((shareType, index) => {
+        const variable = `compositionType${index}`;
+        declarations.push(`$${variable}: String!`);
+        selections.push(`composition${index}: objects(first: 1, filter: { type: $${variable} }) { nodes { address } }`);
+        variables[variable] =
+            `${misoPackageId}::composition::Composition<${shareType}>`;
+    });
+    if (recordings.size > 0) {
+        declarations.push("$recordingType: String!");
+        selections.push(`recordings: objects(first: 50, filter: { type: $recordingType }) {
+      pageInfo { hasNextPage endCursor }
+      nodes { address asMoveObject { contents { type { repr } } } }
+    }`);
+        variables.recordingType = `${misoPackageId}::recording::Recording`;
+    }
+    const result = await client.query({
+        query: `query WorkAddressesByShareTypes(${declarations.join(", ")}) {
+      ${selections.join("\n")}
+    }`,
+        variables,
+    });
+    if (result.errors?.length) {
+        throw new AggregateError(result.errors.map((error) => new Error(error.message)), "Work type discovery failed");
+    }
+    compositions.forEach((shareType, index) => {
+        const address = result.data?.[`composition${index}`]?.nodes[0]?.address;
+        if (address)
+            out.compositions[shareType] = address;
+    });
+    const readRecordingPage = (page) => {
+        for (const node of page?.nodes ?? []) {
+            const repr = node.asMoveObject?.contents?.type?.repr;
+            if (!repr)
+                continue;
+            try {
+                const [shareType] = extractTypeParams2(repr);
+                if (recordings.has(shareType))
+                    out.recordings[shareType] = node.address;
+            }
+            catch {
+                // Ignore objects whose deployed type does not match the Recording ABI.
+            }
+        }
+    };
+    let page = result.data?.recordings;
+    readRecordingPage(page);
+    while (page?.pageInfo?.hasNextPage &&
+        page.pageInfo.endCursor &&
+        Object.keys(out.recordings).length < recordings.size) {
+        const next = await client.query({
+            query: `query RecordingWorkAddresses($recordingType: String!, $cursor: String!) {
+        recordings: objects(first: 50, after: $cursor, filter: { type: $recordingType }) {
+          pageInfo { hasNextPage endCursor }
+          nodes { address asMoveObject { contents { type { repr } } } }
+        }
+      }`,
+            variables: {
+                recordingType: variables.recordingType,
+                cursor: page.pageInfo.endCursor,
+            },
+        });
+        if (next.errors?.length) {
+            throw new AggregateError(next.errors.map((error) => new Error(error.message)), "Recording type discovery failed");
+        }
+        page = next.data?.recordings;
+        readRecordingPage(page);
+    }
+    return out;
+}
+function workState(value) {
+    return value?.$kind === "Published"
+        ? { type: "Published", timestampMs: Number(value.Published) }
+        : { type: "Initialized" };
+}
+function parseComposition(id, content) {
+    const value = contracts.composition.Composition.parse(content);
+    return {
+        id,
+        state: workState(value.state),
+        title: String(value.title),
+        royaltyRate: {
+            value: Number(Array.isArray(value.royalty_rate)
+                ? value.royalty_rate[0]
+                : value.royalty_rate),
+        },
+    };
+}
+function parseRecording(id, content) {
+    const value = contracts.recording.Recording.parse(content);
+    return {
+        id,
+        state: workState(value.state),
+        compositionId: String(value.composition_id),
+    };
+}
+export function parseReleaseObject(id, content) {
+    const value = contracts.release.Release.parse(content);
+    return {
+        id,
+        state: workState(value.state),
+        title: String(value.title),
+        tracks: (value.tracks ?? []).map((track) => ({
+            state: (track.state?.$kind ?? "Unassigned"),
+            compositionId: String(track.composition_id),
+            recordingId: String(track.recording_id),
+            splitBps: {
+                value: Number(Array.isArray(track.split_bps) ? track.split_bps[0] : track.split_bps),
+            },
+        })),
+    };
+}
+/** Fetch and parse heterogeneous works through one Core bulk request. */
+export async function getWorksByIds(client, ids) {
+    const kinds = new Map();
+    for (const [kind, objectIds] of Object.entries(ids)) {
+        for (const objectId of objectIds) {
+            const normalized = normalizeSuiAddress(objectId);
+            const previous = kinds.get(normalized);
+            if (previous && previous !== kind) {
+                throw new Error(`Work ${normalized} was requested as both ${previous} and ${kind}`);
+            }
+            kinds.set(normalized, kind);
+        }
+    }
+    const out = { compositions: {}, recordings: {}, releases: {} };
+    if (kinds.size === 0)
+        return out;
+    const { objects } = await client.core.getObjects({
+        objectIds: [...kinds.keys()],
+        include: { content: true },
+    });
+    for (const object of objects) {
+        if (object instanceof Error || !object.content)
+            continue;
+        const kind = kinds.get(normalizeSuiAddress(object.objectId));
+        if (kind === "compositions")
+            out.compositions[object.objectId] = parseComposition(object.objectId, object.content);
+        else if (kind === "recordings")
+            out.recordings[object.objectId] = parseRecording(object.objectId, object.content);
+        else if (kind === "releases")
+            out.releases[object.objectId] = parseReleaseObject(object.objectId, object.content);
+    }
+    return out;
+}
+/** Resolve recording titles through each recording's canonical composition type. */
+export async function getRecordingTitles(client, graphql, recordingIds, misoPackageId) {
+    const ids = [...new Set(recordingIds)];
+    if (ids.length === 0)
+        return {};
+    const { objects } = await client.core.getObjects({
+        objectIds: ids,
+        include: {},
+    });
+    const titles = {};
+    const compositionShareByRecording = {};
+    for (const object of objects) {
+        if (object instanceof Error)
+            continue;
+        const [, compositionShareType] = extractTypeParams2(object.type);
+        compositionShareByRecording[object.objectId] = compositionShareType;
+    }
+    const compositionShareTypes = Object.values(compositionShareByRecording);
+    if (compositionShareTypes.length === 0)
+        return titles;
+    const addresses = await getWorkAddressesByShareTypes(graphql, { compositions: compositionShareTypes, recordings: [] }, misoPackageId);
+    const compositions = await getCompositionsByIds(client, Object.values(addresses.compositions).filter((id) => !!id));
+    for (const [recordingId, shareType] of Object.entries(compositionShareByRecording)) {
+        const compositionId = addresses.compositions[shareType];
+        const title = compositionId
+            ? compositions[compositionId]?.title
+            : undefined;
+        if (title)
+            titles[recordingId] = title;
+    }
+    return titles;
+}
+//# sourceMappingURL=works.js.map

package/dist/read/works.js.map

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

package/dist/recording-extensions.d.ts

@@ -0,0 +1,58 @@
+import type { ClientWithCoreApi } from "@mysten/sui/client";
+import type { TransactionArgument } from "@mysten/sui/transactions";
+import type { TxThunk } from "./transactions.ts";
+import { type AdminCapAuthority, type ObjectInput } from "./vault.ts";
+export interface RecordingExtensionTarget {
+    readonly recordingId: ObjectInput;
+    readonly authority: AdminCapAuthority;
+    readonly recordingShareType: string;
+    readonly compositionShareType: string;
+}
+type Rating = "Explicit" | "NotExplicit" | "Cleaned";
+export interface SetRecordingAdvisoryParams extends RecordingExtensionTarget {
+    readonly recordingAdvisoryPackageId: string;
+    readonly rating: Rating;
+}
+export declare function setRecordingAdvisory(p: SetRecordingAdvisoryParams): TxThunk;
+export interface SetRecordingLanguagesParams extends RecordingExtensionTarget {
+    readonly recordingLanguagePackageId: string;
+    /** A vector<LanguageCode> built by the language-code package in this PTB. */
+    readonly languages: TransactionArgument;
+}
+export declare function setRecordingLanguages(p: SetRecordingLanguagesParams): TxThunk;
+export declare function setRecordingInstrumental(p: Omit<SetRecordingLanguagesParams, "languages">): TxThunk;
+interface RecordingWalrusReferenceParams extends RecordingExtensionTarget {
+    /** An ori::WalrusData value assembled in the same PTB (must be a standalone blob on chain). */
+    readonly reference: TransactionArgument;
+}
+export interface SetRecordingMasterReferenceParams extends RecordingWalrusReferenceParams {
+    readonly recordingMasterReferencePackageId: string;
+}
+export declare function setRecordingMasterReference(p: SetRecordingMasterReferenceParams): TxThunk;
+export interface SetRecordingStreamingTranscodeParams extends RecordingExtensionTarget {
+    readonly recordingStreamingTranscodePackageId: string;
+    /** External `ori` package used to construct the complete Walrus Quilt reference. */
+    readonly oriPackageId: string;
+    /** Complete Walrus Quilt ID as its on-chain `u256` value. */
+    readonly quiltId: bigint | string;
+}
+/** Sets or replaces the complete streaming-transcode Quilt attached to a Recording. */
+export declare function setRecordingStreamingTranscode(p: SetRecordingStreamingTranscodeParams): TxThunk;
+export type UnsetRecordingStreamingTranscodeParams = Omit<SetRecordingStreamingTranscodeParams, "oriPackageId" | "quiltId">;
+/** Removes the Recording's streaming-transcode reference, if present. */
+export declare function unsetRecordingStreamingTranscode(p: UnsetRecordingStreamingTranscodeParams): TxThunk;
+/** Parse an attached master reference's standalone Walrus blob id. */
+export declare function parseRecordingMasterReferenceContent(content: Uint8Array): string | null;
+/** Deterministic dynamic-field id for a Recording's master reference. */
+export declare function recordingMasterReferenceFieldId(recordingId: string, recordingMasterReferencePackageId: string): string;
+/** Read one Recording's master-reference blob id, or null when absent. */
+export declare function getRecordingMasterReference(client: ClientWithCoreApi, recordingId: string, recordingMasterReferencePackageId: string): Promise<string | null>;
+/**
+ * Read master-reference blob ids for many Recordings in one Core request.
+ *
+ * Missing fields and malformed individual objects are omitted so one Recording
+ * without a playable master cannot make the rest of an album unplayable.
+ */
+export declare function getRecordingMasterReferencesByIds(client: ClientWithCoreApi, recordingIdsInput: readonly string[], recordingMasterReferencePackageId: string): Promise<Partial<Record<string, string>>>;
+export {};
+//# sourceMappingURL=recording-extensions.d.ts.map

package/dist/recording-extensions.d.ts.map

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

package/dist/recording-extensions.js

@@ -0,0 +1,148 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+/** Cap-authorized builders and reads for data-only Recording metadata extensions. */
+import { bcs } from "@mysten/sui/bcs";
+import { deriveDynamicFieldID } from "@mysten/sui/utils";
+import { invokeWithAdminCap } from "./vault.js";
+import * as advisory from "@misofm/protocol/contracts/recording_advisory/recording_advisory";
+import * as language from "@misofm/protocol/contracts/recording_language/recording_language";
+import * as walrusData from "@misofm/protocol/contracts/recording_master_reference/deps/ori/walrus_data";
+import * as masterReference from "@misofm/protocol/contracts/recording_master_reference/recording_master_reference";
+import * as streamingTranscode from "@misofm/protocol/contracts/recording_streaming_transcode/recording_streaming_transcode";
+function object(tx, value) {
+    return typeof value === "string" ? tx.object(value) : value;
+}
+export function setRecordingAdvisory(p) {
+    return (tx) => {
+        const rating = tx.add(p.rating === "Explicit" ? advisory.explicit({ package: p.recordingAdvisoryPackageId })
+            : p.rating === "NotExplicit" ? advisory.notExplicit({ package: p.recordingAdvisoryPackageId })
+                : advisory.cleaned({ package: p.recordingAdvisoryPackageId }));
+        invokeWithAdminCap(tx, p.authority, {
+            target: `${p.recordingAdvisoryPackageId}::recording_advisory::set_rating`,
+            typeArguments: [p.recordingShareType, p.compositionShareType],
+            arguments: [object(tx, p.recordingId), rating],
+            adminCapIndex: 1,
+        });
+    };
+}
+export function setRecordingLanguages(p) {
+    return (tx) => {
+        invokeWithAdminCap(tx, p.authority, {
+            target: `${p.recordingLanguagePackageId}::recording_language::set_languages`,
+            typeArguments: [p.recordingShareType, p.compositionShareType],
+            arguments: [object(tx, p.recordingId), p.languages],
+            adminCapIndex: 1,
+        });
+    };
+}
+export function setRecordingInstrumental(p) {
+    return (tx) => {
+        invokeWithAdminCap(tx, p.authority, {
+            target: `${p.recordingLanguagePackageId}::recording_language::set_instrumental`,
+            typeArguments: [p.recordingShareType, p.compositionShareType],
+            arguments: [object(tx, p.recordingId)],
+            adminCapIndex: 1,
+        });
+    };
+}
+export function setRecordingMasterReference(p) {
+    return (tx) => {
+        invokeWithAdminCap(tx, p.authority, {
+            target: `${p.recordingMasterReferencePackageId}::recording_master_reference::set_master_reference`,
+            typeArguments: [p.recordingShareType, p.compositionShareType],
+            arguments: [object(tx, p.recordingId), p.reference],
+            adminCapIndex: 1,
+        });
+    };
+}
+/** Sets or replaces the complete streaming-transcode Quilt attached to a Recording. */
+export function setRecordingStreamingTranscode(p) {
+    return (tx) => {
+        const quilt = tx.moveCall({
+            target: `${p.oriPackageId}::data::new_quilt`,
+            arguments: [tx.pure.u256(p.quiltId)],
+        });
+        const transcode = tx.add(streamingTranscode._new({
+            package: p.recordingStreamingTranscodePackageId,
+            arguments: [quilt],
+        }));
+        invokeWithAdminCap(tx, p.authority, {
+            target: `${p.recordingStreamingTranscodePackageId}::recording_streaming_transcode::set_streaming_transcode`,
+            typeArguments: [p.recordingShareType, p.compositionShareType],
+            arguments: [object(tx, p.recordingId), transcode],
+            adminCapIndex: 1,
+        });
+    };
+}
+/** Removes the Recording's streaming-transcode reference, if present. */
+export function unsetRecordingStreamingTranscode(p) {
+    return (tx) => {
+        invokeWithAdminCap(tx, p.authority, {
+            target: `${p.recordingStreamingTranscodePackageId}::recording_streaming_transcode::unset_streaming_transcode`,
+            typeArguments: [p.recordingShareType, p.compositionShareType],
+            arguments: [object(tx, p.recordingId)],
+            adminCapIndex: 1,
+        });
+    };
+}
+// ── Master-reference reads ───────────────────────────────────────────────────
+// recording_master_reference stores the ori::WalrusData value inline in a
+// dynamic field on the Recording. Its empty ExtensionKey serializes to one false
+// byte, so the field object id can be derived without listing the Recording's
+// dynamic fields.
+const MasterReferenceField = bcs.struct("Field", {
+    id: bcs.Address,
+    name: masterReference.ExtensionKey,
+    value: walrusData.WalrusData,
+});
+const MASTER_REFERENCE_KEY_BYTES = masterReference.ExtensionKey.serialize([
+    false,
+]).toBytes();
+/** Parse an attached master reference's standalone Walrus blob id. */
+export function parseRecordingMasterReferenceContent(content) {
+    const reference = MasterReferenceField.parse(content).value;
+    return reference.$kind === "Blob" ? String(reference.Blob[0]) : null;
+}
+/** Deterministic dynamic-field id for a Recording's master reference. */
+export function recordingMasterReferenceFieldId(recordingId, recordingMasterReferencePackageId) {
+    return deriveDynamicFieldID(recordingId, `${recordingMasterReferencePackageId}::recording_master_reference::ExtensionKey`, MASTER_REFERENCE_KEY_BYTES);
+}
+/** Read one Recording's master-reference blob id, or null when absent. */
+export async function getRecordingMasterReference(client, recordingId, recordingMasterReferencePackageId) {
+    return ((await getRecordingMasterReferencesByIds(client, [recordingId], recordingMasterReferencePackageId))[recordingId] ?? null);
+}
+/**
+ * Read master-reference blob ids for many Recordings in one Core request.
+ *
+ * Missing fields and malformed individual objects are omitted so one Recording
+ * without a playable master cannot make the rest of an album unplayable.
+ */
+export async function getRecordingMasterReferencesByIds(client, recordingIdsInput, recordingMasterReferencePackageId) {
+    const recordingIds = [...new Set(recordingIdsInput)];
+    const targets = recordingIds.map((recordingId) => ({
+        recordingId,
+        fieldId: recordingMasterReferenceFieldId(recordingId, recordingMasterReferencePackageId),
+    }));
+    if (targets.length === 0)
+        return {};
+    const { objects } = await client.core.getObjects({
+        objectIds: targets.map((target) => target.fieldId),
+        include: { content: true },
+    });
+    const out = {};
+    objects.forEach((object, index) => {
+        const target = targets[index];
+        if (!target || object instanceof Error || !object.content)
+            return;
+        try {
+            const blobId = parseRecordingMasterReferenceContent(object.content);
+            if (blobId)
+                out[target.recordingId] = blobId;
+        }
+        catch {
+            // Extension metadata is soft: retain valid tracks when one field is stale.
+        }
+    });
+    return out;
+}
+//# sourceMappingURL=recording-extensions.js.map

package/dist/recording-extensions.js.map

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

package/dist/release-extensions.d.ts

@@ -0,0 +1,93 @@
+import type { ClientWithCoreApi } from "@mysten/sui/client";
+import type { TxThunk } from "./transactions.ts";
+import { type AdminCapAuthority, type ObjectInput, type U64Input } from "./vault.ts";
+type ReleaseAuthorityInput = {
+    readonly authority: AdminCapAuthority;
+    readonly releaseAdminCapId?: never;
+} | {
+    readonly authority?: never;
+    readonly releaseAdminCapId: string;
+};
+interface ReleaseExtensionTargetBase {
+    releaseId: ObjectInput;
+}
+export type ReleaseExtensionTarget = ReleaseExtensionTargetBase & ReleaseAuthorityInput;
+export type SetReleaseKindParams = ReleaseExtensionTarget & {
+    kind: string;
+    releaseKindPackageId: string;
+};
+/** Attach the release's self-declared kind (for example "EP" or "Mixtape"). */
+export declare function setReleaseKind(p: SetReleaseKindParams): TxThunk;
+/** Deterministic dynamic-field id for a Release's optional self-declared kind. */
+export declare function releaseKindFieldId(releaseId: string, releaseKindPackageId: string): string;
+/** Parse the dynamic field storing `Option<String>` as its present string. */
+export declare function parseReleaseKindContent(content: Uint8Array): string;
+/** Read a Release's self-declared kind, or `null` when the extension is absent. */
+export declare function getReleaseKind(client: ClientWithCoreApi, releaseId: string, releaseKindPackageId: string): Promise<string | null>;
+export type SetReleaseDescriptionParams = ReleaseExtensionTarget & {
+    description: string;
+    releaseDescriptionPackageId: string;
+};
+/** Attach the release's editorial description. */
+export declare function setReleaseDescription(p: SetReleaseDescriptionParams): TxThunk;
+/** Validate the canonical on-chain genre vocabulary spelling. */
+export declare function assertCanonicalGenreName(name: string): void;
+/** Derive the immutable Genre object address for a canonical vocabulary name.
+ * `genrePackageId` must be the genre package's defining (original publish)
+ * address — the on-chain derivation hashes type names with defining IDs. */
+export declare function deriveGenreAddress(genreRegistryId: string, genrePackageId: string, canonicalName: string): string;
+export interface TrackGenreAssignment {
+    trackIndex: U64Input;
+    genreId: string;
+}
+export type SetReleaseGenresParams = ReleaseExtensionTarget & {
+    primaryGenreId: string;
+    secondaryGenreIds?: readonly string[];
+    trackPrimaryGenres?: readonly TrackGenreAssignment[];
+    releaseGenrePackageId: string;
+};
+/** Attach primary/secondary release genres and optional per-track overrides. */
+export declare function setReleaseGenres(p: SetReleaseGenresParams): TxThunk;
+export type DspLink = {
+    platform: "Spotify";
+    id: string;
+} | {
+    platform: "AppleMusic";
+    storefront: string;
+    albumId: string;
+    trackId?: string;
+} | {
+    platform: "AmazonMusic";
+    albumId: string;
+    trackId?: string;
+} | {
+    platform: "Bandcamp";
+    subdomain: string;
+    slug: string;
+} | {
+    platform: "Deezer";
+    id: string;
+} | {
+    platform: "SoundCloud";
+    user: string;
+    slug: string;
+} | {
+    platform: "Tidal";
+    id: string;
+} | {
+    platform: "YouTubeMusic";
+    id: string;
+};
+export interface TrackDspLink {
+    trackIndex: U64Input;
+    link: DspLink;
+}
+export type SetReleaseDspLinksParams = ReleaseExtensionTarget & {
+    releaseLinks?: readonly DspLink[];
+    trackLinks?: readonly TrackDspLink[];
+    releaseDspLinkPackageId: string;
+};
+/** Attach release-level and per-track DSP links. */
+export declare function setReleaseDspLinks(p: SetReleaseDspLinksParams): TxThunk;
+export {};
+//# sourceMappingURL=release-extensions.d.ts.map

package/dist/release-extensions.d.ts.map

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