@saketsawrav/instagram-feed 0.1.0 → 0.2.0

package/README.md

@@ -5,6 +5,7 @@ Drop-in Instagram feed for Next.js apps. Fetches recent posts and proxies images
 ## Features
 
 - Fetches posts via Instagram's public web profile API
+- Post captions included out of the box
 - Server-side image proxy (avoids Instagram's cross-origin blocking)
 - In-memory caching with configurable TTL (default: 1 hour)
 - Ready-made Next.js route handler factories
@@ -97,7 +98,7 @@ import { fetchInstagramPosts } from '@saketsawrav/instagram-feed';
 
 const posts = await fetchInstagramPosts({ username: 'your_username', count: 6 });
 console.log(posts);
-// [{ shortcode: 'abc123', thumbnailUrl: 'https://...' }, ...]
+// [{ shortcode: 'abc123', thumbnailUrl: 'https://...', caption: 'Post caption text...' }, ...]
 ```
 
 ### Available exports from `@saketsawrav/instagram-feed`
@@ -107,7 +108,7 @@ console.log(posts);
 | `fetchInstagramPosts()` | Fetch posts for a username (returns `InstagramPost[]`) |
 | `getInstagramImageUrl()`| Get the full-res image URL for a shortcode       |
 | `proxyInstagramImage()` | Fetch and stream an image from Instagram CDN     |
-| `InstagramPost`         | Type: `{ shortcode: string; thumbnailUrl: string }` |
+| `InstagramPost`         | Type: `{ shortcode: string; thumbnailUrl: string; caption: string \| null }` |
 | `InstagramFeedOptions`  | Type: configuration options                      |
 
 ### Available exports from `@saketsawrav/instagram-feed/nextjs`

package/dist/chunk-KW22UH7A.mjs

@@ -0,0 +1,93 @@
+// src/fetcher.ts
+var DEFAULT_COUNT = 9;
+var DEFAULT_CACHE_TTL_MS = 36e5;
+var DEFAULT_IG_APP_ID = "936619743392459";
+var USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36";
+var cacheByUsername = /* @__PURE__ */ new Map();
+function buildHeaders(username, igAppId) {
+  return {
+    "User-Agent": USER_AGENT,
+    "x-ig-app-id": igAppId,
+    Accept: "*/*",
+    "Sec-Fetch-Mode": "cors",
+    "Sec-Fetch-Site": "same-origin",
+    "Sec-Fetch-Dest": "empty",
+    Referer: `https://www.instagram.com/${username}/`
+  };
+}
+async function fetchFromInstagram(username, count, igAppId) {
+  const res = await fetch(
+    `https://www.instagram.com/api/v1/users/web_profile_info/?username=${username}`,
+    { headers: buildHeaders(username, igAppId) }
+  );
+  if (!res.ok) {
+    return { posts: [], imageMap: {}, timestamp: Date.now() };
+  }
+  const json = await res.json();
+  const edges = json?.data?.user?.edge_owner_to_timeline_media?.edges ?? [];
+  const posts = [];
+  const imageMap = {};
+  for (const edge of edges) {
+    const node = edge?.node;
+    if (!node?.shortcode) continue;
+    const thumbnailUrl = node.thumbnail_src ?? node.display_url ?? "";
+    const displayUrl = node.display_url ?? node.thumbnail_src ?? "";
+    imageMap[node.shortcode] = displayUrl;
+    const caption = node.edge_media_to_caption?.edges?.[0]?.node?.text ?? null;
+    if (posts.length < count) {
+      posts.push({ shortcode: node.shortcode, thumbnailUrl, caption });
+    }
+  }
+  return { posts, imageMap, timestamp: Date.now() };
+}
+function getCached(username, cacheTtlMs) {
+  const entry = cacheByUsername.get(username);
+  if (entry && Date.now() - entry.timestamp < cacheTtlMs) return entry;
+  return null;
+}
+async function ensureCache(opts) {
+  const existing = getCached(opts.username, opts.cacheTtlMs);
+  if (existing) return existing;
+  const fresh = await fetchFromInstagram(opts.username, opts.count, opts.igAppId);
+  if (fresh.posts.length > 0) {
+    cacheByUsername.set(opts.username, fresh);
+  }
+  return fresh;
+}
+function resolveOptions(opts) {
+  return {
+    username: opts.username,
+    count: opts.count ?? DEFAULT_COUNT,
+    cacheTtlMs: opts.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS,
+    igAppId: opts.igAppId ?? DEFAULT_IG_APP_ID
+  };
+}
+async function fetchInstagramPosts(opts) {
+  const resolved = resolveOptions(opts);
+  const cached = await ensureCache(resolved);
+  return cached.posts;
+}
+async function getInstagramImageUrl(opts, shortcode) {
+  const resolved = resolveOptions(opts);
+  const cached = await ensureCache(resolved);
+  return cached.imageMap[shortcode] ?? null;
+}
+async function proxyInstagramImage(imageUrl) {
+  const res = await fetch(imageUrl, {
+    headers: {
+      "User-Agent": USER_AGENT,
+      Referer: "https://www.instagram.com/"
+    }
+  });
+  if (!res.ok || !res.body) return null;
+  return {
+    body: res.body,
+    contentType: res.headers.get("content-type") ?? "image/jpeg"
+  };
+}
+
+export {
+  fetchInstagramPosts,
+  getInstagramImageUrl,
+  proxyInstagramImage
+};

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { I as InstagramFeedOptions, a as InstagramPost } from './types-CJuNiTch.mjs';
+import { I as InstagramFeedOptions, a as InstagramPost } from './types-Baezfam3.mjs';
 
 declare function fetchInstagramPosts(opts: InstagramFeedOptions): Promise<InstagramPost[]>;
 declare function getInstagramImageUrl(opts: InstagramFeedOptions, shortcode: string): Promise<string | null>;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { I as InstagramFeedOptions, a as InstagramPost } from './types-CJuNiTch.js';
+import { I as InstagramFeedOptions, a as InstagramPost } from './types-Baezfam3.js';
 
 declare function fetchInstagramPosts(opts: InstagramFeedOptions): Promise<InstagramPost[]>;
 declare function getInstagramImageUrl(opts: InstagramFeedOptions, shortcode: string): Promise<string | null>;

package/dist/index.js

@@ -61,8 +61,9 @@ async function fetchFromInstagram(username, count, igAppId) {
     const thumbnailUrl = node.thumbnail_src ?? node.display_url ?? "";
     const displayUrl = node.display_url ?? node.thumbnail_src ?? "";
     imageMap[node.shortcode] = displayUrl;
+    const caption = node.edge_media_to_caption?.edges?.[0]?.node?.text ?? null;
     if (posts.length < count) {
-      posts.push({ shortcode: node.shortcode, thumbnailUrl });
+      posts.push({ shortcode: node.shortcode, thumbnailUrl, caption });
     }
   }
   return { posts, imageMap, timestamp: Date.now() };

package/dist/index.mjs

@@ -2,7 +2,7 @@ import {
   fetchInstagramPosts,
   getInstagramImageUrl,
   proxyInstagramImage
-} from "./chunk-QEYBYUKH.mjs";
+} from "./chunk-KW22UH7A.mjs";
 export {
   fetchInstagramPosts,
   getInstagramImageUrl,

package/dist/nextjs.d.mts

@@ -1,4 +1,4 @@
-import { I as InstagramFeedOptions, a as InstagramPost } from './types-CJuNiTch.mjs';
+import { I as InstagramFeedOptions, a as InstagramPost } from './types-Baezfam3.mjs';
 import { NextResponse, NextRequest } from 'next/server';
 
 declare function createFeedHandler(opts: InstagramFeedOptions): () => Promise<NextResponse<InstagramPost[]>>;

package/dist/nextjs.d.ts

@@ -1,4 +1,4 @@
-import { I as InstagramFeedOptions, a as InstagramPost } from './types-CJuNiTch.js';
+import { I as InstagramFeedOptions, a as InstagramPost } from './types-Baezfam3.js';
 import { NextResponse, NextRequest } from 'next/server';
 
 declare function createFeedHandler(opts: InstagramFeedOptions): () => Promise<NextResponse<InstagramPost[]>>;

package/dist/nextjs.js

@@ -63,8 +63,9 @@ async function fetchFromInstagram(username, count, igAppId) {
     const thumbnailUrl = node.thumbnail_src ?? node.display_url ?? "";
     const displayUrl = node.display_url ?? node.thumbnail_src ?? "";
     imageMap[node.shortcode] = displayUrl;
+    const caption = node.edge_media_to_caption?.edges?.[0]?.node?.text ?? null;
     if (posts.length < count) {
-      posts.push({ shortcode: node.shortcode, thumbnailUrl });
+      posts.push({ shortcode: node.shortcode, thumbnailUrl, caption });
     }
   }
   return { posts, imageMap, timestamp: Date.now() };

package/dist/nextjs.mjs

@@ -2,7 +2,7 @@ import {
   fetchInstagramPosts,
   getInstagramImageUrl,
   proxyInstagramImage
-} from "./chunk-QEYBYUKH.mjs";
+} from "./chunk-KW22UH7A.mjs";
 
 // src/handlers.ts
 import { NextResponse } from "next/server";

package/dist/types-Baezfam3.d.mts

@@ -0,0 +1,13 @@
+interface InstagramPost {
+    shortcode: string;
+    thumbnailUrl: string;
+    caption: string | null;
+}
+interface InstagramFeedOptions {
+    username: string;
+    count?: number;
+    cacheTtlMs?: number;
+    igAppId?: string;
+}
+
+export type { InstagramFeedOptions as I, InstagramPost as a };

package/dist/types-Baezfam3.d.ts

@@ -0,0 +1,13 @@
+interface InstagramPost {
+    shortcode: string;
+    thumbnailUrl: string;
+    caption: string | null;
+}
+interface InstagramFeedOptions {
+    username: string;
+    count?: number;
+    cacheTtlMs?: number;
+    igAppId?: string;
+}
+
+export type { InstagramFeedOptions as I, InstagramPost as a };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saketsawrav/instagram-feed",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Drop-in Instagram feed for Next.js — fetches posts and proxies images server-side, no third-party widgets",
   "main": "dist/index.js",
   "module": "dist/index.mjs",