naystack 1.9.1 → 1.9.2

package/README.md

@@ -724,6 +724,8 @@ const profile = await InstagramProvider.fetchProfile(accessToken);
 
 const posts = await InstagramProvider.fetchMedia?.(accessToken, { limit: 6 });
 // [{ kind: "video", permalink: "…", likes: 812, comments: null, … }]
+// null instead means the request failed — an account with nothing posted
+// returns []. Cache the empty, retry the null.
 
 InstagramProvider.profileURL(profile.username);
 // "https://instagram.com/…" — so a stored account row links out without the

package/dist/socials/index.cjs.js

@@ -471,7 +471,11 @@ var InstagramProvider = {
       MEDIA_FIELDS,
       options?.limit
     );
-    if (!result?.data) return [];
+    if (!Array.isArray(result?.data)) {
+      if (result?.error)
+        console.error("[naystack] Instagram media:", result.error.message);
+      return null;
+    }
     return result.data.map(toPost);
   }
 };

package/dist/socials/index.esm.js

@@ -415,7 +415,11 @@ var InstagramProvider = {
       MEDIA_FIELDS,
       options?.limit
     );
-    if (!result?.data) return [];
+    if (!Array.isArray(result?.data)) {
+      if (result?.error)
+        console.error("[naystack] Instagram media:", result.error.message);
+      return null;
+    }
     return result.data.map(toPost);
   }
 };

package/dist/socials/instagram/adapter.cjs.js

@@ -266,7 +266,11 @@ var InstagramProvider = {
       MEDIA_FIELDS,
       options?.limit
     );
-    if (!result?.data) return [];
+    if (!Array.isArray(result?.data)) {
+      if (result?.error)
+        console.error("[naystack] Instagram media:", result.error.message);
+      return null;
+    }
     return result.data.map(toPost);
   }
 };

package/dist/socials/instagram/adapter.esm.js

@@ -240,7 +240,11 @@ var InstagramProvider = {
       MEDIA_FIELDS,
       options?.limit
     );
-    if (!result?.data) return [];
+    if (!Array.isArray(result?.data)) {
+      if (result?.error)
+        console.error("[naystack] Instagram media:", result.error.message);
+      return null;
+    }
     return result.data.map(toPost);
   }
 };

package/dist/socials/provider.d.mts

@@ -15,7 +15,7 @@ import { SocialPlatform, SocialTokens, SocialProfile, SocialPost } from './types
  * @property auth.authorizationURL - `state` comes back on the callback; `redirectURI` must match what the platform has registered.
  * @property auth.exchangeCode - Trades the callback `code` for tokens. `platformUserId` is `null` on platforms whose token response carries no id (Google); the route then takes it from `fetchProfile`.
  * @property auth.refresh - Omitted by platforms whose tokens don't expire or can't be refreshed.
- * @property fetchMedia - Omitted by platforms with no content-listing API.
+ * @property fetchMedia - Omitted by platforms with no content-listing API. Resolves to `null` when the request failed and `[]` when the account genuinely has no content — a caller that caches results must not treat an outage as an empty grid.
  * @property profileURL - Public profile link for a handle. Platform knowledge, not a capability, so every adapter has one.
  *
  * @example
@@ -48,7 +48,7 @@ type SocialProvider = {
     profileURL: (username: string) => string;
     fetchMedia?: (accessToken: string, options?: {
         limit?: number;
-    }) => Promise<SocialPost[]>;
+    }) => Promise<SocialPost[] | null>;
 };
 
 export type { SocialProvider };

package/dist/socials/provider.d.ts

@@ -15,7 +15,7 @@ import { SocialPlatform, SocialTokens, SocialProfile, SocialPost } from './types
  * @property auth.authorizationURL - `state` comes back on the callback; `redirectURI` must match what the platform has registered.
  * @property auth.exchangeCode - Trades the callback `code` for tokens. `platformUserId` is `null` on platforms whose token response carries no id (Google); the route then takes it from `fetchProfile`.
  * @property auth.refresh - Omitted by platforms whose tokens don't expire or can't be refreshed.
- * @property fetchMedia - Omitted by platforms with no content-listing API.
+ * @property fetchMedia - Omitted by platforms with no content-listing API. Resolves to `null` when the request failed and `[]` when the account genuinely has no content — a caller that caches results must not treat an outage as an empty grid.
  * @property profileURL - Public profile link for a handle. Platform knowledge, not a capability, so every adapter has one.
  *
  * @example
@@ -48,7 +48,7 @@ type SocialProvider = {
     profileURL: (username: string) => string;
     fetchMedia?: (accessToken: string, options?: {
         limit?: number;
-    }) => Promise<SocialPost[]>;
+    }) => Promise<SocialPost[] | null>;
 };
 
 export type { SocialProvider };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "naystack",
-  "version": "1.9.1",
+  "version": "1.9.2",
   "description": "A stack built with Next + GraphQL + S3 + Auth",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",