@pyric/ui 0.1.0-alpha.10

package/dist/events/digest.js

@@ -0,0 +1,426 @@
+/**
+ * The pure activity-digest reducer — folds a `SandboxEvent[]` (the
+ * unified stream) into the banded digest the activity grid renders.
+ *
+ * Kept free of React so it's trivially testable and reusable by a
+ * non-React consumer (a CLI session summary, say). `useActivityDigest`
+ * is a thin `useMemo` wrapper over `computeActivityDigest`.
+ *
+ * The categorization is the product (see
+ * the design rationale): the can't-miss bands are
+ * **denied** (surfaced first, loudly), **added**, **updated**,
+ * **removed**, **signed-in / signed-out**, and the catch-alls. Every
+ * row + band carries provenance (actor / lens / on-behalf-of) so
+ * attribution rides every aggregate, and the band order LEADS with the
+ * highest-consequence category present.
+ */
+// ── Band ordering: lead-with-consequence ──────────────────────────────
+// Lower rank renders first. Denials lead; operational errors next; then
+// the write bands; auth; reads; catch-all. (design-ideation.md:
+// "the answer LEADS with the highest-consequence category present".)
+const BAND_RANK = {
+    denied: 0,
+    errored: 1,
+    added: 2,
+    updated: 3,
+    removed: 4,
+    'signed-in': 5,
+    'signed-out': 6,
+    read: 7,
+    other: 8,
+};
+const BAND_LABEL = {
+    denied: 'Denied',
+    errored: 'Errored',
+    added: 'Added',
+    updated: 'Updated',
+    removed: 'Removed',
+    'signed-in': 'Signed in',
+    'signed-out': 'Signed out',
+    read: 'Read',
+    other: 'Other',
+};
+/** The kinds the digest models. Everything else is skipped. */
+function isModelled(e) {
+    return (e.kind === 'request' ||
+        e.kind === 'write' ||
+        e.kind === 'service_mutation');
+}
+function lastSegment(path) {
+    const trimmed = path.replace(/\/+$/, '');
+    const i = trimmed.lastIndexOf('/');
+    return i === -1 ? trimmed : trimmed.slice(i + 1);
+}
+function defaultActor(actor) {
+    return actor ?? { kind: 'app' };
+}
+function defaultLens(lens) {
+    return lens ?? { mode: 'app-session' };
+}
+function lensLabel(lens) {
+    switch (lens.mode) {
+        case 'admin':
+            return 'admin';
+        case 'as':
+            return lens.uid;
+        case 'app-session':
+            return 'app';
+    }
+}
+function actorLabel(actor) {
+    switch (actor.kind) {
+        case 'app':
+            return 'the app';
+        case 'studio':
+            return 'studio';
+        case 'app-builder':
+            return 'the app builder';
+        case 'agent':
+            return `agent ${actor.name}`;
+    }
+}
+/** A stable identity key for an actor (for attribution counting). */
+function actorKey(actor) {
+    return actor.kind === 'agent' ? `agent:${actor.name}` : actor.kind;
+}
+/** The deciding rule on a denial, parsed from the simulator reasons.
+ *  Best-effort — falls back to a generic phrase. */
+function denialRulePhrase(reasons) {
+    // Reasons look like `Rule #0 (update) → DENY`. We surface the op the
+    // rule governs when present; the design copy says "owner rule" but
+    // that's app-semantic naming the library can't know, so we stay
+    // mechanical: name the failing op.
+    for (const r of reasons) {
+        const m = /Rule #\d+\s*\(([^)]+)\)/i.exec(r);
+        if (m)
+            return `${m[1]} rule`;
+    }
+    return undefined;
+}
+function relativeWhen(at, now) {
+    const deltaMs = Math.max(0, now - at);
+    const s = Math.floor(deltaMs / 1000);
+    if (s < 1)
+        return 'now';
+    if (s < 60)
+        return `${s}s`;
+    const m = Math.floor(s / 60);
+    if (m < 60)
+        return `${m}m`;
+    const h = Math.floor(m / 60);
+    return `${h}h`;
+}
+// ── Per-kind projection: event → { band, row fields } ─────────────────
+function projectRequest(e) {
+    if (e.result === 'deny') {
+        const rule = denialRulePhrase(e.reasons);
+        const change = rule ? `${e.method}, ${rule}` : `${e.method} denied`;
+        return { band: 'denied', change, subjectUid: e.auth?.uid ?? null };
+    }
+    if (e.result === 'unsupported') {
+        return {
+            band: 'errored',
+            change: `${e.method} unsupported`,
+            subjectUid: e.auth?.uid ?? null,
+        };
+    }
+    // Allowed request. Reads land in `read`; allowed writes that DIDN'T
+    // also emit a `write` event still get a band so nothing is dropped.
+    const subjectUid = e.auth?.uid ?? null;
+    if (e.method === 'get' || e.method === 'list') {
+        return { band: 'read', change: e.method, subjectUid };
+    }
+    if (e.method === 'delete') {
+        return { band: 'removed', change: 'deleted', subjectUid };
+    }
+    if (e.method === 'create') {
+        return { band: 'added', change: 'created', subjectUid };
+    }
+    return { band: 'updated', change: e.method, subjectUid };
+}
+/** A compact change summary for a write, diffing prior→next when cheap. */
+function writeChange(e) {
+    if (e.method === 'delete')
+        return 'deleted';
+    if (e.method === 'create') {
+        // Surface a representative field value if present (mock shows the
+        // note title in quotes). Pick the first string-ish scalar.
+        const data = e.nextState ?? e.data ?? null;
+        const preview = data ? firstScalarPreview(data) : undefined;
+        return preview !== undefined ? preview : 'created';
+    }
+    // update / set — try to show a single changed field as `key → value`.
+    const single = singleFieldDiff(e.priorState, e.nextState);
+    if (single)
+        return single;
+    return e.method === 'set' ? 'replaced' : 'updated';
+}
+function firstScalarPreview(data) {
+    for (const v of Object.values(data)) {
+        if (typeof v === 'string')
+            return `"${v}"`;
+    }
+    for (const v of Object.values(data)) {
+        if (typeof v === 'number' || typeof v === 'boolean')
+            return String(v);
+    }
+    return undefined;
+}
+function singleFieldDiff(prior, next) {
+    if (!next)
+        return undefined;
+    const before = prior ?? {};
+    const changed = [];
+    for (const k of Object.keys(next)) {
+        if (!shallowEqual(before[k], next[k]))
+            changed.push(k);
+    }
+    if (changed.length !== 1) {
+        return changed.length > 1 ? `${changed.length} fields changed` : undefined;
+    }
+    const key = changed[0];
+    const v = next[key];
+    if (typeof v === 'string' ||
+        typeof v === 'number' ||
+        typeof v === 'boolean') {
+        const shown = typeof v === 'string' ? v : String(v);
+        return `${key} → ${shown}`;
+    }
+    return `${key} changed`;
+}
+function shallowEqual(a, b) {
+    if (a === b)
+        return true;
+    if (typeof a !== typeof b)
+        return false;
+    if (typeof a === 'object' && a && b) {
+        return JSON.stringify(a) === JSON.stringify(b);
+    }
+    return false;
+}
+function projectWrite(e) {
+    const subjectUid = e.auth?.uid ?? null;
+    if (e.method === 'delete')
+        return { band: 'removed', change: 'deleted', subjectUid };
+    if (e.method === 'create')
+        return { band: 'added', change: writeChange(e), subjectUid };
+    return { band: 'updated', change: writeChange(e), subjectUid };
+}
+function projectServiceMutation(e) {
+    const op = e.op;
+    // auth ops carry the affected uid in `path` (or `*` for a clear-all).
+    if (e.service === 'auth') {
+        const affected = e.path && e.path !== '*' ? e.path : null;
+        const subjectUid = affected ?? e.auth?.uid ?? null;
+        switch (op) {
+            case 'sign_in':
+                return { band: 'signed-in', change: 'signed in', subjectUid };
+            case 'sign_out':
+                return { band: 'signed-out', change: 'signed out', subjectUid };
+            case 'user_create':
+                return { band: 'added', change: 'user created', subjectUid };
+            case 'user_update':
+                return { band: 'updated', change: 'user updated', subjectUid };
+            case 'user_delete':
+                return { band: 'removed', change: 'user deleted', subjectUid };
+            case 'users_clear':
+                return { band: 'removed', change: 'all users cleared', subjectUid };
+            default:
+                return { band: 'other', change: op, subjectUid };
+        }
+    }
+    const subjectUid = e.auth?.uid ?? null;
+    if (e.service === 'storage') {
+        switch (op) {
+            case 'object_put':
+                // create vs overwrite: `before` present ⇒ overwrite.
+                return e.before !== undefined
+                    ? { band: 'updated', change: 'object replaced', subjectUid }
+                    : { band: 'added', change: 'object uploaded', subjectUid };
+            case 'object_delete':
+                return { band: 'removed', change: 'object deleted', subjectUid };
+            case 'metadata_update':
+                return { band: 'updated', change: 'metadata updated', subjectUid };
+            default:
+                return { band: 'other', change: op, subjectUid };
+        }
+    }
+    // rtdb
+    switch (op) {
+        case 'set':
+            return e.before !== undefined && e.before !== null
+                ? { band: 'updated', change: 'set', subjectUid }
+                : { band: 'added', change: 'set', subjectUid };
+        case 'update':
+            return { band: 'updated', change: 'update', subjectUid };
+        case 'remove':
+            return { band: 'removed', change: 'removed', subjectUid };
+        case 'transaction':
+            return { band: 'updated', change: 'transaction', subjectUid };
+        default:
+            return { band: 'other', change: op, subjectUid };
+    }
+}
+function project(e) {
+    switch (e.kind) {
+        case 'request':
+            return projectRequest(e);
+        case 'write':
+            return projectWrite(e);
+        case 'service_mutation':
+            return projectServiceMutation(e);
+    }
+}
+function targetOf(e) {
+    switch (e.kind) {
+        case 'request':
+        case 'write':
+            return e.path;
+        case 'service_mutation':
+            // auth: the affected uid; storage/rtdb: the path.
+            if (e.service === 'auth')
+                return e.path && e.path !== '*' ? e.path : '*';
+            return e.path ?? '';
+    }
+}
+function serviceOf(e) {
+    if (e.kind === 'service_mutation')
+        return e.service;
+    return e.service ?? 'firestore';
+}
+/** Build a row from a modelled event. */
+function toRow(e, now) {
+    const { band, change, subjectUid } = project(e);
+    const actor = defaultActor(e.actor);
+    const authLens = defaultLens(e.authLens);
+    const row = {
+        id: e.id,
+        at: e.at,
+        band,
+        denied: band === 'denied',
+        service: serviceOf(e),
+        target: targetOf(e),
+        change,
+        for: subjectUid ?? '',
+        lens: lensLabel(authLens),
+        when: relativeWhen(e.at, now),
+        actor,
+        authLens,
+        subjectUid,
+        event: e,
+    };
+    if (e.planId !== undefined)
+        row.planId = e.planId;
+    return row;
+}
+/** The pivot key for a row under a given group-by axis. */
+function groupKeyFor(row, by) {
+    switch (by) {
+        case 'actor':
+            return actorKey(row.actor);
+        case 'lens':
+            return row.authLens.mode === 'as'
+                ? `as:${row.authLens.uid}`
+                : row.authLens.mode;
+        case 'subject':
+            return row.subjectUid ?? '(anonymous)';
+        case 'service':
+            return row.service;
+        case 'none':
+            return '';
+    }
+}
+/**
+ * Compute the band attribution phrase: when one actor OR one subject
+ * dominates the band, say so ("all by alice", "by the app"). Mixed ⇒
+ * undefined (header shows just the count).
+ */
+function attributionFor(rows) {
+    if (rows.length === 0)
+        return undefined;
+    // Subject dominance first ("all by alice") — it's the most pointed.
+    const subjects = new Set();
+    for (const r of rows)
+        if (r.subjectUid)
+            subjects.add(r.subjectUid);
+    const anonCount = rows.filter((r) => !r.subjectUid).length;
+    if (subjects.size === 1 && anonCount === 0) {
+        const [only] = subjects;
+        return rows.length > 1 ? `all by ${only}` : `by ${only}`;
+    }
+    // Actor dominance ("by the app", "by agent atlas").
+    const actors = new Set();
+    for (const r of rows)
+        actors.add(actorKey(r.actor));
+    if (actors.size === 1) {
+        return `by ${actorLabel(rows[0].actor)}`;
+    }
+    return undefined;
+}
+/**
+ * Fold a unified event stream into the banded activity digest. PURE —
+ * no React, no clock reads except the injected `now` (defaults to
+ * `Date.now()`, but pass a fixed value in tests for determinism).
+ *
+ * Events the digest doesn't model (listener lifecycle, snapshot
+ * delivery, session boundaries, unknown kinds) are skipped — a full
+ * `SandboxEvent[]` from `sandbox.history()` flows in unfiltered.
+ */
+export function computeActivityDigest(events, opts = {}) {
+    const { order = 'recency', groupBy = 'none', rowsPerBand, now = Date.now(), } = opts;
+    const byBand = new Map();
+    let deniedCount = 0;
+    for (const e of events) {
+        if (!isModelled(e))
+            continue;
+        const row = toRow(e, now);
+        if (row.denied)
+            deniedCount++;
+        const list = byBand.get(row.band);
+        if (list)
+            list.push(row);
+        else
+            byBand.set(row.band, [row]);
+    }
+    const sortRows = (rows) => rows.sort((a, b) => order === 'recency' ? b.at - a.at : a.at - b.at);
+    const bands = [];
+    let total = 0;
+    for (const [key, allRows] of byBand) {
+        sortRows(allRows);
+        const count = allRows.length;
+        total += count;
+        const rows = rowsPerBand !== undefined ? allRows.slice(0, rowsPerBand) : allRows;
+        if (groupBy !== 'none') {
+            for (const r of rows)
+                r.groupKey = groupKeyFor(r, groupBy);
+        }
+        const band = {
+            key,
+            label: BAND_LABEL[key],
+            count,
+            rows,
+        };
+        const attr = attributionFor(allRows);
+        if (attr)
+            band.attribution = attr;
+        if (groupBy !== 'none') {
+            const groups = new Map();
+            for (const r of rows) {
+                const gk = groupKeyFor(r, groupBy);
+                const g = groups.get(gk);
+                if (g)
+                    g.push(r);
+                else
+                    groups.set(gk, [r]);
+            }
+            band.subgroups = [...groups.entries()]
+                .map(([k, rs]) => ({ key: k, count: rs.length, rows: rs }))
+                .sort((a, b) => b.count - a.count || a.key.localeCompare(b.key));
+        }
+        bands.push(band);
+    }
+    bands.sort((a, b) => BAND_RANK[a.key] - BAND_RANK[b.key]);
+    const denials = sortRows((byBand.get('denied') ?? []).slice());
+    return { bands, total, deniedCount, denials };
+}
+//# sourceMappingURL=digest.js.map

package/dist/events/digest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest.js","sourceRoot":"","sources":["../../src/events/digest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA0JH,yEAAyE;AACzE,wEAAwE;AACxE,gEAAgE;AAChE,qEAAqE;AACrE,MAAM,SAAS,GAAoC;IACjD,MAAM,EAAE,CAAC;IACT,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;IACV,WAAW,EAAE,CAAC;IACd,YAAY,EAAE,CAAC;IACf,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,MAAM,UAAU,GAAoC;IAClD,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,WAAW,EAAE,WAAW;IACxB,YAAY,EAAE,YAAY;IAC1B,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;CACf,CAAC;AAEF,+DAA+D;AAC/D,SAAS,UAAU,CAAC,CAAmB;IACrC,OAAO,CACL,CAAC,CAAC,IAAI,KAAK,SAAS;QACpB,CAAC,CAAC,IAAI,KAAK,OAAO;QAClB,CAAC,CAAC,IAAI,KAAK,kBAAkB,CAC9B,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACzC,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,YAAY,CAAC,KAAgC;IACpD,OAAO,KAAK,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,WAAW,CAAC,IAA8B;IACjD,OAAO,IAAI,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;AACzC,CAAC;AAED,SAAS,SAAS,CAAC,IAAkB;IACnC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,IAAI;YACP,OAAO,IAAI,CAAC,GAAG,CAAC;QAClB,KAAK,aAAa;YAChB,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAoB;IACtC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,KAAK;YACR,OAAO,SAAS,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,aAAa;YAChB,OAAO,iBAAiB,CAAC;QAC3B,KAAK,OAAO;YACV,OAAO,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC;AACH,CAAC;AAED,qEAAqE;AACrE,SAAS,QAAQ,CAAC,KAAoB;IACpC,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;AACrE,CAAC;AAED;oDACoD;AACpD,SAAS,gBAAgB,CAAC,OAAiB;IACzC,qEAAqE;IACrE,mEAAmE;IACnE,gEAAgE;IAChE,mCAAmC;IACnC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7C,IAAI,CAAC;YAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAC/B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,YAAY,CAAC,EAAU,EAAE,GAAW;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;IACtC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC;IAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7B,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC;IAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7B,OAAO,GAAG,CAAC,GAAG,CAAC;AACjB,CAAC;AAED,yEAAyE;AAEzE,SAAS,cAAc,CACrB,CAAuB;IAEvB,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,SAAS,CAAC;QACpE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;IACrE,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;QAC/B,OAAO;YACL,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,cAAc;YACjC,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI;SAChC,CAAC;IACJ,CAAC;IACD,oEAAoE;IACpE,oEAAoE;IACpE,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC;IACvC,IAAI,CAAC,CAAC,MAAM,KAAK,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;IACxD,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;IAC5D,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;IAC1D,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;AAC3D,CAAC;AAED,2EAA2E;AAC3E,SAAS,WAAW,CAAC,CAAqB;IACxC,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC5C,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1B,kEAAkE;QAClE,2DAA2D;QAC3D,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5D,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACrD,CAAC;IACD,sEAAsE;IACtE,MAAM,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;IAC1D,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,OAAO,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC;AAED,SAAS,kBAAkB,CAAC,IAA6B;IACvD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC,GAAG,CAAC;IAC7C,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,eAAe,CACtB,KAAqC,EACrC,IAAoC;IAEpC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACvB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,IACE,OAAO,CAAC,KAAK,QAAQ;QACrB,OAAO,CAAC,KAAK,QAAQ;QACrB,OAAO,CAAC,KAAK,SAAS,EACtB,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACpD,OAAO,GAAG,GAAG,MAAM,KAAK,EAAE,CAAC;IAC7B,CAAC;IACD,OAAO,GAAG,GAAG,UAAU,CAAC;AAC1B,CAAC;AAED,SAAS,YAAY,CAAC,CAAU,EAAE,CAAU;IAC1C,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,OAAO,CAAC,KAAK,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CACnB,CAAqB;IAErB,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC;IACvC,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;IACrF,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;IACxF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;AACjE,CAAC;AAED,SAAS,sBAAsB,CAC7B,CAA+B;IAE/B,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;IAChB,sEAAsE;IACtE,IAAI,CAAC,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1D,MAAM,UAAU,GAAG,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC;QACnD,QAAQ,EAAE,EAAE,CAAC;YACX,KAAK,SAAS;gBACZ,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;YAChE,KAAK,UAAU;gBACb,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;YAClE,KAAK,aAAa;gBAChB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC;YAC/D,KAAK,aAAa;gBAChB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC;YACjE,KAAK,aAAa;gBAChB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC;YACjE,KAAK,aAAa;gBAChB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,mBAAmB,EAAE,UAAU,EAAE,CAAC;YACtE;gBACE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC;QACrD,CAAC;IACH,CAAC;IACD,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC;IACvC,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC5B,QAAQ,EAAE,EAAE,CAAC;YACX,KAAK,YAAY;gBACf,qDAAqD;gBACrD,OAAO,CAAC,CAAC,MAAM,KAAK,SAAS;oBAC3B,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE;oBAC5D,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,CAAC;YAC/D,KAAK,eAAe;gBAClB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,UAAU,EAAE,CAAC;YACnE,KAAK,iBAAiB;gBACpB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB,EAAE,UAAU,EAAE,CAAC;YACrE;gBACE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC;QACrD,CAAC;IACH,CAAC;IACD,OAAO;IACP,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,KAAK;YACR,OAAO,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI;gBAChD,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE;gBAChD,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;QACnD,KAAK,QAAQ;YACX,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;QAC3D,KAAK,QAAQ;YACX,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;QAC5D,KAAK,aAAa;YAChB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC;QAChE;YACE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC;IACrD,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,CAAgB;IAK/B,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC;QAC3B,KAAK,OAAO;YACV,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC;QACzB,KAAK,kBAAkB;YACrB,OAAO,sBAAsB,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,CAAgB;IAChC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,SAAS,CAAC;QACf,KAAK,OAAO;YACV,OAAO,CAAC,CAAC,IAAI,CAAC;QAChB,KAAK,kBAAkB;YACrB,kDAAkD;YAClD,IAAI,CAAC,CAAC,OAAO,KAAK,MAAM;gBAAE,OAAO,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;YACzE,OAAO,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IACxB,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,CAAgB;IACjC,IAAI,CAAC,CAAC,IAAI,KAAK,kBAAkB;QAAE,OAAO,CAAC,CAAC,OAAO,CAAC;IACpD,OAAO,CAAC,CAAC,OAAO,IAAI,WAAW,CAAC;AAClC,CAAC;AAED,yCAAyC;AACzC,SAAS,KAAK,CAAC,CAAgB,EAAE,GAAW;IAC1C,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,GAAG,GAAgB;QACvB,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI;QACJ,MAAM,EAAE,IAAI,KAAK,QAAQ;QACzB,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;QACrB,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;QACnB,MAAM;QACN,GAAG,EAAE,UAAU,IAAI,EAAE;QACrB,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC;QACzB,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC;QAC7B,KAAK;QACL,QAAQ;QACR,UAAU;QACV,KAAK,EAAE,CAAC;KACT,CAAC;IACF,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;QAAE,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,2DAA2D;AAC3D,SAAS,WAAW,CAAC,GAAgB,EAAE,EAAmB;IACxD,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC7B,KAAK,MAAM;YACT,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI;gBAC/B,CAAC,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE;gBAC1B,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QACxB,KAAK,SAAS;YACZ,OAAO,GAAG,CAAC,UAAU,IAAI,aAAa,CAAC;QACzC,KAAK,SAAS;YACZ,OAAO,GAAG,CAAC,OAAO,CAAC;QACrB,KAAK,MAAM;YACT,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,IAAmB;IACzC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAExC,oEAAoE;IACpE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,KAAK,MAAM,CAAC,IAAI,IAAI;QAAE,IAAI,CAAC,CAAC,UAAU;YAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC;IAC3D,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC;QACxB,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;IAC3D,CAAC;IAED,oDAAoD;IACpD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,IAAI;QAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACpD,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;IAC3C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAmBD;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAmC,EACnC,OAAiD,EAAE;IAEnD,MAAM,EACJ,KAAK,GAAG,SAAS,EACjB,OAAO,GAAG,MAAM,EAChB,WAAW,EACX,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GACjB,GAAG,IAAI,CAAC;IAET,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkC,CAAC;IACzD,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,SAAS;QAC7B,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC1B,IAAI,GAAG,CAAC,MAAM;YAAE,WAAW,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;;YACpB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,IAAmB,EAAiB,EAAE,CACtD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACjB,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAChD,CAAC;IAEJ,MAAM,KAAK,GAA6B,EAAE,CAAC;IAC3C,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,MAAM,EAAE,CAAC;QACpC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAClB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,KAAK,IAAI,KAAK,CAAC;QACf,MAAM,IAAI,GACR,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QACtE,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;YACvB,KAAK,MAAM,CAAC,IAAI,IAAI;gBAAE,CAAC,CAAC,QAAQ,GAAG,WAAW,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC7D,CAAC;QACD,MAAM,IAAI,GAA2B;YACnC,GAAG;YACH,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC;YACtB,KAAK;YACL,IAAI;SACL,CAAC;QACF,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,IAAI;YAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAClC,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;YAChD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;gBACrB,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;gBACnC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACzB,IAAI,CAAC;oBAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;;oBACZ,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3B,CAAC;YACD,IAAI,CAAC,SAAS,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;iBACnC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;iBAC1D,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAE1D,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAE/D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AAChD,CAAC"}

package/dist/events/hooks/index.d.ts

@@ -0,0 +1,3 @@
+export { useActivityDigest, type UseActivityDigestOptions, } from './useActivityDigest.js';
+export { useActivityStream, type UseActivityStreamOptions, type UseActivityStreamResult, } from './useActivityStream.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/events/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/events/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,GAC9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,wBAAwB,CAAC"}

package/dist/events/hooks/index.js

@@ -0,0 +1,3 @@
+export { useActivityDigest, } from './useActivityDigest.js';
+export { useActivityStream, } from './useActivityStream.js';
+//# sourceMappingURL=index.js.map

package/dist/events/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/events/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,GAElB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,GAGlB,MAAM,wBAAwB,CAAC"}

package/dist/events/hooks/useActivityDigest.d.ts

@@ -0,0 +1,27 @@
+import type { AnyActivityEvent } from '../types.js';
+import { type ActivityDigest, type ActivityDigestOptions } from '../digest.js';
+export interface UseActivityDigestOptions extends ActivityDigestOptions {
+    /**
+     * Clock injection for the relative `when` column. Defaults to
+     * `Date.now()` read once per recompute. Pass a fixed value (or a
+     * frozen "session now") for deterministic rendering / tests.
+     *
+     * NOTE: changing `now` between renders re-folds the digest, so don't
+     * pass a fresh `Date.now()` inline unless you want a recompute every
+     * render — pin it (e.g. a ticking value updated on an interval).
+     */
+    now?: number;
+}
+/**
+ * React wrapper over {@link computeActivityDigest} — memoizes the pure
+ * fold over the unified `SandboxEvent` stream into the banded activity
+ * digest. Feed it `sandbox.history()` (a snapshot) or the live buffer
+ * from {@link useActivityStream}; the reducer is identical either way.
+ *
+ * The fold re-runs when `events` identity, any grouping option, or
+ * `now` changes. Keep `events` referentially stable across renders that
+ * shouldn't recompute (the stream hook already returns a stable array
+ * per emission).
+ */
+export declare function useActivityDigest(events: readonly AnyActivityEvent[], options?: UseActivityDigestOptions): ActivityDigest;
+//# sourceMappingURL=useActivityDigest.d.ts.map

package/dist/events/hooks/useActivityDigest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActivityDigest.d.ts","sourceRoot":"","sources":["../../../src/events/hooks/useActivityDigest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC3B,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,wBAAyB,SAAQ,qBAAqB;IACrE;;;;;;;;OAQG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,gBAAgB,EAAE,EACnC,OAAO,GAAE,wBAA6B,GACrC,cAAc,CAMhB"}

package/dist/events/hooks/useActivityDigest.js

@@ -0,0 +1,18 @@
+import { useMemo } from 'react';
+import { computeActivityDigest, } from '../digest.js';
+/**
+ * React wrapper over {@link computeActivityDigest} — memoizes the pure
+ * fold over the unified `SandboxEvent` stream into the banded activity
+ * digest. Feed it `sandbox.history()` (a snapshot) or the live buffer
+ * from {@link useActivityStream}; the reducer is identical either way.
+ *
+ * The fold re-runs when `events` identity, any grouping option, or
+ * `now` changes. Keep `events` referentially stable across renders that
+ * shouldn't recompute (the stream hook already returns a stable array
+ * per emission).
+ */
+export function useActivityDigest(events, options = {}) {
+    const { order, groupBy, rowsPerBand, now } = options;
+    return useMemo(() => computeActivityDigest(events, { order, groupBy, rowsPerBand, now }), [events, order, groupBy, rowsPerBand, now]);
+}
+//# sourceMappingURL=useActivityDigest.js.map

package/dist/events/hooks/useActivityDigest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActivityDigest.js","sourceRoot":"","sources":["../../../src/events/hooks/useActivityDigest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EACL,qBAAqB,GAGtB,MAAM,cAAc,CAAC;AAetB;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAmC,EACnC,UAAoC,EAAE;IAEtC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IACrD,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,qBAAqB,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,EACzE,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,CAAC,CAC3C,CAAC;AACJ,CAAC"}

package/dist/events/hooks/useActivityStream.d.ts

@@ -0,0 +1,44 @@
+import type { ActivitySource, AnyActivityEvent } from '../types.js';
+export interface UseActivityStreamOptions {
+    /**
+     * The subscription — `sandbox.onEvent` satisfies this directly. Pass
+     * a stable reference; the hook re-subscribes on identity change.
+     */
+    source: ActivitySource;
+    /**
+     * Seed the buffer with a snapshot before the live subscription
+     * attaches — typically `sandbox.history()`, so a late-attaching
+     * consumer sees the whole session, not just events from `subscribe`
+     * onward. Read once on mount.
+     */
+    initial?: readonly AnyActivityEvent[];
+    /**
+     * Ring-buffer cap. Once exceeded, the oldest events drop. Default
+     * 5000 (mirrors the traffic monitor's cap — a load-test session can
+     * emit 100k+ events).
+     */
+    bufferSize?: number;
+    /** Start paused — incoming events drop (not queued) while paused. */
+    paused?: boolean;
+}
+export interface UseActivityStreamResult {
+    /** The buffered events, oldest-first. Stable per emission — safe to
+     *  hand straight to {@link useActivityDigest}. */
+    events: AnyActivityEvent[];
+    isPaused: boolean;
+    pause: () => void;
+    resume: () => void;
+    /** Empty the buffer (does NOT re-seed from `initial`). */
+    clear: () => void;
+}
+/**
+ * Buffers the unified sandbox event stream into a capped ring buffer
+ * with optional history seeding + pause/resume/clear. Decoupled from
+ * `pyric` — `source` is just a `(cb) => unsubscribe`.
+ *
+ * Sibling to the traffic monitor's `useTrafficMonitor`; the difference
+ * is the wider event type (`AnyActivityEvent`, the full union) and the
+ * `initial` seed so `history()` + live compose into one buffer.
+ */
+export declare function useActivityStream({ source, initial, bufferSize, paused, }: UseActivityStreamOptions): UseActivityStreamResult;
+//# sourceMappingURL=useActivityStream.d.ts.map

package/dist/events/hooks/useActivityStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActivityStream.d.ts","sourceRoot":"","sources":["../../../src/events/hooks/useActivityStream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpE,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,MAAM,EAAE,cAAc,CAAC;IACvB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACtC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC;sDACkD;IAClD,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,OAAO,EACP,UAAiB,EACjB,MAAc,GACf,EAAE,wBAAwB,GAAG,uBAAuB,CAkCpD"}

package/dist/events/hooks/useActivityStream.js

@@ -0,0 +1,38 @@
+import { useEffect, useMemo, useRef, useState } from 'react';
+/**
+ * Buffers the unified sandbox event stream into a capped ring buffer
+ * with optional history seeding + pause/resume/clear. Decoupled from
+ * `pyric` — `source` is just a `(cb) => unsubscribe`.
+ *
+ * Sibling to the traffic monitor's `useTrafficMonitor`; the difference
+ * is the wider event type (`AnyActivityEvent`, the full union) and the
+ * `initial` seed so `history()` + live compose into one buffer.
+ */
+export function useActivityStream({ source, initial, bufferSize = 5000, paused = false, }) {
+    const [events, setEvents] = useState(() => initial ? initial.slice(-bufferSize) : []);
+    const [isPaused, setIsPaused] = useState(paused);
+    const pausedRef = useRef(isPaused);
+    pausedRef.current = isPaused;
+    const bufferSizeRef = useRef(bufferSize);
+    bufferSizeRef.current = bufferSize;
+    useEffect(() => {
+        const unsubscribe = source((event) => {
+            if (pausedRef.current)
+                return;
+            setEvents((prev) => {
+                const next = prev.length >= bufferSizeRef.current ? prev.slice(1) : prev.slice();
+                next.push(event);
+                return next;
+            });
+        });
+        return unsubscribe;
+    }, [source]);
+    return useMemo(() => ({
+        events,
+        isPaused,
+        pause: () => setIsPaused(true),
+        resume: () => setIsPaused(false),
+        clear: () => setEvents([]),
+    }), [events, isPaused]);
+}
+//# sourceMappingURL=useActivityStream.js.map

package/dist/events/hooks/useActivityStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActivityStream.js","sourceRoot":"","sources":["../../../src/events/hooks/useActivityStream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAqC7D;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAChC,MAAM,EACN,OAAO,EACP,UAAU,GAAG,IAAI,EACjB,MAAM,GAAG,KAAK,GACW;IACzB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAqB,GAAG,EAAE,CAC5D,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAC1C,CAAC;IACF,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEjD,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnC,SAAS,CAAC,OAAO,GAAG,QAAQ,CAAC;IAC7B,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IACzC,aAAa,CAAC,OAAO,GAAG,UAAU,CAAC;IAEnC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACnC,IAAI,SAAS,CAAC,OAAO;gBAAE,OAAO;YAC9B,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;gBACjB,MAAM,IAAI,GACR,IAAI,CAAC,MAAM,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACtE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACjB,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,OAAO,WAAW,CAAC;IACrB,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC;QACL,MAAM;QACN,QAAQ;QACR,KAAK,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC;QAC9B,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC;QAChC,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;KAC3B,CAAC,EACF,CAAC,MAAM,EAAE,QAAQ,CAAC,CACnB,CAAC;AACJ,CAAC"}

package/dist/events/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `@pyric/ui/events` — headless activity view over the unified
+ * `SandboxEvent` stream (Pyric Studio's keystone). Aggregates the whole
+ * stream (Firestore request/write + the cross-service `service_mutation`
+ * envelope for auth/storage/rtdb) into category bands with per-row
+ * provenance — the activity grid. Sibling to `@pyric/ui/traffic` (which
+ * is per-request, not aggregated-by-category).
+ *
+ * Ships zero styling — Pyric Studio applies the `data-pyric-*` contract.
+ */
+export * from './hooks/index.js';
+export * from './components/index.js';
+export { computeActivityDigest, type ActivityDigest, type ActivityDigestOptions, type ActivityGroupBy, type ActivityBand, type ActivityBandWithGroups, type ActivitySubgroup, type ActivityBandKey, type ActivityRow, } from './digest.js';
+export type { ActivityEvent, AnyActivityEvent, ActivitySource, ActivityRequestEvent, ActivityWriteEvent, ActivityServiceMutationEvent, ActivityProvenance, ActivityService, ActivityActor, ActivityLens, ActivityResult, ActivityAuthState, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AAEtC,OAAO,EACL,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,4BAA4B,EAC5B,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,YAAY,EACZ,cAAc,EACd,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/events/index.js

@@ -0,0 +1,14 @@
+/**
+ * `@pyric/ui/events` — headless activity view over the unified
+ * `SandboxEvent` stream (Pyric Studio's keystone). Aggregates the whole
+ * stream (Firestore request/write + the cross-service `service_mutation`
+ * envelope for auth/storage/rtdb) into category bands with per-row
+ * provenance — the activity grid. Sibling to `@pyric/ui/traffic` (which
+ * is per-request, not aggregated-by-category).
+ *
+ * Ships zero styling — Pyric Studio applies the `data-pyric-*` contract.
+ */
+export * from './hooks/index.js';
+export * from './components/index.js';
+export { computeActivityDigest, } from './digest.js';
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AAEtC,OAAO,EACL,qBAAqB,GAStB,MAAM,aAAa,CAAC"}