iorwerth-hub 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8fe7207839b271a72800dc05b9e9f8ed43b39208e765082e3272f548abc3035a
-  data.tar.gz: 050fad5950fea4cec1f3d54fa4d2a5fa8a366331a9933ec514d42191bb3fec81
+  metadata.gz: d030b6a6a8d09a19eabfaa5d4de8f27682e144dfb968d3c05cbcb36359a334b8
+  data.tar.gz: 5f296810092251cb6de7e11b6edf527ba3069ffe649dd4a28d2b796d8f475641
 SHA512:
-  metadata.gz: 0c66317ece2c5fb5413f8ea43d1627e29a2af29d0b9aa39f6f366a7a54e5f84704ec4f517561625eed63c166074a1dea9c666a6618b4596e188a85ec2b26cef8
-  data.tar.gz: 987ca13d118419db3f8d9a9b11a35b87c96772388d5afd248f4e15526db858f634016781ec4b55fb4dd5d7ac4e01f5b7910e128d1f4f5798db9013570b6dc778
+  metadata.gz: 48155d512256d8a5147036ad71acb9142d78111df2a48e46a6866d588e128d274bf02be8e3bde04f9758d05d52bdd9b28fa396c32b07ba84cfce4b72d9fddfc1
+  data.tar.gz: 6fea37e940129be2dbc5a1907b109693dad63b867da00ebffb6fca2297502c8d882a60af19818de5d063cdd991ad804d3a321daf99c7f06e3af84d3211c9d63f

data/CHANGELOG.md

@@ -1,6 +1,18 @@
 # Changelog
 
-## 0.1.0 (unreleased)
+## 0.2.0
+
+- `checkout` and `portal`: Stripe Checkout and Customer Portal URLs for an organization.
+  `checkout` without `plan:` buys the plan the organization requested at signup.
+- `list_plans` answers no longer carry `ends_on`, and `interval` is `month` or `year`:
+  the Hub has no seasonal plans (ADR-0010).
+
+## 0.1.1
+
+- Sign-in works against a Hub on plain http, such as the local one from
+  `docker compose --profile dev up`: discovery no longer assumes https.
+
+## 0.1.0
 
 - First release: `Iorwerth::Hub::Client` for every `/api/v1` operation, `entitled?` and
   `limit` with a cache that survives a Hub outage, `Webhook.verify` and a Rack

data/README.md

@@ -40,6 +40,10 @@ HUB_API_KEY=...
 HUB_WEBHOOK_SECRET=...
 ```
 
+To develop against a Hub on your own machine, see
+[step 10 of the guide](../../docs/integration/connecting-a-product.md#10-test-locally):
+`docker compose --profile dev up` prints a ready-made block for `.env.development`.
+
 You can override any of them in code:
 
 ```ruby
@@ -73,7 +77,9 @@ def callback
   auth = request.env["omniauth.auth"]
   user = User.find_or_initialize_by(hub_id: auth.uid)
   user.update!(email: auth.info.email, name: auth.info.name)
-  Iorwerth::Hub.organizations(auth).each do |organization|
+  # Each has "type": "business" or "personal". A product whose customers are
+  # organizations provisions business ones; one for individuals, the personal one.
+  Iorwerth::Hub.organizations(auth).select { |o| o["type"] == "business" }.each do |organization|
     tenant = Tenant.find_or_create_by!(hub_organization_id: organization["id"])
     # ...
   end
@@ -87,6 +93,8 @@ hub = Iorwerth::Hub.client
 hub.get_organization("org_01J...")              # profile, members, subscription, entitlements
 hub.report_tenant("org_01J...", external_tenant_id: tenant.id.to_s)
 hub.report_usage("org_01J...", usage: { teams: 7 })
+hub.checkout("org_01J...", plan: "pro", success_url: done_url, cancel_url: billing_url)["url"]
+hub.portal("org_01J...", return_url: billing_url)["url"]   # "Manage billing"
 hub.invite("org_01J...", email: "sam@example.com", role: "member")
 hub.each_organization { |organization| ... }    # every organization this product can see
 hub.each_event(since: last_event_id) { |event| ... }   # catch up after downtime

data/lib/iorwerth/hub/client.rb

@@ -23,6 +23,8 @@ module Iorwerth
         "get_organization" => [:get, "/api/v1/organizations/{organization_id}"],
         "get_entitlements" => [:get, "/api/v1/organizations/{organization_id}/entitlements"],
         "report_tenant" => [:post, "/api/v1/organizations/{organization_id}/tenant"],
+        "checkout" => [:post, "/api/v1/organizations/{organization_id}/checkout"],
+        "portal" => [:post, "/api/v1/organizations/{organization_id}/portal"],
         "get_usage" => [:get, "/api/v1/organizations/{organization_id}/usage"],
         "report_usage" => [:post, "/api/v1/organizations/{organization_id}/usage"],
         "invite" => [:post, "/api/v1/organizations/{organization_id}/invites"],
@@ -74,6 +76,19 @@ module Iorwerth
                               idempotency_key: idempotency_key)
       end
 
+      # A Stripe Checkout page for one of this product's plans; without plan:, the one requested
+      # at signup. Redirect the customer to answer["url"].
+      def checkout(organization_id, success_url:, cancel_url:, plan: nil, idempotency_key: SecureRandom.uuid)
+        body = { plan: plan, success_url: success_url, cancel_url: cancel_url }.compact
+        call("checkout", organization_id: organization_id, body: body, idempotency_key: idempotency_key)
+      end
+
+      # A Stripe Customer Portal page: card, invoices, plan changes, cancellation.
+      def portal(organization_id, return_url:, idempotency_key: SecureRandom.uuid)
+        call("portal", organization_id: organization_id, body: { return_url: return_url },
+                       idempotency_key: idempotency_key)
+      end
+
       def get_usage(organization_id)
         call("get_usage", organization_id: organization_id)
       end

data/lib/iorwerth/hub/omniauth.rb

@@ -36,6 +36,9 @@ module OmniAuth
         options.client_options.scheme = hub.scheme
         options.client_options.host = hub.host
         options.client_options.port = hub.port
+        # A Hub on a laptop (the Compose dev profile) is plain http, and discovery builds
+        # https URLs unless told otherwise. Production Hubs are https, so this never applies.
+        SWD.url_builder = URI::HTTP if hub.scheme == "http"
       end
 
       def request_phase

data/lib/iorwerth/hub/version.rb

@@ -2,6 +2,6 @@
 
 module Iorwerth
   module Hub
-    VERSION = "0.1.0"
+    VERSION = "0.2.0"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: iorwerth-hub
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Iorwerth Technologies
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-02 00:00:00.000000000 Z
+date: 2026-10-08 00:00:00.000000000 Z
 dependencies: []
 description: Sign-in through the Hub (OmniAuth), its /api/v1 client, cached entitlement
   checks, and a Rack endpoint that verifies the Hub's webhooks.