@misonetwork/sdk 0.8.0 → 0.9.0

package/dist/party/queries.js

@@ -0,0 +1,232 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+import { deriveDynamicFieldID, deriveObjectID } from "@mysten/sui/utils";
+import { bcs } from "@mysten/sui/bcs";
+import { fromBase64 } from "@mysten/sui/utils";
+import { MembershipKey as MembershipKeyBcs, Party as PartyBcs, PendingInviteKey as PendingInviteKeyBcs, PendingMembershipKey as PendingMembershipKeyBcs, } from "../contracts/miso_party/party.js";
+import { Profile as ProfileBcs, ProfileKey as ProfileKeyBcs } from "../contracts/party_profile/party_profile.js";
+import { Media as MediaBcs, MediaKey as MediaKeyBcs } from "../contracts/party_media/party_media.js";
+import { ArtistRole as ArtistRoleBcs, RolesKey as RolesKeyBcs } from "../contracts/party_roles/party_roles.js";
+import { TagsKey as TagsKeyBcs } from "../contracts/party_tags/party_tags.js";
+import { GenresKey as GenresKeyBcs } from "../contracts/party_genre/party_genre.js";
+import { Cta as CtaBcs, CtasKey as CtasKeyBcs } from "../contracts/party_cta/party_cta.js";
+import { mapCtas, mapGenres, mapMedia, mapParty, mapProfile, mapRoles, mapTags } from "./internal.js";
+import { buildLink, platformForDataType } from "./extensions/links.js";
+/** True for the Core API's "object does not exist" error (a missing dynamic field). */
+function isNotFound(e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    return /not\s*found|does not exist|no object/i.test(msg);
+}
+// A missing object (e.g. an unset profile/media dynamic field) surfaces as a
+// thrown "not found" from the Core API, not an empty result — treat it as null
+// so optional extensions read cleanly.
+async function getContent(client, objectId) {
+    try {
+        const { object } = await client.core.getObject({ objectId, include: { content: true } });
+        return object?.content ?? null;
+    }
+    catch (e) {
+        if (isNotFound(e))
+            return null;
+        throw e;
+    }
+}
+/** Fetches and parses a shared `Party` object. */
+export async function getPartyById(client, partyId) {
+    const content = await getContent(client, partyId);
+    if (!content)
+        throw new Error(`Party not found: ${partyId}`);
+    return mapParty(partyId, PartyBcs.parse(content));
+}
+/** Fetches and parses multiple shared `Party` objects in one Core request. */
+export async function getPartiesByIds(client, partyIds) {
+    if (partyIds.length === 0)
+        return {};
+    const { objects } = await client.core.getObjects({
+        objectIds: [...new Set(partyIds)],
+        include: { content: true },
+    });
+    const parties = {};
+    for (const obj of objects) {
+        if (obj instanceof Error)
+            continue;
+        parties[obj.objectId] = mapParty(obj.objectId, PartyBcs.parse(obj.content));
+    }
+    return parties;
+}
+/** Derives a party's `PartyAdminCap` id (it is a `derived_object` off the party UID). */
+export function derivePartyAdminCapId(partyId, partyPackageId) {
+    return deriveObjectID(partyId, `${partyPackageId}::party::PartyAdminCapKey`, bcs.Address.serialize(partyId).toBytes());
+}
+// The profile is a dynamic field on the party UID under an empty `ProfileKey()`
+// (Move's implicit `dummy_field: bool` → one zero byte).
+const ProfileField = bcs.struct("Field", { id: bcs.Address, name: ProfileKeyBcs, value: ProfileBcs });
+const PROFILE_KEY_BYTES = ProfileKeyBcs.serialize([false]).toBytes();
+/** Fetches a party's profile, or null if none is set. */
+export async function getProfile(client, partyId, partyProfilePackageId) {
+    const fieldId = deriveDynamicFieldID(partyId, `${partyProfilePackageId}::party_profile::ProfileKey`, PROFILE_KEY_BYTES);
+    const content = await getContent(client, fieldId);
+    if (!content)
+        return null;
+    return mapProfile(partyId, ProfileField.parse(content).value);
+}
+// Media is a dynamic field on the party UID under an empty `MediaKey()` (same
+// implicit `dummy_field: bool` → one zero byte as the profile key).
+const MediaField = bcs.struct("Field", { id: bcs.Address, name: MediaKeyBcs, value: MediaBcs });
+const MEDIA_KEY_BYTES = MediaKeyBcs.serialize([false]).toBytes();
+/** Fetches a party's media (avatar + header), or null if none is set. */
+export async function getMedia(client, partyId, partyMediaPackageId) {
+    const fieldId = deriveDynamicFieldID(partyId, `${partyMediaPackageId}::party_media::MediaKey`, MEDIA_KEY_BYTES);
+    const content = await getContent(client, fieldId);
+    if (!content)
+        return null;
+    return mapMedia(partyId, MediaField.parse(content).value);
+}
+// === Collection extension reads (roles / tags / genres / ctas) ===
+//
+// Each is a single dynamic field on the party UID under an empty positional key
+// (Move's implicit `dummy_field: bool` → one zero byte, same as the profile key).
+const ROLES_KEY_BYTES = RolesKeyBcs.serialize([false]).toBytes();
+const RolesField = bcs.struct("Field", { id: bcs.Address, name: RolesKeyBcs, value: bcs.vector(ArtistRoleBcs) });
+/** The party's artist-type roles (display names), or `[]` if none are set. */
+export async function getRoles(client, partyId, partyRolesPackageId) {
+    const fieldId = deriveDynamicFieldID(partyId, `${partyRolesPackageId}::party_roles::RolesKey`, ROLES_KEY_BYTES);
+    const content = await getContent(client, fieldId);
+    if (!content)
+        return [];
+    return mapRoles(RolesField.parse(content).value);
+}
+const TAGS_KEY_BYTES = TagsKeyBcs.serialize([false]).toBytes();
+const TagsField = bcs.struct("Field", { id: bcs.Address, name: TagsKeyBcs, value: bcs.vector(bcs.string()) });
+/** The party's free-form tags, or `[]` if none are set. */
+export async function getTags(client, partyId, partyTagsPackageId) {
+    const fieldId = deriveDynamicFieldID(partyId, `${partyTagsPackageId}::party_tags::TagsKey`, TAGS_KEY_BYTES);
+    const content = await getContent(client, fieldId);
+    if (!content)
+        return [];
+    return mapTags(TagsField.parse(content).value);
+}
+const GENRES_KEY_BYTES = GenresKeyBcs.serialize([false]).toBytes();
+const GenresField = bcs.struct("Field", { id: bcs.Address, name: GenresKeyBcs, value: bcs.vector(bcs.Address) });
+/** The party's genre object ids, or `[]` if none are set. */
+export async function getGenres(client, partyId, partyGenrePackageId) {
+    const fieldId = deriveDynamicFieldID(partyId, `${partyGenrePackageId}::party_genre::GenresKey`, GENRES_KEY_BYTES);
+    const content = await getContent(client, fieldId);
+    if (!content)
+        return [];
+    return mapGenres(GenresField.parse(content).value);
+}
+const CTAS_KEY_BYTES = CtasKeyBcs.serialize([false]).toBytes();
+// The CTA field's value is a bare `vector<Cta>` (not a wrapper struct).
+const CtasField = bcs.struct("Field", { id: bcs.Address, name: CtasKeyBcs, value: bcs.vector(CtaBcs) });
+/** The party's ordered CTA list (position is priority), or `[]` if none is set. */
+export async function getCtas(client, partyId, partyCtaPackageId) {
+    const fieldId = deriveDynamicFieldID(partyId, `${partyCtaPackageId}::party_cta::CtasKey`, CTAS_KEY_BYTES);
+    const content = await getContent(client, fieldId);
+    if (!content)
+        return [];
+    return mapCtas(CtasField.parse(content).value);
+}
+// === Platform-link reads ===
+//
+// Each platform is an independent `PlatformLink<Data>` dynamic field keyed by
+// `platform_link::PlatformLinkKey<Data>`. There is no single key to derive, so
+// enumerate the party's dynamic fields and pick out the platform-link ones,
+// identifying the platform from the `Data` type argument. Every payload `Data`
+// type is a single-`String` newtype, so `PlatformLink<Data>` serializes exactly
+// as one BCS string — parse the field value as such.
+const PlatformLinkField = bcs.struct("Field", { id: bcs.Address, name: bcs.bool(), value: bcs.string() });
+const PLATFORM_LINK_KEY_RE = /::platform_link::PlatformLinkKey<(.+)>$/;
+/** All external-platform links attached to a party (social, music, professional). */
+export async function getLinks(client, partyId) {
+    const links = [];
+    let cursor;
+    do {
+        const page = await client.core.listDynamicFields({ parentId: partyId, cursor: cursor ?? undefined });
+        for (const f of page.dynamicFields) {
+            if (typeof f.name?.type !== "string")
+                continue;
+            const match = f.name.type.match(PLATFORM_LINK_KEY_RE);
+            const dataType = match?.[1];
+            if (!dataType)
+                continue;
+            const platform = platformForDataType(dataType);
+            if (!platform)
+                continue;
+            const content = await getContent(client, f.fieldId);
+            if (!content)
+                continue;
+            links.push(buildLink(platform, PlatformLinkField.parse(content).value));
+        }
+        cursor = page.hasNextPage ? page.cursor : null;
+    } while (cursor);
+    return links;
+}
+// === Group membership reads ===
+/** Normalizes a dynamic-field key's BCS bytes (Uint8Array or base64 string). */
+function keyBytes(bcs) {
+    return typeof bcs === "string" ? fromBase64(bcs) : bcs;
+}
+/**
+ * The group ids a party currently belongs to, read from its `MembershipKey`
+ * dynamic fields (the member-side record). No indexer required.
+ */
+export async function getMemberships(client, partyId) {
+    const groups = [];
+    let cursor;
+    do {
+        const page = await client.core.listDynamicFields({ parentId: partyId, cursor: cursor ?? undefined });
+        for (const f of page.dynamicFields) {
+            if (typeof f.name?.type === "string" && f.name.type.endsWith("::party::MembershipKey") && f.name.bcs != null) {
+                const [groupId] = MembershipKeyBcs.parse(keyBytes(f.name.bcs));
+                groups.push(String(groupId));
+            }
+        }
+        cursor = page.hasNextPage ? page.cursor : null;
+    } while (cursor);
+    return groups;
+}
+/** The member ids invited to a group but not yet accepted (its `PendingInviteKey` fields). */
+export async function getPendingInvites(client, groupId) {
+    const members = [];
+    let cursor;
+    do {
+        const page = await client.core.listDynamicFields({ parentId: groupId, cursor: cursor ?? undefined });
+        for (const f of page.dynamicFields) {
+            if (typeof f.name?.type === "string" && f.name.type.endsWith("::party::PendingInviteKey") && f.name.bcs != null) {
+                const [memberId] = PendingInviteKeyBcs.parse(keyBytes(f.name.bcs));
+                members.push(String(memberId));
+            }
+        }
+        cursor = page.hasNextPage ? page.cursor : null;
+    } while (cursor);
+    return members;
+}
+/**
+ * The group ids that have invited a party but are still awaiting its response.
+ * This reads the member-side `PendingMembershipKey` inbox index, so it only
+ * enumerates the target party's dynamic fields.
+ */
+export async function getPendingMemberships(client, partyId) {
+    const groups = [];
+    let cursor;
+    do {
+        const page = await client.core.listDynamicFields({ parentId: partyId, cursor: cursor ?? undefined });
+        for (const f of page.dynamicFields) {
+            if (typeof f.name?.type === "string" &&
+                f.name.type.endsWith("::party::PendingMembershipKey") &&
+                f.name.bcs != null) {
+                const [groupId] = PendingMembershipKeyBcs.parse(keyBytes(f.name.bcs));
+                groups.push(String(groupId));
+            }
+        }
+        cursor = page.hasNextPage ? page.cursor : null;
+    } while (cursor);
+    return groups;
+}
+/** Whether `memberId` currently holds a membership record for `groupId`. */
+export async function isMember(client, memberId, groupId, partyPackageId) {
+    const fieldId = deriveDynamicFieldID(memberId, `${partyPackageId}::party::MembershipKey`, MembershipKeyBcs.serialize([groupId]).toBytes());
+    return (await getContent(client, fieldId)) !== null;
+}
+//# sourceMappingURL=queries.js.map

package/dist/party/queries.js.map

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

package/dist/party/transactions.d.ts

@@ -0,0 +1,74 @@
+import type { Transaction } from "@mysten/sui/transactions";
+export type TxThunk = (tx: Transaction) => void | Promise<void>;
+export interface CreatePartyParams {
+    /** Human-readable party name (not verified; app-layer verifies). */
+    name: string;
+    /** Address that receives the PartyAdminCap. */
+    recipient: string;
+    partyPackageId: string;
+}
+/** Creates an individual party, shares it, and transfers its admin cap to `recipient`. */
+export declare function createIndividualParty(params: CreatePartyParams): TxThunk;
+/** Creates a group party (empty member set), shares it, transfers its admin cap. */
+export declare function createGroupParty(params: CreatePartyParams): TxThunk;
+export interface InvitePartyParams {
+    groupId: string;
+    groupCapId: string;
+    /** The individual party (shared object id) to invite. */
+    memberId: string;
+    partyPackageId: string;
+}
+/** Invites an individual party to a group (gated by the group's admin cap). */
+export declare function inviteParty(params: InvitePartyParams): TxThunk;
+export interface AcceptInviteParams {
+    groupId: string;
+    memberId: string;
+    /** The member party's admin cap id (proves consent). */
+    memberCapId: string;
+    partyPackageId: string;
+}
+/** Accepts a pending invite, joining the member to the group (member's cap). */
+export declare function acceptInvite(params: AcceptInviteParams): TxThunk;
+export interface DeclineInviteParams {
+    groupId: string;
+    /** The invited individual party (shared object id). */
+    memberId: string;
+    memberCapId: string;
+    partyPackageId: string;
+}
+/** Declines a pending invite (member's cap). */
+export declare function declineInvite(params: DeclineInviteParams): TxThunk;
+export interface RevokeInviteParams {
+    groupId: string;
+    /** The invited individual party (shared object id). */
+    memberId: string;
+    groupCapId: string;
+    partyPackageId: string;
+}
+/** Revokes a pending invite (group's admin cap). */
+export declare function revokeInvite(params: RevokeInviteParams): TxThunk;
+export interface LeaveGroupParams {
+    groupId: string;
+    memberId: string;
+    memberCapId: string;
+    partyPackageId: string;
+}
+/** Leaves a group, authorized by the member's own admin cap. */
+export declare function leaveGroup(params: LeaveGroupParams): TxThunk;
+export interface RemoveMemberParams {
+    groupId: string;
+    groupCapId: string;
+    memberId: string;
+    partyPackageId: string;
+}
+/** Evicts a member from a group (group's admin cap); scrubs the member's record too. */
+export declare function removeMember(params: RemoveMemberParams): TxThunk;
+export interface SetNameParams {
+    partyId: string;
+    capId: string;
+    name: string;
+    partyPackageId: string;
+}
+/** Sets the party's human-readable name. */
+export declare function setName(params: SetNameParams): TxThunk;
+//# sourceMappingURL=transactions.d.ts.map

package/dist/party/transactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.d.ts","sourceRoot":"","sources":["../../src/party/transactions.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D,MAAM,MAAM,OAAO,GAAG,CAAC,EAAE,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,0FAA0F;AAC1F,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAOxE;AAED,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAOnE;AAMD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAO9D;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAOhE;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAOlE;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAOhE;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,gEAAgE;AAChE,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAO5D;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAOhE;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,4CAA4C;AAC5C,wBAAgB,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAOtD"}

package/dist/party/transactions.js

@@ -0,0 +1,85 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+import * as party from "../contracts/miso_party/party.js";
+/** Creates an individual party, shares it, and transfers its admin cap to `recipient`. */
+export function createIndividualParty(params) {
+    return (tx) => {
+        const kind = tx.add(party.newIndividualKind({ package: params.partyPackageId }));
+        const res = tx.add(party._new({ package: params.partyPackageId, arguments: [kind, params.name] }));
+        tx.add(party.share({ package: params.partyPackageId, arguments: [res[0], res[1]] }));
+        tx.transferObjects([res[1]], params.recipient);
+    };
+}
+/** Creates a group party (empty member set), shares it, transfers its admin cap. */
+export function createGroupParty(params) {
+    return (tx) => {
+        const kind = tx.add(party.newGroupKind({ package: params.partyPackageId }));
+        const res = tx.add(party._new({ package: params.partyPackageId, arguments: [kind, params.name] }));
+        tx.add(party.share({ package: params.partyPackageId, arguments: [res[0], res[1]] }));
+        tx.transferObjects([res[1]], params.recipient);
+    };
+}
+/** Invites an individual party to a group (gated by the group's admin cap). */
+export function inviteParty(params) {
+    return (tx) => {
+        tx.add(party.inviteParty({
+            package: params.partyPackageId,
+            arguments: [params.groupId, params.memberId, params.groupCapId],
+        }));
+    };
+}
+/** Accepts a pending invite, joining the member to the group (member's cap). */
+export function acceptInvite(params) {
+    return (tx) => {
+        tx.add(party.acceptInvite({
+            package: params.partyPackageId,
+            arguments: [params.groupId, params.memberId, params.memberCapId],
+        }));
+    };
+}
+/** Declines a pending invite (member's cap). */
+export function declineInvite(params) {
+    return (tx) => {
+        tx.add(party.declineInvite({
+            package: params.partyPackageId,
+            arguments: [params.groupId, params.memberId, params.memberCapId],
+        }));
+    };
+}
+/** Revokes a pending invite (group's admin cap). */
+export function revokeInvite(params) {
+    return (tx) => {
+        tx.add(party.revokeInvite({
+            package: params.partyPackageId,
+            arguments: [params.groupId, params.memberId, params.groupCapId],
+        }));
+    };
+}
+/** Leaves a group, authorized by the member's own admin cap. */
+export function leaveGroup(params) {
+    return (tx) => {
+        tx.add(party.leave({
+            package: params.partyPackageId,
+            arguments: [params.groupId, params.memberId, params.memberCapId],
+        }));
+    };
+}
+/** Evicts a member from a group (group's admin cap); scrubs the member's record too. */
+export function removeMember(params) {
+    return (tx) => {
+        tx.add(party.removeMember({
+            package: params.partyPackageId,
+            arguments: [params.groupId, params.groupCapId, params.memberId],
+        }));
+    };
+}
+/** Sets the party's human-readable name. */
+export function setName(params) {
+    return (tx) => {
+        tx.add(party.setName({
+            package: params.partyPackageId,
+            arguments: [params.partyId, params.capId, params.name],
+        }));
+    };
+}
+//# sourceMappingURL=transactions.js.map

package/dist/party/transactions.js.map

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

package/dist/party/types.d.ts

@@ -0,0 +1,54 @@
+export type PartyKind = "individual" | "group";
+export interface Party {
+    id: string;
+    kind: PartyKind;
+    /** Human-readable name (not verified). */
+    name: string;
+    /** Member party ids — present only when `kind === "group"`. */
+    members?: string[];
+    /** Unix ms when the party was created. */
+    createdAtMs: number;
+}
+export interface Profile {
+    partyId: string;
+    bioShort: string;
+    bioLong?: string;
+    /** ISO 3166-1 alpha-2 country code, e.g. "GB". */
+    country?: string;
+    /** ISO 639-1 language codes, e.g. ["en"]. */
+    languages: string[];
+}
+/**
+ * A party's imagery, stored on-chain as a single Walrus quilt. Individual images
+ * (avatar, header, …) are quilt patches addressed by identifier off-chain — see
+ * `mediaUrls` / `MEDIA_IDENTIFIERS` in `extensions/media`.
+ */
+export interface Media {
+    partyId: string;
+    /** Walrus quilt blob id (base64url) holding the party's images. */
+    quiltId: string;
+}
+/** A single call-to-action on a party: a labeled external link. Position is priority. */
+export interface Cta {
+    label: string;
+    url: string;
+}
+/**
+ * A platform this SDK knows how to build a link for. One key per external
+ * platform, spanning social (`x`, `instagram`, …), music (`spotify`, `bandcamp`,
+ * …), and professional/industry (`website`, `patreon`, …) payloads.
+ */
+export type PlatformKey = "x" | "instagram" | "threads" | "tiktok" | "youtube" | "discord" | "telegram" | "reddit" | "twitch" | "facebook" | "spotify" | "bandcamp" | "soundcloud" | "appleMusic" | "deezer" | "tidal" | "amazonMusic" | "audiomack" | "website" | "bookingPage" | "managementPage" | "publisherPage" | "labelPage" | "epk" | "patreon" | "substack" | "kofi";
+/**
+ * One external-platform link attached to a party. Only the native identifier
+ * (`value` — a handle, artist id, subdomain, or full URL) is stored on-chain; the
+ * public `url` is rebuilt client-side from it.
+ */
+export interface PlatformLink {
+    platform: PlatformKey;
+    /** The platform-native identifier stored on-chain (handle / id / subdomain / URL). */
+    value: string;
+    /** The public profile URL, rebuilt from `value`. */
+    url: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/party/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/party/types.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,OAAO,CAAC;AAE/C,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,yFAAyF;AACzF,MAAM,WAAW,GAAG;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAEnB,GAAG,GACH,WAAW,GACX,SAAS,GACT,QAAQ,GACR,SAAS,GACT,SAAS,GACT,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,UAAU,GAEV,SAAS,GACT,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,QAAQ,GACR,OAAO,GACP,aAAa,GACb,WAAW,GAEX,SAAS,GACT,aAAa,GACb,gBAAgB,GAChB,eAAe,GACf,WAAW,GACX,KAAK,GACL,SAAS,GACT,UAAU,GACV,MAAM,CAAC;AAEX;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,WAAW,CAAC;IACtB,sFAAsF;IACtF,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAC;CACb"}

package/dist/party/types.js

@@ -0,0 +1,4 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+export {};
+//# sourceMappingURL=types.js.map

package/dist/party/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/party/types.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@misonetwork/sdk",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "packageManager": "bun@1.4.0",
-  "description": "Typed bindings, queries, event decoders, and PTB builders for the Miso protocol package set on Sui.",
+  "description": "Typed bindings, queries, event decoders, and PTB builders for the Miso protocol and Party package set on Sui.",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -82,6 +82,10 @@
       "types": "./dist/packages.d.ts",
       "default": "./dist/packages.js"
     },
+    "./party": {
+      "types": "./dist/party/index.d.ts",
+      "default": "./dist/party/index.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [

package/src/client.ts

@@ -17,6 +17,7 @@ import {
 import { bindModulePackage, MisoPackageBindings, REF_RETURNING_CALLS } from "./packages.ts";
 import * as parsers from "./parsers.ts";
 import { eventParsers } from "./events.ts";
+import { PartyProtocolClient } from "./party/client.ts";
 import * as queries from "./queries.ts";
 import * as view from "./view.ts";
 import type {
@@ -108,6 +109,7 @@ export class MisoProtocolClient {
   #graphqlClient?: SuiGraphQLClient;
   #deployment: MisoProtocolDeployment;
   #packageDeployment?: MisoDeployment;
+  #partyClient?: PartyProtocolClient;
 
   constructor(client: ClientWithCoreApi, options: MisoProtocolClientOptions) {
     this.#client = client;
@@ -116,6 +118,9 @@ export class MisoProtocolClient {
     this.#packageDeployment = options.packageDeployment
       ? normalizeMisoDeployment(options.packageDeployment)
       : undefined;
+    this.#partyClient = this.#packageDeployment
+      ? new PartyProtocolClient(client, this.#packageDeployment)
+      : undefined;
   }
 
   /** The exact deployment selected for this client. */
@@ -137,6 +142,17 @@ export class MisoProtocolClient {
     return new MisoPackageBindings(this.#packageDeployment);
   }
 
+  /** Party identity, profile, membership, and extension APIs. */
+  get party(): PartyProtocolClient {
+    if (!this.#partyClient) {
+      throw new Error(
+        "@misonetwork/sdk: Party APIs require a complete MisoDeployment. " +
+          "Pass the verified post-publish manifest to miso({ deployment }).",
+      );
+    }
+    return this.#partyClient;
+  }
+
   get #misoPackageId(): string {
     return this.#deployment.packageId;
   }

package/src/contracts/miso/composition.ts

@@ -156,33 +156,6 @@ export function publish(options: PublishOptions) {
         typeArguments: options.typeArguments
     });
 }
-export interface IdArguments {
-    self: RawTransactionArgument<string>;
-}
-export interface IdOptions {
-    package?: string;
-    arguments: IdArguments | [
-        self: RawTransactionArgument<string>
-    ];
-    typeArguments: [
-        string
-    ];
-}
-/** Returns the composition's object ID. */
-export function id(options: IdOptions) {
-    const packageAddress = options.package ?? '@local-pkg/miso';
-    const argumentsTypes = [
-        null
-    ] satisfies (string | null)[];
-    const parameterNames = ["self"];
-    return (tx: Transaction) => tx.moveCall({
-        package: packageAddress,
-        module: 'composition',
-        function: 'id',
-        arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames),
-        typeArguments: options.typeArguments
-    });
-}
 export interface TitleArguments {
     self: RawTransactionArgument<string>;
 }

package/src/contracts/miso/recording.ts

@@ -240,34 +240,6 @@ export function compositionId(options: CompositionIdOptions) {
         typeArguments: options.typeArguments
     });
 }
-export interface IdArguments {
-    self: RawTransactionArgument<string>;
-}
-export interface IdOptions {
-    package?: string;
-    arguments: IdArguments | [
-        self: RawTransactionArgument<string>
-    ];
-    typeArguments: [
-        string,
-        string
-    ];
-}
-/** Returns the recording's object ID. */
-export function id(options: IdOptions) {
-    const packageAddress = options.package ?? '@local-pkg/miso';
-    const argumentsTypes = [
-        null
-    ] satisfies (string | null)[];
-    const parameterNames = ["self"];
-    return (tx: Transaction) => tx.moveCall({
-        package: packageAddress,
-        module: 'recording',
-        function: 'id',
-        arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames),
-        typeArguments: options.typeArguments
-    });
-}
 export interface UidArguments {
     self: RawTransactionArgument<string>;
 }