rowpipe 2.2.1 → 2.10.2

package/dist/analytics/outliers.js

@@ -0,0 +1,114 @@
+/**
+ * Streaming Outlier & Anomaly Detection Transform.
+ */
+export function outliersTransform(options) {
+    const col = options.column;
+    const method = options.method || "zscore";
+    const threshold = options.threshold !== undefined
+        ? options.threshold
+        : method === "iqr"
+            ? 1.5
+            : 3.0;
+    return async function* (input) {
+        // Pass 1: Collect numeric stats
+        const allRows = [];
+        const values = [];
+        let sum = 0;
+        for await (const batch of input) {
+            for (const row of batch.rows) {
+                allRows.push(row);
+                const rawVal = row[col];
+                if (rawVal !== null && rawVal !== undefined && rawVal !== "") {
+                    const num = typeof rawVal === "number" ? rawVal : parseFloat(String(rawVal));
+                    if (Number.isFinite(num)) {
+                        values.push(num);
+                        sum += num;
+                    }
+                }
+            }
+        }
+        if (values.length === 0) {
+            yield { rows: allRows, offset: 0 };
+            return;
+        }
+        // Compute statistical boundaries
+        let isOutlierFn;
+        if (method === "zscore") {
+            const n = values.length;
+            const mean = sum / n;
+            const variance = values.reduce((acc, v) => acc + (v - mean) ** 2, 0) / (n > 1 ? n - 1 : 1);
+            const stddev = Math.sqrt(variance);
+            isOutlierFn = (v) => {
+                if (stddev === 0)
+                    return { isOutlier: false, score: 0 };
+                const z = (v - mean) / stddev;
+                const score = parseFloat(z.toFixed(3));
+                return { isOutlier: Math.abs(z) > threshold, score };
+            };
+        }
+        else if (method === "iqr") {
+            values.sort((a, b) => a - b);
+            const n = values.length;
+            const q1 = values[Math.floor(0.25 * (n - 1))];
+            const q3 = values[Math.floor(0.75 * (n - 1))];
+            const iqr = q3 - q1;
+            const lower = q1 - threshold * iqr;
+            const upper = q3 + threshold * iqr;
+            isOutlierFn = (v) => {
+                const isOut = v < lower || v > upper;
+                const dist = v < lower ? lower - v : v > upper ? v - upper : 0;
+                const score = iqr > 0 ? parseFloat((dist / iqr).toFixed(3)) : 0;
+                return { isOutlier: isOut, score };
+            };
+        }
+        else {
+            // MAD (Median Absolute Deviation)
+            values.sort((a, b) => a - b);
+            const median = values[Math.floor(values.length / 2)];
+            const absDevs = values.map((v) => Math.abs(v - median)).sort((a, b) => a - b);
+            const mad = absDevs[Math.floor(absDevs.length / 2)] || 0.0001;
+            isOutlierFn = (v) => {
+                const modZ = (0.6745 * Math.abs(v - median)) / mad;
+                const score = parseFloat(modZ.toFixed(3));
+                return { isOutlier: modZ > threshold, score };
+            };
+        }
+        // Pass 2: Filter or annotate rows
+        const outRows = [];
+        for (const row of allRows) {
+            const rawVal = row[col];
+            const num = typeof rawVal === "number" ? rawVal : parseFloat(String(rawVal));
+            const hasValidNum = Number.isFinite(num);
+            const check = hasValidNum ? isOutlierFn(num) : { isOutlier: false, score: 0 };
+            if (options.onlyOutliers) {
+                if (check.isOutlier) {
+                    if (options.addColumns) {
+                        outRows.push({ ...row, _is_outlier: true, _outlier_score: check.score });
+                    }
+                    else {
+                        outRows.push(row);
+                    }
+                }
+            }
+            else if (options.invert) {
+                if (!check.isOutlier) {
+                    outRows.push(row);
+                }
+            }
+            else {
+                if (options.addColumns) {
+                    outRows.push({
+                        ...row,
+                        _is_outlier: check.isOutlier,
+                        _outlier_score: check.score,
+                    });
+                }
+                else {
+                    outRows.push(row);
+                }
+            }
+        }
+        yield { rows: outRows, offset: 0 };
+    };
+}
+//# sourceMappingURL=outliers.js.map

package/dist/analytics/outliers.js.map

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

package/dist/analytics/pareto.d.ts

@@ -0,0 +1,36 @@
+import type { Row, DataBatch } from "../core/types.js";
+export interface ParetoOptions {
+    itemCol?: string;
+    valueCol?: string;
+    aThreshold?: number;
+    bThreshold?: number;
+    summary?: boolean;
+}
+export interface ParetoItemResult {
+    rank: number;
+    item: string;
+    value: number;
+    share_pct: number;
+    cumulative_value: number;
+    cumulative_pct: number;
+    abc_class: "A" | "B" | "C";
+}
+export interface ParetoSummaryCategory {
+    abc_class: "A" | "B" | "C";
+    item_count: number;
+    item_percentage: number;
+    total_value: number;
+    value_percentage: number;
+    description: string;
+}
+export interface ParetoResult {
+    items: ParetoItemResult[];
+    summary: ParetoSummaryCategory[];
+    total_items: number;
+    total_value: number;
+    pareto_80_item_count: number;
+    pareto_80_item_percentage: number;
+    formattedRows: Row[];
+}
+export declare function computePareto(batchIterator: AsyncIterable<DataBatch>, options?: ParetoOptions): Promise<ParetoResult>;
+//# sourceMappingURL=pareto.d.ts.map

package/dist/analytics/pareto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pareto.d.ts","sourceRoot":"","sources":["../../src/analytics/pareto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,yBAAyB,EAAE,MAAM,CAAC;IAClC,aAAa,EAAE,GAAG,EAAE,CAAC;CACtB;AAED,wBAAsB,aAAa,CACjC,aAAa,EAAE,aAAa,CAAC,SAAS,CAAC,EACvC,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAuJvB"}

package/dist/analytics/pareto.js

@@ -0,0 +1,140 @@
+export async function computePareto(batchIterator, options = {}) {
+    let itemCol = options.itemCol;
+    let valueCol = options.valueCol;
+    const aThreshold = options.aThreshold ?? 80;
+    const bThreshold = options.bThreshold ?? 95;
+    const itemMap = new Map();
+    for await (const batch of batchIterator) {
+        if (batch.rows.length === 0)
+            continue;
+        if (!itemCol || !valueCol) {
+            const firstRow = batch.rows[0];
+            const keys = Object.keys(firstRow);
+            if (!itemCol) {
+                itemCol =
+                    keys.find((k) => /^(item|product|sku|category|customer|name|title|key|id)$/i.test(k)) ??
+                        keys[0];
+            }
+            if (!valueCol) {
+                valueCol =
+                    keys.find((k) => /(value|revenue|sales|amount|total|spend|count|qty|quantity|price)/i.test(k)) ??
+                        keys[1];
+            }
+        }
+        for (const row of batch.rows) {
+            const rawItem = row[itemCol];
+            if (rawItem === null || rawItem === undefined || rawItem === "")
+                continue;
+            const it = String(rawItem);
+            const rawVal = row[valueCol];
+            let numVal = 0;
+            if (typeof rawVal === "number") {
+                numVal = rawVal;
+            }
+            else {
+                const parsed = parseFloat(String(rawVal));
+                if (!isNaN(parsed))
+                    numVal = parsed;
+            }
+            itemMap.set(it, (itemMap.get(it) || 0) + numVal);
+        }
+    }
+    const sortedList = Array.from(itemMap.entries()).sort((a, b) => b[1] - a[1]);
+    const totalItems = sortedList.length;
+    let totalValue = 0;
+    for (const [, val] of sortedList) {
+        totalValue += val;
+    }
+    const items = [];
+    let runningSum = 0;
+    let pareto80Count = 0;
+    for (let rank = 1; rank <= totalItems; rank++) {
+        const [name, val] = sortedList[rank - 1];
+        runningSum += val;
+        const sharePct = totalValue > 0 ? (val / totalValue) * 100 : 0;
+        const cumPct = totalValue > 0 ? (runningSum / totalValue) * 100 : 0;
+        let abc = "C";
+        if (cumPct <= aThreshold || (rank === 1 && cumPct > aThreshold)) {
+            abc = "A";
+        }
+        else if (cumPct <= bThreshold) {
+            abc = "B";
+        }
+        else {
+            abc = "C";
+        }
+        if (cumPct <= 80 || (pareto80Count === 0 && cumPct > 80)) {
+            pareto80Count = rank;
+        }
+        items.push({
+            rank,
+            item: name,
+            value: Math.round(val * 100) / 100,
+            share_pct: Math.round(sharePct * 100) / 100,
+            cumulative_value: Math.round(runningSum * 100) / 100,
+            cumulative_pct: Math.round(cumPct * 10) / 10,
+            abc_class: abc,
+        });
+    }
+    // Calculate Summary Categories
+    const classA = items.filter((it) => it.abc_class === "A");
+    const classB = items.filter((it) => it.abc_class === "B");
+    const classC = items.filter((it) => it.abc_class === "C");
+    const sumA = classA.reduce((acc, it) => acc + it.value, 0);
+    const sumB = classB.reduce((acc, it) => acc + it.value, 0);
+    const sumC = classC.reduce((acc, it) => acc + it.value, 0);
+    const summary = [
+        {
+            abc_class: "A",
+            item_count: classA.length,
+            item_percentage: totalItems > 0 ? Math.round((classA.length / totalItems) * 1000) / 10 : 0,
+            total_value: Math.round(sumA * 100) / 100,
+            value_percentage: totalValue > 0 ? Math.round((sumA / totalValue) * 1000) / 10 : 0,
+            description: "Vital Few: Top driving ~80% of value",
+        },
+        {
+            abc_class: "B",
+            item_count: classB.length,
+            item_percentage: totalItems > 0 ? Math.round((classB.length / totalItems) * 1000) / 10 : 0,
+            total_value: Math.round(sumB * 100) / 100,
+            value_percentage: totalValue > 0 ? Math.round((sumB / totalValue) * 1000) / 10 : 0,
+            description: "Moderate: Intermediate ~15% of value",
+        },
+        {
+            abc_class: "C",
+            item_count: classC.length,
+            item_percentage: totalItems > 0 ? Math.round((classC.length / totalItems) * 1000) / 10 : 0,
+            total_value: Math.round(sumC * 100) / 100,
+            value_percentage: totalValue > 0 ? Math.round((sumC / totalValue) * 1000) / 10 : 0,
+            description: "Trivial Many: Long tail ~5% of value",
+        },
+    ];
+    const pareto80Pct = totalItems > 0 ? Math.round((pareto80Count / totalItems) * 1000) / 10 : 0;
+    const formattedRows = options.summary
+        ? summary.map((s) => ({
+            abc_class: s.abc_class,
+            items: `${s.item_count} (${s.item_percentage.toFixed(1)}%)`,
+            total_value: s.total_value,
+            value_share: `${s.value_percentage.toFixed(1)}%`,
+            description: s.description,
+        }))
+        : items.map((it) => ({
+            rank: it.rank,
+            item: it.item,
+            value: it.value,
+            share: `${it.share_pct.toFixed(2)}%`,
+            cum_value: it.cumulative_value,
+            cum_share: `${it.cumulative_pct.toFixed(1)}%`,
+            class: it.abc_class,
+        }));
+    return {
+        items,
+        summary,
+        total_items: totalItems,
+        total_value: Math.round(totalValue * 100) / 100,
+        pareto_80_item_count: pareto80Count,
+        pareto_80_item_percentage: pareto80Pct,
+        formattedRows,
+    };
+}
+//# sourceMappingURL=pareto.js.map

package/dist/analytics/pareto.js.map

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

package/dist/analytics/quantiles.d.ts

@@ -0,0 +1,18 @@
+import type { DataStream } from "../core/types.js";
+export interface QuantilesResult {
+    column: string;
+    count: number;
+    min: number;
+    max: number;
+    mean: number;
+    median: number;
+    q1: number;
+    q3: number;
+    iqr: number;
+    percentiles: Record<string, number>;
+}
+/**
+ * Computes exact/interpolated percentiles from numeric stream.
+ */
+export declare function computeQuantiles(stream: DataStream, column: string, requestedPercentiles?: number[]): Promise<QuantilesResult>;
+//# sourceMappingURL=quantiles.d.ts.map

package/dist/analytics/quantiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quantiles.d.ts","sourceRoot":"","sources":["../../src/analytics/quantiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,EACd,oBAAoB,GAAE,MAAM,EAA6B,GACxD,OAAO,CAAC,eAAe,CAAC,CA8D1B"}

package/dist/analytics/quantiles.js

@@ -0,0 +1,62 @@
+/**
+ * Computes exact/interpolated percentiles from numeric stream.
+ */
+export async function computeQuantiles(stream, column, requestedPercentiles = [25, 50, 75, 90, 95, 99]) {
+    const values = [];
+    let sum = 0;
+    for await (const batch of stream) {
+        for (const row of batch.rows) {
+            const rawVal = row[column];
+            if (rawVal === null || rawVal === undefined || rawVal === "")
+                continue;
+            const num = typeof rawVal === "number" ? rawVal : parseFloat(String(rawVal));
+            if (Number.isFinite(num)) {
+                values.push(num);
+                sum += num;
+            }
+        }
+    }
+    if (values.length === 0) {
+        throw new Error(`No numeric values found in column: "${column}"`);
+    }
+    // Sort values
+    values.sort((a, b) => a - b);
+    const n = values.length;
+    const mean = sum / n;
+    const min = values[0];
+    const max = values[n - 1];
+    function getPercentile(p) {
+        if (p <= 0)
+            return min;
+        if (p >= 100)
+            return max;
+        const rank = (p / 100) * (n - 1);
+        const low = Math.floor(rank);
+        const high = Math.ceil(rank);
+        const weight = rank - low;
+        return values[low] * (1 - weight) + values[high] * weight;
+    }
+    const q1 = getPercentile(25);
+    const median = getPercentile(50);
+    const q3 = getPercentile(75);
+    const iqr = q3 - q1;
+    const percentiles = {};
+    const allPs = Array.from(new Set([...requestedPercentiles, 25, 50, 75])).sort((a, b) => a - b);
+    for (const p of allPs) {
+        const key = `p${p}`;
+        percentiles[key] = parseFloat(getPercentile(p).toFixed(4));
+    }
+    return {
+        column,
+        count: n,
+        min,
+        max,
+        mean: parseFloat(mean.toFixed(4)),
+        median: parseFloat(median.toFixed(4)),
+        q1: parseFloat(q1.toFixed(4)),
+        q3: parseFloat(q3.toFixed(4)),
+        iqr: parseFloat(iqr.toFixed(4)),
+        percentiles,
+    };
+}
+//# sourceMappingURL=quantiles.js.map

package/dist/analytics/quantiles.js.map

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

package/dist/analytics/regression.d.ts

@@ -0,0 +1,18 @@
+import type { DataStream } from "../core/types.js";
+export interface LinearRegressionResult {
+    xColumn: string;
+    yColumn: string;
+    sampleSize: number;
+    slope: number;
+    intercept: number;
+    r: number;
+    r2: number;
+    stdError: number;
+    formula: string;
+    interpretation: string;
+}
+/**
+ * Computes Ordinary Least Squares (OLS) Linear Regression in a single pass.
+ */
+export declare function computeLinearRegression(stream: DataStream, xColumn: string, yColumn: string): Promise<LinearRegressionResult>;
+//# sourceMappingURL=regression.d.ts.map

package/dist/analytics/regression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regression.d.ts","sourceRoot":"","sources":["../../src/analytics/regression.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,sBAAsB,CAAC,CAkFjC"}

package/dist/analytics/regression.js

@@ -0,0 +1,79 @@
+/**
+ * Computes Ordinary Least Squares (OLS) Linear Regression in a single pass.
+ */
+export async function computeLinearRegression(stream, xColumn, yColumn) {
+    let n = 0;
+    let meanX = 0;
+    let meanY = 0;
+    let m2X = 0;
+    let m2Y = 0;
+    let coMoment = 0;
+    for await (const batch of stream) {
+        for (const row of batch.rows) {
+            const rawX = row[xColumn];
+            const rawY = row[yColumn];
+            if (rawX === null || rawX === undefined || rawX === "")
+                continue;
+            if (rawY === null || rawY === undefined || rawY === "")
+                continue;
+            const x = typeof rawX === "number" ? rawX : parseFloat(String(rawX));
+            const y = typeof rawY === "number" ? rawY : parseFloat(String(rawY));
+            if (!Number.isFinite(x) || !Number.isFinite(y))
+                continue;
+            n++;
+            const dx = x - meanX;
+            meanX += dx / n;
+            const dy = y - meanY;
+            meanY += dy / n;
+            m2X += dx * (x - meanX);
+            m2Y += dy * (y - meanY);
+            coMoment += dx * (y - meanY);
+        }
+    }
+    if (n < 2) {
+        throw new Error(`Insufficient numeric data points for regression (found ${n} pairs).`);
+    }
+    const varX = m2X / (n - 1);
+    const varY = m2Y / (n - 1);
+    const cov = coMoment / (n - 1);
+    if (varX === 0) {
+        throw new Error(`Independent variable (${xColumn}) has zero variance.`);
+    }
+    const slope = cov / varX;
+    const intercept = meanY - slope * meanX;
+    const stdX = Math.sqrt(varX);
+    const stdY = Math.sqrt(varY);
+    const r = stdY > 0 ? cov / (stdX * stdY) : 0;
+    const r2 = r * r;
+    // Residual sum of squares & std error
+    const ssTot = m2Y;
+    const ssReg = slope * slope * m2X;
+    const ssRes = Math.max(0, ssTot - ssReg);
+    const stdError = n > 2 ? Math.sqrt(ssRes / (n - 2)) : 0;
+    const sign = intercept >= 0 ? "+" : "-";
+    const absIntercept = Math.abs(intercept);
+    const formula = `${yColumn} = ${slope.toFixed(4)} * ${xColumn} ${sign} ${absIntercept.toFixed(4)}`;
+    let interpretation = "No linear relationship";
+    const absR = Math.abs(r);
+    if (absR >= 0.8)
+        interpretation = `Very strong ${r > 0 ? "positive" : "negative"} linear fit`;
+    else if (absR >= 0.6)
+        interpretation = `Strong ${r > 0 ? "positive" : "negative"} linear fit`;
+    else if (absR >= 0.4)
+        interpretation = `Moderate ${r > 0 ? "positive" : "negative"} linear fit`;
+    else if (absR >= 0.2)
+        interpretation = `Weak ${r > 0 ? "positive" : "negative"} linear fit`;
+    return {
+        xColumn,
+        yColumn,
+        sampleSize: n,
+        slope: parseFloat(slope.toFixed(6)),
+        intercept: parseFloat(intercept.toFixed(6)),
+        r: parseFloat(r.toFixed(4)),
+        r2: parseFloat(r2.toFixed(4)),
+        stdError: parseFloat(stdError.toFixed(4)),
+        formula,
+        interpretation,
+    };
+}
+//# sourceMappingURL=regression.js.map

package/dist/analytics/regression.js.map

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

package/dist/analytics/rfm.d.ts

@@ -0,0 +1,41 @@
+import type { DataBatch } from "../core/types.js";
+export interface RfmOptions {
+    customerIdCol?: string;
+    dateCol?: string;
+    amountCol?: string;
+    asOfDate?: string | Date;
+}
+export interface CustomerRfmRaw {
+    customerId: string;
+    lastDateMs: number;
+    frequency: number;
+    monetary: number;
+}
+export interface CustomerRfmResult {
+    customer_id: string;
+    recency_days: number;
+    frequency: number;
+    monetary: number;
+    r_score: number;
+    f_score: number;
+    m_score: number;
+    rfm_score: string;
+    segment: string;
+}
+export interface RfmSegmentSummary {
+    segment: string;
+    customer_count: number;
+    customer_percentage: number;
+    total_revenue: number;
+    revenue_percentage: number;
+    avg_recency_days: number;
+    avg_frequency: number;
+    avg_monetary: number;
+}
+export declare function classifyRfmSegment(r: number, f: number, m: number): string;
+export declare function computeRfm(batchIterator: AsyncIterable<DataBatch>, options?: RfmOptions): Promise<{
+    customers: CustomerRfmResult[];
+    summary: RfmSegmentSummary[];
+    referenceDate: string;
+}>;
+//# sourceMappingURL=rfm.d.ts.map

package/dist/analytics/rfm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rfm.d.ts","sourceRoot":"","sources":["../../src/analytics/rfm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAO,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,UAAU;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAiDD,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAY1E;AAED,wBAAsB,UAAU,CAC9B,aAAa,EAAE,aAAa,CAAC,SAAS,CAAC,EACvC,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC;IACT,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC,CAuKD"}