@uptimizr/sdk-core 0.1.0

package/dist/transport.js

@@ -0,0 +1,37 @@
+/**
+ * Default browser transport.
+ *
+ * Prefers `navigator.sendBeacon` so in-flight batches survive page unload, and
+ * falls back to `fetch` with `keepalive` (and finally a plain `fetch`) in
+ * environments where beacon is unavailable (including Node for tests).
+ */
+export function createBeaconTransport(endpoint) {
+    const url = endpoint.replace(/\/$/, "") + "/api/v1/collect";
+    return {
+        async send(batch) {
+            const payload = JSON.stringify(batch);
+            const nav = globalThis.navigator;
+            if (nav && typeof nav.sendBeacon === "function") {
+                const blob = new Blob([payload], { type: "application/json" });
+                return nav.sendBeacon(url, blob);
+            }
+            const fetchFn = globalThis.fetch;
+            if (typeof fetchFn !== "function") {
+                return false;
+            }
+            try {
+                const res = await fetchFn(url, {
+                    method: "POST",
+                    headers: { "content-type": "application/json" },
+                    body: payload,
+                    keepalive: payload.length < 64_000,
+                });
+                return res.ok;
+            }
+            catch {
+                return false;
+            }
+        },
+    };
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,iBAAiB,CAAC;IAE5D,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,KAAqB;YAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAEtC,MAAM,GAAG,GAAI,UAAwC,CAAC,SAAS,CAAC;YAChE,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBAChD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;gBAC/D,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACnC,CAAC;YAED,MAAM,OAAO,GAAI,UAAuC,CAAC,KAAK,CAAC;YAC/D,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;gBAClC,OAAO,KAAK,CAAC;YACf,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE;oBAC7B,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;oBAC/C,IAAI,EAAE,OAAO;oBACb,SAAS,EAAE,OAAO,CAAC,MAAM,GAAG,MAAM;iBACnC,CAAC,CAAC;gBACH,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,186 @@
+import type { AnyEvent, CapabilityChangeKind, CollectRequest, Connector, CustomPropValue, Device, Graphics, Handedness, InputSource, PageMeta, SceneMeta, SessionUser } from "@uptimizr/schema";
+/**
+ * Envelope fields the client fills in automatically. Collectors and callers only
+ * provide the event `type` and its payload — never these.
+ */
+export type EnvelopeKey = "projectId" | "visitorId" | "sessionId" | "ts" | "sdkVersion" | "url" | "sceneId" | "pageMeta";
+/**
+ * The shape a caller passes to `emit`: any event minus the auto-filled envelope.
+ * Distributes over the event union so each variant keeps its own payload typing.
+ */
+export type EventInput = AnyEvent extends infer E ? E extends AnyEvent ? Omit<E, EnvelopeKey> : never : never;
+/**
+ * Options for {@link UptimizrClient.trackInput} — a discrete keyboard/gamepad
+ * action (ADR 0023). `source` defaults to `"keyboard"`.
+ */
+export interface TrackInputOptions {
+    /** The discrete input source. Defaults to `"keyboard"`. */
+    source?: InputSource;
+    /** Raw key code (`KeyboardEvent.code`) for keyboard inputs. */
+    code?: string;
+    /** Raw button index for gamepad inputs. */
+    button?: number;
+    /** Whether this is a press (`true`) or release (`false`). Omit for a single fire. */
+    pressed?: boolean;
+    /** Handedness for paired sources, when applicable. */
+    handedness?: Handedness;
+    /** Ephemeral, session-local id correlating a concurrent source (ADR 0011). */
+    sourceId?: string;
+}
+/**
+ * A capability / fidelity transition reported to
+ * {@link UptimizrClient.reportCapabilityChange} (#49). Engines decide their
+ * backend at init and rarely expose a runtime "I downgraded" hook, so this is
+ * **app-reported**: the host app describes the fallback or recovery it performed.
+ *
+ * Privacy (ADR 0003): `from` / `to` / `reason` must be low-cardinality,
+ * app-defined tokens (e.g. `"webgpu"`, `"webgl2"`, `"high"`) — never raw device
+ * strings or PII.
+ */
+export interface CapabilityChangeReport {
+    /** What class of capability changed. */
+    kind: CapabilityChangeKind;
+    /** Previous capability/level as a short app-defined token (e.g. `"webgpu"`). */
+    from?: string;
+    /** New capability/level as a short app-defined token (e.g. `"webgl2"`). */
+    to?: string;
+    /** Optional short, app-defined reason for the change (no PII). */
+    reason?: string;
+}
+/**
+ * A transport delivers a batch to the collector. Returns `true` on success.
+ * Swappable so callers can provide a custom transport (extension point).
+ */
+export interface Transport {
+    send(batch: CollectRequest): Promise<boolean>;
+}
+/**
+ * Context handed to each collector plugin. The capture-side API surface.
+ */
+export interface CollectorContext {
+    readonly config: ResolvedConfig;
+    readonly sessionId: string;
+    /** Emit a typed event; the envelope is filled in automatically. */
+    emit(event: EventInput): void;
+    /** Convenience for emitting a `custom` event. */
+    track(name: string, props?: Record<string, CustomPropValue>): void;
+    /** Emit an `input_action` for a discrete keyboard/gamepad input (ADR 0023). */
+    trackInput(action: string, opts?: TrackInputOptions): void;
+    /** Report a capability fallback/recovery transition (#49); emits `capability_change`. */
+    reportCapabilityChange(change: CapabilityChangeReport): void;
+    /** Switch the active scene/area (ADR 0010); emits a `scene_change` marker. */
+    setScene(sceneId: string): void;
+    /** Current timestamp in epoch ms (overridable for testing). */
+    now(): number;
+}
+/** Handle returned by a collector's `start`, used to tear it down. */
+export interface CollectorHandle {
+    stop(): void;
+}
+/**
+ * A capture plugin. This is the primary SDK extension point: engine adapters
+ * (e.g. Babylon) and custom instrumentation register as collectors via
+ * `client.use(collector)`. `start` wires up listeners and returns a handle.
+ */
+export interface Collector {
+    readonly name: string;
+    start(ctx: CollectorContext): CollectorHandle | void;
+}
+/** A hook to inspect, modify, or drop an event before it is queued. */
+export type BeforeSendHook = (event: AnyEvent) => AnyEvent | null;
+/** Public configuration accepted by the client. */
+export interface UptimizrConfig {
+    /** Project identifier (public, non-secret). */
+    projectId: string;
+    /** Collector endpoint base URL, e.g. `https://collect.example.com`. */
+    endpoint: string;
+    /** Override the reported SDK version. Defaults to the package version. */
+    sdkVersion?: string;
+    /** Flush when this many events are queued. Default 20. */
+    batchSize?: number;
+    /** Flush at least this often, in ms. Default 5000. Set 0 to disable the timer. */
+    flushIntervalMs?: number;
+    /** Max events retained while offline before the oldest are dropped. Default 1000. */
+    maxQueueSize?: number;
+    /** Provide a custom transport. Defaults to a beacon/fetch transport. */
+    transport?: Transport;
+    /**
+     * Where the offload-eligible processing phase runs (ADR 0031). `"main"`
+     * (default) keeps serialization + network dispatch on the main thread —
+     * today's behaviour, byte-for-byte. `"worker"` moves *steady-state*
+     * serialization + dispatch to an opt-in Web Worker, while the terminal unload
+     * flush always stays on the main thread.
+     *
+     * Worker mode is never required for correctness: if a worker cannot be created
+     * (no `Worker`, restrictive CSP, SSR, tests) the SDK silently falls back to
+     * `"main"`. Supplying a custom {@link UptimizrConfig.transport} also disables
+     * worker offload, since a custom transport is a main-thread closure the worker
+     * cannot run; the transport is honoured on the main thread instead.
+     */
+    offload?: "main" | "worker";
+    /**
+     * Advanced bundler escape hatch: construct the offload worker yourself when
+     * the default `new Worker(new URL("./offloadWorker.js", import.meta.url))`
+     * pattern is not handled by your bundler. Only consulted when
+     * `offload: "worker"`.
+     */
+    createWorker?: () => Worker;
+    /** Inspect/modify/drop each event before queueing. */
+    beforeSend?: BeforeSendHook;
+    /** When true, the client collects nothing (e.g. respect Do-Not-Track). */
+    disabled?: boolean;
+    /**
+     * Capture generic browser lifecycle events — `viewport_resize` (debounced),
+     * `focus_change`, and `visibility_change` — so the timeline records when the
+     * canvas was resized, blurred, or backgrounded. Default true. The session
+     * flush-on-hidden and end-on-pagehide behavior is always active regardless.
+     */
+    captureLifecycle?: boolean;
+    /** Debounce window for `viewport_resize`, in ms. Default 250. */
+    resizeDebounceMs?: number;
+    /**
+     * Capture JavaScript errors and unhandled promise rejections as
+     * `runtime_error` events (`window.onerror` / `unhandledrejection`). Off by
+     * default because error text can carry PII (ADR 0013) — when enabled, use
+     * `beforeSend` to redact or drop. Consecutive identical errors are deduped and
+     * at most 50 are emitted per session.
+     */
+    captureErrors?: boolean;
+    /** Emit debug logs to the console. */
+    debug?: boolean;
+}
+/** Config with defaults applied. */
+export interface ResolvedConfig {
+    projectId: string;
+    endpoint: string;
+    sdkVersion: string;
+    batchSize: number;
+    flushIntervalMs: number;
+    maxQueueSize: number;
+    offload: "main" | "worker";
+    disabled: boolean;
+    captureLifecycle: boolean;
+    resizeDebounceMs: number;
+    captureErrors: boolean;
+    debug: boolean;
+}
+/** Optional metadata passed to `start`. */
+export interface StartMeta {
+    /** Device/GPU capabilities, supplied by engine adapters that can introspect them. */
+    device?: Device;
+    /** Underlying graphics technology (API/backend/version/shading language) (ADR 0021). */
+    graphics?: Graphics;
+    /** Coarse scene descriptor (camera kind, mesh count, description). */
+    scene?: SceneMeta;
+    /** Connector/engine provenance and the source's native coordinate frame (ADR 0018). */
+    connector?: Connector;
+    /** Caller-supplied, anonymized user context. Opt-in; never PII. */
+    user?: SessionUser;
+    /** Page/document context. */
+    pageMeta?: PageMeta;
+    /** Page URL. Defaults to `location.href` when available. */
+    url?: string;
+    /** Initial scene/area id (ADR 0010). Stamped on `session_start` and after. */
+    sceneId?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+/** Version of this SDK, stamped onto every event's envelope as `sdkVersion`. */
+export declare const SDK_VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,eAAO,MAAM,WAAW,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,3 @@
+/** Version of this SDK, stamped onto every event's envelope as `sdkVersion`. */
+export const SDK_VERSION = "0.1.0";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC"}

package/dist/xrInput.d.ts

@@ -0,0 +1,54 @@
+import type { Handedness, InputSource, Vec3 } from "@uptimizr/schema";
+/**
+ * Engine-agnostic WebXR input mapping shared by the connectors (three.js, A-Frame,
+ * Babylon, …). The per-engine XR collectors read controller pose from their own
+ * renderer / XR object and canonicalize coordinates at the emission boundary
+ * (ADR 0018); everything in this module is frame-independent — classifying a WebXR
+ * input source into the source-neutral schema vocabulary (ADR 0011) and the shared
+ * capture-option / ray-probe shapes. No new event types or fields are introduced.
+ *
+ * Privacy (ADR 0003): the only identity these collectors ever emit is the ephemeral,
+ * session-local {@link Handedness} disambiguator — never a persistent device/user id.
+ */
+/** Structural view of a WebXR `XRInputSource` (only the fields we classify on). */
+export interface XrInputSourceLike {
+    /** `"left"` / `"right"` / `"none"`. */
+    handedness?: string;
+    /** `"tracked-pointer"` / `"gaze"` / `"screen"` / `"transient-pointer"`. */
+    targetRayMode?: string;
+    /** Present for articulated-hand input. */
+    hand?: unknown;
+}
+/**
+ * Map a WebXR input source to an Uptimizr {@link InputSource} (ADR 0011):
+ * articulated hands → `hand`, gaze target-ray → `gaze`, transient/screen taps →
+ * `transient`, everything else (tracked controllers) → `xr-controller`.
+ */
+export declare function xrSource(input: XrInputSourceLike): InputSource;
+/** The paired XR hand, or `undefined` when not applicable (e.g. gaze). */
+export declare function xrHandedness(input: XrInputSourceLike): Handedness | undefined;
+/** Which XR signals a connector's XR collector captures. All default to `true`. */
+export interface XrCaptureOptions {
+    /** Continuous controller/gaze pose → `pointer_move` (with `ray`). */
+    pointerMove?: boolean;
+    /** Controller `select` (trigger) → `pointer_click`. */
+    clicks?: boolean;
+    /** Named hit on select/squeeze → `mesh_interaction`. Requires a {@link XrRayProbe}. */
+    meshPicks?: boolean;
+}
+/**
+ * A controller-ray raycast result, in the engine's **native** world frame (the
+ * collector canonicalizes it before emitting). Optional in every XR collector —
+ * without a probe, controller/gaze pose is still captured as `pointer_move` rays and
+ * `select` still emits `pointer_click`; only `hitPoint` / `hitMesh` and
+ * `mesh_interaction` need a probe.
+ */
+export interface XrRayHit {
+    /** Hit point in the engine's native world frame. */
+    point: Vec3;
+    /** Hit object's name (empty string when unnamed). */
+    name: string;
+}
+/** Resolve a world-space controller ray to the nearest scene hit, or `undefined`. */
+export type XrRayProbe = (origin: Vec3, direction: Vec3) => XrRayHit | undefined;
+//# sourceMappingURL=xrInput.d.ts.map

package/dist/xrInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xrInput.d.ts","sourceRoot":"","sources":["../src/xrInput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAEtE;;;;;;;;;;GAUG;AAEH,mFAAmF;AACnF,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,WAAW,CAM9D;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,UAAU,GAAG,SAAS,CAE7E;AAED,mFAAmF;AACnF,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uDAAuD;IACvD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uFAAuF;IACvF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,oDAAoD;IACpD,KAAK,EAAE,IAAI,CAAC;IACZ,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qFAAqF;AACrF,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,KAAK,QAAQ,GAAG,SAAS,CAAC"}

package/dist/xrInput.js

@@ -0,0 +1,20 @@
+/**
+ * Map a WebXR input source to an Uptimizr {@link InputSource} (ADR 0011):
+ * articulated hands → `hand`, gaze target-ray → `gaze`, transient/screen taps →
+ * `transient`, everything else (tracked controllers) → `xr-controller`.
+ */
+export function xrSource(input) {
+    if (input.hand != null)
+        return "hand";
+    const mode = input.targetRayMode;
+    if (mode === "gaze")
+        return "gaze";
+    if (mode === "transient-pointer" || mode === "screen")
+        return "transient";
+    return "xr-controller";
+}
+/** The paired XR hand, or `undefined` when not applicable (e.g. gaze). */
+export function xrHandedness(input) {
+    return input.handedness === "left" || input.handedness === "right" ? input.handedness : undefined;
+}
+//# sourceMappingURL=xrInput.js.map

package/dist/xrInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xrInput.js","sourceRoot":"","sources":["../src/xrInput.ts"],"names":[],"mappings":"AAwBA;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAwB;IAC/C,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI;QAAE,OAAO,MAAM,CAAC;IACtC,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa,CAAC;IACjC,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACnC,IAAI,IAAI,KAAK,mBAAmB,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,WAAW,CAAC;IAC1E,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,OAAO,KAAK,CAAC,UAAU,KAAK,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AACpG,CAAC"}

package/llms.txt

@@ -0,0 +1,16 @@
+# @uptimizr/sdk-core
+
+> The framework-agnostic Uptimizr capture runtime: session, in-memory batching, flush
+> scheduling, and a cookieless transport, with a pluggable collector system. No engine knowledge.
+
+## Docs
+
+- [Package reference](./README.md): usage, collector extension point, all config options, transport.
+- [Agent guide](./AGENTS.md): rules and canonical usage for AI agents.
+- [Integration & API reference](https://github.com/RaananW/Uptimizr/blob/main/docs/integration.md): how tracking flows end-to-end.
+- [Architecture Decision Records](https://github.com/RaananW/Uptimizr/tree/main/docs/adr): privacy model (0003), thin backends (0005).
+
+## Key exports
+
+- `UptimizrClient` — create, `start()`, `track(name, props)`, `use(collector)`, `stop()`.
+- `Collector` / `Transport` types — the extension points.

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@uptimizr/sdk-core",
+  "version": "0.1.0",
+  "description": "Framework-agnostic Uptimizr capture runtime — session, batching, cookieless transport, and a pluggable collector system.",
+  "keywords": [
+    "uptimizr",
+    "analytics",
+    "3d",
+    "webgl",
+    "webgpu",
+    "telemetry",
+    "session",
+    "cookieless",
+    "privacy"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RaananW/Uptimizr.git",
+    "directory": "oss/packages/sdk-core"
+  },
+  "bugs": {
+    "url": "https://github.com/RaananW/Uptimizr/issues"
+  },
+  "homepage": "https://github.com/RaananW/Uptimizr/tree/main/oss/packages/sdk-core#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "AGENTS.md",
+    "llms.txt"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "@uptimizr/schema": "0.1.0"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.9"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "lint": "eslint .",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}