@bubblelab/bubble-core 0.1.8 → 0.1.9

package/dist/types/api-scraper.schema.d.ts

@@ -0,0 +1,453 @@
+import { z } from 'zod';
+export declare const APIFY_ACTOR_SCHEMAS: {
+    readonly 'apify/instagram-scraper': {
+        readonly input: z.ZodObject<{
+            directUrls: z.ZodArray<z.ZodString, "many">;
+            resultsType: z.ZodDefault<z.ZodEnum<["posts", "details"]>>;
+            resultsLimit: z.ZodDefault<z.ZodNumber>;
+            includeStories: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            includeHighlights: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        }, "strip", z.ZodTypeAny, {
+            directUrls: string[];
+            resultsType: "posts" | "details";
+            resultsLimit: number;
+            includeStories?: boolean | undefined;
+            includeHighlights?: boolean | undefined;
+        }, {
+            directUrls: string[];
+            resultsType?: "posts" | "details" | undefined;
+            resultsLimit?: number | undefined;
+            includeStories?: boolean | undefined;
+            includeHighlights?: boolean | undefined;
+        }>;
+        readonly output: z.ZodObject<{
+            username: z.ZodOptional<z.ZodString>;
+            fullName: z.ZodOptional<z.ZodString>;
+            biography: z.ZodOptional<z.ZodString>;
+            followersCount: z.ZodOptional<z.ZodNumber>;
+            followingCount: z.ZodOptional<z.ZodNumber>;
+            followsCount: z.ZodOptional<z.ZodNumber>;
+            postsCount: z.ZodOptional<z.ZodNumber>;
+            verified: z.ZodOptional<z.ZodBoolean>;
+            isVerified: z.ZodOptional<z.ZodBoolean>;
+            isPrivate: z.ZodOptional<z.ZodBoolean>;
+            profilePicUrl: z.ZodOptional<z.ZodString>;
+            profilePicture: z.ZodOptional<z.ZodString>;
+            externalUrl: z.ZodOptional<z.ZodString>;
+            latestPosts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+                shortCode: z.ZodOptional<z.ZodString>;
+                caption: z.ZodOptional<z.ZodString>;
+                likesCount: z.ZodOptional<z.ZodNumber>;
+                commentsCount: z.ZodOptional<z.ZodNumber>;
+                ownerUsername: z.ZodOptional<z.ZodString>;
+                ownerFullName: z.ZodOptional<z.ZodString>;
+                timestamp: z.ZodOptional<z.ZodString>;
+                type: z.ZodOptional<z.ZodNullable<z.ZodEnum<["image", "video", "carousel"]>>>;
+                displayUrl: z.ZodOptional<z.ZodString>;
+                hashtags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                mentions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                location: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    name: z.ZodOptional<z.ZodString>;
+                    id: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    name?: string | undefined;
+                    id?: string | undefined;
+                }, {
+                    name?: string | undefined;
+                    id?: string | undefined;
+                }>>>;
+            }, "strip", z.ZodTypeAny, {
+                url: string;
+                type?: "image" | "video" | "carousel" | null | undefined;
+                shortCode?: string | undefined;
+                caption?: string | undefined;
+                likesCount?: number | undefined;
+                commentsCount?: number | undefined;
+                ownerUsername?: string | undefined;
+                ownerFullName?: string | undefined;
+                timestamp?: string | undefined;
+                displayUrl?: string | undefined;
+                hashtags?: string[] | undefined;
+                mentions?: string[] | undefined;
+                location?: {
+                    name?: string | undefined;
+                    id?: string | undefined;
+                } | null | undefined;
+            }, {
+                url: string;
+                type?: "image" | "video" | "carousel" | null | undefined;
+                shortCode?: string | undefined;
+                caption?: string | undefined;
+                likesCount?: number | undefined;
+                commentsCount?: number | undefined;
+                ownerUsername?: string | undefined;
+                ownerFullName?: string | undefined;
+                timestamp?: string | undefined;
+                displayUrl?: string | undefined;
+                hashtags?: string[] | undefined;
+                mentions?: string[] | undefined;
+                location?: {
+                    name?: string | undefined;
+                    id?: string | undefined;
+                } | null | undefined;
+            }>, "many">>;
+            stories: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                url: z.ZodOptional<z.ZodString>;
+                timestamp: z.ZodOptional<z.ZodString>;
+                type: z.ZodOptional<z.ZodEnum<["image", "video"]>>;
+                viewsCount: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                type?: "image" | "video" | undefined;
+                url?: string | undefined;
+                timestamp?: string | undefined;
+                viewsCount?: number | undefined;
+            }, {
+                type?: "image" | "video" | undefined;
+                url?: string | undefined;
+                timestamp?: string | undefined;
+                viewsCount?: number | undefined;
+            }>, "many">>;
+            highlights: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                title: z.ZodOptional<z.ZodString>;
+                coverUrl: z.ZodOptional<z.ZodString>;
+                itemsCount: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                title?: string | undefined;
+                coverUrl?: string | undefined;
+                itemsCount?: number | undefined;
+            }, {
+                title?: string | undefined;
+                coverUrl?: string | undefined;
+                itemsCount?: number | undefined;
+            }>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            username?: string | undefined;
+            fullName?: string | undefined;
+            biography?: string | undefined;
+            followersCount?: number | undefined;
+            followingCount?: number | undefined;
+            followsCount?: number | undefined;
+            postsCount?: number | undefined;
+            verified?: boolean | undefined;
+            isVerified?: boolean | undefined;
+            isPrivate?: boolean | undefined;
+            profilePicUrl?: string | undefined;
+            profilePicture?: string | undefined;
+            externalUrl?: string | undefined;
+            latestPosts?: {
+                url: string;
+                type?: "image" | "video" | "carousel" | null | undefined;
+                shortCode?: string | undefined;
+                caption?: string | undefined;
+                likesCount?: number | undefined;
+                commentsCount?: number | undefined;
+                ownerUsername?: string | undefined;
+                ownerFullName?: string | undefined;
+                timestamp?: string | undefined;
+                displayUrl?: string | undefined;
+                hashtags?: string[] | undefined;
+                mentions?: string[] | undefined;
+                location?: {
+                    name?: string | undefined;
+                    id?: string | undefined;
+                } | null | undefined;
+            }[] | undefined;
+            stories?: {
+                type?: "image" | "video" | undefined;
+                url?: string | undefined;
+                timestamp?: string | undefined;
+                viewsCount?: number | undefined;
+            }[] | undefined;
+            highlights?: {
+                title?: string | undefined;
+                coverUrl?: string | undefined;
+                itemsCount?: number | undefined;
+            }[] | undefined;
+        }, {
+            username?: string | undefined;
+            fullName?: string | undefined;
+            biography?: string | undefined;
+            followersCount?: number | undefined;
+            followingCount?: number | undefined;
+            followsCount?: number | undefined;
+            postsCount?: number | undefined;
+            verified?: boolean | undefined;
+            isVerified?: boolean | undefined;
+            isPrivate?: boolean | undefined;
+            profilePicUrl?: string | undefined;
+            profilePicture?: string | undefined;
+            externalUrl?: string | undefined;
+            latestPosts?: {
+                url: string;
+                type?: "image" | "video" | "carousel" | null | undefined;
+                shortCode?: string | undefined;
+                caption?: string | undefined;
+                likesCount?: number | undefined;
+                commentsCount?: number | undefined;
+                ownerUsername?: string | undefined;
+                ownerFullName?: string | undefined;
+                timestamp?: string | undefined;
+                displayUrl?: string | undefined;
+                hashtags?: string[] | undefined;
+                mentions?: string[] | undefined;
+                location?: {
+                    name?: string | undefined;
+                    id?: string | undefined;
+                } | null | undefined;
+            }[] | undefined;
+            stories?: {
+                type?: "image" | "video" | undefined;
+                url?: string | undefined;
+                timestamp?: string | undefined;
+                viewsCount?: number | undefined;
+            }[] | undefined;
+            highlights?: {
+                title?: string | undefined;
+                coverUrl?: string | undefined;
+                itemsCount?: number | undefined;
+            }[] | undefined;
+        }>;
+        readonly description: "Scrape Instagram profiles, posts, stories, and highlights";
+        readonly documentation: "https://docs.apify.com/platform/actors/apify/instagram-scraper";
+        readonly category: "social-media";
+    };
+};
+export type ActorId = keyof typeof APIFY_ACTOR_SCHEMAS;
+export type ActorInput<T extends ActorId> = z.input<typeof APIFY_ACTOR_SCHEMAS[T]['input']>;
+export type ActorOutput<T extends ActorId> = z.output<typeof APIFY_ACTOR_SCHEMAS[T]['output']>;
+export type ActorSchema<T extends ActorId> = typeof APIFY_ACTOR_SCHEMAS[T];
+/**
+ * Get the input schema for a specific actor
+ */
+export declare function getActorInputSchema<T extends ActorId>(actorId: T): z.ZodObject<{
+    directUrls: z.ZodArray<z.ZodString, "many">;
+    resultsType: z.ZodDefault<z.ZodEnum<["posts", "details"]>>;
+    resultsLimit: z.ZodDefault<z.ZodNumber>;
+    includeStories: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    includeHighlights: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    directUrls: string[];
+    resultsType: "posts" | "details";
+    resultsLimit: number;
+    includeStories?: boolean | undefined;
+    includeHighlights?: boolean | undefined;
+}, {
+    directUrls: string[];
+    resultsType?: "posts" | "details" | undefined;
+    resultsLimit?: number | undefined;
+    includeStories?: boolean | undefined;
+    includeHighlights?: boolean | undefined;
+}>;
+/**
+ * Get the output schema for a specific actor
+ */
+export declare function getActorOutputSchema<T extends ActorId>(actorId: T): z.ZodObject<{
+    username: z.ZodOptional<z.ZodString>;
+    fullName: z.ZodOptional<z.ZodString>;
+    biography: z.ZodOptional<z.ZodString>;
+    followersCount: z.ZodOptional<z.ZodNumber>;
+    followingCount: z.ZodOptional<z.ZodNumber>;
+    followsCount: z.ZodOptional<z.ZodNumber>;
+    postsCount: z.ZodOptional<z.ZodNumber>;
+    verified: z.ZodOptional<z.ZodBoolean>;
+    isVerified: z.ZodOptional<z.ZodBoolean>;
+    isPrivate: z.ZodOptional<z.ZodBoolean>;
+    profilePicUrl: z.ZodOptional<z.ZodString>;
+    profilePicture: z.ZodOptional<z.ZodString>;
+    externalUrl: z.ZodOptional<z.ZodString>;
+    latestPosts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        shortCode: z.ZodOptional<z.ZodString>;
+        caption: z.ZodOptional<z.ZodString>;
+        likesCount: z.ZodOptional<z.ZodNumber>;
+        commentsCount: z.ZodOptional<z.ZodNumber>;
+        ownerUsername: z.ZodOptional<z.ZodString>;
+        ownerFullName: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodNullable<z.ZodEnum<["image", "video", "carousel"]>>>;
+        displayUrl: z.ZodOptional<z.ZodString>;
+        hashtags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        mentions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        location: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            name?: string | undefined;
+            id?: string | undefined;
+        }, {
+            name?: string | undefined;
+            id?: string | undefined;
+        }>>>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        type?: "image" | "video" | "carousel" | null | undefined;
+        shortCode?: string | undefined;
+        caption?: string | undefined;
+        likesCount?: number | undefined;
+        commentsCount?: number | undefined;
+        ownerUsername?: string | undefined;
+        ownerFullName?: string | undefined;
+        timestamp?: string | undefined;
+        displayUrl?: string | undefined;
+        hashtags?: string[] | undefined;
+        mentions?: string[] | undefined;
+        location?: {
+            name?: string | undefined;
+            id?: string | undefined;
+        } | null | undefined;
+    }, {
+        url: string;
+        type?: "image" | "video" | "carousel" | null | undefined;
+        shortCode?: string | undefined;
+        caption?: string | undefined;
+        likesCount?: number | undefined;
+        commentsCount?: number | undefined;
+        ownerUsername?: string | undefined;
+        ownerFullName?: string | undefined;
+        timestamp?: string | undefined;
+        displayUrl?: string | undefined;
+        hashtags?: string[] | undefined;
+        mentions?: string[] | undefined;
+        location?: {
+            name?: string | undefined;
+            id?: string | undefined;
+        } | null | undefined;
+    }>, "many">>;
+    stories: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodEnum<["image", "video"]>>;
+        viewsCount: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type?: "image" | "video" | undefined;
+        url?: string | undefined;
+        timestamp?: string | undefined;
+        viewsCount?: number | undefined;
+    }, {
+        type?: "image" | "video" | undefined;
+        url?: string | undefined;
+        timestamp?: string | undefined;
+        viewsCount?: number | undefined;
+    }>, "many">>;
+    highlights: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        coverUrl: z.ZodOptional<z.ZodString>;
+        itemsCount: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        title?: string | undefined;
+        coverUrl?: string | undefined;
+        itemsCount?: number | undefined;
+    }, {
+        title?: string | undefined;
+        coverUrl?: string | undefined;
+        itemsCount?: number | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    username?: string | undefined;
+    fullName?: string | undefined;
+    biography?: string | undefined;
+    followersCount?: number | undefined;
+    followingCount?: number | undefined;
+    followsCount?: number | undefined;
+    postsCount?: number | undefined;
+    verified?: boolean | undefined;
+    isVerified?: boolean | undefined;
+    isPrivate?: boolean | undefined;
+    profilePicUrl?: string | undefined;
+    profilePicture?: string | undefined;
+    externalUrl?: string | undefined;
+    latestPosts?: {
+        url: string;
+        type?: "image" | "video" | "carousel" | null | undefined;
+        shortCode?: string | undefined;
+        caption?: string | undefined;
+        likesCount?: number | undefined;
+        commentsCount?: number | undefined;
+        ownerUsername?: string | undefined;
+        ownerFullName?: string | undefined;
+        timestamp?: string | undefined;
+        displayUrl?: string | undefined;
+        hashtags?: string[] | undefined;
+        mentions?: string[] | undefined;
+        location?: {
+            name?: string | undefined;
+            id?: string | undefined;
+        } | null | undefined;
+    }[] | undefined;
+    stories?: {
+        type?: "image" | "video" | undefined;
+        url?: string | undefined;
+        timestamp?: string | undefined;
+        viewsCount?: number | undefined;
+    }[] | undefined;
+    highlights?: {
+        title?: string | undefined;
+        coverUrl?: string | undefined;
+        itemsCount?: number | undefined;
+    }[] | undefined;
+}, {
+    username?: string | undefined;
+    fullName?: string | undefined;
+    biography?: string | undefined;
+    followersCount?: number | undefined;
+    followingCount?: number | undefined;
+    followsCount?: number | undefined;
+    postsCount?: number | undefined;
+    verified?: boolean | undefined;
+    isVerified?: boolean | undefined;
+    isPrivate?: boolean | undefined;
+    profilePicUrl?: string | undefined;
+    profilePicture?: string | undefined;
+    externalUrl?: string | undefined;
+    latestPosts?: {
+        url: string;
+        type?: "image" | "video" | "carousel" | null | undefined;
+        shortCode?: string | undefined;
+        caption?: string | undefined;
+        likesCount?: number | undefined;
+        commentsCount?: number | undefined;
+        ownerUsername?: string | undefined;
+        ownerFullName?: string | undefined;
+        timestamp?: string | undefined;
+        displayUrl?: string | undefined;
+        hashtags?: string[] | undefined;
+        mentions?: string[] | undefined;
+        location?: {
+            name?: string | undefined;
+            id?: string | undefined;
+        } | null | undefined;
+    }[] | undefined;
+    stories?: {
+        type?: "image" | "video" | undefined;
+        url?: string | undefined;
+        timestamp?: string | undefined;
+        viewsCount?: number | undefined;
+    }[] | undefined;
+    highlights?: {
+        title?: string | undefined;
+        coverUrl?: string | undefined;
+        itemsCount?: number | undefined;
+    }[] | undefined;
+}>;
+/**
+ * Get all available actors
+ */
+export declare function getAvailableActors(): ActorId[];
+/**
+ * Get actors by category
+ */
+export declare function getActorsByCategory(category: string): "apify/instagram-scraper"[];
+/**
+ * Validate actor input against its schema
+ */
+export declare function validateActorInput<T extends ActorId>(actorId: T, input: unknown): ActorInput<T>;
+/**
+ * Validate actor output against its schema
+ */
+export declare function validateActorOutput<T extends ActorId>(actorId: T, output: unknown): ActorOutput<T>;
+/**
+ * Check if an actor ID is supported
+ */
+export declare function isActorSupported(actorId: string): actorId is ActorId;
+//# sourceMappingURL=api-scraper.schema.d.ts.map

package/dist/types/api-scraper.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-scraper.schema.d.ts","sourceRoot":"","sources":["../../src/types/api-scraper.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmHxB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAStB,CAAC;AAMX,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,mBAAmB,CAAC;AACvD,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;AAC5F,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,OAAO,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC/F,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,OAAO,IAAI,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAO3E;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,CAAC;;;;;;;;;;;;;;;;;;GAEhE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAEjE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IACW,OAAO,EAAE,CACrD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,+BAInD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,OAAO,EAClD,OAAO,EAAE,CAAC,EACV,KAAK,EAAE,OAAO,GACb,UAAU,CAAC,CAAC,CAAC,CAGf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,OAAO,EACnD,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,OAAO,GACd,WAAW,CAAC,CAAC,CAAC,CAGhB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,OAAO,CAEpE"}

package/dist/types/api-scraper.schema.js

@@ -0,0 +1,160 @@
+import { z } from 'zod';
+/**
+ * Apify Actor Schema Registry
+ *
+ * This registry provides type-safe input and output schemas for popular Apify actors.
+ * Each actor definition includes:
+ * - Input schema: Validates parameters sent to the actor
+ * - Output schema: Validates and types the results returned by the actor
+ * - Description: Human-readable description of what the actor does
+ * - Documentation: Link to actor documentation
+ */
+// ============================================================================
+// INSTAGRAM SCRAPER SCHEMAS
+// ============================================================================
+const InstagramScraperInputSchema = z.object({
+    directUrls: z
+        .array(z.string().url())
+        .min(1, 'At least one Instagram URL is required')
+        .describe('Instagram profile URLs to scrape. Examples: ["https://www.instagram.com/username/"]'),
+    resultsType: z
+        .enum(['posts', 'details'])
+        .default('posts')
+        .describe('Type of results to fetch: "posts" for posts only, "details" for profile + posts'),
+    resultsLimit: z
+        .number()
+        .min(1)
+        .max(200)
+        .default(20)
+        .describe('Maximum number of posts to fetch per profile (1-200)'),
+    includeStories: z
+        .boolean()
+        .default(false)
+        .optional()
+        .describe('Whether to include Instagram stories in results'),
+    includeHighlights: z
+        .boolean()
+        .default(false)
+        .optional()
+        .describe('Whether to include Instagram highlights in results'),
+});
+const InstagramPostSchema = z.object({
+    url: z.string().url().describe('Post URL'),
+    shortCode: z.string().optional().describe('Instagram short code'),
+    caption: z.string().optional().describe('Post caption text'),
+    likesCount: z.number().optional().describe('Number of likes'),
+    commentsCount: z.number().optional().describe('Number of comments'),
+    ownerUsername: z.string().optional().describe('Post owner username'),
+    ownerFullName: z.string().optional().describe('Post owner full name'),
+    timestamp: z.string().optional().describe('Post timestamp (ISO format)'),
+    type: z
+        .enum(['image', 'video', 'carousel'])
+        .nullable()
+        .optional()
+        .describe('Post media type'),
+    displayUrl: z.string().optional().describe('Main display image URL'),
+    hashtags: z.array(z.string()).optional().describe('Hashtags in the post'),
+    mentions: z.array(z.string()).optional().describe('User mentions in the post'),
+    location: z
+        .object({
+        name: z.string().optional(),
+        id: z.string().optional(),
+    })
+        .nullable()
+        .optional()
+        .describe('Location information if available'),
+});
+// Single profile/item output schema (each item in the array)
+const InstagramScraperItemSchema = z.object({
+    // When resultsType is 'details', profile fields are at the top level
+    username: z.string().optional().describe('Instagram username'),
+    fullName: z.string().optional().describe('Full name'),
+    biography: z.string().optional().describe('Profile bio'),
+    followersCount: z.number().optional().describe('Number of followers'),
+    followingCount: z.number().optional().describe('Number of following'),
+    followsCount: z.number().optional().describe('Number of following (alt field)'),
+    postsCount: z.number().optional().describe('Total posts'),
+    verified: z.boolean().optional().describe('Verification status'),
+    isVerified: z.boolean().optional().describe('Verification status (alt field)'),
+    isPrivate: z.boolean().optional().describe('Whether profile is private'),
+    profilePicUrl: z.string().optional().describe('Profile picture URL'),
+    profilePicture: z.string().optional().describe('Profile picture URL (alt field)'),
+    externalUrl: z.string().optional().describe('External website URL'),
+    // Posts (nested when resultsType is 'details')
+    latestPosts: z.array(InstagramPostSchema).optional().describe('Latest posts from the profile'),
+    // Stories (when includeStories is true)
+    stories: z.array(z.object({
+        url: z.string().optional(),
+        timestamp: z.string().optional(),
+        type: z.enum(['image', 'video']).optional(),
+        viewsCount: z.number().optional(),
+    })).optional().describe('Instagram stories'),
+    // Highlights (when includeHighlights is true)
+    highlights: z.array(z.object({
+        title: z.string().optional(),
+        coverUrl: z.string().optional(),
+        itemsCount: z.number().optional(),
+    })).optional().describe('Instagram highlights'),
+});
+// ============================================================================
+// ACTOR REGISTRY
+// ============================================================================
+export const APIFY_ACTOR_SCHEMAS = {
+    'apify/instagram-scraper': {
+        input: InstagramScraperInputSchema,
+        output: InstagramScraperItemSchema,
+        description: 'Scrape Instagram profiles, posts, stories, and highlights',
+        documentation: 'https://docs.apify.com/platform/actors/apify/instagram-scraper',
+        category: 'social-media',
+    },
+};
+// ============================================================================
+// UTILITY FUNCTIONS
+// ============================================================================
+/**
+ * Get the input schema for a specific actor
+ */
+export function getActorInputSchema(actorId) {
+    return APIFY_ACTOR_SCHEMAS[actorId].input;
+}
+/**
+ * Get the output schema for a specific actor
+ */
+export function getActorOutputSchema(actorId) {
+    return APIFY_ACTOR_SCHEMAS[actorId].output;
+}
+/**
+ * Get all available actors
+ */
+export function getAvailableActors() {
+    return Object.keys(APIFY_ACTOR_SCHEMAS);
+}
+/**
+ * Get actors by category
+ */
+export function getActorsByCategory(category) {
+    return Object.entries(APIFY_ACTOR_SCHEMAS)
+        .filter(([_, schema]) => schema.category === category)
+        .map(([actorId]) => actorId);
+}
+/**
+ * Validate actor input against its schema
+ */
+export function validateActorInput(actorId, input) {
+    const schema = getActorInputSchema(actorId);
+    return schema.parse(input);
+}
+/**
+ * Validate actor output against its schema
+ */
+export function validateActorOutput(actorId, output) {
+    const schema = getActorOutputSchema(actorId);
+    return schema.parse(output);
+}
+/**
+ * Check if an actor ID is supported
+ */
+export function isActorSupported(actorId) {
+    return actorId in APIFY_ACTOR_SCHEMAS;
+}
+//# sourceMappingURL=api-scraper.schema.js.map

package/dist/types/api-scraper.schema.js.map

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

package/dist/types/available-tools.d.ts

@@ -1,4 +1,4 @@
 import { z } from 'zod';
-export declare const AvailableTools: z.ZodEnum<["web-search-tool", "web-scrape-tool", "web-crawl-tool", "web-extract-tool", "research-agent-tool", "reddit-scrape-tool", "list-bubbles-tool", "get-bubble-details-tool", "bubbleflow-validation-tool", "chart-js-tool", "sql-query-tool"]>;
+export declare const AvailableTools: z.ZodEnum<["web-search-tool", "web-scrape-tool", "web-crawl-tool", "web-extract-tool", "research-agent-tool", "reddit-scrape-tool", "instagram-tool", "list-bubbles-tool", "get-bubble-details-tool", "bubbleflow-validation-tool", "chart-js-tool", "sql-query-tool"]>;
 export type AvailableTool = z.infer<typeof AvailableTools>;
 //# sourceMappingURL=available-tools.d.ts.map

package/dist/types/available-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"available-tools.d.ts","sourceRoot":"","sources":["../../src/types/available-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,cAAc,uPAcgB,CAAC;AAE5C,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}
+{"version":3,"file":"available-tools.d.ts","sourceRoot":"","sources":["../../src/types/available-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,cAAc,yQAgBgB,CAAC;AAE5C,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/types/available-tools.js

@@ -9,6 +9,8 @@ export const AvailableTools = z.enum([
     'web-extract-tool',
     'research-agent-tool',
     'reddit-scrape-tool',
+    // Social media tools
+    'instagram-tool',
     // Existing bubble tools (for reference - these are handled by bubble names)
     'list-bubbles-tool',
     'get-bubble-details-tool',

package/dist/types/available-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"available-tools.js","sourceRoot":"","sources":["../../src/types/available-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,4DAA4D;AAC5D,oEAAoE;AACpE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC;IACnC,YAAY;IACZ,iBAAiB;IACjB,iBAAiB;IACjB,gBAAgB;IAChB,kBAAkB;IAClB,qBAAqB;IACrB,oBAAoB;IACpB,4EAA4E;IAC5E,mBAAmB;IACnB,yBAAyB;IACzB,4BAA4B;IAC5B,eAAe;IACf,gBAAgB;CACwB,CAAC,CAAC"}
+{"version":3,"file":"available-tools.js","sourceRoot":"","sources":["../../src/types/available-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,4DAA4D;AAC5D,oEAAoE;AACpE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC;IACnC,YAAY;IACZ,iBAAiB;IACjB,iBAAiB;IACjB,gBAAgB;IAChB,kBAAkB;IAClB,qBAAqB;IACrB,oBAAoB;IACpB,qBAAqB;IACrB,gBAAgB;IAChB,4EAA4E;IAC5E,mBAAmB;IACnB,yBAAyB;IACzB,4BAA4B;IAC5B,eAAe;IACf,gBAAgB;CACwB,CAAC,CAAC"}

package/dist/types/base-bubble-class.d.ts

@@ -25,6 +25,11 @@ export declare abstract class BaseBubble<TParams = unknown, TResult extends Bubb
     private computeChildContext;
     saveResult<R extends BubbleOperationResult>(result: BubbleResult<R>): void;
     clearSavedResult(): void;
+    /**
+     * Override toJSON to prevent credential leaking via JSON.stringify or console.log
+     * Only exposes safe metadata, never params which may contain credentials
+     */
+    toJSON(): Record<string, unknown>;
     /**
      * Execute the bubble - just runs the action
      */