@deliverd/sdk 0.4.0 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +28 -0
- package/dist/dev.d.ts.map +1 -1
- package/dist/dev.js +48 -0
- package/dist/flows.d.ts +9 -1
- package/dist/flows.d.ts.map +1 -1
- package/dist/flows.js +14 -0
- package/dist/http.d.ts +7 -0
- package/dist/http.d.ts.map +1 -1
- package/dist/http.js +11 -0
- package/dist/reports.d.ts +10 -1
- package/dist/reports.d.ts.map +1 -1
- package/dist/reports.js +15 -0
- package/dist/types.d.ts +82 -0
- package/dist/types.d.ts.map +1 -1
- package/package.json +1 -1
- package/src/dev.ts +56 -1
- package/src/flows.ts +16 -1
- package/src/http.ts +19 -0
- package/src/reports.ts +17 -0
- package/src/types.ts +86 -0
package/README.md
CHANGED
|
@@ -205,6 +205,32 @@ await deliverd.flows.get(id);
|
|
|
205
205
|
`allSettled` is a fact about this moment, not a verdict. You may be about to
|
|
206
206
|
add the next step, so nothing closes a flow but you.
|
|
207
207
|
|
|
208
|
+
## Evidence
|
|
209
|
+
|
|
210
|
+
Show your working. One call assembles the whole record of a piece of work —
|
|
211
|
+
every approval, review and request with who was asked, what they were told and
|
|
212
|
+
what they said, plus the timeline across all of it.
|
|
213
|
+
|
|
214
|
+
```ts
|
|
215
|
+
const pack = await flow.evidence();
|
|
216
|
+
// or, for the deliverable itself:
|
|
217
|
+
const pack = await deliverd.reports.evidence(report.id);
|
|
218
|
+
|
|
219
|
+
pack.steps; // each one with asked[], outcomes[] and its own detail
|
|
220
|
+
pack.timeline; // what happened, in order
|
|
221
|
+
pack.integrity; // what the digest stands for, in the pack's own words
|
|
222
|
+
```
|
|
223
|
+
|
|
224
|
+
A person downloads it as a PDF from the flow or report page; this is the same
|
|
225
|
+
pack as JSON. It needs every read scope, because it contains everything.
|
|
226
|
+
|
|
227
|
+
**Read `integrity` before you quote it.** The digest is over the pack as
|
|
228
|
+
exported, so it detects a file altered after it left. It makes no claim about
|
|
229
|
+
the database — what stands behind the records is that the audit table rejects
|
|
230
|
+
updates and deletes at the database level. That is tamper-evident history, not
|
|
231
|
+
cryptographic immutability, and the pack says so in both directions rather than
|
|
232
|
+
leaving a hash to imply the stronger one.
|
|
233
|
+
|
|
208
234
|
## Collecting
|
|
209
235
|
|
|
210
236
|
`approve()` asks permission, `review()` asks judgement, and this asks for a
|
|
@@ -414,6 +440,8 @@ Zero dependencies. Node 20 or later.
|
|
|
414
440
|
|
|
415
441
|
## Also
|
|
416
442
|
|
|
443
|
+
- The same walkthrough as a page, if you would rather read it there:
|
|
444
|
+
<https://deliverd.dev/quickstart>
|
|
417
445
|
- The API reference: <https://deliverd.dev/docs/api>
|
|
418
446
|
- MCP, if your agent speaks it rather than TypeScript:
|
|
419
447
|
<https://deliverd.dev/connect>
|
package/dist/dev.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../src/dev.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,
|
|
1
|
+
{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../src/dev.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAKb,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AAElF,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,kBAAkB,GAAG,CAAC,CAAC,OAAO,EAAE,YAAY,KAAK,kBAAkB,CAAC,CAAC;IAC/E,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAcD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,UAAU,CAAC,KAAK,CAyW1F"}
|
package/dist/dev.js
CHANGED
|
@@ -38,6 +38,14 @@ export function developmentFetch(options = {}) {
|
|
|
38
38
|
metadata: body.metadata ?? {},
|
|
39
39
|
requestedBy: "You (development mode)",
|
|
40
40
|
approvers: body.approvers ?? [],
|
|
41
|
+
/*
|
|
42
|
+
* One, always. A standing rule could raise it on a real organisation,
|
|
43
|
+
* but development mode has no rules to read and an imaginary approver
|
|
44
|
+
* cannot be two people — pretending otherwise would let a caller test
|
|
45
|
+
* an escalation that never happened.
|
|
46
|
+
*/
|
|
47
|
+
requiredApprovals: 1,
|
|
48
|
+
approvalsSoFar: 0,
|
|
41
49
|
decidedBy: null,
|
|
42
50
|
decidedAt: null,
|
|
43
51
|
note: null,
|
|
@@ -262,6 +270,46 @@ export function developmentFetch(options = {}) {
|
|
|
262
270
|
}
|
|
263
271
|
return json(data, 201);
|
|
264
272
|
}
|
|
273
|
+
/*
|
|
274
|
+
* Evidence in development is the shape and not the substance: this store
|
|
275
|
+
* holds no audit rows, so the pack comes back with the subject and an
|
|
276
|
+
* empty record rather than an invented one. What it proves is that
|
|
277
|
+
* `flow.evidence()` reaches the right path and returns something a caller
|
|
278
|
+
* can destructure — an imaginary approval trail would be worse than none.
|
|
279
|
+
*/
|
|
280
|
+
const evidenceMatch = /^\/(flows|reports)\/([^/]+)\/evidence$/.exec(path);
|
|
281
|
+
if (evidenceMatch && method === "GET") {
|
|
282
|
+
const kind = evidenceMatch[1] === "flows" ? "flow" : "report";
|
|
283
|
+
const id = evidenceMatch[2];
|
|
284
|
+
const title = kind === "flow" ? (flowStore.get(id)?.title ?? "A flow") : "A report";
|
|
285
|
+
const now = new Date().toISOString();
|
|
286
|
+
const pack = {
|
|
287
|
+
packVersion: 1,
|
|
288
|
+
generatedAt: now,
|
|
289
|
+
generatedBy: "You (development mode)",
|
|
290
|
+
organisation: { id: "org_dev", name: "Development" },
|
|
291
|
+
subject: {
|
|
292
|
+
kind,
|
|
293
|
+
id,
|
|
294
|
+
title,
|
|
295
|
+
url: `https://deliverd.dev/${evidenceMatch[1]}/${id}`,
|
|
296
|
+
status: "open",
|
|
297
|
+
startedBy: "You (development mode)",
|
|
298
|
+
startedAt: now,
|
|
299
|
+
},
|
|
300
|
+
summary: { steps: 0, events: 0, firstEventAt: null, lastEventAt: null },
|
|
301
|
+
steps: [],
|
|
302
|
+
timeline: [],
|
|
303
|
+
integrity: {
|
|
304
|
+
algorithm: "sha256",
|
|
305
|
+
digest: "development",
|
|
306
|
+
covers: "Nothing: this pack was produced in development mode and holds no records.",
|
|
307
|
+
doesNotCover: "Everything. Do not hand this to anybody.",
|
|
308
|
+
recordsAreInsertOnly: true,
|
|
309
|
+
},
|
|
310
|
+
};
|
|
311
|
+
return json(pack);
|
|
312
|
+
}
|
|
265
313
|
const flowMatch = /^\/flows\/([^/]+)(\/complete|\/cancel)?$/.exec(path);
|
|
266
314
|
if (flowMatch) {
|
|
267
315
|
const flow = flowStore.get(flowMatch[1]);
|
package/dist/flows.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { HttpClient } from "./http.js";
|
|
2
|
-
import type { CreateFlowInput, FlowData, ListFlowsInput } from "./types.js";
|
|
2
|
+
import type { CreateFlowInput, EvidencePack, FlowData, ListFlowsInput } from "./types.js";
|
|
3
3
|
import type { ApproveOptions, CollectOptions, Decision, ReviewOptions, ReviewOutcome } from "./index.js";
|
|
4
4
|
import type { CollectedAnswers } from "./types.js";
|
|
5
5
|
/**
|
|
@@ -59,6 +59,14 @@ export declare class Flow {
|
|
|
59
59
|
review(options: Omit<ReviewOptions, "flowId">): Promise<ReviewOutcome>;
|
|
60
60
|
/** Ask for facts, inside this flow. */
|
|
61
61
|
collect(options: Omit<CollectOptions, "flowId">): Promise<CollectedAnswers>;
|
|
62
|
+
/**
|
|
63
|
+
* The whole record of this flow: every step with who was asked and what they
|
|
64
|
+
* said, and the timeline across all of it.
|
|
65
|
+
*
|
|
66
|
+
* What to hand over when somebody asks you to show your working. Needs every
|
|
67
|
+
* read scope, because it contains everything.
|
|
68
|
+
*/
|
|
69
|
+
evidence(signal?: AbortSignal): Promise<EvidencePack>;
|
|
62
70
|
/**
|
|
63
71
|
* Say the work is done. It stops taking new members from here.
|
|
64
72
|
*
|
package/dist/flows.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"flows.d.ts","sourceRoot":"","sources":["../src/flows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;
|
|
1
|
+
{"version":3,"file":"flows.d.ts","sourceRoot":"","sources":["../src/flows.ts"],"names":[],"mappings":"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"}
|
package/dist/flows.js
CHANGED
|
@@ -52,6 +52,20 @@ export class Flow {
|
|
|
52
52
|
collect(options) {
|
|
53
53
|
return this.client.collect({ ...options, flowId: this.data.id });
|
|
54
54
|
}
|
|
55
|
+
/**
|
|
56
|
+
* The whole record of this flow: every step with who was asked and what they
|
|
57
|
+
* said, and the timeline across all of it.
|
|
58
|
+
*
|
|
59
|
+
* What to hand over when somebody asks you to show your working. Needs every
|
|
60
|
+
* read scope, because it contains everything.
|
|
61
|
+
*/
|
|
62
|
+
evidence(signal) {
|
|
63
|
+
return this.http.request({
|
|
64
|
+
method: "GET",
|
|
65
|
+
path: `/flows/${this.data.id}/evidence`,
|
|
66
|
+
signal,
|
|
67
|
+
});
|
|
68
|
+
}
|
|
55
69
|
/**
|
|
56
70
|
* Say the work is done. It stops taking new members from here.
|
|
57
71
|
*
|
package/dist/http.d.ts
CHANGED
|
@@ -30,6 +30,13 @@ interface RequestOptions {
|
|
|
30
30
|
body?: unknown;
|
|
31
31
|
query?: Record<string, string | number | undefined>;
|
|
32
32
|
signal?: AbortSignal;
|
|
33
|
+
/**
|
|
34
|
+
* Overrides the key generated for this call. Pass one when the *caller's*
|
|
35
|
+
* own retry should be recognised too — a job that reruns from the start
|
|
36
|
+
* after a crash wants the key its first run used, which only the caller
|
|
37
|
+
* knows how to derive.
|
|
38
|
+
*/
|
|
39
|
+
idempotencyKey?: string;
|
|
33
40
|
}
|
|
34
41
|
export declare class HttpClient {
|
|
35
42
|
readonly baseUrl: string;
|
package/dist/http.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AAEvD,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;IACpD,MAAM,CAAC,EAAE,WAAW,CAAC;
|
|
1
|
+
{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AAEvD,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;IACpD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA4BD,qBAAa,UAAU;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;gBAEtC,OAAO,EAAE,aAAa;IAW5B,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;CAkFtD;AAED,eAAO,MAAM,UAAU,iBAAiB,CAAC"}
|
package/dist/http.js
CHANGED
|
@@ -47,6 +47,16 @@ export class HttpClient {
|
|
|
47
47
|
url.searchParams.set(key, String(value));
|
|
48
48
|
}
|
|
49
49
|
const correlationId = randomUUID();
|
|
50
|
+
/*
|
|
51
|
+
* One key per logical request, held across every attempt below — which is
|
|
52
|
+
* the whole point. These retries are why the server needs replay
|
|
53
|
+
* protection at all: a POST that arrived and lost its response on the way
|
|
54
|
+
* back used to be retried as a second create, and for an approval that
|
|
55
|
+
* means two people asked to authorise one act.
|
|
56
|
+
*
|
|
57
|
+
* Only on POST: nothing else here creates anything.
|
|
58
|
+
*/
|
|
59
|
+
const idempotencyKey = options.method === "POST" ? (options.idempotencyKey ?? randomUUID()) : undefined;
|
|
50
60
|
let lastError;
|
|
51
61
|
for (let attempt = 1; attempt <= this.maxRetries; attempt++) {
|
|
52
62
|
if (attempt > 1)
|
|
@@ -66,6 +76,7 @@ export class HttpClient {
|
|
|
66
76
|
// thing to quote when something went wrong, and generating it
|
|
67
77
|
// here means nobody has to remember to.
|
|
68
78
|
"deliverd-correlation-id": correlationId,
|
|
79
|
+
...(idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {}),
|
|
69
80
|
...(options.body !== undefined ? { "Content-Type": "application/json" } : {}),
|
|
70
81
|
},
|
|
71
82
|
body: options.body !== undefined ? JSON.stringify(options.body) : undefined,
|
package/dist/reports.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { HttpClient } from "./http.js";
|
|
2
|
-
import type { CommentThread, PublishReportInput, PublishResult, ReportData, UpdateReportInput } from "./types.js";
|
|
2
|
+
import type { CommentThread, PublishReportInput, PublishResult, ReportData, UpdateReportInput, EvidencePack } from "./types.js";
|
|
3
3
|
/**
|
|
4
4
|
* The publishing half: get what the agent wrote to the people who need it, at
|
|
5
5
|
* an address that does not change.
|
|
@@ -22,6 +22,15 @@ export declare class Reports {
|
|
|
22
22
|
publish(input: PublishReportInput, signal?: AbortSignal): Promise<PublishResult>;
|
|
23
23
|
/** A new version of an existing report, keeping its URL and its audience. */
|
|
24
24
|
update(idOrSlug: string, input: UpdateReportInput, signal?: AbortSignal): Promise<PublishResult>;
|
|
25
|
+
/**
|
|
26
|
+
* The whole record behind a report: the approvals, reviews and requests for
|
|
27
|
+
* information that point at it, its version history, and the timeline across
|
|
28
|
+
* all of it.
|
|
29
|
+
*
|
|
30
|
+
* The subject an auditor usually names — and unlike a flow, it works for
|
|
31
|
+
* work that was done before flows existed. Needs every read scope.
|
|
32
|
+
*/
|
|
33
|
+
evidence(idOrSlug: string, signal?: AbortSignal): Promise<EvidencePack>;
|
|
25
34
|
get(idOrSlug: string, signal?: AbortSignal): Promise<ReportData>;
|
|
26
35
|
list(query?: string, signal?: AbortSignal): Promise<ReportData[]>;
|
|
27
36
|
/** Change the title, the address, or both. The old address keeps working. */
|
package/dist/reports.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../src/reports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,iBAAiB,
|
|
1
|
+
{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../src/reports.ts"],"names":[],"mappings":"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"}
|
package/dist/reports.js
CHANGED
|
@@ -31,6 +31,21 @@ export class Reports {
|
|
|
31
31
|
signal,
|
|
32
32
|
});
|
|
33
33
|
}
|
|
34
|
+
/**
|
|
35
|
+
* The whole record behind a report: the approvals, reviews and requests for
|
|
36
|
+
* information that point at it, its version history, and the timeline across
|
|
37
|
+
* all of it.
|
|
38
|
+
*
|
|
39
|
+
* The subject an auditor usually names — and unlike a flow, it works for
|
|
40
|
+
* work that was done before flows existed. Needs every read scope.
|
|
41
|
+
*/
|
|
42
|
+
evidence(idOrSlug, signal) {
|
|
43
|
+
return this.http.request({
|
|
44
|
+
method: "GET",
|
|
45
|
+
path: `/reports/${encodeURIComponent(idOrSlug)}/evidence`,
|
|
46
|
+
signal,
|
|
47
|
+
});
|
|
48
|
+
}
|
|
34
49
|
get(idOrSlug, signal) {
|
|
35
50
|
return this.http.request({
|
|
36
51
|
method: "GET",
|
package/dist/types.d.ts
CHANGED
|
@@ -42,6 +42,14 @@ export interface ApprovalData {
|
|
|
42
42
|
metadata: Record<string, unknown>;
|
|
43
43
|
requestedBy: string;
|
|
44
44
|
approvers: string[];
|
|
45
|
+
/**
|
|
46
|
+
* How many people must agree before it settles. One unless a standing rule
|
|
47
|
+
* in the organisation escalated it — an agent cannot set this, and a rule
|
|
48
|
+
* can only push it up.
|
|
49
|
+
*/
|
|
50
|
+
requiredApprovals: number;
|
|
51
|
+
/** How many have approved so far. Compare with `requiredApprovals`. */
|
|
52
|
+
approvalsSoFar: number;
|
|
45
53
|
decidedBy: string | null;
|
|
46
54
|
decidedAt: string | null;
|
|
47
55
|
/** The approver's reason, on a rejection or an approval that carried one. */
|
|
@@ -431,4 +439,78 @@ export interface ListFlowsInput {
|
|
|
431
439
|
externalId?: string;
|
|
432
440
|
limit?: number;
|
|
433
441
|
}
|
|
442
|
+
export type EvidenceStepKind = "approval" | "review" | "collection" | "report";
|
|
443
|
+
export interface EvidenceOutcome {
|
|
444
|
+
who: string;
|
|
445
|
+
/** What they said, in the words the step uses: "approved", "answered". */
|
|
446
|
+
said: string;
|
|
447
|
+
note: string | null;
|
|
448
|
+
at: string;
|
|
449
|
+
}
|
|
450
|
+
export interface EvidenceStep {
|
|
451
|
+
kind: EvidenceStepKind;
|
|
452
|
+
id: string;
|
|
453
|
+
title: string;
|
|
454
|
+
status: string;
|
|
455
|
+
url: string;
|
|
456
|
+
createdAt: string;
|
|
457
|
+
settledAt: string | null;
|
|
458
|
+
requestedBy: string;
|
|
459
|
+
/** Whether an agent asked for this, which is the point of the record. */
|
|
460
|
+
requestedByAgent: boolean;
|
|
461
|
+
asked: string[];
|
|
462
|
+
outcomes: EvidenceOutcome[];
|
|
463
|
+
/** Whatever else the step records: the description, the questions, the answers. */
|
|
464
|
+
detail: Record<string, unknown>;
|
|
465
|
+
}
|
|
466
|
+
export interface EvidenceEvent {
|
|
467
|
+
at: string;
|
|
468
|
+
event: string;
|
|
469
|
+
actor: string;
|
|
470
|
+
actorType: string;
|
|
471
|
+
/** Which step it happened to, when it happened to one. */
|
|
472
|
+
step: string | null;
|
|
473
|
+
metadata: Record<string, unknown>;
|
|
474
|
+
}
|
|
475
|
+
export interface EvidencePack {
|
|
476
|
+
packVersion: number;
|
|
477
|
+
generatedAt: string;
|
|
478
|
+
generatedBy: string;
|
|
479
|
+
organisation: {
|
|
480
|
+
id: string;
|
|
481
|
+
name: string;
|
|
482
|
+
};
|
|
483
|
+
subject: {
|
|
484
|
+
kind: "flow" | "report";
|
|
485
|
+
id: string;
|
|
486
|
+
title: string;
|
|
487
|
+
url: string;
|
|
488
|
+
status: string;
|
|
489
|
+
startedBy: string;
|
|
490
|
+
startedAt: string;
|
|
491
|
+
};
|
|
492
|
+
summary: {
|
|
493
|
+
steps: number;
|
|
494
|
+
events: number;
|
|
495
|
+
firstEventAt: string | null;
|
|
496
|
+
lastEventAt: string | null;
|
|
497
|
+
};
|
|
498
|
+
steps: EvidenceStep[];
|
|
499
|
+
timeline: EvidenceEvent[];
|
|
500
|
+
/**
|
|
501
|
+
* What the digest does and does not stand for, in the pack's own words.
|
|
502
|
+
*
|
|
503
|
+
* `covers` says it detects a file altered after export. `doesNotCover` says
|
|
504
|
+
* it makes no claim about the database. Both travel with the pack rather
|
|
505
|
+
* than living only in documentation, because a reader who sees a hash and
|
|
506
|
+
* no sentence will assume the stronger one.
|
|
507
|
+
*/
|
|
508
|
+
integrity: {
|
|
509
|
+
algorithm: "sha256";
|
|
510
|
+
digest: string;
|
|
511
|
+
covers: string;
|
|
512
|
+
doesNotCover: string;
|
|
513
|
+
recordsAreInsertOnly: boolean;
|
|
514
|
+
};
|
|
515
|
+
}
|
|
434
516
|
//# sourceMappingURL=types.d.ts.map
|
package/dist/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
package/src/dev.ts
CHANGED
|
@@ -1,4 +1,10 @@
|
|
|
1
|
-
import type {
|
|
1
|
+
import type {
|
|
2
|
+
ApprovalData,
|
|
3
|
+
CollectionData,
|
|
4
|
+
EvidencePack,
|
|
5
|
+
FlowData,
|
|
6
|
+
ReviewData,
|
|
7
|
+
} from "./types.js";
|
|
2
8
|
|
|
3
9
|
/**
|
|
4
10
|
* Development mode: the whole loop, on your machine, with nobody in it.
|
|
@@ -93,6 +99,14 @@ export function developmentFetch(options: DevelopmentOptions = {}): typeof globa
|
|
|
93
99
|
metadata: (body.metadata as Record<string, unknown>) ?? {},
|
|
94
100
|
requestedBy: "You (development mode)",
|
|
95
101
|
approvers: (body.approvers as string[] | undefined) ?? [],
|
|
102
|
+
/*
|
|
103
|
+
* One, always. A standing rule could raise it on a real organisation,
|
|
104
|
+
* but development mode has no rules to read and an imaginary approver
|
|
105
|
+
* cannot be two people — pretending otherwise would let a caller test
|
|
106
|
+
* an escalation that never happened.
|
|
107
|
+
*/
|
|
108
|
+
requiredApprovals: 1,
|
|
109
|
+
approvalsSoFar: 0,
|
|
96
110
|
decidedBy: null,
|
|
97
111
|
decidedAt: null,
|
|
98
112
|
note: null,
|
|
@@ -332,6 +346,47 @@ export function developmentFetch(options: DevelopmentOptions = {}): typeof globa
|
|
|
332
346
|
return json(data, 201);
|
|
333
347
|
}
|
|
334
348
|
|
|
349
|
+
/*
|
|
350
|
+
* Evidence in development is the shape and not the substance: this store
|
|
351
|
+
* holds no audit rows, so the pack comes back with the subject and an
|
|
352
|
+
* empty record rather than an invented one. What it proves is that
|
|
353
|
+
* `flow.evidence()` reaches the right path and returns something a caller
|
|
354
|
+
* can destructure — an imaginary approval trail would be worse than none.
|
|
355
|
+
*/
|
|
356
|
+
const evidenceMatch = /^\/(flows|reports)\/([^/]+)\/evidence$/.exec(path);
|
|
357
|
+
if (evidenceMatch && method === "GET") {
|
|
358
|
+
const kind = evidenceMatch[1] === "flows" ? "flow" : "report";
|
|
359
|
+
const id = evidenceMatch[2]!;
|
|
360
|
+
const title = kind === "flow" ? (flowStore.get(id)?.title ?? "A flow") : "A report";
|
|
361
|
+
const now = new Date().toISOString();
|
|
362
|
+
const pack: EvidencePack = {
|
|
363
|
+
packVersion: 1,
|
|
364
|
+
generatedAt: now,
|
|
365
|
+
generatedBy: "You (development mode)",
|
|
366
|
+
organisation: { id: "org_dev", name: "Development" },
|
|
367
|
+
subject: {
|
|
368
|
+
kind,
|
|
369
|
+
id,
|
|
370
|
+
title,
|
|
371
|
+
url: `https://deliverd.dev/${evidenceMatch[1]}/${id}`,
|
|
372
|
+
status: "open",
|
|
373
|
+
startedBy: "You (development mode)",
|
|
374
|
+
startedAt: now,
|
|
375
|
+
},
|
|
376
|
+
summary: { steps: 0, events: 0, firstEventAt: null, lastEventAt: null },
|
|
377
|
+
steps: [],
|
|
378
|
+
timeline: [],
|
|
379
|
+
integrity: {
|
|
380
|
+
algorithm: "sha256",
|
|
381
|
+
digest: "development",
|
|
382
|
+
covers: "Nothing: this pack was produced in development mode and holds no records.",
|
|
383
|
+
doesNotCover: "Everything. Do not hand this to anybody.",
|
|
384
|
+
recordsAreInsertOnly: true,
|
|
385
|
+
},
|
|
386
|
+
};
|
|
387
|
+
return json(pack);
|
|
388
|
+
}
|
|
389
|
+
|
|
335
390
|
const flowMatch = /^\/flows\/([^/]+)(\/complete|\/cancel)?$/.exec(path);
|
|
336
391
|
if (flowMatch) {
|
|
337
392
|
const flow = flowStore.get(flowMatch[1]!);
|
package/src/flows.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { HttpClient } from "./http.js";
|
|
2
|
-
import type { CreateFlowInput, FlowData, ListFlowsInput } from "./types.js";
|
|
2
|
+
import type { CreateFlowInput, EvidencePack, FlowData, ListFlowsInput } from "./types.js";
|
|
3
3
|
/*
|
|
4
4
|
* Type-only, and therefore erased: `index.ts` imports this file at runtime,
|
|
5
5
|
* and a value import back would be a cycle. What the handle needs from the
|
|
@@ -97,6 +97,21 @@ export class Flow {
|
|
|
97
97
|
return this.client.collect({ ...options, flowId: this.data.id });
|
|
98
98
|
}
|
|
99
99
|
|
|
100
|
+
/**
|
|
101
|
+
* The whole record of this flow: every step with who was asked and what they
|
|
102
|
+
* said, and the timeline across all of it.
|
|
103
|
+
*
|
|
104
|
+
* What to hand over when somebody asks you to show your working. Needs every
|
|
105
|
+
* read scope, because it contains everything.
|
|
106
|
+
*/
|
|
107
|
+
evidence(signal?: AbortSignal): Promise<EvidencePack> {
|
|
108
|
+
return this.http.request<EvidencePack>({
|
|
109
|
+
method: "GET",
|
|
110
|
+
path: `/flows/${this.data.id}/evidence`,
|
|
111
|
+
signal,
|
|
112
|
+
});
|
|
113
|
+
}
|
|
114
|
+
|
|
100
115
|
/**
|
|
101
116
|
* Say the work is done. It stops taking new members from here.
|
|
102
117
|
*
|
package/src/http.ts
CHANGED
|
@@ -36,6 +36,13 @@ interface RequestOptions {
|
|
|
36
36
|
body?: unknown;
|
|
37
37
|
query?: Record<string, string | number | undefined>;
|
|
38
38
|
signal?: AbortSignal;
|
|
39
|
+
/**
|
|
40
|
+
* Overrides the key generated for this call. Pass one when the *caller's*
|
|
41
|
+
* own retry should be recognised too — a job that reruns from the start
|
|
42
|
+
* after a crash wants the key its first run used, which only the caller
|
|
43
|
+
* knows how to derive.
|
|
44
|
+
*/
|
|
45
|
+
idempotencyKey?: string;
|
|
39
46
|
}
|
|
40
47
|
|
|
41
48
|
const sleep = (ms: number, signal?: AbortSignal) =>
|
|
@@ -89,6 +96,17 @@ export class HttpClient {
|
|
|
89
96
|
}
|
|
90
97
|
|
|
91
98
|
const correlationId = randomUUID();
|
|
99
|
+
/*
|
|
100
|
+
* One key per logical request, held across every attempt below — which is
|
|
101
|
+
* the whole point. These retries are why the server needs replay
|
|
102
|
+
* protection at all: a POST that arrived and lost its response on the way
|
|
103
|
+
* back used to be retried as a second create, and for an approval that
|
|
104
|
+
* means two people asked to authorise one act.
|
|
105
|
+
*
|
|
106
|
+
* Only on POST: nothing else here creates anything.
|
|
107
|
+
*/
|
|
108
|
+
const idempotencyKey =
|
|
109
|
+
options.method === "POST" ? (options.idempotencyKey ?? randomUUID()) : undefined;
|
|
92
110
|
let lastError: DeliverdError | undefined;
|
|
93
111
|
for (let attempt = 1; attempt <= this.maxRetries; attempt++) {
|
|
94
112
|
if (attempt > 1) await sleep(lastError ? retryDelay(lastError, attempt) : backoffMs(attempt), options.signal);
|
|
@@ -109,6 +127,7 @@ export class HttpClient {
|
|
|
109
127
|
// thing to quote when something went wrong, and generating it
|
|
110
128
|
// here means nobody has to remember to.
|
|
111
129
|
"deliverd-correlation-id": correlationId,
|
|
130
|
+
...(idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {}),
|
|
112
131
|
...(options.body !== undefined ? { "Content-Type": "application/json" } : {}),
|
|
113
132
|
},
|
|
114
133
|
body: options.body !== undefined ? JSON.stringify(options.body) : undefined,
|
package/src/reports.ts
CHANGED
|
@@ -5,6 +5,7 @@ import type {
|
|
|
5
5
|
PublishResult,
|
|
6
6
|
ReportData,
|
|
7
7
|
UpdateReportInput,
|
|
8
|
+
EvidencePack,
|
|
8
9
|
} from "./types.js";
|
|
9
10
|
|
|
10
11
|
/**
|
|
@@ -44,6 +45,22 @@ export class Reports {
|
|
|
44
45
|
});
|
|
45
46
|
}
|
|
46
47
|
|
|
48
|
+
/**
|
|
49
|
+
* The whole record behind a report: the approvals, reviews and requests for
|
|
50
|
+
* information that point at it, its version history, and the timeline across
|
|
51
|
+
* all of it.
|
|
52
|
+
*
|
|
53
|
+
* The subject an auditor usually names — and unlike a flow, it works for
|
|
54
|
+
* work that was done before flows existed. Needs every read scope.
|
|
55
|
+
*/
|
|
56
|
+
evidence(idOrSlug: string, signal?: AbortSignal): Promise<EvidencePack> {
|
|
57
|
+
return this.http.request<EvidencePack>({
|
|
58
|
+
method: "GET",
|
|
59
|
+
path: `/reports/${encodeURIComponent(idOrSlug)}/evidence`,
|
|
60
|
+
signal,
|
|
61
|
+
});
|
|
62
|
+
}
|
|
63
|
+
|
|
47
64
|
get(idOrSlug: string, signal?: AbortSignal): Promise<ReportData> {
|
|
48
65
|
return this.http.request({
|
|
49
66
|
method: "GET",
|
package/src/types.ts
CHANGED
|
@@ -47,6 +47,14 @@ export interface ApprovalData {
|
|
|
47
47
|
metadata: Record<string, unknown>;
|
|
48
48
|
requestedBy: string;
|
|
49
49
|
approvers: string[];
|
|
50
|
+
/**
|
|
51
|
+
* How many people must agree before it settles. One unless a standing rule
|
|
52
|
+
* in the organisation escalated it — an agent cannot set this, and a rule
|
|
53
|
+
* can only push it up.
|
|
54
|
+
*/
|
|
55
|
+
requiredApprovals: number;
|
|
56
|
+
/** How many have approved so far. Compare with `requiredApprovals`. */
|
|
57
|
+
approvalsSoFar: number;
|
|
50
58
|
decidedBy: string | null;
|
|
51
59
|
decidedAt: string | null;
|
|
52
60
|
/** The approver's reason, on a rejection or an approval that carried one. */
|
|
@@ -509,3 +517,81 @@ export interface ListFlowsInput {
|
|
|
509
517
|
externalId?: string;
|
|
510
518
|
limit?: number;
|
|
511
519
|
}
|
|
520
|
+
|
|
521
|
+
/* ── Evidence ─────────────────────────────────────────────────────────────── */
|
|
522
|
+
|
|
523
|
+
export type EvidenceStepKind = "approval" | "review" | "collection" | "report";
|
|
524
|
+
|
|
525
|
+
export interface EvidenceOutcome {
|
|
526
|
+
who: string;
|
|
527
|
+
/** What they said, in the words the step uses: "approved", "answered". */
|
|
528
|
+
said: string;
|
|
529
|
+
note: string | null;
|
|
530
|
+
at: string;
|
|
531
|
+
}
|
|
532
|
+
|
|
533
|
+
export interface EvidenceStep {
|
|
534
|
+
kind: EvidenceStepKind;
|
|
535
|
+
id: string;
|
|
536
|
+
title: string;
|
|
537
|
+
status: string;
|
|
538
|
+
url: string;
|
|
539
|
+
createdAt: string;
|
|
540
|
+
settledAt: string | null;
|
|
541
|
+
requestedBy: string;
|
|
542
|
+
/** Whether an agent asked for this, which is the point of the record. */
|
|
543
|
+
requestedByAgent: boolean;
|
|
544
|
+
asked: string[];
|
|
545
|
+
outcomes: EvidenceOutcome[];
|
|
546
|
+
/** Whatever else the step records: the description, the questions, the answers. */
|
|
547
|
+
detail: Record<string, unknown>;
|
|
548
|
+
}
|
|
549
|
+
|
|
550
|
+
export interface EvidenceEvent {
|
|
551
|
+
at: string;
|
|
552
|
+
event: string;
|
|
553
|
+
actor: string;
|
|
554
|
+
actorType: string;
|
|
555
|
+
/** Which step it happened to, when it happened to one. */
|
|
556
|
+
step: string | null;
|
|
557
|
+
metadata: Record<string, unknown>;
|
|
558
|
+
}
|
|
559
|
+
|
|
560
|
+
export interface EvidencePack {
|
|
561
|
+
packVersion: number;
|
|
562
|
+
generatedAt: string;
|
|
563
|
+
generatedBy: string;
|
|
564
|
+
organisation: { id: string; name: string };
|
|
565
|
+
subject: {
|
|
566
|
+
kind: "flow" | "report";
|
|
567
|
+
id: string;
|
|
568
|
+
title: string;
|
|
569
|
+
url: string;
|
|
570
|
+
status: string;
|
|
571
|
+
startedBy: string;
|
|
572
|
+
startedAt: string;
|
|
573
|
+
};
|
|
574
|
+
summary: {
|
|
575
|
+
steps: number;
|
|
576
|
+
events: number;
|
|
577
|
+
firstEventAt: string | null;
|
|
578
|
+
lastEventAt: string | null;
|
|
579
|
+
};
|
|
580
|
+
steps: EvidenceStep[];
|
|
581
|
+
timeline: EvidenceEvent[];
|
|
582
|
+
/**
|
|
583
|
+
* What the digest does and does not stand for, in the pack's own words.
|
|
584
|
+
*
|
|
585
|
+
* `covers` says it detects a file altered after export. `doesNotCover` says
|
|
586
|
+
* it makes no claim about the database. Both travel with the pack rather
|
|
587
|
+
* than living only in documentation, because a reader who sees a hash and
|
|
588
|
+
* no sentence will assume the stronger one.
|
|
589
|
+
*/
|
|
590
|
+
integrity: {
|
|
591
|
+
algorithm: "sha256";
|
|
592
|
+
digest: string;
|
|
593
|
+
covers: string;
|
|
594
|
+
doesNotCover: string;
|
|
595
|
+
recordsAreInsertOnly: boolean;
|
|
596
|
+
};
|
|
597
|
+
}
|