docs/demo.ts - Chobble Tickets documentation

Demo mode and seed data generation.

Demo mode replaces real PII with sample data for safe previewing. Seeds populate the database with realistic test events and attendees.

Functions

f

applyDemoOverrides(

form: FormParams,

mapping: DemoFieldMap

Replace form field values with demo data when demo mode is active. Only replaces fields that are present and non-empty in the form. Mutates and returns the same URLSearchParams for chaining.

f

eventCount: number,

attendeesPerEvent: number

): Promise<SeedResult>

Create seed events and attendees using efficient batch writes. Encrypts all data before inserting, matching production behavior. Assigns random ticket quantities (1-4) per attendee without overselling.

f

isDemoMode(): boolean

Check if demo mode is enabled

f

randomChoice<T>(arr: readonly T[]): T

Pick a random element from an array

f

resetDemoMode(): void

Reset cached demo mode value (for testing and cache invalidation)

f

setDemoModeForTest(enabled: boolean): void

Explicitly set demo mode on or off (for testing). Bypasses Deno.env to avoid races between parallel test workers.

f

wrapResourceForDemo<R, I, V extends FieldValues = FieldValues>(

resource: NamedResource<R, I, V>,

mapping: DemoFieldMap

): NamedResource<R, I, V>

Wrap a named resource so create/update apply demo overrides to the form

Type Aliases

T

DemoFieldMap = Record<string, readonly string[]>

Maps form field names to arrays of possible demo values

T

SeedResult = { eventsCreated: number; attendeesCreated: number; }

Result of a seed operation

Variables

v

ATTENDEE_DEMO_FIELDS: DemoFieldMap

Attendee PII fields

v

DEMO_ADDRESSES:

"1 High Street, London, SW1A 1AA"
| "2 Main Road, Manchester, M1 1AA"
| "3 Church Lane, Bristol, BS1 1AA"
| "4 Park Avenue, Leeds, LS1 1AA"
| "5 Station Road, Birmingham, B1 1AA"
| "6 Mill Lane, Edinburgh, EH1 1AA"
| "7 Victoria Road, Cardiff, CF1 1AA"
| "8 Green Lane, Oxford, OX1 1AA"
| "9 King Street, Cambridge, CB1 1AA"
| "10 Queen's Road, Bath, BA1 1AA"
| "11 Riverside Drive, York, YO1 1AA"
| "12 Castle Street, Norwich, NR1 1AA"
| "13 Elm Close, Exeter, EX1 1AA"
| "14 Meadow Way, Canterbury, CT1 1AA"
| "15 Harbour View, Brighton, BN1 1AA"

Demo addresses

v

DEMO_BANNER: "<div class=\"demo-banner\">Demo Mode — entered text is replaced with sample data</div>"

Demo mode banner HTML

v

"alice@example.com"
| "bob@example.com"
| "carol@example.com"
| "dave@example.com"
| "eve@example.com"
| "frank@example.com"
| "grace@example.com"
| "henry@example.com"
| "ivy@example.com"
| "jack@example.com"
| "keiko@example.com"
| "liam@example.com"
| "maria@example.com"
| "nadia@example.com"
| "omar@example.com"
| "priya@example.com"
| "quincy@example.com"
| "rosa@example.com"
| "sven@example.com"
| "tomoko@example.com"
| "uche@example.com"
| "valentina@example.com"
| "wei@example.com"
| "xena@example.com"
| "yusuf@example.com"
| "zara@example.com"
| "aisling@example.com"
| "bjorn@example.com"
| "chiara@example.com"
| "dmitri@example.com"
| "elena@example.com"
| "fatima@example.com"
| "george@example.com"
| "hana@example.com"
| "ibrahim@example.com"
| "jasmine@example.com"
| "kofi@example.com"
| "leila@example.com"
| "magnus@example.com"
| "nkechi@example.com"
| "olga@example.com"
| "pablo@example.com"
| "ravi@example.com"
| "sakura@example.com"
| "tariq@example.com"
| "uma@example.com"
| "viktor@example.com"
| "wanda@example.com"
| "yuki@example.com"
| "amara@example.com"

Demo email addresses

v

DEMO_EVENT_DESCRIPTIONS: readonly string[]

Demo event descriptions — rock-themed gig blurbs assembled from word pools. Like the names above, the list is procedurally generated but seeded so it stays deterministic across runs.

v

DEMO_EVENT_LOCATIONS: readonly string[]

Demo event locations — pretend rock-venue / festival listings. Procedurally generated from the venue word pools using a seeded PRNG.

v

DEMO_EVENT_NAMES: readonly string[]

Demo event names — pretend rock/heavy-metal band listings. Generated procedurally from a seeded PRNG so the list stays deterministic across runs (tests rely on this) but offers far more variety than a hand-curated list while staying on-theme.

v

DEMO_FIRST_NAMES:

"Alice"
| "Bob"
| "Carol"
| "Dave"
| "Eve"
| "Frank"
| "Grace"
| "Henry"
| "Ivy"
| "Jack"
| "Keiko"
| "Liam"
| "Maria"
| "Nadia"
| "Omar"
| "Priya"
| "Quincy"
| "Rosa"
| "Sven"
| "Tomoko"
| "Uche"
| "Valentina"
| "Wei"
| "Xena"
| "Yusuf"
| "Zara"
| "Aisling"
| "Bjorn"
| "Chiara"
| "Dmitri"
| "Elena"
| "Fatima"
| "George"
| "Hana"
| "Ibrahim"
| "Jasmine"
| "Kofi"
| "Leila"
| "Magnus"
| "Nkechi"
| "Olga"
| "Pablo"
| "Ravi"
| "Sakura"
| "Tariq"
| "Uma"
| "Viktor"
| "Wanda"
| "Yuki"
| "Amara"
| "Aiden"
| "Bianca"
| "Callum"
| "Daphne"
| "Emeka"
| "Fiona"
| "Gustavo"
| "Haruki"
| "Ingrid"
| "Javier"
| "Keira"
| "Lorenzo"
| "Mina"
| "Niall"
| "Oona"
| "Petra"
| "Rafael"
| "Sienna"
| "Theo"
| "Ursula"
| "Vijay"
| "Wendy"
| "Xiomara"
| "Yolanda"
| "Zane"
| "Aoife"
| "Benoit"
| "Celine"
| "Declan"
| "Esme"
| "Felix"
| "Gemma"
| "Hugo"
| "Isla"
| "Jules"
| "Khadija"
| "Lucian"
| "Maeve"
| "Nico"
| "Orla"
| "Piotr"
| "Quinn"
| "Rosario"
| "Saoirse"
| "Tomas"

Demo first names for seed data (combined with surnames for more variety)

v

DEMO_GROUP_DESCRIPTIONS:

"A collection of summer activities for the whole family"
| "Warm up with our winter programme of events"
| "Community-led activities open to all"
| "Fun activities for young people aged 11-18"
| "Help us raise money for local causes"
| "Stay active with our sports and fitness events"

Demo group descriptions

v

DEMO_GROUP_NAMES:

"Summer Events"
| "Winter Programme"
| "Community Activities"
| "Youth Club"
| "Charity Fundraisers"
| "Sports & Fitness"

Demo group names

v

DEMO_HOLIDAY_NAMES:

"Bank Holiday"
| "School Half Term"
| "Christmas Break"
| "Easter Weekend"
| "Summer Holidays"
| "Staff Training Day"

Demo holiday names

v

"Alice Johnson"
| "Bob Smith"
| "Carol Williams"
| "Dave Brown"
| "Eve Davis"
| "Frank Miller"
| "Grace Wilson"
| "Henry Moore"
| "Ivy Taylor"
| "Jack Anderson"
| "Keiko Tanaka"
| "Liam O'Brien"
| "Maria Garcia"
| "Nadia Petrova"
| "Omar Hassan"
| "Priya Sharma"
| "Quincy Adams"
| "Rosa Hernandez"
| "Sven Lindqvist"
| "Tomoko Sato"
| "Uche Okafor"
| "Valentina Rossi"
| "Wei Zhang"
| "Xena Papadopoulos"
| "Yusuf Demir"
| "Zara Mbeki"
| "Aisling Murphy"
| "Bjorn Eriksson"
| "Chiara Bianchi"
| "Dmitri Volkov"
| "Elena Vasquez"
| "Fatima Al-Rashid"
| "George Kamau"
| "Hana Yoshida"
| "Ibrahim Diallo"
| "Jasmine Patel"
| "Kofi Mensah"
| "Leila Khoury"
| "Magnus Andersen"
| "Nkechi Eze"
| "Olga Novak"
| "Pablo Reyes"
| "Ravi Krishnan"
| "Sakura Watanabe"
| "Tariq Benmoussa"
| "Uma Devi"
| "Viktor Szabo"
| "Wanda Kowalski"
| "Yuki Nakamura"
| "Amara Osei"

Demo attendee names (full names for demo mode overrides)

v

DEMO_PAGE_TEXT:

"Welcome to our community events page. Browse upcoming events and book your tickets online."
| "Find out about local events in our village. Everyone is welcome to attend!"
| "Your one-stop destination for community events and activities."

Demo page text (homepage / contact)

v

"+44 7700 900001"
| "+44 7700 900002"
| "+44 7700 900003"
| "+44 7700 900004"
| "+44 7700 900005"
| "+44 7700 900006"
| "+44 7700 900007"
| "+44 7700 900008"
| "+44 7700 900009"
| "+44 7700 900010"
| "+44 7700 900011"
| "+44 7700 900012"
| "+44 7700 900013"
| "+44 7700 900014"
| "+44 7700 900015"
| "+44 7700 900016"
| "+44 7700 900017"
| "+44 7700 900018"
| "+44 7700 900019"
| "+44 7700 900020"
| "+44 7700 900021"
| "+44 7700 900022"
| "+44 7700 900023"
| "+44 7700 900024"
| "+44 7700 900025"
| "+44 7700 900026"
| "+44 7700 900027"
| "+44 7700 900028"
| "+44 7700 900029"
| "+44 7700 900030"

Demo phone numbers (UK format)

v

DEMO_SPECIAL_INSTRUCTIONS:

"No special requirements"
| "Wheelchair access needed"
| "Vegetarian meal please"
| "Requires parking space"
| "Bringing a guide dog"
| "Gluten-free diet"
| "Hearing loop required"
| "Arriving late, please save seat"
| "Nut allergy - please advise catering"
| "Bringing two children under 5"
| "Need a seat near the exit"
| "Vegan meal please"
| "Lactose intolerant"
| "BSL interpreter needed"
| "Bringing own mobility scooter"

Demo special instructions

v

"Johnson"
| "Smith"
| "Williams"
| "Brown"
| "Davis"
| "Miller"
| "Wilson"
| "Moore"
| "Taylor"
| "Anderson"
| "Tanaka"
| "O'Brien"
| "Garcia"
| "Petrova"
| "Hassan"
| "Sharma"
| "Adams"
| "Hernandez"
| "Lindqvist"
| "Sato"
| "Okafor"
| "Rossi"
| "Zhang"
| "Papadopoulos"
| "Demir"
| "Mbeki"
| "Murphy"
| "Eriksson"
| "Bianchi"
| "Volkov"
| "Vasquez"
| "Al-Rashid"
| "Kamau"
| "Yoshida"
| "Diallo"
| "Patel"
| "Mensah"
| "Khoury"
| "Andersen"
| "Eze"
| "Novak"
| "Reyes"
| "Krishnan"
| "Watanabe"
| "Benmoussa"
| "Devi"
| "Szabo"
| "Kowalski"
| "Nakamura"
| "Osei"
| "Chen"
| "Fitzgerald"
| "Johansson"
| "Kim"
| "Larsson"
| "Moreau"
| "Nguyen"
| "O'Sullivan"
| "Park"
| "Russo"
| "Singh"
| "Torres"
| "Virtanen"
| "Weber"
| "Yamamoto"
| "Zimmerman"
| "Bergstrom"
| "Costa"
| "Dubois"
| "Fischer"
| "Gonzalez"
| "Horvat"
| "Ivanova"
| "Jensen"
| "Kapoor"
| "Li"
| "Martinez"
| "Nielsen"
| "Oduya"
| "Pereira"
| "Ramirez"
| "Svensson"
| "Takahashi"
| "Ueda"
| "Varga"
| "Walsh"
| "Xu"
| "Yilmaz"

Demo surnames for seed data (combined with first names for more variety)

v

"Tickets are non-refundable. Please arrive 15 minutes before the event start time."
| string
| "All attendees must follow the venue code of conduct. Photography may take place at this event."

Demo terms and conditions

v

DEMO_WEBSITE_TITLES:

"Village Events"
| "Community Hub"
| "Parish Council Events"
| "Town Hall Bookings"

Demo website titles

v

EVENT_DEMO_FIELDS: DemoFieldMap

Event metadata fields

v

GROUP_DEMO_FIELDS: DemoFieldMap

Group name and description fields

v

HOLIDAY_DEMO_FIELDS: DemoFieldMap

Holiday name field

v

SEED_MAX_ATTENDEES: 100000

Max attendees per seeded event

v

SITE_CONTACT_DEMO_FIELDS: DemoFieldMap

Site contact page fields

v

SITE_HOME_DEMO_FIELDS: DemoFieldMap

Site homepage fields

v

TERMS_DEMO_FIELDS: DemoFieldMap

Terms and conditions field

Usage

import * as mod from "docs/demo.ts";