@wishknish/knishio-client-js 0.6.4 → 0.7.5

package/src/response/Response.js

@@ -45,9 +45,9 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import InvalidResponseException from '../exception/InvalidResponseException'
-import UnauthenticatedException from '../exception/UnauthenticatedException'
-import Dot from '../libraries/Dot'
+import InvalidResponseException from '../exception/InvalidResponseException.js'
+import UnauthenticatedException from '../exception/UnauthenticatedException.js'
+import Dot from '../libraries/Dot.js'
 
 /**
  * Base Response class for processing node responses
@@ -86,6 +86,17 @@ export default class Response {
       throw new InvalidResponseException()
     }
 
+    // Check for GraphQL errors array
+    if (this.$__response.errors && Array.isArray(this.$__response.errors) && this.$__response.errors.length > 0) {
+      const errorMessage = this.$__response.errors[0].message || 'Unknown GraphQL error'
+
+      if (errorMessage.includes('Unauthenticated')) {
+        throw new UnauthenticatedException()
+      }
+
+      throw new InvalidResponseException(`GraphQL Error: ${errorMessage}`)
+    }
+
     this.init()
   }
 
@@ -103,9 +114,14 @@ export default class Response {
       return this.response()
     }
 
+    // Check if response has data field
+    if (!this.response().data) {
+      throw new InvalidResponseException('Response has no data field')
+    }
+
     // Check key & return custom data from the response
     if (!Dot.has(this.response(), this.dataKey)) {
-      throw new InvalidResponseException()
+      throw new InvalidResponseException(`Missing expected field: ${this.dataKey}`)
     }
 
     return Dot.get(this.response(), this.dataKey)
@@ -138,4 +154,152 @@ export default class Response {
   status () {
     return null
   }
+
+  /**
+   * Check if response was successful
+   * @return {boolean}
+   */
+  success () {
+    // Default implementation - can be overridden by subclasses
+    return !this.$__response?.errors?.length
+  }
+
+  /**
+   * Get error message if any
+   *
+   * @return {string|null}
+   */
+  error () {
+    return this.$__response?.errors?.length ? this.$__response.errors[0].message || 'Unknown error' : null
+  }
+
+  /**
+   * Enhanced interface methods for standardized response handling
+   */
+  
+  /**
+   * Get error reason (alias for error() to match standardized interface)
+   * @return {string|null}
+   */
+  reason () {
+    return this.error()
+  }
+
+  /**
+   * Convert to ValidationResult for enhanced error handling
+   * @return {object}
+   */
+  toValidationResult () {
+    if (this.success() && this.payload() !== null) {
+      return {
+        success: true,
+        data: this.payload(),
+        warnings: []
+      }
+    } else {
+      return {
+        success: false,
+        error: {
+          message: this.reason() || 'Unknown error',
+          context: this.constructor.name,
+          details: this.$__response?.errors || []
+        }
+      }
+    }
+  }
+
+  /**
+   * Enhanced error handling with callbacks
+   * @param {function} callback
+   * @return {Response}
+   */
+  onSuccess (callback) {
+    if (this.success() && this.payload() !== null) {
+      try {
+        callback(this.payload())
+      } catch (error) {
+        console.warn('Response.onSuccess callback failed:', error)
+      }
+    }
+    return this
+  }
+
+  /**
+   * Enhanced failure handling with callbacks
+   * @param {function} callback
+   * @return {Response}
+   */
+  onFailure (callback) {
+    if (!this.success()) {
+      try {
+        callback(this.reason() || 'Unknown error')
+      } catch (error) {
+        console.warn('Response.onFailure callback failed:', error)
+      }
+    }
+    return this
+  }
+
+  /**
+   * Debug logging with enhanced context
+   * @param {string|null} label
+   * @return {Response}
+   */
+  debug (label = null) {
+    const debugPrefix = label ? `[${label}]` : `[${this.constructor.name}]`
+    
+    if (this.success()) {
+      console.debug(`${debugPrefix} Success:`, {
+        payload: this.payload(),
+        query: this.$__query?.constructor?.name,
+        dataKey: this.dataKey
+      })
+    } else {
+      console.debug(`${debugPrefix} Failure:`, {
+        error: this.reason(),
+        errors: this.$__response?.errors,
+        rawData: this.$__response
+      })
+    }
+    
+    return this
+  }
+
+  /**
+   * Promise conversion for enhanced async patterns
+   * @return {Promise}
+   */
+  toPromise () {
+    if (this.success() && this.payload() !== null) {
+      return Promise.resolve(this.payload())
+    } else {
+      return Promise.reject(new Error(this.reason() || 'Unknown error'))
+    }
+  }
+
+  /**
+   * Functional programming map operation
+   * @param {function} mapper
+   * @return {Response}
+   */
+  map (mapper) {
+    if (this.success() && this.payload() !== null) {
+      try {
+        const mappedPayload = mapper(this.payload())
+        // Create new response with mapped payload
+        const newResponse = Object.create(Object.getPrototypeOf(this))
+        Object.assign(newResponse, this)
+        newResponse.$__payload = mappedPayload
+        return newResponse
+      } catch (error) {
+        // Create error response
+        const errorResponse = Object.create(Object.getPrototypeOf(this))
+        Object.assign(errorResponse, this)
+        errorResponse.$__response = { errors: [{ message: `Mapping failed: ${error.message}` }] }
+        return errorResponse
+      }
+    } else {
+      return this
+    }
+  }
 }

package/src/response/ResponseActiveSession.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 Query from '../query/Query'
-import Response from './Response'
+import Query from '../query/Query.js'
+import Response from './Response.js'
 
 export default class ResponseActiveSession extends Response {
   /**

package/src/response/{ResponseMetaBatch.js → ResponseAppendRequest.js}

@@ -45,28 +45,11 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-
-import Query from '../query/Query'
-import Response from './Response'
+import ResponseProposeMolecule from './ResponseProposeMolecule.js'
 
 /**
- * Response for MetaBatch Query
+ * Response for append requests via A-isotope
  */
-export default class ResponseMetaBatch extends Response {
-  /**
-   * Class constructor
-   *
-   * @param {Query} query
-   * @param {object} json
-   */
-  constructor ({
-    query,
-    json
-  }) {
-    super({
-      query,
-      json,
-      dataKey: 'data.MetaBatch'
-    })
-  }
+export default class ResponseAppendRequest extends ResponseProposeMolecule {
+
 }

package/src/response/ResponseAtom.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 Query from '../query/Query'
-import Response from './Response'
+import Query from '../query/Query.js'
+import Response from './Response.js'
 
 /**
  * Response for MetaType Query

package/src/response/ResponseAuthorizationGuest.js

@@ -46,10 +46,10 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
 
-import Query from '../query/Query'
-import Response from './Response'
-import Dot from '../libraries/Dot'
-import InvalidResponseException from '../exception/InvalidResponseException'
+import Query from '../query/Query.js'
+import Response from './Response.js'
+import Dot from '../libraries/Dot.js'
+import InvalidResponseException from '../exception/InvalidResponseException.js'
 
 /**
  * Response for Guest Authorization Request

package/src/response/ResponseBalance.js

@@ -45,9 +45,9 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import Query from '../query/Query'
-import Response from './Response'
-import ResponseWalletList from './ResponseWalletList'
+import Query from '../query/Query.js'
+import Response from './Response.js'
+import ResponseWalletList from './ResponseWalletList.js'
 
 /**
  * Response for balance query
@@ -76,7 +76,12 @@ export default class ResponseBalance extends Response {
    * @return {null|Wallet}
    */
   payload () {
-    const walletData = this.data()
+    let walletData = this.data()
+
+    // Handle array response (e.g. from Rust validator which returns Vec<Wallet>)
+    if (Array.isArray(walletData)) {
+      walletData = walletData.length > 0 ? walletData[0] : null
+    }
 
     if (!walletData || !walletData.bundleHash || !walletData.tokenSlug) {
       return null

package/src/response/ResponseClaimShadowWallet.js

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

package/src/response/ResponseContinuId.js

@@ -45,9 +45,9 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import Query from '../query/Query'
-import Response from './Response'
-import Wallet from '../Wallet'
+import Query from '../query/Query.js'
+import Response from './Response.js'
+import Wallet from '../Wallet.js'
 
 /**
  * Response for ContinuID query
@@ -91,7 +91,7 @@ export default class ResponseContinuId extends Response {
       wallet.batchId = continuId.batchId
       wallet.characters = continuId.characters
       wallet.pubkey = continuId.pubkey
-      wallet.balance = continuId.amount * 1.0
+      wallet.balance = String(continuId.amount != null ? continuId.amount : 0)
     }
 
     return wallet

package/src/response/ResponseCreateIdentifier.js

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

package/src/response/ResponseCreateMeta.js

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

package/src/response/ResponseCreateRule.js

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

package/src/response/ResponseCreateToken.js

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

package/src/response/ResponseCreateWallet.js

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

package/src/response/ResponseLinkIdentifier.js

@@ -45,9 +45,9 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import Query from '../query/Query'
-import Response from './Response'
-import Dot from '../libraries/Dot'
+import Query from '../query/Query.js'
+import Response from './Response.js'
+import Dot from '../libraries/Dot.js'
 
 /**
  * Response for mutation to create / link an Identifier to a Wallet Bundle

package/src/response/ResponseMetaType.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 Query from '../query/Query'
-import Response from './Response'
+import Query from '../query/Query.js'
+import Response from './Response.js'
 
 /**
  * Response for MetaType Query

package/src/response/ResponseMetaTypeViaAtom.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 Query from '../query/Query'
-import Response from './Response'
+import Query from '../query/Query.js'
+import Response from './Response.js'
 
 export default class ResponseMetaTypeViaAtom extends Response {
   /**

package/src/response/ResponseMetaTypeViaMolecule.js

@@ -0,0 +1,210 @@
+/*
+                               (
+                              (/(
+                              (//(
+                              (///(
+                             (/////(
+                             (//////(                          )
+                            (////////(                        (/)
+                            (////////(                       (///)
+                           (//////////(                      (////)
+                           (//////////(                     (//////)
+                          (////////////(                    (///////)
+                         (/////////////(                   (/////////)
+                        (//////////////(                  (///////////)
+                        (///////////////(                (//////////////)
+                       (////////////////(               (///////////////)
+                      (((((((((((((((((((              (((((((((((((((
+                     (((((((((((((((((((              ((((((((((((((
+                     (((((((((((((((((((            ((((((((((((((
+                    ((((((((((((((((((((           (((((((((((((
+                    ((((((((((((((((((((          ((((((((((((
+                    (((((((((((((((((((         ((((((((((((
+                    (((((((((((((((((((        ((((((((((
+                    ((((((((((((((((((/      (((((((((
+                    ((((((((((((((((((     ((((((((
+                    (((((((((((((((((    (((((((
+                   ((((((((((((((((((  (((((
+                   #################  ##
+                   ################  #
+                  ################# ##
+                 %################  ###
+                 ###############(   ####
+                ###############      ####
+               ###############       ######
+              %#############(        (#######
+             %#############           #########
+            ############(              ##########
+           ###########                  #############
+          #########                      ##############
+        %######
+
+        Powered by Knish.IO: Connecting a Decentralized World
+
+Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
+
+License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
+*/
+
+import Query from '../query/Query.js'
+import Response from './Response.js'
+import CheckMolecule from '../libraries/CheckMolecule.js'
+
+/**
+ * Response for MetaType queries via Molecule data.
+ *
+ * Instead of using the redundant instance-level `metas` field,
+ * this response extracts metadata from molecule atoms' `metasJson`,
+ * producing a payload format compatible with ResponseMetaType and
+ * ResponseMetaTypeViaAtom for drop-in replacement usage.
+ */
+export default class ResponseMetaTypeViaMolecule extends Response {
+  /**
+   * Class constructor
+   *
+   * @param {Query} query
+   * @param {object} json
+   */
+  constructor ({
+    query,
+    json
+  }) {
+    super({
+      query,
+      json,
+      dataKey: 'data.MetaTypeViaAtom'
+    })
+  }
+
+  /**
+   * Extracts metas from a molecule's atoms' metasJson for a specific instance.
+   * Filters atoms by matching metaType and metaId, then parses metasJson.
+   *
+   * @param {object} molecule - Molecule data with atoms array
+   * @param {string} metaType - Instance meta type to filter by
+   * @param {string} metaId - Instance meta ID to filter by
+   * @return {Array<{molecularHash: string, position: string, key: string, value: string, createdAt: string}>}
+   */
+  static extractMetasFromMolecule (molecule, metaType, metaId) {
+    if (!molecule || !molecule.atoms) {
+      return []
+    }
+
+    const metas = []
+
+    for (const atom of molecule.atoms) {
+      // Filter atoms to those matching this instance's metaType and metaId
+      if (atom.metaType !== metaType || atom.metaId !== metaId) {
+        continue
+      }
+
+      if (!atom.metasJson) {
+        continue
+      }
+
+      let parsed
+      try {
+        parsed = JSON.parse(atom.metasJson)
+        if (!Array.isArray(parsed)) {
+          continue
+        }
+      } catch (e) {
+        continue
+      }
+
+      for (const entry of parsed) {
+        metas.push({
+          molecularHash: molecule.molecularHash,
+          position: atom.position,
+          key: entry.key,
+          value: entry.value,
+          createdAt: atom.createdAt
+        })
+      }
+    }
+
+    return metas
+  }
+
+  /**
+   * Returns meta type instance results with metas synthesized from molecule data.
+   * Produces the same payload format as ResponseMetaType and ResponseMetaTypeViaAtom:
+   * { instances, instanceCount, paginatorInfo }
+   *
+   * @return {null|{instances: Array, instanceCount: Array, paginatorInfo: object}}
+   */
+  payload () {
+    const metaTypeData = this.data()
+
+    if (!metaTypeData || metaTypeData.length === 0) {
+      return null
+    }
+
+    const response = {
+      instances: {},
+      instanceCount: {},
+      paginatorInfo: {}
+    }
+
+    const metaData = metaTypeData.pop()
+
+    if (metaData.instances) {
+      response.instances = metaData.instances.map(instance => {
+        // Prefer server-filtered metas (from metas sub-field) when available
+        let metas = instance.metas
+        if (!metas || metas.length === 0) {
+          // Fallback: synthesize from molecule atoms' metasJson
+          metas = ResponseMetaTypeViaMolecule.extractMetasFromMolecule(
+            instance.molecule,
+            instance.metaType,
+            instance.metaId
+          )
+        }
+
+        return {
+          ...instance,
+          metas
+        }
+      })
+    }
+
+    if (metaData.instanceCount) {
+      response.instanceCount = metaData.instanceCount
+    }
+
+    if (metaData.paginatorInfo) {
+      response.paginatorInfo = metaData.paginatorInfo
+    }
+
+    return response
+  }
+
+  /**
+   * Verifies the cryptographic integrity of all molecules associated
+   * with meta instances in this response. For each instance, reconstructs
+   * the molecule from server data and runs CheckMolecule.verify() to validate
+   * the molecular hash and OTS signature.
+   *
+   * @return {{ verified: boolean, molecules: Array<{ molecularHash: string, verified: boolean, error: string|null }> }}
+   */
+  verifyIntegrity () {
+    const results = []
+    const metaTypeData = this.data()
+
+    if (!metaTypeData || metaTypeData.length === 0) {
+      return { verified: true, molecules: results }
+    }
+
+    const instances = metaTypeData[metaTypeData.length - 1]?.instances || []
+
+    for (const instance of instances) {
+      if (!instance.molecule) continue
+      results.push(CheckMolecule.verifyFromServerData(instance.molecule))
+    }
+
+    return {
+      verified: results.length === 0 || results.every(r => r.verified),
+      molecules: results
+    }
+  }
+}