@scalebun/web 1.0.0

package/dist/features/crash/CrashFeature.d.ts

@@ -0,0 +1,46 @@
+/**
+ * F-CRASH — native-style crash detection for the web. Two complementary signals:
+ *
+ *  1. ReportingObserver — browser-generated `crash` (OOM/unresponsive) + `intervention` reports that
+ *     never surface via window.onerror. Emitted as contract `error` items (crash → type:'crash').
+ *  2. Session-liveness recovery — a per-tab marker (see liveness.ts) that, on the next load, detects a
+ *     prior session that died without a graceful `pagehide` (tab crash / OOM kill / forced close) and
+ *     emits a `type:'crash'` error referencing the dead session. This is the web analog of a native
+ *     crash, which is otherwise invisible (the page can't report its own hard death).
+ *
+ * Cheap + always-on. Deprecation reports are intentionally skipped (high-volume, low-signal).
+ */
+import type { IFeature, FeatureContext } from '@scalebun/sdk-contracts';
+export declare class CrashFeature implements IFeature {
+    readonly name = "crash";
+    private ctx;
+    private active;
+    private tabId;
+    private observer?;
+    private heartbeat?;
+    private onHide?;
+    private onShow?;
+    get isActive(): boolean;
+    setup(ctx: FeatureContext): void;
+    private installReportingObserver;
+    private handleReport;
+    private installLiveness;
+    /**
+     * Report the death of the PRIOR session — on that session, not on this one.
+     *
+     * The crash is discovered by the next load, so the only pipeline in existence belongs to a
+     * session that is perfectly healthy. Emitting normally filed the crash there: verified against
+     * real rows, 4 of 4 recovered crashes landed on a brand-new session at t≈0 (three of them a
+     * fraction of a second BEFORE that session's own recorded start), while the session that actually
+     * died stayed clean. Every first open after a hard kill therefore came up already crashed.
+     *
+     * `emitFor` files it against `prior.sessionId` instead. Without it (older bootstrap, mock ctx) the
+     * item still has to go somewhere, so it falls back to the live session as `handled` — recorded and
+     * searchable, but not a crash the current session did not have.
+     */
+    private emitRecoveredCrash;
+    private buildError;
+    private emitError;
+    teardown(): void;
+}
+//# sourceMappingURL=CrashFeature.d.ts.map

package/dist/features/crash/CrashFeature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CrashFeature.d.ts","sourceRoot":"","sources":["../../../src/features/crash/CrashFeature.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAkCxE,qBAAa,YAAa,YAAW,QAAQ;IAC3C,QAAQ,CAAC,IAAI,WAAW;IACxB,OAAO,CAAC,GAAG,CAA+B;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,QAAQ,CAAC,CAA0C;IAC3D,OAAO,CAAC,SAAS,CAAC,CAAiC;IACnD,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,OAAO,CAAC,MAAM,CAAC,CAAa;IAE5B,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAUhC,OAAO,CAAC,wBAAwB;IAgBhC,OAAO,CAAC,YAAY;IAqBpB,OAAO,CAAC,eAAe;IA8BvB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,kBAAkB;IA0B1B,OAAO,CAAC,UAAU;IAuBlB,OAAO,CAAC,SAAS;IAIjB,QAAQ,IAAI,IAAI;CAmBjB"}

package/dist/features/crash/CrashFeature.js

@@ -0,0 +1,173 @@
+import { uuid, now, scrubText } from '../../core';
+import { getTabId, readRecord, writeRecord, markEnded, touch, cleanupStale, } from './liveness';
+const HEARTBEAT_MS = 15000;
+export class CrashFeature {
+    constructor() {
+        this.name = 'crash';
+        this.ctx = null;
+        this.active = false;
+        this.tabId = '';
+    }
+    get isActive() {
+        return this.active;
+    }
+    setup(ctx) {
+        this.ctx = ctx;
+        if (typeof window === 'undefined')
+            return;
+        this.installReportingObserver();
+        this.installLiveness(ctx.sessionId ?? `sess_${uuid()}`);
+        this.active = true;
+    }
+    // ── ReportingObserver ───────────────────────────────────────────────────────
+    installReportingObserver() {
+        const Ctor = globalThis.ReportingObserver;
+        if (!Ctor)
+            return;
+        try {
+            this.observer = new Ctor((reports) => {
+                for (const r of reports)
+                    this.handleReport(r);
+            }, { buffered: true });
+            this.observer.observe();
+        }
+        catch {
+            /* ReportingObserver unsupported / blocked — liveness recovery still works */
+        }
+    }
+    handleReport(r) {
+        if (r.type === 'deprecation')
+            return; // noisy + low-signal
+        const body = r.body ?? {};
+        const isCrash = r.type === 'crash';
+        const message = isCrash
+            ? `Browser crash report: ${body.reason ?? 'unknown'}`
+            : (body.message ?? `${r.type} report`);
+        const stack = body.sourceFile
+            ? `${body.sourceFile}:${body.lineNumber ?? 0}:${body.columnNumber ?? 0}`
+            : undefined;
+        this.emitError({
+            type: isCrash ? 'crash' : 'handled',
+            message,
+            stack,
+            fingerprint: `report:${r.type}:${body.reason ?? body.id ?? message}`.slice(0, 180),
+            metadata: { reportType: r.type, reason: body.reason, anticipated: body.anticipated, url: r.url },
+        });
+        if (isCrash)
+            this.ctx?.signal('error');
+    }
+    // ── Session-liveness recovery ─────────────────────────────────────────────────
+    installLiveness(sessionId) {
+        this.tabId = getTabId();
+        // Recover: a prior record for THIS tab that never ended = abnormal termination.
+        const prior = readRecord(this.tabId);
+        if (prior && !prior.ended && prior.sessionId !== sessionId) {
+            this.emitRecoveredCrash(prior);
+        }
+        // Stamp this session as live.
+        const t = now();
+        writeRecord(this.tabId, {
+            v: 1,
+            sessionId,
+            startedAt: t,
+            lastActive: t,
+            screen: currentScreen() ?? '',
+            ended: false,
+        });
+        cleanupStale(this.tabId, t);
+        // pagehide = the only reliable "graceful shutdown" hook → mark ended. A hard kill skips it,
+        // which is exactly the crash we detect next load. pageshow (bfcache restore) re-arms.
+        this.onHide = () => markEnded(this.tabId, true);
+        this.onShow = () => markEnded(this.tabId, false);
+        window.addEventListener('pagehide', this.onHide);
+        window.addEventListener('pageshow', this.onShow);
+        this.heartbeat = setInterval(() => touch(this.tabId), HEARTBEAT_MS);
+    }
+    /**
+     * Report the death of the PRIOR session — on that session, not on this one.
+     *
+     * The crash is discovered by the next load, so the only pipeline in existence belongs to a
+     * session that is perfectly healthy. Emitting normally filed the crash there: verified against
+     * real rows, 4 of 4 recovered crashes landed on a brand-new session at t≈0 (three of them a
+     * fraction of a second BEFORE that session's own recorded start), while the session that actually
+     * died stayed clean. Every first open after a hard kill therefore came up already crashed.
+     *
+     * `emitFor` files it against `prior.sessionId` instead. Without it (older bootstrap, mock ctx) the
+     * item still has to go somewhere, so it falls back to the live session as `handled` — recorded and
+     * searchable, but not a crash the current session did not have.
+     */
+    emitRecoveredCrash(prior) {
+        const durationMs = Math.max(0, prior.lastActive - prior.startedAt);
+        const item = this.buildError({
+            type: 'crash',
+            message: 'Session ended abnormally (tab crash, OOM, or forced close — no graceful shutdown)',
+            fingerprint: 'session-abnormal-termination',
+            screenName: prior.screen || undefined,
+            metadata: {
+                reason: 'unfinalized-session',
+                priorSessionId: prior.sessionId,
+                durationMs,
+                lastScreen: prior.screen,
+            },
+            // The death happened while the prior session was alive, not now. Stamping "now" is what put
+            // these errors a few hundred ms before the host session's own start.
+            timestamp: prior.lastActive,
+        });
+        if (this.ctx?.emitFor) {
+            this.ctx.emitFor(prior.sessionId, item);
+            return;
+        }
+        this.ctx?.emit({ ...item, type: 'handled' });
+        this.ctx?.signal('error');
+    }
+    buildError(p) {
+        return {
+            kind: 'error',
+            type: p.type,
+            message: scrubText(p.message),
+            stack: p.stack,
+            source: 'js',
+            fingerprint: p.fingerprint,
+            screenName: p.screenName ?? currentScreen(),
+            clientId: `crash_${uuid()}`,
+            timestamp: p.timestamp ?? now(),
+            ...(p.metadata ? { metadata: p.metadata } : {}),
+        };
+    }
+    emitError(p) {
+        this.ctx?.emit(this.buildError(p));
+    }
+    teardown() {
+        if (this.observer) {
+            try {
+                this.observer.disconnect();
+            }
+            catch {
+                /* ignore */
+            }
+            this.observer = undefined;
+        }
+        if (this.heartbeat)
+            clearInterval(this.heartbeat);
+        this.heartbeat = undefined;
+        if (typeof window !== 'undefined') {
+            if (this.onHide)
+                window.removeEventListener('pagehide', this.onHide);
+            if (this.onShow)
+                window.removeEventListener('pageshow', this.onShow);
+        }
+        // Teardown is a graceful stop (consent revoke / SDK stop) → not a crash.
+        if (this.tabId)
+            markEnded(this.tabId, true);
+        this.active = false;
+    }
+}
+function currentScreen() {
+    try {
+        return typeof location !== 'undefined' ? location.pathname : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=CrashFeature.js.map

package/dist/features/crash/CrashFeature.js.map

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

package/dist/features/crash/liveness.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Per-tab session-liveness marker for native-style crash detection on the web.
+ *
+ * Idea: a page that dies abnormally (renderer crash, OOM kill, forced close, power loss) never runs
+ * its `pagehide` shutdown, so it never marks the session `ended`. On the NEXT load in that tab we read
+ * the prior marker — if it's still `ended:false`, the previous session terminated abnormally → a
+ * crash-class signal (the web analog of a native crash).
+ *
+ * Multi-tab safety: the marker is keyed by a per-TAB id held in sessionStorage (survives reloads +
+ * crash-restore within the tab, distinct per tab), so two open tabs never see each other's live marker
+ * as a crash. localStorage holds the record so it survives the renderer dying.
+ */
+export interface LivenessRecord {
+    v: 1;
+    sessionId: string;
+    startedAt: number;
+    lastActive: number;
+    screen: string;
+    ended: boolean;
+}
+/** Stable id for THIS tab (sessionStorage → survives reload + crash-restore, unique per tab). */
+export declare function getTabId(): string;
+export declare function readRecord(tabId: string): LivenessRecord | null;
+export declare function writeRecord(tabId: string, rec: LivenessRecord): void;
+/** Mark the current tab's record ended (graceful shutdown) without a full rewrite when possible. */
+export declare function markEnded(tabId: string, ended: boolean): void;
+export declare function touch(tabId: string): void;
+/** Remove other tabs' clearly-abandoned records (old + ended) so localStorage doesn't accrete. */
+export declare function cleanupStale(exceptTabId: string, now: number): void;
+//# sourceMappingURL=liveness.d.ts.map

package/dist/features/crash/liveness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveness.d.ts","sourceRoot":"","sources":["../../../src/features/crash/liveness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,CAAC,CAAC;IACL,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AAgCD,iGAAiG;AACjG,wBAAgB,QAAQ,IAAI,MAAM,CAYjC;AAID,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAW/D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAQpE;AAED,oGAAoG;AACpG,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAM7D;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAKzC;AAED,kGAAkG;AAClG,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAmBnE"}

package/dist/features/crash/liveness.js

@@ -0,0 +1,131 @@
+/**
+ * Per-tab session-liveness marker for native-style crash detection on the web.
+ *
+ * Idea: a page that dies abnormally (renderer crash, OOM kill, forced close, power loss) never runs
+ * its `pagehide` shutdown, so it never marks the session `ended`. On the NEXT load in that tab we read
+ * the prior marker — if it's still `ended:false`, the previous session terminated abnormally → a
+ * crash-class signal (the web analog of a native crash).
+ *
+ * Multi-tab safety: the marker is keyed by a per-TAB id held in sessionStorage (survives reloads +
+ * crash-restore within the tab, distinct per tab), so two open tabs never see each other's live marker
+ * as a crash. localStorage holds the record so it survives the renderer dying.
+ */
+const TAB_KEY = 'scalebun:tab';
+const REC_PREFIX = 'scalebun:live:';
+/** Other-tab records older than this are abandoned junk → cleaned up (not reported, to avoid FPs). */
+const STALE_MS = 24 * 60 * 60 * 1000;
+function ls() {
+    try {
+        return typeof localStorage !== 'undefined' ? localStorage : null;
+    }
+    catch {
+        return null;
+    }
+}
+function ss() {
+    try {
+        return typeof sessionStorage !== 'undefined' ? sessionStorage : null;
+    }
+    catch {
+        return null;
+    }
+}
+function rand() {
+    try {
+        const c = globalThis.crypto;
+        if (c && typeof c.randomUUID === 'function')
+            return c.randomUUID();
+    }
+    catch {
+        /* fall through */
+    }
+    return `${Date.now().toString(36)}-${Math.floor(Math.random() * 1e9).toString(36)}`;
+}
+/** Stable id for THIS tab (sessionStorage → survives reload + crash-restore, unique per tab). */
+export function getTabId() {
+    const store = ss();
+    if (!store)
+        return `mem-${rand()}`; // no sessionStorage → degrade to a per-load id (no recovery)
+    try {
+        const existing = store.getItem(TAB_KEY);
+        if (existing)
+            return existing;
+        const id = rand();
+        store.setItem(TAB_KEY, id);
+        return id;
+    }
+    catch {
+        return `mem-${rand()}`;
+    }
+}
+const keyFor = (tabId) => `${REC_PREFIX}${tabId}`;
+export function readRecord(tabId) {
+    const store = ls();
+    if (!store)
+        return null;
+    try {
+        const raw = store.getItem(keyFor(tabId));
+        if (!raw)
+            return null;
+        const r = JSON.parse(raw);
+        return r && r.v === 1 && typeof r.sessionId === 'string' ? r : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function writeRecord(tabId, rec) {
+    const store = ls();
+    if (!store)
+        return;
+    try {
+        store.setItem(keyFor(tabId), JSON.stringify(rec));
+    }
+    catch {
+        /* quota / disabled — liveness is best-effort */
+    }
+}
+/** Mark the current tab's record ended (graceful shutdown) without a full rewrite when possible. */
+export function markEnded(tabId, ended) {
+    const rec = readRecord(tabId);
+    if (!rec)
+        return;
+    rec.ended = ended;
+    rec.lastActive = Date.now();
+    writeRecord(tabId, rec);
+}
+export function touch(tabId) {
+    const rec = readRecord(tabId);
+    if (!rec)
+        return;
+    rec.lastActive = Date.now();
+    writeRecord(tabId, rec);
+}
+/** Remove other tabs' clearly-abandoned records (old + ended) so localStorage doesn't accrete. */
+export function cleanupStale(exceptTabId, now) {
+    const store = ls();
+    if (!store)
+        return;
+    try {
+        const doomed = [];
+        for (let i = 0; i < store.length; i++) {
+            const k = store.key(i);
+            if (!k || !k.startsWith(REC_PREFIX) || k === keyFor(exceptTabId))
+                continue;
+            try {
+                const r = JSON.parse(store.getItem(k) || '{}');
+                if (r && (r.ended || now - (r.lastActive || 0) > STALE_MS))
+                    doomed.push(k);
+            }
+            catch {
+                doomed.push(k); // unparseable → remove
+            }
+        }
+        for (const k of doomed)
+            store.removeItem(k);
+    }
+    catch {
+        /* best-effort */
+    }
+}
+//# sourceMappingURL=liveness.js.map

package/dist/features/crash/liveness.js.map

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

package/dist/features/engage/EngageFeature.d.ts

@@ -0,0 +1,61 @@
+/**
+ * F-ENG — Engage (surveys / NPS / in-app). Core shell: fetch the active campaign config from
+ * /sdk/engage/config and, only if a campaign exists, LAZY-load the runtime (trigger engine + throttle +
+ * DOM widget) so the heavy bits stay out of core. Triggers are fed from existing producers — capture
+ * signals (rage/dead/error/network_error/slow_screen), navigation, track()/purchase custom events, and
+ * session lifecycle — no parallel pipeline.
+ *
+ * E1 — cold-start buffer: triggers that arrive while the first config fetch is still in flight (and
+ * before the runtime lazy-loads) are buffered in a bounded TTL ring and replayed once the runtime arms,
+ * honouring each campaign's REMAINING delay — so a "show on session #1 / app_open" campaign isn't lost.
+ */
+import type { IFeature, FeatureContext } from '@scalebun/sdk-contracts';
+import type { LifecycleKind } from './triggerEngine';
+export declare class EngageFeature implements IFeature {
+    readonly name = "engage";
+    private ctx;
+    private active;
+    private transport?;
+    private runtime?;
+    private unsub?;
+    private onPop?;
+    private screen;
+    private buffer;
+    private bufferOpen;
+    get isActive(): boolean;
+    setup(ctx: FeatureContext): Promise<void>;
+    /** Fetch engage config; lazy-load + (re)arm the runtime when campaigns are present, then drain the
+     *  cold-start buffer. The heavy normalizer + matcher stay in the lazy chunk — core does only a shallow
+     *  presence check (an empty config is the common case and must cost ~nothing). */
+    refresh(): Promise<void>;
+    /** Lazy-load + construct the runtime on first need (config load, or a programmatic
+     *  emitRatingEvent/submit). Returns undefined only before setup / without a transport. */
+    private ensureRuntime;
+    /** Programmatic submit for a host's own survey UI → 'success'|'error' (transport-retried). */
+    submit(surveyId: string, result: import('./types').SurveyResult): Promise<'success' | 'error'>;
+    /** Emit one rating-funnel event (works even without a served campaign). */
+    emitRatingEvent(type: import('./types').RatingEventType, input?: import('./types').RatingEventInput): void;
+    /** Dev/QA — clear on-device engage state (throttle/session/test-seen) so campaigns show again. */
+    resetInAppState(): Promise<void>;
+    onScreenView(screen: string): void;
+    /**
+     * Identity changed (the host called identify()) — re-fetch config.
+     *
+     * The boot fetch is normally anonymous and the backend serves NO segment-targeted campaign to an
+     * anonymous request (it fails closed), so without this a visitor who logs in mid-session would see
+     * none of their targeted surveys or messages until a full page load.
+     */
+    onIdentify(): void;
+    onCustomEvent(name: string): void;
+    onSignal(reason: string): void;
+    onLifecycle(kind: LifecycleKind, count?: number): void;
+    private feed;
+    private dispatch;
+    /** Replay the cold-start buffer into the armed runtime, honouring each entry's remaining delay. */
+    private drain;
+    private closeBuffer;
+    /** Running session number, persisted across launches; bumped exactly once per new session. */
+    private bumpSessionCount;
+    teardown(): void;
+}
+//# sourceMappingURL=EngageFeature.d.ts.map

package/dist/features/engage/EngageFeature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EngageFeature.d.ts","sourceRoot":"","sources":["../../../src/features/engage/EngageFeature.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAIxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AA6BrD,qBAAa,aAAc,YAAW,QAAQ;IAC5C,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,GAAG,CAA+B;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAC,CAAkB;IACpC,OAAO,CAAC,OAAO,CAAC,CAAgB;IAChC,OAAO,CAAC,KAAK,CAAC,CAAa;IAC3B,OAAO,CAAC,KAAK,CAAC,CAAa;IAC3B,OAAO,CAAC,MAAM,CAAM;IAEpB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAAQ;IAE1B,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAEK,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC/C;;sFAEkF;IAC5E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB9B;8FAC0F;YAC5E,aAAa;IAoB3B,8FAA8F;IACxF,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC;IAIpG,2EAA2E;IAC3E,eAAe,CAAC,IAAI,EAAE,OAAO,SAAS,EAAE,eAAe,EAAE,KAAK,CAAC,EAAE,OAAO,SAAS,EAAE,gBAAgB,GAAG,IAAI;IAG1G,kGAAkG;IAC5F,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIlC;;;;;;OAMG;IACH,UAAU,IAAI,IAAI;IAIlB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAGjC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAG9B,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAItD,OAAO,CAAC,IAAI;IAUZ,OAAO,CAAC,QAAQ;IAShB,mGAAmG;IACnG,OAAO,CAAC,KAAK;IASb,OAAO,CAAC,WAAW;IAKnB,8FAA8F;IAC9F,OAAO,CAAC,gBAAgB;IAcxB,QAAQ,IAAI,IAAI;CAUjB"}