@sudajs/cli 0.7.1 → 0.8.0

package/dist/index.d.ts

@@ -1,6 +1,10 @@
 #!/usr/bin/env node
-import { ThemeModule } from '@sudajs/theme-engine';
+import { ThemeModule, ThemeStarterPage } from '@sudajs/theme-engine';
+import { ThemeRender, extractLayoutChrome, resolveAssetPath } from '@sudajs/theme-engine/server';
 import { Command } from 'commander';
+import { createElement } from 'react';
+import { renderToString } from 'react-dom/server';
+import { z } from 'zod';
 
 interface ValidatedTheme {
     root: string;
@@ -9,16 +13,118 @@ interface ValidatedTheme {
     clientEntryPath: string | null;
     stylesheetPath: string | null;
 }
+interface CliAuthContext {
+    baseUrl: string;
+    token: string;
+}
+type FetchJsonFn = typeof fetchJson;
+declare const destructivePageOperationOutputSchema: z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
+    status: z.ZodLiteral<"needs_confirmation">;
+    projectId: z.ZodString;
+    slug: z.ZodString;
+    impact: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    slug: string;
+    status: "needs_confirmation";
+    impact: string;
+}, {
+    projectId: string;
+    slug: string;
+    status: "needs_confirmation";
+    impact: string;
+}>, z.ZodObject<{
+    status: z.ZodEnum<["deleted", "published"]>;
+    projectId: z.ZodString;
+    slug: z.ZodString;
+    pageId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    slug: string;
+    status: "deleted" | "published";
+    pageId: string;
+}, {
+    projectId: string;
+    slug: string;
+    status: "deleted" | "published";
+    pageId: string;
+}>]>;
+declare const activateThemeOutputSchema: z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
+    status: z.ZodLiteral<"needs_confirmation">;
+    projectId: z.ZodString;
+    themeKey: z.ZodString;
+    themeVersion: z.ZodNullable<z.ZodString>;
+    impact: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    status: "needs_confirmation";
+    impact: string;
+    themeKey: string;
+    themeVersion: string | null;
+}, {
+    projectId: string;
+    status: "needs_confirmation";
+    impact: string;
+    themeKey: string;
+    themeVersion: string | null;
+}>, z.ZodObject<{
+    status: z.ZodLiteral<"activated">;
+    projectId: z.ZodString;
+    themeKey: z.ZodString;
+    themeVersion: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    status: "activated";
+    themeKey: string;
+    themeVersion: string | null;
+}, {
+    projectId: string;
+    status: "activated";
+    themeKey: string;
+    themeVersion: string | null;
+}>]>;
+declare function fetchJson<T>(url: string, options?: RequestInit & {
+    token?: string;
+}): Promise<T>;
 declare function validateTheme(root: string): Promise<ValidatedTheme>;
 declare function toViteModuleUrl(root: string, absolutePath: string): string;
 declare function buildTheme(root: string): Promise<ValidatedTheme>;
 declare function finalizeTheme(root: string): Promise<ValidatedTheme>;
 declare function findAnchorTagByHref(html: string, href: string): string | null;
 declare const __testUtils: {
+    createRemotePageDraft: typeof createRemotePageDraft;
     findAnchorTagByHref: typeof findAnchorTagByHref;
+    loadThemeScopedRenderer: typeof loadThemeScopedRenderer;
+    initThemeWithKey: typeof initThemeWithKey;
+    performActivateTheme: typeof performActivateTheme;
+    performConfirmedPageOperation: typeof performConfirmedPageOperation;
+    renderDevStarterPageHtml: typeof renderDevStarterPageHtml;
+    slugifyThemeName: typeof slugifyThemeName;
+    validateThemeKey: typeof validateThemeKey;
+    validateThemeName: typeof validateThemeName;
     toViteModuleUrl: typeof toViteModuleUrl;
+    updateRemotePageDraft: typeof updateRemotePageDraft;
 };
 declare function watchTheme(root: string, port: number): Promise<void>;
+/**
+ * Theme-project-scoped renderer bundle. We deliberately resolve `react`,
+ * `react-dom/server` and `@sudajs/theme-engine/server` through the theme
+ * project's own `require` graph instead of the CLI's, because the theme
+ * `dist/index.js` was already loaded against that copy of React. Importing
+ * a different React instance from the CLI side would yield two React
+ * dispatchers; client components inside the theme would call hooks against
+ * the CLI's React (whose dispatcher is `null` outside a render), producing
+ * `Cannot read properties of null (reading 'useState')`.
+ */
+interface ThemeRenderer {
+    ThemeRender: typeof ThemeRender;
+    extractLayoutChrome: typeof extractLayoutChrome;
+    resolveAssetPath: typeof resolveAssetPath;
+    createElement: typeof createElement;
+    renderToString: typeof renderToString;
+}
+declare function loadThemeScopedRenderer(themeRoot: string): Promise<ThemeRenderer>;
+declare function renderDevStarterPageHtml(theme: ValidatedTheme, page: ThemeStarterPage, renderer: ThemeRenderer): string;
 /**
  * 解析人机交互的 `key@version` 格式。允许仅 `key`，也允许带 version。
  * 注意：theme key 现行约束不含 `@`，所以从右侧第一个 `@` 之后视为 version。
@@ -29,7 +135,42 @@ declare function parseThemeRef(value: string): {
     key: string;
     version?: string;
 };
+declare function createRemotePageDraft(auth: CliAuthContext, input: {
+    projectId: string;
+    title: string;
+    slug: string;
+    themeKey: string;
+    themeVersion: string;
+    data: unknown;
+}, fetcher?: FetchJsonFn): Promise<{
+    pageId: string;
+}>;
+declare function updateRemotePageDraft(auth: CliAuthContext, input: {
+    projectId: string;
+    slug: string;
+    themeKey: string;
+    themeVersion: string;
+    data: unknown;
+}, fetcher?: FetchJsonFn): Promise<{
+    pageId: string;
+}>;
+declare function performConfirmedPageOperation(auth: CliAuthContext, input: {
+    operation: "delete" | "publish";
+    projectId: string;
+    slug: string;
+    confirm?: boolean | undefined;
+}, fetcher?: FetchJsonFn): Promise<z.infer<typeof destructivePageOperationOutputSchema>>;
+declare function performActivateTheme(auth: CliAuthContext, input: {
+    projectId: string;
+    themeKey: string;
+    themeVersion?: string | undefined;
+    confirm?: boolean | undefined;
+}, fetcher?: FetchJsonFn): Promise<z.infer<typeof activateThemeOutputSchema>>;
+declare function validateThemeName(name: string): string | null;
+declare function validateThemeKey(key: string): string | null;
+declare function slugifyThemeName(name: string): string;
 declare function initTheme(target: string): Promise<void>;
+declare function initThemeWithKey(target: string, key: string): Promise<void>;
 declare function buildProgram(): Command;
 declare function main(): Promise<void>;