flowgrid-sdk 1.2.0 → 1.3.0

package/dist/lib/features/ecommerce/cart.js.map

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

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

@@ -45,7 +45,7 @@
  * ```
  */
 import { FlowGridTransport } from "../../client/transport";
-import { Cart, CheckoutStep, ShippingInfo, PaymentInfo, DateRangeFilter, TimeSeriesData } from "../../types";
+import { Cart, CheckoutStep, ShippingInfo, PaymentInfo, TimeSeriesData } from "../../types";
 /**
  * Configuration for beginning checkout.
  */
@@ -293,32 +293,5 @@ export declare class Checkout extends FlowGridTransport {
      * @returns Promise resolving to checkout response
      */
     paymentAttempt(success: boolean, cart: Cart, payment: PaymentInfo, errorCode?: string): Promise<CheckoutResponse>;
-    /**
-     * Retrieves checkout analytics data for dashboards and charts.
-     *
-     * @param filter - Date range filter
-     * @returns Promise resolving to checkout analytics
-     *
-     * @example
-     * ```typescript
-     * const analytics = await checkout.getAnalytics({
-     *   range: 'last30days'
-     * });
-     *
-     * // Funnel chart
-     * const funnelData = analytics.funnel.map(step => ({
-     *   name: step.step,
-     *   value: step.started,
-     *   conversion: step.conversionRate
-     * }));
-     *
-     * // Pie chart - payment methods
-     * const paymentData = analytics.paymentMethods.map(p => ({
-     *   name: p.method,
-     *   value: p.count
-     * }));
-     * ```
-     */
-    getAnalytics(filter?: DateRangeFilter): Promise<CheckoutAnalyticsData>;
 }
 export default Checkout;

package/dist/lib/features/ecommerce/checkout.js

@@ -0,0 +1,254 @@
+/**
+ * @fileoverview Ecommerce - Checkout Tracking
+ * @module features/ecommerce/checkout
+ *
+ * @description
+ * Track checkout flow progress, payment attempts, and checkout
+ * optimization opportunities.
+ *
+ * @useCases
+ * - Track checkout step progression
+ * - Identify checkout drop-off points
+ * - Monitor payment success rates
+ * - Analyze shipping method preferences
+ * - Optimize checkout UX
+ *
+ * @metrics
+ * - Checkout initiation rate
+ * - Step completion rates
+ * - Payment success rate
+ * - Checkout abandonment rate
+ * - Average time to complete
+ *
+ * @chartData
+ * - Funnel chart: Checkout steps
+ * - Bar chart: Abandonment by step
+ * - Pie chart: Payment methods
+ * - Line chart: Checkout completions over time
+ *
+ * @example
+ * ```typescript
+ * const checkout = new Checkout(webId, endpoint, apiKey);
+ *
+ * // Begin checkout
+ * await checkout.begin({
+ *   cart: shoppingCart,
+ *   userId: 'user_123'
+ * });
+ *
+ * // Track step progress
+ * await checkout.step({
+ *   step: 'add_payment_info',
+ *   stepNumber: 3,
+ *   cart: shoppingCart
+ * });
+ * ```
+ */
+import { FlowGridTransport } from "../../client/transport";
+// ============================================================================
+// CHECKOUT CLASS
+// ============================================================================
+/**
+ * Checkout - Track checkout flow and payments.
+ *
+ * @extends FlowGridTransport
+ *
+ * @description
+ * Provides checkout tracking capabilities including:
+ * - Checkout initiation
+ * - Step-by-step progress
+ * - Shipping info capture
+ * - Payment info capture
+ * - Checkout abandonment
+ *
+ * @example
+ * ```typescript
+ * const checkout = new Checkout(webId, endpoint, apiKey);
+ *
+ * // Start checkout
+ * await checkout.begin({ cart: shoppingCart });
+ *
+ * // Track shipping step
+ * await checkout.addShipping({
+ *   cart: shoppingCart,
+ *   shipping: {
+ *     method: 'express',
+ *     carrier: 'FedEx',
+ *     cost: 9.99
+ *   }
+ * });
+ *
+ * // Track payment step
+ * await checkout.addPayment({
+ *   cart: shoppingCart,
+ *   payment: {
+ *     method: 'credit_card',
+ *     cardBrand: 'Visa'
+ *   }
+ * });
+ * ```
+ */
+export class Checkout extends FlowGridTransport {
+    /**
+     * Tracks checkout initiation.
+     *
+     * @param config - Begin checkout configuration
+     * @returns Promise resolving to checkout response
+     *
+     * @example
+     * ```typescript
+     * await checkout.begin({
+     *   cart: {
+     *     cartId: 'cart_123',
+     *     items: cartItems,
+     *     total: 199.99,
+     *     currency: 'USD',
+     *     itemCount: 3
+     *   }
+     * });
+     * ```
+     */
+    async begin(config) {
+        return await this.init("begin_checkout", {
+            type: "ecommerce",
+            subtype: "begin_checkout",
+            cart: config.cart,
+            cartValue: config.cart.total,
+            itemCount: config.cart.itemCount,
+            userId: config.userId,
+            sessionId: config.sessionId,
+            ...config.properties,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Tracks checkout step progress.
+     *
+     * @param config - Checkout step configuration
+     * @returns Promise resolving to checkout response
+     *
+     * @example
+     * ```typescript
+     * await checkout.step({
+     *   step: 'add_shipping_info',
+     *   stepNumber: 2,
+     *   cart: shoppingCart,
+     *   option: 'express_shipping'
+     * });
+     * ```
+     */
+    async step(config) {
+        return await this.init("checkout_step", {
+            type: "ecommerce",
+            subtype: "checkout_step",
+            step: config.step,
+            stepNumber: config.stepNumber,
+            cart: config.cart,
+            option: config.option,
+            userId: config.userId,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Tracks adding shipping information.
+     *
+     * @param config - Shipping info configuration
+     * @returns Promise resolving to checkout response
+     *
+     * @example
+     * ```typescript
+     * await checkout.addShipping({
+     *   cart: shoppingCart,
+     *   shipping: {
+     *     method: 'standard',
+     *     carrier: 'USPS',
+     *     cost: 5.99,
+     *     estimatedDelivery: '2026-02-07'
+     *   }
+     * });
+     * ```
+     */
+    async addShipping(config) {
+        return await this.init("add_shipping_info", {
+            type: "ecommerce",
+            subtype: "shipping_info",
+            cart: config.cart,
+            shipping: config.shipping,
+            shippingMethod: config.shipping.method,
+            shippingCost: config.shipping.cost,
+            userId: config.userId,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Tracks adding payment information.
+     *
+     * @param config - Payment info configuration
+     * @returns Promise resolving to checkout response
+     *
+     * @example
+     * ```typescript
+     * await checkout.addPayment({
+     *   cart: shoppingCart,
+     *   payment: {
+     *     method: 'credit_card',
+     *     provider: 'stripe',
+     *     cardBrand: 'Mastercard',
+     *     cardLast4: '4242'
+     *   }
+     * });
+     * ```
+     */
+    async addPayment(config) {
+        return await this.init("add_payment_info", {
+            type: "ecommerce",
+            subtype: "payment_info",
+            cart: config.cart,
+            payment: config.payment,
+            paymentMethod: config.payment.method,
+            userId: config.userId,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Tracks checkout abandonment.
+     *
+     * @param cart - Cart at abandonment
+     * @param step - Last completed step
+     * @param reason - Abandonment reason (if known)
+     * @returns Promise resolving to checkout response
+     */
+    async abandon(cart, step, reason) {
+        return await this.init("checkout_abandoned", {
+            type: "ecommerce",
+            subtype: "checkout_abandoned",
+            cart,
+            step,
+            cartValue: cart.total,
+            reason,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Tracks payment attempt (success or failure).
+     *
+     * @param success - Whether payment succeeded
+     * @param cart - Cart being paid for
+     * @param payment - Payment information
+     * @param errorCode - Error code (if failed)
+     * @returns Promise resolving to checkout response
+     */
+    async paymentAttempt(success, cart, payment, errorCode) {
+        return await this.init("payment_attempt", {
+            type: "ecommerce",
+            subtype: "payment_attempt",
+            success,
+            cart,
+            payment,
+            errorCode,
+            timestamp: new Date().toISOString()
+        });
+    }
+}
+export default Checkout;
+//# sourceMappingURL=checkout.js.map

package/dist/lib/features/ecommerce/checkout.js.map

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

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

@@ -11,7 +11,6 @@ export { Promotions } from './promotions';
 export { WishlistTracking } from './wishlist';
 export { CustomerLTV } from './ltv';
 export { SearchAnalytics } from './search';
-export { Inventory } from './inventory';
 export { Subscriptions } from './subscriptions';
 export type { ProductViewConfig, ProductImpressionConfig, ProductClickConfig, ProductResponse, ProductAnalyticsData } from './products';
 export type { AddToCartConfig, RemoveFromCartConfig, UpdateCartItemConfig, ViewCartConfig, CartResponse, CartAnalyticsData } from './cart';
@@ -22,5 +21,4 @@ export type { PromotionViewConfig, PromotionClickConfig, CouponUsageConfig, Prom
 export type { AddToWishlistConfig, RemoveFromWishlistConfig, WishlistResponse, WishlistAnalyticsData } from './wishlist';
 export type { CustomerValueData, AcquisitionCostConfig, LTVResponse, LTVAnalyticsData } from './ltv';
 export type { SearchConfig, SearchClickConfig, SearchResponse, SearchAnalyticsData } from './search';
-export type { StockUpdateConfig, OutOfStockConfig, InventoryResponse, InventoryAnalyticsData } from './inventory';
 export type { SubscriptionStartConfig, SubscriptionChangeConfig, SubscriptionCancelConfig, SubscriptionResponse, SubscriptionAnalyticsData } from './subscriptions';

package/dist/lib/features/ecommerce/index.js

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview Ecommerce features barrel export
+ * @module features/ecommerce
+ */
+export { Products } from './products';
+export { CartTracking } from './cart';
+export { Checkout } from './checkout';
+export { Purchases } from './purchases';
+export { Refunds } from './refunds';
+export { Promotions } from './promotions';
+export { WishlistTracking } from './wishlist';
+export { CustomerLTV } from './ltv';
+export { SearchAnalytics } from './search';
+export { Subscriptions } from './subscriptions';
+//# sourceMappingURL=index.js.map

package/dist/lib/features/ecommerce/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/features/ecommerce/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -29,16 +29,10 @@
  * @example
  * ```typescript
  * const ltv = new CustomerLTV(webId, endpoint, apiKey);
- *
- * // Get customer LTV
- * const customerValue = await ltv.getCustomerValue('user_123');
- *
- * // Get LTV analytics
- * const analytics = await ltv.getAnalytics({ range: 'last90days' });
  * ```
  */
 import { FlowGridTransport } from "../../client/transport";
-import { MoneyValue, DateRangeFilter, TimeSeriesData } from "../../types";
+import { MoneyValue, TimeSeriesData } from "../../types";
 /**
  * Customer value data.
  */
@@ -164,30 +158,9 @@ export interface LTVAnalyticsData {
  *   channel: 'facebook_ads',
  *   campaign: 'spring_campaign'
  * });
- *
- * // Get LTV analytics
- * const analytics = await ltv.getAnalytics();
- * console.log(`LTV:CAC Ratio: ${analytics.summary.ltvCacRatio}`);
  * ```
  */
 export declare class CustomerLTV extends FlowGridTransport {
-    /**
-     * Gets lifetime value data for a specific customer.
-     *
-     * @param userId - Customer/user identifier
-     * @returns Promise resolving to customer value data
-     *
-     * @example
-     * ```typescript
-     * const value = await ltv.getCustomerValue('user_123');
-     *
-     * console.log(`Total Revenue: $${value.totalRevenue.amount / 100}`);
-     * console.log(`Orders: ${value.orderCount}`);
-     * console.log(`Segment: ${value.segment}`);
-     * console.log(`Predicted LTV: $${value.predictedLTV.amount / 100}`);
-     * ```
-     */
-    getCustomerValue(userId: string): Promise<CustomerValueData>;
     /**
      * Records customer acquisition cost.
      *
@@ -213,46 +186,5 @@ export declare class CustomerLTV extends FlowGridTransport {
      * @returns Promise resolving to LTV response
      */
     updateSegment(userId: string, segment: 'low' | 'medium' | 'high' | 'vip'): Promise<LTVResponse>;
-    /**
-     * Gets high-value customers.
-     *
-     * @param limit - Number of customers to return
-     * @returns Promise resolving to list of high-value customers
-     */
-    getTopCustomers(limit?: number): Promise<CustomerValueData[]>;
-    /**
-     * Retrieves LTV analytics for dashboards and charts.
-     *
-     * @param filter - Date range filter
-     * @returns Promise resolving to LTV analytics
-     *
-     * @example
-     * ```typescript
-     * const analytics = await ltv.getAnalytics({
-     *   range: 'last90days'
-     * });
-     *
-     * // KPI cards
-     * const kpis = [
-     *   { label: 'Avg LTV', value: analytics.summary.averageLTV.amount },
-     *   { label: 'LTV:CAC', value: analytics.summary.ltvCacRatio },
-     *   { label: 'Avg AOV', value: analytics.summary.averageOrderValue.amount }
-     * ];
-     *
-     * // Bar chart - LTV by channel
-     * const channelChart = analytics.byChannel.map(c => ({
-     *   name: c.channel,
-     *   ltv: c.averageLTV.amount,
-     *   cac: c.averageCAC.amount
-     * }));
-     *
-     * // Histogram - value distribution
-     * const distribution = analytics.distribution.map(d => ({
-     *   range: d.range,
-     *   count: d.count
-     * }));
-     * ```
-     */
-    getAnalytics(filter?: DateRangeFilter): Promise<LTVAnalyticsData>;
 }
 export default CustomerLTV;

package/dist/lib/features/ecommerce/ltv.js

@@ -0,0 +1,114 @@
+/**
+ * @fileoverview Ecommerce - Customer Lifetime Value (LTV)
+ * @module features/ecommerce/ltv
+ *
+ * @description
+ * Calculate and track customer lifetime value to understand
+ * customer worth and optimize acquisition costs.
+ *
+ * @useCases
+ * - Calculate customer LTV
+ * - Segment customers by value
+ * - Track LTV trends over time
+ * - Identify high-value customers
+ * - Optimize acquisition spend (LTV:CAC)
+ *
+ * @metrics
+ * - Average LTV
+ * - LTV by cohort
+ * - LTV by segment
+ * - LTV:CAC ratio
+ * - Customer value distribution
+ *
+ * @chartData
+ * - Line chart: LTV by cohort over time
+ * - Bar chart: LTV by segment
+ * - Histogram: Customer value distribution
+ * - KPI: Average LTV, LTV:CAC
+ *
+ * @example
+ * ```typescript
+ * const ltv = new CustomerLTV(webId, endpoint, apiKey);
+ * ```
+ */
+import { FlowGridTransport } from "../../client/transport";
+// ============================================================================
+// CUSTOMER LTV CLASS
+// ============================================================================
+/**
+ * CustomerLTV - Calculate and track customer lifetime value.
+ *
+ * @extends FlowGridTransport
+ *
+ * @description
+ * Provides LTV tracking capabilities including:
+ * - Customer value calculation
+ * - Acquisition cost tracking
+ * - LTV:CAC ratio analysis
+ * - Customer segmentation by value
+ * - Cohort-based LTV analysis
+ *
+ * @example
+ * ```typescript
+ * const ltv = new CustomerLTV(webId, endpoint, apiKey);
+ *
+ * // Get individual customer value
+ * const value = await ltv.getCustomerValue('user_123');
+ * console.log(`LTV: $${value.totalRevenue.amount / 100}`);
+ *
+ * // Record acquisition cost
+ * await ltv.recordAcquisitionCost({
+ *   userId: 'user_123',
+ *   cost: { amount: 5000, currency: 'USD' },
+ *   channel: 'facebook_ads',
+ *   campaign: 'spring_campaign'
+ * });
+ * ```
+ */
+export class CustomerLTV extends FlowGridTransport {
+    /**
+     * Records customer acquisition cost.
+     *
+     * @param config - Acquisition cost configuration
+     * @returns Promise resolving to LTV response
+     *
+     * @example
+     * ```typescript
+     * await ltv.recordAcquisitionCost({
+     *   userId: 'user_123',
+     *   cost: { amount: 2500, currency: 'USD' }, // $25.00
+     *   channel: 'google_ads',
+     *   campaign: 'brand_terms'
+     * });
+     * ```
+     */
+    async recordAcquisitionCost(config) {
+        return await this.init("record_acquisition_cost", {
+            type: "ecommerce",
+            subtype: "acquisition_cost",
+            userId: config.userId,
+            cost: config.cost,
+            channel: config.channel,
+            campaign: config.campaign,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Updates customer segment based on value.
+     *
+     * @param userId - Customer/user identifier
+     * @param segment - New segment
+     * @returns Promise resolving to LTV response
+     */
+    async updateSegment(userId, segment) {
+        return await this.init("update_customer_segment", {
+            type: "ecommerce",
+            subtype: "update_customer_segment",
+            userId,
+            segment,
+            timestamp: new Date().toISOString()
+        });
+    }
+}
+export default CustomerLTV;
+//# sourceMappingURL=ltv.js.map

package/dist/lib/features/ecommerce/ltv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ltv.js","sourceRoot":"","sources":["../../../../src/lib/features/ecommerce/ltv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAiH3D,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,OAAO,WAAY,SAAQ,iBAAiB;IAChD;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,qBAAqB,CAAC,MAA6B;QACvD,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,yBAAyB,EAAE;YAChD,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,kBAAkB;YAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,aAAa,CACjB,MAAc,EACd,OAA0C;QAE1C,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,yBAAyB,EAAE;YAChD,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,yBAAyB;YAClC,MAAM;YACN,OAAO;YACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;CAEF;AAED,eAAe,WAAW,CAAC"}

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

@@ -41,7 +41,7 @@
  * ```
  */
 import { FlowGridTransport } from "../../client/transport";
-import { Product, ProductList, ProductPerformance, DateRangeFilter, PaginationParams, TimeSeriesData } from "../../types";
+import { Product, ProductList, ProductPerformance, TimeSeriesData } from "../../types";
 /**
  * Configuration for tracking a product view.
  */
@@ -232,37 +232,5 @@ export declare class Products extends FlowGridTransport {
      * @returns Promise resolving to interaction response
      */
     interaction(productId: string, action: 'zoom' | 'read_reviews' | 'size_guide' | 'compare' | 'share' | 'notify_stock', properties?: Record<string, unknown>): Promise<ProductResponse>;
-    /**
-     * Retrieves product analytics data for dashboards and charts.
-     *
-     * @param filter - Date range filter
-     * @param pagination - Pagination options
-     * @returns Promise resolving to product analytics
-     *
-     * @example
-     * ```typescript
-     * const analytics = await products.getAnalytics({
-     *   range: 'last30days'
-     * });
-     *
-     * // Bar chart - top products by views
-     * const topByViews = analytics.topProducts.byViews.map(p => ({
-     *   name: p.product.name,
-     *   value: p.views
-     * }));
-     *
-     * // Line chart - views over time
-     * const viewsTrend = analytics.viewsTimeSeries.data;
-     * ```
-     */
-    getAnalytics(filter?: DateRangeFilter, pagination?: PaginationParams): Promise<ProductAnalyticsData>;
-    /**
-     * Gets performance data for a specific product.
-     *
-     * @param productId - Product identifier
-     * @param filter - Date range filter
-     * @returns Promise resolving to product performance
-     */
-    getProductPerformance(productId: string, filter?: DateRangeFilter): Promise<ProductPerformance>;
 }
 export default Products;