feat: idempotency key, the INTERRUPTED phase, and a real-hub skew suite
The hub now takes an idempotency key and reports INTERRUPTED for a run its process did not survive, so the client exposes both. The real-hub suite gained the cross-language half of the idempotency guard: a repeated key has to answer with the first run's outputs, which only a real hub can prove. Signed-off-by: flemming-it <sf@flemming.it>
This commit is contained in:
parent
b6c6cc8295
commit
0db793494d
4 changed files with 39 additions and 2 deletions
|
|
@ -1,4 +1,4 @@
|
|||
98a68dd39de4f98d965baf87eca60acc53bb393bd90ae9feb2c07b98071823d9 chain/v1/common.proto
|
||||
b38ade1faa50cd5e645b040001b3d2e32b287b128556694837a1a30083b8416e chain/v1/hub.proto
|
||||
78964aaff179fc43d59776a0f81e57197aff3f1ae61fabdc4b186abfdb4279d6 chain/v1/hub.proto
|
||||
1b2742775d3abe0bcbdcb4a56c14b434e8547f672ea10a7f648ad14c7e14bef7 chain/v1/module.proto
|
||||
47d3af9df026a40f5f5a76311965f719e3ceb49ad944c4393e02158a0bdb1873 chain/v1/federation.proto
|
||||
|
|
|
|||
|
|
@ -439,6 +439,10 @@ message InvocationStatus {
|
|||
SUCCEEDED = 3;
|
||||
FAILED = 4;
|
||||
CANCELLED = 5;
|
||||
// The hub went down while this run was executing (added in hub
|
||||
// 0.25). The run did not finish and did not fail on its own; a
|
||||
// caller that owns the work decides whether to submit it again.
|
||||
INTERRUPTED = 6;
|
||||
}
|
||||
Phase phase = 1;
|
||||
// Step currently executing (RUNNING), empty otherwise.
|
||||
|
|
|
|||
|
|
@ -77,7 +77,19 @@ export interface FlowResult {
|
|||
|
||||
/** Where a detached run stands. */
|
||||
export interface InvocationStatus {
|
||||
phase: 'PENDING' | 'RUNNING' | 'SUCCEEDED' | 'FAILED' | 'CANCELLED' | 'PHASE_UNKNOWN';
|
||||
/**
|
||||
* `INTERRUPTED` means the hub went down while this run was
|
||||
* executing: it neither finished nor failed on its own, and the
|
||||
* caller that owns the work decides whether to submit it again.
|
||||
*/
|
||||
phase:
|
||||
| 'PENDING'
|
||||
| 'RUNNING'
|
||||
| 'SUCCEEDED'
|
||||
| 'FAILED'
|
||||
| 'CANCELLED'
|
||||
| 'INTERRUPTED'
|
||||
| 'PHASE_UNKNOWN';
|
||||
/** Step currently executing, empty unless running. */
|
||||
currentStep: string;
|
||||
startedAt: string;
|
||||
|
|
|
|||
|
|
@ -111,6 +111,27 @@ describe('client against a real hub', { skip: available ? false : `no hub binary
|
|||
assert.equal(err.retryable, false);
|
||||
});
|
||||
|
||||
it('answers a repeated idempotency key with the first run', async () => {
|
||||
// The cross-language half of the idempotency guard: the field has
|
||||
// to survive this client's encoding and the hub's decoding, which
|
||||
// the fake hub cannot prove.
|
||||
const key = `e2e-${Date.now()}`;
|
||||
const first = await client.submit({
|
||||
flowYaml: HELLO,
|
||||
inputs: { name: 'first' },
|
||||
idempotencyKey: key,
|
||||
});
|
||||
const again = await client.submit({
|
||||
flowYaml: HELLO,
|
||||
inputs: { name: 'second' },
|
||||
idempotencyKey: key,
|
||||
});
|
||||
assert.equal(again.invocationId, first.invocationId);
|
||||
// The replay answers with what the first run produced, not with
|
||||
// the second request's input.
|
||||
assert.equal(asText(again.outputs.greeting), 'Hello, first');
|
||||
});
|
||||
|
||||
it('refuses a flow whose module is not installed, as not_found', async () => {
|
||||
const err = (await client
|
||||
.submit({
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue