flowgrid-sdk 1.0.2 → 1.2.0

package/dist/lib/features/ecommerce/subscriptions.d.ts

@@ -40,7 +40,7 @@
  * });
  * ```
  */
-import { FTRPC } from "../../client/ftrpc";
+import { FlowGridTransport } from "../../client/transport";
 import { MoneyValue, DateRangeFilter, TimeSeriesData } from "../../types";
 /**
  * Subscription start configuration.
@@ -165,7 +165,7 @@ export interface SubscriptionAnalyticsData {
 /**
  * Subscriptions - Track subscription lifecycle events.
  *
- * @extends FTRPC
+ * @extends FlowGridTransport
  *
  * @description
  * Provides subscription tracking including:
@@ -201,7 +201,7 @@ export interface SubscriptionAnalyticsData {
  * });
  * ```
  */
-export declare class Subscriptions extends FTRPC {
+export declare class Subscriptions extends FlowGridTransport {
     /**
      * Tracks subscription start.
      *

package/dist/lib/features/ecommerce/wishlist.d.ts

@@ -37,7 +37,7 @@
  * });
  * ```
  */
-import { FTRPC } from "../../client/ftrpc";
+import { FlowGridTransport } from "../../client/transport";
 import { Product, Wishlist, DateRangeFilter, TimeSeriesData } from "../../types";
 /**
  * Configuration for adding to wishlist.
@@ -112,7 +112,7 @@ export interface WishlistAnalyticsData {
 /**
  * WishlistTracking - Track wishlist interactions.
  *
- * @extends FTRPC
+ * @extends FlowGridTransport
  *
  * @description
  * Provides wishlist tracking capabilities including:
@@ -144,7 +144,7 @@ export interface WishlistAnalyticsData {
  * });
  * ```
  */
-export declare class WishlistTracking extends FTRPC {
+export declare class WishlistTracking extends FlowGridTransport {
     /**
      * Tracks adding product to wishlist.
      *

package/dist/lib/features/enterprise/acquisition.d.ts

@@ -38,7 +38,7 @@
  * });
  * ```
  */
-import { EnterpriseFTRPC } from "../../client/enterprise-ftrpc";
+import { FlowGridTransport } from "../../client/transport";
 import { DateRangeFilter, TimeSeriesData, TimeGranularity, MoneyValue, CurrencyCode } from "../../types";
 /**
  * Acquisition source types.
@@ -290,7 +290,7 @@ export declare function classifySource(utmSource?: string, utmMedium?: string):
 /**
  * Marketing and acquisition analytics class.
  */
-export declare class AcquisitionAnalytics extends EnterpriseFTRPC {
+export declare class AcquisitionAnalytics extends FlowGridTransport {
     /**
      * Track user acquisition.
      */

package/dist/lib/features/enterprise/alerts.d.ts

@@ -40,7 +40,7 @@
  * });
  * ```
  */
-import { EnterpriseFTRPC } from "../../client/enterprise-ftrpc";
+import { FlowGridTransport } from "../../client/transport";
 import { DateRangeFilter, TimeSeriesData, TimeGranularity } from "../../types";
 /**
  * Alert condition types.
@@ -244,7 +244,7 @@ export declare function checkAlertCondition(currentValue: number, condition: Ale
 /**
  * Alerts and anomaly detection class.
  */
-export declare class AlertsAnalytics extends EnterpriseFTRPC {
+export declare class AlertsAnalytics extends FlowGridTransport {
     /**
      * Create an alert rule.
      */

package/dist/lib/features/enterprise/churn.d.ts

@@ -37,7 +37,7 @@
  * const atRisk = await churn.getAtRiskUsers({ minScore: 70 });
  * ```
  */
-import { EnterpriseFTRPC } from "../../client/enterprise-ftrpc";
+import { FlowGridTransport } from "../../client/transport";
 import { DateRangeFilter, TimeSeriesData, TimeGranularity } from "../../types";
 /**
  * Churn risk factors.
@@ -214,7 +214,7 @@ export declare function generateRecommendations(riskFactors: Array<{
 /**
  * Churn and predictive analytics class.
  */
-export declare class ChurnAnalytics extends EnterpriseFTRPC {
+export declare class ChurnAnalytics extends FlowGridTransport {
     /**
      * Get user churn risk score.
      */

package/dist/lib/features/enterprise/cohorts.d.ts

@@ -38,7 +38,7 @@
  * });
  * ```
  */
-import { EnterpriseFTRPC } from "../../client/enterprise-ftrpc";
+import { FlowGridTransport } from "../../client/transport";
 import { DateRangeFilter, TimeSeriesData, TimeGranularity } from "../../types";
 /**
  * Cohort rule operators.
@@ -196,7 +196,7 @@ export declare function generateCohortId(name: string): string;
 /**
  * Advanced cohorts and segmentation class.
  */
-export declare class Cohorts extends EnterpriseFTRPC {
+export declare class Cohorts extends FlowGridTransport {
     /**
      * Create a new cohort.
      */

package/dist/lib/features/enterprise/engagement.d.ts

@@ -38,8 +38,8 @@
  * });
  * ```
  */
-import { EnterpriseFTRPC } from "../../client/enterprise-ftrpc";
-import { DateRangeFilter, TimeSeriesData, TimeGranularity } from "../../types";
+import { FlowGridTransport } from "../../client/transport";
+import { DateRangeFilter, TimeSeriesData, TimeGranularity, ActiveUsersConfig, ActiveUsersResponse, ActiveUserRatios } from "../../types";
 /**
  * Configuration for tracking feature dwell time.
  */
@@ -185,7 +185,7 @@ export declare function calculateSessionDepthScore(pagesVisited: number, feature
 /**
  * Engagement analytics tracking class.
  */
-export declare class Engagement extends EnterpriseFTRPC {
+export declare class Engagement extends FlowGridTransport {
     /**
      * Track feature dwell time.
      */
@@ -230,4 +230,25 @@ export declare class Engagement extends EnterpriseFTRPC {
         avgDwellTime: number;
         uniqueUsers: number;
     }>>;
+    /**
+     * Get active users at any granularity (day, week, month).
+     */
+    getActiveUsers(config: ActiveUsersConfig): Promise<ActiveUsersResponse>;
+    /**
+     * Get daily active users.
+     */
+    getDAU(filter?: DateRangeFilter): Promise<ActiveUsersResponse>;
+    /**
+     * Get weekly active users.
+     */
+    getWAU(filter?: DateRangeFilter): Promise<ActiveUsersResponse>;
+    /**
+     * Get monthly active users.
+     */
+    getMAU(filter?: DateRangeFilter): Promise<ActiveUsersResponse>;
+    /**
+     * Get DAU/WAU/MAU stickiness ratios.
+     * Fetches all three in parallel and computes ratios (guards division by zero).
+     */
+    getActiveUserRatios(filter?: DateRangeFilter): Promise<ActiveUserRatios>;
 }

package/dist/lib/features/enterprise/forecasting.d.ts

@@ -38,7 +38,7 @@
  * });
  * ```
  */
-import { EnterpriseFTRPC } from "../../client/enterprise-ftrpc";
+import { FlowGridTransport } from "../../client/transport";
 import { DateRangeFilter, TimeGranularity, MoneyValue, CurrencyCode } from "../../types";
 /**
  * Forecast model types.
@@ -265,7 +265,7 @@ export declare function applyConfidenceInterval(predicted: number, stdError: num
 /**
  * Product usage forecasting class.
  */
-export declare class Forecasting extends EnterpriseFTRPC {
+export declare class Forecasting extends FlowGridTransport {
     /**
      * Forecast active users.
      */

package/dist/lib/features/enterprise/monetization.d.ts

@@ -43,7 +43,7 @@
  * });
  * ```
  */
-import { EnterpriseFTRPC } from "../../client/enterprise-ftrpc";
+import { FlowGridTransport } from "../../client/transport";
 import { DateRangeFilter, TimeSeriesData, TimeGranularity, MoneyValue, CurrencyCode } from "../../types";
 /**
  * Revenue event types.
@@ -274,7 +274,7 @@ export declare function calculateLTV(arpu: number, monthlyChurnRate: number, cur
 /**
  * Revenue and monetization analytics class.
  */
-export declare class Monetization extends EnterpriseFTRPC {
+export declare class Monetization extends FlowGridTransport {
     /**
      * Track revenue event.
      */

package/dist/lib/features/enterprise/multi-path-funnels.d.ts

@@ -40,7 +40,7 @@
  * });
  * ```
  */
-import { EnterpriseFTRPC } from "../../client/enterprise-ftrpc";
+import { FlowGridTransport } from "../../client/transport";
 import { DateRangeFilter, TimeSeriesData, TimeGranularity } from "../../types";
 /**
  * Funnel path definition.
@@ -254,7 +254,7 @@ export declare function generatePathId(steps: string[]): string;
 /**
  * Multi-path funnels and micro-conversions class.
  */
-export declare class MultiPathFunnels extends EnterpriseFTRPC {
+export declare class MultiPathFunnels extends FlowGridTransport {
     /**
      * Define a multi-path funnel.
      */

package/dist/lib/features/enterprise/paths.d.ts

@@ -38,7 +38,7 @@
  * });
  * ```
  */
-import { EnterpriseFTRPC } from "../../client/enterprise-ftrpc";
+import { FlowGridTransport } from "../../client/transport";
 import { DateRangeFilter, TimeSeriesData, TimeGranularity } from "../../types";
 /**
  * Screen/page transition configuration.
@@ -251,7 +251,7 @@ export declare function findCommonSubPaths(paths: string[][], minLength?: number
 /**
  * Behavioral analytics and path analysis class.
  */
-export declare class PathAnalytics extends EnterpriseFTRPC {
+export declare class PathAnalytics extends FlowGridTransport {
     /**
      * Track screen/page transition.
      */

package/dist/lib/features/enterprise/security.d.ts

@@ -38,7 +38,7 @@
  * });
  * ```
  */
-import { EnterpriseFTRPC } from "../../client/enterprise-ftrpc";
+import { FlowGridTransport } from "../../client/transport";
 import { DateRangeFilter, TimeSeriesData, TimeGranularity } from "../../types";
 /**
  * Security event types.
@@ -274,7 +274,7 @@ export declare function determineEventSeverity(eventType: SecurityEventType, suc
 /**
  * Security and compliance analytics class.
  */
-export declare class SecurityAnalytics extends EnterpriseFTRPC {
+export declare class SecurityAnalytics extends FlowGridTransport {
     /**
      * Track login attempt.
      */

package/dist/lib/features/enterprise/support.d.ts

@@ -39,7 +39,7 @@
  * });
  * ```
  */
-import { EnterpriseFTRPC } from "../../client/enterprise-ftrpc";
+import { FlowGridTransport } from "../../client/transport";
 import { DateRangeFilter, TimeSeriesData, TimeGranularity } from "../../types";
 /**
  * Ticket priority levels.
@@ -248,7 +248,7 @@ export declare function formatDuration(ms: number): string;
 /**
  * Customer support and experience analytics class.
  */
-export declare class SupportAnalytics extends EnterpriseFTRPC {
+export declare class SupportAnalytics extends FlowGridTransport {
     /**
      * Track new support ticket.
      */

package/dist/lib/frameworks/nextjs/client.d.ts

@@ -26,11 +26,12 @@
  * ```
  */
 import { type ReactNode } from 'react';
-import { Activation, TrackFeature, TrackPrompt, Experiment, FeatureFlag, PageViews, Sessions, Events, Identify, Funnels, Products, CartTracking, Checkout, Purchases } from '../../../index';
+import { Activation, TrackFeature, TrackPrompt, Experiment, PageViews, Sessions, Events, Identify, Funnels, Products, CartTracking, Checkout, Purchases } from '../../../index';
 export interface FlowGridConfig {
     webId: string;
     endpoint: string;
     apiKey: string;
+    visitorId?: string;
     autoTrackPageViews?: boolean;
     autoTrackSessions?: boolean;
     debug?: boolean;
@@ -40,7 +41,6 @@ export interface FlowGridContextValue {
     trackFeature: TrackFeature;
     trackPrompt: TrackPrompt;
     experiment: Experiment;
-    featureFlag: FeatureFlag;
     pageViews: PageViews;
     sessions: Sessions;
     events: Events;
@@ -94,7 +94,7 @@ export interface FlowGridProviderProps extends FlowGridConfig {
  * }
  * ```
  */
-export declare function FlowGridProvider({ children, webId, endpoint, apiKey, autoTrackPageViews, autoTrackSessions, debug }: FlowGridProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function FlowGridProvider({ children, webId, endpoint, apiKey, visitorId, autoTrackPageViews, autoTrackSessions, debug }: FlowGridProviderProps): import("react/jsx-runtime").JSX.Element;
 /**
  * Access the FlowGrid SDK instance.
  */
@@ -127,15 +127,6 @@ export declare function useExperiment(experimentId: string, userId: string): {
     variant: string | null;
     isLoading: boolean;
 };
-/**
- * Evaluate a feature flag.
- */
-export declare function useFeatureFlag(flagKey: string, context?: {
-    userId?: string;
-}): {
-    isEnabled: boolean;
-    isLoading: boolean;
-};
 /**
  * Identify user.
  */
@@ -195,14 +186,17 @@ export declare function useEcommerce(): {
  * ```
  */
 export declare function PageViewTracker(): null;
+import { CookieBanner as _CookieBanner } from '../react/CookieBanner';
+export { CookieBanner } from '../react/CookieBanner';
+export type { CookieBannerProps } from '../react/CookieBanner';
 declare const _default: {
     FlowGridProvider: typeof FlowGridProvider;
     useFlowGrid: typeof useFlowGrid;
     useTrackEvent: typeof useTrackEvent;
     useExperiment: typeof useExperiment;
-    useFeatureFlag: typeof useFeatureFlag;
     useIdentify: typeof useIdentify;
     useEcommerce: typeof useEcommerce;
     PageViewTracker: typeof PageViewTracker;
+    CookieBanner: typeof _CookieBanner;
 };
 export default _default;

package/dist/lib/frameworks/nextjs/server.d.ts

@@ -21,18 +21,21 @@
  * }
  * ```
  */
-import { Activation, TrackFeature, TrackPrompt, Experiment, FeatureFlag, PageViews, Sessions, Events, Identify, Funnels, Purchases, Subscriptions, CustomerLTV } from '../../../index';
+import { Activation, TrackFeature, TrackPrompt, Experiment, PageViews, Sessions, Events, Identify, Funnels, Purchases, Subscriptions, CustomerLTV } from '../../../index';
+import { type ServerCookieReader } from '../../utils/identity';
 export interface ServerFlowGridConfig {
     webId: string;
     endpoint: string;
     apiKey: string;
+    visitorId?: string;
+    /** Next.js `cookies()` for reading visitor identity from the request */
+    cookies?: ServerCookieReader;
 }
 export interface ServerFlowGridInstance {
     activation: Activation;
     trackFeature: TrackFeature;
     trackPrompt: TrackPrompt;
     experiment: Experiment;
-    featureFlag: FeatureFlag;
     pageViews: PageViews;
     sessions: Sessions;
     events: Events;
@@ -70,7 +73,6 @@ export declare const flowgrid: {
     readonly purchases: Purchases;
     readonly subscriptions: Subscriptions;
     readonly experiment: Experiment;
-    readonly featureFlag: FeatureFlag;
     readonly activation: Activation;
     readonly trackFeature: TrackFeature;
     readonly trackPrompt: TrackPrompt;
@@ -136,16 +138,6 @@ export declare function trackServerPurchase(order: {
         quantity: number;
     }>;
 }): Promise<void>;
-/**
- * Evaluate a feature flag server-side.
- *
- * @example
- * ```ts
- * // In a Server Component or API route
- * const isEnabled = await evaluateServerFlag('new_feature', userId);
- * ```
- */
-export declare function evaluateServerFlag(flagKey: string, userId?: string, context?: Record<string, unknown>): Promise<boolean>;
 /**
  * Get experiment variant server-side.
  *
@@ -184,7 +176,6 @@ declare const _default: {
         readonly purchases: Purchases;
         readonly subscriptions: Subscriptions;
         readonly experiment: Experiment;
-        readonly featureFlag: FeatureFlag;
         readonly activation: Activation;
         readonly trackFeature: TrackFeature;
         readonly trackPrompt: TrackPrompt;
@@ -194,7 +185,6 @@ declare const _default: {
     trackServerEvent: typeof trackServerEvent;
     identifyServerUser: typeof identifyServerUser;
     trackServerPurchase: typeof trackServerPurchase;
-    evaluateServerFlag: typeof evaluateServerFlag;
     getServerExperimentVariant: typeof getServerExperimentVariant;
     createTrackedAction: typeof createTrackedAction;
 };

package/dist/lib/frameworks/node/index.d.ts

@@ -23,11 +23,12 @@
  * await flowgrid.track('user_signed_up', { userId: 'user_123' });
  * ```
  */
-import { Activation, TrackFeature, TrackPrompt, Experiment, FeatureFlag, Events, Identify, Funnels, Purchases, Refunds, Subscriptions, CustomerLTV, Inventory } from '../../../index';
+import { Activation, TrackFeature, TrackPrompt, Experiment, Events, Identify, Funnels, Purchases, Refunds, Subscriptions, CustomerLTV, Inventory } from '../../../index';
 export interface FlowGridConfig {
     webId: string;
     endpoint: string;
     apiKey: string;
+    visitorId?: string;
     /** Flush events in batches (default: true) */
     batchEvents?: boolean;
     /** Batch size before auto-flush (default: 100) */
@@ -87,7 +88,6 @@ export declare class FlowGrid {
     readonly trackFeature: TrackFeature;
     readonly trackPrompt: TrackPrompt;
     readonly experiment: Experiment;
-    readonly featureFlag: FeatureFlag;
     readonly events: Events;
     readonly identify: Identify;
     readonly funnels: Funnels;
@@ -215,10 +215,6 @@ export declare class FlowGrid {
      * Get experiment variant for a user.
      */
     getExperimentVariant(experimentId: string, userId: string): Promise<string>;
-    /**
-     * Evaluate a feature flag.
-     */
-    evaluateFlag(flagKey: string, userId?: string, defaultValue?: boolean): Promise<boolean>;
 }
 /**
  * Express middleware for automatic request tracking.

package/dist/lib/frameworks/nuxt/index.d.ts

@@ -35,11 +35,12 @@
  */
 export * from '../vue/index';
 import { type Ref } from 'vue';
-import { Activation, TrackFeature, TrackPrompt, Experiment, FeatureFlag, PageViews, Sessions, Events, Identify, Funnels, Products, CartTracking, Checkout, Purchases, Subscriptions, CustomerLTV } from '../../../index';
+import { Activation, TrackFeature, TrackPrompt, Experiment, PageViews, Sessions, Events, Identify, Funnels, Products, CartTracking, Checkout, Purchases, Subscriptions, CustomerLTV } from '../../../index';
 export interface NuxtFlowGridConfig {
     webId: string;
     endpoint: string;
     apiKey: string;
+    visitorId?: string;
     autoTrackPageViews?: boolean;
     autoTrackSessions?: boolean;
     debug?: boolean;
@@ -76,7 +77,6 @@ export declare function createFlowGridPlugin(config: NuxtFlowGridConfig): {
     trackFeature: TrackFeature;
     trackPrompt: TrackPrompt;
     experiment: Experiment;
-    featureFlag: FeatureFlag;
     pageViews: PageViews;
     sessions: Sessions;
     events: Events;
@@ -146,12 +146,16 @@ export declare function createServerFlowGrid(config: {
     webId: string;
     endpoint: string;
     apiKey: string;
+    visitorId?: string;
+    /** Nuxt server cookie reader (e.g. from getCookie or parseCookies) */
+    cookies?: {
+        get(name: string): string | undefined | null;
+    };
 }): {
     activation: Activation;
     trackFeature: TrackFeature;
     trackPrompt: TrackPrompt;
     experiment: Experiment;
-    featureFlag: FeatureFlag;
     events: Events;
     identify: Identify;
     funnels: Funnels;

package/dist/lib/frameworks/react/CookieBanner.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @fileoverview FlowGrid Cookie Banner — React Component
+ * @module frameworks/react/CookieBanner
+ *
+ * @description
+ * A customisable cookie consent banner for React applications.
+ * Works with the FlowGrid {@link ConsentManager} to persist user
+ * choices and gate analytics/marketing tracking.
+ *
+ * @example
+ * ```tsx
+ * import { CookieBanner } from 'flowgrid-sdk/react';
+ * import { ConsentManager, FlowGridTransport } from 'flowgrid-sdk';
+ *
+ * const consent = new ConsentManager({
+ *   onChange: (prefs) => {
+ *     FlowGridTransport.setConsent({
+ *       analytics: prefs.analytics,
+ *       marketing: prefs.marketing,
+ *     });
+ *   },
+ * });
+ *
+ * function App() {
+ *   return (
+ *     <>
+ *       <MyApp />
+ *       <CookieBanner
+ *         consent={consent}
+ *         config={{
+ *           title: 'We use cookies',
+ *           description: 'We use cookies to improve your experience and analyse traffic.',
+ *           privacyPolicyUrl: '/privacy',
+ *           theme: { position: 'bottom', primaryColor: '#4F46E5' },
+ *         }}
+ *       />
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+import type { ConsentManager } from '../../consent/manager';
+import type { CookieBannerConfig } from '../../consent/types';
+/**
+ * Props for the {@link CookieBanner} component.
+ */
+export interface CookieBannerProps {
+    /** The {@link ConsentManager} instance. */
+    consent: ConsentManager;
+    /** Banner configuration and theme. */
+    config?: CookieBannerConfig;
+    /** Called after the user makes a choice and the banner closes. */
+    onClose?: () => void;
+}
+/**
+ * Cookie consent banner for React.
+ *
+ * Shows a GDPR/CCPA-compliant cookie banner with "Accept All",
+ * "Reject All", and "Customise" options. Persists choices via
+ * the provided {@link ConsentManager}.
+ *
+ * @param props - Component props.
+ *
+ * @example
+ * ```tsx
+ * import { CookieBanner } from 'flowgrid-sdk/react';
+ *
+ * function App() {
+ *   return (
+ *     <>
+ *       <Routes />
+ *       <CookieBanner
+ *         consent={consentManager}
+ *         config={{
+ *           title: 'Cookie Preferences',
+ *           description: 'We use cookies to personalise content and ads.',
+ *           privacyPolicyUrl: '/privacy',
+ *           theme: { position: 'bottom-right', primaryColor: '#059669' },
+ *           categoryDescriptions: {
+ *             analytics: 'Help us understand how visitors interact with our site.',
+ *             marketing: 'Used to deliver relevant ads and track campaigns.',
+ *             preferences: 'Remember your settings and preferences.',
+ *           },
+ *         }}
+ *       />
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+export declare function CookieBanner({ consent, config, onClose }: CookieBannerProps): import("react/jsx-runtime").JSX.Element | null;