@proxima-nexus/openapi 2.4.0 → 2.6.0

package/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to the Proxima Nexus OpenAPI specification are documented in
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.6.0] - 2026-08-12
+
+### Added
+
+- **Transfer group ownership**
+  - `PUT /group/{groupId}/owner/{userId}`: transfers ownership to an existing admin and demotes the current owner to admin. Only the current owner may call it; the target must already be an active admin.
+
+## [2.5.0] - 2026-08-12
+
+### Added
+
+- **Extendable event-series end date**
+  - `UpdateEventSeriesDto`: added optional `seriesEndDate` (YYYY-MM-DD). May only be moved later; extending appends the new upcoming event instances up to the new end without disturbing existing ones. Moving it earlier is rejected.
+
 ## [2.4.0] - 2026-05-23
 
 ### Added

package/openapi.json

@@ -1752,6 +1752,62 @@
         ]
       }
     },
+    "/group/{groupId}/owner/{userId}": {
+      "put": {
+        "operationId": "GroupController_transferOwnership",
+        "summary": "Transfer group ownership to an admin",
+        "description": "Transfers ownership to :userId (who must already be an active admin) and demotes the current owner to admin. Only the current owner may perform this.",
+        "parameters": [
+          {
+            "name": "groupId",
+            "required": true,
+            "in": "path",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "userId",
+            "required": true,
+            "in": "path",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "X-Proxima-Nexus-Requester-User-Id",
+            "in": "header",
+            "description": "ID of the current owner transferring ownership",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Ownership transferred"
+          },
+          "400": {
+            "description": "New owner is not an admin, or transfer target is invalid"
+          },
+          "401": {
+            "description": "Only the group owner can transfer ownership"
+          },
+          "404": {
+            "description": "Group not found"
+          }
+        },
+        "tags": [
+          "group"
+        ],
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      }
+    },
     "/group/{groupId}/connections": {
       "get": {
         "operationId": "GroupController_getConnections",
@@ -3700,6 +3756,11 @@
             "type": "string",
             "description": "IANA timezone for interpreting times and generating instances. Changing this regenerates upcoming instances.",
             "example": "America/New_York"
+          },
+          "seriesEndDate": {
+            "type": "string",
+            "description": "New end date for the series (YYYY-MM-DD). May only be moved later; extending appends new upcoming instances up to the new end without disturbing existing ones. Moving it earlier is rejected.",
+            "example": "2027-06-30"
           }
         }
       },

package/openapi.yaml

@@ -1140,6 +1140,43 @@ paths:
         - group
       security:
         - api_key: []
+  /group/{groupId}/owner/{userId}:
+    put:
+      operationId: GroupController_transferOwnership
+      summary: Transfer group ownership to an admin
+      description: >-
+        Transfers ownership to :userId (who must already be an active admin) and demotes the current owner to admin.
+        Only the current owner may perform this.
+      parameters:
+        - name: groupId
+          required: true
+          in: path
+          schema:
+            type: string
+        - name: userId
+          required: true
+          in: path
+          schema:
+            type: string
+        - name: X-Proxima-Nexus-Requester-User-Id
+          in: header
+          description: ID of the current owner transferring ownership
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Ownership transferred
+        '400':
+          description: New owner is not an admin, or transfer target is invalid
+        '401':
+          description: Only the group owner can transfer ownership
+        '404':
+          description: Group not found
+      tags:
+        - group
+      security:
+        - api_key: []
   /group/{groupId}/connections:
     get:
       operationId: GroupController_getConnections
@@ -2532,16 +2569,26 @@ components:
           example: eur
         instanceStartTime:
           type: string
-          description: Start time of each instance in HH:MM format (local time in the given timezone). Changing this regenerates upcoming instances.
+          description: >-
+            Start time of each instance in HH:MM format (local time in the given timezone). Changing this regenerates
+            upcoming instances.
           example: '10:00'
         instanceEndTime:
           type: string
-          description: End time of each instance in HH:MM format (local time in the given timezone). Changing this regenerates upcoming instances.
+          description: >-
+            End time of each instance in HH:MM format (local time in the given timezone). Changing this regenerates
+            upcoming instances.
           example: '11:00'
         timezone:
           type: string
           description: IANA timezone for interpreting times and generating instances. Changing this regenerates upcoming instances.
           example: America/New_York
+        seriesEndDate:
+          type: string
+          description: >-
+            New end date for the series (YYYY-MM-DD). May only be moved later; extending appends new upcoming instances
+            up to the new end without disturbing existing ones. Moving it earlier is rejected.
+          example: '2027-06-30'
     GetEventSeriesDto:
       type: object
       properties:

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@proxima-nexus/openapi",
-    "version": "2.4.0",
+    "version": "2.6.0",
     "description": "OpenAPI specification for Proxima Nexus",
     "main": "openapi.json",
     "types": "openapi.json",