feat: add schedule integration

packages/backend/src/apps/schedule/assets/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" role="img" viewBox="0 0 24 24"><path fill="#1976d2" d="M11.99 2C6.47 2 2 6.48 2 12s4.47 10 9.99 10C17.52 22 22 17.52 22 12S17.52 2 11.99 2zM12 20c-4.42 0-8-3.58-8-8s3.58-8 8-8 8 3.58 8 8-3.58 8-8 8z"></path><path fill="#1976d2" d="M12.5 7H11v6l5.25 3.15.75-1.23-4.5-2.67z"></path></svg>

packages/backend/src/apps/schedule/index.ts

@@ -0,0 +1,18 @@
+import Triggers from './triggers';
+import {
+  IService,
+  IApp,
+  IJSONObject,
+} from '@automatisch/types';
+
+export default class Schedule implements IService {
+  triggers: Triggers;
+
+  constructor(
+    appData: IApp,
+    connectionData: IJSONObject,
+    parameters: IJSONObject
+  ) {
+    this.triggers = new Triggers(connectionData, parameters);
+  }
+}

packages/backend/src/apps/schedule/info.json

@@ -0,0 +1,46 @@
+{
+  "name": "Schedule",
+  "key": "schedule",
+  "iconUrl": "{BASE_URL}/apps/schedule/assets/favicon.svg",
+  "docUrl": "https://automatisch.io/docs/schedule",
+  "primaryColor": "0059F7",
+  "requiresAuthentication": false,
+  "triggers": [
+    {
+      "name": "Every hour",
+      "key": "everyHour",
+      "description": "Triggers every hour.",
+      "substeps": [
+        {
+          "key": "chooseTrigger",
+          "name": "Set up a trigger",
+          "arguments": [
+            {
+              "label": "Trigger on weekends?",
+              "key": "triggersOnWeekend",
+              "type": "dropdown",
+              "description": "Should this flow trigger on Saturday and Sunday?",
+              "required": true,
+              "value": true,
+              "variables": false,
+              "options": [
+                {
+                  "label": "Yes",
+                  "value": true
+                },
+                {
+                  "label": "No",
+                  "value": false
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "key": "testStep",
+          "name": "Test trigger"
+        }
+      ]
+    }
+  ]
+}

packages/backend/src/apps/schedule/triggers.ts

@@ -0,0 +1,10 @@
+import { IJSONObject } from '@automatisch/types';
+import EveryHour from './triggers/every-hour';
+
+export default class Triggers {
+  everyHour: EveryHour;
+
+  constructor(connectionData: IJSONObject, parameters: IJSONObject) {
+    this.everyHour = new EveryHour(parameters);
+  }
+}

packages/backend/src/apps/schedule/triggers/every-hour.ts

@@ -0,0 +1,35 @@
+import { DateTime } from 'luxon';
+import type { IJSONObject, IJSONValue, ITrigger } from '@automatisch/types';
+import { cronTimes, getNextCronDateTime, getDateTimeObjectRepresentation } from '../utils';
+
+export default class EveryHour implements ITrigger {
+  triggersOnWeekend?: boolean | string;
+
+  constructor(parameters: IJSONObject) {
+    if (parameters.triggersOnWeekend) {
+      this.triggersOnWeekend = parameters.triggersOnWeekend as string;
+    }
+  }
+
+  get interval() {
+    if (this.triggersOnWeekend) {
+      return cronTimes.everyHour;
+    }
+
+    return cronTimes.everyHourExcludingWeekends;
+  }
+
+  async run(startDateTime: Date) {
+    const dateTime = DateTime.fromJSDate(startDateTime);
+    const dateTimeObjectRepresentation = getDateTimeObjectRepresentation(dateTime) as IJSONValue;
+
+    return [dateTimeObjectRepresentation] as IJSONValue;
+  }
+
+  async testRun() {
+    const nextCronDateTime = getNextCronDateTime(this.interval);
+    const dateTimeObjectRepresentation = getDateTimeObjectRepresentation(nextCronDateTime) as IJSONValue;
+
+    return [dateTimeObjectRepresentation] as IJSONValue;
+  }
+}

packages/backend/src/apps/schedule/utils.ts

@@ -0,0 +1,28 @@
+import { DateTime } from 'luxon';
+import cronParser from 'cron-parser';
+
+export const cronTimes = {
+  everyHour: '0 * * * *',
+  everyHourExcludingWeekends: '0 * * * 1-5',
+};
+
+export function getNextCronDateTime(cronString: string) {
+  const cronDate = cronParser.parseExpression(cronString);
+  const matchingNextCronDateTime = cronDate.next();
+  const matchingNextDateTime = DateTime.fromJSDate(matchingNextCronDateTime.toDate());
+
+  return matchingNextDateTime;
+};
+
+export function getDateTimeObjectRepresentation(dateTime: DateTime) {
+  const defaults = dateTime.toObject();
+
+  return {
+    ...defaults,
+    ISO_date_time: dateTime.toISO(),
+    pretty_date: dateTime.toLocaleString(DateTime.DATE_MED),
+    pretty_time: dateTime.toLocaleString(DateTime.TIME_WITH_SECONDS),
+    pretty_day_of_week: dateTime.toFormat('cccc'),
+    day_of_week: dateTime.weekday,
+  };
+}