Scratch support plus bug fixes

[michaelcfine]

• Added ctx.set() and ctx.get() to ctx passed to pre- and post- triggers for both methods and events
• To do this, needed to export stateManagement.mjs::setScratch and ::getScratch
• These methods take userId, so needed to flow userId all the refactored methods in stateManagement.mjs
• Also needed to pass methodName to these refactored methods because it is used in error messages
• Added two example files, closed-captions-settings-reset.json and closed-captions-settings.yaml.
• Added one new example trigger in triggers/methodTriggers/closedcaptions.enabled/post.mjs

To test,

• Start Mock Firebolt using: npm run dev -- --manage --triggers ./src/triggers
  • Note that this enables the manage sdk (so you can use ClosedCaptions.enabled(false|true)) and loads the above trigger (among others)
• Do: node cli.mjs --upload ../examples/closed-captions-settings-reset.json
  • This sets the scratch k-v 'database' value for 'closedCaptionsSettings' to a default/starter value
• Do: node cli.mjs --upload ../examples/closed-captions-settings.yaml
  • This provides the dynamic mock override 'values' (functions)
• Run the test app

The app code I used to test looks like:

let value, onOff;

console.log('--------------------------closed1');

value = false;
onOff = ( value ? 'on' : 'off' );

console.log(`Calling Manage SDK's ClosedCaptions.enabled(${value}) to turn ${onOff} closed captions...`);
data = await ClosedCaptions.enabled(value);
console.log(`Used Manage SDK's ClosedCaptions.enabled(${value}) to turn ${onOff} closed captions`);

console.log(`Calling SDK's ClosedCaptions.enabled()...`);
data = await ClosedCaptions.enabled();
console.log(`Manage SDK's ClosedCaptions.enabled() returned: ${data}`);

console.log(`Calling Core SDK's Accessibility.closedCaptionsSettings()...`);
data = await Accessibility.closedCaptionsSettings();
console.log(`Core SDK's Accessibility.closedCaptionsSettings() returned: ${JSON.stringify(data)}`);

console.log('--------------------------closed2');

value = true;
onOff = ( value ? 'on' : 'off' );

console.log(`Calling Manage SDK's ClosedCaptions.enabled(${value}) to turn ${onOff} closed captions`);
data = await ClosedCaptions.enabled(value);
console.log(`Used Manage SDK's ClosedCaptions.enabled(${value}) to turn ${onOff} closed captions`);

console.log(`Calling SDK's ClosedCaptions.enabled()...`);
data = await ClosedCaptions.enabled();
console.log(`Manage SDK's ClosedCaptions.enabled() returned: ${data}`);

console.log(`Calling Core SDK's Accessibility.closedCaptionsSettings()...`);
data = await Accessibility.closedCaptionsSettings();
console.log(`Core SDK's Accessibility.closedCaptionsSettings() returned: ${JSON.stringify(data)}`);

console.log('--------------------------closed3');