@fecommunity/reactpress-toolkit 3.0.4 → 3.7.0

package/dist/react/client.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiError = void 0;
+exports.createClient = createClient;
+exports.getDefaultApiBaseUrl = getDefaultApiBaseUrl;
+const instance_1 = require("../api/instance");
+class ApiError extends Error {
+    constructor(code, message) {
+        super(message);
+        this.name = 'ApiError';
+        this.code = code;
+    }
+}
+exports.ApiError = ApiError;
+function readApiMessage(value) {
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        return trimmed ? trimmed : null;
+    }
+    if (Array.isArray(value)) {
+        const parts = value
+            .map((item) => readApiMessage(item))
+            .filter((item) => Boolean(item));
+        return parts.length ? parts.join(', ') : null;
+    }
+    if (value && typeof value === 'object') {
+        const payload = value;
+        return readApiMessage(payload.message) ?? readApiMessage(payload.msg);
+    }
+    return null;
+}
+function rejectApiError(status, payload) {
+    if (typeof payload.code === 'number' && payload.code !== 0) {
+        return Promise.reject(new ApiError(payload.code, readApiMessage(payload.message) ?? 'Request failed'));
+    }
+    const message = readApiMessage(payload.msg) ?? readApiMessage(payload.message);
+    if (message) {
+        return Promise.reject(new ApiError(Number(payload.statusCode ?? status ?? 500), message));
+    }
+    return null;
+}
+function attachInterceptors(http, options) {
+    http.instance.interceptors.request.use((config) => {
+        const token = options.getAccessToken?.();
+        if (token && config.headers) {
+            config.headers.Authorization = `Bearer ${token}`;
+        }
+        return config;
+    });
+    http.instance.interceptors.response.use((response) => {
+        const body = response.data;
+        if (!body || typeof body !== 'object')
+            return response;
+        if (typeof body.code === 'number') {
+            if (body.code !== 0) {
+                throw new ApiError(body.code, readApiMessage(body.message) ?? 'Request failed');
+            }
+            response.data = body.data;
+            return response;
+        }
+        if (typeof body.success === 'boolean') {
+            if (!body.success) {
+                throw new ApiError(Number(body.statusCode ?? 500), readApiMessage(body.msg) ?? 'Request failed');
+            }
+            response.data = body.data;
+            return response;
+        }
+        return response;
+    }, (error) => {
+        const status = error?.response?.status;
+        if (status === 401) {
+            options.onUnauthorized?.();
+        }
+        const body = error?.response?.data;
+        if (body && typeof body === 'object') {
+            const rejected = rejectApiError(status, body);
+            if (rejected)
+                return rejected;
+        }
+        return Promise.reject(error);
+    });
+}
+/** Single factory for web / theme / plugins — wraps generated API modules. */
+function createClient(options = {}) {
+    const baseURL = options.baseURL ?? 'http://localhost:3002/api';
+    const client = (0, instance_1.createApiInstance)({ baseURL });
+    attachInterceptors(client.article.http, options);
+    return client;
+}
+function getDefaultApiBaseUrl() {
+    if (typeof process !== 'undefined' && process.env?.SERVER_API_URL) {
+        return process.env.SERVER_API_URL;
+    }
+    return 'http://localhost:3002/api';
+}

package/dist/react/index.d.ts

@@ -0,0 +1,4 @@
+export type { ClientOptions, ReactPressClient } from './client';
+export { ApiError, createClient, getDefaultApiBaseUrl } from './client';
+export type { AppRuntime, DesktopApi } from './runtime';
+export { getDesktopApi, getRuntime, resolveApiBaseUrl, } from './runtime';

package/dist/react/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveApiBaseUrl = exports.getRuntime = exports.getDesktopApi = exports.getDefaultApiBaseUrl = exports.createClient = exports.ApiError = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "ApiError", { enumerable: true, get: function () { return client_1.ApiError; } });
+Object.defineProperty(exports, "createClient", { enumerable: true, get: function () { return client_1.createClient; } });
+Object.defineProperty(exports, "getDefaultApiBaseUrl", { enumerable: true, get: function () { return client_1.getDefaultApiBaseUrl; } });
+var runtime_1 = require("./runtime");
+Object.defineProperty(exports, "getDesktopApi", { enumerable: true, get: function () { return runtime_1.getDesktopApi; } });
+Object.defineProperty(exports, "getRuntime", { enumerable: true, get: function () { return runtime_1.getRuntime; } });
+Object.defineProperty(exports, "resolveApiBaseUrl", { enumerable: true, get: function () { return runtime_1.resolveApiBaseUrl; } });

package/dist/react/runtime.d.ts

@@ -0,0 +1,18 @@
+export type AppRuntime = 'web' | 'electron';
+export interface DesktopApi {
+    getApiBaseUrl: () => Promise<string>;
+    setApiBaseUrl: (url: string) => Promise<void>;
+    showSaveDialog: (opts: {
+        defaultPath?: string;
+    }) => Promise<string | undefined>;
+    openExternal: (url: string) => Promise<void>;
+    platform: NodeJS.Platform;
+}
+declare global {
+    interface Window {
+        reactpressDesktop?: DesktopApi;
+    }
+}
+export declare function getRuntime(): AppRuntime;
+export declare function getDesktopApi(): DesktopApi | undefined;
+export declare function resolveApiBaseUrl(fallback: string): Promise<string>;

package/dist/react/runtime.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRuntime = getRuntime;
+exports.getDesktopApi = getDesktopApi;
+exports.resolveApiBaseUrl = resolveApiBaseUrl;
+function getRuntime() {
+    if (typeof window !== 'undefined' && window.reactpressDesktop) {
+        return 'electron';
+    }
+    return 'web';
+}
+function getDesktopApi() {
+    if (typeof window === 'undefined')
+        return undefined;
+    return window.reactpressDesktop;
+}
+async function resolveApiBaseUrl(fallback) {
+    const desktop = getDesktopApi();
+    if (desktop) {
+        try {
+            const url = await desktop.getApiBaseUrl();
+            if (url)
+                return url;
+        }
+        catch {
+            // fall through
+        }
+    }
+    return fallback;
+}

package/dist/theme/antdDocument.d.ts

@@ -0,0 +1,18 @@
+import type { DocumentContext } from 'next/document';
+import type { IncomingMessage } from 'http';
+export type CreateAntdThemeDocumentOptions = {
+    resolveLocale?: (req?: IncomingMessage) => string;
+    colorModeScript?: string | false;
+    defaultLocale?: string;
+};
+export declare function createAntdThemeDocument(options?: CreateAntdThemeDocumentOptions): {
+    ({ locale }: {
+        locale?: string;
+    }): import("react/jsx-runtime").JSX.Element;
+    getInitialProps(ctx: DocumentContext): Promise<{
+        locale: string;
+        styles: import("react/jsx-runtime").JSX.Element;
+        html: string;
+        head?: Array<JSX.Element | null>;
+    }>;
+};

package/dist/theme/antdDocument.js

@@ -0,0 +1,59 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAntdThemeDocument = createAntdThemeDocument;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const cssinjs_1 = require("@ant-design/cssinjs");
+const document_1 = __importStar(require("next/document"));
+const colorMode_1 = require("./colorMode");
+function createAntdThemeDocument(options = {}) {
+    const { resolveLocale, colorModeScript = colorMode_1.colorModeInitScript, defaultLocale = 'zh', } = options;
+    const ThemeDocument = ({ locale }) => ((0, jsx_runtime_1.jsxs)(document_1.Html, { lang: locale || defaultLocale, suppressHydrationWarning: true, children: [(0, jsx_runtime_1.jsx)(document_1.Head, {}), (0, jsx_runtime_1.jsxs)("body", { suppressHydrationWarning: true, children: [colorModeScript ? ((0, jsx_runtime_1.jsx)("script", { dangerouslySetInnerHTML: { __html: colorModeScript } })) : null, (0, jsx_runtime_1.jsx)(document_1.Main, {}), (0, jsx_runtime_1.jsx)(document_1.NextScript, {})] })] }));
+    ThemeDocument.getInitialProps = async (ctx) => {
+        const cache = (0, cssinjs_1.createCache)();
+        const originalRenderPage = ctx.renderPage;
+        ctx.renderPage = () => originalRenderPage({
+            enhanceApp: (App) => (props) => ((0, jsx_runtime_1.jsx)(cssinjs_1.StyleProvider, { cache: cache, children: (0, jsx_runtime_1.jsx)(App, { ...props }) })),
+        });
+        const initialProps = await document_1.default.getInitialProps(ctx);
+        const style = (0, cssinjs_1.extractStyle)(cache, true);
+        return {
+            ...initialProps,
+            locale: resolveLocale?.(ctx.req) ?? defaultLocale,
+            styles: ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [initialProps.styles, (0, jsx_runtime_1.jsx)("style", { dangerouslySetInnerHTML: { __html: style } })] })),
+        };
+    };
+    return ThemeDocument;
+}

package/dist/theme/api/api-data.d.ts

@@ -0,0 +1,2 @@
+export type { ApiEnvelope } from '../../utils/api-envelope';
+export { unpackList, unpackOne, unpackPaginated, unpackPaginatedPair } from '../../utils/api-envelope';

package/dist/theme/api/api-data.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unpackPaginatedPair = exports.unpackPaginated = exports.unpackOne = exports.unpackList = void 0;
+var api_envelope_1 = require("../../utils/api-envelope");
+Object.defineProperty(exports, "unpackList", { enumerable: true, get: function () { return api_envelope_1.unpackList; } });
+Object.defineProperty(exports, "unpackOne", { enumerable: true, get: function () { return api_envelope_1.unpackOne; } });
+Object.defineProperty(exports, "unpackPaginated", { enumerable: true, get: function () { return api_envelope_1.unpackPaginated; } });
+Object.defineProperty(exports, "unpackPaginatedPair", { enumerable: true, get: function () { return api_envelope_1.unpackPaginatedPair; } });

package/dist/theme/api/api.d.ts

@@ -0,0 +1,28 @@
+import { createApiInstance } from '../../api/instance';
+export type ThemeApi = ReturnType<typeof createApiInstance>;
+/**
+ * Base URL for theme API calls.
+ * SSR uses REACTPRESS_API_URL (direct :3002); browser uses NEXT_PUBLIC_* (often nginx /api).
+ */
+export declare function resolveThemeApiBaseUrl(): string;
+/** Create a theme-scoped API client (override baseURL for tests or multi-tenant). */
+export declare function createThemeApi(config?: {
+    baseURL?: string;
+}): ThemeApi;
+/** Default theme API client — same env contract as `reactpress theme dev`. */
+export declare const themeApi: {
+    article: import("../../api/Article").Article<unknown>;
+    auth: import("../../api/Auth").Auth<unknown>;
+    category: import("../../api/Category").Category<unknown>;
+    comment: import("../../api/Comment").Comment<unknown>;
+    file: import("../../api/File").File<unknown>;
+    knowledge: import("../../api/Knowledge").Knowledge<unknown>;
+    page: import("../../api/Page").Page<unknown>;
+    search: import("../../api/Search").Search<unknown>;
+    setting: import("../../api/Setting").Setting<unknown>;
+    smtp: import("../../api/Smtp").Smtp<unknown>;
+    tag: import("../../api/Tag").Tag<unknown>;
+    user: import("../../api/User").User<unknown>;
+    view: import("../../api/View").View<unknown>;
+};
+export declare function getThemeApiBaseUrl(): string;

package/dist/theme/api/api.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.themeApi = void 0;
+exports.resolveThemeApiBaseUrl = resolveThemeApiBaseUrl;
+exports.createThemeApi = createThemeApi;
+exports.getThemeApiBaseUrl = getThemeApiBaseUrl;
+const instance_1 = require("../../api/instance");
+/**
+ * Base URL for theme API calls.
+ * SSR uses REACTPRESS_API_URL (direct :3002); browser uses NEXT_PUBLIC_* (often nginx /api).
+ */
+function resolveThemeApiBaseUrl() {
+    const serverBaseURL = process.env.REACTPRESS_API_URL || 'http://localhost:3002/api';
+    const browserBaseURL = process.env.NEXT_PUBLIC_REACTPRESS_API_URL || serverBaseURL;
+    return typeof window === 'undefined' ? serverBaseURL : browserBaseURL;
+}
+/** Create a theme-scoped API client (override baseURL for tests or multi-tenant). */
+function createThemeApi(config) {
+    return (0, instance_1.createApiInstance)({
+        baseURL: config?.baseURL ?? resolveThemeApiBaseUrl(),
+    });
+}
+/** Default theme API client — same env contract as `reactpress theme dev`. */
+exports.themeApi = createThemeApi();
+function getThemeApiBaseUrl() {
+    return resolveThemeApiBaseUrl();
+}

package/dist/theme/api/httpClient.d.ts

@@ -0,0 +1,24 @@
+import { type AxiosInstance } from 'axios';
+export interface ThemeApiEnvelope<T = unknown> {
+    statusCode: number;
+    success: boolean;
+    msg: string | null;
+    data: T;
+}
+export interface CreateThemeAxiosClientOptions {
+    baseURL?: string;
+    timeout?: number;
+    getAccessToken?: () => string | null;
+    onError?: (message: string, status?: number) => void;
+    onUnauthorized?: () => void;
+    unwrapEnvelope?: boolean;
+}
+/**
+ * Theme axios base URL (SSR + client).
+ * Do not read `process.env.SERVER_API_URL` here — Next inlines it from next.config at compile time
+ * and stale values (e.g. localhost:3002) break `--remote-origin` dev.
+ */
+export declare function resolveThemeAxiosBaseUrl(): string;
+/** Encode dynamic path segments (e.g. Chinese tag names) for Node fetch / axios. */
+export declare function encodeAxiosUrlPath(url: string): string;
+export declare function createThemeAxiosClient(options?: CreateThemeAxiosClientOptions): AxiosInstance;

package/dist/theme/api/httpClient.js

@@ -0,0 +1,83 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveThemeAxiosBaseUrl = resolveThemeAxiosBaseUrl;
+exports.encodeAxiosUrlPath = encodeAxiosUrlPath;
+exports.createThemeAxiosClient = createThemeAxiosClient;
+const axios_1 = __importDefault(require("axios"));
+const authSession_1 = require("../visitor/authSession");
+const api_1 = require("./api");
+/**
+ * Theme axios base URL (SSR + client).
+ * Do not read `process.env.SERVER_API_URL` here — Next inlines it from next.config at compile time
+ * and stale values (e.g. localhost:3002) break `--remote-origin` dev.
+ */
+function resolveThemeAxiosBaseUrl() {
+    return (0, api_1.resolveThemeApiBaseUrl)();
+}
+/** Encode dynamic path segments (e.g. Chinese tag names) for Node fetch / axios. */
+function encodeAxiosUrlPath(url) {
+    const qIndex = url.indexOf('?');
+    const pathname = qIndex === -1 ? url : url.slice(0, qIndex);
+    const search = qIndex === -1 ? '' : url.slice(qIndex);
+    const encodedPath = pathname
+        .split('/')
+        .map((segment) => {
+        if (!segment)
+            return segment;
+        try {
+            return encodeURIComponent(decodeURIComponent(segment));
+        }
+        catch {
+            return encodeURIComponent(segment);
+        }
+    })
+        .join('/');
+    return encodedPath + search;
+}
+function createThemeAxiosClient(options = {}) {
+    const isBrowser = typeof window !== 'undefined';
+    const { baseURL = resolveThemeAxiosBaseUrl(), timeout = 60000, getAccessToken = authSession_1.getStoredAccessToken, onError, onUnauthorized, unwrapEnvelope = true, } = options;
+    const client = axios_1.default.create({ baseURL, timeout });
+    client.interceptors.request.use((config) => {
+        if (config.url) {
+            config.url = encodeAxiosUrlPath(config.url);
+        }
+        if (isBrowser) {
+            const token = getAccessToken();
+            if (config.headers && token) {
+                config.headers.Authorization = `Bearer ${token}`;
+            }
+        }
+        return config;
+    }, () => {
+        throw new Error('Failed to send request');
+    });
+    client.interceptors.response.use((response) => {
+        if (!unwrapEnvelope) {
+            return response;
+        }
+        const payload = response.data;
+        if (!payload?.success) {
+            onError?.(payload?.msg || 'Request failed');
+            const message = payload?.msg || `Request failed (${payload?.statusCode ?? 'unknown'})`;
+            return Promise.reject(new Error(message));
+        }
+        return payload.data;
+    }, (err) => {
+        const status = err?.response?.status;
+        const msg = err?.response?.data?.msg;
+        if (status === 401) {
+            onUnauthorized?.();
+            onError?.(msg || 'Unauthorized');
+        }
+        else if (status) {
+            onError?.(msg || 'Server error', status);
+        }
+        const message = msg || err?.message || `HTTP ${status ?? 'error'}`;
+        return Promise.reject(new Error(message));
+    });
+    return client;
+}

package/dist/theme/api/json.d.ts

@@ -0,0 +1 @@
+export { safeJsonParse } from '../../utils/json';

package/dist/theme/api/json.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safeJsonParse = void 0;
+var json_1 = require("../../utils/json");
+Object.defineProperty(exports, "safeJsonParse", { enumerable: true, get: function () { return json_1.safeJsonParse; } });

package/dist/theme/api/jsonp.d.ts

@@ -0,0 +1 @@
+export { jsonp } from '../../utils/jsonp';

package/dist/theme/api/jsonp.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonp = void 0;
+var jsonp_1 = require("../../utils/jsonp");
+Object.defineProperty(exports, "jsonp", { enumerable: true, get: function () { return jsonp_1.jsonp; } });

package/dist/theme/api-data.d.ts

@@ -0,0 +1,12 @@
+/** Nest TransformInterceptor body (axios already returns this as `response.data`). */
+export interface ApiEnvelope<T = unknown> {
+    statusCode?: number;
+    msg?: string | null;
+    success?: boolean;
+    data?: T;
+}
+/** Paginated endpoints: `data` is `[items, total]`. */
+export declare function unpackPaginated<T>(res: ApiEnvelope<[T[], number]> | null | undefined): T[];
+/** List or single entity wrapped in `data`. */
+export declare function unpackList<T>(res: ApiEnvelope<T[]> | null | undefined): T[];
+export declare function unpackOne<T>(res: ApiEnvelope<T> | null | undefined): T | null;

package/dist/theme/api-data.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unpackPaginated = unpackPaginated;
+exports.unpackList = unpackList;
+exports.unpackOne = unpackOne;
+/** Paginated endpoints: `data` is `[items, total]`. */
+function unpackPaginated(res) {
+    const payload = res?.data;
+    if (Array.isArray(payload) && Array.isArray(payload[0])) {
+        return payload[0];
+    }
+    return [];
+}
+/** List or single entity wrapped in `data`. */
+function unpackList(res) {
+    const data = res?.data;
+    return Array.isArray(data) ? data : [];
+}
+function unpackOne(res) {
+    const data = res?.data;
+    return data != null ? data : null;
+}

package/dist/theme/api.d.ts

@@ -0,0 +1,28 @@
+import { createApiInstance } from '../api/instance';
+export type ThemeApi = ReturnType<typeof createApiInstance>;
+/**
+ * Base URL for theme API calls.
+ * SSR uses REACTPRESS_API_URL (direct :3002); browser uses NEXT_PUBLIC_* (often nginx /api).
+ */
+export declare function resolveThemeApiBaseUrl(): string;
+/** Create a theme-scoped API client (override baseURL for tests or multi-tenant). */
+export declare function createThemeApi(config?: {
+    baseURL?: string;
+}): ThemeApi;
+/** Default theme API client — same env contract as `reactpress theme dev`. */
+export declare const themeApi: {
+    article: import("../api/Article").Article<unknown>;
+    auth: import("../api/Auth").Auth<unknown>;
+    category: import("../api/Category").Category<unknown>;
+    comment: import("../api/Comment").Comment<unknown>;
+    file: import("../api/File").File<unknown>;
+    knowledge: import("../api/Knowledge").Knowledge<unknown>;
+    page: import("../api/Page").Page<unknown>;
+    search: import("../api/Search").Search<unknown>;
+    setting: import("../api/Setting").Setting<unknown>;
+    smtp: import("../api/Smtp").Smtp<unknown>;
+    tag: import("../api/Tag").Tag<unknown>;
+    user: import("../api/User").User<unknown>;
+    view: import("../api/View").View<unknown>;
+};
+export declare function getThemeApiBaseUrl(): string;

package/dist/theme/api.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.themeApi = void 0;
+exports.resolveThemeApiBaseUrl = resolveThemeApiBaseUrl;
+exports.createThemeApi = createThemeApi;
+exports.getThemeApiBaseUrl = getThemeApiBaseUrl;
+const instance_1 = require("../api/instance");
+/**
+ * Base URL for theme API calls.
+ * SSR uses REACTPRESS_API_URL (direct :3002); browser uses NEXT_PUBLIC_* (often nginx /api).
+ */
+function resolveThemeApiBaseUrl() {
+    const serverBaseURL = process.env.REACTPRESS_API_URL || 'http://localhost:3002/api';
+    const browserBaseURL = process.env.NEXT_PUBLIC_REACTPRESS_API_URL || serverBaseURL;
+    return typeof window === 'undefined' ? serverBaseURL : browserBaseURL;
+}
+/** Create a theme-scoped API client (override baseURL for tests or multi-tenant). */
+function createThemeApi(config) {
+    return (0, instance_1.createApiInstance)({
+        baseURL: config?.baseURL ?? resolveThemeApiBaseUrl(),
+    });
+}
+/** Default theme API client — same env contract as `reactpress theme dev`. */
+exports.themeApi = createThemeApi();
+function getThemeApiBaseUrl() {
+    return resolveThemeApiBaseUrl();
+}

package/dist/theme/appearance.d.ts

@@ -0,0 +1,4 @@
+import type { ThemeManifest } from './extension/theme';
+import type { ThemeMods } from './extension/theme';
+/** Build default theme_mod values from `theme.json` → `appearance.sections`. */
+export declare function defaultModsFromManifest(manifest: ThemeManifest | null | undefined): ThemeMods;

package/dist/theme/appearance.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultModsFromManifest = defaultModsFromManifest;
+/** Build default theme_mod values from `theme.json` → `appearance.sections`. */
+function defaultModsFromManifest(manifest) {
+    const mods = {};
+    const sections = manifest?.appearance?.sections ?? [];
+    for (const section of sections) {
+        for (const setting of section.settings ?? []) {
+            if (setting.id && setting.default != null) {
+                mods[setting.id] = String(setting.default);
+            }
+        }
+    }
+    return mods;
+}

package/dist/theme/assets.d.ts

@@ -0,0 +1,2 @@
+/** Resolve media / logo URLs for theme pages (relative `/api/...` → public API origin). */
+export declare function resolvePublicAssetUrl(url: string | undefined | null): string;

package/dist/theme/assets.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePublicAssetUrl = resolvePublicAssetUrl;
+const api_1 = require("./api");
+/** Resolve media / logo URLs for theme pages (relative `/api/...` → public API origin). */
+function resolvePublicAssetUrl(url) {
+    const trimmed = (url ?? '').trim();
+    if (!trimmed)
+        return '';
+    if (/^https?:\/\//i.test(trimmed) || trimmed.startsWith('data:'))
+        return trimmed;
+    if (trimmed.startsWith('//')) {
+        const protocol = typeof window !== 'undefined' ? window.location.protocol : 'http:';
+        return `${protocol}${trimmed}`;
+    }
+    const apiBase = (0, api_1.resolveThemeApiBaseUrl)().replace(/\/$/, '');
+    const siteOrigin = typeof window !== 'undefined'
+        ? window.location.origin
+        : apiBase.replace(/\/api\/?$/, '');
+    if (trimmed.startsWith('/api/')) {
+        return `${siteOrigin}${trimmed}`;
+    }
+    if (trimmed.startsWith('/')) {
+        return `${siteOrigin}${trimmed}`;
+    }
+    return trimmed;
+}

package/dist/theme/authSession.d.ts

@@ -0,0 +1,16 @@
+/** Zustand persist key used by the ReactPress admin (`web/src/stores/auth.ts`). */
+export declare const ADMIN_AUTH_STORAGE_KEY = "auth-storage";
+export declare const THEME_TOKEN_STORAGE_KEY = "token";
+export declare const THEME_USER_STORAGE_KEY = "user";
+export interface ThemeSessionUser {
+    name: string;
+    email: string;
+    avatar?: string;
+    token: string;
+    role?: string;
+}
+export declare function getStoredAccessToken(): string | null;
+/** Resolve theme user from theme storage, or fall back to admin `auth-storage`. */
+export declare function resolveStoredUser(): ThemeSessionUser | null;
+export declare function persistThemeSession(user: ThemeSessionUser): void;
+export declare function clearThemeSession(): void;