@misofm/partyos 0.1.0

package/dist/queries.js

@@ -0,0 +1,123 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+import { deriveDynamicFieldID, deriveObjectID, normalizeStructTag } from "@mysten/sui/utils";
+import { bcs } from "@mysten/sui/bcs";
+import { MembershipKey as MembershipKeyBcs, Party as PartyBcs, PendingInviteKey as PendingInviteKeyBcs, PendingMembershipKey as PendingMembershipKeyBcs, } from "./contracts/partyos/party.js";
+import { keyBytes, mapParty } from "./internal.js";
+/** True for the Core API's "object does not exist" error (a missing dynamic field). */
+export function isNotFound(e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    return /not\s*found|does not exist|no object/i.test(msg);
+}
+/**
+ * Reads an object's BCS content, or null when it does not exist. A missing
+ * object (e.g. an unset dynamic field) surfaces as a thrown "not found" from the
+ * Core API, not an empty result, so optional reads can treat it as absence.
+ */
+export async function getObjectContent(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;
+    }
+}
+/** The `Party` struct tag of one partyos deployment. */
+export function partyType(partyPackageId) {
+    return normalizeStructTag(`${partyPackageId}::party::Party`);
+}
+// A Party from another partyos package (a previous generation) parses
+// identically but no deployed package accepts it, so the object's type is
+// checked against the deployment before its content is trusted.
+function assertPartyType(objectId, type, partyPackageId) {
+    const expected = partyType(partyPackageId);
+    if (type === undefined || normalizeStructTag(type) !== expected) {
+        throw new Error(`Object ${objectId} is ${type ?? "of unknown type"}, not a ${expected}` +
+            (type?.endsWith("::party::Party") ? " (a Party from a different partyos deployment)" : ""));
+    }
+}
+/** Fetches and parses a shared `Party` object of this deployment's partyos package. */
+export async function getPartyById(client, partyId, partyPackageId) {
+    let object;
+    try {
+        ({ object } = await client.core.getObject({ objectId: partyId, include: { content: true } }));
+    }
+    catch (e) {
+        if (isNotFound(e))
+            throw new Error(`Party not found: ${partyId}`);
+        throw e;
+    }
+    if (!object?.content)
+        throw new Error(`Party not found: ${partyId}`);
+    assertPartyType(partyId, object.type, partyPackageId);
+    return mapParty(partyId, PartyBcs.parse(object.content));
+}
+/**
+ * Fetches and parses multiple shared `Party` objects in one Core request.
+ * Missing objects are skipped; an object of another type is an error.
+ */
+export async function getPartiesByIds(client, partyIds, partyPackageId) {
+    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;
+        assertPartyType(obj.objectId, obj.type, partyPackageId);
+        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());
+}
+// === Group membership reads ===
+/** Collects the ids stored in every dynamic-field key of `parentId` whose type ends with `keySuffix`. */
+async function collectKeyIds(client, parentId, keySuffix, codec) {
+    const ids = [];
+    let cursor;
+    do {
+        const page = await client.core.listDynamicFields({ parentId, cursor: cursor ?? undefined });
+        for (const f of page.dynamicFields) {
+            if (typeof f.name?.type === "string" && f.name.type.endsWith(keySuffix) && f.name.bcs != null) {
+                const [id] = codec.parse(keyBytes(f.name.bcs));
+                ids.push(String(id));
+            }
+        }
+        cursor = page.hasNextPage ? page.cursor : null;
+    } while (cursor);
+    return ids;
+}
+/**
+ * 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) {
+    return collectKeyIds(client, partyId, "::party::MembershipKey", MembershipKeyBcs);
+}
+/** The member ids invited to a group but not yet accepted (its `PendingInviteKey` fields). */
+export async function getPendingInvites(client, groupId) {
+    return collectKeyIds(client, groupId, "::party::PendingInviteKey", PendingInviteKeyBcs);
+}
+/**
+ * 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) {
+    return collectKeyIds(client, partyId, "::party::PendingMembershipKey", PendingMembershipKeyBcs);
+}
+/** 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 getObjectContent(client, fieldId)) !== null;
+}
+//# sourceMappingURL=queries.js.map

package/dist/queries.js.map

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

package/dist/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/transactions.d.ts.map

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

@@ -0,0 +1,85 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+import * as party from "./contracts/partyos/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/transactions.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,12 @@
+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;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,97 @@
+{
+  "name": "@misofm/partyos",
+  "version": "0.1.0",
+  "packageManager": "bun@1.4.0",
+  "description": "Typed bindings, queries, and PTB builders for the PartyOS object model (Party identity, admin caps, and group membership) on Sui.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/misofm/sdks.git"
+  },
+  "homepage": "https://github.com/misofm/sdks#readme",
+  "bugs": {
+    "url": "https://github.com/misofm/sdks/issues"
+  },
+  "keywords": [
+    "sui",
+    "move",
+    "miso",
+    "partyos",
+    "party",
+    "identity",
+    "blockchain",
+    "sdk"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "sideEffects": false,
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "docs": "typedoc",
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "prepack": "rm -rf dist && tsc -p tsconfig.build.json",
+    "prepare": "rm -rf dist && tsc -p tsconfig.build.json --noCheck"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "default": "./dist/client.js"
+    },
+    "./deployments": {
+      "types": "./dist/deployments.d.ts",
+      "default": "./dist/deployments.js"
+    },
+    "./queries": {
+      "types": "./dist/queries.d.ts",
+      "default": "./dist/queries.js"
+    },
+    "./transactions": {
+      "types": "./dist/transactions.d.ts",
+      "default": "./dist/transactions.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "default": "./dist/types.js"
+    },
+    "./contracts": {
+      "types": "./dist/contracts.d.ts",
+      "default": "./dist/contracts.js"
+    },
+    "./contracts/*": {
+      "types": "./dist/contracts/*.d.ts",
+      "default": "./dist/contracts/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "dependencies": {
+    "@mysten/bcs": "^2.1.1"
+  },
+  "devDependencies": {
+    "@mysten/sui": "2.29.0",
+    "@types/bun": "^1.4.0",
+    "typedoc": "^0.28.20",
+    "typedoc-plugin-markdown": "^4.13.0",
+    "typescript": "^7.0.2"
+  },
+  "peerDependencies": {
+    "@mysten/sui": "2.29.0",
+    "typescript": "^5.7 || ^6 || ^7"
+  },
+  "main": "./dist/index.js"
+}

package/src/client.ts

@@ -0,0 +1,165 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+// Party queries and transaction builders bound to one verified partyos
+// deployment. Consumers reach this through `client.partyos` after
+// `$extend(partyos())`, or construct `PartyosClient` directly.
+
+import type { ClientWithCoreApi, SuiClientRegistration } from "@mysten/sui/client";
+import { getPartyDeployment, normalizePartyDeployment, type PartyDeployment } from "./deployments.ts";
+import { PARTY_REF_RETURNING_CALLS } from "./contracts.ts";
+import * as queries from "./queries.ts";
+import * as transactions from "./transactions.ts";
+import type { TxThunk } from "./transactions.ts";
+import type { Party } from "./types.ts";
+import * as partyMod from "./contracts/partyos/party.ts";
+
+type BoundMoveFunction<F> = F extends (options: infer Options) => infer Result
+  ? Options extends { package?: unknown }
+    ? (options: Omit<Options, "package">) => Result
+    : F
+  : F;
+type BoundModule<M extends object, Removed extends PropertyKey> = {
+  [Key in Exclude<keyof M, Removed>]: BoundMoveFunction<M[Key]>;
+};
+
+/** Defaults generated calls to one package and removes reference-returning calls. */
+export function bindModulePackage<M extends object, K extends readonly (keyof M)[]>(
+  mod: M,
+  pkg: string,
+  unavailable: K = [] as unknown as K,
+): BoundModule<M, K[number]> {
+  const out: Record<string, unknown> = {};
+  for (const [key, value] of Object.entries({ ...mod })) {
+    if ((unavailable as readonly string[]).includes(key)) continue;
+    out[key] =
+      typeof value === "function"
+        ? (options: { package?: string }) => (value as (o: unknown) => unknown)({ package: pkg, ...options })
+        : value;
+  }
+  return out as BoundModule<M, K[number]>;
+}
+
+export interface PartyosOptions<Name extends string = "partyos"> {
+  /** Name for the client extension. Defaults to "partyos". */
+  name?: Name;
+  /** Explicit deployment. Omit only when this SDK bundles a verified manifest for the client's network. */
+  deployment?: PartyDeployment;
+}
+
+/**
+ * Creates a PartyOS client extension for use with `$extend()`.
+ *
+ * @example
+ * ```ts
+ * const client = new SuiGrpcClient({ network: "testnet" }).$extend(partyos());
+ * const party = await client.partyos.getPartyById("0x...");
+ * ```
+ */
+export function partyos<const Name extends string = "partyos">(
+  options: PartyosOptions<Name> = {},
+): SuiClientRegistration<ClientWithCoreApi, Name, PartyosClient> {
+  const name = (options.name ?? "partyos") as Name;
+  return {
+    name,
+    register: (client) =>
+      new PartyosClient(
+        client,
+        options.deployment ? normalizePartyDeployment(options.deployment) : getPartyDeployment(client.network),
+      ),
+  };
+}
+
+/** Package-bound PartyOS client. */
+export class PartyosClient {
+  #client: ClientWithCoreApi;
+  #deployment: PartyDeployment;
+
+  constructor(client: ClientWithCoreApi, deployment: PartyDeployment) {
+    this.#client = client;
+    this.#deployment = normalizePartyDeployment(deployment);
+  }
+
+  /** The exact deployment selected for this client. */
+  get deployment(): PartyDeployment {
+    return this.#deployment;
+  }
+
+  get #pkg(): string {
+    return this.#deployment.partyos;
+  }
+
+  // === Queries ===
+
+  async getPartyById(partyId: string): Promise<Party> {
+    return queries.getPartyById(this.#client, partyId, this.#pkg);
+  }
+  async getPartiesByIds(partyIds: readonly string[]): Promise<Partial<Record<string, Party>>> {
+    return queries.getPartiesByIds(this.#client, partyIds, this.#pkg);
+  }
+  derivePartyAdminCapId(partyId: string): string {
+    return queries.derivePartyAdminCapId(partyId, this.#pkg);
+  }
+  /** Group ids a party belongs to (member-side membership records). */
+  async getMemberships(partyId: string): Promise<string[]> {
+    return queries.getMemberships(this.#client, partyId);
+  }
+  /** Member ids invited to a group but not yet accepted. */
+  async getPendingInvites(groupId: string): Promise<string[]> {
+    return queries.getPendingInvites(this.#client, groupId);
+  }
+  /** Group ids that have invited this party but are awaiting its response. */
+  async getPendingMemberships(partyId: string): Promise<string[]> {
+    return queries.getPendingMemberships(this.#client, partyId);
+  }
+  /** Whether a party is a member of a group. */
+  async isMember(memberId: string, groupId: string): Promise<boolean> {
+    return queries.isMember(this.#client, memberId, groupId, this.#pkg);
+  }
+
+  // === Transaction builders (thunks; the package id is bound from the client) ===
+
+  get tx() {
+    const pkg = this.#pkg;
+    return {
+      createIndividualParty: (p: Omit<transactions.CreatePartyParams, "partyPackageId">): TxThunk =>
+        transactions.createIndividualParty({ ...p, partyPackageId: pkg }),
+      createGroupParty: (p: Omit<transactions.CreatePartyParams, "partyPackageId">): TxThunk =>
+        transactions.createGroupParty({ ...p, partyPackageId: pkg }),
+      setName: (p: Omit<transactions.SetNameParams, "partyPackageId">): TxThunk =>
+        transactions.setName({ ...p, partyPackageId: pkg }),
+      inviteParty: (p: Omit<transactions.InvitePartyParams, "partyPackageId">): TxThunk =>
+        transactions.inviteParty({ ...p, partyPackageId: pkg }),
+      acceptInvite: (p: Omit<transactions.AcceptInviteParams, "partyPackageId">): TxThunk =>
+        transactions.acceptInvite({ ...p, partyPackageId: pkg }),
+      declineInvite: (p: Omit<transactions.DeclineInviteParams, "partyPackageId">): TxThunk =>
+        transactions.declineInvite({ ...p, partyPackageId: pkg }),
+      revokeInvite: (p: Omit<transactions.RevokeInviteParams, "partyPackageId">): TxThunk =>
+        transactions.revokeInvite({ ...p, partyPackageId: pkg }),
+      leaveGroup: (p: Omit<transactions.LeaveGroupParams, "partyPackageId">): TxThunk =>
+        transactions.leaveGroup({ ...p, partyPackageId: pkg }),
+      removeMember: (p: Omit<transactions.RemoveMemberParams, "partyPackageId">): TxThunk =>
+        transactions.removeMember({ ...p, partyPackageId: pkg }),
+    };
+  }
+
+  // === Generated type-safe Move calls (for tx.add) ===
+
+  get call() {
+    return {
+      party: bindModulePackage(partyMod, this.#pkg, PARTY_REF_RETURNING_CALLS),
+    };
+  }
+
+  // === Generated BCS structs (for parsing object/event content) ===
+
+  get bcs() {
+    return {
+      Party: partyMod.Party,
+      PartyAdminCap: partyMod.PartyAdminCap,
+    };
+  }
+}
+
+/** @deprecated Use `PartyosClient`. Retained for callers migrating from `@misofm/protocol/party`. */
+export { PartyosClient as PartyProtocolClient };

package/src/contracts/partyos/deps/sui/vec_set.ts

@@ -0,0 +1,22 @@
+/**************************************************************
+ * THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *
+ **************************************************************/
+import { type BcsType, bcs } from '@mysten/sui/bcs';
+import type {} from "@mysten/bcs";
+import { MoveStruct } from '../../../utils/index.ts';
+const $moduleName = '0x2::vec_set';
+/**
+ * A set data structure backed by a vector. The set is guaranteed not to contain
+ * duplicate keys. All operations are O(N) in the size of the set
+ *
+ * - the intention of this data structure is only to provide the convenience of
+ *   programming against a set API. Sets that need sorted iteration rather than
+ *   insertion order iteration should be handwritten.
+ */
+export function VecSet<K extends BcsType<any>>(...typeParameters: [
+    K
+]) {
+    return new MoveStruct({ name: `${$moduleName}::VecSet<${typeParameters[0].name as K['name']}>`, fields: {
+            contents: bcs.vector(typeParameters[0])
+        } });
+}