@wishknish/knishio-client-ts 0.9.5 → 0.9.6

package/dist/index.cjs

@@ -2178,11 +2178,9 @@ function verifyOTSSignature(otsFragments, molecularHash, signingAddress) {
     const base17Hash = convertToBase17(molecularHash);
     const enumerated = enumerateMolecularHash(base17Hash);
     const normalized = normalizeMolecularHash(enumerated);
-    let ots = otsFragments;
+    const ots = otsFragments;
     if (ots.length !== 2048) {
-      if (ots.length !== 2048) {
-        return false;
-      }
+      return false;
     }
     const otsChunks = [];
     for (let i = 0; i < ots.length; i += CRYPTO_CONSTANTS.KEY_FRAGMENT_SIZE) {
@@ -2685,6 +2683,123 @@ var Meta = class {
     });
   }
 };
+
+// src/libraries/array.ts
+function deepCloning(o, h) {
+  let i;
+  let r;
+  let x;
+  const t = [Array, Date, Number, String, Boolean];
+  const s = Object.prototype.toString;
+  h = h || [];
+  for (i = 0; i < h.length; i += 2) {
+    if (o === h[i]) {
+      return h[i + 1];
+    }
+  }
+  if (!r && o && typeof o === "object") {
+    r = {};
+    for (i = 0; i < t.length; i++) {
+      if (s.call(o) === s.call(x = new t[i](o))) {
+        r = i ? x : [];
+      }
+    }
+    h.push(o, r);
+    for (i in o) {
+      if (Object.prototype.hasOwnProperty.call(o, i)) {
+        r[i] = deepCloning(o[i], h);
+      }
+    }
+  }
+  return r || o;
+}
+function chunkArray(arr, size) {
+  const chunks = [];
+  for (let i = 0; i < arr.length; i += size) {
+    chunks.push(arr.slice(i, i + size));
+  }
+  return chunks;
+}
+function diff(...arrays) {
+  return [].concat(...arrays.map((arr, i) => {
+    const others = arrays.slice(0);
+    others.splice(i, 1);
+    const unique = [...new Set([].concat(...others))];
+    return arr.filter((item) => !unique.includes(item));
+  }));
+}
+function intersect(...arrays) {
+  if (arrays.length === 0) return [];
+  if (arrays.length === 1) return arrays[0];
+  return arrays.reduce(
+    (first, second) => first.filter((item) => second.includes(item))
+  );
+}
+
+// src/core/PolicyMeta.ts
+var PolicyMeta = class _PolicyMeta {
+  policy;
+  /**
+   * Create new PolicyMeta instance
+   * Matches JavaScript SDK constructor signature exactly
+   */
+  constructor(policy = {}, metaKeys = []) {
+    this.policy = _PolicyMeta.normalizePolicy(policy);
+    this.fillDefault(metaKeys);
+  }
+  /**
+   * Normalize policy object structure
+   * Matches JavaScript SDK normalizePolicy method exactly
+   */
+  static normalizePolicy(policy = {}) {
+    const policyMeta = {};
+    for (const [policyKey, value] of Object.entries(policy)) {
+      if (value !== null && ["read", "write"].includes(policyKey)) {
+        policyMeta[policyKey] = {};
+        for (const [key, content] of Object.entries(value)) {
+          policyMeta[policyKey][key] = content;
+        }
+      }
+    }
+    return policyMeta;
+  }
+  /**
+   * Fill default policy values for metadata keys
+   * Matches JavaScript SDK fillDefault method exactly
+   */
+  fillDefault(metaKeys = []) {
+    const readPolicy = Array.from(this.policy).filter((item) => item.action === "read");
+    const writePolicy = Array.from(this.policy).filter((item) => item.action === "write");
+    for (const [type, value] of Object.entries({
+      read: readPolicy,
+      write: writePolicy
+    })) {
+      const policyKey = value.map((item) => item.key);
+      if (!this.policy[type]) {
+        this.policy[type] = {};
+      }
+      for (const key of diff(metaKeys, policyKey)) {
+        if (!this.policy[type][key]) {
+          this.policy[type][key] = type === "write" && !["characters", "pubkey"].includes(key) ? ["self"] : ["all"];
+        }
+      }
+    }
+  }
+  /**
+   * Get the policy object
+   * Matches JavaScript SDK get method exactly
+   */
+  get() {
+    return this.policy;
+  }
+  /**
+   * Convert policy to JSON string
+   * Matches JavaScript SDK toJson method exactly
+   */
+  toJson() {
+    return JSON.stringify(this.get());
+  }
+};
 var AtomMeta = class _AtomMeta {
   meta;
   /**
@@ -2780,8 +2895,9 @@ var AtomMeta = class _AtomMeta {
    * @return This instance for chaining
    */
   addPolicy(policy) {
+    const policyMeta = new PolicyMeta(policy, Object.keys(this.meta));
     this.merge({
-      policy: JSON.stringify(policy)
+      policy: policyMeta.toJson()
     });
     return this;
   }
@@ -3414,6 +3530,87 @@ function createMolecularHash(value) {
   }
   return value;
 }
+
+// src/core/TokenUnit.ts
+var TokenUnit = class _TokenUnit {
+  id;
+  name;
+  metas;
+  /**
+   * Create new TokenUnit instance
+   * Matches JavaScript SDK constructor signature exactly
+   */
+  constructor(id, name, metas) {
+    this.id = id;
+    this.name = name;
+    this.metas = metas || {};
+  }
+  /**
+   * Create TokenUnit from GraphQL response data
+   * Matches JavaScript SDK createFromGraphQL method exactly
+   */
+  static createFromGraphQL(data) {
+    let metas = data.metas || {};
+    if (Array.isArray(metas) && metas.length) {
+      try {
+        metas = JSON.parse(metas);
+        if (!metas) {
+          metas = {};
+        }
+      } catch (error) {
+        metas = {};
+      }
+    }
+    return new _TokenUnit(
+      data.id,
+      data.name,
+      metas
+    );
+  }
+  /**
+   * Create TokenUnit from database array data
+   * Matches JavaScript SDK createFromDB method exactly
+   */
+  static createFromDB(data) {
+    return new _TokenUnit(
+      data[0],
+      data[1],
+      data.length > 2 ? data[2] : {}
+    );
+  }
+  /**
+   * Get fragment zone from metadata
+   * Matches JavaScript SDK getFragmentZone method exactly
+   */
+  getFragmentZone() {
+    return this.metas.fragmentZone || null;
+  }
+  /**
+   * Get fused token units from metadata
+   * Matches JavaScript SDK getFusedTokenUnits method exactly
+   */
+  getFusedTokenUnits() {
+    return this.metas.fusedTokenUnits || null;
+  }
+  /**
+   * Convert to data array format
+   * Matches JavaScript SDK toData method exactly
+   */
+  toData() {
+    return [this.id, this.name, this.metas];
+  }
+  /**
+   * Convert to GraphQL response format
+   * Matches JavaScript SDK toGraphQLResponse method exactly
+   */
+  toGraphQLResponse() {
+    return {
+      id: this.id,
+      name: this.name,
+      metas: JSON.stringify(this.metas)
+    };
+  }
+};
 var Wallet = class _Wallet {
   token;
   balance;
@@ -3554,11 +3751,13 @@ var Wallet = class _Wallet {
     return typeof maybeBundleHash === "string" && isBundleHash(maybeBundleHash);
   }
   /**
-   * Get formatted token units from raw data
-   * Stub implementation for now
+   * Map raw token-unit tuples to TokenUnit instances.
+   * Matches JS SDK Wallet.getTokenUnits (Wallet.js:190-196). The serialised shape reaches hashed
+   * atom meta via AtomMeta.setAtomWallet -> JSON.stringify(getTokenUnitsData()), so returning raw
+   * tuples here would diverge from every other SDK.
    */
   static getTokenUnits(unitsData) {
-    return unitsData;
+    return unitsData.map((unitData) => TokenUnit.createFromDB(unitData));
   }
   /**
    * Create a remainder wallet for transactions
@@ -3855,7 +4054,7 @@ zod.z.string().regex(base17HashRegex, "Molecular hash must be base17 format (0-9
 var TokenSlugSchema = zod.z.string().min(1, "Token slug cannot be empty").max(64, "Token slug cannot exceed 64 characters").transform((val) => val.toUpperCase()).brand();
 var MetaTypeSchema = zod.z.string().min(1, "Meta type cannot be empty").max(256, "Meta type cannot exceed 256 characters").brand();
 var MetaIdSchema = zod.z.string().min(1, "Meta ID cannot be empty").brand();
-var BatchIdSchema = zod.z.string().min(1, "Batch ID cannot be empty").brand();
+var BatchIdSchema = zod.z.string().regex(/^[0-9a-fA-F]{64}$/, "Batch ID must be 64 hexadecimal characters").brand();
 var CellSlugSchema = zod.z.string().min(1, "Cell slug cannot be empty").max(64, "Cell slug cannot exceed 64 characters").brand();
 var AtomIsotopeSchema = zod.z.enum(["C", "V", "U", "T", "M", "I", "R", "B", "F"], {
   error: "Invalid atom isotope. Must be one of: C, V, U, T, M, I, R, B, F"
@@ -4179,58 +4378,6 @@ var RuleArgumentException = class extends exports.BaseException {
 };
 var RuleArgumentException_default = RuleArgumentException;
 
-// src/libraries/array.ts
-function deepCloning(o, h) {
-  let i;
-  let r;
-  let x;
-  const t = [Array, Date, Number, String, Boolean];
-  const s = Object.prototype.toString;
-  h = h || [];
-  for (i = 0; i < h.length; i += 2) {
-    if (o === h[i]) {
-      return h[i + 1];
-    }
-  }
-  if (!r && o && typeof o === "object") {
-    r = {};
-    for (i = 0; i < t.length; i++) {
-      if (s.call(o) === s.call(x = new t[i](o))) {
-        r = i ? x : [];
-      }
-    }
-    h.push(o, r);
-    for (i in o) {
-      if (Object.prototype.hasOwnProperty.call(o, i)) {
-        r[i] = deepCloning(o[i], h);
-      }
-    }
-  }
-  return r || o;
-}
-function chunkArray(arr, size) {
-  const chunks = [];
-  for (let i = 0; i < arr.length; i += size) {
-    chunks.push(arr.slice(i, i + size));
-  }
-  return chunks;
-}
-function diff(...arrays) {
-  return [].concat(...arrays.map((arr, i) => {
-    const others = arrays.slice(0);
-    others.splice(i, 1);
-    const unique = [...new Set([].concat(...others))];
-    return arr.filter((item) => !unique.includes(item));
-  }));
-}
-function intersect(...arrays) {
-  if (arrays.length === 0) return [];
-  if (arrays.length === 1) return arrays[0];
-  return arrays.reduce(
-    (first, second) => first.filter((item) => second.includes(item))
-  );
-}
-
 // src/instance/rules/Callback.ts
 init_exception();
 var CallbackParamsSchema = zod.z.object({
@@ -5561,6 +5708,51 @@ var Molecule = class _Molecule {
     }));
     return this;
   }
+  /**
+   * Replenishes non-finite token supplies.
+   * Matches JS SDK Molecule.replenishToken (Molecule.js:521-566) exactly.
+   *
+   * Two orderings here are load-bearing for the molecular hash and must not be reordered:
+   * the remainder balance is computed BEFORE the source balance is overwritten, and the
+   * source V-atom is added BEFORE the remainder V-atom.
+   */
+  replenishToken({
+    amount,
+    units = []
+  }) {
+    if (amount < 0) {
+      throw new NegativeAmountException("Molecule::replenishToken() - Amount to replenish must be positive!");
+    }
+    if (!this.sourceWallet || !this.remainderWallet) {
+      throw new Error("Source and remainder wallets required for token replenishment");
+    }
+    if (units.length) {
+      const formatted = Wallet.getTokenUnits(units);
+      this.remainderWallet.tokenUnits = this.sourceWallet.tokenUnits;
+      for (const unit of formatted) {
+        this.remainderWallet.tokenUnits.push(unit);
+      }
+      this.remainderWallet.balance = String(this.remainderWallet.tokenUnits.length);
+      this.sourceWallet.tokenUnits = formatted;
+      this.sourceWallet.balance = String(this.sourceWallet.tokenUnits.length);
+    } else {
+      this.remainderWallet.balance = String(Number(this.sourceWallet.balance) + amount);
+      this.sourceWallet.balance = String(amount);
+    }
+    this.addAtom(Atom.create({
+      isotope: "V",
+      wallet: this.sourceWallet,
+      value: Number(this.sourceWallet.balance)
+    }));
+    this.addAtom(Atom.create({
+      isotope: "V",
+      wallet: this.remainderWallet,
+      value: Number(this.remainderWallet.balance),
+      metaType: "walletBundle",
+      metaId: this.remainderWallet.bundle
+    }));
+    return this;
+  }
   /**
    * Initialize authorization request
    * Creates U-isotope (authorization) atom for requesting auth token
@@ -6095,16 +6287,27 @@ var GraphQLClient = class {
     return core.createClient({
       url: serverUri,
       exchanges,
-      // PQ-transport Phase E: when encryption is on, route fetch through the CipherHash wrapper
-      // (encrypt the request body to the validator's ML-KEM pubkey, decrypt the response).
-      // Omitted → urql uses the global fetch (plaintext).
-      ...this.cipherLink ? { fetch: ((input, init) => this.cipherFetch(input, init)) } : {},
+      // urql 5 had no default and always POSTed; urql 6 defaults to 'within-url-limit', which
+      // URL-encodes short queries and sends NO body. That would silently disable the CipherHash
+      // envelope below — cipherFetch's `typeof init.body === 'string'` guard fails on a GET, so
+      // the query would leave as plaintext URL parameters with no error. Pin POST explicitly.
+      preferGetMethod: false,
+      // Always route through our own fetch. Two reasons: (1) PQ-transport Phase E — when
+      // encryption is on, cipherFetch wraps the request body in the CipherHash envelope and
+      // decrypts the response; (2) the 60s timeout. urql's makeFetchSource unconditionally
+      // overwrites init.signal with its own AbortController, so a signal returned from
+      // fetchOptions() is discarded and never fired. Combining it here is the only place it
+      // survives.
+      fetch: ((input, init) => {
+        const timeoutSignal = AbortSignal.timeout(6e4);
+        const signal = init?.signal && typeof AbortSignal.any === "function" ? AbortSignal.any([init.signal, timeoutSignal]) : init?.signal ?? timeoutSignal;
+        const timedInit = { ...init, signal };
+        return this.cipherLink ? this.cipherFetch(input, timedInit) : fetch(input, timedInit);
+      }),
       fetchOptions: () => ({
         headers: {
           "X-Auth-Token": this.$__authToken
-        },
-        // Add 60 second timeout
-        signal: AbortSignal.timeout(6e4)
+        }
       })
     });
   }
@@ -6617,12 +6820,12 @@ var TokenSlugSchema2 = createBrandedSchema(
 );
 var BatchIdSchema2 = createBrandedSchema(
   "BatchId",
-  // v3's `.uuid()` regex, inlined verbatim. Zod 4's `z.uuid()` additionally enforces the
-  // RFC 9562 version/variant nibbles and would reject batch IDs v3 accepted.
-  zod.z.string().regex(
-    /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
-    "Invalid batch ID format"
-  )
+  // 64 hex characters. generateBatchId (src/libraries/crypto.ts) returns either
+  // shake256(molecularHash + index, 256) — 256 bits, 64 hex chars — or randomString(64) over the
+  // alphabet 'abcdef0123456789'. A UUID shape matches nothing this SDK can produce, so the
+  // previous 8-4-4-4-12 regex rejected every real batch ID. Agrees with isBatchId in
+  // src/types/guards.ts.
+  zod.z.string().regex(/^[0-9a-fA-F]{64}$/, "Invalid batch ID format")
 );
 var CellSlugSchema2 = createBrandedSchema(
   "CellSlug",
@@ -7525,89 +7728,6 @@ var ConfigValidator = class _ConfigValidator {
 
 // src/response/ResponseBalance.ts
 init_Response();
-
-// src/core/TokenUnit.ts
-var TokenUnit = class _TokenUnit {
-  id;
-  name;
-  metas;
-  /**
-   * Create new TokenUnit instance
-   * Matches JavaScript SDK constructor signature exactly
-   */
-  constructor(id, name, metas) {
-    this.id = id;
-    this.name = name;
-    this.metas = metas || {};
-  }
-  /**
-   * Create TokenUnit from GraphQL response data
-   * Matches JavaScript SDK createFromGraphQL method exactly
-   */
-  static createFromGraphQL(data) {
-    let metas = data.metas || {};
-    if (Array.isArray(metas) && metas.length) {
-      try {
-        metas = JSON.parse(metas);
-        if (!metas) {
-          metas = {};
-        }
-      } catch (error) {
-        metas = {};
-      }
-    }
-    return new _TokenUnit(
-      data.id,
-      data.name,
-      metas
-    );
-  }
-  /**
-   * Create TokenUnit from database array data
-   * Matches JavaScript SDK createFromDB method exactly
-   */
-  static createFromDB(data) {
-    return new _TokenUnit(
-      data[0],
-      data[1],
-      data.length > 2 ? data[2] : {}
-    );
-  }
-  /**
-   * Get fragment zone from metadata
-   * Matches JavaScript SDK getFragmentZone method exactly
-   */
-  getFragmentZone() {
-    return this.metas.fragmentZone || null;
-  }
-  /**
-   * Get fused token units from metadata
-   * Matches JavaScript SDK getFusedTokenUnits method exactly
-   */
-  getFusedTokenUnits() {
-    return this.metas.fusedTokenUnits || null;
-  }
-  /**
-   * Convert to data array format
-   * Matches JavaScript SDK toData method exactly
-   */
-  toData() {
-    return [this.id, this.name, this.metas];
-  }
-  /**
-   * Convert to GraphQL response format
-   * Matches JavaScript SDK toGraphQLResponse method exactly
-   */
-  toGraphQLResponse() {
-    return {
-      id: this.id,
-      name: this.name,
-      metas: JSON.stringify(this.metas)
-    };
-  }
-};
-
-// src/response/ResponseBalance.ts
 var ResponseBalance = class _ResponseBalance extends exports.Response {
   /**
    * Class constructor
@@ -10116,6 +10236,12 @@ var MutationAppendRequest = class extends MutationProposeMolecule {
   }
 };
 
+// src/mutation/MutationReplenishToken.ts
+var MutationReplenishToken = class extends MutationProposeMolecule {
+  fillMolecule() {
+  }
+};
+
 // src/subscribe/Subscribe.ts
 init_exception();
 var Subscribe = class {
@@ -11549,20 +11675,42 @@ var KnishIOClient = class {
     return response;
   }
   /**
-   * Replenish tokens
+   * Replenish a non-finite token supply.
+   * Matches JS SDK KnishIOClient.replenishToken (KnishIOClient.js:2195-2231).
    */
   async replenishToken({
     token,
     amount = null,
     units = null,
-    sourceWallet: _sourceWallet = null
+    sourceWallet = null
   }) {
     this.log("info", `KnishIOClient::replenishToken() - Replenishing ${amount || "units"} of ${token}...`);
-    return this.requestTokens({
-      token,
-      amount,
-      units
+    if (!sourceWallet) {
+      sourceWallet = (await this.queryBalance({ token }))?.payload();
+    }
+    if (!sourceWallet) {
+      throw new exports.TransferBalanceException("Source wallet is missing or invalid.");
+    }
+    const remainderWallet = sourceWallet.createRemainder(this.getSecret());
+    const molecule = await this.createMolecule({
+      sourceWallet,
+      remainderWallet
     });
+    molecule.replenishToken({
+      amount: Number(amount ?? 0),
+      units: units ?? []
+    });
+    molecule.sign({ bundle: this.getBundle() });
+    molecule.check();
+    const mutation = await this.createMoleculeMutation({
+      mutationClass: MutationReplenishToken,
+      molecule
+    });
+    const response = await this.executeQuery(mutation);
+    if (!response) {
+      throw new CodeException("Token replenishment failed");
+    }
+    return response;
   }
   /**
    * Fuse token units
@@ -12013,75 +12161,8 @@ var KnishIOClient = class {
 
 // src/index.ts
 init_Response();
-
-// src/core/PolicyMeta.ts
-var PolicyMeta = class _PolicyMeta {
-  policy;
-  /**
-   * Create new PolicyMeta instance
-   * Matches JavaScript SDK constructor signature exactly
-   */
-  constructor(policy = {}, metaKeys = []) {
-    this.policy = _PolicyMeta.normalizePolicy(policy);
-    this.fillDefault(metaKeys);
-  }
-  /**
-   * Normalize policy object structure
-   * Matches JavaScript SDK normalizePolicy method exactly
-   */
-  static normalizePolicy(policy = {}) {
-    const policyMeta = {};
-    for (const [policyKey, value] of Object.entries(policy)) {
-      if (value !== null && ["read", "write"].includes(policyKey)) {
-        policyMeta[policyKey] = {};
-        for (const [key, content] of Object.entries(value)) {
-          policyMeta[policyKey][key] = content;
-        }
-      }
-    }
-    return policyMeta;
-  }
-  /**
-   * Fill default policy values for metadata keys
-   * Matches JavaScript SDK fillDefault method exactly
-   */
-  fillDefault(metaKeys = []) {
-    const readPolicy = Array.from(this.policy).filter((item) => item.action === "read");
-    const writePolicy = Array.from(this.policy).filter((item) => item.action === "write");
-    for (const [type, value] of Object.entries({
-      read: readPolicy,
-      write: writePolicy
-    })) {
-      const policyKey = value.map((item) => item.key);
-      if (!this.policy[type]) {
-        this.policy[type] = {};
-      }
-      for (const key of diff(metaKeys, policyKey)) {
-        if (!this.policy[type][key]) {
-          this.policy[type][key] = type === "write" && !["characters", "pubkey"].includes(key) ? ["self"] : ["all"];
-        }
-      }
-    }
-  }
-  /**
-   * Get the policy object
-   * Matches JavaScript SDK get method exactly
-   */
-  get() {
-    return this.policy;
-  }
-  /**
-   * Convert policy to JSON string
-   * Matches JavaScript SDK toJson method exactly
-   */
-  toJson() {
-    return JSON.stringify(this.get());
-  }
-};
-
-// src/index.ts
 init_exception();
-var SDK_VERSION = "0.9.5";
+var SDK_VERSION = "0.9.6";
 var SDK_NAME = "KnishIO-Client-TS";
 var COMPATIBLE_SERVER_VERSIONS = [4, 5];
 var SDK_INFO = {