naystack 1.8.19 → 1.9.0

package/dist/socials/instagram/adapter.d.mts

@@ -0,0 +1,30 @@
+import { SocialProvider } from '../provider.mjs';
+import '../types.mjs';
+
+/**
+ * Instagram as a normalized {@link SocialProvider}.
+ *
+ * A ready-made singleton — import and call it, there is nothing to construct.
+ * Credentials are read from the environment inside the `auth` methods, so
+ * `fetchProfile` and `fetchMedia` need only a token and work in a process that
+ * has no Instagram OAuth configuration at all.
+ *
+ * Wraps the platform-specific helpers rather than replacing them:
+ * {@link getInstagramUser} and {@link getInstagramMedia} remain the way to reach
+ * fields this normalization drops.
+ *
+ * Requires env vars for `auth` only: `INSTAGRAM_CLIENT_ID`, `INSTAGRAM_CLIENT_SECRET`.
+ *
+ * @example
+ * ```ts
+ * import { InstagramProvider } from "naystack/socials";
+ *
+ * const profile = await InstagramProvider.fetchProfile(accessToken);
+ * const posts = await InstagramProvider.fetchMedia?.(accessToken, { limit: 6 });
+ * ```
+ *
+ * @category Socials
+ */
+declare const InstagramProvider: SocialProvider;
+
+export { InstagramProvider };

package/dist/socials/instagram/adapter.d.ts

@@ -0,0 +1,30 @@
+import { SocialProvider } from '../provider.js';
+import '../types.js';
+
+/**
+ * Instagram as a normalized {@link SocialProvider}.
+ *
+ * A ready-made singleton — import and call it, there is nothing to construct.
+ * Credentials are read from the environment inside the `auth` methods, so
+ * `fetchProfile` and `fetchMedia` need only a token and work in a process that
+ * has no Instagram OAuth configuration at all.
+ *
+ * Wraps the platform-specific helpers rather than replacing them:
+ * {@link getInstagramUser} and {@link getInstagramMedia} remain the way to reach
+ * fields this normalization drops.
+ *
+ * Requires env vars for `auth` only: `INSTAGRAM_CLIENT_ID`, `INSTAGRAM_CLIENT_SECRET`.
+ *
+ * @example
+ * ```ts
+ * import { InstagramProvider } from "naystack/socials";
+ *
+ * const profile = await InstagramProvider.fetchProfile(accessToken);
+ * const posts = await InstagramProvider.fetchMedia?.(accessToken, { limit: 6 });
+ * ```
+ *
+ * @category Socials
+ */
+declare const InstagramProvider: SocialProvider;
+
+export { InstagramProvider };

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

@@ -0,0 +1,248 @@
+// src/env.ts
+var EXTRA_ENV = globalThis.__NAYSTACK_ENV__ || (globalThis.__NAYSTACK_ENV__ = {});
+var getEnvValue = (key) => {
+  switch (key) {
+    case "NEXT_PUBLIC_GRAPHQL_ENDPOINT" /* NEXT_PUBLIC_GRAPHQL_ENDPOINT */:
+      return process.env.NEXT_PUBLIC_GRAPHQL_ENDPOINT || EXTRA_ENV.GRAPHQL_ENDPOINT;
+    case "NEXT_PUBLIC_EMAIL_AUTH_ENDPOINT" /* NEXT_PUBLIC_EMAIL_AUTH_ENDPOINT */:
+      return process.env.NEXT_PUBLIC_EMAIL_AUTH_ENDPOINT || EXTRA_ENV.EMAIL_AUTH_ENDPOINT;
+    case "NEXT_PUBLIC_GOOGLE_AUTH_ENDPOINT" /* NEXT_PUBLIC_GOOGLE_AUTH_ENDPOINT */:
+      return process.env.NEXT_PUBLIC_GOOGLE_AUTH_ENDPOINT || EXTRA_ENV.GOOGLE_AUTH_ENDPOINT;
+    case "NEXT_PUBLIC_SOCIAL_AUTH_ENDPOINT" /* NEXT_PUBLIC_SOCIAL_AUTH_ENDPOINT */:
+      return process.env.NEXT_PUBLIC_SOCIAL_AUTH_ENDPOINT || EXTRA_ENV.SOCIAL_AUTH_ENDPOINT;
+    case "NEXT_PUBLIC_FILE_ENDPOINT" /* NEXT_PUBLIC_FILE_ENDPOINT */:
+      return process.env.NEXT_PUBLIC_FILE_ENDPOINT || EXTRA_ENV.FILE_ENDPOINT;
+    case "NEXT_PUBLIC_BASE_URL" /* NEXT_PUBLIC_BASE_URL */:
+      return process.env.NEXT_PUBLIC_BASE_URL || EXTRA_ENV.BASE_URL;
+    case "REFRESH_KEY" /* REFRESH_KEY */:
+      return process.env.REFRESH_KEY;
+    case "SIGNING_KEY" /* SIGNING_KEY */:
+      return process.env.SIGNING_KEY;
+    case "INSTAGRAM_CLIENT_SECRET" /* INSTAGRAM_CLIENT_SECRET */:
+      return process.env.INSTAGRAM_CLIENT_SECRET;
+    case "INSTAGRAM_CLIENT_ID" /* INSTAGRAM_CLIENT_ID */:
+      return process.env.INSTAGRAM_CLIENT_ID;
+    case "GOOGLE_CLIENT_SECRET" /* GOOGLE_CLIENT_SECRET */:
+      return process.env.GOOGLE_CLIENT_SECRET;
+    case "GOOGLE_CLIENT_ID" /* GOOGLE_CLIENT_ID */:
+      return process.env.GOOGLE_CLIENT_ID;
+    case "TURNSTILE_KEY" /* TURNSTILE_KEY */:
+      return process.env.TURNSTILE_KEY;
+    case "S3_ACCESS_KEY_ID" /* S3_ACCESS_KEY_ID */:
+      return process.env.S3_ACCESS_KEY_ID;
+    case "S3_ACCESS_KEY_SECRET" /* S3_ACCESS_KEY_SECRET */:
+      return process.env.S3_ACCESS_KEY_SECRET;
+    case "S3_REGION" /* S3_REGION */:
+      return process.env.S3_REGION;
+    case "S3_BUCKET" /* S3_BUCKET */:
+      return process.env.S3_BUCKET;
+    case "NODE_ENV" /* NODE_ENV */:
+      return process.env.NODE_ENV;
+    default:
+      return process.env[key];
+  }
+};
+function getEnv(key, skipCheck) {
+  const value = getEnvValue(key);
+  if (!skipCheck && !value) throw new Error(`${key} is not defined`);
+  return value;
+}
+
+// src/socials/instagram/auth.ts
+var getInstagramAuthorizationURL = (state, redirectURI, scopes = ["instagram_business_basic"]) => `https://www.instagram.com/oauth/authorize/?client_id=${getEnv(
+  "INSTAGRAM_CLIENT_ID" /* INSTAGRAM_CLIENT_ID */
+)}&response_type=code&enable_fb_login=0&force_authentication=1&scope=${scopes.join(",")}&state=${state}&redirect_uri=${redirectURI}#weblink`;
+async function getLongLivedInstagramToken(code, redirectURI) {
+  const formData = new FormData();
+  formData.set("client_id", getEnv("INSTAGRAM_CLIENT_ID" /* INSTAGRAM_CLIENT_ID */));
+  formData.set("client_secret", getEnv("INSTAGRAM_CLIENT_SECRET" /* INSTAGRAM_CLIENT_SECRET */));
+  formData.set("grant_type", "authorization_code");
+  formData.set("redirect_uri", redirectURI);
+  formData.set("code", code);
+  const shortRes = await fetch("https://api.instagram.com/oauth/access_token", {
+    method: "POST",
+    body: formData
+  });
+  if (!shortRes.ok) return void 0;
+  const shortResData = await shortRes.json();
+  if (!shortResData.access_token) return void 0;
+  const longRes = await fetch(
+    `https://graph.instagram.com/access_token?grant_type=ig_exchange_token&access_token=${shortResData.access_token}&client_secret=${getEnv("INSTAGRAM_CLIENT_SECRET" /* INSTAGRAM_CLIENT_SECRET */)}`
+  );
+  if (!longRes.ok) return void 0;
+  const longResData = await longRes.json();
+  return {
+    accessToken: longResData.access_token,
+    userId: shortResData.user_id,
+    expiresIn: longResData.expires_in,
+    permissions: shortResData.permissions
+  };
+}
+async function refreshInstagramAccessToken(token) {
+  const request = await fetch(
+    `https://graph.instagram.com/refresh_access_token?grant_type=ig_refresh_token&access_token=${token}`
+  );
+  const response = await request.json();
+  if (!response.access_token) return void 0;
+  return {
+    accessToken: response.access_token,
+    expiresIn: response.expires_in
+  };
+}
+
+// src/socials/meta/request.ts
+function createGraphClient(baseURL) {
+  const buildURL = (token, path, params = {}) => {
+    const search = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+      if (value !== void 0) search.set(key, String(value));
+    }
+    search.set("access_token", token);
+    return `${baseURL}/${path}?${search.toString()}`;
+  };
+  const request = async (token, path, options = {}) => {
+    const response = await fetch(buildURL(token, path, options.params), {
+      method: options.method || (options.body ? "POST" : "GET"),
+      headers: {
+        Authorization: `Bearer ${token}`,
+        ...options.body ? { "Content-Type": "application/json" } : {}
+      },
+      ...options.body ? { body: JSON.stringify(options.body) } : {}
+    });
+    return response.json().catch(() => null);
+  };
+  return { buildURL, request };
+}
+
+// src/socials/instagram/utils.ts
+var client = createGraphClient("https://graph.instagram.com/v23.0");
+var getInstagramData = client.request;
+
+// src/socials/instagram/getters.ts
+var getInstagramUser = (token, id, fields) => {
+  return getInstagramData(token, id || "me", {
+    params: {
+      fields: fields ? fields.join(",") : "username,followers_count,media_count"
+    }
+  });
+};
+var getInstagramMedia = (token, fields, limit = 12) => {
+  return getInstagramData(token, "me/media", {
+    params: {
+      fields: fields ? fields.join(",") : "like_count,comments_count,permalink",
+      limit
+    }
+  });
+};
+
+// src/socials/instagram/adapter.ts
+var PROFILE_FIELDS = [
+  "id",
+  "user_id",
+  "username",
+  "name",
+  "profile_picture_url",
+  "followers_count",
+  "media_count"
+];
+var MEDIA_FIELDS = [
+  "id",
+  "caption",
+  "media_type",
+  "media_url",
+  "permalink",
+  "thumbnail_url",
+  "timestamp",
+  "like_count",
+  "comments_count"
+];
+var expiresAt = (seconds) => seconds ? new Date(Date.now() + seconds * 1e3) : void 0;
+function toKind(mediaType) {
+  if (mediaType === "VIDEO") return "video" /* Video */;
+  if (mediaType === "CAROUSEL_ALBUM") return "carousel" /* Carousel */;
+  return "image" /* Image */;
+}
+function toPost(media) {
+  const kind = toKind(media.media_type);
+  return {
+    platform: "instagram" /* Instagram */,
+    platformMediaId: media.id,
+    permalink: media.permalink,
+    // A video's `media_url` is the .mp4 itself, so it is never a stand-in for a
+    // missing poster frame — better no thumbnail than one that can't render.
+    thumbnail: media.thumbnail_url ?? (kind === "video" /* Video */ ? null : media.media_url ?? null),
+    mediaURL: media.media_url ?? null,
+    caption: media.caption ?? null,
+    kind,
+    publishedAt: media.timestamp,
+    likes: media.like_count ?? null,
+    comments: media.comments_count ?? null,
+    // Both need the Insights API; the basic media fields carry neither.
+    views: null,
+    shares: null,
+    metadata: {}
+  };
+}
+var InstagramProvider = {
+  platform: "instagram" /* Instagram */,
+  auth: {
+    authorizationURL: ({ state, redirectURI, scopes }) => getInstagramAuthorizationURL(
+      state,
+      redirectURI,
+      scopes
+    ),
+    exchangeCode: async ({ code, redirectURI }) => {
+      const result = await getLongLivedInstagramToken(code, redirectURI);
+      if (!result) {
+        console.error("[naystack] Instagram code exchange returned no token");
+        return null;
+      }
+      return {
+        accessToken: result.accessToken,
+        platformUserId: result.userId || null,
+        expiresAt: expiresAt(result.expiresIn),
+        scopes: result.permissions
+      };
+    },
+    refresh: async ({ accessToken }) => {
+      const refreshed = await refreshInstagramAccessToken(accessToken);
+      if (!refreshed) return null;
+      return {
+        accessToken: refreshed.accessToken,
+        expiresAt: expiresAt(refreshed.expiresIn)
+      };
+    }
+  },
+  fetchProfile: async (accessToken) => {
+    const user = await getInstagramUser(
+      accessToken,
+      void 0,
+      PROFILE_FIELDS
+    );
+    if (!user?.username) return null;
+    return {
+      platform: "instagram" /* Instagram */,
+      // `user_id` is what the OAuth exchange hands back, so preferring it keeps
+      // one account's id identical however it was read.
+      platformUserId: user.user_id || user.id || null,
+      username: user.username,
+      displayName: user.name ?? null,
+      avatar: user.profile_picture_url ?? null,
+      followers: user.followers_count ?? 0,
+      contentCount: user.media_count ?? 0,
+      metadata: {}
+    };
+  },
+  fetchMedia: async (accessToken, options) => {
+    const result = await getInstagramMedia(
+      accessToken,
+      MEDIA_FIELDS,
+      options?.limit
+    );
+    if (!result?.data) return [];
+    return result.data.map(toPost);
+  }
+};
+export {
+  InstagramProvider
+};

package/dist/{auth/instagram/utils.cjs.js → socials/instagram/auth.cjs.js}

@@ -17,14 +17,14 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/auth/instagram/utils.ts
-var utils_exports = {};
-__export(utils_exports, {
+// src/socials/instagram/auth.ts
+var auth_exports = {};
+__export(auth_exports, {
   getInstagramAuthorizationURL: () => getInstagramAuthorizationURL,
-  getLongLivedToken: () => getLongLivedToken,
-  getRefreshedInstagramAccessToken: () => getRefreshedInstagramAccessToken
+  getLongLivedInstagramToken: () => getLongLivedInstagramToken,
+  refreshInstagramAccessToken: () => refreshInstagramAccessToken
 });
-module.exports = __toCommonJS(utils_exports);
+module.exports = __toCommonJS(auth_exports);
 
 // src/env.ts
 var EXTRA_ENV = globalThis.__NAYSTACK_ENV__ || (globalThis.__NAYSTACK_ENV__ = {});
@@ -36,8 +36,8 @@ var getEnvValue = (key) => {
       return process.env.NEXT_PUBLIC_EMAIL_AUTH_ENDPOINT || EXTRA_ENV.EMAIL_AUTH_ENDPOINT;
     case "NEXT_PUBLIC_GOOGLE_AUTH_ENDPOINT" /* NEXT_PUBLIC_GOOGLE_AUTH_ENDPOINT */:
       return process.env.NEXT_PUBLIC_GOOGLE_AUTH_ENDPOINT || EXTRA_ENV.GOOGLE_AUTH_ENDPOINT;
-    case "NEXT_PUBLIC_INSTAGRAM_AUTH_ENDPOINT" /* NEXT_PUBLIC_INSTAGRAM_AUTH_ENDPOINT */:
-      return process.env.NEXT_PUBLIC_INSTAGRAM_AUTH_ENDPOINT || EXTRA_ENV.INSTAGRAM_AUTH_ENDPOINT;
+    case "NEXT_PUBLIC_SOCIAL_AUTH_ENDPOINT" /* NEXT_PUBLIC_SOCIAL_AUTH_ENDPOINT */:
+      return process.env.NEXT_PUBLIC_SOCIAL_AUTH_ENDPOINT || EXTRA_ENV.SOCIAL_AUTH_ENDPOINT;
     case "NEXT_PUBLIC_FILE_ENDPOINT" /* NEXT_PUBLIC_FILE_ENDPOINT */:
       return process.env.NEXT_PUBLIC_FILE_ENDPOINT || EXTRA_ENV.FILE_ENDPOINT;
     case "NEXT_PUBLIC_BASE_URL" /* NEXT_PUBLIC_BASE_URL */:
@@ -76,48 +76,50 @@ function getEnv(key, skipCheck) {
   return value;
 }
 
-// src/auth/instagram/utils.ts
-async function getRefreshedInstagramAccessToken(token) {
-  const request = await fetch(
-    `https://graph.instagram.com/refresh_access_token?grant_type=ig_refresh_token&access_token=${token}`
-  );
-  const response = await request.json();
-  return response.access_token;
-}
-async function getLongLivedToken(code, redirectURL, clientId, clientSecret) {
+// src/socials/instagram/auth.ts
+var getInstagramAuthorizationURL = (state, redirectURI, scopes = ["instagram_business_basic"]) => `https://www.instagram.com/oauth/authorize/?client_id=${getEnv(
+  "INSTAGRAM_CLIENT_ID" /* INSTAGRAM_CLIENT_ID */
+)}&response_type=code&enable_fb_login=0&force_authentication=1&scope=${scopes.join(",")}&state=${state}&redirect_uri=${redirectURI}#weblink`;
+async function getLongLivedInstagramToken(code, redirectURI) {
   const formData = new FormData();
-  formData.set("client_id", clientId);
-  formData.set("client_secret", clientSecret);
+  formData.set("client_id", getEnv("INSTAGRAM_CLIENT_ID" /* INSTAGRAM_CLIENT_ID */));
+  formData.set("client_secret", getEnv("INSTAGRAM_CLIENT_SECRET" /* INSTAGRAM_CLIENT_SECRET */));
   formData.set("grant_type", "authorization_code");
-  formData.set("redirect_uri", redirectURL);
+  formData.set("redirect_uri", redirectURI);
   formData.set("code", code);
   const shortRes = await fetch("https://api.instagram.com/oauth/access_token", {
     method: "POST",
     body: formData
   });
-  if (shortRes.ok) {
-    const shortResData = await shortRes.json();
-    if (shortResData.access_token) {
-      const shortLivedToken = shortResData.access_token;
-      const longRes = await fetch(
-        `https://graph.instagram.com/access_token?grant_type=ig_exchange_token&access_token=${shortLivedToken}&client_secret=${getEnv("INSTAGRAM_CLIENT_SECRET" /* INSTAGRAM_CLIENT_SECRET */)}`
-      );
-      if (longRes.ok) {
-        const longResData = await longRes.json();
-        return {
-          accessToken: longResData.access_token,
-          userId: shortResData.user_id
-        };
-      }
-    }
-  }
+  if (!shortRes.ok) return void 0;
+  const shortResData = await shortRes.json();
+  if (!shortResData.access_token) return void 0;
+  const longRes = await fetch(
+    `https://graph.instagram.com/access_token?grant_type=ig_exchange_token&access_token=${shortResData.access_token}&client_secret=${getEnv("INSTAGRAM_CLIENT_SECRET" /* INSTAGRAM_CLIENT_SECRET */)}`
+  );
+  if (!longRes.ok) return void 0;
+  const longResData = await longRes.json();
+  return {
+    accessToken: longResData.access_token,
+    userId: shortResData.user_id,
+    expiresIn: longResData.expires_in,
+    permissions: shortResData.permissions
+  };
+}
+async function refreshInstagramAccessToken(token) {
+  const request = await fetch(
+    `https://graph.instagram.com/refresh_access_token?grant_type=ig_refresh_token&access_token=${token}`
+  );
+  const response = await request.json();
+  if (!response.access_token) return void 0;
+  return {
+    accessToken: response.access_token,
+    expiresIn: response.expires_in
+  };
 }
-var getInstagramAuthorizationURL = (token, scopes = ["instagram_business_basic"]) => `https://www.instagram.com/oauth/authorize/?client_id=${getEnv(
-  "INSTAGRAM_CLIENT_ID" /* INSTAGRAM_CLIENT_ID */
-)}&response_type=code&enable_fb_login=0&force_authentication=1&scope=${scopes.join(",")}&state=${token}&redirect_uri=${getEnv("NEXT_PUBLIC_INSTAGRAM_AUTH_ENDPOINT" /* NEXT_PUBLIC_INSTAGRAM_AUTH_ENDPOINT */)}#weblink`;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   getInstagramAuthorizationURL,
-  getLongLivedToken,
-  getRefreshedInstagramAccessToken
+  getLongLivedInstagramToken,
+  refreshInstagramAccessToken
 });

package/dist/socials/instagram/auth.d.mts

@@ -0,0 +1,52 @@
+/**
+ * Permissions requestable during Instagram Login OAuth. `instagram_business_basic`
+ * is enough to read a profile; publishing needs `instagram_business_content_publish`.
+ *
+ * Widening the scopes only affects users who authorize afterwards — tokens already
+ * stored keep the permissions they were granted, so existing users must reconnect.
+ *
+ * @category Socials
+ */
+type InstagramScope = "instagram_business_basic" | "instagram_business_content_publish" | "instagram_business_manage_messages" | "instagram_business_manage_comments" | "instagram_business_manage_insights";
+/**
+ * Builds the Instagram OAuth authorization URL.
+ *
+ * **Server-only** — reads the non-public `INSTAGRAM_CLIENT_ID`. The client id still
+ * ends up in the URL the browser follows; it is simply built here rather than
+ * shipped in the client bundle.
+ *
+ * @param state - Passed back by Instagram on the callback; typically the logged-in user's access token.
+ * @param redirectURI - Where Instagram sends the user back. Must match a URI registered with Meta verbatim.
+ * @param scopes - Default: `["instagram_business_basic"]`.
+ *
+ * @category Socials
+ */
+declare const getInstagramAuthorizationURL: (state: string, redirectURI: string, scopes?: InstagramScope[]) => string;
+/**
+ * Exchanges an OAuth code for a long-lived Instagram access token.
+ *
+ * @param code - Authorization code from the callback.
+ * @param redirectURI - The same URI used to obtain the code.
+ * @returns `{ accessToken, userId, expiresIn, permissions }`, or `undefined` if either exchange failed.
+ *
+ * @category Socials
+ */
+declare function getLongLivedInstagramToken(code: string, redirectURI: string): Promise<{
+    accessToken: string;
+    userId: string | undefined;
+    expiresIn: number;
+    permissions: string[] | undefined;
+} | undefined>;
+/**
+ * Refreshes a long-lived Instagram token.
+ *
+ * @returns `{ accessToken, expiresIn }` (seconds), or `undefined` if the refresh failed.
+ *
+ * @category Socials
+ */
+declare function refreshInstagramAccessToken(token: string): Promise<{
+    accessToken: string;
+    expiresIn: number | undefined;
+} | undefined>;
+
+export { type InstagramScope, getInstagramAuthorizationURL, getLongLivedInstagramToken, refreshInstagramAccessToken };

package/dist/socials/instagram/auth.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Permissions requestable during Instagram Login OAuth. `instagram_business_basic`
+ * is enough to read a profile; publishing needs `instagram_business_content_publish`.
+ *
+ * Widening the scopes only affects users who authorize afterwards — tokens already
+ * stored keep the permissions they were granted, so existing users must reconnect.
+ *
+ * @category Socials
+ */
+type InstagramScope = "instagram_business_basic" | "instagram_business_content_publish" | "instagram_business_manage_messages" | "instagram_business_manage_comments" | "instagram_business_manage_insights";
+/**
+ * Builds the Instagram OAuth authorization URL.
+ *
+ * **Server-only** — reads the non-public `INSTAGRAM_CLIENT_ID`. The client id still
+ * ends up in the URL the browser follows; it is simply built here rather than
+ * shipped in the client bundle.
+ *
+ * @param state - Passed back by Instagram on the callback; typically the logged-in user's access token.
+ * @param redirectURI - Where Instagram sends the user back. Must match a URI registered with Meta verbatim.
+ * @param scopes - Default: `["instagram_business_basic"]`.
+ *
+ * @category Socials
+ */
+declare const getInstagramAuthorizationURL: (state: string, redirectURI: string, scopes?: InstagramScope[]) => string;
+/**
+ * Exchanges an OAuth code for a long-lived Instagram access token.
+ *
+ * @param code - Authorization code from the callback.
+ * @param redirectURI - The same URI used to obtain the code.
+ * @returns `{ accessToken, userId, expiresIn, permissions }`, or `undefined` if either exchange failed.
+ *
+ * @category Socials
+ */
+declare function getLongLivedInstagramToken(code: string, redirectURI: string): Promise<{
+    accessToken: string;
+    userId: string | undefined;
+    expiresIn: number;
+    permissions: string[] | undefined;
+} | undefined>;
+/**
+ * Refreshes a long-lived Instagram token.
+ *
+ * @returns `{ accessToken, expiresIn }` (seconds), or `undefined` if the refresh failed.
+ *
+ * @category Socials
+ */
+declare function refreshInstagramAccessToken(token: string): Promise<{
+    accessToken: string;
+    expiresIn: number | undefined;
+} | undefined>;
+
+export { type InstagramScope, getInstagramAuthorizationURL, getLongLivedInstagramToken, refreshInstagramAccessToken };

package/dist/{auth/instagram/utils.esm.js → socials/instagram/auth.esm.js}

@@ -8,8 +8,8 @@ var getEnvValue = (key) => {
       return process.env.NEXT_PUBLIC_EMAIL_AUTH_ENDPOINT || EXTRA_ENV.EMAIL_AUTH_ENDPOINT;
     case "NEXT_PUBLIC_GOOGLE_AUTH_ENDPOINT" /* NEXT_PUBLIC_GOOGLE_AUTH_ENDPOINT */:
       return process.env.NEXT_PUBLIC_GOOGLE_AUTH_ENDPOINT || EXTRA_ENV.GOOGLE_AUTH_ENDPOINT;
-    case "NEXT_PUBLIC_INSTAGRAM_AUTH_ENDPOINT" /* NEXT_PUBLIC_INSTAGRAM_AUTH_ENDPOINT */:
-      return process.env.NEXT_PUBLIC_INSTAGRAM_AUTH_ENDPOINT || EXTRA_ENV.INSTAGRAM_AUTH_ENDPOINT;
+    case "NEXT_PUBLIC_SOCIAL_AUTH_ENDPOINT" /* NEXT_PUBLIC_SOCIAL_AUTH_ENDPOINT */:
+      return process.env.NEXT_PUBLIC_SOCIAL_AUTH_ENDPOINT || EXTRA_ENV.SOCIAL_AUTH_ENDPOINT;
     case "NEXT_PUBLIC_FILE_ENDPOINT" /* NEXT_PUBLIC_FILE_ENDPOINT */:
       return process.env.NEXT_PUBLIC_FILE_ENDPOINT || EXTRA_ENV.FILE_ENDPOINT;
     case "NEXT_PUBLIC_BASE_URL" /* NEXT_PUBLIC_BASE_URL */:
@@ -48,47 +48,49 @@ function getEnv(key, skipCheck) {
   return value;
 }
 
-// src/auth/instagram/utils.ts
-async function getRefreshedInstagramAccessToken(token) {
-  const request = await fetch(
-    `https://graph.instagram.com/refresh_access_token?grant_type=ig_refresh_token&access_token=${token}`
-  );
-  const response = await request.json();
-  return response.access_token;
-}
-async function getLongLivedToken(code, redirectURL, clientId, clientSecret) {
+// src/socials/instagram/auth.ts
+var getInstagramAuthorizationURL = (state, redirectURI, scopes = ["instagram_business_basic"]) => `https://www.instagram.com/oauth/authorize/?client_id=${getEnv(
+  "INSTAGRAM_CLIENT_ID" /* INSTAGRAM_CLIENT_ID */
+)}&response_type=code&enable_fb_login=0&force_authentication=1&scope=${scopes.join(",")}&state=${state}&redirect_uri=${redirectURI}#weblink`;
+async function getLongLivedInstagramToken(code, redirectURI) {
   const formData = new FormData();
-  formData.set("client_id", clientId);
-  formData.set("client_secret", clientSecret);
+  formData.set("client_id", getEnv("INSTAGRAM_CLIENT_ID" /* INSTAGRAM_CLIENT_ID */));
+  formData.set("client_secret", getEnv("INSTAGRAM_CLIENT_SECRET" /* INSTAGRAM_CLIENT_SECRET */));
   formData.set("grant_type", "authorization_code");
-  formData.set("redirect_uri", redirectURL);
+  formData.set("redirect_uri", redirectURI);
   formData.set("code", code);
   const shortRes = await fetch("https://api.instagram.com/oauth/access_token", {
     method: "POST",
     body: formData
   });
-  if (shortRes.ok) {
-    const shortResData = await shortRes.json();
-    if (shortResData.access_token) {
-      const shortLivedToken = shortResData.access_token;
-      const longRes = await fetch(
-        `https://graph.instagram.com/access_token?grant_type=ig_exchange_token&access_token=${shortLivedToken}&client_secret=${getEnv("INSTAGRAM_CLIENT_SECRET" /* INSTAGRAM_CLIENT_SECRET */)}`
-      );
-      if (longRes.ok) {
-        const longResData = await longRes.json();
-        return {
-          accessToken: longResData.access_token,
-          userId: shortResData.user_id
-        };
-      }
-    }
-  }
+  if (!shortRes.ok) return void 0;
+  const shortResData = await shortRes.json();
+  if (!shortResData.access_token) return void 0;
+  const longRes = await fetch(
+    `https://graph.instagram.com/access_token?grant_type=ig_exchange_token&access_token=${shortResData.access_token}&client_secret=${getEnv("INSTAGRAM_CLIENT_SECRET" /* INSTAGRAM_CLIENT_SECRET */)}`
+  );
+  if (!longRes.ok) return void 0;
+  const longResData = await longRes.json();
+  return {
+    accessToken: longResData.access_token,
+    userId: shortResData.user_id,
+    expiresIn: longResData.expires_in,
+    permissions: shortResData.permissions
+  };
+}
+async function refreshInstagramAccessToken(token) {
+  const request = await fetch(
+    `https://graph.instagram.com/refresh_access_token?grant_type=ig_refresh_token&access_token=${token}`
+  );
+  const response = await request.json();
+  if (!response.access_token) return void 0;
+  return {
+    accessToken: response.access_token,
+    expiresIn: response.expires_in
+  };
 }
-var getInstagramAuthorizationURL = (token, scopes = ["instagram_business_basic"]) => `https://www.instagram.com/oauth/authorize/?client_id=${getEnv(
-  "INSTAGRAM_CLIENT_ID" /* INSTAGRAM_CLIENT_ID */
-)}&response_type=code&enable_fb_login=0&force_authentication=1&scope=${scopes.join(",")}&state=${token}&redirect_uri=${getEnv("NEXT_PUBLIC_INSTAGRAM_AUTH_ENDPOINT" /* NEXT_PUBLIC_INSTAGRAM_AUTH_ENDPOINT */)}#weblink`;
 export {
   getInstagramAuthorizationURL,
-  getLongLivedToken,
-  getRefreshedInstagramAccessToken
+  getLongLivedInstagramToken,
+  refreshInstagramAccessToken
 };

package/dist/socials/instagram/getters.d.mts

@@ -1,6 +1,7 @@
 import { GraphError, ContainerState } from '../meta/types.mjs';
 import { InstagramConversation, InstagramMedia, InstagramMessage, InstagramUser } from './types.mjs';
 import '../meta/container.mjs';
+import '../utils/poll.mjs';
 
 /**
  * Fetches an Instagram user's profile. Defaults to the authenticated user (`"me"`).

package/dist/socials/instagram/getters.d.ts

@@ -1,6 +1,7 @@
 import { GraphError, ContainerState } from '../meta/types.js';
 import { InstagramConversation, InstagramMedia, InstagramMessage, InstagramUser } from './types.js';
 import '../meta/container.js';
+import '../utils/poll.js';
 
 /**
  * Fetches an Instagram user's profile. Defaults to the authenticated user (`"me"`).