flowgrid-sdk 1.2.1 → 1.3.0

package/dist/lib/frameworks/node/index.js

@@ -0,0 +1,391 @@
+/**
+ * @fileoverview FlowGrid SDK - Node.js Integration
+ * @module frameworks/node
+ *
+ * @description
+ * Node.js SDK for server-side event tracking.
+ * Use in Express, Fastify, Hono, or any Node.js backend.
+ *
+ * ⚠️ All operations are server-side. Never expose your API key.
+ *
+ * @example
+ * ```ts
+ * // Basic usage
+ * import { FlowGrid } from 'flowgrid-sdk/node';
+ *
+ * const flowgrid = new FlowGrid({
+ *   webId: process.env.FLOWGRID_WEB_ID!,
+ *   endpoint: process.env.FLOWGRID_ENDPOINT!,
+ *   apiKey: process.env.FLOWGRID_API_KEY!,
+ * });
+ *
+ * // Track event
+ * await flowgrid.track('user_signed_up', { userId: 'user_123' });
+ * ```
+ */
+import { Activation, TrackFeature, TrackPrompt, Experiment, Events, Identify, Funnels, Purchases, Refunds, Subscriptions, CustomerLTV, Inventory } from '../../../index';
+import { IdentityManager } from '../../utils/identity';
+// ============================================================================
+// MAIN CLASS
+// ============================================================================
+/**
+ * FlowGrid Node.js SDK.
+ *
+ * @example
+ * ```ts
+ * import { FlowGrid } from 'flowgrid-sdk/node';
+ *
+ * const flowgrid = new FlowGrid({
+ *   webId: process.env.FLOWGRID_WEB_ID!,
+ *   endpoint: process.env.FLOWGRID_ENDPOINT!,
+ *   apiKey: process.env.FLOWGRID_API_KEY!,
+ * });
+ *
+ * // Track events
+ * await flowgrid.track('order_placed', {
+ *   orderId: 'ORD-123',
+ *   userId: 'user_456',
+ *   value: 9999
+ * });
+ *
+ * // Identify users
+ * await flowgrid.identify('user_456', {
+ *   email: 'user@example.com',
+ *   plan: 'pro'
+ * });
+ *
+ * // Flush before shutdown
+ * await flowgrid.flush();
+ * ```
+ */
+export class FlowGrid {
+    constructor(config) {
+        this.eventQueue = [];
+        this.flushTimer = null;
+        this.config = {
+            batchEvents: true,
+            batchSize: 100,
+            flushInterval: 5000,
+            debug: false,
+            ...config,
+        };
+        const { webId, endpoint, apiKey } = config;
+        // Create identity manager with memory storage (no cookies in Node)
+        const identity = new IdentityManager({
+            visitorId: config.visitorId,
+            storage: 'memory',
+        });
+        // Initialize SDK instances
+        this.activation = new Activation(webId, endpoint, apiKey, config.visitorId, identity);
+        this.trackFeature = new TrackFeature(webId, endpoint, apiKey, config.visitorId, identity);
+        this.trackPrompt = new TrackPrompt(webId, endpoint, apiKey, config.visitorId, identity);
+        this.experiment = new Experiment(webId, endpoint, apiKey, config.visitorId, identity);
+        this.events = new Events(webId, endpoint, apiKey, config.visitorId, identity);
+        this.identify = new Identify(webId, endpoint, apiKey, config.visitorId, identity);
+        this.funnels = new Funnels(webId, endpoint, apiKey, config.visitorId, identity);
+        this.purchases = new Purchases(webId, endpoint, apiKey, config.visitorId, identity);
+        this.refunds = new Refunds(webId, endpoint, apiKey, config.visitorId, identity);
+        this.subscriptions = new Subscriptions(webId, endpoint, apiKey, config.visitorId, identity);
+        this.customerLTV = new CustomerLTV(webId, endpoint, apiKey, config.visitorId, identity);
+        this.inventory = new Inventory(webId, endpoint, apiKey, config.visitorId, identity);
+        // Start flush timer if batching enabled
+        if (this.config.batchEvents) {
+            this.startFlushTimer();
+        }
+        this.log('FlowGrid initialized');
+    }
+    log(...args) {
+        if (this.config.debug) {
+            console.log('[FlowGrid]', ...args);
+        }
+    }
+    startFlushTimer() {
+        this.flushTimer = setInterval(() => {
+            if (this.eventQueue.length > 0) {
+                this.flush();
+            }
+        }, this.config.flushInterval);
+    }
+    // ============================================================================
+    // CORE METHODS
+    // ============================================================================
+    /**
+     * Track an event.
+     *
+     * @example
+     * ```ts
+     * await flowgrid.track('button_clicked', {
+     *   buttonId: 'cta',
+     *   userId: 'user_123'
+     * });
+     * ```
+     */
+    async track(eventName, properties) {
+        const event = {
+            name: eventName,
+            properties,
+            timestamp: new Date().toISOString(),
+        };
+        if (this.config.batchEvents) {
+            this.eventQueue.push(event);
+            this.log('Event queued:', eventName);
+            if (this.eventQueue.length >= (this.config.batchSize || 100)) {
+                await this.flush();
+            }
+        }
+        else {
+            await this.events.track({ eventName, properties: properties || {} });
+            this.log('Event sent:', eventName);
+        }
+    }
+    /**
+     * Identify a user with traits.
+     *
+     * @example
+     * ```ts
+     * await flowgrid.identifyUser('user_123', {
+     *   email: 'user@example.com',
+     *   plan: 'pro',
+     *   company: 'Acme Inc'
+     * });
+     * ```
+     */
+    async identifyUser(userId, traits) {
+        await this.identify.user({ userId, traits: traits || {} });
+        this.log('User identified:', userId);
+    }
+    /**
+     * Alias one user ID to another.
+     *
+     * @example
+     * ```ts
+     * // After user logs in, link anonymous to known ID
+     * await flowgrid.alias('anon_abc123', 'user_456');
+     * ```
+     */
+    async alias(previousId, newId) {
+        await this.identify.alias({ previousId, userId: newId });
+        this.log('User aliased:', previousId, '->', newId);
+    }
+    /**
+     * Flush all queued events.
+     * Call before process exit.
+     *
+     * @example
+     * ```ts
+     * // Before shutdown
+     * await flowgrid.flush();
+     * process.exit(0);
+     * ```
+     */
+    async flush() {
+        if (this.eventQueue.length === 0)
+            return;
+        const eventsToSend = [...this.eventQueue];
+        this.eventQueue = [];
+        try {
+            await this.events.trackBatch({
+                events: eventsToSend.map(e => ({
+                    eventName: e.name,
+                    properties: e.properties || {},
+                    timestamp: e.timestamp,
+                }))
+            });
+            this.log('Flushed', eventsToSend.length, 'events');
+        }
+        catch (error) {
+            // Re-queue failed events
+            this.eventQueue.push(...eventsToSend);
+            this.log('Flush failed, re-queued events:', error);
+            throw error;
+        }
+    }
+    /**
+     * Shutdown the SDK gracefully.
+     * Flushes remaining events and clears timers.
+     */
+    async shutdown() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+        await this.flush();
+        this.log('Shutdown complete');
+    }
+    // ============================================================================
+    // ECOMMERCE METHODS
+    // ============================================================================
+    /**
+     * Track a purchase/order.
+     *
+     * @example
+     * ```ts
+     * await flowgrid.trackPurchase({
+     *   orderId: 'ORD-12345',
+     *   userId: 'user_123',
+     *   revenue: 9999, // in cents
+     *   currency: 'USD',
+     *   items: [
+     *     { id: 'prod_1', name: 'Widget', price: 4999, quantity: 2 }
+     *   ]
+     * });
+     * ```
+     */
+    async trackPurchase(order) {
+        await this.purchases.track({
+            order: {
+                orderId: order.orderId,
+                items: order.items.map(i => ({
+                    id: i.id,
+                    productId: i.id,
+                    name: i.name,
+                    price: i.price,
+                    quantity: i.quantity,
+                    lineTotal: i.price * i.quantity,
+                    currency: order.currency || 'USD',
+                })),
+                subtotal: order.revenue,
+                discountTotal: 0,
+                shippingTotal: 0,
+                taxTotal: 0,
+                total: order.revenue,
+                currency: order.currency || 'USD'
+            },
+            userId: order.userId,
+        });
+        this.log('Purchase tracked:', order.orderId);
+    }
+    /**
+     * Track a refund.
+     */
+    async trackRefund(refund) {
+        await this.refunds.track({
+            refundId: refund.refundId,
+            orderId: refund.orderId,
+            amount: { amount: refund.amount, currency: refund.currency || 'USD' },
+            reason: refund.reason,
+            currency: refund.currency,
+            isFullRefund: false
+        });
+        this.log('Refund tracked:', refund.refundId);
+    }
+    // ============================================================================
+    // SUBSCRIPTION METHODS
+    // ============================================================================
+    /**
+     * Track a subscription start.
+     */
+    async trackSubscriptionStart(sub) {
+        await this.subscriptions.start({
+            subscriptionId: sub.subscriptionId,
+            userId: sub.userId,
+            plan: sub.plan,
+            mrr: { amount: sub.mrr, currency: sub.currency || 'USD' },
+            billingCycle: sub.billingCycle || 'monthly',
+        });
+        this.log('Subscription started:', sub.subscriptionId);
+    }
+    /**
+     * Track a subscription cancellation.
+     */
+    async trackSubscriptionCancel(sub) {
+        await this.subscriptions.cancel({
+            subscriptionId: sub.subscriptionId,
+            userId: sub.userId,
+            plan: sub.plan,
+            lostMrr: { amount: sub.lostMrr, currency: sub.currency || 'USD' },
+            reason: sub.reason,
+            immediate: false,
+        });
+        this.log('Subscription cancelled:', sub.subscriptionId);
+    }
+    // ============================================================================
+    // EXPERIMENT METHODS
+    // ============================================================================
+    /**
+     * Get experiment variant for a user.
+     */
+    async getExperimentVariant(experimentId, userId) {
+        await this.experiment.trackExposure(experimentId, userId, 'control');
+        // In real implementation, this would return actual variant from API
+        return 'control';
+    }
+}
+// ============================================================================
+// EXPRESS MIDDLEWARE
+// ============================================================================
+/**
+ * Express middleware for automatic request tracking.
+ *
+ * @example
+ * ```ts
+ * import express from 'express';
+ * import { FlowGrid, expressMiddleware } from 'flowgrid-sdk/node';
+ *
+ * const app = express();
+ * const flowgrid = new FlowGrid({ ... });
+ *
+ * app.use(expressMiddleware(flowgrid));
+ * ```
+ */
+export function expressMiddleware(flowgrid) {
+    return async (req, res, next) => {
+        const startTime = Date.now();
+        res.on('finish', async () => {
+            await flowgrid.track('http_request', {
+                method: req.method,
+                path: req.path,
+                statusCode: res.statusCode,
+                duration: Date.now() - startTime,
+                userAgent: req.get('user-agent'),
+                userId: req.user?.id, // If using auth middleware
+            });
+        });
+        next();
+    };
+}
+/**
+ * Graceful shutdown handler.
+ *
+ * @example
+ * ```ts
+ * import { FlowGrid, gracefulShutdown } from 'flowgrid-sdk/node';
+ *
+ * const flowgrid = new FlowGrid({ ... });
+ * gracefulShutdown(flowgrid);
+ * ```
+ */
+export function gracefulShutdown(flowgrid) {
+    const shutdown = async () => {
+        console.log('[FlowGrid] Shutting down...');
+        await flowgrid.shutdown();
+        process.exit(0);
+    };
+    process.on('SIGTERM', shutdown);
+    process.on('SIGINT', shutdown);
+}
+// ============================================================================
+// FACTORY FUNCTION
+// ============================================================================
+/**
+ * Create a FlowGrid instance.
+ *
+ * @example
+ * ```ts
+ * import { createFlowGrid } from 'flowgrid-sdk/node';
+ *
+ * const flowgrid = createFlowGrid({
+ *   webId: process.env.FLOWGRID_WEB_ID!,
+ *   endpoint: process.env.FLOWGRID_ENDPOINT!,
+ *   apiKey: process.env.FLOWGRID_API_KEY!,
+ * });
+ * ```
+ */
+export function createFlowGrid(config) {
+    return new FlowGrid(config);
+}
+// ============================================================================
+// EXPORTS
+// ============================================================================
+export default FlowGrid;
+//# sourceMappingURL=index.js.map

package/dist/lib/frameworks/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/frameworks/node/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/frameworks/nuxt/index.js

@@ -0,0 +1,288 @@
+/**
+ * @fileoverview FlowGrid SDK - Nuxt 3 Integration
+ * @module frameworks/nuxt
+ *
+ * @description
+ * Nuxt 3 plugin, composables, and server utilities for FlowGrid SDK.
+ * Supports both client-side and server-side tracking.
+ *
+ * ## File Structure
+ *
+ * ```
+ * your-nuxt-app/
+ * ├── plugins/
+ * │   └── flowgrid.client.ts   # Client-only plugin
+ * ├── server/
+ * │   └── utils/
+ * │       └── flowgrid.ts      # Server utilities
+ * └── composables/
+ *     └── useFlowGrid.ts       # Auto-imported composable
+ * ```
+ *
+ * @example
+ * ```ts
+ * // plugins/flowgrid.client.ts
+ * import { FlowGridPlugin } from 'flowgrid-sdk/nuxt';
+ *
+ * export default defineNuxtPlugin((nuxtApp) => {
+ *   nuxtApp.vueApp.use(FlowGridPlugin, {
+ *     webId: useRuntimeConfig().public.flowgridWebId,
+ *     endpoint: useRuntimeConfig().public.flowgridEndpoint,
+ *     apiKey: useRuntimeConfig().public.flowgridApiKey,
+ *   });
+ * });
+ * ```
+ */
+// Re-export Vue composables (work in Nuxt)
+export * from '../vue/index';
+import { ref, onMounted } from 'vue';
+import { Activation, TrackFeature, TrackPrompt, Experiment, PageViews, Sessions, Events, Identify, Funnels, Products, CartTracking, Checkout, Purchases, Subscriptions, CustomerLTV } from '../../../index';
+import { getVisitorId } from '../../utils/storage';
+import { IdentityManager } from '../../utils/identity';
+// ============================================================================
+// NUXT PLUGIN FACTORY
+// ============================================================================
+/**
+ * Create FlowGrid Nuxt plugin.
+ *
+ * @example
+ * ```ts
+ * // plugins/flowgrid.client.ts
+ * import { createFlowGridPlugin } from 'flowgrid-sdk/nuxt';
+ *
+ * export default defineNuxtPlugin((nuxtApp) => {
+ *   const config = useRuntimeConfig();
+ *
+ *   const flowgrid = createFlowGridPlugin({
+ *     webId: config.public.flowgridWebId,
+ *     endpoint: config.public.flowgridEndpoint,
+ *     apiKey: config.public.flowgridApiKey,
+ *   });
+ *
+ *   return {
+ *     provide: {
+ *       flowgrid
+ *     }
+ *   };
+ * });
+ * ```
+ */
+export function createFlowGridPlugin(config) {
+    const { webId, endpoint, apiKey, debug = false } = config;
+    const isReady = ref(false);
+    const sessionId = ref(null);
+    // Create identity manager for visitor/session lifecycle
+    const identity = new IdentityManager({
+        visitorId: config.visitorId || getVisitorId() || undefined,
+    });
+    const resolvedVisitorId = identity.getVisitorId() || undefined;
+    const instance = {
+        activation: new Activation(webId, endpoint, apiKey, resolvedVisitorId, identity),
+        trackFeature: new TrackFeature(webId, endpoint, apiKey, resolvedVisitorId, identity),
+        trackPrompt: new TrackPrompt(webId, endpoint, apiKey, resolvedVisitorId, identity),
+        experiment: new Experiment(webId, endpoint, apiKey, resolvedVisitorId, identity),
+        pageViews: new PageViews(webId, endpoint, apiKey, resolvedVisitorId, identity),
+        sessions: new Sessions(webId, endpoint, apiKey, resolvedVisitorId, identity),
+        events: new Events(webId, endpoint, apiKey, resolvedVisitorId, identity),
+        identify: new Identify(webId, endpoint, apiKey, resolvedVisitorId, identity),
+        funnels: new Funnels(webId, endpoint, apiKey, resolvedVisitorId, identity),
+        products: new Products(webId, endpoint, apiKey, resolvedVisitorId, identity),
+        cart: new CartTracking(webId, endpoint, apiKey, resolvedVisitorId, identity),
+        checkout: new Checkout(webId, endpoint, apiKey, resolvedVisitorId, identity),
+        purchases: new Purchases(webId, endpoint, apiKey, resolvedVisitorId, identity),
+        subscriptions: new Subscriptions(webId, endpoint, apiKey, resolvedVisitorId, identity),
+        customerLTV: new CustomerLTV(webId, endpoint, apiKey, resolvedVisitorId, identity),
+        isReady,
+        sessionId,
+    };
+    // Auto-start session on client
+    if (typeof window !== 'undefined' && config.autoTrackSessions !== false) {
+        instance.sessions.start({
+            referrer: document.referrer,
+            landingPage: window.location.pathname,
+        }).then((result) => {
+            sessionId.value = result.response?.sessionId || null;
+            isReady.value = true;
+            if (debug)
+                console.log('[FlowGrid] Session started:', sessionId.value);
+        });
+        window.addEventListener('beforeunload', () => {
+            if (sessionId.value) {
+                instance.sessions.end(sessionId.value);
+            }
+        });
+    }
+    else {
+        isReady.value = true;
+    }
+    // Helper methods
+    const trackEvent = async (name, properties) => {
+        if (debug)
+            console.log('[FlowGrid] Event:', name, properties);
+        await instance.events.track({ eventName: name, properties: properties || {} });
+    };
+    const identifyUser = async (userId, traits) => {
+        if (debug)
+            console.log('[FlowGrid] Identify:', userId, traits);
+        await instance.identify.user({ userId, traits: traits || {} });
+    };
+    return {
+        ...instance,
+        trackEvent,
+        identifyUser,
+    };
+}
+// ============================================================================
+// NUXT COMPOSABLES
+// ============================================================================
+/**
+ * Composable for accessing FlowGrid in Nuxt.
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * const { $flowgrid } = useNuxtApp();
+ * // Or use the provided composable
+ * const flowgrid = useNuxtFlowGrid();
+ *
+ * const handleClick = () => {
+ *   flowgrid.trackEvent('button_clicked');
+ * };
+ * </script>
+ * ```
+ */
+export function useNuxtFlowGrid() {
+    // This would use useNuxtApp() in actual Nuxt context
+    // For the SDK, we provide the factory function
+    const nuxtApp = globalThis.__nuxt_app__;
+    if (!nuxtApp?.$flowgrid) {
+        console.warn('[FlowGrid] Plugin not installed. Make sure to add the plugin.');
+        return null;
+    }
+    return nuxtApp.$flowgrid;
+}
+/**
+ * Composable for route-aware page view tracking.
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * // In your app.vue or layout
+ * useNuxtPageView();
+ * </script>
+ * ```
+ */
+export function useNuxtPageView() {
+    // This would integrate with useRoute() in Nuxt
+    onMounted(() => {
+        const flowgrid = useNuxtFlowGrid();
+        if (!flowgrid)
+            return;
+        flowgrid.pageViews.track({
+            url: window.location.href,
+            path: window.location.pathname,
+            title: document.title,
+            referrer: document.referrer,
+        });
+    });
+}
+// ============================================================================
+// SERVER UTILITIES
+// ============================================================================
+/**
+ * Server-side FlowGrid instance for Nuxt server routes.
+ *
+ * @example
+ * ```ts
+ * // server/utils/flowgrid.ts
+ * import { createServerFlowGrid } from 'flowgrid-sdk/nuxt';
+ *
+ * export const flowgrid = createServerFlowGrid({
+ *   webId: process.env.FLOWGRID_WEB_ID!,
+ *   endpoint: process.env.FLOWGRID_ENDPOINT!,
+ *   apiKey: process.env.FLOWGRID_API_KEY!,
+ * });
+ *
+ * // server/api/track.post.ts
+ * export default defineEventHandler(async (event) => {
+ *   const body = await readBody(event);
+ *   await flowgrid.events.track({ name: body.event, properties: body.properties });
+ *   return { success: true };
+ * });
+ * ```
+ */
+export function createServerFlowGrid(config) {
+    const { webId, endpoint, apiKey, visitorId } = config;
+    const identity = new IdentityManager({
+        visitorId,
+        storage: 'memory',
+        serverCookies: config.cookies ? { get: (name) => config.cookies.get(name) ?? null } : undefined,
+    });
+    const resolvedVisitorId = identity.getVisitorId();
+    return {
+        activation: new Activation(webId, endpoint, apiKey, resolvedVisitorId, identity),
+        trackFeature: new TrackFeature(webId, endpoint, apiKey, resolvedVisitorId, identity),
+        trackPrompt: new TrackPrompt(webId, endpoint, apiKey, resolvedVisitorId, identity),
+        experiment: new Experiment(webId, endpoint, apiKey, resolvedVisitorId, identity),
+        events: new Events(webId, endpoint, apiKey, resolvedVisitorId, identity),
+        identify: new Identify(webId, endpoint, apiKey, resolvedVisitorId, identity),
+        funnels: new Funnels(webId, endpoint, apiKey, resolvedVisitorId, identity),
+        purchases: new Purchases(webId, endpoint, apiKey, resolvedVisitorId, identity),
+        subscriptions: new Subscriptions(webId, endpoint, apiKey, resolvedVisitorId, identity),
+        customerLTV: new CustomerLTV(webId, endpoint, apiKey, resolvedVisitorId, identity),
+    };
+}
+/**
+ * Track event from Nuxt server route.
+ */
+export async function trackNuxtServerEvent(flowgrid, eventName, properties) {
+    await flowgrid.events.track({
+        eventName,
+        properties: { ...properties, _server: true },
+    });
+}
+// ============================================================================
+// NITRO EVENT HANDLER WRAPPER
+// ============================================================================
+/**
+ * Wrap a Nuxt event handler with tracking.
+ *
+ * @example
+ * ```ts
+ * // server/api/checkout.post.ts
+ * import { withTracking } from 'flowgrid-sdk/nuxt';
+ *
+ * export default withTracking('checkout_api_called', async (event) => {
+ *   const body = await readBody(event);
+ *   // Your logic
+ *   return { success: true };
+ * });
+ * ```
+ */
+export function withTracking(eventName, handler) {
+    return async (event) => {
+        const startTime = Date.now();
+        try {
+            const result = await handler(event);
+            // Would track success here with server flowgrid instance
+            console.log(`[FlowGrid] ${eventName} succeeded in ${Date.now() - startTime}ms`);
+            return result;
+        }
+        catch (error) {
+            console.log(`[FlowGrid] ${eventName} failed in ${Date.now() - startTime}ms`);
+            throw error;
+        }
+    };
+}
+// ============================================================================
+// EXPORTS
+// ============================================================================
+export default {
+    createFlowGridPlugin,
+    useNuxtFlowGrid,
+    useNuxtPageView,
+    createServerFlowGrid,
+    trackNuxtServerEvent,
+    withTracking,
+};
+//# sourceMappingURL=index.js.map