sdk docs
/
install + events + security
SDK installation
Copy-paste installs, versioned contracts, and safety defaults — from loader to ingest to hardening.
/
Press
/
to search,
Esc
to clear.
SDK install
Copy-paste patterns you can ship safely
versioned
Web SDK
Next.js
Server API
Security & abuse controls
More adapters coming
Web SDK (Script install)
Drop-in script with deterministic delivery, session-scoped IDs, and a bounded event contract.
Pilot
Install in under 2 minutes
Loader is idempotent; events batch automatically; unknown events are ignored safely.
• Init: tenantId + env + apiKey
• Track: page_view + key UI signals
• Perf: sampling + batching
Common surfaces
https://cdn.yourdomain.com/minerva.js
minerva.init({ tenantId, env, apiKey })
minerva.track(name, payload)
Next.js (App Router)
Client component wrapper + route change tracking with stable event naming and safe hydration.
Pilot
Server API (Event ingest)
Ingest endpoint for event batches with strict validation, idempotency, and durable receipts.
Pilot
Security & abuse controls
Hardening patterns: domain allowlists, signature validation, rate limits, and origin anomaly alerts.
Pilot
Shopify (App + extensions)
Installable package that wires the SDK into checkout-safe surfaces with receipts tied to orderId.
Pilot
WooCommerce (Adapter-first)
Hooks into server-side totals calculation; idempotent apply paths and explicit deny behavior.
In progress
•
Q2
bounded telemetry
•
perf safe
•
abuse ready
sdk
Web SDK (Script install)
Drop-in script with deterministic delivery, session-scoped IDs, and a bounded event contract.
Install-first playbook — safe defaults, bounded telemetry, deterministic receipts.
Overview
Quickstart
API
Examples
What you get
Lightweight loader with retry/backoff and idempotent init.
Session-scoped identifiers (no PII required).
Event contract is versioned; unknown events are ignored safely.
Sampling + batching to protect performance.
Rollout
step 1
observe-only (events only)
step 2
sampling + batching tuned
step 3
enable decision calls
escape
killswitch → no-op
Defaults
scope
session
contract
events v1
perf
<2ms sync init
fallback
no-op safe
privacy
no PII required
Observability
events
batched + acked
drops
reason-coded
latency
p50/p95 client
errors
init + transport
replay
requestId thread
Press
/
to search.