Closer/functions/src/index.ts

66 lines
3.4 KiB
TypeScript
Raw Normal View History

// Global v2 options (region pin, instance cap) — MUST be imported before any function module so
// setGlobalOptions runs before the functions below are defined.
import './options'
import * as admin from 'firebase-admin'
// Initialize the Admin SDK once for every function in this codebase.
// Handlers call admin.firestore()/messaging() lazily at invocation time, so a
// single idempotent init here is sufficient and avoids "already exists" errors.
if (admin.apps.length === 0) {
admin.initializeApp()
}
// RevenueCat entitlement webhook. Auth = HMAC-SHA256 over the raw body (see revenueCatWebhook.ts).
// Binds defineSecret('REVENUECAT_WEBHOOK_SECRET') — the integration's signing secret from the
// RevenueCat dashboard — which is validated for the whole codebase at deploy time, so the secret
// must exist before any deploy. Seed it with:
// firebase functions:secrets:set REVENUECAT_WEBHOOK_SECRET
export { revenueCatWebhook } from './billing/revenueCatWebhook'
export { syncEntitlement } from './billing/syncEntitlement'
export { onEntitlementChanged } from './billing/onEntitlementChanged'
export { sendGentleReminderCallable } from './notifications/sendGentleReminderCallable'
export { sendThinkingOfYouCallable } from './notifications/sendThinkingOfYouCallable'
export {
sendChallengeDayReminders,
unlockDueMemoryCapsules,
} from './notifications/gameRetention'
export { sendDailyQuestionProactiveReminder } from './notifications/dailyQuestionReminder'
export { sendStreakReminder } from './notifications/streakReminder'
export { sendReengagementReminder } from './notifications/reengagement'
export { checkDeviceIntegrity } from './security/checkDeviceIntegrity'
export { notifyOnDateMatch } from './dates/createDateMatch'
export { onDateReflectionWritten } from './dates/onDateReflectionWritten'
export { onDateReflectionRevealed } from './dates/onDateReflectionRevealed'
export { onDateHistoryCreated } from './dates/onDateHistoryCreated'
export { onRestoreRequested, onRestoreFulfilled } from './backup/onRestoreRequested'
feat(functions): hourly cleanup of expired restore requests (Future.md security #1) A restore_requests doc left behind — partner wrapped the couple key but the recipient never completed, or nobody ever answered — keeps its ECIES keybox forever. It's sealed to the recipient alone, so it's not exploitable, but key material has no business lying around, and expiry was enforced only client-side (fulfil-time check, delete-before-re-request, delete-on-complete): a request whose device disappeared simply lived forever. cleanupExpiredRestoreRequests runs hourly (requests expire in 30 min, so a stranded keybox now lives ~1.5 h at most) over a collectionGroup query on expiresAt — chosen over iterating couples deliberately, because it also reaps requests orphaned under already-deleted couple docs, which a parent iteration can never see. Backed by a new COLLECTION_GROUP fieldOverride on restore_requests.expiresAt (expiresAt is epoch millis, not a Timestamp, which also rules out native Firestore TTL). Deletes only on positive evidence: a pure predicate re-verifies every query hit (a real expiresAt past a 5-min grace so a mid-completion restore is never raced; a day-old createdAt as the defensive fallback when expiresAt is unusable; neither → leave it and log). Status is deliberately irrelevant — a DECLINED-after-READY doc still carries the keybox. Requests that expired recently while still waiting on someone (REQUESTED/READY) nudge the requester — "start a new one whenever you're ready" — through the house pipeline (notification_queue + sendPushToUser, quiet hours respected). The doc is deleted BEFORE the nudge, so a notify failure costs a nudge, never a duplicate; a 2-h notify window keeps the first deploy from blasting the ancient backlog. queueAndPush moves from being file-local in onRestoreRequested.ts to a shared notifications/queueAndPush.ts — the cleanup needed identical semantics, and two copies of notification plumbing is how the same bug ends up existing twice. Sweep never throws (a scheduled-function throw retries in a storm; the next hourly run IS the retry): per-doc Promise.allSettled, one summary log line via the structured logger. 15 new tests; grace-window mutation check kills exactly the guard test. Functions suite 98/98, tsc clean. Deploy (scoped — the RevenueCat webhook must stay undeployed): firebase deploy --only firestore:indexes, then --only functions:cleanupExpiredRestoreRequests. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-15 02:32:59 -05:00
export { cleanupExpiredRestoreRequests } from './backup/cleanupRestoreRequests'
export {
assignDailyQuestion,
assignDailyQuestionCallable,
} from './questions/assignDailyQuestion'
export { onAnswerWritten } from './questions/onAnswerWritten'
export { onAnswerRevealed } from './questions/onAnswerRevealed'
export { onMessageWritten } from './questions/onMessageWritten'
export { onCoupleLeave } from './couples/onCoupleLeave'
export { leaveCoupleCallable } from './couples/leaveCoupleCallable'
export { acceptInviteCallable } from './couples/acceptInviteCallable'
export { createInviteCallable } from './couples/createInviteCallable'
export { submitOutcomeCallable } from './couples/submitOutcomeCallable'
export { aggregateOutcomeStats } from './couples/aggregateOutcomes'
export { scheduledOutcomesReminder } from './couples/scheduledOutcomesReminder'
export { onUserDelete } from './users/onUserDelete'
export {
onGameSessionUpdate,
onThisOrThatPartFinished,
onWheelPartFinished,
onHowWellPartFinished,
onDesireSyncPartFinished,
} from './games/onGameSessionUpdate'
export { wrapReleaseKeyCallable } from './releaseKey/wrapReleaseKeyCallable'
// NOTE (security review Batch 2): the unauthenticated public `health` HTTP endpoint
// was removed to shrink attack surface. Deployment can be verified via
// `firebase functions:list`. If an uptime probe is ever needed, re-add it behind
// auth / a shared secret rather than as an open endpoint.