Cygnus Reach Session UI for Angular

This library provides configurable UI components designed to work with the Reach Session web library, allowing for the creation of Reach portals and "zero-install" web apps for use by support agents and technicians alike. This library was built with Angular 18.2.13 and has been tested in Angular 18 and 20.

Usage

UI components in this library are designed for use with the SessionService Angular service provided in this library, which extends the Reach Session library's implementation for optimized use in an Angular context. Theming can be customized using CSS variables and classes described here, alongside text and iconography customization.

Changelog

• 2.0.0
  • Updated to rxjs 7.x
  • Removed dependencies on @swimlane/ngx-datatable and ngx-toastr
  • Widened support for Angular versions to 18-21.
  • Replaced lib- selector prefix with cyg-rs- prefix across full library
  • Revised styling system to fully support runtime editing and light and dark modes. This represents the 2026 Constellation Design System, simplifying the color and typography styling systems, alongside numerous other changes.
  • Reduced scope of items exposed for public use, hiding a number of low-level internal components, models, and utilities that were not intended for external usage.
  • Aligned all component inputs with icons and text model, affecting SessionHistory, SessionResources, SessionView, and ConnectedMediaEditor
  • Introduced new component for session creation and invitation process: CreateSession. Also exposed two underlying components for customization, InvitationGrid and InvitationDialog.
  • Introduced new output for SessionResources, StreamUnit, and ConnectedMediaEditor to replace internal display of toasts. Now, components wishing to display momentary pop-up notifications in the UI will emit events with NotificationEvent payloads.
• 1.5.1 (Beta releases only)
  • Reverted renaming of EnterSession, TextTabs, and IconTabs.
  • Renamed input interfaces for SessionView and SessionViewHeader to reflect new component names.
  • Fixed inconsistent fields in MediaViewIcons, removing an unused delete field and adding a missing edit field. This affects the MediaView and SessionResources components.
  • Reverted changes to field names in EnterSessionText and SessionInviteText, replacing btnText with previous context-based names.
  • Fixed bug in SessionHistory that caused errors when mediaText input was not provided.
  • Fixed bug in SessionInviteUser that caused phone number formatting to not be shown.
  • Updated GenericMatDataTable styling to better fit into customizable styling.
  • Reorganized exported text defaults to group them by functional area. Items formerly in TextDefaults are now available in:
    • ChatTextDefaults
    • DeviceTextDefaults
    • HistoryTextDefaults
    • MediaTextDefaults
    • NoteTextDefaults
    • SessionTextDefaults
    • StreamTextDefaults
    • ConnectedUITextDefaults
    • SharedTextDefaults
  • Removed a number of deprecated and unused models and constants:
    • Tab enumeration: SessionTab should be used in its place.
    • User class.
    • Various deprecated internal screen drawing constants:
      • DEFAULT_ERASER_WIDTH
      • DEFAULT_ERASER_COLOR
      • DESTINATION_OUT
      • SOURCE_OVER
• 1.5.0
  • Updated to Angular 18.2.13.
  • Renamed various components:
    • EnterSession → StartSession
    • TextTabs → TextTab
    • IconTabs → IconTab
    • ArchivedSessionView → SessionView
    • ArchivedSessionHeader → SessionViewHeader
  • Revised SessionView component to not include SessionViewHeader by default.
  • Introduced new table component, GenericMatDataTable, which now serves as the basis for the SessionHistoryTable component.
  • Introduced new button utility components: BaseButton, ChatInputButton, ChatMediaButton, and MediaEditorRoundButton.
  • Changed button-related field names in EnterSessionText and SessionInviteText to btnText.
• 1.4.4
  • Re-release to fix configuration error.
• 1.4.3
  • Revised SMS phone number validation (not published).
• 1.4.2
  • Updated dependencies.
• 1.4.1
  • Improved functionality of drag-to-download feature on media cards, providing increased support for images dragged into programs.
  • Bugfix to ChatInput, keeping the submit event from being fired without canSend being set.
  • Fixed bug causing viewing a session within SessionHistory to affect recording of history.
• 1.4.0
  • Revised stream units to use improved start/end share system, ensuring browser permissions are released when not in use.
  • Added UI for pending stream source state.
  • Added optional input-configured drag-to-download system for session media (in history or resources), supported by Google Chrome and some other Chromium-based browsers.
• 1.3.1
  • Request state handling added to stream units.
  • Welcome text configuration added to stream units.
  • Bugfixes to icon inheritance in media file display grids and generic dialog close icons.
• 1.3.0
  • Small fix to GenericDialog configuration.
• 1.2.1
  • Update to session service configuration with regards to session invitations.
• 1.2.0
  • Initial release.