> ## Documentation Index
> Fetch the complete documentation index at: https://connect-docs.supertab.co/llms.txt
> Use this file to discover all available pages before exploring further.

# SDKs

> Available SDKs, what they cover, and how to pick the right one for your integration.

Supertab Connect SDKs handle two sides of the licensing flow: crawler operators use them to obtain license tokens for protected content, and publishers use them to verify tokens and enforce access at the edge.

## SDK Availability

| Language   | Package                             | Install  | Token acquisition | Verification & enforcement | CDN runtime helpers                            |
| ---------- | ----------------------------------- | -------- | ----------------- | -------------------------- | ---------------------------------------------- |
| TypeScript | `@getsupertab/supertab-connect-sdk` | npm      | Yes               | Yes                        | Cloudflare Workers, Fastly Compute, CloudFront |
| PHP        | `getsupertab/connect-sdk-php`       | Composer | Yes               | Yes                        | —                                              |
| Python     | `supertab-connect-sdk`              | pip      | Yes               | Yes                        | —                                              |

## Choosing the Right API

| You want to...                                             | Use                                                                                                 |
| ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| Acquire a token before requesting protected content        | `obtainLicenseToken()`                                                                              |
| Check a token without side effects                         | `verify()`                                                                                          |
| Check a token and record usage for analytics/billing       | `verifyAndRecord()`                                                                                 |
| Protect a route or origin request end-to-end               | `handleRequest()`                                                                                   |
| Integrate at a supported CDN edge with minimal boilerplate | CDN runtime helper (`cloudflareHandleRequests`, `fastlyHandleRequests`, `cloudfrontHandleRequests`) |

Static methods like `obtainLicenseToken()` and `verify()` can be called without initializing a client. Methods that record events or enforce access (`verifyAndRecord`, `handleRequest`, runtime helpers) require a configured client instance with your API key.

## Enforcement Modes

Publisher-side request handling uses an enforcement mode to control what happens when automated traffic reaches protected content without a valid token.

| Mode             | Behavior                                                                                                           |
| ---------------- | ------------------------------------------------------------------------------------------------------------------ |
| `SOFT` (default) | Requests pass through, but the SDK attaches licensing headers and records events. Use this during initial rollout. |
| `STRICT`         | Bots without a valid token are blocked with a `401` and licensing headers.                                         |
| `DISABLED`       | No enforcement or signaling. Requests are allowed without licensing intervention.                                  |

## Language-Specific References

Each language reference covers installation, configuration, full method signatures, and code examples.

<CardGroup cols={2}>
  <Card title="TypeScript SDK" icon="code" href="/reference/sdk/typescript">
    Edge-ready SDK for Cloudflare Workers, Fastly Compute, and CloudFront Lambda\@Edge.
  </Card>

  <Card title="PHP SDK" icon="code" href="/reference/sdk/php">
    Server-side SDK for WordPress and PHP applications.
  </Card>

  <Card title="Python SDK" icon="code" href="/reference/sdk/python">
    Async server-side SDK for Python applications and crawler clients.
  </Card>
</CardGroup>