umami-compass 0.2.0 → 0.3.1

package/dist/mcp/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/mcp/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5D,eAAO,MAAM,UAAU,wDAIE,CAAC;AAC1B,eAAO,MAAM,UAAU,iDAEsD,CAAC;AAC9E,eAAO,MAAM,cAAc,2BAYV,CAAC;AAClB,eAAO,MAAM,UAAU;;;;;;GAAgE,CAAC;AACxF,eAAO,MAAM,UAAU,2BAAiD,CAAC;AACzE,eAAO,MAAM,cAAc,2BAA+C,CAAC;AAE3E,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA4Bf,CAAC;AAEZ,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,SAAS,EACd,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC1F,KAAK,CAUP;AAED,QAAA,MAAM,iBAAiB;aACrB,MAAM,EAAE,KAAM;aACd,IAAI,EAAE,OAAS;aACf,GAAG,EAAE,QAAU;aACf,KAAK,EAAE,UAAa;aACpB,IAAI,EAAE,WAAc;CACZ,CAAC;AAEX,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,SAAS,EACd,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,OAAO,iBAAiB,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACjB,GACL,KAAK,CAeP;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,SAAS,EACd,YAAY,EAAE,MAAM,EACpB,WAAW,SAAI,GACd,MAAM,OAAO,iBAAiB,CAUhC;AAUD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;iBAcb,CAAC;AAEjB,eAAO,MAAM,sBAAsB;IACjC,IAAI;;;;;;;;;;;;;;;CACL,CAAC;AAEF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;CAGxB,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;CAG9B,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;CAG7B,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;CAU7B,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;iBAKhB,CAAC;AAEjB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;CAGjC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;iBAOnB,CAAC;AAEjB,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;CAGpC,CAAC;AAEF,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAMvF"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/mcp/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,KAAK,EAAc,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5D,eAAO,MAAM,UAAU,wDAIE,CAAC;AAC1B,eAAO,MAAM,UAAU,iDAEsD,CAAC;AAC9E,eAAO,MAAM,cAAc,2BAYV,CAAC;AAClB,eAAO,MAAM,UAAU;;;;;;GAAgE,CAAC;AACxF,eAAO,MAAM,UAAU,2BAAiD,CAAC;AACzE,eAAO,MAAM,cAAc,2BAA+C,CAAC;AAE3E,eAAO,MAAM,oBAAoB;;;;;;;;;EAS/B,CAAC;AA+HH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAoE,CAAC;AAE/F,eAAO,MAAM,gBAAgB,YAC3B,QAAQ,EACR,SAAS,EACT,UAAU,EACV,WAAW,EACX,KAAK,EACL,KAAK,EACL,eAAe,EACf,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,OAAO,EACP,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,WAAW,CACH,CAAC;AAEX,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;EAA2B,CAAC;AAE7D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAGC,CAAC;AAErC,eAAO,MAAM,oBAAoB;;;GAA0C,CAAC;AAkC5E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,KAAK,CA6BpF;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,KAAK,CAc1F;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,SAAS,EACd,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;IACxC,iBAAiB,CAAC,EAAE,KAAK,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACV,GACL,KAAK,CAWP;AAED,QAAA,MAAM,iBAAiB;aACrB,MAAM,EAAE,KAAM;aACd,IAAI,EAAE,OAAS;aACf,GAAG,EAAE,QAAU;aACf,KAAK,EAAE,UAAa;aACpB,IAAI,EAAE,WAAc;CACZ,CAAC;AAEX,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,SAAS,EACd,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;IACxC,iBAAiB,CAAC,EAAE,KAAK,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,OAAO,iBAAiB,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACjB,GACL,KAAK,CAeP;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,SAAS,EACd,YAAY,EAAE,MAAM,EACpB,WAAW,SAAI,GACd,MAAM,OAAO,iBAAiB,CAUhC;AAUD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;iBAcb,CAAC;AAEjB,eAAO,MAAM,sBAAsB;IACjC,IAAI;;;;;;;;;;;;;;;CACL,CAAC;AAEF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;CAGxB,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;CAG9B,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;CAG7B,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;CAU7B,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;iBAKhB,CAAC;AAEjB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;CAGjC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;iBAOnB,CAAC;AAEjB,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;CAGpC,CAAC;AAEF,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAMvF"}

package/dist/mcp/schemas.js

@@ -26,38 +26,222 @@ export const timezoneSchema = z
 export const unitSchema = z.enum(["minute", "hour", "day", "month", "year"]).optional();
 export const pageSchema = z.number().int().min(1).max(10_000).default(1);
 export const pageSizeSchema = z.number().int().min(1).max(100).default(20);
-export const filtersSchema = z
+export const filterOperatorSchema = z.enum([
+    "equals",
+    "not_equals",
+    "contains",
+    "not_contains",
+    "regex",
+    "not_regex",
+    "is_empty",
+    "is_not_empty",
+]);
+const MAX_FILTER_CONDITIONS_PER_FIELD = 10;
+const MAX_FILTER_VALUES_PER_CONDITION = 20;
+const MAX_TOTAL_FILTER_CONDITIONS = 30;
+const MAX_TOTAL_FILTER_VALUES = 100;
+const MAX_SERIALIZED_FILTER_BYTES = 16_384;
+const filterConditionSchema = (maximum) => z
     .object({
-    browser: z.string().max(200).optional(),
-    city: z.string().max(200).optional(),
+    operator: filterOperatorSchema,
+    value: z
+        .union([
+        z.string().max(maximum),
+        z.array(z.string().max(maximum)).min(1).max(MAX_FILTER_VALUES_PER_CONDITION),
+    ])
+        .optional(),
+})
+    .strict()
+    .superRefine(({ operator, value }, context) => {
+    const emptyOperator = operator === "is_empty" || operator === "is_not_empty";
+    if (emptyOperator && value !== undefined) {
+        context.addIssue({
+            code: "custom",
+            message: `${operator} does not accept a value`,
+            path: ["value"],
+        });
+    }
+    else if (!emptyOperator && value === undefined) {
+        context.addIssue({
+            code: "custom",
+            message: `${operator} requires a value`,
+            path: ["value"],
+        });
+    }
+    if (Array.isArray(value) && !["equals", "not_equals"].includes(operator)) {
+        context.addIssue({
+            code: "custom",
+            message: `${operator} accepts one string value`,
+            path: ["value"],
+        });
+    }
+    if ((operator === "equals" || operator === "not_equals") &&
+        (Array.isArray(value) ? value : value === undefined ? [] : [value]).some((item) => item.includes(","))) {
+        context.addIssue({
+            code: "custom",
+            message: "equals values cannot contain commas; pass separate values in the array",
+            path: ["value"],
+        });
+    }
+});
+const textFilterSchema = (maximum) => z.union([
+    z.string().max(maximum),
+    filterConditionSchema(maximum),
+    z.array(filterConditionSchema(maximum)).min(1).max(MAX_FILTER_CONDITIONS_PER_FIELD),
+]);
+const filterFields = {
+    browser: textFilterSchema(200).optional(),
+    city: textFilterSchema(200).optional(),
     cohort: uuidSchema.optional(),
-    country: z.string().max(10).optional(),
-    device: z.string().max(200).optional(),
-    distinctId: z.string().max(500).optional(),
+    country: textFilterSchema(10).optional(),
+    device: textFilterSchema(200).optional(),
+    distinctId: textFilterSchema(500).optional(),
     eventType: z.number().int().positive().optional(),
-    event: z.string().max(500).optional(),
+    event: textFilterSchema(500).optional(),
     excludeBounce: z.boolean().optional(),
-    hostname: z.string().max(500).optional(),
-    language: z.string().max(100).optional(),
-    os: z.string().max(200).optional(),
+    hostname: textFilterSchema(500).optional(),
+    language: textFilterSchema(100).optional(),
+    os: textFilterSchema(200).optional(),
     match: z.enum(["all", "any"]).optional(),
-    path: z.string().max(2_000).optional(),
-    query: z.string().max(2_000).optional(),
-    referrer: z.string().max(2_000).optional(),
-    region: z.string().max(200).optional(),
+    path: textFilterSchema(2_000).optional(),
+    query: textFilterSchema(2_000).optional(),
+    referrer: textFilterSchema(2_000).optional(),
+    region: textFilterSchema(200).optional(),
     segment: uuidSchema.optional(),
-    tag: z.string().max(500).optional(),
-    title: z.string().max(1_000).optional(),
-    utmCampaign: z.string().max(500).optional(),
-    utmContent: z.string().max(500).optional(),
-    utmMedium: z.string().max(500).optional(),
-    utmSource: z.string().max(500).optional(),
-    utmTerm: z.string().max(500).optional(),
-})
-    .strict();
+    tag: textFilterSchema(500).optional(),
+    title: textFilterSchema(1_000).optional(),
+    utmCampaign: textFilterSchema(500).optional(),
+    utmContent: textFilterSchema(500).optional(),
+    utmMedium: textFilterSchema(500).optional(),
+    utmSource: textFilterSchema(500).optional(),
+    utmTerm: textFilterSchema(500).optional(),
+};
+function validateFilterBudget(filters, context) {
+    let conditionCount = 0;
+    let valueCount = 0;
+    for (const value of Object.values(filters)) {
+        const conditions = Array.isArray(value) ? value : [value];
+        for (const condition of conditions) {
+            if (!isFilterCondition(condition))
+                continue;
+            conditionCount += 1;
+            valueCount += Array.isArray(condition.value) ? condition.value.length : 1;
+        }
+    }
+    if (conditionCount > MAX_TOTAL_FILTER_CONDITIONS) {
+        context.addIssue({
+            code: "custom",
+            message: `filters cannot contain more than ${MAX_TOTAL_FILTER_CONDITIONS} structured conditions`,
+        });
+    }
+    if (valueCount > MAX_TOTAL_FILTER_VALUES) {
+        context.addIssue({
+            code: "custom",
+            message: `filters cannot contain more than ${MAX_TOTAL_FILTER_VALUES} structured values`,
+        });
+    }
+    const params = new URLSearchParams();
+    for (const [name, value] of Object.entries(serializeFilters(filters))) {
+        if (value !== undefined)
+            params.append(name, String(value));
+    }
+    if (new TextEncoder().encode(params.toString()).length > MAX_SERIALIZED_FILTER_BYTES) {
+        context.addIssue({
+            code: "custom",
+            message: `serialized filters cannot exceed ${MAX_SERIALIZED_FILTER_BYTES} bytes`,
+        });
+    }
+}
+export const filtersSchema = z.object(filterFields).strict().superRefine(validateFilterBudget);
+export const TRAFFIC_CHANNELS = [
+    "direct",
+    "paidAds",
+    "referral",
+    "affiliate",
+    "sms",
+    "llm",
+    "organicSearch",
+    "paidSearch",
+    "organicSocial",
+    "paidSocial",
+    "email",
+    "organicShopping",
+    "paidShopping",
+    "organicVideo",
+    "paidVideo",
+];
+export const trafficChannelSchema = z.enum(TRAFFIC_CHANNELS);
+export const segmentedFiltersSchema = z
+    .object({ ...filterFields, channel: trafficChannelSchema.optional() })
+    .strict()
+    .superRefine(validateFilterBudget);
+export const trafficSegmentSchema = z.enum(["all", "human"]).default("all");
+const UPSTREAM_OPERATORS = {
+    equals: "eq",
+    not_equals: "neq",
+    contains: "c",
+    not_contains: "dnc",
+    regex: "re",
+    not_regex: "nre",
+    is_empty: "eq",
+    is_not_empty: "neq",
+};
+function isFilterCondition(value) {
+    return (typeof value === "object" && value !== null && !Array.isArray(value) && "operator" in value);
+}
+function encodeFilterCondition(condition) {
+    const value = condition.operator === "is_empty" || condition.operator === "is_not_empty"
+        ? ""
+        : Array.isArray(condition.value)
+            ? condition.value.join(",")
+            : condition.value;
+    return `${UPSTREAM_OPERATORS[condition.operator]}.${value ?? ""}`;
+}
+export function serializeFilters(filters) {
+    const serialized = {};
+    for (const [name, value] of Object.entries(filters ?? {})) {
+        if (value === undefined)
+            continue;
+        const conditions = isFilterCondition(value)
+            ? [value]
+            : Array.isArray(value) && value.every(isFilterCondition)
+                ? value
+                : undefined;
+        if (!conditions) {
+            if (name === "referrer" && value === "") {
+                serialized.domain1 = "eq.";
+                continue;
+            }
+            serialized[name] = value;
+            continue;
+        }
+        // Umami's public `referrer` filter always removes internal/direct rows. Its
+        // equivalent `domain` column has neutral equality semantics, and a numeric
+        // suffix makes it survive the upstream route's dynamic-filter parser.
+        const upstreamName = name === "referrer" ? "domain" : name;
+        conditions.forEach((condition, index) => {
+            const suffix = name === "referrer" ? index + 1 : index;
+            const key = suffix === 0 ? upstreamName : `${upstreamName}${suffix}`;
+            serialized[key] = encodeFilterCondition(condition);
+        });
+    }
+    return serialized;
+}
+export function appendReferrerExclusions(filters, domains) {
+    const values = [...new Set(domains.map((domain) => domain.trim()).filter(Boolean))].filter((domain) => !domain.includes(","));
+    if (values.length === 0)
+        return filters;
+    if (filters.match === "any") {
+        throw new UmamiError("VALIDATION_ERROR", 'trafficSegment="human" cannot be combined with filters.match="any" because Umami cannot apply mandatory spam exclusions outside that OR group.');
+    }
+    let suffix = 1;
+    while (`domain${suffix}` in filters)
+        suffix += 1;
+    return { ...filters, [`domain${suffix}`]: `neq.${values.join(",")}` };
+}
 export function rangeQuery(start, end, maxRangeDays, options = {}) {
     const range = parseTimeRange(start, end, maxRangeDays);
-    const { excludeBounce, ...filters } = options.filters ?? {};
+    const { excludeBounce, ...filters } = options.serializedFilters ?? serializeFilters(options.filters);
     return {
         ...range,
         ...filters,

package/dist/mcp/schemas.js.map

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

package/dist/mcp/traffic-segmentation.d.ts

@@ -0,0 +1,82 @@
+import type { UmamiClient } from "../api/client.js";
+import type { BreakdownField, Query } from "../api/types.js";
+import { type TRAFFIC_CHANNELS } from "./schemas.js";
+export type TrafficChannel = (typeof TRAFFIC_CHANNELS)[number];
+export interface TrafficPeriod {
+    endAt: number;
+    startAt: number;
+}
+export interface ExpandedMetricRow {
+    bounces: number;
+    name: string;
+    pageviews: number;
+    totaltime: number;
+    visitors: number;
+    visits: number;
+}
+export declare function parseExpandedMetricRows(value: unknown): ExpandedMetricRow[];
+export declare function fetchExpandedMetricRows(client: UmamiClient, input: {
+    excludedReferrers?: readonly string[];
+    filters?: Query;
+    maxRangeDays: number;
+    period: TrafficPeriod;
+    signal?: AbortSignal;
+    type: string;
+    websiteId: string;
+}): Promise<ExpandedMetricRow[]>;
+export interface SuspiciousReferrer extends ExpandedMetricRow {
+    averageVisitDurationSeconds: number;
+    bounceRatePercent: number;
+    confidence: "high" | "medium";
+    reasons: string[];
+}
+export declare function assessReferralSpam(client: UmamiClient, input: {
+    filters?: Query;
+    maxRangeDays: number;
+    period: TrafficPeriod;
+    signal?: AbortSignal;
+    websiteId: string;
+}): Promise<{
+    suspiciousReferrers: SuspiciousReferrer[];
+    excludedReferrers: string[];
+    dataQuality: {
+        sourceRows: number;
+        sourceRowsTruncated: boolean;
+        heuristic: boolean;
+        thresholds: {
+            minimumVisits: number;
+            minimumBounceRatePercent: number;
+            maximumAverageVisitDurationSeconds: number;
+        };
+    };
+}>;
+export declare function selectChannelTotals(rows: readonly ExpandedMetricRow[], channel: TrafficChannel): ExpandedMetricRow;
+export declare function appendDimensionEquality(filters: Query, field: string, value: string): Query | undefined;
+export declare function runDerivedChannelBreakdown(client: UmamiClient, input: {
+    channel?: TrafficChannel;
+    excludedReferrers?: readonly string[];
+    fields: readonly (BreakdownField | "channel")[];
+    filters: Query;
+    limit: number;
+    maxRangeDays: number;
+    period: TrafficPeriod;
+    signal?: AbortSignal;
+    websiteId: string;
+}): Promise<{
+    rows: {
+        bounces: number;
+        pageviews: number;
+        totaltime: number;
+        visitors: number;
+        visits: number;
+        channel?: string | undefined;
+    }[];
+    dataQuality: {
+        derivedChannelBreakdown: boolean;
+        upstreamCandidateRows: number;
+        sourceRowsTruncated: boolean;
+        omittedUnsupportedRows: number;
+        fanoutRequests: number;
+    };
+}>;
+//# sourceMappingURL=traffic-segmentation.d.ts.map

package/dist/mcp/traffic-segmentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traffic-segmentation.d.ts","sourceRoot":"","sources":["../../src/mcp/traffic-segmentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,cAAc,EAA0B,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAwC,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE3F,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAqCD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,EAAE,CAwB3E;AAED,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE;IACL,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAmB9B;AAiDD,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,2BAA2B,EAAE,MAAM,CAAC;IACpC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE;IACL,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;;;;;;;;;;;;;GAmDF;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,SAAS,iBAAiB,EAAE,EAClC,OAAO,EAAE,cAAc,GACtB,iBAAiB,CAWnB;AASD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,KAAK,EACd,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,KAAK,GAAG,SAAS,CASnB;AAaD,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE;IACL,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,MAAM,EAAE,SAAS,CAAC,cAAc,GAAG,SAAS,CAAC,EAAE,CAAC;IAChD,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;;iBArRQ,MAAM;mBAEJ,MAAM;mBACN,MAAM;kBACP,MAAM;gBACR,MAAM;;;;;;;;;;GAiWf"}

package/dist/mcp/traffic-segmentation.js

@@ -0,0 +1,264 @@
+import { UmamiError } from "../api/errors.js";
+import { appendReferrerExclusions, rangeQuery } from "./schemas.js";
+const MAX_EXPANDED_ROWS = 100;
+const MAX_CHANNEL_CANDIDATES = 50;
+const MIN_SUSPICIOUS_VISITS = 3;
+const MIN_SUSPICIOUS_BOUNCE_RATE = 0.9;
+const MAX_SUSPICIOUS_AVERAGE_DURATION_SECONDS = 2;
+async function mapConcurrent(values, concurrency, operation) {
+    const results = new Array(values.length);
+    let nextIndex = 0;
+    const workers = Array.from({ length: Math.min(concurrency, values.length) }, async () => {
+        while (nextIndex < values.length) {
+            const index = nextIndex;
+            nextIndex += 1;
+            results[index] = await operation(values[index]);
+        }
+    });
+    await Promise.all(workers);
+    return results;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function finiteNumber(value) {
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    if (typeof value !== "string" || value.trim() === "")
+        return undefined;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+export function parseExpandedMetricRows(value) {
+    if (!Array.isArray(value)) {
+        throw new UmamiError("INVALID_RESPONSE", "Umami returned invalid expanded metric data.");
+    }
+    return value.map((item) => {
+        if (!isRecord(item) || typeof item.name !== "string") {
+            throw new UmamiError("INVALID_RESPONSE", "Umami returned invalid expanded metric data.");
+        }
+        const pageviews = finiteNumber(item.pageviews);
+        const visitors = finiteNumber(item.visitors);
+        const visits = finiteNumber(item.visits);
+        const bounces = finiteNumber(item.bounces);
+        const totaltime = finiteNumber(item.totaltime);
+        if (pageviews === undefined ||
+            visitors === undefined ||
+            visits === undefined ||
+            bounces === undefined ||
+            totaltime === undefined) {
+            throw new UmamiError("INVALID_RESPONSE", "Umami returned invalid expanded metric data.");
+        }
+        return { name: item.name, pageviews, visitors, visits, bounces, totaltime };
+    });
+}
+export async function fetchExpandedMetricRows(client, input) {
+    const serializedFilters = appendReferrerExclusions(input.filters ?? {}, input.excludedReferrers ?? []);
+    return parseExpandedMetricRows(await client.get(`websites/${encodeURIComponent(input.websiteId)}/metrics/expanded`, {
+        ...rangeQuery(input.period.startAt, input.period.endAt, input.maxRangeDays, {
+            serializedFilters,
+        }),
+        type: input.type,
+        limit: MAX_EXPANDED_ROWS,
+        offset: 0,
+    }, input.signal));
+}
+function longestConsonantRun(value) {
+    let longest = 0;
+    let current = 0;
+    for (const character of value) {
+        if (/[a-z]/.test(character) && !/[aeiouy]/.test(character)) {
+            current += 1;
+            longest = Math.max(longest, current);
+        }
+        else {
+            current = 0;
+        }
+    }
+    return longest;
+}
+function shannonEntropy(value) {
+    const counts = new Map();
+    for (const character of value)
+        counts.set(character, (counts.get(character) ?? 0) + 1);
+    let entropy = 0;
+    for (const count of counts.values()) {
+        const probability = count / value.length;
+        entropy -= probability * Math.log2(probability);
+    }
+    return entropy;
+}
+function looksGeneratedDomain(domain) {
+    const hostname = domain
+        .trim()
+        .toLowerCase()
+        .replace(/^https?:\/\//, "")
+        .split(/[/?#]/, 1)[0]
+        ?.replace(/^www\./, "")
+        .replace(/:\d+$/, "");
+    const labels = hostname?.split(".").filter(Boolean) ?? [];
+    const label = (labels.length > 1 ? labels.slice(0, -1) : labels).sort((left, right) => right.length - left.length)[0];
+    if (!label)
+        return false;
+    const letters = label.replace(/[^a-z]/g, "");
+    if (letters.length < 12)
+        return false;
+    const vowels = [...letters].filter((character) => /[aeiouy]/.test(character)).length;
+    return (shannonEntropy(letters) >= 3.1 &&
+        (vowels / letters.length < 0.24 || longestConsonantRun(letters) >= 6));
+}
+export async function assessReferralSpam(client, input) {
+    const rows = await fetchExpandedMetricRows(client, {
+        ...input,
+        type: "referrer",
+    });
+    const suspiciousReferrers = rows.flatMap((row) => {
+        const bounceRate = row.visits === 0 ? 0 : row.bounces / row.visits;
+        const averageVisitDurationSeconds = row.visits === 0 ? 0 : row.totaltime / row.visits;
+        const generatedDomain = looksGeneratedDomain(row.name);
+        if (!generatedDomain ||
+            row.visits < MIN_SUSPICIOUS_VISITS ||
+            bounceRate < MIN_SUSPICIOUS_BOUNCE_RATE ||
+            averageVisitDurationSeconds > MAX_SUSPICIOUS_AVERAGE_DURATION_SECONDS) {
+            return [];
+        }
+        const reasons = [
+            "generated_domain_pattern",
+            "very_high_bounce_rate",
+            "near_zero_visit_duration",
+        ];
+        return [
+            {
+                ...row,
+                bounceRatePercent: Math.round(bounceRate * 10_000) / 100,
+                averageVisitDurationSeconds: Math.round(averageVisitDurationSeconds * 100) / 100,
+                confidence: row.visits >= 20 && bounceRate >= 0.95 && averageVisitDurationSeconds <= 1
+                    ? "high"
+                    : "medium",
+                reasons,
+            },
+        ];
+    });
+    return {
+        suspiciousReferrers,
+        excludedReferrers: suspiciousReferrers.map(({ name }) => name),
+        dataQuality: {
+            sourceRows: rows.length,
+            sourceRowsTruncated: rows.length >= MAX_EXPANDED_ROWS,
+            heuristic: true,
+            thresholds: {
+                minimumVisits: MIN_SUSPICIOUS_VISITS,
+                minimumBounceRatePercent: MIN_SUSPICIOUS_BOUNCE_RATE * 100,
+                maximumAverageVisitDurationSeconds: MAX_SUSPICIOUS_AVERAGE_DURATION_SECONDS,
+            },
+        },
+    };
+}
+export function selectChannelTotals(rows, channel) {
+    return (rows.find(({ name }) => name === channel) ?? {
+        name: channel,
+        pageviews: 0,
+        visitors: 0,
+        visits: 0,
+        bounces: 0,
+        totaltime: 0,
+    });
+}
+function nextFilterKey(filters, field) {
+    const upstreamField = field === "referrer" ? "domain" : field;
+    let suffix = field === "referrer" ? 1 : 0;
+    while ((suffix === 0 ? upstreamField : `${upstreamField}${suffix}`) in filters)
+        suffix += 1;
+    return suffix === 0 ? upstreamField : `${upstreamField}${suffix}`;
+}
+export function appendDimensionEquality(filters, field, value) {
+    if (value.includes(","))
+        return undefined;
+    if (filters.match === "any") {
+        throw new UmamiError("VALIDATION_ERROR", 'Derived channel cross-tabs cannot be combined with filters.match="any" because Umami cannot require candidate predicates outside that OR group.');
+    }
+    return { ...filters, [nextFilterKey(filters, field)]: `eq.${value}` };
+}
+function requireRowFields(row, fields) {
+    const result = {};
+    for (const field of fields) {
+        if (typeof row[field] !== "string") {
+            throw new UmamiError("INVALID_RESPONSE", "Umami returned invalid breakdown candidate data.");
+        }
+        result[field] = row[field];
+    }
+    return result;
+}
+export async function runDerivedChannelBreakdown(client, input) {
+    const dimensions = input.fields.filter((field) => field !== "channel");
+    const baseFilters = appendReferrerExclusions(input.filters, input.excludedReferrers ?? []);
+    let candidates = [{ values: {} }];
+    let sourceRowsTruncated = false;
+    let omittedUnsupportedRows = 0;
+    if (dimensions.length > 0) {
+        const request = {
+            websiteId: input.websiteId,
+            type: "breakdown",
+            parameters: {
+                startDate: new Date(input.period.startAt).toISOString(),
+                endDate: new Date(input.period.endAt).toISOString(),
+                fields: dimensions,
+            },
+            filters: baseFilters,
+        };
+        const result = await client.runReport(request, input.signal);
+        if (!Array.isArray(result)) {
+            throw new UmamiError("INVALID_RESPONSE", "Umami returned invalid breakdown candidate data.");
+        }
+        const candidateLimit = Math.min(MAX_CHANNEL_CANDIDATES, Math.max(input.limit * 3, 20));
+        sourceRowsTruncated = result.length > candidateLimit || result.length >= 500;
+        candidates = result.slice(0, candidateLimit).map((candidate) => {
+            if (!isRecord(candidate)) {
+                throw new UmamiError("INVALID_RESPONSE", "Umami returned invalid breakdown candidate data.");
+            }
+            return { values: requireRowFields(candidate, dimensions) };
+        });
+    }
+    const derived = await mapConcurrent(candidates, 4, async (candidate) => {
+        let filters = baseFilters;
+        const { values } = candidate;
+        for (const [field, value] of Object.entries(values)) {
+            filters = appendDimensionEquality(filters, field, value);
+            if (!filters) {
+                omittedUnsupportedRows += 1;
+                return [];
+            }
+        }
+        const channels = await fetchExpandedMetricRows(client, {
+            filters,
+            maxRangeDays: input.maxRangeDays,
+            period: input.period,
+            signal: input.signal,
+            type: "channel",
+            websiteId: input.websiteId,
+        });
+        return channels
+            .filter(({ name }) => input.channel === undefined || name === input.channel)
+            .map(({ name, ...metrics }) => ({
+            ...values,
+            ...(input.fields.includes("channel") ? { channel: name } : {}),
+            ...metrics,
+        }));
+    });
+    const rows = derived
+        .flat()
+        .sort((left, right) => right.visitors - left.visitors ||
+        right.pageviews - left.pageviews ||
+        JSON.stringify(left).localeCompare(JSON.stringify(right)));
+    return {
+        rows,
+        dataQuality: {
+            derivedChannelBreakdown: true,
+            upstreamCandidateRows: candidates.length,
+            sourceRowsTruncated,
+            omittedUnsupportedRows,
+            fanoutRequests: candidates.length,
+        },
+    };
+}
+//# sourceMappingURL=traffic-segmentation.js.map