close_encounters 0.1.3 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ad2eb14acac02e5a5795ffd9508b0bb7dd19987265e398bcdbb73fe48ff42407
-  data.tar.gz: 123e788ca23010056255b21bc9a71a4fd27e4bdd1e340586b22147f8fe10e8cb
+  metadata.gz: 4954f6a9a487299009cb84b6af2571743e1d08d2703683edbcde73e0670a154b
+  data.tar.gz: d05d458352582236246c0ceab9f556f8ca3c2df9c3531db3e35123e854cb6485
 SHA512:
-  metadata.gz: fdf6130ae5170dc17f1af37cc16e7405c334b722d0ced759c8012782a1b314a73a518886bbd5f7d9199384097bf8554373379da16cb0a92dea781190095ff028
-  data.tar.gz: a652c2aaa5215275695811da24003816689a19de14407ba053186ef7c007f9825010d5053b00e2cd9421b6399f74f4b44d7255994ee22bab98f57056f360a897
+  metadata.gz: 64c3973533245763a65dd67e466c6da6b7f425853aeaebeb4712d94eb115dfc36484a49ea146a93db1e77dd5848f4c8770d1768a76c5b435d43f4acdd2f196e0
+  data.tar.gz: d2c569f12ce8da83cfc3d3eb8d437b0100436687212bbded9d10fee5989a74e5bd3c67d03b2f4d314c4903bdbcd90bc74990bba754cbc9ac5f9cfb5d2b612d46

data/CHANGELOG.md

@@ -5,24 +5,15 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
-## [0.1.3] - 2024-07-11
+## [0.2.0] - 2025-02-26
 
-## [] - 
+### Changed
 
-### 
-
-- [] -
-
-### Removed
-
-- Remove serialize connection_info for manual methods
-
-## [0.1.2] - 2024-07-11
+- Test with Ruby 3.4
 
 ### Added
 
-- Check if the table exits before conditionally setting up the serialize column
-
-### Removed
+- Ability to use CloseEncounters::Middleware and CloseEncounters.auto_contact! to automatically track responses from third-party services.
+- Add metadata to events for storing extra information about the event.
 
-- Appending engine migrations to the main app's migration path
+## [0.1.4] - Unreleased

data/README.md

@@ -27,6 +27,23 @@ CloseEncounters.status("SomeThirdPartyService") # => 200
 CloseEncounters.status("SomeThirdPartyService") # => 500
 ```
 
+### Rack Middleware
+
+Setup your middleware in your `config/application.rb` or `config/environments/production.rb`.
+
+```ruby
+config.middleware.use CloseEncounters::Middleware
+```
+
+This will automatically track responses from third-party services when you store a "domain" key in the
+`connection_info` in the ParticipantService records.
+
+Alternatively, you can use the `auto_contact!` method to automatically turn on the rack middleware:
+
+```ruby
+CloseEncounters.auto_contact!
+```
+
 ### TODO
 
 - [ ] Add JS to the gem to track events on the front-end.

data/app/models/close_encounters/participant_event.rb

@@ -6,5 +6,9 @@ module CloseEncounters
       foreign_key: "close_encounters_participant_service_id"
 
     scope :newest, -> { order(created_at: :desc).limit(1) }
+
+    unless ActiveRecord::Base.connection.adapter_name.downcase.include?("postgresql")
+      serialize :metadata, coder: JSON
+    end
   end
 end

data/db/migrate/20250225232551_add_metadata_to_close_encounters_participant_events.rb

@@ -0,0 +1,9 @@
+class AddMetadataToCloseEncountersParticipantEvents < ActiveRecord::Migration[7.1]
+  def change
+    if ActiveRecord::Base.connection.adapter_name.downcase.include?("postgresql")
+      add_column :close_encounters_participant_events, :metadata, :jsonb
+    else
+      add_column :close_encounters_participant_events, :metadata, :text
+    end
+  end
+end

data/lib/close_encounters/engine.rb

@@ -1,3 +1,4 @@
+require_relative "middleware"
 module CloseEncounters
   class Engine < ::Rails::Engine
     isolate_namespace CloseEncounters
@@ -6,6 +7,10 @@ module CloseEncounters
       g.test_framework :minitest, spec: true
     end
 
+    initializer "close_encounters.middleware" do |app|
+      app.middleware.use CloseEncounters::Middleware if CloseEncounters.auto_contact?
+    end
+
     if defined?(Importmap)
       initializer "close_encounters.importmap", before: "importmap" do |app|
         app.config.importmap.paths << root.join("config/importmap.rb")

data/lib/close_encounters/middleware.rb

@@ -0,0 +1,31 @@
+module CloseEncounters
+  class Middleware
+    def initialize(app, tracker: CloseEncounters)
+      @app = app
+      @tracker = tracker
+    end
+
+    def call(env)
+      status, headers, response = @app.call(env)
+
+      record_contact(env["SERVER_NAME"], status, response)
+
+      [status, headers, response]
+    end
+
+    private
+
+    def record_contact(host, status, response)
+      if (name = participant_services[host])
+        @tracker.contact(name, status:, response:)
+      end
+    end
+
+    def participant_services
+      @participant_services ||= CloseEncounters::ParticipantService.all
+        .map do |service|
+          [service.connection_info["domain"], service.name]
+        end.to_h
+    end
+  end
+end

data/lib/close_encounters/version.rb

@@ -1,3 +1,3 @@
 module CloseEncounters
-  VERSION = "0.1.3"
+  VERSION = "0.2.0"
 end

data/lib/close_encounters.rb

@@ -19,6 +19,39 @@ module CloseEncounters
     end
   end
 
+  # Record a verification of a contact with a third party service where the
+  # verification is a callable which must also respond to to_s.
+  #
+  # For example, provide a callable which checks the JSON Schema for a response body
+  # and will record an event if calling the verification returns false.
+  #
+  # @param name [String] the name of the service
+  # @param status [Integer] the HTTP status of the contact
+  # @param response [String] the response object
+  # @param verifier [Proc] the verification callable which must also respond to to_s
+  def verify(name, status:, response:, verifier:)
+    service = ParticipantService.find_by!(name:)
+    unless service.events.newest.pick(:status) == status && (verified = verifier.call(response))
+      service.events.create!(status:, response:, metadata: {verified:, verification: verifier.to_s})
+    end
+  end
+
+  # Determine if contacts with third party services should be recorded automatically
+  # using the Rack Middleware
+  #
+  # Set the CLOSE_ENCOUNTERS_AUTO_CONTACT environment variable to enable this feature
+  # or call CloseEncounters.auto_contact! in an initializer
+  #
+  # @return [Boolean] whether or not to automatically record contacts
+  def auto_contact?
+    !!(ENV["CLOSE_ENCOUNTERS_AUTO_CONTACT"] || @auto_contact)
+  end
+
+  # Enable automatic contact recording in the Rack Middleware
+  def auto_contact!
+    @auto_contact = true
+  end
+
   # Get the status of the most recent contact with a third party service
   #
   # @param name [String] the name of the service

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: close_encounters
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.0
 platform: ruby
 authors:
 - Jim Gay
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-07-11 00:00:00.000000000 Z
+date: 2025-02-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -112,13 +112,14 @@ files:
 - app/models/close_encounters/application_record.rb
 - app/models/close_encounters/participant_event.rb
 - app/models/close_encounters/participant_service.rb
-- app/views/layouts/close_encounters/application.html.erb
 - config/importmap.rb
 - db/migrate/20240430173723_create_close_encounters_participant_services.rb
 - db/migrate/20240430173725_create_close_encounters_participant_events.rb
 - db/migrate/20240508190642_add_close_ecounters_indexes.rb
+- db/migrate/20250225232551_add_metadata_to_close_encounters_participant_events.rb
 - lib/close_encounters.rb
 - lib/close_encounters/engine.rb
+- lib/close_encounters/middleware.rb
 - lib/close_encounters/version.rb
 - lib/tasks/close_encounters.rake
 homepage: https://github.com/SOFware/close_encounters

data/app/views/layouts/close_encounters/application.html.erb

@@ -1,15 +0,0 @@
-<!DOCTYPE html>
-<html>
-<head>
-  <title>Close encounters</title>
-  <%= csrf_meta_tags %>
-  <%= csp_meta_tag %>
-
-  <%= stylesheet_link_tag    "close_encounters/application", media: "all" %>
-</head>
-<body>
-
-<%= yield %>
-
-</body>
-</html>