naystack 1.9.0 → 1.9.2

package/README.md

@@ -713,7 +713,8 @@ constant so the generalized pieces pick it up for free.
 A provider is a plain object with no per-instance state — import the constant, no
 construction. Capability is method presence: a platform that can't refresh tokens
 omits `refresh`, one with no content-listing API omits `fetchMedia`, and callers
-narrow with a plain `if`.
+narrow with a plain `if`. Platform *knowledge* is not a capability, so it is
+always there: `platform` and `profileURL(username)` are required of every adapter.
 
 ```typescript
 import { InstagramProvider } from "naystack/socials";
@@ -723,6 +724,12 @@ 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
+// consumer keeping its own per-platform URL table
 ```
 
 Every metric on a `SocialPost` is `number | null`, and `null` always means *the

package/dist/socials/index.cjs.js

@@ -444,6 +444,7 @@ var InstagramProvider = {
       };
     }
   },
+  profileURL: (username) => `https://instagram.com/${username}`,
   fetchProfile: async (accessToken) => {
     const user = await getInstagramUser(
       accessToken,
@@ -470,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

@@ -388,6 +388,7 @@ var InstagramProvider = {
       };
     }
   },
+  profileURL: (username) => `https://instagram.com/${username}`,
   fetchProfile: async (accessToken) => {
     const user = await getInstagramUser(
       accessToken,
@@ -414,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

@@ -239,6 +239,7 @@ var InstagramProvider = {
       };
     }
   },
+  profileURL: (username) => `https://instagram.com/${username}`,
   fetchProfile: async (accessToken) => {
     const user = await getInstagramUser(
       accessToken,
@@ -265,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

@@ -213,6 +213,7 @@ var InstagramProvider = {
       };
     }
   },
+  profileURL: (username) => `https://instagram.com/${username}`,
   fetchProfile: async (accessToken) => {
     const user = await getInstagramUser(
       accessToken,
@@ -239,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,8 @@ 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
  * ```ts
@@ -44,9 +45,10 @@ type SocialProvider = {
         refresh?: (tokens: SocialTokens) => Promise<SocialTokens | null>;
     };
     fetchProfile: (accessToken: string) => Promise<SocialProfile | null>;
+    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,8 @@ 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
  * ```ts
@@ -44,9 +45,10 @@ type SocialProvider = {
         refresh?: (tokens: SocialTokens) => Promise<SocialTokens | null>;
     };
     fetchProfile: (accessToken: string) => Promise<SocialProfile | null>;
+    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.0",
+  "version": "1.9.2",
   "description": "A stack built with Next + GraphQL + S3 + Auth",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",