ADDED - Admin SEO page, robots/sitemap hardening and media/maintenance security fixes
SEO - New Settings > SEO admin page (seo_settings in app_config): indexing switch, Google/Bing verification, X handle, JSON-LD identity (Person/Organization, sameAs), per-locale keywords, readiness checklist and open links for sitemap.xml / robots.txt / manifest. - robots.txt is now dynamic: disallows admin, api, success and coming-soon paths; blocks everything while indexing is off or maintenance is on. - sitemap.xml carries hreflang alternates per URL, lists only categories with published projects, and is empty while hidden. - Metadata: robots + verification meta, og:locale in de_DE/en_US/ar_AR form, alternateLocale, twitter site/creator, project cover as OG image with article type, noindex on /success and /coming-soon. - JSON-LD: WebSite + publisher graph on all public pages, CreativeWork per project (view-mode independent). Security - Maintenance bypass now requires a correctly signed admin cookie; the middleware previously only checked the cookie existed. Token helpers moved to lib/admin-session-token.ts (shared by proxy.ts and lib/admin-auth.ts). - Media uploads: magic-byte validation against the declared type, SVG sanitization (script/handlers/foreignObject/javascript: rejected), upload folder sanitized, kind inferred from the real file. - Media route: fixed prefix-based path check that accepted sibling directories, unknown extensions return 404, nosniff header, CSP sandbox on SVG, gif content type added. - External media URLs: protocol-relative (//host) URLs rejected. Portfolio - Project and category slugs share /portfolio/[slug]; saving now rejects a slug already used on the other side instead of silently shadowing it. Tooling/docs - Lint: ignore scripts/legacy-prisma-seed.cjs, drop unused import. - New docs/SEO.md; FEATURES, ARCHITECTURE (Drizzle instead of Prisma), admin spec and CLAUDE.md updated. - Tests for all of the above (unit + integration); suite green.
This commit is contained in:
moh
@@ -0,0 +1,145 @@
|
||||
import type { AppLocale } from "./locale";
|
||||
|
||||
/**
|
||||
* Site-wide SEO configuration stored as one JSON blob in `app_config`
|
||||
* (key `seo_settings`). Everything here is pure: parsing/normalizing only.
|
||||
* Read/write goes through `lib/app-config.ts`.
|
||||
*/
|
||||
export const SEO_SETTINGS_KEY = "seo_settings";
|
||||
|
||||
export type SeoStructuredDataType = "Person" | "Organization";
|
||||
|
||||
export type SeoLocaleSettings = {
|
||||
/** Comma-separated keywords (optional, low SEO weight but harmless). */
|
||||
keywords: string;
|
||||
};
|
||||
|
||||
export type SeoSettings = {
|
||||
/** Master switch: false → robots disallow all + `noindex` on every page. */
|
||||
allowIndexing: boolean;
|
||||
/** `google-site-verification` meta value. */
|
||||
googleSiteVerification: string;
|
||||
/** `msvalidate.01` meta value (Bing Webmaster). */
|
||||
bingSiteVerification: string;
|
||||
/** `@handle` used for twitter:site / twitter:creator. */
|
||||
twitterHandle: string;
|
||||
/** Publisher shape used for JSON-LD on the home page. */
|
||||
structuredDataType: SeoStructuredDataType;
|
||||
/** Name shown in JSON-LD (falls back to the site name when empty). */
|
||||
structuredDataName: string;
|
||||
/** Person job title / Organization tagline used in JSON-LD. */
|
||||
structuredDataJobTitle: string;
|
||||
/** Social profile URLs for `sameAs` in JSON-LD. */
|
||||
sameAs: string[];
|
||||
locales: Record<AppLocale, SeoLocaleSettings>;
|
||||
};
|
||||
|
||||
export function buildDefaultSeoSettings(): SeoSettings {
|
||||
return {
|
||||
allowIndexing: true,
|
||||
googleSiteVerification: "",
|
||||
bingSiteVerification: "",
|
||||
twitterHandle: "",
|
||||
structuredDataType: "Person",
|
||||
structuredDataName: "",
|
||||
structuredDataJobTitle: "",
|
||||
sameAs: [],
|
||||
locales: {
|
||||
ar: { keywords: "" },
|
||||
en: { keywords: "" },
|
||||
de: { keywords: "" },
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
function normalizeText(value: unknown, maxLength = 500): string {
|
||||
return typeof value === "string" ? value.trim().slice(0, maxLength) : "";
|
||||
}
|
||||
|
||||
/** Meta verification tokens are alphanumeric with `-` / `_`; anything else is dropped. */
|
||||
export function normalizeVerificationToken(value: unknown): string {
|
||||
const text = normalizeText(value, 200);
|
||||
|
||||
return /^[A-Za-z0-9_-]+$/.test(text) ? text : "";
|
||||
}
|
||||
|
||||
export function normalizeTwitterHandle(value: unknown): string {
|
||||
const text = normalizeText(value, 60).replace(/^https?:\/\/(www\.)?(twitter|x)\.com\//i, "").replace(/^@+/, "");
|
||||
|
||||
return /^[A-Za-z0-9_]{1,15}$/.test(text) ? `@${text}` : "";
|
||||
}
|
||||
|
||||
export function normalizeSameAs(value: unknown): string[] {
|
||||
const rawList = Array.isArray(value)
|
||||
? value
|
||||
: typeof value === "string"
|
||||
? value.split(/[\n,]+/)
|
||||
: [];
|
||||
|
||||
const urls = rawList
|
||||
.map((entry) => normalizeText(entry, 500))
|
||||
.filter((entry) => /^https:\/\/[^\s]+$/i.test(entry));
|
||||
|
||||
return Array.from(new Set(urls)).slice(0, 20);
|
||||
}
|
||||
|
||||
export function normalizeStructuredDataType(value: unknown): SeoStructuredDataType {
|
||||
return value === "Organization" ? "Organization" : "Person";
|
||||
}
|
||||
|
||||
export function normalizeKeywords(value: unknown): string {
|
||||
const text = normalizeText(value, 1000);
|
||||
|
||||
return text
|
||||
.split(",")
|
||||
.map((keyword) => keyword.trim())
|
||||
.filter(Boolean)
|
||||
.slice(0, 30)
|
||||
.join(", ");
|
||||
}
|
||||
|
||||
export function parseSeoSettingsValue(rawValue: string | null | undefined): SeoSettings {
|
||||
const defaults = buildDefaultSeoSettings();
|
||||
|
||||
if (!rawValue) {
|
||||
return defaults;
|
||||
}
|
||||
|
||||
try {
|
||||
const parsed = JSON.parse(rawValue) as Record<string, unknown>;
|
||||
const locales =
|
||||
parsed.locales && typeof parsed.locales === "object"
|
||||
? (parsed.locales as Record<string, Record<string, unknown> | undefined>)
|
||||
: {};
|
||||
|
||||
return {
|
||||
allowIndexing: parsed.allowIndexing !== false,
|
||||
googleSiteVerification: normalizeVerificationToken(parsed.googleSiteVerification),
|
||||
bingSiteVerification: normalizeVerificationToken(parsed.bingSiteVerification),
|
||||
twitterHandle: normalizeTwitterHandle(parsed.twitterHandle),
|
||||
structuredDataType: normalizeStructuredDataType(parsed.structuredDataType),
|
||||
structuredDataName: normalizeText(parsed.structuredDataName, 120),
|
||||
structuredDataJobTitle: normalizeText(parsed.structuredDataJobTitle, 160),
|
||||
sameAs: normalizeSameAs(parsed.sameAs),
|
||||
locales: {
|
||||
ar: { keywords: normalizeKeywords(locales.ar?.keywords) },
|
||||
en: { keywords: normalizeKeywords(locales.en?.keywords) },
|
||||
de: { keywords: normalizeKeywords(locales.de?.keywords) },
|
||||
},
|
||||
};
|
||||
} catch {
|
||||
return defaults;
|
||||
}
|
||||
}
|
||||
|
||||
/** Map an app locale to the Open Graph `og:locale` format. */
|
||||
export function toOpenGraphLocale(locale: AppLocale): string {
|
||||
switch (locale) {
|
||||
case "ar":
|
||||
return "ar_AR";
|
||||
case "en":
|
||||
return "en_US";
|
||||
default:
|
||||
return "de_DE";
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user