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

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.operation/artifact.load",
+    "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.operation/artifact.load",
+    "protocolVersion": "0.1.0-draft.2",
+    "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.operation/localization.messages",
+    "protocolVersion": "0.1.0-draft.2",
+    "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.2",
+    "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.2",
+    "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.2",
+    "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.2",
+    "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
+  }
+}

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

@@ -0,0 +1,36 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.media.complete-upload.unknown",
+  "description": "Completing an upload the host never granted is refused without disclosing whether the identifier exists.",
+  "profile": "studio.profile/host-baseline",
+  "port": "media",
+  "operation": "complete-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.complete-upload",
+    "protocolVersion": "0.1.0-draft.2",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "argument": {
+    "uploadId": "uploads/never-granted"
+  },
+  "expect": {
+    "outcome": "error",
+    "category": "not-found",
+    "retryable": false,
+    "messageMustNotContain": ["uploads/never-granted"]
+  }
+}

package/vectors/host/media.get.unknown.json

@@ -0,0 +1,34 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.media.get.unknown",
+  "description": "An unknown media asset resolves to an empty result rather than an error, so absence is not an exception path.",
+  "profile": "studio.profile/host-baseline",
+  "port": "media",
+  "operation": "get",
+  "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.get",
+    "protocolVersion": "0.1.0-draft.2",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "argument": {
+    "assetId": "assets/absent"
+  },
+  "expect": {
+    "outcome": "result",
+    "value": "null"
+  }
+}

package/vectors/host/media.import-external.private-host.error.json

@@ -0,0 +1,36 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.media.import-external.private-host",
+  "description": "An external candidate resolving to a private address is refused by the lexical URL policy, and the message names the stable reason rather than the candidate.",
+  "profile": "studio.profile/host-baseline",
+  "port": "media",
+  "operation": "import-external",
+  "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.import-external",
+    "protocolVersion": "0.1.0-draft.2",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "argument": {
+    "url": "http://169.254.169.254/latest/meta-data"
+  },
+  "expect": {
+    "outcome": "error",
+    "category": "validation-failed",
+    "retryable": false,
+    "messageMustNotContain": ["http://169.254.169.254/latest/meta-data"]
+  }
+}

package/vectors/host/media.list.cursor.error.json

@@ -0,0 +1,36 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.media.list.cursor",
+  "description": "An opaque cursor the host did not mint is refused rather than treated as an offset.",
+  "profile": "studio.profile/host-baseline",
+  "port": "media",
+  "operation": "list",
+  "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.list",
+    "protocolVersion": "0.1.0-draft.2",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "argument": {
+    "cursor": "not-a-cursor",
+    "limit": 10
+  },
+  "expect": {
+    "outcome": "error",
+    "category": "invalid-request",
+    "retryable": false
+  }
+}

package/vectors/host/media.list.limit.error.json

@@ -0,0 +1,35 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.media.list.limit",
+  "description": "A page size outside the declared bound is refused rather than silently clamped.",
+  "profile": "studio.profile/host-baseline",
+  "port": "media",
+  "operation": "list",
+  "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.list",
+    "protocolVersion": "0.1.0-draft.2",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "argument": {
+    "limit": 500
+  },
+  "expect": {
+    "outcome": "error",
+    "category": "invalid-request",
+    "retryable": false
+  }
+}

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

@@ -0,0 +1,35 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.media.upload-status.unknown",
+  "description": "Polling an asset the host never accepted is refused without disclosing existence.",
+  "profile": "studio.profile/host-baseline",
+  "port": "media",
+  "operation": "upload-status",
+  "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.upload-status",
+    "protocolVersion": "0.1.0-draft.2",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "argument": {
+    "assetId": "assets/absent"
+  },
+  "expect": {
+    "outcome": "error",
+    "category": "not-found",
+    "retryable": false
+  }
+}

package/vectors/host/permission.explain.withheld.json

@@ -0,0 +1,34 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.permission.explain.withheld",
+  "description": "An operation the acting identity does not hold is explained as disallowed with a safe reason, never by silently succeeding.",
+  "profile": "studio.profile/host-baseline",
+  "port": "permission",
+  "operation": "explain",
+  "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/permission.explain",
+    "protocolVersion": "0.1.0-draft.2",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "argument": {
+    "operation": "studio.permission/publish"
+  },
+  "expect": {
+    "outcome": "result",
+    "value": "permission-explanation"
+  }
+}

package/vectors/host/permission.refresh.snapshot.json

@@ -0,0 +1,31 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.permission.refresh.snapshot",
+  "description": "Refreshing authority answers with the held permissions and the live session generation.",
+  "profile": "studio.profile/host-baseline",
+  "port": "permission",
+  "operation": "refresh",
+  "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/permission.refresh",
+    "protocolVersion": "0.1.0-draft.2",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "expect": {
+    "outcome": "result",
+    "value": "permission-snapshot"
+  }
+}

package/vectors/host/recovery.load.absent.json

@@ -0,0 +1,31 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.recovery.load.absent",
+  "description": "A recovery envelope that was never stored resolves empty for the requesting context.",
+  "profile": "studio.profile/host-baseline",
+  "port": "recovery",
+  "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.operation/recovery.load",
+    "protocolVersion": "0.1.0-draft.2",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "expect": {
+    "outcome": "result",
+    "value": "null"
+  }
+}

package/vectors/host/telemetry.emit.accepted.json

@@ -0,0 +1,37 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.telemetry.emit.accepted",
+  "description": "A telemetry event carrying only primitive attributes is accepted.",
+  "profile": "studio.profile/host-baseline",
+  "port": "telemetry",
+  "operation": "emit",
+  "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/telemetry.emit",
+    "protocolVersion": "0.1.0-draft.2",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "argument": {
+    "attributes": {
+      "surface": "canvas"
+    },
+    "name": "studio.telemetry/vector"
+  },
+  "expect": {
+    "outcome": "result",
+    "value": "null"
+  }
+}

package/vectors/host/telemetry.emit.non-primitive.error.json

@@ -0,0 +1,40 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "host-vector",
+  "id": "vector.host-vector.telemetry.emit.non-primitive",
+  "description": "A telemetry attribute that is not a JSON primitive is refused, keeping the cardinality discipline enforceable.",
+  "profile": "studio.profile/host-baseline",
+  "port": "telemetry",
+  "operation": "emit",
+  "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/telemetry.emit",
+    "protocolVersion": "0.1.0-draft.2",
+    "requestId": "requests/vector-1",
+    "resourceContextKey": "contexts/vector",
+    "sessionGeneration": "session-r1"
+  },
+  "argument": {
+    "attributes": {
+      "surface": {
+        "nested": true
+      }
+    },
+    "name": "studio.telemetry/vector"
+  },
+  "expect": {
+    "outcome": "error",
+    "category": "invalid-request",
+    "retryable": false
+  }
+}