@rokt/dcui-orchestrator 1.2.1-rc.3 → 1.2.1-rc.30

package/dist/libraries/dcui-components/src/components/data-mapper/data-mapper.d.ts

@@ -5,9 +5,13 @@ export type DataObject = {
 export type StateOnlyObject = {
     state: object;
 };
+export type AttributeOnlyObject = {
+    attribute: object;
+};
 export type ExtendableDataMapper = ReturnType<typeof createDataMapper>;
 export declare function createDataMapper(data: object, namespace?: string): {
     (template: string): string;
     (stateObj: StateOnlyObject, namespace?: string): /*elided*/ any;
+    (attributeObj: AttributeOnlyObject, namespace?: string): /*elided*/ any;
     (dataObj: DataObject, namespace: string): /*elided*/ any;
 };

package/dist/libraries/dcui-components/src/components/index.d.ts

@@ -31,3 +31,4 @@ export * from './form';
 export * from './text-input';
 export * from './action-button';
 export * from './apple-pay-button';
+export * from './paypal-button';

package/dist/libraries/dcui-components/src/components/paypal-button/index.d.ts

@@ -0,0 +1 @@
+export * from './paypal-button';

package/dist/libraries/dcui-components/src/components/paypal-button/paypal-button.d.ts

@@ -0,0 +1,78 @@
+import React from 'react';
+import type { ThemeColor } from '@rokt/dcui-layout-schema';
+/**
+ * Renders a PayPal-branded button whose look is fixed to the options in
+ * PayPal's button style guide (colors, shapes, height range), the same way
+ * ApplePayButton only offers Apple's styles. Layout styles can pick between
+ * those options but cannot restyle the brand.
+ * @see https://developer.paypal.com/docs/multiparty/checkout/standard/customize/buttons-style-guide/
+ */
+export type PayPalButtonColor = 'gold' | 'blue' | 'silver' | 'white' | 'black';
+export type PayPalButtonStyle = {
+    color: {
+        light: PayPalButtonColor;
+        dark?: PayPalButtonColor;
+    };
+};
+export declare const PAYPAL_BUTTON_MIN_HEIGHT = 25;
+export declare const PAYPAL_BUTTON_MAX_HEIGHT = 55;
+export declare const PAYPAL_BUTTON_DEFAULT_HEIGHT = 45;
+export declare const PAYPAL_BUTTON_DEFAULT_RADIUS = 4;
+/**
+ * Base `own` styles to merge under the layout's own styles (with
+ * mergeStylesWithDefaults), so the defaults sit in the normal style cascade:
+ * layout breakpoints, pseudo-states and conditional transitions override them
+ * only where they apply.
+ */
+export declare const PAYPAL_BUTTON_DEFAULT_OWN_STYLES: {
+    readonly dimension: {
+        readonly height: {
+            readonly type: "fixed";
+            readonly value: 45;
+        };
+    };
+    readonly border: {
+        readonly borderRadius: 4;
+    };
+};
+/**
+ * Structural shape of the `own` style hints this module reads, declared
+ * structurally so any schema node with `own` styles can pass itself.
+ */
+export type PayPalButtonStyleSource = {
+    styles?: {
+        elements?: {
+            own?: ReadonlyArray<{
+                default?: {
+                    background?: {
+                        backgroundColor?: ThemeColor | null;
+                    } | null;
+                } | null;
+            } | null> | null;
+        } | null;
+    } | null;
+};
+/**
+ * Derives the PayPal button color from the schema's `own` default styles.
+ * The background color picks gold, blue, silver, white or black by exact PayPal
+ * hex (#RGB, #RRGGBB, or alpha-first #ARGB / #AARRGGBB when fully opaque);
+ * anything else falls back to gold, PayPal's recommended color. A `dark` value
+ * applies in dark mode. Colors are brand-locked, so breakpoint blocks merge
+ * with last-non-null-wins, as for Apple Pay.
+ *
+ * Height and border radius are not derived: they stay in the layout's own
+ * class, merged over PAYPAL_BUTTON_DEFAULT_OWN_STYLES, and PayPalButton only
+ * bounds the height to PayPal's 25-55px range.
+ */
+export declare function derivePayPalButtonStyle(schema: PayPalButtonStyleSource): PayPalButtonStyle;
+type PayPalButtonProps = {
+    buttonStyle?: PayPalButtonStyle;
+    ariaLabel?: string;
+    className?: string;
+    disabled?: boolean;
+    onClick?: React.MouseEventHandler<HTMLButtonElement>;
+    tabIndex?: number;
+    testId?: string;
+};
+export declare const PayPalButton: React.ForwardRefExoticComponent<PayPalButtonProps & React.RefAttributes<HTMLButtonElement>>;
+export {};

package/dist/libraries/dcui-components/src/components/paypal-button/paypal-wordmark.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+/**
+ * PLACEHOLDER wordmark. Replace with the official PayPal wordmark SVG from
+ * PayPal's Logo and Marks resources once PayPal confirms the asset for this
+ * integration. Keep the two fills driven by the CSS variables below so the
+ * blue (light buttons) and white (dark buttons) variants keep working.
+ */
+export declare function PayPalWordmark(): React.JSX.Element;

package/dist/libraries/dcui-components/src/contexts/data-mapper-context.d.ts

@@ -1,20 +1,24 @@
 export declare const DataMapperContext: import("react").Context<{
     (template: string): string;
     (stateObj: import("..").StateOnlyObject, namespace?: string): /*elided*/ any;
+    (attributeObj: import("..").AttributeOnlyObject, namespace?: string): /*elided*/ any;
     (dataObj: import("..").DataObject, namespace: string): /*elided*/ any;
 }>;
 export declare const DataMapperConsumer: import("react").Consumer<{
     (template: string): string;
     (stateObj: import("..").StateOnlyObject, namespace?: string): /*elided*/ any;
+    (attributeObj: import("..").AttributeOnlyObject, namespace?: string): /*elided*/ any;
     (dataObj: import("..").DataObject, namespace: string): /*elided*/ any;
 }>;
 export declare const DataMapperProvider: import("react").Provider<{
     (template: string): string;
     (stateObj: import("..").StateOnlyObject, namespace?: string): /*elided*/ any;
+    (attributeObj: import("..").AttributeOnlyObject, namespace?: string): /*elided*/ any;
     (dataObj: import("..").DataObject, namespace: string): /*elided*/ any;
 }>;
 export declare const useDataMapper: () => {
     (template: string): string;
     (stateObj: import("..").StateOnlyObject, namespace?: string): /*elided*/ any;
+    (attributeObj: import("..").AttributeOnlyObject, namespace?: string): /*elided*/ any;
     (dataObj: import("..").DataObject, namespace: string): /*elided*/ any;
 };

package/dist/libraries/dcui-components/src/contexts/index.d.ts

@@ -3,6 +3,7 @@ export * from './global-state-context';
 export * from './node-mapper-context';
 export * from './root-element-context';
 export * from './offer-data-context';
+export * from './lead-capture-offer-context';
 export * from './data-mapper-context';
 export * from './scoped-style-mapper-context';
 export * from './layout-schema-type-context';

package/dist/libraries/dcui-components/src/contexts/lead-capture-offer-context.d.ts

@@ -0,0 +1,5 @@
+import { PluginOffer } from '../../../domain/src/models';
+/** Resolves the offer whose referral response a lead form belongs to. */
+export type LeadCaptureOfferResolver = (offerPositionIndex?: number) => PluginOffer | undefined;
+export declare const LeadCaptureOfferContext: import("react").Context<LeadCaptureOfferResolver>;
+export declare const useLeadCaptureOffer: () => LeadCaptureOfferResolver;

package/dist/libraries/dcui-components/src/contexts/validators/validator-provider.d.ts

@@ -1,14 +1,16 @@
-import { ReactNode } from 'react';
+import { ReactNode, RefObject } from 'react';
 export type Validator = () => boolean;
 export interface ValidatorFieldData {
     validators: Validator[];
     isValid: boolean;
+    element?: HTMLElement;
 }
 export type ValidatorMap = Record<string, ValidatorFieldData>;
 export interface ValidatorContextType {
-    registerValidators: (validatorFieldKey: string, validators: Validator[]) => void;
+    registerValidators: (validatorFieldKey: string, validators: Validator[], element?: HTMLElement) => void;
     validateFieldKeys: (validatorFieldKey: string[]) => boolean;
     getFieldKeyValidity: (validatorFieldKey: string) => boolean;
+    focusFirstInvalidField?: () => void;
 }
 export declare const ValidatorContext: import("react").Context<ValidatorContextType | null>;
 /**
@@ -21,4 +23,4 @@ export declare function ValidatorProvider(props: {
     children: ReactNode;
 }): import("react").JSX.Element;
 export declare function useValidator(): ValidatorContextType;
-export declare function useRegisterValidators(validationFieldKey: string | undefined, validators: Validator[]): void;
+export declare function useRegisterValidators(validationFieldKey: string | undefined, validators: Validator[], targetRef?: RefObject<HTMLElement | null>): void;

package/dist/libraries/dcui-components/src/failure-codes.d.ts

@@ -5,3 +5,4 @@ export declare const FAILED_TEMPLATING_DATA = "FAILED_TEMPLATING_DATA";
 export declare const FAILED_TO_MAP_STATIC_DATA = "FAILED_TO_MAP_STATIC_DATA";
 export declare const FAILED_SANITISING_HTML = "FAILED_SANITISING_HTML";
 export declare const UNRESOLVED_FORM_VALIDATION_TARGET = "UNRESOLVED_FORM_VALIDATION_TARGET";
+export declare const MISSING_LEAD_IDENTITY = "MISSING_LEAD_IDENTITY";

package/dist/libraries/domain/src/behaviors/continuous-child.d.ts

@@ -0,0 +1,59 @@
+import { LinkOpenTarget } from '@rokt/dcui-layout-schema';
+import { PluginChildLayoutModel } from '../models';
+/** Deliberately off until measurement and the SDK persistence proof are approved. */
+export declare const CONTINUOUS_CHILD_CAPABILITY_ENABLED = false;
+export declare const CONTINUOUS_CHILD_VERSION = 1;
+export declare const CONTINUOUS_CHILD_EVENTS: {
+    readonly READY: "CONTINUOUS_CHILD/READY";
+    readonly PRESENTATION: "CONTINUOUS_CHILD/PRESENTATION";
+    readonly APPLIED: "CONTINUOUS_CHILD/APPLIED";
+    readonly REQUEST: "CONTINUOUS_CHILD/REQUEST";
+    readonly EXPOSURE: "CONTINUOUS_CHILD/EXPOSURE";
+};
+/** Temporary additive types until the stable schema package is published. */
+export type ContinuousChildSchema = PluginChildLayoutModel['childLayoutSchema'] & {
+    continuationKey?: string | null;
+    ownsViewability?: boolean | null;
+};
+export interface ContinuousIdentity {
+    sessionId: string;
+    revision: number;
+    position: number;
+    creativeInstanceGuid: string;
+    childInstanceGuid: string;
+}
+export interface ContinuousPresentationInput {
+    config: PluginChildLayoutModel;
+    position: number;
+    ownsViewability: boolean;
+}
+export interface ContinuousPresentation extends ContinuousPresentationInput {
+    identity: ContinuousIdentity;
+    totalCount: number;
+}
+export interface ContinuousRequest {
+    identity: ContinuousIdentity;
+    actionId: string;
+    openLinks?: LinkOpenTarget;
+    action: 'next' | 'previous' | 'positive' | 'negative' | 'close';
+}
+export interface ContinuousExposure {
+    identity: ContinuousIdentity;
+    kind: 'rendered' | 'qualified';
+    inferred: boolean;
+    supportedByBrowser: boolean;
+}
+export declare const continuousEnvelope: <T>(payload: T) => {
+    version: number;
+    payload: T;
+};
+export declare function isContinuousEnvelope(value: unknown): value is {
+    version: 1;
+    payload: unknown;
+};
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function isContinuousIdentity(value: unknown): value is ContinuousIdentity;
+export declare function sameContinuousIdentity(a: ContinuousIdentity, b: ContinuousIdentity): boolean;
+export declare function isContinuousRequest(value: unknown): value is ContinuousRequest;
+export declare function isContinuousExposure(value: unknown): value is ContinuousExposure;
+export declare function isContinuousPresentation(value: unknown): value is ContinuousPresentation;

package/dist/libraries/domain/src/behaviors/custom-states.d.ts

@@ -17,7 +17,7 @@ export declare function isValidSetCustomStatePayload(payload: unknown): payload
 export declare const DEVICE_PAY_PROCESSING_STATE_KEY = "ProcessingState";
 export declare const DEVICE_PAY_PROCESSING_IDLE = 0;
 export declare const DEVICE_PAY_PROCESSING_IN_FLIGHT = 1;
-export declare const DEVICE_PAY_AVAILABILITY_KEYS: readonly ["applePay", "afterpay"];
+export declare const DEVICE_PAY_AVAILABILITY_KEYS: readonly ["applePay", "afterpay", "paypal"];
 export type DevicePayProviderKey = (typeof DEVICE_PAY_AVAILABILITY_KEYS)[number];
 export declare const DEVICE_PAY_APPLE_PAY_AVAILABLE_STATE_KEY = "applePayAvailable";
 export declare const DEVICE_PAY_ERROR_STATE_KEY = "DevicePayErrorState";

package/dist/libraries/domain/src/behaviors/index.d.ts

@@ -18,3 +18,4 @@ export * from './dismiss-overlay';
 export * from './trigger-action';
 export * from './form-state';
 export * from './report-error';
+export * from './continuous-child';

package/dist/libraries/domain/src/behaviors/offer-engagement.d.ts

@@ -14,10 +14,12 @@ export interface OfferEngagementFulfillmentPayload {
     fulfillment: Fulfillment;
     accountID: string;
     referralCreativeID?: string;
+    adID?: string;
 }
 export interface OfferEngagementUrlPayload extends PluginCreativeUrlResponseOption {
     accountID: string;
     referralCreativeID?: string;
+    adID?: string;
     creativeInstanceGuid?: string;
 }
 export interface OfferEngagementProductItemResponsePayload extends OfferEngagementUrlPayload {
@@ -44,6 +46,15 @@ export declare function isRealTimeReferralOnly(response: OfferEngagementPayload
 })): response is OfferEngagementPayload & {
     accountID: string;
     referralCreativeID: string;
+    adID?: string;
+};
+/**
+ * `adID` is the key the Web SDK's realtime-conversion-promotion extension reads.
+ * Anything but a non-empty string yields no key, so a payload or event without
+ * an ad id keeps exactly the keys it had before.
+ */
+export declare function adIDField(adID: string | undefined): {
+    adID?: string;
 };
 export declare function makeCaptureOnlyOfferEngagementPayload(offerPayload?: Partial<OfferEngagementCaptureOnlyPayload>): OfferEngagementCaptureOnlyPayload;
 export declare function makeUrlOfferEngagementPayload(offerPayload?: Partial<OfferEngagementUrlPayload>): OfferEngagementUrlPayload;

package/dist/libraries/domain/src/behaviors/send-partner.d.ts

@@ -14,6 +14,7 @@ export type OutboundRealtimeOfferFulfillmentReferralEventPayload = {
         rclid: string;
         accountID: string;
         referralCreativeID: string;
+        adID?: string;
         referralOnly?: boolean;
         rewardHandoff?: boolean;
     };
@@ -24,6 +25,7 @@ export type OutboundRealtimeOfferFulfillmentConversionEventPayload = {
         rclid: string;
         accountID: string;
         referralCreativeID: string;
+        adID?: string;
         rewardHandoff?: boolean;
     };
 };
@@ -80,10 +82,20 @@ export type OutboundAbortDevicePayEventPayload = {
 export type OutboundCompleteDevicePayEventPayload = {
     name: 'COMPLETE_DEVICE_PAY_EVENT';
 };
-export type OutboundPartnerEventPayload<EventType extends OutboundPartnerEvent> = EventType extends 'REALTIME_OFFER_FULFILLMENT_REFERRAL' ? OutboundRealtimeOfferFulfillmentReferralEventPayload : EventType extends 'REALTIME_OFFER_FULFILLMENT_CONVERSION' ? OutboundRealtimeOfferFulfillmentConversionEventPayload : EventType extends 'REALTIME_OFFER_FULFILLMENT_SUCCESS' ? OutboundRealtimeOfferFulfillmentSuccessEventPayload : EventType extends 'V2_CART_ITEM_UPDATED' | 'UPDATE_CART_ITEM_MESSAGE' | 'CART_ITEM_INSTANT_PURCHASE' | 'UPSELL_ITEM_INSTANT_PURCHASE' | 'UPSELL_CREATIVE_SENT' | 'INITIATE_INSTANT_PURCHASE_EVENT' | 'INSTANT_PURCHASE_INITIATE_TAX_AND_SHIPPING_EVENT' | 'INITIATE_CART_ITEM_EVENT' | 'DELIVERY_DETAILS_SENT' | 'PREPARE_DEVICE_PAY_EVENT' | 'INITIATE_DEVICE_PAY_EVENT' | 'ABORT_DEVICE_PAY_EVENT' | 'COMPLETE_DEVICE_PAY_EVENT' ? never : {
+export type OutboundLeadCaptureSubmittedEventPayload = {
+    name: 'LEAD_CAPTURE_SUBMITTED';
+    body: {
+        email?: string;
+        mobile_number?: string;
+        rclid?: string;
+        accountID?: string;
+        referralCreativeID?: string;
+    };
+};
+export type OutboundPartnerEventPayload<EventType extends OutboundPartnerEvent> = EventType extends 'LEAD_CAPTURE_SUBMITTED' ? OutboundLeadCaptureSubmittedEventPayload : EventType extends 'REALTIME_OFFER_FULFILLMENT_REFERRAL' ? OutboundRealtimeOfferFulfillmentReferralEventPayload : EventType extends 'REALTIME_OFFER_FULFILLMENT_CONVERSION' ? OutboundRealtimeOfferFulfillmentConversionEventPayload : EventType extends 'REALTIME_OFFER_FULFILLMENT_SUCCESS' ? OutboundRealtimeOfferFulfillmentSuccessEventPayload : EventType extends 'V2_CART_ITEM_UPDATED' | 'UPDATE_CART_ITEM_MESSAGE' | 'CART_ITEM_INSTANT_PURCHASE' | 'UPSELL_ITEM_INSTANT_PURCHASE' | 'UPSELL_CREATIVE_SENT' | 'INITIATE_INSTANT_PURCHASE_EVENT' | 'INSTANT_PURCHASE_INITIATE_TAX_AND_SHIPPING_EVENT' | 'INITIATE_CART_ITEM_EVENT' | 'DELIVERY_DETAILS_SENT' | 'PREPARE_DEVICE_PAY_EVENT' | 'INITIATE_DEVICE_PAY_EVENT' | 'ABORT_DEVICE_PAY_EVENT' | 'COMPLETE_DEVICE_PAY_EVENT' ? never : {
     name: EventType;
 };
 export type SendPartner<EventType extends OutboundPartnerEvent> = {
     type: typeof SEND_PARTNER;
-    payload: OutboundPartnerEventPayload<EventType> | OutboundUpdateCartEventPayload | OutboundUpdateCartItemMessageEventPayload | OutboundInstantPurchaseEventPayload | OutboundUpsellItemInstantPurchaseEventPayload | OutboundUpsellCreativeSentEventPayload | OutboundInstantPurchaseWsdkEventPayload | OutboundInstantPurchaseTaxAndShippingEventPayload | OutboundCartItemEventPayload | OutboundDeliveryDetailsSentEventPayload | OutboundPrepareDevicePayEventPayload | OutboundDevicePayEventPayload | OutboundAbortDevicePayEventPayload | OutboundCompleteDevicePayEventPayload;
+    payload: OutboundPartnerEventPayload<EventType> | OutboundUpdateCartEventPayload | OutboundUpdateCartItemMessageEventPayload | OutboundInstantPurchaseEventPayload | OutboundUpsellItemInstantPurchaseEventPayload | OutboundUpsellCreativeSentEventPayload | OutboundInstantPurchaseWsdkEventPayload | OutboundInstantPurchaseTaxAndShippingEventPayload | OutboundCartItemEventPayload | OutboundDeliveryDetailsSentEventPayload | OutboundPrepareDevicePayEventPayload | OutboundDevicePayEventPayload | OutboundAbortDevicePayEventPayload | OutboundCompleteDevicePayEventPayload | OutboundLeadCaptureSubmittedEventPayload;
 };

package/dist/libraries/domain/src/behaviors/trigger-action.d.ts

@@ -1,14 +1,14 @@
-import { LayoutAction, LayoutVariantAction, OuterLayoutAction } from '@rokt/dcui-layout-schema';
+import { ChildLayoutAction, LayoutAction, LayoutVariantAction, OuterLayoutAction } from '@rokt/dcui-layout-schema';
 import { PluginOffer } from '../models';
 export declare const TRIGGER_ACTION = "GLOBAL/TRIGGER_ACTION";
 /**
  * Actions a trigger (e.g. a layout timer or button) can carry. A trigger may
- * originate in any of the three layout contexts, so the channel accepts the
+ * originate in any of the four layout contexts, so the channel accepts the
  * union of all their action sets rather than assuming one stays a superset of
  * the others. This keeps producers in every context assignable even if the
  * sets diverge in future schema versions.
  */
-export type TriggerableAction = LayoutAction | OuterLayoutAction | LayoutVariantAction;
+export type TriggerableAction = LayoutAction | OuterLayoutAction | LayoutVariantAction | ChildLayoutAction;
 export interface TriggerAction {
     type: typeof TRIGGER_ACTION;
     payload: {

package/dist/libraries/domain/src/models/child-layout-response.d.ts

@@ -0,0 +1,4 @@
+import { PluginOffer } from './plugin/plugin-offer';
+import { PluginCreativeUrlResponseOption } from './plugin/plugin-creative-response-option';
+/** Child acceptance supports ordinary positive URLs, not deferred fulfillment. */
+export declare function getChildPositiveResponse(offer: PluginOffer | null, responseKey: string): PluginCreativeUrlResponseOption | undefined;

package/dist/libraries/domain/src/models/index.d.ts

@@ -14,3 +14,4 @@ export * from './interactivity';
 export * from './child-plugin';
 export * from './purchase';
 export * from './shipping';
+export * from './child-layout-response';

package/dist/libraries/domain/src/models/layout/layout-offer.d.ts

@@ -4,6 +4,8 @@ import { LayoutTransactionData } from './layout-transaction-data';
 export interface LayoutOffer {
     campaignId: string;
     accountId: string;
+    /** The rendered ad's id; absent until the transactions API sends it. */
+    adId?: string;
     maxTotalItemsQtyInOffer: number;
     creative: LayoutCreative;
     metadata: Record<string, string>;

package/dist/libraries/domain/src/models/partner-event.d.ts

@@ -1,5 +1,5 @@
 export type CatalogOutboundPartnerEvent = 'V2_CART_ITEM_UPDATED' | 'UPDATE_CART_ITEM_MESSAGE' | 'CART_ITEM_INSTANT_PURCHASE' | 'UPSELL_ITEM_INSTANT_PURCHASE' | 'DELIVERY_DETAILS_SENT';
-export type OfferOutboundPartnerEvent = CatalogOutboundPartnerEvent | 'OFFER_ENGAGEMENT' | 'POSITIVE_ENGAGEMENT' | 'UPSELL_CREATIVE_SENT' | 'REALTIME_OFFER_FULFILLMENT_REFERRAL' | 'REALTIME_OFFER_FULFILLMENT_CONVERSION' | 'REALTIME_OFFER_FULFILLMENT_SUCCESS' | 'INITIATE_INSTANT_PURCHASE_EVENT' | 'INSTANT_PURCHASE_INITIATE_TAX_AND_SHIPPING_EVENT' | 'INITIATE_CART_ITEM_EVENT' | 'PREPARE_DEVICE_PAY_EVENT' | 'INITIATE_DEVICE_PAY_EVENT' | 'ABORT_DEVICE_PAY_EVENT' | 'COMPLETE_DEVICE_PAY_EVENT';
+export type OfferOutboundPartnerEvent = CatalogOutboundPartnerEvent | 'OFFER_ENGAGEMENT' | 'POSITIVE_ENGAGEMENT' | 'UPSELL_CREATIVE_SENT' | 'REALTIME_OFFER_FULFILLMENT_REFERRAL' | 'REALTIME_OFFER_FULFILLMENT_CONVERSION' | 'REALTIME_OFFER_FULFILLMENT_SUCCESS' | 'INITIATE_INSTANT_PURCHASE_EVENT' | 'INSTANT_PURCHASE_INITIATE_TAX_AND_SHIPPING_EVENT' | 'INITIATE_CART_ITEM_EVENT' | 'PREPARE_DEVICE_PAY_EVENT' | 'INITIATE_DEVICE_PAY_EVENT' | 'ABORT_DEVICE_PAY_EVENT' | 'COMPLETE_DEVICE_PAY_EVENT' | 'LEAD_CAPTURE_SUBMITTED';
 export type OutboundPartnerEvent = OfferOutboundPartnerEvent | 'PLACEMENT_CLOSED' | 'PLACEMENT_COMPLETED' | 'PLACEMENT_INTERACTIVE' | 'PLACEMENT_FAILURE';
 export declare function isOutboundPartnerEvent(value: unknown): value is OutboundPartnerEvent;
 export declare function isOfferOutboundPartnerEvent(value: unknown): value is OfferOutboundPartnerEvent;

package/dist/libraries/domain/src/models/plugin/plugin-child-layout-model.d.ts

@@ -3,6 +3,7 @@ import { Fonts } from '@rokt/plugin';
 import { SyncedGlobalState } from '../global-state';
 import { PluginOffer } from './plugin-offer';
 export interface PluginChildLayoutModel<ChildRootLayoutSchema = ChildRootSchemaModel<LayoutSchemaModel, LayoutDisplayPreset, LayoutSettings, WhenPredicate>> {
+    continuousPresentation?: import('../../behaviors/continuous-child').ContinuousIdentity;
     instanceGuid: string;
     childLayoutId: string;
     layoutSchemaVersion: string;

package/dist/libraries/domain/src/models/plugin/plugin-offer.d.ts

@@ -5,6 +5,8 @@ import { TransactionData } from './plugin-transaction-data';
 export interface PluginOffer {
     campaignId: string;
     accountId: string;
+    /** The rendered ad's id; absent until the transactions API sends it. */
+    adId?: string;
     maxTotalItemsQtyInOffer: number;
     creative: PluginCreative;
     metadata: Record<string, string>;

package/dist/libraries/layout-renderer-utils/src/actions/attributes.d.ts

@@ -0,0 +1,7 @@
+import { AttributesState } from '../models';
+export declare const SET_ATTRIBUTES = "ATTRIBUTES/SET";
+export type SetAttributesAction = {
+    type: typeof SET_ATTRIBUTES;
+    payload: AttributesState;
+};
+export type AttributesActions = SetAttributesAction;

package/dist/libraries/layout-renderer-utils/src/actions/index.d.ts

@@ -1,6 +1,7 @@
 import { OpenLink, PrepareSignal, RaiseMetric, RaiseSignal, SendPartner, SetDomainState } from '../../../domain/src/behaviors';
 import { ActiveStateActions } from './active';
 import { BreakpointActions, SetBreakpoints } from './breakpoint';
+import { AttributesActions } from './attributes';
 import { FontsActions } from './fonts';
 import { LayoutActions } from './layout';
 import { ClosePlugin } from './plugin';
@@ -25,16 +26,18 @@ export * from './error';
 export * from './log';
 export * from './overlay';
 export * from './plugin';
+export * from './attributes';
 export * from './custom-states';
 export * from './domain-states';
 export * from './form-states';
-export type CoreStateActions = LayoutActions | BreakpointActions | ActiveStateActions | FontsActions | SignalStateActions | SerializableCacheActions | SettingsActions | CustomStatesActions | SetDomainStateReducer | LayoutEventAction | FormStatesActions;
+export type CoreStateActions = LayoutActions | BreakpointActions | ActiveStateActions | AttributesActions | FontsActions | SignalStateActions | SerializableCacheActions | SettingsActions | CustomStatesActions | SetDomainStateReducer | LayoutEventAction | FormStatesActions;
 export declare const coreStateActionTypes: {
     readonly LAYOUT_UPDATE: "LAYOUT/UPDATE";
     readonly UPDATE_ACTIVE_BREAKPOINT: "BREAKPOINT/UPDATE_ACTIVE";
     readonly INITIALISE_BREAKPOINT: "BREAKPOINT/INITIALISE";
     readonly ACTIVE_ADD: "ACTIVE/ADD";
     readonly ACTIVE_DELETE: "ACTIVE/DELETE";
+    readonly SET_ATTRIBUTES: "ATTRIBUTES/SET";
     readonly SET_FONTS: "FONTS/SET";
     readonly QUEUE_SIGNAL: "SIGNAL/QUEUE";
     readonly SIGNAL_PROCESSED: "SIGNAL/PROCESSED";

package/dist/libraries/layout-renderer-utils/src/models/state/attributes.d.ts

@@ -0,0 +1,2 @@
+import { NormalizedAttributes } from '@rokt/plugin/interface/attributes';
+export type AttributesState = NormalizedAttributes;

package/dist/libraries/layout-renderer-utils/src/models/state/index.d.ts

@@ -1,4 +1,5 @@
 import { ActiveState } from './active';
+import { AttributesState } from './attributes';
 import { BreakpointState } from './breakpoint';
 import { FontsState } from './fonts';
 import { LayoutState } from './layout';
@@ -9,6 +10,7 @@ import { CustomStatesIndexState } from './custom-states';
 import { FiredEventsIndexState } from './fired-events';
 import { FormStatesIndexState } from './form-states';
 export * from './active';
+export * from './attributes';
 export * from './breakpoint';
 export * from './fonts';
 export * from './layout';
@@ -22,6 +24,7 @@ export type CoreAppState = {
     layout: LayoutState;
     breakpoint: BreakpointState;
     active: ActiveState;
+    attributes: AttributesState;
     fonts: FontsState;
     signal: SignalState;
     serializableCache: SerializableCacheState;

package/dist/libraries/layout-renderer-utils/src/reducers/attributes/index.d.ts

@@ -0,0 +1 @@
+export * from './reducer';

package/dist/libraries/layout-renderer-utils/src/reducers/attributes/reducer.d.ts

@@ -0,0 +1,4 @@
+import { AnyAction } from '@reduxjs/toolkit';
+import { AttributesState } from '../../models';
+export declare function makeInitialAttributesState(): AttributesState;
+export declare function attributesReducer(state: AttributesState | undefined, action: AnyAction): AttributesState;

package/dist/libraries/layout-renderer-utils/src/reducers/index.d.ts

@@ -2,6 +2,7 @@ import { CoreAppState } from '../models';
 import { breakpointReducer } from './breakpoint';
 import { layoutReducer } from './layout';
 import { activeReducer } from './active';
+import { attributesReducer } from './attributes';
 import { fontsReducer } from './fonts';
 import { signalReducer } from './signal';
 import { serializableCacheReducer } from './serializable-cache';
@@ -12,6 +13,7 @@ import { formStatesReducer } from './form-states';
 export * from './breakpoint';
 export * from './layout';
 export * from './active';
+export * from './attributes';
 export * from './fonts';
 export * from './signal';
 export * from './serializable-cache';
@@ -23,6 +25,7 @@ export declare const coreAppReducers: {
     layout: typeof layoutReducer;
     breakpoint: typeof breakpointReducer;
     active: typeof activeReducer;
+    attributes: typeof attributesReducer;
     fonts: typeof fontsReducer;
     signal: typeof signalReducer;
     serializableCache: typeof serializableCacheReducer;

package/dist/libraries/layout-renderer-utils/src/sagas/plugin/channels.d.ts

@@ -1,5 +1,5 @@
 import { EventChannel } from 'redux-saga';
 import { ThemeInterface } from '@rokt/plugin';
-import { ConfigService } from '../../../../plugin-utils/src/index';
-import { HandleConfigAction, SetFontsAction } from '../../actions';
-export declare function makeWsdkChannel<LayoutModelType, PluginModelType>(configService: ConfigService<LayoutModelType>, themeService: ThemeInterface, transformRawConfig: (config: LayoutModelType) => PluginModelType | undefined): EventChannel<HandleConfigAction<PluginModelType> | SetFontsAction>;
+import { AttributesService, ConfigService } from '../../../../plugin-utils/src/index';
+import { HandleConfigAction, SetAttributesAction, SetFontsAction } from '../../actions';
+export declare function makeWsdkChannel<LayoutModelType, PluginModelType>(configService: ConfigService<LayoutModelType>, themeService: ThemeInterface, transformRawConfig: (config: LayoutModelType) => PluginModelType | undefined, attributesService?: AttributesService): EventChannel<HandleConfigAction<PluginModelType> | SetFontsAction | SetAttributesAction>;

package/dist/libraries/layout-renderer-utils/src/sagas/plugin/display.d.ts

@@ -19,6 +19,7 @@ export declare function getDisplaySettings(preset?: LayoutDisplayPreset | null,
         width: string;
     };
     css?: undefined;
+    lockHostScroll?: undefined;
 } | {
     autoresize: boolean;
     css: {
@@ -34,9 +35,11 @@ export declare function getDisplaySettings(preset?: LayoutDisplayPreset | null,
     replaceTargetElement?: undefined;
     outerCss?: undefined;
     innerCss?: undefined;
+    lockHostScroll?: undefined;
 } | {
     autoresize: boolean;
     applyHighestZIndex: boolean;
+    lockHostScroll: boolean;
     replaceTargetElement: string;
     css: {
         zIndex?: number | undefined;

package/dist/libraries/layout-renderer-utils/src/sagas/plugin/sagas.d.ts

@@ -1,11 +1,14 @@
 import { CallEffect, PutEffect, SelectEffect } from '@redux-saga/core/effects';
+import { OutboundPartnerEvent } from '../../../../domain/src/models';
+import { SendPartner } from '../../../../domain/src/behaviors';
 import { FrameControls, LayoutDisplayPreset } from '@rokt/dcui-layout-schema';
 import { RaceEffect } from 'redux-saga/effects';
-import { ContextService, DisplayService, PluginService } from '../../../../plugin-utils/src/index';
+import { ContextService, DisplayService, PartnerInteractionService, PluginService } from '../../../../plugin-utils/src/index';
 import { HandleConfigAction, ReportError } from '../../actions';
 import { EventChannel } from 'redux-saga';
 export declare function closePlugin(contextService: ContextService): Generator<RaceEffect<CallEffect | Generator<SelectEffect | CallEffect, void, boolean>> | SelectEffect | CallEffect | Generator<SelectEffect | CallEffect, void, boolean> | PutEffect<ReportError>, void, boolean>;
-export declare function listenToWsdkChannel<LayoutModelType, PluginModelType>(pluginService: PluginService<LayoutModelType>, transformRawConfig: (config: LayoutModelType) => PluginModelType | undefined): Generator<PutEffect<ReportError> | CallEffect<EventChannel<import("../../../../orchestrator/src/actions").SetFontsAction | HandleConfigAction<PluginModelType>>> | import("redux-saga/effects").ChannelTakeEffect<HandleConfigAction<PluginModelType>> | PutEffect<HandleConfigAction<PluginModelType>>, void, EventChannel<HandleConfigAction<PluginModelType>> & HandleConfigAction<PluginModelType>>;
+export declare function handlePartnerSend(partnerInteractionService: PartnerInteractionService, { payload }: SendPartner<OutboundPartnerEvent>): Generator<Promise<void>, void, void>;
+export declare function listenToWsdkChannel<LayoutModelType, PluginModelType>(pluginService: PluginService<LayoutModelType>, transformRawConfig: (config: LayoutModelType) => PluginModelType | undefined): Generator<PutEffect<ReportError> | CallEffect<EventChannel<import("../../../../orchestrator/src/actions").SetAttributesAction | import("../../../../orchestrator/src/actions").SetFontsAction | HandleConfigAction<PluginModelType>>> | import("redux-saga/effects").ChannelTakeEffect<HandleConfigAction<PluginModelType>> | PutEffect<HandleConfigAction<PluginModelType>>, void, EventChannel<HandleConfigAction<PluginModelType>> & HandleConfigAction<PluginModelType>>;
 export declare function wsdkSagas<LayoutModelType, PluginModelType>(pluginService: PluginService<LayoutModelType>, transformRawConfig: (config: LayoutModelType) => PluginModelType | undefined): Generator<import("redux-saga/effects").AllEffect<import("redux-saga/effects").ForkEffect<void>>, void, unknown>;
 export declare function displayPlugin(displayService: DisplayService, preset?: LayoutDisplayPreset | null, controls?: FrameControls | null): Generator<CallEffect<void> | import("redux-saga/effects").ForkEffect<void> | PutEffect<{
     type: "ACTIVE/ADD";

package/dist/libraries/module-connector/src/main.d.ts

@@ -1,6 +1,6 @@
 export { ModuleAttributes } from './models/module-attributes';
 export { ModuleConnectorBuilder, AppSettings, } from './models/module-connector-builder';
-export { IGateway, IDisposable, Gateway, GetFonts, GatewayFactory, ActionInterceptor, EmptyGateway, GlobalGateway, GlobalGatewayFactory, makeGatewayFactory, ModuleEventListener, } from './models/gateway';
+export { IGateway, ContinuousGatewayService, IDisposable, Gateway, GetFonts, GatewayFactory, ActionInterceptor, EmptyGateway, GlobalGateway, GlobalGatewayFactory, makeGatewayFactory, ModuleEventListener, } from './models/gateway';
 export * from './models/module';
 export { AbstractStore } from './models/abstract-store';
 export { AbstractGlobalStore, GlobalStoreOfferContext, } from './models/abstract-global-store';

package/dist/libraries/module-connector/src/models/gateway.d.ts

@@ -1,4 +1,4 @@
-import { GlobalState, Interactivity } from '../../../domain/src/models';
+import { GlobalState, Interactivity, PluginLayoutChild } from '../../../domain/src/models';
 import { GlobalActions } from '../../../domain/src/behaviors';
 import { ChildPluginFactoryInterface, Fonts, PartnerInteractionInterface } from '@rokt/plugin';
 import { Subscriber } from '@rokt/plugin/interface/subscriber';
@@ -10,6 +10,11 @@ export type ChildPluginFactoryOptions = Parameters<ChildPluginFactory>[0];
 export type GetFonts = () => Fonts;
 export type GatewayFactory<State extends object, Action extends object> = (offerContext: GlobalStoreOfferContext, interactivityChannel: ISubscribable<Interactivity> & IClearable) => IGateway<State, Action> & IDisposable;
 export type ActionInterceptor<Action extends object> = (action: Action) => Action | undefined;
+/** Trusted parent services; the gateway binds the module's served offer identity. */
+export interface ContinuousGatewayService {
+    register(context: GlobalStoreOfferContext, dispatch: (action: GlobalActions) => void): () => void;
+    launch(context: GlobalStoreOfferContext, child: PluginLayoutChild): Promise<boolean>;
+}
 export type ModuleEventListener = {
     name: string;
     source: 'partner' | '*';
@@ -21,14 +26,20 @@ export interface IGateway<State extends object, Action extends object> {
     onInteractivityChange(callback: (interactivity: Interactivity) => void): () => void;
     globalDispatch(action: Action): void;
     createChildPlugin: ChildPluginFactory;
+    registerContinuousResponseHandler?: (dispatch: (action: GlobalActions) => void) => () => void;
+    launchContinuousChild?: (child: PluginLayoutChild) => Promise<boolean>;
+    scrollHostToViewportOffset?: (viewportOffsetY: number) => Promise<void>;
 }
 export interface IDisposable {
     dispose(): void;
 }
-export declare function makeGatewayFactory<State extends object, Action extends object>(globalStore: AbstractGlobalStore<State, Action>, createChildPlugin: ChildPluginFactory, onPartnerEvent: PartnerEventReceiver, getFonts?: GetFonts): GatewayFactory<State, Action>;
+export declare function makeGatewayFactory<State extends object, Action extends object>(globalStore: AbstractGlobalStore<State, Action>, createChildPlugin: ChildPluginFactory, onPartnerEvent: PartnerEventReceiver, getFonts?: GetFonts, scrollHostToViewportOffset?: (viewportOffsetY: number) => Promise<void>, continuous?: ContinuousGatewayService): GatewayFactory<State, Action>;
 export declare class Gateway<State extends object, Action extends object> implements IGateway<State, Action>, IDisposable {
     #private;
-    constructor(store: AbstractGlobalStore<State, Action>, createChildPlugin: ChildPluginFactory, context: GlobalStoreOfferContext, interactivityChannel: ISubscribable<Interactivity> & IClearable, onPartnerEvent: PartnerEventReceiver, getFonts?: GetFonts);
+    scrollHostToViewportOffset?: (viewportOffsetY: number) => Promise<void>;
+    registerContinuousResponseHandler?: (dispatch: (action: GlobalActions) => void) => () => void;
+    launchContinuousChild?: (child: PluginLayoutChild) => Promise<boolean>;
+    constructor(store: AbstractGlobalStore<State, Action>, createChildPlugin: ChildPluginFactory, context: GlobalStoreOfferContext, interactivityChannel: ISubscribable<Interactivity> & IClearable, onPartnerEvent: PartnerEventReceiver, getFonts?: GetFonts, scrollHostToViewportOffset?: (viewportOffsetY: number) => Promise<void>, continuous?: ContinuousGatewayService);
     onGlobalStateChange(callback: (globalState: State) => void): () => void;
     onInteractivityChange(callback: (interactivity: Interactivity) => void): () => void;
     onEvent(...moduleEventListeners: Array<ModuleEventListener>): () => void;

package/dist/libraries/module-utils/src/sagas/child-layouts/sagas.d.ts

@@ -13,5 +13,7 @@ type BridgeChannelMessage = {
 export declare function childLayoutBridge(gateway: GlobalGateway, logger: (log: Log) => void, childPlugin: ChildPluginInterface<BasicObject>, offerContext: {
     offer: PluginOffer;
     offerPositionIndex: number | undefined;
+    childInstanceGuid: string;
+    advanceOnDismiss?: boolean;
 }): Generator<PutEffect | CallEffect | CancelledEffect | RaceEffect<ChannelTakeEffect<BridgeChannelMessage> | CallEffect>, void, never>;
 export {};