32 Commits
Author SHA1 Message Date
George Powell 45ffa39f2a first pass analytics redo 2026-09-22 12:15:56 -04:00
George Powell b656fd04c0 Merge pull request #3 from pupperpowell/rss-feed-fixes
fix(rss): stop future-verse leaks, correct timezone dates, fix feed discovery
2026-09-22 12:01:19 -04:00
George Powell 97bff35323 fix(rss): halt future-verse leaks, correct timezone dates, fix discovery
- Cap /feed.xml at the current America/New_York calendar day so
  pre-scheduled future verses (and stray 2124 rows) can no longer
  surface at the top of the feed
- Emit DST-aware RFC 822 pubDates (correct -04:00/-05:00 offset) instead
  of a hardcoded EST offset, and parse calendar days as UTC so titles
  no longer shift by one day on UTC hosts
- Add content-addressed ETag + Last-Modified with If-None-Match /
  If-Modified-Since conditional handling
- Add atom:link rel=self, content:encoded, channel pubDate/generator/image
- Move RSS auto-discovery <link> into app.html: the root route sets
  ssr=false, so the layout <svelte:head> link never reached the raw HTML
  and feed readers could not discover /feed.xml
- Extract feed helpers into $lib/server/rss and add unit tests
2026-09-22 11:31:36 -04:00
George Powell 4a53e09ab3 documentation 2026-07-07 17:49:33 -04:00
George Powell 2fb484ebaa Minor button cooldown change 2026-07-07 17:06:12 -04:00
George Powell 21efdd4eef New scheduling UI! 2026-07-07 17:02:24 -04:00
George Powell be0d7ad297 Added verse-submission infrastructure 2026-07-07 15:41:10 -04:00
George Powell 99552c57ad Added donation button 2026-07-07 13:12:17 -04:00
George Powell efc9900de1 Updated documentation 2026-07-07 12:13:35 -04:00
George Powell e3ca264c54 new email link 2026-05-26 17:59:56 -04:00
George Powell f5e16c7e71 updated todo and fixed themetoggle 2026-03-25 09:06:21 -04:00
George Powell e45ac28169 rainbow glow 2026-03-25 02:25:04 -04:00
George PowellandClaude Sonnet 4.6 3d578a9eb8 feat: add Google sign-in button to WinScreen and footer provider label
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-25 01:50:34 -04:00
George PowellandClaude Sonnet 4.6 db04da6a2c feat: add Sign In with Google
Adds Google OAuth alongside existing Apple and email/password auth. Follows the same patterns as Apple Sign-In: state cookie for CSRF, anonymousId migration, and user linking by email. Key differences: Google callback is a GET redirect (sameSite: lax) and uses a static client secret instead of a signed JWT.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-25 01:39:24 -04:00
George PowellandClaude Sonnet 4.6 321fac9aa8 feat: add achievements system, hint overlay, and progress page polish
Achievements system:
- Add src/lib/server/milestones.ts with full achievement definitions and
  calculation logic (16 achievements: streaks, book set completions,
  community milestones like Overachiever/Procrastinator/Outlier, and fun
  ones like Prodigal Son, Extra Credit, Is This A Joke To You?)
- Wire calculateMilestones() into the progress page server load
- Replace the old ad-hoc milestone cards with a proper achievements grid
  (3/4 col, uniform min-height cards, larger text)
- Change "With God, All Things Are Possible" from "every game solved in 1"
  to "solve in 1 guess for each of the 66 books at least once"

Game page hint overlay:
- After a correct testament/section/first-letter match, display a subtle
  text hint below the verse prompt (e.g. "It is in the Old Testament.")
- Hints fade in 2.8s after a guess (after the row flip animation)
- Hints are only shown to new players (fewer than 3 tracked wins) to
  avoid being patronising to experienced players

Progress page:
- Hide Skill Growth chart with {#if false && showChart} pending rework
- Fix book tier colour scheme: explored=blue, mastered=purple, perfect=emerald
  (was amber/emerald — now consistent across grid, legend, and stat cards)
- Simplify GuessesTable row colour: remove proximity gradient, use flat red
  for wrong guesses
- Add "Come back tomorrow!" encouragement text in CountdownTimer for new
  players (fewer than 3 wins)
- Fix GamePrompt text colour to always be gray-100

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-24 00:37:15 -04:00
George PowellandClaude Sonnet 4.6 4a5aef5a3d refactor: extract CollapsibleTable component and fix show more
Replaces 7 inline collapsible tables in the global stats page with a
reusable CollapsibleTable component. Adds mode tab toggle (Rolling 30d /
Calendar) into the component. Fixes show more/less which was broken due
to mode-based expanded tracking when no modes were provided.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-23 20:17:30 -04:00
George PowellandClaude Sonnet 4.6 f98ab24d2e fix: update Discord message format to italic date + bold verse
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-22 01:05:38 -04:00
George PowellandClaude Sonnet 4.6 c5b333bbb3 fix: use Bun.env instead of $env/dynamic/private to avoid build-time errors
$env/dynamic/private requires env vars to be present at build time.
Bun.env reads them at runtime, which is correct for runtime secrets.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-22 00:59:16 -04:00
George Powell e842923d81 guesses 2026-03-22 00:58:17 -04:00
George PowellandClaude Sonnet 4.6 51bfb53a39 feat: add /api/send-daily-verse endpoint for daily Discord verse posting
Protected by CRON_SECRET bearer token. Fetches today's verse in
America/New_York timezone and POSTs it to DISCORD_DAILY_WEBHOOK.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-22 00:57:01 -04:00
George PowellandClaude Sonnet 4.6 45d33b6bad feat: improve guesses collapse timing, win screen CTA, and progress page polish
- GuessesTable now accepts a `minimized` prop instead of deriving collapse from `isWon`, giving the parent control over timing
- Delay collapsing guesses grid until win animations complete (1800ms), skipped for already-completed puzzles
- Replace plain progress link on win screen with a styled green button matching other CTAs
- Progress page: remove redundant subtitle and nav button from header, add book status legend, add axis labels to guess history chart

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-22 00:47:02 -04:00
George PowellandClaude Sonnet 4.6 3eb3a968dc feat: add progress page with activity calendar, book grid, and insights
Adds a new /progress route showing a personalized Bible knowledge dashboard
with stat cards, book mastery grid, 30-day activity calendar, skill growth
chart, streak milestones, and section insights. Links added from WinScreen
(logged-in users) and DevButtons.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-21 23:33:47 -04:00
George Powell 67d9757f98 added discord link and shrunk guessesgrid for more than three guesses 2026-03-19 10:53:57 -04:00
George Powell b6b41b6ba9 added MaU section with projection 2026-03-19 00:39:54 -04:00
George Powell bdc08bc58e Added survival curve metrics and table minimizing 2026-03-19 00:18:54 -04:00
George PowellandClaude Sonnet 4.6 83cfcc66c0 feat: add WAU history table, fix retention metric, add new logos and favicon
- Add 12-week Weekly Active Users table to global stats with WoW change %
- Fix 7-day and 30-day retention to measure return on exactly day N (not any day within the window)
- Remove "Avg Guesses Today" stat card
- Update retention description to clarify exact-day measurement
- Add bibdle logos (SVG, square PNG, circle PNG) and new favicon.png
- Wire favicon.png as the site favicon via app.html link tag

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-16 00:04:45 -04:00
George Powell e878dea235 Fixed instructions, added color border based on closeness between guess
and target
2026-03-15 03:19:21 -04:00
George PowellandClaude Sonnet 4.6 252edc3a6d fix: show most recent dates first in return rate and retention tables
- Reverse new player return rate table (most recent day at top)
- Reverse 7- and 30-day retention tables (most recent cohort at top)
- Rename "Day Rate" column to "Return Rate"
- Clarify "Last 14 Days" heading to "Last 14 Days — Completions"

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-15 02:16:16 -04:00
George PowellandClaude Sonnet 4.6 75b13280ef feat: add return rate and retention metrics to global stats
- Overall return rate: % of all-time players who played more than once
- New player return rate: 7-day rolling avg of daily first-timer return rates, with velocity vs prior 7 days
- 7-day and 30-day retention over time: per-cohort-day retention series

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-15 02:09:55 -04:00
George Powell 7007df2966 added global route for stat tracking 2026-03-14 22:17:33 -04:00
George Powell 61673a646d Added thank you message 2026-03-14 18:46:22 -04:00
George Powell 1eb8eb2f04 Added umami event to Apple signin and fixed spacing 2026-03-14 18:40:57 -04:00
120 changed files with 15160 additions and 716 deletions

No files matched your search

+22
View File
@@ -1,5 +1,27 @@
DATABASE_URL=example.db DATABASE_URL=example.db
# Local-only admin bypass for testing /admin/stats without the real admin
# account. NEVER enable in production (it is also force-disabled when
# NODE_ENV=production).
# DEV_ADMIN_ALL=true
# Cron job secret for protected endpoints (e.g. send-daily-verse)
CRON_SECRET=your-cron-secret-here
# Discord webhook URL for posting the daily verse
DISCORD_DAILY_WEBHOOK=https://discord.com/api/webhooks/your-webhook-url
# Discord admin webhook for the daily statistics digest (optional; digest is skipped if unset)
DISCORD_ADMIN_WEBHOOK=https://discord.com/api/webhooks/your-admin-webhook-url
# Statistics thresholds (optional; these override the built-in defaults)
# STATS_CORE_PLAYS_PER_WEEK=4
# STATS_CHURN_DAYS=30
# STATS_D1_TARGET=20
# STATS_RETURN7_TARGET=25
# STATS_FIRST_TRY_MIN=15
# STATS_FIRST_TRY_MAX=35
PUBLIC_SITE_URL=https://bibdle.com PUBLIC_SITE_URL=https://bibdle.com
# nodemailer # nodemailer
-165
View File
@@ -1,165 +0,0 @@
# CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
## Project Overview
Bibdle is a daily Bible verse guessing game built with SvelteKit 5. Players read a verse and try to guess which book of the Bible it comes from. The game provides feedback hints (Testament match, Section match, Adjacent book, etc.) similar to Wordle-style games. Progress is stored locally in the browser and a new verse is generated daily.
You are able to use the Svelte MCP server, where you have access to comprehensive Svelte 5 and SvelteKit documentation. Here's how to use the available tools effectively:
(Make sure you use the Svelte agent to execute these commands)
## Available MCP Tools:
### 1. list-sections
Use this FIRST to discover all available documentation sections. Returns a structured list with titles, use_cases, and paths.
When asked about Svelte or SvelteKit topics, ALWAYS use this tool at the start of the chat to find relevant sections.
### 2. get-documentation
Retrieves full documentation content for specific sections. Accepts single or multiple sections.
After calling the list-sections tool, you MUST analyze the returned documentation sections (especially the use_cases field) and then use the get-documentation tool to fetch ALL documentation sections that are relevant for the user's task.
### 3. svelte-autofixer
Analyzes Svelte code and returns issues and suggestions.
You MUST use this tool whenever writing Svelte code before sending it to the user. Keep calling it until no issues or suggestions are returned.
## Tech Stack
- **Framework**: SvelteKit 5 with Svelte 5 (uses runes: `$state`, `$derived`, `$effect`, `$props`)
- **Styling**: Tailwind CSS 4
- **Database**: SQLite with Drizzle ORM
- **Auth**: Session-based authentication using Bun's built-in cryptographically secure functions
- **Deployment**: Node.js adapter for production builds
- **ML**: `@xenova/transformers` for verse embeddings (initialized in server hook) (currently disabled, was a test for a cancelled project)
## Development Commands
```bash
# Start development server
bun run dev
# Type checking
bun run check
bun run check:watch
# Run tests
bun test
bun test --watch
bun test tests/timezone-handling.test.ts # Run a single test file
# Build for production
bun run build
# Preview production build
bun run preview
# Database operations
bun run db:push # Push schema changes directly (avoid in prod)
bun run db:generate # Generate migrations
bun run db:migrate # Run migrations
bun run db:studio # Open Drizzle Studio GUI
```
## Critical: Date/Time Handling
**Bibdle is played by users across many timezones worldwide. The verse shown to a player must always be the verse for the calendar date at *their* location — not the server's timezone, not UTC. A user in Tokyo on Wednesday must see Wednesday's verse, even if the server (or a user in New York) is still on Tuesday.**
**NEVER use server time or UTC time for user-facing date calculations.**
- Get today's date client-side: `new Date().toLocaleDateString("en-CA")` → `YYYY-MM-DD`
- Pass the date to the server as a query param or POST body (`localDate`)
- Server-side date arithmetic must use UTC methods on the client-provided date string: `new Date(dateStr + 'T00:00:00Z')` + `setUTCDate`/`getUTCDate`
- `src/routes/+page.ts` has `ssr = false` so the load runs client-side with the true local date
- Never set the user-facing URL to include their date as a parameter. It should always be passed to an API route behind the scenes if needed.
### Streak Calculation
A streak counts consecutive calendar days (in the user's local timezone) on which the user completed the puzzle. The rules:
- The client passes its local date (`localDate`) to the streak API. The server never uses its own clock.
- A streak is **active** if the user has completed today's puzzle *or* yesterday's puzzle (they still have time to play today).
- Walk backwards from `localDate` through the `dailyCompletions` records, counting each day that has a completion. Stop as soon as a day is missing.
- A streak of 1 (completed only today or only yesterday, with no prior consecutive days) is **not displayed** — the minimum shown streak is 2.
- "Yesterday" and all date arithmetic on the server must use UTC methods on the client-provided date string to avoid timezone drift: `new Date(localDate + 'T00:00:00Z')`, then `setUTCDate`/`getUTCDate`.
## Architecture
### Database Schema (`src/lib/server/db/schema.ts`)
- **user**: `id`, `firstName`, `lastName`, `email` (unique), `passwordHash`, `appleId` (unique), `isPrivate`
- **session**: `id` (SHA-256 hash of token), `userId` (FK), `expiresAt`
- **daily_verses**: Cached daily verses with book ID, verse text, reference, and date
- **dailyCompletions**: Game results per user/date with guess count, grade, book; unique on `(userId, date)`
Sessions expire after 30 days and auto-renew when < 15 days remain.
### Bible Data (`src/lib/types/bible.ts`)
The `bibleBooks` array contains all 66 Bible books with metadata:
- Testament (old/new), Section (Law, History, Wisdom, Prophets, Gospels, Epistles, Apocalyptic)
- Order (1-66, used for adjacency detection)
### Daily Verse System (`src/routes/+page.server.ts`)
`getTodayVerse()` checks the database for today's date, fetches a verse if missing, caches permanently, and returns verse with book metadata.
### Game Logic (`src/routes/+page.svelte`)
**State Management:**
- `guesses` array stored in localStorage keyed by date: `bibdle-guesses-${date}`
- Each guess tracks: book, testamentMatch, sectionMatch, adjacent
- `isWon` derived from whether any guess matches the correct book
**Hint System, for share grid:**
- ✅ Exact match | 🟩 Section match | 🟧 Testament match | ‼️ Adjacent book | 🟥 No match
### Authentication System (`src/lib/server/auth.ts`)
- Token generation: base64-encoded random bytes; stored as SHA-256 hash in DB
- Cookie name: `auth-session`
- Anonymous users: identified by a client-generated ID; stats migrate on sign-up via `migrateAnonymousStats()`
- Apple Sign-In supported via `appleId` field
### Stats & Streak (`src/routes/stats/`)
- Stats page requires auth; returns `requiresAuth: true` if unauthenticated
- Streak calculated client-side by calling `GET /api/streak?userId=X&localDate=Y`
- Streak walk-back: counts consecutive days backwards from `localDate` through completed dates
- Minimum displayed streak is 2 (single-day streaks suppressed)
## API Endpoints
- `POST /api/daily-verse` — Fetch verse for a specific date
- `POST /api/submit-completion` — Submit game result with stats
- `GET /api/streak?userId=X&localDate=Y` — Current streak for user
- `GET /api/streak-percentile` — Streak percentile ranking
## Key Files
- `src/routes/+page.svelte` — Main game UI and client-side logic
- `src/routes/+page.server.ts` / `+page.ts` — Server load (verse) + client load (`ssr: false`)
- `src/routes/stats/+page.svelte` / `+page.server.ts` — Stats UI and server calculations
- `src/lib/server/auth.ts` — Session management, password hashing, anonymous migration
- `src/lib/server/bible-api.ts` — Random verse fetching from local XML Bible
- `src/lib/server/bible.ts` — Bible book utility functions
- `src/lib/types/bible.ts` — Bible books data and TypeScript types
- `src/lib/server/db/schema.ts` — Drizzle ORM schema
- `src/hooks.server.ts` — Session validation hook; initializes ML embeddings
- `tests/` — Bun test suites (timezone, game, bible, stats, share, auth migration)
## Environment Variables
Required in `.env`:
- `DATABASE_URL` — Path to SQLite database file (e.g., `./local.db`)
## Deployment
Uses `@sveltejs/adapter-node`. See `bibdle.service` systemd configuration.
## A Note
The main developer of this project is still learning a lot about developing full-stack applications. If they ask you to do something, make sure they understand how it will be implemented before proceeding.
+194 -23
View File
@@ -1,38 +1,209 @@
# sv # Bibdle
Everything you need to build a Svelte project, powered by [`sv`](https://github.com/sveltejs/cli). A daily Bible verse guessing game. Each day a verse is shown and players try to identify which of the 66 books of the Bible it comes from, receiving Wordle-style feedback (Testament match, Section match, Adjacent book, First letter, etc.) after each guess. A new verse is generated daily and progress is tracked across timezones.
## Creating a project Live at [bibdle.com](https://bibdle.com).
If you're seeing this, you've probably already done this step. Congrats! ## Tech Stack
```sh - **Framework**: SvelteKit 2 with Svelte 5 (runes: `$state`, `$derived`, `$effect`, `$props`)
# create a new project in the current directory - **Styling**: Tailwind CSS 4
bunx sv create - **Database**: SQLite (`bun:sqlite`) with Drizzle ORM
- **Auth**: Session-based — email/password (argon2id via `Bun.password`), plus Apple and Google OAuth
- **Bible text**: Local NKJV XML (`EnglishNKJBible.xml`), parsed with `fast-xml-parser`; a Greek 1904 and Swedish 2000 translation are also bundled for alternate modes
- **ML** (currently disabled): `@xenova/transformers` verse embeddings for a similarity search route
- **Deployment**: `@sveltejs/adapter-node`, run under Bun, managed by a systemd service (see `bibdle.service`)
# create a new project in my-app ## Getting Started
bunx sv create my-app
```
## Developing ```bash
bun install
Once you've created a project and installed dependencies with `npm install` (or `pnpm install` or `yarn`), start a development server: # Start the dev server (Vite, Bun runtime)
```sh
bun run dev bun run dev
# or start the server and open the app in a new browser tab # Type checking
bun run dev -- --open bun run check
```
## Building # Tests (Bun test)
bun test
bun test tests/timezone-handling.test.ts # single file
bun test --watch
To create a production version of your app: # Production build & preview
```sh
bun run build bun run build
bun run preview
``` ```
You can preview the production build with `bun run preview`. ### Database
> To deploy your app, you may need to install an [adapter](https://svelte.dev/docs/kit/adapters) for your target environment. ```bash
bun run db:push # push schema changes directly (avoid in prod)
bun run db:generate # generate migrations
bun run db:migrate # run migrations
bun run db:studio # open Drizzle Studio GUI
```
The statistics dashboard migration (`drizzle/0004_slim_nomad.sql`) is **purely additive**: it creates `stats_snapshot`, `analytics_events` and `dashboard_settings`, and adds a nullable `user.created_at`. It never alters or drops historical rows. To replicate to production, apply that SQL to `prod.db` (e.g. `sqlite3 prod.db < drizzle/0004_slim_nomad.sql`) **before** deploying the new code. Applying it twice is safe for the new tables only if you skip the existing objects; run it once.
### Environment Variables
See `.env.example`. Required/used variables:
- `DATABASE_URL` — path to the SQLite database file (e.g. `prod.db`)
- `PUBLIC_SITE_URL` — canonical site URL
- `CRON_SECRET` — bearer token protecting the cron-only `/api/send-daily-verse` and `/api/cron/build-stats` endpoints
- `DISCORD_DAILY_WEBHOOK` — webhook for posting the daily verse to Discord
- `DISCORD_ADMIN_WEBHOOK` — optional webhook for the daily statistics digest (digest is skipped when unset)
- `STATS_*` — optional overrides for dashboard thresholds (`STATS_D1_TARGET`, `STATS_CORE_PLAYS_PER_WEEK`, …); see `src/lib/types/stats.ts` for defaults
- `AUTH_SECRET` — secret for Apple Sign-In
- `APPLE_ID` / `APPLE_TEAM_ID` / `APPLE_KEY_ID` / `APPLE_PRIVATE_KEY` — Apple Sign-In credentials
- `SMTP_USERNAME` / `SMTP_TOKEN` / `SMTP_SERVER` / `SMTP_PORT` — email (nodemailer)
## Architecture
### Database Schema (`src/lib/server/db/schema.ts`)
- **user** — `id`, `firstName`, `lastName`, `email` (unique), `passwordHash`, `appleId` (unique), `googleId` (unique), `isPrivate`, `createdAt` (nullable; existing accounts show "unknown")
- **session** — `id` (SHA-256 hash of token), `userId` (FK), `expiresAt`
- **dailyVerses** — cached daily verse: `date` (unique), `bookId`, `verseText`, `reference`, `createdAt`
- **dailyCompletions** — one row per player/date: `anonymousId`, `date`, `guessCount`, `guesses` (JSON of book IDs, nullable), `completedAt`. Unique on `(anonymousId, date)` to prevent duplicate submissions.
- **verseSubmissions** — a log of community-submitted future verses: `id`, `userId` (FK → `user.id` ON DELETE SET NULL), `scheduledDate` (unique `YYYY-MM-DD` matching a `dailyVerses` row), `selectedBookId`, `selectedChapter`, `selectedVerse` (the anchor the user picked), `submittedAt` (server UTC millis, drives the 7-day cooldown). Indexed on `userId` (cooldown lookup) and `scheduledDate` (unique). The canonical verse text/reference lives on `dailyVerses`, joined by `scheduledDate`.
- **statsSnapshot** — one immutable JSON aggregate row per as-of day (`date` PK, `generatedAt`, `buildKind`, `configVersion`, `payload`, `playerState`, `config`). Powers `/admin/stats` with point-in-time reads.
- **analyticsEvents** — generic event log (`id`, `name`, `anonymousId`, `userId`, `date`, `createdAt`, `metadata`) with a partial unique index deduping `verse_served` per player/day.
- **dashboardSettings** — key/value overrides for dashboard thresholds.
Sessions expire after 30 days and auto-renew when fewer than 15 days remain.
### Bible Data (`src/lib/types/bible.ts`)
The `bibleBooks` array lists all 66 books with metadata:
- `testament`: `old` | `new`
- `section`: `Law`, `History`, `Wisdom`, `Major Prophets`, `Minor Prophets`, `Gospels`, `Pauline Epistles`, `General Epistles`, `Apocalyptic`
- `order` (1–66, used for adjacency detection)
### Game Logic
- `src/lib/utils/game.ts` — `evaluateGuess()` compares a guess to the target book and returns `testamentMatch`, `sectionMatch`, `adjacent`, and `firstLetterMatch` flags. `getGrade()` maps guess count to a letter grade (S+ down to C). Includes a special-case so that numbered Epistles (e.g. "1 John") match on first letter against any other numbered Epistle.
- `src/lib/stores/game-persistence.svelte.ts` — reactive store that keeps guesses and per-day flags in sync with `localStorage`, keyed by date (`bibdle-guesses-${date}`). Resolves the player identity (logged-in user ID, or a locally generated anonymous UUID) and restores state.
- `src/lib/utils/share.ts` — generates the share grid and text. Hint emojis: ✅ exact · 🟩 section · 🟧 testament · ‼️ adjacent · 🟥 no match.
### Daily Verse System
`src/lib/server/daily-verse.ts` → `getVerseForDate(date)`: returns the cached verse for a date if present, otherwise fetches a random verse from the local XML Bible and stores it permanently. The XML Bible is read and parsed in `src/lib/server/xml-bible.ts`; `src/lib/server/bible-api.ts` wraps it to produce a verse with a validated `bookId`, `reference`, and `verseText`.
### Community Verse Submissions
Authenticated users who have solved today's puzzle can submit a verse for scheduling as a future "verse of the day." Selection is dropdown-based (cascading Book → Chapter → Verse selects), so content is always canonical NKJV text — no free-text entry. Each submission immediately reserves a concrete future date.
- `src/lib/server/verse-submission.ts` — the 3-verse window composer (`composeVerseWindow`, fall-forward, never crosses a book), `formatWindowReference` (same-chapter hyphen / cross-chapter en-dash), and the assign-at-submit scheduling scan (empty / no-back-to-back-with-committed-neighbors / 60-day-repeat rules, transaction + retry-on-unique-conflict).
- `getVerseForDate(date)` serves pre-written submission rows unchanged on their day; gap days (no committed row) are filled lazily by the random path, now extended to avoid the book of any committed neighbor (D-1 / D+1).
- **Rate limiting:** one submission per user per rolling 7×24h window, measured in server UTC (not gameable). The win-screen button is always visible; it is greyed out with a countdown timer while the cooldown is active.
- **Attribution is anonymous everywhere** except the admin-only `/scheduled-verses` view (the single exception, gated to `ADMIN_EMAIL` in `src/lib/server/admin.ts`), which surfaces submitter email for moderation.
### Authentication (`src/lib/server/auth.ts`)
- Token: base64url-encoded random bytes; stored as a SHA-256 hash in the DB. Cookie name: `auth-session`.
- Anonymous users are identified by a client-generated UUID in `localStorage`. On sign-up, `migrateAnonymousStats()` re-attributes the user's `dailyCompletions` rows from the anonymous ID to the new user ID (duplicates for overlapping dates are dropped).
- Apple Sign-In (`src/lib/server/apple-auth.ts`) and Google Sign-In (`src/lib/server/google-auth.ts`) are supported; the SvelteKit CSRF config trusts `https://appleid.apple.com` for the cross-origin `form_post` callback.
## Routes
### Pages
| Route | Description |
| --- | --- |
| `/` | Main game (classic mode). Verse display, search input, guesses table, win screen, streak/percentile. `+page.ts` sets `ssr = false` so the load runs client-side with the true local date, then POSTs that date to `/api/daily-verse`. |
| `/imposter` | Imposter Mode — four verses are shown; three come from one book and one from a different book. Pick the one that doesn't belong. |
| `/random` | Debug page showing a random verse from the NKJV. |
| `/greek-random` | Debug page showing a random verse in parallel Greek (1904) / English (NKJV). |
| `/similarity` | Search a sentence and return the most similar Bible verses via the (currently disabled) embeddings model. |
| `/about` | About page with the project's backstory and social links. |
| `/global` | Slim public community-stats widget: all-time finishes/players, weekly/monthly players, yesterday's finishes + average guesses, and a 30-day finish calendar. Reads the latest daily snapshot; no retention/churn/signup data. |
| `/progress` | Personal progress page (requires auth): activity calendar, 66-book grid with mastery tiers, insights, and achievements/milestones. |
| `/stats` | Personal stats page (requires auth); returns `requiresAuth: true` for unauthenticated visitors and renders a sign-in modal. |
| `/dev` | Local-time / countdown debug page. |
| `/scheduled-verses` | Admin-only (gated to `ADMIN_EMAIL` in `src/lib/server/admin.ts`). Full historical + future log of `verseSubmissions` joined to `dailyVerses` and `user`, sorted by scheduled date. The sole surface where submitter identity is shown. Not linked from the UI. |
| `/admin/stats` | Admin-only private **Growth Console** (gated to `ADMIN_EMAIL`). Once-daily, point-in-time snapshot; date navigator, “Mature this view”, editable thresholds, Pulse, Growth Loop, Retention, Verse Mix, Habit, Signals and Glossary. Set `?date=YYYY-MM-DD`; `?mature=1` recomputes old cohorts using later data. |
### API Endpoints
| Endpoint | Description |
| --- | --- |
| `POST /api/daily-verse` | Fetch (and cache) the verse for a given `YYYY-MM-DD` date. Also records a deduped `verse_served` event for the supplied `anonymousId` (started→finished funnel). |
| `POST /api/events` | Fire-and-forget analytics sink. Allowlisted names: `verse_served`, `share`, `share_copy`, `first_visit`, `donate_click`, `discord_click`; `userId` resolved from the session. Always returns 204. |
| `POST /api/cron/build-stats` | Cron-only (bearer `CRON_SECRET`). Builds yesterday's snapshot (`America/New_York`) and posts the digest to `DISCORD_ADMIN_WEBHOOK`. |
| `POST /api/admin/rebuild-stats` | Admin-only. Rebuilds one snapshot: `{ date: 'YYYY-MM-DD' }`. |
| `POST /api/submit-completion` | Submit a game result (`anonymousId`, `date`, `guessCount`, `guesses`); returns solve rank, guess rank, total solves, average guesses, ties, and percentile. Unique on `(anonymousId, date)`. |
| `GET /api/streak?anonymousId=X&localDate=Y` | Current streak: walks backwards from the client's local date through completed dates, counting consecutive days. Single-day streaks are reported as 0 (minimum displayed streak is 2). |
| `GET /api/streak-percentile?streak=N&localDate=Y` | Streak percentile ranking computed across all players' current streaks. |
| `GET /api/stats` | Aggregated stats used by the `/global` dashboard. |
| `GET /api/imposter` | Generates a four-verse imposter-mode round. |
| `POST /api/similar-verses` | Semantic verse search via embeddings. |
| `POST /api/send-daily-verse` | Cron-only (bearer `CRON_SECRET`); posts today's verse to the Discord webhook. |
| `POST /api/dev/seed-history` | Dev seeding helper. |
| `POST /api/submit-verse` | Auth required. Accept `{ bookId, chapter, verse, localDate }`; runs the solved-today gate, 7-day cooldown, structural validation, and the assign-at-submit scheduling scan; returns `{ scheduledDate, reference, windowText }`. |
| `GET /api/submit-verse/status?localDate=YYYY-MM-DD` | Auth required. Win-screen button state: `canSubmit`, `cooldownEndsAt`, `lastSubmission`, and this user's not-yet-reached upcoming submissions. |
| `GET /api/bible/structure` | Public. 66-book verse counts per chapter (cascading-dropdown payload, cached indefinitely). |
| `GET /api/verse-window?bookId=gen&chapter=1&verse=1` | Public. Live 3-verse preview (fall-forward window) for the submit selector. |
### Other Endpoints
- `GET /feed.xml` — RSS feed of daily verses.
- `GET /sitemap.xml` — XML sitemap for SEO.
## Critical: Date/Time Handling
Bibdle is played across many timezones. The verse shown must always be the verse for the calendar date at **the player's location** — never the server's timezone, never UTC.
- The client computes today's date with `new Date().toLocaleDateString("en-CA")` (`YYYY-MM-DD`) and sends it to the server.
- Server-side date arithmetic always uses UTC methods on the client-provided date string (`new Date(dateStr + 'T00:00:00Z')` + `setUTCDate`/`getUTCDate`) to avoid timezone drift — see `/api/streak` and `/api/send-daily-verse`.
- `/` has `ssr = false` so the load runs client-side with the real local date.
- The main page also reloads itself if the tab regains focus on a new calendar day.
- The user's local date is never placed in the URL; it is only ever sent to API routes.
### Streak Calculation
A streak counts consecutive calendar days (in the player's local timezone) on which the puzzle was completed:
- The client passes `localDate`; the server never uses its own clock.
- `/api/streak` walks backwards from `localDate` through `dailyCompletions`, counting each completed day; stops at the first missing day. It's called from the win screen, so today is typically completed. Single-day streaks are reported as `0` — the minimum displayed streak is 2.
- `/api/streak-percentile` (which ranks all players) anchors on today-if-played-else-yesterday, so a player's streak isn't zeroed mid-day before they've had a chance to complete today's puzzle.
## Key Files
| File | Purpose |
| --- | --- |
| `src/routes/+page.svelte` | Main game UI and client-side logic |
| `src/routes/+page.server.ts` / `+page.ts` | Server load (user/session) + client load (`ssr: false`, fetches the daily verse) |
| `src/routes/+layout.svelte` | App shell, title animation, theme toggle, analytics injection |
| `src/lib/server/auth.ts` | Session management, password hashing, anonymous→user migration |
| `src/lib/server/apple-auth.ts`, `google-auth.ts` | OAuth providers |
| `src/lib/server/daily-verse.ts` | Per-date verse caching/lookup |
| `src/lib/server/xml-bible.ts` | Local XML Bible parsing (NKJV / Greek / Swedish) |
| `src/lib/server/bible-api.ts` | Random verse fetching on top of the XML parser |
| `src/lib/server/bible.ts` | Bible book utility functions |
| `src/lib/server/milestones.ts` | Achievement/milestone calculation (set-completion, streak, etc.) |
| `src/lib/server/admin.ts` | `ADMIN_EMAIL` constant for the `/scheduled-verses` admin route. |
| `src/lib/server/verse-submission.ts` | Window composer + scheduling scan for community verse submissions. |
| `src/lib/components/SubmitVerse.svelte` | Win-screen submit button (logged-out sign-in dropdown / cooldown + countdown / cascading selects + preview + submit). |
| `src/lib/types/bible.ts` | 66-book metadata and TypeScript types |
| `src/lib/utils/game.ts` | Guess evaluation and grading |
| `src/lib/utils/share.ts` | Share grid/text generation |
| `src/lib/utils/streak.ts`, `stats-client.ts`, `stats.ts` | Client-side streak/stats fetching and formatting |
| `src/lib/stores/game-persistence.svelte.ts` | Reactive localStorage-backed game state |
| `src/lib/server/db/schema.ts` | Drizzle ORM schema |
| `src/hooks.server.ts` | Session validation hook; (commented-out) embeddings init |
| `tests/` | Bun test suites: timezone, game, bible, stats, share, sign-in migration, and `stats-*` (metrics, segments, settings, events, signals, snapshot, digest) |
| `src/lib/server/stats/*` | Statistics engine: `metrics.ts`, `segments.ts`, `snapshot.ts`, `signals.ts`, `settings.ts`, `events.ts`, `digest.ts`, `dates.ts`. |
| `src/lib/components/stats/*` | Growth Console UI (Pulse, Growth Loop, Retention/Verse Mix/Habit labs, Signals, Settings, Glossary). |
| `src/lib/utils/analytics.ts` | Client event helper (`track`, anonymous ID, first-visit capture). |
## Deployment
Production uses `@sveltejs/adapter-node` run under Bun via a systemd service. `deploy.sh` pulls latest, installs deps, builds, and restarts `bibdle.service` (which runs `bun --bun build/index.js` on port 5173 with `DATABASE_URL=prod.db`). See `bibdle.service` for the unit file.
## Background
Bibdle was created as a small, daily nudge to read the Bible — inspired by the Wordle story of a personal project that grew organically through word of mouth. The full backstory lives on the `/about` page.
+385
View File
@@ -0,0 +1,385 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<svg
width="680"
viewBox="0 0 680 520"
version="1.1"
id="svg41"
sodipodi:docname="bibdle_logo.svg"
inkscape:version="1.4 (e7c3feb1, 2024-10-09)"
xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
xmlns="http://www.w3.org/2000/svg"
xmlns:svg="http://www.w3.org/2000/svg">
<sodipodi:namedview
id="namedview41"
pagecolor="#ffffff"
bordercolor="#000000"
borderopacity="0.25"
inkscape:showpageshadow="2"
inkscape:pageopacity="0.0"
inkscape:pagecheckerboard="0"
inkscape:deskcolor="#d1d1d1"
showgrid="true"
inkscape:zoom="0.91550428"
inkscape:cx="321.68064"
inkscape:cy="144.18283"
inkscape:window-width="1512"
inkscape:window-height="921"
inkscape:window-x="0"
inkscape:window-y="33"
inkscape:window-maximized="1"
inkscape:current-layer="svg41">
<inkscape:grid
id="grid41"
units="px"
originx="0"
originy="0"
spacingx="1"
spacingy="1"
empcolor="#0099e5"
empopacity="0.30196078"
color="#0099e5"
opacity="0.14901961"
empspacing="5"
enabled="true"
visible="true" />
</sodipodi:namedview>
<defs
id="defs32">
<linearGradient
id="bgSq"
x1="0"
y1="0"
x2="0"
y2="1">
<stop
offset="0%"
stop-color="rgb(110,154,202)"
id="stop1" />
<stop
offset="3.23%"
stop-color="rgb(111,155,203)"
id="stop2" />
<stop
offset="6.45%"
stop-color="rgb(112,156,203)"
id="stop3" />
<stop
offset="9.68%"
stop-color="rgb(114,158,204)"
id="stop4" />
<stop
offset="12.9%"
stop-color="rgb(115,159,205)"
id="stop5" />
<stop
offset="16.13%"
stop-color="rgb(116,160,205)"
id="stop6" />
<stop
offset="19.35%"
stop-color="rgb(118,162,206)"
id="stop7" />
<stop
offset="22.58%"
stop-color="rgb(119,163,207)"
id="stop8" />
<stop
offset="25.81%"
stop-color="rgb(121,165,208)"
id="stop9" />
<stop
offset="29.03%"
stop-color="rgb(123,167,209)"
id="stop10" />
<stop
offset="32.26%"
stop-color="rgb(125,168,210)"
id="stop11" />
<stop
offset="35.48%"
stop-color="rgb(127,170,211)"
id="stop12" />
<stop
offset="38.71%"
stop-color="rgb(130,172,212)"
id="stop13" />
<stop
offset="41.94%"
stop-color="rgb(132,175,213)"
id="stop14" />
<stop
offset="45.16%"
stop-color="rgb(135,177,214)"
id="stop15" />
<stop
offset="48.39%"
stop-color="rgb(138,180,215)"
id="stop16" />
<stop
offset="51.61%"
stop-color="rgb(141,182,216)"
id="stop17" />
<stop
offset="54.84%"
stop-color="rgb(145,185,218)"
id="stop18" />
<stop
offset="58.06%"
stop-color="rgb(149,188,219)"
id="stop19" />
<stop
offset="61.29%"
stop-color="rgb(153,191,220)"
id="stop20" />
<stop
offset="64.52%"
stop-color="rgb(158,195,222)"
id="stop21" />
<stop
offset="67.74%"
stop-color="rgb(163,198,223)"
id="stop22" />
<stop
offset="70.97%"
stop-color="rgb(169,202,224)"
id="stop23" />
<stop
offset="74.19%"
stop-color="rgb(174,206,226)"
id="stop24" />
<stop
offset="77.42%"
stop-color="rgb(181,209,227)"
id="stop25" />
<stop
offset="80.65%"
stop-color="rgb(188,213,228)"
id="stop26" />
<stop
offset="83.87%"
stop-color="rgb(195,217,229)"
id="stop27" />
<stop
offset="87.1%"
stop-color="rgb(203,221,230)"
id="stop28" />
<stop
offset="90.32%"
stop-color="rgb(210,225,230)"
id="stop29" />
<stop
offset="93.55%"
stop-color="rgb(218,228,229)"
id="stop30" />
<stop
offset="96.77%"
stop-color="rgb(224,230,227)"
id="stop31" />
<stop
offset="100%"
stop-color="rgb(227,228,223)"
id="stop32" />
</linearGradient>
<clipPath
id="sqClip">
<rect
x="40"
y="40"
width="260"
height="260"
rx="44"
id="rect32" />
</clipPath>
<clipPath
id="ciClip">
<circle
cx="510"
cy="170"
r="130"
id="circle32" />
</clipPath>
<clipPath
id="sqClip-9">
<rect
x="40"
y="40"
width="260"
height="260"
rx="44"
id="rect32-8" />
</clipPath>
<clipPath
id="clipPath1">
<rect
x="40"
y="40"
width="260"
height="260"
rx="44"
id="rect1" />
</clipPath>
<clipPath
id="clipPath2">
<rect
x="40"
y="40"
width="260"
height="260"
rx="44"
id="rect2" />
</clipPath>
<clipPath
id="clipPath3">
<rect
x="40"
y="40"
width="260"
height="260"
rx="44"
id="rect3" />
</clipPath>
<clipPath
id="sqClip-9-1">
<rect
x="40"
y="40"
width="260"
height="260"
rx="44"
id="rect32-8-7" />
</clipPath>
<clipPath
id="clipPath1-1">
<rect
x="40"
y="40"
width="260"
height="260"
rx="44"
id="rect1-8" />
</clipPath>
<clipPath
id="clipPath2-7">
<rect
x="40"
y="40"
width="260"
height="260"
rx="44"
id="rect2-8" />
</clipPath>
<clipPath
id="clipPath3-7">
<rect
x="40"
y="40"
width="260"
height="260"
rx="44"
id="rect3-7" />
</clipPath>
</defs>
<!-- Rounded square (favicon / app icon) -->
<rect
x="40"
y="40"
width="260"
height="260"
rx="44"
fill="url(#bgSq)"
id="rect33"
inkscape:export-filename="../Coding/bibdle/static/favicon.png"
inkscape:export-xdpi="23.63077"
inkscape:export-ydpi="23.63077" />
<!-- Circle (Discord server icon) -->
<circle
cx="510"
cy="170"
r="130"
fill="url(#bgSq)"
id="circle37"
inkscape:export-filename="../Coding/bibdle/static/bibdle-logo-circle.png"
inkscape:export-xdpi="378.09232"
inkscape:export-ydpi="378.09232" />
<rect
x="152"
y="78"
width="36"
height="184"
rx="5"
fill="#ffffff"
clip-path="url(#sqClip-9)"
id="rect34-6"
transform="matrix(0.89748134,0,0,1,357.18847,2.5366858)" />
<rect
x="128"
y="88"
width="84"
height="26"
rx="5"
fill="#ffffff"
clip-path="url(#sqClip-9)"
id="rect35-5"
transform="matrix(1,0,0,0.80796134,339.90604,30.104693)" />
<rect
x="96"
y="140"
width="148"
height="30"
rx="5"
fill="#ffffff"
clip-path="url(#sqClip-9)"
id="rect36-7"
transform="matrix(1,0,0,0.82878095,339.90604,26.507353)" />
<rect
x="128"
y="210"
width="84"
height="20"
rx="4"
fill="#ffffff"
clip-path="url(#sqClip-9)"
transform="rotate(15,330.33996,1512.3487)"
id="rect37-6" />
<rect
x="152"
y="78"
width="36"
height="184"
rx="5"
fill="#ffffff"
clip-path="url(#sqClip-9-1)"
id="rect34-6-4"
transform="matrix(0.89748134,0,0,1,17.264653,0.15299483)" />
<rect
x="128"
y="88"
width="84"
height="26"
rx="5"
fill="#ffffff"
clip-path="url(#sqClip-9-1)"
id="rect35-5-4"
transform="matrix(1,0,0,0.80796134,0.28036275,27.721002)" />
<rect
x="96"
y="140"
width="148"
height="30"
rx="5"
fill="#ffffff"
clip-path="url(#sqClip-9-1)"
id="rect36-7-9"
transform="matrix(1,0,0,0.82878095,-0.01777671,24.123662)" />
<rect
x="128"
y="210"
width="84"
height="20"
rx="4"
fill="#ffffff"
clip-path="url(#sqClip-9-1)"
transform="rotate(15,169.4311,220.168)"
id="rect37-6-1" />
</svg>

After

Width:  |  Height:  |  Size: 8.6 KiB

+1096 -7
View File
File diff suppressed because it is too large. Load diff
+3
View File
@@ -0,0 +1,3 @@
ALTER TABLE `daily_completions` ADD `guesses` text;--> statement-breakpoint
ALTER TABLE `user` ADD `google_id` text;--> statement-breakpoint
CREATE UNIQUE INDEX `user_google_id_unique` ON `user` (`google_id`);
+31
View File
@@ -0,0 +1,31 @@
CREATE TABLE `analytics_events` (
`id` text PRIMARY KEY NOT NULL,
`name` text NOT NULL,
`anonymous_id` text,
`user_id` text,
`date` text,
`created_at` integer NOT NULL,
`metadata` text,
FOREIGN KEY (`user_id`) REFERENCES `user`(`id`) ON UPDATE no action ON DELETE set null
);
--> statement-breakpoint
CREATE INDEX `analytics_events_name_date_idx` ON `analytics_events` (`name`,`date`);--> statement-breakpoint
CREATE INDEX `analytics_events_anonymous_id_date_idx` ON `analytics_events` (`anonymous_id`,`date`);--> statement-breakpoint
CREATE UNIQUE INDEX `analytics_events_serve_unique` ON `analytics_events` (`name`,`anonymous_id`,`date`) WHERE "analytics_events"."name" = 'verse_served';--> statement-breakpoint
CREATE TABLE `dashboard_settings` (
`key` text PRIMARY KEY NOT NULL,
`value` text NOT NULL,
`updated_at` integer NOT NULL
);
--> statement-breakpoint
CREATE TABLE `stats_snapshot` (
`date` text PRIMARY KEY NOT NULL,
`generated_at` integer NOT NULL,
`build_kind` text NOT NULL,
`config_version` text NOT NULL,
`payload` text NOT NULL,
`player_state` text,
`config` text NOT NULL
);
--> statement-breakpoint
ALTER TABLE `user` ADD `created_at` integer;
+384
View File
@@ -0,0 +1,384 @@
{
"version": "6",
"dialect": "sqlite",
"id": "80883fb9-70cd-4fa5-b228-36358ffc4c40",
"prevId": "f3a47f60-540b-4d95-8c23-b1f68506b3ed",
"tables": {
"daily_completions": {
"name": "daily_completions",
"columns": {
"id": {
"name": "id",
"type": "text",
"primaryKey": true,
"notNull": true,
"autoincrement": false
},
"anonymous_id": {
"name": "anonymous_id",
"type": "text",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"date": {
"name": "date",
"type": "text",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"guess_count": {
"name": "guess_count",
"type": "integer",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"guesses": {
"name": "guesses",
"type": "text",
"primaryKey": false,
"notNull": false,
"autoincrement": false
},
"completed_at": {
"name": "completed_at",
"type": "integer",
"primaryKey": false,
"notNull": true,
"autoincrement": false
}
},
"indexes": {
"anonymous_id_date_idx": {
"name": "anonymous_id_date_idx",
"columns": [
"anonymous_id",
"date"
],
"isUnique": false
},
"date_idx": {
"name": "date_idx",
"columns": [
"date"
],
"isUnique": false
},
"date_guess_idx": {
"name": "date_guess_idx",
"columns": [
"date",
"guess_count"
],
"isUnique": false
},
"daily_completions_anonymous_id_date_unique": {
"name": "daily_completions_anonymous_id_date_unique",
"columns": [
"anonymous_id",
"date"
],
"isUnique": true
}
},
"foreignKeys": {},
"compositePrimaryKeys": {},
"uniqueConstraints": {},
"checkConstraints": {}
},
"daily_verses": {
"name": "daily_verses",
"columns": {
"id": {
"name": "id",
"type": "text",
"primaryKey": true,
"notNull": true,
"autoincrement": false
},
"date": {
"name": "date",
"type": "text",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"book_id": {
"name": "book_id",
"type": "text",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"verse_text": {
"name": "verse_text",
"type": "text",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"reference": {
"name": "reference",
"type": "text",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"created_at": {
"name": "created_at",
"type": "integer",
"primaryKey": false,
"notNull": false,
"autoincrement": false
}
},
"indexes": {
"daily_verses_date_unique": {
"name": "daily_verses_date_unique",
"columns": [
"date"
],
"isUnique": true
}
},
"foreignKeys": {},
"compositePrimaryKeys": {},
"uniqueConstraints": {},
"checkConstraints": {}
},
"session": {
"name": "session",
"columns": {
"id": {
"name": "id",
"type": "text",
"primaryKey": true,
"notNull": true,
"autoincrement": false
},
"user_id": {
"name": "user_id",
"type": "text",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"expires_at": {
"name": "expires_at",
"type": "integer",
"primaryKey": false,
"notNull": true,
"autoincrement": false
}
},
"indexes": {},
"foreignKeys": {
"session_user_id_user_id_fk": {
"name": "session_user_id_user_id_fk",
"tableFrom": "session",
"tableTo": "user",
"columnsFrom": [
"user_id"
],
"columnsTo": [
"id"
],
"onDelete": "no action",
"onUpdate": "no action"
}
},
"compositePrimaryKeys": {},
"uniqueConstraints": {},
"checkConstraints": {}
},
"user": {
"name": "user",
"columns": {
"id": {
"name": "id",
"type": "text",
"primaryKey": true,
"notNull": true,
"autoincrement": false
},
"first_name": {
"name": "first_name",
"type": "text",
"primaryKey": false,
"notNull": false,
"autoincrement": false
},
"last_name": {
"name": "last_name",
"type": "text",
"primaryKey": false,
"notNull": false,
"autoincrement": false
},
"email": {
"name": "email",
"type": "text",
"primaryKey": false,
"notNull": false,
"autoincrement": false
},
"password_hash": {
"name": "password_hash",
"type": "text",
"primaryKey": false,
"notNull": false,
"autoincrement": false
},
"apple_id": {
"name": "apple_id",
"type": "text",
"primaryKey": false,
"notNull": false,
"autoincrement": false
},
"google_id": {
"name": "google_id",
"type": "text",
"primaryKey": false,
"notNull": false,
"autoincrement": false
},
"is_private": {
"name": "is_private",
"type": "integer",
"primaryKey": false,
"notNull": false,
"autoincrement": false,
"default": false
}
},
"indexes": {
"user_email_unique": {
"name": "user_email_unique",
"columns": [
"email"
],
"isUnique": true
},
"user_apple_id_unique": {
"name": "user_apple_id_unique",
"columns": [
"apple_id"
],
"isUnique": true
},
"user_google_id_unique": {
"name": "user_google_id_unique",
"columns": [
"google_id"
],
"isUnique": true
}
},
"foreignKeys": {},
"compositePrimaryKeys": {},
"uniqueConstraints": {},
"checkConstraints": {}
},
"verse_submissions": {
"name": "verse_submissions",
"columns": {
"id": {
"name": "id",
"type": "text",
"primaryKey": true,
"notNull": true,
"autoincrement": false
},
"user_id": {
"name": "user_id",
"type": "text",
"primaryKey": false,
"notNull": false,
"autoincrement": false
},
"scheduled_date": {
"name": "scheduled_date",
"type": "text",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"selected_book_id": {
"name": "selected_book_id",
"type": "text",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"selected_chapter": {
"name": "selected_chapter",
"type": "integer",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"selected_verse": {
"name": "selected_verse",
"type": "integer",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"submitted_at": {
"name": "submitted_at",
"type": "integer",
"primaryKey": false,
"notNull": true,
"autoincrement": false
}
},
"indexes": {
"verse_submissions_scheduled_date_unique": {
"name": "verse_submissions_scheduled_date_unique",
"columns": [
"scheduled_date"
],
"isUnique": true
},
"verse_submissions_user_id_idx": {
"name": "verse_submissions_user_id_idx",
"columns": [
"user_id"
],
"isUnique": false
}
},
"foreignKeys": {
"verse_submissions_user_id_user_id_fk": {
"name": "verse_submissions_user_id_user_id_fk",
"tableFrom": "verse_submissions",
"tableTo": "user",
"columnsFrom": [
"user_id"
],
"columnsTo": [
"id"
],
"onDelete": "set null",
"onUpdate": "no action"
}
},
"compositePrimaryKeys": {},
"uniqueConstraints": {},
"checkConstraints": {}
}
},
"views": {},
"enums": {},
"_meta": {
"schemas": {},
"tables": {},
"columns": {}
},
"internal": {
"indexes": {}
}
}
+581
View File
@@ -0,0 +1,581 @@
{
"version": "6",
"dialect": "sqlite",
"id": "6b6e3771-d705-4bbb-9b36-97f4f402fc5d",
"prevId": "80883fb9-70cd-4fa5-b228-36358ffc4c40",
"tables": {
"analytics_events": {
"name": "analytics_events",
"columns": {
"id": {
"name": "id",
"type": "text",
"primaryKey": true,
"notNull": true,
"autoincrement": false
},
"name": {
"name": "name",
"type": "text",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"anonymous_id": {
"name": "anonymous_id",
"type": "text",
"primaryKey": false,
"notNull": false,
"autoincrement": false
},
"user_id": {
"name": "user_id",
"type": "text",
"primaryKey": false,
"notNull": false,
"autoincrement": false
},
"date": {
"name": "date",
"type": "text",
"primaryKey": false,
"notNull": false,
"autoincrement": false
},
"created_at": {
"name": "created_at",
"type": "integer",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"metadata": {
"name": "metadata",
"type": "text",
"primaryKey": false,
"notNull": false,
"autoincrement": false
}
},
"indexes": {
"analytics_events_name_date_idx": {
"name": "analytics_events_name_date_idx",
"columns": [
"name",
"date"
],
"isUnique": false
},
"analytics_events_anonymous_id_date_idx": {
"name": "analytics_events_anonymous_id_date_idx",
"columns": [
"anonymous_id",
"date"
],
"isUnique": false
},
"analytics_events_serve_unique": {
"name": "analytics_events_serve_unique",
"columns": [
"name",
"anonymous_id",
"date"
],
"isUnique": true,
"where": "\"analytics_events\".\"name\" = 'verse_served'"
}
},
"foreignKeys": {
"analytics_events_user_id_user_id_fk": {
"name": "analytics_events_user_id_user_id_fk",
"tableFrom": "analytics_events",
"tableTo": "user",
"columnsFrom": [
"user_id"
],
"columnsTo": [
"id"
],
"onDelete": "set null",
"onUpdate": "no action"
}
},
"compositePrimaryKeys": {},
"uniqueConstraints": {},
"checkConstraints": {}
},
"daily_completions": {
"name": "daily_completions",
"columns": {
"id": {
"name": "id",
"type": "text",
"primaryKey": true,
"notNull": true,
"autoincrement": false
},
"anonymous_id": {
"name": "anonymous_id",
"type": "text",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"date": {
"name": "date",
"type": "text",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"guess_count": {
"name": "guess_count",
"type": "integer",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"guesses": {
"name": "guesses",
"type": "text",
"primaryKey": false,
"notNull": false,
"autoincrement": false
},
"completed_at": {
"name": "completed_at",
"type": "integer",
"primaryKey": false,
"notNull": true,
"autoincrement": false
}
},
"indexes": {
"anonymous_id_date_idx": {
"name": "anonymous_id_date_idx",
"columns": [
"anonymous_id",
"date"
],
"isUnique": false
},
"date_idx": {
"name": "date_idx",
"columns": [
"date"
],
"isUnique": false
},
"date_guess_idx": {
"name": "date_guess_idx",
"columns": [
"date",
"guess_count"
],
"isUnique": false
},
"daily_completions_anonymous_id_date_unique": {
"name": "daily_completions_anonymous_id_date_unique",
"columns": [
"anonymous_id",
"date"
],
"isUnique": true
}
},
"foreignKeys": {},
"compositePrimaryKeys": {},
"uniqueConstraints": {},
"checkConstraints": {}
},
"daily_verses": {
"name": "daily_verses",
"columns": {
"id": {
"name": "id",
"type": "text",
"primaryKey": true,
"notNull": true,
"autoincrement": false
},
"date": {
"name": "date",
"type": "text",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"book_id": {
"name": "book_id",
"type": "text",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"verse_text": {
"name": "verse_text",
"type": "text",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"reference": {
"name": "reference",
"type": "text",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"created_at": {
"name": "created_at",
"type": "integer",
"primaryKey": false,
"notNull": false,
"autoincrement": false
}
},
"indexes": {
"daily_verses_date_unique": {
"name": "daily_verses_date_unique",
"columns": [
"date"
],
"isUnique": true
}
},
"foreignKeys": {},
"compositePrimaryKeys": {},
"uniqueConstraints": {},
"checkConstraints": {}
},
"dashboard_settings": {
"name": "dashboard_settings",
"columns": {
"key": {
"name": "key",
"type": "text",
"primaryKey": true,
"notNull": true,
"autoincrement": false
},
"value": {
"name": "value",
"type": "text",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"updated_at": {
"name": "updated_at",
"type": "integer",
"primaryKey": false,
"notNull": true,
"autoincrement": false
}
},
"indexes": {},
"foreignKeys": {},
"compositePrimaryKeys": {},
"uniqueConstraints": {},
"checkConstraints": {}
},
"session": {
"name": "session",
"columns": {
"id": {
"name": "id",
"type": "text",
"primaryKey": true,
"notNull": true,
"autoincrement": false
},
"user_id": {
"name": "user_id",
"type": "text",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"expires_at": {
"name": "expires_at",
"type": "integer",
"primaryKey": false,
"notNull": true,
"autoincrement": false
}
},
"indexes": {},
"foreignKeys": {
"session_user_id_user_id_fk": {
"name": "session_user_id_user_id_fk",
"tableFrom": "session",
"tableTo": "user",
"columnsFrom": [
"user_id"
],
"columnsTo": [
"id"
],
"onDelete": "no action",
"onUpdate": "no action"
}
},
"compositePrimaryKeys": {},
"uniqueConstraints": {},
"checkConstraints": {}
},
"stats_snapshot": {
"name": "stats_snapshot",
"columns": {
"date": {
"name": "date",
"type": "text",
"primaryKey": true,
"notNull": true,
"autoincrement": false
},
"generated_at": {
"name": "generated_at",
"type": "integer",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"build_kind": {
"name": "build_kind",
"type": "text",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"config_version": {
"name": "config_version",
"type": "text",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"payload": {
"name": "payload",
"type": "text",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"player_state": {
"name": "player_state",
"type": "text",
"primaryKey": false,
"notNull": false,
"autoincrement": false
},
"config": {
"name": "config",
"type": "text",
"primaryKey": false,
"notNull": true,
"autoincrement": false
}
},
"indexes": {},
"foreignKeys": {},
"compositePrimaryKeys": {},
"uniqueConstraints": {},
"checkConstraints": {}
},
"user": {
"name": "user",
"columns": {
"id": {
"name": "id",
"type": "text",
"primaryKey": true,
"notNull": true,
"autoincrement": false
},
"first_name": {
"name": "first_name",
"type": "text",
"primaryKey": false,
"notNull": false,
"autoincrement": false
},
"last_name": {
"name": "last_name",
"type": "text",
"primaryKey": false,
"notNull": false,
"autoincrement": false
},
"email": {
"name": "email",
"type": "text",
"primaryKey": false,
"notNull": false,
"autoincrement": false
},
"password_hash": {
"name": "password_hash",
"type": "text",
"primaryKey": false,
"notNull": false,
"autoincrement": false
},
"apple_id": {
"name": "apple_id",
"type": "text",
"primaryKey": false,
"notNull": false,
"autoincrement": false
},
"google_id": {
"name": "google_id",
"type": "text",
"primaryKey": false,
"notNull": false,
"autoincrement": false
},
"is_private": {
"name": "is_private",
"type": "integer",
"primaryKey": false,
"notNull": false,
"autoincrement": false,
"default": false
},
"created_at": {
"name": "created_at",
"type": "integer",
"primaryKey": false,
"notNull": false,
"autoincrement": false
}
},
"indexes": {
"user_email_unique": {
"name": "user_email_unique",
"columns": [
"email"
],
"isUnique": true
},
"user_apple_id_unique": {
"name": "user_apple_id_unique",
"columns": [
"apple_id"
],
"isUnique": true
},
"user_google_id_unique": {
"name": "user_google_id_unique",
"columns": [
"google_id"
],
"isUnique": true
}
},
"foreignKeys": {},
"compositePrimaryKeys": {},
"uniqueConstraints": {},
"checkConstraints": {}
},
"verse_submissions": {
"name": "verse_submissions",
"columns": {
"id": {
"name": "id",
"type": "text",
"primaryKey": true,
"notNull": true,
"autoincrement": false
},
"user_id": {
"name": "user_id",
"type": "text",
"primaryKey": false,
"notNull": false,
"autoincrement": false
},
"scheduled_date": {
"name": "scheduled_date",
"type": "text",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"selected_book_id": {
"name": "selected_book_id",
"type": "text",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"selected_chapter": {
"name": "selected_chapter",
"type": "integer",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"selected_verse": {
"name": "selected_verse",
"type": "integer",
"primaryKey": false,
"notNull": true,
"autoincrement": false
},
"submitted_at": {
"name": "submitted_at",
"type": "integer",
"primaryKey": false,
"notNull": true,
"autoincrement": false
}
},
"indexes": {
"verse_submissions_scheduled_date_unique": {
"name": "verse_submissions_scheduled_date_unique",
"columns": [
"scheduled_date"
],
"isUnique": true
},
"verse_submissions_user_id_idx": {
"name": "verse_submissions_user_id_idx",
"columns": [
"user_id"
],
"isUnique": false
}
},
"foreignKeys": {
"verse_submissions_user_id_user_id_fk": {
"name": "verse_submissions_user_id_user_id_fk",
"tableFrom": "verse_submissions",
"tableTo": "user",
"columnsFrom": [
"user_id"
],
"columnsTo": [
"id"
],
"onDelete": "set null",
"onUpdate": "no action"
}
},
"compositePrimaryKeys": {},
"uniqueConstraints": {},
"checkConstraints": {}
}
},
"views": {},
"enums": {},
"_meta": {
"schemas": {},
"tables": {},
"columns": {}
},
"internal": {
"indexes": {}
}
}
+14
View File
@@ -22,6 +22,20 @@
"when": 1770961427714, "when": 1770961427714,
"tag": "0002_outstanding_hiroim", "tag": "0002_outstanding_hiroim",
"breakpoints": true "breakpoints": true
},
{
"idx": 3,
"version": "6",
"when": 1774416309647,
"tag": "0003_overjoyed_mindworm",
"breakpoints": true
},
{
"idx": 4,
"version": "6",
"when": 1789505566968,
"tag": "0004_slim_nomad",
"breakpoints": true
} }
] ]
} }
+87
View File
@@ -0,0 +1,87 @@
#!/bin/bash
# Export all daily verses to JSON
# Usage: ./export-verses.sh [path/to/database.db] [output.json]
DB="${1:-./local.db}"
OUT="${2:-verses.json}"
sqlite3 "$DB" <<'SQL' > "$OUT"
.mode json
SELECT
CASE book_id
WHEN 'GEN' THEN 'Genesis'
WHEN 'EXO' THEN 'Exodus'
WHEN 'LEV' THEN 'Leviticus'
WHEN 'NUM' THEN 'Numbers'
WHEN 'DEU' THEN 'Deuteronomy'
WHEN 'JOS' THEN 'Joshua'
WHEN 'JDG' THEN 'Judges'
WHEN 'RUT' THEN 'Ruth'
WHEN '1SA' THEN '1 Samuel'
WHEN '2SA' THEN '2 Samuel'
WHEN '1KI' THEN '1 Kings'
WHEN '2KI' THEN '2 Kings'
WHEN '1CH' THEN '1 Chronicles'
WHEN '2CH' THEN '2 Chronicles'
WHEN 'EZR' THEN 'Ezra'
WHEN 'NEH' THEN 'Nehemiah'
WHEN 'EST' THEN 'Esther'
WHEN 'JOB' THEN 'Job'
WHEN 'PSA' THEN 'Psalms'
WHEN 'PRO' THEN 'Proverbs'
WHEN 'ECC' THEN 'Ecclesiastes'
WHEN 'SNG' THEN 'Song of Solomon'
WHEN 'ISA' THEN 'Isaiah'
WHEN 'JER' THEN 'Jeremiah'
WHEN 'LAM' THEN 'Lamentations'
WHEN 'EZK' THEN 'Ezekiel'
WHEN 'DAN' THEN 'Daniel'
WHEN 'HOS' THEN 'Hosea'
WHEN 'JOL' THEN 'Joel'
WHEN 'AMO' THEN 'Amos'
WHEN 'OBA' THEN 'Obadiah'
WHEN 'JON' THEN 'Jonah'
WHEN 'MIC' THEN 'Micah'
WHEN 'NAM' THEN 'Nahum'
WHEN 'HAB' THEN 'Habakkuk'
WHEN 'ZEP' THEN 'Zephaniah'
WHEN 'HAG' THEN 'Haggai'
WHEN 'ZEC' THEN 'Zechariah'
WHEN 'MAL' THEN 'Malachi'
WHEN 'MAT' THEN 'Matthew'
WHEN 'MRK' THEN 'Mark'
WHEN 'LUK' THEN 'Luke'
WHEN 'JHN' THEN 'John'
WHEN 'ACT' THEN 'Acts'
WHEN 'ROM' THEN 'Romans'
WHEN '1CO' THEN '1 Corinthians'
WHEN '2CO' THEN '2 Corinthians'
WHEN 'GAL' THEN 'Galatians'
WHEN 'EPH' THEN 'Ephesians'
WHEN 'PHP' THEN 'Philippians'
WHEN 'COL' THEN 'Colossians'
WHEN '1TH' THEN '1 Thessalonians'
WHEN '2TH' THEN '2 Thessalonians'
WHEN '1TI' THEN '1 Timothy'
WHEN '2TI' THEN '2 Timothy'
WHEN 'TIT' THEN 'Titus'
WHEN 'PHM' THEN 'Philemon'
WHEN 'HEB' THEN 'Hebrews'
WHEN 'JAS' THEN 'James'
WHEN '1PE' THEN '1 Peter'
WHEN '2PE' THEN '2 Peter'
WHEN '1JN' THEN '1 John'
WHEN '2JN' THEN '2 John'
WHEN '3JN' THEN '3 John'
WHEN 'JUD' THEN 'Jude'
WHEN 'REV' THEN 'Revelation'
ELSE book_id
END AS book,
verse_text AS verse,
reference AS citation,
date
FROM daily_verses
ORDER BY date;
SQL
echo "Exported to $OUT"
+2 -1
View File
@@ -5,7 +5,7 @@
"type": "module", "type": "module",
"scripts": { "scripts": {
"dev": "bun --bun vite dev", "dev": "bun --bun vite dev",
"build": "vite build", "build": "bun --bun vite build",
"preview": "vite preview", "preview": "vite preview",
"prepare": "svelte-kit sync || echo ''", "prepare": "svelte-kit sync || echo ''",
"check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json", "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
@@ -35,6 +35,7 @@
}, },
"dependencies": { "dependencies": {
"@xenova/transformers": "^2.17.2", "@xenova/transformers": "^2.17.2",
"drizzle": "^1.4.0",
"fast-xml-parser": "^5.3.3", "fast-xml-parser": "^5.3.3",
"marked": "^17.0.4", "marked": "^17.0.4",
"xml2js": "^0.6.2" "xml2js": "^0.6.2"
+67
View File
@@ -0,0 +1,67 @@
# Community Verse Submissions — Implementation Plan
Source of truth: `spec.md`. Each step is independently verifiable and builds on the previous.
## Step 1 — Schema & migration
- Add `verse_submissions` table to `src/lib/server/db/schema.ts`:
- `id` text pk (`Bun.randomUUIDv7()`)
- `user_id` text not null, FK → `user.id` **ON DELETE SET NULL** (nullable column to allow that)
- `scheduled_date` text not null **unique**
- `selected_book_id` text not null
- `selected_chapter` integer not null
- `selected_verse` integer not null
- `submitted_at` integer not null (server UTC **millis**; raw integer, drives 7-day cooldown)
- indexes: `user_id`, unique on `scheduled_date` (the column-level unique handles this)
- `bun run db:push` to dev.db.
- Verify: `sqlite3 dev.db ".schema verse_submissions"`.
> Note: spec says `user_id` FK should be SET NULL on account deletion, so the column is **nullable** despite "not null" in the table sketch (the edge-cases section overrides: "FK should be ON DELETE SET NULL"). Resolution: make `user_id` nullable + ON DELETE SET NULL. The admin LEFT JOIN renders "(deleted user)" when null. This is the spec-intended behavior.
## Step 2 — Bible structure + windowing helpers
- Export `getChapterCount`, `getVerseCount` from `xml-bible.ts` (currently private).
- Add `composeVerseWindow(bookNumber, chapter, verse)`:
- Computes the selected verse's index `v` within the book (contiguous 1-based across chapters), `bookStart`=1, `bookEnd`=total verses in book.
- Default window `[v-2, v-1, v]`; if `v-2 < 1` fall forward to `[v, v+1, v+2]`.
- Returns `{ bookId, bookName, verses: string[], startChapter, startVerse, endChapter, endVerse, selectedVerse }` by calling `extractVerses` per chapter and concatenating for cross-chapter windows.
- Add `formatWindowReference(bookName, startChapter, startVerse, endChapter, endVerse)`: same-chapter → `Book C:S-E`; cross-chapter → `Book C1:S1–C2:E2`.
- Unit tests in `tests/verse-window.test.ts`.
## Step 3 — Public APIs
- `GET /api/bible/structure` → `[{ bookId, chapters: number[] }, ...]` for all 66 books (verse counts per chapter). Cached in-memory.
- `GET /api/verse-window?bookId=gen&chapter=1&verse=1` → `{ windowVerses, reference, bookId, selectedVerse }` via `composeVerseWindow`.
- Verify with curl.
## Step 4 — Admin module + `/scheduled-verses` page
- `src/lib/server/admin.ts` exporting `ADMIN_EMAIL = 'geohpowell@gmail.com'`.
- `src/routes/scheduled-verses/+page.server.ts`: require `locals.user?.email === ADMIN_EMAIL` else auth redirect / 403 access-denied page.
- `+page.svelte`: table joining `verse_submissions` LEFT JOIN `daily_verses` (on `scheduled_date = date`) LEFT JOIN `user` (on `user_id`), sorted by `scheduled_date` asc. Columns per spec. "(deleted user)" when user null.
- Not linked from nav. Verify by direct URL.
## Step 5 — Submit backend + lazy gap-fill
- `POST /api/submit-verse` (auth required): body `{ bookId, chapter, verse, localDate }`.
1. Require `locals.user` (401).
2. Solved-today gate: `dailyCompletions` row `(anonymousId=user.id, date=localDate)` else 403.
3. Cooldown: most recent `verse_submissions.submitted_at` for user; if `< 7d` ago → 429 `{ cooldownEndsAt }`.
4. Structural validation: bookId valid, chapter in `[1, getChapterCount]`, verse in `[1, getVerseCount]`.
5. Compute window via `composeVerseWindow`.
6. Scheduling scan: fetch all `daily_verses` with `date > today` (server UTC) ordered; walk day-by-day from tomorrow; validity = empty + no back-to-back with D-1/D+2 committed neighbors + no same-window-ref row within ±60 days (bounded lookup). Find earliest valid `D`.
7. Transaction: insert `daily_verses` `{ id, date: D, bookId, reference, verseText, createdAt: now }` + `verse_submissions` `{ id, user_id, scheduled_date: D, selected_book_id, selected_chapter, selected_verse, submitted_at: now }`. On `SQLITE_CONSTRAINT_UNIQUE` retry scan from `D+1`, up to 5 attempts.
8. Return `{ scheduledDate: D, reference, windowText }`. Emit rybbit event.
- `GET /api/submit-verse/status?localDate=YYYY-MM-DD` (auth required): `{ canSubmit, cooldownEndsAt, lastSubmission, upcoming }`.
- Modify `getVerseForDate` lazy path: re-roll `getRandomVerses()` until book differs from committed D-1 and D+1 neighbors (cap ~20 retries).
- Verify with curl end-to-end.
## Step 6 — Frontend `SubmitVerse.svelte`
- New component rendered in `WinScreen.svelte` near the progress button, sharing `.progress-btn` styling.
- States: logged-out (Apple/Google dropdown mirroring progress button), cooldown (greyed + `CountdownTimer`-style countdown to `cooldownEndsAt`), can-submit (cascading Book→Chapter→Verse `<select>`s from `/api/bible/structure`, debounced 250ms preview via `/api/verse-window`, Submit button, success confirmation with scheduled date, inline 429/403 errors).
- Pass `isLoggedIn` + `anonymousId` through (already on WinScreen props).
- Verify in browser.
## Step 7 — Tests
- `tests/verse-window.test.ts`: book-start fall-forward (Gen 1:1 → [1,2,3]), cross-chapter window, same-chapter window, end-of-book safety.
- `tests/scheduling.test.ts` (or unit-test the pure scan function against an in-memory fixture): no-back-to-back, 60-day repeat skip, earliest-valid-date selection.
- Cooldown arithmetic test.
## Step 8 — Docs
- Update `README.md` schema table (add `verse_submissions`) and routes/API tables (new endpoints + `/scheduled-verses`).
- Note `ADMIN_EMAIL` constant location.
+299
View File
@@ -0,0 +1,299 @@
# Spec: Community Verse Submissions
## TODO
- [x] **Step 1 — Schema & migration:** add `verse_submissions` table to `src/lib/server/db/schema.ts` (nullable `user_id` FK → `user.id` ON DELETE SET NULL, unique `scheduled_date`, index on `user_id`), pushed to dev.db.
- [x] **Step 2 — Bible structure + windowing helpers:** export `getChapterCount`/`getVerseCount` from `xml-bible.ts`; add `composeVerseWindow()` (fall-forward 3-verse window, never crosses book, crosses chapter within book) and `formatWindowReference()` (hyphen same-chapter, en-dash cross-chapter). Tests in `tests/verse-window.test.ts` (17 pass).
- [x] **Step 3 — Public APIs:** `GET /api/bible/structure` (66-book verse counts for cascading dropdowns) and `GET /api/verse-window` (live 3-verse preview).
- [x] **Step 4 — Admin module + `/scheduled-verses` page:** `src/lib/server/admin.ts` (`ADMIN_EMAIL`), auth-walled admin view joining `verse_submissions` → `daily_verses` → `user`.
- [x] **Step 5 — Submit backend + lazy gap-fill:** `POST /api/submit-verse` (solved-today gate, 7-day cooldown, structural validation, scheduling scan with empty/no-back-to-back/60-day-repeat rules, transaction + retry), `GET /api/submit-verse/status`, modified `getVerseForDate` neighbor avoidance.
- [x] **Step 6 — Frontend `SubmitVerse.svelte`:** three states (logged-out sign-in dropdown, cooldown + countdown, cascading selects + preview + submit), wired into `WinScreen.svelte`.
- [x] **Step 7 — Tests:** scheduling validity, cooldown arithmetic, concurrency.
- [x] **Step 8 — Docs:** update README schema + routes/API tables.
---
Let authenticated users submit a Bible verse they love. Submissions are scheduled as future "verses of the day," mixed so that **no two consecutive calendar days ever feature the same book**, and spaced so an exact 3-verse window never repeats within 60 days. Selection is dropdown-based (cascading `<select>`s) so the system can compose verses purely from existing Bible-lookup functions already in the codebase — no free-text entry, so typos are impossible and content is always canonical NKJV text.
## Goals
- A new button on the **win screen** (`WinScreen.svelte`), visually consistent with the existing "📈 See your progress" neobrutalist button.
- Logged-out users who click it get a dropdown prompting sign-in (mirroring the existing progress button's Apple/Google dropdown).
- Logged-in users get a cascading Book → Chapter → Verse selector with a live 3-verse preview.
- Each submission immediately reserves a concrete future date; the submitter is shown that date on success.
- A 7-day rolling cooldown (server UTC) gates submissions, with the button greyed out and a countdown timer shown while active.
- Attribution is **anonymous everywhere** — submissions are never credited to a user publicly.
## Non-goals (explicitly decided)
- **No giveaway-text filtering.** Verses that mention their own book/author (e.g. Eph 1:1, Isa 1:1) are allowed. The random generator already permits these.
- **No persistent pending queue / no cron.** Assignment happens at submit time, not via a background job.
- **No withdrawal / deletion / editing.** Submissions are final (references come from dropdowns, so typos are impossible).
- **No guardrail on how far out a verse is scheduled.** If the calendar is dense, a submission may land months or years in the future; this is accepted.
- **No per-user pending cap, no global cap.** The 7-day rolling cooldown is the only rate limit.
- **No attribution / leaderboard / share-text changes.** Submitter identity is recorded only for rate-limiting and the solved-today gate; it is never displayed.
- **No backfill of gap days.** Sparse future `dailyVerses` rows are fine.
---
## Data Model
### New table: `verse_submissions`
A log of who submitted what and when, plus the assigned scheduled date. The canonical verse text/reference lives in `daily_verses` (keyed by `date`); this table links a user to a scheduled date.
| Column | Type | Notes |
| --- | --- | --- |
| `id` | text (pk) | `Bun.randomUUIDv7()` |
| `user_id` | text, not null, FK → `user.id` | the submitter (never displayed) |
| `scheduled_date` | text, not null, **unique** | `YYYY-MM-DD` of the reserved `daily_verses` row |
| `selected_book_id` | text, not null | the book the user chose |
| `selected_chapter` | integer, not null | the chapter the user chose |
| `selected_verse` | integer, not null | the single verse the user chose (the "anchor") |
| `submitted_at` | integer (timestamp), not null | server UTC millis — drives the 7-day cooldown |
Indexes: `user_id` (cooldown lookup + "your upcoming verses"), `scheduled_date` (unique — one submission per scheduled date).
No `status`, `withdrawn_at`, or attribution columns. Denormalized window/verseText/reference are **not** stored here; they live on `daily_verses` and are joined by `scheduled_date`.
### `daily_verses` (unchanged schema)
Submissions simply write a new row with a future `date`, exactly as the existing lazy path does for the current day. `getVerseForDate(date)` already returns a pre-existing row if present, so a pre-written submission row for a future date is served unchanged when its day arrives.
The new behavior:
- **Submission rows** are written at submit time for a future date (the date returned by the scheduling scan).
- **Gap days** (dates with no committed row when a player arrives) are filled lazily by the existing random path — extended to respect the no-back-to-back rule (see *Lazy gap-fill* below).
---
## Verse Windowing
A submission selects **one** verse (book → chapter → verse). The displayed daily verse is a **3-verse window** anchored on that verse, for difficulty consistency with the existing game (`getRandomVerses` defaults to 3 consecutive verses).
### Window algorithm (deterministic)
Let `v` be the selected verse's index within its **book** (a contiguous 1-based index across all chapters of that book). Let `bookStart` = 1 (first verse index in the book) and `bookEnd` = last verse index in the book.
- Default window: `[v-2, v-1, v]` (the two preceding in-book verses + the selected verse).
- If `v - 2 < bookStart` (not enough preceding verses in-book — only happens at a book's very start, e.g. Gen 1:1, John 1:1): **fall forward** so the window is 3 consecutive in-book verses that still includes `v`, i.e. start = `v`, window = `[v, v+1, v+2]`. (Every Bible book has ≥3 verses after its opening, so this always succeeds.)
- The window **never crosses a book boundary**. Crossing a chapter boundary **within the same book** is allowed and expected (e.g. a window spanning the end of chapter 1 and the start of chapter 2).
This reuses existing functions: `getChapterCount`, `getVerseCount`, `extractVerses` (called per chapter; for cross-chapter windows, call `extractVerses` twice and concatenate), `getBookByNumber`/`getBookById`, and `formatReference` (extended to format cross-chapter ranges, e.g. `Genesis 1:31–2:1`; same-chapter stays `Genesis 1:1-3`).
The selected verse's **book** is the day's `bookId` (the guess target). All three displayed verses come from that same book, so the guessing game stays fair.
---
## Scheduling Algorithm (assign-at-submit)
When a submission is accepted, the server scans forward from **tomorrow** (server UTC date) to find the earliest valid candidate date `D`, then writes the `daily_verses` row for `D` immediately and records a `verse_submissions` row. The submitter is shown `D`.
### Validity checks for candidate date `D` and submission book `B`
`D` is valid iff **all** hold:
1. **Empty:** no `daily_verses` row exists at `D`.
2. **No back-to-back with prior committed neighbor:** the `daily_verses` row at `D-1` (if one exists) must have `book_id != B`.
3. **No back-to-back with next committed neighbor:** the `daily_verses` row at `D+1` (if one exists) must have `book_id != B`.
4. **60-day repeat distance:** no `daily_verses` row with the **same 3-verse window** exists whose date is within `[D-60, D+60]` days inclusive. The window identity is its canonical reference string (`book_id` + formatted `chapter:startverse-endverse`, cross-chapter-aware). This is a *soft* repeat rule: repeats are allowed, just not within ±60 days of any prior/scheduled appearance.
### Implementation note (performance)
Don't query per candidate date. Instead, fetch all `daily_verses` rows with `date > today` ordered by date into memory, then walk day-by-day from tomorrow, checking the four rules against the in-memory set + a single range query for the 60-day repeat check (windowed by reference). Historical rows (date ≤ today) only matter for rule 4; a bounded lookup (rows with the same window-ref within 60 days of `D`) suffices.
### Concurrency
The scan-then-insert is a critical section. Two concurrent submissions could both select the same `D`. Wrap insert in a transaction; on a `SQLITE_CONSTRAINT_UNIQUE` failure on `daily_verses.date` (or `verse_submissions.scheduled_date`), re-run the scan from `D+1`. Retry up to a small bound (e.g. 5). SQLite under `bun:sqlite` handles this with a transaction.
### Why this preserves no-back-to-back globally
Adjacency is only ever checked against **committed** rows (D-1, D+1). Gap days (empty between two committed rows) are filled lazily later by a random verse whose generator also respects committed neighbors (see below). So at play-time, every adjacent pair of days has been checked at write-time. The invariant is maintained inductively.
---
## Lazy Gap-Fill (modified `getVerseForDate`)
When a player opens a date with no committed `daily_verses` row, the existing random path runs — **extended** so the random verse's book differs from any committed neighbor:
- If `D-1` has a committed row with book `X`, the random book must be `!= X`.
- If `D+1` has a committed row with book `Y`, the random book must be `!= Y`.
- Re-try `getRandomVerses()` until both hold (66 books, ≤2 excluded → ~97% success per try; cap at ~20 retries, then accept). `getRandomVerses` already returns 3 consecutive in-book verses; no windowing change needed for random fillers.
Submission days are pre-written, so they skip this path entirely (`getVerseForDate` returns the existing row).
---
## Rate Limiting & Cooldown
- **One submission per user per rolling 7×24h window**, measured in **server UTC** (not gameable; smooth countdown).
- `cooldownEndsAt = lastSubmission.submitted_at + 7 days` (server UTC millis).
- The win-screen button is **always visible**; when the cooldown is active it is **greyed out and disabled**, with a small countdown timer below it (target `cooldownEndsAt`).
- Query: select the user's most recent `verse_submissions.submitted_at`; if `now - submitted_at < 7d`, cooldown is active.
### Solved-today gate (API-level)
The `POST /api/submit-verse` endpoint requires that the user has a `daily_completions` row for **their local today**. The client sends `localDate` (the same `YYYY-MM-DD` it already computes via `toLocaleDateString("en-CA")` and sends to other endpoints). The server checks `dailyCompletions` for a row with `anonymous_id = user.id` (for logged-in users, `anonymousId` is the user id after migration) and `date = localDate`. If absent → `403` with `{ error: "Solve today's puzzle first" }`.
This is an **engagement gate**, not a security necessity (submissions are anonymous → low spam incentive), but it ties the feature to real play and blocks scripted submissions.
---
## Validation (no content moderation)
Because verses are chosen from canonical NKJV via dropdowns, no profanity/inappropriate-content filter is needed. Pre-submit validation is purely structural:
- `bookId` is one of the 66 known books (`getBookById`).
- `chapter` is in `[1, getChapterCount(bookNumber)]`.
- `verse` is in `[1, getVerseCount(bookNumber, chapter)]`.
- Cooldown not active.
- Solved-today gate passed.
- (The 60-day repeat and no-back-to-back rules are enforced by the scheduling scan, not by pre-rejecting the user's selection. A user can pick any valid verse; the scan will simply place it on the earliest valid date, possibly far out.)
---
## API Endpoints
### `/scheduled-verses` (auth-walled, admin-only)
A private admin page gated to the single account `geohpowell@gmail.com`. This is the **one place** where submitter identity is surfaced — attribution is anonymous everywhere else (public game, share text, etc.), but this admin view is the exception.
**Access control:**
- `+page.server.ts` `load` requires `locals.user` and `locals.user.email === 'geohpowell@gmail.com'`.
- Not authenticated → redirect to the sign-in modal/flow (same pattern as `/progress`, `/stats`).
- Authenticated but wrong account → `403` / a plain "not authorized" page. Do not leak the existence of privileged data; the page simply renders an access-denied state.
- The email check is a literal string match; if the admin email ever changes, update the constant (single source in one server module, e.g. `src/lib/server/admin.ts` exporting `ADMIN_EMAIL`).
- No `isPrivate` bypass needed — the admin is trusted to see all submitters regardless of their `isPrivate` flag.
**Page contents:** a table of all `verse_submissions` rows joined to `daily_verses` (by `scheduled_date = daily_verses.date`) and `user` (by `user_id`), one row per submission:
| Column | Source |
| --- | --- |
| Scheduled date | `verse_submissions.scheduled_date` (rendered human-readable) |
| Reference | `daily_verses.reference` |
| Window text | `daily_verses.verse_text` (the 3-verse window) |
| Book | `daily_verses.book_id` (resolve to name via `getBookById`) |
| Submitted by | `user.email` (and `firstName lastName` if present) |
| Submitted at | `verse_submissions.submitted_at` (server UTC, rendered) |
| Selected verse | `verse_submissions.selected_book_id` / `selected_chapter` / `selected_verse` (the anchor the user picked) |
Sorted by `scheduled_date` ascending (so the upcoming calendar reads top-to-bottom). Include past rows (already-played submissions) — the table is a full historical + future log, not just pending. A small filter toggle (All / Upcoming / Past) is a nice-to-have, not required.
Since attribution appears here, `verse_submissions.user_id` must resolve even for deleted accounts — use a `LEFT JOIN` to `user` and render "(deleted user)" when the join is null. (Matches the `ON DELETE SET NULL` decision in the edge-cases section: the scheduled verse still plays out; the admin just sees the attribution is gone.)
This route is **not** linked from the UI (no nav entry, no win-screen button) — it's a direct-URL admin tool.
### `POST /api/submit-verse` (auth required)
**Body:** `{ bookId, chapter, verse, localDate }`
**Flow:**
1. Require `locals.user` (else `401`).
2. Solved-today gate: `dailyCompletions` row for `(anonymousId=user.id, date=localDate)` else `403`.
3. Cooldown: most recent `verse_submissions.submitted_at` for user; if `< 7d` ago → `429 { cooldownEndsAt }`.
4. Structural validation of `bookId/chapter/verse`.
5. Compute the 3-verse window (fall-forward algorithm).
6. Run the scheduling scan; on unique-constraint conflict, retry.
7. In a transaction: insert `daily_verses` row `{ id, date: D, bookId, reference, verseText, createdAt: now }` and `verse_submissions` row `{ id, user_id, scheduled_date: D, selected_book_id, selected_chapter, selected_verse, submitted_at: now }`.
8. Return `{ scheduledDate: D, reference, windowText }`.
Analytics: emit `(window as any).rybbit?.event("Submit a verse")`.
### `GET /api/submit-verse/status?localDate=YYYY-MM-DD` (auth required)
Returns the state for the win-screen button:
```json
{
"canSubmit": true | false,
"cooldownEndsAt": <server UTC millis> | null,
"lastSubmission": { "scheduledDate": "2026-08-24", "reference": "..." } | null,
"upcoming": [ { "scheduledDate": "...", "reference": "..." }, ... ] // this user's not-yet-reached submissions, for an optional small list
}
```
### `GET /api/bible/structure` (public)
Returns the static structure for populating the cascading dropdowns client-side (cached indefinitely):
```json
[
{ "bookId": "gen", "chapters": [31, 25, 24, ...] }, // verse counts per chapter
...
]
```
Built from `getChapterCount` + `getVerseCount` over all 66 books. Small payload (~1189 chapter entries).
### `GET /api/verse-window?bookId=gen&chapter=1&verse=1` (public)
Returns the 3-verse preview for the live preview pane, computed via the fall-forward window algorithm:
```json
{
"windowVerses": ["In the beginning...", "And the earth...", "And God said..."],
"reference": "Genesis 1:1-3",
"bookId": "gen",
"selectedVerse": 1
}
```
Called debounced (e.g. 250ms) as the selector changes.
---
## Frontend
### New component: `src/lib/components/SubmitVerse.svelte`
Rendered inside `WinScreen.svelte`, near the existing "📈 See your progress" button, sharing the same neobrutalist `.progress-btn` styling.
**Three visual states:**
1. **Logged out** — button reads "✨ Submit a verse" with a chevron; clicking expands a dropdown identical in structure to the existing logged-out progress dropdown: helper text ("Sign in to submit a verse for a future day") + Apple Sign-In form (`POST /auth/apple`, with hidden `anonymousId`) + Google Sign-In form (`POST /auth/google`). Mirrors the existing markup/classes exactly.
2. **Logged in, cooldown active** — button is greyed out / disabled ("✨ Submit a verse" + lock/⏳), with a small countdown timer below it counting down to `cooldownEndsAt` (reuse the `CountdownTimer` pattern / a compact timer). The dropdown does not expand.
3. **Logged in, can submit** — clicking expands a panel with:
- Three cascading native `<select>` dropdowns: **Book** (grouped by Testament, `<optgroup>`), **Chapter** (1..chapterCount), **Verse** (1..verseCount). Book list/chapter counts come from `/api/bible/structure` (fetched once, cached). Selecting book populates chapters; selecting chapter populates verses; selecting verse (or any change) triggers the debounced preview fetch.
- A **live preview** card showing the 3-verse window text + reference, updating in real time as the selector changes. (This is not today's verse — it's the user's prospective submission — so showing the book/reference is fine.)
- A **Submit** button (neobrutalist). On success, replace the panel with a confirmation: "✅ Your verse is scheduled for **August 24, 2026**" + the reference, plus a rybbit event. On `429`/`403`, show the server's error message inline.
The win screen already receives `isLoggedIn` and `anonymousId` as props; pass them through to `SubmitVerse`.
### Placement note
The button is **win-screen-only**, which implicitly requires the user to have solved today's puzzle to reach it (the win screen only renders post-solve, and reloads still render it via `game-persistence` restoring today's completed guesses). This matches the API-level solved-today gate.
---
## Reused Existing Functions
| Function | Used for |
| --- | --- |
| `getChapterCount(bookNumber)` | Dropdown chapter list bounds |
| `getVerseCount(bookNumber, chapter)` | Dropdown verse list bounds |
| `extractVerses(bookNumber, chapter, startVerse, count)` | Composing the 3-verse window (per chapter; concat for cross-chapter) |
| `getBookById` / `getBookByNumber` | Book id ↔ number ↔ name resolution |
| `formatReference(bookName, chapter, startVerse, endVerse)` | Reference formatting (extend for cross-chapter) |
| `getRandomVerses()` | Lazy gap-fill random verse (extended with neighbor avoidance) |
| `getVerseForDate(date)` | Returns pre-written submission row unchanged on its day |
| Auth (`locals.user`, session cookie) | Identifying the submitter |
| `dailyCompletions` (`anonymousId = user.id`, `date`) | Solved-today gate |
---
## Edge Cases & Decisions Log
- **Selected verse at a book's start (v1/v2 of chapter 1):** fall forward to `[v, v+1, v+2]`. Always 3 verses, same book.
- **Cross-chapter window within a book:** allowed; reference formatted as `Book C1:S1–C2:E2`.
- **Cross-book window:** never happens (algorithm constrains to one book).
- **Concurrent submissions picking the same date:** transaction + retry-on-unique-conflict.
- **Repeat of an identical 3-verse window:** allowed, but the scan skips any candidate date within ±60 days of an existing same-window row, so repeats land far out (this is what "schedule them out a month or two" means in practice).
- **Calendar drift (submissions outpace 1/day demand):** accepted — no guardrail; a submission may land far in the future. The submitter is shown the resulting date regardless.
- **Account deletion:** submissions are anonymous; `daily_verses` rows stay (canonical text). The `verse_submissions` row's `user_id` FK should be `ON DELETE SET NULL` (or cascade-delete the log row) — either is fine since attribution is never shown. The scheduled verse plays out regardless.
- **Discord daily-verse cron / RSS / sitemap:** unchanged — they call `getVerseForDate`, which serves pre-written submission rows transparently.
- **`createdAt` on submission-written `daily_verses` rows:** equals submit time, not the future play date. This is consistent with the existing field's meaning ("when the row was created").
- **Admin `/scheduled-verses` view is the sole attribution exception:** the public-facing anonymity guarantee does not apply to this admin-only route, which deliberately surfaces `user.email` for the `geohpowell@gmail.com` account. All other surfaces (win screen, share text, future potential leaderboard) remain anonymous.
---
## Open / Deferred (not blocking v1)
- A small "your upcoming scheduled verses" list on the win screen (data already available from `/api/submit-verse/status`). Nice-to-have, not required for v1.
- Balancing book distribution beyond no-back-to-back (e.g. avoiding clustering the same book within a month). Explicitly out of scope — only adjacent-day collisions are prevented.
- Email/notification when a user's scheduled verse goes live. Out of scope.
+2 -1
View File
@@ -3,7 +3,8 @@
<head> <head>
<meta charset="utf-8" /> <meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" /> <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
<script src="https://rybbit.snail.city/api/script.js" data-site-id="9abf0e81d024" defer></script> <link rel="icon" href="/favicon.png" type="image/png" />
<link rel="alternate" type="application/rss+xml" title="Bibdle RSS Feed" href="/feed.xml" />
%sveltekit.head% %sveltekit.head%
</head> </head>
<body data-sveltekit-preload-data="hover"> <body data-sveltekit-preload-data="hover">
+2 -2
View File
@@ -17,9 +17,9 @@ const handleAuth: Handle = async ({ event, resolve }) => {
const { session, user } = await auth.validateSessionToken(sessionToken); const { session, user } = await auth.validateSessionToken(sessionToken);
if (session) { if (session) {
auth.setSessionTokenCookie(event, sessionToken, session.expiresAt); auth.setSessionTokenCookie({ cookies: event.cookies }, sessionToken, session.expiresAt);
} else { } else {
auth.deleteSessionTokenCookie(event); auth.deleteSessionTokenCookie({ cookies: event.cookies });
} }
event.locals.user = user; event.locals.user = user;
Binary file not shown.

After

Width:  |  Height:  |  Size: 4.0 MiB

+200
View File
@@ -0,0 +1,200 @@
<script lang="ts">
import { onMount } from "svelte";
import Container from "$lib/components/Container.svelte";
interface Props {
completions: Array<{ date: string; guessCount: number }>;
}
let { completions }: Props = $props();
type CalendarCell = {
date: string;
dayNum: number;
played: boolean;
guessCount: number | null;
} | null;
type CalendarRow = {
cells: CalendarCell[];
monthLabel: string | null;
};
const MONTH_NAMES = [
"January",
"February",
"March",
"April",
"May",
"June",
"July",
"August",
"September",
"October",
"November",
"December",
];
function buildCalendar(
completionList: Array<{ date: string; guessCount: number }>,
localDate: string,
): CalendarRow[] {
const completionMap = new Map(
completionList.map((c) => [c.date, c.guessCount]),
);
const today = new Date(localDate + "T00:00:00Z");
const days: Array<{
date: string;
dayNum: number;
month: string;
dayOfWeek: number;
guessCount: number | null;
}> = [];
for (let i = 29; i >= 0; i--) {
const d = new Date(today);
d.setUTCDate(d.getUTCDate() - i);
const dateStr = d.toISOString().slice(0, 10);
days.push({
date: dateStr,
dayNum: d.getUTCDate(),
month: dateStr.slice(0, 7),
dayOfWeek: d.getUTCDay(),
guessCount: completionMap.get(dateStr) ?? null,
});
}
const rows: CalendarRow[] = [];
let currentRow: CalendarCell[] = [];
let currentMonth = "";
let firstRowOfMonth = true;
for (const day of days) {
if (day.month !== currentMonth) {
if (currentRow.length > 0) {
while (currentRow.length < 7) currentRow.push(null);
rows.push({ cells: currentRow, monthLabel: null });
currentRow = [];
}
for (let j = 0; j < day.dayOfWeek; j++) currentRow.push(null);
currentMonth = day.month;
firstRowOfMonth = true;
}
currentRow.push({
date: day.date,
dayNum: day.dayNum,
played: day.guessCount !== null,
guessCount: day.guessCount ?? null,
});
if (currentRow.length === 7) {
const [year, monthIdx] = currentMonth.split("-").map(Number);
const label = firstRowOfMonth
? `${MONTH_NAMES[monthIdx - 1]} ${year}`
: null;
rows.push({ cells: currentRow, monthLabel: label });
currentRow = [];
firstRowOfMonth = false;
}
}
if (currentRow.length > 0) {
while (currentRow.length < 7) currentRow.push(null);
const [year, monthIdx] = currentMonth.split("-").map(Number);
rows.push({
cells: currentRow,
monthLabel: firstRowOfMonth
? `${MONTH_NAMES[monthIdx - 1]} ${year}`
: null,
});
}
return rows;
}
function calendarColor(day: {
played: boolean;
guessCount: number | null;
}): string {
if (!day.played) return "bg-gray-800/60 text-gray-400";
const g = day.guessCount!;
if (g === 1) return "bg-emerald-300";
if (g <= 3) return "bg-emerald-500";
if (g <= 5) return "bg-amber-400";
if (g <= 7) return "bg-orange-500";
return "bg-red-600";
}
let calendarRows = $state<CalendarRow[]>([]);
onMount(() => {
const localDate = new Date().toLocaleDateString("en-CA");
calendarRows = buildCalendar(completions, localDate);
});
</script>
<Container class="p-4 md:p-6 w-full">
<h2 class="text-xl font-bold text-gray-100 mb-3 w-full text-left">
Activity
</h2>
<!-- Day-of-week headers -->
<div class="flex gap-1 mb-1">
{#each ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"] as d (d)}
<div
class="w-10 h-5 text-center text-[10px] text-gray-500 font-medium shrink-0"
>
{d}
</div>
{/each}
</div>
<!-- Calendar rows -->
{#each calendarRows as row, rowIdx (rowIdx)}
{#if row.monthLabel}
<div class="text-xs text-gray-400 font-semibold mt-3 mb-1">
{row.monthLabel}
</div>
{/if}
<div class="flex gap-1 mb-1">
{#each row.cells as cell, cellIdx (cellIdx)}
{#if cell}
<div
class="w-10 h-10 rounded flex items-center justify-center text-sm font-semibold shrink-0 {calendarColor(
cell,
)}"
title={cell.played
? `${cell.date}: ${cell.guessCount} guess${cell.guessCount === 1 ? "" : "es"}`
: cell.date}
>
{cell.dayNum}
</div>
{:else}
<div class="w-10 h-10 shrink-0"></div>
{/if}
{/each}
</div>
{/each}
<!-- Legend -->
<div class="flex flex-wrap gap-3 mt-3 text-xs text-gray-400">
<span class="flex items-center gap-1">
<span class="inline-block w-3 h-3 rounded-sm bg-emerald-300"></span>
1 guess
</span>
<span class="flex items-center gap-1">
<span class="inline-block w-3 h-3 rounded-sm bg-emerald-500"></span>
2–3 guesses
</span>
<span class="flex items-center gap-1">
<span class="inline-block w-3 h-3 rounded-sm bg-amber-400"></span>
4–5 guesses
</span>
<span class="flex items-center gap-1">
<span class="inline-block w-3 h-3 rounded-sm bg-orange-500"></span>
6–7 guesses
</span>
<span class="flex items-center gap-1">
<span class="inline-block w-3 h-3 rounded-sm bg-red-600"></span>
8+ guesses
</span>
</div>
</Container>
+18
View File
@@ -96,6 +96,7 @@
<button <button
type="submit" type="submit"
class="w-full flex items-center justify-center gap-2 px-4 py-2.5 bg-white text-black rounded-md hover:bg-gray-100 transition-colors font-medium" class="w-full flex items-center justify-center gap-2 px-4 py-2.5 bg-white text-black rounded-md hover:bg-gray-100 transition-colors font-medium"
data-umami-event="Sign in with Apple"
> >
<svg class="w-5 h-5" viewBox="0 0 24 24" fill="currentColor"> <svg class="w-5 h-5" viewBox="0 0 24 24" fill="currentColor">
<path d="M17.05 20.28c-.98.95-2.05.88-3.08.4-1.09-.5-2.08-.48-3.24 0-1.44.62-2.2.44-3.06-.4C2.79 15.25 3.51 7.59 9.05 7.31c1.35.07 2.29.74 3.08.8 1.18-.24 2.31-.93 3.57-.84 1.51.12 2.65.72 3.4 1.8-3.12 1.87-2.38 5.98.48 7.13-.57 1.5-1.31 2.99-2.54 4.09zM12.03 7.25c-.15-2.23 1.66-4.07 3.74-4.25.29 2.58-2.34 4.5-3.74 4.25z"/> <path d="M17.05 20.28c-.98.95-2.05.88-3.08.4-1.09-.5-2.08-.48-3.24 0-1.44.62-2.2.44-3.06-.4C2.79 15.25 3.51 7.59 9.05 7.31c1.35.07 2.29.74 3.08.8 1.18-.24 2.31-.93 3.57-.84 1.51.12 2.65.72 3.4 1.8-3.12 1.87-2.38 5.98.48 7.13-.57 1.5-1.31 2.99-2.54 4.09zM12.03 7.25c-.15-2.23 1.66-4.07 3.74-4.25.29 2.58-2.34 4.5-3.74 4.25z"/>
@@ -104,6 +105,23 @@
</button> </button>
</form> </form>
<form method="POST" action="/auth/google">
<input type="hidden" name="anonymousId" value={anonymousId} />
<button
type="submit"
class="w-full flex items-center justify-center gap-2 px-4 py-2.5 bg-white text-black rounded-md hover:bg-gray-100 transition-colors font-medium mt-3"
data-umami-event="Sign in with Google"
>
<svg class="w-5 h-5" viewBox="0 0 24 24">
<path fill="#4285F4" d="M22.56 12.25c0-.78-.07-1.53-.2-2.25H12v4.26h5.92c-.26 1.37-1.04 2.53-2.21 3.31v2.77h3.57c2.08-1.92 3.28-4.74 3.28-8.09z"/>
<path fill="#34A853" d="M12 23c2.97 0 5.46-.98 7.28-2.66l-3.57-2.77c-.98.66-2.23 1.06-3.71 1.06-2.86 0-5.29-1.93-6.16-4.53H2.18v2.84C3.99 20.53 7.7 23 12 23z"/>
<path fill="#FBBC05" d="M5.84 14.09c-.22-.66-.35-1.36-.35-2.09s.13-1.43.35-2.09V7.07H2.18C1.43 8.55 1 10.22 1 12s.43 3.45 1.18 4.93l3.66-2.84z"/>
<path fill="#EA4335" d="M12 5.38c1.62 0 3.06.56 4.21 1.64l3.15-3.15C17.45 2.09 14.97 1 12 1 7.7 1 3.99 3.47 2.18 7.07l3.66 2.84c.87-2.6 3.3-4.53 6.16-4.53z"/>
</svg>
Sign in with Google
</button>
</form>
<div class="flex items-center my-4"> <div class="flex items-center my-4">
<div class="flex-1 border-t border-white/20"></div> <div class="flex-1 border-t border-white/20"></div>
<span class="px-3 text-sm text-white/60">or</span> <span class="px-3 text-sm text-white/60">or</span>
+3
View File
@@ -7,6 +7,7 @@
onclick?: () => void; onclick?: () => void;
class?: string; class?: string;
type?: "button" | "submit" | "reset"; type?: "button" | "submit" | "reset";
disabled?: boolean;
} }
let { let {
@@ -15,6 +16,7 @@
onclick, onclick,
class: className = "", class: className = "",
type = "button", type = "button",
disabled = false,
}: Props = $props(); }: Props = $props();
const variantClasses = { const variantClasses = {
@@ -31,6 +33,7 @@
<button <button
{type} {type}
{onclick} {onclick}
{disabled}
class="inline-flex items-center justify-center px-4 py-2 rounded-lg border-2 font-bold text-sm transition-all duration-200 {variantClasses[ class="inline-flex items-center justify-center px-4 py-2 rounded-lg border-2 font-bold text-sm transition-all duration-200 {variantClasses[
variant variant
]} {className}" ]} {className}"
+102
View File
@@ -0,0 +1,102 @@
<script lang="ts" generics="T">
import type { Snippet } from 'svelte';
interface Header {
label: string;
align?: 'left' | 'right';
width?: string;
}
interface Mode {
value: string;
label: string;
}
interface Props {
rows: T[];
headers: Header[];
row: Snippet<[item: T]>;
empty?: Snippet;
initialRows?: number;
modes?: Mode[];
mode?: string;
}
let {
rows,
headers,
row: rowSnippet,
empty,
initialRows = 3,
modes,
mode = $bindable(modes && modes.length > 0 ? modes[0].value : undefined),
}: Props = $props();
let expanded = $state(false);
// Reset expanded when mode changes (e.g. switching Rolling 30d ↔ Calendar)
$effect(() => {
mode;
expanded = false;
});
function toggleExpanded() {
expanded = !expanded;
}
const displayedRows = $derived(expanded ? rows : rows.slice(0, initialRows));
</script>
{#if modes && modes.length > 1}
<div class="flex gap-1 bg-white/5 rounded-lg p-1 w-fit ml-auto mb-3">
{#each modes as m (m.value)}
{@const active = mode === m.value}
<button
onclick={() => (mode = m.value)}
class="px-3 py-1 text-xs rounded-md transition-colors {active ? 'bg-white/10 text-gray-100' : 'text-gray-400 hover:text-gray-200'}"
>
{m.label}
</button>
{/each}
</div>
{/if}
{#if rows.length === 0}
{#if empty}
{@render empty()}
{:else}
<p class="text-gray-400 text-sm px-4 py-6">Not enough data yet.</p>
{/if}
{:else}
<div class="overflow-x-auto rounded-xl border border-white/10">
<table class="w-full text-sm">
<thead>
<tr class="bg-white/5 text-gray-400 text-xs uppercase tracking-wide">
{#each headers as header (header.label)}
<th
class="{header.align === 'right' ? 'text-right' : 'text-left'} px-4 py-3{header.width ? ' ' + header.width : ''}"
>
{header.label}
</th>
{/each}
</tr>
</thead>
<tbody>
{#each displayedRows as item, i (i)}
<tr class="border-t border-white/5 hover:bg-white/5 transition-colors">
{@render rowSnippet(item)}
</tr>
{/each}
</tbody>
</table>
</div>
{#if rows.length > initialRows}
<button
onclick={toggleExpanded}
class="mt-2 flex items-center gap-1 text-xs text-gray-500 hover:text-gray-300 transition-colors mx-auto"
>
<span>{expanded ? '▲ Show less' : '▼ Show more'}</span>
</button>
{/if}
{/if}
+15
View File
@@ -3,6 +3,7 @@
let timeUntilNext = $state(""); let timeUntilNext = $state("");
let newVerseReady = $state(false); let newVerseReady = $state(false);
let showEncouragement = $state(false);
let intervalId: number | null = null; let intervalId: number | null = null;
let targetTime = 0; let targetTime = 0;
@@ -41,6 +42,13 @@
initTarget(); initTarget();
updateTimer(); updateTimer();
intervalId = window.setInterval(updateTimer, 1000); intervalId = window.setInterval(updateTimer, 1000);
const winCount = Object.keys(localStorage).filter(
(k) =>
k.startsWith("bibdle-win-tracked-") &&
localStorage.getItem(k) === "true",
).length;
showEncouragement = winCount < 3;
}); });
onDestroy(() => { onDestroy(() => {
@@ -77,6 +85,13 @@
> >
{timeUntilNext} {timeUntilNext}
</p> </p>
{#if showEncouragement}
<p
class="text-xs text-center uppercase tracking-[0.2em] text-gray-500 dark:text-gray-400 font-bold px-4 mt-3"
>
Come back tomorrow for a new verse!
</p>
{/if}
{/if} {/if}
</div> </div>
</div> </div>
+6
View File
@@ -69,6 +69,12 @@
> >
📊 View Stats 📊 View Stats
</a> </a>
<a
href="/progress"
class="inline-flex items-center justify-center w-full px-4 py-4 md:py-2 bg-emerald-600 text-white rounded-lg hover:bg-emerald-700 transition-colors text-sm font-medium shadow-md"
>
📈 View Progress
</a>
{#if user} {#if user}
<form method="POST" action="/auth/logout" use:enhance class="w-full"> <form method="POST" action="/auth/logout" use:enhance class="w-full">
+39
View File
@@ -0,0 +1,39 @@
<script lang="ts">
let { guessCount }: { guessCount: number } = $props();
let promptText = $state("What book of the Bible is this verse from?");
let visible = $state(true);
$effect(() => {
let fadeOutId: ReturnType<typeof setTimeout>;
let changeId: ReturnType<typeof setTimeout>;
function animateTo(newText: string, delay = 0) {
fadeOutId = setTimeout(() => {
visible = false;
changeId = setTimeout(() => {
promptText = newText;
visible = true;
}, 300);
}, delay);
}
if (guessCount === 0) {
animateTo("What book of the Bible is this verse from?");
} else {
animateTo("Guess again", 2100);
}
return () => {
clearTimeout(fadeOutId);
clearTimeout(changeId);
};
});
</script>
<p
class="big-text text-center text-gray-800 dark:text-gray-100 mb-6 px-4"
style="transition: opacity 0.3s ease; opacity: {visible ? 1 : 0};"
>
{promptText}
</p>
+182 -32
View File
@@ -1,14 +1,20 @@
<script lang="ts"> <script lang="ts">
import { bibleBooks } from "$lib/types/bible"; import { bibleBooks } from "$lib/types/bible";
import { getFirstLetter, type Guess } from "$lib/utils/game"; import { getFirstLetter, type Guess } from "$lib/utils/game";
import Container from "./Container.svelte";
let { let {
guesses, guesses,
correctBookId, correctBookId,
}: { guesses: Guess[]; correctBookId: string } = $props(); minimized = false,
}: { guesses: Guess[]; correctBookId: string; minimized?: boolean } = $props();
let hasGuesses = $derived(guesses.length > 0); let hasGuesses = $derived(guesses.length > 0);
let showMinimized = $derived(minimized);
let expanded = $state(false);
$effect(() => {
if (!minimized) expanded = false;
});
function getBoxColor(isCorrect: boolean, isAdjacent?: boolean): string { function getBoxColor(isCorrect: boolean, isAdjacent?: boolean): string {
if (isCorrect) return "bg-green-500 border-green-600"; if (isCorrect) return "bg-green-500 border-green-600";
@@ -16,6 +22,13 @@
return "bg-red-500 border-red-600"; return "bg-red-500 border-red-600";
} }
function getBookBoxStyle(guess: Guess): string {
if (guess.book.id === correctBookId) {
return "background-color: #22c55e; border-color: #16a34a;";
}
return "background-color: #ef4444; border-color: #dc2626;";
}
function getBoxContent( function getBoxContent(
guess: Guess, guess: Guess,
column: "book" | "firstLetter" | "testament" | "section", column: "book" | "firstLetter" | "testament" | "section",
@@ -64,17 +77,7 @@
} }
</script> </script>
{#if !hasGuesses} {#if hasGuesses}
<Container class="p-6 text-center">
<h2 class="font-triodion text-xl italic mb-3 text-gray-800 dark:text-gray-100">
Instructions
</h2>
<p class="text-gray-700 dark:text-gray-300 leading-relaxed italic">
Guess what book of the bible you think the verse is from. You will
get clues to help you after each guess.
</p>
</Container>
{:else}
<div class="space-y-3"> <div class="space-y-3">
<!-- Column Headers --> <!-- Column Headers -->
<div <div
@@ -102,31 +105,35 @@
</div> </div>
</div> </div>
{#each guesses as guess, rowIndex (guess.book.id)} {#if showMinimized && !expanded}
<!-- Minimized view: first guess, divider, last two guesses -->
<!-- First guess (no animation since post-win) -->
{@const firstGuess = guesses[0]}
<div class="flex gap-2 justify-center"> <div class="flex gap-2 justify-center">
<!-- Testament Column --> <!-- Testament Column -->
<div <div
class="w-1/4 shrink-0 h-16 sm:h-20 md:h-24 border-2 border-opacity-80 rounded-lg flex items-center justify-center text-white font-bold text-base sm:text-lg md:text-xl shadow-md animate-flip-in {getBoxColor( class="w-1/4 shrink-0 h-16 sm:h-20 md:h-24 border-2 border-opacity-80 rounded-lg flex items-center justify-center text-white font-bold text-base sm:text-lg md:text-xl shadow-md animate-flip-in {getBoxColor(
guess.testamentMatch, firstGuess.testamentMatch,
)}" )}"
style="animation-delay: {rowIndex * 1000 + 0 * 500}ms" style="animation: none; opacity: 1; transform: none;"
> >
<span class="text-center leading-tight px-1 text-shadow-sm" <span class="text-center leading-tight px-1 text-shadow-sm"
>{getBoxContent(guess, "testament")}</span >{getBoxContent(firstGuess, "testament")}</span
> >
</div> </div>
<!-- Section Column --> <!-- Section Column -->
<div <div
class="relative w-1/4 shrink-0 h-16 sm:h-20 md:h-24 border-2 border-opacity-80 rounded-lg flex items-center justify-center text-white font-bold text-base sm:text-lg md:text-xl shadow-md animate-flip-in {getBoxColor( class="relative w-1/4 shrink-0 h-16 sm:h-20 md:h-24 border-2 border-opacity-80 rounded-lg flex items-center justify-center text-white font-bold text-base sm:text-lg md:text-xl shadow-md animate-flip-in {getBoxColor(
guess.sectionMatch, firstGuess.sectionMatch,
guess.adjacent, firstGuess.adjacent,
)}" )}"
style="animation-delay: {rowIndex * 1000 + 1 * 500}ms" style="animation: none; opacity: 1; transform: none;"
> >
<span class="text-center leading-tight px-1 text-shadow-sm" <span class="text-center leading-tight px-1 text-shadow-sm"
>{getBoxContent(guess, "section")} >{getBoxContent(firstGuess, "section")}
{#if guess.adjacent} {#if firstGuess.adjacent}
‼️ ‼️
{/if} {/if}
</span> </span>
@@ -135,30 +142,173 @@
<!-- First Letter Column --> <!-- First Letter Column -->
<div <div
class="w-1/4 shrink-0 h-16 sm:h-20 md:h-24 border-2 border-opacity-80 rounded-lg flex items-center justify-center text-white font-bold text-base sm:text-lg md:text-xl shadow-md animate-flip-in {getBoxColor( class="w-1/4 shrink-0 h-16 sm:h-20 md:h-24 border-2 border-opacity-80 rounded-lg flex items-center justify-center text-white font-bold text-base sm:text-lg md:text-xl shadow-md animate-flip-in {getBoxColor(
guess.firstLetterMatch, firstGuess.firstLetterMatch,
)}" )}"
style="animation-delay: {rowIndex * 1000 + 2 * 500}ms" style="animation: none; opacity: 1; transform: none;"
> >
<span class="text-center leading-tight px-1 text-shadow-sm" <span class="text-center leading-tight px-1 text-shadow-sm"
>{getBoxContent(guess, "firstLetter")}</span >{getBoxContent(firstGuess, "firstLetter")}</span
> >
</div> </div>
<!-- Book Column --> <!-- Book Column -->
<div <div
class="w-1/4 shrink-0 h-16 sm:h-20 md:h-24 border-4 border-opacity-100 rounded-lg flex items-center justify-center text-white font-bold text-base sm:text-lg md:text-xl shadow-lg animate-flip-in {getBoxColor( class="w-1/4 shrink-0 h-16 sm:h-20 md:h-24 border-4 rounded-lg flex items-center justify-center text-white font-bold text-base sm:text-lg md:text-xl shadow-lg animate-flip-in"
guess.book.id === correctBookId, style="animation: none; opacity: 1; transform: none; {getBookBoxStyle(firstGuess)}"
)}"
style="animation-delay: {rowIndex * 1000 + 3 * 500}ms"
> >
<span class="text-center leading-tight px-1 text-shadow-lg" <span class="text-center leading-tight px-1 text-shadow-lg"
>{getBoxContent(guess, "book")}</span >{getBoxContent(firstGuess, "book")}</span
> >
</div> </div>
</div> </div>
{/each}
<!-- Expand/collapse divider -->
<button
type="button"
class="w-full flex items-center gap-3 py-1 cursor-pointer group"
onclick={() => (expanded = true)}
>
<div class="flex-1 h-px bg-gray-300 dark:bg-gray-600 group-hover:bg-gray-400 dark:group-hover:bg-gray-500 transition-colors"></div>
<span class="text-xs font-medium text-gray-500 dark:text-gray-400 group-hover:text-gray-700 dark:group-hover:text-gray-200 transition-colors whitespace-nowrap select-none">
expand guesses ▼
</span>
<div class="flex-1 h-px bg-gray-300 dark:bg-gray-600 group-hover:bg-gray-400 dark:group-hover:bg-gray-500 transition-colors"></div>
</button>
<!-- Last two guesses (no animation since post-win) -->
{#each guesses.slice(-2) as guess (guess.book.id)}
<div class="flex gap-2 justify-center">
<!-- Testament Column -->
<div
class="w-1/4 shrink-0 h-16 sm:h-20 md:h-24 border-2 border-opacity-80 rounded-lg flex items-center justify-center text-white font-bold text-base sm:text-lg md:text-xl shadow-md animate-flip-in {getBoxColor(
guess.testamentMatch,
)}"
style="animation: none; opacity: 1; transform: none;"
>
<span class="text-center leading-tight px-1 text-shadow-sm"
>{getBoxContent(guess, "testament")}</span
>
</div>
<!-- Section Column -->
<div
class="relative w-1/4 shrink-0 h-16 sm:h-20 md:h-24 border-2 border-opacity-80 rounded-lg flex items-center justify-center text-white font-bold text-base sm:text-lg md:text-xl shadow-md animate-flip-in {getBoxColor(
guess.sectionMatch,
guess.adjacent,
)}"
style="animation: none; opacity: 1; transform: none;"
>
<span class="text-center leading-tight px-1 text-shadow-sm"
>{getBoxContent(guess, "section")}
{#if guess.adjacent}
‼️
{/if}
</span>
</div>
<!-- First Letter Column -->
<div
class="w-1/4 shrink-0 h-16 sm:h-20 md:h-24 border-2 border-opacity-80 rounded-lg flex items-center justify-center text-white font-bold text-base sm:text-lg md:text-xl shadow-md animate-flip-in {getBoxColor(
guess.firstLetterMatch,
)}"
style="animation: none; opacity: 1; transform: none;"
>
<span class="text-center leading-tight px-1 text-shadow-sm"
>{getBoxContent(guess, "firstLetter")}</span
>
</div>
<!-- Book Column -->
<div
class="w-1/4 shrink-0 h-16 sm:h-20 md:h-24 border-4 rounded-lg flex items-center justify-center text-white font-bold text-base sm:text-lg md:text-xl shadow-lg animate-flip-in"
style="animation: none; opacity: 1; transform: none; {getBookBoxStyle(guess)}"
>
<span class="text-center leading-tight px-1 text-shadow-lg"
>{getBoxContent(guess, "book")}</span
>
</div>
</div>
{/each}
{:else}
<!-- Full view: all guesses -->
{#each guesses as guess, rowIndex (guess.book.id)}
<div class="flex gap-2 justify-center">
<!-- Testament Column -->
<div
class="w-1/4 shrink-0 h-16 sm:h-20 md:h-24 border-2 border-opacity-80 rounded-lg flex items-center justify-center text-white font-bold text-base sm:text-lg md:text-xl shadow-md animate-flip-in {getBoxColor(
guess.testamentMatch,
)}"
style={showMinimized
? "animation: none; opacity: 1; transform: none;"
: `animation-delay: ${rowIndex * 1000 + 0 * 500}ms`}
>
<span class="text-center leading-tight px-1 text-shadow-sm"
>{getBoxContent(guess, "testament")}</span
>
</div>
<!-- Section Column -->
<div
class="relative w-1/4 shrink-0 h-16 sm:h-20 md:h-24 border-2 border-opacity-80 rounded-lg flex items-center justify-center text-white font-bold text-base sm:text-lg md:text-xl shadow-md animate-flip-in {getBoxColor(
guess.sectionMatch,
guess.adjacent,
)}"
style={showMinimized
? "animation: none; opacity: 1; transform: none;"
: `animation-delay: ${rowIndex * 1000 + 1 * 500}ms`}
>
<span class="text-center leading-tight px-1 text-shadow-sm"
>{getBoxContent(guess, "section")}
{#if guess.adjacent}
‼️
{/if}
</span>
</div>
<!-- First Letter Column -->
<div
class="w-1/4 shrink-0 h-16 sm:h-20 md:h-24 border-2 border-opacity-80 rounded-lg flex items-center justify-center text-white font-bold text-base sm:text-lg md:text-xl shadow-md animate-flip-in {getBoxColor(
guess.firstLetterMatch,
)}"
style={showMinimized
? "animation: none; opacity: 1; transform: none;"
: `animation-delay: ${rowIndex * 1000 + 2 * 500}ms`}
>
<span class="text-center leading-tight px-1 text-shadow-sm"
>{getBoxContent(guess, "firstLetter")}</span
>
</div>
<!-- Book Column -->
<div
class="w-1/4 shrink-0 h-16 sm:h-20 md:h-24 border-4 rounded-lg flex items-center justify-center text-white font-bold text-base sm:text-lg md:text-xl shadow-lg animate-flip-in"
style={showMinimized
? `animation: none; opacity: 1; transform: none; ${getBookBoxStyle(guess)}`
: `animation-delay: ${rowIndex * 1000 + 3 * 500}ms; ${getBookBoxStyle(guess)}`}
>
<span class="text-center leading-tight px-1 text-shadow-lg"
>{getBoxContent(guess, "book")}</span
>
</div>
</div>
{#if showMinimized && expanded && rowIndex === 0}
<!-- Collapse divider shown right below the final (correct) guess -->
<button
type="button"
class="w-full flex items-center gap-3 py-1 cursor-pointer group"
onclick={() => (expanded = false)}
>
<div class="flex-1 h-px bg-gray-300 dark:bg-gray-600 group-hover:bg-gray-400 dark:group-hover:bg-gray-500 transition-colors"></div>
<span class="text-xs font-medium text-gray-500 dark:text-gray-400 group-hover:text-gray-700 dark:group-hover:text-gray-200 transition-colors whitespace-nowrap select-none">
collapse guesses ▲
</span>
<div class="flex-1 h-px bg-gray-300 dark:bg-gray-600 group-hover:bg-gray-400 dark:group-hover:bg-gray-500 transition-colors"></div>
</button>
{/if}
{/each}
{/if}
</div> </div>
<!-- </div> -->
{/if} {/if}
<style> <style>
@@ -0,0 +1,25 @@
<script lang="ts">
import Container from "$lib/components/Container.svelte";
interface Props {
emoji: string;
value: string;
label: string;
colorClass: string;
suffix?: string;
}
let { emoji, value, label, colorClass, suffix }: Props = $props();
</script>
<Container class="p-4 md:p-6 w-full">
<div class="text-center w-full">
<div class="text-2xl md:text-3xl mb-1">{emoji}</div>
<div class="text-2xl md:text-3xl font-bold {colorClass} mb-1">
{value}{#if suffix}<span class="text-base font-normal text-gray-400"
>&nbsp;{suffix}</span
>{/if}
</div>
<div class="text-xs md:text-sm text-gray-300 font-medium">{label}</div>
</div>
</Container>
+324 -278
View File
@@ -1,309 +1,355 @@
<script lang="ts"> <script lang="ts">
import { bibleBooks, type BibleBook, type BibleSection, type Testament } from "$lib/types/bible"; import {
import { SvelteSet } from "svelte/reactivity"; bibleBooks,
type BibleBook,
type BibleSection,
type Testament,
} from "$lib/types/bible";
import { SvelteSet } from "svelte/reactivity";
let { let {
searchQuery = $bindable(""), searchQuery = $bindable(""),
guessedIds, guessedIds,
submitGuess, submitGuess,
guessCount = 0, guessCount = 0,
}: { }: {
searchQuery: string; searchQuery: string;
guessedIds: SvelteSet<string>; guessedIds: SvelteSet<string>;
submitGuess: (id: string) => void; submitGuess: (id: string) => void;
guessCount: number; guessCount: number;
} = $props(); } = $props();
type DisplayMode = "simple" | "testament" | "sections"; type DisplayMode = "simple" | "testament" | "sections";
const displayMode = $derived<DisplayMode>( const displayMode = $derived<DisplayMode>(
guessCount >= 9 ? "sections" : guessCount >= 3 ? "testament" : "simple" guessCount >= 9 ? "sections" : guessCount >= 3 ? "testament" : "simple",
); );
const filteredBooks = $derived( const filteredBooks = $derived(
bibleBooks.filter((book) => bibleBooks.filter((book) =>
book.name.toLowerCase().includes(searchQuery.toLowerCase()) book.name.toLowerCase().includes(searchQuery.toLowerCase()),
) ),
); );
type SimpleGroup = { books: BibleBook[] }; type SimpleGroup = { books: BibleBook[] };
type TestamentGroup = { type TestamentGroup = {
testament: Testament; testament: Testament;
label: string; label: string;
books: BibleBook[]; books: BibleBook[];
}; };
type SectionGroup = { type SectionGroup = {
testament: Testament; testament: Testament;
testamentLabel: string; testamentLabel: string;
showTestamentHeader: boolean; showTestamentHeader: boolean;
section: BibleSection; section: BibleSection;
books: BibleBook[]; books: BibleBook[];
}; };
const simpleGroup = $derived.by<SimpleGroup>(() => { const simpleGroup = $derived.by<SimpleGroup>(() => {
const sorted = [...filteredBooks].sort((a, b) => const sorted = [...filteredBooks].sort((a, b) =>
a.name.localeCompare(b.name) a.name.localeCompare(b.name),
); );
return { books: sorted }; return { books: sorted };
}); });
const testamentGroups = $derived.by<TestamentGroup[]>(() => { const testamentGroups = $derived.by<TestamentGroup[]>(() => {
const old = filteredBooks const old = filteredBooks
.filter((b) => b.testament === "old") .filter((b) => b.testament === "old")
.sort((a, b) => a.name.localeCompare(b.name)); .sort((a, b) => a.name.localeCompare(b.name));
const newT = filteredBooks const newT = filteredBooks
.filter((b) => b.testament === "new") .filter((b) => b.testament === "new")
.sort((a, b) => a.name.localeCompare(b.name)); .sort((a, b) => a.name.localeCompare(b.name));
const groups: TestamentGroup[] = []; const groups: TestamentGroup[] = [];
if (old.length > 0) { if (old.length > 0) {
groups.push({ testament: "old", label: "Old Testament", books: old }); groups.push({
} testament: "old",
if (newT.length > 0) { label: "Old Testament",
groups.push({ testament: "new", label: "New Testament", books: newT }); books: old,
} });
return groups; }
}); if (newT.length > 0) {
groups.push({
testament: "new",
label: "New Testament",
books: newT,
});
}
return groups;
});
const sectionGroups = $derived.by<SectionGroup[]>(() => { const sectionGroups = $derived.by<SectionGroup[]>(() => {
// Build an ordered list of (testament, section) pairs by iterating bibleBooks once // Build an ordered list of (testament, section) pairs by iterating bibleBooks once
const seenKeys: Record<string, true> = {}; const seenKeys: Record<string, true> = {};
const orderedPairs: { testament: Testament; section: BibleSection }[] = []; const orderedPairs: { testament: Testament; section: BibleSection }[] =
[];
for (const book of bibleBooks) { for (const book of bibleBooks) {
const key = `${book.testament}:${book.section}`; const key = `${book.testament}:${book.section}`;
if (!seenKeys[key]) { if (!seenKeys[key]) {
seenKeys[key] = true; seenKeys[key] = true;
orderedPairs.push({ testament: book.testament, section: book.section }); orderedPairs.push({
} testament: book.testament,
} section: book.section,
});
}
}
const groups: SectionGroup[] = []; const groups: SectionGroup[] = [];
let lastTestament: Testament | null = null; let lastTestament: Testament | null = null;
for (const pair of orderedPairs) { for (const pair of orderedPairs) {
const books = filteredBooks.filter( const books = filteredBooks.filter(
(b) => b.testament === pair.testament && b.section === pair.section (b) =>
); b.testament === pair.testament &&
if (books.length === 0) continue; b.section === pair.section,
);
if (books.length === 0) continue;
const showTestamentHeader = pair.testament !== lastTestament; const showTestamentHeader = pair.testament !== lastTestament;
lastTestament = pair.testament; lastTestament = pair.testament;
groups.push({ groups.push({
testament: pair.testament, testament: pair.testament,
testamentLabel: testamentLabel:
pair.testament === "old" ? "Old Testament" : "New Testament", pair.testament === "old"
showTestamentHeader, ? "Old Testament"
section: pair.section, : "New Testament",
books, showTestamentHeader,
}); section: pair.section,
} books,
});
}
return groups; return groups;
}); });
// First book in display order for Enter key submission // First book in display order for Enter key submission
const firstBookId = $derived.by<string | null>(() => { const firstBookId = $derived.by<string | null>(() => {
if (filteredBooks.length === 0) return null; if (filteredBooks.length === 0) return null;
if (displayMode === "simple") { if (displayMode === "simple") {
return simpleGroup.books[0]?.id ?? null; return simpleGroup.books[0]?.id ?? null;
} }
if (displayMode === "testament") { if (displayMode === "testament") {
return testamentGroups[0]?.books[0]?.id ?? null; return testamentGroups[0]?.books[0]?.id ?? null;
} }
return sectionGroups[0]?.books[0]?.id ?? null; return sectionGroups[0]?.books[0]?.id ?? null;
}); });
function handleKeydown(e: KeyboardEvent) { function handleKeydown(e: KeyboardEvent) {
if (e.key === "Enter" && firstBookId) { if (e.key === "Enter" && firstBookId) {
submitGuess(firstBookId); submitGuess(firstBookId);
} }
} }
const showBanner = $derived(guessCount >= 3); // const showBanner = $derived(guessCount >= 3);
const bannerIsIndigo = $derived(guessCount >= 9); const showBanner = false;
const bannerIsIndigo = $derived(guessCount >= 9);
</script> </script>
{#if showBanner} {#if showBanner}
<p <p
class="mb-3 text-xs font-medium text-gray-500 dark:text-gray-400" class="mb-3 text-xs font-medium text-gray-500 dark:text-gray-400"
role="status" role="status"
aria-live="polite" aria-live="polite"
> >
{#if bannerIsIndigo} {#if bannerIsIndigo}
Testament &amp; section groups now visible Testament &amp; section groups now visible
{:else} {:else}
Old &amp; New Testament groups now visible Old &amp; New Testament groups now visible
{/if} {/if}
</p> </p>
{/if} {/if}
<div class="relative"> <div class="relative">
<div class="relative"> <div class="relative">
<svg <svg
class="absolute left-4 sm:left-6 top-1/2 -translate-y-1/2 w-5 h-5 sm:w-6 sm:h-6 text-gray-400" class="absolute left-4 sm:left-6 top-1/2 -translate-y-1/2 w-5 h-5 sm:w-6 sm:h-6 text-gray-400"
fill="none" fill="none"
stroke="currentColor" stroke="currentColor"
viewBox="0 0 24 24" viewBox="0 0 24 24"
xmlns="http://www.w3.org/2000/svg" xmlns="http://www.w3.org/2000/svg"
aria-hidden="true" aria-hidden="true"
> >
<path <path
stroke-linecap="round" stroke-linecap="round"
stroke-linejoin="round" stroke-linejoin="round"
stroke-width="2" stroke-width="2"
d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z" d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z"
/> />
</svg> </svg>
<input <input
bind:value={searchQuery} bind:value={searchQuery}
placeholder="Type to guess a book (e.g. 'Genesis', 'John')..." placeholder="Type to guess a book (e.g. 'Genesis', 'John')..."
class="w-full pl-12 sm:pl-16 p-4 sm:p-6 border-2 border-gray-500 dark:border-gray-600 rounded-2xl text-base sm:text-lg md:text-xl focus:outline-none focus:border-blue-600 dark:focus:border-blue-400 focus:ring-4 focus:ring-blue-200 dark:focus:ring-blue-900/50 transition-all bg-white dark:bg-gray-800 dark:text-gray-100 dark:placeholder-gray-400" class="w-full pl-12 sm:pl-16 p-4 sm:p-6 border-2 border-gray-500 dark:border-gray-600 rounded-2xl text-base sm:text-lg md:text-xl focus:outline-none focus:border-blue-600 dark:focus:border-blue-400 focus:ring-4 focus:ring-blue-200 dark:focus:ring-blue-900/50 transition-all bg-white dark:bg-gray-800 dark:text-gray-100 dark:placeholder-gray-400"
onkeydown={handleKeydown} onkeydown={handleKeydown}
autocomplete="off" autocomplete="off"
/> />
{#if searchQuery} {#if searchQuery}
<button <button
class="absolute right-4 sm:right-6 top-1/2 -translate-y-1/2 text-gray-400 hover:text-gray-600 dark:hover:text-gray-200 transition-colors" class="absolute right-4 sm:right-6 top-1/2 -translate-y-1/2 text-gray-400 hover:text-gray-600 dark:hover:text-gray-200 transition-colors"
onclick={() => (searchQuery = "")} onclick={() => (searchQuery = "")}
aria-label="Clear search" aria-label="Clear search"
> >
<svg <svg
class="w-5 h-5 sm:w-6 sm:h-6" class="w-5 h-5 sm:w-6 sm:h-6"
fill="none" fill="none"
stroke="currentColor" stroke="currentColor"
viewBox="0 0 24 24" viewBox="0 0 24 24"
xmlns="http://www.w3.org/2000/svg" xmlns="http://www.w3.org/2000/svg"
aria-hidden="true" aria-hidden="true"
> >
<path <path
stroke-linecap="round" stroke-linecap="round"
stroke-linejoin="round" stroke-linejoin="round"
stroke-width="2" stroke-width="2"
d="M6 18L18 6M6 6l12 12" d="M6 18L18 6M6 6l12 12"
/> />
</svg> </svg>
</button> </button>
{/if} {/if}
</div> </div>
{#if searchQuery && filteredBooks.length > 0} {#if searchQuery && filteredBooks.length > 0}
<ul <ul
class="mt-4 max-h-60 sm:max-h-80 overflow-y-auto bg-white dark:bg-gray-800 border border-gray-300 dark:border-gray-700 rounded-2xl shadow-xl" class="mt-4 max-h-60 sm:max-h-80 overflow-y-auto bg-white dark:bg-gray-800 border border-gray-300 dark:border-gray-700 rounded-2xl shadow-xl"
role="listbox" role="listbox"
> >
{#if displayMode === "simple"} {#if displayMode === "simple"}
{#each simpleGroup.books as book (book.id)} {#each simpleGroup.books as book (book.id)}
<li role="option" aria-selected={guessedIds.has(book.id)}> <li role="option" aria-selected={guessedIds.has(book.id)}>
<button <button
class="w-full px-5 py-4 text-left border-b border-gray-100 last:border-b-0 flex items-center transition-all class="w-full px-5 py-4 text-left border-b border-gray-100 last:border-b-0 flex items-center transition-all
{guessedIds.has(book.id) {guessedIds.has(book.id)
? 'opacity-50 cursor-not-allowed pointer-events-none' ? 'opacity-50 cursor-not-allowed pointer-events-none'
: 'hover:bg-blue-50 hover:text-blue-700'}" : 'hover:bg-blue-50 hover:text-blue-700'}"
onclick={() => submitGuess(book.id)} onclick={() => submitGuess(book.id)}
tabindex={guessedIds.has(book.id) ? -1 : 0} tabindex={guessedIds.has(book.id) ? -1 : 0}
> >
<span <span
class="font-semibold dark:text-gray-100 {guessedIds.has(book.id) class="font-semibold dark:text-gray-100 {guessedIds.has(
? 'line-through text-gray-400 dark:text-gray-500' book.id,
: ''}" )
> ? 'line-through text-gray-400 dark:text-gray-500'
{book.name} : ''}"
</span> >
</button> {book.name}
</li> </span>
{/each} </button>
{:else if displayMode === "testament"} </li>
{#each testamentGroups as group (group.testament)} {/each}
<li role="presentation"> {:else if displayMode === "testament"}
<div {#each testamentGroups as group (group.testament)}
class="px-5 py-2 flex items-center gap-3 bg-gray-50 dark:bg-gray-700/50 border-b border-gray-100 dark:border-gray-700" <li role="presentation">
> <div
<span class="px-5 py-2 flex items-center gap-3 bg-gray-50 dark:bg-gray-700/50 border-b border-gray-100 dark:border-gray-700"
class="text-xs font-semibold uppercase tracking-wider text-gray-400 dark:text-gray-400" >
> <span
{group.label} class="text-xs font-semibold uppercase tracking-wider text-gray-400 dark:text-gray-400"
</span> >
<div class="flex-1 h-px bg-gray-200 dark:bg-gray-600"></div> {group.label}
</div> </span>
<ul> <div
{#each group.books as book (book.id)} class="flex-1 h-px bg-gray-200 dark:bg-gray-600"
<li role="option" aria-selected={guessedIds.has(book.id)}> ></div>
<button </div>
class="w-full px-5 py-4 text-left border-b border-gray-100 dark:border-gray-700 last:border-b-0 flex items-center transition-all dark:text-gray-200 <ul>
{#each group.books as book (book.id)}
<li
role="option"
aria-selected={guessedIds.has(book.id)}
>
<button
class="w-full px-5 py-4 text-left border-b border-gray-100 dark:border-gray-700 last:border-b-0 flex items-center transition-all dark:text-gray-200
{guessedIds.has(book.id) {guessedIds.has(book.id)
? 'opacity-50 cursor-not-allowed pointer-events-none' ? 'opacity-50 cursor-not-allowed pointer-events-none'
: 'hover:bg-blue-50 dark:hover:bg-blue-900/40 hover:text-blue-700 dark:hover:text-blue-300'}" : 'hover:bg-blue-50 dark:hover:bg-blue-900/40 hover:text-blue-700 dark:hover:text-blue-300'}"
onclick={() => submitGuess(book.id)} onclick={() => submitGuess(book.id)}
tabindex={guessedIds.has(book.id) ? -1 : 0} tabindex={guessedIds.has(book.id)
> ? -1
<span : 0}
class="font-semibold {guessedIds.has(book.id) >
? 'line-through text-gray-400 dark:text-gray-500' <span
: ''}" class="font-semibold {guessedIds.has(
> book.id,
{book.name} )
</span> ? 'line-through text-gray-400 dark:text-gray-500'
</button> : ''}"
</li> >
{/each} {book.name}
</ul> </span>
</li> </button>
{/each} </li>
{:else} {/each}
{#each sectionGroups as group (`${group.testament}:${group.section}`)} </ul>
<li role="presentation"> </li>
{#if group.showTestamentHeader} {/each}
<div {:else}
class="px-5 pt-3 pb-1 flex items-center gap-3 bg-gray-50 dark:bg-gray-700/50 border-b border-gray-100 dark:border-gray-700" {#each sectionGroups as group (`${group.testament}:${group.section}`)}
> <li role="presentation">
<span {#if group.showTestamentHeader}
class="text-xs font-bold uppercase tracking-wider text-gray-500 dark:text-gray-400" <div
> class="px-5 pt-3 pb-1 flex items-center gap-3 bg-gray-50 dark:bg-gray-700/50 border-b border-gray-100 dark:border-gray-700"
{group.testamentLabel} >
</span> <span
<div class="flex-1 h-px bg-gray-200 dark:bg-gray-600"></div> class="text-xs font-bold uppercase tracking-wider text-gray-500 dark:text-gray-400"
</div> >
{/if} {group.testamentLabel}
<div </span>
class="px-7 py-1.5 flex items-center gap-3 bg-gray-50/50 dark:bg-gray-700/30 border-b border-gray-100 dark:border-gray-700" <div
> class="flex-1 h-px bg-gray-200 dark:bg-gray-600"
<span ></div>
class="text-[11px] font-medium uppercase tracking-wider text-gray-400 dark:text-gray-500" </div>
> {/if}
{group.section} <div
</span> class="px-7 py-1.5 flex items-center gap-3 bg-gray-50/50 dark:bg-gray-700/30 border-b border-gray-100 dark:border-gray-700"
<div class="flex-1 h-px bg-gray-100 dark:bg-gray-600"></div> >
</div> <span
<ul> class="text-[11px] font-medium uppercase tracking-wider text-gray-400 dark:text-gray-500"
{#each group.books as book (book.id)} >
<li role="option" aria-selected={guessedIds.has(book.id)}> {group.section}
<button </span>
class="w-full px-5 py-4 text-left border-b border-gray-100 dark:border-gray-700 last:border-b-0 flex items-center transition-all dark:text-gray-200 <div
class="flex-1 h-px bg-gray-100 dark:bg-gray-600"
></div>
</div>
<ul>
{#each group.books as book (book.id)}
<li
role="option"
aria-selected={guessedIds.has(book.id)}
>
<button
class="w-full px-5 py-4 text-left border-b border-gray-100 dark:border-gray-700 last:border-b-0 flex items-center transition-all dark:text-gray-200
{guessedIds.has(book.id) {guessedIds.has(book.id)
? 'opacity-50 cursor-not-allowed pointer-events-none' ? 'opacity-50 cursor-not-allowed pointer-events-none'
: 'hover:bg-blue-50 dark:hover:bg-blue-900/40 hover:text-blue-700 dark:hover:text-blue-300'}" : 'hover:bg-blue-50 dark:hover:bg-blue-900/40 hover:text-blue-700 dark:hover:text-blue-300'}"
onclick={() => submitGuess(book.id)} onclick={() => submitGuess(book.id)}
tabindex={guessedIds.has(book.id) ? -1 : 0} tabindex={guessedIds.has(book.id)
> ? -1
<span : 0}
class="font-semibold {guessedIds.has(book.id) >
? 'line-through text-gray-400 dark:text-gray-500' <span
: ''}" class="font-semibold {guessedIds.has(
> book.id,
{book.name} )
</span> ? 'line-through text-gray-400 dark:text-gray-500'
</button> : ''}"
</li> >
{/each} {book.name}
</ul> </span>
</li> </button>
{/each} </li>
{/if} {/each}
</ul> </ul>
{:else if searchQuery} </li>
<p class="mt-4 text-center text-gray-500 dark:text-gray-400 p-8">No books found</p> {/each}
{/if} {/if}
</ul>
{:else if searchQuery}
<p class="mt-4 text-center text-gray-500 dark:text-gray-400 p-8">
No books found
</p>
{/if}
</div> </div>
+1 -4
View File
@@ -11,7 +11,6 @@
class="inline-flex hover:opacity-80 transition-opacity" class="inline-flex hover:opacity-80 transition-opacity"
aria-label="Follow on Bluesky" aria-label="Follow on Bluesky"
data-umami-event="Bluesky clicked" data-umami-event="Bluesky clicked"
onclick={() => (window as any).rybbit?.event("Bluesky clicked")}
> >
<img src={BlueskyLogo} alt="Bluesky" class="w-8 h-8" /> <img src={BlueskyLogo} alt="Bluesky" class="w-8 h-8" />
</a> </a>
@@ -25,7 +24,6 @@
class="inline-flex hover:opacity-80 transition-opacity" class="inline-flex hover:opacity-80 transition-opacity"
aria-label="Follow on Twitter" aria-label="Follow on Twitter"
data-umami-event="Twitter clicked" data-umami-event="Twitter clicked"
onclick={() => (window as any).rybbit?.event("Twitter clicked")}
> >
<img src={TwitterLogo} alt="Twitter" class="w-8 h-8" /> <img src={TwitterLogo} alt="Twitter" class="w-8 h-8" />
</a> </a>
@@ -33,11 +31,10 @@
<div class="w-0.5 h-8 bg-gray-400 dark:bg-gray-600"></div> --> <div class="w-0.5 h-8 bg-gray-400 dark:bg-gray-600"></div> -->
<a <a
href="mailto:george+bibdle@silentsummit.co" href="mailto:george@snail.city"
class="inline-flex hover:opacity-80 transition-opacity" class="inline-flex hover:opacity-80 transition-opacity"
aria-label="Send email" aria-label="Send email"
data-umami-event="Email clicked" data-umami-event="Email clicked"
onclick={() => (window as any).rybbit?.event("Email clicked")}
> >
<svg <svg
class="w-8 h-8 text-gray-700 dark:text-gray-300" class="w-8 h-8 text-gray-700 dark:text-gray-300"
+995
View File
@@ -0,0 +1,995 @@
<script lang="ts">
import { onMount, onDestroy } from "svelte";
import { fly } from "svelte/transition";
import { bibleBooks } from "$lib/types/bible";
let {
isLoggedIn = false,
anonymousId = "",
localDate = "",
}: {
isLoggedIn?: boolean;
anonymousId?: string;
localDate?: string;
} = $props();
// ── Status (logged-in state) ───────────────────────────────────────────
type Status = {
canSubmit: boolean;
cooldownEndsAt: number | null;
lastSubmission: { scheduledDate: string; reference: string } | null;
upcoming: { scheduledDate: string; reference: string }[];
};
let status = $state<Status | null>(null);
let statusError = $state<string | null>(null);
// ── Bible structure (Book → chapters → verse counts) ──────────────────
type Structure = { bookId: string; chapters: number[] }[];
let structure = $state<Structure | null>(null);
// ── Selector state ─────────────────────────────────────────────────────
let selectedBookId = $state<string>("");
let selectedChapter = $state<number>(0);
let selectedVerse = $state<number>(0);
// ── Preview state ──────────────────────────────────────────────────────
type Preview = {
windowVerses: string[];
reference: string;
bookId: string;
selectedVerse: number;
};
let preview = $state<Preview | null>(null);
let previewLoading = $state(false);
// ── Submission state ───────────────────────────────────────────────────
let submitting = $state(false);
let submitError = $state<string | null>(null);
let submitResult = $state<{ scheduledDate: string; reference: string } | null>(
null,
);
// ── UI state ───────────────────────────────────────────────────────────
let expanded = $state(false);
let countdownText = $state("");
let countdownId: number | null = null;
// Book list grouped by Testament for the <select> optgroups.
const oldBooks = $derived(bibleBooks.filter((b) => b.testament === "old"));
const newBooks = $derived(bibleBooks.filter((b) => b.testament === "new"));
// Chapter list for the currently selected book (1..N).
const chapterCount = $derived(
structure && selectedBookId
? structure.find((b) => b.bookId === selectedBookId)?.chapters.length ??
0
: 0,
);
// Verse count for the currently selected chapter.
const verseCount = $derived(
structure && selectedBookId && selectedChapter
? structure.find((b) => b.bookId === selectedBookId)?.chapters[
selectedChapter - 1
] ?? 0
: 0,
);
// Whether the user is currently on cooldown (only meaningful when logged in).
const onCooldown = $derived(
!!status && !status.canSubmit && status.cooldownEndsAt !== null,
);
// Debounce handle for the live preview fetch.
let previewTimer: ReturnType<typeof setTimeout> | null = null;
function trackEvent(name: string) {
try {
(window as any).rybbit?.event?.(name);
} catch {
/* noop */
}
}
function fmtDateLong(dateStr: string): string {
// dateStr is YYYY-MM-DD; format as "August 24, 2026" in UTC to avoid drift.
const d = new Date(dateStr + "T00:00:00Z");
return d.toLocaleDateString("en-US", {
weekday: "long",
year: "numeric",
month: "long",
day: "numeric",
timeZone: "UTC",
});
}
function fmtDateVague(dateStr: string): string {
// dateStr is YYYY-MM-DD. Return a deliberately vague timeframe instead of
// revealing the exact scheduled date.
const scheduled = new Date(dateStr + "T00:00:00Z");
const now = new Date();
const today = new Date(
Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate()),
);
const diffDays = Math.round(
(scheduled.getTime() - today.getTime()) / (1000 * 60 * 60 * 24),
);
if (diffDays <= 14) return "a few days from now";
if (diffDays <= 60) return "a few weeks from now";
return "within the next few months";
}
async function loadStatus() {
if (!isLoggedIn || !localDate) return;
try {
const res = await fetch(
`/api/submit-verse/status?localDate=${encodeURIComponent(localDate)}`,
);
if (res.status === 401) {
status = null;
return;
}
if (!res.ok) {
statusError = "Couldn't load submission status.";
return;
}
status = await res.json();
} catch {
statusError = "Couldn't load submission status.";
}
}
async function loadStructure() {
if (structure) return;
try {
const res = await fetch("/api/bible/structure");
if (!res.ok) return;
const data = await res.json();
structure = data;
// Default selection: first book, chapter 1, verse 1.
if (data.length > 0 && !selectedBookId) {
selectedBookId = data[0].bookId;
selectedChapter = 1;
selectedVerse = 1;
}
} catch {
/* noop */
}
}
function fetchPreview() {
if (previewTimer) clearTimeout(previewTimer);
previewTimer = setTimeout(async () => {
if (!selectedBookId || !selectedChapter || !selectedVerse) {
preview = null;
return;
}
previewLoading = true;
try {
const res = await fetch(
`/api/verse-window?bookId=${encodeURIComponent(
selectedBookId,
)}&chapter=${selectedChapter}&verse=${selectedVerse}`,
);
if (res.ok) {
preview = await res.json();
}
} catch {
/* noop */
} finally {
previewLoading = false;
}
}, 250);
}
function onBookChange() {
selectedChapter = 1;
selectedVerse = 1;
submitError = null;
fetchPreview();
}
function onChapterChange() {
selectedVerse = 1;
submitError = null;
fetchPreview();
}
function onVerseChange() {
submitError = null;
fetchPreview();
}
async function handleSubmit() {
if (!isLoggedIn) return;
submitting = true;
submitError = null;
try {
const res = await fetch("/api/submit-verse", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
bookId: selectedBookId,
chapter: selectedChapter,
verse: selectedVerse,
localDate,
}),
});
const data = await res.json();
if (!res.ok) {
if (res.status === 429 && data?.cooldownEndsAt) {
// Refresh status so the cooldown UI kicks in.
await loadStatus();
submitError = "You're on cooldown — try again later.";
} else {
submitError = data?.error ?? "Submission failed.";
}
return;
}
submitResult = {
scheduledDate: data.scheduledDate,
reference: data.reference,
};
trackEvent("Submit a verse");
// Refresh status so the cooldown reflects the new submission.
await loadStatus();
} catch {
submitError = "Network error — please try again.";
} finally {
submitting = false;
}
}
function updateCountdown() {
if (!status?.cooldownEndsAt) {
countdownText = "";
return;
}
const diff = status.cooldownEndsAt - Date.now();
if (diff <= 0) {
countdownText = "";
// Cooldown elapsed — refresh status once.
loadStatus();
if (countdownId) {
clearInterval(countdownId);
countdownId = null;
}
return;
}
const days = Math.floor(diff / (1000 * 60 * 60 * 24));
const hours = Math.floor((diff % (1000 * 60 * 60 * 24)) / (1000 * 60 * 60));
const minutes = Math.floor((diff % (1000 * 60 * 60)) / (1000 * 60));
countdownText =
(days > 0 ? `${days}d ` : "") +
`${hours.toString().padStart(2, "0")}h ${minutes
.toString()
.padStart(2, "0")}m`;
}
onMount(() => {
if (isLoggedIn) {
loadStatus();
loadStructure();
}
});
// Start/stop the countdown timer as cooldown state changes.
$effect(() => {
if (onCooldown && status?.cooldownEndsAt && !countdownId) {
updateCountdown();
countdownId = window.setInterval(updateCountdown, 1000);
} else if (!onCooldown && countdownId) {
clearInterval(countdownId);
countdownId = null;
countdownText = "";
}
});
// (Re)load status + structure when the user logs in.
$effect(() => {
if (isLoggedIn) {
loadStatus();
loadStructure();
} else {
status = null;
structure = null;
expanded = false;
submitResult = null;
}
});
onDestroy(() => {
if (countdownId) clearInterval(countdownId);
if (previewTimer) clearTimeout(previewTimer);
});
</script>
<div class="signin-prompt submit-verse-wrap">
{#if submitResult}
<!-- ── Confirmation state (replaces the panel after success) ──────── -->
<div class="confirm-card" in:fly={{ y: -8, duration: 220 }}>
<p class="confirm-title">
✅ Your verse is scheduled for
<strong>{fmtDateVague(submitResult.scheduledDate)}</strong>
</p>
<p class="confirm-ref">{submitResult.reference}</p>
<button
type="button"
class="submit-another-btn"
onclick={() => {
submitResult = null;
expanded = false;
}}
>
Done
</button>
</div>
{:else if !isLoggedIn}
<!-- ── State 1: logged out — sign-in dropdown ─────────────────────── -->
<button
type="button"
class="progress-btn w-full"
aria-expanded={expanded}
onclick={() => (expanded = !expanded)}
data-umami-event="Submit a verse (logged out)"
>
<span>✨ Submit a verse</span>
<svg
class="progress-chev"
class:open={expanded}
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
stroke-width="2.5"
stroke-linecap="round"
stroke-linejoin="round"
aria-hidden="true"
>
<path d="m6 9 6 6 6-6" />
</svg>
</button>
{#if expanded}
<p class="signin-text text-gray-800 dark:text-gray-300">
Sign in to submit a verse for a future day
</p>
<form method="POST" action="/auth/apple" class="w-full">
<input type="hidden" name="anonymousId" value={anonymousId} />
<button
type="submit"
class="apple-signin-btn"
data-umami-event="Sign in with Apple"
>
<svg class="apple-icon" viewBox="0 0 24 24" fill="currentColor">
<path
d="M17.05 20.28c-.98.95-2.05.88-3.08.4-1.09-.5-2.08-.48-3.24 0-1.44.62-2.2.44-3.06-.4C2.79 15.25 3.51 7.59 9.05 7.31c1.35.07 2.29.74 3.08.8 1.18-.24 2.31-.93 3.57-.84 1.51.12 2.65.72 3.4 1.8-3.12 1.87-2.38 5.98.48 7.13-.57 1.5-1.31 2.99-2.54 4.09zM12.03 7.25c-.15-2.23 1.66-4.07 3.74-4.25.29 2.58-2.34 4.5-3.74 4.25z"
/>
</svg>
Sign in with Apple
</button>
</form>
<form method="POST" action="/auth/google" class="w-full">
<input type="hidden" name="anonymousId" value={anonymousId} />
<button
type="submit"
class="google-signin-btn"
data-umami-event="Sign in with Google"
>
<svg
class="google-icon"
viewBox="0 0 24 24"
xmlns="http://www.w3.org/2000/svg"
>
<path
fill="#4285F4"
d="M22.56 12.25c0-.78-.07-1.53-.2-2.25H12v4.26h5.92c-.26 1.37-1.04 2.53-2.21 3.31v2.77h3.57c2.08-1.92 3.28-4.74 3.28-8.09z"
/>
<path
fill="#34A853"
d="M12 23c2.97 0 5.46-.98 7.28-2.66l-3.57-2.77c-.98.66-2.23 1.06-3.71 1.06-2.86 0-5.29-1.93-6.16-4.53H2.18v2.84C3.99 20.53 7.7 23 12 23z"
/>
<path
fill="#FBBC05"
d="M5.84 14.09c-.22-.66-.35-1.36-.35-2.09s.13-1.43.35-2.09V7.07H2.18C1.43 8.55 1 10.22 1 12s.43 3.45 1.18 4.93l3.66-2.84z"
/>
<path
fill="#EA4335"
d="M12 5.38c1.62 0 3.06.56 4.21 1.64l3.15-3.15C17.45 2.09 14.97 1 12 1 7.7 1 3.99 3.47 2.18 7.07l3.66 2.84c.87-2.6 3.3-4.53 6.16-4.53z"
/>
</svg>
Sign in with Google
</button>
</form>
{/if}
{:else if onCooldown}
<!-- ── State 2: logged in, cooldown active — disabled + countdown on button ─── -->
<button
type="button"
class="progress-btn w-full progress-btn-disabled"
disabled
aria-disabled="true"
>
<!-- <span>✨ Submit a verse</span> -->
{#if countdownText}
<span class="countdown-inline" aria-hidden="true"
>⏳ {countdownText}</span
>
{:else}
<span class="lock-icon" aria-hidden="true">⏳</span>
{/if}
</button>
{:else}
<!-- ── State 3: logged in, can submit — selector + preview ────────── -->
<button
type="button"
class="progress-btn w-full"
aria-expanded={expanded}
onclick={() => (expanded = !expanded)}
data-umami-event="Submit a verse (logged in)"
>
<span>✨ Submit a verse</span>
<svg
class="progress-chev"
class:open={expanded}
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
stroke-width="2.5"
stroke-linecap="round"
stroke-linejoin="round"
aria-hidden="true"
>
<path d="m6 9 6 6 6-6" />
</svg>
</button>
{#if expanded}
<div class="submit-panel" in:fly={{ y: -8, duration: 220 }}>
{#if statusError}
<p class="panel-error">{statusError}</p>
{/if}
{#if !structure}
<p class="panel-hint">Loading Bible structure…</p>
{:else}
<div class="select-row">
<label class="select-label">
<span class="select-cap">Book</span>
<select
class="cascading-select"
value={selectedBookId}
onchange={(e) => {
selectedBookId = e.currentTarget.value;
onBookChange();
}}
>
<optgroup label="Old Testament">
{#each oldBooks as book (book.id)}
<option value={book.id}>{book.name}</option>
{/each}
</optgroup>
<optgroup label="New Testament">
{#each newBooks as book (book.id)}
<option value={book.id}>{book.name}</option>
{/each}
</optgroup>
</select>
</label>
<label class="select-label">
<span class="select-cap">Chapter</span>
<select
class="cascading-select"
value={selectedChapter}
onchange={(e) => {
selectedChapter = Number(e.currentTarget.value);
onChapterChange();
}}
>
{#if chapterCount === 0}
<option value={0}>—</option>
{:else}
{#each Array(chapterCount) as _, i (i)}
<option value={i + 1}>{i + 1}</option>
{/each}
{/if}
</select>
</label>
<label class="select-label">
<span class="select-cap">Verse</span>
<select
class="cascading-select"
value={selectedVerse}
onchange={(e) => {
selectedVerse = Number(e.currentTarget.value);
onVerseChange();
}}
>
{#if verseCount === 0}
<option value={0}>—</option>
{:else}
{#each Array(verseCount) as _, i (i)}
<option value={i + 1}>{i + 1}</option>
{/each}
{/if}
</select>
</label>
</div>
<!-- Live 3-verse preview -->
<div class="preview-card">
{#if previewLoading}
<p class="preview-hint">Loading preview…</p>
{:else if preview}
<p class="preview-ref">{preview.reference}</p>
<div class="preview-verses">
{#each preview.windowVerses as verseText, i (i)}
<p class="preview-verse">{verseText}</p>
{/each}
</div>
{:else}
<p class="preview-hint">Select a verse to preview.</p>
{/if}
</div>
{#if submitError}
<p class="panel-error">{submitError}</p>
{/if}
<button
type="button"
class="submit-btn"
disabled={submitting ||
!selectedBookId ||
!selectedChapter ||
!selectedVerse ||
!preview}
onclick={handleSubmit}
>
{submitting ? "Scheduling…" : "Submit verse"}
</button>
{#if status?.upcoming && status.upcoming.length > 0}
<p class="upcoming-text">
Your upcoming verse{status.upcoming.length > 1
? "s"
: ""}:
{#each status.upcoming as u, i (i)}
{#if i > 0}<span class="upcoming-sep">·</span>{/if}
<span class="upcoming-item"
>{u.reference} ({fmtDateVague(u.scheduledDate)})</span
>
{/each}
</p>
{/if}
{/if}
</div>
{/if}
{/if}
</div>
<style>
.submit-verse-wrap {
gap: 0.75rem;
}
/* Reuse WinScreen's neobrutalist .progress-btn base (scoped here too). */
:global(.submit-verse-wrap .progress-btn) {
display: flex;
align-items: center;
justify-content: center;
gap: 0.5rem;
padding: 0.85rem 1.25rem;
background: #fff;
color: #111;
border: 2px solid #000;
border-radius: 0.75rem;
font-size: 1rem;
font-weight: 700;
text-decoration: none;
cursor: pointer;
box-shadow: 6px 6px 0 0 #000;
transition:
transform 80ms ease,
box-shadow 80ms ease;
}
:global(.submit-verse-wrap .progress-btn:hover) {
transform: translate(-2px, -2px);
box-shadow: 8px 8px 0 0 #000;
}
:global(.submit-verse-wrap .progress-btn:active) {
transform: translate(2px, 2px);
box-shadow: 2px 2px 0 0 #000;
}
:global(.submit-verse-wrap .progress-chev) {
width: 1.25rem;
height: 1.25rem;
transition: transform 200ms ease;
}
:global(.submit-verse-wrap .progress-chev.open) {
transform: rotate(180deg);
}
@media (prefers-color-scheme: dark) {
:global(.submit-verse-wrap .progress-btn) {
background: #111827;
color: #f9fafb;
border-color: #fff;
box-shadow: 6px 6px 0 0 #fff;
}
:global(.submit-verse-wrap .progress-btn:hover) {
box-shadow: 8px 8px 0 0 #fff;
}
:global(.submit-verse-wrap .progress-btn:active) {
box-shadow: 2px 2px 0 0 #fff;
}
}
/* Disabled (cooldown) variant. */
:global(.submit-verse-wrap .progress-btn-disabled) {
opacity: 0.55;
cursor: not-allowed;
box-shadow: 4px 4px 0 0 #000;
}
:global(.submit-verse-wrap .progress-btn-disabled:hover),
:global(.submit-verse-wrap .progress-btn-disabled:active) {
transform: none;
box-shadow: 4px 4px 0 0 #000;
}
@media (prefers-color-scheme: dark) {
:global(.submit-verse-wrap .progress-btn-disabled) {
box-shadow: 4px 4px 0 0 #fff;
}
:global(.submit-verse-wrap .progress-btn-disabled:hover),
:global(.submit-verse-wrap .progress-btn-disabled:active) {
box-shadow: 4px 4px 0 0 #fff;
}
}
.lock-icon {
font-size: 1rem;
}
.countdown-inline {
font-size: 0.85rem;
font-weight: 700;
font-variant-numeric: tabular-nums;
letter-spacing: 0.01em;
opacity: 0.85;
}
.signin-text {
font-size: 0.85rem;
text-align: center;
font-weight: 500;
}
/* ── Apple / Google sign-in buttons (mirror WinScreen) ── */
:global(.submit-verse-wrap .apple-signin-btn),
:global(.submit-verse-wrap .google-signin-btn) {
display: flex;
align-items: center;
justify-content: center;
gap: 0.5rem;
padding: 0.6rem 1rem;
width: 100%;
background: #000;
color: #fff;
border-radius: 0.5rem;
font-size: 0.95rem;
font-weight: 600;
border: none;
cursor: pointer;
transition:
background 150ms ease,
transform 80ms ease;
}
:global(.submit-verse-wrap .apple-signin-btn) {
margin-bottom: 0.6rem;
}
:global(.submit-verse-wrap .apple-signin-btn:hover),
:global(.submit-verse-wrap .google-signin-btn:hover) {
background: #222;
transform: translateY(-1px);
}
:global(.submit-verse-wrap .apple-signin-btn:active),
:global(.submit-verse-wrap .google-signin-btn:active) {
background: #111;
transform: scale(0.98);
}
@media (prefers-color-scheme: dark) {
:global(.submit-verse-wrap .apple-signin-btn),
:global(.submit-verse-wrap .google-signin-btn) {
background: #fff;
color: #000;
}
:global(.submit-verse-wrap .apple-signin-btn:hover),
:global(.submit-verse-wrap .google-signin-btn:hover) {
background: #e5e5e5;
}
:global(.submit-verse-wrap .apple-signin-btn:active),
:global(.submit-verse-wrap .google-signin-btn:active) {
background: #ccc;
}
}
:global(.submit-verse-wrap .apple-icon),
:global(.submit-verse-wrap .google-icon) {
width: 1.1rem;
height: 1.1rem;
flex-shrink: 0;
}
/* ── Submit panel ── */
.submit-panel {
display: flex;
flex-direction: column;
gap: 0.85rem;
width: 100%;
padding: 1rem;
background: oklch(94% 0.028 298.626);
border: 2px solid #000;
border-radius: 0.75rem;
box-shadow: 6px 6px 0 0 #000;
}
@media (prefers-color-scheme: dark) {
.submit-panel {
background: oklch(22% 0.025 298.626);
border-color: #fff;
box-shadow: 6px 6px 0 0 #fff;
}
}
.panel-hint,
.preview-hint {
font-size: 0.85rem;
color: #6b7280;
text-align: center;
}
@media (prefers-color-scheme: dark) {
.panel-hint,
.preview-hint {
color: #9ca3af;
}
}
.panel-error {
font-size: 0.85rem;
color: #b91c1c;
text-align: center;
font-weight: 600;
}
@media (prefers-color-scheme: dark) {
.panel-error {
color: #f87171;
}
}
.select-row {
display: flex;
gap: 0.5rem;
flex-wrap: wrap;
}
.select-label {
display: flex;
flex-direction: column;
gap: 0.25rem;
flex: 1;
min-width: 5rem;
}
.select-cap {
font-size: 0.7rem;
font-weight: 700;
text-transform: uppercase;
letter-spacing: 0.08em;
color: #6b7280;
}
@media (prefers-color-scheme: dark) {
.select-cap {
color: #9ca3af;
}
}
.cascading-select {
width: 100%;
padding: 0.5rem 0.6rem;
border: 2px solid #000;
border-radius: 0.5rem;
background: #fff;
color: #111;
font-size: 0.9rem;
font-weight: 600;
cursor: pointer;
}
@media (prefers-color-scheme: dark) {
.cascading-select {
background: #111827;
color: #f9fafb;
border-color: #fff;
}
}
/* ── Preview card ── */
.preview-card {
padding: 0.75rem;
border: 1px solid rgba(0, 0, 0, 0.15);
border-radius: 0.5rem;
background: rgba(255, 255, 255, 0.5);
}
@media (prefers-color-scheme: dark) {
.preview-card {
border-color: rgba(255, 255, 255, 0.15);
background: rgba(0, 0, 0, 0.25);
}
}
.preview-ref {
font-size: 0.8rem;
font-weight: 700;
color: #374151;
margin-bottom: 0.4rem;
}
@media (prefers-color-scheme: dark) {
.preview-ref {
color: #d1d5db;
}
}
.preview-verses {
display: flex;
flex-direction: column;
gap: 0.35rem;
}
.preview-verse {
font-size: 0.82rem;
line-height: 1.45;
color: #4b5563;
font-style: italic;
}
@media (prefers-color-scheme: dark) {
.preview-verse {
color: #9ca3af;
}
}
/* ── Submit button (neobrutalist) ── */
.submit-btn {
padding: 0.7rem 1rem;
background: #16a34a;
color: #fff;
border: 2px solid #000;
border-radius: 0.6rem;
font-size: 0.95rem;
font-weight: 700;
cursor: pointer;
box-shadow: 4px 4px 0 0 #000;
transition:
transform 80ms ease,
box-shadow 80ms ease,
background-color 120ms ease;
}
.submit-btn:hover:not(:disabled) {
transform: translate(-2px, -2px);
box-shadow: 6px 6px 0 0 #000;
background: #15803d;
}
.submit-btn:active:not(:disabled) {
transform: translate(2px, 2px);
box-shadow: 2px 2px 0 0 #000;
}
.submit-btn:disabled {
opacity: 0.55;
cursor: not-allowed;
}
@media (prefers-color-scheme: dark) {
.submit-btn {
border-color: #fff;
box-shadow: 4px 4px 0 0 #fff;
}
.submit-btn:hover:not(:disabled) {
box-shadow: 6px 6px 0 0 #fff;
}
.submit-btn:active:not(:disabled) {
box-shadow: 2px 2px 0 0 #fff;
}
}
/* ── Upcoming list ── */
.upcoming-text {
font-size: 0.72rem;
color: #6b7280;
text-align: center;
line-height: 1.5;
}
@media (prefers-color-scheme: dark) {
.upcoming-text {
color: #9ca3af;
}
}
.upcoming-item {
font-weight: 600;
}
.upcoming-sep {
margin: 0 0.25rem;
opacity: 0.6;
}
/* ── Confirmation card ── */
.confirm-card {
display: flex;
flex-direction: column;
gap: 0.5rem;
align-items: center;
width: 100%;
padding: 1.1rem;
background: oklch(94% 0.028 298.626);
border: 2px solid #000;
border-radius: 0.75rem;
box-shadow: 6px 6px 0 0 #000;
text-align: center;
}
@media (prefers-color-scheme: dark) {
.confirm-card {
background: oklch(22% 0.025 298.626);
border-color: #fff;
box-shadow: 6px 6px 0 0 #fff;
}
}
.confirm-title {
font-size: 1rem;
font-weight: 700;
color: #111;
}
@media (prefers-color-scheme: dark) {
.confirm-title {
color: #f9fafb;
}
}
.confirm-ref {
font-size: 0.85rem;
font-weight: 600;
color: #374151;
}
@media (prefers-color-scheme: dark) {
.confirm-ref {
color: #d1d5db;
}
}
.submit-another-btn {
padding: 0.5rem 1.1rem;
background: #fff;
color: #111;
border: 2px solid #000;
border-radius: 0.5rem;
font-size: 0.85rem;
font-weight: 700;
cursor: pointer;
box-shadow: 3px 3px 0 0 #000;
transition:
transform 80ms ease,
box-shadow 80ms ease;
}
.submit-another-btn:hover {
transform: translate(-1px, -1px);
box-shadow: 4px 4px 0 0 #000;
}
.submit-another-btn:active {
transform: translate(1px, 1px);
box-shadow: 2px 2px 0 0 #000;
}
@media (prefers-color-scheme: dark) {
.submit-another-btn {
background: #111827;
color: #f9fafb;
border-color: #fff;
box-shadow: 3px 3px 0 0 #fff;
}
.submit-another-btn:hover {
box-shadow: 4px 4px 0 0 #fff;
}
.submit-another-btn:active {
box-shadow: 2px 2px 0 0 #fff;
}
}
</style>
+10 -4
View File
@@ -1,14 +1,21 @@
<script lang="ts"> <script lang="ts">
import { browser } from "$app/environment"; import { browser } from "$app/environment";
import { fade } from "svelte/transition"; import { fade } from "svelte/transition";
import type { PageData } from "../../routes/$types.js"; // Approximate type; adjust if needed
import Container from "./Container.svelte"; import Container from "./Container.svelte";
interface VerseDisplayData {
dailyVerse: {
date: string;
reference: string;
verseText: string;
};
}
let { let {
data, data,
isWon, isWon,
blurChapter = false, blurChapter = false,
}: { data: PageData; isWon: boolean; blurChapter?: boolean } = $props(); }: { data: VerseDisplayData; isWon: boolean; blurChapter?: boolean } = $props();
let dailyVerse = $derived(data.dailyVerse); let dailyVerse = $derived(data.dailyVerse);
let displayReference = $derived( let displayReference = $derived(
blurChapter blurChapter
@@ -19,7 +26,7 @@
); );
let displayVerseText = $derived( let displayVerseText = $derived(
dailyVerse.verseText dailyVerse.verseText
.replace(/^([a-z])/, (c) => c.toUpperCase()) .replace(/^([a-z])/, (c: string) => c.toUpperCase())
.replace(/[,:;-—]$/, "..."), .replace(/[,:;-—]$/, "..."),
); );
@@ -55,7 +62,6 @@
function copyVerse() { function copyVerse() {
navigator.clipboard.writeText(displayVerseText).then(() => { navigator.clipboard.writeText(displayVerseText).then(() => {
copied = true; copied = true;
(window as any).rybbit?.event("Copy Verse");
setTimeout(() => { setTimeout(() => {
copied = false; copied = false;
}, 2000); }, 2000);
+305 -23
View File
@@ -10,6 +10,8 @@
import CountdownTimer from "./CountdownTimer.svelte"; import CountdownTimer from "./CountdownTimer.svelte";
import StreakCounter from "./StreakCounter.svelte"; import StreakCounter from "./StreakCounter.svelte";
import ChapterGuess from "./ChapterGuess.svelte"; import ChapterGuess from "./ChapterGuess.svelte";
import SubmitVerse from "./SubmitVerse.svelte";
import { track } from "$lib/utils/analytics";
interface StatsData { interface StatsData {
solveRank: number; solveRank: number;
@@ -40,7 +42,8 @@
streak = 0, streak = 0,
streakPercentile = null, streakPercentile = null,
isLoggedIn = false, isLoggedIn = false,
anonymousId = '', anonymousId = "",
localDate = "",
}: { }: {
statsData: StatsData | null; statsData: StatsData | null;
correctBookId: string; correctBookId: string;
@@ -57,6 +60,7 @@
streakPercentile?: number | null; streakPercentile?: number | null;
isLoggedIn?: boolean; isLoggedIn?: boolean;
anonymousId?: string; anonymousId?: string;
localDate?: string;
} = $props(); } = $props();
let bookName = $derived(getBookById(correctBookId)?.name ?? ""); let bookName = $derived(getBookById(correctBookId)?.name ?? "");
@@ -68,6 +72,7 @@
let copyTracked = $state(false); let copyTracked = $state(false);
let showSnippetOption = $state(false); let showSnippetOption = $state(false);
let includeSnippet = $state(false); let includeSnippet = $state(false);
let showProgressDropdown = $state(false);
let effectiveShareText = $derived( let effectiveShareText = $derived(
includeSnippet includeSnippet
@@ -237,7 +242,9 @@
{/if} {/if}
<div class="share-card" in:fly={{ y: 40, duration: 400, delay: 600 }}> <div class="share-card" in:fly={{ y: 40, duration: 400, delay: 600 }}>
<div class="big-text font-black! text-center">Share your result</div> <div class="big-text font-black! text-center text-gray-300!">
Share your result
</div>
<div class="chat-window"> <div class="chat-window">
<!-- Received bubble: primary action (share / copy) --> <!-- Received bubble: primary action (share / copy) -->
<div class="bubble-wrapper received-wrapper"> <div class="bubble-wrapper received-wrapper">
@@ -250,15 +257,13 @@
: "Copy to Clipboard"} : "Copy to Clipboard"}
onclick={() => { onclick={() => {
if (hasWebShare) { if (hasWebShare) {
(window as any).rybbit?.event("Share"); track("share", { snippet: includeSnippet });
shareResult(effectiveShareText); shareResult(effectiveShareText);
} else { } else {
if (!copyTracked) { if (!copyTracked) {
(window as any).rybbit?.event(
"Copy to Clipboard",
);
copyTracked = true; copyTracked = true;
} }
track("share_copy", { snippet: includeSnippet });
clipboardCopy(effectiveShareText); clipboardCopy(effectiveShareText);
copySuccess = true; copySuccess = true;
setTimeout(() => { setTimeout(() => {
@@ -285,9 +290,9 @@
data-umami-event="Copy to Clipboard" data-umami-event="Copy to Clipboard"
onclick={() => { onclick={() => {
if (!copyTracked) { if (!copyTracked) {
(window as any).rybbit?.event("Copy to Clipboard");
copyTracked = true; copyTracked = true;
} }
track("share_copy", { snippet: includeSnippet });
clipboardCopy(effectiveShareText); clipboardCopy(effectiveShareText);
showSnippetOption = true; showSnippetOption = true;
bubbleCopied = true; bubbleCopied = true;
@@ -307,6 +312,11 @@
{/if} {/if}
</div> </div>
</div> </div>
{#if streak >= 7}
<div class="big-text tracking-widest! font-black! text-center mt-4">
Thank you for making Bibdle part of your daily routine! —George
</div>
{/if}
</div> </div>
{#if showSnippetOption} {#if showSnippetOption}
@@ -324,23 +334,142 @@
</div> </div>
{/if} {/if}
{#if !isLoggedIn} {#if isLoggedIn}
<div class="signin-prompt"> <div class="signin-prompt">
<p class="signin-text">Sign in to save your streak &amp; see your stats</p> <a
<form method="POST" action="/auth/apple"> href="/progress"
class="progress-btn w-full"
data-umami-event="See your progress (logged in)"
>
<span>📈 See your progress</span>
<svg class="progress-chev" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
<path d="m9 18 6-6-6-6" />
</svg>
</a>
</div>
{:else}
<div class="signin-prompt">
<button
type="button"
class="progress-btn w-full"
aria-expanded={showProgressDropdown}
onclick={() => (showProgressDropdown = !showProgressDropdown)}
data-umami-event="See your progress (logged out)"
>
<span>📈 See your progress</span>
<svg class="progress-chev" class:open={showProgressDropdown} viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
<path d="m6 9 6 6 6-6" />
</svg>
</button>
{#if showProgressDropdown}
<p class="signin-text text-gray-800 dark:text-gray-300">
Create an account (or sign in) to track your progress
</p>
<form method="POST" action="/auth/apple" class="w-full">
<input type="hidden" name="anonymousId" value={anonymousId} /> <input type="hidden" name="anonymousId" value={anonymousId} />
<button <button
type="submit" type="submit"
class="apple-signin-btn" class="apple-signin-btn"
data-umami-event="Sign in with Apple"
> >
<svg class="apple-icon" viewBox="0 0 24 24" fill="currentColor"> <svg
<path d="M17.05 20.28c-.98.95-2.05.88-3.08.4-1.09-.5-2.08-.48-3.24 0-1.44.62-2.2.44-3.06-.4C2.79 15.25 3.51 7.59 9.05 7.31c1.35.07 2.29.74 3.08.8 1.18-.24 2.31-.93 3.57-.84 1.51.12 2.65.72 3.4 1.8-3.12 1.87-2.38 5.98.48 7.13-.57 1.5-1.31 2.99-2.54 4.09zM12.03 7.25c-.15-2.23 1.66-4.07 3.74-4.25.29 2.58-2.34 4.5-3.74 4.25z"/> class="apple-icon"
viewBox="0 0 24 24"
fill="currentColor"
>
<path
d="M17.05 20.28c-.98.95-2.05.88-3.08.4-1.09-.5-2.08-.48-3.24 0-1.44.62-2.2.44-3.06-.4C2.79 15.25 3.51 7.59 9.05 7.31c1.35.07 2.29.74 3.08.8 1.18-.24 2.31-.93 3.57-.84 1.51.12 2.65.72 3.4 1.8-3.12 1.87-2.38 5.98.48 7.13-.57 1.5-1.31 2.99-2.54 4.09zM12.03 7.25c-.15-2.23 1.66-4.07 3.74-4.25.29 2.58-2.34 4.5-3.74 4.25z"
/>
</svg> </svg>
Sign in with Apple Sign in with Apple
</button> </button>
</form> </form>
<form method="POST" action="/auth/google" class="w-full">
<input type="hidden" name="anonymousId" value={anonymousId} />
<button
type="submit"
class="google-signin-btn"
data-umami-event="Sign in with Google"
>
<svg
class="google-icon"
viewBox="0 0 24 24"
xmlns="http://www.w3.org/2000/svg"
>
<path
fill="#4285F4"
d="M22.56 12.25c0-.78-.07-1.53-.2-2.25H12v4.26h5.92c-.26 1.37-1.04 2.53-2.21 3.31v2.77h3.57c2.08-1.92 3.28-4.74 3.28-8.09z"
/>
<path
fill="#34A853"
d="M12 23c2.97 0 5.46-.98 7.28-2.66l-3.57-2.77c-.98.66-2.23 1.06-3.71 1.06-2.86 0-5.29-1.93-6.16-4.53H2.18v2.84C3.99 20.53 7.7 23 12 23z"
/>
<path
fill="#FBBC05"
d="M5.84 14.09c-.22-.66-.35-1.36-.35-2.09s.13-1.43.35-2.09V7.07H2.18C1.43 8.55 1 10.22 1 12s.43 3.45 1.18 4.93l3.66-2.84z"
/>
<path
fill="#EA4335"
d="M12 5.38c1.62 0 3.06.56 4.21 1.64l3.15-3.15C17.45 2.09 14.97 1 12 1 7.7 1 3.99 3.47 2.18 7.07l3.66 2.84c.87-2.6 3.3-4.53 6.16-4.53z"
/>
</svg>
Sign in with Google
</button>
</form>
{/if}
</div> </div>
{/if} {/if}
<SubmitVerse
{isLoggedIn}
{anonymousId}
{localDate}
/>
<div class="signin-prompt">
<a
href="https://discord.gg/yWQXbGK8SD"
target="_blank"
rel="noopener noreferrer"
class="discord-btn w-full"
data-umami-event="Join the BIBDLE Discord"
onclick={() => track("discord_click")}
>
<svg
class="discord-icon"
viewBox="0 0 127.14 96.36"
fill="currentColor"
aria-hidden="true"
>
<path
d="M107.7,8.07A105.15,105.15,0,0,0,81.47,0a72.06,72.06,0,0,0-3.36,6.83A97.68,97.68,0,0,0,49,6.83,72.37,72.37,0,0,0,45.64,0,105.89,105.89,0,0,0,19.39,8.09C2.79,32.65-1.71,56.6.54,80.21h0A105.73,105.73,0,0,0,32.71,96.36,77.7,77.7,0,0,0,39.6,85.25a68.42,68.42,0,0,1-10.85-5.18c.91-.66,1.8-1.34,2.66-2a75.57,75.57,0,0,0,64.32,0c.87.71,1.76,1.39,2.66,2a68.68,68.68,0,0,1-10.87,5.19,77,77,0,0,0,6.89,11.1A105.25,105.25,0,0,0,126.6,80.22h0C129.24,52.84,122.09,29.11,107.7,8.07ZM42.45,65.69C36.18,65.69,31,60,31,53s5-12.74,11.43-12.74S54,46,53.89,53,48.84,65.69,42.45,65.69Zm42.24,0C78.41,65.69,73.25,60,73.25,53s5-12.74,11.44-12.74S96.23,46,96.12,53,91.08,65.69,84.69,65.69Z"
/>
</svg>
<span>Join the BIBDLE Discord!</span>
<svg class="progress-chev" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
<path d="m9 18 6-6-6-6" />
</svg>
</a>
</div>
<div class="signin-prompt">
<a
href="https://donate.stripe.com/9B6aEZ9WgeZF3qYfF987K00"
target="_blank"
rel="noopener noreferrer"
class="progress-btn w-full"
data-umami-event="Support bibdle's development"
onclick={() => track("donate_click")}
>
<span>❤️ Support bibdle's development</span>
<svg class="progress-chev" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
<path d="m9 18 6-6-6-6" />
</svg>
</a>
<div class="big-text font-black! text-center text-gray-300! mt-2">
BIBDLE will be ad-free forever.
</div>
</div>
</div> </div>
<style> <style>
@@ -621,34 +750,137 @@
transform: translateX(16px); transform: translateX(16px);
} }
/* ── Apple Sign In prompt ── */ /* ── See your progress button (neobrutalist) ── */
.progress-btn {
display: flex;
align-items: center;
justify-content: center;
gap: 0.5rem;
padding: 0.85rem 1.25rem;
background: #fff;
color: #111;
border: 2px solid #000;
border-radius: 0.75rem;
font-size: 1rem;
font-weight: 700;
text-decoration: none;
cursor: pointer;
box-shadow: 6px 6px 0 0 #000;
transition:
transform 80ms ease,
box-shadow 80ms ease;
}
.progress-btn:hover {
transform: translate(-2px, -2px);
box-shadow: 8px 8px 0 0 #000;
}
.progress-btn:active {
transform: translate(2px, 2px);
box-shadow: 2px 2px 0 0 #000;
}
.progress-chev {
width: 1.25rem;
height: 1.25rem;
transition: transform 200ms ease;
}
.progress-chev.open {
transform: rotate(180deg);
}
@media (prefers-color-scheme: dark) {
.progress-btn {
background: #111827;
color: #f9fafb;
border-color: #fff;
box-shadow: 6px 6px 0 0 #fff;
}
.progress-btn:hover {
box-shadow: 8px 8px 0 0 #fff;
}
.progress-btn:active {
box-shadow: 2px 2px 0 0 #fff;
}
}
.signin-prompt { .signin-prompt {
display: flex; display: flex;
flex-direction: column; flex-direction: column;
align-items: center; align-items: center;
gap: 0.75rem; gap: 0.75rem;
padding: 1rem 0 0.25rem; /*padding: 1rem 0 0.25rem;*/
}
/* ── Discord button (neobrutalist, discord purple) ── */
.discord-btn {
display: flex;
align-items: center;
justify-content: center;
gap: 0.5rem;
padding: 0.85rem 1.25rem;
background: #5865f2;
color: #fff;
border: 2px solid #000;
border-radius: 0.75rem;
font-size: 1rem;
font-weight: 700;
text-decoration: none;
cursor: pointer;
box-shadow: 6px 6px 0 0 #000;
transition:
transform 80ms ease,
box-shadow 80ms ease,
background-color 120ms ease;
}
.discord-btn:hover {
transform: translate(-2px, -2px);
box-shadow: 8px 8px 0 0 #000;
background: #4752c4;
}
.discord-btn:active {
transform: translate(2px, 2px);
box-shadow: 2px 2px 0 0 #000;
background: #3c45a5;
}
@media (prefers-color-scheme: dark) {
.discord-btn {
border-color: #fff;
box-shadow: 6px 6px 0 0 #fff;
}
.discord-btn:hover {
box-shadow: 8px 8px 0 0 #fff;
}
.discord-btn:active {
box-shadow: 2px 2px 0 0 #fff;
}
}
.discord-icon {
width: 1.25rem;
height: 1.25rem;
flex-shrink: 0;
} }
.signin-text { .signin-text {
font-size: 0.85rem; font-size: 0.85rem;
color: #555;
text-align: center; text-align: center;
font-weight: 500; font-weight: 500;
} }
@media (prefers-color-scheme: dark) {
.signin-text {
color: #aaa;
}
}
.apple-signin-btn { .apple-signin-btn {
display: flex; display: flex;
align-items: center; align-items: center;
justify-content: center; justify-content: center;
gap: 0.5rem; gap: 0.5rem;
padding: 0.6rem 1.5rem; padding: 0.6rem 1rem;
width: 100%;
margin-bottom: 0.6rem;
background: #000; background: #000;
color: #fff; color: #fff;
border-radius: 0.5rem; border-radius: 0.5rem;
@@ -656,7 +888,9 @@
font-weight: 600; font-weight: 600;
border: none; border: none;
cursor: pointer; cursor: pointer;
transition: background 150ms ease, transform 80ms ease; transition:
background 150ms ease,
transform 80ms ease;
} }
.apple-signin-btn:hover { .apple-signin-btn:hover {
@@ -687,4 +921,52 @@
height: 1.1rem; height: 1.1rem;
flex-shrink: 0; flex-shrink: 0;
} }
.google-signin-btn {
display: flex;
align-items: center;
justify-content: center;
gap: 0.5rem;
padding: 0.6rem 1rem;
width: 100%;
background: #000;
color: #fff;
border-radius: 0.5rem;
font-size: 0.95rem;
font-weight: 600;
border: none;
cursor: pointer;
transition:
background 150ms ease,
transform 80ms ease;
}
.google-signin-btn:hover {
background: #222;
transform: translateY(-1px);
}
.google-signin-btn:active {
background: #111;
transform: scale(0.98);
}
@media (prefers-color-scheme: dark) {
.google-signin-btn {
background: #fff;
color: #000;
}
.google-signin-btn:hover {
background: #e5e5e5;
}
.google-signin-btn:active {
background: #ccc;
}
}
.google-icon {
width: 1.1rem;
height: 1.1rem;
flex-shrink: 0;
}
</style> </style>
+33
View File
@@ -0,0 +1,33 @@
<script lang="ts">
interface Item {
label: string;
value: number;
color?: string;
sub?: string;
}
interface Props {
items: Item[];
format?: (v: number) => string;
signed?: boolean;
}
let { items, format = (v) => String(v), signed = false }: Props = $props();
const maxAbs = $derived(Math.max(1, ...items.map((i) => Math.abs(i.value))));
</script>
<div class="flex w-full flex-col gap-1.5">
{#each items as item (item.label)}
<div class="flex items-center gap-2 text-xs">
<span class="w-20 shrink-0 text-gray-400">{item.label}</span>
<div class="relative h-4 flex-1 overflow-hidden rounded bg-white/5">
<div
class="absolute top-0 h-full rounded {item.value < 0 ? 'right-1/2 bg-rose-500/60' : 'left-0'}"
style={`width:${(Math.abs(item.value) / maxAbs) * 100}%;${item.value < 0 ? '' : `background:${item.color ?? 'rgba(56,189,248,0.5)'}`}`}
></div>
</div>
<span class="w-16 shrink-0 text-right font-medium text-gray-200">
{signed && item.value >= 0 ? '+' : ''}{format(item.value)}
</span>
</div>
{/each}
</div>
@@ -0,0 +1,58 @@
<script lang="ts">
interface Props {
data: { date: string; count: number }[];
color?: string;
}
let { data, color = '52,211,153' }: Props = $props();
const values = $derived(new Map(data.map((d) => [d.date, d.count])));
const max = $derived(Math.max(1, ...data.map((d) => d.count)));
// Build Sunday-aligned weeks ending on the last date.
const weeks = $derived.by(() => {
if (data.length === 0) return [] as { date: string; inRange: boolean }[][];
const first = new Date(data[0].date + 'T00:00:00Z');
const start = new Date(first);
start.setUTCDate(start.getUTCDate() - start.getUTCDay());
const last = new Date(data[data.length - 1].date + 'T00:00:00Z');
const end = new Date(last);
end.setUTCDate(end.getUTCDate() + (6 - end.getUTCDay()));
const range = new Set(data.map((d) => d.date));
const out: { date: string; inRange: boolean }[][] = [];
let cursor = new Date(start);
while (cursor <= end) {
const week: { date: string; inRange: boolean }[] = [];
for (let d = 0; d < 7; d++) {
const iso = cursor.toISOString().slice(0, 10);
week.push({ date: iso, inRange: range.has(iso) });
cursor.setUTCDate(cursor.getUTCDate() + 1);
}
out.push(week);
}
return out;
});
</script>
<div class="overflow-x-auto">
<div class="flex gap-1">
<div class="flex flex-col justify-between py-0.5 text-[9px] text-gray-500">
<span>Sun</span><span>Wed</span><span>Sat</span>
</div>
<div class="flex gap-[3px]">
{#each weeks as week, wi (wi)}
<div class="flex flex-col gap-[3px]">
{#each week as cell (cell.date)}
{@const count = values.get(cell.date) ?? 0}
<div
class="h-3 w-3 rounded-[2px]"
style={cell.inRange
? `background:rgba(${color},${(0.12 + 0.88 * (count / max)).toFixed(3)})`
: 'background:transparent'}
title={cell.inRange ? `${cell.date}: ${count} finishes` : cell.date}
></div>
{/each}
</div>
{/each}
</div>
</div>
</div>
@@ -0,0 +1,47 @@
<script lang="ts">
import type { CohortRow } from '$lib/types/stats';
interface Props {
cohorts: CohortRow[];
weeks?: number;
}
let { cohorts, weeks = 8 }: Props = $props();
function shade(rate: number | null): string {
if (rate === null) return 'background:rgba(255,255,255,0.03)';
const t = Math.min(1, rate / 100);
return `background:rgba(16,185,129,${(0.08 + 0.82 * t).toFixed(3)})`;
}
</script>
<div class="overflow-x-auto">
<table class="border-separate border-spacing-0.5 text-[10px] text-gray-400">
<thead>
<tr>
<th class="pr-2 text-right font-normal">Cohort</th>
<th class="pr-2 font-normal">Size</th>
{#each Array(weeks) as _w, k (k)}
<th class="w-8 font-normal">W{k}</th>
{/each}
</tr>
</thead>
<tbody>
{#each cohorts as row (row.weekStart)}
<tr>
<td class="pr-2 text-right whitespace-nowrap text-gray-300">{row.weekStart.slice(5)}</td>
<td class="pr-2 text-right text-gray-400">{row.size}</td>
{#each Array(weeks) as _w, k (k)}
{@const rate = row.rates[k] ?? null}
<td
class="h-6 w-8 rounded-sm text-center align-middle text-gray-900"
style={shade(rate)}
title={`Week ${k}: ${rate === null ? 'not resolved' : rate + '%'}`}
>
{rate === null ? '' : Math.round(rate)}
</td>
{/each}
</tr>
{/each}
</tbody>
</table>
</div>
@@ -0,0 +1,54 @@
<script lang="ts">
interface Props {
rowLabels: string[];
colLabels: string[];
values: number[][];
max?: number;
color?: string;
format?: (v: number) => string;
cellSize?: number;
}
let {
rowLabels,
colLabels,
values,
max,
color = '16,185,129',
format = (v) => String(v),
cellSize = 22
}: Props = $props();
const effectiveMax = $derived(
max ?? Math.max(1, ...values.flat().filter((v) => Number.isFinite(v)))
);
</script>
<div class="overflow-x-auto">
<table class="border-separate border-spacing-0.5 text-[10px] text-gray-400">
<thead>
<tr>
<th></th>
{#each colLabels as label, c (c)}
<th class="px-0.5 font-normal">{label}</th>
{/each}
</tr>
</thead>
<tbody>
{#each rowLabels as row, r (r)}
<tr>
<th class="pr-1 text-right font-normal whitespace-nowrap">{row}</th>
{#each colLabels as _label, c (c)}
{@const v = values[r]?.[c] ?? 0}
<td
class="rounded-sm text-center align-middle text-[9px] text-gray-900"
style={`width:${cellSize}px;height:${cellSize}px;background:rgba(${color},${Math.min(1, v / effectiveMax).toFixed(3)})`}
title={`${row} · ${colLabels[c]}: ${format(v)}`}
>
{v > 0 ? format(v) : ''}
</td>
{/each}
</tr>
{/each}
</tbody>
</table>
</div>
@@ -0,0 +1,254 @@
<script lang="ts">
interface Series {
name: string;
color: string;
points: { date: string; value: number | null }[];
step?: boolean;
}
interface Props {
series: Series[];
height?: number;
ySuffix?: string;
yMin?: number;
yMax?: number;
showLegend?: boolean;
}
let {
series,
height = 180,
ySuffix = '',
yMin,
yMax,
showLegend = true
}: Props = $props();
const W = 600;
const pad = { l: 36, r: 10, t: 10, b: 22 };
const innerW = W - pad.l - pad.r;
const innerH = $derived(height - pad.t - pad.b);
const allValues = $derived(
series.flatMap((s) => s.points.map((p) => p.value)).filter((v): v is number => v !== null)
);
const domain = $derived.by(() => {
const lo = yMin ?? (allValues.length ? Math.min(...allValues) : 0);
const hi = yMax ?? (allValues.length ? Math.max(...allValues) : 1);
const span = hi - lo || 1;
return { lo: yMin ?? lo - span * 0.1, hi: yMax ?? hi + span * 0.1 };
});
const pointCount = $derived(
Math.max(1, ...series.map((s) => s.points.length))
);
function xAt(i: number): number {
if (pointCount <= 1) return pad.l + innerW / 2;
return pad.l + (i / (pointCount - 1)) * innerW;
}
function yAt(v: number): number {
const t = (v - domain.lo) / (domain.hi - domain.lo || 1);
return pad.t + innerH - t * innerH;
}
/** Break a series into path segments so nulls create gaps. */
const paths = $derived(
series.map((s) => {
const segments: string[] = [];
let current: string[] = [];
s.points.forEach((p, i) => {
if (p.value === null) {
if (current.length) segments.push(current.join(' '));
current = [];
return;
}
current.push(`${xAt(i).toFixed(1)},${yAt(p.value).toFixed(1)}`);
});
if (current.length) segments.push(current.join(' '));
return { name: s.name, color: s.color, segments, step: s.step };
})
);
const firstLabel = $derived(series[0]?.points[0]?.date?.slice(5) ?? '');
const lastLabel = $derived(
series[0]?.points[series[0].points.length - 1]?.date?.slice(5) ?? ''
);
// --- Hover / tooltip state -------------------------------------------------
let wrapperEl: HTMLDivElement | undefined = $state();
let hoverIndex = $state<number | null>(null);
function handlePointerMove(event: PointerEvent) {
if (!wrapperEl || pointCount <= 0) return;
const rect = wrapperEl.getBoundingClientRect();
if (rect.width === 0) return;
const scale = rect.width / W;
const svgX = (event.clientX - rect.left) / scale;
if (pointCount <= 1) {
hoverIndex = 0;
return;
}
const t = (svgX - pad.l) / innerW;
const i = Math.round(t * (pointCount - 1));
hoverIndex = Math.min(pointCount - 1, Math.max(0, i));
}
function clearHover() {
hoverIndex = null;
}
/** Rows shown in the tooltip for the currently hovered index. */
const hoverRows = $derived.by(() => {
const i = hoverIndex;
if (i === null) return [];
return series.map((s) => ({
name: s.name,
color: s.color,
value: s.points[i]?.value ?? null
}));
});
const hoveredDate = $derived.by(() => {
if (hoverIndex === null) return null;
for (const s of series) {
const point = s.points[hoverIndex];
if (point) return point.date;
}
return null;
});
const hasHoverValues = $derived(hoverRows.some((r) => r.value !== null));
const tooltipLeft = $derived(
hoverIndex === null ? 50 : Math.min(85, Math.max(15, (xAt(hoverIndex) / W) * 100))
);
function formatValue(value: number | null): string {
if (value === null) return '—';
const rounded = Number.isInteger(value) ? value : Number(value.toFixed(1));
return `${rounded.toLocaleString()}${ySuffix}`;
}
</script>
<div
class="relative w-full touch-pan-y"
bind:this={wrapperEl}
role="presentation"
onpointermove={handlePointerMove}
onpointerleave={clearHover}
onpointercancel={clearHover}
>
<svg
viewBox={`0 0 ${W} ${height}`}
class="w-full text-gray-400"
style={`height:${height}px`}
role="img"
>
<!-- gridlines -->
{#each [0, 0.5, 1] as t}
<line
x1={pad.l}
x2={W - pad.r}
y1={pad.t + innerH * t}
y2={pad.t + innerH * t}
stroke="currentColor"
stroke-opacity="0.15"
stroke-dasharray="2 3"
/>
{/each}
<text x={4} y={pad.t + 4} fill="currentColor" fill-opacity="0.8" font-size="9">
{domain.hi.toFixed(0)}{ySuffix}
</text>
<text x={4} y={pad.t + innerH} fill="currentColor" fill-opacity="0.8" font-size="9">
{domain.lo.toFixed(0)}{ySuffix}
</text>
{#each paths as s (s.name)}
{#each s.segments as d}
<polyline
points={d}
fill="none"
stroke={s.color}
stroke-width="1.75"
stroke-linejoin="round"
stroke-linecap="round"
vector-effect="non-scaling-stroke"
opacity={hoverIndex === null ? 1 : 0.45}
style="transition:opacity 120ms ease"
/>
{/each}
{/each}
{#if hoverIndex !== null}
<!-- crosshair -->
<line
x1={xAt(hoverIndex)}
x2={xAt(hoverIndex)}
y1={pad.t}
y2={pad.t + innerH}
stroke="currentColor"
stroke-opacity="0.5"
stroke-dasharray="3 3"
vector-effect="non-scaling-stroke"
/>
<!-- highlighted points -->
{#each hoverRows as row (row.name)}
{#if row.value !== null}
<circle
cx={xAt(hoverIndex)}
cy={yAt(row.value)}
r="3.5"
fill={row.color}
stroke="#0b0b12"
stroke-width="1.5"
vector-effect="non-scaling-stroke"
/>
{/if}
{/each}
{/if}
<text x={pad.l} y={height - 6} fill="currentColor" fill-opacity="0.8" font-size="9">
{firstLabel}
</text>
<text
x={W - pad.r}
y={height - 6}
text-anchor="end"
fill="currentColor"
fill-opacity="0.8"
font-size="9"
>
{lastLabel}
</text>
</svg>
{#if hoverIndex !== null && hoveredDate !== null && hasHoverValues}
<div
class="pointer-events-none absolute top-1 z-10 -translate-x-1/2 rounded-lg border border-white/15 bg-gray-900/95 px-2.5 py-1.5 text-[11px] leading-tight text-gray-100 shadow-lg backdrop-blur-sm"
style={`left:${tooltipLeft}%`}
>
<p class="mb-1 font-semibold text-gray-300">{hoveredDate}</p>
<ul class="flex flex-col gap-0.5">
{#each hoverRows as row (row.name)}
<li class="flex items-center justify-between gap-3">
<span class="inline-flex items-center gap-1.5">
<span class="h-2 w-2 shrink-0 rounded-full" style={`background:${row.color}`}></span>
{row.name}
</span>
<span class="font-semibold tabular-nums text-gray-100">{formatValue(row.value)}</span>
</li>
{/each}
</ul>
</div>
{/if}
{#if showLegend && series.length > 1}
<div class="mt-1 flex flex-wrap gap-3 text-[11px] text-gray-300">
{#each series as s (s.name)}
<span class="inline-flex items-center gap-1">
<span class="h-2 w-2 rounded-full" style={`background:${s.color}`}></span>
{s.name}
</span>
{/each}
</div>
{/if}
</div>
@@ -0,0 +1,49 @@
<script lang="ts">
interface Props {
values: number[];
width?: number;
height?: number;
class?: string;
stroke?: string;
}
let {
values,
width = 120,
height = 32,
class: className = '',
stroke = 'currentColor'
}: Props = $props();
const points = $derived.by(() => {
if (values.length === 0) return '';
const min = Math.min(...values);
const max = Math.max(...values);
const span = max - min || 1;
return values
.map((v, i) => {
const x = values.length === 1 ? width / 2 : (i / (values.length - 1)) * width;
const y = height - ((v - min) / span) * (height - 4) - 2;
return `${x.toFixed(1)},${y.toFixed(1)}`;
})
.join(' ');
});
</script>
<svg
viewBox={`0 0 ${width} ${height}`}
class={className}
preserveAspectRatio="none"
aria-hidden="true"
>
{#if points}
<polyline
{points}
fill="none"
{stroke}
stroke-width="1.5"
stroke-linejoin="round"
stroke-linecap="round"
vector-effect="non-scaling-stroke"
/>
{/if}
</svg>
@@ -0,0 +1,32 @@
<script lang="ts">
import type { SignalSeverity } from '$lib/types/stats';
interface Props {
severity: SignalSeverity;
children?: import('svelte').Snippet;
label?: string;
}
let { severity, children, label }: Props = $props();
const styles: Record<SignalSeverity, string> = {
good: 'bg-emerald-500/15 text-emerald-300 border-emerald-500/30',
info: 'bg-sky-500/15 text-sky-300 border-sky-500/30',
warn: 'bg-amber-500/15 text-amber-200 border-amber-500/30',
bad: 'bg-rose-500/15 text-rose-300 border-rose-500/30'
};
const dots: Record<SignalSeverity, string> = {
good: 'bg-emerald-400',
info: 'bg-sky-400',
warn: 'bg-amber-400',
bad: 'bg-rose-400'
};
</script>
<span
class="inline-flex items-center gap-1.5 rounded-full border px-2.5 py-0.5 text-xs font-semibold {styles[
severity
]}"
>
<span class="h-1.5 w-1.5 rounded-full {dots[severity]}"></span>
{#if children}{@render children()}{:else}{label}{/if}
</span>
@@ -0,0 +1,147 @@
<script lang="ts">
import { bibleBooks, type BibleSection, type Testament } from '$lib/types/bible';
import type { BookStat } from '$lib/types/stats';
interface Props {
coverage: BookStat[];
}
let { coverage }: Props = $props();
interface Tile extends BookStat {
name: string;
}
interface SectionGroup {
section: BibleSection;
testament: Testament;
books: Tile[];
days: number;
plays: number;
covered: number;
firstTryWeightedSum: number;
firstTryPlays: number;
}
const byId = $derived(new Map(coverage.map((c) => [c.bookId, c])));
const maxDays = $derived(Math.max(1, ...coverage.map((c) => c.days)));
const totalDays = $derived(coverage.reduce((a, b) => a + b.days, 0));
const totalPlays = $derived(coverage.reduce((a, b) => a + b.plays, 0));
/** Red → orange → yellow → green, driven by days featured relative to the busiest book. */
function coverageColor(days: number): string {
if (days <= 0) return 'hsl(220, 9%, 55%)';
const t = Math.min(1, days / maxDays);
return `hsl(${Math.round(t * 142)}, 78%, 55%)`;
}
const legendStops = [0, 0.25, 0.5, 0.75, 1];
const legendGradient = $derived(
`linear-gradient(90deg, ${legendStops
.map((t) => `hsl(${Math.round(t * 142)}, 78%, 55%) ${Math.round(t * 100)}%`)
.join(', ')})`
);
const legendTicks = $derived(legendStops.map((t) => Math.round(t * maxDays)));
/** Consecutive runs of books sharing a section (preserves canonical order). */
const groups = $derived.by(() => {
const out: SectionGroup[] = [];
for (const book of bibleBooks) {
const stat = byId.get(book.id);
if (!stat) continue;
let group = out[out.length - 1];
if (!group || group.section !== book.section || group.testament !== book.testament) {
group = {
section: book.section,
testament: book.testament,
books: [],
days: 0,
plays: 0,
covered: 0,
firstTryWeightedSum: 0,
firstTryPlays: 0
};
out.push(group);
}
group.books.push({ ...stat, name: book.name });
group.days += stat.days;
group.plays += stat.plays;
if (stat.days > 0) group.covered++;
if (stat.plays > 0) {
group.firstTryWeightedSum += stat.firstTryPct * stat.plays;
group.firstTryPlays += stat.plays;
}
}
return out;
});
</script>
<div class="flex w-full flex-col gap-5">
<!-- Numeric colour legend -->
<div class="flex flex-col gap-1">
<div class="flex items-center justify-between text-[10px] font-semibold uppercase tracking-wider text-gray-400">
<span>Featured less</span>
<span>Days featured →</span>
<span>Featured more</span>
</div>
<div class="h-3 w-full rounded-full ring-1 ring-inset ring-white/10" style={`background:${legendGradient}`}></div>
<div class="flex justify-between text-[10px] tabular-nums text-gray-300">
{#each legendTicks as tick}
<span class="font-semibold">{tick}</span>
{/each}
</div>
<p class="flex items-center gap-1.5 text-[10px] text-gray-500">
<span class="inline-block h-2.5 w-2.5 rounded-sm ring-1 ring-inset ring-white/10" style="background:hsl(220, 9%, 55%)"></span>
never featured (0 days)
</p>
</div>
<!-- Sections -->
<div class="flex flex-col gap-6">
{#each groups as group (group.testament + group.section)}
{@const share = totalDays ? Math.round((group.days / totalDays) * 100) : 0}
{@const avgFirstTry = group.firstTryPlays
? Math.round(group.firstTryWeightedSum / group.firstTryPlays)
: null}
<div class="flex flex-col gap-2">
<div class="flex flex-wrap items-baseline justify-between gap-x-4 gap-y-1 border-b border-white/10 pb-1">
<h3 class="flex items-center gap-2 text-sm font-bold text-gray-100">
{group.section}
<span class="rounded bg-white/10 px-1.5 py-0.5 text-[10px] font-semibold uppercase tracking-wide text-gray-300">
{group.testament === 'old' ? 'OT' : 'NT'}
</span>
</h3>
<p class="text-[11px] text-gray-400">
<span class="font-semibold text-gray-200">{group.covered}/{group.books.length}</span> books covered ·
<span class="font-semibold text-gray-200">{group.days}</span> days ({share}%) ·
<span class="font-semibold text-gray-200">{group.plays}</span> plays
{#if avgFirstTry !== null}
· avg first-try <span class="font-semibold text-gray-200">{avgFirstTry}%</span>
{/if}
</p>
</div>
<div class="h-1 w-full overflow-hidden rounded-full bg-white/5">
<div
class="h-full rounded-full bg-white/40"
style={`width:${share}%`}
></div>
</div>
<div class="grid grid-cols-4 gap-1.5 sm:grid-cols-6 md:grid-cols-8 lg:grid-cols-11">
{#each group.books as book (book.bookId)}
<div
class="flex min-h-11 flex-col items-center justify-center rounded-lg bg-white/5 px-1 py-1 text-center ring-1 ring-inset ring-white/10 transition-colors duration-100 hover:bg-white/10"
title={`${book.name}: featured ${book.days} day${book.days === 1 ? '' : 's'}, ${book.plays} play${book.plays === 1 ? '' : 's'}`}
>
<span class="text-[10px] font-bold uppercase tracking-wider text-gray-400">{book.bookId}</span>
<span class="text-base font-bold leading-tight" style={`color:${coverageColor(book.days)}`}>{book.days}</span>
</div>
{/each}
</div>
</div>
{/each}
</div>
<p class="text-[11px] text-gray-500">
66 books over the last 180 days · {totalDays} featured days · {totalPlays} plays. Colour is scaled
to the busiest book ({maxDays} day{maxDays === 1 ? '' : 's'}). Hover a tile for full details.
</p>
</div>
@@ -0,0 +1,61 @@
<script lang="ts">
import DateNavigator from './DateNavigator.svelte';
import SettingsMenu from './SettingsMenu.svelte';
import { formatDateLabel } from '$lib/utils/stats-format';
import type { StatsSettings } from '$lib/types/stats';
interface Props {
date: string;
today: string;
generatedAt: Date;
buildKind: string;
matured: boolean;
stale: boolean;
settings: StatsSettings;
}
let { date, today, generatedAt, buildKind, matured, stale, settings }: Props = $props();
const matureHref = $derived(
`/admin/stats?date=${date}${matured ? '' : '&mature=1'}`
);
const generatedLabel = $derived(
generatedAt instanceof Date ? generatedAt.toISOString().slice(0, 16).replace('T', ' ') : ''
);
</script>
<header
class="sticky top-0 z-20 -mx-4 mb-4 border-b border-white/10 bg-gray-950/85 px-4 py-3 backdrop-blur"
>
<div class="mx-auto flex max-w-6xl flex-col gap-3">
<div class="flex flex-wrap items-center justify-between gap-3">
<div class="flex items-center gap-3">
<a href="/" class="text-sm text-gray-400 hover:text-gray-200">← Game</a>
<h1 class="text-xl font-bold text-gray-100">Growth Console</h1>
</div>
<div class="flex flex-wrap items-center gap-2">
<DateNavigator {date} {today} mature={matured} />
<a
href={matureHref}
class="rounded-lg border px-3 py-1.5 text-xs font-semibold {matured
? 'border-amber-400/50 bg-amber-400/15 text-amber-200'
: 'border-white/10 bg-white/5 text-gray-300 hover:bg-white/10'}"
>
{matured ? 'Matured view ✓' : 'Mature this view'}
</a>
</div>
</div>
<div class="flex flex-wrap items-center gap-2">
<p class="text-xs text-gray-400">
Showing <span class="font-semibold text-gray-200">{formatDateLabel(date)}</span>
· snapshot built {generatedLabel} UTC
{#if buildKind}<span class="uppercase tracking-wide"> · {buildKind}</span>{/if}
{#if matured}
<span class="font-semibold text-amber-300"> · Matured — uses data after this date.</span>
{/if}
</p>
</div>
<SettingsMenu {settings} {stale} />
</div>
</header>
@@ -0,0 +1,65 @@
<script lang="ts">
import { goto } from '$app/navigation';
interface Props {
date: string;
today: string;
mature: boolean;
}
let { date, today, mature }: Props = $props();
function shift(dateStr: string, n: number): string {
const d = new Date(dateStr + 'T00:00:00Z');
d.setUTCDate(d.getUTCDate() + n);
return d.toISOString().slice(0, 10);
}
const hrefFor = (d: string) => `/admin/stats?date=${d}${mature ? '&mature=1' : ''}`;
const prev = $derived(shift(date, -1));
const next = $derived(shift(date, 1));
const nextDisabled = $derived(next > today);
function onDateChange(event: Event) {
const value = (event.currentTarget as HTMLInputElement).value;
if (value) goto(hrefFor(value));
}
</script>
<div class="flex flex-wrap items-center gap-2">
<a
href={hrefFor(prev)}
class="rounded-lg border border-white/10 bg-white/5 px-3 py-1.5 text-sm text-gray-200 hover:bg-white/10"
aria-label="Previous day"
>
←
</a>
<input
type="date"
value={date}
max={today}
onchange={onDateChange}
class="rounded-lg border border-white/10 bg-black/30 px-2 py-1.5 text-sm text-gray-100 focus:border-blue-400 focus:outline-none"
/>
{#if nextDisabled}
<span
class="cursor-not-allowed rounded-lg border border-white/5 bg-white/5 px-3 py-1.5 text-sm text-gray-600"
aria-label="Next day (unavailable)"
>
→
</span>
{:else}
<a
href={hrefFor(next)}
class="rounded-lg border border-white/10 bg-white/5 px-3 py-1.5 text-sm text-gray-200 hover:bg-white/10"
aria-label="Next day"
>
→
</a>
{/if}
<a
href={hrefFor(today)}
class="rounded-lg border border-white/10 bg-white/5 px-3 py-1.5 text-xs font-semibold text-gray-300 hover:bg-white/10"
>
Latest
</a>
</div>
@@ -0,0 +1,20 @@
<script lang="ts">
import Container from '$lib/components/Container.svelte';
</script>
<section class="flex flex-col gap-3">
<h2 class="text-lg font-bold text-gray-100">7 · Feature Impact</h2>
<Container class="p-4 w-full items-start text-left gap-2">
<p class="font-semibold text-gray-100">Needs data</p>
<p class="text-xs text-gray-400">
Feature-usage events are deferred. The <code>analytics_events</code> table already supports
them; only the emit points remain. Once added, this panel will show:
</p>
<ul class="list-disc pl-5 text-xs text-gray-400">
<li>Imposter-mode entries and their return rate</li>
<li>Hint reveals per finish and whether they help retention</li>
<li>Progress-page visits as a signup/retention signal</li>
<li>Verse submissions and their effect on next-day return</li>
</ul>
</Container>
</section>
+54
View File
@@ -0,0 +1,54 @@
<script lang="ts">
import Container from '$lib/components/Container.svelte';
interface GlossaryEntry {
name: string;
definition: string;
action: string;
}
/** Mirrors statistics-plan.md §5. Single source for on-page definitions. */
const GLOSSARY: GlossaryEntry[] = [
{ name: 'Players today', definition: 'Finished the puzzle yesterday.', action: 'Investigate content or traffic.' },
{ name: 'WAU / MAU', definition: 'Played at least once in the last 7 / 30 days.', action: 'Reach vs habit.' },
{ name: 'Core players', definition: 'Finished 4+ times this week.', action: 'If falling, it is a retention problem.' },
{ name: 'Returning share', definition: 'Played before today vs. first time.', action: 'Low = acquisition-heavy and leaky.' },
{ name: 'D1 return', definition: 'First-timers who came back the next day.', action: 'The number one activation lever.' },
{ name: 'Return rate (any)', definition: 'Played again within N days.', action: 'Onboarding quality.' },
{ name: 'Overall return rate', definition: 'Ever played more than once.', action: 'Overall stickiness.' },
{ name: 'Net growth', definition: 'New + resurrected − churned.', action: 'Is the base expanding?' },
{ name: 'Completion rate', definition: 'Started → finished.', action: 'Friction or confusion.' },
{ name: 'Signup rate', definition: 'Players who made an account.', action: 'Account value.' },
{ name: 'First-try rate', definition: 'Solved with no wrong guesses.', action: 'Too high = giveaway; too low = brutal.' },
{ name: 'Share rate', definition: 'Shares ÷ finishes.', action: 'Virality.' },
{ name: 'Streak survival', definition: 'Chance a streak continues.', action: 'Streak feature return on investment.' }
];
</script>
<section class="flex flex-col gap-3">
<h2 class="text-lg font-bold text-gray-100">8 · Notes &amp; Glossary</h2>
<Container class="p-2 md:p-4 w-full overflow-x-auto">
<table class="w-full text-left text-sm text-gray-200">
<thead class="border-b border-white/10 text-xs uppercase text-gray-400">
<tr>
<th class="px-2 py-2 md:px-3">Metric</th>
<th class="px-2 py-2 md:px-3">Plain definition</th>
<th class="px-2 py-2 md:px-3">What to do if it's off</th>
</tr>
</thead>
<tbody>
{#each GLOSSARY as entry (entry.name)}
<tr class="border-b border-white/5 align-top">
<td class="px-2 py-2 font-medium md:px-3">{entry.name}</td>
<td class="px-2 py-2 text-gray-300 md:px-3">{entry.definition}</td>
<td class="px-2 py-2 text-gray-400 md:px-3">{entry.action}</td>
</tr>
{/each}
</tbody>
</table>
</Container>
<p class="text-xs text-gray-500">
Snapshots are point-in-time. A day where a metric did not exist shows
“—”.
</p>
</section>
@@ -0,0 +1,96 @@
<script lang="ts">
import Container from '$lib/components/Container.svelte';
import MiniLineChart from '$lib/components/charts/MiniLineChart.svelte';
import BarList from '$lib/components/charts/BarList.svelte';
import type { SnapshotPayload } from '$lib/types/stats';
import { signed, numOrDash } from '$lib/utils/stats-format';
interface Props {
payload: SnapshotPayload;
}
let { payload }: Props = $props();
const series = $derived(payload.dailySeries.slice(-60));
const hasStarted = $derived(payload.meta.hasStartedData);
const signupTotal = $derived(payload.growth.signups.reduce((a, b) => a + b.count, 0));
</script>
<section class="flex flex-col gap-3">
<h2 class="text-lg font-bold text-gray-100">2 · Growth Loop</h2>
<Container class="p-4 w-full items-stretch text-left gap-2">
<p class="font-semibold text-gray-100">New players per day</p>
<p class="text-xs text-gray-400">First-time players each day. Hover later for post annotations.</p>
<MiniLineChart
series={[{ name: 'New players', color: '#60a5fa', points: series.map((d) => ({ date: d.date, value: d.newPlayers })) }]}
showLegend={false}
/>
</Container>
<div class="grid gap-3 md:grid-cols-2">
<Container class="p-4 w-full items-stretch text-left gap-2">
<p class="font-semibold text-gray-100">Acquisition vs churn (7d)</p>
<p class="text-xs text-gray-400">
New + resurrected − churned = net. Week-over-week.
</p>
<BarList
signed
items={[
{ label: 'New', value: payload.activity.newPlayers, color: 'rgba(96,165,250,0.6)' },
{ label: 'Resurrected', value: payload.activity.resurrected, color: 'rgba(52,211,153,0.6)' },
{ label: 'Churned', value: -payload.activity.churned, color: 'rgba(251,113,133,0.6)' },
{ label: 'Net', value: payload.activity.netGrowth, color: 'rgba(167,139,250,0.6)' }
]}
/>
<p class="text-xs text-gray-400">Net growth: <span class="font-semibold text-gray-200">{signed(payload.activity.netGrowth)}</span></p>
</Container>
<Container class="p-4 w-full items-stretch text-left gap-2">
<p class="font-semibold text-gray-100">Lifecycle funnel</p>
<p class="text-xs text-gray-400">
Of everyone active in the tracked window, how many reached each play count.
</p>
<BarList
items={payload.growth.lifecycleFunnel.map((f) => ({
label: f.label,
value: f.players,
color: 'rgba(52,211,153,0.5)'
}))}
/>
</Container>
</div>
<div class="grid gap-3 md:grid-cols-2">
<Container class="p-4 w-full items-stretch text-left gap-2">
<p class="font-semibold text-gray-100">Started → finished</p>
{#if hasStarted}
<p class="text-xs text-gray-400">
Completion rate {payload.kpis.completionRate ?? '—'}%. Started counts distinct
players who loaded the verse.
</p>
<MiniLineChart
series={[
{ name: 'Started', color: '#f59e0b', points: series.map((d) => ({ date: d.date, value: d.started })) },
{ name: 'Finished', color: '#34d399', points: series.map((d) => ({ date: d.date, value: d.completions })) }
]}
/>
{:else}
<p class="text-sm text-gray-400">
Needs data. Once players load the game this shows start → finish.
</p>
{/if}
</Container>
<Container class="p-4 w-full items-stretch text-left gap-2">
<p class="font-semibold text-gray-100">Signups</p>
<p class="text-xs text-gray-400">
Account creations ({numOrDash(signupTotal)} in the last 90 days). Existing accounts show
“unknown” date.
</p>
<MiniLineChart
series={[{ name: 'Signups', color: '#a78bfa', points: payload.growth.signups.map((s) => ({ date: s.date, value: s.count })) }]}
showLegend={false}
/>
</Container>
</div>
</section>
+68
View File
@@ -0,0 +1,68 @@
<script lang="ts">
import Container from '$lib/components/Container.svelte';
import MiniLineChart from '$lib/components/charts/MiniLineChart.svelte';
import BarList from '$lib/components/charts/BarList.svelte';
import CalendarHeatmap from '$lib/components/charts/CalendarHeatmap.svelte';
import HeatmapGrid from '$lib/components/charts/HeatmapGrid.svelte';
import type { SnapshotPayload } from '$lib/types/stats';
interface Props {
payload: SnapshotPayload;
}
let { payload }: Props = $props();
const dayLabels = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
const hourLabels = Array.from({ length: 24 }, (_, h) => (h % 3 === 0 ? String(h) : ''));
</script>
<section class="flex flex-col gap-3">
<h2 class="text-lg font-bold text-gray-100">5 · Habit Lab</h2>
<div class="grid gap-3 md:grid-cols-2">
<Container class="p-4 w-full items-stretch text-left gap-2">
<p class="font-semibold text-gray-100">Streak survival</p>
<p class="text-xs text-gray-400">
If you've played N days in a row, how likely are you to play day N+1.
</p>
<MiniLineChart
series={[
{
name: 'Survival',
color: '#34d399',
points: payload.habit.streakSurvival.map((s) => ({ date: String(s.length), value: s.probability }))
}
]}
showLegend={false}
ySuffix="%"
/>
</Container>
<Container class="p-4 w-full items-stretch text-left gap-2">
<p class="font-semibold text-gray-100">Current streak lengths</p>
<p class="text-xs text-gray-400">Players whose current run has reached each length.</p>
<BarList
items={payload.habit.streakLengths.map((b) => ({ label: `${b.label} days`, value: b.value, color: 'rgba(251,191,36,0.5)' }))}
/>
</Container>
</div>
<Container class="p-4 w-full items-stretch text-left gap-2">
<p class="font-semibold text-gray-100">Daily finishes (last 120 days)</p>
<CalendarHeatmap data={payload.habit.calendar} />
</Container>
<Container class="p-4 w-full items-stretch text-left gap-2">
<p class="font-semibold text-gray-100">When people play</p>
<p class="text-xs text-gray-400">
Finishes by weekday and hour. Times are server time (UTC) and therefore approximate.
</p>
<HeatmapGrid
rowLabels={dayLabels}
colLabels={hourLabels}
values={payload.habit.weekdayHour}
color="96,165,250"
cellSize={16}
format={(v) => String(v)}
/>
</Container>
</section>
+61
View File
@@ -0,0 +1,61 @@
<script lang="ts">
import Container from '$lib/components/Container.svelte';
import Sparkline from '$lib/components/charts/Sparkline.svelte';
import type { SignalSeverity } from '$lib/types/stats';
interface Props {
label: string;
value: string;
caption?: string;
delta?: string;
deltaDirection?: 'up' | 'down' | 'flat';
sparkValues?: number[];
severity?: SignalSeverity;
}
let {
label,
value,
caption,
delta,
deltaDirection = 'flat',
sparkValues = [],
severity
}: Props = $props();
const deltaClass = $derived(
deltaDirection === 'up'
? 'text-emerald-400'
: deltaDirection === 'down'
? 'text-rose-400'
: 'text-gray-400'
);
const strokeColor = $derived(
severity === 'bad'
? '#fb7185'
: severity === 'warn'
? '#fbbf24'
: '#34d399'
);
</script>
<Container class="p-4 w-full items-start text-left">
<div class="flex items-start justify-between gap-2 w-full">
<p class="text-[11px] font-semibold uppercase tracking-wider text-gray-400">
{label}
</p>
{#if delta}
<span class="text-xs font-semibold {deltaClass}">{delta}</span>
{/if}
</div>
<p class="mt-1 text-2xl font-bold text-gray-100">{value}</p>
{#if sparkValues.length > 1}
<Sparkline
values={sparkValues}
stroke={strokeColor}
class="mt-2 w-full h-8 text-gray-500"
/>
{/if}
{#if caption}
<p class="mt-1 text-xs leading-snug text-gray-400">{caption}</p>
{/if}
</Container>
+103
View File
@@ -0,0 +1,103 @@
<script lang="ts">
import KpiCard from './KpiCard.svelte';
import StatusPill from '$lib/components/charts/StatusPill.svelte';
import type { Signal, SnapshotPayload, StatsSettings } from '$lib/types/stats';
import {
delta,
numOrDash,
pctOrDash,
signed
} from '$lib/utils/stats-format';
interface Props {
payload: SnapshotPayload;
settings: StatsSettings;
verdict: string;
topSignal: Signal | null;
}
let { payload, settings, verdict, topSignal }: Props = $props();
const series = $derived(payload.dailySeries.slice(-30));
const spark = $derived(series.map((d) => d.completions));
const newSpark = $derived(series.map((d) => d.newPlayers));
const d1Severity = $derived(
payload.kpis.d1Return === null
? 'info'
: payload.kpis.d1Return >= settings.d1_target
? 'good'
: payload.kpis.d1Return < 12
? 'bad'
: 'warn'
);
</script>
<section class="flex flex-col gap-3">
<div class="flex flex-wrap items-center gap-2">
<h2 class="text-lg font-bold text-gray-100">1 · Pulse</h2>
{#if topSignal}
<StatusPill severity={topSignal.severity}>{topSignal.title}</StatusPill>
{/if}
</div>
<div
class="rounded-2xl border border-white/10 bg-white/5 p-3 text-sm text-gray-200"
>
{verdict}
</div>
<div class="grid grid-cols-2 gap-3 lg:grid-cols-4">
<KpiCard
label="Players today"
value={numOrDash(payload.activity.dau)}
delta={delta(payload.activity.dau, payload.activity.previous?.dau).text}
deltaDirection={delta(payload.activity.dau, payload.activity.previous?.dau).direction}
sparkValues={spark}
caption="Finished yesterday's verse."
/>
<KpiCard
label="Players this week"
value={numOrDash(payload.activity.wau)}
delta={delta(payload.activity.wau, payload.activity.previous?.wau).text}
deltaDirection={delta(payload.activity.wau, payload.activity.previous?.wau).direction}
caption="Distinct players in the last 7 days."
/>
<KpiCard
label="Players this month"
value={numOrDash(payload.activity.mau)}
delta={delta(payload.activity.mau, payload.activity.previous?.mau).text}
deltaDirection={delta(payload.activity.mau, payload.activity.previous?.mau).direction}
caption="Distinct players in the last 30 days."
/>
<KpiCard
label="Core players"
value={numOrDash(payload.activity.core)}
delta={delta(payload.activity.core, payload.activity.corePrevious).text}
deltaDirection={delta(payload.activity.core, payload.activity.corePrevious).direction}
caption={`Finished ${settings.core_plays_per_week}+ times this week.`}
/>
<KpiCard
label="New players"
value={numOrDash(payload.activity.newPlayers)}
sparkValues={newSpark}
caption="First-time players in the last 7 days."
/>
<KpiCard
label="Returning share"
value={pctOrDash(payload.activity.returningShare)}
caption="Of yesterday's players, how many had played before."
/>
<KpiCard
label="D1 return"
value={pctOrDash(payload.kpis.d1Return)}
severity={d1Severity}
delta={`target ${settings.d1_target}%`}
caption="First-timers who came back the next day."
/>
<KpiCard
label="Net growth (7d)"
value={signed(payload.activity.netGrowth)}
caption={`New + returning − churned (${payload.activity.newPlayers} + ${payload.activity.resurrected} − ${payload.activity.churned}).`}
/>
</div>
</section>
@@ -0,0 +1,83 @@
<script lang="ts">
import Container from '$lib/components/Container.svelte';
import CohortHeatmap from '$lib/components/charts/CohortHeatmap.svelte';
import MiniLineChart from '$lib/components/charts/MiniLineChart.svelte';
import BarList from '$lib/components/charts/BarList.svelte';
import type { SnapshotPayload, StatsSettings } from '$lib/types/stats';
import { pctOrDash, numOrDash } from '$lib/utils/stats-format';
interface Props {
payload: SnapshotPayload;
settings: StatsSettings;
}
let { payload, settings }: Props = $props();
const mix = $derived(payload.retention.segmentMix);
const colors = ['#60a5fa', '#34d399', '#a78bfa', '#f59e0b', '#fb7185'];
</script>
<section class="flex flex-col gap-3">
<h2 class="text-lg font-bold text-gray-100">3 · Retention Lab</h2>
<div class="grid gap-3 md:grid-cols-2">
<Container class="p-4 w-full items-start text-left">
<p class="text-[11px] font-semibold uppercase tracking-wider text-gray-400">
Overall return rate
</p>
<p class="text-2xl font-bold text-gray-100">
{pctOrDash(payload.kpis.overallReturnRate)}
</p>
<p class="text-xs text-gray-400">
Share of all players who ever played more than once. Target:
{settings.return7_target}%+ within 7 days.
</p>
</Container>
<Container class="p-4 w-full items-start text-left">
<p class="text-[11px] font-semibold uppercase tracking-wider text-gray-400">
Time to second play
</p>
<BarList items={payload.retention.timeToSecondPlay.map((b) => ({ label: b.label, value: b.value }))} />
</Container>
</div>
<Container class="p-4 w-full items-stretch text-left gap-2">
<p class="font-semibold text-gray-100">Cohort retention triangle</p>
<p class="text-xs text-gray-400">
Each row is a starting week; each column is weeks later. Darker = more came back.
Only resolved weeks are filled.
</p>
<CohortHeatmap cohorts={payload.retention.cohorts} weeks={8} />
</Container>
<Container class="p-4 w-full items-stretch text-left gap-2">
<p class="font-semibold text-gray-100">Retention curves</p>
<p class="text-xs text-gray-400">
D1 / D7 / D30 return over time. Latest resolvable cohorts only.
</p>
<MiniLineChart
series={[
{ name: 'D1', color: '#34d399', points: payload.retention.curves.d1 },
{ name: 'D7', color: '#60a5fa', points: payload.retention.curves.d7 },
{ name: 'D30', color: '#a78bfa', points: payload.retention.curves.d30 }
]}
ySuffix="%"
/>
</Container>
<Container class="p-4 w-full items-stretch text-left gap-2">
<p class="font-semibold text-gray-100">Segment mix over time</p>
<p class="text-xs text-gray-400">
Active players split into new, core, returning, at-risk and churned. Total tracked:
{numOrDash(payload.activity.mau)} recently active.
</p>
<MiniLineChart
series={[
{ name: 'New', color: colors[0], points: mix.map((m) => ({ date: m.date, value: m.new })) },
{ name: 'Core', color: colors[1], points: mix.map((m) => ({ date: m.date, value: m.core })) },
{ name: 'Returning', color: colors[2], points: mix.map((m) => ({ date: m.date, value: m.returning })) },
{ name: 'At risk', color: colors[3], points: mix.map((m) => ({ date: m.date, value: m.atRisk })) },
{ name: 'Churned', color: colors[4], points: mix.map((m) => ({ date: m.date, value: m.churned })) }
]}
/>
</Container>
</section>
@@ -0,0 +1,70 @@
<script lang="ts">
import Container from '$lib/components/Container.svelte';
import { SETTINGS_DEFAULTS, type SettingsKey, type StatsSettings } from '$lib/types/stats';
interface Props {
settings: StatsSettings;
stale?: boolean;
}
let { settings, stale = false }: Props = $props();
const FIELDS: { key: SettingsKey; label: string; hint: string; suffix?: string }[] = [
{ key: 'core_plays_per_week', label: 'Core player threshold', hint: 'Finishes in 7 days to count as core.' },
{ key: 'at_risk_days', label: 'At-risk after (days)', hint: 'Days inactive before a player is at risk.' },
{ key: 'churn_days', label: 'Churned after (days)', hint: 'Days inactive before a player is churned.' },
{ key: 'resurrect_gap_days', label: 'Resurrection gap (days)', hint: 'Gap that makes a return "resurrected".' },
{ key: 'active_window_days', label: 'Player-state window (days)', hint: 'How much player history is stored.' },
{ key: 'd1_target', label: 'D1 return target', hint: 'Target for next-day return.', suffix: '%' },
{ key: 'return7_target', label: '7-day return target', hint: 'Target for any return within 7 days.', suffix: '%' },
{ key: 'completion_target', label: 'Completion target', hint: 'Started → finished target.', suffix: '%' },
{ key: 'first_try_min', label: 'First-try band (min)', hint: 'Below this is too hard.', suffix: '%' },
{ key: 'first_try_max', label: 'First-try band (max)', hint: 'Above this is too easy.', suffix: '%' },
{ key: 'share_target', label: 'Share target', hint: 'Shares ÷ finishes target.', suffix: '%' },
{ key: 'anomaly_mad_threshold', label: 'Anomaly sensitivity', hint: 'Lower = more alerts.' }
];
</script>
<details class="group">
<summary
class="cursor-pointer list-none rounded-xl border border-white/10 bg-white/5 px-4 py-2 text-sm font-semibold text-gray-200 hover:bg-white/10"
>
⚙️ Settings &amp; thresholds
{#if stale}
<span class="ml-2 text-xs font-normal text-amber-300"
>(snapshot definitions are outdated)</span
>
{/if}
</summary>
<Container class="mt-3 p-4 w-full items-stretch text-left gap-3">
<p class="text-xs text-gray-400">
Changing these re-reads history; snapshots themselves are unchanged.
</p>
<form method="POST" action="?/updateSettings" class="grid gap-3 sm:grid-cols-2">
{#each FIELDS as field (field.key)}
<label class="flex flex-col gap-1 text-xs text-gray-300">
<span class="font-semibold">{field.label}{field.suffix ? ` (${field.suffix})` : ''}</span>
<input
type="number"
name={field.key}
value={settings[field.key]}
step="any"
min={field.key === 'anomaly_mad_threshold' ? 0.5 : 0}
class="rounded-lg border border-white/10 bg-black/30 px-2 py-1.5 text-sm text-gray-100 focus:border-blue-400 focus:outline-none"
/>
<span class="text-[11px] text-gray-500">{field.hint}</span>
</label>
{/each}
<div class="flex items-center gap-2 sm:col-span-2">
<button
type="submit"
class="rounded-lg bg-blue-600 px-4 py-2 text-sm font-semibold text-white hover:bg-blue-500"
>
Save settings
</button>
<span class="text-[11px] text-gray-500">
Defaults come from <code>SETTINGS_DEFAULTS</code> / <code>STATS_*</code> env vars.
</span>
</div>
</form>
</Container>
</details>
@@ -0,0 +1,41 @@
<script lang="ts">
import Container from '$lib/components/Container.svelte';
import StatusPill from '$lib/components/charts/StatusPill.svelte';
import type { Signal } from '$lib/types/stats';
interface Props {
signals: Signal[];
}
let { signals }: Props = $props();
const labels: Record<Signal['severity'], string> = {
good: 'On target',
info: 'Needs data',
warn: 'Watch',
bad: 'Act now'
};
</script>
<section class="flex flex-col gap-3">
<h2 class="text-lg font-bold text-gray-100">6 · Signals &amp; Actions</h2>
{#if signals.length === 0}
<p class="text-sm text-gray-400">No signals for this date.</p>
{:else}
<div class="grid gap-3 md:grid-cols-2">
{#each signals as signal (signal.id)}
<Container class="p-4 w-full items-start text-left gap-2">
<div class="flex items-center justify-between gap-2 w-full">
<p class="font-semibold text-gray-100">{signal.title}</p>
<StatusPill severity={signal.severity} label={labels[signal.severity]} />
</div>
<p class="text-sm text-gray-300">{signal.detail}</p>
{#if signal.action}
<p class="text-xs text-amber-200/90">
<span class="font-semibold">What to do:</span> {signal.action}
</p>
{/if}
</Container>
{/each}
</div>
{/if}
</section>
+172
View File
@@ -0,0 +1,172 @@
<script lang="ts">
import Container from '$lib/components/Container.svelte';
import MiniLineChart from '$lib/components/charts/MiniLineChart.svelte';
import BarList from '$lib/components/charts/BarList.svelte';
import BookCoverage from '$lib/components/stats/BookCoverage.svelte';
import type { SnapshotPayload } from '$lib/types/stats';
import { bibleBooks } from '$lib/types/bible';
interface Props {
payload: SnapshotPayload;
}
let { payload }: Props = $props();
const nameOf = (id: string) => bibleBooks.find((b) => b.id === id)?.name ?? id;
const coverage = $derived(payload.verseMix.coverage);
const retained = $derived(payload.verseMix.retentionByBook);
const avgD1 = $derived(
retained.length ? retained.reduce((a, b) => a + (b.d1Return ?? 0), 0) / retained.length : 0
);
const giveaways = $derived(
payload.verseMix.firstTryByBook
.filter((b) => b.firstTryPct >= 50 && b.plays >= 3)
.sort((a, b) => b.firstTryPct - a.firstTryPct)
.slice(0, 8)
);
const alarms = $derived(
retained
.filter((b) => b.plays >= 5 && (b.d1Return ?? 100) < avgD1 - 5)
.sort((a, b) => (a.d1Return ?? 0) - (b.d1Return ?? 0))
.slice(0, 8)
);
function bar(pct: number | null, color = 'rgba(52,211,153,0.6)'): string {
const w = pct === null ? 0 : Math.min(100, pct);
return `width:${w}%;background:${color}`;
}
</script>
<section class="flex flex-col gap-3">
<h2 class="text-lg font-bold text-gray-100">4 · Verse Mix Lab</h2>
<Container class="p-4 w-full items-stretch text-left gap-2">
<p class="font-semibold text-gray-100">66-book coverage (180 days)</p>
<p class="text-xs text-gray-400">
How often each book was the answer, grouped by canonical section. Red = rarely featured,
green = a staple. Aim for breadth, not repetition.
</p>
<BookCoverage {coverage} />
</Container>
<div class="grid gap-3 md:grid-cols-2">
<Container class="p-4 w-full items-stretch text-left gap-2">
<p class="font-semibold text-gray-100">Testament balance &amp; variety</p>
<p class="text-xs text-gray-400">
Weekly Old vs New Testament count, plus book-distribution entropy (higher = more variety).
</p>
<MiniLineChart
series={[
{ name: 'Old', color: '#f59e0b', points: payload.verseMix.testamentMix.map((t) => ({ date: t.date, value: t.old })) },
{ name: 'New', color: '#60a5fa', points: payload.verseMix.testamentMix.map((t) => ({ date: t.date, value: t.new })) }
]}
/>
<MiniLineChart
series={[{ name: 'Entropy (bits)', color: '#a78bfa', points: payload.verseMix.entropy }]}
showLegend={false}
height={120}
/>
</Container>
<Container class="p-4 w-full items-stretch text-left gap-2">
<p class="font-semibold text-gray-100">Freshness</p>
<p class="text-xs text-gray-400">
How long between repeats of the same book. More short gaps = repetitive mix.
</p>
<BarList
items={payload.verseMix.repeatIntervals.map((b) => ({ label: b.label, value: b.value, color: 'rgba(244,114,182,0.5)' }))}
/>
<p class="pt-2 text-xs text-gray-400">Achievability (last 30 days)</p>
<BarList
items={payload.verseMix.achievability.map((b) => ({ label: `${b.label} guess${b.label === '1' ? '' : 'es'}`, value: b.value, color: 'rgba(96,165,250,0.5)' }))}
/>
</Container>
</div>
<div class="grid gap-3 md:grid-cols-2">
<Container class="p-4 w-full items-stretch text-left gap-2">
<p class="font-semibold text-gray-100">Retention by difficulty</p>
<p class="text-xs text-gray-400">
Next-day return after solving in each guess bucket. Do hard days make people leave?
</p>
<table class="w-full text-left text-xs text-gray-300">
<thead class="text-gray-500">
<tr><th class="py-1">Guesses</th><th>Plays</th><th>D1 return</th></tr>
</thead>
<tbody>
{#each payload.verseMix.retentionByGuessBucket as row (row.bucket)}
<tr>
<td class="py-1">{row.bucket}</td>
<td>{row.plays}</td>
<td>
<div class="flex items-center gap-2">
<div class="h-2 w-24 overflow-hidden rounded bg-white/5">
<div class="h-full rounded" style={bar(row.d1)}></div>
</div>
<span>{row.d1 === null ? '—' : `${row.d1}%`}</span>
</div>
</td>
</tr>
{/each}
</tbody>
</table>
</Container>
<Container class="p-4 w-full items-stretch text-left gap-2">
<p class="font-semibold text-gray-100">Retention by book</p>
<p class="text-xs text-gray-400">
Books whose day had below-average next-day return (min 5 plays). Candidate retirements.
</p>
{#if alarms.length === 0}
<p class="text-sm text-gray-400">No clear churn outliers.</p>
{:else}
<table class="w-full text-left text-xs text-gray-300">
<thead class="text-gray-500">
<tr><th class="py-1">Book</th><th>Plays</th><th>D1</th><th>First-try</th></tr>
</thead>
<tbody>
{#each alarms as b (b.bookId)}
<tr>
<td class="py-1">{nameOf(b.bookId)}</td>
<td>{b.plays}</td>
<td>{b.d1Return === null ? '—' : `${b.d1Return}%`}</td>
<td>{b.firstTryPct}%</td>
</tr>
{/each}
</tbody>
</table>
{/if}
</Container>
</div>
<Container class="p-4 w-full items-stretch text-left gap-2">
<p class="font-semibold text-gray-100">Giveaway detector</p>
<p class="text-xs text-gray-400">
Books solved first try more than half the time (min 3 plays). Likely self-revealing text —
down-weight in the curated mix.
</p>
{#if giveaways.length === 0}
<p class="text-sm text-gray-400">No giveaway outliers.</p>
{:else}
<table class="w-full text-left text-xs text-gray-300">
<thead class="text-gray-500">
<tr><th class="py-1">Book</th><th>Plays</th><th>First-try</th><th>Avg guesses</th></tr>
</thead>
<tbody>
{#each giveaways as b (b.bookId)}
<tr>
<td class="py-1">{nameOf(b.bookId)}</td>
<td>{b.plays}</td>
<td>{b.firstTryPct}%</td>
<td>{b.avgGuesses}</td>
</tr>
{/each}
</tbody>
</table>
{/if}
</Container>
<p class="text-xs text-gray-500">
Before/after the curated mix system will appear here once enough pre/post data exists.
</p>
</section>
+16
View File
@@ -0,0 +1,16 @@
// Single source of truth for the admin account that may view submitter
// attribution on /scheduled-verses. The public game never surfaces submitter
// identity; this email is the sole exception (see spec "Admin /scheduled-verses").
export const ADMIN_EMAIL = 'geohpowell@gmail.com';
// Local-only escape hatch: set `DEV_ADMIN_ALL=true` in `.env` to treat every
// visitor as an admin so the private console can be tested on a dev machine.
// Explicitly disabled when NODE_ENV=production, so it can never apply to a
// deployed build even if the variable leaks.
export const DEV_ADMIN_ALL =
Bun.env.DEV_ADMIN_ALL === 'true' && Bun.env.NODE_ENV !== 'production';
export function isAdmin(email: string | null | undefined): boolean {
if (DEV_ADMIN_ALL) return true;
return !!email && email.toLowerCase() === ADMIN_EMAIL;
}
+8 -6
View File
@@ -1,4 +1,4 @@
import type { RequestEvent } from '@sveltejs/kit'; import type { Cookies } from '@sveltejs/kit';
import { eq } from 'drizzle-orm'; import { eq } from 'drizzle-orm';
import { testDb as db } from '$lib/server/db/test'; import { testDb as db } from '$lib/server/db/test';
import * as table from '$lib/server/db/schema'; import * as table from '$lib/server/db/schema';
@@ -64,15 +64,15 @@ export async function invalidateSession(sessionId: string) {
await db.delete(table.session).where(eq(table.session.id, sessionId)); await db.delete(table.session).where(eq(table.session.id, sessionId));
} }
export function setSessionTokenCookie(event: RequestEvent, token: string, expiresAt: Date) { export function setSessionTokenCookie({ cookies }: { cookies: Cookies }, token: string, expiresAt: Date) {
event.cookies.set(sessionCookieName, token, { cookies.set(sessionCookieName, token, {
expires: expiresAt, expires: expiresAt,
path: '/' path: '/'
}); });
} }
export function deleteSessionTokenCookie(event: RequestEvent) { export function deleteSessionTokenCookie({ cookies }: { cookies: Cookies }) {
event.cookies.delete(sessionCookieName, { cookies.delete(sessionCookieName, {
path: '/' path: '/'
}); });
} }
@@ -99,9 +99,11 @@ export async function createUser(anonymousId: string, email: string, passwordHas
email, email,
passwordHash, passwordHash,
appleId: null, appleId: null,
googleId: null,
firstName: firstName || null, firstName: firstName || null,
lastName: lastName || null, lastName: lastName || null,
isPrivate: false isPrivate: false,
createdAt: new Date()
}; };
await db.insert(table.user).values(user); await db.insert(table.user).values(user);
return user; return user;
+14 -7
View File
@@ -1,4 +1,4 @@
import type { RequestEvent } from '@sveltejs/kit'; import type { Cookies, RequestEvent } from '@sveltejs/kit';
import { eq } from 'drizzle-orm'; import { eq } from 'drizzle-orm';
import { db } from '$lib/server/db'; import { db } from '$lib/server/db';
import * as table from '$lib/server/db/schema'; import * as table from '$lib/server/db/schema';
@@ -28,7 +28,7 @@ export async function validateSessionToken(token: string) {
const [result] = await db const [result] = await db
.select({ .select({
// Adjust user table here to tweak returned data // Adjust user table here to tweak returned data
user: { id: table.user.id, email: table.user.email, firstName: table.user.firstName, lastName: table.user.lastName, appleId: table.user.appleId }, user: { id: table.user.id, email: table.user.email, firstName: table.user.firstName, lastName: table.user.lastName, appleId: table.user.appleId, googleId: table.user.googleId },
session: table.session session: table.session
}) })
.from(table.session) .from(table.session)
@@ -64,15 +64,15 @@ export async function invalidateSession(sessionId: string) {
await db.delete(table.session).where(eq(table.session.id, sessionId)); await db.delete(table.session).where(eq(table.session.id, sessionId));
} }
export function setSessionTokenCookie(event: RequestEvent, token: string, expiresAt: Date) { export function setSessionTokenCookie({ cookies }: { cookies: Cookies }, token: string, expiresAt: Date) {
event.cookies.set(sessionCookieName, token, { cookies.set(sessionCookieName, token, {
expires: expiresAt, expires: expiresAt,
path: '/' path: '/'
}); });
} }
export function deleteSessionTokenCookie(event: RequestEvent) { export function deleteSessionTokenCookie({ cookies }: { cookies: Cookies }) {
event.cookies.delete(sessionCookieName, { cookies.delete(sessionCookieName, {
path: '/' path: '/'
}); });
} }
@@ -99,9 +99,11 @@ export async function createUser(anonymousId: string, email: string, passwordHas
email, email,
passwordHash, passwordHash,
appleId: null, appleId: null,
googleId: null,
firstName: firstName || null, firstName: firstName || null,
lastName: lastName || null, lastName: lastName || null,
isPrivate: false isPrivate: false,
createdAt: new Date()
}; };
await db.insert(table.user).values(user); await db.insert(table.user).values(user);
return user; return user;
@@ -117,6 +119,11 @@ export async function getUserByAppleId(appleId: string) {
return user || null; return user || null;
} }
export async function getUserByGoogleId(googleId: string) {
const [user] = await db.select().from(table.user).where(eq(table.user.googleId, googleId));
return user || null;
}
export async function migrateAnonymousStats(anonymousId: string | undefined, userId: string) { export async function migrateAnonymousStats(anonymousId: string | undefined, userId: string) {
if (!anonymousId || anonymousId === userId) return; if (!anonymousId || anonymousId === userId) return;
+19
View File
@@ -31,3 +31,22 @@ export async function fetchRandomVerse(): Promise<ApiVerse> {
verseText verseText
}; };
} }
/**
* Like fetchRandomVerse, but re-rolls until the picked book is not in
* `avoidBookIds` (the no-back-to-back neighbors for lazy gap-fill).
* 66 books with ≤2 excluded gives ~97% success per try; capped at 20 tries
* before accepting whatever was last drawn (spec: "Lazy Gap-Fill").
*/
export async function fetchRandomVerseAvoiding(
avoidBookIds: string[] = []
): Promise<ApiVerse> {
const avoid = new Set(avoidBookIds.filter(Boolean));
let last: ApiVerse | null = null;
for (let i = 0; i < 20; i++) {
const v = await fetchRandomVerse();
last = v;
if (!avoid.has(v.bookId)) return v;
}
return last as ApiVerse;
}
+30 -3
View File
@@ -1,9 +1,16 @@
import { db } from '$lib/server/db'; import { db } from '$lib/server/db';
import { dailyVerses } from '$lib/server/db/schema'; import { dailyVerses } from '$lib/server/db/schema';
import { eq, sql } from 'drizzle-orm'; import { eq, sql } from 'drizzle-orm';
import { fetchRandomVerse } from '$lib/server/bible-api'; import { fetchRandomVerse, fetchRandomVerseAvoiding } from '$lib/server/bible-api';
import type { DailyVerse } from '$lib/server/db/schema'; import type { DailyVerse } from '$lib/server/db/schema';
/** Add `n` days to a YYYY-MM-DD string using pure UTC arithmetic. */
function addDays(dateStr: string, n: number): string {
const d = new Date(dateStr + 'T00:00:00Z');
d.setUTCDate(d.getUTCDate() + n);
return d.toISOString().slice(0, 10);
}
export async function getVerseForDate(dateStr: string): Promise<DailyVerse> { export async function getVerseForDate(dateStr: string): Promise<DailyVerse> {
// Validate date format (YYYY-MM-DD) // Validate date format (YYYY-MM-DD)
if (!/^\d{4}-\d{2}-\d{2}$/.test(dateStr)) { if (!/^\d{4}-\d{2}-\d{2}$/.test(dateStr)) {
@@ -16,8 +23,28 @@ export async function getVerseForDate(dateStr: string): Promise<DailyVerse> {
return existing[0]; return existing[0];
} }
// Otherwise get a new random verse for this date // Otherwise get a new random verse for this date. Gap-fill is extended to
const apiVerse = await fetchRandomVerse(); // respect the no-back-to-back rule: the random verse's book must differ from
// any committed neighbor (D-1 / D+1). This preserves the global invariant
// that no two consecutive calendar days ever feature the same book
// (spec: "Lazy Gap-Fill").
const [prev] = await db
.select({ bookId: dailyVerses.bookId })
.from(dailyVerses)
.where(eq(dailyVerses.date, addDays(dateStr, -1)))
.limit(1);
const [next] = await db
.select({ bookId: dailyVerses.bookId })
.from(dailyVerses)
.where(eq(dailyVerses.date, addDays(dateStr, 1)))
.limit(1);
const avoid = [prev?.bookId, next?.bookId].filter((b): b is string => !!b);
const apiVerse =
avoid.length > 0
? await fetchRandomVerseAvoiding(avoid)
: await fetchRandomVerse();
const createdAt = sql`${Math.floor(Date.now() / 1000)}`; const createdAt = sql`${Math.floor(Date.now() / 1000)}`;
const newVerse: Omit<DailyVerse, 'createdAt'> = { const newVerse: Omit<DailyVerse, 'createdAt'> = {
+76 -2
View File
@@ -1,4 +1,5 @@
import { integer, sqliteTable, text, index, unique } from 'drizzle-orm/sqlite-core'; import { integer, sqliteTable, text, index, unique, uniqueIndex } from 'drizzle-orm/sqlite-core';
import { sql } from 'drizzle-orm';
export const user = sqliteTable('user', { export const user = sqliteTable('user', {
id: text('id').primaryKey(), id: text('id').primaryKey(),
@@ -7,7 +8,11 @@ export const user = sqliteTable('user', {
email: text('email').unique(), email: text('email').unique(),
passwordHash: text('password_hash'), passwordHash: text('password_hash'),
appleId: text('apple_id').unique(), appleId: text('apple_id').unique(),
isPrivate: integer('is_private', { mode: 'boolean' }).default(false) googleId: text('google_id').unique(),
isPrivate: integer('is_private', { mode: 'boolean' }).default(false),
// Additive: existing rows stay NULL ("unknown signup date"). New rows get a
// timestamp automatically via the client-side default function.
createdAt: integer('created_at', { mode: 'timestamp' }).$defaultFn(() => new Date())
}); });
export const session = sqliteTable('session', { export const session = sqliteTable('session', {
@@ -47,3 +52,72 @@ export const dailyCompletions = sqliteTable('daily_completions', {
]); ]);
export type DailyCompletion = typeof dailyCompletions.$inferSelect; export type DailyCompletion = typeof dailyCompletions.$inferSelect;
export const verseSubmissions = sqliteTable('verse_submissions', {
id: text('id').primaryKey(),
// Nullable so ON DELETE SET NULL can clear attribution when a user is deleted;
// the scheduled verse still plays out (canonical text lives on daily_verses).
userId: text('user_id').references(() => user.id, { onDelete: 'set null' }),
scheduledDate: text('scheduled_date').notNull().unique(),
selectedBookId: text('selected_book_id').notNull(),
selectedChapter: integer('selected_chapter').notNull(),
selectedVerse: integer('selected_verse').notNull(),
// Raw integer of server UTC milliseconds — drives the 7-day rolling cooldown.
submittedAt: integer('submitted_at').notNull(),
}, (table) => [
index('verse_submissions_user_id_idx').on(table.userId),
]);
export type VerseSubmission = typeof verseSubmissions.$inferSelect;
// ── Statistics dashboard (see statistics-plan.md) ────────────────────────────
// One immutable row per "as of" day. Payload/config/playerState are JSON text.
export const statsSnapshot = sqliteTable('stats_snapshot', {
// as-of date, YYYY-MM-DD
date: text('date').primaryKey(),
// build time (server timestamp)
generatedAt: integer('generated_at', { mode: 'timestamp' }).notNull(),
// scheduled | lazy | reconstructed
buildKind: text('build_kind').notNull(),
// stable hash of the settings used at build time
configVersion: text('config_version').notNull(),
// all aggregate series / lab data
payload: text('payload').notNull(),
// compact per-player state for render-time segmentation (JSON)
playerState: text('player_state'),
// copy of the resolved settings used at build time (JSON)
config: text('config').notNull()
});
export type StatsSnapshot = typeof statsSnapshot.$inferSelect;
// Generic, extensible event log. Unlocks instrumentation B/D/E/F now; C later.
export const analyticsEvents = sqliteTable('analytics_events', {
id: text('id').primaryKey(),
name: text('name').notNull(),
anonymousId: text('anonymous_id'),
// Nullable so ON DELETE SET NULL keeps historical events when a user is deleted.
userId: text('user_id').references(() => user.id, { onDelete: 'set null' }),
date: text('date'),
createdAt: integer('created_at', { mode: 'timestamp' }).notNull(),
metadata: text('metadata')
}, (table) => [
index('analytics_events_name_date_idx').on(table.name, table.date),
index('analytics_events_anonymous_id_date_idx').on(table.anonymousId, table.date),
// Dedupe verse_served per player per day (reloads), without collapsing
// legitimate repeat events like multiple shares in a day.
uniqueIndex('analytics_events_serve_unique')
.on(table.name, table.anonymousId, table.date)
.where(sql`${table.name} = 'verse_served'`)
]);
export type AnalyticsEvent = typeof analyticsEvents.$inferSelect;
// Simple key/value store for dashboard thresholds (env vars provide defaults).
export const dashboardSettings = sqliteTable('dashboard_settings', {
key: text('key').primaryKey(),
value: text('value').notNull(),
updatedAt: integer('updated_at', { mode: 'timestamp' }).notNull()
});
export type DashboardSetting = typeof dashboardSettings.$inferSelect;
+65
View File
@@ -0,0 +1,65 @@
const GOOGLE_AUTH_URL = 'https://accounts.google.com/o/oauth2/v2/auth';
const GOOGLE_TOKEN_URL = 'https://oauth2.googleapis.com/token';
export function getGoogleAuthUrl(state: string): string {
const params = new URLSearchParams({
client_id: Bun.env.GOOGLE_CLIENT_ID!,
redirect_uri: `${Bun.env.PUBLIC_SITE_URL}/auth/google/callback`,
response_type: 'code',
scope: 'openid email profile',
state,
access_type: 'online',
prompt: 'select_account'
});
return `${GOOGLE_AUTH_URL}?${params.toString()}`;
}
export async function exchangeGoogleCode(
code: string,
redirectUri: string
): Promise<{
access_token: string;
token_type: string;
expires_in: number;
id_token: string;
scope: string;
}> {
const params = new URLSearchParams({
client_id: Bun.env.GOOGLE_CLIENT_ID!,
client_secret: Bun.env.GOOGLE_CLIENT_SECRET!,
code,
grant_type: 'authorization_code',
redirect_uri: redirectUri
});
const response = await fetch(GOOGLE_TOKEN_URL, {
method: 'POST',
headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
body: params.toString()
});
if (!response.ok) {
const errText = await response.text();
throw new Error(`Google token exchange failed: ${errText}`);
}
return await response.json();
}
/**
* Decode Google's id_token JWT payload without signature verification.
* Safe because the token is received directly from Google's token endpoint over TLS.
*/
export function decodeGoogleIdToken(idToken: string): {
sub: string;
email?: string;
email_verified?: boolean;
name?: string;
given_name?: string;
family_name?: string;
} {
const [, payloadB64] = idToken.split('.');
const padded = payloadB64 + '='.repeat((4 - (payloadB64.length % 4)) % 4);
const payload = JSON.parse(atob(padded.replace(/-/g, '+').replace(/_/g, '/')));
return payload;
}
+282
View File
@@ -0,0 +1,282 @@
import { db } from '$lib/server/db';
import { dailyCompletions } from '$lib/server/db/schema';
import { bibleBooks } from '$lib/types/bible';
import { inArray } from 'drizzle-orm';
import type { DailyCompletion } from '$lib/server/db/schema';
export type Milestone = {
id: string;
name: string;
emoji: string;
description: string;
achieved: boolean;
achievedDate: string | null; // YYYY-MM-DD of first achievement, or null
};
export type ClassicMilestoneInputs = {
bestSingleGame: { date: string; bookName: string } | null;
streakMilestones: { days7: string | null; days14: string | null; days30: string | null };
};
export async function calculateMilestones(
completions: DailyCompletion[],
dateToBookId: Map<string, string>,
classic: ClassicMilestoneInputs,
): Promise<Milestone[]> {
const sorted = [...completions].sort((a, b) => a.date.localeCompare(b.date));
// Helper: returns the date when all books in targetIds were first solved
function findSetDate(targetIds: Set<string>): string | null {
const solved = new Set<string>();
for (const c of sorted) {
const bookId = dateToBookId.get(c.date);
if (bookId && targetIds.has(bookId)) {
solved.add(bookId);
if (solved.size === targetIds.size) return c.date;
}
}
return null;
}
// Book sets
const ntIds = new Set(bibleBooks.filter(b => b.testament === 'new').map(b => b.id));
const otIds = new Set(bibleBooks.filter(b => b.testament === 'old').map(b => b.id));
const allIds = new Set(bibleBooks.map(b => b.id));
const gospelIds = new Set(['MAT', 'MRK', 'LUK', 'JHN']);
const pentateuchIds = new Set(['GEN', 'EXO', 'LEV', 'NUM', 'DEU']);
// Set-completion milestones
const ntScholarDate = findSetDate(ntIds);
const otScholarDate = findSetDate(otIds);
const theologianDate = findSetDate(allIds);
const fantasticFourDate = findSetDate(gospelIds);
const pentatonixDate = findSetDate(pentateuchIds);
// With God, All Things Are Possible — solved in 1 guess for at least one puzzle from each of the 66 books
const booksInOne = new Set<string>();
let withGodDate: string | null = null;
for (const c of sorted) {
if (c.guessCount === 1) {
const bookId = dateToBookId.get(c.date);
if (bookId) {
booksInOne.add(bookId);
if (withGodDate === null && booksInOne.size === allIds.size) {
withGodDate = c.date;
}
}
}
}
const allInOne = booksInOne.size === allIds.size;
// Is This A Joke To You? — guessed all 65 other books first (66 guesses total)
const jokeCompletion = sorted.find(c => c.guessCount >= 66);
// Prodigal Son — returned after a 30+ day gap
let prodigalDate: string | null = null;
for (let i = 1; i < sorted.length; i++) {
const prev = new Date(sorted[i - 1].date + 'T00:00:00Z');
const curr = new Date(sorted[i].date + 'T00:00:00Z');
const diff = Math.round((curr.getTime() - prev.getTime()) / 86400000);
if (diff >= 30) {
prodigalDate = sorted[i].date;
break;
}
}
// Extra Credit — solved on a Sunday
const sundayCompletion = sorted.find(c => {
const d = new Date(c.date + 'T00:00:00Z');
return d.getUTCDay() === 0;
});
// Cross-user milestones: Overachiever, Procrastinator, Outlier
let overachieverDate: string | null = null;
let procrastinatorDate: string | null = null;
let outlierDate: string | null = null;
if (sorted.length > 0) {
const userDates = sorted.map(c => c.date);
const allOnDates = await db
.select({
date: dailyCompletions.date,
completedAt: dailyCompletions.completedAt,
guessCount: dailyCompletions.guessCount,
anonymousId: dailyCompletions.anonymousId,
})
.from(dailyCompletions)
.where(inArray(dailyCompletions.date, userDates));
// Group all completions by date
const byDate = new Map<string, typeof allOnDates>();
for (const c of allOnDates) {
const arr = byDate.get(c.date) ?? [];
arr.push(c);
byDate.set(c.date, arr);
}
const userByDate = new Map(sorted.map(c => [c.date, c]));
for (const userComp of sorted) {
const allForDate = byDate.get(userComp.date) ?? [];
if (allForDate.length < 2) continue; // need multiple players
const validTimes = allForDate
.filter(c => c.completedAt != null)
.map(c => c.completedAt!.getTime());
if (!overachieverDate && userComp.completedAt && validTimes.length > 0) {
const earliest = Math.min(...validTimes);
if (userComp.completedAt.getTime() === earliest) {
overachieverDate = userComp.date;
}
}
if (!procrastinatorDate && userComp.completedAt && validTimes.length > 0) {
const latest = Math.max(...validTimes);
if (userComp.completedAt.getTime() === latest) {
procrastinatorDate = userComp.date;
}
}
if (!outlierDate && allForDate.length >= 10) {
const sortedGuesses = allForDate.map(c => c.guessCount).sort((a, b) => a - b);
const cutoffIndex = Math.ceil(sortedGuesses.length * 0.1) - 1;
const cutoff = sortedGuesses[cutoffIndex];
if (userComp.guessCount <= cutoff) {
outlierDate = userComp.date;
}
}
}
}
return [
{
id: 'first-1-guess',
name: 'Lightning Strike',
emoji: '⚡',
description: `First 1-guess solve${classic.bestSingleGame ? ` — ${classic.bestSingleGame.bookName}` : ''}`,
achieved: classic.bestSingleGame !== null,
achievedDate: classic.bestSingleGame?.date ?? null,
},
{
id: 'streak-7',
name: '7-Day Streak',
emoji: '🔥',
description: 'Solve Bibdle 7 days in a row',
achieved: classic.streakMilestones.days7 !== null,
achievedDate: classic.streakMilestones.days7,
},
{
id: 'streak-14',
name: '14-Day Streak',
emoji: '💥',
description: 'Solve Bibdle 14 days in a row',
achieved: classic.streakMilestones.days14 !== null,
achievedDate: classic.streakMilestones.days14,
},
{
id: 'streak-30',
name: '30-Day Streak',
emoji: '🏅',
description: 'Solve Bibdle 30 days in a row',
achieved: classic.streakMilestones.days30 !== null,
achievedDate: classic.streakMilestones.days30,
},
{
id: 'nt-scholar',
name: 'NT Scholar',
emoji: '✝️',
description: 'Solve for every New Testament book',
achieved: ntScholarDate !== null,
achievedDate: ntScholarDate,
},
{
id: 'ot-scholar',
name: 'OT Scholar',
emoji: '📜',
description: 'Solve for every Old Testament book',
achieved: otScholarDate !== null,
achievedDate: otScholarDate,
},
{
id: 'theologian',
name: 'Theologian',
emoji: '🎓',
description: 'Solve for all 66 books of the Bible',
achieved: theologianDate !== null,
achievedDate: theologianDate,
},
{
id: 'fantastic-four',
name: 'The Fantastic Four',
emoji: '4️⃣',
description: 'Solve a puzzle for all four Gospels',
achieved: fantasticFourDate !== null,
achievedDate: fantasticFourDate,
},
{
id: 'pentatonix',
name: 'Pentatonix',
emoji: '📃',
description: 'Solve a puzzle for all five books of the Pentateuch',
achieved: pentatonixDate !== null,
achievedDate: pentatonixDate,
},
{
id: 'with-god',
name: 'With God, All Things Are Possible',
emoji: '🙏',
description: 'Solve in 1 guess for each of the 66 books at least once',
achieved: allInOne,
achievedDate: withGodDate,
},
{
id: 'is-this-a-joke',
name: 'Is This A Joke To You?',
emoji: '😤',
description: 'Guess all 65 other books before getting the right one',
achieved: jokeCompletion !== undefined,
achievedDate: jokeCompletion?.date ?? null,
},
{
id: 'overachiever',
name: 'Overachiever',
emoji: '⚡',
description: 'Be the first person to solve Bibdle on a day',
achieved: overachieverDate !== null,
achievedDate: overachieverDate,
},
{
id: 'procrastinator',
name: 'Procrastinator',
emoji: '🐢',
description: 'Be the last person to solve Bibdle on a day',
achieved: procrastinatorDate !== null,
achievedDate: procrastinatorDate,
},
{
id: 'prodigal-son',
name: 'Prodigal Son',
emoji: '🏠',
description: 'Return to Bibdle after at least 30 days away',
achieved: prodigalDate !== null,
achievedDate: prodigalDate,
},
{
id: 'extra-credit',
name: 'Extra Credit',
emoji: '📅',
description: 'Solve Bibdle on a Sunday',
achieved: sundayCompletion !== undefined,
achievedDate: sundayCompletion?.date ?? null,
},
{
id: 'outlier',
name: 'Outlier',
emoji: '📊',
description: 'Finish in the top 10% of solves on a day (fewest guesses)',
achieved: outlierDate !== null,
achievedDate: outlierDate,
},
];
}
+165
View File
@@ -0,0 +1,165 @@
import type { DailyVerse } from '$lib/server/db/schema';
/**
* The feed presents calendar days, so every timestamp is anchored to midnight
* in this reference timezone. Using a fixed zone (rather than the server's
* local timezone) keeps output stable across UTC dev machines and NY hosts.
*/
export const FEED_TIMEZONE = 'America/New_York';
/** Number of most-recent verses exposed in the feed. */
export const FEED_ITEM_LIMIT = 30;
/** Escape the five XML predefined entities. */
export function escapeXml(text: string): string {
return text
.replace(/&/g, '&amp;')
.replace(/</g, '&lt;')
.replace(/>/g, '&gt;')
.replace(/"/g, '&quot;')
.replace(/'/g, '&apos;');
}
/**
* The current calendar date (`YYYY-MM-DD`) in the feed's reference timezone.
* Used to cap the feed so future/scheduled verses are never published early.
*/
export function todayInTimeZone(timeZone: string = FEED_TIMEZONE, now: Date = new Date()): string {
const parts = new Intl.DateTimeFormat('en-US', {
timeZone,
year: 'numeric',
month: '2-digit',
day: '2-digit'
}).formatToParts(now);
const get = (type: string) => parts.find((part) => part.type === type)?.value ?? '';
return `${get('year')}-${get('month')}-${get('day')}`;
}
/**
* The UTC offset in effect on a given `YYYY-MM-DD` for a timezone, formatted
* as `±HH:MM` (e.g. `-04:00` during EDT, `-05:00` during EST).
*/
export function timeZoneOffset(dateStr: string, timeZone: string = FEED_TIMEZONE): string {
const [year, month, day] = dateStr.split('-').map(Number);
// Noon UTC is safely inside the calendar day in any US offset, so DST is
// resolved correctly regardless of the time of day.
const reference = new Date(Date.UTC(year, month - 1, day, 12));
const name = new Intl.DateTimeFormat('en-US', {
timeZone,
timeZoneName: 'longOffset'
})
.formatToParts(reference)
.find((part) => part.type === 'timeZoneName')?.value;
const offset = (name ?? 'GMT+00:00').replace('GMT', '');
return offset === '' ? '+00:00' : offset;
}
/**
* Format a `YYYY-MM-DD` day as an RFC 822 / RFC 2822 timestamp at midnight in
* the feed's reference timezone. Always emits a valid numeric/GMT timestamp
* (never a bare, ambiguous abbreviation like `EST`).
*/
export function formatRFC822(dateStr: string, timeZone: string = FEED_TIMEZONE): string {
const offset = timeZoneOffset(dateStr, timeZone);
return new Date(`${dateStr}T00:00:00${offset}`).toUTCString();
}
/** Human-readable date that does not shift with the server's local timezone. */
export function formatReadableDate(dateStr: string): string {
const [year, month, day] = dateStr.split('-').map(Number);
return new Date(Date.UTC(year, month - 1, day)).toLocaleDateString('en-US', {
month: 'long',
day: 'numeric',
year: 'numeric',
timeZone: 'UTC'
});
}
/** Wrap text in a CDATA section, splitting any embedded `]]>` safely. */
export function cdata(text: string): string {
return `<![CDATA[${text.replace(/]]>/g, ']]]]><![CDATA[>')}]]>`;
}
// Helper: Format verse text (VerseDisplay + Imposter unbalanced punctuation handling)
export function formatVerseText(text: string): string {
let formatted = text;
// Handle unbalanced opening/closing punctuation (from Imposter.svelte)
const pairs: [string, string][] = [
['(', ')'],
['[', ']'],
['{', '}'],
['"', '"'],
["'", "'"],
['\u201C', '\u201D'], // " "
['\u2018', '\u2019'] // ' '
];
// Check if text starts with opening punctuation without closing
for (const [open, close] of pairs) {
if (formatted.startsWith(open) && !formatted.includes(close)) {
formatted += '...' + close;
break;
}
}
// Check if text ends with closing punctuation without opening
for (const [open, close] of pairs) {
if (formatted.endsWith(close) && !formatted.includes(open)) {
formatted = open + '...' + formatted;
break;
}
}
// Check if text contains unbalanced opening quotes (not at start) without closing
for (const [open, close] of pairs) {
const openCount = (formatted.match(new RegExp(`\\${open}`, 'g')) || []).length;
const closeCount = (formatted.match(new RegExp(`\\${close}`, 'g')) || []).length;
if (openCount > closeCount) {
formatted += close;
break;
}
}
// Capitalize first letter if lowercase (from VerseDisplay.svelte)
formatted = formatted.replace(/^([a-z])/, (c) => c.toUpperCase());
// Replace trailing punctuation with ellipsis
// Preserve closing quotes/brackets that may have been added
formatted = formatted.replace(/[,:;-—]([)\]}\"\'\u201D\u2019]*)$/, '...$1');
return formatted;
}
/**
* Content fingerprint used as a strong ETag. Any change to the included rows
* (new day, edited verse text, changed reference) produces a new hash, so
* cached clients revalidate correctly.
*/
export function feedFingerprint(
verses: Pick<DailyVerse, 'date' | 'reference' | 'verseText'>[]
): string {
let hash = 5381;
for (const verse of verses) {
const row = `${verse.date}\u0000${verse.reference}\u0000${verse.verseText}`;
for (let i = 0; i < row.length; i++) {
hash = ((hash << 5) + hash + row.charCodeAt(i)) | 0;
}
}
return (hash >>> 0).toString(16);
}
/**
* The most recent `createdAt` across the given rows, used for `Last-Modified`.
* Falls back to `fallback` when no row carries a timestamp.
*/
export function latestModification(
verses: Pick<DailyVerse, 'createdAt'>[],
fallback: Date
): Date {
return verses.reduce<Date | null>((latest, verse) => {
if (!verse.createdAt) return latest;
return !latest || verse.createdAt > latest ? verse.createdAt : latest;
}, null) ?? fallback;
}
+37
View File
@@ -0,0 +1,37 @@
/** Pure UTC date arithmetic on `YYYY-MM-DD` strings. No DB, no Svelte. */
const DAY_MS = 1000 * 60 * 60 * 24;
export function addDays(dateStr: string, n: number): string {
const d = new Date(dateStr + 'T00:00:00Z');
d.setUTCDate(d.getUTCDate() + n);
return d.toISOString().slice(0, 10);
}
/** Whole-day difference `b - a`. */
export function dayDiff(a: string, b: string): number {
return Math.round(
(new Date(b + 'T00:00:00Z').getTime() - new Date(a + 'T00:00:00Z').getTime()) / DAY_MS
);
}
/** The Sunday on or before `dateStr` (week cohorts are Sunday-aligned). */
export function startOfWeek(dateStr: string): string {
const day = new Date(dateStr + 'T00:00:00Z').getUTCDay(); // 0 = Sunday
return addDays(dateStr, -day);
}
/** All dates from `start` to `end` inclusive. */
export function dateRange(start: string, end: string): string[] {
const out: string[] = [];
for (let d = start; d <= end; d = addDays(d, 1)) out.push(d);
return out;
}
export function todayUtc(): string {
return new Date().toISOString().slice(0, 10);
}
export function isValidDate(dateStr: string): boolean {
return /^\d{4}-\d{2}-\d{2}$/.test(dateStr) && !Number.isNaN(new Date(dateStr + 'T00:00:00Z').getTime());
}
+4
View File
@@ -0,0 +1,4 @@
import { db } from '$lib/server/db';
/** The Drizzle database type (production db or a test db). */
export type StatsDb = typeof db;
+44
View File
@@ -0,0 +1,44 @@
import type { SnapshotPayload } from '$lib/types/stats';
import { sortSignals } from './signals';
/** Compose the ~6-line plain-language daily digest. Pure / testable. */
export function composeDigest(payload: SnapshotPayload): string {
const { activity, kpis } = payload;
const top = sortSignals(payload.signals)[0];
const lines = [
`**Bibdle stats — ${payload.asOfDate}**`,
`Players: ${activity.dau} today · ${activity.wau} this week · ${activity.mau} this month`,
`New ${activity.newPlayers} · returning ${activity.returningShare ?? '—'}% · net ${activity.netGrowth >= 0 ? '+' : ''}${activity.netGrowth}`,
`D1 return ${kpis.d1Return ?? '—'}% · 7-day ${kpis.return7 ?? '—'}%`,
top ? `Top signal: ${top.title} — ${top.detail}` : 'No signals.',
`https://bibdle.com/admin/stats?date=${payload.asOfDate}`
];
return lines.join('\n');
}
/**
* POST the digest to the admin Discord webhook. No-op (with a log) when the
* webhook is unset; never throws so a digest failure can't fail the build.
*/
export async function sendDigest(
payload: SnapshotPayload,
webhookUrl: string | undefined = Bun.env.DISCORD_ADMIN_WEBHOOK
): Promise<boolean> {
const message = composeDigest(payload);
if (!webhookUrl) {
console.log('[stats] DISCORD_ADMIN_WEBHOOK not set; digest skipped:\n' + message);
return false;
}
try {
const res = await fetch(webhookUrl, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ content: message })
});
if (!res.ok) console.error('[stats] digest webhook responded', res.status);
return res.ok;
} catch (err) {
console.error('[stats] digest failed', err);
return false;
}
}
+70
View File
@@ -0,0 +1,70 @@
import { db as defaultDb } from '$lib/server/db';
import { analyticsEvents } from '$lib/server/db/schema';
import { EVENT_NAMES, MAX_METADATA_BYTES, type EventName } from '$lib/types/stats';
import type { StatsDb } from './db';
export interface RecordEventInput {
name: string;
anonymousId?: string | null;
userId?: string | null;
date?: string | null;
metadata?: Record<string, unknown> | null;
}
export function isEventName(name: string): name is EventName {
return (EVENT_NAMES as readonly string[]).includes(name);
}
/**
* Safely serialize metadata, capping it at `MAX_METADATA_BYTES`. Oversized
* payloads are replaced with a marker rather than truncated into invalid JSON.
*/
export function encodeMetadata(metadata: Record<string, unknown> | null | undefined): string | null {
if (metadata == null) return null;
let json: string | undefined;
try {
json = JSON.stringify(metadata);
} catch {
return null;
}
if (json === undefined) return null;
if (Buffer.byteLength(json) > MAX_METADATA_BYTES) {
return JSON.stringify({ truncated: true });
}
return json;
}
/**
* Insert one analytics event.
*
* Always uses `ON CONFLICT DO NOTHING`: the only unique constraint is the
* partial `verse_served` index, so this dedupes reloads for `verse_served`
* while other events insert freely.
*
* Never throws — analytics must not break gameplay. Returns true on insert.
*/
export async function recordEvent(
input: RecordEventInput,
database: StatsDb = defaultDb
): Promise<boolean> {
const { name, anonymousId, userId, date, metadata } = input;
try {
const inserted = await database
.insert(analyticsEvents)
.values({
id: crypto.randomUUID(),
name,
anonymousId: anonymousId ?? null,
userId: userId ?? null,
date: date ?? null,
createdAt: new Date(),
metadata: encodeMetadata(metadata)
})
.onConflictDoNothing()
.returning({ id: analyticsEvents.id });
return inserted.length > 0;
} catch (err) {
console.error('[stats] failed to record event', name, err);
return false;
}
}
+478
View File
@@ -0,0 +1,478 @@
import type {
BookStat,
CohortRow,
CompletionRow,
HistogramBin,
VerseRow
} from '$lib/types/stats';
import { bibleBooks } from '$lib/types/bible';
import { addDays, dateRange, dayDiff, startOfWeek } from './dates';
// ── internal helpers ─────────────────────────────────────────────────────────
/** Unique play dates per player, sorted ascending. */
export function groupDatesByPlayer(completions: CompletionRow[]): Map<string, string[]> {
const map = new Map<string, Set<string>>();
for (const c of completions) {
let set = map.get(c.anonymousId);
if (!set) {
set = new Set();
map.set(c.anonymousId, set);
}
set.add(c.date);
}
const out = new Map<string, string[]>();
for (const [id, set] of map) out.set(id, [...set].sort());
return out;
}
/** First-ever play date per player. */
export function firstPlayDates(completions: CompletionRow[]): Map<string, string> {
const out = new Map<string, string>();
for (const c of completions) {
const current = out.get(c.anonymousId);
if (current === undefined || c.date < current) out.set(c.anonymousId, c.date);
}
return out;
}
function round1(n: number): number {
return Math.round(n * 10) / 10;
}
function pct(part: number, whole: number): number | null {
if (whole <= 0) return null;
return round1((part / whole) * 100);
}
// ── activity ─────────────────────────────────────────────────────────────────
/** Distinct players with a completion in `[end - windowDays + 1, end]`. */
export function activePlayers(
completions: CompletionRow[],
end: string,
windowDays: number
): number {
const start = addDays(end, -(windowDays - 1));
const set = new Set<string>();
for (const c of completions) {
if (c.date >= start && c.date <= end) set.add(c.anonymousId);
}
return set.size;
}
export interface NewVsReturning {
newPlayers: number;
returning: number;
returningShare: number | null;
}
/** Split a single day's players into first-timers and returning players. */
export function newVsReturning(completions: CompletionRow[], date: string): NewVsReturning {
const firsts = firstPlayDates(completions);
const players = new Set<string>();
for (const c of completions) if (c.date === date) players.add(c.anonymousId);
let newPlayers = 0;
let returning = 0;
for (const id of players) {
if (firsts.get(id) === date) newPlayers++;
else returning++;
}
return { newPlayers, returning, returningShare: pct(returning, players.size) };
}
export interface NetGrowth {
newPlayers: number;
resurrected: number;
churned: number;
netGrowth: number;
}
/**
* Growth accounting over a trailing window:
* `new + resurrected - churned`.
*
* - new: first-ever play inside the window
* - resurrected: played in the window after a gap longer than `resurrectGapDays`
* - churned: played in the preceding equal window but not in this one
*/
export function netGrowth(
completions: CompletionRow[],
end: string,
windowDays: number,
resurrectGapDays: number
): NetGrowth {
const windowStart = addDays(end, -(windowDays - 1));
const prevStart = addDays(windowStart, -windowDays);
const prevEnd = addDays(windowStart, -1);
const datesByPlayer = groupDatesByPlayer(completions);
let newPlayers = 0;
let resurrected = 0;
let churned = 0;
for (const dates of datesByPlayer.values()) {
const inWindow = dates.filter((d) => d >= windowStart && d <= end);
const inPrev = dates.filter((d) => d >= prevStart && d <= prevEnd);
if (inWindow.length > 0) {
const firstInWindow = inWindow[0];
const earlier = dates.filter((d) => d < firstInWindow);
if (earlier.length === 0) {
if (firstInWindow >= windowStart) newPlayers++;
} else {
const gap = dayDiff(earlier[earlier.length - 1], firstInWindow);
if (gap > resurrectGapDays) resurrected++;
}
} else if (inPrev.length > 0) {
churned++;
}
}
return { newPlayers, resurrected, churned, netGrowth: newPlayers + resurrected - churned };
}
// ── retention ────────────────────────────────────────────────────────────────
/**
* Fraction of players first seen on `cohortDate` who played again within
* `n` days. Returns null for cohorts smaller than `minSize`.
*/
export function returnWithin(
completions: CompletionRow[],
cohortDate: string,
n: number,
minSize = 1
): number | null {
const firsts = firstPlayDates(completions);
const datesByPlayer = groupDatesByPlayer(completions);
const end = addDays(cohortDate, n);
let cohort = 0;
let returned = 0;
for (const [id, first] of firsts) {
if (first !== cohortDate) continue;
cohort++;
const dates = datesByPlayer.get(id) ?? [];
if (dates.some((d) => d > cohortDate && d <= end)) returned++;
}
if (cohort < minSize) return null;
return pct(returned, cohort);
}
/** Next-day return rate for a cohort of first-timers. */
export function d1Return(completions: CompletionRow[], cohortDate: string, minSize = 1): number | null {
return returnWithin(completions, cohortDate, 1, minSize);
}
/**
* Weekly cohort triangle. Each row is a cohort (players whose first play fell
* in that week) and each column k is the share active k weeks later.
*/
export function cohortTriangle(
completions: CompletionRow[],
opts: { start: string; weeks: number; asOf?: string; minSize?: number }
): CohortRow[] {
const { start, weeks, asOf, minSize = 1 } = opts;
const firsts = firstPlayDates(completions);
const datesByPlayer = groupDatesByPlayer(completions);
const rows: CohortRow[] = [];
for (let i = 0; i < weeks; i++) {
const weekStart = addDays(start, i * 7);
const weekEnd = addDays(weekStart, 6);
const members: string[] = [];
for (const [id, first] of firsts) {
if (first >= weekStart && first <= weekEnd) members.push(id);
}
const size = members.length;
const counts: number[] = [];
const rates: (number | null)[] = [];
for (let k = 0; k < weeks - i; k++) {
const wStart = addDays(weekStart, k * 7);
const wEnd = addDays(wStart, 6);
if (asOf && wStart > asOf) {
counts.push(0);
rates.push(null);
continue;
}
let active = 0;
for (const id of members) {
const dates = datesByPlayer.get(id) ?? [];
if (dates.some((d) => d >= wStart && d <= wEnd)) active++;
}
counts.push(active);
rates.push(size < minSize ? null : pct(active, size));
}
rows.push({ weekStart, size, counts, rates });
}
return rows;
}
/** Days until a first-timer's second play, bucketed. */
export function timeToSecondPlayHistogram(completions: CompletionRow[]): HistogramBin[] {
const datesByPlayer = groupDatesByPlayer(completions);
const gaps: number[] = [];
for (const dates of datesByPlayer.values()) {
if (dates.length < 2) continue;
gaps.push(dayDiff(dates[0], dates[1]));
}
const buckets: { label: string; test: (g: number) => boolean }[] = [
{ label: '1 day', test: (g) => g === 1 },
{ label: '2 days', test: (g) => g === 2 },
{ label: '3–4 days', test: (g) => g >= 3 && g <= 4 },
{ label: '5–7 days', test: (g) => g >= 5 && g <= 7 },
{ label: '8–14 days', test: (g) => g >= 8 && g <= 14 },
{ label: '15–30 days', test: (g) => g >= 15 && g <= 30 },
{ label: '31+ days', test: (g) => g >= 31 }
];
return buckets.map((b) => ({ label: b.label, value: gaps.filter(b.test).length }));
}
// ── guesses / difficulty ─────────────────────────────────────────────────────
/** Distribution of guess counts, with everything above `max` collapsed. */
export function guessHistogram(completions: CompletionRow[], max = 8): HistogramBin[] {
const bins: HistogramBin[] = [];
for (let g = 1; g <= max; g++) bins.push({ label: String(g), value: 0 });
bins.push({ label: `${max + 1}+`, value: 0 });
for (const c of completions) {
if (c.guessCount <= max) bins[c.guessCount - 1].value++;
else bins[max].value++;
}
return bins;
}
/** Share of completions solved on the very first guess, %. */
export function firstTryRate(completions: CompletionRow[]): number | null {
if (completions.length === 0) return null;
const firstTry = completions.filter((c) => c.guessCount === 1).length;
return pct(firstTry, completions.length);
}
export function averageGuesses(completions: CompletionRow[]): number | null {
if (completions.length === 0) return null;
const total = completions.reduce((sum, c) => sum + c.guessCount, 0);
return round1(total / completions.length);
}
// ── streaks ──────────────────────────────────────────────────────────────────
export interface StreakSurvivalPoint {
length: number;
probability: number;
}
/**
* Probability that a streak of length N continues to N+1.
* Denominator counts every day a player's run reached length N.
*/
export function streakSurvival(completions: CompletionRow[]): StreakSurvivalPoint[] {
const datesByPlayer = groupDatesByPlayer(completions);
const attempts = new Map<number, number>();
const continued = new Map<number, number>();
for (const dates of datesByPlayer.values()) {
let streak = 0;
for (let i = 0; i < dates.length; i++) {
streak = i > 0 && dayDiff(dates[i - 1], dates[i]) === 1 ? streak + 1 : 1;
attempts.set(streak, (attempts.get(streak) ?? 0) + 1);
const tomorrow = addDays(dates[i], 1);
if (dates.includes(tomorrow)) {
continued.set(streak, (continued.get(streak) ?? 0) + 1);
}
}
}
const lengths = [...attempts.keys()].sort((a, b) => a - b);
const out: StreakSurvivalPoint[] = [];
for (const length of lengths) {
const denom = attempts.get(length) ?? 0;
if (denom === 0) continue;
out.push({ length, probability: round1(((continued.get(length) ?? 0) / denom) * 100) });
}
return out;
}
// ── content ──────────────────────────────────────────────────────────────────
/** Shannon entropy (bits) of a count distribution. */
export function entropy(counts: number[]): number {
const total = counts.reduce((a, b) => a + b, 0);
if (total <= 0) return 0;
let h = 0;
for (const c of counts) {
if (c <= 0) continue;
const p = c / total;
h -= p * Math.log2(p);
}
return Math.round(h * 1000) / 1000;
}
/** Next-feature interval per book, bucketed. */
export function repeatIntervals(verses: VerseRow[]): HistogramBin[] {
const byBook = new Map<string, string[]>();
for (const v of verses) {
const arr = byBook.get(v.bookId);
if (arr) arr.push(v.date);
else byBook.set(v.bookId, [v.date]);
}
const gaps: number[] = [];
for (const dates of byBook.values()) {
dates.sort();
for (let i = 1; i < dates.length; i++) gaps.push(dayDiff(dates[i - 1], dates[i]));
}
const buckets: { label: string; test: (g: number) => boolean }[] = [
{ label: '1–7d', test: (g) => g <= 7 },
{ label: '8–14d', test: (g) => g >= 8 && g <= 14 },
{ label: '15–30d', test: (g) => g >= 15 && g <= 30 },
{ label: '31–60d', test: (g) => g >= 31 && g <= 60 },
{ label: '61–90d', test: (g) => g >= 61 && g <= 90 },
{ label: '90d+', test: (g) => g > 90 }
];
return buckets.map((b) => ({ label: b.label, value: gaps.filter(b.test).length }));
}
export interface BookCoverageOptions {
start: string;
end: string;
minPlays?: number;
}
/**
* Per-book content + retention stats over `[start, end]`.
* `days` is the number of distinct days the book was the answer; `plays` is the
* number of completions on those days.
*/
export function bookCoverage(
verses: VerseRow[],
completions: CompletionRow[],
opts: BookCoverageOptions
): BookStat[] {
const { start, end, minPlays = 1 } = opts;
const verseInRange = verses.filter((v) => v.date >= start && v.date <= end);
const bookByDate = new Map<string, string>();
const daysByBook = new Map<string, Set<string>>();
for (const v of verseInRange) {
bookByDate.set(v.date, v.bookId);
let set = daysByBook.get(v.bookId);
if (!set) {
set = new Set();
daysByBook.set(v.bookId, set);
}
set.add(v.date);
}
const datesByPlayer = groupDatesByPlayer(completions);
const completionsInRange = completions.filter((c) => c.date >= start && c.date <= end);
// Aggregate per book
const stats = new Map<
string,
{ plays: number; firstTry: number; guessSum: number; d1: number; d1Denom: number }
>();
for (const c of completionsInRange) {
const bookId = bookByDate.get(c.date);
if (!bookId) continue;
let s = stats.get(bookId);
if (!s) {
s = { plays: 0, firstTry: 0, guessSum: 0, d1: 0, d1Denom: 0 };
stats.set(bookId, s);
}
s.plays++;
if (c.guessCount === 1) s.firstTry++;
s.guessSum += c.guessCount;
s.d1Denom++;
const dates = datesByPlayer.get(c.anonymousId) ?? [];
if (dates.includes(addDays(c.date, 1))) s.d1++;
}
const out: BookStat[] = [];
for (const book of bibleBooks) {
const days = daysByBook.get(book.id)?.size ?? 0;
const s = stats.get(book.id);
if (!s || s.plays < minPlays) {
out.push({
bookId: book.id,
days,
plays: s?.plays ?? 0,
firstTryPct: s ? (pct(s.firstTry, s.plays) ?? 0) : 0,
avgGuesses: s ? round1(s.guessSum / s.plays) : 0,
d1Return: null
});
continue;
}
out.push({
bookId: book.id,
days,
plays: s.plays,
firstTryPct: pct(s.firstTry, s.plays) ?? 0,
avgGuesses: round1(s.guessSum / s.plays),
d1Return: pct(s.d1, s.d1Denom)
});
}
return out;
}
/** Next-day return rate grouped by how many guesses the solve took. */
export function retentionByGuessBucket(
completions: CompletionRow[]
): { bucket: string; d1: number | null; plays: number }[] {
const datesByPlayer = groupDatesByPlayer(completions);
const buckets: { label: string; test: (g: number) => boolean }[] = [
{ label: '1', test: (g) => g === 1 },
{ label: '2', test: (g) => g === 2 },
{ label: '3', test: (g) => g === 3 },
{ label: '4–5', test: (g) => g >= 4 && g <= 5 },
{ label: '6+', test: (g) => g >= 6 }
];
return buckets.map((b) => {
const rows = completions.filter((c) => b.test(c.guessCount));
let returned = 0;
for (const c of rows) {
const dates = datesByPlayer.get(c.anonymousId) ?? [];
if (dates.includes(addDays(c.date, 1))) returned++;
}
return { bucket: b.label, d1: pct(returned, rows.length), plays: rows.length };
});
}
/** Completion counts by weekday (0=Sun) and UTC hour. */
export function weekdayHourHeatmap(completions: CompletionRow[]): number[][] {
const grid: number[][] = Array.from({ length: 7 }, () => Array(24).fill(0));
for (const c of completions) {
const d = new Date(c.completedAt);
grid[d.getUTCDay()][d.getUTCHours()]++;
}
return grid;
}
/** Overall share of players who ever played more than once. */
export function overallReturnRate(completions: CompletionRow[]): number | null {
const datesByPlayer = groupDatesByPlayer(completions);
if (datesByPlayer.size === 0) return null;
let returned = 0;
for (const dates of datesByPlayer.values()) if (dates.length >= 2) returned++;
return pct(returned, datesByPlayer.size);
}
/** Players who completed on each date, for daily series. */
export function dailyCompletionsSeries(
completions: CompletionRow[],
start: string,
end: string
): { date: string; completions: number; newPlayers: number }[] {
const firsts = firstPlayDates(completions);
const byDate = new Map<string, { completions: number; newPlayers: number }>();
for (const date of dateRange(start, end)) byDate.set(date, { completions: 0, newPlayers: 0 });
for (const c of completions) {
const row = byDate.get(c.date);
if (!row) continue;
row.completions++;
if (firsts.get(c.anonymousId) === c.date) row.newPlayers++;
}
return [...byDate.entries()].map(([date, v]) => ({ date, ...v }));
}
export { startOfWeek, addDays, dayDiff };
+80
View File
@@ -0,0 +1,80 @@
import type {
PlayerState,
SegmentCounts,
SegmentSets,
StatsSettings
} from '$lib/types/stats';
import { dayDiff } from './dates';
/**
* Classify players into mutually-exclusive lifecycle segments using the
* thresholds supplied at render time. The stored player state is frozen as of
* the snapshot date, so changing thresholds re-segments all history instantly
* without rebuilding anything.
*/
export function deriveSegments(
players: PlayerState[],
asOfDate: string,
settings: StatsSettings
): SegmentSets {
const sets: SegmentSets = {
new: [],
core: [],
returning: [],
resurrected: [],
atRisk: [],
churned: [],
active: []
};
for (const p of players) {
const inactive = dayDiff(p.lastDate, asOfDate);
const firstAge = dayDiff(p.firstDate, asOfDate);
// Inactive segments first.
if (inactive >= settings.churn_days) {
sets.churned.push(p.id);
continue;
}
if (inactive >= settings.at_risk_days) {
sets.atRisk.push(p.id);
continue;
}
sets.active.push(p.id);
if (firstAge < 7) {
sets.new.push(p.id);
} else if (p.plays7 >= settings.core_plays_per_week) {
sets.core.push(p.id);
} else if (
p.plays7 > 0 &&
firstAge > settings.resurrect_gap_days &&
p.plays30 <= p.plays7
) {
// Active this week, no activity in the 8–30 day band, first seen long
// ago → they came back after a long gap.
sets.resurrected.push(p.id);
} else {
sets.returning.push(p.id);
}
}
return sets;
}
export function countSegments(sets: SegmentSets): SegmentCounts {
return {
new: sets.new.length,
core: sets.core.length,
returning: sets.returning.length,
resurrected: sets.resurrected.length,
atRisk: sets.atRisk.length,
churned: sets.churned.length,
active: sets.active.length,
total:
sets.active.length +
sets.atRisk.length +
sets.churned.length
};
}
+82
View File
@@ -0,0 +1,82 @@
import { db as defaultDb } from '$lib/server/db';
import { dashboardSettings } from '$lib/server/db/schema';
import {
SETTINGS_DEFAULTS,
type SettingsKey,
type StatsSettings
} from '$lib/types/stats';
import type { StatsDb } from './db';
const SETTINGS_KEYS = Object.keys(SETTINGS_DEFAULTS) as SettingsKey[];
/** `core_plays_per_week` → `STATS_CORE_PLAYS_PER_WEEK` */
export function settingsEnvVar(key: SettingsKey): string {
return `STATS_${key.toUpperCase()}`;
}
/** Defaults from `SETTINGS_DEFAULTS`, overridden by `STATS_*` env vars. */
export function envSettings(): StatsSettings {
const out = { ...SETTINGS_DEFAULTS } as StatsSettings;
for (const key of SETTINGS_KEYS) {
const raw = Bun.env[settingsEnvVar(key)];
if (raw === undefined || raw === '') continue;
const value = Number(raw);
if (Number.isFinite(value)) out[key] = value;
}
return out;
}
function coerce(key: SettingsKey, raw: string): number {
const value = Number(raw);
return Number.isFinite(value) ? value : SETTINGS_DEFAULTS[key];
}
/**
* Reads persisted overrides from `dashboard_settings` and overlays them on the
* env/default baseline. Safe to call when the table does not yet exist.
*/
export async function getSettings(database: StatsDb = defaultDb): Promise<StatsSettings> {
const settings = envSettings();
try {
const rows = await database.select().from(dashboardSettings);
for (const row of rows) {
if ((SETTINGS_KEYS as string[]).includes(row.key)) {
settings[row.key as SettingsKey] = coerce(row.key as SettingsKey, row.value);
}
}
} catch {
// Table missing / DB unavailable — fall back to defaults.
}
return settings;
}
/** Upserts a partial set of setting overrides. */
export async function updateSettings(
partial: Partial<StatsSettings>,
database: StatsDb = defaultDb
): Promise<StatsSettings> {
const now = new Date();
for (const [key, value] of Object.entries(partial)) {
if (!(SETTINGS_KEYS as string[]).includes(key)) continue;
if (value === undefined || value === null || !Number.isFinite(value)) continue;
await database
.insert(dashboardSettings)
.values({ key, value: String(value), updatedAt: now })
.onConflictDoUpdate({
target: dashboardSettings.key,
set: { value: String(value), updatedAt: now }
});
}
return getSettings(database);
}
/** Stable short hash of the resolved settings — used to detect stale snapshots. */
export function hashSettings(settings: StatsSettings): string {
const canonical = SETTINGS_KEYS.map((k) => `${k}=${settings[k]}`).join(';');
const digest = new Bun.CryptoHasher('sha256').update(canonical).digest('hex');
return digest.slice(0, 12);
}
export async function configVersion(database: StatsDb = defaultDb): Promise<string> {
return hashSettings(await getSettings(database));
}
+246
View File
@@ -0,0 +1,246 @@
import type { SeriesPoint, Signal, SignalSeverity, SnapshotPayload, StatsSettings } from '$lib/types/stats';
// ── generic anomaly detection ────────────────────────────────────────────────
export interface Anomaly {
date: string;
value: number;
median: number;
score: number;
}
/**
* Robust, weekday-aware anomaly detection. Compares the latest point with the
* median/MAD of the same weekday over the preceding `lookback` points.
* Returns null when there is not enough history or the series is flat.
*/
export function detectAnomaly(series: SeriesPoint[], threshold: number, lookback = 28): Anomaly | null {
const points = series.filter((p) => p.value !== null) as { date: string; value: number }[];
if (points.length < 5) return null;
const latest = points[points.length - 1];
const weekday = new Date(latest.date + 'T00:00:00Z').getUTCDay();
const history = points
.slice(0, -1)
.filter((p) => new Date(p.date + 'T00:00:00Z').getUTCDay() === weekday)
.slice(-lookback);
if (history.length < 4) return null;
const values = history.map((p) => p.value).sort((a, b) => a - b);
const median = medianOf(values);
const deviations = values.map((v) => Math.abs(v - median)).sort((a, b) => a - b);
const mad = medianOf(deviations);
if (mad === 0) return null;
const score = (0.6745 * (latest.value - median)) / mad;
if (Math.abs(score) < threshold) return null;
return { date: latest.date, value: latest.value, median: Math.round(median * 10) / 10, score: Math.round(score * 10) / 10 };
}
function medianOf(sorted: number[]): number {
if (sorted.length === 0) return 0;
const mid = Math.floor(sorted.length / 2);
return sorted.length % 2 === 0 ? (sorted[mid - 1] + sorted[mid]) / 2 : sorted[mid];
}
// ── rule helpers ─────────────────────────────────────────────────────────────
type Direction = 'up' | 'down';
interface TargetRule {
id: string;
title: string;
action: string;
value: number | null;
target: number;
/** At or above target is good when direction is 'up'. */
direction?: Direction;
/** Absolute value that means "red" regardless of the target. */
red: number;
unit?: string;
}
function evaluateTarget(rule: TargetRule): Signal {
const { id, title, action, value, target, red, direction = 'up', unit = '%' } = rule;
if (value === null) {
return {
id,
severity: 'info',
title,
detail: `Not enough data yet to measure this (needs instrumented events).`,
metric: id,
value: null,
target
};
}
const meets = direction === 'up' ? value >= target : value <= target;
const isRed = direction === 'up' ? value < red : value > red;
let severity: SignalSeverity = 'good';
if (!meets) severity = isRed ? 'bad' : 'warn';
const comparison =
direction === 'up'
? value >= target
? `at or above the ${target}% target`
: `below the ${target}% target`
: value <= target
? `at or below the ${target}% target`
: `above the ${target}% target`;
return {
id,
severity,
title,
detail: `${title} is ${value}${unit}, ${comparison}.`,
action: severity === 'good' ? undefined : action,
metric: id,
value,
target
};
}
// ── main engine ──────────────────────────────────────────────────────────────
/**
* Evaluate the explicit targets plus anomaly detection. Pure: the snapshot
* payload carries every number the engine needs.
*/
export function evaluateSignals(payload: SnapshotPayload, settings: StatsSettings): Signal[] {
const { kpis, activity } = payload;
const signals: Signal[] = [];
signals.push(
evaluateTarget({
id: 'd1_return',
title: 'D1 return',
action: 'Test a "come back tomorrow" prompt on the win screen.',
value: kpis.d1Return,
target: settings.d1_target,
red: 12
})
);
signals.push(
evaluateTarget({
id: 'return7',
title: '7-day return',
action: 'Improve the first-session experience or send a day-2 reminder.',
value: kpis.return7,
target: settings.return7_target,
red: 15
})
);
signals.push(
evaluateTarget({
id: 'completion',
title: 'Completion rate',
action: 'Look for friction between the first guess and the win screen.',
value: kpis.completionRate,
target: settings.completion_target,
red: 55
})
);
// First-try rate is a band: both too high and too low are bad.
if (kpis.firstTryRate === null) {
signals.push({
id: 'first_try',
severity: 'info',
title: 'First-try rate',
detail: 'Not enough data yet to measure this.',
metric: 'first_try'
});
} else {
const v = kpis.firstTryRate;
const inBand = v >= settings.first_try_min && v <= settings.first_try_max;
const severe = v > 45 || v < 8;
signals.push({
id: 'first_try',
severity: inBand ? 'good' : severe ? 'bad' : 'warn',
title: 'Verse achievability',
detail: `First-try rate is ${v}% (target band ${settings.first_try_min}–${settings.first_try_max}%).${
v > settings.first_try_max
? ' Verses may be too easy / self-revealing.'
: v < settings.first_try_min
? ' Verses may be too hard.'
: ''
}`,
action: inBand ? undefined : 'Review the verse mix for the easiest / hardest books.',
metric: 'first_try',
value: v,
target: settings.first_try_max
});
}
signals.push(
evaluateTarget({
id: 'share_rate',
title: 'Share rate',
action: 'Make the share action more prominent or reward sharing.',
value: kpis.shareRate,
target: settings.share_target,
red: 15
})
);
// Core players: week-over-week direction.
if (activity.corePrevious === null) {
signals.push({
id: 'core_players',
severity: 'info',
title: 'Core players',
detail: `${activity.core} players finished 4+ times this week. No prior week to compare yet.`,
metric: 'core_players',
value: activity.core
});
} else {
const delta = activity.core - activity.corePrevious;
signals.push({
id: 'core_players',
severity: delta >= 0 ? 'good' : 'warn',
title: 'Core players',
detail: `${activity.core} players finished 4+ times this week (${delta >= 0 ? '+' : ''}${delta} vs last week).`,
action: delta < 0 ? 'Check whether verse difficulty or reminders changed.' : undefined,
metric: 'core_players',
value: activity.core
});
}
// Anomaly detection on the daily completions series.
const anomaly = detectAnomaly(
payload.dailySeries.map((d) => ({ date: d.date, value: d.completions })),
settings.anomaly_mad_threshold
);
if (anomaly) {
const direction = anomaly.score > 0 ? 'above' : 'below';
signals.push({
id: 'completions_anomaly',
severity: anomaly.score > 0 ? 'good' : 'warn',
title: 'Unusual day',
detail: `${anomaly.date} had ${anomaly.value} finishes, well ${direction} the usual ${anomaly.median} for that weekday.`,
action: anomaly.score < 0 ? 'Check for outages or a hard verse.' : undefined,
metric: 'completions',
value: anomaly.value,
target: anomaly.median
});
}
return signals;
}
const SEVERITY_ORDER: Record<SignalSeverity, number> = { bad: 0, warn: 1, info: 2, good: 3 };
export function sortSignals(signals: Signal[]): Signal[] {
return signals
.slice()
.sort((a, b) => SEVERITY_ORDER[a.severity] - SEVERITY_ORDER[b.severity]);
}
/** One-line verdict for the Pulse banner. */
export function verdictLine(signals: Signal[]): string {
const top = sortSignals(signals)[0];
if (!top) return 'No signals yet.';
if (top.severity === 'good') return `All core metrics are on target. ${top.detail}`;
if (top.severity === 'info') return top.detail;
return top.detail;
}
+684
View File
@@ -0,0 +1,684 @@
import { and, eq, lte } from 'drizzle-orm';
import { db as defaultDb } from '$lib/server/db';
import {
analyticsEvents,
dailyCompletions,
dailyVerses,
statsSnapshot,
user
} from '$lib/server/db/schema';
import type { StatsDb } from './db';
import type {
Activity,
CompletionRow,
DailyPoint,
HabitData,
HistogramBin,
Kpis,
PlayerState,
SeriesPoint,
SnapshotPayload,
StatsSettings,
VerseRow
} from '$lib/types/stats';
import { bibleBooks } from '$lib/types/bible';
import { getSettings, hashSettings } from './settings';
import { deriveSegments, countSegments } from './segments';
import { evaluateSignals } from './signals';
import {
activePlayers,
averageGuesses,
bookCoverage,
cohortTriangle,
dailyCompletionsSeries,
entropy,
firstPlayDates,
firstTryRate,
groupDatesByPlayer,
guessHistogram,
netGrowth,
newVsReturning,
overallReturnRate,
repeatIntervals,
retentionByGuessBucket,
streakSurvival,
timeToSecondPlayHistogram,
weekdayHourHeatmap
} from './metrics';
import { addDays, dateRange, dayDiff, startOfWeek, todayUtc } from './dates';
export type BuildKind = 'scheduled' | 'lazy' | 'reconstructed';
/**
* Bump whenever the snapshot payload shape changes. Older snapshots are
* rebuilt lazily so the UI never reads a stale shape.
*/
export const PAYLOAD_SCHEMA_VERSION = 2;
const RETENTION_WINDOW_DAYS = 180;
const SERIES_DAYS = 90;
const RECENT_KPI_DAYS = 30;
function endOfDay(dateStr: string): Date {
return new Date(dateStr + 'T23:59:59.999Z');
}
function round1(n: number): number {
return Math.round(n * 10) / 10;
}
export interface LoadedData {
completions: CompletionRow[];
verses: VerseRow[];
startedByDate: Map<string, number>;
shareEvents: number;
firstEventDate: string | null;
signupDates: string[];
}
/** Load all rows needed to build a snapshot as of `cutoff` (inclusive). */
export async function loadStatsData(
cutoff: string,
database: StatsDb = defaultDb
): Promise<LoadedData> {
const cutoffDate = endOfDay(cutoff);
const completionRows = await database
.select({
anonymousId: dailyCompletions.anonymousId,
date: dailyCompletions.date,
guessCount: dailyCompletions.guessCount,
guesses: dailyCompletions.guesses,
completedAt: dailyCompletions.completedAt
})
.from(dailyCompletions)
.where(and(lte(dailyCompletions.date, cutoff), lte(dailyCompletions.completedAt, cutoffDate)));
const verseRows = await database
.select({ date: dailyVerses.date, bookId: dailyVerses.bookId })
.from(dailyVerses)
.where(lte(dailyVerses.date, cutoff));
const eventRows = await database
.select({
name: analyticsEvents.name,
date: analyticsEvents.date,
createdAt: analyticsEvents.createdAt
})
.from(analyticsEvents)
.where(lte(analyticsEvents.createdAt, cutoffDate));
const startedByDate = new Map<string, number>();
let shareEvents = 0;
let firstEventDate: string | null = null;
for (const e of eventRows) {
const eventDate = e.date ?? new Date(e.createdAt).toISOString().slice(0, 10);
if (!firstEventDate || eventDate < firstEventDate) firstEventDate = eventDate;
if (e.name === 'verse_served' && e.date && e.date <= cutoff) {
startedByDate.set(e.date, (startedByDate.get(e.date) ?? 0) + 1);
}
if ((e.name === 'share' || e.name === 'share_copy') && eventDate <= cutoff) {
shareEvents++;
}
}
const userRows = await database
.select({ id: user.id, createdAt: user.createdAt })
.from(user)
.where(lte(user.createdAt, cutoffDate));
return {
completions: completionRows as CompletionRow[],
verses: verseRows,
startedByDate,
shareEvents,
firstEventDate,
signupDates: userRows
.filter((u) => u.createdAt)
.map((u) => new Date(u.createdAt as Date).toISOString().slice(0, 10))
};
}
/** Compact per-player state as of `asOfDate`, for players active in the window. */
export function computePlayerState(
completions: CompletionRow[],
asOfDate: string,
activeWindowDays: number
): PlayerState[] {
const windowStart = addDays(asOfDate, -(activeWindowDays - 1));
const sevenStart = addDays(asOfDate, -6);
const thirtyStart = addDays(asOfDate, -29);
const datesByPlayer = groupDatesByPlayer(completions);
const out: PlayerState[] = [];
for (const [id, dates] of datesByPlayer) {
const inScope = dates.filter((d) => d <= asOfDate);
if (inScope.length === 0) continue;
const firstDate = inScope[0];
const lastDate = inScope[inScope.length - 1];
if (lastDate < windowStart) continue;
// Current consecutive-day streak ending at the last active day.
let streak = 1;
for (let i = inScope.length - 1; i > 0; i--) {
if (dayDiff(inScope[i - 1], inScope[i]) === 1) streak++;
else break;
}
out.push({
id,
firstDate,
lastDate,
totalPlays: inScope.length,
plays7: inScope.filter((d) => d >= sevenStart).length,
plays30: inScope.filter((d) => d >= thirtyStart).length,
streak
});
}
return out;
}
/** Pooled return rate over a run of cohort days (more stable than single days). */
function pooledReturn(
completions: CompletionRow[],
cohortEnd: string,
cohortDays: number,
n: number
): number | null {
const firsts = firstPlayDates(completions);
const datesByPlayer = groupDatesByPlayer(completions);
const start = addDays(cohortEnd, -(cohortDays - 1));
let cohort = 0;
let returned = 0;
for (const [id, first] of firsts) {
if (first < start || first > cohortEnd) continue;
cohort++;
const limit = addDays(first, n);
const dates = datesByPlayer.get(id) ?? [];
if (dates.some((d) => d > first && d <= limit)) returned++;
}
if (cohort === 0) return null;
return round1((returned / cohort) * 100);
}
function buildActivity(
pointCompletions: CompletionRow[],
asOfDate: string,
settings: StatsSettings
): Activity {
const dau = activePlayers(pointCompletions, asOfDate, 1);
const wau = activePlayers(pointCompletions, asOfDate, 7);
const mau = activePlayers(pointCompletions, asOfDate, 30);
const { returningShare } = newVsReturning(pointCompletions, asOfDate);
const growth = netGrowth(pointCompletions, asOfDate, 7, settings.resurrect_gap_days);
// Core count current + one week earlier, both with current thresholds.
const core = deriveSegments(
computePlayerState(pointCompletions, asOfDate, settings.active_window_days),
asOfDate,
settings
).core.length;
const prevDate = addDays(asOfDate, -7);
const corePrevious = deriveSegments(
computePlayerState(
pointCompletions.filter((c) => c.date <= prevDate),
prevDate,
settings.active_window_days
),
prevDate,
settings
).core.length;
const prev = addDays(asOfDate, -7);
const previous = {
dau: activePlayers(pointCompletions, prev, 1),
wau: activePlayers(pointCompletions, prev, 7),
mau: activePlayers(pointCompletions, prev, 30),
core: corePrevious
};
return {
dau,
wau,
mau,
core,
returningShare,
newPlayers: growth.newPlayers,
resurrected: growth.resurrected,
churned: growth.churned,
netGrowth: growth.netGrowth,
corePrevious,
previous
};
}
function buildKpis(
pointCompletions: CompletionRow[],
data: LoadedData,
asOfDate: string
): Kpis {
const recentStart = addDays(asOfDate, -(RECENT_KPI_DAYS - 1));
const recent = pointCompletions.filter((c) => c.date >= recentStart);
const shares = data.shareEvents;
const completionsInRecent = recent.length;
// Completion rate: only meaningful once verse_served events exist.
let started = 0;
for (const [date, count] of data.startedByDate) {
if (date >= recentStart && date <= asOfDate) started += count;
}
const completionRate = started > 0 ? round1((completionsInRecent / started) * 100) : null;
const shareRate = shares > 0 && completionsInRecent > 0
? round1((shares / completionsInRecent) * 100)
: null;
return {
// Most recent resolvable cohorts (as-of yesterday can't resolve its own D1).
d1Return: pooledReturn(pointCompletions, addDays(asOfDate, -1), 7, 1),
return7: pooledReturn(pointCompletions, addDays(asOfDate, -7), 7, 7),
overallReturnRate: overallReturnRate(pointCompletions),
completionRate,
shareRate,
firstTryRate: firstTryRate(recent),
avgGuesses: averageGuesses(recent)
};
}
function buildCurves(
pointCompletions: CompletionRow[],
allCompletions: CompletionRow[],
asOfDate: string,
n: number,
matured: boolean
): SeriesPoint[] {
const series: SeriesPoint[] = [];
// Only cohorts whose window has resolved by `asOfDate` are point-in-time
// honest; for matured builds the effective end is today.
const effectiveEnd = matured ? todayUtc() : asOfDate;
const latest = addDays(effectiveEnd, -n);
const start = addDays(latest, -29);
const firsts = firstPlayDates(pointCompletions);
const datesByPlayer = groupDatesByPlayer(allCompletions);
for (const date of dateRange(start, latest)) {
const limit = addDays(date, n);
let cohort = 0;
let returned = 0;
for (const [id, first] of firsts) {
if (first !== date) continue;
cohort++;
const dates = datesByPlayer.get(id) ?? [];
if (dates.some((d) => d > date && d <= limit)) returned++;
}
series.push({ date, value: cohort >= 3 ? round1((returned / cohort) * 100) : null });
}
return series;
}
function buildHabit(pointCompletions: CompletionRow[], players: PlayerState[], asOfDate: string): HabitData {
const calendarStart = addDays(asOfDate, -119);
const calendarCounts = new Map<string, number>();
for (const c of pointCompletions) {
if (c.date < calendarStart || c.date > asOfDate) continue;
calendarCounts.set(c.date, (calendarCounts.get(c.date) ?? 0) + 1);
}
const calendar = dateRange(calendarStart, asOfDate).map((date) => ({
date,
count: calendarCounts.get(date) ?? 0
}));
// Current-streak distribution, bucketed.
const buckets = new Map<string, number>([
['1', 0],
['2', 0],
['3–4', 0],
['5–6', 0],
['7–13', 0],
['14+', 0]
]);
for (const p of players) {
if (p.streak <= 1) continue;
const label =
p.streak === 2
? '2'
: p.streak <= 4
? '3–4'
: p.streak <= 6
? '5–6'
: p.streak <= 13
? '7–13'
: '14+';
buckets.set(label, (buckets.get(label) ?? 0) + 1);
}
const streakLengths: HistogramBin[] = [...buckets.entries()].map(([label, value]) => ({
label,
value
}));
return {
streakSurvival: streakSurvival(pointCompletions),
streakLengths,
calendar,
weekdayHour: weekdayHourHeatmap(pointCompletions)
};
}
function buildSegmentMix(
pointCompletions: CompletionRow[],
asOfDate: string,
settings: StatsSettings
): SnapshotPayload['retention']['segmentMix'] {
const start = addDays(asOfDate, -29);
const out: SnapshotPayload['retention']['segmentMix'] = [];
for (const date of dateRange(start, asOfDate)) {
const point = pointCompletions.filter((c) => c.date <= date);
const players = computePlayerState(point, date, settings.active_window_days);
const counts = countSegments(deriveSegments(players, date, settings));
out.push({
date,
new: counts.new,
core: counts.core,
returning: counts.returning,
resurrected: counts.resurrected,
atRisk: counts.atRisk,
churned: counts.churned
});
}
return out;
}
function buildGrowth(
data: LoadedData,
players: PlayerState[],
asOfDate: string
): SnapshotPayload['growth'] {
const thresholds = [1, 2, 5, 10, 25, 50];
const lifecycleFunnel = thresholds.map((t) => ({
label: `${t}+`,
players: players.filter((p) => p.totalPlays >= t).length
}));
const start = addDays(asOfDate, -89);
const counts = new Map<string, number>();
for (const d of data.signupDates) {
if (d >= start && d <= asOfDate) counts.set(d, (counts.get(d) ?? 0) + 1);
}
const signups = dateRange(start, asOfDate).map((date) => ({
date,
count: counts.get(date) ?? 0
}));
return { lifecycleFunnel, signups };
}
function buildVerseMix(
pointCompletions: CompletionRow[],
verses: VerseRow[],
asOfDate: string
): SnapshotPayload['verseMix'] {
const mixStart = addDays(asOfDate, -179);
const inRangeVerses = verses.filter((v) => v.date >= mixStart && v.date <= asOfDate);
const oldTestament = new Set(
bibleBooks.filter((b) => b.testament === 'old').map((b) => b.id)
);
const coverage = bookCoverage(inRangeVerses, pointCompletions, {
start: mixStart,
end: asOfDate
});
// Weekly testament mix + book-distribution entropy.
const weeksBack = 12;
const weekStart = startOfWeek(addDays(asOfDate, -(weeksBack - 1) * 7));
const testamentMix: { date: string; old: number; new: number }[] = [];
const entropySeries: SeriesPoint[] = [];
for (let w = 0; w < weeksBack; w++) {
const wStart = addDays(weekStart, w * 7);
const wEnd = addDays(wStart, 6);
const rows = inRangeVerses.filter((v) => v.date >= wStart && v.date <= wEnd);
if (rows.length === 0) {
testamentMix.push({ date: wStart, old: 0, new: 0 });
entropySeries.push({ date: wStart, value: null });
continue;
}
const bookCounts = new Map<string, number>();
let old = 0;
let nt = 0;
for (const v of rows) {
bookCounts.set(v.bookId, (bookCounts.get(v.bookId) ?? 0) + 1);
if (oldTestament.has(v.bookId)) old++;
else nt++;
}
testamentMix.push({ date: wStart, old, new: nt });
entropySeries.push({ date: wStart, value: entropy([...bookCounts.values()]) });
}
const firstTryByBook = coverage
.filter((b) => b.plays >= 3)
.sort((a, b) => b.plays - a.plays);
return {
coverage,
testamentMix,
entropy: entropySeries,
repeatIntervals: repeatIntervals(verses),
firstTryByBook,
retentionByBook: coverage.filter((b) => b.d1Return !== null),
retentionByGuessBucket: retentionByGuessBucket(pointCompletions),
achievability: guessHistogram(pointCompletions.filter((c) => c.date >= addDays(asOfDate, -29)))
};
}
export interface ComputeOptions {
/** Data cutoff for retention resolution (defaults to asOfDate). */
matureThrough?: string;
}
/**
* Compute a full snapshot payload. Pure with respect to I/O: everything it
* needs is passed in, which keeps the point-in-time cutoff testable.
*/
export function computePayload(
asOfDate: string,
settings: StatsSettings,
data: LoadedData,
opts: ComputeOptions = {}
): SnapshotPayload {
const pointCompletions = data.completions.filter((c) => c.date <= asOfDate);
// Retention uses everything loaded: identical for point-in-time builds, and
// extends past `asOfDate` for matured builds.
const allCompletions = data.completions;
const matured = !!opts.matureThrough && opts.matureThrough > asOfDate;
const activity = buildActivity(pointCompletions, asOfDate, settings);
const kpis = buildKpis(pointCompletions, data, asOfDate);
const seriesStart = addDays(asOfDate, -(SERIES_DAYS - 1));
const baseSeries = dailyCompletionsSeries(pointCompletions, seriesStart, asOfDate);
const dailySeries: DailyPoint[] = baseSeries.map((d) => ({
...d,
started: data.startedByDate.get(d.date) ?? 0
}));
const players = computePlayerState(pointCompletions, asOfDate, settings.active_window_days);
const cohortStart = startOfWeek(addDays(asOfDate, -11 * 7));
const cohorts = cohortTriangle(allCompletions, {
start: cohortStart,
weeks: 12,
asOf: matured ? todayUtc() : asOfDate,
minSize: 3
});
const retention: SnapshotPayload['retention'] = {
cohorts,
curves: {
d1: buildCurves(pointCompletions, allCompletions, asOfDate, 1, matured),
d7: buildCurves(pointCompletions, allCompletions, asOfDate, 7, matured),
d30: buildCurves(pointCompletions, allCompletions, asOfDate, 30, matured)
},
timeToSecondPlay: timeToSecondPlayHistogram(allCompletions),
segmentMix: buildSegmentMix(pointCompletions, asOfDate, settings)
};
const growth = buildGrowth(data, players, asOfDate);
const verseMix = buildVerseMix(pointCompletions, data.verses, asOfDate);
const habit = buildHabit(pointCompletions, players, asOfDate);
const yesterday = pointCompletions.filter((c) => c.date === asOfDate);
const totals = {
completions: pointCompletions.length,
players: firstPlayDates(pointCompletions).size,
yesterdayCompletions: yesterday.length,
yesterdayAvgGuesses: averageGuesses(yesterday)
};
const payload: SnapshotPayload = {
asOfDate,
activity,
dailySeries,
kpis,
retention,
verseMix,
habit,
growth,
totals,
signals: [],
meta: {
hasStartedData: data.startedByDate.size > 0,
hasShareData: data.shareEvents > 0,
firstEventDate: data.firstEventDate,
generatedAt: Date.now(),
schemaVersion: PAYLOAD_SCHEMA_VERSION
}
};
payload.signals = evaluateSignals(payload, settings);
return payload;
}
export interface StoredSnapshot {
date: string;
generatedAt: Date;
buildKind: BuildKind;
configVersion: string;
payload: SnapshotPayload;
config: StatsSettings;
playerState: PlayerState[];
}
function parseRow(row: typeof statsSnapshot.$inferSelect): StoredSnapshot {
return {
date: row.date,
generatedAt: row.generatedAt,
buildKind: row.buildKind as BuildKind,
configVersion: row.configVersion,
payload: JSON.parse(row.payload) as SnapshotPayload,
config: JSON.parse(row.config) as StatsSettings,
playerState: row.playerState ? (JSON.parse(row.playerState) as PlayerState[]) : []
};
}
export async function getSnapshot(
date: string,
database: StatsDb = defaultDb
): Promise<StoredSnapshot | null> {
const [row] = await database.select().from(statsSnapshot).where(eq(statsSnapshot.date, date));
return row ? parseRow(row) : null;
}
export interface BuildResult {
snapshot: StoredSnapshot;
settings: StatsSettings;
buildKind: BuildKind;
}
/**
* Build and persist a snapshot. `replace=false` never overwrites an existing
* (immutable) snapshot; the caller re-reads instead.
*/
export async function buildSnapshot(
asOfDate: string,
opts: { kind: BuildKind; replace?: boolean; matureThrough?: string; persist?: boolean },
database: StatsDb = defaultDb
): Promise<BuildResult> {
const settings = await getSettings(database);
const version = hashSettings(settings);
const cutoff = opts.matureThrough ?? asOfDate;
const data = await loadStatsData(cutoff, database);
const payload = computePayload(asOfDate, settings, data, {
matureThrough: opts.matureThrough
});
const playerState = computePlayerState(
data.completions.filter((c) => c.date <= asOfDate),
asOfDate,
settings.active_window_days
);
const row = {
date: asOfDate,
generatedAt: new Date(),
buildKind: opts.kind,
configVersion: version,
payload: JSON.stringify(payload),
playerState: JSON.stringify(playerState),
config: JSON.stringify(settings)
};
if (opts.persist !== false) {
if (opts.replace) {
await database
.insert(statsSnapshot)
.values(row)
.onConflictDoUpdate({ target: statsSnapshot.date, set: row });
} else {
await database.insert(statsSnapshot).values(row).onConflictDoNothing();
}
}
return {
snapshot: {
date: asOfDate,
generatedAt: row.generatedAt,
buildKind: opts.kind,
configVersion: version,
payload,
config: settings,
playerState
},
settings,
buildKind: opts.kind
};
}
/**
* Return the snapshot for `date`, building it lazily if missing. Race-safe via
* `INSERT OR IGNORE` followed by a re-read.
*/
export async function ensureSnapshot(
date: string,
opts: { matureThrough?: string } = {},
database: StatsDb = defaultDb
): Promise<StoredSnapshot> {
const existing = await getSnapshot(date, database);
if (existing && existing.payload.meta?.schemaVersion === PAYLOAD_SCHEMA_VERSION) {
return existing;
}
// Missing or built with an older payload shape: (re)build deterministically
// for this point in time. The point-in-time cutoff keeps it faithful.
await buildSnapshot(
date,
{ kind: 'lazy', matureThrough: opts.matureThrough, replace: !!existing },
database
);
const stored = await getSnapshot(date, database);
if (!stored) throw new Error(`Failed to build snapshot for ${date}`);
return stored;
}
/** True when a stored snapshot was built with different thresholds or shape. */
export async function isSnapshotStale(
date: string,
database: StatsDb = defaultDb
): Promise<boolean> {
const snapshot = await getSnapshot(date, database);
if (!snapshot) return false;
if (snapshot.payload.meta?.schemaVersion !== PAYLOAD_SCHEMA_VERSION) return true;
const current = hashSettings(await getSettings(database));
return snapshot.configVersion !== current;
}
+293
View File
@@ -0,0 +1,293 @@
import { db as defaultDb } from '$lib/server/db';
import { dailyVerses, verseSubmissions } from '$lib/server/db/schema';
import { eq, desc, sql } from 'drizzle-orm';
import { getBookById } from '$lib/server/bible';
// Drizzle instance type alias (the production db or the test db).
export type Db = typeof defaultDb;
import {
composeVerseWindow,
formatWindowReference,
getChapterCount,
getVerseCount
} from '$lib/server/xml-bible';
// Server-side constants for the community-verse-submission feature
// (spec: "Rate Limiting & Cooldown", "Scheduling Algorithm").
const DAY_MS = 1000 * 60 * 60 * 24;
export const COOLDOWN_MS = 7 * DAY_MS;
export const REPEAT_WINDOW_DAYS = 60;
const MAX_SCHEDULE_RETRIES = 5;
// Safety cap on the day-by-day forward scan. 10k days (~27 years) is well
// beyond any realistic calendar density; prevents an accidental infinite loop.
const MAX_SCAN_DAYS = 10_000;
export interface SubmissionInput {
bookId: string;
chapter: number;
verse: number;
}
export interface ScheduleResult {
scheduledDate: string;
reference: string;
windowText: string;
bookId: string;
}
/** Add `n` days to a YYYY-MM-DD string using pure UTC arithmetic. */
export function addDays(dateStr: string, n: number): string {
const d = new Date(dateStr + 'T00:00:00Z');
d.setUTCDate(d.getUTCDate() + n);
return d.toISOString().slice(0, 10);
}
/** Whole-day difference (b - a) between two YYYY-MM-DD strings, UTC. */
export function dayDiff(a: string, b: string): number {
const ta = new Date(a + 'T00:00:00Z').getTime();
const tb = new Date(b + 'T00:00:00Z').getTime();
return Math.round((tb - ta) / DAY_MS);
}
/** Current server UTC date as YYYY-MM-DD. */
export function todayUtcStr(): string {
return new Date().toISOString().slice(0, 10);
}
/**
* The canonical identity of a 3-verse window, used by the 60-day repeat rule.
* Combines bookId + formatted reference so identical windows collide regardless
* of how the underlying row was produced (submission vs. random gap-fill).
*/
function windowRef(bookId: string, reference: string): string {
return `${bookId}|${reference}`;
}
/** Is this a SQLite unique-constraint violation (used for retry-on-conflict)? */
export function isUniqueConstraintError(err: unknown): boolean {
const e = err as { code?: string; message?: string } | null;
return !!e && (
e.code === 'SQLITE_CONSTRAINT_UNIQUE' ||
e.code === 'SQLITE_CONSTRAINT' ||
!!(e.message && /UNIQUE/i.test(e.message))
);
}
export interface CooldownState {
/** True if the user submitted within the last 7 days. */
onCooldown: boolean;
/** Server UTC millis when the cooldown expires, or null. */
cooldownEndsAt: number | null;
}
/** Compute the rolling 7-day cooldown state for a user (server UTC). */
export async function getCooldownState(
db: Db,
userId: string,
now: number = Date.now()
): Promise<CooldownState> {
const [last] = await db
.select({ submittedAt: verseSubmissions.submittedAt })
.from(verseSubmissions)
.where(eq(verseSubmissions.userId, userId))
.orderBy(desc(verseSubmissions.submittedAt))
.limit(1);
if (!last) {
return { onCooldown: false, cooldownEndsAt: null };
}
const cooldownEndsAt = last.submittedAt + COOLDOWN_MS;
if (now < cooldownEndsAt) {
return { onCooldown: true, cooldownEndsAt };
}
return { onCooldown: false, cooldownEndsAt: null };
}
/** Structural validation of a user-supplied (bookId, chapter, verse) selection. */
export function validateSelection(input: SubmissionInput): string | null {
const book = getBookById(input.bookId);
if (!book) return 'Unknown bookId';
if (!Number.isInteger(input.chapter) || input.chapter < 1) {
return 'chapter must be a positive integer';
}
const chapterCount = getChapterCount(book.order);
if (input.chapter > chapterCount) {
return `chapter out of range (1-${chapterCount})`;
}
if (!Number.isInteger(input.verse) || input.verse < 1) {
return 'verse must be a positive integer';
}
const verseCount = getVerseCount(book.order, input.chapter);
if (input.verse > verseCount) {
return `verse out of range (1-${verseCount})`;
}
return null;
}
interface LoadedCalendar {
byDate: Map<string, { bookId: string; windowRef: string }>;
datesByWindowRef: Map<string, string[]>;
}
/** Load every committed daily_verses row into in-memory indexes for the scan. */
async function loadCalendar(db: Db): Promise<LoadedCalendar> {
const rows = await db
.select({
date: dailyVerses.date,
bookId: dailyVerses.bookId,
reference: dailyVerses.reference
})
.from(dailyVerses);
const byDate = new Map<string, { bookId: string; windowRef: string }>();
const datesByWindowRef = new Map<string, string[]>();
for (const r of rows) {
const wr = windowRef(r.bookId, r.reference);
byDate.set(r.date, { bookId: r.bookId, windowRef: wr });
const arr = datesByWindowRef.get(wr);
if (arr) arr.push(r.date);
else datesByWindowRef.set(wr, [r.date]);
}
return { byDate, datesByWindowRef };
}
/**
* Find the earliest valid candidate date `D` (scanning forward from tomorrow,
* server UTC) for a submission with the given book + window identity.
*
* Validity (spec "Scheduling Algorithm"):
* 1. Empty: no daily_verses row at D.
* 2. No back-to-back: D-1 (if committed) has a different book.
* 3. No back-to-back: D+1 (if committed) has a different book.
* 4. 60-day repeat: no identical window within [D-60, D+60] inclusive.
*/
async function findCandidateDate(
db: Db,
bookId: string,
submissionWindowRef: string,
opts?: { startFrom?: string; today?: string }
): Promise<string | null> {
const { byDate, datesByWindowRef } = await loadCalendar(db);
let cursor = opts?.startFrom ?? addDays(opts?.today ?? todayUtcStr(), 1);
for (let i = 0; i < MAX_SCAN_DAYS; i++) {
// Rule 1: must be empty.
if (!byDate.has(cursor)) {
// Rules 2 & 3: no back-to-back with committed neighbors.
const prev = byDate.get(addDays(cursor, -1));
const next = byDate.get(addDays(cursor, 1));
const backToBack =
(!!prev && prev.bookId === bookId) ||
(!!next && next.bookId === bookId);
if (!backToBack) {
// Rule 4: 60-day repeat distance for the identical window.
const sameWindowDates = datesByWindowRef.get(submissionWindowRef) ?? [];
const tooClose = sameWindowDates.some(
(d) => Math.abs(dayDiff(d, cursor)) <= REPEAT_WINDOW_DAYS
);
if (!tooClose) {
return cursor;
}
}
}
cursor = addDays(cursor, 1);
}
return null;
}
/**
* Run the scheduling scan and write the daily_verses + verse_submissions rows
* in a transaction. On a unique-constraint conflict (concurrent submission
* picked the same date), re-run the scan from the next day; retry up to a
* small bound.
*/
export async function scheduleSubmission(
db: Db,
input: SubmissionInput,
userId: string,
now: number = Date.now(),
opts?: { today?: string }
): Promise<ScheduleResult> {
const book = getBookById(input.bookId);
if (!book) throw new Error('Invalid bookId');
const window = composeVerseWindow(book.order, input.chapter, input.verse);
if (!window) throw new Error('Invalid chapter/verse for this book');
const reference = formatWindowReference(
window.bookName,
window.startChapter,
window.startVerse,
window.endChapter,
window.endVerse
);
const windowText = window.verses.join(' ');
const submissionWindowRef = windowRef(book.id, reference);
let lastCandidate = '';
for (let attempt = 0; attempt < MAX_SCHEDULE_RETRIES; attempt++) {
// Re-compute the candidate each attempt — a concurrent submission may
// have claimed the previous candidate between scan and insert. After a
// conflict, re-scan from the day *after* the contested candidate.
const candidate = await findCandidateDate(
db,
book.id,
submissionWindowRef,
attempt === 0
? { today: opts?.today }
: { startFrom: addDays(lastCandidate, 1) }
);
if (!candidate) {
throw new Error('No valid candidate date found within the scan window');
}
lastCandidate = candidate;
try {
db.transaction((tx) => {
tx.insert(dailyVerses)
.values({
id: Bun.randomUUIDv7(),
date: candidate,
bookId: book.id,
verseText: windowText,
reference,
createdAt: sql`${Math.floor(now / 1000)}`
})
.run();
tx.insert(verseSubmissions)
.values({
id: Bun.randomUUIDv7(),
userId,
scheduledDate: candidate,
selectedBookId: input.bookId,
selectedChapter: input.chapter,
selectedVerse: input.verse,
submittedAt: now
})
.run();
});
return {
scheduledDate: candidate,
reference,
windowText,
bookId: book.id
};
} catch (err) {
if (isUniqueConstraintError(err)) {
continue; // retry — re-scan from tomorrow
}
throw err;
}
}
throw new Error('Failed to schedule submission after retries');
}
+126 -2
View File
@@ -135,7 +135,7 @@ function getGreekChapter(bookNumber: number, chapterNumber: number): ChapterData
/** /**
* Get the number of verses in a specific chapter * Get the number of verses in a specific chapter
*/ */
function getVerseCount(bookNumber: number, chapterNumber: number): number { export function getVerseCount(bookNumber: number, chapterNumber: number): number {
const chapter = getChapter(bookNumber, chapterNumber); const chapter = getChapter(bookNumber, chapterNumber);
return chapter ? chapter.verse.length : 0; return chapter ? chapter.verse.length : 0;
} }
@@ -151,7 +151,7 @@ function getGreekVerseCount(bookNumber: number, chapterNumber: number): number {
/** /**
* Get the number of chapters in a specific book * Get the number of chapters in a specific book
*/ */
function getChapterCount(bookNumber: number): number { export function getChapterCount(bookNumber: number): number {
const book = getBook(bookNumber); const book = getBook(bookNumber);
return book ? book.chapter.length : 0; return book ? book.chapter.length : 0;
} }
@@ -439,3 +439,127 @@ export function getAllNKJVVerses(): Array<{ text: string; book: string; chapter:
} }
return verses; return verses;
} }
/**
* Resolve a 1-based book-wide verse index to { chapter, verse }.
* The index is contiguous across all chapters of the book.
*/
function resolveBookVerseIndex(
bookNumber: number,
index: number
): { chapter: number; verse: number } | null {
const chapterCount = getChapterCount(bookNumber);
let cumulative = 0;
for (let c = 1; c <= chapterCount; c++) {
const vCount = getVerseCount(bookNumber, c);
if (index <= cumulative + vCount) {
return { chapter: c, verse: index - cumulative };
}
cumulative += vCount;
}
return null;
}
export interface ComposedWindow {
bookId: string;
bookName: string;
verses: string[]; // the 3 verse texts in order
startChapter: number;
startVerse: number;
endChapter: number;
endVerse: number;
selectedVerse: number; // the anchor verse number within its chapter
}
/**
* Compose a 3-verse window anchored on (book, chapter, verse), constrained to
* a single book. Default window is [v-2, v-1, v] in book-wide verse indices;
* if that would run before the book's start (v is 1 or 2), fall forward to
* [v, v+1, v+2]. Cross-chapter windows within the same book are allowed.
*
* Mirrors the spec's "Verse Windowing" section.
*/
export function composeVerseWindow(
bookNumber: number,
chapter: number,
verse: number
): ComposedWindow | null {
const book = getBookByNumber(bookNumber);
if (!book) return null;
const chapterCount = getChapterCount(bookNumber);
if (chapter < 1 || chapter > chapterCount) return null;
const verseCount = getVerseCount(bookNumber, chapter);
if (verse < 1 || verse > verseCount) return null;
// Book-wide 1-based index of the selected verse.
let selectedIndex = 0;
for (let c = 1; c < chapter; c++) selectedIndex += getVerseCount(bookNumber, c);
selectedIndex += verse;
let startIdx: number;
let endIdx: number;
if (selectedIndex - 2 < 1) {
// Fall forward: [v, v+1, v+2]
startIdx = selectedIndex;
endIdx = selectedIndex + 2;
} else {
startIdx = selectedIndex - 2;
endIdx = selectedIndex;
}
const start = resolveBookVerseIndex(bookNumber, startIdx);
const end = resolveBookVerseIndex(bookNumber, endIdx);
if (!start || !end) return null;
// Extract the contiguous window, crossing chapter boundaries within the book as needed.
const verses: string[] = [];
let curChapter = start.chapter;
let curVerse = start.verse;
while (verses.length < 3 && curChapter <= chapterCount) {
const vCount = getVerseCount(bookNumber, curChapter);
while (curVerse <= vCount && verses.length < 3) {
const ex = extractVerses(bookNumber, curChapter, curVerse, 1);
if (ex.length === 1) {
verses.push(ex[0]);
} else {
break;
}
curVerse++;
}
curChapter++;
curVerse = 1;
}
if (verses.length < 3) return null;
return {
bookId: book.id,
bookName: book.name,
verses,
startChapter: start.chapter,
startVerse: start.verse,
endChapter: end.chapter,
endVerse: end.verse,
selectedVerse: verse
};
}
/**
* Format a reference for a window that may span chapters within a book.
* Same-chapter: "Genesis 1:1-3" (hyphen)
* Cross-chapter: "Genesis 1:31–2:1" (en-dash)
*/
export function formatWindowReference(
bookName: string,
startChapter: number,
startVerse: number,
endChapter: number,
endVerse: number
): string {
if (startChapter === endChapter) {
if (startVerse === endVerse) return `${bookName} ${startChapter}:${startVerse}`;
return `${bookName} ${startChapter}:${startVerse}-${endVerse}`;
}
return `${bookName} ${startChapter}:${startVerse}\u2013${endChapter}:${endVerse}`;
}
+3 -23
View File
@@ -1,18 +1,6 @@
import { browser } from "$app/environment"; import { browser } from "$app/environment";
import { evaluateGuess, generateUUID, type Guess } from "$lib/utils/game"; import { evaluateGuess, type Guess } from "$lib/utils/game";
import { getOrCreateAnonymousId } from "$lib/utils/analytics";
// Returns a stable anonymous ID for this browser, creating one if it doesn't exist yet.
// Used to attribute stats to a player who hasn't signed in.
function getOrCreateAnonymousId(): string {
if (!browser) return "";
const key = "bibdle-anonymous-id";
let id = localStorage.getItem(key);
if (!id) {
id = generateUUID();
localStorage.setItem(key, id);
}
return id;
}
// Reactive store that keeps in-memory game state in sync with localStorage. // Reactive store that keeps in-memory game state in sync with localStorage.
// Accepts getter functions (rather than plain values) so Svelte's reactivity // Accepts getter functions (rather than plain values) so Svelte's reactivity
@@ -53,15 +41,7 @@ export function createGamePersistence(
if ((window as any).umami) { if ((window as any).umami) {
(window as any).umami.identify(anonymousId); (window as any).umami.identify(anonymousId);
} }
if (user) {
const nameParts = [user.firstName, user.lastName].filter(Boolean);
(window as any).rybbit?.identify(user.id, {
...(nameParts.length ? { name: nameParts.join(' ') } : {}),
...(user.email ? { email: user.email } : {}),
});
} else {
(window as any).rybbit?.identify(anonymousId);
}
const date = getDate(); const date = getDate();
const reference = getReference(); const reference = getReference();
+252
View File
@@ -0,0 +1,252 @@
/**
* Shared types for the private statistics dashboard (see statistics-plan.md).
*
* Keep this module dependency-free (no DB / Svelte imports) so it can be used
* from server code, Svelte components, and unit tests alike.
*/
// ── Settings ─────────────────────────────────────────────────────────────────
/**
* Dashboard thresholds. Keys are snake_case to match both the
* `dashboard_settings` table and the `STATS_*` environment variables.
*/
export const SETTINGS_DEFAULTS = {
core_plays_per_week: 4,
churn_days: 30,
resurrect_gap_days: 30,
at_risk_days: 8,
active_window_days: 180,
d1_target: 20,
return7_target: 25,
completion_target: 70,
first_try_min: 15,
first_try_max: 35,
share_target: 25,
anomaly_mad_threshold: 2
} as const;
export type SettingsKey = keyof typeof SETTINGS_DEFAULTS;
export type StatsSettings = Record<SettingsKey, number>;
// ── Plain rows (pure metric inputs) ──────────────────────────────────────────
/** The subset of a `daily_completions` row the metrics need. */
export interface CompletionRow {
anonymousId: string;
date: string;
guessCount: number;
guesses?: string | null;
completedAt: Date | number;
}
export interface VerseRow {
date: string;
bookId: string;
}
export interface UserRow {
id: string;
createdAt: Date | null;
}
// ── Player state & segments ──────────────────────────────────────────────────
/** Compact per-player state frozen as of a snapshot date. */
export interface PlayerState {
id: string;
firstDate: string;
lastDate: string;
totalPlays: number;
plays7: number;
plays30: number;
streak: number;
}
export interface SegmentSets {
new: string[];
core: string[];
returning: string[];
resurrected: string[];
atRisk: string[];
churned: string[];
active: string[];
}
export interface SegmentCounts {
new: number;
core: number;
returning: number;
resurrected: number;
atRisk: number;
churned: number;
active: number;
total: number;
}
// ── Signals ──────────────────────────────────────────────────────────────────
export type SignalSeverity = 'good' | 'info' | 'warn' | 'bad';
export interface Signal {
id: string;
severity: SignalSeverity;
title: string;
detail: string;
action?: string;
metric?: string;
value?: number | null;
target?: number | null;
}
// ── Payload ──────────────────────────────────────────────────────────────────
export interface DailyPoint {
date: string;
completions: number;
newPlayers: number;
started: number;
}
export interface SeriesPoint {
date: string;
value: number | null;
}
export interface CohortRow {
weekStart: string;
size: number;
/** Index 0 = week 0 (the cohort week); index k = k weeks later. */
counts: number[];
rates: (number | null)[];
}
export interface HistogramBin {
label: string;
value: number;
}
export interface BookStat {
bookId: string;
days: number;
plays: number;
firstTryPct: number;
avgGuesses: number;
d1Return: number | null;
}
export interface Activity {
dau: number;
wau: number;
mau: number;
core: number;
returningShare: number | null;
newPlayers: number;
resurrected: number;
churned: number;
netGrowth: number;
/** Core count from the snapshot ~7 days earlier (same thresholds), if available. */
corePrevious: number | null;
/** Same-metric values for the previous day (weekday-aligned comparison). */
previous: {
dau: number;
wau: number;
mau: number;
core: number;
} | null;
}
export interface Kpis {
d1Return: number | null;
return7: number | null;
overallReturnRate: number | null;
completionRate: number | null;
shareRate: number | null;
firstTryRate: number | null;
avgGuesses: number | null;
}
export interface RetentionData {
cohorts: CohortRow[];
curves: {
d1: SeriesPoint[];
d7: SeriesPoint[];
d30: SeriesPoint[];
};
timeToSecondPlay: HistogramBin[];
segmentMix: {
date: string;
new: number;
core: number;
returning: number;
resurrected: number;
atRisk: number;
churned: number;
}[];
}
export interface VerseMixData {
coverage: BookStat[];
testamentMix: { date: string; old: number; new: number }[];
entropy: SeriesPoint[];
repeatIntervals: HistogramBin[];
firstTryByBook: BookStat[];
retentionByBook: BookStat[];
retentionByGuessBucket: { bucket: string; d1: number | null; plays: number }[];
achievability: HistogramBin[];
}
export interface HabitData {
streakSurvival: { length: number; probability: number }[];
streakLengths: HistogramBin[];
calendar: { date: string; count: number }[];
weekdayHour: number[][];
}
export interface SnapshotPayload {
asOfDate: string;
activity: Activity;
dailySeries: DailyPoint[];
kpis: Kpis;
retention: RetentionData;
verseMix: VerseMixData;
habit: HabitData;
growth: {
lifecycleFunnel: { label: string; players: number }[];
signups: { date: string; count: number }[];
};
/** Safe, all-time aggregates for the public community widget. */
totals: {
completions: number;
players: number;
yesterdayCompletions: number;
yesterdayAvgGuesses: number | null;
};
signals: Signal[];
/** Metadata about data availability, so the UI can show honest em-dashes. */
meta: {
hasStartedData: boolean;
hasShareData: boolean;
firstEventDate: string | null;
generatedAt?: number;
/** Payload shape version; older snapshots are rebuilt lazily. */
schemaVersion?: number;
};
}
// ── Analytics events ─────────────────────────────────────────────────────────
/** Appendix B — allowlisted event names. */
export const EVENT_NAMES = [
'verse_served',
'share',
'share_copy',
'first_visit',
'donate_click',
'discord_click'
] as const;
export type EventName = (typeof EVENT_NAMES)[number];
export const MAX_METADATA_BYTES = 2048;
+36
View File
@@ -0,0 +1,36 @@
/** Pure first-touch acquisition parsing (no browser/SvelteKit imports). */
export interface Acquisition {
referrer: string | null;
utm_source: string | null;
utm_medium: string | null;
utm_campaign: string | null;
}
/**
* Extract first-touch acquisition data from a query string and referrer.
* Same-origin referrers are ignored when `location` is available.
*/
export function parseAcquisition(search: string, referrer: string): Acquisition {
const params = new URLSearchParams(search);
const clean = (v: string | null): string | null => {
if (v === null) return null;
const trimmed = v.trim().slice(0, 256);
return trimmed.length > 0 ? trimmed : null;
};
let ref = referrer || null;
if (ref) {
try {
const refUrl = new URL(ref);
if (typeof location !== 'undefined' && refUrl.origin === location.origin) ref = null;
} catch {
/* keep raw referrer */
}
}
return {
referrer: clean(ref),
utm_source: clean(params.get('utm_source') ?? params.get('ref')),
utm_medium: clean(params.get('utm_medium')),
utm_campaign: clean(params.get('utm_campaign'))
};
}
+65
View File
@@ -0,0 +1,65 @@
import { browser } from '$app/environment';
import { generateUUID } from './game';
import { parseAcquisition, type Acquisition } from './acquisition';
import type { EventName } from '$lib/types/stats';
export { parseAcquisition };
export type { Acquisition };
const ANON_KEY = 'bibdle-anonymous-id';
const FIRST_VISIT_KEY = 'bibdle-first-visit-sent';
/** Stable pseudonymous ID for this browser, created on first use. */
export function getOrCreateAnonymousId(): string {
if (!browser) return '';
let id = localStorage.getItem(ANON_KEY);
if (!id) {
id = generateUUID();
localStorage.setItem(ANON_KEY, id);
}
return id;
}
/**
* Fire-and-forget event. Never throws and never blocks the UI.
* `date` should be the game date for date-scoped events (e.g. verse_served).
*/
export function track(
name: EventName,
metadata?: Record<string, unknown> | null,
date?: string | null
): void {
if (!browser) return;
try {
const body = JSON.stringify({
name,
anonymousId: getOrCreateAnonymousId(),
date: date ?? null,
metadata: metadata ?? null
});
void fetch('/api/events', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body,
keepalive: true
}).catch(() => {});
} catch {
/* ignore */
}
}
/**
* Records a single `first_visit` event per browser with referrer / UTM data.
* Call once on mount (root layout).
*/
export function captureFirstVisit(): void {
if (!browser) return;
try {
if (localStorage.getItem(FIRST_VISIT_KEY) === 'true') return;
const acquisition = parseAcquisition(location.search, document.referrer ?? '');
track('first_visit', { ...acquisition });
localStorage.setItem(FIRST_VISIT_KEY, 'true');
} catch {
/* ignore */
}
}
+43
View File
@@ -0,0 +1,43 @@
/** Small formatting helpers shared by the stats dashboard components. */
export function numOrDash(n: number | null | undefined): string {
return n === null || n === undefined ? '—' : String(n);
}
export function pctOrDash(n: number | null | undefined): string {
return n === null || n === undefined ? '—' : `${n}%`;
}
export function signed(n: number | null | undefined): string {
if (n === null || n === undefined) return '—';
return `${n >= 0 ? '+' : ''}${n}`;
}
export function formatDateLabel(dateStr: string): string {
return new Date(dateStr + 'T00:00:00Z').toLocaleDateString('en-US', {
month: 'short',
day: 'numeric',
year: 'numeric',
timeZone: 'UTC'
});
}
export function weekdayName(dateStr: string): string {
return new Date(dateStr + 'T00:00:00Z').toLocaleDateString('en-US', {
weekday: 'short',
timeZone: 'UTC'
});
}
/** Compare a value to a previous value, returning signed delta and direction. */
export function delta(
value: number | null | undefined,
previous: number | null | undefined
): { text: string; direction: 'up' | 'down' | 'flat' } {
if (value === null || value === undefined || previous === null || previous === undefined) {
return { text: '—', direction: 'flat' };
}
const diff = value - previous;
if (diff === 0) return { text: 'no change', direction: 'flat' };
return { text: signed(diff), direction: diff > 0 ? 'up' : 'down' };
}
+29 -8
View File
@@ -1,17 +1,32 @@
<script lang="ts"> <script lang="ts">
import { onMount } from 'svelte'; import { onMount } from "svelte";
import { browser } from "$app/environment";
import "./layout.css"; import "./layout.css";
import favicon from "$lib/assets/favicon.ico"; import favicon from "$lib/assets/favicon.ico";
import TitleAnimation from "$lib/components/TitleAnimation.svelte"; import TitleAnimation from "$lib/components/TitleAnimation.svelte";
import ThemeToggle from "$lib/components/ThemeToggle.svelte";
import { captureFirstVisit } from "$lib/utils/analytics";
let isDev = $state(false);
onMount(() => { onMount(() => {
isDev =
window.location.host === "localhost:5173" ||
window.location.host === "test.bibdle.com";
// Instrumentation E: capture first-touch referrer / UTM once per browser.
captureFirstVisit();
// Inject analytics script // Inject analytics script
const script = document.createElement('script'); const script = document.createElement("script");
script.defer = true; script.defer = true;
script.src = 'https://umami.snail.city/script.js'; script.src = "https://umami.snail.city/script.js";
script.setAttribute('data-website-id', '5b8c31ad-71cd-4317-940b-6bccea732acc'); script.setAttribute(
script.setAttribute('data-domains', 'bibdle.com,www.bibdle.com'); "data-website-id",
"5b8c31ad-71cd-4317-940b-6bccea732acc",
);
script.setAttribute("data-domains", "bibdle.com,www.bibdle.com");
document.body.appendChild(script); document.body.appendChild(script);
}); });
@@ -20,16 +35,22 @@
<svelte:head> <svelte:head>
<link rel="icon" href={favicon} /> <link rel="icon" href={favicon} />
<link rel="alternate" type="application/rss+xml" title="Bibdle RSS Feed" href="/feed.xml" /> <meta name="description" content="A Wordle-inspired daily Bible game" />
<meta name="description" content="A daily Bible game" />
</svelte:head> </svelte:head>
<div class="min-h-dvh md:bg-linear-to-br md:from-blue-50 md:to-indigo-200 dark:md:from-gray-900 dark:md:to-slate-950"> <div
class="min-h-dvh md:bg-linear-to-br md:from-blue-50 md:to-indigo-200 dark:md:from-gray-900 dark:md:to-slate-950"
>
<h1 <h1
class="text-3xl md:text-4xl font-bold text-center uppercase text-gray-600 dark:text-gray-300 drop-shadow-2xl tracking-widest p-4 pt-12 animate-fade-in-up" class="text-3xl md:text-4xl font-bold text-center uppercase text-gray-600 dark:text-gray-300 drop-shadow-2xl tracking-widest p-4 pt-12 animate-fade-in-up"
> >
<TitleAnimation /> <TitleAnimation />
<div class="font-normal"></div> <div class="font-normal"></div>
</h1> </h1>
{#if isDev}
<div class="flex justify-center pb-2"><ThemeToggle /></div>
{:else}
<div class="justify-center hidden pb-2"><ThemeToggle /></div>
{/if}
{@render children()} {@render children()}
</div> </div>
+13
View File
@@ -18,6 +18,18 @@ export const actions: Actions = {
const anonymousId = formData.get('anonymousId') as string; const anonymousId = formData.get('anonymousId') as string;
const date = formData.get('date') as string; const date = formData.get('date') as string;
const guessCount = parseInt(formData.get('guessCount') as string, 10); const guessCount = parseInt(formData.get('guessCount') as string, 10);
// Optional JSON array of book IDs — mirrors the JSON API so all guest
// completions persist guess sequences (instrumentation A).
const guessesRaw = formData.get('guesses') as string | null;
let guesses: string[] | null = null;
if (guessesRaw) {
try {
const parsed = JSON.parse(guessesRaw);
if (Array.isArray(parsed)) guesses = parsed.map(String);
} catch {
guesses = null;
}
}
// Validation // Validation
if (!anonymousId || !date || isNaN(guessCount) || guessCount < 1) { if (!anonymousId || !date || isNaN(guessCount) || guessCount < 1) {
@@ -33,6 +45,7 @@ export const actions: Actions = {
anonymousId, anonymousId,
date, date,
guessCount, guessCount,
guesses: guesses && guesses.length > 0 ? JSON.stringify(guesses) : null,
completedAt, completedAt,
}); });
} catch (err: any) { } catch (err: any) {
+131 -14
View File
@@ -2,17 +2,19 @@
import type { PageProps } from "./$types"; import type { PageProps } from "./$types";
import { browser } from "$app/environment"; import { browser } from "$app/environment";
import { enhance } from "$app/forms"; import { enhance } from "$app/forms";
import { onMount } from "svelte";
import VerseDisplay from "$lib/components/VerseDisplay.svelte"; import VerseDisplay from "$lib/components/VerseDisplay.svelte";
import SearchInput from "$lib/components/SearchInput.svelte"; import SearchInput from "$lib/components/SearchInput.svelte";
import GuessesTable from "$lib/components/GuessesTable.svelte"; import GuessesTable from "$lib/components/GuessesTable.svelte";
import WinScreen from "$lib/components/WinScreen.svelte"; import WinScreen from "$lib/components/WinScreen.svelte";
import Credits from "$lib/components/Credits.svelte"; import Credits from "$lib/components/Credits.svelte";
import ThemeToggle from "$lib/components/ThemeToggle.svelte";
import GamePrompt from "$lib/components/GamePrompt.svelte";
import DevButtons from "$lib/components/DevButtons.svelte"; import DevButtons from "$lib/components/DevButtons.svelte";
import AuthModal from "$lib/components/AuthModal.svelte"; import AuthModal from "$lib/components/AuthModal.svelte";
import { evaluateGuess } from "$lib/utils/game"; import { evaluateGuess, getFirstLetter } from "$lib/utils/game";
import { import {
generateShareText, generateShareText,
shareResult, shareResult,
@@ -52,6 +54,7 @@
let statsData = $state<StatsData | null>(null); let statsData = $state<StatsData | null>(null);
let streak = $state(0); let streak = $state(0);
let streakPercentile = $state<number | null>(null); let streakPercentile = $state<number | null>(null);
let guessesMinimized = $state(false);
const persistence = createGamePersistence( const persistence = createGamePersistence(
() => dailyVerse.date, () => dailyVerse.date,
@@ -73,6 +76,62 @@
!persistence.chapterGuessCompleted, !persistence.chapterGuessCompleted,
); );
let knownTestament = $derived(
persistence.guesses.some((g) => g.testamentMatch)
? correctBook?.testament
: null,
);
let knownSection = $derived(
persistence.guesses.some((g) => g.sectionMatch)
? correctBook?.section
: null,
);
let knownFirstLetter = $derived(
persistence.guesses.some((g) => g.firstLetterMatch)
? getFirstLetter(correctBook?.name ?? "").toUpperCase()
: null,
);
let testamentVisible = $state(false);
let sectionVisible = $state(false);
let firstLetterVisible = $state(false);
let showHints = $state(false);
// On page load, show hints that are already known without animation
onMount(() => {
if (knownTestament) testamentVisible = true;
if (knownSection) sectionVisible = true;
if (knownFirstLetter) firstLetterVisible = true;
const winCount = Object.keys(localStorage).filter(
(k) => k.startsWith("bibdle-win-tracked-") && localStorage.getItem(k) === "true"
).length;
showHints = winCount < 3;
});
// Fade in newly revealed hints after the guess animation completes
$effect(() => {
if (!knownTestament || testamentVisible) return;
const id = setTimeout(() => {
testamentVisible = true;
}, 2800);
return () => clearTimeout(id);
});
$effect(() => {
if (!knownSection || sectionVisible) return;
const id = setTimeout(() => {
sectionVisible = true;
}, 2800);
return () => clearTimeout(id);
});
$effect(() => {
if (!knownFirstLetter || firstLetterVisible) return;
const id = setTimeout(() => {
firstLetterVisible = true;
}, 2800);
return () => clearTimeout(id);
});
async function submitGuess(bookId: string) { async function submitGuess(bookId: string) {
if (persistence.guesses.some((g) => g.book.id === bookId)) return; if (persistence.guesses.some((g) => g.book.id === bookId)) return;
@@ -87,7 +146,6 @@
(window as any).umami (window as any).umami
) { ) {
(window as any).umami.track("First guess"); (window as any).umami.track("First guess");
(window as any).rybbit?.event("First guess");
localStorage.setItem(key, "true"); localStorage.setItem(key, "true");
} }
} }
@@ -203,6 +261,23 @@
} }
}); });
// Delay collapsing the guesses grid until animations complete (mirrors showWinScreen delay)
$effect(() => {
if (!isWon || persistence.guesses.length <= 3) {
guessesMinimized = false;
return;
}
if (persistence.isWinAlreadyTracked()) {
guessesMinimized = true;
} else {
const animationDelay = 1800;
const timeoutId = setTimeout(() => {
guessesMinimized = true;
}, animationDelay);
return () => clearTimeout(timeoutId);
}
});
// Track win analytics // Track win analytics
$effect(() => { $effect(() => {
if (!browser || !isWon) return; if (!browser || !isWon) return;
@@ -211,9 +286,6 @@
(window as any).umami.track("Guessed correctly", { (window as any).umami.track("Guessed correctly", {
totalGuesses: persistence.guesses.length, totalGuesses: persistence.guesses.length,
}); });
(window as any).rybbit?.event("Guessed correctly", {
totalGuesses: persistence.guesses.length,
});
} }
}); });
@@ -297,6 +369,44 @@
{#if !isWon} {#if !isWon}
<div class="animate-fade-in-up animate-delay-400"> <div class="animate-fade-in-up animate-delay-400">
<GamePrompt guessCount={persistence.guesses.length} />
{#if showHints && (knownTestament || knownSection || knownFirstLetter)}
<div
class="text-xs uppercase tracking-widest font-bold text-center text-gray-500 dark:text-gray-400 flex flex-col gap-1 mb-4 -mt-2"
>
{#if knownTestament}
<p
style="transition: opacity 0.5s ease; opacity: {testamentVisible
? 1
: 0};"
>
It is in the {knownTestament === "old"
? "Old"
: "New"} Testament.
</p>
{/if}
{#if knownSection}
<p
style="transition: opacity 0.5s ease; opacity: {sectionVisible
? 1
: 0};"
>
It is in the {knownSection} section.
</p>
{/if}
{#if knownFirstLetter}
<p
style="transition: opacity 0.5s ease; opacity: {firstLetterVisible
? 1
: 0};"
>
The book's name starts with "{knownFirstLetter}".
</p>
{/if}
</div>
{/if}
<SearchInput <SearchInput
bind:searchQuery bind:searchQuery
{guessedIds} {guessedIds}
@@ -322,24 +432,27 @@
{streakPercentile} {streakPercentile}
isLoggedIn={!!user} isLoggedIn={!!user}
anonymousId={persistence.anonymousId} anonymousId={persistence.anonymousId}
localDate={new Date().toLocaleDateString("en-CA")}
/> />
</div> </div>
{/if} {/if}
<div class="animate-fade-in-up animate-delay-600"> <div class="animate-fade-in-up animate-delay-600">
<GuessesTable guesses={persistence.guesses} {correctBookId} /> <GuessesTable
guesses={persistence.guesses}
{correctBookId}
minimized={guessesMinimized}
/>
</div> </div>
{#if isWon} {#if isWon}
<hr
class="animate-fade-in-up animate-delay-800 border-gray-300 dark:border-gray-600"
/>
<div class="animate-fade-in-up animate-delay-800"> <div class="animate-fade-in-up animate-delay-800">
<Credits /> <Credits />
</div> </div>
{/if} {/if}
<!-- We will just go with the user's system color theme for now. -->
<div class="flex justify-center hidden mt-4">
<ThemeToggle />
</div>
</div> </div>
{#if isDev} {#if isDev}
<div class="mt-8 flex flex-col items-stretch md:items-center gap-3"> <div class="mt-8 flex flex-col items-stretch md:items-center gap-3">
@@ -376,7 +489,11 @@
<div>Daily Verse Date: {dailyVerse.date}</div> <div>Daily Verse Date: {dailyVerse.date}</div>
<div>Streak: {streak}</div> <div>Streak: {streak}</div>
</div> </div>
<DevButtons anonymousId={persistence.anonymousId} {user} onSignIn={() => (authModalOpen = true)} /> <DevButtons
anonymousId={persistence.anonymousId}
{user}
onSignIn={() => (authModalOpen = true)}
/>
</div> </div>
{/if} {/if}
@@ -388,7 +505,7 @@
.filter(Boolean) .filter(Boolean)
.join(" ")}{user.email .join(" ")}{user.email
? ` (${user.email})` ? ` (${user.email})`
: ""}{user.appleId ? " using Apple" : ""} | : ""}{user.appleId ? " using Apple" : user.googleId ? " using Google" : ""} |
<form <form
method="POST" method="POST"
+3 -1
View File
@@ -1,15 +1,17 @@
import type { PageLoad } from './$types'; import type { PageLoad } from './$types';
import { getOrCreateAnonymousId } from '$lib/utils/analytics';
// Disable SSR so the load function runs on the client with the correct local date // Disable SSR so the load function runs on the client with the correct local date
export const ssr = false; export const ssr = false;
export const load: PageLoad = async ({ fetch, data }) => { export const load: PageLoad = async ({ fetch, data }) => {
const localDate = new Date().toLocaleDateString("en-CA"); const localDate = new Date().toLocaleDateString("en-CA");
const anonymousId = getOrCreateAnonymousId();
const res = await fetch('/api/daily-verse', { const res = await fetch('/api/daily-verse', {
method: 'POST', method: 'POST',
headers: { 'Content-Type': 'application/json' }, headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ date: localDate }), body: JSON.stringify({ date: localDate, anonymousId }),
}); });
const result = await res.json(); const result = await res.json();
+89
View File
@@ -0,0 +1,89 @@
import { error, fail, redirect } from '@sveltejs/kit';
import type { Actions, PageServerLoad } from './$types';
import { isAdmin } from '$lib/server/admin';
import { addDays, isValidDate } from '$lib/server/stats/dates';
import {
buildSnapshot,
ensureSnapshot,
isSnapshotStale
} from '$lib/server/stats/snapshot';
import { deriveSegments, countSegments } from '$lib/server/stats/segments';
import { getSettings, updateSettings, hashSettings } from '$lib/server/stats/settings';
import { sortSignals, verdictLine } from '$lib/server/stats/signals';
import { SETTINGS_DEFAULTS, type SettingsKey, type StatsSettings } from '$lib/types/stats';
function todayEst(): string {
return new Date().toLocaleDateString('en-CA', { timeZone: 'America/New_York' });
}
export const load: PageServerLoad = async ({ locals, url }) => {
if (!isAdmin(locals.user?.email)) {
throw error(404, 'Not found');
}
const today = todayEst();
const yesterday = addDays(today, -1);
const dateParam = url.searchParams.get('date');
let date = dateParam && isValidDate(dateParam) ? dateParam : yesterday;
if (date > today) date = today;
const matured = url.searchParams.get('mature') === '1';
const settings = await getSettings();
// Normal loads read (or lazily build) the immutable snapshot. The mature
// toggle is the only path allowed to compute on demand from raw data.
const snapshot = matured
? (
await buildSnapshot(date, {
kind: 'lazy',
matureThrough: today,
persist: false
})
).snapshot
: await ensureSnapshot(date);
const segments = deriveSegments(snapshot.playerState, date, settings);
const stale =
!matured && snapshot.configVersion !== hashSettings(settings);
const topSignal = sortSignals(snapshot.payload.signals)[0] ?? null;
return {
date,
today,
generatedAt: snapshot.generatedAt,
buildKind: snapshot.buildKind,
payload: snapshot.payload,
settings,
segmentCounts: countSegments(segments),
verdict: verdictLine(snapshot.payload.signals),
topSignal,
stale,
matured,
userEmail: locals.user?.email ?? null
};
};
export const actions: Actions = {
updateSettings: async ({ request, url, locals }) => {
if (!isAdmin(locals.user?.email)) {
return fail(403, { error: 'Forbidden' });
}
const form = await request.formData();
const partial: Partial<StatsSettings> = {};
for (const key of Object.keys(SETTINGS_DEFAULTS) as SettingsKey[]) {
const raw = form.get(key);
if (typeof raw === 'string' && raw !== '') {
const value = Number(raw);
if (Number.isFinite(value)) partial[key] = value;
}
}
try {
await updateSettings(partial);
} catch (err) {
return fail(500, { error: String(err) });
}
// Segments are re-derived at render time, so no rebuild is needed.
const date = url.searchParams.get('date');
throw redirect(303, `/admin/stats${date ? `?date=${date}` : ''}`);
}
};
+75
View File
@@ -0,0 +1,75 @@
<script lang="ts">
import type { PageData } from './$types';
import ConsoleChrome from '$lib/components/stats/ConsoleChrome.svelte';
import Pulse from '$lib/components/stats/Pulse.svelte';
import GrowthLoop from '$lib/components/stats/GrowthLoop.svelte';
import RetentionLab from '$lib/components/stats/RetentionLab.svelte';
import VerseMixLab from '$lib/components/stats/VerseMixLab.svelte';
import HabitLab from '$lib/components/stats/HabitLab.svelte';
import SignalsFeed from '$lib/components/stats/SignalsFeed.svelte';
import FeatureImpact from '$lib/components/stats/FeatureImpact.svelte';
import Glossary from '$lib/components/stats/Glossary.svelte';
import Container from '$lib/components/Container.svelte';
import { numOrDash } from '$lib/utils/stats-format';
let { data }: { data: PageData } = $props();
const segments = $derived(data.segmentCounts);
</script>
<svelte:head>
<title>Growth Console | Bibdle</title>
<meta name="robots" content="noindex" />
</svelte:head>
<div class="min-h-screen bg-gray-950 p-4 md:p-6">
<div class="mx-auto flex max-w-6xl flex-col gap-8 pb-16">
<ConsoleChrome
date={data.date}
today={data.today}
generatedAt={data.generatedAt}
buildKind={data.buildKind}
matured={data.matured}
stale={data.stale}
settings={data.settings}
/>
<Pulse
payload={data.payload}
settings={data.settings}
verdict={data.verdict}
topSignal={data.topSignal}
/>
<section class="flex flex-col gap-3">
<h2 class="text-lg font-bold text-gray-100">Segment mix (as of this date)</h2>
<div class="grid grid-cols-2 gap-3 sm:grid-cols-3 lg:grid-cols-6">
{#each [
{ label: 'New (7d)', value: segments.new },
{ label: 'Core', value: segments.core },
{ label: 'Returning', value: segments.returning },
{ label: 'Resurrected', value: segments.resurrected },
{ label: 'At risk', value: segments.atRisk },
{ label: 'Churned', value: segments.churned }
] as item (item.label)}
<Container class="p-3 w-full items-start text-left">
<p class="text-[11px] font-semibold uppercase tracking-wider text-gray-400">{item.label}</p>
<p class="text-xl font-bold text-gray-100">{numOrDash(item.value)}</p>
</Container>
{/each}
</div>
<p class="text-xs text-gray-500">
Segments are re-derived from stored per-player state, so changing thresholds in Settings
updates every date instantly. Total tracked players: {numOrDash(segments.total)}.
</p>
</section>
<GrowthLoop payload={data.payload} />
<RetentionLab payload={data.payload} settings={data.settings} />
<VerseMixLab payload={data.payload} />
<HabitLab payload={data.payload} />
<SignalsFeed signals={data.payload.signals} />
<FeatureImpact />
<Glossary />
</div>
</div>
@@ -0,0 +1,31 @@
import { json } from '@sveltejs/kit';
import type { RequestHandler } from './$types';
import { isAdmin } from '$lib/server/admin';
import { isValidDate } from '$lib/server/stats/dates';
import { buildSnapshot } from '$lib/server/stats/snapshot';
/** Admin-only manual snapshot (re)build, e.g. after a settings change. */
export const POST: RequestHandler = async ({ request, locals }) => {
if (!isAdmin(locals.user?.email)) {
return json({ error: 'Forbidden' }, { status: 403 });
}
let body: { date?: string; mature?: boolean } = {};
try {
body = await request.json();
} catch {
/* fall through to validation */
}
const date = body.date;
if (!date || !isValidDate(date)) {
return json({ error: 'A valid date (YYYY-MM-DD) is required' }, { status: 400 });
}
const { snapshot } = await buildSnapshot(date, {
kind: 'reconstructed',
replace: true
});
return json({ ok: true, date, buildKind: snapshot.buildKind, generatedAt: snapshot.generatedAt });
};
+26
View File
@@ -0,0 +1,26 @@
import { json } from '@sveltejs/kit';
import type { RequestHandler } from './$types';
import { bibleBooks } from '$lib/server/bible';
import { getChapterCount, getVerseCount } from '$lib/server/xml-bible';
// Static Bible structure for the cascading Book → Chapter → Verse selectors.
// ~1189 chapter entries total; safe to cache indefinitely.
let cached: { bookId: string; chapters: number[] }[] | null = null;
function build(): { bookId: string; chapters: number[] }[] {
if (cached) return cached;
const out = bibleBooks.map((book) => {
const chapterCount = getChapterCount(book.order);
const chapters: number[] = new Array(chapterCount);
for (let c = 1; c <= chapterCount; c++) {
chapters[c - 1] = getVerseCount(book.order, c);
}
return { bookId: book.id, chapters };
});
cached = out;
return out;
}
export const GET: RequestHandler = async () => {
return json(build());
};
@@ -0,0 +1,31 @@
import { json } from '@sveltejs/kit';
import type { RequestHandler } from './$types';
import { addDays } from '$lib/server/stats/dates';
import { buildSnapshot } from '$lib/server/stats/snapshot';
import { sendDigest } from '$lib/server/stats/digest';
/**
* Daily snapshot build trigger. Protected by `Authorization: Bearer $CRON_SECRET`
* (same pattern as `/api/send-daily-verse`). Builds yesterday in `America/New_York`
* and then sends the digest.
*/
export const POST: RequestHandler = async ({ request }) => {
const cronSecret = Bun.env.CRON_SECRET;
const authHeader = request.headers.get('Authorization');
if (!cronSecret || authHeader !== `Bearer ${cronSecret}`) {
return json({ error: 'Unauthorized' }, { status: 401 });
}
const todayEst = new Date().toLocaleDateString('en-CA', { timeZone: 'America/New_York' });
const yesterday = addDays(todayEst, -1);
const { snapshot } = await buildSnapshot(yesterday, {
kind: 'scheduled',
replace: true
});
// Digest failure must never fail the build.
await sendDigest(snapshot.payload);
return json({ ok: true, date: yesterday, buildKind: 'scheduled' });
};
+15 -2
View File
@@ -2,10 +2,11 @@ import { json } from '@sveltejs/kit';
import type { RequestHandler } from './$types'; import type { RequestHandler } from './$types';
import { getVerseForDate } from '$lib/server/daily-verse'; import { getVerseForDate } from '$lib/server/daily-verse';
import { getBookById } from '$lib/server/bible'; import { getBookById } from '$lib/server/bible';
import { recordEvent } from '$lib/server/stats/events';
export const POST: RequestHandler = async ({ request }) => { export const POST: RequestHandler = async ({ request, locals }) => {
const body = await request.json(); const body = await request.json();
const { date } = body; const { date, anonymousId } = body;
if (!date || !/^\d{4}-\d{2}-\d{2}$/.test(date)) { if (!date || !/^\d{4}-\d{2}-\d{2}$/.test(date)) {
return json({ error: 'A valid date (YYYY-MM-DD) is required' }, { status: 400 }); return json({ error: 'A valid date (YYYY-MM-DD) is required' }, { status: 400 });
@@ -16,6 +17,18 @@ export const POST: RequestHandler = async ({ request }) => {
const dailyVerse = await getVerseForDate(dateStr); const dailyVerse = await getVerseForDate(dateStr);
const correctBook = getBookById(dailyVerse.bookId) ?? null; const correctBook = getBookById(dailyVerse.bookId) ?? null;
// Instrumentation B: a player "started" the puzzle for this date. The unique
// partial index dedupes reloads, so this is safe to call on every load.
// Never let analytics failures affect the response.
// Prefer the signed-in user's ID so the started→finished funnel matches
// completions (which are keyed to the user ID for logged-in players).
const playerId =
locals.user?.id ??
(typeof anonymousId === 'string' && anonymousId.length > 0 ? anonymousId : null);
if (playerId) {
void recordEvent({ name: 'verse_served', anonymousId: playerId, date: dateStr });
}
return json({ return json({
dailyVerse, dailyVerse,
correctBookId: dailyVerse.bookId, correctBookId: dailyVerse.bookId,
@@ -0,0 +1,189 @@
import type { RequestHandler } from './$types';
import { db } from '$lib/server/db';
import { dailyVerses, verseSubmissions, user } from '$lib/server/db/schema';
import { sql } from 'drizzle-orm';
import { json } from '@sveltejs/kit';
import { bibleBooks } from '$lib/types/bible';
import {
getChapterCount,
getVerseCount,
composeVerseWindow,
formatWindowReference
} from '$lib/server/xml-bible';
const DEV_HOSTS = ['localhost:5173', 'test.bibdle.com'];
const MAX_SCAN_RETRIES = 5;
// Dev-only: insert a verse_submissions row (from a random existing account) +
// its corresponding daily_verses row, scheduled on the earliest valid future
// date per the spec's scheduling rules. Lets you populate /scheduled-verses to
// verify the admin view without going through the (Step 5+) submit API.
export const POST: RequestHandler = async ({ request }) => {
const host = request.headers.get('host') ?? '';
if (!DEV_HOSTS.includes(host)) {
return json({ error: 'Not allowed in production' }, { status: 403 });
}
// Pick a random existing user.
const users = await db.select().from(user);
if (users.length === 0) {
return json(
{ error: 'No users exist yet. Sign up at least one account first.' },
{ status: 400 }
);
}
const submitter = users[Math.floor(Math.random() * users.length)];
// Pick a random valid (book, chapter, verse).
const book = bibleBooks[Math.floor(Math.random() * bibleBooks.length)];
const chapterCount = getChapterCount(book.order);
const chapter = Math.floor(Math.random() * chapterCount) + 1;
const verseCount = getVerseCount(book.order, chapter);
const verse = Math.floor(Math.random() * verseCount) + 1;
const window = composeVerseWindow(book.order, chapter, verse);
if (!window) {
return json({ error: 'Failed to compose verse window' }, { status: 500 });
}
const reference = formatWindowReference(
window.bookName,
window.startChapter,
window.startVerse,
window.endChapter,
window.endVerse
);
const verseText = window.verses.join(' ');
const todayUtc = new Date().toISOString().slice(0, 10);
const tomorrowMs = new Date(todayUtc + 'T00:00:00Z').getTime() + 86400000;
function addDays(ms: number, n: number): string {
return new Date(ms + n * 86400000).toISOString().slice(0, 10);
}
// Fetch all future daily_verses into memory (date → bookId, date → reference).
const future = await db.select().from(dailyVerses).where(sql`date > ${todayUtc}`);
const byDate = new Map<string, { bookId: string; reference: string }>();
for (const r of future) byDate.set(r.date, { bookId: r.bookId, reference: r.reference });
// For the 60-day repeat rule, also need a bounded historical lookup per
// candidate date. Build a set of all existing references globally to do a
// cheap pre-check, then a precise range query when we settle on a date.
const allRows = await db.select().from(dailyVerses);
const refDates = new Map<string, string[]>(); // reference → list of dates
for (const r of allRows) {
const arr = refDates.get(r.reference) ?? [];
arr.push(r.date);
refDates.set(r.reference, arr);
}
let scheduledDate: string | null = null;
for (let attempt = 0; attempt < MAX_SCAN_RETRIES && !scheduledDate; attempt++) {
// Walk day-by-day from tomorrow.
for (let offset = 0; offset < 10000; offset++) {
const D = addDays(tomorrowMs, offset);
// Rule 1: empty (no committed daily_verses row).
if (byDate.has(D)) continue;
// Rule 2: no back-to-back with prior neighbor.
const prev = byDate.get(addDays(tomorrowMs, offset - 1));
if (prev && prev.bookId === book.id) continue;
// Rule 3: no back-to-back with next committed neighbor.
const next = byDate.get(addDays(tomorrowMs, offset + 1));
if (next && next.bookId === book.id) continue;
// Rule 4: 60-day repeat distance — no same reference within ±60 days.
const sameRefDates = refDates.get(reference) ?? [];
const dMs = new Date(D + 'T00:00:00Z').getTime();
const tooClose = sameRefDates.some((d) => {
const diff = Math.abs(new Date(d + 'T00:00:00Z').getTime() - dMs);
return diff <= 60 * 86400000;
});
if (tooClose) continue;
scheduledDate = D;
break;
}
if (!scheduledDate) break; // exhausted retries
}
if (!scheduledDate) {
return json({ error: 'Could not find a valid future date' }, { status: 500 });
}
// Insert both rows in a transaction. On a unique conflict (concurrent
// submission grabbed the same date), bubble up so the caller can retry.
const now = Date.now();
const verseId = Bun.randomUUIDv7();
const submissionId = Bun.randomUUIDv7();
try {
db.transaction((tx) => {
tx.insert(dailyVerses)
.values({
id: verseId,
date: scheduledDate!,
bookId: book.id,
verseText,
reference,
createdAt: sql`${Math.floor(now / 1000)}`
})
.run();
tx.insert(verseSubmissions)
.values({
id: submissionId,
userId: submitter.id,
scheduledDate: scheduledDate!,
selectedBookId: book.id,
selectedChapter: chapter,
selectedVerse: verse,
submittedAt: now
})
.run();
});
} catch (err: any) {
if (err?.code === 'SQLITE_CONSTRAINT_UNIQUE' || err?.message?.includes('UNIQUE')) {
return json(
{ error: 'Date collision during seed; retry the request', detail: String(err?.message ?? err) },
{ status: 409 }
);
}
throw err;
}
return json({
ok: true,
submitter: { id: submitter.id, email: submitter.email },
selected: {
bookId: book.id,
bookName: book.name,
chapter,
verse
},
scheduledDate,
reference,
verseText
});
};
// Convenience: GET returns the current count of submissions + future scheduled
// verses, useful as a quick dev sanity check without mutating state.
export const GET: RequestHandler = async ({ request }) => {
const host = request.headers.get('host') ?? '';
if (!DEV_HOSTS.includes(host)) {
return json({ error: 'Not allowed in production' }, { status: 403 });
}
const subs = await db.select().from(verseSubmissions);
const future = await db
.select()
.from(dailyVerses)
.where(sql`date > ${new Date().toISOString().slice(0, 10)}`);
return json({
totalSubmissions: subs.length,
futureScheduledVerses: future.length
});
};
+52
View File
@@ -0,0 +1,52 @@
import { json } from '@sveltejs/kit';
import type { RequestHandler } from './$types';
import { isEventName, recordEvent, encodeMetadata } from '$lib/server/stats/events';
const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
/**
* Fire-and-forget client analytics sink.
*
* Body: `{ name, anonymousId?, date?, metadata? }`.
* `userId` is resolved server-side from the session — never trusted from the client.
* Always returns 204, even for invalid input, so gameplay is never blocked.
*/
export const POST: RequestHandler = async ({ request, locals }) => {
let body: any;
try {
body = await request.json();
} catch {
return new Response(null, { status: 204 });
}
const name = typeof body?.name === 'string' ? body.name : '';
if (!isEventName(name)) {
return new Response(null, { status: 204 });
}
const anonymousId =
typeof body?.anonymousId === 'string' && body.anonymousId.length > 0
? body.anonymousId.slice(0, 128)
: null;
const date =
typeof body?.date === 'string' && DATE_RE.test(body.date) ? body.date : null;
const metadata =
body?.metadata && typeof body.metadata === 'object' && !Array.isArray(body.metadata)
? (body.metadata as Record<string, unknown>)
: null;
// Ensure metadata is always serializable/capped before it reaches the DB.
void encodeMetadata(metadata);
await recordEvent({
name,
anonymousId,
userId: locals.user?.id ?? null,
date,
metadata
});
return new Response(null, { status: 204 });
};
@@ -0,0 +1,42 @@
import { json } from '@sveltejs/kit';
import type { RequestHandler } from './$types';
import { getVerseForDate } from '$lib/server/daily-verse';
export const POST: RequestHandler = async ({ request }) => {
const cronSecret = Bun.env.CRON_SECRET;
const discordWebhook = Bun.env.DISCORD_DAILY_WEBHOOK;
const authHeader = request.headers.get('Authorization');
if (!authHeader || !cronSecret || authHeader !== `Bearer ${cronSecret}`) {
return json({ error: 'Unauthorized' }, { status: 401 });
}
const dateStr = new Date().toLocaleDateString('en-CA', { timeZone: 'America/New_York' });
const verse = await getVerseForDate(dateStr);
const fullDate = new Date(dateStr + 'T00:00:00Z').toLocaleDateString('en-US', {
year: 'numeric',
month: 'long',
day: 'numeric',
timeZone: 'UTC',
});
const message = `*${fullDate}*\n**"${verse.verseText}"**`;
if (!discordWebhook) {
return json({ error: 'Discord webhook not configured' }, { status: 500 });
}
const discordResponse = await fetch(discordWebhook, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ content: message }),
});
if (!discordResponse.ok) {
return json({ error: 'Failed to post to Discord' }, { status: 500 });
}
return json({ ok: true });
};
+89
View File
@@ -0,0 +1,89 @@
import { json } from '@sveltejs/kit';
import type { RequestHandler } from './$types';
import { db } from '$lib/server/db';
import { dailyCompletions } from '$lib/server/db/schema';
import { eq, and } from 'drizzle-orm';
import {
scheduleSubmission,
validateSelection,
getCooldownState
} from '$lib/server/verse-submission';
/**
* POST /api/submit-verse
*
* Accepts a user-chosen verse (bookId/chapter/verse) and reserves a concrete
* future date for it via the scheduling scan. Auth required, solved-today gate,
* 7-day rolling cooldown, and structural validation all enforced here.
*
* Body: { bookId, chapter, verse, localDate }
*/
export const POST: RequestHandler = async ({ request, locals }) => {
// 1. Auth.
if (!locals.user) {
return json({ error: 'Unauthorized' }, { status: 401 });
}
const userId = locals.user.id;
let body: any;
try {
body = await request.json();
} catch {
return json({ error: 'Invalid JSON body' }, { status: 400 });
}
const { bookId, chapter, verse, localDate } = body ?? {};
// 2. Solved-today gate (engagement gate, not security).
if (typeof localDate !== 'string' || !/^\d{4}-\d{2}-\d{2}$/.test(localDate)) {
return json({ error: 'A valid localDate (YYYY-MM-DD) is required' }, { status: 400 });
}
const [completion] = await db
.select({ id: dailyCompletions.id })
.from(dailyCompletions)
.where(
and(
eq(dailyCompletions.anonymousId, userId),
eq(dailyCompletions.date, localDate)
)
)
.limit(1);
if (!completion) {
return json({ error: "Solve today's puzzle first" }, { status: 403 });
}
// 3. Cooldown (rolling 7×24h, server UTC).
const cooldown = await getCooldownState(db, userId);
if (cooldown.onCooldown) {
return json(
{ error: 'Cooldown active', cooldownEndsAt: cooldown.cooldownEndsAt },
{ status: 429 }
);
}
// 4. Structural validation.
const validationError = validateSelection({ bookId, chapter, verse });
if (validationError) {
return json({ error: validationError }, { status: 400 });
}
// 5–7. Compute window + scheduling scan + transactional insert (with retry).
try {
const result = await scheduleSubmission(
db,
{ bookId, chapter, verse },
userId
);
return json(
{
scheduledDate: result.scheduledDate,
reference: result.reference,
windowText: result.windowText
},
{ status: 201 }
);
} catch (err) {
console.error('submit-verse failed:', err);
return json({ error: 'Failed to schedule submission' }, { status: 500 });
}
};
@@ -0,0 +1,69 @@
import { json } from '@sveltejs/kit';
import type { RequestHandler } from './$types';
import { db } from '$lib/server/db';
import { verseSubmissions, dailyVerses } from '$lib/server/db/schema';
import { eq, desc, asc } from 'drizzle-orm';
import { getCooldownState, todayUtcStr } from '$lib/server/verse-submission';
/**
* GET /api/submit-verse/status?localDate=YYYY-MM-DD
*
* Returns the state needed to render the win-screen submit button:
* whether the user can submit, the active cooldown (if any), their most
* recent submission, and their not-yet-reached upcoming submissions.
*/
export const GET: RequestHandler = async ({ locals }) => {
if (!locals.user) {
return json({ error: 'Unauthorized' }, { status: 401 });
}
const userId = locals.user.id;
const cooldown = await getCooldownState(db, userId);
// Most recent submission (by submitted_at) — joined to daily_verses for the
// canonical reference/window text that will actually play on its day.
const [lastRow] = await db
.select({
scheduledDate: verseSubmissions.scheduledDate,
reference: dailyVerses.reference
})
.from(verseSubmissions)
.leftJoin(dailyVerses, eq(verseSubmissions.scheduledDate, dailyVerses.date))
.where(eq(verseSubmissions.userId, userId))
.orderBy(desc(verseSubmissions.submittedAt))
.limit(1);
const lastSubmission = lastRow
? {
scheduledDate: lastRow.scheduledDate,
reference: lastRow.reference
}
: null;
// Upcoming = this user's submissions whose scheduled date hasn't been
// reached yet (server UTC today).
const today = todayUtcStr();
const upcomingRows = await db
.select({
scheduledDate: verseSubmissions.scheduledDate,
reference: dailyVerses.reference
})
.from(verseSubmissions)
.leftJoin(dailyVerses, eq(verseSubmissions.scheduledDate, dailyVerses.date))
.where(eq(verseSubmissions.userId, userId))
.orderBy(asc(verseSubmissions.scheduledDate));
const upcoming = upcomingRows
.filter((r) => r.scheduledDate > today)
.map((r) => ({
scheduledDate: r.scheduledDate,
reference: r.reference
}));
return json({
canSubmit: !cooldown.onCooldown,
cooldownEndsAt: cooldown.cooldownEndsAt,
lastSubmission,
upcoming
});
};
+51
View File
@@ -0,0 +1,51 @@
import { json } from '@sveltejs/kit';
import type { RequestHandler } from './$types';
import { getBookById } from '$lib/server/bible';
import {
composeVerseWindow,
formatWindowReference
} from '$lib/server/xml-bible';
// Live 3-verse preview for the submission selector. Computes the fall-forward
// window anchored on the selected verse (spec: "Verse Windowing").
export const GET: RequestHandler = async ({ url }) => {
const bookId = url.searchParams.get('bookId');
const chapterParam = url.searchParams.get('chapter');
const verseParam = url.searchParams.get('verse');
if (!bookId || !chapterParam || !verseParam) {
return json({ error: 'bookId, chapter, and verse are required' }, { status: 400 });
}
const book = getBookById(bookId);
if (!book) {
return json({ error: 'Unknown bookId' }, { status: 400 });
}
const chapter = Number(chapterParam);
const verse = Number(verseParam);
if (!Number.isInteger(chapter) || !Number.isInteger(verse) || chapter < 1 || verse < 1) {
return json({ error: 'chapter and verse must be positive integers' }, { status: 400 });
}
const window = composeVerseWindow(book.order, chapter, verse);
if (!window) {
// chapter/verse out of range — caught by composeVerseWindow's bounds checks
return json({ error: 'chapter or verse out of range for this book' }, { status: 400 });
}
const reference = formatWindowReference(
window.bookName,
window.startChapter,
window.startVerse,
window.endChapter,
window.endVerse
);
return json({
windowVerses: window.verses,
reference,
bookId: window.bookId,
selectedVerse: window.selectedVerse
});
};
+1 -1
View File
@@ -131,7 +131,7 @@ export const POST: RequestHandler = async ({ request, cookies }) => {
// Create session // Create session
const sessionToken = auth.generateSessionToken(); const sessionToken = auth.generateSessionToken();
const session = await auth.createSession(sessionToken, userId); const session = await auth.createSession(sessionToken, userId);
auth.setSessionTokenCookie({ cookies } as any, sessionToken, session.expiresAt); auth.setSessionTokenCookie({ cookies }, sessionToken, session.expiresAt);
redirect(302, '/'); redirect(302, '/');
}; };
+26
View File
@@ -0,0 +1,26 @@
import { redirect } from '@sveltejs/kit';
import type { Actions } from './$types';
import { getGoogleAuthUrl } from '$lib/server/google-auth';
export const actions: Actions = {
default: async ({ cookies, request }) => {
const data = await request.formData();
const anonymousId = data.get('anonymousId')?.toString() || '';
// Generate CSRF state
const stateBytes = crypto.getRandomValues(new Uint8Array(16));
const state = Buffer.from(stateBytes).toString('base64url');
// sameSite 'lax' is safe here because Google sends a GET redirect back
// (unlike Apple which POSTs cross-origin, requiring 'none')
cookies.set('google_oauth_state', JSON.stringify({ state, anonymousId }), {
path: '/',
httpOnly: true,
secure: true,
sameSite: 'lax',
maxAge: 600
});
redirect(302, getGoogleAuthUrl(state));
}
};
+131
View File
@@ -0,0 +1,131 @@
import { redirect, error } from '@sveltejs/kit';
import type { RequestHandler } from './$types';
import { exchangeGoogleCode, decodeGoogleIdToken } from '$lib/server/google-auth';
import * as auth from '$lib/server/auth';
import { db } from '$lib/server/db';
import { user as userTable } from '$lib/server/db/schema';
import { eq } from 'drizzle-orm';
export const GET: RequestHandler = async ({ url, cookies }) => {
const code = url.searchParams.get('code');
const state = url.searchParams.get('state');
const errorParam = url.searchParams.get('error');
// User denied access
if (errorParam) {
redirect(302, '/');
}
const storedRaw = cookies.get('google_oauth_state');
if (!storedRaw || !state || !code) {
throw error(400, 'Invalid OAuth callback');
}
const stored = JSON.parse(storedRaw) as { state: string; anonymousId: string };
if (stored.state !== state) {
throw error(400, 'State mismatch');
}
cookies.delete('google_oauth_state', { path: '/' });
const anonId = stored.anonymousId;
if (!anonId) {
console.error('[Google auth] Missing anonymousId in state cookie');
throw error(400, 'Missing anonymous ID — please return to the game and try again');
}
// Exchange authorization code for tokens
const tokens = await exchangeGoogleCode(
code,
`${Bun.env.PUBLIC_SITE_URL}/auth/google/callback`
);
const claims = decodeGoogleIdToken(tokens.id_token);
const googleId = claims.sub;
// --- User resolution ---
let userId: string;
// 1. Check if a user with this googleId already exists (returning user)
const existingGoogleUser = await auth.getUserByGoogleId(googleId);
if (existingGoogleUser) {
userId = existingGoogleUser.id;
console.log(`[Google auth] Returning Google user: userId=${userId}, anonId=${anonId}`);
await auth.migrateAnonymousStats(anonId, userId);
} else if (claims.email) {
// 2. Check if email matches an existing email/password or Apple user
const existingEmailUser = await auth.getUserByEmail(claims.email);
if (existingEmailUser) {
// Link Google account to existing user
await db.update(userTable).set({ googleId }).where(eq(userTable.id, existingEmailUser.id));
userId = existingEmailUser.id;
console.log(`[Google auth] Linked Google to existing email user: userId=${userId}, anonId=${anonId}`);
await auth.migrateAnonymousStats(anonId, userId);
} else {
// 3. Brand new user — use anonymousId as user ID to preserve local stats
userId = anonId;
console.log(`[Google auth] New user (has email): userId=${userId}`);
try {
await db.insert(userTable).values({
id: userId,
email: claims.email,
passwordHash: null,
appleId: null,
googleId,
firstName: claims.given_name || null,
lastName: claims.family_name || null,
isPrivate: false
});
} catch (e: any) {
// Handle race condition: if googleId was inserted between our check and insert
if (e?.message?.includes('UNIQUE constraint')) {
const retryUser = await auth.getUserByGoogleId(googleId);
if (retryUser) {
userId = retryUser.id;
console.log(`[Google auth] Race condition (has email): resolved to userId=${userId}, anonId=${anonId}`);
await auth.migrateAnonymousStats(anonId, userId);
} else {
throw error(500, 'Failed to create user');
}
} else {
throw e;
}
}
}
} else {
// No email from Google (edge case — Google almost always returns email)
userId = anonId;
console.log(`[Google auth] New user (no email): userId=${userId}`);
try {
await db.insert(userTable).values({
id: userId,
email: null,
passwordHash: null,
appleId: null,
googleId,
firstName: claims.given_name || null,
lastName: claims.family_name || null,
isPrivate: false
});
} catch (e: any) {
if (e?.message?.includes('UNIQUE constraint')) {
const retryUser = await auth.getUserByGoogleId(googleId);
if (retryUser) {
userId = retryUser.id;
console.log(`[Google auth] Race condition (no email): resolved to userId=${userId}, anonId=${anonId}`);
await auth.migrateAnonymousStats(anonId, userId);
} else {
throw error(500, 'Failed to create user');
}
} else {
throw e;
}
}
}
// Create session
const sessionToken = auth.generateSessionToken();
const session = await auth.createSession(sessionToken, userId);
auth.setSessionTokenCookie({ cookies }, sessionToken, session.expiresAt);
redirect(302, '/');
};
+69 -102
View File
@@ -1,133 +1,99 @@
import type { RequestHandler } from './$types'; import type { RequestHandler } from './$types';
import { db } from '$lib/server/db'; import { db } from '$lib/server/db';
import { dailyVerses } from '$lib/server/db/schema'; import { dailyVerses } from '$lib/server/db/schema';
import { desc } from 'drizzle-orm'; import { desc, lte } from 'drizzle-orm';
import {
// Helper: Escape XML special characters FEED_ITEM_LIMIT,
function escapeXml(text: string): string { cdata,
return text escapeXml,
.replace(/&/g, '&amp;') feedFingerprint,
.replace(/</g, '&lt;') formatRFC822,
.replace(/>/g, '&gt;') formatReadableDate,
.replace(/"/g, '&quot;') formatVerseText,
.replace(/'/g, '&apos;'); latestModification,
} todayInTimeZone
} from '$lib/server/rss';
// Helper: Format YYYY-MM-DD to RFC 822 date string
function formatRFC822(dateStr: string): string {
// Parse date in America/New_York timezone (EST/EDT)
// Assuming midnight ET
const date = new Date(dateStr + 'T00:00:00-05:00');
return date.toUTCString().replace('GMT', 'EST');
}
// Helper: Format YYYY-MM-DD to readable date
function formatReadableDate(dateStr: string): string {
const date = new Date(dateStr + 'T00:00:00');
return date.toLocaleDateString('en-US', {
month: 'long',
day: 'numeric',
year: 'numeric',
timeZone: 'America/New_York'
});
}
// Helper: Format verse text (VerseDisplay + Imposter unbalanced punctuation handling)
function formatVerseText(text: string): string {
let formatted = text;
// Handle unbalanced opening/closing punctuation (from Imposter.svelte)
const pairs: [string, string][] = [
['(', ')'],
['[', ']'],
['{', '}'],
['"', '"'],
["'", "'"],
['\u201C', '\u201D'], // " "
['\u2018', '\u2019'] // ' '
];
// Check if text starts with opening punctuation without closing
for (const [open, close] of pairs) {
if (formatted.startsWith(open) && !formatted.includes(close)) {
formatted += '...' + close;
break;
}
}
// Check if text ends with closing punctuation without opening
for (const [open, close] of pairs) {
if (formatted.endsWith(close) && !formatted.includes(open)) {
formatted = open + '...' + formatted;
break;
}
}
// Check if text contains unbalanced opening quotes (not at start) without closing
for (const [open, close] of pairs) {
const openCount = (formatted.match(new RegExp(`\\${open}`, 'g')) || []).length;
const closeCount = (formatted.match(new RegExp(`\\${close}`, 'g')) || []).length;
if (openCount > closeCount) {
formatted += close;
break;
}
}
// Capitalize first letter if lowercase (from VerseDisplay.svelte)
formatted = formatted.replace(/^([a-z])/, (c) => c.toUpperCase());
// Replace trailing punctuation with ellipsis
// Preserve closing quotes/brackets that may have been added
formatted = formatted.replace(/[,:;-—]([)\]}\"\'\u201D\u2019]*)$/, '...$1');
return formatted;
}
export const GET: RequestHandler = async ({ request }) => { export const GET: RequestHandler = async ({ request }) => {
try { try {
// Query last 30 verses, ordered by date descending const SITE_URL = process.env.PUBLIC_SITE_URL || 'https://bibdle.com';
const FEED_URL = `${SITE_URL}/feed.xml`;
const today = todayInTimeZone();
// Only publish verses whose calendar day has arrived. Pre-scheduled
// future verses (from the submission scheduling scan) and any stray
// future-dated rows must never leak into the feed early.
const verses = await db const verses = await db
.select() .select()
.from(dailyVerses) .from(dailyVerses)
.where(lte(dailyVerses.date, today))
.orderBy(desc(dailyVerses.date)) .orderBy(desc(dailyVerses.date))
.limit(30); .limit(FEED_ITEM_LIMIT);
// Generate ETag based on latest verse date // Content-addressed ETag + Last-Modified let aggregators revalidate
const etag = verses[0]?.date ? `"bibdle-feed-${verses[0].date}"` : '"bibdle-feed-empty"'; // cheaply with If-None-Match / If-Modified-Since.
const etag = `"bibdle-feed-${feedFingerprint(verses)}"`;
const lastModifiedDate = latestModification(
verses,
new Date(`${today}T00:00:00Z`)
);
const lastModified = lastModifiedDate.toUTCString();
// Check if client has cached version const notModified =
if (request.headers.get('If-None-Match') === etag) { request.headers.get('If-None-Match') === etag ||
return new Response(null, { status: 304 }); (() => {
const since = request.headers.get('If-Modified-Since');
if (!since) return false;
const sinceMs = Date.parse(since);
return !Number.isNaN(sinceMs) && lastModifiedDate.getTime() <= sinceMs;
})();
if (notModified) {
return new Response(null, {
status: 304,
headers: {
ETag: etag,
'Last-Modified': lastModified,
'Cache-Control': 'public, max-age=3600, s-maxage=3600'
}
});
} }
// Get site URL from environment or use default
const SITE_URL = process.env.PUBLIC_SITE_URL || 'https://bibdle.com';
// Build RSS XML
const lastBuildDate = verses[0] ? formatRFC822(verses[0].date) : new Date().toUTCString(); const lastBuildDate = verses[0] ? formatRFC822(verses[0].date) : new Date().toUTCString();
const items = verses const items = verses
.map( .map((verse) => {
(verse) => ` const body = formatVerseText(verse.verseText);
const escaped = escapeXml(body);
return `
<item> <item>
<title>Bibdle verse for ${formatReadableDate(verse.date)}</title> <title>Bibdle verse for ${formatReadableDate(verse.date)}</title>
<description>${escapeXml(formatVerseText(verse.verseText))}</description> <description>${escaped}</description>
<content:encoded>${cdata(`<p>${escaped}</p>`)}</content:encoded>
<link>${SITE_URL}</link> <link>${SITE_URL}</link>
<guid isPermaLink="false">bibdle-verse-${verse.date}</guid> <guid isPermaLink="false">bibdle-verse-${verse.date}</guid>
<pubDate>${formatRFC822(verse.date)}</pubDate> <pubDate>${formatRFC822(verse.date)}</pubDate>
</item>` </item>`;
) })
.join(''); .join('');
const xml = `<?xml version="1.0" encoding="UTF-8" ?> const xml = `<?xml version="1.0" encoding="UTF-8" ?>
<rss version="2.0"> <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
<channel> <channel>
<title>Bibdle</title> <title>Bibdle</title>
<link>${SITE_URL}</link> <link>${SITE_URL}</link>
<description>A daily Bible game</description> <description>A daily Bible verse guessing game</description>
<language>en-us</language> <language>en-us</language>
<lastBuildDate>${lastBuildDate}</lastBuildDate> <lastBuildDate>${lastBuildDate}</lastBuildDate>
<ttl>720</ttl>${items} <pubDate>${lastBuildDate}</pubDate>
<generator>SvelteKit</generator>
<ttl>720</ttl>
<atom:link href="${escapeXml(FEED_URL)}" rel="self" type="application/rss+xml" />
<image>
<url>${SITE_URL}/favicon.ico</url>
<title>Bibdle</title>
<link>${SITE_URL}</link>
</image>${items}
</channel> </channel>
</rss>`; </rss>`;
@@ -135,11 +101,12 @@ export const GET: RequestHandler = async ({ request }) => {
headers: { headers: {
'Content-Type': 'application/rss+xml; charset=utf-8', 'Content-Type': 'application/rss+xml; charset=utf-8',
'Cache-Control': 'public, max-age=3600, s-maxage=3600', 'Cache-Control': 'public, max-age=3600, s-maxage=3600',
ETag: etag ETag: etag,
'Last-Modified': lastModified
} }
}); });
} catch (error) { } catch (error) {
console.error('RSS feed generation error:', error); console.error('RSS feed generation error:', error);
return new Response('Internal Server Error', { status: 500 }); return new Response('Internal Server Error', { status: 500 });
} }
}; }
+25
View File
@@ -0,0 +1,25 @@
import type { PageServerLoad } from './$types';
import { ensureSnapshot } from '$lib/server/stats/snapshot';
import { addDays } from '$lib/server/stats/dates';
/**
* Slim public community widget. Reads the latest daily snapshot and exposes
* only safe aggregates (no retention, churn, signup or revenue data).
*/
export const load: PageServerLoad = async () => {
const todayEst = new Date().toLocaleDateString('en-CA', { timeZone: 'America/New_York' });
const yesterday = addDays(todayEst, -1);
const snapshot = await ensureSnapshot(yesterday);
const payload = snapshot.payload;
return {
asOfDate: payload.asOfDate,
completions: payload.totals.completions,
players: payload.totals.players,
weeklyPlayers: payload.activity.wau,
monthlyPlayers: payload.activity.mau,
yesterdayCompletions: payload.totals.yesterdayCompletions,
yesterdayAvgGuesses: payload.totals.yesterdayAvgGuesses,
calendar: payload.habit.calendar.slice(-30)
};
};
+56
View File
@@ -0,0 +1,56 @@
<script lang="ts">
import type { PageData } from './$types';
import Container from '$lib/components/Container.svelte';
import CalendarHeatmap from '$lib/components/charts/CalendarHeatmap.svelte';
import { formatDateLabel, numOrDash } from '$lib/utils/stats-format';
let { data }: { data: PageData } = $props();
</script>
<svelte:head>
<title>Community Stats | Bibdle</title>
<meta name="description" content="Bibdle community statistics, as of yesterday." />
</svelte:head>
<div class="mx-auto max-w-3xl px-4 py-8">
<div class="mb-6 text-center">
<h1 class="text-3xl font-bold text-gray-900 dark:text-gray-100">Community Stats</h1>
<p class="mt-1 text-sm text-gray-600 dark:text-gray-400">As of {formatDateLabel(data.asOfDate)}</p>
</div>
<div class="grid grid-cols-2 gap-3 md:grid-cols-3">
<Container class="p-4 w-full items-start text-left">
<p class="text-[11px] font-semibold uppercase tracking-wider text-gray-600 dark:text-gray-400">All-time finishes</p>
<p class="text-2xl font-bold text-gray-900 dark:text-gray-100">{numOrDash(data.completions)}</p>
</Container>
<Container class="p-4 w-full items-start text-left">
<p class="text-[11px] font-semibold uppercase tracking-wider text-gray-600 dark:text-gray-400">All-time players</p>
<p class="text-2xl font-bold text-gray-900 dark:text-gray-100">{numOrDash(data.players)}</p>
</Container>
<Container class="p-4 w-full items-start text-left">
<p class="text-[11px] font-semibold uppercase tracking-wider text-gray-600 dark:text-gray-400">Players this week</p>
<p class="text-2xl font-bold text-gray-900 dark:text-gray-100">{numOrDash(data.weeklyPlayers)}</p>
</Container>
<Container class="p-4 w-full items-start text-left">
<p class="text-[11px] font-semibold uppercase tracking-wider text-gray-600 dark:text-gray-400">Players this month</p>
<p class="text-2xl font-bold text-gray-900 dark:text-gray-100">{numOrDash(data.monthlyPlayers)}</p>
</Container>
<Container class="p-4 w-full items-start text-left">
<p class="text-[11px] font-semibold uppercase tracking-wider text-gray-600 dark:text-gray-400">Yesterday's finishes</p>
<p class="text-2xl font-bold text-gray-900 dark:text-gray-100">{numOrDash(data.yesterdayCompletions)}</p>
</Container>
<Container class="p-4 w-full items-start text-left">
<p class="text-[11px] font-semibold uppercase tracking-wider text-gray-600 dark:text-gray-400">Avg guesses yesterday</p>
<p class="text-2xl font-bold text-gray-900 dark:text-gray-100">{numOrDash(data.yesterdayAvgGuesses)}</p>
</Container>
</div>
<Container class="mt-3 p-4 w-full items-stretch text-left gap-2">
<p class="font-semibold text-gray-900 dark:text-gray-100">Daily finishes (last 30 days)</p>
<CalendarHeatmap data={data.calendar} />
</Container>
<p class="mt-4 text-center text-xs text-gray-500 dark:text-gray-500">
Updated once a day from completed games. <a class="underline hover:text-gray-300" href="/">Play today's verse →</a>
</p>
</div>
+287
View File
@@ -0,0 +1,287 @@
import { db } from '$lib/server/db';
import { dailyCompletions, dailyVerses } from '$lib/server/db/schema';
import { eq, desc } from 'drizzle-orm';
import type { PageServerLoad } from './$types';
import { bibleBooks } from '$lib/types/bible';
import { calculateMilestones } from '$lib/server/milestones';
import type { Milestone } from '$lib/server/milestones';
export type BookTier = 'unseen' | 'explored' | 'mastered' | 'perfect';
export type BookGridEntry = {
bookId: string;
tier: BookTier;
avgGuesses: number | null;
count: number;
};
export type ChartPoint = {
label: string;
avgGuesses: number;
};
export type SectionStat = {
section: string;
avgGuesses: number;
count: number;
};
export type TestamentStat = {
avgGuesses: number;
count: number;
} | null;
export type { Milestone };
export type ProgressData = {
completions: Array<{ date: string; guessCount: number }>;
chartPoints: ChartPoint[];
bookGrid: BookGridEntry[];
sectionStats: SectionStat[];
testamentStats: { old: TestamentStat; new: TestamentStat };
totalSolves: number;
bestStreak: number;
currentStreak: number;
booksExplored: number;
booksMastered: number;
booksPerfect: number;
bestSingleGame: { date: string; bookName: string } | null;
totalWords: number;
streakMilestones: { days7: string | null; days14: string | null; days30: string | null };
milestones: Milestone[];
};
export const load: PageServerLoad = async ({ locals }) => {
if (!locals.user) {
return {
progress: null,
requiresAuth: true,
user: null,
session: null,
};
}
const userId = locals.user.id;
try {
const completions = await db
.select()
.from(dailyCompletions)
.where(eq(dailyCompletions.anonymousId, userId))
.orderBy(desc(dailyCompletions.date));
if (completions.length === 0) {
return {
progress: {
completions: [],
chartPoints: [],
bookGrid: bibleBooks.map(b => ({ bookId: b.id, tier: 'unseen' as BookTier, avgGuesses: null, count: 0 })),
sectionStats: [],
testamentStats: { old: null, new: null },
totalSolves: 0,
bestStreak: 0,
currentStreak: 0,
booksExplored: 0,
booksMastered: 0,
booksPerfect: 0,
bestSingleGame: null,
totalWords: 0,
streakMilestones: { days7: null, days14: null, days30: null },
milestones: [],
} satisfies ProgressData,
requiresAuth: false,
user: locals.user,
session: locals.session,
};
}
// Map dates to book IDs and verse text via cached daily_verses
const allVerses = await db.select().from(dailyVerses);
const dateToBookId = new Map(allVerses.map(v => [v.date, v.bookId]));
const dateToVerseText = new Map(allVerses.map(v => [v.date, v.verseText]));
// Total words across all played verses
let totalWords = 0;
for (const c of completions) {
const verseText = dateToVerseText.get(c.date);
if (verseText) {
totalWords += verseText.trim().split(/\s+/).length;
}
}
// Per-book stats
const bookStatsMap = new Map<string, { count: number; totalGuesses: number; everGuessedIn1: boolean }>();
for (const c of completions) {
const bookId = dateToBookId.get(c.date);
if (!bookId) continue;
const existing = bookStatsMap.get(bookId) ?? { count: 0, totalGuesses: 0, everGuessedIn1: false };
bookStatsMap.set(bookId, {
count: existing.count + 1,
totalGuesses: existing.totalGuesses + c.guessCount,
everGuessedIn1: existing.everGuessedIn1 || c.guessCount === 1,
});
}
// Book grid (all 66 in canonical order)
const bookGrid: BookGridEntry[] = bibleBooks.map(book => {
const stats = bookStatsMap.get(book.id);
if (!stats) return { bookId: book.id, tier: 'unseen', avgGuesses: null, count: 0 };
const avgGuesses = stats.totalGuesses / stats.count;
let tier: BookTier = 'explored';
if (stats.count >= 2 && avgGuesses <= 3) {
tier = stats.everGuessedIn1 ? 'perfect' : 'mastered';
}
return { bookId: book.id, tier, avgGuesses: Math.round(avgGuesses * 10) / 10, count: stats.count };
});
// Section stats
const sectionMap = new Map<string, { totalGuesses: number; count: number }>();
for (const c of completions) {
const bookId = dateToBookId.get(c.date);
if (!bookId) continue;
const book = bibleBooks.find(b => b.id === bookId);
if (!book) continue;
const existing = sectionMap.get(book.section) ?? { totalGuesses: 0, count: 0 };
sectionMap.set(book.section, { totalGuesses: existing.totalGuesses + c.guessCount, count: existing.count + 1 });
}
const sectionStats: SectionStat[] = Array.from(sectionMap.entries())
.filter(([, s]) => s.count >= 3)
.map(([section, s]) => ({ section, avgGuesses: Math.round((s.totalGuesses / s.count) * 10) / 10, count: s.count }))
.sort((a, b) => a.avgGuesses - b.avgGuesses);
// Testament stats (only show if ≥5 games per testament)
let otTotal = 0, otCount = 0, ntTotal = 0, ntCount = 0;
for (const c of completions) {
const bookId = dateToBookId.get(c.date);
if (!bookId) continue;
const book = bibleBooks.find(b => b.id === bookId);
if (!book) continue;
if (book.testament === 'old') { otTotal += c.guessCount; otCount++; }
else { ntTotal += c.guessCount; ntCount++; }
}
const testamentStats = {
old: otCount >= 5 ? { avgGuesses: Math.round((otTotal / otCount) * 10) / 10, count: otCount } : null,
new: ntCount >= 5 ? { avgGuesses: Math.round((ntTotal / ntCount) * 10) / 10, count: ntCount } : null,
};
// Chart points — monthly averages sorted ascending
const sortedCompletions = [...completions].sort((a, b) => a.date.localeCompare(b.date));
const monthMap = new Map<string, { totalGuesses: number; count: number }>();
for (const c of sortedCompletions) {
const month = c.date.slice(0, 7); // YYYY-MM
const existing = monthMap.get(month) ?? { totalGuesses: 0, count: 0 };
monthMap.set(month, { totalGuesses: existing.totalGuesses + c.guessCount, count: existing.count + 1 });
}
let chartPoints: ChartPoint[] = Array.from(monthMap.entries())
.map(([label, m]) => ({ label, avgGuesses: Math.round((m.totalGuesses / m.count) * 10) / 10 }));
// Fall back to weekly if fewer than 3 months of data
if (chartPoints.length < 3 && sortedCompletions.length >= 5) {
const weekMap = new Map<string, { totalGuesses: number; count: number }>();
for (const c of sortedCompletions) {
const d = new Date(c.date + 'T00:00:00Z');
const year = d.getUTCFullYear();
const week = getISOWeek(d);
const key = `${year}-W${String(week).padStart(2, '0')}`;
const existing = weekMap.get(key) ?? { totalGuesses: 0, count: 0 };
weekMap.set(key, { totalGuesses: existing.totalGuesses + c.guessCount, count: existing.count + 1 });
}
chartPoints = Array.from(weekMap.entries())
.map(([label, m]) => ({ label, avgGuesses: Math.round((m.totalGuesses / m.count) * 10) / 10 }));
}
// Best streak (all-time) + streak milestones
const sortedDates = completions.map(c => c.date).sort();
let bestStreak = sortedDates.length > 0 ? 1 : 0;
let tempStreak = 1;
const streakMilestones: { days7: string | null; days14: string | null; days30: string | null } = { days7: null, days14: null, days30: null };
for (let i = 1; i < sortedDates.length; i++) {
const curr = new Date(sortedDates[i] + 'T00:00:00Z');
const prev = new Date(sortedDates[i - 1] + 'T00:00:00Z');
const diff = Math.round((curr.getTime() - prev.getTime()) / 86400000);
if (diff === 1) { tempStreak++; }
else { bestStreak = Math.max(bestStreak, tempStreak); tempStreak = 1; }
if (tempStreak >= 7 && !streakMilestones.days7) streakMilestones.days7 = sortedDates[i];
if (tempStreak >= 14 && !streakMilestones.days14) streakMilestones.days14 = sortedDates[i];
if (tempStreak >= 30 && !streakMilestones.days30) streakMilestones.days30 = sortedDates[i];
}
bestStreak = Math.max(bestStreak, tempStreak);
// Server-side current streak estimate (client overrides via /api/streak)
const userToday = new Date().toISOString().slice(0, 10);
const yesterday = new Date(new Date(userToday + 'T00:00:00Z').getTime() - 86400000).toISOString().slice(0, 10);
const lastDate = sortedDates[sortedDates.length - 1] ?? '';
let currentStreak = 0;
if (lastDate === userToday || lastDate === yesterday) {
currentStreak = 1;
for (let i = sortedDates.length - 2; i >= 0; i--) {
const curr = new Date(sortedDates[i + 1] + 'T00:00:00Z');
const prev = new Date(sortedDates[i] + 'T00:00:00Z');
const diff = Math.round((curr.getTime() - prev.getTime()) / 86400000);
if (diff === 1) currentStreak++;
else break;
}
}
// Milestone counts
const booksExplored = bookStatsMap.size;
const booksMastered = bookGrid.filter(b => b.tier === 'mastered' || b.tier === 'perfect').length;
const booksPerfect = bookGrid.filter(b => b.tier === 'perfect').length;
// Best single game (earliest 1-guess solve)
let bestSingleGame: { date: string; bookName: string } | null = null;
for (const c of sortedCompletions) {
if (c.guessCount === 1) {
const bookId = dateToBookId.get(c.date);
const book = bookId ? bibleBooks.find(b => b.id === bookId) : null;
if (book) {
bestSingleGame = { date: c.date, bookName: book.name };
break;
}
}
}
const milestones = await calculateMilestones(completions, dateToBookId, { bestSingleGame, streakMilestones });
return {
progress: {
completions: completions.map(c => ({ date: c.date, guessCount: c.guessCount })),
chartPoints,
bookGrid,
sectionStats,
testamentStats,
totalSolves: completions.length,
bestStreak,
currentStreak,
booksExplored,
booksMastered,
booksPerfect,
bestSingleGame,
totalWords,
streakMilestones,
milestones,
} satisfies ProgressData,
requiresAuth: false,
user: locals.user,
session: locals.session,
};
} catch (error) {
console.error('Error fetching progress data:', error);
return {
progress: null,
error: 'Failed to load progress data',
requiresAuth: false,
user: locals.user,
session: locals.session,
};
}
};
function getISOWeek(d: Date): number {
const date = new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
const dayNum = date.getUTCDay() || 7;
date.setUTCDate(date.getUTCDate() + 4 - dayNum);
const yearStart = new Date(Date.UTC(date.getUTCFullYear(), 0, 1));
return Math.ceil((((date.getTime() - yearStart.getTime()) / 86400000) + 1) / 7);
}
+627
View File
@@ -0,0 +1,627 @@
<script lang="ts">
import { browser } from "$app/environment";
import { onMount } from "svelte";
import AuthModal from "$lib/components/AuthModal.svelte";
import Container from "$lib/components/Container.svelte";
import ProgressStatCard from "$lib/components/ProgressStatCard.svelte";
import ActivityCalendar from "$lib/components/ActivityCalendar.svelte";
import { bibleBooks } from "$lib/types/bible";
type BookTier = "unseen" | "explored" | "mastered" | "perfect";
type BookGridEntry = {
bookId: string;
tier: BookTier;
avgGuesses: number | null;
count: number;
};
type ChartPoint = {
label: string;
avgGuesses: number;
};
type SectionStat = {
section: string;
avgGuesses: number;
count: number;
};
type Milestone = {
id: string;
name: string;
emoji: string;
description: string;
achieved: boolean;
achievedDate: string | null;
};
type ProgressData = {
completions: Array<{ date: string; guessCount: number }>;
chartPoints: ChartPoint[];
bookGrid: BookGridEntry[];
sectionStats: SectionStat[];
testamentStats: {
old: { avgGuesses: number; count: number } | null;
new: { avgGuesses: number; count: number } | null;
};
totalSolves: number;
bestStreak: number;
currentStreak: number;
booksExplored: number;
booksMastered: number;
booksPerfect: number;
bestSingleGame: { date: string; bookName: string } | null;
totalWords: number;
streakMilestones: {
days7: string | null;
days14: string | null;
days30: string | null;
};
milestones: Milestone[];
};
interface PageData {
progress: ProgressData | null;
error?: string;
user?: any;
session?: any;
requiresAuth?: boolean;
}
let { data }: { data: PageData } = $props();
let authModalOpen = $state(false);
let anonymousId = $state("");
function getOrCreateAnonymousId(): string {
if (!browser) return "";
const key = "bibdle-anonymous-id";
let id = localStorage.getItem(key);
if (!id) {
id = crypto.randomUUID();
localStorage.setItem(key, id);
}
return id;
}
function bookTileClass(tier: BookTier): string {
switch (tier) {
case "perfect":
return "bg-emerald-500 text-white";
case "mastered":
return "bg-purple-600 text-white";
case "explored":
return "bg-blue-700 text-blue-100";
default:
return "bg-gray-700/50 text-gray-500";
}
}
function formatDate(dateStr: string): string {
const d = new Date(dateStr + "T00:00:00Z");
return d.toLocaleDateString("en-US", {
month: "short",
day: "numeric",
year: "numeric",
timeZone: "UTC",
});
}
onMount(() => {
anonymousId = getOrCreateAnonymousId();
});
// Derived SVG chart values
const chartPoints = $derived(data.progress?.chartPoints ?? []);
const showChart = $derived(chartPoints.length >= 3);
const maxGuesses = $derived(
showChart ? Math.max(...chartPoints.map((p) => p.avgGuesses)) : 6,
);
const chartImproving = $derived(
showChart &&
chartPoints[chartPoints.length - 1].avgGuesses <
chartPoints[0].avgGuesses,
);
function svgX(index: number, total: number): number {
return (index / (total - 1)) * 360 + 20;
}
function svgY(avgGuesses: number, maxG: number): number {
return 100 - ((maxG - avgGuesses) / (maxG - 1)) * 90 + 10;
}
const polylinePoints = $derived(
showChart
? chartPoints
.map(
(p, i) =>
`${svgX(i, chartPoints.length)},${svgY(p.avgGuesses, maxGuesses)}`,
)
.join(" ")
: "",
);
// Insights helpers
const progress = $derived(data.progress);
const bestSection = $derived(
progress?.sectionStats.find((s) => s.count >= 3) ?? null,
);
const hardestSection = $derived.by(() => {
if (!progress) return null;
const eligible = progress.sectionStats.filter((s) => s.count >= 3);
if (eligible.length === 0) return null;
const last = eligible[eligible.length - 1];
if (bestSection && last.section === bestSection.section) return null;
return last;
});
const showInsights = $derived(
progress !== null &&
((progress.testamentStats.old !== null &&
progress.testamentStats.new !== null) ||
bestSection !== null),
);
function testamentComparison(
old_: { avgGuesses: number; count: number } | null,
new_: { avgGuesses: number; count: number } | null,
): string | null {
if (!old_ || !new_) return null;
const ratio = old_.avgGuesses / new_.avgGuesses;
if (ratio < 0.85) {
const x = (new_.avgGuesses / old_.avgGuesses).toFixed(1);
return `You're ${x}x faster at Old Testament books`;
}
if (ratio > 1.18) {
const x = (old_.avgGuesses / new_.avgGuesses).toFixed(1);
return `You're ${x}x faster at New Testament books`;
}
return "Your speed is similar for Old and New Testament books";
}
</script>
<svelte:head>
<title>Your Progress | Bibdle</title>
<meta
name="description"
content="Track your Bible knowledge journey with Bibdle"
/>
</svelte:head>
<div
class="min-h-screen bg-linear-to-br from-gray-900 via-slate-900 to-gray-900 p-4 md:p-8"
>
<div class="max-w-3xl mx-auto">
<!-- Header -->
<div class="text-center mb-6 md:mb-8">
<h1 class="text-3xl md:text-4xl font-bold text-gray-100 mb-4">
Your Progress
</h1>
<a href="/" class="p-2 px-20 w-full items-center text-gray-300">
&larr; Back to Game
</a>
</div>
{#if data.requiresAuth}
<div class="text-center py-12">
<div
class="bg-blue-950/50 border border-blue-800/50 rounded-lg p-8 max-w-md mx-auto backdrop-blur-sm"
>
<h2 class="text-2xl font-bold text-blue-200 mb-4">
Authentication Required
</h2>
<p class="text-blue-300 mb-6">
You must be logged in to see your progress.
</p>
<div class="flex flex-col gap-3">
<button
onclick={() => (authModalOpen = true)}
class="inline-flex items-center justify-center px-6 py-3 bg-blue-600 text-white rounded-lg hover:bg-blue-700 transition-colors font-medium"
>
Sign In / Sign Up
</button>
<a
href="/"
class="inline-flex items-center justify-center px-6 py-3 bg-gray-700 text-white rounded-lg hover:bg-gray-600 transition-colors font-medium"
>
&larr; Back to Game
</a>
</div>
</div>
</div>
{:else if data.error}
<div class="text-center py-12">
<div
class="bg-red-950/50 border border-red-800/50 rounded-lg p-6 max-w-md mx-auto backdrop-blur-sm"
>
<p class="text-red-300">{data.error}</p>
<a
href="/"
class="mt-4 inline-block px-4 py-2 bg-red-600 text-white rounded hover:bg-red-700 transition-colors"
>
Return to Game
</a>
</div>
</div>
{:else if !data.progress}
<div class="text-center py-12">
<Container class="p-8 max-w-md mx-auto">
<div class="text-yellow-400 mb-4 text-lg">
No progress yet.
</div>
<p class="text-gray-300 mb-6">
Start playing to build your Bible knowledge journey!
</p>
<a
href="/"
class="inline-flex items-center px-6 py-2.5 bg-amber-600 text-white rounded-lg hover:bg-amber-700 transition-colors font-medium shadow-md"
>
Start Playing
</a>
</Container>
</div>
{:else}
{@const prog = data.progress}
<!-- Key Stats Row -->
<div class="grid grid-cols-2 md:grid-cols-3 gap-3 md:gap-4 mb-6">
<ProgressStatCard
emoji="📅"
value={String(prog.totalSolves)}
label="Total Played"
colorClass="text-blue-400"
/>
<ProgressStatCard
emoji="📖"
value={String(prog.booksExplored)}
label="Books Explored"
colorClass="text-teal-400"
suffix="/ 66"
/>
<ProgressStatCard
emoji="✍️"
value={prog.totalWords.toLocaleString()}
label="Words Read"
colorClass="text-violet-400"
/>
<ProgressStatCard
emoji="✝️"
value={(((prog.totalSolves * 3) / 31102) * 100).toFixed(2) +
"%"}
label="Bible Read"
colorClass="text-amber-400"
/>
<ProgressStatCard
emoji="🏆"
value={String(prog.booksMastered)}
label="Books Mastered"
colorClass="text-purple-400"
suffix="/ 66"
/>
<ProgressStatCard
emoji="⭐"
value={String(prog.booksPerfect)}
label="Books Perfected"
colorClass="text-emerald-400"
suffix="/ 66"
/>
</div>
<!-- Bible Book Grid -->
<div class="mb-6">
<Container class="p-4 md:p-6 w-full">
<h2
class="text-xl font-bold text-gray-100 mb-3 w-full text-left"
>
Bible Books
</h2>
<!-- Legend -->
<div class="flex flex-wrap gap-2 mb-3">
<span
class="flex items-center gap-1 text-xs text-gray-400"
>
<span
class="inline-block w-5 h-5 rounded bg-blue-700"
></span>
Explored
</span>
<span
class="flex items-center gap-1 text-xs text-gray-400"
>
<span
class="inline-block w-5 h-5 rounded bg-purple-600"
></span>
Mastered
</span>
<span
class="flex items-center gap-1 text-xs text-gray-400"
>
<span
class="inline-block w-5 h-5 rounded bg-emerald-500"
></span>
Perfect
</span>
</div>
<!-- Grid -->
<div class="grid grid-cols-8 md:grid-cols-11 gap-1 w-full">
{#each prog.bookGrid as entry (entry.bookId)}
{@const bookMeta = bibleBooks.find(
(b) => b.id === entry.bookId,
)}
<div
class="aspect-square flex items-center justify-center rounded text-[9px] md:text-[10px] font-bold cursor-default {bookTileClass(
entry.tier,
)}"
title="{bookMeta?.name ??
entry.bookId} — {entry.tier}{entry.avgGuesses !==
null
? ` (avg ${entry.avgGuesses})`
: ''}"
>
{entry.bookId}
</div>
{/each}
</div>
<p class="text-xs text-gray-500 mt-3 leading-relaxed">
<span class="text-blue-400 font-medium">Explored</span>
— played at least once<br />
<span class="text-purple-400 font-medium"
>Mastered</span
>
— avg &le; 3 guesses over 2+ plays<br />
<span class="text-emerald-400 font-medium">Perfect</span> —
mastered and guessed in 1 at least once
</p>
</Container>
</div>
<!-- Activity Calendar -->
<div class="mb-6">
<ActivityCalendar completions={prog.completions} />
</div>
<!-- Skill Growth Chart (hidden, needs rework) -->
{#if false && showChart}
<div class="mb-6">
<Container class="p-4 md:p-6 w-full">
<div class="w-full">
<div class="flex items-baseline gap-2 mb-1">
<h2 class="text-xl font-bold text-gray-100">
Skill Growth
</h2>
<span class="text-xs text-gray-400">
Lower is better
</span>
</div>
<svg
viewBox="0 0 400 135"
class="w-full"
aria-hidden="true"
>
<defs>
<linearGradient
id="chartFill"
x1="0"
y1="0"
x2="0"
y2="1"
>
<stop
offset="0%"
stop-color="#10b981"
stop-opacity="0.3"
/>
<stop
offset="100%"
stop-color="#10b981"
stop-opacity="0"
/>
</linearGradient>
</defs>
<!-- Y-axis label -->
<text
transform="translate(8, 60) rotate(-90)"
text-anchor="middle"
font-size="8"
fill="#9ca3af"
>Guesses</text>
<!-- Fill polygon -->
<polygon
points="{polylinePoints} {svgX(
chartPoints.length - 1,
chartPoints.length,
)},110 {svgX(0, chartPoints.length)},110"
fill="url(#chartFill)"
/>
<!-- Line -->
<polyline
points={polylinePoints}
fill="none"
stroke="#10b981"
stroke-width="2"
stroke-linecap="round"
stroke-linejoin="round"
/>
<!-- Dots -->
{#each chartPoints as point, i (i)}
<circle
cx={svgX(i, chartPoints.length)}
cy={svgY(point.avgGuesses, maxGuesses)}
r="3"
fill="#10b981"
/>
<text
x={svgX(i, chartPoints.length)}
y={svgY(point.avgGuesses, maxGuesses) - 6}
font-size="7"
fill="#6ee7b7"
text-anchor="middle"
>{point.avgGuesses}</text>
{/each}
<!-- X-axis labels -->
<text
x={svgX(0, chartPoints.length)}
y="118"
font-size="8"
fill="#9ca3af"
text-anchor="middle"
>
{chartPoints[0].label}
</text>
<text
x={svgX(
chartPoints.length - 1,
chartPoints.length,
)}
y="118"
font-size="8"
fill="#9ca3af"
text-anchor="middle"
>
{chartPoints[chartPoints.length - 1].label}
</text>
<!-- X-axis title -->
<text
x="200"
y="132"
font-size="8"
fill="#9ca3af"
text-anchor="middle"
>Date</text>
</svg>
{#if chartImproving}
<p class="text-xs text-emerald-400 mt-1">
You're getting better!
</p>
{/if}
<p
class="text-xs text-gray-500 mt-2 leading-relaxed"
>
Each point is your average guesses over a
rolling window of games. A downward trend means
you're improving.
</p>
</div>
</Container>
</div>
{/if}
<!-- Achievements -->
{#if prog.milestones.length > 0}
<div class="mb-6">
<h2 class="text-xl font-bold text-gray-100 mb-3">🏆 Achievements</h2>
<div class="grid grid-cols-3 md:grid-cols-4 gap-2 md:gap-3">
{#each prog.milestones.filter(m => m.achieved) as milestone (milestone.id)}
<Container class="p-3 min-h-[130px]">
<div class="text-center flex flex-col items-center justify-center h-full">
<div class="text-2xl mb-1">{milestone.emoji}</div>
<div class="text-sm font-bold text-yellow-300 leading-tight mb-1">
{milestone.name}
</div>
<div class="text-xs text-gray-400 leading-tight">
{milestone.description}
</div>
{#if milestone.achievedDate}
<div class="text-[10px] text-gray-500 mt-1">
{formatDate(milestone.achievedDate)}
</div>
{:else}
<div class="text-[10px] text-emerald-500 mt-1">Earned</div>
{/if}
</div>
</Container>
{/each}
</div>
<p class="text-xs text-gray-500 mt-2">{prog.milestones.filter(m => m.achieved).length} / {prog.milestones.length} achievements unlocked</p>
</div>
{/if}
<!-- Insights -->
{#if showInsights}
<div class="mb-6">
<h2 class="text-xl font-bold text-gray-100 mb-3">
Insights
</h2>
<div class="flex flex-col gap-3">
{#if prog.testamentStats.old && prog.testamentStats.new}
{@const comparison = testamentComparison(
prog.testamentStats.old,
prog.testamentStats.new,
)}
{#if comparison}
<Container class="p-4 w-full">
<div class="flex items-start gap-3 w-full">
<span class="text-2xl">📊</span>
<div class="flex-1 min-w-0">
<p
class="text-gray-100 font-medium text-sm"
>
{comparison}
</p>
<p
class="text-gray-400 text-xs mt-0.5"
>
OT avg: {prog.testamentStats.old
.avgGuesses} guesses &bull; NT
avg: {prog.testamentStats.new
.avgGuesses} guesses
</p>
</div>
</div>
</Container>
{/if}
{/if}
{#if bestSection && bestSection.count >= 3}
<Container class="p-4 w-full">
<div class="flex items-start gap-3 w-full">
<span class="text-2xl">🌟</span>
<div class="flex-1 min-w-0">
<p
class="text-gray-100 font-medium text-sm"
>
Your strongest section: {bestSection.section}
</p>
<p class="text-gray-400 text-xs mt-0.5">
{bestSection.avgGuesses} avg guesses
across {bestSection.count} games
</p>
</div>
</div>
</Container>
{/if}
{#if hardestSection}
{@const hard = hardestSection}
{#if hard && hard.count >= 3}
<Container class="p-4 w-full">
<div class="flex items-start gap-3 w-full">
<span class="text-2xl">💪</span>
<div class="flex-1 min-w-0">
<p
class="text-gray-100 font-medium text-sm"
>
Room to grow: {hard.section}
</p>
<p
class="text-gray-400 text-xs mt-0.5"
>
{hard.avgGuesses} avg guesses across
{hard.count} games
</p>
</div>
</div>
</Container>
{/if}
{/if}
</div>
</div>
{/if}
{/if}
</div>
</div>
<AuthModal bind:isOpen={authModalOpen} {anonymousId} />
Loaded 100 of 120 files, more files were not shown because too many files have changed in this diff. Show more