myrr-rb 0.3.3

data/lib/myrr/transaction.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Myrr
+  # Read-only value object representing a wallet transaction.
+  class Transaction
+    attr_reader :id, :amount, :currency, :status, :source, :merchant_name,
+                :merchant_category, :decline_reason, :created_at
+
+    # @param attrs [Hash] Transaction attributes from the API
+    def initialize(attrs)
+      @id = attrs["id"]
+      @amount = attrs["amount"]
+      @currency = attrs["currency"] || "usd"
+      @status = attrs["status"]
+      @source = attrs["source"]
+      @merchant_name = attrs["merchant_name"]
+      @merchant_category = attrs["merchant_category"]
+      @decline_reason = attrs["decline_reason"]
+      @created_at = attrs["created_at"]
+    end
+
+    # @return [String] Human-readable amount
+    def amount_dollars
+      "$" + format("%.2f", @amount.to_f / 100)
+    end
+
+    # @return [Boolean] Whether the transaction was authorized
+    def authorized?
+      @status == "authorized"
+    end
+
+    # @return [Boolean] Whether the transaction was declined
+    def declined?
+      @status == "declined"
+    end
+
+    # @return [Boolean] Whether this is a funding transaction
+    def funding?
+      @status == "funding"
+    end
+
+    # @return [Boolean] Whether this is a Myrr Pay top-up
+    def myrr_pay_topup?
+      @source == "myrr_pay_topup"
+    end
+
+    # @return [Boolean] Whether this is a wallet funding
+    def wallet_funding?
+      @source == "wallet_funding"
+    end
+
+    # @return [Boolean] Whether this is a regular merchant purchase
+    def merchant_purchase?
+      @source.nil? || @source == "merchant_purchase"
+    end
+  end
+end

data/lib/myrr/version.rb

@@ -0,0 +1,3 @@
+module Myrr
+  VERSION = "0.3.3"
+end

data/lib/myrr/wallet.rb

@@ -0,0 +1,131 @@
+# frozen_string_literal: true
+
+require "json"
+require_relative "client"
+
+module Myrr
+  # Wallet client for the Myrr protocol server.
+  #
+  # @example
+  #   wallet = Myrr::Wallet.create(agent_did: "did:myrr:abc123")
+  #   wallet = Myrr::Wallet.find("wallet-uuid")
+  #   wallet = Myrr::Wallet.find_by_agent("did:myrr:abc123")
+  #   wallet.fund(amount_cents: 50_00)
+  #   wallet.cards  # => Array of Myrr::Card
+  #   wallet.transactions(limit: 10)
+  #   wallet.topup(seller_did: "did:myrr:seller", seller_name: "DataPulse", amount_cents: 10_00, payment_intent_id: "pi_xxx")
+  class Wallet
+    attr_reader :id, :agent_did, :balance, :currency, :status, :stripe_customer_id,
+                :metadata, :created_at, :updated_at
+
+    # @param attrs [Hash] Wallet attributes from the API
+    def initialize(attrs)
+      @id = attrs["id"]
+      @agent_did = attrs["agent_did"]
+      @balance = attrs["balance"]
+      @currency = attrs["currency"] || "usd"
+      @status = attrs["status"]
+      @stripe_customer_id = attrs["stripe_customer_id"]
+      @metadata = attrs["metadata"]
+      @created_at = attrs["created_at"]
+      @updated_at = attrs["updated_at"]
+    end
+
+    # Create a new wallet for the given agent.
+    #
+    # @param agent_did [String] The did:myrr: identifier
+    # @param metadata [Hash] Optional metadata
+    # @param client [Myrr::Client, nil] Optional custom client
+    # @return [Myrr::Wallet]
+    def self.create(agent_did:, metadata: {}, client: nil)
+      client ||= Myrr.client
+      body = { agent_did: agent_did }
+      body[:metadata] = metadata if metadata.any?
+      resp = client.send(:post, "/v1/wallets", body)
+      new(resp)
+    end
+
+    # Find a wallet by its UUID.
+    #
+    # @param id [String] Wallet UUID
+    # @param client [Myrr::Client, nil] Optional custom client
+    # @return [Myrr::Wallet, nil]
+    def self.find(id, client: nil)
+      client ||= Myrr.client
+      resp = client.send(:get, "/v1/wallets/#{id}")
+      new(resp)
+    rescue Myrr::Error => e
+      raise unless e.message.include?("not_found")
+      nil
+    end
+
+    # Find a wallet by its agent did:myrr: identifier.
+    #
+    # @param agent_did [String] The did:myrr: identifier
+    # @param client [Myrr::Client, nil] Optional custom client
+    # @return [Myrr::Wallet, nil]
+    def self.find_by_agent(agent_did, client: nil)
+      client ||= Myrr.client
+      resp = client.send(:get, "/v1/wallets?agent_did=#{agent_did}")
+      new(resp)
+    rescue Myrr::Error => e
+      raise unless e.message.include?("not_found")
+      nil
+    end
+
+    # Pre-approve a Myrr Pay top-up before confirming the PaymentIntent.
+    #
+    # @param seller_did [String] Seller's did:myrr: identifier
+    # @param seller_name [String] Seller's display name
+    # @param amount_cents [Integer] Top-up amount in cents
+    # @param payment_intent_id [String] Stripe PaymentIntent ID
+    # @param metadata [Hash] Optional metadata
+    # @return [Hash] { "status" => "approved"/"declined", "reason" => String? }
+    def topup(seller_did:, seller_name:, amount_cents:, payment_intent_id: nil, metadata: {})
+      body = {
+        seller_did: seller_did,
+        seller_name: seller_name,
+        amount_cents: amount_cents,
+        payment_intent_id: payment_intent_id
+      }
+      body[:metadata] = metadata if metadata.any?
+      self.class.client.send(:post, "/v1/wallets/#{id}/topups", body)
+    end
+
+    # Create a Stripe Checkout session to fund this wallet.
+    #
+    # @param amount_cents [Integer] Amount in cents (minimum 50)
+    # @return [String] Checkout URL
+    def fund(amount_cents:)
+      resp = self.class.client.send(:post, "/v1/wallets/#{id}/fund", { amount_cents: amount_cents })
+      resp["checkout_url"]
+    end
+
+    # List virtual cards for this wallet.
+    #
+    # @return [Array<Myrr::Card>]
+    def cards
+      resp = self.class.client.send(:get, "/v1/wallets/#{id}/cards")
+      (resp["cards"] || []).map { |c| Myrr::Card.new(c) }
+    end
+
+    # List transactions for this wallet.
+    #
+    # @param limit [Integer] Max results (default 20, max 100)
+    # @param before [String, nil] Cursor for pagination
+    # @return [Array<Myrr::Transaction>]
+    def transactions(limit: 20, before: nil)
+      query = "limit=#{limit}"
+      query += "&before=#{before}" if before
+      resp = self.class.client.send(:get, "/v1/wallets/#{id}/transactions?#{query}")
+      txns = (resp["transactions"] || []).map { |t| Myrr::Transaction.new(t) }
+      [txns, resp["has_more"], resp["next_cursor"]]
+    end
+
+    private
+
+    def self.client
+      Myrr.client
+    end
+  end
+end

data/lib/myrr-rb.rb

@@ -0,0 +1,3 @@
+# Entry point for bundler's auto-require.
+# Bundler calls `require "myrr-rb"` for `gem "myrr-rb"`.
+require_relative "myrr"

data/lib/myrr.rb

@@ -0,0 +1,76 @@
+require_relative "myrr/version"
+require_relative "myrr/configuration"
+require_relative "myrr/tokenizer"
+require_relative "myrr/port/middleware"
+require_relative "myrr/railtie" if defined?(Rails::Railtie)
+
+# Myrr — Agent-friendly content for your Rails app.
+#
+# In its default (Port) mode, myrr-rb counts tokens on every text/markdown
+# response and adds an +X-Token-Count+ header.  No Go server, no database,
+# no configuration required.
+#
+# @example Zero-config setup
+#   # Just add the gem, create .md.erb views, and you're done.
+module Myrr
+  class Error < StandardError; end
+
+  class << self
+    # The current configuration object.
+    # @return [Myrr::Configuration]
+    attr_reader :config
+
+    # Configure Myrr.
+    #
+    # @yield [config] Yields the configuration object for modification.
+    # @yieldparam config [Myrr::Configuration]
+    def configure
+      @config ||= Configuration.new
+      yield(@config) if block_given?
+      @config
+    end
+
+    # Reset configuration to defaults.
+    def reset_config!
+      @config = Configuration.new
+    end
+
+    # Create a new protocol server client.
+    # Requires +protocol_server_url+ to be configured.
+    # (Identity-layer feature — opt-in, requires explicit require.)
+    #
+    # @return [Myrr::Client]
+    def client
+      Client.new(
+        server_url: config.protocol_server_url,
+        api_key: config.site_api_key,
+        open_timeout: config.open_timeout,
+        read_timeout: config.read_timeout
+      )
+    end
+
+    # Verify an agent identity. Returns agent info or nil.
+    # (Identity-layer feature — opt-in, requires explicit require.)
+    #
+    # Performs challenge-response verification via the configured protocol
+    # server (or identity_adapter). If +fail_open+ is true, returns nil
+    # on network errors instead of raising.
+    #
+    # @param did_key [String] The did:myrr: identifier
+    # @return [Hash, nil] Agent info with +did_key+, +status+, +owner+, or nil
+    def verify_agent(did_key)
+      if config.identity_adapter
+        config.identity_adapter.call(did_key)
+      else
+        client.verify(did_key)
+      end
+    rescue => e
+      if config.fail_open
+        warn "[myrr] Identity verification failed (fail_open=true): #{e.message}"
+        nil
+      else
+        raise
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,150 @@
+--- !ruby/object:Gem::Specification
+name: myrr-rb
+version: !ruby/object:Gem::Version
+  version: 0.3.3
+platform: ruby
+authors:
+- Kaka Ruto
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: tiktoken_ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.16
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.16
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.20'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.20'
+- !ruby/object:Gem::Dependency
+  name: rack-test
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.19'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.19'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: Count tokens on text/markdown responses, add an X-Token-Count header,
+  and serve .md.erb views alongside .html.erb. Zero config out of the box.
+email:
+- kr@kakaruto.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/generators/myrr/install/install_generator.rb
+- lib/generators/myrr/install/templates/initializer.rb
+- lib/myrr-rb.rb
+- lib/myrr.rb
+- lib/myrr/bridge.rb
+- lib/myrr/budget.rb
+- lib/myrr/card.rb
+- lib/myrr/client.rb
+- lib/myrr/configuration.rb
+- lib/myrr/pay.rb
+- lib/myrr/pay/client.rb
+- lib/myrr/pay/middleware.rb
+- lib/myrr/port/metadata.rb
+- lib/myrr/port/middleware.rb
+- lib/myrr/rack/middleware.rb
+- lib/myrr/railtie.rb
+- lib/myrr/tokenizer.rb
+- lib/myrr/transaction.rb
+- lib/myrr/version.rb
+- lib/myrr/wallet.rb
+homepage: https://myrrlabs.com
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://myrrlabs.com
+  source_code_uri: https://github.com/myrrlabs/myrr-rb
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: Agent-friendly content for your Rails app
+test_files: []