memori-client 0.0.9 → 0.1.1

data/lib/memori_client/engine/v2/stat.rb

@@ -1,41 +1,51 @@
-# Generated on 2023-07-11 06:40:04 +0000    
+# Generated on 2024-01-18 17:37:07 +0000    
 class MemoriClient::Engine::V2::Stat < MemoriClient::Engine::Resource
     # GET /memori/v2/Statistics/{strSessionID}
     # Computes usage statistics for the Memori of the current session.
     # Params list:
     # @param [string] strSessionID The session ID. required
-    # statistics(strSessionID:)
-    def self.statistics(**args)
-      exec_http_request('get', '/memori/v2/Statistics/{strSessionID}', args)
+    # get_statistics(strSessionID:)
+    def self.get_statistics(strSessionID:)
+      args = build_arguments(binding)
+
+      exec_http_request('get', '/memori/v2/Statistics/{strSessionID}', **args)
     end
 
-    # GET /memori/v2/ContentQualityIndexes/{strMemoriID}
+    # GET /memori/v2/ContentQualityIndexes/{strMemoriID}/{strLatestUpdate}
     # Computes content quality indexes for a Memori.
     # Params list:
     # @param [string] strMemoriID The Memori object ID. required
-    # content_quality_indexes(strMemoriID:)
-    def self.content_quality_indexes(**args)
-      exec_http_request('get', '/memori/v2/ContentQualityIndexes/{strMemoriID}', args)
+    # @param [string] strLatestUpdate The optional latest update timestamp, in UTC time, in the format yyyyMMddHHmmssfff. optional
+    # get_content_quality_indexes(strMemoriID:, strLatestUpdate: nil)
+    def self.get_content_quality_indexes(strMemoriID:, strLatestUpdate: nil)
+      args = build_arguments(binding)
+
+      exec_http_request('get', '/memori/v2/ContentQualityIndexes/{strMemoriID}/{strLatestUpdate}', **args)
     end
 
-    # GET /memori/v2/TextQualityIndexes/{strSessionID}
+    # GET /memori/v2/TextQualityIndexes/{strSessionID}/{strLatestUpdate}
     # Computes text quality indexes for a Memori.
     # Params list:
     # @param [string] strSessionID The session ID. required
-    # text_quality_indexes(strSessionID:)
-    def self.text_quality_indexes(**args)
-      exec_http_request('get', '/memori/v2/TextQualityIndexes/{strSessionID}', args)
+    # @param [string] strLatestUpdate The optional latest update timestamp, in UTC time, in the format yyyyMMddHHmmssfff. optional
+    # get_text_quality_indexes(strSessionID:, strLatestUpdate: nil)
+    def self.get_text_quality_indexes(strSessionID:, strLatestUpdate: nil)
+      args = build_arguments(binding)
+
+      exec_http_request('get', '/memori/v2/TextQualityIndexes/{strSessionID}/{strLatestUpdate}', **args)
     end
 
     # GET /memori/v2/SessionStatistics/{strMemoriID}/{strDateFrom}/{strDateTo}
-    # Computes session statistics for the specified Memori in a specific date internval.
+    # Computes session statistics for the specified Memori in a specific date interval.
     # Params list:
     # @param [string] strMemoriID The Memori object ID. required
     # @param [string] strDateFrom The optional begin of the date interval, in UTC time, in the format yyyyMMddHHmmssfff. optional
     # @param [string] strDateTo The optional end of the date interval, in UTC time, in the format yyyyMMddHHmmssfff. optional
-    # session_statistics(strMemoriID:, strDateFrom: nil, strDateTo: nil)
-    def self.session_statistics(**args)
-      exec_http_request('get', '/memori/v2/SessionStatistics/{strMemoriID}/{strDateFrom}/{strDateTo}', args)
+    # get_session_statistics(strMemoriID:, strDateFrom: nil, strDateTo: nil)
+    def self.get_session_statistics(strMemoriID:, strDateFrom: nil, strDateTo: nil)
+      args = build_arguments(binding)
+
+      exec_http_request('get', '/memori/v2/SessionStatistics/{strMemoriID}/{strDateFrom}/{strDateTo}', **args)
     end
 
 

data/lib/memori_client/engine/v2/unanswered_question.rb

@@ -1,12 +1,14 @@
-# Generated on 2023-07-11 06:40:04 +0000    
+# Generated on 2024-01-18 17:37:07 +0000    
 class MemoriClient::Engine::V2::UnansweredQuestion < MemoriClient::Engine::Resource
     # GET /memori/v2/UnansweredQuestions/{strSessionID}
     # Lists all Unanswered Question objects.
     # Params list:
     # @param [string] strSessionID The session ID. required
-    # unanswered_questions(strSessionID:)
-    def self.unanswered_questions(**args)
-      exec_http_request('get', '/memori/v2/UnansweredQuestions/{strSessionID}', args)
+    # list_unanswered_questions(strSessionID:)
+    def self.list_unanswered_questions(strSessionID:)
+      args = build_arguments(binding)
+
+      exec_http_request('get', '/memori/v2/UnansweredQuestions/{strSessionID}', **args)
     end
 
     # GET /memori/v2/UnansweredQuestions/{strSessionID}/{from}/{howMany}
@@ -15,9 +17,51 @@ class MemoriClient::Engine::V2::UnansweredQuestion < MemoriClient::Engine::Resou
     # @param [string] strSessionID The session ID. required
     # @param [integer] from The 0-based index of the first Unanswered Question object to list. required
     # @param [integer] howMany The number of the Unanswered Question objects to list. required
-    # paginated_unanswered_questions(strSessionID:, from:, howMany:)
-    def self.paginated_unanswered_questions(**args)
-      exec_http_request('get', '/memori/v2/UnansweredQuestions/{strSessionID}/{from}/{howMany}', args)
+    # list_unanswered_questions_paginated(strSessionID:, from:, howMany:)
+    def self.list_unanswered_questions_paginated(strSessionID:, from:, howMany:)
+      args = build_arguments(binding)
+
+      exec_http_request('get', '/memori/v2/UnansweredQuestions/{strSessionID}/{from}/{howMany}', **args)
+    end
+
+    # POST /memori/v2/UnansweredQuestion/{strSessionID}
+    # Adds a new Unanswered Question object.
+    # Params list:
+    # @param [string] strSessionID The session ID. required
+    # @param [object] payload request payload. optional
+    # @param [string] payload.unansweredQuestionID . optional
+    # @param [string] payload.text . optional
+    # @param [object] payload.contextVars . optional
+    # @param [integer] payload.occurrences . optional
+    # @param [string] payload.receiverID . optional
+    # @param [string] payload.receiverTag . optional
+    # @param [string] payload.receiverName . optional
+    # @param [array] payload.suggestions . optional
+    # @param [string] payload.creationTimestamp . optional
+    # @param [string] payload.creationSessionID . optional
+    # @param [string] payload.lastChangeTimestamp . optional
+    # @param [string] payload.lastChangeSessionID . optional
+    # add_unanswered_question(strSessionID:, payload: {})
+    def self.add_unanswered_question(strSessionID:, payload: {})
+      args = build_arguments(binding)
+      payload_keys = [
+        'contextVars',
+        'creationSessionID',
+        'creationTimestamp',
+        'lastChangeSessionID',
+        'lastChangeTimestamp',
+        'occurrences',
+        'receiverID',
+        'receiverName',
+        'receiverTag',
+        'suggestions',
+        'text',
+        'unansweredQuestionID',
+      ]
+      payload_required_keys = %w[]
+      validate_payload!(args[:payload], keys: payload_keys, required: payload_required_keys)
+
+      exec_http_request('post', '/memori/v2/UnansweredQuestion/{strSessionID}', **args)
     end
 
     # DELETE /memori/v2/UnansweredQuestion/{strSessionID}/{strUnansweredQuestionID}
@@ -25,9 +69,11 @@ class MemoriClient::Engine::V2::UnansweredQuestion < MemoriClient::Engine::Resou
     # Params list:
     # @param [string] strSessionID The session ID. required
     # @param [string] strUnansweredQuestionID The Unanswered Question object ID. required
-    # unanswered_question(strSessionID:, strUnansweredQuestionID:)
-    def self.unanswered_question(**args)
-      exec_http_request('delete', '/memori/v2/UnansweredQuestion/{strSessionID}/{strUnansweredQuestionID}', args)
+    # remove_unanswered_question(strSessionID:, strUnansweredQuestionID:)
+    def self.remove_unanswered_question(strSessionID:, strUnansweredQuestionID:)
+      args = build_arguments(binding)
+
+      exec_http_request('delete', '/memori/v2/UnansweredQuestion/{strSessionID}/{strUnansweredQuestionID}', **args)
     end
 
 

data/lib/memori_client/engine/v2/user.rb

@@ -0,0 +1,52 @@
+# Generated on 2024-01-18 17:37:07 +0000    
+class MemoriClient::Engine::V2::User < MemoriClient::Engine::Resource
+    # GET /memori/v2/KnownFacts/{strSessionID}
+    # Lists all Known Facts objects associated with the current User.
+    # Params list:
+    # @param [string] strSessionID The session ID. required
+    # list_known_facts(strSessionID:)
+    def self.list_known_facts(strSessionID:)
+      args = build_arguments(binding)
+
+      exec_http_request('get', '/memori/v2/KnownFacts/{strSessionID}', **args)
+    end
+
+    # GET /memori/v2/KnownFacts/{strSessionID}/{from}/{howMany}
+    # Lists Known Facts objects associated with the current User, with pagination.
+    # Params list:
+    # @param [string] strSessionID The session ID. required
+    # @param [integer] from The 0-based index of the first Known Fact to list. required
+    # @param [integer] howMany The number of the Known Fact to list. required
+    # list_known_facts_paginated(strSessionID:, from:, howMany:)
+    def self.list_known_facts_paginated(strSessionID:, from:, howMany:)
+      args = build_arguments(binding)
+
+      exec_http_request('get', '/memori/v2/KnownFacts/{strSessionID}/{from}/{howMany}', **args)
+    end
+
+    # GET /memori/v2/KnownFact/{strSessionID}/{strKnownFactID}
+    # Gets the details of a Known Fact object.
+    # Params list:
+    # @param [string] strSessionID The session ID. required
+    # @param [string] strKnownFactID The Known Fact object ID. required
+    # get_known_fact(strSessionID:, strKnownFactID:)
+    def self.get_known_fact(strSessionID:, strKnownFactID:)
+      args = build_arguments(binding)
+
+      exec_http_request('get', '/memori/v2/KnownFact/{strSessionID}/{strKnownFactID}', **args)
+    end
+
+    # DELETE /memori/v2/KnownFact/{strSessionID}/{strKnownFactID}
+    # Deletes an existing Known Fact object.
+    # Params list:
+    # @param [string] strSessionID The session ID. required
+    # @param [string] strKnownFactID The Known Fact object ID. required
+    # delete_known_fact(strSessionID:, strKnownFactID:)
+    def self.delete_known_fact(strSessionID:, strKnownFactID:)
+      args = build_arguments(binding)
+
+      exec_http_request('delete', '/memori/v2/KnownFact/{strSessionID}/{strKnownFactID}', **args)
+    end
+
+
+end

data/lib/memori_client/engine/v2/web_hook.rb

@@ -1,44 +1,81 @@
-# Generated on 2023-07-11 06:40:04 +0000    
+# Generated on 2024-01-18 17:37:07 +0000    
 class MemoriClient::Engine::V2::WebHook < MemoriClient::Engine::Resource
     # POST /memori/v2/TestSlot
     # Returns test slot values.
     # Params list:
     # @param [object] payload request payload. optional
-    # @param [string] payload.slotName . optional
-    # @param [integer] payload.requestID . optional
-    # @param [string] payload.requestDateTime . optional
-    # @param [number] payload.requestValidityMinutes . optional
-    # @param [string] payload.memoriID . optional
-    # @param [string] payload.culture . optional
-    # test_slot()
-    def self.test_slot(**args)
-      exec_http_request('post', '/memori/v2/TestSlot', args)
+    # @param [string] payload.slotName . required
+    # @param [integer] payload.requestID . required
+    # @param [string] payload.requestDateTime . required
+    # @param [number] payload.requestValidityMinutes . required
+    # @param [string] payload.memoriID . required
+    # @param [string] payload.culture . required
+    # test_slot(payload: {})
+    def self.test_slot(payload: {})
+      args = build_arguments(binding)
+      payload_keys = [
+        'culture',
+        'memoriID',
+        'requestDateTime',
+        'requestID',
+        'requestValidityMinutes',
+        'slotName',
+      ]
+      payload_required_keys = %w[culture memoriID requestDateTime requestID requestValidityMinutes slotName]
+      validate_payload!(args[:payload], keys: payload_keys, required: payload_required_keys)
+
+      exec_http_request('post', '/memori/v2/TestSlot', **args)
     end
 
     # POST /memori/v2/TestIntent
     # Returns test intent results.
     # Params list:
     # @param [object] payload request payload. optional
-    # @param [string] payload.intentName . optional
+    # @param [string] payload.intentName . required
     # @param [string] payload.utterance . optional
-    # @param [object] payload.slotValues . optional
-    # @param [string] payload.sessionID . optional
+    # @param [object] payload.slotValues . required
+    # @param [string] payload.sessionID . required
     # @param [string] payload.currentTag . optional
     # @param [boolean] payload.currentTagAuthenticated . optional
     # @param [string] payload.currentDateUTC . optional
     # @param [] payload.currentPlace . optional
-    # @param [string] payload.timeZone . optional
-    # @param [string] payload.beginUTC . optional
-    # @param [string] payload.endUTC . optional
-    # @param [object] payload.contextVars . optional
-    # @param [integer] payload.requestID . optional
-    # @param [string] payload.requestDateTime . optional
-    # @param [number] payload.requestValidityMinutes . optional
-    # @param [string] payload.memoriID . optional
-    # @param [string] payload.culture . optional
-    # test_intent()
-    def self.test_intent(**args)
-      exec_http_request('post', '/memori/v2/TestIntent', args)
+    # @param [string] payload.timeZone . required
+    # @param [string] payload.beginUTC . required
+    # @param [string] payload.endUTC . required
+    # @param [object] payload.contextVars . required
+    # @param [array] payload.transitionHistory . required
+    # @param [integer] payload.requestID . required
+    # @param [string] payload.requestDateTime . required
+    # @param [number] payload.requestValidityMinutes . required
+    # @param [string] payload.memoriID . required
+    # @param [string] payload.culture . required
+    # test_intent(payload: {})
+    def self.test_intent(payload: {})
+      args = build_arguments(binding)
+      payload_keys = [
+        'beginUTC',
+        'contextVars',
+        'culture',
+        'currentDateUTC',
+        'currentPlace',
+        'currentTag',
+        'currentTagAuthenticated',
+        'endUTC',
+        'intentName',
+        'memoriID',
+        'requestDateTime',
+        'requestID',
+        'requestValidityMinutes',
+        'sessionID',
+        'slotValues',
+        'timeZone',
+        'transitionHistory',
+        'utterance',
+      ]
+      payload_required_keys = %w[beginUTC contextVars culture endUTC intentName memoriID requestDateTime requestID requestValidityMinutes sessionID slotValues timeZone transitionHistory]
+      validate_payload!(args[:payload], keys: payload_keys, required: payload_required_keys)
+
+      exec_http_request('post', '/memori/v2/TestIntent', **args)
     end
 
 

data/lib/memori_client/http_client.rb

@@ -75,7 +75,7 @@ class MemoriClient::HttpClient
     if request['Content-Type'] == 'application/json'
       [
         response.code,
-        (body.blank? ? {} : JSON.parse(body))
+        (body.nil? ? {} : JSON.parse(body))
       ]
     else
       [response.code, body]

data/lib/memori_client/resource.rb

@@ -0,0 +1,56 @@
+class MemoriClient::Resource
+  def self.build_arguments(the_binding)
+    the_binding.local_variables.each_with_object({}) do |key, acc|
+      value = the_binding.local_variable_get(key)
+      acc[key] = value
+    end
+  end
+
+  def self.exec_http_request(method, path, args)
+    stop = false
+    processed_tokens = []
+    path.split('/').each do |token|
+      break if stop == true
+      if token =~ /^{.*}$/
+        param_name = token.match(/^{(.*)}$/).captures.first
+        if args[param_name.to_sym].blank?
+          stop = true
+        else
+          processed_tokens << args[param_name.to_sym]
+        end
+      else
+        processed_tokens << token
+      end
+    end
+
+    url = processed_tokens.join('/')
+    url = build_url(url)
+    http = MemoriClient::HttpClient.new
+
+    case method
+    when 'get'
+      status, body = http.get(url)
+    else
+      status, body = http.send(method, url, payload: args[:payload])
+    end
+
+    [status, body]
+  end
+
+  def self.build_url(_url)
+    raise NotImplementedError
+  end
+
+  def self.validate_payload!(payload, keys:, required:)
+    bad_names = []
+    payload.each do |k, v|
+      unless keys.include?(k.to_s)
+        bad_names << k
+      end
+    end
+
+    if bad_names.size > 0
+      raise ArgumentError.new "Found invalid keys: #{bad_names.join(', ')}"
+    end
+  end
+end

data/lib/memori_client.rb

@@ -39,8 +39,12 @@ module MemoriClient
   end
 end
 
+require 'securerandom'
+require 'uri'
+require 'json'
 require 'memori_client/configuration'
 require "memori_client/http_client"
+require "memori_client/resource"
 require "memori_client/backend/resource"
 require "memori_client/backend/resources"
 require "memori_client/engine/resource"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: memori-client
 version: !ruby/object:Gem::Version
-  version: 0.0.9
+  version: 0.1.1
 platform: ruby
 authors:
 - Stefano Lampis
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-07-11 00:00:00.000000000 Z
+date: 2024-01-18 00:00:00.000000000 Z
 dependencies: []
 description: Memori Client to interact with Memori backend and engine API
 email: me@stefanolampis.com
@@ -19,12 +19,16 @@ files:
 - lib/memori_client.rb
 - lib/memori_client/backend/resource.rb
 - lib/memori_client/backend/resources.rb
+- lib/memori_client/backend/v1/asset.rb
 - lib/memori_client/backend/v2/action_log.rb
 - lib/memori_client/backend/v2/asset.rb
+- lib/memori_client/backend/v2/badge.rb
 - lib/memori_client/backend/v2/consumption_log.rb
+- lib/memori_client/backend/v2/import_export.rb
 - lib/memori_client/backend/v2/integration.rb
 - lib/memori_client/backend/v2/invitation.rb
 - lib/memori_client/backend/v2/memori.rb
+- lib/memori_client/backend/v2/memori_list.rb
 - lib/memori_client/backend/v2/notification.rb
 - lib/memori_client/backend/v2/tenant.rb
 - lib/memori_client/backend/v2/user.rb
@@ -32,20 +36,29 @@ files:
 - lib/memori_client/engine/resource.rb
 - lib/memori_client/engine/resources.rb
 - lib/memori_client/engine/v2/chat_log.rb
+- lib/memori_client/engine/v2/completion_log.rb
 - lib/memori_client/engine/v2/context_var.rb
 - lib/memori_client/engine/v2/correlation_pair.rb
+- lib/memori_client/engine/v2/custom_dictionary.rb
 - lib/memori_client/engine/v2/dialog.rb
 - lib/memori_client/engine/v2/event_log.rb
+- lib/memori_client/engine/v2/expert_reference.rb
 - lib/memori_client/engine/v2/intent.rb
+- lib/memori_client/engine/v2/localization_key.rb
+- lib/memori_client/engine/v2/medium.rb
 - lib/memori_client/engine/v2/memori.rb
 - lib/memori_client/engine/v2/memory.rb
 - lib/memori_client/engine/v2/nlp.rb
+- lib/memori_client/engine/v2/person.rb
+- lib/memori_client/engine/v2/prompted_question.rb
 - lib/memori_client/engine/v2/search.rb
 - lib/memori_client/engine/v2/session.rb
 - lib/memori_client/engine/v2/stat.rb
 - lib/memori_client/engine/v2/unanswered_question.rb
+- lib/memori_client/engine/v2/user.rb
 - lib/memori_client/engine/v2/web_hook.rb
 - lib/memori_client/http_client.rb
+- lib/memori_client/resource.rb
 homepage: https://rubygems.org/gems/memori_client-client
 licenses:
 - MIT