@rxdrag/website-lib-core 0.0.127 → 0.0.128

package/src/entify/Entify.ts

@@ -1,530 +1,533 @@
-import { EnvVariables } from "./types";
-import { queryOneTheme } from "./lib/queryOneTheme";
-import {
-  ListConditions,
-  queryEntityList,
-  queryFeaturedProducts,
-  queryLangs,
-  queryLatestPosts,
-  queryOnePostBySlug,
-  queryOnePostCategoryBySlug,
-  queryOneProductBySlug,
-  queryOneProductCategoryBySlug,
-  queryOneUser,
-  queryPostCategories,
-  queryPosts,
-  queryProductCategories,
-  queryProducts,
-  queryTagCategories,
-  queryTags,
-  queryUserPosts,
-  fulltextSearch,
-  queryOneEntity,
-  createUploadCredentials,
-  UploadOptions,
-  UploadSession,
-} from "./lib";
-import { IQueryOptions } from "@rxdrag/entify-lib";
-import { queryAllProducts } from "./lib/queryAllProducts";
-import { queryPostSlugs } from "./lib/queryPostSlugs";
-import { queryUserIds } from "./lib/queryUserIds";
-import { IEntify, PostPatinateOptions, PostsOptions } from "./IEntify";
-import { queryWebsite } from "./lib/queryWebsite";
-import {
-  ImageSize,
-  ImageSizes,
-  Media,
-  Page,
-  PageType,
-  Product,
-  WebsitePart,
-  WebsitePartBoolExp,
-} from "@rxdrag/rxcms-models";
-import { queryPageBySlug } from "./lib/queryPageBySlug";
-import { queryPageByType } from "./lib/queryPageByType";
-import { queryOneMedia } from "./lib/queryOneMedia";
-import { DEFAULT_LARGE, DEFAULT_MEDIUM, DEFAULT_SAMLL, DEFUALT_HEIGHT, DEFUALT_WIDTH, FileFieldType, ImageResize } from "../astro/media";
-import { queryOneIcon } from "./lib/queryOneIcon";
-import { queryBulletin } from "./lib/queryBulletin";
-
-export class Entify implements IEntify {
-  private static instance: Entify | null = null;
-
-  private constructor(protected envVariables: EnvVariables, protected imageSizes: ImageSizes) { }
-  private flattenTree<T>(nodes: T[] | undefined): T[] {
-    if (!nodes) return [];
-    let result: T[] = [];
-    for (const node of nodes) {
-      result.push(node);
-      const children = (node as { children?: T[] }).children;
-      if (children && children.length > 0) {
-        result = result.concat(this.flattenTree(children));
-      }
-    }
-    return result;
-  }
-
-  public static getInstance(envVariables: EnvVariables, imageSizes: ImageSizes): Entify {
-    if (!Entify.instance) {
-      Entify.instance = new Entify(envVariables, imageSizes);
-    }
-    return Entify.instance;
-  }
-
-  public setImageSizes(imageSizes: ImageSizes): void {
-    this.imageSizes = imageSizes;
-  }
-
-  public getImageSizes(): ImageSizes {
-    return this.imageSizes;
-  }
-
-  public async queryEntityList<
-    T,
-    WhereExp = unknown,
-    OrderBy = unknown,
-    DistinctExp = unknown
-  >(options: IQueryOptions<T, WhereExp, OrderBy, DistinctExp>) {
-    return await queryEntityList<T, WhereExp, OrderBy, DistinctExp>(
-      options,
-      this.envVariables
-    );
-  }
-
-  public async queryOneEntity<T extends WebsitePart = WebsitePart>(
-    options: IQueryOptions<T, WebsitePartBoolExp>
-  ) {
-    return await queryOneEntity<T, WebsitePartBoolExp>(
-      options,
-      this.envVariables
-    );
-  }
-
-  public getLang() {
-    return this.envVariables.language || "en-US";
-  }
-
-  public async getWebsite() {
-    return queryWebsite(this.envVariables);
-  }
-
-  public async getTheme() {
-    return await queryOneTheme(this.envVariables);
-  }
-
-  public async getLangs() {
-    return (await queryLangs(this.envVariables))?.items;
-  }
-
-  public async getMedia(ref: string | undefined | null, fileField?: FileFieldType, resize?: ImageResize): Promise<Media | undefined> {
-    const fields: string[] = []
-    switch (fileField) {
-      case "resize":
-        fields.push(`resize(width: ${resize?.width || DEFUALT_WIDTH}, height: ${resize?.height || DEFUALT_HEIGHT})`)
-        break;
-      case "small":
-        fields.push(`small(width: ${this.imageSizes.small?.width || DEFAULT_SAMLL.width}, height: ${this.imageSizes.small?.height || DEFAULT_SAMLL.height})`)
-        break;
-      case "medium":
-        fields.push(`medium(width: ${this.imageSizes.medium?.width || DEFAULT_MEDIUM.width}, height: ${this.imageSizes.medium?.height || DEFAULT_MEDIUM.height})`)
-        break;
-      case "large":
-        fields.push(`large(width: ${this.imageSizes.large?.width || DEFAULT_LARGE.width}, height: ${this.imageSizes.large?.height || DEFAULT_LARGE.height})`)
-        break;
-    }
-    return await queryOneMedia(ref, fields, this.envVariables);
-  }
-
-  public async getIcon(name: string | undefined | null) {
-    return await queryOneIcon(name, this.envVariables);
-  }
-
-  public async getBulletin() {
-    return await queryBulletin(this.envVariables);
-  }
-
-
-  public async getFeaturedProducts(
-    count?: number,
-    imageSize?: ImageSize,
-    addonFields?: (keyof Product)[]
-  ) {
-    if (!imageSize) {
-      imageSize = this.imageSizes?.productThumbnial;
-    }
-    return await queryFeaturedProducts(
-      count,
-      imageSize,
-      this.envVariables,
-      addonFields
-    );
-  }
-
-  public async getLatestPosts(count?: number, coverSize?: ImageSize) {
-    if (!coverSize) {
-      coverSize = this.imageSizes?.postThumbnial;
-    }
-    return await queryLatestPosts(count, coverSize, this.envVariables);
-  }
-
-  public async getHomePage(): Promise<Page | undefined> {
-    return await this.getPageByType(PageType.Home);
-  }
-  public async getPostPage(): Promise<Page | undefined> {
-    return await this.getPageByType(PageType.Post);
-  }
-  public async getPostListPage(): Promise<Page | undefined> {
-    return await this.getPageByType(PageType.PostList);
-  }
-  public async getPostCategoryPage(): Promise<Page | undefined> {
-    return await this.getPageByType(PageType.PostCategory);
-  }
-  public async getProductPage(): Promise<Page | undefined> {
-    return await this.getPageByType(PageType.Product);
-  }
-  public async getProductListPage(): Promise<Page | undefined> {
-    return await this.getPageByType(PageType.ProductList);
-  }
-  public async getProductCategoryPage(): Promise<Page | undefined> {
-    return await this.getPageByType(PageType.ProductCategory);
-  }
-  public async getSearchPage(): Promise<Page | undefined> {
-    return await this.getPageByType(PageType.SearchList);
-  }
-  public async getProfilePage(): Promise<Page | undefined> {
-    return await this.getPageByType(PageType.Profile);
-  }
-  public async getThanksPage(): Promise<Page | undefined> {
-    return await this.getPageByType(PageType.Thanks);
-  }
-  public async get404Page(): Promise<Page | undefined> {
-    return await this.getPageByType(PageType.Page404);
-  }
-  public async getErrorPage(): Promise<Page | undefined> {
-    return await this.getPageByType(PageType.PageError);
-  }
-  public async getPageBySlug(slug: string): Promise<Page | undefined> {
-    return await queryPageBySlug(slug, this.envVariables);
-  }
-
-  public async getPageByType(pageType: PageType): Promise<Page | undefined> {
-    return await queryPageByType(pageType, this.envVariables);
-  }
-
-  public async getPosts(options: PostsOptions) {
-    const { category, coverSize, page, pageSize } = options;
-    const conditions: ListConditions = { category, page, pageSize };
-    const result = await queryPosts(conditions, coverSize, this.envVariables);
-    return result?.items;
-  }
-
-  public async getPostListPaths(options: PostPatinateOptions) {
-    const { category, pageSize } = options;
-    // 获取总文章数据，只需要获取总数
-    // TODO: 目前数据查询有点重复，后续要结合后端优化
-    const postsData = await queryPosts(
-      { category, page: 1, pageSize: 10 },
-      undefined,
-      this.envVariables
-    );
-
-    const totalItems = postsData?.total ?? 0;
-
-    return this.createPagination(totalItems, pageSize);
-  }
-
-  public async getPostPaths() {
-    // 获取所有文章的 slug
-    const slugs = await this.getPostSlugs();
-
-    // 为每个 slug 创建路径
-    return slugs.map((slug) => ({
-      params: { slug },
-      props: { slug },
-    }));
-  }
-
-  public async getPostBySlug(slug: string, coverSize: ImageSize | undefined) {
-    if (!coverSize) {
-      coverSize = this.imageSizes.post;
-    }
-    return await queryOnePostBySlug(slug, coverSize, this.envVariables);
-  }
-
-  /**
-   * 获取所有文章的 slug，用于生成静态页面
-   * 对于大量文章，这个方法会进行优化，只获取 slug 字段
-   */
-  public async getPostSlugs() {
-    // 只获取 slug 字段，减少数据传输量
-    const result = await queryPostSlugs(this.envVariables);
-
-    return result?.items?.map((post) => post.slug) || [];
-  }
-
-  public async getPostCategories() {
-    return await queryPostCategories(this.envVariables);
-  }
-
-  public async getPostCategoryBySlug(slug: string) {
-    return await queryOnePostCategoryBySlug(slug, this.envVariables);
-  }
-
-  public async getTagCategories() {
-    return await queryTagCategories(this.envVariables);
-  }
-
-  public async getTags(categoryId?: string) {
-    return await queryTags(this.envVariables, categoryId);
-  }
-
-  public async getProducts(
-    conditions: ListConditions,
-    imageSize: ImageSize | undefined,
-    addonFields?: (keyof Product)[]
-  ) {
-    if (!imageSize) {
-      imageSize = this.imageSizes.productThumbnial;
-    }
-    return (
-      await queryProducts(conditions, imageSize, this.envVariables, addonFields)
-    )?.items;
-  }
-
-  public async getProductListPaths(options: {
-    category?: string;
-    pageSize: number;
-  }) {
-    const { category, pageSize } = options;
-    // 获取总产品数据，只需要获取总数
-    const productsData = await queryProducts(
-      { category, page: 1, pageSize: 10 },
-      undefined,
-      this.envVariables
-    );
-
-    const totalItems = productsData?.total ?? 0;
-
-    return this.createPagination(totalItems, pageSize);
-  }
-
-  public async getCategoredProductListPaths() {
-    // 获取所有产品分类
-    const categoryTree = await this.getProductCategories();
-    const categories = this.flattenTree(categoryTree);
-
-    // 为每个分类生成路径
-    const paths = [];
-
-    // 如果没有分类，至少创建一个默认路径
-    if (!categories || categories.length === 0) {
-      paths.push({
-        params: { slug: "default", page: "1" },
-        props: {
-          currentPage: 1,
-          totalPages: 1,
-          pageSize: 12,
-          totalItems: 0,
-          slug: "default",
-        },
-      });
-      return paths;
-    }
-
-    for (const category of categories) {
-      // 跳过没有 slug 的分类
-      if (!category.slug) continue;
-
-      // 获取该分类下的分页路径
-      const categoryPaths = await this.getProductListPaths({
-        pageSize: 12,
-        category: category.slug,
-      });
-
-      // 如果该分类没有产品，至少创建一个第一页
-      if (categoryPaths.length === 0) {
-        paths.push({
-          params: { slug: String(category.slug), page: "1" },
-          props: {
-            currentPage: 1,
-            totalPages: 1,
-            pageSize: 12,
-            totalItems: 0,
-            slug: String(category.slug),
-          },
-        });
-        continue;
-      }
-
-      // 为每个分页路径添加分类 slug
-      for (const path of categoryPaths) {
-        paths.push({
-          params: { ...path.params, slug: String(category.slug) },
-          props: { ...path.props, slug: String(category.slug) },
-        });
-      }
-    }
-
-    return paths;
-  }
-
-  /**
-   * 获取所有文章分类的分页路径
-   * 用于生成静态页面
-   * @returns 所有文章分类的分页路径
-   */
-  public async getCategoredPostListPaths() {
-    // 获取所有文章分类
-    const categoryTree = await this.getPostCategories();
-    const categories = this.flattenTree(categoryTree);
-
-    // 为每个分类生成路径
-    const paths = [];
-
-    // 如果没有分类，至少创建一个默认路径
-    if (!categories || categories.length === 0) {
-      paths.push({
-        params: { slug: "default", page: "1" },
-        props: {
-          currentPage: 1,
-          totalPages: 1,
-          pageSize: 10,
-          totalItems: 0,
-          slug: "default",
-        },
-      });
-      return paths;
-    }
-
-    for (const category of categories) {
-      // 跳过没有 slug 的分类
-      if (!category.slug) continue;
-
-      // 获取该分类下的分页路径
-      const categoryPaths = await this.getPostListPaths({
-        pageSize: 10,
-        category: category.slug,
-      });
-
-      // 如果该分类没有文章，至少创建一个第一页
-      if (categoryPaths.length === 0) {
-        paths.push({
-          params: { slug: String(category.slug), page: "1" },
-          props: {
-            currentPage: 1,
-            totalPages: 1,
-            pageSize: 10,
-            totalItems: 0,
-            slug: String(category.slug),
-          },
-        });
-        continue;
-      }
-
-      // 为每个分页路径添加分类 slug
-      for (const path of categoryPaths) {
-        paths.push({
-          params: { ...path.params, slug: String(category.slug) },
-          props: { ...path.props, slug: String(category.slug) },
-        });
-      }
-    }
-
-    return paths;
-  }
-
-  public async getProductBySlug(slug: string, imageSize: ImageSize | undefined) {
-    if (!imageSize) {
-      imageSize = this.imageSizes.product;
-    }
-    return await queryOneProductBySlug(slug, imageSize, this.envVariables);
-  }
-
-  public async getProductPaths() {
-    // 获取所有产品的 slug
-    const slugs = await this.getProductSlugs();
-
-    // 为每个 slug 创建路径
-    return slugs.map((slug) => ({
-      params: { slug },
-      props: { slug },
-    }));
-  }
-
-  /**
-   * 获取所有产品的 slug，用于生成静态页面
-   * 对于大量产品，这个方法会进行优化，只获取 slug 字段
-   */
-  public async getProductSlugs() {
-    // 只获取 slug 字段，减少数据传输量
-    const result = await queryAllProducts(this.envVariables);
-    return result?.items?.map((product) => product.slug) || [];
-  }
-
-  public async getProductIds() {
-    const result = await queryAllProducts(this.envVariables);
-    return result?.items?.map((product) => product.id) || [];
-  }
-
-  public async getProductCategories() {
-    return await queryProductCategories(this.envVariables);
-  }
-
-  public async getProductCategoryBySlug(slug: string) {
-    return await queryOneProductCategoryBySlug(slug, this.envVariables);
-  }
-
-  public async getOneUser(id: string) {
-    return await queryOneUser(id, this.envVariables);
-  }
-
-  public async getUserPosts(userId: string) {
-    return (await queryUserPosts({ userId }, this.envVariables))?.items;
-  }
-
-  public async fulltextSearch(keyword: string, imageSize: ImageSize | undefined) {
-    if (!imageSize) {
-      imageSize = this.imageSizes.postThumbnial;
-    }
-    return await fulltextSearch(keyword, imageSize, this.envVariables);
-  }
-
-  public async getUserPaths() {
-    const result = await queryUserIds(this.envVariables);
-    return (
-      result?.items?.map((user) => ({
-        params: { id: user.id },
-        props: { id: user.id },
-      })) || []
-    );
-  }
-
-  public createPagination(totalItems: number, pageSize: number) {
-    const totalPages = Math.max(1, Math.ceil(totalItems / pageSize));
-
-    // 为每个页面创建路径和获取对应的文章数据
-    const paths = [];
-
-    for (let i = 0; i < totalPages; i++) {
-      const currentPage = i + 1;
-
-      paths.push({
-        params: { page: String(currentPage) },
-        props: {
-          currentPage,
-          totalPages,
-          pageSize,
-          totalItems,
-        },
-      });
-    }
-
-    return paths;
-  }
-
-  public async createUploadCredentials(
-    options: UploadOptions
-  ): Promise<UploadSession | null> {
-    return await createUploadCredentials(options, this.envVariables);
-  }
-}
+import { EnvVariables } from "./types";
+import { queryOneTheme } from "./lib/queryOneTheme";
+import {
+  ListConditions,
+  queryEntityList,
+  queryFeaturedProducts,
+  queryLangs,
+  queryLatestPosts,
+  queryOnePostBySlug,
+  queryOnePostCategoryBySlug,
+  queryOneProductBySlug,
+  queryOneProductCategoryBySlug,
+  queryOneUser,
+  queryPostCategories,
+  queryPosts,
+  queryProductCategories,
+  queryProducts,
+  queryTagCategories,
+  queryTags,
+  queryUserPosts,
+  fulltextSearch,
+  queryOneEntity,
+  createUploadCredentials,
+  UploadOptions,
+  UploadSession,
+} from "./lib";
+import { IQueryOptions } from "@rxdrag/entify-lib";
+import { queryAllProducts } from "./lib/queryAllProducts";
+import { queryPostSlugs } from "./lib/queryPostSlugs";
+import { queryUserIds } from "./lib/queryUserIds";
+import { IEntify, PostPatinateOptions, PostsOptions } from "./IEntify";
+import { queryWebsite } from "./lib/queryWebsite";
+import {
+  ImageSize,
+  ImageSizes,
+  Product,
+  WebsitePart,
+  WebsitePartBoolExp,
+} from "@rxdrag/rxcms-models";
+import { queryOneMedia } from "./lib/queryOneMedia";
+import { FileFieldType, ImageResize } from "../astro/media";
+import { queryBulletin } from "./lib/queryBulletin";
+
+export class Entify implements IEntify {
+  private static instance: Entify | null = null;
+
+  private constructor(protected envVariables: EnvVariables, protected imageSizes: ImageSizes) { }
+  private flattenTree<T>(nodes: T[] | undefined): T[] {
+    if (!nodes) return [];
+    let result: T[] = [];
+    for (const node of nodes) {
+      result.push(node);
+      const children = (node as { children?: T[] }).children;
+      if (children && children.length > 0) {
+        result = result.concat(this.flattenTree(children));
+      }
+    }
+    return result;
+  }
+
+  /**
+   * 获取 Entify 单例实例（无参数，获取已创建的实例）
+   */
+  public static getInstance(): Entify;
+  /**
+   * 获取 Entify 单例实例（带参数，创建或更新实例）
+   */
+  public static getInstance(envVariables: EnvVariables, imageSizes: ImageSizes): Entify;
+  public static getInstance(envVariables?: EnvVariables, imageSizes?: ImageSizes): Entify {
+    // 无参数调用：获取已创建的实例
+    if (envVariables === undefined && imageSizes === undefined) {
+      if (!Entify.instance) {
+        throw new Error(
+          'Entify instance not initialized. Please call getInstance(envVariables, imageSizes) first.'
+        );
+      }
+      return Entify.instance;
+    }
+    
+    // 有参数调用：创建或更新实例
+    if (!Entify.instance) {
+      Entify.instance = new Entify(envVariables!, imageSizes!);
+    } else {
+      Entify.instance.envVariables = envVariables!;
+      Entify.instance.imageSizes = imageSizes!;
+    }
+    return Entify.instance;
+  }
+
+  private currentLangAbbr?: string;
+
+  /**
+   * 设置当前语言
+   */
+  public setLangAbbr(langAbbr: string): void {
+    this.currentLangAbbr = langAbbr;
+  }
+
+  /**
+   * 获取当前语言，如果未设置则抛出异常
+   */
+  private ensureLangAbbr(): string {
+    if (!this.currentLangAbbr) {
+      throw new Error(
+        'langAbbr is not set. Please call setLangAbbr() before using language-dependent methods.'
+      );
+    }
+    return this.currentLangAbbr;
+  }
+
+  public setImageSizes(imageSizes: ImageSizes): void {
+    this.imageSizes = imageSizes;
+  }
+
+  public getImageSizes(): ImageSizes {
+    return this.imageSizes;
+  }
+
+  public async queryEntityList<
+    T,
+    WhereExp = unknown,
+    OrderBy = unknown,
+    DistinctExp = unknown
+  >(options: IQueryOptions<T, WhereExp, OrderBy, DistinctExp>) {
+    return await queryEntityList<T, WhereExp, OrderBy, DistinctExp>(
+      options,
+      this.envVariables
+    );
+  }
+
+  public async queryOneEntity<T extends WebsitePart = WebsitePart>(
+    options: IQueryOptions<T, WebsitePartBoolExp>
+  ) {
+    return await queryOneEntity<T, WebsitePartBoolExp>(
+      options,
+      this.envVariables
+    );
+  }
+
+  public async getWebsite() {
+    return queryWebsite(this.envVariables);
+  }
+
+  public async getTheme() {
+    return await queryOneTheme(this.envVariables);
+  }
+
+  public async getLangs() {
+    return (await queryLangs(this.envVariables))?.items;
+  }
+
+  public async getBaseLang() {
+    const website = await this.getWebsite();
+    return website?.baseLang;
+  }
+
+  public async getMedia(ref: string | undefined | null, fileField: FileFieldType = 'thumbnail', resize?: ImageResize) {
+    const fields = [fileField];
+    return await queryOneMedia(ref, fields, this.envVariables);
+  }
+
+  public async getBulletin() {
+    const langAbbr = this.ensureLangAbbr();
+    return await queryBulletin(this.envVariables, langAbbr);
+  }
+
+
+  public async getFeaturedProducts(
+    count: number | undefined,
+    imageSize: ImageSize | undefined,
+    addonFields: (keyof Product)[] | undefined
+  ) {
+    const langAbbr = this.ensureLangAbbr();
+    if (!imageSize) {
+      imageSize = this.imageSizes?.productThumbnial;
+    }
+    return await queryFeaturedProducts(
+      count,
+      imageSize,
+      this.envVariables,
+      addonFields,
+      langAbbr
+    );
+  }
+
+  public async getLatestPosts(count: number | undefined, coverSize: ImageSize | undefined) {
+    const langAbbr = this.ensureLangAbbr();
+    if (!coverSize) {
+      coverSize = this.imageSizes?.postThumbnial;
+    }
+    return await queryLatestPosts(count, coverSize, this.envVariables, langAbbr);
+  }
+
+
+  public async getPosts(options: PostsOptions) {
+    const langAbbr = this.ensureLangAbbr();
+    const { category, coverSize, page, pageSize } = options;
+    const conditions: ListConditions = { category, page, pageSize };
+    const result = await queryPosts(conditions, coverSize, this.envVariables, langAbbr);
+    return result?.items;
+  }
+
+  public async getPostListPaths(options: PostPatinateOptions) {
+    const langAbbr = this.ensureLangAbbr();
+    const { category, pageSize } = options;
+    // 获取总文章数据，只需要获取总数
+    // TODO: 目前数据查询有点重复，后续要结合后端优化
+    const postsData = await queryPosts(
+      { category, page: 1, pageSize: 10 },
+      undefined,
+      this.envVariables,
+      langAbbr
+    );
+
+    const totalItems = postsData?.total ?? 0;
+
+    return this.createPagination(totalItems, pageSize);
+  }
+
+  public async getPostPaths() {
+    // 获取所有文章的 slug
+    const slugs = await this.getPostSlugs();
+
+    // 为每个 slug 创建路径
+    return slugs.map((slug) => ({
+      params: { slug },
+      props: { slug },
+    }));
+  }
+
+  public async getPostBySlug(slug: string, coverSize: ImageSize | undefined) {
+    const langAbbr = this.ensureLangAbbr();
+    if (!coverSize) {
+      coverSize = this.imageSizes.post;
+    }
+    return await queryOnePostBySlug(slug, coverSize, this.envVariables, langAbbr);
+  }
+
+  /**
+   * 获取所有文章的 slug，用于生成静态页面
+   * 对于大量文章，这个方法会进行优化，只获取 slug 字段
+   */
+  public async getPostSlugs() {
+    const langAbbr = this.ensureLangAbbr();
+    // 只获取 slug 字段，减少数据传输量
+    const result = await queryPostSlugs(this.envVariables, langAbbr);
+
+    return result?.items?.map((post) => post.slug) || [];
+  }
+
+  public async getPostCategories() {
+    const langAbbr = this.ensureLangAbbr();
+    return await queryPostCategories(this.envVariables, langAbbr);
+  }
+
+  public async getPostCategoryBySlug(slug: string) {
+    const langAbbr = this.ensureLangAbbr();
+    return await queryOnePostCategoryBySlug(slug, this.envVariables, langAbbr);
+  }
+
+  public async getTagCategories() {
+    const langAbbr = this.ensureLangAbbr();
+    return await queryTagCategories(this.envVariables, langAbbr);
+  }
+
+  public async getTags(categoryId: string | undefined) {
+    const langAbbr = this.ensureLangAbbr();
+    return await queryTags(this.envVariables, categoryId, langAbbr);
+  }
+
+  public async getProducts(
+    conditions: ListConditions,
+    imageSize: ImageSize | undefined,
+    addonFields: (keyof Product)[] | undefined
+  ) {
+    const langAbbr = this.ensureLangAbbr();
+    if (!imageSize) {
+      imageSize = this.imageSizes.productThumbnial;
+    }
+    return (
+      await queryProducts(conditions, imageSize, this.envVariables, addonFields, langAbbr)
+    )?.items;
+  }
+
+  public async getProductListPaths(options: {
+    category?: string;
+    pageSize: number;
+  }) {
+    const langAbbr = this.ensureLangAbbr();
+    const { category, pageSize } = options;
+    // 获取总产品数据，只需要获取总数
+    const productsData = await queryProducts(
+      { category, page: 1, pageSize: 10 },
+      undefined,
+      this.envVariables,
+      undefined,
+      langAbbr
+    );
+
+    const totalItems = productsData?.total ?? 0;
+
+    return this.createPagination(totalItems, pageSize);
+  }
+
+  public async getCategoredProductListPaths() {
+    const langAbbr = this.ensureLangAbbr();
+    // 获取所有产品分类
+    const categoryTree = await this.getProductCategories();
+    const categories = this.flattenTree(categoryTree);
+
+    // 为每个分类生成路径
+    const paths = [];
+
+    // 如果没有分类，至少创建一个默认路径
+    if (!categories || categories.length === 0) {
+      paths.push({
+        params: { slug: "default", page: "1" },
+        props: {
+          currentPage: 1,
+          totalPages: 1,
+          pageSize: 12,
+          totalItems: 0,
+          slug: "default",
+        },
+      });
+      return paths;
+    }
+
+    for (const category of categories) {
+      // 跳过没有 slug 的分类
+      if (!category.slug) continue;
+
+      // 获取该分类下的分页路径
+      const categoryPaths = await this.getProductListPaths({
+        pageSize: 12,
+        category: category.slug,
+      });
+
+      // 如果该分类没有产品，至少创建一个第一页
+      if (categoryPaths.length === 0) {
+        paths.push({
+          params: { slug: String(category.slug), page: "1" },
+          props: {
+            currentPage: 1,
+            totalPages: 1,
+            pageSize: 12,
+            totalItems: 0,
+            slug: String(category.slug),
+          },
+        });
+        continue;
+      }
+
+      // 为每个分页路径添加分类 slug
+      for (const path of categoryPaths) {
+        paths.push({
+          params: { ...path.params, slug: String(category.slug) },
+          props: { ...path.props, slug: String(category.slug) },
+        });
+      }
+    }
+
+    return paths;
+  }
+
+  /**
+   * 获取所有文章分类的分页路径
+   * 用于生成静态页面
+   * @returns 所有文章分类的分页路径
+   */
+  public async getCategoredPostListPaths() {
+    const langAbbr = this.ensureLangAbbr();
+    // 获取所有文章分类
+    const categoryTree = await this.getPostCategories();
+    const categories = this.flattenTree(categoryTree);
+
+    // 为每个分类生成路径
+    const paths = [];
+
+    // 如果没有分类，至少创建一个默认路径
+    if (!categories || categories.length === 0) {
+      paths.push({
+        params: { slug: "default", page: "1" },
+        props: {
+          currentPage: 1,
+          totalPages: 1,
+          pageSize: 10,
+          totalItems: 0,
+          slug: "default",
+        },
+      });
+      return paths;
+    }
+
+    for (const category of categories) {
+      // 跳过没有 slug 的分类
+      if (!category.slug) continue;
+
+      // 获取该分类下的分页路径
+      const categoryPaths = await this.getPostListPaths({
+        pageSize: 10,
+        category: category.slug,
+      });
+
+      // 如果该分类没有文章，至少创建一个第一页
+      if (categoryPaths.length === 0) {
+        paths.push({
+          params: { slug: String(category.slug), page: "1" },
+          props: {
+            currentPage: 1,
+            totalPages: 1,
+            pageSize: 10,
+            totalItems: 0,
+            slug: String(category.slug),
+          },
+        });
+        continue;
+      }
+
+      // 为每个分页路径添加分类 slug
+      for (const path of categoryPaths) {
+        paths.push({
+          params: { ...path.params, slug: String(category.slug) },
+          props: { ...path.props, slug: String(category.slug) },
+        });
+      }
+    }
+
+    return paths;
+  }
+
+  public async getProductBySlug(slug: string, imageSize: ImageSize | undefined) {
+    const langAbbr = this.ensureLangAbbr();
+    if (!imageSize) {
+      imageSize = this.imageSizes.product;
+    }
+    return await queryOneProductBySlug(slug, imageSize, this.envVariables, langAbbr);
+  }
+
+  public async getProductPaths() {
+    // 获取所有产品的 slug
+    const slugs = await this.getProductSlugs();
+
+    // 为每个 slug 创建路径
+    return slugs.map((slug) => ({
+      params: { slug },
+      props: { slug },
+    }));
+  }
+
+  /**
+   * 获取所有产品的 slug，用于生成静态页面
+   * 对于大量产品，这个方法会进行优化，只获取 slug 字段
+   */
+  public async getProductSlugs() {
+    const langAbbr = this.ensureLangAbbr();
+    // 只获取 slug 字段，减少数据传输量
+    const result = await queryAllProducts(this.envVariables, langAbbr);
+    return result?.items?.map((product) => product.slug) || [];
+  }
+
+  public async getProductIds() {
+    const langAbbr = this.ensureLangAbbr();
+    const result = await queryAllProducts(this.envVariables, langAbbr);
+    return result?.items?.map((product) => product.id) || [];
+  }
+
+  public async getProductCategories() {
+    const langAbbr = this.ensureLangAbbr();
+    return await queryProductCategories(this.envVariables, langAbbr);
+  }
+
+  public async getProductCategoryBySlug(slug: string) {
+    const langAbbr = this.ensureLangAbbr();
+    return await queryOneProductCategoryBySlug(slug, this.envVariables, langAbbr);
+  }
+
+  public async getOneUser(id: string) {
+    return await queryOneUser(id, this.envVariables);
+  }
+
+  public async getUserPosts(userId: string) {
+    const langAbbr = this.ensureLangAbbr();
+    return (await queryUserPosts({ userId }, this.envVariables, langAbbr))?.items;
+  }
+
+  public async fulltextSearch(keyword: string, imageSize: ImageSize | undefined) {
+    const langAbbr = this.ensureLangAbbr();
+    if (!imageSize) {
+      imageSize = this.imageSizes.postThumbnial;
+    }
+    return await fulltextSearch(keyword, imageSize, this.envVariables, langAbbr);
+  }
+
+  public async getUserPaths() {
+    const result = await queryUserIds(this.envVariables);
+    return (
+      result?.items?.map((user) => ({
+        params: { id: user.id },
+        props: { id: user.id },
+      })) || []
+    );
+  }
+
+  public createPagination(totalItems: number, pageSize: number) {
+    const totalPages = Math.max(1, Math.ceil(totalItems / pageSize));
+
+    // 为每个页面创建路径和获取对应的文章数据
+    const paths = [];
+
+    for (let i = 0; i < totalPages; i++) {
+      const currentPage = i + 1;
+
+      paths.push({
+        params: { page: String(currentPage) },
+        props: {
+          currentPage,
+          totalPages,
+          pageSize,
+          totalItems,
+        },
+      });
+    }
+
+    return paths;
+  }
+
+  public async createUploadCredentials(
+    options: UploadOptions
+  ): Promise<UploadSession | null> {
+    return await createUploadCredentials(options, this.envVariables);
+  }
+}