passkit 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a0b38c2c63123caf5195b6ac2e319088a7b09b85b407c773fa6301d12afe2e93
-  data.tar.gz: bae23beda0bc05e54cad0509697a94e1afa3422bee4f962d3fe51e25e39dbda0
+  metadata.gz: 759d9f1d6698e06c21d68d76e55edfa52f4e6e687148b2e553709471158597db
+  data.tar.gz: 90453db3b78892ab6ec2df6466288242a23b782b7524734c92bf08f057fbc032
 SHA512:
-  metadata.gz: 21618ddd7bf862cff4ce94fece9d5881d9981a5c162ea4ce86a05047542c4f99bc492683e28f9c101e426a3357810eb4872a63d861716e3a2fbaf86feb3db527
-  data.tar.gz: af5a69f49077ebca8e4645ce24e564db926b1c7052a84ea98f09649f28dd7d9bf49a96df511aadc0b34a4c4134bc3bc783615742341369e7645c7b7eacd86b2a
+  metadata.gz: f3fa0b1df59c67f5ea94426c9c18bfcfd89aa90ed02a1499fc0e429ad666160a231b6a6b413c8a4399bcc5a8e0285d72d34d4a41e8aca433ca1ff8eb02e5963b
+  data.tar.gz: 17f3a2d0abd18a192f52757a1c256ea9d8645dbdba16bdc7aa921e9575194a1ce3c188f2ee698888697a374e9c672bf73c0305c242689897810cd7332aaf51ad

data/.example.env

@@ -1,5 +1,5 @@
 PASSKIT_WEB_SERVICE_HOST=https://localhost:3000
-PASSKIT_CERTIFICATE_KEY=path/to/certificate.key
+PASSKIT_CERTIFICATE_KEY=theCertPassword
 PASSKIT_PRIVATE_P12_CERTIFICATE=path/to/certificate.p12
 PASSKIT_APPLE_INTERMEDIATE_CERTIFICATE=path/to/AppleWWDRCA.cer
 PASSKIT_APPLE_TEAM_IDENTIFIER=XXXXXXXXXX

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## [0.8.0]
+- [#36](https://github.com/coorasse/passkit/pull/36): More flexible configuration parameters.
+- [#44](https://github.com/coorasse/passkit/pull/44): Add `stripColor` option.
+
 ## [0.7.0]
 - [#25](https://github.com/coorasse/passkit/pull/25): Change the label default color to black.
 

data/README.md

@@ -58,6 +58,7 @@ If you followed the installation steps, you already saw that Passkit provides
 you the tables and ActiveRecord models, and also an engine with the necessary APIs already implemented.
 
 Now is your turn. Before proceeding, you need to set these ENV variables:
+
 * `PASSKIT_WEB_SERVICE_HOST`
 * `PASSKIT_CERTIFICATE_KEY`
 * `PASSKIT_PRIVATE_P12_CERTIFICATE`
@@ -68,6 +69,26 @@ Now is your turn. Before proceeding, you need to set these ENV variables:
 We have a [specific guide on how to get all these](docs/passkit_environment_variables.md), please follow it.
 You cannot start using this library without these variables set, and we cannot do the work for you.
 
+Alternatively, you can configure passkit with an initializer, where you can use environment variables, Rails secrets,
+or any other source for the required credentials:
+
+```ruby
+Passkit.configure do |config|
+  # Required, no defaults
+  config.apple_team_identifier = "dummy ID"
+  config.certificate_key = "dummy key"
+  config.private_p12_certificate = "path/to/file"
+  config.apple_intermediate_certificate = "path/to/file"
+  config.pass_type_identifier = "pass.com.some.id"
+
+  # Optional, defaults shown
+  config.dashboard_username = nil
+  config.dashboard_password = nil
+  config.skip_verification = false # Unless true, throws exceptions on startup when a required configuration is missing
+  config.web_service_host = "https://localhost:3000"
+  config.available_passes = { "Passkit::ExampleStoreCard" => -> {} }
+end
+
 ## Usage
 
 If you followed the installation steps and you have the ENV variables set, we can start looking at what is provided for you.
@@ -128,22 +149,34 @@ You can define colors, fields and texts. You can also define the logo and the ba
 You should place the images in a 'private/passkit/<your_downcased_passname>' folder.
 There is a [dummy app in the gem](test/dummy) that you can use to check how to create your own Wallet Passes.
 
+Full documentation for image specifications is on Apple's
+[Pass Design and Creation](https://developer.apple.com/library/archive/documentation/UserExperience/Conceptual/PassKit_PG/Creating.html)
+page. Naming the file according to convetion and putting it in 'private/passkit/<your_downcased_passname>' is all that's needed for it
+to be included in the pass.
+
 ### Serve your Wallet Pass
 
-Use the [Passkit::UrlGenerator](lib/passkit/url_generator.rb) to generate the URL to serve your Wallet Pass. 
-You can initialize it with:
+Use the [Passkit::UrlGenerator](lib/passkit/url_generator.rb) to generate the URL to serve your Wallet Pass.
+For one pass, you can initialize it with:
 
 ```ruby
 Passkit::UrlGenerator.new(Passkit::MyPass, User.find(1))
 ```
 
+For one passes, you can initialize it with:
+
+```ruby
+Passkit::UrlGenerator.new(Passkit::UserTicket, User.find(1), :tickets)
+```
+(this presumes you have `User.find(1).tickets` would return the ticket records)
+
 and then use `.android` or `.ios` to get the URL to serve the Wallet Pass.
 Again, check the example mailer included in the gem to see how to use it.
 
 ## Debug issues 
 
-* On Mac, open the `Console.app` to view the errors.
-* Check the logs on http://localhost:3000/passkit/logs
+* On Mac, you can open the *.pkpass files with "Pass Viewer". Open the `Console.app` to log possible error messages and filter by "Pass Viewer" process.
+* Check the logs on http://localhost:3000/passkit/dashboard/logs
 * In case of error "The passTypeIdentifier or teamIdentifier provided may not match your certificate, 
 or the certificate trust chain could not be verified." the certificate (p12) might be expired.
 

data/app/controllers/passkit/api/v1/passes_controller.rb

@@ -5,7 +5,18 @@ module Passkit
         before_action :decrypt_payload, only: :create
 
         def create
-          send_file(fetch_pass(@payload), type: "application/vnd.apple.pkpass", disposition: "attachment")
+          set_generator
+
+          if @generator && @payload[:collection_name].present?
+            files = @generator.public_send(@payload[:collection_name]).collect do |collection_item|
+              Passkit::Factory.create_pass(@payload[:pass_class], collection_item)
+            end
+            file = Passkit::Generator.compress_passes_files(files)
+            send_file(file, type: 'application/vnd.apple.pkpasses', disposition: 'attachment')
+          else
+            file = Passkit::Factory.create_pass(@payload[:pass_class], @generator)
+            send_file(file, type: 'application/vnd.apple.pkpass', disposition: 'attachment')
+          end
         end
 
         # @return If request is authorized, returns HTTP status 200 with a payload of the pass data.
@@ -44,13 +55,13 @@ module Passkit
           end
         end
 
-        def fetch_pass(payload)
-          generator = nil
-          if payload[:generator_class].present? && payload[:generator_id].present?
-            generator_class = payload[:generator_class].constantize
-            generator = generator_class.find(payload[:generator_id])
-          end
-          Passkit::Factory.create_pass(payload[:pass_class], generator)
+        def set_generator
+          @generator = nil
+
+          return unless @payload[:generator_class].present? && @payload[:generator_id].present?
+
+          generator_class = @payload[:generator_class].constantize
+          @generator = generator_class.find(@payload[:generator_id])
         end
       end
     end

data/app/models/passkit/pass.rb

@@ -17,14 +17,11 @@ module Passkit
       :barcodes,
       :beacons,
       :boarding_pass,
-      :coupon,
       :description,
-      :event_ticket,
       :expiration_date,
       :file_name,
       :foreground_color,
       :format_version,
-      :generic,
       :grouping_identifier,
       :header_fields,
       :label_color,
@@ -42,7 +39,7 @@ module Passkit
       :secondary_fields,
       :semantics,
       :sharing_prohibited,
-      :store_card,
+      :strip_color
       :suppress_strip_shine,
       :user_info,
       :voided,

data/app/views/passkit/dashboard/passes/index.html.erb

@@ -2,31 +2,30 @@
   <h1>Passkit Passes</h1>
   <%= render 'shared/passkit/navigation' %>
 </header>
-
 <main>
   <h2>Last 100 passes and registered devices</h2>
   <table>
     <thead>
-    <th>Created at</th>
-    <th>Generator</th>
-    <th>Pass Class</th>
-    <th>Devices</th>
+      <th>Created at</th>
+      <th>Generator</th>
+      <th>Pass Class</th>
+      <th>Devices</th>
     </thead>
     <tbody>
-    <% @passes.each do |pass| %>
-      <tr>
-        <td><%= I18n.l(pass.created_at) %></td>
-        <td><%= pass.generator.to_s %></td>
-        <td><%= pass.klass %></td>
-        <td>
-          <% pass.devices.each do |device| %>
-            <div>
+      <% @passes.each do |pass| %>
+        <tr>
+          <td><%= I18n.l(pass.created_at) %></td>
+          <td><%= pass.generator.class.name %> - <%= pass.generator.id %></td>
+          <td><%= pass.klass %></td>
+          <td>
+            <% pass.devices.each do |device| %>
+              <div>
                 <%= device.push_token %>
-            </div>
-          <% end %>
-        </td>
-      </tr>
-    <% end %>
+              </div>
+            <% end %>
+          </td>
+        </tr>
+      <% end %>
     </tbody>
   </table>
 </main>

data/app/views/passkit/example_mailer/example_email.html.erb

@@ -2,14 +2,14 @@
   Here is an example of an email message that contains a link to Download a Wallet Pass.
 </p>
 <p>
-  <a href="<%=@passkit_url_generator.ios %>">
-    <%=image_tag 'passkit/add_to_apple_wallet_en.png', style: 'width: 150px;' %>
-    Download a iOS Wallet Pass
+  <a href="<%= @passkit_url_generator.ios %>">
+    <%= image_tag 'passkit/add_to_apple_wallet_en.png', style: 'width: 150px;' %>
+    Download an iOS Wallet Pass
   </a>
 </p>
 <p>
   <a href="<%=@passkit_url_generator.android %>">
-    <%=image_tag 'https://walletpasses.io/badges/badge_web_black_en@3x.png', style: 'width: 150px;' %>
+    <%= image_tag 'passkit/add_to_walletpass_en.png', style: 'width: 150px;' %>
     Download an Android Wallet Pass
   </a>
 </p>

data/docs/passkit_environment_variables.md

@@ -12,7 +12,7 @@ In production, it will simply be your domain name, but in development you can us
 
 This is the easy one.
 Head to https://www.apple.com/certificateauthority/ and download the latest Apple Intermediate Certificate Worldwide Developer Relations.
-You might want to choose the one with the longest expiration date.
+You might want to choose the one with the longest expiration date. PASSKIT_APPLE_INTERMEDIATE_CERTIFICATE is the path to the certificate.
 
 ### `PASSKIT_APPLE_TEAM_IDENTIFIER`
 
@@ -32,7 +32,10 @@ Head to your Apple Developers console and generate a new certificate.
 
 The identifier is the `PASSKIT_PASS_TYPE_IDENTIFIER` variable.
 
-Now, create a certificate signing request: https://help.apple.com/developer-account/#/devbfa00fef7
+**Note**: When renewing your certificate, make sure that this identifier stays the same as before. Changing this identifier will
+require existing passes to be regenerated, as they will otherwise no longer be updateable via the web service URL.
+
+Now, create a certificate signing request: https://developer.apple.com/help/account/create-certificates/create-a-certificate-signing-request/
 
 And create the certificate:
 

data/lib/passkit/base_pass.rb

@@ -5,15 +5,15 @@ module Passkit
     end
 
     def format_version
-      ENV["PASSKIT_FORMAT_VERSION"] || 1
+      Passkit.configuration.format_version
     end
 
     def apple_team_identifier
-      ENV["PASSKIT_APPLE_TEAM_IDENTIFIER"] || raise(Error.new("Missing environment variable: PASSKIT_APPLE_TEAM_IDENTIFIER"))
+      Passkit.configuration.apple_team_identifier
     end
 
     def pass_type_identifier
-      ENV["PASSKIT_PASS_TYPE_IDENTIFIER"] || raise(Error.new("Missing environment variable: PASSKIT_PASS_TYPE_IDENTIFIER"))
+      Passkit.configuration.pass_type_identifier
     end
 
     def language
@@ -43,34 +43,48 @@ module Passkit
     end
 
     def web_service_url
-      raise Error.new("Missing environment variable: PASSKIT_WEB_SERVICE_HOST") unless ENV["PASSKIT_WEB_SERVICE_HOST"]
-      "#{ENV["PASSKIT_WEB_SERVICE_HOST"]}/passkit/api"
+      "#{Passkit.configuration.web_service_host}/passkit/api"
     end
 
+    # The foreground color, used for the values of fields shown on the front of the pass.
     def foreground_color
       # black
       "rgb(0, 0, 0)"
     end
 
+    # The strip color, used to print the text over the background image.
+    def strip_color
+      "rgb(0, 0, 0)"
+    end
+
+    # The background color, used for the background of the front and back of the pass.
+    # If you provide a background image, any background color is ignored.
     def background_color
       # white
       "rgb(255, 255, 255)"
     end
 
+    # The label color, used for the labels of fields shown on the front of the pass.
     def label_color
       # black
       "rgb(0, 0, 0)"
     end
 
+    # The organization name is displayed on the lock screen when your pass is relevant and by apps such as Mail which
+    # act as a conduit for passes. The value for the organizationName key in the pass specifies the organization name.
+    # Choose a name that users recognize and associate with your organization or company.
     def organization_name
       "Passkit"
     end
 
+    # The description lets VoiceOver make your pass accessible to blind and low-vision users. The value for the
+    # description key in the pass specifies the description.
+    # @see https://developer.apple.com/library/archive/documentation/UserExperience/Conceptual/PassKit_PG/Creating.html
     def description
       "A basic description for a pass"
     end
 
-    # A pass can have up to ten relevant locations
+    # An array of up to 10 latitudes and longitudes. iOS uses these locations to determine when to display the pass on the lock screen
     #
     # @see https://developer.apple.com/library/archive/documentation/UserExperience/Conceptual/PassKit_PG/Creating.html
     def locations
@@ -85,7 +99,8 @@ module Passkit
     def add_other_files(path)
     end
 
-    # Distance in meters from locations; if blank uses pass default
+    # Distance in meters from locations; if blank uses pass default.
+    # The system uses the smaller of either this distance or the default distance.
     def max_distance
     end
 
@@ -118,30 +133,19 @@ module Passkit
 
     # Information specific to a boarding pass
     # Returns a hash representing Pass.BoardingPass
+    # https://developer.apple.com/documentation/walletpasses/pass/boardingpass
+    # i.e {transitType: 'PKTransitTypeGeneric'}
     def boarding_pass
-    end
-
-    # Information specific to a coupon
-    # Returns a hash representing Pass.Coupon
-    def coupon
-    end
-
-    # Information specific to an event ticket
-    # Returns a hash representing Pass.EventTicket
-    def event_ticket
+      {}
     end
 
     # Date and time the pass expires, must include
     # days, hours and minutes (seconds are optional)
-    # Returns a String representing the date and time in W3C format
+    # Returns a String representing the date and time in W3C format ('%Y-%m-%dT%H:%M:%S%:z')
+    # For example, 1980-05-07T10:30-05:00.
     def expiration_date
     end
 
-    # Information specific to a generic pass
-    # Returns a hash representing Pass.Generic
-    def generic
-    end
-
     # A key to identify group multiple passes together
     # (e.g. a number of boarding passes for the same trip)
     # Returns a String
@@ -157,7 +161,7 @@ module Passkit
     # Date and time when the pass becomes relevant and should be
     # displayed, must include days, hours and minutes
     # (seconds are optional)
-    # Returns a String representing the date and time in W3C format
+    # Returns a String representing the date and time in W3C format ('%Y-%m-%dT%H:%M:%S%:z')
     def relevant_date
     end
 
@@ -167,11 +171,6 @@ module Passkit
     def semantics
     end
 
-    # Information specific to a store card
-    # Returns a hash representing Pass.StoreCard
-    def store_card
-    end
-
     # Display the strip image without a shine effect
     # Returns a boolean
     def suppress_strip_shine

data/lib/passkit/example_store_card.rb

@@ -58,17 +58,13 @@ module Passkit
       "Loyalty Card"
     end
 
-    def app_launch_url
-      "https://github.com/coorasse/passkit"
-    end
-
     def relevant_date
-      Time.current.strftime("%Y-%m-%dT%H:%M:%S%z")
+      Time.current.strftime('%Y-%m-%dT%H:%M:%S%:z')
     end
 
     def expiration_date
       # Expire the pass tomorrow
-      (Time.current + 60*60*24).strftime("%Y-%m-%dT%H:%M:%S%z")
+      (Time.current + 1.day).strftime('%Y-%m-%dT%H:%M:%S%:z')
     end
 
     def semantics

data/lib/passkit/factory.rb

@@ -1,6 +1,7 @@
 module Passkit
   class Factory
     class << self
+      # generator is an optional ActiveRecord object, the application data for the pass
       def create_pass(pass_class, generator = nil)
         pass = Passkit::Pass.create!(klass: pass_class, generator: generator)
         Passkit::Generator.new(pass).generate_and_sign

data/lib/passkit/generator.rb

@@ -23,6 +23,19 @@ module Passkit
       compress_pass_file
     end
 
+    def self.compress_passes_files(files)
+      zip_path = TMP_FOLDER.join("#{SecureRandom.uuid}.pkpasses")
+      zipped_file = File.open(zip_path, "w")
+
+      Zip::OutputStream.open(zipped_file.path) do |z|
+        files.each do |file|
+          z.put_next_entry(File.basename(file))
+          z.print File.read(file)
+        end
+      end
+      zip_path
+    end
+
   private
 
     def check_necessary_files
@@ -59,6 +72,7 @@ module Passkit
         passTypeIdentifier: @pass.pass_type_identifier,
         serialNumber: @pass.serial_number,
         sharingProhibited: @pass.sharing_prohibited,
+        stripColor: @pass.strip_color,
         suppressStripShine: @pass.suppress_strip_shine,
         voided: @pass.voided,
         webServiceURL: @pass.web_service_url
@@ -75,20 +89,14 @@ module Passkit
       else
         pass[:barcodes] = @pass.barcodes
       end
-
       pass[:appLaunchURL] = @pass.app_launch_url if @pass.app_launch_url
       pass[:associatedStoreIdentifiers] = @pass.associated_store_identifiers unless @pass.associated_store_identifiers.empty?
       pass[:beacons] = @pass.beacons unless @pass.beacons.empty?
-      pass[:boardingPass] = @pass.boarding_pass if @pass.boarding_pass
-      pass[:coupon] = @pass.coupon if @pass.coupon
-      pass[:eventTicket] = @pass.event_ticket if @pass.event_ticket
       pass[:expirationDate] = @pass.expiration_date if @pass.expiration_date
-      pass[:generic] = @pass.generic if @pass.generic
       pass[:groupingIdentifier] = @pass.grouping_identifier if @pass.grouping_identifier
       pass[:nfc] = @pass.nfc if @pass.nfc
       pass[:relevantDate] = @pass.relevant_date if @pass.relevant_date
       pass[:semantics] = @pass.semantics if @pass.semantics
-      pass[:store_card] = @pass.store_card if @pass.store_card
       pass[:userInfo] = @pass.user_info if @pass.user_info
 
       pass[@pass.pass_type] = {
@@ -99,11 +107,11 @@ module Passkit
         backFields: @pass.back_fields
       }
 
+      pass[:boardingPass].merge(@pass.boarding_pass) if @pass.pass_type == :boardingPass && @pass.boarding_pass
+
       File.write(@temporary_path.join("pass.json"), pass.to_json)
     end
 
-    # rubocop:enable Metrics/AbcSize
-
     def generate_json_manifest
       manifest = {}
       Dir.glob(@temporary_path.join("**")).each do |file|
@@ -114,14 +122,18 @@ module Passkit
       File.write(@manifest_url, manifest.to_json)
     end
 
-    CERTIFICATE = Rails.root.join(ENV["PASSKIT_PRIVATE_P12_CERTIFICATE"])
-    INTERMEDIATE_CERTIFICATE = Rails.root.join(ENV["PASSKIT_APPLE_INTERMEDIATE_CERTIFICATE"])
-    CERTIFICATE_PASSWORD = ENV["PASSKIT_CERTIFICATE_KEY"]
+    def certificate_path
+      Rails.root.join(Passkit.configuration.private_p12_certificate)
+    end
+
+    def intermediate_certificate_path
+      Rails.root.join(Passkit.configuration.apple_intermediate_certificate)
+    end
 
     # :nocov:
     def sign_manifest
-      p12_certificate = OpenSSL::PKCS12.new(File.read(CERTIFICATE), CERTIFICATE_PASSWORD)
-      intermediate_certificate = OpenSSL::X509::Certificate.new(File.read(INTERMEDIATE_CERTIFICATE))
+      p12_certificate = OpenSSL::PKCS12.new(File.read(certificate_path), Passkit.configuration.certificate_key)
+      intermediate_certificate = OpenSSL::X509::Certificate.new(File.read(intermediate_certificate_path))
 
       flag = OpenSSL::PKCS7::DETACHED | OpenSSL::PKCS7::BINARY
       signed = OpenSSL::PKCS7.sign(p12_certificate.certificate,

data/lib/passkit/payload_generator.rb

@@ -2,17 +2,18 @@ module Passkit
   class PayloadGenerator
     VALIDITY = 30.days
 
-    def self.encrypted(pass_class, generator = nil)
-      UrlEncrypt.encrypt(hash(pass_class, generator))
+    def self.encrypted(pass_class, generator = nil, collection_name = nil)
+      UrlEncrypt.encrypt(hash(pass_class, generator, collection_name))
     end
 
-    def self.hash(pass_class, generator = nil)
+    def self.hash(pass_class, generator = nil, collection_name = nil)
       valid_until = VALIDITY.from_now
 
       {valid_until: valid_until,
        generator_class: generator&.class&.name,
        generator_id: generator&.id,
-       pass_class: pass_class.name}
+       pass_class: pass_class.name,
+       collection_name: collection_name}
     end
   end
 end

data/lib/passkit/url_generator.rb

@@ -2,9 +2,9 @@ module Passkit
   class UrlGenerator
     include Passkit::Engine.routes.url_helpers
 
-    def initialize(pass_class, generator = nil)
-      @url = passes_api_url(host: ENV["PASSKIT_WEB_SERVICE_HOST"],
-        payload: PayloadGenerator.encrypted(pass_class, generator))
+    def initialize(pass_class, generator = nil, collection_name = nil)
+      @url = passes_api_url(host: Passkit.configuration.web_service_host,
+        payload: PayloadGenerator.encrypted(pass_class, generator, collection_name))
     end
 
     def ios

data/lib/passkit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Passkit
-  VERSION = "0.7.0"
+  VERSION = "0.8.0"
 end

data/lib/passkit.rb

@@ -18,6 +18,11 @@ module Passkit
   def self.configure
     self.configuration ||= Configuration.new
     yield(configuration) if block_given?
+    configuration.verify!
+  end
+
+  def self.configured?
+    self.configuration&.configured?
   end
 
   class Configuration
@@ -27,11 +32,24 @@ module Passkit
       :private_p12_certificate,
       :apple_intermediate_certificate,
       :apple_team_identifier,
-      :pass_type_identifier
+      :pass_type_identifier,
+      :dashboard_username,
+      :dashboard_password,
+      :format_version,
+      :skip_verification
+
+    REQUIRED_ATTRIBUTES = %i[
+      web_service_host
+      certificate_key
+      private_p12_certificate
+      apple_intermediate_certificate
+      apple_team_identifier
+      pass_type_identifier
+    ]
 
     DEFAULT_AUTHENTICATION = proc do
       authenticate_or_request_with_http_basic("Passkit Dashboard. Login required") do |username, password|
-        username == ENV["PASSKIT_DASHBOARD_USERNAME"] && password == ENV["PASSKIT_DASHBOARD_PASSWORD"]
+        username == Passkit.configuration.dashboard_username && password == Passkit.configuration.dashboard_password
       end
     end
     def authenticate_dashboard_with(&block)
@@ -40,14 +58,34 @@ module Passkit
     end
 
     def initialize
-      @available_passes = {"Passkit::ExampleStoreCard" => -> {}}
-      @web_service_host = ENV["PASSKIT_WEB_SERVICE_HOST"] || (raise "Please set PASSKIT_WEB_SERVICE_HOST")
-      raise("PASSKIT_WEB_SERVICE_HOST must start with https://") unless @web_service_host.start_with?("https://")
-      @certificate_key = ENV["PASSKIT_CERTIFICATE_KEY"] || (raise "Please set PASSKIT_CERTIFICATE_KEY")
-      @private_p12_certificate = ENV["PASSKIT_PRIVATE_P12_CERTIFICATE"] || (raise "Please set PASSKIT_PRIVATE_P12_CERTIFICATE")
-      @apple_intermediate_certificate = ENV["PASSKIT_APPLE_INTERMEDIATE_CERTIFICATE"] || (raise "Please set PASSKIT_APPLE_INTERMEDIATE_CERTIFICATE")
-      @apple_team_identifier = ENV["PASSKIT_APPLE_TEAM_IDENTIFIER"] || (raise "Please set PASSKIT_APPLE_TEAM_IDENTIFIER")
-      @pass_type_identifier = ENV["PASSKIT_PASS_TYPE_IDENTIFIER"] || (raise "Please set PASSKIT_PASS_TYPE_IDENTIFIER")
+      # Required
+      @certificate_key = ENV["PASSKIT_CERTIFICATE_KEY"]
+      @private_p12_certificate = ENV["PASSKIT_PRIVATE_P12_CERTIFICATE"]
+      @apple_intermediate_certificate = ENV["PASSKIT_APPLE_INTERMEDIATE_CERTIFICATE"]
+      @apple_team_identifier = ENV["PASSKIT_APPLE_TEAM_IDENTIFIER"]
+      @pass_type_identifier = ENV["PASSKIT_PASS_TYPE_IDENTIFIER"]
+
+      # Optional
+      @skip_verification = false
+      @web_service_host = ENV["PASSKIT_WEB_SERVICE_HOST"] || "https://localhost:3000"
+      @available_passes = { "Passkit::ExampleStoreCard" => -> {} }
+      @format_version = ENV["PASSKIT_FORMAT_VERSION"] || 1
+      @dashboard_username = ENV["PASSKIT_DASHBOARD_USERNAME"]
+      @dashboard_password = ENV["PASSKIT_DASHBOARD_PASSWORD"]
+    end
+
+    def configured?
+      REQUIRED_ATTRIBUTES.all? { |attr| send(attr).present? }
+    end
+
+    def verify!
+      return if skip_verification
+
+      REQUIRED_ATTRIBUTES.each do |attr|
+        raise Error, "Please set #{attr.upcase}" unless send(attr).present?
+      end
+
+      raise Error, "PASSKIT_WEB_SERVICE_HOST must start with https://" unless web_service_host.start_with?("https://")
     end
   end
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: passkit
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Alessandro Rodi
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-04-09 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -222,7 +221,6 @@ metadata:
   source_code_uri: https://github.com/coorasse/passkit
   changelog_uri: https://github.com/coorasse/passkit/blob/master/CHANGELOG.md
   funding_uri: https://github.com/sponsors/coorasse
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -237,8 +235,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.22
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Serve Wallet Passes for iOS and Android directly from your Rails app
 test_files: []