@drip-apex/sdk 0.1.0 → 0.2.0

package/dist/types/config-runtime.d.ts

@@ -0,0 +1,313 @@
+import type { CompactGroupSelections } from "./persistence-decoders";
+import { getSignals as getStoredSignals } from "./signals";
+import { ActivationMode, AntiFlickerMode, Assignment, ActivationGateDiagnostic, CustomJsPolicy, ExecutionMode, Experiment, InitConfig, PageTargetingRule, PageTriggerMode, PlatformHint, SegmentCondition, RuntimeSignalDefinition, SdkDiagnostics, DataProtectionSettings, DataLayerSignalMapping, DataLayerTriggerSettings, TrackingStart } from "./types";
+export declare function applyRuntimeAntiFlicker(mode: AntiFlickerMode, timeoutMs: number, scopedSelectors?: string[], customCss?: string): boolean;
+export declare const SDK_SCRIPT_SRC: string | undefined;
+export type HeatmapController = {
+    stop: () => void;
+    update: (assignments: Assignment[], experiments: Experiment[]) => void;
+};
+export type SemanticController = {
+    stop: () => void;
+};
+export type FetchAttemptInfo = {
+    attempt: number;
+    elapsedMs: number;
+    error?: string;
+    status?: number;
+    timedOut?: boolean;
+};
+export type FetchRetryOptions = {
+    timeoutMs?: number;
+    firstAttemptTimeoutMs?: number;
+    slowMs?: number;
+    onAttemptStart?: (attempt: number) => void;
+    onAttemptEnd?: (info: FetchAttemptInfo) => void;
+    onSlow?: (info: {
+        attempt: number;
+        elapsedMs: number;
+    }) => void;
+};
+export declare const DEFAULT_CONFIG_FETCH_TIMEOUT_MS = 4500;
+export declare const DEFAULT_CONFIG_FETCH_SLOW_MS = 1500;
+export declare const CONFIG_FETCH_RETRY_COUNT = 2;
+export declare const CONFIG_FETCH_RETRY_DELAY_MS = 500;
+export declare const CONFIG_FETCH_MAX_WAIT_MS: number;
+export declare const CACHED_REDIRECT_HIDE_TIMEOUT_MS: number;
+export declare function createFetchTimeoutError(): Error | DOMException;
+export declare function fetchWithTimeout(url: string, timeoutMs: number): Promise<Response>;
+export declare function fetchWithRetry(url: string, retries?: number, delayMs?: number, options?: FetchRetryOptions): Promise<Response>;
+export declare const CONFIG_CACHE_KEY_PREFIX = "drip_cfg:";
+export declare const DEFAULT_CONFIG_CACHE_TTL_MS: number;
+export declare const DEFAULT_ANTI_FLICKER_TIMEOUT_MS = 1200;
+export declare const DEFAULT_TRACKING_IDLE_TIMEOUT_MS = 2000;
+export declare const DEFAULT_EXECUTION_MODE: ExecutionMode;
+export declare const DEFAULT_TRACKING_START: TrackingStart;
+export declare const DEFAULT_JS_POLICY: CustomJsPolicy;
+export declare const PAGE_RULE_POLL_WINDOW_MS = 2000;
+export declare const PAGE_RULE_POLL_INTERVAL_MS = 50;
+export declare const CONSENT_COOKIE_NAME = "drip_consent";
+export declare const IDENTITY_CONTEXT_COOKIE_NAME = "drip_ctx";
+export declare const IDENTITY_CONTEXT_COOKIE_MAX_AGE_SECONDS: number;
+export declare const IDENTITY_CONTEXT_COOKIE_MAX_ENCODED_BYTES = 1024;
+export declare const SESSION_STORAGE_KEY = "drip_sid";
+export declare function collectScopedSelectors(experiments: Experiment[], config?: InitConfig, assignments?: Assignment[]): string[];
+export type ResolvedRuntimeConfig = {
+    executionMode: ExecutionMode;
+    antiFlickerMode: AntiFlickerMode;
+    antiFlickerTimeoutMs: number;
+    antiFlickerCustomCss?: string;
+    trackingStart: TrackingStart;
+    trackingIdleTimeoutMs: number;
+    customJsPolicy: CustomJsPolicy;
+    proxyEventDelivery?: {
+        enabled: boolean;
+        path?: string;
+    };
+    assetFallback?: boolean;
+};
+export type UrlDiffNeeds = {
+    path: boolean;
+    search: boolean;
+    hash: boolean;
+};
+export type ConfigSource = "inline" | "cache" | "network" | "none";
+export type PendingPerfEvent = {
+    perf_event_kind: "init" | "route_change";
+    assignment_ready_ms: number;
+    init_total_ms?: number;
+    guard_resolve_ms?: number;
+    consent_identity_ms?: number;
+    runtime_setup_ms?: number;
+    targeting_assignment_ms?: number;
+    mutation_finalize_ms?: number;
+    predecision_mismatch_count?: number;
+    unattributed_init_ms?: number;
+    dom_content_loaded_ms: number;
+    /** @deprecated One-release alias for dom_content_loaded_ms. */
+    blank_screen_ms: number;
+    platform: PlatformHint;
+    config_source: ConfigSource;
+    activation_mode: ActivationMode;
+    sdk_version: string;
+    sdk_delivery_mode: string;
+    sdk_delivery_source: string;
+    sdk_policy_revision: string;
+    snippet_revision?: number;
+    runtime_profile: string;
+    sdk_variant: string;
+    snippet_fetch_ms: number;
+    snippet_transfer_size: number;
+    sdk_bundle_fetch_ms: number;
+    sdk_bundle_transfer_size: number;
+    time_to_sdk_ready_ms?: number;
+    experiment_count?: number;
+    assignment_count?: number;
+    mutation_count?: number;
+    script_exec_start?: number;
+    anti_flicker_inserted_at?: number;
+    assignment_ready_at?: number;
+    first_mutation_at?: number;
+    reveal_at?: number;
+    hidden_duration_ms?: number;
+    current_page_hide_selector_count?: number;
+    delivery_state?: string;
+    script_cache_source?: string;
+    install_surface?: string;
+    first_install_surface?: string;
+    config_fetch_ms?: number;
+    config_fetch_attempts?: number;
+    config_fetch_status?: RuntimeLoadDiagnostic["configFetchStatus"];
+    config_fetch_status_code?: number;
+    mutation_apply_pending?: number;
+    mutation_apply_applied?: number;
+    mutation_apply_missed?: number;
+    cls_total?: number;
+    cls_after_reveal?: number;
+    hydration_detected_at?: number;
+    apply_delayed_ms?: number;
+    hydration_timeout?: boolean;
+    hold_timeout?: boolean;
+    reapply_count?: number;
+    reassert_loop_detected?: boolean;
+    early_apply_at?: number;
+    reasserts_count?: number;
+    revert_loops_detected?: number;
+};
+export type InitPhaseKey = "guard_resolve_ms" | "consent_identity_ms" | "runtime_setup_ms" | "targeting_assignment_ms" | "mutation_finalize_ms";
+export type InitPerfContext = {
+    startedAt: number;
+    phases: Partial<Record<InitPhaseKey, number>>;
+    includesConfigFetch: boolean;
+    predecisionMismatches: number;
+};
+export declare const MAX_PERF_DURATION_MS = 60000;
+export declare function monotonicNow(): number;
+export declare function boundedPerfDuration(value: number): number;
+export declare function createInitPerfContext(): InitPerfContext;
+export type BootstrapPredecision = {
+    decision: Array<[experimentId: string, variationId: string]>;
+    configRevision: number;
+    visitorId: string;
+    groups: CompactGroupSelections;
+};
+export declare function bootstrapPredecision(config: InitConfig, perf: InitPerfContext): BootstrapPredecision | null;
+export declare function addInitPhase(context: InitPerfContext, phase: InitPhaseKey, startedAt: number): void;
+export type DeliveryHealthStatus = "applied" | "partial" | "miss" | "control" | "no_mutations";
+export type DeliveryHealthTracker = {
+    assignment: Assignment;
+    expected: number;
+    applied: Set<number>;
+    missed: Set<number>;
+    emitted: boolean;
+};
+export type RouteDiagnostic = {
+    previousUrl: string;
+    nextUrl: string;
+    reason: string;
+    at: number;
+    reEvaluated: boolean;
+};
+export type DataLayerDiagnostic = {
+    eventName: string;
+    dataLayerName: string;
+    at: number;
+    mappedSignals: string[];
+    gtagNormalized?: boolean;
+};
+export type ShopifySyncDiagnostic = {
+    at: number;
+    status: "pending" | "sent" | "skipped" | "failed";
+    reason?: string;
+    assignmentCount: number;
+};
+export type ShopifyAssignmentSyncDiagnostic = Omit<ShopifySyncDiagnostic, "status"> & {
+    status: ShopifySyncDiagnostic["status"] | "cookie_fallback";
+    truncatedAssignmentCount?: number;
+};
+export type ExposureDestinationDiagnostic = {
+    type: string;
+    status: "sent" | "skipped" | "failed";
+    at: number;
+    reason?: string;
+};
+export type RuntimeLoadDiagnostic = SdkDiagnostics["load"];
+export type DripPerfWindow = Window & {
+    __dripPerf?: Record<string, unknown>;
+};
+export declare function normalizeNumber(value: unknown, fallback: number): number;
+export declare function resolveRuntimeConfig(config: InitConfig): ResolvedRuntimeConfig;
+export declare function resolvePageTriggerMode(config: InitConfig): PageTriggerMode;
+export declare function resolveDomPageTrigger(config: InitConfig, pageTriggerMode: PageTriggerMode): boolean;
+export declare function dtLog(type: string, label: string, detail?: Record<string, unknown>): void;
+export declare function traceName(id: string, name?: string): string;
+export declare function traceStep(message: string, data?: Record<string, unknown>): void;
+export declare function traceGate(experiment: Experiment, gate: ActivationGateDiagnostic): void;
+export declare function browserDoNotTrackValue(): string;
+export declare function trackingBlocked(): boolean;
+export declare let storefrontVitalsGateOpen: boolean | null;
+export declare function syncStorefrontVitals(): void;
+export declare function doNotTrackEnabled(config: InitConfig): boolean;
+export declare function storageAllowed(consentRequired: boolean, consentGranted: boolean, trackingDisabledByDnt: boolean): boolean;
+export declare function readWindowPath(path: string | undefined): unknown;
+export declare function configuredConsentGranted(config: InitConfig): boolean | null;
+export declare function syncConfiguredConsent(config: InitConfig): void;
+export declare const CUSTOM_CONSENT_POLL_INTERVAL_MS = 1000;
+export declare const CUSTOM_CONSENT_POLL_MAX_MS: number;
+export declare const MANUAL_CALLBACK_TRIGGER_RERUN_INTERVAL_MS = 1000;
+export declare const MANUAL_CALLBACK_TRIGGER_RERUN_MAX_MS = 10000;
+export declare const MANUAL_CALLBACK_TRIGGER_MAX_RERUNS = 10;
+export declare const EVENT_DRIVEN_CONSENT_PROVIDERS: Set<string>;
+export declare function shouldPollConfiguredConsent(config: InitConfig): boolean;
+export declare function installConsentChangeListeners(config: InitConfig): (() => void) | null;
+export declare function resolveConsentRequired(config: InitConfig): boolean;
+export declare function resolveConsentGranted(config: InitConfig, consentRequired: boolean): boolean;
+export declare function persistentStorageAllowed(): boolean;
+export declare function coerceSignalValue(value: unknown, valueType?: RuntimeSignalDefinition["valueType"]): unknown;
+export declare function captureUrlSignals(config: InitConfig): void;
+export declare function installClickSignalCaptures(config: InitConfig): (() => void) | null;
+export declare function captureEventPropertySignals(type: string, data?: Record<string, unknown>): void;
+export declare function setCapturedSignal(key: string, value: unknown, opts: {
+    ttlDays?: number;
+    persist?: boolean;
+    source: string;
+}): void;
+export declare function setPublicSignal(key: string, value: unknown, ttlDays?: number, source?: string): void;
+export declare function getPublicSignals(options?: {
+    markVisitorSeen?: boolean;
+}): ReturnType<typeof getStoredSignals>;
+export declare function normalizePageApiName(value: unknown): string;
+export declare function pageTriggerSignal(normalizedApiName: string): string;
+export declare function triggerPage(apiName: unknown, active?: unknown): void;
+export declare function readElementCaptureValue(element: Element, capture: NonNullable<RuntimeSignalDefinition["capture"]>): unknown;
+export declare function captureDomAndGlobalSignals(config: InitConfig): void;
+export declare function consentAwareDataProtection(config: InitConfig): DataProtectionSettings | undefined;
+export declare function writeConsentCookie(granted: boolean): void;
+export declare function readConsentCookie(): boolean;
+export declare function clearConsentStorage(): void;
+export declare function applyConsentStorageMode(): void;
+export declare function runWhenDomReady(callback: () => void): void;
+export declare function applyProjectCode(config: InitConfig): void;
+export declare function resetProjectCode(): void;
+export declare function runProjectStartupCode(config: InitConfig): void;
+export declare function collectJsTriggerConditions(experiments: Experiment[]): SegmentCondition[];
+export declare function collectPageTriggerRules(experiments: Experiment[]): PageTargetingRule[];
+export type PageDetectorMode = "history" | "polling" | "dom";
+export type PageRuleReconcileScope = {
+    triggeredPageIds: ReadonlySet<string>;
+    includeImmediate: boolean;
+};
+export declare function collectPageDetectorRules(experiments: Experiment[]): Map<PageDetectorMode, PageTargetingRule[]>;
+export declare function experimentsForGlobalRouteReevaluation(experiments: Experiment[]): Experiment[];
+export declare function conditionUsesActivateTrigger(condition: SegmentCondition): boolean;
+export declare function buildJsTriggerContext(condition: SegmentCondition): Record<string, unknown>;
+export declare function runJsTriggerReset(condition: SegmentCondition): void;
+export declare function normalizeActivationValue(next: unknown, hasArgument: boolean): boolean;
+export declare function installActivateJsTrigger(condition: SegmentCondition, onChange: () => void): () => void;
+export declare function installPageTriggerRule(rule: PageTargetingRule, onChange: () => void, manualInitialTrigger?: boolean): () => void;
+export declare function installJsTriggerObserver(experiments: Experiment[], onChange: () => void, manualInitialTrigger: boolean): () => void;
+export declare function notifyQaAssistantRuntimeListeners(): void;
+export type HarnessManifest = {
+    version?: number;
+    expiresAt?: string;
+    externalJsUrl?: string | null;
+    externalCssUrl?: string | null;
+    manifestUrl?: string;
+    pollIntervalMs?: number;
+};
+export declare let harnessPollTimer: number | null;
+export declare let harnessPollKey: string;
+export declare let harnessVisibilityInstalled: boolean;
+export declare function activeHarnessAssignment(assignments: Assignment[]): Assignment | null;
+export declare function stopHarnessPolling(): void;
+export declare function applyHarnessManifest(manifest: HarnessManifest): void;
+export declare function pollHarnessManifest(manifestUrl: string): void;
+export declare function startHarnessPolling(assignments: Assignment[]): void;
+export declare function getEventsEndpoint(config: InitConfig): string | undefined;
+export declare function mintBucketingHandoverPayload(config: InitConfig, visitorId: string, assignments: Assignment[]): Promise<string | null>;
+export declare function verifyBucketingHandoverToken(config: InitConfig, token: string): Promise<unknown>;
+export declare function clearScheduledAnalyticsStart(): void;
+export declare function normalizeDataLayerTriggers(config: InitConfig): DataLayerTriggerSettings[];
+export declare function applyDataLayerMappings(eventPayload: Record<string, unknown>, mappings: DataLayerSignalMapping[] | undefined): string[];
+export declare function readNumericPath(payload: Record<string, unknown>, path: string | undefined): number | undefined;
+export declare function readStringPath(payload: Record<string, unknown>, path: string | undefined): string | undefined;
+export declare const RESERVED_DATA_LAYER_REVENUE_KEYS: Set<string>;
+export type PendingDataLayerEvent = {
+    trigger: DataLayerTriggerSettings;
+    payload: Record<string, unknown>;
+    dataLayerName: string;
+    gtagNormalized: boolean;
+    rawItem: unknown;
+};
+export declare const MAX_PENDING_DATA_LAYER_EVENTS = 50;
+export declare const pendingDataLayerEvents: PendingDataLayerEvent[];
+export declare const processedDataLayerEntries: WeakSet<object>;
+export declare function isDataLayerEntryObject(item: unknown): item is object;
+export declare function markDataLayerEntryProcessed(item: unknown): void;
+export declare function trackDataLayerRevenue(trigger: DataLayerTriggerSettings, payload: Record<string, unknown>): void;
+export declare function trackDataLayerEvent(trigger: DataLayerTriggerSettings, payload: Record<string, unknown>): void;
+export declare function enqueuePendingDataLayerEvent(event: PendingDataLayerEvent): void;
+export declare function drainPendingDataLayerEvents(): void;
+export declare function finishInitializingAssignments(): void;
+export declare function handleDataLayerEvent(trigger: DataLayerTriggerSettings, payload: Record<string, unknown>, dataLayerName: string, rawItem: unknown, gtagNormalized?: boolean): void;
+export declare function recordObserverError(source: "route" | "data_layer" | "dom", error: unknown): void;

package/dist/types/consent-evaluation.d.ts

@@ -0,0 +1,27 @@
+export type SynchronousConsentInput = {
+    requireConsent?: boolean;
+    hasConsent?: boolean;
+    consentModeEnabled?: boolean;
+    configuredConsentGranted?: boolean | null;
+    consentCookieGranted: boolean;
+    respectDoNotTrack?: boolean;
+    doNotTrackValue?: string;
+};
+export type ConsentProvider = "custom" | "onetrust" | "usercentrics" | "cookiebot" | "ccm19" | "pandectes" | "cookiescript";
+export declare function readPath(root: unknown, path?: string): unknown;
+export declare function readConsentCookie(name: string): string;
+/** The SDK's synchronous native-CMP readers, shared with the pre-SDK capture fragment. */
+export declare function readConfiguredConsent(provider?: ConsentProvider, requiredGroup?: string, getter?: string): boolean | null;
+export declare function readCookieScriptConsent(requiredGroup?: string): boolean | null;
+export declare const CONSENT_REQUIRED = 1;
+export declare const CONSENT_GRANTED = 2;
+export declare const DNT_BLOCKED = 4;
+export declare const STORAGE_ALLOWED = 8;
+export declare function resolveSynchronousConsentGranted(input: SynchronousConsentInput & {
+    provider?: ConsentProvider;
+}): boolean;
+export declare function evaluateSynchronousConsentForProvider(input: SynchronousConsentInput & {
+    provider?: ConsentProvider;
+}): number;
+/** Pure synchronous consent/DNT bitmask shared by SDK init and the inline bootstrap. */
+export declare function evaluateSynchronousConsent(input: SynchronousConsentInput): number;

package/dist/types/css.d.ts

@@ -1,5 +1,7 @@
-export declare function injectCss(css: string, experimentId: string, variationId: string): void;
-export declare function injectExperimentCss(css: string, experimentId: string): void;
+export declare function injectCss(css: string, experimentId: string, variationId: string, ownerKeys?: readonly string[], artifactId?: string, epoch?: number): void;
+export declare function injectExperimentCss(css: string, experimentId: string, ownerKeys?: readonly string[], artifactId?: string, epoch?: number): void;
 export declare function removeCss(experimentId: string, variationId: string): void;
-export declare function injectExternalCss(url: string, experimentId: string, variationId: string): Promise<void>;
+export declare function injectExternalCss(url: string, experimentId: string, variationId: string, ownerKeys?: readonly string[], artifactId?: string, epoch?: number): Promise<void>;
+export declare function removeCssForOwner(ownerKey: string, artifactId?: string): void;
+export declare function addCssOwners(existingOwnerKeys: ReadonlySet<string>, ownerKeys: readonly string[], artifactId?: string): void;
 export declare function removeAllCss(): void;

package/dist/types/debug-loader.d.ts

@@ -0,0 +1,2 @@
+import type { DebugSettings } from "./types";
+export declare function loadDebugBuild(settings: DebugSettings | undefined, snippetUrl: string | undefined, onFallback?: () => void): boolean;

package/dist/types/decide-assignments.d.ts

@@ -0,0 +1,31 @@
+import type { PersistedAssignmentRecord } from "./assignment-store";
+import type { Assignment, ExclusionGroupConfig, Experiment, Variation } from "./types";
+export type StoredGroupSelection = {
+    experimentId: string;
+    epoch: number;
+};
+export interface DecideAssignmentsInput {
+    experiments: Experiment[];
+    visitorId: string;
+    storedAssignments?: Record<string, PersistedAssignmentRecord>;
+    storedGroupSelections?: Record<string, StoredGroupSelection>;
+    exclusionGroups?: ExclusionGroupConfig[];
+    holdout?: {
+        enabled?: boolean;
+        percentage?: number;
+    };
+    /** Supplied by the caller so the decision boundary never reads the clock. */
+    now: number;
+    /** Reserved for the Stage 2 bootstrap's already-targeted payload contract. */
+    url?: string;
+}
+export declare function buildAssignment(experiment: Experiment, variation: Variation, index: number, hashValue: string, url?: string): Assignment;
+/** Worker bootstrap entrypoint after its literal status and weekday filters. */
+export declare function decideVariationIdsPregated(input: DecideAssignmentsInput): Array<[string, string]>;
+/** Compact projection of the same production bucketing decision for pre-paint handoff. */
+export declare function decideVariationIds(input: DecideAssignmentsInput): Array<[string, string]>;
+/**
+ * Pure assignment boundary for the SDK and the future inline bootstrap.
+ * The caller owns targeting, storage reads/writes, time, and exposure effects.
+ */
+export declare function decideAssignments(input: DecideAssignmentsInput): Assignment[];

package/dist/types/delivery-timing.d.ts

@@ -0,0 +1,8 @@
+export type DeliveryTiming = {
+    snippet_fetch_ms: number;
+    snippet_transfer_size: number;
+    sdk_bundle_fetch_ms: number;
+    sdk_bundle_transfer_size: number;
+    time_to_sdk_ready_ms?: number;
+};
+export declare function collectDeliveryTiming(sdkInitStartedAt: number | undefined, sdkScriptSrc?: string): DeliveryTiming;

package/dist/types/early-interaction-capture.d.ts

@@ -0,0 +1,79 @@
+import type { Assignment, DataProtectionSettings, Experiment } from "./types";
+export declare const EARLY_INTERACTION_STORAGE_KEY = "drip_early_interactions_v1";
+export declare const EARLY_INTERACTION_TTL_MS: number;
+type StorageMode = NonNullable<DataProtectionSettings["storageMode"]>;
+export type EarlyInteractionEntry = {
+    goalId: string;
+    experimentId: string;
+    variationId: string;
+    assignmentEpoch: number;
+    kind: "click" | "submit";
+    data: Record<string, unknown>;
+    timestamp: number;
+    sessionId: string;
+    pageUrl: string;
+    configRevision: number;
+};
+type EarlyCaptureState = {
+    entries: EarlyInteractionEntry[];
+    stop: () => void;
+    storageMode: StorageMode;
+};
+declare global {
+    var __dripEarlyInteractions: EarlyCaptureState | undefined;
+    var __dripHasConsent: boolean | undefined;
+    var __dripInstallEarlyInteractionCapture: typeof installEarlyInteractionCapture | undefined;
+    var __dripPredecided: {
+        decision?: Array<[string, string]>;
+    } | undefined;
+    var __dripEarlyQ: Array<{
+        kind: "click" | "submit";
+        target: Element;
+        timestamp: number;
+        id: number;
+        pageUrl: string;
+        consentAllowed: boolean;
+    }> | undefined;
+    var __dripEarlyStop: (() => void) | undefined;
+}
+export declare function drainBootstrapEarlyInteractions(input: ConsentConfig & {
+    assignments: Assignment[];
+    experiments: Experiment[];
+    activePageIds?: ReadonlySet<string>;
+    qaMode?: boolean;
+    environment?: string;
+    now?: number;
+    consume: (goalId: string, assignment: Assignment, timestamp: number, kind: "click" | "submit", pageUrl: string) => void;
+}): void;
+export declare function clearEarlyInteractions(mode?: StorageMode): void;
+type ConsentConfig = {
+    requireConsent?: boolean;
+    consentModeEnabled?: boolean;
+    consentProvider?: "custom" | "onetrust" | "usercentrics" | "cookiebot" | "ccm19" | "pandectes" | "cookiescript";
+    consentRequiredGroup?: string;
+    consentGetter?: string;
+    respectDoNotTrack?: boolean;
+};
+export type EarlyCaptureConfig = ConsentConfig & {
+    experiments: Experiment[];
+    assignments: Pick<Assignment, "experimentId" | "variationId" | "assignmentEpoch">[];
+    attributes?: Record<string, unknown>;
+    configRevision: number;
+    pageUrl: string;
+    storageMode?: StorageMode;
+    forcedExperimentIds?: string[];
+    now?: number;
+};
+export declare function installEarlyInteractionCapture(config: EarlyCaptureConfig): void;
+export declare function drainEarlyInteractions(input: ConsentConfig & {
+    qaMode?: boolean;
+    environment?: string;
+    configRevision: number | undefined;
+    sessionId: string;
+    storageMode?: StorageMode;
+    experiments: Experiment[];
+    now?: number;
+    forcedExperimentIds?: string[];
+    consume: (entry: EarlyInteractionEntry) => void;
+}): void;
+export {};

package/dist/types/early-reassert.d.ts

@@ -0,0 +1,32 @@
+import type { Assignment } from "./types";
+export type EarlyReassertDiagnostics = {
+    early_apply_at?: number;
+    reasserts_count?: number;
+    revert_loops_detected?: number;
+};
+export declare function assignmentsHaveStructuralMutations(assignments: Assignment[]): boolean;
+export declare function assignmentsHaveCustomJs(assignments: Assignment[]): boolean;
+export declare function shouldUseEarlyReassert(input: {
+    applyTiming?: string;
+    hasTrustedPredecision: boolean;
+    consentGranted: boolean;
+    dntBlocked: boolean;
+    configSource: string;
+}): boolean;
+/**
+ * Watches only treatment selectors and batches hydration repairs into the next
+ * animation frame. The observer is deliberately SDK-side: the inline decision
+ * bootstrap remains a small, synchronous decision-only artifact.
+ *
+ * The watcher never captures an assignment array. It resolves the live applied
+ * set through `resolveAssignments` at fire time, so a page teardown that drops
+ * the artifacts stops it by construction rather than through a
+ * `stopEarlyReassert()` call nobody makes.
+ */
+export declare function installEarlyReassert(input: {
+    resolveAssignments: () => Assignment[];
+    reapply: (assignments: Assignment[]) => void;
+    diagnostics: EarlyReassertDiagnostics;
+    timeoutMs?: number;
+    cap?: number;
+}): () => void;

package/dist/types/edge-runtime.d.ts

@@ -0,0 +1,11 @@
+export type EdgeRuntimeAssignment = {
+    experimentId: string;
+    variationId: string;
+    index: number;
+};
+export declare function edgeRuntimeActive(): boolean;
+/**
+ * Reads the edge worker's authoritative assignment set.
+ * The adoption evaluator validates each selected variation and index.
+ */
+export declare function readEdgeRuntimeAssignments(): Map<string, EdgeRuntimeAssignment> | null;

package/dist/types/editor/api.d.ts

@@ -1,7 +1,9 @@
 import type { ActiveEditorSession, ClaimedEditorCommand, EditorArtifacts, EditorVariation } from "./types";
+import { type VariationSaveOutcome } from "./publication-result";
 export declare class EditorApiError extends Error {
     readonly status: number;
     readonly payload?: (Record<string, unknown> | null) | undefined;
+    readonly outcome: VariationSaveOutcome | null;
     constructor(message: string, status: number, payload?: (Record<string, unknown> | null) | undefined);
 }
 type FetchLike = typeof fetch;
@@ -19,6 +21,7 @@ export declare class EditorApi {
     saveArtifacts(variationId: string, artifacts: EditorArtifacts, expectedPriorHash: string): Promise<{
         artifactHash: string;
         reviewStatus: string | null;
+        outcome: VariationSaveOutcome;
         warningIssues: Array<{
             code?: string;
             message?: string;

package/dist/types/editor/controller.d.ts

@@ -34,6 +34,7 @@ export declare class EditorController {
     readonly apiOrigin: string;
     private readonly api;
     private readonly reload;
+    private readonly confirmLiveSave;
     private state;
     private readonly listeners;
     private readonly history;
@@ -43,8 +44,9 @@ export declare class EditorController {
     private saveQueue;
     private revision;
     private variationRequest;
+    private liveSaveConfirmed;
     private readonly cleanups;
-    constructor(session: ActiveEditorSession, apiOrigin: string, api?: EditorApi, reload?: () => void);
+    constructor(session: ActiveEditorSession, apiOrigin: string, api?: EditorApi, reload?: () => void, confirmLiveSave?: (message: string) => boolean);
     getState(): EditorState;
     subscribe(listener: (state: EditorState) => void): () => void;
     initialize(): Promise<void>;

package/dist/types/editor/publication-result.d.ts

@@ -0,0 +1,11 @@
+export type PublicationStatus = "ok" | "pending" | "warning" | "failed";
+export type VariationSaveOutcome = {
+    saved: boolean;
+    artifactHash: string | null;
+    publication: {
+        status: PublicationStatus;
+        code: string;
+        message: string;
+    } | null;
+};
+export declare function parseVariationSaveOutcome(value: unknown): VariationSaveOutcome | null;

package/dist/types/editor/types.d.ts

@@ -6,6 +6,7 @@ export type ActiveEditorSession = {
     shopId: string;
     experimentId: string;
     experimentName?: string | null;
+    experimentStatus?: string | null;
     initialVariationId: string;
     targetUrl: string;
     targetOrigin: string;
@@ -33,7 +34,7 @@ export type ClaimedEditorCommand = {
     args: Record<string, unknown>;
     expiresAt: string | null;
 };
-export type EditorSaveState = "idle" | "saving" | "saved" | "conflict" | "error";
+export type EditorSaveState = "idle" | "saving" | "saved" | "pending" | "warning" | "publication_failed" | "conflict" | "error";
 export type EditorDeviceState = "closed" | "loading" | "active" | "blocked";
 export type EditorState = {
     variation: EditorVariation | null;

package/dist/types/editor/view-kit.d.ts

@@ -30,4 +30,4 @@ export type IconName = keyof typeof ICONS;
 export declare function icon(name: IconName, size?: number, extra?: string): string;
 export declare function operatorMark(size?: number, color?: string): string;
 export declare function esc(value: string): string;
-export declare const KIT_CSS = "\n:host {\n  --bg0:#08080A;--bg1:#0A0A0C;--raised:#141419;--raised-hi:#1A1A21;--inset:#0B0B0E;\n  --border:rgba(255,255,255,0.06);--border-hi:rgba(255,255,255,0.10);--border-px:rgba(255,255,255,0.14);\n  --text1:#FAFAFA;--text2:rgba(255,255,255,0.66);--text3:rgba(255,255,255,0.42);--text4:rgba(255,255,255,0.26);\n  --purple500:#5B29FF;--purple400:#7C54FF;--purple300:#9B6FFF;--purple200:#C8B4FF;\n  --purple-soft:rgba(91,41,255,0.14);--purple-bd:rgba(124,84,255,0.34);\n  --positive:#3DD68C;--warning:#FACC15;--negative:#EB5252;--negative-soft:#F39797;\n  all:initial;font-family:Inter,system-ui,sans-serif;color:var(--text1);letter-spacing:0;\n  position:fixed;inset:0;z-index:2147483647;pointer-events:none;font-size:12.5px;line-height:1.5;\n}\n*{box-sizing:border-box;letter-spacing:0;margin:0;padding:0}\nbutton,input,select,textarea{font:inherit;color:inherit;font-family:inherit}\nbutton{cursor:pointer;background:none;border:none}\nbutton:disabled{cursor:not-allowed}\n:is(button,textarea,input,a):focus-visible{outline:2px solid var(--purple400);outline-offset:2px}\n@keyframes ee-spin{to{transform:rotate(360deg)}}\n@keyframes ee-pulse{0%{transform:scale(0.7);opacity:0.9}100%{transform:scale(1.6);opacity:0}}\n@keyframes ee-in{from{opacity:0;transform:translateY(4px)}to{opacity:1;transform:none}}\n.ee-in{animation:ee-in 160ms ease-out}\n.spin{animation:ee-spin 1s linear infinite}\n@media(prefers-reduced-motion:reduce){*,*::before,*::after{animation-duration:0.01ms!important;animation-iteration-count:1!important;transition-duration:0.01ms!important}}\n\n/* Buttons */\n.btn{display:inline-flex;align-items:center;gap:7px;justify-content:center;padding:7px 12px;font-size:13px;font-weight:550;border-radius:8px;border:1px solid transparent;line-height:1.2;white-space:nowrap;transition:background 120ms,border-color 120ms,color 120ms;pointer-events:auto}\n.btn.sm{padding:5px 10px;font-size:12px}\n.btn:disabled{opacity:0.45}\n.btn.primary{background:var(--purple500);color:#fff;border-color:rgba(255,255,255,0.14)}\n.btn.soft{background:var(--purple-soft);color:var(--purple200);border-color:var(--purple-bd)}\n.btn.ghost{background:transparent;color:var(--text2);border-color:var(--border)}\n.btn.ghost:hover{background:var(--raised-hi);color:var(--text1)}\n.btn.bare{background:transparent;color:var(--text2);border-color:transparent}\n.btn.danger{background:rgba(235,82,82,0.14);color:var(--negative-soft);border-color:rgba(235,82,82,0.3)}\n.iconbtn{width:30px;height:30px;display:inline-flex;align-items:center;justify-content:center;border-radius:8px;border:1px solid transparent;background:transparent;color:var(--text2);flex-shrink:0;transition:background 120ms,color 120ms;pointer-events:auto}\n.iconbtn:hover{background:var(--raised-hi);color:var(--text1)}\n.iconbtn.active{background:var(--purple-soft);color:var(--purple200);border-color:var(--purple-bd)}\n.iconbtn:disabled{opacity:0.4}\n.iconbtn.xs{width:22px;height:22px}\n\n/* Status dot */\n.dot{position:relative;width:7px;height:7px;flex-shrink:0;display:inline-block}\n.dot i{position:absolute;inset:0;border-radius:50%}\n.dot.ok i{background:var(--positive)}.dot.warn i{background:var(--warning)}.dot.err i{background:var(--negative)}.dot.purple i{background:var(--purple300)}\n.dot b{position:absolute;inset:-3px;border-radius:50%;border:1px solid currentColor}\n.dot.ok b{color:var(--positive)}.dot.warn b{color:var(--warning)}.dot.err b{color:var(--negative)}.dot.purple b{color:var(--purple300)}\n.dot b{animation:ee-pulse 1.4s ease-out infinite}\n\n/* Save chip */\n.save-chip{display:inline-flex;align-items:center;gap:7px;font-size:12px;font-weight:550;padding:4px 9px;border-radius:7px;background:rgba(255,255,255,0.04);border:1px solid var(--border);white-space:nowrap}\n.save-chip.unsaved{color:var(--warning)}\n.save-chip.saving{color:var(--purple200)}\n.save-chip.saved{color:var(--positive)}\n.save-chip.failed,.save-chip.conflict{color:var(--negative-soft);background:rgba(235,82,82,0.10);border-color:rgba(235,82,82,0.25)}\n.save-chip .retry{border:none;background:rgba(255,255,255,0.1);color:#fff;font-size:11.5px;font-weight:600;border-radius:5px;padding:2px 7px;margin-left:2px;pointer-events:auto}\n\n/* Segmented control */\n.seg{display:inline-flex;background:var(--inset);border-radius:8px;padding:2px;gap:2px;border:1px solid var(--border);pointer-events:auto}\n.seg button{display:inline-flex;align-items:center;gap:6px;justify-content:center;padding:5px 11px;border-radius:6px;border:none;background:transparent;color:var(--text3);font-size:12px;font-weight:550;transition:background 120ms,color 120ms}\n.seg button.sm{padding:4px 8px}\n.seg button[aria-checked=\"true\"]{background:var(--raised-hi);color:var(--text1);box-shadow:inset 0 0 0 1px var(--border-px)}\n\n/* Pills & chips */\n.draft-pill{display:inline-flex;align-items:center;gap:6px;padding:2px 8px;border-radius:999px;background:rgba(250,204,21,0.10);border:1px solid rgba(250,204,21,0.3);font-size:11px;font-weight:600;color:var(--warning);white-space:nowrap}\n.session-chip{display:inline-flex;align-items:center;gap:6px;font-size:12px;font-weight:550;color:var(--warning);padding:4px 9px;border-radius:7px;border:1px solid rgba(250,204,21,0.35);background:rgba(250,204,21,0.08);white-space:nowrap;font-variant-numeric:tabular-nums}\n.session-chip .extend{border:none;background:rgba(250,204,21,0.16);color:var(--warning);font-size:11.5px;font-weight:600;border-radius:5px;padding:2px 7px;pointer-events:auto}\n.session-note{font-size:11px;color:var(--text4);white-space:nowrap}\n.conn-chip{display:inline-flex;align-items:center;gap:7px;font-size:12px;font-weight:550;white-space:nowrap;color:var(--text3)}\n.conn-chip.offline{color:var(--negative-soft)}\n.conn-chip.connecting{color:var(--warning)}\n.ctx-chip{display:inline-flex;align-items:center;gap:7px;max-width:100%;background:var(--purple-soft);border:1px solid var(--purple-bd);border-radius:8px;padding:5px 8px;font-size:11.5px;color:var(--purple200);font-weight:550}\n.ctx-chip .name{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}\n.ctx-chip .replace{border:none;background:rgba(255,255,255,0.08);color:var(--text2);font-size:10.5px;font-weight:600;border-radius:5px;padding:2px 7px;pointer-events:auto}\n.ctx-chip .clear{border:none;background:none;color:var(--text3);padding:2px;display:inline-flex;pointer-events:auto}\n\n/* Fields */\n.field{width:100%;background:var(--inset);color:var(--text1);border:1px solid var(--border-hi);border-radius:8px;padding:8px 10px;font-size:12.5px;line-height:1.5;outline:none;resize:vertical;pointer-events:auto}\n.field::placeholder{color:rgba(255,255,255,0.28)}\n.field.code{white-space:pre;font-variant-numeric:tabular-nums;min-height:150px}\n.flabel{display:block;font-size:11.5px;font-weight:550;color:var(--text3);margin-bottom:5px}\n.fhint{display:block;font-size:11px;color:var(--text4);margin-top:4px}\n\n/* Banners */\n.banner{display:flex;align-items:center;gap:9px;padding:8px 12px;border-radius:10px;color:var(--text1);font-size:12.5px;box-shadow:0 12px 32px rgba(0,0,0,0.4);pointer-events:auto;max-width:560px}\n.banner .body{flex:1;min-width:0}\n.banner.info{background:linear-gradient(0deg,rgba(91,41,255,0.16),rgba(91,41,255,0.16)),var(--bg1);border:1px solid var(--purple-bd)}\n.banner.info svg{color:var(--purple200)}\n.banner.warn{background:linear-gradient(0deg,rgba(250,204,21,0.10),rgba(250,204,21,0.10)),var(--bg1);border:1px solid rgba(250,204,21,0.35)}\n.banner.warn svg{color:var(--warning)}\n.banner.error{background:linear-gradient(0deg,rgba(235,82,82,0.12),rgba(235,82,82,0.12)),var(--bg1);border:1px solid rgba(235,82,82,0.35)}\n.banner.error svg{color:var(--negative-soft)}\n\n/* Modal */\n.modal-backdrop{position:fixed;inset:0;z-index:300;display:flex;align-items:center;justify-content:center;background:rgba(5,5,8,0.55);backdrop-filter:blur(3px);pointer-events:auto}\n.modal{width:430px;max-width:calc(100vw - 40px);background:var(--bg1);border:1px solid var(--border-px);border-radius:14px;box-shadow:0 32px 80px rgba(0,0,0,0.55);overflow:hidden;color:var(--text1)}\n.modal .m-head{display:flex;gap:10px;align-items:flex-start;padding:18px 18px 0}\n.modal .m-icon{width:30px;height:30px;border-radius:8px;background:rgba(255,255,255,0.05);border:1px solid var(--border);display:flex;align-items:center;justify-content:center;flex-shrink:0}\n.modal .m-icon.warn{color:var(--warning)}.modal .m-icon.purple{color:var(--purple300)}.modal .m-icon.ok{color:var(--positive)}\n.modal .m-title{font-size:15px;font-weight:600;letter-spacing:-0.015em;padding-top:4px}\n.modal .m-body{padding:12px 18px 4px;font-size:13px;line-height:1.6;color:var(--text2)}\n.modal .m-body p{margin:0}\n.modal .m-body p+p{margin-top:10px}\n.modal .m-actions{display:flex;justify-content:flex-end;gap:8px;padding:14px 18px 18px}\n";
+export declare const KIT_CSS = "\n:host {\n  --bg0:#08080A;--bg1:#0A0A0C;--raised:#141419;--raised-hi:#1A1A21;--inset:#0B0B0E;\n  --border:rgba(255,255,255,0.06);--border-hi:rgba(255,255,255,0.10);--border-px:rgba(255,255,255,0.14);\n  --text1:#FAFAFA;--text2:rgba(255,255,255,0.66);--text3:rgba(255,255,255,0.42);--text4:rgba(255,255,255,0.26);\n  --purple500:#5B29FF;--purple400:#7C54FF;--purple300:#9B6FFF;--purple200:#C8B4FF;\n  --purple-soft:rgba(91,41,255,0.14);--purple-bd:rgba(124,84,255,0.34);\n  --positive:#3DD68C;--warning:#FACC15;--negative:#EB5252;--negative-soft:#F39797;\n  all:initial;font-family:Inter,system-ui,sans-serif;color:var(--text1);letter-spacing:0;\n  position:fixed;inset:0;z-index:2147483647;pointer-events:none;font-size:12.5px;line-height:1.5;\n}\n*{box-sizing:border-box;letter-spacing:0;margin:0;padding:0}\nbutton,input,select,textarea{font:inherit;color:inherit;font-family:inherit}\nbutton{cursor:pointer;background:none;border:none}\nbutton:disabled{cursor:not-allowed}\n:is(button,textarea,input,a):focus-visible{outline:2px solid var(--purple400);outline-offset:2px}\n@keyframes ee-spin{to{transform:rotate(360deg)}}\n@keyframes ee-pulse{0%{transform:scale(0.7);opacity:0.9}100%{transform:scale(1.6);opacity:0}}\n@keyframes ee-in{from{opacity:0;transform:translateY(4px)}to{opacity:1;transform:none}}\n.ee-in{animation:ee-in 160ms ease-out}\n.spin{animation:ee-spin 1s linear infinite}\n@media(prefers-reduced-motion:reduce){*,*::before,*::after{animation-duration:0.01ms!important;animation-iteration-count:1!important;transition-duration:0.01ms!important}}\n\n/* Buttons */\n.btn{display:inline-flex;align-items:center;gap:7px;justify-content:center;padding:7px 12px;font-size:13px;font-weight:550;border-radius:8px;border:1px solid transparent;line-height:1.2;white-space:nowrap;transition:background 120ms,border-color 120ms,color 120ms;pointer-events:auto}\n.btn.sm{padding:5px 10px;font-size:12px}\n.btn:disabled{opacity:0.45}\n.btn.primary{background:var(--purple500);color:#fff;border-color:rgba(255,255,255,0.14)}\n.btn.soft{background:var(--purple-soft);color:var(--purple200);border-color:var(--purple-bd)}\n.btn.ghost{background:transparent;color:var(--text2);border-color:var(--border)}\n.btn.ghost:hover{background:var(--raised-hi);color:var(--text1)}\n.btn.bare{background:transparent;color:var(--text2);border-color:transparent}\n.btn.danger{background:rgba(235,82,82,0.14);color:var(--negative-soft);border-color:rgba(235,82,82,0.3)}\n.iconbtn{width:30px;height:30px;display:inline-flex;align-items:center;justify-content:center;border-radius:8px;border:1px solid transparent;background:transparent;color:var(--text2);flex-shrink:0;transition:background 120ms,color 120ms;pointer-events:auto}\n.iconbtn:hover{background:var(--raised-hi);color:var(--text1)}\n.iconbtn.active{background:var(--purple-soft);color:var(--purple200);border-color:var(--purple-bd)}\n.iconbtn:disabled{opacity:0.4}\n.iconbtn.xs{width:22px;height:22px}\n\n/* Status dot */\n.dot{position:relative;width:7px;height:7px;flex-shrink:0;display:inline-block}\n.dot i{position:absolute;inset:0;border-radius:50%}\n.dot.ok i{background:var(--positive)}.dot.warn i{background:var(--warning)}.dot.err i{background:var(--negative)}.dot.purple i{background:var(--purple300)}\n.dot b{position:absolute;inset:-3px;border-radius:50%;border:1px solid currentColor}\n.dot.ok b{color:var(--positive)}.dot.warn b{color:var(--warning)}.dot.err b{color:var(--negative)}.dot.purple b{color:var(--purple300)}\n.dot b{animation:ee-pulse 1.4s ease-out infinite}\n\n/* Save chip */\n.save-chip{display:inline-flex;align-items:center;gap:7px;font-size:12px;font-weight:550;padding:4px 9px;border-radius:7px;background:rgba(255,255,255,0.04);border:1px solid var(--border);white-space:nowrap}\n.save-chip.unsaved{color:var(--warning)}\n.save-chip.saving{color:var(--purple200)}\n.save-chip.saved{color:var(--positive)}\n.save-chip.pending,.save-chip.warning{color:var(--warning);background:rgba(245,166,35,0.10);border-color:rgba(245,166,35,0.25)}\n.save-chip.failed,.save-chip.publication-failed,.save-chip.conflict{color:var(--negative-soft);background:rgba(235,82,82,0.10);border-color:rgba(235,82,82,0.25)}\n.save-chip .retry{border:none;background:rgba(255,255,255,0.1);color:#fff;font-size:11.5px;font-weight:600;border-radius:5px;padding:2px 7px;margin-left:2px;pointer-events:auto}\n\n/* Segmented control */\n.seg{display:inline-flex;background:var(--inset);border-radius:8px;padding:2px;gap:2px;border:1px solid var(--border);pointer-events:auto}\n.seg button{display:inline-flex;align-items:center;gap:6px;justify-content:center;padding:5px 11px;border-radius:6px;border:none;background:transparent;color:var(--text3);font-size:12px;font-weight:550;transition:background 120ms,color 120ms}\n.seg button.sm{padding:4px 8px}\n.seg button[aria-checked=\"true\"]{background:var(--raised-hi);color:var(--text1);box-shadow:inset 0 0 0 1px var(--border-px)}\n\n/* Pills & chips */\n.draft-pill{display:inline-flex;align-items:center;gap:6px;padding:2px 8px;border-radius:999px;background:rgba(250,204,21,0.10);border:1px solid rgba(250,204,21,0.3);font-size:11px;font-weight:600;color:var(--warning);white-space:nowrap}\n.session-chip{display:inline-flex;align-items:center;gap:6px;font-size:12px;font-weight:550;color:var(--warning);padding:4px 9px;border-radius:7px;border:1px solid rgba(250,204,21,0.35);background:rgba(250,204,21,0.08);white-space:nowrap;font-variant-numeric:tabular-nums}\n.session-chip .extend{border:none;background:rgba(250,204,21,0.16);color:var(--warning);font-size:11.5px;font-weight:600;border-radius:5px;padding:2px 7px;pointer-events:auto}\n.session-note{font-size:11px;color:var(--text4);white-space:nowrap}\n.conn-chip{display:inline-flex;align-items:center;gap:7px;font-size:12px;font-weight:550;white-space:nowrap;color:var(--text3)}\n.conn-chip.offline{color:var(--negative-soft)}\n.conn-chip.connecting{color:var(--warning)}\n.ctx-chip{display:inline-flex;align-items:center;gap:7px;max-width:100%;background:var(--purple-soft);border:1px solid var(--purple-bd);border-radius:8px;padding:5px 8px;font-size:11.5px;color:var(--purple200);font-weight:550}\n.ctx-chip .name{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}\n.ctx-chip .replace{border:none;background:rgba(255,255,255,0.08);color:var(--text2);font-size:10.5px;font-weight:600;border-radius:5px;padding:2px 7px;pointer-events:auto}\n.ctx-chip .clear{border:none;background:none;color:var(--text3);padding:2px;display:inline-flex;pointer-events:auto}\n\n/* Fields */\n.field{width:100%;background:var(--inset);color:var(--text1);border:1px solid var(--border-hi);border-radius:8px;padding:8px 10px;font-size:12.5px;line-height:1.5;outline:none;resize:vertical;pointer-events:auto}\n.field::placeholder{color:rgba(255,255,255,0.28)}\n.field.code{white-space:pre;font-variant-numeric:tabular-nums;min-height:150px}\n.flabel{display:block;font-size:11.5px;font-weight:550;color:var(--text3);margin-bottom:5px}\n.fhint{display:block;font-size:11px;color:var(--text4);margin-top:4px}\n\n/* Banners */\n.banner{display:flex;align-items:center;gap:9px;padding:8px 12px;border-radius:10px;color:var(--text1);font-size:12.5px;box-shadow:0 12px 32px rgba(0,0,0,0.4);pointer-events:auto;max-width:560px}\n.banner .body{flex:1;min-width:0}\n.banner.info{background:linear-gradient(0deg,rgba(91,41,255,0.16),rgba(91,41,255,0.16)),var(--bg1);border:1px solid var(--purple-bd)}\n.banner.info svg{color:var(--purple200)}\n.banner.warn{background:linear-gradient(0deg,rgba(250,204,21,0.10),rgba(250,204,21,0.10)),var(--bg1);border:1px solid rgba(250,204,21,0.35)}\n.banner.warn svg{color:var(--warning)}\n.banner.error{background:linear-gradient(0deg,rgba(235,82,82,0.12),rgba(235,82,82,0.12)),var(--bg1);border:1px solid rgba(235,82,82,0.35)}\n.banner.error svg{color:var(--negative-soft)}\n\n/* Modal */\n.modal-backdrop{position:fixed;inset:0;z-index:300;display:flex;align-items:center;justify-content:center;background:rgba(5,5,8,0.55);backdrop-filter:blur(3px);pointer-events:auto}\n.modal{width:430px;max-width:calc(100vw - 40px);background:var(--bg1);border:1px solid var(--border-px);border-radius:14px;box-shadow:0 32px 80px rgba(0,0,0,0.55);overflow:hidden;color:var(--text1)}\n.modal .m-head{display:flex;gap:10px;align-items:flex-start;padding:18px 18px 0}\n.modal .m-icon{width:30px;height:30px;border-radius:8px;background:rgba(255,255,255,0.05);border:1px solid var(--border);display:flex;align-items:center;justify-content:center;flex-shrink:0}\n.modal .m-icon.warn{color:var(--warning)}.modal .m-icon.purple{color:var(--purple300)}.modal .m-icon.ok{color:var(--positive)}\n.modal .m-title{font-size:15px;font-weight:600;letter-spacing:-0.015em;padding-top:4px}\n.modal .m-body{padding:12px 18px 4px;font-size:13px;line-height:1.6;color:var(--text2)}\n.modal .m-body p{margin:0}\n.modal .m-body p+p{margin-top:10px}\n.modal .m-actions{display:flex;justify-content:flex-end;gap:8px;padding:14px 18px 18px}\n";

package/dist/types/endpoint.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Normalize an SDK endpoint: strip trailing slashes and a trailing events path
+ * so configured bare, /events, and /v1/events endpoints resolve to the base.
+ * Single chokepoint — every SDK helper that derives a sibling route from
+ * config.endpoint must go through this (events, handover, order-identity,
+ * replay, shopify cart authorization).
+ */
+export declare function normalizeEndpoint(endpoint: string): string;