Eval #3: Interface scaffold.

server-sdk-common/src/evaluation/Evaluator.ts

@@ -0,0 +1,9 @@
+import { Queries } from './Queries';
+
+export default class Evaluator {
+  private queries: Queries;
+
+  constructor(queries: Queries) {
+    this.queries = queries;
+  }
+}

server-sdk-common/src/evaluation/Queries.ts

@@ -0,0 +1,13 @@
+import { BigSegmentStoreMembership } from '../api/interfaces';
+import { Flag } from './data/Flag';
+import { Segment } from './data/Segment';
+
+/**
+ * This interface is used by the evaluator to query data it may need during
+ * an evaluation.
+ */
+export interface Queries {
+  getFlag(key: string): Promise<Flag | null>
+  getSegment(key: string): Promise<Segment | null>
+  getBigSegmentsMembership(userKey: string): Promise<BigSegmentStoreMembership | null>
+}

server-sdk-common/src/evaluation/data/Clause.ts

@@ -0,0 +1,23 @@
+export type Op =
+  'in'
+  | 'startsWith'
+  | 'endsWith'
+  | 'contains'
+  | 'matches'
+  | 'lessThan'
+  | 'lessThanOrEqual'
+  | 'greaterThan'
+  | 'greaterThanOrEqual'
+  | 'before'
+  | 'after'
+  | 'segmentMatch'
+  | 'semVerEqual'
+  | 'semVerGreaterThan'
+  | 'semVerLessThan';
+
+export interface Clause {
+  attribute: string,
+  negate?: boolean,
+  op: Op,
+  values: any[];
+}

server-sdk-common/src/evaluation/data/ClientSideAvailability.ts

@@ -0,0 +1,4 @@
+export interface ClientSideAvailability {
+  usingMobileKey?: boolean;
+  usingEnvironmentId?: boolean;
+}

server-sdk-common/src/evaluation/data/Flag.ts

@@ -0,0 +1,25 @@
+import { ClientSideAvailability } from './ClientSideAvailability';
+import { Prerequisite } from './Prerequisite';
+import { Rollout } from './Rollout';
+import { FlagRule } from './FlagRule';
+import { Target } from './Target';
+import { Versioned } from './Versioned';
+
+type VariationOrRollout = number | Rollout;
+
+export interface Flag extends Versioned {
+  on: boolean,
+  prerequisites?: Prerequisite[];
+  targets?: Omit<Target, 'contextKind'>[],
+  contextTargets?: Target[],
+  rules?: FlagRule[],
+  fallthrough: VariationOrRollout,
+  offVariation?: number;
+  variations: any[];
+  clientSide?: boolean;
+  clientSideAvailability?: ClientSideAvailability;
+  salt?: string;
+  trackEvents?: boolean;
+  trackEventsFallthrough?: boolean;
+  debugEventsUntilDate?: number
+}

server-sdk-common/src/evaluation/data/FlagRule.ts

@@ -0,0 +1,10 @@
+import { Clause } from './Clause';
+import { Rollout } from './Rollout';
+
+export interface FlagRule {
+  id: string;
+  variation?: number;
+  rollout?: Rollout;
+  trackEvents?: boolean;
+  clauses?: Clause[];
+}

server-sdk-common/src/evaluation/data/Prerequisite.ts

@@ -0,0 +1,4 @@
+export interface Prerequisite {
+  key: string;
+  variation: number
+}

server-sdk-common/src/evaluation/data/Rollout.ts

@@ -0,0 +1,9 @@
+import { WeightedVariation } from './WeightedVariation';
+
+type RolloutKind = 'rollout' | 'experiment';
+export interface Rollout {
+  kind?: RolloutKind,
+  bucketBy?: string,
+  variations: WeightedVariation[]
+  seed?: number
+}

server-sdk-common/src/evaluation/data/Segment.ts

@@ -0,0 +1,15 @@
+import { SegmentTarget } from './SegmentTarget';
+import { Versioned } from './Versioned';
+import { SegmentRule } from './SegmentRule';
+
+export interface Segment extends Versioned {
+  included?: string[],
+  excluded?: string[],
+  includedContexts?: SegmentTarget[];
+  excludedContexts?: SegmentTarget[];
+  rules?: SegmentRule[];
+  salt?: string;
+  unbounded?: boolean;
+  unboundedContextKind?: string;
+  generation?: number;
+}

server-sdk-common/src/evaluation/data/SegmentRule.ts

@@ -0,0 +1,9 @@
+import { Clause } from './Clause';
+
+export interface SegmentRule {
+  id: string;
+  clauses: Clause[];
+  weight?: number;
+  bucketBy?: string;
+  rolloutContextKind?: string;
+}

server-sdk-common/src/evaluation/data/SegmentTarget.ts

@@ -0,0 +1,4 @@
+export interface SegmentTarget {
+  contextKind: string;
+  values: string[];
+}

server-sdk-common/src/evaluation/data/Target.ts

@@ -0,0 +1,5 @@
+export interface Target {
+  contextKind?: string;
+  values: string[],
+  variation: number
+}

server-sdk-common/src/evaluation/data/Versioned.ts

@@ -0,0 +1,7 @@
+/**
+ * Common interface for flags/segments. Versioned data we store.
+ */
+export interface Versioned {
+  key: string;
+  version: number;
+}

server-sdk-common/src/evaluation/data/WeightedVariation.ts

@@ -0,0 +1,5 @@
+export interface WeightedVariation {
+  variation: number;
+  weight: number;
+  untracked?: boolean;
+}