@rathnasgala2/schemas 3.43.0 → 3.44.0

package/generated/typescript/contracts/build-input.d.ts

@@ -405,7 +405,7 @@ export type BuildInputPublicationNormalized = Readonly<{
     readonly route: BuildInputCanonicalRoute;
   }>;
   readonly recommendations?: ReadonlyArray<BuildInputRecommendation>;
-  readonly sharing?: BuildInputSharing;
+  readonly sharing?: BuildInputResolvedSharing;
   readonly slug: BuildInputSlug;
   readonly socialLinks: ReadonlyArray<BuildInputSocialLink>;
   readonly sourceDigest: BuildInputDigest;
@@ -481,6 +481,29 @@ export type BuildInputResolvedMedia = Readonly<{
 }> &
   unknown;
 
+export type BuildInputResolvedSharing = Readonly<{
+  readonly reddit?: Readonly<{
+    readonly community: string;
+  }>;
+  readonly targets: ReadonlyArray<
+    | 'copy-link'
+    | 'native'
+    | 'x'
+    | 'bluesky'
+    | 'threads'
+    | 'linkedin'
+    | 'facebook'
+    | 'hacker-news'
+    | 'whatsapp'
+    | 'telegram'
+    | 'reddit'
+    | 'email'
+  >;
+  readonly x?: Readonly<{
+    readonly via: string;
+  }>;
+}>;
+
 export type BuildInputRfc3339 = string;
 
 export type BuildInputSemanticTokens = Readonly<{
@@ -502,22 +525,6 @@ export type BuildInputSemver = string;
 
 export type BuildInputSemverRange = string;
 
-export type BuildInputSharing = Readonly<{
-  readonly targets: ReadonlyArray<
-    | 'copy-link'
-    | 'native'
-    | 'x'
-    | 'bluesky'
-    | 'linkedin'
-    | 'facebook'
-    | 'hacker-news'
-    | 'whatsapp'
-    | 'telegram'
-    | 'reddit'
-    | 'email'
-  >;
-}>;
-
 export type BuildInputSlug = string;
 
 export type BuildInputSocialLink = Readonly<{

package/generated/typescript/contracts/publication.d.ts

@@ -124,6 +124,7 @@ export type PublicationSharing = Readonly<{
     | 'native'
     | 'x'
     | 'bluesky'
+    | 'threads'
     | 'linkedin'
     | 'facebook'
     | 'hacker-news'

package/openapi/http-catalog.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "2.0.0",
   "sourceDesignRevision": "a53052955ceb6c1aa10c886289dc832eedfe6de0a00004df07d353ac19c4403a",
-  "openApiDigest": "sha256:c7f738c2ab658e466d32f46a37e25a105b7c68dcf38d8697d2b4c9d7c24762bb",
+  "openApiDigest": "sha256:7b04832e11d16fdb13a2d3a4318e2b135d06e8de42967b4a8392b707be852ee3",
   "operations": [
     {
       "operationId": "getInternalHealth",
@@ -3452,6 +3452,19 @@
       "apiKeyScope": null,
       "sourceFragment": "audience"
     },
+    {
+      "operationId": "getPublicSharing",
+      "method": "GET",
+      "path": "/v2/public/sharing",
+      "purpose": "read the platform sharing document",
+      "capabilityKey": null,
+      "conditionalCapabilityKeys": [],
+      "activationGate": "MVP",
+      "assuranceClass": "SESSION",
+      "actionGrant": "none",
+      "apiKeyScope": null,
+      "sourceFragment": "public-interactions"
+    },
     {
       "operationId": "getPublicToday",
       "method": "GET",
@@ -4220,5 +4233,5 @@
       "sourceFragment": "workloads"
     }
   ],
-  "digest": "sha256:b24e8862f60e9714e0d29d3d26d32aa01286878afde9add07949ba2cb2a49c88"
+  "digest": "sha256:c2666937dd218c493b22e40ca0ae5068e3c93749f0d0f6374ec1c58401bfb9a7"
 }

package/openapi/openapi.yaml

@@ -21,6 +21,13 @@ components:
           - private, no-cache
           - no-cache, private
         type: string
+    CacheControlPublicMaxAge300:
+      description: "SCHEMA-3.44.0: `public, max-age=300` -- a shared cache or browser may reuse the body for five minutes."
+      required: true
+      schema:
+        pattern: ^public, max-age=300$
+        type: string
+        x-gala-const: public, max-age=300
     ContentDispositionAttachment:
       description: "The archive is a download: `attachment` with its file name."
       required: true
@@ -5667,6 +5674,8 @@ components:
         - origin
         - publicBaseUrl
       type: object
+    GetPublicSharingResponse:
+      $ref: "#/components/schemas/PublicSharingDocument"
     GetPublicTodayResponse:
       $ref: "#/components/schemas/PublicTodayDrop"
     GetPublicTodayTopicsResponse:
@@ -17773,7 +17782,7 @@ components:
         maximum: 512
     PortablePublicationSharing:
       additionalProperties: false
-      description: "SCHEMA-3.22.0: the share buttons shown on each article. `targets` is the display order: 0 to 11 unique members of the closed target set. An absent `sharing` member means `[\"copy-link\"]` (the Copy link button only); an empty `targets` array means no share buttons. `native` is shown only where the browser offers the system share sheet; every other target is a plain link to that service's documented share URL. Bookmark is not a share target and is unaffected."
+      description: "SCHEMA-3.22.0: the share buttons shown on each article. `targets` is the display order: 0 to 12 unique members of the closed target set; an empty `targets` array means no share buttons. SCHEMA-3.44.0: an absent `sharing` member now means the platform's default share set, resolved at build time by the toolchain from `GET /v2/public/sharing` (it was the Copy link button only); a present `targets` is the site's own ordered list. `native` is shown only where the browser offers the system share sheet; every other target is a plain link to that service's documented share URL. Bookmark is not a share target and is unaffected."
       properties:
         targets:
           items:
@@ -17782,6 +17791,7 @@ components:
               - native
               - x
               - bluesky
+              - threads
               - linkedin
               - facebook
               - hacker-news
@@ -17789,7 +17799,7 @@ components:
               - telegram
               - reddit
               - email
-          maxItems: 11
+          maxItems: 12
           minItems: 0
           type: array
           uniqueItems: true
@@ -21482,6 +21492,73 @@ components:
         - count
         - viewerActive
       type: object
+    PublicSharingDocument:
+      additionalProperties: false
+      description: "SCHEMA-3.44.0: the platform sharing document. `networks` is the ordered catalogue of share targets the platform offers; `defaults` is the subset an undecided site shows (a site with no `sharing` member); `reddit.community` is the subreddit name without `r/` (empty means plain submit); `x.via` is the X handle without `@` appended as `via=` (empty means none)."
+      properties:
+        defaults:
+          items:
+            enum:
+              - copy-link
+              - native
+              - x
+              - bluesky
+              - threads
+              - linkedin
+              - facebook
+              - hacker-news
+              - reddit
+              - whatsapp
+              - telegram
+              - email
+            type: string
+          maxItems: 12
+          type: array
+          uniqueItems: true
+        networks:
+          items:
+            enum:
+              - copy-link
+              - native
+              - x
+              - bluesky
+              - threads
+              - linkedin
+              - facebook
+              - hacker-news
+              - reddit
+              - whatsapp
+              - telegram
+              - email
+            type: string
+          maxItems: 12
+          minItems: 1
+          type: array
+          uniqueItems: true
+        reddit:
+          additionalProperties: false
+          properties:
+            community:
+              pattern: ^[A-Za-z0-9_]{0,21}$
+              type: string
+          required:
+            - community
+          type: object
+        x:
+          additionalProperties: false
+          properties:
+            via:
+              pattern: ^[A-Za-z0-9_]{0,15}$
+              type: string
+          required:
+            - via
+          type: object
+      required:
+        - networks
+        - defaults
+        - reddit
+        - x
+      type: object
     PublicTodayDrop:
       additionalProperties: false
       description: "SCHEMA-3.43.0: the network-wide drop for one UTC day, the same for every visitor; no personal signal is used."
@@ -24147,6 +24224,7 @@ components:
         - native
         - x
         - bluesky
+        - threads
         - linkedin
         - facebook
         - hacker-news
@@ -24156,10 +24234,10 @@ components:
         - email
       type: string
     SharingTargets:
-      description: "SCHEMA-3.23.0: the ordered share buttons, 0 to 11 distinct targets. An empty list shows no share buttons."
+      description: "SCHEMA-3.23.0: the ordered share buttons, 0 to 12 distinct targets. An empty list shows no share buttons."
       items:
         $ref: "#/components/schemas/SharingTarget"
-      maxItems: 11
+      maxItems: 12
       type: array
       uniqueItems: true
     SiteActor:
@@ -82281,6 +82359,76 @@ paths:
         - NONE
       x-gala-success-category: async
       x-gala-tenant-scope: NONE
+  /v2/public/sharing:
+    get:
+      description: "The platform sharing document, with no authentication: the share targets the platform offers, the default set for a site that has not chosen its own, and the Reddit community and X handle used in share links. The toolchain reads it at build time. Answered with `Cache-Control: public, max-age=300`."
+      operationId: getPublicSharing
+      parameters:
+        - $ref: "#/components/parameters/XCorrelationId"
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                nominal:
+                  summary: Nominal successful response
+                  value:
+                    defaults:
+                      - copy-link
+                      - x
+                      - bluesky
+                      - threads
+                      - linkedin
+                      - facebook
+                      - hacker-news
+                      - reddit
+                      - whatsapp
+                      - telegram
+                      - email
+                    networks:
+                      - copy-link
+                      - native
+                      - x
+                      - bluesky
+                      - threads
+                      - linkedin
+                      - facebook
+                      - hacker-news
+                      - reddit
+                      - whatsapp
+                      - telegram
+                      - email
+                    reddit:
+                      community: Galascribe
+                    x:
+                      via: ""
+              schema:
+                $ref: "#/components/schemas/GetPublicSharingResponse"
+          description: read the platform sharing document succeeded
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlPublicMaxAge300"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+      security: []
+      summary: read the platform sharing document
+      tags:
+        - public-interactions
+      x-gala-activation-gate: MVP
+      x-gala-activation-guards:
+        - NONE
+      x-gala-capability-key: null
+      x-gala-concurrency: none
+      x-gala-conditional-capabilities: []
+      x-gala-example-profile: NOMINAL_SUCCESS_AND_EACH_REACHABLE_PROBLEM
+      x-gala-nullability: required-and-nullable-are-explicit
+      x-gala-purpose: read the platform sharing document
+      x-gala-reachable-problems: []
+      x-gala-replay-identity: safe-query
+      x-gala-state-guards:
+        - NONE
+      x-gala-success-category: query
+      x-gala-tenant-scope: NONE
   /v2/public/today:
     get:
       description: The network-wide drop for the current UTC day, identical for every visitor and computed once at the platform drop hour. `404 TODAY_NOT_PUBLIC` while Today is off or fewer eligible publications have posts in the window than the launch threshold.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rathnasgala2/schemas",
-  "version": "3.43.0",
+  "version": "3.44.0",
   "description": "Executable JSON Schema and OpenAPI contracts for Galascribe",
   "type": "module",
   "license": "Apache-2.0",

package/sbom.cdx.json

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

package/schemas/build-input.schema.json

@@ -545,7 +545,7 @@
         "aiRights": { "$ref": "#/$defs/aiRights" },
         "performance": { "$ref": "#/$defs/performance" },
         "newsletter": { "$ref": "#/$defs/newsletter" },
-        "sharing": { "$ref": "#/$defs/sharing" },
+        "sharing": { "$ref": "#/$defs/resolvedSharing" },
         "contactForm": { "$ref": "#/$defs/contactFormNormalized" },
         "listen": {
           "$ref": "#/$defs/listen",
@@ -619,7 +619,7 @@
         }
       ]
     },
-    "sharing": {
+    "resolvedSharing": {
       "type": "object",
       "required": ["targets"],
       "properties": {
@@ -631,6 +631,7 @@
               "native",
               "x",
               "bluesky",
+              "threads",
               "linkedin",
               "facebook",
               "hacker-news",
@@ -641,12 +642,28 @@
             ]
           },
           "minItems": 0,
-          "maxItems": 11,
+          "maxItems": 12,
           "uniqueItems": true
+        },
+        "reddit": {
+          "type": "object",
+          "required": ["community"],
+          "properties": {
+            "community": { "type": "string", "pattern": "^[A-Za-z0-9_]{0,21}$" }
+          },
+          "additionalProperties": false
+        },
+        "x": {
+          "type": "object",
+          "required": ["via"],
+          "properties": {
+            "via": { "type": "string", "pattern": "^[A-Za-z0-9_]{0,15}$" }
+          },
+          "additionalProperties": false
         }
       },
       "additionalProperties": false,
-      "description": "SCHEMA-3.22.0: the share buttons shown on each article. `targets` is the display order: 0 to 11 unique members of the closed target set. An absent `sharing` member means `[\"copy-link\"]` (the Copy link button only); an empty `targets` array means no share buttons. `native` is shown only where the browser offers the system share sheet; every other target is a plain link to that service's documented share URL. Bookmark is not a share target and is unaffected."
+      "description": "SCHEMA-3.44.0: the share buttons shown on each article. `targets` is the display order and is already resolved by the toolchain: the site's own list intersected with the platform catalogue, or the platform default share set when the site sets none (0 to 12 unique members of the closed target set). Optional `reddit.community` (subreddit name without `r/`; empty means plain submit) and `x.via` (X handle without `@`; empty means none) are copied from the platform."
     },
     "listing": {
       "type": "object",

package/schemas/publication.schema.json

@@ -369,6 +369,7 @@
               "native",
               "x",
               "bluesky",
+              "threads",
               "linkedin",
               "facebook",
               "hacker-news",
@@ -379,12 +380,12 @@
             ]
           },
           "minItems": 0,
-          "maxItems": 11,
+          "maxItems": 12,
           "uniqueItems": true
         }
       },
       "additionalProperties": false,
-      "description": "SCHEMA-3.22.0: the share buttons shown on each article. `targets` is the display order: 0 to 11 unique members of the closed target set. An absent `sharing` member means `[\"copy-link\"]` (the Copy link button only); an empty `targets` array means no share buttons. `native` is shown only where the browser offers the system share sheet; every other target is a plain link to that service's documented share URL. Bookmark is not a share target and is unaffected."
+      "description": "SCHEMA-3.22.0: the share buttons shown on each article. `targets` is the display order: 0 to 12 unique members of the closed target set; an empty `targets` array means no share buttons. SCHEMA-3.44.0: an absent `sharing` member now means the platform's default share set, resolved at build time by the toolchain from `GET /v2/public/sharing` (it was the Copy link button only); a present `targets` is the site's own ordered list. `native` is shown only where the browser offers the system share sheet; every other target is a plain link to that service's documented share URL. Bookmark is not a share target and is unaffected."
     },
     "contactForm": {
       "type": "object",