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.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.
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) |
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.TypeScript SDK
Edge-ready SDK for Cloudflare Workers, Fastly Compute, and CloudFront Lambda@Edge.
PHP SDK
Server-side SDK for WordPress and PHP applications.
Python SDK
Async server-side SDK for Python applications and crawler clients.