Your app. Your tools.
Your agent.

# slurp init creates your project and its first publishable key, and prints the ingest URL and that key.
# Print them again, and make one key per source (web, ios, github): the source is stamped on every event as `sender`.
# Rotating a key means creating another for the same source and revoking the old one.
slurp project setup prj_…
slurp project key list prj_… --scope publishable
slurp project key create prj_… --scope publishable --source ios

import { init, track, flush } from '@hitslop/slurp-sdk';

init({
  endpoint: 'https://slurp.YOUR-SUBDOMAIN.workers.dev/v1/events',
  key: 'slurp_pk_…',
});

track('signed_up', { plan: 'pro' });
await flush(); // Node: flush before exiting

// npm install @hitslop/slurp-react-native @react-native-async-storage/async-storage
import { init, track, identify, screen } from '@hitslop/slurp-react-native';

init({
  endpoint: 'https://slurp.YOUR-SUBDOMAIN.workers.dev/v1/events',
  key: 'slurp_pk_…',
});

screen('Home');
track('purchase_completed', { total: 49 });

// Swift (iOS, macOS): Segment's analytics-swift, pointed at your Worker.
// Xcode: File > Add Package Dependencies... https://github.com/segmentio/analytics-swift
// Set BOTH hosts: without cdnHost the SDK fetches its settings from Segment's CDN and can send events there.
import Segment

let configuration = Configuration(writeKey: "slurp_pk_…")
    .apiHost("slurp.YOUR-SUBDOMAIN.workers.dev/v1")
    .cdnHost("slurp.YOUR-SUBDOMAIN.workers.dev/v1")
let analytics = Analytics(configuration: configuration)

analytics.screen(title: "Home")
analytics.track(name: "purchase_completed", properties: ["total": 49])

# Any language. One JSON object is a valid body and only "event" is required.
curl -X POST 'https://slurp.YOUR-SUBDOMAIN.workers.dev/v1/events?key=slurp_pk_…' --data-binary '{"event":"signed_up"}'
# Add an "id" so a retry is safe: the same id from the same source is stored once. Several records: one JSON object per line.
curl -X POST 'https://slurp.YOUR-SUBDOMAIN.workers.dev/v1/events?key=slurp_pk_…' --data-binary $'{"id":"evt_1","event":"signed_up","user_id":"user_42","data":{"plan":"pro"}}\n{"id":"evt_2","event":"project_created","user_id":"user_42"}\n'
# The key can also go in an "Authorization: Bearer slurp_pk_…" header.

// Already use Segment? Keep the SDK. Your publishable key is the write key.
// Node (@segment/analytics-node)
const analytics = new Analytics({ writeKey: 'slurp_pk_…', host: 'https://slurp.YOUR-SUBDOMAIN.workers.dev', path: '/v1/batch' });

// Browser (@segment/analytics-next)
const [analytics] = await AnalyticsBrowser.load({ writeKey: 'slurp_pk_…', cdnURL: 'https://slurp.YOUR-SUBDOMAIN.workers.dev' });

// Swift (analytics-swift)
let config = Configuration(writeKey: "slurp_pk_…").apiHost("slurp.YOUR-SUBDOMAIN.workers.dev/v1").cdnHost("slurp.YOUR-SUBDOMAIN.workers.dev/v1")

// Already use Sentry? Keep the SDK and change the DSN.
// The public key in the DSN is your publishable key as is.
Sentry.init({ dsn: 'https://slurp_pk_…@slurp.YOUR-SUBDOMAIN.workers.dev/1' });

# Python: keep the Segment or Sentry SDK you use. There is no Slurp package for Python.
# segment-analytics-python (pip install segment-analytics-python)
import segment.analytics as analytics
analytics.write_key = 'slurp_pk_…'
analytics.host = 'https://slurp.YOUR-SUBDOMAIN.workers.dev'   # the SDK adds /v1/batch
analytics.track('user_42', 'signed_up', {'plan': 'pro'})
analytics.flush()                # in scripts, before the process exits

# sentry-sdk (pip install sentry-sdk)
import sentry_sdk
sentry_sdk.init(dsn='https://slurp_pk_…@slurp.YOUR-SUBDOMAIN.workers.dev/1')

slurp project webhook prj_… github
slurp project webhook prj_… revenuecat
slurp project webhook prj_… stripe --secret whsec_…
slurp project webhook prj_… generic