@iann29/rastro 0.1.0-alpha.2 → 0.1.0-alpha.4

package/dist/client/federation.d.ts

@@ -0,0 +1,205 @@
+import type { UserIdentity } from "convex/server";
+import type { AnalyticsAuthorizationContext } from "./index.js";
+export declare const FEDERATED_ANALYTICS_CLAIMS: Readonly<{
+    readonly connectionId: "rastro_connection_id";
+    readonly organizationId: "rastro_organization_id";
+    readonly permissions: "rastro_permissions";
+}>;
+export declare const FEDERATED_ANALYTICS_READ_PERMISSION = "analytics:read";
+export declare const FEDERATED_ANALYTICS_ERROR_CODES: Readonly<{
+    readonly UNAUTHENTICATED: "FEDERATION_UNAUTHENTICATED";
+    readonly ISSUER_MISMATCH: "FEDERATION_ISSUER_MISMATCH";
+    readonly INVALID_CLAIMS: "FEDERATION_INVALID_CLAIMS";
+    readonly CONNECTION_DENIED: "FEDERATION_CONNECTION_DENIED";
+    readonly INVALID_SCOPE: "FEDERATION_INVALID_SCOPE";
+    readonly SITE_DENIED: "FEDERATION_SITE_DENIED";
+}>;
+export declare const FEDERATED_ANALYTICS_CONNECTOR_MANIFEST: Readonly<{
+    readonly protocol: "amage-rastro-analytics";
+    readonly protocolVersion: 1;
+    readonly moduleName: "rastroFederation";
+    readonly functions: Readonly<{
+        readonly manifest: "manifest";
+        readonly connectionStatus: "connectionStatus";
+        readonly listSites: "listSites";
+        readonly overview: "overview";
+        readonly liveVisitors: "liveVisitors";
+        readonly listSessions: "listSessions";
+        readonly sessionJourney: "sessionJourney";
+        readonly listConversions: "listConversions";
+        readonly visitorJourney: "visitorJourney";
+        readonly goalsReport: "goalsReport";
+        readonly funnelsReport: "funnelsReport";
+        readonly affiliatesReport: "affiliatesReport";
+        readonly dataCoverage: "dataCoverage";
+    }>;
+    readonly capabilities: readonly ["siteSummaries", "overview", "liveVisitors", "sessions", "sessionJourney", "conversions", "visitorJourney", "goals", "funnels", "affiliates", "dataCoverage"];
+    readonly limits: Readonly<{
+        readonly maxSitesPerRequest: 10;
+        readonly maxSitesPerConnection: 10;
+        readonly maxReportRangeDays: 366;
+        readonly maxLiveVisitors: 500;
+        readonly maxJourneyEvents: 500;
+    }>;
+}>;
+export type FederatedAnalyticsErrorCode = (typeof FEDERATED_ANALYTICS_ERROR_CODES)[keyof typeof FEDERATED_ANALYTICS_ERROR_CODES];
+export type FederatedAnalyticsCapability = (typeof FEDERATED_ANALYTICS_CONNECTOR_MANIFEST.capabilities)[number];
+export type FederatedAnalyticsManifest = ReturnType<typeof createFederatedAnalyticsManifest>;
+export interface FederatedAnalyticsConnection {
+    connectionId: string;
+    organizationId: string;
+    siteIds: readonly string[];
+    revokedAt?: number;
+}
+export interface FederatedAnalyticsIdentity {
+    connectionId: string;
+    organizationId: string;
+    identity: UserIdentity;
+}
+export interface FederatedSiteSummary {
+    siteId: string;
+    name: string;
+    currency: string;
+    timezone: string | null;
+    cookieless: boolean;
+}
+export interface FederatedAnalyticsConnectionStatus {
+    status: "connected";
+    protocolVersion: 1;
+    capabilities: FederatedAnalyticsCapability[];
+    siteCount: number;
+}
+export type ResolveFederatedAnalyticsConnection = (ctx: AnalyticsAuthorizationContext, identity: FederatedAnalyticsIdentity) => FederatedAnalyticsConnection | null | Promise<FederatedAnalyticsConnection | null>;
+export interface FederatedAnalyticsAuthorizerOptions {
+    issuer: string;
+    resolveConnection: ResolveFederatedAnalyticsConnection;
+}
+export declare const federatedAnalyticsManifestValidator: import("convex/values").VObject<{
+    capabilities: ("affiliates" | "conversions" | "dataCoverage" | "funnels" | "goals" | "liveVisitors" | "overview" | "sessionJourney" | "sessions" | "siteSummaries" | "visitorJourney")[];
+    functions: {
+        affiliatesReport: "affiliatesReport";
+        connectionStatus: "connectionStatus";
+        dataCoverage: "dataCoverage";
+        funnelsReport: "funnelsReport";
+        goalsReport: "goalsReport";
+        listConversions: "listConversions";
+        listSessions: "listSessions";
+        listSites: "listSites";
+        liveVisitors: "liveVisitors";
+        manifest: "manifest";
+        overview: "overview";
+        sessionJourney: "sessionJourney";
+        visitorJourney: "visitorJourney";
+    };
+    limits: {
+        maxJourneyEvents: number;
+        maxLiveVisitors: number;
+        maxReportRangeDays: number;
+        maxSitesPerConnection: number;
+        maxSitesPerRequest: number;
+    };
+    moduleName: "rastroFederation";
+    protocol: "amage-rastro-analytics";
+    protocolVersion: 1;
+}, {
+    protocol: import("convex/values").VLiteral<"amage-rastro-analytics", "required">;
+    protocolVersion: import("convex/values").VLiteral<1, "required">;
+    moduleName: import("convex/values").VLiteral<"rastroFederation", "required">;
+    functions: import("convex/values").VObject<{
+        affiliatesReport: "affiliatesReport";
+        connectionStatus: "connectionStatus";
+        dataCoverage: "dataCoverage";
+        funnelsReport: "funnelsReport";
+        goalsReport: "goalsReport";
+        listConversions: "listConversions";
+        listSessions: "listSessions";
+        listSites: "listSites";
+        liveVisitors: "liveVisitors";
+        manifest: "manifest";
+        overview: "overview";
+        sessionJourney: "sessionJourney";
+        visitorJourney: "visitorJourney";
+    }, {
+        manifest: import("convex/values").VLiteral<"manifest", "required">;
+        connectionStatus: import("convex/values").VLiteral<"connectionStatus", "required">;
+        listSites: import("convex/values").VLiteral<"listSites", "required">;
+        overview: import("convex/values").VLiteral<"overview", "required">;
+        liveVisitors: import("convex/values").VLiteral<"liveVisitors", "required">;
+        listSessions: import("convex/values").VLiteral<"listSessions", "required">;
+        sessionJourney: import("convex/values").VLiteral<"sessionJourney", "required">;
+        listConversions: import("convex/values").VLiteral<"listConversions", "required">;
+        visitorJourney: import("convex/values").VLiteral<"visitorJourney", "required">;
+        goalsReport: import("convex/values").VLiteral<"goalsReport", "required">;
+        funnelsReport: import("convex/values").VLiteral<"funnelsReport", "required">;
+        affiliatesReport: import("convex/values").VLiteral<"affiliatesReport", "required">;
+        dataCoverage: import("convex/values").VLiteral<"dataCoverage", "required">;
+    }, "required", "affiliatesReport" | "connectionStatus" | "dataCoverage" | "funnelsReport" | "goalsReport" | "listConversions" | "listSessions" | "listSites" | "liveVisitors" | "manifest" | "overview" | "sessionJourney" | "visitorJourney">;
+    capabilities: import("convex/values").VArray<("affiliates" | "conversions" | "dataCoverage" | "funnels" | "goals" | "liveVisitors" | "overview" | "sessionJourney" | "sessions" | "siteSummaries" | "visitorJourney")[], import("convex/values").VUnion<"affiliates" | "conversions" | "dataCoverage" | "funnels" | "goals" | "liveVisitors" | "overview" | "sessionJourney" | "sessions" | "siteSummaries" | "visitorJourney", [import("convex/values").VLiteral<"siteSummaries", "required">, import("convex/values").VLiteral<"overview", "required">, import("convex/values").VLiteral<"liveVisitors", "required">, import("convex/values").VLiteral<"sessions", "required">, import("convex/values").VLiteral<"sessionJourney", "required">, import("convex/values").VLiteral<"conversions", "required">, import("convex/values").VLiteral<"visitorJourney", "required">, import("convex/values").VLiteral<"goals", "required">, import("convex/values").VLiteral<"funnels", "required">, import("convex/values").VLiteral<"affiliates", "required">, import("convex/values").VLiteral<"dataCoverage", "required">], "required", never>, "required">;
+    limits: import("convex/values").VObject<{
+        maxJourneyEvents: number;
+        maxLiveVisitors: number;
+        maxReportRangeDays: number;
+        maxSitesPerConnection: number;
+        maxSitesPerRequest: number;
+    }, {
+        maxSitesPerRequest: import("convex/values").VFloat64<number, "required">;
+        maxSitesPerConnection: import("convex/values").VFloat64<number, "required">;
+        maxReportRangeDays: import("convex/values").VFloat64<number, "required">;
+        maxLiveVisitors: import("convex/values").VFloat64<number, "required">;
+        maxJourneyEvents: import("convex/values").VFloat64<number, "required">;
+    }, "required", "maxJourneyEvents" | "maxLiveVisitors" | "maxReportRangeDays" | "maxSitesPerConnection" | "maxSitesPerRequest">;
+}, "required", "capabilities" | "functions" | "functions.affiliatesReport" | "functions.connectionStatus" | "functions.dataCoverage" | "functions.funnelsReport" | "functions.goalsReport" | "functions.listConversions" | "functions.listSessions" | "functions.listSites" | "functions.liveVisitors" | "functions.manifest" | "functions.overview" | "functions.sessionJourney" | "functions.visitorJourney" | "limits" | "limits.maxJourneyEvents" | "limits.maxLiveVisitors" | "limits.maxReportRangeDays" | "limits.maxSitesPerConnection" | "limits.maxSitesPerRequest" | "moduleName" | "protocol" | "protocolVersion">;
+export declare const federatedAnalyticsConnectionStatusValidator: import("convex/values").VObject<{
+    capabilities: ("affiliates" | "conversions" | "dataCoverage" | "funnels" | "goals" | "liveVisitors" | "overview" | "sessionJourney" | "sessions" | "siteSummaries" | "visitorJourney")[];
+    protocolVersion: 1;
+    siteCount: number;
+    status: "connected";
+}, {
+    status: import("convex/values").VLiteral<"connected", "required">;
+    protocolVersion: import("convex/values").VLiteral<1, "required">;
+    capabilities: import("convex/values").VArray<("affiliates" | "conversions" | "dataCoverage" | "funnels" | "goals" | "liveVisitors" | "overview" | "sessionJourney" | "sessions" | "siteSummaries" | "visitorJourney")[], import("convex/values").VUnion<"affiliates" | "conversions" | "dataCoverage" | "funnels" | "goals" | "liveVisitors" | "overview" | "sessionJourney" | "sessions" | "siteSummaries" | "visitorJourney", [import("convex/values").VLiteral<"siteSummaries", "required">, import("convex/values").VLiteral<"overview", "required">, import("convex/values").VLiteral<"liveVisitors", "required">, import("convex/values").VLiteral<"sessions", "required">, import("convex/values").VLiteral<"sessionJourney", "required">, import("convex/values").VLiteral<"conversions", "required">, import("convex/values").VLiteral<"visitorJourney", "required">, import("convex/values").VLiteral<"goals", "required">, import("convex/values").VLiteral<"funnels", "required">, import("convex/values").VLiteral<"affiliates", "required">, import("convex/values").VLiteral<"dataCoverage", "required">], "required", never>, "required">;
+    siteCount: import("convex/values").VFloat64<number, "required">;
+}, "required", "capabilities" | "protocolVersion" | "siteCount" | "status">;
+export declare const federatedSiteSummaryValidator: import("convex/values").VObject<{
+    cookieless: boolean;
+    currency: string;
+    name: string;
+    siteId: string;
+    timezone: string | null;
+}, {
+    siteId: import("convex/values").VString<string, "required">;
+    name: import("convex/values").VString<string, "required">;
+    currency: import("convex/values").VString<string, "required">;
+    timezone: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    cookieless: import("convex/values").VBoolean<boolean, "required">;
+}, "required", "cookieless" | "currency" | "name" | "siteId" | "timezone">;
+export declare function createFederatedAnalyticsManifest(): {
+    protocol: "amage-rastro-analytics";
+    protocolVersion: 1;
+    moduleName: "rastroFederation";
+    functions: {
+        manifest: "manifest";
+        connectionStatus: "connectionStatus";
+        listSites: "listSites";
+        overview: "overview";
+        liveVisitors: "liveVisitors";
+        listSessions: "listSessions";
+        sessionJourney: "sessionJourney";
+        listConversions: "listConversions";
+        visitorJourney: "visitorJourney";
+        goalsReport: "goalsReport";
+        funnelsReport: "funnelsReport";
+        affiliatesReport: "affiliatesReport";
+        dataCoverage: "dataCoverage";
+    };
+    capabilities: ("affiliates" | "conversions" | "dataCoverage" | "funnels" | "goals" | "liveVisitors" | "overview" | "sessionJourney" | "sessions" | "siteSummaries" | "visitorJourney")[];
+    limits: {
+        maxSitesPerRequest: 10;
+        maxSitesPerConnection: 10;
+        maxReportRangeDays: 366;
+        maxLiveVisitors: 500;
+        maxJourneyEvents: 500;
+    };
+};
+export declare function createFederatedAnalyticsConnectionAuthorizer(options: FederatedAnalyticsAuthorizerOptions): (ctx: AnalyticsAuthorizationContext, requestedSiteIds?: readonly string[]) => Promise<FederatedAnalyticsConnection>;
+//# sourceMappingURL=federation.d.ts.map

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

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

package/dist/client/federation.js

@@ -0,0 +1,179 @@
+import { ConvexError, v } from "convex/values";
+import { MAX_JOURNEY_EVENTS, MAX_LIVE_VISITORS, MAX_REPORT_RANGE_DAYS, MAX_REPORT_SITES, } from "../component/constants.js";
+export const FEDERATED_ANALYTICS_CLAIMS = Object.freeze({
+    connectionId: "rastro_connection_id",
+    organizationId: "rastro_organization_id",
+    permissions: "rastro_permissions",
+});
+export const FEDERATED_ANALYTICS_READ_PERMISSION = "analytics:read";
+export const FEDERATED_ANALYTICS_ERROR_CODES = Object.freeze({
+    UNAUTHENTICATED: "FEDERATION_UNAUTHENTICATED",
+    ISSUER_MISMATCH: "FEDERATION_ISSUER_MISMATCH",
+    INVALID_CLAIMS: "FEDERATION_INVALID_CLAIMS",
+    CONNECTION_DENIED: "FEDERATION_CONNECTION_DENIED",
+    INVALID_SCOPE: "FEDERATION_INVALID_SCOPE",
+    SITE_DENIED: "FEDERATION_SITE_DENIED",
+});
+const MAX_CONNECTION_SITE_IDS = MAX_REPORT_SITES;
+const FEDERATED_ANALYTICS_FUNCTION_NAMES = Object.freeze({
+    manifest: "manifest",
+    connectionStatus: "connectionStatus",
+    listSites: "listSites",
+    overview: "overview",
+    liveVisitors: "liveVisitors",
+    listSessions: "listSessions",
+    sessionJourney: "sessionJourney",
+    listConversions: "listConversions",
+    visitorJourney: "visitorJourney",
+    goalsReport: "goalsReport",
+    funnelsReport: "funnelsReport",
+    affiliatesReport: "affiliatesReport",
+    dataCoverage: "dataCoverage",
+});
+const FEDERATED_ANALYTICS_CAPABILITIES = Object.freeze([
+    "siteSummaries",
+    "overview",
+    "liveVisitors",
+    "sessions",
+    "sessionJourney",
+    "conversions",
+    "visitorJourney",
+    "goals",
+    "funnels",
+    "affiliates",
+    "dataCoverage",
+]);
+const FEDERATED_ANALYTICS_LIMITS = Object.freeze({
+    maxSitesPerRequest: MAX_REPORT_SITES,
+    maxSitesPerConnection: MAX_CONNECTION_SITE_IDS,
+    maxReportRangeDays: MAX_REPORT_RANGE_DAYS,
+    maxLiveVisitors: MAX_LIVE_VISITORS,
+    maxJourneyEvents: MAX_JOURNEY_EVENTS,
+});
+export const FEDERATED_ANALYTICS_CONNECTOR_MANIFEST = Object.freeze({
+    protocol: "amage-rastro-analytics",
+    protocolVersion: 1,
+    moduleName: "rastroFederation",
+    functions: FEDERATED_ANALYTICS_FUNCTION_NAMES,
+    capabilities: FEDERATED_ANALYTICS_CAPABILITIES,
+    limits: FEDERATED_ANALYTICS_LIMITS,
+});
+const MAX_CLAIM_LENGTH = 128;
+const MAX_PERMISSIONS = 16;
+const federatedAnalyticsCapabilityValidator = v.union(v.literal("siteSummaries"), v.literal("overview"), v.literal("liveVisitors"), v.literal("sessions"), v.literal("sessionJourney"), v.literal("conversions"), v.literal("visitorJourney"), v.literal("goals"), v.literal("funnels"), v.literal("affiliates"), v.literal("dataCoverage"));
+export const federatedAnalyticsManifestValidator = v.object({
+    protocol: v.literal(FEDERATED_ANALYTICS_CONNECTOR_MANIFEST.protocol),
+    protocolVersion: v.literal(FEDERATED_ANALYTICS_CONNECTOR_MANIFEST.protocolVersion),
+    moduleName: v.literal(FEDERATED_ANALYTICS_CONNECTOR_MANIFEST.moduleName),
+    functions: v.object({
+        manifest: v.literal("manifest"),
+        connectionStatus: v.literal("connectionStatus"),
+        listSites: v.literal("listSites"),
+        overview: v.literal("overview"),
+        liveVisitors: v.literal("liveVisitors"),
+        listSessions: v.literal("listSessions"),
+        sessionJourney: v.literal("sessionJourney"),
+        listConversions: v.literal("listConversions"),
+        visitorJourney: v.literal("visitorJourney"),
+        goalsReport: v.literal("goalsReport"),
+        funnelsReport: v.literal("funnelsReport"),
+        affiliatesReport: v.literal("affiliatesReport"),
+        dataCoverage: v.literal("dataCoverage"),
+    }),
+    capabilities: v.array(federatedAnalyticsCapabilityValidator),
+    limits: v.object({
+        maxSitesPerRequest: v.number(),
+        maxSitesPerConnection: v.number(),
+        maxReportRangeDays: v.number(),
+        maxLiveVisitors: v.number(),
+        maxJourneyEvents: v.number(),
+    }),
+});
+export const federatedAnalyticsConnectionStatusValidator = v.object({
+    status: v.literal("connected"),
+    protocolVersion: v.literal(1),
+    capabilities: v.array(federatedAnalyticsCapabilityValidator),
+    siteCount: v.number(),
+});
+export const federatedSiteSummaryValidator = v.object({
+    siteId: v.string(),
+    name: v.string(),
+    currency: v.string(),
+    timezone: v.union(v.string(), v.null()),
+    cookieless: v.boolean(),
+});
+export function createFederatedAnalyticsManifest() {
+    return {
+        ...FEDERATED_ANALYTICS_CONNECTOR_MANIFEST,
+        functions: { ...FEDERATED_ANALYTICS_CONNECTOR_MANIFEST.functions },
+        capabilities: [...FEDERATED_ANALYTICS_CONNECTOR_MANIFEST.capabilities],
+        limits: { ...FEDERATED_ANALYTICS_CONNECTOR_MANIFEST.limits },
+    };
+}
+export function createFederatedAnalyticsConnectionAuthorizer(options) {
+    if (!isBoundedClaim(options?.issuer)) {
+        throw new Error("Federated analytics issuer must be a non-empty string");
+    }
+    if (typeof options.resolveConnection !== "function") {
+        throw new Error("Federated analytics connection resolver is required");
+    }
+    return async (ctx, requestedSiteIds) => {
+        const identity = await ctx.auth.getUserIdentity();
+        if (!identity) {
+            fail(FEDERATED_ANALYTICS_ERROR_CODES.UNAUTHENTICATED, "Federated analytics authentication is required");
+        }
+        if (identity.issuer !== options.issuer) {
+            fail(FEDERATED_ANALYTICS_ERROR_CODES.ISSUER_MISMATCH, "Federated analytics issuer is not trusted");
+        }
+        const connectionId = identity[FEDERATED_ANALYTICS_CLAIMS.connectionId];
+        const organizationId = identity[FEDERATED_ANALYTICS_CLAIMS.organizationId];
+        const permissions = identity[FEDERATED_ANALYTICS_CLAIMS.permissions];
+        if (!isBoundedClaim(connectionId) ||
+            !isBoundedClaim(organizationId) ||
+            !isStringArray(permissions, MAX_PERMISSIONS) ||
+            !permissions.includes(FEDERATED_ANALYTICS_READ_PERMISSION)) {
+            fail(FEDERATED_ANALYTICS_ERROR_CODES.INVALID_CLAIMS, "Federated analytics claims are invalid");
+        }
+        const connection = await options.resolveConnection(ctx, {
+            connectionId,
+            organizationId,
+            identity,
+        });
+        if (!connection ||
+            connection.revokedAt !== undefined ||
+            connection.connectionId !== connectionId ||
+            connection.organizationId !== organizationId ||
+            !isStringArray(connection.siteIds, MAX_CONNECTION_SITE_IDS) ||
+            connection.siteIds.length === 0 ||
+            new Set(connection.siteIds).size !== connection.siteIds.length) {
+            fail(FEDERATED_ANALYTICS_ERROR_CODES.CONNECTION_DENIED, "Federated analytics connection is not active");
+        }
+        if (requestedSiteIds !== undefined) {
+            if (requestedSiteIds.length === 0 ||
+                requestedSiteIds.length > MAX_REPORT_SITES ||
+                new Set(requestedSiteIds).size !== requestedSiteIds.length ||
+                requestedSiteIds.some((siteId) => !isBoundedClaim(siteId))) {
+                fail(FEDERATED_ANALYTICS_ERROR_CODES.INVALID_SCOPE, "Federated analytics site scope is invalid");
+            }
+            const allowedSiteIds = new Set(connection.siteIds);
+            if (requestedSiteIds.some((siteId) => !allowedSiteIds.has(siteId))) {
+                fail(FEDERATED_ANALYTICS_ERROR_CODES.SITE_DENIED, "Federated analytics site is not authorized");
+            }
+        }
+        return connection;
+    };
+}
+function isBoundedClaim(value) {
+    return (typeof value === "string" &&
+        value.length > 0 &&
+        value.length <= MAX_CLAIM_LENGTH);
+}
+function isStringArray(value, maximumLength) {
+    return (Array.isArray(value) &&
+        value.length <= maximumLength &&
+        value.every(isBoundedClaim));
+}
+function fail(code, message) {
+    throw new ConvexError({ code, message });
+}
+//# sourceMappingURL=federation.js.map

package/dist/client/federation.js.map

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