flowgrid-sdk 1.2.1 → 1.4.1

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

@@ -0,0 +1,223 @@
+/**
+ * @fileoverview Ecommerce - Product Tracking
+ * @module features/ecommerce/products
+ *
+ * @description
+ * Track product interactions including views, impressions, clicks,
+ * and product list interactions.
+ *
+ * @useCases
+ * - Track product page views
+ * - Measure product list/search impressions
+ * - Analyze product click-through rates
+ * - Monitor product detail engagement
+ * - Compare product performance
+ *
+ * @metrics
+ * - Product views
+ * - Product impressions
+ * - Click-through rate
+ * - View-to-cart rate
+ * - Revenue per product
+ *
+ * @chartData
+ * - Bar chart: Top products by views
+ * - Line chart: Product views over time
+ * - Table: Product performance comparison
+ * - Scatter: Price vs conversion rate
+ *
+ * @example
+ * ```typescript
+ * const products = new Products(webId, endpoint, apiKey);
+ *
+ * // Track product view
+ * await products.view({
+ *   productId: 'SKU-123',
+ *   name: 'Premium Headphones',
+ *   price: 299.99,
+ *   currency: 'USD',
+ *   category: 'Electronics/Audio'
+ * });
+ * ```
+ */
+import { FlowGridTransport } from "../../client/transport";
+// ============================================================================
+// PRODUCTS CLASS
+// ============================================================================
+/**
+ * Products - Track product interactions.
+ *
+ * @extends FlowGridTransport
+ *
+ * @description
+ * Provides product tracking capabilities including:
+ * - Product page views
+ * - Product list impressions
+ * - Product clicks from lists
+ * - Product detail interactions
+ * - Quick view tracking
+ *
+ * @example
+ * ```typescript
+ * const products = new Products(webId, endpoint, apiKey);
+ *
+ * // Track product page view
+ * await products.view({
+ *   productId: 'PROD-001',
+ *   name: 'Wireless Earbuds',
+ *   price: 79.99,
+ *   currency: 'USD',
+ *   category: 'Electronics/Audio',
+ *   brand: 'AudioTech'
+ * });
+ *
+ * // Track list impressions
+ * await products.impression({
+ *   list: {
+ *     listId: 'search-results',
+ *     listName: 'Search Results',
+ *     products: searchResults
+ *   }
+ * });
+ * ```
+ */
+export class Products extends FlowGridTransport {
+    /**
+     * Tracks a product page view.
+     *
+     * @param config - Product view configuration
+     * @returns Promise resolving to product response
+     *
+     * @example
+     * ```typescript
+     * await products.view({
+     *   productId: 'SKU-12345',
+     *   name: 'Premium Widget',
+     *   price: 49.99,
+     *   currency: 'USD',
+     *   category: 'Widgets/Premium',
+     *   brand: 'WidgetCo',
+     *   source: 'search',
+     *   searchQuery: 'premium widget'
+     * });
+     * ```
+     */
+    async view(config) {
+        return await this.init("product_view", {
+            type: "ecommerce",
+            subtype: "product_view",
+            product: {
+                productId: config.productId,
+                name: config.name,
+                brand: config.brand,
+                category: config.category,
+                variant: config.variant,
+                price: config.price,
+                currency: config.currency,
+                url: config.url,
+                imageUrl: config.imageUrl,
+                rating: config.rating,
+                reviewCount: config.reviewCount,
+                stockStatus: config.stockStatus,
+                attributes: config.attributes
+            },
+            source: config.source,
+            searchQuery: config.searchQuery,
+            userId: config.userId,
+            sessionId: config.sessionId,
+            ...config.properties,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Tracks product list impressions.
+     *
+     * @param config - Impression configuration
+     * @returns Promise resolving to impression response
+     *
+     * @example
+     * ```typescript
+     * // Track products shown in search results
+     * await products.impression({
+     *   list: {
+     *     listId: 'search-results',
+     *     listName: 'Search Results',
+     *     products: products.map((p, i) => ({ ...p, position: i + 1 }))
+     *   }
+     * });
+     * ```
+     */
+    async impression(config) {
+        return await this.init("product_impression", {
+            type: "ecommerce",
+            subtype: "product_impression",
+            list: config.list,
+            productCount: config.list.products.length,
+            userId: config.userId,
+            sessionId: config.sessionId,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Tracks a product click from a list.
+     *
+     * @param config - Click configuration
+     * @returns Promise resolving to click response
+     *
+     * @example
+     * ```typescript
+     * await products.click({
+     *   product: selectedProduct,
+     *   listId: 'homepage-featured',
+     *   position: 3
+     * });
+     * ```
+     */
+    async click(config) {
+        return await this.init("product_click", {
+            type: "ecommerce",
+            subtype: "product_click",
+            product: config.product,
+            listId: config.listId,
+            position: config.position,
+            userId: config.userId,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Tracks a quick view interaction (modal product view).
+     *
+     * @param product - Product being quick-viewed
+     * @param listId - List where quick view was triggered
+     * @returns Promise resolving to quick view response
+     */
+    async quickView(product, listId) {
+        return await this.init("product_quick_view", {
+            type: "ecommerce",
+            subtype: "product_quick_view",
+            product,
+            listId,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Tracks product detail interaction (zoom, read reviews, etc.).
+     *
+     * @param productId - Product identifier
+     * @param action - Interaction type
+     * @param properties - Additional properties
+     * @returns Promise resolving to interaction response
+     */
+    async interaction(productId, action, properties) {
+        return await this.init("product_interaction", {
+            type: "ecommerce",
+            subtype: "product_interaction",
+            productId,
+            action,
+            ...properties,
+            timestamp: new Date().toISOString()
+        });
+    }
+}
+export default Products;
+//# sourceMappingURL=products.js.map

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

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

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

@@ -46,7 +46,7 @@
  * ```
  */
 import { FlowGridTransport } from "../../client/transport";
-import { Promotion, MoneyValue, DateRangeFilter, TimeSeriesData } from "../../types";
+import { Promotion, MoneyValue, TimeSeriesData } from "../../types";
 /**
  * Configuration for tracking promotion view.
  */
@@ -233,34 +233,5 @@ export declare class Promotions extends FlowGridTransport {
      * @returns Promise resolving to attempt response
      */
     couponAttempt(code: string, success: boolean, failureReason?: 'expired' | 'invalid' | 'minimum_not_met' | 'already_used' | 'not_applicable'): Promise<PromotionResponse>;
-    /**
-     * Retrieves promotion analytics for dashboards and charts.
-     *
-     * @param filter - Date range filter
-     * @returns Promise resolving to promotion analytics
-     *
-     * @example
-     * ```typescript
-     * const analytics = await promotions.getAnalytics({
-     *   range: 'last30days'
-     * });
-     *
-     * // Bar chart - top promotions
-     * const topPromoChart = analytics.topPromotions.map(p => ({
-     *   name: p.name,
-     *   value: p.revenue
-     * }));
-     *
-     * // Table - coupon performance
-     * const couponTable = analytics.coupons;
-     *
-     * // Pie chart - promoted vs non-promoted revenue
-     * const revenuePie = [
-     *   { name: 'Promoted', value: analytics.revenueImpact.promotedRevenue.amount },
-     *   { name: 'Non-Promoted', value: analytics.revenueImpact.nonPromotedRevenue.amount }
-     * ];
-     * ```
-     */
-    getAnalytics(filter?: DateRangeFilter): Promise<PromotionAnalyticsData>;
 }
 export default Promotions;

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

@@ -0,0 +1,197 @@
+/**
+ * @fileoverview Ecommerce - Promotion Tracking
+ * @module features/ecommerce/promotions
+ *
+ * @description
+ * Track promotional content, coupon usage, and discount
+ * effectiveness across your ecommerce store.
+ *
+ * @useCases
+ * - Track promotional banner views
+ * - Measure promotion click-through rates
+ * - Analyze coupon usage and effectiveness
+ * - Monitor discount impact on revenue
+ * - Compare promotion performance
+ *
+ * @metrics
+ * - Promotion impressions
+ * - Promotion CTR
+ * - Coupon redemption rate
+ * - Revenue attributed to promotions
+ * - Discount impact on margins
+ *
+ * @chartData
+ * - Bar chart: Top promotions by revenue
+ * - Line chart: Coupon usage over time
+ * - Table: Promotion performance comparison
+ * - Pie chart: Revenue by promotion type
+ *
+ * @example
+ * ```typescript
+ * const promotions = new Promotions(webId, endpoint, apiKey);
+ *
+ * // Track promotion view
+ * await promotions.view({
+ *   promotionId: 'PROMO-SUMMER',
+ *   name: 'Summer Sale 20% Off',
+ *   creative: 'homepage-banner'
+ * });
+ *
+ * // Track coupon usage
+ * await promotions.couponUsed({
+ *   code: 'SAVE20',
+ *   discountValue: 20,
+ *   orderId: 'ORD-123'
+ * });
+ * ```
+ */
+import { FlowGridTransport } from "../../client/transport";
+// ============================================================================
+// PROMOTIONS CLASS
+// ============================================================================
+/**
+ * Promotions - Track promotions and coupons.
+ *
+ * @extends FlowGridTransport
+ *
+ * @description
+ * Provides promotion tracking capabilities including:
+ * - Promotion/banner impressions
+ * - Promotion clicks
+ * - Coupon applications
+ * - Coupon success/failure
+ * - Revenue attribution
+ *
+ * @example
+ * ```typescript
+ * const promotions = new Promotions(webId, endpoint, apiKey);
+ *
+ * // Track banner impression
+ * await promotions.view({
+ *   promotionId: 'FLASH-SALE',
+ *   name: 'Flash Sale - 30% Off',
+ *   creative: 'hero-banner',
+ *   position: 'homepage-top'
+ * });
+ *
+ * // Track banner click
+ * await promotions.click({
+ *   promotionId: 'FLASH-SALE',
+ *   name: 'Flash Sale - 30% Off',
+ *   destinationUrl: '/sale'
+ * });
+ * ```
+ */
+export class Promotions extends FlowGridTransport {
+    /**
+     * Tracks promotion view/impression.
+     *
+     * @param config - Promotion view configuration
+     * @returns Promise resolving to promotion response
+     *
+     * @example
+     * ```typescript
+     * await promotions.view({
+     *   promotionId: 'SUMMER-2026',
+     *   name: 'Summer Collection Launch',
+     *   creative: 'collection-banner',
+     *   position: 'homepage-hero',
+     *   page: '/home'
+     * });
+     * ```
+     */
+    async view(config) {
+        return await this.init("promotion_view", {
+            type: "ecommerce",
+            subtype: "promotion_view",
+            promotionId: config.promotionId,
+            name: config.name,
+            creative: config.creative,
+            position: config.position,
+            page: config.page,
+            userId: config.userId,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Tracks promotion click.
+     *
+     * @param config - Promotion click configuration
+     * @returns Promise resolving to promotion response
+     *
+     * @example
+     * ```typescript
+     * await promotions.click({
+     *   promotionId: 'SUMMER-2026',
+     *   name: 'Summer Collection Launch',
+     *   destinationUrl: '/collections/summer-2026'
+     * });
+     * ```
+     */
+    async click(config) {
+        return await this.init("promotion_click", {
+            type: "ecommerce",
+            subtype: "promotion_click",
+            promotionId: config.promotionId,
+            name: config.name,
+            creative: config.creative,
+            position: config.position,
+            destinationUrl: config.destinationUrl,
+            userId: config.userId,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Tracks successful coupon usage.
+     *
+     * @param config - Coupon usage configuration
+     * @returns Promise resolving to coupon response
+     *
+     * @example
+     * ```typescript
+     * await promotions.couponUsed({
+     *   code: 'SAVE20',
+     *   orderId: 'ORD-12345',
+     *   discountValue: 20,
+     *   discountType: 'percentage',
+     *   orderValueBefore: 100,
+     *   orderValueAfter: 80
+     * });
+     * ```
+     */
+    async couponUsed(config) {
+        return await this.init("coupon_used", {
+            type: "ecommerce",
+            subtype: "coupon_used",
+            code: config.code,
+            orderId: config.orderId,
+            discountValue: config.discountValue,
+            discountType: config.discountType,
+            orderValueBefore: config.orderValueBefore,
+            orderValueAfter: config.orderValueAfter,
+            savings: config.orderValueBefore - config.orderValueAfter,
+            userId: config.userId,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Tracks coupon application attempt (including failures).
+     *
+     * @param code - Coupon code attempted
+     * @param success - Whether coupon was valid
+     * @param failureReason - Reason for failure (if failed)
+     * @returns Promise resolving to attempt response
+     */
+    async couponAttempt(code, success, failureReason) {
+        return await this.init("coupon_attempt", {
+            type: "ecommerce",
+            subtype: "coupon_attempt",
+            code,
+            success,
+            failureReason,
+            timestamp: new Date().toISOString()
+        });
+    }
+}
+export default Promotions;
+//# sourceMappingURL=promotions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"promotions.js","sourceRoot":"","sources":["../../../../src/lib/features/ecommerce/promotions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AA2G3D,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,OAAO,UAAW,SAAQ,iBAAiB;IAC/C;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,IAAI,CAAC,MAA2B;QACpC,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE;YACvC,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,gBAAgB;YACzB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,KAAK,CAAC,MAA4B;QACtC,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE;YACxC,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,iBAAiB;YAC1B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,UAAU,CAAC,MAAyB;QACxC,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE;YACpC,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,aAAa;YACtB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,OAAO,EAAE,MAAM,CAAC,gBAAgB,GAAG,MAAM,CAAC,eAAe;YACzD,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,aAAa,CACjB,IAAY,EACZ,OAAgB,EAChB,aAA6F;QAE7F,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE;YACvC,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,gBAAgB;YACzB,IAAI;YACJ,OAAO;YACP,aAAa;YACb,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;CAEF;AAED,eAAe,UAAU,CAAC"}

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

@@ -42,7 +42,7 @@
  * ```
  */
 import { FlowGridTransport } from "../../client/transport";
-import { Order, ShippingInfo, MoneyValue, DateRangeFilter, TimeSeriesData, PaginationParams } from "../../types";
+import { Order, ShippingInfo, MoneyValue, TimeSeriesData } from "../../types";
 /**
  * Configuration for tracking a purchase.
  */
@@ -178,9 +178,6 @@ export interface RecentOrdersData {
  *   },
  *   userId: 'user_123'
  * });
- *
- * // Get revenue analytics
- * const revenue = await purchases.getRevenue({ range: 'thisMonth' });
  * ```
  */
 export declare class Purchases extends FlowGridTransport {
@@ -239,49 +236,5 @@ export declare class Purchases extends FlowGridTransport {
      * @returns Promise resolving to delivered response
      */
     delivered(orderId: string, deliveredAt?: string): Promise<PurchaseResponse>;
-    /**
-     * Retrieves revenue analytics for dashboards and charts.
-     *
-     * @param filter - Date range filter
-     * @returns Promise resolving to revenue analytics
-     *
-     * @example
-     * ```typescript
-     * const revenue = await purchases.getRevenue({
-     *   range: 'last30days'
-     * });
-     *
-     * // KPI cards
-     * const kpis = [
-     *   { label: 'Revenue', value: revenue.summary.totalRevenue.amount },
-     *   { label: 'Orders', value: revenue.summary.totalOrders },
-     *   { label: 'AOV', value: revenue.summary.averageOrderValue.amount }
-     * ];
-     *
-     * // Revenue chart
-     * const revenueChart = revenue.revenueTimeSeries.data;
-     *
-     * // Category breakdown
-     * const categoryPie = revenue.byCategory.map(c => ({
-     *   name: c.category,
-     *   value: c.revenue
-     * }));
-     * ```
-     */
-    getRevenue(filter?: DateRangeFilter): Promise<RevenueAnalyticsData>;
-    /**
-     * Gets recent orders for display.
-     *
-     * @param pagination - Pagination options
-     * @returns Promise resolving to recent orders
-     */
-    getRecentOrders(pagination?: PaginationParams): Promise<RecentOrdersData>;
-    /**
-     * Gets order details by ID.
-     *
-     * @param orderId - Order identifier
-     * @returns Promise resolving to order details
-     */
-    getOrder(orderId: string): Promise<Order>;
 }
 export default Purchases;