@iann29/rastro 0.5.0 → 0.7.0

package/dist/client/identity.d.ts

@@ -0,0 +1,11 @@
+import { type GenericActionCtx, type GenericDataModel } from "convex/server";
+import type { IdentifyVisitorInput } from "./index.js";
+import type { VisitorProfile } from "../component/validators.js";
+/** Fits provider identifiers (including issuer URLs and Unicode) into a tracker ID. */
+export declare function visitorIdForUser(userId: string): Promise<string>;
+type ActionCtx = GenericActionCtx<GenericDataModel>;
+export type IdentityHttpAuthorizer = (ctx: ActionCtx, request: Request, siteId: string) => void | Promise<void>;
+/** Server-to-server transport. The host must authenticate AND authorize the site. */
+export declare function identityHttpAction(identify: (ctx: ActionCtx, input: IdentifyVisitorInput) => Promise<VisitorProfile>, authorize: IdentityHttpAuthorizer): import("convex/server").PublicHttpAction;
+export {};
+//# sourceMappingURL=identity.d.ts.map

package/dist/client/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/client/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,uFAAuF;AACvF,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQtE;AAED,KAAK,SAAS,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;AACpD,MAAM,MAAM,sBAAsB,GAAG,CACnC,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,KACX,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,qFAAqF;AACrF,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,CACR,GAAG,EAAE,SAAS,EACd,KAAK,EAAE,oBAAoB,KACxB,OAAO,CAAC,cAAc,CAAC,EAC5B,SAAS,EAAE,sBAAsB,4CAqIlC"}

package/dist/client/identity.js

@@ -0,0 +1,123 @@
+import { httpActionGeneric, } from "convex/server";
+import { ConvexError } from "convex/values";
+/** Fits provider identifiers (including issuer URLs and Unicode) into a tracker ID. */
+export async function visitorIdForUser(userId) {
+    if (!userId.trim() || userId.length > 2048)
+        throw new Error("userId must contain 1–2048 characters");
+    const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(userId));
+    return `user_${Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, "0")).join("")}`;
+}
+/** Server-to-server transport. The host must authenticate AND authorize the site. */
+export function identityHttpAction(identify, authorize) {
+    const json = (value, status) => Response.json(value, {
+        status,
+        headers: { "Cache-Control": "no-store" },
+    });
+    return httpActionGeneric(async (ctx, request) => {
+        if (request.method !== "POST")
+            return json({ error: "METHOD_NOT_ALLOWED" }, 405);
+        let input;
+        try {
+            if (request.headers
+                .get("content-type")
+                ?.toLowerCase()
+                .split(";")[0]
+                .trim() !== "application/json") {
+                return json({ error: "JSON_REQUIRED" }, 415);
+            }
+            const reader = request.body?.getReader();
+            if (!reader)
+                return json({ error: "INVALID_BODY" }, 400);
+            const chunks = [];
+            let size = 0;
+            try {
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done)
+                        break;
+                    size += value.byteLength;
+                    if (size > 8192) {
+                        await reader.cancel();
+                        return json({ error: "BODY_TOO_LARGE" }, 413);
+                    }
+                    chunks.push(value);
+                }
+            }
+            finally {
+                reader.releaseLock();
+            }
+            const bytes = new Uint8Array(size);
+            let offset = 0;
+            for (const chunk of chunks) {
+                bytes.set(chunk, offset);
+                offset += chunk.byteLength;
+            }
+            const body = JSON.parse(new TextDecoder().decode(bytes));
+            if (!body || typeof body !== "object" || Array.isArray(body))
+                throw new Error("body");
+            const fields = body;
+            if (Object.keys(fields).some((key) => ![
+                "siteId",
+                "visitorId",
+                "previousVisitorId",
+                "name",
+                "email",
+                "attributes",
+            ].includes(key)))
+                throw new Error("fields");
+            if (typeof fields.siteId !== "string" ||
+                typeof fields.visitorId !== "string")
+                throw new Error("identity");
+            if (fields.previousVisitorId !== undefined &&
+                typeof fields.previousVisitorId !== "string")
+                throw new Error("previousVisitorId");
+            for (const key of ["name", "email"]) {
+                if (fields[key] !== undefined &&
+                    fields[key] !== null &&
+                    typeof fields[key] !== "string")
+                    throw new Error(key);
+            }
+            if (fields.attributes !== undefined) {
+                if (!fields.attributes ||
+                    typeof fields.attributes !== "object" ||
+                    Array.isArray(fields.attributes))
+                    throw new Error("attributes");
+                if (Object.values(fields.attributes).some((value) => value !== null &&
+                    !["string", "number", "boolean"].includes(typeof value)))
+                    throw new Error("attribute value");
+            }
+            input = fields;
+        }
+        catch {
+            return json({ error: "INVALID_BODY" }, 400);
+        }
+        try {
+            await authorize(ctx, request, input.siteId);
+        }
+        catch {
+            return json({ error: "FORBIDDEN" }, 403);
+        }
+        try {
+            return json(await identify(ctx, input), 200);
+        }
+        catch (error) {
+            if (error instanceof ConvexError &&
+                error.data &&
+                typeof error.data === "object") {
+                const code = error.data.code;
+                const status = code === "CONFLICT"
+                    ? 409
+                    : code === "NOT_FOUND"
+                        ? 404
+                        : code === "LIMIT_EXCEEDED"
+                            ? 429
+                            : code === "INVALID_ARGUMENT"
+                                ? 400
+                                : 500;
+                return json({ error: status === 500 ? "IDENTIFY_FAILED" : code }, status);
+            }
+            return json({ error: "IDENTIFY_FAILED" }, 500);
+        }
+    });
+}
+//# sourceMappingURL=identity.js.map

package/dist/client/identity.js.map

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

package/dist/client/index.d.ts

@@ -1,13 +1,16 @@
 import type { FunctionArgs, FunctionReturnType, GenericActionCtx, GenericDataModel, GenericMutationCtx, GenericQueryCtx } from "convex/server";
 import { type Infer } from "convex/values";
+import { type IdentityHttpAuthorizer } from "./identity.js";
+export { visitorIdForUser } from "./identity.js";
+export type { IdentityHttpAuthorizer } from "./identity.js";
 import type { ComponentApi } from "../component/_generated/component.js";
-import { eventPropertiesValidator, eventTypeValidator, funnelStepValidator, goalMatchTypeValidator, ingestContextValidator, ingestResultValidator, trackerEventValidator, vitalMetricValidator } from "../component/validators.js";
+import { eventPropertiesValidator, eventTypeValidator, funnelStepValidator, goalMatchTypeValidator, ingestContextValidator, ingestResultValidator, trackerEventValidator, vitalMetricValidator, visitorProfileValidator } from "../component/validators.js";
 import { type FederatedAnalyticsAuthorizerOptions, type FederatedAnalyticsConnectionStatus, type FederatedSiteSummary } from "./federation.js";
-export { eventPropertiesValidator, eventTypeValidator, funnelStepValidator, goalMatchTypeValidator, ingestContextValidator, ingestResultValidator, trackerEventValidator, vitalMetricValidator, };
-export type { Channel, EventProperties, EventType, Evidence, FunnelStep, IngestContext, TrackerEvent, } from "../component/validators.js";
+export { eventPropertiesValidator, eventTypeValidator, funnelStepValidator, goalMatchTypeValidator, ingestContextValidator, ingestResultValidator, trackerEventValidator, vitalMetricValidator, visitorProfileValidator, };
+export type { Channel, EventProperties, EventType, Evidence, FunnelStep, IngestContext, TrackerEvent, VisitorProfile, PersonAttributes, PersonFilter, } from "../component/validators.js";
 export { channelForPlatform, platformDimensionValue, platformForSource, splitPlatformDimension, } from "../component/origin.js";
 export { VITAL_METRICS, VITAL_THRESHOLDS } from "../component/vitals.js";
-export { normalizeRoute } from "../component/sanitize.js";
+export { normalizeRoute, validateRoutePatterns, } from "../component/sanitize.js";
 export { localDayStart, nextLocalDayStart, previousLocalDayStart, } from "../component/localTime.js";
 export { HEAT_HOT_SCORE, HEAT_WARM_SCORE, visitorHeat } from "./heat.js";
 export type { HeatInput, HeatLevel, HeatSignal, VisitorHeat } from "./heat.js";
@@ -15,6 +18,8 @@ export type { VitalMetric } from "../component/vitals.js";
 export { effectiveFederatedPermissions, federatedPermissionSatisfies, isPublicFederatedAccess, FEDERATED_ANALYTICS_CLAIMS, FEDERATED_ANALYTICS_CONFIGURE_FUNCTIONS, FEDERATED_ANALYTICS_CONFIGURE_PERMISSION, FEDERATED_ANALYTICS_CONNECTOR_MANIFEST, FEDERATED_ANALYTICS_ERROR_CODES, FEDERATED_ANALYTICS_PERMISSIONS, FEDERATED_ANALYTICS_PUBLIC_FUNCTIONS, FEDERATED_ANALYTICS_PUBLIC_PERMISSION, FEDERATED_ANALYTICS_READ_PERMISSION, FEDERATED_ANALYTICS_REQUIRED_CAPABILITIES, FEDERATED_ANALYTICS_REQUIRED_FUNCTIONS, federatedAnalyticsPermissionValidator, } from "./federation.js";
 export type { FederatedAnalyticsCapability, FederatedAnalyticsAuthorizerOptions, FederatedAnalyticsConnection, FederatedAnalyticsConnectionStatus, FederatedAnalyticsErrorCode, FederatedAnalyticsIdentity, FederatedAnalyticsManifest, FederatedAnalyticsPermission, FederatedSiteSummary, ResolveFederatedAnalyticsConnection, } from "./federation.js";
 export type CreateSiteInput = FunctionArgs<ComponentApi["sites"]["create"]>;
+export type ListPeopleInput = FunctionArgs<ComponentApi["people"]["list"]>;
+export type Person = FunctionReturnType<ComponentApi["people"]["list"]>["page"][number];
 export type CreateSiteOutput = FunctionReturnType<ComponentApi["sites"]["create"]>;
 export type UpdateSiteInput = FunctionArgs<ComponentApi["sites"]["update"]>;
 export type UpdateSiteOutput = FunctionReturnType<ComponentApi["sites"]["update"]>;
@@ -27,6 +32,8 @@ export type TrackConversionInput = Omit<FunctionArgs<ComponentApi["ingest"]["tra
 export type TrackConversionOutput = FunctionReturnType<ComponentApi["ingest"]["trackConversion"]>;
 export type LinkVisitorInput = FunctionArgs<ComponentApi["visitors"]["link"]>;
 export type LinkVisitorOutput = FunctionReturnType<ComponentApi["visitors"]["link"]>;
+export type IdentifyVisitorInput = FunctionArgs<ComponentApi["visitors"]["identify"]>;
+export type GetVisitorProfileInput = FunctionArgs<ComponentApi["visitors"]["getProfile"]>;
 export type OverviewInput = FunctionArgs<ComponentApi["reports"]["overview"]>;
 export type Overview = Infer<typeof hostOverviewValidator>;
 export type LiveVisitorsInput = FunctionArgs<ComponentApi["reports"]["liveVisitors"]>;
@@ -137,6 +144,7 @@ export declare class Rastro {
         name: string;
         networkId?: string;
         ownerId: string;
+        routePatterns?: Array<string>;
         timezone?: string;
         updatedAt: number;
     } | null>;
@@ -155,6 +163,7 @@ export declare class Rastro {
         name: string;
         networkId?: string;
         ownerId: string;
+        routePatterns?: Array<string>;
         timezone?: string;
         updatedAt: number;
     }[]>;
@@ -172,6 +181,61 @@ export declare class Rastro {
         aliasCount: number;
         linked: boolean;
     }>;
+    /** The caller resolves the user with its own auth; no provider is required. */
+    identifyVisitor(ctx: MutationCtx | ActionCtx, args: IdentifyVisitorInput): Promise<{
+        attributes?: Record<string, string | number | boolean>;
+        email?: string;
+        identifiedAt: number;
+        name?: string;
+        updatedAt: number;
+        visitorId: string;
+    }>;
+    /** End-user entrypoint: the browser supplies only its pre-login visitor ID. */
+    identifyVisitorMutation<DataModel extends GenericDataModel>(options: {
+        resolveUser: (ctx: GenericMutationCtx<DataModel>) => Promise<Omit<IdentifyVisitorInput, "previousVisitorId"> | null>;
+    }): import("convex/server").RegisteredMutation<"public", {
+        previousVisitorId?: string | undefined;
+    }, Promise<{
+        attributes?: Record<string, string | number | boolean>;
+        email?: string;
+        identifiedAt: number;
+        name?: string;
+        updatedAt: number;
+        visitorId: string;
+    }>>;
+    /** Mount on the host's router with its own server credential/site authorization. */
+    identifyVisitorHttpAction(options: {
+        authorize: IdentityHttpAuthorizer;
+    }): import("convex/server").PublicHttpAction;
+    getVisitorProfile(ctx: QueryCtx | MutationCtx | ActionCtx, args: GetVisitorProfileInput): Promise<{
+        attributes?: Record<string, string | number | boolean>;
+        email?: string;
+        identifiedAt: number;
+        name?: string;
+        updatedAt: number;
+        visitorId: string;
+    } | null>;
+    listPeople(ctx: QueryCtx | MutationCtx | ActionCtx, args: ListPeopleInput): Promise<{
+        continueCursor: string;
+        isDone: boolean;
+        page: Array<{
+            _creationTime: number;
+            _id: string;
+            attributes?: Record<string, string | number | boolean>;
+            email?: string;
+            identifiedAt: number;
+            name?: string;
+            siteId: string;
+            updatedAt: number;
+            visitorId: string;
+        }>;
+    }>;
+    backfillVisitorProfiles(ctx: MutationCtx | ActionCtx, args: {
+        siteId: string;
+    }): Promise<{
+        isDone: boolean;
+        updated: number;
+    }>;
     overview(ctx: QueryCtx | MutationCtx | ActionCtx, args: OverviewInput): Promise<{
         currency: string;
         from: number;
@@ -342,6 +406,14 @@ export declare class Rastro {
         pageviewCount: number;
         path: string;
         previousPath?: string;
+        profile?: {
+            attributes?: Record<string, string | number | boolean>;
+            email?: string;
+            identifiedAt: number;
+            name?: string;
+            updatedAt: number;
+            visitorId: string;
+        };
         returning?: boolean;
         sessionId: string;
         siteId: string;
@@ -379,6 +451,14 @@ export declare class Rastro {
         os: string;
         pageviewCount: number;
         platform?: string;
+        profile?: {
+            attributes?: Record<string, string | number | boolean>;
+            email?: string;
+            identifiedAt: number;
+            name?: string;
+            updatedAt: number;
+            visitorId: string;
+        };
         referrer?: string;
         revenueCents: number;
         sessionId: string;
@@ -427,6 +507,14 @@ export declare class Rastro {
             os: string;
             pageviewCount: number;
             platform?: string;
+            profile?: {
+                attributes?: Record<string, string | number | boolean>;
+                email?: string;
+                identifiedAt: number;
+                name?: string;
+                updatedAt: number;
+                visitorId: string;
+            };
             referrer?: string;
             revenueCents: number;
             sessionId: string;
@@ -717,6 +805,7 @@ export declare class Rastro {
                 exact: boolean;
             };
         };
+        routePatterns?: Record<string, Array<string>>;
         routes: Array<{
             bounces: number;
             daily: Array<{
@@ -862,7 +951,7 @@ export declare class Rastro {
         hasMore: boolean;
     }>;
 }
-export type AnalyticsOperation = "site.create" | "site.update" | "site.get" | "site.list" | "ingest" | "conversion.track" | "visitor.link" | "report.overview" | "report.live" | "report.sessions" | "report.sessionJourney" | "report.conversions" | "report.visitorJourney" | "report.goals" | "report.funnels" | "report.affiliates" | "report.vitals" | "report.siteMap" | "goal.upsert" | "goal.list" | "goal.remove" | "funnel.upsert" | "funnel.list" | "funnel.remove" | "affiliate.upsert" | "affiliate.list" | "affiliate.remove" | "trackedLink.create" | "trackedLink.update" | "trackedLink.delete" | "trackedLink.list" | "retention.cleanup" | "retention.policy" | "retention.status" | "coverage.read";
+export type AnalyticsOperation = "site.create" | "site.update" | "site.get" | "site.list" | "ingest" | "conversion.track" | "visitor.link" | "visitor.identify" | "visitor.profile" | "visitor.list" | "visitor.index" | "report.overview" | "report.live" | "report.sessions" | "report.sessionJourney" | "report.conversions" | "report.visitorJourney" | "report.goals" | "report.funnels" | "report.affiliates" | "report.vitals" | "report.siteMap" | "goal.upsert" | "goal.list" | "goal.remove" | "funnel.upsert" | "funnel.list" | "funnel.remove" | "affiliate.upsert" | "affiliate.list" | "affiliate.remove" | "trackedLink.create" | "trackedLink.update" | "trackedLink.delete" | "trackedLink.list" | "retention.cleanup" | "retention.policy" | "retention.status" | "coverage.read";
 export type AnalyticsAuthorizationRequest = {
     operation: AnalyticsOperation;
     siteIds: string[];
@@ -2060,6 +2149,7 @@ declare const hostSiteMapValidator: import("convex/values").VObject<{
             exact: boolean;
         };
     };
+    routePatterns?: Record<string, string[]> | undefined;
     routes: {
         bounces: number;
         daily: {
@@ -2091,6 +2181,7 @@ declare const hostSiteMapValidator: import("convex/values").VObject<{
         to: number;
     } | null;
 }, {
+    routePatterns: import("convex/values").VRecord<Record<string, string[]> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">, "optional", string>;
     from: import("convex/values").VFloat64<number, "required">;
     to: import("convex/values").VFloat64<number, "required">;
     window: import("convex/values").VUnion<{
@@ -2242,7 +2333,7 @@ declare const hostSiteMapValidator: import("convex/values").VObject<{
             rows: import("convex/values").VFloat64<number, "required">;
         }, "required", "routesPerDay" | "rows" | "transitionSlots">;
     }, "required", "basis" | "coverage" | "coverage.availableFrom" | "coverage.availableThrough" | "coverage.generation" | "coverage.retainedBefore" | "coverage.state" | "limits" | "limits.routesPerDay" | "limits.rows" | "limits.transitionSlots" | "range" | "range.boundary" | "range.from" | "range.timezone" | "range.to" | "visitors" | "visitors.basis" | "visitors.exact">;
-}, "required", "from" | "metadata" | "metadata.basis" | "metadata.coverage" | "metadata.coverage.availableFrom" | "metadata.coverage.availableThrough" | "metadata.coverage.generation" | "metadata.coverage.retainedBefore" | "metadata.coverage.state" | "metadata.limits" | "metadata.limits.routesPerDay" | "metadata.limits.rows" | "metadata.limits.transitionSlots" | "metadata.range" | "metadata.range.boundary" | "metadata.range.from" | "metadata.range.timezone" | "metadata.range.to" | "metadata.visitors" | "metadata.visitors.basis" | "metadata.visitors.exact" | "routes" | "to" | "transitions" | "truncated" | "truncated.routes" | "truncated.transitions" | "window" | "window.from" | "window.to">;
+}, "required", "from" | "metadata" | "metadata.basis" | "metadata.coverage" | "metadata.coverage.availableFrom" | "metadata.coverage.availableThrough" | "metadata.coverage.generation" | "metadata.coverage.retainedBefore" | "metadata.coverage.state" | "metadata.limits" | "metadata.limits.routesPerDay" | "metadata.limits.rows" | "metadata.limits.transitionSlots" | "metadata.range" | "metadata.range.boundary" | "metadata.range.from" | "metadata.range.timezone" | "metadata.range.to" | "metadata.visitors" | "metadata.visitors.basis" | "metadata.visitors.exact" | "routePatterns" | "routes" | "to" | "transitions" | "truncated" | "truncated.routes" | "truncated.transitions" | "window" | "window.from" | "window.to" | `routePatterns.${string}`>;
 export declare function exposeAnalyticsApi(component: ComponentApi, options: {
     authorize: AnalyticsAuthorizer;
 }): {
@@ -2253,6 +2344,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         name: string;
         networkId?: string | undefined;
         ownerId: string;
+        routePatterns?: string[] | undefined;
         timezone?: string | undefined;
     }, Promise<string>>;
     updateSite: import("convex/server").RegisteredMutation<"public", {
@@ -2261,6 +2353,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         domains?: string[] | undefined;
         name?: string | undefined;
         networkId?: string | null | undefined;
+        routePatterns?: string[] | undefined;
         siteId: string;
         timezone?: string | null | undefined;
     }, Promise<null>>;
@@ -2276,6 +2369,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         name: string;
         networkId?: string;
         ownerId: string;
+        routePatterns?: Array<string>;
         timezone?: string;
         updatedAt: number;
     } | null>>;
@@ -2292,6 +2386,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         name: string;
         networkId?: string;
         ownerId: string;
+        routePatterns?: Array<string>;
         timezone?: string;
         updatedAt: number;
     }[]>>;
@@ -2357,6 +2452,67 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         aliasCount: number;
         linked: boolean;
     }>>;
+    identifyVisitor: import("convex/server").RegisteredMutation<"public", {
+        attributes?: Record<string, string | number | boolean | null> | undefined;
+        email?: string | null | undefined;
+        name?: string | null | undefined;
+        previousVisitorId?: string | undefined;
+        siteId: string;
+        visitorId: string;
+    }, Promise<{
+        attributes?: Record<string, string | number | boolean>;
+        email?: string;
+        identifiedAt: number;
+        name?: string;
+        updatedAt: number;
+        visitorId: string;
+    }>>;
+    getVisitorProfile: import("convex/server").RegisteredQuery<"public", {
+        siteId: string;
+        visitorId: string;
+    }, Promise<{
+        attributes?: Record<string, string | number | boolean>;
+        email?: string;
+        identifiedAt: number;
+        name?: string;
+        updatedAt: number;
+        visitorId: string;
+    } | null>>;
+    listPeople: import("convex/server").RegisteredQuery<"public", {
+        filter?: {
+            field: "email" | "name" | "visitorId";
+            prefix: string;
+        } | {
+            field: "attribute";
+            key: string;
+            value: string | number | boolean;
+        } | undefined;
+        paginationOpts: {
+            cursor: string | null;
+            numItems: number;
+        };
+        siteId: string;
+    }, Promise<{
+        continueCursor: string;
+        isDone: boolean;
+        page: Array<{
+            _creationTime: number;
+            _id: string;
+            attributes?: Record<string, string | number | boolean>;
+            email?: string;
+            identifiedAt: number;
+            name?: string;
+            siteId: string;
+            updatedAt: number;
+            visitorId: string;
+        }>;
+    }>>;
+    backfillVisitorProfiles: import("convex/server").RegisteredMutation<"public", {
+        siteId: string;
+    }, Promise<{
+        isDone: boolean;
+        updated: number;
+    }>>;
     overview: import("convex/server").RegisteredQuery<"public", {
         from: number;
         interval?: "day" | "hour" | undefined;
@@ -2536,6 +2692,14 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         pageviewCount: number;
         path: string;
         previousPath?: string;
+        profile?: {
+            attributes?: Record<string, string | number | boolean>;
+            email?: string;
+            identifiedAt: number;
+            name?: string;
+            updatedAt: number;
+            visitorId: string;
+        };
         returning?: boolean;
         sessionId: string;
         siteId: string;
@@ -2573,6 +2737,14 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         os: string;
         pageviewCount: number;
         platform?: string;
+        profile?: {
+            attributes?: Record<string, string | number | boolean>;
+            email?: string;
+            identifiedAt: number;
+            name?: string;
+            updatedAt: number;
+            visitorId: string;
+        };
         referrer?: string;
         revenueCents: number;
         sessionId: string;
@@ -2633,6 +2805,14 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
             os: string;
             pageviewCount: number;
             platform?: string;
+            profile?: {
+                attributes?: Record<string, string | number | boolean>;
+                email?: string;
+                identifiedAt: number;
+                name?: string;
+                updatedAt: number;
+                visitorId: string;
+            };
             referrer?: string;
             revenueCents: number;
             sessionId: string;
@@ -2974,6 +3154,7 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
                 exact: boolean;
             };
         };
+        routePatterns?: Record<string, Array<string>>;
         routes: Array<{
             bounces: number;
             daily: Array<{
@@ -3262,6 +3443,8 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             setRetentionPolicy: "setRetentionPolicy";
             disableRetentionPolicy: "disableRetentionPolicy";
             getSession: "getSession";
+            getVisitorProfile: "getVisitorProfile";
+            listPeople: "listPeople";
             revenueSummary: "revenueSummary";
             vitalsReport: "vitalsReport";
             siteMap: "siteMap";
@@ -3271,7 +3454,7 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             deleteTrackedLink: "deleteTrackedLink";
             transferConnection?: "transferConnection" | undefined;
         };
-        capabilities: ("affiliates" | "configure" | "conversions" | "dataCoverage" | "funnels" | "goals" | "liveVisitors" | "localDays" | "overview" | "revenueSummary" | "sessionDetails" | "sessionJourney" | "sessions" | "siteMap" | "siteSummaries" | "trackedLinks" | "transfer" | "visitorJourney" | "vitals")[];
+        capabilities: ("affiliates" | "configure" | "conversions" | "dataCoverage" | "funnels" | "goals" | "liveVisitors" | "localDays" | "overview" | "people" | "revenueSummary" | "sessionDetails" | "sessionJourney" | "sessions" | "siteMap" | "siteSummaries" | "trackedLinks" | "transfer" | "visitorJourney" | "visitorProfiles" | "vitals")[];
         limits: {
             maxSitesPerRequest: 10;
             maxSitesPerConnection: 10;
@@ -3462,6 +3645,14 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
         pageviewCount: number;
         path: string;
         previousPath?: string;
+        profile?: {
+            attributes?: Record<string, string | number | boolean>;
+            email?: string;
+            identifiedAt: number;
+            name?: string;
+            updatedAt: number;
+            visitorId: string;
+        };
         returning?: boolean;
         sessionId: string;
         siteId: string;
@@ -3499,6 +3690,14 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
         os: string;
         pageviewCount: number;
         platform?: string;
+        profile?: {
+            attributes?: Record<string, string | number | boolean>;
+            email?: string;
+            identifiedAt: number;
+            name?: string;
+            updatedAt: number;
+            visitorId: string;
+        };
         referrer?: string;
         revenueCents: number;
         sessionId: string;
@@ -3559,6 +3758,14 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             os: string;
             pageviewCount: number;
             platform?: string;
+            profile?: {
+                attributes?: Record<string, string | number | boolean>;
+                email?: string;
+                identifiedAt: number;
+                name?: string;
+                updatedAt: number;
+                visitorId: string;
+            };
             referrer?: string;
             revenueCents: number;
             sessionId: string;
@@ -3690,6 +3897,46 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
         type: "pageview" | "click" | "custom" | "conversion" | "heartbeat" | "leave" | "outbound" | "vital";
         visitorId: string;
     }[]>>;
+    getVisitorProfile: import("convex/server").RegisteredQuery<"public", {
+        siteId: string;
+        visitorId: string;
+    }, Promise<{
+        attributes?: Record<string, string | number | boolean>;
+        email?: string;
+        identifiedAt: number;
+        name?: string;
+        updatedAt: number;
+        visitorId: string;
+    } | null>>;
+    listPeople: import("convex/server").RegisteredQuery<"public", {
+        filter?: {
+            field: "email" | "name" | "visitorId";
+            prefix: string;
+        } | {
+            field: "attribute";
+            key: string;
+            value: string | number | boolean;
+        } | undefined;
+        paginationOpts: {
+            cursor: string | null;
+            numItems: number;
+        };
+        siteId: string;
+    }, Promise<{
+        continueCursor: string;
+        isDone: boolean;
+        page: Array<{
+            _creationTime: number;
+            _id: string;
+            attributes?: Record<string, string | number | boolean>;
+            email?: string;
+            identifiedAt: number;
+            name?: string;
+            siteId: string;
+            updatedAt: number;
+            visitorId: string;
+        }>;
+    }>>;
     goalsReport: import("convex/server").RegisteredQuery<"public", {
         from: number;
         siteId: string;
@@ -3900,6 +4147,7 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
                 exact: boolean;
             };
         };
+        routePatterns?: Record<string, Array<string>>;
         routes: Array<{
             bounces: number;
             daily: Array<{
@@ -3959,10 +4207,12 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
         timezone: string | null;
         currency: string;
         cookieless: boolean;
+        routePatterns: string[];
     }>>;
     updateSite: import("convex/server").RegisteredMutation<"public", {
         domains?: string[] | undefined;
         name?: string | undefined;
+        routePatterns?: string[] | undefined;
         siteId: string;
         timezone?: string | null | undefined;
     }, Promise<null>>;