From 6654ba4a55be54fb3b7cd416354252868d72f391 Mon Sep 17 00:00:00 2001 From: Corey Blais Date: Wed, 22 Jul 2026 20:24:47 -0400 Subject: [PATCH 1/8] Fixing mobile views --- frontend/src/index.css | 467 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 467 insertions(+) diff --git a/frontend/src/index.css b/frontend/src/index.css index ae75bc4..38a871d 100644 --- a/frontend/src/index.css +++ b/frontend/src/index.css @@ -41,6 +41,7 @@ body, #root { margin: 0; min-height: 100%; + width: 100%; } body { @@ -48,6 +49,8 @@ body { color: var(--ink); position: relative; isolation: isolate; + overflow-x: hidden; + -webkit-text-size-adjust: 100%; } body::before { @@ -121,6 +124,7 @@ textarea { .content-shell { display: grid; gap: 1.5rem; + min-width: 0; } .top-alert-notification { @@ -193,11 +197,13 @@ textarea { display: grid; gap: 1rem; align-self: start; + min-width: 0; } .side-nav { display: grid; gap: 1.25rem; + min-width: 0; } .brand-lockup { @@ -453,6 +459,7 @@ textarea { .stack-grid { display: grid; gap: 1.5rem; + min-width: 0; } .hero-card, @@ -536,6 +543,7 @@ textarea { .forms-grid { display: grid; gap: 1.5rem; + min-width: 0; } .hero-stats { @@ -721,6 +729,7 @@ textarea { border-radius: 28px; padding: 1.5rem; align-self: start; + min-width: 0; } .panel-header { @@ -729,6 +738,7 @@ textarea { justify-content: space-between; gap: 1rem; margin-bottom: 1rem; + min-width: 0; } .pulse-panel .panel-header { @@ -864,6 +874,7 @@ textarea { display: flex; gap: 0.75rem; flex-wrap: wrap; + min-width: 0; } .member-header-actions { @@ -964,6 +975,7 @@ textarea { .bird-list { display: grid; gap: 0.9rem; + min-width: 0; } .bird-card-header { @@ -1223,6 +1235,11 @@ textarea { var(--card-bg); position: relative; overflow: hidden; + min-width: 0; +} + +.chart-card .weight-chart { + display: block; } .overview-chart-card::before { @@ -1707,6 +1724,7 @@ textarea { .bird-detail-tab-panel { display: grid; gap: 1rem; + min-width: 0; } .profile-copy { @@ -2074,6 +2092,7 @@ label { .bulk-weight-table-shell { overflow-x: auto; + -webkit-overflow-scrolling: touch; border-radius: 22px; border: 1px solid rgba(53, 129, 98, 0.18); background: rgba(255, 252, 246, 0.72); @@ -2687,3 +2706,451 @@ label { display: none; } } + +@media (max-width: 720px) { + :root { + background: + radial-gradient(circle at 18% 8%, rgba(222, 124, 58, 0.18), transparent 24%), + radial-gradient(circle at 82% 10%, rgba(53, 136, 110, 0.18), transparent 24%), + linear-gradient(180deg, #fef5e7 0%, #ece3c8 48%, #dceee3 100%); + } + + body::before { + opacity: 0.22; + background-size: auto 1200px; + } + + input, + textarea, + select { + min-height: 46px; + border-radius: 14px; + padding: 0.78rem 0.85rem; + font-size: 16px; + } + + .app-shell, + .auth-shell { + width: 100%; + padding: 0.75rem; + } + + .app-shell { + gap: 0.75rem; + } + + .content-shell, + .stack-grid, + .dashboard-grid, + .forms-grid, + .settings-grid, + .settings-column, + .flock-detail-column, + .flock-member-panel, + .flock-member-sections { + gap: 0.85rem; + } + + .hero-card, + .panel { + border-radius: 20px; + padding: 1rem; + box-shadow: 0 14px 26px rgba(89, 48, 42, 0.12); + } + + .hero-card { + gap: 1rem; + } + + .hero-card h1 { + max-width: none; + font-size: 2.15rem; + line-height: 1.04; + } + + .panel-header { + display: grid; + gap: 0.85rem; + margin-bottom: 0.85rem; + } + + .panel-header .button-row, + .member-header-actions, + .overview-alert-actions { + justify-content: start; + } + + .primary-button, + .secondary-button, + .danger-button, + .range-alert-button { + min-height: 44px; + border-radius: 14px; + padding: 0.72rem 0.9rem; + } + + .button-row > button, + .button-row > a, + .top-alert-actions > button { + flex: 1 1 9rem; + } + + .side-rail { + position: sticky; + top: 0; + z-index: 25; + margin: -0.75rem -0.75rem 0; + padding: 0.6rem 0.75rem 0.7rem; + grid-template-columns: 1fr; + gap: 0.55rem; + background: linear-gradient(180deg, rgba(254, 245, 231, 0.98), rgba(254, 245, 231, 0.88)); + border-bottom: 1px solid rgba(53, 129, 98, 0.16); + backdrop-filter: blur(14px); + } + + .brand-lockup { + display: none; + } + + .side-nav.panel { + grid-template-columns: minmax(0, 1fr) auto; + padding: 0; + border: 0; + border-radius: 0; + background: transparent; + box-shadow: none; + backdrop-filter: none; + } + + .page-tabs { + margin: 0 -0.2rem; + padding: 0.1rem 0.2rem 0.25rem; + grid-auto-columns: minmax(5.4rem, 1fr); + gap: 0.35rem; + scroll-snap-type: x proximity; + } + + .page-tab { + min-height: 40px; + min-width: 5.4rem; + padding: 0.5rem 0.55rem; + border-radius: 999px; + font-size: 0.86rem; + scroll-snap-align: start; + } + + .side-nav .secondary-button { + min-height: 40px; + padding: 0.5rem 0.7rem; + border-radius: 999px; + font-size: 0.86rem; + } + + .workspace-switcher { + gap: 0.4rem; + } + + .workspace-switcher-list { + margin: 0 -0.2rem; + padding: 0 0.2rem 0.2rem; + } + + .workspace-switcher-item { + min-width: min(180px, 78vw); + padding: 0.5rem 0.65rem; + border-radius: 999px; + font-size: 0.86rem; + } + + .top-alert-notification { + gap: 0.65rem; + padding: 0.75rem; + border-radius: 16px; + } + + .notification-bell { + width: 30px; + height: 30px; + } + + .chart-card { + padding: 0.75rem; + overflow-x: auto; + -webkit-overflow-scrolling: touch; + } + + .chart-card .weight-chart { + min-width: 520px; + } + + .overview-chart-card { + min-height: 230px; + } + + .chart-footer { + grid-template-columns: 1fr; + } + + .legend-grid, + .detail-grid, + .summary-grid { + grid-template-columns: repeat(auto-fit, minmax(min(150px, 100%), 1fr)); + } + + .bird-list-panel { + order: 1; + } + + .flock-detail-column { + order: 2; + } + + .bird-list { + grid-template-columns: repeat(auto-fit, minmax(min(240px, 100%), 1fr)); + } + + .bird-card { + border-radius: 18px; + padding: 0.8rem; + } + + .bird-avatar { + width: 50px; + height: 50px; + border-radius: 16px; + } + + .bird-detail-panel { + margin-right: 0; + } + + .bird-detail-tabs { + position: sticky; + top: 4.35rem; + z-index: 15; + margin: -0.2rem -0.35rem 0.65rem; + padding: 0.2rem 0.35rem 0.35rem; + display: flex; + flex-direction: row; + overflow-x: auto; + gap: 0.35rem; + background: linear-gradient(180deg, rgba(250, 244, 232, 0.96), rgba(250, 244, 232, 0.84)); + border-radius: 16px; + backdrop-filter: blur(12px); + transform: none; + scrollbar-width: thin; + } + + .bird-detail-tab { + width: 42px; + height: 40px; + min-width: 42px; + border-left: 1px solid rgba(39, 105, 179, 0.14); + border-radius: 14px; + } + + .bird-detail-tab.active { + box-shadow: 0 8px 16px rgba(39, 105, 179, 0.12); + } + + .profile-hero { + grid-template-columns: auto minmax(0, 1fr); + align-items: start; + padding: 0.85rem; + gap: 0.75rem; + } + + .profile-actions { + position: static; + grid-column: 1 / -1; + justify-content: start; + } + + .profile-photo { + width: 86px; + height: 86px; + border-radius: 22px; + } + + .profile-copy h3 { + font-size: 1.35rem; + overflow-wrap: anywhere; + } + + .inline-form, + .settings-nested-grid, + .education-admin-basics, + .quiz-editor-options, + .dose-schedule-row, + .verified-location-search-row, + .verified-location-search-row.has-selected-location, + .medication-dose-row { + grid-template-columns: 1fr; + } + + .verified-location-search-row button, + .verified-location-search-row.has-selected-location button { + width: 100%; + } + + .toggle-field { + padding-top: 0; + } + + .checkbox-row { + width: 100%; + padding: 0.75rem; + border-radius: 14px; + } + + .segmented-control { + grid-template-columns: repeat(auto-fit, minmax(min(8rem, 100%), 1fr)); + } + + .segmented-option { + border-radius: 14px; + padding: 0.72rem 0.8rem; + } + + .photo-editor { + grid-template-columns: 1fr; + justify-items: start; + padding: 0.85rem; + } + + .color-preview-card { + align-items: start; + border-radius: 16px; + padding: 0.8rem; + } + + .bulk-weight-table { + min-width: 560px; + } + + .bulk-weight-table th, + .bulk-weight-table td { + padding: 0.75rem; + } + + .app-modal-backdrop { + padding: 0.75rem; + align-items: end; + } + + .app-modal { + max-height: min(88vh, 760px); + border-radius: 22px; + padding: 1rem; + } +} + +@media (max-width: 430px) { + .app-shell, + .auth-shell { + padding: 0.55rem; + } + + .side-rail { + margin: -0.55rem -0.55rem 0; + padding: 0.5rem 0.55rem 0.6rem; + } + + .content-shell, + .stack-grid, + .dashboard-grid, + .forms-grid, + .settings-grid, + .settings-column, + .flock-detail-column, + .flock-member-panel, + .flock-member-sections { + gap: 0.7rem; + } + + .hero-card, + .panel { + border-radius: 18px; + padding: 0.85rem; + } + + .hero-card h1 { + font-size: 1.9rem; + } + + .page-tabs { + grid-auto-columns: minmax(4.8rem, 1fr); + } + + .page-tab { + min-width: 4.8rem; + font-size: 0.8rem; + } + + .side-nav .secondary-button { + padding-inline: 0.58rem; + font-size: 0.8rem; + } + + .top-alert-notification { + grid-template-columns: 1fr; + } + + .notification-bell { + display: none; + } + + .button-row > button, + .button-row > a, + .top-alert-actions > button, + .settings-save-row > button { + flex: 1 1 100%; + width: 100%; + } + + .bird-card-header { + gap: 0.65rem; + } + + .bird-card-title { + align-items: flex-start; + flex-wrap: wrap; + } + + .profile-hero { + grid-template-columns: 1fr; + } + + .profile-photo { + width: 96px; + height: 96px; + } + + .profile-actions { + width: 100%; + } + + .profile-icon-button { + flex: 1 1 42px; + } + + .chart-card { + margin-inline: -0.1rem; + } + + .settings-nested-card, + .inset-panel, + .legend-card, + .detail-card, + .summary-card, + .weight-reference-card, + .vet-visit-card, + .toggle-card { + border-radius: 16px; + padding: 0.8rem; + } + + .app-modal-backdrop { + padding: 0.5rem; + } +} From 3d38093c9fb2eec0d09265c55d702d06a0cecdfe Mon Sep 17 00:00:00 2001 From: Corey Blais Date: Tue, 4 Aug 2026 16:03:43 -0400 Subject: [PATCH 2/8] Add Discord deploy notifications --- .gitea/workflows/deploy.yml | 122 ++++++++++++++++++++++++++++++++++++ README.md | 2 + 2 files changed, 124 insertions(+) diff --git a/.gitea/workflows/deploy.yml b/.gitea/workflows/deploy.yml index 342a33d..81278d2 100644 --- a/.gitea/workflows/deploy.yml +++ b/.gitea/workflows/deploy.yml @@ -47,6 +47,67 @@ jobs: cd /docker/FlockPal-dev docker compose -f docker-compose.dev.yaml up -d --build + - name: Notify Discord + if: always() + env: + DISCORD_WEBHOOK_URL: ${{ secrets.DISCORD_WEBHOOK_URL }} + JOB_STATUS: ${{ job.status }} + run: | + if [ -z "$DISCORD_WEBHOOK_URL" ]; then + echo "DISCORD_WEBHOOK_URL is not configured; skipping Discord notification." + exit 0 + fi + + if [ "$JOB_STATUS" = "success" ]; then + STATUS_TITLE="Deploy succeeded" + COLOR=65280 + else + STATUS_TITLE="Deploy failed" + COLOR=16711680 + fi + RUN_URL="${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}" + AVATAR_URL="${{ vars.DISCORD_AVATAR_URL }}" + AVATAR_URL="${AVATAR_URL:-https://flockpal.app/FlockPal-Paint.png}" + COMMIT_MESSAGE="$(git -C /docker/FlockPal-dev log -1 --pretty=%s 2>/dev/null || printf '%s' '${{ github.sha }}')" + json_escape() { + printf '%s' "$1" | sed 's/\\/\\\\/g; s/"/\\"/g' + } + BRANCH="$(json_escape '${{ github.ref_name }}')" + MESSAGE="$(json_escape "$COMMIT_MESSAGE")" + AVATAR_URL="$(json_escape "$AVATAR_URL")" + + cat > /tmp/discord-payload.json < /tmp/discord-payload.json <" https://your-host/api/metrics - `S3_ACCESS_KEY_ID` - `S3_SECRET_ACCESS_KEY` - `RESCUE_ONBOARDING_WEBHOOK_URL` + - `DISCORD_WEBHOOK_URL` as a Gitea Actions secret for deploy notifications + - `DISCORD_AVATAR_URL` as an optional Gitea Actions variable for the deploy notification icon 2. Build and start the production stack: ```bash From b4254a68fab29610840b54fc09961c51b761d9b8 Mon Sep 17 00:00:00 2001 From: Corey Blais Date: Tue, 4 Aug 2026 16:14:48 -0400 Subject: [PATCH 3/8] Fix Discord deploy avatar URL --- .gitea/workflows/deploy.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.gitea/workflows/deploy.yml b/.gitea/workflows/deploy.yml index 81278d2..cbf6346 100644 --- a/.gitea/workflows/deploy.yml +++ b/.gitea/workflows/deploy.yml @@ -67,7 +67,7 @@ jobs: fi RUN_URL="${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}" AVATAR_URL="${{ vars.DISCORD_AVATAR_URL }}" - AVATAR_URL="${AVATAR_URL:-https://flockpal.app/FlockPal-Paint.png}" + AVATAR_URL="${AVATAR_URL:-https://www.flockpal.app/FlockPal-Paint.png}" COMMIT_MESSAGE="$(git -C /docker/FlockPal-dev log -1 --pretty=%s 2>/dev/null || printf '%s' '${{ github.sha }}')" json_escape() { printf '%s' "$1" | sed 's/\\/\\\\/g; s/"/\\"/g' @@ -167,7 +167,7 @@ jobs: fi RUN_URL="${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}" AVATAR_URL="${{ vars.DISCORD_AVATAR_URL }}" - AVATAR_URL="${AVATAR_URL:-https://flockpal.app/FlockPal-Paint.png}" + AVATAR_URL="${AVATAR_URL:-https://www.flockpal.app/FlockPal-Paint.png}" COMMIT_MESSAGE="$(git -C /docker/FlockPal log -1 --pretty=%s 2>/dev/null || printf '%s' '${{ github.sha }}')" json_escape() { printf '%s' "$1" | sed 's/\\/\\\\/g; s/"/\\"/g' From 5abc7f6174d7bb349be616d56f542494b7adad62 Mon Sep 17 00:00:00 2001 From: blaisadmin Date: Sat, 5 Sep 2026 22:51:39 -0400 Subject: [PATCH 4/8] Added missing weight emails --- .env.example | 3 + README.md | 20 +++ backend/src/app.ts | 14 ++ backend/src/db/schema.ts | 11 ++ backend/src/queues/weightReminderQueue.ts | 26 +++ backend/src/reminders/weightReminders.test.ts | 60 +++++++ backend/src/reminders/weightReminders.ts | 121 +++++++++++++ backend/src/worker.ts | 16 ++ .../compose.weight-reminders.yml | 26 +++ backend/test-integration/weightReminders.mjs | 166 ++++++++++++++++++ docker-compose.prod.yml | 2 + docker-compose.yml | 2 + docs/WEIGHT_REMINDER_TESTING.md | 34 ++++ 13 files changed, 501 insertions(+) create mode 100644 backend/src/queues/weightReminderQueue.ts create mode 100644 backend/src/reminders/weightReminders.test.ts create mode 100644 backend/src/reminders/weightReminders.ts create mode 100644 backend/test-integration/compose.weight-reminders.yml create mode 100644 backend/test-integration/weightReminders.mjs create mode 100644 docs/WEIGHT_REMINDER_TESTING.md diff --git a/.env.example b/.env.example index d97f1a7..ccaa4b7 100644 --- a/.env.example +++ b/.env.example @@ -39,3 +39,6 @@ STRIPE_PRICE_HOUSEHOLD_HYACINTH_MACAW_YEARLY= STRIPE_CHECKOUT_SUCCESS_URL=http://localhost:3000/?billing=success STRIPE_CHECKOUT_CANCEL_URL=http://localhost:3000/?billing=cancelled STRIPE_PORTAL_RETURN_URL=http://localhost:3000/?billing=portal + +# Send an email after 48 hours without a new weight entry. Requires SMTP and worker. +WEIGHT_REMINDERS_ENABLED=true diff --git a/README.md b/README.md index 4f9f442..e28c9b1 100644 --- a/README.md +++ b/README.md @@ -161,6 +161,26 @@ npm run build npm run worker ``` +### Overdue weight emails + +The worker checks every five minutes for living birds with no new weight entry in +48 hours. Each accepted owner, assistant, or caregiver receives one email per flock +listing all birds due for a reminder. Pending invitees and viewers are excluded. +Reminders repeat every 48 hours while overdue; adding a new weight restarts the +48-hour clock. Birds without weights use their profile creation time. + +The clock uses the weight entry's creation timestamp, since the measurement date +has no time of day. Editing an existing entry does not restart the clock; entering +a historical weight does. Memorialized birds are excluded. + +`WEIGHT_REMINDERS_ENABLED` defaults to `true` in both Compose stacks. Set it to +`false` to disable delivery. The worker, Redis, Postgres, and existing SMTP settings +must be available. The schema initializer creates the delivery tracking table. +Missing SMTP configuration or failed sends leave reminders eligible for retry. +Delivery tracking prevents ordinary repeat sends and concurrent claims; as with +other SMTP delivery, a crash after acceptance but before saving delivery can cause +a duplicate on retry. + ## Auth and flock notes - One user can belong to multiple flocks. diff --git a/backend/src/app.ts b/backend/src/app.ts index 989c6ab..ce01685 100644 --- a/backend/src/app.ts +++ b/backend/src/app.ts @@ -1,3 +1,4 @@ +import type { WeightReminder } from './reminders/weightReminders.js'; import crypto from 'crypto'; import { existsSync } from 'fs'; import path from 'path'; @@ -2270,6 +2271,19 @@ export const runBirdMilestoneReminders = async (runDate = getDateInTimeZone()) = }; }; +export const sendWeightReminderNotification = async (reminders: WeightReminder[]): Promise => { + if (!mailTransport || !reminders.length) return false; + const first = reminders[0]; + const result = await mailTransport.sendMail({ + from: smtpFromName ? `"${smtpFromName}" <${smtpFromEmail}>` : smtpFromEmail, + to: first.recipient, + subject: `Weight reminders for ${first.workspace_name}`, + text: `These birds in ${first.workspace_name} haven't had a new weight entry in at least 48 hours:\n\n${reminders.map((bird) => `- ${bird.bird_name}`).join('\n')}\n\nOpen FlockPal to record their weights: ${frontendBaseUrl}`, + html: `

These birds in ${escapeHtml(first.workspace_name)} haven't had a new weight entry in at least 48 hours:

    ${reminders.map((bird) => `
  • ${escapeHtml(bird.bird_name)}
  • `).join('')}

Open FlockPal to record their weights

`, + }); + return result.accepted.length > 0; +}; + export const runMedicationReminders = async (runDate = getDateInTimeZone(), currentTime = getTimeInTimeZone()) => { const reminders = await listDueMedicationReminders(runDate, currentTime); let sent = 0; diff --git a/backend/src/db/schema.ts b/backend/src/db/schema.ts index 4d83ff6..49dbf15 100644 --- a/backend/src/db/schema.ts +++ b/backend/src/db/schema.ts @@ -480,6 +480,17 @@ export const ensureSchema = async (database: DatabaseClient = db) => { UNIQUE (bird_id, recorded_on) ); + CREATE TABLE IF NOT EXISTS weight_reminder_deliveries ( + bird_id UUID NOT NULL REFERENCES birds(id) ON DELETE CASCADE, + workspace_id INTEGER NOT NULL REFERENCES workspaces(id) ON DELETE CASCADE, + activity_at TIMESTAMPTZ NOT NULL, + recipient TEXT NOT NULL, + claim_token UUID NOT NULL, + claimed_at TIMESTAMPTZ NOT NULL DEFAULT CURRENT_TIMESTAMP, + delivered_at TIMESTAMPTZ, + PRIMARY KEY (bird_id, workspace_id, activity_at, recipient) + ); + CREATE TABLE IF NOT EXISTS vet_visits ( id UUID PRIMARY KEY DEFAULT gen_random_uuid(), bird_id UUID NOT NULL REFERENCES birds(id) ON DELETE CASCADE, diff --git a/backend/src/queues/weightReminderQueue.ts b/backend/src/queues/weightReminderQueue.ts new file mode 100644 index 0000000..ac98391 --- /dev/null +++ b/backend/src/queues/weightReminderQueue.ts @@ -0,0 +1,26 @@ +import { Queue } from 'bullmq'; +import { redisConnection } from './redisConnection.js'; + +export const weightReminderQueueName = 'weight-reminders'; +export const weightReminderQueue = new Queue(weightReminderQueueName, { + connection: redisConnection, + defaultJobOptions: { + attempts: 3, + backoff: { type: 'exponential', delay: 60_000 }, + removeOnComplete: 100, + removeOnFail: 1000, + }, +}); + +export const startWeightReminderScheduler = async () => { + if (process.env.WEIGHT_REMINDERS_ENABLED === 'false') { + await weightReminderQueue.removeJobScheduler('weight-reminders'); + return; + } + await weightReminderQueue.setGlobalConcurrency(1); + await weightReminderQueue.upsertJobScheduler( + 'weight-reminders', + { every: 5 * 60_000 }, + { name: 'check-overdue-weights', data: {} }, + ); +}; diff --git a/backend/src/reminders/weightReminders.test.ts b/backend/src/reminders/weightReminders.test.ts new file mode 100644 index 0000000..e3a73cd --- /dev/null +++ b/backend/src/reminders/weightReminders.test.ts @@ -0,0 +1,60 @@ +import assert from 'node:assert/strict'; +import { test } from 'node:test'; +import { runWeightReminders, type WeightReminder } from './weightReminders.js'; + +const bird = (id: string, workspace = 1, recipient = 'owner@example.com'): WeightReminder => ({ + bird_id: id, workspace_id: workspace, recipient, + bird_name: id, workspace_name: `Flock ${workspace}`, activity_at: '2026-09-01T12:00:00Z', +}); + +test('groups overdue birds into one email per flock and recipient', async () => { + const sent: WeightReminder[][] = []; + const finished: boolean[] = []; + const result = await runWeightReminders(async (birds) => { sent.push(birds); return true; }, { + list: async () => [bird('a'), bird('b'), bird('c', 2), bird('a', 1, 'caregiver@example.com')], + claim: async () => true, + finish: async (_token, delivered) => { finished.push(delivered); }, + }); + assert.deepEqual(sent.map((group) => group.map((item) => item.bird_id)), [['a', 'b'], ['c'], ['a']]); + assert.deepEqual(finished, [true, true, true, true]); + assert.equal(result.sent, 3); +}); + +test('omits birds whose claim was lost or whose weight changed', async () => { + const sent: WeightReminder[][] = []; + await runWeightReminders(async (birds) => { sent.push(birds); return true; }, { + list: async () => [bird('a'), bird('b')], + claim: async (reminder) => reminder.bird_id === 'b', finish: async () => {}, + }); + assert.deepEqual(sent.map((group) => group.map((item) => item.bird_id)), [['b']]); +}); + +test('does not email when all claims are unavailable', async () => { + await runWeightReminders(async () => { assert.fail('Unexpected email'); }, { + list: async () => [bird('a')], claim: async () => false, finish: async () => {}, + }); +}); + +test('missing SMTP releases all claims without recording delivery', async () => { + const finished: boolean[] = []; + const result = await runWeightReminders(async () => false, { + list: async () => [bird('a'), bird('b')], claim: async () => true, + finish: async (_token, delivered) => { finished.push(delivered); }, + }); + assert.deepEqual(finished, [false, false]); + assert.equal(result.sent, 0); +}); + +test('SMTP failure releases claims and still processes other flocks', async () => { + const finished: boolean[] = []; + const result = await runWeightReminders(async (birds) => { + if (birds[0].workspace_id === 1) throw new Error('SMTP unavailable'); + return true; + }, { + list: async () => [bird('a'), bird('b'), bird('c', 2)], claim: async () => true, + finish: async (_token, delivered) => { finished.push(delivered); }, + }); + assert.deepEqual(finished, [false, false, true]); + assert.equal(result.sent, 1); + assert.equal(result.failed, 1); +}); diff --git a/backend/src/reminders/weightReminders.ts b/backend/src/reminders/weightReminders.ts new file mode 100644 index 0000000..1663e29 --- /dev/null +++ b/backend/src/reminders/weightReminders.ts @@ -0,0 +1,121 @@ +import { randomUUID } from 'node:crypto'; +import { db } from '../db/client.js'; + +export type WeightReminder = { + bird_id: string; + workspace_id: number; + bird_name: string; + workspace_name: string; + activity_at: string; + recipient: string; +}; + +// Use entry creation time: recorded_on is a date and cannot measure elapsed hours. +// Editing an existing entry does not reset the reminder clock. +export const listDueWeightReminders = async () => { + const result = await db.query(` + WITH activity AS ( + SELECT birds.id AS bird_id, birds.workspace_id, birds.name AS bird_name, + workspaces.name AS workspace_name, + GREATEST(birds.created_at, COALESCE(MAX(weight_records.created_at), birds.created_at)) AS activity_at + FROM birds + JOIN workspaces ON workspaces.id = birds.workspace_id + LEFT JOIN weight_records ON weight_records.bird_id = birds.id + WHERE birds.memorialized_at IS NULL + GROUP BY birds.id, workspaces.name + ), recipients AS ( + SELECT DISTINCT workspace_id, LOWER(TRIM(users.email)) AS recipient + FROM workspace_members + JOIN users ON users.id = workspace_members.user_id + WHERE accepted_at IS NOT NULL + AND role IN ('owner', 'assistant', 'caregiver') + ) + SELECT activity.bird_id, activity.workspace_id, activity.bird_name, activity.workspace_name, + activity.activity_at::text, recipients.recipient + FROM activity + JOIN recipients USING (workspace_id) + WHERE activity_at <= CURRENT_TIMESTAMP - INTERVAL '48 hours' + AND recipients.recipient <> '' + AND NOT EXISTS ( + SELECT 1 FROM weight_reminder_deliveries d + WHERE d.bird_id = activity.bird_id AND d.workspace_id = activity.workspace_id + AND d.activity_at = activity.activity_at AND d.recipient = recipients.recipient + AND (d.delivered_at > CURRENT_TIMESTAMP - INTERVAL '48 hours' + OR (d.delivered_at IS NULL AND d.claimed_at > CURRENT_TIMESTAMP - INTERVAL '15 minutes')) + ) + ORDER BY activity.workspace_id, activity.bird_id, recipients.recipient + `); + return result.rows; +}; + +export const claimWeightReminder = async (reminder: WeightReminder, token: string) => { + const result = await db.query(` + INSERT INTO weight_reminder_deliveries (bird_id, workspace_id, activity_at, recipient, claim_token) + SELECT $1, $2, $3, $4, $5 + WHERE EXISTS ( + SELECT 1 FROM birds + WHERE id = $1 AND workspace_id = $2 AND memorialized_at IS NULL + AND GREATEST(created_at, COALESCE((SELECT MAX(created_at) FROM weight_records WHERE bird_id = $1), created_at)) = $3::timestamptz + ) + ON CONFLICT (bird_id, workspace_id, activity_at, recipient) DO UPDATE + SET claim_token = EXCLUDED.claim_token, claimed_at = CURRENT_TIMESTAMP, delivered_at = NULL + WHERE weight_reminder_deliveries.delivered_at <= CURRENT_TIMESTAMP - INTERVAL '48 hours' + OR (weight_reminder_deliveries.delivered_at IS NULL + AND weight_reminder_deliveries.claimed_at <= CURRENT_TIMESTAMP - INTERVAL '15 minutes') + RETURNING bird_id + `, [reminder.bird_id, reminder.workspace_id, reminder.activity_at, reminder.recipient, token]); + return Boolean(result.rowCount); +}; + +export const finishWeightReminder = async (token: string, delivered: boolean) => { + if (delivered) { + await db.query('UPDATE weight_reminder_deliveries SET delivered_at = CURRENT_TIMESTAMP WHERE claim_token = $1', [token]); + } else { + await db.query('DELETE FROM weight_reminder_deliveries WHERE claim_token = $1 AND delivered_at IS NULL', [token]); + } +}; + +type Dependencies = { + list: typeof listDueWeightReminders; + claim: typeof claimWeightReminder; + finish: typeof finishWeightReminder; +}; + +export const runWeightReminders = async ( + send: (reminders: WeightReminder[]) => Promise, + dependencies: Dependencies = { list: listDueWeightReminders, claim: claimWeightReminder, finish: finishWeightReminder }, +) => { + const reminders = await dependencies.list(); + const result = { checked: reminders.length, sent: 0, skipped: 0, failed: 0 }; + const groups = new Map(); + for (const reminder of reminders) { + const key = JSON.stringify([reminder.workspace_id, reminder.recipient]); + groups.set(key, [...(groups.get(key) ?? []), reminder]); + } + for (const group of groups.values()) { + const claimed: { reminder: WeightReminder; token: string }[] = []; + let delivered = false; + try { + for (const reminder of group) { + const token = randomUUID(); + if (await dependencies.claim(reminder, token)) claimed.push({ reminder, token }); + else result.skipped += 1; + } + if (!claimed.length) continue; + delivered = await send(claimed.map(({ reminder }) => reminder)); + for (const { token } of claimed) await dependencies.finish(token, delivered); + if (delivered) result.sent += 1; + else result.skipped += claimed.length; + } catch (error) { + result.failed += 1; + // Keep leases if SMTP accepted the email but saving delivery failed. + if (!delivered) { + for (const { token } of claimed) { + await dependencies.finish(token, false).catch((cleanupError) => console.error('Weight reminder claim cleanup failed', cleanupError)); + } + } + console.error(`Weight reminder failed for flock ${group[0].workspace_id}`, error); + } + } + return result; +}; diff --git a/backend/src/worker.ts b/backend/src/worker.ts index 7611d0e..9c52815 100644 --- a/backend/src/worker.ts +++ b/backend/src/worker.ts @@ -1,8 +1,11 @@ +import { runWeightReminders } from './reminders/weightReminders.js'; +import { weightReminderQueue, weightReminderQueueName, startWeightReminderScheduler } from './queues/weightReminderQueue.js'; import { Worker } from 'bullmq'; import { ensureSchema } from './db/schema.js'; import { db } from './db/client.js'; import { + sendWeightReminderNotification, runBirdMilestoneReminders, runMedicationReminders, startBirdMilestoneReminderScheduler, @@ -29,6 +32,7 @@ import { import { redisConnection } from './queues/redisConnection.js'; import { renderAdoptionReportForBird } from './reports/adoptionReportJob.js'; +let weightReminderWorker: Worker | null = null; let birdMilestoneWorker: Worker | null = null; let medicationReminderWorker: Worker | null = null; let adoptionReportWorker: Worker | null = null; @@ -93,6 +97,16 @@ const startWorker = async () => { console.error(`Adoption report job failed: id=${job?.id ?? 'unknown'}, birdId=${job?.data.birdId ?? 'unknown'}`, error); }); + weightReminderWorker = new Worker(weightReminderQueueName, async () => { + if (process.env.WEIGHT_REMINDERS_ENABLED === 'false') return; + const result = await runWeightReminders(sendWeightReminderNotification); + console.log('Weight reminder job completed', result); + return result; + }, { connection: redisConnection, concurrency: 1 }); + weightReminderWorker.on('failed', (job, error) => { + console.error(`Weight reminder job failed: id=${job?.id ?? 'unknown'}`, error); + }); + await startWeightReminderScheduler(); startBirdMilestoneReminderScheduler(); startMedicationReminderScheduler(); console.log('FlockPal worker started.'); @@ -100,6 +114,8 @@ const startWorker = async () => { const shutdown = async (signal: string) => { console.log(`FlockPal worker received ${signal}; shutting down.`); + await weightReminderWorker?.close(); + await weightReminderQueue.close(); await birdMilestoneWorker?.close(); await medicationReminderWorker?.close(); await adoptionReportWorker?.close(); diff --git a/backend/test-integration/compose.weight-reminders.yml b/backend/test-integration/compose.weight-reminders.yml new file mode 100644 index 0000000..7ae6464 --- /dev/null +++ b/backend/test-integration/compose.weight-reminders.yml @@ -0,0 +1,26 @@ +services: + postgres: + image: postgres:16-alpine + environment: + POSTGRES_USER: flockpal_test + POSTGRES_PASSWORD: isolated_test_password + POSTGRES_DB: flockpal_weight_test + ports: + - '127.0.0.1:25432:5432' + tmpfs: + - /var/lib/postgresql/data + healthcheck: + test: ['CMD-SHELL', 'pg_isready -U flockpal_test -d flockpal_weight_test'] + interval: 1s + timeout: 3s + retries: 30 + redis: + image: redis:7-alpine + command: ['redis-server', '--save', '', '--appendonly', 'no'] + ports: + - '127.0.0.1:26379:6379' + mail: + image: axllent/mailpit:latest + ports: + - '127.0.0.1:21025:1025' + - '127.0.0.1:28025:8025' diff --git a/backend/test-integration/weightReminders.mjs b/backend/test-integration/weightReminders.mjs new file mode 100644 index 0000000..ba72f3d --- /dev/null +++ b/backend/test-integration/weightReminders.mjs @@ -0,0 +1,166 @@ +// Run only against disposable local Postgres, Redis, and Mailpit services. +// See docs/WEIGHT_REMINDER_TESTING.md for the isolated Compose setup. +import assert from 'node:assert/strict'; +import { randomUUID } from 'node:crypto'; +import { spawn } from 'node:child_process'; +import { once } from 'node:events'; +import { fileURLToPath } from 'node:url'; + +Object.assign(process.env, { + POSTGRES_HOST: '127.0.0.1', POSTGRES_PORT: '25432', POSTGRES_DB: 'flockpal_weight_test', + POSTGRES_USER: 'flockpal_test', POSTGRES_PASSWORD: 'isolated_test_password', + REDIS_URL: 'redis://127.0.0.1:26379', + SMTP_HOST: '127.0.0.1', SMTP_PORT: '21025', SMTP_SECURE: 'false', + SMTP_USER: '', SMTP_PASS: '', SMTP_FROM_EMAIL: 'reminders@flockpal.test', SMTP_FROM_NAME: 'FlockPal Test', + FRONTEND_URL: 'http://flockpal.test', MILESTONE_REMINDERS_ENABLED: 'false', + MEDICATION_REMINDERS_ENABLED: 'false', WEIGHT_REMINDERS_ENABLED: 'true', +}); +const { db } = await import('../dist/db/client.js'); +const { ensureSchema } = await import('../dist/db/schema.js'); +const { listDueWeightReminders, claimWeightReminder, finishWeightReminder } = await import('../dist/reminders/weightReminders.js'); +const { weightReminderQueue, startWeightReminderScheduler } = await import('../dist/queues/weightReminderQueue.js'); +const workers = []; +let logs = ''; +const poll = async (check, label) => { + const deadline = Date.now() + 30_000; + while (Date.now() < deadline) { + if (await check()) return; + await new Promise(resolve => setTimeout(resolve, 100)); + } + throw new Error(`Timed out: ${label}\n${logs}`); +}; +const messages = async () => (await (await fetch('http://127.0.0.1:28025/api/v1/messages')).json()).messages; +const startWorker = () => { + const child = spawn(process.execPath, [fileURLToPath(new URL('../dist/worker.js', import.meta.url))], { + cwd: '/tmp', env: process.env, stdio: ['ignore', 'pipe', 'pipe'], + }); + child.stdout.on('data', data => { logs += data; }); + child.stderr.on('data', data => { logs += data; }); + workers.push(child); +}; +const stopWorkers = async () => { + const exits = workers.map(child => once(child, 'exit')); + for (const child of workers) child.kill('SIGTERM'); + await Promise.all(exits); + workers.length = 0; +}; +const drain = async () => { + await poll(async () => { + const counts = await weightReminderQueue.getJobCounts('active', 'waiting'); + return !counts.active && !counts.waiting; + }, 'queue drain'); +}; +const runJob = async () => { + const job = await weightReminderQueue.add('integration-check', {}); + await poll(async () => ['completed', 'failed'].includes(await job.getState()), 'manual job'); + assert.equal(await job.getState(), 'completed'); + return (await weightReminderQueue.getJob(job.id)).returnvalue; +}; +try { + await ensureSchema(); + await ensureSchema(); + assert.equal((await db.query('SELECT COUNT(*)::int AS count FROM birds')).rows[0].count, 0, 'Use a fresh disposable database'); + assert.equal((await messages()).length, 0, 'Use a fresh email catcher'); + await db.query("INSERT INTO workspaces (id, name) VALUES (101, 'Test Flock'), (102, 'Other Flock')"); + const ids = {}; + for (const [role, accepted] of [['owner', true], ['assistant', true], ['caregiver', true], ['viewer', true], ['pending', false]]) { + const id = randomUUID(); ids[role] = id; + await db.query('INSERT INTO users (id, email, name) VALUES ($1, $2, $3)', [id, `${role}@example.test`, role]); + await db.query(`INSERT INTO workspace_members (workspace_id, user_id, invite_email, name, role, accepted_at) + VALUES (101, $1, $2, $3, $4, ${accepted ? 'CURRENT_TIMESTAMP' : 'NULL'})`, [id, `${role}@example.test`, role, role === 'pending' ? 'caregiver' : role]); + } + await db.query("INSERT INTO workspace_members (workspace_id, user_id, invite_email, name, role, accepted_at) VALUES (102, $1, 'owner@example.test', 'owner', 'owner', CURRENT_TIMESTAMP)", [ids.owner]); + const birds = {}; + for (const [name, age, memorial, workspace] of [ + ['Kiwi & ', 72, false, 101], ['Boundary', 48, false, 101], + ['No weights', null, false, 101], ['Recent', 47, false, 101], + ['Memorial', 72, true, 101], ['Other bird', 72, false, 102], + ]) { + const id = randomUUID(); birds[name] = id; + await db.query(`INSERT INTO birds (id, workspace_id, name, species, created_at, memorialized_at) + VALUES ($1, $2, $3, 'Cockatiel', CURRENT_TIMESTAMP - INTERVAL '100 hours', ${memorial ? 'CURRENT_TIMESTAMP' : 'NULL'})`, [id, workspace, name]); + if (age !== null) await db.query("INSERT INTO weight_records (bird_id, weight_grams, recorded_on, created_at) VALUES ($1, 90, CURRENT_DATE - 3, CURRENT_TIMESTAMP - $2 * INTERVAL '1 hour')", [id, age]); + } + const due = await listDueWeightReminders(); + assert.equal(due.length, 10); + assert.deepEqual(new Set(due.map(b => b.recipient)), new Set(['owner@example.test', 'assistant@example.test', 'caregiver@example.test'])); + const candidate = due[0]; + const tokens = [randomUUID(), randomUUID()]; + const claims = await Promise.all(tokens.map(token => claimWeightReminder(candidate, token))); + assert.equal(claims.filter(Boolean).length, 1, 'Only one concurrent claim wins'); + await finishWeightReminder(tokens[claims.indexOf(true)], false); + console.log('PASS: schema initialization is repeatable; eligibility, roles, and concurrent claims'); + + startWorker(); startWorker(); + await poll(async () => (await messages()).length === 4, 'initial grouped emails'); + await drain(); + const initial = await messages(); + const bodies = await Promise.all(initial.map(async message => (await fetch(`http://127.0.0.1:28025/api/v1/message/${message.ID}`)).json())); + for (const body of bodies) { + if (body.Subject === 'Weight reminders for Test Flock') { + for (const name of ['Kiwi & ', 'Boundary', 'No weights']) assert.ok(body.Text.includes(name)); + assert.ok(body.HTML.includes('Kiwi & <Peep>')); + assert.ok(!body.Text.includes('Memorial')); + assert.ok(!body.Text.includes('Recent')); + assert.ok(!body.Text.includes('Other bird')); + } else { + assert.equal(body.Subject, 'Weight reminders for Other Flock'); + assert.ok(body.Text.includes('Other bird')); + assert.ok(!body.Text.includes('Boundary')); + } + assert.equal(body.To.length, 1); + } + assert.equal((await weightReminderQueue.getJobSchedulers()).length, 1); + assert.equal(await weightReminderQueue.getGlobalConcurrency(), 1); + assert.equal((await runJob()).sent, 0); + assert.equal((await messages()).length, 4); + console.log('PASS: two real workers, one scheduler, grouped SMTP delivery, escaping, flock isolation, no immediate duplicates'); + + await db.query("UPDATE weight_reminder_deliveries SET delivered_at = CURRENT_TIMESTAMP - INTERVAL '47 hours'"); + assert.equal((await runJob()).sent, 0); + await db.query("UPDATE weight_reminder_deliveries SET delivered_at = CURRENT_TIMESTAMP - INTERVAL '48 hours'"); + assert.equal((await runJob()).sent, 4); + assert.equal((await messages()).length, 8); + await db.query("INSERT INTO weight_records (bird_id, weight_grams, recorded_on) VALUES ($1, 91, CURRENT_DATE)", [birds.Boundary]); + await db.query("UPDATE weight_reminder_deliveries SET delivered_at = CURRENT_TIMESTAMP - INTERVAL '49 hours'"); + assert.ok((await listDueWeightReminders()).every(b => b.bird_id !== birds.Boundary)); + assert.equal((await runJob()).sent, 4); + console.log('PASS: no repeat before 48 hours, repeat after 48 hours, fresh weight resets eligibility'); + + await stopWorkers(); + await db.query("UPDATE weight_reminder_deliveries SET delivered_at = CURRENT_TIMESTAMP - INTERVAL '49 hours'"); + const beforeFailures = (await messages()).length; + process.env.SMTP_HOST = ''; + startWorker(); + assert.equal((await runJob()).sent, 0); + assert.equal((await listDueWeightReminders()).length, 7); + await stopWorkers(); + + process.env.SMTP_HOST = '127.0.0.1'; + process.env.SMTP_PORT = '21026'; // No SMTP listener: exercise a real refused connection. + startWorker(); + const failed = await runJob(); + assert.equal(failed.failed, 4); + assert.equal(failed.sent, 0); + assert.equal((await listDueWeightReminders()).length, 7); + assert.equal((await messages()).length, beforeFailures); + await stopWorkers(); + + process.env.SMTP_PORT = '21025'; + startWorker(); + await runJob(); + await poll(async () => (await messages()).length === beforeFailures + 4, 'delivery after SMTP recovery'); + await drain(); + await stopWorkers(); + console.log('PASS: missing SMTP, real SMTP connection failure, released claims, successful retry'); + + process.env.WEIGHT_REMINDERS_ENABLED = 'false'; + await startWeightReminderScheduler(); + assert.equal((await weightReminderQueue.getJobSchedulers()).length, 0); + console.log('PASS: graceful worker shutdown and disabled scheduler removal'); + console.log('All Postgres / Redis / SMTP integration checks passed.'); +} finally { + for (const child of workers) child.kill('SIGKILL'); + await weightReminderQueue.close(); + await db.close(); +} diff --git a/docker-compose.prod.yml b/docker-compose.prod.yml index a9bae56..522c32f 100644 --- a/docker-compose.prod.yml +++ b/docker-compose.prod.yml @@ -60,6 +60,7 @@ services: RESCUE_STATUS_NOTIFICATION_EMAIL: ${RESCUE_STATUS_NOTIFICATION_EMAIL:-appadmin@flockpal.app} RESCUE_ONBOARDING_WEBHOOK_URL: ${RESCUE_ONBOARDING_WEBHOOK_URL:-https://n8n.blaishome.online/webhook/395cd538-5e0d-4e89-8070-9e66f571b7ee} MILESTONE_REMINDERS_ENABLED: ${MILESTONE_REMINDERS_ENABLED:-true} + WEIGHT_REMINDERS_ENABLED: ${WEIGHT_REMINDERS_ENABLED:-true} MEDICATION_REMINDERS_ENABLED: ${MEDICATION_REMINDERS_ENABLED:-true} MILESTONE_REMINDER_TIME_ZONE: ${MILESTONE_REMINDER_TIME_ZONE:-America/New_York} GOOGLE_CLIENT_ID: ${GOOGLE_CLIENT_ID:-} @@ -142,6 +143,7 @@ services: RESCUE_STATUS_NOTIFICATION_EMAIL: ${RESCUE_STATUS_NOTIFICATION_EMAIL:-appadmin@flockpal.app} RESCUE_ONBOARDING_WEBHOOK_URL: ${RESCUE_ONBOARDING_WEBHOOK_URL:-https://n8n.blaishome.online/webhook/395cd538-5e0d-4e89-8070-9e66f571b7ee} MILESTONE_REMINDERS_ENABLED: ${MILESTONE_REMINDERS_ENABLED:-true} + WEIGHT_REMINDERS_ENABLED: ${WEIGHT_REMINDERS_ENABLED:-true} MEDICATION_REMINDERS_ENABLED: ${MEDICATION_REMINDERS_ENABLED:-true} MILESTONE_REMINDER_TIME_ZONE: ${MILESTONE_REMINDER_TIME_ZONE:-America/New_York} SMTP_HOST: ${SMTP_HOST:-} diff --git a/docker-compose.yml b/docker-compose.yml index b7f4446..b56c17c 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -58,6 +58,7 @@ services: RESCUE_STATUS_NOTIFICATION_EMAIL: ${RESCUE_STATUS_NOTIFICATION_EMAIL:-appadmin@flockpal.app} RESCUE_ONBOARDING_WEBHOOK_URL: ${RESCUE_ONBOARDING_WEBHOOK_URL:-https://n8n.blaishome.online/webhook/395cd538-5e0d-4e89-8070-9e66f571b7ee} MILESTONE_REMINDERS_ENABLED: ${MILESTONE_REMINDERS_ENABLED:-true} + WEIGHT_REMINDERS_ENABLED: ${WEIGHT_REMINDERS_ENABLED:-true} MEDICATION_REMINDERS_ENABLED: ${MEDICATION_REMINDERS_ENABLED:-true} MILESTONE_REMINDER_TIME_ZONE: ${MILESTONE_REMINDER_TIME_ZONE:-America/New_York} GOOGLE_CLIENT_ID: ${GOOGLE_CLIENT_ID:-} @@ -135,6 +136,7 @@ services: RESCUE_STATUS_NOTIFICATION_EMAIL: ${RESCUE_STATUS_NOTIFICATION_EMAIL:-appadmin@flockpal.app} RESCUE_ONBOARDING_WEBHOOK_URL: ${RESCUE_ONBOARDING_WEBHOOK_URL:-https://n8n.blaishome.online/webhook/395cd538-5e0d-4e89-8070-9e66f571b7ee} MILESTONE_REMINDERS_ENABLED: ${MILESTONE_REMINDERS_ENABLED:-true} + WEIGHT_REMINDERS_ENABLED: ${WEIGHT_REMINDERS_ENABLED:-true} MEDICATION_REMINDERS_ENABLED: ${MEDICATION_REMINDERS_ENABLED:-true} MILESTONE_REMINDER_TIME_ZONE: ${MILESTONE_REMINDER_TIME_ZONE:-America/New_York} SMTP_HOST: ${SMTP_HOST:-} diff --git a/docs/WEIGHT_REMINDER_TESTING.md b/docs/WEIGHT_REMINDER_TESTING.md new file mode 100644 index 0000000..eaf8b75 --- /dev/null +++ b/docs/WEIGHT_REMINDER_TESTING.md @@ -0,0 +1,34 @@ +# Weight reminder tests + +From the repository root, run the unit tests and builds: + +```bash +npm ci --prefix backend +npm ci --prefix frontend +npm test --prefix backend +npm run build --prefix backend +npm run build --prefix frontend +``` + +The integration test uses real Postgres 16, Redis 7, two worker processes, and +Mailpit to capture SMTP messages locally. It requires Docker and free localhost +ports 25432, 26379, 21025, and 28025. Port 21026 must remain unused for the SMTP +failure check. Test addresses use `.test`; Mailpit does not relay mail externally. + +```bash +docker compose -p flockpal-weight-test -f backend/test-integration/compose.weight-reminders.yml up -d --wait +node backend/test-integration/weightReminders.mjs +docker compose -p flockpal-weight-test -f backend/test-integration/compose.weight-reminders.yml down --volumes +``` + +Always run the last command when finished, including after a failed test. Start +fresh containers for each run. Postgres data is disposable and held in tmpfs. +The test overrides database, Redis, and SMTP environment variables to use only +these local services. It does not use the application's configured SMTP account. + +Coverage includes repeatable schema initialization, overdue and recent weights, +birds without weights, memorial exclusions, accepted care roles, concurrent +claims, one scheduler across two workers, grouped emails, HTML escaping, flock +isolation, 48-hour repeats, fresh weight resets, SMTP failures and recovery, +worker shutdown, and disabling the scheduler. Repeat timing is tested by aging +delivery timestamps rather than waiting two days. From 856753b0122cc12bea5548426b9cf935aebdbc3d Mon Sep 17 00:00:00 2001 From: blaisadmin Date: Sat, 5 Sep 2026 23:23:56 -0400 Subject: [PATCH 5/8] changed weight reminder schedule --- .env.example | 2 +- README.md | 10 ++++-- backend/src/queues/weightReminderQueue.ts | 34 ++++++++++++++------ backend/src/reminders/reminderDate.test.ts | 21 ++++++++++++ backend/src/reminders/reminderDate.ts | 5 +++ backend/src/reminders/weightReminders.ts | 9 +++--- backend/src/worker.ts | 4 ++- backend/test-integration/weightReminders.mjs | 20 ++++++++---- docs/WEIGHT_REMINDER_TESTING.md | 4 +-- 9 files changed, 84 insertions(+), 25 deletions(-) create mode 100644 backend/src/reminders/reminderDate.test.ts create mode 100644 backend/src/reminders/reminderDate.ts diff --git a/.env.example b/.env.example index ccaa4b7..44efc09 100644 --- a/.env.example +++ b/.env.example @@ -40,5 +40,5 @@ STRIPE_CHECKOUT_SUCCESS_URL=http://localhost:3000/?billing=success STRIPE_CHECKOUT_CANCEL_URL=http://localhost:3000/?billing=cancelled STRIPE_PORTAL_RETURN_URL=http://localhost:3000/?billing=portal -# Send an email after 48 hours without a new weight entry. Requires SMTP and worker. +# Daily email for birds without a new weight entry in 48 hours; uses the milestone time zone. WEIGHT_REMINDERS_ENABLED=true diff --git a/README.md b/README.md index e28c9b1..8a9c7f3 100644 --- a/README.md +++ b/README.md @@ -163,12 +163,18 @@ npm run worker ### Overdue weight emails -The worker checks every five minutes for living birds with no new weight entry in +The worker checks once per calendar day for living birds with no new weight entry in 48 hours. Each accepted owner, assistant, or caregiver receives one email per flock listing all birds due for a reminder. Pending invitees and viewers are excluded. -Reminders repeat every 48 hours while overdue; adding a new weight restarts the +Reminders repeat daily while overdue; adding a new weight restarts the 48-hour clock. Birds without weights use their profile creation time. +Scheduling matches hatch-day reminders: a check 15 seconds after worker startup, +then hourly, with one queued job per local date. There is no fixed morning send +time. Both use `MILESTONE_REMINDER_TIME_ZONE` (default `America/New_York`). +Delivery tracking uses local calendar dates, including daylight-saving changes. +Deploying this change removes the old five-minute Redis schedule. + The clock uses the weight entry's creation timestamp, since the measurement date has no time of day. Editing an existing entry does not restart the clock; entering a historical weight does. Memorialized birds are excluded. diff --git a/backend/src/queues/weightReminderQueue.ts b/backend/src/queues/weightReminderQueue.ts index ac98391..7485719 100644 --- a/backend/src/queues/weightReminderQueue.ts +++ b/backend/src/queues/weightReminderQueue.ts @@ -1,4 +1,5 @@ import { Queue } from 'bullmq'; +import { getReminderDate } from '../reminders/reminderDate.js'; import { redisConnection } from './redisConnection.js'; export const weightReminderQueueName = 'weight-reminders'; @@ -12,15 +13,30 @@ export const weightReminderQueue = new Queue(weightReminderQueueName, { }, }); +export const enqueueDailyWeightReminder = (now = new Date()) => { + const runDate = getReminderDate(now); + return weightReminderQueue.add('check-overdue-weights', { runDate }, { + jobId: `weight-reminders-${runDate}`, + }); +}; + export const startWeightReminderScheduler = async () => { - if (process.env.WEIGHT_REMINDERS_ENABLED === 'false') { - await weightReminderQueue.removeJobScheduler('weight-reminders'); - return; - } + // Remove the previous five-minute schedule during upgrades and when disabled. + await weightReminderQueue.removeJobScheduler('weight-reminders'); + if (process.env.WEIGHT_REMINDERS_ENABLED === 'false') return () => {}; await weightReminderQueue.setGlobalConcurrency(1); - await weightReminderQueue.upsertJobScheduler( - 'weight-reminders', - { every: 5 * 60_000 }, - { name: 'check-overdue-weights', data: {} }, - ); + let lastRunDate = ''; + const runIfNeeded = async () => { + const now = new Date(); + const runDate = getReminderDate(now); + if (lastRunDate === runDate) return; + await enqueueDailyWeightReminder(now); + lastRunDate = runDate; + }; + const check = () => { + void runIfNeeded().catch(error => console.error('Weight reminder scheduler failed', error)); + }; + const startup = setTimeout(check, 15_000); + const interval = setInterval(check, 60 * 60_000); + return () => { clearTimeout(startup); clearInterval(interval); }; }; diff --git a/backend/src/reminders/reminderDate.test.ts b/backend/src/reminders/reminderDate.test.ts new file mode 100644 index 0000000..c323299 --- /dev/null +++ b/backend/src/reminders/reminderDate.test.ts @@ -0,0 +1,21 @@ +import assert from 'node:assert/strict'; +import { test } from 'node:test'; +import { getReminderDate } from './reminderDate.js'; + +test('daily reminder dates use the configured zone across midnight and DST', () => { + const previous = process.env.MILESTONE_REMINDER_TIME_ZONE; + try { + process.env.MILESTONE_REMINDER_TIME_ZONE = 'America/New_York'; + assert.equal(getReminderDate(new Date('2026-09-06T03:59:59Z')), '2026-09-05'); + assert.equal(getReminderDate(new Date('2026-09-06T04:00:00Z')), '2026-09-06'); + assert.equal(getReminderDate(new Date('2026-03-08T06:59:59Z')), '2026-03-08'); + assert.equal(getReminderDate(new Date('2026-03-08T07:00:00Z')), '2026-03-08'); + assert.equal(getReminderDate(new Date('2026-11-01T05:30:00Z')), '2026-11-01'); + assert.equal(getReminderDate(new Date('2026-11-01T06:30:00Z')), '2026-11-01'); + process.env.MILESTONE_REMINDER_TIME_ZONE = 'UTC'; + assert.equal(getReminderDate(new Date('2026-09-06T03:59:59Z')), '2026-09-06'); + } finally { + if (previous === undefined) delete process.env.MILESTONE_REMINDER_TIME_ZONE; + else process.env.MILESTONE_REMINDER_TIME_ZONE = previous; + } +}); diff --git a/backend/src/reminders/reminderDate.ts b/backend/src/reminders/reminderDate.ts new file mode 100644 index 0000000..baba36e --- /dev/null +++ b/backend/src/reminders/reminderDate.ts @@ -0,0 +1,5 @@ +export const getReminderTimeZone = () => process.env.MILESTONE_REMINDER_TIME_ZONE?.trim() || 'America/New_York'; + +export const getReminderDate = (now = new Date()) => new Intl.DateTimeFormat('en-CA', { + timeZone: getReminderTimeZone(), year: 'numeric', month: '2-digit', day: '2-digit', +}).format(now); diff --git a/backend/src/reminders/weightReminders.ts b/backend/src/reminders/weightReminders.ts index 1663e29..da76e56 100644 --- a/backend/src/reminders/weightReminders.ts +++ b/backend/src/reminders/weightReminders.ts @@ -1,3 +1,4 @@ +import { getReminderTimeZone } from './reminderDate.js'; import { randomUUID } from 'node:crypto'; import { db } from '../db/client.js'; @@ -40,11 +41,11 @@ export const listDueWeightReminders = async () => { SELECT 1 FROM weight_reminder_deliveries d WHERE d.bird_id = activity.bird_id AND d.workspace_id = activity.workspace_id AND d.activity_at = activity.activity_at AND d.recipient = recipients.recipient - AND (d.delivered_at > CURRENT_TIMESTAMP - INTERVAL '48 hours' + AND ((d.delivered_at AT TIME ZONE $1)::date >= (CURRENT_TIMESTAMP AT TIME ZONE $1)::date OR (d.delivered_at IS NULL AND d.claimed_at > CURRENT_TIMESTAMP - INTERVAL '15 minutes')) ) ORDER BY activity.workspace_id, activity.bird_id, recipients.recipient - `); + `, [getReminderTimeZone()]); return result.rows; }; @@ -59,11 +60,11 @@ export const claimWeightReminder = async (reminder: WeightReminder, token: strin ) ON CONFLICT (bird_id, workspace_id, activity_at, recipient) DO UPDATE SET claim_token = EXCLUDED.claim_token, claimed_at = CURRENT_TIMESTAMP, delivered_at = NULL - WHERE weight_reminder_deliveries.delivered_at <= CURRENT_TIMESTAMP - INTERVAL '48 hours' + WHERE (weight_reminder_deliveries.delivered_at AT TIME ZONE $6)::date < (CURRENT_TIMESTAMP AT TIME ZONE $6)::date OR (weight_reminder_deliveries.delivered_at IS NULL AND weight_reminder_deliveries.claimed_at <= CURRENT_TIMESTAMP - INTERVAL '15 minutes') RETURNING bird_id - `, [reminder.bird_id, reminder.workspace_id, reminder.activity_at, reminder.recipient, token]); + `, [reminder.bird_id, reminder.workspace_id, reminder.activity_at, reminder.recipient, token, getReminderTimeZone()]); return Boolean(result.rowCount); }; diff --git a/backend/src/worker.ts b/backend/src/worker.ts index 9c52815..4931cfa 100644 --- a/backend/src/worker.ts +++ b/backend/src/worker.ts @@ -32,6 +32,7 @@ import { import { redisConnection } from './queues/redisConnection.js'; import { renderAdoptionReportForBird } from './reports/adoptionReportJob.js'; +let stopWeightReminderScheduler: (() => void) | undefined; let weightReminderWorker: Worker | null = null; let birdMilestoneWorker: Worker | null = null; let medicationReminderWorker: Worker | null = null; @@ -106,7 +107,7 @@ const startWorker = async () => { weightReminderWorker.on('failed', (job, error) => { console.error(`Weight reminder job failed: id=${job?.id ?? 'unknown'}`, error); }); - await startWeightReminderScheduler(); + stopWeightReminderScheduler = await startWeightReminderScheduler(); startBirdMilestoneReminderScheduler(); startMedicationReminderScheduler(); console.log('FlockPal worker started.'); @@ -114,6 +115,7 @@ const startWorker = async () => { const shutdown = async (signal: string) => { console.log(`FlockPal worker received ${signal}; shutting down.`); + stopWeightReminderScheduler?.(); await weightReminderWorker?.close(); await weightReminderQueue.close(); await birdMilestoneWorker?.close(); diff --git a/backend/test-integration/weightReminders.mjs b/backend/test-integration/weightReminders.mjs index ba72f3d..13e6907 100644 --- a/backend/test-integration/weightReminders.mjs +++ b/backend/test-integration/weightReminders.mjs @@ -14,11 +14,13 @@ Object.assign(process.env, { SMTP_USER: '', SMTP_PASS: '', SMTP_FROM_EMAIL: 'reminders@flockpal.test', SMTP_FROM_NAME: 'FlockPal Test', FRONTEND_URL: 'http://flockpal.test', MILESTONE_REMINDERS_ENABLED: 'false', MEDICATION_REMINDERS_ENABLED: 'false', WEIGHT_REMINDERS_ENABLED: 'true', + MILESTONE_REMINDER_TIME_ZONE: 'America/New_York', }); const { db } = await import('../dist/db/client.js'); const { ensureSchema } = await import('../dist/db/schema.js'); +const { getReminderDate } = await import('../dist/reminders/reminderDate.js'); const { listDueWeightReminders, claimWeightReminder, finishWeightReminder } = await import('../dist/reminders/weightReminders.js'); -const { weightReminderQueue, startWeightReminderScheduler } = await import('../dist/queues/weightReminderQueue.js'); +const { weightReminderQueue, startWeightReminderScheduler, enqueueDailyWeightReminder } = await import('../dist/queues/weightReminderQueue.js'); const workers = []; let logs = ''; const poll = async (check, label) => { @@ -91,6 +93,8 @@ try { await finishWeightReminder(tokens[claims.indexOf(true)], false); console.log('PASS: schema initialization is repeatable; eligibility, roles, and concurrent claims'); + // Simulate the schedule present before upgrading to daily reminders. + await weightReminderQueue.upsertJobScheduler('weight-reminders', { every: 300_000 }, { name: 'check-overdue-weights', data: {} }); startWorker(); startWorker(); await poll(async () => (await messages()).length === 4, 'initial grouped emails'); await drain(); @@ -110,22 +114,26 @@ try { } assert.equal(body.To.length, 1); } - assert.equal((await weightReminderQueue.getJobSchedulers()).length, 1); + assert.equal((await weightReminderQueue.getJobSchedulers()).length, 0); + await poll(async () => Boolean(await weightReminderQueue.getJob(`weight-reminders-${getReminderDate()}`)), 'startup daily scheduler'); + const dailyJobs = await Promise.all([enqueueDailyWeightReminder(), enqueueDailyWeightReminder()]); + assert.equal(dailyJobs[0].id, dailyJobs[1].id); + await drain(); assert.equal(await weightReminderQueue.getGlobalConcurrency(), 1); assert.equal((await runJob()).sent, 0); assert.equal((await messages()).length, 4); - console.log('PASS: two real workers, one scheduler, grouped SMTP delivery, escaping, flock isolation, no immediate duplicates'); + console.log('PASS: two real workers, one daily job, legacy schedule removed, grouped SMTP delivery, escaping, flock isolation, no immediate duplicates'); - await db.query("UPDATE weight_reminder_deliveries SET delivered_at = CURRENT_TIMESTAMP - INTERVAL '47 hours'"); + await db.query("UPDATE weight_reminder_deliveries SET delivered_at = CURRENT_TIMESTAMP"); assert.equal((await runJob()).sent, 0); - await db.query("UPDATE weight_reminder_deliveries SET delivered_at = CURRENT_TIMESTAMP - INTERVAL '48 hours'"); + await db.query("UPDATE weight_reminder_deliveries SET delivered_at = ((CURRENT_TIMESTAMP AT TIME ZONE 'America/New_York')::date::timestamp AT TIME ZONE 'America/New_York') - INTERVAL '1 second'"); assert.equal((await runJob()).sent, 4); assert.equal((await messages()).length, 8); await db.query("INSERT INTO weight_records (bird_id, weight_grams, recorded_on) VALUES ($1, 91, CURRENT_DATE)", [birds.Boundary]); await db.query("UPDATE weight_reminder_deliveries SET delivered_at = CURRENT_TIMESTAMP - INTERVAL '49 hours'"); assert.ok((await listDueWeightReminders()).every(b => b.bird_id !== birds.Boundary)); assert.equal((await runJob()).sent, 4); - console.log('PASS: no repeat before 48 hours, repeat after 48 hours, fresh weight resets eligibility'); + console.log('PASS: no repeat on the same local date, daily repeat, fresh weight resets eligibility'); await stopWorkers(); await db.query("UPDATE weight_reminder_deliveries SET delivered_at = CURRENT_TIMESTAMP - INTERVAL '49 hours'"); diff --git a/docs/WEIGHT_REMINDER_TESTING.md b/docs/WEIGHT_REMINDER_TESTING.md index eaf8b75..ecbef01 100644 --- a/docs/WEIGHT_REMINDER_TESTING.md +++ b/docs/WEIGHT_REMINDER_TESTING.md @@ -28,7 +28,7 @@ these local services. It does not use the application's configured SMTP account. Coverage includes repeatable schema initialization, overdue and recent weights, birds without weights, memorial exclusions, accepted care roles, concurrent -claims, one scheduler across two workers, grouped emails, HTML escaping, flock -isolation, 48-hour repeats, fresh weight resets, SMTP failures and recovery, +claims, one daily job across two workers, removal of the old five-minute schedule, grouped emails, HTML escaping, flock +isolation, daily repeats, fresh weight resets, SMTP failures and recovery, worker shutdown, and disabling the scheduler. Repeat timing is tested by aging delivery timestamps rather than waiting two days. From b1b89ad334874c7692956cac62ee43b132fc98b3 Mon Sep 17 00:00:00 2001 From: blaisadmin Date: Tue, 8 Sep 2026 20:49:59 -0400 Subject: [PATCH 6/8] Fixed email designs --- .env.example | 4 + README.md | 4 +- backend/assets/email-background.png | Bin 0 -> 242968 bytes backend/scripts/generate-email-background.mjs | 13 + backend/src/app.ts | 235 ++++-------------- backend/src/emails/birdPortrait.ts | 29 +++ backend/src/emails/emailLayout.test.ts | 36 +++ backend/src/emails/emailLayout.ts | 48 ++++ .../src/emails/weightReminderEmail.test.ts | 60 +++++ backend/src/emails/weightReminderEmail.ts | 44 ++++ backend/src/reminders/weightReminders.test.ts | 1 + backend/src/reminders/weightReminders.ts | 6 +- backend/test-integration/weightReminders.mjs | 8 + docs/WEIGHT_REMINDER_TESTING.md | 2 +- frontend/public/email-background.png | Bin 0 -> 242968 bytes 15 files changed, 302 insertions(+), 188 deletions(-) create mode 100644 backend/assets/email-background.png create mode 100644 backend/scripts/generate-email-background.mjs create mode 100644 backend/src/emails/birdPortrait.ts create mode 100644 backend/src/emails/emailLayout.test.ts create mode 100644 backend/src/emails/emailLayout.ts create mode 100644 backend/src/emails/weightReminderEmail.test.ts create mode 100644 backend/src/emails/weightReminderEmail.ts create mode 100644 frontend/public/email-background.png diff --git a/.env.example b/.env.example index 44efc09..bf76da6 100644 --- a/.env.example +++ b/.env.example @@ -42,3 +42,7 @@ STRIPE_PORTAL_RETURN_URL=http://localhost:3000/?billing=portal # Daily email for birds without a new weight entry in 48 hours; uses the milestone time zone. WEIGHT_REMINDERS_ENABLED=true + +# Optional absolute HTTPS image URL; defaults to FRONTEND_URL/email-background.png. +# Deploy frontend/public/email-background.png before sending the updated email templates. +EMAIL_BACKGROUND_URL= diff --git a/README.md b/README.md index 8a9c7f3..4a5e872 100644 --- a/README.md +++ b/README.md @@ -165,7 +165,9 @@ npm run worker The worker checks once per calendar day for living birds with no new weight entry in 48 hours. Each accepted owner, assistant, or caregiver receives one email per flock -listing all birds due for a reminder. Pending invitees and viewers are excluded. +listing all birds due for a reminder. The branded email embeds the FlockPal logo +and each bird's portrait (including private S3 photos), with the default portrait +used when a photo is missing or unavailable. Pending invitees and viewers are excluded. Reminders repeat daily while overdue; adding a new weight restarts the 48-hour clock. Birds without weights use their profile creation time. diff --git a/backend/assets/email-background.png b/backend/assets/email-background.png new file mode 100644 index 0000000000000000000000000000000000000000..f3b74ae1a9fd7c68f8fc48b9204978d1831c8bab GIT binary patch literal 242968 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⊀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[[14,10,22,'#de7c3a',.28],[82,12,20,'#35886e',.26],[24,84,22,'#ddb34e',.2],[86,78,24,'#2b765c',.24],[62,54,16,'#3072a0',.14]].map(([x,y,r,color,opacity],i)=>``).join('')}`; +const svg = `${gradients}${[0,1,2,3,4].map(i=>``).join('')}${tracks.replace(/^]*>/,'').replace(/<\/svg>$/,'')}`; +await writeFile(new URL('../assets/email-background.png', import.meta.url), await sharp(Buffer.from(svg)).png().toBuffer()); + +await writeFile(new URL('../../frontend/public/email-background.png', import.meta.url), await readFile(new URL('../assets/email-background.png', import.meta.url))); diff --git a/backend/src/app.ts b/backend/src/app.ts index ce01685..959d9d2 100644 --- a/backend/src/app.ts +++ b/backend/src/app.ts @@ -1,3 +1,5 @@ +import { buildEmailLayout } from './emails/emailLayout.js'; +import { buildWeightReminderEmail } from './emails/weightReminderEmail.js'; import type { WeightReminder } from './reminders/weightReminders.js'; import crypto from 'crypto'; import { existsSync } from 'fs'; @@ -9,7 +11,7 @@ import express, { type NextFunction, type Request, type Response } from 'express import rateLimit from 'express-rate-limit'; import helmet from 'helmet'; import morgan from 'morgan'; -import nodemailer, { type SendMailOptions } from 'nodemailer'; +import nodemailer from 'nodemailer'; import Stripe from 'stripe'; import { z } from 'zod'; @@ -1395,12 +1397,14 @@ const sendMagicLink = async ({ '', 'This link expires in 15 minutes and can only be used once.', ].join('\n'), - html: ` -

Hi ${name || 'there'},

+ ...await buildEmailLayout({ eyebrow: 'Sign in', headline: 'Your FlockPal sign-in link', + contentHtml: ` +

Hi ${escapeHtml(name || 'there')},

Use this secure link to sign in to FlockPal:

-

Sign in to FlockPal

This link expires in 15 minutes and can only be used once.

- `, +`, + action: { url: magicLinkUrl, label: 'Sign in to FlockPal' }, + }), }); return { @@ -1471,27 +1475,6 @@ const getMilestoneYearCount = (reminder: BirdMilestoneReminderCandidateRow) => { return Number.isFinite(sourceYear) ? Math.max(0, reminder.reminder_year - sourceYear) : 0; }; -const getFlockPalLogoAttachment = () => { - const logoPath = path.join(process.cwd(), 'assets', 'flockpal-logo.png'); - - if (!existsSync(logoPath)) { - console.warn(`Unable to load FlockPal email logo from ${logoPath}`); - return null; - } - - return { - filename: 'flockpal-logo.png', - path: logoPath, - cid: 'flockpal-logo', - contentDisposition: 'inline' as const, - }; -}; - -const getEmailTrackPatternDataUrl = () => { - const svg = ``; - return `data:image/svg+xml,${encodeURIComponent(svg)}`; -}; - const parseDataImage = (dataUrl: string) => { const match = /^data:(image\/[a-zA-Z0-9.+-]+);base64,(.+)$/.exec(dataUrl); if (!match) { @@ -1636,22 +1619,6 @@ const loadBirdReportPhotoBuffer = async (bird: BirdRow) => { return Buffer.from(await imageResponse.arrayBuffer()); }; -const getDefaultBirdPhotoAttachment = () => { - const defaultPhotoPath = path.join(process.cwd(), 'assets', 'yoda-default.png'); - - if (!existsSync(defaultPhotoPath)) { - console.warn(`Unable to load default bird photo from ${defaultPhotoPath}`); - return null; - } - - return { - filename: 'yoda-default.png', - path: defaultPhotoPath, - cid: 'flockpal-default-bird-photo', - contentDisposition: 'inline' as const, - }; -}; - const sendRescueStatusNotification = async ({ workspace, ownerEmail, @@ -1701,7 +1668,8 @@ const sendRescueStatusNotification = async ({ to: rescueStatusNotificationEmail, subject, text: lines.join('\n'), - html: ` + ...await buildEmailLayout({ eyebrow: 'Rescue status', headline: 'Rescue flock update', + contentHtml: `

A rescue flock was ${eventLabel}.

  • Rescue flock: ${escapedWorkspaceName}
  • @@ -1711,7 +1679,9 @@ const sendRescueStatusNotification = async ({
  • Flock ID: ${workspace.id}
${escapedNote ? `

Note: ${escapedNote}

` : ''} - `, +`, + action: { url: frontendBaseUrl, label: 'Open FlockPal' }, + }), }); return { delivered: true }; @@ -1850,13 +1820,15 @@ const issueBirdTransferInvite = async ({ to: email, subject, text, - html: ` + ...await buildEmailLayout({ eyebrow: 'Bird transfer', headline: 'A bird is joining your flock', + contentHtml: `

Hi there,

${escapeHtml(sourceWorkspaceName)} wants to transfer ${escapeHtml(birdName)} to your FlockPal account.

Use this secure invite link to sign in or create your account. FlockPal will automatically create your receiving flock and complete any pending bird transfers for this email.

-

Accept bird transfer in FlockPal

This link expires in 15 minutes and can only be used once.

- `, +`, + action: { url: magicLinkUrl, label: 'Accept bird transfer' }, + }), }); return { @@ -1912,7 +1884,8 @@ const sendLostBirdReportNotification = async ({ replyTo: emptyToNull(report.finderEmail) ?? undefined, subject, text: lines.join('\n'), - html: ` + ...await buildEmailLayout({ eyebrow: 'Found bird report', headline: 'A possible match for your bird', + contentHtml: `

A possible found bird report was submitted for ${escapeHtml(bird.name)}.

  • Band ID: ${escapeHtml(bird.tag_id ?? 'Not recorded')}
  • @@ -1924,7 +1897,9 @@ const sendLostBirdReportNotification = async ({
  • Message: ${escapeHtml(message)}

FlockPal does not verify found bird reports. Please use care before sharing personal information or arranging a pickup.

- `, +`, + action: { url: frontendBaseUrl, label: 'Open FlockPal' }, + }), }); return { delivered: true }; @@ -2000,7 +1975,7 @@ const buildMedicationReminderCopy = (reminder: MedicationReminderCandidateRow) = return { subject: `${reminder.medication_name} reminder for ${reminder.name}`, eyebrow: 'Medication Reminder', - headline: `${slotLabel} time for ${reminder.name}`, + headline: `Medication time for ${reminder.name}`, intro: `${reminder.name} is due for ${reminder.medication_name} at ${doseTime}.`, body: `Dose: ${reminder.dosage}${route}.`, detailLabel: `${slotLabel} at ${doseTime}`, @@ -2021,32 +1996,6 @@ const sendBirdMilestoneReminderNotification = async ({ } const copy = buildBirdMilestoneReminderCopy(reminder); - const attachments: NonNullable = []; - const logoAttachment = getFlockPalLogoAttachment(); - const trackPatternDataUrl = getEmailTrackPatternDataUrl(); - const uploadedBirdPhoto = reminder.photo_data_url ? parseDataImage(reminder.photo_data_url) : null; - const defaultBirdPhoto = uploadedBirdPhoto ? null : getDefaultBirdPhotoAttachment(); - const birdPhotoCid = uploadedBirdPhoto ? 'bird-photo' : defaultBirdPhoto ? defaultBirdPhoto.cid : ''; - - if (logoAttachment) { - attachments.push(logoAttachment); - } - - if (uploadedBirdPhoto) { - attachments.push({ - filename: `${reminder.name.replace(/[^a-z0-9_-]+/gi, '-').toLowerCase() || 'bird'}-photo`, - content: uploadedBirdPhoto.content, - contentType: uploadedBirdPhoto.contentType, - cid: birdPhotoCid, - contentDisposition: 'inline', - }); - } else if (defaultBirdPhoto) { - attachments.push(defaultBirdPhoto); - } - - const birdPhotoHtml = birdPhotoCid - ? `${escapeHtml(reminder.name)}` - : `
${escapeHtml(reminder.name.slice(0, 1).toUpperCase())}
`; const lines = [ copy.headline, '', @@ -2071,43 +2020,18 @@ const sendBirdMilestoneReminderNotification = async ({ bcc: uniqueRecipients, subject: copy.subject, text: lines.join('\n'), - attachments, - html: ` -
-
- -
-
-
- ${ - logoAttachment - ? 'FlockPal' - : 'FlockPal' - } -
-
- - - - - -
- ${birdPhotoHtml} - -

${escapeHtml(copy.headline)}

-

${escapeHtml(copy.intro)}

-
-

${escapeHtml(copy.body)}

-

- Open FlockPal -

-
-
-
- -
-
- `, + ...await buildEmailLayout({ + bird: reminder, + eyebrow: copy.eyebrow, + headline: copy.headline, + preheader: copy.intro, + contentHtml: `

${escapeHtml(copy.intro)}

+

${escapeHtml(copy.body)}

+

${escapeHtml(reminder.name)} · ${escapeHtml(reminder.species)}

+

${escapeHtml(`${copy.eventName}: ${copy.milestoneLabel}`)}

+ `, + action: { url: frontendBaseUrl, label: 'Open FlockPal' }, + }), }); return { delivered: true }; @@ -2127,35 +2051,6 @@ const sendMedicationReminderNotification = async ({ } const copy = buildMedicationReminderCopy(reminder); - const attachments: NonNullable = []; - const logoAttachment = getFlockPalLogoAttachment(); - const trackPatternDataUrl = getEmailTrackPatternDataUrl(); - const uploadedBirdPhoto = reminder.photo_data_url ? parseDataImage(reminder.photo_data_url) : null; - const defaultBirdPhoto = uploadedBirdPhoto ? null : getDefaultBirdPhotoAttachment(); - const birdPhotoCid = uploadedBirdPhoto ? 'bird-photo' : defaultBirdPhoto ? defaultBirdPhoto.cid : ''; - - if (logoAttachment) { - attachments.push(logoAttachment); - } - - if (uploadedBirdPhoto) { - attachments.push({ - filename: `${reminder.name.replace(/[^a-z0-9_-]+/gi, '-').toLowerCase() || 'bird'}-photo`, - content: uploadedBirdPhoto.content, - contentType: uploadedBirdPhoto.contentType, - cid: birdPhotoCid, - contentDisposition: 'inline', - }); - } else if (defaultBirdPhoto) { - attachments.push(defaultBirdPhoto); - } - - const birdPhotoHtml = birdPhotoCid - ? `${escapeHtml(reminder.name)}` - : `
${escapeHtml(reminder.name.slice(0, 1).toUpperCase())}
`; - const medicationNotesHtml = reminder.medication_notes - ? `

Medication notes: ${escapeHtml(reminder.medication_notes)}

` - : ''; const lines = [ copy.headline, '', @@ -2182,46 +2077,18 @@ const sendMedicationReminderNotification = async ({ bcc: uniqueRecipients, subject: copy.subject, text: lines.join('\n'), - attachments, - html: ` -
-
- -
-
-
- ${ - logoAttachment - ? 'FlockPal' - : 'FlockPal' - } -
-
- - - - - -
- ${birdPhotoHtml} - -

${escapeHtml(copy.eyebrow)}

-

${escapeHtml(copy.headline)}

-

${escapeHtml(copy.intro)}

-
-

${escapeHtml(copy.body)}

-

Schedule: ${escapeHtml(copy.detailLabel)}

- ${medicationNotesHtml} -

- Open FlockPal -

-
-
-
- -
-
- `, + ...await buildEmailLayout({ + bird: reminder, + eyebrow: copy.eyebrow, + headline: copy.headline, + preheader: copy.intro, + contentHtml: `

${escapeHtml(copy.intro)}

+

${escapeHtml(copy.body)}

+

${escapeHtml(reminder.name)} · ${escapeHtml(reminder.species)}

+

${escapeHtml(copy.detailLabel)}

+ ${reminder.medication_notes ? `

Medication notes: ${escapeHtml(reminder.medication_notes)}

` : ''}`, + action: { url: frontendBaseUrl, label: 'Open FlockPal' }, + }), }); return { delivered: true }; @@ -2277,9 +2144,7 @@ export const sendWeightReminderNotification = async (reminders: WeightReminder[] const result = await mailTransport.sendMail({ from: smtpFromName ? `"${smtpFromName}" <${smtpFromEmail}>` : smtpFromEmail, to: first.recipient, - subject: `Weight reminders for ${first.workspace_name}`, - text: `These birds in ${first.workspace_name} haven't had a new weight entry in at least 48 hours:\n\n${reminders.map((bird) => `- ${bird.bird_name}`).join('\n')}\n\nOpen FlockPal to record their weights: ${frontendBaseUrl}`, - html: `

These birds in ${escapeHtml(first.workspace_name)} haven't had a new weight entry in at least 48 hours:

    ${reminders.map((bird) => `
  • ${escapeHtml(bird.bird_name)}
  • `).join('')}

Open FlockPal to record their weights

`, + ...await buildWeightReminderEmail(reminders, frontendBaseUrl), }); return result.accepted.length > 0; }; diff --git a/backend/src/emails/birdPortrait.ts b/backend/src/emails/birdPortrait.ts new file mode 100644 index 0000000..cf03dfb --- /dev/null +++ b/backend/src/emails/birdPortrait.ts @@ -0,0 +1,29 @@ +import { readFile } from 'node:fs/promises'; +import sharp from 'sharp'; +import type { WeightReminder } from '../reminders/weightReminders.js'; +import { getS3ImageStorageConfig } from '../storage/imageStorageConfig.js'; +import { getSignedS3ObjectUrl } from '../storage/s3Client.js'; + +const asset = (name: string) => new URL(`../../assets/${name}`, import.meta.url); +const thumbnail = (content: Buffer) => sharp(content).rotate().resize(192, 192, { fit: 'cover' }).jpeg({ quality: 80 }).toBuffer(); + +export const loadWeightReminderPortrait = async (bird: Pick): Promise => { + try { + if (bird.photo_object_key) { + const config = getS3ImageStorageConfig(); + if (config) { + const response = await fetch(getSignedS3ObjectUrl({ config, objectKey: bird.photo_object_key, expiresInSeconds: 300 }), { + signal: AbortSignal.timeout(10_000), + }); + if (!response.ok) throw new Error(`Photo storage returned ${response.status}`); + return await thumbnail(Buffer.from(await response.arrayBuffer())); + } + } + const match = bird.photo_data_url?.match(/^data:image\/(?:png|jpe?g|webp|gif);base64,(.+)$/); + if (match) return await thumbnail(Buffer.from(match[1], 'base64')); + } catch { + console.warn(`Unable to load weight reminder portrait for bird ${bird.bird_id}; using default portrait.`); + } + return thumbnail(await readFile(asset('yoda-default.png'))); +}; + diff --git a/backend/src/emails/emailLayout.test.ts b/backend/src/emails/emailLayout.test.ts new file mode 100644 index 0000000..00754e2 --- /dev/null +++ b/backend/src/emails/emailLayout.test.ts @@ -0,0 +1,36 @@ +import assert from 'node:assert/strict'; +import { test } from 'node:test'; +import { buildEmailLayout } from './emailLayout.js'; + +test('shared layout escapes copy and embeds the app background and bird portrait', async () => { + const mail = await buildEmailLayout({ + backgroundUrl: 'https://flockpal.test/email-background.png', + eyebrow: 'Medication ', headline: 'Medication time for Kiwi & Peep', + contentHtml: '

Morning at 8:00 AM

', + action: { url: 'https://flockpal.test/?a=1&b=2', label: 'Open ' }, + bird: { id: 'bird-1', name: 'Kiwi & Peep', photo_data_url: null, photo_object_key: null }, + }); + const html = String(mail.html); + assert.match(html, /Medication <reminder>/); + assert.match(html, /Medication time for Kiwi & Peep/); + assert.match(html, /a=1&b=2/); + assert.match(html, /Open <FlockPal>/); + assert.match(html, /Morning at 8:00 AM/); + assert.match(html, /background="https:\/\/flockpal.test\/email-background.png"/); + assert.match(html, /background-image:url\('https:\/\/flockpal.test\/email-background.png'\)/); + assert.doesNotMatch(html, /flockpal-pattern|cid:flockpal-background/); + assert.doesNotMatch(html, /48-hour|weights are overdue|data:image/); + for (const attachment of mail.attachments ?? []) { + assert.ok(html.includes(`cid:${attachment.cid}`)); + assert.equal(attachment.contentDisposition, 'inline'); + assert.ok(Buffer.isBuffer(attachment.content)); + } + assert.equal((html.match(//g) ?? []).length); + assert.equal((html.match(//g) ?? []).length); +}); + +test('transactional layout omits optional portrait, action and reminder footer', async () => { + const mail = await buildEmailLayout({ eyebrow: 'Rescue status', headline: 'Flock update', contentHtml: '

Status changed

' }); + assert.equal(mail.attachments?.length, 1); + assert.doesNotMatch(String(mail.html), /bird-portrait| value.replace(/[&<>"']/g, char => ({ + '&': '&', '<': '<', '>': '>', '"': '"', "'": ''', +})[char]!); +const asset = (name: string) => new URL(`../../assets/${name}`, import.meta.url); + +export const buildEmailLayout = async ({ eyebrow, headline, preheader = headline, contentHtml, action, footer, bird, backgroundUrl = process.env.EMAIL_BACKGROUND_URL || new URL('/email-background.png', process.env.FRONTEND_URL || 'http://localhost:3000').href }: { + eyebrow: string; + headline: string; + preheader?: string; + /** Trusted markup; escape all dynamic values before passing them. */ + contentHtml: string; + action?: { url: string; label: string }; + footer?: string; + backgroundUrl?: string; + bird?: { id: string; name: string; photo_data_url: string | null; photo_object_key: string | null }; +}): Promise> => ({ + attachments: [ + { filename: 'flockpal-logo.png', cid: 'flockpal-logo', contentType: 'image/png', contentDisposition: 'inline', content: await sharp(await readFile(asset('flockpal-logo.png'))).resize({ width: 480 }).png().toBuffer() }, + ...(bird ? [{ filename: 'bird-portrait.jpg', cid: 'bird-portrait', contentType: 'image/jpeg', contentDisposition: 'inline' as const, content: await loadWeightReminderPortrait({ bird_id: bird.id, photo_data_url: bird.photo_data_url, photo_object_key: bird.photo_object_key }) }] : []), + ], + html: ` + +
${escapeHtml(preheader)}
+ + +
+ + + +
+ FlockPal +
+

${escapeHtml(eyebrow)}

+

${escapeHtml(headline)}

+ ${bird ? `${escapeHtml(bird.name)}` : ''} + ${contentHtml} + ${action ? `
${escapeHtml(action.label)}
` : ''} + ${footer ? `

${escapeHtml(footer)}

` : ''} +
+

FlockPal · A little care, every day.

+
+`, +}); diff --git a/backend/src/emails/weightReminderEmail.test.ts b/backend/src/emails/weightReminderEmail.test.ts new file mode 100644 index 0000000..f73be08 --- /dev/null +++ b/backend/src/emails/weightReminderEmail.test.ts @@ -0,0 +1,60 @@ +import assert from 'node:assert/strict'; +import { readFile } from 'node:fs/promises'; +import { test } from 'node:test'; +import sharp from 'sharp'; +import { buildWeightReminderEmail, loadWeightReminderPortrait } from './weightReminderEmail.js'; +import type { WeightReminder } from '../reminders/weightReminders.js'; + +const bird: WeightReminder = { + bird_id: 'bird-1', workspace_id: 1, bird_name: 'Kiwi & ', species: 'Cockatiel', + workspace_name: 'Our ', activity_at: '2026-09-01T12:00:00Z', recipient: 'owner@example.test', + photo_data_url: null, photo_object_key: null, +}; + +test('branded grouped email embeds distinct portraits and escapes dynamic content', async () => { + const mail = await buildWeightReminderEmail([bird, { ...bird, bird_id: 'bird-2', bird_name: 'Yoda' }], 'https://flockpal.test/?a=1&b=2'); + assert.equal(mail.attachments?.length, 3); + assert.deepEqual(mail.attachments?.map(a => a.cid), ['flockpal-logo', 'weight-bird-0', 'weight-bird-1']); + for (const attachment of mail.attachments ?? []) { + assert.equal(attachment.contentDisposition, 'inline'); + assert.ok(Buffer.isBuffer(attachment.content)); + assert.ok(String(mail.html).includes(`cid:${attachment.cid}`)); + } + assert.match(String(mail.html), /Kiwi & <Peep>/); + assert.match(String(mail.html), /Our <Flock>/); + assert.match(String(mail.html), /a=1&b=2/); + assert.match(String(mail.text), /Kiwi & /); +}); + +test('database portrait is resized and invalid photos fall back to the default', async () => { + const source = await readFile(new URL('../../assets/yoda.png', import.meta.url)); + const photo = await loadWeightReminderPortrait({ ...bird, photo_data_url: `data:image/png;base64,${source.toString('base64')}` }); + const metadata = await sharp(photo).metadata(); + assert.equal(metadata.width, 192); + assert.equal(metadata.height, 192); + assert.equal(metadata.format, 'jpeg'); + assert.deepEqual(await loadWeightReminderPortrait({ ...bird, photo_data_url: 'data:image/png;base64,broken' }), await loadWeightReminderPortrait(bird)); +}); + +test('private S3 portrait is downloaded and embedded rather than linked', async (t) => { + const env = { IMAGE_STORAGE_PROVIDER: 's3', S3_ENDPOINT: 'https://storage.example.test', S3_REGION: 'us-east-1', S3_BUCKET: 'portraits', S3_ACCESS_KEY_ID: 'test', S3_SECRET_ACCESS_KEY: 'test' }; + const previous = Object.fromEntries(Object.keys(env).map(key => [key, process.env[key]])); + Object.assign(process.env, env); + try { + const source = await readFile(new URL('../../assets/yoda.png', import.meta.url)); + t.mock.method(globalThis, 'fetch', async (url: string) => { + assert.match(String(url), /private-bird.png/); + return new Response(source); + }); + const photo = await loadWeightReminderPortrait({ ...bird, photo_object_key: 'private-bird.png' }); + assert.equal((await sharp(photo).metadata()).width, 192); + t.mock.restoreAll(); + t.mock.method(globalThis, 'fetch', async () => new Response('', { status: 404 })); + assert.deepEqual(await loadWeightReminderPortrait({ ...bird, photo_object_key: 'missing.png' }), await loadWeightReminderPortrait(bird)); + } finally { + for (const [key, value] of Object.entries(previous)) { + if (value === undefined) delete process.env[key]; + else process.env[key] = value; + } + } +}); diff --git a/backend/src/emails/weightReminderEmail.ts b/backend/src/emails/weightReminderEmail.ts new file mode 100644 index 0000000..c0ec647 --- /dev/null +++ b/backend/src/emails/weightReminderEmail.ts @@ -0,0 +1,44 @@ +import { buildEmailLayout, escapeHtml } from './emailLayout.js'; +import type { SendMailOptions } from 'nodemailer'; +import type { WeightReminder } from '../reminders/weightReminders.js'; +import { loadWeightReminderPortrait } from './birdPortrait.js'; +export { loadWeightReminderPortrait } from './birdPortrait.js'; + +export const buildWeightReminderEmail = async ( + reminders: WeightReminder[], + frontendUrl: string, + loadPortrait = loadWeightReminderPortrait, +): Promise> => { + if (!reminders.length) throw new Error('A weight reminder email requires at least one bird'); + const flock = reminders[0].workspace_name; + const attachments: NonNullable = []; + const rows: string[] = []; + for (const [index, bird] of reminders.entries()) { + const cid = `weight-bird-${index}`; + attachments.push({ filename: `${cid}.jpg`, cid, content: await loadPortrait(bird), contentType: 'image/jpeg', contentDisposition: 'inline' }); + rows.push(` + + ${escapeHtml(bird.bird_name)} + + +

${escapeHtml(bird.bird_name)}

+

${escapeHtml(bird.species)}

+

Ready for a weight check

+ + `); + } + const layout = await buildEmailLayout({ + eyebrow: 'Daily weight reminder', + headline: 'A little check-in for your flock', + preheader: `A little check-in for ${flock}: it's time to log your birds' weights.`, + contentHtml: `

These birds in ${escapeHtml(flock)} haven't had a new weight entry in at least 48 hours.

${rows.join('')}
`, + action: { url: frontendUrl, label: 'Record their weights' }, + footer: "You'll receive a daily reminder while weights are overdue. A new weight entry restarts the 48-hour clock.", + }); + return { + subject: `Weight reminders for ${flock}`, + text: `Daily weight reminder — ${flock}\n\nThese birds haven't had a new weight entry in at least 48 hours:\n\n${reminders.map(bird => `- ${bird.bird_name} (${bird.species})`).join('\n')}\n\nOpen FlockPal to record their weights: ${frontendUrl}\n\nYou'll receive a daily reminder while weights are overdue.`, + ...layout, + attachments: [...(layout.attachments ?? []), ...attachments], + }; +}; diff --git a/backend/src/reminders/weightReminders.test.ts b/backend/src/reminders/weightReminders.test.ts index e3a73cd..f4af9ed 100644 --- a/backend/src/reminders/weightReminders.test.ts +++ b/backend/src/reminders/weightReminders.test.ts @@ -3,6 +3,7 @@ import { test } from 'node:test'; import { runWeightReminders, type WeightReminder } from './weightReminders.js'; const bird = (id: string, workspace = 1, recipient = 'owner@example.com'): WeightReminder => ({ + species: 'Cockatiel', photo_data_url: null, photo_object_key: null, bird_id: id, workspace_id: workspace, recipient, bird_name: id, workspace_name: `Flock ${workspace}`, activity_at: '2026-09-01T12:00:00Z', }); diff --git a/backend/src/reminders/weightReminders.ts b/backend/src/reminders/weightReminders.ts index da76e56..cf90f07 100644 --- a/backend/src/reminders/weightReminders.ts +++ b/backend/src/reminders/weightReminders.ts @@ -6,6 +6,9 @@ export type WeightReminder = { bird_id: string; workspace_id: number; bird_name: string; + species: string; + photo_data_url: string | null; + photo_object_key: string | null; workspace_name: string; activity_at: string; recipient: string; @@ -32,9 +35,10 @@ export const listDueWeightReminders = async () => { AND role IN ('owner', 'assistant', 'caregiver') ) SELECT activity.bird_id, activity.workspace_id, activity.bird_name, activity.workspace_name, - activity.activity_at::text, recipients.recipient + activity.activity_at::text, recipients.recipient, birds.species, birds.photo_data_url, birds.photo_object_key FROM activity JOIN recipients USING (workspace_id) + JOIN birds ON birds.id = activity.bird_id WHERE activity_at <= CURRENT_TIMESTAMP - INTERVAL '48 hours' AND recipients.recipient <> '' AND NOT EXISTS ( diff --git a/backend/test-integration/weightReminders.mjs b/backend/test-integration/weightReminders.mjs index 13e6907..f907213 100644 --- a/backend/test-integration/weightReminders.mjs +++ b/backend/test-integration/weightReminders.mjs @@ -1,6 +1,7 @@ // Run only against disposable local Postgres, Redis, and Mailpit services. // See docs/WEIGHT_REMINDER_TESTING.md for the isolated Compose setup. import assert from 'node:assert/strict'; +import { readFile } from 'node:fs/promises'; import { randomUUID } from 'node:crypto'; import { spawn } from 'node:child_process'; import { once } from 'node:events'; @@ -83,6 +84,8 @@ try { VALUES ($1, $2, $3, 'Cockatiel', CURRENT_TIMESTAMP - INTERVAL '100 hours', ${memorial ? 'CURRENT_TIMESTAMP' : 'NULL'})`, [id, workspace, name]); if (age !== null) await db.query("INSERT INTO weight_records (bird_id, weight_grams, recorded_on, created_at) VALUES ($1, 90, CURRENT_DATE - 3, CURRENT_TIMESTAMP - $2 * INTERVAL '1 hour')", [id, age]); } + const portrait = await readFile(new URL('../assets/yoda.png', import.meta.url)); + await db.query('UPDATE birds SET photo_data_url = $1 WHERE id = $2', [`data:image/png;base64,${portrait.toString('base64')}`, birds['Kiwi & ']]); const due = await listDueWeightReminders(); assert.equal(due.length, 10); assert.deepEqual(new Set(due.map(b => b.recipient)), new Set(['owner@example.test', 'assistant@example.test', 'caregiver@example.test'])); @@ -113,6 +116,11 @@ try { assert.ok(!body.Text.includes('Boundary')); } assert.equal(body.To.length, 1); + const inline = body.Inline ?? []; + assert.ok(inline.some(attachment => attachment.ContentID === 'flockpal-logo')); + assert.equal(inline.filter(attachment => attachment.ContentID.startsWith('weight-bird-')).length, body.Subject === 'Weight reminders for Test Flock' ? 3 : 1); + assert.ok(body.HTML.includes('Daily weight reminder')); + assert.ok(body.HTML.includes('Record their weights')); } assert.equal((await weightReminderQueue.getJobSchedulers()).length, 0); await poll(async () => Boolean(await weightReminderQueue.getJob(`weight-reminders-${getReminderDate()}`)), 'startup daily scheduler'); diff --git a/docs/WEIGHT_REMINDER_TESTING.md b/docs/WEIGHT_REMINDER_TESTING.md index ecbef01..c185a41 100644 --- a/docs/WEIGHT_REMINDER_TESTING.md +++ b/docs/WEIGHT_REMINDER_TESTING.md @@ -28,7 +28,7 @@ these local services. It does not use the application's configured SMTP account. Coverage includes repeatable schema initialization, overdue and recent weights, birds without weights, memorial exclusions, accepted care roles, concurrent -claims, one daily job across two workers, removal of the old five-minute schedule, grouped emails, HTML escaping, flock +claims, one daily job across two workers, removal of the old five-minute schedule, grouped emails, embedded branding and portraits, HTML escaping, flock isolation, daily repeats, fresh weight resets, SMTP failures and recovery, worker shutdown, and disabling the scheduler. Repeat timing is tested by aging delivery timestamps rather than waiting two days. diff --git a/frontend/public/email-background.png b/frontend/public/email-background.png new file mode 100644 index 0000000000000000000000000000000000000000..f3b74ae1a9fd7c68f8fc48b9204978d1831c8bab GIT binary patch literal 242968 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⊀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 Date: Mon, 5 Oct 2026 15:20:00 -0400 Subject: [PATCH 7/8] Added behavior journal, adjusted layout, and added some colors --- README.md | 7 + backend/package-lock.json | 266 +++++++++++++ backend/package.json | 4 + backend/src/app.ts | 356 +++++++----------- backend/src/behaviorSchemas.ts | 40 ++ backend/src/birdMembershipSchemas.ts | 9 + backend/src/db/client.ts | 15 + backend/src/db/schema.ts | 38 +- backend/src/docs/openapi.test.ts | 117 ++++++ backend/src/docs/openapi.ts | 134 +++++++ backend/src/docs/responses.ts | 61 +++ backend/src/docs/router.ts | 24 ++ .../src/repositories/behaviorRepository.ts | 47 +++ .../repositories/birdMembershipRepository.ts | 50 +++ backend/src/repositories/birdRepository.ts | 12 - backend/src/schemas.ts | 211 +++++++++++ backend/src/scripts/migrateBirdPhotosToS3.ts | 2 +- backend/src/storage/imageStorageConfig.ts | 4 +- backend/src/types.ts | 7 +- backend/test-integration/behaviorJournal.mjs | 94 +++++ backend/test-integration/birdMembership.mjs | 116 ++++++ docs/API_REFERENCE.md | 47 ++- docs/BEHAVIOR_JOURNAL.md | 68 ++++ docs/BIRD_MEMBERSHIP.md | 50 +++ frontend/index.html | 1 + frontend/src/App.tsx | 154 ++++++-- frontend/src/BehaviorJournal.tsx | 132 +++++++ frontend/src/behaviorJournal.css | 24 ++ frontend/src/index.css | 91 ++++- frontend/test-integration/behaviorJournal.mjs | 138 +++++++ frontend/test-integration/birdMembership.mjs | 91 +++++ 31 files changed, 2135 insertions(+), 275 deletions(-) create mode 100644 backend/src/behaviorSchemas.ts create mode 100644 backend/src/birdMembershipSchemas.ts create mode 100644 backend/src/docs/openapi.test.ts create mode 100644 backend/src/docs/openapi.ts create mode 100644 backend/src/docs/responses.ts create mode 100644 backend/src/docs/router.ts create mode 100644 backend/src/repositories/behaviorRepository.ts create mode 100644 backend/src/repositories/birdMembershipRepository.ts create mode 100644 backend/src/schemas.ts create mode 100644 backend/test-integration/behaviorJournal.mjs create mode 100644 backend/test-integration/birdMembership.mjs create mode 100644 docs/BEHAVIOR_JOURNAL.md create mode 100644 docs/BIRD_MEMBERSHIP.md create mode 100644 frontend/src/BehaviorJournal.tsx create mode 100644 frontend/src/behaviorJournal.css create mode 100644 frontend/test-integration/behaviorJournal.mjs create mode 100644 frontend/test-integration/birdMembership.mjs diff --git a/README.md b/README.md index 4a5e872..7127419 100644 --- a/README.md +++ b/README.md @@ -272,3 +272,10 @@ This starter now includes the account and flock foundation for monetization, plu Stripe billing should be attached to `workspaces`, not `users`. Each flock has its own billing plan, subscription status, Stripe customer ID, and Stripe subscription ID, which lets one person own multiple household flocks with separate subscriptions while rescue flocks can stay on the free rescue path. For account design, `standard` vs `rescue` is best treated as a flock type, not as a user role. If paid plans are added later, a separate `admin account mode` is usually less flexible than flock roles such as `owner`, `assistant`, `caregiver`, and `viewer`. That lets the same underlying account system work for both households and rescues without splitting product logic into unrelated account classes. + +## Customer API documentation + +Open `/api/docs/` on your FlockPal instance for the interactive integration API reference, +or download `/api/openapi.json`. Locally, use `http://localhost:5000/api/docs/`. +Create a token in Settings → Integration tokens and use **Authorize** to try requests. +See [the API reference](docs/API_REFERENCE.md) for details. diff --git a/backend/package-lock.json b/backend/package-lock.json index 361494d..a4e1e94 100644 --- a/backend/package-lock.json +++ b/backend/package-lock.json @@ -8,6 +8,7 @@ "name": "flockpal-backend", "version": "0.1.0", "dependencies": { + "@asteasolutions/zod-to-openapi": "7.3.4", "@types/nodemailer": "^8.0.0", "bullmq": "^5.76.4", "cors": "2.8.5", @@ -22,9 +23,11 @@ "qrcode": "^1.5.4", "sharp": "^0.34.5", "stripe": "^22.0.2", + "swagger-ui-express": "5.0.1", "zod": "3.24.1" }, "devDependencies": { + "@apidevtools/swagger-parser": "13.1.0", "@types/cors": "2.8.17", "@types/express": "4.17.21", "@types/morgan": "1.9.9", @@ -32,10 +35,79 @@ "@types/pdfkit": "^0.17.6", "@types/pg": "8.11.10", "@types/qrcode": "^1.5.6", + "@types/swagger-ui-express": "4.1.8", "tsx": "4.19.2", "typescript": "5.7.2" } }, + "node_modules/@apidevtools/json-schema-ref-parser": { + "version": "16.0.3", + "resolved": "https://registry.npmjs.org/@apidevtools/json-schema-ref-parser/-/json-schema-ref-parser-16.0.3.tgz", + "integrity": "sha512-7lZp4XCTZhU/AgiGpIG+j4uJeWPdGbpQ+8wqXrzuHy+tboKsjSacjGH9/kNThRDIFhMWHF3ba+ejS8J3PeSI1Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "js-yaml": "^5.4.2", + "undici": "^8.10.2" + }, + "engines": { + "node": ">=22.19.0" + }, + "peerDependencies": { + "@types/json-schema": "^7.0.15" + } + }, + "node_modules/@apidevtools/openapi-schemas": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/@apidevtools/openapi-schemas/-/openapi-schemas-2.1.0.tgz", + "integrity": "sha512-Zc1AlqrJlX3SlpupFGpiLi2EbteyP7fXmUOGup6/DnkRgjP9bgMM/ag+n91rsv0U1Gpz0H3VILA/o3bW7Ua6BQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + } + }, + "node_modules/@apidevtools/swagger-methods": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/@apidevtools/swagger-methods/-/swagger-methods-3.0.2.tgz", + "integrity": "sha512-QAkD5kK2b1WfjDS/UQn/qQkbwF31uqRjPTrsCs5ZG9BQGAkjwvqGFjjPqAuzac/IYzpPtRzjCP1WrTuAIjMrXg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@apidevtools/swagger-parser": { + "version": "13.1.0", + "resolved": "https://registry.npmjs.org/@apidevtools/swagger-parser/-/swagger-parser-13.1.0.tgz", + "integrity": "sha512-dkCuqCWh5U7u0aurmmc/qvel2KeKDxHTwVtUdYonndIpD7mXV6AVaWNdvaja2HAy628z7FT/Qdz8sCgzwhgwKg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@apidevtools/json-schema-ref-parser": "^16.0.3", + "@apidevtools/openapi-schemas": "^2.1.0", + "@apidevtools/swagger-methods": "^3.0.2", + "@types/json-schema": "^7.0.15", + "ajv": "^8.20.0", + "ajv-draft-04": "^1.0.0", + "call-me-maybe": "^1.0.2" + }, + "engines": { + "node": ">=22.19.0" + }, + "peerDependencies": { + "openapi-types": ">=7" + } + }, + "node_modules/@asteasolutions/zod-to-openapi": { + "version": "7.3.4", + "resolved": "https://registry.npmjs.org/@asteasolutions/zod-to-openapi/-/zod-to-openapi-7.3.4.tgz", + "integrity": "sha512-/2rThQ5zPi9OzVwes6U7lK1+Yvug0iXu25olp7S0XsYmOqnyMfxH7gdSQjn/+DSOHRg7wnotwGJSyL+fBKdnEA==", + "license": "MIT", + "dependencies": { + "openapi3-ts": "^4.1.2" + }, + "peerDependencies": { + "zod": "^3.20.2" + } + }, "node_modules/@emnapi/runtime": { "version": "1.10.0", "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.10.0.tgz", @@ -1027,6 +1099,13 @@ "url": "https://paulmillr.com/funding/" } }, + "node_modules/@scarf/scarf": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/@scarf/scarf/-/scarf-1.4.0.tgz", + "integrity": "sha512-xxeapPiUXdZAE3che6f3xogoJPeZgig6omHEy1rIY5WVsB3H2BHNnZH+gHG6x91SCWyQCzWGsuL2Hh3ClO5/qQ==", + "hasInstallScript": true, + "license": "Apache-2.0" + }, "node_modules/@swc/helpers": { "version": "0.5.23", "resolved": "https://registry.npmjs.org/@swc/helpers/-/helpers-0.5.23.tgz", @@ -1100,6 +1179,13 @@ "dev": true, "license": "MIT" }, + "node_modules/@types/json-schema": { + "version": "7.0.15", + "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz", + "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==", + "dev": true, + "license": "MIT" + }, "node_modules/@types/morgan": { "version": "1.9.9", "resolved": "https://registry.npmjs.org/@types/morgan/-/morgan-1.9.9.tgz", @@ -1195,6 +1281,17 @@ "@types/node": "*" } }, + "node_modules/@types/swagger-ui-express": { + "version": "4.1.8", + "resolved": "https://registry.npmjs.org/@types/swagger-ui-express/-/swagger-ui-express-4.1.8.tgz", + "integrity": "sha512-AhZV8/EIreHFmBV5wAs0gzJUNq9JbbSXgJLQubCC0jtIo6prnI9MIRRxnU4MZX9RB9yXxF1V4R7jtLl/Wcj31g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/express": "*", + "@types/serve-static": "*" + } + }, "node_modules/accepts": { "version": "1.3.8", "resolved": "https://registry.npmjs.org/accepts/-/accepts-1.3.8.tgz", @@ -1208,6 +1305,38 @@ "node": ">= 0.6" } }, + "node_modules/ajv": { + "version": "8.20.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz", + "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==", + "dev": true, + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.3", + "fast-uri": "^3.0.1", + "json-schema-traverse": "^1.0.0", + "require-from-string": "^2.0.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/ajv-draft-04": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/ajv-draft-04/-/ajv-draft-04-1.0.0.tgz", + "integrity": "sha512-mv00Te6nmYbRp5DCwclxtt7yV/joXJPGS7nM+97GdxvuttCOfgI3K4U25zboyeX0O+myI8ERluxQe5wljMmVIw==", + "dev": true, + "license": "MIT", + "peerDependencies": { + "ajv": "^8.5.0" + }, + "peerDependenciesMeta": { + "ajv": { + "optional": true + } + } + }, "node_modules/ansi-regex": { "version": "5.0.1", "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", @@ -1232,6 +1361,13 @@ "url": "https://github.com/chalk/ansi-styles?sponsor=1" } }, + "node_modules/argparse": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", + "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", + "dev": true, + "license": "Python-2.0" + }, "node_modules/array-flatten": { "version": "1.1.1", "resolved": "https://registry.npmjs.org/array-flatten/-/array-flatten-1.1.1.tgz", @@ -1373,6 +1509,13 @@ "url": "https://github.com/sponsors/ljharb" } }, + "node_modules/call-me-maybe": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/call-me-maybe/-/call-me-maybe-1.0.2.tgz", + "integrity": "sha512-HpX65o1Hnr9HH25ojC1YGs7HCQLq0GCOibSaWER0eNpgJ/Z1MZv2mTc7+xh6WOPxbRVcmgbv4hGU+uSQ/2xFZQ==", + "dev": true, + "license": "MIT" + }, "node_modules/camelcase": { "version": "5.3.1", "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-5.3.1.tgz", @@ -1756,6 +1899,23 @@ "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==", "license": "MIT" }, + "node_modules/fast-uri": { + "version": "3.1.8", + "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.8.tgz", + "integrity": "sha512-GZMtZUTNRpOVIECoXwLNZS5xUGE+mVNbTB8h/7Rwh2TFWcBQiPzTgyZi05BF9UMZKkLJv8XBRJTlU7zg8+ZfMg==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "BSD-3-Clause" + }, "node_modules/finalhandler": { "version": "1.3.1", "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-1.3.1.tgz", @@ -2055,6 +2215,36 @@ "integrity": "sha512-qR0HB5uP6wCuRMrWPTrkMaev7MJZwJuuw4fnwAzRgP4J4/F8RwtodOKpGp4XpqsLBFzzgqIO42efFAyz2Et6KQ==", "license": "MIT" }, + "node_modules/js-yaml": { + "version": "5.4.2", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-5.4.2.tgz", + "integrity": "sha512-m+aqu+LwO1O6sIopafj8HUVl5aawITwZQe/yHpMCKjaWBaA/d07B/QdMb3529REftiU+RMMHL3Vlsw3hON7vWg==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/puzrin" + }, + { + "type": "github", + "url": "https://github.com/sponsors/nodeca" + } + ], + "license": "MIT", + "dependencies": { + "argparse": "^2.0.1" + }, + "bin": { + "js-yaml": "bin/js-yaml.mjs" + } + }, + "node_modules/json-schema-traverse": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz", + "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==", + "dev": true, + "license": "MIT" + }, "node_modules/linebreak": { "version": "1.1.0", "resolved": "https://registry.npmjs.org/linebreak/-/linebreak-1.1.0.tgz", @@ -2329,6 +2519,23 @@ "node": ">= 0.8" } }, + "node_modules/openapi-types": { + "version": "12.1.3", + "resolved": "https://registry.npmjs.org/openapi-types/-/openapi-types-12.1.3.tgz", + "integrity": "sha512-N4YtSYJqghVu4iek2ZUvcN/0aqH1kRDuNqzcycDxhOUpg7GdvLa2F3DgS6yBNhInhv2r/6I0Flkn7CqL8+nIcw==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/openapi3-ts": { + "version": "4.6.1", + "resolved": "https://registry.npmjs.org/openapi3-ts/-/openapi3-ts-4.6.1.tgz", + "integrity": "sha512-XW9MOldkhoICNeXVzzmXzmOW5G73ppOEGmh7fLCqHjgfdEYCGGN+00MlVCeUZgovjjfC56j9tvtDt1zGabNjjA==", + "license": "MIT", + "dependencies": { + "yaml": "^2.9.0" + } + }, "node_modules/p-limit": { "version": "2.3.0", "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz", @@ -2732,6 +2939,16 @@ "node": ">=0.10.0" } }, + "node_modules/require-from-string": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz", + "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/require-main-filename": { "version": "2.0.0", "resolved": "https://registry.npmjs.org/require-main-filename/-/require-main-filename-2.0.0.tgz", @@ -3041,6 +3258,30 @@ } } }, + "node_modules/swagger-ui-dist": { + "version": "5.33.0", + "resolved": "https://registry.npmjs.org/swagger-ui-dist/-/swagger-ui-dist-5.33.0.tgz", + "integrity": "sha512-wpdK+m6BU5yj6pmUdMskZVTSWYG4DLglAx3sIhylloY37i8O37IrH+YEpqdXNfpaTGxILRBFzUqLF2jKqbfI7A==", + "license": "Apache-2.0", + "dependencies": { + "@scarf/scarf": "=1.4.0" + } + }, + "node_modules/swagger-ui-express": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/swagger-ui-express/-/swagger-ui-express-5.0.1.tgz", + "integrity": "sha512-SrNU3RiBGTLLmFU8GIJdOdanJTl4TOmT27tt3bWWHppqYmAZ6IDuEuBvMU6nZq0zLEe6b/1rACXCgLZqO6ZfrA==", + "license": "MIT", + "dependencies": { + "swagger-ui-dist": ">=5.0.0" + }, + "engines": { + "node": ">= v0.10.32" + }, + "peerDependencies": { + "express": ">=4.0.0 || >=5.0.0-beta" + } + }, "node_modules/tiny-inflate": { "version": "1.0.3", "resolved": "https://registry.npmjs.org/tiny-inflate/-/tiny-inflate-1.0.3.tgz", @@ -3109,6 +3350,16 @@ "node": ">=14.17" } }, + "node_modules/undici": { + "version": "8.11.2", + "resolved": "https://registry.npmjs.org/undici/-/undici-8.11.2.tgz", + "integrity": "sha512-u4UB2/IrKdU6lFxumHmmo1a3fCQO5tzQllRorfoRS63txhrB7xTpSn1PftwC4qEHkOaqP95fCWW4lJzwErwzhQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=22.19.0" + } + }, "node_modules/undici-types": { "version": "6.20.0", "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.20.0.tgz", @@ -3203,6 +3454,21 @@ "integrity": "sha512-JKhqTOwSrqNA1NY5lSztJ1GrBiUodLMmIZuLiDaMRJ+itFd+ABVE8XBjOvIWL+rSqNDC74LCSFmlb/U4UZ4hJQ==", "license": "ISC" }, + "node_modules/yaml": { + "version": "2.9.1", + "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.9.1.tgz", + "integrity": "sha512-3NxN8+78OdzbT7C/WjGsyfPAtJaN3FNDsWxv7Y7mcDsT/oOmgW8BpyQQFFBnvZE3j9Y2Sdz1ULFLezL7Eb2yFw==", + "license": "ISC", + "bin": { + "yaml": "bin.mjs" + }, + "engines": { + "node": ">= 14.6" + }, + "funding": { + "url": "https://github.com/sponsors/eemeli" + } + }, "node_modules/yargs": { "version": "15.4.1", "resolved": "https://registry.npmjs.org/yargs/-/yargs-15.4.1.tgz", diff --git a/backend/package.json b/backend/package.json index d904c9d..b00703f 100644 --- a/backend/package.json +++ b/backend/package.json @@ -14,6 +14,7 @@ "worker": "node dist/worker.js" }, "dependencies": { + "@asteasolutions/zod-to-openapi": "7.3.4", "@types/nodemailer": "^8.0.0", "bullmq": "^5.76.4", "cors": "2.8.5", @@ -28,9 +29,11 @@ "qrcode": "^1.5.4", "sharp": "^0.34.5", "stripe": "^22.0.2", + "swagger-ui-express": "5.0.1", "zod": "3.24.1" }, "devDependencies": { + "@apidevtools/swagger-parser": "13.1.0", "@types/cors": "2.8.17", "@types/express": "4.17.21", "@types/morgan": "1.9.9", @@ -38,6 +41,7 @@ "@types/pdfkit": "^0.17.6", "@types/pg": "8.11.10", "@types/qrcode": "^1.5.6", + "@types/swagger-ui-express": "4.1.8", "tsx": "4.19.2", "typescript": "5.7.2" } diff --git a/backend/src/app.ts b/backend/src/app.ts index 959d9d2..f542d76 100644 --- a/backend/src/app.ts +++ b/backend/src/app.ts @@ -1,3 +1,43 @@ +import { unassignedBirdMatchSchema, claimBirdSchema } from './birdMembershipSchemas.js'; +import { hasUnassignedBird, removeBirdFromFlock, claimUnassignedBird } from './repositories/birdMembershipRepository.js'; +import { behaviorTypeSchema, behaviorOccurrenceSchema, behaviorRangeSchema } from './behaviorSchemas.js'; +import { listBehaviorTypes, createBehaviorType, listBehaviorOccurrences, saveBehaviorOccurrence, deleteBehaviorOccurrence } from './repositories/behaviorRepository.js'; +import { + dateStringSchema, + chartColorSchema, + photoDataUrlSchema, + photoUrlSchema, + magicLinkRequestSchema, + switchWorkspaceSchema, + workspaceTypeSchema, + workspaceRoleSchema, + billingPlanSchema, + billingIntervalSchema, + integrationTokenScopeSchema, + birdGenderSchema, + rescueVerificationStatusSchema, + rescueOnboardingSchema, + workspaceSchema, + createWorkspaceSchema, + workspaceMemberSchema, + flockTransferSchema, + lostBirdReportSchema, + publicProfileCodeSchema, + birdTransferCodeSchema, + birdProfileListSchema, + verifiedLocationDetailsSchema, + locationSearchSchema, + birdSchema, + memorializeBirdSchema, + memorialReminderPreferenceSchema, + birdTimelineEventSchema, + weightSchema, + vetVisitSchema, + medicationSchema, + medicationAdministrationSchema, + flockNoteSchema, +} from './schemas.js'; +import { mountApiDocs } from './docs/router.js'; import { buildEmailLayout } from './emails/emailLayout.js'; import { buildWeightReminderEmail } from './emails/weightReminderEmail.js'; import type { WeightReminder } from './reminders/weightReminders.js'; @@ -48,7 +88,6 @@ import { findBirdsByBandId, createVetVisitForBird, createWeightForBird, - deleteBird, deleteMedicationForBird, deleteVetVisitForBird, getBirdById, @@ -207,163 +246,6 @@ const allowedOrigins = Array.from( ), ); -const dateStringSchema = z.string().regex(/^\d{4}-\d{2}-\d{2}$/); -const chartColorSchema = z.string().regex(/^#[0-9a-fA-F]{6}$/); -const photoDataUrlSchema = z - .string() - .regex(/^data:image\/(?:png|jpeg|jpg|webp|gif);base64,[A-Za-z0-9+/=]+$/) - .max(1_500_000); -const photoUrlSchema = z.string().trim().url().max(2000); - -const magicLinkRequestSchema = z.object({ - name: z.string().trim().max(160).optional().or(z.literal('')), - email: z.string().trim().email().max(255), - redirectTo: z.string().trim().url().max(2000).optional().or(z.literal('')), -}); - -const switchWorkspaceSchema = z.object({ - workspaceId: z.coerce.number().int().positive(), -}); - -const workspaceTypeSchema = z.enum(['standard', 'rescue']); -const workspaceRoleSchema = z.enum(['owner', 'assistant', 'caregiver', 'viewer']); -const billingPlanSchema = z.enum(['household_basic', 'household_plus', 'household_macaw', 'household_hyacinth_macaw']); -const billingIntervalSchema = z.enum(['monthly', 'yearly']); -const integrationTokenScopeSchema = z.enum(['read_only', 'read_write']); -const birdGenderSchema = z.enum(['unknown', 'male', 'female', 'male_dna', 'female_dna']); -const rescueVerificationStatusSchema = z.enum(['pending', 'approved', 'rejected']); -const rescueOnboardingSchema = z.object({ - name: z.string().trim().max(160).optional().or(z.literal('')), - city: z.string().trim().max(120).optional().or(z.literal('')), - state: z.string().trim().max(80).optional().or(z.literal('')), - ein: z.string().trim().max(32).optional().or(z.literal('')), - website: z.string().trim().url().max(2000).optional().or(z.literal('')), -}); - -const workspaceSchema = z.object({ - name: z.string().trim().min(1).max(160), - workspaceType: workspaceTypeSchema, - billingEmail: z.string().trim().email().max(255).optional().or(z.literal('')), - billingPlan: billingPlanSchema.optional(), - billingInterval: billingIntervalSchema.optional(), - rescueOnboarding: rescueOnboardingSchema.optional(), -}); - -const createWorkspaceSchema = z.object({ - name: z.string().trim().min(1).max(160), - workspaceType: workspaceTypeSchema, - billingEmail: z.string().trim().email().max(255).optional().or(z.literal('')), - billingPlan: billingPlanSchema.optional(), - billingInterval: billingIntervalSchema.optional(), - rescueOnboarding: rescueOnboardingSchema.optional(), -}); - -const workspaceMemberSchema = z.object({ - name: z.string().trim().min(1).max(160), - email: z.string().trim().email().max(255), - role: workspaceRoleSchema, -}); - -const flockTransferSchema = z.object({ - destinationOwnerEmail: z.string().trim().email().max(255), -}); - -const lostBirdReportSchema = z.object({ - tagId: z.string().trim().min(1).max(80), - finderName: z.string().trim().max(160).optional().or(z.literal('')), - finderEmail: z.string().trim().email().max(255).optional().or(z.literal('')), - foundLocation: z.string().trim().max(255).optional().or(z.literal('')), - message: z.string().trim().max(1000).optional().or(z.literal('')), -}); - -const publicProfileCodeSchema = z.string().trim().regex(/^[A-Za-z0-9_-]{8,32}$/); -const birdTransferCodeSchema = z.string().trim().regex(/^[A-Za-z0-9_-]{12,32}$/); -const birdProfileListSchema = z - .string() - .trim() - .max(1000) - .refine( - (value) => value.split(/\r?\n/).map((item) => item.trim()).filter(Boolean).length <= 3, - 'Use no more than three list items.', - ) - .optional() - .or(z.literal('')); - -const verifiedLocationDetailsSchema = z - .object({ - label: z.string().trim().max(220).optional().or(z.literal('')), - city: z.string().trim().max(120).optional().or(z.literal('')), - region: z.string().trim().max(120).optional().or(z.literal('')), - country: z.string().trim().max(120).optional().or(z.literal('')), - countryCode: z.string().trim().max(2).optional().or(z.literal('')), - latitude: z.coerce.number().min(-90).max(90).optional().nullable().or(z.literal('')), - longitude: z.coerce.number().min(-180).max(180).optional().nullable().or(z.literal('')), - precision: z.enum(['city', 'region', 'country']).optional(), - provider: z.literal('mapbox').optional().nullable(), - providerPlaceId: z.string().trim().max(220).optional().or(z.literal('')), - }) - .optional() - .nullable(); - -const locationSearchSchema = z.object({ - q: z.string().trim().min(3).max(120), -}); - -const birdSchema = z.object({ - name: z.string().trim().min(1).max(120), - tagId: z.string().trim().max(80).optional().or(z.literal('')), - species: z.string().trim().min(1).max(120), - motivators: birdProfileListSchema, - demotivators: birdProfileListSchema, - favoriteSnack: z.string().trim().max(160).optional().or(z.literal('')), - locationLabel: z.string().trim().max(160).optional().or(z.literal('')), - locationDetails: verifiedLocationDetailsSchema, - vetClinicName: z.string().trim().max(160).optional().or(z.literal('')), - vetClinicAddress: z.string().trim().max(500).optional().or(z.literal('')), - vetAccountNumber: z.string().trim().max(120).optional().or(z.literal('')), - vetDoctorName: z.string().trim().max(160).optional().or(z.literal('')), - gender: birdGenderSchema.optional(), - hatchDay: dateStringSchema.optional().or(z.literal('')), - dateOfBirth: dateStringSchema.optional().or(z.literal('')), - gotchaDay: dateStringSchema.optional().or(z.literal('')), - chartColor: chartColorSchema.optional(), - photoDataUrl: z.union([photoDataUrlSchema, photoUrlSchema, z.literal('')]).optional(), - notifyOnDob: z.boolean().optional(), - notifyOnGotchaDay: z.boolean().optional(), - publicProfileEnabled: z.boolean().optional(), -}); - -const memorializeBirdSchema = z.object({ - memorializedOn: dateStringSchema, - memorialNote: z.string().trim().max(1000).optional().or(z.literal('')), - notifyOnMemorialDay: z.boolean().optional(), -}); - -const memorialReminderPreferenceSchema = z.object({ - notifyOnMemorialDay: z.boolean(), -}); - -const birdTimelineEventSchema = z - .object({ - eventType: z.enum(['location_updated', 'owner_changed', 'manual_note']), - eventDate: dateStringSchema.optional().or(z.literal('')), - locationLabel: z.string().trim().max(160).optional().or(z.literal('')), - locationDetails: verifiedLocationDetailsSchema, - note: z.string().trim().max(500).optional().or(z.literal('')), - }) - .refine( - (value) => - value.eventType === 'owner_changed' || - Boolean( - value.locationLabel?.trim() || - value.note?.trim() || - value.locationDetails?.city?.trim() || - value.locationDetails?.region?.trim() || - value.locationDetails?.country?.trim(), - ), - 'Add a location or note for this timeline item.', - ); - type VerifiedLocationDetailsInput = z.infer; const normalizeVerifiedLocationDetails = (value: VerifiedLocationDetailsInput) => { @@ -483,57 +365,6 @@ const normalizeMapboxLocationFeature = (feature: MapboxGeocodeFeature): Verified }); }; -const weightSchema = z.object({ - weightGrams: z.coerce.number().positive().max(10000), - recordedOn: dateStringSchema, - notes: z.string().trim().max(280).optional().or(z.literal('')), -}); - -const vetVisitSchema = z.object({ - visitedOn: dateStringSchema, - clinicName: z.string().trim().min(1).max(160), - reason: z.string().trim().min(1).max(160), - notes: z.string().trim().max(1000).optional().or(z.literal('')), -}); - -const medicationSchema = z - .object({ - name: z.string().trim().min(1).max(160), - dosage: z.string().trim().min(1).max(160), - frequency: z.enum(['once_daily', 'twice_daily', 'every_8_hours', 'every_6_hours', 'as_needed']), - doseSchedule: z - .array( - z.object({ - key: z.string().trim().min(1).max(80), - label: z.string().trim().min(1).max(80), - time: z.string().trim().regex(/^$|^\d{2}:\d{2}$/), - }), - ) - .min(1) - .max(8), - route: z.string().trim().max(80).optional().or(z.literal('')), - startDate: dateStringSchema, - endDate: dateStringSchema.optional().or(z.literal('')), - notes: z.string().trim().max(1000).optional().or(z.literal('')), - remindersEnabled: z.boolean().optional(), - }) - .refine((value) => !value.endDate || value.endDate >= value.startDate, { - message: 'End date must be on or after start date.', - path: ['endDate'], - }); - -const medicationAdministrationSchema = z.object({ - administeredOn: dateStringSchema, - administrationSlot: z.string().trim().min(1).max(80).default('dose-1'), - status: z.enum(['administered', 'missed']), - notes: z.string().trim().max(500).optional().or(z.literal('')), -}); - -const flockNoteSchema = z.object({ - birdId: z.string().uuid().optional().nullable().or(z.literal('')), - body: z.string().trim().min(1).max(5000), -}); - const integrationTokenCreateSchema = z.object({ name: z.string().trim().min(1).max(160), scope: integrationTokenScopeSchema.default('read_write'), @@ -1035,6 +866,7 @@ const oauthProviders = { }; app.disable('x-powered-by'); +mountApiDocs(app); app.use(helmet({ crossOriginResourcePolicy: false })); app.use( cors({ @@ -3694,6 +3526,27 @@ app.get('/api/locations/search', requireAuth, locationSearchLimiter, async (req: } }); +app.get('/api/birds/unassigned-match', requireAuth, requireWorkspaceRole(['owner', 'assistant', 'caregiver']), async (req: Request, res: Response, next: NextFunction) => { + const parsed = unassignedBirdMatchSchema.safeParse(req.query); + if (!parsed.success) { res.status(400).json({ error: 'Enter a known band ID.' }); return; } + try { + res.json({ available: await hasUnassignedBird(parsed.data.tagId) }); + } catch (error) { next(error); } +}); + +app.post('/api/birds/claim', requireAuth, requireWriteAccess, requireWorkspaceRole(['owner', 'assistant', 'caregiver']), async (req: Request, res: Response, next: NextFunction) => { + const parsed = claimBirdSchema.safeParse(req.body); + if (!parsed.success) { res.status(400).json({ error: 'A known band ID and confirmation to bring in existing history are required.' }); return; } + try { + const birdId = await claimUnassignedBird(parsed.data.tagId, req.auth!.workspace.id, req.auth!.user.id); + if (!birdId) { res.status(409).json({ error: 'No unassigned bird is available with that band ID. It may already have joined a flock.' }); return; } + const bird = await getBirdById(birdId, req.auth!.workspace.id); + if (!bird) { res.status(409).json({ error: 'The bird is no longer in this flock. Refresh the flock to continue.' }); return; } + await writeAuditLog(req.auth!, 'bird.claimed', 'bird', bird.id, bird.name, { tagId: bird.tag_id }); + res.status(200).json({ bird: normalizeBird(bird), historyImported: true }); + } catch (error) { next(error); } +}); + app.get('/api/birds', requireAuth, async (req: Request, res: Response, next: NextFunction) => { try { const [birds, memorializedBirds] = await Promise.all([ @@ -3842,6 +3695,11 @@ app.post('/api/birds', requireAuth, requireWriteAccess, requireWorkspaceRole(['o let uploadedObjectKeyToCleanup: string | null = null; try { + const tagId = normalizeBandId(parsed.data.tagId); + if (tagId && await hasUnassignedBird(tagId)) { + res.status(409).json({ code: 'bird_history_available', error: 'An unassigned bird has this band ID. Confirm adding the existing bird with its history instead of creating a new profile.' }); + return; + } const birdId = crypto.randomUUID(); const photoStorage = await resolveBirdPhotoStorage({ birdId, @@ -4298,16 +4156,15 @@ app.delete('/api/birds/:birdId', requireAuth, requireWriteAccess, requireWorkspa return; } - const deleted = await deleteBird(req.params.birdId, req.auth!.workspace.id); + const removed = await removeBirdFromFlock(req.params.birdId, req.auth!.workspace.id, req.auth!.user.id); - if (!deleted) { - res.status(404).json({ error: 'Bird not found.' }); + if (!removed) { + res.status(404).json({ error: 'Bird not found or no longer removable.' }); return; } - await writeAuditLog(req.auth!, 'bird.deleted', 'bird', bird.id, bird.name); + await writeAuditLog(req.auth!, 'bird.removed_from_flock', 'bird', bird.id, bird.name); res.status(204).send(); - await deleteBirdPhotoObjectIfNeeded(bird.photo_object_key); } catch (error) { next(error); } @@ -4384,6 +4241,77 @@ app.patch('/api/birds/:birdId/memorial-reminders', requireAuth, requireWriteAcce } }); +// Behavior types are flock-scoped; occurrences follow their bird across flock transfers. +app.get('/api/birds/:birdId/behavior-types', requireAuth, async (req: Request, res: Response, next: NextFunction) => { + try { + if (!z.string().uuid().safeParse(req.params.birdId).success) { res.status(400).json({ error: 'Invalid bird ID.' }); return; } + const bird = await getBirdById(req.params.birdId, req.auth!.workspace.id); + if (!bird) { res.status(404).json({ error: 'Bird not found.' }); return; } + res.json({ behaviorTypes: await listBehaviorTypes(req.auth!.workspace.id, bird.id) }); + } catch (error) { next(error); } +}); +app.post('/api/birds/:birdId/behavior-types', requireAuth, requireWriteAccess, requireWorkspaceRole(['owner', 'assistant', 'caregiver']), async (req: Request, res: Response, next: NextFunction) => { + const parsed = behaviorTypeSchema.safeParse(req.body); + if (!parsed.success || !z.string().uuid().safeParse(req.params.birdId).success) { res.status(400).json({ error: 'Invalid behavior type payload.' }); return; } + try { + const bird = await getBirdById(req.params.birdId, req.auth!.workspace.id); + if (!bird) { res.status(404).json({ error: 'Bird not found.' }); return; } + if (!ensureBirdWritable(bird, res)) return; + const behaviorType = await createBehaviorType(req.auth!.workspace.id, parsed.data.name, parsed.data.description); + await writeAuditLog(req.auth!, 'behavior_type.created', 'behavior_type', behaviorType.id, parsed.data.name); + res.status(201).json({ behaviorType }); + } catch (error) { next(error); } +}); +app.get('/api/birds/:birdId/behaviors', requireAuth, async (req: Request, res: Response, next: NextFunction) => { + const parsed = behaviorRangeSchema.safeParse(req.query); + if (!parsed.success || !z.string().uuid().safeParse(req.params.birdId).success) { res.status(400).json({ error: 'Invalid behavior date range or bird ID.' }); return; } + try { + const bird = await getBirdById(req.params.birdId, req.auth!.workspace.id); + if (!bird) { res.status(404).json({ error: 'Bird not found.' }); return; } + res.json({ occurrences: await listBehaviorOccurrences(bird.id, req.auth!.workspace.id, parsed.data.from, parsed.data.to, parsed.data.behaviorTypeId) }); + } catch (error) { next(error); } +}); +app.post('/api/birds/:birdId/behaviors', requireAuth, requireWriteAccess, requireWorkspaceRole(['owner', 'assistant', 'caregiver']), async (req: Request, res: Response, next: NextFunction) => { + if (!z.string().uuid().safeParse(req.params.birdId).success) { res.status(400).json({ error: 'Invalid ID.' }); return; } + const parsed = behaviorOccurrenceSchema.safeParse(req.body); + if (!parsed.success) { res.status(400).json({ error: 'Invalid behavior payload.', details: parsed.error.flatten() }); return; } + try { + const bird = await getBirdById(req.params.birdId, req.auth!.workspace.id); + if (!bird) { res.status(404).json({ error: 'Bird not found.' }); return; } + if (!ensureBirdWritable(bird, res)) return; + const occurrence = await saveBehaviorOccurrence(bird.id, req.auth!.workspace.id, parsed.data); + if (!occurrence) { res.status(404).json({ error: 'Occurrence or behavior type not found, or bird is no longer editable.' }); return; } + await writeAuditLog(req.auth!, 'behavior.created', 'behavior_occurrence', occurrence.id, bird.name, { birdId: bird.id }); + res.status(201).json({ occurrence }); + } catch (error) { next(error); } +}); +app.put('/api/birds/:birdId/behaviors/:occurrenceId', requireAuth, requireWriteAccess, requireWorkspaceRole(['owner', 'assistant', 'caregiver']), async (req: Request, res: Response, next: NextFunction) => { + if (!z.string().uuid().safeParse(req.params.birdId).success || !z.string().uuid().safeParse(req.params.occurrenceId).success) { res.status(400).json({ error: 'Invalid ID.' }); return; } + const parsed = behaviorOccurrenceSchema.safeParse(req.body); + if (!parsed.success) { res.status(400).json({ error: 'Invalid behavior payload.', details: parsed.error.flatten() }); return; } + try { + const bird = await getBirdById(req.params.birdId, req.auth!.workspace.id); + if (!bird) { res.status(404).json({ error: 'Bird not found.' }); return; } + if (!ensureBirdWritable(bird, res)) return; + const occurrence = await saveBehaviorOccurrence(bird.id, req.auth!.workspace.id, parsed.data, req.params.occurrenceId); + if (!occurrence) { res.status(404).json({ error: 'Occurrence or behavior type not found, or bird is no longer editable.' }); return; } + await writeAuditLog(req.auth!, 'behavior.updated', 'behavior_occurrence', occurrence.id, bird.name, { birdId: bird.id }); + res.status(200).json({ occurrence }); + } catch (error) { next(error); } +}); +app.delete('/api/birds/:birdId/behaviors/:occurrenceId', requireAuth, requireWriteAccess, requireWorkspaceRole(['owner', 'assistant', 'caregiver']), async (req: Request, res: Response, next: NextFunction) => { + if (!z.string().uuid().safeParse(req.params.birdId).success || !z.string().uuid().safeParse(req.params.occurrenceId).success) { res.status(400).json({ error: 'Invalid ID.' }); return; } + try { + const bird = await getBirdById(req.params.birdId, req.auth!.workspace.id); + if (!bird) { res.status(404).json({ error: 'Bird not found.' }); return; } + if (!ensureBirdWritable(bird, res)) return; + const occurrence = await deleteBehaviorOccurrence(bird.id, req.auth!.workspace.id, req.params.occurrenceId); + if (!occurrence) { res.status(404).json({ error: 'Occurrence or behavior type not found, or bird is no longer editable.' }); return; } + await writeAuditLog(req.auth!, 'behavior.deleted', 'behavior_occurrence', occurrence.id, bird.name, { birdId: bird.id }); + res.status(204).send(); + } catch (error) { next(error); } +}); + app.get('/api/birds/:birdId/weights', requireAuth, async (req: Request, res: Response, next: NextFunction) => { try { const days = Math.min(Math.max(Number(req.query.days ?? 30), 1), 425); diff --git a/backend/src/behaviorSchemas.ts b/backend/src/behaviorSchemas.ts new file mode 100644 index 0000000..131bd8b --- /dev/null +++ b/backend/src/behaviorSchemas.ts @@ -0,0 +1,40 @@ +import { z } from 'zod'; + +export const behaviorTypeSchema = z.object({ + name: z.string().trim().min(1).max(120), + description: z.string().trim().max(2000).nullable().optional(), +}); +export const behaviorOccurrenceSchema = z.object({ + behaviorTypeId: z.string().uuid(), + occurredAt: z.string().datetime({ offset: true }), + durationSeconds: z.number().finite().positive().max(31536000).nullable().optional(), + severity: z.number().int().min(1).max(5).nullable().optional(), + notes: z.string().trim().max(10000).nullable().optional(), +}); +export const behaviorRangeSchema = z.object({ + from: z.string().datetime({ offset: true }), + to: z.string().datetime({ offset: true }), + behaviorTypeId: z.string().uuid().optional(), +}).refine(({ from, to }) => Date.parse(to) > Date.parse(from) && Date.parse(to) - Date.parse(from) <= 32 * 86400000, { + message: 'Choose a date range of up to 32 days, with to after from.', +}); +export type BehaviorInput = z.infer; + +export type BehaviorType = { + id: string; + name: string; + description: string | null; + createdAt: Date; +}; +export type BehaviorOccurrence = { + id: string; + birdId: string; + behaviorTypeId: string; + behaviorName: string; + occurredAt: Date; + durationSeconds: number | null; + severity: number | null; + notes: string | null; + createdAt: Date; + updatedAt: Date; +}; diff --git a/backend/src/birdMembershipSchemas.ts b/backend/src/birdMembershipSchemas.ts new file mode 100644 index 0000000..59fd7de --- /dev/null +++ b/backend/src/birdMembershipSchemas.ts @@ -0,0 +1,9 @@ +import { z } from 'zod'; + +export const unassignedBirdMatchSchema = z.object({ + tagId: z.string().trim().min(1).max(80).refine( + (value) => !['unknown', 'not recorded', 'n/a', 'na', 'none'].includes(value.toLowerCase()), + 'Enter a known band ID.', + ), +}); +export const claimBirdSchema = unassignedBirdMatchSchema.extend({ confirmHistory: z.literal(true) }); diff --git a/backend/src/db/client.ts b/backend/src/db/client.ts index 6178e6c..09e8ded 100644 --- a/backend/src/db/client.ts +++ b/backend/src/db/client.ts @@ -23,6 +23,21 @@ export class DatabaseClient { return this.pool.query(text, params); } + async transaction(operation: (client: pg.PoolClient) => Promise): Promise { + const client = await this.pool.connect(); + try { + await client.query('BEGIN'); + const result = await operation(client); + await client.query('COMMIT'); + return result; + } catch (error) { + await client.query('ROLLBACK'); + throw error; + } finally { + client.release(); + } + } + async close() { await this.pool.end(); } diff --git a/backend/src/db/schema.ts b/backend/src/db/schema.ts index 49dbf15..ea182e8 100644 --- a/backend/src/db/schema.ts +++ b/backend/src/db/schema.ts @@ -303,7 +303,9 @@ export const ensureSchema = async (database: DatabaseClient = db) => { ADD COLUMN IF NOT EXISTS notify_on_memorial_day BOOLEAN NOT NULL DEFAULT FALSE; ALTER TABLE birds - ALTER COLUMN tag_id DROP NOT NULL; + ALTER COLUMN tag_id DROP NOT NULL, + ALTER COLUMN workspace_id DROP NOT NULL, + ALTER COLUMN workspace_id DROP DEFAULT; UPDATE birds SET tag_id = NULL @@ -450,6 +452,9 @@ export const ensureSchema = async (database: DatabaseClient = db) => { ON flock_notes (bird_id, updated_at DESC) WHERE bird_id IS NOT NULL; + -- Bird-specific notes remain attached while their bird is between flocks. + ALTER TABLE flock_notes ALTER COLUMN workspace_id DROP NOT NULL; + CREATE TABLE IF NOT EXISTS audit_log_entries ( id UUID PRIMARY KEY DEFAULT gen_random_uuid(), workspace_id INTEGER NOT NULL REFERENCES workspaces(id) ON DELETE CASCADE, @@ -594,6 +599,37 @@ export const ensureSchema = async (database: DatabaseClient = db) => { CREATE INDEX IF NOT EXISTS idx_medication_administrations_medication_date ON medication_administrations (medication_id, administered_on DESC, created_at DESC); + CREATE TABLE IF NOT EXISTS behavior_types ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + workspace_id INTEGER REFERENCES workspaces(id) ON DELETE SET NULL, + name VARCHAR(120) NOT NULL, + is_default BOOLEAN NOT NULL DEFAULT FALSE, + description TEXT, + created_at TIMESTAMPTZ NOT NULL DEFAULT CURRENT_TIMESTAMP + ); + CREATE UNIQUE INDEX IF NOT EXISTS idx_behavior_types_workspace_name + ON behavior_types (workspace_id, lower(name)) WHERE workspace_id IS NOT NULL; + CREATE UNIQUE INDEX IF NOT EXISTS idx_behavior_types_default_name + ON behavior_types (lower(name)) WHERE is_default; + INSERT INTO behavior_types (name, is_default) VALUES + ('Screaming / vocalization', TRUE), ('Biting / aggression', TRUE), ('Feather plucking', TRUE), + ('Repetitive behavior', TRUE), ('Excessive scratching', TRUE), ('Hiding / withdrawal', TRUE), + ('Unusual posture', TRUE), ('Food refusal', TRUE), ('Other', TRUE) + ON CONFLICT DO NOTHING; + CREATE TABLE IF NOT EXISTS behavior_occurrences ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + bird_id UUID NOT NULL REFERENCES birds(id) ON DELETE CASCADE, + behavior_type_id UUID NOT NULL REFERENCES behavior_types(id), + occurred_at TIMESTAMPTZ NOT NULL, + duration_seconds DOUBLE PRECISION CHECK (duration_seconds > 0 AND duration_seconds <= 31536000), + severity SMALLINT CHECK (severity BETWEEN 1 AND 5), + notes TEXT, + created_at TIMESTAMPTZ NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMPTZ NOT NULL DEFAULT CURRENT_TIMESTAMP + ); + CREATE INDEX IF NOT EXISTS idx_behavior_occurrences_bird_time ON behavior_occurrences (bird_id, occurred_at DESC); + CREATE INDEX IF NOT EXISTS idx_behavior_occurrences_bird_type_time ON behavior_occurrences (bird_id, behavior_type_id, occurred_at DESC); + DO $$ BEGIN IF EXISTS ( diff --git a/backend/src/docs/openapi.test.ts b/backend/src/docs/openapi.test.ts new file mode 100644 index 0000000..5db4644 --- /dev/null +++ b/backend/src/docs/openapi.test.ts @@ -0,0 +1,117 @@ +import assert from 'node:assert/strict'; +import { readFile } from 'node:fs/promises'; +import { once } from 'node:events'; +import test from 'node:test'; +import express from 'express'; +import SwaggerParser from '@apidevtools/swagger-parser'; +import ts from 'typescript'; +import { customerOpenApi } from './openapi.js'; +import { mountApiDocs } from './router.js'; +import { birdSchema, medicationSchema } from '../schemas.js'; + +const appSource = await readFile(new URL('../app.ts', import.meta.url), 'utf8'); +const ast = ts.createSourceFile('app.ts', appSource, ts.ScriptTarget.Latest, true); + +test('customer specification is valid OpenAPI and has unique operation IDs', async () => { + await SwaggerParser.validate(JSON.parse(JSON.stringify(customerOpenApi))); + const ids = Object.values(customerOpenApi.paths).flatMap((path) => Object.values(path!).map((operation) => operation.operationId)); + assert.equal(new Set(ids).size, ids.length); + assert.deepEqual(customerOpenApi.servers, [{ url: '/api', description: 'This FlockPal instance' }]); +}); + +test('documented operations exactly match customer integration routes and permissions', () => { + const expected: string[] = []; + for (const statement of ast.statements) { + if (!ts.isExpressionStatement(statement) || !ts.isCallExpression(statement.expression)) continue; + const call = statement.expression; + if (!ts.isPropertyAccessExpression(call.expression) || call.expression.expression.getText(ast) !== 'app') continue; + const method = call.expression.name.text; + if (!['get', 'post', 'put', 'delete', 'patch'].includes(method)) continue; + const [pathArg, ...args] = call.arguments; + if (!pathArg || !ts.isStringLiteral(pathArg)) continue; + const middleware = args.filter(ts.isIdentifier).map((arg) => arg.text); + if (!middleware.includes('requireAuth') || middleware.includes('requireSessionAuth') || middleware.includes('requireAdmin')) continue; + const path = pathArg.text.replace(/^\/api/, '').replace(/:(\w+)/g, '{$1}'); + expected.push(`${method} ${path}`); + const operation = (customerOpenApi.paths[path] as Record | undefined)?.[method]; + assert.ok(operation, `Missing ${method} ${path}`); + assert.deepEqual(operation.security, [{ IntegrationToken: [] }]); + if (middleware.includes('requireWriteAccess')) { + assert.match(operation.description, /read_write/); + assert.ok(operation.responses['402']); + assert.ok(operation.responses['403']); + } + const roleCall = args.find((arg) => ts.isCallExpression(arg) && arg.expression.getText(ast) === 'requireWorkspaceRole'); + if (roleCall && ts.isCallExpression(roleCall)) { + for (const match of roleCall.getText(ast).matchAll(/'([^']+)'/g)) assert.ok(operation.description.includes(match[1])); + } + } + const actual = Object.entries(customerOpenApi.paths).flatMap(([path, item]) => Object.keys(item!).map((method) => `${method} ${path}`)); + assert.deepEqual(actual.sort(), expected.sort()); + assert.equal(actual.length, 35); +}); + +test('response models cover the actual serialized fields', () => { + const components = customerOpenApi.components!.schemas!; + const names: Record = { normalizeWorkspace: 'workspace', normalizeWorkspaceMember: 'member', normalizeBird: 'bird', normalizeWeight: 'weight', normalizeVetVisit: 'vetVisit', normalizeMedication: 'medication', normalizeMedicationAdministration: 'administration', normalizeFlockNote: 'note', normalizeBirdTimelineEvent: 'timeline' }; + for (const statement of ast.statements) { + if (!ts.isVariableStatement(statement)) continue; + for (const declaration of statement.declarationList.declarations) { + const model = names[declaration.name.getText(ast)]; + if (!model) continue; + const fn = declaration.initializer; + assert.ok(fn && ts.isArrowFunction(fn) && ts.isParenthesizedExpression(fn.body)); + const body = fn.body.expression; + assert.ok(ts.isObjectLiteralExpression(body)); + const keys = body.properties.map((property) => property.name!.getText(ast)); + const schema = components[model]; + assert.ok(schema && !('$ref' in schema)); + assert.deepEqual(Object.keys(schema.properties!).sort(), keys.sort(), model); + } + } +}); + +test('shared validators retain custom rules and document required request fields', () => { + assert.equal(birdSchema.safeParse({ name: 'Yoda', species: 'Parrot', motivators: 'one\ntwo\nthree\nfour' }).success, false); + assert.equal(medicationSchema.safeParse({ name: 'Medicine', dosage: '1 ml', frequency: 'once_daily', doseSchedule: [{ key: 'morning', label: 'Morning', time: '08:00' }], startDate: '2026-09-27', endDate: '2026-09-26' }).success, false); + const bird = customerOpenApi.components!.schemas!.BirdInput; + assert.ok(!('$ref' in bird)); + assert.deepEqual(bird.required, ['name', 'species']); +}); + +test('Swagger UI, initialization, assets and specification are served locally with compatible CSP', async (t) => { + const app = express(); + mountApiDocs(app); + const server = app.listen(0, '127.0.0.1'); + await once(server, 'listening'); + t.after(() => new Promise((resolve, reject) => server.close((error) => error ? reject(error) : resolve()))); + const address = server.address(); + assert.ok(address && typeof address !== 'string'); + const base = `http://127.0.0.1:${address.port}`; + const page = await fetch(`${base}/api/docs/`); + assert.equal(page.status, 200); + const html = await page.text(); + assert.match(html, /FlockPal API Reference/); + const csp = page.headers.get('content-security-policy')!; + assert.match(csp, /script-src 'self'/); + assert.match(csp, /connect-src 'self'/); + assert.ok(!csp.includes('upgrade-insecure-requests')); + for (const asset of ['swagger-ui.css', 'swagger-ui-bundle.js', 'swagger-ui-standalone-preset.js', 'swagger-ui-init.js']) { + const response = await fetch(`${base}/api/docs/${asset}`); + assert.equal(response.status, 200, asset); + const content = await response.text(); + assert.ok(content.length > 0); + if (asset === 'swagger-ui-init.js') { + assert.match(content, /\/api\/openapi.json/); + assert.match(content, /"persistAuthorization": false/); + assert.match(content, /"validatorUrl": null/); + } + } + const spec = await fetch(`${base}/api/openapi.json`); + assert.equal(spec.status, 200); + assert.match(spec.headers.get('content-type')!, /application\/json/); + assert.deepEqual(await spec.json(), customerOpenApi); + const redirect = await fetch(`${base}/api/docs`, { redirect: 'manual' }); + assert.equal(redirect.status, 301); + assert.equal(redirect.headers.get('location'), '/api/docs/'); +}); diff --git a/backend/src/docs/openapi.ts b/backend/src/docs/openapi.ts new file mode 100644 index 0000000..85c5730 --- /dev/null +++ b/backend/src/docs/openapi.ts @@ -0,0 +1,134 @@ +import { unassignedBirdMatchSchema, claimBirdSchema } from '../birdMembershipSchemas.js'; +import { behaviorTypeSchema, behaviorOccurrenceSchema } from '../behaviorSchemas.js'; +import { z } from 'zod'; +import { extendZodWithOpenApi, OpenAPIRegistry, OpenApiGeneratorV3, type RouteConfig } from '@asteasolutions/zod-to-openapi'; +import { birdSchema, workspaceMemberSchema, workspaceRoleSchema, flockNoteSchema, locationSearchSchema, + weightSchema, vetVisitSchema, medicationSchema, medicationAdministrationSchema } from '../schemas.js'; +import * as responses from './responses.js'; + +extendZodWithOpenApi(z); +const registry = new OpenAPIRegistry(); +registry.registerComponent('securitySchemes', 'IntegrationToken', { + type: 'http', scheme: 'bearer', bearerFormat: 'flpt_…', + description: 'Paste your integration token, without the Bearer prefix. Create it in FlockPal Settings → Integration tokens.', +}); +const models = Object.fromEntries(Object.entries(responses).map(([name, schema]) => [name, registry.register(name.replace('Response', ''), schema)])); +const error = registry.register('Error', z.object({ + error: z.string(), code: z.string().optional(), + details: z.object({ formErrors: z.array(z.string()), fieldErrors: z.record(z.array(z.string())) }).optional(), +})); +const json = (schema: z.ZodTypeAny, example?: unknown) => ({ 'application/json': { schema, ...(example ? { example } : {}) } }); +const errors: Record = { + 400: 'Invalid request.', 401: 'Missing, expired, revoked, or invalid integration token.', + 402: 'Workspace is read-only: subscription must be active/trialing, or rescue verification approved.', + 403: 'Insufficient token scope or workspace role.', 404: 'Resource not found in this workspace, or cannot be changed.', + 409: 'Conflict: duplicate band/tag ID, duplicate weight date, or memorialized bird is read-only.', + 500: 'Internal server error.', 502: 'Location provider request failed.', 503: 'Location search is not configured.', +}; +type Endpoint = { + method: 'get' | 'post' | 'put' | 'delete'; path: string; summary: string; tag: string; + response?: z.ZodTypeAny; body?: z.ZodTypeAny; example?: unknown; query?: z.AnyZodObject; + description?: string; status?: number; errors?: number[]; roles?: string[]; +}; +const careRoles = ['owner', 'assistant', 'caregiver']; +function endpoint(config: Endpoint) { + const write = config.method !== 'get'; + const params = Object.fromEntries([...config.path.matchAll(/\{(\w+)\}/g)].map((match) => [match[1], z.string().uuid()])); + const responseMap: RouteConfig['responses'] = { + [config.status ?? (config.method === 'delete' ? 204 : config.method === 'post' ? 201 : 200)]: { + description: config.method === 'delete' ? 'Deleted successfully. No response body.' : 'Success.', + ...(config.response ? { content: json(config.response) } : {}), + }, + 429: { description: 'Rate limit exceeded. General limit: 300 requests per 15 minutes per IP; location search additionally allows 40 per 15 minutes.', + headers: { 'Retry-After': { schema: { type: 'string' }, description: 'Seconds until retry.' } }, + content: { 'text/html': { schema: { type: 'string' } }, 'application/json': { schema: error } } }, + }; + for (const status of new Set([401, 500, ...(write ? [402, 403] : []), ...(config.body || config.query ? [400] : []), ...(config.errors ?? [])])) { + responseMap[status] = { description: errors[status], content: json(error) }; + } + registry.registerPath({ + method: config.method, path: config.path, summary: config.summary, tags: [config.tag], + operationId: `${config.method}_${config.path.replace(/[{}]/g, '').replace(/[^a-zA-Z0-9]+/g, '_').replace(/^_/, '')}`, + description: [config.description, write ? `Requires a read_write token and an active writable workspace. Allowed roles: ${(config.roles ?? careRoles).join(', ')}.` : 'Accepts read_only or read_write integration tokens.'].filter(Boolean).join('\n\n'), + security: [{ IntegrationToken: [] }], + request: { + ...(Object.keys(params).length ? { params: z.object(params) } : {}), + ...(config.query ? { query: config.query } : {}), + ...(config.body ? { body: { required: true, content: json(config.body, config.example) } } : {}), + }, + responses: responseMap, + }); +} +const one = (name: string, model: z.ZodTypeAny) => z.object({ [name]: model }); +const many = (name: string, model: z.ZodTypeAny) => one(name, z.array(model)); +endpoint({ method: 'get', path: '/workspace', summary: 'Get the token’s workspace', tag: 'Workspace', response: one('workspace', models.workspaceResponse) }); +endpoint({ method: 'get', path: '/workspace/members', summary: 'List workspace members', tag: 'Workspace', response: many('members', models.memberResponse) }); +endpoint({ method: 'post', path: '/workspace/members', summary: 'Add or update a workspace member', tag: 'Workspace', body: registry.register('MemberInput', workspaceMemberSchema), response: one('member', models.memberResponse), roles: ['owner', 'assistant'] }); +endpoint({ method: 'put', path: '/workspace/members/{memberId}', summary: 'Change a member’s role', tag: 'Workspace', body: z.object({ role: workspaceRoleSchema }), response: one('member', models.memberResponse), roles: ['owner', 'assistant'], errors: [404], description: 'Only the billing owner can promote collaborators to owner. Additional protections apply to changing your own or the billing owner’s membership.' }); +endpoint({ method: 'delete', path: '/workspace/members/{memberId}', summary: 'Remove a workspace member', tag: 'Workspace', roles: ['owner', 'assistant'], errors: [404], description: 'Protected memberships cannot be removed.' }); +endpoint({ method: 'get', path: '/notes', summary: 'List flock notes', tag: 'Notes', response: many('notes', models.noteResponse) }); +endpoint({ method: 'post', path: '/notes', summary: 'Create a flock note', tag: 'Notes', body: registry.register('NoteInput', flockNoteSchema), response: one('note', models.noteResponse), errors: [404], example: { body: 'Enjoyed a new enrichment activity today.' } }); +endpoint({ method: 'delete', path: '/notes/{noteId}', summary: 'Delete a flock note', tag: 'Notes', errors: [404] }); +endpoint({ method: 'get', path: '/locations/search', summary: 'Search for a location', tag: 'Locations', query: locationSearchSchema, response: many('results', models.locationResponse), errors: [502, 503], description: 'Search cities, regions, and countries. Requires 3–120 characters; returns up to three matches. Additional rate limit: 40 requests per 15 minutes per IP.' }); +endpoint({ method: 'get', path: '/birds/unassigned-match', summary: 'Check for an unassigned bird by band ID', tag: 'Birds', query: unassignedBirdMatchSchema, response: z.object({ available: z.boolean() }), errors: [403], description: 'Requires owner, assistant, or caregiver role. Returns only availability, not profile details. Matching ignores case and surrounding whitespace; partial and unknown IDs do not match.' }); +endpoint({ method: 'post', path: '/birds/claim', summary: 'Add an unassigned bird with its existing history', tag: 'Birds', body: claimBirdSchema, response: z.object({ bird: models.birdResponse, historyImported: z.literal(true) }), status: 200, errors: [409], description: 'Requires confirmHistory: true. Atomically assigns the existing bird to the current flock, preserving its ID, profile, photo, and history. Existing profile details are used. Birds already in a flock cannot be claimed.' }); +endpoint({ method: 'get', path: '/birds', summary: 'List active and memorialized birds', tag: 'Birds', response: z.object({ birds: z.array(models.birdResponse), memorializedBirds: z.array(models.birdResponse) }) }); +const birdInput = registry.register('BirdInput', birdSchema); +const birdDescription = 'motivators and demotivators each allow up to three non-empty lines. hatchDay takes precedence over the legacy dateOfBirth field. photoDataUrl accepts an image data URL or HTTP(S) URL; returned photo links may expire.'; +endpoint({ method: 'post', path: '/birds', summary: 'Create a bird', tag: 'Birds', body: birdInput, response: one('bird', models.birdResponse), errors: [409], description: birdDescription, example: { name: 'Yoda', species: 'African grey' } }); +endpoint({ method: 'put', path: '/birds/{birdId}', summary: 'Update a bird', tag: 'Birds', body: birdInput, response: one('bird', models.birdResponse), errors: [404, 409], description: `Submit the full editable profile: omitted optional fields may be cleared or reset. ${birdDescription}` }); +endpoint({ method: 'delete', path: '/birds/{birdId}', summary: 'Remove a bird from its flock', tag: 'Birds', errors: [404, 409], description: 'Unassigns the bird without deleting its profile, photo, or care history. Bird-specific notes follow the bird; flock-wide notes and workspace audit logs stay in the old flock. Public sharing is disabled and pending transfers are revoked. An exact band ID match can later bring the bird and its history into a flock.' }); +endpoint({ method: 'get', path: '/birds/{birdId}/timeline', summary: 'List bird timeline events', tag: 'Birds', response: many('events', models.timelineResponse), errors: [404] }); +for (const resource of [ + { path: 'weights', single: 'weight', plural: 'weights', id: 'weightId', tag: 'Weights', input: weightSchema, model: models.weightResponse }, + { path: 'vet-visits', single: 'vetVisit', plural: 'vetVisits', id: 'visitId', tag: 'Vet visits', input: vetVisitSchema, model: models.vetVisitResponse }, + { path: 'medications', single: 'medication', plural: 'medications', id: 'medicationId', tag: 'Medications', input: medicationSchema, model: models.medicationResponse }, +]) { + const path = `/birds/{birdId}/${resource.path}`; + const body = registry.register(`${resource.single}Input`, resource.input); + const description = resource.path === 'medications' ? 'endDate must be on or after startDate. Supply 1–8 doseSchedule entries with unique application-defined keys; use a key as administrationSlot when recording a dose.' : undefined; + endpoint({ method: 'get', path, summary: `List ${resource.tag.toLowerCase()}`, tag: resource.tag, response: many(resource.plural, resource.model), + ...(resource.path === 'weights' ? { query: z.object({ days: z.coerce.number().min(1).max(425).default(30) }), description: 'Lookback window in days; defaults to 30. Numeric values are clamped to 1–425. Returns an empty list when no matching records exist.' } : {}) }); + endpoint({ method: 'post', path, summary: `Create ${resource.single === 'vetVisit' ? 'a vet visit' : `a ${resource.single}`}`, tag: resource.tag, body, response: one(resource.single, resource.model), errors: [404, 409], description, + ...(resource.path === 'weights' ? { example: { weightGrams: 425, recordedOn: '2026-09-27', notes: 'Morning weight' } } : {}) }); + endpoint({ method: 'put', path: `${path}/{${resource.id}}`, summary: `Update ${resource.single === 'vetVisit' ? 'a vet visit' : `a ${resource.single}`}`, tag: resource.tag, body, response: one(resource.single, resource.model), errors: [404, 409], + description: resource.path === 'weights' ? 'Only the three most recent weight records are editable. Older records return 404. One weight entry is allowed per bird per date.' : `Submit the full editable record; omitted optional fields may be reset. ${description ?? ''}` }); + if (resource.path !== 'weights') endpoint({ method: 'delete', path: `${path}/{${resource.id}}`, summary: `Delete ${resource.single === 'vetVisit' ? 'a vet visit' : 'a medication'}`, tag: resource.tag, errors: [404, 409] }); +} +endpoint({ method: 'get', path: '/birds/{birdId}/medication-administrations', summary: 'List medication administrations', tag: 'Medications', response: many('administrations', models.administrationResponse) }); +endpoint({ method: 'post', path: '/birds/{birdId}/medications/{medicationId}/administrations', summary: 'Record or update a medication dose', tag: 'Medications', body: registry.register('AdministrationInput', medicationAdministrationSchema), response: one('administration', models.administrationResponse), errors: [404, 409], description: 'Creates or updates the record for this medication, date, and administrationSlot. Use a doseSchedule key for administrationSlot; it defaults to dose-1. Returns 201 for both creation and update.' }); + +const behaviorTypeResponse = registry.register('BehaviorType', z.object({ + id: z.string().uuid(), name: z.string(), description: z.string().nullable(), createdAt: z.string().datetime(), +})); +const behaviorResponse = registry.register('BehaviorOccurrence', z.object({ + id: z.string().uuid(), birdId: z.string().uuid(), behaviorTypeId: z.string().uuid(), behaviorName: z.string(), + occurredAt: z.string().datetime(), durationSeconds: z.number().nullable(), severity: z.number().int().min(1).max(5).nullable(), + notes: z.string().nullable(), createdAt: z.string().datetime(), updatedAt: z.string().datetime(), +})); +endpoint({ method: 'get', path: '/birds/{birdId}/behavior-types', summary: 'List available behavior types', tag: 'Behavior Journal', response: many('behaviorTypes', behaviorTypeResponse), errors: [400, 404], description: 'Includes common behaviors, flock custom behaviors, and behaviors in this bird’s transferred history.' }); +endpoint({ method: 'post', path: '/birds/{birdId}/behavior-types', summary: 'Create a reusable flock behavior type', tag: 'Behavior Journal', body: behaviorTypeSchema, response: one('behaviorType', behaviorTypeResponse), errors: [404, 409], description: 'Names are unique within the flock, ignoring case. An existing type is returned for a duplicate name.' }); +endpoint({ method: 'get', path: '/birds/{birdId}/behaviors', summary: 'List behavior occurrences in a date range', tag: 'Behavior Journal', response: many('occurrences', behaviorResponse), query: z.object({ from: z.string().datetime({ offset: true }), to: z.string().datetime({ offset: true }), behaviorTypeId: z.string().uuid().optional() }), errors: [404], description: 'From is inclusive; to is exclusive. The range must be positive and at most 32 days. Send local month boundaries with their UTC offsets or converted to UTC. Results are newest first; individual events are never aggregated.' }); +endpoint({ method: 'post', path: '/birds/{birdId}/behaviors', summary: 'Record a behavior occurrence', tag: 'Behavior Journal', body: behaviorOccurrenceSchema, response: one('occurrence', behaviorResponse), errors: [404, 409], description: 'Duration is optional and measured in seconds. Intensity is optional, from 1 to 5. Occurrence timestamps require a time zone offset.' }); +endpoint({ method: 'put', path: '/birds/{birdId}/behaviors/{occurrenceId}', summary: 'Edit a behavior occurrence', tag: 'Behavior Journal', body: behaviorOccurrenceSchema, response: one('occurrence', behaviorResponse), errors: [404, 409] }); +endpoint({ method: 'delete', path: '/birds/{birdId}/behaviors/{occurrenceId}', summary: 'Delete a behavior occurrence', tag: 'Behavior Journal', errors: [400, 404, 409] }); + +export const customerOpenApi = new OpenApiGeneratorV3(registry.definitions).generateDocument({ + openapi: '3.0.3', + info: { title: 'FlockPal Customer API', version: '0.1.0', description: `Connect your flock to scripts and automation tools such as n8n. + +### Getting started +1. Sign in to FlockPal and open Settings → Integration tokens. +2. Create a read_only token for reading, or read_write for changes. Copy the secret when shown; it is only displayed once. +3. Click Authorize and paste the token (without the Bearer prefix). Requests send Authorization: Bearer flpt_…. + +Tokens are scoped to the workspace where they were created and use the creating user’s current membership permissions. Create separate tokens for other workspaces. Expired or revoked tokens return 401. + +Writes require read_write scope, an allowed role, and an active/trialing subscription or approved rescue workspace. Memorialized birds are read-only. Try it out sends real requests to this FlockPal instance, including changes and deletions; authorization is not persisted across reloads. + +This reference covers customer integration endpoints. Manage tokens, authentication, billing, transfers, and memorialization in the FlockPal application. Photo URLs returned by the API can be used directly and may expire. + +The general rate limit is 300 requests per 15 minutes per IP; location search also has a 40-request limit. On 429, wait for Retry-After before retrying.` }, + servers: [{ url: '/api', description: 'This FlockPal instance' }], + tags: ['Workspace', 'Birds', 'Weights', 'Vet visits', 'Medications', 'Notes', 'Locations', 'Behavior Journal'].map((name) => ({ name })), +}); diff --git a/backend/src/docs/responses.ts b/backend/src/docs/responses.ts new file mode 100644 index 0000000..7ac5d33 --- /dev/null +++ b/backend/src/docs/responses.ts @@ -0,0 +1,61 @@ +import { z } from 'zod'; +import { birdGenderSchema, workspaceRoleSchema } from '../schemas.js'; + +const id = z.string().uuid(); +const text = z.string().nullable(); +const date = z.string().regex(/^\d{4}-\d{2}-\d{2}$/); +const timestamp = z.string().datetime({ offset: true }); +export const locationResponse = z.object({ + label: text, city: text, region: text, country: text, countryCode: text, + latitude: z.number().nullable(), longitude: z.number().nullable(), + precision: z.enum(['city', 'region', 'country']).nullable(), verifiedAt: timestamp, provider: z.literal('mapbox').nullable(), providerPlaceId: text, +}); +export const workspaceResponse = z.object({ + id: z.number().int(), name: z.string(), workspaceType: z.enum(['standard', 'rescue']), billingEmail: text, + billingPlan: z.enum(['rescue_free', 'household_basic', 'household_plus', 'household_macaw', 'household_hyacinth_macaw']), + billingInterval: z.enum(['monthly', 'yearly']), + subscriptionStatus: z.enum(['active', 'trialing', 'past_due', 'canceled', 'unpaid', 'none']), + stripeCustomerId: text, stripeSubscriptionId: text, + rescueVerificationStatus: z.enum(['not_required', 'pending', 'approved', 'rejected']), + createdAt: timestamp, updatedAt: timestamp, +}); +export const memberResponse = z.object({ + id, workspaceId: z.number().int(), userId: id.nullable(), inviteEmail: z.string(), name: z.string(), + role: workspaceRoleSchema, acceptedAt: timestamp.nullable(), createdAt: timestamp, +}); +export const birdResponse = z.object({ + id, workspaceId: z.number().int(), name: z.string(), tagId: text, species: z.string(), + motivators: text, demotivators: text, favoriteSnack: text, locationLabel: text, + locationDetails: locationResponse.nullable(), vetClinicName: text, vetClinicAddress: text, + vetAccountNumber: text, vetDoctorName: text, gender: birdGenderSchema, + hatchDay: date.nullable(), dateOfBirth: date.nullable(), gotchaDay: date.nullable(), chartColor: z.string(), + photoDataUrl: text.describe('Photo URL or legacy data URL. Storage-backed URLs expire; refresh the bird list to obtain a new URL.'), + photoObjectKey: text, photoContentType: text, photoUpdatedAt: timestamp.nullable(), + notifyOnDob: z.boolean(), notifyOnGotchaDay: z.boolean(), publicProfileCode: text, publicProfileEnabled: z.boolean(), + memorializedAt: timestamp.nullable(), memorializedOn: date.nullable(), memorialNote: text, + notifyOnMemorialDay: z.boolean(), createdAt: timestamp, + latestWeightGrams: z.number().nullable(), latestRecordedOn: date.nullable(), +}); +export const weightResponse = z.object({ id, birdId: id, weightGrams: z.number(), recordedOn: date, notes: text }); +export const vetVisitResponse = z.object({ id, birdId: id, visitedOn: date, clinicName: z.string(), reason: z.string(), notes: text }); +export const medicationResponse = z.object({ + id, birdId: id, name: z.string(), dosage: z.string(), + frequency: z.enum(['once_daily', 'twice_daily', 'every_8_hours', 'every_6_hours', 'as_needed']), + doseSchedule: z.array(z.object({ key: z.string(), label: z.string(), time: z.string() })), + route: text, startDate: date, endDate: date.nullable(), notes: text, remindersEnabled: z.boolean(), +}); +export const administrationResponse = z.object({ + id, medicationId: id, birdId: id, administeredOn: date, administrationSlot: z.string(), + status: z.enum(['administered', 'missed']), notes: text, createdByUserId: id.nullable(), createdAt: timestamp, +}); +export const noteResponse = z.object({ + id, workspaceId: z.number().int(), birdId: id.nullable(), birdName: text, title: z.string(), body: z.string(), + createdByUserId: id.nullable(), createdByName: text, createdAt: timestamp, updatedAt: timestamp, +}); +export const timelineResponse = z.object({ + id, birdId: id, eventType: z.enum(['profile_created', 'transferred', 'location_updated', 'owner_changed', 'manual_note', 'removed_from_flock', 'joined_flock']), + fromWorkspaceId: z.number().int().nullable(), toWorkspaceId: z.number().int().nullable(), + fromWorkspaceName: text, toWorkspaceName: text, fromOwnerEmail: text, toOwnerEmail: text, + locationLabel: text, locationDetails: locationResponse.nullable(), note: text, eventDate: date, + createdByUserId: id.nullable(), createdAt: timestamp, +}); diff --git a/backend/src/docs/router.ts b/backend/src/docs/router.ts new file mode 100644 index 0000000..5cdbd6f --- /dev/null +++ b/backend/src/docs/router.ts @@ -0,0 +1,24 @@ +import type { Express } from 'express'; +import helmet from 'helmet'; +import swaggerUi from 'swagger-ui-express'; +import { customerOpenApi } from './openapi.js'; + +// Mount before application middleware so docs do not consume API rate limits. +// Swagger assets and initialization are served locally; no external validator is used. +export function mountApiDocs(app: Express) { + app.get('/api/openapi.json', helmet(), (_req, res) => res.json(customerOpenApi)); + app.use('/api/docs', helmet({ + contentSecurityPolicy: { directives: { + 'script-src': ["'self'"], + 'connect-src': ["'self'"], + // Keep local HTTP development usable; production transport is handled by the proxy. + 'upgrade-insecure-requests': null, + } }, + }), swaggerUi.serve, swaggerUi.setup(undefined, { + customSiteTitle: 'FlockPal API Reference', + swaggerOptions: { + url: '/api/openapi.json', validatorUrl: null, persistAuthorization: false, + displayRequestDuration: true, docExpansion: 'none', + }, + })); +} diff --git a/backend/src/repositories/behaviorRepository.ts b/backend/src/repositories/behaviorRepository.ts new file mode 100644 index 0000000..ffc83ee --- /dev/null +++ b/backend/src/repositories/behaviorRepository.ts @@ -0,0 +1,47 @@ +import { db } from '../db/client.js'; +import type { BehaviorInput, BehaviorType, BehaviorOccurrence } from '../behaviorSchemas.js'; + +const typeFields = `id, name, description, created_at AS "createdAt"`; +const occurrenceFields = `o.id, o.bird_id AS "birdId", o.behavior_type_id AS "behaviorTypeId", + t.name AS "behaviorName", o.occurred_at AS "occurredAt", o.duration_seconds AS "durationSeconds", + o.severity, o.notes, o.created_at AS "createdAt", o.updated_at AS "updatedAt"`; + +export async function listBehaviorTypes(workspaceId: number, birdId: string) { + // Include types used by this bird before a flock transfer, without exposing other flock types. + return (await db.query(`SELECT ${typeFields} FROM behavior_types t + WHERE is_default OR workspace_id = $1 OR EXISTS ( + SELECT 1 FROM behavior_occurrences o JOIN birds b ON b.id = o.bird_id + WHERE o.behavior_type_id = t.id AND b.id = $2 AND b.workspace_id = $1) + ORDER BY name`, [workspaceId, birdId])).rows; +} +export async function createBehaviorType(workspaceId: number, name: string, description?: string | null) { + return (await db.query(`INSERT INTO behavior_types (workspace_id, name, description) VALUES ($1, $2, $3) + ON CONFLICT (workspace_id, lower(name)) WHERE workspace_id IS NOT NULL + DO UPDATE SET name = behavior_types.name RETURNING ${typeFields}`, [workspaceId, name, description || null])).rows[0]; +} +export async function listBehaviorOccurrences(birdId: string, workspaceId: number, from: string, to: string, typeId?: string) { + return (await db.query(`SELECT ${occurrenceFields} FROM behavior_occurrences o + JOIN birds b ON b.id = o.bird_id JOIN behavior_types t ON t.id = o.behavior_type_id + WHERE b.id = $1 AND b.workspace_id = $2 AND o.occurred_at >= $3 AND o.occurred_at < $4 + AND ($5::uuid IS NULL OR o.behavior_type_id = $5) ORDER BY o.occurred_at DESC, o.id`, + [birdId, workspaceId, from, to, typeId || null])).rows; +} +export async function saveBehaviorOccurrence(birdId: string, workspaceId: number, input: BehaviorInput, id?: string) { + const params = [birdId, workspaceId, input.behaviorTypeId, input.occurredAt, input.durationSeconds ?? null, input.severity ?? null, input.notes || null]; + // Keep authorization in the mutation as well as the route to protect against concurrent transfers. + const allowed = `EXISTS (SELECT 1 FROM birds b WHERE b.id = $1 AND b.workspace_id = $2 AND b.memorialized_at IS NULL) + AND EXISTS (SELECT 1 FROM behavior_types t WHERE t.id = $3 AND + (t.is_default OR t.workspace_id = $2 OR EXISTS + (SELECT 1 FROM behavior_occurrences previous WHERE previous.bird_id = $1 AND previous.behavior_type_id = t.id)))`; + const mutation = id + ? `UPDATE behavior_occurrences SET behavior_type_id = $3, occurred_at = $4, duration_seconds = $5, + severity = $6, notes = $7, updated_at = CURRENT_TIMESTAMP WHERE bird_id = $1 AND id = $8 AND ${allowed} RETURNING *` + : `INSERT INTO behavior_occurrences (bird_id, behavior_type_id, occurred_at, duration_seconds, severity, notes) + SELECT $1, $3, $4, $5, $6, $7 WHERE ${allowed} RETURNING *`; + return (await db.query(`WITH saved AS (${mutation}) SELECT ${occurrenceFields} + FROM saved o JOIN behavior_types t ON t.id = o.behavior_type_id`, id ? [...params, id] : params)).rows[0]; +} +export async function deleteBehaviorOccurrence(birdId: string, workspaceId: number, id: string) { + return (await db.query<{ id: string }>(`DELETE FROM behavior_occurrences o USING birds b WHERE o.bird_id = b.id + AND b.id = $1 AND b.workspace_id = $2 AND b.memorialized_at IS NULL AND o.id = $3 RETURNING o.id`, [birdId, workspaceId, id])).rows[0]; +} diff --git a/backend/src/repositories/birdMembershipRepository.ts b/backend/src/repositories/birdMembershipRepository.ts new file mode 100644 index 0000000..7d317cb --- /dev/null +++ b/backend/src/repositories/birdMembershipRepository.ts @@ -0,0 +1,50 @@ +import { db } from '../db/client.js'; + +// Only reveal whether an exact normalized band match is available, never its profile or former flock. +export async function hasUnassignedBird(tagId: string): Promise { + const result = await db.query<{ id: string }>( + `SELECT id FROM birds WHERE workspace_id IS NULL AND memorialized_at IS NULL + AND LOWER(BTRIM(tag_id)) = LOWER(BTRIM($1)) LIMIT 1`, [tagId], + ); + return result.rows.length > 0; +} + +export async function removeBirdFromFlock(birdId: string, workspaceId: number, userId: string): Promise { + return db.transaction(async (client) => { + const result = await client.query<{ id: string }>( + `UPDATE birds SET workspace_id = NULL, public_profile_enabled = FALSE + WHERE id = $1 AND workspace_id = $2 AND memorialized_at IS NULL RETURNING id`, [birdId, workspaceId], + ); + if (!result.rows.length) return false; + await client.query(`UPDATE flock_notes SET workspace_id = NULL WHERE bird_id = $1`, [birdId]); + await client.query(`UPDATE bird_transfer_codes SET revoked_at = CURRENT_TIMESTAMP + WHERE bird_id = $1 AND completed_at IS NULL AND revoked_at IS NULL`, [birdId]); + await client.query(`DELETE FROM pending_bird_transfers WHERE bird_id = $1 AND completed_at IS NULL`, [birdId]); + await client.query(`INSERT INTO bird_timeline_events + (bird_id, event_type, from_workspace_id, from_workspace_name, note, created_by_user_id) + SELECT $1, 'removed_from_flock', id, name, 'Removed from flock; profile and history retained.', $3 + FROM workspaces WHERE id = $2`, [birdId, workspaceId, userId]); + return true; + }); +} + +export async function claimUnassignedBird(tagId: string, workspaceId: number, userId: string): Promise { + return db.transaction(async (client) => { + // The row lock and repeated unassigned predicate prevent competing flocks from claiming the same bird. + const match = await client.query<{ id: string }>( + `SELECT id FROM birds WHERE workspace_id IS NULL AND memorialized_at IS NULL + AND LOWER(BTRIM(tag_id)) = LOWER(BTRIM($1)) FOR UPDATE`, [tagId], + ); + if (!match.rows.length) return null; + const birdId = match.rows[0].id; + const claimed = await client.query(`UPDATE birds SET workspace_id = $2, public_profile_enabled = FALSE + WHERE id = $1 AND workspace_id IS NULL RETURNING id`, [birdId, workspaceId]); + if (!claimed.rows.length) return null; + await client.query(`UPDATE flock_notes SET workspace_id = $2 WHERE bird_id = $1 AND workspace_id IS NULL`, [birdId, workspaceId]); + await client.query(`INSERT INTO bird_timeline_events + (bird_id, event_type, to_workspace_id, to_workspace_name, note, created_by_user_id) + SELECT $1, 'joined_flock', id, name, 'Added by matching band ID; existing profile and history retained.', $3 + FROM workspaces WHERE id = $2`, [birdId, workspaceId, userId]); + return birdId; + }); +} diff --git a/backend/src/repositories/birdRepository.ts b/backend/src/repositories/birdRepository.ts index dec5aad..5536c5c 100644 --- a/backend/src/repositories/birdRepository.ts +++ b/backend/src/repositories/birdRepository.ts @@ -789,18 +789,6 @@ export const updateMemorialReminderPreference = async ({ return result.rows[0] ?? null; }; -export const deleteBird = async (birdId: string, workspaceId: number) => { - const result = await db.query<{ id: string }>( - `DELETE FROM birds - WHERE id = $1 - AND workspace_id = $2 - RETURNING id`, - [birdId, workspaceId], - ); - - return Boolean(result.rowCount); -}; - export const transferBirdToWorkspace = async (birdId: string, sourceWorkspaceId: number, targetWorkspaceId: number) => { const result = await db.query( `UPDATE birds diff --git a/backend/src/schemas.ts b/backend/src/schemas.ts new file mode 100644 index 0000000..dcfa7b2 --- /dev/null +++ b/backend/src/schemas.ts @@ -0,0 +1,211 @@ +import { z } from 'zod'; + +// Shared runtime validation and API documentation schemas. +export const dateStringSchema = z.string().regex(/^\d{4}-\d{2}-\d{2}$/); +export const chartColorSchema = z.string().regex(/^#[0-9a-fA-F]{6}$/); +export const photoDataUrlSchema = z + .string() + .regex(/^data:image\/(?:png|jpeg|jpg|webp|gif);base64,[A-Za-z0-9+/=]+$/) + .max(1_500_000); +export const photoUrlSchema = z.string().trim().url().max(2000); + +export const magicLinkRequestSchema = z.object({ + name: z.string().trim().max(160).optional().or(z.literal('')), + email: z.string().trim().email().max(255), + redirectTo: z.string().trim().url().max(2000).optional().or(z.literal('')), +}); + +export const switchWorkspaceSchema = z.object({ + workspaceId: z.coerce.number().int().positive(), +}); + +export const workspaceTypeSchema = z.enum(['standard', 'rescue']); +export const workspaceRoleSchema = z.enum(['owner', 'assistant', 'caregiver', 'viewer']); +export const billingPlanSchema = z.enum(['household_basic', 'household_plus', 'household_macaw', 'household_hyacinth_macaw']); +export const billingIntervalSchema = z.enum(['monthly', 'yearly']); +export const integrationTokenScopeSchema = z.enum(['read_only', 'read_write']); +export const birdGenderSchema = z.enum(['unknown', 'male', 'female', 'male_dna', 'female_dna']); +export const rescueVerificationStatusSchema = z.enum(['pending', 'approved', 'rejected']); +export const rescueOnboardingSchema = z.object({ + name: z.string().trim().max(160).optional().or(z.literal('')), + city: z.string().trim().max(120).optional().or(z.literal('')), + state: z.string().trim().max(80).optional().or(z.literal('')), + ein: z.string().trim().max(32).optional().or(z.literal('')), + website: z.string().trim().url().max(2000).optional().or(z.literal('')), +}); + +export const workspaceSchema = z.object({ + name: z.string().trim().min(1).max(160), + workspaceType: workspaceTypeSchema, + billingEmail: z.string().trim().email().max(255).optional().or(z.literal('')), + billingPlan: billingPlanSchema.optional(), + billingInterval: billingIntervalSchema.optional(), + rescueOnboarding: rescueOnboardingSchema.optional(), +}); + +export const createWorkspaceSchema = z.object({ + name: z.string().trim().min(1).max(160), + workspaceType: workspaceTypeSchema, + billingEmail: z.string().trim().email().max(255).optional().or(z.literal('')), + billingPlan: billingPlanSchema.optional(), + billingInterval: billingIntervalSchema.optional(), + rescueOnboarding: rescueOnboardingSchema.optional(), +}); + +export const workspaceMemberSchema = z.object({ + name: z.string().trim().min(1).max(160), + email: z.string().trim().email().max(255), + role: workspaceRoleSchema, +}); + +export const flockTransferSchema = z.object({ + destinationOwnerEmail: z.string().trim().email().max(255), +}); + +export const lostBirdReportSchema = z.object({ + tagId: z.string().trim().min(1).max(80), + finderName: z.string().trim().max(160).optional().or(z.literal('')), + finderEmail: z.string().trim().email().max(255).optional().or(z.literal('')), + foundLocation: z.string().trim().max(255).optional().or(z.literal('')), + message: z.string().trim().max(1000).optional().or(z.literal('')), +}); + +export const publicProfileCodeSchema = z.string().trim().regex(/^[A-Za-z0-9_-]{8,32}$/); +export const birdTransferCodeSchema = z.string().trim().regex(/^[A-Za-z0-9_-]{12,32}$/); +export const birdProfileListSchema = z + .string() + .trim() + .max(1000) + .refine( + (value) => value.split(/\r?\n/).map((item) => item.trim()).filter(Boolean).length <= 3, + 'Use no more than three list items.', + ) + .optional() + .or(z.literal('')); + +export const verifiedLocationDetailsSchema = z + .object({ + label: z.string().trim().max(220).optional().or(z.literal('')), + city: z.string().trim().max(120).optional().or(z.literal('')), + region: z.string().trim().max(120).optional().or(z.literal('')), + country: z.string().trim().max(120).optional().or(z.literal('')), + countryCode: z.string().trim().max(2).optional().or(z.literal('')), + latitude: z.coerce.number().min(-90).max(90).optional().nullable().or(z.literal('')), + longitude: z.coerce.number().min(-180).max(180).optional().nullable().or(z.literal('')), + precision: z.enum(['city', 'region', 'country']).optional(), + provider: z.literal('mapbox').optional().nullable(), + providerPlaceId: z.string().trim().max(220).optional().or(z.literal('')), + }) + .optional() + .nullable(); + +export const locationSearchSchema = z.object({ + q: z.string().trim().min(3).max(120), +}); + +export const birdSchema = z.object({ + name: z.string().trim().min(1).max(120), + tagId: z.string().trim().max(80).optional().or(z.literal('')), + species: z.string().trim().min(1).max(120), + motivators: birdProfileListSchema, + demotivators: birdProfileListSchema, + favoriteSnack: z.string().trim().max(160).optional().or(z.literal('')), + locationLabel: z.string().trim().max(160).optional().or(z.literal('')), + locationDetails: verifiedLocationDetailsSchema, + vetClinicName: z.string().trim().max(160).optional().or(z.literal('')), + vetClinicAddress: z.string().trim().max(500).optional().or(z.literal('')), + vetAccountNumber: z.string().trim().max(120).optional().or(z.literal('')), + vetDoctorName: z.string().trim().max(160).optional().or(z.literal('')), + gender: birdGenderSchema.optional(), + hatchDay: dateStringSchema.optional().or(z.literal('')), + dateOfBirth: dateStringSchema.optional().or(z.literal('')), + gotchaDay: dateStringSchema.optional().or(z.literal('')), + chartColor: chartColorSchema.optional(), + photoDataUrl: z.union([photoDataUrlSchema, photoUrlSchema, z.literal('')]).optional(), + notifyOnDob: z.boolean().optional(), + notifyOnGotchaDay: z.boolean().optional(), + publicProfileEnabled: z.boolean().optional(), +}); + +export const memorializeBirdSchema = z.object({ + memorializedOn: dateStringSchema, + memorialNote: z.string().trim().max(1000).optional().or(z.literal('')), + notifyOnMemorialDay: z.boolean().optional(), +}); + +export const memorialReminderPreferenceSchema = z.object({ + notifyOnMemorialDay: z.boolean(), +}); + +export const birdTimelineEventSchema = z + .object({ + eventType: z.enum(['location_updated', 'owner_changed', 'manual_note']), + eventDate: dateStringSchema.optional().or(z.literal('')), + locationLabel: z.string().trim().max(160).optional().or(z.literal('')), + locationDetails: verifiedLocationDetailsSchema, + note: z.string().trim().max(500).optional().or(z.literal('')), + }) + .refine( + (value) => + value.eventType === 'owner_changed' || + Boolean( + value.locationLabel?.trim() || + value.note?.trim() || + value.locationDetails?.city?.trim() || + value.locationDetails?.region?.trim() || + value.locationDetails?.country?.trim(), + ), + 'Add a location or note for this timeline item.', + ); + +export const weightSchema = z.object({ + weightGrams: z.coerce.number().positive().max(10000), + recordedOn: dateStringSchema, + notes: z.string().trim().max(280).optional().or(z.literal('')), +}); + +export const vetVisitSchema = z.object({ + visitedOn: dateStringSchema, + clinicName: z.string().trim().min(1).max(160), + reason: z.string().trim().min(1).max(160), + notes: z.string().trim().max(1000).optional().or(z.literal('')), +}); + +export const medicationSchema = z + .object({ + name: z.string().trim().min(1).max(160), + dosage: z.string().trim().min(1).max(160), + frequency: z.enum(['once_daily', 'twice_daily', 'every_8_hours', 'every_6_hours', 'as_needed']), + doseSchedule: z + .array( + z.object({ + key: z.string().trim().min(1).max(80), + label: z.string().trim().min(1).max(80), + time: z.string().trim().regex(/^$|^\d{2}:\d{2}$/), + }), + ) + .min(1) + .max(8), + route: z.string().trim().max(80).optional().or(z.literal('')), + startDate: dateStringSchema, + endDate: dateStringSchema.optional().or(z.literal('')), + notes: z.string().trim().max(1000).optional().or(z.literal('')), + remindersEnabled: z.boolean().optional(), + }) + .refine((value) => !value.endDate || value.endDate >= value.startDate, { + message: 'End date must be on or after start date.', + path: ['endDate'], + }); + +export const medicationAdministrationSchema = z.object({ + administeredOn: dateStringSchema, + administrationSlot: z.string().trim().min(1).max(80).default('dose-1'), + status: z.enum(['administered', 'missed']), + notes: z.string().trim().max(500).optional().or(z.literal('')), +}); + +export const flockNoteSchema = z.object({ + birdId: z.string().uuid().optional().nullable().or(z.literal('')), + body: z.string().trim().min(1).max(5000), +}); + diff --git a/backend/src/scripts/migrateBirdPhotosToS3.ts b/backend/src/scripts/migrateBirdPhotosToS3.ts index 85fa41e..d9607ed 100644 --- a/backend/src/scripts/migrateBirdPhotosToS3.ts +++ b/backend/src/scripts/migrateBirdPhotosToS3.ts @@ -5,7 +5,7 @@ import { deleteS3Object, putS3Object } from '../storage/s3Client.js'; type BirdPhotoMigrationRow = { id: string; - workspace_id: number; + workspace_id: number | null; name: string; photo_data_url: string; }; diff --git a/backend/src/storage/imageStorageConfig.ts b/backend/src/storage/imageStorageConfig.ts index 8d47d57..dc0dc76 100644 --- a/backend/src/storage/imageStorageConfig.ts +++ b/backend/src/storage/imageStorageConfig.ts @@ -54,7 +54,7 @@ export const buildBirdPhotoObjectKey = ({ extension, now = new Date(), }: { - workspaceId: number; + workspaceId: number | null; birdId: string; extension: string; now?: Date; @@ -63,7 +63,7 @@ export const buildBirdPhotoObjectKey = ({ const safeExtension = extension.replace(/^\./, '').toLowerCase() || 'bin'; const timestamp = now.toISOString().replace(/[:.]/g, '-'); - return `${prefix}/workspace-${workspaceId}/${birdId}/${timestamp}.${safeExtension}`; + return `${prefix}/${workspaceId === null ? 'unassigned' : `workspace-${workspaceId}`}/${birdId}/${timestamp}.${safeExtension}`; }; export const getImageExtensionFromContentType = (contentType: string) => { diff --git a/backend/src/types.ts b/backend/src/types.ts index ff415a0..384b2f9 100644 --- a/backend/src/types.ts +++ b/backend/src/types.ts @@ -123,7 +123,7 @@ export type IntegrationTokenRow = { export type BirdRow = { id: string; - workspace_id: number; + workspace_id: number | null; name: string; tag_id: string | null; species: string; @@ -158,6 +158,7 @@ export type BirdRow = { }; export type LostBirdMatchRow = BirdRow & { + workspace_id: number; workspace_name: string; workspace_billing_email: string | null; }; @@ -165,6 +166,7 @@ export type LostBirdMatchRow = BirdRow & { export type BirdMilestoneReminderType = 'hatch_day' | 'gotcha_day' | 'memorial_day'; export type BirdMilestoneReminderCandidateRow = BirdRow & { + workspace_id: number; workspace_name: string; reminder_type: BirdMilestoneReminderType; reminder_date: string; @@ -205,7 +207,7 @@ export type BirdTransferCodeRow = { created_at: string; }; -export type BirdTimelineEventType = 'profile_created' | 'transferred' | 'location_updated' | 'owner_changed' | 'manual_note'; +export type BirdTimelineEventType = 'profile_created' | 'transferred' | 'location_updated' | 'owner_changed' | 'manual_note' | 'removed_from_flock' | 'joined_flock'; export type BirdTimelineEventRow = { id: string; @@ -263,6 +265,7 @@ export type MedicationDoseScheduleItem = { }; export type MedicationReminderCandidateRow = BirdRow & { + workspace_id: number; workspace_name: string; medication_id: string; medication_name: string; diff --git a/backend/test-integration/behaviorJournal.mjs b/backend/test-integration/behaviorJournal.mjs new file mode 100644 index 0000000..3f05874 --- /dev/null +++ b/backend/test-integration/behaviorJournal.mjs @@ -0,0 +1,94 @@ +// Run against the disposable database described in docs/BEHAVIOR_JOURNAL.md. +import assert from 'node:assert/strict'; +import { createHash, randomUUID } from 'node:crypto'; +import { spawn } from 'node:child_process'; +import { once } from 'node:events'; +import { fileURLToPath } from 'node:url'; +Object.assign(process.env, { + POSTGRES_HOST: '127.0.0.1', POSTGRES_PORT: '55439', POSTGRES_DB: 'behavior_test', + POSTGRES_USER: 'postgres', POSTGRES_PASSWORD: 'behavior_test_only', PORT: '55440', + MILESTONE_REMINDERS_ENABLED: 'false', MEDICATION_REMINDERS_ENABLED: 'false', WEIGHT_REMINDERS_ENABLED: 'false', +}); +const { db } = await import('../dist/db/client.js'); +const { ensureSchema } = await import('../dist/db/schema.js'); +let server; +let logs = ''; +try { + await ensureSchema(); + await ensureSchema(); // Schema and seed must be safe to re-run. + const workspace = 100000 + Math.floor(Math.random() * 1000000000); + const otherWorkspace = workspace + 1; + await db.query(`INSERT INTO workspaces (id, name, workspace_type, rescue_verification_status) VALUES ($1, 'Journal test', 'rescue', 'approved'), ($2, 'Other test', 'rescue', 'approved')`, [workspace, otherWorkspace]); + const user = randomUUID(); + await db.query(`INSERT INTO users (id, email, name) VALUES ($1, $2, 'Journal tester')`, [user, `${user}@example.test`]); + await db.query(`INSERT INTO workspace_members (workspace_id, user_id, invite_email, name, role, accepted_at) VALUES ($1, $2, 'journal@example.test', 'Journal tester', 'owner', NOW())`, [workspace, user]); + const token = randomUUID(); + await db.query(`INSERT INTO auth_sessions (user_id, active_workspace_id, token_hash, expires_at) VALUES ($1, $2, $3, NOW() + INTERVAL '1 hour')`, [user, workspace, createHash('sha256').update(token).digest('hex')]); + const bird = randomUUID(), otherBird = randomUUID(), secondBird = randomUUID(); + for (const [id, flock] of [[bird, workspace], [secondBird, workspace], [otherBird, otherWorkspace]]) { + await db.query(`INSERT INTO birds (id, workspace_id, name, species) VALUES ($1, $2, 'Journal bird', 'Parrot')`, [id, flock]); + } + server = spawn(process.execPath, [fileURLToPath(new URL('../dist/app.js', import.meta.url))], { cwd: '/tmp', env: process.env, stdio: ['ignore', 'pipe', 'pipe'] }); + server.stdout.on('data', (data) => { logs += data; }); server.stderr.on('data', (data) => { logs += data; }); + for (let attempt = 0; attempt < 100 && !logs.includes('listening'); attempt++) await new Promise((resolve) => setTimeout(resolve, 100)); + assert.match(logs, /listening/, logs); + async function api(path, method = 'GET', body, status = 200, authenticated = true) { + const response = await fetch(`http://127.0.0.1:55440/api${path}`, { method, headers: { 'Content-Type': 'application/json', ...(authenticated ? { Authorization: `Bearer ${token}` } : {}) }, ...(body ? { body: JSON.stringify(body) } : {}) }); + const data = response.status === 204 ? null : await response.json(); + assert.equal(response.status, status, JSON.stringify(data)); return data; + } + const base = `/birds/${bird}`; + const range = '?from=2026-10-01T00:00:00-04:00&to=2026-11-01T00:00:00-04:00'; + const types = (await api(`${base}/behavior-types`)).behaviorTypes; + assert.equal(types.length, 9); + const custom = (await api(`${base}/behavior-types`, 'POST', { name: 'Wing stretching', description: 'Observed stretching' }, 201)).behaviorType; + const duplicate = (await api(`${base}/behavior-types`, 'POST', { name: 'wing stretching' }, 201)).behaviorType; + assert.equal(custom.id, duplicate.id); + const foreignType = (await db.query(`INSERT INTO behavior_types (workspace_id, name) VALUES ($1, 'Private behavior') RETURNING id`, [otherWorkspace])).rows[0].id; + const input = { behaviorTypeId: custom.id, occurredAt: '2026-10-05T23:30:12.123-04:00', durationSeconds: 90, severity: 3, notes: 'Observed after play' }; + const first = (await api(`${base}/behaviors`, 'POST', input, 201)).occurrence; + assert.equal(first.occurredAt, '2026-10-06T03:30:12.123Z'); + const second = (await api(`${base}/behaviors`, 'POST', { ...input, behaviorTypeId: types[0].id }, 201)).occurrence; + await api(`${base}/behaviors`, 'POST', { ...input, occurredAt: '2026-11-01T00:00:00-04:00' }, 201); + assert.equal((await api(`${base}/behaviors${range}`)).occurrences.length, 2); + assert.equal((await api(`${base}/behaviors${range}&behaviorTypeId=${custom.id}`)).occurrences.length, 1); + assert.equal((await api(`/birds/${secondBird}/behaviors${range}`)).occurrences.length, 0); + const edited = (await api(`${base}/behaviors/${first.id}`, 'PUT', { ...input, notes: 'Edited note', severity: null, durationSeconds: null })).occurrence; + assert.equal(edited.notes, 'Edited note'); assert.equal(edited.severity, null); assert.equal(edited.durationSeconds, null); + assert.equal(edited.createdAt, first.createdAt); assert.equal(edited.occurredAt, first.occurredAt); + for (const bad of [{ severity: 6 }, { durationSeconds: -1 }, { occurredAt: '2026-02-30T12:00:00Z' }, { occurredAt: '2026-10-05T12:00:00' }]) await api(`${base}/behaviors`, 'POST', { ...input, ...bad }, 400); + await api(`${base}/behaviors`, 'POST', { ...input, behaviorTypeId: foreignType }, 404); + await api(`/birds/${otherBird}/behavior-types`, 'GET', undefined, 404); + await api(`/birds/${otherBird}/behaviors${range}`, 'GET', undefined, 404); + await api(`/birds/${otherBird}/behaviors`, 'POST', input, 404); + await api(`/birds/${secondBird}/behaviors/${first.id}`, 'PUT', input, 404); + await api(`/birds/${secondBird}/behaviors/${first.id}`, 'DELETE', undefined, 404); + await api(`${base}/behavior-types`, 'GET', undefined, 401, false); + await api(`${base}/behaviors?from=invalid&to=invalid`, 'GET', undefined, 400); + await db.query(`UPDATE workspace_members SET role = 'viewer' WHERE user_id = $1`, [user]); + await api(`${base}/behaviors`, 'POST', input, 403); + await api(`${base}/behaviors/${first.id}`, 'PUT', input, 403); + await api(`${base}/behaviors/${first.id}`, 'DELETE', undefined, 403); + await db.query(`UPDATE workspace_members SET role = 'owner' WHERE user_id = $1`, [user]); + await db.query(`UPDATE workspaces SET rescue_verification_status = 'pending' WHERE id = $1`, [workspace]); + await api(`${base}/behaviors`, 'POST', input, 402); + await db.query(`UPDATE workspaces SET rescue_verification_status = 'approved' WHERE id = $1`, [workspace]); + await db.query(`UPDATE birds SET memorialized_at = NOW() WHERE id = $1`, [bird]); + await api(`${base}/behaviors`, 'POST', input, 409); + await api(`${base}/behaviors/${first.id}`, 'DELETE', undefined, 409); + await db.query(`UPDATE birds SET memorialized_at = NULL WHERE id = $1`, [bird]); + await api(`${base}/behaviors/${second.id}`, 'DELETE', undefined, 204); + assert.equal((await api(`${base}/behaviors${range}`)).occurrences.length, 1); + // Transfer the bird: old flock loses access, new flock retains normalized history. + await db.query(`UPDATE birds SET workspace_id = $1 WHERE id = $2`, [otherWorkspace, bird]); + await api(`${base}/behaviors${range}`, 'GET', undefined, 404); + await db.query(`INSERT INTO workspace_members (workspace_id, user_id, invite_email, name, role, accepted_at) VALUES ($1, $2, 'journal@example.test', 'Journal tester', 'owner', NOW())`, [otherWorkspace, user]); + await db.query(`UPDATE auth_sessions SET active_workspace_id = $1 WHERE user_id = $2`, [otherWorkspace, user]); + assert.equal((await api(`${base}/behaviors${range}`)).occurrences[0].behaviorName, 'Wing stretching'); + assert.ok((await api(`${base}/behavior-types`)).behaviorTypes.some((type) => type.id === custom.id)); + await api(`${base}/behaviors/${first.id}`, 'PUT', input); + console.log('PASS: schema repeatability; defaults/custom types; create/edit/delete; bird/behavior/month filters; timestamp precision; auth/role/billing/memorial restrictions; flock isolation and transfer history.'); +} finally { + if (server && server.exitCode === null) { const exited = once(server, 'exit'); server.kill('SIGTERM'); await exited; } + await db.close(); +} diff --git a/backend/test-integration/birdMembership.mjs b/backend/test-integration/birdMembership.mjs new file mode 100644 index 0000000..3cbdda8 --- /dev/null +++ b/backend/test-integration/birdMembership.mjs @@ -0,0 +1,116 @@ +// Uses only the disposable database and API ports documented in docs/BIRD_MEMBERSHIP.md. +import assert from 'node:assert/strict'; +import { createHash, randomUUID } from 'node:crypto'; +import { spawn } from 'node:child_process'; +import { once } from 'node:events'; +import { fileURLToPath } from 'node:url'; +Object.assign(process.env, { + POSTGRES_HOST: '127.0.0.1', POSTGRES_PORT: '55439', POSTGRES_DB: 'behavior_test', + POSTGRES_USER: 'postgres', POSTGRES_PASSWORD: 'behavior_test_only', PORT: '55440', + MILESTONE_REMINDERS_ENABLED: 'false', MEDICATION_REMINDERS_ENABLED: 'false', WEIGHT_REMINDERS_ENABLED: 'false', +}); +const { db } = await import('../dist/db/client.js'); +const { ensureSchema } = await import('../dist/db/schema.js'); +const { removeBirdFromFlock, claimUnassignedBird } = await import('../dist/repositories/birdMembershipRepository.js'); +let server; +let output = ''; +try { + await ensureSchema(); + await ensureSchema(); + const baseId = 100000 + Math.floor(Math.random() * 1000000000); + const accounts = []; + for (let i = 0; i < 3; i++) { + const workspace = baseId + i, user = randomUUID(), token = randomUUID(), email = `${user}@example.test`; + await db.query(`INSERT INTO workspaces (id, name, workspace_type, rescue_verification_status) VALUES ($1, $2, 'rescue', 'approved')`, [workspace, `Membership test ${i}`]); + await db.query(`INSERT INTO users (id, email, name, education_opt_out) VALUES ($1, $2, 'Tester', TRUE)`, [user, email]); + await db.query(`INSERT INTO workspace_members (workspace_id, user_id, invite_email, name, role, accepted_at) VALUES ($1, $2, $3, 'Tester', 'owner', NOW())`, [workspace, user, email]); + await db.query(`INSERT INTO auth_sessions (user_id, active_workspace_id, token_hash, expires_at) VALUES ($1, $2, $3, NOW() + INTERVAL '1 hour')`, [user, workspace, createHash('sha256').update(token).digest('hex')]); + accounts.push({ workspace, user, token }); + } + const [source, destination, rival] = accounts; + const bird = randomUUID(), tagId = `BAND-${randomUUID()}`, publicCode = randomUUID().slice(0, 20); + const photo = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+a2ioAAAAASUVORK5CYII='; + await db.query(`INSERT INTO birds (id, workspace_id, name, tag_id, species, photo_data_url, public_profile_code, public_profile_enabled) + VALUES ($1, $2, 'Preserved bird', $3, 'Parrot', $4, $5, TRUE)`, [bird, source.workspace, tagId, photo, publicCode]); + await db.query(`INSERT INTO weight_records (bird_id, weight_grams, recorded_on) VALUES ($1, 120, CURRENT_DATE)`, [bird]); + await db.query(`INSERT INTO vet_visits (bird_id, visited_on, clinic_name, reason) VALUES ($1, CURRENT_DATE, 'Clinic', 'Checkup')`, [bird]); + const med = (await db.query(`INSERT INTO medications (bird_id, name, dosage, frequency, start_date) VALUES ($1, 'Existing medication', '1 ml', 'Daily', CURRENT_DATE) RETURNING id`, [bird])).rows[0].id; + await db.query(`INSERT INTO medication_administrations (medication_id, bird_id, administered_on, status) VALUES ($1, $2, CURRENT_DATE, 'administered')`, [med, bird]); + const behaviorType = (await db.query(`INSERT INTO behavior_types (workspace_id, name) VALUES ($1, 'Existing custom behavior') RETURNING id`, [source.workspace])).rows[0].id; + await db.query(`INSERT INTO behavior_occurrences (bird_id, behavior_type_id, occurred_at, notes) VALUES ($1, $2, NOW(), 'Existing occurrence')`, [bird, behaviorType]); + const birdNote = (await db.query(`INSERT INTO flock_notes (workspace_id, bird_id, title, body) VALUES ($1, $2, 'Bird note', 'Keep with bird') RETURNING id`, [source.workspace, bird])).rows[0].id; + await db.query(`INSERT INTO flock_notes (workspace_id, title, body) VALUES ($1, 'Flock only', 'Keep in source flock')`, [source.workspace]); + const transferCode = randomUUID().slice(0, 20); + await db.query(`INSERT INTO bird_transfer_codes (code, bird_id, source_workspace_id, requested_by_user_id) VALUES ($1, $2, $3, $4)`, [transferCode, bird, source.workspace, source.user]); + await db.query(`INSERT INTO pending_bird_transfers (bird_id, source_workspace_id, destination_owner_email, requested_by_user_id) VALUES ($1, $2, 'pending@example.test', $3)`, [bird, source.workspace, source.user]); + // A late failure must roll back the bird, notes, and transfer changes together. + await assert.rejects(() => removeBirdFromFlock(bird, source.workspace, randomUUID())); + assert.equal((await db.query(`SELECT workspace_id FROM birds WHERE id = $1`, [bird])).rows[0].workspace_id, source.workspace); + assert.equal((await db.query(`SELECT revoked_at FROM bird_transfer_codes WHERE code = $1`, [transferCode])).rows[0].revoked_at, null); + server = spawn(process.execPath, [fileURLToPath(new URL('../dist/app.js', import.meta.url))], { cwd: '/tmp', env: process.env, stdio: ['ignore', 'pipe', 'pipe'] }); + server.stdout.on('data', (data) => { output += data; }); server.stderr.on('data', (data) => { output += data; }); + for (let i = 0; i < 100 && !output.includes('listening'); i++) await new Promise((resolve) => setTimeout(resolve, 100)); + assert.match(output, /listening/, output); + async function api(account, path, method = 'GET', body, status = 200) { + const response = await fetch(`http://127.0.0.1:55440/api${path}`, { method, headers: { 'Content-Type': 'application/json', ...(account ? { Authorization: `Bearer ${account.token}` } : {}) }, ...(body ? { body: JSON.stringify(body) } : {}) }); + const data = response.status === 204 ? null : await response.json(); + if (status !== null) assert.equal(response.status, status, JSON.stringify(data)); + return { status: response.status, data }; + } + const matchPath = `/birds/unassigned-match?${new URLSearchParams({ tagId })}`; + assert.deepEqual((await api(destination, matchPath)).data, { available: false }); + await api(destination, '/birds/claim', 'POST', { tagId, confirmHistory: true }, 409); + await api(destination, `/birds/${bird}`, 'DELETE', undefined, 404); + await api(source, `/birds/${bird}`, 'DELETE', undefined, 204); + const removed = (await db.query(`SELECT * FROM birds WHERE id = $1`, [bird])).rows[0]; + assert.equal(removed.workspace_id, null); assert.equal(removed.photo_data_url, photo); assert.equal(removed.public_profile_enabled, false); + for (const table of ['weight_records', 'vet_visits', 'medications', 'medication_administrations', 'behavior_occurrences', 'flock_notes']) { + assert.equal((await db.query(`SELECT COUNT(*)::int AS count FROM ${table} WHERE bird_id = $1`, [bird])).rows[0].count, 1, table); + } + assert.equal((await db.query(`SELECT workspace_id FROM flock_notes WHERE id = $1`, [birdNote])).rows[0].workspace_id, null); + assert.ok((await db.query(`SELECT revoked_at FROM bird_transfer_codes WHERE code = $1`, [transferCode])).rows[0].revoked_at); + assert.equal((await db.query(`SELECT COUNT(*)::int AS count FROM pending_bird_transfers WHERE bird_id = $1`, [bird])).rows[0].count, 0); + assert.equal((await api(source, '/birds')).data.birds.length, 0); + assert.equal((await api(source, '/notes')).data.notes.length, 1); + assert.equal((await api(source, `/birds/${bird}/weights`)).data.weights.length, 0); + await api(null, `/public/birds/${publicCode}`, 'GET', undefined, 404); + assert.deepEqual((await api(destination, matchPath)).data, { available: true }); + await api(null, matchPath, 'GET', undefined, 401); + await api(destination, '/birds/unassigned-match?tagId=unknown', 'GET', undefined, 400); + assert.deepEqual((await api(destination, `/birds/unassigned-match?tagId=${encodeURIComponent(tagId.slice(0, -1))}`)).data, { available: false }); + await api(destination, '/birds/claim', 'POST', { tagId }, 400); + await db.query(`UPDATE workspace_members SET role = 'viewer' WHERE user_id = $1`, [destination.user]); + await api(destination, matchPath, 'GET', undefined, 403); + await api(destination, '/birds/claim', 'POST', { tagId, confirmHistory: true }, 403); + await db.query(`UPDATE workspace_members SET role = 'owner' WHERE user_id = $1`, [destination.user]); + await db.query(`UPDATE workspaces SET rescue_verification_status = 'pending' WHERE id = $1`, [destination.workspace]); + await api(destination, '/birds/claim', 'POST', { tagId, confirmHistory: true }, 402); + await db.query(`UPDATE workspaces SET rescue_verification_status = 'approved' WHERE id = $1`, [destination.workspace]); + assert.equal((await api(destination, '/birds', 'POST', { name: 'New name should not replace existing', species: 'Parrot', tagId }, 409)).data.code, 'bird_history_available'); + await assert.rejects(() => claimUnassignedBird(tagId, destination.workspace, randomUUID())); + assert.equal((await db.query(`SELECT workspace_id FROM birds WHERE id = $1`, [bird])).rows[0].workspace_id, null); + const claimed = (await api(destination, '/birds/claim', 'POST', { tagId: ` ${tagId.toLowerCase()} `, confirmHistory: true })).data; + assert.equal(claimed.bird.id, bird); assert.equal(claimed.bird.name, 'Preserved bird'); assert.equal(claimed.historyImported, true); assert.equal(claimed.bird.photoDataUrl, photo); + assert.equal((await api(destination, `/birds/${bird}/weights`)).data.weights.length, 1); + assert.equal((await api(destination, `/birds/${bird}/vet-visits`)).data.vetVisits.length, 1); + assert.equal((await api(destination, '/notes')).data.notes[0].id, birdNote); + assert.equal((await api(source, '/notes')).data.notes.length, 1); + assert.ok((await api(destination, `/birds/${bird}/behavior-types`)).data.behaviorTypes.some((type) => type.id === behaviorType)); + const timeline = (await api(destination, `/birds/${bird}/timeline`)).data.events; + assert.ok(timeline.some((event) => event.eventType === 'removed_from_flock')); + assert.ok(timeline.some((event) => event.eventType === 'joined_flock')); + await api(source, `/birds/${bird}`, 'DELETE', undefined, 404); + await api(rival, '/birds/claim', 'POST', { tagId, confirmHistory: true }, 409); + // Remove again and race two different flocks. Exactly one claim must succeed. + await api(destination, `/birds/${bird}`, 'DELETE', undefined, 204); + const race = await Promise.all([source, rival].map((account) => api(account, '/birds/claim', 'POST', { tagId, confirmHistory: true }, null))); + assert.deepEqual(race.map((result) => result.status).sort(), [200, 409]); + const bandless = randomUUID(); + await db.query(`INSERT INTO birds (id, workspace_id, name, species) VALUES ($1, $2, 'No band', 'Parrot')`, [bandless, source.workspace]); + await api(source, `/birds/${bandless}`, 'DELETE', undefined, 204); + assert.equal((await db.query(`SELECT workspace_id FROM birds WHERE id = $1`, [bandless])).rows[0].workspace_id, null); + console.log('PASS: reversible flock removal, retained profile/photo/all care records, notes isolation, sharing/transfer revocation, exact normalized band matching, explicit history consent, permissions, rollback, and concurrent claims.'); +} finally { + if (server && server.exitCode === null) { const done = once(server, 'exit'); server.kill('SIGTERM'); await done; } + await db.close(); +} diff --git a/docs/API_REFERENCE.md b/docs/API_REFERENCE.md index 254ee09..49f401c 100644 --- a/docs/API_REFERENCE.md +++ b/docs/API_REFERENCE.md @@ -1,5 +1,30 @@ # FlockPal API Reference +## Customer integration reference + +The interactive customer API reference is available at **`/api/docs/`** on your +FlockPal instance (locally, `http://localhost:5000/api/docs/`). Download the +OpenAPI 3.0 specification at **`/api/openapi.json`**. There is also a link in +Settings → Integration tokens. + +Create an integration token in Settings, then paste it into Swagger's **Authorize** +dialog without the `Bearer` prefix. Use `read_only` for reading or `read_write` +for changes. Tokens apply to their originating workspace and the creator's +current membership permissions. Swagger's **Try it out** makes real API requests. + +The customer reference covers integration-token endpoints only. The broader +application reference below also includes browser-session and administrative APIs. + +### Maintaining the interactive reference + +- Request validators live in `backend/src/schemas.ts` and are shared with route handlers. +- Customer operations are explicitly registered in `backend/src/docs/openapi.ts`. +- Response models live in `backend/src/docs/responses.ts`; update them when serialized responses change. +- `backend/src/docs/openapi.test.ts` validates OpenAPI, compares customer coverage against actual route middleware, and checks locally served Swagger assets and security headers. +- Run `npm run build` and `npm test` in `backend` after changes. +- The Zod-to-OpenAPI dependency is pinned to the Zod 3-compatible release; upgrade both together. + + This document describes the HTTP API currently implemented in `backend/src/app.ts`. ## Base URLs @@ -933,7 +958,7 @@ Possible errors: #### `DELETE /api/birds/:birdId` -Requires auth with write access and role `owner`, `assistant`, or `caregiver`. Deletes a bird. +Requires auth with write access and role `owner`, `assistant`, or `caregiver`. Removes the bird from its current flock without deleting its profile, photo, or care history. Bird-specific notes stay with the bird. Public sharing is disabled and pending transfers are revoked. Workspace audit logs and flock-wide notes remain in the source flock. Response `204` with no body. @@ -941,6 +966,22 @@ Possible errors: - `404` if the bird does not exist in the active workspace +#### `GET /api/birds/unassigned-match?tagId=…` + +Requires auth and role `owner`, `assistant`, or `caregiver`. Returns `{ "available": true }` only for an unassigned, non-memorialized bird whose band ID matches exactly after trimming and ignoring letter case. No profile, history, or former-flock details are disclosed. Blank/unknown IDs return `400`; partial IDs do not match. + +#### `POST /api/birds/claim` + +Requires auth with write access and role `owner`, `assistant`, or `caregiver`. + +```json +{ "tagId": "BAND-123", "confirmHistory": true } +``` + +Returns `200` with `{ "bird": { ... }, "historyImported": true }`. Adds the existing unassigned bird to the current flock using its saved profile and history. The bird's ID and photo are preserved; bird-specific notes follow it. Public sharing remains disabled until explicitly enabled. Competing requests are serialized so only one flock can claim a bird. + +Returns `400` without explicit history confirmation, or `409` if no matching unassigned bird remains. Creating a new profile via `POST /api/birds` with an unassigned bird's band ID returns `409` with code `bird_history_available` instead of duplicating or overwriting its profile. + ### Weights #### `GET /api/birds/:birdId/weights` @@ -1266,3 +1307,7 @@ curl -X POST http://localhost:5000/api/auth/magic-link/request \ curl http://localhost:5000/api/auth/session \ -H 'Authorization: Bearer YOUR_SESSION_TOKEN' ``` + +### Behavior Journal + +Behavior types and occurrences are available under `/birds/{birdId}/behavior-types` and `/birds/{birdId}/behaviors`. The interactive reference documents request/response schemas and permissions. See [Behavior Journal](BEHAVIOR_JOURNAL.md) for timestamp semantics, flock scoping, and isolated workflow tests. diff --git a/docs/BEHAVIOR_JOURNAL.md b/docs/BEHAVIOR_JOURNAL.md new file mode 100644 index 0000000..f077869 --- /dev/null +++ b/docs/BEHAVIOR_JOURNAL.md @@ -0,0 +1,68 @@ +# Behavior Journal + +Open **Flock → select a bird → Behavior Journal** (calendar tab). Select a behavior or create a custom one, confirm the current date/time, and save. Duration in seconds, intensity from 1–5, and notes are optional. Open a day's occurrence to see its details, edit it, or delete it with confirmation. + +The bird and behavior selectors filter the journal. The calendar displays one month at a time, daily counts and up to three dots (plus a `+` for additional events). Select a day to review its individual events. The count above the calendar reflects the selected behavior and displayed month. + +## Storage and access + +The existing `ensureSchema` startup migration creates `behavior_types` and `behavior_occurrences` and idempotently seeds nine common behaviors. No separate migration command is required. Occurrences reference existing birds and normalized behavior types. They retain `TIMESTAMPTZ` occurrence, created, and updated timestamps; optional duration in seconds; optional intensity; and notes. Indexes support bird/date and bird/behavior/date queries. + +Custom behavior names are reusable within a flock and unique ignoring case. Default types are explicitly marked so orphaned custom types never become public. A transferred bird retains its occurrences and the types used in those occurrences, even if its old flock is deleted. Other custom types from its former flock remain private. + +Existing session/integration-token authentication, flock roles, subscription restrictions, memorialized-bird restrictions, and audit logging apply. Owners, assistants, and caregivers can record/edit/delete; viewers can read. Queries and mutations check the bird's current flock. Writes also check flock ownership and memorialization inside the SQL statement. + +The browser uses its device time zone for entry and calendar grouping, consistently with local date/time controls. Month boundaries are converted to UTC for the API's inclusive `from`, exclusive `to` range. Stored timestamps are not replaced by dates or daily totals. An unchanged edit retains the original timestamp, including sub-second precision. During a daylight-saving repeated hour, a newly entered ambiguous local time uses the browser's earlier offset; an existing event retains its original instant when its time is unchanged. + +This feature records observations and occurrence timing. It adds no diagnostic interpretation or behavioral analysis. + +## API + +The interactive API reference includes these endpoints: + +| Method | Path | Purpose | +| --- | --- | --- | +| GET | `/api/birds/:birdId/behavior-types` | Available default, flock, and transferred-history types | +| POST | `/api/birds/:birdId/behavior-types` | Create/reuse a custom type (`name`, optional `description`) | +| GET | `/api/birds/:birdId/behaviors?from=…&to=…&behaviorTypeId=…` | Events in a positive range of at most 32 days; optional type filter | +| POST | `/api/birds/:birdId/behaviors` | Create an occurrence | +| PUT | `/api/birds/:birdId/behaviors/:occurrenceId` | Replace the editable fields | +| DELETE | `/api/birds/:birdId/behaviors/:occurrenceId` | Delete an occurrence | + +Occurrence input: `behaviorTypeId`, offset-bearing `occurredAt`, optional/null `durationSeconds` (positive, at most one year), `severity` (integer 1–5), and `notes` (at most 10,000 characters). Responses include the behavior name and timestamps, allowing complete details to open without another request. + +## Isolated verification + +Use a disposable copy/install when the local dependency or build directories belong to a container. Do not point these scripts at a real flock database. The integration scripts use fixed test-only database settings on port 55439 and API port 55440. They create fixtures with distinct flock IDs and leave them in the disposable database for inspection. + +```sh +docker run --detach --rm --name flockpal-behavior-test-db \ + -e POSTGRES_PASSWORD=behavior_test_only -e POSTGRES_DB=behavior_test \ + -p 127.0.0.1:55439:5432 postgres:16-alpine +cd backend +npm ci +npm run build +npm test +node test-integration/behaviorJournal.mjs +``` + +The API integration check covers schema repeatability, seeded/custom types, duplicate custom names, independent events, create/edit/delete, bird/behavior/month filters, timestamp precision, invalid inputs, unauthenticated requests, viewer/read-only/memorialized restrictions, cross-flock access, and transfer history. + +For the optional browser check, install Playwright in a disposable frontend install (it is not an application dependency), with the built backend alongside it: + +```sh +cd ../frontend +npm ci +npm run build +npm install --no-save --package-lock=false playwright +npx playwright install chromium +node test-integration/behaviorJournal.mjs +``` + +The browser check starts and stops its own API and Vite server (port 55441). It covers the complete entry/custom behavior/edit/delete workflow, bird and behavior filters, day selection and daily counts, month navigation, local midnight and daylight-saving boundaries, and a 390px mobile layout. It writes screenshots to `/tmp/flockpal-behavior-mobile.png` and `/tmp/flockpal-behavior-desktop.png`. + +After verification, stop only the disposable database: + +```sh +docker stop flockpal-behavior-test-db +``` diff --git a/docs/BIRD_MEMBERSHIP.md b/docs/BIRD_MEMBERSHIP.md new file mode 100644 index 0000000..f2dad5e --- /dev/null +++ b/docs/BIRD_MEMBERSHIP.md @@ -0,0 +1,50 @@ +# Removing and re-adding a bird + +**Remove from flock** now unassigns the bird. It does not delete the bird profile, photo, weights, vet visits, medication/dose records, Behavior Journal, timeline, or bird-specific notes. + +The bird disappears from the old flock's lists and care-record access. Its public profile is disabled, open transfer codes are revoked, and pending transfers are cancelled. Existing reminders find birds through their current flock, so unassigned birds do not enter future reminder selections. Removal is recorded in the bird timeline and the old flock's audit log. + +Bird-specific notes follow the bird. Flock-wide notes and workspace audit history stay with the original flock. Removal and claiming keep the bird's ID, so care history is preserved without copying or combining records. + +## Adding an existing unassigned bird + +In **Add bird**, enter the band ID. FlockPal checks for an unassigned, non-memorialized match after typing pauses. Matching follows the existing global band-ID convention: ignore surrounding whitespace and letter case, but otherwise require the entire ID. Blank/unknown placeholders and partial IDs cannot recover a bird. + +A match displays a notice that the saved profile, photo, notes, and care history will be brought in, with an **Add bird with existing history** button. Confirmation is required. Saved profile details are used rather than overwriting them with draft fields. No new name or species is required for this path. Before confirmation, the lookup returns only availability, not the previous profile or flock details. + +A bird already assigned to a flock cannot be claimed this way; use the existing transfer flow. Claims use a database row lock so simultaneous requests from different flocks cannot both succeed. Memorialized birds remain read-only. + +Birds without band IDs can still be removed and retained, but they cannot be automatically recovered through the band-ID workflow. The removal confirmation explains this. Previously hard-deleted records cannot be restored by this change. + +## Schema and API + +The startup `ensureSchema` migration allows `birds.workspace_id` and bird-specific `flock_notes.workspace_id` to be null. Removal, note reassignment, transfer revocation, and timeline recording run in a transaction. Claiming and its note/timeline changes also run in a transaction. A failure rolls the entire change back. + +The existing `DELETE /api/birds/:birdId` now removes flock membership and still returns `204`. New endpoints: + +- `GET /api/birds/unassigned-match?tagId=…` returns `{ "available": true | false }`. +- `POST /api/birds/claim` accepts `{ "tagId": "…", "confirmHistory": true }` and returns the existing bird plus `historyImported: true`. + +Both require authenticated owner, assistant, or caregiver membership. Claiming also requires write access. Creating a new profile with an unassigned band's ID returns `409` / `bird_history_available`; it never overwrites history. + +## Verification + +Use the disposable PostgreSQL/API setup in [Behavior Journal testing](BEHAVIOR_JOURNAL.md#isolated-verification), then run: + +```sh +cd backend +npm run build +npm test +node test-integration/birdMembership.mjs +``` + +The integration check covers repeated schema startup, retained profile/photo/history, notes separation, source access removal, disabled sharing, transfer revocation, exact/case-insensitive band matching, explicit confirmation, role/billing restrictions, transaction rollback, and competing claims. + +With Playwright installed in the disposable frontend install as described in that guide: + +```sh +cd frontend +node test-integration/birdMembership.mjs +``` + +The browser check exercises desktop removal, the mobile match notice, cancellation, confirmed recovery without replacement profile fields, and restored notes/timeline. It uses ports 55439–55441 and writes a notice screenshot to `/tmp/flockpal-existing-history-notice.png`. No real flock data is used. diff --git a/frontend/index.html b/frontend/index.html index 4d7fc99..396a0d2 100644 --- a/frontend/index.html +++ b/frontend/index.html @@ -8,6 +8,7 @@ type="image/svg+xml" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 64 64'%3E%3Cdefs%3E%3ClinearGradient id='featherFill' x1='0%25' y1='0%25' x2='100%25' y2='100%25'%3E%3Cstop offset='0%25' stop-color='%23cb3a35'/%3E%3Cstop offset='30%25' stop-color='%23f0b63f'/%3E%3Cstop offset='58%25' stop-color='%23238a5a'/%3E%3Cstop offset='100%25' stop-color='%232769b3'/%3E%3C/linearGradient%3E%3C/defs%3E%3Cpath d='M50.8 10.4C37.9 10.3 27 18.5 22.7 31.1c-3.1 9.1-2.1 18.5-8.6 24.8c-1.5 1.5-0.2 4 1.9 3.6c8.4-1.5 14.6-6.7 18.6-13.7c1 0.5 2.2 0.8 3.4 0.8c3.5 0 6.5-2.3 7.5-5.4c1.9-0.4 3.7-1.3 5.1-2.7c2-2 3-4.6 3.1-7.2c3.3-5.8 4.9-12.9 1.4-20.2c-0.7-1.3-2-0.7-4.3-0.7Z' fill='url(%23featherFill)'/%3E%3Cpath d='M18 56c8.5-3.4 14.2-9.8 18.1-17.8M26.9 48.9c6.9-7.2 13.5-14.8 20.3-22.1M31.8 41.2c6.4-1.3 12.1-4.6 16.5-9.4M36.8 33.8c4.9-0.9 9.2-3.4 12.6-7.1' fill='none' stroke='%23fff8ef' stroke-linecap='round' stroke-width='2.6'/%3E%3Cpath d='M18 56c8.5-3.4 14.2-9.8 18.1-17.8' fill='none' stroke='%2363562d' stroke-linecap='round' stroke-width='2.2'/%3E%3C/svg%3E" /> + FlockPal diff --git a/frontend/src/App.tsx b/frontend/src/App.tsx index 193e3c5..0d523aa 100644 --- a/frontend/src/App.tsx +++ b/frontend/src/App.tsx @@ -1,3 +1,4 @@ +import { BehaviorJournal } from './BehaviorJournal'; import { useEffect, useMemo, useState, type CSSProperties, type Dispatch, type SetStateAction } from 'react'; import birdSilhouette from './assets/bird-silhouette.jpg'; import flockPalLandingArt from './assets/flockpal-landing-art.png'; @@ -252,7 +253,7 @@ type AuditLogEntry = { type BirdTimelineEvent = { id: string; birdId: string; - eventType: 'profile_created' | 'transferred' | 'location_updated' | 'owner_changed' | 'manual_note'; + eventType: 'profile_created' | 'transferred' | 'location_updated' | 'owner_changed' | 'manual_note' | 'removed_from_flock' | 'joined_flock'; fromWorkspaceId: number | null; toWorkspaceId: number | null; fromWorkspaceName: string | null; @@ -458,7 +459,7 @@ type WeightDropAlert = { }; type DismissibleAlertType = 'weight-range' | 'weight-drop' | 'vet-visit'; -type BirdDetailTab = 'info' | 'weight' | 'vet' | 'notes' | 'reports' | 'timeline' | 'audit'; +type BirdDetailTab = 'behavior' | 'info' | 'weight' | 'vet' | 'notes' | 'reports' | 'timeline' | 'audit'; type DismissedAlertMap = Record; type PhotoCropState = { @@ -1174,6 +1175,9 @@ const formatAuditAction = (value: string) => .join(' '); const formatBirdTimelineTitle = (event: BirdTimelineEvent) => { + if (event.eventType === 'removed_from_flock') return 'Removed from flock'; + if (event.eventType === 'joined_flock') return 'Joined flock with history'; + if (event.eventType === 'profile_created') { return 'Added to flock'; } @@ -1194,6 +1198,9 @@ const formatBirdTimelineTitle = (event: BirdTimelineEvent) => { }; const formatBirdTimelineDescription = (event: BirdTimelineEvent) => { + if (event.eventType === 'removed_from_flock') return `Left ${event.fromWorkspaceName || 'previous flock'}; history retained.`; + if (event.eventType === 'joined_flock') return `Joined ${event.toWorkspaceName || 'current flock'} with existing history.`; + if (event.eventType === 'profile_created') { return event.locationLabel ? `Location: ${event.locationLabel}` : `Flock: ${event.toWorkspaceName || 'Unknown flock'}`; } @@ -1272,6 +1279,9 @@ const getBirdHatchDay = (bird: Pick) => { }; const getBirdTimelineGraphLabel = (event: BirdTimelineEvent) => { + if (event.eventType === 'removed_from_flock') return 'Removed from flock'; + if (event.eventType === 'joined_flock') return 'Joined flock with history'; + if (event.eventType === 'location_updated') { return event.locationLabel || 'Location updated'; } @@ -2208,6 +2218,12 @@ function App() { const [integrationTokenForm, setIntegrationTokenForm] = useState(emptyIntegrationTokenForm); const [flockNoteForm, setFlockNoteForm] = useState(emptyFlockNoteForm); const [birdForm, setBirdForm] = useState(emptyBirdForm); + const [unassignedBirdMatch, setUnassignedBirdMatch] = useState<{ + tagId: string; status: 'idle' | 'loading' | 'available' | 'none' | 'error'; + }>({ tagId: '', status: 'idle' }); + const matchingUnassignedBird = !editingBirdId && unassignedBirdMatch.status === 'available' + && unassignedBirdMatch.tagId === birdForm.tagId.trim().toLowerCase(); + const [birdImportPreview, setBirdImportPreview] = useState(null); const [birdImportFileName, setBirdImportFileName] = useState(''); const [birdImportNotice, setBirdImportNotice] = useState(''); @@ -2332,12 +2348,33 @@ function App() { [auditLogEntries, selectedBird], ); + useEffect(() => { + const tagId = birdForm.tagId.trim().toLowerCase(); + if (!authToken || !birdEditorOpen || editingBirdId || !tagId || ['unknown', 'not recorded', 'n/a', 'na', 'none'].includes(tagId)) { + setUnassignedBirdMatch({ tagId, status: 'idle' }); + return; + } + const controller = new AbortController(); + setUnassignedBirdMatch({ tagId, status: 'loading' }); + const timer = window.setTimeout(async () => { + try { + const response = await apiFetch(`/birds/unassigned-match?${new URLSearchParams({ tagId })}`, authToken, { signal: controller.signal }); + if (!response.ok) throw new Error('Unable to check band ID.'); + const data = await response.json() as { available: boolean }; + if (!controller.signal.aborted) setUnassignedBirdMatch({ tagId, status: data.available ? 'available' : 'none' }); + } catch { + if (!controller.signal.aborted) setUnassignedBirdMatch({ tagId, status: 'error' }); + } + }, 350); + return () => { window.clearTimeout(timer); controller.abort(); }; + }, [authToken, workspace?.id, birdEditorOpen, editingBirdId, birdForm.tagId]); + useEffect(() => { setDismissedAlerts(readDismissedAlerts()); }, [workspace?.id]); useEffect(() => { - setSelectedBirdTab('info'); + setSelectedBirdTab((current) => current === 'behavior' ? 'behavior' : 'info'); setBirdTimelineEvents([]); setBirdTimelineEventForm(emptyBirdTimelineEventForm); setBirdTimelineNotice(null); @@ -4224,6 +4261,37 @@ function App() { } }; + const handleClaimUnassignedBird = async () => { + if (!matchingUnassignedBird || savingBird) return; + const tagId = birdForm.tagId.trim(); + if (!window.confirm(`Add the bird with band ID ${tagId} to this flock?\n\nIts saved profile, photo, notes, and care history will be brought in. The existing profile details will be used instead of any new details entered here.`)) return; + setSavingBird(true); + setError(''); + try { + const response = await apiFetch('/birds/claim', authToken, { + method: 'POST', headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ tagId, confirmHistory: true }), + }); + if (!response.ok) throw new Error(await readErrorMessage(response, 'Unable to add the existing bird.')); + const data = await response.json() as { bird: Bird }; + setBirds((current) => sortBirdsByName([...current.filter((bird) => bird.id !== data.bird.id), data.bird])); + setSelectedBirdId(data.bird.id); + setEditingBirdId(data.bird.id); + setBirdForm(toBirdForm(data.bird)); + setBirdPhotoName(''); + setBirdEditorOpen(false); + setActivePage('flock'); + setUnassignedBirdMatch({ tagId: '', status: 'idle' }); + // Refresh notes without treating a successful claim as failed if this secondary request fails. + void apiFetch('/notes', authToken).then(async (notesResponse) => { + if (notesResponse.ok) setFlockNotes(((await notesResponse.json()) as { notes: FlockNote[] }).notes); + }).catch(() => setError('Bird added with its history. Refresh the flock to load its notes.')); + window.alert(`${data.bird.name} was added with its existing profile and care history.`); + } catch (claimError) { + setError(claimError instanceof Error ? claimError.message : 'Unable to add the existing bird.'); + } finally { setSavingBird(false); } + }; + const handleBirdSubmit = async (event: React.FormEvent) => { event.preventDefault(); setError(''); @@ -4842,7 +4910,7 @@ function App() { } const confirmed = window.confirm( - `Remove ${selectedBird.name} from the flock?\n\nThis will also remove weight records and vet visits for this flock member.`, + `Remove ${selectedBird.name} from the flock?\n\nThe bird will leave this flock, but its profile, photo, notes, and care history will be retained. Public sharing and pending transfers will be disabled. Someone adding its exact band ID can bring the bird and its history into their flock.${selectedBird.tagId ? '' : '\n\nThis bird has no band ID, so its history cannot be automatically matched later.'}`, ); if (!confirmed) { @@ -4862,6 +4930,7 @@ function App() { } const nextBirds = birds.filter((bird) => bird.id !== selectedBird.id); + setFlockNotes((current) => current.filter((note) => note.birdId !== selectedBird.id)); setBirds(nextBirds); setAllBirdWeights((current) => { const next = { ...current }; @@ -6193,17 +6262,17 @@ function App() {