@crayonscodetech/cms-sdk 1.0.8 → 1.0.10

package/dist/index.mjs

@@ -1,28 +1,27 @@
-import React from "react";
-import { Activity, AlertCircle, ArrowDown, ArrowLeft, ArrowRight, ArrowUp, Award, BarChart, Battery, Bell, BookOpen, Bookmark, Brain, Briefcase, Building2, Calendar, Camera, Check, CheckCircle, ChevronDown, ChevronLeft, ChevronRight, ChevronUp, ChevronsUpDown, Clipboard, Clock, Cloud, Code, Copy, CreditCard, Database, Download, Edit, ExternalLink, Eye, EyeOff, File, Filter, Flag, Folder, Gift, Globe, GraduationCap, Grid, Handshake, Heart, HeartHandshake, HelpCircle, Home, Image, Info, Layers, Layout, Lightbulb, Link, List, Lock, LogIn, LogOut, Mail, MapPin, Maximize, Menu, MessageSquare, Mic, Microscope, Minus, Moon, MoreHorizontal, MoreVertical, Music, Package, PauseCircle, Phone, PieChart, PlayCircle, Plus, RefreshCw, Save, Search, Send, Server, Settings, Share, ShoppingCart, Star, Stethoscope, Sun, Tag, Target, Trash, Trees, TrendingDown, TrendingUp, Truck, Unlock, Upload, User, UserMinus, UserPlus, Users, Video, Wifi, X, XCircle, Zap } from "lucide-react";
 //#region src/constants/pageTypes.ts
+/**
+* Page type identifiers. Mirrors cms-backend/src/constants/pageTypes.ts.
+*
+* `pageTypes` are the singleton types — a site may have at most one page of
+* each, enforced on create by the backend (cms/page/page.routes.ts). Attempting
+* a second one is rejected with "A page with type "<type>" already exists for
+* this site". `custom` is the only repeatable type.
+*/
 const pageTypes = [
 	"home",
 	"about",
-	"contact"
-];
-const defaultPageTypes = [
-	...pageTypes,
-	"services",
-	"blog",
-	"team",
-	"gallery",
-	"events"
-];
-const allPageTypes = [
-	...pageTypes,
-	"custom",
+	"contact",
 	"services",
 	"blog",
 	"team",
 	"gallery",
-	"events"
+	"events",
+	"clients-partners",
+	"testimonial",
+	"faq"
 ];
+/** The full set accepted by the backend's page validator. */
+const allPageTypes = [...pageTypes, "custom"];
 //#endregion
 //#region src/constants/index.ts
 const PAGINATION = {
@@ -82,6 +81,30 @@ const MEDIA = {
 	MAX_IMAGE_SIZE: 5242880
 };
 //#endregion
+//#region src/types/contact.ts
+/** Attachment caps enforced by the API; mirrored here to fail fast client-side. */
+const MAX_CONTACT_ATTACHMENTS = 3;
+/**
+* Total attachment budget, measured on RAW bytes.
+*
+* Attachments are forwarded onto the notification email, so the ceiling is
+* Cloudflare Email's 5 MiB message limit — but the wire format is base64, 4/3
+* the size. 3 MiB raw leaves headroom; 4 MiB encoded to ~5.33 MiB and was
+* already over. Keep in step with MAX_CONTACT_ATTACHMENTS_TOTAL_BYTES in
+* cms-backend/src/constants/limits.ts.
+*/
+const MAX_CONTACT_ATTACHMENTS_TOTAL_BYTES = 3145728;
+const CONTACT_ATTACHMENT_MIME_ALLOWLIST = [
+	"application/pdf",
+	"image/png",
+	"image/jpeg",
+	"image/webp",
+	"image/gif",
+	"text/plain",
+	"application/msword",
+	"application/vnd.openxmlformats-officedocument.wordprocessingml.document"
+];
+//#endregion
 //#region src/core/client.ts
 var CmsError = class extends Error {
 	message;
@@ -98,9 +121,9 @@ var CmsError = class extends Error {
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 function createCmsClient(config) {
 	const { baseUrl, defaultOptions = {} } = config;
-	async function cmsFetch(endpoint, options = {}, retries = 2) {
+	async function cmsFetch(endpoint, options = {}) {
 		const url = `${baseUrl}${endpoint}`;
-		const { revalidate = CACHE.NO_CACHE, tags, ...rest } = {
+		const { revalidate = CACHE.NO_CACHE, tags, retries = 1, ...rest } = {
 			...defaultOptions,
 			...options
 		};
@@ -111,12 +134,9 @@ function createCmsClient(config) {
 				...tags && { tags }
 			}
 		};
-		let lastError = null;
 		for (let attempt = 0; attempt <= retries; attempt++) try {
 			const response = await fetch(url, fetchConfig);
 			if (!response.ok) {
-				const errorMsg = `API request failed: ${response.status} ${url}`;
-				console.error(errorMsg);
 				if (attempt < retries && [
 					502,
 					503,
@@ -125,32 +145,29 @@ function createCmsClient(config) {
 					await sleep(Math.pow(2, attempt) * 1e3);
 					continue;
 				}
-				return null;
+				let errorMsg = `API request failed: ${response.status} ${url}`;
+				try {
+					const body = await response.json();
+					if (body?.message) errorMsg = body.message;
+				} catch {}
+				throw new CmsError(errorMsg, response.status, url);
 			}
 			if (response.status === 204) return null;
 			const result = await response.json();
 			return result.data ?? result;
 		} catch (error) {
-			lastError = error instanceof Error ? error : new Error(String(error));
-			console.error(`API request error (attempt ${attempt + 1}/${retries + 1}): ${url}`, lastError);
+			if (error instanceof CmsError) throw error;
 			if (attempt < retries) {
 				await sleep(Math.pow(2, attempt) * 1e3);
 				continue;
 			}
+			throw new CmsError(`Request failed: ${error instanceof Error ? error.message : String(error)}`, void 0, url);
 		}
-		return null;
-	}
-	async function cmsFetchPaginated(endpoint, options = {}, retries = 2) {
-		const emptyResponse = {
-			data: [],
-			pagination: {
-				page: 1,
-				limit: PAGINATION.DEFAULT_LIMIT,
-				total: 0
-			}
-		};
+		throw new CmsError(`Request failed after ${retries + 1} attempts`, void 0, url);
+	}
+	async function cmsFetchPaginated(endpoint, options = {}) {
 		const url = `${baseUrl}${endpoint}`;
-		const { revalidate = CACHE.NO_CACHE, tags, ...rest } = {
+		const { revalidate = CACHE.NO_CACHE, tags, retries = 1, ...rest } = {
 			...defaultOptions,
 			...options
 		};
@@ -164,7 +181,6 @@ function createCmsClient(config) {
 		for (let attempt = 0; attempt <= retries; attempt++) try {
 			const response = await fetch(url, fetchConfig);
 			if (!response.ok) {
-				console.error(`API request failed: ${response.status} ${url}`);
 				if (attempt < retries && [
 					502,
 					503,
@@ -173,17 +189,23 @@ function createCmsClient(config) {
 					await sleep(Math.pow(2, attempt) * 1e3);
 					continue;
 				}
-				return emptyResponse;
+				let errorMsg = `API request failed: ${response.status} ${url}`;
+				try {
+					const body = await response.json();
+					if (body?.message) errorMsg = body.message;
+				} catch {}
+				throw new CmsError(errorMsg, response.status, url);
 			}
 			return await response.json();
 		} catch (error) {
-			console.error(`API request error (attempt ${attempt + 1}/${retries + 1}): ${url}`, error);
+			if (error instanceof CmsError) throw error;
 			if (attempt < retries) {
 				await sleep(Math.pow(2, attempt) * 1e3);
 				continue;
 			}
+			throw new CmsError(`Request failed: ${error instanceof Error ? error.message : String(error)}`, void 0, url);
 		}
-		return emptyResponse;
+		throw new CmsError(`Request failed after ${retries + 1} attempts`, void 0, url);
 	}
 	function buildQueryString(params) {
 		const query = new URLSearchParams();
@@ -225,17 +247,25 @@ function createCmsClient(config) {
 		});
 	}
 	async function fetchPageByUrl(siteId, urlPath, options) {
-		try {
-			const targetUrl = urlPath === "/" || urlPath === "" ? "/" : `/${urlPath.replace(/^\/|\/$/g, "")}`;
-			return await cmsFetch(`/api/public/cms/${siteId}/page/by-url/?url=${encodeURIComponent(targetUrl)}`, {
-				revalidate: CACHE.SHORT,
-				tags: ["pages", `page-${targetUrl || "root"}`],
-				...options
-			});
-		} catch (error) {
-			console.error(`Error in fetchPageByUrl for ${urlPath}:`, error);
-			return null;
-		}
+		const targetUrl = urlPath === "/" || urlPath === "" ? "/" : `/${urlPath.replace(/^\/|\/$/g, "")}`;
+		return cmsFetch(`/api/public/cms/${siteId}/page/by-url/?url=${encodeURIComponent(targetUrl)}`, {
+			revalidate: CACHE.SHORT,
+			tags: ["pages", `page-${targetUrl || "root"}`],
+			...options
+		});
+	}
+	/**
+	* The site's single published page of a given type, with its sections — the
+	* same payload as `fetchPageByUrl`. Prefer this when you know which kind of
+	* page you want but not its url, since an editor can rename the url at any
+	* time. Returns null when the site has no published page of that type.
+	*/
+	async function fetchPageByType(siteId, pageType, options) {
+		return cmsFetch(`/api/public/cms/${siteId}/page/by-type/${encodeURIComponent(pageType)}/`, {
+			revalidate: CACHE.SHORT,
+			tags: ["pages", `page-type-${pageType}`],
+			...options
+		});
 	}
 	function fetchAboutUs(siteId, options) {
 		return cmsFetch(`/api/public/cms/${siteId}/about-us/`, {
@@ -361,14 +391,73 @@ function createCmsClient(config) {
 			...options
 		});
 	}
-	async function submitContactForm(siteId, payload, options) {
-		return cmsFetch(`/api/public/cms/${siteId}/contact/`, {
-			method: "POST",
-			headers: { "Content-Type": "application/json" },
-			body: JSON.stringify(payload),
-			revalidate: CACHE.NO_CACHE,
-			...options
-		});
+	/**
+	* Public Turnstile settings for the site's contact form.
+	*
+	* Call this before rendering the form: when `turnstile.enabled` is true the
+	* widget must be rendered with `turnstile.site_key` and its token passed to
+	* `submitContactForm`, or every submission is rejected.
+	*/
+	function fetchContactConfig(siteId, options) {
+		return cmsFetch(`/api/public/cms/${siteId}/contact-config/`, {
+			revalidate: CACHE.SHORT,
+			tags: ["contact-config"],
+			...options
+		});
+	}
+	/**
+	* Submit the contact form.
+	*
+	* Unlike the read methods, this THROWS `CmsError` on a rejection rather than
+	* returning null — a form needs to tell "captcha failed, reset the widget"
+	* (403) apart from "rate limited" (429) and a network blip, and a single
+	* `null` cannot carry that. `error.status` holds the HTTP status.
+	*
+	* Pass `attachments` to send files; the request then goes out as multipart
+	* instead of JSON. Caps are enforced server-side and pre-checked here.
+	*/
+	async function submitContactForm(siteId, payload, attachments, options) {
+		const url = `${baseUrl}/api/public/cms/${siteId}/contact/`;
+		if (attachments?.length) {
+			if (attachments.length > 3) throw new CmsError(`At most 3 attachments are allowed`, 400, url);
+			if (attachments.reduce((sum, f) => sum + f.size, 0) > 3145728) throw new CmsError(`Attachments exceed the ${MAX_CONTACT_ATTACHMENTS_TOTAL_BYTES / 1048576} MiB total size limit`, 400, url);
+			for (const f of attachments) if (!CONTACT_ATTACHMENT_MIME_ALLOWLIST.includes(f.type)) throw new CmsError(`Attachment type not allowed: ${f.type || "unknown"}`, 400, url);
+		}
+		let body;
+		const headers = {};
+		if (attachments?.length) {
+			const form = new FormData();
+			for (const [key, value] of Object.entries(payload)) if (value !== void 0 && value !== null) form.append(key, String(value));
+			for (const file of attachments) form.append("attachments", file, file.name);
+			body = form;
+		} else {
+			headers["Content-Type"] = "application/json";
+			body = JSON.stringify(payload);
+		}
+		let response;
+		try {
+			response = await fetch(url, {
+				...options,
+				method: "POST",
+				headers: {
+					...headers,
+					...options?.headers
+				},
+				body
+			});
+		} catch (error) {
+			throw new CmsError(error instanceof Error ? error.message : "Network request failed", void 0, url);
+		}
+		if (!response.ok) {
+			let message = `Request failed with status ${response.status}`;
+			try {
+				const parsed = await response.json();
+				if (parsed?.message) message = parsed.message;
+			} catch {}
+			throw new CmsError(message, response.status, url);
+		}
+		const result = await response.json();
+		return result.data ?? result;
 	}
 	function fetchFaqs(siteId, params, options) {
 		return cmsFetchPaginated(`/api/public/cms/${siteId}/faqs/?${buildQueryString({
@@ -409,8 +498,9 @@ function createCmsClient(config) {
 				referrer
 			}),
 			revalidate: CACHE.NO_CACHE,
-			tags: ["redirects", "redirect-404-logs"]
-		}, 0);
+			tags: ["redirects", "redirect-404-logs"],
+			retries: 0
+		});
 	}
 	function fetchStoreSettings(siteId, options) {
 		return cmsFetch(`/api/public/store/${siteId}/settings/`, {
@@ -490,6 +580,7 @@ function createCmsClient(config) {
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify(payload),
 			revalidate: CACHE.NO_CACHE,
+			retries: 0,
 			...options
 		});
 	}
@@ -525,6 +616,70 @@ function createCmsClient(config) {
 			...options
 		});
 	}
+	const SITEMAP_ROUTES = {
+		blogs: {
+			segment: "blogs",
+			store: false
+		},
+		pages: {
+			segment: "pages",
+			store: false
+		},
+		services: {
+			segment: "services",
+			store: false
+		},
+		events: {
+			segment: "events",
+			store: false
+		},
+		albums: {
+			segment: "albums",
+			store: false
+		},
+		"team-members": {
+			segment: "team-members",
+			store: false
+		},
+		"team-categories": {
+			segment: "team-categories",
+			store: false
+		},
+		"brand-groups": {
+			segment: "brand-groups",
+			store: false
+		},
+		products: {
+			segment: "products",
+			store: true
+		},
+		collections: {
+			segment: "collections",
+			store: true
+		},
+		"product-categories": {
+			segment: "categories",
+			store: true
+		},
+		"product-brands": {
+			segment: "brands",
+			store: true
+		}
+	};
+	/**
+	* Fetch any sitemap resource. Returns slug/url, title/name, image (where
+	* the content type has one) and `updatedAt` for `lastModified`.
+	*/
+	function fetchSitemap(siteId, resource, params = {}, options) {
+		const { segment, store } = SITEMAP_ROUTES[resource];
+		const namespace = store ? "store" : "cms";
+		const query = buildQueryString(params);
+		return cmsFetchPaginated(`/api/public/${namespace}/${siteId}/sitemap/${segment}/${query ? `?${query}` : ""}`, {
+			revalidate: CACHE.STATIC,
+			tags: ["sitemap", `sitemap-${resource}`],
+			...options
+		});
+	}
 	return {
 		LIST_DEFAULT_LIMIT,
 		fetchHeader,
@@ -532,6 +687,7 @@ function createCmsClient(config) {
 		fetchSiteConfig,
 		fetchPages,
 		fetchPageByUrl,
+		fetchPageByType,
 		fetchAboutUs,
 		fetchServices,
 		fetchServiceBySlug,
@@ -554,6 +710,7 @@ function createCmsClient(config) {
 		resolveRedirect,
 		reportRedirect404,
 		submitContactForm,
+		fetchContactConfig,
 		fetchStoreSettings,
 		fetchProductCategories,
 		fetchProductBrands,
@@ -564,6 +721,7 @@ function createCmsClient(config) {
 		fetchCollectionDetail,
 		fetchCollectionDetailById,
 		placeOrder,
+		fetchSitemap,
 		fetchSitemapBlogs,
 		fetchSitemapPages,
 		fetchSitemapProducts,
@@ -574,127 +732,116 @@ function createCmsClient(config) {
 	};
 }
 //#endregion
-//#region src/components/Icon.tsx
-/**
-* A exhaustive map of Lucide icons commonly used in the CMS.
-*/
-const ICON_MAP = {
-	Home,
-	User,
-	Settings,
-	Mail,
-	Bell,
-	Calendar,
-	Star,
-	Heart,
-	Bookmark,
-	Search,
-	Filter,
-	Download,
-	Upload,
-	Trash,
-	Edit,
-	Plus,
-	Minus,
-	Check,
-	X,
-	ChevronRight,
-	ChevronLeft,
-	ChevronUp,
-	ChevronDown,
-	ChevronsUpDown,
-	ArrowRight,
-	ArrowLeft,
-	ArrowUp,
-	ArrowDown,
-	File,
-	Folder,
-	Image,
-	Video,
-	Music,
-	Lock,
-	Unlock,
-	Eye,
-	EyeOff,
-	Sun,
-	Moon,
-	Cloud,
-	Zap,
-	Activity,
-	TrendingUp,
-	TrendingDown,
-	BarChart,
-	PieChart,
-	Database,
-	Server,
-	Wifi,
-	Battery,
-	Camera,
-	Mic,
-	Phone,
-	MessageSquare,
-	Send,
-	Share,
-	Link,
-	ExternalLink,
-	Globe,
-	MapPin,
-	Users,
-	ShoppingCart,
-	CreditCard,
-	Package,
-	Briefcase,
-	Target,
-	Flag,
-	Clipboard,
-	List,
-	Grid,
-	Layout,
-	Layers,
-	Copy,
-	Save,
-	RefreshCw,
-	Maximize,
-	Code,
-	AlertCircle,
-	Info,
-	HelpCircle,
-	CheckCircle,
-	XCircle,
-	Menu,
-	MoreVertical,
-	MoreHorizontal,
-	PlayCircle,
-	PauseCircle,
-	LogIn,
-	LogOut,
-	UserPlus,
-	UserMinus,
-	Tag,
-	Award,
-	Gift,
-	Truck,
-	Clock,
-	Handshake,
-	Stethoscope,
-	Microscope,
-	GraduationCap,
-	BookOpen,
-	Building2,
-	Trees,
-	HeartHandshake,
-	Brain,
-	Lightbulb
-};
-/**
-* Dynamic Icon component that renders Lucide icons by name.
-* Useful for CMS-driven icons where names are stored as strings.
-*/
-function Icon({ name, fallback = "HelpCircle", ...props }) {
-	const IconComponent = ICON_MAP[name] ?? ICON_MAP[fallback] ?? HelpCircle;
-	return React.createElement(IconComponent, props);
-}
+//#region src/types/icon.ts
+const ICON_NAMES = [
+	"Home",
+	"User",
+	"Settings",
+	"Mail",
+	"Bell",
+	"Calendar",
+	"Star",
+	"Heart",
+	"Bookmark",
+	"Search",
+	"Filter",
+	"Download",
+	"Upload",
+	"Trash",
+	"Edit",
+	"Plus",
+	"Minus",
+	"Check",
+	"X",
+	"ChevronRight",
+	"ChevronLeft",
+	"ChevronUp",
+	"ChevronDown",
+	"ChevronsUpDown",
+	"ArrowRight",
+	"ArrowLeft",
+	"ArrowUp",
+	"ArrowDown",
+	"File",
+	"Folder",
+	"Image",
+	"Video",
+	"Music",
+	"Lock",
+	"Unlock",
+	"Eye",
+	"EyeOff",
+	"Sun",
+	"Moon",
+	"Cloud",
+	"Zap",
+	"Activity",
+	"TrendingUp",
+	"TrendingDown",
+	"BarChart",
+	"PieChart",
+	"Database",
+	"Server",
+	"Wifi",
+	"Battery",
+	"Camera",
+	"Mic",
+	"Phone",
+	"MessageSquare",
+	"Send",
+	"Share",
+	"Link",
+	"ExternalLink",
+	"Globe",
+	"MapPin",
+	"Users",
+	"ShoppingCart",
+	"CreditCard",
+	"Package",
+	"Briefcase",
+	"Target",
+	"Flag",
+	"Clipboard",
+	"List",
+	"Grid",
+	"Layout",
+	"Layers",
+	"Copy",
+	"Save",
+	"RefreshCw",
+	"Maximize",
+	"Code",
+	"AlertCircle",
+	"Info",
+	"HelpCircle",
+	"CheckCircle",
+	"XCircle",
+	"Menu",
+	"MoreVertical",
+	"MoreHorizontal",
+	"PlayCircle",
+	"PauseCircle",
+	"LogIn",
+	"LogOut",
+	"UserPlus",
+	"UserMinus",
+	"Tag",
+	"Award",
+	"Gift",
+	"Truck",
+	"Clock",
+	"Handshake",
+	"Stethoscope",
+	"Microscope",
+	"GraduationCap",
+	"BookOpen",
+	"Building2",
+	"Trees",
+	"HeartHandshake",
+	"Brain",
+	"Lightbulb"
+];
 //#endregion
-export { ANIMATION, CACHE, CONTACT_SUBJECTS, CmsError, HTTP_STATUS, ICON_MAP, Icon, MEDIA, PAGINATION, SEARCH, allPageTypes, createCmsClient, defaultPageTypes, pageTypes };
+export { ANIMATION, CACHE, CONTACT_ATTACHMENT_MIME_ALLOWLIST, CONTACT_SUBJECTS, CmsError, HTTP_STATUS, ICON_NAMES, MAX_CONTACT_ATTACHMENTS, MAX_CONTACT_ATTACHMENTS_TOTAL_BYTES, MEDIA, PAGINATION, SEARCH, allPageTypes, createCmsClient, pageTypes };
 
 //# sourceMappingURL=index.mjs.map