@fecommunity/reactpress-toolkit 3.0.4 → 3.7.0

package/dist/theme/preview/preview-mods.d.ts

@@ -0,0 +1,16 @@
+import type { ThemeMods } from '../extension/theme';
+/** Query key for draft customizer values in live preview iframe (`?reactpress_preview_mods=…`). */
+export declare const PREVIEW_MODS_QUERY_KEY = "reactpress_preview_mods";
+export declare function parsePreviewModsParam(raw: string | null | undefined): ThemeMods;
+/** Read draft mods from a request URL or path+query string. */
+export declare function parsePreviewModsFromRequestUrl(url: string | undefined): ThemeMods;
+export declare function appendPreviewModsToUrl(baseUrl: string, mods: ThemeMods): string;
+export declare function mergePreviewMods(base: ThemeMods, override: ThemeMods): ThemeMods;
+/** Next.js Pages `ctx.query` / `asPath` / `req.url` — used in `createThemeApp.getInitialProps`. */
+export declare function parsePreviewModsFromNextCtx(ctx: {
+    query?: Record<string, string | string[] | undefined>;
+    asPath?: string;
+    req?: {
+        url?: string;
+    };
+}): ThemeMods;

package/dist/theme/preview/preview-mods.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PREVIEW_MODS_QUERY_KEY = void 0;
+exports.parsePreviewModsParam = parsePreviewModsParam;
+exports.parsePreviewModsFromRequestUrl = parsePreviewModsFromRequestUrl;
+exports.appendPreviewModsToUrl = appendPreviewModsToUrl;
+exports.mergePreviewMods = mergePreviewMods;
+exports.parsePreviewModsFromNextCtx = parsePreviewModsFromNextCtx;
+/** Query key for draft customizer values in live preview iframe (`?reactpress_preview_mods=…`). */
+exports.PREVIEW_MODS_QUERY_KEY = 'reactpress_preview_mods';
+function parsePreviewModsParam(raw) {
+    if (!raw?.trim())
+        return {};
+    try {
+        const parsed = JSON.parse(decodeURIComponent(raw.trim()));
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+            return {};
+        const out = {};
+        for (const [key, value] of Object.entries(parsed)) {
+            if (value == null || value === '')
+                continue;
+            out[key] = String(value);
+        }
+        return out;
+    }
+    catch {
+        return {};
+    }
+}
+/** Read draft mods from a request URL or path+query string. */
+function parsePreviewModsFromRequestUrl(url) {
+    if (!url?.trim())
+        return {};
+    try {
+        const parsed = new URL(url, 'http://reactpress.local');
+        return parsePreviewModsParam(parsed.searchParams.get(exports.PREVIEW_MODS_QUERY_KEY));
+    }
+    catch {
+        return {};
+    }
+}
+function appendPreviewModsToUrl(baseUrl, mods) {
+    if (Object.keys(mods).length === 0)
+        return baseUrl;
+    try {
+        const url = baseUrl.includes('://')
+            ? new URL(baseUrl)
+            : new URL(baseUrl, 'http://localhost');
+        url.searchParams.set(exports.PREVIEW_MODS_QUERY_KEY, JSON.stringify(mods));
+        return url.toString();
+    }
+    catch {
+        return baseUrl;
+    }
+}
+function mergePreviewMods(base, override) {
+    if (!Object.keys(override).length)
+        return base;
+    return { ...base, ...override };
+}
+/** Next.js Pages `ctx.query` / `asPath` / `req.url` — used in `createThemeApp.getInitialProps`. */
+function parsePreviewModsFromNextCtx(ctx) {
+    const raw = ctx.query?.[exports.PREVIEW_MODS_QUERY_KEY];
+    if (typeof raw === 'string')
+        return parsePreviewModsParam(raw);
+    if (Array.isArray(raw) && typeof raw[0] === 'string')
+        return parsePreviewModsParam(raw[0]);
+    const asPath = typeof ctx.asPath === 'string' ? ctx.asPath : '';
+    if (asPath.includes('?')) {
+        return parsePreviewModsFromRequestUrl(`http://reactpress.local${asPath.startsWith('/') ? asPath : `/${asPath}`}`);
+    }
+    const reqUrl = ctx.req?.url;
+    if (reqUrl && String(reqUrl).includes('?')) {
+        const path = String(reqUrl).startsWith('/') ? reqUrl : `/${reqUrl}`;
+        return parsePreviewModsFromRequestUrl(`http://reactpress.local${path}`);
+    }
+    return {};
+}

package/dist/theme/preview-config.d.ts

@@ -0,0 +1,13 @@
+/** Query key for draft theme configuration in live preview (`?reactpress_preview_config=…`). */
+export declare const PREVIEW_CONFIG_QUERY_KEY = "reactpress_preview_config";
+export declare function parsePreviewConfigParam(raw: string | null | undefined): Record<string, unknown>;
+export declare function parsePreviewConfigFromRequestUrl(url: string | undefined): Record<string, unknown>;
+export declare function appendPreviewConfigToUrl(baseUrl: string, configuration: Record<string, unknown>): string;
+/** Next.js Pages `ctx.query` / `asPath` / `req.url`. */
+export declare function parsePreviewConfigFromNextCtx(ctx: {
+    query?: Record<string, string | string[] | undefined>;
+    asPath?: string;
+    req?: {
+        url?: string;
+    };
+}): Record<string, unknown>;

package/dist/theme/preview-config.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PREVIEW_CONFIG_QUERY_KEY = void 0;
+exports.parsePreviewConfigParam = parsePreviewConfigParam;
+exports.parsePreviewConfigFromRequestUrl = parsePreviewConfigFromRequestUrl;
+exports.appendPreviewConfigToUrl = appendPreviewConfigToUrl;
+exports.parsePreviewConfigFromNextCtx = parsePreviewConfigFromNextCtx;
+/** Query key for draft theme configuration in live preview (`?reactpress_preview_config=…`). */
+exports.PREVIEW_CONFIG_QUERY_KEY = 'reactpress_preview_config';
+function parsePreviewConfigParam(raw) {
+    if (!raw?.trim())
+        return {};
+    try {
+        const parsed = JSON.parse(decodeURIComponent(raw.trim()));
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+            return {};
+        return parsed;
+    }
+    catch {
+        return {};
+    }
+}
+function parsePreviewConfigFromRequestUrl(url) {
+    if (!url?.trim())
+        return {};
+    try {
+        const parsed = new URL(url, 'http://reactpress.local');
+        return parsePreviewConfigParam(parsed.searchParams.get(exports.PREVIEW_CONFIG_QUERY_KEY));
+    }
+    catch {
+        return {};
+    }
+}
+function appendPreviewConfigToUrl(baseUrl, configuration) {
+    if (!configuration || Object.keys(configuration).length === 0)
+        return baseUrl;
+    try {
+        const url = baseUrl.includes('://')
+            ? new URL(baseUrl)
+            : new URL(baseUrl, 'http://localhost');
+        url.searchParams.set(exports.PREVIEW_CONFIG_QUERY_KEY, JSON.stringify(configuration));
+        return url.toString();
+    }
+    catch {
+        return baseUrl;
+    }
+}
+/** Next.js Pages `ctx.query` / `asPath` / `req.url`. */
+function parsePreviewConfigFromNextCtx(ctx) {
+    const raw = ctx.query?.[exports.PREVIEW_CONFIG_QUERY_KEY];
+    if (typeof raw === 'string')
+        return parsePreviewConfigParam(raw);
+    if (Array.isArray(raw) && typeof raw[0] === 'string')
+        return parsePreviewConfigParam(raw[0]);
+    const asPath = typeof ctx.asPath === 'string' ? ctx.asPath : '';
+    if (asPath.includes('?')) {
+        return parsePreviewConfigFromRequestUrl(`http://reactpress.local${asPath.startsWith('/') ? asPath : `/${asPath}`}`);
+    }
+    const reqUrl = ctx.req?.url;
+    if (reqUrl && String(reqUrl).includes('?')) {
+        const path = String(reqUrl).startsWith('/') ? reqUrl : `/${reqUrl}`;
+        return parsePreviewConfigFromRequestUrl(`http://reactpress.local${path}`);
+    }
+    return {};
+}

package/dist/theme/preview-draft.d.ts

@@ -0,0 +1,19 @@
+import type { ThemeMods } from './extension/theme';
+/** Short-lived preview payload id (avoids 414 from huge query strings). */
+export declare const PREVIEW_TOKEN_QUERY_KEY = "reactpress_preview_token";
+export type PreviewDraftPayload = {
+    /** Theme whose `configuration` / mods apply (defaults to active theme when omitted). */
+    themeId?: string;
+    mods?: ThemeMods;
+    configuration?: Record<string, unknown>;
+};
+export declare function appendPreviewTokenToUrl(baseUrl: string, token: string): string;
+export declare function parsePreviewTokenFromRequestUrl(url: string | undefined): string;
+/** Next.js Pages `ctx.query` / `asPath` / `req.url`. */
+export declare function parsePreviewTokenFromNextCtx(ctx: {
+    query?: Record<string, string | string[] | undefined>;
+    asPath?: string;
+    req?: {
+        url?: string;
+    };
+}): string;

package/dist/theme/preview-draft.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PREVIEW_TOKEN_QUERY_KEY = void 0;
+exports.appendPreviewTokenToUrl = appendPreviewTokenToUrl;
+exports.parsePreviewTokenFromRequestUrl = parsePreviewTokenFromRequestUrl;
+exports.parsePreviewTokenFromNextCtx = parsePreviewTokenFromNextCtx;
+/** Short-lived preview payload id (avoids 414 from huge query strings). */
+exports.PREVIEW_TOKEN_QUERY_KEY = 'reactpress_preview_token';
+function appendPreviewTokenToUrl(baseUrl, token) {
+    if (!token.trim())
+        return baseUrl;
+    try {
+        const url = baseUrl.includes('://')
+            ? new URL(baseUrl)
+            : new URL(baseUrl, 'http://localhost');
+        url.searchParams.set(exports.PREVIEW_TOKEN_QUERY_KEY, token);
+        return url.toString();
+    }
+    catch {
+        return baseUrl;
+    }
+}
+function parsePreviewTokenFromRequestUrl(url) {
+    if (!url?.trim())
+        return '';
+    try {
+        const parsed = new URL(url, 'http://reactpress.local');
+        return parsed.searchParams.get(exports.PREVIEW_TOKEN_QUERY_KEY)?.trim() ?? '';
+    }
+    catch {
+        return '';
+    }
+}
+/** Next.js Pages `ctx.query` / `asPath` / `req.url`. */
+function parsePreviewTokenFromNextCtx(ctx) {
+    const raw = ctx.query?.[exports.PREVIEW_TOKEN_QUERY_KEY];
+    if (typeof raw === 'string')
+        return raw.trim();
+    if (Array.isArray(raw) && typeof raw[0] === 'string')
+        return raw[0].trim();
+    const asPath = typeof ctx.asPath === 'string' ? ctx.asPath : '';
+    if (asPath.includes('?')) {
+        return parsePreviewTokenFromRequestUrl(`http://reactpress.local${asPath.startsWith('/') ? asPath : `/${asPath}`}`);
+    }
+    const reqUrl = ctx.req?.url;
+    if (reqUrl && String(reqUrl).includes('?')) {
+        const path = String(reqUrl).startsWith('/') ? reqUrl : `/${reqUrl}`;
+        return parsePreviewTokenFromRequestUrl(`http://reactpress.local${path}`);
+    }
+    return '';
+}

package/dist/theme/preview-mods.d.ts

@@ -0,0 +1,16 @@
+import type { ThemeMods } from './extension/theme';
+/** Query key for draft customizer values in live preview iframe (`?reactpress_preview_mods=…`). */
+export declare const PREVIEW_MODS_QUERY_KEY = "reactpress_preview_mods";
+export declare function parsePreviewModsParam(raw: string | null | undefined): ThemeMods;
+/** Read draft mods from a request URL or path+query string. */
+export declare function parsePreviewModsFromRequestUrl(url: string | undefined): ThemeMods;
+export declare function appendPreviewModsToUrl(baseUrl: string, mods: ThemeMods): string;
+export declare function mergePreviewMods(base: ThemeMods, override: ThemeMods): ThemeMods;
+/** Next.js Pages `ctx.query` / `asPath` / `req.url` — used in `createThemeApp.getInitialProps`. */
+export declare function parsePreviewModsFromNextCtx(ctx: {
+    query?: Record<string, string | string[] | undefined>;
+    asPath?: string;
+    req?: {
+        url?: string;
+    };
+}): ThemeMods;

package/dist/theme/preview-mods.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PREVIEW_MODS_QUERY_KEY = void 0;
+exports.parsePreviewModsParam = parsePreviewModsParam;
+exports.parsePreviewModsFromRequestUrl = parsePreviewModsFromRequestUrl;
+exports.appendPreviewModsToUrl = appendPreviewModsToUrl;
+exports.mergePreviewMods = mergePreviewMods;
+exports.parsePreviewModsFromNextCtx = parsePreviewModsFromNextCtx;
+/** Query key for draft customizer values in live preview iframe (`?reactpress_preview_mods=…`). */
+exports.PREVIEW_MODS_QUERY_KEY = 'reactpress_preview_mods';
+function parsePreviewModsParam(raw) {
+    if (!raw?.trim())
+        return {};
+    try {
+        const parsed = JSON.parse(decodeURIComponent(raw.trim()));
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+            return {};
+        const out = {};
+        for (const [key, value] of Object.entries(parsed)) {
+            if (value == null || value === '')
+                continue;
+            out[key] = String(value);
+        }
+        return out;
+    }
+    catch {
+        return {};
+    }
+}
+/** Read draft mods from a request URL or path+query string. */
+function parsePreviewModsFromRequestUrl(url) {
+    if (!url?.trim())
+        return {};
+    try {
+        const parsed = new URL(url, 'http://reactpress.local');
+        return parsePreviewModsParam(parsed.searchParams.get(exports.PREVIEW_MODS_QUERY_KEY));
+    }
+    catch {
+        return {};
+    }
+}
+function appendPreviewModsToUrl(baseUrl, mods) {
+    if (Object.keys(mods).length === 0)
+        return baseUrl;
+    try {
+        const url = baseUrl.includes('://')
+            ? new URL(baseUrl)
+            : new URL(baseUrl, 'http://localhost');
+        url.searchParams.set(exports.PREVIEW_MODS_QUERY_KEY, JSON.stringify(mods));
+        return url.toString();
+    }
+    catch {
+        return baseUrl;
+    }
+}
+function mergePreviewMods(base, override) {
+    if (!Object.keys(override).length)
+        return base;
+    return { ...base, ...override };
+}
+/** Next.js Pages `ctx.query` / `asPath` / `req.url` — used in `createThemeApp.getInitialProps`. */
+function parsePreviewModsFromNextCtx(ctx) {
+    const raw = ctx.query?.[exports.PREVIEW_MODS_QUERY_KEY];
+    if (typeof raw === 'string')
+        return parsePreviewModsParam(raw);
+    if (Array.isArray(raw) && typeof raw[0] === 'string')
+        return parsePreviewModsParam(raw[0]);
+    const asPath = typeof ctx.asPath === 'string' ? ctx.asPath : '';
+    if (asPath.includes('?')) {
+        return parsePreviewModsFromRequestUrl(`http://reactpress.local${asPath.startsWith('/') ? asPath : `/${asPath}`}`);
+    }
+    const reqUrl = ctx.req?.url;
+    if (reqUrl && String(reqUrl).includes('?')) {
+        const path = String(reqUrl).startsWith('/') ? reqUrl : `/${reqUrl}`;
+        return parsePreviewModsFromRequestUrl(`http://reactpress.local${path}`);
+    }
+    return {};
+}

package/dist/theme/providers/index.d.ts

@@ -0,0 +1,118 @@
+import type { AxiosInstance } from 'axios';
+import type { IArticle, ICategory, IComment, IFile, IKnowledge, IPage, ISetting, ITag, IUser, IView } from '../../types';
+/** Create REST provider classes bound to a theme HTTP client (axios + envelope unwrap). */
+export declare function createThemeProviders(http: AxiosInstance): {
+    SettingProvider: {
+        new (): {};
+        getSetting(): Promise<ISetting>;
+        updateSetting(data: Partial<ISetting>): Promise<ISetting>;
+    };
+    ArticleProvider: {
+        new (): {};
+        getArticles(params: Record<string, unknown>): Promise<[IArticle[], number]>;
+        getAllRecommendArticles(): Promise<IArticle[]>;
+        getArticlesByCategory(category: string, params: Record<string, unknown>): Promise<[IArticle[], number]>;
+        getArticlesByTag(tag: string, params: Record<string, unknown>): Promise<[IArticle[], number]>;
+        getRecommend(articleId?: string | null, pageSize?: number): Promise<IArticle[]>;
+        getArchives(): Promise<Record<string, Record<string, IArticle[]>>>;
+        getArticle(id: string): Promise<IArticle>;
+        addArticle(data: Partial<IArticle>): Promise<IArticle>;
+        updateArticle(id: string, data: Partial<IArticle>): Promise<IArticle>;
+        updateArticleViews(id: string): Promise<IArticle>;
+        updateArticleLikes(id: string, type: string): Promise<IArticle>;
+        checkPassword(id: string, password: string): Promise<{
+            pass: boolean;
+        } & IArticle>;
+        deleteArticle(id: string): Promise<IArticle>;
+    };
+    CategoryProvider: {
+        new (): {};
+        getCategory(params?: Record<string, unknown>): Promise<ICategory[]>;
+        add(data: Partial<ICategory>): Promise<ICategory>;
+        getCategoryById(id: string): Promise<ICategory>;
+        update(id: string, data: Partial<ICategory>): Promise<ICategory>;
+        delete(id: string): Promise<ICategory>;
+    };
+    TagProvider: {
+        new (): {};
+        getTags(params?: Record<string, unknown>): Promise<ITag[]>;
+        getTagWithArticles(id: string, needFilter?: boolean): Promise<ITag>;
+        addTag(data: Partial<ITag>): Promise<ITag>;
+        getTagById(id: string): Promise<ITag>;
+        updateTag(id: string, data: Partial<ITag>): Promise<ITag>;
+        deleteTag(id: string): Promise<ITag>;
+    };
+    PageProvider: {
+        new (): {};
+        getPages(params: Record<string, unknown>): Promise<[IPage[], number]>;
+        getAllPublisedPages(): Promise<[IPage[], number]>;
+        getPage(id: string): Promise<IPage>;
+        addPage(data: Partial<IPage>): Promise<IPage>;
+        updatePage(id: string, data: Partial<IPage>): Promise<IPage>;
+        updatePageViews(id: string): Promise<IPage>;
+        deletePage(id: string): Promise<IPage>;
+    };
+    CommentProvider: {
+        new (): {};
+        getComments(params: Record<string, unknown>): Promise<[IComment[], number]>;
+        getComment(id: string): Promise<IComment>;
+        getArticleComments(hostId: string, params: Record<string, unknown>): Promise<[IComment[], number]>;
+        addComment(data: Partial<IComment>): Promise<IComment>;
+        updateComment(id: string, data: Partial<IComment>): Promise<IComment>;
+        deleteComment(id: string): Promise<IComment>;
+    };
+    UserProvider: {
+        new (): {};
+        login(data: Record<string, unknown>): Promise<IUser>;
+        loginWithGithub(code: string): Promise<IUser>;
+        register(data: Record<string, unknown>): Promise<IUser>;
+        getUsers(params: Record<string, unknown>): Promise<[IUser[], number]>;
+        update(data: Record<string, unknown>): Promise<IUser>;
+        updatePassword(data: Record<string, unknown>): Promise<IUser>;
+    };
+    KnowledgeProvider: {
+        new (): {};
+        createBook(data: Partial<IKnowledge>): Promise<IKnowledge>;
+        createChapters(data: Partial<IKnowledge>[]): Promise<IKnowledge[]>;
+        deleteKnowledge(id: string): Promise<IKnowledge>;
+        updateKnowledge(id: string, data: Partial<IKnowledge>): Promise<IKnowledge>;
+        getKnowledges(params?: Record<string, unknown>): Promise<[IKnowledge[], number]>;
+        getKnowledge(id: string): Promise<IKnowledge>;
+        updateKnowledgeViews(id: string): Promise<IKnowledge>;
+        updateKnowledgeLikes(id: string, type: string): Promise<IKnowledge>;
+    };
+    SearchProvider: {
+        new (): {};
+        searchArticles(keyword: string): Promise<IArticle[]>;
+    };
+    FileProvider: {
+        new (): {};
+        uploadFile(file: FormData, unique?: number): Promise<IFile>;
+        getFiles(params: Record<string, unknown>): Promise<[IFile[], number]>;
+        deleteFile(id: string): Promise<IFile>;
+    };
+    ViewProvider: {
+        new (): {};
+        getViews(params: Record<string, unknown>): Promise<[IView[], number]>;
+        addView(data: Record<string, unknown>): Promise<IView>;
+        getViewsByUrl(url: string): Promise<IView[]>;
+        deleteView(id: string): Promise<IView>;
+    };
+    MailProvider: {
+        new (): {};
+        getMails(params: Record<string, unknown>): Promise<[Record<string, unknown>[], number]>;
+        deleteMail(id: string): Promise<Record<string, unknown>>;
+    };
+    SmtpProvider: {
+        new (): {};
+        testSendMail(user: Record<string, unknown>): Promise<IFile>;
+    };
+    PosterProvider: {
+        new (): {};
+        createPoster(data: Record<string, unknown>): Promise<{
+            name: string;
+            url: string;
+        }>;
+    };
+};
+export type ThemeProviders = ReturnType<typeof createThemeProviders>;