# @lssm-tech/example.integration-paypal

Credential-free PayPal commerce example built on the canonical `paypalIntegrationSpec`.

## What This Demonstrates

- Canonical integration reuse from `@lssm-tech/lib.contracts-integrations`.
- Deterministic checkout, buyer approval, capture, refund, subscription, webhook, and marketplace lifecycle fixtures.
- Explicit human and policy handoffs for approval, refunds, seller onboarding, and payouts.
- A redacted sandbox connection plus stable tenant timestamps.
- No provider SDK execution, outbound network calls, or usable credentials.

## Public Entry Points

- `.` — complete example barrel.
- `./integration` — canonical PayPal integration re-export.
- `./workflow` — deterministic commerce lifecycle.
- `./blueprint` and `./tenant` — app and tenant configuration.
- `./connection.sample` — redacted connection metadata.
- `./integration-paypal.feature` — feature composition.
- `./docs` and `./docs/integration-paypal.docblock` — documentation registration.
- `./example` — example registry descriptor.

## Running Locally

From `packages/examples/integration-paypal`:

- `bun run test`
- `bun run typecheck`
- `bun run lint:check`
- `bun run build`

## Host Boundary

This package describes contracts only. A host must supply authenticated PayPal adapters, webhook verification, approval gateways, tenant isolation, and recorded policy evidence. Never put client secrets or access tokens in connection config.