@crayonscodetech/cms-sdk 1.0.8 → 1.0.9

package/dist/index.cjs

@@ -1,29 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-//#endregion
-let react = require("react");
-react = __toESM(react, 1);
-let lucide_react = require("lucide-react");
 //#region src/constants/pageTypes.ts
 const pageTypes = [
 	"home",
@@ -106,6 +81,21 @@ 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;
+const MAX_CONTACT_ATTACHMENTS_TOTAL_BYTES = 4194304;
+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;
@@ -122,9 +112,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
 		};
@@ -135,12 +125,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,
@@ -149,32 +136,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
 		};
@@ -188,7 +172,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,
@@ -197,17 +180,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();
@@ -249,17 +238,12 @@ 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
+		});
 	}
 	function fetchAboutUs(siteId, options) {
 		return cmsFetch(`/api/public/cms/${siteId}/about-us/`, {
@@ -385,14 +369,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) > 4194304) throw new CmsError("Attachments exceed the 4 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({
@@ -433,8 +476,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/`, {
@@ -514,6 +558,7 @@ function createCmsClient(config) {
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify(payload),
 			revalidate: CACHE.NO_CACHE,
+			retries: 0,
 			...options
 		});
 	}
@@ -549,6 +594,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,
@@ -578,6 +687,7 @@ function createCmsClient(config) {
 		resolveRedirect,
 		reportRedirect404,
 		submitContactForm,
+		fetchContactConfig,
 		fetchStoreSettings,
 		fetchProductCategories,
 		fetchProductBrands,
@@ -588,6 +698,7 @@ function createCmsClient(config) {
 		fetchCollectionDetail,
 		fetchCollectionDetailById,
 		placeOrder,
+		fetchSitemap,
 		fetchSitemapBlogs,
 		fetchSitemapPages,
 		fetchSitemapProducts,
@@ -598,134 +709,125 @@ function createCmsClient(config) {
 	};
 }
 //#endregion
-//#region src/components/Icon.tsx
-/**
-* A exhaustive map of Lucide icons commonly used in the CMS.
-*/
-const ICON_MAP = {
-	Home: lucide_react.Home,
-	User: lucide_react.User,
-	Settings: lucide_react.Settings,
-	Mail: lucide_react.Mail,
-	Bell: lucide_react.Bell,
-	Calendar: lucide_react.Calendar,
-	Star: lucide_react.Star,
-	Heart: lucide_react.Heart,
-	Bookmark: lucide_react.Bookmark,
-	Search: lucide_react.Search,
-	Filter: lucide_react.Filter,
-	Download: lucide_react.Download,
-	Upload: lucide_react.Upload,
-	Trash: lucide_react.Trash,
-	Edit: lucide_react.Edit,
-	Plus: lucide_react.Plus,
-	Minus: lucide_react.Minus,
-	Check: lucide_react.Check,
-	X: lucide_react.X,
-	ChevronRight: lucide_react.ChevronRight,
-	ChevronLeft: lucide_react.ChevronLeft,
-	ChevronUp: lucide_react.ChevronUp,
-	ChevronDown: lucide_react.ChevronDown,
-	ChevronsUpDown: lucide_react.ChevronsUpDown,
-	ArrowRight: lucide_react.ArrowRight,
-	ArrowLeft: lucide_react.ArrowLeft,
-	ArrowUp: lucide_react.ArrowUp,
-	ArrowDown: lucide_react.ArrowDown,
-	File: lucide_react.File,
-	Folder: lucide_react.Folder,
-	Image: lucide_react.Image,
-	Video: lucide_react.Video,
-	Music: lucide_react.Music,
-	Lock: lucide_react.Lock,
-	Unlock: lucide_react.Unlock,
-	Eye: lucide_react.Eye,
-	EyeOff: lucide_react.EyeOff,
-	Sun: lucide_react.Sun,
-	Moon: lucide_react.Moon,
-	Cloud: lucide_react.Cloud,
-	Zap: lucide_react.Zap,
-	Activity: lucide_react.Activity,
-	TrendingUp: lucide_react.TrendingUp,
-	TrendingDown: lucide_react.TrendingDown,
-	BarChart: lucide_react.BarChart,
-	PieChart: lucide_react.PieChart,
-	Database: lucide_react.Database,
-	Server: lucide_react.Server,
-	Wifi: lucide_react.Wifi,
-	Battery: lucide_react.Battery,
-	Camera: lucide_react.Camera,
-	Mic: lucide_react.Mic,
-	Phone: lucide_react.Phone,
-	MessageSquare: lucide_react.MessageSquare,
-	Send: lucide_react.Send,
-	Share: lucide_react.Share,
-	Link: lucide_react.Link,
-	ExternalLink: lucide_react.ExternalLink,
-	Globe: lucide_react.Globe,
-	MapPin: lucide_react.MapPin,
-	Users: lucide_react.Users,
-	ShoppingCart: lucide_react.ShoppingCart,
-	CreditCard: lucide_react.CreditCard,
-	Package: lucide_react.Package,
-	Briefcase: lucide_react.Briefcase,
-	Target: lucide_react.Target,
-	Flag: lucide_react.Flag,
-	Clipboard: lucide_react.Clipboard,
-	List: lucide_react.List,
-	Grid: lucide_react.Grid,
-	Layout: lucide_react.Layout,
-	Layers: lucide_react.Layers,
-	Copy: lucide_react.Copy,
-	Save: lucide_react.Save,
-	RefreshCw: lucide_react.RefreshCw,
-	Maximize: lucide_react.Maximize,
-	Code: lucide_react.Code,
-	AlertCircle: lucide_react.AlertCircle,
-	Info: lucide_react.Info,
-	HelpCircle: lucide_react.HelpCircle,
-	CheckCircle: lucide_react.CheckCircle,
-	XCircle: lucide_react.XCircle,
-	Menu: lucide_react.Menu,
-	MoreVertical: lucide_react.MoreVertical,
-	MoreHorizontal: lucide_react.MoreHorizontal,
-	PlayCircle: lucide_react.PlayCircle,
-	PauseCircle: lucide_react.PauseCircle,
-	LogIn: lucide_react.LogIn,
-	LogOut: lucide_react.LogOut,
-	UserPlus: lucide_react.UserPlus,
-	UserMinus: lucide_react.UserMinus,
-	Tag: lucide_react.Tag,
-	Award: lucide_react.Award,
-	Gift: lucide_react.Gift,
-	Truck: lucide_react.Truck,
-	Clock: lucide_react.Clock,
-	Handshake: lucide_react.Handshake,
-	Stethoscope: lucide_react.Stethoscope,
-	Microscope: lucide_react.Microscope,
-	GraduationCap: lucide_react.GraduationCap,
-	BookOpen: lucide_react.BookOpen,
-	Building2: lucide_react.Building2,
-	Trees: lucide_react.Trees,
-	HeartHandshake: lucide_react.HeartHandshake,
-	Brain: lucide_react.Brain,
-	Lightbulb: lucide_react.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] ?? lucide_react.HelpCircle;
-	return react.default.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
 exports.ANIMATION = ANIMATION;
 exports.CACHE = CACHE;
+exports.CONTACT_ATTACHMENT_MIME_ALLOWLIST = CONTACT_ATTACHMENT_MIME_ALLOWLIST;
 exports.CONTACT_SUBJECTS = CONTACT_SUBJECTS;
 exports.CmsError = CmsError;
 exports.HTTP_STATUS = HTTP_STATUS;
-exports.ICON_MAP = ICON_MAP;
-exports.Icon = Icon;
+exports.ICON_NAMES = ICON_NAMES;
+exports.MAX_CONTACT_ATTACHMENTS = MAX_CONTACT_ATTACHMENTS;
+exports.MAX_CONTACT_ATTACHMENTS_TOTAL_BYTES = MAX_CONTACT_ATTACHMENTS_TOTAL_BYTES;
 exports.MEDIA = MEDIA;
 exports.PAGINATION = PAGINATION;
 exports.SEARCH = SEARCH;