github-issue-tower-defence-management 1.153.6 → 1.154.1

package/src/adapter/repositories/projectFieldDefinition.test.ts

@@ -0,0 +1,189 @@
+import {
+  ProjectFieldDefinition,
+  convertToFieldOptionColor,
+  projectFromDefinition,
+} from './projectFieldDefinition';
+
+describe('convertToFieldOptionColor', () => {
+  it('should preserve PINK so the Todo by human status button renders pink', () => {
+    expect(convertToFieldOptionColor('PINK')).toEqual('PINK');
+  });
+
+  it('should preserve ORANGE so the Unread status button renders orange', () => {
+    expect(convertToFieldOptionColor('ORANGE')).toEqual('ORANGE');
+  });
+
+  it('should preserve the remaining GitHub project option colors', () => {
+    expect(convertToFieldOptionColor('RED')).toEqual('RED');
+    expect(convertToFieldOptionColor('YELLOW')).toEqual('YELLOW');
+    expect(convertToFieldOptionColor('GREEN')).toEqual('GREEN');
+    expect(convertToFieldOptionColor('BLUE')).toEqual('BLUE');
+    expect(convertToFieldOptionColor('PURPLE')).toEqual('PURPLE');
+    expect(convertToFieldOptionColor('GRAY')).toEqual('GRAY');
+  });
+
+  it('should fall back to GRAY for an unknown color value', () => {
+    expect(convertToFieldOptionColor('UNKNOWN')).toEqual('GRAY');
+  });
+});
+
+describe('projectFromDefinition', () => {
+  const statusField: ProjectFieldDefinition = {
+    fieldId: 'PVTSSF_status',
+    databaseId: 12940049,
+    name: 'Status',
+    options: [
+      {
+        id: 'f75ad846',
+        name: 'Unread',
+        color: 'ORANGE',
+        description: '',
+      },
+    ],
+  };
+  const storyField: ProjectFieldDefinition = {
+    fieldId: 'PVTSSF_story',
+    databaseId: 133939017,
+    name: 'story',
+    options: [
+      {
+        id: '6dc26727',
+        name: 'regular / workflow management',
+        color: 'BLUE',
+        description: 'workflow',
+      },
+      {
+        id: '4ada6c4c',
+        name: 'regular / entertainment',
+        color: 'BLUE',
+        description: '',
+      },
+    ],
+  };
+
+  it('should map the status field and every optional field it finds by name', () => {
+    const project = projectFromDefinition({
+      id: 'PVT_project',
+      url: 'https://github.com/users/HiromiShikata/projects/48',
+      databaseId: 1403371,
+      name: 'UMINO',
+      fields: [
+        statusField,
+        storyField,
+        {
+          fieldId: 'PVTF_nextactiondate',
+          databaseId: 35978365,
+          name: 'nextactiondate',
+          options: [],
+        },
+        {
+          fieldId: 'PVTSSF_nextactionhour',
+          databaseId: 133948391,
+          name: 'nextactionhour',
+          options: [],
+        },
+        {
+          fieldId: 'PVTF_remaining',
+          databaseId: 1,
+          name: 'remaining estimation minutes',
+          options: [],
+        },
+        {
+          fieldId: 'PVTF_depended',
+          databaseId: 156128545,
+          name: 'Depended Issue URL separated by comma',
+          options: [],
+        },
+        {
+          fieldId: 'PVTF_completion',
+          databaseId: 2,
+          name: 'Completion Date (50% Confidence)',
+          options: [],
+        },
+      ],
+    });
+
+    expect(project).toEqual({
+      id: 'PVT_project',
+      url: 'https://github.com/users/HiromiShikata/projects/48',
+      databaseId: 1403371,
+      name: 'UMINO',
+      status: {
+        name: 'Status',
+        fieldId: 'PVTSSF_status',
+        statuses: statusField.options,
+      },
+      nextActionDate: {
+        name: 'nextactiondate',
+        fieldId: 'PVTF_nextactiondate',
+      },
+      nextActionHour: {
+        name: 'nextactionhour',
+        fieldId: 'PVTSSF_nextactionhour',
+      },
+      story: {
+        name: 'story',
+        fieldId: 'PVTSSF_story',
+        databaseId: 133939017,
+        stories: storyField.options,
+        workflowManagementStory: storyField.options[0],
+      },
+      remainingEstimationMinutes: {
+        name: 'remaining estimation minutes',
+        fieldId: 'PVTF_remaining',
+      },
+      dependedIssueUrlSeparatedByComma: {
+        name: 'Depended Issue URL separated by comma',
+        fieldId: 'PVTF_depended',
+      },
+      completionDate50PercentConfidence: {
+        name: 'Completion Date (50% Confidence)',
+        fieldId: 'PVTF_completion',
+      },
+    });
+  });
+
+  it('should leave every optional field null when the project carries only the status field', () => {
+    const project = projectFromDefinition({
+      id: 'PVT_project',
+      url: 'https://github.com/orgs/X-Mile/projects/7',
+      databaseId: 7,
+      name: 'minimal',
+      fields: [statusField],
+    });
+
+    expect(project.story).toBeNull();
+    expect(project.nextActionDate).toBeNull();
+    expect(project.nextActionHour).toBeNull();
+    expect(project.remainingEstimationMinutes).toBeNull();
+    expect(project.dependedIssueUrlSeparatedByComma).toBeNull();
+    expect(project.completionDate50PercentConfidence).toBeNull();
+  });
+
+  it('should leave the story null when no option names the workflow management story', () => {
+    const project = projectFromDefinition({
+      id: 'PVT_project',
+      url: 'https://github.com/users/HiromiShikata/projects/48',
+      databaseId: 1403371,
+      name: 'UMINO',
+      fields: [
+        statusField,
+        { ...storyField, options: [storyField.options[1]] },
+      ],
+    });
+
+    expect(project.story).toBeNull();
+  });
+
+  it('should throw when the project has no status field', () => {
+    expect(() =>
+      projectFromDefinition({
+        id: 'PVT_project',
+        url: 'https://github.com/users/HiromiShikata/projects/48',
+        databaseId: 1403371,
+        name: 'UMINO',
+        fields: [storyField],
+      }),
+    ).toThrow('status field is not found');
+  });
+});

package/src/adapter/repositories/projectFieldDefinition.ts

@@ -0,0 +1,131 @@
+import { FieldOption, Project } from '../../domain/entities/Project';
+import {
+  DEPENDED_ISSUE_URL_FIELD_NAME,
+  NEXT_ACTION_DATE_FIELD_NAME,
+  NEXT_ACTION_HOUR_FIELD_NAME,
+  STORY_FIELD_NAME,
+} from '../../domain/entities/RequiredProjectField';
+import { normalizeFieldName } from './utils';
+
+export type ProjectFieldDefinition = {
+  fieldId: string;
+  databaseId: number;
+  name: string;
+  options: FieldOption[];
+};
+
+export type ProjectDefinition = {
+  id: string;
+  url: string;
+  databaseId: number;
+  name: string;
+  fields: ProjectFieldDefinition[];
+};
+
+export const convertToFieldOptionColor = (
+  color: string,
+): FieldOption['color'] => {
+  switch (color) {
+    case 'RED':
+    case 'YELLOW':
+    case 'GREEN':
+    case 'BLUE':
+    case 'PURPLE':
+    case 'ORANGE':
+    case 'PINK':
+    case 'GRAY':
+      return color;
+    default:
+      return 'GRAY';
+  }
+};
+
+export const projectFromDefinition = (
+  definition: ProjectDefinition,
+): Project => {
+  const nextActionDate = definition.fields.find(
+    (field) =>
+      normalizeFieldName(field.name) ===
+      normalizeFieldName(NEXT_ACTION_DATE_FIELD_NAME),
+  );
+  const nextActionHour = definition.fields.find(
+    (field) =>
+      normalizeFieldName(field.name) ===
+      normalizeFieldName(NEXT_ACTION_HOUR_FIELD_NAME),
+  );
+  const status = definition.fields.find(
+    (field) => normalizeFieldName(field.name) === 'status',
+  );
+  if (!status) {
+    throw new Error('status field is not found');
+  }
+  const story = definition.fields.find(
+    (field) =>
+      normalizeFieldName(field.name) === normalizeFieldName(STORY_FIELD_NAME),
+  );
+  const workflowManagementStory = story?.options.find((option) =>
+    normalizeFieldName(option.name).includes('workflowmanagement'),
+  );
+  const remainingEstimationMinutes = definition.fields.find(
+    (field) => normalizeFieldName(field.name) === 'remainingestimationminutes',
+  );
+  const dependedIssueUrlSeparatedByComma = definition.fields.find((field) =>
+    normalizeFieldName(field.name).startsWith(
+      normalizeFieldName(DEPENDED_ISSUE_URL_FIELD_NAME),
+    ),
+  );
+  const completionDate50PercentConfidence = definition.fields.find((field) =>
+    normalizeFieldName(field.name).startsWith('completiondate'),
+  );
+  return {
+    id: definition.id,
+    url: definition.url,
+    databaseId: definition.databaseId,
+    name: definition.name,
+    status: {
+      name: status.name,
+      fieldId: status.fieldId,
+      statuses: status.options,
+    },
+    nextActionDate: nextActionDate
+      ? {
+          name: nextActionDate.name,
+          fieldId: nextActionDate.fieldId,
+        }
+      : null,
+    nextActionHour: nextActionHour
+      ? {
+          name: nextActionHour.name,
+          fieldId: nextActionHour.fieldId,
+        }
+      : null,
+    story:
+      story && workflowManagementStory
+        ? {
+            name: story.name,
+            fieldId: story.fieldId,
+            databaseId: story.databaseId,
+            stories: story.options,
+            workflowManagementStory,
+          }
+        : null,
+    remainingEstimationMinutes: remainingEstimationMinutes
+      ? {
+          name: remainingEstimationMinutes.name,
+          fieldId: remainingEstimationMinutes.fieldId,
+        }
+      : null,
+    dependedIssueUrlSeparatedByComma: dependedIssueUrlSeparatedByComma
+      ? {
+          name: dependedIssueUrlSeparatedByComma.name,
+          fieldId: dependedIssueUrlSeparatedByComma.fieldId,
+        }
+      : null,
+    completionDate50PercentConfidence: completionDate50PercentConfidence
+      ? {
+          name: completionDate50PercentConfidence.name,
+          fieldId: completionDate50PercentConfidence.fieldId,
+        }
+      : null,
+  };
+};