@mhome/artifact-protocol 0.3.0 → 1.1.1

package/README.md

@@ -3,7 +3,7 @@
 Storage-independent artifact references shared by mHome runtimes.
 
 The crate is the source of truth for the `meow-artifact://v1/` URI format and its
-immutable image, audio, and file metadata. The published schema and conformance
+immutable image, audio, video, and file metadata. The published schema and conformance
 fixtures are intended for non-Rust runtimes.
 
 The crate also defines the transport-neutral `/artifact/resolve` request and response.

package/fixtures/artifact-put.conformance.json

@@ -0,0 +1,28 @@
+{
+  "schemaVersion": 1,
+  "valid": [
+    {
+      "name": "audio-request",
+      "value": { "kind": "AUDIO", "mimeType": "audio/ogg", "dataBase64": "eA==", "durationMillis": 1200 }
+    },
+    {
+      "name": "video-request",
+      "value": { "kind": "VIDEO", "mimeType": "video/mp4", "dataBase64": "eA==", "durationMillis": 2000 }
+    },
+    {
+      "name": "file-response",
+      "value": {
+        "uri": "meow-artifact://v1/tenant/scope/cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc/eyJrIjoiZiIsIm0iOiJhcHBsaWNhdGlvbi9wZGYiLCJzIjozMH0",
+        "kind": "FILE",
+        "mimeType": "application/pdf",
+        "sizeBytes": 30
+      }
+    }
+  ],
+  "invalid": [
+    {
+      "name": "unknown-field",
+      "value": { "kind": "FILE", "mimeType": "text/plain", "dataBase64": "eA==", "path": "/tmp/x" }
+    }
+  ]
+}

package/fixtures/artifact-reference.conformance.json

@@ -18,6 +18,16 @@
       "sizeBytes": 20,
       "durationMillis": 1500
     },
+    {
+      "name": "video",
+      "uri": "meow-artifact://v1/tenant/scope/dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd/eyJrIjoidiIsIm0iOiJ2aWRlby9tcDQiLCJzIjo0MCwidyI6MTkyMCwiaCI6MTA4MCwiZCI6MjAwMH0",
+      "kind": "video",
+      "mimeType": "video/mp4",
+      "sizeBytes": 40,
+      "width": 1920,
+      "height": 1080,
+      "durationMillis": 2000
+    },
     {
       "name": "file",
       "uri": "meow-artifact://v1/tenant/scope/cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc/eyJrIjoiZiIsIm0iOiJhcHBsaWNhdGlvbi9wZGYiLCJzIjozMH0",
@@ -27,10 +37,6 @@
     }
   ],
   "invalid": [
-    {
-      "name": "video-kind",
-      "uri": "meow-artifact://v1/tenant/scope/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/eyJrIjoidiIsIm0iOiJ2aWRlby9tcDQiLCJzIjoxMH0"
-    },
     {
       "name": "file-with-video-mime",
       "uri": "meow-artifact://v1/tenant/scope/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/eyJrIjoiZiIsIm0iOiJ2aWRlby9tcDQiLCJzIjoxMH0"

package/manifest/artifact.v1.json

@@ -1,11 +1,16 @@
 {
   "manifest": "mhome.artifact.v1",
-  "contractVersion": "0.3.0",
+  "contractVersion": "1.1.1",
   "uriPrefix": "meow-artifact://v1/",
-  "kinds": ["image", "audio", "file"],
+  "kinds": ["image", "audio", "video", "file"],
   "resolve": {
     "target": "/artifact/resolve",
     "schema": "schema/artifact-resolve.v1.schema.json",
     "schemaVersion": 1
+  },
+  "put": {
+    "target": "/artifact/put",
+    "schema": "schema/artifact-put.v1.schema.json",
+    "schemaVersion": 1
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mhome/artifact-protocol",
-  "version": "0.3.0",
+  "version": "1.1.1",
   "description": "Build-time protocol artifacts for mhome.artifact",
   "license": "MIT",
   "repository": {

package/protocol.json

@@ -1,13 +1,15 @@
 {
   "protocol": "mhome.artifact",
-  "contractVersion": "0.3.0",
+  "contractVersion": "1.1.1",
   "manifest": "manifest/artifact.v1.json",
   "schemas": {
     "artifactMetadata": "schema/artifact-metadata.v1.schema.json",
-    "artifactResolve": "schema/artifact-resolve.v1.schema.json"
+    "artifactResolve": "schema/artifact-resolve.v1.schema.json",
+    "artifactPut": "schema/artifact-put.v1.schema.json"
   },
   "fixtures": {
     "artifactReference": "fixtures/artifact-reference.conformance.json",
-    "artifactResolve": "fixtures/artifact-resolve.conformance.json"
+    "artifactResolve": "fixtures/artifact-resolve.conformance.json",
+    "artifactPut": "fixtures/artifact-put.conformance.json"
   }
 }

package/schema/artifact-metadata.v1.schema.json

@@ -15,6 +15,19 @@
         "h": { "type": "integer", "minimum": 1, "maximum": 2147483647 }
       }
     },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["k", "m", "s", "w", "h"],
+      "properties": {
+        "k": { "const": "v" },
+        "m": { "type": "string", "pattern": "^video/[a-z0-9!#$&^_.+-]+$", "maxLength": 255 },
+        "s": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
+        "w": { "type": "integer", "minimum": 1, "maximum": 2147483647 },
+        "h": { "type": "integer", "minimum": 1, "maximum": 2147483647 },
+        "d": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }
+      }
+    },
     {
       "type": "object",
       "additionalProperties": false,

package/schema/artifact-put.v1.schema.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mhome.ai/schema/artifact-put.v1.schema.json",
+  "title": "mHome Artifact Put v1",
+  "oneOf": [
+    { "$ref": "#/$defs/request" },
+    { "$ref": "#/$defs/response" }
+  ],
+  "$defs": {
+    "metadata": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["uri", "kind", "mimeType", "sizeBytes"],
+      "properties": {
+        "uri": { "type": "string", "pattern": "^meow-artifact://v1/", "maxLength": 2048 },
+        "kind": { "enum": ["IMAGE", "AUDIO", "VIDEO", "FILE"] },
+        "mimeType": { "type": "string", "minLength": 3, "maxLength": 255 },
+        "sizeBytes": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
+        "width": { "type": "integer", "minimum": 1, "maximum": 2147483647 },
+        "height": { "type": "integer", "minimum": 1, "maximum": 2147483647 },
+        "durationMillis": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }
+      }
+    },
+    "request": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "mimeType", "dataBase64"],
+      "properties": {
+        "kind": { "enum": ["IMAGE", "AUDIO", "VIDEO", "FILE"] },
+        "mimeType": { "type": "string", "minLength": 3, "maxLength": 255 },
+        "dataBase64": { "type": "string", "minLength": 4, "maxLength": 70000000, "pattern": "^[A-Za-z0-9+/]+={0,2}$" },
+        "durationMillis": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }
+      }
+    },
+    "response": { "$ref": "#/$defs/metadata" }
+  }
+}

package/schema/artifact-resolve.v1.schema.json

@@ -21,7 +21,7 @@
       "required": ["uri", "kind", "mimeType", "sizeBytes", "delivery"],
       "properties": {
         "uri": { "type": "string", "pattern": "^meow-artifact://v1/", "maxLength": 2048 },
-        "kind": { "enum": ["IMAGE", "AUDIO", "FILE"] },
+        "kind": { "enum": ["IMAGE", "AUDIO", "VIDEO", "FILE"] },
         "mimeType": { "type": "string", "minLength": 3, "maxLength": 255 },
         "sizeBytes": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
         "width": { "type": "integer", "minimum": 1, "maximum": 2147483647 },