@scalebun-release/web 2.2.2

package/dist/features/analytics/revenue.d.ts

@@ -0,0 +1,77 @@
+/**
+ * A4 — revenue modeling. Beyond a flat `purchase`, the SDK supports revenue TYPE (one-time /
+ * subscription / refund), currency normalization, and LTV-ready fields (product / quantity /
+ * recurrence). Pure + unit-tested; the transport (revenue/currency top-level + folded props) is
+ * unchanged, so this rides the existing `Event` schema with zero migration. Group attribution is
+ * automatic — revenue events carry `groups` (A1) like every other event.
+ */
+/**
+ * What KIND of money movement this is.
+ *
+ * `dispute` and `adjustment` were added for the transaction ledger, which has to
+ * separate them: a chargeback is money taken back by the bank and an adjustment
+ * is a correction someone made, and lumping either into `refund` makes a refund
+ * rate that cannot be acted on.
+ *
+ * SIGN CONVENTION, which is the part that matters:
+ *   refund, dispute  ALWAYS stored negative — money left, whatever sign the
+ *                    caller used, so sums and LTV are right without every call
+ *                    site remembering the convention.
+ *   adjustment       keeps the CALLER's sign, because it is the one kind that
+ *                    legitimately goes either way (a credit or a debit).
+ */
+export type RevenueType = 'one_time' | 'subscription' | 'refund' | 'dispute' | 'adjustment';
+export interface RevenueInput {
+    /** Amount in `currency`. For refunds and disputes pass the positive amount (it is stored negative). */
+    revenue: number;
+    /** ISO-4217 currency; normalized to upper-case. */
+    currency: string;
+    /** Idempotency key — the backend dedups by (appId, 'purchase', transactionId). */
+    transactionId: string;
+    /** Revenue kind. Default 'one_time'. */
+    type?: RevenueType;
+    /** SKU / plan id for per-product revenue + LTV. */
+    productId?: string;
+    /** Human-readable SKU / plan name. Sent as `product_name` for Business plan attribution. */
+    productName?: string;
+    quantity?: number;
+    /** Billing cadence for subscriptions (e.g. 'monthly' | 'yearly'). */
+    recurrence?: string;
+    /**
+     * What came OUT of the charge before it was yours — the gross-to-net bridge.
+     *
+     * Each is a POSITIVE amount in `currency`, deducted from gross to produce net
+     * revenue. All three are optional, and a missing one is treated as ABSENT
+     * rather than as zero: net then simply does not claim a precision the payload
+     * did not carry. Sending `tax: 0` for a zero-rated sale is a different, and
+     * stronger, statement than sending nothing.
+     *
+     * `tax`       collected on behalf of an authority; never the seller's revenue.
+     * `fee`       store commission and payment-processor fees.
+     * `discount`  coupons and credits applied at the point of sale.
+     *
+     * These already reached the backend as loose properties via the spread below,
+     * which is exactly the problem: a typo'd `taxes: 3` looked identical to a real
+     * figure, and a string `"3.50"` was dropped at aggregation with no error. They
+     * are declared and validated so neither can happen silently.
+     */
+    tax?: number;
+    fee?: number;
+    discount?: number;
+    [k: string]: unknown;
+}
+export interface NormalizedRevenue {
+    revenue: number;
+    currency: string;
+    props: Record<string, unknown>;
+}
+/** Upper-case a 3-letter ISO-like code; return an empty string when invalid. */
+export declare function normalizeCurrency(c: string): string;
+export declare function validBusinessAmount(value: unknown): value is number;
+/**
+ * Validate + normalize a revenue event into top-level revenue/currency + folded LTV props. Refunds
+ * are stored as a NEGATIVE amount (regardless of the caller's sign convention) so sums/LTV are
+ * correct. Returns null when required fields or an explicit typed money field are invalid/out of range.
+ */
+export declare function normalizeRevenue(input: RevenueInput): NormalizedRevenue | null;
+//# sourceMappingURL=revenue.d.ts.map

package/dist/features/analytics/revenue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revenue.d.ts","sourceRoot":"","sources":["../../../src/features/analytics/revenue.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,cAAc,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,CAAC;AAE5F,MAAM,WAAW,YAAY;IAC3B,uGAAuG;IACvG,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,aAAa,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;;;;;;;;;;;OAiBG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAKD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,iBAAiB,GAAG,IAAI,CAkC9E"}

package/dist/features/analytics/revenue.js

@@ -0,0 +1,56 @@
+/** The adjustment keys, in the order the bridge deducts them. */
+const ADJUSTMENTS = ['tax', 'fee', 'discount'];
+/** Upper-case a 3-letter ISO-like code; return an empty string when invalid. */
+export function normalizeCurrency(c) {
+    c = c.trim();
+    return /^[a-z]{3}$/i.test(c) ? c.toUpperCase() : '';
+}
+export function validBusinessAmount(value) {
+    return typeof value === 'number' && Math.abs(value) < 1e10;
+}
+/**
+ * Validate + normalize a revenue event into top-level revenue/currency + folded LTV props. Refunds
+ * are stored as a NEGATIVE amount (regardless of the caller's sign convention) so sums/LTV are
+ * correct. Returns null when required fields or an explicit typed money field are invalid/out of range.
+ */
+export function normalizeRevenue(input) {
+    input = input || {};
+    const { revenue, currency, transactionId, type, productId, productName, quantity, recurrence, ...rest } = input;
+    const normalizedCurrency = typeof currency === 'string' ? normalizeCurrency(currency) : '';
+    const normalizedTransactionId = typeof transactionId === 'string' ? transactionId.trim() : '';
+    if (!validBusinessAmount(revenue) || !normalizedCurrency || !normalizedTransactionId
+        || normalizedTransactionId.length > 256)
+        return null;
+    const kind = type ?? 'one_time';
+    if (!/^(one_time|subscription|refund|dispute|adjustment)$/.test(kind))
+        return null;
+    // Written as two comparisons rather than a lookup table: the eager core has
+    // single-digit bytes of headroom, and an array plus `.includes` costs more
+    // than the branch it replaces.
+    const outflow = kind === 'refund' || kind === 'dispute';
+    const amount = outflow ? -Math.abs(revenue) : revenue;
+    const props = { ...rest, transaction_id: normalizedTransactionId, revenue_type: kind };
+    const productIdText = typeof productId === 'string' ? productId.trim() : '';
+    const productNameText = typeof productName === 'string' ? productName.trim() : '';
+    if (productIdText && productIdText.length <= 256)
+        props.product_id = productIdText;
+    if (productNameText && productNameText.length <= 512)
+        props.product_name = productNameText;
+    if (quantity != null)
+        props.quantity = quantity;
+    if (recurrence)
+        props.recurrence = recurrence;
+    // Adjustments are always positive because the aggregate DEDUCTS them. Reject the
+    // whole purchase when an explicit adjustment is invalid: silently omitting a fee
+    // would overstate net revenue while making the event look complete.
+    for (const k of ADJUSTMENTS) {
+        const v = input[k];
+        if (v !== undefined) {
+            if (!validBusinessAmount(v))
+                return null;
+            props[k] = Math.abs(v);
+        }
+    }
+    return { revenue: amount, currency: normalizedCurrency, props };
+}
+//# sourceMappingURL=revenue.js.map

package/dist/features/analytics/revenue.js.map

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

package/dist/features/analytics/sampler.d.ts

@@ -0,0 +1,2 @@
+export declare function keepEvent(name: string, anonymousId: string, sampleRate: number): boolean;
+//# sourceMappingURL=sampler.d.ts.map

package/dist/features/analytics/sampler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampler.d.ts","sourceRoot":"","sources":["../../../src/features/analytics/sampler.ts"],"names":[],"mappings":"AAgBA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAMxF"}

package/dist/features/analytics/sampler.js

@@ -0,0 +1,24 @@
+/**
+ * A6 — analytics-lane sampling. Unlike replay/errors/network (per-event/per-request), product
+ * analytics samples PER-USER so funnels & retention stay intact: a deterministic subset of anonymous
+ * ids is kept in full, the rest are thinned. Identity + revenue events are NEVER thinned (money and
+ * profile links must be complete). Same fnv1a32 family as flags/grouping → the backend can reconcile.
+ */
+import { fnv1a32 } from '../config/bucketing.js';
+// NOTE: keeps the legacy `wzb-` prefix on purpose. This salt is a bucketing input, not
+// branding — nobody ever sees it, and changing the string reshuffles which sessions are
+// sampled. It was left untouched by the ScaleBun rebrand for that reason.
+const SALT = 'wzb-analytics-v1';
+// Events that must always survive sampling regardless of the user's bucket.
+const ALWAYS_KEEP = new Set(['$identify', '$group', '$alias', 'purchase']);
+export function keepEvent(name, anonymousId, sampleRate) {
+    if (sampleRate >= 1)
+        return true; // default — keep everything
+    if (ALWAYS_KEEP.has(name))
+        return true; // identity + revenue never thinned
+    if (sampleRate <= 0)
+        return false;
+    // Per-user deterministic bucket in [0, 10000): a given user is consistently kept or dropped.
+    return fnv1a32(`${anonymousId}:${SALT}`) % 10000 < sampleRate * 10000;
+}
+//# sourceMappingURL=sampler.js.map

package/dist/features/analytics/sampler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampler.js","sourceRoot":"","sources":["../../../src/features/analytics/sampler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,uFAAuF;AACvF,wFAAwF;AACxF,0EAA0E;AAC1E,MAAM,IAAI,GAAG,kBAAkB,CAAC;AAEhC,4EAA4E;AAC5E,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;AAE3E,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,WAAmB,EAAE,UAAkB;IAC7E,IAAI,UAAU,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,4BAA4B;IAC9D,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,mCAAmC;IAC3E,IAAI,UAAU,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAClC,6FAA6F;IAC7F,OAAO,OAAO,CAAC,GAAG,WAAW,IAAI,IAAI,EAAE,CAAC,GAAG,KAAM,GAAG,UAAU,GAAG,KAAM,CAAC;AAC1E,CAAC"}

package/dist/features/analytics/subscription.d.ts

@@ -0,0 +1,35 @@
+/** Backend subscription-ledger wire contract. Additive fields require a new version. */
+export declare const SUBSCRIPTION_SCHEMA_VERSION = 3;
+export type SubscriptionStatus = 'trial_started' | 'trial_converted' | 'started' | 'renewed' | 'plan_changed' | 'cancel_scheduled' | 'resumed' | 'canceled' | 'expired' | 'payment_failed' | 'refunded';
+/** Stable cancellation taxonomy shared by Web, React Native and the dashboard. */
+export type CancellationReason = 'too_expensive' | 'no_longer_needed' | 'competitive_offer' | 'missing_features' | 'poor_experience' | 'payment_issue' | 'other';
+export interface SubscriptionPlan {
+    id?: string;
+    name?: string;
+    amount: number;
+    currency: string;
+    interval: 'day' | 'week' | 'month' | 'year';
+    intervalCount?: number;
+}
+export interface SubscriptionInput {
+    /** Stable subscription identity, scoped to the current app/environment. */
+    subscriptionId: string;
+    /**
+     * Optional stable identity for this lifecycle change. Reuse it when the host repeats the same
+     * logical call; the backend keeps the first accepted payload. A missing key falls back to the
+     * SDK envelope event id, so transport retries remain idempotent either way.
+     */
+    subscriptionEventId?: string;
+    status: SubscriptionStatus;
+    /** Optional structured reason for cancel_scheduled/canceled/expired events. */
+    cancellationReason?: CancellationReason;
+    /** Optional free-text detail; bounded before it enters the event ledger. */
+    cancellationComment?: string;
+    plan?: SubscriptionPlan;
+    trialEndAt?: string | Date;
+    effectiveAt?: string | Date;
+    properties?: Record<string, unknown>;
+}
+/** Validate + build the `$subscription` event properties. Returns null (drop) on invalid input. */
+export declare function normalizeSubscription(input: SubscriptionInput): Record<string, unknown> | null;
+//# sourceMappingURL=subscription.d.ts.map

package/dist/features/analytics/subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../../src/features/analytics/subscription.ts"],"names":[],"mappings":"AAOA,wFAAwF;AACxF,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAG7C,MAAM,MAAM,kBAAkB,GAC1B,eAAe,GACf,iBAAiB,GACjB,SAAS,GACT,SAAS,GACT,cAAc,GACd,kBAAkB,GAClB,SAAS,GACT,UAAU,GACV,SAAS,GACT,gBAAgB,GAChB,UAAU,CAAC;AAEf,kFAAkF;AAClF,MAAM,MAAM,kBAAkB,GAC1B,eAAe,GACf,kBAAkB,GAClB,mBAAmB,GACnB,kBAAkB,GAClB,iBAAiB,GACjB,eAAe,GACf,OAAO,CAAC;AAYZ,MAAM,WAAW,gBAAgB;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,cAAc,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,+EAA+E;IAC/E,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,4EAA4E;IAC5E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AA8BD,mGAAmG;AACnG,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CA2C9F"}

package/dist/features/analytics/subscription.js

@@ -0,0 +1,95 @@
+/**
+ * W2/M3 — `trackSubscription()` input types + a pure validate-or-drop normalizer (mirrors
+ * `revenue.ts`). Produces the `properties` payload for a `$subscription` analytics event; the backend
+ * ledger reads `subscriptionId`/`status`/`plan`/`effectiveAt` from it and folds it into MRR state.
+ */
+import { normalizeCurrency, validBusinessAmount } from './revenue.js';
+/** Backend subscription-ledger wire contract. Additive fields require a new version. */
+export const SUBSCRIPTION_SCHEMA_VERSION = 3;
+const SUBSCRIPTION_KEY = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,159}$/;
+const CANCELLATION_REASONS = [
+    'too_expensive', 'no_longer_needed', 'competitive_offer', 'missing_features',
+    'poor_experience', 'payment_issue', 'other',
+];
+const STATUSES = [
+    'trial_started', 'trial_converted', 'started', 'plan_changed', 'renewed', 'cancel_scheduled',
+    'resumed', 'canceled', 'expired', 'payment_failed', 'refunded',
+];
+/** `undefined` means absent; `null` means an explicit but invalid business timestamp. */
+function toIso(value, maxFutureMs) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value === 'string' ? value.length > 64 : !(value instanceof Date))
+        return null;
+    const date = new Date(value);
+    return +date <= Date.now() + maxFutureMs ? date.toISOString() : null;
+}
+function cleanPlan(plan) {
+    const p = (plan || {});
+    const currency = typeof p.currency === 'string' ? normalizeCurrency(p.currency) : '';
+    const intervalCount = p.intervalCount;
+    if (!validBusinessAmount(p.amount) || p.amount < 0
+        || !currency || !/^(day|week|month|year)$/.test(p.interval)
+        || (intervalCount !== undefined && (intervalCount !== (intervalCount | 0)
+            || intervalCount <= 0 || intervalCount > 1000)))
+        return null;
+    const id = typeof p.id === 'string' ? p.id.trim() : '';
+    const name = typeof p.name === 'string' ? p.name.trim() : '';
+    return {
+        amount: p.amount,
+        currency,
+        interval: p.interval,
+        ...(intervalCount === undefined ? {} : { intervalCount }),
+        ...(id && id.length <= 256 ? { id } : {}),
+        ...(name && name.length <= 512 ? { name } : {}),
+    };
+}
+/** Validate + build the `$subscription` event properties. Returns null (drop) on invalid input. */
+export function normalizeSubscription(input) {
+    input = input || {};
+    const subscriptionId = typeof input.subscriptionId === 'string' ? input.subscriptionId.trim() : '';
+    const subscriptionEventId = typeof input.subscriptionEventId === 'string'
+        ? input.subscriptionEventId.trim()
+        : input.subscriptionEventId;
+    const status = input.status;
+    const statusIndex = STATUSES.indexOf(status);
+    if (!SUBSCRIPTION_KEY.test(subscriptionId)
+        || (subscriptionEventId !== undefined
+            && (typeof subscriptionEventId !== 'string' || !SUBSCRIPTION_KEY.test(subscriptionEventId)))
+        || statusIndex < 0)
+        return null;
+    const cancellationReason = input.cancellationReason;
+    const cancellationComment = typeof input.cancellationComment === 'string'
+        ? input.cancellationComment.trim()
+        : input.cancellationComment;
+    const cancellationStatus = status === 'cancel_scheduled' || status === 'canceled' || status === 'expired';
+    if ((cancellationReason !== undefined || cancellationComment !== undefined) && !cancellationStatus)
+        return null;
+    if (cancellationReason !== undefined && !CANCELLATION_REASONS.includes(cancellationReason))
+        return null;
+    if (cancellationComment !== undefined
+        && (typeof cancellationComment !== 'string' || !cancellationComment || cancellationComment.length > 500))
+        return null;
+    const plan = input.plan;
+    const normalizedPlan = plan === undefined ? undefined : cleanPlan(plan);
+    if (!normalizedPlan && (statusIndex < 4 || plan !== undefined))
+        return null;
+    const trialEndAt = toIso(input.trialEndAt, 316224000000);
+    const effectiveAt = toIso(input.effectiveAt, 86400000);
+    if (trialEndAt === null || effectiveAt === null)
+        return null;
+    return {
+        /* Custom dimensions cannot override the validated ledger identity/state. */
+        ...(input.properties ?? {}),
+        schemaVersion: SUBSCRIPTION_SCHEMA_VERSION,
+        subscriptionId,
+        ...(subscriptionEventId === undefined ? {} : { subscriptionEventId }),
+        status,
+        ...(cancellationReason === undefined ? {} : { cancellationReason }),
+        ...(cancellationComment === undefined ? {} : { cancellationComment }),
+        plan: normalizedPlan,
+        trialEndAt,
+        effectiveAt,
+    };
+}
+//# sourceMappingURL=subscription.js.map

package/dist/features/analytics/subscription.js.map

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

package/dist/features/attention/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Attention producer (#25 P1) — "where on the page do visitors actually spend their attention?".
+ *
+ * The model is "scroll maps + a dwell timer": the document is split into N vertical BANDS; a coarse tick
+ * accrues elapsed time to each band weighted by how much of it is currently in the viewport — gated so
+ * only ACTIVE, VISIBLE time counts (tab foregrounded AND the user not idle). Pure geometry + time: no
+ * per-element observers (virtualization/portal/canvas-proof), no page content, no PII.
+ *
+ * Loaded as its OWN chunk from inside the already-lazy autocapture chunk → the eager core pays ~0 bytes.
+ * Autocapture spreads `summary()` into `$pageleave` (like the scroll producer) and calls `reset()` on
+ * each SPA pageview. Positions + durations only.
+ */
+export declare const ATTENTION_BANDS = 10;
+export interface AttentionSummary {
+    /** Dwell time (ms) per vertical band, top→bottom (length = ATTENTION_BANDS). */
+    attention_bands: number[];
+    /** Total active+visible time credited across all bands (ms). */
+    attention_active_ms: number;
+    attention_bands_n: number;
+}
+export interface AttentionTracker {
+    summary: () => AttentionSummary;
+    reset: () => void;
+    stop: () => void;
+}
+/** Visible fraction (0..1) of each band given the current scroll offset + viewport. Pure + testable. */
+export declare function bandFractions(scrollY: number, viewportH: number, docH: number, n: number): number[];
+export declare function installAttentionTracker(): AttentionTracker;
+//# sourceMappingURL=index.d.ts.map

package/dist/features/attention/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/attention/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,eAAe,KAAK,CAAC;AAIlC,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gEAAgE;IAChE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,gBAAgB,CAAC;IAChC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,wGAAwG;AACxG,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAanG;AAID,wBAAgB,uBAAuB,IAAI,gBAAgB,CAmF1D"}

package/dist/features/attention/index.js

@@ -0,0 +1,128 @@
+/**
+ * Attention producer (#25 P1) — "where on the page do visitors actually spend their attention?".
+ *
+ * The model is "scroll maps + a dwell timer": the document is split into N vertical BANDS; a coarse tick
+ * accrues elapsed time to each band weighted by how much of it is currently in the viewport — gated so
+ * only ACTIVE, VISIBLE time counts (tab foregrounded AND the user not idle). Pure geometry + time: no
+ * per-element observers (virtualization/portal/canvas-proof), no page content, no PII.
+ *
+ * Loaded as its OWN chunk from inside the already-lazy autocapture chunk → the eager core pays ~0 bytes.
+ * Autocapture spreads `summary()` into `$pageleave` (like the scroll producer) and calls `reset()` on
+ * each SPA pageview. Positions + durations only.
+ */
+export const ATTENTION_BANDS = 10;
+const TICK_MS = 500; // coarse accrual (not per-scroll / per-frame)
+const IDLE_MS = 15000; // no interaction this long → stop crediting attention
+/** Visible fraction (0..1) of each band given the current scroll offset + viewport. Pure + testable. */
+export function bandFractions(scrollY, viewportH, docH, n) {
+    const out = new Array(n).fill(0);
+    if (docH <= 0 || viewportH <= 0 || n <= 0)
+        return out;
+    const bandH = docH / n;
+    const vTop = Math.max(0, scrollY);
+    const vBot = Math.min(docH, scrollY + viewportH);
+    for (let i = 0; i < n; i++) {
+        const bTop = i * bandH;
+        const bBot = (i + 1) * bandH;
+        const overlap = Math.max(0, Math.min(vBot, bBot) - Math.max(vTop, bTop));
+        out[i] = bandH > 0 ? overlap / bandH : 0;
+    }
+    return out;
+}
+const now = () => (typeof performance !== 'undefined' && performance.now ? performance.now() : Date.now());
+export function installAttentionTracker() {
+    if (typeof window === 'undefined' || typeof document === 'undefined') {
+        return { summary: () => zero(), reset: () => { }, stop: () => { } };
+    }
+    const bands = new Array(ATTENTION_BANDS).fill(0);
+    let docH = 0;
+    let viewportH = 0;
+    let lastTick = now();
+    let lastActivity = now();
+    let stopped = false;
+    const de = () => document.documentElement;
+    const readHeights = () => {
+        try {
+            docH = Math.max(docH, de().scrollHeight);
+            viewportH = window.innerHeight || de().clientHeight || 0;
+        }
+        catch {
+            /* metrics unavailable */
+        }
+    };
+    /** Credit the elapsed interval to visible bands — only when active + visible. */
+    const tick = () => {
+        if (stopped)
+            return; // a stopped tracker never accrues (summary() calls tick() to flush)
+        const t = now();
+        const dt = t - lastTick;
+        lastTick = t;
+        if (dt <= 0)
+            return;
+        if (typeof document.visibilityState === 'string' && document.visibilityState !== 'visible')
+            return;
+        if (t - lastActivity > IDLE_MS)
+            return;
+        const y = window.scrollY || window.pageYOffset || 0;
+        const fr = bandFractions(y, viewportH, docH, ATTENTION_BANDS);
+        for (let i = 0; i < ATTENTION_BANDS; i++)
+            bands[i] = (bands[i] ?? 0) + dt * (fr[i] ?? 0);
+    };
+    const onActivity = () => { lastActivity = now(); };
+    const onVisibility = () => {
+        if (document.visibilityState === 'visible')
+            lastTick = now(); // don't credit the hidden gap
+        else
+            tick(); // flush what was visible before hiding
+    };
+    let timer;
+    let ro;
+    if (typeof ResizeObserver !== 'undefined') {
+        try {
+            ro = new ResizeObserver(() => readHeights());
+            ro.observe(de());
+        }
+        catch {
+            ro = undefined;
+        }
+    }
+    readHeights();
+    timer = setInterval(tick, TICK_MS);
+    window.addEventListener('scroll', onActivity, { passive: true });
+    window.addEventListener('pointermove', onActivity, { passive: true });
+    window.addEventListener('keydown', onActivity, { passive: true });
+    window.addEventListener('resize', readHeights, { passive: true });
+    document.addEventListener('visibilitychange', onVisibility);
+    const summary = () => {
+        readHeights();
+        tick(); // flush the pending sub-tick interval
+        const rounded = bands.map((b) => Math.round(b));
+        return { attention_bands: rounded, attention_active_ms: rounded.reduce((s, b) => s + b, 0), attention_bands_n: ATTENTION_BANDS };
+    };
+    return {
+        summary,
+        reset: () => {
+            bands.fill(0);
+            docH = 0;
+            viewportH = 0;
+            lastTick = now();
+            lastActivity = now();
+            readHeights();
+        },
+        stop: () => {
+            stopped = true;
+            if (timer)
+                clearInterval(timer);
+            window.removeEventListener('scroll', onActivity);
+            window.removeEventListener('pointermove', onActivity);
+            window.removeEventListener('keydown', onActivity);
+            window.removeEventListener('resize', readHeights);
+            document.removeEventListener('visibilitychange', onVisibility);
+            ro?.disconnect();
+        },
+    };
+}
+function zero() {
+    return { attention_bands: new Array(ATTENTION_BANDS).fill(0), attention_active_ms: 0, attention_bands_n: ATTENTION_BANDS };
+}
+//# sourceMappingURL=index.js.map

package/dist/features/attention/index.js.map

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

package/dist/features/bugreport/BugReportFeature.d.ts

@@ -0,0 +1,37 @@
+/**
+ * F-BUG — bug-report feature. Phase 1 is programmatic (ScaleBun.reportBug(...)); a launcher widget is
+ * a later phase. Its job here is the capture *signal*: on report, it raises `ctx.signal('report')` so
+ * the replay feature flushes its buffer into the session — the report then references the same
+ * sessionId and the dashboard joins the replay frame + network + console + errors automatically.
+ * The actual HTTP submit is orchestrated by the facade (which holds session + transport + registry).
+ */
+import type { IFeature, FeatureContext } from '@scalebun/sdk-contracts';
+import type { SubmitResult, WidgetPosition } from './widget.js';
+export interface LauncherOptions {
+    position: WidgetPosition;
+    label: string;
+}
+/** Resolves to the report id, or to `{ id, reason }` naming which branch of the submit path failed. */
+type SubmitFn = (input: {
+    message: string;
+    email?: string;
+}) => Promise<SubmitResult>;
+export declare class BugReportFeature implements IFeature {
+    readonly name = "bugReport";
+    private ctx;
+    private active;
+    private submitFn;
+    private widget;
+    private mounting;
+    get isActive(): boolean;
+    setup(ctx: FeatureContext): void;
+    /** Raise the 'report' capture-signal → replay flushes its buffer into the current session. */
+    signalReport(): void;
+    /** Wired by the facade after init — the full reportBug submit path (transport + context). */
+    setSubmit(fn: SubmitFn): void;
+    /** Mount the embeddable launcher widget (lazy-imported so it stays out of the core bundle). */
+    mountLauncher(opts: LauncherOptions): Promise<void>;
+    teardown(): void;
+}
+export {};
+//# sourceMappingURL=BugReportFeature.d.ts.map

package/dist/features/bugreport/BugReportFeature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BugReportFeature.d.ts","sourceRoot":"","sources":["../../../src/features/bugreport/BugReportFeature.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAgB,cAAc,EAAE,MAAM,UAAU,CAAC;AAE3E,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uGAAuG;AACvG,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AAEtF,qBAAa,gBAAiB,YAAW,QAAQ;IAC/C,QAAQ,CAAC,IAAI,eAAe;IAC5B,OAAO,CAAC,GAAG,CAA+B;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,QAAQ,CAAS;IAEzB,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAKhC,8FAA8F;IAC9F,YAAY,IAAI,IAAI;IAIpB,6FAA6F;IAC7F,SAAS,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI;IAI7B,+FAA+F;IACzF,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBzD,QAAQ,IAAI,IAAI;CAMjB"}

package/dist/features/bugreport/BugReportFeature.js

@@ -0,0 +1,56 @@
+export class BugReportFeature {
+    constructor() {
+        this.name = 'bugReport';
+        this.ctx = null;
+        this.active = false;
+        this.submitFn = null;
+        this.widget = null;
+        this.mounting = false; // synchronous guard against a double-mount race (mountLauncher is async)
+    }
+    get isActive() {
+        return this.active;
+    }
+    setup(ctx) {
+        this.ctx = ctx;
+        this.active = true;
+    }
+    /** Raise the 'report' capture-signal → replay flushes its buffer into the current session. */
+    signalReport() {
+        this.ctx?.signal('report');
+    }
+    /** Wired by the facade after init — the full reportBug submit path (transport + context). */
+    setSubmit(fn) {
+        this.submitFn = fn;
+    }
+    /** Mount the embeddable launcher widget (lazy-imported so it stays out of the core bundle). */
+    async mountLauncher(opts) {
+        // Guard synchronously (before the await) so two near-simultaneous calls can't both mount.
+        if (this.widget || this.mounting || typeof document === 'undefined')
+            return;
+        this.mounting = true;
+        try {
+            const { createBugReportWidget } = await import('./widget.js');
+            if (this.widget)
+                return; // re-check after the async gap
+            this.widget = createBugReportWidget({
+                position: opts.position,
+                label: opts.label,
+                // No submitFn means the facade never finished wiring — that is 'init', not a send failure.
+                onSubmit: (input) => this.submitFn ? this.submitFn(input) : Promise.resolve({ e: 'init' }),
+            });
+        }
+        catch {
+            /* widget is optional — never break the host if the chunk fails to load */
+        }
+        finally {
+            this.mounting = false;
+        }
+    }
+    teardown() {
+        this.widget?.destroy();
+        this.widget = null;
+        this.submitFn = null;
+        this.active = false;
+    }
+}
+//# sourceMappingURL=BugReportFeature.js.map

package/dist/features/bugreport/BugReportFeature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BugReportFeature.js","sourceRoot":"","sources":["../../../src/features/bugreport/BugReportFeature.ts"],"names":[],"mappings":"AAkBA,MAAM,OAAO,gBAAgB;IAA7B;QACW,SAAI,GAAG,WAAW,CAAC;QACpB,QAAG,GAA0B,IAAI,CAAC;QAClC,WAAM,GAAG,KAAK,CAAC;QACf,aAAQ,GAAoB,IAAI,CAAC;QACjC,WAAM,GAAwB,IAAI,CAAC;QACnC,aAAQ,GAAG,KAAK,CAAC,CAAC,yEAAyE;IAiDrG,CAAC;IA/CC,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,GAAmB;QACvB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,8FAA8F;IAC9F,YAAY;QACV,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAED,6FAA6F;IAC7F,SAAS,CAAC,EAAY;QACpB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACrB,CAAC;IAED,+FAA+F;IAC/F,KAAK,CAAC,aAAa,CAAC,IAAqB;QACvC,0FAA0F;QAC1F,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,WAAW;YAAE,OAAO;QAC5E,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;YAC3D,IAAI,IAAI,CAAC,MAAM;gBAAE,OAAO,CAAC,+BAA+B;YACxD,IAAI,CAAC,MAAM,GAAG,qBAAqB,CAAC;gBAClC,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,2FAA2F;gBAC3F,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAClB,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,MAAe,EAAE,CAAC;aACjF,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,0EAA0E;QAC5E,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACxB,CAAC;IACH,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;CACF"}