v1.2

This is a major release that includes reactivity and an optional module of React bindings.

Manager listeners

There is now a set of new Manager methods that can add listeners for various events. These include:

• The addStatusListener method to listen to the Manager's overall status.
• The addWillTickListener method and addDidTickListener methods to listen to the start and end of each tick.
• The addScheduledTaskRunIdsListener method and addRunningTaskRunIdsListener method to listen to the lists of scheduled and running task run Ids, respectively.
• The addTaskRunRunningListener method to listen to the start and end of each task run.
• The addTaskRunFailedListener method to listen to the failure of task runs.

In all cases, the delListener method should be used to unregister the listener when it is no longer needed.

React bindings

Building on the basic bindings in the previous release, this release adds a set of hooks to benefit from the Manager's reactivity. These include:

• The useStatus hook to get the Manager's status.
• The useScheduledTaskRunIds hook and useRunningTaskRunIds hook to get the lists of scheduled and running task run Ids, respectively.
• The useTaskRunRunning hook to get changes to the the task run's status.
• The useStartCallback hook and useStopCallback to get callbacks that can start and stop the Manager.
• The useSetTask hook to register a task in the Manager.
• The useScheduleTaskRun hook to schedule a task run in the Manager, and the useScheduleTaskRunCallback hook to get a callback that can be used to do so later.

In all cases, these hooks operate on the Manager registered in the Provider component so that one Manager can be used consistently throughout the application, something like this:

import {
  Provider,
  useCreateManager,
  useScheduleTaskRunCallback,
  useSetTask,
} from 'tinytick/ui-react';

const App = () => (
  <Provider manager={useCreateManager(createManager)}>
    <Panel />
  </Provider>
);

const Panel = () => {
  useSetTask('ping', async () => await fetch('https://example.org'));
  return <Button />;
};

const Button = () => {
  const callback = useScheduleTaskRunCallback('ping');
  return <button onClick={callback}>Ping</button>;
};

More information and examples for these React features is in the ui-react module API documentation.

Have fun and let us know how it goes!