hecks 2.2.0 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1fad5f64ba40ddec2720f013efc33d54e7ce5ebaf0926bc0670b642f91e53416
-  data.tar.gz: a714cad37a3a9c02f2ece530fc2c417e019f3ac47e0f0b76fd2c336416c2d55d
+  metadata.gz: 07b56eefa1dd5cd2cc6308fa35aab4b8aba8af59da9418283d98a1235268e3c4
+  data.tar.gz: cc996a57a43dc3652a062c6af748545ec5846d50c08a43d372224e402c60fbf7
 SHA512:
-  metadata.gz: 3ed37d25061346166c25415b92be46409ecefa3eb762fef81941c4758ecc3a2681241f29a4c819a28ad360ee0267919612f9fedb9c56c1be00d0a9a70d512e6e
-  data.tar.gz: 7b6b0df13da60ef2a40a002d2a847b284164518c51363227c01f1d00e548e3d544b25a27d28053ff1af2469c6f802f4a5bd94103b6d2a9a9ed491710b9152217
+  metadata.gz: aab93180168cb073c8f65b05697cfe8c94f68d43a0516e2f8540d0c457d2ff238173fc223006f72e1681b870dcdd86b1ae65d1883d7d5375f62207b2b4a08b6d
+  data.tar.gz: 941f1214a2f1f7a144c57e8c0fc780d5444133973170afbc1d5dd6e646c0456feaaf73ac58da9382fc0b229af37a929e15eb8b77dd0dc36216187fd2341d8e04

data/lib/hecks/bluebook/capabilities.rb

@@ -32,6 +32,13 @@ module Hecks
       # "Newsletter". rust/host's newsletter routes dispatch these verbs
       # and read the subscribing aggregate's instances off `subscribe`.
       NEWSLETTER = "newsletter".freeze
+      # Sending an issue to the confirmed subscribers: the decision to send
+      # and the record of each email handed to the mail provider. A separate
+      # capability from `NEWSLETTER` so a chapter that only takes signups
+      # declares nothing more; rust/host serves the send route only when a
+      # chapter declares this one as well.
+      NEWSLETTER_ISSUES = "newsletter_issues".freeze
+
       # Taking a payment through an external processor: start one, then
       # hear the processor's verdict — recognised by declaration, not the
       # literal chapter name "Payments". rust/host's checkout and webhook
@@ -42,7 +49,7 @@ module Hecks
       PAYMENTS = "payments".freeze
 
       CONTRACTS = {
-        AUTHORIZATION => {
+        AUTHORIZATION     => {
           # every assignment an actor holds, current or historical
           assignments: :query,
           # the command that grants an actor a role
@@ -50,7 +57,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)
@@ -58,7 +65,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
@@ -66,7 +73,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
@@ -76,7 +83,14 @@ module Hecks
           # a subscriber leaves from the emailed link
           unsubscribe: :command
         }.freeze,
-        PAYMENTS      => {
+        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          => {
           # start a payment; the aggregate it names is the payment
           initiate:  :command,
           # the processor reports the money arrived

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

@@ -303,6 +303,8 @@ Hecks.bluebook "Bluebook", version: "1" do
       member keyword: "provides",        context: "Bluebook", at: "",  named: "initiate",    kind: "text", required: "false", fills: "provides"
       member keyword: "provides",        context: "Bluebook", at: "",  named: "succeeded",   kind: "text", required: "false", fills: "provides"
       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: "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

@@ -202,6 +202,34 @@ module Hecks
         }
       end
 
+      # Which chapter answers sending a newsletter issue
+      # (`Registry#newsletter_issues_provider_for`), with its declared verbs
+      # qualified and the issue and delivery aggregates named off them.
+      # rust/host's send route reads this instead of naming
+      # Newsletter::Issue.Send and Newsletter::Delivery.Record. `{}` when
+      # nothing this domain attaches provides newsletter_issues.
+      # @param registry [Runtime::Registry] the booted registry `domain_name` is loaded in
+      # @param domain_name [String] the domain to export the issue-sending binding for
+      # @return [Hash{Symbol => String, nil}] `:provider` (name), `:send_issue`,
+      #   `:record_delivery` (qualified verbs), `:issue_aggregate` and `:delivery_aggregate`
+      #   (each verb's own leading qualified aggregate name); `{}` if nothing this domain
+      #   attaches provides newsletter_issues
+      def newsletter_issues(registry, domain_name)
+        provider = registry.newsletter_issues_provider_for(domain_name)
+        return {} unless provider
+
+        capability = Bluebook::Capabilities::NEWSLETTER_ISSUES
+        send_issue = provider.provided_verb(capability, :send_issue)
+        record_delivery = provider.provided_verb(capability, :record_delivery)
+        {
+          provider:           provider.name,
+          send_issue:         send_issue,
+          record_delivery:    record_delivery,
+          issue_aggregate:    send_issue&.split(".")&.first,
+          delivery_aggregate: record_delivery&.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

@@ -392,6 +392,17 @@ module Hecks
         vendored_provider_for(domain, Bluebook::Capabilities::NEWSLETTER)
       end
 
+      # The chapter that answers sending a newsletter issue for `domain` —
+      # resolved the same way as `newsletter_provider_for`, by what it
+      # declares (`provides "newsletter_issues"`). Nil when none does.
+      #
+      # @param domain [String, Symbol] the domain whose issue-sending chapter is being resolved
+      # @return [Bluebook::Chapter, nil] the chapter that answers `domain`'s issue sending,
+      #   or nil if none does
+      def newsletter_issues_provider_for(domain)
+        vendored_provider_for(domain, Bluebook::Capabilities::NEWSLETTER_ISSUES)
+      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.2.0".freeze
+  VERSION = "2.3.0".freeze
 end

metadata

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