@fecommunity/reactpress-server 3.0.4 → 4.0.0-beta.0

package/dist/modules/extension/theme.service.d.ts

@@ -0,0 +1,140 @@
+import type { SiteThemeState, ThemeAdminLocaleMessages, ThemeConfigurationSchema, ThemeManifest, ThemeMods } from '@fecommunity/reactpress-toolkit/theme';
+import { Repository } from 'typeorm';
+import { SettingService } from '../setting/setting.service';
+import { Setting } from '../setting/setting.entity';
+import { type ThemeRegistryCatalogEntry } from './theme-registry.bridge';
+export interface ThemeNpmLockMeta {
+    spec: string;
+    resolvedVersion?: string;
+    packageName?: string;
+    installedAt?: string;
+}
+export interface ThemeCatalogEntry extends ThemeRegistryCatalogEntry {
+}
+export interface ThemeListItem extends ThemeManifest {
+    source: 'local' | 'npm' | 'installed';
+    installed: boolean;
+    active: boolean;
+    official?: boolean;
+    coverUrl?: string;
+    npm?: ThemeNpmLockMeta;
+    catalog?: Pick<ThemeCatalogEntry, 'dependency' | 'npm' | 'featured' | 'themeUri' | 'previewUrl'>;
+}
+export type ThemePreviewSessionResult = SiteThemeState & {
+    siteUrl: string;
+    previewSiteUrl?: string;
+};
+export declare class ThemeService {
+    private readonly settingRepository;
+    private readonly settingService;
+    private static readonly COPY_SKIP_NAMES;
+    constructor(settingRepository: Repository<Setting>, settingService: SettingService);
+    private themesRoot;
+    private templatesDir;
+    private runtimeDir;
+    private ensureSiteRuntimeLink;
+    private legacyStarterDirs;
+    private legacyBundledDir;
+    private applyTemplateAppearanceSchema;
+    private readManifest;
+    private readNpmThemeLock;
+    private readThemeCatalogFile;
+    getThemeCatalog(): ThemeCatalogEntry[];
+    private findCatalogEntry;
+    private getThemeManifestFromSources;
+    private ensureThemeMaterialized;
+    private listDirThemes;
+    private getSettingRow;
+    private parseGlobalSetting;
+    getThemeState(): Promise<SiteThemeState>;
+    private saveThemeState;
+    private listLocalThemes;
+    private listBundledThemes;
+    private isRegistryLocalTheme;
+    private hasOfficialTag;
+    private resolveThemeOfficial;
+    private catalogMetaFromEntry;
+    listThemes(): Promise<ThemeListItem[]>;
+    getTheme(id: string): Promise<ThemeListItem>;
+    getThemeAdminLocale(themeId: string, locale: string): Promise<{
+        themeId: string;
+        locale: string;
+        messages: ThemeAdminLocaleMessages;
+    }>;
+    private themeLocaleSearchDirs;
+    private getThemeManifestForConfig;
+    getThemeConfigurationSchema(themeId: string): Promise<{
+        themeId: string;
+        schema: ThemeConfigurationSchema | null;
+    }>;
+    getThemeConfiguration(themeId: string): Promise<{
+        themeId: string;
+        configuration: Record<string, unknown>;
+    }>;
+    updateThemeConfiguration(themeId: string, patch: Record<string, unknown>, options?: {
+        replace?: boolean;
+        locale?: string;
+    }): Promise<{
+        themeId: string;
+        configuration: Record<string, unknown>;
+    }>;
+    private isValidThemeId;
+    private isUnderDir;
+    private isSafeThemeDirRel;
+    private resolveThemeDir;
+    installTheme(id: string): Promise<SiteThemeState>;
+    installThemeFromNpm(spec: string, options?: {
+        skipDependencies?: boolean;
+    }): Promise<SiteThemeState & {
+        themeId: string;
+        npmSpec: string;
+    }>;
+    private writeThemeDevManifest;
+    private syncActiveThemeManifest;
+    private ensureRuntimeThemeTsconfigBase;
+    private scheduleProductionClientRestart;
+    private syncPreviewThemeManifest;
+    private clearPreviewThemeManifest;
+    private readLocalDevActiveThemeId;
+    private readPreviewPoolManifest;
+    private writePreviewPoolEntry;
+    private reservePreviewPortForTheme;
+    private resolvePreviewSiteUrl;
+    activateTheme(id: string): Promise<SiteThemeState & {
+        siteUrl?: string;
+    }>;
+    getActiveThemePublic(): Promise<{
+        activeTheme: string;
+        themeDir: string | null;
+        siteUrl: string;
+    }>;
+    updateThemeMods(themeId: string, mods: ThemeMods): Promise<SiteThemeState>;
+    beginPreviewSession(themeId: string): Promise<ThemePreviewSessionResult>;
+    endPreviewSession(): Promise<SiteThemeState & {
+        siteUrl: string;
+    }>;
+    getCoverPath(id: string): string | null;
+    private themeAppearanceDefaults;
+    buildPlaceholderCoverSvg(id: string): string;
+    private resolveSiteUrlFromRow;
+    buildPreviewHtml(themeId: string, mods?: ThemeMods): string;
+    getPreviewMods(themeId: string, overrideMods?: ThemeMods): Promise<ThemeMods>;
+    createPreviewDraft(payload: {
+        themeId?: string;
+        mods?: ThemeMods;
+        configuration?: Record<string, unknown>;
+    }): {
+        token: string;
+    };
+    resolvePreviewDraft(token: string): {
+        themeId?: string;
+        mods?: ThemeMods;
+        configuration?: Record<string, unknown>;
+    } | null;
+    private resolveFallbackActiveTheme;
+    ensureDefaultTheme(): Promise<void>;
+    private materializeRuntimeTheme;
+    private copyDir;
+    private linkTemplateNodeModules;
+    private removeDir;
+}