npm install @latimer-woods-tech/compliance

import {
  CREATE_COMPLIANCE_CONSENTS_TABLE,
  CREATE_COMPLIANCE_CONTACTS_TABLE,
  CREATE_TCPA_SUPPRESSION_TABLE,
} from '@latimer-woods-tech/compliance';

await db.execute(CREATE_COMPLIANCE_CONSENTS_TABLE);
await db.execute(CREATE_COMPLIANCE_CONTACTS_TABLE);
await db.execute(CREATE_TCPA_SUPPRESSION_TABLE);

function checkTCPA(opts: {
  db: Db;
  phone: string;
}): Promise<{ safe: boolean; reason?: string }>;

function suppressPhone(db: Db, phone: string, reason?: string): Promise<void>;

function logConsent(db: Db, opts: {
  userId: string;
  appId: string;
  consentType: 'marketing' | 'sms' | 'call' | 'terms';
  granted: boolean;
  ipAddress?: string;
  userAgent?: string;
}): Promise<ConsentRecord>;

function checkFDCPA(db: Db, opts: {
  userId: string;
  appId: string;
}): Promise<{ allowed: boolean; nextAllowedAt?: Date }>;

function recordContact(db: Db, opts: {
  userId: string;
  appId: string;
  channel: 'sms' | 'call' | 'email';
  outcome?: string;
}): Promise<ContactRecord>;

import { checkTCPA, logConsent, checkFDCPA, recordContact } from '@latimer-woods-tech/compliance';

// Before placing a call
const tcpa = await checkTCPA({ db, phone: '+15551234567' });
if (!tcpa.safe) {
  return c.json({ error: 'Phone suppressed' }, 403);
}

const fdcpa = await checkFDCPA(db, { userId: user.id, appId: 'my-app' });
if (!fdcpa.allowed) {
  return c.json({ error: 'FDCPA window not open', nextAllowedAt: fdcpa.nextAllowedAt }, 429);
}

await recordContact(db, { userId: user.id, appId: 'my-app', channel: 'call' });