@flagship.io/react-sdk 3.0.2 → 3.0.3-alpha.0

package/dist/types/Flag.d.ts

@@ -1,9 +0,0 @@
-import { IFlag, IFlagMetadata } from '@flagship.io/js-sdk';
-export declare class Flag<T> implements IFlag<T> {
-    private _defaultValue;
-    constructor(defaultValue: T);
-    getValue(): T;
-    exists(): boolean;
-    userExposed(): Promise<void>;
-    get metadata(): IFlagMetadata;
-}

package/dist/types/FlagshipContext.d.ts

@@ -1,97 +0,0 @@
-import React, { ReactNode, Dispatch, SetStateAction } from "react";
-import { BucketingDTO, CampaignDTO, FlagDTO, IFlagshipConfig, primitive, Visitor } from "@flagship.io/js-sdk";
-export interface FsStatus {
-    /**
-     * Boolean. When true, the SDK is still not ready to render your App otherwise it'll use default modifications.
-     */
-    isLoading: boolean;
-    /**
-     * Boolean. true after it has fully finished initialization tasks, false otherwise.
-     */
-    isSdkReady: boolean;
-    lastModified?: Date;
-    /**
-     * Boolean. When true the flagship visitor instance is truthy, false otherwise.
-     */
-    isVisitorDefined?: boolean;
-    /**
-     * String or null. The last update date occurred on the flagship visitor instance.
-     */
-    lastRefresh?: string;
-    /**
-     * String or null. When null no initialization succeed yet. When string contains stringified date of last successful initialization.
-     */
-    firstInitSuccess?: string;
-}
-export interface FsState {
-    visitor?: Visitor;
-    config?: IFlagshipConfig;
-    modifications?: Map<string, FlagDTO>;
-    status: FsStatus;
-    initialCampaigns?: CampaignDTO[];
-    initialModifications?: Map<string, FlagDTO> | FlagDTO[];
-}
-export declare type VisitorData = {
-    id?: string;
-    context?: Record<string, primitive>;
-    isAuthenticated?: boolean;
-    hasConsented?: boolean;
-};
-interface FsContext {
-    state: FsState;
-    setState?: Dispatch<SetStateAction<FsState>>;
-}
-interface FlagshipProviderProps extends IFlagshipConfig {
-    /**
-     * This is the data to identify the current visitor using your app
-     */
-    visitorData: VisitorData | null;
-    envId: string;
-    apiKey: string;
-    /**
-     * This component will be rendered when Flagship is loading at first initialization only.
-     * By default, the value is undefined. It means it will display your app and it might
-     * display default modifications value for a very short moment.
-     */
-    loadingComponent?: ReactNode;
-    children?: ReactNode;
-    /**
-     * Callback function called when the SDK starts initialization.
-     */
-    onInitStart?(): void;
-    /**
-     * Callback function called when the SDK ends initialization.
-     */
-    onInitDone?(): void;
-    /**
-     * Callback function called when the SDK is updated. For example, after a synchronize is triggered or visitor context has changed.
-     */
-    onUpdate?(params: {
-        fsModifications: Map<string, FlagDTO>;
-        config: IFlagshipConfig;
-        status: FsStatus;
-    }): void;
-    /**
-     * This is an object of the data received when fetching bucketing endpoint.
-     * Providing this prop will make bucketing ready to use and the first polling will immediatly check for an update.
-     * If the shape of an element is not correct, an error log will give the reason why.
-     */
-    initialBucketing?: BucketingDTO;
-    initialCampaigns?: CampaignDTO[];
-    /**
-     * This is a set of flag data provided to avoid the SDK to have an empty cache during the first initialization.
-     * @deprecated use initialFlagsData instead
-     */
-    initialModifications?: Map<string, FlagDTO> | FlagDTO[];
-    /**
-     * This is a set of flag data provided to avoid the SDK to have an empty cache during the first initialization.
-     */
-    initialFlagsData?: Map<string, FlagDTO> | FlagDTO[];
-    /**
-     * If true, it'll automatically call synchronizeModifications when the bucketing file has updated
-     */
-    synchronizeOnBucketingUpdated?: boolean;
-}
-export declare const FlagshipContext: React.Context<FsContext>;
-export declare const FlagshipProvider: React.FC<FlagshipProviderProps>;
-export {};

package/dist/types/FlagshipHooks.d.ts

@@ -1,130 +0,0 @@
-import { FlagDTO, HitAbstract, HitShape, IFlag, IHit, Modification, modificationsRequested, primitive } from '@flagship.io/js-sdk';
-import { FsStatus } from './FlagshipContext';
-/**
- * Retrieve a modification value by its key. If no modification match the given key or if the stored value type and default value type do not match, default value will be returned.
- * @deprecated use useFsGetFlag instead
- */
-export declare const useFsModifications: <T extends unknown>(params: modificationsRequested<T>[], activateAll?: boolean | undefined) => Record<string, T>;
-/**
- * Retrieve a modification value by its key. If no modification match the given key or if the stored value type and default value type do not match, default value will be returned.
- * @deprecated use useFsGetFlag instead
- */
-export declare const useFsModification: {
-    <T>(params: modificationsRequested<T>): T;
-};
-/**
- * Get the campaign modification information value matching the given key.
- * @param {string} key key which identify the modification.
- * @deprecated use useFsGetFlag instead
- */
-export declare const useFsModificationInfo: {
-    (key: string): Modification | null;
-};
-/**
- * This hook returns a flag object by its key. If no flag match the given key an empty flag will be returned.
- * @param key
- * @param defaultValue
- * @returns
- */
-export declare const useFsFlag: <T extends unknown>(key: string, defaultValue: T) => IFlag<T>;
-/**
- * Report this user has seen this modification. Report this user has seen these modifications.
- * @param params
- * @deprecated use useFsGetFlag instead
- * @returns
- */
-export declare const useFsActivate: {
-    (keys: {
-        key: string;
-    }[]): Promise<void>;
-    (keys: string[]): Promise<void>;
-};
-export declare type UseFlagshipParams<T> = {
-    modifications: {
-        requested: modificationsRequested<T>[];
-        activateAll?: boolean;
-    };
-};
-export declare type UseFlagshipOutput = {
-    visitorId?: string;
-    anonymousId?: string | null;
-    context?: Record<string, primitive>;
-    hasConsented?: boolean;
-    /**
-     * Set if visitor has consented for protected data usage.
-     * @param hasConsented  True if the visitor has consented false otherwise.
-     */
-    setConsent: (hasConsented: boolean) => void;
-    modifications: Modification[];
-    FlagsData: FlagDTO[];
-    status: FsStatus;
-    /**
-     *
-     * @param params
-     * @param activateAll
-     * @deprecated use useFsGetFlag instead
-     */
-    getModifications<T>(params: modificationsRequested<T>[], activateAll?: boolean): Record<string, T>;
-    /**
-     *
-     * @param key
-     * @deprecated use useFsGetFlag instead
-     */
-    getModificationInfo(key: string): Modification | null;
-    /**
-     * @deprecated use useFsFetchFlags instead
-     */
-    synchronizeModifications(): Promise<void>;
-    /**
-     * @deprecated use useFsGetFlag instead
-     */
-    activateModification: {
-        (keys: {
-            key: string;
-        }[]): Promise<void>;
-        (keys: string[]): Promise<void>;
-    };
-    /**
-     * Update the visitor context values, matching the given keys, used for targeting.
-     * A new context value associated with this key will be created if there is no previous matching value.
-     * Context keys must be String, and values types must be one of the following : Number, Boolean, String.
-     * @param context collection of keys, values.
-     */
-    updateContext(context: Record<string, primitive>): void;
-    /**
-     * clear the actual visitor context
-     */
-    clearContext(): void;
-    /**
-     * Authenticate anonymous visitor
-     * @param visitorId
-     */
-    authenticate(visitorId: string): void;
-    /**
-     * This function change authenticated Visitor to anonymous visitor
-     * @param visitorId
-     */
-    unauthenticate(): void;
-    hit: {
-        send: {
-            (hit: HitAbstract): Promise<void>;
-            (hit: IHit): Promise<void>;
-            (hit: HitShape): Promise<void>;
-            (hit: HitAbstract | IHit | HitShape): Promise<void>;
-        };
-        sendMultiple: {
-            (hit: HitAbstract[]): Promise<void>;
-            (hit: IHit[]): Promise<void>;
-            (hit: HitShape[]): Promise<void>;
-            (hit: HitAbstract[] | IHit[] | HitShape[]): Promise<void>;
-        };
-    };
-    /**
-     * Retrieve a Flag object by its key. If no flag match the given key an empty flag will be returned.
-     * @param key flag key
-     * @param defaultValue
-     */
-    getFlag<T>(key: string, defaultValue: T): IFlag<T>;
-    fetchFlags: () => Promise<void>;
-};
-export declare const useFlagship: () => UseFlagshipOutput;

package/dist/types/constants.d.ts

@@ -1,2 +0,0 @@
-export declare const noVisitorMessage = "flagship Visitor not initialized.";
-export declare const noVisitorDefault = "fsVisitor not initialized, returns default value";

package/dist/types/utils.d.ts

@@ -1,9 +0,0 @@
-import { CampaignDTO, IFlagshipConfig, LogLevel, Modification } from '@flagship.io/js-sdk';
-import { EffectCallback, DependencyList } from 'react';
-export declare function logError(config: IFlagshipConfig | undefined, message: string, tag: string): void;
-export declare function logInfo(config: IFlagshipConfig | undefined, message: string, tag: string): void;
-export declare function logWarn(config: IFlagshipConfig | undefined, message: string, tag: string): void;
-export declare function log(level: LogLevel, message: string, tag: string): void;
-export declare const getModificationsFromCampaigns: (campaigns: Array<CampaignDTO>) => Map<string, Modification>;
-export declare function uuidV4(): string;
-export declare function useNonInitialEffect(effect: EffectCallback, deps?: DependencyList): void;