refactor: thresholds for balance threshold events

api/client/javascript/src/client/schemas.ts

@@ -7604,16 +7604,26 @@ export interface components {
       value: number
       /**
        * @description Type of the threshold.
-       * @example NUMBER
+       * @example usage_value
        */
       type: components['schemas']['NotificationRuleBalanceThresholdValueType']
     }
     /**
      * Notification balance threshold type
-     * @description Type of the rule in the balance threshold specification.
+     * @description Type of the rule in the balance threshold specification:
+     *     * `balance_value`: threshold defined by the remaining balance value based on usage and the total of grants in the current usage period
+     *     * `usage_percentage`: threshold defined by the usage percentage compared to the total of grants in the current usage period
+     *     * `usage_value`: threshold defined by the usage value in the current usage period
+     *     * `NUMBER` (**deprecated**): see `usage_value`
+     *     * `PERCENT` (**deprecated**): see `usage_percentage`
      * @enum {string}
      */
-    NotificationRuleBalanceThresholdValueType: 'PERCENT' | 'NUMBER'
+    NotificationRuleBalanceThresholdValueType:
+      | 'PERCENT'
+      | 'NUMBER'
+      | 'balance_value'
+      | 'usage_percentage'
+      | 'usage_value'
     /** @description Union type for requests creating new notification rule with certain type. */
     NotificationRuleCreateRequest:
       | components['schemas']['NotificationRuleBalanceThresholdCreateRequest']

api/client/javascript/src/zod/index.ts

@@ -9851,9 +9851,15 @@ export const createNotificationRuleBody = zod
             zod
               .object({
                 type: zod
-                  .enum(['PERCENT', 'NUMBER'])
+                  .enum([
+                    'PERCENT',
+                    'NUMBER',
+                    'balance_value',
+                    'usage_percentage',
+                    'usage_value',
+                  ])
                   .describe(
-                    'Type of the rule in the balance threshold specification.'
+                    'Type of the rule in the balance threshold specification:\n* `balance_value`: threshold defined by the remaining balance value based on usage and the total of grants in the current usage period\n* `usage_percentage`: threshold defined by the usage percentage compared to the total of grants in the current usage period\n* `usage_value`: threshold defined by the usage value in the current usage period\n* `NUMBER` (**deprecated**): see `usage_value`\n* `PERCENT` (**deprecated**): see `usage_percentage`'
                   )
                   .describe('Type of the threshold.'),
                 value: zod.coerce.number().describe('Value of the threshold.'),
@@ -10047,9 +10053,15 @@ export const updateNotificationRuleBody = zod
             zod
               .object({
                 type: zod
-                  .enum(['PERCENT', 'NUMBER'])
+                  .enum([
+                    'PERCENT',
+                    'NUMBER',
+                    'balance_value',
+                    'usage_percentage',
+                    'usage_value',
+                  ])
                   .describe(
-                    'Type of the rule in the balance threshold specification.'
+                    'Type of the rule in the balance threshold specification:\n* `balance_value`: threshold defined by the remaining balance value based on usage and the total of grants in the current usage period\n* `usage_percentage`: threshold defined by the usage percentage compared to the total of grants in the current usage period\n* `usage_value`: threshold defined by the usage value in the current usage period\n* `NUMBER` (**deprecated**): see `usage_value`\n* `PERCENT` (**deprecated**): see `usage_percentage`'
                   )
                   .describe('Type of the threshold.'),
                 value: zod.coerce.number().describe('Value of the threshold.'),

api/openapi.cloud.yaml

@@ -19454,18 +19454,30 @@ components:
           allOf:
             - $ref: '#/components/schemas/NotificationRuleBalanceThresholdValueType'
           description: Type of the threshold.
-          example: NUMBER
+          example: usage_value
       description: Threshold value with multiple supported types.
     NotificationRuleBalanceThresholdValueType:
       type: string
       enum:
         - PERCENT
         - NUMBER
-      description: Type of the rule in the balance threshold specification.
+        - balance_value
+        - usage_percentage
+        - usage_value
+      description: |-
+        Type of the rule in the balance threshold specification:
+        * `balance_value`: threshold defined by the remaining balance value based on usage and the total of grants in the current usage period
+        * `usage_percentage`: threshold defined by the usage percentage compared to the total of grants in the current usage period
+        * `usage_value`: threshold defined by the usage value in the current usage period
+        * `NUMBER` (**deprecated**): see `usage_value`
+        * `PERCENT` (**deprecated**): see `usage_percentage`
       title: Notification balance threshold type
       x-enum-varnames:
         - Percent
         - Number
+        - BalanceValue
+        - UsagePercentage
+        - UsageValue
     NotificationRuleCreateRequest:
       type: object
       oneOf:

api/openapi.yaml

@@ -20035,18 +20035,30 @@ components:
           allOf:
             - $ref: '#/components/schemas/NotificationRuleBalanceThresholdValueType'
           description: Type of the threshold.
-          example: NUMBER
+          example: usage_value
       description: Threshold value with multiple supported types.
     NotificationRuleBalanceThresholdValueType:
       type: string
       enum:
         - PERCENT
         - NUMBER
-      description: Type of the rule in the balance threshold specification.
+        - balance_value
+        - usage_percentage
+        - usage_value
+      description: |-
+        Type of the rule in the balance threshold specification:
+        * `balance_value`: threshold defined by the remaining balance value based on usage and the total of grants in the current usage period
+        * `usage_percentage`: threshold defined by the usage percentage compared to the total of grants in the current usage period
+        * `usage_value`: threshold defined by the usage value in the current usage period
+        * `NUMBER` (**deprecated**): see `usage_value`
+        * `PERCENT` (**deprecated**): see `usage_percentage`
       title: Notification balance threshold type
       x-enum-varnames:
         - Percent
         - Number
+        - BalanceValue
+        - UsagePercentage
+        - UsageValue
     NotificationRuleCreateRequest:
       type: object
       oneOf:

api/spec/src/notification/entitlements.tsp

@@ -130,19 +130,30 @@ model NotificationRuleBalanceThresholdValue {
    * Type of the threshold.
    */
   @visibility(Lifecycle.Read, Lifecycle.Create, Lifecycle.Update)
-  @example(NotificationRuleBalanceThresholdValueType.NUMBER)
+  @example(NotificationRuleBalanceThresholdValueType.usage_value)
   type: NotificationRuleBalanceThresholdValueType;
 }
 
 /**
- * Type of the rule in the balance threshold specification.
+ * Type of the rule in the balance threshold specification:
+ *   * `balance_value`: threshold defined by the remaining balance value based on usage and the total of grants in the current usage period
+ *   * `usage_percentage`: threshold defined by the usage percentage compared to the total of grants in the current usage period
+ *   * `usage_value`: threshold defined by the usage value in the current usage period
+ *   * `NUMBER` (**deprecated**): see `usage_value`
+ *   * `PERCENT` (**deprecated**): see `usage_percentage`
  */
 @summary("Notification balance threshold type")
 @friendlyName("NotificationRuleBalanceThresholdValueType")
-@extension("x-enum-varnames", #["Percent", "Number"])
+@extension(
+  "x-enum-varnames",
+  #["Percent", "Number", "BalanceValue", "UsagePercentage", "UsageValue"]
+)
 enum NotificationRuleBalanceThresholdValueType {
   PERCENT,
   NUMBER,
+  balance_value,
+  usage_percentage,
+  usage_value,
 }
 
 /**