@apex-inc/sdk 0.20.1 → 0.21.0

package/dist/esm/index.js

@@ -381,6 +381,22 @@ function getExperimentPreview(search) {
     const resolved = search ?? (isBrowser ? window.location.search : "");
     return readExperimentPreview(resolved);
 }
+async function fetchExperimentLineIds(apiBase, experimentId, workspaceKey) {
+    try {
+        const res = await fetch(`${apiBase}/api/experiments/${experimentId}/line?source=sdk`, {
+            credentials: "include",
+            headers: workspaceKey ? { "x-apex-workspace": workspaceKey } : {},
+        });
+        if (!res.ok)
+            return null;
+        const body = (await res.json());
+        const ids = body.data?.lineMemberIds ?? body.lineMemberIds;
+        return Array.isArray(ids) && ids.length > 0 ? ids : null;
+    }
+    catch {
+        return null;
+    }
+}
 // DBS-1 — durable browser session id (`apex_sid`), GA4-parity 30-min
 // inactivity rotation. Mirrors the snippet's cookie format
 // (`<id>.<startedAtMs>.<lastActivityMs>.<sessionNumber>.<utmSig>`) so a page
@@ -540,12 +556,19 @@ export async function getVariant(experimentId, opts = {}) {
     const buildId = opts.buildId ?? config?.buildId;
     // 1. Preview mode — author previewing, not a real exposure. Runs
     // before the browser/consent gates so SSR and a declined cookie
-    // banner still show the URL arm.
+    // banner still show the URL arm. A family member's `_apex_exp`
+    // applies once we know the line.
     const preview = getExperimentPreview(opts.search);
-    if (preview && (!preview.expId || preview.expId === experimentId)) {
-        return preview.variant;
-    }
-    if (preview?.expId && preview.expId !== experimentId) {
+    if (preview) {
+        const lineIds = opts.lineMemberIds ??
+            (isBrowser && preview.expId && preview.expId !== experimentId
+                ? await fetchExperimentLineIds(apiBase, experimentId, workspaceKey)
+                : null);
+        if (!preview.expId ||
+            preview.expId === experimentId ||
+            (lineIds && lineIds.includes(experimentId) && lineIds.includes(preview.expId))) {
+            return preview.variant;
+        }
         return "control";
     }
     if (!isBrowser)
@@ -574,18 +597,22 @@ export async function getVariant(experimentId, opts = {}) {
         if (!res.ok)
             throw new Error(`${res.status}`);
         const data = (await res.json());
+        const runId = data.experimentId || experimentId;
         if (data.eligible === false) {
             // Staging / TestFlight / localhost: serve the arm so they can QA.
             // Do not fire an exposure — that is what would move the result.
             if (data.reason === "non_production_audience") {
-                localStorage.setItem(cacheKey, data.variant);
+                localStorage.setItem(`apex_var_${runId}`, data.variant);
                 return data.variant;
             }
             localStorage.setItem(cacheKey, "control");
             return "control";
         }
-        localStorage.setItem(cacheKey, data.variant);
-        fireExperimentExposure(experimentId, data.variant, apiBase, workspaceKey, buildId);
+        if (runId !== experimentId) {
+            localStorage.removeItem(cacheKey);
+        }
+        localStorage.setItem(`apex_var_${runId}`, data.variant);
+        fireExperimentExposure(runId, data.variant, apiBase, workspaceKey, buildId);
         return data.variant;
     }
     catch {

package/dist/esm/management.js

@@ -344,59 +344,45 @@ export function createManagementClient(cfg) {
                 return json.data.milestone;
             },
             /**
-             * Create a milestone AND scaffold its journey(s) in one call. This is the
-             * programmatic mirror of the dashboard sentence on-ramp.
-             *
-             * `scaffold` selects which legs to create:
-             *   - `"both"` (recommended) — the nudge (audience_entry over "hasn't
-             *     adopted within N days") AND the celebration (fires once on
-             *     adoption). This is what the dashboard on-ramp produces.
-             *   - `"celebration"` (default) — celebration leg only.
-             *   - `"nudge"` — nudge leg only.
-             *   - `"none"` — milestone only, no journey.
-             *
-             * `journeyName` applies only to single-leg scaffolds; for `"both"` each
-             * leg takes its template's default (deduped server-side). Every
-             * scaffolded journey is a draft — publish it from the canvas.
+             * Create a Milestone AND stamp one Adaptive Journey (Trigger → Wait
+             * until they finish → Celebration and/or Nudge). Draft only — publish
+             * from the canvas. `scaffold: "none"` is just-track (no journey).
              */
             async compose(params) {
-                const { scaffold = "celebration", journeyName, ...createParams } = params;
+                const { scaffold = "both", journeyName, nudgeClocks, ...createParams } = params;
                 const milestone = await this.create(createParams);
                 if (scaffold === "none") {
-                    return { milestone, journeyId: null, nudgeJourneyId: null, celebrationJourneyId: null };
+                    return {
+                        milestone,
+                        journeyId: null,
+                        nudgeJourneyId: null,
+                        celebrationJourneyId: null,
+                        sends: [],
+                    };
                 }
-                const scaffoldLeg = async (templateId, name) => {
-                    const res = await fetch(`${root}/api/journeys/from-template`, {
-                        method: "POST",
-                        headers,
-                        body: JSON.stringify({
-                            templateId,
-                            milestoneId: milestone.id,
-                            ...(name ? { name } : {}),
-                        }),
-                    });
-                    if (!res.ok)
-                        throw new Error(`Apex adoption.compose (journey scaffold) failed (${res.status}): ${await res.text().catch(() => "")}`);
-                    const journey = (await res.json());
-                    return journey.id ?? null;
-                };
-                const wantsNudge = scaffold === "nudge" || scaffold === "both";
-                const wantsCelebration = scaffold === "celebration" || scaffold === "both";
-                // Single-leg scaffolds honor journeyName; "both" lets each leg default.
-                const legName = scaffold === "both" ? undefined : journeyName;
-                const nudgeJourneyId = wantsNudge ? await scaffoldLeg("adoption-nudge", legName) : null;
-                const celebrationJourneyId = wantsCelebration
-                    ? await scaffoldLeg("adoption-celebration", legName)
-                    : null;
-                // Re-read so the returned milestone carries the nudge/celebration
-                // back-references the scaffolds just stamped.
+                const res = await fetch(`${root}/api/journeys/from-template`, {
+                    method: "POST",
+                    headers,
+                    body: JSON.stringify({
+                        templateId: "adoption-nudge",
+                        milestoneId: milestone.id,
+                        scaffold,
+                        name: journeyName ?? milestone.name,
+                        ...(nudgeClocks ? { nudgeClocks } : {}),
+                    }),
+                });
+                if (!res.ok) {
+                    throw new Error(`Apex adoption.compose (journey scaffold) failed (${res.status}): ${await res.text().catch(() => "")}`);
+                }
+                const journey = (await res.json());
+                const journeyId = journey.id ?? null;
                 const refreshed = (await this.get(milestone.id)) ?? milestone;
                 return {
                     milestone: refreshed,
-                    // Primary id: the nudge when it was scaffolded, else the celebration.
-                    journeyId: nudgeJourneyId ?? celebrationJourneyId,
-                    nudgeJourneyId,
-                    celebrationJourneyId,
+                    journeyId,
+                    nudgeJourneyId: journeyId,
+                    celebrationJourneyId: null,
+                    sends: journey.sends ?? [],
                 };
             },
             /** Patch a milestone (name, priority, active, gapPolicy, adoptedWhen, ...). */