feat: add month literals

src/lib/inMonth.spec.ts

@@ -8,4 +8,8 @@ describe('inMonth', () => {
   it('should provide in January and December', () => {
     expect(inMonth([1, 12]).toString()).toBe('* * * 1,12 *');
   });
+
+  it('should provide in January and December using literals', () => {
+    expect(inMonth(['January', 'December']).toString()).toBe('* * * 1,12 *');
+  });
 });

src/lib/inMonth.ts

@@ -1,15 +1,46 @@
 import { MonthExpression } from './expression';
 
+const map = {
+  January: 1,
+  February: 2,
+  March: 3,
+  April: 4,
+  May: 5,
+  June: 6,
+  July: 7,
+  August: 8,
+  September: 9,
+  October: 10,
+  November: 11,
+  December: 12,
+};
+
 /**
  * In specific month or multiple specific months
  *
  * ```
  * inMonth(3); // * * * 3 *
+ * inMonth([3,5]); // * * * 3,5 *
+ *
+ * inMonth('January'); // * * * 1 *
+ * inMonth(['January', 'December']); // * * * 1,12 *
  * ```
  *
  */
-export const inMonth = (month: Month | Month[]) => {
+export const inMonth = (
+  month: Month | Month[] | MonthLiteral | MonthLiteral[]
+) => {
+  const arrayInput = Array.isArray(month) ? month : [month];
+
+  if (typeof arrayInput[0] === 'string') {
+    return new MonthExpression({
+      month: (arrayInput as MonthLiteral[])
+        .map((month) => map[month])
+        .join(','),
+    });
+  }
+
   return new MonthExpression({
-    month: `${Array.isArray(month) ? month.join(',') : month}`,
+    month: arrayInput.join(','),
   });
 };

src/lib/types.ts

@@ -90,6 +90,20 @@ type Hour =
 
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 type Month = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+type MonthLiteral =
+  | 'January'
+  | 'February'
+  | 'March'
+  | 'April'
+  | 'May'
+  | 'June'
+  | 'July'
+  | 'August'
+  | 'September'
+  | 'October'
+  | 'November'
+  | 'December';
 
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 type DayOfTheMonth =