@proxima-nexus/openapi 2.2.0 → 2.3.1

package/CHANGELOG.md

@@ -5,6 +5,26 @@ 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.3.1] - 2026-03-04
+
+### Changed
+
+- **Connection types**
+  - Added `associated_group` to connection `type` enums across event, group, and event-series connection DTOs and related responses, so clients can distinguish when a group is linked to an event or series as an associated organizer rather than just an attendee/admin/owner.
+  - `GetEventsDto` and other connection-type-based filters now accept `associated_group` as a valid value.
+
+## [2.3.0] - 2026-03-04
+
+### Added
+
+- **Group event series**
+  - `GET /group/{groupId}/event-series`: list event series associated with a group, returned as `EventSeriesEntityConnectionDto` objects (including connection `type`, `state`, and `seriesId`).
+- **Event series batch lookup**
+  - `POST /event-series/batch`: fetch multiple event series in a single call using `GetEventSeriesDto.seriesIds`.
+- **Schemas**
+  - `EventSeriesEntityConnectionDto`: describes a user/group connection to an event series (timestamps, connection `type`/`state`, and `seriesId`).
+  - `GetEventSeriesDto`: request body for batch series lookup by IDs.
+
 ## [2.2.0] - 2026-03-02
 
 ### Added

package/openapi.json

@@ -1169,7 +1169,8 @@
                 "enum": [
                   "attendee",
                   "admin",
-                  "owner"
+                  "owner",
+                  "associated_group"
                 ]
               }
             }
@@ -1867,6 +1868,45 @@
         ]
       }
     },
+    "/group/{groupId}/event-series": {
+      "get": {
+        "operationId": "GroupController_getEventSeries",
+        "summary": "Get event series of a group",
+        "parameters": [
+          {
+            "name": "groupId",
+            "required": true,
+            "in": "path",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Event series returned",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/EventSeriesEntityConnectionDto"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "group"
+        ],
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      }
+    },
     "/group/batch": {
       "post": {
         "operationId": "GroupController_getBatch",
@@ -2113,6 +2153,46 @@
         ]
       }
     },
+    "/event-series/batch": {
+      "post": {
+        "operationId": "EventSeriesController_getBatch",
+        "summary": "Get a batch of event series by IDs",
+        "parameters": [],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/GetEventSeriesDto"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Event series returned",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/EventSeriesDto"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "event-series"
+        ],
+        "security": [
+          {
+            "api_key": []
+          }
+        ]
+      }
+    },
     "/event-series/{seriesId}/events": {
       "get": {
         "operationId": "EventSeriesController_getInstances",
@@ -2311,6 +2391,7 @@
               "attendee",
               "admin",
               "owner",
+              "associated_group",
               "member",
               "friend",
               "blocked",
@@ -2508,6 +2589,7 @@
               "attendee",
               "admin",
               "owner",
+              "associated_group",
               "member",
               "friend",
               "blocked",
@@ -2575,6 +2657,7 @@
               "attendee",
               "admin",
               "owner",
+              "associated_group",
               "member",
               "friend",
               "blocked",
@@ -2623,6 +2706,7 @@
               "attendee",
               "admin",
               "owner",
+              "associated_group",
               "member",
               "friend",
               "blocked",
@@ -2912,7 +2996,8 @@
             "enum": [
               "attendee",
               "admin",
-              "owner"
+              "owner",
+              "associated_group"
             ]
           }
         },
@@ -3162,6 +3247,55 @@
           "type"
         ]
       },
+      "EventSeriesEntityConnectionDto": {
+        "type": "object",
+        "properties": {
+          "createdAt": {
+            "type": "string",
+            "description": "Date/time the connection was created (ISO string)",
+            "example": "2024-05-01T12:34:56.789Z"
+          },
+          "updatedAt": {
+            "type": "string",
+            "description": "Date/time the connection was last updated (ISO string)",
+            "example": "2024-05-02T12:34:56.789Z"
+          },
+          "type": {
+            "type": "string",
+            "description": "Connection type",
+            "enum": [
+              "attendee",
+              "admin",
+              "owner",
+              "associated_group",
+              "member",
+              "friend",
+              "blocked",
+              "none"
+            ]
+          },
+          "state": {
+            "type": "string",
+            "description": "Connection state",
+            "enum": [
+              "incoming_request",
+              "outgoing_request",
+              "active",
+              "requested",
+              "invited"
+            ]
+          },
+          "seriesId": {
+            "type": "string",
+            "description": "Event series ID",
+            "example": "series-123"
+          }
+        },
+        "required": [
+          "type",
+          "seriesId"
+        ]
+      },
       "GetGroupsDto": {
         "type": "object",
         "properties": {
@@ -3448,6 +3582,25 @@
             "example": 50
           }
         }
+      },
+      "GetEventSeriesDto": {
+        "type": "object",
+        "properties": {
+          "seriesIds": {
+            "description": "The IDs of the event series",
+            "example": [
+              "series-123",
+              "series-456"
+            ],
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "required": [
+          "seriesIds"
+        ]
       }
     }
   }

package/openapi.yaml

@@ -771,6 +771,7 @@ paths:
                 - attendee
                 - admin
                 - owner
+                - associated_group
         - name: X-Proxima-Nexus-Requester-User-Id
           in: header
           description: >-
@@ -1216,6 +1217,29 @@ paths:
         - group
       security:
         - api_key: []
+  /group/{groupId}/event-series:
+    get:
+      operationId: GroupController_getEventSeries
+      summary: Get event series of a group
+      parameters:
+        - name: groupId
+          required: true
+          in: path
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Event series returned
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/EventSeriesEntityConnectionDto'
+      tags:
+        - group
+      security:
+        - api_key: []
   /group/batch:
     post:
       operationId: GroupController_getBatch
@@ -1372,6 +1396,30 @@ paths:
         - event-series
       security:
         - api_key: []
+  /event-series/batch:
+    post:
+      operationId: EventSeriesController_getBatch
+      summary: Get a batch of event series by IDs
+      parameters: []
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/GetEventSeriesDto'
+      responses:
+        '200':
+          description: Event series returned
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/EventSeriesDto'
+      tags:
+        - event-series
+      security:
+        - api_key: []
   /event-series/{seriesId}/events:
     get:
       operationId: EventSeriesController_getInstances
@@ -1517,6 +1565,7 @@ components:
             - attendee
             - admin
             - owner
+            - associated_group
             - member
             - friend
             - blocked
@@ -1661,6 +1710,7 @@ components:
             - attendee
             - admin
             - owner
+            - associated_group
             - member
             - friend
             - blocked
@@ -1712,6 +1762,7 @@ components:
             - attendee
             - admin
             - owner
+            - associated_group
             - member
             - friend
             - blocked
@@ -1750,6 +1801,7 @@ components:
             - attendee
             - admin
             - owner
+            - associated_group
             - member
             - friend
             - blocked
@@ -1967,6 +2019,7 @@ components:
             - attendee
             - admin
             - owner
+            - associated_group
       required:
         - type
     GetEventsDto:
@@ -2143,6 +2196,45 @@ components:
             - owner
       required:
         - type
+    EventSeriesEntityConnectionDto:
+      type: object
+      properties:
+        createdAt:
+          type: string
+          description: Date/time the connection was created (ISO string)
+          example: '2024-05-01T12:34:56.789Z'
+        updatedAt:
+          type: string
+          description: Date/time the connection was last updated (ISO string)
+          example: '2024-05-02T12:34:56.789Z'
+        type:
+          type: string
+          description: Connection type
+          enum:
+            - attendee
+            - admin
+            - owner
+            - associated_group
+            - member
+            - friend
+            - blocked
+            - none
+        state:
+          type: string
+          description: Connection state
+          enum:
+            - incoming_request
+            - outgoing_request
+            - active
+            - requested
+            - invited
+        seriesId:
+          type: string
+          description: Event series ID
+          example: series-123
+      required:
+        - type
+        - seriesId
     GetGroupsDto:
       type: object
       properties:
@@ -2357,3 +2449,16 @@ components:
           type: number
           description: Maximum number of attendees per event instance (null = unlimited)
           example: 50
+    GetEventSeriesDto:
+      type: object
+      properties:
+        seriesIds:
+          description: The IDs of the event series
+          example:
+            - series-123
+            - series-456
+          type: array
+          items:
+            type: string
+      required:
+        - seriesIds

package/package.json

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