Remove context transformers. Add provider hooks

Signed-off-by: Justin Abrahms <[email protected]>

Author: Justin Abrahms

specification.json

@@ -266,25 +266,10 @@
         {
             "id": "Requirement 2.10",
             "machine_id": "requirement_2_10",
-            "content": "The provider interface MAY define a `context transformer` method or function, which can be optionally implemented in order to transform the `evaluation context` prior to flag value resolution.",
+            "content": "The provider interface MAY define a `provider hook` method or function, which can be optionally implemented in order to add `hook` instances to the client.",
             "RFC 2119 keyword": "MAY",
             "children": []
         },
-        {
-            "id": "Condition 2.11",
-            "machine_id": "condition_2_11",
-            "content": "The implementation language supports generics (or an equivalent feature).",
-            "RFC 2119 keyword": null,
-            "children": [
-                {
-                    "id": "Conditional Requirement 2.11.1",
-                    "machine_id": "conditional_requirement_2_11_1",
-                    "content": "If the implementation includes a `context transformer`, the provider SHOULD accept a generic argument (or use an equivalent language feature) indicating the type of the transformed context.  If such type information is supplied, more accurate type information can be supplied in the flag resolution methods.",
-                    "RFC 2119 keyword": "SHOULD",
-                    "children": []
-                }
-            ]
-        },
         {
             "id": "Requirement 3.1.1",
             "machine_id": "requirement_3_1_1",
@@ -451,7 +436,7 @@
         {
             "id": "Requirement 4.4.2",
             "machine_id": "requirement_4_4_2",
-            "content": "Hooks MUST be evaluated in the following order:  - before: API, Client, Invocation - after: Invocation, Client, API - error (if applicable): Invocation, Client, API - finally: Invocation, Client, API",
+            "content": "Hooks MUST be evaluated in the following order:  - before: API, Client, Invocation, Provider - after: Provider, Invocation, Client, API - error (if applicable): Provider, Invocation, Client, API - finally: Provider, Invocation, Client, API",
             "RFC 2119 keyword": "MUST",
             "children": []
         },

specification/sections/02-providers.md

@@ -111,59 +111,22 @@ ResolutionDetails<number> resolveNumberValue(string flagKey, number defaultValue
 ResolutionDetails<MyStruct> resolveStructureValue(string flagKey, MyStruct defaultValue, context: EvaluationContext, options: FlagEvaluationOptions);
 ```
 
-#### Context Transformation
+#### Provider hooks
 
-Feature flag management systems often define structures representing arbitrary contextual data pertaining to the runtime, user, or application. The context transformer defines a simple interface to transform the OpenFeature `evaluation context` to such a structure, mapping values appropriately.
-
-See [evaluation context](./03-evaluation-context.md).
+Feature flag management systems often need to transform the context structures the user provides or general address lifecycle concerns. A `provider hook` provides a mechanism for providers to register [`Hook`s](./04-hooks.md) to tap into that lifecycle.
 
 ##### Requirement 2.10
 
-> The provider interface **MAY** define a `context transformer` method or function, which can be optionally implemented in order to transform the `evaluation context` prior to flag value resolution.
-
-The OpenFeature `client` might apply the transformer function before passing the returned value (the `transformed context`) to the provider resolution methods, thus allowing the provider implementation to avoid implementing and calling such transformation logic repeatedly in flag value resolution methods.
+> The provider interface **MAY** define a `provider hook` method or function, which can be optionally implemented in order to add `hook` instances to the client.
 
 ```typescript
 class MyProvider implements Provider {
   //...
 
-  // implementation of context transformer
-  MyProviderContext transformContext(EvaluationContext context) {
-    return new MyProviderContext(context.email, context.ip, context.httpMethod);
+  List<Hook> providerHooks() {
+    return [new MyProviderHook()];
   }
 
   //...
 }
 ```
-
-See [evaluation context](./03-evaluation-context.md), [flag evaluation](./01-flag-evaluation.md#flag-evaluation).
-
-##### Condition 2.11
-
-> The implementation language supports generics (or an equivalent feature).
-
-###### Conditional Requirement 2.11.1
-
-> If the implementation includes a `context transformer`, the provider **SHOULD** accept a generic argument (or use an equivalent language feature) indicating the type of the transformed context.
->
-> If such type information is supplied, more accurate type information can be supplied in the flag resolution methods.
-
-```typescript
-// an example implementation in a language supporting interfaces, classes, and generics
-// T represents a generic argument for the type of the transformed context
-interface Provider<T> {
-
-  //...
-
-  // context transformer signature
-  T transformContext(EvaluationContext context);
-
-  //...
-
-  // flag resolution methods context parameter type corresponds to class-generic
-  boolean resolveBooleanValue (string flagKey, boolean defaultValue, T transformedContext, EvaluationOptions options);
-
-  //...
-
-}
-```

specification/sections/04-hooks.md

@@ -132,10 +132,10 @@ client.getValue('my-flag', 'defaultValue', new Hook3());
 
 > Hooks **MUST** be evaluated in the following order:
 >
-> - before: API, Client, Invocation
-> - after: Invocation, Client, API
-> - error (if applicable): Invocation, Client, API
-> - finally: Invocation, Client, API
+> - before: API, Client, Invocation, Provider
+> - after: Provider, Invocation, Client, API
+> - error (if applicable): Provider, Invocation, Client, API
+> - finally: Provider, Invocation, Client, API
 
 #### Requirement 4.4.3