@rathnasgala2/schemas 3.25.1 → 3.27.0

package/openapi/openapi.yaml

@@ -2486,7 +2486,11 @@ components:
       type: object
     FollowState:
       additionalProperties: false
+      description: "SCHEMA-3.27.0: whether the reader follows the author. `followers` is the number of readers following this author on this site; it is present only when the bearer token is for this publication and its principal holds `publication.audience.read` on it (the site's team, the same people who may open the Audience page), and absent for every other caller, including callers with no token."
       properties:
+        followers:
+          minimum: 0
+          type: integer
         following:
           type: boolean
       required:
@@ -3805,6 +3809,8 @@ components:
         - openChange
         - setUp
       type: object
+    GetOrganizationsByOrganizationIdPublicationsByPublicationIdListenSettingsResponse:
+      $ref: "#/components/schemas/ListenSettings"
     GetOrganizationsByOrganizationIdPublicationsByPublicationIdModerationQueueResponse:
       additionalProperties: false
       properties:
@@ -6401,6 +6407,26 @@ components:
         - observedAt
         - evidenceDigest
       type: object
+    ListenSettings:
+      additionalProperties: false
+      description: "SCHEMA-3.26.0: the Listen setting of a site at the linked repository's main branch head: the `listen` member of `gala/publication.json` (`enabled`). A publication with no `listen` member reads `enabled` false. `planAllows` is read-only: false while the site's plan does not include Listen (the Free plan by default), in which case `enabled` cannot be turned on. `openChange` names an existing not-yet-published change of this publication that touches the file, or is null. `setUp` matches `GET .../repository/setup` `state`."
+      properties:
+        enabled:
+          type: boolean
+        openChange:
+          oneOf:
+            - $ref: "#/components/schemas/PublicationAppearanceOpenChange"
+            - type: "null"
+        planAllows:
+          type: boolean
+        setUp:
+          type: boolean
+      required:
+        - enabled
+        - planAllows
+        - openChange
+        - setUp
+      type: object
     ManagedDeploymentOperationResponse:
       additionalProperties: false
       allOf:
@@ -8680,6 +8706,9 @@ components:
         contactForm:
           description: "SCHEMA-3.23.0, whether sites on this plan may turn on the contact form. A site on a plan without it sees the form locked, and enabling it is `409 PLAN_REQUIRED`. Defaults of the first release: FREE 50 and no contact form, PRO 500 and a contact form, BUSINESS 2000 and a contact form."
           type: boolean
+        listen:
+          description: "SCHEMA-3.26.0, whether sites on this plan may turn on Listen, the audio version of posts. A site on a plan without it sees the setting locked, and enabling it is `409 PLAN_REQUIRED`. Defaults: FREE no Listen, PRO and BUSINESS Listen."
+          type: boolean
         newsletterSubscriberLimit:
           description: "SCHEMA-3.23.0, the confirmed newsletter subscribers one organization on this plan may hold across its sites; a confirmation past it is `409 NEWSLETTER_FULL`. 0 admits none. Defaults of the first release: FREE 50 and no contact form, PRO 500 and a contact form, BUSINESS 2000 and a contact form."
           format: int64
@@ -8696,6 +8725,7 @@ components:
         - publicationLimit
         - newsletterSubscriberLimit
         - contactForm
+        - listen
       type: object
     PlatformPlanCapacityRelease:
       additionalProperties: false
@@ -9167,6 +9197,31 @@ components:
         - generation
         - approvedAt
       type: object
+    PortableContentFrontmatterContentListen:
+      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."
+      properties:
+        audio:
+          $ref: "#/components/schemas/PortableContentFrontmatterRepoRelativePath"
+          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."
+          pattern: ^.+\.(?:mp3|m4a)$
+        durationSeconds:
+          description: Length of the episode in whole seconds, 1 to 10800 (three hours).
+          maximum: 10800
+          minimum: 1
+          type: integer
+        format:
+          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."
+          enum:
+            - conversation
+            - narration
+            - debate
+            - skit
+      required:
+        - audio
+        - durationSeconds
+        - format
+      type: object
     PortableContentFrontmatterContentSeo:
       additionalProperties: false
       description: "SCHEMA-3.12.0: optional search overrides for one document. `title` replaces the page title in search results (the site suffix is still appended on non-home pages), `description` replaces the search description, `canonicalUrl` is an absolute HTTPS canonical for syndicated or moved content, and `noindex: true` keeps a listed document out of search engines. Every member is optional; absent members fall back to the document's own title and description."
@@ -9246,6 +9301,17 @@ components:
                 x-gala-const: article
             required:
               - kind
+        - if:
+            required:
+              - listen
+          then:
+            properties:
+              kind:
+                pattern: ^article$
+                type: string
+                x-gala-const: article
+            required:
+              - kind
       dependentRequired:
         seriesOrder:
           - series
@@ -9280,6 +9346,8 @@ components:
             - edition
         language:
           $ref: "#/components/schemas/PortableContentFrontmatterBcp47"
+        listen:
+          $ref: "#/components/schemas/PortableContentFrontmatterContentListen"
         newsletter:
           enum:
             - ineligible
@@ -19311,6 +19379,22 @@ components:
       required:
         - change
       type: object
+    PutOrganizationsByOrganizationIdPublicationsByPublicationIdListenSettingsRequest:
+      additionalProperties: false
+      properties:
+        enabled:
+          type: boolean
+      required:
+        - enabled
+      type: object
+    PutOrganizationsByOrganizationIdPublicationsByPublicationIdListenSettingsResponse:
+      additionalProperties: false
+      properties:
+        change:
+          $ref: "#/components/schemas/PostOrganizationsByOrganizationIdPublicationsByPublicationIdContentChangesPlanResponse"
+      required:
+        - change
+      type: object
     PutOrganizationsByOrganizationIdPublicationsByPublicationIdNewsletterSettingsRequest:
       additionalProperties: false
       allOf:
@@ -19410,6 +19494,9 @@ components:
         contactForm:
           description: SCHEMA-3.23.0, optional; absent keeps the plan's current value.
           type: boolean
+        listen:
+          description: SCHEMA-3.26.0, optional; absent keeps the plan's current value.
+          type: boolean
         newsletterSubscriberLimit:
           description: SCHEMA-3.23.0, optional; absent keeps the plan's current value.
           format: int64
@@ -44939,6 +45026,424 @@ paths:
         - RepositoryChange:REQUESTED -> PLANNED
       x-gala-success-category: protocol
       x-gala-tenant-scope: ORGANIZATION_AND_PUBLICATION_PATH
+  /v2/organizations/{organizationId}/publications/{publicationId}/listen-settings:
+    get:
+      description: Reads the `listen` member of `gala/publication.json` at the linked repository's current main branch head. A publication with no `listen` member reads `enabled` false. `planAllows` is the API's own status and is never written to the repository.
+      operationId: getOrganizationsByOrganizationIdPublicationsByPublicationIdListenSettings
+      parameters:
+        - $ref: "#/components/parameters/XCorrelationId"
+        - example: 018f0000-0000-7000-8000-000000000001
+          in: path
+          name: organizationId
+          required: true
+          schema:
+            format: uuid
+            pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
+            type: string
+        - example: 018f0000-0000-7000-8000-000000000001
+          in: path
+          name: publicationId
+          required: true
+          schema:
+            format: uuid
+            pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
+            type: string
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                nominal:
+                  summary: Nominal successful response
+                  value:
+                    enabled: false
+                    openChange: null
+                    planAllows: false
+                    setUp: true
+              schema:
+                $ref: "#/components/schemas/GetOrganizationsByOrganizationIdPublicationsByPublicationIdListenSettingsResponse"
+          description: read this publication's listen settings at the main branch head succeeded
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+        "400":
+          $ref: "#/components/responses/ValidationFailed"
+        "401":
+          content:
+            application/problem+json:
+              examples:
+                AUTHENTICATION_REQUIRED:
+                  summary: AUTHENTICATION_REQUIRED
+                  value:
+                    code: AUTHENTICATION_REQUIRED
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    errors: []
+                    retryable: false
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 401
+                    title: AUTHENTICATION_REQUIRED
+                    type: urn:gala:problem:authentication-required
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: AUTHENTICATION_REQUIRED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - AUTHENTICATION_REQUIRED
+        "403":
+          $ref: "#/components/responses/AuthorizationDenied"
+        "404":
+          $ref: "#/components/responses/ResourceNotFound"
+        "429":
+          content:
+            application/problem+json:
+              examples:
+                RATE_LIMITED:
+                  summary: RATE_LIMITED
+                  value:
+                    code: RATE_LIMITED
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    errors: []
+                    retryable: true
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 429
+                    title: RATE_LIMITED
+                    type: urn:gala:problem:rate-limited
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: RATE_LIMITED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            Retry-After:
+              $ref: "#/components/headers/RetryAfter"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - RATE_LIMITED
+        "503":
+          content:
+            application/problem+json:
+              examples:
+                CAPABILITY_UNAVAILABLE:
+                  summary: CAPABILITY_UNAVAILABLE
+                  value:
+                    code: CAPABILITY_UNAVAILABLE
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    errors: []
+                    retryable: false
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 503
+                    title: CAPABILITY_UNAVAILABLE
+                    type: urn:gala:problem:capability-unavailable
+                DEPENDENCY_UNAVAILABLE:
+                  summary: DEPENDENCY_UNAVAILABLE
+                  value:
+                    code: DEPENDENCY_UNAVAILABLE
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    errors: []
+                    retryable: true
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 503
+                    title: DEPENDENCY_UNAVAILABLE
+                    type: urn:gala:problem:dependency-unavailable
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: CAPABILITY_UNAVAILABLE, DEPENDENCY_UNAVAILABLE
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - CAPABILITY_UNAVAILABLE
+            - DEPENDENCY_UNAVAILABLE
+      security:
+        - browserSession: []
+      summary: read this publication's listen settings at the main branch head
+      tags:
+        - interaction-settings
+      x-gala-activation-gate: MVP
+      x-gala-activation-guards:
+        - Active repository binding and configured GitHub App identity capability
+      x-gala-capability-key: publication.view
+      x-gala-concurrency: binding-epoch
+      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 this publication's listen settings at the main branch head
+      x-gala-reachable-problems:
+        - AUTHENTICATION_REQUIRED
+        - AUTHORIZATION_DENIED
+        - CAPABILITY_UNAVAILABLE
+        - DEPENDENCY_UNAVAILABLE
+        - RATE_LIMITED
+        - RESOURCE_NOT_FOUND
+        - VALIDATION_FAILED
+      x-gala-replay-identity: safe-query
+      x-gala-state-guards:
+        - NONE
+      x-gala-success-category: query
+      x-gala-tenant-scope: ORGANIZATION_AND_PUBLICATION_PATH
+    put:
+      description: The server writes the `listen` member of `gala/publication.json` as one repository change, the way `sharing-settings` writes the `sharing` member. Publishing the change uses the normal publish flow. `change` has the shape the theme-selection write returns. Turning `enabled` on while the plan does not include Listen is `409 PLAN_REQUIRED` pointed at `/enabled`. Saving it off, or unchanged, is always allowed.
+      operationId: putOrganizationsByOrganizationIdPublicationsByPublicationIdListenSettings
+      parameters:
+        - $ref: "#/components/parameters/XCorrelationId"
+        - example: 018f0000-0000-7000-8000-000000000001
+          in: path
+          name: organizationId
+          required: true
+          schema:
+            format: uuid
+            pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
+            type: string
+        - example: 018f0000-0000-7000-8000-000000000001
+          in: path
+          name: publicationId
+          required: true
+          schema:
+            format: uuid
+            pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
+            type: string
+        - $ref: "#/components/parameters/IdempotencyKey"
+        - $ref: "#/components/parameters/XCsrfToken"
+      requestBody:
+        content:
+          application/json:
+            examples:
+              nominal:
+                summary: Nominal valid request
+                value:
+                  enabled: true
+            schema:
+              $ref: "#/components/schemas/PutOrganizationsByOrganizationIdPublicationsByPublicationIdListenSettingsRequest"
+        required: true
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                nominal:
+                  summary: Nominal successful response
+                  value:
+                    change:
+                      changeId: 018f0000-0000-7000-8000-000000000001
+                      diffDigest: sha256:0000000000000000000000000000000000000000000000000000000000000000
+                      expectedHead: sha1:0000000000000000000000000000000000000000
+                      state: REQUESTED
+                      version: 0
+              schema:
+                $ref: "#/components/schemas/PutOrganizationsByOrganizationIdPublicationsByPublicationIdListenSettingsResponse"
+          description: save this publication's listen settings as a repository change succeeded
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+        "400":
+          $ref: "#/components/responses/RequestInvalid"
+        "401":
+          content:
+            application/problem+json:
+              examples:
+                AUTHENTICATION_REQUIRED:
+                  summary: AUTHENTICATION_REQUIRED
+                  value:
+                    code: AUTHENTICATION_REQUIRED
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    errors: []
+                    retryable: false
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 401
+                    title: AUTHENTICATION_REQUIRED
+                    type: urn:gala:problem:authentication-required
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: AUTHENTICATION_REQUIRED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - AUTHENTICATION_REQUIRED
+        "403":
+          $ref: "#/components/responses/AuthorizationDenied"
+        "404":
+          $ref: "#/components/responses/ResourceNotFound"
+        "409":
+          content:
+            application/problem+json:
+              examples:
+                COMMAND_REPLAY_CONFLICT:
+                  summary: COMMAND_REPLAY_CONFLICT
+                  value:
+                    code: COMMAND_REPLAY_CONFLICT
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    errors: []
+                    retryable: false
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 409
+                    title: COMMAND_REPLAY_CONFLICT
+                    type: urn:gala:problem:command-replay-conflict
+                INVALID_SOURCE_STATE:
+                  summary: INVALID_SOURCE_STATE
+                  value:
+                    code: INVALID_SOURCE_STATE
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    errors: []
+                    retryable: false
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 409
+                    title: INVALID_SOURCE_STATE
+                    type: urn:gala:problem:invalid-source-state
+                PLAN_REQUIRED:
+                  summary: PLAN_REQUIRED
+                  value:
+                    code: PLAN_REQUIRED
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: The site's plan does not include Listen. See the operation contract.
+                    errors:
+                      - code: PLAN_REQUIRED
+                        pointer: /enabled
+                    retryable: false
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 409
+                    title: PLAN_REQUIRED
+                    type: urn:gala:problem:plan-required
+                TRANSFER_PENDING:
+                  summary: TRANSFER_PENDING
+                  value:
+                    code: TRANSFER_PENDING
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    errors: []
+                    retryable: false
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 409
+                    title: TRANSFER_PENDING
+                    type: urn:gala:problem:transfer-pending
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: COMMAND_REPLAY_CONFLICT, INVALID_SOURCE_STATE, PLAN_REQUIRED, TRANSFER_PENDING
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - COMMAND_REPLAY_CONFLICT
+            - INVALID_SOURCE_STATE
+            - PLAN_REQUIRED
+            - TRANSFER_PENDING
+        "422":
+          content:
+            application/problem+json:
+              examples:
+                VALIDATION_FAILED:
+                  summary: VALIDATION_FAILED
+                  value:
+                    code: VALIDATION_FAILED
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    errors: []
+                    retryable: false
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 422
+                    title: VALIDATION_FAILED
+                    type: urn:gala:problem:validation-failed
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: VALIDATION_FAILED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - VALIDATION_FAILED
+        "503":
+          content:
+            application/problem+json:
+              examples:
+                CAPABILITY_UNAVAILABLE:
+                  summary: CAPABILITY_UNAVAILABLE
+                  value:
+                    code: CAPABILITY_UNAVAILABLE
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    errors: []
+                    retryable: false
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 503
+                    title: CAPABILITY_UNAVAILABLE
+                    type: urn:gala:problem:capability-unavailable
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: CAPABILITY_UNAVAILABLE
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - CAPABILITY_UNAVAILABLE
+      security:
+        - browserSession: []
+      summary: save this publication's listen settings as a repository change
+      tags:
+        - interaction-settings
+      x-gala-activation-gate: MVP
+      x-gala-activation-guards:
+        - Active repository binding and configured GitHub App identity capability
+      x-gala-capability-key: publication.settings.manage
+      x-gala-concurrency: expected-git-head-and-binding-epoch
+      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: save this publication's listen settings as a repository change
+      x-gala-reachable-problems:
+        - AUTHENTICATION_REQUIRED
+        - AUTHORIZATION_DENIED
+        - CAPABILITY_UNAVAILABLE
+        - COMMAND_REPLAY_CONFLICT
+        - INVALID_SOURCE_STATE
+        - PLAN_REQUIRED
+        - REQUEST_FIELD_UNKNOWN
+        - RESOURCE_NOT_FOUND
+        - TRANSFER_PENDING
+        - VALIDATION_FAILED
+      x-gala-replay-identity: idempotency-key
+      x-gala-state-guards:
+        - Publication:ACTIVE
+        - RepositoryBinding:ACTIVE
+        - RepositoryChange:REQUESTED -> PLANNED
+      x-gala-success-category: protocol
+      x-gala-tenant-scope: ORGANIZATION_AND_PUBLICATION_PATH
   /v2/organizations/{organizationId}/publications/{publicationId}/moderation/comments/{commentId}:decide:
     post:
       description: |
@@ -59960,10 +60465,12 @@ paths:
         active publication-capacity release with its single optimistic-lock
         version and the closed FREE, PRO, and BUSINESS plan catalog.
         Each plan carries its `publicationLimit`, its `newsletterSubscriberLimit`
-        (confirmed newsletter subscribers per organization) and `contactForm`
-        (whether its sites may turn on the contact form). Defaults of the first
-        release: FREE 50 and no contact form, PRO 500 and a contact form,
-        BUSINESS 2000 and a contact form.
+        (confirmed newsletter subscribers per organization), `contactForm`
+        (whether its sites may turn on the contact form) and `listen` (whether
+        its sites may turn on Listen, the audio version of posts). Defaults of
+        the first release: FREE 50 and no contact form, PRO 500 and a contact
+        form, BUSINESS 2000 and a contact form. Listen defaults: FREE no, PRO
+        and BUSINESS yes.
       operationId: getPlatformPlans
       parameters:
         - $ref: "#/components/parameters/XCorrelationId"
@@ -59978,14 +60485,17 @@ paths:
                     effectiveAt: "2026-10-10T00:00:04.000Z"
                     items:
                       - contactForm: false
+                        listen: false
                         newsletterSubscriberLimit: 50
                         planKey: FREE
                         publicationLimit: 1
                       - contactForm: true
+                        listen: true
                         newsletterSubscriberLimit: 500
                         planKey: PRO
                         publicationLimit: 10
                       - contactForm: true
+                        listen: true
                         newsletterSubscriberLimit: 2000
                         planKey: BUSINESS
                         publicationLimit: 50
@@ -60034,9 +60544,9 @@ paths:
         Operators only, with recent authentication. Atomically replaces the
         complete publication-capacity release, changing the named plan's limits
         while retaining the other two, at the release version in `If-Match`.
-        `newsletterSubscriberLimit` and `contactForm` are optional: absent keeps
-        the plan's current value. The invariant FREE <= PRO <= BUSINESS is
-        enforced on `publicationLimit` only. `reason` is a
+        `newsletterSubscriberLimit`, `contactForm` and `listen` are optional:
+        absent keeps the plan's current value. The invariant FREE <= PRO <=
+        BUSINESS is enforced on `publicationLimit` only. `reason` is a
         non-sensitive operator reason code recorded in the audit event.
       operationId: putPlatformPlansByPlanKey
       parameters:
@@ -60073,14 +60583,17 @@ paths:
                     effectiveAt: "2026-10-10T12:00:00.000Z"
                     items:
                       - contactForm: false
+                        listen: false
                         newsletterSubscriberLimit: 50
                         planKey: FREE
                         publicationLimit: 1
                       - contactForm: true
+                        listen: true
                         newsletterSubscriberLimit: 500
                         planKey: PRO
                         publicationLimit: 12
                       - contactForm: true
+                        listen: true
                         newsletterSubscriberLimit: 2000
                         planKey: BUSINESS
                         publicationLimit: 50
@@ -63513,7 +64026,7 @@ paths:
       x-gala-tenant-scope: NONE
   /v2/public/publications/{publicationId}/authors/{authorId}/follow:
     delete:
-      description: Idempotent, and allowed whether or not the site still has follows turned on or is live, so a reader can always leave. `404 AUTHOR_NOT_FOUND` only when the site names no such author and the reader holds no follow of that id.
+      description: Idempotent, and allowed whether or not the site still has follows turned on or is live, so a reader can always leave. `404 AUTHOR_NOT_FOUND` only when the site names no such author and the reader holds no follow of that id. On a site-team token (this publication's token whose principal holds `publication.audience.read`) the response also carries `followers`, the number of readers following the author; it is absent for every other caller, including callers with no token.
       operationId: deletePublicPublicationsByPublicationIdAuthorsByAuthorIdFollow
       parameters:
         - $ref: "#/components/parameters/XCorrelationId"
@@ -63688,7 +64201,7 @@ paths:
       x-gala-success-category: protocol
       x-gala-tenant-scope: NONE
     get:
-      description: Public read with an optional reader bearer token. With a token, `following` says whether that reader follows the author; without one it is false. The site's Follow button decides whether to show itself from the `follows.enabled` setting it was built with, not from this read.
+      description: Public read with an optional reader bearer token. With a token, `following` says whether that reader follows the author; without one it is false. The site's Follow button decides whether to show itself from the `follows.enabled` setting it was built with, not from this read. On a site-team token (this publication's token whose principal holds `publication.audience.read`) the response also carries `followers`, the number of readers following the author; it is absent for every other caller, including callers with no token.
       operationId: getPublicPublicationsByPublicationIdAuthorsByAuthorIdFollow
       parameters:
         - $ref: "#/components/parameters/XCorrelationId"
@@ -63793,7 +64306,7 @@ paths:
       x-gala-success-category: query
       x-gala-tenant-scope: NONE
     put:
-      description: "Idempotent: following twice is the same as following once. A follow is a reader's own business: only that reader sees it, the site owner sees a display name in the follower list and there is no public follower count. `409 FOLLOWS_DISABLED` while the author has the Follow button off. `404 AUTHOR_NOT_FOUND` when the site names no such author."
+      description: "Idempotent: following twice is the same as following once. A follow is a reader's own business: only that reader sees it, the site owner sees a display name in the follower list and there is no public follower count. `409 FOLLOWS_DISABLED` while the author has the Follow button off. `404 AUTHOR_NOT_FOUND` when the site names no such author. On a site-team token (this publication's token whose principal holds `publication.audience.read`) the response also carries `followers`, the number of readers following the author; it is absent for every other caller, including callers with no token."
       operationId: putPublicPublicationsByPublicationIdAuthorsByAuthorIdFollow
       parameters:
         - $ref: "#/components/parameters/XCorrelationId"

package/package.json

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