@openfin/fdc3-api 46.100.64 → 46.100.66

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

@@ -2163,6 +2163,15 @@ declare type ByType_8<Type extends EventType_8> = Payload_10<Type>;
  */
 declare type ByType_9<Type extends EventType_9> = Payload_11<Type>;
 
+/** Minimal V8 CallSite shape — js-adapter does not include @types/node. */
+declare interface CallSite {
+    getFileName(): string | null;
+    toString(): string;
+}
+
+/** V8 CallSite objects, or native stack-frame strings from browsers that ignore Error.prepareStackTrace. */
+declare type CapturedStack = CallSite[] | string[];
+
 /**
  * Configuration for page capture.
  *
@@ -7381,17 +7390,19 @@ declare type InteropActionLoggingOption = {
  *          "interopBrokerConfiguration": {
  *              "contextGroups": [
  *                  {
- *                      "id": "green",
+ *                      "id": "fdc3.channel.4",
  *                      "displayMetadata": {
- *                          "color": "#00CC88",
- *                          "name": "green"
+ *                          "color": "green",
+ *                          "name": "Channel 4",
+ *                          "glyph": "4"
  *                      }
  *                  },
  *                  {
- *                      "id": "purple",
+ *                      "id": "fdc3.channel.8",
  *                      "displayMetadata": {
- *                          "color": "#8C61FF",
- *                          "name": "purple"
+ *                          "color": "purple",
+ *                          "name": "Channel 8",
+ *                          "glyph": "8"
  *                      }
  *                  },
  *              ]
@@ -7525,7 +7536,7 @@ declare class InteropBroker extends Base {
      * @param joinContextGroupOptions - Id of the Context Group and identity of the entity to join to the group.
      * @param senderIdentity - Identity of the client sender.
      */
-    joinContextGroup({ contextGroupId, target }: {
+    joinContextGroup({ contextGroupId: requestedContextGroupId, target }: {
         contextGroupId: string;
         target?: OpenFin.ClientIdentity | OpenFin.Identity;
     }, senderIdentity: OpenFin.ClientIdentity): Promise<void>;
@@ -7536,7 +7547,7 @@ declare class InteropBroker extends Base {
      * @param addClientToContextGroupOptions - Contains the contextGroupId
      * @param clientIdentity - Identity of the client sender.
      */
-    addClientToContextGroup({ contextGroupId }: {
+    addClientToContextGroup({ contextGroupId: requestedContextGroupId }: {
         contextGroupId: string;
     }, clientIdentity: OpenFin.ClientIdentity): Promise<void>;
     /**
@@ -7949,6 +7960,8 @@ declare class InteropBroker extends Base {
     };
     private getClientState;
     private static toObject;
+    private normalizeContextGroupStates;
+    private normalizeContextGroupId;
     static checkContextIntegrity: (context: OpenFin.Context) => {
         isValid: true;
     } | {
@@ -8176,7 +8189,7 @@ declare class InteropClient extends Base {
      *
      * getLastFocusedView()
      *     .then(lastFocusedViewIdentity => {
-     *         joinViewToContextGroup('red', lastFocusedViewIdentity)
+     *         joinViewToContextGroup('fdc3.channel.1', lastFocusedViewIdentity)
      *     })
      * ```
      */
@@ -8211,7 +8224,7 @@ declare class InteropClient extends Base {
      *
      * @example
      * ```js
-     * fin.me.interop.getAllClientsInContextGroup('red')
+     * fin.me.interop.getAllClientsInContextGroup('fdc3.channel.1')
      *     .then(clientsInContextGroup => {
      *         console.log(clientsInContextGroup)
      *     })
@@ -8226,7 +8239,7 @@ declare class InteropClient extends Base {
      *
      * @example
      * ```js
-     * fin.me.interop.getInfoForContextGroup('red')
+     * fin.me.interop.getInfoForContextGroup('fdc3.channel.1')
      *     .then(contextGroupInfo => {
      *         console.log(contextGroupInfo.displayMetadata.name)
      *         console.log(contextGroupInfo.displayMetadata.color)
@@ -8283,12 +8296,12 @@ declare class InteropClient extends Base {
      *
      * @example
      * ```js
-     * await fin.me.interop.joinContextGroup('yellow');
+     * await fin.me.interop.joinContextGroup('fdc3.channel.3');
      * await fin.me.interop.setContext({ type: 'instrument', id: { ticker: 'FOO' }});
      * const currentContext = await fin.me.interop.getCurrentContext();
      *
      * // with a specific context
-     * await fin.me.interop.joinContextGroup('yellow');
+     * await fin.me.interop.joinContextGroup('fdc3.channel.3');
      * await fin.me.interop.setContext({ type: 'country', id: { ISOALPHA3: 'US' }});
      * await fin.me.interop.setContext({ type: 'instrument', id: { ticker: 'FOO' }});
      * const currentContext = await fin.me.interop.getCurrentContext('country');
@@ -8450,7 +8463,7 @@ declare type InteropClientOnDisconnectionListener = (InteropBrokerDisconnectionE
  */
 declare type InteropConfig = {
     /**
-     * Context Group for the client. (green, yellow, red, etc.).
+     * Context Group ID for the client (for example, `fdc3.channel.4`).
      */
     currentContextGroup?: string | null;
     /**
@@ -8499,7 +8512,7 @@ declare class InteropModule extends Base {
      * @example
      * ```js
      * const interopConfig = {
-     *     currentContextGroup: 'green'
+     *     currentContextGroup: 'fdc3.channel.4'
      * }
      *
      * const interopBroker = await fin.Interop.init('openfin');
@@ -9787,6 +9800,10 @@ declare type Manifest = {
     experimentalExtensionPolicyBlockedHosts?: {
         hosts: string[];
     };
+    /**
+     * Chromium extensions to install and enable for this application.
+     */
+    extensions?: ManifestExtension[];
     licenseKey: string;
     offlineAccess?: boolean;
     platform?: PlatformOptions;
@@ -9840,6 +9857,27 @@ declare type ManifestChangedEvent = BaseEvents.IdentityEvent & {
     type: 'manifest-changed';
 };
 
+/**
+ * Chromium extension entry in an application configuration.
+ *
+ * @interface
+ */
+declare type ManifestExtension = {
+    /** Chromium extension ID. */
+    id: string;
+    /** Extension server URL used to install the extension. */
+    serverURL: string;
+    /**
+     * Rules declaring where this extension may inject content scripts into
+     * non-tab surfaces (for example the AI Center). Omit or leave empty to keep
+     * the extension restricted to browser tabs — identical to historic
+     * behavior. A wildcard pattern in `match` grants blanket coverage.
+     * `matchOptions` behaves as it does for domain settings. Intended for
+     * security extensions rather than extensions that add visible UI.
+     */
+    nonTabInjections?: NonTabInjectionRule[];
+};
+
 /**
  * @interface
  */
@@ -10630,6 +10668,32 @@ declare type NonPropagatedWebContentsEvent = never;
  */
 declare type NonPropagatedWindowEvent = never;
 
+/**
+ * Rule permitting a Chromium extension to inject content scripts into non-tab
+ * web content whose URL matches the given patterns.
+ *
+ * Match patterns use the same Chromium
+ * [match pattern](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns)
+ * syntax as {@link DomainSettingsRule}. Omitting `matchOptions` uses the same
+ * default scheme-matching behavior as domain settings.
+ *
+ * @interface
+ */
+declare type NonTabInjectionRule = {
+    /**
+     * Array of [match patterns](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns)
+     * specifying the content locations where the extension may inject outside
+     * browser tabs. An empty array grants no permission. A wildcard grants
+     * blanket coverage of all content locations.
+     */
+    match: string[];
+    /**
+     * Options to use when comparing URIs to the `match` patterns. Behaves as
+     * {@link DomainSettingsRule.matchOptions} / {@link RuleMatchOptions}.
+     */
+    matchOptions?: RuleMatchOptions;
+};
+
 /* Excluded from this release type: NotCloseRequested */
 
 declare type NotificationEvent = {
@@ -10938,6 +11002,8 @@ declare namespace OpenFin {
         ThemeColorsMap,
         ThemeColorId,
         ThemePalette,
+        NonTabInjectionRule,
+        ManifestExtension,
         Manifest,
         LayoutContent,
         LayoutItemConfig,
@@ -17907,7 +17973,7 @@ declare class Transport<MeType extends EntityType = EntityType> extends EventEmi
     connectByPort(config: ExistingConnectConfig): Promise<void>;
     private authorize;
     sendAction<T extends keyof ProtocolMap>(action: T, payload?: ProtocolMap[T]['request'], uncorrelated?: boolean): SentMessage<SendActionResponse<T>>;
-    protected nackHandler(payloadOrMessage: RuntimeErrorPayload | string, reject: Function, callSites?: NodeJS.CallSite[]): void;
+    protected nackHandler(payloadOrMessage: RuntimeErrorPayload | string, reject: Function, callSites?: CapturedStack): void;
     ferryAction(origData: any): Promise<Message<any>>;
     registerMessageHandler(handler: MessageHandler): void;
     protected addWireListener(id: number, resolve: Function, handleNack: NackHandler, uncorrelated: boolean): void;

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

@@ -2163,6 +2163,15 @@ declare type ByType_8<Type extends EventType_8> = Payload_10<Type>;
  */
 declare type ByType_9<Type extends EventType_9> = Payload_11<Type>;
 
+/** Minimal V8 CallSite shape — js-adapter does not include @types/node. */
+declare interface CallSite {
+    getFileName(): string | null;
+    toString(): string;
+}
+
+/** V8 CallSite objects, or native stack-frame strings from browsers that ignore Error.prepareStackTrace. */
+declare type CapturedStack = CallSite[] | string[];
+
 /**
  * Configuration for page capture.
  *
@@ -7381,17 +7390,19 @@ declare type InteropActionLoggingOption = {
  *          "interopBrokerConfiguration": {
  *              "contextGroups": [
  *                  {
- *                      "id": "green",
+ *                      "id": "fdc3.channel.4",
  *                      "displayMetadata": {
- *                          "color": "#00CC88",
- *                          "name": "green"
+ *                          "color": "green",
+ *                          "name": "Channel 4",
+ *                          "glyph": "4"
  *                      }
  *                  },
  *                  {
- *                      "id": "purple",
+ *                      "id": "fdc3.channel.8",
  *                      "displayMetadata": {
- *                          "color": "#8C61FF",
- *                          "name": "purple"
+ *                          "color": "purple",
+ *                          "name": "Channel 8",
+ *                          "glyph": "8"
  *                      }
  *                  },
  *              ]
@@ -7525,7 +7536,7 @@ declare class InteropBroker extends Base {
      * @param joinContextGroupOptions - Id of the Context Group and identity of the entity to join to the group.
      * @param senderIdentity - Identity of the client sender.
      */
-    joinContextGroup({ contextGroupId, target }: {
+    joinContextGroup({ contextGroupId: requestedContextGroupId, target }: {
         contextGroupId: string;
         target?: OpenFin.ClientIdentity | OpenFin.Identity;
     }, senderIdentity: OpenFin.ClientIdentity): Promise<void>;
@@ -7536,7 +7547,7 @@ declare class InteropBroker extends Base {
      * @param addClientToContextGroupOptions - Contains the contextGroupId
      * @param clientIdentity - Identity of the client sender.
      */
-    addClientToContextGroup({ contextGroupId }: {
+    addClientToContextGroup({ contextGroupId: requestedContextGroupId }: {
         contextGroupId: string;
     }, clientIdentity: OpenFin.ClientIdentity): Promise<void>;
     /**
@@ -7949,6 +7960,8 @@ declare class InteropBroker extends Base {
     };
     private getClientState;
     private static toObject;
+    private normalizeContextGroupStates;
+    private normalizeContextGroupId;
     static checkContextIntegrity: (context: OpenFin.Context) => {
         isValid: true;
     } | {
@@ -8176,7 +8189,7 @@ declare class InteropClient extends Base {
      *
      * getLastFocusedView()
      *     .then(lastFocusedViewIdentity => {
-     *         joinViewToContextGroup('red', lastFocusedViewIdentity)
+     *         joinViewToContextGroup('fdc3.channel.1', lastFocusedViewIdentity)
      *     })
      * ```
      */
@@ -8211,7 +8224,7 @@ declare class InteropClient extends Base {
      *
      * @example
      * ```js
-     * fin.me.interop.getAllClientsInContextGroup('red')
+     * fin.me.interop.getAllClientsInContextGroup('fdc3.channel.1')
      *     .then(clientsInContextGroup => {
      *         console.log(clientsInContextGroup)
      *     })
@@ -8226,7 +8239,7 @@ declare class InteropClient extends Base {
      *
      * @example
      * ```js
-     * fin.me.interop.getInfoForContextGroup('red')
+     * fin.me.interop.getInfoForContextGroup('fdc3.channel.1')
      *     .then(contextGroupInfo => {
      *         console.log(contextGroupInfo.displayMetadata.name)
      *         console.log(contextGroupInfo.displayMetadata.color)
@@ -8283,12 +8296,12 @@ declare class InteropClient extends Base {
      *
      * @example
      * ```js
-     * await fin.me.interop.joinContextGroup('yellow');
+     * await fin.me.interop.joinContextGroup('fdc3.channel.3');
      * await fin.me.interop.setContext({ type: 'instrument', id: { ticker: 'FOO' }});
      * const currentContext = await fin.me.interop.getCurrentContext();
      *
      * // with a specific context
-     * await fin.me.interop.joinContextGroup('yellow');
+     * await fin.me.interop.joinContextGroup('fdc3.channel.3');
      * await fin.me.interop.setContext({ type: 'country', id: { ISOALPHA3: 'US' }});
      * await fin.me.interop.setContext({ type: 'instrument', id: { ticker: 'FOO' }});
      * const currentContext = await fin.me.interop.getCurrentContext('country');
@@ -8450,7 +8463,7 @@ declare type InteropClientOnDisconnectionListener = (InteropBrokerDisconnectionE
  */
 declare type InteropConfig = {
     /**
-     * Context Group for the client. (green, yellow, red, etc.).
+     * Context Group ID for the client (for example, `fdc3.channel.4`).
      */
     currentContextGroup?: string | null;
     /**
@@ -8499,7 +8512,7 @@ declare class InteropModule extends Base {
      * @example
      * ```js
      * const interopConfig = {
-     *     currentContextGroup: 'green'
+     *     currentContextGroup: 'fdc3.channel.4'
      * }
      *
      * const interopBroker = await fin.Interop.init('openfin');
@@ -9787,6 +9800,10 @@ declare type Manifest = {
     experimentalExtensionPolicyBlockedHosts?: {
         hosts: string[];
     };
+    /**
+     * Chromium extensions to install and enable for this application.
+     */
+    extensions?: ManifestExtension[];
     licenseKey: string;
     offlineAccess?: boolean;
     platform?: PlatformOptions;
@@ -9840,6 +9857,27 @@ declare type ManifestChangedEvent = BaseEvents.IdentityEvent & {
     type: 'manifest-changed';
 };
 
+/**
+ * Chromium extension entry in an application configuration.
+ *
+ * @interface
+ */
+declare type ManifestExtension = {
+    /** Chromium extension ID. */
+    id: string;
+    /** Extension server URL used to install the extension. */
+    serverURL: string;
+    /**
+     * Rules declaring where this extension may inject content scripts into
+     * non-tab surfaces (for example the AI Center). Omit or leave empty to keep
+     * the extension restricted to browser tabs — identical to historic
+     * behavior. A wildcard pattern in `match` grants blanket coverage.
+     * `matchOptions` behaves as it does for domain settings. Intended for
+     * security extensions rather than extensions that add visible UI.
+     */
+    nonTabInjections?: NonTabInjectionRule[];
+};
+
 /**
  * @interface
  */
@@ -10630,6 +10668,32 @@ declare type NonPropagatedWebContentsEvent = never;
  */
 declare type NonPropagatedWindowEvent = never;
 
+/**
+ * Rule permitting a Chromium extension to inject content scripts into non-tab
+ * web content whose URL matches the given patterns.
+ *
+ * Match patterns use the same Chromium
+ * [match pattern](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns)
+ * syntax as {@link DomainSettingsRule}. Omitting `matchOptions` uses the same
+ * default scheme-matching behavior as domain settings.
+ *
+ * @interface
+ */
+declare type NonTabInjectionRule = {
+    /**
+     * Array of [match patterns](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns)
+     * specifying the content locations where the extension may inject outside
+     * browser tabs. An empty array grants no permission. A wildcard grants
+     * blanket coverage of all content locations.
+     */
+    match: string[];
+    /**
+     * Options to use when comparing URIs to the `match` patterns. Behaves as
+     * {@link DomainSettingsRule.matchOptions} / {@link RuleMatchOptions}.
+     */
+    matchOptions?: RuleMatchOptions;
+};
+
 /* Excluded from this release type: NotCloseRequested */
 
 declare type NotificationEvent = {
@@ -10938,6 +11002,8 @@ declare namespace OpenFin {
         ThemeColorsMap,
         ThemeColorId,
         ThemePalette,
+        NonTabInjectionRule,
+        ManifestExtension,
         Manifest,
         LayoutContent,
         LayoutItemConfig,
@@ -17907,7 +17973,7 @@ declare class Transport<MeType extends EntityType = EntityType> extends EventEmi
     connectByPort(config: ExistingConnectConfig): Promise<void>;
     private authorize;
     sendAction<T extends keyof ProtocolMap>(action: T, payload?: ProtocolMap[T]['request'], uncorrelated?: boolean): SentMessage<SendActionResponse<T>>;
-    protected nackHandler(payloadOrMessage: RuntimeErrorPayload | string, reject: Function, callSites?: NodeJS.CallSite[]): void;
+    protected nackHandler(payloadOrMessage: RuntimeErrorPayload | string, reject: Function, callSites?: CapturedStack): void;
     ferryAction(origData: any): Promise<Message<any>>;
     registerMessageHandler(handler: MessageHandler): void;
     protected addWireListener(id: number, resolve: Function, handleNack: NackHandler, uncorrelated: boolean): void;

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

@@ -2163,6 +2163,15 @@ declare type ByType_8<Type extends EventType_8> = Payload_10<Type>;
  */
 declare type ByType_9<Type extends EventType_9> = Payload_11<Type>;
 
+/** Minimal V8 CallSite shape — js-adapter does not include @types/node. */
+declare interface CallSite {
+    getFileName(): string | null;
+    toString(): string;
+}
+
+/** V8 CallSite objects, or native stack-frame strings from browsers that ignore Error.prepareStackTrace. */
+declare type CapturedStack = CallSite[] | string[];
+
 /**
  * Configuration for page capture.
  *
@@ -7381,17 +7390,19 @@ declare type InteropActionLoggingOption = {
  *          "interopBrokerConfiguration": {
  *              "contextGroups": [
  *                  {
- *                      "id": "green",
+ *                      "id": "fdc3.channel.4",
  *                      "displayMetadata": {
- *                          "color": "#00CC88",
- *                          "name": "green"
+ *                          "color": "green",
+ *                          "name": "Channel 4",
+ *                          "glyph": "4"
  *                      }
  *                  },
  *                  {
- *                      "id": "purple",
+ *                      "id": "fdc3.channel.8",
  *                      "displayMetadata": {
- *                          "color": "#8C61FF",
- *                          "name": "purple"
+ *                          "color": "purple",
+ *                          "name": "Channel 8",
+ *                          "glyph": "8"
  *                      }
  *                  },
  *              ]
@@ -7525,7 +7536,7 @@ declare class InteropBroker extends Base {
      * @param joinContextGroupOptions - Id of the Context Group and identity of the entity to join to the group.
      * @param senderIdentity - Identity of the client sender.
      */
-    joinContextGroup({ contextGroupId, target }: {
+    joinContextGroup({ contextGroupId: requestedContextGroupId, target }: {
         contextGroupId: string;
         target?: OpenFin.ClientIdentity | OpenFin.Identity;
     }, senderIdentity: OpenFin.ClientIdentity): Promise<void>;
@@ -7536,7 +7547,7 @@ declare class InteropBroker extends Base {
      * @param addClientToContextGroupOptions - Contains the contextGroupId
      * @param clientIdentity - Identity of the client sender.
      */
-    addClientToContextGroup({ contextGroupId }: {
+    addClientToContextGroup({ contextGroupId: requestedContextGroupId }: {
         contextGroupId: string;
     }, clientIdentity: OpenFin.ClientIdentity): Promise<void>;
     /**
@@ -7949,6 +7960,8 @@ declare class InteropBroker extends Base {
     };
     private getClientState;
     private static toObject;
+    private normalizeContextGroupStates;
+    private normalizeContextGroupId;
     static checkContextIntegrity: (context: OpenFin.Context) => {
         isValid: true;
     } | {
@@ -8176,7 +8189,7 @@ declare class InteropClient extends Base {
      *
      * getLastFocusedView()
      *     .then(lastFocusedViewIdentity => {
-     *         joinViewToContextGroup('red', lastFocusedViewIdentity)
+     *         joinViewToContextGroup('fdc3.channel.1', lastFocusedViewIdentity)
      *     })
      * ```
      */
@@ -8211,7 +8224,7 @@ declare class InteropClient extends Base {
      *
      * @example
      * ```js
-     * fin.me.interop.getAllClientsInContextGroup('red')
+     * fin.me.interop.getAllClientsInContextGroup('fdc3.channel.1')
      *     .then(clientsInContextGroup => {
      *         console.log(clientsInContextGroup)
      *     })
@@ -8226,7 +8239,7 @@ declare class InteropClient extends Base {
      *
      * @example
      * ```js
-     * fin.me.interop.getInfoForContextGroup('red')
+     * fin.me.interop.getInfoForContextGroup('fdc3.channel.1')
      *     .then(contextGroupInfo => {
      *         console.log(contextGroupInfo.displayMetadata.name)
      *         console.log(contextGroupInfo.displayMetadata.color)
@@ -8283,12 +8296,12 @@ declare class InteropClient extends Base {
      *
      * @example
      * ```js
-     * await fin.me.interop.joinContextGroup('yellow');
+     * await fin.me.interop.joinContextGroup('fdc3.channel.3');
      * await fin.me.interop.setContext({ type: 'instrument', id: { ticker: 'FOO' }});
      * const currentContext = await fin.me.interop.getCurrentContext();
      *
      * // with a specific context
-     * await fin.me.interop.joinContextGroup('yellow');
+     * await fin.me.interop.joinContextGroup('fdc3.channel.3');
      * await fin.me.interop.setContext({ type: 'country', id: { ISOALPHA3: 'US' }});
      * await fin.me.interop.setContext({ type: 'instrument', id: { ticker: 'FOO' }});
      * const currentContext = await fin.me.interop.getCurrentContext('country');
@@ -8450,7 +8463,7 @@ declare type InteropClientOnDisconnectionListener = (InteropBrokerDisconnectionE
  */
 declare type InteropConfig = {
     /**
-     * Context Group for the client. (green, yellow, red, etc.).
+     * Context Group ID for the client (for example, `fdc3.channel.4`).
      */
     currentContextGroup?: string | null;
     /**
@@ -8499,7 +8512,7 @@ declare class InteropModule extends Base {
      * @example
      * ```js
      * const interopConfig = {
-     *     currentContextGroup: 'green'
+     *     currentContextGroup: 'fdc3.channel.4'
      * }
      *
      * const interopBroker = await fin.Interop.init('openfin');
@@ -9787,6 +9800,10 @@ declare type Manifest = {
     experimentalExtensionPolicyBlockedHosts?: {
         hosts: string[];
     };
+    /**
+     * Chromium extensions to install and enable for this application.
+     */
+    extensions?: ManifestExtension[];
     licenseKey: string;
     offlineAccess?: boolean;
     platform?: PlatformOptions;
@@ -9840,6 +9857,27 @@ declare type ManifestChangedEvent = BaseEvents.IdentityEvent & {
     type: 'manifest-changed';
 };
 
+/**
+ * Chromium extension entry in an application configuration.
+ *
+ * @interface
+ */
+declare type ManifestExtension = {
+    /** Chromium extension ID. */
+    id: string;
+    /** Extension server URL used to install the extension. */
+    serverURL: string;
+    /**
+     * Rules declaring where this extension may inject content scripts into
+     * non-tab surfaces (for example the AI Center). Omit or leave empty to keep
+     * the extension restricted to browser tabs — identical to historic
+     * behavior. A wildcard pattern in `match` grants blanket coverage.
+     * `matchOptions` behaves as it does for domain settings. Intended for
+     * security extensions rather than extensions that add visible UI.
+     */
+    nonTabInjections?: NonTabInjectionRule[];
+};
+
 /**
  * @interface
  */
@@ -10630,6 +10668,32 @@ declare type NonPropagatedWebContentsEvent = never;
  */
 declare type NonPropagatedWindowEvent = never;
 
+/**
+ * Rule permitting a Chromium extension to inject content scripts into non-tab
+ * web content whose URL matches the given patterns.
+ *
+ * Match patterns use the same Chromium
+ * [match pattern](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns)
+ * syntax as {@link DomainSettingsRule}. Omitting `matchOptions` uses the same
+ * default scheme-matching behavior as domain settings.
+ *
+ * @interface
+ */
+declare type NonTabInjectionRule = {
+    /**
+     * Array of [match patterns](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns)
+     * specifying the content locations where the extension may inject outside
+     * browser tabs. An empty array grants no permission. A wildcard grants
+     * blanket coverage of all content locations.
+     */
+    match: string[];
+    /**
+     * Options to use when comparing URIs to the `match` patterns. Behaves as
+     * {@link DomainSettingsRule.matchOptions} / {@link RuleMatchOptions}.
+     */
+    matchOptions?: RuleMatchOptions;
+};
+
 /* Excluded from this release type: NotCloseRequested */
 
 declare type NotificationEvent = {
@@ -10938,6 +11002,8 @@ declare namespace OpenFin {
         ThemeColorsMap,
         ThemeColorId,
         ThemePalette,
+        NonTabInjectionRule,
+        ManifestExtension,
         Manifest,
         LayoutContent,
         LayoutItemConfig,
@@ -17907,7 +17973,7 @@ declare class Transport<MeType extends EntityType = EntityType> extends EventEmi
     connectByPort(config: ExistingConnectConfig): Promise<void>;
     private authorize;
     sendAction<T extends keyof ProtocolMap>(action: T, payload?: ProtocolMap[T]['request'], uncorrelated?: boolean): SentMessage<SendActionResponse<T>>;
-    protected nackHandler(payloadOrMessage: RuntimeErrorPayload | string, reject: Function, callSites?: NodeJS.CallSite[]): void;
+    protected nackHandler(payloadOrMessage: RuntimeErrorPayload | string, reject: Function, callSites?: CapturedStack): void;
     ferryAction(origData: any): Promise<Message<any>>;
     registerMessageHandler(handler: MessageHandler): void;
     protected addWireListener(id: number, resolve: Function, handleNack: NackHandler, uncorrelated: boolean): void;

package/out/fdc3-api.d.ts

@@ -2195,6 +2195,15 @@ declare type ByType_8<Type extends EventType_8> = Payload_10<Type>;
  */
 declare type ByType_9<Type extends EventType_9> = Payload_11<Type>;
 
+/** Minimal V8 CallSite shape — js-adapter does not include @types/node. */
+declare interface CallSite {
+    getFileName(): string | null;
+    toString(): string;
+}
+
+/** V8 CallSite objects, or native stack-frame strings from browsers that ignore Error.prepareStackTrace. */
+declare type CapturedStack = CallSite[] | string[];
+
 /**
  * Configuration for page capture.
  *
@@ -7562,17 +7571,19 @@ declare type InteropActionLoggingOption = {
  *          "interopBrokerConfiguration": {
  *              "contextGroups": [
  *                  {
- *                      "id": "green",
+ *                      "id": "fdc3.channel.4",
  *                      "displayMetadata": {
- *                          "color": "#00CC88",
- *                          "name": "green"
+ *                          "color": "green",
+ *                          "name": "Channel 4",
+ *                          "glyph": "4"
  *                      }
  *                  },
  *                  {
- *                      "id": "purple",
+ *                      "id": "fdc3.channel.8",
  *                      "displayMetadata": {
- *                          "color": "#8C61FF",
- *                          "name": "purple"
+ *                          "color": "purple",
+ *                          "name": "Channel 8",
+ *                          "glyph": "8"
  *                      }
  *                  },
  *              ]
@@ -7709,7 +7720,7 @@ declare class InteropBroker extends Base {
      * @param joinContextGroupOptions - Id of the Context Group and identity of the entity to join to the group.
      * @param senderIdentity - Identity of the client sender.
      */
-    joinContextGroup({ contextGroupId, target }: {
+    joinContextGroup({ contextGroupId: requestedContextGroupId, target }: {
         contextGroupId: string;
         target?: OpenFin.ClientIdentity | OpenFin.Identity;
     }, senderIdentity: OpenFin.ClientIdentity): Promise<void>;
@@ -7720,7 +7731,7 @@ declare class InteropBroker extends Base {
      * @param addClientToContextGroupOptions - Contains the contextGroupId
      * @param clientIdentity - Identity of the client sender.
      */
-    addClientToContextGroup({ contextGroupId }: {
+    addClientToContextGroup({ contextGroupId: requestedContextGroupId }: {
         contextGroupId: string;
     }, clientIdentity: OpenFin.ClientIdentity): Promise<void>;
     /**
@@ -8133,6 +8144,8 @@ declare class InteropBroker extends Base {
     };
     private getClientState;
     private static toObject;
+    private normalizeContextGroupStates;
+    private normalizeContextGroupId;
     static checkContextIntegrity: (context: OpenFin.Context) => {
         isValid: true;
     } | {
@@ -8363,7 +8376,7 @@ declare class InteropClient extends Base {
      *
      * getLastFocusedView()
      *     .then(lastFocusedViewIdentity => {
-     *         joinViewToContextGroup('red', lastFocusedViewIdentity)
+     *         joinViewToContextGroup('fdc3.channel.1', lastFocusedViewIdentity)
      *     })
      * ```
      */
@@ -8398,7 +8411,7 @@ declare class InteropClient extends Base {
      *
      * @example
      * ```js
-     * fin.me.interop.getAllClientsInContextGroup('red')
+     * fin.me.interop.getAllClientsInContextGroup('fdc3.channel.1')
      *     .then(clientsInContextGroup => {
      *         console.log(clientsInContextGroup)
      *     })
@@ -8413,7 +8426,7 @@ declare class InteropClient extends Base {
      *
      * @example
      * ```js
-     * fin.me.interop.getInfoForContextGroup('red')
+     * fin.me.interop.getInfoForContextGroup('fdc3.channel.1')
      *     .then(contextGroupInfo => {
      *         console.log(contextGroupInfo.displayMetadata.name)
      *         console.log(contextGroupInfo.displayMetadata.color)
@@ -8470,12 +8483,12 @@ declare class InteropClient extends Base {
      *
      * @example
      * ```js
-     * await fin.me.interop.joinContextGroup('yellow');
+     * await fin.me.interop.joinContextGroup('fdc3.channel.3');
      * await fin.me.interop.setContext({ type: 'instrument', id: { ticker: 'FOO' }});
      * const currentContext = await fin.me.interop.getCurrentContext();
      *
      * // with a specific context
-     * await fin.me.interop.joinContextGroup('yellow');
+     * await fin.me.interop.joinContextGroup('fdc3.channel.3');
      * await fin.me.interop.setContext({ type: 'country', id: { ISOALPHA3: 'US' }});
      * await fin.me.interop.setContext({ type: 'instrument', id: { ticker: 'FOO' }});
      * const currentContext = await fin.me.interop.getCurrentContext('country');
@@ -8642,7 +8655,7 @@ declare type InteropClientOnDisconnectionListener = (InteropBrokerDisconnectionE
  */
 declare type InteropConfig = {
     /**
-     * Context Group for the client. (green, yellow, red, etc.).
+     * Context Group ID for the client (for example, `fdc3.channel.4`).
      */
     currentContextGroup?: string | null;
     /**
@@ -8691,7 +8704,7 @@ declare class InteropModule extends Base {
      * @example
      * ```js
      * const interopConfig = {
-     *     currentContextGroup: 'green'
+     *     currentContextGroup: 'fdc3.channel.4'
      * }
      *
      * const interopBroker = await fin.Interop.init('openfin');
@@ -10171,6 +10184,10 @@ declare type Manifest = {
     experimentalExtensionPolicyBlockedHosts?: {
         hosts: string[];
     };
+    /**
+     * Chromium extensions to install and enable for this application.
+     */
+    extensions?: ManifestExtension[];
     licenseKey: string;
     offlineAccess?: boolean;
     platform?: PlatformOptions;
@@ -10224,6 +10241,27 @@ declare type ManifestChangedEvent = BaseEvents.IdentityEvent & {
     type: 'manifest-changed';
 };
 
+/**
+ * Chromium extension entry in an application configuration.
+ *
+ * @interface
+ */
+declare type ManifestExtension = {
+    /** Chromium extension ID. */
+    id: string;
+    /** Extension server URL used to install the extension. */
+    serverURL: string;
+    /**
+     * Rules declaring where this extension may inject content scripts into
+     * non-tab surfaces (for example the AI Center). Omit or leave empty to keep
+     * the extension restricted to browser tabs — identical to historic
+     * behavior. A wildcard pattern in `match` grants blanket coverage.
+     * `matchOptions` behaves as it does for domain settings. Intended for
+     * security extensions rather than extensions that add visible UI.
+     */
+    nonTabInjections?: NonTabInjectionRule[];
+};
+
 /**
  * @interface
  */
@@ -11026,6 +11064,32 @@ declare type NonPropagatedWebContentsEvent = never;
  */
 declare type NonPropagatedWindowEvent = never;
 
+/**
+ * Rule permitting a Chromium extension to inject content scripts into non-tab
+ * web content whose URL matches the given patterns.
+ *
+ * Match patterns use the same Chromium
+ * [match pattern](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns)
+ * syntax as {@link DomainSettingsRule}. Omitting `matchOptions` uses the same
+ * default scheme-matching behavior as domain settings.
+ *
+ * @interface
+ */
+declare type NonTabInjectionRule = {
+    /**
+     * Array of [match patterns](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns)
+     * specifying the content locations where the extension may inject outside
+     * browser tabs. An empty array grants no permission. A wildcard grants
+     * blanket coverage of all content locations.
+     */
+    match: string[];
+    /**
+     * Options to use when comparing URIs to the `match` patterns. Behaves as
+     * {@link DomainSettingsRule.matchOptions} / {@link RuleMatchOptions}.
+     */
+    matchOptions?: RuleMatchOptions;
+};
+
 /**
  * @internal
  *
@@ -11347,6 +11411,8 @@ declare namespace OpenFin {
         ThemeColorsMap,
         ThemeColorId,
         ThemePalette,
+        NonTabInjectionRule,
+        ManifestExtension,
         Manifest,
         LayoutContent,
         LayoutItemConfig,
@@ -18412,7 +18478,7 @@ declare class Transport<MeType extends EntityType = EntityType> extends EventEmi
     connectByPort(config: ExistingConnectConfig): Promise<void>;
     private authorize;
     sendAction<T extends keyof ProtocolMap>(action: T, payload?: ProtocolMap[T]['request'], uncorrelated?: boolean): SentMessage<SendActionResponse<T>>;
-    protected nackHandler(payloadOrMessage: RuntimeErrorPayload | string, reject: Function, callSites?: NodeJS.CallSite[]): void;
+    protected nackHandler(payloadOrMessage: RuntimeErrorPayload | string, reject: Function, callSites?: CapturedStack): void;
     ferryAction(origData: any): Promise<Message<any>>;
     registerMessageHandler(handler: MessageHandler): void;
     protected addWireListener(id: number, resolve: Function, handleNack: NackHandler, uncorrelated: boolean): void;

package/out/fdc3-api.js

@@ -900,7 +900,7 @@ class InteropClient extends Base {
      *
      * getLastFocusedView()
      *     .then(lastFocusedViewIdentity => {
-     *         joinViewToContextGroup('red', lastFocusedViewIdentity)
+     *         joinViewToContextGroup('fdc3.channel.1', lastFocusedViewIdentity)
      *     })
      * ```
      */
@@ -950,7 +950,7 @@ class InteropClient extends Base {
      *
      * @example
      * ```js
-     * fin.me.interop.getAllClientsInContextGroup('red')
+     * fin.me.interop.getAllClientsInContextGroup('fdc3.channel.1')
      *     .then(clientsInContextGroup => {
      *         console.log(clientsInContextGroup)
      *     })
@@ -974,7 +974,7 @@ class InteropClient extends Base {
      *
      * @example
      * ```js
-     * fin.me.interop.getInfoForContextGroup('red')
+     * fin.me.interop.getInfoForContextGroup('fdc3.channel.1')
      *     .then(contextGroupInfo => {
      *         console.log(contextGroupInfo.displayMetadata.name)
      *         console.log(contextGroupInfo.displayMetadata.color)
@@ -1063,12 +1063,12 @@ class InteropClient extends Base {
      *
      * @example
      * ```js
-     * await fin.me.interop.joinContextGroup('yellow');
+     * await fin.me.interop.joinContextGroup('fdc3.channel.3');
      * await fin.me.interop.setContext({ type: 'instrument', id: { ticker: 'FOO' }});
      * const currentContext = await fin.me.interop.getCurrentContext();
      *
      * // with a specific context
-     * await fin.me.interop.joinContextGroup('yellow');
+     * await fin.me.interop.joinContextGroup('fdc3.channel.3');
      * await fin.me.interop.setContext({ type: 'country', id: { ISOALPHA3: 'US' }});
      * await fin.me.interop.setContext({ type: 'instrument', id: { ticker: 'FOO' }});
      * const currentContext = await fin.me.interop.getCurrentContext('country');
@@ -1374,15 +1374,18 @@ class FDC3ModuleBase {
     async joinChannel(channelId) {
         this.wire.recordAnalytic('fdc3-join-channel');
         try {
+            const contextGroup = await this.client.getInfoForContextGroup(channelId);
+            if (!contextGroup) {
+                console.error(`No User Channel was found with the ID "${channelId}". If this is an App Channel, use getOrCreateChannel instead.`);
+                throw new Error(ChannelError.NoChannelFound);
+            }
             return await this.client.joinContextGroup(channelId);
         }
         catch (error) {
-            if (error.message === BROKER_ERRORS.joinSessionContextGroupWithJoinContextGroup) {
-                console.error('The Channel you have tried to join is an App Channel. Custom Channels can only be defined by the Interop Broker through code or manifest configuration. Please use getOrCreateChannel.');
-            }
-            else {
-                console.error(error.message);
+            if (error.message === ChannelError.NoChannelFound) {
+                throw new Error(ChannelError.NoChannelFound);
             }
+            console.error(error.message);
             if (error.message.startsWith('Attempting to join a context group that does not exist')) {
                 throw new Error(ChannelError.NoChannelFound);
             }

package/package.json

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