@convertcom/js-sdk-rules 0.0.1 → 1.0.0

package/lib/legacy/logger/src/log-manager.d.ts

@@ -0,0 +1,64 @@
+/*!
+ * Convert JS SDK
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+import { LogLevel } from '@convertcom/js-sdk-enums';
+import { LogMethodMapInterface } from './interfaces/log-method-map';
+import { LogManagerInterface } from './interfaces/log-manager';
+/**
+ * Provides logging logic
+ * @category Modules
+ * @constructor
+ * @implements {LogManagerInterface}
+ */
+export declare class LogManager implements LogManagerInterface {
+    private _clients;
+    private _defaultMapper;
+    /**
+     * @param {any} client
+     * @param {LogLevel=} level
+     * @param {LogMethodMapInterface=} mapper
+     */
+    constructor(client?: any, level?: LogLevel, mapper?: LogMethodMapInterface);
+    private _isValidLevel;
+    private _isValidMethod;
+    private _log;
+    /**
+     * @param {LogLevel} level
+     * @param {Array<any>} args
+     */
+    log(level: LogLevel, ...args: any[]): void;
+    /**
+     * @param {Array<any>} args
+     */
+    trace(...args: any[]): void;
+    /**
+     * @param {Array<any>} args
+     */
+    debug(...args: any[]): void;
+    /**
+     * @param {Array<any>} args
+     */
+    info(...args: any[]): void;
+    /**
+     * @param {Array<any>} args
+     */
+    warn(...args: any[]): void;
+    /**
+     * @param {Array<any>} args
+     */
+    error(...args: any[]): void;
+    /**
+     * @param {any=} client
+     * @param {LogLevel=} level
+     * @param {LogMethodMapInterface=} methodMap
+     */
+    addClient(client?: any, level?: LogLevel, methodMap?: LogMethodMapInterface): void;
+    /**
+     * @param {LogLevel=} level
+     * @param {any=} client
+     */
+    setClientLevel(level: LogLevel, client?: any): void;
+}

package/lib/legacy/rules/index.d.ts

@@ -0,0 +1,8 @@
+/*!
+ * Convert JS SDK test
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+export { RuleManager } from './src/rule-manager';
+export { RuleManagerInterface } from './src/interfaces/rule-manager';

package/lib/legacy/rules/src/interfaces/rule-manager.d.ts

@@ -0,0 +1,14 @@
+/*!
+ * Convert JS SDK
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+import { Rule, RuleSet } from '@convertcom/js-sdk-types';
+import { RuleError } from '@convertcom/js-sdk-enums';
+export interface RuleManagerInterface {
+    comparisonProcessor: Record<string, any>;
+    getComparisonProcessorMethods(): Array<string>;
+    isRuleMatched(data: Record<string, any>, ruleSet: RuleSet, logEntry?: string): boolean | RuleError;
+    isValidRule(rule: Rule): boolean;
+}

package/lib/legacy/rules/src/rule-manager.d.ts

@@ -0,0 +1,75 @@
+import { RuleManagerInterface } from './interfaces/rule-manager';
+import { Config, Rule, RuleSet } from '@convertcom/js-sdk-types';
+import { LogManagerInterface } from '@convertcom/js-sdk-logger';
+import { RuleError } from '@convertcom/js-sdk-enums';
+/**
+ * Provides rule processing calculations with corresponding comparisons methods
+ * @category Modules
+ * @constructor
+ * @implements {RuleManagerInterface}
+ */
+export declare class RuleManager implements RuleManagerInterface {
+    private _comparisonProcessor;
+    private readonly _negation;
+    private readonly _keys_case_sensitive;
+    private _loggerManager;
+    /**
+     * @param {Config=} config
+     * @param {Object=} dependencies
+     * @param {LogManagerInterface=} dependencies.loggerManager
+     */
+    constructor(config?: Config, { loggerManager }?: {
+        loggerManager?: LogManagerInterface;
+    });
+    /**
+     * Setter for comparison processor
+     * @param {Record<string, any>} comparisonProcessor
+     */
+    set comparisonProcessor(comparisonProcessor: Record<string, any>);
+    /**
+     * Getter for comparison processor
+     */
+    get comparisonProcessor(): Record<string, any>;
+    /**
+     * Retrieve comparison methods from comparison processor
+     * @return {Array<string>} List of methods of comparison processor
+     */
+    getComparisonProcessorMethods(): Array<string>;
+    /**
+     * Check input data matching to rule set
+     * @param {Record<string, any>} data Single value or key-value data set to compare
+     * @param {RuleSet} ruleSet
+     * @return {boolean | RuleError}
+     */
+    isRuleMatched(data: Record<string, any>, ruleSet: RuleSet, logEntry?: string): boolean | RuleError;
+    /**
+     * Check is rule object valid
+     * @param {Rule} rule
+     * @return {boolean}
+     */
+    isValidRule(rule: Rule): boolean;
+    /**
+     * Process AND block of rule set. Return first false if found
+     * @param {Record<string, any>} data Single value or key-value data set to compare
+     * @param {RuleAnd} rulesSubset
+     * @return {boolean | RuleError}
+     * @private
+     */
+    private _processAND;
+    /**
+     * Process OR block of rule set. Return first true if found
+     * @param {Record<string, any>} data Single value or key-value data set to compare
+     * @param {RuleOrWhen} rulesSubset
+     * @return {boolean | RuleError}
+     * @private
+     */
+    private _processORWHEN;
+    /**
+     * Process single rule item
+     * @param {Record<string, any>} data Single value or key-value data set to compare
+     * @param {Rule} rule A single rule to compare
+     * @return {boolean | RuleError} Comparison result
+     * @private
+     */
+    private _processRuleItem;
+}

package/lib/legacy/types/index.d.ts

@@ -0,0 +1,36 @@
+/*!
+ * Convert JS SDK test
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+export * from './src/Audience';
+export * from './src/BucketedFeature';
+export * from './src/BucketedVariation';
+export * from './src/BucketingAttributes';
+export * from './src/Config';
+export * from './src/ConversionAttributes';
+export * from './src/Entity';
+export * from './src/Experience';
+export * from './src/Feature';
+export * from './src/Goal';
+export * from './src/Id';
+export * from './src/IndentityField';
+export * from './src/Integration';
+export * from './src/Location';
+export * from './src/Path';
+export * from './src/Project';
+export * from './src/RequireAtLeastOne';
+export * from './src/Rule';
+export * from './src/Segments';
+export * from './src/SegmentsAttributes';
+export * from './src/SegmentsData';
+export * from './src/StoreData';
+export * from './src/TrackingEvent';
+export * from './src/VariableType';
+export * from './src/Variation';
+export * from './src/VisitorsQueue';
+export * from './src/tracking/BucketingEvent';
+export * from './src/tracking/ConversionEvent';
+export * from './src/tracking/Visitor';
+export * from './src/tracking/VisitorEvent';

package/lib/legacy/types/src/Audience.d.ts

@@ -0,0 +1,16 @@
+/*!
+ * Convert JS SDK
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+import { AudienceType } from '@convertcom/js-sdk-enums';
+import { RuleSet } from './Rule';
+import { Id } from './Id';
+export type Audience = {
+    id: Id;
+    name: string;
+    key: string;
+    rules: RuleSet;
+    type: AudienceType;
+};

package/lib/legacy/types/src/BucketedFeature.d.ts

@@ -0,0 +1,30 @@
+/*!
+ * Convert JS SDK
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+import { Id } from './Id';
+import { FeatureStatus } from '@convertcom/js-sdk-enums';
+import { RequireAtLeastOne } from './RequireAtLeastOne';
+type NotEnabledFeature = RequireAtLeastOne<{
+    experienceId?: Id;
+    experienceKey?: string;
+    experienceName?: string;
+    id?: Id;
+    key?: string;
+    name?: string;
+    status: FeatureStatus.DISABLED;
+    variables?: Record<string, any>;
+}, 'id' | 'key'>;
+export type BucketedFeature = {
+    experienceId?: Id;
+    experienceKey?: string;
+    experienceName?: string;
+    id?: Id;
+    key?: string;
+    name?: string;
+    status: FeatureStatus;
+    variables?: Record<string, any>;
+} | NotEnabledFeature;
+export {};

package/lib/legacy/types/src/BucketedVariation.d.ts

@@ -0,0 +1,13 @@
+/*!
+ * Convert JS SDK
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+import { Id } from './Id';
+import { Variation } from './Variation';
+export type BucketedVariation = Variation & {
+    experienceId?: Id;
+    experienceKey?: string;
+    experienceName?: string;
+};

package/lib/legacy/types/src/BucketingAttributes.d.ts

@@ -0,0 +1,13 @@
+/*!
+ * Convert JS SDK
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+export type BucketingAttributes = {
+    environment?: string;
+    locationProperties?: Record<any, any>;
+    visitorProperties?: Record<any, any>;
+    typeCasting?: boolean;
+    experienceKeys?: Array<string>;
+};

package/lib/legacy/types/src/Config.d.ts

@@ -0,0 +1,62 @@
+/*!
+ * Convert JS SDK
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+import { Experience } from './Experience';
+import { Feature } from './Feature';
+import { Id } from './Id';
+import { Project } from './Project';
+import { Goal } from './Goal';
+import { Audience } from './Audience';
+import { Location } from './Location';
+import { LogLevel } from '@convertcom/js-sdk-enums';
+import { Segments } from './Segments';
+export type ConfigData = {
+    account_id: Id;
+    project: Project;
+    goals?: Array<Goal>;
+    locations?: Array<Location>;
+    audiences?: Array<Audience>;
+    experiences?: Array<Experience>;
+    archived_experiences?: Array<Id>;
+    features?: Array<Feature>;
+    segments?: Array<Segments>;
+};
+export type Config = {
+    environment: string;
+    api?: {
+        endpoint?: {
+            config?: string;
+            track?: string;
+        };
+    };
+    bucketing?: {
+        hash_seed?: number;
+        max_traffic?: number;
+    };
+    data: ConfigData;
+    dataStore?: object;
+    dataRefreshInterval?: number;
+    tracking?: boolean;
+    events?: {
+        batch_size?: number;
+        release_interval?: number;
+    };
+    rules?: {
+        comparisonProcessor?: Record<string, any>;
+        negation?: string;
+        keys_case_sensitive?: boolean;
+    };
+    sdkKey: string;
+    logger?: {
+        logLevel?: LogLevel;
+        file?: {
+            enabled?: boolean;
+            path?: string;
+            logLevel?: LogLevel;
+        };
+        customLoggers: Array<Record<string, any>>;
+    };
+};

package/lib/legacy/types/src/ConversionAttributes.d.ts

@@ -0,0 +1,11 @@
+/*!
+ * Convert JS SDK
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+import { GoalDataKey } from '@convertcom/js-sdk-enums';
+export type ConversionAttributes = {
+    ruleData?: Record<string, any>;
+    conversionData?: Array<Record<GoalDataKey, number>>;
+};

package/lib/legacy/types/src/Entity.d.ts

@@ -0,0 +1,13 @@
+/*!
+ * Convert JS SDK
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+import { Experience } from './Experience';
+import { Feature } from './Feature';
+import { Audience } from './Audience';
+import { Location } from './Location';
+import { Segments } from './Segments';
+import { Goal } from './Goal';
+export type Entity = Experience | Feature | Audience | Location | Segments | Goal;

package/lib/legacy/types/src/Experience.d.ts

@@ -0,0 +1,37 @@
+/*!
+ * Convert JS SDK
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+import { ExperienceType } from '@convertcom/js-sdk-enums';
+import { Id } from './Id';
+import { RuleSet } from './Rule';
+import { Variation } from './Variation';
+import { Integration } from './Integration';
+export type MultipagePages = {
+    id: Id;
+    url: string;
+};
+export type Experience = {
+    id: Id;
+    name: string;
+    key: string;
+    site_area?: RuleSet;
+    locations?: Array<Id>;
+    audiences?: Array<Id>;
+    goals?: Array<Id>;
+    type: ExperienceType;
+    version: number;
+    url: string;
+    global_js?: string;
+    global_css?: string;
+    multipage_pages?: Array<MultipagePages>;
+    variations: Array<Variation>;
+    environments: Array<string>;
+    settings?: {
+        min_order_value?: number;
+        max_order_value?: number;
+    };
+    integrations?: Array<Integration>;
+};

package/lib/legacy/types/src/Feature.d.ts

@@ -0,0 +1,18 @@
+/*!
+ * Convert JS SDK
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+import { Id } from './Id';
+import { VariableType } from './VariableType';
+export type FeatureVariableDefinition = {
+    key: string;
+    type?: VariableType;
+};
+export type Feature = {
+    id: Id;
+    name: string;
+    key: string;
+    variables: Array<FeatureVariableDefinition>;
+};

package/lib/legacy/types/src/Goal.d.ts

@@ -0,0 +1,30 @@
+/*!
+ * Convert JS SDK
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+import { RuleSet } from './Rule';
+import { Id } from './Id';
+import { GoalType, GoalRevenueTriggeringType } from '@convertcom/js-sdk-enums';
+export type GoalTrackedItem = {
+    event: string;
+    selector: string;
+};
+export type GoalSettings = {
+    percentage?: number;
+    tracked_items?: Array<GoalTrackedItem>;
+    triggering_type?: GoalRevenueTriggeringType;
+    selector?: string;
+    href?: string;
+    action?: string;
+    ga_event?: string;
+};
+export type Goal = {
+    id: Id;
+    rules?: RuleSet;
+    type: GoalType;
+    settings?: GoalSettings;
+    name: string;
+    key: string;
+};

package/lib/legacy/types/src/Id.d.ts

@@ -0,0 +1,10 @@
+/*!
+ * Convert JS SDK
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+/**
+ * A type which describes identification. String or number
+ */
+export type Id = string | number;

package/lib/{index.d.ts → legacy/types/src/IndentityField.d.ts}

@@ -1,6 +1,7 @@
 /*!
- * Convert JS SDK test
+ * Convert JS SDK
  * Version 1.0.0
  * Copyright(c) 2020 Convert Insights, Inc
  * License Apache-2.0
  */
+export type IdentityField = 'id' | 'key';

package/lib/legacy/types/src/Integration.d.ts

@@ -0,0 +1,16 @@
+/*!
+ * Convert JS SDK
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+import { GoogleAnalyticsType, IntegrationProvider } from '@convertcom/js-sdk-enums';
+export type Integration = {
+    provider: IntegrationProvider;
+    enabled?: boolean;
+    custom_dimension?: string;
+    type?: GoogleAnalyticsType;
+    measurementId?: string;
+    property_UA?: string;
+    evar?: string;
+};

package/lib/legacy/types/src/Location.d.ts

@@ -0,0 +1,14 @@
+/*!
+ * Convert JS SDK
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+import { RuleSet } from './Rule';
+import { Id } from './Id';
+export type Location = {
+    id: Id;
+    name: string;
+    key: string;
+    rules: RuleSet;
+};

package/lib/legacy/types/src/Path.d.ts

@@ -0,0 +1,10 @@
+/*!
+ * Convert JS SDK
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+export type Path = {
+    base: string;
+    route: string;
+};

package/lib/legacy/types/src/Project.d.ts

@@ -0,0 +1,37 @@
+/*!
+ * Convert JS SDK
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+import { Id } from './Id';
+import { DoNotTrack, GoogleAnalyticsType, ProjectType } from '@convertcom/js-sdk-enums';
+export type Project = {
+    id: Id;
+    name: string;
+    type: ProjectType;
+    environments: Record<string, string>;
+    utc_offset: number;
+    domains: Array<Record<string, any>>;
+    global_javascript?: string | ((...args: any) => any | undefined);
+    settings: {
+        auto_link: boolean;
+        data_anonymization: boolean;
+        do_not_track: DoNotTrack;
+        include_jquery: boolean;
+        min_order_value?: number;
+        max_order_value?: number;
+        integrations?: {
+            google_analytics?: {
+                enabled: boolean;
+                type: GoogleAnalyticsType;
+                measurementId?: string;
+                property_UA?: string;
+                auto_revenue_tracking: boolean;
+            };
+            kissmetrics?: {
+                enabled: boolean;
+            };
+        };
+    };
+};

package/lib/legacy/types/src/RequireAtLeastOne.d.ts

@@ -0,0 +1,3 @@
+export type RequireAtLeastOne<T, Keys extends keyof T = keyof T> = Pick<T, Exclude<keyof T, Keys>> & {
+    [K in Keys]-?: Required<Pick<T, K>> & Partial<Pick<T, Exclude<Keys, K>>>;
+}[Keys];

package/lib/legacy/types/src/Rule.d.ts

@@ -0,0 +1,24 @@
+/*!
+ * Convert JS SDK
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+export type Rule = {
+    rule_type?: string;
+    key?: string;
+    matching: {
+        match_type: string;
+        negated?: boolean;
+    };
+    value: string | number | boolean | ((...args: any) => any | undefined);
+};
+export type RuleOrWhen = {
+    OR_WHEN: Array<Rule>;
+};
+export type RuleAnd = {
+    AND: Array<RuleOrWhen>;
+};
+export type RuleSet = {
+    OR: Array<RuleAnd>;
+};

package/lib/legacy/types/src/Segments.d.ts

@@ -0,0 +1,14 @@
+/*!
+ * Convert JS SDK
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+import { RuleSet } from './Rule';
+import { Id } from './Id';
+export type Segments = {
+    id: Id;
+    rules: RuleSet;
+    name: string;
+    key: string;
+};

package/lib/legacy/types/src/SegmentsAttributes.d.ts

@@ -0,0 +1,9 @@
+/*!
+ * Convert JS SDK
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+export type SegmentsAttributes = {
+    ruleData?: Record<string, any>;
+};

package/lib/legacy/types/src/SegmentsData.d.ts

@@ -0,0 +1,16 @@
+/*!
+ * Convert JS SDK
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+import { BrowserType, DeviceType, SegmentsKeys, SourceType, VisitorType } from '@convertcom/js-sdk-enums';
+export type SegmentsData = {
+    [SegmentsKeys.COUNTRY]?: string;
+    [SegmentsKeys.BROWSER]?: BrowserType;
+    [SegmentsKeys.DEVICES]?: Array<DeviceType>;
+    [SegmentsKeys.SOURCE]?: SourceType;
+    [SegmentsKeys.CAMPAIGN]?: string;
+    [SegmentsKeys.VISITOR_TYPE]?: VisitorType;
+    [SegmentsKeys.CUSTOM_SEGMENTS]?: Array<string>;
+};

package/lib/legacy/types/src/StoreData.d.ts

@@ -0,0 +1,14 @@
+/*!
+ * Convert JS SDK
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+import { Id } from './Id';
+import { SegmentsData } from './SegmentsData';
+export type StoreData = {
+    bucketing?: Record<string, Id>;
+    locations?: Array<Id>;
+    segments?: SegmentsData;
+    goals?: Record<string, boolean>;
+};

package/lib/legacy/types/src/TrackingEvent.d.ts

@@ -0,0 +1,14 @@
+/*!
+ * Convert JS SDK
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+import { Id } from './Id';
+import { Visitor } from './tracking/Visitor';
+export type TrackingEvent = {
+    accountId?: Id;
+    projectId?: Id;
+    enrichData?: boolean;
+    visitors: Array<Visitor>;
+};

package/lib/legacy/types/src/VariableType.d.ts

@@ -0,0 +1,8 @@
+/*!
+ * Convert JS SDK
+ * Version 1.0.0
+ * Copyright(c) 2020 Convert Insights, Inc
+ * License Apache-2.0
+ */
+import { VARIABLE_TYPES } from '@convertcom/js-sdk-enums';
+export type VariableType = (typeof VARIABLE_TYPES)[number];