@wishknish/knishio-client-ts 0.7.0

package/src/query/Query.ts

@@ -0,0 +1,187 @@
+/*
+                               (
+                              (/(
+                              (//(
+                              (///(
+                             (/////(
+                             (//////(                          )
+                            (////////(                        (/)
+                            (////////(                       (///)
+                           (//////////(                      (////)
+                           (//////////(                     (//////)
+                          (////////////(                    (///////)
+                         (/////////////(                   (/////////)
+                        (//////////////(                  (///////////)
+                        (///////////////(                (/////////////)
+                       (////////////////(               (//////////////)
+                      (((((((((((((((((((              (((((((((((((((
+                     (((((((((((((((((((              ((((((((((((((
+                     (((((((((((((((((((            ((((((((((((((
+                    ((((((((((((((((((((           (((((((((((((
+                    ((((((((((((((((((((          ((((((((((((
+                    (((((((((((((((((((         ((((((((((((
+                    (((((((((((((((((((        ((((((((((
+                    ((((((((((((((((((/      (((((((((
+                    ((((((((((((((((((     ((((((((
+                    (((((((((((((((((    (((((((
+                   ((((((((((((((((((  (((((
+                   #################  ##
+                   ################  #
+                  ################# ##
+                 %################  ###
+                 ###############(   ####
+                ###############      ####
+               ###############       ######
+              %#############(        (#######
+             %#############           #########
+            ############(              ##########
+           ###########                  #############
+          #########                      ##############
+        %######
+
+        Powered by Knish.IO: Connecting a Decentralized World
+
+Please visit https://github.com/WishKnish/KnishIO-Client-TS for information.
+
+License: https://github.com/WishKnish/KnishIO-Client-TS/blob/master/LICENSE
+*/
+
+import { CodeException } from '@/exception'
+import type Response from '@/response/Response'
+import type { GraphQLClient } from '@/types'
+
+/**
+ * Base Query class for constructing GraphQL queries
+ */
+export default class Query {
+  protected client: GraphQLClient
+  protected knishIOClient: any // Will be KnishIOClient type
+  protected $__variables: Record<string, any> | null = null
+  protected $__query: string | null = null
+  protected $__response: Response | null = null
+  protected $__request: any = null
+
+  /**
+   * Create new Query instance
+   */
+  constructor(graphQLClient: GraphQLClient, knishIOClient: any) {
+    this.client = graphQLClient
+    this.knishIOClient = knishIOClient
+  }
+
+  /**
+   * Return a response object
+   * Used at KnishIOClient::createMolecule => sets the source wallet from the remainder one stored in response object
+   */
+  response(): Response | null {
+    return this.$__response
+  }
+
+  /**
+   * Builds a Response based on JSON input
+   */
+  async createResponseRaw(response: any): Promise<Response> {
+    return this.createResponse(response)
+  }
+
+  /**
+   * Returns a Response object
+   */
+  createResponse(json: any): Response {
+    // Import here to avoid circular dependency
+    const Response = require('@/response/Response').default
+    return new Response({
+      query: this,
+      json
+    })
+  }
+
+  /**
+   * Compiles variables for the query
+   * Can be overridden by subclasses to add specific variables
+   */
+  compiledVariables(variables: Record<string, any> | null = null): Record<string, any> {
+    return variables || {}
+  }
+
+  /**
+   * Gets the current variables
+   */
+  variables(): Record<string, any> | null {
+    return this.$__variables
+  }
+
+  /**
+   * Gets the node URI
+   */
+  uri(): string {
+    return this.client.getUri()
+  }
+
+  /**
+   * Creates a new Request for the given parameters
+   */
+  createQuery({ variables = null }: { variables?: Record<string, any> | null }): any {
+    this.$__variables = this.compiledVariables(variables)
+
+    // Uri is a required parameter
+    const uri = this.uri()
+    if (!uri) {
+      throw new CodeException('Query::createQuery() - Node URI was not initialized for this client instance!')
+    }
+
+    if (this.$__query === null) {
+      throw new CodeException('Query::createQuery() - GraphQL query was not initialized!')
+    }
+
+    return {
+      query: this.$__query,
+      variables: this.variables()
+    }
+  }
+
+  /**
+   * Creates the query context
+   */
+  createQueryContext(): Record<string, any> {
+    return {}
+  }
+
+  /**
+   * Executes the Query and returns a Response
+   */
+  async execute({ 
+    variables = {}, 
+    context = {} 
+  }: { 
+    variables?: Record<string, any>
+    context?: Record<string, any> 
+  } = {}): Promise<Response | null> {
+    this.$__request = this.createQuery({ variables })
+
+    const mergedContext = {
+      ...context,
+      ...this.createQueryContext()
+    }
+
+    try {
+      const queryParams = {
+        ...this.$__request,
+        context: mergedContext
+      }
+      const response = await this.client.query(queryParams)
+      this.$__response = await this.createResponseRaw(response)
+      return this.$__response
+    } catch (error) {
+      if ((error as any).name === 'AbortError') {
+        this.knishIOClient.log('warn', 'Query was cancelled')
+        const Response = require('@/response/Response').default
+        return new Response({
+          query: this,
+          json: { data: null, errors: [{ message: 'Query was cancelled' }] }
+        })
+      }
+      throw error
+    }
+  }
+}

package/src/query/QueryActiveSession.ts

@@ -0,0 +1,89 @@
+/*
+                               (
+                              (/(
+                              (//(
+                              (///(
+                             (/////(
+                             (//////(                          )
+                            (////////(                        (/)
+                            (////////(                       (///)
+                           (//////////(                      (////)
+                           (//////////(                     (//////)
+                          (////////////(                    (///////)
+                         (/////////////(                   (/////////)
+                        (//////////////(                  (///////////)
+                        (///////////////(                (/////////////)
+                       (////////////////(               (//////////////)
+                      (((((((((((((((((((              (((((((((((((((
+                     (((((((((((((((((((              ((((((((((((((
+                     (((((((((((((((((((            ((((((((((((((
+                    ((((((((((((((((((((           (((((((((((((
+                    ((((((((((((((((((((          ((((((((((((
+                    (((((((((((((((((((         ((((((((((((
+                    (((((((((((((((((((        ((((((((((
+                    ((((((((((((((((((/      (((((((((
+                    ((((((((((((((((((     ((((((((
+                    (((((((((((((((((    (((((((
+                   ((((((((((((((((((  (((((
+                   #################  ##
+                   ################  #
+                  ################# ##
+                 %################  ###
+                 ###############(   ####
+                ###############      ####
+               ###############       ######
+              %#############(        (#######
+             %#############           #########
+            ############(              ##########
+           ###########                  #############
+          #########                      ##############
+        %######
+
+        Powered by Knish.IO: Connecting a Decentralized World
+
+Please visit https://github.com/WishKnish/KnishIO-Client-TS for information.
+
+License: https://github.com/WishKnish/KnishIO-Client-TS/blob/master/LICENSE
+*/
+
+import Query from './Query'
+import ResponseQueryActiveSession from '@/response/ResponseQueryActiveSession'
+import { gql } from '@urql/core'
+import type { GraphQLClient as IGraphQLClient } from '@/types'
+import type KnishIOClient from '@/KnishIOClient'
+import type { BundleHash, MetaType, MetaId } from '@/types'
+
+/**
+ * Query for retrieving a list of active User Sessions
+ */
+export default class QueryActiveSession extends Query {
+  /**
+   * Constructor
+   */
+  constructor(graphQLClient: IGraphQLClient, knishIOClient: KnishIOClient) {
+    super(graphQLClient, knishIOClient)
+
+    this.$__query = gql`
+      query ActiveUserQuery($bundleHash: String, $metaType: String, $metaId: String) {
+        ActiveUser(bundleHash: $bundleHash, metaType: $metaType, metaId: $metaId) {
+          bundleHash
+          metaType
+          metaId
+          jsonData
+          createdAt
+          updatedAt
+        }
+      }
+    `
+  }
+
+  /**
+   * Creates a Response object
+   */
+  override createResponse(json: Record<string, any>): ResponseQueryActiveSession {
+    return new ResponseQueryActiveSession({
+      query: this,
+      json
+    })
+  }
+}

package/src/query/QueryAtom.ts

@@ -0,0 +1,275 @@
+/*
+                               (
+                              (/(
+                              (//(
+                              (///(
+                             (/////(
+                             (//////(                          )
+                            (////////(                        (/)
+                            (////////(                       (///)
+                           (//////////(                      (////)
+                           (//////////(                     (//////)
+                          (////////////(                    (///////)
+                         (/////////////(                   (/////////)
+                        (//////////////(                  (///////////)
+                        (///////////////(                (/////////////)
+                       (////////////////(               (//////////////)
+                      (((((((((((((((((((              (((((((((((((((
+                     (((((((((((((((((((              ((((((((((((((
+                     (((((((((((((((((((            ((((((((((((((
+                    ((((((((((((((((((((           (((((((((((((
+                    ((((((((((((((((((((          ((((((((((((
+                    (((((((((((((((((((         ((((((((((((
+                    (((((((((((((((((((        ((((((((((
+                    ((((((((((((((((((/      (((((((((
+                    ((((((((((((((((((     ((((((((
+                    (((((((((((((((((    (((((((
+                   ((((((((((((((((((  (((((
+                   #################  ##
+                   ################  #
+                  ################# ##
+                 %################  ###
+                 ###############(   ####
+                ###############      ####
+               ###############       ######
+              %#############(        (#######
+             %#############           #########
+            ############(              ##########
+           ###########                  #############
+          #########                      ##############
+        %######
+
+        Powered by Knish.IO: Connecting a Decentralized World
+
+Please visit https://github.com/WishKnish/KnishIO-Client-TS for information.
+
+License: https://github.com/WishKnish/KnishIO-Client-TS/blob/master/LICENSE
+*/
+
+import Query from './Query'
+import ResponseAtom from '../response/ResponseAtom'
+import type { UrqlClientWrapper } from '../client/GraphQLClient'
+import type KnishIOClient from '../KnishIOClient'
+
+/**
+ * QueryAtom class - Query for getting Knish.IO Atoms
+ * Matches JavaScript SDK QueryAtom implementation exactly
+ */
+export default class QueryAtom extends Query {
+  /**
+   * Create new QueryAtom instance
+   * Matches JavaScript SDK constructor signature exactly
+   */
+  constructor(graphQLClient: UrqlClientWrapper, knishIOClient: KnishIOClient) {
+    super(graphQLClient, knishIOClient)
+
+    this.$__query = `query(
+      $molecularHashes: [String!],
+      $bundleHashes: [String!],
+      $positions:[String!],
+      $walletAddresses: [String!],
+      $isotopes: [String!],
+      $tokenSlugs: [String!],
+      $cellSlugs: [String!],
+      $batchIds: [String!],
+      $values: [String!],
+      $metaTypes: [String!],
+      $metaIds: [String!],
+      $indexes: [String!],
+      $filter: [ MetaFilter! ],
+      $latest: Boolean,
+      $queryArgs: QueryArgs,
+    ) {
+      Atom(
+        molecularHashes: $molecularHashes,
+        bundleHashes: $bundleHashes,
+        positions: $positions,
+        walletAddresses: $walletAddresses,
+        isotopes: $isotopes,
+        tokenSlugs: $tokenSlugs,
+        cellSlugs: $cellSlugs,
+        batchIds: $batchIds,
+        values: $values,
+        metaTypes: $metaTypes,
+        metaIds: $metaIds,
+        indexes: $indexes,
+        filter: $filter,
+        latest: $latest,
+        queryArgs: $queryArgs,
+      ) {
+        instances {
+          position,
+          walletAddress,
+          tokenSlug,
+          isotope,
+          index,
+          molecularHash,
+          metaId,
+          metaType,
+          metasJson,
+          batchId,
+          value,
+          bundleHashes,
+          cellSlugs,
+          createdAt,
+          otsFragment
+        },
+        paginatorInfo {
+          currentPage,
+          total
+        }
+      }
+    }`
+  }
+
+  /**
+   * Queries Knish.IO Atoms
+   * Matches JavaScript SDK createVariables method exactly
+   */
+  static createVariables({
+    molecularHashes,
+    molecularHash,
+    bundleHashes,
+    bundleHash,
+    positions,
+    position,
+    walletAddresses,
+    walletAddress,
+    isotopes,
+    isotope,
+    tokenSlugs,
+    tokenSlug,
+    cellSlugs,
+    cellSlug,
+    batchIds,
+    batchId,
+    values,
+    value,
+    metaTypes,
+    metaType,
+    metaIds,
+    metaId,
+    indexes,
+    index,
+    filter,
+    latest,
+    queryArgs
+  }: {
+    molecularHashes?: string[]
+    molecularHash?: string
+    bundleHashes?: string[]
+    bundleHash?: string
+    positions?: string[]
+    position?: string
+    walletAddresses?: string[]
+    walletAddress?: string
+    isotopes?: string[]
+    isotope?: string
+    tokenSlugs?: string[]
+    tokenSlug?: string
+    cellSlugs?: string[]
+    cellSlug?: string
+    batchIds?: string[]
+    batchId?: string
+    values?: string[]
+    value?: string | number
+    metaTypes?: string[]
+    metaType?: string
+    metaIds?: string[]
+    metaId?: string
+    indexes?: number[]
+    index?: number
+    filter?: object[]
+    latest?: boolean
+    queryArgs?: object
+  }): Record<string, any> {
+    if (molecularHash) {
+      molecularHashes = molecularHashes || []
+      molecularHashes.push(molecularHash)
+    }
+
+    if (bundleHash) {
+      bundleHashes = bundleHashes || []
+      bundleHashes.push(bundleHash)
+    }
+
+    if (position) {
+      positions = positions || []
+      positions.push(position)
+    }
+
+    if (walletAddress) {
+      walletAddresses = walletAddresses || []
+      walletAddresses.push(walletAddress)
+    }
+
+    if (isotope) {
+      isotopes = isotopes || []
+      isotopes.push(isotope)
+    }
+
+    if (tokenSlug) {
+      tokenSlugs = tokenSlugs || []
+      tokenSlugs.push(tokenSlug)
+    }
+
+    if (cellSlug) {
+      cellSlugs = cellSlugs || []
+      cellSlugs.push(cellSlug)
+    }
+
+    if (batchId) {
+      batchIds = batchIds || []
+      batchIds.push(batchId)
+    }
+
+    if (value) {
+      values = values || []
+      values.push(String(value))
+    }
+
+    if (metaType) {
+      metaTypes = metaTypes || []
+      metaTypes.push(metaType)
+    }
+
+    if (metaId) {
+      metaIds = metaIds || []
+      metaIds.push(metaId)
+    }
+
+    if (index) {
+      indexes = indexes || []
+      indexes.push(index)
+    }
+
+    return {
+      molecularHashes,
+      bundleHashes,
+      positions,
+      walletAddresses,
+      isotopes,
+      tokenSlugs,
+      cellSlugs,
+      batchIds,
+      values,
+      metaTypes,
+      metaIds,
+      indexes,
+      filter,
+      latest,
+      queryArgs
+    }
+  }
+
+  /**
+   * Returns a Response object
+   * Matches JavaScript SDK createResponse method exactly
+   */
+  override createResponse(json: any): ResponseAtom {
+    return new ResponseAtom({
+      query: this,
+      json
+    })
+  }
+}

package/src/query/QueryBalance.ts

@@ -0,0 +1,102 @@
+/*
+                               (
+                              (/(
+                              (//(
+                              (///(
+                             (/////(
+                             (//////(                          )
+                            (////////(                        (/)
+                            (////////(                       (///)
+                           (//////////(                      (////)
+                           (//////////(                     (//////)
+                          (////////////(                    (///////)
+                         (/////////////(                   (/////////)
+                        (//////////////(                  (///////////)
+                        (///////////////(                (/////////////)
+                       (////////////////(               (//////////////)
+                      (((((((((((((((((((              (((((((((((((((
+                     (((((((((((((((((((              ((((((((((((((
+                     (((((((((((((((((((            ((((((((((((((
+                    ((((((((((((((((((((           (((((((((((((
+                    ((((((((((((((((((((          ((((((((((((
+                    (((((((((((((((((((         ((((((((((((
+                    (((((((((((((((((((        ((((((((((
+                    ((((((((((((((((((/      (((((((((
+                    ((((((((((((((((((     ((((((((
+                    (((((((((((((((((    (((((((
+                   ((((((((((((((((((  (((((
+                   #################  ##
+                   ################  #
+                  ################# ##
+                 %################  ###
+                 ###############(   ####
+                ###############      ####
+               ###############       ######
+              %#############(        (#######
+             %#############           #########
+            ############(              ##########
+           ###########                  #############
+          #########                      ##############
+        %######
+
+        Powered by Knish.IO: Connecting a Decentralized World
+
+Please visit https://github.com/WishKnish/KnishIO-Client-TS for information.
+
+License: https://github.com/WishKnish/KnishIO-Client-TS/blob/master/LICENSE
+*/
+
+import Query from './Query'
+import ResponseBalance from '../response/ResponseBalance'
+import type GraphQLClient from '../libraries/GraphQLClient'
+import type KnishIOClient from '../KnishIOClient'
+
+/**
+ * Query for getting the balance of a given wallet or token slug
+ * Matches JavaScript SDK QueryBalance implementation exactly
+ */
+export default class QueryBalance extends Query {
+  /**
+   * Create QueryBalance instance
+   */
+  constructor(graphQLClient: GraphQLClient, knishIOClient: KnishIOClient) {
+    super(graphQLClient, knishIOClient)
+
+    this.$__query = `
+      query($address: String, $bundleHash: String, $type: String, $token: String, $position: String) {
+        Balance(address: $address, bundleHash: $bundleHash, type: $type, token: $token, position: $position) {
+          address,
+          bundleHash,
+          type,
+          tokenSlug,
+          batchId,
+          position,
+          amount,
+          characters,
+          pubkey,
+          createdAt,
+          tokenUnits {
+            id,
+            name,
+            metas
+          },
+          tradeRates {
+            tokenSlug,
+            amount
+          }
+        }
+      }
+    `
+  }
+
+  /**
+   * Create ResponseBalance instance from JSON data
+   * Matches JavaScript SDK createResponse method signature exactly
+   */
+  override createResponse(json: Record<string, unknown>): ResponseBalance {
+    return new ResponseBalance({
+      query: this,
+      json
+    })
+  }
+}