@vigilkids/cms-nuxt 0.3.0 → 0.4.0

package/dist/runtime/server/api/preview.get.js

@@ -1,16 +1,33 @@
 import { env } from "node:process";
 import { useRuntimeConfig } from "#imports";
 import { createError, defineEventHandler, getQuery, sendRedirect, setCookie } from "h3";
+import { buildCmsPath, extractCmsSourceRouteParams, mergeCmsRouteParams, resolveCmsRoutePolicy } from "../../utils/routes.js";
+import { createServerCmsClient } from "../utils/cms-client.js";
+function stringValue(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+function queryRouteParams(query) {
+  const params = {};
+  for (const [key, value] of Object.entries(query)) {
+    if (typeof value === "string" && value.trim()) {
+      params[key] = value.trim();
+    }
+  }
+  return params;
+}
 export default defineEventHandler(async (event) => {
   const query = getQuery(event);
-  const token = query.token;
-  const slug = query.slug;
-  const locale = query.locale;
-  if (!token || !slug) {
+  const token = stringValue(query.token);
+  const rawSlug = stringValue(query.slug);
+  const resource = stringValue(query.resource_type) || stringValue(query.resource) || "article";
+  if (!token || resource === "article" && !rawSlug) {
     throw createError({ statusCode: 400, message: "Missing token or slug parameter" });
   }
   const config = useRuntimeConfig();
   const cmsConfig = config.public.cms;
+  const routePolicy = resolveCmsRoutePolicy(cmsConfig);
+  const publicLocale = stringValue(query.locale) || routePolicy.locale.defaultLocale || "en";
+  const apiLocale = cmsConfig.localeMap?.[publicLocale] ?? publicLocale;
   const cookieName = cmsConfig.preview?.cookieName ?? "__preview_token";
   const cookieMaxAge = cmsConfig.preview?.cookieMaxAge ?? 1800;
   setCookie(event, cookieName, token, {
@@ -20,13 +37,31 @@ export default defineEventHandler(async (event) => {
     path: "/",
     maxAge: cookieMaxAge
   });
-  const defaultLocale = cmsConfig.defaultLocale ?? "en";
-  let prefix = "";
-  if (locale && locale !== defaultLocale) {
-    const prefixes = cmsConfig.localePrefixes ?? {};
-    prefix = `/${prefixes[locale] ?? locale.toLowerCase()}`;
+  const sourceParams = rawSlug ? extractCmsSourceRouteParams(routePolicy, resource, rawSlug) : null;
+  let routeParams = mergeCmsRouteParams(sourceParams, queryRouteParams(query));
+  routeParams.locale = publicLocale;
+  if (rawSlug && !routeParams.slug) {
+    routeParams.slug = rawSlug;
+  }
+  if (resource === "article" && !routeParams.category_slug && routePolicy.resources.article?.includes("{category_slug}")) {
+    const client = createServerCmsClient(token);
+    try {
+      const article = await client.getArticle(String(routeParams.slug), apiLocale);
+      if (article.category) {
+        routeParams = { ...routeParams, category_slug: article.category };
+      }
+    } catch {
+      throw createError({ statusCode: 404, message: "Preview article not found" });
+    }
+  }
+  let path;
+  try {
+    path = buildCmsPath(routePolicy, resource, routeParams, { includeLocale: true });
+  } catch (error) {
+    throw createError({
+      statusCode: 400,
+      message: error instanceof Error ? error.message : "Invalid preview route parameters"
+    });
   }
-  const articlePath = cmsConfig.preview?.articlePath ?? "/blog/{slug}";
-  const path = articlePath.replace("{slug}", slug);
-  return sendRedirect(event, `${prefix}${path}?_preview=1`, 302);
+  return sendRedirect(event, `${path}?_preview=1`, 302);
 });

package/dist/runtime/server/api/sitemap-urls.get.d.ts

@@ -0,0 +1,16 @@
+declare const _default: import("h3").EventHandler<import("h3").EventHandlerRequest, Promise<{
+    loc: string;
+    lastmod: string;
+    changefreq: string;
+    priority: number;
+    alternatives: {
+        hreflang: string;
+        href: string;
+    }[] | undefined;
+    images: {
+        loc: string;
+        title: string | undefined;
+    }[] | undefined;
+}[]>>;
+export default _default;
+//# sourceMappingURL=sitemap-urls.get.d.ts.map

package/dist/runtime/server/api/sitemap-urls.get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap-urls.get.d.ts","sourceRoot":"","sources":["../../../../src/runtime/server/api/sitemap-urls.get.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AASA,wBAqBE"}

package/dist/runtime/server/api/sitemap-urls.get.js

@@ -0,0 +1,20 @@
+import { useRuntimeConfig } from "#imports";
+import { defineEventHandler, getQuery, setResponseHeader } from "h3";
+import { toArray } from "../../utils/list.js";
+import { resolveCmsRoutePolicy } from "../../utils/routes.js";
+import { cmsLocale, toNuxtSitemapEntry } from "../../utils/sitemap.js";
+import { useServerCmsClient } from "../utils/cms-client.js";
+export default defineEventHandler(async (event) => {
+  setResponseHeader(event, "Cache-Control", "private, no-cache, no-store");
+  const { locale } = getQuery(event);
+  if (!locale || typeof locale !== "string")
+    return [];
+  const config = useRuntimeConfig();
+  const cmsConfig = config.public.cms;
+  const routePolicy = resolveCmsRoutePolicy(cmsConfig);
+  const client = useServerCmsClient();
+  const entries = await client.getSitemap(cmsLocale(cmsConfig.localeMap, locale));
+  return toArray(entries).map(
+    (entry) => toNuxtSitemapEntry(entry, locale, routePolicy, cmsConfig.localeMap)
+  );
+});

package/dist/runtime/server/middleware/preview-context.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 预览模式中间件：token 穿透 + SWR 缓存绕过。
+ *
+ * 1. Token 穿透：将预览 cookie 存入 event.context，穿越 SWR 合成事件边界。
+ *    SWR cachedEventHandler 的合成事件会剥离 cookie，但 event.context
+ *    通过引用共享（synthetic.context = original.context）可以穿越。
+ *
+ * 2. 缓存绕过：Nitro SWR cache key 基于 hash(event.node.req.url)（含 query）。
+ *    对页面路由追加唯一时间戳参数，使每次预览请求产生不同 cache key，
+ *    确保编辑后刷新总是获取最新草稿内容。
+ */
+declare const _default: import("h3").EventHandler<import("h3").EventHandlerRequest, void>;
+export default _default;
+//# sourceMappingURL=preview-context.d.ts.map

package/dist/runtime/server/middleware/preview-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-context.d.ts","sourceRoot":"","sources":["../../../../src/runtime/server/middleware/preview-context.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;;AACH,wBAsBE"}

package/dist/runtime/server/middleware/redirects.d.ts

@@ -0,0 +1,4 @@
+/** CMS 重定向中间件 */
+declare const _default: import("h3").EventHandler<import("h3").EventHandlerRequest, Promise<void>>;
+export default _default;
+//# sourceMappingURL=redirects.d.ts.map

package/dist/runtime/server/middleware/redirects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirects.d.ts","sourceRoot":"","sources":["../../../../src/runtime/server/middleware/redirects.ts"],"names":[],"mappings":"AAsDA,iBAAiB;;AACjB,wBAiBE"}

package/dist/runtime/server/middleware/redirects.js

@@ -3,6 +3,8 @@ import { defineEventHandler, getRequestURL, sendRedirect } from "h3";
 import { toArray } from "../../utils/list.js";
 let cachedRules = null;
 let cacheExpiry = 0;
+const regexCache = /* @__PURE__ */ new Map();
+const skippedPrefixes = ["/_", "/__", "/_nuxt", "/_ipx", "/.well-known", "/api"];
 async function loadRules() {
   const now = Date.now();
   if (cachedRules && now < cacheExpiry)
@@ -13,27 +15,42 @@ async function loadRules() {
     const { useServerCmsClient } = await import("../utils/cms-client.js");
     const client = useServerCmsClient();
     cachedRules = toArray(await client.getRedirects());
+    regexCache.clear();
     cacheExpiry = now + cacheTtl;
     return cachedRules;
-  } catch (error) {
-    console.error("[cms-nuxt] \u52A0\u8F7D\u91CD\u5B9A\u5411\u89C4\u5219\u5931\u8D25", error);
+  } catch {
     return cachedRules ?? [];
   }
 }
+function matchesRule(rule, path) {
+  if (rule.match_type === "prefix")
+    return path.startsWith(rule.source_path);
+  if (rule.match_type === "regex") {
+    if (path.length > 2048)
+      return false;
+    let expression = regexCache.get(rule.source_path);
+    if (!expression) {
+      try {
+        expression = new RegExp(rule.source_path);
+      } catch {
+        return false;
+      }
+      regexCache.set(rule.source_path, expression);
+    }
+    return expression.test(path);
+  }
+  return path === rule.source_path;
+}
 export default defineEventHandler(async (event) => {
   const path = getRequestURL(event).pathname;
-  if (path.startsWith("/api/") || path.startsWith("/_nuxt/") || path.startsWith("/__nuxt")) {
+  const config = useRuntimeConfig();
+  const proxyPath = config.public.cms.content?.cmsProxyPath ?? "/cms-proxy";
+  if (path.includes(".") || [...skippedPrefixes, proxyPath].some((prefix) => path.startsWith(prefix))) {
     return;
   }
   const rules = await loadRules();
   for (const rule of rules) {
-    let matched = false;
-    if (rule.match_type === "exact" && path === rule.source_path) {
-      matched = true;
-    } else if (rule.match_type === "prefix" && path.startsWith(rule.source_path)) {
-      matched = true;
-    }
-    if (matched) {
+    if (matchesRule(rule, path)) {
       return sendRedirect(event, rule.destination_path, rule.status_code);
     }
   }

package/dist/runtime/server/routes/cms-proxy.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("h3").EventHandler<import("h3").EventHandlerRequest, Promise<unknown>>;
+export default _default;
+//# sourceMappingURL=cms-proxy.d.ts.map

package/dist/runtime/server/routes/cms-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cms-proxy.d.ts","sourceRoot":"","sources":["../../../../src/runtime/server/routes/cms-proxy.ts"],"names":[],"mappings":";AA0BA,wBA0CE"}

package/dist/runtime/server/routes/cms-proxy.js

@@ -0,0 +1,55 @@
+import { useRuntimeConfig } from "#imports";
+import {
+  createError,
+  defineEventHandler,
+  getCookie,
+  getQuery,
+  getRequestHeader,
+  getRequestURL,
+  setResponseHeader
+} from "h3";
+function queryString(query) {
+  const params = new URLSearchParams();
+  for (const [key, value] of Object.entries(query)) {
+    if (value !== void 0 && value !== null) {
+      params.set(key, String(value));
+    }
+  }
+  return params.toString();
+}
+function proxyPathname(pathname, proxyPath) {
+  const prefix = proxyPath.replace(/\/+$/g, "");
+  return decodeURIComponent(pathname.slice(prefix.length).replace(/^\/+/g, ""));
+}
+export default defineEventHandler(async (event) => {
+  setResponseHeader(event, "Cache-Control", "private, no-cache, no-store");
+  const config = useRuntimeConfig();
+  const cmsConfig = config.public.cms;
+  if (!cmsConfig.apiUrl) {
+    throw createError({ statusCode: 500, message: "CMS API URL not configured" });
+  }
+  const url = getRequestURL(event);
+  const proxyPath = cmsConfig.content?.cmsProxyPath ?? "/cms-proxy";
+  const path = proxyPathname(url.pathname, proxyPath);
+  const search = queryString(getQuery(event));
+  const targetUrl = `${cmsConfig.apiUrl.replace(/\/+$/g, "")}/${path}${search ? `?${search}` : ""}`;
+  const previewCookieName = cmsConfig.preview?.cookieName ?? "__preview_token";
+  const previewToken = getRequestHeader(event, "x-preview-token") || getCookie(event, previewCookieName);
+  const headers = { Accept: "application/json" };
+  if (cmsConfig.productCode)
+    headers["X-Product-Code"] = cmsConfig.productCode;
+  if (previewToken)
+    headers["X-Preview-Token"] = decodeURIComponent(previewToken);
+  const upstreamResponse = await $fetch.raw(targetUrl, {
+    headers,
+    ignoreResponseError: true
+  });
+  if (!upstreamResponse.ok) {
+    throw createError({
+      statusCode: upstreamResponse.status,
+      statusMessage: upstreamResponse.statusText,
+      data: upstreamResponse._data
+    });
+  }
+  return upstreamResponse._data;
+});

package/dist/runtime/server/utils/cms-client.d.ts

@@ -0,0 +1,4 @@
+import { CmsClient } from '@vigilkids/cms-client';
+export declare function createServerCmsClient(previewToken?: string): CmsClient;
+export declare function useServerCmsClient(): CmsClient;
+//# sourceMappingURL=cms-client.d.ts.map

package/dist/runtime/server/utils/cms-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cms-client.d.ts","sourceRoot":"","sources":["../../../../src/runtime/server/utils/cms-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAgBjD,wBAAgB,qBAAqB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAQtE;AAED,wBAAgB,kBAAkB,IAAI,SAAS,CAK9C"}

package/dist/runtime/server/utils/cms-client.js

@@ -1,15 +1,22 @@
 import { useRuntimeConfig } from "#imports";
 import { CmsClient } from "@vigilkids/cms-client";
 let _client = null;
+function publicCmsConfig() {
+  const config = useRuntimeConfig();
+  return config.public.cms;
+}
+export function createServerCmsClient(previewToken) {
+  const publicCms = publicCmsConfig();
+  return new CmsClient({
+    baseUrl: publicCms.apiUrl,
+    productCode: publicCms.productCode,
+    defaultLocale: publicCms.defaultLocale,
+    previewToken
+  });
+}
 export function useServerCmsClient() {
   if (!_client) {
-    const config = useRuntimeConfig();
-    const publicCms = config.public.cms;
-    _client = new CmsClient({
-      baseUrl: publicCms.apiUrl,
-      productCode: publicCms.productCode,
-      defaultLocale: publicCms.defaultLocale
-    });
+    _client = createServerCmsClient();
   }
   return _client;
 }

package/dist/runtime/sitemap/provider.d.ts

@@ -0,0 +1,17 @@
+import type { CmsNuxtModuleOptions } from '../../types';
+/** 为 @nuxtjs/sitemap 提供 CMS 内容 URL */
+export declare function sitemapProvider(options: CmsNuxtModuleOptions): Promise<{
+    loc: string;
+    lastmod?: string;
+    changefreq?: string;
+    priority?: number;
+    alternatives?: Array<{
+        hreflang: string;
+        href: string;
+    }>;
+    images?: Array<{
+        loc: string;
+        title?: string;
+    }>;
+}[]>;
+//# sourceMappingURL=provider.d.ts.map

package/dist/runtime/sitemap/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/runtime/sitemap/provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAMvD,sCAAsC;AACtC,wBAAsB,eAAe,CAAC,OAAO,EAAE,oBAAoB;SAc1D,MAAM;cACD,MAAM;iBACH,MAAM;eACR,MAAM;mBACF,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;aAC/C,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;KAWlD"}

package/dist/runtime/sitemap/provider.js

@@ -1,5 +1,7 @@
 import { CmsClient } from "@vigilkids/cms-client";
 import { toArray } from "../utils/list.js";
+import { resolveCmsRoutePolicy } from "../utils/routes.js";
+import { cmsLocale, toNuxtSitemapEntry } from "../utils/sitemap.js";
 export async function sitemapProvider(options) {
   const client = new CmsClient({
     baseUrl: options.apiUrl,
@@ -7,20 +9,16 @@ export async function sitemapProvider(options) {
     defaultLocale: options.defaultLocale
   });
   const locales = options.sitemap?.locales ?? [options.defaultLocale ?? "en"];
+  const routePolicy = resolveCmsRoutePolicy({
+    defaultLocale: options.defaultLocale,
+    localePrefixes: options.localePrefixes,
+    routes: options.routes
+  });
   const entries = [];
   for (const locale of locales) {
-    const sitemapEntries = await client.getSitemap(locale);
+    const sitemapEntries = await client.getSitemap(cmsLocale(options.localeMap, locale));
     for (const entry of toArray(sitemapEntries)) {
-      entries.push({
-        loc: entry.loc,
-        lastmod: entry.last_mod,
-        changefreq: entry.change_freq,
-        priority: entry.priority,
-        alternatives: entry.hreflang?.map((h) => ({
-          hreflang: h.lang,
-          href: h.href
-        }))
-      });
+      entries.push(toNuxtSitemapEntry(entry, locale, routePolicy, options.localeMap));
     }
   }
   return entries;

package/dist/runtime/utils/list.d.ts

@@ -0,0 +1,2 @@
+export declare function toArray<T>(value: unknown): T[];
+//# sourceMappingURL=list.d.ts.map

package/dist/runtime/utils/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/runtime/utils/list.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,EAAE,CAE9C"}

package/dist/runtime/utils/routes.d.ts

@@ -0,0 +1,19 @@
+import type { CmsRouteParams, CmsRoutePolicy, CmsRouteResources } from '../../types';
+export declare const DEFAULT_CMS_ROUTE_RESOURCES: CmsRouteResources & Required<Pick<CmsRouteResources, 'article' | 'author' | 'category' | 'index'>>;
+interface CmsRouteRuntimeConfig {
+    defaultLocale?: string;
+    localePrefixes?: Record<string, string>;
+    routes?: CmsRoutePolicy;
+}
+interface BuildCmsPathOptions {
+    includeLocale?: boolean;
+}
+export declare function resolveCmsRoutePolicy(config?: CmsRouteRuntimeConfig): Required<CmsRoutePolicy>;
+export declare function buildCmsPath(policy: CmsRoutePolicy, resource: string, params?: CmsRouteParams, options?: BuildCmsPathOptions): string;
+export declare function extractCmsRouteParams(pattern: string, path: string): CmsRouteParams | null;
+export declare function extractCmsSourceRouteParams(policy: CmsRoutePolicy, resource: string, path: string): CmsRouteParams | null;
+export declare function mergeCmsRouteParams(left: CmsRouteParams | null | undefined, right: CmsRouteParams | null | undefined): {
+    [x: string]: string | number | boolean | null | undefined;
+};
+export {};
+//# sourceMappingURL=routes.d.ts.map

package/dist/runtime/utils/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/runtime/utils/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEpF,eAAO,MAAM,2BAA2B,EAAE,iBAAiB,GAAG,QAAQ,CAAC,IAAI,CACzE,iBAAiB,EACjB,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAC5C,CAKA,CAAA;AAED,UAAU,qBAAqB;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,MAAM,CAAC,EAAE,cAAc,CAAA;CACxB;AAED,UAAU,mBAAmB;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAuCD,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,QAAQ,CAAC,cAAc,CAAC,CAiB9F;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,cAAmB,EAC3B,OAAO,GAAE,mBAAwB,UAmBlC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAgC1F;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,yBAeb;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,EACvC,KAAK,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS;;EAMzC"}

package/dist/runtime/utils/routes.js

@@ -0,0 +1,119 @@
+export const DEFAULT_CMS_ROUTE_RESOURCES = {
+  index: "/",
+  category: "/{category_slug}",
+  article: "/{category_slug}/{slug}",
+  author: "/authors/{slug}"
+};
+function trimSlashes(value) {
+  return value.replace(/^\/+|\/+$/g, "");
+}
+function normalizePath(path) {
+  const clean = path.split("?")[0]?.split("#")[0] ?? "";
+  const withSlash = clean.startsWith("/") ? clean : `/${clean}`;
+  const collapsed = withSlash.replace(/\/{2,}/g, "/");
+  if (collapsed.length > 1)
+    return collapsed.replace(/\/+$/g, "");
+  return collapsed;
+}
+function encodePathValue(value) {
+  return encodeURIComponent(String(value));
+}
+function localePrefix(locale, policy) {
+  if (!locale)
+    return "";
+  const defaultLocale = policy.defaultLocale ?? "en";
+  if (locale === defaultLocale && !policy.includeDefaultLocale)
+    return "";
+  const prefix = policy.prefixes?.[locale] ?? locale.toLowerCase();
+  return `/${trimSlashes(prefix)}`;
+}
+function mergeResources(resources) {
+  return {
+    ...DEFAULT_CMS_ROUTE_RESOURCES,
+    ...resources ?? {}
+  };
+}
+export function resolveCmsRoutePolicy(config) {
+  const routes = config?.routes ?? {};
+  const defaultLocale = routes.locale?.defaultLocale ?? config?.defaultLocale ?? "en";
+  const prefixes = {
+    ...config?.localePrefixes ?? {},
+    ...routes.locale?.prefixes ?? {}
+  };
+  return {
+    resources: mergeResources(routes.resources),
+    sourceResources: mergeResources(routes.sourceResources),
+    locale: {
+      defaultLocale,
+      prefixes,
+      includeDefaultLocale: routes.locale?.includeDefaultLocale ?? false
+    }
+  };
+}
+export function buildCmsPath(policy, resource, params = {}, options = {}) {
+  const resolvedPolicy = resolveCmsRoutePolicy({ routes: policy });
+  const pattern = resolvedPolicy.resources[resource];
+  if (!pattern) {
+    throw new Error(`CMS route pattern is not configured for resource '${resource}'`);
+  }
+  const path = normalizePath(pattern.replace(/\{(\w+)\}/g, (_, key) => {
+    const value = params[key];
+    if (value === void 0 || value === null || value === "") {
+      throw new Error(`CMS route parameter '${key}' is required for resource '${resource}'`);
+    }
+    return encodePathValue(value);
+  }));
+  if (!options.includeLocale)
+    return path;
+  return normalizePath(`${localePrefix(String(params.locale ?? ""), resolvedPolicy.locale)}${path}`);
+}
+export function extractCmsRouteParams(pattern, path) {
+  const keys = [];
+  const source = normalizePath(pattern);
+  let expression = "^";
+  for (let index = 0; index < source.length; index++) {
+    const char = source[index];
+    if (char === "{") {
+      const closeIndex = source.indexOf("}", index);
+      if (closeIndex > index) {
+        const key = source.slice(index + 1, closeIndex);
+        keys.push(key);
+        expression += "([^/]+)";
+        index = closeIndex;
+        continue;
+      }
+    }
+    expression += char.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  }
+  expression += "$";
+  const match = normalizePath(path).match(new RegExp(expression));
+  if (!match)
+    return null;
+  const params = {};
+  for (let index = 0; index < keys.length; index++) {
+    const raw = match[index + 1];
+    if (raw)
+      params[keys[index]] = decodeURIComponent(raw);
+  }
+  return params;
+}
+export function extractCmsSourceRouteParams(policy, resource, path) {
+  const resolvedPolicy = resolveCmsRoutePolicy({ routes: policy });
+  const candidates = [
+    resolvedPolicy.sourceResources[resource],
+    resolvedPolicy.resources[resource],
+    DEFAULT_CMS_ROUTE_RESOURCES[resource]
+  ].filter((pattern) => Boolean(pattern));
+  for (const pattern of candidates) {
+    const params = extractCmsRouteParams(pattern, path);
+    if (params)
+      return params;
+  }
+  return null;
+}
+export function mergeCmsRouteParams(left, right) {
+  return {
+    ...left ?? {},
+    ...right ?? {}
+  };
+}

package/dist/runtime/utils/sitemap.d.ts

@@ -0,0 +1,20 @@
+import type { SitemapEntry } from '@vigilkids/cms-client/types';
+import type { CmsRoutePolicy } from '../../types';
+export declare function cmsLocale(localeMap: Record<string, string> | undefined, locale: string): string;
+export declare function publicLocale(localeMap: Record<string, string> | undefined, locale: string): string;
+export declare function sitemapPath(entry: SitemapEntry, locale: string, routePolicy: CmsRoutePolicy): string;
+export declare function toNuxtSitemapEntry(entry: SitemapEntry, locale: string, routePolicy: CmsRoutePolicy, localeMap?: Record<string, string>): {
+    loc: string;
+    lastmod: string;
+    changefreq: string;
+    priority: number;
+    alternatives: {
+        hreflang: string;
+        href: string;
+    }[] | undefined;
+    images: {
+        loc: string;
+        title: string | undefined;
+    }[] | undefined;
+};
+//# sourceMappingURL=sitemap.d.ts.map

package/dist/runtime/utils/sitemap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.d.ts","sourceRoot":"","sources":["../../../src/runtime/utils/sitemap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAGjD,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,UAEtF;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,UAGzF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,UAY3F;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,cAAc,EAC3B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;;;;;;;;;EAwBnC"}

package/dist/runtime/utils/sitemap.js

@@ -0,0 +1,44 @@
+import { buildCmsPath, extractCmsSourceRouteParams, mergeCmsRouteParams, resolveCmsRoutePolicy } from "./routes.js";
+export function cmsLocale(localeMap, locale) {
+  return localeMap?.[locale] ?? locale;
+}
+export function publicLocale(localeMap, locale) {
+  const match = Object.entries(localeMap ?? {}).find(([, value]) => value === locale);
+  return match?.[0] ?? locale;
+}
+export function sitemapPath(entry, locale, routePolicy) {
+  const resource = entry.resource_type || "article";
+  const sourceParams = entry.route_params ?? extractCmsSourceRouteParams(routePolicy, resource, entry.loc);
+  if (!sourceParams)
+    return entry.loc;
+  return buildCmsPath(
+    resolveCmsRoutePolicy({ routes: routePolicy }),
+    resource,
+    mergeCmsRouteParams(sourceParams, { locale }),
+    { includeLocale: true }
+  );
+}
+export function toNuxtSitemapEntry(entry, locale, routePolicy, localeMap) {
+  return {
+    loc: sitemapPath(entry, locale, routePolicy),
+    lastmod: entry.last_mod,
+    changefreq: entry.change_freq,
+    priority: entry.priority,
+    alternatives: entry.hreflang?.map((h) => ({
+      hreflang: h.lang,
+      href: sitemapPath(
+        {
+          ...entry,
+          loc: h.href,
+          route_params: h.route_params
+        },
+        publicLocale(localeMap, h.lang),
+        routePolicy
+      )
+    })),
+    images: entry.images?.map((image) => ({
+      loc: image.loc,
+      title: image.title
+    }))
+  };
+}