Shopify Bulk

1'use strict';
2
3// The sequential Shopify bulk runner. One bulk operation runs at a time, for both
4// callers: the discovery census and the extract. A caller supplies its own
5// manifest, staging directory, ordered query list and handlers; this module owns every state, stop
6// and recovery rule, so a caller adds no runner and no recovery path of its own.
7//
8// Query states, one atomic manifest write per change:
9//   pending -> starting -> running -> downloaded -> done
10//                              \-> pending (one re-run, or an expired link)
11//   running | downloaded -> settling -> failed | denied      (terminal; the handler runs in between)
12// `settling` makes every terminal side effect recoverable: a query never becomes `failed` or
13// `denied` directly. The runner writes `settling` with the outcome and the verbatim error, runs the