@mathrunet/masamune_firebase_workflow_marketing 3.8.0

package/dist/clients/firebase_analytics_client.js

@@ -0,0 +1,411 @@
+"use strict";
+/**
+ * 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
+ */
+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.FirebaseAnalyticsClient = void 0;
+const data_1 = require("@google-analytics/data");
+const fs = __importStar(require("fs"));
+/**
+ * Firebase Analytics Data API Client.
+ */
+class FirebaseAnalyticsClient {
+    analyticsClient;
+    propertyId;
+    constructor(config) {
+        // Validate service account file exists
+        if (!fs.existsSync(config.serviceAccountPath)) {
+            throw new Error(`Service account file not found: ${config.serviceAccountPath}`);
+        }
+        // Initialize Analytics Data client with service account
+        this.analyticsClient = new data_1.BetaAnalyticsDataClient({
+            keyFilename: config.serviceAccountPath,
+        });
+        this.propertyId = config.propertyId;
+    }
+    /**
+     * Get active users metrics (DAU, WAU, MAU).
+     */
+    async getActiveUsers(dateRange) {
+        try {
+            const [response] = await this.analyticsClient.runReport({
+                property: this.propertyId,
+                dateRanges: [
+                    {
+                        startDate: dateRange.startDate,
+                        endDate: dateRange.endDate,
+                    },
+                ],
+                metrics: [
+                    { name: "activeUsers" },
+                    { name: "active7DayUsers" },
+                    { name: "active28DayUsers" },
+                    { name: "newUsers" },
+                ],
+            });
+            const row = response.rows?.[0];
+            const metrics = row?.metricValues || [];
+            return {
+                dau: parseInt(metrics[0]?.value || "0", 10),
+                wau: parseInt(metrics[1]?.value || "0", 10),
+                mau: parseInt(metrics[2]?.value || "0", 10),
+                newUsers: parseInt(metrics[3]?.value || "0", 10),
+                returningUsers: parseInt(metrics[0]?.value || "0", 10) - parseInt(metrics[3]?.value || "0", 10),
+            };
+        }
+        catch (err) {
+            console.error("Failed to get active users:", err.message);
+            return { dau: 0, wau: 0, mau: 0, newUsers: 0, returningUsers: 0 };
+        }
+    }
+    /**
+     * Get user demographics (age, gender, country, language).
+     */
+    async getUserDemographics(dateRange) {
+        const [ageGender, country, language] = await Promise.all([
+            this.getAgeGenderDistribution(dateRange),
+            this.getCountryDistribution(dateRange),
+            this.getLanguageDistribution(dateRange),
+        ]);
+        return {
+            ageGroups: ageGender.ageGroups,
+            genderDistribution: ageGender.genderDistribution,
+            countryDistribution: country,
+            languageDistribution: language,
+        };
+    }
+    /**
+     * Get age and gender distribution.
+     */
+    async getAgeGenderDistribution(dateRange) {
+        try {
+            const [response] = await this.analyticsClient.runReport({
+                property: this.propertyId,
+                dateRanges: [
+                    {
+                        startDate: dateRange.startDate,
+                        endDate: dateRange.endDate,
+                    },
+                ],
+                dimensions: [{ name: "userAgeBracket" }, { name: "userGender" }],
+                metrics: [{ name: "activeUsers" }],
+            });
+            const ageGroups = {};
+            const genderDistribution = {
+                male: 0,
+                female: 0,
+                unknown: 0,
+            };
+            for (const row of response.rows || []) {
+                const age = row.dimensionValues?.[0]?.value || "unknown";
+                const gender = row.dimensionValues?.[1]?.value || "unknown";
+                const count = parseInt(row.metricValues?.[0]?.value || "0", 10);
+                // Map age brackets
+                const ageKey = this.mapAgeBracket(age);
+                ageGroups[ageKey] = (ageGroups[ageKey] || 0) + count;
+                // Map gender
+                if (gender === "male") {
+                    genderDistribution.male = (genderDistribution.male || 0) + count;
+                }
+                else if (gender === "female") {
+                    genderDistribution.female = (genderDistribution.female || 0) + count;
+                }
+                else {
+                    genderDistribution.unknown = (genderDistribution.unknown || 0) + count;
+                }
+            }
+            return { ageGroups, genderDistribution };
+        }
+        catch (err) {
+            console.error("Failed to get age/gender distribution:", err.message);
+            return {
+                ageGroups: {},
+                genderDistribution: { male: 0, female: 0, unknown: 0 },
+            };
+        }
+    }
+    /**
+     * Map GA4 age bracket to our format.
+     */
+    mapAgeBracket(ageBracket) {
+        const mapping = {
+            "18-24": "18-24",
+            "25-34": "25-34",
+            "35-44": "35-44",
+            "45-54": "45-54",
+            "55-64": "55-64",
+            "65+": "65+",
+        };
+        return mapping[ageBracket] || "unknown";
+    }
+    /**
+     * Get country distribution.
+     */
+    async getCountryDistribution(dateRange) {
+        try {
+            const [response] = await this.analyticsClient.runReport({
+                property: this.propertyId,
+                dateRanges: [
+                    {
+                        startDate: dateRange.startDate,
+                        endDate: dateRange.endDate,
+                    },
+                ],
+                dimensions: [{ name: "country" }],
+                metrics: [{ name: "activeUsers" }],
+                limit: 50,
+            });
+            const distribution = {};
+            for (const row of response.rows || []) {
+                const country = row.dimensionValues?.[0]?.value || "unknown";
+                const count = parseInt(row.metricValues?.[0]?.value || "0", 10);
+                distribution[country] = count;
+            }
+            return distribution;
+        }
+        catch (err) {
+            console.error("Failed to get country distribution:", err.message);
+            return {};
+        }
+    }
+    /**
+     * Get language distribution.
+     */
+    async getLanguageDistribution(dateRange) {
+        try {
+            const [response] = await this.analyticsClient.runReport({
+                property: this.propertyId,
+                dateRanges: [
+                    {
+                        startDate: dateRange.startDate,
+                        endDate: dateRange.endDate,
+                    },
+                ],
+                dimensions: [{ name: "language" }],
+                metrics: [{ name: "activeUsers" }],
+                limit: 50,
+            });
+            const distribution = {};
+            for (const row of response.rows || []) {
+                const language = row.dimensionValues?.[0]?.value || "unknown";
+                const count = parseInt(row.metricValues?.[0]?.value || "0", 10);
+                distribution[language] = count;
+            }
+            return distribution;
+        }
+        catch (err) {
+            console.error("Failed to get language distribution:", err.message);
+            return {};
+        }
+    }
+    /**
+     * Get device information (device types and OS versions).
+     */
+    async getDeviceInfo(dateRange) {
+        const [deviceTypes, osVersions] = await Promise.all([
+            this.getDeviceTypeDistribution(dateRange),
+            this.getOsVersionDistribution(dateRange),
+        ]);
+        return {
+            deviceTypes,
+            osVersions,
+        };
+    }
+    /**
+     * Get device type distribution.
+     */
+    async getDeviceTypeDistribution(dateRange) {
+        try {
+            const [response] = await this.analyticsClient.runReport({
+                property: this.propertyId,
+                dateRanges: [
+                    {
+                        startDate: dateRange.startDate,
+                        endDate: dateRange.endDate,
+                    },
+                ],
+                dimensions: [{ name: "deviceCategory" }],
+                metrics: [{ name: "activeUsers" }],
+            });
+            const distribution = {
+                phone: 0,
+                tablet: 0,
+                desktop: 0,
+                other: 0,
+            };
+            for (const row of response.rows || []) {
+                const category = row.dimensionValues?.[0]?.value?.toLowerCase() || "other";
+                const count = parseInt(row.metricValues?.[0]?.value || "0", 10);
+                if (category === "mobile") {
+                    distribution.phone = (distribution.phone || 0) + count;
+                }
+                else if (category === "tablet") {
+                    distribution.tablet = (distribution.tablet || 0) + count;
+                }
+                else if (category === "desktop") {
+                    distribution.desktop = (distribution.desktop || 0) + count;
+                }
+                else {
+                    distribution.other = (distribution.other || 0) + count;
+                }
+            }
+            return distribution;
+        }
+        catch (err) {
+            console.error("Failed to get device type distribution:", err.message);
+            return { phone: 0, tablet: 0, desktop: 0, other: 0 };
+        }
+    }
+    /**
+     * Get OS version distribution.
+     */
+    async getOsVersionDistribution(dateRange) {
+        try {
+            const [response] = await this.analyticsClient.runReport({
+                property: this.propertyId,
+                dateRanges: [
+                    {
+                        startDate: dateRange.startDate,
+                        endDate: dateRange.endDate,
+                    },
+                ],
+                dimensions: [{ name: "operatingSystemWithVersion" }],
+                metrics: [{ name: "activeUsers" }],
+                limit: 20,
+            });
+            const distribution = {};
+            for (const row of response.rows || []) {
+                const osVersion = row.dimensionValues?.[0]?.value || "unknown";
+                const count = parseInt(row.metricValues?.[0]?.value || "0", 10);
+                distribution[osVersion] = count;
+            }
+            return distribution;
+        }
+        catch (err) {
+            console.error("Failed to get OS version distribution:", err.message);
+            return {};
+        }
+    }
+    /**
+     * Get engagement metrics.
+     */
+    async getEngagementMetrics(dateRange) {
+        try {
+            const [response] = await this.analyticsClient.runReport({
+                property: this.propertyId,
+                dateRanges: [
+                    {
+                        startDate: dateRange.startDate,
+                        endDate: dateRange.endDate,
+                    },
+                ],
+                metrics: [
+                    { name: "averageSessionDuration" },
+                    { name: "sessionsPerUser" },
+                    { name: "screenPageViews" },
+                ],
+            });
+            const row = response.rows?.[0];
+            const metrics = row?.metricValues || [];
+            return {
+                averageSessionDuration: parseFloat(metrics[0]?.value || "0"),
+                sessionsPerUser: parseFloat(metrics[1]?.value || "0"),
+                screenPageViews: parseInt(metrics[2]?.value || "0", 10),
+            };
+        }
+        catch (err) {
+            console.error("Failed to get engagement metrics:", err.message);
+            return { averageSessionDuration: 0, sessionsPerUser: 0, screenPageViews: 0 };
+        }
+    }
+    /**
+     * Collect all Firebase Analytics data for a date range.
+     */
+    async collectAllData(dateRange) {
+        const [activeUsers, demographics, deviceInfo, engagement] = await Promise.all([
+            this.getActiveUsers(dateRange).catch((err) => {
+                console.error("Failed to get active users:", err.message);
+                return { dau: 0, wau: 0, mau: 0, newUsers: 0, returningUsers: 0 };
+            }),
+            this.getUserDemographics(dateRange).catch((err) => {
+                console.error("Failed to get demographics:", err.message);
+                return {
+                    ageGroups: {},
+                    genderDistribution: { male: 0, female: 0, unknown: 0 },
+                    countryDistribution: {},
+                    languageDistribution: {},
+                };
+            }),
+            this.getDeviceInfo(dateRange).catch((err) => {
+                console.error("Failed to get device info:", err.message);
+                return {
+                    deviceTypes: { phone: 0, tablet: 0, desktop: 0, other: 0 },
+                    osVersions: {},
+                };
+            }),
+            this.getEngagementMetrics(dateRange).catch((err) => {
+                console.error("Failed to get engagement metrics:", err.message);
+                return { averageSessionDuration: 0, sessionsPerUser: 0, screenPageViews: 0 };
+            }),
+        ]);
+        return {
+            propertyId: this.propertyId,
+            dateRange: dateRange,
+            dau: activeUsers.dau,
+            wau: activeUsers.wau,
+            mau: activeUsers.mau,
+            newUsers: activeUsers.newUsers,
+            returningUsers: activeUsers.returningUsers,
+            demographics: demographics,
+            deviceTypes: deviceInfo.deviceTypes,
+            osVersions: deviceInfo.osVersions,
+            averageSessionDuration: engagement.averageSessionDuration,
+            sessionsPerUser: engagement.sessionsPerUser,
+            screenPageViews: engagement.screenPageViews,
+            collectedAt: new Date().toISOString(),
+        };
+    }
+}
+exports.FirebaseAnalyticsClient = FirebaseAnalyticsClient;
+//# sourceMappingURL=firebase_analytics_client.js.map

package/dist/clients/firebase_analytics_client.js.map

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

package/dist/clients/github_content_client.d.ts

@@ -0,0 +1,83 @@
+/**
+ * GitHub Content API Client
+ *
+ * Fetches repository contents for code analysis:
+ * - Directory listings
+ * - File contents
+ * - Repository tree structure
+ *
+ * @see https://docs.github.com/en/rest/repos/contents
+ */
+import { GitHubContentClientConfig, GitHubContentItem, GitHubTreeItem } from "../models";
+export { GitHubContentClientConfig, GitHubContentItem, GitHubTreeItem, };
+/**
+ * GitHub Content API Client for repository analysis.
+ */
+export declare class GitHubContentClient {
+    private token;
+    private owner;
+    private repo;
+    constructor(config: GitHubContentClientConfig);
+    /**
+     * Make a GitHub API request.
+     */
+    private request;
+    /**
+     * Execute with retry logic.
+     */
+    private withRetry;
+    /**
+     * Get repository information.
+     */
+    getRepositoryInfo(): Promise<{
+        defaultBranch: string;
+        fullName: string;
+        description: string | null;
+    }>;
+    /**
+     * Get directory contents at a specific path.
+     */
+    getDirectoryContents(path?: string): Promise<GitHubContentItem[]>;
+    /**
+     * Get file content (for files under 1MB).
+     */
+    getFileContent(path: string): Promise<string>;
+    /**
+     * Get file content via Blob API (for larger files).
+     */
+    getFileContentViaBlob(sha: string): Promise<string>;
+    /**
+     * Get repository tree recursively.
+     */
+    getRepositoryTree(basePath?: string): Promise<GitHubTreeItem[]>;
+    /**
+     * Get filtered file list for analysis.
+     * Excludes binary files, generated files, and common non-source directories.
+     */
+    getFilteredFileList(basePath?: string): Promise<string[]>;
+    /**
+     * Check if a file should be included in analysis.
+     */
+    shouldIncludeFile(path: string): boolean;
+    /**
+     * Get file extension.
+     */
+    private getExtension;
+    /**
+     * Get folder paths from file list.
+     */
+    getFolderPaths(filePaths: string[]): string[];
+    /**
+     * Get files in a specific folder.
+     */
+    getFilesInFolder(filePaths: string[], folderPath: string): string[];
+    /**
+     * Detect framework from repository.
+     */
+    detectFramework(basePath?: string): Promise<{
+        framework: string;
+        platforms: string[];
+        configFile?: string;
+        configContent?: string;
+    }>;
+}