chore: add template

Author: danez

packages/config-schema/src/schema/netlify-toml.schema.json

@@ -27,7 +27,9 @@
       "title": "Environment Variables",
       "description": "Define build environment variables. Variables set here override those set with the Netlify UI, CLI, or API. Be mindful when using this option and avoid committing sensitive values to public source repositories.",
       "type": "object",
-      "additionalProperties": true
+      "additionalProperties": {
+        "type": "string"
+      }
     },
     "Processing": {
       "title": "Post processing",
@@ -650,6 +652,38 @@
           "key": "https://docs.netlify.com/configure-builds/file-based-configuration/#netlify-dev"
         }
       }
+    },
+    "template": {
+      "title": "Template configuration",
+      "description": "",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "incoming-hooks": {
+          "title": "Incoming hooks",
+          "description": "A list of incoming hooks for the users site. This is very useful if you want to allow a third party service to control when to deploy the site. This is what headless CMS services like Contentful and DatoCMS do.",
+          "type": "array",
+          "default": [""],
+          "items": {
+            "title": "Integrations",
+            "description": "The name of an integration.",
+            "type": "string"
+          }
+        },
+        "environment": {
+          "title": "Environment Variables",
+          "description": "A list of required environment variables. This is the way to let users configure specific configuration options upon deployment. It also enables customization without having to change the code of the base template.",
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        }
+      },
+      "x-taplo": {
+        "links": {
+          "key": "https://docs.netlify.com/site-deploys/create-deploys/#template-configuration"
+        }
+      }
     }
   },
   "x-taplo": {

packages/config-schema/tests/fixtures/templates-errors/snapshot.snap

@@ -0,0 +1,32 @@
+{
+  "errors": [
+    {
+      "instancePath": "/template",
+      "keyword": "additionalProperties",
+      "message": "must NOT have additional properties",
+      "params": {
+        "additionalProperty": "other",
+      },
+      "schemaPath": "#/properties/template/additionalProperties",
+    },
+    {
+      "instancePath": "/template/environment",
+      "keyword": "type",
+      "message": "must be object",
+      "params": {
+        "type": "object",
+      },
+      "schemaPath": "#/properties/template/properties/environment/type",
+    },
+    {
+      "instancePath": "/template/incoming-hooks",
+      "keyword": "type",
+      "message": "must be array",
+      "params": {
+        "type": "array",
+      },
+      "schemaPath": "#/properties/template/properties/incoming-hooks/type",
+    },
+  ],
+  "valid": false,
+}

packages/config-schema/tests/fixtures/templates-errors/test.toml

@@ -0,0 +1,4 @@
+[template]
+incoming-hooks = 1
+other = 1
+environment = 1

packages/config-schema/tests/fixtures/templates-errors2/snapshot.snap

@@ -0,0 +1,23 @@
+{
+  "errors": [
+    {
+      "instancePath": "/template/environment/ASDFG",
+      "keyword": "type",
+      "message": "must be string",
+      "params": {
+        "type": "string",
+      },
+      "schemaPath": "#/properties/template/properties/environment/additionalProperties/type",
+    },
+    {
+      "instancePath": "/template/incoming-hooks/0",
+      "keyword": "type",
+      "message": "must be string",
+      "params": {
+        "type": "string",
+      },
+      "schemaPath": "#/properties/template/properties/incoming-hooks/items/type",
+    },
+  ],
+  "valid": false,
+}

packages/config-schema/tests/fixtures/templates-errors2/test.toml

@@ -0,0 +1,5 @@
+[template]
+incoming-hooks = [1]
+
+[template.environment]
+ASDFG = 1

packages/config-schema/tests/fixtures/templates-pass/snapshot.snap

@@ -0,0 +1,4 @@
+{
+  "errors": undefined,
+  "valid": true,
+}

packages/config-schema/tests/fixtures/templates-pass/test.toml

@@ -0,0 +1,5 @@
+[template]
+incoming-hooks = ["Contentful"]
+
+[template.environment]
+ASDFG = "STRING"