naystack 1.8.15 → 1.8.17

package/dist/utils/client/index.cjs.js

@@ -122,28 +122,42 @@ function getEnv(key, skipCheck) {
 }
 
 // src/utils/client/seo.ts
-var setupSEO = (SEO) => (title, description, image) => ({
-  title: title ? `${title} \u2022 ${SEO.siteName}` : SEO.title,
-  description: description || SEO.description,
-  openGraph: {
-    type: "website",
-    siteName: SEO.siteName,
-    ...image ? { images: [image] } : {}
-  },
-  twitter: {
-    card: "summary_large_image",
-    ...image ? { images: [image] } : {}
-  },
-  appleWebApp: {
-    title: title ? title : SEO.title,
-    capable: true,
-    startupImage: `${getEnv("NEXT_PUBLIC_BASE_URL" /* NEXT_PUBLIC_BASE_URL */)}/apple-icon.png`
-  },
-  applicationName: SEO.siteName,
-  creator: SEO.siteName,
-  robots: "index, follow",
-  publisher: SEO.siteName
-});
+var setupSEO = (SEO) => (title, description, image, options) => {
+  const isSmallImage = options?.imageSize === "small";
+  return {
+    title: title ? `${title} \u2022 ${SEO.siteName}` : SEO.title,
+    description: description || SEO.description,
+    openGraph: {
+      type: "website",
+      siteName: SEO.siteName,
+      // WhatsApp/Slack pick the thumbnail layout off the declared dimensions,
+      // so a small image needs them stated explicitly to avoid a full-bleed preview.
+      ...image ? {
+        images: [
+          isSmallImage ? {
+            url: image,
+            width: SMALL_IMAGE_SIZE,
+            height: SMALL_IMAGE_SIZE
+          } : image
+        ]
+      } : {}
+    },
+    twitter: {
+      card: isSmallImage ? "summary" : "summary_large_image",
+      ...image ? { images: [image] } : {}
+    },
+    appleWebApp: {
+      title: title ? title : SEO.title,
+      capable: true,
+      startupImage: `${getEnv("NEXT_PUBLIC_BASE_URL" /* NEXT_PUBLIC_BASE_URL */)}/apple-icon.png`
+    },
+    applicationName: SEO.siteName,
+    creator: SEO.siteName,
+    robots: "index, follow",
+    publisher: SEO.siteName
+  };
+};
+var SMALL_IMAGE_SIZE = 200;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   setupSEO,

package/dist/utils/client/index.d.mts

@@ -1,4 +1,4 @@
 export { useBreakpoint, useVisibility } from './hooks.mjs';
-export { setupSEO } from './seo.mjs';
+export { SEOOptions, setupSEO } from './seo.mjs';
 import 'react';
 import 'next';

package/dist/utils/client/index.d.ts

@@ -1,4 +1,4 @@
 export { useBreakpoint, useVisibility } from './hooks.js';
-export { setupSEO } from './seo.js';
+export { SEOOptions, setupSEO } from './seo.js';
 import 'react';
 import 'next';

package/dist/utils/client/index.esm.js

@@ -94,28 +94,42 @@ function getEnv(key, skipCheck) {
 }
 
 // src/utils/client/seo.ts
-var setupSEO = (SEO) => (title, description, image) => ({
-  title: title ? `${title} \u2022 ${SEO.siteName}` : SEO.title,
-  description: description || SEO.description,
-  openGraph: {
-    type: "website",
-    siteName: SEO.siteName,
-    ...image ? { images: [image] } : {}
-  },
-  twitter: {
-    card: "summary_large_image",
-    ...image ? { images: [image] } : {}
-  },
-  appleWebApp: {
-    title: title ? title : SEO.title,
-    capable: true,
-    startupImage: `${getEnv("NEXT_PUBLIC_BASE_URL" /* NEXT_PUBLIC_BASE_URL */)}/apple-icon.png`
-  },
-  applicationName: SEO.siteName,
-  creator: SEO.siteName,
-  robots: "index, follow",
-  publisher: SEO.siteName
-});
+var setupSEO = (SEO) => (title, description, image, options) => {
+  const isSmallImage = options?.imageSize === "small";
+  return {
+    title: title ? `${title} \u2022 ${SEO.siteName}` : SEO.title,
+    description: description || SEO.description,
+    openGraph: {
+      type: "website",
+      siteName: SEO.siteName,
+      // WhatsApp/Slack pick the thumbnail layout off the declared dimensions,
+      // so a small image needs them stated explicitly to avoid a full-bleed preview.
+      ...image ? {
+        images: [
+          isSmallImage ? {
+            url: image,
+            width: SMALL_IMAGE_SIZE,
+            height: SMALL_IMAGE_SIZE
+          } : image
+        ]
+      } : {}
+    },
+    twitter: {
+      card: isSmallImage ? "summary" : "summary_large_image",
+      ...image ? { images: [image] } : {}
+    },
+    appleWebApp: {
+      title: title ? title : SEO.title,
+      capable: true,
+      startupImage: `${getEnv("NEXT_PUBLIC_BASE_URL" /* NEXT_PUBLIC_BASE_URL */)}/apple-icon.png`
+    },
+    applicationName: SEO.siteName,
+    creator: SEO.siteName,
+    robots: "index, follow",
+    publisher: SEO.siteName
+  };
+};
+var SMALL_IMAGE_SIZE = 200;
 export {
   setupSEO,
   useBreakpoint,

package/dist/utils/client/seo.cjs.js

@@ -75,28 +75,42 @@ function getEnv(key, skipCheck) {
 }
 
 // src/utils/client/seo.ts
-var setupSEO = (SEO) => (title, description, image) => ({
-  title: title ? `${title} \u2022 ${SEO.siteName}` : SEO.title,
-  description: description || SEO.description,
-  openGraph: {
-    type: "website",
-    siteName: SEO.siteName,
-    ...image ? { images: [image] } : {}
-  },
-  twitter: {
-    card: "summary_large_image",
-    ...image ? { images: [image] } : {}
-  },
-  appleWebApp: {
-    title: title ? title : SEO.title,
-    capable: true,
-    startupImage: `${getEnv("NEXT_PUBLIC_BASE_URL" /* NEXT_PUBLIC_BASE_URL */)}/apple-icon.png`
-  },
-  applicationName: SEO.siteName,
-  creator: SEO.siteName,
-  robots: "index, follow",
-  publisher: SEO.siteName
-});
+var setupSEO = (SEO) => (title, description, image, options) => {
+  const isSmallImage = options?.imageSize === "small";
+  return {
+    title: title ? `${title} \u2022 ${SEO.siteName}` : SEO.title,
+    description: description || SEO.description,
+    openGraph: {
+      type: "website",
+      siteName: SEO.siteName,
+      // WhatsApp/Slack pick the thumbnail layout off the declared dimensions,
+      // so a small image needs them stated explicitly to avoid a full-bleed preview.
+      ...image ? {
+        images: [
+          isSmallImage ? {
+            url: image,
+            width: SMALL_IMAGE_SIZE,
+            height: SMALL_IMAGE_SIZE
+          } : image
+        ]
+      } : {}
+    },
+    twitter: {
+      card: isSmallImage ? "summary" : "summary_large_image",
+      ...image ? { images: [image] } : {}
+    },
+    appleWebApp: {
+      title: title ? title : SEO.title,
+      capable: true,
+      startupImage: `${getEnv("NEXT_PUBLIC_BASE_URL" /* NEXT_PUBLIC_BASE_URL */)}/apple-icon.png`
+    },
+    applicationName: SEO.siteName,
+    creator: SEO.siteName,
+    robots: "index, follow",
+    publisher: SEO.siteName
+  };
+};
+var SMALL_IMAGE_SIZE = 200;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   setupSEO

package/dist/utils/client/seo.d.mts

@@ -12,7 +12,7 @@ import { Metadata } from 'next';
  * @param SEO.description - Default meta description.
  * @param SEO.siteName - Application/site name (used in openGraph, twitter, and as the separator in titles).
  * @param SEO.themeColor - Theme color for mobile browsers (e.g. `"#000000"`).
- * @returns A function `(title?, description?, image?) => Metadata`. Pass page-specific overrides; they fill in or replace the defaults.
+ * @returns A function `(title?, description?, image?, options?) => Metadata`. Pass page-specific overrides; they fill in or replace the defaults.
  *
  * @example Setup in a utility file:
  * ```ts
@@ -44,6 +44,11 @@ import { Metadata } from 'next';
  * }
  * ```
  *
+ * @example Thumbnail-sized preview (avatars, icons — anything not a hero image):
+ * ```ts
+ * return getSEO(post.title, post.body, post.author.photo, { imageSize: "small" });
+ * ```
+ *
  * @category Client
  */
 declare const setupSEO: (SEO: {
@@ -51,6 +56,13 @@ declare const setupSEO: (SEO: {
     description: string;
     siteName: string;
     themeColor: string;
-}) => (title?: string, description?: string, image?: string | null) => Metadata;
+}) => (title?: string, description?: string, image?: string | null, options?: SEOOptions) => Metadata;
+interface SEOOptions {
+    /**
+     * `"large"` (default) renders a full-width hero preview; `"small"` renders a
+     * square thumbnail next to the text — right for avatars and icons.
+     */
+    imageSize?: "large" | "small";
+}
 
-export { setupSEO };
+export { type SEOOptions, setupSEO };

package/dist/utils/client/seo.d.ts

@@ -12,7 +12,7 @@ import { Metadata } from 'next';
  * @param SEO.description - Default meta description.
  * @param SEO.siteName - Application/site name (used in openGraph, twitter, and as the separator in titles).
  * @param SEO.themeColor - Theme color for mobile browsers (e.g. `"#000000"`).
- * @returns A function `(title?, description?, image?) => Metadata`. Pass page-specific overrides; they fill in or replace the defaults.
+ * @returns A function `(title?, description?, image?, options?) => Metadata`. Pass page-specific overrides; they fill in or replace the defaults.
  *
  * @example Setup in a utility file:
  * ```ts
@@ -44,6 +44,11 @@ import { Metadata } from 'next';
  * }
  * ```
  *
+ * @example Thumbnail-sized preview (avatars, icons — anything not a hero image):
+ * ```ts
+ * return getSEO(post.title, post.body, post.author.photo, { imageSize: "small" });
+ * ```
+ *
  * @category Client
  */
 declare const setupSEO: (SEO: {
@@ -51,6 +56,13 @@ declare const setupSEO: (SEO: {
     description: string;
     siteName: string;
     themeColor: string;
-}) => (title?: string, description?: string, image?: string | null) => Metadata;
+}) => (title?: string, description?: string, image?: string | null, options?: SEOOptions) => Metadata;
+interface SEOOptions {
+    /**
+     * `"large"` (default) renders a full-width hero preview; `"small"` renders a
+     * square thumbnail next to the text — right for avatars and icons.
+     */
+    imageSize?: "large" | "small";
+}
 
-export { setupSEO };
+export { type SEOOptions, setupSEO };

package/dist/utils/client/seo.esm.js

@@ -49,28 +49,42 @@ function getEnv(key, skipCheck) {
 }
 
 // src/utils/client/seo.ts
-var setupSEO = (SEO) => (title, description, image) => ({
-  title: title ? `${title} \u2022 ${SEO.siteName}` : SEO.title,
-  description: description || SEO.description,
-  openGraph: {
-    type: "website",
-    siteName: SEO.siteName,
-    ...image ? { images: [image] } : {}
-  },
-  twitter: {
-    card: "summary_large_image",
-    ...image ? { images: [image] } : {}
-  },
-  appleWebApp: {
-    title: title ? title : SEO.title,
-    capable: true,
-    startupImage: `${getEnv("NEXT_PUBLIC_BASE_URL" /* NEXT_PUBLIC_BASE_URL */)}/apple-icon.png`
-  },
-  applicationName: SEO.siteName,
-  creator: SEO.siteName,
-  robots: "index, follow",
-  publisher: SEO.siteName
-});
+var setupSEO = (SEO) => (title, description, image, options) => {
+  const isSmallImage = options?.imageSize === "small";
+  return {
+    title: title ? `${title} \u2022 ${SEO.siteName}` : SEO.title,
+    description: description || SEO.description,
+    openGraph: {
+      type: "website",
+      siteName: SEO.siteName,
+      // WhatsApp/Slack pick the thumbnail layout off the declared dimensions,
+      // so a small image needs them stated explicitly to avoid a full-bleed preview.
+      ...image ? {
+        images: [
+          isSmallImage ? {
+            url: image,
+            width: SMALL_IMAGE_SIZE,
+            height: SMALL_IMAGE_SIZE
+          } : image
+        ]
+      } : {}
+    },
+    twitter: {
+      card: isSmallImage ? "summary" : "summary_large_image",
+      ...image ? { images: [image] } : {}
+    },
+    appleWebApp: {
+      title: title ? title : SEO.title,
+      capable: true,
+      startupImage: `${getEnv("NEXT_PUBLIC_BASE_URL" /* NEXT_PUBLIC_BASE_URL */)}/apple-icon.png`
+    },
+    applicationName: SEO.siteName,
+    creator: SEO.siteName,
+    robots: "index, follow",
+    publisher: SEO.siteName
+  };
+};
+var SMALL_IMAGE_SIZE = 200;
 export {
   setupSEO
 };

package/package.json

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