@tetherto/dev-websites-core 0.0.0 → 0.2.1

package/dist/cms-5bS91IRZ.mjs

@@ -0,0 +1,1419 @@
+import { t as createLogger } from "./logger-BPURnavq.mjs";
+import { buildConfig } from "payload";
+import { BlocksFeature, CodeBlock, EXPERIMENTAL_TableFeature, UploadFeature, editorConfigFactory, lexicalEditor } from "@payloadcms/richtext-lexical";
+import { s3Storage } from "@payloadcms/storage-s3";
+//#region src/cms/shared/access.ts
+const isAdminUser = (req) => req.user?.collection === "users";
+const isDisabledApiToken = (req) => req.user?.collection === "api-tokens" && req.user?.enabled === false;
+/**
+* Build access helpers. Pass `{ apiTokens: true }` when the `api-tokens`
+* collection is registered (stock by default via `buildCmsConfig`).
+*/
+function createAccessHelpers(options = {}) {
+	const apiTokens = options.apiTokens === true;
+	const adminOnly = ({ req }) => isAdminUser(req);
+	const adminOrPublished = ({ req }) => {
+		if (isAdminUser(req)) return true;
+		if (apiTokens && isDisabledApiToken(req)) return false;
+		return { _status: { equals: "published" } };
+	};
+	const publicRead = ({ req }) => {
+		if (apiTokens && isDisabledApiToken(req)) return false;
+		return true;
+	};
+	const adminOnlyField = ({ req }) => isAdminUser(req);
+	return {
+		adminOnly,
+		adminOrPublished,
+		publicRead,
+		adminOnlyField
+	};
+}
+//#endregion
+//#region src/cms/collections/createApiTokens.ts
+const adminOrSelf = ({ req }) => {
+	if (req.user?.collection === "users") return true;
+	if (req.user?.collection === "api-tokens") return { id: { equals: req.user.id } };
+	return false;
+};
+/**
+* Stock API-key auth collection for server-to-server Payload REST/GraphQL clients.
+* Disable per site with `overrides['api-tokens'] = false`.
+*/
+function createApiTokens(access) {
+	return {
+		slug: "api-tokens",
+		labels: {
+			singular: "API Token",
+			plural: "API Tokens"
+		},
+		admin: {
+			useAsTitle: "name",
+			defaultColumns: [
+				"name",
+				"description",
+				"enabled",
+				"createdAt"
+			],
+			description: "Server-to-server tokens for non-admin clients calling the Payload REST/GraphQL API. Each token authenticates as an api-tokens user and is restricted to published, public-readable content."
+		},
+		auth: {
+			useAPIKey: true,
+			disableLocalStrategy: true
+		},
+		access: {
+			read: adminOrSelf,
+			create: access.adminOnly,
+			update: access.adminOnly,
+			delete: access.adminOnly,
+			admin: access.adminOnly
+		},
+		fields: [
+			{
+				name: "name",
+				type: "text",
+				required: true,
+				admin: { description: "Human-readable label, e.g. \"mobile-app-prod\" or \"partner-foo\"." }
+			},
+			{
+				name: "description",
+				type: "textarea",
+				admin: { description: "Who is this token for and what is it used for? Free-form notes." }
+			},
+			{
+				name: "enabled",
+				type: "checkbox",
+				defaultValue: true,
+				admin: {
+					position: "sidebar",
+					description: "Disable to soft-revoke. To hard-revoke, clear the API Key field or delete the document."
+				}
+			}
+		]
+	};
+}
+//#endregion
+//#region src/cms/hooks/slugify.ts
+const slugify = ({ value }) => typeof value === "string" ? value.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "") : value;
+//#endregion
+//#region src/cms/shared/seo-fields.ts
+const MAX_META_TITLE = 60;
+const MAX_META_DESCRIPTION = 160;
+const validateMetaTitle = (value) => {
+	if (!value || value.trim().length === 0) return "Meta title is required.";
+	if (value.length > MAX_META_TITLE) return `Meta title must be ${MAX_META_TITLE} characters or fewer (currently ${value.length}).`;
+	return true;
+};
+const validateMetaDescription = (value) => {
+	if (!value || value.trim().length === 0) return "Meta description is required.";
+	if (value.length > MAX_META_DESCRIPTION) return `Meta description must be ${MAX_META_DESCRIPTION} characters or fewer (currently ${value.length}).`;
+	return true;
+};
+const validateUrl = (value) => {
+	if (!value) return true;
+	try {
+		new URL(value);
+		return true;
+	} catch {
+		return "Must be a valid URL (e.g. https://example.com/page).";
+	}
+};
+const seoFields = {
+	name: "seo",
+	type: "group",
+	label: "SEO",
+	fields: [
+		{
+			name: "metaTitle",
+			type: "text",
+			required: true,
+			localized: true,
+			maxLength: MAX_META_TITLE,
+			validate: validateMetaTitle,
+			admin: { description: `Required. ${MAX_META_TITLE} characters max — shown in browser tabs and search results.` }
+		},
+		{
+			name: "metaDescription",
+			type: "textarea",
+			required: true,
+			localized: true,
+			validate: validateMetaDescription,
+			admin: { description: `Required. ${MAX_META_DESCRIPTION} characters max — shown in search result snippets.` }
+		},
+		{
+			name: "ogImage",
+			type: "upload",
+			relationTo: "media",
+			admin: { description: "Used when the page is shared on social media (1200×630 recommended). Falls back to cover image if empty." }
+		},
+		{
+			name: "canonicalUrl",
+			type: "text",
+			validate: validateUrl,
+			admin: { description: "Override for syndicated content. Leave empty to auto-derive from slug." }
+		},
+		{
+			name: "noIndex",
+			type: "checkbox",
+			defaultValue: false,
+			admin: { description: "When checked, search engines will not index this page." }
+		},
+		{
+			name: "noFollow",
+			type: "checkbox",
+			defaultValue: false,
+			admin: { description: "When checked, search engines will not follow links on this page (paired with noIndex if needed)." }
+		}
+	]
+};
+//#endregion
+//#region src/cms/collections/createAuthors.ts
+function createAuthors(access) {
+	return {
+		slug: "authors",
+		admin: {
+			useAsTitle: "name",
+			defaultColumns: [
+				"name",
+				"slug",
+				"role"
+			]
+		},
+		access: {
+			read: access.publicRead,
+			create: access.adminOnly,
+			update: access.adminOnly,
+			delete: access.adminOnly
+		},
+		fields: [
+			{
+				name: "name",
+				type: "text",
+				required: true,
+				localized: true
+			},
+			{
+				name: "slug",
+				type: "text",
+				required: true,
+				unique: true,
+				admin: { position: "sidebar" },
+				hooks: { beforeValidate: [slugify] }
+			},
+			{
+				name: "avatar",
+				type: "upload",
+				relationTo: "media"
+			},
+			{
+				name: "role",
+				type: "text",
+				localized: true,
+				admin: { description: "Job title or role (e.g. \"Lead Engineer\")" }
+			},
+			{
+				name: "bio",
+				type: "textarea",
+				localized: true
+			},
+			{
+				name: "social",
+				type: "group",
+				label: "Social Profiles",
+				admin: { position: "sidebar" },
+				fields: [
+					{
+						name: "website",
+						type: "text"
+					},
+					{
+						name: "twitter",
+						type: "text",
+						admin: { description: "@handle or full URL" }
+					},
+					{
+						name: "linkedin",
+						type: "text"
+					},
+					{
+						name: "github",
+						type: "text"
+					}
+				]
+			},
+			{
+				...seoFields,
+				fields: [...seoFields.fields, {
+					name: "jsonLd",
+					type: "group",
+					label: "Structured Data Overrides",
+					admin: { description: "Used in JSON-LD Person schema on author pages and article bylines." },
+					fields: [
+						{
+							name: "jobTitle",
+							type: "text",
+							admin: { description: "schema.org jobTitle (defaults to role if empty)" }
+						},
+						{
+							name: "worksFor",
+							type: "text",
+							admin: { description: "Organization name for schema.org worksFor" }
+						},
+						{
+							name: "sameAs",
+							type: "array",
+							admin: { description: "Extra canonical URLs for this person (Wikipedia, Crunchbase, etc.)" },
+							fields: [{
+								name: "url",
+								type: "text",
+								required: true
+							}]
+						}
+					]
+				}]
+			}
+		]
+	};
+}
+//#endregion
+//#region src/cms/blocks/language-options.ts
+/** Shared language options for CMS code blocks and Lexical CodeBlock feature. */
+const languageOptions = [
+	{
+		label: "TypeScript",
+		value: "typescript"
+	},
+	{
+		label: "JavaScript",
+		value: "javascript"
+	},
+	{
+		label: "Python",
+		value: "python"
+	},
+	{
+		label: "Bash / Shell",
+		value: "bash"
+	},
+	{
+		label: "Shell",
+		value: "shell"
+	},
+	{
+		label: "JSON",
+		value: "json"
+	},
+	{
+		label: "CSS",
+		value: "css"
+	},
+	{
+		label: "HTML",
+		value: "html"
+	},
+	{
+		label: "Rust",
+		value: "rust"
+	},
+	{
+		label: "Go",
+		value: "go"
+	},
+	{
+		label: "YAML",
+		value: "yaml"
+	},
+	{
+		label: "Markdown",
+		value: "markdown"
+	},
+	{
+		label: "Plain Text",
+		value: "plaintext"
+	}
+];
+const codeBlockLanguages = Object.fromEntries(languageOptions.map((opt) => [opt.value, opt.label]));
+const defaultCodeLanguage = "plaintext";
+//#endregion
+//#region src/cms/blocks/code.ts
+const codeBlock = {
+	slug: "code",
+	labels: {
+		singular: "Code Block",
+		plural: "Code Blocks"
+	},
+	fields: [
+		{
+			name: "language",
+			type: "select",
+			defaultValue: "typescript",
+			options: languageOptions
+		},
+		{
+			name: "filename",
+			type: "text",
+			admin: { description: "Optional filename label shown above the block" }
+		},
+		{
+			name: "code",
+			type: "code",
+			required: true,
+			admin: { language: "typescript" }
+		}
+	]
+};
+//#endregion
+//#region src/cms/blocks/code-tabs.ts
+const codeTabsBlock = {
+	slug: "code-tabs",
+	labels: {
+		singular: "Code Tabs",
+		plural: "Code Tabs"
+	},
+	fields: [{
+		name: "tabs",
+		type: "array",
+		required: true,
+		minRows: 1,
+		fields: [
+			{
+				name: "label",
+				type: "text",
+				required: true,
+				admin: { description: "Tab label (e.g. Windows, Linux, Android)" }
+			},
+			{
+				name: "language",
+				type: "select",
+				defaultValue: "bash",
+				options: languageOptions
+			},
+			{
+				name: "code",
+				type: "code",
+				required: true,
+				admin: { language: "bash" }
+			}
+		]
+	}]
+};
+//#endregion
+//#region src/cms/blocks/download-cta.ts
+const downloadCtaBlock = {
+	slug: "download-cta",
+	labels: {
+		singular: "Download CTA",
+		plural: "Download CTAs"
+	},
+	fields: [
+		{
+			name: "eyebrow",
+			type: "text",
+			localized: true
+		},
+		{
+			name: "heading",
+			type: "text",
+			required: true,
+			localized: true
+		},
+		{
+			name: "headingAccent",
+			type: "text",
+			localized: true
+		},
+		{
+			name: "description",
+			type: "textarea",
+			localized: true
+		},
+		{
+			name: "submitLabel",
+			type: "text",
+			required: true,
+			localized: true
+		},
+		{
+			name: "downloadUrl",
+			type: "text",
+			required: true
+		},
+		{
+			name: "downloadLabel",
+			type: "text",
+			required: true,
+			localized: true
+		},
+		{
+			name: "successMessage",
+			type: "textarea",
+			localized: true
+		},
+		{
+			name: "consent",
+			type: "textarea",
+			localized: true
+		},
+		{
+			name: "footnote",
+			type: "textarea",
+			localized: true
+		}
+	]
+};
+//#endregion
+//#region src/cms/blocks/image.ts
+const imageBlock = {
+	slug: "image",
+	labels: {
+		singular: "Image",
+		plural: "Images"
+	},
+	fields: [
+		{
+			name: "image",
+			type: "upload",
+			relationTo: "media",
+			required: true
+		},
+		{
+			name: "caption",
+			type: "text",
+			localized: true
+		},
+		{
+			name: "size",
+			type: "select",
+			defaultValue: "full",
+			options: [
+				{
+					label: "Full Width",
+					value: "full"
+				},
+				{
+					label: "Wide",
+					value: "wide"
+				},
+				{
+					label: "Medium",
+					value: "medium"
+				}
+			]
+		}
+	]
+};
+//#endregion
+//#region src/cms/blocks/video.ts
+const videoBlock = {
+	slug: "video",
+	labels: {
+		singular: "Video",
+		plural: "Videos"
+	},
+	fields: [
+		{
+			name: "video",
+			type: "upload",
+			relationTo: "media",
+			required: true,
+			filterOptions: { mimeType: { contains: "video" } }
+		},
+		{
+			name: "caption",
+			type: "text",
+			localized: true
+		},
+		{
+			name: "size",
+			type: "select",
+			defaultValue: "full",
+			options: [
+				{
+					label: "Full Width",
+					value: "full"
+				},
+				{
+					label: "Wide",
+					value: "wide"
+				},
+				{
+					label: "Medium",
+					value: "medium"
+				}
+			]
+		}
+	]
+};
+//#endregion
+//#region src/cms/lexical/editor.ts
+const richTextFeatures = ({ defaultFeatures }) => [
+	...defaultFeatures.filter((feature) => feature.key !== "upload"),
+	UploadFeature({ collections: { media: { fields: [{
+		name: "caption",
+		type: "text"
+	}] } } }),
+	BlocksFeature({ blocks: [CodeBlock({
+		languages: codeBlockLanguages,
+		defaultLanguage: defaultCodeLanguage
+	}), videoBlock] }),
+	EXPERIMENTAL_TableFeature()
+];
+/**
+* Shared Lexical editor for every `richText` field.
+*
+* Adds `CodeBlock`, inline `video` block, media upload captions, and
+* `EXPERIMENTAL_TableFeature` on top of Payload defaults.
+*/
+const richTextEditor = () => lexicalEditor({ features: richTextFeatures });
+/** Resolve Lexical editor config for seed scripts / markdown conversion. */
+async function getRichTextEditorConfig(config) {
+	return editorConfigFactory.fromFeatures({
+		config,
+		features: richTextFeatures
+	});
+}
+//#endregion
+//#region src/cms/blocks/rich-text.ts
+const richTextBlock = {
+	slug: "rich-text",
+	labels: {
+		singular: "Rich Text",
+		plural: "Rich Text Blocks"
+	},
+	fields: [{
+		name: "content",
+		type: "richText",
+		localized: true,
+		editor: richTextEditor()
+	}]
+};
+//#endregion
+//#region src/cms/blocks/steps.ts
+const stepsBlock = {
+	slug: "steps",
+	labels: {
+		singular: "Steps List",
+		plural: "Steps Lists"
+	},
+	fields: [{
+		name: "items",
+		type: "array",
+		required: true,
+		minRows: 1,
+		fields: [
+			{
+				name: "title",
+				type: "text",
+				required: true,
+				localized: true
+			},
+			{
+				name: "description",
+				type: "textarea",
+				localized: true
+			},
+			{
+				name: "avatar",
+				type: "upload",
+				relationTo: "media",
+				admin: { description: "Optional avatar or icon shown next to the step" }
+			}
+		]
+	}]
+};
+//#endregion
+//#region src/cms/blocks/leaf-blocks.ts
+const leafBlocks = [
+	richTextBlock,
+	codeBlock,
+	codeTabsBlock,
+	imageBlock,
+	videoBlock,
+	downloadCtaBlock,
+	stepsBlock
+];
+//#endregion
+//#region src/cms/blocks/accordion.ts
+const accordionBlock = {
+	slug: "accordion",
+	labels: {
+		singular: "Accordion",
+		plural: "Accordions"
+	},
+	fields: [{
+		name: "items",
+		type: "array",
+		required: true,
+		minRows: 1,
+		fields: [
+			{
+				name: "title",
+				type: "text",
+				required: true,
+				localized: true
+			},
+			{
+				name: "defaultOpen",
+				type: "checkbox",
+				defaultValue: false
+			},
+			{
+				name: "content",
+				type: "blocks",
+				blocks: leafBlocks,
+				localized: true
+			}
+		]
+	}]
+};
+//#endregion
+//#region src/cms/blocks/section-heading.ts
+const sectionHeadingBlock = {
+	slug: "section-heading",
+	labels: {
+		singular: "Section Heading",
+		plural: "Section Headings"
+	},
+	fields: [{
+		name: "text",
+		type: "text",
+		required: true,
+		localized: true
+	}]
+};
+//#endregion
+//#region src/cms/blocks/index.ts
+const blogContentBlocks = [
+	richTextBlock,
+	codeBlock,
+	codeTabsBlock,
+	imageBlock,
+	videoBlock,
+	downloadCtaBlock,
+	stepsBlock,
+	accordionBlock
+];
+const pageContentBlocks = [
+	richTextBlock,
+	codeBlock,
+	codeTabsBlock,
+	imageBlock,
+	stepsBlock,
+	accordionBlock
+];
+const showcaseContentBlocks = [
+	sectionHeadingBlock,
+	richTextBlock,
+	codeBlock,
+	imageBlock
+];
+//#endregion
+//#region src/cms/hooks/set-published-at.ts
+const setPublishedAt = ({ data }) => {
+	if (data && !data.publishedAt && data._status === "published") data.publishedAt = (/* @__PURE__ */ new Date()).toISOString();
+	return data;
+};
+//#endregion
+//#region src/cms/shared/drafts-with-autosave.ts
+const draftsWithAutosave = {
+	maxPerDoc: 25,
+	drafts: {
+		autosave: { interval: 800 },
+		schedulePublish: true
+	}
+};
+//#endregion
+//#region src/cms/collections/createBlogPosts.ts
+/** Stock blog-posts collection (no site revalidation — add via overrides.hooks). */
+function createBlogPosts(access) {
+	return {
+		slug: "blog-posts",
+		defaultSort: "-publishedAt",
+		admin: {
+			useAsTitle: "title",
+			defaultColumns: [
+				"title",
+				"slug",
+				"author",
+				"publishedAt",
+				"_status"
+			]
+		},
+		access: {
+			read: access.adminOrPublished,
+			create: access.adminOnly,
+			update: access.adminOnly,
+			delete: access.adminOnly
+		},
+		versions: draftsWithAutosave,
+		hooks: { beforeChange: [setPublishedAt] },
+		fields: [
+			{
+				name: "title",
+				type: "text",
+				required: true,
+				localized: true
+			},
+			{
+				name: "slug",
+				type: "text",
+				required: true,
+				unique: true,
+				admin: {
+					position: "sidebar",
+					description: "URL-friendly identifier. Not localized — one slug per post."
+				},
+				hooks: { beforeValidate: [slugify] }
+			},
+			{
+				name: "coverImage",
+				type: "upload",
+				relationTo: "media"
+			},
+			{
+				name: "imageAlt",
+				type: "text",
+				localized: true,
+				admin: { description: "Alt text used for the auto-generated social/OG image (`og:image:alt`). Should describe the post for screen readers." }
+			},
+			{
+				name: "excerpt",
+				type: "textarea",
+				localized: true,
+				admin: { description: "Short summary shown in listing cards and meta description fallback." }
+			},
+			{
+				name: "content",
+				type: "blocks",
+				localized: true,
+				blocks: blogContentBlocks
+			},
+			{
+				name: "author",
+				type: "relationship",
+				relationTo: "authors",
+				admin: { position: "sidebar" }
+			},
+			{
+				name: "category",
+				type: "relationship",
+				relationTo: "categories",
+				admin: { position: "sidebar" }
+			},
+			{
+				name: "readingTime",
+				type: "number",
+				min: 1,
+				admin: {
+					position: "sidebar",
+					description: "Estimated reading time in minutes."
+				}
+			},
+			{
+				name: "publishedAt",
+				type: "date",
+				admin: {
+					position: "sidebar",
+					date: { pickerAppearance: "dayAndTime" },
+					description: "Auto-filled on first publish if left empty."
+				}
+			},
+			{
+				name: "showLatestNews",
+				type: "checkbox",
+				defaultValue: true,
+				admin: {
+					position: "sidebar",
+					description: "Show a \"Latest News\" section at the bottom of this post."
+				}
+			},
+			seoFields
+		]
+	};
+}
+//#endregion
+//#region src/cms/collections/createCategories.ts
+function createCategories(access) {
+	return {
+		slug: "categories",
+		admin: {
+			useAsTitle: "name",
+			defaultColumns: ["name", "slug"]
+		},
+		access: {
+			read: access.publicRead,
+			create: access.adminOnly,
+			update: access.adminOnly,
+			delete: access.adminOnly
+		},
+		fields: [
+			{
+				name: "name",
+				type: "text",
+				required: true,
+				localized: true
+			},
+			{
+				name: "slug",
+				type: "text",
+				required: true,
+				unique: true,
+				admin: { position: "sidebar" },
+				hooks: { beforeValidate: [slugify] }
+			},
+			{
+				name: "description",
+				type: "textarea",
+				localized: true
+			}
+		]
+	};
+}
+//#endregion
+//#region src/cms/collections/createChangelog.ts
+/**
+* Stock changelog collection (shared fields only).
+* Site-specific body / GitHub / related-block fields — add via `overrides.fields`.
+* Revalidation — add via `overrides.hooks`.
+*/
+function createChangelog(access) {
+	return {
+		slug: "changelog",
+		labels: {
+			singular: "Changelog",
+			plural: "Changelog"
+		},
+		defaultSort: "-releaseDate",
+		admin: {
+			useAsTitle: "title",
+			defaultColumns: [
+				"title",
+				"version",
+				"versionType",
+				"tags",
+				"releaseDate",
+				"_status"
+			]
+		},
+		access: {
+			read: access.adminOrPublished,
+			create: access.adminOnly,
+			update: access.adminOnly,
+			delete: access.adminOnly
+		},
+		versions: draftsWithAutosave,
+		fields: [
+			{
+				name: "title",
+				type: "text",
+				required: true,
+				localized: true,
+				admin: { description: "Release headline shown on the changelog detail page (e.g. \"Added Solana Support\")." }
+			},
+			{
+				name: "slug",
+				type: "text",
+				required: true,
+				unique: true,
+				admin: {
+					position: "sidebar",
+					description: "URL-friendly identifier. Not localized — one slug per entry."
+				},
+				hooks: { beforeValidate: [slugify] }
+			},
+			{
+				name: "version",
+				type: "text",
+				admin: {
+					position: "sidebar",
+					description: "Optional semantic version label shown in the badge, e.g. v1.1.0 or 2.3.0. Omit for non-versioned announcements."
+				}
+			},
+			{
+				name: "versionType",
+				type: "select",
+				options: [
+					{
+						label: "Major",
+						value: "major"
+					},
+					{
+						label: "Minor",
+						value: "minor"
+					},
+					{
+						label: "Patch",
+						value: "patch"
+					}
+				],
+				admin: {
+					position: "sidebar",
+					description: "Release line for badge styling (major / minor / patch). Editors set this explicitly."
+				}
+			},
+			{
+				name: "releaseDate",
+				type: "date",
+				required: true,
+				admin: {
+					position: "sidebar",
+					date: {
+						pickerAppearance: "dayOnly",
+						displayFormat: "MMM d, yyyy"
+					}
+				}
+			},
+			{
+				name: "tags",
+				type: "relationship",
+				relationTo: "changelog-tags",
+				hasMany: true,
+				label: "Tags",
+				admin: {
+					position: "sidebar",
+					description: "Editor-managed tags from the Changelog Tags collection."
+				}
+			},
+			{
+				name: "heroImage",
+				type: "upload",
+				relationTo: "media",
+				admin: { description: "Large visual above the article body on the changelog detail page." }
+			},
+			{
+				name: "summary",
+				type: "textarea",
+				localized: true,
+				admin: { description: "Short excerpt for listing cards and previews." }
+			}
+		]
+	};
+}
+//#endregion
+//#region src/cms/collections/createChangelogTags.ts
+/** Stock changelog-tags (no site revalidation — add via overrides.hooks). */
+function createChangelogTags(access) {
+	return {
+		slug: "changelog-tags",
+		defaultSort: "order",
+		admin: {
+			useAsTitle: "name",
+			defaultColumns: [
+				"name",
+				"slug",
+				"order"
+			],
+			description: "Tags shown on changelog entries."
+		},
+		access: {
+			read: access.publicRead,
+			create: access.adminOnly,
+			update: access.adminOnly,
+			delete: access.adminOnly
+		},
+		fields: [
+			{
+				name: "name",
+				type: "text",
+				required: true,
+				localized: true
+			},
+			{
+				name: "slug",
+				type: "text",
+				required: true,
+				unique: true,
+				admin: {
+					position: "sidebar",
+					description: "URL-friendly identifier used by listing filters."
+				},
+				hooks: { beforeValidate: [slugify] }
+			},
+			{
+				name: "order",
+				type: "number",
+				defaultValue: 0,
+				admin: {
+					position: "sidebar",
+					description: "Display order in admin lists (ascending). Ties broken by name."
+				}
+			},
+			{
+				name: "description",
+				type: "textarea",
+				localized: true,
+				admin: { description: "Optional context shown to editors. Not rendered publicly yet." }
+			}
+		]
+	};
+}
+//#endregion
+//#region src/cms/collections/createMedia.ts
+/** Stock media upload collection (always publicly readable once uploaded). */
+function createMedia(access) {
+	return {
+		slug: "media",
+		admin: {
+			useAsTitle: "filename",
+			defaultColumns: [
+				"filename",
+				"alt",
+				"updatedAt"
+			]
+		},
+		access: {
+			read: access.publicRead,
+			create: access.adminOnly,
+			update: access.adminOnly,
+			delete: access.adminOnly
+		},
+		upload: {
+			imageSizes: [
+				{
+					name: "thumbnail",
+					width: 400,
+					height: 300,
+					position: "centre"
+				},
+				{
+					name: "card",
+					width: 768,
+					height: 512,
+					position: "centre"
+				},
+				{
+					name: "tablet",
+					width: 1024,
+					height: void 0,
+					position: "centre"
+				}
+			],
+			adminThumbnail: "thumbnail",
+			mimeTypes: [
+				"image/*",
+				"video/*",
+				"application/pdf"
+			]
+		},
+		fields: [{
+			name: "alt",
+			type: "text",
+			required: true,
+			localized: true
+		}]
+	};
+}
+//#endregion
+//#region src/cms/collections/createPages.ts
+function createContentPageCollection(access, slug) {
+	return {
+		slug,
+		admin: {
+			useAsTitle: "title",
+			defaultColumns: [
+				"title",
+				"slug",
+				"publishedAt",
+				"_status"
+			]
+		},
+		access: {
+			read: access.adminOrPublished,
+			create: access.adminOnly,
+			update: access.adminOnly,
+			delete: access.adminOnly
+		},
+		versions: draftsWithAutosave,
+		hooks: { beforeChange: [setPublishedAt] },
+		fields: [
+			{
+				name: "title",
+				type: "text",
+				required: true,
+				localized: true
+			},
+			{
+				name: "slug",
+				type: "text",
+				required: true,
+				unique: true,
+				admin: {
+					position: "sidebar",
+					description: "URL-friendly identifier. Not localized — one slug per page."
+				},
+				hooks: { beforeValidate: [slugify] }
+			},
+			{
+				name: "content",
+				type: "blocks",
+				localized: true,
+				blocks: pageContentBlocks
+			},
+			{
+				name: "publishedAt",
+				type: "date",
+				admin: {
+					position: "sidebar",
+					date: { pickerAppearance: "dayAndTime" },
+					description: "Auto-filled on first publish if left empty."
+				}
+			},
+			seoFields
+		]
+	};
+}
+function createPages(access) {
+	return createContentPageCollection(access, "pages");
+}
+function createLegalPages(access) {
+	return createContentPageCollection(access, "legal-pages");
+}
+//#endregion
+//#region src/cms/collections/createUsers.ts
+function createUsers(access) {
+	return {
+		slug: "users",
+		admin: { useAsTitle: "email" },
+		auth: true,
+		access: {
+			read: access.adminOnly,
+			create: access.adminOnly,
+			update: access.adminOnly,
+			delete: access.adminOnly,
+			admin: access.adminOnly
+		},
+		fields: []
+	};
+}
+//#endregion
+//#region src/cms/globals/createSiteSettings.ts
+function createSiteSettings(access) {
+	return {
+		slug: "site-settings",
+		label: "Site Settings",
+		access: {
+			read: access.publicRead,
+			update: access.adminOnly
+		},
+		fields: [
+			{
+				name: "name",
+				type: "text",
+				required: true,
+				localized: true,
+				admin: { description: "Public site name used in titles and structured data." }
+			},
+			{
+				name: "defaultDescription",
+				type: "textarea",
+				required: true,
+				localized: true,
+				admin: { description: "Fallback meta description when a page does not define its own." }
+			},
+			{
+				name: "defaultOgImage",
+				type: "upload",
+				relationTo: "media",
+				admin: { description: "Default Open Graph image (1200×630 recommended)." }
+			},
+			{
+				name: "organization",
+				type: "group",
+				label: "Organization",
+				fields: [
+					{
+						name: "name",
+						type: "text",
+						required: true
+					},
+					{
+						name: "legalName",
+						type: "text"
+					},
+					{
+						name: "description",
+						type: "textarea",
+						localized: true
+					},
+					{
+						name: "logo",
+						type: "upload",
+						relationTo: "media"
+					},
+					{
+						name: "foundingDate",
+						type: "text",
+						admin: { description: "Year or ISO date for schema.org structured data." }
+					}
+				]
+			},
+			{
+				name: "social",
+				type: "group",
+				label: "Social Profiles",
+				fields: [
+					{
+						name: "twitter",
+						type: "text"
+					},
+					{
+						name: "github",
+						type: "text"
+					},
+					{
+						name: "linkedin",
+						type: "text"
+					}
+				]
+			}
+		]
+	};
+}
+//#endregion
+//#region src/cms/applyOverride.ts
+function mergeHooks(base, extra) {
+	const keys = /* @__PURE__ */ new Set([...Object.keys(base ?? {}), ...Object.keys(extra ?? {})]);
+	const merged = {};
+	keys.forEach((key) => {
+		const combined = [...base?.[key] ?? [], ...extra?.[key] ?? []];
+		if (combined.length) merged[key] = combined;
+	});
+	return merged;
+}
+function applyOverride(base, override) {
+	if (override === false) return null;
+	if (!override) return base;
+	const next = {
+		...base,
+		...override.admin && { admin: {
+			...base.admin,
+			...override.admin
+		} },
+		...override.access && { access: {
+			...base.access,
+			...override.access
+		} },
+		...override.fields && { fields: override.fields(base.fields ?? []) },
+		...override.hooks && { hooks: mergeHooks(base.hooks, override.hooks) }
+	};
+	return override.config ? override.config(next) : next;
+}
+const applyCollectionOverride = (base, override) => applyOverride(base, override);
+const applyGlobalOverride = (base, override) => applyOverride(base, override);
+//#endregion
+//#region src/cms/overrides.ts
+/** Slugs of the stock collections shipped by `buildCmsConfig`, in registration order. */
+const STOCK_COLLECTION_SLUGS = [
+	"users",
+	"api-tokens",
+	"media",
+	"authors",
+	"categories",
+	"blog-posts",
+	"pages",
+	"legal-pages",
+	"changelog-tags",
+	"changelog"
+];
+//#endregion
+//#region src/cms/buildCmsConfig.ts
+/** Drop keys whose value is `undefined` so they don't clobber Payload defaults. */
+function defined(obj) {
+	return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== void 0));
+}
+/**
+* Build a Payload config from shared stock collections/globals plus site
+* overrides and extras. Types are still generated in the consuming app.
+*/
+function buildCmsConfig(options) {
+	const overrides = options.overrides ?? {};
+	const access = createAccessHelpers({
+		...options.access,
+		apiTokens: options.access?.apiTokens ?? overrides["api-tokens"] !== false
+	});
+	const stock = {
+		"users": createUsers(access),
+		"api-tokens": createApiTokens(access),
+		"media": createMedia(access),
+		"authors": createAuthors(access),
+		"categories": createCategories(access),
+		"blog-posts": createBlogPosts(access),
+		"pages": createPages(access),
+		"legal-pages": createLegalPages(access),
+		"changelog-tags": createChangelogTags(access),
+		"changelog": createChangelog(access)
+	};
+	const collections = [...STOCK_COLLECTION_SLUGS.map((slug) => applyCollectionOverride(stock[slug], overrides[slug])).filter((c) => c !== null), ...options.extraCollections ?? []];
+	const siteSettings = applyGlobalOverride(createSiteSettings(access), overrides["site-settings"]);
+	const globals = [...siteSettings ? [siteSettings] : [], ...options.extraGlobals ?? []];
+	return buildConfig({
+		...options.payload,
+		...defined({
+			sharp: options.sharp,
+			cors: options.cors,
+			csrf: options.csrf,
+			plugins: options.plugins
+		}),
+		secret: options.secret,
+		db: options.db,
+		admin: {
+			user: "users",
+			...options.admin
+		},
+		editor: options.editor ?? richTextEditor(),
+		collections,
+		...globals.length ? { globals } : {},
+		localization: {
+			locales: options.locales.map((code) => ({
+				code,
+				label: code.toUpperCase()
+			})),
+			defaultLocale: options.defaultLocale,
+			fallback: true
+		},
+		typescript: options.typescript ?? { outputFile: "src/payload-types.ts" }
+	});
+}
+//#endregion
+//#region src/cms/requireEnv.ts
+const log = createLogger("env");
+/**
+* Read a required env var. During Next.js `phase-production-build` and
+* `generate:importmap` (when NEXT_PHASE is unset) returns "" instead of throwing,
+* because those phases do not connect to the DB.
+*/
+function requireEnvAtRuntime(name) {
+	const value = process.env[name];
+	const isBuildTime = !process.env.NEXT_PHASE || process.env.NEXT_PHASE === "phase-production-build";
+	if (!value && !isBuildTime) {
+		log.error(`Missing required environment variable: ${name}`);
+		throw new Error(`Missing required environment variable: ${name}`);
+	}
+	return value ?? "";
+}
+//#endregion
+//#region src/cms/createS3MediaPlugin.ts
+/** Payload S3 storage plugin wired for the stock `media` collection. */
+function createS3MediaPlugin(options = {}) {
+	const bucket = options.bucket ?? process.env.AWS_S3_BUCKET ?? "";
+	const endpoint = options.endpoint ?? process.env.AWS_S3_ENDPOINT ?? "";
+	const forcePathStyle = options.forcePathStyle ?? process.env.AWS_S3_FORCE_PATH_STYLE === "true";
+	return s3Storage({
+		enabled: Boolean(bucket),
+		collections: { [options.collection ?? "media"]: true },
+		bucket,
+		config: {
+			credentials: {
+				accessKeyId: options.accessKeyId ?? process.env.AWS_ACCESS_KEY_ID ?? "",
+				secretAccessKey: options.secretAccessKey ?? process.env.AWS_SECRET_ACCESS_KEY ?? ""
+			},
+			region: options.region ?? process.env.AWS_S3_REGION ?? "us-east-1",
+			...endpoint ? { endpoint } : {},
+			...forcePathStyle ? { forcePathStyle: true } : {}
+		}
+	});
+}
+//#endregion
+export { downloadCtaBlock as A, createAccessHelpers as B, leafBlocks as C, richTextEditor as D, getRichTextEditorConfig as E, languageOptions as F, createAuthors as I, seoFields as L, codeBlock as M, codeBlockLanguages as N, videoBlock as O, defaultCodeLanguage as P, slugify as R, accordionBlock as S, richTextBlock as T, setPublishedAt as _, applyCollectionOverride as a, showcaseContentBlocks as b, createUsers as c, createMedia as d, createChangelogTags as f, draftsWithAutosave as g, createBlogPosts as h, STOCK_COLLECTION_SLUGS as i, codeTabsBlock as j, imageBlock as k, createLegalPages as l, createCategories as m, requireEnvAtRuntime as n, applyGlobalOverride as o, createChangelog as p, buildCmsConfig as r, createSiteSettings as s, createS3MediaPlugin as t, createPages as u, blogContentBlocks as v, stepsBlock as w, sectionHeadingBlock as x, pageContentBlocks as y, createApiTokens as z };
+
+//# sourceMappingURL=cms-5bS91IRZ.mjs.map