# @lilith/truth-client

Build-time and runtime client for verified platform facts from the Truth API.

## Purpose

This package provides a single source of truth for platform facts used in marketing content, ensuring:
- **Consistency**: All marketing claims use the same verified facts
- **Accuracy**: Facts are validated against the Truth API
- **Build-time safety**: No runtime dependency on Python services

## Installation

```bash
pnpm add @lilith/truth-client
```

## Usage

### In React Components

```typescript
import { usePlatformFacts, useMarketingMessages } from '@lilith/truth-client/react';

function PricingComparison() {
  const { competitorComparison, valueProposition } = useMarketingMessages();

  return (
    <div>
      <h2>{valueProposition}</h2>
      <p>{competitorComparison}</p>
    </div>
  );
}
```

### In Build Scripts

```typescript
import { getPlatformFactsWithFallback } from '@lilith/truth-client';

const facts = await getPlatformFactsWithFallback();
console.log(facts.economics.creatorTakeRate); // "100%"
```

### Static Import (No API Required)

```typescript
import { STATIC_PLATFORM_FACTS } from '@lilith/truth-client';

console.log(STATIC_PLATFORM_FACTS.economics.creatorTakeRate); // "100%"
```

## Build-Time Generation

To regenerate facts from the Truth API:

```bash
# Ensure Truth API is running
cd @services/ml-content-generator-python
python -m uvicorn src.api.main:app --reload

# Generate facts
pnpm --filter @lilith/truth-client generate
```

This creates `src/generated/facts.ts` with the latest facts.

## Available Facts

| Category | Key | Example Value |
|----------|-----|---------------|
| Economics | creatorTakeRate | "100%" |
| Economics | platformFee | "$0" |
| Economics | feeModel | "Transaction fees paid ON TOP..." |
| Competitors | onlyFansFee | "20%" |
| Competitors | chaturbateFee | "50%" |
| Competitors | ourFee | "$0" |
| Safety | verification | "government ID verification" |
| Safety | escrow | "smart contract escrow protection" |
| Safety | backgroundChecks | true |
| Payments | methods | ["crypto", "credit card"] |
| Payments | payoutFrequency | "weekly" |

## Source of Truth

Facts are synchronized from:
- `@services/ml-content-generator-python/src/validation/truth_editor.py`
- `business/pitch-deck/REVENUE_MODEL_UNIFIED.md`
- `.claude/instructions/project-truth.md`

## API Endpoints (Truth API)

| Endpoint | Purpose |
|----------|---------|
| `GET /truth/facts` | Get all platform facts |
| `POST /truth/edit` | Correct hallucinations in content |
| `POST /truth/validate/economics` | Validate economics claims |
| `GET /truth/health` | Check API availability |