@wishknish/knishio-client-js 0.6.4 → 0.7.5

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@wishknish/knishio-client-js",
-  "version": "0.6.4",
+  "version": "0.7.5",
+  "type": "module",
   "productName": "Knish.IO Javascript SDK Client",
   "description": "JavaScript implementation of the Knish.IO SDK to consume Knish.IO GraphQL APIs.",
   "license": "GPL-3.0-or-later",
   "repository": {
     "type": "git",
-    "url": "https://github.com/WishKnish/KnishIO-Client-JS.git"
+    "url": "git+https://github.com/WishKnish/KnishIO-Client-JS.git"
   },
   "contributors": [
     {
@@ -15,12 +16,6 @@
       "homepage": "https://wishknish.com",
       "role": "developer"
     },
-    {
-      "name": "Vladimir Makarov",
-      "email": "vladimir@wishknish.com",
-      "homepage": "https://wishknish.com",
-      "role": "developer"
-    },
     {
       "name": "Yuri Kizilov",
       "email": "yuriy@wishknish.com",
@@ -28,44 +23,64 @@
       "role": "developer"
     }
   ],
-  "main": "dist/client.iife.js",
-  "module": "dist/client.es.js",
-  "commonjs": "dist/client.cjs.js",
+  "main": "dist/client.cjs.js",
+  "module": "dist/client.es.mjs",
+  "browser": "dist/client.iife.js",
+  "exports": {
+    ".": {
+      "browser": "./dist/client.iife.js",
+      "import": "./dist/client.es.mjs",
+      "require": "./dist/client.cjs.js"
+    },
+    "./src": "./src/index.js",
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
   "keywords": [
     "wishknish",
     "knishio",
     "blockchain",
     "dag",
     "client",
-    "graphql"
+    "graphql",
+    "xmss",
+    "post-quantum",
+    "quantum-safe",
+    "sdk",
+    "javascript",
+    "ml-kem768",
+    "cryptography",
+    "crystals-kyber",
+    "fips-202",
+    "fips-203"
   ],
   "dependencies": {
-    "@noble/post-quantum": "^0.4.0",
+    "@noble/post-quantum": "^0.5.4",
     "@thumbmarkjs/thumbmarkjs": "^0.19.1",
-    "@urql/core": "^5.1.1",
-    "graphql": "^16.10.0",
-    "graphql-ws": "^6.0.4",
+    "@urql/core": "^5.2.0",
+    "graphql": "^16.12.0",
+    "graphql-ws": "^6.0.7",
     "isomorphic-fetch": "^3.0.0",
     "jssha": "^3.3.1",
-    "wonka": "^6.3.4"
+    "wonka": "^6.3.5"
   },
   "devDependencies": {
     "@jest/globals": "^29.7.0",
-    "@rollup/plugin-babel": "^6.0.4",
-    "@rollup/plugin-commonjs": "^28.0.3",
-    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@rollup/plugin-babel": "^6.1.0",
+    "@rollup/plugin-commonjs": "^28.0.9",
+    "@rollup/plugin-node-resolve": "^16.0.3",
     "buffer": "^6.0.3",
     "esbuild-jest": "^0.5.0",
     "eslint": "^8.57.1",
     "eslint-config-standard": "^17.1.0",
-    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-n": "^16.6.2",
     "eslint-plugin-promise": "^6.6.0",
-    "eslint-plugin-vue": "^9.32.0",
-    "esmock": "^2.7.0",
+    "eslint-plugin-vue": "^9.33.0",
+    "esmock": "^2.7.3",
     "jest": "^29.7.0",
-    "rollup": "^4.34.8",
-    "vite": "^6.1.1"
+    "rollup": "^4.57.1",
+    "vite": "^6.4.1"
   },
   "browserslist": [
     "> 1%",
@@ -76,9 +91,14 @@
     "build": "vite build --config build/vite.config.mjs",
     "lint": "eslint --ext .js src",
     "test": "jest",
-    "test:coverage": "jest --coverage"
+    "test:coverage": "jest --coverage",
+    "selftest": "npm run build && node tests/scripts/self-test.js",
+    "integration-test": "npm run build && node tests/scripts/integration-test.js",
+    "prepublishOnly": "npm run build"
   },
   "files": [
-    "/src"
-  ]
+    "/src",
+    "/dist"
+  ],
+  "packageManager": "yarn@4.9.2"
 }

package/src/Atom.js

@@ -46,11 +46,11 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
 import JsSHA from 'jssha'
-import { charsetBaseConvert } from './libraries/strings'
-import Meta from './Meta'
-import AtomMeta from './AtomMeta'
-import AtomsMissingException from './exception/AtomsMissingException'
-import versions from './versions/index'
+import { charsetBaseConvert } from './libraries/strings.js'
+import Meta from './Meta.js'
+import AtomMeta from './AtomMeta.js'
+import AtomsMissingException from './exception/AtomsMissingException.js'
+import versions from './versions/index.js'
 
 /**
  * Atom class used to form microtransactions within a Molecule
@@ -176,6 +176,8 @@ export default class Atom {
     }
 
     // Create the final atom's object
+    // walletAddress is null for atoms without a pre-existing wallet (e.g., recipient V-atoms).
+    // toJSON() serializes null as '' for GraphQL compatibility; hash computation treats both identically.
     return new Atom({
       position: wallet ? wallet.position : null,
       walletAddress: wallet ? wallet.address : null,
@@ -208,6 +210,131 @@ export default class Atom {
     return target
   }
 
+  /**
+   * Returns JSON-ready object for cross-SDK compatibility (2025 JS best practices)
+   * 
+   * Provides clean serialization of atomic operations with optional OTS fragments.
+   * Follows 2025 JavaScript best practices with proper type safety and validation.
+   *
+   * @param {Object} options - Serialization options
+   * @param {boolean} options.includeOtsFragments - Include OTS signature fragments (default: true)
+   * @param {boolean} options.validateFields - Validate required fields (default: false)
+   * @return {Object} JSON-serializable object
+   * @throws {Error} If atom is in invalid state for serialization
+   */
+  toJSON (options = {}) {
+    const {
+      includeOtsFragments = true,
+      validateFields = false
+    } = options;
+
+    try {
+      // Validate required fields if requested
+      if (validateFields) {
+        const requiredFields = ['position', 'walletAddress', 'isotope', 'token'];
+        for (const field of requiredFields) {
+          if (!this[field]) {
+            throw new Error(`Required field '${field}' is missing or empty`);
+          }
+        }
+      }
+
+      // Core atom properties (always included)
+      // Coerce null position/walletAddress/token to empty string for GraphQL compatibility.
+      // The molecular hash computation (getHashableValues) already treats null as '' (line 448),
+      // so this coercion does NOT change the hash. Required because the Rust validator's
+      // GraphQL schema uses String! (non-null) with #[graphql(default)] for these fields,
+      // which accepts omitted values but rejects explicit null.
+      const serialized = {
+        position: this.position ?? '',
+        walletAddress: this.walletAddress ?? '',
+        isotope: this.isotope,
+        token: this.token ?? '',
+        value: this.value,
+        batchId: this.batchId,
+        metaType: this.metaType,
+        metaId: this.metaId,
+        meta: this.meta || [],
+        index: this.index,
+        createdAt: this.createdAt,
+        version: this.version
+      };
+
+      // Optional OTS fragments (can be large, so optional)
+      if (includeOtsFragments && this.otsFragment) {
+        serialized.otsFragment = this.otsFragment;
+      }
+
+      return serialized;
+
+    } catch (error) {
+      throw new Error(`Atom serialization failed: ${error.message}`);
+    }
+  }
+
+  /**
+   * Creates an Atom instance from JSON data (2025 JS best practices)
+   * 
+   * Handles cross-SDK atom deserialization with robust error handling.
+   * Essential for reconstructing atoms from other SDK implementations.
+   *
+   * @param {string|Object} json - JSON string or object to deserialize
+   * @param {Object} options - Deserialization options
+   * @param {boolean} options.validateStructure - Validate required fields (default: true)
+   * @param {boolean} options.strictMode - Strict validation mode (default: false)
+   * @return {Atom} Reconstructed atom instance
+   * @throws {Error} If JSON is invalid or required fields are missing
+   */
+  static fromJSON (json, options = {}) {
+    const {
+      validateStructure = true,
+      strictMode = false
+    } = options;
+
+    try {
+      // Parse JSON safely
+      const data = typeof json === 'string' ? JSON.parse(json) : json;
+
+      // Validate required fields in strict mode
+      if (strictMode || validateStructure) {
+        const requiredFields = ['position', 'walletAddress', 'isotope', 'token'];
+        for (const field of requiredFields) {
+          if (!data[field]) {
+            throw new Error(`Required field '${field}' is missing or empty`);
+          }
+        }
+      }
+
+      // Create atom instance with required fields
+      const atom = new Atom({
+        position: data.position,
+        walletAddress: data.walletAddress,
+        isotope: data.isotope,
+        token: data.token,
+        value: data.value,
+        batchId: data.batchId,
+        metaType: data.metaType,
+        metaId: data.metaId,
+        meta: data.meta,
+        index: data.index,
+        version: data.version
+      });
+
+      // Set additional properties that may not be in constructor
+      if (data.otsFragment) {
+        atom.otsFragment = data.otsFragment;
+      }
+      if (data.createdAt) {
+        atom.createdAt = data.createdAt;
+      }
+
+      return atom;
+
+    } catch (error) {
+      throw new Error(`Atom deserialization failed: ${error.message}`);
+    }
+  }
+
   /**
    * Produces a hash of the atoms inside a molecule.
    * Used to generate the molecularHash field for Molecules.

package/src/AtomMeta.js

@@ -46,8 +46,8 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
 
-import PolicyMeta from './PolicyMeta'
-import Meta from './Meta'
+import PolicyMeta from './PolicyMeta.js'
+import Meta from './Meta.js'
 
 const USE_META_CONTEXT = false
 const DEFAULT_META_CONTEXT = 'https://www.schema.org'
@@ -94,10 +94,7 @@ export default class AtomMeta {
    * @returns {AtomMeta}
    */
   setAtomWallet (wallet) {
-    const walletMeta = {
-      pubkey: wallet.pubkey,
-      characters: wallet.characters
-    }
+    const walletMeta = {}
 
     // Add token units meta key
     if (wallet.tokenUnits && wallet.tokenUnits.length) {
@@ -108,8 +105,10 @@ export default class AtomMeta {
       walletMeta.tradeRates = JSON.stringify(wallet.tradeRates)
     }
 
-    // Merge all wallet's metas
-    this.merge(walletMeta)
+    // Merge all wallet's metas (if any)
+    if (Object.keys(walletMeta).length > 0) {
+      this.merge(walletMeta)
+    }
     return this
   }
 

package/src/AuthToken.js

@@ -46,7 +46,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
 
-import Wallet from './Wallet'
+import Wallet from './Wallet.js'
 
 /**
  *