@rokt/dcui-orchestrator 1.2.1-rc.2 → 1.2.1-rc.21

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/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/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/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-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-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 {};

package/dist/libraries/orchestrator/src/actions/index.d.ts

@@ -36,6 +36,7 @@ export declare const stateActionTypes: {
     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/orchestrator/src/reducers/index.d.ts

@@ -14,6 +14,7 @@ export declare const appReducers: {
     layout: typeof import("../../../layout-renderer-utils/src/index").layoutReducer;
     breakpoint: typeof import("../../../layout-renderer-utils/src/index").breakpointReducer;
     active: typeof import("../../../layout-renderer-utils/src/index").activeReducer;
+    attributes: typeof import("../../../layout-renderer-utils/src/index").attributesReducer;
     fonts: typeof import("../../../layout-renderer-utils/src/index").fontsReducer;
     signal: typeof import("../../../layout-renderer-utils/src/index").signalReducer;
     serializableCache: typeof import("../../../layout-renderer-utils/src/index").serializableCacheReducer;

package/dist/libraries/plugin-utils/src/plugin-service/attributes.d.ts

@@ -0,0 +1,7 @@
+import { PluginInterface } from '@rokt/plugin';
+import { NormalizedAttributes } from '@rokt/plugin/interface/attributes';
+import { Callback, Unsubscriber } from '@rokt/plugin/interface/subscriber';
+export type AttributesService = {
+    subscribe(value?: Callback<[NormalizedAttributes]>, error?: Callback, complete?: Callback): Unsubscriber;
+};
+export declare const makeAttributesService: (pluginInterface: Pick<PluginInterface, "attributes">) => AttributesService;

package/dist/libraries/plugin-utils/src/plugin-service/index.d.ts

@@ -1,4 +1,5 @@
 import { ErrorInterface, PluginInterface, RDNInterface, ThemeInterface } from '@rokt/plugin';
+import { AttributesService } from './attributes';
 import { ContextService } from './context';
 import { MetricsService } from './metrics';
 import { DisplayService } from './display';
@@ -6,8 +7,9 @@ import { PartnerInteractionService } from './partner-interaction';
 import { ParentInteractionService } from './parent-interaction';
 import { ConfigService } from './config';
 import { ChildPluginService } from './child-plugin';
-export { ContextService, MetricsService, DisplayService, PartnerInteractionService, ParentInteractionService, ConfigService, ChildPluginService, };
+export { AttributesService, ContextService, MetricsService, DisplayService, PartnerInteractionService, ParentInteractionService, ConfigService, ChildPluginService, };
 export interface PluginService<T> {
+    attributesService: AttributesService;
     contextService: ContextService;
     configService: ConfigService<T>;
     partnerInteractionService: PartnerInteractionService;

package/dist/modules/instant-purchase/src/actions/catalog-selection.d.ts

@@ -6,10 +6,17 @@ export declare const TRIGGER_SELECT_ITEM = "CATALOG/TRIGGER_SELECT_ITEM";
 export type TriggerSelectItemAction = {
     type: typeof TRIGGER_SELECT_ITEM;
     payload: SetSelectedItemPayload;
+    preserveAttributeSelections?: boolean;
 };
 export declare const SET_SELECTED_ITEM = "CATALOG/SET_SELECTED_ITEM";
 export type SetSelectedItemAction = {
     type: typeof SET_SELECTED_ITEM;
     payload: SetSelectedItemPayload;
+    preserveAttributeSelections?: boolean;
 };
-export type CatalogSelectionActions = SetSelectedItemAction | TriggerSelectItemAction;
+export declare const SET_CATALOG_ATTRIBUTE_SELECTIONS = "CATALOG/SET_ATTRIBUTE_SELECTIONS";
+export type SetCatalogAttributeSelectionsAction = {
+    type: typeof SET_CATALOG_ATTRIBUTE_SELECTIONS;
+    payload: Record<string, string>;
+};
+export type CatalogSelectionActions = SetCatalogAttributeSelectionsAction | SetSelectedItemAction | TriggerSelectItemAction;

package/dist/modules/instant-purchase/src/actions/instant-purchase.d.ts

@@ -42,6 +42,7 @@ export interface PushTaxAndShippingPayload {
 }
 export interface MarkTaxAndShippingPendingPayload {
     cacheKey: string;
+    requestId: string;
 }
 export declare const INITIATE_INSTANT_PURCHASE = "INSTANT_PURCHASE/INITIATE";
 export type InitiateInstantPurchase = {

package/dist/modules/instant-purchase/src/components/catalog-selectors-stacked/catalog-selectors-stacked.d.ts

@@ -1,6 +1,36 @@
 import React from 'react';
 import { CatalogSelectorsStackedModel, LayoutSchemaModel, WhenPredicate } from '@rokt/dcui-layout-schema';
 export interface CatalogSelectorsStackedProps<Template extends LayoutSchemaModel> {
+    /**
+     *  - `default`: the template rendered once per variant dimension.
+     *    `CatalogDropdown` includes its own visible dimension label. Do not add a
+     *    separate label node. Each render also exposes tokens for custom content:
+     *    * `%^DATA.variantAttribute.attributeId^%`: the dimension id, e.g.
+     *      `color`. It comes from the merchant's variant option key and is
+     *      neither normalised nor guaranteed lowercase or single-word, so
+     *      `shoe_size` reaches the shopper verbatim. Apply casing with the node's
+     *      `text.textTransform` rather than transforming the value, so `When`
+     *      comparisons stay stable.
+     *    * `%^DATA.variantAttribute.hasMultipleOptions^%`: `"true"` or `"false"`.
+     *      `CatalogDropdown` renders neither label nor control for a single option,
+     *      and the whole template for that dimension is hidden, so it takes no
+     *      space in the stack.
+     *    Tokens from the enclosing scope stay resolvable alongside these.
+     *
+     *    Keep the dropdown mounted. A `When` that encloses it would stop it mounting, and
+     *    a dropdown that never mounts never registers its validator field key —
+     *    a trigger that then resolves zero keys fails closed, blocking the CTA
+     *    with nothing on screen to explain it.
+     *
+     *    Bind custom text with `BasicText`. `RichText` sends the value through the
+     *    HTML sanitiser, which throws on markup-shaped input; the node is then
+     *    dropped by its error boundary.
+     *  - `dropdown`: accepted by the layout schema, currently ignored — this
+     *    component only ever renders `default`.
+     *  - `styles`:
+     *    * `elements`:
+     *      - `own`
+     */
     schema: CatalogSelectorsStackedModel<Template, WhenPredicate>;
     testId?: string;
 }

package/dist/modules/instant-purchase/src/models/state/instant-purchase.d.ts

@@ -24,6 +24,7 @@ export interface TaxAndShippingData {
 }
 export interface TaxAndShippingEntry {
     isPending: boolean;
+    requestId?: string;
     taxAndShippingData?: TaxAndShippingData;
 }
 export interface TaxAndShippingState {

package/dist/modules/instant-purchase/src/reducers/catalog-selection/reducer.d.ts

@@ -1,4 +1,6 @@
 import { AnyAction } from '@reduxjs/toolkit';
 import { CatalogSelectionState } from '../../models/state/catalog-selection';
+export type CatalogAttributeSelectionsState = Record<string, string> | null;
+export declare const catalogAttributeSelectionsReducer: (state: CatalogAttributeSelectionsState | undefined, action: AnyAction) => CatalogAttributeSelectionsState;
 export declare function makeInitialCatalogSelectionState(): CatalogSelectionState;
 export declare const catalogReducer: (state: CatalogSelectionState | undefined, action: AnyAction) => CatalogSelectionState;

package/dist/modules/instant-purchase/src/reducers/index.d.ts

@@ -1,6 +1,7 @@
 import { GlobalActions } from '../../../../libraries/domain/src/behaviors';
 import { ChildLayoutActions, childLayoutsReducer, ChildLayoutsState, StaticData, staticDataReducer, DynamicData, dynamicDataReducer } from '../../../../libraries/module-utils/src/index';
 import { CatalogSelectionState, DevicePayAvailabilityState, FulfillmentDetailsState, OfferLifecycleEventState, TaxAndShippingState } from '../models';
+import { CatalogAttributeSelectionsState } from './catalog-selection/reducer';
 import { DevicePayRequestsState } from './device-pay-requests';
 import { PurchaseIdState } from './instant-purchase';
 import { PayPalTransactionDetailsState } from './paypal-transaction-details';
@@ -8,6 +9,7 @@ import { PayPalPurchaseContextState } from './paypal-purchase-context';
 export type AppState = {
     staticData: StaticData;
     selectedItem: CatalogSelectionState;
+    catalogAttributeSelections: CatalogAttributeSelectionsState;
     dynamicData: DynamicData;
     childLayouts: ChildLayoutsState;
     fulfillmentDetails: FulfillmentDetailsState;
@@ -23,6 +25,7 @@ export type StateActions = GlobalActions | ChildLayoutActions;
 export declare const appReducers: {
     staticData: typeof staticDataReducer;
     selectedItem: (state: CatalogSelectionState | undefined, action: import("redux").AnyAction) => CatalogSelectionState;
+    catalogAttributeSelections: (state: CatalogAttributeSelectionsState | undefined, action: import("redux").AnyAction) => CatalogAttributeSelectionsState;
     dynamicData: typeof dynamicDataReducer;
     childLayouts: typeof childLayoutsReducer;
     fulfillmentDetails: (state: FulfillmentDetailsState | undefined, action: import("redux").AnyAction) => FulfillmentDetailsState;

package/dist/modules/instant-purchase/src/sagas/tax-and-shipping/sagas.d.ts

@@ -1,5 +1,5 @@
 import { CallEffect, PutEffect, RaceEffect, SelectEffect, ForkEffect } from 'redux-saga/effects';
-import { InstantPurchaseTaxAndShippingResponsePayload, TaxAndShippingErrors, TaxAndShippingPricing } from '../../models';
+import { InstantPurchaseTaxAndShippingResponsePayload, TaxAndShippingState, TaxAndShippingErrors } from '../../models';
 import { GlobalGateway } from '../../../../../libraries/module-connector/src/main';
 import { Log } from '../../../../../libraries/domain/src/models';
 import { AppState } from '../../reducers';
@@ -10,41 +10,16 @@ export declare function watchTaxAndShippingChannel(gateway: GlobalGateway, logge
     offerEnd: unknown;
 } | undefined>;
 export declare function initiateTaxAndShippingRequest(_gateway: GlobalGateway, logger: (log: Log) => void, action: InitiateTaxAndShipping): Generator<SelectEffect | CallEffect | PutEffect | ForkEffect, void, AppState['fulfillmentDetails'] | boolean>;
-export declare function processTaxAndShippingResponse(payload: InstantPurchaseTaxAndShippingResponsePayload): Generator<PutEffect<{
+export declare function processTaxAndShippingResponse(payload: InstantPurchaseTaxAndShippingResponsePayload): Generator<SelectEffect | PutEffect, void, unknown>;
+export declare function timeoutPendingCacheEntry(cacheKey: string, requestId: string, logger: (log: Log) => void): Generator<CallEffect<void> | SelectEffect | CallEffect<true> | PutEffect<{
     type: string;
     payload: {
         cacheKey: string;
         taxAndShippingEntry: {
             isPending: false;
             taxAndShippingData: {
-                error: TaxAndShippingErrors.REQUEST_FAILED;
+                error: TaxAndShippingErrors;
             };
         };
     };
-}> | PutEffect<{
-    type: string;
-    payload: {
-        event: string;
-        completionReason: string;
-    };
-}> | PutEffect<{
-    type: string;
-    payload: {
-        key: "offerComplete";
-        value: number;
-    };
-}> | PutEffect<{
-    type: string;
-    payload: {
-        cacheKey: string;
-        taxAndShippingEntry: {
-            isPending: false;
-            taxAndShippingData: {
-                taxAndShippingPricing: TaxAndShippingPricing;
-            };
-        };
-    };
-}> | PutEffect<{
-    type: string;
-    payload: string | null;
-}>, void, unknown>;
+}>, void, TaxAndShippingState>;

package/dist/modules/instant-purchase/src/selectors/tax-and-shipping/selectors.d.ts

@@ -1,3 +1,6 @@
+import { PluginCatalogItem } from '../../../../../libraries/domain/src/models';
 import { TaxAndShippingEntry } from '../../models';
 import { AppState } from '../../reducers';
 export declare function getActiveTaxAndShipping(state: AppState): TaxAndShippingEntry;
+export declare function getTaxAndShippingForCatalogItem(state: AppState, catalogItem: Pick<PluginCatalogItem, 'catalogItemId'>): TaxAndShippingEntry | undefined;
+export declare function isCatalogItemTaxAndShippingReady(state: AppState, catalogItem: Pick<PluginCatalogItem, 'catalogItemId' | 'copy'>): boolean;

package/dist/modules/instant-purchase/src/utils/parse-non-negative-monetary-amount.d.ts

@@ -0,0 +1 @@
+export declare function parseNonNegativeMonetaryAmount(value: unknown): number | null;

package/dist/modules/instant-purchase/src/utils/requires-tax-and-shipping-initialization.d.ts

@@ -0,0 +1,2 @@
+import { PluginCatalogItem } from '../../../../libraries/domain/src/models';
+export declare function requiresTaxAndShippingInitialization(catalogItem: Pick<PluginCatalogItem, 'copy'>): boolean;

package/dist/modules/standard-marketing/src/sagas/offer-engagement/sagas.d.ts

@@ -12,10 +12,11 @@ export declare function getRealtimeFulfillmentSuccessCallback(gateway: GlobalGat
     payload: {
         name: string;
         body: {
+            rewardHandoff: boolean | undefined;
+            adID?: string;
             rclid: string | undefined;
             accountID: string;
             referralCreativeID: string | undefined;
-            rewardHandoff: boolean | undefined;
         };
     };
 }>, void, unknown>) | undefined;