@mathrunet/masamune_firebase_workflow_marketing 3.8.0

package/dist/clients/app_store_client.d.ts

@@ -0,0 +1,54 @@
+/**
+ * App Store Connect API Client
+ *
+ * Collects app data from App Store Connect:
+ * - App information
+ * - Ratings and reviews
+ *
+ * @see https://developer.apple.com/documentation/appstoreconnectapi
+ */
+import { DateRange, RatingDistribution, Review, AppStoreClientConfig, AppStoreAppInfo, AppStoreRatings, AppStoreReview, AppStoreReviewsResponse, AppStoreGetReviewsOptions } from "../models";
+export { DateRange, RatingDistribution, Review, AppStoreClientConfig };
+export type AppInfo = AppStoreAppInfo;
+export type AppRatings = AppStoreRatings;
+export { AppStoreReview, AppStoreReviewsResponse, AppStoreGetReviewsOptions };
+/**
+ * App Store Connect API Client.
+ */
+export declare class AppStoreClient {
+    private keyId;
+    private issuerId;
+    private privateKey;
+    private appId;
+    private vendorNumber?;
+    private tokenCache;
+    constructor(config: AppStoreClientConfig);
+    /**
+     * Generate JWT token for App Store Connect API.
+     */
+    private generateToken;
+    /**
+     * Make authenticated API request.
+     */
+    private apiRequest;
+    /**
+     * Get app basic information.
+     */
+    getAppInfo(): Promise<AppInfo>;
+    /**
+     * Get app ratings.
+     * Note: App Store Connect API doesn't directly provide ratings summary.
+     * We need to calculate from customer reviews or use App Analytics.
+     */
+    getRatings(): Promise<AppRatings>;
+    /**
+     * Get customer reviews.
+     */
+    getReviews(options?: AppStoreGetReviewsOptions): Promise<AppStoreReviewsResponse>;
+    /**
+     * Collect all App Store data for a date range.
+     */
+    collectAllData(dateRange: DateRange): Promise<{
+        [key: string]: any;
+    }>;
+}

package/dist/clients/app_store_client.js

@@ -0,0 +1,280 @@
+"use strict";
+/**
+ * App Store Connect API Client
+ *
+ * Collects app data from App Store Connect:
+ * - App information
+ * - Ratings and reviews
+ *
+ * @see https://developer.apple.com/documentation/appstoreconnectapi
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppStoreClient = void 0;
+const fs = __importStar(require("fs"));
+const jwt = __importStar(require("jsonwebtoken"));
+const APP_STORE_API_BASE = "https://api.appstoreconnect.apple.com/v1";
+/**
+ * App Store Connect API Client.
+ */
+class AppStoreClient {
+    keyId;
+    issuerId;
+    privateKey;
+    appId;
+    vendorNumber;
+    tokenCache = null;
+    constructor(config) {
+        // Validate private key file exists
+        if (!fs.existsSync(config.privateKeyPath)) {
+            throw new Error(`Private key file not found: ${config.privateKeyPath}`);
+        }
+        this.keyId = config.keyId;
+        this.issuerId = config.issuerId;
+        this.privateKey = fs.readFileSync(config.privateKeyPath, "utf-8");
+        this.appId = config.appId;
+        this.vendorNumber = config.vendorNumber;
+    }
+    /**
+     * Generate JWT token for App Store Connect API.
+     */
+    generateToken() {
+        // Check cache
+        const now = Math.floor(Date.now() / 1000);
+        if (this.tokenCache && this.tokenCache.expiresAt > now + 60) {
+            return this.tokenCache.token;
+        }
+        // Token expires in 20 minutes (max allowed)
+        const expiresAt = now + 20 * 60;
+        const payload = {
+            iss: this.issuerId,
+            iat: now,
+            exp: expiresAt,
+            aud: "appstoreconnect-v1",
+        };
+        const token = jwt.sign(payload, this.privateKey, {
+            algorithm: "ES256",
+            header: {
+                alg: "ES256",
+                kid: this.keyId,
+                typ: "JWT",
+            },
+        });
+        // Cache the token
+        this.tokenCache = { token, expiresAt };
+        return token;
+    }
+    /**
+     * Make authenticated API request.
+     */
+    async apiRequest(endpoint, options = {}) {
+        const token = this.generateToken();
+        const url = endpoint.startsWith("http") ? endpoint : `${APP_STORE_API_BASE}${endpoint}`;
+        const response = await fetch(url, {
+            ...options,
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "application/json",
+                ...options.headers,
+            },
+        });
+        if (!response.ok) {
+            const errorBody = await response.text();
+            throw new Error(`App Store Connect API error: ${response.status} ${response.statusText} - ${errorBody}`);
+        }
+        return response.json();
+    }
+    /**
+     * Get app basic information.
+     */
+    async getAppInfo() {
+        try {
+            const response = await this.apiRequest(`/apps/${this.appId}`);
+            const app = response.data;
+            return {
+                appId: app.id,
+                name: app.attributes.name,
+                bundleId: app.attributes.bundleId,
+                sku: app.attributes.sku,
+                primaryLocale: app.attributes.primaryLocale,
+            };
+        }
+        catch (err) {
+            console.error("Failed to get app info:", err.message);
+            throw err;
+        }
+    }
+    /**
+     * Get app ratings.
+     * Note: App Store Connect API doesn't directly provide ratings summary.
+     * We need to calculate from customer reviews or use App Analytics.
+     */
+    async getRatings() {
+        try {
+            // Fetch reviews to calculate ratings
+            const reviews = await this.getReviews({ limit: 200 });
+            if (reviews.reviews.length === 0) {
+                return {
+                    averageRating: 0,
+                    totalRatings: 0,
+                    ratingDistribution: {
+                        star1: 0,
+                        star2: 0,
+                        star3: 0,
+                        star4: 0,
+                        star5: 0,
+                    },
+                };
+            }
+            const distribution = {
+                star1: 0,
+                star2: 0,
+                star3: 0,
+                star4: 0,
+                star5: 0,
+            };
+            let totalRating = 0;
+            for (const review of reviews.reviews) {
+                totalRating += review.rating;
+                switch (review.rating) {
+                    case 1:
+                        distribution.star1++;
+                        break;
+                    case 2:
+                        distribution.star2++;
+                        break;
+                    case 3:
+                        distribution.star3++;
+                        break;
+                    case 4:
+                        distribution.star4++;
+                        break;
+                    case 5:
+                        distribution.star5++;
+                        break;
+                }
+            }
+            const totalRatings = reviews.reviews.length;
+            const averageRating = totalRatings > 0 ? Math.round((totalRating / totalRatings) * 10) / 10 : 0;
+            return {
+                averageRating,
+                totalRatings,
+                ratingDistribution: distribution,
+            };
+        }
+        catch (err) {
+            console.error("Failed to get ratings:", err.message);
+            return {
+                averageRating: 0,
+                totalRatings: 0,
+                ratingDistribution: { star1: 0, star2: 0, star3: 0, star4: 0, star5: 0 },
+            };
+        }
+    }
+    /**
+     * Get customer reviews.
+     */
+    async getReviews(options = {}) {
+        try {
+            const limit = options.limit || 100;
+            const sort = options.sort || "-createdDate";
+            let url = `/apps/${this.appId}/customerReviews?limit=${limit}&sort=${sort}`;
+            if (options.cursor) {
+                url = options.cursor;
+            }
+            const response = await this.apiRequest(url);
+            const reviews = (response.data || []).map((review) => ({
+                id: review.id,
+                rating: review.attributes.rating,
+                title: review.attributes.title || "",
+                body: review.attributes.body || "",
+                reviewerNickname: review.attributes.reviewerNickname || "Anonymous",
+                createdDate: review.attributes.createdDate,
+                territory: review.attributes.territory,
+            }));
+            return {
+                reviews,
+                nextCursor: response.links?.next,
+            };
+        }
+        catch (err) {
+            console.error("Failed to get reviews:", err.message);
+            return { reviews: [] };
+        }
+    }
+    /**
+     * Collect all App Store data for a date range.
+     */
+    async collectAllData(dateRange) {
+        const [appInfo, ratings, reviewsResponse] = await Promise.all([
+            this.getAppInfo().catch((err) => {
+                console.error("Failed to get app info:", err.message);
+                return null;
+            }),
+            this.getRatings().catch((err) => {
+                console.error("Failed to get ratings:", err.message);
+                return {
+                    averageRating: 0,
+                    totalRatings: 0,
+                    ratingDistribution: { star1: 0, star2: 0, star3: 0, star4: 0, star5: 0 },
+                };
+            }),
+            this.getReviews({ limit: 50 }).catch((err) => {
+                console.error("Failed to get reviews:", err.message);
+                return { reviews: [] };
+            }),
+        ]);
+        // Convert reviews to common format
+        const recentReviews = reviewsResponse.reviews.map((r) => ({
+            id: r.id,
+            rating: r.rating,
+            title: r.title,
+            text: r.body,
+            authorName: r.reviewerNickname,
+            date: r.createdDate.split("T")[0],
+        }));
+        return {
+            appId: this.appId,
+            dateRange: dateRange,
+            averageRating: ratings.averageRating,
+            totalRatings: ratings.totalRatings,
+            ratingDistribution: ratings.ratingDistribution,
+            recentReviews: recentReviews,
+            collectedAt: new Date().toISOString(),
+        };
+    }
+}
+exports.AppStoreClient = AppStoreClient;
+//# sourceMappingURL=app_store_client.js.map

package/dist/clients/app_store_client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app_store_client.js","sourceRoot":"","sources":["../../src/clients/app_store_client.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,kDAAoC;AAqBpC,MAAM,kBAAkB,GAAG,0CAA0C,CAAC;AAEtE;;GAEG;AACH,MAAa,cAAc;IACf,KAAK,CAAS;IACd,QAAQ,CAAS;IACjB,UAAU,CAAS;IACnB,KAAK,CAAS;IACd,YAAY,CAAU;IACtB,UAAU,GAAgD,IAAI,CAAC;IAEvE,YAAY,MAA4B;QACpC,mCAAmC;QACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;QAC5E,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAClE,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;IAC5C,CAAC;IAED;;OAEG;IACK,aAAa;QACjB,cAAc;QACd,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,GAAG,GAAG,GAAG,EAAE,EAAE,CAAC;YAC1D,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QACjC,CAAC;QAED,4CAA4C;QAC5C,MAAM,SAAS,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,CAAC;QAEhC,MAAM,OAAO,GAAG;YACZ,GAAG,EAAE,IAAI,CAAC,QAAQ;YAClB,GAAG,EAAE,GAAG;YACR,GAAG,EAAE,SAAS;YACd,GAAG,EAAE,oBAAoB;SAC5B,CAAC;QAEF,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE;YAC7C,SAAS,EAAE,OAAO;YAClB,MAAM,EAAE;gBACJ,GAAG,EAAE,OAAO;gBACZ,GAAG,EAAE,IAAI,CAAC,KAAK;gBACf,GAAG,EAAE,KAAK;aACb;SACJ,CAAC,CAAC;QAEH,kBAAkB;QAClB,IAAI,CAAC,UAAU,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAEvC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,UAAU,CAAI,QAAgB,EAAE,UAAuB,EAAE;QACnE,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,kBAAkB,GAAG,QAAQ,EAAE,CAAC;QAExF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC9B,GAAG,OAAO;YACV,OAAO,EAAE;gBACL,aAAa,EAAE,UAAU,KAAK,EAAE;gBAChC,cAAc,EAAE,kBAAkB;gBAClC,GAAG,OAAO,CAAC,OAAO;aACrB;SACJ,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,MAAM,SAAS,EAAE,CAAC,CAAC;QAC7G,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAgB,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACZ,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAM,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAEnE,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC;YAC1B,OAAO;gBACH,KAAK,EAAE,GAAG,CAAC,EAAE;gBACb,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI;gBACzB,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,QAAQ;gBACjC,GAAG,EAAE,GAAG,CAAC,UAAU,CAAC,GAAG;gBACvB,aAAa,EAAE,GAAG,CAAC,UAAU,CAAC,aAAa;aAC9C,CAAC;QACN,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;YACtD,MAAM,GAAG,CAAC;QACd,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU;QACZ,IAAI,CAAC;YACD,qCAAqC;YACrC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YAEtD,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC/B,OAAO;oBACH,aAAa,EAAE,CAAC;oBAChB,YAAY,EAAE,CAAC;oBACf,kBAAkB,EAAE;wBAChB,KAAK,EAAE,CAAC;wBACR,KAAK,EAAE,CAAC;wBACR,KAAK,EAAE,CAAC;wBACR,KAAK,EAAE,CAAC;wBACR,KAAK,EAAE,CAAC;qBACX;iBACJ,CAAC;YACN,CAAC;YAED,MAAM,YAAY,GAAuB;gBACrC,KAAK,EAAE,CAAC;gBACR,KAAK,EAAE,CAAC;gBACR,KAAK,EAAE,CAAC;gBACR,KAAK,EAAE,CAAC;gBACR,KAAK,EAAE,CAAC;aACX,CAAC;YAEF,IAAI,WAAW,GAAG,CAAC,CAAC;YAEpB,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACnC,WAAW,IAAI,MAAM,CAAC,MAAM,CAAC;gBAC7B,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;oBACpB,KAAK,CAAC;wBACF,YAAY,CAAC,KAAK,EAAE,CAAC;wBACrB,MAAM;oBACV,KAAK,CAAC;wBACF,YAAY,CAAC,KAAK,EAAE,CAAC;wBACrB,MAAM;oBACV,KAAK,CAAC;wBACF,YAAY,CAAC,KAAK,EAAE,CAAC;wBACrB,MAAM;oBACV,KAAK,CAAC;wBACF,YAAY,CAAC,KAAK,EAAE,CAAC;wBACrB,MAAM;oBACV,KAAK,CAAC;wBACF,YAAY,CAAC,KAAK,EAAE,CAAC;wBACrB,MAAM;gBACd,CAAC;YACL,CAAC;YAED,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;YAC5C,MAAM,aAAa,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,GAAG,YAAY,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAEhG,OAAO;gBACH,aAAa;gBACb,YAAY;gBACZ,kBAAkB,EAAE,YAAY;aACnC,CAAC;QACN,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;YACrD,OAAO;gBACH,aAAa,EAAE,CAAC;gBAChB,YAAY,EAAE,CAAC;gBACf,kBAAkB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;aAC3E,CAAC;QACN,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,UAAqC,EAAE;QACpD,IAAI,CAAC;YACD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC;YACnC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,cAAc,CAAC;YAE5C,IAAI,GAAG,GAAG,SAAS,IAAI,CAAC,KAAK,0BAA0B,KAAK,SAAS,IAAI,EAAE,CAAC;YAC5E,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACjB,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;YACzB,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAM,GAAG,CAAC,CAAC;YAEjD,MAAM,OAAO,GAAqB,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAW,EAAE,EAAE,CAAC,CAAC;gBAC1E,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,MAAM;gBAChC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE;gBACpC,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,EAAE;gBAClC,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,gBAAgB,IAAI,WAAW;gBACnE,WAAW,EAAE,MAAM,CAAC,UAAU,CAAC,WAAW;gBAC1C,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,SAAS;aACzC,CAAC,CAAC,CAAC;YAEJ,OAAO;gBACH,OAAO;gBACP,UAAU,EAAE,QAAQ,CAAC,KAAK,EAAE,IAAI;aACnC,CAAC;QACN,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;YACrD,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QAC3B,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,SAAoB;QACrC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,eAAe,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC1D,IAAI,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC5B,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;gBACtD,OAAO,IAAI,CAAC;YAChB,CAAC,CAAC;YACF,IAAI,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC5B,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;gBACrD,OAAO;oBACH,aAAa,EAAE,CAAC;oBAChB,YAAY,EAAE,CAAC;oBACf,kBAAkB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;iBAC3E,CAAC;YACN,CAAC,CAAC;YACF,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACzC,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;gBACrD,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YAC3B,CAAC,CAAC;SACL,CAAC,CAAC;QAEH,mCAAmC;QACnC,MAAM,aAAa,GAAa,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAChE,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,UAAU,EAAE,CAAC,CAAC,gBAAgB;YAC9B,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACpC,CAAC,CAAC,CAAC;QAEJ,OAAO;YACH,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,SAAS;YACpB,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;YAC9C,aAAa,EAAE,aAAa;YAC5B,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACxC,CAAC;IACN,CAAC;CACJ;AA5PD,wCA4PC"}

package/dist/clients/firebase_analytics_client.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Firebase Analytics Data API Client
+ *
+ * Collects analytics data from Google Analytics 4 (Firebase Analytics):
+ * - Active users (DAU, WAU, MAU)
+ * - User demographics (age, gender, country, language)
+ * - Device information
+ * - Engagement metrics
+ *
+ * @see https://developers.google.com/analytics/devguides/reporting/data/v1
+ */
+import { DateRange, FirebaseAnalyticsClientConfig, AgeGroupDistribution, GenderDistribution, CountryDistribution, LanguageDistribution, DeviceTypeDistribution, OsVersionDistribution, ActiveUsersMetrics, UserDemographics, DeviceInfo, EngagementMetrics } from "../models";
+export { DateRange, FirebaseAnalyticsClientConfig, AgeGroupDistribution, GenderDistribution, CountryDistribution, LanguageDistribution, DeviceTypeDistribution, OsVersionDistribution, ActiveUsersMetrics, UserDemographics, DeviceInfo, EngagementMetrics, };
+/**
+ * Firebase Analytics Data API Client.
+ */
+export declare class FirebaseAnalyticsClient {
+    private analyticsClient;
+    private propertyId;
+    constructor(config: FirebaseAnalyticsClientConfig);
+    /**
+     * Get active users metrics (DAU, WAU, MAU).
+     */
+    getActiveUsers(dateRange: DateRange): Promise<ActiveUsersMetrics>;
+    /**
+     * Get user demographics (age, gender, country, language).
+     */
+    getUserDemographics(dateRange: DateRange): Promise<UserDemographics>;
+    /**
+     * Get age and gender distribution.
+     */
+    private getAgeGenderDistribution;
+    /**
+     * Map GA4 age bracket to our format.
+     */
+    private mapAgeBracket;
+    /**
+     * Get country distribution.
+     */
+    private getCountryDistribution;
+    /**
+     * Get language distribution.
+     */
+    private getLanguageDistribution;
+    /**
+     * Get device information (device types and OS versions).
+     */
+    getDeviceInfo(dateRange: DateRange): Promise<DeviceInfo>;
+    /**
+     * Get device type distribution.
+     */
+    private getDeviceTypeDistribution;
+    /**
+     * Get OS version distribution.
+     */
+    private getOsVersionDistribution;
+    /**
+     * Get engagement metrics.
+     */
+    getEngagementMetrics(dateRange: DateRange): Promise<EngagementMetrics>;
+    /**
+     * Collect all Firebase Analytics data for a date range.
+     */
+    collectAllData(dateRange: DateRange): Promise<{
+        [key: string]: any;
+    }>;
+}