ruby_native 0.9.0 → 0.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e1dba22f3ed73cde73344241945e6862510cb3d0f42560f77225b5f9ad9e78d4
-  data.tar.gz: 7cf291e917138449546715e585cc3926842b94dcafcf7c85d3ea439f7b17edd6
+  metadata.gz: 8f882623a2d70e309c284e7a67a9dd4119579024f5c8da2afbb8cefbf5185127
+  data.tar.gz: e05abee9a75d6f830fa0e575517746bfa0e4bc728aeff5d2da75f893de09289e
 SHA512:
-  metadata.gz: 0daccf8ec40c9f0c4514b618fff3bcbaffcda78e8777a6ddc2b5b5aca0bbe7844f3a7ab5e1a5c83c3875c4889b6531cf65bd09b949353636f66d0c3f3d62a8fb
-  data.tar.gz: e8a3d231802d4f4324a664f1e6bcaaba5a69ca9a95ad03d531d24185e1b816df739c8baa363587b300a95a5377c8513aea8a888e56a498aa2af45dec92bcbf8e
+  metadata.gz: a598a22166379ba712b9b0fb9417434cb94786937085055363bac1eb676c06a684addaecd4537e5b45098a9ed0ca810d0569d4c1af12c5adbe170cad1d0de6b2
+  data.tar.gz: 3fd6fe2454af67d3ea515862dc3161b2a2695dbf1534774baa3afa03e72e8ae564cb147a24d6ff7ad53feebaf1d41520025bdd849a2bb5dc139e583874d2ae0e

data/README.md

@@ -79,6 +79,26 @@ The companion app persists the scanned URL across launches. Long-press the app i
 - `GET /native/config` - returns the YAML config as JSON
 - `POST /native/push/devices` - registers a push notification token (requires `current_user` from host app)
 
+## Push notifications
+
+Delivery uses the companion `action_push_native` gem. Ruby Native owns the registration handshake (the `native_push_tag` helper prompts for permission, `/native/push/devices` stores the token) and the tap-handling conventions on the native side.
+
+When sending a push, two destination keys are supported via `with_data`:
+
+- `path` — internal route appended to your base URL and loaded in the in-app WebView (e.g. `/sources/42`).
+- `url` — full external URL opened in `SFSafariViewController`, leaving the WebView in place behind it (e.g. `https://dashboard.stripe.com/payments/pi_abc`).
+
+If both are present, `url` wins. `http` and `https` URLs open in `SFSafariViewController`; other valid schemes (`mailto:`, `tel:`, `maps:`, third-party app schemes, etc.) hand off to the appropriate app via `UIApplication.open`. Malformed `url` strings are dropped (the tap does not fall back to `path`).
+
+```ruby
+ApplicationPushNotification
+  .with_data(path: source_path(source), url: notification.external_url)
+  .new(title: "New payment", body: "$49.99 from joe@example.com")
+  .deliver_later_to(user.push_devices)
+```
+
+For model/migration setup, see [action_push_native](https://github.com/basecamp/action_push_native).
+
 ## Normal and Advanced Modes
 
 Normal Mode works with any frontend framework and requires no JavaScript. You get tabs, form page marking, push notifications, and history management.

data/app/controllers/ruby_native/screenshots/sessions_controller.rb

@@ -27,7 +27,7 @@ module RubyNative
           return
         end
 
-        RubyNative.screenshot_sign_in.call(self)
+        RubyNative.screenshot_sign_in.call(SignInHelper.new(self))
 
         cookies[:_ruby_native_screenshot_session] = {
           value: "1",

data/lib/generators/ruby_native/templates/CLAUDE.md

@@ -129,6 +129,26 @@ The gem auto-mounts at `/native`. No route configuration needed.
 - `GET /native/config` returns the YAML config as JSON
 - `POST /native/push/devices` registers a push notification device token
 
+## Push notifications
+
+Delivery uses the companion `action_push_native` gem. Ruby Native owns the registration (the `native_push_tag` helper prompts for permission, `/native/push/devices` stores the token) and defines the tap conventions on the native side.
+
+Two destination keys are supported via `with_data`:
+
+- `path` — internal route appended to your base URL, loaded in the WebView.
+- `url` — full external URL, opened in `SFSafariViewController`.
+
+If both are present, `url` wins. `http` and `https` open in `SFSafariViewController`; other valid schemes (`mailto:`, `tel:`, `maps:`, third-party app schemes) open via `UIApplication.open`. Malformed `url` does not fall back to `path`.
+
+```ruby
+ApplicationPushNotification
+  .with_data(path: source_path(source), url: notification.external_url)
+  .new(title: "New payment", body: "$49.99 from joe@example.com")
+  .deliver_later_to(user.push_devices)
+```
+
+For model/migration setup, see the [action_push_native](https://github.com/basecamp/action_push_native) README.
+
 ## CLI
 
 ### Deploy from CI

data/lib/ruby_native/cli/deploy.rb

@@ -16,6 +16,7 @@ module RubyNative
 
       def initialize(argv)
         @if_needed = argv.include?("--if-needed")
+        @platform = parse_platform(argv)
       end
 
       def run
@@ -105,7 +106,7 @@ module RubyNative
         req = Net::HTTP::Post.new(uri)
         req["Authorization"] = "Token #{Credentials.token}"
         req["Content-Type"] = "application/json"
-        req.body = JSON.generate(gem_version: RubyNative::VERSION)
+        req.body = JSON.generate(build_payload)
 
         response = make_request(uri, req)
 
@@ -174,7 +175,7 @@ module RubyNative
             puts "  Version: v#{data["version"]} (#{data["number"]})"
             puts "  Ruby Native: #{data["native_version"]}" if data["native_version"]
             puts ""
-            puts "Your build is being submitted to TestFlight."
+            puts success_destination_message(data)
             break
           when "failure", "failed", "cancelled"
             puts ""
@@ -208,15 +209,59 @@ module RubyNative
       end
 
       def print_status(status)
-        labels = {
-          "queued" => "Queued",
-          "building" => "Building",
-          "processing" => "Submitting to App Store Connect"
-        }
-        label = labels[status]
+        label = status_labels[status]
         puts "  #{label}..." if label
       end
 
+      def status_labels
+        if android?
+          {
+            "queued" => "Queued",
+            "building" => "Building Android AAB",
+            "processing" => "Uploading to Play Internal Testing"
+          }
+        else
+          {
+            "queued" => "Queued",
+            "building" => "Building",
+            "processing" => "Submitting to App Store Connect"
+          }
+        end
+      end
+
+      def success_destination_message(data)
+        platform = data["platform"] || requested_platform
+        case platform
+        when "android"
+          "Your build is being uploaded to Play Internal Testing."
+        else
+          "Your build is being submitted to TestFlight."
+        end
+      end
+
+      def parse_platform(argv)
+        return "android" if argv.include?("--android")
+
+        flag = argv.find { |a| a.start_with?("--platform=") }
+        return flag.split("=", 2).last if flag
+
+        "ios"
+      end
+
+      def requested_platform
+        @platform
+      end
+
+      def android?
+        @platform == "android"
+      end
+
+      def build_payload
+        payload = { gem_version: RubyNative::VERSION }
+        payload[:platform] = @platform unless @platform == "ios"
+        payload
+      end
+
       # --- App linking ---
 
       def link_app

data/lib/ruby_native/cli.rb

@@ -26,7 +26,7 @@ module RubyNative
         puts "Usage: ruby_native <command>"
         puts ""
         puts "Commands:"
-        puts "  deploy        Trigger an iOS build"
+        puts "  deploy        Trigger an iOS build (use --android for Android)"
         puts "  login         Authenticate with Ruby Native"
         puts "  logout        Remove stored credentials"
         puts "  preview       Start a tunnel and display a QR code"

data/lib/ruby_native/helper.rb

@@ -53,8 +53,10 @@ module RubyNative
       tag.div(data: { native_navbar: title.to_s }, hidden: true) { builder.to_html }
     end
 
-    def native_fab_tag(icon:, href: nil, click: nil)
-      data = { native_fab: true, native_icon: icon }
+    def native_fab_tag(icon: nil, icons: nil, href: nil, click: nil)
+      resolved = RubyNative::Helper.resolve_icon(icon: icon, icons: icons, platform: try(:native_platform))
+      raise ArgumentError, "native_fab_tag requires an icon" if resolved.nil?
+      data = { native_fab: true, native_icon: resolved }
       data[:native_href] = href if href
       data[:native_click] = click if click
       tag.div(data: data, hidden: true)
@@ -71,16 +73,31 @@ module RubyNative
       data
     end
 
+    # Picks the right icon name for the current native platform. Accepts the
+    # single `icon:` form (applied to every platform) and/or the `icons:` hash
+    # form (`{ ios: "...", android: "..." }`). When both are given, a matching
+    # `icons[platform]` wins; otherwise falls back to `icon`. Returns nil when
+    # nothing resolves.
+    def self.resolve_icon(icon: nil, icons: nil, platform: nil)
+      if icons.is_a?(Hash) && platform
+        key = platform.to_sym
+        per_platform = icons[key] || icons[key.to_s]
+        return per_platform if per_platform
+      end
+      icon
+    end
+
     class NavbarBuilder
       def initialize(context)
         @context = context
         @items = []
       end
 
-      def button(title = nil, icon: nil, href: nil, click: nil, position: :trailing, selected: false, &block)
+      def button(title = nil, icon: nil, icons: nil, href: nil, click: nil, position: :trailing, selected: false, &block)
+        resolved = RubyNative::Helper.resolve_icon(icon: icon, icons: icons, platform: @context.try(:native_platform))
         data = { native_button: "" }
         data[:native_title] = title if title
-        data[:native_icon] = icon if icon
+        data[:native_icon] = resolved if resolved
         data[:native_href] = href if href
         data[:native_click] = click if click
         data[:native_position] = position.to_s
@@ -114,11 +131,12 @@ module RubyNative
         @items = []
       end
 
-      def item(title, href: nil, click: nil, icon: nil, selected: false)
+      def item(title, href: nil, click: nil, icon: nil, icons: nil, selected: false)
+        resolved = RubyNative::Helper.resolve_icon(icon: icon, icons: icons, platform: @context.try(:native_platform))
         data = { native_menu_item: "", native_title: title }
         data[:native_href] = href if href
         data[:native_click] = click if click
-        data[:native_icon] = icon if icon
+        data[:native_icon] = resolved if resolved
         data[:native_selected] = "" if selected
         @items << @context.tag.div(data: data)
       end

data/lib/ruby_native/native_detection.rb

@@ -3,7 +3,7 @@ module RubyNative
     extend ActiveSupport::Concern
 
     included do
-      helper_method :native_app?, :native_version if respond_to?(:helper_method)
+      helper_method :native_app?, :native_version, :native_platform if respond_to?(:helper_method)
     end
 
     def native_app?
@@ -14,5 +14,14 @@ module RubyNative
       match = request.user_agent.to_s.match(/RubyNative\/([\d.]+)/)
       NativeVersion.new(match ? match[1] : "0")
     end
+
+    # Returns "ios" or "android" for native requests, nil for web browsers.
+    # Used by view helpers to pick the right icon from `icons: { ios:, android: }`.
+    def native_platform
+      ua = request.user_agent.to_s
+      return "ios" if ua.include?("Ruby Native iOS")
+      return "android" if ua.include?("Ruby Native Android")
+      nil
+    end
   end
 end

data/lib/ruby_native/screenshots/sign_in_helper.rb

@@ -0,0 +1,26 @@
+module RubyNative
+  module Screenshots
+    # Yielded to the customer's `screenshot_sign_in` lambda. Exposes the
+    # request, session, and cookies as public accessors so the lambda never
+    # touches `ActionController` internals directly. `cookies` in particular
+    # is private on `ActionController::Base` in Rails 8.1+, so customers
+    # would otherwise have to fall back to `controller.send(:cookies)`.
+    class SignInHelper
+      def initialize(controller)
+        @controller = controller
+      end
+
+      def cookies
+        @controller.send(:cookies)
+      end
+
+      def request
+        @controller.request
+      end
+
+      def session
+        @controller.session
+      end
+    end
+  end
+end

data/lib/ruby_native/version.rb

@@ -1,3 +1,3 @@
 module RubyNative
-  VERSION = "0.9.0"
+  VERSION = "0.9.1"
 end

data/lib/ruby_native.rb

@@ -10,6 +10,7 @@ require "ruby_native/iap/verifiable"
 require "ruby_native/iap/decodable"
 require "ruby_native/iap/normalizable"
 require "ruby_native/iap/apple_webhook_processor"
+require "ruby_native/screenshots/sign_in_helper"
 require "ruby_native/engine"
 
 module RubyNative

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_native
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.9.1
 platform: ruby
 authors:
 - Joe Masilotti
@@ -101,6 +101,7 @@ files:
 - lib/ruby_native/native_detection.rb
 - lib/ruby_native/native_version.rb
 - lib/ruby_native/oauth_middleware.rb
+- lib/ruby_native/screenshots/sign_in_helper.rb
 - lib/ruby_native/tunnel_cookie_middleware.rb
 - lib/ruby_native/version.rb
 homepage: https://github.com/ruby-native/gem