@unicitylabs/sphere-sdk 0.17.2 → 0.17.3

package/dist/index.cjs

@@ -58,6 +58,7 @@ __export(index_exports, {
   NFT_SIGNED_TAG: () => NFT_SIGNED_TAG,
   NIP29_KINDS: () => NIP29_KINDS,
   NOSTR_EVENT_KINDS: () => NOSTR_EVENT_KINDS,
+  NO_PAYMENTS: () => NO_PAYMENTS,
   NostrClient: () => import_nostr_js_sdk6.NostrClient,
   NostrKeyManager: () => import_nostr_js_sdk6.NostrKeyManager,
   PartialSendConflictError: () => PartialSendConflictError,
@@ -17148,7 +17149,16 @@ var WalletApiSplitCheckpointStore = class {
 };
 
 // core/payments-v2-wiring.ts
+var NO_PAYMENTS = "none";
+function readPaymentsOptOut(walletApi) {
+  if (walletApi === NO_PAYMENTS) return NO_PAYMENTS;
+  throw new SphereError(
+    `walletApi must be a wallet-api transport config or the literal '${NO_PAYMENTS}' (the explicit messaging-only opt-out, #793) \u2014 received ${JSON.stringify(walletApi)}.`,
+    "INVALID_CONFIG"
+  );
+}
 function resolvePaymentsV2Composition(walletApi, sphereNetwork) {
+  if (typeof walletApi === "string") return readPaymentsOptOut(walletApi);
   const source = walletApi;
   const network = typeof source?.network === "string" && source.network !== "" ? source.network : null;
   if (!source || network === null) {
@@ -17428,7 +17438,11 @@ var Sphere = class _Sphere {
   // The payments vertical (the ONLY money path since the P11 flip)
   /** The ACTIVE address's running vertical — §7: exactly one at a time, ever. */
   _paymentsV2Active = null;
-  /** Resolved wallet-api transport composition (network + per-address factory); set at init, fail-closed. */
+  /**
+   * Money composition, set at init. `null` = never resolved (a construction bug),
+   * `NO_PAYMENTS` = the explicit #793 opt-out, an object = a real composition. One
+   * spelling for the last two would read a forgotten resolve as messaging-only.
+   */
   _paymentsV2Composition = null;
   /**
    * §7 lifecycle mutex: every stop/start pair runs strictly serialized, so
@@ -18104,10 +18118,24 @@ var Sphere = class _Sphere {
   get payments() {
     const facade = this._paymentsV2Active?.facade;
     if (!facade) {
+      if (this._paymentsV2Composition === NO_PAYMENTS) {
+        throw new SphereError(
+          "payments is not composed: this Sphere was initialised with `walletApi: 'none'`, the explicit messaging-only composition. Money has no path here \u2014 re-init with a wallet-api transport config to move any.",
+          "PAYMENTS_NOT_COMPOSED"
+        );
+      }
       throw new SphereError("Sphere not initialized", "NOT_INITIALIZED");
     }
     return facade;
   }
+  /**
+   * Whether this Sphere composes money at all (#793) — fixed for the instance's life,
+   * so a messaging-only wallet can branch without a try/catch. Not a liveness check:
+   * `true` still leaves `payments` throwing NOT_INITIALIZED mid-init or mid-switch.
+   */
+  get hasPayments() {
+    return this._paymentsV2Composition !== NO_PAYMENTS;
+  }
   /** Communications module */
   get communications() {
     this.ensureReady();
@@ -20135,6 +20163,7 @@ var Sphere = class _Sphere {
    * breaks initialization.
    */
   async buildTokenEngine(identity) {
+    if (this._paymentsV2Composition === NO_PAYMENTS) return void 0;
     const oracle = this._oracle;
     const privateKey = (identity ?? this._identity)?.privateKey;
     const trustBaseJson = oracle.getTrustBaseJson?.() ?? null;
@@ -20240,6 +20269,7 @@ var Sphere = class _Sphere {
    * setOracleApiKey rebuild is what future operations snapshot.
    */
   async startPaymentsV2Inner(index, identity) {
+    if (this._paymentsV2Composition === NO_PAYMENTS) return;
     if (!this._paymentsV2Composition) {
       throw new SphereError("wallet-api composition required for money", "INVALID_CONFIG");
     }
@@ -20924,6 +20954,7 @@ function addressesMatch(a, b) {
   NFT_SIGNED_TAG,
   NIP29_KINDS,
   NOSTR_EVENT_KINDS,
+  NO_PAYMENTS,
   NostrClient,
   NostrKeyManager,
   PartialSendConflictError,