feat: add STALE pre-defined reason (#898)

Adds STALE pre-defined reason, re-orders reasons in source to match
spec.

Signed-off-by: Todd Baert <[email protected]>

Author: toddbaert

packages/shared/src/evaluation/evaluation.ts

@@ -38,6 +38,16 @@ export type EvaluationDetails<T extends FlagValue> = {
 } & ResolutionDetails<T>;
 
 export const StandardResolutionReasons = {
+  /**
+   * The resolved value is static (no dynamic evaluation).
+   */
+  STATIC: 'STATIC',
+
+  /**
+   *  The resolved value was configured statically, or otherwise fell back to a pre-configured value.
+   */
+  DEFAULT: 'DEFAULT',
+
   /**
    * The resolved value was the result of a dynamic evaluation, such as a rule or specific user-targeting.
    */
@@ -49,29 +59,24 @@ export const StandardResolutionReasons = {
   SPLIT: 'SPLIT',
 
   /**
-   * The resolved value was the result of the flag being disabled in the management system.
+   * The resolved value was retrieved from cache.
    */
-  DISABLED: 'DISABLED',
+  CACHED: 'CACHED',
 
   /**
-   *  The resolved value was configured statically, or otherwise fell back to a pre-configured value.
+   * The resolved value was the result of the flag being disabled in the management system.
    */
-  DEFAULT: 'DEFAULT',
+  DISABLED: 'DISABLED',
 
   /**
    * The reason for the resolved value could not be determined.
    */
   UNKNOWN: 'UNKNOWN',
 
   /**
-   * The resolved value is static (no dynamic evaluation).
-   */
-  STATIC: 'STATIC',
-
-  /**
-   * The resolved value was retrieved from cache.
+   * The resolved value is non-authoritative or possibly out of date.
    */
-  CACHED: 'CACHED',
+  STALE: 'STALE',
 
   /**
    * The resolved value was the result of an error.