@rathnasgala2/schemas 2.15.0 → 2.17.0

package/README.md

@@ -91,6 +91,62 @@ calls `postMembershipInvitationsByTokenAccept`; its non-enumerating failure
 states collapse onto that operation's single declared `INVALID_SOURCE_STATE`
 problem, which covers an expired, already-used or unknown token alike.
 
+SCHEMA-2.17.0 (design `scrap/20260928_write-preview-publish.md` section 9) is
+media in articles: a cover image, and images, sound and video referenced from an
+article's body, both pass-through -- copied unchanged into the built site, no
+resizing and no derived formats for in-text media (the cover image still goes
+through the renderer's existing, unrelated resizing pipeline).
+`build-input.schema.json`'s `contentBuildRecord` gains an optional `media` array
+(new `$defs` entry `contentBuildMediaFile`: `path`, `sourceDigest`, `mediaType`,
+`byteLength`; up to 200 entries) of files the article body refers to;
+`mediaType` is a closed image/audio/video list (SVG stays refused, an SVG can
+carry script) and `byteLength` is bounded per category (image 5 MiB, audio 20
+MiB, video 50 MiB) via an `allOf`/`if`/`then` chain keyed on an explicit `enum`
+per category rather than a `pattern`-matched prefix, since the fixture generator
+cannot synthesize an unconstrained `pattern` string.
+`artifact-manifest.schema.json`'s `manifestAsset`/`manifestRoute` (and the
+byte-identical `build-provenance.schema.json` copy, sharing one JS-source
+`MANIFEST_MEDIA_TYPES` constant) admit the same seven added types for the site's
+own built assets. On the OpenAPI side, `content-changes:plan`'s
+`ContentChangeAssetEntry` admits the same eleven types (still no SVG) with a
+per-category `bytesBase64` bound; `assets` grows from 20 to 40 items and 20 MiB
+to 100 MiB per change, documents unchanged (20, 1 MiB each).
+`GET .../content/assets` serves eleven types, growing from the five it served
+before (the `200` response's declared content-type list stays at the published
+twelve, `image/svg+xml` included, since removing an already-shipped value is not
+additive; no server version has ever answered with it -- a stored SVG is refused
+with the declared `422` on read exactly as on write, since it can carry script
+and this operation answers `Content-Disposition: inline` from the application's
+own origin). The new `206` response's content-type list is the eleven
+actually-served types, SVG correctly absent. The operation now declares
+`Accept-Ranges: bytes` and honours a single-range `Range` request header for
+sound and video: `206` with `Content-Range` for a satisfiable range, the new
+`416` (`VALIDATION_FAILED`) with `Content-Range: bytes */<total>` for an
+unsatisfiable one -- both fit the existing generator machinery with no
+special-casing, so no prose-only fallback was needed here. New shared OpenAPI
+components: headers `AcceptRanges`/`ContentRange`, parameter `Range`.
+
+SCHEMA-2.16.0 corrects a fault SCHEMA-2.14.0 introduced:
+`POST .../repository-changes/{changeId}:bring-up-to-date`'s
+`x-gala-state-guards` admitted only `REQUESTED|PLANNED|AWAITING_CONFIRMATION`,
+and its `409` wording said an already-committed change was refused -- which
+defeated the operation's purpose, since a person's saved change IS committed (it
+carries a `proposedRevision`, and it was reviewed and approved) and it is
+exactly that change a publish refuses `SOURCE_OUT_OF_DATE`. The guard now also
+admits `COMMITTED`:
+`RepositoryChange:REQUESTED|PLANNED|AWAITING_CONFIRMATION|COMMITTED -> PLANNED (new change)`.
+Not admitted, and now stated as such: a change with a commit in flight
+(`COMMIT_REQUESTED`/`COMMITTING`/`UNKNOWN_RECONCILING`), one that already failed
+or was cancelled (`FAILED_NO_CHANGE`/`CANCELLED`), or one already published. Two
+smaller additions travel in the same release: `GET .../repository/setup`
+declares `503 CAPABILITY_UNAVAILABLE`/`DEPENDENCY_UNAVAILABLE` exactly as
+`POST .../repository:set-up` already does, since both depend on the same
+configured GitHub App identity; and repository creation's operation description
+now states that with `startFrom: USER_TEMPLATE` an unreachable
+`rathnasgala2/user-template` GitHub template is the existing
+`503 DEPENDENCY_UNAVAILABLE` this operation has declared since 2.13.0 (no new
+status was needed).
+
 SCHEMA-2.15.0 closes a Content-list gap SCHEMA-2.14.0 left: with `kind` the only
 fact the inventory carried about a flat file, a row could not show title, kind,
 status or last-changed, and a client could not check web-address uniqueness,

package/THIRD_PARTY_LICENSES.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "package": "@rathnasgala2/schemas@2.15.0",
+  "package": "@rathnasgala2/schemas@2.17.0",
   "source": "package-lock.json",
   "dependencies": [
     {

package/diagnostics/diagnostic-map.json

@@ -5936,6 +5936,60 @@
     "build-input:#/$defs/colorMode:type": {
       "code": "SCHEMA_TYPE_INVALID"
     },
+    "build-input:#/$defs/contentBuildMediaFile/allOf/0/if/properties/mediaType:enum": {
+      "code": "SCHEMA_ENUM_INVALID"
+    },
+    "build-input:#/$defs/contentBuildMediaFile/allOf/0/if:required:mediaType": {
+      "code": "SCHEMA_REQUIRED_FIELD_MISSING"
+    },
+    "build-input:#/$defs/contentBuildMediaFile/allOf/0/then/properties/byteLength:maximum": {
+      "code": "SCHEMA_NUMBER_TOO_LARGE"
+    },
+    "build-input:#/$defs/contentBuildMediaFile/allOf/1/if/properties/mediaType:enum": {
+      "code": "SCHEMA_ENUM_INVALID"
+    },
+    "build-input:#/$defs/contentBuildMediaFile/allOf/1/if:required:mediaType": {
+      "code": "SCHEMA_REQUIRED_FIELD_MISSING"
+    },
+    "build-input:#/$defs/contentBuildMediaFile/allOf/1/then/properties/byteLength:maximum": {
+      "code": "SCHEMA_NUMBER_TOO_LARGE"
+    },
+    "build-input:#/$defs/contentBuildMediaFile/allOf/2/if/properties/mediaType:enum": {
+      "code": "SCHEMA_ENUM_INVALID"
+    },
+    "build-input:#/$defs/contentBuildMediaFile/allOf/2/if:required:mediaType": {
+      "code": "SCHEMA_REQUIRED_FIELD_MISSING"
+    },
+    "build-input:#/$defs/contentBuildMediaFile/allOf/2/then/properties/byteLength:maximum": {
+      "code": "SCHEMA_NUMBER_TOO_LARGE"
+    },
+    "build-input:#/$defs/contentBuildMediaFile/properties/byteLength:minimum": {
+      "code": "SCHEMA_NUMBER_TOO_SMALL"
+    },
+    "build-input:#/$defs/contentBuildMediaFile/properties/byteLength:type": {
+      "code": "SCHEMA_TYPE_INVALID"
+    },
+    "build-input:#/$defs/contentBuildMediaFile/properties/mediaType:enum": {
+      "code": "SCHEMA_ENUM_INVALID"
+    },
+    "build-input:#/$defs/contentBuildMediaFile:additionalProperties": {
+      "code": "REQUEST_FIELD_UNKNOWN"
+    },
+    "build-input:#/$defs/contentBuildMediaFile:required:byteLength": {
+      "code": "SCHEMA_REQUIRED_FIELD_MISSING"
+    },
+    "build-input:#/$defs/contentBuildMediaFile:required:mediaType": {
+      "code": "SCHEMA_REQUIRED_FIELD_MISSING"
+    },
+    "build-input:#/$defs/contentBuildMediaFile:required:path": {
+      "code": "SCHEMA_REQUIRED_FIELD_MISSING"
+    },
+    "build-input:#/$defs/contentBuildMediaFile:required:sourceDigest": {
+      "code": "SCHEMA_REQUIRED_FIELD_MISSING"
+    },
+    "build-input:#/$defs/contentBuildMediaFile:type": {
+      "code": "SCHEMA_TYPE_INVALID"
+    },
     "build-input:#/$defs/contentBuildRecord/properties/body:maxLength": {
       "code": "SCHEMA_STRING_TOO_LONG"
     },
@@ -5945,6 +5999,12 @@
     "build-input:#/$defs/contentBuildRecord/properties/bodyMediaType:const": {
       "code": "SCHEMA_CONSTANT_INVALID"
     },
+    "build-input:#/$defs/contentBuildRecord/properties/media:maxItems": {
+      "code": "SCHEMA_ARRAY_TOO_LONG"
+    },
+    "build-input:#/$defs/contentBuildRecord/properties/media:type": {
+      "code": "SCHEMA_TYPE_INVALID"
+    },
     "build-input:#/$defs/contentBuildRecord/properties/resolvedAuthorIds:maxItems": {
       "code": "SCHEMA_ARRAY_TOO_LONG"
     },
@@ -25338,6 +25398,7 @@
     "build-input:#/$defs/authorNormalized/properties/localized:minItems": "ZERO_LOWER_BOUND_REJECTS_NO_INSTANCE",
     "build-input:#/$defs/buildPackages/properties/dependencies:minItems": "ZERO_LOWER_BOUND_REJECTS_NO_INSTANCE",
     "build-input:#/$defs/contentBuildRecord/properties/body:minLength": "ZERO_LOWER_BOUND_REJECTS_NO_INSTANCE",
+    "build-input:#/$defs/contentBuildRecord/properties/media:minItems": "ZERO_LOWER_BOUND_REJECTS_NO_INSTANCE",
     "build-input:#/$defs/contentFrontmatterNormalized/properties/redirects:minItems": "ZERO_LOWER_BOUND_REJECTS_NO_INSTANCE",
     "build-input:#/$defs/contentFrontmatterNormalized/properties/tags:minItems": "ZERO_LOWER_BOUND_REJECTS_NO_INSTANCE",
     "build-input:#/$defs/githubPositiveDecimal:format": "FORMAT_REDUNDANT_WITH_SIBLING_RULES",

package/docs/catalogs/schema-inventory.json

@@ -29,7 +29,7 @@
       "version": "2.0.0",
       "path": "schemas/artifact-manifest.schema.json",
       "materialized": true,
-      "sourceDigest": "sha256:722ea75b9820ecadb5ee907e4c92fd560f9d1b298cab2824cbbcfa6fcf10b652",
+      "sourceDigest": "sha256:ee2107c4ae162bc975ceac5e3c543a77ca57aa50892a037fc55a9878a57785cf",
       "typescriptRootType": "ArtifactManifestDocument"
     },
     {
@@ -49,7 +49,7 @@
       "version": "2.0.0",
       "path": "schemas/build-input.schema.json",
       "materialized": true,
-      "sourceDigest": "sha256:0828f9658b0515f9608ca7b2482089eb4e411380002001cd87eeeaed21cf21bb",
+      "sourceDigest": "sha256:342260092fc16bdd6ba6b38490fbdaeca6817212fe51f8082b464b70d01469d0",
       "typescriptRootType": "BuildInputDocument"
     },
     {
@@ -59,7 +59,7 @@
       "version": "2.0.0",
       "path": "schemas/build-provenance.schema.json",
       "materialized": true,
-      "sourceDigest": "sha256:f2442cda1645ec30d2ef07616ef6815f5227d513405d6161247c6a27123e12f9",
+      "sourceDigest": "sha256:d97d133c083770f75f91356bcc084a0f1df33c0d8ff3e60bc2799204d2ae9958",
       "typescriptRootType": "BuildProvenanceDocument"
     },
     {
@@ -209,9 +209,9 @@
       "version": "2.0.0",
       "path": "openapi/openapi.yaml",
       "materialized": true,
-      "sourceDigest": "sha256:ca5cf80a6fc7b91e4a029d9962efc0da84b31a267b0e1a7bbaaba731d426dffc",
+      "sourceDigest": "sha256:4fc11abc34a1de9a64eb669ed414ca4d508e5672aad79ecb6e1a88454627617b",
       "typescriptRootType": null
     }
   ],
-  "digest": "sha256:fe8e29466fbeaafd38b28e6d09f94a4f9e05045aaa4af954431d5b493a13ba14"
+  "digest": "sha256:74a4b8f2a34024211a4a63d8e7f853082a6045990c86cadd9fd539aeb74495df"
 }

package/examples/valid/build-input/rules.json

@@ -165,6 +165,26 @@
     "keyword": "x-gala-graphemeLength",
     "instance": "fixture-1"
   },
+  {
+    "caseId": "build-input-valid-0564bdcec3af2163",
+    "coveredRuleIds": [
+      "build-input:#/$defs/contentBuildMediaFile:additionalProperties",
+      "build-input:#/$defs/contentBuildMediaFile:required:byteLength",
+      "build-input:#/$defs/contentBuildMediaFile:required:mediaType",
+      "build-input:#/$defs/contentBuildMediaFile:required:path",
+      "build-input:#/$defs/contentBuildMediaFile:required:sourceDigest",
+      "build-input:#/$defs/contentBuildMediaFile:type"
+    ],
+    "schemaId": "urn:gala:schema:build-input:2.0.0",
+    "schemaPointer": "#/$defs/contentBuildMediaFile",
+    "keyword": "additionalProperties",
+    "instance": {
+      "path": "content/fixture-1.md",
+      "sourceDigest": "sha256:0000000000000000000000000000000000000000000000000000000000000001",
+      "mediaType": "image/png",
+      "byteLength": 1
+    }
+  },
   {
     "caseId": "build-input-valid-0627e3b3d58715e9",
     "coveredRuleIds": [
@@ -401,6 +421,16 @@
       "route": "/fixture-1"
     }
   },
+  {
+    "caseId": "build-input-valid-1fa6418fdd9f1220",
+    "coveredRuleIds": [
+      "build-input:#/$defs/contentBuildMediaFile/allOf/2/if:required:mediaType"
+    ],
+    "schemaId": "urn:gala:schema:build-input:2.0.0",
+    "schemaPointer": "#/$defs/contentBuildMediaFile/allOf/2/if",
+    "keyword": "required",
+    "instance": { "mediaType": "video/mp4" }
+  },
   {
     "caseId": "build-input-valid-211314c13a883385",
     "coveredRuleIds": [
@@ -899,6 +929,26 @@
     "keyword": "const",
     "instance": "built-in-default"
   },
+  {
+    "caseId": "build-input-valid-3e704a85aded3da0",
+    "coveredRuleIds": [
+      "build-input:#/$defs/contentBuildMediaFile/allOf/1/then/properties/byteLength:maximum"
+    ],
+    "schemaId": "urn:gala:schema:build-input:2.0.0",
+    "schemaPointer": "#/$defs/contentBuildMediaFile/allOf/1/then/properties/byteLength",
+    "keyword": "maximum",
+    "instance": null
+  },
+  {
+    "caseId": "build-input-valid-401ec826e25c2929",
+    "coveredRuleIds": [
+      "build-input:#/$defs/contentBuildMediaFile/allOf/0/then/properties/byteLength:maximum"
+    ],
+    "schemaId": "urn:gala:schema:build-input:2.0.0",
+    "schemaPointer": "#/$defs/contentBuildMediaFile/allOf/0/then/properties/byteLength",
+    "keyword": "maximum",
+    "instance": null
+  },
   {
     "caseId": "build-input-valid-42ef9522a838bfc9",
     "coveredRuleIds": [
@@ -1091,6 +1141,16 @@
     "keyword": "required",
     "instance": { "role": "decorative" }
   },
+  {
+    "caseId": "build-input-valid-51cfe2c3b839fec4",
+    "coveredRuleIds": [
+      "build-input:#/$defs/contentBuildMediaFile/allOf/2/if/properties/mediaType:enum"
+    ],
+    "schemaId": "urn:gala:schema:build-input:2.0.0",
+    "schemaPointer": "#/$defs/contentBuildMediaFile/allOf/2/if/properties/mediaType",
+    "keyword": "enum",
+    "instance": "video/mp4"
+  },
   {
     "caseId": "build-input-valid-51d5cb18a8eca75c",
     "coveredRuleIds": [
@@ -1197,6 +1257,25 @@
     "keyword": "format",
     "instance": "https://fixture-1.example.com/"
   },
+  {
+    "caseId": "build-input-valid-6754ffca58bd6b51",
+    "coveredRuleIds": [
+      "build-input:#/$defs/contentBuildRecord/properties/media:maxItems",
+      "build-input:#/$defs/contentBuildRecord/properties/media:minItems",
+      "build-input:#/$defs/contentBuildRecord/properties/media:type"
+    ],
+    "schemaId": "urn:gala:schema:build-input:2.0.0",
+    "schemaPointer": "#/$defs/contentBuildRecord/properties/media",
+    "keyword": "maxItems",
+    "instance": [
+      {
+        "path": "content/fixture-1.md",
+        "sourceDigest": "sha256:0000000000000000000000000000000000000000000000000000000000000001",
+        "mediaType": "image/png",
+        "byteLength": 1
+      }
+    ]
+  },
   {
     "caseId": "build-input-valid-6c8df9dafddc200f",
     "coveredRuleIds": [
@@ -1247,6 +1326,17 @@
     "keyword": "x-gala-graphemeLength",
     "instance": "fixture-1"
   },
+  {
+    "caseId": "build-input-valid-74061890596a952b",
+    "coveredRuleIds": [
+      "build-input:#/$defs/contentBuildMediaFile/properties/byteLength:minimum",
+      "build-input:#/$defs/contentBuildMediaFile/properties/byteLength:type"
+    ],
+    "schemaId": "urn:gala:schema:build-input:2.0.0",
+    "schemaPointer": "#/$defs/contentBuildMediaFile/properties/byteLength",
+    "keyword": "minimum",
+    "instance": 1
+  },
   {
     "caseId": "build-input-valid-76d6127794f5dd48",
     "coveredRuleIds": [
@@ -1551,6 +1641,16 @@
       }
     ]
   },
+  {
+    "caseId": "build-input-valid-a24d533edaddedce",
+    "coveredRuleIds": [
+      "build-input:#/$defs/contentBuildMediaFile/allOf/0/if/properties/mediaType:enum"
+    ],
+    "schemaId": "urn:gala:schema:build-input:2.0.0",
+    "schemaPointer": "#/$defs/contentBuildMediaFile/allOf/0/if/properties/mediaType",
+    "keyword": "enum",
+    "instance": "image/png"
+  },
   {
     "caseId": "build-input-valid-a43bb1115a995f34",
     "coveredRuleIds": [
@@ -1615,6 +1715,16 @@
     "keyword": "additionalProperties",
     "instance": {}
   },
+  {
+    "caseId": "build-input-valid-b0422e3810892dbd",
+    "coveredRuleIds": [
+      "build-input:#/$defs/contentBuildMediaFile/properties/mediaType:enum"
+    ],
+    "schemaId": "urn:gala:schema:build-input:2.0.0",
+    "schemaPointer": "#/$defs/contentBuildMediaFile/properties/mediaType",
+    "keyword": "enum",
+    "instance": "image/png"
+  },
   {
     "caseId": "build-input-valid-b24bbede1ab69bed",
     "coveredRuleIds": [
@@ -1692,6 +1802,16 @@
     "keyword": "x-gala-graphemeLength",
     "instance": "fixture-1"
   },
+  {
+    "caseId": "build-input-valid-c0f1727a1a5b82d4",
+    "coveredRuleIds": [
+      "build-input:#/$defs/contentBuildMediaFile/allOf/1/if/properties/mediaType:enum"
+    ],
+    "schemaId": "urn:gala:schema:build-input:2.0.0",
+    "schemaPointer": "#/$defs/contentBuildMediaFile/allOf/1/if/properties/mediaType",
+    "keyword": "enum",
+    "instance": "audio/mpeg"
+  },
   {
     "caseId": "build-input-valid-c2495f1262345ef0",
     "coveredRuleIds": [
@@ -1738,6 +1858,16 @@
     "keyword": "maxItems",
     "instance": ["/fixture-1"]
   },
+  {
+    "caseId": "build-input-valid-ce84ac8883526107",
+    "coveredRuleIds": [
+      "build-input:#/$defs/contentBuildMediaFile/allOf/1/if:required:mediaType"
+    ],
+    "schemaId": "urn:gala:schema:build-input:2.0.0",
+    "schemaPointer": "#/$defs/contentBuildMediaFile/allOf/1/if",
+    "keyword": "required",
+    "instance": { "mediaType": "audio/mpeg" }
+  },
   {
     "caseId": "build-input-valid-d3f6cc6ab7220249",
     "coveredRuleIds": ["build-input:#/$defs/normalizedSource:oneOf"],
@@ -2000,6 +2130,16 @@
     "keyword": "enum",
     "instance": "website"
   },
+  {
+    "caseId": "build-input-valid-e91f7c18870f1e9b",
+    "coveredRuleIds": [
+      "build-input:#/$defs/contentBuildMediaFile/allOf/2/then/properties/byteLength:maximum"
+    ],
+    "schemaId": "urn:gala:schema:build-input:2.0.0",
+    "schemaPointer": "#/$defs/contentBuildMediaFile/allOf/2/then/properties/byteLength",
+    "keyword": "maximum",
+    "instance": null
+  },
   {
     "caseId": "build-input-valid-eb61a43d2b3f4bd2",
     "coveredRuleIds": [
@@ -2068,6 +2208,16 @@
       "sourceDigest": "sha256:0000000000000000000000000000000000000000000000000000000000000001"
     }
   },
+  {
+    "caseId": "build-input-valid-f45cf1e222c15591",
+    "coveredRuleIds": [
+      "build-input:#/$defs/contentBuildMediaFile/allOf/0/if:required:mediaType"
+    ],
+    "schemaId": "urn:gala:schema:build-input:2.0.0",
+    "schemaPointer": "#/$defs/contentBuildMediaFile/allOf/0/if",
+    "keyword": "required",
+    "instance": { "mediaType": "image/png" }
+  },
   {
     "caseId": "build-input-valid-f60d3692dc6e9132",
     "coveredRuleIds": [