@openfin/fdc3-api 40.102.1 → 40.103.1

package/out/fdc3-api-alpha.d.ts

@@ -3218,6 +3218,40 @@ declare class Clipboard_2 extends Base {
     getAvailableFormats(type?: OpenFin.ClipboardSelectionType): Promise<Array<string>>;
 }
 
+/**
+ * Generated when a copy operation is blocked through {@link OpenFin.DomainSettings}.
+ * @interface
+ */
+declare type ClipboardCopyBlockedEvent = NamedEvent & {
+    type: 'clipboard-copy-blocked';
+    /**
+     * URL of the Window or View that generated the event.
+     */
+    url: string;
+    reason: CopyBlockedEventReason;
+};
+
+/**
+ * Generated when a paste operation is blocked through {@link OpenFin.DomainSettings}.
+ * @interface
+ */
+declare type ClipboardPasteBlockedEvent = NamedEvent & {
+    type: 'clipboard-paste-blocked';
+    /**
+     * URL of the Window or View that generated the event.
+     */
+    url: string;
+    reason: PasteBlockedEventReason;
+};
+
+/**
+ * Clipboard Permissions
+ */
+declare type ClipboardPermissions = {
+    copy?: CopyPermissions;
+    paste?: PastePermissions;
+};
+
 /**
  * The type of clipboard to write to, can be 'clipboard' or 'selection'.
  * Defaults to 'clipboard'. Use 'selection' for linux only.
@@ -3992,6 +4026,40 @@ declare type CookieOption = {
     name: string;
 };
 
+/**
+ * Reasons for a copy operation being blocked
+ *
+ * 'disabled': Copy operation is disabled through domain-based permissions.
+ */
+declare type CopyBlockedEventReason = 'disabled';
+
+/**
+ * Control copy operations for a matched URL.
+ */
+declare type CopyPermissions = {
+    /**
+     * @defaultValue 'allowed'
+     *
+     * Controls the behavior for copy operations for a matched URL.
+     *
+     * allow: Enables all copy operations.
+     * block: Disables all copy operations.
+     * protect: Protects any copied content. Only URLs that have set paste.behavior: 'all-content' will be allowed to paste this content.
+     */
+    behavior: 'allow' | 'block' | 'protect';
+    /**
+     * Additional copy operation options
+     */
+    options?: {
+        /**
+         * @defaultValue ''
+         *
+         * When setting behavior = 'protected' , this string will be pasted to other applications that do not have a matching URL instead of the original content.
+         */
+        replacementText: string;
+    };
+};
+
 /**
  * Defines and applies rounded corners for a frameless window. **NOTE:** On macOS corner is not ellipse but circle rounded by the
  *  average of _height_ and _width_.
@@ -4598,6 +4666,15 @@ declare class EmitterBase<EmitterEvent extends BaseEvent, EmitterEventType exten
     eventNames: () => (string | symbol)[];
     /* Excluded from this release type: emit */
     private hasEmitter;
+    /**
+     * Cleans up after removal of a listener, e.g. deleting any lingering deregistration handlers for a
+     * `once` subscription.
+     *
+     * @remarks Implementing this as a `removeListener` handler ensures that direct removal of a listener
+     * on the base emitter will not leak additional core handlers.  We could do this in the forwarding method,
+     * which would involve less "magic," but would be more-vulnerable to accidental re-introduction of a leak.
+     */
+    private cleanUpRemovedListener;
     private getOrCreateEmitter;
     listeners: (type: string | symbol) => Function[];
     listenerCount: (type: string | symbol) => number;
@@ -4838,7 +4915,7 @@ declare type Event_4 = (WebContentsEvents.Event<'view'> & {
  */
 declare type Event_5<Topic extends string> = {
     topic: Topic;
-} & (BlurredEvent | CertificateSelectionShownEvent | CrashedEvent_2 | DidChangeThemeColorEvent | FocusedEvent | NavigationRejectedEvent | UrlChangedEvent | DidFailLoadEvent | DidFinishLoadEvent | DidStartLoadingEvent | PageFaviconUpdatedEvent | PageTitleUpdatedEvent | ResourceLoadFailedEvent | ResourceResponseReceivedEvent | ChildContentBlockedEvent | ChildContentOpenedInBrowserEvent | ChildViewCreatedEvent | ChildWindowCreatedEvent | FileDownloadStartedEvent | FileDownloadProgressEvent | FileDownloadCompletedEvent | FoundInPageEvent | CertificateErrorEvent | ContentBlockedEvent | WillRedirectEvent);
+} & (BlurredEvent | CertificateSelectionShownEvent | CrashedEvent_2 | DidChangeThemeColorEvent | FocusedEvent | NavigationRejectedEvent | UrlChangedEvent | DidFailLoadEvent | DidFinishLoadEvent | DidStartLoadingEvent | PageFaviconUpdatedEvent | PageTitleUpdatedEvent | ResourceLoadFailedEvent | ResourceResponseReceivedEvent | ChildContentBlockedEvent | ChildContentOpenedInBrowserEvent | ChildViewCreatedEvent | ChildWindowCreatedEvent | FileDownloadStartedEvent | FileDownloadProgressEvent | FileDownloadCompletedEvent | FoundInPageEvent | CertificateErrorEvent | ContentBlockedEvent | WillRedirectEvent | ClipboardCopyBlockedEvent | ClipboardPasteBlockedEvent);
 
 /**
  *  [Union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) containing every possible event that can be emitted by a {@link Window}.  Events are
@@ -5940,11 +6017,8 @@ declare type FrameEventType = EventType_5;
 /**
  * @interface
  */
-declare type FrameInfo = {
-    name: string;
-    uuid: string;
+declare type FrameInfo = EntityInfo & {
     url: string;
-    entityType: EntityType_4;
     parent: Identity_4;
 };
 
@@ -9660,6 +9734,8 @@ declare namespace OpenFin {
         ClientConnectionPayload,
         EntityInfo,
         EntityType_4 as EntityType,
+        ScreenCaptureState,
+        ScreenCapturePermission,
         Bounds,
         WindowBounds,
         GetBoundsOptions,
@@ -9880,7 +9956,11 @@ declare namespace OpenFin {
         StructuredContentBehavior,
         StructuredContentPermissions,
         ContentPermission,
+        ScreenCaptureBehavior,
         PerDomainSettings,
+        CopyPermissions,
+        PastePermissions,
+        ClipboardPermissions,
         DomainSettingsRule,
         FileDownloadBehavior,
         FileDownloadBehaviorNames,
@@ -10059,6 +10139,29 @@ declare type PageTitleUpdatedEvent = NamedEvent & {
     title: string;
 };
 
+/**
+ * Reasons for a paste operation being blocked
+ *
+ * 'invalid-data': Copy protection is enabled and the pasted data is invalid.
+ * 'disabled': Copy protection is turned on and the current URL for this WebContent has been disabled through domain-based settings from accessing the copied data.
+ */
+declare type PasteBlockedEventReason = 'invalid-data' | 'disabled';
+
+/**
+ * Control copy operations for a matched URL.
+ */
+declare type PastePermissions = {
+    /**
+     * @defaultValue 'non-protected-content'
+     *
+     * Controls the behavior for paste operations for a matched URL.
+     *
+     * non-protected-content: All matching URLs will be able to paste content copied from non-protected URLs.
+     * all-content: All matching URLs will be able to paste content copied from both protected (copy.behavior = 'protect') and on-protected (copy.behavior = 'allow') URLs.
+     */
+    behavior: 'non-protected-content' | 'all-content';
+};
+
 declare type PathServeRequest = ServeRequest & {
     path: string;
 };
@@ -10202,6 +10305,16 @@ declare type PerDomainSettings = {
      * {@inheritdoc ChromiumPolicies}
      */
     chromiumPolicies?: ChromiumPolicies;
+    contentProtection?: {
+        /**
+         * {@inheritdoc ScreenCaptureBehavior}
+         */
+        screenCapture: ScreenCaptureBehavior;
+        /**
+         * {@inheritdoc ClipboardPermissions}
+         */
+        clipboard?: ClipboardPermissions;
+    };
 };
 
 /**
@@ -12852,6 +12965,10 @@ declare interface ProtocolMap extends ProtocolMapBase {
         };
         response: OpenFin.PopupResult;
     };
+    'get-screen-capture-permissions': {
+        request: OpenFin.Identity;
+        response: OpenFin.ScreenCapturePermission;
+    };
     'render-overlay': {
         request: {
             bounds: OpenFin.Bounds;
@@ -13381,6 +13498,31 @@ declare type RvmLaunchOptions = {
     subscribe?: (launch: LaunchEmitter) => void;
 };
 
+/**
+ * @interface
+ * Controls whether this content should be allowed or blocked when capturing the screen.
+ */
+declare type ScreenCaptureBehavior = 'allow' | 'block';
+
+/**
+ * Returned by getScreenCapturePermission. Includes sub-entity permission states and the resulting permission.
+ * @interface
+ */
+declare type ScreenCapturePermission = {
+    permission: ScreenCaptureBehavior;
+    permissions: ScreenCaptureState[];
+};
+
+/**
+ * screenCapture state for a given entity as defined in domain settings.
+ * @interface
+ */
+declare type ScreenCaptureState = {
+    info: EntityInfo;
+    behavior: ScreenCaptureBehavior;
+    url: string;
+};
+
 /**
  * @interface
  */
@@ -17732,6 +17874,19 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      * {@link OpenFin.WebContentsEvents event namespace}.
      */
     showPopupWindow(options: OpenFin.PopupOptions): Promise<OpenFin.PopupResult>;
+    /**
+     *
+     * Get the screen capture permission for this content.
+     *
+     * @example
+     * ```js
+     * const { permission } = await fin.me.getScreenCapturePermission();
+     *
+     * console.log(`This content is currently ${permission}ed in screen captures.`);
+     *
+     * ```
+     */
+    getScreenCapturePermission(): Promise<OpenFin.ScreenCapturePermission>;
 }
 
 /**
@@ -17770,6 +17925,8 @@ declare namespace WebContentsEvents {
         FileDownloadProgressEvent,
         FileDownloadCompletedEvent,
         ContentBlockedEvent,
+        ClipboardCopyBlockedEvent,
+        ClipboardPasteBlockedEvent,
         Event_5 as Event,
         WebContentsEvent,
         WillPropagateWebContentsEvent,

package/out/fdc3-api-beta.d.ts

@@ -3218,6 +3218,40 @@ declare class Clipboard_2 extends Base {
     getAvailableFormats(type?: OpenFin.ClipboardSelectionType): Promise<Array<string>>;
 }
 
+/**
+ * Generated when a copy operation is blocked through {@link OpenFin.DomainSettings}.
+ * @interface
+ */
+declare type ClipboardCopyBlockedEvent = NamedEvent & {
+    type: 'clipboard-copy-blocked';
+    /**
+     * URL of the Window or View that generated the event.
+     */
+    url: string;
+    reason: CopyBlockedEventReason;
+};
+
+/**
+ * Generated when a paste operation is blocked through {@link OpenFin.DomainSettings}.
+ * @interface
+ */
+declare type ClipboardPasteBlockedEvent = NamedEvent & {
+    type: 'clipboard-paste-blocked';
+    /**
+     * URL of the Window or View that generated the event.
+     */
+    url: string;
+    reason: PasteBlockedEventReason;
+};
+
+/**
+ * Clipboard Permissions
+ */
+declare type ClipboardPermissions = {
+    copy?: CopyPermissions;
+    paste?: PastePermissions;
+};
+
 /**
  * The type of clipboard to write to, can be 'clipboard' or 'selection'.
  * Defaults to 'clipboard'. Use 'selection' for linux only.
@@ -3992,6 +4026,40 @@ declare type CookieOption = {
     name: string;
 };
 
+/**
+ * Reasons for a copy operation being blocked
+ *
+ * 'disabled': Copy operation is disabled through domain-based permissions.
+ */
+declare type CopyBlockedEventReason = 'disabled';
+
+/**
+ * Control copy operations for a matched URL.
+ */
+declare type CopyPermissions = {
+    /**
+     * @defaultValue 'allowed'
+     *
+     * Controls the behavior for copy operations for a matched URL.
+     *
+     * allow: Enables all copy operations.
+     * block: Disables all copy operations.
+     * protect: Protects any copied content. Only URLs that have set paste.behavior: 'all-content' will be allowed to paste this content.
+     */
+    behavior: 'allow' | 'block' | 'protect';
+    /**
+     * Additional copy operation options
+     */
+    options?: {
+        /**
+         * @defaultValue ''
+         *
+         * When setting behavior = 'protected' , this string will be pasted to other applications that do not have a matching URL instead of the original content.
+         */
+        replacementText: string;
+    };
+};
+
 /**
  * Defines and applies rounded corners for a frameless window. **NOTE:** On macOS corner is not ellipse but circle rounded by the
  *  average of _height_ and _width_.
@@ -4598,6 +4666,15 @@ declare class EmitterBase<EmitterEvent extends BaseEvent, EmitterEventType exten
     eventNames: () => (string | symbol)[];
     /* Excluded from this release type: emit */
     private hasEmitter;
+    /**
+     * Cleans up after removal of a listener, e.g. deleting any lingering deregistration handlers for a
+     * `once` subscription.
+     *
+     * @remarks Implementing this as a `removeListener` handler ensures that direct removal of a listener
+     * on the base emitter will not leak additional core handlers.  We could do this in the forwarding method,
+     * which would involve less "magic," but would be more-vulnerable to accidental re-introduction of a leak.
+     */
+    private cleanUpRemovedListener;
     private getOrCreateEmitter;
     listeners: (type: string | symbol) => Function[];
     listenerCount: (type: string | symbol) => number;
@@ -4838,7 +4915,7 @@ declare type Event_4 = (WebContentsEvents.Event<'view'> & {
  */
 declare type Event_5<Topic extends string> = {
     topic: Topic;
-} & (BlurredEvent | CertificateSelectionShownEvent | CrashedEvent_2 | DidChangeThemeColorEvent | FocusedEvent | NavigationRejectedEvent | UrlChangedEvent | DidFailLoadEvent | DidFinishLoadEvent | DidStartLoadingEvent | PageFaviconUpdatedEvent | PageTitleUpdatedEvent | ResourceLoadFailedEvent | ResourceResponseReceivedEvent | ChildContentBlockedEvent | ChildContentOpenedInBrowserEvent | ChildViewCreatedEvent | ChildWindowCreatedEvent | FileDownloadStartedEvent | FileDownloadProgressEvent | FileDownloadCompletedEvent | FoundInPageEvent | CertificateErrorEvent | ContentBlockedEvent | WillRedirectEvent);
+} & (BlurredEvent | CertificateSelectionShownEvent | CrashedEvent_2 | DidChangeThemeColorEvent | FocusedEvent | NavigationRejectedEvent | UrlChangedEvent | DidFailLoadEvent | DidFinishLoadEvent | DidStartLoadingEvent | PageFaviconUpdatedEvent | PageTitleUpdatedEvent | ResourceLoadFailedEvent | ResourceResponseReceivedEvent | ChildContentBlockedEvent | ChildContentOpenedInBrowserEvent | ChildViewCreatedEvent | ChildWindowCreatedEvent | FileDownloadStartedEvent | FileDownloadProgressEvent | FileDownloadCompletedEvent | FoundInPageEvent | CertificateErrorEvent | ContentBlockedEvent | WillRedirectEvent | ClipboardCopyBlockedEvent | ClipboardPasteBlockedEvent);
 
 /**
  *  [Union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) containing every possible event that can be emitted by a {@link Window}.  Events are
@@ -5940,11 +6017,8 @@ declare type FrameEventType = EventType_5;
 /**
  * @interface
  */
-declare type FrameInfo = {
-    name: string;
-    uuid: string;
+declare type FrameInfo = EntityInfo & {
     url: string;
-    entityType: EntityType_4;
     parent: Identity_4;
 };
 
@@ -9660,6 +9734,8 @@ declare namespace OpenFin {
         ClientConnectionPayload,
         EntityInfo,
         EntityType_4 as EntityType,
+        ScreenCaptureState,
+        ScreenCapturePermission,
         Bounds,
         WindowBounds,
         GetBoundsOptions,
@@ -9880,7 +9956,11 @@ declare namespace OpenFin {
         StructuredContentBehavior,
         StructuredContentPermissions,
         ContentPermission,
+        ScreenCaptureBehavior,
         PerDomainSettings,
+        CopyPermissions,
+        PastePermissions,
+        ClipboardPermissions,
         DomainSettingsRule,
         FileDownloadBehavior,
         FileDownloadBehaviorNames,
@@ -10059,6 +10139,29 @@ declare type PageTitleUpdatedEvent = NamedEvent & {
     title: string;
 };
 
+/**
+ * Reasons for a paste operation being blocked
+ *
+ * 'invalid-data': Copy protection is enabled and the pasted data is invalid.
+ * 'disabled': Copy protection is turned on and the current URL for this WebContent has been disabled through domain-based settings from accessing the copied data.
+ */
+declare type PasteBlockedEventReason = 'invalid-data' | 'disabled';
+
+/**
+ * Control copy operations for a matched URL.
+ */
+declare type PastePermissions = {
+    /**
+     * @defaultValue 'non-protected-content'
+     *
+     * Controls the behavior for paste operations for a matched URL.
+     *
+     * non-protected-content: All matching URLs will be able to paste content copied from non-protected URLs.
+     * all-content: All matching URLs will be able to paste content copied from both protected (copy.behavior = 'protect') and on-protected (copy.behavior = 'allow') URLs.
+     */
+    behavior: 'non-protected-content' | 'all-content';
+};
+
 declare type PathServeRequest = ServeRequest & {
     path: string;
 };
@@ -10202,6 +10305,16 @@ declare type PerDomainSettings = {
      * {@inheritdoc ChromiumPolicies}
      */
     chromiumPolicies?: ChromiumPolicies;
+    contentProtection?: {
+        /**
+         * {@inheritdoc ScreenCaptureBehavior}
+         */
+        screenCapture: ScreenCaptureBehavior;
+        /**
+         * {@inheritdoc ClipboardPermissions}
+         */
+        clipboard?: ClipboardPermissions;
+    };
 };
 
 /**
@@ -12852,6 +12965,10 @@ declare interface ProtocolMap extends ProtocolMapBase {
         };
         response: OpenFin.PopupResult;
     };
+    'get-screen-capture-permissions': {
+        request: OpenFin.Identity;
+        response: OpenFin.ScreenCapturePermission;
+    };
     'render-overlay': {
         request: {
             bounds: OpenFin.Bounds;
@@ -13381,6 +13498,31 @@ declare type RvmLaunchOptions = {
     subscribe?: (launch: LaunchEmitter) => void;
 };
 
+/**
+ * @interface
+ * Controls whether this content should be allowed or blocked when capturing the screen.
+ */
+declare type ScreenCaptureBehavior = 'allow' | 'block';
+
+/**
+ * Returned by getScreenCapturePermission. Includes sub-entity permission states and the resulting permission.
+ * @interface
+ */
+declare type ScreenCapturePermission = {
+    permission: ScreenCaptureBehavior;
+    permissions: ScreenCaptureState[];
+};
+
+/**
+ * screenCapture state for a given entity as defined in domain settings.
+ * @interface
+ */
+declare type ScreenCaptureState = {
+    info: EntityInfo;
+    behavior: ScreenCaptureBehavior;
+    url: string;
+};
+
 /**
  * @interface
  */
@@ -17732,6 +17874,19 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      * {@link OpenFin.WebContentsEvents event namespace}.
      */
     showPopupWindow(options: OpenFin.PopupOptions): Promise<OpenFin.PopupResult>;
+    /**
+     *
+     * Get the screen capture permission for this content.
+     *
+     * @example
+     * ```js
+     * const { permission } = await fin.me.getScreenCapturePermission();
+     *
+     * console.log(`This content is currently ${permission}ed in screen captures.`);
+     *
+     * ```
+     */
+    getScreenCapturePermission(): Promise<OpenFin.ScreenCapturePermission>;
 }
 
 /**
@@ -17770,6 +17925,8 @@ declare namespace WebContentsEvents {
         FileDownloadProgressEvent,
         FileDownloadCompletedEvent,
         ContentBlockedEvent,
+        ClipboardCopyBlockedEvent,
+        ClipboardPasteBlockedEvent,
         Event_5 as Event,
         WebContentsEvent,
         WillPropagateWebContentsEvent,

package/out/fdc3-api-public.d.ts

@@ -3218,6 +3218,40 @@ declare class Clipboard_2 extends Base {
     getAvailableFormats(type?: OpenFin.ClipboardSelectionType): Promise<Array<string>>;
 }
 
+/**
+ * Generated when a copy operation is blocked through {@link OpenFin.DomainSettings}.
+ * @interface
+ */
+declare type ClipboardCopyBlockedEvent = NamedEvent & {
+    type: 'clipboard-copy-blocked';
+    /**
+     * URL of the Window or View that generated the event.
+     */
+    url: string;
+    reason: CopyBlockedEventReason;
+};
+
+/**
+ * Generated when a paste operation is blocked through {@link OpenFin.DomainSettings}.
+ * @interface
+ */
+declare type ClipboardPasteBlockedEvent = NamedEvent & {
+    type: 'clipboard-paste-blocked';
+    /**
+     * URL of the Window or View that generated the event.
+     */
+    url: string;
+    reason: PasteBlockedEventReason;
+};
+
+/**
+ * Clipboard Permissions
+ */
+declare type ClipboardPermissions = {
+    copy?: CopyPermissions;
+    paste?: PastePermissions;
+};
+
 /**
  * The type of clipboard to write to, can be 'clipboard' or 'selection'.
  * Defaults to 'clipboard'. Use 'selection' for linux only.
@@ -3992,6 +4026,40 @@ declare type CookieOption = {
     name: string;
 };
 
+/**
+ * Reasons for a copy operation being blocked
+ *
+ * 'disabled': Copy operation is disabled through domain-based permissions.
+ */
+declare type CopyBlockedEventReason = 'disabled';
+
+/**
+ * Control copy operations for a matched URL.
+ */
+declare type CopyPermissions = {
+    /**
+     * @defaultValue 'allowed'
+     *
+     * Controls the behavior for copy operations for a matched URL.
+     *
+     * allow: Enables all copy operations.
+     * block: Disables all copy operations.
+     * protect: Protects any copied content. Only URLs that have set paste.behavior: 'all-content' will be allowed to paste this content.
+     */
+    behavior: 'allow' | 'block' | 'protect';
+    /**
+     * Additional copy operation options
+     */
+    options?: {
+        /**
+         * @defaultValue ''
+         *
+         * When setting behavior = 'protected' , this string will be pasted to other applications that do not have a matching URL instead of the original content.
+         */
+        replacementText: string;
+    };
+};
+
 /**
  * Defines and applies rounded corners for a frameless window. **NOTE:** On macOS corner is not ellipse but circle rounded by the
  *  average of _height_ and _width_.
@@ -4598,6 +4666,15 @@ declare class EmitterBase<EmitterEvent extends BaseEvent, EmitterEventType exten
     eventNames: () => (string | symbol)[];
     /* Excluded from this release type: emit */
     private hasEmitter;
+    /**
+     * Cleans up after removal of a listener, e.g. deleting any lingering deregistration handlers for a
+     * `once` subscription.
+     *
+     * @remarks Implementing this as a `removeListener` handler ensures that direct removal of a listener
+     * on the base emitter will not leak additional core handlers.  We could do this in the forwarding method,
+     * which would involve less "magic," but would be more-vulnerable to accidental re-introduction of a leak.
+     */
+    private cleanUpRemovedListener;
     private getOrCreateEmitter;
     listeners: (type: string | symbol) => Function[];
     listenerCount: (type: string | symbol) => number;
@@ -4838,7 +4915,7 @@ declare type Event_4 = (WebContentsEvents.Event<'view'> & {
  */
 declare type Event_5<Topic extends string> = {
     topic: Topic;
-} & (BlurredEvent | CertificateSelectionShownEvent | CrashedEvent_2 | DidChangeThemeColorEvent | FocusedEvent | NavigationRejectedEvent | UrlChangedEvent | DidFailLoadEvent | DidFinishLoadEvent | DidStartLoadingEvent | PageFaviconUpdatedEvent | PageTitleUpdatedEvent | ResourceLoadFailedEvent | ResourceResponseReceivedEvent | ChildContentBlockedEvent | ChildContentOpenedInBrowserEvent | ChildViewCreatedEvent | ChildWindowCreatedEvent | FileDownloadStartedEvent | FileDownloadProgressEvent | FileDownloadCompletedEvent | FoundInPageEvent | CertificateErrorEvent | ContentBlockedEvent | WillRedirectEvent);
+} & (BlurredEvent | CertificateSelectionShownEvent | CrashedEvent_2 | DidChangeThemeColorEvent | FocusedEvent | NavigationRejectedEvent | UrlChangedEvent | DidFailLoadEvent | DidFinishLoadEvent | DidStartLoadingEvent | PageFaviconUpdatedEvent | PageTitleUpdatedEvent | ResourceLoadFailedEvent | ResourceResponseReceivedEvent | ChildContentBlockedEvent | ChildContentOpenedInBrowserEvent | ChildViewCreatedEvent | ChildWindowCreatedEvent | FileDownloadStartedEvent | FileDownloadProgressEvent | FileDownloadCompletedEvent | FoundInPageEvent | CertificateErrorEvent | ContentBlockedEvent | WillRedirectEvent | ClipboardCopyBlockedEvent | ClipboardPasteBlockedEvent);
 
 /**
  *  [Union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) containing every possible event that can be emitted by a {@link Window}.  Events are
@@ -5940,11 +6017,8 @@ declare type FrameEventType = EventType_5;
 /**
  * @interface
  */
-declare type FrameInfo = {
-    name: string;
-    uuid: string;
+declare type FrameInfo = EntityInfo & {
     url: string;
-    entityType: EntityType_4;
     parent: Identity_4;
 };
 
@@ -9660,6 +9734,8 @@ declare namespace OpenFin {
         ClientConnectionPayload,
         EntityInfo,
         EntityType_4 as EntityType,
+        ScreenCaptureState,
+        ScreenCapturePermission,
         Bounds,
         WindowBounds,
         GetBoundsOptions,
@@ -9880,7 +9956,11 @@ declare namespace OpenFin {
         StructuredContentBehavior,
         StructuredContentPermissions,
         ContentPermission,
+        ScreenCaptureBehavior,
         PerDomainSettings,
+        CopyPermissions,
+        PastePermissions,
+        ClipboardPermissions,
         DomainSettingsRule,
         FileDownloadBehavior,
         FileDownloadBehaviorNames,
@@ -10059,6 +10139,29 @@ declare type PageTitleUpdatedEvent = NamedEvent & {
     title: string;
 };
 
+/**
+ * Reasons for a paste operation being blocked
+ *
+ * 'invalid-data': Copy protection is enabled and the pasted data is invalid.
+ * 'disabled': Copy protection is turned on and the current URL for this WebContent has been disabled through domain-based settings from accessing the copied data.
+ */
+declare type PasteBlockedEventReason = 'invalid-data' | 'disabled';
+
+/**
+ * Control copy operations for a matched URL.
+ */
+declare type PastePermissions = {
+    /**
+     * @defaultValue 'non-protected-content'
+     *
+     * Controls the behavior for paste operations for a matched URL.
+     *
+     * non-protected-content: All matching URLs will be able to paste content copied from non-protected URLs.
+     * all-content: All matching URLs will be able to paste content copied from both protected (copy.behavior = 'protect') and on-protected (copy.behavior = 'allow') URLs.
+     */
+    behavior: 'non-protected-content' | 'all-content';
+};
+
 declare type PathServeRequest = ServeRequest & {
     path: string;
 };
@@ -10202,6 +10305,16 @@ declare type PerDomainSettings = {
      * {@inheritdoc ChromiumPolicies}
      */
     chromiumPolicies?: ChromiumPolicies;
+    contentProtection?: {
+        /**
+         * {@inheritdoc ScreenCaptureBehavior}
+         */
+        screenCapture: ScreenCaptureBehavior;
+        /**
+         * {@inheritdoc ClipboardPermissions}
+         */
+        clipboard?: ClipboardPermissions;
+    };
 };
 
 /**
@@ -12852,6 +12965,10 @@ declare interface ProtocolMap extends ProtocolMapBase {
         };
         response: OpenFin.PopupResult;
     };
+    'get-screen-capture-permissions': {
+        request: OpenFin.Identity;
+        response: OpenFin.ScreenCapturePermission;
+    };
     'render-overlay': {
         request: {
             bounds: OpenFin.Bounds;
@@ -13381,6 +13498,31 @@ declare type RvmLaunchOptions = {
     subscribe?: (launch: LaunchEmitter) => void;
 };
 
+/**
+ * @interface
+ * Controls whether this content should be allowed or blocked when capturing the screen.
+ */
+declare type ScreenCaptureBehavior = 'allow' | 'block';
+
+/**
+ * Returned by getScreenCapturePermission. Includes sub-entity permission states and the resulting permission.
+ * @interface
+ */
+declare type ScreenCapturePermission = {
+    permission: ScreenCaptureBehavior;
+    permissions: ScreenCaptureState[];
+};
+
+/**
+ * screenCapture state for a given entity as defined in domain settings.
+ * @interface
+ */
+declare type ScreenCaptureState = {
+    info: EntityInfo;
+    behavior: ScreenCaptureBehavior;
+    url: string;
+};
+
 /**
  * @interface
  */
@@ -17732,6 +17874,19 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      * {@link OpenFin.WebContentsEvents event namespace}.
      */
     showPopupWindow(options: OpenFin.PopupOptions): Promise<OpenFin.PopupResult>;
+    /**
+     *
+     * Get the screen capture permission for this content.
+     *
+     * @example
+     * ```js
+     * const { permission } = await fin.me.getScreenCapturePermission();
+     *
+     * console.log(`This content is currently ${permission}ed in screen captures.`);
+     *
+     * ```
+     */
+    getScreenCapturePermission(): Promise<OpenFin.ScreenCapturePermission>;
 }
 
 /**
@@ -17770,6 +17925,8 @@ declare namespace WebContentsEvents {
         FileDownloadProgressEvent,
         FileDownloadCompletedEvent,
         ContentBlockedEvent,
+        ClipboardCopyBlockedEvent,
+        ClipboardPasteBlockedEvent,
         Event_5 as Event,
         WebContentsEvent,
         WillPropagateWebContentsEvent,

package/out/fdc3-api.d.ts

@@ -3274,6 +3274,40 @@ declare class Clipboard_2 extends Base {
     getAvailableFormats(type?: OpenFin.ClipboardSelectionType): Promise<Array<string>>;
 }
 
+/**
+ * Generated when a copy operation is blocked through {@link OpenFin.DomainSettings}.
+ * @interface
+ */
+declare type ClipboardCopyBlockedEvent = NamedEvent & {
+    type: 'clipboard-copy-blocked';
+    /**
+     * URL of the Window or View that generated the event.
+     */
+    url: string;
+    reason: CopyBlockedEventReason;
+};
+
+/**
+ * Generated when a paste operation is blocked through {@link OpenFin.DomainSettings}.
+ * @interface
+ */
+declare type ClipboardPasteBlockedEvent = NamedEvent & {
+    type: 'clipboard-paste-blocked';
+    /**
+     * URL of the Window or View that generated the event.
+     */
+    url: string;
+    reason: PasteBlockedEventReason;
+};
+
+/**
+ * Clipboard Permissions
+ */
+declare type ClipboardPermissions = {
+    copy?: CopyPermissions;
+    paste?: PastePermissions;
+};
+
 /**
  * The type of clipboard to write to, can be 'clipboard' or 'selection'.
  * Defaults to 'clipboard'. Use 'selection' for linux only.
@@ -4051,6 +4085,40 @@ declare type CookieOption = {
     name: string;
 };
 
+/**
+ * Reasons for a copy operation being blocked
+ *
+ * 'disabled': Copy operation is disabled through domain-based permissions.
+ */
+declare type CopyBlockedEventReason = 'disabled';
+
+/**
+ * Control copy operations for a matched URL.
+ */
+declare type CopyPermissions = {
+    /**
+     * @defaultValue 'allowed'
+     *
+     * Controls the behavior for copy operations for a matched URL.
+     *
+     * allow: Enables all copy operations.
+     * block: Disables all copy operations.
+     * protect: Protects any copied content. Only URLs that have set paste.behavior: 'all-content' will be allowed to paste this content.
+     */
+    behavior: 'allow' | 'block' | 'protect';
+    /**
+     * Additional copy operation options
+     */
+    options?: {
+        /**
+         * @defaultValue ''
+         *
+         * When setting behavior = 'protected' , this string will be pasted to other applications that do not have a matching URL instead of the original content.
+         */
+        replacementText: string;
+    };
+};
+
 /**
  * Defines and applies rounded corners for a frameless window. **NOTE:** On macOS corner is not ellipse but circle rounded by the
  *  average of _height_ and _width_.
@@ -4662,6 +4730,15 @@ declare class EmitterBase<EmitterEvent extends BaseEvent, EmitterEventType exten
         type: EventType;
     }>, ...args: any[]) => boolean;
     private hasEmitter;
+    /**
+     * Cleans up after removal of a listener, e.g. deleting any lingering deregistration handlers for a
+     * `once` subscription.
+     *
+     * @remarks Implementing this as a `removeListener` handler ensures that direct removal of a listener
+     * on the base emitter will not leak additional core handlers.  We could do this in the forwarding method,
+     * which would involve less "magic," but would be more-vulnerable to accidental re-introduction of a leak.
+     */
+    private cleanUpRemovedListener;
     private getOrCreateEmitter;
     listeners: (type: string | symbol) => Function[];
     listenerCount: (type: string | symbol) => number;
@@ -4902,7 +4979,7 @@ declare type Event_4 = (WebContentsEvents.Event<'view'> & {
  */
 declare type Event_5<Topic extends string> = {
     topic: Topic;
-} & (BlurredEvent | CertificateSelectionShownEvent | CrashedEvent_2 | DidChangeThemeColorEvent | FocusedEvent | NavigationRejectedEvent | UrlChangedEvent | DidFailLoadEvent | DidFinishLoadEvent | DidStartLoadingEvent | PageFaviconUpdatedEvent | PageTitleUpdatedEvent | ResourceLoadFailedEvent | ResourceResponseReceivedEvent | ChildContentBlockedEvent | ChildContentOpenedInBrowserEvent | ChildViewCreatedEvent | ChildWindowCreatedEvent | FileDownloadStartedEvent | FileDownloadProgressEvent | FileDownloadCompletedEvent | FoundInPageEvent | CertificateErrorEvent | ContentBlockedEvent | WillRedirectEvent);
+} & (BlurredEvent | CertificateSelectionShownEvent | CrashedEvent_2 | DidChangeThemeColorEvent | FocusedEvent | NavigationRejectedEvent | UrlChangedEvent | DidFailLoadEvent | DidFinishLoadEvent | DidStartLoadingEvent | PageFaviconUpdatedEvent | PageTitleUpdatedEvent | ResourceLoadFailedEvent | ResourceResponseReceivedEvent | ChildContentBlockedEvent | ChildContentOpenedInBrowserEvent | ChildViewCreatedEvent | ChildWindowCreatedEvent | FileDownloadStartedEvent | FileDownloadProgressEvent | FileDownloadCompletedEvent | FoundInPageEvent | CertificateErrorEvent | ContentBlockedEvent | WillRedirectEvent | ClipboardCopyBlockedEvent | ClipboardPasteBlockedEvent);
 
 /**
  *  [Union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) containing every possible event that can be emitted by a {@link Window}.  Events are
@@ -6028,11 +6105,8 @@ declare type FrameEventType = EventType_5;
 /**
  * @interface
  */
-declare type FrameInfo = {
-    name: string;
-    uuid: string;
+declare type FrameInfo = EntityInfo & {
     url: string;
-    entityType: EntityType_4;
     parent: Identity_4;
 };
 
@@ -9978,6 +10052,8 @@ declare namespace OpenFin {
         ClientConnectionPayload,
         EntityInfo,
         EntityType_4 as EntityType,
+        ScreenCaptureState,
+        ScreenCapturePermission,
         Bounds,
         WindowBounds,
         GetBoundsOptions,
@@ -10198,7 +10274,11 @@ declare namespace OpenFin {
         StructuredContentBehavior,
         StructuredContentPermissions,
         ContentPermission,
+        ScreenCaptureBehavior,
         PerDomainSettings,
+        CopyPermissions,
+        PastePermissions,
+        ClipboardPermissions,
         DomainSettingsRule,
         FileDownloadBehavior,
         FileDownloadBehaviorNames,
@@ -10377,6 +10457,29 @@ declare type PageTitleUpdatedEvent = NamedEvent & {
     title: string;
 };
 
+/**
+ * Reasons for a paste operation being blocked
+ *
+ * 'invalid-data': Copy protection is enabled and the pasted data is invalid.
+ * 'disabled': Copy protection is turned on and the current URL for this WebContent has been disabled through domain-based settings from accessing the copied data.
+ */
+declare type PasteBlockedEventReason = 'invalid-data' | 'disabled';
+
+/**
+ * Control copy operations for a matched URL.
+ */
+declare type PastePermissions = {
+    /**
+     * @defaultValue 'non-protected-content'
+     *
+     * Controls the behavior for paste operations for a matched URL.
+     *
+     * non-protected-content: All matching URLs will be able to paste content copied from non-protected URLs.
+     * all-content: All matching URLs will be able to paste content copied from both protected (copy.behavior = 'protect') and on-protected (copy.behavior = 'allow') URLs.
+     */
+    behavior: 'non-protected-content' | 'all-content';
+};
+
 declare type PathServeRequest = ServeRequest & {
     path: string;
 };
@@ -10520,6 +10623,16 @@ declare type PerDomainSettings = {
      * {@inheritdoc ChromiumPolicies}
      */
     chromiumPolicies?: ChromiumPolicies;
+    contentProtection?: {
+        /**
+         * {@inheritdoc ScreenCaptureBehavior}
+         */
+        screenCapture: ScreenCaptureBehavior;
+        /**
+         * {@inheritdoc ClipboardPermissions}
+         */
+        clipboard?: ClipboardPermissions;
+    };
 };
 
 /**
@@ -13253,6 +13366,10 @@ declare interface ProtocolMap extends ProtocolMapBase {
         };
         response: OpenFin.PopupResult;
     };
+    'get-screen-capture-permissions': {
+        request: OpenFin.Identity;
+        response: OpenFin.ScreenCapturePermission;
+    };
     'render-overlay': {
         request: {
             bounds: OpenFin.Bounds;
@@ -13782,6 +13899,31 @@ declare type RvmLaunchOptions = {
     subscribe?: (launch: LaunchEmitter) => void;
 };
 
+/**
+ * @interface
+ * Controls whether this content should be allowed or blocked when capturing the screen.
+ */
+declare type ScreenCaptureBehavior = 'allow' | 'block';
+
+/**
+ * Returned by getScreenCapturePermission. Includes sub-entity permission states and the resulting permission.
+ * @interface
+ */
+declare type ScreenCapturePermission = {
+    permission: ScreenCaptureBehavior;
+    permissions: ScreenCaptureState[];
+};
+
+/**
+ * screenCapture state for a given entity as defined in domain settings.
+ * @interface
+ */
+declare type ScreenCaptureState = {
+    info: EntityInfo;
+    behavior: ScreenCaptureBehavior;
+    url: string;
+};
+
 /**
  * @interface
  */
@@ -18183,6 +18325,19 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      * {@link OpenFin.WebContentsEvents event namespace}.
      */
     showPopupWindow(options: OpenFin.PopupOptions): Promise<OpenFin.PopupResult>;
+    /**
+     *
+     * Get the screen capture permission for this content.
+     *
+     * @example
+     * ```js
+     * const { permission } = await fin.me.getScreenCapturePermission();
+     *
+     * console.log(`This content is currently ${permission}ed in screen captures.`);
+     *
+     * ```
+     */
+    getScreenCapturePermission(): Promise<OpenFin.ScreenCapturePermission>;
 }
 
 /**
@@ -18221,6 +18376,8 @@ declare namespace WebContentsEvents {
         FileDownloadProgressEvent,
         FileDownloadCompletedEvent,
         ContentBlockedEvent,
+        ClipboardCopyBlockedEvent,
+        ClipboardPasteBlockedEvent,
         Event_5 as Event,
         WebContentsEvent,
         WillPropagateWebContentsEvent,

package/out/fdc3-api.js

@@ -476,7 +476,7 @@ var __classPrivateFieldGet$1 = (commonjsGlobal && commonjsGlobal.__classPrivateF
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _EmitterBase_emitterAccessor;
+var _EmitterBase_emitterAccessor, _EmitterBase_deregisterOnceListeners;
 Object.defineProperty(base, "__esModule", { value: true });
 base.Reply = base.EmitterBase = base.Base = void 0;
 const promises_1 = promises;
@@ -548,6 +548,7 @@ class EmitterBase extends Base {
         super(wire);
         this.topic = topic;
         _EmitterBase_emitterAccessor.set(this, void 0);
+        _EmitterBase_deregisterOnceListeners.set(this, void 0);
         this.eventNames = () => (this.hasEmitter() ? this.getOrCreateEmitter().eventNames() : []);
         /**
          * @internal
@@ -556,7 +557,28 @@ class EmitterBase extends Base {
             return this.hasEmitter() ? this.getOrCreateEmitter().emit(eventType, payload, ...args) : false;
         };
         this.hasEmitter = () => this.wire.eventAggregator.has(__classPrivateFieldGet$1(this, _EmitterBase_emitterAccessor, "f"));
-        this.getOrCreateEmitter = () => this.wire.eventAggregator.getOrCreate(__classPrivateFieldGet$1(this, _EmitterBase_emitterAccessor, "f"));
+        /**
+         * Cleans up after removal of a listener, e.g. deleting any lingering deregistration handlers for a
+         * `once` subscription.
+         *
+         * @remarks Implementing this as a `removeListener` handler ensures that direct removal of a listener
+         * on the base emitter will not leak additional core handlers.  We could do this in the forwarding method,
+         * which would involve less "magic," but would be more-vulnerable to accidental re-introduction of a leak.
+         */
+        this.cleanUpRemovedListener = (eventType, listener) => {
+            const deregister = __classPrivateFieldGet$1(this, _EmitterBase_deregisterOnceListeners, "f").get(listener);
+            if (deregister) {
+                const emitter = this.wire.eventAggregator.getOrCreate(__classPrivateFieldGet$1(this, _EmitterBase_emitterAccessor, "f"));
+                emitter.removeListener(eventType, deregister);
+            }
+        };
+        this.getOrCreateEmitter = () => {
+            const emitter = this.wire.eventAggregator.getOrCreate(__classPrivateFieldGet$1(this, _EmitterBase_emitterAccessor, "f"));
+            if (!emitter.listeners('removeListener').includes(this.cleanUpRemovedListener)) {
+                emitter.on('removeListener', this.cleanUpRemovedListener);
+            }
+            return emitter;
+        };
         this.listeners = (type) => this.hasEmitter() ? this.getOrCreateEmitter().listeners(type) : [];
         this.listenerCount = (type) => this.hasEmitter() ? this.getOrCreateEmitter().listenerCount(type) : 0;
         this.registerEventListener = async (eventType, options = {}, applySubscription, undoSubscription) => {
@@ -588,13 +610,13 @@ class EmitterBase extends Base {
                     type: eventType
                 };
                 await this.wire.sendAction('unsubscribe-to-desktop-event', runtimeEvent).catch(() => null);
-                const emitter = this.getOrCreateEmitter();
-                return emitter;
+                return this.getOrCreateEmitter();
             }
             // This will only be reached if unsubscribe from event that does not exist but do not want to error here
             return Promise.resolve();
         };
         __classPrivateFieldSet$1(this, _EmitterBase_emitterAccessor, [topic, ...additionalAccessors], "f");
+        __classPrivateFieldSet$1(this, _EmitterBase_deregisterOnceListeners, new WeakMap(), "f");
         this.listeners = (event) => this.hasEmitter() ? this.getOrCreateEmitter().listeners(event) : [];
     }
     /**
@@ -623,6 +645,7 @@ class EmitterBase extends Base {
      */
     async once(eventType, listener, options) {
         const deregister = () => this.deregisterEventListener(eventType);
+        __classPrivateFieldGet$1(this, _EmitterBase_deregisterOnceListeners, "f").set(listener, deregister);
         await this.registerEventListener(eventType, options, (emitter) => {
             emitter.once(eventType, deregister);
             emitter.once(eventType, listener);
@@ -653,6 +676,7 @@ class EmitterBase extends Base {
      */
     async prependOnceListener(eventType, listener, options) {
         const deregister = () => this.deregisterEventListener(eventType);
+        __classPrivateFieldGet$1(this, _EmitterBase_deregisterOnceListeners, "f").set(listener, deregister);
         await this.registerEventListener(eventType, options, (emitter) => {
             emitter.prependOnceListener(eventType, listener);
             emitter.once(eventType, deregister);
@@ -711,13 +735,13 @@ class EmitterBase extends Base {
         return this;
     }
     deleteEmitterIfNothingRegistered(emitter) {
-        if (emitter.eventNames().length === 0) {
+        if (emitter.eventNames().every((type) => type === 'removeListener')) {
             this.wire.eventAggregator.delete(__classPrivateFieldGet$1(this, _EmitterBase_emitterAccessor, "f"));
         }
     }
 }
 base.EmitterBase = EmitterBase;
-_EmitterBase_emitterAccessor = new WeakMap();
+_EmitterBase_emitterAccessor = new WeakMap(), _EmitterBase_deregisterOnceListeners = new WeakMap();
 class Reply {
 }
 base.Reply = Reply;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@openfin/fdc3-api",
-    "version": "40.102.1",
+    "version": "40.103.1",
     "description": "OpenFin fdc3 module utilities and types.",
     "license": "SEE LICENSE IN LICENSE.md",
     "private": false,