@rathnasgala2/schemas 2.22.0 → 3.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rathnasgala2/schemas",
-  "version": "2.22.0",
+  "version": "3.1.0",
   "description": "Executable JSON Schema and OpenAPI contracts for Galascribe",
   "type": "module",
   "license": "Apache-2.0",
@@ -40,6 +40,7 @@
     "./schemas/deployment-observation.schema.json": "./schemas/deployment-observation.schema.json",
     "./schemas/deployment-receipt.schema.json": "./schemas/deployment-receipt.schema.json",
     "./schemas/event-envelope.schema.json": "./schemas/event-envelope.schema.json",
+    "./schemas/interactions-config.schema.json": "./schemas/interactions-config.schema.json",
     "./schemas/lock.schema.json": "./schemas/lock.schema.json",
     "./schemas/navigation.schema.json": "./schemas/navigation.schema.json",
     "./schemas/problem.schema.json": "./schemas/problem.schema.json",

package/sbom.cdx.json

@@ -97,8 +97,8 @@
       "type": "library",
       "name": "schemas",
       "group": "@rathnasgala2",
-      "version": "2.22.0",
-      "bom-ref": "@rathnasgala2/schemas@2.22.0",
+      "version": "3.1.0",
+      "bom-ref": "@rathnasgala2/schemas@3.1.0",
       "description": "Executable JSON Schema and OpenAPI contracts for Galascribe",
       "licenses": [
         {
@@ -108,7 +108,7 @@
           }
         }
       ],
-      "purl": "pkg:npm/%40rathnasgala2/schemas@2.22.0?vcs_url=git%2Bhttps%3A%2F%2Fgithub.com%2Frathnasgala2%2Fschema.git",
+      "purl": "pkg:npm/%40rathnasgala2/schemas@3.1.0?vcs_url=git%2Bhttps%3A%2F%2Fgithub.com%2Frathnasgala2%2Fschema.git",
       "externalReferences": [
         {
           "url": "https://github.com/rathnasgala2/schema/issues",
@@ -153,7 +153,7 @@
       "type": "library",
       "name": "ajv-formats",
       "version": "3.0.1",
-      "bom-ref": "@rathnasgala2/schemas@2.22.0|ajv-formats@3.0.1",
+      "bom-ref": "@rathnasgala2/schemas@3.1.0|ajv-formats@3.0.1",
       "licenses": [
         {
           "license": {
@@ -187,7 +187,7 @@
       "type": "library",
       "name": "ajv",
       "version": "8.20.0",
-      "bom-ref": "@rathnasgala2/schemas@2.22.0|ajv@8.20.0",
+      "bom-ref": "@rathnasgala2/schemas@3.1.0|ajv@8.20.0",
       "licenses": [
         {
           "license": {
@@ -221,7 +221,7 @@
       "type": "library",
       "name": "fast-deep-equal",
       "version": "3.1.3",
-      "bom-ref": "@rathnasgala2/schemas@2.22.0|fast-deep-equal@3.1.3",
+      "bom-ref": "@rathnasgala2/schemas@3.1.0|fast-deep-equal@3.1.3",
       "licenses": [
         {
           "license": {
@@ -255,7 +255,7 @@
       "type": "library",
       "name": "fast-uri",
       "version": "3.1.8",
-      "bom-ref": "@rathnasgala2/schemas@2.22.0|fast-uri@3.1.8",
+      "bom-ref": "@rathnasgala2/schemas@3.1.0|fast-uri@3.1.8",
       "licenses": [
         {
           "license": {
@@ -289,7 +289,7 @@
       "type": "library",
       "name": "json-schema-traverse",
       "version": "1.0.0",
-      "bom-ref": "@rathnasgala2/schemas@2.22.0|json-schema-traverse@1.0.0",
+      "bom-ref": "@rathnasgala2/schemas@3.1.0|json-schema-traverse@1.0.0",
       "licenses": [
         {
           "license": {
@@ -323,7 +323,7 @@
       "type": "library",
       "name": "require-from-string",
       "version": "2.0.2",
-      "bom-ref": "@rathnasgala2/schemas@2.22.0|require-from-string@2.0.2",
+      "bom-ref": "@rathnasgala2/schemas@3.1.0|require-from-string@2.0.2",
       "licenses": [
         {
           "license": {
@@ -1064,10 +1064,10 @@
   ],
   "dependencies": [
     {
-      "ref": "@rathnasgala2/schemas@2.22.0",
+      "ref": "@rathnasgala2/schemas@3.1.0",
       "dependsOn": [
-        "@rathnasgala2/schemas@2.22.0|ajv-formats@3.0.1",
-        "@rathnasgala2/schemas@2.22.0|ajv@8.20.0",
+        "@rathnasgala2/schemas@3.1.0|ajv-formats@3.0.1",
+        "@rathnasgala2/schemas@3.1.0|ajv@8.20.0",
         "pkg:npm/semver@7.8.5",
         "urn:gala:source-data:iana-ipv4-special-registry",
         "urn:gala:source-data:iana-ipv6-special-registry",
@@ -1089,31 +1089,31 @@
       ]
     },
     {
-      "ref": "@rathnasgala2/schemas@2.22.0|ajv-formats@3.0.1",
+      "ref": "@rathnasgala2/schemas@3.1.0|ajv-formats@3.0.1",
       "dependsOn": [
-        "@rathnasgala2/schemas@2.22.0|ajv@8.20.0"
+        "@rathnasgala2/schemas@3.1.0|ajv@8.20.0"
       ]
     },
     {
-      "ref": "@rathnasgala2/schemas@2.22.0|ajv@8.20.0",
+      "ref": "@rathnasgala2/schemas@3.1.0|ajv@8.20.0",
       "dependsOn": [
-        "@rathnasgala2/schemas@2.22.0|fast-deep-equal@3.1.3",
-        "@rathnasgala2/schemas@2.22.0|fast-uri@3.1.8",
-        "@rathnasgala2/schemas@2.22.0|json-schema-traverse@1.0.0",
-        "@rathnasgala2/schemas@2.22.0|require-from-string@2.0.2"
+        "@rathnasgala2/schemas@3.1.0|fast-deep-equal@3.1.3",
+        "@rathnasgala2/schemas@3.1.0|fast-uri@3.1.8",
+        "@rathnasgala2/schemas@3.1.0|json-schema-traverse@1.0.0",
+        "@rathnasgala2/schemas@3.1.0|require-from-string@2.0.2"
       ]
     },
     {
-      "ref": "@rathnasgala2/schemas@2.22.0|fast-deep-equal@3.1.3"
+      "ref": "@rathnasgala2/schemas@3.1.0|fast-deep-equal@3.1.3"
     },
     {
-      "ref": "@rathnasgala2/schemas@2.22.0|fast-uri@3.1.8"
+      "ref": "@rathnasgala2/schemas@3.1.0|fast-uri@3.1.8"
     },
     {
-      "ref": "@rathnasgala2/schemas@2.22.0|json-schema-traverse@1.0.0"
+      "ref": "@rathnasgala2/schemas@3.1.0|json-schema-traverse@1.0.0"
     },
     {
-      "ref": "@rathnasgala2/schemas@2.22.0|require-from-string@2.0.2"
+      "ref": "@rathnasgala2/schemas@3.1.0|require-from-string@2.0.2"
     },
     {
       "ref": "pkg:npm/semver@7.8.5"

package/schemas/artifact-manifest.schema.json

@@ -587,7 +587,7 @@
         "routeClass": { "enum": ["html", "feed", "sitemap", "asset", "error"] },
         "stableContentId": { "$ref": "#/$defs/stableId" },
         "sourceRevision": { "$ref": "#/$defs/gitObjectId" },
-        "interactionBearing": { "const": false }
+        "interactionBearing": { "type": "boolean" }
       },
       "additionalProperties": false
     },

package/schemas/build-input.schema.json

@@ -506,6 +506,25 @@
           },
           "additionalProperties": false
         },
+        "crawlers": {
+          "type": "object",
+          "required": ["ai"],
+          "properties": { "ai": { "enum": ["allow", "block"] } },
+          "additionalProperties": false
+        },
+        "newsletter": {
+          "type": "object",
+          "required": ["url", "title", "text"],
+          "properties": {
+            "url": { "$ref": "#/$defs/urlHttps" },
+            "title": { "$ref": "#/$defs/plainLabel" },
+            "text": {
+              "$ref": "#/$defs/plainText",
+              "x-gala-graphemeLength": { "minimum": 1, "maximum": 300 }
+            }
+          },
+          "additionalProperties": false
+        },
         "sourcePath": { "$ref": "#/$defs/repoRelativePath" },
         "sourceDigest": { "$ref": "#/$defs/digest" }
       },
@@ -913,9 +932,124 @@
     "moduleBuildSelection": {
       "type": "object",
       "required": [],
-      "properties": {},
+      "properties": {
+        "interactions": {
+          "type": "object",
+          "required": ["config", "apiOrigin", "appOrigin"],
+          "properties": {
+            "config": { "$ref": "#/$defs/interactionsConfig" },
+            "apiOrigin": { "$ref": "#/$defs/interactionsServiceOrigin" },
+            "appOrigin": { "$ref": "#/$defs/interactionsServiceOrigin" }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "interactionsConfig": {
+      "type": "object",
+      "required": [
+        "schemaId",
+        "schemaVersion",
+        "reactions",
+        "comments",
+        "publicCounts"
+      ],
+      "properties": {
+        "schemaId": { "const": "urn:gala:schema:interactions-config:2.0.0" },
+        "schemaVersion": { "const": "2.0.0" },
+        "reactions": {
+          "type": "object",
+          "required": ["enabled", "definitions"],
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "definitions": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/reactionDefinition" },
+              "minItems": 0,
+              "maxItems": 16
+            }
+          },
+          "additionalProperties": false
+        },
+        "comments": {
+          "type": "object",
+          "required": ["enabled", "allowReplies", "maxDepth"],
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "allowReplies": { "type": "boolean" },
+            "maxDepth": { "type": "integer", "minimum": 1, "maximum": 4 }
+          },
+          "additionalProperties": false
+        },
+        "publicCounts": {
+          "type": "object",
+          "required": ["reactions", "comments"],
+          "properties": {
+            "reactions": { "type": "boolean" },
+            "comments": { "type": "boolean" }
+          },
+          "additionalProperties": false
+        }
+      },
       "additionalProperties": false,
-      "maxProperties": 0
+      "$comment": "JSON Schema cannot express two rules; consumers enforce them: reaction keys are unique within definitions, and reaction orders are unique within definitions."
+    },
+    "reactionKey": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]{1,31}$",
+      "not": { "const": "like" },
+      "description": "Stable reaction key. \"like\" is reserved: Like is implicit whenever reactions are enabled."
+    },
+    "reactionVisual": {
+      "type": "object",
+      "required": ["kind", "token"],
+      "properties": {
+        "kind": { "const": "emoji" },
+        "token": {
+          "enum": [
+            "👍",
+            "❤️",
+            "💡",
+            "🎉",
+            "😂",
+            "🤯",
+            "🙏",
+            "🔥",
+            "👏",
+            "😮",
+            "😢",
+            "🤔",
+            "✨",
+            "🚀",
+            "💯",
+            "👀"
+          ]
+        }
+      },
+      "additionalProperties": false
+    },
+    "reactionDefinition": {
+      "type": "object",
+      "required": ["key", "label", "visual", "order", "enabled"],
+      "properties": {
+        "key": { "$ref": "#/$defs/reactionKey" },
+        "label": {
+          "allOf": [{ "$ref": "#/$defs/plainLabel" }],
+          "type": "string",
+          "x-gala-graphemeLength": { "minimum": 1, "maximum": 32 }
+        },
+        "visual": { "$ref": "#/$defs/reactionVisual" },
+        "order": { "type": "integer", "minimum": 1, "maximum": 16 },
+        "enabled": { "type": "boolean" }
+      },
+      "additionalProperties": false
+    },
+    "interactionsServiceOrigin": {
+      "type": "string",
+      "maxLength": 255,
+      "pattern": "^(?:https://[^/?#@\\s]+|http://(?:localhost|127\\.0\\.0\\.1)(?::[0-9]{1,5})?)$",
+      "description": "Credential-free service origin with no path, query or fragment: HTTPS, or http on localhost or 127.0.0.1 for the local runtime profile."
     },
     "authoredAdapterIdentity": {
       "type": "object",

package/schemas/build-provenance.schema.json

@@ -627,7 +627,7 @@
         "routeClass": { "enum": ["html", "feed", "sitemap", "asset", "error"] },
         "stableContentId": { "$ref": "#/$defs/stableId" },
         "sourceRevision": { "$ref": "#/$defs/gitObjectId" },
-        "interactionBearing": { "const": false }
+        "interactionBearing": { "type": "boolean" }
       },
       "additionalProperties": false
     },

package/schemas/interactions-config.schema.json

@@ -0,0 +1,222 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:gala:schema:interactions-config:2.0.0",
+  "title": "Gala interactions-config contract",
+  "type": "object",
+  "required": [
+    "schemaId",
+    "schemaVersion",
+    "reactions",
+    "comments",
+    "publicCounts"
+  ],
+  "properties": {
+    "schemaId": { "const": "urn:gala:schema:interactions-config:2.0.0" },
+    "schemaVersion": { "const": "2.0.0" },
+    "reactions": {
+      "type": "object",
+      "required": ["enabled", "definitions"],
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "definitions": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/reactionDefinition" },
+          "minItems": 0,
+          "maxItems": 16
+        }
+      },
+      "additionalProperties": false
+    },
+    "comments": {
+      "type": "object",
+      "required": ["enabled", "allowReplies", "maxDepth"],
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "allowReplies": { "type": "boolean" },
+        "maxDepth": { "type": "integer", "minimum": 1, "maximum": 4 }
+      },
+      "additionalProperties": false
+    },
+    "publicCounts": {
+      "type": "object",
+      "required": ["reactions", "comments"],
+      "properties": {
+        "reactions": { "type": "boolean" },
+        "comments": { "type": "boolean" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "stableId": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+      "description": "Lowercase canonical UUIDv7. Once published, it is immutable; its time ordering conveys neither chronology nor authority."
+    },
+    "slug": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 80,
+      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+    },
+    "repoRelativePath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512,
+      "pattern": "^(?!/)(?!.*\\\\)(?!.*\\u0000).+$",
+      "format": "gala-repository-relative-path",
+      "x-gala-utf8ByteLength": { "maximum": 512 },
+      "description": "NFC UTF-8 repository-relative path using slash separators, with no leading slash, dot segment, NUL, backslash, or percent-decoded traversal."
+    },
+    "canonicalRoute": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^/(?!/)(?!.*//)(?!.*[?#]).*$",
+      "format": "gala-canonical-route",
+      "description": "Absolute normalized route with no query, fragment, dot segment, double slash, or non-normalized percent encoding."
+    },
+    "gitObjectId": {
+      "type": "string",
+      "pattern": "^(?:sha1:[0-9a-f]{40}|sha256:[0-9a-f]{64})$"
+    },
+    "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "urlHttps": {
+      "type": "string",
+      "format": "uri",
+      "pattern": "^https://(?![^/?#]*@)",
+      "description": "Absolute HTTPS URL without embedded credentials."
+    },
+    "bcp47": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 255,
+      "pattern": "^[A-Za-z0-9-]+$",
+      "format": "gala-bcp47",
+      "x-gala-utf8ByteLength": { "minimum": 1, "maximum": 255 },
+      "description": "Structurally valid canonical BCP-47 language tag."
+    },
+    "isoCountry": {
+      "type": "string",
+      "pattern": "^[A-Z]{2}$",
+      "format": "gala-iso-country",
+      "description": "ISO 3166-1 alpha-2 country code; admission remains subject to the active policy profile."
+    },
+    "plainLabel": {
+      "type": "string",
+      "format": "gala-plain-label",
+      "x-gala-graphemeLength": { "minimum": 1, "maximum": 80 },
+      "description": "Normalized Unicode plain text without markup, controls, or bidi overrides."
+    },
+    "plainText": {
+      "type": "string",
+      "format": "gala-plain-text",
+      "description": "NFC Unicode text without disallowed C0/C1 controls or bidi override/isolate controls."
+    },
+    "rfc3339": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^[0-9]{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])T(?:[01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]\\.[0-9]{3}Z$",
+      "description": "Canonical Gala UTC millisecond subset of RFC 3339."
+    },
+    "semver": {
+      "type": "string",
+      "pattern": "^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*)?$",
+      "description": "Canonical SemVer 2.0.0 without build metadata."
+    },
+    "semverRange": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^(?:\\S+|\\S+ \\S+)$",
+      "format": "gala-semver-range",
+      "description": "Whitespace-free npm-compatible exact, caret, or bounded comparator-set range; tags and URLs are invalid."
+    },
+    "packageRange": {
+      "type": "string",
+      "minLength": 3,
+      "pattern": "^(?:@[a-z0-9](?:[a-z0-9._-]*[a-z0-9])?/[a-z0-9](?:[a-z0-9._-]*[a-z0-9])?|[a-z0-9](?:[a-z0-9._-]*[a-z0-9])?)@(?:\\S+|\\S+ \\S+)$",
+      "format": "gala-package-range",
+      "description": "Lowercase npm package identity and admitted semver range; Git, file, URL, and alias sources are invalid."
+    },
+    "packageExact": {
+      "type": "string",
+      "minLength": 3,
+      "pattern": "^(?:@[a-z0-9](?:[a-z0-9._-]*[a-z0-9])?/[a-z0-9](?:[a-z0-9._-]*[a-z0-9])?|[a-z0-9](?:[a-z0-9._-]*[a-z0-9])?)@\\S+$",
+      "format": "gala-package-exact",
+      "description": "Lowercase npm package identity and exact canonical semantic version; aliases are invalid."
+    },
+    "urn": {
+      "type": "string",
+      "minLength": 10,
+      "maxLength": 255,
+      "format": "uri",
+      "pattern": "^urn:gala:[\\x21-\\x7E]+$",
+      "description": "Absolute ASCII URN in the schema-declared Gala namespace."
+    },
+    "glob": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256,
+      "format": "gala-repository-glob",
+      "x-gala-utf8ByteLength": { "maximum": 256 },
+      "description": "Repository-relative POSIX glob using only star, globstar, and question-mark operators; braces, extglobs, negation, absolute paths, and parent traversal are invalid."
+    },
+    "passiveVisualToken": false,
+    "extensionKey": {
+      "type": "string",
+      "format": "gala-extension-key",
+      "description": "Reverse-DNS extension namespace that cannot shadow a core key."
+    },
+    "reactionKey": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]{1,31}$",
+      "not": { "const": "like" },
+      "description": "Stable reaction key. \"like\" is reserved: Like is implicit whenever reactions are enabled."
+    },
+    "reactionVisual": {
+      "type": "object",
+      "required": ["kind", "token"],
+      "properties": {
+        "kind": { "const": "emoji" },
+        "token": {
+          "enum": [
+            "👍",
+            "❤️",
+            "💡",
+            "🎉",
+            "😂",
+            "🤯",
+            "🙏",
+            "🔥",
+            "👏",
+            "😮",
+            "😢",
+            "🤔",
+            "✨",
+            "🚀",
+            "💯",
+            "👀"
+          ]
+        }
+      },
+      "additionalProperties": false
+    },
+    "reactionDefinition": {
+      "type": "object",
+      "required": ["key", "label", "visual", "order", "enabled"],
+      "properties": {
+        "key": { "$ref": "#/$defs/reactionKey" },
+        "label": {
+          "allOf": [{ "$ref": "#/$defs/plainLabel" }],
+          "type": "string",
+          "x-gala-graphemeLength": { "minimum": 1, "maximum": 32 }
+        },
+        "visual": { "$ref": "#/$defs/reactionVisual" },
+        "order": { "type": "integer", "minimum": 1, "maximum": 16 },
+        "enabled": { "type": "boolean" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$comment": "JSON Schema cannot express two rules; consumers enforce them: reaction keys are unique within definitions, and reaction orders are unique within definitions."
+}

package/schemas/publication.schema.json

@@ -47,6 +47,8 @@
     "defaultImageRef": { "$ref": "#/$defs/repoRelativePath" },
     "profile": { "$ref": "#/$defs/publicationProfile" },
     "footerCard": { "$ref": "#/$defs/footerCard" },
+    "newsletter": { "$ref": "#/$defs/newsletter" },
+    "crawlers": { "$ref": "#/$defs/crawlers" },
     "extensions": { "$ref": "#/$defs/extensionMap" }
   },
   "additionalProperties": false,
@@ -237,6 +239,25 @@
       },
       "additionalProperties": false
     },
+    "newsletter": {
+      "type": "object",
+      "required": ["url", "title", "text"],
+      "properties": {
+        "url": { "$ref": "#/$defs/urlHttps" },
+        "title": { "$ref": "#/$defs/plainLabel" },
+        "text": {
+          "$ref": "#/$defs/plainText",
+          "x-gala-graphemeLength": { "minimum": 1, "maximum": 300 }
+        }
+      },
+      "additionalProperties": false
+    },
+    "crawlers": {
+      "type": "object",
+      "required": ["ai"],
+      "properties": { "ai": { "enum": ["allow", "block"] } },
+      "additionalProperties": false
+    },
     "extensionMap": {
       "type": "object",
       "maxProperties": 32,