@rathnasgala2/schemas 3.25.1 → 3.27.0

package/sbom.cdx.json

@@ -97,8 +97,8 @@
       "type": "library",
       "name": "schemas",
       "group": "@rathnasgala2",
-      "version": "3.25.1",
-      "bom-ref": "@rathnasgala2/schemas@3.25.1",
+      "version": "3.27.0",
+      "bom-ref": "@rathnasgala2/schemas@3.27.0",
       "description": "Executable JSON Schema and OpenAPI contracts for Galascribe",
       "licenses": [
         {
@@ -108,7 +108,7 @@
           }
         }
       ],
-      "purl": "pkg:npm/%40rathnasgala2/schemas@3.25.1?vcs_url=git%2Bhttps%3A%2F%2Fgithub.com%2Frathnasgala2%2Fschema.git",
+      "purl": "pkg:npm/%40rathnasgala2/schemas@3.27.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@3.25.1|ajv-formats@3.0.1",
+      "bom-ref": "@rathnasgala2/schemas@3.27.0|ajv-formats@3.0.1",
       "licenses": [
         {
           "license": {
@@ -187,7 +187,7 @@
       "type": "library",
       "name": "ajv",
       "version": "8.20.0",
-      "bom-ref": "@rathnasgala2/schemas@3.25.1|ajv@8.20.0",
+      "bom-ref": "@rathnasgala2/schemas@3.27.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@3.25.1|fast-deep-equal@3.1.3",
+      "bom-ref": "@rathnasgala2/schemas@3.27.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@3.25.1|fast-uri@3.1.8",
+      "bom-ref": "@rathnasgala2/schemas@3.27.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@3.25.1|json-schema-traverse@1.0.0",
+      "bom-ref": "@rathnasgala2/schemas@3.27.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@3.25.1|require-from-string@2.0.2",
+      "bom-ref": "@rathnasgala2/schemas@3.27.0|require-from-string@2.0.2",
       "licenses": [
         {
           "license": {
@@ -1064,10 +1064,10 @@
   ],
   "dependencies": [
     {
-      "ref": "@rathnasgala2/schemas@3.25.1",
+      "ref": "@rathnasgala2/schemas@3.27.0",
       "dependsOn": [
-        "@rathnasgala2/schemas@3.25.1|ajv-formats@3.0.1",
-        "@rathnasgala2/schemas@3.25.1|ajv@8.20.0",
+        "@rathnasgala2/schemas@3.27.0|ajv-formats@3.0.1",
+        "@rathnasgala2/schemas@3.27.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@3.25.1|ajv-formats@3.0.1",
+      "ref": "@rathnasgala2/schemas@3.27.0|ajv-formats@3.0.1",
       "dependsOn": [
-        "@rathnasgala2/schemas@3.25.1|ajv@8.20.0"
+        "@rathnasgala2/schemas@3.27.0|ajv@8.20.0"
       ]
     },
     {
-      "ref": "@rathnasgala2/schemas@3.25.1|ajv@8.20.0",
+      "ref": "@rathnasgala2/schemas@3.27.0|ajv@8.20.0",
       "dependsOn": [
-        "@rathnasgala2/schemas@3.25.1|fast-deep-equal@3.1.3",
-        "@rathnasgala2/schemas@3.25.1|fast-uri@3.1.8",
-        "@rathnasgala2/schemas@3.25.1|json-schema-traverse@1.0.0",
-        "@rathnasgala2/schemas@3.25.1|require-from-string@2.0.2"
+        "@rathnasgala2/schemas@3.27.0|fast-deep-equal@3.1.3",
+        "@rathnasgala2/schemas@3.27.0|fast-uri@3.1.8",
+        "@rathnasgala2/schemas@3.27.0|json-schema-traverse@1.0.0",
+        "@rathnasgala2/schemas@3.27.0|require-from-string@2.0.2"
       ]
     },
     {
-      "ref": "@rathnasgala2/schemas@3.25.1|fast-deep-equal@3.1.3"
+      "ref": "@rathnasgala2/schemas@3.27.0|fast-deep-equal@3.1.3"
     },
     {
-      "ref": "@rathnasgala2/schemas@3.25.1|fast-uri@3.1.8"
+      "ref": "@rathnasgala2/schemas@3.27.0|fast-uri@3.1.8"
     },
     {
-      "ref": "@rathnasgala2/schemas@3.25.1|json-schema-traverse@1.0.0"
+      "ref": "@rathnasgala2/schemas@3.27.0|json-schema-traverse@1.0.0"
     },
     {
-      "ref": "@rathnasgala2/schemas@3.25.1|require-from-string@2.0.2"
+      "ref": "@rathnasgala2/schemas@3.27.0|require-from-string@2.0.2"
     },
     {
       "ref": "pkg:npm/semver@7.8.5"

package/schemas/build-input.schema.json

@@ -520,6 +520,10 @@
         "newsletter": { "$ref": "#/$defs/newsletter" },
         "sharing": { "$ref": "#/$defs/sharing" },
         "contactForm": { "$ref": "#/$defs/contactFormNormalized" },
+        "listen": {
+          "$ref": "#/$defs/listen",
+          "description": "SCHEMA-3.26.0: the toolchain always writes this member, `enabled: false` when the site sets none; a build input without it is read as off, so every 3.25 build input still validates."
+        },
         "sourcePath": { "$ref": "#/$defs/repoRelativePath" },
         "sourceDigest": { "$ref": "#/$defs/digest" }
       },
@@ -658,6 +662,55 @@
       "additionalProperties": false,
       "description": "SCHEMA-3.22.0: the normalized contact form. `intro` is the rendered body of the optional `gala/theme-pages/contact.md`, absent when the file is absent (the template then shows its default intro). The template renders the `/contact/` page only when `enabled` is true."
     },
+    "listen": {
+      "type": "object",
+      "required": ["enabled"],
+      "properties": { "enabled": { "type": "boolean" } },
+      "additionalProperties": false,
+      "description": "SCHEMA-3.26.0: the site's Listen setting. `enabled: true` offers the audio version of the posts that have one: the template adds a Listen button to the top bar, a small invitation on each post with audio and a playlist on the home page, and ships its script only while at least one published article carries a `listen` member. An absent `listen` means off. The API, not the schema, limits turning it on to the Pro and Business plans."
+    },
+    "listenAudio": {
+      "type": "object",
+      "required": ["sourcePath", "mediaType", "bytes", "sha256"],
+      "properties": {
+        "sourcePath": {
+          "$ref": "#/$defs/repoRelativePath",
+          "pattern": "^.+\\.(?:mp3|m4a)$"
+        },
+        "mediaType": {
+          "enum": ["audio/mpeg", "audio/mp4"],
+          "description": "What the toolchain sniffed: `audio/mpeg` for an MP3 file, `audio/mp4` for an M4A file."
+        },
+        "bytes": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 26214400,
+          "description": "Size of the file in bytes, 1 to 26214400 (25 MiB), which must equal the size of the file in the source tree."
+        },
+        "sha256": { "$ref": "#/$defs/digest" }
+      },
+      "additionalProperties": false,
+      "description": "SCHEMA-3.26.0: one resolved audio file. `sha256` is the digest of the file bytes and must equal the file digest in the source tree; the file belongs to the source closure like any other asset."
+    },
+    "contentListenNormalized": {
+      "type": "object",
+      "required": ["audio", "durationSeconds", "format"],
+      "properties": {
+        "audio": { "$ref": "#/$defs/listenAudio" },
+        "durationSeconds": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 10800,
+          "description": "Length of the episode in whole seconds, 1 to 10800 (three hours)."
+        },
+        "format": {
+          "enum": ["conversation", "narration", "debate", "skit"],
+          "description": "What the episode is: `conversation` (two voices talking the post over), `narration` (one voice reading it), `debate` (two voices taking sides) or `skit` (a scripted scene). The template words its invitation by format."
+        }
+      },
+      "additionalProperties": false,
+      "description": "SCHEMA-3.26.0: the normalized audio version of an article. It appears only on a `kind: article` record and is absent when the article has none."
+    },
     "policyPageNormalized": {
       "type": "object",
       "required": ["title", "body"],
@@ -1021,7 +1074,8 @@
         "translationOf": {
           "$ref": "#/$defs/slug",
           "description": "SCHEMA-3.21.0: the slug of the article this document translates. The group is that article (the primary, in the publication's default language) plus every document naming it. The target must exist in the same content root, be `kind: article`, carry a different `language`, and must not itself carry `translationOf`; at most one document per language per group. A translation's default route is `/<language lowercased>/<primary slug>/` unless `route` is set. The API enforces the cross-document rules; the schema only fixes the shape: `translationOf` is allowed only when `kind` is `article` and never together with `edition`."
-        }
+        },
+        "listen": { "$ref": "#/$defs/contentListenNormalized" }
       },
       "additionalProperties": false,
       "dependentRequired": { "seriesOrder": ["series"] },
@@ -1041,6 +1095,13 @@
             "required": ["kind"],
             "not": { "required": ["edition"] }
           }
+        },
+        {
+          "if": { "required": ["listen"] },
+          "then": {
+            "properties": { "kind": { "const": "article" } },
+            "required": ["kind"]
+          }
         }
       ],
       "$comment": "Timestamp ordering, canonical set ordering, route derivation, and route/redirect collision rules are enforced semantically."

package/schemas/content-frontmatter.schema.json

@@ -71,6 +71,7 @@
       "$ref": "#/$defs/slug",
       "description": "SCHEMA-3.21.0: the slug of the article this document translates. The group is that article (the primary, in the publication's default language) plus every document naming it. The target must exist in the same content root, be `kind: article`, carry a different `language`, and must not itself carry `translationOf`; at most one document per language per group. A translation's default route is `/<language lowercased>/<primary slug>/` unless `route` is set. The API enforces the cross-document rules; the schema only fixes the shape: `translationOf` is allowed only when `kind` is `article` and never together with `edition`."
     },
+    "listen": { "$ref": "#/$defs/contentListen" },
     "extensions": { "$ref": "#/$defs/extensionMap" }
   },
   "additionalProperties": false,
@@ -228,6 +229,29 @@
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
       "description": "SCHEMA-3.25.0: the calendar date (`YYYY-MM-DD`, day precision, read in the publication's staggered-release timezone) on or after which Galascribe removes this article from the published site: it leaves every listing, feed, sitemap and search index and its route renders a removed-post notice. Same format as `publishAfter`; it must be later than `publishAfter` and `date` when both exist. The API enforces that rule; the schema only fixes the shape."
     },
+    "contentListen": {
+      "type": "object",
+      "required": ["audio", "durationSeconds", "format"],
+      "properties": {
+        "audio": {
+          "$ref": "#/$defs/repoRelativePath",
+          "pattern": "^.+\\.(?:mp3|m4a)$",
+          "description": "Repository-relative path of the audio file: an `.mp3` or `.m4a` file that sits under one of the repository `assetRoots`. The schema fixes the shape and the extension; the publish toolchain checks the asset root, that the file exists and is a regular file, that it sniffs as MP3 or M4A and the size limits."
+        },
+        "durationSeconds": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 10800,
+          "description": "Length of the episode in whole seconds, 1 to 10800 (three hours)."
+        },
+        "format": {
+          "enum": ["conversation", "narration", "debate", "skit"],
+          "description": "What the episode is: `conversation` (two voices talking the post over), `narration` (one voice reading it), `debate` (two voices taking sides) or `skit` (a scripted scene). The template words its invitation by format."
+        }
+      },
+      "additionalProperties": false,
+      "description": "SCHEMA-3.26.0: the audio version of this article. All three members are required. `listen` is allowed only when `kind` is `article`. It has an effect only while the publication has `listen.enabled` true."
+    },
     "contentEdition": {
       "type": "object",
       "required": ["of", "kind", "sourceDigest", "generation", "approvedAt"],
@@ -309,6 +333,13 @@
         "required": ["kind"],
         "not": { "required": ["edition"] }
       }
+    },
+    {
+      "if": { "required": ["listen"] },
+      "then": {
+        "properties": { "kind": { "const": "article" } },
+        "required": ["kind"]
+      }
     }
   ],
   "$comment": "The content validator enforces canonical set ordering, timestamp ordering, root-kind agreement, and route/redirect collision checks."

package/schemas/publication.schema.json

@@ -55,6 +55,7 @@
     "listing": { "$ref": "#/$defs/listing" },
     "aiRights": { "$ref": "#/$defs/aiRights" },
     "performance": { "$ref": "#/$defs/performance" },
+    "listen": { "$ref": "#/$defs/listen" },
     "extensions": { "$ref": "#/$defs/extensionMap" }
   },
   "additionalProperties": false,
@@ -399,6 +400,13 @@
       "additionalProperties": false,
       "description": "SCHEMA-3.25.0: size budgets in bytes, each at least 1024 and optional. `htmlBytes` bounds a page's HTML, `cssBytes` and `jsBytes` bound the sum of the same-origin stylesheets and scripts a page links. A page over budget is reported; a budget never fails a build."
     },
+    "listen": {
+      "type": "object",
+      "required": ["enabled"],
+      "properties": { "enabled": { "type": "boolean" } },
+      "additionalProperties": false,
+      "description": "SCHEMA-3.26.0: the site's Listen setting. `enabled: true` offers the audio version of the posts that have one: the template adds a Listen button to the top bar, a small invitation on each post with audio and a playlist on the home page, and ships its script only while at least one published article carries a `listen` member. An absent `listen` means off. The API, not the schema, limits turning it on to the Pro and Business plans."
+    },
     "extensionMap": {
       "type": "object",
       "maxProperties": 32,