@misofm/sdk 0.12.4 → 0.13.0

package/dist/publication.d.ts

@@ -0,0 +1,207 @@
+import type { MisoPlatformDeployment } from "./deployments.ts";
+import type { TxThunk } from "./transactions.ts";
+import { type ShareRecipient } from "./transactions.ts";
+import { type CompositionRole, type RecordingRole, type ReleaseRole } from "./credits.ts";
+import { type DspLink } from "./release-extensions.ts";
+import { type AdminCapAuthority } from "./vault.ts";
+import { type ListingPrice, type PressingRunState } from "./pressing.ts";
+import { type PlatformExecResult } from "./execute.ts";
+export declare const MAX_ATOMIC_PUBLICATION_COMMANDS = 900;
+export declare const MAX_ATOMIC_PUBLICATION_INPUTS = 2048;
+export interface PublicationCustody {
+    readonly kind: "direct" | "vault";
+    readonly owner: string;
+}
+export type PublicationParty = {
+    readonly ref: string;
+    readonly id: string;
+} | {
+    readonly ref: string;
+    readonly create: "individual" | "group";
+    readonly name: string;
+    readonly custody: PublicationCustody;
+    /** Defaults to true with Vault custody. */
+    readonly installWallet?: boolean;
+};
+export interface PublicationCompositionCredit {
+    readonly party: string;
+    readonly displayName: string;
+    readonly roles: CompositionRole[];
+}
+export interface PublicationRecordingCredit {
+    readonly party: string;
+    readonly displayName: string;
+    readonly roles: RecordingRole[];
+    readonly primaryArtist?: boolean;
+}
+export interface PublicationReleaseCredit {
+    readonly party: string;
+    readonly displayName: string;
+    readonly role: ReleaseRole;
+}
+export interface PublicationComposition {
+    readonly ref: string;
+    readonly shareType: string;
+    readonly shareCurrencyId: string;
+    readonly shareTreasuryCapId: string;
+    readonly title: string;
+    readonly royaltyRateBps: number;
+    readonly shareRecipients: ShareRecipient[];
+    readonly custody: PublicationCustody;
+    readonly credits?: PublicationCompositionCredit[];
+    readonly royaltyPool?: {
+        readonly currencyType: string;
+    };
+    readonly routedStake?: boolean;
+}
+type PublicationRecordingParent = {
+    readonly parentCompositionIndex: number;
+    readonly parentCompositionId?: never;
+} | {
+    readonly parentCompositionIndex?: never;
+    readonly parentCompositionId: string;
+};
+export type PublicationRecordingLanguages = {
+    readonly kind: "instrumental";
+} | {
+    readonly kind: "languages";
+    readonly codes: string[];
+};
+export type PublicationRecording = PublicationRecordingParent & {
+    readonly ref: string;
+    readonly shareType: string;
+    readonly shareCurrencyId: string;
+    readonly shareTreasuryCapId: string;
+    readonly compositionShareType: string;
+    readonly shareRecipients: ShareRecipient[];
+    readonly custody: PublicationCustody;
+    readonly credits?: PublicationRecordingCredit[];
+    readonly royaltyPool?: {
+        readonly currencyType: string;
+    };
+    readonly advisory?: "Explicit" | "NotExplicit" | "Cleaned";
+    readonly languages?: PublicationRecordingLanguages;
+    readonly masterReferenceBlobId?: bigint | string;
+    readonly previewBlobId?: bigint | string;
+};
+export interface PublicationFreshTrack {
+    readonly recordingIndex: number;
+    readonly splitBps: number;
+}
+export interface PublicationExistingTrack {
+    readonly recordingId: string;
+    readonly recordingShareType: string;
+    readonly compositionShareType: string;
+    readonly splitBps: number;
+    readonly authority: AdminCapAuthority;
+}
+export type PublicationTrack = PublicationFreshTrack | PublicationExistingTrack;
+export interface PublicationRelease {
+    readonly title: string;
+    readonly nonce: string;
+    readonly tracks: PublicationTrack[];
+    readonly custody: PublicationCustody;
+    readonly credits?: PublicationReleaseCredit[];
+    readonly kind?: string;
+    readonly description?: string;
+    readonly genres?: {
+        readonly primaryGenreId: string;
+        readonly secondaryGenreIds?: string[];
+        readonly tracks?: {
+            readonly trackIndex: number;
+            readonly genreId: string;
+        }[];
+    };
+    readonly dspLinks?: {
+        readonly release?: DspLink[];
+        readonly tracks?: {
+            readonly trackIndex: number;
+            readonly link: DspLink;
+        }[];
+    };
+    readonly cover?: {
+        readonly stillBlobId?: bigint | string;
+        readonly animatedBlobId?: bigint | string;
+        readonly tracks?: {
+            readonly trackIndex: number;
+            readonly stillBlobId: bigint | string;
+            readonly animatedBlobId?: bigint | string;
+        }[];
+    };
+    readonly revenueDistribution?: boolean;
+}
+export interface PublicationPressing {
+    readonly state?: PressingRunState;
+    readonly listings: {
+        readonly currencyType: string;
+        readonly price: ListingPrice;
+        readonly enabled?: boolean;
+    }[];
+    readonly custody: PublicationCustody;
+}
+export interface AtomicPublicationParams {
+    readonly deployment: MisoPlatformDeployment;
+    readonly parties: PublicationParty[];
+    readonly compositions: PublicationComposition[];
+    readonly recordings: PublicationRecording[];
+    readonly release?: PublicationRelease;
+    readonly pressing?: PublicationPressing;
+}
+/** Build the complete post-share catalog graph as one atomic PTB. */
+export declare function publishAtomicCatalog(p: AtomicPublicationParams): TxThunk;
+export interface AtomicPublicationInspection {
+    commands: number;
+    inputs: number;
+}
+/** Assemble without RPC access so callers can fail before publishing share packages. */
+export declare function inspectAtomicPublication(p: AtomicPublicationParams): AtomicPublicationInspection;
+export declare function assertAtomicPublicationBounds(p: AtomicPublicationParams): AtomicPublicationInspection;
+export type PublicationAuthorityOut = {
+    kind: "direct";
+    adminCapId: string;
+} | {
+    kind: "vault";
+    vaultId: string;
+    vaultAdminCapId: string;
+    capType: string;
+    vaultPackageId: string;
+};
+export interface AtomicPublicationResult {
+    digest: string;
+    gasUsed: number;
+    parties: Record<string, {
+        id: string;
+        adminCapId: string;
+        created: boolean;
+        authority?: PublicationAuthorityOut;
+    }>;
+    compositions: Record<string, {
+        id: string;
+        adminCapId: string;
+        shareType: string;
+        authority: PublicationAuthorityOut;
+        royaltyPoolId?: string;
+    }>;
+    recordings: Record<string, {
+        id: string;
+        adminCapId: string;
+        shareType: string;
+        compositionShareType: string;
+        authority: PublicationAuthorityOut;
+        royaltyPoolId?: string;
+    }>;
+    release?: {
+        id: string;
+        adminCapId: string;
+        authority: PublicationAuthorityOut;
+    };
+    pressing?: {
+        id: string;
+        adminCapId: string;
+        authority: PublicationAuthorityOut;
+    };
+}
+/** Parse one atomic publication using type identity plus lifecycle event payloads. */
+export declare function parseAtomicPublicationResult(p: AtomicPublicationParams, result: PlatformExecResult): AtomicPublicationResult;
+export {};
+//# sourceMappingURL=publication.d.ts.map

package/dist/publication.d.ts.map

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