Improve/Fix JSON Schemas

CHANGELOG.md

@@ -8,11 +8,6 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## [v1.0.0-beta.1] - 2020-05-29
 
-### Changed
-
-- Extensions:
-  - [Label extension](extensions/label/README.md) types were clarified and types in README and JSON schema were brought into alignment
-
 ### Removed
 - The API portion of STAC has been split off into a [new repository: stac-api-spec](https://github.com/radiantearth/stac-api-spec) and will start being versioned and released separately than the core STAC spec.
 - proj4 string from proj extension
@@ -35,13 +30,15 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - [Tiled Assets extension](extensions/tiled-assets/README.md), for representing data that has been split into tiles
 
 ### Changed
+- [Label extension](extensions/label/README.md) types were clarified and types in README and JSON schema were brought into alignment
 - Moved item recommendations to best practices, and added a bit more in item spec about 'search'
 - Moved `eo:gsd` from `eo` extension to core `gsd` field in Item common metadata
 - `asset` extension renamed to `item-assets` and renamed `assets` field in Collections to `item_assets`
 - `item-assets` extension only requires any two fields to be available, not the two specific fields `title` and `type`
 - `datetime` allows `null` as value, but requires `start_datetime` and `end_datetime` then
 - Extensions `sat`, `scientific` and `view`: At least one field is required to be specified.
 - [Single File STAC extension](extensions/single-file-stac/README.md) changed to be a complete STAC catalog + GeoJSON FeatureCollection that contains collections and items.
+- Improved several JSON Schemas
 
 ### Fixed
 - Datacube extension: `cube:dimensions` was not flagged as required.

catalog-spec/json-schema/catalog.json

@@ -37,12 +37,7 @@
               },
               {
                 "title": "Reference to a core extension",
-                "type": "string",
-                "enum": [
-                  "checksum",
-                  "single-file-stac",
-                  "tiled-assets"
-                ]
+                "type": "string"
               }
             ]
           }

collection-spec/json-schema/collection.json

@@ -34,16 +34,7 @@
               },
               {
                 "title": "Reference to a core extension",
-                "type": "string",
-                "enum": [
-                  "collection-assets",
-                  "checksum",
-                  "datacube",
-                  "item-assets",
-                  "scientific",
-                  "tiled-assets",
-                  "version"
-                ]
+                "type": "string"
               }
             ]
           }

extensions/checksum/README.md

@@ -17,6 +17,8 @@ Provides a way to specify file checksums (e.g. BLAKE2, MD5, SHA1, SHA2, SHA3) fo
 | ------------------ | ------ | ------------------------------------------------------------ |
 | checksum:multihash | string | Multihash for the corresponding file, encoded as hexadecimal (base 16) string with lowercase letters. |
 
+This extension can OPTIONALLY be used with the [Collection Assets Extension](../collection-assets/README.md). Checksums MUST NOT be part of the [Item Assets Definition](../item-assets/README.md) in Collections.
+
 ### Examples
 
 Checksum for a text file with file content `test`.

extensions/checksum/json-schema/schema.json

@@ -3,27 +3,83 @@
   "$id": "schema.json#",
   "title": "Checksum Extension Specification",
   "description": "STAC Checksum Extension to a STAC Item",
-  "allOf": [
+  "oneOf": [
     {
-      "$ref": "../../../item-spec/json-schema/item.json#/definitions/core"
+      "allOf": [
+        {
+          "$ref": "../../../item-spec/json-schema/item.json"
+        },
+        {
+          "$ref": "#/definitions/stac_extensions"
+        },
+        {
+          "$ref": "#/definitions/checksum_links"
+        },
+        {
+          "$ref": "#/definitions/checksum_assets"
+        }
+      ]
     },
     {
-      "$ref": "#/definitions/checksum"
+      "allOf": [
+        {
+          "$ref": "../../../catalog-spec/json-schema/catalog.json"
+        },
+        {
+          "$ref": "#/definitions/stac_extensions"
+        },
+        {
+          "$ref": "#/definitions/checksum_links"
+        }
+      ]
+    },
+    {
+      "allOf": [
+        {
+          "$ref": "../../../collection-spec/json-schema/collection.json"
+        },
+        {
+          "$ref": "#/definitions/stac_extensions"
+        },
+        {
+          "$ref": "#/definitions/checksum_links"
+        },
+        {
+          "$ref": "#/definitions/checksum_assets"
+        }
+      ]
     }
   ],
   "definitions": {
-    "checksum": {
+    "stac_extensions": {
+      "type": "object",
+      "required": [
+        "stac_extensions"
+      ],
+      "properties": {
+        "stac_extensions": {
+          "type": "array",
+          "contains": {
+            "const": "checksum"
+          }
+        }
+      }
+    },
+    "checksum_links": {
       "type": "object",
       "properties": {
         "links": {
-          "title": "Links",
           "type": "array",
           "items": {
             "$ref": "#/definitions/checksums"
           }
-        },
+        }
+      }
+    },
+    "checksum_assets": {
+      "type": "object",
+      "properties": {
         "assets": {
-          "title": "Assets",
           "type": "object",
           "patternProperties": {
             ".+": {

extensions/collection-assets/json-schema/schema.json

@@ -10,9 +10,16 @@
     {
       "type": "object",
       "required": [
+        "stac_extensions",
         "assets"
       ],
       "properties": {
+        "stac_extensions": {
+          "type": "array",
+          "contains": {
+            "const": "collection-assets"
+          }
+        },
         "assets": {
           "$ref": "../../../item-spec/json-schema/item.json#/definitions/assets"
         }

extensions/datacube/json-schema/schema.json

@@ -9,6 +9,9 @@
         {
           "$ref": "../../../item-spec/json-schema/item.json"
         },
+        {
+          "$ref": "#/definitions/stac_extensions"
+        },
         {
           "type": "object",
           "required": [
@@ -27,13 +30,30 @@
         {
           "$ref": "../../../collection-spec/json-schema/collection.json"
         },
+        {
+          "$ref": "#/definitions/stac_extensions"
+        },
         {
           "$ref": "#/definitions/datacube"
         }
       ]
     }
   ],
   "definitions": {
+    "stac_extensions": {
+      "type": "object",
+      "required": [
+        "stac_extensions"
+      ],
+      "properties": {
+        "stac_extensions": {
+          "type": "array",
+          "contains": {
+            "const": "datacube"
+          }
+        }
+      }
+    },
     "datacube": {
       "type": "object",
       "required": [

extensions/eo/json-schema/schema.json

@@ -15,10 +15,17 @@
     "eo": {
       "type": "object",
       "required": [
+        "stac_extensions",
         "properties",
         "assets"
       ],
       "properties": {
+        "stac_extensions": {
+          "type": "array",
+          "contains": {
+            "const": "eo"
+          }
+        },
         "properties": {
           "type": "object",
           "required": [

extensions/item-assets/json-schema/schema.json

@@ -16,9 +16,16 @@
       "title": "Item Assets Definition",
       "type": "object",
       "required": [
+        "stac_extensions",
         "item_assets"
       ],
       "properties": {
+        "stac_extensions": {
+          "type": "array",
+          "contains": {
+            "const": "item-assets"
+          }
+        },
         "item_assets": {
           "type": "object",
           "additionalProperties": {