@vigilkids/cms-nuxt 0.3.0 → 0.5.0

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
+    }))
+  };
+}

package/dist/types.d.ts

@@ -1,7 +1,76 @@
-import type { NuxtModule } from '@nuxt/schema'
-
-import type { default as Module } from './module'
-
-export type ModuleOptions = typeof Module extends NuxtModule<infer O> ? Partial<O> : Record<string, any>
-
-export { default } from './module'
+/** CMS 资源路由参数 */
+export type CmsRouteParams = Record<string, string | number | boolean | null | undefined>;
+/** CMS 资源路由模式 */
+export interface CmsRouteResources {
+    index?: string;
+    category?: string;
+    article?: string;
+    author?: string;
+    [resource: string]: string | undefined;
+}
+/** CMS 语言路径策略 */
+export interface CmsRouteLocalePolicy {
+    defaultLocale?: string;
+    prefixes?: Record<string, string>;
+    includeDefaultLocale?: boolean;
+}
+/** CMS 资源路由策略 */
+export interface CmsRoutePolicy {
+    /** 站点公开 URL 模式 */
+    resources?: CmsRouteResources;
+    /** CMS API 返回的资源 URL 模式，用于 preview/sitemap 输入解析 */
+    sourceResources?: CmsRouteResources;
+    /** 语言路径策略 */
+    locale?: CmsRouteLocalePolicy;
+}
+/** CMS Nuxt Module 配置 */
+export interface CmsNuxtModuleOptions {
+    /** CMS API 基础 URL */
+    apiUrl: string;
+    /** 产品编码 */
+    productCode: string;
+    /** 默认语言 */
+    defaultLocale?: string;
+    /** Webhook HMAC-SHA256 密钥（服务端专用） */
+    webhookSecret: string;
+    /** 预览模式配置 */
+    preview?: {
+        enabled?: boolean;
+        path?: string;
+        cookieName?: string;
+        cookieMaxAge?: number;
+    };
+    /** CMS 资源路由策略 */
+    routes?: CmsRoutePolicy;
+    /** 内容 API 集成 */
+    content?: {
+        articleCollectionPath?: string;
+        cmsProxyPath?: string;
+    };
+    /** 分类预加载配置 */
+    categories?: {
+        preload?: boolean;
+        locales?: string[];
+    };
+    /** ISR 重验证配置 */
+    revalidate?: {
+        enabled?: boolean;
+        path?: string;
+    };
+    /** 重定向中间件配置 */
+    redirects?: {
+        enabled?: boolean;
+        cacheTtl?: number;
+    };
+    /** Sitemap 集成 */
+    sitemap?: {
+        enabled?: boolean;
+        locales?: string[];
+        sourcePath?: string;
+    };
+    /** 语言代码映射 (前端 locale → CMS API locale) */
+    localeMap?: Record<string, string>;
+    /** URL 路径前缀映射 (CMS locale → URL prefix)，默认语言无需配置 */
+    localePrefixes?: Record<string, string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;AAEzF,iBAAiB;AACjB,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CACvC;AAED,iBAAiB;AACjB,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B;AAED,iBAAiB;AACjB,MAAM,WAAW,cAAc;IAC7B,kBAAkB;IAClB,SAAS,CAAC,EAAE,iBAAiB,CAAA;IAC7B,mDAAmD;IACnD,eAAe,CAAC,EAAE,iBAAiB,CAAA;IACnC,aAAa;IACb,MAAM,CAAC,EAAE,oBAAoB,CAAA;CAC9B;AAED,yBAAyB;AACzB,MAAM,WAAW,oBAAoB;IACnC,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,WAAW;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW;IACX,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa;IACb,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,YAAY,CAAC,EAAE,MAAM,CAAA;KACtB,CAAA;IACD,iBAAiB;IACjB,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,gBAAgB;IAChB,OAAO,CAAC,EAAE;QACR,qBAAqB,CAAC,EAAE,MAAM,CAAA;QAC9B,YAAY,CAAC,EAAE,MAAM,CAAA;KACtB,CAAA;IACD,cAAc;IACd,UAAU,CAAC,EAAE;QACX,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KACnB,CAAA;IACD,gBAAgB;IAChB,UAAU,CAAC,EAAE;QACX,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;IACD,eAAe;IACf,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAA;IACD,iBAAiB;IACjB,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;QAClB,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB,CAAA;IACD,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACxC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vigilkids/cms-nuxt",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Nuxt 3 module for OnEx CMS — composables, server routes, middleware, sitemap",
   "type": "module",
   "main": "./dist/module.mjs",
@@ -12,12 +12,13 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "CHANGELOG.md"
   ],
   "sideEffects": false,
   "scripts": {
-    "build": "nuxt-module-build build",
-    "prepack": "nuxt-module-build build",
+    "build": "nuxt-module-build build && tsc --emitDeclarationOnly --declaration --outDir dist",
+    "prepack": "pnpm build",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "format": "prettier --write src/"
@@ -27,7 +28,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/1yhy/onex.git",
+    "url": "git+https://github.com/vigikids/onex.git",
     "directory": "packages/cms-nuxt"
   },
   "devDependencies": {
@@ -43,7 +44,7 @@
     "vue": "^3.4.0"
   },
   "peerDependencies": {
-    "@vigilkids/cms-client": "^0.1.4",
+    "@vigilkids/cms-client": "^0.3.0",
     "nuxt": ">=3.15.0"
   },
   "peerDependenciesMeta": {