@unicitylabs/sphere-sdk 0.17.2-dev.3 → 0.17.3

package/dist/core/index.cjs

@@ -38,6 +38,7 @@ __export(core_exports, {
   FIELD_ENVELOPE_MAX_BYTES: () => FIELD_ENVELOPE_MAX_BYTES,
   FIELD_ENVELOPE_NONCE_BYTES: () => FIELD_ENVELOPE_NONCE_BYTES,
   FIELD_ENVELOPE_PREFIX: () => FIELD_ENVELOPE_PREFIX,
+  NO_PAYMENTS: () => NO_PAYMENTS,
   PartialSendConflictError: () => PartialSendConflictError,
   SIGN_MESSAGE_PREFIX: () => SIGN_MESSAGE_PREFIX,
   Sphere: () => Sphere,
@@ -4624,6 +4625,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);
@@ -5235,9 +5256,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]],
@@ -17041,7 +17062,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) {
@@ -17321,7 +17351,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
@@ -17997,10 +18031,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();
@@ -20028,6 +20076,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;
@@ -20133,6 +20182,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");
     }
@@ -20513,6 +20563,7 @@ async function runCustomCheck(name, checkFn, timeoutMs) {
   FIELD_ENVELOPE_MAX_BYTES,
   FIELD_ENVELOPE_NONCE_BYTES,
   FIELD_ENVELOPE_PREFIX,
+  NO_PAYMENTS,
   PartialSendConflictError,
   SIGN_MESSAGE_PREFIX,
   Sphere,