@useractivity/core

Core library for UserActivity.ai — behavioral intelligence for AI coding agents.

Provides Supabase client, query functions, aggregators, scorers, formatters, and an HTTP API client for analyzing user behavior: frustration signals, scroll depth, session quality, navigation flow, and engagement metrics.

Install

npm install @useractivity/core

Usage

Hosted (recommended)

import { createApiClient } from '@useractivity/core';

const client = createApiClient('your-api-key', 'your-site-id');
const frustration = await client.frustration(30); // last 30 days
console.log(frustration.score, frustration.narratives);

Self-hosted (direct Supabase)

import { aggregateFrustration, scoreFrustration, formatFrustration } from '@useractivity/core';

// Requires SUPABASE_URL + SUPABASE_SERVICE_ROLE_KEY env vars
const result = await aggregateFrustration('your-site-id', 30);
const score = scoreFrustration(result.data);
const narratives = formatFrustration(result.data, score);

License

MIT — UserActivity.ai