SDKs

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
`OBSERVE` (default)	Requests pass through, but the SDK verifies tokens, records outcomes, and attaches licensing headers. Use this during initial rollout.
`ENFORCE`	Bots without a valid token are blocked with a `401` (or `403` for a valid token that doesn’t cover the resource) and licensing headers.
`DISABLED`	No verification. 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.

Introduction

Guides

Licensing

Reference

SDK Availability

Choosing the Right API

Enforcement Modes

Language-Specific References

TypeScript SDK

PHP SDK

Python SDK

​SDK Availability

​Choosing the Right API

​Enforcement Modes

​Language-Specific References

TypeScript SDK

PHP SDK

Python SDK

SDK Availability

Choosing the Right API

Enforcement Modes

Language-Specific References