@oomol-lab/open-flow 0.1.0-alpha.0

package/dist/common/control-api-conformance.js

@@ -0,0 +1,518 @@
+//#region ../../node_modules/dequal/lite/index.mjs
+var e = Object.prototype.hasOwnProperty;
+function t(n, r) {
+	var i, a;
+	if (n === r) return !0;
+	if (n && r && (i = n.constructor) === r.constructor) {
+		if (i === Date) return n.getTime() === r.getTime();
+		if (i === RegExp) return n.toString() === r.toString();
+		if (i === Array) {
+			if ((a = n.length) === r.length) for (; a-- && t(n[a], r[a]););
+			return a === -1;
+		}
+		if (!i || typeof n == "object") {
+			for (i in a = 0, n) if (e.call(n, i) && ++a && !e.call(r, i) || !(i in r) || !t(n[i], r[i])) return !1;
+			return Object.keys(r).length === a;
+		}
+	}
+	return n !== n && r !== r;
+}
+//#endregion
+//#region src/control/common/conformance.ts
+var n = "open-flow-engine/v1";
+function r(e) {
+	throw Error(e);
+}
+function i(e, n, i) {
+	t(e, n) || r(`${i}: expected ${JSON.stringify(n)}, received ${JSON.stringify(e)}.`);
+}
+function a(e, t) {
+	return (typeof e != "object" || !e || Array.isArray(e)) && r(`${t}: expected an object.`), e;
+}
+function o(e, t) {
+	return Array.isArray(e) || r(`${t}: expected an array.`), e;
+}
+function s(e, t) {
+	return (typeof e != "string" || e.length == 0) && r(`${t}: expected a non-empty string.`), e;
+}
+function c(e, t, n) {
+	i(Object.keys(e).toSorted(), [...t].toSorted(), `${n} fields`);
+}
+function l(e, t) {
+	let n = a(e, t);
+	return c(n, [
+		"connectionId",
+		"displayName",
+		"isDefault",
+		"serviceId",
+		"status"
+	], t), s(n.connectionId, `${t} connectionId`), s(n.displayName, `${t} displayName`), s(n.serviceId, `${t} serviceId`), typeof n.isDefault != "boolean" && r(`${t} isDefault: expected a boolean.`), [
+		"active",
+		"disconnected",
+		"error",
+		"reauth_required"
+	].includes(String(n.status)) || r(`${t} status: invalid status.`), n;
+}
+function u(e, t, n) {
+	let i = a(e, n), o = Object.hasOwn(i, "description"), s = t && Object.hasOwn(i, "value");
+	c(i, [
+		"jsonSchema",
+		"nullable",
+		...o ? ["description"] : [],
+		...s ? ["value"] : []
+	], n), typeof i.nullable != "boolean" && r(`${n} nullable: expected a boolean.`), o && typeof i.description != "string" && r(`${n} description: expected a string.`);
+}
+function d(e, t) {
+	let n = a(e, t), o = Object.hasOwn(n, "defaultConnection"), d = Object.hasOwn(n, "icon");
+	c(n, [
+		"actionId",
+		...o ? ["defaultConnection"] : [],
+		"description",
+		...d ? ["icon"] : [],
+		"inputs",
+		"name",
+		"outputs",
+		"serviceId",
+		"serviceName"
+	], t), s(n.actionId, `${t} actionId`), s(n.name, `${t} name`), s(n.serviceId, `${t} serviceId`), s(n.serviceName, `${t} serviceName`), typeof n.description != "string" && r(`${t} description: expected a string.`), d && s(n.icon, `${t} icon`);
+	for (let [e, r] of Object.entries(a(n.inputs, `${t} inputs`))) u(r, !0, `${t} input ${e}`);
+	for (let [e, r] of Object.entries(a(n.outputs, `${t} outputs`))) u(r, !1, `${t} output ${e}`);
+	if (o) {
+		let e = l(n.defaultConnection, `${t} default Connection`);
+		i(e.serviceId, n.serviceId, `${t} default Connection serviceId`), i(e.status, "active", `${t} default Connection status`);
+	}
+	return n;
+}
+async function f(e, t, n) {
+	return i(e.status, t, `${n} status`), a(await e.json().catch(() => r(`${n} body: expected JSON.`)), `${n} body`);
+}
+async function p(e, t, n, r) {
+	let o = await f(e, t, r);
+	i(a(o.error, `${r} error`).code, n, `${r} error code`), i(o.version, 1, `${r} version`);
+}
+function m(e, t, n = {}) {
+	let r = new Headers(n.headers);
+	return n.body != null && !r.has("content-type") && r.set("content-type", "application/json"), e.request(new Request(new URL(t, e.origin), {
+		...n,
+		headers: r
+	}));
+}
+function h(e, t, n) {
+	return m(e, "/v1/projects", {
+		body: JSON.stringify({
+			name: t,
+			version: 1
+		}),
+		headers: { "idempotency-key": n },
+		method: "POST"
+	});
+}
+async function g(e, t, n) {
+	return await f(await h(e, t, n), 201, "Create Project");
+}
+function _(e, t, n, r) {
+	return m(e, `/v1/projects/${encodeURIComponent(t)}/draft/changes`, {
+		body: JSON.stringify({
+			expectedRevisionId: n,
+			operations: [{
+				flow: {
+					graph: { nodes: {} },
+					name: "Main"
+				},
+				flowId: r,
+				kind: "flow.create"
+			}],
+			version: 1
+		}),
+		method: "POST"
+	});
+}
+async function v(e, t, n, r = "main") {
+	return await f(await _(e, t, n, r), 200, "Create Flow Revision");
+}
+function y(e, t) {
+	return s(a(e.revision, `${t} revision`).revisionId, `${t} revisionId`);
+}
+function b(e, t, n, r) {
+	return m(e, `/v1/projects/${encodeURIComponent(t)}/draft/changes`, {
+		body: JSON.stringify({
+			expectedRevisionId: n,
+			operations: r,
+			version: 1
+		}),
+		method: "POST"
+	});
+}
+function x(e, t, r, i, a, o) {
+	return m(e, `/v1/projects/${encodeURIComponent(t)}/revisions/${encodeURIComponent(r)}/flows/${encodeURIComponent(i)}/publications`, {
+		body: JSON.stringify({
+			engineContract: n,
+			expectedLivePublicationId: a,
+			version: 1
+		}),
+		headers: { "idempotency-key": o },
+		method: "POST"
+	});
+}
+function S(e, t, n, r, i, a) {
+	return m(e, `/v1/projects/${encodeURIComponent(t)}/flows/${encodeURIComponent(n)}/publications/${encodeURIComponent(r)}/rollback`, {
+		body: JSON.stringify({
+			expectedLivePublicationId: i,
+			version: 1
+		}),
+		headers: { "idempotency-key": a },
+		method: "POST"
+	});
+}
+function C(e, t, n, r, i = {}) {
+	return m(e, `/v1/projects/${encodeURIComponent(t)}/flows/${encodeURIComponent(n)}/runs`, {
+		body: JSON.stringify({
+			inputs: i,
+			version: 1
+		}),
+		headers: { "idempotency-key": r },
+		method: "POST"
+	});
+}
+function w(e, t) {
+	return s(e.publicationId, `${t} publicationId`);
+}
+var T = [
+	{
+		name: "creates, replays, lists, reads, and retires a Project",
+		async verify(e) {
+			let t = await g(e, "Control project", "project-lifecycle"), n = s(t.projectId, "Created Project projectId"), r = s(t.draftRevisionId, "Created Project draftRevisionId");
+			i(t.name, "Control project", "Created Project name"), i(t.status, "active", "Created Project status"), i(t.version, 1, "Created Project version"), i(await f(await h(e, "Control project", "project-lifecycle"), 200, "Replay Project"), t, "Replayed Project"), await p(await h(e, "Different project", "project-lifecycle"), 409, "project.conflict", "Conflicting Project"), i(await f(await m(e, `/v1/projects/${encodeURIComponent(n)}`), 200, "Read Project"), t, "Read Project");
+			let a = await f(await m(e, "/v1/projects?includeTotal=true"), 200, "List Projects");
+			i(a.projects, [t], "Listed Projects"), i(a.total, 1, "Project total");
+			let o = await f(await m(e, `/v1/projects/${encodeURIComponent(n)}/draft`), 200, "Read initial Draft");
+			i(o.revisionId, r, "Initial Draft revisionId"), i(o.projectId, n, "Initial Draft projectId");
+			let c = () => m(e, `/v1/projects/${encodeURIComponent(n)}`, { method: "DELETE" }), l = await f(await c(), 202, "Retire Project");
+			i(l.status, "retiring", "Retired Project status"), i(l.projectId, n, "Retired Project projectId"), i(await f(await c(), 202, "Replay Project retirement"), l, "Replayed Project retirement"), await p(await _(e, n, r, "rejected"), 409, "project.busy", "Mutation after retirement");
+		}
+	},
+	{
+		name: "commits immutable Draft Revisions and projects the current Flows",
+		async verify(e) {
+			let t = await g(e, "Draft project", "draft-project"), n = s(t.projectId, "Draft Project projectId"), c = s(t.draftRevisionId, "Draft Project revisionId"), l = await v(e, n, c), u = y(l, "Changed Draft");
+			u == c && r("Changed Draft must advance the Revision identity."), i(a(l.revision, "Changed Draft revision").parentRevisionId, c, "Changed Draft parentRevisionId"), await p(await _(e, n, c, "stale"), 412, "project.revision-conflict", "Stale Draft change"), i((await f(await m(e, `/v1/projects/${encodeURIComponent(n)}`), 200, "Read changed Project")).draftRevisionId, u, "Current Project Draft head"), i(a(a((await f(await m(e, `/v1/projects/${encodeURIComponent(n)}/revisions/${encodeURIComponent(c)}`), 200, "Read immutable Revision")).content, "Old Revision content").document, "Old Revision document").flows, {}, "Old Revision Flows");
+			let d = await f(await m(e, `/v1/projects/${encodeURIComponent(n)}/draft`), 200, "Read current Draft");
+			i(d.revisionId, u, "Current Draft revisionId");
+			let h = a(a(d.content, "Current Draft content").document, "Current Draft document").flows;
+			i(Object.keys(a(h, "Current Draft Flows")), ["main"], "Current Draft Flow ids");
+			let b = await f(await m(e, `/v1/projects/${encodeURIComponent(n)}/draft/sync`), 200, "Sync Draft snapshot");
+			i(b.kind, "snapshot", "Draft snapshot kind"), i(a(b.draft, "Draft snapshot").revisionId, u, "Draft snapshot revisionId");
+			let x = await f(await m(e, `/v1/projects/${encodeURIComponent(n)}/draft/sync?fromRevisionId=${encodeURIComponent(c)}`), 200, "Sync Draft from parent");
+			x.kind == "snapshot" ? i(a(x.draft, "Draft sync snapshot").revisionId, u, "Draft sync snapshot revisionId") : x.kind == "changes" ? i(a(a(o(x.revisions, "Draft sync revisions").at(-1), "Last Draft sync revision").revision, "Last Draft sync revision metadata").revisionId, u, "Last Draft sync revisionId") : r(`Draft sync kind: expected changes or snapshot, received ${JSON.stringify(x.kind)}.`);
+			let S = o((await f(await m(e, `/v1/projects/${encodeURIComponent(n)}/flows`), 200, "List Draft Flows")).flows, "Projected Flows"), C = a(S[0], "Projected Flow");
+			i(S.length, 1, "Projected Flow count"), i(C.flowId, "main", "Projected Flow id"), i(a(C.draft, "Projected Flow Draft").revisionId, u, "Projected Flow Revision");
+		}
+	},
+	{
+		name: "keeps Presentation CAS independent from the Draft head",
+		async verify(e) {
+			let t = await g(e, "Presentation project", "presentation-project"), n = s(t.projectId, "Presentation Project projectId"), r = s(t.draftRevisionId, "Presentation Project Draft head"), a = `/v1/projects/${encodeURIComponent(n)}/presentation`;
+			i((await f(await m(e, a), 200, "Read initial Presentation")).revision, 1, "Initial Presentation revision");
+			let o = { nodes: { task: {
+				x: 120,
+				y: 80
+			} } }, c = await f(await m(e, a, {
+				body: JSON.stringify({
+					expectedRevision: 1,
+					value: o,
+					version: 1
+				}),
+				method: "PUT"
+			}), 200, "Update Presentation");
+			i(c.revision, 2, "Updated Presentation revision"), i(c.value, o, "Updated Presentation value"), i(await f(await m(e, a), 200, "Read updated Presentation"), c, "Persisted Presentation"), await p(await m(e, a, {
+				body: JSON.stringify({
+					expectedRevision: 1,
+					value: {},
+					version: 1
+				}),
+				method: "PUT"
+			}), 412, "project.presentation-conflict", "Stale Presentation update"), i((await f(await m(e, `/v1/projects/${encodeURIComponent(n)}`), 200, "Read Presentation Project")).draftRevisionId, r, "Draft head after Presentation update");
+		}
+	},
+	{
+		name: "validates one Flow from a fixed ProjectRevision",
+		async verify(e) {
+			let t = await g(e, "Validation project", "validation-project"), r = s(t.projectId, "Validation Project projectId"), o = await v(e, r, s(t.draftRevisionId, "Validation Project Draft head")), c = y(o, "Validation Revision"), l = a(o.revision, "Validation Revision"), u = `/v1/projects/${encodeURIComponent(r)}/revisions/${encodeURIComponent(c)}/flows`, d = await f(await m(e, `${u}/main/check`, {
+				body: JSON.stringify({
+					engineContract: n,
+					version: 1
+				}),
+				method: "POST"
+			}), 200, "Check Flow");
+			i(d.projectId, r, "Flow check projectId"), i(d.revisionId, c, "Flow check revisionId"), i(d.revisionDigest, l.digest, "Flow check revision digest"), i(d.flowId, "main", "Flow check flowId"), i(d.engineContract, n, "Flow check Engine Contract"), i(d.modelVersion, 1, "Flow check model version"), i(d.valid, !0, "Flow check validity"), s(d.closureDigest, "Flow check closure digest"), await p(await m(e, `${u}/missing/check`, {
+				body: JSON.stringify({
+					engineContract: n,
+					version: 1
+				}),
+				method: "POST"
+			}), 404, "flow.not-found", "Missing Flow check");
+		}
+	},
+	{
+		name: "admits, observes, and cancels one fixed Draft Run",
+		async verify(e) {
+			let t = await g(e, "Run project", "run-project"), r = s(t.projectId, "Run Project projectId"), c = y(await v(e, r, s(t.draftRevisionId, "Run Project Draft head")), "Run Revision"), l = `/v1/projects/${encodeURIComponent(r)}/revisions/${encodeURIComponent(c)}/flows/main/runs`, u = () => m(e, l, {
+				body: JSON.stringify({
+					engineContract: n,
+					inputs: {},
+					version: 1
+				}),
+				headers: { "idempotency-key": "draft-run" },
+				method: "POST"
+			}), d = await f(await u(), 202, "Create Draft Run"), h = s(d.runId, "Draft Run runId");
+			i(d.projectId, r, "Draft Run projectId"), i(d.revisionId, c, "Draft Run revisionId"), i(d.flowId, "main", "Draft Run flowId"), i(d.source, "draft", "Draft Run source"), i(d.status, "queued", "Draft Run status"), i(await f(await u(), 200, "Replay Draft Run"), d, "Replayed Draft Run");
+			let _ = `/v1/projects/${encodeURIComponent(r)}/runs/${encodeURIComponent(h)}`;
+			i(await f(await m(e, _), 200, "Read Draft Run"), d, "Read Draft Run");
+			let b = await f(await m(e, `/v1/projects/${encodeURIComponent(r)}/runs`), 200, "List Draft Runs");
+			i(b.projectId, r, "Run list projectId"), i(o(b.runs, "Listed Runs").map((e) => a(e, "Listed Run").runId), [h], "Listed Run ids");
+			let x = await f(await m(e, `${_}/events`), 200, "Read queued Run events"), [S] = o(x.events, "Queued Run events");
+			i(a(S, "Queued Run event").kind, "run.queued", "Queued Run event kind"), i(x.done, !1, "Queued Run events done"), await p(await m(e, `${_}/result`), 409, "run.not-terminal", "Read pending Run result");
+			let C = await g(e, "Other project", "other-run-project");
+			await p(await m(e, `/v1/projects/${encodeURIComponent(s(C.projectId, "Other Project projectId"))}/runs/${encodeURIComponent(h)}`), 404, "run.not-found", "Read Run through another Project");
+			let w = () => m(e, `${_}/cancel`, {
+				body: JSON.stringify({ version: 1 }),
+				method: "POST"
+			});
+			i(await f(await w(), 200, "Cancel Draft Run"), {
+				cancelAccepted: !0,
+				runId: h,
+				status: "canceled",
+				version: 1
+			}, "Canceled Draft Run");
+			let T = await f(await m(e, `${_}/result`), 200, "Read canceled Run result");
+			i(T.runId, h, "Canceled Run result runId"), i(T.status, "canceled", "Canceled Run result status"), s(T.finishedAt, "Canceled Run result finishedAt");
+			let E = await f(await m(e, `${_}/events?after=1`), 200, "Read terminal Run events"), [D] = o(E.events, "Terminal Run events");
+			i(a(D, "Terminal Run event").kind, "run.canceled", "Terminal Run event kind"), i(E.done, !0, "Terminal Run events done"), i(await f(await w(), 200, "Replay Run cancellation"), {
+				cancelAccepted: !1,
+				runId: h,
+				status: "canceled",
+				version: 1
+			}, "Replayed cancellation");
+		}
+	}
+], E = [
+	{
+		name: "publishes one immutable Flow with idempotent Live CAS",
+		async verify(e) {
+			let t = await g(e, "Publication project", "publication-project"), r = s(t.projectId, "Publication Project projectId"), c = a((await v(e, r, s(t.draftRevisionId, "Publication Project Draft head"))).revision, "Publication Revision"), l = s(c.revisionId, "Publication Revision revisionId"), u = `/v1/projects/${encodeURIComponent(r)}/flows/main`, d = await f(await m(e, `${u}/live`), 200, "Read unpublished Live");
+			i(d.projectId, r, "Unpublished Live projectId"), i(d.flowId, "main", "Unpublished Live flowId"), i(d.publication, null, "Unpublished Live Publication"), i(d.revision, 0, "Unpublished Live revision"), i(d.status, "not-published", "Unpublished Live status"), i(d.hasUnpublishedChanges, !0, "Unpublished Live Draft state"), await p(await C(e, r, "main", "missing-live-run"), 404, "live.not-found", "Run unpublished Live");
+			let h = () => x(e, r, l, "main", null, "publication-first"), _ = await f(await h(), 201, "Publish Flow"), y = w(_, "Published Flow");
+			i(_.projectId, r, "Publication projectId"), i(_.flowId, "main", "Publication flowId"), i(_.revisionId, l, "Publication revisionId"), i(_.revisionDigest, c.digest, "Publication revision digest"), i(_.engineContract, n, "Publication Engine Contract"), i(_.modelVersion, 1, "Publication model version"), i(_.operation, "publish", "Publication operation"), i(_.sourcePublicationId, void 0, "Publication source"), i(_.version, 1, "Publication version"), s(_.actorId, "Publication actorId"), s(_.closureDigest, "Publication closure digest"), s(_.createdAt, "Publication createdAt"), i(await f(await h(), 200, "Replay Publish"), _, "Replayed Publication"), await p(await x(e, r, l, "main", y, "publication-first"), 409, "publication.conflict", "Conflicting Publish replay"), await p(await x(e, r, l, "main", null, "publication-stale-live"), 412, "live.conflict", "Stale Publish Live precondition");
+			let b = await f(await m(e, `${u}/live`), 200, "Read published Live");
+			i(b.publication, _, "Live Publication"), i(b.revision, 1, "Published Live revision"), i(b.status, "runnable", "Published Live status"), i(b.hasUnpublishedChanges, !1, "Published Live Draft state");
+			let [S] = o((await f(await m(e, `/v1/projects/${encodeURIComponent(r)}/flows`), 200, "List published Flows")).flows, "Published Flow projection"), T = a(S, "Published Flow");
+			i(a(a(T.live, "Published Flow Live").publication, "Published Flow Publication"), _, "Projected Publication"), i(a(T.live, "Published Flow Live").revision, 1, "Projected Live revision"), i(T.hasUnpublishedChanges, !1, "Projected unpublished state");
+			let E = await f(await m(e, `${u}/publications?includeTotal=true`), 200, "List Publication history");
+			i(E.publications, [_], "Publication history"), i(E.total, 1, "Publication history total");
+		}
+	},
+	{
+		name: "rolls back immutable history and fixes a Live Run target",
+		async verify(e) {
+			let t = await g(e, "Rollback project", "rollback-project"), n = s(t.projectId, "Rollback Project projectId"), a = y(await v(e, n, s(t.draftRevisionId, "Rollback Project Draft head")), "First Rollback Revision"), o = await f(await x(e, n, a, "main", null, "rollback-publish-first"), 201, "Publish first Rollback Revision"), c = w(o, "First Rollback Publication"), l = y(await f(await b(e, n, a, [{
+				kind: "graph.node.create",
+				node: {
+					concurrency: 1,
+					inputs: {},
+					kind: "value",
+					values: { ready: {
+						jsonSchema: { type: "boolean" },
+						nullable: !1,
+						value: !0
+					} }
+				},
+				nodeId: "marker",
+				target: {
+					id: "main",
+					kind: "flow"
+				}
+			}]), 200, "Create second Rollback Revision"), "Second Rollback Revision"), u = await f(await x(e, n, l, "main", c, "rollback-publish-second"), 201, "Publish second Rollback Revision"), d = w(u, "Second Rollback Publication"), h = () => S(e, n, "main", c, d, "rollback-first"), _ = await f(await h(), 201, "Rollback Flow"), T = w(_, "Rollback Publication");
+			(T == c || T == d) && r("Rollback must create a new Publication identity."), i(_.operation, "rollback", "Rollback operation"), i(_.sourcePublicationId, c, "Rollback source Publication"), i(_.revisionId, o.revisionId, "Rollback fixed Revision"), i(_.revisionDigest, o.revisionDigest, "Rollback fixed Revision digest"), i(_.closureDigest, o.closureDigest, "Rollback fixed closure digest"), i(_.engineContract, o.engineContract, "Rollback fixed Engine Contract"), i(await f(await h(), 200, "Replay Rollback"), _, "Replayed Rollback"), await p(await S(e, n, "main", c, T, "rollback-first"), 409, "publication.conflict", "Conflicting Rollback replay");
+			let E = `/v1/projects/${encodeURIComponent(n)}/flows/main`, D = await f(await m(e, `${E}/live`), 200, "Read rolled back Live");
+			i(D.publication, _, "Rolled back Live Publication"), i(D.revision, 3, "Rolled back Live revision"), i(D.hasUnpublishedChanges, !0, "Rolled back Live Draft state"), i((await f(await m(e, `/v1/projects/${encodeURIComponent(n)}`), 200, "Read Rollback Project")).draftRevisionId, l, "Draft head after Rollback");
+			let O = await f(await m(e, `${E}/publications?includeTotal=true&limit=2`), 200, "List first Publication page");
+			i(O.publications, [_, u], "First Publication page"), i(O.total, 3, "Publication page total");
+			let k = s(O.nextCursor, "Publication next cursor"), A = await f(await m(e, `${E}/publications?cursor=${encodeURIComponent(k)}&limit=2`), 200, "List second Publication page");
+			i(A.publications, [o], "Second Publication page"), i(A.nextCursor, void 0, "Final Publication cursor");
+			let j = () => C(e, n, "main", "rollback-live-run"), M = await f(await j(), 202, "Create rolled back Live Run"), N = s(M.runId, "Rolled back Live Run runId");
+			i(M.projectId, n, "Live Run projectId"), i(M.flowId, "main", "Live Run flowId"), i(M.publicationId, T, "Live Run Publication"), i(M.revisionId, a, "Live Run fixed Revision"), i(M.source, "live", "Live Run source"), i(M.status, "queued", "Live Run status"), i(await f(await j(), 200, "Replay Live Run"), M, "Replayed Live Run"), await p(await C(e, n, "main", "rollback-live-run", { changed: {} }), 409, "run.conflict", "Conflicting Live Run replay"), await f(await x(e, n, l, "main", T, "rollback-publish-current"), 201, "Move Live after Run admission"), i(await f(await m(e, `/v1/projects/${encodeURIComponent(n)}/runs/${encodeURIComponent(N)}`), 200, "Read fixed Live Run"), M, "Live Run after Live moved");
+		}
+	},
+	{
+		name: "retires Live when its Flow or Project is retired",
+		async verify(e) {
+			let t = await g(e, "Deleted Flow project", "deleted-flow-project"), n = s(t.projectId, "Deleted Flow Project projectId"), r = y(await v(e, n, s(t.draftRevisionId, "Deleted Flow Project Draft head")), "Deleted Flow Revision"), a = await f(await x(e, n, r, "main", null, "deleted-flow-publish"), 201, "Publish deleted Flow");
+			await f(await b(e, n, r, [{
+				flowId: "main",
+				kind: "flow.delete"
+			}]), 200, "Delete published Flow");
+			let o = `/v1/projects/${encodeURIComponent(n)}/flows/main`, c = await f(await m(e, `${o}/live`), 200, "Read deleted Flow Live");
+			i(c.publication, null, "Deleted Flow Live Publication"), i(c.revision, 0, "Deleted Flow Live revision"), i(c.status, "not-published", "Deleted Flow Live status"), i(c.hasUnpublishedChanges, !1, "Deleted Flow unpublished state"), i((await f(await m(e, `/v1/projects/${encodeURIComponent(n)}/flows`), 200, "List deleted Flows")).flows, [], "Deleted Flow projection");
+			let l = await f(await m(e, `${o}/publications?includeTotal=true`), 200, "List deleted Flow history");
+			i(l.publications, [a], "Deleted Flow Publication history"), i(l.total, 1, "Deleted Flow Publication total"), await p(await C(e, n, "main", "deleted-flow-run"), 404, "live.not-found", "Run deleted Flow Live");
+			let u = await g(e, "Retired Live project", "retired-live-project"), d = s(u.projectId, "Retired Live Project projectId"), h = y(await v(e, d, s(u.draftRevisionId, "Retired Live Project Draft head")), "Retired Live Revision"), _ = await f(await x(e, d, h, "main", null, "retired-live-publish"), 201, "Publish retiring Project Flow"), T = w(_, "Retired Live Publication");
+			await f(await m(e, `/v1/projects/${encodeURIComponent(d)}`, { method: "DELETE" }), 202, "Retire Live Project");
+			let E = `/v1/projects/${encodeURIComponent(d)}/flows/main`, D = await f(await m(e, `${E}/live`), 200, "Read retired Project Live");
+			i(D.publication, null, "Retired Project Live Publication"), i(D.revision, 0, "Retired Project Live revision"), i(D.status, "not-published", "Retired Project Live status");
+			let O = await f(await m(e, `${E}/publications?includeTotal=true`), 200, "List retired Publication history");
+			i(O.publications, [_], "Retired Publication history"), i(O.total, 1, "Retired Publication total"), await p(await C(e, d, "main", "retired-live-run"), 409, "project.busy", "Run retired Live"), await p(await x(e, d, h, "main", null, "retired-live-republish"), 409, "project.busy", "Publish retired Project"), await p(await S(e, d, "main", T, T, "retired-live-rollback"), 409, "project.busy", "Rollback retired Project");
+		}
+	}
+], D = [{
+	name: "exposes one deployment-scoped Trigger Key catalog",
+	async verify(e) {
+		let t = await f(await m(e, "/v1/trigger-keys"), 200, "List Trigger Keys"), n = await f(await m(e, "/v1/trigger-keys/catalog"), 200, "List Trigger definitions"), c = o(t.keys, "Trigger Key summaries").map((e) => a(e, "Trigger Key summary")), l = o(n.definitions, "Trigger definitions").map((e) => a(e, "Trigger definition"));
+		i(t.version, 1, "Trigger Key summaries version"), i(n.version, 1, "Trigger definitions version"), i(c.map((e) => s(e.key, "Trigger Key summary key")), l.map((e) => s(e.key, "Trigger definition key")), "Trigger catalog identities");
+		for (let [t, n] of c.entries()) {
+			let a = l[t], o = n.type;
+			o != "integration" && o != "poll" && r(`Trigger Key summary type: expected integration or poll, received ${JSON.stringify(o)}.`), i(a.type, o, "Trigger definition type"), typeof n.description != "string" && r(`Trigger Key summary description: expected string, received ${JSON.stringify(n.description)}.`), s(n.displayName, "Trigger Key summary displayName"), s(n.name, "Trigger Key summary name"), s(n.provider, "Trigger Key summary provider");
+			let c = s(n.key, "Trigger Key summary key"), u = await f(await m(e, `/v1/trigger-keys/${encodeURIComponent(c)}`), 200, "Read Trigger Key");
+			i(u.definition, a, "Trigger Key detail"), i(u.version, 1, "Trigger Key detail version");
+		}
+		await p(await m(e, "/v1/trigger-keys/conformance.missing"), 404, "trigger-key.not-found", "Read missing Trigger Key");
+	}
+}, {
+	name: "operates and retires one Live Trigger binding without creating another execution history",
+	async verify(e) {
+		let t = await g(e, "Trigger project", "trigger-project"), n = s(t.projectId, "Trigger Project projectId"), r = y(await f(await b(e, n, s(t.draftRevisionId, "Trigger Project Draft head"), [{
+			flow: {
+				graph: { nodes: {
+					cron: {
+						cronTimes: [{
+							type: "every",
+							unit: "hour",
+							value: 1
+						}],
+						kind: "cron",
+						name: "Scheduled"
+					},
+					webhook: {
+						inputsDef: [],
+						kind: "webhook",
+						name: "Incoming"
+					}
+				} },
+				name: "Triggered"
+			},
+			flowId: "main",
+			kind: "flow.create"
+		}]), 200, "Create Trigger Flow"), "Trigger Revision"), c = w(await f(await x(e, n, r, "main", null, "trigger-publication-1"), 201, "Publish Trigger Flow"), "First Trigger Publication"), l = `/v1/projects/${encodeURIComponent(n)}/flows/main/triggers`, u = await f(await m(e, l), 200, "List Trigger bindings");
+		i(u.projectId, n, "Trigger binding list projectId"), i(u.flowId, "main", "Trigger binding list flowId"), i(u.version, 1, "Trigger binding list version");
+		let d = o(u.bindings, "Trigger bindings").map((e) => a(e, "Trigger binding"));
+		i(d.map((e) => e.triggerNodeId), ["cron", "webhook"], "Trigger binding order");
+		for (let e of d) i(e.currentPublicationId, c, "Trigger binding current Publication"), i(e.currentRevisionId, r, "Trigger binding current Revision"), i(e.operatorState, "active", "Trigger binding operator state"), i(e.health, "healthy", "Trigger binding health"), i(e.runtimeVersion, 1, "Initial Trigger runtime version"), i(e.endpointUrl, void 0, "Trigger list endpoint URL"), i(e.version, 1, "Trigger binding version"), s(e.updatedAt, "Trigger binding updatedAt");
+		let h = `${l}/webhook`, _ = await f(await m(e, h), 200, "Read Webhook binding"), v = a(_.binding, "Webhook binding detail"), S = s(v.endpointUrl, "Webhook endpoint URL");
+		i(v.kind, "webhook", "Webhook binding kind"), i(_.version, 1, "Webhook binding detail version"), i(a((await f(await m(e, `${l}/cron`), 200, "Read Cron binding")).binding, "Cron binding detail").endpointUrl, void 0, "Cron endpoint URL");
+		let C = (t) => m(e, `${h}/${t}`, {
+			body: JSON.stringify({ version: 1 }),
+			method: "POST"
+		}), T = await f(await C("pause"), 200, "Pause Webhook binding");
+		i(T.operatorState, "paused", "Paused Webhook operator state"), i(T.runtimeVersion, 2, "Paused Webhook runtime version"), i(await f(await C("pause"), 200, "Replay Webhook pause"), T, "Replayed Webhook pause"), i((await e.request(new Request(S, { method: "POST" }))).status, 404, "Paused Webhook callback status");
+		let E = w(await f(await x(e, n, r, "main", c, "trigger-publication-2"), 201, "Republish paused Trigger Flow"), "Second Trigger Publication"), D = a((await f(await m(e, h), 200, "Read paused republished binding")).binding, "Paused binding");
+		i(D.currentPublicationId, E, "Paused binding current Publication"), i(D.operatorState, "paused", "Paused binding state after Publish"), i(D.runtimeVersion, 3, "Paused binding runtime after Publish"), i((await e.request(new Request(S, { method: "POST" }))).status, 404, "Republished paused Webhook callback status");
+		let O = await f(await C("resume"), 200, "Resume Webhook binding");
+		i(O.operatorState, "active", "Resumed Webhook operator state"), i(O.runtimeVersion, 4, "Resumed Webhook runtime version"), i((await e.request(new Request(S, { method: "POST" }))).status, 200, "Resumed Webhook callback status"), await p(await m(e, `${h}/test`, {
+			body: JSON.stringify({ version: 1 }),
+			method: "POST"
+		}), 404, "trigger.not-found", "Test non-Poll binding");
+		let k = await f(await m(e, `${h}/activities?limit=1`), 200, "List first Trigger Activity"), A = a(o(k.activities, "First Trigger Activity page")[0], "First Trigger Activity");
+		i(A.kind, "operator.resumed", "First Trigger Activity kind"), s(A.activityId, "First Trigger Activity id"), s(A.createdAt, "First Trigger Activity createdAt");
+		let j = s(k.nextCursor, "First Trigger Activity cursor"), M = await f(await m(e, `${h}/activities?cursor=${encodeURIComponent(j)}&limit=1`), 200, "List second Trigger Activity");
+		i(a(o(M.activities, "Second Trigger Activity page")[0], "Second Trigger Activity").kind, "operator.paused", "Second Trigger Activity kind"), i(M.nextCursor, void 0, "Last Trigger Activity cursor"), await p(await m(e, `${l}/cron/activities?cursor=${encodeURIComponent(j)}`), 400, "page.invalid-cursor", "Cross-binding Trigger Activity cursor"), await f(await x(e, n, y(await f(await b(e, n, r, [{
+			kind: "graph.node.delete",
+			nodeId: "webhook",
+			target: {
+				id: "main",
+				kind: "flow"
+			}
+		}]), 200, "Delete Webhook Trigger"), "Retired Trigger Revision"), "main", E, "trigger-publication-3"), 201, "Publish retired Webhook Trigger");
+		let N = a((await f(await m(e, h), 200, "Read retired Webhook binding")).binding, "Retired Webhook binding");
+		i(N.currentPublicationId, void 0, "Retired Webhook current Publication"), i(N.currentRevisionId, void 0, "Retired Webhook current Revision"), i(N.endpointUrl, void 0, "Retired Webhook endpoint URL"), i((await e.request(new Request(S, { method: "POST" }))).status, 404, "Retired Webhook callback status"), await p(await C("pause"), 404, "trigger.not-found", "Pause retired Webhook binding"), i(o((await f(await m(e, `${h}/activities`), 200, "Read retired Trigger Activities")).activities, "Retired Trigger Activities").length, 2, "Retired Trigger Activity count");
+	}
+}], O = [{
+	name: "projects one Connector catalog and its authorized Connections",
+	async verify(e) {
+		let t = s((await g(e, "Connector project", "connector-project")).projectId, "Connector Project projectId"), n = `/v1/projects/${encodeURIComponent(t)}/connector`, u = await f(await m(e, `${n}/providers`), 200, "List Connector Providers");
+		c(u, [
+			"projectId",
+			"providers",
+			"version"
+		], "Connector Provider page"), i(u.projectId, t, "Connector Provider page projectId"), i(u.version, 1, "Connector Provider page version");
+		let p = o(u.providers, "Connector Providers").map((e, t) => {
+			let n = a(e, `Connector Provider ${t}`), r = Object.hasOwn(n, "icon");
+			return c(n, [
+				"serviceId",
+				"serviceName",
+				...r ? ["icon"] : []
+			], `Connector Provider ${t}`), s(n.serviceId, `Connector Provider ${t} serviceId`), s(n.serviceName, `Connector Provider ${t} serviceName`), r && s(n.icon, `Connector Provider ${t} icon`), n;
+		});
+		p.length == 0 && r("Connector conformance deployment must expose at least one Provider.");
+		let h = await f(await m(e, `${n}/actions`), 200, "List all Connector Actions");
+		c(h, [
+			"actions",
+			"projectId",
+			"version"
+		], "Complete Connector Action page"), i(h.projectId, t, "Complete Connector Action page projectId"), i(h.version, 1, "Complete Connector Action page version");
+		let _ = o(h.actions, "Complete Connector Actions").map((e, t) => d(e, `Complete Connector Action ${t}`));
+		_.length == 0 && r("Connector conformance deployment must expose at least one Action.");
+		let v = _[0], y = s(v.serviceId, "Selected Connector Action serviceId");
+		p.some((e) => e.serviceId == y) || r("Selected Connector Action must refer to a listed Provider.");
+		let b = await f(await m(e, `${n}/actions?service=${encodeURIComponent(y)}`), 200, "List Provider Connector Actions");
+		c(b, [
+			"actions",
+			"projectId",
+			"version"
+		], "Provider Connector Action page"), i(b.projectId, t, "Provider Connector Action page projectId"), i(b.version, 1, "Provider Connector Action page version"), o(b.actions, "Provider Connector Actions").map((e, t) => d(e, `Provider Connector Action ${t}`)).some((e) => e.actionId == v.actionId) || r("Provider Action list must include the selected Action.");
+		let x = s(v.name, "Selected Connector Action name"), S = await f(await m(e, `${n}/actions?q=${encodeURIComponent(x)}`), 200, "Search Connector Actions");
+		c(S, [
+			"actions",
+			"projectId",
+			"version"
+		], "Searched Connector Action page"), i(S.projectId, t, "Searched Connector Action page projectId"), i(S.version, 1, "Searched Connector Action page version"), o(S.actions, "Searched Connector Actions").map((e, t) => d(e, `Searched Connector Action ${t}`)).some((e) => e.actionId == v.actionId) || r("Connector Action search must include an exact name match.");
+		let C = s(v.actionId, "Selected Connector Action actionId"), w = await f(await m(e, `${n}/actions/${encodeURIComponent(C)}`), 200, "Read Connector Action");
+		c(w, [
+			"action",
+			"projectId",
+			"version"
+		], "Connector Action detail"), i(d(w.action, "Connector Action detail Action"), v, "Connector Action detail"), i(w.projectId, t, "Connector Action detail projectId"), i(w.version, 1, "Connector Action detail version");
+		let T = await f(await m(e, `${n}/connections/${encodeURIComponent(y)}`), 200, "List Connector Connections");
+		c(T, [
+			"connections",
+			"projectId",
+			"serviceId",
+			"version"
+		], "Connector Connection page"), i(T.projectId, t, "Connector Connection page projectId"), i(T.serviceId, y, "Connector Connection page serviceId"), i(T.version, 1, "Connector Connection page version");
+		let E = o(T.connections, "Connector Connections").map((e, t) => l(e, `Connector Connection ${t}`)), D = Object.hasOwn(v, "defaultConnection") ? l(v.defaultConnection, "Selected Connector Action default Connection") : void 0;
+		D != null && !E.some((e) => e.connectionId == D.connectionId) && r("Connector Action default Connection must be present in the service Connection list.");
+		let O = await f(await m(e, `${n}/connections/${encodeURIComponent(y)}/page`, {
+			body: JSON.stringify({
+				returnUrl: "https://workbench.example/projects/connector",
+				version: 1
+			}),
+			method: "POST"
+		}), 200, "Create Connector Connection page");
+		c(O, ["url", "version"], "Connector Connection external page");
+		let k = new URL(s(O.url, "Connector Connection external page URL"));
+		k.protocol != "http:" && k.protocol != "https:" && r("Connector Connection external page URL must use HTTP."), i(O.version, 1, "Connector Connection external page version");
+	}
+}, {
+	name: "rejects invalid or out-of-scope Connector discovery requests",
+	async verify(e) {
+		let t = s((await g(e, "Connector validation", "connector-validation")).projectId, "Connector validation Project projectId"), n = `/v1/projects/${encodeURIComponent(t)}/connector`;
+		await p(await m(e, `${n}/actions?service=mail&q=send`), 400, "project.invalid", "Conflicting Connector Action query"), await p(await m(e, `${n}/actions?q=%20%20`), 400, "project.invalid", "Empty Connector Action query"), await p(await m(e, `${n}/actions?q=${"a".repeat(257)}`), 400, "project.invalid", "Oversized Connector Action query"), await p(await m(e, `${n}/connections/${"a".repeat(257)}`), 400, "project.invalid", "Oversized Connector service"), await p(await m(e, `${n}/connections/mail/page`, {
+			body: JSON.stringify({
+				extra: !0,
+				returnUrl: "https://workbench.example",
+				version: 1
+			}),
+			method: "POST"
+		}), 400, "project.invalid", "Malformed Connector Connection page"), await p(await m(e, "/v1/projects/00000000-0000-7000-8000-000000000000/connector/providers"), 404, "project.not-found", "Out-of-scope Connector Project"), await p(await m(e, `${n}/actions/conformance.missing`), 404, "connector.action-not-found", "Missing Connector Action");
+	}
+}];
+//#endregion
+export { O as connectorControlApiConformanceCases, T as controlApiConformanceCases, E as publicationControlApiConformanceCases, D as triggerControlApiConformanceCases };

package/dist/common/control-api-errors.d.ts

@@ -0,0 +1,121 @@
+export declare const controlErrorCode: {
+    readonly authenticationRequired: 'authentication.required';
+    readonly authorizationDenied: 'authorization.denied';
+    readonly bindingUnresolved: 'binding.unresolved';
+    readonly connectorActionNotFound: 'connector.action-not-found';
+    readonly connectorUnavailable: 'connector.unavailable';
+    readonly engineUnavailable: 'engine.unavailable';
+    readonly engineUnsupported: 'engine.unsupported';
+    readonly flowInvalid: 'flow.invalid';
+    readonly flowNotFound: 'flow.not-found';
+    readonly liveConflict: 'live.conflict';
+    readonly liveNotFound: 'live.not-found';
+    readonly pageInvalidCursor: 'page.invalid-cursor';
+    readonly projectBusy: 'project.busy';
+    readonly projectConflict: 'project.conflict';
+    readonly projectInvalid: 'project.invalid';
+    readonly projectNotFound: 'project.not-found';
+    readonly projectPresentationConflict: 'project.presentation-conflict';
+    readonly projectRevisionConflict: 'project.revision-conflict';
+    readonly publicationConflict: 'publication.conflict';
+    readonly publicationNotFound: 'publication.not-found';
+    readonly routeNotFound: 'route.not-found';
+    readonly runConflict: 'run.conflict';
+    readonly runEventsExpired: 'run.events-expired';
+    readonly runInvalid: 'run.invalid';
+    readonly runNotFound: 'run.not-found';
+    readonly runNotTerminal: 'run.not-terminal';
+    readonly triggerKeyInvalid: 'trigger-key.invalid';
+    readonly triggerKeyNotFound: 'trigger-key.not-found';
+    readonly triggerNotFound: 'trigger.not-found';
+};
+export type ControlErrorCode = (typeof controlErrorCode)[keyof typeof controlErrorCode];
+export declare const controlErrorMetadata: {
+    readonly "authentication.required": {
+        readonly status: 401;
+    };
+    readonly "authorization.denied": {
+        readonly status: 403;
+    };
+    readonly "binding.unresolved": {
+        readonly status: 409;
+    };
+    readonly "connector.action-not-found": {
+        readonly status: 404;
+    };
+    readonly "connector.unavailable": {
+        readonly status: 503;
+    };
+    readonly "engine.unavailable": {
+        readonly status: 503;
+    };
+    readonly "engine.unsupported": {
+        readonly status: 409;
+    };
+    readonly "flow.invalid": {
+        readonly status: 400;
+    };
+    readonly "flow.not-found": {
+        readonly status: 404;
+    };
+    readonly "live.conflict": {
+        readonly status: 412;
+    };
+    readonly "live.not-found": {
+        readonly status: 404;
+    };
+    readonly "page.invalid-cursor": {
+        readonly status: 400;
+    };
+    readonly "project.busy": {
+        readonly status: 409;
+    };
+    readonly "project.conflict": {
+        readonly status: 409;
+    };
+    readonly "project.invalid": {
+        readonly status: 400;
+    };
+    readonly "project.not-found": {
+        readonly status: 404;
+    };
+    readonly "project.presentation-conflict": {
+        readonly status: 412;
+    };
+    readonly "project.revision-conflict": {
+        readonly status: 412;
+    };
+    readonly "publication.conflict": {
+        readonly status: 409;
+    };
+    readonly "publication.not-found": {
+        readonly status: 404;
+    };
+    readonly "route.not-found": {
+        readonly status: 404;
+    };
+    readonly "run.conflict": {
+        readonly status: 409;
+    };
+    readonly "run.events-expired": {
+        readonly status: 410;
+    };
+    readonly "run.invalid": {
+        readonly status: 400;
+    };
+    readonly "run.not-found": {
+        readonly status: 404;
+    };
+    readonly "run.not-terminal": {
+        readonly status: 409;
+    };
+    readonly "trigger-key.invalid": {
+        readonly status: 409;
+    };
+    readonly "trigger-key.not-found": {
+        readonly status: 404;
+    };
+    readonly "trigger.not-found": {
+        readonly status: 404;
+    };
+};