@rathnasgala2/schemas 3.40.0 → 3.41.0

package/THIRD_PARTY_LICENSES.json

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

package/docs/catalogs/app-routes.json

@@ -3222,6 +3222,7 @@
       "capabilityKeys": ["publication.settings.manage", "publication.view"],
       "apiOperationIds": [
         "deleteOrganizationsByOrganizationIdPublicationsByPublicationIdSyndicationConnectionsByConnectionId",
+        "getCallbacksXOauth",
         "getOrganizationsByOrganizationIdPublicationsByPublicationIdSyndicationConnections",
         "getOrganizationsByOrganizationIdPublicationsByPublicationIdSyndicationConnectionsByConnectionId",
         "getOrganizationsByOrganizationIdPublicationsByPublicationIdSyndicationDeliveries",
@@ -3230,6 +3231,7 @@
         "postOrganizationsByOrganizationIdPublicationsByPublicationIdSyndicationConnectionsByConnectionIdReplaceCredential",
         "postOrganizationsByOrganizationIdPublicationsByPublicationIdSyndicationConnectionsByConnectionIdResume",
         "postOrganizationsByOrganizationIdPublicationsByPublicationIdSyndicationConnectionsByConnectionIdVerify",
+        "postOrganizationsByOrganizationIdPublicationsByPublicationIdSyndicationConnectionsXAuthorize",
         "postOrganizationsByOrganizationIdPublicationsByPublicationIdSyndicationDeliveries",
         "postOrganizationsByOrganizationIdPublicationsByPublicationIdSyndicationDeliveriesByDeliveryIdRetry"
       ],
@@ -3759,5 +3761,5 @@
       ]
     }
   ],
-  "digest": "sha256:da951053ced5e845b1994317d0ac5dedd13676f12e0013d25e9b026a0c0da285"
+  "digest": "sha256:7cbb42b552bf9e04d74c01c2abbcf50de684bcd74fc1f5f8f4f36be7b59f564f"
 }

package/docs/catalogs/schema-inventory.json

@@ -229,9 +229,9 @@
       "version": "2.0.0",
       "path": "openapi/openapi.yaml",
       "materialized": true,
-      "sourceDigest": "sha256:d39cfe63299c7e04e2e4c4127130e6880cafca135cd0889124a849c469bb7a77",
+      "sourceDigest": "sha256:4a900ecbc6118116001779afb71afe88fce5c97b08f8a955c54c4359f57e5d4d",
       "typescriptRootType": null
     }
   ],
-  "digest": "sha256:89ec466312679842755188c4cc0963fc38981c1e0c1a1edbe26b8125ee459a4a"
+  "digest": "sha256:06ab0cbc82777d1d3d0fc5bbbb170f2bd7681588dbfcfb7c59318923b4690c28"
 }

package/openapi/http-catalog.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "2.0.0",
   "sourceDesignRevision": "a53052955ceb6c1aa10c886289dc832eedfe6de0a00004df07d353ac19c4403a",
-  "openApiDigest": "sha256:d39cfe63299c7e04e2e4c4127130e6880cafca135cd0889124a849c469bb7a77",
+  "openApiDigest": "sha256:4a900ecbc6118116001779afb71afe88fce5c97b08f8a955c54c4359f57e5d4d",
   "operations": [
     {
       "operationId": "getInternalHealth",
@@ -146,6 +146,19 @@
       "apiKeyScope": null,
       "sourceFragment": "callbacks"
     },
+    {
+      "operationId": "getCallbacksXOauth",
+      "method": "GET",
+      "path": "/v2/callbacks/x/oauth",
+      "purpose": "consume the exact X OAuth callback transaction",
+      "capabilityKey": null,
+      "conditionalCapabilityKeys": [],
+      "activationGate": "MVP",
+      "assuranceClass": "SESSION",
+      "actionGrant": "none",
+      "apiKeyScope": null,
+      "sourceFragment": "callbacks"
+    },
     {
       "operationId": "getClaimsByToken",
       "method": "GET",
@@ -2347,6 +2360,19 @@
       "apiKeyScope": null,
       "sourceFragment": "syndication"
     },
+    {
+      "operationId": "postOrganizationsByOrganizationIdPublicationsByPublicationIdSyndicationConnectionsXAuthorize",
+      "method": "POST",
+      "path": "/v2/organizations/{organizationId}/publications/{publicationId}/syndication-connections/x:authorize",
+      "purpose": "start connecting X",
+      "capabilityKey": "publication.settings.manage",
+      "conditionalCapabilityKeys": [],
+      "activationGate": "MVP",
+      "assuranceClass": "SESSION",
+      "actionGrant": "none",
+      "apiKeyScope": null,
+      "sourceFragment": "syndication"
+    },
     {
       "operationId": "getOrganizationsByOrganizationIdPublicationsByPublicationIdSyndicationDeliveries",
       "method": "GET",
@@ -3843,5 +3869,5 @@
       "sourceFragment": "workloads"
     }
   ],
-  "digest": "sha256:d11e92e7c9ce052e2ad9a46724c2c06954925864442076dea4612e8e85ea6ef8"
+  "digest": "sha256:1e95229acb1fc8413bba7472f5bfd5be3cb571c81488df439b389f061cde022d"
 }

package/openapi/openapi.yaml

@@ -19367,6 +19367,9 @@ components:
     PostOrganizationsByOrganizationIdPublicationsByPublicationIdSyndicationConnectionsResponse:
       allOf:
         - $ref: "#/components/schemas/SyndicationConnection"
+    PostOrganizationsByOrganizationIdPublicationsByPublicationIdSyndicationConnectionsXAuthorizeResponse:
+      allOf:
+        - $ref: "#/components/schemas/SyndicationXAuthorization"
     PostOrganizationsByOrganizationIdPublicationsByPublicationIdSyndicationDeliveriesByDeliveryIdRetryResponse:
       allOf:
         - $ref: "#/components/schemas/SyndicationDelivery"
@@ -23827,6 +23830,9 @@ components:
           maxLength: 200
           minLength: 1
           type: string
+        allowance:
+          $ref: "#/components/schemas/SyndicationWeeklyAllowance"
+          description: SCHEMA-3.41.0. Present when `kind` is `x`, the organization's X posts left this UTC week.
         attention:
           $ref: "#/components/schemas/SyndicationConnectionAttention"
         createdAt:
@@ -23856,7 +23862,7 @@ components:
       description: SCHEMA-3.37.0. Why a connection stopped posting, present while its `status` is `NEEDS_ATTENTION`. `message` is written for the author.
       properties:
         code:
-          description: A stable upper-case reason, for example `CREDENTIAL_REJECTED`. A client shows a value it does not know as `message`.
+          description: "A stable upper-case reason, for example `CREDENTIAL_REJECTED`, or `REAUTHORIZE` (SCHEMA-3.41.0: X refused the saved refresh token, so the person must press Connect X again). A client shows a value it does not know as `message`."
           maxLength: 64
           minLength: 1
           pattern: ^[A-Z][A-Z0-9_]*$
@@ -23974,7 +23980,6 @@ components:
           mastodon: "#/components/schemas/SyndicationCredentialMastodon"
           telegram: "#/components/schemas/SyndicationCredentialTelegram"
           wordpress: "#/components/schemas/SyndicationCredentialWordpress"
-          x: "#/components/schemas/SyndicationCredentialX"
         propertyName: kind
       oneOf:
         - $ref: "#/components/schemas/SyndicationCredentialDevto"
@@ -23985,7 +23990,6 @@ components:
         - $ref: "#/components/schemas/SyndicationCredentialDiscord"
         - $ref: "#/components/schemas/SyndicationCredentialWordpress"
         - $ref: "#/components/schemas/SyndicationCredentialGhost"
-        - $ref: "#/components/schemas/SyndicationCredentialX"
     SyndicationCredentialBluesky:
       additionalProperties: false
       description: SCHEMA-3.37.0. A Bluesky handle and app password.
@@ -24184,41 +24188,6 @@ components:
         - username
         - applicationPassword
       type: object
-    SyndicationCredentialX:
-      additionalProperties: false
-      description: SCHEMA-3.40.0. The author's own X developer app, OAuth 1.0a user context with Read and Write. X bills the author's developer account for every post.
-      properties:
-        accessToken:
-          maxLength: 200
-          minLength: 8
-          type: string
-          writeOnly: true
-        accessTokenSecret:
-          maxLength: 200
-          minLength: 8
-          type: string
-          writeOnly: true
-        apiKey:
-          maxLength: 200
-          minLength: 8
-          type: string
-          writeOnly: true
-        apiKeySecret:
-          maxLength: 200
-          minLength: 8
-          type: string
-          writeOnly: true
-        kind:
-          pattern: ^x$
-          type: string
-          x-gala-const: x
-      required:
-        - kind
-        - apiKey
-        - apiKeySecret
-        - accessToken
-        - accessTokenSecret
-      type: object
     SyndicationDelivery:
       additionalProperties: false
       description: SCHEMA-3.37.0. One post of one live article to one platform. `connectionId` is absent once the connection was removed; `kind` and `accountLabel` stay. `externalUrl` is the post on the platform, absent for `discord` and until the delivery is `SENT`.
@@ -24282,7 +24251,7 @@ components:
       description: SCHEMA-3.37.0. Why a delivery failed. `message` is the platform's own words when it gave any, else Galascribe's.
       properties:
         code:
-          description: A stable upper-case reason, for example `CREDENTIAL_REJECTED`, `PLATFORM_REJECTED` or `RETRIES_EXHAUSTED`. A client shows a value it does not know as `message`.
+          description: A stable upper-case reason, for example `CREDENTIAL_REJECTED`, `PLATFORM_REJECTED`, `RETRIES_EXHAUSTED` or, since SCHEMA-3.41.0, `WEEKLY_ALLOWANCE_SPENT` (an X delivery, status `FAILED`, message "X posts for this week are used. They come back on <Mon d>."; a manual retry after the allowance renews works). A client shows a value it does not know as `message`.
           maxLength: 64
           minLength: 1
           pattern: ^[A-Z][A-Z0-9_]*$
@@ -24369,6 +24338,46 @@ components:
       required:
         - credential
       type: object
+    SyndicationWeeklyAllowance:
+      additionalProperties: false
+      description: SCHEMA-3.41.0. How many X posts the organization has left this UTC week. The allowance follows the organization's plan (2 on Basic and 5 on Pro by default, as the platform settings say) and is shared by every X connection of the organization. Wording follows `InterviewPolicy.quota`.
+      properties:
+        limit:
+          format: int64
+          minimum: 0
+          type: integer
+        period:
+          description: The UTC week the allowance counts in, as its Monday, `YYYY-MM-DD`
+          format: date
+          pattern: ^[0-9]{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])$
+          type: string
+        remaining:
+          format: int64
+          minimum: 0
+          type: integer
+        renewsAt:
+          $ref: "#/components/schemas/PortableProblemRfc3339"
+          description: The first instant of the next UTC week (Monday 00:00Z), when the allowance comes back
+      required:
+        - period
+        - renewsAt
+        - limit
+        - remaining
+      type: object
+    SyndicationXAuthorization:
+      additionalProperties: false
+      description: SCHEMA-3.41.0. Where to send the person to let Galascribe's own X app post for them. Open `authorizationUrl` (x.com); X brings the browser back to `GET /v2/callbacks/x/oauth` within 10 minutes (`expiresAt`).
+      properties:
+        authorizationUrl:
+          format: uri
+          maxLength: 2048
+          type: string
+        expiresAt:
+          $ref: "#/components/schemas/PortableProblemRfc3339"
+      required:
+        - authorizationUrl
+        - expiresAt
+      type: object
     VerificationPlanEntry:
       additionalProperties: false
       properties:
@@ -25809,6 +25818,77 @@ paths:
         - NONE
       x-gala-success-category: billing-callback
       x-gala-tenant-scope: NONE
+  /v2/callbacks/x/oauth:
+    get:
+      description: |
+        SCHEMA-3.41.0. The address X sends the person back to after the consent screen. It never answers with a problem document for what the provider sends: every outcome is a `303` to the App at `/settings/syndication?x=<connectionId>` on success or `/settings/syndication?xError=<code>` with `<code>` one of `DENIED` (the person refused on x.com), `EXPIRED` (the state is unknown or older than 10 minutes), `LIMIT` (the publication is at its connection limit), `REJECTED` (X refused the code or the account read) or `UNAVAILABLE` (X could not be reached or is not configured). Reconnecting an X account already connected to the same publication replaces its tokens in place (same connection) and clears attention. `code`, `state`, `error` and `error_description` are never logged or echoed. Only a value longer than its limit is refused as `400 VALIDATION_FAILED`, before any connection is touched.
+      operationId: getCallbacksXOauth
+      parameters:
+        - $ref: "#/components/parameters/XCorrelationId"
+        - example: example
+          in: query
+          name: code
+          required: false
+          schema:
+            maxLength: 8192
+            minLength: 1
+            type: string
+        - example: example
+          in: query
+          name: state
+          required: false
+          schema:
+            maxLength: 8192
+            minLength: 1
+            type: string
+        - example: example
+          in: query
+          name: error
+          required: false
+          schema:
+            maxLength: 8192
+            minLength: 1
+            type: string
+        - example: example
+          in: query
+          name: error_description
+          required: false
+          schema:
+            maxLength: 8192
+            minLength: 1
+            type: string
+      responses:
+        "303":
+          description: consume the exact X OAuth callback transaction succeeded
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            Location:
+              $ref: "#/components/headers/Location"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+        "400":
+          $ref: "#/components/responses/ValidationFailed"
+      security: []
+      summary: consume the exact X OAuth callback transaction
+      tags:
+        - callbacks
+      x-gala-activation-gate: MVP
+      x-gala-activation-guards:
+        - NONE
+      x-gala-capability-key: null
+      x-gala-concurrency: single-use-transaction
+      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: consume the exact X OAuth callback transaction
+      x-gala-reachable-problems:
+        - VALIDATION_FAILED
+      x-gala-replay-identity: oauth-state
+      x-gala-state-guards:
+        - NONE
+      x-gala-success-category: oauth-callback
+      x-gala-tenant-scope: NONE
   /v2/claims/{token}:
     get:
       description: |
@@ -65404,6 +65484,298 @@ paths:
         - NONE
       x-gala-success-category: create
       x-gala-tenant-scope: ORGANIZATION_AND_PUBLICATION_PATH
+  /v2/organizations/{organizationId}/publications/{publicationId}/syndication-connections/x:authorize:
+    post:
+      description: "SCHEMA-3.41.0. Starts connecting X. Galascribe's own X app posts on the author's behalf: the author never handles keys, X bills Galascribe, and the organization's plan sets a weekly allowance of X posts (2 on Basic, 5 on Pro by default; none on Free). The answer carries the address on x.com to send the person to; X brings the browser back to `GET /v2/callbacks/x/oauth` within 10 minutes, which saves the connection and lands on the Syndication settings page. Needs `publication.settings.manage`. `409 PLAN_REQUIRED` when the plan allows no X posts, `409 SYNDICATION_CONNECTION_LIMIT` at 12 connections, `503 SYNDICATION_X_NOT_CONFIGURED` when the platform operator has not configured the X app, `429 RATE_LIMITED` after too many attempts."
+      operationId: postOrganizationsByOrganizationIdPublicationsByPublicationIdSyndicationConnectionsXAuthorize
+      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"
+      responses:
+        "201":
+          content:
+            application/json:
+              examples:
+                nominal:
+                  summary: Nominal successful response
+                  value:
+                    authorizationUrl: https://x.com/i/oauth2/authorize?response_type=code&client_id=example-client-id&state=example-state
+                    expiresAt: "2026-11-06T12:10:00.000Z"
+              schema:
+                $ref: "#/components/schemas/PostOrganizationsByOrganizationIdPublicationsByPublicationIdSyndicationConnectionsXAuthorizeResponse"
+          description: start connecting X succeeded
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            Location:
+              $ref: "#/components/headers/Location"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+        "400":
+          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: 400
+                    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
+        "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":
+          content:
+            application/problem+json:
+              examples:
+                AUTHORIZATION_DENIED:
+                  summary: AUTHORIZATION_DENIED
+                  value:
+                    code: AUTHORIZATION_DENIED
+                    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: 403
+                    title: AUTHORIZATION_DENIED
+                    type: urn:gala:problem:authorization-denied
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: AUTHORIZATION_DENIED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - AUTHORIZATION_DENIED
+        "404":
+          content:
+            application/problem+json:
+              examples:
+                RESOURCE_NOT_FOUND:
+                  summary: RESOURCE_NOT_FOUND
+                  value:
+                    code: RESOURCE_NOT_FOUND
+                    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: 404
+                    title: RESOURCE_NOT_FOUND
+                    type: urn:gala:problem:resource-not-found
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: RESOURCE_NOT_FOUND
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - RESOURCE_NOT_FOUND
+        "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
+                PLAN_REQUIRED:
+                  summary: PLAN_REQUIRED
+                  value:
+                    code: PLAN_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: 409
+                    title: PLAN_REQUIRED
+                    type: urn:gala:problem:plan-required
+                SYNDICATION_CONNECTION_LIMIT:
+                  summary: SYNDICATION_CONNECTION_LIMIT
+                  value:
+                    code: SYNDICATION_CONNECTION_LIMIT
+                    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: SYNDICATION_CONNECTION_LIMIT
+                    type: urn:gala:problem:syndication-connection-limit
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: COMMAND_REPLAY_CONFLICT, PLAN_REQUIRED, SYNDICATION_CONNECTION_LIMIT
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - COMMAND_REPLAY_CONFLICT
+            - PLAN_REQUIRED
+            - SYNDICATION_CONNECTION_LIMIT
+        "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:
+                SYNDICATION_X_NOT_CONFIGURED:
+                  summary: SYNDICATION_X_NOT_CONFIGURED
+                  value:
+                    code: SYNDICATION_X_NOT_CONFIGURED
+                    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: SYNDICATION_X_NOT_CONFIGURED
+                    type: urn:gala:problem:syndication-x-not-configured
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: SYNDICATION_X_NOT_CONFIGURED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - SYNDICATION_X_NOT_CONFIGURED
+      security:
+        - browserSession: []
+      summary: start connecting X
+      tags:
+        - syndication
+      x-gala-activation-gate: MVP
+      x-gala-activation-guards:
+        - NONE
+      x-gala-capability-key: publication.settings.manage
+      x-gala-concurrency: authorization-and-publication-epochs
+      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: start connecting X
+      x-gala-reachable-problems:
+        - AUTHENTICATION_REQUIRED
+        - AUTHORIZATION_DENIED
+        - COMMAND_REPLAY_CONFLICT
+        - PLAN_REQUIRED
+        - RATE_LIMITED
+        - RESOURCE_NOT_FOUND
+        - SYNDICATION_CONNECTION_LIMIT
+        - SYNDICATION_X_NOT_CONFIGURED
+        - VALIDATION_FAILED
+      x-gala-replay-identity: idempotency-key
+      x-gala-state-guards:
+        - NONE
+      x-gala-success-category: create
+      x-gala-tenant-scope: ORGANIZATION_AND_PUBLICATION_PATH
   /v2/organizations/{organizationId}/publications/{publicationId}/syndication-connections/{connectionId}:
     delete:
       description: Removes the connection and destroys its saved credential. Posts already made stay on the platform; its deliveries stay in the history with their kind and account name. Needs `publication.settings.manage`. Removing a connection that is already gone answers `404 SYNDICATION_CONNECTION_NOT_FOUND`.
@@ -66056,7 +66428,7 @@ paths:
       x-gala-tenant-scope: ORGANIZATION_AND_PUBLICATION_PATH
   /v2/organizations/{organizationId}/publications/{publicationId}/syndication-connections/{connectionId}:replace-credential:
     post:
-      description: "Checks the new credential with the platform and, when it is accepted, replaces the saved one and sets the connection `ACTIVE`; the old credential is destroyed. The new `credential.kind` must equal the connection's kind. Same problems as connecting: `422 SYNDICATION_CREDENTIAL_REJECTED` with the platform's message, `503 SYNDICATION_PLATFORM_UNAVAILABLE`. Needs `publication.settings.manage`."
+      description: "Checks the new credential with the platform and, when it is accepted, replaces the saved one and sets the connection `ACTIVE`; the old credential is destroyed. The new `credential.kind` must equal the connection's kind. Same problems as connecting: `422 SYNDICATION_CREDENTIAL_REJECTED` with the platform's message, `503 SYNDICATION_PLATFORM_UNAVAILABLE`. Needs `publication.settings.manage`. SCHEMA-3.41.0: an `x` connection takes no credential; it is reconnected through `syndication-connections/x:authorize`, and this operation refuses it."
       operationId: postOrganizationsByOrganizationIdPublicationsByPublicationIdSyndicationConnectionsByConnectionIdReplaceCredential
       parameters:
         - $ref: "#/components/parameters/XCorrelationId"

package/package.json

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