Subscribe URL + GateCard Review — 2026-06-05

Use this doc to verify all changes from the “subscribe URL centralized + GateCard emailMode + subscribe-direct hub API” commit.
All links are absolute paths — click to open the exact line in VS Code.

1. Subscribe URL — single source of truth in app-core.js

What changed: /subscribe-direct is now defined once in AppCoreConfig. All callers read from it.

How to verify:

# Should return ZERO results — no raw /subscribe-direct strings left in app-core.js
grep -n "'/subscribe-direct'\|\"\/subscribe-direct\"" assets/js/app-core.js

How to change the subscribe URL site-wide:
Edit only subscribeUrl at line 45. Everything else follows.

2. GateCard — emailMode option + inline form support

What changed: GateCard now supports emailMode: 'form' which renders an inline EmailSubscribe form instead of a link.

How to use on any page:

// Show inline email form instead of link (gate modal):
GateCard.render(container, { mode: 'sequential', emailMode: 'form' });

// Show push button only:
GateCard.render(container, { mode: 'push-only' });

// Show both push + email form side-by-side:
GateCard.render(container, { mode: 'both', emailMode: 'form' });

Front matter shortcuts (post.html):

gate_mode: sequential       # sequential | push-only | email-only | both
gate_email_mode: form       # link | form
gate_email_url: /custom-subscribe  # override URL for this post only

3. post.html GATE_CONFIG — emailMode + URL from config

What changed: GATE_CONFIG now exposes emailMode and reads emailUrl from AppCoreConfig instead of hardcoding it.

4. bookpost.html SUBSCRIPTION_INTENTS — URL from config

What changed: fallbackUrl in both intents now reads AppCoreConfig.subscribeUrl instead of /subscribe-direct hardcoded.

5. subscribe-direct.html — new hub API throughout

What changed: page now uses SubscriptionHub for cap checks and sends full grants on push subscribe.

How to verify:

# Should return ZERO — no direct localStorage push reads left
grep -n "localStorage.*push_subscribed" subscribe-direct.html

# Should return FULL_PUSH_GRANTS — not bare subscribe()
grep -n "subscribeFor\|subscribe()" subscribe-direct.html

Quick sanity checks (run all at once)

cd /home/ahmed/.gemini/antigravity/scratch/ahmedbouchefra2

# 1. No raw /subscribe-direct strings in app-core.js (only SUBSCRIBE_URL)
grep -n "'/subscribe-direct'\|\"\/subscribe-direct\"" assets/js/app-core.js

# 2. No localStorage push reads in subscribe-direct page
grep -n "localStorage.*push_subscribed" subscribe-direct.html

# 3. GateCard reads URL from config, not hardcoded
grep -n "subscribe-direct" assets/js/ui/subscribe/GateCard.js

# 4. bookpost fallbackUrl uses _subUrl helper
grep -n "fallbackUrl" _layouts/bookpost.html

# 5. post.html GATE_CONFIG has emailMode field
grep -n "emailMode" _layouts/post.html

All checks should return either zero results or show the new patterns (no raw /subscribe-direct strings, no localStorage.getItem('push_subscribed')).