@wix/headless-instagram 0.0.1

package/dist/react/InstagramMedia.js

@@ -0,0 +1,71 @@
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import React from 'react';
+import { AsChildSlot } from '@wix/headless-utils/react';
+import * as CoreInstagramMedia from './core/InstagramMedia.js';
+import { WixServices } from '@wix/services-manager-react';
+import { createServicesMap } from '@wix/services-manager';
+import { InstagramMediaItemServiceDefinition, InstagramMediaItemService, } from '../services/index.js';
+import * as CoreInstagramMedias from './core/InstagramMedias.js';
+import { MediaGallery } from '@wix/headless-media/react';
+/**
+ * Repeats children for each Instagram media item, providing a per-item service context.
+ */
+export const MediaGalleryRepeater = ({ children, }) => {
+    return (_jsx(CoreInstagramMedias.InstagramMedias, { children: ({ hasItems, mediaItems }) => {
+            console.log('mediaItems', mediaItems);
+            if (!hasItems)
+                return null;
+            return (_jsx(_Fragment, { children: mediaItems.map((mediaItem, index) => {
+                    console.log('mediaItem', mediaItem.mediaGalleryItems);
+                    return (_jsx(WixServices, { servicesMap: createServicesMap().addService(InstagramMediaItemServiceDefinition, InstagramMediaItemService, { mediaItem, index }), children: _jsx(MediaGallery.Root, { mediaGalleryServiceConfig: {
+                                media: mediaItem.mediaGalleryItems,
+                            }, children: children }) }, mediaItem.id || index));
+                }) }));
+        } }));
+};
+export var TestIds;
+(function (TestIds) {
+    TestIds["instagramMediaCaption"] = "instagram-media-caption";
+    TestIds["instagramMediaType"] = "instagram-media-type";
+    TestIds["instagramMediaUserName"] = "instagram-media-username";
+    TestIds["instagramMediaTimestamp"] = "instagram-media-timestamp";
+    TestIds["instagramMediaGalleries"] = "instagram-media-galleries";
+})(TestIds || (TestIds = {}));
+export const Caption = React.forwardRef((props, ref) => {
+    const { asChild, children, className, ...otherProps } = props;
+    return (_jsx(CoreInstagramMedia.Caption, { children: ({ caption }) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.instagramMediaCaption, customElement: children, customElementProps: { caption }, content: caption ?? '', ...otherProps, children: _jsx("span", { children: caption }) })) }));
+});
+export const MediaType = React.forwardRef((props, ref) => {
+    const { asChild, children, className, ...otherProps } = props;
+    return (_jsx(CoreInstagramMedia.MediaType, { children: ({ mediaType }) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.instagramMediaType, customElement: children, customElementProps: { mediaType }, content: mediaType, ...otherProps, children: _jsx("span", { children: mediaType }) })) }));
+});
+export const UserName = React.forwardRef((props, ref) => {
+    const { asChild, children, className, ...otherProps } = props;
+    return (_jsx(CoreInstagramMedia.UserName, { children: ({ userName }) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.instagramMediaUserName, customElement: children, customElementProps: { userName }, content: userName ?? '', ...otherProps, children: _jsx("span", { children: userName }) })) }));
+});
+export const Timestamp = React.forwardRef((props, ref) => {
+    const { asChild, children, className, ...otherProps } = props;
+    return (_jsx(CoreInstagramMedia.Timestamp, { children: ({ timestamp }) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, "data-testid": TestIds.instagramMediaTimestamp, customElement: children, customElementProps: { timestamp }, content: timestamp, ...otherProps, children: _jsx("time", { dateTime: timestamp, children: timestamp }) })) }));
+});
+export const MediaGalleries = React.forwardRef((props, ref) => {
+    const { children, className, ...otherProps } = props;
+    return (_jsx("div", { ref: ref, className: className, "data-testid": TestIds.instagramMediaGalleries, ...otherProps, children: children }));
+});
+export const MediaGalleryItems = React.forwardRef(({ children, className, ...otherProps }, ref) => {
+    return (_jsx("div", { ref: ref, className: className, ...otherProps, children: children }));
+});
+export const InstagramMedia = {
+    Root: ({ children }) => _jsx(_Fragment, { children: children }),
+    Caption,
+    MediaType,
+    UserName,
+    Timestamp,
+    MediaGalleries,
+    MediaGalleryItems,
+    MediaGalleryRepeater,
+    // lowercase aliases (new interface)
+    caption: Caption,
+    mediaType: MediaType,
+    userName: UserName,
+    timestamp: Timestamp,
+};

package/dist/react/InstagramMedias.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+export interface InstagramMediasProps {
+    children: React.ReactNode;
+    emptyState?: React.ReactNode;
+}
+/**
+ * Container for Instagram media items list.
+ * Renders nothing (or emptyState) when there are no media items.
+ */
+export declare const InstagramMedias: React.ForwardRefExoticComponent<InstagramMediasProps & React.RefAttributes<HTMLDivElement>>;

package/dist/react/InstagramMedias.js

@@ -0,0 +1,16 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from 'react';
+import * as CoreInstagramMedias from './core/InstagramMedias.js';
+/**
+ * Container for Instagram media items list.
+ * Renders nothing (or emptyState) when there are no media items.
+ */
+export const InstagramMedias = React.forwardRef((props, ref) => {
+    const { children, emptyState } = props;
+    return (_jsx(CoreInstagramMedias.InstagramMedias, { children: ({ hasItems }) => {
+            if (!hasItems) {
+                return emptyState || null;
+            }
+            return _jsx("div", { ref: ref, children: children });
+        } }));
+});

package/dist/react/UserName.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import { type AsChildChildren } from '@wix/headless-utils/react';
+export interface UserNameProps {
+    asChild?: boolean;
+    children?: AsChildChildren<{
+        displayName: string;
+    }>;
+    className?: string;
+    unknownLabel?: string;
+}
+export declare const UserName: React.ForwardRefExoticComponent<UserNameProps & React.RefAttributes<HTMLElement>>;

package/dist/react/UserName.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from 'react';
+import { AsChildSlot } from '@wix/headless-utils/react';
+import * as CoreUserName from './core/UserName.js';
+export const UserName = React.forwardRef((props, ref) => {
+    const { asChild, children, className, ...otherProps } = props;
+    return (_jsx(CoreUserName.UserName, { unknownLabel: props.unknownLabel, children: ({ displayName, displayValue }) => (_jsx(AsChildSlot, { ref: ref, asChild: asChild, className: className, customElement: children, customElementProps: { displayName }, content: displayValue, ...otherProps, children: _jsx("span", { children: displayValue }) })) }));
+});

package/dist/react/core/InstagramMedia.d.ts

@@ -0,0 +1,82 @@
+import React from 'react';
+export interface MediaItem {
+    image: string;
+    altText?: string;
+}
+export interface CaptionProps {
+    /** Render prop function that receives caption data */
+    children: (props: CaptionRenderProps) => React.ReactNode;
+}
+/**
+ * Render props for Caption component
+ */
+export interface CaptionRenderProps {
+    /** Media caption text */
+    caption?: string;
+}
+/**
+ * Headless component for Instagram media caption
+ */
+export declare function Caption(props: CaptionProps): React.ReactNode;
+export interface MediaTypeProps {
+    /** Render prop function that receives media type data */
+    children: (props: MediaTypeRenderProps) => React.ReactNode;
+}
+/**
+ * Render props for MediaType component
+ */
+export interface MediaTypeRenderProps {
+    /** Type of media */
+    mediaType: 'image' | 'video' | 'carousel';
+}
+/**
+ * Headless component for Instagram media type
+ */
+export declare function MediaType(props: MediaTypeProps): React.ReactNode;
+export interface UserNameProps {
+    /** Render prop function that receives username data */
+    children: (props: UserNameRenderProps) => React.ReactNode;
+}
+/**
+ * Render props for UserName component
+ */
+export interface UserNameRenderProps {
+    /** Instagram username */
+    userName?: string;
+}
+/**
+ * Headless component for Instagram media username
+ */
+export declare function UserName(props: UserNameProps): React.ReactNode;
+export interface TimestampProps {
+    /** Render prop function that receives timestamp data */
+    children: (props: TimestampRenderProps) => React.ReactNode;
+}
+/**
+ * Render props for Timestamp component
+ */
+export interface TimestampRenderProps {
+    /** Media timestamp */
+    timestamp: string;
+}
+/**
+ * Headless component for Instagram media timestamp
+ */
+export declare function Timestamp(props: TimestampProps): React.ReactNode;
+export interface MediaGalleryRepeaterProps {
+    /** Render prop function that receives media gallery repeater data */
+    children: (props: MediaGalleryRepeaterRenderProps) => React.ReactNode;
+}
+/**
+ * Render props for MediaGalleryRepeater component
+ */
+export interface MediaGalleryRepeaterRenderProps {
+    /** Array of media items formatted for MediaGallery */
+    media: MediaItem[];
+    /** Whether there are media items */
+    hasMedia: boolean;
+}
+/**
+ * Headless component for Instagram media gallery repeater
+ */
+export declare function MediaGalleryRepeater(props: MediaGalleryRepeaterProps): React.ReactNode;

package/dist/react/core/InstagramMedia.js

@@ -0,0 +1,65 @@
+import { useService } from '@wix/services-manager-react';
+import { InstagramMediaItemServiceDefinition, InstagramFeedServiceDefinition, } from '../../services/index.js';
+/**
+ * Headless component for Instagram media caption
+ */
+export function Caption(props) {
+    const mediaItemService = useService(InstagramMediaItemServiceDefinition);
+    const { caption } = mediaItemService.mediaItem.get();
+    return props.children({
+        caption,
+    });
+}
+/**
+ * Headless component for Instagram media type
+ */
+export function MediaType(props) {
+    const mediaItemService = useService(InstagramMediaItemServiceDefinition);
+    const { type } = mediaItemService.mediaItem.get();
+    return props.children({
+        mediaType: type,
+    });
+}
+/**
+ * Headless component for Instagram media username
+ */
+export function UserName(props) {
+    const feedService = useService(InstagramFeedServiceDefinition);
+    const account = feedService.feedData.get().account;
+    const userName = account?.instagramInfo?.instagramUsername;
+    return props.children({
+        userName,
+    });
+}
+/**
+ * Headless component for Instagram media timestamp
+ */
+export function Timestamp(props) {
+    const mediaItemService = useService(InstagramMediaItemServiceDefinition);
+    const { timestamp } = mediaItemService.mediaItem.get();
+    return props.children({
+        timestamp,
+    });
+}
+/**
+ * Headless component for Instagram media gallery repeater
+ */
+export function MediaGalleryRepeater(props) {
+    const mediaItemService = useService(InstagramMediaItemServiceDefinition);
+    const mediaItem = mediaItemService.mediaItem.get();
+    const media = (mediaItem?.type === 'video' ? mediaItem.thumbnailUrl : mediaItem?.mediaUrl)
+        ? [
+            {
+                image: (mediaItem.type === 'video'
+                    ? mediaItem.thumbnailUrl
+                    : mediaItem.mediaUrl),
+                altText: mediaItem.altText,
+            },
+        ]
+        : [];
+    const hasMedia = media.length > 0;
+    return props.children({
+        media,
+        hasMedia,
+    });
+}

package/dist/react/core/InstagramMedias.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+export interface InstagramMediasProps {
+    /** Render prop function that receives Instagram medias data */
+    children: (props: InstagramMediasRenderProps) => React.ReactNode;
+}
+/**
+ * Render props for InstagramMedias component
+ */
+export interface InstagramMediasRenderProps {
+    /** Whether there are media items to display */
+    hasItems: boolean;
+    /** Array of media items */
+    mediaItems: any[];
+}
+/**
+ * Headless component for Instagram medias
+ * Handles service logic and provides render props with media items data
+ */
+export declare function InstagramMedias(props: InstagramMediasProps): React.ReactNode;

package/dist/react/core/InstagramMedias.js

@@ -0,0 +1,54 @@
+import { useService } from '@wix/services-manager-react';
+import { InstagramFeedServiceDefinition } from '../../services/index.js';
+/**
+ * Headless component for Instagram medias
+ * Handles service logic and provides render props with media items data
+ */
+export function InstagramMedias(props) {
+    const instagramFeedService = useService(InstagramFeedServiceDefinition);
+    const feedData = instagramFeedService.feedData.get();
+    const hasItems = feedData.mediaItems.length > 0;
+    // Convert Instagram media items to MediaGallery format
+    const convertedMediaItems = feedData.mediaItems.map((mediaItem) => {
+        let mediaGalleryItems = [];
+        if (mediaItem.type === 'carousel' &&
+            mediaItem.children &&
+            mediaItem.children.length > 0) {
+            // Convert all carousel children to MediaGallery format
+            mediaGalleryItems = mediaItem.children.map((carouselItem, carouselIndex) => {
+                const imageUrl = carouselItem.type === 'video'
+                    ? carouselItem.thumbnailUrl || carouselItem.mediaUrl
+                    : carouselItem.mediaUrl;
+                return {
+                    image: imageUrl,
+                    altText: carouselItem.altText ||
+                        mediaItem.caption ||
+                        `Instagram carousel item ${carouselIndex + 1}`,
+                };
+            });
+        }
+        else {
+            // Convert single Instagram media item to MediaGallery format
+            const imageUrl = mediaItem.type === 'video'
+                ? mediaItem.thumbnailUrl || mediaItem.mediaUrl
+                : mediaItem.mediaUrl;
+            mediaGalleryItems = [
+                {
+                    image: imageUrl,
+                    altText: mediaItem.altText ||
+                        mediaItem.caption ||
+                        `Instagram ${mediaItem.type}`,
+                },
+            ];
+        }
+        return {
+            // Keep original Instagram data
+            ...mediaItem,
+            mediaGalleryItems, // Add converted MediaGallery data
+        };
+    });
+    return props.children({
+        hasItems,
+        mediaItems: convertedMediaItems,
+    });
+}

package/dist/react/core/Root.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import { type InstagramFeedServiceConfig } from '../../services/index.js';
+export interface RootProps {
+    instagramFeedServiceConfig: InstagramFeedServiceConfig;
+    children: React.ReactNode;
+}
+export declare function Root(props: RootProps): React.ReactNode;

package/dist/react/core/Root.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createServicesMap } from '@wix/services-manager';
+import { WixServices } from '@wix/services-manager-react';
+import { InstagramFeedService, InstagramFeedServiceDefinition, } from '../../services/index.js';
+export function Root(props) {
+    const { children, instagramFeedServiceConfig } = props;
+    return (_jsx(WixServices, { servicesMap: createServicesMap().addService(InstagramFeedServiceDefinition, InstagramFeedService, instagramFeedServiceConfig), children: children }));
+}

package/dist/react/core/UserName.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+export interface UserNameProps {
+    /** Render prop function that receives username data */
+    children: (props: UserNameRenderProps) => React.ReactNode;
+    /** Fallback label when username is unavailable */
+    unknownLabel?: string;
+}
+/**
+ * Render props for UserName component
+ */
+export interface UserNameRenderProps {
+    /** Display name (Instagram username) */
+    displayName: string;
+    /** Formatted display value with @ prefix */
+    displayValue: string;
+}
+/**
+ * Headless component for Instagram account username
+ * Handles service logic and provides render props with username data
+ */
+export declare function UserName(props: UserNameProps): React.ReactNode;

package/dist/react/core/UserName.js

@@ -0,0 +1,17 @@
+import { useService } from '@wix/services-manager-react';
+import { InstagramFeedServiceDefinition } from '../../services/index.js';
+/**
+ * Headless component for Instagram account username
+ * Handles service logic and provides render props with username data
+ */
+export function UserName(props) {
+    const { unknownLabel = 'unknown' } = props;
+    const instagramFeedService = useService(InstagramFeedServiceDefinition);
+    const feedData = instagramFeedService.feedData.get();
+    const displayName = feedData.account?.instagramInfo?.instagramUsername || unknownLabel;
+    const displayValue = `@${displayName}`;
+    return props.children({
+        displayName,
+        displayValue,
+    });
+}

package/dist/react/core/index.d.ts

@@ -0,0 +1,4 @@
+export { Root, type RootProps } from './Root.js';
+export { UserName as CoreUserName, type UserNameProps as CoreUserNameProps, type UserNameRenderProps, } from './UserName.js';
+export { InstagramMedias, type InstagramMediasProps, type InstagramMediasRenderProps, } from './InstagramMedias.js';
+export { Caption as InstagramMediaCaption, MediaType as InstagramMediaType, UserName as InstagramMediaUserName, Timestamp as InstagramMediaTimestamp, MediaGalleryRepeater, type CaptionProps as InstagramMediaCaptionProps, type CaptionRenderProps, type MediaTypeProps as InstagramMediaTypeProps, type MediaTypeRenderProps, type UserNameProps as InstagramMediaUserNameProps, type UserNameRenderProps as InstagramMediaUserNameRenderProps, type TimestampProps as InstagramMediaTimestampProps, type TimestampRenderProps, type MediaGalleryRepeaterProps, type MediaGalleryRepeaterRenderProps, } from './InstagramMedia.js';

package/dist/react/core/index.js

@@ -0,0 +1,5 @@
+export { Root } from './Root.js';
+// New core components
+export { UserName as CoreUserName, } from './UserName.js';
+export { InstagramMedias, } from './InstagramMedias.js';
+export { Caption as InstagramMediaCaption, MediaType as InstagramMediaType, UserName as InstagramMediaUserName, Timestamp as InstagramMediaTimestamp, MediaGalleryRepeater, } from './InstagramMedia.js';

package/dist/react/index.d.ts

@@ -0,0 +1,2 @@
+export * as InstagramFeed from './InstagramFeed.js';
+export { InstagramMedia } from './InstagramMedia.js';

package/dist/react/index.js

@@ -0,0 +1,2 @@
+export * as InstagramFeed from './InstagramFeed.js';
+export { InstagramMedia } from './InstagramMedia.js';

package/dist/services/index.d.ts

@@ -0,0 +1,2 @@
+export { InstagramFeedService, InstagramFeedServiceDefinition, loadInstagramFeedServiceConfig, type InstagramFeedServiceConfig, type InstagramFeedServiceAPI, type InstagramFeedServiceConfigResult, type SuccessInstagramFeedServiceConfigResult, type NotFoundInstagramFeedServiceConfigResult, type InstagramFeedData, type InstagramMediaItem, type InstagramMediaType, type InstagramAccount, type InstagramMedia, } from './instagram-feed-service.js';
+export { InstagramMediaItemService, InstagramMediaItemServiceDefinition, type InstagramMediaItemServiceConfig, type InstagramMediaItemServiceAPI, } from './instagram-media-item-service.js';

package/dist/services/index.js

@@ -0,0 +1,2 @@
+export { InstagramFeedService, InstagramFeedServiceDefinition, loadInstagramFeedServiceConfig, } from './instagram-feed-service.js';
+export { InstagramMediaItemService, InstagramMediaItemServiceDefinition, } from './instagram-media-item-service.js';

package/dist/services/instagram-feed-service.d.ts

@@ -0,0 +1,178 @@
+import { type Signal } from '@wix/services-definitions/core-services/signals';
+import { accounts } from '@wix/instagram-account';
+import { media } from '@wix/instagram-media';
+/**
+ * Instagram media item types
+ */
+export type InstagramMediaType = 'image' | 'video' | 'carousel';
+/**
+ * Instagram media item structure
+ * Extending SDK types with additional fields for UI components
+ */
+export interface InstagramMediaItem {
+    /** Unique identifier for the media item */
+    id: string;
+    /** Type of the media */
+    type: InstagramMediaType;
+    /** URL to the media content */
+    mediaUrl: string;
+    /** Thumbnail URL for videos */
+    thumbnailUrl?: string;
+    /** Caption text */
+    caption?: string;
+    /** Permalink to the Instagram post */
+    permalink: string;
+    /** ISO timestamp of when the media was created */
+    timestamp: string;
+    /** Alt text for accessibility */
+    altText?: string;
+}
+/**
+ * Instagram account information using SDK types
+ */
+export type InstagramAccount = accounts.InstagramAccount;
+/**
+ * Instagram media using SDK types
+ */
+export type InstagramMedia = media.Media;
+/**
+ * Instagram feed data combining account and media information
+ */
+export interface InstagramFeedData {
+    /** Instagram account information */
+    account?: InstagramAccount;
+    /** Array of media items */
+    mediaItems: InstagramMediaItem[];
+    /** Whether there are more items to load */
+    hasMore: boolean;
+    /** Cursor for pagination */
+    nextCursor?: string;
+}
+/**
+ * Configuration interface for the Instagram Feed service.
+ * Contains the initial feed data and connection settings.
+ */
+export interface InstagramFeedServiceConfig {
+    /** Instagram account ID or username */
+    accountId?: string;
+    /** Number of media items to fetch */
+    limit?: number;
+    /** Initial feed data (for SSR or caching) */
+    feedData?: InstagramFeedData;
+}
+/**
+ * API interface for the Instagram Feed service, providing reactive feed data management.
+ * This service handles loading and managing Instagram feed data, loading state, and errors.
+ */
+export interface InstagramFeedServiceAPI {
+    /** Reactive signal containing the current feed data */
+    feedData: Signal<InstagramFeedData>;
+    /** Reactive signal indicating if feed data is currently being loaded */
+    isLoading: Signal<boolean>;
+    /** Reactive signal containing any error message, or null if no error */
+    error: Signal<string | null>;
+    /** Function to load more media items */
+    loadMore: () => Promise<void>;
+    /** Function to refresh the entire feed */
+    refresh: () => Promise<void>;
+}
+/**
+ * Service definition for the Instagram Feed service.
+ * This defines the reactive API contract for managing Instagram feed data.
+ */
+export declare const InstagramFeedServiceDefinition: string & {
+    __api: InstagramFeedServiceAPI;
+    __config: InstagramFeedServiceConfig;
+    isServiceDefinition?: boolean;
+} & InstagramFeedServiceAPI;
+/**
+ * Implementation of the Instagram Feed service that manages reactive Instagram feed data.
+ * This service provides signals for feed data, loading state, and error handling,
+ * along with methods to dynamically load and refresh Instagram content.
+ *
+ * @example
+ * ```tsx
+ * import { InstagramFeedService, InstagramFeedServiceDefinition } from '@wix/instagram/services';
+ * import { useService } from '@wix/services-manager-react';
+ *
+ * function InstagramComponent({ feedConfig }) {
+ *   return (
+ *     <ServiceProvider services={createServicesMap([
+ *       [InstagramFeedServiceDefinition, InstagramFeedService.withConfig(feedConfig)]
+ *     ])}>
+ *       <InstagramDisplay />
+ *     </ServiceProvider>
+ *   );
+ * }
+ *
+ * function InstagramDisplay() {
+ *   const feedService = useService(InstagramFeedServiceDefinition);
+ *   const feedData = feedService.feedData.get();
+ *   const isLoading = feedService.isLoading.get();
+ *   const error = feedService.error.get();
+ *
+ *   if (isLoading) return <div>Loading Instagram feed...</div>;
+ *   if (error) return <div>Error: {error}</div>;
+ *
+ *   return <div>{feedData.mediaItems.length} posts loaded</div>;
+ * }
+ * ```
+ */
+export declare const InstagramFeedService: import("@wix/services-definitions").ServiceFactory<string & {
+    __api: InstagramFeedServiceAPI;
+    __config: InstagramFeedServiceConfig;
+    isServiceDefinition?: boolean;
+} & InstagramFeedServiceAPI, InstagramFeedServiceConfig>;
+/**
+ * Success result interface for Instagram feed service configuration loading.
+ * Returned when feed data is successfully loaded.
+ */
+export interface SuccessInstagramFeedServiceConfigResult {
+    /** Type "success" means that the feed was loaded and the config is valid */
+    type: 'success';
+    /** The feed config containing the loaded feed data */
+    config: InstagramFeedServiceConfig;
+}
+/**
+ * Not found result interface for Instagram feed service configuration loading.
+ * Returned when account or feed data cannot be found.
+ */
+export interface NotFoundInstagramFeedServiceConfigResult {
+    /** Type "notFound" means that the account was not found */
+    type: 'notFound';
+}
+/**
+ * Union type for Instagram feed service configuration results.
+ */
+export type InstagramFeedServiceConfigResult = SuccessInstagramFeedServiceConfigResult | NotFoundInstagramFeedServiceConfigResult;
+/**
+ * Input object for loading Instagram feed service configuration
+ */
+/**
+ * Loads Instagram feed service configuration from the Wix Instagram API for SSR initialization.
+ * This function is designed to be used during Server-Side Rendering (SSR) to preload
+ * Instagram feed data that will be used to configure the InstagramFeedService.
+ *
+ * @param input InstagramFeedServiceConfig object containing accountId and optional limit
+ * @returns Promise that resolves to InstagramFeedServiceConfigResult (success with config or notFound)
+ *
+ * @example
+ * ```tsx
+ * import { loadInstagramFeedServiceConfig } from '@wix/instagram/services';
+ *
+ * // In your SSR handler or server action
+ * const configResult = await loadInstagramFeedServiceConfig({
+ *   accountId: 'instagram_account_123',
+ *   limit: 12
+ * });
+ *
+ * if (configResult.type === 'success') {
+ *   // Use configResult.config to initialize InstagramFeedService
+ *   return configResult.config;
+ * } else {
+ *   // Handle not found case
+ *   return { accountId: 'instagram_account_123' }; // fallback config
+ * }
+ * ```
+ */
+export declare function loadInstagramFeedServiceConfig(input: InstagramFeedServiceConfig): Promise<InstagramFeedServiceConfigResult>;