Files
elegalsoftware/scripts
Leon SerfatyandClaude Fable 5 304f7f30c3 Security hardening: deps, tenancy quotas, auth, deploy, webhooks
Addresses the findings from the platform security audit. Verified green:
all-workspace typecheck, web build, 16 API unit tests, 23 e2e auth tests,
and 0 high/critical production dependency vulnerabilities.

Dependencies (High):
- Bump drizzle-orm 0.36→0.45.2 (GHSA-gpj5-g38j-94v9 SQLi-via-identifier)
  and drizzle-kit→0.31.10; npm audit fix cleared fast-uri path-traversal
  and the react-router open-redirect. Remaining audit items are dev-only
  build tooling (esbuild/vite), not shipped at runtime.

AI cost control + storage quota (new ai_usage table, migration 0002):
- Per-firm monthly AI token budget enforced before each completion (429),
  with every completion recorded to an ai_usage ledger (lib/ai-usage.ts).
- Enforce per-plan storage quota on upload (402) and maintain
  storage_bytes_used on upload/delete (lib/storage-quota.ts); widen the
  column int→bigint so 8GB/50GB plans don't overflow.

Auth (defense-in-depth):
- Constant-time login: verify against a dummy argon2 hash when the account
  doesn't exist, closing the timing/enumeration oracle (verifyPasswordSafe).
- Enforce suspension on requireSuperadmin, /auth/me, /auth/resend-verification.

Web:
- Validate the post-login ?next= redirect to same-origin paths only
  (open-redirect / phishing).

Deploy hardening:
- docker-compose: memory/CPU limits so a spike can't OOM the Dokploy host.
- .dockerignore: keep destructive one-off scripts (seed-demo, create-admin,
  migrate-storage) out of the runtime image; retain the cron scripts.
- seed-demo.ts: hard-refuse NODE_ENV=production and the prod DB host.

Webhooks / config:
- Stripe idempotency via a stripe_events ledger (skip already-processed
  events; record only after successful processing so a transient failure
  still retries); make the plan-upgraded email non-blocking.
- Rate-limit account export and invoice PDF; cap invoice item arrays at 200.
- Require TURNSTILE_SECRET_KEY in production (bot protection no longer fails
  open on a forgotten key); don't load .env under NODE_ENV=test so the suite
  is hermetic.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-17 13:34:33 -04:00
..

Operational scripts

All scripts load .env from the repo root and run against the live database/bucket — there is no staging environment. Run them from the monorepo root.

Scheduled jobs (set up as daily crons on the production server)

# Daily at 03:00 — enforce Privacy Policy retention windows
0 3 * * * cd /path/to/app && npm run cron:retention >> logs/retention.log 2>&1

# Daily at 08:00 — mark past-due invoices overdue + email client reminders
0 8 * * * cd /path/to/app && npm run cron:overdue >> logs/overdue.log 2>&1
Script npm alias What it does
retention-sweep.ts npm run cron:retention Purges expired sessions, consumed/expired reset & verification tokens, login attempts and tool usage > 90 days, contact messages and audit log > 24 months.
send-overdue-reminders.ts npm run cron:overdue Flips past-due sent invoices to overdue and emails the client once, on the transition.

Maintenance / one-off

Script npm alias What it does
sweep-orphaned-storage.ts npm run storage:sweep Reconciles DO Spaces against the documents table. Dry-run by default; add -- --delete to remove orphans. Only document-shaped keys (uuid/uuid/uuid.ext) are ever deleted.
create-admin.ts Creates a superadmin user (credentials via env/argv).
seed-demo.ts Seeds demo data. Live DB — use with care.
migrate-storage-to-spaces.ts One-time migration of legacy local files to Spaces (historical).