@kumwe/studio-testkit 0.1.0-alpha.6 → 0.1.0-alpha.7

package/vectors/host/artifact.load.stored.json

@@ -0,0 +1,36 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.artifact.load.stored",
+  "description": "Loading a stored artifact returns it with the revision it is stored at.",
+  "profile": "studio.profile/host-baseline",
+  "port": "artifact",
+  "operation": "load",
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.blueprint",
+        "kind": "blueprint",
+        "revision": "vector.blueprint-r1"
+      }
+    ],
+    "permissions": ["studio.permission/publish", "studio.permission/save"],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.host/operation",
+    "protocolVersion": "0.1.0-draft.1",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "argument": {
+    "id": "vector.blueprint",
+    "version": "1.0.0"
+  },
+  "expect": {
+    "outcome": "result",
+    "revision": "vector.blueprint-r1",
+    "value": "artifact"
+  }
+}

package/vectors/host/artifact.load.unknown.error.json

@@ -0,0 +1,37 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.artifact.load.unknown",
+  "description": "An unknown artifact identifier is refused as not-found without disclosing whether it exists.",
+  "profile": "studio.profile/host-baseline",
+  "port": "artifact",
+  "operation": "load",
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.blueprint",
+        "kind": "blueprint",
+        "revision": "vector.blueprint-r1"
+      }
+    ],
+    "permissions": ["studio.permission/publish", "studio.permission/save"],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.host/operation",
+    "protocolVersion": "0.1.0-draft.1",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "argument": {
+    "id": "vector.absent",
+    "version": "1.0.0"
+  },
+  "expect": {
+    "outcome": "error",
+    "category": "not-found",
+    "retryable": false,
+    "messageMustNotContain": ["vector.absent"]
+  }
+}

package/vectors/host/artifact.publish.accepted.json

@@ -0,0 +1,37 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.artifact.publish.accepted",
+  "description": "Publishing under the current revision is accepted and advances the revision.",
+  "profile": "studio.profile/host-baseline",
+  "port": "artifact",
+  "operation": "publish",
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.blueprint",
+        "kind": "blueprint",
+        "revision": "vector.blueprint-r1"
+      }
+    ],
+    "permissions": ["studio.permission/publish", "studio.permission/save"],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.host/operation",
+    "protocolVersion": "0.1.0-draft.1",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1",
+    "expectedRevision": "vector.blueprint-r1"
+  },
+  "argument": {
+    "id": "vector.blueprint",
+    "version": "1.0.0"
+  },
+  "expect": {
+    "outcome": "result",
+    "revisionAdvances": true,
+    "value": "null"
+  }
+}

package/vectors/host/artifact.publish.forbidden.error.json

@@ -0,0 +1,37 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.artifact.publish.forbidden",
+  "description": "Publication authority is distinct from save authority: holding one never grants the other.",
+  "profile": "studio.profile/host-baseline",
+  "port": "artifact",
+  "operation": "publish",
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.blueprint",
+        "kind": "blueprint",
+        "revision": "vector.blueprint-r1"
+      }
+    ],
+    "permissions": ["studio.permission/save"],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.operation/artifact.publish",
+    "protocolVersion": "0.1.0-draft.1",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1",
+    "expectedRevision": "vector.blueprint-r1"
+  },
+  "argument": {
+    "id": "vector.blueprint",
+    "version": "1.0.0"
+  },
+  "expect": {
+    "outcome": "error",
+    "category": "forbidden",
+    "retryable": false
+  }
+}

package/vectors/host/artifact.publish.stale.error.json

@@ -0,0 +1,38 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.artifact.publish.stale",
+  "description": "Publishing against a superseded revision conflicts and carries the safe current revision.",
+  "profile": "studio.profile/host-baseline",
+  "port": "artifact",
+  "operation": "publish",
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.blueprint",
+        "kind": "blueprint",
+        "revision": "vector.blueprint-r1"
+      }
+    ],
+    "permissions": ["studio.permission/publish", "studio.permission/save"],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.host/operation",
+    "protocolVersion": "0.1.0-draft.1",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1",
+    "expectedRevision": "vector.blueprint-r0"
+  },
+  "argument": {
+    "id": "vector.blueprint",
+    "version": "1.0.0"
+  },
+  "expect": {
+    "outcome": "error",
+    "category": "conflict",
+    "retryable": false,
+    "revision": "vector.blueprint-r1"
+  }
+}

package/vectors/host/artifact.save.accepted.json

@@ -0,0 +1,38 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.artifact.save.accepted",
+  "description": "A save whose expected revision matches the stored revision is accepted and advances the revision.",
+  "profile": "studio.profile/host-baseline",
+  "port": "artifact",
+  "operation": "save",
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.blueprint",
+        "kind": "blueprint",
+        "revision": "vector.blueprint-r1"
+      }
+    ],
+    "permissions": ["studio.permission/publish", "studio.permission/save"],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.host/operation",
+    "protocolVersion": "0.1.0-draft.1",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1",
+    "expectedRevision": "vector.blueprint-r1",
+    "idempotencyKey": "idempotency/save-1"
+  },
+  "argument": {
+    "id": "vector.blueprint",
+    "kind": "blueprint"
+  },
+  "expect": {
+    "outcome": "result",
+    "revisionAdvances": true,
+    "value": "null"
+  }
+}

package/vectors/host/artifact.save.forbidden.error.json

@@ -0,0 +1,38 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.artifact.save.forbidden",
+  "description": "A save the acting identity is not authorized for is refused before the artifact is touched, and the refusal does not disclose whether it exists.",
+  "profile": "studio.profile/host-baseline",
+  "port": "artifact",
+  "operation": "save",
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.blueprint",
+        "kind": "blueprint",
+        "revision": "vector.blueprint-r1"
+      }
+    ],
+    "permissions": ["studio.permission/publish"],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.operation/artifact.save",
+    "protocolVersion": "0.1.0-draft.1",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1",
+    "expectedRevision": "vector.blueprint-r1"
+  },
+  "argument": {
+    "id": "vector.blueprint",
+    "kind": "blueprint"
+  },
+  "expect": {
+    "outcome": "error",
+    "category": "forbidden",
+    "retryable": false,
+    "messageMustNotContain": ["vector.blueprint"]
+  }
+}

package/vectors/host/artifact.save.stale.error.json

@@ -0,0 +1,39 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.artifact.save.stale",
+  "description": "A save against a superseded revision conflicts and returns the safe current revision so the client resolves without a second read.",
+  "profile": "studio.profile/host-baseline",
+  "port": "artifact",
+  "operation": "save",
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.blueprint",
+        "kind": "blueprint",
+        "revision": "vector.blueprint-r1"
+      }
+    ],
+    "permissions": ["studio.permission/publish", "studio.permission/save"],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.host/operation",
+    "protocolVersion": "0.1.0-draft.1",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1",
+    "expectedRevision": "vector.blueprint-r0",
+    "idempotencyKey": "idempotency/save-2"
+  },
+  "argument": {
+    "id": "vector.blueprint",
+    "kind": "blueprint"
+  },
+  "expect": {
+    "outcome": "error",
+    "category": "conflict",
+    "retryable": false,
+    "revision": "vector.blueprint-r1"
+  }
+}

package/vectors/host/artifact.unpublish.stale.error.json

@@ -0,0 +1,38 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.artifact.unpublish.stale",
+  "description": "Unpublishing is revision-checked exactly like every other mutation.",
+  "profile": "studio.profile/host-baseline",
+  "port": "artifact",
+  "operation": "unpublish",
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.blueprint",
+        "kind": "blueprint",
+        "revision": "vector.blueprint-r1"
+      }
+    ],
+    "permissions": ["studio.permission/publish", "studio.permission/save"],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.host/operation",
+    "protocolVersion": "0.1.0-draft.1",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1",
+    "expectedRevision": "vector.blueprint-r0"
+  },
+  "argument": {
+    "id": "vector.blueprint",
+    "version": "1.0.0"
+  },
+  "expect": {
+    "outcome": "error",
+    "category": "conflict",
+    "retryable": false,
+    "revision": "vector.blueprint-r1"
+  }
+}

package/vectors/host/envelope.malformed-context.error.json

@@ -0,0 +1,36 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.envelope.malformed-context",
+  "description": "A structurally invalid request envelope is refused as invalid-request rather than partially honoured.",
+  "profile": "studio.profile/host-baseline",
+  "port": "artifact",
+  "operation": "load",
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.blueprint",
+        "kind": "blueprint",
+        "revision": "vector.blueprint-r1"
+      }
+    ],
+    "permissions": ["studio.permission/publish", "studio.permission/save"],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.host/operation",
+    "protocolVersion": "0.1.0-draft.1",
+    "requestId": "",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "argument": {
+    "id": "vector.blueprint",
+    "version": "1.0.0"
+  },
+  "expect": {
+    "outcome": "error",
+    "category": "invalid-request",
+    "retryable": false
+  }
+}

package/vectors/host/envelope.protocol-version.error.json

@@ -0,0 +1,36 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.envelope.protocol-version",
+  "description": "A request naming a wire version the host does not support is refused as incompatible before any work.",
+  "profile": "studio.profile/host-baseline",
+  "port": "artifact",
+  "operation": "load",
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.blueprint",
+        "kind": "blueprint",
+        "revision": "vector.blueprint-r1"
+      }
+    ],
+    "permissions": ["studio.permission/publish", "studio.permission/save"],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.host/operation",
+    "protocolVersion": "9.9.9",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "argument": {
+    "id": "vector.blueprint",
+    "version": "1.0.0"
+  },
+  "expect": {
+    "outcome": "error",
+    "category": "incompatible",
+    "retryable": false
+  }
+}

package/vectors/host/envelope.stale-generation.error.json

@@ -0,0 +1,36 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.envelope.stale-generation",
+  "description": "A request carrying a superseded session generation is refused; a permission or context change mints a new generation.",
+  "profile": "studio.profile/host-baseline",
+  "port": "artifact",
+  "operation": "load",
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.blueprint",
+        "kind": "blueprint",
+        "revision": "vector.blueprint-r1"
+      }
+    ],
+    "permissions": ["studio.permission/publish", "studio.permission/save"],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.host/operation",
+    "protocolVersion": "0.1.0-draft.1",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r0"
+  },
+  "argument": {
+    "id": "vector.blueprint",
+    "version": "1.0.0"
+  },
+  "expect": {
+    "outcome": "error",
+    "category": "invalid-request",
+    "retryable": false
+  }
+}

package/vectors/host/localization.messages.unknown-locale.error.json

@@ -0,0 +1,36 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.localization.messages.unknown-locale",
+  "description": "A locale the host does not carry is refused as not-found rather than answered with an empty bundle.",
+  "profile": "studio.profile/host-baseline",
+  "port": "localization",
+  "operation": "messages",
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.blueprint",
+        "kind": "blueprint",
+        "revision": "vector.blueprint-r1"
+      }
+    ],
+    "permissions": ["studio.permission/publish", "studio.permission/save"],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.host/operation",
+    "protocolVersion": "0.1.0-draft.1",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "argument": {
+    "locale": "zz",
+    "namespaces": ["studio.shell"]
+  },
+  "expect": {
+    "outcome": "error",
+    "category": "not-found",
+    "retryable": false
+  }
+}

package/vectors/host/media.abort-upload.unknown.error.json

@@ -0,0 +1,35 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.media.abort-upload.unknown",
+  "description": "Aborting an unknown grant is refused rather than reported as a silent success.",
+  "profile": "studio.profile/host-baseline",
+  "port": "media",
+  "operation": "abort-upload",
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.blueprint",
+        "kind": "blueprint",
+        "revision": "vector.blueprint-r1"
+      }
+    ],
+    "permissions": ["studio.permission/publish", "studio.permission/save"],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.operation/media.abort-upload",
+    "protocolVersion": "0.1.0-draft.1",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "argument": {
+    "uploadId": "uploads/never-granted"
+  },
+  "expect": {
+    "outcome": "error",
+    "category": "not-found",
+    "retryable": false
+  }
+}

package/vectors/host/media.authorize-upload.granted.json

@@ -0,0 +1,37 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.media.authorize-upload.granted",
+  "description": "An upload within policy is authorized before any byte moves, returning a bounded, expiring grant.",
+  "profile": "studio.profile/host-baseline",
+  "port": "media",
+  "operation": "authorize-upload",
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.blueprint",
+        "kind": "blueprint",
+        "revision": "vector.blueprint-r1"
+      }
+    ],
+    "permissions": ["studio.permission/publish", "studio.permission/save"],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.operation/media.authorize-upload",
+    "protocolVersion": "0.1.0-draft.1",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "argument": {
+    "byteSize": 1048576,
+    "filename": "photo.jpg",
+    "mediaType": "image/jpeg",
+    "purpose": "studio.media/content"
+  },
+  "expect": {
+    "outcome": "result",
+    "value": "upload-grant"
+  }
+}

package/vectors/host/media.authorize-upload.path-filename.error.json

@@ -0,0 +1,39 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.media.authorize-upload.path-filename",
+  "description": "A declared filename carrying a path separator is refused: a filename is display metadata, never a storage path.",
+  "profile": "studio.profile/host-baseline",
+  "port": "media",
+  "operation": "authorize-upload",
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.blueprint",
+        "kind": "blueprint",
+        "revision": "vector.blueprint-r1"
+      }
+    ],
+    "permissions": ["studio.permission/publish", "studio.permission/save"],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.operation/media.authorize-upload",
+    "protocolVersion": "0.1.0-draft.1",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "argument": {
+    "byteSize": 1024,
+    "filename": "../../etc/passwd",
+    "mediaType": "image/jpeg",
+    "purpose": "studio.media/content"
+  },
+  "expect": {
+    "outcome": "error",
+    "category": "validation-failed",
+    "retryable": false,
+    "messageMustNotContain": ["../../etc/passwd"]
+  }
+}

package/vectors/host/media.authorize-upload.too-large.error.json

@@ -0,0 +1,38 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.media.authorize-upload.too-large",
+  "description": "An upload larger than the host bound is refused at authorization, so no transfer is ever started.",
+  "profile": "studio.profile/host-baseline",
+  "port": "media",
+  "operation": "authorize-upload",
+  "given": {
+    "artifacts": [
+      {
+        "id": "vector.blueprint",
+        "kind": "blueprint",
+        "revision": "vector.blueprint-r1"
+      }
+    ],
+    "permissions": ["studio.permission/publish", "studio.permission/save"],
+    "sessionGeneration": "session-r1"
+  },
+  "context": {
+    "operationId": "studio.operation/media.authorize-upload",
+    "protocolVersion": "0.1.0-draft.1",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "argument": {
+    "byteSize": 1073741824,
+    "filename": "huge.bin",
+    "mediaType": "image/jpeg",
+    "purpose": "studio.media/content"
+  },
+  "expect": {
+    "outcome": "error",
+    "category": "limit-exceeded",
+    "retryable": false
+  }
+}