@rathnasgala2/schemas 3.38.0 → 3.40.0

package/THIRD_PARTY_LICENSES.json

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

package/docs/catalogs/schema-inventory.json

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

package/openapi/http-catalog.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "2.0.0",
   "sourceDesignRevision": "a53052955ceb6c1aa10c886289dc832eedfe6de0a00004df07d353ac19c4403a",
-  "openApiDigest": "sha256:9fd0867256cb9bae41fe81a73fec8ef605e102e6731ef9711c7507b0d6f4248d",
+  "openApiDigest": "sha256:d39cfe63299c7e04e2e4c4127130e6880cafca135cd0889124a849c469bb7a77",
   "operations": [
     {
       "operationId": "getInternalHealth",
@@ -3843,5 +3843,5 @@
       "sourceFragment": "workloads"
     }
   ],
-  "digest": "sha256:40a395fc0ba96909facd3dda068e3860495386ea21d3aba493ce13dc730600aa"
+  "digest": "sha256:d11e92e7c9ce052e2ad9a46724c2c06954925864442076dea4612e8e85ea6ef8"
 }

package/openapi/openapi.yaml

@@ -6723,11 +6723,11 @@ components:
       type: string
     InterviewPolicy:
       additionalProperties: false
-      description: "SCHEMA-3.34.0. Whether Interview is available to this publication and how many interviews are left this period (UTC month). `enabled: false` means the feature is off; the editor says so and stays usable."
+      description: "SCHEMA-3.34.0. Whether Interview is available to this publication and how many interviews are left this period (the UTC week starting Monday). `enabled: false` means the feature is off; the editor says so and stays usable. `plan.requiredTier` is `PRO` and `quota.period` is a week with `quota.renewsAt` as of SCHEMA-3.39.0."
       properties:
         budget:
           additionalProperties: false
-          description: "`available` is false when the platform's monthly spend cap is reached."
+          description: "`available` is false when the platform's optional monthly spend cap is reached."
           properties:
             available:
               type: boolean
@@ -6743,7 +6743,7 @@ components:
             allowed:
               type: boolean
             requiredTier:
-              description: "The API tier the feature needs: `BUSINESS`, sold as Pro."
+              description: "The lowest API tier that includes Interview: `PRO` (sold as Basic). Basic sites get 2 interviews a week and Pro sites (`BUSINESS`) 5, as the platform settings say."
               enum:
                 - FREE
                 - PRO
@@ -6761,19 +6761,23 @@ components:
               minimum: 0
               type: integer
             period:
-              description: The UTC month, `YYYY-MM`.
-              pattern: ^[0-9]{4}-(?:0[1-9]|1[0-2])$
+              description: The UTC week the allowance counts in, as its Monday, `YYYY-MM-DD`
+              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
             used:
               format: int64
               minimum: 0
               type: integer
           required:
             - period
+            - renewsAt
             - limit
             - used
             - remaining
@@ -23817,7 +23821,7 @@ components:
       type: string
     SyndicationConnection:
       additionalProperties: false
-      description: "SCHEMA-3.37.0. One platform connection of a publication. The credential is never returned: no response, list or event carries it, and a lost one is replaced, not read. `accountLabel` is the platform account the credential belongs to, as the platform names it, for example `@anand` or `name.hashnode.dev`."
+      description: "SCHEMA-3.37.0. One platform connection of a publication. The credential is never returned: no response, list or event carries it, and a lost one is replaced, not read. `accountLabel` is the platform account the credential belongs to, as the platform names it, for example `@anand`, `name.hashnode.dev`, `anand @ example.com` (WordPress) or the Ghost site title."
       properties:
         accountLabel:
           maxLength: 200
@@ -23883,14 +23887,17 @@ components:
         - credential
       type: object
     SyndicationConnectionKind:
-      description: SCHEMA-3.37.0. The platforms a publication can announce its posts to. `devto` and `hashnode` mirror the whole article with the original address as canonical; the other four post a short announcement with the live address.
+      description: SCHEMA-3.37.0. The platforms a publication can announce its posts to. `devto`, `hashnode`, `wordpress` and `ghost` mirror the whole article with the original address as canonical; the others post a short announcement with the live address. `wordpress`, `ghost` and `x` since SCHEMA-3.40.0.
       enum:
         - devto
         - hashnode
+        - wordpress
+        - ghost
         - bluesky
         - mastodon
         - telegram
         - discord
+        - x
       type: string
     SyndicationConnectionList:
       additionalProperties: false
@@ -23929,6 +23936,24 @@ components:
           required:
             - style
           type: object
+        ghost:
+          additionalProperties: false
+          description: "SCHEMA-3.40.0. `publishAsDraft: true` saves each mirrored article on the Ghost site as a draft; default `false` publishes it."
+          properties:
+            publishAsDraft:
+              type: boolean
+          required:
+            - publishAsDraft
+          type: object
+        wordpress:
+          additionalProperties: false
+          description: "SCHEMA-3.40.0. `publishAsDraft: true` saves each mirrored article on the WordPress site as a draft; default `false` publishes it."
+          properties:
+            publishAsDraft:
+              type: boolean
+          required:
+            - publishAsDraft
+          type: object
       type: object
     SyndicationConnectionStatus:
       description: SCHEMA-3.37.0. `ACTIVE` posts new announcements; `PAUSED` was stopped by a person and files nothing; `NEEDS_ATTENTION` means the platform rejected the saved credential, nothing is posted until the credential is replaced or checked again.
@@ -23944,9 +23969,12 @@ components:
           bluesky: "#/components/schemas/SyndicationCredentialBluesky"
           devto: "#/components/schemas/SyndicationCredentialDevto"
           discord: "#/components/schemas/SyndicationCredentialDiscord"
+          ghost: "#/components/schemas/SyndicationCredentialGhost"
           hashnode: "#/components/schemas/SyndicationCredentialHashnode"
           mastodon: "#/components/schemas/SyndicationCredentialMastodon"
           telegram: "#/components/schemas/SyndicationCredentialTelegram"
+          wordpress: "#/components/schemas/SyndicationCredentialWordpress"
+          x: "#/components/schemas/SyndicationCredentialX"
         propertyName: kind
       oneOf:
         - $ref: "#/components/schemas/SyndicationCredentialDevto"
@@ -23955,6 +23983,9 @@ components:
         - $ref: "#/components/schemas/SyndicationCredentialMastodon"
         - $ref: "#/components/schemas/SyndicationCredentialTelegram"
         - $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.
@@ -24018,6 +24049,33 @@ components:
         - kind
         - webhookUrl
       type: object
+    SyndicationCredentialGhost:
+      additionalProperties: false
+      description: SCHEMA-3.40.0. A Ghost site and the Admin API key of a custom integration on it (Settings > Integrations).
+      properties:
+        adminApiKey:
+          description: The integration's Admin API key, `id:secret`.
+          maxLength: 89
+          minLength: 89
+          pattern: ^[0-9a-f]{24}:[0-9a-f]{64}$
+          type: string
+          writeOnly: true
+        kind:
+          pattern: ^ghost$
+          type: string
+          x-gala-const: ghost
+        siteUrl:
+          description: The Ghost admin address root, for example `https://name.ghost.io` or the site's own domain.
+          format: uri
+          maxLength: 300
+          minLength: 12
+          pattern: ^https://[^\s?#]+$
+          type: string
+      required:
+        - kind
+        - siteUrl
+        - adminApiKey
+      type: object
     SyndicationCredentialHashnode:
       additionalProperties: false
       description: SCHEMA-3.37.0. A Hashnode credential and the publication it posts to.
@@ -24094,6 +24152,73 @@ components:
         - botToken
         - channel
       type: object
+    SyndicationCredentialWordpress:
+      additionalProperties: false
+      description: SCHEMA-3.40.0. A WordPress site, a user on it and an Application Password of that user (WordPress 5.6 or later; on WordPress.com this needs the Business plan or higher).
+      properties:
+        applicationPassword:
+          description: An Application Password from the user's profile, with or without its spaces; never the account password.
+          maxLength: 64
+          minLength: 8
+          type: string
+          writeOnly: true
+        kind:
+          pattern: ^wordpress$
+          type: string
+          x-gala-const: wordpress
+        siteUrl:
+          description: The site's root address, for example `https://example.com` or `https://example.com/blog`.
+          format: uri
+          maxLength: 300
+          minLength: 12
+          pattern: ^https://[^\s?#]+$
+          type: string
+        username:
+          description: The WordPress user the posts are published as.
+          maxLength: 100
+          minLength: 1
+          type: string
+      required:
+        - kind
+        - siteUrl
+        - 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`.
@@ -50477,7 +50602,7 @@ paths:
   /v2/organizations/{organizationId}/publications/{publicationId}/interview-policy:
     get:
       description: |
-        Whether Interview is available to this publication (`enabled`), whether the plan includes it (`plan.allowed`, `BUSINESS` tier, sold as Pro), how many interviews are left this period (UTC month) and whether the platform's monthly spend cap still has room. `enabled: false` means the feature is off; the editor says so and stays usable.
+        Whether Interview is available to this publication (`enabled`), whether the plan includes it (`plan.allowed`: the plan must be `PRO`, sold as Basic, or above), how many interviews are left this period (the UTC week starting Monday) and whether the platform's optional monthly spend cap still has room. `enabled: false` means the feature is off; the editor says so and stays usable.
       operationId: getOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewPolicy
       parameters:
         - $ref: "#/components/parameters/XCorrelationId"
@@ -50502,6 +50627,21 @@ paths:
           content:
             application/json:
               examples:
+                basic:
+                  summary: A Basic site
+                  value:
+                    budget:
+                      available: true
+                    enabled: true
+                    plan:
+                      allowed: true
+                      requiredTier: PRO
+                    quota:
+                      limit: 2
+                      period: "2026-11-02"
+                      remaining: 1
+                      renewsAt: "2026-11-09T00:00:00Z"
+                      used: 1
                 nominal:
                   summary: Nominal successful response
                   value:
@@ -50510,11 +50650,12 @@ paths:
                     enabled: true
                     plan:
                       allowed: true
-                      requiredTier: BUSINESS
+                      requiredTier: PRO
                     quota:
-                      limit: 10
-                      period: 2026-11
-                      remaining: 7
+                      limit: 5
+                      period: "2026-11-02"
+                      remaining: 2
+                      renewsAt: "2026-11-09T00:00:00Z"
                       used: 3
               schema:
                 $ref: "#/components/schemas/GetOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewPolicyResponse"
@@ -51269,7 +51410,7 @@ paths:
       x-gala-tenant-scope: ORGANIZATION_AND_PUBLICATION_PATH
     post:
       description: |
-        Saves the material (a note, a voice transcript or a link with its text) as an interview in `CAPTURED`. Nothing is asked and no quota unit is used yet; `POST .../interviews/{interviewId}:start` begins the conversation. `409 PLAN_REQUIRED` when the plan is below `BUSINESS`; `503 CAPABILITY_UNAVAILABLE` when Interview is off. `201`.
+        Saves the material (a note, a voice transcript or a link with its text) as an interview in `CAPTURED`. Nothing is asked and no quota unit is used yet; `POST .../interviews/{interviewId}:start` begins the conversation. The plan must be `PRO` (sold as Basic) or above: `409 PLAN_REQUIRED` below `PRO`. `503 CAPABILITY_UNAVAILABLE` when Interview is off. `201`.
       operationId: postOrganizationsByOrganizationIdPublicationsByPublicationIdInterviews
       parameters:
         - $ref: "#/components/parameters/XCorrelationId"
@@ -53088,7 +53229,7 @@ paths:
   /v2/organizations/{organizationId}/publications/{publicationId}/interviews/{interviewId}:start:
     post:
       description: |
-        Reserves one unit of the organization's monthly allowance and asks the first question. Only from `CAPTURED`. `429 QUOTA_EXHAUSTED` with `Retry-After` when no unit is left this period; `503 BUDGET_EXHAUSTED` when the platform's monthly spend cap is reached; `503 PROVIDER_UNAVAILABLE` when the question could not be asked (nothing is stored and no unit is used; retry).
+        Reserves one unit of the organization's weekly allowance (the UTC week starting Monday; 2 on Basic, 5 on Pro by default) and asks the first question. Only from `CAPTURED`. `429 QUOTA_EXHAUSTED` with `Retry-After` when no unit is left this period; `503 BUDGET_EXHAUSTED` when the platform's optional monthly spend cap is reached; `503 PROVIDER_UNAVAILABLE` when the question could not be asked (nothing is stored and no unit is used; retry).
       operationId: postOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsByInterviewIdStart
       parameters:
         - $ref: "#/components/parameters/XCorrelationId"

package/package.json

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