@bubblelab/bubble-core 0.1.237 → 0.1.239

package/dist/bubbles/tool-bubble/app-rankings-tool.d.ts

@@ -0,0 +1,285 @@
+import { z } from 'zod';
+import { ToolBubble } from '../../types/tool-bubble-class.js';
+import type { BubbleContext } from '../../types/bubble.js';
+import { CredentialType, type BubbleName } from '@bubblelab/shared-schemas';
+declare const AppRankingsToolParamsSchema: z.ZodObject<{
+    operation: z.ZodEnum<["rankings"]>;
+    stores: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodEnum<["apple", "google"]>, "many">>>;
+    countries: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
+    appleCategories: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
+    googleCategories: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
+    chartType: z.ZodOptional<z.ZodDefault<z.ZodEnum<["free", "paid", "grossing"]>>>;
+    limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    credentials: z.ZodOptional<z.ZodRecord<z.ZodNativeEnum<typeof CredentialType>, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    operation: "rankings";
+    credentials?: Partial<Record<CredentialType, string>> | undefined;
+    limit?: number | undefined;
+    stores?: ("google" | "apple")[] | undefined;
+    appleCategories?: string[] | undefined;
+    googleCategories?: string[] | undefined;
+    chartType?: "free" | "paid" | "grossing" | undefined;
+    countries?: string[] | undefined;
+}, {
+    operation: "rankings";
+    credentials?: Partial<Record<CredentialType, string>> | undefined;
+    limit?: number | undefined;
+    stores?: ("google" | "apple")[] | undefined;
+    appleCategories?: string[] | undefined;
+    googleCategories?: string[] | undefined;
+    chartType?: "free" | "paid" | "grossing" | undefined;
+    countries?: string[] | undefined;
+}>;
+declare const AppRankingsToolResultSchema: z.ZodObject<{
+    operation: z.ZodEnum<["rankings"]>;
+    rankings: z.ZodArray<z.ZodObject<{
+        store: z.ZodEnum<["apple", "google"]>;
+        rank: z.ZodNumber;
+        appName: z.ZodString;
+        appId: z.ZodString;
+        appUrl: z.ZodNullable<z.ZodString>;
+        developer: z.ZodNullable<z.ZodString>;
+        rating: z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+        ratingCount: z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+        price: z.ZodNullable<z.ZodString>;
+        category: z.ZodString;
+        chartType: z.ZodString;
+        genres: z.ZodNullable<z.ZodString>;
+        country: z.ZodString;
+        releaseDate: z.ZodNullable<z.ZodString>;
+        iconUrl: z.ZodNullable<z.ZodString>;
+        scrapedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        developer: string | null;
+        store: "google" | "apple";
+        rating: string | number | null;
+        category: string;
+        country: string;
+        price: string | null;
+        scrapedAt: string;
+        rank: number;
+        appId: string;
+        iconUrl: string | null;
+        appName: string;
+        appUrl: string | null;
+        ratingCount: string | number | null;
+        chartType: string;
+        genres: string | null;
+        releaseDate: string | null;
+    }, {
+        developer: string | null;
+        store: "google" | "apple";
+        rating: string | number | null;
+        category: string;
+        country: string;
+        price: string | null;
+        scrapedAt: string;
+        rank: number;
+        appId: string;
+        iconUrl: string | null;
+        appName: string;
+        appUrl: string | null;
+        ratingCount: string | number | null;
+        chartType: string;
+        genres: string | null;
+        releaseDate: string | null;
+    }>, "many">;
+    totalApps: z.ZodNumber;
+    success: z.ZodBoolean;
+    error: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    error: string;
+    success: boolean;
+    operation: "rankings";
+    rankings: {
+        developer: string | null;
+        store: "google" | "apple";
+        rating: string | number | null;
+        category: string;
+        country: string;
+        price: string | null;
+        scrapedAt: string;
+        rank: number;
+        appId: string;
+        iconUrl: string | null;
+        appName: string;
+        appUrl: string | null;
+        ratingCount: string | number | null;
+        chartType: string;
+        genres: string | null;
+        releaseDate: string | null;
+    }[];
+    totalApps: number;
+}, {
+    error: string;
+    success: boolean;
+    operation: "rankings";
+    rankings: {
+        developer: string | null;
+        store: "google" | "apple";
+        rating: string | number | null;
+        category: string;
+        country: string;
+        price: string | null;
+        scrapedAt: string;
+        rank: number;
+        appId: string;
+        iconUrl: string | null;
+        appName: string;
+        appUrl: string | null;
+        ratingCount: string | number | null;
+        chartType: string;
+        genres: string | null;
+        releaseDate: string | null;
+    }[];
+    totalApps: number;
+}>;
+type AppRankingsToolParams = z.output<typeof AppRankingsToolParamsSchema>;
+type AppRankingsToolResult = z.output<typeof AppRankingsToolResultSchema>;
+type AppRankingsToolParamsInput = z.input<typeof AppRankingsToolParamsSchema>;
+export declare class AppRankingsTool extends ToolBubble<AppRankingsToolParams, AppRankingsToolResult> {
+    static readonly bubbleName: BubbleName;
+    static readonly schema: z.ZodObject<{
+        operation: z.ZodEnum<["rankings"]>;
+        stores: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodEnum<["apple", "google"]>, "many">>>;
+        countries: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
+        appleCategories: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
+        googleCategories: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
+        chartType: z.ZodOptional<z.ZodDefault<z.ZodEnum<["free", "paid", "grossing"]>>>;
+        limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        credentials: z.ZodOptional<z.ZodRecord<z.ZodNativeEnum<typeof CredentialType>, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        operation: "rankings";
+        credentials?: Partial<Record<CredentialType, string>> | undefined;
+        limit?: number | undefined;
+        stores?: ("google" | "apple")[] | undefined;
+        appleCategories?: string[] | undefined;
+        googleCategories?: string[] | undefined;
+        chartType?: "free" | "paid" | "grossing" | undefined;
+        countries?: string[] | undefined;
+    }, {
+        operation: "rankings";
+        credentials?: Partial<Record<CredentialType, string>> | undefined;
+        limit?: number | undefined;
+        stores?: ("google" | "apple")[] | undefined;
+        appleCategories?: string[] | undefined;
+        googleCategories?: string[] | undefined;
+        chartType?: "free" | "paid" | "grossing" | undefined;
+        countries?: string[] | undefined;
+    }>;
+    static readonly resultSchema: z.ZodObject<{
+        operation: z.ZodEnum<["rankings"]>;
+        rankings: z.ZodArray<z.ZodObject<{
+            store: z.ZodEnum<["apple", "google"]>;
+            rank: z.ZodNumber;
+            appName: z.ZodString;
+            appId: z.ZodString;
+            appUrl: z.ZodNullable<z.ZodString>;
+            developer: z.ZodNullable<z.ZodString>;
+            rating: z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+            ratingCount: z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+            price: z.ZodNullable<z.ZodString>;
+            category: z.ZodString;
+            chartType: z.ZodString;
+            genres: z.ZodNullable<z.ZodString>;
+            country: z.ZodString;
+            releaseDate: z.ZodNullable<z.ZodString>;
+            iconUrl: z.ZodNullable<z.ZodString>;
+            scrapedAt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            developer: string | null;
+            store: "google" | "apple";
+            rating: string | number | null;
+            category: string;
+            country: string;
+            price: string | null;
+            scrapedAt: string;
+            rank: number;
+            appId: string;
+            iconUrl: string | null;
+            appName: string;
+            appUrl: string | null;
+            ratingCount: string | number | null;
+            chartType: string;
+            genres: string | null;
+            releaseDate: string | null;
+        }, {
+            developer: string | null;
+            store: "google" | "apple";
+            rating: string | number | null;
+            category: string;
+            country: string;
+            price: string | null;
+            scrapedAt: string;
+            rank: number;
+            appId: string;
+            iconUrl: string | null;
+            appName: string;
+            appUrl: string | null;
+            ratingCount: string | number | null;
+            chartType: string;
+            genres: string | null;
+            releaseDate: string | null;
+        }>, "many">;
+        totalApps: z.ZodNumber;
+        success: z.ZodBoolean;
+        error: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        error: string;
+        success: boolean;
+        operation: "rankings";
+        rankings: {
+            developer: string | null;
+            store: "google" | "apple";
+            rating: string | number | null;
+            category: string;
+            country: string;
+            price: string | null;
+            scrapedAt: string;
+            rank: number;
+            appId: string;
+            iconUrl: string | null;
+            appName: string;
+            appUrl: string | null;
+            ratingCount: string | number | null;
+            chartType: string;
+            genres: string | null;
+            releaseDate: string | null;
+        }[];
+        totalApps: number;
+    }, {
+        error: string;
+        success: boolean;
+        operation: "rankings";
+        rankings: {
+            developer: string | null;
+            store: "google" | "apple";
+            rating: string | number | null;
+            category: string;
+            country: string;
+            price: string | null;
+            scrapedAt: string;
+            rank: number;
+            appId: string;
+            iconUrl: string | null;
+            appName: string;
+            appUrl: string | null;
+            ratingCount: string | number | null;
+            chartType: string;
+            genres: string | null;
+            releaseDate: string | null;
+        }[];
+        totalApps: number;
+    }>;
+    static readonly shortDescription = "Scrape Apple App Store and Google Play top free, paid, and grossing chart rankings across countries and categories.";
+    static readonly longDescription = "\n    App store rankings scraping tool for iOS and Android top charts.\n\n    Operations:\n    - rankings: Get top chart rankings (free, paid, or grossing) across 60+ countries and 50+ categories\n\n    Supports both Apple App Store and Google Play Store in a single run.\n    Returns up to `limit` apps per store/country/category combination as a flat array.\n    Use the `store`, `country`, and `category` fields on each result to filter/group.\n\n    Examples:\n      // US top 10 free apps (both stores):\n      { operation: 'rankings', limit: 10 }\n\n      // Apple-only Games category, top 50:\n      { operation: 'rankings', stores: ['apple'], appleCategories: ['6014'], limit: 50 }\n\n      // Top grossing across US, JP, DE:\n      { operation: 'rankings', chartType: 'grossing', countries: ['us', 'jp', 'de'] }\n\n      // Multiple categories (Health & Medical):\n      { operation: 'rankings', appleCategories: ['6013', '6020'], googleCategories: ['HEALTH_AND_FITNESS', 'MEDICAL'] }\n\n    Apple Category IDs: overall, 6000 (Business), 6001 (Weather), 6002 (Utilities), 6003 (Travel),\n      6004 (Sports), 6005 (Social Networking), 6006 (Reference), 6007 (Productivity), 6008 (Lifestyle),\n      6009 (News), 6010 (Navigation), 6011 (Music), 6012 (Photo & Video), 6013 (Health & Fitness),\n      6014 (Games), 6015 (Finance), 6016 (Entertainment), 6017 (Education), 6018 (Books),\n      6020 (Medical), 6023 (Food & Drink), 6024 (Shopping), 6026 (Magazines & Newspapers)\n\n    Google Play Categories: APPLICATION, GAME, ART_AND_DESIGN, AUTO_AND_VEHICLES, BEAUTY,\n      BOOKS_AND_REFERENCE, BUSINESS, COMMUNICATION, DATING, EDUCATION, ENTERTAINMENT, EVENTS,\n      FINANCE, FOOD_AND_DRINK, HEALTH_AND_FITNESS, LIFESTYLE, MAPS_AND_NAVIGATION, MEDICAL,\n      MUSIC_AND_AUDIO, NEWS_AND_MAGAZINES, PHOTOGRAPHY, PRODUCTIVITY, SHOPPING, SOCIAL, SPORTS,\n      TOOLS, TRAVEL_AND_LOCAL, VIDEO_PLAYERS, WEATHER\n\n    Uses Apify's slothtechlabs/ios-android-app-rankings-scraper.\n  ";
+    static readonly alias = "app-rankings";
+    static readonly type = "tool";
+    constructor(params?: AppRankingsToolParamsInput, context?: BubbleContext);
+    performAction(): Promise<AppRankingsToolResult>;
+    private createErrorResult;
+    private scrapeRankings;
+    private transformRankings;
+}
+export {};
+//# sourceMappingURL=app-rankings-tool.d.ts.map

package/dist/bubbles/tool-bubble/app-rankings-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-rankings-tool.d.ts","sourceRoot":"","sources":["../../../src/bubbles/tool-bubble/app-rankings-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,2BAA2B,CAAC;AA+B5E,QAAA,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4D/B,CAAC;AAEH,QAAA,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM/B,CAAC;AAEH,KAAK,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAC1E,KAAK,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAC1E,KAAK,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAW9E,qBAAa,eAAgB,SAAQ,UAAU,CAC7C,qBAAqB,EACrB,qBAAqB,CACtB;IACC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAuB;IAC7D,MAAM,CAAC,QAAQ,CAAC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;OAA+B;IACrD,MAAM,CAAC,QAAQ,CAAC,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAA+B;IAC3D,MAAM,CAAC,QAAQ,CAAC,gBAAgB,yHACwF;IACxH,MAAM,CAAC,QAAQ,CAAC,eAAe,y8DAoC7B;IACF,MAAM,CAAC,QAAQ,CAAC,KAAK,kBAAkB;IACvC,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;gBAG5B,MAAM,GAAE,0BAIP,EACD,OAAO,CAAC,EAAE,aAAa;IAKnB,aAAa,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAwBrD,OAAO,CAAC,iBAAiB;YAUX,cAAc;IAkE5B,OAAO,CAAC,iBAAiB;CA6B1B"}

package/dist/bubbles/tool-bubble/app-rankings-tool.js

@@ -0,0 +1,230 @@
+import { z } from 'zod';
+import { ToolBubble } from '../../types/tool-bubble-class.js';
+import { CredentialType } from '@bubblelab/shared-schemas';
+import { ApifyBubble } from '../service-bubble/apify/apify.js';
+const AppRankingSchema = z.object({
+    store: z
+        .enum(['apple', 'google'])
+        .describe('Which app store this ranking is from'),
+    rank: z.number().describe('Chart position (1-indexed)'),
+    appName: z.string().describe('App display name'),
+    appId: z.string().describe('Unique app identifier'),
+    appUrl: z.string().nullable().describe('Direct link to store listing'),
+    developer: z.string().nullable().describe('Developer or publisher name'),
+    rating: z
+        .union([z.number(), z.string()])
+        .nullable()
+        .describe('Average user rating or "Not enough reviews yet"'),
+    ratingCount: z
+        .union([z.number(), z.string()])
+        .nullable()
+        .describe('Total ratings count'),
+    price: z.string().nullable().describe('Price ("Free" for free apps)'),
+    category: z.string().describe('Human-readable category name'),
+    chartType: z.string().describe('Chart type (e.g., "top-free")'),
+    genres: z.string().nullable().describe('Comma-separated genre tags'),
+    country: z.string().describe('ISO country code'),
+    releaseDate: z.string().nullable().describe('Original release date'),
+    iconUrl: z.string().nullable().describe('App icon image URL'),
+    scrapedAt: z.string().describe('When data was scraped (ISO 8601)'),
+});
+const AppRankingsToolParamsSchema = z.object({
+    operation: z
+        .enum(['rankings'])
+        .describe('Operation (only rankings supported)'),
+    stores: z
+        .array(z.enum(['apple', 'google']))
+        .min(1)
+        .default(['apple', 'google'])
+        .optional()
+        .describe("Array of stores to scrape: 'apple', 'google', or both. Default: ['apple', 'google']. Pass ['apple'] for App Store only."),
+    countries: z
+        .array(z.string())
+        .default(['us'])
+        .optional()
+        .describe('Array of ISO 3166-1 alpha-2 country codes. Default: ["us"]. Example: ["us", "jp", "de"]'),
+    appleCategories: z
+        .array(z.string())
+        .default(['overall'])
+        .optional()
+        .describe('Array of Apple category IDs. Use "overall" for all apps. Common IDs: "6014" (Games), "6015" (Finance), "6013" (Health & Fitness), "6020" (Medical), "6016" (Entertainment), "6005" (Social Networking), "6007" (Productivity), "6002" (Utilities), "6017" (Education), "6008" (Lifestyle). Default: ["overall"]'),
+    googleCategories: z
+        .array(z.string())
+        .default(['APPLICATION'])
+        .optional()
+        .describe('Array of Google Play category IDs. Use "APPLICATION" for all apps. Common values: "GAME", "FINANCE", "HEALTH_AND_FITNESS", "MEDICAL", "ENTERTAINMENT", "SOCIAL", "PRODUCTIVITY", "TOOLS", "EDUCATION", "LIFESTYLE". Default: ["APPLICATION"]'),
+    chartType: z
+        .enum(['free', 'paid', 'grossing'])
+        .default('free')
+        .optional()
+        .describe("Which chart to scrape. One of: 'free', 'paid', 'grossing'. Default: 'free'"),
+    limit: z
+        .number()
+        .min(1)
+        .max(100)
+        .default(100)
+        .optional()
+        .describe('Number of apps to return per store/country/category combination (1-100, default: 100)'),
+    credentials: z
+        .record(z.nativeEnum(CredentialType), z.string())
+        .optional()
+        .describe('Required credentials (auto-injected)'),
+});
+const AppRankingsToolResultSchema = z.object({
+    operation: z.enum(['rankings']).describe('Operation performed'),
+    rankings: z.array(AppRankingSchema).describe('App rankings'),
+    totalApps: z.number().describe('Total apps returned'),
+    success: z.boolean().describe('Whether the operation was successful'),
+    error: z.string().describe('Error message if operation failed'),
+});
+const CHART_TYPE_MAP = {
+    free: { apple: 'topfreeapplications', google: 'topselling_free' },
+    paid: { apple: 'toppaidapplications', google: 'topselling_paid' },
+    grossing: {
+        apple: 'topgrossingapplications',
+        google: 'topgrossing',
+    },
+};
+export class AppRankingsTool extends ToolBubble {
+    static bubbleName = 'app-rankings-tool';
+    static schema = AppRankingsToolParamsSchema;
+    static resultSchema = AppRankingsToolResultSchema;
+    static shortDescription = 'Scrape Apple App Store and Google Play top free, paid, and grossing chart rankings across countries and categories.';
+    static longDescription = `
+    App store rankings scraping tool for iOS and Android top charts.
+
+    Operations:
+    - rankings: Get top chart rankings (free, paid, or grossing) across 60+ countries and 50+ categories
+
+    Supports both Apple App Store and Google Play Store in a single run.
+    Returns up to \`limit\` apps per store/country/category combination as a flat array.
+    Use the \`store\`, \`country\`, and \`category\` fields on each result to filter/group.
+
+    Examples:
+      // US top 10 free apps (both stores):
+      { operation: 'rankings', limit: 10 }
+
+      // Apple-only Games category, top 50:
+      { operation: 'rankings', stores: ['apple'], appleCategories: ['6014'], limit: 50 }
+
+      // Top grossing across US, JP, DE:
+      { operation: 'rankings', chartType: 'grossing', countries: ['us', 'jp', 'de'] }
+
+      // Multiple categories (Health & Medical):
+      { operation: 'rankings', appleCategories: ['6013', '6020'], googleCategories: ['HEALTH_AND_FITNESS', 'MEDICAL'] }
+
+    Apple Category IDs: overall, 6000 (Business), 6001 (Weather), 6002 (Utilities), 6003 (Travel),
+      6004 (Sports), 6005 (Social Networking), 6006 (Reference), 6007 (Productivity), 6008 (Lifestyle),
+      6009 (News), 6010 (Navigation), 6011 (Music), 6012 (Photo & Video), 6013 (Health & Fitness),
+      6014 (Games), 6015 (Finance), 6016 (Entertainment), 6017 (Education), 6018 (Books),
+      6020 (Medical), 6023 (Food & Drink), 6024 (Shopping), 6026 (Magazines & Newspapers)
+
+    Google Play Categories: APPLICATION, GAME, ART_AND_DESIGN, AUTO_AND_VEHICLES, BEAUTY,
+      BOOKS_AND_REFERENCE, BUSINESS, COMMUNICATION, DATING, EDUCATION, ENTERTAINMENT, EVENTS,
+      FINANCE, FOOD_AND_DRINK, HEALTH_AND_FITNESS, LIFESTYLE, MAPS_AND_NAVIGATION, MEDICAL,
+      MUSIC_AND_AUDIO, NEWS_AND_MAGAZINES, PHOTOGRAPHY, PRODUCTIVITY, SHOPPING, SOCIAL, SPORTS,
+      TOOLS, TRAVEL_AND_LOCAL, VIDEO_PLAYERS, WEATHER
+
+    Uses Apify's slothtechlabs/ios-android-app-rankings-scraper.
+  `;
+    static alias = 'app-rankings';
+    static type = 'tool';
+    constructor(params = {
+        operation: 'rankings',
+        stores: ['apple', 'google'],
+        limit: 100,
+    }, context) {
+        super(params, context);
+    }
+    async performAction() {
+        const credentials = this.params.credentials;
+        if (!credentials || !credentials[CredentialType.APIFY_CRED]) {
+            return this.createErrorResult('App rankings scraping requires authentication. Please configure APIFY_CRED.');
+        }
+        try {
+            const result = await this.scrapeRankings();
+            return {
+                operation: 'rankings',
+                rankings: result.rankings,
+                totalApps: result.rankings.length,
+                success: result.success,
+                error: result.error,
+            };
+        }
+        catch (error) {
+            return this.createErrorResult(error instanceof Error ? error.message : 'Unknown error occurred');
+        }
+    }
+    createErrorResult(errorMessage) {
+        return {
+            operation: 'rankings',
+            rankings: [],
+            totalApps: 0,
+            success: false,
+            error: errorMessage,
+        };
+    }
+    async scrapeRankings() {
+        const { stores = ['apple', 'google'], countries = ['us'], appleCategories = ['overall'], googleCategories = ['APPLICATION'], chartType = 'free', limit = 100, } = this.params;
+        const chartMapping = CHART_TYPE_MAP[chartType];
+        const input = {
+            stores: stores,
+            appleCountries: countries,
+            appleCategories: appleCategories,
+            appleChartTypes: [chartMapping.apple],
+            googleCountries: countries,
+            googleCategories: googleCategories,
+            googleChartTypes: [chartMapping.google],
+            limit,
+        };
+        const scraper = new ApifyBubble({
+            actorId: 'slothtechlabs/ios-android-app-rankings-scraper',
+            input,
+            waitForFinish: true,
+            timeout: 300000,
+            limit: stores.length * countries.length * limit,
+            credentials: this.params.credentials,
+        }, this.context, 'appRankingsScraper');
+        const apifyResult = await scraper.action();
+        if (!apifyResult.data.success) {
+            return {
+                rankings: [],
+                success: false,
+                error: apifyResult.data.error || 'Failed to scrape app rankings',
+            };
+        }
+        const items = apifyResult.data.items || [];
+        const rankings = this.transformRankings(items);
+        return {
+            rankings,
+            success: true,
+            error: '',
+        };
+    }
+    transformRankings(items) {
+        return items.map((item) => ({
+            store: item.store,
+            rank: item.rank,
+            appName: item.appName,
+            appId: item.appId,
+            appUrl: item.appUrl || null,
+            developer: item.developer || null,
+            rating: typeof item.rating === 'number' || typeof item.rating === 'string'
+                ? item.rating
+                : null,
+            ratingCount: typeof item.ratingCount === 'number' ||
+                typeof item.ratingCount === 'string'
+                ? item.ratingCount
+                : null,
+            price: item.price || null,
+            category: item.category,
+            chartType: item.chartType,
+            genres: item.genres || null,
+            country: item.country,
+            releaseDate: item.releaseDate || null,
+            iconUrl: item.iconUrl || null,
+            scrapedAt: item.scrapedAt,
+        }));
+    }
+}
+//# sourceMappingURL=app-rankings-tool.js.map

package/dist/bubbles/tool-bubble/app-rankings-tool.js.map

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

package/dist/bubbles/tool-bubble/browser-tools/_shared/schema.d.ts

@@ -30,7 +30,6 @@ export declare const BrowserSessionDataSchema: z.ZodObject<{
         secure?: boolean | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
-    contextId: string;
     cookies: {
         value: string;
         name: string;
@@ -40,8 +39,8 @@ export declare const BrowserSessionDataSchema: z.ZodObject<{
         httpOnly?: boolean | undefined;
         secure?: boolean | undefined;
     }[];
-}, {
     contextId: string;
+}, {
     cookies: {
         value: string;
         name: string;
@@ -51,6 +50,7 @@ export declare const BrowserSessionDataSchema: z.ZodObject<{
         httpOnly?: boolean | undefined;
         secure?: boolean | undefined;
     }[];
+    contextId: string;
 }>;
 /**
  * Custom proxy configuration

package/dist/bubbles/tool-bubble/bubbleflow-validation-tool.d.ts

@@ -135,13 +135,13 @@ declare const BubbleFlowValidationToolResultSchema: z.ZodObject<{
         hasActionCall: boolean;
         parameterCount: number;
     }[] | undefined;
-    bubbleCount?: number | undefined;
     variableTypes?: {
         type: string;
         name: string;
         column: number;
         line: number;
     }[] | undefined;
+    bubbleCount?: number | undefined;
 }, {
     valid: boolean;
     error: string;
@@ -160,13 +160,13 @@ declare const BubbleFlowValidationToolResultSchema: z.ZodObject<{
         hasActionCall: boolean;
         parameterCount: number;
     }[] | undefined;
-    bubbleCount?: number | undefined;
     variableTypes?: {
         type: string;
         name: string;
         column: number;
         line: number;
     }[] | undefined;
+    bubbleCount?: number | undefined;
 }>;
 /**
  * BubbleFlow Validation Tool
@@ -284,13 +284,13 @@ export declare class BubbleFlowValidationTool extends ToolBubble<BubbleFlowValid
             hasActionCall: boolean;
             parameterCount: number;
         }[] | undefined;
-        bubbleCount?: number | undefined;
         variableTypes?: {
             type: string;
             name: string;
             column: number;
             line: number;
         }[] | undefined;
+        bubbleCount?: number | undefined;
     }, {
         valid: boolean;
         error: string;
@@ -309,13 +309,13 @@ export declare class BubbleFlowValidationTool extends ToolBubble<BubbleFlowValid
             hasActionCall: boolean;
             parameterCount: number;
         }[] | undefined;
-        bubbleCount?: number | undefined;
         variableTypes?: {
             type: string;
             name: string;
             column: number;
             line: number;
         }[] | undefined;
+        bubbleCount?: number | undefined;
     }>;
     static readonly shortDescription = "Validates BubbleFlow TypeScript code for syntax and structure";
     static readonly longDescription = "\n    A comprehensive validation tool for BubbleFlow TypeScript code.\n    \n    What it does:\n    - Validates TypeScript syntax and compilation\n    - Checks BubbleFlow class structure and requirements\n    - Parses and analyzes bubble instantiations\n    - Provides detailed error reporting with line numbers\n    - Returns metadata about detected bubbles\n    \n    How it works:\n    - Uses TypeScript compiler API for syntax validation\n    - Validates that code extends BubbleFlow and has handle method\n    - Parses bubble instantiations using AST analysis\n    - Maps bubble class names to registered bubble types\n    \n    Use cases:\n    - When an AI agent needs to validate user-provided BubbleFlow code\n    - When checking code before execution or deployment\n    - When providing feedback on BubbleFlow implementation\n    - When analyzing bubble usage patterns in code\n  ";