@pakoor/n8n-nodes-instagram 0.1.0

package/README.md

@@ -0,0 +1,271 @@
+# n8n-nodes-instagram
+
+n8n community node for Instagram Messaging API integration. This package provides OAuth2/Access Token authentication, messaging capabilities, content publishing, comment management, and webhook-based event handling through the Instagram Graph API.
+
+## Features
+
+- **OAuth2 & Access Token Authentication** - Secure connection with automatic token refresh
+- **Messaging** - Send text, images, audio, video, buttons, carousels, and quick replies
+- **User Management** - Retrieve user profiles and account information
+- **Comment Management** - Get, reply, delete, and moderate comments
+- **Content Publishing** - Create posts, carousels, stories, and reels
+- **Media Management** - List and retrieve media details
+- **Webhook Triggers** - Receive real-time messaging and content events
+
+## Installation
+
+### Community Nodes (Recommended)
+
+1. Go to **Settings > Community Nodes**
+2. Select **Install**
+3. Enter `n8n-nodes-instagram` and confirm
+
+### Manual Installation
+
+```bash
+npm install n8n-nodes-instagram
+```
+
+Or in your n8n installation directory:
+
+```bash
+cd ~/.n8n/custom
+npm install n8n-nodes-instagram
+```
+
+## Prerequisites
+
+- Instagram Business Account or Creator Account
+- Facebook Page connected to your Instagram account
+- Meta Developer App with Instagram Graph API enabled
+
+### Required Permissions
+
+- `instagram_basic` - Basic account information
+- `instagram_manage_messages` - Send and receive messages
+- `instagram_manage_comments` - Manage comments
+- `instagram_content_publish` - Publish content
+- `pages_show_list` - Access connected Facebook pages
+- `pages_read_engagement` - Read page engagement data
+
+## Quick Start
+
+### 1. Set Up Credentials
+
+#### OAuth2 (Recommended)
+1. Create a Meta Developer App at [developers.facebook.com](https://developers.facebook.com)
+2. Add Instagram Graph API product
+3. In n8n, create new **Instagram OAuth2 API** credentials
+4. Enter your App ID and App Secret
+5. Click **Connect** to authorize
+
+#### Access Token
+1. Generate a long-lived access token from Meta Developer Console
+2. In n8n, create new **Instagram Access Token API** credentials
+3. Paste your access token
+4. Account ID will be auto-discovered
+
+### 2. Create Your First Workflow
+
+1. Add an **Instagram** node to your workflow
+2. Select your credentials
+3. Choose a resource and operation
+4. Configure the parameters
+5. Execute the workflow
+
+## Node Operations
+
+### Instagram Node
+
+#### Message Operations
+
+| Operation | Description |
+|-----------|-------------|
+| Send Text | Send a text message to a user |
+| Send Image | Send an image message via URL |
+| Send Audio | Send an audio message via URL |
+| Send Video | Send a video message via URL |
+| Send Button Template | Send interactive buttons |
+| Send Generic Template | Send a carousel of cards |
+| Send Quick Replies | Send quick reply options |
+
+#### User Operations
+
+| Operation | Description |
+|-----------|-------------|
+| Get Profile | Get a user's profile by IGSID |
+| Get My Profile | Get your Instagram Business Account info |
+
+#### Comment Operations
+
+| Operation | Description |
+|-----------|-------------|
+| Get Comments | Get comments on a media post |
+| Get Replies | Get replies to a comment |
+| Reply | Post a public reply to a comment |
+| Send Private Reply | Send a DM to a commenter (within 7 days) |
+| Delete | Delete a comment |
+| Toggle Visibility | Hide or unhide a comment |
+
+#### Post Operations
+
+| Operation | Description |
+|-----------|-------------|
+| Create Single | Create a single image/video post |
+| Create Carousel | Create a carousel post (2-10 items) |
+| Publish | Publish a media container |
+
+#### Story Operations
+
+| Operation | Description |
+|-----------|-------------|
+| Create | Create a story (image or video) |
+
+#### Reel Operations
+
+| Operation | Description |
+|-----------|-------------|
+| Create | Create a reel (video up to 60 seconds) |
+
+#### Media Operations
+
+| Operation | Description |
+|-----------|-------------|
+| List | List your media with pagination |
+| Get | Get details of a specific media |
+| Get Children | Get items in a carousel post |
+
+### Instagram Trigger Node
+
+Receives webhook events from Instagram with dual outputs:
+
+| Output | Events |
+|--------|--------|
+| Messaging Events | Messages, Postbacks, Opt-ins |
+| Content Events | Comments, Mentions |
+
+## Usage Examples
+
+### Send a Text Message
+
+```json
+{
+  "resource": "message",
+  "operation": "sendText",
+  "recipientId": "{{$json.sender_id}}",
+  "text": "Hello! Thanks for reaching out."
+}
+```
+
+### Send Button Template
+
+```json
+{
+  "resource": "message",
+  "operation": "sendButtonTemplate",
+  "recipientId": "{{$json.sender_id}}",
+  "text": "How can I help you?",
+  "buttons": [
+    { "type": "postback", "title": "View Products", "payload": "PRODUCTS" },
+    { "type": "web_url", "title": "Visit Website", "url": "https://example.com" }
+  ]
+}
+```
+
+### Create and Publish a Post
+
+```json
+// Step 1: Create container
+{
+  "resource": "post",
+  "operation": "createSingle",
+  "mediaType": "IMAGE",
+  "mediaUrl": "https://example.com/image.jpg",
+  "caption": "Check out our new product! #newproduct"
+}
+
+// Step 2: Publish (use container ID from step 1)
+{
+  "resource": "post",
+  "operation": "publish",
+  "containerId": "{{$json.id}}"
+}
+```
+
+### Reply to Comments Automatically
+
+Use the Instagram Trigger to receive comment events, then reply:
+
+```json
+{
+  "resource": "comment",
+  "operation": "reply",
+  "commentId": "{{$json.id}}",
+  "message": "Thanks for your comment! 🙏"
+}
+```
+
+## Validation Limits
+
+| Field | Limit |
+|-------|-------|
+| Text message | 1000 characters |
+| Button count | 3 maximum |
+| Button title | 20 characters |
+| Quick replies | 13 maximum |
+| Carousel items | 2-10 items |
+| User tags | 20 maximum |
+| Tag position (x, y) | 0-1 range |
+| Reel duration | 60 seconds |
+
+## Webhook Setup
+
+To use the Instagram Trigger node:
+
+1. Deploy your n8n instance with a public URL
+2. Add the Instagram Trigger node to a workflow
+3. Activate the workflow
+4. Configure the webhook URL in your Meta App:
+   - Go to your Meta App > Webhooks
+   - Subscribe to `instagram` webhooks
+   - Enter your n8n webhook URL
+   - Select events: `messages`, `messaging_postbacks`, `comments`, `mentions`
+
+## Error Handling
+
+The node provides detailed error information:
+
+| Error Code | Description | Suggestion |
+|------------|-------------|------------|
+| 4 | Rate limit exceeded | Wait and retry |
+| 190 | Invalid access token | Reconnect credentials |
+| 100 | Invalid parameter | Check input values |
+| 10 | Permission denied | Check app permissions |
+
+Enable **Continue On Fail** in node settings for graceful error handling in workflows.
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Lint
+npm run lint
+```
+
+## License
+
+MIT
+
+## Links
+
+- [Instagram Graph API Documentation](https://developers.facebook.com/docs/instagram-api)
+- [n8n Community Nodes](https://docs.n8n.io/integrations/community-nodes/)
+- [Meta Developer Portal](https://developers.facebook.com)

package/dist/__tests__/helpers/index.d.ts

@@ -0,0 +1,2 @@
+export * from './testUtils';
+//# sourceMappingURL=index.d.ts.map

package/dist/__tests__/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/__tests__/helpers/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./testUtils"), exports);
+//# sourceMappingURL=index.js.map

package/dist/__tests__/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/__tests__/helpers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B"}

package/dist/__tests__/helpers/testUtils.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Test Utilities and Helpers
+ * Common utilities for unit and property-based testing
+ */
+import * as fc from 'fast-check';
+/**
+ * Fast-check configuration for property-based tests
+ * Minimum 100 iterations per property as per design requirements
+ */
+export declare const fcConfig: fc.Parameters<unknown>;
+/**
+ * Generate a random string of specified length
+ */
+export declare const arbString: (maxLength: number) => fc.Arbitrary<string>;
+/**
+ * Generate a random non-empty string
+ */
+export declare const arbNonEmptyString: (maxLength: number) => fc.Arbitrary<string>;
+/**
+ * Generate a valid HTTPS URL
+ */
+export declare const arbHttpsUrl: () => fc.Arbitrary<string>;
+/**
+ * Generate an invalid (non-HTTPS) URL
+ */
+export declare const arbNonHttpsUrl: () => fc.Arbitrary<string>;
+/**
+ * Generate a valid Instagram-scoped User ID (IGSID)
+ */
+export declare const arbIgsid: () => fc.Arbitrary<string>;
+/**
+ * Generate a valid button title (max 20 chars)
+ */
+export declare const arbButtonTitle: () => fc.Arbitrary<string>;
+/**
+ * Generate a valid button
+ */
+export declare const arbButton: () => fc.Arbitrary<{
+    type: "web_url" | "postback";
+    title: string;
+    url?: string;
+    payload?: string;
+}>;
+/**
+ * Generate a valid quick reply
+ */
+export declare const arbQuickReply: () => fc.Arbitrary<{
+    content_type: "text";
+    title: string;
+    payload: string;
+    image_url?: string;
+}>;
+/**
+ * Generate a valid user tag with position
+ */
+export declare const arbUserTag: () => fc.Arbitrary<{
+    username: string;
+    x: number;
+    y: number;
+}>;
+/**
+ * Generate a timestamp within a specific range
+ */
+export declare const arbTimestamp: (daysAgo?: number) => fc.Arbitrary<number>;
+/**
+ * Generate a future timestamp
+ */
+export declare const arbFutureTimestamp: (daysAhead?: number) => fc.Arbitrary<number>;
+/**
+ * Generate a webhook signature
+ */
+export declare const arbWebhookSignature: () => fc.Arbitrary<string>;
+/**
+ * Generate a valid webhook verify token
+ */
+export declare const arbVerifyToken: () => fc.Arbitrary<string>;
+/**
+ * Generate a webhook challenge string
+ */
+export declare const arbChallenge: () => fc.Arbitrary<string>;
+/**
+ * Helper to create a mock n8n execution context
+ */
+export declare function createMockExecutionContext(): {
+    getInputData: jest.Mock<any, any, any>;
+    getNodeParameter: jest.Mock<any, any, any>;
+    getCredentials: jest.Mock<any, any, any>;
+    continueOnFail: jest.Mock<any, any, any>;
+    helpers: {
+        request: jest.Mock<any, any, any>;
+        requestWithAuthentication: jest.Mock<any, any, any>;
+    };
+};
+/**
+ * Helper to create a mock webhook context
+ */
+export declare function createMockWebhookContext(): {
+    getRequestObject: jest.Mock<any, any, any>;
+    getQueryData: jest.Mock<any, any, any>;
+    getBodyData: jest.Mock<any, any, any>;
+    getNodeParameter: jest.Mock<any, any, any>;
+    getHeaderData: jest.Mock<any, any, any>;
+};
+//# sourceMappingURL=testUtils.d.ts.map

package/dist/__tests__/helpers/testUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testUtils.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/testUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAI3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,WAAW,MAAM,KAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CACvC,CAAC;AAE3B;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,WAAW,MAAM,KAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CACjC,CAAC;AAEzC;;GAEG;AACH,eAAO,MAAM,WAAW,QAAO,EAAE,CAAC,SAAS,CAAC,MAAM,CACV,CAAC;AAEzC;;GAEG;AACH,eAAO,MAAM,cAAc,QAAO,EAAE,CAAC,SAAS,CAAC,MAAM,CAKlD,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,QAAQ,QAAO,EAAE,CAAC,SAAS,CAAC,MAAM,CAI3C,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,cAAc,QAAO,EAAE,CAAC,SAAS,CAAC,MAAM,CACT,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,SAAS,QAAO,EAAE,CAAC,SAAS,CAAC;IACxC,IAAI,EAAE,SAAS,GAAG,UAAU,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAMG,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,aAAa,QAAO,EAAE,CAAC,SAAS,CAAC;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAMG,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,UAAU,QAAO,EAAE,CAAC,SAAS,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX,CAKG,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,UAAS,MAAW,KAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAItE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,YAAW,MAAW,KAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAI9E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,QAAO,EAAE,CAAC,SAAS,CAAC,MAAM,CACqB,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,cAAc,QAAO,EAAE,CAAC,SAAS,CAAC,MAAM,CACT,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,YAAY,QAAO,EAAE,CAAC,SAAS,CAAC,MAAM,CACL,CAAC;AAE/C;;GAEG;AACH,wBAAgB,0BAA0B;;;;;;;;;EAWzC;AAED;;GAEG;AACH,wBAAgB,wBAAwB;;;;;;EAQvC"}

package/dist/__tests__/helpers/testUtils.js

@@ -0,0 +1,175 @@
+"use strict";
+/**
+ * Test Utilities and Helpers
+ * Common utilities for unit and property-based testing
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.arbChallenge = exports.arbVerifyToken = exports.arbWebhookSignature = exports.arbFutureTimestamp = exports.arbTimestamp = exports.arbUserTag = exports.arbQuickReply = exports.arbButton = exports.arbButtonTitle = exports.arbIgsid = exports.arbNonHttpsUrl = exports.arbHttpsUrl = exports.arbNonEmptyString = exports.arbString = exports.fcConfig = void 0;
+exports.createMockExecutionContext = createMockExecutionContext;
+exports.createMockWebhookContext = createMockWebhookContext;
+const fc = __importStar(require("fast-check"));
+/**
+ * Fast-check configuration for property-based tests
+ * Minimum 100 iterations per property as per design requirements
+ */
+exports.fcConfig = {
+    numRuns: 100,
+    verbose: false,
+    seed: Date.now(),
+};
+/**
+ * Generate a random string of specified length
+ */
+const arbString = (maxLength) => fc.string({ maxLength });
+exports.arbString = arbString;
+/**
+ * Generate a random non-empty string
+ */
+const arbNonEmptyString = (maxLength) => fc.string({ minLength: 1, maxLength });
+exports.arbNonEmptyString = arbNonEmptyString;
+/**
+ * Generate a valid HTTPS URL
+ */
+const arbHttpsUrl = () => fc.webUrl({ validSchemes: ['https'] });
+exports.arbHttpsUrl = arbHttpsUrl;
+/**
+ * Generate an invalid (non-HTTPS) URL
+ */
+const arbNonHttpsUrl = () => fc.oneof(fc.webUrl({ validSchemes: ['http'] }), fc.constant('ftp://example.com/file'), fc.constant('file:///path/to/file'));
+exports.arbNonHttpsUrl = arbNonHttpsUrl;
+/**
+ * Generate a valid Instagram-scoped User ID (IGSID)
+ */
+const arbIgsid = () => fc.stringOf(fc.constantFrom('0', '1', '2', '3', '4', '5', '6', '7', '8', '9'), {
+    minLength: 10,
+    maxLength: 20,
+});
+exports.arbIgsid = arbIgsid;
+/**
+ * Generate a valid button title (max 20 chars)
+ */
+const arbButtonTitle = () => fc.string({ minLength: 1, maxLength: 20 });
+exports.arbButtonTitle = arbButtonTitle;
+/**
+ * Generate a valid button
+ */
+const arbButton = () => fc.record({
+    type: fc.constantFrom('web_url', 'postback'),
+    title: (0, exports.arbButtonTitle)(),
+    url: fc.option((0, exports.arbHttpsUrl)(), { nil: undefined }),
+    payload: fc.option(fc.string({ maxLength: 100 }), { nil: undefined }),
+});
+exports.arbButton = arbButton;
+/**
+ * Generate a valid quick reply
+ */
+const arbQuickReply = () => fc.record({
+    content_type: fc.constant('text'),
+    title: fc.string({ minLength: 1, maxLength: 20 }),
+    payload: fc.string({ minLength: 1, maxLength: 100 }),
+    image_url: fc.option((0, exports.arbHttpsUrl)(), { nil: undefined }),
+});
+exports.arbQuickReply = arbQuickReply;
+/**
+ * Generate a valid user tag with position
+ */
+const arbUserTag = () => fc.record({
+    username: fc.string({ minLength: 1, maxLength: 30 }),
+    x: fc.float({ min: 0, max: 1, noNaN: true }),
+    y: fc.float({ min: 0, max: 1, noNaN: true }),
+});
+exports.arbUserTag = arbUserTag;
+/**
+ * Generate a timestamp within a specific range
+ */
+const arbTimestamp = (daysAgo = 30) => {
+    const now = Date.now();
+    const past = now - daysAgo * 24 * 60 * 60 * 1000;
+    return fc.integer({ min: past, max: now });
+};
+exports.arbTimestamp = arbTimestamp;
+/**
+ * Generate a future timestamp
+ */
+const arbFutureTimestamp = (daysAhead = 60) => {
+    const now = Date.now();
+    const future = now + daysAhead * 24 * 60 * 60 * 1000;
+    return fc.integer({ min: now, max: future });
+};
+exports.arbFutureTimestamp = arbFutureTimestamp;
+/**
+ * Generate a webhook signature
+ */
+const arbWebhookSignature = () => fc.hexaString({ minLength: 64, maxLength: 64 }).map((hex) => `sha256=${hex}`);
+exports.arbWebhookSignature = arbWebhookSignature;
+/**
+ * Generate a valid webhook verify token
+ */
+const arbVerifyToken = () => fc.string({ minLength: 8, maxLength: 64 });
+exports.arbVerifyToken = arbVerifyToken;
+/**
+ * Generate a webhook challenge string
+ */
+const arbChallenge = () => fc.string({ minLength: 10, maxLength: 100 });
+exports.arbChallenge = arbChallenge;
+/**
+ * Helper to create a mock n8n execution context
+ */
+function createMockExecutionContext() {
+    return {
+        getInputData: jest.fn().mockReturnValue([{ json: {} }]),
+        getNodeParameter: jest.fn(),
+        getCredentials: jest.fn(),
+        continueOnFail: jest.fn().mockReturnValue(false),
+        helpers: {
+            request: jest.fn(),
+            requestWithAuthentication: jest.fn(),
+        },
+    };
+}
+/**
+ * Helper to create a mock webhook context
+ */
+function createMockWebhookContext() {
+    return {
+        getRequestObject: jest.fn(),
+        getQueryData: jest.fn(),
+        getBodyData: jest.fn(),
+        getNodeParameter: jest.fn(),
+        getHeaderData: jest.fn(),
+    };
+}
+//# sourceMappingURL=testUtils.js.map

package/dist/__tests__/helpers/testUtils.js.map

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

package/dist/credentials/InstagramAccessTokenApi.credentials.d.ts

@@ -0,0 +1,19 @@
+import type { IAuthenticateGeneric, ICredentialDataDecryptedObject, ICredentialTestRequest, ICredentialType, IHttpRequestHelper, INodeProperties } from 'n8n-workflow';
+export declare class InstagramAccessTokenApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+    /**
+     * Pre-authentication hook to validate token and auto-discover Instagram Business Account ID
+     *
+     * Requirements:
+     * - 2.1: Validate token against Instagram Graph API
+     * - 2.2: Auto-discover Instagram Business Account ID
+     * - 2.3: Return descriptive error for invalid tokens
+     */
+    preAuthentication(this: IHttpRequestHelper, credentials: ICredentialDataDecryptedObject): Promise<ICredentialDataDecryptedObject>;
+}
+//# sourceMappingURL=InstagramAccessTokenApi.credentials.d.ts.map

package/dist/credentials/InstagramAccessTokenApi.credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstagramAccessTokenApi.credentials.d.ts","sourceRoot":"","sources":["../../src/credentials/InstagramAccessTokenApi.credentials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,8BAA8B,EAC9B,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,eAAe,EAChB,MAAM,cAAc,CAAC;AAmCtB,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,IAAI,SAA6B;IACjC,WAAW,SAAgC;IAC3C,gBAAgB,SAAyD;IAEzE,UAAU,EAAE,eAAe,EAAE,CAmB3B;IAEF,YAAY,EAAE,oBAAoB,CAOhC;IAEF,IAAI,EAAE,sBAAsB,CAQ1B;IAEF;;;;;;;OAOG;IACG,iBAAiB,CACrB,IAAI,EAAE,kBAAkB,EACxB,WAAW,EAAE,8BAA8B,GAC1C,OAAO,CAAC,8BAA8B,CAAC;CAmF3C"}