@joai/sites 0.0.0-stage → 0.1.1

package/dist/admin.d.mts

@@ -0,0 +1,25 @@
+'use client';
+import * as _$react from "react";
+import { AppEnv } from "@joai/core";
+//#region src/session.d.ts
+type SiteEditingSessionConfig = {
+  env?: AppEnv;
+  team: string;
+  brand?: string;
+  sessionStorageKey: string; /** Path for the admin login route (default `/admin-login`). */
+  loginPath?: string;
+};
+//#endregion
+//#region src/admin-login.d.ts
+type SiteAdminLoginClientProps = {
+  config: SiteEditingSessionConfig; /** Where to send the user after a successful exchange. Defaults to `/`. */
+  redirectTo?: string;
+  className?: string;
+};
+declare function SiteAdminLoginClient({
+  config,
+  redirectTo,
+  className
+}: SiteAdminLoginClientProps): _$react.JSX.Element;
+//#endregion
+export { SiteAdminLoginClient, type SiteAdminLoginClientProps };

package/dist/admin.mjs

@@ -0,0 +1,60 @@
+'use client';
+import { getAuthFragmentToken } from "@joai/sdk";
+import { useTranslations } from "next-intl";
+import { useEffect, useState } from "react";
+import { getLoginUrl } from "@joai/core";
+import { createSessionTokenStore } from "@joai/react";
+import { jsx } from "react/jsx-runtime";
+//#region src/session.ts
+function createSiteLoginUrl(config, redirect) {
+	const returnUrl = new URL(redirect);
+	returnUrl.searchParams.set("platform", "app");
+	return getLoginUrl(config.env ?? "mainnet", returnUrl.toString(), {
+		team: config.team,
+		brand: config.brand
+	});
+}
+function createSiteSessionStore(config) {
+	return createSessionTokenStore(config.sessionStorageKey);
+}
+async function exchangeSiteEditingSession(config, handoffToken) {
+	const { createClient } = await import("@joai/sdk");
+	const response = await createClient({
+		env: config.env ?? "mainnet",
+		team: config.team,
+		cache: { enabled: false }
+	}).auth.exchangeNativeSession(handoffToken);
+	if (!response.ok || !response.data?.token) throw new Error("session_exchange_failed");
+	if (!createSiteSessionStore(config).set(response.data.token)) throw new Error("session_store_failed");
+	return response.data.token;
+}
+//#endregion
+//#region src/admin-login.tsx
+function SiteAdminLoginClient({ config, redirectTo = "/", className }) {
+	const t = useTranslations("sites");
+	const [message, setMessage] = useState(t("loginRedirecting"));
+	useEffect(() => {
+		const loginUrl = () => createSiteLoginUrl(config, `${window.location.origin}${window.location.pathname}`);
+		const token = getAuthFragmentToken(window.location.href);
+		if (!token) {
+			window.location.replace(loginUrl());
+			return;
+		}
+		window.history.replaceState(null, "", `${window.location.pathname}${window.location.search}`);
+		exchangeSiteEditingSession(config, token).then(() => window.location.replace(redirectTo)).catch(() => {
+			setMessage(t("loginFailed"));
+			window.setTimeout(() => window.location.replace(loginUrl()), 1200);
+		});
+	}, [
+		config,
+		redirectTo,
+		t
+	]);
+	return /* @__PURE__ */ jsx("main", {
+		className,
+		"data-site-admin-login": "true",
+		children: /* @__PURE__ */ jsx("p", { children: message })
+	});
+}
+//#endregion
+export { SiteAdminLoginClient };

package/dist/editable.d.mts

@@ -0,0 +1,35 @@
+'use client';
+import { EditableContentProp, EditableImageProp } from "@joai/react";
+import * as _$react from "react";
+
+//#region src/editable.d.ts
+type EditableSiteTextProps = Omit<EditableContentProp, 'field'> & {
+  field: string;
+  fallback: string;
+};
+/**
+ * Editable text with a local fallback while the JoAi content has no value yet.
+ * When editing starts, the fallback is seeded into the draft so the field is visible.
+ */
+declare function EditableSiteText({
+  field,
+  fallback,
+  ...props
+}: EditableSiteTextProps): _$react.JSX.Element;
+type EditableSiteImageProps = Omit<EditableImageProp, 'field' | 'alt'> & {
+  field: string;
+  fallback: string;
+  alt: string;
+};
+/**
+ * Editable image with a local fallback while the JoAi content has no value yet.
+ */
+declare function EditableSiteImage({
+  field,
+  fallback,
+  alt,
+  className,
+  ...props
+}: EditableSiteImageProps): _$react.JSX.Element;
+//#endregion
+export { EditableSiteImage, EditableSiteImageProps, EditableSiteText, EditableSiteTextProps };

package/dist/editable.mjs

@@ -0,0 +1,61 @@
+'use client';
+"use client";
+import { EditableContent, EditableImage, useContent, useContentValue } from "@joai/react";
+import { useEffect } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/editable.tsx
+/**
+* Editable text with a local fallback while the JoAi content has no value yet.
+* When editing starts, the fallback is seeded into the draft so the field is visible.
+*/
+function EditableSiteText({ field, fallback, ...props }) {
+	const { isEditing, setValue } = useContent();
+	const value = useContentValue(field);
+	const text = typeof value === "string" || typeof value === "number" ? String(value) : "";
+	useEffect(() => {
+		if (isEditing && value === void 0) setValue(field, fallback);
+	}, [
+		fallback,
+		field,
+		isEditing,
+		setValue,
+		value
+	]);
+	if (!isEditing && !text) return /* @__PURE__ */ jsx(props.as ?? "span", {
+		className: props.className,
+		children: fallback
+	});
+	return /* @__PURE__ */ jsx(EditableContent, {
+		field,
+		...props
+	});
+}
+/**
+* Editable image with a local fallback while the JoAi content has no value yet.
+*/
+function EditableSiteImage({ field, fallback, alt, className, ...props }) {
+	const { isEditing, setValue } = useContent();
+	const value = useContentValue(field);
+	useEffect(() => {
+		if (isEditing && value === void 0) setValue(field, fallback);
+	}, [
+		fallback,
+		field,
+		isEditing,
+		setValue,
+		value
+	]);
+	if (!isEditing) return /* @__PURE__ */ jsx("img", {
+		src: typeof value === "string" && value ? value : fallback,
+		alt,
+		className
+	});
+	return /* @__PURE__ */ jsx(EditableImage, {
+		field,
+		alt,
+		className,
+		...props
+	});
+}
+//#endregion
+export { EditableSiteImage, EditableSiteText };

package/dist/index.d.mts

@@ -0,0 +1,255 @@
+import * as _$_joai_core0 from "@joai/core";
+import { AppEnv, Content, ContentDefinition, ContentValue, Site } from "@joai/core";
+import * as _$_joai_react0 from "@joai/react";
+import { ComponentType, ReactNode } from "react";
+
+//#region src/types.d.ts
+/** Path key for a theme page (`/` for home, `/about`, …). */
+type SiteThemePath = string;
+type SiteThemePageProps = {
+  site: Site;
+  content: Content;
+  params?: Record<string, string | string[]>;
+  searchParams?: Record<string, string | string[] | undefined>;
+};
+type SiteThemeMetadata = {
+  title?: string;
+  description?: string;
+  canonicalPath?: string;
+  openGraph?: {
+    title?: string;
+    description?: string;
+    images?: Array<{
+      url: string;
+      width?: number;
+      height?: number;
+      alt?: string;
+    }>;
+  };
+  robots?: {
+    index?: boolean;
+    follow?: boolean;
+  };
+  icons?: {
+    icon?: string | string[];
+    shortcut?: string;
+    apple?: string;
+  };
+};
+type SiteThemePage = {
+  Component: ComponentType<SiteThemePageProps>;
+  metadata?: (ctx: SiteThemePageProps) => SiteThemeMetadata | Promise<SiteThemeMetadata>;
+};
+type SiteThemeLayoutProps = {
+  site: Site;
+  content: Content;
+  children: ReactNode;
+};
+/**
+ * Stable theme contract for host apps.
+ * `slug` is the theme key from site settings (`settings.theme`), never the brand slug.
+ */
+type SiteThemeLocalConfig = {
+  team: string;
+  contentSlug: string;
+  contentId?: string;
+  contentName?: string;
+  contentDefinition?: ContentDefinition;
+  contentValues?: Record<string, ContentValue>;
+  siteName?: string;
+  siteUrl?: string;
+};
+type SiteTheme = {
+  slug: string;
+  pages: Record<SiteThemePath, SiteThemePage>;
+  Layout?: ComponentType<SiteThemeLayoutProps>; /** Absolute import id or relative path the host uses to load theme-scoped CSS. */
+  styles?: string;
+  metadata?: (ctx: {
+    site: Site;
+    content: Content;
+  }) => SiteThemeMetadata | Promise<SiteThemeMetadata>;
+  jsonLd?: (ctx: {
+    site: Site;
+    content: Content;
+  }) => Record<string, unknown> | Record<string, unknown>[];
+  sitemapPaths?: SiteThemePath[];
+  llmsTxt?: (ctx: {
+    site: Site;
+    content: Content;
+  }) => string; /** Used by the host when a local subdomain has no provisioned JoAi site yet. */
+  local?: SiteThemeLocalConfig;
+};
+type ResolvedSiteContext = {
+  site: Site;
+  content: Content;
+  themeKey: string;
+  contentSlug: string;
+};
+type SiteHostConfig = {
+  env?: _$_joai_core0.AppEnv; /** Shared secret expected as Bearer token on the revalidate route. */
+  revalidateSecret: string; /** Default ISR window in seconds when a page does not override it. */
+  revalidateSeconds?: number;
+};
+//#endregion
+//#region src/settings.d.ts
+/** Theme key from brand settings (`settings.theme`). Not the site brand slug. */
+declare function getSiteThemeKey(site: Site): string | null;
+/** Public content slug from brand settings (`settings.content`). */
+declare function getSiteContentSlug(site: Site): string | null;
+//#endregion
+//#region src/resolve.d.ts
+type ResolveSiteOptions = {
+  env?: AppEnv;
+  team?: string;
+};
+/** Normalize a Host header / URL host to the domain form used by sites.resolve. */
+declare function normalizeSiteHost(host: string): string;
+declare function resolveSiteByHost(host: string, options?: ResolveSiteOptions): Promise<Site | null>;
+declare function loadSiteContent(site: Site, options?: ResolveSiteOptions & {
+  slug?: string;
+}): Promise<Content | null>;
+declare function resolveSiteContext(host: string, options?: ResolveSiteOptions): Promise<ResolvedSiteContext | null>;
+//#endregion
+//#region src/revalidate.d.ts
+type RevalidateHandlerOptions = {
+  secret: string; /** Extra work after the default path/tag revalidation (optional). */
+  onRevalidate?: (contentSlug: string) => void | Promise<void>; /** Tag prefix used with `revalidateTag`. Defaults to `content`. */
+  tagPrefix?: string; /** Paths to revalidate. Defaults to `/` (full site). */
+  paths?: string[];
+};
+/**
+ * Secret-protected Next.js route handler for publish-time revalidation pings.
+ * Expects POST JSON `{ content: "<slug>" }` and `Authorization: Bearer <secret>`.
+ */
+declare function createRevalidateHandler(options: RevalidateHandlerOptions): (request: Request) => Promise<Response>;
+//#endregion
+//#region src/session.d.ts
+type SiteEditingSessionConfig = {
+  env?: AppEnv;
+  team: string;
+  brand?: string;
+  sessionStorageKey: string; /** Path for the admin login route (default `/admin-login`). */
+  loginPath?: string;
+};
+declare function createSiteLoginUrl(config: SiteEditingSessionConfig, redirect: string): string;
+declare function createSiteSessionStore(config: SiteEditingSessionConfig): _$_joai_react0.SessionTokenStore;
+declare function exchangeSiteEditingSession(config: SiteEditingSessionConfig, handoffToken: string): Promise<string>;
+declare function getSiteAdminLoginPath(config: SiteEditingSessionConfig): string;
+//#endregion
+//#region src/theme.d.ts
+declare function defineSiteTheme(theme: SiteTheme): SiteTheme;
+declare function createThemeRegistry(themes: SiteTheme[]): Map<string, SiteTheme>;
+declare function getThemePage(theme: SiteTheme, path: SiteThemePath): SiteThemePage;
+declare function listThemeSitemapPaths(theme: SiteTheme): SiteThemePath[];
+declare function normalizeThemePath(path: SiteThemePath): SiteThemePath;
+//#endregion
+//#region src/seo/metadata.d.ts
+type BuildSiteMetadataInput = {
+  site: Site;
+  baseUrl: string;
+  metadata: SiteThemeMetadata;
+  locale?: string;
+};
+type SiteMetadataResult = {
+  title: string;
+  description?: string;
+  alternates: {
+    canonical: string;
+  };
+  openGraph: {
+    title: string;
+    description?: string;
+    url: string;
+    siteName: string;
+    locale?: string;
+    type: 'website';
+    images?: Array<{
+      url: string;
+      width?: number;
+      height?: number;
+      alt?: string;
+    }>;
+  };
+  robots?: {
+    index?: boolean;
+    follow?: boolean;
+  };
+};
+declare function buildSiteMetadata({
+  site,
+  baseUrl,
+  metadata,
+  locale
+}: BuildSiteMetadataInput): SiteMetadataResult;
+//#endregion
+//#region src/seo/sitemap.d.ts
+type SiteSitemapEntry = {
+  url: string;
+  lastModified?: Date | string;
+  changeFrequency?: 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
+  priority?: number;
+};
+declare function buildSiteSitemap(baseUrl: string, paths: SiteThemePath[], options?: {
+  lastModified?: Date | string;
+  changeFrequency?: SiteSitemapEntry['changeFrequency'];
+  homePriority?: number;
+  defaultPriority?: number;
+}): SiteSitemapEntry[];
+//#endregion
+//#region src/seo/robots.d.ts
+type SiteRobotsResult = {
+  rules: Array<{
+    userAgent: string;
+    allow?: string | string[];
+    disallow?: string | string[];
+  }>;
+  sitemap: string;
+  host?: string;
+};
+declare function buildSiteRobots(baseUrl: string, options?: {
+  disallow?: string | string[];
+  allow?: string | string[];
+}): SiteRobotsResult;
+//#endregion
+//#region src/seo/json-ld.d.ts
+type LocalBusinessJsonLdInput = {
+  type?: 'LocalBusiness' | 'SportsClub' | 'HealthAndBeautyBusiness' | 'HomeAndConstructionBusiness' | string;
+  name: string;
+  url: string;
+  description?: string;
+  telephone?: string;
+  email?: string;
+  image?: string | string[];
+  address?: {
+    streetAddress?: string;
+    addressLocality?: string;
+    postalCode?: string;
+    addressCountry?: string;
+    addressRegion?: string;
+  };
+  openingHours?: string[];
+  sameAs?: string[];
+  geo?: {
+    latitude: number;
+    longitude: number;
+  };
+  priceRange?: string;
+};
+declare function buildLocalBusinessJsonLd(input: LocalBusinessJsonLdInput): Record<string, unknown>;
+declare function serializeJsonLd(data: Record<string, unknown> | Record<string, unknown>[]): string;
+//#endregion
+//#region src/seo/llms-txt.d.ts
+type LlmsTxtPage = {
+  title: string;
+  path: string;
+  summary?: string;
+};
+declare function buildLlmsTxt(input: {
+  name: string;
+  description?: string;
+  baseUrl: string;
+  pages: LlmsTxtPage[];
+  contact?: string;
+}): string;
+//#endregion
+export { BuildSiteMetadataInput, LlmsTxtPage, LocalBusinessJsonLdInput, ResolveSiteOptions, ResolvedSiteContext, RevalidateHandlerOptions, SiteEditingSessionConfig, SiteHostConfig, SiteMetadataResult, SiteRobotsResult, SiteSitemapEntry, SiteTheme, SiteThemeLayoutProps, SiteThemeLocalConfig, SiteThemeMetadata, SiteThemePage, SiteThemePageProps, SiteThemePath, buildLlmsTxt, buildLocalBusinessJsonLd, buildSiteMetadata, buildSiteRobots, buildSiteSitemap, createRevalidateHandler, createSiteLoginUrl, createSiteSessionStore, createThemeRegistry, defineSiteTheme, exchangeSiteEditingSession, getSiteAdminLoginPath, getSiteContentSlug, getSiteThemeKey, getThemePage, listThemeSitemapPaths, loadSiteContent, normalizeSiteHost, normalizeThemePath, resolveSiteByHost, resolveSiteContext, serializeJsonLd };

package/dist/index.mjs

@@ -0,0 +1,263 @@
+import { createClient } from "@joai/sdk";
+import { revalidatePath, revalidateTag } from "next/cache";
+import { getLoginUrl } from "@joai/core";
+import { createSessionTokenStore } from "@joai/react";
+//#region src/settings.ts
+const asString = (value) => {
+	if (typeof value !== "string") return null;
+	const trimmed = value.trim();
+	return trimmed === "" ? null : trimmed;
+};
+/** Theme key from brand settings (`settings.theme`). Not the site brand slug. */
+function getSiteThemeKey(site) {
+	return asString(site.settings?.theme);
+}
+/** Public content slug from brand settings (`settings.content`). */
+function getSiteContentSlug(site) {
+	return asString(site.settings?.content);
+}
+//#endregion
+//#region src/resolve.ts
+function createPublicClient(options = {}) {
+	return createClient({
+		env: options.env ?? "mainnet",
+		team: options.team,
+		cache: { enabled: false }
+	});
+}
+/** Normalize a Host header / URL host to the domain form used by sites.resolve. */
+function normalizeSiteHost(host) {
+	const trimmed = host.trim().toLowerCase();
+	if (!trimmed) return "";
+	try {
+		return (trimmed.includes("://") ? new URL(trimmed) : new URL(`https://${trimmed}`)).hostname;
+	} catch {
+		return trimmed.split("/")[0]?.split(":")[0] ?? trimmed;
+	}
+}
+async function resolveSiteByHost(host, options = {}) {
+	const domain = normalizeSiteHost(host);
+	if (!domain) return null;
+	const response = await createPublicClient(options).sites.resolveByDomain(domain);
+	return response.ok ? response.data : null;
+}
+async function loadSiteContent(site, options = {}) {
+	const slug = options.slug ?? getSiteContentSlug(site);
+	if (!slug) return null;
+	const response = await createPublicClient({
+		env: options.env,
+		team: options.team ?? site.team?.slug ?? void 0
+	}).content.getPublic(slug);
+	return response.ok ? response.data : null;
+}
+async function resolveSiteContext(host, options = {}) {
+	const site = await resolveSiteByHost(host, options);
+	if (!site) return null;
+	const themeKey = getSiteThemeKey(site);
+	const contentSlug = getSiteContentSlug(site);
+	if (!themeKey || !contentSlug) return null;
+	const content = await loadSiteContent(site, {
+		...options,
+		slug: contentSlug
+	});
+	if (!content) return null;
+	return {
+		site,
+		content,
+		themeKey,
+		contentSlug
+	};
+}
+//#endregion
+//#region src/revalidate.ts
+function extractBearer(request) {
+	const header = request.headers.get("authorization") ?? request.headers.get("Authorization");
+	if (!header) return null;
+	return /^Bearer\s+(.+)$/i.exec(header.trim())?.[1]?.trim() || null;
+}
+/**
+* Secret-protected Next.js route handler for publish-time revalidation pings.
+* Expects POST JSON `{ content: "<slug>" }` and `Authorization: Bearer <secret>`.
+*/
+function createRevalidateHandler(options) {
+	return async function POST(request) {
+		const token = extractBearer(request);
+		if (!options.secret || token !== options.secret) return Response.json({ error: "Unauthorized" }, { status: 401 });
+		let contentSlug = null;
+		try {
+			const body = await request.json();
+			contentSlug = typeof body.content === "string" ? body.content.trim() : null;
+		} catch {
+			return Response.json({ error: "Invalid JSON body" }, { status: 400 });
+		}
+		if (!contentSlug) return Response.json({ error: "Missing content" }, { status: 400 });
+		revalidateTag(`${options.tagPrefix ?? "content"}:${contentSlug}`, "max");
+		for (const path of options.paths ?? ["/"]) revalidatePath(path, "layout");
+		await options.onRevalidate?.(contentSlug);
+		return Response.json({
+			revalidated: true,
+			content: contentSlug
+		});
+	};
+}
+//#endregion
+//#region src/session.ts
+function createSiteLoginUrl(config, redirect) {
+	const returnUrl = new URL(redirect);
+	returnUrl.searchParams.set("platform", "app");
+	return getLoginUrl(config.env ?? "mainnet", returnUrl.toString(), {
+		team: config.team,
+		brand: config.brand
+	});
+}
+function createSiteSessionStore(config) {
+	return createSessionTokenStore(config.sessionStorageKey);
+}
+async function exchangeSiteEditingSession(config, handoffToken) {
+	const { createClient } = await import("@joai/sdk");
+	const response = await createClient({
+		env: config.env ?? "mainnet",
+		team: config.team,
+		cache: { enabled: false }
+	}).auth.exchangeNativeSession(handoffToken);
+	if (!response.ok || !response.data?.token) throw new Error("session_exchange_failed");
+	if (!createSiteSessionStore(config).set(response.data.token)) throw new Error("session_store_failed");
+	return response.data.token;
+}
+function getSiteAdminLoginPath(config) {
+	return config.loginPath ?? "/admin-login";
+}
+//#endregion
+//#region src/theme.ts
+function defineSiteTheme(theme) {
+	return theme;
+}
+function createThemeRegistry(themes) {
+	return new Map(themes.map((theme) => [theme.slug, theme]));
+}
+function getThemePage(theme, path) {
+	const normalized = normalizeThemePath(path);
+	return theme.pages[normalized] ?? theme.pages["/"] ?? null;
+}
+function listThemeSitemapPaths(theme) {
+	if (theme.sitemapPaths?.length) return theme.sitemapPaths.map(normalizeThemePath);
+	return Object.keys(theme.pages).map(normalizeThemePath);
+}
+function normalizeThemePath(path) {
+	if (!path || path === "/") return "/";
+	const withSlash = path.startsWith("/") ? path : `/${path}`;
+	return withSlash.length > 1 && withSlash.endsWith("/") ? withSlash.slice(0, -1) : withSlash;
+}
+//#endregion
+//#region src/seo/metadata.ts
+function absoluteUrl(baseUrl, path = "/") {
+	const base = baseUrl.replace(/\/$/, "");
+	if (!path || path === "/") return `${base}/`;
+	return `${base}${path.startsWith("/") ? path : `/${path}`}`;
+}
+function buildSiteMetadata({ site, baseUrl, metadata, locale = "de" }) {
+	const title = metadata.title ?? site.name ?? site.team?.name ?? site.slug;
+	const description = metadata.description;
+	const canonical = absoluteUrl(baseUrl, metadata.canonicalPath ?? "/");
+	const ogTitle = metadata.openGraph?.title ?? title;
+	const ogDescription = metadata.openGraph?.description ?? description;
+	return {
+		title,
+		description,
+		alternates: { canonical },
+		openGraph: {
+			title: ogTitle,
+			description: ogDescription,
+			url: canonical,
+			siteName: site.name ?? site.team?.name ?? site.slug,
+			locale,
+			type: "website",
+			images: metadata.openGraph?.images
+		},
+		robots: metadata.robots
+	};
+}
+//#endregion
+//#region src/seo/sitemap.ts
+function buildSiteSitemap(baseUrl, paths, options = {}) {
+	const base = baseUrl.replace(/\/$/, "");
+	const homePriority = options.homePriority ?? 1;
+	const defaultPriority = options.defaultPriority ?? .8;
+	return paths.map((path) => {
+		const normalized = !path || path === "/" ? "" : path.startsWith("/") ? path : `/${path}`;
+		const isHome = normalized === "";
+		return {
+			url: `${base}${normalized || "/"}`,
+			lastModified: options.lastModified,
+			changeFrequency: options.changeFrequency ?? (isHome ? "weekly" : "monthly"),
+			priority: isHome ? homePriority : defaultPriority
+		};
+	});
+}
+//#endregion
+//#region src/seo/robots.ts
+function buildSiteRobots(baseUrl, options = {}) {
+	const base = baseUrl.replace(/\/$/, "");
+	let host;
+	try {
+		host = new URL(base).host;
+	} catch {
+		host = void 0;
+	}
+	return {
+		rules: [{
+			userAgent: "*",
+			allow: options.allow ?? "/",
+			disallow: options.disallow ?? ["/admin-login", "/api/"]
+		}],
+		sitemap: `${base}/sitemap.xml`,
+		host
+	};
+}
+//#endregion
+//#region src/seo/json-ld.ts
+function buildLocalBusinessJsonLd(input) {
+	const jsonLd = {
+		"@context": "https://schema.org",
+		"@type": input.type ?? "LocalBusiness",
+		name: input.name,
+		url: input.url
+	};
+	if (input.description) jsonLd.description = input.description;
+	if (input.telephone) jsonLd.telephone = input.telephone;
+	if (input.email) jsonLd.email = input.email;
+	if (input.image) jsonLd.image = input.image;
+	if (input.openingHours?.length) jsonLd.openingHours = input.openingHours;
+	if (input.sameAs?.length) jsonLd.sameAs = input.sameAs;
+	if (input.priceRange) jsonLd.priceRange = input.priceRange;
+	if (input.geo) jsonLd.geo = {
+		"@type": "GeoCoordinates",
+		latitude: input.geo.latitude,
+		longitude: input.geo.longitude
+	};
+	if (input.address) jsonLd.address = {
+		"@type": "PostalAddress",
+		...input.address
+	};
+	return jsonLd;
+}
+function serializeJsonLd(data) {
+	return JSON.stringify(data);
+}
+//#endregion
+//#region src/seo/llms-txt.ts
+function buildLlmsTxt(input) {
+	const base = input.baseUrl.replace(/\/$/, "");
+	const lines = [`# ${input.name}`, ""];
+	if (input.description) lines.push(input.description, "");
+	lines.push("## Pages", "");
+	for (const page of input.pages) {
+		const url = `${base}${page.path === "/" ? "/" : page.path.startsWith("/") ? page.path : `/${page.path}`}`;
+		lines.push(`- [${page.title}](${url})${page.summary ? `: ${page.summary}` : ""}`);
+	}
+	if (input.contact) lines.push("", "## Contact", "", input.contact);
+	lines.push("");
+	return lines.join("\n");
+}
+//#endregion
+export { buildLlmsTxt, buildLocalBusinessJsonLd, buildSiteMetadata, buildSiteRobots, buildSiteSitemap, createRevalidateHandler, createSiteLoginUrl, createSiteSessionStore, createThemeRegistry, defineSiteTheme, exchangeSiteEditingSession, getSiteAdminLoginPath, getSiteContentSlug, getSiteThemeKey, getThemePage, listThemeSitemapPaths, loadSiteContent, normalizeSiteHost, normalizeThemePath, resolveSiteByHost, resolveSiteContext, serializeJsonLd };

package/dist/session.d.mts

@@ -0,0 +1,17 @@
+import { AppEnv } from "@joai/core";
+import * as _$_joai_react0 from "@joai/react";
+
+//#region src/session.d.ts
+type SiteEditingSessionConfig = {
+  env?: AppEnv;
+  team: string;
+  brand?: string;
+  sessionStorageKey: string; /** Path for the admin login route (default `/admin-login`). */
+  loginPath?: string;
+};
+declare function createSiteLoginUrl(config: SiteEditingSessionConfig, redirect: string): string;
+declare function createSiteSessionStore(config: SiteEditingSessionConfig): _$_joai_react0.SessionTokenStore;
+declare function exchangeSiteEditingSession(config: SiteEditingSessionConfig, handoffToken: string): Promise<string>;
+declare function getSiteAdminLoginPath(config: SiteEditingSessionConfig): string;
+//#endregion
+export { SiteEditingSessionConfig, createSiteLoginUrl, createSiteSessionStore, exchangeSiteEditingSession, getSiteAdminLoginPath };

package/dist/session.mjs

@@ -0,0 +1,30 @@
+import { getLoginUrl } from "@joai/core";
+import { createSessionTokenStore } from "@joai/react";
+//#region src/session.ts
+function createSiteLoginUrl(config, redirect) {
+	const returnUrl = new URL(redirect);
+	returnUrl.searchParams.set("platform", "app");
+	return getLoginUrl(config.env ?? "mainnet", returnUrl.toString(), {
+		team: config.team,
+		brand: config.brand
+	});
+}
+function createSiteSessionStore(config) {
+	return createSessionTokenStore(config.sessionStorageKey);
+}
+async function exchangeSiteEditingSession(config, handoffToken) {
+	const { createClient } = await import("@joai/sdk");
+	const response = await createClient({
+		env: config.env ?? "mainnet",
+		team: config.team,
+		cache: { enabled: false }
+	}).auth.exchangeNativeSession(handoffToken);
+	if (!response.ok || !response.data?.token) throw new Error("session_exchange_failed");
+	if (!createSiteSessionStore(config).set(response.data.token)) throw new Error("session_store_failed");
+	return response.data.token;
+}
+function getSiteAdminLoginPath(config) {
+	return config.loginPath ?? "/admin-login";
+}
+//#endregion
+export { createSiteLoginUrl, createSiteSessionStore, exchangeSiteEditingSession, getSiteAdminLoginPath };

package/locales/de.json

@@ -0,0 +1,6 @@
+{
+  "sites": {
+    "loginRedirecting": "Weiterleitung zur sicheren Anmeldung …",
+    "loginFailed": "Anmeldung fehlgeschlagen. Weiterleitung wird erneut gestartet …"
+  }
+}

package/locales/en.json

@@ -0,0 +1,6 @@
+{
+  "sites": {
+    "loginRedirecting": "Redirecting to secure sign-in…",
+    "loginFailed": "Sign-in failed. Trying again…"
+  }
+}

package/locales/es.json

@@ -0,0 +1,6 @@
+{
+  "sites": {
+    "loginRedirecting": "Redirigiendo al inicio de sesión seguro…",
+    "loginFailed": "Error al iniciar sesión. Reintentando…"
+  }
+}

package/locales/fr.json

@@ -0,0 +1,6 @@
+{
+  "sites": {
+    "loginRedirecting": "Redirection vers la connexion sécurisée…",
+    "loginFailed": "Échec de la connexion. Nouvel essai…"
+  }
+}

package/locales/it.json

@@ -0,0 +1,6 @@
+{
+  "sites": {
+    "loginRedirecting": "Reindirizzamento all’accesso sicuro…",
+    "loginFailed": "Accesso non riuscito. Nuovo tentativo…"
+  }
+}

package/locales/ro.json

@@ -0,0 +1,6 @@
+{
+  "sites": {
+    "loginRedirecting": "Redirecționare către autentificarea securizată…",
+    "loginFailed": "Autentificarea a eșuat. Se reîncearcă…"
+  }
+}

package/package.json

@@ -1,6 +1,60 @@
 {
   "name": "@joai/sites",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Shared helpers for JoAi-managed multi-tenant websites",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.mts"
+    },
+    "./admin": {
+      "import": "./dist/admin.mjs",
+      "types": "./dist/admin.d.mts"
+    },
+    "./locales/*": "./locales/*",
+    "./editable": {
+      "import": "./dist/editable.mjs",
+      "types": "./dist/editable.d.mts"
+    },
+    "./session": {
+      "import": "./dist/session.mjs",
+      "types": "./dist/session.d.mts"
+    }
+  },
+  "files": [
+    "dist",
+    "locales"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "jest --config jest.config.js"
+  },
+  "dependencies": {
+    "@joai/core": "^5.3.5",
+    "@joai/react": "^1.0.4",
+    "@joai/sdk": "^12.1.0"
+  },
+  "peerDependencies": {
+    "next": ">=15.0.0",
+    "next-intl": ">=3.0.0",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/react": "^19.2.14",
+    "jest": "^30.3.0",
+    "next": "^16.2.0",
+    "next-intl": "^4.8.3",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "ts-jest": "^29.4.6",
+    "tsdown": "^0.21.0",
+    "typescript": "^5.9.3"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.