@proxima-nexus/openapi 2.3.1 → 2.3.3

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.3.2] - 2026-03-19
+
+### Added
+
+- **Geo-aware discovery filters**
+  - `GET /user/{userId}/groups`: added optional `latitude` and `longitude` query params for nearby group discovery.
+  - `GET /user/{userId}/events`: added optional `latitude` and `longitude` query params for nearby event discovery.
+
+### Changed
+
+- **Connection types**
+  - Added `nearby` to connection `type` enums used by event, group, and event-series connection DTOs/responses and related filters.
+  - `GetEventsDto` and group connection-type filters now accept `nearby` as a valid value.
+
 ## [2.3.1] - 2026-03-04
 
 ### Changed

package/openapi.json

@@ -590,6 +590,24 @@
               "type": "string"
             }
           },
+          {
+            "name": "latitude",
+            "required": false,
+            "in": "query",
+            "description": "Requester latitude for nearby group discovery",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "longitude",
+            "required": false,
+            "in": "query",
+            "description": "Requester longitude for nearby group discovery",
+            "schema": {
+              "type": "string"
+            }
+          },
           {
             "name": "X-Proxima-Nexus-Requester-User-Id",
             "in": "header",
@@ -656,6 +674,24 @@
               "type": "string"
             }
           },
+          {
+            "name": "latitude",
+            "required": false,
+            "in": "query",
+            "description": "Requester latitude for nearby event discovery",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "longitude",
+            "required": false,
+            "in": "query",
+            "description": "Requester longitude for nearby event discovery",
+            "schema": {
+              "type": "string"
+            }
+          },
           {
             "name": "X-Proxima-Nexus-Requester-User-Id",
             "in": "header",
@@ -1170,7 +1206,8 @@
                   "attendee",
                   "admin",
                   "owner",
-                  "associated_group"
+                  "associated_group",
+                  "nearby"
                 ]
               }
             }
@@ -1759,7 +1796,8 @@
                 "enum": [
                   "member",
                   "admin",
-                  "owner"
+                  "owner",
+                  "nearby"
                 ]
               }
             }
@@ -2392,6 +2430,7 @@
               "admin",
               "owner",
               "associated_group",
+              "nearby",
               "member",
               "friend",
               "blocked",
@@ -2590,6 +2629,7 @@
               "admin",
               "owner",
               "associated_group",
+              "nearby",
               "member",
               "friend",
               "blocked",
@@ -2658,6 +2698,7 @@
               "admin",
               "owner",
               "associated_group",
+              "nearby",
               "member",
               "friend",
               "blocked",
@@ -2707,6 +2748,7 @@
               "admin",
               "owner",
               "associated_group",
+              "nearby",
               "member",
               "friend",
               "blocked",
@@ -2806,6 +2848,16 @@
             "type": "number",
             "description": "Maximum number of attendees allowed (null = unlimited)",
             "example": 100
+          },
+          "registrationFeeAmount": {
+            "type": "number",
+            "description": "Registration fee amount in minor units (e.g. cents). Must be set together with registrationFeeCurrency.",
+            "example": 500
+          },
+          "registrationFeeCurrency": {
+            "type": "string",
+            "description": "ISO 4217 currency code, lowercase (e.g. eur). Must be set together with registrationFeeAmount.",
+            "example": "eur"
           }
         },
         "required": [
@@ -2915,6 +2967,16 @@
             "type": "string",
             "description": "ID of the event series this instance belongs to, if any",
             "example": "series-weekly-standup"
+          },
+          "registrationFeeAmount": {
+            "type": "number",
+            "description": "Registration fee amount in minor units (e.g. cents)",
+            "example": 500
+          },
+          "registrationFeeCurrency": {
+            "type": "string",
+            "description": "ISO 4217 currency code, lowercase (e.g. eur)",
+            "example": "eur"
           }
         },
         "required": [
@@ -2984,6 +3046,16 @@
             "type": "number",
             "description": "Maximum number of attendees allowed (null = unlimited)",
             "example": 100
+          },
+          "registrationFeeAmount": {
+            "type": "object",
+            "description": "Registration fee amount in minor units (e.g. cents). Set to null to remove the fee.",
+            "example": 500
+          },
+          "registrationFeeCurrency": {
+            "type": "object",
+            "description": "ISO 4217 currency code, lowercase (e.g. eur). Set to null to remove the fee.",
+            "example": "eur"
           }
         }
       },
@@ -2997,7 +3069,8 @@
               "attendee",
               "admin",
               "owner",
-              "associated_group"
+              "associated_group",
+              "nearby"
             ]
           }
         },
@@ -3239,7 +3312,8 @@
             "enum": [
               "member",
               "admin",
-              "owner"
+              "owner",
+              "nearby"
             ]
           }
         },
@@ -3268,6 +3342,7 @@
               "admin",
               "owner",
               "associated_group",
+              "nearby",
               "member",
               "friend",
               "blocked",
@@ -3401,6 +3476,16 @@
             "type": "number",
             "description": "Maximum number of attendees per event instance (null = unlimited)",
             "example": 50
+          },
+          "registrationFeeAmount": {
+            "type": "number",
+            "description": "Registration fee amount in minor units (e.g. cents). Must be set together with registrationFeeCurrency.",
+            "example": 500
+          },
+          "registrationFeeCurrency": {
+            "type": "string",
+            "description": "ISO 4217 currency code, lowercase (e.g. eur). Must be set together with registrationFeeAmount.",
+            "example": "eur"
           }
         },
         "required": [
@@ -3518,6 +3603,16 @@
             "type": "number",
             "description": "Maximum number of attendees per event instance",
             "example": 50
+          },
+          "registrationFeeAmount": {
+            "type": "number",
+            "description": "Registration fee amount in minor units (e.g. cents)",
+            "example": 500
+          },
+          "registrationFeeCurrency": {
+            "type": "string",
+            "description": "ISO 4217 currency code, lowercase (e.g. eur)",
+            "example": "eur"
           }
         },
         "required": [
@@ -3580,6 +3675,16 @@
             "type": "number",
             "description": "Maximum number of attendees per event instance (null = unlimited)",
             "example": 50
+          },
+          "registrationFeeAmount": {
+            "type": "object",
+            "description": "Registration fee amount in minor units (e.g. cents). Set to null to remove the fee.",
+            "example": 500
+          },
+          "registrationFeeCurrency": {
+            "type": "object",
+            "description": "ISO 4217 currency code, lowercase (e.g. eur). Set to null to remove the fee.",
+            "example": "eur"
           }
         }
       },

package/openapi.yaml

@@ -394,6 +394,18 @@ paths:
           in: path
           schema:
             type: string
+        - name: latitude
+          required: false
+          in: query
+          description: Requester latitude for nearby group discovery
+          schema:
+            type: string
+        - name: longitude
+          required: false
+          in: query
+          description: Requester longitude for nearby group discovery
+          schema:
+            type: string
         - name: X-Proxima-Nexus-Requester-User-Id
           in: header
           description: >-
@@ -437,6 +449,18 @@ paths:
           description: ISO 8601 end of range (events starting before this time)
           schema:
             type: string
+        - name: latitude
+          required: false
+          in: query
+          description: Requester latitude for nearby event discovery
+          schema:
+            type: string
+        - name: longitude
+          required: false
+          in: query
+          description: Requester longitude for nearby event discovery
+          schema:
+            type: string
         - name: X-Proxima-Nexus-Requester-User-Id
           in: header
           description: >-
@@ -772,6 +796,7 @@ paths:
                 - admin
                 - owner
                 - associated_group
+                - nearby
         - name: X-Proxima-Nexus-Requester-User-Id
           in: header
           description: >-
@@ -1151,6 +1176,7 @@ paths:
                 - member
                 - admin
                 - owner
+                - nearby
         - name: X-Proxima-Nexus-Requester-User-Id
           in: header
           description: >-
@@ -1566,6 +1592,7 @@ components:
             - admin
             - owner
             - associated_group
+            - nearby
             - member
             - friend
             - blocked
@@ -1711,6 +1738,7 @@ components:
             - admin
             - owner
             - associated_group
+            - nearby
             - member
             - friend
             - blocked
@@ -1763,6 +1791,7 @@ components:
             - admin
             - owner
             - associated_group
+            - nearby
             - member
             - friend
             - blocked
@@ -1802,6 +1831,7 @@ components:
             - admin
             - owner
             - associated_group
+            - nearby
             - member
             - friend
             - blocked
@@ -1877,6 +1907,14 @@ components:
           type: number
           description: Maximum number of attendees allowed (null = unlimited)
           example: 100
+        registrationFeeAmount:
+          type: number
+          description: Registration fee amount in minor units (e.g. cents). Must be set together with registrationFeeCurrency.
+          example: 500
+        registrationFeeCurrency:
+          type: string
+          description: ISO 4217 currency code, lowercase (e.g. eur). Must be set together with registrationFeeAmount.
+          example: eur
       required:
         - displayName
         - visibility
@@ -1958,6 +1996,14 @@ components:
           type: string
           description: ID of the event series this instance belongs to, if any
           example: series-weekly-standup
+        registrationFeeAmount:
+          type: number
+          description: Registration fee amount in minor units (e.g. cents)
+          example: 500
+        registrationFeeCurrency:
+          type: string
+          description: ISO 4217 currency code, lowercase (e.g. eur)
+          example: eur
       required:
         - startTime
         - endTime
@@ -2009,6 +2055,14 @@ components:
           type: number
           description: Maximum number of attendees allowed (null = unlimited)
           example: 100
+        registrationFeeAmount:
+          type: object
+          description: Registration fee amount in minor units (e.g. cents). Set to null to remove the fee.
+          example: 500
+        registrationFeeCurrency:
+          type: object
+          description: ISO 4217 currency code, lowercase (e.g. eur). Set to null to remove the fee.
+          example: eur
     MutateEventEntityConnectionDto:
       type: object
       properties:
@@ -2020,6 +2074,7 @@ components:
             - admin
             - owner
             - associated_group
+            - nearby
       required:
         - type
     GetEventsDto:
@@ -2194,6 +2249,7 @@ components:
             - member
             - admin
             - owner
+            - nearby
       required:
         - type
     EventSeriesEntityConnectionDto:
@@ -2215,6 +2271,7 @@ components:
             - admin
             - owner
             - associated_group
+            - nearby
             - member
             - friend
             - blocked
@@ -2315,6 +2372,14 @@ components:
           type: number
           description: Maximum number of attendees per event instance (null = unlimited)
           example: 50
+        registrationFeeAmount:
+          type: number
+          description: Registration fee amount in minor units (e.g. cents). Must be set together with registrationFeeCurrency.
+          example: 500
+        registrationFeeCurrency:
+          type: string
+          description: ISO 4217 currency code, lowercase (e.g. eur). Must be set together with registrationFeeAmount.
+          example: eur
       required:
         - displayName
         - visibility
@@ -2403,6 +2468,14 @@ components:
           type: number
           description: Maximum number of attendees per event instance
           example: 50
+        registrationFeeAmount:
+          type: number
+          description: Registration fee amount in minor units (e.g. cents)
+          example: 500
+        registrationFeeCurrency:
+          type: string
+          description: ISO 4217 currency code, lowercase (e.g. eur)
+          example: eur
       required:
         - type
         - rrule
@@ -2449,6 +2522,14 @@ components:
           type: number
           description: Maximum number of attendees per event instance (null = unlimited)
           example: 50
+        registrationFeeAmount:
+          type: object
+          description: Registration fee amount in minor units (e.g. cents). Set to null to remove the fee.
+          example: 500
+        registrationFeeCurrency:
+          type: object
+          description: ISO 4217 currency code, lowercase (e.g. eur). Set to null to remove the fee.
+          example: eur
     GetEventSeriesDto:
       type: object
       properties:

package/package.json

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