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 | Coming soon | 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.