igpapi — Instagram private API Simulator for Node.js (API reference) 4.19.0
    Preparing search index...

    Function createClientInternals

    • Builds the client state from the options: a new device from seed, or the restored snapshot, plus the native transport client.

      Invalid options throw what they always threw (a RangeError for the request timeout, the native client's own error for a proxy or protocol mode it rejects); a snapshot that cannot be restored throws SnapshotDecodeError.

      A restored snapshot keeps the application it carries, whatever build wrote it: a session saved on 222 sends the 222 user agent, build number and the rest of the snapshot's application, built with this release's request shapes (owner, 2026-10-31, verbatim: «Что лежит в снапшоте, то и уходит. Сессия, сохранённая на 222, шлёт User-Agent 222, номер сборки 222 и прочие данные приложения из снапшота»). A version-bound field the snapshot omits is filled from defaultApplication, because the request cannot be built without it — the GraphQL doc-id table, GRAPHQL_OMIT_PRETTY, the Direct inbox directInboxMode, the launch wire launchWire (the feed/timeline block, the feeds' appnetsession pair, the shared launch requests, the inbox-tray form, the save-credentials placement and the dictionary fan-out), the media wires mediaLikeWire, mediaRepostWire and mediaNoteWire, the launch constants shoppingExperiments and directSearchGenAiBotsLimit, the Bloks prism palette, the Bloks theme bloksThemeParams, its INTERNAL_INFRA_THEME spelling, the bk_client_context shape bloksClientContext, the zero-rating table ZERO_HEADERS and the USDID registration's name usdidRegistrationName. Nothing is replaced or dropped: every literal the snapshot carries stays. A new process (no snapshot) runs defaultApplication whole. See withDefaultVersionBoundFields.

      The device and the session are the snapshot's own: the platform's settleRestoredDevice hook fills the device facts a snapshot of the same build may predate (settleAndroidDeviceFacts), so a restored device reports what a fresh one of that build does.

      The platform app layers and the tests build a process through it.

      Parameters

      Returns Promise<
          {
              application: MobileApplicationState;
              client: Client;
              cookieJar: CookieJarLike;
              device: MobileDeviceState;
              protocolDiagnostics: () => readonly Readonly<ProtocolDiagnostic>[];
              requestTimeoutMs: number;
              session: {
                  accounts: {
                      readonly [key: string]: {
                          contentFilterDictionaryVersions?: { readonly [key: string]: string };
                          directInboxCache?: {
                              threads: readonly {
                                  is_group: boolean;
                                  items: readonly {
                                      client_context?: ...;
                                      item_id: ...;
                                      item_type: ...;
                                      text?: ...;
                                      timestamp: ...;
                                      user_id: ...;
                                  }[];
                                  last_activity_at: string
                                  | number;
                                  muted: boolean;
                                  thread_id: string;
                                  thread_title: string;
                                  thread_v2_id: string;
                                  users: readonly {
                                      fbid_v2?: ...;
                                      full_name: ...;
                                      pk: ...;
                                      username: ...;
                                  }[];
                              }[];
                          };
                          directInboxSeqId?: number;
                          directLoadedThreads?: readonly string[];
                          lastCreationMode?: "post"
                          | "reel"
                          | "story";
                          metaAiConsent?: {
                              cacheTimeSeconds: number;
                              fetchedAtSeconds: number;
                              nuxType: string;
                              requiresNux: boolean;
                              text: string;
                              version: string;
                          };
                          metaSubsEntrypointSessions?: {
                              readonly [key: string]: {
                                  expiresAtMs: number;
                                  refreshAtMs: number;
                                  sessionId: string;
                              };
                          };
                          msgrRegion?: string;
                          noteCtasFetchedAtMs?: number;
                          popularKeywordsRefreshedAtMs?: number;
                          quickPromotionCooldown?: {
                              defaultMs: number;
                              slots: { readonly [key: string]: number };
                          };
                          quickPromotionImpressions?: {
                              readonly [key: string]: {
                                  lastSurface: string;
                                  surfaces: { readonly [key: string]: number };
                              };
                          };
                          regionHint?: string;
                          rur?: string;
                          shbid?: string;
                          shbts?: string;
                      };
                  };
                  appStartPhase?: "cold";
                  appStartTimeMs?: number;
                  authorization?: string;
                  bandwidth?: {
                      bytes: number;
                      carried?: true;
                      ms: number;
                      stack?: {
                          downloadBwAvgBps: number;
                          downloadBweMeanBps: number;
                          downloadBwStddevBps: number;
                          rttAvgMs: number;
                          rttStddevMs: number;
                          uploadBwAvgBps: number;
                          uploadBwe: {
                              bps: number;
                              buckets: readonly {
                                  lower: number;
                                  mean: number;
                                  p25: number;
                                  p50: number;
                                  p75: number;
                                  samples: number;
                                  upper: (...)
                                  | (...);
                              }[];
                              sampleCount: number;
                          };
                          uploadBwStddevBps: number;
                      };
                  };
                  challenge?: { readonly [key: string]: unknown };
                  checkpoint?: { readonly [key: string]: unknown };
                  clientSessionIdLifetime: number;
                  dsUserId?: string;
                  familyDeviceIdBound?: boolean;
                  fbidV2?: string;
                  igWWWClaim?: string;
                  passwordEncryptionKeyId?: string;
                  passwordEncryptionPubKey?: string;
                  pigeonSessionIdLifetime: number;
                  profileFollows?: {
                      readonly [key: string]: {
                          atMs: number;
                          following: boolean;
                          outgoingRequest: boolean;
                      };
                  };
                  profileInfoFetches?: {
                      readonly [key: string]: {
                          atMs: number;
                          userFbid?: string;
                          username: string;
                      };
                  };
                  rmdEvaluationStarted?: boolean;
                  sessionStartPhase?: "starting";
                  thumbnailCacheBustingValue: number;
                  xMetaUsdid?: string;
                  xMid?: string;
                  zeroInterface?: boolean;
                  zeroPhase?: "logged-out"
                  | "authenticated"
                  | "rmd-evaluated";
              };
              startedWithSession: boolean;
          },
      >