rate-card 0.1.0

data/lib/rate_card/tui/fields/select.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+module RateCard
+  module TUI
+    module Fields
+      # Pick exactly one. Bubbles::List would do this, but it brings a title
+      # bar, pagination and a filter this wizard has no use for, and it cannot
+      # be shared with MultiSelect below — so both are built on one small
+      # cursor-and-window core instead.
+      class Select
+        WINDOW = 8
+
+        attr_reader :label
+
+        # choices: Array<[display String, value]>
+        # selected: index the cursor starts on, so a field re-entered by going
+        # back opens on the answer it already has rather than on the first row.
+        def initialize(label:, choices:, selected: 0)
+          @label = label
+          @choices = choices
+          @cursor = selected
+          @value = nil
+          @chosen = false
+        end
+
+        def done? = @chosen
+        def value = @value
+
+        def update(message)
+          return nil unless message.is_a?(Bubbletea::KeyMessage)
+
+          if message.up? || message.to_s == 'k'
+            move(-1)
+          elsif message.down? || message.to_s == 'j'
+            move(1)
+          elsif message.enter?
+            @value = @choices[@cursor].last
+            @chosen = true
+          end
+          nil
+        end
+
+        def view
+          lines = ["#{Theme.accent(Theme::CURSOR)} #{Theme.bold(@label)}"]
+          window.each do |index|
+            display = @choices[index].first
+            lines << if index == @cursor
+                       "  #{Theme.accent(Theme::CURSOR)} #{Theme.accent(display)}"
+                     else
+                       "    #{display}"
+                     end
+          end
+          lines << "  #{Theme.muted(hint)}"
+          lines.join("\n")
+        end
+
+        private
+
+        def move(delta)
+          @cursor = (@cursor + delta) % @choices.length
+        end
+
+        # Keeps the cursor inside a fixed-height window so a long service list
+        # does not push the banner and earlier answers off the screen.
+        def window
+          return (0...@choices.length) if @choices.length <= WINDOW
+
+          start = [[@cursor - (WINDOW / 2), 0].max, @choices.length - WINDOW].min
+          (start...(start + WINDOW))
+        end
+
+        def hint
+          parts = ['↑↓ move', 'enter confirm', 'esc back']
+          parts << "#{@cursor + 1}/#{@choices.length}" if @choices.length > WINDOW
+          parts.join(' · ')
+        end
+      end
+    end
+  end
+end

data/lib/rate_card/tui/fields/text.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+require 'bubbles'
+
+module RateCard
+  module TUI
+    module Fields
+      # A single-line answer, optionally masked and optionally validated.
+      #
+      # Validation runs on Enter and keeps the field open on failure, so a
+      # mistyped zone list or a mangled paste of a JWT costs a keystroke rather
+      # than the run — the same guarantee the tty-prompt wizard made.
+      class Text
+        attr_reader :label, :error
+
+        # parse: String -> value, raising ArgumentError with a message to show.
+        def initialize(label:, parse:, default: nil, mask: false, hint: nil)
+          @label = label
+          @parse = parse
+          @default = default
+          @hint = hint
+          @error = nil
+          @value = nil
+
+          @input = Bubbles::TextInput.new
+          @input.prompt = ''
+          @input.placeholder = default.to_s if default
+          if mask
+            @input.echo_mode = :password
+            @input.echo_character = '•'
+          end
+          @input.focus
+        end
+
+        def done? = !@value.nil?
+        def value = @value
+
+        def update(message)
+          if message.is_a?(Bubbletea::KeyMessage) && message.enter?
+            submit
+            return nil
+          end
+
+          @input, command = @input.update(message)
+          command
+        end
+
+        def view
+          lines = ["#{Theme.accent(Theme::CURSOR)} #{Theme.bold(@label)} #{@input.view}"]
+          lines << "  #{Theme.muted("#{@hint} · esc back")}" if @hint
+          lines << "  #{Theme.danger(Theme::CROSS)} #{Theme.danger(@error)}" if @error
+          lines.join("\n")
+        end
+
+        private
+
+        # An empty answer means "take the default"; without this the placeholder
+        # would be shown but never actually used.
+        def submit
+          raw = @input.value.to_s.strip
+          raw = @default.to_s if raw.empty? && @default
+
+          @value = @parse.call(raw)
+          @error = nil
+        rescue ArgumentError => e
+          @error = e.message
+          @value = nil
+          @input.reset
+        end
+      end
+    end
+  end
+end

data/lib/rate_card/tui/messages.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require 'bubbletea'
+
+module RateCard
+  module TUI
+    # Results of work done off the event loop. Bubbletea runs a Proc command in
+    # a Thread and feeds whatever it returns back through #update, and the fetch
+    # pushes ProgressAdvanced from its worker threads via Runner#send.
+    class ServicesLoaded < Bubbletea::Message
+      attr_reader :services
+
+      def initialize(services)
+        super()
+        @services = services
+      end
+    end
+
+    class LoadFailed < Bubbletea::Message
+      attr_reader :error
+
+      def initialize(error)
+        super()
+        @error = error
+      end
+    end
+
+    # Carries the running failure count so the bar can show trouble as it
+    # happens: on a doomed run the user should not have to wait out all 128
+    # calls to find out.
+    class ProgressAdvanced < Bubbletea::Message
+      attr_reader :completed, :failed
+
+      def initialize(completed:, failed:)
+        super()
+        @completed = completed
+        @failed = failed
+      end
+    end
+
+    class FetchFinished < Bubbletea::Message
+      attr_reader :grid
+
+      def initialize(grid)
+        super()
+        @grid = grid
+      end
+    end
+
+    class FetchFailed < Bubbletea::Message
+      attr_reader :error
+
+      def initialize(error)
+        super()
+        @error = error
+      end
+    end
+  end
+end

data/lib/rate_card/tui/theme.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require 'lipgloss'
+
+module RateCard
+  module TUI
+    # Every colour and glyph the TUI uses. Lipgloss strips colour by itself when
+    # stdout is not a terminal, so nothing here needs a tty? guard — unlike the
+    # Pastel/TTY pairing this replaced, where only Pastel was gated and the
+    # spinner and bar leaked escapes into a pipe.
+    module Theme
+      ACCENT  = Lipgloss::AdaptiveColor.new(dark: '#00D3FF', light: '#0072B5')
+      OK      = Lipgloss::AdaptiveColor.new(dark: '#2ECC71', light: '#1E8449')
+      WARNING = Lipgloss::AdaptiveColor.new(dark: '#F5A623', light: '#B7791F')
+      DANGER  = Lipgloss::AdaptiveColor.new(dark: '#FF5C5C', light: '#C0392B')
+      MUTED   = Lipgloss::AdaptiveColor.new(dark: '#8A8A8A', light: '#6B6B6B')
+
+      CURSOR      = '❯'
+      CHECKED     = '◉'
+      UNCHECKED   = '○'
+      TICK        = '✓'
+      CROSS       = '✗'
+      BULLET      = '▸'
+      ALERT       = '⚠'
+
+      module_function
+
+      def style = Lipgloss::Style.new
+
+      def accent(text)  = style.foreground(ACCENT).render(text)
+      def ok(text)      = style.foreground(OK).render(text)
+      def warning(text) = style.foreground(WARNING).render(text)
+      def danger(text)  = style.foreground(DANGER).render(text)
+      def muted(text)   = style.foreground(MUTED).render(text)
+      def bold(text)    = style.bold(true).render(text)
+
+      def title(text)
+        style.bold(true).foreground(ACCENT).render(text)
+      end
+
+      # The run targets production and cannot be pointed elsewhere, so the
+      # banner says so in the one colour the eye catches first.
+      def banner
+        style.border(Lipgloss::ROUNDED_BORDER)
+             .border_foreground(ACCENT)
+             .padding(0, 1)
+             .render("#{bold('eHub Rate Card Builder')}\n#{danger('●')} production · api.ehub.com")
+      end
+    end
+  end
+end

data/lib/rate_card/ui.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+require_relative 'tui/theme'
+
+module RateCard
+  # Plain, non-interactive output: everything printed before the TUI starts or
+  # after it exits — errors, the rate tables, the failure and warning reports,
+  # and where the files went.
+  #
+  # The interactive half (banner, prompts, spinner, progress) moved to TUI::App
+  # when this switched to Bubbletea. What stays here is deliberately dumb line
+  # printing, so tables and reports survive being piped to a file and specs can
+  # still assert against a StringIO.
+  class UI
+    MAX_LISTED_FAILURES = 10
+    MAX_LISTED_WARNINGS = 10
+
+    def initialize(io: $stdout)
+      @io = io
+    end
+
+    # The one thing printed before the TUI starts, so the run says what it
+    # targets before a production token is pasted into it.
+    def banner
+      @io.puts
+      @io.puts TUI::Theme.banner
+      @io.puts
+    end
+
+    # No newline: the answer is typed on the same line.
+    def prompt(message)
+      @io.print "#{TUI::Theme.accent(TUI::Theme::CURSOR)} #{TUI::Theme.bold(message)}"
+      @io.flush
+    end
+
+    def info(message)
+      @io.puts "#{TUI::Theme.accent(TUI::Theme::BULLET)} #{message}"
+    end
+
+    def warn(message)
+      @io.puts "  #{TUI::Theme.warning(TUI::Theme::ALERT)} #{message}"
+    end
+
+    def error(message)
+      @io.puts "  #{TUI::Theme.danger(TUI::Theme::CROSS)} #{message}"
+    end
+
+    def success(message)
+      @io.puts "  #{TUI::Theme.ok(TUI::Theme::TICK)} #{message}"
+    end
+
+    def blank
+      @io.puts
+    end
+
+    def print_tables(tables)
+      tables.each do |title, rendered|
+        @io.puts
+        @io.puts "  #{TUI::Theme.bold(title)}"
+        @io.puts rendered
+      end
+    end
+
+    def failure_report(failures, spec:)
+      return if failures.empty?
+
+      @io.puts
+      warn "#{failures.length} #{failures.length == 1 ? 'cell' : 'cells'} failed"
+      failures.first(MAX_LISTED_FAILURES).each do |failure|
+        @io.puts "      #{row_prefix(spec)}#{spec.row_label(failure.weight)}  Z#{failure.zone}  → #{failure.message}"
+      end
+      remaining = failures.length - MAX_LISTED_FAILURES
+      @io.puts "      … and #{remaining} more" if remaining.positive?
+    end
+
+    # What the API itself reported on calls that succeeded. Separate from
+    # #failure_report: those cells have no answer, these have an answer that
+    # says why there is no rate.
+    def warning_report(warnings)
+      return if warnings.empty?
+
+      @io.puts
+      noun = warnings.length == 1 ? 'warning' : 'warnings'
+      warn "the API reported #{warnings.length} #{noun}"
+
+      listed = warnings.first(MAX_LISTED_WARNINGS)
+      account, service = listed.partition(&:account_wide?)
+      warning_group("for this card's services", service)
+      warning_group('for every service on this token, including ones not in this card', account)
+
+      remaining = warnings.length - MAX_LISTED_WARNINGS
+      @io.puts "      … and #{remaining} more" if remaining.positive?
+    end
+
+    # Headed rather than filtered. An account-wide message can still be about
+    # this card — 'Unable to verify address' names the destination we sent — so
+    # dropping the ones that do not name a selected service would delete the
+    # most actionable warning in the run. The heading says what it can be
+    # blamed on and leaves the reading to the user.
+    def warning_group(heading, warnings)
+      return if warnings.empty?
+
+      @io.puts "      #{heading}"
+      warnings.each do |warning|
+        repeat = warning.count > 1 ? " (×#{warning.count})" : ''
+        @io.puts "        #{warning.message}#{repeat}"
+      end
+    end
+
+    def saved(paths)
+      return if paths.empty?
+
+      @io.puts
+      noun = paths.length == 1 ? 'file' : 'files'
+      success "Saved #{paths.length} #{noun} to #{paths.first.dirname}"
+      paths.each { |path| @io.puts "      #{path.basename}" }
+    end
+
+    # "wt " in weight mode, so failure lines read exactly as before; nothing
+    # extra in cubic mode, since row_label is already self-describing
+    # ("Tier 3", not just "3").
+    def row_prefix(spec)
+      spec.rate_mode == :cubic ? '' : 'wt '
+    end
+  end
+end

data/lib/rate_card/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module RateCard
+  VERSION = '0.1.0'
+end

data/lib/rate_card/warning.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module RateCard
+  # One distinct thing the API told us went wrong, with how many calls said it.
+  #
+  # Deliberately not keyed by (weight, zone) the way Failure is: a carrier
+  # outage repeats the same message on all 128 calls, and the user needs the
+  # message once, not a wall of it.
+  #
+  # `scope` is what the message can be blamed on. :service means it came from
+  # the `errors` field of a service in this card, so it explains that service's
+  # blank cells. :account means it came from the response-level `warnings`
+  # array, which covers every service enabled on the token — one call rates all
+  # of them — so it may be about a service nobody asked for. It is still
+  # reported, not filtered: 'Unable to verify address' arrives at response level
+  # and is about this card's own destination address.
+  class Warning < Struct.new(:message, :count, :scope, keyword_init: true)
+    SERVICE = :service
+    ACCOUNT = :account
+
+    # Service-scoped is the safe default: it says 'this is about what you
+    # selected', which is the claim a caller that did not set a scope is making.
+    def scope
+      self[:scope] || SERVICE
+    end
+
+    def account_wide?
+      scope == ACCOUNT
+    end
+  end
+end

data/lib/rate_card.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require_relative 'rate_card/version'
+
+module RateCard
+  # Base for everything this tool raises on purpose.
+  class Error < StandardError; end
+
+  # The production API rejected the token. Retrying will not help.
+  class Unauthorized < Error; end
+
+  # A rate call failed in a way we chose not to retry (or ran out of retries).
+  class RequestFailed < Error; end
+
+  # The probe call came back with no services at all — nothing to build a card from.
+  class NoServices < Error; end
+
+  # The destination directory cannot be written to.
+  class OutputNotWritable < Error; end
+
+  # A carrier was asked for that has no hand-curated zone chart. Raised rather
+  # than defaulted: a zone number only means something against a real carrier's
+  # own chart, so substituting another carrier's addresses would produce a card
+  # that looks right and is mislabeled.
+  class UnsupportedCarrier < Error; end
+end
+
+require_relative 'rate_card/token'
+require_relative 'rate_card/token_prompt'
+require_relative 'rate_card/service'
+require_relative 'rate_card/failure'
+require_relative 'rate_card/constants/carriers'
+require_relative 'rate_card/constants/addresses'
+require_relative 'rate_card/constants/cubic_tiers'
+require_relative 'rate_card/client'
+require_relative 'rate_card/service_catalog'
+require_relative 'rate_card/input'
+require_relative 'rate_card/run_spec'
+require_relative 'rate_card/shipment'
+require_relative 'rate_card/warning'
+require_relative 'rate_card/grid'
+require_relative 'rate_card/csv_writer'
+require_relative 'rate_card/table_renderer'
+require_relative 'rate_card/tui/theme'
+require_relative 'rate_card/tui/messages'
+require_relative 'rate_card/tui/fields/text'
+require_relative 'rate_card/tui/fields/select'
+require_relative 'rate_card/tui/fields/multi_select'
+require_relative 'rate_card/tui/app'
+require_relative 'rate_card/ui'
+require_relative 'rate_card/runner'

metadata

@@ -0,0 +1,189 @@
+--- !ruby/object:Gem::Specification
+name: rate-card
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- eHub
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2026-09-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: csv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.13'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.13'
+- !ruby/object:Gem::Dependency
+  name: parallel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.26'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.26'
+- !ruby/object:Gem::Dependency
+  name: bubbles
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: bubbletea
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: lipgloss
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: ntcharts
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+description: |
+  rate-card walks you through a carrier, its services, zones, a weight range and a
+  package type, fetches every weight x zone cell from the eHub API, prints the rate
+  card to your terminal and saves it as CSV.
+email:
+executables:
+- rate-card
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- exe/rate-card
+- lib/rate_card.rb
+- lib/rate_card/client.rb
+- lib/rate_card/constants/addresses.rb
+- lib/rate_card/constants/carriers.rb
+- lib/rate_card/constants/cubic_tiers.rb
+- lib/rate_card/csv_writer.rb
+- lib/rate_card/failure.rb
+- lib/rate_card/grid.rb
+- lib/rate_card/input.rb
+- lib/rate_card/run_spec.rb
+- lib/rate_card/runner.rb
+- lib/rate_card/service.rb
+- lib/rate_card/service_catalog.rb
+- lib/rate_card/shipment.rb
+- lib/rate_card/table_renderer.rb
+- lib/rate_card/token.rb
+- lib/rate_card/token_prompt.rb
+- lib/rate_card/tui/app.rb
+- lib/rate_card/tui/fields/multi_select.rb
+- lib/rate_card/tui/fields/select.rb
+- lib/rate_card/tui/fields/text.rb
+- lib/rate_card/tui/messages.rb
+- lib/rate_card/tui/theme.rb
+- lib/rate_card/ui.rb
+- lib/rate_card/version.rb
+- lib/rate_card/warning.rb
+homepage: https://github.com/jxsoren/rate-card-cli
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/jxsoren/rate-card-cli
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.11
+signing_key:
+specification_version: 4
+summary: Interactive CLI that builds a shipping rate card from the eHub API.
+test_files: []