keystone-design-bootstrap 1.0.41 → 1.0.43

package/dist/utils/photo-helpers.d.ts

@@ -0,0 +1,46 @@
+import { W as WebsitePhotos } from '../website-photos-_n2g24IM.js';
+
+/**
+ * Helper functions for extracting photo URLs from photo associations
+ */
+
+interface PhotoAttachment {
+    id: number;
+    photo: {
+        id: number;
+        title: string;
+        thumbnail_url?: string;
+        medium_url?: string;
+        large_url?: string;
+        original_url?: string;
+    };
+    featured: boolean;
+    sort_order: number;
+}
+/**
+ * Get the best available photo URL from a photos array
+ * Priority: featured photo > first photo > fallback
+ */
+declare function getPhotoUrl(photos?: PhotoAttachment[]): string | null;
+/**
+ * Get avatar URL for team members or authors.
+ * Returns a URL only when there is a real photo in attachments; otherwise null.
+ * Callers should use PhotoWithFallback (gradient fallback) or Avatar with initials when null.
+ */
+/** Optional fallbackId/name reserved for future use (e.g. deterministic fallback). */
+declare function getAvatarUrl(photos?: PhotoAttachment[], _fallbackId?: number | string, _name?: string): string | null;
+/**
+ * Get featured image URL for blog posts
+ */
+declare function getFeaturedImageUrl(photos?: PhotoAttachment[]): string | null;
+/**
+ * Get logo URL from website_photos API (which aggregates from account_photos)
+ *
+ * The website_photos API endpoint returns logos from account_photos with photo_type: 'logo',
+ * with industry fallback. This is the primary and only source for logos.
+ *
+ * Returns undefined if no logo is available (for PhotoWithFallback gradient fallback)
+ */
+declare function getLogoUrl(websitePhotos?: WebsitePhotos | null): string | undefined;
+
+export { type PhotoAttachment, getAvatarUrl, getFeaturedImageUrl, getLogoUrl, getPhotoUrl };

package/dist/website-photos-_n2g24IM.d.ts

@@ -0,0 +1,20 @@
+interface WebsitePhoto {
+    id: number;
+    url: string;
+    thumbnail_url?: string;
+    medium_url?: string;
+    alt: string;
+    source: 'account' | 'industry';
+}
+interface WebsitePhotos {
+    logo?: WebsitePhoto | null;
+    favicon?: WebsitePhoto | null;
+    hero?: WebsitePhoto | null;
+    contact?: WebsitePhoto | null;
+    about?: WebsitePhoto | null;
+    careers?: WebsitePhoto | null;
+    stock_photos?: WebsitePhoto[];
+}
+type WebsitePhotosResponse = WebsitePhotos;
+
+export type { WebsitePhotos as W, WebsitePhoto as a, WebsitePhotosResponse as b };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keystone-design-bootstrap",
-  "version": "1.0.41",
+  "version": "1.0.43",
   "description": "Keystone Design Bootstrap - Sections, Elements, and Theme System for customer websites",
   "type": "module",
   "main": "./src/index.ts",

package/src/lib/server-api.ts

@@ -5,6 +5,7 @@
 
 import type { CompanyInformation } from '../types/api/company-information';
 import type { Service } from '../types/api/service';
+import type { WebsitePhotos } from '../types/api/website-photos';
 
 const API_URL = process.env.API_URL || 'http://localhost:3000/api/v1';
 const API_KEY = process.env.API_KEY || '';
@@ -112,8 +113,8 @@ export async function getTeamMembers() {
   return serverFetch('/public/team_members', defaultOptions);
 }
 
-export async function getWebsitePhotos() {
-  return serverFetch('/public/website_photos', defaultOptions);
+export async function getWebsitePhotos(): Promise<WebsitePhotos | null> {
+  return serverFetch<WebsitePhotos>('/public/website_photos', defaultOptions);
 }
 
 export async function getJobPostings() {

package/src/types/api/website-photos.ts

@@ -14,6 +14,7 @@ export interface WebsitePhotos {
   contact?: WebsitePhoto | null;
   about?: WebsitePhoto | null;
   careers?: WebsitePhoto | null;
+  preview_image?: WebsitePhoto | null;
   stock_photos?: WebsitePhoto[]; // Array of 'none' type photos for stub mode fallback
 }