ENGINEERING // CLIENT_LIBRARIES

CLIENT LIBRARIES.

Browser, TypeScript, and Python clients built against the same published contract. Use automatic retries, consistent errors, and pagination helpers without rebuilding the plumbing.

BROWSER

PixelBridge (web)

<script async src="https://sdk.qubitnotion.com/v1/sdk.js"></script>

First-party event collection

Consent gating before any event fires

Event deduplication with server events

No third-party cookies

AVAILABLE

BROWSER, TYPED

@qubitnotion/pixel

npm install @qubitnotion/pixel

Typed wrapper over the hosted pixel script

Consent-first: nothing identifiable before you call consent

Email and phone hashed in the browser

Safe to import in server-rendered code

RELEASE PENDING

TYPESCRIPT / JAVASCRIPT

@qubitnotion/sdk

npm install @qubitnotion/sdk

Covers every live /api/v1 endpoint

Full TypeScript definitions

Automatic retry honouring Retry-After

Pagination helper over limit and offset

AVAILABLE

PYTHON 3.10+

qubitnotion

pip install qubitnotion

Standard library only, no dependencies

Same methods and errors as the TypeScript client

Automatic retry honouring Retry-After

Pagination helper over limit and offset

AVAILABLE

INITIALIZATION_SEQUENCE

QUICK START

PixelBridge, available today

<script>
(function(w,d,s){
  w.QubitNotion = w.QubitNotion || function(){
    (w.QubitNotion.q = w.QubitNotion.q || []).push(arguments);
  };
  w.QubitNotion.p = 'YOUR_PIXEL_CODE';
  w.QubitNotion.e = 'https://sdk.qubitnotion.com/v1/ingest';
  var f = d.getElementsByTagName(s)[0], j = d.createElement(s);
  j.async = true; j.src = 'https://sdk.qubitnotion.com/v1/sdk.js';
  f.parentNode.insertBefore(j, f);
})(window, document, 'script');

// Nothing is collected until consent is granted
QubitNotion('consent', { analytics_storage: 'granted', ad_storage: 'denied' });

QubitNotion('event', 'purchase', {
  value: 249.00,
  currency: 'AED',
  event_id: 'ord_10482'   // deduplicates against your server event
});
</script>

TypeScript SDK, available today

import { createClient } from '@qubitnotion/sdk';

const qn = createClient({
  apiKey: process.env.QUBIT_NOTION_API_KEY,
  baseURL: 'https://api.qubitnotion.com/v1',
});

// Send a batch of server-side events
await qn.events.createBatch({
  events: [
    { type: 'purchase', user_id: 'usr_123', value: 249.00, currency: 'AED' }
  ]
});

// Paginate through plans
for await (const page of qn.plans.list({ limit: 20 })) {
  console.log(page.id);
}

Python SDK, available today

from qubitnotion import QubitNotion

qn = QubitNotion(api_key="qn_live_...")

# Send a batch of server-side events
qn.track("8f3c...-pixel-uuid", [
    {
        "event_id": "ord_10482",
        "event_name": "purchase",
        "value": 249.00,
        "currency": "AED",
        "identity": {"email": "buyer@example.com"},
        "consent": {"analytics": True, "marketing": True},
    }
], idempotency_key="ord_10482")

# Paginate through plans
for plan in qn.paginate("/api/v1/plans", limit=20):
    print(plan["id"])

Your pixel id and installation snippet are in the workspace under PixelBridge. Workspace API keys can be created by admins in App Studio once the REST API v1 beta is enabled.

What the clients handle for you

Both server clients use the same endpoint contract and error model. They respect Retry-After on rate limits and temporary failures, expose list pagination, and keep credentials on the server. PixelBridge separately handles consent-aware browser events and deduplicates them against server events when both carry the same event id.

Scoped credentialsAutomatic backoffConsistent errorsEvent deduplication

RETURN TO ENGINEERING TERMINAL