feat: implement tracking as per spec

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

Author: toddbaert

packages/angular/angular.json

@@ -39,6 +39,7 @@
   "cli": {
     "schematicCollections": [
       "@angular-eslint/schematics"
-    ]
+    ],
+    "analytics": false
   }
 }

packages/server/src/client/client.ts

@@ -8,12 +8,14 @@ import {
 import { Features } from '../evaluation';
 import { ProviderStatus } from '../provider';
 import { ProviderEvents } from '../events';
+import { Tracking } from '../tracking';
 
 export interface Client
   extends EvaluationLifeCycle<Client>,
     Features,
     ManageContext<Client>,
     ManageLogger<Client>,
+    Tracking,
     Eventing<ProviderEvents> {
   readonly metadata: ClientMetadata;
   /**

packages/server/src/client/internal/open-feature-client.ts

@@ -9,6 +9,7 @@ import {
   HookContext,
   JsonValue,
   Logger,
+  OccurrenceDetails,
   OpenFeatureError,
   ProviderFatalError,
   ProviderNotReadyError,
@@ -221,6 +222,10 @@ export class OpenFeatureClient implements Client {
     return this.evaluate<T>(flagKey, this._provider.resolveObjectEvaluation, defaultValue, 'object', context, options);
   }
 
+  track(occurrenceKey: string, context: EvaluationContext, occurrenceDetails: OccurrenceDetails): void {
+    return this._provider.track?.(occurrenceKey, context, occurrenceDetails);
+  }
+
   private async evaluate<T extends FlagValue>(
     flagKey: string,
     resolver: (

packages/server/src/index.ts

@@ -5,4 +5,5 @@ export * from './open-feature';
 export * from './transaction-context';
 export * from './events';
 export * from './hooks';
+export * from './tracking';
 export * from '@openfeature/core';

packages/server/src/provider/provider.ts

@@ -1,4 +1,12 @@
-import { CommonProvider, EvaluationContext, JsonValue, Logger, ResolutionDetails, ServerProviderStatus } from '@openfeature/core';
+import {
+  CommonProvider,
+  EvaluationContext,
+  JsonValue,
+  Logger,
+  OccurrenceDetails,
+  ResolutionDetails,
+  ServerProviderStatus,
+} from '@openfeature/core';
 import { Hook } from '../hooks';
 
 export { ServerProviderStatus as ProviderStatus };
@@ -57,4 +65,12 @@ export interface Provider extends CommonProvider<ServerProviderStatus> {
     context: EvaluationContext,
     logger: Logger,
   ): Promise<ResolutionDetails<T>>;
+
+  /**
+   * Track a thing
+   * @param occurrenceKey
+   * @param context
+   * @param occurrenceDetails
+   */
+  track?(occurrenceKey: string, context: EvaluationContext, occurrenceDetails: OccurrenceDetails): void;
 }

packages/server/src/tracking/index.ts

@@ -0,0 +1 @@
+export * from './tracking';

packages/server/src/tracking/tracking.ts

@@ -0,0 +1,12 @@
+import { EvaluationContext, OccurrenceDetails } from '@openfeature/core';
+
+export interface Tracking {
+
+  /**
+   * Track a thing
+   * @param occurrenceKey
+   * @param context
+   * @param occurrenceDetails
+   */
+  track(occurrenceKey: string, context: EvaluationContext, occurrenceDetails: OccurrenceDetails): void;
+}

packages/shared/src/evaluation/context.ts

@@ -1,4 +1,4 @@
-import { PrimitiveValue } from './evaluation';
+import { PrimitiveValue } from '../types';
 
 export type EvaluationContextValue =
   | PrimitiveValue

packages/shared/src/evaluation/evaluation.ts

@@ -1,13 +1,6 @@
-export type FlagValueType = 'boolean' | 'string' | 'number' | 'object';
-
-export type PrimitiveValue = null | boolean | string | number;
-export type JsonObject = { [key: string]: JsonValue };
-export type JsonArray = JsonValue[];
+import { JsonValue } from '../types/structure';
 
-/**
- * Represents a JSON node value.
- */
-export type JsonValue = PrimitiveValue | JsonObject | JsonArray;
+export type FlagValueType = 'boolean' | 'string' | 'number' | 'object';
 
 /**
  * Represents a JSON node value, or Date.

packages/shared/src/index.ts

@@ -7,4 +7,5 @@ export * from './logger';
 export * from './provider';
 export * from './evaluation';
 export * from './type-guards';
+export * from './tracking';
 export * from './open-feature';