Pass
A pass is something a creator sells to players for Castle bricks (the in-app currency): buy it once, own it for good. Use one to gate part of a deck behind a purchase — bonus levels, a cosmetic, supporting the creator. Set up the pass (name, art, price) on Castle; a deck refers to it by id.
Pass.has(passId): Promise<boolean>
Returns true if the current player owns the pass. No UI, nothing
charged — use it to gate content.
if (await Pass.has(bonusLevelsPassId)) {
showBonusLevels();
}
Pass.offer(passId): Promise<PassOfferResult>
Presents the pass for the player to buy; resolves when they're done.
Bricks cost real money, so this only works in the Castle mobile app —
elsewhere (the website, the dev server) it resolves unavailable.
PassOfferResult has a status:
'purchased'— just bought it; grant access.'alreadyOwned'— already had it (not charged); grant access.'cancelled'— dismissed without buying.'unavailable'— can't buy here (e.g. the website).
const { status } = await Pass.offer(bonusLevelsPassId);
if (status === "purchased" || status === "alreadyOwned") {
showBonusLevels();
}