flowgrid-sdk 1.2.0 → 1.3.0

package/dist/lib/tracking/ecommerce/purchases.js

@@ -0,0 +1,10 @@
+export class PurchaseTracker {
+    constructor(client) {
+        this.client = client;
+    }
+    /** Track a completed purchase. */
+    complete(order) {
+        return this.client.track({ order });
+    }
+}
+//# sourceMappingURL=purchases.js.map

package/dist/lib/tracking/ecommerce/purchases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"purchases.js","sourceRoot":"","sources":["../../../../src/lib/tracking/ecommerce/purchases.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,eAAe;IAC1B,YAA4B,MAAiB;QAAjB,WAAM,GAAN,MAAM,CAAW;IAAG,CAAC;IAEjD,kCAAkC;IAClC,QAAQ,CAAC,KAAY;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/lib/tracking/ecommerce/refunds.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Refund shortcuts.
+ */
+import { Refunds } from "../../features/ecommerce/refunds";
+import type { CartItem } from "../../types";
+export declare class RefundTracker {
+    readonly client: Refunds;
+    constructor(client: Refunds);
+    /** Customer requested a refund. */
+    request(orderId: string, items?: CartItem[], reason?: string): Promise<import("../../features/ecommerce/refunds").RefundResponse>;
+    /** Refund approved. */
+    approve(refundId: string, approvedAmount: number): Promise<import("../../features/ecommerce/refunds").RefundResponse>;
+    /** Refund denied. */
+    deny(refundId: string, reason: string): Promise<import("../../features/ecommerce/refunds").RefundResponse>;
+    /** Track a completed refund (partial or full). */
+    complete(orderId: string, refundId: string, amount: number, currency: string, reason: string, isFullRefund?: boolean): Promise<import("../../features/ecommerce/refunds").RefundResponse>;
+}

package/dist/lib/tracking/ecommerce/refunds.js

@@ -0,0 +1,22 @@
+export class RefundTracker {
+    constructor(client) {
+        this.client = client;
+    }
+    /** Customer requested a refund. */
+    request(orderId, items, reason) {
+        return this.client.request(orderId, items, reason);
+    }
+    /** Refund approved. */
+    approve(refundId, approvedAmount) {
+        return this.client.approve(refundId, approvedAmount);
+    }
+    /** Refund denied. */
+    deny(refundId, reason) {
+        return this.client.deny(refundId, reason);
+    }
+    /** Track a completed refund (partial or full). */
+    complete(orderId, refundId, amount, currency, reason, isFullRefund = false) {
+        return this.client.track({ orderId, refundId, amount, currency, reason, isFullRefund });
+    }
+}
+//# sourceMappingURL=refunds.js.map

package/dist/lib/tracking/ecommerce/refunds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refunds.js","sourceRoot":"","sources":["../../../../src/lib/tracking/ecommerce/refunds.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,aAAa;IACxB,YAA4B,MAAe;QAAf,WAAM,GAAN,MAAM,CAAS;IAAG,CAAC;IAE/C,mCAAmC;IACnC,OAAO,CAAC,OAAe,EAAE,KAAkB,EAAE,MAAe;QAC1D,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACrD,CAAC;IAED,uBAAuB;IACvB,OAAO,CAAC,QAAgB,EAAE,cAAsB;QAC9C,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IACvD,CAAC;IAED,qBAAqB;IACrB,IAAI,CAAC,QAAgB,EAAE,MAAc;QACnC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED,kDAAkD;IAClD,QAAQ,CACN,OAAe,EACf,QAAgB,EAChB,MAAc,EACd,QAAgB,EAChB,MAAc,EACd,YAAY,GAAG,KAAK;QAEpB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IAC1F,CAAC;CACF"}

package/dist/lib/tracking/ecommerce/search.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Site search shortcuts.
+ */
+import { SearchAnalytics } from "../../features/ecommerce/search";
+import type { Product } from "../../types";
+type RefinementType = "query_change" | "add_filter" | "remove_filter" | "sort_change";
+export declare class SearchTracker {
+    readonly client: SearchAnalytics;
+    constructor(client: SearchAnalytics);
+    /** A user searched. */
+    query(query: string, resultsCount: number, extra?: {
+        category?: string;
+        filters?: Record<string, string | string[]>;
+        userId?: string;
+        sessionId?: string;
+    }): Promise<import("../../features/ecommerce/search").SearchResponse>;
+    /** A user clicked a search result. */
+    click(query: string, product: Product, position: number): Promise<import("../../features/ecommerce/search").SearchResponse>;
+    /** A user refined an existing search. */
+    refine(originalQuery: string, refinedQuery: string, refinementType: RefinementType): Promise<import("../../features/ecommerce/search").SearchResponse>;
+    /** Autocomplete suggestion accepted. */
+    suggestion(partialQuery: string, selectedSuggestion: string, suggestionPosition: number): Promise<import("../../features/ecommerce/search").SearchResponse>;
+}
+export {};

package/dist/lib/tracking/ecommerce/search.js

@@ -0,0 +1,22 @@
+export class SearchTracker {
+    constructor(client) {
+        this.client = client;
+    }
+    /** A user searched. */
+    query(query, resultsCount, extra) {
+        return this.client.track({ query, resultsCount, ...extra });
+    }
+    /** A user clicked a search result. */
+    click(query, product, position) {
+        return this.client.trackClick({ query, product, position });
+    }
+    /** A user refined an existing search. */
+    refine(originalQuery, refinedQuery, refinementType) {
+        return this.client.trackRefinement(originalQuery, refinedQuery, refinementType);
+    }
+    /** Autocomplete suggestion accepted. */
+    suggestion(partialQuery, selectedSuggestion, suggestionPosition) {
+        return this.client.trackSuggestion(partialQuery, selectedSuggestion, suggestionPosition);
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/lib/tracking/ecommerce/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../../src/lib/tracking/ecommerce/search.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,aAAa;IACxB,YAA4B,MAAuB;QAAvB,WAAM,GAAN,MAAM,CAAiB;IAAG,CAAC;IAEvD,uBAAuB;IACvB,KAAK,CAAC,KAAa,EAAE,YAAoB,EAAE,KAA+G;QACxJ,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,sCAAsC;IACtC,KAAK,CAAC,KAAa,EAAE,OAAgB,EAAE,QAAgB;QACrD,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,yCAAyC;IACzC,MAAM,CAAC,aAAqB,EAAE,YAAoB,EAAE,cAA8B;QAChF,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,aAAa,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC;IAClF,CAAC;IAED,wCAAwC;IACxC,UAAU,CAAC,YAAoB,EAAE,kBAA0B,EAAE,kBAA0B;QACrF,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;IAC3F,CAAC;CACF"}

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

@@ -0,0 +1,21 @@
+/**
+ * Subscription shortcuts.
+ */
+import { Subscriptions } from "../../features/ecommerce/subscriptions";
+import type { MoneyValue } from "../../types";
+export declare class SubscriptionTracker {
+    readonly client: Subscriptions;
+    constructor(client: Subscriptions);
+    /** New subscription started. */
+    start(subscriptionId: string, userId: string, plan: string, mrr: MoneyValue, billingCycle: "monthly" | "quarterly" | "yearly"): Promise<import("../../features/ecommerce/subscriptions").SubscriptionResponse>;
+    /** Plan changed (upgrade / downgrade). */
+    change(subscriptionId: string, userId: string, previousPlan: string, newPlan: string, previousMrr: MoneyValue, newMrr: MoneyValue, changeType: "upgrade" | "downgrade" | "cross_grade"): Promise<import("../../features/ecommerce/subscriptions").SubscriptionResponse>;
+    /** Subscription cancelled. */
+    cancel(subscriptionId: string, userId: string, plan: string, lostMrr: MoneyValue, immediate?: boolean): Promise<import("../../features/ecommerce/subscriptions").SubscriptionResponse>;
+    /** Subscription renewed. */
+    renew(subscriptionId: string, userId: string, mrr: MoneyValue): Promise<import("../../features/ecommerce/subscriptions").SubscriptionResponse>;
+    /** Trial converted to paid. */
+    trialConverted(subscriptionId: string, userId: string, plan: string, mrr: MoneyValue): Promise<import("../../features/ecommerce/subscriptions").SubscriptionResponse>;
+    /** Trial expired without converting. */
+    trialExpired(subscriptionId: string, userId: string): Promise<import("../../features/ecommerce/subscriptions").SubscriptionResponse>;
+}

package/dist/lib/tracking/ecommerce/subscriptions.js

@@ -0,0 +1,38 @@
+export class SubscriptionTracker {
+    constructor(client) {
+        this.client = client;
+    }
+    /** New subscription started. */
+    start(subscriptionId, userId, plan, mrr, billingCycle) {
+        return this.client.start({ subscriptionId, userId, plan, mrr, billingCycle });
+    }
+    /** Plan changed (upgrade / downgrade). */
+    change(subscriptionId, userId, previousPlan, newPlan, previousMrr, newMrr, changeType) {
+        return this.client.change({
+            subscriptionId,
+            userId,
+            previousPlan,
+            newPlan,
+            previousMrr,
+            newMrr,
+            changeType,
+        });
+    }
+    /** Subscription cancelled. */
+    cancel(subscriptionId, userId, plan, lostMrr, immediate = false) {
+        return this.client.cancel({ subscriptionId, userId, plan, lostMrr, immediate });
+    }
+    /** Subscription renewed. */
+    renew(subscriptionId, userId, mrr) {
+        return this.client.renew(subscriptionId, userId, mrr);
+    }
+    /** Trial converted to paid. */
+    trialConverted(subscriptionId, userId, plan, mrr) {
+        return this.client.trialConverted(subscriptionId, userId, plan, mrr);
+    }
+    /** Trial expired without converting. */
+    trialExpired(subscriptionId, userId) {
+        return this.client.trialExpired(subscriptionId, userId);
+    }
+}
+//# sourceMappingURL=subscriptions.js.map

package/dist/lib/tracking/ecommerce/subscriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.js","sourceRoot":"","sources":["../../../../src/lib/tracking/ecommerce/subscriptions.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,mBAAmB;IAC9B,YAA4B,MAAqB;QAArB,WAAM,GAAN,MAAM,CAAe;IAAG,CAAC;IAErD,gCAAgC;IAChC,KAAK,CACH,cAAsB,EACtB,MAAc,EACd,IAAY,EACZ,GAAe,EACf,YAAgD;QAEhD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,0CAA0C;IAC1C,MAAM,CACJ,cAAsB,EACtB,MAAc,EACd,YAAoB,EACpB,OAAe,EACf,WAAuB,EACvB,MAAkB,EAClB,UAAmD;QAEnD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;YACxB,cAAc;YACd,MAAM;YACN,YAAY;YACZ,OAAO;YACP,WAAW;YACX,MAAM;YACN,UAAU;SACX,CAAC,CAAC;IACL,CAAC;IAED,8BAA8B;IAC9B,MAAM,CAAC,cAAsB,EAAE,MAAc,EAAE,IAAY,EAAE,OAAmB,EAAE,SAAS,GAAG,KAAK;QACjG,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,4BAA4B;IAC5B,KAAK,CAAC,cAAsB,EAAE,MAAc,EAAE,GAAe;QAC3D,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IACxD,CAAC;IAED,+BAA+B;IAC/B,cAAc,CACZ,cAAsB,EACtB,MAAc,EACd,IAAY,EACZ,GAAe;QAEf,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IACvE,CAAC;IAED,wCAAwC;IACxC,YAAY,CAAC,cAAsB,EAAE,MAAc;QACjD,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAC1D,CAAC;CACF"}

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

@@ -0,0 +1,19 @@
+/**
+ * Wishlist shortcuts.
+ */
+import { WishlistTracking } from "../../features/ecommerce/wishlist";
+import type { Product, Wishlist } from "../../types";
+export declare class WishlistTracker {
+    readonly client: WishlistTracking;
+    constructor(client: WishlistTracking);
+    /** Add a product to wishlist. */
+    add(product: Product, wishlistId?: string): Promise<import("../../features/ecommerce/wishlist").WishlistResponse>;
+    /** Remove a product from wishlist. */
+    remove(product: Product, wishlistId?: string): Promise<import("../../features/ecommerce/wishlist").WishlistResponse>;
+    /** Track a wishlist view. */
+    view(wishlist: Wishlist): Promise<import("../../features/ecommerce/wishlist").WishlistResponse>;
+    /** Move a wishlist item into the cart. */
+    moveToCart(product: Product, wishlistId?: string): Promise<import("../../features/ecommerce/wishlist").WishlistResponse>;
+    /** Wishlist was shared. */
+    share(wishlistId: string, method: "email" | "link" | "social"): Promise<import("../../features/ecommerce/wishlist").WishlistResponse>;
+}

package/dist/lib/tracking/ecommerce/wishlist.js

@@ -0,0 +1,26 @@
+export class WishlistTracker {
+    constructor(client) {
+        this.client = client;
+    }
+    /** Add a product to wishlist. */
+    add(product, wishlistId) {
+        return this.client.add({ product, wishlistId });
+    }
+    /** Remove a product from wishlist. */
+    remove(product, wishlistId) {
+        return this.client.remove({ product, wishlistId });
+    }
+    /** Track a wishlist view. */
+    view(wishlist) {
+        return this.client.view(wishlist);
+    }
+    /** Move a wishlist item into the cart. */
+    moveToCart(product, wishlistId) {
+        return this.client.moveToCart(product, wishlistId);
+    }
+    /** Wishlist was shared. */
+    share(wishlistId, method) {
+        return this.client.share(wishlistId, method);
+    }
+}
+//# sourceMappingURL=wishlist.js.map

package/dist/lib/tracking/ecommerce/wishlist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wishlist.js","sourceRoot":"","sources":["../../../../src/lib/tracking/ecommerce/wishlist.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,eAAe;IAC1B,YAA4B,MAAwB;QAAxB,WAAM,GAAN,MAAM,CAAkB;IAAG,CAAC;IAExD,iCAAiC;IACjC,GAAG,CAAC,OAAgB,EAAE,UAAmB;QACvC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,sCAAsC;IACtC,MAAM,CAAC,OAAgB,EAAE,UAAmB;QAC1C,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,6BAA6B;IAC7B,IAAI,CAAC,QAAkB;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,0CAA0C;IAC1C,UAAU,CAAC,OAAgB,EAAE,UAAmB;QAC9C,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACrD,CAAC;IAED,2BAA2B;IAC3B,KAAK,CAAC,UAAkB,EAAE,MAAmC;QAC3D,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;CACF"}

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

@@ -0,0 +1,25 @@
+/**
+ * Acquisition shortcuts.
+ */
+import { AcquisitionAnalytics, AcquisitionSource, LifecycleStage } from "../../features/enterprise/acquisition";
+import type { MoneyValue } from "../../types";
+export declare class AcquisitionTracker {
+    readonly client: AcquisitionAnalytics;
+    constructor(client: AcquisitionAnalytics);
+    /** Track how a user was acquired. */
+    acquired(userId: string, source: AcquisitionSource, properties?: Record<string, unknown>): Promise<{
+        tracked: boolean;
+    }>;
+    /** Create a marketing campaign. */
+    campaign(definition: Parameters<AcquisitionAnalytics["createCampaign"]>[0]): Promise<{
+        created: boolean;
+    }>;
+    /** Record campaign spend. */
+    spend(campaignId: string, amount: MoneyValue, date: string): Promise<{
+        tracked: boolean;
+    }>;
+    /** Track a lifecycle stage transition. */
+    lifecycle(userId: string, fromStage: LifecycleStage, toStage: LifecycleStage): Promise<{
+        tracked: boolean;
+    }>;
+}

package/dist/lib/tracking/enterprise/acquisition.js

@@ -0,0 +1,22 @@
+export class AcquisitionTracker {
+    constructor(client) {
+        this.client = client;
+    }
+    /** Track how a user was acquired. */
+    acquired(userId, source, properties) {
+        return this.client.trackAcquisition({ userId, source, properties });
+    }
+    /** Create a marketing campaign. */
+    campaign(definition) {
+        return this.client.createCampaign(definition);
+    }
+    /** Record campaign spend. */
+    spend(campaignId, amount, date) {
+        return this.client.trackCampaignSpend({ campaignId, amount, date });
+    }
+    /** Track a lifecycle stage transition. */
+    lifecycle(userId, fromStage, toStage) {
+        return this.client.trackLifecycleTransition({ userId, fromStage, toStage });
+    }
+}
+//# sourceMappingURL=acquisition.js.map

package/dist/lib/tracking/enterprise/acquisition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acquisition.js","sourceRoot":"","sources":["../../../../src/lib/tracking/enterprise/acquisition.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,kBAAkB;IAC7B,YAA4B,MAA4B;QAA5B,WAAM,GAAN,MAAM,CAAsB;IAAG,CAAC;IAE5D,qCAAqC;IACrC,QAAQ,CAAC,MAAc,EAAE,MAAyB,EAAE,UAAoC;QACtF,OAAO,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,mCAAmC;IACnC,QAAQ,CAAC,UAAiE;QACxE,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAChD,CAAC;IAED,6BAA6B;IAC7B,KAAK,CAAC,UAAkB,EAAE,MAAkB,EAAE,IAAY;QACxD,OAAO,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,0CAA0C;IAC1C,SAAS,CAAC,MAAc,EAAE,SAAyB,EAAE,OAAuB;QAC1E,OAAO,IAAI,CAAC,MAAM,CAAC,wBAAwB,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9E,CAAC;CACF"}

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

@@ -0,0 +1,32 @@
+/**
+ * Alert shortcuts.
+ */
+import { AlertsAnalytics } from "../../features/enterprise/alerts";
+export declare class AlertTracker {
+    readonly client: AlertsAnalytics;
+    constructor(client: AlertsAnalytics);
+    /** Create an alert rule. */
+    create(definition: Parameters<AlertsAnalytics["createAlert"]>[0]): Promise<{
+        alertId: string;
+    }>;
+    /** Update an alert rule. */
+    update(alertId: string, updates: Record<string, unknown>): Promise<{
+        updated: boolean;
+    }>;
+    /** Delete an alert rule. */
+    delete(alertId: string): Promise<{
+        deleted: boolean;
+    }>;
+    /** Acknowledge a triggered alert instance. */
+    acknowledge(instanceId: string, acknowledgedBy: string): Promise<{
+        acknowledged: boolean;
+    }>;
+    /** Resolve a triggered alert instance. */
+    resolve(instanceId: string, notes?: string): Promise<{
+        resolved: boolean;
+    }>;
+    /** Mute an alert rule for a number of minutes. */
+    mute(alertId: string, durationMinutes: number): Promise<{
+        muted: boolean;
+    }>;
+}

package/dist/lib/tracking/enterprise/alerts.js

@@ -0,0 +1,30 @@
+export class AlertTracker {
+    constructor(client) {
+        this.client = client;
+    }
+    /** Create an alert rule. */
+    create(definition) {
+        return this.client.createAlert(definition);
+    }
+    /** Update an alert rule. */
+    update(alertId, updates) {
+        return this.client.updateAlert(alertId, updates);
+    }
+    /** Delete an alert rule. */
+    delete(alertId) {
+        return this.client.deleteAlert(alertId);
+    }
+    /** Acknowledge a triggered alert instance. */
+    acknowledge(instanceId, acknowledgedBy) {
+        return this.client.acknowledgeAlert(instanceId, acknowledgedBy);
+    }
+    /** Resolve a triggered alert instance. */
+    resolve(instanceId, notes) {
+        return this.client.resolveAlert(instanceId, notes);
+    }
+    /** Mute an alert rule for a number of minutes. */
+    mute(alertId, durationMinutes) {
+        return this.client.muteAlert(alertId, durationMinutes);
+    }
+}
+//# sourceMappingURL=alerts.js.map

package/dist/lib/tracking/enterprise/alerts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts.js","sourceRoot":"","sources":["../../../../src/lib/tracking/enterprise/alerts.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,YAAY;IACvB,YAA4B,MAAuB;QAAvB,WAAM,GAAN,MAAM,CAAiB;IAAG,CAAC;IAEvD,4BAA4B;IAC5B,MAAM,CAAC,UAAyD;QAC9D,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;IAED,4BAA4B;IAC5B,MAAM,CAAC,OAAe,EAAE,OAAgC;QACtD,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,4BAA4B;IAC5B,MAAM,CAAC,OAAe;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,8CAA8C;IAC9C,WAAW,CAAC,UAAkB,EAAE,cAAsB;QACpD,OAAO,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAClE,CAAC;IAED,0CAA0C;IAC1C,OAAO,CAAC,UAAkB,EAAE,KAAc;QACxC,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC;IAED,kDAAkD;IAClD,IAAI,CAAC,OAAe,EAAE,eAAuB;QAC3C,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACzD,CAAC;CACF"}

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

@@ -0,0 +1,23 @@
+/**
+ * Churn shortcuts.
+ */
+import { ChurnAnalytics, UsageDecayConfig, PreventionActionConfig } from "../../features/enterprise/churn";
+export declare class ChurnTracker {
+    readonly client: ChurnAnalytics;
+    constructor(client: ChurnAnalytics);
+    /** Track usage decay over time. */
+    decay(userId: string, metric: UsageDecayConfig["metric"], periods: UsageDecayConfig["periods"]): Promise<import("../../features/enterprise/churn").UsageDecay>;
+    /** Record an NPS / CSAT-style score. */
+    nps(userId: string, score: number, feedback?: string): Promise<{
+        tracked: boolean;
+    }>;
+    /** Record an actual churn event. */
+    churned(userId: string, churnType: "voluntary" | "involuntary", reason?: string): Promise<{
+        tracked: boolean;
+        churnId: string;
+    }>;
+    /** Record a retention/save action. */
+    prevention(userId: string, actionType: PreventionActionConfig["actionType"], details?: Record<string, unknown>): Promise<{
+        tracked: boolean;
+    }>;
+}

package/dist/lib/tracking/enterprise/churn.js

@@ -0,0 +1,22 @@
+export class ChurnTracker {
+    constructor(client) {
+        this.client = client;
+    }
+    /** Track usage decay over time. */
+    decay(userId, metric, periods) {
+        return this.client.trackUsageDecay({ userId, metric, periods });
+    }
+    /** Record an NPS / CSAT-style score. */
+    nps(userId, score, feedback) {
+        return this.client.trackNPS({ userId, score, feedback });
+    }
+    /** Record an actual churn event. */
+    churned(userId, churnType, reason) {
+        return this.client.trackChurn({ userId, churnType, reason });
+    }
+    /** Record a retention/save action. */
+    prevention(userId, actionType, details) {
+        return this.client.trackPreventionAction({ userId, actionType, details });
+    }
+}
+//# sourceMappingURL=churn.js.map

package/dist/lib/tracking/enterprise/churn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"churn.js","sourceRoot":"","sources":["../../../../src/lib/tracking/enterprise/churn.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,YAAY;IACvB,YAA4B,MAAsB;QAAtB,WAAM,GAAN,MAAM,CAAgB;IAAG,CAAC;IAEtD,mCAAmC;IACnC,KAAK,CAAC,MAAc,EAAE,MAAkC,EAAE,OAAoC;QAC5F,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,wCAAwC;IACxC,GAAG,CAAC,MAAc,EAAE,KAAa,EAAE,QAAiB;QAClD,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,oCAAoC;IACpC,OAAO,CAAC,MAAc,EAAE,SAAsC,EAAE,MAAe;QAC7E,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,sCAAsC;IACtC,UAAU,CAAC,MAAc,EAAE,UAAgD,EAAE,OAAiC;QAC5G,OAAO,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;CACF"}

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

@@ -0,0 +1,18 @@
+/**
+ * Cohort shortcuts.
+ */
+import { Cohorts } from "../../features/enterprise/cohorts";
+export declare class CohortTracker {
+    readonly client: Cohorts;
+    constructor(client: Cohorts);
+    /** Define a new cohort (admin / setup). */
+    create(definition: Parameters<Cohorts["createCohort"]>[0]): Promise<import("../../features/enterprise/cohorts").CohortResponse>;
+    /** Define a new segment. */
+    segment(definition: Parameters<Cohorts["createSegment"]>[0]): Promise<{
+        segmentId: string;
+    }>;
+    /** Check whether a user is in a cohort. */
+    isMember(userId: string, cohortId: string): Promise<{
+        isMember: boolean;
+    }>;
+}

package/dist/lib/tracking/enterprise/cohorts.js

@@ -0,0 +1,18 @@
+export class CohortTracker {
+    constructor(client) {
+        this.client = client;
+    }
+    /** Define a new cohort (admin / setup). */
+    create(definition) {
+        return this.client.createCohort(definition);
+    }
+    /** Define a new segment. */
+    segment(definition) {
+        return this.client.createSegment(definition);
+    }
+    /** Check whether a user is in a cohort. */
+    isMember(userId, cohortId) {
+        return this.client.isUserInCohort(userId, cohortId);
+    }
+}
+//# sourceMappingURL=cohorts.js.map

package/dist/lib/tracking/enterprise/cohorts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cohorts.js","sourceRoot":"","sources":["../../../../src/lib/tracking/enterprise/cohorts.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,aAAa;IACxB,YAA4B,MAAe;QAAf,WAAM,GAAN,MAAM,CAAS;IAAG,CAAC;IAE/C,2CAA2C;IAC3C,MAAM,CAAC,UAAkD;QACvD,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;IAC9C,CAAC;IAED,4BAA4B;IAC5B,OAAO,CAAC,UAAmD;QACzD,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC;IAED,2CAA2C;IAC3C,QAAQ,CAAC,MAAc,EAAE,QAAgB;QACvC,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACtD,CAAC;CACF"}

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

@@ -0,0 +1,31 @@
+/**
+ * Engagement shortcuts.
+ */
+import { Engagement, ContentConsumptionConfig, UserActivityConfig } from "../../features/enterprise/engagement";
+export declare class EngagementTracker {
+    readonly client: Engagement;
+    constructor(client: Engagement);
+    /** Time spent dwelling on a feature (ms). */
+    dwell(featureId: string, dwellTimeMs: number, properties?: Record<string, unknown>): Promise<import("../../features/enterprise/engagement").EngagementResponse>;
+    /** End-of-session depth metrics. */
+    sessionDepth(sessionId: string, pagesVisited: number, featuresUsed: number, actionsTaken: number, durationMs: number): Promise<import("../../features/enterprise/engagement").EngagementResponse>;
+    /** How much of a content piece a user consumed. */
+    contentConsumption(contentId: string, contentType: ContentConsumptionConfig["contentType"], percentageConsumed: number, timeSpentMs: number): Promise<import("../../features/enterprise/engagement").EngagementResponse>;
+    /** User activity ping. */
+    activity(userId: string, activityType: UserActivityConfig["activityType"], durationMs: number): Promise<import("../../features/enterprise/engagement").EngagementResponse>;
+    /** Auto-track dwell time on a feature; returns a teardown that emits the event. */
+    autoTrackDwell(featureId: string, options?: {
+        userId?: string;
+        sessionId?: string;
+    }): import("../../utils/browser").Teardown;
+    /**
+     * Auto-track session-level engagement (session depth + activity transitions).
+     * Returns a teardown function. Safe no-op outside the browser.
+     */
+    autoTrack(options?: {
+        userId?: string;
+        sessionId?: string;
+        idleAfterMs?: number;
+        pollMs?: number;
+    }): import("../../utils/browser").Teardown;
+}

package/dist/lib/tracking/enterprise/engagement.js

@@ -0,0 +1,44 @@
+export class EngagementTracker {
+    constructor(client) {
+        this.client = client;
+    }
+    /** Time spent dwelling on a feature (ms). */
+    dwell(featureId, dwellTimeMs, properties) {
+        return this.client.trackDwellTime({ featureId, dwellTimeMs, properties });
+    }
+    /** End-of-session depth metrics. */
+    sessionDepth(sessionId, pagesVisited, featuresUsed, actionsTaken, durationMs) {
+        return this.client.trackSessionDepth({
+            sessionId,
+            pagesVisited,
+            featuresUsed,
+            actionsTaken,
+            durationMs,
+        });
+    }
+    /** How much of a content piece a user consumed. */
+    contentConsumption(contentId, contentType, percentageConsumed, timeSpentMs) {
+        return this.client.trackContentConsumption({
+            contentId,
+            contentType,
+            percentageConsumed,
+            timeSpentMs,
+        });
+    }
+    /** User activity ping. */
+    activity(userId, activityType, durationMs) {
+        return this.client.trackUserActivity({ userId, activityType, durationMs });
+    }
+    /** Auto-track dwell time on a feature; returns a teardown that emits the event. */
+    autoTrackDwell(featureId, options) {
+        return this.client.autoTrackDwell(featureId, options);
+    }
+    /**
+     * Auto-track session-level engagement (session depth + activity transitions).
+     * Returns a teardown function. Safe no-op outside the browser.
+     */
+    autoTrack(options) {
+        return this.client.autoTrack(options);
+    }
+}
+//# sourceMappingURL=engagement.js.map

package/dist/lib/tracking/enterprise/engagement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engagement.js","sourceRoot":"","sources":["../../../../src/lib/tracking/enterprise/engagement.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,iBAAiB;IAC5B,YAA4B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAElD,6CAA6C;IAC7C,KAAK,CAAC,SAAiB,EAAE,WAAmB,EAAE,UAAoC;QAChF,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,oCAAoC;IACpC,YAAY,CACV,SAAiB,EACjB,YAAoB,EACpB,YAAoB,EACpB,YAAoB,EACpB,UAAkB;QAElB,OAAO,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC;YACnC,SAAS;YACT,YAAY;YACZ,YAAY;YACZ,YAAY;YACZ,UAAU;SACX,CAAC,CAAC;IACL,CAAC;IAED,mDAAmD;IACnD,kBAAkB,CAChB,SAAiB,EACjB,WAAoD,EACpD,kBAA0B,EAC1B,WAAmB;QAEnB,OAAO,IAAI,CAAC,MAAM,CAAC,uBAAuB,CAAC;YACzC,SAAS;YACT,WAAW;YACX,kBAAkB;YAClB,WAAW;SACZ,CAAC,CAAC;IACL,CAAC;IAED,0BAA0B;IAC1B,QAAQ,CAAC,MAAc,EAAE,YAAgD,EAAE,UAAkB;QAC3F,OAAO,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,mFAAmF;IACnF,cAAc,CAAC,SAAiB,EAAE,OAAiD;QACjF,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,OAAwF;QAChG,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;CACF"}

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

@@ -0,0 +1,18 @@
+/**
+ * Forecasting shortcuts.
+ */
+import { Forecasting, ForecastMetric } from "../../features/enterprise/forecasting";
+type Granularity = "day" | "week" | "month";
+export declare class ForecastingTracker {
+    readonly client: Forecasting;
+    constructor(client: Forecasting);
+    /** Forecast active users. */
+    activeUsers(metric: ForecastMetric, periods: number, granularity: Granularity): Promise<import("../../features/enterprise/forecasting").ForecastResult>;
+    /** Forecast revenue. */
+    revenue(periods: number, granularity: Granularity): Promise<import("../../features/enterprise/forecasting").RevenueForecastResult>;
+    /** Forecast adoption of a specific feature. */
+    featureAdoption(featureId: string, periods: number, granularity: Granularity): Promise<import("../../features/enterprise/forecasting").ForecastResult>;
+    /** Forecast churn. */
+    churn(periods: number, granularity: Granularity): Promise<import("../../features/enterprise/forecasting").ChurnForecastResult>;
+}
+export {};

package/dist/lib/tracking/enterprise/forecasting.js

@@ -0,0 +1,22 @@
+export class ForecastingTracker {
+    constructor(client) {
+        this.client = client;
+    }
+    /** Forecast active users. */
+    activeUsers(metric, periods, granularity) {
+        return this.client.forecastActiveUsers({ metric, periods, granularity });
+    }
+    /** Forecast revenue. */
+    revenue(periods, granularity) {
+        return this.client.forecastRevenue({ periods, granularity });
+    }
+    /** Forecast adoption of a specific feature. */
+    featureAdoption(featureId, periods, granularity) {
+        return this.client.forecastFeatureAdoption({ featureId, periods, granularity });
+    }
+    /** Forecast churn. */
+    churn(periods, granularity) {
+        return this.client.forecastChurn({ periods, granularity });
+    }
+}
+//# sourceMappingURL=forecasting.js.map

package/dist/lib/tracking/enterprise/forecasting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forecasting.js","sourceRoot":"","sources":["../../../../src/lib/tracking/enterprise/forecasting.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,kBAAkB;IAC7B,YAA4B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEnD,6BAA6B;IAC7B,WAAW,CAAC,MAAsB,EAAE,OAAe,EAAE,WAAwB;QAC3E,OAAO,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,wBAAwB;IACxB,OAAO,CAAC,OAAe,EAAE,WAAwB;QAC/C,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,+CAA+C;IAC/C,eAAe,CAAC,SAAiB,EAAE,OAAe,EAAE,WAAwB;QAC1E,OAAO,IAAI,CAAC,MAAM,CAAC,uBAAuB,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,sBAAsB;IACtB,KAAK,CAAC,OAAe,EAAE,WAAwB;QAC7C,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/dist/lib/tracking/enterprise/index.d.ts

@@ -0,0 +1,11 @@
+export { EngagementTracker } from "./engagement";
+export { CohortTracker } from "./cohorts";
+export { ChurnTracker } from "./churn";
+export { MonetizationTracker } from "./monetization";
+export { MultiPathFunnelTracker } from "./multi-path-funnels";
+export { SupportTracker } from "./support";
+export { AcquisitionTracker } from "./acquisition";
+export { PathTracker } from "./paths";
+export { AlertTracker } from "./alerts";
+export { SecurityTracker } from "./security";
+export { ForecastingTracker } from "./forecasting";

package/dist/lib/tracking/enterprise/index.js

@@ -0,0 +1,12 @@
+export { EngagementTracker } from "./engagement";
+export { CohortTracker } from "./cohorts";
+export { ChurnTracker } from "./churn";
+export { MonetizationTracker } from "./monetization";
+export { MultiPathFunnelTracker } from "./multi-path-funnels";
+export { SupportTracker } from "./support";
+export { AcquisitionTracker } from "./acquisition";
+export { PathTracker } from "./paths";
+export { AlertTracker } from "./alerts";
+export { SecurityTracker } from "./security";
+export { ForecastingTracker } from "./forecasting";
+//# sourceMappingURL=index.js.map

package/dist/lib/tracking/enterprise/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/tracking/enterprise/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * Monetization shortcuts.
+ */
+import { Monetization, RevenueType } from "../../features/enterprise/monetization";
+import type { CurrencyCode } from "../../types";
+export declare class MonetizationTracker {
+    readonly client: Monetization;
+    constructor(client: Monetization);
+    /** Track a revenue event. */
+    revenue(userId: string, amount: number, currency: CurrencyCode, type: RevenueType, properties?: Record<string, unknown>): Promise<{
+        tracked: boolean;
+        revenueId: string;
+    }>;
+}