nodejs-insta-private-api-mqtt 1.3.65 → 1.3.66

package/README.md

@@ -1,6 +1,6 @@
-Dear users,
-I post many versions of the project because Instagram changes the protocol almost daily, if you like this project leave a star on github https://github.com/Kunboruto20/nodejs-insta-private-api.git 
+Full featured Java and nodejs Instagram api private with Mqtt full suport and api rest 
 
+Dear users The repository on github is currently unavailable will be available soon 
 
 If you Like This Project You Can Help Me with Donation revolut , My revolut revtag is @gvny22 
 
@@ -11,40 +11,46 @@ This project implements a complete and production-ready MQTT protocol client for
 
 By leveraging MQTT instead of Instagram's REST API, this library achieves sub-500ms message latency, bidirectional real-time communication, and native support for notifications, presence tracking, and thread management. The implementation is reverse-engineered from Instagram's mobile app protocol and tested extensively for reliability and compatibility.
 
-## Features (v5.61.11 - iOS + Android Full Support)
-
-- **NEW: FULL iOS SUPPORT** - iPhone 16/15/14/13/12 + iPad Pro/Air device emulation
-- **NEW: FULL ANDROID SUPPORT** - Samsung, Huawei, Google Pixel, OnePlus, Xiaomi, OPPO
-- **NEW: 33 Preset Devices** - 21 iOS + 12 Android devices ready to use
-- **NEW: switchPlatform()** - Switch between iOS and Android with one line
-- **NEW: useIOSDevice()** - Emulate any iPhone or iPad
-- **NEW: useAndroidDevice()** - Emulate any Android phone
-- **NEW: getPlatformInfo()** - Get current platform and device details
-- **NEW: downloadContentFromMessage()** - Download media from DM messages (like Baileys for WhatsApp)
-- **NEW: View-Once Media Extraction** - Save disappearing photos/videos before they expire
-- **NEW: downloadMediaBuffer()** - Get media as Buffer directly
-- **NEW: extractMediaUrls()** - Extract CDN URLs from any message type
-- **NEW: Custom Device Emulation** - Choose which phone model Instagram sees
-- **NEW: setCustomDevice()** - Set any custom Android device with full control
-- **NEW: setIOSDevice()** - Set any custom iOS device with full control
-- **FIX: IRIS subscription auto-fetch** - Messages now received automatically without manual irisData
-- **FIX: startRealTimeListener()** - Fixed to use correct inbox method for IRIS data retrieval
-- **NEW: sendPhoto() / sendVideo()** - Upload and send photos/videos directly via MQTT
-- **NEW: Clear message display** - Incoming messages shown with Username, ID, Text, Status
-- **NEW: All message types decoded** - Photos, videos, voice, reels, stories, links displayed clearly
-- Multi-file auth state - Session persistence like Baileys (WhatsApp library)
-- Real-time MQTT messaging - Receive and send DMs with <500ms latency
-- Bidirectional communication - Send messages back through the same MQTT connection
-- Message management - Send, delete, edit, and reply to messages via MQTT
-- Notification subscriptions - Follow, mention, and call notifications via MQTT
-- Thread management - Add/remove members from groups via MQTT
-- Auto-reply bots - Build keyword-triggered or scheduled response bots
-- Session persistence - Avoid repeated logins with saved sessions
-- Full Instagram API - Stories, media uploads, search, comments, user info
-- Group chat support - Automatic detection with thread-based messaging
-- IRIS subscription protocol - Reliable message delivery with compression
-- Automatic reconnection - Exponential backoff with connection pooling
-- Pure JavaScript - No compilation required, works in Node.js 18+
+## Features (v5.66.0 - Complete REST API + MQTT)
+
+### REST API (32 Repositories)
+- **Account** - Login, 2FA (TOTP + SMS), challenge resolver, edit profile, change password, privacy settings
+- **User** - Info, search, follow/unfollow, block/unblock, mute, get posts/reels/stories with pagination
+- **Media** - Like, comment (pin/unpin/bulk delete/reply), save, archive, download, PK/shortcode conversion
+- **Reels/Clips** - Upload, configure, discover reels, download, music info
+- **Stories** - Upload photo/video stories, react, mark seen, highlights management
+- **Highlights** - Create, edit, delete highlights, add/remove stories, update cover
+- **Direct Messages** - Send text/photo/video/link/media, inbox, pending inbox, group threads
+- **Friendship** - Follow, block, restrict, close friends, favorites, pending requests
+- **Search** - Users, hashtags, places, music, recent/suggested searches
+- **Explore** - Topical explore, report, mark seen
+- **Feed** - Timeline, hashtag/location feeds, saved/liked, carousel upload
+- **Upload** - Photo/video upload with configure to feed, story, or clips
+- **Insights** - Account, media, reel, story analytics (business/creator accounts)
+- **Notes** - Create, delete, view Instagram Notes
+- **Notifications** - Per-type notification settings (likes, comments, follows, etc.)
+- **TOTP** - 2FA setup with authenticator app, SMS 2FA, backup codes
+- **Challenge** - Auto-resolve security checkpoints, verify methods
+- **Signup** - Account creation, email/phone verification, username availability
+- **Music/Tracks** - Search, get info, download audio tracks
+- **Fundraiser** - Create, donate, get fundraiser info
+- **Multiple Accounts** - Account family, switch accounts
+- **Captcha** - reCAPTCHA / hCaptcha handling
+- **Share** - Decode QR/NFC share codes, parse share URLs
+- **Bloks** - Low-level Instagram Bloks engine actions
+
+### MQTT Real-Time
+- **Real-time MQTT messaging** - Receive and send DMs with <500ms latency
+- **FBNS Push Notifications** - Follows, likes, comments, story mentions, live broadcasts
+- **33 Preset Devices** - 21 iOS + 12 Android device emulation
+- **View-Once Media** - Download disappearing photos/videos before they expire
+- **sendPhoto() / sendVideo()** - Upload and send media directly via MQTT
+- **Session persistence** - Multi-file auth state like Baileys (WhatsApp library)
+- **Automatic reconnection** - Smart error classification with type-specific backoff
+- **Session health monitoring** - Auto-relogin, uptime tracking
+- **Persistent logging** - File-based logging with rotation
+- **Message ordering** - Per-thread message queuing
+- **Pure JavaScript** - No compilation required, works in Node.js 18+
 
 ## Scope: DM-Focused Implementation
 
@@ -802,6 +808,1349 @@ const thread = await ig.direct.getThread(threadId);
 await ig.direct.sendText({ thread_ids: [threadId], text: 'Hello' });
 ```
 
+---
+
+## REST API — Full Reference (v5.66.0)
+
+Everything below uses the REST HTTP endpoints, not MQTT. You don't need `RealtimeClient` for any of this — just `IgApiClient` and a valid session.
+
+```javascript
+const { IgApiClient } = require('nodejs-insta-private-api-mqtt');
+const ig = new IgApiClient();
+
+ig.state.usePresetDevice('Samsung Galaxy S25 Ultra');
+await ig.login({ username: 'your_username', password: 'your_password' });
+// you're ready to use any of the methods below
+```
+
+---
+
+### Authentication & Login
+
+#### Basic Login
+
+```javascript
+await ig.login({ username: 'your_username', password: 'your_password' });
+
+// or the shorter way
+await ig.account.login('your_username', 'your_password');
+```
+
+#### Two-Factor Authentication (2FA)
+
+When Instagram asks for a 2FA code, `login()` throws an error that contains the `two_factor_identifier`. Catch it and finish the flow:
+
+```javascript
+try {
+  await ig.account.login('username', 'password');
+} catch (err) {
+  if (err.response?.body?.two_factor_required) {
+    const twoFactorId = err.response.body.two_factor_info.two_factor_identifier;
+    
+    // user enters the code from their authenticator app or SMS
+    const code = '123456';
+    
+    await ig.account.twoFactorLogin('username', code, twoFactorId, '1');
+    // verificationMethod: '1' = SMS, '3' = TOTP app
+    console.log('2FA login successful');
+  }
+}
+```
+
+#### TOTP Two-Factor Setup
+
+Set up authenticator-app-based 2FA for your account. This generates a seed you can add to Google Authenticator, Authy, etc.
+
+```javascript
+// generate a TOTP seed (this is the secret key for your authenticator app)
+const seed = await ig.totp.generateSeed();
+console.log('Add this to your authenticator app:', seed.totp_seed);
+
+// after adding it, verify with a code from the app to confirm
+const code = '123456'; // from authenticator app
+await ig.totp.enable(code);
+console.log('TOTP 2FA is now enabled');
+
+// get backup codes in case you lose your authenticator
+const backupCodes = await ig.totp.getBackupCodes();
+console.log('Save these somewhere safe:', backupCodes);
+
+// disable TOTP 2FA
+await ig.totp.disable();
+```
+
+#### SMS-Based 2FA
+
+```javascript
+// enable SMS 2FA
+await ig.totp.smsTwoFactorEnable('+1234567890');
+
+// confirm with the code you received
+await ig.totp.smsTwoFactorConfirm('123456');
+
+// disable it later
+await ig.totp.disableSmsTwoFactor();
+```
+
+#### Challenge Resolver
+
+When Instagram triggers a security checkpoint (suspicious login, new location, etc.), you need to resolve the challenge:
+
+```javascript
+try {
+  await ig.account.login('username', 'password');
+} catch (err) {
+  if (err.response?.body?.challenge) {
+    const challengeUrl = err.response.body.challenge.api_path;
+    
+    // option 1: automatic resolution (tries to handle it for you)
+    const result = await ig.challenge.auto(challengeUrl);
+    console.log('Challenge result:', result);
+    
+    // option 2: manual step-by-step
+    // first, see what verification methods are available
+    const page = await ig.challenge.getChallengePage(challengeUrl);
+    
+    // choose SMS (0) or email (1)
+    await ig.challenge.selectVerifyMethod(challengeUrl, 1);
+    
+    // enter the code you received
+    await ig.challenge.sendSecurityCode(challengeUrl, '123456');
+  }
+}
+```
+
+---
+
+### Account Management
+
+#### Get Current User Info
+
+```javascript
+const me = await ig.account.currentUser();
+console.log('Username:', me.user.username);
+console.log('Follower count:', me.user.follower_count);
+```
+
+#### Edit Profile
+
+```javascript
+await ig.account.editProfile({
+  fullName: 'John Doe',
+  biography: 'building cool stuff',
+  externalUrl: 'https://example.com',
+  email: 'john@example.com',
+  phoneNumber: '+1234567890',
+  username: 'johndoe_new'
+});
+```
+
+#### Set Biography
+
+```javascript
+await ig.account.setBiography('i like building things that work');
+```
+
+#### Set External URL / Remove Bio Links
+
+```javascript
+await ig.account.setExternalUrl('https://mywebsite.com');
+await ig.account.removeBioLinks();
+```
+
+#### Change Password
+
+```javascript
+await ig.account.changePassword('old_password_here', 'new_password_here');
+```
+
+#### Switch to Private / Public
+
+```javascript
+await ig.account.setPrivate();
+await ig.account.setPublic();
+```
+
+#### Set Gender
+
+```javascript
+// 1 = male, 2 = female, 3 = prefer not to say, 4 = custom
+await ig.account.setGender(1);
+```
+
+#### Profile Picture
+
+```javascript
+// you need an upload_id from a previous photo upload
+await ig.account.profilePictureChange(uploadId);
+await ig.account.profilePictureRemove();
+```
+
+#### Password Encryption Keys
+
+```javascript
+// get the public keys for Instagram's password encryption (needed for some flows)
+const keys = await ig.account.passwordPublicKeys();
+```
+
+#### Account Recovery
+
+```javascript
+// send password recovery via email
+await ig.account.sendRecoveryFlowEmail('user@example.com');
+
+// or via SMS
+await ig.account.sendRecoveryFlowSms('+1234567890');
+```
+
+---
+
+### User Operations
+
+#### Fetch User Info
+
+```javascript
+// by username
+const user = await ig.user.infoByUsername('instagram');
+console.log('User ID:', user.pk);
+console.log('Followers:', user.follower_count);
+
+// by user ID
+const userById = await ig.user.info('25025320');
+```
+
+#### Resolve Username ↔ User ID
+
+```javascript
+const userId = await ig.user.userIdFromUsername('instagram');
+// returns '25025320'
+
+const username = await ig.user.usernameFromUserId('25025320');
+// returns 'instagram'
+```
+
+#### Search Users
+
+```javascript
+const results = await ig.user.search('john', 20);
+results.users.forEach(u => {
+  console.log(u.username, '-', u.full_name);
+});
+
+// exact match
+const exact = await ig.user.searchExact('johndoe');
+```
+
+#### Follow / Unfollow
+
+```javascript
+await ig.user.follow('25025320');
+await ig.user.unfollow('25025320');
+```
+
+#### Block / Unblock
+
+```javascript
+await ig.user.block('25025320');
+await ig.user.unblock('25025320');
+
+// see all blocked users
+const blocked = await ig.user.getBlockedUsers();
+```
+
+#### Mute / Unmute
+
+```javascript
+// mute posts, stories, or both
+await ig.user.mute('25025320', { mutePosts: true, muteStories: true });
+await ig.user.unmute('25025320', { unmutePosts: true, unmuteStories: true });
+```
+
+#### Get Followers / Following (with pagination)
+
+```javascript
+// get up to 200 followers at a time
+const followers = await ig.user.getFollowers('25025320', 200);
+console.log('Got', followers.users.length, 'followers');
+
+// pagination — pass the maxId from the previous response
+const moreFollowers = await ig.user.getFollowers('25025320', 200, followers.next_max_id);
+
+// same for following
+const following = await ig.user.getFollowing('25025320', 200);
+```
+
+#### Get User's Posts (with pagination)
+
+```javascript
+// grab the latest 50 posts
+const posts = await ig.user.getUserMedias('25025320', 50);
+posts.items.forEach(item => {
+  console.log(item.pk, '-', item.caption?.text?.substring(0, 50));
+});
+
+// next page
+const morePosts = await ig.user.getUserMedias('25025320', 50, posts.next_max_id);
+```
+
+#### Get User's Reels / Clips
+
+```javascript
+const reels = await ig.user.getUserReels('25025320', 50);
+const clips = await ig.user.getUserClips('25025320', 50);
+```
+
+#### Get User's Stories
+
+```javascript
+const stories = await ig.user.getUserStories('25025320');
+stories.reel?.items.forEach(story => {
+  console.log('Story:', story.pk, 'taken at:', story.taken_at);
+});
+```
+
+#### Get Tagged Posts
+
+```javascript
+const tagged = await ig.user.getUserTags('25025320');
+```
+
+#### Mutual Followers
+
+```javascript
+const mutual = await ig.user.getMutualFollowers('25025320');
+```
+
+#### Remove a Follower
+
+```javascript
+await ig.user.removeFollower('25025320');
+```
+
+#### Report a User
+
+```javascript
+// reason: 1 = spam, 2 = inappropriate, etc.
+await ig.user.report('25025320', 1);
+```
+
+#### Get Suggested Users
+
+```javascript
+const suggestions = await ig.user.getSuggested();
+```
+
+#### Friendship Status (Bulk)
+
+```javascript
+// check relationship status with multiple users at once
+const statuses = await ig.user.getFriendshipStatuses(['12345', '67890', '11111']);
+```
+
+---
+
+### Media Operations
+
+#### Get Media Info
+
+```javascript
+const info = await ig.media.info('3193593212003331660');
+console.log('Type:', info.items[0].media_type);
+console.log('Likes:', info.items[0].like_count);
+```
+
+#### PK / Shortcode Conversion
+
+These are super useful when you have a post URL and need the numeric ID, or the other way around.
+
+```javascript
+const { MediaRepository } = require('nodejs-insta-private-api-mqtt');
+
+// convert shortcode to numeric PK
+const pk = MediaRepository.mediaPkFromCode('CxR7Bsejq5M');
+// '3193593212003331660'
+
+// convert PK back to shortcode
+const code = MediaRepository.mediaCodeFromPk('3193593212003331660');
+// 'CxR7Bsejq5M'
+
+// extract PK directly from a full URL
+const pkFromUrl = MediaRepository.mediaPkFromUrl('https://www.instagram.com/p/CxR7Bsejq5M/');
+// '3193593212003331660'
+```
+
+#### Like / Unlike
+
+```javascript
+await ig.media.like('3193593212003331660');
+await ig.media.unlike('3193593212003331660');
+```
+
+#### Comment
+
+```javascript
+const comment = await ig.media.comment('3193593212003331660', 'great shot!');
+console.log('Comment ID:', comment.comment.pk);
+```
+
+#### Reply to a Comment
+
+```javascript
+await ig.media.replyToComment('3193593212003331660', '17858893269000001', '@user thanks!');
+```
+
+#### Like / Unlike Comments
+
+```javascript
+await ig.media.likeComment('3193593212003331660', '17858893269000001');
+await ig.media.unlikeComment('3193593212003331660', '17858893269000001');
+```
+
+#### Pin / Unpin Comments
+
+```javascript
+await ig.media.pinComment('3193593212003331660', '17858893269000001');
+await ig.media.unpinComment('3193593212003331660', '17858893269000001');
+```
+
+#### Delete Comments (Single or Bulk)
+
+```javascript
+// single
+await ig.media.deleteComment('3193593212003331660', '17858893269000001');
+
+// bulk delete
+await ig.media.bulkDeleteComments('3193593212003331660', [
+  '17858893269000001',
+  '17858893269000002',
+  '17858893269000003'
+]);
+```
+
+#### Get Comments (Paginated)
+
+```javascript
+const comments = await ig.media.comments('3193593212003331660', null, 20);
+// next page:
+const moreComments = await ig.media.comments('3193593212003331660', comments.next_min_id, 20);
+```
+
+#### Get Comment Thread (Replies to a Comment)
+
+```javascript
+const thread = await ig.media.commentThreadComments('3193593212003331660', '17858893269000001');
+```
+
+#### Get Likers
+
+```javascript
+const likers = await ig.media.likers('3193593212003331660');
+likers.users.forEach(u => console.log(u.username));
+```
+
+#### Save / Unsave
+
+```javascript
+await ig.media.save('3193593212003331660');
+
+// save to a specific collection
+await ig.media.save('3193593212003331660', 'collection_id_here');
+
+await ig.media.unsave('3193593212003331660');
+```
+
+#### Archive / Unarchive
+
+```javascript
+await ig.media.archive('3193593212003331660');
+await ig.media.unarchive('3193593212003331660');
+```
+
+#### Delete Media
+
+```javascript
+// mediaType: 'PHOTO', 'VIDEO', 'CAROUSEL'
+await ig.media.delete('3193593212003331660', 'PHOTO');
+```
+
+#### Edit Caption
+
+```javascript
+await ig.media.edit('3193593212003331660', 'new caption goes here', {
+  usertags: { in: [{ user_id: '12345', position: [0.5, 0.5] }] }
+});
+```
+
+#### Enable / Disable Comments
+
+```javascript
+await ig.media.disableComments('3193593212003331660');
+await ig.media.enableComments('3193593212003331660');
+```
+
+#### Download Media
+
+```javascript
+// download by URL
+const buffer = await ig.media.downloadByUrl('https://instagram.cdnurl.com/...');
+
+// download by PK (photo or video)
+const photo = await ig.media.downloadPhoto('3193593212003331660');
+const video = await ig.media.downloadVideo('3193593212003331660');
+```
+
+#### oEmbed
+
+```javascript
+const oembed = await ig.media.oembed('https://www.instagram.com/p/CxR7Bsejq5M/');
+console.log(oembed.title, '-', oembed.author_name);
+```
+
+#### Get User Who Posted a Media
+
+```javascript
+const user = await ig.media.getUser('3193593212003331660');
+```
+
+---
+
+### Reels / Clips
+
+Upload and browse Reels through the REST API.
+
+#### Upload a Reel
+
+```javascript
+const result = await ig.clip.upload({
+  videoBuffer: fs.readFileSync('./reel.mp4'),
+  caption: 'check this out',
+  coverImage: fs.readFileSync('./cover.jpg'), // optional
+  duration: 15,
+  width: 1080,
+  height: 1920,
+  audisMuted: false,
+});
+console.log('Reel PK:', result.media?.pk);
+```
+
+#### Configure a Video as Reel (after uploading separately)
+
+```javascript
+const configured = await ig.clip.configure({
+  upload_id: uploadId,
+  caption: 'my reel',
+  duration: 15,
+  width: 1080,
+  height: 1920,
+});
+```
+
+#### Discover Reels / Connected Reels
+
+```javascript
+// the explore-style reels feed
+const discover = await ig.clip.discoverReels(10);
+discover.items.forEach(reel => {
+  console.log(reel.media.code, '-', reel.media.caption?.text?.substring(0, 40));
+});
+
+// paginate
+const more = await ig.clip.discoverReels(10, discover.paging_info?.max_id);
+
+// connected reels (similar reels after watching one)
+const connected = await ig.clip.connectedReels(10);
+```
+
+#### Download a Reel
+
+```javascript
+const reelBuffer = await ig.clip.download('3193593212003331660');
+
+// or from URL
+const reelFromUrl = await ig.clip.downloadByUrl('https://instagram.cdnurl.com/...');
+```
+
+#### Get Music Info for Reels
+
+```javascript
+const music = await ig.clip.musicInfo({ music_canonical_id: '12345' });
+```
+
+---
+
+### Stories
+
+#### Get Your Story Feed (Tray)
+
+```javascript
+const tray = await ig.story.getFeed();
+tray.tray.forEach(reel => {
+  console.log(reel.user.username, '- stories:', reel.media_count);
+});
+```
+
+#### Get Someone's Stories
+
+```javascript
+const stories = await ig.story.getUserStories('25025320');
+stories.reel?.items.forEach(item => {
+  console.log('Type:', item.media_type, 'Taken at:', item.taken_at);
+});
+```
+
+#### Upload a Photo Story
+
+```javascript
+const result = await ig.story.upload({
+  file: fs.readFileSync('./story.jpg'),
+  caption: 'hello world', // optional
+});
+console.log('Story ID:', result.media?.pk);
+```
+
+#### Upload a Video Story
+
+```javascript
+const result = await ig.story.uploadVideo({
+  file: fs.readFileSync('./story.mp4'),
+  duration: 10,
+  width: 1080,
+  height: 1920,
+});
+```
+
+#### Mark Stories as Seen
+
+```javascript
+await ig.story.seen([
+  { id: 'media_id_1', taken_at: 1700000000, user: { pk: '25025320' } }
+]);
+```
+
+#### React to a Story
+
+```javascript
+await ig.story.react({
+  mediaId: '3193593212003331660',
+  reelId: '25025320',
+  emoji: '🔥'
+});
+```
+
+---
+
+### Highlights
+
+#### Get User's Highlights
+
+```javascript
+const highlights = await ig.highlights.getHighlightsTray('25025320');
+highlights.tray.forEach(h => {
+  console.log(h.id, '-', h.title);
+});
+```
+
+#### Get a Specific Highlight
+
+```javascript
+const highlight = await ig.highlights.getHighlight('highlight:12345678');
+```
+
+#### Create a Highlight
+
+```javascript
+await ig.highlights.create('My Trip', ['story_id_1', 'story_id_2'], 'cover_media_id');
+```
+
+#### Edit a Highlight
+
+```javascript
+await ig.highlights.edit('highlight_id', 'Updated Title', ['new_story_id']);
+```
+
+#### Add / Remove Stories from Highlight
+
+```javascript
+await ig.highlights.addStories('highlight_id', ['story_id_3', 'story_id_4']);
+await ig.highlights.removeStories('highlight_id', ['story_id_1']);
+```
+
+#### Update Highlight Cover
+
+```javascript
+await ig.highlights.updateCover('highlight_id', 'cover_media_id');
+```
+
+#### Delete a Highlight
+
+```javascript
+await ig.highlights.delete('highlight_id');
+```
+
+---
+
+### Upload & Configure Media
+
+#### Upload a Photo Post
+
+```javascript
+const upload = await ig.upload.photo({
+  file: fs.readFileSync('./photo.jpg'),
+});
+
+const post = await ig.upload.configurePhoto({
+  upload_id: upload.upload_id,
+  caption: 'sunset vibes',
+  usertags: {
+    in: [{ user_id: '12345', position: [0.5, 0.5] }]
+  }
+});
+console.log('Posted! PK:', post.media?.pk);
+```
+
+#### Upload a Video Post
+
+```javascript
+const upload = await ig.upload.video({
+  file: fs.readFileSync('./video.mp4'),
+  duration: 30,
+  width: 1080,
+  height: 1920,
+});
+
+const post = await ig.upload.configureVideo({
+  upload_id: upload.upload_id,
+  caption: 'check this clip',
+  duration: 30,
+  width: 1080,
+  height: 1920,
+});
+```
+
+#### Configure as Reel (Clips)
+
+```javascript
+const reel = await ig.upload.configureToClips({
+  upload_id: upload.upload_id,
+  caption: 'my first reel',
+  duration: 15,
+  width: 1080,
+  height: 1920,
+});
+```
+
+#### Configure as Story
+
+```javascript
+const story = await ig.upload.configureToStory({
+  upload_id: upload.upload_id,
+});
+```
+
+#### Upload a Carousel (Multiple Photos/Videos)
+
+```javascript
+const carousel = await ig.feed.uploadCarousel({
+  caption: 'summer trip highlights',
+  children: [
+    { type: 'photo', file: fs.readFileSync('./pic1.jpg') },
+    { type: 'photo', file: fs.readFileSync('./pic2.jpg') },
+    { type: 'video', file: fs.readFileSync('./vid1.mp4'), duration: 10, width: 1080, height: 1080 },
+  ]
+});
+```
+
+---
+
+### Feed
+
+#### Home Timeline
+
+```javascript
+const feed = await ig.timeline.getFeed();
+feed.feed_items?.forEach(item => {
+  const media = item.media_or_ad;
+  if (media) console.log(media.user.username, '-', media.caption?.text?.substring(0, 40));
+});
+```
+
+#### Hashtag Feed
+
+```javascript
+const tagFeed = await ig.feed.getTag('photography');
+```
+
+#### Location Feed
+
+```javascript
+const locFeed = await ig.feed.getLocation('213385402');
+```
+
+#### Liked Posts
+
+```javascript
+const liked = await ig.feed.getLiked();
+```
+
+#### Saved Posts
+
+```javascript
+const saved = await ig.feed.getSaved();
+```
+
+#### Reels Tray (Stories of People You Follow)
+
+```javascript
+const tray = await ig.feed.reelsTray();
+```
+
+#### Explore Feed
+
+```javascript
+const explore = await ig.feed.getExploreFeed();
+```
+
+#### Reels Feed
+
+```javascript
+const reels = await ig.feed.getReelsFeed();
+const userReels = await ig.feed.getUserReelsFeed('25025320');
+```
+
+#### Reels Media (Bulk)
+
+```javascript
+// get stories for multiple users at once
+const reelsMedia = await ig.feed.reelsMedia(['25025320', '12345678']);
+```
+
+---
+
+### Timeline (Reels)
+
+```javascript
+// get reels from your timeline
+const reels = await ig.timeline.reels(10);
+
+// explore reels
+const exploreReels = await ig.timeline.exploreReels(10);
+```
+
+---
+
+### Direct Messages (REST API)
+
+The REST-based DM methods. These work without MQTT — they're regular HTTP requests.
+
+#### Get Inbox
+
+```javascript
+const inbox = await ig.direct.getInbox();
+inbox.inbox.threads.forEach(t => {
+  console.log(t.thread_title || t.users[0]?.username, '- last:', t.last_permanent_item?.text);
+});
+
+// paginate
+const page2 = await ig.direct.getInbox(inbox.inbox.oldest_cursor, 20);
+```
+
+#### Pending Inbox (Message Requests)
+
+```javascript
+const pending = await ig.direct.getPendingInbox();
+```
+
+#### Get a Thread
+
+```javascript
+const thread = await ig.direct.getThread(threadId);
+thread.thread.items.forEach(msg => {
+  console.log(msg.user_id, ':', msg.text || `[${msg.item_type}]`);
+});
+```
+
+#### Send Text / Photo / Video / Link via REST
+
+```javascript
+await ig.direct.sendText({ thread_ids: [threadId], text: 'hey there!' });
+
+await ig.direct.sendPhoto({
+  thread_ids: [threadId],
+  file: fs.readFileSync('./photo.jpg'),
+});
+
+await ig.direct.sendVideo({
+  thread_ids: [threadId],
+  file: fs.readFileSync('./video.mp4'),
+});
+
+await ig.direct.sendLink({
+  thread_ids: [threadId],
+  link: 'https://example.com',
+  text: 'check this out'
+});
+```
+
+#### Share Media / Profile / Hashtag / Location
+
+```javascript
+await ig.direct.sendMediaShare({ thread_ids: [threadId], mediaId: '3193593212003331660' });
+await ig.direct.sendProfile({ thread_ids: [threadId], userId: '25025320' });
+await ig.direct.sendHashtag({ thread_ids: [threadId], hashtag: 'photography' });
+await ig.direct.sendLocation({ thread_ids: [threadId], locationId: '213385402' });
+```
+
+#### Create a Group Thread
+
+```javascript
+const group = await ig.direct.createGroupThread(['user_id_1', 'user_id_2'], 'Project Team');
+console.log('Thread ID:', group.thread_id);
+```
+
+#### Ranked Recipients (Who to Message)
+
+```javascript
+const recipients = await ig.direct.rankedRecipients('raven', 'john');
+```
+
+#### Get Presence
+
+```javascript
+const presence = await ig.direct.getPresence();
+```
+
+#### Mark as Seen / Hide Thread
+
+```javascript
+await ig.direct.markAsSeen(threadId, itemId);
+await ig.direct.hideThread(threadId);
+```
+
+---
+
+### Friendship Management
+
+#### Follow / Unfollow
+
+```javascript
+await ig.friendship.create('25025320');  // follow
+await ig.friendship.destroy('25025320'); // unfollow
+```
+
+#### Check Friendship Status
+
+```javascript
+const status = await ig.friendship.show('25025320');
+console.log('Following:', status.following);
+console.log('Followed by:', status.followed_by);
+console.log('Blocking:', status.blocking);
+
+// bulk check
+const many = await ig.friendship.showMany(['12345', '67890']);
+```
+
+#### Approve / Ignore Follow Requests
+
+```javascript
+await ig.friendship.approve('25025320');
+await ig.friendship.ignore('25025320');
+
+// list pending requests
+const pending = await ig.friendship.getPendingRequests();
+```
+
+#### Block / Unblock
+
+```javascript
+await ig.friendship.block('25025320');
+await ig.friendship.unblock('25025320');
+
+const blocked = await ig.friendship.getBlockedUsers();
+```
+
+#### Restrict / Unrestrict
+
+```javascript
+await ig.friendship.restrict('25025320');
+await ig.friendship.unrestrict('25025320');
+```
+
+#### Mute / Unmute
+
+```javascript
+await ig.friendship.mute('25025320', { muteStories: true, mutePosts: true });
+await ig.friendship.unmute('25025320', { unmuteStories: true, unmutePosts: true });
+```
+
+#### Close Friends / Besties
+
+```javascript
+// add someone to close friends
+await ig.friendship.setCloseFriend('25025320', true);
+// remove
+await ig.friendship.setCloseFriend('25025320', false);
+
+// bulk update close friends list
+await ig.friendship.setBesties(['user1', 'user2'], ['user3']); // add, remove
+```
+
+#### Favorites
+
+```javascript
+await ig.friendship.setFavorite('25025320');
+await ig.friendship.unsetFavorite('25025320');
+
+const favorites = await ig.friendship.getFavoriteFriends();
+```
+
+#### Remove Follower
+
+```javascript
+await ig.friendship.removeFollower('25025320');
+```
+
+#### Get Followers / Following
+
+```javascript
+const followers = await ig.friendship.getFollowers('25025320');
+const following = await ig.friendship.getFollowing('25025320');
+const mutual = await ig.friendship.getMutuafFollowers('25025320');
+```
+
+---
+
+### Search (FBSearch)
+
+Instagram's unified search endpoint. Covers users, hashtags, places, and music.
+
+#### Top Search (All Types)
+
+```javascript
+const results = await ig.fbsearch.topSearch('coffee shop');
+console.log('Users:', results.users?.length);
+console.log('Places:', results.places?.length);
+console.log('Hashtags:', results.hashtags?.length);
+
+// flat version (simpler output)
+const flat = await ig.fbsearch.topSearchFlat('coffee', 30);
+```
+
+#### Search by Type
+
+```javascript
+const users = await ig.fbsearch.searchUsers('johndoe', 20);
+const hashtags = await ig.fbsearch.searchHashtags('photography', 20);
+const places = await ig.fbsearch.searchPlaces('new york');
+const music = await ig.fbsearch.searchMusic('trending');
+```
+
+#### Search History
+
+```javascript
+const recent = await ig.fbsearch.getRecentSearches();
+
+// clear it
+await ig.fbsearch.clearRecentSearches();
+
+// manually add something to recent searches
+await ig.fbsearch.registerRecentSearch('25025320', 'user');
+```
+
+#### Suggested Searches
+
+```javascript
+const suggested = await ig.fbsearch.getSuggestedSearches('users');
+```
+
+#### Null State (Default Explore)
+
+```javascript
+const nullState = await ig.fbsearch.nullStateDynamic();
+```
+
+---
+
+### Explore
+
+#### Topical Explore
+
+```javascript
+const explore = await ig.explore.topicalExplore({
+  module: 'explore_popular',
+  cluster_id: 'explore_all:0',
+});
+
+// basic explore
+const basic = await ig.explore.explore();
+// paginate
+const page2 = await ig.explore.explore(basic.next_max_id);
+```
+
+#### Report Explore Media
+
+```javascript
+await ig.explore.reportExploreMedia('3193593212003331660', 1);
+```
+
+#### Mark Explore as Seen
+
+```javascript
+await ig.explore.markAsSeen();
+```
+
+---
+
+### Notes
+
+Instagram Notes — the little status messages that show up in the DM tab.
+
+```javascript
+// get all notes from people you follow
+const notes = await ig.note.getNotes();
+const followingNotes = await ig.note.getNotesFollowing();
+
+// create a note (audience: 0 = followers, 1 = close friends)
+await ig.note.createNote('currently building something cool', 0);
+
+// delete your note
+await ig.note.deleteNote('note_id_here');
+
+// mark notes as seen
+await ig.note.lastSeenUpdateNote();
+```
+
+---
+
+### Insights (Business/Creator Accounts)
+
+Requires a business or creator account.
+
+```javascript
+// account-level insights
+const accountInsights = await ig.insights.account({
+  ig_drop_table: 'is_feed',
+  follower_type: 'followers',
+  timeframe: 'one_week',
+  query_params: JSON.stringify({ access_token: '', id: '' })
+});
+
+// insights for a specific post
+const mediaInsights = await ig.insights.media('3193593212003331660');
+
+// reel insights
+const reelInsights = await ig.insights.reelInsights('3193593212003331660');
+
+// story insights
+const storyInsights = await ig.insights.storyInsights('3193593212003331660');
+
+// all media feed insights
+const allMedia = await ig.insights.mediaFeedAll({ count: 20 });
+```
+
+---
+
+### Notifications
+
+Fine-grained control over push notification settings.
+
+```javascript
+// mute all notifications for 8 hours
+await ig.notification.muteAll('8_hour');
+
+// disable all notifications
+await ig.notification.disableAll();
+
+// control individual notification types
+await ig.notification.likes('off');
+await ig.notification.comments('off');
+await ig.notification.newFollower('off');
+await ig.notification.commentLikes('off');
+await ig.notification.directShareActivity('off');
+await ig.notification.login('off');
+await ig.notification.reminders('off');
+
+// and many more: userTagged, firstPost, followRequestAccepted,
+// connection, taggedInBio, pendingDirectShare, directGroupRequests,
+// fundraiserSupporter, announcements, reportUpdated...
+```
+
+---
+
+### Music / Audio Tracks
+
+```javascript
+// search for music
+const tracks = await ig.track.search('trending pop');
+
+// get track info
+const trackInfo = await ig.track.infoById('track_id_here');
+const trackByCanonical = await ig.track.infoByCanonicalId('canonical_id');
+
+// download audio
+const audioBuffer = await ig.track.downloadByUrl('https://instagram.cdnurl.com/...');
+```
+
+---
+
+### Signup (Account Creation)
+
+Programmatic account creation flow.
+
+```javascript
+// check if email/username is available
+const emailCheck = await ig.signup.checkEmail('user@example.com');
+const usernameCheck = await ig.signup.checkUsername('desired_username');
+
+// get signup config
+const config = await ig.signup.getSignupConfig();
+
+// check age eligibility
+await ig.signup.checkAgeEligibility(1995, 6, 15);
+
+// send verification email and confirm
+await ig.signup.sendVerifyEmail('user@example.com');
+await ig.signup.checkConfirmationCode('user@example.com', '123456');
+
+// phone-based signup
+await ig.signup.sendSignupSmsCode('+1234567890');
+await ig.signup.validateSignupSmsCode('+1234567890', '123456');
+
+// get username suggestions
+const suggestions = await ig.signup.getSuggestedUsernames('John Doe', 'john@example.com');
+
+// create the account
+const newAccount = await ig.signup.accountsCreate({
+  username: 'johndoe_2026',
+  password: 'securepassword123',
+  email: 'john@example.com',
+  first_name: 'John',
+});
+```
+
+---
+
+### Multiple Accounts
+
+```javascript
+const family = await ig.multipleAccounts.getAccountFamily();
+const featured = await ig.multipleAccounts.getFeaturedAccounts();
+const info = await ig.multipleAccounts.getAccountInfo();
+
+// switch to another logged-in account
+await ig.multipleAccounts.switchAccount('other_user_id');
+```
+
+---
+
+### Fundraiser
+
+```javascript
+// get fundraiser info
+const info = await ig.fundraiser.standaloneFundraiserInfo('fundraiser_pk');
+
+// create a charity fundraiser
+const fundraiser = await ig.fundraiser.createCharityFundraiser({
+  title: 'Help Local School',
+  description: 'Raising funds for supplies',
+  charity_id: 'charity_pk',
+  goal_amount: 5000,
+});
+
+// donate
+await ig.fundraiser.donateFundraiser('fundraiser_pk', 25);
+```
+
+---
+
+### Captcha / Challenge Forms
+
+```javascript
+// get challenge form (when Instagram shows a captcha)
+const form = await ig.captcha.getChallengeForm('/api/v1/challenge/1234/');
+
+// submit reCAPTCHA or hCaptcha response
+await ig.captcha.submitRecaptchaResponse('/api/v1/challenge/1234/', 'recaptcha_token');
+await ig.captcha.submitHCaptchaResponse('/api/v1/challenge/1234/', 'hcaptcha_token');
+```
+
+---
+
+### Share / URL Parsing
+
+```javascript
+// decode a share code (from QR codes, NFC tags, etc.)
+const info = ig.share.shareInfo('base64_encoded_code');
+// returns { type: 'user', pk: '25025320' }
+
+// parse from URL
+const fromUrl = ig.share.shareInfoByUrl('https://www.instagram.com/share/abc123');
+
+// extract share code from URL
+const code = ig.share.shareCodeFromUrl('https://www.instagram.com/share/abc123');
+```
+
+---
+
+### Bloks (Instagram Bloks Engine)
+
+Low-level access to Instagram's Bloks framework. Used internally by some flows.
+
+```javascript
+await ig.bloks.action({
+  action_name: 'some.action.name',
+  params: { key: 'value' }
+});
+
+const layout = await ig.bloks.getLayoutData({
+  layout_name: 'layout.name',
+  params: {}
+});
+
+// bloks-based password change
+await ig.bloks.changePassword('old_pass', 'new_pass');
+```
+
+---
+
+### Complete REST Repository Reference
+
+Here's every repository and what it covers at a glance.
+
+| Repository | Access | What it does |
+|------------|--------|--------------|
+| `ig.account` | Account management | Login, 2FA, edit profile, change password, privacy |
+| `ig.user` | User operations | Info, search, follow, block, mute, get medias/reels/stories |
+| `ig.media` | Media operations | Like, comment, pin, delete, save, archive, download |
+| `ig.clip` | Reels / Clips | Upload, discover, download reels |
+| `ig.story` | Stories | Upload, view, react, highlights |
+| `ig.highlights` | Highlights | Create, edit, delete, manage cover |
+| `ig.feed` | Content feeds | Timeline, hashtag, location, saved, liked, explore |
+| `ig.timeline` | Timeline reels | Reels feed, explore reels |
+| `ig.upload` | Upload & configure | Photo/video upload, configure to feed/story/clips |
+| `ig.direct` | Direct messages | Inbox, send text/media/links, group threads |
+| `ig.friendship` | Relationships | Follow, block, restrict, close friends, favorites |
+| `ig.fbsearch` | Search | Users, hashtags, places, music, search history |
+| `ig.explore` | Explore page | Topical explore, report, mark seen |
+| `ig.insights` | Analytics | Account, media, reel, story insights |
+| `ig.note` | Notes | Create, delete, view notes |
+| `ig.notification` | Notification settings | Enable/disable per-type notifications |
+| `ig.totp` | 2FA management | TOTP setup, SMS 2FA, backup codes |
+| `ig.challenge` | Challenge resolver | Auto-resolve, verify methods, security codes |
+| `ig.signup` | Account creation | Email/phone verification, username check, create account |
+| `ig.track` | Music / Audio | Search tracks, get info, download |
+| `ig.share` | Share codes | Decode QR/NFC share codes, parse URLs |
+| `ig.bloks` | Bloks engine | Low-level Instagram UI actions |
+| `ig.fundraiser` | Fundraisers | Create, donate, get info |
+| `ig.multipleAccounts` | Multi-account | Switch accounts, account family |
+| `ig.captcha` | Captcha handling | reCAPTCHA / hCaptcha submission |
+| `ig.location` | Locations | Location search and info |
+| `ig.hashtag` | Hashtags | Hashtag info and feed |
+| `ig.news` | Activity feed | Activity inbox |
+| `ig.collection` | Collections | Saved collections management |
+| `ig.closeFriends` | Close friends | Close friends list management |
+
+---
+
 ### RealtimeClient Events
 
 | Event | Description |
@@ -1532,6 +2881,41 @@ The result is roughly 10x less keepalive traffic, which means less chance of Ins
 
 ## Changelog
 
+### v5.66.0 (February 2026) - Complete REST API Parity with instagrapi
+
+**32 REST API Repositories — full coverage of every Instagram private endpoint:**
+
+New repositories added:
+- `ClipRepository` - Upload, configure, discover, and download Reels/Clips
+- `TimelineRepository` - Timeline reels feed and explore reels
+- `InsightsRepository` - Account, media, reel, and story insights for business/creator accounts
+- `NoteRepository` - Create, delete, and view Instagram Notes
+- `NotificationRepository` - Fine-grained per-type notification settings
+- `SignupRepository` - Full account creation flow with email/SMS verification
+- `TOTPRepository` - TOTP 2FA setup, SMS 2FA, backup codes
+- `BloksRepository` - Low-level Bloks engine actions
+- `ChallengeRepository` - Auto-resolve challenges, verify methods, security codes
+- `ShareRepository` - Decode QR/NFC share codes, parse share URLs
+- `TrackRepository` - Music/audio search, info, download
+- `ExploreRepository` - Topical explore, report, mark seen
+- `FBSearchRepository` - Unified search (users, hashtags, places, music), search history
+- `FundraiserRepository` - Create, donate, get fundraiser info
+- `MultipleAccountsRepository` - Account family, switch accounts
+- `CaptchaRepository` - reCAPTCHA / hCaptcha submission for challenges
+- `HighlightsRepository` - Create, edit, delete highlights, manage stories and covers
+
+Enhanced existing repositories:
+- `AccountRepository` - Added editProfile, setBiography, setExternalUrl, removeBioLinks, setGender, setPrivate/Public, profilePictureChange/Remove, passwordPublicKeys, sendRecoveryFlowEmail/Sms, encryptPassword
+- `UserRepository` - Added getUserMedias/getUserReels/getUserClips with pagination, userIdFromUsername, usernameFromUserId, block/unblock, mute/unmute, removeFollower, getBlockedUsers, getMutualFollowers
+- `MediaRepository` - Added pinComment/unpinComment, bulkDeleteComments, replyToComment, likeComment/unlikeComment, save/unsave, archive/unarchive, disableComments/enableComments, commentThreadComments, downloadPhoto/downloadVideo, oembed, static mediaPkFromCode/mediaCodeFromPk/mediaPkFromUrl
+- `FriendshipRepository` - Added restrict/unrestrict, setCloseFriend, setBesties, getFavoriteFriends, setFavorite/unsetFavorite, getPendingRequests, getMutuafFollowers, getBlockedUsers
+- `FeedRepository` - Added uploadCarousel, reelsMedia, reelsTray, getReelsFeed, getUserReelsFeed, getExploreFeed
+- `StoryRepository` - Added createHighlight/editHighlight/deleteHighlight, uploadVideo, configureStoryVideo, react
+- `DirectRepository` - Added sendPhoto/sendVideo/sendLink/sendMediaShare/sendProfile/sendHashtag/sendLocation, getPendingInbox, createGroupThread, hideThread
+- `UploadRepository` - Added configureToClips, configurePhoto, configureVideo, configureToStory
+
+All 32 repositories registered in client.js and exported from index.js.
+
 ### v5.65.0 (February 2026) - Full FBNS Push Notifications
 
 **FbnsClient now fully working out of the box:**