Week of Jan 6 changes

- clarify errors for bad paths and methods - Remove "origin" - add `/capabilities` API and "capabilities" Registry attr - requires `?inline=capabilities` reads, just presence on writes(like model) - remove "schemas" from model, moved into "capabilities" - add 'xid'. Change xref to start with / - add "labels" to model schema : Registry, Groups and Resources - add a "compatiblewith" well-known label - add support for `relation` type of URLs - add text about how to deal with sending incomplete results - error unless you can be tricky via something like pagination spec - allow ?export, ?inline, ?filter on all APIs to control responses - explain that "generated" errors != must send back to client - e.g. security - use highest alphabetical versionid (case insensitive) when all versions have the same "createdat" value. Remove requirement for ?setdefaultversionid Fixes xregistry#199 Fixes xregistry#216 Fixes xregistry#217 Fixes xregistry#213 Fixes xregistry#210 Fixes xregistry#211 Fixes xregistry#209 Fixes xregistry#187 Fixes xregistry#200 Fixes xregistry#202 Signed-off-by: Doug Davis <[email protected]>
duglin · Jan 4, 2025 · feaef7a · feaef7a
1 parent 5350918
commit feaef7a
Show file tree

Hide file tree

Showing 25 changed files with 1,054 additions and 1,114 deletions.
diff --git a/cloudevents/model.json b/cloudevents/model.json
@@ -1,7 +1,4 @@
 {
-  "schemas": [
-    "xRegistry-json"
-  ],
   "groups": {
     "$includes": [
       "../endpoint/model.json#groups",

diff --git a/cloudevents/schemas/document-schema.avsc b/cloudevents/schemas/document-schema.avsc
@@ -35,7 +35,12 @@
             {
               "name": "self",
               "type": "string",
-              "doc": "URI of the object"
+              "doc": "URL of the object"
+            },
+            {
+              "name": "xid",
+              "type": "string",
+              "doc": "Relative URL of the object"
             },
             {
               "name": "description",
@@ -64,11 +69,6 @@
               },
               "doc": "Labels for the object"
             },
-            {
-              "name": "origin",
-              "type": "string",
-              "doc": "URI of the object origin"
-            },
             {
               "name": "createdat",
               "type": [
@@ -247,7 +247,12 @@
                     {
                       "name": "self",
                       "type": "string",
-                      "doc": "URI of the object"
+                      "doc": "URL of the object"
+                    },
+                    {
+                      "name": "xid",
+                      "type": "string",
+                      "doc": "Relative URL of the object"
                     },
                     {
                       "name": "description",
@@ -276,11 +281,6 @@
                       },
                       "doc": "Labels for the object"
                     },
-                    {
-                      "name": "origin",
-                      "type": "string",
-                      "doc": "URI of the object origin"
-                    },
                     {
                       "name": "createdat",
                       "type": [
@@ -530,7 +530,12 @@
             {
               "name": "self",
               "type": "string",
-              "doc": "URI of the object"
+              "doc": "URL of the object"
+            },
+            {
+              "name": "xid",
+              "type": "string",
+              "doc": "Relative URL of the object"
             },
             {
               "name": "description",
@@ -559,11 +564,6 @@
               },
               "doc": "Labels for the object"
             },
-            {
-              "name": "origin",
-              "type": "string",
-              "doc": "URI of the object origin"
-            },
             {
               "name": "createdat",
               "type": [
@@ -648,7 +648,12 @@
             {
               "name": "self",
               "type": "string",
-              "doc": "URI of the object"
+              "doc": "URL of the object"
+            },
+            {
+              "name": "xid",
+              "type": "string",
+              "doc": "Relative URL of the object"
             },
             {
               "name": "description",
@@ -677,11 +682,6 @@
               },
               "doc": "Labels for the object"
             },
-            {
-              "name": "origin",
-              "type": "string",
-              "doc": "URI of the object origin"
-            },
             {
               "name": "createdat",
               "type": [
@@ -745,7 +745,12 @@
                     {
                       "name": "self",
                       "type": "string",
-                      "doc": "URI of the object"
+                      "doc": "URL of the object"
+                    },
+                    {
+                      "name": "xid",
+                      "type": "string",
+                      "doc": "Relative URL of the object"
                     },
                     {
                       "name": "description",
@@ -774,11 +779,6 @@
                       },
                       "doc": "Labels for the object"
                     },
-                    {
-                      "name": "origin",
-                      "type": "string",
-                      "doc": "URI of the object origin"
-                    },
                     {
                       "name": "createdat",
                       "type": [

diff --git a/cloudevents/schemas/document-schema.json b/cloudevents/schemas/document-schema.json
@@ -40,7 +40,12 @@
         "self": {
           "type": "string",
           "format": "uri",
-          "description": "URI of the object"
+          "description": "URL of the object"
+        },
+        "xid": {
+          "type": "string",
+          "format": "uri",
+          "description": "Relative URL of the object"
         },
         "description": {
           "type": "string",
@@ -55,11 +60,6 @@
           "type": "object",
           "description": "Labels for the object"
         },
-        "origin": {
-          "type": "string",
-          "format": "uri",
-          "description": "URI of the object origin"
-        },
         "createdat": {
           "type": "string",
           "format": "date-time",
@@ -1096,7 +1096,12 @@
         "self": {
           "type": "string",
           "format": "uri",
-          "description": "URI of the object"
+          "description": "URL of the object"
+        },
+        "xid": {
+          "type": "string",
+          "format": "uri",
+          "description": "Relative URL of the object"
         },
         "description": {
           "type": "string",
@@ -1111,11 +1116,6 @@
           "type": "object",
           "description": "Labels for the object"
         },
-        "origin": {
-          "type": "string",
-          "format": "uri",
-          "description": "URI of the object origin"
-        },
         "createdat": {
           "type": "string",
           "format": "date-time",
@@ -1773,7 +1773,12 @@
         "self": {
           "type": "string",
           "format": "uri",
-          "description": "URI of the object"
+          "description": "URL of the object"
+        },
+        "xid": {
+          "type": "string",
+          "format": "uri",
+          "description": "Relative URL of the object"
         },
         "description": {
           "type": "string",
@@ -1788,11 +1793,6 @@
           "type": "object",
           "description": "Labels for the object"
         },
-        "origin": {
-          "type": "string",
-          "format": "uri",
-          "description": "URI of the object origin"
-        },
         "createdat": {
           "type": "string",
           "format": "date-time",
@@ -1841,7 +1841,12 @@
         "self": {
           "type": "string",
           "format": "uri",
-          "description": "URI of the object"
+          "description": "URL of the object"
+        },
+        "xid": {
+          "type": "string",
+          "format": "uri",
+          "description": "Relative URL of the object"
         },
         "description": {
           "type": "string",
@@ -1856,11 +1861,6 @@
           "type": "object",
           "description": "Labels for the object"
         },
-        "origin": {
-          "type": "string",
-          "format": "uri",
-          "description": "URI of the object origin"
-        },
         "createdat": {
           "type": "string",
           "format": "date-time",
@@ -1939,7 +1939,12 @@
         "self": {
           "type": "string",
           "format": "uri",
-          "description": "URI of the object"
+          "description": "URL of the object"
+        },
+        "xid": {
+          "type": "string",
+          "format": "uri",
+          "description": "Relative URL of the object"
         },
         "description": {
           "type": "string",
@@ -1954,11 +1959,6 @@
           "type": "object",
           "description": "Labels for the object"
         },
-        "origin": {
-          "type": "string",
-          "format": "uri",
-          "description": "URI of the object origin"
-        },
         "createdat": {
           "type": "string",
           "format": "date-time",
@@ -2017,7 +2017,12 @@
         "self": {
           "type": "string",
           "format": "uri",
-          "description": "URI of the object"
+          "description": "URL of the object"
+        },
+        "xid": {
+          "type": "string",
+          "format": "uri",
+          "description": "Relative URL of the object"
         },
         "description": {
           "type": "string",
@@ -2032,11 +2037,6 @@
           "type": "object",
           "description": "Labels for the object"
         },
-        "origin": {
-          "type": "string",
-          "format": "uri",
-          "description": "URI of the object origin"
-        },
         "createdat": {
           "type": "string",
           "format": "date-time",