@misofm/partyos 0.1.0 → 0.3.0

package/dist/queries.js

@@ -1,123 +1,85 @@
 // Copyright (c) Miso Labs, Inc.
 // SPDX-License-Identifier: Apache-2.0
+// Typed reads: fetch an on-chain object (or dynamic field) via the Core API, BCS-parse
+// it through the generated struct, and map to the public camelCase types. Every read
+// requires the `SuiClient` service (see `@misofm/effect`) instead of taking a client
+// parameter; not-found and type-mismatch paths are typed failures, not thrown errors.
+import { Effect, Option, Stream } from "effect";
 import { deriveDynamicFieldID, deriveObjectID, normalizeStructTag } from "@mysten/sui/utils";
 import { bcs } from "@mysten/sui/bcs";
+import { assertObjectType, decodeBcs, getObjectContent, getObjectsContent, getOptionalObjectContent, listDynamicFields, } from "@misofm/effect";
 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;
-    }
-}
+import { Party } from "./types.js";
 /** 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)" : ""));
-    }
+/** Decodes one object's BCS content into a `Party`, mapping the generated parse output first. */
+function decodeParty(objectId, content, expectedType) {
+    return decodeBcs({ parse: (bytes) => mapParty(objectId, PartyBcs.parse(bytes)) }, Party, content, { type: expectedType, objectId });
 }
 /** 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));
-}
+export const getPartyById = Effect.fn("getPartyById")(function* (partyId, partyPackageId) {
+    const expected = partyType(partyPackageId);
+    const object = yield* getObjectContent(partyId);
+    // 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.
+    yield* assertObjectType(partyId, normalizeStructTag(object.type), expected);
+    return yield* decodeParty(partyId, object.content, expected);
+});
 /**
  * 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) {
+export const getPartiesByIds = Effect.fn("getPartiesByIds")(function* (partyIds, partyPackageId) {
     if (partyIds.length === 0)
         return {};
-    const { objects } = await client.core.getObjects({
-        objectIds: [...new Set(partyIds)],
-        include: { content: true },
-    });
+    const expected = partyType(partyPackageId);
+    const contentById = yield* getObjectsContent([...new Set(partyIds)]);
     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));
+    for (const [objectId, { content, type }] of contentById) {
+        yield* assertObjectType(objectId, normalizeStructTag(type), expected);
+        parties[objectId] = yield* decodeParty(objectId, content, expected);
     }
     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;
+function collectKeyIds(parentId, keySuffix, codec) {
+    return listDynamicFields(parentId).pipe(Stream.filter((f) => typeof f.name?.type === "string" && f.name.type.endsWith(keySuffix) && f.name.bcs != null), Stream.map((f) => {
+        const [id] = codec.parse(keyBytes(f.name.bcs));
+        return String(id);
+    }), Stream.runCollect, Effect.map((chunk) => Array.from(chunk)));
 }
 /**
  * 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);
+export function getMemberships(partyId) {
+    return collectKeyIds(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);
+export function getPendingInvites(groupId) {
+    return collectKeyIds(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);
+export function getPendingMemberships(partyId) {
+    return collectKeyIds(partyId, "::party::PendingMembershipKey", PendingMembershipKeyBcs);
 }
 /** Whether `memberId` currently holds a membership record for `groupId`. */
-export async function isMember(client, memberId, groupId, partyPackageId) {
+export const isMember = Effect.fn("isMember")(function* (memberId, groupId, partyPackageId) {
     const fieldId = deriveDynamicFieldID(memberId, `${partyPackageId}::party::MembershipKey`, MembershipKeyBcs.serialize([groupId]).toBytes());
-    return (await getObjectContent(client, fieldId)) !== null;
-}
+    const content = yield* getOptionalObjectContent(fieldId);
+    return Option.isSome(content);
+});
 //# sourceMappingURL=queries.js.map

package/dist/queries.js.map

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

package/dist/types.d.ts

@@ -1,12 +1,17 @@
-export type PartyKind = "individual" | "group";
-export interface Party {
-    id: string;
-    kind: PartyKind;
+import { Schema } from "effect";
+export declare const PartyKind: Schema.Literals<readonly ["individual", "group"]>;
+export type PartyKind = typeof PartyKind.Type;
+declare const Party_base: Schema.Class<Party, Schema.Struct<{
+    readonly id: Schema.String;
+    readonly kind: Schema.Literals<readonly ["individual", "group"]>;
     /** Human-readable name (not verified). */
-    name: string;
+    readonly name: Schema.String;
     /** Member party ids — present only when `kind === "group"`. */
-    members?: string[];
+    readonly members: Schema.optional<Schema.$Array<Schema.String>>;
     /** Unix ms when the party was created. */
-    createdAtMs: number;
+    readonly createdAtMs: Schema.Number;
+}>, {}>;
+export declare class Party extends Party_base {
 }
+export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,eAAO,MAAM,SAAS,mDAA2C,CAAC;AAClE,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAC;;;;IAK5C,0CAA0C;;IAE1C,+DAA+D;;IAE/D,0CAA0C;;;AAP5C,qBAAa,KAAM,SAAQ,UASzB;CAAG"}

package/dist/types.js

@@ -1,4 +1,18 @@
 // Copyright (c) Miso Labs, Inc.
 // SPDX-License-Identifier: Apache-2.0
-export {};
+// Public, camelCase result types. The mapper in ./internal.ts turns the generated
+// (snake_case, Move-shaped) parse output into the plain shape `Party` decodes from.
+import { Schema } from "effect";
+export const PartyKind = Schema.Literals(["individual", "group"]);
+export class Party extends Schema.Class("@misofm/partyos/Party")({
+    id: Schema.String,
+    kind: PartyKind,
+    /** Human-readable name (not verified). */
+    name: Schema.String,
+    /** Member party ids — present only when `kind === "group"`. */
+    members: Schema.optional(Schema.Array(Schema.String)),
+    /** Unix ms when the party was created. */
+    createdAtMs: Schema.Number,
+}) {
+}
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AAEtC,kFAAkF;AAClF,oFAAoF;AAEpF,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;AAGlE,MAAM,OAAO,KAAM,SAAQ,MAAM,CAAC,KAAK,CAAQ,uBAAuB,CAAC,CAAC;IACtE,EAAE,EAAE,MAAM,CAAC,MAAM;IACjB,IAAI,EAAE,SAAS;IACf,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC,MAAM;IACnB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrD,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC,MAAM;CAC3B,CAAC;CAAG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@misofm/partyos",
-  "version": "0.1.0",
+  "version": "0.3.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",
@@ -50,6 +50,10 @@
       "types": "./dist/deployments.d.ts",
       "default": "./dist/deployments.js"
     },
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "default": "./dist/errors.js"
+    },
     "./queries": {
       "types": "./dist/queries.d.ts",
       "default": "./dist/queries.js"
@@ -80,17 +84,20 @@
     "package.json"
   ],
   "dependencies": {
+    "@misofm/effect": "0.1.0",
     "@mysten/bcs": "^2.1.1"
   },
   "devDependencies": {
     "@mysten/sui": "2.29.0",
     "@types/bun": "^1.4.0",
+    "effect": "4.0.0-rc.112",
     "typedoc": "^0.28.20",
     "typedoc-plugin-markdown": "^4.13.0",
     "typescript": "^7.0.2"
   },
   "peerDependencies": {
     "@mysten/sui": "2.29.0",
+    "effect": "4.0.0-rc.112",
     "typescript": "^5.7 || ^6 || ^7"
   },
   "main": "./dist/index.js"

package/src/client.ts

@@ -5,7 +5,10 @@
 // deployment. Consumers reach this through `client.partyos` after
 // `$extend(partyos())`, or construct `PartyosClient` directly.
 
+import { Effect } from "effect";
 import type { ClientWithCoreApi, SuiClientRegistration } from "@mysten/sui/client";
+import { SuiClient } from "@misofm/effect";
+import type { BcsDecodeError, ObjectNotFoundError, ObjectTypeMismatchError, SuiRpcError } from "@misofm/effect";
 import { getPartyDeployment, normalizePartyDeployment, type PartyDeployment } from "./deployments.ts";
 import { PARTY_REF_RETURNING_CALLS } from "./contracts.ts";
 import * as queries from "./queries.ts";
@@ -74,10 +77,12 @@ export function partyos<const Name extends string = "partyos">(
 export class PartyosClient {
   #client: ClientWithCoreApi;
   #deployment: PartyDeployment;
+  #layer: ReturnType<typeof SuiClient.layer>;
 
   constructor(client: ClientWithCoreApi, deployment: PartyDeployment) {
     this.#client = client;
     this.#deployment = normalizePartyDeployment(deployment);
+    this.#layer = SuiClient.layer(client);
   }
 
   /** The exact deployment selected for this client. */
@@ -89,32 +94,43 @@ export class PartyosClient {
     return this.#deployment.partyos;
   }
 
+  /** Provides the `SuiClient` service bound to this client, discharging `R`. */
+  #provide<A, E>(effect: Effect.Effect<A, E, SuiClient>): Effect.Effect<A, E> {
+    return effect.pipe(Effect.provide(this.#layer));
+  }
+
   // === Queries ===
+  // Each method provides `SuiClient` internally, so callers get `Effect<A, E>`
+  // (R = never) and only need `Effect.runPromise` (or their own composition).
 
-  async getPartyById(partyId: string): Promise<Party> {
-    return queries.getPartyById(this.#client, partyId, this.#pkg);
+  getPartyById(
+    partyId: string,
+  ): Effect.Effect<Party, ObjectNotFoundError | ObjectTypeMismatchError | BcsDecodeError | SuiRpcError> {
+    return this.#provide(queries.getPartyById(partyId, this.#pkg));
   }
-  async getPartiesByIds(partyIds: readonly string[]): Promise<Partial<Record<string, Party>>> {
-    return queries.getPartiesByIds(this.#client, partyIds, this.#pkg);
+  getPartiesByIds(
+    partyIds: readonly string[],
+  ): Effect.Effect<Partial<Record<string, Party>>, ObjectTypeMismatchError | BcsDecodeError | SuiRpcError> {
+    return this.#provide(queries.getPartiesByIds(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);
+  getMemberships(partyId: string): Effect.Effect<string[], SuiRpcError> {
+    return this.#provide(queries.getMemberships(partyId));
   }
   /** Member ids invited to a group but not yet accepted. */
-  async getPendingInvites(groupId: string): Promise<string[]> {
-    return queries.getPendingInvites(this.#client, groupId);
+  getPendingInvites(groupId: string): Effect.Effect<string[], SuiRpcError> {
+    return this.#provide(queries.getPendingInvites(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);
+  getPendingMemberships(partyId: string): Effect.Effect<string[], SuiRpcError> {
+    return this.#provide(queries.getPendingMemberships(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);
+  isMember(memberId: string, groupId: string): Effect.Effect<boolean, SuiRpcError> {
+    return this.#provide(queries.isMember(memberId, groupId, this.#pkg));
   }
 
   // === Transaction builders (thunks; the package id is bound from the client) ===

package/src/deployments.ts

@@ -1,7 +1,9 @@
 // Copyright (c) Miso Labs, Inc.
 // SPDX-License-Identifier: Apache-2.0
 
+import { Effect } from "effect";
 import { normalizeSuiAddress } from "@mysten/sui/utils";
+import { DeploymentError } from "@misofm/effect";
 
 /** Sui networks for which this SDK may bundle a verified deployment. */
 export type PartyosNetwork = "mainnet" | "testnet";
@@ -26,7 +28,7 @@ export type PartyDeployment = Readonly<Record<PartyosPackageName, string>>;
 /** Verified immutable deployments bundled with this SDK release. */
 export const PARTYOS_DEPLOYMENTS = Object.freeze({
   testnet: Object.freeze({
-    partyos: "0xc9fc5d918da992b7c6499880fc509635def384d8529948b28f58494daedf8ec8",
+    partyos: "0x342425da86c4389c1f5558013251f18017ead98414db5644569890ba3a4a434c",
   } as const),
 } as const) satisfies Partial<Record<PartyosNetwork, PartyDeployment>>;
 
@@ -88,3 +90,17 @@ export function normalizePartyDeployment(deployment: unknown): PartyDeployment {
     Object.fromEntries(CANONICAL_PARTYOS_PACKAGE_NAMES.map((name) => [name, deployment[name]])),
   ) as PartyDeployment;
 }
+
+/**
+ * Effect counterpart to {@link normalizePartyDeployment}: validation is pure and
+ * synchronous, so this exists only for callers composing a config-loading
+ * pipeline out of Effects rather than throwing at a configuration boundary.
+ */
+export const validatePartyDeployment = Effect.fn("validatePartyDeployment")(function* (
+  input: unknown,
+): Effect.fn.Return<PartyDeployment, DeploymentError> {
+  return yield* Effect.try({
+    try: () => normalizePartyDeployment(input),
+    catch: (cause) => new DeploymentError({ message: cause instanceof Error ? cause.message : String(cause) }),
+  });
+});

package/src/errors.ts

@@ -0,0 +1,18 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+// Party-specific tagged errors, plus the shared vocabulary re-exported so
+// callers never need to reach into `@misofm/effect` directly. `getPartyById`
+// and `getPartiesByIds` fail with the foundation's `ObjectNotFoundError` /
+// `ObjectTypeMismatchError` — `PartyNotFoundError` below is offered for
+// callers that want a party-scoped tag instead of pattern-matching the
+// generic object vocabulary.
+
+import { Schema } from "effect";
+
+export * from "@misofm/effect/errors";
+
+/** A party object does not exist (never existed, was deleted, or the id is not a party). */
+export class PartyNotFoundError extends Schema.TaggedError<PartyNotFoundError>()("PartyNotFoundError", {
+  partyId: Schema.String,
+}) {}

package/src/index.ts

@@ -10,6 +10,7 @@ export * from "./transactions.ts";
 export * from "./queries.ts";
 export * from "./client.ts";
 export * from "./deployments.ts";
+export * from "./errors.ts";
 
 // Generated, ABI-bound bindings (BCS structs + type-safe Move calls).
 export * as contracts from "./contracts.ts";

package/src/internal.ts

@@ -2,13 +2,15 @@
 // SPDX-License-Identifier: Apache-2.0
 
 // The single boundary between generated BCS-parse output (snake_case, Move-shaped)
-// and the public camelCase types.
+// and the public camelCase types. `mapParty` returns a plain object shaped like
+// `Party`'s encoded form; `Schema.decodeUnknownEffect(Party)` (via `decodeBcs`)
+// validates and constructs the class from it.
 
 import { fromBase64 } from "@mysten/sui/utils";
 import type { Party } from "./types.ts";
 
 // deno-lint-ignore no-explicit-any -- generated parse output is loosely typed
-export function mapParty(id: string, d: any): Party {
+export function mapParty(id: string, d: any): typeof Party.Encoded {
   const kind = d.kind;
   const createdAtMs = Number(d.created_at_ms);
   // PartyKind is `Individual | Group(VecSet<ID>)`. The enum parses to