hecks 2.4.0 → 2.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 97edfb74e99fd94bc3ffa0d9b4b9d9a6b1fafb257431fbe1bb128fdecb4bbf33
-  data.tar.gz: 2e4741a23695049fd2639d484f9ca6476c6a89195f0c1be0c8cb5e2434a50f6f
+  metadata.gz: 9df85914ab1de8512f099777f6129d4ed2c75fa26cb29de9162fb82ddc66b6ee
+  data.tar.gz: 6e171cfe202477bded39de3591ffa009b5738136e28444d042d408db1888d99a
 SHA512:
-  metadata.gz: 2c016c201f4217462adc98d860308cce1ed47485abae6012d3a7220e4604bc83533ad8e2c302d94aeff9b476da59eb0f9bce431a9ca36ad9be259fe6a753690c
-  data.tar.gz: a85c4aac72e327792fd65b7027fe0e07a8440ac952031351caece519952b25bd25d256722c415a3552e41869eed4eb807e9827d4a28e78de1112bb63b39d4af1
+  metadata.gz: 8cd2ea1bd846b0064d56e6309e8cd99e2a0b8c7d2dfe368a021e2af7c5b8a377068ade46e6367d63e844a5eb735f4067d12fc29ce3a63f10dcf1c03545a4388c
+  data.tar.gz: b0dea44c43a300f81ea80c1917852e90b12093c9ee2e651f032bf0b06bc89bca88c1165ddb72f2c69653cd89e2e74006779325dd478fa28c44d9b130b714fbbb

data/lib/hecks/bluebook/capabilities.rb

@@ -48,8 +48,22 @@ module Hecks
       # vocabulary), not commands.
       PAYMENTS = "payments".freeze
 
+      # Scheduling sessions and taking registrations for them — recognised
+      # by declaration, not the literal aggregate names "Event" and
+      # "Registration". rust/host's event and registration routes dispatch
+      # these verbs; the aggregates they name are the event and the
+      # registration.
+      REGISTRATIONS = "registrations".freeze
+
+      # A business's connection to its payment processor: connect it, drop
+      # it, pause it, and switch taking payments on or off — recognised by
+      # declaration, not the literal name "PaymentConnection". rust/host's
+      # payments routes dispatch these verbs; the connection aggregate is
+      # the one `connect` names.
+      PAYMENT_CONNECTION = "payment_connection".freeze
+
       CONTRACTS = {
-        AUTHORIZATION     => {
+        AUTHORIZATION      => {
           # every assignment an actor holds, current or historical
           assignments: :query,
           # the command that grants an actor a role
@@ -57,7 +71,7 @@ module Hecks
           # every grant of one role acting as another
           transitions: :query
         }.freeze,
-        MEMBERSHIP        => {
+        MEMBERSHIP         => {
           # recognize a person who may eventually sign in
           admit:  :command,
           # grant an admitted person a role (the access-grant half)
@@ -65,7 +79,7 @@ module Hecks
           # every admitted person, for the admin listing
           people: :query
         }.freeze,
-        IDENTITY          => {
+        IDENTITY           => {
           # mint a stable identity, independent of how it authenticated
           register: :command,
           # associate an (issuer, subject) pair with that identity
@@ -73,7 +87,7 @@ module Hecks
           # look up the identity an authenticated pair resolves to
           resolve:  :query
         }.freeze,
-        NEWSLETTER        => {
+        NEWSLETTER         => {
           # a guest signs up; the aggregate it names is the subscriber
           subscribe:   :command,
           # attach a display name to an existing subscriber
@@ -83,20 +97,42 @@ module Hecks
           # a subscriber leaves from the emailed link
           unsubscribe: :command
         }.freeze,
-        NEWSLETTER_ISSUES => {
+        NEWSLETTER_ISSUES  => {
           # mark an issue sent; the issue aggregate is the one it names
           send_issue:      :command,
           # record one email handed to the mail provider; the delivery
           # aggregate is the one it names
           record_delivery: :command
         }.freeze,
-        PAYMENTS          => {
+        PAYMENTS           => {
           # start a payment; the aggregate it names is the payment
           initiate:  :command,
           # the processor reports the money arrived
           succeeded: :port_operation,
           # the processor reports the payment failed or expired
           failed:    :port_operation
+        }.freeze,
+        REGISTRATIONS      => {
+          # schedule a session; the aggregate it names is the event
+          schedule: :command,
+          # a guest asks for a place; the aggregate it names is the registration
+          request:  :command
+        }.freeze,
+        PAYMENT_CONNECTION => {
+          # link the processor account; the aggregate it names is the connection
+          connect:    :command,
+          # link a different processor account after a disconnect
+          reconnect:  :command,
+          # drop the link
+          disconnect: :command,
+          # pause the connection without dropping it
+          suspend:    :command,
+          # lift a pause
+          resume:     :command,
+          # switch taking payments on
+          enable:     :command,
+          # switch taking payments off
+          disable:    :command
         }.freeze
       }.freeze
     end

data/lib/hecks/language/bluebook/bluebook.bluebook

@@ -305,6 +305,15 @@ Hecks.bluebook "Bluebook", version: "1" do
       member keyword: "provides",        context: "Bluebook", at: "",  named: "failed",      kind: "text", required: "false", fills: "provides"
       member keyword: "provides",        context: "Bluebook", at: "",  named: "send_issue",      kind: "text", required: "false", fills: "provides"
       member keyword: "provides",        context: "Bluebook", at: "",  named: "record_delivery", kind: "text", required: "false", fills: "provides"
+      member keyword: "provides",        context: "Bluebook", at: "",  named: "schedule", kind: "text", required: "false", fills: "provides"
+      member keyword: "provides",        context: "Bluebook", at: "",  named: "request", kind: "text", required: "false", fills: "provides"
+      member keyword: "provides",        context: "Bluebook", at: "",  named: "connect", kind: "text", required: "false", fills: "provides"
+      member keyword: "provides",        context: "Bluebook", at: "",  named: "reconnect", kind: "text", required: "false", fills: "provides"
+      member keyword: "provides",        context: "Bluebook", at: "",  named: "disconnect", kind: "text", required: "false", fills: "provides"
+      member keyword: "provides",        context: "Bluebook", at: "",  named: "suspend", kind: "text", required: "false", fills: "provides"
+      member keyword: "provides",        context: "Bluebook", at: "",  named: "resume", kind: "text", required: "false", fills: "provides"
+      member keyword: "provides",        context: "Bluebook", at: "",  named: "enable", kind: "text", required: "false", fills: "provides"
+      member keyword: "provides",        context: "Bluebook", at: "",  named: "disable", kind: "text", required: "false", fills: "provides"
       member keyword: "aggregate",       context: "Bluebook", at: "1", named: "",        kind: "text",     required: "true",  fills: "name"
       member keyword: "read_model", context: "Bluebook", at: "1", named: "", kind: "text", required: "true", fills: "name"
       member keyword: "policy",          context: "Bluebook", at: "1", named: "",        kind: "text",     required: "true",  fills: "name"

data/lib/hecks/projector/exporter.rb

@@ -230,6 +230,52 @@ module Hecks
         }
       end
 
+      # Same seam as `newsletter` — which chapter answers scheduling sessions
+      # and taking registrations (`Registry#registrations_provider_for`), with
+      # its declared verbs qualified and the event and registration aggregates
+      # named off them. `{}` when nothing this domain attaches provides
+      # registrations.
+      # @param registry [Runtime::Registry] the booted registry `domain_name` is loaded in
+      # @param domain_name [String] the domain to export the registrations binding for
+      # @return [Hash{Symbol => String, nil}] `:provider` (name), `:schedule`, `:request`
+      #   (qualified verbs), `:event_aggregate` and `:registration_aggregate` (each verb's own
+      #   leading qualified aggregate name); `{}` if nothing this domain attaches provides
+      #   registrations
+      def registrations(registry, domain_name)
+        provider = registry.registrations_provider_for(domain_name)
+        return {} unless provider
+
+        capability = Bluebook::Capabilities::REGISTRATIONS
+        schedule = provider.provided_verb(capability, :schedule)
+        request = provider.provided_verb(capability, :request)
+        {
+          provider:               provider.name,
+          schedule:               schedule,
+          request:                request,
+          event_aggregate:        schedule&.split(".")&.first,
+          registration_aggregate: request&.split(".")&.first
+        }
+      end
+
+      # Which chapter owns the payment-processor connection
+      # (`Registry#payment_connection_provider_for`), with its declared verbs
+      # qualified and the connection aggregate named off `connect`. `{}` when
+      # nothing this domain attaches provides payment_connection.
+      # @param registry [Runtime::Registry] the booted registry `domain_name` is loaded in
+      # @param domain_name [String] the domain to export the payment-connection binding for
+      # @return [Hash{Symbol => String, nil}] `:provider` (name), one qualified verb per contract key
+      #   (`:connect`, `:reconnect`, `:disconnect`, `:suspend`, `:resume`, `:enable`, `:disable`) and
+      #   `:aggregate` (`:connect`'s own leading qualified aggregate name); `{}` if nothing this
+      #   domain attaches provides payment_connection
+      def payment_connection(registry, domain_name)
+        provider = registry.payment_connection_provider_for(domain_name)
+        return {} unless provider
+
+        capability = Bluebook::Capabilities::PAYMENT_CONNECTION
+        verbs = Bluebook::Capabilities::CONTRACTS.fetch(capability).keys.to_h { |key| [key, provider.provided_verb(capability, key)] }
+        { provider: provider.name, **verbs, aggregate: verbs[:connect]&.split(".")&.first }
+      end
+
       # Same seam as `newsletter` — which chapter takes payments
       # (`Registry#payments_provider_for`), with its declared verbs
       # qualified and the paying aggregate named off `initiate`. rust/host

data/lib/hecks/runtime/registry.rb

@@ -403,6 +403,28 @@ module Hecks
         vendored_provider_for(domain, Bluebook::Capabilities::NEWSLETTER_ISSUES)
       end
 
+      # The chapter that answers scheduling sessions and taking registrations
+      # for `domain` — resolved the same way as `payments_provider_for`, by what
+      # it declares (`provides "registrations"`). Nil when none does.
+      #
+      # @param domain [String, Symbol] the domain whose registrations chapter is being resolved
+      # @return [Bluebook::Chapter, nil] the chapter that answers `domain`'s registrations,
+      #   or nil if none does
+      def registrations_provider_for(domain)
+        vendored_provider_for(domain, Bluebook::Capabilities::REGISTRATIONS)
+      end
+
+      # The chapter that owns the business's payment-processor connection for
+      # `domain` — resolved by what it declares (`provides "payment_connection"`).
+      # Nil when none does.
+      #
+      # @param domain [String, Symbol] the domain whose payment-connection chapter is being resolved
+      # @return [Bluebook::Chapter, nil] the chapter that owns `domain`'s payment connection,
+      #   or nil if none does
+      def payment_connection_provider_for(domain)
+        vendored_provider_for(domain, Bluebook::Capabilities::PAYMENT_CONNECTION)
+      end
+
       # The chapter that takes payments for `domain` — the domain's own
       # chapter, a framework member, or a vendored embryonaut bluebook it
       # attaches, that declares `provides "payments"`. Nil when none does.

data/lib/hecks/version.rb

@@ -12,5 +12,5 @@ module Hecks
   # it there, or even in the consuming Gemfile, never closed the gap,
   # because gemspec evaluation happens before anything Bundler
   # resolves is actually loadable yet.
-  VERSION = "2.4.0".freeze
+  VERSION = "2.5.0".freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hecks
 version: !ruby/object:Gem::Version
-  version: 2.4.0
+  version: 2.5.0
 platform: ruby
 authors:
 - Chris Young