@pakoor/n8n-nodes-instagram 0.1.0

package/dist/services/InstagramApiClient.d.ts

@@ -0,0 +1,261 @@
+/**
+ * Instagram API Client
+ * Handles all Instagram Graph API interactions
+ */
+export type MediaType = 'image' | 'audio' | 'video';
+export type ContainerType = 'IMAGE' | 'VIDEO' | 'REELS' | 'STORIES';
+export interface IMessageResponse {
+    recipient_id: string;
+    message_id: string;
+}
+export interface IButton {
+    type: 'web_url' | 'postback';
+    title: string;
+    url?: string;
+    payload?: string;
+}
+export interface ICarouselElement {
+    title: string;
+    subtitle?: string;
+    image_url?: string;
+    buttons?: IButton[];
+}
+export interface IQuickReply {
+    content_type: 'text';
+    title: string;
+    payload: string;
+    image_url?: string;
+}
+export interface IUserProfile {
+    id: string;
+    name?: string;
+    username?: string;
+    profile_pic?: string;
+}
+export interface IBusinessAccount {
+    id: string;
+    username: string;
+    name?: string;
+    profile_picture_url?: string;
+    followers_count?: number;
+    media_count?: number;
+}
+export interface IPaginationOptions {
+    limit?: number;
+    after?: string;
+    before?: string;
+}
+export interface IPaging {
+    cursors?: {
+        before: string;
+        after: string;
+    };
+    next?: string;
+    previous?: string;
+}
+export interface IComment {
+    id: string;
+    text: string;
+    timestamp: string;
+    from: {
+        id: string;
+        username: string;
+    };
+    like_count?: number;
+    hidden?: boolean;
+}
+export interface ICommentsResponse {
+    data: IComment[];
+    paging?: IPaging;
+}
+export interface IMediaContainer {
+    id: string;
+    status?: 'EXPIRED' | 'ERROR' | 'FINISHED' | 'IN_PROGRESS' | 'PUBLISHED';
+    status_code?: string;
+}
+export interface IMediaDetails {
+    id: string;
+    media_type: 'IMAGE' | 'VIDEO' | 'CAROUSEL_ALBUM' | 'REELS';
+    media_url?: string;
+    permalink?: string;
+    caption?: string;
+    timestamp: string;
+    like_count?: number;
+    comments_count?: number;
+}
+export interface IUserTag {
+    username: string;
+    x: number;
+    y: number;
+}
+export interface IMediaOptions {
+    caption?: string;
+    location_id?: string;
+    user_tags?: IUserTag[];
+    collaborators?: string[];
+    thumb_offset?: number;
+    audio_name?: string;
+}
+export interface IInstagramError {
+    code: number;
+    message: string;
+    subcode?: number;
+    fbtrace_id?: string;
+    type?: string;
+    suggestion?: string;
+    retryable?: boolean;
+    retryAfter?: number;
+}
+/** Raw API error response structure */
+interface IApiErrorResponse {
+    error: {
+        message: string;
+        type?: string;
+        code: number;
+        error_subcode?: number;
+        fbtrace_id?: string;
+    };
+}
+export declare class InstagramApiError extends Error {
+    readonly code: number;
+    readonly subcode?: number;
+    readonly fbtrace_id?: string;
+    readonly type?: string;
+    readonly suggestion?: string;
+    readonly retryable: boolean;
+    readonly retryAfter?: number;
+    constructor(error: IInstagramError);
+    toJSON(): IInstagramError;
+}
+export declare class InstagramApiClient {
+    protected readonly baseUrl = "https://graph.facebook.com/v18.0";
+    protected readonly accessToken: string;
+    protected readonly accountId: string;
+    constructor(accessToken: string, accountId: string);
+    /**
+     * Parse API error response and return enhanced error object
+     * Requirements: 14.1, 14.2, 14.3
+     */
+    protected parseErrorResponse(response: IApiErrorResponse): IInstagramError;
+    /**
+     * Make authenticated GET request to Instagram Graph API
+     */
+    protected get<T>(endpoint: string, params?: Record<string, string>): Promise<T>;
+    /**
+     * Make authenticated POST request to Instagram Graph API
+     */
+    protected post<T>(endpoint: string, body?: Record<string, unknown>): Promise<T>;
+    /**
+     * Make authenticated DELETE request to Instagram Graph API
+     */
+    protected delete<T>(endpoint: string): Promise<T>;
+    /**
+     * Send a text message to a user
+     * Requirements: 3.1, 3.2, 3.4
+     */
+    sendTextMessage(recipientId: string, text: string): Promise<IMessageResponse>;
+    /**
+     * Send a media message (image, audio, video)
+     * Requirements: 4.1, 4.2, 4.3, 4.4, 4.5
+     */
+    sendMediaMessage(recipientId: string, mediaType: MediaType, mediaUrl: string): Promise<IMessageResponse>;
+    /**
+     * Send a button template message
+     * Requirements: 5.1, 5.2, 5.6
+     */
+    sendButtonTemplate(recipientId: string, text: string, buttons: IButton[]): Promise<IMessageResponse>;
+    /**
+     * Send a generic template (carousel) message
+     * Requirements: 5.3, 5.6
+     */
+    sendGenericTemplate(recipientId: string, elements: ICarouselElement[]): Promise<IMessageResponse>;
+    /**
+     * Send quick replies
+     * Requirements: 5.4, 5.5, 5.6
+     */
+    sendQuickReplies(recipientId: string, text: string, quickReplies: IQuickReply[]): Promise<IMessageResponse>;
+    /**
+     * Get user profile by IGSID
+     * Requirements: 6.1, 6.3
+     */
+    getUserProfile(userId: string): Promise<IUserProfile>;
+    /**
+     * Get authenticated account profile
+     * Requirements: 6.2, 6.3
+     */
+    getMyProfile(): Promise<IBusinessAccount>;
+    /**
+     * Get comments on a media with pagination
+     * Requirements: 7.1
+     */
+    getComments(mediaId: string, options?: IPaginationOptions): Promise<ICommentsResponse>;
+    /**
+     * Get replies to a comment
+     * Requirements: 7.2
+     */
+    getReplies(commentId: string): Promise<ICommentsResponse>;
+    /**
+     * Reply to a comment publicly
+     * Requirements: 7.3
+     */
+    replyToComment(commentId: string, message: string): Promise<IComment>;
+    /**
+     * Send private reply to a commenter (DM)
+     * Requirements: 7.4, 7.5
+     */
+    sendPrivateReply(commentId: string, message: string): Promise<IMessageResponse>;
+    /**
+     * Delete a comment
+     * Requirements: 7.6
+     */
+    deleteComment(commentId: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Hide or unhide a comment
+     * Requirements: 7.7
+     */
+    toggleCommentVisibility(commentId: string, hide: boolean): Promise<{
+        success: boolean;
+        hidden: boolean;
+    }>;
+    /**
+     * Create a media container for single posts, stories, or reels
+     * Requirements: 8.1, 8.2, 10.1, 10.2, 10.4
+     */
+    createMediaContainer(mediaType: ContainerType, mediaUrl: string, options?: IMediaOptions): Promise<IMediaContainer>;
+    /**
+     * Create a carousel container from child media containers
+     * Requirements: 9.4, 9.5
+     */
+    createCarouselContainer(childrenIds: string[], caption?: string): Promise<IMediaContainer>;
+    /**
+     * Publish a media container
+     * Requirements: 8.3, 9.5, 10.5
+     */
+    publishMedia(containerId: string): Promise<{
+        id: string;
+    }>;
+    /**
+     * List media with pagination
+     * Requirements: 11.1
+     */
+    listMedia(options?: IPaginationOptions): Promise<{
+        data: IMediaDetails[];
+        paging?: IPaging;
+    }>;
+    /**
+     * Get media details by ID
+     * Requirements: 11.2
+     */
+    getMedia(mediaId: string): Promise<IMediaDetails>;
+    /**
+     * Get carousel children
+     * Requirements: 11.3
+     */
+    getMediaChildren(mediaId: string): Promise<{
+        data: IMediaDetails[];
+    }>;
+}
+export {};
+//# sourceMappingURL=InstagramApiClient.d.ts.map

package/dist/services/InstagramApiClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstagramApiClient.d.ts","sourceRoot":"","sources":["../../src/services/InstagramApiClient.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AACpD,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,SAAS,GAAG,UAAU,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,CAAC,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,aAAa,GAAG,WAAW,CAAC;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,OAAO,GAAG,OAAO,GAAG,gBAAgB,GAAG,OAAO,CAAC;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,uCAAuC;AACvC,UAAU,iBAAiB;IACzB,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,SAAS,EAAE,OAAO,CAAC;IACnC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,KAAK,EAAE,eAAe;IAYlC,MAAM,IAAI,eAAe;CAY1B;AAED,qBAAa,kBAAkB;IAC7B,SAAS,CAAC,QAAQ,CAAC,OAAO,sCAAsC;IAChE,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACvC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEzB,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAKlD;;;OAGG;IACH,SAAS,CAAC,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,eAAe;IA0C1E;;OAEG;cACa,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA6BrF;;OAEG;cACa,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAsBrF;;OAEG;cACa,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAuBvD;;;OAGG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAiBnF;;;OAGG;IACG,gBAAgB,CACpB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC;IAsB5B;;;OAGG;IACG,kBAAkB,CACtB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,gBAAgB,CAAC;IA8B5B;;;OAGG;IACG,mBAAmB,CACvB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,OAAO,CAAC,gBAAgB,CAAC;IAkD5B;;;OAGG;IACG,gBAAgB,CACpB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,WAAW,EAAE,GAC1B,OAAO,CAAC,gBAAgB,CAAC;IA2B5B;;;OAGG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAM3D;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAQ/C;;;OAGG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAkB5F;;;OAGG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAM/D;;;OAGG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAM3E;;;OAGG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA4BrF;;;OAGG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAIrE;;;OAGG;IACG,uBAAuB,CAC3B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IASjD;;;OAGG;IACG,oBAAoB,CACxB,SAAS,EAAE,aAAa,EACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,eAAe,CAAC;IAuE3B;;;OAGG;IACG,uBAAuB,CAC3B,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,CAAC;IAuB3B;;;OAGG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAQhE;;;OAGG;IACG,SAAS,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,aAAa,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAkBnG;;;OAGG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAMvD;;;OAGG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;CAK5E"}