@misofm/musicos 0.2.0 → 0.3.0

package/dist/view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../src/view.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAEjE,MAAM,WAAW,2BAA2B;IAC1C,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,oDAAoD;IACpD,KAAK,EAAE,aAAa,CAAC;IACrB,wEAAwE;IACxE,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,iBAAiB,EACzB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,MAAM,CAAC,CA2BjB"}
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../src/view.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAEjE,MAAM,WAAW,2BAA2B;IAC1C,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,oDAAoD;IACpD,KAAK,EAAE,aAAa,CAAC;IACrB,wEAAwE;IACxE,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,+GA4ChC,CAAC"}

package/dist/view.js

@@ -4,8 +4,10 @@
 // through the Core `simulateTransaction` API to read a computed value without
 // changing state — used where the value is a pure function of inputs the chain
 // derives (e.g. the deterministic release id).
+import { Effect } from "effect";
 import { Transaction } from "@mysten/sui/transactions";
 import { bcs } from "@mysten/sui/bcs";
+import { SuiClient, SuiRpcError } from "@misofm/effect";
 import * as release from "./contracts/musicos/release.js";
 import { asU256, asU64 } from "./numeric.js";
 /**
@@ -14,7 +16,7 @@ import { asU256, asU64 } from "./numeric.js";
  * Tracks embedded in a release must reference this exact ID, so it is computed
  * up front and threaded into the core release builder.
  */
-export async function deriveTargetReleaseId(client, misoPackageId, params) {
+export const deriveTargetReleaseId = Effect.fn("deriveTargetReleaseId")(function* (misoPackageId, params) {
     if (params.recordingIds.length !== params.splitBps.length) {
         throw new Error(`deriveTargetReleaseId: recordingIds (${params.recordingIds.length}) and splitBps (${params.splitBps.length}) length mismatch.`);
     }
@@ -29,14 +31,25 @@ export async function deriveTargetReleaseId(client, misoPackageId, params) {
             asU256("release nonce", params.nonce),
         ],
     }));
+    const client = yield* SuiClient;
     // gRPC/Core equivalent of devInspect: simulate with per-command return values.
-    const res = await client.core.simulateTransaction({ transaction: tx, include: { commandResults: true } });
+    const res = yield* Effect.tryPromise({
+        try: (signal) => client.core.simulateTransaction({ transaction: tx, include: { commandResults: true }, signal }),
+        catch: (cause) => new SuiRpcError({ operation: "simulateTransaction", cause }),
+    });
     if (res.$kind !== "Transaction") {
-        throw new Error(`derive_target_release_id simulation failed: ${JSON.stringify(res.FailedTransaction.status)}`);
+        return yield* new SuiRpcError({
+            operation: "simulateTransaction",
+            cause: new Error(`derive_target_release_id simulation failed: ${JSON.stringify(res.FailedTransaction.status)}`),
+        });
     }
     const returned = res.commandResults?.[0]?.returnValues?.[0]?.bcs;
-    if (!returned)
-        throw new Error("derive_target_release_id returned no value.");
+    if (!returned) {
+        return yield* new SuiRpcError({
+            operation: "simulateTransaction",
+            cause: new Error("derive_target_release_id returned no value."),
+        });
+    }
     return bcs.Address.parse(returned);
-}
+});
 //# sourceMappingURL=view.js.map

package/dist/view.js.map

@@ -1 +1 @@
-{"version":3,"file":"view.js","sourceRoot":"","sources":["../src/view.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AAEtC,kFAAkF;AAClF,8EAA8E;AAC9E,+EAA+E;AAC/E,+CAA+C;AAE/C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAEtC,OAAO,KAAK,OAAO,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,KAAK,EAAsB,MAAM,cAAc,CAAC;AAejE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAyB,EACzB,aAAqB,EACrB,MAAmC;IAEnC,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,wCAAwC,MAAM,CAAC,YAAY,CAAC,MAAM,mBAAmB,MAAM,CAAC,QAAQ,CAAC,MAAM,oBAAoB,CAAC,CAAC;IACnJ,CAAC;IAED,MAAM,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;IAC7B,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5B,EAAE,CAAC,GAAG,CACJ,OAAO,CAAC,qBAAqB,CAAC;QAC5B,OAAO,EAAE,aAAa;QACtB,SAAS,EAAE;YACT,MAAM,CAAC,iBAAiB;YACxB,MAAM,CAAC,YAAY;YACnB,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC;YACvD,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC;SACtC;KACF,CAAC,CACH,CAAC;IAEF,+EAA+E;IAC/E,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1G,IAAI,GAAG,CAAC,KAAK,KAAK,aAAa,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,+CAA+C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACjH,CAAC;IACD,MAAM,QAAQ,GAAG,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;IACjE,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAC9E,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC"}
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../src/view.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@misofm/musicos",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "packageManager": "bun@1.4.0",
   "description": "Typed bindings, queries, event decoders, and PTB builders for the Miso object model (Composition, Recording, Release, Track) on Sui.",
   "license": "Apache-2.0",
@@ -92,6 +92,10 @@
       "types": "./dist/contracts/*.d.ts",
       "default": "./dist/contracts/*.js"
     },
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "default": "./dist/errors.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -102,17 +106,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

@@ -1,11 +1,21 @@
 // Copyright (c) Miso Labs, Inc.
 // SPDX-License-Identifier: Apache-2.0
 
+import type { ConflictingWorkKindError } from "./errors.ts";
 import type {
   ClientWithCoreApi,
   SuiClientRegistration,
 } from "@mysten/sui/client";
 import type { SuiGraphQLClient } from "@mysten/sui/graphql";
+import { Effect } from "effect";
+import {
+  GraphQLUnavailableError,
+  SuiClient,
+  SuiGraphQL,
+  type BcsDecodeError,
+  type ObjectNotFoundError,
+  type SuiRpcError,
+} from "@misofm/effect";
 import {
   getMisoDeployment,
   normalizeMisoDeployment,
@@ -26,6 +36,7 @@ import type {
   RecordingAdminCap,
   Release,
   ReleaseAdminCap,
+  ReleaseRegistry,
 } from "./types.ts";
 
 // Generated call modules (type-safe Move calls) and BCS structs.
@@ -66,7 +77,7 @@ function isFullDeployment(
  * ```ts
  * const client = new SuiGrpcClient({ network: 'testnet' })
  *   .$extend(miso());
- * const composition = await client.miso.getCompositionById('0x...');
+ * const composition = await Effect.runPromise(client.miso.getCompositionById('0x...'));
  * ```
  */
 export function miso<const Name extends string = "miso">(
@@ -143,92 +154,77 @@ export class MisoProtocolClient {
     return this.#deployment.packageId;
   }
 
+  /** Provides `SuiClient` from this client's `ClientWithCoreApi`, so a method's program has `R = never`. */
+  #run<A, E>(effect: Effect.Effect<A, E, SuiClient>): Effect.Effect<A, E> {
+    return effect.pipe(Effect.provide(SuiClient.layer(this.#client)));
+  }
+
   // === Composition ===
 
-  async getCompositionById(compositionId: string): Promise<Composition> {
-    return queries.getCompositionById(this.#client, compositionId);
+  getCompositionById(compositionId: string): Effect.Effect<Composition, ObjectNotFoundError | SuiRpcError | BcsDecodeError> {
+    return this.#run(queries.getCompositionById(compositionId));
   }
-  async getCompositionsByIds(
-    ids: string[],
-  ): Promise<Record<string, Composition>> {
-    return queries.getCompositionsByIds(this.#client, ids);
+  getCompositionsByIds(ids: string[]): Effect.Effect<Record<string, Composition>, SuiRpcError | BcsDecodeError> {
+    return this.#run(queries.getCompositionsByIds(ids));
   }
-  async getWorksByIds(ids: queries.WorkIds): Promise<queries.WorksById> {
-    return queries.getWorksByIds(this.#client, ids);
+  getWorksByIds(ids: queries.WorkIds): Effect.Effect<queries.WorksById, ConflictingWorkKindError | SuiRpcError | BcsDecodeError> {
+    return this.#run(queries.getWorksByIds(ids));
   }
-  async getWorkAddressesByShareTypes(
+  getWorkAddressesByShareTypes(
     shareTypes: queries.WorkShareTypes,
-  ): Promise<queries.WorkAddressesByShareType> {
-    return queries.getWorkAddressesByShareTypes(
-      this.#requireGraphQL(),
-      shareTypes,
-      this.#misoPackageId,
-    );
+  ): Effect.Effect<queries.WorkAddressesByShareType, SuiRpcError | GraphQLUnavailableError> {
+    if (!this.#graphqlClient) return Effect.fail(new GraphQLUnavailableError());
+    return queries
+      .getWorkAddressesByShareTypes(shareTypes, this.#misoPackageId)
+      .pipe(Effect.provide(SuiGraphQL.layer(this.#graphqlClient)));
   }
-  async getCompositionShareType(compositionId: string): Promise<string> {
-    return queries.getCompositionShareType(this.#client, compositionId);
+  getCompositionShareType(compositionId: string): Effect.Effect<string, ObjectNotFoundError | SuiRpcError> {
+    return this.#run(queries.getCompositionShareType(compositionId));
   }
-  async getCompositionByShareType(shareType: string): Promise<Composition> {
-    return queries.getCompositionByShareType(
-      this.#client,
-      this.#requireGraphQL(),
-      shareType,
-      this.#misoPackageId,
+  getCompositionByShareType(
+    shareType: string,
+  ): Effect.Effect<Composition, ObjectNotFoundError | SuiRpcError | BcsDecodeError | GraphQLUnavailableError> {
+    if (!this.#graphqlClient) return Effect.fail(new GraphQLUnavailableError());
+    return queries.getCompositionByShareType(shareType, this.#misoPackageId).pipe(
+      Effect.provide(SuiGraphQL.layer(this.#graphqlClient)),
+      Effect.provide(SuiClient.layer(this.#client)),
     );
   }
-  async getCompositionAdminCapById(
-    adminCapId: string,
-  ): Promise<CompositionAdminCap> {
-    return queries.getCompositionAdminCapById(this.#client, adminCapId);
-  }
-  async getOwnedCompositionAdminCaps(
-    owner: string,
-  ): Promise<CompositionAdminCap[]> {
-    return queries.getOwnedCompositionAdminCaps(
-      this.#client,
-      owner,
-      this.#misoPackageId,
-    );
+  getCompositionAdminCapById(adminCapId: string): Effect.Effect<CompositionAdminCap, ObjectNotFoundError | SuiRpcError> {
+    return this.#run(queries.getCompositionAdminCapById(adminCapId));
+  }
+  getOwnedCompositionAdminCaps(owner: string): Effect.Effect<CompositionAdminCap[], SuiRpcError> {
+    return this.#run(queries.getOwnedCompositionAdminCaps(owner, this.#misoPackageId));
   }
   deriveCompositionAdminCapId(compositionId: string): string {
-    return queries.deriveCompositionAdminCapId(
-      compositionId,
-      this.#misoPackageId,
-    );
+    return queries.deriveCompositionAdminCapId(compositionId, this.#misoPackageId);
   }
 
   // === Recording ===
 
-  async getRecordingById(recordingId: string): Promise<Recording> {
-    return queries.getRecordingById(this.#client, recordingId);
+  getRecordingById(recordingId: string): Effect.Effect<Recording, ObjectNotFoundError | SuiRpcError | BcsDecodeError> {
+    return this.#run(queries.getRecordingById(recordingId));
   }
-  async getRecordingsByIds(ids: string[]): Promise<Record<string, Recording>> {
-    return queries.getRecordingsByIds(this.#client, ids);
+  getRecordingsByIds(ids: string[]): Effect.Effect<Record<string, Recording>, SuiRpcError | BcsDecodeError> {
+    return this.#run(queries.getRecordingsByIds(ids));
   }
-  async getRecordingShareType(recordingId: string): Promise<string> {
-    return queries.getRecordingShareType(this.#client, recordingId);
+  getRecordingShareType(recordingId: string): Effect.Effect<string, ObjectNotFoundError | SuiRpcError> {
+    return this.#run(queries.getRecordingShareType(recordingId));
   }
-  async getRecordingByShareType(shareType: string): Promise<Recording> {
-    return queries.getRecordingByShareType(
-      this.#client,
-      this.#requireGraphQL(),
-      shareType,
-      this.#misoPackageId,
+  getRecordingByShareType(
+    shareType: string,
+  ): Effect.Effect<Recording, ObjectNotFoundError | SuiRpcError | BcsDecodeError | GraphQLUnavailableError> {
+    if (!this.#graphqlClient) return Effect.fail(new GraphQLUnavailableError());
+    return queries.getRecordingByShareType(shareType, this.#misoPackageId).pipe(
+      Effect.provide(SuiGraphQL.layer(this.#graphqlClient)),
+      Effect.provide(SuiClient.layer(this.#client)),
     );
   }
-  async getRecordingAdminCapById(
-    adminCapId: string,
-  ): Promise<RecordingAdminCap> {
-    return queries.getRecordingAdminCapById(this.#client, adminCapId);
-  }
-  async getOwnedRecordingAdminCaps(
-    owner: string,
-  ): Promise<RecordingAdminCap[]> {
-    return queries.getOwnedRecordingAdminCaps(
-      this.#client,
-      owner,
-      this.#misoPackageId,
-    );
+  getRecordingAdminCapById(adminCapId: string): Effect.Effect<RecordingAdminCap, ObjectNotFoundError | SuiRpcError> {
+    return this.#run(queries.getRecordingAdminCapById(adminCapId));
+  }
+  getOwnedRecordingAdminCaps(owner: string): Effect.Effect<RecordingAdminCap[], SuiRpcError> {
+    return this.#run(queries.getOwnedRecordingAdminCaps(owner, this.#misoPackageId));
   }
   deriveRecordingAdminCapId(recordingId: string): string {
     return queries.deriveRecordingAdminCapId(recordingId, this.#misoPackageId);
@@ -236,54 +232,47 @@ export class MisoProtocolClient {
 
   // === Release ===
 
-  async getReleaseById(releaseId: string): Promise<Release> {
-    return queries.getReleaseById(this.#client, releaseId);
+  getReleaseById(releaseId: string): Effect.Effect<Release, ObjectNotFoundError | SuiRpcError | BcsDecodeError> {
+    return this.#run(queries.getReleaseById(releaseId));
   }
   /** Read the shared canonical core `miso::release::ReleaseRegistry`. */
-  async getReleaseRegistryById(registryId: string) {
-    return queries.getReleaseRegistryById(this.#client, registryId);
+  getReleaseRegistryById(registryId: string): Effect.Effect<ReleaseRegistry, ObjectNotFoundError | SuiRpcError | BcsDecodeError> {
+    return this.#run(queries.getReleaseRegistryById(registryId));
   }
-  async getReleasesByIds(ids: string[]): Promise<Record<string, Release>> {
-    return queries.getReleasesByIds(this.#client, ids);
+  getReleasesByIds(ids: string[]): Effect.Effect<Record<string, Release>, SuiRpcError | BcsDecodeError> {
+    return this.#run(queries.getReleasesByIds(ids));
   }
-  async getReleaseAdminCapById(adminCapId: string): Promise<ReleaseAdminCap> {
-    return queries.getReleaseAdminCapById(this.#client, adminCapId);
+  getReleaseAdminCapById(adminCapId: string): Effect.Effect<ReleaseAdminCap, ObjectNotFoundError | SuiRpcError> {
+    return this.#run(queries.getReleaseAdminCapById(adminCapId));
   }
   deriveReleaseAdminCapId(releaseId: string): string {
     return queries.deriveReleaseAdminCapId(releaseId, this.#misoPackageId);
   }
-  async getOwnedReleaseAdminCaps(owner: string): Promise<ReleaseAdminCap[]> {
-    return queries.getOwnedReleaseAdminCaps(
-      this.#client,
-      owner,
-      this.#misoPackageId,
-    );
+  getOwnedReleaseAdminCaps(owner: string): Effect.Effect<ReleaseAdminCap[], SuiRpcError> {
+    return this.#run(queries.getOwnedReleaseAdminCaps(owner, this.#misoPackageId));
   }
+
   // === Share Currency ===
 
-  async getShareCurrencyType(shareCurrencyId: string): Promise<string> {
-    return queries.getShareCurrencyType(this.#client, shareCurrencyId);
+  getShareCurrencyType(shareCurrencyId: string): Effect.Effect<string, ObjectNotFoundError | SuiRpcError> {
+    return this.#run(queries.getShareCurrencyType(shareCurrencyId));
   }
   /**
    * The `TreasuryCap<shareType>` owned by `owner`. Takes the share TYPE — if you
    * hold only the `Currency` object id, resolve it first with
    * {@link getShareCurrencyType}.
    */
-  async getShareCurrencyTreasuryCap(
-    shareType: string,
-    owner: string,
-  ): Promise<string> {
-    return queries.getShareCurrencyTreasuryCap(this.#client, shareType, owner);
+  getShareCurrencyTreasuryCap(shareType: string, owner: string): Effect.Effect<string, SuiRpcError> {
+    return this.#run(queries.getShareCurrencyTreasuryCap(shareType, owner));
   }
 
   // === Simulate-based reads (view) ===
 
   get view() {
-    const client = this.#client;
     const misoPackageId = this.#misoPackageId;
     return {
       deriveTargetReleaseId: (params: view.DeriveTargetReleaseIdParams) =>
-        view.deriveTargetReleaseId(client, misoPackageId, params),
+        this.#run(view.deriveTargetReleaseId(misoPackageId, params)),
     };
   }
 
@@ -326,15 +315,6 @@ export class MisoProtocolClient {
       events: eventParsers,
     };
   }
-
-  #requireGraphQL(): SuiGraphQLClient {
-    if (!this.#graphqlClient) {
-      throw new Error(
-        "GraphQL client required. Pass graphqlClient to miso() options.",
-      );
-    }
-    return this.#graphqlClient;
-  }
 }
 
 /** @deprecated Prefer the layer-specific `MisoProtocolClient` name. */

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/errors";
 
 /** Sui networks for which this SDK may bundle a verified deployment. */
 export type MisoNetwork = "mainnet" | "testnet";
@@ -164,3 +166,16 @@ export function normalizeMisoDeployment(deployment: unknown): MisoDeployment {
     Object.fromEntries(CANONICAL_MISO_PACKAGE_NAMES.map((name) => [name, deployment[name]])),
   ) as MisoDeployment;
 }
+
+/**
+ * Effect-returning form of {@link assertMisoDeployment} + {@link normalizeMisoDeployment}, for
+ * configuration boundaries that are already composing `Effect` programs (e.g. loading a
+ * deployment manifest from a config service). Synchronous and pure — validation is not I/O — so
+ * both this and the throwing form are fine; use whichever fits the call site.
+ */
+export function validateMisoDeployment(deployment: unknown): Effect.Effect<MisoDeployment, DeploymentError> {
+  return Effect.try({
+    try: () => normalizeMisoDeployment(deployment),
+    catch: (cause) => new DeploymentError({ message: cause instanceof Error ? cause.message : String(cause) }),
+  });
+}

package/src/errors.ts

@@ -0,0 +1,30 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+// `@misofm/musicos` has no failure modes of its own beyond the shared Sui
+// read/write vocabulary — every query is a Core object read, a GraphQL type
+// discovery, or a BCS decode, and every one of those is already covered by
+// `@misofm/effect`'s tagged errors. Re-exported here so callers can import the
+// complete error vocabulary from one place (`@misofm/musicos/errors`) without
+// also depending on `@misofm/effect` directly.
+import { Schema } from "effect";
+
+export {
+  ObjectNotFoundError,
+  ObjectTypeMismatchError,
+  SuiRpcError,
+  BcsDecodeError,
+  TransactionFailedError,
+  GraphQLUnavailableError,
+  DeploymentError,
+  type SuiReadError,
+} from "@misofm/effect/errors";
+
+/** One object id was requested under two different work kinds in a single batched read. */
+export class ConflictingWorkKindError extends Schema.TaggedError<ConflictingWorkKindError>()(
+  "ConflictingWorkKindError",
+  {
+    objectId: Schema.String,
+    kinds: Schema.Array(Schema.String),
+  },
+) {}

package/src/events.ts

@@ -7,8 +7,8 @@
  * and nested layouts exactly, which is the safe indexer boundary.
  */
 
+import type { BcsParser } from "@misofm/effect";
 import * as release from "./contracts/musicos/release.ts";
-import type { BcsParser } from "./queries.ts";
 
 /** Decode raw event BCS with the corresponding generated codec. */
 export function decodeEvent<T>(codec: BcsParser<T>, bytes: Uint8Array): T {

package/src/execute.ts

@@ -2,136 +2,8 @@
 // SPDX-License-Identifier: Apache-2.0
 
 // Transaction execution + effect extraction (the Signer-parameter pattern).
-//
-// Builders elsewhere only *append* to a caller-owned Transaction; this module is
-// where a transaction is actually submitted. `signAndExecute` submits over the
-// unified Core API, unwraps the `{ $kind: "Transaction", Transaction }` envelope,
-// waits for finality, and returns changed objects, the objectId→type map, balance
-// changes, and net gas for downstream extraction. Everything here is
-// transport-agnostic — it takes any `ClientWithCoreApi`, so gRPC / JSON-RPC /
-// GraphQL clients all work.
-//
-
-import { Transaction } from "@mysten/sui/transactions";
-import type { ClientWithCoreApi, SuiClientTypes } from "@mysten/sui/client";
-import type { Signer } from "@mysten/sui/cryptography";
-import type { TxThunk } from "./transactions.ts";
-
-/** The effect fields every submit path requests, so extraction is uniform. */
-export const FULL_INCLUDE = { effects: true, objectTypes: true, balanceChanges: true } as const;
-type FullInclude = typeof FULL_INCLUDE;
-
-export interface ExecResult {
-  digest: string;
-  /** Objects created/mutated/deleted by the transaction. */
-  changedObjects: SuiClientTypes.ChangedObject[];
-  /** Map of changed objectId → fully-qualified type. */
-  objectTypes: Record<string, string>;
-  /** Net coin balance deltas by address. */
-  balanceChanges: SuiClientTypes.BalanceChange[];
-  /** Net gas cost in MIST (computation + storage − rebate). */
-  gasUsed: number;
-}
-
-/** Builds a fresh Transaction from one or more thunks (awaiting async ones). */
-export async function buildTx(...thunks: TxThunk[]): Promise<Transaction> {
-  const tx = new Transaction();
-  for (const thunk of thunks) await thunk(tx);
-  return tx;
-}
-
-/** Normalizes the `{ $kind }` transaction-result envelope into an {@link ExecResult}. */
-export function toExecResult(res: SuiClientTypes.TransactionResult<FullInclude>): ExecResult {
-  if (res.$kind !== "Transaction") {
-    const failed = res.FailedTransaction;
-    const status = failed.effects?.status;
-    const err = status && !status.success ? JSON.stringify(status.error) : "unknown error";
-    throw new Error(`Transaction failed: ${err} (digest ${failed.digest})`);
-  }
-
-  const t = res.Transaction;
-  const effects = t.effects as SuiClientTypes.TransactionEffects;
-  if (!effects.status.success) {
-    throw new Error(`Transaction reverted: ${JSON.stringify(effects.status.error)} (digest ${t.digest})`);
-  }
-
-  return {
-    digest: t.digest,
-    changedObjects: effects.changedObjects,
-    objectTypes: (t.objectTypes as Record<string, string>) ?? {},
-    balanceChanges: (t.balanceChanges as SuiClientTypes.BalanceChange[]) ?? [],
-    gasUsed: netGas(effects.gasUsed),
-  };
-}
-
-/** Signs, executes, and waits for a transaction; returns changes, types, gas. */
-export async function signAndExecute(client: ClientWithCoreApi, signer: Signer, tx: Transaction): Promise<ExecResult> {
-  const res = await client.core.signAndExecuteTransaction({ transaction: tx, signer, include: FULL_INCLUDE });
-  const result = toExecResult(res);
-  await client.core.waitForTransaction({ digest: result.digest });
-  return result;
-}
-
-/** Convenience: build from thunks, then sign+execute in one call. */
-export async function execThunks(client: ClientWithCoreApi, signer: Signer, ...thunks: TxThunk[]): Promise<ExecResult> {
-  return signAndExecute(client, signer, await buildTx(...thunks));
-}
-
-// ── Object-change extractors ────────────────────────────────────────────────
-
-/** The package id from the (single) newly-published package. */
-export function publishedPackageId(r: ExecResult): string {
-  const pkg = r.changedObjects.find((c) => c.idOperation === "Created" && c.outputState === "PackageWrite");
-  if (!pkg) throw new Error("No published package found in object changes.");
-  return pkg.objectId;
-}
-
-/** All package ids newly published by the transaction (up to 5 per PTB). */
-export function allPublishedPackageIds(r: ExecResult): string[] {
-  return r.changedObjects
-    .filter((c) => c.idOperation === "Created" && c.outputState === "PackageWrite")
-    .map((c) => c.objectId);
-}
-
-/** The first newly-created object whose type contains `substr`. */
-export function createdByType(r: ExecResult, substr: string): string {
-  const id = maybeCreatedByType(r, substr);
-  if (!id) throw new Error(`No created object with type containing "${substr}" found in object changes.`);
-  return id;
-}
-
-/** Like {@link createdByType} but returns undefined instead of throwing. */
-export function maybeCreatedByType(r: ExecResult, substr: string): string | undefined {
-  for (const c of r.changedObjects) {
-    if (c.idOperation === "Created" && (r.objectTypes[c.objectId] ?? "").includes(substr)) return c.objectId;
-  }
-  return undefined;
-}
-
-/** The first newly-created object whose type is EXACTLY `type` (for non-generic types). */
-export function createdByExactType(r: ExecResult, type: string): string {
-  for (const c of r.changedObjects) {
-    if (c.idOperation === "Created" && r.objectTypes[c.objectId] === type) return c.objectId;
-  }
-  throw new Error(`No created object of exact type "${type}" found in object changes.`);
-}
-
-/** All newly-created objects whose type contains `substr`. */
-export function allCreatedByType(r: ExecResult, substr: string): { objectId: string; objectType: string }[] {
-  const out: { objectId: string; objectType: string }[] = [];
-  for (const c of r.changedObjects) {
-    const type = r.objectTypes[c.objectId] ?? "";
-    if (c.idOperation === "Created" && type.includes(substr)) out.push({ objectId: c.objectId, objectType: type });
-  }
-  return out;
-}
-
-/** The signed balance delta for `address` in `coinType`, or "0" if absent. */
-export function balanceDelta(r: ExecResult, address: string, coinType: string): string {
-  const change = r.balanceChanges.find((b) => b.address === address && b.coinType === coinType);
-  return change?.amount ?? "0";
-}
-
-function netGas(gasUsed: SuiClientTypes.GasCostSummary): number {
-  return Number(gasUsed.computationCost) + Number(gasUsed.storageCost) - Number(gasUsed.storageRebate);
-}
+// This module is a thin re-export of `@misofm/effect/execute` so the
+// `@misofm/musicos/execute` subpath keeps resolving for existing callers —
+// the implementation is transport-agnostic and shared across every `@misofm/*`
+// SDK, so there is exactly one copy of it.
+export * from "@misofm/effect/execute";