Merge branch 'main' into brtc-java-sdk

Author: smoghe-bw

.bandwidth/catalog-info.yaml

@@ -0,0 +1,11 @@
+apiVersion: backstage.io/v1alpha1
+kind: Location
+metadata:
+  schemaVersion: v1.0.0
+  name: java-sdk-location
+  description: Links to additional entities in the java-sdk repository.
+  annotations:
+    github.com/project-slug: Bandwidth/java-sdk
+spec:
+  targets:
+    - ./component.yaml

.bandwidth/component.yaml

@@ -0,0 +1,14 @@
+apiVersion: backstage.io/v1alpha1
+kind: Component
+metadata:
+  schemaVersion: v1.0.0
+  name: java-sdk
+  description: Bandwidth Java SDK
+  annotations:
+    github.com/project-slug: Bandwidth/java-sdk
+    organization: BW
+    costCenter: Development - Software Infra
+spec:
+  type: Library
+  owner: github/band-swi
+  lifecycle: Available

api/openapi.yaml

@@ -6928,7 +6928,7 @@ components:
             latestMessageDeliveryStatusDate: 2025-05-18
           - phoneNumber: "+10072904498"
             countryCodeA3: USA
-            lineType: FIXED
+            lineType: MOBILE
             voiceProvider: VERIZON
             latestMessageDeliveryStatus: DEACTIVATED
             initialMessageDeliveryStatusDate: 2025-09-05
@@ -6942,6 +6942,14 @@ components:
             deactivationDate: 2025-09-29 01:23:00
             deactivationEvent: DEACTIVATED
             latestMessageDeliveryStatus: UNKNOWN
+          - phoneNumber: "+10072904500"
+            lineType: FIXED
+            countryCodeA3: USA
+            voiceProvider: VERIZON
+            deactivationReporter: Verizon Wireless
+            deactivationDate: 2025-09-29 01:23:00
+            deactivationEvent: DEACTIVATED
+            latestMessageDeliveryStatus: NOT_ENABLED
         errors: []
     badRequestExample:
       summary: Example Bad Request Error
@@ -9330,15 +9338,17 @@ components:
       type: string
     media:
       example:
-        contentLength: 0
+        contentLength: 1024
         content: content
-        mediaName: mediaName
+        mediaName: image.png
       properties:
         content:
           type: string
         contentLength:
+          example: 1024
           type: integer
         mediaName:
+          example: image.png
           type: string
       title: Media
       type: object
@@ -10537,6 +10547,7 @@ components:
         - `inboundCallback` indicates an inbound MO message or a multichannel message client's response to a suggestion or location request.
       discriminator:
         mapping:
+          message-sending: "#/components/schemas/statusCallback"
           message-sent: "#/components/schemas/statusCallback"
           message-delivered: "#/components/schemas/statusCallback"
           message-failed: "#/components/schemas/statusCallback"
@@ -14263,10 +14274,12 @@ components:
         - ACTIVE: A message was successfully sent to the number (delivery code 0).
         - DEACTIVATED: A message was not delivered to a number (delivery code 720)
         - UNKNOWN: Bandwidth cannot find an delivery status entry for the number.
+        - NOT_ENABLED: The phone number is not enabled for messaging, so there is no delivery status information.
       enum:
       - ACTIVE
       - DEACTIVATED
       - UNKNOWN
+      - NOT_ENABLED
       type: string
     lineTypeEnum:
       enum:
@@ -14680,24 +14693,31 @@ components:
     privacyPolicyUrl:
       description: The Toll-Free Verification request privacy policy URL.
       example: http://your-company.com/privacyPolicy
+      maxLength: 500
       type: string
     termsAndConditionsUrl:
       description: The Toll-Free Verification request terms and conditions policy
         URL.
       example: http://your-company.com/termsAndConditions
+      maxLength: 500
       type: string
     businessDba:
       description: The company 'Doing Business As'.
       example: Another Company Name Inc.
+      maxLength: 500
       type: string
     businessRegistrationNumber:
-      description: Government-issued business identifying number.
+      description: |
+        Government-issued business identifying number.
+
+        **Note:** If this field is provided, it is strongly recommended to also provide `businessRegistrationType` and `businessRegistrationIssuingCountry`. Submissions missing these fields have a high likelihood of rejection.
       example: 12-3456789
       maxLength: 500
       nullable: true
       type: string
     businessRegistrationTypeEnum:
-      description: The type of business registration number.
+      description: |
+        The type of business registration number.
       enum:
       - EIN
       - CBN
@@ -14717,11 +14737,14 @@ components:
       - CNPJ
       - UID
       - OTHER
+      example: EIN
       nullable: true
       type: string
     businessRegistrationIssuingCountryEnum:
       description: |-
-        The country issuing the business registration in ISO-3166-1 alpha-3 format.
+        The country issuing the business registration in ISO-3166-1 alpha-3 format. Alpha-2 country codes are acceptable, but the application will convert them to alpha-3 when received, so alpha-3 is encouraged.
+
+        **Note:** If this field is omitted but `businessRegistrationType` is provided, the application will attempt to infer the country based on the registration type. However, if the application cannot confidently infer the country, the submission may be rejected. To ensure the highest likelihood of acceptance, it is recommended to provide both `businessRegistrationType` and `businessRegistrationIssuingCountry`.
 
         | Registration Type     | Supported Countries                |
         |----------------------|------------------------------------|
@@ -14757,17 +14780,23 @@ components:
       - DEU
       - ESP
       - CHE
+      - CYP
+      - IND
+      - CHN
+      - BGR
+      example: USA
       nullable: false
       type: string
     businessEntityTypeEnum:
-      description: "The type of registered business. If no option is applicable, please\
-        \ provide \"SOLE_PROPRIETOR\" as a value."
+      description: |
+        The type of registered business.
       enum:
       - SOLE_PROPRIETOR
       - PRIVATE_PROFIT
       - PUBLIC_PROFIT
       - NON_PROFIT
       - GOVERNMENT
+      example: PRIVATE_PROFIT
       nullable: false
       type: string
     helpMessageResponse:
@@ -14876,18 +14905,24 @@ components:
         privacyPolicyUrl:
           description: The Toll-Free Verification request privacy policy URL.
           example: http://your-company.com/privacyPolicy
+          maxLength: 500
           type: string
         termsAndConditionsUrl:
           description: The Toll-Free Verification request terms and conditions policy
             URL.
           example: http://your-company.com/termsAndConditions
+          maxLength: 500
           type: string
         businessDba:
           description: The company 'Doing Business As'.
           example: Another Company Name Inc.
+          maxLength: 500
           type: string
         businessRegistrationNumber:
-          description: Government-issued business identifying number.
+          description: |
+            Government-issued business identifying number.
+
+            **Note:** If this field is provided, it is strongly recommended to also provide `businessRegistrationType` and `businessRegistrationIssuingCountry`. Submissions missing these fields have a high likelihood of rejection.
           example: 12-3456789
           maxLength: 500
           nullable: true
@@ -14980,18 +15015,24 @@ components:
         privacyPolicyUrl:
           description: The Toll-Free Verification request privacy policy URL.
           example: http://your-company.com/privacyPolicy
+          maxLength: 500
           type: string
         termsAndConditionsUrl:
           description: The Toll-Free Verification request terms and conditions policy
             URL.
           example: http://your-company.com/termsAndConditions
+          maxLength: 500
           type: string
         businessDba:
           description: The company 'Doing Business As'.
           example: Another Company Name Inc.
+          maxLength: 500
           type: string
         businessRegistrationNumber:
-          description: Government-issued business identifying number.
+          description: |
+            Government-issued business identifying number.
+
+            **Note:** If this field is provided, it is strongly recommended to also provide `businessRegistrationType` and `businessRegistrationIssuingCountry`. Submissions missing these fields have a high likelihood of rejection.
           example: 12-3456789
           maxLength: 500
           nullable: true
@@ -15656,7 +15697,7 @@ components:
             phoneNumber: "+19192654500"
             email: foo@bar.com
           messageVolume: 10000
-          businessEntityType: SOLE_PROPRIETOR
+          businessEntityType: PRIVATE_PROFIT
           businessRegistrationType: EIN
           privacyPolicyUrl: http://your-company.com/privacyPolicy
           optInWorkflow:
@@ -15755,7 +15796,7 @@ components:
           phoneNumber: "+19192654500"
           email: foo@bar.com
         messageVolume: 10000
-        businessEntityType: SOLE_PROPRIETOR
+        businessEntityType: PRIVATE_PROFIT
         businessRegistrationType: EIN
         privacyPolicyUrl: http://your-company.com/privacyPolicy
         optInWorkflow:
@@ -15828,18 +15869,24 @@ components:
         privacyPolicyUrl:
           description: The Toll-Free Verification request privacy policy URL.
           example: http://your-company.com/privacyPolicy
+          maxLength: 500
           type: string
         termsAndConditionsUrl:
           description: The Toll-Free Verification request terms and conditions policy
             URL.
           example: http://your-company.com/termsAndConditions
+          maxLength: 500
           type: string
         businessDba:
           description: The company 'Doing Business As'.
           example: Another Company Name Inc.
+          maxLength: 500
           type: string
         businessRegistrationNumber:
-          description: Government-issued business identifying number.
+          description: |
+            Government-issued business identifying number.
+
+            **Note:** If this field is provided, it is strongly recommended to also provide `businessRegistrationType` and `businessRegistrationIssuingCountry`. Submissions missing these fields have a high likelihood of rejection.
           example: 12-3456789
           maxLength: 500
           nullable: true