@xibosignage/xibo-layout-renderer 1.0.26 → 1.0.28

package/dist/src/Modules/ActionController/ActionController.d.ts

@@ -24,15 +24,17 @@ export default class ActionController {
     constructor(parent: ILayout, actions: Action[], options: InactOptions);
     init(): void;
     openLayoutInNewTab(layoutCode: string, options: InactOptions): void;
-    openLayoutInPlayer(layoutCode: string, options: InactOptions): void;
+    openLayoutInPlayer(layoutCode: string, _options: InactOptions): void;
     prevOrNextLayout(targetId: string, actionType: string): void;
     /** Change media in region (next/previous) */
-    nextMediaInRegion(regionId: string, actionType: string): void;
+    gotoMediaInRegion(regionId: string, actionType: string): void;
     loadMediaInRegion(regionId: string, widgetId: string): void;
     /** Run action based on action data */
     runAction(actionData: {
         [k: string]: any;
     }, options: InactOptions): void;
     initTouchActions(): void;
+    /** Dispatch an incoming webhook trigger to any matching actions on this layout. */
+    handleWebhookTrigger(triggerCode: string, widgetId?: string): void;
     initKeyboardActions(): void;
 }

package/dist/src/Modules/Media/Media.d.ts

@@ -50,6 +50,9 @@ export declare class Media implements IMedia {
     xml: Element | null;
     videoHandler?: IVideoMediaHandler;
     mediaTimer: ReturnType<typeof setInterval> | undefined;
+    sspImpressionUrls: string[] | undefined;
+    sspErrorUrls: string[] | undefined;
+    private isSspWidget;
     private mediaTimeCount;
     private xlr;
     private readonly statsBC;
@@ -59,6 +62,7 @@ export declare class Media implements IMedia {
     private on;
     private init;
     run(): void;
+    setSspAdUrl(url: string, adMediaType: 'image' | 'video', impressionUrls?: string[], errorUrls?: string[]): void;
     stop(): Promise<void>;
     /**
      * Emits a command from the shell command widget.

package/dist/src/Types/Layout/Layout.types.d.ts

@@ -27,6 +27,7 @@ export type InputLayoutType = {
     duration?: number;
     isOverlay?: boolean;
     shareOfVoice?: number;
+    code?: string;
 };
 export type OptionsType = {
     xlfUrl: string;

package/dist/src/Types/Media/Media.types.d.ts

@@ -42,6 +42,9 @@ export interface IMedia {
     region: IRegion;
     render: string;
     run(): void;
+    setSspAdUrl(url: string, adMediaType: 'image' | 'video', impressionUrls?: string[], errorUrls?: string[]): void;
+    sspImpressionUrls: string[] | undefined;
+    sspErrorUrls: string[] | undefined;
     schemaVersion: string;
     singlePlay: boolean;
     state: MediaState;

package/dist/src/Types/Region/Region.types.d.ts

@@ -35,6 +35,7 @@ export interface IRegion {
     };
     playNextMedia(): void;
     playPreviousMedia(): void;
+    prepareMedia(media: IMedia): void;
     prepareMediaObjects(): void;
     prepareRegion(): void;
     ready: boolean;

package/dist/src/Types/XLR/XLR.types.d.ts

@@ -1,5 +1,6 @@
 import { Emitter, Unsubscribe } from 'nanoevents';
 import { ILayout, InputLayoutType, OptionsType } from '../Layout';
+import { IMedia } from '../Media';
 import { OverlayLayoutManager } from "../../Modules/Layout/OverlayLayoutManager";
 export type PrepareLayoutsType = {
     moveNext?: boolean;
@@ -17,6 +18,8 @@ export type IXlrEvents = {
     widgetEnd: (widgetId: number) => void;
     widgetError: (widgetId: number) => void;
     adRequest: (sspLayoutIndex: number) => void;
+    sspWidgetRequest: (media: IMedia) => void;
+    sspWidgetEnd: (impressionUrls: string[], errorUrls: string[], duration: number) => void;
     updateLoop: (inputLayouts: InputLayoutType[]) => void;
     updateOverlays: (overlays: InputLayoutType[]) => void;
     overlayStart: (overlay: ILayout) => void;
@@ -45,6 +48,23 @@ export interface IXlr {
     getLayoutById(layoutId: number, layoutIndex?: number): ILayout | undefined;
     gotoNextLayout(): void;
     gotoPrevLayout(): void;
+    /**
+     * Navigate directly to a layout identified by its CMS code string.
+     * Searches parsed layouts first, then fetches unparsed XLF files via appHost.
+     * No-ops silently if the code is not found in the current loop.
+     */
+    gotoLayoutByCode(layoutCode: string): Promise<void>;
+    /**
+     * Play the given layout once as an interrupt, then resume the current loop.
+     * Used by non-CMS platforms for Navigate to Layout interactive actions.
+     * The interrupt is not part of inputLayouts and is spliced in temporarily.
+     */
+    playInterruptLayout(inputLayout: InputLayoutType): Promise<void>;
+    /**
+     * Dispatch an incoming webhook trigger code to the current layout's
+     * action controller. Pass an optional widgetId to narrow the match.
+     */
+    triggerAction(triggerCode: string, widgetId?: string): void;
     init(): Promise<IXlr>;
     inputLayouts: InputLayoutType[];
     isInterrupted: boolean;
@@ -65,7 +85,7 @@ export interface IXlr {
     prepareLayoutXlf(inputLayout: ILayout | undefined): Promise<ILayout>;
     prepareLayouts(): Promise<IXlr>;
     renderOverlayLayouts(): Promise<void>;
-    uniqueLayouts: Record<string, InputLayoutType>;
+    uniqueLayouts: Map<string, InputLayoutType>;
     updateInputLayout(layoutIndex: number, layout: InputLayoutType): void;
     updateLayouts(inputLayouts: InputLayoutType[]): void;
     updateLoop(inputLayouts: InputLayoutType[]): Promise<void>;