@cratis/showrunner.usher.react 0.0.0-bootstrap.0

package/Issues/IssueView/IssueHeader.tsx

@@ -0,0 +1,69 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { Button } from '@cratis/components/Common';
+import { Tag } from '@cratis/components/Display';
+import { IssueConversation } from '@cratis/showrunner.usher';
+import { format } from '../../Labels/index.js';
+import { useUsherContext } from '../../Provider/UsherContext.js';
+import { formatTime } from '../../Reporting/AccessChoice.js';
+import { formatLocation } from '../../Reporting/formatLocation.js';
+import { BackIcon } from '../../Icons.js';
+import { stateBadgeFor } from '../issueStates.js';
+import { isFixReleased } from '../MyIssuesList.js';
+import { isWebAddress } from '../webAddress.js';
+
+/**
+ * Props for {@link IssueHeader}.
+ */
+export interface IssueHeaderProps {
+    /** The issue. */
+    issue: IssueConversation;
+
+    /** Goes back to the list of issues; no back button when not given. */
+    onBack?: () => void;
+}
+
+/**
+ * The header of an issue: its title and state, when and where it was reported, and what it is linked to.
+ */
+export const IssueHeader = ({ issue, onBack }: IssueHeaderProps) => {
+    const { labels, locale } = useUsherContext();
+    const badge = stateBadgeFor(issue.state, labels);
+    const reportedAt = issue.reportedAt instanceof Date ? issue.reportedAt : new Date(issue.reportedAt);
+    const location = formatLocation(issue.location, labels.common.locationSeparator, labels.common.unknownLocation);
+    const workItem = issue.workItem;
+    const hasWorkItem = (workItem?.reference ?? '').length > 0;
+
+    return (
+        <header className='usher-issue-header'>
+            {onBack && (
+                <Button variant='ghost' size='small' icon={<BackIcon />} onClick={onBack} label={labels.issue.back} />
+            )}
+            <div className='usher-issue-header__title-row'>
+                <h3 className='usher-issue-header__title'>{issue.title}</h3>
+                <Tag value={badge.label} severity={badge.severity} />
+            </div>
+            <p className='usher-issue-header__meta'>
+                {format(labels.issue.reported, { date: formatTime(reportedAt, locale) })} · {location}
+            </p>
+            {(issue.knownIssueTitle?.length > 0 || hasWorkItem) && (
+                <p className='usher-issue-header__links'>
+                    {issue.knownIssueTitle?.length > 0 && (
+                        <span>{labels.issue.knownIssue} <strong>{issue.knownIssueTitle}</strong></span>
+                    )}
+                    {hasWorkItem && (
+                        <span>
+                            {labels.issue.trackedIn}{' '}
+                            {isWebAddress(workItem.url)
+                                ? <a href={workItem.url} target='_blank' rel='noreferrer'>{workItem.reference}</a>
+                                : <strong>{workItem.reference}</strong>}
+                            {' · '}
+                            {isFixReleased(issue) ? format(labels.issue.fixedIn, { version: issue.fixedInVersion }) : labels.issue.notReleased}
+                        </span>
+                    )}
+                </p>
+            )}
+        </header>
+    );
+};

package/Issues/IssueView/IssueView.tsx

@@ -0,0 +1,74 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { Message } from '@cratis/components/Display';
+import { Guid } from '@cratis/fundamentals';
+import { ForIssue } from '@cratis/showrunner.usher';
+import { UsherBoundary } from '../../Provider/UsherBoundary.js';
+import { useUsherLabels } from '../../Provider/UsherContext.js';
+import { isOpenQuestion } from '../conversationMessages.js';
+import { AccessPanel } from './AccessPanel.js';
+import { IdentityPanel } from './IdentityPanel.js';
+import { IssueActions } from './IssueActions.js';
+import { IssueConversationPanel } from './IssueConversationPanel.js';
+import { IssueHeader } from './IssueHeader.js';
+import { QuestionBanner } from './QuestionBanner.js';
+import { StatusStrip } from './StatusStrip.js';
+
+/**
+ * Props for {@link IssueView}.
+ */
+export interface IssueViewProps {
+    /** The issue to show. */
+    issueId: Guid;
+
+    /** Goes back to the list of issues; no back button when not given. */
+    onBack?: () => void;
+}
+
+/**
+ * One of the signed-in reporter's issues: its state, the conversation with support, who support knows the reporter
+ * is, support's access, and what the reporter can do with it. It stays current as support works on the issue.
+ * Usable on its own, such as on a page of the solution, or inside the my issues side sheet.
+ */
+export const IssueView = (props: IssueViewProps) => (
+    <UsherBoundary>
+        <IssueViewContent {...props} />
+    </UsherBoundary>
+);
+
+const IssueViewContent = ({ issueId, onBack }: IssueViewProps) => {
+    const labels = useUsherLabels();
+    const [result] = ForIssue.use({ issueId });
+
+    // The query answers with the issue or with nothing: an issue the reporter did not report, or one support's session
+    // is not for, is never sent.
+    const issue = result.data?.[0];
+    const isLoaded = result.hasData && issue?.id !== undefined;
+
+    if (!isLoaded) {
+        return (
+            <div className='usher-issue-view'>
+                <Message severity={result.isPerforming ? 'info' : 'secondary'} text={result.isPerforming ? labels.issue.loading : labels.issue.notFound} />
+            </div>
+        );
+    }
+
+    const openQuestion = issue.openQuestion;
+
+    return (
+        <div className='usher-issue-view'>
+            <IssueHeader issue={issue} onBack={onBack} />
+            <StatusStrip state={issue.state} />
+            {isOpenQuestion(openQuestion?.questionId) && <QuestionBanner question={openQuestion.question} />}
+            <div className='usher-issue-view__body'>
+                <IssueConversationPanel issue={issue} />
+                <aside className='usher-issue-view__side'>
+                    <IdentityPanel issue={issue} />
+                    <AccessPanel issue={issue} />
+                    <IssueActions issue={issue} />
+                </aside>
+            </div>
+        </div>
+    );
+};

package/Issues/IssueView/QuestionBanner.tsx

@@ -0,0 +1,27 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { Message } from '@cratis/components/Display';
+import { format } from '../../Labels/index.js';
+import { useUsherLabels } from '../../Provider/UsherContext.js';
+
+/**
+ * Props for {@link QuestionBanner}.
+ */
+export interface QuestionBannerProps {
+    /** What support asked. */
+    question: string;
+}
+
+/**
+ * Tells the reporter that support waits for an answer, and that their next message answers it.
+ */
+export const QuestionBanner = ({ question }: QuestionBannerProps) => {
+    const labels = useUsherLabels();
+
+    return (
+        <div className='usher-question-banner'>
+            <Message severity='warn' text={format(labels.issue.questionBanner, { question })} />
+        </div>
+    );
+};

package/Issues/IssueView/ReopenIssueDialog.tsx

@@ -0,0 +1,37 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { CommandDialog } from '@cratis/components/CommandDialog';
+import { TextAreaField } from '@cratis/components/CommandForm';
+import { DialogInitialFocus } from '@cratis/components/Dialogs';
+import { Guid } from '@cratis/fundamentals';
+import { ReopenIssue } from '@cratis/showrunner.usher';
+import { useUsherLabels } from '../../Provider/UsherContext.js';
+
+/**
+ * Props for {@link ReopenIssueDialog}.
+ */
+export interface ReopenIssueDialogProps {
+    /** The issue. */
+    issueId: Guid;
+}
+
+/**
+ * Lets the reporter reopen a resolved issue, saying why it is not fixed.
+ */
+export const ReopenIssueDialog = ({ issueId }: ReopenIssueDialogProps) => {
+    const labels = useUsherLabels();
+
+    return (
+        <CommandDialog<ReopenIssue>
+            command={ReopenIssue}
+            title={labels.actions.reopenTitle}
+            okLabel={labels.actions.reopen}
+            cancelLabel={labels.common.cancel}
+            closeAriaLabel={labels.common.close}
+            initialFocus={DialogInitialFocus.Content}
+            initialValues={{ issueId, reason: '' }}>
+            <TextAreaField<ReopenIssue> value={command => command.reason} title={labels.actions.reopenReason} rows={4} />
+        </CommandDialog>
+    );
+};

package/Issues/IssueView/ShareIdentityDialog.tsx

@@ -0,0 +1,37 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { CommandDialog } from '@cratis/components/CommandDialog';
+import { DialogInitialFocus } from '@cratis/components/Dialogs';
+import { Guid } from '@cratis/fundamentals';
+import { ShareIdentity } from '@cratis/showrunner.usher';
+import { useUsherLabels } from '../../Provider/UsherContext.js';
+
+/**
+ * Props for {@link ShareIdentityDialog}.
+ */
+export interface ShareIdentityDialogProps {
+    /** The issue. */
+    issueId: Guid;
+}
+
+/**
+ * Asks the reporter to confirm that support may know who they are on an issue. Sharing cannot be undone, so the
+ * dialog opens with focus on cancel.
+ */
+export const ShareIdentityDialog = ({ issueId }: ShareIdentityDialogProps) => {
+    const labels = useUsherLabels();
+
+    return (
+        <CommandDialog<ShareIdentity>
+            command={ShareIdentity}
+            title={labels.identity.shareTitle}
+            okLabel={labels.identity.shareConfirm}
+            cancelLabel={labels.common.cancel}
+            closeAriaLabel={labels.common.close}
+            initialFocus={DialogInitialFocus.Cancel}
+            initialValues={{ issueId }}>
+            <p className='usher-dialog-text'>{labels.identity.shareDescription}</p>
+        </CommandDialog>
+    );
+};

package/Issues/IssueView/StatusStrip.tsx

@@ -0,0 +1,42 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { IssueState } from '@cratis/showrunner.usher';
+import { useUsherLabels } from '../../Provider/UsherContext.js';
+import { stateBadgeFor, statusStepOf, statusSteps } from '../issueStates.js';
+
+/**
+ * Props for {@link StatusStrip}.
+ */
+export interface StatusStripProps {
+    /** The state the issue is in. */
+    state: IssueState;
+}
+
+/**
+ * Shows how far along an issue is, from reported to resolved. The step reached is marked as the current step.
+ */
+export const StatusStrip = ({ state }: StatusStripProps) => {
+    const labels = useUsherLabels();
+    const reached = statusStepOf(state);
+    const closedOtherwise = state === IssueState.wontFix || state === IssueState.withdrawn;
+
+    return (
+        <ol className='usher-status-strip'>
+            {statusSteps.map((step, index) => {
+                const isCurrent = index === reached;
+                const label = isCurrent && closedOtherwise ? stateBadgeFor(state, labels).label : stateBadgeFor(step, labels).label;
+                return (
+                    <li
+                        key={step}
+                        className='usher-status-strip__step'
+                        data-reached={index <= reached || undefined}
+                        data-current={isCurrent || undefined}
+                        aria-current={isCurrent ? 'step' : undefined}>
+                        {label}
+                    </li>
+                );
+            })}
+        </ol>
+    );
+};

package/Issues/IssueView/SupportSessions.tsx

@@ -0,0 +1,59 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { ConversationEntry, SupportSession } from '@cratis/showrunner.usher';
+import { format } from '../../Labels/index.js';
+import { useUsherContext } from '../../Provider/UsherContext.js';
+import { formatClock, formatTime } from '../../Reporting/AccessChoice.js';
+import { isSessionRunning } from '../accessStatus.js';
+import { sessionActivityOf } from '../sessionActivity.js';
+
+/**
+ * Props for {@link SupportSessions}.
+ */
+export interface SupportSessionsProps {
+    /** The sessions, oldest first. */
+    sessions: SupportSession[];
+
+    /** The entries of the conversation, to show what support did in each session. */
+    entries: ConversationEntry[];
+}
+
+/**
+ * Lists the sessions in which support signed in as the reporter, each with what support did as the reporter in it.
+ */
+export const SupportSessions = ({ sessions, entries }: SupportSessionsProps) => {
+    const { labels, locale } = useUsherContext();
+
+    if (sessions.length === 0) {
+        return <p className='usher-panel__text usher-panel__text--secondary'>{labels.accessPanel.noSessions}</p>;
+    }
+
+    return (
+        <div className='usher-sessions'>
+            <span className='usher-sessions__heading'>{labels.accessPanel.sessionsHeading}</span>
+            <ul className='usher-sessions__list'>
+                {sessions.map(session => {
+                    const start = formatTime(asDate(session.startedAt), locale);
+                    const end = isSessionRunning(session) ? labels.accessPanel.sessionRunning : formatClock(asDate(session.endedAt), locale);
+                    const name = (session.author?.name ?? '').length > 0 ? session.author.name : labels.conversation.support;
+                    const activity = sessionActivityOf(session, entries, labels.accessPanel.sessionActions);
+                    return (
+                        <li key={session.sessionId.toString()}>
+                            {format(labels.accessPanel.session, { name, start, end })}
+                            {activity.length > 0
+                                ? (
+                                    <ul className='usher-sessions__activity'>
+                                        {activity.map(action => <li key={action.entryId}>{action.text}</li>)}
+                                    </ul>
+                                )
+                                : <p className='usher-sessions__activity usher-panel__text--secondary'>{labels.accessPanel.sessionDidNothing}</p>}
+                        </li>
+                    );
+                })}
+            </ul>
+        </div>
+    );
+};
+
+const asDate = (value: Date | string) => value instanceof Date ? value : new Date(value);

package/Issues/IssueView/index.ts

@@ -0,0 +1,15 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+export * from './AccessPanel.js';
+export * from './GrantAccessDialog.js';
+export * from './IdentityPanel.js';
+export * from './IssueActions.js';
+export * from './IssueConversationPanel.js';
+export * from './IssueHeader.js';
+export * from './IssueView.js';
+export * from './QuestionBanner.js';
+export * from './ReopenIssueDialog.js';
+export * from './ShareIdentityDialog.js';
+export * from './StatusStrip.js';
+export * from './SupportSessions.js';

package/Issues/MyIssues/IssueList.tsx

@@ -0,0 +1,78 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { Column, DataTableFilterMatchMode, DataTableForObservableQuery } from '@cratis/components/DataTables';
+import { Tag } from '@cratis/components/Display';
+import { IssueKind, MyIssues, ReportedIssue } from '@cratis/showrunner.usher';
+import { format } from '../../Labels/index.js';
+import { useUsherContext } from '../../Provider/UsherContext.js';
+import { formatTime } from '../../Reporting/AccessChoice.js';
+import { isClosed, stateBadgeFor, statusSteps } from '../issueStates.js';
+import { isFixReleased } from '../MyIssuesList.js';
+
+/**
+ * Props for {@link IssueList}.
+ */
+export interface IssueListProps {
+    /** Whether to list closed issues too. */
+    showClosed: boolean;
+
+    /** Opens an issue. */
+    onOpen: (issue: ReportedIssue) => void;
+}
+
+const openStates = statusSteps.filter(state => !isClosed(state));
+
+/**
+ * The signed-in reporter's issues, most recent activity first, as they change.
+ */
+export const IssueList = ({ showClosed, onOpen }: IssueListProps) => {
+    const { labels, locale } = useUsherContext();
+
+    return (
+        <DataTableForObservableQuery<MyIssues, ReportedIssue, object>
+            key={showClosed ? 'all' : 'open'}
+            query={MyIssues}
+            dataKey='id'
+            emptyMessage={labels.myIssues.empty}
+            filteredEmptyMessage={labels.myIssues.noOpenIssues}
+            loadingMessage={labels.myIssues.loading}
+            failureMessage={labels.myIssues.failed}
+            unauthorizedMessage={labels.myIssues.unauthorized}
+            defaultFilters={showClosed ? {} : { state: { value: openStates, matchMode: DataTableFilterMatchMode.In } }}
+            selectionMode='single'
+            selection={null}
+            onSelectionChange={event => {
+                if (event.value) {
+                    onOpen(event.value);
+                }
+            }}>
+            <Column<ReportedIssue>
+                field='title'
+                header={labels.myIssues.issueColumn}
+                body={issue => (
+                    <span className='usher-issue-list__title'>
+                        <span>{issue.title}</span>
+                        <span className='usher-issue-list__kind'>{issue.kind === IssueKind.error ? labels.myIssues.errorKind : labels.myIssues.manualKind}</span>
+                    </span>
+                )} />
+            <Column<ReportedIssue>
+                field='state'
+                header={labels.myIssues.stateColumn}
+                body={issue => {
+                    const badge = stateBadgeFor(issue.state, labels);
+                    return (
+                        <span className='usher-issue-list__state'>
+                            <Tag value={badge.label} severity={badge.severity} />
+                            {issue.waitingOnReporter && <Tag value={labels.myIssues.waitingForYou} severity='warn' />}
+                            {isFixReleased(issue) && <Tag value={format(labels.myIssues.fixedIn, { version: issue.fixedInVersion })} severity='success' />}
+                        </span>
+                    );
+                }} />
+            <Column<ReportedIssue>
+                field='lastActivityAt'
+                header={labels.myIssues.lastActivityColumn}
+                body={issue => formatTime(issue.lastActivityAt instanceof Date ? issue.lastActivityAt : new Date(issue.lastActivityAt), locale)} />
+        </DataTableForObservableQuery>
+    );
+};

package/Issues/MyIssues/MyIssuesDialog.tsx

@@ -0,0 +1,64 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { Button, Switch } from '@cratis/components/Common';
+import { Dialog, DialogInitialFocus } from '@cratis/components/Dialogs';
+import { Guid } from '@cratis/fundamentals';
+import { useReducer } from 'react';
+import { BugIcon } from '../../Icons.js';
+import { UsherBoundary } from '../../Provider/UsherBoundary.js';
+import { useUsherLabels } from '../../Provider/UsherContext.js';
+import { IssueView } from '../IssueView/IssueView.js';
+import { IssueList } from './IssueList.js';
+import { navigate, startNavigation } from './MyIssuesNavigation.js';
+
+/**
+ * Props for {@link MyIssuesDialog}.
+ */
+export interface MyIssuesDialogProps {
+    /** The issue to open on; the list of issues when not given. */
+    issueId?: Guid;
+
+    /** Opens the report a problem dialog; no report button when not given. */
+    onReportIssue?: () => void;
+}
+
+/**
+ * The my issues side sheet: the signed-in reporter's issues, and one issue at a time with its conversation. Open it
+ * with `useDialog`.
+ */
+export const MyIssuesDialog = ({ issueId, onReportIssue }: MyIssuesDialogProps) => {
+    const labels = useUsherLabels();
+    const [navigation, dispatch] = useReducer(navigate, issueId, startNavigation);
+    if (navigation.requestedIssueId !== issueId) {
+        dispatch({ type: 'requested', issueId });
+    }
+
+    return (
+        <Dialog
+            title={labels.myIssues.title}
+            subtitle={labels.myIssues.description}
+            placement='end'
+            width='720px'
+            buttons={null}
+            dismissable
+            initialFocus={DialogInitialFocus.Content}
+            closeAriaLabel={labels.common.close}>
+            <UsherBoundary>
+                {navigation.openIssueId
+                    ? <IssueView issueId={navigation.openIssueId} onBack={() => dispatch({ type: 'back' })} />
+                    : (
+                        <div className='usher-my-issues'>
+                            <div className='usher-my-issues__toolbar'>
+                                {onReportIssue && (
+                                    <Button variant='solid' tone='accent' size='small' icon={<BugIcon />} label={labels.myIssues.reportProblem} onClick={onReportIssue} />
+                                )}
+                                <Switch label={labels.myIssues.showClosed} checked={navigation.showClosed} onChange={showClosed => dispatch({ type: 'showClosedChanged', showClosed })} />
+                            </div>
+                            <IssueList showClosed={navigation.showClosed} onOpen={issue => dispatch({ type: 'opened', issueId: issue.id })} />
+                        </div>
+                    )}
+            </UsherBoundary>
+        </Dialog>
+    );
+};

package/Issues/MyIssues/MyIssuesNavigation.ts

@@ -0,0 +1,61 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { Guid } from '@cratis/fundamentals';
+
+/**
+ * Where the my issues side sheet is: the list, or one issue.
+ */
+export interface MyIssuesNavigation {
+    /** The issue shown; the list when not set. */
+    readonly openIssueId?: Guid;
+
+    /** The issue the side sheet was last asked to open on, so a new request moves to it. */
+    readonly requestedIssueId?: Guid;
+
+    /** Whether the list shows closed issues too. */
+    readonly showClosed: boolean;
+}
+
+/**
+ * Something that moves the my issues side sheet.
+ */
+export type MyIssuesNavigationAction =
+    | { readonly type: 'requested'; readonly issueId?: Guid }
+    | { readonly type: 'opened'; readonly issueId: Guid }
+    | { readonly type: 'back' }
+    | { readonly type: 'showClosedChanged'; readonly showClosed: boolean };
+
+/**
+ * Gets where the side sheet starts: on the issue asked for, or on the list of open issues.
+ * @param issueId The issue to open on; the list when not given.
+ * @returns The {@link MyIssuesNavigation}.
+ */
+export function startNavigation(issueId?: Guid): MyIssuesNavigation {
+    return { openIssueId: issueId, requestedIssueId: issueId, showClosed: false };
+}
+
+/**
+ * Moves the side sheet.
+ * @param navigation Where the side sheet is.
+ * @param action What moves it.
+ * @returns Where it is after.
+ */
+export function navigate(navigation: MyIssuesNavigation, action: MyIssuesNavigationAction): MyIssuesNavigation {
+    switch (action.type) {
+        case 'requested':
+            return sameIssue(navigation.requestedIssueId, action.issueId)
+                ? navigation
+                : { ...navigation, openIssueId: action.issueId, requestedIssueId: action.issueId };
+        case 'opened':
+            return { ...navigation, openIssueId: action.issueId };
+        case 'back':
+            return { ...navigation, openIssueId: undefined };
+        case 'showClosedChanged':
+            return { ...navigation, showClosed: action.showClosed };
+    }
+}
+
+function sameIssue(left?: Guid, right?: Guid): boolean {
+    return left === right || (left !== undefined && right !== undefined && left.equals(right));
+}

package/Issues/MyIssues/index.ts

@@ -0,0 +1,6 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+export * from './IssueList.js';
+export * from './MyIssuesDialog.js';
+export * from './MyIssuesNavigation.js';

package/Issues/MyIssuesList.ts

@@ -0,0 +1,33 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { ReportedIssue } from '@cratis/showrunner.usher';
+import { isClosed } from './issueStates.js';
+
+/**
+ * Counts the issues support waits for the reporter on.
+ * @param issues The reporter's issues.
+ * @returns How many issues support waits for the reporter on.
+ */
+export function waitingCount(issues: ReportedIssue[]): number {
+    return issues.filter(issue => issue.waitingOnReporter).length;
+}
+
+/**
+ * Gets the issues to list.
+ * @param issues The reporter's issues, most recent activity first.
+ * @param showClosed Whether to list closed issues too.
+ * @returns The issues to list, in the order given.
+ */
+export function visibleIssues(issues: ReportedIssue[], showClosed: boolean): ReportedIssue[] {
+    return showClosed ? issues : issues.filter(issue => !isClosed(issue.state));
+}
+
+/**
+ * Checks whether a release has the fix for an issue.
+ * @param issue The issue.
+ * @returns True when a release has the fix.
+ */
+export function isFixReleased(issue: { fixedInVersion: string }): boolean {
+    return typeof issue.fixedInVersion === 'string' && issue.fixedInVersion.length > 0;
+}