@fluid-app/fluid-cli-themes 0.1.0

package/src/generated/resources.ts

@@ -0,0 +1,78 @@
+// resources.ts — AUTO-GENERATED, DO NOT EDIT
+import { Command } from "commander";
+import type { CommandContext } from "@fluid-app/fluid-cli";
+
+export function registerResources(parent: Command, ctx: CommandContext): void {
+  const resource = parent.command("resources").description("resources");
+
+  resource
+    .command("get <application-theme-id>")
+    .description("Lists all theme resources")
+    .action(async (applicationThemeId) => {
+      const client = await ctx.getClient();
+      if (ctx.verbose)
+        process.stderr.write(
+          "GET " +
+            `/api/application_themes/${applicationThemeId}/resources` +
+            "\n",
+        );
+      const result = await client.get(
+        `/api/application_themes/${applicationThemeId}/resources`,
+      );
+      ctx.output(result);
+    });
+
+  resource
+    .command("update <application-theme-id>")
+    .description("Updates a theme resource")
+    .option("--body <json>", "Request body as JSON string")
+    .option("--body-file <path>", "Read request body from file")
+    .action(async (applicationThemeId, opts) => {
+      const client = await ctx.getClient();
+      let body: unknown;
+      if (opts.bodyFile) {
+        const { readFileSync } = await import("fs");
+        body = ctx.parseBody(readFileSync(opts.bodyFile, "utf-8"));
+      } else if (opts.body) {
+        body = ctx.parseBody(opts.body);
+      }
+      if (ctx.verbose)
+        process.stderr.write(
+          "PUT " +
+            `/api/application_themes/${applicationThemeId}/resources` +
+            "\n",
+        );
+      const result = await client.put(
+        `/api/application_themes/${applicationThemeId}/resources`,
+        body,
+      );
+      ctx.output(result);
+    });
+
+  resource
+    .command("delete <application-theme-id>")
+    .description("Deletes a theme resource")
+    .option("--body <json>", "Request body as JSON string")
+    .option("--body-file <path>", "Read request body from file")
+    .action(async (applicationThemeId, opts) => {
+      const client = await ctx.getClient();
+      let body: unknown;
+      if (opts.bodyFile) {
+        const { readFileSync } = await import("fs");
+        body = ctx.parseBody(readFileSync(opts.bodyFile, "utf-8"));
+      } else if (opts.body) {
+        body = ctx.parseBody(opts.body);
+      }
+      if (ctx.verbose)
+        process.stderr.write(
+          "DELETE " +
+            `/api/application_themes/${applicationThemeId}/resources` +
+            "\n",
+        );
+      const result = await client.delete(
+        `/api/application_themes/${applicationThemeId}/resources`,
+        { body },
+      );
+      ctx.output(result);
+    });
+}

package/src/generated/root-themes.ts

@@ -0,0 +1,119 @@
+// root-themes.ts — AUTO-GENERATED, DO NOT EDIT
+import { Command } from "commander";
+import type { CommandContext } from "@fluid-app/fluid-cli";
+
+export function registerRootThemes(parent: Command, ctx: CommandContext): void {
+  const resource = parent.command("root-themes").description("root-themes");
+
+  resource
+    .command("list")
+    .description("List root themes")
+    .option("--page <value>", "Page number for pagination")
+    .option("--per-page <value>", "Number of records per page")
+    .option(
+      "--status <value>",
+      "Filter themes by status of their versions (draft, publishing, rejected, published)",
+    )
+    .action(async (opts) => {
+      const client = await ctx.getClient();
+      const params: Record<string, unknown> = {};
+      if (opts.page !== undefined) params["page"] = Number(opts.page);
+      if (opts.perPage !== undefined) params["per_page"] = Number(opts.perPage);
+      if (opts.status !== undefined) params["status"] = opts.status;
+      if (ctx.verbose) process.stderr.write("GET " + `/api/root_themes` + "\n");
+      const result = await client.get(`/api/root_themes`, params);
+      ctx.output(result);
+    });
+
+  resource
+    .command("create")
+    .description("Create a root theme")
+    .option("--body <json>", "Request body as JSON string")
+    .option("--body-file <path>", "Read request body from file")
+    .action(async (opts) => {
+      const client = await ctx.getClient();
+      let body: unknown;
+      if (opts.bodyFile) {
+        const { readFileSync } = await import("fs");
+        body = ctx.parseBody(readFileSync(opts.bodyFile, "utf-8"));
+      } else if (opts.body) {
+        body = ctx.parseBody(opts.body);
+      }
+      if (ctx.verbose)
+        process.stderr.write("POST " + `/api/root_themes` + "\n");
+      const result = await client.post(`/api/root_themes`, body);
+      ctx.output(result);
+    });
+
+  resource
+    .command("list-company")
+    .description("List company root themes")
+    .option("--page <value>", "Page number for pagination")
+    .option("--per-page <value>", "Number of records per page")
+    .option(
+      "--status <value>",
+      "Filter themes by status of their versions (draft, publishing, rejected, published, active)",
+    )
+    .action(async (opts) => {
+      const client = await ctx.getClient();
+      const params: Record<string, unknown> = {};
+      if (opts.page !== undefined) params["page"] = Number(opts.page);
+      if (opts.perPage !== undefined) params["per_page"] = Number(opts.perPage);
+      if (opts.status !== undefined) params["status"] = opts.status;
+      if (ctx.verbose)
+        process.stderr.write("GET " + `/api/root_themes/my` + "\n");
+      const result = await client.get(`/api/root_themes/my`, params);
+      ctx.output(result);
+    });
+
+  resource
+    .command("update <id>")
+    .description("Update a root theme")
+    .option("--body <json>", "Request body as JSON string")
+    .option("--body-file <path>", "Read request body from file")
+    .action(async (id, opts) => {
+      const client = await ctx.getClient();
+      let body: unknown;
+      if (opts.bodyFile) {
+        const { readFileSync } = await import("fs");
+        body = ctx.parseBody(readFileSync(opts.bodyFile, "utf-8"));
+      } else if (opts.body) {
+        body = ctx.parseBody(opts.body);
+      }
+      if (ctx.verbose)
+        process.stderr.write("PATCH " + `/api/root_themes/${id}` + "\n");
+      const result = await client.patch(`/api/root_themes/${id}`, body);
+      ctx.output(result);
+    });
+
+  resource
+    .command("delete <id>")
+    .description("Delete a root theme")
+    .action(async (id) => {
+      const client = await ctx.getClient();
+      if (ctx.verbose)
+        process.stderr.write("DELETE " + `/api/root_themes/${id}` + "\n");
+      const result = await client.delete(`/api/root_themes/${id}`);
+      ctx.output(result);
+    });
+
+  resource
+    .command("update-status <id>")
+    .description("Update a root theme status")
+    .option("--body <json>", "Request body as JSON string")
+    .option("--body-file <path>", "Read request body from file")
+    .action(async (id, opts) => {
+      const client = await ctx.getClient();
+      let body: unknown;
+      if (opts.bodyFile) {
+        const { readFileSync } = await import("fs");
+        body = ctx.parseBody(readFileSync(opts.bodyFile, "utf-8"));
+      } else if (opts.body) {
+        body = ctx.parseBody(opts.body);
+      }
+      if (ctx.verbose)
+        process.stderr.write("POST " + `/api/root_themes/${id}/status` + "\n");
+      const result = await client.post(`/api/root_themes/${id}/status`, body);
+      ctx.output(result);
+    });
+}

package/src/generated/templates.ts

@@ -0,0 +1,366 @@
+// templates.ts — AUTO-GENERATED, DO NOT EDIT
+import { Command } from "commander";
+import type { CommandContext } from "@fluid-app/fluid-cli";
+
+function parseBooleanOption(value: string, flag: string): boolean {
+  const normalized = value.trim().toLowerCase();
+  if (["true", "1", "yes", "on"].includes(normalized)) return true;
+  if (["false", "0", "no", "off"].includes(normalized)) return false;
+  throw new Error(`Invalid value for ${flag}: ${value}. Expected true/false.`);
+}
+
+export function registerTemplates(parent: Command, ctx: CommandContext): void {
+  const resource = parent.command("templates").description("templates");
+
+  resource
+    .command("list")
+    .description("Lists all theme templates")
+    .option("--application-theme-id <value>", "ID of the application theme")
+    .option("--themeable-type <value>", "Filter templates by themeable type")
+    .option("--published <value>", "return published versions")
+    .action(async (opts) => {
+      const client = await ctx.getClient();
+      const params: Record<string, unknown> = {};
+      if (opts.applicationThemeId !== undefined)
+        params["application_theme_id"] = opts.applicationThemeId;
+      if (opts.themeableType !== undefined)
+        params["themeable_type"] = opts.themeableType;
+      if (opts.published !== undefined)
+        params["published"] = parseBooleanOption(opts.published, "--published");
+      if (ctx.verbose)
+        process.stderr.write(
+          "GET " + `/api/application_theme_templates` + "\n",
+        );
+      const result = await client.get(
+        `/api/application_theme_templates`,
+        params,
+      );
+      ctx.output(result);
+    });
+
+  resource
+    .command("create")
+    .description("Creates a theme template")
+    .option("--application-theme-id <value>", "ID of the application theme")
+    .option("--themeable-type <value>", "Filter templates by themeable type")
+    .option("--published <value>", "return published versions")
+    .option("--body <json>", "Request body as JSON string")
+    .option("--body-file <path>", "Read request body from file")
+    .action(async (opts) => {
+      const client = await ctx.getClient();
+      const params: Record<string, unknown> = {};
+      if (opts.applicationThemeId !== undefined)
+        params["application_theme_id"] = opts.applicationThemeId;
+      if (opts.themeableType !== undefined)
+        params["themeable_type"] = opts.themeableType;
+      if (opts.published !== undefined)
+        params["published"] = parseBooleanOption(opts.published, "--published");
+      let body: unknown;
+      if (opts.bodyFile) {
+        const { readFileSync } = await import("fs");
+        body = ctx.parseBody(readFileSync(opts.bodyFile, "utf-8"));
+      } else if (opts.body) {
+        body = ctx.parseBody(opts.body);
+      }
+      if (ctx.verbose)
+        process.stderr.write(
+          "POST " + `/api/application_theme_templates` + "\n",
+        );
+      const result = await client.post(
+        `/api/application_theme_templates`,
+        body,
+        { params },
+      );
+      ctx.output(result);
+    });
+
+  resource
+    .command("get <id>")
+    .description("Retrieves a theme template")
+    .option("--version <value>", "Version of the theme template to retrieve")
+    .option(
+      "--published <value>",
+      "Retrieve the published version of the theme template",
+    )
+    .action(async (id, opts) => {
+      const client = await ctx.getClient();
+      const params: Record<string, unknown> = {};
+      if (opts.version !== undefined) params["version"] = opts.version;
+      if (opts.published !== undefined)
+        params["published"] = parseBooleanOption(opts.published, "--published");
+      if (ctx.verbose)
+        process.stderr.write(
+          "GET " + `/api/application_theme_templates/${id}` + "\n",
+        );
+      const result = await client.get(
+        `/api/application_theme_templates/${id}`,
+        params,
+      );
+      ctx.output(result);
+    });
+
+  resource
+    .command("update <id>")
+    .description("Updates a theme template")
+    .option("--version <value>", "Version of the theme template to retrieve")
+    .option(
+      "--published <value>",
+      "Retrieve the published version of the theme template",
+    )
+    .option("--body <json>", "Request body as JSON string")
+    .option("--body-file <path>", "Read request body from file")
+    .action(async (id, opts) => {
+      const client = await ctx.getClient();
+      const params: Record<string, unknown> = {};
+      if (opts.version !== undefined) params["version"] = opts.version;
+      if (opts.published !== undefined)
+        params["published"] = parseBooleanOption(opts.published, "--published");
+      let body: unknown;
+      if (opts.bodyFile) {
+        const { readFileSync } = await import("fs");
+        body = ctx.parseBody(readFileSync(opts.bodyFile, "utf-8"));
+      } else if (opts.body) {
+        body = ctx.parseBody(opts.body);
+      }
+      if (ctx.verbose)
+        process.stderr.write(
+          "PATCH " + `/api/application_theme_templates/${id}` + "\n",
+        );
+      const result = await client.patch(
+        `/api/application_theme_templates/${id}`,
+        body,
+        { params },
+      );
+      ctx.output(result);
+    });
+
+  resource
+    .command("delete <id>")
+    .description("Deletes a theme template")
+    .option("--version <value>", "Version of the theme template to retrieve")
+    .option(
+      "--published <value>",
+      "Retrieve the published version of the theme template",
+    )
+    .action(async (id, opts) => {
+      const client = await ctx.getClient();
+      const params: Record<string, unknown> = {};
+      if (opts.version !== undefined) params["version"] = opts.version;
+      if (opts.published !== undefined)
+        params["published"] = parseBooleanOption(opts.published, "--published");
+      if (ctx.verbose)
+        process.stderr.write(
+          "DELETE " + `/api/application_theme_templates/${id}` + "\n",
+        );
+      const result = await client.delete(
+        `/api/application_theme_templates/${id}`,
+        { params },
+      );
+      ctx.output(result);
+    });
+
+  resource
+    .command("clone <id>")
+    .description("Clones a theme template")
+    .action(async (id) => {
+      const client = await ctx.getClient();
+      if (ctx.verbose)
+        process.stderr.write(
+          "POST " + `/api/application_theme_templates/${id}/clone` + "\n",
+        );
+      const result = await client.post(
+        `/api/application_theme_templates/${id}/clone`,
+      );
+      ctx.output(result);
+    });
+
+  resource
+    .command("set-default <id>")
+    .description("Sets a theme template as default")
+    .action(async (id) => {
+      const client = await ctx.getClient();
+      if (ctx.verbose)
+        process.stderr.write(
+          "POST " + `/api/application_theme_templates/${id}/set_default` + "\n",
+        );
+      const result = await client.post(
+        `/api/application_theme_templates/${id}/set_default`,
+      );
+      ctx.output(result);
+    });
+
+  resource
+    .command("version-diff <id>")
+    .description("Gets version diff information")
+    .option("--version <value>", "Version number to compare with")
+    .action(async (id, opts) => {
+      const client = await ctx.getClient();
+      const params: Record<string, unknown> = {};
+      if (opts.version !== undefined) params["version"] = Number(opts.version);
+      if (ctx.verbose)
+        process.stderr.write(
+          "GET " + `/api/application_theme_templates/${id}/version_diff` + "\n",
+        );
+      const result = await client.get(
+        `/api/application_theme_templates/${id}/version_diff`,
+        params,
+      );
+      ctx.output(result);
+    });
+
+  resource
+    .command("render-page <id>")
+    .description("Renders a page for a theme template")
+    .option("--version <value>", "Version of the theme template to retrieve")
+    .option("--body <json>", "Request body as JSON string")
+    .option("--body-file <path>", "Read request body from file")
+    .action(async (id, opts) => {
+      const client = await ctx.getClient();
+      const params: Record<string, unknown> = {};
+      if (opts.version !== undefined) params["version"] = opts.version;
+      let body: unknown;
+      if (opts.bodyFile) {
+        const { readFileSync } = await import("fs");
+        body = ctx.parseBody(readFileSync(opts.bodyFile, "utf-8"));
+      } else if (opts.body) {
+        body = ctx.parseBody(opts.body);
+      }
+      if (ctx.verbose)
+        process.stderr.write(
+          "POST " + `/api/application_theme_templates/${id}/render_page` + "\n",
+        );
+      const result = await client.post(
+        `/api/application_theme_templates/${id}/render_page`,
+        body,
+        { params },
+      );
+      ctx.output(result);
+    });
+
+  resource
+    .command("render-section <id>")
+    .description("Renders a section template")
+    .action(async (id) => {
+      const client = await ctx.getClient();
+      if (ctx.verbose)
+        process.stderr.write(
+          "POST " +
+            `/api/application_theme_templates/${id}/render_section` +
+            "\n",
+        );
+      const result = await client.post(
+        `/api/application_theme_templates/${id}/render_section`,
+      );
+      ctx.output(result);
+    });
+
+  resource
+    .command("get-theme-template-available-variables-api <id>")
+    .description("Get available variables for a theme template")
+    .action(async (id) => {
+      const client = await ctx.getClient();
+      if (ctx.verbose)
+        process.stderr.write(
+          "GET " +
+            `/api/application_theme_templates/${id}/available_variables` +
+            "\n",
+        );
+      const result = await client.get(
+        `/api/application_theme_templates/${id}/available_variables`,
+      );
+      ctx.output(result);
+    });
+
+  resource
+    .command("publish <id>")
+    .description("Publishes the template")
+    .option(
+      "--version <value>",
+      "Version of the theme template to publish. If not specified, the latest version will be published.",
+    )
+    .action(async (id, opts) => {
+      const client = await ctx.getClient();
+      const params: Record<string, unknown> = {};
+      if (opts.version !== undefined) params["version"] = opts.version;
+      if (ctx.verbose)
+        process.stderr.write(
+          "POST " + `/api/application_theme_templates/${id}/publish` + "\n",
+        );
+      const result = await client.post(
+        `/api/application_theme_templates/${id}/publish`,
+        undefined,
+        { params },
+      );
+      ctx.output(result);
+    });
+
+  resource
+    .command("available-themeables <id>")
+    .description("Returns all available themeables for theme template")
+    .option(
+      "--selected <value>",
+      "Filter themeables that are already assigned to this template",
+    )
+    .option(
+      "--status <value>",
+      "Filter themeables by status (active, draft, archived)",
+    )
+    .action(async (id, opts) => {
+      const client = await ctx.getClient();
+      const params: Record<string, unknown> = {};
+      if (opts.selected !== undefined)
+        params["selected"] = parseBooleanOption(opts.selected, "--selected");
+      if (opts.status !== undefined) params["status"] = opts.status;
+      if (ctx.verbose)
+        process.stderr.write(
+          "GET " +
+            `/api/application_theme_templates/${id}/available_themeables` +
+            "\n",
+        );
+      const result = await client.get(
+        `/api/application_theme_templates/${id}/available_themeables`,
+        params,
+      );
+      ctx.output(result);
+    });
+
+  resource
+    .command("themeables-update <id>")
+    .description(
+      "Updates themeable records to be used by the specified template",
+    )
+    .option("--query-params <value>", "query_params")
+    .action(async (id, opts) => {
+      const client = await ctx.getClient();
+      const params: Record<string, unknown> = {};
+      if (opts.queryParams !== undefined)
+        params["query_params"] = opts.queryParams;
+      if (ctx.verbose)
+        process.stderr.write(
+          "PUT " +
+            `/api/application_theme_templates/${id}/themeables_update` +
+            "\n",
+        );
+      const result = await client.put(
+        `/api/application_theme_templates/${id}/themeables_update`,
+        undefined,
+        { params },
+      );
+      ctx.output(result);
+    });
+
+  resource
+    .command("get-mysite-themes")
+    .description("List all mysite themes")
+    .action(async () => {
+      const client = await ctx.getClient();
+      if (ctx.verbose)
+        process.stderr.write(
+          "GET " + `/api/application_theme_templates/mysite_themes` + "\n",
+        );
+      const result = await client.get(
+        `/api/application_theme_templates/mysite_themes`,
+      );
+      ctx.output(result);
+    });
+}

package/src/index.ts

@@ -0,0 +1,20 @@
+import type { FluidPlugin } from "@fluid-app/fluid-cli";
+import { createDomainCommand } from "@fluid-app/fluid-cli";
+
+import { registerAllCommands } from "./generated/index.js";
+
+const plugin: FluidPlugin = {
+  name: "@fluid-app/fluid-cli-themes",
+  version: "0.1.0",
+  register(ctx) {
+    ctx.program.addCommand(
+      createDomainCommand(
+        "themes",
+        "Manage Fluid application themes and templates",
+        registerAllCommands,
+      ),
+    );
+  },
+};
+
+export default plugin;

package/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "@fluid-app/typescript-config/base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "incremental": false
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/tsdown.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from "tsdown";
+
+export default defineConfig({
+  entry: { index: "src/index.ts" },
+  format: ["esm"],
+  dts: true,
+  clean: true,
+  target: "node18",
+  deps: {
+    neverBundle: ["commander", "@fluid-app/fluid-cli"],
+  },
+});