flowgrid-sdk 1.1.0 → 1.2.1

package/dist/lib/features/core/feature-flag.d.ts

@@ -1,249 +0,0 @@
-/**
- * @fileoverview Core - Feature Flags
- * @module features/core/feature-flag
- *
- * @description
- * Track feature flag evaluations and usage to understand
- * rollout progress and flag performance.
- *
- * @useCases
- * - Track flag evaluations
- * - Monitor rollout progress
- * - Analyze flag impact
- * - Debug flag configurations
- * - Measure gradual rollouts
- *
- * @metrics
- * - Evaluations per flag
- * - Unique users per variant
- * - Rollout percentage
- * - Error rate
- * - Flag age
- *
- * @chartData
- * - Pie chart: Users by variant
- * - Line chart: Evaluations over time
- * - Table: Active flags summary
- * - Bar chart: Top evaluated flags
- *
- * @example
- * ```typescript
- * const featureFlag = new FeatureFlag(webId, endpoint, apiKey);
- *
- * await featureFlag.evaluate({
- *   eventName: 'new_dashboard',
- *   properties: { userId: 'user_123', result: true }
- * });
- * ```
- */
-import { FTRPC } from "../../client/ftrpc";
-import { TimeSeriesData } from "../../types";
-/**
- * Base feature flag configuration.
- */
-export interface FlagConfig {
-    /** Flag name/event */
-    eventName: string;
-    /** Evaluation properties */
-    properties: Record<string, unknown>;
-}
-/**
- * Feature flag definition.
- */
-export interface FlagDefinition {
-    /** Flag key */
-    flagKey: string;
-    /** Flag name */
-    name: string;
-    /** Description */
-    description?: string;
-    /** Flag type */
-    type: 'boolean' | 'string' | 'number' | 'json';
-    /** Default value */
-    defaultValue: boolean | string | number | Record<string, unknown>;
-    /** Variants (for multivariate flags) */
-    variants?: Array<{
-        key: string;
-        value: boolean | string | number | Record<string, unknown>;
-        weight?: number;
-    }>;
-    /** Targeting rules */
-    targeting?: {
-        rules: Array<{
-            attribute: string;
-            operator: 'equals' | 'contains' | 'in' | 'gt' | 'lt';
-            value: unknown;
-            variant: string;
-        }>;
-    };
-    /** Rollout percentage (0-100) */
-    rolloutPercentage?: number;
-}
-/**
- * Flag evaluation configuration.
- */
-export interface FlagEvaluationConfig {
-    /** Flag key */
-    flagKey: string;
-    /** User ID */
-    userId?: string;
-    /** Evaluation context */
-    context?: Record<string, unknown>;
-    /** Evaluated variant/value */
-    result: boolean | string | number | Record<string, unknown>;
-    /** Reason for evaluation result */
-    reason?: 'default' | 'targeting' | 'rollout' | 'override' | 'error';
-    /** Evaluation duration (ms) */
-    duration?: number;
-}
-/**
- * Feature flag response.
- */
-export interface FlagResponse {
-    eventName: string;
-    properties: Record<string, unknown>;
-    response: {
-        tracked: boolean;
-        flagKey?: string;
-    };
-    timestamp: string;
-}
-/**
- * Single flag analytics.
- */
-export interface FlagAnalyticsData {
-    /** Flag info */
-    flag: {
-        flagKey: string;
-        name: string;
-        type: string;
-        status: 'active' | 'inactive' | 'archived';
-        createdAt: string;
-        lastModified: string;
-    };
-    /** Evaluation stats */
-    evaluations: {
-        total: number;
-        uniqueUsers: number;
-        avgDuration: number;
-        errorRate: number;
-    };
-    /** Results by variant */
-    byVariant: Array<{
-        variant: string;
-        evaluations: number;
-        uniqueUsers: number;
-        percentage: number;
-    }>;
-    /** Results by reason */
-    byReason: Record<string, number>;
-    /** Trends */
-    trends: TimeSeriesData;
-}
-/**
- * All flags analytics.
- */
-export interface AllFlagsAnalyticsData {
-    /** Summary */
-    summary: {
-        totalFlags: number;
-        activeFlags: number;
-        totalEvaluations: number;
-        uniqueUsers: number;
-        avgEvaluationsPerUser: number;
-    };
-    /** Top flags by evaluations */
-    topFlags: Array<{
-        flagKey: string;
-        name: string;
-        evaluations: number;
-        uniqueUsers: number;
-        rolloutPercentage: number;
-    }>;
-    /** Stale flags (not evaluated recently) */
-    staleFlags: Array<{
-        flagKey: string;
-        name: string;
-        lastEvaluated: string;
-        daysSinceEvaluation: number;
-    }>;
-    /** Flags by status */
-    byStatus: {
-        active: number;
-        inactive: number;
-        archived: number;
-    };
-}
-/**
- * FeatureFlag - Track feature flag evaluations.
- *
- * @extends FTRPC
- *
- * @description
- * Provides feature flag tracking including:
- * - Flag evaluations
- * - Rollout monitoring
- * - Flag definitions
- * - Usage analytics
- * - Stale flag detection
- *
- * @example
- * ```typescript
- * const featureFlag = new FeatureFlag(webId, endpoint, apiKey);
- *
- * // Track evaluation
- * await featureFlag.trackEvaluation({
- *   flagKey: 'new_checkout',
- *   userId: 'user_123',
- *   result: true,
- *   reason: 'rollout'
- * });
- *
- * // Get flag analytics
- * const analytics = await featureFlag.getFlagAnalytics('new_checkout');
- * console.log(`${analytics.evaluations.total} evaluations`);
- * ```
- */
-export declare class FeatureFlag extends FTRPC {
-    /**
-     * Evaluates and tracks a feature flag.
-     *
-     * @param config - Flag configuration
-     * @returns Promise resolving to flag response
-     */
-    evaluate(config: FlagConfig): Promise<FlagResponse>;
-    /**
-     * Tracks a flag evaluation with details.
-     *
-     * @param config - Flag evaluation configuration
-     * @returns Promise resolving to flag response
-     */
-    trackEvaluation(config: FlagEvaluationConfig): Promise<FlagResponse>;
-    /**
-     * Defines/updates a feature flag.
-     *
-     * @param definition - Flag definition
-     * @returns Promise resolving to flag response
-     */
-    define(definition: FlagDefinition): Promise<FlagResponse>;
-    /**
-     * Tracks flag status change (enable/disable).
-     *
-     * @param flagKey - Flag key
-     * @param enabled - Whether flag is enabled
-     * @param changedBy - User who made the change
-     * @returns Promise resolving to flag response
-     */
-    trackStatusChange(flagKey: string, enabled: boolean, changedBy?: string): Promise<FlagResponse>;
-    /**
-     * Tracks rollout percentage change.
-     *
-     * @param flagKey - Flag key
-     * @param previousPercentage - Previous rollout %
-     * @param newPercentage - New rollout %
-     * @param changedBy - User who made the change
-     * @returns Promise resolving to flag response
-     */
-    trackRolloutChange(flagKey: string, previousPercentage: number, newPercentage: number, changedBy?: string): Promise<FlagResponse>;
-}
-export default FeatureFlag;

package/dist/lib/utils/functions.d.ts

@@ -1 +0,0 @@
-export declare function _0x7777(): string;