@misofm/partyos 0.2.0 → 0.3.0

package/README.md

@@ -14,38 +14,90 @@ this package. Which Move package generates into which SDK is decided by
 ## Install
 
 ```sh
-bun add @misofm/partyos @mysten/sui
+bun add @misofm/partyos @misofm/effect effect @mysten/sui
 ```
 
-`@mysten/sui` is a peer dependency pinned to one exact version.
+`@mysten/sui` and `effect` (exactly `4.0.0-rc.112`) are peer dependencies.
 
 ## Use
 
+Every read returns an `Effect` that requires the `SuiClient` service instead of
+taking a client parameter — see [`@misofm/effect`](https://www.npmjs.com/package/@misofm/effect)
+for the shared `SuiClient` service and error vocabulary every `@misofm/*` package
+builds on.
+
+### Through the client extension
+
+`client.partyos.*` provides `SuiClient` internally (bound to the client it was
+built from), so each method already returns `Effect<A, E>` with `R = never` —
+just `Effect.runPromise` it:
+
 ```ts
+import { Effect } from "effect";
 import { SuiGrpcClient } from "@mysten/sui/grpc";
 import { Transaction } from "@mysten/sui/transactions";
 import { partyos } from "@misofm/partyos";
 
 const client = new SuiGrpcClient({ network: "testnet" }).$extend(partyos());
 
-const party = await client.partyos.getPartyById("0x...");
-const groups = await client.partyos.getMemberships(party.id);
+const program = Effect.gen(function* () {
+  const party = yield* client.partyos.getPartyById("0x...");
+  const groups = yield* client.partyos.getMemberships(party.id);
+  return { party, groups };
+}).pipe(
+  Effect.catchTag("ObjectNotFoundError", (error) => Effect.succeed({ party: null, groups: [], missing: error })),
+);
+
+const { party, groups } = await Effect.runPromise(program);
 
 const tx = new Transaction();
 await client.partyos.tx.createIndividualParty({ name: "Ada", recipient: "0x..." })(tx);
 ```
 
 Every builder under `tx` appends commands to a caller-owned `Transaction` and never
-executes. `call` exposes the generated, package-bound Move calls (minus the
-reference-returning views a PTB cannot use), and `bcs` the generated codecs.
+executes (`tx`/`call`/`bcs` stay synchronous). `call` exposes the generated,
+package-bound Move calls (minus the reference-returning views a PTB cannot use),
+and `bcs` the generated codecs.
+
+### Free functions
+
+The functions in `./queries` take no client parameter — they declare `SuiClient`
+in their Effect's requirements, so provide it once at your program's boundary:
+
+```ts
+import { Effect } from "effect";
+import { SuiGrpcClient } from "@mysten/sui/grpc";
+import { SuiClient } from "@misofm/effect";
+import { getPartyById } from "@misofm/partyos/queries";
+
+const client = new SuiGrpcClient({ network: "testnet" });
+
+const program = getPartyById("0x...", "0xPARTYOS_PACKAGE");
+
+const party = await Effect.runPromise(program.pipe(Effect.provide(SuiClient.layer(client))));
+```
+
+## Errors
+
+Reads fail with the shared `@misofm/effect` vocabulary: `ObjectNotFoundError { objectId }`,
+`ObjectTypeMismatchError { objectId, expected, actual }` (e.g. a `Party` object from a
+different partyos deployment, or an id that is not a `Party` at all), `BcsDecodeError`,
+and `SuiRpcError`. Recover from one with `Effect.catchTag("ObjectNotFoundError", ...)`
+rather than an `isNotFound(error)` predicate. `./errors` re-exports the full
+`@misofm/effect/errors` vocabulary plus `PartyNotFoundError { partyId }`, offered for
+callers that want a party-scoped tag instead of pattern-matching the generic one.
+`validatePartyDeployment` (in `./deployments`) fails with `DeploymentError { message }`.
 
 ## Deployment manifest
 
 `PARTYOS_DEPLOYMENTS` bundles the verified testnet deployment: a single key, `partyos`.
 Pass `partyos({ deployment })` for another network; a manifest with any other shape is
-rejected before a Move target is constructed.
+rejected before a Move target is constructed (`assertPartyDeployment`/`normalizePartyDeployment`
+throw synchronously; `validatePartyDeployment` is the Effect-returning counterpart for
+callers composing a config-loading pipeline out of Effects).
 
 ## Subpaths
 
-`@misofm/partyos` (everything), `/client`, `/deployments`, `/queries`, `/transactions`,
-`/types`, `/contracts` (curated bindings), `/contracts/*` (raw generated modules).
+`@misofm/partyos` (everything), `/client`, `/deployments`, `/errors`, `/queries`,
+`/transactions`, `/types`, `/contracts` (curated bindings), `/contracts/*` (raw
+generated modules).

package/dist/client.d.ts

@@ -1,4 +1,6 @@
+import { Effect } from "effect";
 import type { ClientWithCoreApi, SuiClientRegistration } from "@mysten/sui/client";
+import type { BcsDecodeError, ObjectNotFoundError, ObjectTypeMismatchError, SuiRpcError } from "@misofm/effect";
 import { type PartyDeployment } from "./deployments.ts";
 import * as transactions from "./transactions.ts";
 import type { TxThunk } from "./transactions.ts";
@@ -34,17 +36,17 @@ export declare class PartyosClient {
     constructor(client: ClientWithCoreApi, deployment: PartyDeployment);
     /** The exact deployment selected for this client. */
     get deployment(): PartyDeployment;
-    getPartyById(partyId: string): Promise<Party>;
-    getPartiesByIds(partyIds: readonly string[]): Promise<Partial<Record<string, Party>>>;
+    getPartyById(partyId: string): Effect.Effect<Party, ObjectNotFoundError | ObjectTypeMismatchError | BcsDecodeError | SuiRpcError>;
+    getPartiesByIds(partyIds: readonly string[]): Effect.Effect<Partial<Record<string, Party>>, ObjectTypeMismatchError | BcsDecodeError | SuiRpcError>;
     derivePartyAdminCapId(partyId: string): string;
     /** Group ids a party belongs to (member-side membership records). */
-    getMemberships(partyId: string): Promise<string[]>;
+    getMemberships(partyId: string): Effect.Effect<string[], SuiRpcError>;
     /** Member ids invited to a group but not yet accepted. */
-    getPendingInvites(groupId: string): Promise<string[]>;
+    getPendingInvites(groupId: string): Effect.Effect<string[], SuiRpcError>;
     /** Group ids that have invited this party but are awaiting its response. */
-    getPendingMemberships(partyId: string): Promise<string[]>;
+    getPendingMemberships(partyId: string): Effect.Effect<string[], SuiRpcError>;
     /** Whether a party is a member of a group. */
-    isMember(memberId: string, groupId: string): Promise<boolean>;
+    isMember(memberId: string, groupId: string): Effect.Effect<boolean, SuiRpcError>;
     get tx(): {
         createIndividualParty: (p: Omit<transactions.CreatePartyParams, "partyPackageId">) => TxThunk;
         createGroupParty: (p: Omit<transactions.CreatePartyParams, "partyPackageId">) => TxThunk;

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -1,5 +1,10 @@
 // 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 { Effect } from "effect";
+import { SuiClient } from "@misofm/effect";
 import { getPartyDeployment, normalizePartyDeployment } from "./deployments.js";
 import { PARTY_REF_RETURNING_CALLS } from "./contracts.js";
 import * as queries from "./queries.js";
@@ -38,9 +43,11 @@ export function partyos(options = {}) {
 export class PartyosClient {
     #client;
     #deployment;
+    #layer;
     constructor(client, deployment) {
         this.#client = client;
         this.#deployment = normalizePartyDeployment(deployment);
+        this.#layer = SuiClient.layer(client);
     }
     /** The exact deployment selected for this client. */
     get deployment() {
@@ -49,31 +56,37 @@ export class PartyosClient {
     get #pkg() {
         return this.#deployment.partyos;
     }
+    /** Provides the `SuiClient` service bound to this client, discharging `R`. */
+    #provide(effect) {
+        return effect.pipe(Effect.provide(this.#layer));
+    }
     // === Queries ===
-    async getPartyById(partyId) {
-        return queries.getPartyById(this.#client, partyId, this.#pkg);
+    // Each method provides `SuiClient` internally, so callers get `Effect<A, E>`
+    // (R = never) and only need `Effect.runPromise` (or their own composition).
+    getPartyById(partyId) {
+        return this.#provide(queries.getPartyById(partyId, this.#pkg));
     }
-    async getPartiesByIds(partyIds) {
-        return queries.getPartiesByIds(this.#client, partyIds, this.#pkg);
+    getPartiesByIds(partyIds) {
+        return this.#provide(queries.getPartiesByIds(partyIds, this.#pkg));
     }
     derivePartyAdminCapId(partyId) {
         return queries.derivePartyAdminCapId(partyId, this.#pkg);
     }
     /** Group ids a party belongs to (member-side membership records). */
-    async getMemberships(partyId) {
-        return queries.getMemberships(this.#client, partyId);
+    getMemberships(partyId) {
+        return this.#provide(queries.getMemberships(partyId));
     }
     /** Member ids invited to a group but not yet accepted. */
-    async getPendingInvites(groupId) {
-        return queries.getPendingInvites(this.#client, groupId);
+    getPendingInvites(groupId) {
+        return this.#provide(queries.getPendingInvites(groupId));
     }
     /** Group ids that have invited this party but are awaiting its response. */
-    async getPendingMemberships(partyId) {
-        return queries.getPendingMemberships(this.#client, partyId);
+    getPendingMemberships(partyId) {
+        return this.#provide(queries.getPendingMemberships(partyId));
     }
     /** Whether a party is a member of a group. */
-    async isMember(memberId, groupId) {
-        return queries.isMember(this.#client, memberId, groupId, this.#pkg);
+    isMember(memberId, groupId) {
+        return this.#provide(queries.isMember(memberId, groupId, this.#pkg));
     }
     // === Transaction builders (thunks; the package id is bound from the client) ===
     get tx() {

package/dist/client.js.map

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

package/dist/deployments.d.ts

@@ -1,3 +1,5 @@
+import { Effect } from "effect";
+import { DeploymentError } from "@misofm/effect";
 /** Sui networks for which this SDK may bundle a verified deployment. */
 export type PartyosNetwork = "mainnet" | "testnet";
 /**
@@ -29,5 +31,11 @@ export declare function getPartyDeployment(network: string): PartyDeployment;
 export declare function assertPartyDeployment(deployment: unknown): asserts deployment is PartyDeployment;
 /** Validate and snapshot an untrusted manifest so later caller mutation is inert. */
 export declare function normalizePartyDeployment(deployment: unknown): 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 declare const validatePartyDeployment: (input: unknown) => Effect.Effect<Readonly<Record<"partyos", string>>, DeploymentError, never>;
 export {};
 //# sourceMappingURL=deployments.d.ts.map

package/dist/deployments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deployments.d.ts","sourceRoot":"","sources":["../src/deployments.ts"],"names":[],"mappings":"AAKA,wEAAwE;AACxE,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,CAAC;AAEnD;;;;;;GAMG;AACH,QAAA,MAAM,+BAA+B,YAAI,SAAS,CAAU,CAAC;AAE7D,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;AAElF;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAC;AAE3E,oEAAoE;AACpE,eAAO,MAAM,mBAAmB;;0BAEnB,oEAAoE;;EAEX,CAAC;AAEvE,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CASnE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,IAAI,eAAe,CAiChG;AAED,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,OAAO,GAAG,eAAe,CAK7E"}
+{"version":3,"file":"deployments.d.ts","sourceRoot":"","sources":["../src/deployments.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,wEAAwE;AACxE,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,CAAC;AAEnD;;;;;;GAMG;AACH,QAAA,MAAM,+BAA+B,YAAI,SAAS,CAAU,CAAC;AAE7D,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;AAElF;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAC;AAE3E,oEAAoE;AACpE,eAAO,MAAM,mBAAmB;;0BAEnB,oEAAoE;;EAEX,CAAC;AAEvE,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CASnE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,IAAI,eAAe,CAiChG;AAED,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,OAAO,GAAG,eAAe,CAK7E;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,gGAOlC,CAAC"}

package/dist/deployments.js

@@ -1,6 +1,8 @@
 // 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";
 /**
  * The single independently published package required by this SDK surface:
  * the `partyos` object-model package (module `party`).
@@ -60,4 +62,15 @@ export function normalizePartyDeployment(deployment) {
     assertPartyDeployment(deployment);
     return Object.freeze(Object.fromEntries(CANONICAL_PARTYOS_PACKAGE_NAMES.map((name) => [name, deployment[name]])));
 }
+/**
+ * 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) {
+    return yield* Effect.try({
+        try: () => normalizePartyDeployment(input),
+        catch: (cause) => new DeploymentError({ message: cause instanceof Error ? cause.message : String(cause) }),
+    });
+});
 //# sourceMappingURL=deployments.js.map

package/dist/deployments.js.map

@@ -1 +1 @@
-{"version":3,"file":"deployments.js","sourceRoot":"","sources":["../src/deployments.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AAEtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAKxD;;;;;;GAMG;AACH,MAAM,+BAA+B,GAAG,CAAC,SAAS,CAAU,CAAC;AAU7D,oEAAoE;AACpE,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;QACrB,OAAO,EAAE,oEAAoE;KACrE,CAAC;CACH,CAA4D,CAAC;AAEvE,0EAA0E;AAC1E,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,MAAM,UAAU,GAAI,mBAAgE,CAAC,OAAO,CAAC,CAAC;IAC9F,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,2EAA2E,OAAO,KAAK;YACrF,2GAA2G,CAC9G,CAAC;IACJ,CAAC;IACD,OAAO,wBAAwB,CAAC,UAAU,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAmB;IACvD,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/E,MAAM,IAAI,KAAK,CACb,iFAAiF,+BAA+B,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC/H,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,UAAqC,CAAC;IACtD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAC5B,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,+BAA+B,CAAC,QAAQ,CAAC,GAAyB,CAAC,CAC9E,CAAC;IACF,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,+BAA+B,CAAC,MAAM,EAAE,CAAC;QACpF,MAAM,IAAI,KAAK,CACb,uEAAuE,+BAA+B,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACrH,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,+BAA+B,EAAE,CAAC;QACnD,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,0DAA0D,IAAI,IAAI,CAAC,CAAC;QACtF,CAAC;QACD,IAAI,UAAkB,CAAC;QACvB,IAAI,CAAC;YACH,UAAU,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,+CAA+C,IAAI,+BAA+B,CAAC,CAAC;QACtG,CAAC;QACD,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,+CAA+C,IAAI,yBAAyB,UAAU,IAAI,CAC3F,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,wBAAwB,CAAC,UAAmB;IAC1D,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAClC,OAAO,MAAM,CAAC,MAAM,CAClB,MAAM,CAAC,WAAW,CAAC,+BAA+B,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CACzE,CAAC;AACvB,CAAC"}
+{"version":3,"file":"deployments.js","sourceRoot":"","sources":["../src/deployments.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,9 @@
+import { Schema } from "effect";
+export * from "@misofm/effect/errors";
+declare const PartyNotFoundError_base: Schema.Class<PartyNotFoundError, Schema.TaggedStruct<"PartyNotFoundError", {
+    readonly partyId: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** A party object does not exist (never existed, was deleted, or the id is not a party). */
+export declare class PartyNotFoundError extends PartyNotFoundError_base {
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,cAAc,uBAAuB,CAAC;;;;AAEtC,4FAA4F;AAC5F,qBAAa,kBAAmB,SAAQ,uBAEtC;CAAG"}

package/dist/errors.js

@@ -0,0 +1,16 @@
+// 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", {
+    partyId: Schema.String,
+}) {
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AAEtC,0EAA0E;AAC1E,6EAA6E;AAC7E,2EAA2E;AAC3E,wEAAwE;AACxE,uEAAuE;AACvE,6BAA6B;AAE7B,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,cAAc,uBAAuB,CAAC;AAEtC,4FAA4F;AAC5F,MAAM,OAAO,kBAAmB,SAAQ,MAAM,CAAC,WAAW,EAAsB,CAAC,oBAAoB,EAAE;IACrG,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CAAC;CAAG"}

package/dist/index.d.ts

@@ -3,5 +3,6 @@ export * from "./transactions.ts";
 export * from "./queries.ts";
 export * from "./client.ts";
 export * from "./deployments.ts";
+export * from "./errors.ts";
 export * as contracts from "./contracts.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AAGjC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAG5B,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -9,6 +9,7 @@ export * from "./transactions.js";
 export * from "./queries.js";
 export * from "./client.js";
 export * from "./deployments.js";
+export * from "./errors.js";
 // Generated, ABI-bound bindings (BCS structs + type-safe Move calls).
 export * as contracts from "./contracts.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AAEtC,+EAA+E;AAC/E,+EAA+E;AAC/E,yEAAyE;AACzE,6DAA6D;AAC7D,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AAEjC,sEAAsE;AACtE,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AAEtC,+EAA+E;AAC/E,+EAA+E;AAC/E,yEAAyE;AACzE,6DAA6D;AAC7D,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAE5B,sEAAsE;AACtE,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC"}

package/dist/internal.d.ts

@@ -1,5 +1,5 @@
 import type { Party } from "./types.ts";
-export declare function mapParty(id: string, d: any): Party;
+export declare function mapParty(id: string, d: any): typeof Party.Encoded;
 /** Normalizes a dynamic-field key's BCS bytes (Uint8Array or base64 string). */
 export declare function keyBytes(bcs: unknown): Uint8Array;
 //# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,GAAG,KAAK,CAclD;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAEjD"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,GAAG,OAAO,KAAK,CAAC,OAAO,CAcjE;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAEjD"}

package/dist/internal.js

@@ -1,7 +1,9 @@
 // Copyright (c) Miso Labs, Inc.
 // 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";
 // deno-lint-ignore no-explicit-any -- generated parse output is loosely typed
 export function mapParty(id, d) {

package/dist/internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AAEtC,mFAAmF;AACnF,kCAAkC;AAElC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,8EAA8E;AAC9E,MAAM,UAAU,QAAQ,CAAC,EAAU,EAAE,CAAM;IACzC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;IACpB,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IAC5C,oEAAoE;IACpE,iFAAiF;IACjF,MAAM,YAAY,GAAG,IAAI,EAAE,KAAK,IAAI,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACvF,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,YAAY,EAAE,QAAQ,IAAI,YAAY,IAAI,EAAE,CAAC;QAC9D,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAU,EAAE,EAAE,CAC3E,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAqB,EAAE,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,CACpE,CAAC;QACF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IACnE,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC;AAC/D,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,QAAQ,CAAC,GAAY;IACnC,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,GAAkB,CAAC;AACzE,CAAC"}
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AAEtC,mFAAmF;AACnF,gFAAgF;AAChF,gFAAgF;AAChF,8CAA8C;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,8EAA8E;AAC9E,MAAM,UAAU,QAAQ,CAAC,EAAU,EAAE,CAAM;IACzC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;IACpB,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IAC5C,oEAAoE;IACpE,iFAAiF;IACjF,MAAM,YAAY,GAAG,IAAI,EAAE,KAAK,IAAI,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACvF,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,YAAY,EAAE,QAAQ,IAAI,YAAY,IAAI,EAAE,CAAC;QAC9D,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAU,EAAE,EAAE,CAC3E,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAqB,EAAE,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,CACpE,CAAC;QACF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IACnE,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC;AAC/D,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,QAAQ,CAAC,GAAY;IACnC,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,GAAkB,CAAC;AACzE,CAAC"}

package/dist/queries.d.ts

@@ -1,37 +1,31 @@
-import type { ClientWithCoreApi } from "@mysten/sui/client";
-import type { Party } from "./types.ts";
-/** True for the Core API's "object does not exist" error (a missing dynamic field). */
-export declare function isNotFound(e: unknown): boolean;
-/**
- * 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 declare function getObjectContent(client: ClientWithCoreApi, objectId: string): Promise<Uint8Array | null>;
+import { Effect } from "effect";
+import { type SuiClient } from "@misofm/effect";
+import type { BcsDecodeError, ObjectNotFoundError, ObjectTypeMismatchError, SuiRpcError } from "@misofm/effect";
+import { Party } from "./types.ts";
 /** The `Party` struct tag of one partyos deployment. */
 export declare function partyType(partyPackageId: string): string;
 /** Fetches and parses a shared `Party` object of this deployment's partyos package. */
-export declare function getPartyById(client: ClientWithCoreApi, partyId: string, partyPackageId: string): Promise<Party>;
+export declare const getPartyById: (partyId: string, partyPackageId: string) => Effect.Effect<Party, BcsDecodeError | ObjectNotFoundError | ObjectTypeMismatchError | SuiRpcError, SuiClient>;
 /**
  * Fetches and parses multiple shared `Party` objects in one Core request.
  * Missing objects are skipped; an object of another type is an error.
  */
-export declare function getPartiesByIds(client: ClientWithCoreApi, partyIds: readonly string[], partyPackageId: string): Promise<Partial<Record<string, Party>>>;
+export declare const getPartiesByIds: (partyIds: readonly string[], partyPackageId: string) => Effect.Effect<Partial<Record<string, Party>>, BcsDecodeError | ObjectTypeMismatchError | SuiRpcError, SuiClient>;
 /** Derives a party's `PartyAdminCap` id (it is a `derived_object` off the party UID). */
 export declare function derivePartyAdminCapId(partyId: string, partyPackageId: string): string;
 /**
  * The group ids a party currently belongs to, read from its `MembershipKey`
  * dynamic fields (the member-side record). No indexer required.
  */
-export declare function getMemberships(client: ClientWithCoreApi, partyId: string): Promise<string[]>;
+export declare function getMemberships(partyId: string): Effect.Effect<string[], SuiRpcError, SuiClient>;
 /** The member ids invited to a group but not yet accepted (its `PendingInviteKey` fields). */
-export declare function getPendingInvites(client: ClientWithCoreApi, groupId: string): Promise<string[]>;
+export declare function getPendingInvites(groupId: string): Effect.Effect<string[], SuiRpcError, SuiClient>;
 /**
  * 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 declare function getPendingMemberships(client: ClientWithCoreApi, partyId: string): Promise<string[]>;
+export declare function getPendingMemberships(partyId: string): Effect.Effect<string[], SuiRpcError, SuiClient>;
 /** Whether `memberId` currently holds a membership record for `groupId`. */
-export declare function isMember(client: ClientWithCoreApi, memberId: string, groupId: string, partyPackageId: string): Promise<boolean>;
+export declare const isMember: (memberId: string, groupId: string, partyPackageId: string) => Effect.Effect<boolean, SuiRpcError, SuiClient>;
 //# sourceMappingURL=queries.d.ts.map

package/dist/queries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../src/queries.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAU5D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAG9C;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAQ9G;AAED,wDAAwD;AACxD,wBAAgB,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAExD;AAeD,uFAAuF;AACvF,wBAAsB,YAAY,CAChC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,KAAK,CAAC,CAWhB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAazC;AAED,yFAAyF;AACzF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAMrF;AA0BD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAElG;AAED,8FAA8F;AAC9F,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAErG;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAEzG;AAED,4EAA4E;AAC5E,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CAOlB"}
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../src/queries.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,MAAM,EAAkB,MAAM,QAAQ,CAAC;AAGhD,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAQhH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,wDAAwD;AACxD,wBAAgB,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAExD;AAYD,uFAAuF;AACvF,eAAO,MAAM,YAAY,4JAevB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe,2KAiB1B,CAAC;AAEH,yFAAyF;AACzF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAMrF;AAqBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,SAAS,CAAC,CAE/F;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,SAAS,CAAC,CAElG;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,SAAS,CAAC,CAEtG;AAED,4EAA4E;AAC5E,eAAO,MAAM,QAAQ,+GAYnB,CAAC"}

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.2.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";
@@ -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

package/src/queries.ts

@@ -2,11 +2,23 @@
 // 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.
+// 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 type { ClientWithCoreApi } from "@mysten/sui/client";
+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,
+  type SuiClient,
+} from "@misofm/effect";
+import type { BcsDecodeError, ObjectNotFoundError, ObjectTypeMismatchError, SuiRpcError } from "@misofm/effect";
 import {
   MembershipKey as MembershipKeyBcs,
   Party as PartyBcs,
@@ -14,87 +26,63 @@ import {
   PendingMembershipKey as PendingMembershipKeyBcs,
 } from "./contracts/partyos/party.ts";
 import { keyBytes, mapParty } from "./internal.ts";
-import type { Party } from "./types.ts";
-
-/** True for the Core API's "object does not exist" error (a missing dynamic field). */
-export function isNotFound(e: unknown): boolean {
-  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: ClientWithCoreApi, objectId: string): Promise<Uint8Array | null> {
-  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.ts";
 
 /** The `Party` struct tag of one partyos deployment. */
 export function partyType(partyPackageId: string): string {
   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: string, type: string | undefined, partyPackageId: string): void {
-  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: string, content: Uint8Array, expectedType: string) {
+  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: ClientWithCoreApi,
+export const getPartyById = Effect.fn("getPartyById")(function* (
   partyId: string,
   partyPackageId: string,
-): Promise<Party> {
-  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));
-}
+): Effect.fn.Return<
+  Party,
+  ObjectNotFoundError | ObjectTypeMismatchError | BcsDecodeError | SuiRpcError,
+  SuiClient
+> {
+  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: ClientWithCoreApi,
+export const getPartiesByIds = Effect.fn("getPartiesByIds")(function* (
   partyIds: readonly string[],
   partyPackageId: string,
-): Promise<Partial<Record<string, Party>>> {
+): Effect.fn.Return<
+  Partial<Record<string, Party>>,
+  ObjectTypeMismatchError | BcsDecodeError | SuiRpcError,
+  SuiClient
+> {
   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: Partial<Record<string, Party>> = {};
-  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: string, partyPackageId: string): string {
@@ -108,38 +96,33 @@ export function derivePartyAdminCapId(partyId: string, partyPackageId: string):
 // === Group membership reads ===
 
 /** Collects the ids stored in every dynamic-field key of `parentId` whose type ends with `keySuffix`. */
-async function collectKeyIds(
-  client: ClientWithCoreApi,
+function collectKeyIds(
   parentId: string,
   keySuffix: string,
   codec: { parse(bytes: Uint8Array): readonly unknown[] },
-): Promise<string[]> {
-  const ids: string[] = [];
-  let cursor: string | null | undefined;
-  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;
+): Effect.Effect<string[], SuiRpcError, SuiClient> {
+  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: ClientWithCoreApi, partyId: string): Promise<string[]> {
-  return collectKeyIds(client, partyId, "::party::MembershipKey", MembershipKeyBcs);
+export function getMemberships(partyId: string): Effect.Effect<string[], SuiRpcError, SuiClient> {
+  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: ClientWithCoreApi, groupId: string): Promise<string[]> {
-  return collectKeyIds(client, groupId, "::party::PendingInviteKey", PendingInviteKeyBcs);
+export function getPendingInvites(groupId: string): Effect.Effect<string[], SuiRpcError, SuiClient> {
+  return collectKeyIds(groupId, "::party::PendingInviteKey", PendingInviteKeyBcs);
 }
 
 /**
@@ -147,21 +130,21 @@ export async function getPendingInvites(client: ClientWithCoreApi, groupId: stri
  * This reads the member-side `PendingMembershipKey` inbox index, so it only
  * enumerates the target party's dynamic fields.
  */
-export async function getPendingMemberships(client: ClientWithCoreApi, partyId: string): Promise<string[]> {
-  return collectKeyIds(client, partyId, "::party::PendingMembershipKey", PendingMembershipKeyBcs);
+export function getPendingMemberships(partyId: string): Effect.Effect<string[], SuiRpcError, SuiClient> {
+  return collectKeyIds(partyId, "::party::PendingMembershipKey", PendingMembershipKeyBcs);
 }
 
 /** Whether `memberId` currently holds a membership record for `groupId`. */
-export async function isMember(
-  client: ClientWithCoreApi,
+export const isMember = Effect.fn("isMember")(function* (
   memberId: string,
   groupId: string,
   partyPackageId: string,
-): Promise<boolean> {
+): Effect.fn.Return<boolean, SuiRpcError, SuiClient> {
   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);
+});

package/src/types.ts

@@ -1,18 +1,21 @@
 // Copyright (c) Miso Labs, Inc.
 // SPDX-License-Identifier: Apache-2.0
 
-// Public, camelCase result types. The mappers in ./internal.ts turn the generated
-// (snake_case, Move-shaped) parse output into these.
+// 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.
 
-export type PartyKind = "individual" | "group";
+import { Schema } from "effect";
 
-export interface Party {
-  id: string;
-  kind: PartyKind;
+export const PartyKind = Schema.Literals(["individual", "group"]);
+export type PartyKind = typeof PartyKind.Type;
+
+export class Party extends Schema.Class<Party>("@misofm/partyos/Party")({
+  id: Schema.String,
+  kind: PartyKind,
   /** Human-readable name (not verified). */
-  name: string;
+  name: Schema.String,
   /** Member party ids — present only when `kind === "group"`. */
-  members?: string[];
+  members: Schema.optional(Schema.Array(Schema.String)),
   /** Unix ms when the party was created. */
-  createdAtMs: number;
-}
+  createdAtMs: Schema.Number,
+}) {}