@scalebun/web 1.0.0

package/dist/features/engage/normalize.js

@@ -0,0 +1,203 @@
+// ── coercion primitives ───────────────────────────────────────────────────────
+const rec = (v) => v && typeof v === 'object' && !Array.isArray(v) ? v : {};
+const arr = (v) => (Array.isArray(v) ? v : []);
+const str = (v) => (typeof v === 'string' ? v : undefined);
+const numOpt = (v) => (typeof v === 'number' && Number.isFinite(v) ? v : undefined);
+const boolOpt = (v) => (typeof v === 'boolean' ? v : undefined);
+const strArr = (v) => {
+    if (!Array.isArray(v))
+        return undefined;
+    const a = v.filter((x) => typeof x === 'string');
+    return a.length ? a : undefined;
+};
+/** Drop `undefined` values so optional fields stay truly absent (clean objects, exact-optional-safe). */
+const compact = (o) => {
+    for (const k of Object.keys(o))
+        if (o[k] === undefined)
+            delete o[k];
+    return o;
+};
+const LAYOUTS = ['modal', 'fullscreen', 'bottom_sheet', 'top_banner', 'bottom_banner', 'tooltip', 'toast'];
+const CTA_ACTIONS = new Set(['dismiss', 'link', 'custom']);
+const QUESTION_KINDS = new Set(['scale', 'text', 'single', 'multi', 'emoji', 'boolean', 'screenshot', 'voice']);
+// ── sub-shape mappers ─────────────────────────────────────────────────────────
+function throttle(v) {
+    const r = rec(v);
+    const t = compact({
+        showOnce: boolOpt(r.showOnce),
+        cooldownHours: numOpt(r.cooldownHours),
+        maxImpressions: numOpt(r.maxImpressions),
+        samplePct: numOpt(r.samplePct),
+    });
+    return Object.keys(t).length ? t : undefined;
+}
+function triggerConfig(v) {
+    const r = rec(v);
+    const t = compact({
+        event: str(r.event),
+        action: str(r.action),
+        seconds: numOpt(r.seconds),
+        sessions: numOpt(r.sessions),
+        slowMs: numOpt(r.slowMs),
+        screen: str(r.screen),
+        delaySeconds: numOpt(r.delaySeconds),
+    });
+    return Object.keys(t).length ? t : undefined;
+}
+function targeting(v) {
+    const r = rec(v);
+    const t = compact({
+        platforms: strArr(r.platforms),
+        minAppVersion: str(r.minAppVersion),
+        segments: strArr(r.segments),
+        userProps: r.userProps && typeof r.userProps === 'object' && !Array.isArray(r.userProps) ? r.userProps : undefined,
+    });
+    return Object.keys(t).length ? t : undefined;
+}
+function questions(v) {
+    const out = [];
+    for (const raw of arr(v)) {
+        const r = rec(raw);
+        const key = str(r.key);
+        const kind = str(r.kind);
+        if (!key || !kind || !QUESTION_KINDS.has(kind))
+            continue; // malformed question → drop
+        // Wire serves per-question text as `prompt` (backend + RN); fall back to `label` for older shapes.
+        /**
+         * `required` and `pageBreakBefore` must be carried through explicitly.
+         *
+         * `compact` drops undefined, and these two were simply never read here — so the widget saw every
+         * question as `required: undefined` (which it treats as required, matching its historical
+         * behaviour) and saw no page breaks at all. The visible symptoms: an OPTIONAL question still
+         * blocked Next, and an authored page break did nothing. Both were authored correctly, stored
+         * correctly and served correctly; they died at this boundary.
+         *
+         * `required` is read as a strict boolean so an explicit `false` survives — treating it like the
+         * other optionals and dropping falsy values would recreate exactly the bug being fixed.
+         */
+        out.push(compact({
+            key,
+            kind,
+            label: str(r.prompt) ?? str(r.label),
+            choices: strArr(r.choices),
+            scaleMax: numOpt(r.scaleMax),
+            required: typeof r.required === 'boolean' ? r.required : undefined,
+            pageBreakBefore: r.pageBreakBefore === true ? true : undefined,
+        }));
+    }
+    return out.length ? out : undefined;
+}
+function cta(v) {
+    const r = rec(v);
+    const label = str(r.label);
+    const action = str(r.action);
+    if (!label || !action || !CTA_ACTIONS.has(action))
+        return undefined;
+    return compact({ label, action: action, deepLink: str(r.deepLink) });
+}
+function renderSpec(v) {
+    const r = rec(v);
+    const body = str(r.body);
+    if (!body)
+        return null; // a message with no body is unrenderable → drop the message
+    const secondary = rec(r.secondaryCta);
+    const style = r.style && typeof r.style === 'object' && !Array.isArray(r.style) ? r.style : undefined;
+    const ext = r.ext && typeof r.ext === 'object' && !Array.isArray(r.ext) ? r.ext : undefined;
+    return compact({
+        title: str(r.title),
+        body,
+        imageUrl: str(r.imageUrl),
+        cta: cta(r.cta),
+        secondaryCta: str(secondary.label) ? { label: str(secondary.label), action: 'dismiss' } : undefined,
+        dark: boolOpt(r.dark),
+        rtl: boolOpt(r.rtl),
+        coupon: str(r.coupon),
+        style,
+        ext,
+    });
+}
+function experiment(v) {
+    const r = rec(v);
+    if (!('enabled' in r) && !('variantB' in r) && !('split' in r))
+        return undefined;
+    const vb = renderSpec(r.variantB);
+    return compact({ enabled: boolOpt(r.enabled), split: numOpt(r.split), variantB: vb ?? undefined });
+}
+// ── top-level row mappers (return null ⇒ drop the row, never throw) ────────────
+function campaign(raw) {
+    const r = rec(raw);
+    const id = str(r.id);
+    const type = str(r.type);
+    if (!id || !type)
+        return null;
+    return compact({
+        id,
+        type,
+        name: str(r.name) ?? id,
+        question: str(r.question) ?? '',
+        questions: questions(r.questions),
+        scale: numOpt(r.scale),
+        trigger: str(r.trigger),
+        targetScreen: str(r.targetScreen),
+        triggerConfig: triggerConfig(r.triggerConfig),
+        targeting: targeting(r.targeting),
+        throttle: throttle(r.throttle),
+        enabled: boolOpt(r.enabled) ?? true,
+        revision: str(r.revision),
+        /**
+         * `style` was missing here, so every campaign theme the server sent was discarded at the
+         * boundary and the widget always fell back to its built-in colours — the authored accent never
+         * reached the DOM regardless of what was stored or served. Object-shaped only; the widget
+         * re-validates every VALUE against a colour grammar before it touches CSS.
+         */
+        style: r.style && typeof r.style === 'object' && !Array.isArray(r.style)
+            ? r.style
+            : undefined,
+        startScreen: str(r.startScreen),
+        thankYouScreen: str(r.thankYouScreen),
+    });
+}
+function inApp(raw) {
+    const r = rec(raw);
+    const id = str(r.id);
+    const spec = renderSpec(r.spec);
+    if (!id || !spec)
+        return null;
+    const layout = str(r.layout);
+    return compact({
+        id,
+        layout: layout && LAYOUTS.includes(layout) ? layout : 'modal',
+        trigger: str(r.trigger),
+        delaySeconds: numOpt(r.delaySeconds),
+        targetScreen: str(r.targetScreen),
+        triggerConfig: triggerConfig(r.triggerConfig),
+        targeting: targeting(r.targeting),
+        throttle: throttle(r.throttle),
+        spec,
+        revision: str(r.revision),
+        experiment: experiment(r.experiment),
+        variantId: str(r.variantId),
+        variantKey: str(r.variantKey),
+        preview: boolOpt(r.preview),
+        previewId: str(r.previewId),
+        isTest: boolOpt(r.isTest),
+        testRunId: str(r.testRunId),
+        createdAt: str(r.createdAt),
+    });
+}
+/** Coerce the raw `/sdk/engage/config` JSON into a typed, safe `EngageConfigResponse`. Never throws;
+ *  malformed campaigns/messages are dropped; missing arrays become []. */
+export function normalizeConfig(raw) {
+    const r = rec(raw);
+    return {
+        configVersion: numOpt(r.configVersion) ?? 0,
+        serverTime: str(r.serverTime) ?? new Date().toISOString(),
+        campaigns: arr(r.campaigns)
+            .map(campaign)
+            .filter((c) => c !== null),
+        inAppMessages: arr(r.inAppMessages)
+            .map(inApp)
+            .filter((m) => m !== null),
+    };
+}
+//# sourceMappingURL=normalize.js.map

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

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

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

@@ -0,0 +1,64 @@
+/**
+ * WEB-ONLY bridge: render an engage in-app campaign that uses a RICH mechanic variant (spin wheel,
+ * scratch, slot, carousel, countdown, confetti, QR, video-commerce, poll, checklist) through the
+ * IAM 2.0 renderer, which supports these mechanic blocks. The legacy engage widget (InAppWidget)
+ * only draws the 7 basic layouts + title/body/image/coupon/CTA, so a spin-wheel campaign rendered
+ * as it does today comes out as a plain modal with no wheel. This bridge fixes that WITHOUT changing
+ * plain-layout campaigns (they keep using the widget) and without touching the mobile SDK (separate
+ * repo). The IAM 2.0 render code is dynamic-imported so it stays out of the eager bundle.
+ *
+ * The mechanic mapping mirrors the dashboard preview's webPreviewVariant.ts (archetype → block), so
+ * what the author previews is what the SDK now ships.
+ */
+import type { Variant } from '../inapp/types';
+import type { InAppMessage, InAppRenderSpec } from './types';
+import type { InAppGameRequestHandler } from './gameTypes';
+/** Why a message did not take the rich path — reported rather than swallowed (C4). */
+export interface RichDegrade {
+    variantKey?: string;
+    /** `unmapped` = no archetype from either source · `unrenderable` = archetype this SDK can't build. */
+    reason: 'unmapped' | 'unrenderable';
+    archetype?: string;
+}
+type DegradeListener = (d: RichDegrade) => void;
+/**
+ * Observe rich-render fall-throughs.
+ *
+ * C4 requires that an unmapped variantKey "degrades to the widget AND reports it". Previously it
+ * degraded in total silence, which is indistinguishable from working — the same failure mode as a
+ * wheel that always lands on segment 0.
+ */
+export declare function onRichDegrade(fn: DegradeListener | null): void;
+export declare function setInAppGameHandler(fn: InAppGameRequestHandler | null): void;
+/**
+ * Resolve the render archetype for a message.
+ *
+ * Order is deliberate: the SERVED archetype wins, because the backend resolved it from the
+ * canonical registry — the single source the dashboard preview also reads. The local map is only
+ * consulted for payloads served before the backend started stamping it.
+ */
+export declare function richArchetype(variantKey?: string, servedArchetype?: string): string | null;
+/**
+ * Does this engage message use a rich mechanic variant the basic widget can't render?
+ *
+ * Reports the two distinct fall-through reasons instead of returning a bare false: a CONTAINER
+ * archetype (modal/banner/…) legitimately belongs to the widget, whereas a mechanic archetype this
+ * SDK doesn't know is a version gap the host should be able to see.
+ */
+export declare function isRichInApp(m: InAppMessage, resolvedSpec?: InAppRenderSpec): boolean;
+/** Build an IAM 2.0 Variant from an engage rich-variant message + its (A/B-resolved) spec. */
+export declare function engageMessageToVariant(m: InAppMessage, spec: InAppRenderSpec): Variant;
+export interface RichHandle {
+    close(): void;
+}
+/**
+ * Render a rich variant through the IAM 2.0 renderer. The render system is dynamic-imported (kept
+ * out of the eager bundle), rendered into its own ShadowHost, and torn down on close. CTA/dismiss
+ * are wired back to the caller's beacons so analytics is identical to the widget path.
+ */
+export declare function renderRichInApp(m: InAppMessage, spec: InAppRenderSpec, cb: {
+    onClick(): void;
+    onDismiss(): void;
+}): Promise<RichHandle>;
+export {};
+//# sourceMappingURL=richInApp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"richInApp.d.ts","sourceRoot":"","sources":["../../../src/features/engage/richInApp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAyC,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAErF,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAK7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAmF3D,sFAAsF;AACtF,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sGAAsG;IACtG,MAAM,EAAE,UAAU,GAAG,cAAc,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,KAAK,eAAe,GAAG,CAAC,CAAC,EAAE,WAAW,KAAK,IAAI,CAAC;AAGhD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI,CAE9D;AAWD,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,uBAAuB,GAAG,IAAI,GAAG,IAAI,CAE5E;AAMD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI1F;AAQD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,eAAe,GAAG,OAAO,CAgBpF;AAsqBD,8FAA8F;AAC9F,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CA2EtF;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,IAAI,IAAI,CAAC;CACf;AAiFD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,CAAC,EAAE,YAAY,EACf,IAAI,EAAE,eAAe,EACrB,EAAE,EAAE;IAAE,OAAO,IAAI,IAAI,CAAC;IAAC,SAAS,IAAI,IAAI,CAAA;CAAE,GACzC,OAAO,CAAC,UAAU,CAAC,CA4FrB"}