naystack 1.9.0 → 1.9.1

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,10 @@ const profile = await InstagramProvider.fetchProfile(accessToken);
 
 const posts = await InstagramProvider.fetchMedia?.(accessToken, { limit: 6 });
 // [{ kind: "video", permalink: "…", likes: 812, comments: 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,

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,

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,

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,

package/dist/socials/provider.d.mts

@@ -16,6 +16,7 @@ import { SocialPlatform, SocialTokens, SocialProfile, SocialPost } from './types
  * @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 profileURL - Public profile link for a handle. Platform knowledge, not a capability, so every adapter has one.
  *
  * @example
  * ```ts
@@ -44,6 +45,7 @@ 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[]>;

package/dist/socials/provider.d.ts

@@ -16,6 +16,7 @@ import { SocialPlatform, SocialTokens, SocialProfile, SocialPost } from './types
  * @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 profileURL - Public profile link for a handle. Platform knowledge, not a capability, so every adapter has one.
  *
  * @example
  * ```ts
@@ -44,6 +45,7 @@ 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[]>;

package/package.json

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