Support Long Timers ⏳📈🚀🚀🚀

[hossam-nasr]

Resolves #325. This PR leverages these changes in the extension: Azure/azure-functions-durable-extension#2134 to allow JS orchestrators to have timers longer than 6 days. Internally, when user code calls CreateTimer, if it is more than 6 days, a LongTimerTask, which is essentially a WhenAll task of several small sub-timers, is created instead of an atomic DFTimerTask.

Now, the JS SDK will become the first OOProc SDK to support long timers 🥳 This also unblocks #284

[davidmrdavid]

Good job, I think this is close to merge. Left some comments. My main blocker at this point is that I would prefer not having the timer metadata be exposed in the orchestration context class :-)

[davidmrdavid]

We're almost there!

[davidmrdavid]

This looks pretty much ready to me, implementation-wise.

Just 2 more things:

1. I realized last night this was missing a test-case. Can you please add the appropiate long timer test cases using the following segment of timer tests as an example?

   azure-functions-durable-js/test/integration/orchestrator-spec.ts

   Line 1536 in 3182ada

   describe("createTimer()", () => {

For the above, you'll probably have to modify the TestHistories class to include a new history for long timers. That will be a little manual, but essentially you need to mock the expected History for a simple long timer scenario. My tip here is not to overcomplicate it, just mock the history for an orchestrator that schedules 1 long timer with, say, 2 sub-timers, and that's it.

As for how many long timer test cases you need, I'd say 2: one that tests that the orchestrator waits for the sub-timers, and another that tests that the orchestrator proceeds when all sub-timers finish.

2. Can you do a manual check testing that long timers can be cancelled successfully? Now that timers can be arbitrarily long, it is important to make sure they can be cancelled at-will. The easiest way to test for cancellable timers it to utilize the human in the loop sample and have the activity in it always finish immediately. See the linked sample for more clarity. Just want to make sure this edge-case is at least manually tested as well. Thanks!

[hossam-nasr]

Added unit tests and also manually tested and verified that long timers get canceled :)

[davidmrdavid]

The time has come ...
to merge this PR 🧙‍♂️

✨ it looks good to me ✨