phone_preview 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dc78569a84670e434020eb9ce555cd7e21c00228025ceb52e18d9420adc8f8c2
-  data.tar.gz: e8e46b0e1f29452f1e90a012f4089cfeb190f7ae64fd5d11af0d1ac4dc6220cb
+  metadata.gz: 2dbc9e0b2f71df5089e74928aae948c2dee2586f548a7f1e264999a13f2ced8c
+  data.tar.gz: ca7b5f90b0083f533290e4662f8d0a409eefaf7731e00e3752adac06f18f5c47
 SHA512:
-  metadata.gz: 2768cd8b0e3058463d1839358c3d0693ac95cbe87aba06126de22176f0c67ea2c0e62dc971e332ba38ca8995b6270d2c6e668c3207a502010d81a3e50e484ca3
-  data.tar.gz: 97b463e508fc83fa547a938a5a3336ee2c416f1d0e9974213446cc3ec355bc2d6ea866cb890f852fe920f06270c9d6368d542c4afa851728829de2fb43a332d8
+  metadata.gz: d64daa6df8cb0a84f3fad478184328478d5284805ccf5bc345a05bdb0bcfb4e0f4717874b87e014e79dc0b74b6960ed219cdeca6112dda2ecb2c5df3bca036de
+  data.tar.gz: 8ffd3f6a9a6c9e705a8db739a280b0438ca81105580ac44fc21fa8f7539b7aeb325ad868096e3b59cb3652a8a6842c7c1d7709ba3a9e50252813b4dccb5cc235

data/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-10-22
+
+### Added
+
+- `phone_preview` says ngrok is not installed, or not signed in to an account, and starts nothing.
+- `phone_preview` names a port already in use, or an address already held by another running tunnel, and starts nothing.
+- When the tunnel stops while the app runs, the terminal says the phone can no longer reach the app.
+
+## [0.1.0] - 2026-10-22
+
 ### Added
 
 - `phone_preview` starts the app's server and an ngrok tunnel on one port, and prints the public address and a QR code of it.

data/README.md

@@ -41,6 +41,12 @@ Open the printed address on the phone, or scan the QR code.
 
 With no `PORT` set, the server starts on port 3000.
 
+Before starting anything, `phone_preview` stops with a message when ngrok is not
+installed, when ngrok is not signed in to an account, when the port is already
+in use, or when another running tunnel already holds the public address. If the
+tunnel stops while the app runs, the terminal says the phone can no longer
+reach the app.
+
 When `PUBLIC_BASE_URL` is set in development, emailed links use it over https
 with no port. With it unset, or outside development, emailed links keep the
 app's own `action_mailer.default_url_options`.

data/exe/phone_preview

@@ -1,9 +1,54 @@
 #!/usr/bin/env ruby
 require "rqrcode"
+require "yaml"
+require "socket"
+require "net/http"
+
+def stop(message)
+  warn "phone_preview: #{message}"
+  exit 1
+end
+
+def installed?(command)
+  ENV.fetch("PATH", "").split(File::PATH_SEPARATOR).any? { |dir| File.executable?(File.join(dir, command)) }
+end
+
+stop "ngrok is not installed. Install it with `brew install ngrok`." unless installed?("ngrok")
+
+def signed_in?
+  return true if ENV["NGROK_AUTHTOKEN"].to_s != ""
+
+  config = IO.popen(%w[ngrok config check], err: File::NULL, &:read)[/Valid configuration file at (.+)$/, 1]
+  config && File.exist?(config) && YAML.safe_load_file(config).to_h.then { |settings| settings.dig("agent", "authtoken") || settings["authtoken"] }.to_s != ""
+end
+
+stop "ngrok is not signed in to an account. Sign in with `ngrok config add-authtoken <token>`." unless signed_in?
 
 address = ENV.fetch("PUBLIC_BASE_URL")
 ENV["PORT"] ||= "3000"
 
+def port_in_use?(port)
+  %w[127.0.0.1 ::1].any? do |host|
+    TCPServer.new(host, port.to_i).close
+    false
+  rescue Errno::EADDRINUSE
+    true
+  rescue SystemCallError, SocketError
+    false
+  end
+end
+
+stop "port #{ENV["PORT"]} is already in use. Stop what is using it, or start with another PORT." if port_in_use?(ENV["PORT"])
+
+def held_by_another_tunnel?(address)
+  response = Net::HTTP.get_response(URI(address))
+  !response.body.to_s.include?("ERR_NGROK_3200")
+rescue SystemCallError, SocketError, IOError, Timeout::Error
+  false
+end
+
+stop "#{address} is already held by another running tunnel. Stop that tunnel first." if held_by_another_tunnel?(address)
+
 puts RQRCode::QRCode.new(address).as_ansi
 puts "Open #{address} on your phone"
 

data/lib/phone_preview/Procfile

@@ -1,2 +1,2 @@
 web: bin/rails server -p $PORT
-tunnel: ngrok http --url=$PUBLIC_BASE_URL $PORT --log=stdout
+tunnel: ngrok http --url=$PUBLIC_BASE_URL $PORT --log=stdout; echo "The tunnel stopped, so the phone can no longer reach the app."

data/lib/phone_preview/version.rb

@@ -1,3 +1,3 @@
 module PhonePreview
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: phone_preview
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Tyler Schneider