Adds the GM-facing end-of-session orchestration. The expected use is a
Foundry macro of type Script with body:
seitimeBridge.endSession();
Flow:
1. Fetch scheduled sessions for this world from Frappe.
2. If 0 → notify and abort. If 1 → confirm dialog. If 2+ → picker dialog.
3. POST complete_session to mark the chosen session Completed and
schedule the next one (Frappe-side schedule_next_session).
4. Push snapshots for every PC in parallel (Promise.allSettled — partial
failures are surfaced, not fatal).
5. Whisper a summary chat message to the GM (counts and any failed
actor names with errors).
scripts/macros.js holds the orchestration; scripts/api.js gains thin
fetch wrappers for list_scheduled_sessions and complete_session. HTML in
dialogs and chat is escaped on output since session titles ultimately
come from user input.
Public API now: testConnection, pushManifest, pushSnapshot,
pushAllSnapshots, endSession.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Foundry side of the per-PC snapshot flow: the primary GM pushes a debounced
snapshot of any character that gets edited, including embedded item changes
(updateItem/createItem/deleteItem don't trigger updateActor in v12).
Payload is actor.toObject() augmented with a denormalized _player_name
field — the Frappe extractor reads it from there since Foundry's ownership
map uses opaque user IDs.
Per-actor debouncers (default 5s, configurable) keep combat HP edits from
spamming the webhook. Toggle off via the snapshotAutoSync setting if you
want explicit-only pushes from a macro.
API exposed at globalThis.seitimeBridge.pushSnapshot(actor) for manual
pushes (single argument: a Foundry Actor document).
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Foundry v12 ESM module that pushes the world's PC actor manifest to a
companion Frappe app via webhook.
Structure:
- scripts/main.js: registers settings on init, exposes API on ready,
wires createActor/deleteActor/periodic hooks. All push operations
gated to game.users.activeGM to avoid duplicate pushes from co-GMs.
- scripts/settings.js: Frappe URL, shared secret, world ID, periodic
interval. Secret uses `secret: true` for masked input but is still
readable by all connected clients (documented in setting hint).
- scripts/api.js: bridgeFetch helper with X-Bridge-Secret/-World
headers, pushManifest, testConnection.
- scripts/constants.js: MODULE_ID.
Public API exposed at globalThis.seitimeBridge:
seitimeBridge.testConnection() // round-trip empty manifest
seitimeBridge.pushManifest() // push current world manifest
dnd5e is declared as a related system in module.json.
Snapshot push and End Session macro come in subsequent commits.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
