@vigilkids/cms-client 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-present VigilKids
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,44 @@
+# @vigilkids/cms-client
+
+TypeScript HTTP client for the OneX CMS delivery API. Framework-agnostic — works with any HTTP client (fetch, axios, etc.).
+
+## Install
+
+```bash
+pnpm add @vigilkids/cms-client
+```
+
+## Usage
+
+```typescript
+import { createCmsClient } from '@vigilkids/cms-client'
+
+const cms = createCmsClient({
+  baseUrl: 'https://api.example.com',
+  productCode: 'visiva',
+})
+
+// Fetch article by slug
+const article = await cms.getArticleBySlug('my-article', { locale: 'en' })
+
+// List articles
+const { data, pagination } = await cms.listArticles({ page: 1, pageSize: 20 })
+```
+
+## Exports
+
+| Entry Point | Import | Content |
+|-------------|--------|---------|
+| Main | `@vigilkids/cms-client` | Client factory and API methods |
+| Types | `@vigilkids/cms-client/types` | Request/response type definitions |
+| Webhook | `@vigilkids/cms-client/webhook` | Webhook payload types and validation |
+
+## Compatibility
+
+- Node.js ≥ 18
+- ESM only
+- TypeScript ≥ 5.0
+
+## License
+
+[MIT](./LICENSE)

package/dist/index.d.mts

@@ -0,0 +1,78 @@
+import { ArticleListParams, Paginated, ArticleListItem, ArticleDetail, Author, CategoryNode, Comment, CreateCommentPayload, SitemapEntry, RedirectRule, Series } from './types.mjs';
+export { HreflangEntry, LocalizedString, OgMeta, PaginationMeta, RevalidatePayload, SeoMeta, TwitterMeta, WebhookEventType } from './types.mjs';
+
+/** CMS 客户端配置 */
+interface CmsClientConfig {
+    /** CMS API 基础 URL */
+    baseUrl: string;
+    /** 产品编码，注入 X-Product-Code header */
+    productCode?: string;
+    /** 默认语言 */
+    defaultLocale?: string;
+    /** 预览令牌 */
+    previewToken?: string;
+    /** 自定义 fetch 实现 */
+    fetch?: typeof globalThis.fetch;
+    /** 请求超时（毫秒），默认 10000 */
+    timeout?: number;
+    /** 自定义请求头 */
+    headers?: Record<string, string>;
+}
+
+/** CMS Public API 客户端 */
+declare class CmsClient {
+    private readonly config;
+    private readonly fetchFn;
+    constructor(config: CmsClientConfig);
+    /** 获取文章分页列表 */
+    getArticles(params?: ArticleListParams): Promise<Paginated<ArticleListItem>>;
+    /** 获取文章详情 */
+    getArticle(slug: string, locale?: string): Promise<ArticleDetail>;
+    /** 获取相关文章 */
+    getRelatedArticles(slug: string, options?: {
+        limit?: number;
+        locale?: string;
+    }): Promise<ArticleListItem[]>;
+    /** 获取所有作者 */
+    getAuthors(): Promise<Author[]>;
+    /** 获取作者详情 */
+    getAuthor(slug: string): Promise<Author>;
+    /** 获取作者的文章列表 */
+    getAuthorArticles(slug: string, options?: {
+        page?: number;
+        page_size?: number;
+        locale?: string;
+    }): Promise<ArticleListItem[]>;
+    /** 获取分类树 */
+    getCategories(): Promise<CategoryNode[]>;
+    /** 获取文章评论树 */
+    getComments(articleSlug: string): Promise<Comment[]>;
+    /** 发表评论 */
+    createComment(articleSlug: string, payload: CreateCommentPayload): Promise<void>;
+    /** 获取 Sitemap 条目 */
+    getSitemap(locale?: string): Promise<SitemapEntry[]>;
+    /** 获取重定向规则 */
+    getRedirects(): Promise<RedirectRule[]>;
+    /** 获取文章系列 */
+    getSeries(slug: string, locale?: string): Promise<Series>;
+    private request;
+    /** 构建完整 URL，过滤 undefined 参数 */
+    private buildUrl;
+    /** 构建请求头 */
+    private buildHeaders;
+}
+/** 创建 CMS 客户端实例 */
+declare function createCmsClient(config: CmsClientConfig): CmsClient;
+
+/** CMS API 错误 */
+declare class CmsApiError extends Error {
+    readonly statusCode: number;
+    readonly errorCode: string;
+    readonly body: unknown;
+    constructor(statusCode: number, errorCode: string, message: string, body?: unknown);
+    get isNotFound(): boolean;
+    get isUnauthorized(): boolean;
+}
+
+export { ArticleDetail, ArticleListItem, ArticleListParams, Author, CategoryNode, CmsApiError, CmsClient, Comment, CreateCommentPayload, Paginated, RedirectRule, Series, SitemapEntry, createCmsClient };
+export type { CmsClientConfig };

package/dist/index.d.ts

@@ -0,0 +1,78 @@
+import { ArticleListParams, Paginated, ArticleListItem, ArticleDetail, Author, CategoryNode, Comment, CreateCommentPayload, SitemapEntry, RedirectRule, Series } from './types.js';
+export { HreflangEntry, LocalizedString, OgMeta, PaginationMeta, RevalidatePayload, SeoMeta, TwitterMeta, WebhookEventType } from './types.js';
+
+/** CMS 客户端配置 */
+interface CmsClientConfig {
+    /** CMS API 基础 URL */
+    baseUrl: string;
+    /** 产品编码，注入 X-Product-Code header */
+    productCode?: string;
+    /** 默认语言 */
+    defaultLocale?: string;
+    /** 预览令牌 */
+    previewToken?: string;
+    /** 自定义 fetch 实现 */
+    fetch?: typeof globalThis.fetch;
+    /** 请求超时（毫秒），默认 10000 */
+    timeout?: number;
+    /** 自定义请求头 */
+    headers?: Record<string, string>;
+}
+
+/** CMS Public API 客户端 */
+declare class CmsClient {
+    private readonly config;
+    private readonly fetchFn;
+    constructor(config: CmsClientConfig);
+    /** 获取文章分页列表 */
+    getArticles(params?: ArticleListParams): Promise<Paginated<ArticleListItem>>;
+    /** 获取文章详情 */
+    getArticle(slug: string, locale?: string): Promise<ArticleDetail>;
+    /** 获取相关文章 */
+    getRelatedArticles(slug: string, options?: {
+        limit?: number;
+        locale?: string;
+    }): Promise<ArticleListItem[]>;
+    /** 获取所有作者 */
+    getAuthors(): Promise<Author[]>;
+    /** 获取作者详情 */
+    getAuthor(slug: string): Promise<Author>;
+    /** 获取作者的文章列表 */
+    getAuthorArticles(slug: string, options?: {
+        page?: number;
+        page_size?: number;
+        locale?: string;
+    }): Promise<ArticleListItem[]>;
+    /** 获取分类树 */
+    getCategories(): Promise<CategoryNode[]>;
+    /** 获取文章评论树 */
+    getComments(articleSlug: string): Promise<Comment[]>;
+    /** 发表评论 */
+    createComment(articleSlug: string, payload: CreateCommentPayload): Promise<void>;
+    /** 获取 Sitemap 条目 */
+    getSitemap(locale?: string): Promise<SitemapEntry[]>;
+    /** 获取重定向规则 */
+    getRedirects(): Promise<RedirectRule[]>;
+    /** 获取文章系列 */
+    getSeries(slug: string, locale?: string): Promise<Series>;
+    private request;
+    /** 构建完整 URL，过滤 undefined 参数 */
+    private buildUrl;
+    /** 构建请求头 */
+    private buildHeaders;
+}
+/** 创建 CMS 客户端实例 */
+declare function createCmsClient(config: CmsClientConfig): CmsClient;
+
+/** CMS API 错误 */
+declare class CmsApiError extends Error {
+    readonly statusCode: number;
+    readonly errorCode: string;
+    readonly body: unknown;
+    constructor(statusCode: number, errorCode: string, message: string, body?: unknown);
+    get isNotFound(): boolean;
+    get isUnauthorized(): boolean;
+}
+
+export { ArticleDetail, ArticleListItem, ArticleListParams, Author, CategoryNode, CmsApiError, CmsClient, Comment, CreateCommentPayload, Paginated, RedirectRule, Series, SitemapEntry, createCmsClient };
+export type { CmsClientConfig };

package/dist/index.mjs

@@ -0,0 +1,181 @@
+const DEFAULT_CONFIG = {
+  defaultLocale: "en",
+  timeout: 1e4
+};
+
+class CmsApiError extends Error {
+  statusCode;
+  errorCode;
+  body;
+  constructor(statusCode, errorCode, message, body) {
+    super(message);
+    this.name = "CmsApiError";
+    this.statusCode = statusCode;
+    this.errorCode = errorCode;
+    this.body = body;
+  }
+  get isNotFound() {
+    return this.statusCode === 404;
+  }
+  get isUnauthorized() {
+    return this.statusCode === 401;
+  }
+}
+
+class CmsClient {
+  config;
+  fetchFn;
+  constructor(config) {
+    this.config = { ...DEFAULT_CONFIG, ...config };
+    this.fetchFn = config.fetch ?? globalThis.fetch.bind(globalThis);
+  }
+  // ─── 文章 ───────────────────────────────────────────
+  /** 获取文章分页列表 */
+  async getArticles(params) {
+    return this.request("GET", "/articles", params);
+  }
+  /** 获取文章详情 */
+  async getArticle(slug, locale) {
+    return this.request("GET", `/articles/${encodeURIComponent(slug)}`, { locale });
+  }
+  /** 获取相关文章 */
+  async getRelatedArticles(slug, options) {
+    return this.request(
+      "GET",
+      `/articles/${encodeURIComponent(slug)}/related`,
+      options
+    );
+  }
+  // ─── 作者 ───────────────────────────────────────────
+  /** 获取所有作者 */
+  async getAuthors() {
+    return this.request("GET", "/authors");
+  }
+  /** 获取作者详情 */
+  async getAuthor(slug) {
+    return this.request("GET", `/authors/${encodeURIComponent(slug)}`);
+  }
+  /** 获取作者的文章列表 */
+  async getAuthorArticles(slug, options) {
+    return this.request(
+      "GET",
+      `/authors/${encodeURIComponent(slug)}/articles`,
+      options
+    );
+  }
+  // ─── 分类 ───────────────────────────────────────────
+  /** 获取分类树 */
+  async getCategories() {
+    return this.request("GET", "/categories");
+  }
+  // ─── 评论 ───────────────────────────────────────────
+  /** 获取文章评论树 */
+  async getComments(articleSlug) {
+    return this.request(
+      "GET",
+      `/articles/${encodeURIComponent(articleSlug)}/comments`
+    );
+  }
+  /** 发表评论 */
+  async createComment(articleSlug, payload) {
+    return this.request(
+      "POST",
+      `/articles/${encodeURIComponent(articleSlug)}/comments`,
+      void 0,
+      payload
+    );
+  }
+  // ─── Sitemap / 重定向 / 系列 ──────────────────────
+  /** 获取 Sitemap 条目 */
+  async getSitemap(locale) {
+    return this.request("GET", "/sitemap", { locale });
+  }
+  /** 获取重定向规则 */
+  async getRedirects() {
+    return this.request("GET", "/redirects");
+  }
+  /** 获取文章系列 */
+  async getSeries(slug, locale) {
+    return this.request("GET", `/series/${encodeURIComponent(slug)}`, { locale });
+  }
+  // ─── 内部请求方法 ──────────────────────────────────
+  async request(method, path, query, body) {
+    if (method === "GET" && this.config.defaultLocale) {
+      const q = query ?? {};
+      if (q.locale === void 0 || q.locale === null) {
+        q.locale = this.config.defaultLocale;
+      }
+      query = q;
+    }
+    const url = this.buildUrl(path, query);
+    const headers = this.buildHeaders(method);
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+    try {
+      const response = await this.fetchFn(url, {
+        method,
+        headers,
+        body: body !== void 0 ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      if (!response.ok) {
+        let errorBody;
+        let errorCode = "UNKNOWN_ERROR";
+        let errorMessage = `CMS API \u8BF7\u6C42\u5931\u8D25: ${response.status}`;
+        try {
+          errorBody = await response.json();
+          if (typeof errorBody === "object" && errorBody !== null && "code" in errorBody && "message" in errorBody) {
+            const parsed = errorBody;
+            errorCode = parsed.code;
+            errorMessage = parsed.message;
+          }
+        } catch {
+        }
+        throw new CmsApiError(response.status, errorCode, errorMessage, errorBody);
+      }
+      if (response.status === 204) {
+        return void 0;
+      }
+      return await response.json();
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  /** 构建完整 URL，过滤 undefined 参数 */
+  buildUrl(path, query) {
+    const base = this.config.baseUrl.replace(/\/+$/, "");
+    const url = new URL(`${base}${path}`);
+    if (query) {
+      for (const [key, value] of Object.entries(query)) {
+        if (value !== void 0 && value !== null) {
+          url.searchParams.set(key, String(value));
+        }
+      }
+    }
+    return url.toString();
+  }
+  /** 构建请求头 */
+  buildHeaders(method) {
+    const headers = {
+      Accept: "application/json"
+    };
+    if (method === "POST" || method === "PUT") {
+      headers["Content-Type"] = "application/json";
+    }
+    if (this.config.productCode) {
+      headers["X-Product-Code"] = this.config.productCode;
+    }
+    if (this.config.previewToken) {
+      headers["X-Preview-Token"] = this.config.previewToken;
+    }
+    if (this.config.headers) {
+      Object.assign(headers, this.config.headers);
+    }
+    return headers;
+  }
+}
+function createCmsClient(config) {
+  return new CmsClient(config);
+}
+
+export { CmsApiError, CmsClient, createCmsClient };

package/dist/types.d.mts

@@ -0,0 +1,169 @@
+/** 多语言字符串 (Go: domain.LocalizedString = map[string]string) */
+type LocalizedString = Record<string, string>;
+/** 分页元信息 (Go: response.PaginationMeta) */
+interface PaginationMeta {
+    page: number;
+    page_size: number;
+    total: number;
+    total_pages: number;
+}
+/** 分页响应 (Go: response.Paginated[T]) */
+interface Paginated<T> {
+    data: T[];
+    pagination: PaginationMeta;
+}
+
+/** 作者信息 (Go: delivery.DeliveryAuthorResponse) */
+interface Author {
+    display_name: string;
+    slug: string;
+    avatar_url?: string;
+    bio?: string;
+}
+
+/** 文章详情 (Go: delivery.DeliveryArticleResponse) */
+interface ArticleDetail {
+    slug: string;
+    title: string;
+    excerpt?: string;
+    content_html: string;
+    content_json?: unknown;
+    featured_image_url?: string;
+    featured_image_alt?: string;
+    category?: string;
+    tags: string[];
+    authors: Author[];
+    related_article_ids?: number[];
+    comment_count: number;
+    is_comment_enabled: boolean;
+    published_at: string | null;
+    last_published_at: string | null;
+    word_count: number;
+    reading_time_minutes: number;
+    seo_meta?: SeoMeta;
+    og_meta?: OgMeta;
+    twitter_meta?: TwitterMeta;
+    json_ld: Record<string, unknown> | null;
+    locale: string;
+    available_locales: string[];
+}
+/** 文章列表项 (Go: delivery.DeliveryArticleListItem) */
+interface ArticleListItem {
+    slug: string;
+    title: string;
+    excerpt?: string;
+    featured_image_url?: string;
+    featured_image_alt?: string;
+    published_at: string | null;
+    reading_time_minutes: number;
+    category_slug?: string;
+    is_pinned: boolean;
+    tags: string[];
+    authors: Author[];
+}
+/** 文章列表查询参数 */
+interface ArticleListParams {
+    locale?: string;
+    category_id?: number;
+    category_slug?: string;
+    tag?: string;
+    is_pinned?: boolean;
+    page?: number;
+    page_size?: number;
+}
+/** SEO 元信息 */
+interface SeoMeta {
+    title: string | null;
+    description: string | null;
+    keywords: string | null;
+    robots: string | null;
+    canonical_url: string | null;
+}
+/** Open Graph 元信息 */
+interface OgMeta {
+    title: string | null;
+    description: string | null;
+    image: string | null;
+    url: string | null;
+    type: string | null;
+}
+/** Twitter Card 元信息 */
+interface TwitterMeta {
+    card: string | null;
+    title: string | null;
+    description: string | null;
+    image: string | null;
+}
+
+/** 分类树节点 (Go: delivery.CategoryNodeResponse) */
+interface CategoryNode {
+    id: number;
+    slug: string;
+    name: LocalizedString;
+    description: LocalizedString;
+    article_count: number;
+    article_counts?: Record<string, number>;
+    children?: CategoryNode[];
+}
+
+/** 评论树节点 (Go: delivery.CommentTreeResponse) */
+interface Comment {
+    id: number;
+    author_name: string;
+    author_url?: string;
+    content_html: string;
+    is_pinned: boolean;
+    like_count: number;
+    created_at: string;
+    children?: Comment[];
+}
+/** 发表评论请求 */
+interface CreateCommentPayload {
+    author_name: string;
+    author_email: string;
+    content: string;
+    parent_id?: number;
+}
+
+/** 重定向规则 (Go: delivery.RedirectRuleResponse) */
+interface RedirectRule {
+    source_path: string;
+    destination_path: string;
+    status_code: number;
+    match_type: string;
+}
+
+/** 文章系列 (Go: delivery.DeliverySeriesResponse) */
+interface Series {
+    title: string;
+    slug: string;
+    description: string | null;
+    cover_image_url: string | null;
+    articles: ArticleListItem[];
+}
+
+/** Hreflang 条目 (Go: delivery.HreflangEntry) */
+interface HreflangEntry {
+    lang: string;
+    href: string;
+}
+/** Sitemap 条目 (Go: delivery.SitemapEntryResponse) */
+interface SitemapEntry {
+    loc: string;
+    last_mod: string;
+    change_freq: string;
+    priority: number;
+    hreflang?: HreflangEntry[];
+}
+
+/** Webhook 事件类型 */
+type WebhookEventType = 'article.published' | 'article.unpublished' | 'article.updated' | 'article.archived' | 'redirect.changed' | 'comment.approved';
+/** ISR 重验证请求体 */
+interface RevalidatePayload {
+    event: WebhookEventType;
+    slug: string;
+    locale: string;
+    category_slug?: string;
+}
+
+export type { ArticleDetail, ArticleListItem, ArticleListParams, Author, CategoryNode, Comment, CreateCommentPayload, HreflangEntry, LocalizedString, OgMeta, Paginated, PaginationMeta, RedirectRule, RevalidatePayload, SeoMeta, Series, SitemapEntry, TwitterMeta, WebhookEventType };

package/dist/types.d.ts

@@ -0,0 +1,169 @@
+/** 多语言字符串 (Go: domain.LocalizedString = map[string]string) */
+type LocalizedString = Record<string, string>;
+/** 分页元信息 (Go: response.PaginationMeta) */
+interface PaginationMeta {
+    page: number;
+    page_size: number;
+    total: number;
+    total_pages: number;
+}
+/** 分页响应 (Go: response.Paginated[T]) */
+interface Paginated<T> {
+    data: T[];
+    pagination: PaginationMeta;
+}
+
+/** 作者信息 (Go: delivery.DeliveryAuthorResponse) */
+interface Author {
+    display_name: string;
+    slug: string;
+    avatar_url?: string;
+    bio?: string;
+}
+
+/** 文章详情 (Go: delivery.DeliveryArticleResponse) */
+interface ArticleDetail {
+    slug: string;
+    title: string;
+    excerpt?: string;
+    content_html: string;
+    content_json?: unknown;
+    featured_image_url?: string;
+    featured_image_alt?: string;
+    category?: string;
+    tags: string[];
+    authors: Author[];
+    related_article_ids?: number[];
+    comment_count: number;
+    is_comment_enabled: boolean;
+    published_at: string | null;
+    last_published_at: string | null;
+    word_count: number;
+    reading_time_minutes: number;
+    seo_meta?: SeoMeta;
+    og_meta?: OgMeta;
+    twitter_meta?: TwitterMeta;
+    json_ld: Record<string, unknown> | null;
+    locale: string;
+    available_locales: string[];
+}
+/** 文章列表项 (Go: delivery.DeliveryArticleListItem) */
+interface ArticleListItem {
+    slug: string;
+    title: string;
+    excerpt?: string;
+    featured_image_url?: string;
+    featured_image_alt?: string;
+    published_at: string | null;
+    reading_time_minutes: number;
+    category_slug?: string;
+    is_pinned: boolean;
+    tags: string[];
+    authors: Author[];
+}
+/** 文章列表查询参数 */
+interface ArticleListParams {
+    locale?: string;
+    category_id?: number;
+    category_slug?: string;
+    tag?: string;
+    is_pinned?: boolean;
+    page?: number;
+    page_size?: number;
+}
+/** SEO 元信息 */
+interface SeoMeta {
+    title: string | null;
+    description: string | null;
+    keywords: string | null;
+    robots: string | null;
+    canonical_url: string | null;
+}
+/** Open Graph 元信息 */
+interface OgMeta {
+    title: string | null;
+    description: string | null;
+    image: string | null;
+    url: string | null;
+    type: string | null;
+}
+/** Twitter Card 元信息 */
+interface TwitterMeta {
+    card: string | null;
+    title: string | null;
+    description: string | null;
+    image: string | null;
+}
+
+/** 分类树节点 (Go: delivery.CategoryNodeResponse) */
+interface CategoryNode {
+    id: number;
+    slug: string;
+    name: LocalizedString;
+    description: LocalizedString;
+    article_count: number;
+    article_counts?: Record<string, number>;
+    children?: CategoryNode[];
+}
+
+/** 评论树节点 (Go: delivery.CommentTreeResponse) */
+interface Comment {
+    id: number;
+    author_name: string;
+    author_url?: string;
+    content_html: string;
+    is_pinned: boolean;
+    like_count: number;
+    created_at: string;
+    children?: Comment[];
+}
+/** 发表评论请求 */
+interface CreateCommentPayload {
+    author_name: string;
+    author_email: string;
+    content: string;
+    parent_id?: number;
+}
+
+/** 重定向规则 (Go: delivery.RedirectRuleResponse) */
+interface RedirectRule {
+    source_path: string;
+    destination_path: string;
+    status_code: number;
+    match_type: string;
+}
+
+/** 文章系列 (Go: delivery.DeliverySeriesResponse) */
+interface Series {
+    title: string;
+    slug: string;
+    description: string | null;
+    cover_image_url: string | null;
+    articles: ArticleListItem[];
+}
+
+/** Hreflang 条目 (Go: delivery.HreflangEntry) */
+interface HreflangEntry {
+    lang: string;
+    href: string;
+}
+/** Sitemap 条目 (Go: delivery.SitemapEntryResponse) */
+interface SitemapEntry {
+    loc: string;
+    last_mod: string;
+    change_freq: string;
+    priority: number;
+    hreflang?: HreflangEntry[];
+}
+
+/** Webhook 事件类型 */
+type WebhookEventType = 'article.published' | 'article.unpublished' | 'article.updated' | 'article.archived' | 'redirect.changed' | 'comment.approved';
+/** ISR 重验证请求体 */
+interface RevalidatePayload {
+    event: WebhookEventType;
+    slug: string;
+    locale: string;
+    category_slug?: string;
+}
+
+export type { ArticleDetail, ArticleListItem, ArticleListParams, Author, CategoryNode, Comment, CreateCommentPayload, HreflangEntry, LocalizedString, OgMeta, Paginated, PaginationMeta, RedirectRule, RevalidatePayload, SeoMeta, Series, SitemapEntry, TwitterMeta, WebhookEventType };

package/dist/types.mjs

@@ -0,0 +1 @@
+

package/dist/webhook.d.mts

@@ -0,0 +1,10 @@
+interface VerifyWebhookOptions {
+    rawBody: string;
+    signature: string;
+    secret: string;
+}
+/** 验证 Webhook 签名（HMAC-SHA256） */
+declare function verifyWebhookSignature(options: VerifyWebhookOptions): boolean;
+
+export { verifyWebhookSignature };
+export type { VerifyWebhookOptions };

package/dist/webhook.d.ts

@@ -0,0 +1,10 @@
+interface VerifyWebhookOptions {
+    rawBody: string;
+    signature: string;
+    secret: string;
+}
+/** 验证 Webhook 签名（HMAC-SHA256） */
+declare function verifyWebhookSignature(options: VerifyWebhookOptions): boolean;
+
+export { verifyWebhookSignature };
+export type { VerifyWebhookOptions };

package/dist/webhook.mjs

@@ -0,0 +1,13 @@
+import { createHmac, timingSafeEqual } from 'node:crypto';
+
+function verifyWebhookSignature(options) {
+  const { rawBody, signature, secret } = options;
+  if (!signature || !rawBody || !secret) return false;
+  const expected = `sha256=${createHmac("sha256", secret).update(rawBody).digest("hex")}`;
+  const sigBuffer = Buffer.from(signature);
+  const expectedBuffer = Buffer.from(expected);
+  if (sigBuffer.length !== expectedBuffer.length) return false;
+  return timingSafeEqual(sigBuffer, expectedBuffer);
+}
+
+export { verifyWebhookSignature };

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@vigilkids/cms-client",
+  "version": "0.0.1",
+  "description": "Framework-agnostic TypeScript client for OnEx CMS Public API",
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.mjs"
+    },
+    "./webhook": {
+      "types": "./dist/webhook.d.ts",
+      "import": "./dist/webhook.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "unbuild"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/1yhy/onex.git",
+    "directory": "packages/cms-client"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "unbuild": "^3.5.0"
+  }
+}