hazo_umetrics 0.1.1

package/dist/server/flags.js

@@ -0,0 +1,207 @@
+// hazo_umetrics/src/server/flags.ts — weighted-variant deterministic bucket engine,
+// resolveVariant, getVariant, and isEnabled.
+//
+// Uses cyrb53 (pure JS, no node:crypto) for deterministic, distribution-uniform hashing.
+// Sticky assignments are stored in hazo_umetrics_assignment; exposures in hazo_umetrics_exposure.
+import { createCrudService } from 'hazo_connect/server';
+import { HazoError } from 'hazo_core';
+import { signSubjectCookie, readSubjectCookie } from './cookie.js';
+// ---------------------------------------------------------------------------
+// cyrb53 — pure-JS 53-bit hash (no node:crypto)
+// ---------------------------------------------------------------------------
+function cyrb53(str, seed = 0) {
+    let h1 = 0xdeadbeef ^ seed, h2 = 0x41c6ce57 ^ seed;
+    for (let i = 0; i < str.length; i++) {
+        const ch = str.charCodeAt(i);
+        h1 = Math.imul(h1 ^ ch, 2654435761);
+        h2 = Math.imul(h2 ^ ch, 1597334677);
+    }
+    h1 = Math.imul(h1 ^ (h1 >>> 16), 2246822507) ^ Math.imul(h2 ^ (h2 >>> 13), 3266489909);
+    h2 = Math.imul(h2 ^ (h2 >>> 16), 2246822507) ^ Math.imul(h1 ^ (h1 >>> 13), 3266489909);
+    return 4294967296 * (2097151 & h2) + (h1 >>> 0);
+}
+/**
+ * Given a list of variants with weights, deterministically assign a bucket
+ * using the hashInput string. Weights are normalized to sum to 100.
+ *
+ * Throws HazoError if variants is empty.
+ */
+export function weightedBucket(variants, hashInput) {
+    if (variants.length === 0) {
+        throw new HazoError({
+            code: 'INVALID_ARGUMENT',
+            pkg: 'hazo_umetrics',
+            message: 'weightedBucket: variants array must not be empty',
+            httpStatus: 400,
+            retryable: false,
+        });
+    }
+    const totalWeight = variants.reduce((sum, v) => sum + v.weight, 0);
+    const hash = cyrb53(hashInput);
+    // Map hash to [0, 1) using the lower 32 bits
+    const position = (hash >>> 0) / 0xFFFFFFFF;
+    let cumulative = 0;
+    for (const variant of variants) {
+        const normalized = (variant.weight / totalWeight) * 100;
+        cumulative += normalized;
+        if (position < cumulative / 100) {
+            return variant.name;
+        }
+    }
+    // Floating-point edge case: return the last variant
+    return variants[variants.length - 1].name;
+}
+/**
+ * Resolve the variant for a subject in an experiment.
+ *
+ * - draft/stopped experiment → first variant (or 'control'), no DB writes
+ * - running + subjectId (logged-in) → deterministic bucket, upsert assignment, write exposure
+ * - running + no subjectId + consent=true → ephemeral anon ID signed in cookie, sticky
+ * - running + no subjectId + consent=false/undefined → per-request bucket, no persistence
+ */
+export async function resolveVariant(adapter, opts) {
+    const { experimentKey, scope_id, consent } = opts;
+    // Fetch the experiment
+    const expCrud = createCrudService(adapter, 'hazo_umetrics_experiment', {
+        primaryKeys: ['key', 'scope_id'],
+        autoId: false,
+    });
+    const expRow = await expCrud.findOneBy({ key: experimentKey, scope_id });
+    if (!expRow) {
+        // Experiment not found — return 'control' with no DB writes
+        return { variant: 'control', sticky: false };
+    }
+    const variants = parseVariants(expRow.variants);
+    // Path 1: draft or stopped — no DB writes
+    if (expRow.status === 'draft' || expRow.status === 'stopped') {
+        const firstVariant = variants.length > 0 ? variants[0].name : 'control';
+        return { variant: firstVariant, sticky: false };
+    }
+    // Experiment is running — determine subjectId
+    const assignmentCrud = createCrudService(adapter, 'hazo_umetrics_assignment', {
+        primaryKeys: ['experiment_key', 'scope_id', 'subject_id'],
+        autoId: false,
+    });
+    const exposureCrud = createCrudService(adapter, 'hazo_umetrics_exposure');
+    let effectiveSubjectId = opts.subjectId;
+    let isAnon = false;
+    let anonCookieValue;
+    // Check for a cookie-restored anon identity
+    if (!effectiveSubjectId && opts.cookieValue && consent) {
+        const restored = await readSubjectCookie(opts.cookieValue);
+        if (restored) {
+            effectiveSubjectId = restored;
+            isAnon = true;
+            // We'll re-sign the same cookie so the caller can refresh it
+            anonCookieValue = opts.cookieValue;
+        }
+    }
+    // Path 2: logged-in user (or cookie-restored anon with consent)
+    if (effectiveSubjectId) {
+        // Check for existing sticky assignment
+        const existing = await assignmentCrud.findOneBy({
+            experiment_key: experimentKey,
+            scope_id,
+            subject_id: effectiveSubjectId,
+        });
+        let variant;
+        if (existing) {
+            variant = existing.variant;
+        }
+        else {
+            variant = weightedBucket(variants, `${experimentKey}:${effectiveSubjectId}`);
+            // Upsert assignment
+            await assignmentCrud.upsert({
+                experiment_key: experimentKey,
+                scope_id,
+                subject_id: effectiveSubjectId,
+                variant,
+                assigned_at: new Date().toISOString(),
+            });
+        }
+        // Write exposure only once per (experiment_key, scope_id, subject_id, event)
+        const existingExposure = await exposureCrud.findOneBy({
+            experiment_key: experimentKey,
+            scope_id,
+            subject_id: effectiveSubjectId,
+            event: 'exposure',
+        });
+        if (!existingExposure) {
+            await exposureCrud.insert({
+                experiment_key: experimentKey,
+                scope_id,
+                subject_id: effectiveSubjectId,
+                variant,
+                event: 'exposure',
+                timestamp: new Date().toISOString(),
+            });
+        }
+        const result = { variant, sticky: true };
+        if (isAnon && anonCookieValue) {
+            result.cookieValue = anonCookieValue;
+        }
+        return result;
+    }
+    // Path 3: anon + consent=true → create ephemeral ID, sign cookie, persist
+    if (consent === true) {
+        const ephemeralId = `anon_${Date.now()}_${cyrb53(experimentKey) % 1000000}`;
+        const variant = weightedBucket(variants, `${experimentKey}:${ephemeralId}`);
+        await assignmentCrud.upsert({
+            experiment_key: experimentKey,
+            scope_id,
+            subject_id: ephemeralId,
+            variant,
+            assigned_at: new Date().toISOString(),
+        });
+        await exposureCrud.insert({
+            experiment_key: experimentKey,
+            scope_id,
+            subject_id: ephemeralId,
+            variant,
+            event: 'exposure',
+            timestamp: new Date().toISOString(),
+        });
+        const signedCookie = await signSubjectCookie(ephemeralId);
+        return { variant, sticky: true, cookieValue: signedCookie };
+    }
+    // Path 4: anon + no consent → per-request ephemeral bucket, no persistence
+    const requestId = `req_${Date.now()}_${Math.random()}`;
+    const variant = weightedBucket(variants, `${experimentKey}:${requestId}`);
+    // Still write an exposure event (no subject identity, use a transient id)
+    await exposureCrud.insert({
+        experiment_key: experimentKey,
+        scope_id,
+        subject_id: requestId,
+        variant,
+        event: 'exposure',
+        timestamp: new Date().toISOString(),
+    });
+    return { variant, sticky: false };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function parseVariants(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return [];
+    }
+}
+// ---------------------------------------------------------------------------
+// Public convenience wrappers
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the variant name for a subject. Wraps resolveVariant.
+ */
+export async function getVariant(adapter, opts) {
+    const { variant } = await resolveVariant(adapter, opts);
+    return variant;
+}
+/**
+ * Returns true when the resolved variant is 'on'. Useful for simple feature flags.
+ */
+export async function isEnabled(adapter, opts) {
+    return (await getVariant(adapter, opts)) === 'on';
+}

package/dist/server/ga4.d.ts

@@ -0,0 +1,30 @@
+export interface Ga4Report {
+    rows: Array<{
+        dimensions: string[];
+        metrics: string[];
+    }>;
+    rowCount: number;
+}
+export interface Ga4PropertyConfig {
+    propertyId: string;
+    measurementId: string;
+}
+export interface Ga4Client {
+    runReport(params: {
+        metrics: string[];
+        dimensions: string[];
+        dateRanges: Array<{
+            startDate: string;
+            endDate: string;
+        }>;
+    }): Promise<Ga4Report>;
+}
+export interface Ga4Provisioner {
+    provision(scopeId: string, config: Ga4PropertyConfig): Promise<{
+        status: 'provisioned' | 'error';
+        message?: string;
+    }>;
+}
+export declare function createGa4Client(_config?: Partial<Ga4PropertyConfig>): Ga4Client;
+export declare function createGa4Provisioner(): Ga4Provisioner;
+//# sourceMappingURL=ga4.d.ts.map

package/dist/server/ga4.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ga4.d.ts","sourceRoot":"","sources":["../../src/server/ga4.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACzD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,KAAK,CAAC;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CAC/I;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvH;AAGD,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,SAAS,CAM/E;AAGD,wBAAgB,oBAAoB,IAAI,cAAc,CAMrD"}

package/dist/server/ga4.js

@@ -0,0 +1,19 @@
+// hazo_umetrics/src/server/ga4.ts — GA4 client and provisioner stubs.
+// STUB: Real Data API + Admin API clients are M1. These return mocked shapes
+// so downstream code can import and type-check against them today.
+// STUB (M1/deferred) — returns empty report
+export function createGa4Client(_config) {
+    return {
+        async runReport() {
+            return { rows: [], rowCount: 0 }; // STUB
+        },
+    };
+}
+// STUB (M1/deferred) — returns mock provision status
+export function createGa4Provisioner() {
+    return {
+        async provision() {
+            return { status: 'provisioned', message: 'stub — no real GA4 provisioning in M0' }; // STUB
+        },
+    };
+}

package/dist/server/stats.d.ts

@@ -0,0 +1,51 @@
+import type { HazoConnectAdapter } from 'hazo_connect/server';
+import type { Stat, StatCollectorDef, MaintenanceJob } from './types.js';
+/**
+ * Records a new stat reading. Always inserts — append-only, never upserts.
+ */
+export declare function recordStat(adapter: HazoConnectAdapter, params: {
+    scope_id: string;
+    app_id?: string;
+    metric_key: string;
+    value: number;
+    unit?: string;
+    dimensions?: Record<string, string | number>;
+}): Promise<void>;
+/**
+ * Returns the most recent reading for a metric in a scope, or null if none.
+ */
+export declare function getLatestStat(adapter: HazoConnectAdapter, params: {
+    scope_id: string;
+    metric_key: string;
+}): Promise<Stat | null>;
+/**
+ * Returns readings for a metric in a scope, ascending by captured_at.
+ * Optionally filtered by a `since` ISO timestamp and/or a result limit.
+ */
+export declare function getStatSeries(adapter: HazoConnectAdapter, params: {
+    scope_id: string;
+    metric_key: string;
+    since?: string;
+    limit?: number;
+}): Promise<Stat[]>;
+/**
+ * Registers a stat collector. Collectors are module-level singletons that
+ * contribute to `runStatSnapshot`.
+ */
+export declare function registerStatCollector(def: StatCollectorDef): void;
+/**
+ * Runs all registered collectors for a scope and inserts one stat row per
+ * collector. Returns the key+value pairs that were recorded.
+ */
+export declare function runStatSnapshot(adapter: HazoConnectAdapter, params: {
+    scope_id: string;
+}): Promise<Array<{
+    key: string;
+    value: number;
+}>>;
+/**
+ * MaintenanceJob-shaped export for M1 job wiring. Wire this into hazo_jobs
+ * so snapshots run on a schedule without manual orchestration.
+ */
+export declare const statSnapshotJob: MaintenanceJob;
+//# sourceMappingURL=stats.d.ts.map

package/dist/server/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/server/stats.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAmDzE;;GAEG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE;IACN,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC9C,GACA,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC/C,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAWtB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE;IACN,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,OAAO,CAAC,IAAI,EAAE,CAAC,CAgBjB;AAQD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAMjE;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC3B,OAAO,CAAC,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAchD;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,cAM7B,CAAC"}

package/dist/server/stats.js

@@ -0,0 +1,129 @@
+// hazo_umetrics/src/server/stats.ts — stat store: append-only metric readings,
+// collector registry, and snapshot job.
+import { createCrudService } from 'hazo_connect/server';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function rowToStat(row) {
+    let dimensions = null;
+    if (row.dimensions) {
+        try {
+            dimensions = JSON.parse(row.dimensions);
+        }
+        catch {
+            dimensions = null;
+        }
+    }
+    return {
+        id: row.id,
+        scope_id: row.scope_id,
+        app_id: row.app_id,
+        metric_key: row.metric_key,
+        value: row.value,
+        unit: row.unit,
+        dimensions,
+        captured_at: row.captured_at,
+    };
+}
+function getCrud(adapter) {
+    return createCrudService(adapter, 'hazo_umetrics_stat');
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Records a new stat reading. Always inserts — append-only, never upserts.
+ */
+export async function recordStat(adapter, params) {
+    const crud = getCrud(adapter);
+    const dimensionsJson = params.dimensions != null
+        ? JSON.stringify(params.dimensions)
+        : null;
+    await crud.insert({
+        scope_id: params.scope_id,
+        app_id: params.app_id ?? '',
+        metric_key: params.metric_key,
+        value: params.value,
+        unit: params.unit ?? null,
+        dimensions: dimensionsJson,
+        captured_at: new Date().toISOString(),
+    });
+}
+/**
+ * Returns the most recent reading for a metric in a scope, or null if none.
+ */
+export async function getLatestStat(adapter, params) {
+    const crud = getCrud(adapter);
+    const rows = await crud.list((qb) => qb
+        .where('scope_id', 'eq', params.scope_id)
+        .where('metric_key', 'eq', params.metric_key)
+        .order('captured_at', 'desc')
+        .limit(1));
+    if (rows.length === 0)
+        return null;
+    return rowToStat(rows[0]);
+}
+/**
+ * Returns readings for a metric in a scope, ascending by captured_at.
+ * Optionally filtered by a `since` ISO timestamp and/or a result limit.
+ */
+export async function getStatSeries(adapter, params) {
+    const crud = getCrud(adapter);
+    const rows = await crud.list((qb) => {
+        let q = qb
+            .where('scope_id', 'eq', params.scope_id)
+            .where('metric_key', 'eq', params.metric_key)
+            .order('captured_at', 'asc');
+        if (params.since) {
+            q = q.where('captured_at', 'gte', params.since);
+        }
+        if (params.limit != null) {
+            q = q.limit(params.limit);
+        }
+        return q;
+    });
+    return rows.map(rowToStat);
+}
+// ---------------------------------------------------------------------------
+// Collector registry
+// ---------------------------------------------------------------------------
+const _collectors = [];
+/**
+ * Registers a stat collector. Collectors are module-level singletons that
+ * contribute to `runStatSnapshot`.
+ */
+export function registerStatCollector(def) {
+    // Prevent duplicate registrations (idempotent for HMR safety)
+    const exists = _collectors.some((c) => c.key === def.key);
+    if (!exists) {
+        _collectors.push(def);
+    }
+}
+/**
+ * Runs all registered collectors for a scope and inserts one stat row per
+ * collector. Returns the key+value pairs that were recorded.
+ */
+export async function runStatSnapshot(adapter, params) {
+    const results = [];
+    for (const collector of _collectors) {
+        const value = await collector.collect(params.scope_id);
+        await recordStat(adapter, {
+            scope_id: params.scope_id,
+            metric_key: collector.key,
+            value,
+        });
+        results.push({ key: collector.key, value });
+    }
+    return results;
+}
+/**
+ * MaintenanceJob-shaped export for M1 job wiring. Wire this into hazo_jobs
+ * so snapshots run on a schedule without manual orchestration.
+ */
+export const statSnapshotJob = {
+    type: 'hazo_umetrics.stat_snapshot',
+    defaultCron: '0 * * * *', // hourly
+    handler: async ({ scope_id, adapter }) => {
+        return runStatSnapshot(adapter, { scope_id });
+    },
+};

package/dist/server/types.d.ts

@@ -0,0 +1,65 @@
+export interface Stat {
+    id: string;
+    scope_id: string;
+    app_id: string;
+    metric_key: string;
+    value: number;
+    unit: string | null;
+    dimensions: Record<string, string | number> | null;
+    captured_at: string;
+}
+export interface StatDef {
+    metric_key: string;
+    scope_id: string;
+    label: string;
+    description: string;
+    format: 'count' | 'currency' | 'duration' | 'percent';
+    cadence: string | null;
+}
+export interface Experiment {
+    key: string;
+    scope_id: string;
+    name: string;
+    type: 'flag' | 'experiment';
+    variants: Array<{
+        name: string;
+        weight: number;
+    }>;
+    traffic_allocation: number;
+    status: 'draft' | 'running' | 'stopped';
+    targeting: Record<string, unknown>;
+    goal_event: string | null;
+    target_sample_size: number | null;
+}
+export interface Assignment {
+    experiment_key: string;
+    scope_id: string;
+    subject_id: string;
+    variant: string;
+    assigned_at: string;
+}
+export interface Exposure {
+    id: string;
+    experiment_key: string;
+    scope_id: string;
+    subject_id: string;
+    variant: string;
+    event: string;
+    timestamp: string;
+}
+export interface MaintenanceJob {
+    type: string;
+    defaultCron: string;
+    handler: (ctx: {
+        scope_id: string;
+        adapter: import('hazo_connect').HazoConnectAdapter;
+    }) => Promise<unknown>;
+}
+export interface StatCollectorDef {
+    key: string;
+    label: string;
+    format: StatDef['format'];
+    cadence?: string;
+    collect: (scope_id: string) => Promise<number>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/server/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC;IACnD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,OAAO;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IACtD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC;IAC5B,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,cAAc,EAAE,kBAAkB,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9G;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAChD"}

package/dist/server/types.js

@@ -0,0 +1,2 @@
+// hazo_umetrics/src/server/types.ts — shared TypeScript types for the server layer
+export {};

package/dist/ui/index.d.ts

@@ -0,0 +1,2 @@
+export * from './metrics_panel.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAGA,cAAc,oBAAoB,CAAC"}

package/dist/ui/index.js

@@ -0,0 +1,3 @@
+// hazo_umetrics/src/ui/index.ts — Client-safe UI components (no Node.js imports).
+// Full MetricsPanel wiring is deferred to M1 interactive session.
+export * from './metrics_panel.js';

package/dist/ui/metrics_panel.d.ts

@@ -0,0 +1,33 @@
+export interface StatCardsProps {
+    stats: Array<{
+        key: string;
+        label: string;
+        value: number;
+        unit?: string;
+        format: string;
+    }>;
+}
+export declare function StatCards({ stats }: StatCardsProps): import("react").JSX.Element;
+export interface StatTrendProps {
+    data: Array<{
+        ts: string;
+        value: number;
+    }>;
+    label?: string;
+}
+export declare function StatTrend({ data, label }: StatTrendProps): import("react").JSX.Element;
+export interface ExperimentListProps {
+    experiments: Array<{
+        key: string;
+        name: string;
+        type: string;
+        status: string;
+        variants: string;
+    }>;
+}
+export declare function ExperimentList({ experiments }: ExperimentListProps): import("react").JSX.Element;
+export interface MetricsPanelProps {
+    scopeId: string;
+}
+export declare function MetricsPanel({ scopeId }: MetricsPanelProps): import("react").JSX.Element;
+//# sourceMappingURL=metrics_panel.d.ts.map

package/dist/ui/metrics_panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics_panel.d.ts","sourceRoot":"","sources":["../../src/ui/metrics_panel.tsx"],"names":[],"mappings":"AA8FA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5F;AAeD,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,cAAc,+BAmBlD;AAMD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAaD,wBAAgB,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,cAAc,+BAmBxD;AAMD,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,KAAK,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAkBD,wBAAgB,cAAc,CAAC,EAAE,WAAW,EAAE,EAAE,mBAAmB,+BAyBlE;AAMD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB;AAoBD,wBAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,EAAE,iBAAiB,+BAyK1D"}