@unicitylabs/sphere-sdk 0.17.2-dev.3 → 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,
@@ -4696,6 +4697,26 @@ var GroupVisibility = {
   PRIVATE: "PRIVATE"
 };
 
+// modules/groupchat/group-id.ts
+var MAX_SLUG_LENGTH = 24;
+var RANDOM_BYTES = 8;
+function groupIdSlug(name) {
+  const slug = name.normalize("NFKD").replace(/\p{M}/gu, "").toLowerCase().replace(/['\u2019]/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  if (slug.length <= MAX_SLUG_LENGTH) return slug;
+  const head = slug.slice(0, MAX_SLUG_LENGTH + 1);
+  const hyphen = head.lastIndexOf("-");
+  return hyphen > 0 ? head.slice(0, hyphen) : slug.slice(0, MAX_SLUG_LENGTH);
+}
+function newGroupId(name) {
+  const crypto2 = globalThis.crypto;
+  if (typeof crypto2?.getRandomValues !== "function") {
+    throw new SphereError("Creating a group requires crypto.getRandomValues", "INVALID_CONFIG");
+  }
+  const bytes = crypto2.getRandomValues(new Uint8Array(RANDOM_BYTES));
+  const random = Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+  return `${groupIdSlug(name) || "group"}-${random}`;
+}
+
 // modules/groupchat/GroupChatModule.ts
 function createNip29Filter(data) {
   return new import_nostr_js_sdk3.Filter(data);
@@ -5307,9 +5328,9 @@ var GroupChatModule = class {
     if (!this.client) return null;
     const creatorPubkey = this.getMyPublicKey();
     if (!creatorPubkey) return null;
-    const proposedGroupId = options.name.toLowerCase().replace(/[^a-z0-9]/g, "").slice(0, 20) || this.randomId();
     try {
       const isPrivate = options.visibility === GroupVisibility.PRIVATE;
+      const proposedGroupId = newGroupId(options.name);
       const eventId = await this.client.createAndPublishEvent({
         kind: NIP29_KINDS.CREATE_GROUP,
         tags: [["h", proposedGroupId]],
@@ -17128,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) {
@@ -17408,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
@@ -18084,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();
@@ -20115,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;
@@ -20220,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");
     }
@@ -20904,6 +20954,7 @@ function addressesMatch(a, b) {
   NFT_SIGNED_TAG,
   NIP29_KINDS,
   NOSTR_EVENT_KINDS,
+  NO_PAYMENTS,
   NostrClient,
   NostrKeyManager,
   PartialSendConflictError,