@genesislcap/foundation-broadcast-channel NPM | npm.io

14.217.0 • Published 9 months ago

Install

Weekly downloads

-

License

SEE LICENSE IN li...

Repository

Last release

9 months ago

Foundation Broadcast Channel

foundation-broadcast-channel provides a strongly typed Broadcast_Channel API and related utilities. The system uses the same event typing we use in our stores, where the key is the event, and the value is the details or payload if any.

Installation

To enable this module in your application, follow the steps below.

Add @genesislcap/foundation-broadcast-channel as a dependency in your package.json file.

Note whenever you change the dependencies of your project, ensure you run the $ npm run bootstrap command again, or npm i, depending on your setup. You can find more information in the package.json basics page.

{
  "dependencies": {
    "@genesislcap/foundation-broadcast-channel": "latest",
    ...
  }
}

Usage

Create a typed channel for your application or package, likely in a config.ts file.

import { registerTypedBroadcastChannel, TypedBroadcastChannel } from '@genesislcap/foundation-broadcast-channel';

// Define or import the channel event / message map
export type GenesisResourcesEvents = {
  'resources-loaded': ResourceItem[];
  'resources-unloaded': void;
};

// Define the interface
export interface GenesisResourcesChannel extends TypedBroadcastChannel<GenesisResourcesEvents> {}

// Define the DI key
export const GenesisResourcesChannel = registerTypedBroadcastChannel<GenesisResourcesEvents>(GenesisResourcesChannelId);

Inject the channel into the actors you wish to post broadcast messages from.

import { GenesisResourcesChannel } from '@genesislcap/foundation-comms';

constructor(@GenesisResourcesChannel protected channel: GenesisResourcesChannel) {}

// Broadcast strongly typed messages
this.channel.postMessage('resources-loaded', this.resources);

Inject the channel into the actors you wish to recieve broadcast messages from.

import { GenesisResourcesChannel } from '@genesislcap/foundation-comms';

@GenesisResourcesChannel protected channel: GenesisResourcesChannel;

// Handle broadcasted messages and use the provided type narrowing API
this.channel.onmessage = (ev) => {
  if (this.channel.isMessageType('resources-loaded', ev)) {
    // Typescript now knows what detail is
    if (!ev.data.detail.length) {
      throw Error('No backend resources available');
    }
  }
};

// Close the channel when finished, perhaps on disconnectedCallback
this.channel.close();

Note that injected channels are transient by design.

API Docs

License

Note: this project provides front-end dependencies and uses licensed components listed in the next section; thus, licenses for those components are required during development. Contact Genesis Global for more details.

Licensed components

Genesis low-code platform

@genesislcap/foundation-events @genesislcap/foundation-logger @microsoft/fast-element @microsoft/fast-foundation

@genesislcap/foundation-comms @genesislcap/foundation-user

14.217.0-FUI-2233.2

9 months ago

9 months ago

14.215.1-alpha-886b8d5.0

9 months ago

14.215.1-alpha-1b867f5.0

9 months ago

9 months ago

9 months ago

14.214.4-cr.cr-1

9 months ago

14.214.1-FUI-2233.1

9 months ago

14.214.5-alpha-4192f9d.0

9 months ago

9 months ago

9 months ago

14.214.1-openfin-notifications.4

9 months ago

9 months ago

9 months ago

14.214.1-openfin-notifications.1

9 months ago

14.214.1-openfin-notifications.2

9 months ago

14.214.1-openfin-notifications.3

9 months ago

14.214.2-alpha-40e31af.0

9 months ago

9 months ago

14.214.0-fui-2223.1

9 months ago

9 months ago

14.214.1-alpha-aba6589.0

9 months ago

9 months ago

9 months ago

10 months ago

10 months ago

10 months ago

10 months ago

9 months ago

14.209.3-alpha-7cad5ca.0

10 months ago

10 months ago

14.209.3-alpha-afba6ee.0

10 months ago

14.209.2-alpha-b930c55.0

10 months ago

14.209.3-alpha-44127d4.0

10 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

14.210.5-alpha-edf4692.0

9 months ago

14.209.3-alpha-19540ee.0

10 months ago

14.209.3-alpha-b1b0602.0

10 months ago

14.209.1-alpha-6fc0d91.0

10 months ago

14.210.1-alpha-2ea9194.0

10 months ago

14.211.1-FUI-2213.1

9 months ago

9 months ago

14.210.6-alpha-cb142e0.0

9 months ago

14.210.1-alpha-1717fac.0

10 months ago

14.209.3-alpha-e70b36d.0

10 months ago

14.210.6-alpha-d598d73.0

9 months ago

14.209.3-alpha-6a63026.0

10 months ago

14.209.3-alpha-0e5e530.0

10 months ago

10 months ago

14.209.3-alpha-7176d01.0

10 months ago

10 months ago

14.210.1-alpha-d058de3.0

10 months ago

14.210.5-alpha-84d021b.0

9 months ago

14.209.1-alpha-25a4098.0

10 months ago

14.209.3-alpha-fa76c19.0

9 months ago

14.208.4-alpha-e888e8b.0

10 months ago

14.209.1-alpha-963e767.0

10 months ago

14.208.4-alpha-0dc13bc.0

10 months ago

14.208.4-alpha-06fcac4.0

10 months ago

14.208.3-alpha-92c853eac01c.0

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

14.204.1-FUI-2179.1

10 months ago

11 months ago

14.205.0-jsdom.1

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

14.203.2-alpha-9f2807c.0

11 months ago

14.182.0-pa-1226.2

1 year ago

12 months ago

12 months ago

1 year ago

1 year ago

1 year ago

14.195.1-alpha-a6b4686.0

1 year ago

14.189.1-alpha-971cf4f.0

1 year ago

14.200.0-FUI-2127.3

11 months ago

14.200.0-FUI-2127.4

11 months ago

14.188.0-FUI-2012-tabulator.2

1 year ago

14.188.0-FUI-2012-tabulator.3

1 year ago

14.197.1-alpha-62c6ae2.0

12 months ago

14.188.0-FUI-2012-tabulator.4

1 year ago

14.188.0-FUI-2012-tabulator.5

1 year ago

14.195.1-alpha-e5f27cb.0

1 year ago

14.188.0-FUI-2012-tabulator.7

1 year ago

11 months ago

14.195.2-alpha-20c90cf.0

12 months ago

1 year ago

1 year ago

14.194.1-alpha-5e85261f157.0

1 year ago

1 year ago

14.191.1-dotenv.1

1 year ago

14.186.1-alpha-1d915d4.0

1 year ago

12 months ago

1 year ago

1 year ago

14.188.0-FUI-2012-tabulator.1

1 year ago

14.183.7-alpha-ed1fe01.0

1 year ago

14.189.1-alpha-3318926.0

1 year ago

14.190.0-FUI-2012.1

12 months ago

12 months ago

12 months ago

1 year ago

1 year ago

1 year ago

1 year ago

14.182.0-PA-1226.1

1 year ago

14.193.4-alpha-17d5b15.0

1 year ago

14.200.1-alpha-599cb19.0

11 months ago

11 months ago

11 months ago

14.202.1-alpha-77ef7ac.0

11 months ago

14.200.0-FUI-2127.2

11 months ago

14.194.1-alpha-d6fd42b.0

1 year ago

14.183.8-alpha-a6f12fb.0

1 year ago

14.183.8-alpha-b447c11.0

1 year ago

14.202.1-alpha-271f747.0

11 months ago

14.192.0-accessibility.2

1 year ago

14.199.2-alpha-1ab46f4.0

12 months ago

14.192.3-alpha-1303ae2.0

1 year ago

1 year ago

1 year ago

1 year ago

14.192.3-alpha-c1861f7.0

1 year ago

14.195.2-alpha-cb87d2d.0

12 months ago

14.187.1-accessibility.1

1 year ago

1 year ago

14.198.1-alpha-09f65e3.0

12 months ago

14.182.3-alpha-287cf40.0

1 year ago

14.183.8-alpha-2bee32d.0

1 year ago

14.181.1-alpha-89be4c2.0

1 year ago

14.195.3-FUI-2102.1

12 months ago

14.195.3-FUI-2102.2

12 months ago

14.195.3-FUI-2102.3

12 months ago

14.188.0-FUI-2012.1

1 year ago

14.199.2-alpha-0c81553.0

11 months ago

1 year ago

12 months ago

1 year ago

1 year ago

1 year ago

14.182.3-alpha-75765564b4e.0

1 year ago

1 year ago

14.199.2-alpha-6f7195d.0

12 months ago

14.192.2-fdc3-enhancements.1

1 year ago

14.183.8-alpha-42eb620.0

1 year ago

1 year ago

1 year ago

1 year ago

14.192.2-fdc3-enhancements.6

12 months ago

14.192.2-fdc3-enhancements.7

12 months ago

14.192.2-fdc3-enhancements.8

12 months ago

14.192.2-fdc3-enhancements.9

12 months ago

14.192.2-fdc3-enhancements.2

1 year ago

11 months ago

14.192.2-fdc3-enhancements.3

1 year ago

14.192.2-fdc3-enhancements.4

1 year ago

14.192.2-fdc3-enhancements.5

1 year ago

14.187.1-alpha-3406925.0

1 year ago

14.197.0-FUI-2106.2

12 months ago

14.197.0-FUI-2106.1

12 months ago

14.195.3-FUI-2102.4

12 months ago

1 year ago

14.195.3-FUI-2102.5

12 months ago

1 year ago

14.197.1-alpha-1283f91.0

12 months ago

1 year ago

14.200.1-alpha-eb310c6.0

11 months ago

1 year ago

1 year ago

14.192.2-FUI-2127.1

11 months ago

14.195.1-alpha-d2b1b03.0

1 year ago

14.188.0-fui-2012.2

1 year ago

14.198.1-alpha-3f8f444.0

12 months ago

14.199.3-alpha-40ecfcd.0

11 months ago

12 months ago

12 months ago

14.195.1-alpha-2acf4e6.0

1 year ago

14.200.1-alpha-e974201.0

11 months ago

1 year ago

1 year ago

14.195.2-alpha-505284e.0

12 months ago

1 year ago

1 year ago

14.183.8-alpha-63f9910.0

1 year ago

11 months ago

12 months ago

12 months ago

14.192.2-fdc3-enhancements.11

12 months ago

14.183.0-pa-1217.1

1 year ago

14.192.2-fdc3-enhancements.12

12 months ago

14.202.1-alpha-34c59e8.0

11 months ago

11 months ago

14.192.2-fdc3-enhancements.10

12 months ago

14.192.2-axes.2

1 year ago

1 year ago

14.189.0-PA-1226-fix.1

1 year ago

14.195.2-alpha-8d2dc82.0

1 year ago

1 year ago

14.195.1-alpha-5b4d154.0

1 year ago

1 year ago

1 year ago

14.192.2-publicpath.2

1 year ago

1 year ago

1 year ago

14.192.2-publicpath.1

1 year ago

1 year ago

14.197.1-alpha-bd261ef.0

12 months ago

1 year ago

1 year ago

1 year ago

1 year ago

14.180.1-GENC-376.4

1 year ago

14.180.1-GENC-376.2

1 year ago

14.180.1-GENC-376.1

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

14.177.1-raise-intent.3

1 year ago

1 year ago

14.177.2-alpha-ca0c7658ab2.0

1 year ago

14.177.0-raise-intent.1

1 year ago

14.177.0-raise-intent.2

1 year ago

14.177.0-raise-intent.3

1 year ago

14.177.2-alpha-f467137.0

1 year ago

1 year ago

14.176.1-alpha-ed9e3d4.0

1 year ago

1 year ago

14.176.1-alpha-6ef4895.0

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

14.173.2-genc-376.1

1 year ago

1 year ago

14.173.2-genc-374.1

1 year ago

1 year ago

14.173.2-alpha-090e5e7.0

1 year ago

1 year ago

1 year ago

1 year ago

14.172.2-PA-1208.2

1 year ago

1 year ago

1 year ago

14.172.1-alpha-30b1afc.0

1 year ago

1 year ago