portage-ucp-client 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 96ae3a5da5ef868663d2b296539ef3812249479031f6237f0c4dbb5679dda268
-  data.tar.gz: 7b132dc0d5c2152a2bba93db9629e5c897331a5360d95894cc84028fb9052ee9
+  metadata.gz: 88904b38d834b4f1b1343d35f50db2149828dc76edd179a778c511cb17119880
+  data.tar.gz: 334b55de228968238f9737e079ee719119232c81c631dcda00be1bd68e7c44d2
 SHA512:
-  metadata.gz: 88439c696a4d6c6b4ead359c4b463b00fc07f02e811774096e745d7e95880b45b67ec3d948c5beffea0f0bd56456834305c774cc4d2b0a7281846840fd526bc3
-  data.tar.gz: d0965725d9e6914ae0bd19a0f2e8acabd182c943d01d0cb810458e3edc9d9d3001cf67bea1931eca3258b0315f32328e47b156a752c5f935bc07772d1ac9d0b3
+  metadata.gz: ba6fbffe20114f8c1d328dd7399f792a4dbaa81d03fb589366e8ec312c8efd08299b349aa5c0eaa9fd16254c4af9c4e3d9881387ae61163fb0d40ecebb92a7dc
+  data.tar.gz: 5dbce7d84c0b54d8068be7d95713855b94e765a6c945ea4c9e13bc86c02bf19683b87b6db8431173eb27b46363df3838bc264147259a470c430cf3a0ee48c79d

data/CHANGELOG.md

@@ -4,7 +4,16 @@ All notable changes to this project are documented here. Format loosely follows
 [Keep a Changelog](https://keepachangelog.com/en/1.0.0/); this project is
 pre-1.0, so APIs may still shift between minor versions.
 
-## [0.1.0] - Unreleased
+## [0.2.0] - 2026-08-21
+
+- `Session#create_checkout`/`#update_checkout` gain an optional `fulfillment:`
+  param, passed through only when given. Only exercised end-to-end over the
+  loopback transport (an in-process `Adapter`, taking a real
+  `Portage::Ucp::CheckoutFulfillment`); the stdio/HTTP wire shape for
+  `fulfillment` has no real UCP server to verify it against yet, so it's not
+  wired there.
+
+## [0.1.0] - 2026-08-14
 
 - Initial pre-release. Client-side SDK — loopback, stdio, and Streamable HTTP
   transports behind one `Session` interface.

data/lib/portage/ucp/client/session.rb

@@ -55,14 +55,22 @@ module Portage
           call("cancel_cart", cart_id: cart_id, idempotency_key: idempotency_key)
         end
 
-        def create_checkout(line_items:, idempotency_key: nil)
-          call("create_checkout", line_items: line_items, idempotency_key: idempotency_key)
+        # `fulfillment:` (dev.ucp.shopping.fulfillment) is only exercised over
+        # the loopback transport today (Portage::Cli::Buy's own-store adapter
+        # path) — passed straight through as whatever value the caller built
+        # (a Portage::Ucp::CheckoutFulfillment for loopback). Over stdio/HTTP
+        # it would need a JSON wire shape this gem doesn't build yet, so
+        # callers on those transports should leave it nil.
+        def create_checkout(line_items:, idempotency_key: nil, fulfillment: nil)
+          call("create_checkout", line_items: line_items, idempotency_key: idempotency_key,
+                                  **(fulfillment ? { fulfillment: fulfillment } : {}))
         end
 
         def get_checkout(checkout_id:) = call("get_checkout", checkout_id: checkout_id)
 
-        def update_checkout(checkout_id:, line_items:, idempotency_key: nil)
-          call("update_checkout", checkout_id: checkout_id, line_items: line_items, idempotency_key: idempotency_key)
+        def update_checkout(checkout_id:, line_items:, idempotency_key: nil, fulfillment: nil)
+          call("update_checkout", checkout_id: checkout_id, line_items: line_items, idempotency_key: idempotency_key,
+                                  **(fulfillment ? { fulfillment: fulfillment } : {}))
         end
 
         def complete_checkout(checkout_id:, payment_token:, idempotency_key: nil)

data/lib/portage/ucp/client/version.rb

@@ -1,7 +1,7 @@
 module Portage
   module Ucp
     module Client
-      VERSION = "0.1.0".freeze
+      VERSION = "0.2.0".freeze
     end
   end
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: portage-ucp-client
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Tom Whitbread
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-14 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mcp
@@ -30,14 +29,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -100,7 +99,6 @@ description: 'Every other portage-ucp gem lets a Ruby program expose a commerce
   as the client. Three transports behind one interface (loopback over an in-process
   Adapter, stdio, Streamable HTTP) — callers never know which they got. Depends only
   on portage-ucp + the mcp gem''s client half; no adapter gem is a dependency.'
-email:
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -123,7 +121,6 @@ metadata:
   source_code_uri: https://github.com/tomtom87/Portage/tree/main/portage-ucp-client
   changelog_uri: https://github.com/tomtom87/Portage/blob/main/portage-ucp-client/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -138,8 +135,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 4.0.18
 specification_version: 4
 summary: Client-side SDK for portage-ucp — act as the shopper's agent against any
   UCP/MCP server