feat(OUT-4005): payout sync table schema + migration [1/4]

[SandipBajracharya]

Stack 1/4 — base: OUT-4012

Adds the qb_payout_sync table (schema + migration) that stores the payout payload so a failed reconciliation can be rebuilt on resync. Amounts are integer cents, matching line_items. Includes the schema round-trip test.

Part of the OUT-4005 payout-reconciliation stack:

1. schema + migration ← this PR
2. reconciliation service + deposit lookup
3. webhook + resync wiring
4. typecheck tooling + chore

🤖 Generated with Claude Code

[linear-code]

OUT-4005

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
quickbooks-sync (dev)	Ready	Preview	Jul 31, 2026 10:38am

[greptile-apps]

Greptile Summary

Adds persistent payout-reconciliation state and its database integration.

• Creates the qb_payout_sync table, partial unique index, migration metadata, and Drizzle schema.
• Exports the payout line-item type used by the JSONB column.
• Registers the table in the shared schema and test cleanup helper.
• Adds an integration test covering payout-row persistence and retrieval.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains; the previously missing PayoutLineItem export is now present and consumed by the payout schema.

Important Files Changed

Filename	Overview
src/db/schema/qbPayoutSync.ts	Defines the payout-sync table, typed JSONB payload, monetary and deposit fields, validation schemas, and active-row uniqueness constraint.
src/type/dto/webhook.dto.ts	Extracts and exports the payout line-item schema and inferred type, resolving the previously reported missing type export.
src/db/migrations/20260729105911_add_qb_payout_sync_table.sql	Creates the payout-sync table and its partial unique index consistently with the Drizzle schema.
test/integration/quickbooks/payoutResync/schema.test.ts	Verifies that payout records and typed JSONB line items round-trip through the database.

_{Reviews (2): Last reviewed commit: "feat(OUT-4005): add qb_payout_sync table..." | Re-trigger Greptile}

[SandipBajracharya]

@greptileai review PR again

[priosshrsth]

lgtm