[PR-26997] Support Apple poster pass styles

[ilovepinkpony1]

Summary

Adds opt-in support for the iOS 27 Apple Wallet poster styles, and fixes boarding_pass keys never reaching pass.json.

Problem

1. The gem can only emit the classic pass layouts (storeCard, coupon, eventTicket, generic, boardingPass). iOS 27 adds the poster styles, which use a different layout: logo -> logo text -> header fields -> background image -> barcode -> primary fields -> footer fields. There is no secondary or auxiliary row, and there is a footer row the classic layouts do not have. Wallet also renders up to two action buttons on the face of the pass from a top-level featuredActions key.

2. boarding_pass was dead code. The old line was pass[:boardingPass].merge(@pass.boarding_pass) — Hash#merge returns a new hash and the result was thrown away, so keys like transitType never reached pass.json.

Solution

Four new hooks on Passkit::BasePass, all with safe defaults so nothing changes for existing passes:

hook	default	purpose
poster_pass_type	nil	poster style dictionary to emit, e.g. :posterGeneric
poster_primary_fields	primary_fields	the row above the poster footer
footer_fields	[]	the poster footer row
featured_actions	[]	up to two action buttons

A pass that sets poster_pass_type emits both style dictionaries in one pass.json. This is Apple's own backward-compatibility pattern: older iOS does not know the posterGeneric key, ignores it, and renders the classic dictionary instead. One pass file works on every device.

poster_primary_fields is a separate hook rather than reusing primary_fields because both dictionaries ship in the same file and the two slots hold different content — the classic layout puts primary fields above the barcode, the poster below it. It defaults to primary_fields so passes that want the same content in both get it for free.

posterGeneric is the only poster style Wallet accepts as a top-level key. posterEventTicket is a preferredStyleSchemes array entry, not a style dictionary.

The boarding pass fix assigns the merge result back: pass[:boardingPass] = pass[:boardingPass].merge(@pass.boarding_pass).

generate_json_pass is split into a one-line file writer plus a pass_json builder so the payload can be tested without a signing certificate or a booted app.

Version bumped to 0.8.0.

Demo

https://admin.bastion.talkable.com/

Screenshots

Checklist

• Updated the documentation accordingly
• Added tests to cover the changes
• Deployed the changes to Void
• Deployed the changes to Bastion
• Deployed the changes to Bart
• Can be reverted easily on Production

Related Stories

Test Plan

test/test_generator_poster.rb — 7 tests, 15 assertions, all green:

bundle exec ruby -Itest test/test_generator_poster.rb
7 runs, 15 assertions, 0 failures, 0 errors, 0 skips

Coverage:

• the poster dictionary is emitted alongside the classic one, sharing header and back fields
• the poster dictionary carries no secondary or auxiliary rows
• poster primary fields are independent of the classic ones
• poster_primary_fields falls back to primary_fields when a pass does not override it
• featuredActions is emitted
• passes with no poster style are byte-for-byte unchanged (no posterGeneric, no featuredActions)
• boarding_pass keys are merged into the boardingPass dictionary without wiping the generated fields

Both fixes were reverted locally to confirm the tests fail without them — 4 failures, then green again after restoring.

bundle exec standardrb adds no new offenses (42 before this branch, 42 after).

bundle exec rake cannot run on this machine: it needs a .env (the repo ships .example.env), and even with the env vars set there is a pre-existing gem conflict — can't activate sqlite3 (>= 2.1), already activated sqlite3-1.7.3. Both failures reproduce on main.

Files Changed

• lib/passkit/base_pass.rb — the four new hooks with defaults
• lib/passkit/generator.rb — emit the poster dictionary and featuredActions; fix the boarding pass merge; split out pass_json
• app/models/passkit/pass.rb — delegate the four new hooks
• lib/passkit/version.rb — 0.7.0 -> 0.8.0
• CHANGELOG.md — 0.8.0 entry
• test/test_generator_poster.rb — new

[zhuravel]

No problems found in this PR.

Reviewed main@6c0174d → vo-PR-26997@122af06 only.

Checks

• ruby -Itest test/test_generator_poster.rb — 8 runs and 16 assertions passed.
• Ruby syntax — five changed Ruby files passed.
• Full suite — not run: sqlite3 ~> 1.4 is not installed.
• StandardRB — not run: the standard gem is not installed.
• Apple Wallet docs — poster and featured action schemas matched.