@scalebun/web 1.0.0

package/dist/features/config/targeting.js

@@ -0,0 +1,57 @@
+/** Read an attribute, supporting a dot-path (`group.company`) and flat keys (`group_company`). */
+function getAttr(ctx, path) {
+    if (path in ctx)
+        return ctx[path];
+    if (path.indexOf('.') === -1)
+        return undefined;
+    let cur = ctx;
+    for (const part of path.split('.')) {
+        if (cur == null || typeof cur !== 'object')
+            return undefined;
+        cur = cur[part];
+    }
+    return cur;
+}
+function matchCondition(ctx, c) {
+    const actual = getAttr(ctx, c.attr);
+    const value = c.value;
+    switch (c.op) {
+        case 'exists':
+            return actual != null;
+        case 'eq':
+            return actual === value;
+        case 'neq':
+            return actual !== value;
+        case 'in':
+            return Array.isArray(value) && value.includes(actual);
+        case 'nin':
+            return Array.isArray(value) && !value.includes(actual);
+        case 'contains':
+            return typeof actual === 'string' && typeof value === 'string' && actual.includes(value);
+        case 'gt':
+            return typeof actual === 'number' && typeof value === 'number' && actual > value;
+        case 'lt':
+            return typeof actual === 'number' && typeof value === 'number' && actual < value;
+        default:
+            return false;
+    }
+}
+function ruleMatches(ctx, rule) {
+    const all = rule.all ?? [];
+    const any = rule.any ?? [];
+    if (all.length === 0 && any.length === 0)
+        return true; // empty rule = catch-all
+    const allOk = all.every((c) => matchCondition(ctx, c));
+    const anyOk = any.length === 0 || any.some((c) => matchCondition(ctx, c));
+    return allOk && anyOk;
+}
+/** First rule (top-down) whose conditions match the context, or null when none do. */
+export function evaluateTargeting(rules, ctx) {
+    if (!rules || rules.length === 0)
+        return null;
+    for (const rule of rules)
+        if (ruleMatches(ctx, rule))
+            return rule;
+    return null;
+}
+//# sourceMappingURL=targeting.js.map

package/dist/features/config/targeting.js.map

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

package/dist/features/config/types.d.ts

@@ -0,0 +1,100 @@
+/** Wire shapes for GET /config — mirrors the backend SdkConfigResponse + the RN SDK payload. */
+export type RemoteConfigType = 'string' | 'number' | 'boolean' | 'json';
+export type TargetOp = 'eq' | 'neq' | 'in' | 'nin' | 'contains' | 'gt' | 'lt' | 'exists';
+export interface TargetCondition {
+    attr: string;
+    op: TargetOp;
+    value?: unknown;
+}
+export interface TargetRule {
+    all?: TargetCondition[];
+    any?: TargetCondition[];
+    serve?: boolean;
+    rollout?: number;
+    percentage?: number;
+    variants?: SdkExperimentVariant[];
+    include?: boolean;
+    variation?: string;
+}
+export type FlagValue = boolean | string | number | Record<string, unknown> | unknown[] | null;
+export interface SdkFlagVariation {
+    key: string;
+    value: FlagValue;
+    allocationPct?: number;
+}
+export type FlagReason = 'TARGETING_MATCH' | 'ROLLOUT' | 'DEFAULT' | 'FLAG_NOT_FOUND';
+export interface VariationDetail<T> {
+    value: T;
+    variant: string | null;
+    reason: FlagReason;
+}
+export type BucketBy = string;
+export interface SdkFlag {
+    key: string;
+    enabled: boolean;
+    salt?: string;
+    targeting?: TargetRule[];
+    bucketBy?: BucketBy;
+    variations?: SdkFlagVariation[];
+    defaultVariant?: string;
+    defaultValue?: FlagValue;
+}
+export interface SdkRemoteConfig {
+    key: string;
+    value: string;
+    type: RemoteConfigType;
+}
+export interface SdkExperimentVariant {
+    key: string;
+    allocationPct: number;
+}
+export interface SdkExperiment {
+    key: string;
+    salt: string;
+    goalEventName?: string | null;
+    variants: SdkExperimentVariant[];
+    targeting?: TargetRule[];
+    bucketBy?: BucketBy;
+    layer?: string;
+    layerRange?: [number, number];
+}
+export interface SdkHoldout {
+    salt: string;
+    percentage: number;
+}
+export interface SdkRollout {
+    key: string;
+    salt: string;
+    percentage: number;
+    targeting?: TargetRule[];
+    bucketBy?: BucketBy;
+}
+export interface SdkEntitlements {
+    replay: boolean;
+    networkMonitoring: boolean;
+    crashReporting: boolean;
+    performanceMonitoring: boolean;
+    logs: boolean;
+    heatmaps: boolean;
+}
+/** Server-controlled SDK behaviour switches. Lets a behaviour change be enabled per app from the
+ *  backend, without shipping an SDK release — and rolled back the same way. Every switch must
+ *  default to the PRE-EXISTING behaviour when absent, so an older payload is always safe. */
+export interface SdkFlags {
+    /** Bucket rule rollouts / experiments on the stable install id instead of `userId ?? deviceId`.
+     *  Off by default: turning it on re-buckets already-logged-in users ONCE, so it is enabled for
+     *  new experiments first. See ConfigFeature.bucketingId(). */
+    stableBucketingId?: boolean;
+}
+export interface SdkConfigPayload {
+    version: string;
+    flags: SdkFlag[];
+    remoteConfig: SdkRemoteConfig[];
+    experiments: SdkExperiment[];
+    rollouts: SdkRollout[];
+    entitlements?: Partial<SdkEntitlements>;
+    holdout?: SdkHoldout;
+    sdkFlags?: SdkFlags;
+}
+export declare const EMPTY_CONFIG: SdkConfigPayload;
+//# sourceMappingURL=types.d.ts.map

package/dist/features/config/types.d.ts.map

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

package/dist/features/config/types.js

@@ -0,0 +1,9 @@
+/** Wire shapes for GET /config — mirrors the backend SdkConfigResponse + the RN SDK payload. */
+export const EMPTY_CONFIG = {
+    version: '',
+    flags: [],
+    remoteConfig: [],
+    experiments: [],
+    rollouts: [],
+};
+//# sourceMappingURL=types.js.map

package/dist/features/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/features/config/types.ts"],"names":[],"mappings":"AAAA,gGAAgG;AA2HhG,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,EAAE;IACT,YAAY,EAAE,EAAE;IAChB,WAAW,EAAE,EAAE;IACf,QAAQ,EAAE,EAAE;CACb,CAAC"}

package/dist/features/console/ConsoleFeature.d.ts

@@ -0,0 +1,31 @@
+/**
+ * F-CON — wraps console.{debug,info,log,warn,error} and emits contract `log` breadcrumbs onto the
+ * unified pipeline. The original console is ALWAYS called first (we never swallow the developer's
+ * output). Noise is throttled (warn/error always kept; info/debug sampled); messages are
+ * safe-serialized + scrubbed. A small recent-ring is exposed for F-BUG to attach recent breadcrumbs.
+ *
+ * Feedback-loop guard: the SDK's own logger writes via `console.info('[scalebun]', …)`, and our own
+ * serialize/emit path may log — a re-entrancy flag + a `[scalebun]` prefix skip prevent capturing
+ * our own diagnostics (which would otherwise recurse / pollute the customer's stream).
+ */
+import type { IFeature, FeatureContext } from '@scalebun/sdk-contracts';
+import type { LogItem } from '@scalebun/protocol';
+export declare class ConsoleFeature implements IFeature {
+    readonly name = "console";
+    private ctx;
+    private active;
+    private readonly throttle;
+    private readonly originals;
+    /** Reentrancy guard — true while we're inside our own capture path. */
+    private capturing;
+    /** Last N emitted breadcrumbs, for F-BUG to attach without re-capturing. */
+    private readonly ring;
+    get isActive(): boolean;
+    setup(ctx: FeatureContext): void;
+    private capture;
+    private pushRing;
+    /** Recent breadcrumbs (oldest→newest). Consumed by F-BUG; safe to call anytime. */
+    getRecent(): readonly LogItem[];
+    teardown(): void;
+}
+//# sourceMappingURL=ConsoleFeature.d.ts.map

package/dist/features/console/ConsoleFeature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleFeature.d.ts","sourceRoot":"","sources":["../../../src/features/console/ConsoleFeature.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAUlD,qBAAa,cAAe,YAAW,QAAQ;IAC7C,QAAQ,CAAC,IAAI,aAAa;IAC1B,OAAO,CAAC,GAAG,CAA+B;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuC;IACjE,uEAAuE;IACvE,OAAO,CAAC,SAAS,CAAS;IAC1B,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiB;IAEtC,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAwBhC,OAAO,CAAC,OAAO;IAmBf,OAAO,CAAC,QAAQ;IAKhB,mFAAmF;IACnF,SAAS,IAAI,SAAS,OAAO,EAAE;IAI/B,QAAQ,IAAI,IAAI;CAUjB"}

package/dist/features/console/ConsoleFeature.js

@@ -0,0 +1,98 @@
+/**
+ * F-CON — wraps console.{debug,info,log,warn,error} and emits contract `log` breadcrumbs onto the
+ * unified pipeline. The original console is ALWAYS called first (we never swallow the developer's
+ * output). Noise is throttled (warn/error always kept; info/debug sampled); messages are
+ * safe-serialized + scrubbed. A small recent-ring is exposed for F-BUG to attach recent breadcrumbs.
+ *
+ * Feedback-loop guard: the SDK's own logger writes via `console.info('[scalebun]', …)`, and our own
+ * serialize/emit path may log — a re-entrancy flag + a `[scalebun]` prefix skip prevent capturing
+ * our own diagnostics (which would otherwise recurse / pollute the customer's stream).
+ */
+import { WZB_LOG_PREFIX } from '../../core/logger';
+import { toLogItem, levelFor } from './normalize';
+import { LogThrottle } from './throttle';
+const METHODS = ['debug', 'info', 'log', 'warn', 'error'];
+const RING_MAX = 50;
+export class ConsoleFeature {
+    constructor() {
+        this.name = 'console';
+        this.ctx = null;
+        this.active = false;
+        this.throttle = new LogThrottle();
+        this.originals = new Map();
+        /** Reentrancy guard — true while we're inside our own capture path. */
+        this.capturing = false;
+        /** Last N emitted breadcrumbs, for F-BUG to attach without re-capturing. */
+        this.ring = [];
+    }
+    get isActive() {
+        return this.active;
+    }
+    setup(ctx) {
+        if (this.active)
+            return; // idempotent — a second setup without teardown would double-wrap console
+        this.ctx = ctx;
+        if (typeof console === 'undefined')
+            return;
+        for (const method of METHODS) {
+            const original = console[method];
+            if (typeof original !== 'function')
+                continue;
+            this.originals.set(method, original);
+            const wrapped = (...args) => {
+                // Always call through first — never break the developer's console.
+                try {
+                    original.apply(console, args);
+                }
+                catch {
+                    /* a throwing original must never break capture */
+                }
+                this.capture(method, args);
+            };
+            console[method] = wrapped;
+        }
+        this.active = true;
+    }
+    capture(method, args) {
+        if (this.capturing)
+            return; // don't capture logs emitted from within our own path
+        // Skip the SDK's own debug output (`console.info(WZB_LOG_PREFIX, …)`) — shared constant so this
+        // guard and the logger can't drift.
+        if (args.length > 0 && args[0] === WZB_LOG_PREFIX)
+            return;
+        this.capturing = true;
+        try {
+            if (!this.throttle.accept(levelFor(method)))
+                return;
+            const item = toLogItem(method, args, this.throttle.takeDropped());
+            this.pushRing(item);
+            this.ctx?.emit(item);
+        }
+        catch {
+            /* capture must never throw into the host app */
+        }
+        finally {
+            this.capturing = false;
+        }
+    }
+    pushRing(item) {
+        this.ring.push(item);
+        if (this.ring.length > RING_MAX)
+            this.ring.shift();
+    }
+    /** Recent breadcrumbs (oldest→newest). Consumed by F-BUG; safe to call anytime. */
+    getRecent() {
+        return this.ring.slice();
+    }
+    teardown() {
+        if (typeof console !== 'undefined') {
+            for (const [method, original] of this.originals) {
+                console[method] = original;
+            }
+        }
+        this.originals.clear();
+        this.ring.length = 0;
+        this.active = false;
+    }
+}
+//# sourceMappingURL=ConsoleFeature.js.map

package/dist/features/console/ConsoleFeature.js.map

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

package/dist/features/console/normalize.d.ts

@@ -0,0 +1,18 @@
+/** Builds a contract `log` Item from a console call. Pure — shared by the wrapper + tests. */
+import type { LogItem } from '@scalebun/protocol';
+/** The console methods we wrap. */
+export type ConsoleMethod = 'debug' | 'info' | 'log' | 'warn' | 'error';
+/** The contract log levels (LogItem.level enum — frozen). */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Map a console method → contract level. The contract has no `log` level, so `console.log` collapses
+ * to `info` (the conventional mapping); the literal method is preserved in `metadata.method`.
+ */
+export declare function levelFor(method: ConsoleMethod): LogLevel;
+/**
+ * Normalize one console call into a contract `log` item. Extra fields (logId/source/platform/
+ * metadata) ride on the `.passthrough()` LogItem schema — no contract change. The message is
+ * safe-serialized then scrubbed for obvious PII (same scrub as F-ERR).
+ */
+export declare function toLogItem(method: ConsoleMethod, args: unknown[], droppedSince?: number): LogItem;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/features/console/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/features/console/normalize.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAE9F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAIlD,mCAAmC;AACnC,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAExE,6DAA6D;AAC7D,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,QAAQ,CAaxD;AAUD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,YAAY,SAAI,GAAG,OAAO,CA2B3F"}

package/dist/features/console/normalize.js

@@ -0,0 +1,64 @@
+/** Builds a contract `log` Item from a console call. Pure — shared by the wrapper + tests. */
+import { uuid, now, scrubText } from '../../core';
+import { safeSerialize, firstErrorStack } from './serialize';
+/**
+ * Map a console method → contract level. The contract has no `log` level, so `console.log` collapses
+ * to `info` (the conventional mapping); the literal method is preserved in `metadata.method`.
+ */
+export function levelFor(method) {
+    switch (method) {
+        case 'debug':
+            return 'debug';
+        case 'warn':
+            return 'warn';
+        case 'error':
+            return 'error';
+        case 'info':
+        case 'log':
+        default:
+            return 'info';
+    }
+}
+const currentScreen = () => {
+    try {
+        return typeof location !== 'undefined' ? location.pathname : undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * Normalize one console call into a contract `log` item. Extra fields (logId/source/platform/
+ * metadata) ride on the `.passthrough()` LogItem schema — no contract change. The message is
+ * safe-serialized then scrubbed for obvious PII (same scrub as F-ERR).
+ */
+export function toLogItem(method, args, droppedSince = 0) {
+    const level = levelFor(method);
+    const message = scrubText(safeSerialize(args));
+    const metadata = { method };
+    const screen = currentScreen();
+    if (screen)
+        metadata.screen = screen;
+    // Keep the stack for warn/error console calls that were passed an Error.
+    if (level === 'warn' || level === 'error') {
+        const stack = firstErrorStack(args);
+        if (stack)
+            metadata.stack = scrubText(stack);
+    }
+    // "No silent caps": carry the throttle count INSIDE metadata so it survives the backend mapLogs
+    // (which forwards `metadata` but not arbitrary top-level fields) and reaches the dashboard.
+    if (droppedSince > 0)
+        metadata.droppedSince = droppedSince;
+    return {
+        kind: 'log',
+        level,
+        message,
+        source: 'console',
+        platform: 'js',
+        // Stable id for idempotent retries → LogEntry.logId (@unique + skipDuplicates).
+        logId: `log_${uuid()}`,
+        metadata,
+        timestamp: now(),
+    };
+}
+//# sourceMappingURL=normalize.js.map

package/dist/features/console/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../../src/features/console/normalize.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAG9F,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAQ7D;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAqB;IAC5C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,MAAM,CAAC;QACZ,KAAK,KAAK,CAAC;QACX;YACE,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC;AAED,MAAM,aAAa,GAAG,GAAuB,EAAE;IAC7C,IAAI,CAAC;QACH,OAAO,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,MAAqB,EAAE,IAAe,EAAE,YAAY,GAAG,CAAC;IAChF,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAG,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAE/C,MAAM,QAAQ,GAA4B,EAAE,MAAM,EAAE,CAAC;IACrD,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,IAAI,MAAM;QAAE,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC;IACrC,yEAAyE;IACzE,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,KAAK;YAAE,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IACD,gGAAgG;IAChG,4FAA4F;IAC5F,IAAI,YAAY,GAAG,CAAC;QAAE,QAAQ,CAAC,YAAY,GAAG,YAAY,CAAC;IAE3D,OAAO;QACL,IAAI,EAAE,KAAK;QACX,KAAK;QACL,OAAO;QACP,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,IAAI;QACd,gFAAgF;QAChF,KAAK,EAAE,OAAO,IAAI,EAAE,EAAE;QACtB,QAAQ;QACR,SAAS,EAAE,GAAG,EAAE;KACN,CAAC;AACf,CAAC"}

package/dist/features/console/serialize.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Safe serialization of console arguments → one human-readable string.
+ *
+ * console.* takes `...args: unknown[]` (strings, objects, Errors, DOM nodes, circular graphs).
+ * We must never throw and never serialize an unbounded graph, so every arg is rendered with a
+ * `seen` guard (circular → "[Circular]"), a depth cap, a breadth cap, and a total length cap.
+ * This is the heart of the console feature — kept pure + dependency-free so it's unit-testable.
+ */
+export interface SerializeOptions {
+    /** Max object/array nesting before collapsing to "[Object]"/"[Array]". */
+    maxDepth?: number;
+    /** Max keys (objects) / items (arrays) rendered before a "…(+N more)" marker. */
+    maxBreadth?: number;
+    /** Hard cap on the final message length (protects payloads from huge graphs). */
+    maxLength?: number;
+}
+/**
+ * Serialize console args into a single message string. Strings join with spaces (console-like);
+ * the result is length-capped. Never throws — any unexpected failure degrades to a placeholder.
+ */
+export declare function safeSerialize(args: unknown[], options?: SerializeOptions): string;
+/** Extract a short stack from an Error arg, if any (for metadata on warn/error logs). */
+export declare function firstErrorStack(args: unknown[]): string | undefined;
+//# sourceMappingURL=serialize.d.ts.map

package/dist/features/console/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../../src/features/console/serialize.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAoED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAUjF;AAED,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,GAAG,SAAS,CAKnE"}

package/dist/features/console/serialize.js

@@ -0,0 +1,99 @@
+/**
+ * Safe serialization of console arguments → one human-readable string.
+ *
+ * console.* takes `...args: unknown[]` (strings, objects, Errors, DOM nodes, circular graphs).
+ * We must never throw and never serialize an unbounded graph, so every arg is rendered with a
+ * `seen` guard (circular → "[Circular]"), a depth cap, a breadth cap, and a total length cap.
+ * This is the heart of the console feature — kept pure + dependency-free so it's unit-testable.
+ */
+const DEFAULTS = {
+    maxDepth: 4,
+    maxBreadth: 50,
+    maxLength: 8 * 1024,
+};
+/** Render a single value to a compact string, circular- and depth-safe. */
+function renderValue(value, depth, seen, opts) {
+    if (value === null)
+        return 'null';
+    if (value === undefined)
+        return 'undefined';
+    const t = typeof value;
+    if (t === 'string')
+        return value;
+    if (t === 'number' || t === 'boolean' || t === 'bigint')
+        return String(value);
+    if (t === 'symbol')
+        return value.toString();
+    if (t === 'function') {
+        const name = value.name;
+        return `[Function${name ? `: ${name}` : ''}]`;
+    }
+    // From here on `value` is an object.
+    const obj = value;
+    if (seen.has(obj))
+        return '[Circular]';
+    // Errors — show name + message (stack rides separately via metadata when relevant).
+    if (value instanceof Error) {
+        return `${value.name}: ${value.message}`;
+    }
+    if (depth >= opts.maxDepth) {
+        return Array.isArray(value) ? '[Array]' : '[Object]';
+    }
+    seen.add(obj);
+    try {
+        if (Array.isArray(value)) {
+            const shown = value.slice(0, opts.maxBreadth).map((v) => renderValue(v, depth + 1, seen, opts));
+            const extra = value.length > opts.maxBreadth ? `, …(+${value.length - opts.maxBreadth} more)` : '';
+            return `[${shown.join(', ')}${extra}]`;
+        }
+        // Map / Set get a friendly summary rather than "{}".
+        if (value instanceof Map)
+            return `Map(${value.size})`;
+        if (value instanceof Set)
+            return `Set(${value.size})`;
+        // DOM-ish nodes (jsdom + browser) — avoid walking the whole tree.
+        const nodeName = value.nodeName;
+        if (typeof nodeName === 'string') {
+            const id = value.id;
+            return `<${nodeName.toLowerCase()}${id ? ` #${String(id)}` : ''}>`;
+        }
+        const keys = Object.keys(value);
+        const shownKeys = keys.slice(0, opts.maxBreadth);
+        const parts = shownKeys.map((k) => {
+            const rendered = renderValue(value[k], depth + 1, seen, opts);
+            return `${k}: ${rendered}`;
+        });
+        const extra = keys.length > opts.maxBreadth ? `, …(+${keys.length - opts.maxBreadth} more)` : '';
+        return `{${parts.join(', ')}${extra}}`;
+    }
+    finally {
+        // Allow the same object to appear again in a sibling branch (only blocks true cycles).
+        seen.delete(obj);
+    }
+}
+/**
+ * Serialize console args into a single message string. Strings join with spaces (console-like);
+ * the result is length-capped. Never throws — any unexpected failure degrades to a placeholder.
+ */
+export function safeSerialize(args, options) {
+    const opts = { ...DEFAULTS, ...options };
+    let out;
+    try {
+        out = args.map((a) => renderValue(a, 0, new WeakSet(), opts)).join(' ');
+    }
+    catch {
+        out = '[unserializable console arguments]';
+    }
+    if (out.length > opts.maxLength)
+        out = out.slice(0, opts.maxLength) + '…(truncated)';
+    return out;
+}
+/** Extract a short stack from an Error arg, if any (for metadata on warn/error logs). */
+export function firstErrorStack(args) {
+    for (const a of args) {
+        if (a instanceof Error && a.stack)
+            return a.stack.slice(0, 4 * 1024);
+    }
+    return undefined;
+}
+//# sourceMappingURL=serialize.js.map

package/dist/features/console/serialize.js.map

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

package/dist/features/console/throttle.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Noise control for console capture. A `console.log` in a render loop floods exactly like an error
+ * loop, so we mirror F-ERR's anti-flood approach (errors/dedup.ts): a hard per-window rate cap that
+ * counts what it drops (no silent caps). The one difference: it's LEVEL-AWARE — `warn`/`error` are
+ * the debugging-valuable lines and are ALWAYS kept; only chatty `info`/`debug` get sampled + capped.
+ */
+import type { LogLevel } from './normalize';
+export interface LogThrottleOptions {
+    /** Hard cap on sampled (info/debug) logs accepted per `capWindowMs`. */
+    capCount?: number;
+    capWindowMs?: number;
+}
+export declare class LogThrottle {
+    private readonly capCount;
+    private readonly capWindowMs;
+    private recent;
+    private dropped;
+    constructor(opts?: LogThrottleOptions);
+    /**
+     * True if this log should be emitted. `warn`/`error` always pass; `info`/`debug` are subject to
+     * the rolling rate cap. Drops are counted (ride along on the next emitted item).
+     */
+    accept(level: LogLevel): boolean;
+    /** Read + reset the dropped counter (rides along on the next emitted item). */
+    takeDropped(): number;
+}
+//# sourceMappingURL=throttle.d.ts.map

package/dist/features/console/throttle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../../src/features/console/throttle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAAK;gBAER,IAAI,CAAC,EAAE,kBAAkB;IAKrC;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IAahC,+EAA+E;IAC/E,WAAW,IAAI,MAAM;CAKtB"}

package/dist/features/console/throttle.js

@@ -0,0 +1,37 @@
+/**
+ * Noise control for console capture. A `console.log` in a render loop floods exactly like an error
+ * loop, so we mirror F-ERR's anti-flood approach (errors/dedup.ts): a hard per-window rate cap that
+ * counts what it drops (no silent caps). The one difference: it's LEVEL-AWARE — `warn`/`error` are
+ * the debugging-valuable lines and are ALWAYS kept; only chatty `info`/`debug` get sampled + capped.
+ */
+export class LogThrottle {
+    constructor(opts) {
+        this.recent = [];
+        this.dropped = 0;
+        this.capCount = opts?.capCount ?? 100;
+        this.capWindowMs = opts?.capWindowMs ?? 10000;
+    }
+    /**
+     * True if this log should be emitted. `warn`/`error` always pass; `info`/`debug` are subject to
+     * the rolling rate cap. Drops are counted (ride along on the next emitted item).
+     */
+    accept(level) {
+        if (level === 'warn' || level === 'error')
+            return true;
+        const t = Date.now();
+        this.recent = this.recent.filter((ts) => t - ts < this.capWindowMs);
+        if (this.recent.length >= this.capCount) {
+            this.dropped++;
+            return false;
+        }
+        this.recent.push(t);
+        return true;
+    }
+    /** Read + reset the dropped counter (rides along on the next emitted item). */
+    takeDropped() {
+        const d = this.dropped;
+        this.dropped = 0;
+        return d;
+    }
+}
+//# sourceMappingURL=throttle.js.map

package/dist/features/console/throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../../src/features/console/throttle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,MAAM,OAAO,WAAW;IAMtB,YAAY,IAAyB;QAH7B,WAAM,GAAa,EAAE,CAAC;QACtB,YAAO,GAAG,CAAC,CAAC;QAGlB,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,GAAG,CAAC;QACtC,IAAI,CAAC,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,KAAK,CAAC;IAChD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAe;QACpB,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QAEvD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;QACpE,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACxC,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+EAA+E;IAC/E,WAAW;QACT,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACjB,OAAO,CAAC,CAAC;IACX,CAAC;CACF"}