@wishknish/knishio-client-js 0.6.4 → 0.7.4

package/src/mutation/MutationCreateWallet.js

@@ -45,8 +45,8 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import MutationProposeMolecule from './MutationProposeMolecule'
-import ResponseCreateWallet from '../response/ResponseCreateWallet'
+import MutationProposeMolecule from './MutationProposeMolecule.js'
+import ResponseCreateWallet from '../response/ResponseCreateWallet.js'
 
 /**
  * Query for creating new Wallets

package/src/mutation/MutationDepositBufferToken.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 MutationProposeMolecule from './MutationProposeMolecule'
+import MutationProposeMolecule from './MutationProposeMolecule.js'
 
 /**
  *

package/src/mutation/MutationLinkIdentifier.js

@@ -45,8 +45,8 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import Mutation from '../mutation/Mutation'
-import ResponseLinkIdentifier from '../response/ResponseLinkIdentifier'
+import Mutation from '../mutation/Mutation.js'
+import ResponseLinkIdentifier from '../response/ResponseLinkIdentifier.js'
 import { gql } from '@urql/core'
 
 /**

package/src/mutation/MutationPeering.js

@@ -0,0 +1,82 @@
+/*
+                               (
+                              (/(
+                              (//(
+                              (///(
+                             (/////(
+                             (//////(                          )
+                            (////////(                        (/)
+                            (////////(                       (///)
+                           (//////////(                      (////)
+                           (//////////(                     (//////)
+                          (////////////(                    (///////)
+                         (/////////////(                   (/////////)
+                        (//////////////(                  (///////////)
+                        (///////////////(                (/////////////)
+                       (////////////////(               (//////////////)
+                      (((((((((((((((((((              (((((((((((((((
+                     (((((((((((((((((((              ((((((((((((((
+                     (((((((((((((((((((            ((((((((((((((
+                    ((((((((((((((((((((           (((((((((((((
+                    ((((((((((((((((((((          ((((((((((((
+                    (((((((((((((((((((         ((((((((((((
+                    (((((((((((((((((((        ((((((((((
+                    ((((((((((((((((((/      (((((((((
+                    ((((((((((((((((((     ((((((((
+                    (((((((((((((((((    (((((((
+                   ((((((((((((((((((  (((((
+                   #################  ##
+                   ################  #
+                  ################# ##
+                 %################  ###
+                 ###############(   ####
+                ###############      ####
+               ###############       ######
+              %#############(        (#######
+             %#############           #########
+            ############(              ##########
+           ###########                  #############
+          #########                      ##############
+        %######
+
+        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 MutationProposeMolecule from './MutationProposeMolecule.js'
+import ResponsePeering from '../response/ResponsePeering.js'
+
+/**
+ * Mutation for registering a peer node via the P-isotope
+ */
+export default class MutationPeering extends MutationProposeMolecule {
+  /**
+   * Fills a molecule with a P-isotope peering atom
+   *
+   * @param {string} host
+   */
+  fillMolecule ({
+    host
+  }) {
+    this.$__molecule.initPeering({
+      host
+    })
+    this.$__molecule.sign({})
+    this.$__molecule.check()
+  }
+
+  /**
+   * Builds a new Response object from a JSON string
+   *
+   * @param {object} json
+   * @return {ResponsePeering}
+   */
+  createResponse (json) {
+    return new ResponsePeering({
+      query: this,
+      json
+    })
+  }
+}

package/src/mutation/MutationProposeMolecule.js

@@ -45,8 +45,8 @@ 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 '../response/ResponseProposeMolecule'
-import Mutation from './Mutation'
+import ResponseProposeMolecule from '../response/ResponseProposeMolecule.js'
+import Mutation from './Mutation.js'
 import { gql } from '@urql/core'
 
 export default class MutationProposeMolecule extends Mutation {

package/src/mutation/MutationRequestAuthorization.js

@@ -45,8 +45,8 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import MutationProposeMolecule from './MutationProposeMolecule'
-import ResponseRequestAuthorization from '../response/ResponseRequestAuthorization'
+import MutationProposeMolecule from './MutationProposeMolecule.js'
+import ResponseRequestAuthorization from '../response/ResponseRequestAuthorization.js'
 
 /**
  * Query for requesting an authorization token from the node

package/src/mutation/MutationRequestAuthorizationGuest.js

@@ -45,8 +45,8 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import Mutation from '../mutation/Mutation'
-import ResponseRequestAuthorizationGuest from '../response/ResponseRequestAuthorizationGuest'
+import Mutation from '../mutation/Mutation.js'
+import ResponseRequestAuthorizationGuest from '../response/ResponseRequestAuthorizationGuest.js'
 import { gql } from '@urql/core'
 
 export default class MutationRequestAuthorizationGuest extends Mutation {

package/src/mutation/MutationRequestTokens.js

@@ -45,8 +45,8 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import MutationProposeMolecule from './MutationProposeMolecule'
-import ResponseRequestTokens from '../response/ResponseRequestTokens'
+import MutationProposeMolecule from './MutationProposeMolecule.js'
+import ResponseRequestTokens from '../response/ResponseRequestTokens.js'
 
 export default class MutationRequestTokens extends MutationProposeMolecule {
   /**

package/src/mutation/MutationTransferTokens.js

@@ -45,8 +45,8 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import MutationProposeMolecule from './MutationProposeMolecule'
-import ResponseTransferTokens from '../response/ResponseTransferTokens'
+import MutationProposeMolecule from './MutationProposeMolecule.js'
+import ResponseTransferTokens from '../response/ResponseTransferTokens.js'
 
 /**
  * Query for moving tokens between wallets

package/src/mutation/MutationWithdrawBufferToken.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 MutationProposeMolecule from './MutationProposeMolecule'
+import MutationProposeMolecule from './MutationProposeMolecule.js'
 
 /**
  *

package/src/query/Query.js

@@ -45,8 +45,8 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import CodeException from '../exception/CodeException'
-import Response from '../response/Response'
+import CodeException from '../exception/CodeException.js'
+import Response from '../response/Response.js'
 
 export default class Query {
   /**

package/src/query/QueryActiveSession.js

@@ -45,8 +45,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'
-import ResponseQueryActiveSession from '../response/ResponseQueryActiveSession'
+import Query from './Query.js'
+import ResponseQueryActiveSession from '../response/ResponseQueryActiveSession.js'
 import { gql } from '@urql/core'
 
 /**

package/src/query/QueryAtom.js

@@ -45,8 +45,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'
-import ResponseAtom from '../response/ResponseAtom'
+import Query from './Query.js'
+import ResponseAtom from '../response/ResponseAtom.js'
 import { gql } from '@urql/core'
 
 /**

package/src/query/QueryBalance.js

@@ -45,8 +45,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'
-import ResponseBalance from '../response/ResponseBalance'
+import Query from './Query.js'
+import ResponseBalance from '../response/ResponseBalance.js'
 import { gql } from '@urql/core'
 
 /**

package/src/query/QueryBatch.js

@@ -45,8 +45,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'
-import Response from '../response/Response'
+import Query from './Query.js'
+import Response from '../response/Response.js'
 import { gql } from '@urql/core'
 
 /**

package/src/query/QueryBatchHistory.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'
-import QueryBatch from './QueryBatch'
-import Response from '../response/Response'
+import Query from './Query.js'
+import QueryBatch from './QueryBatch.js'
+import Response from '../response/Response.js'
 import { gql } from '@urql/core'
 
 /**

package/src/query/QueryContinuId.js

@@ -45,8 +45,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'
-import ResponseContinuId from '../response/ResponseContinuId'
+import Query from './Query.js'
+import ResponseContinuId from '../response/ResponseContinuId.js'
 import { gql } from '@urql/core'
 
 /**

package/src/query/QueryMetaType.js

@@ -45,8 +45,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'
-import ResponseMetaType from '../response/ResponseMetaType'
+import Query from './Query.js'
+import ResponseMetaType from '../response/ResponseMetaType.js'
 import { gql } from '@urql/core'
 
 /**
@@ -60,8 +60,8 @@ export default class QueryMetaType extends Query {
   constructor (graphQLClient, knishIOClient) {
     super(graphQLClient, knishIOClient)
 
-    this.$__query = gql`query( $metaType: String, $metaTypes: [ String! ], $metaId: String, $metaIds: [ String! ], $key: String, $keys: [ String! ], $value: String, $values: [ String! ], $count: String, $latest: Boolean, $filter: [ MetaFilter! ], $queryArgs: QueryArgs, $countBy: String ) {
-      MetaType( metaType: $metaType, metaTypes: $metaTypes, metaId: $metaId, metaIds: $metaIds, key: $key, keys: $keys, value: $value, values: $values, count: $count, filter: $filter, queryArgs: $queryArgs, countBy: $countBy ) {
+    this.$__query = gql`query( $metaType: String, $metaTypes: [ String! ], $metaId: String, $metaIds: [ String! ], $key: String, $keys: [ String! ], $value: String, $values: [ String! ], $count: String, $latest: Boolean, $filter: [ MetaFilter! ], $queryArgs: QueryArgs, $countBy: String, $cellSlug: String ) {
+      MetaType( metaType: $metaType, metaTypes: $metaTypes, metaId: $metaId, metaIds: $metaIds, key: $key, keys: $keys, value: $value, values: $values, count: $count, filter: $filter, queryArgs: $queryArgs, countBy: $countBy, cellSlug: $cellSlug ) {
         metaType,
         instanceCount {
           key,
@@ -99,6 +99,7 @@ export default class QueryMetaType extends Query {
    * @param {object|null} queryArgs
    * @param {string|null} count
    * @param {string|null} countBy
+   * @param {string|null} cellSlug
    * @return {{}}
    */
   static createVariables ({
@@ -110,7 +111,8 @@ export default class QueryMetaType extends Query {
     filter = null,
     queryArgs = null,
     count = null,
-    countBy = null
+    countBy = null,
+    cellSlug = null
   }) {
     const variables = {}
 
@@ -152,6 +154,10 @@ export default class QueryMetaType extends Query {
       variables.countBy = countBy
     }
 
+    if (cellSlug) {
+      variables.cellSlug = cellSlug
+    }
+
     return variables
   }
 

package/src/query/QueryMetaTypeViaAtom.js

@@ -45,8 +45,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'
-import ResponseMetaTypeViaAtom from '../response/ResponseMetaTypeViaAtom'
+import Query from './Query.js'
+import ResponseMetaTypeViaAtom from '../response/ResponseMetaTypeViaAtom.js'
 import { gql } from '@urql/core'
 
 export default class QueryMetaTypeViaAtom extends Query {
@@ -57,11 +57,12 @@ export default class QueryMetaTypeViaAtom extends Query {
   constructor (graphQLClient, knishIOClient) {
     super(graphQLClient, knishIOClient)
 
-    this.$__query = gql`query ($metaTypes: [String!], $metaIds: [String!], $values: [String!], $keys: [String!], $latest: Boolean, $filter: [MetaFilter!], $queryArgs: QueryArgs, $countBy: String, $atomValues: [String!] ) {
+    this.$__query = gql`query ($metaTypes: [String!], $metaIds: [String!], $values: [String!], $keys: [String!], $latest: Boolean, $filter: [MetaFilter!], $queryArgs: QueryArgs, $countBy: String, $atomValues: [String!], $cellSlugs: [String!] ) {
       MetaTypeViaAtom(
         metaTypes: $metaTypes
         metaIds: $metaIds
         atomValues: $atomValues
+        cellSlugs: $cellSlugs
         filter: $filter,
         latest: $latest,
         queryArgs: $queryArgs
@@ -106,6 +107,7 @@ export default class QueryMetaTypeViaAtom extends Query {
    * @param {array|null} filter
    * @param {object|null} queryArgs
    * @param {string|null} countBy
+   * @param {string|null} cellSlug
    * @return {{}}
    */
   static createVariables ({
@@ -119,7 +121,8 @@ export default class QueryMetaTypeViaAtom extends Query {
     latest = null,
     filter = null,
     queryArgs = null,
-    countBy = null
+    countBy = null,
+    cellSlug = null
   }) {
     const variables = {}
 
@@ -143,6 +146,10 @@ export default class QueryMetaTypeViaAtom extends Query {
       variables.metaIds = typeof metaId === 'string' ? [metaId] : metaId
     }
 
+    if (cellSlug) {
+      variables.cellSlugs = typeof cellSlug === 'string' ? [cellSlug] : cellSlug
+    }
+
     if (countBy) {
       variables.countBy = countBy
     }

package/src/query/QueryPolicy.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'
-import ResponsePolicy from '../response/ResponsePolicy'
+import Query from './Query.js'
+import ResponsePolicy from '../response/ResponsePolicy.js'
 import { gql } from "@urql/core";
 
 export default class QueryPolicy extends Query {

package/src/query/QueryToken.js

@@ -45,8 +45,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'
-import Response from '../response/Response'
+import Query from './Query.js'
+import Response from '../response/Response.js'
 import { gql } from '@urql/core'
 
 /**

package/src/query/QueryUserActivity.js

@@ -45,8 +45,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'
-import ResponseQueryUserActivity from '../response/ResponseQueryUserActivity'
+import Query from './Query.js'
+import ResponseQueryUserActivity from '../response/ResponseQueryUserActivity.js'
 import { gql } from '@urql/core'
 
 /**

package/src/query/QueryWalletBundle.js

@@ -45,8 +45,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'
-import ResponseWalletBundle from '../response/ResponseWalletBundle'
+import Query from './Query.js'
+import ResponseWalletBundle from '../response/ResponseWalletBundle.js'
 import { gql } from '@urql/core'
 
 /**

package/src/query/QueryWalletList.js

@@ -45,8 +45,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'
-import ResponseWalletList from '../response/ResponseWalletList'
+import Query from './Query.js'
+import ResponseWalletList from '../response/ResponseWalletList.js'
 import { gql } from '@urql/core'
 
 /**

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 {
   /**