@kodiak-finance/orderly-devkit 1.0.2

package/src/commands/delete.js

@@ -0,0 +1,224 @@
+const {
+  heading,
+  info,
+  warn,
+  error,
+  success,
+  select,
+  confirm,
+  getApiErrorInfo,
+} = require("../shared");
+const {
+  isLoggedIn,
+  getToken,
+  authenticatedFetch,
+} = require("../internal/auth");
+const {
+  MARKETPLACE_API_MY_PLUGINS_URL,
+  getMarketplaceApiPluginUrl,
+} = require("../internal/constants");
+
+/**
+ * Normalize unknown list payloads into an array.
+ * This keeps delete flow stable across minor API response shape changes.
+ * @param {unknown} data
+ * @returns {Array<Record<string, unknown>>}
+ */
+function normalizePlugins(data) {
+  if (Array.isArray(data)) {
+    return data;
+  }
+
+  if (Array.isArray(data?.data)) {
+    return data.data;
+  }
+
+  if (Array.isArray(data?.plugins)) {
+    return data.plugins;
+  }
+
+  if (Array.isArray(data?.items)) {
+    return data.items;
+  }
+
+  if (Array.isArray(data?.results)) {
+    return data.results;
+  }
+
+  if (Array.isArray(data?.data?.items)) {
+    return data.data.items;
+  }
+
+  if (Array.isArray(data?.data?.plugins)) {
+    return data.data.plugins;
+  }
+
+  if (Array.isArray(data?.data?.results)) {
+    return data.data.results;
+  }
+
+  return [];
+}
+
+/**
+ * Render a compact plugin label for the selection prompt.
+ * @param {Record<string, unknown>} plugin
+ * @returns {string}
+ */
+function toPluginChoiceLabel(plugin) {
+  const name = plugin?.name || plugin?.npmName || "Unknown";
+  const id = plugin?.id || plugin?.pluginId || "unknown-id";
+  const status = plugin?.status || "unknown";
+  return `${name} (${id}) [${status}]`;
+}
+
+module.exports = {
+  command: "delete",
+  describe: "Delete one of your submitted plugins from Marketplace",
+  builder: (yargs) => {
+    return yargs
+      .option("pluginId", {
+        type: "string",
+        describe:
+          "string; plugin ID to delete directly. If omitted, an interactive selector is shown",
+        demandOption: false,
+      })
+      .example("orderly delete", "Select one of your plugins and delete it")
+      .example(
+        "orderly delete --pluginId my-plugin-id",
+        "Delete a specific plugin directly without selection",
+      )
+      .example(
+        "orderly delete --help",
+        "Show command help and usage for plugin deletion",
+      );
+  },
+  handler: async (argv) => {
+    heading("Delete My Plugin");
+    info(
+      "This command will permanently delete one of your submitted plugins.\n",
+    );
+
+    // Deletion is author-scoped and requires authenticated identity.
+    if (!isLoggedIn()) {
+      warn("You are not logged in.");
+      info("Please run 'orderly login' first to authenticate.");
+      process.exitCode = 1;
+      return;
+    }
+
+    const token = getToken();
+    if (!token) {
+      error("Authentication token not found.");
+      info("Please run 'orderly login' again.");
+      process.exitCode = 1;
+      return;
+    }
+
+    try {
+      // Skip interactive selection when pluginId is provided explicitly.
+      let selectedPluginId =
+        typeof argv.pluginId === "string" ? argv.pluginId.trim() : "";
+      if (!selectedPluginId) {
+        info("Fetching your submitted plugins...");
+        const listResponse = await authenticatedFetch(
+          MARKETPLACE_API_MY_PLUGINS_URL,
+          {
+            method: "GET",
+            headers: {
+              Accept: "application/json",
+              Authorization: `Bearer ${token}`,
+            },
+          },
+        );
+
+        const listData = await listResponse.json().catch(() => null);
+        if (!listResponse.ok) {
+          const { message } = getApiErrorInfo(listData, listResponse.status);
+          error(`Failed to fetch plugins: ${message}`);
+          process.exitCode = 1;
+          return;
+        }
+
+        const plugins = normalizePlugins(listData);
+        if (plugins.length === 0) {
+          info("You have not submitted any plugins yet.");
+          info(
+            "If Marketplace Web shows records, run `orderly whoami` to confirm account consistency and `orderly list --json` to inspect the raw API response.",
+          );
+          return;
+        }
+
+        const choices = plugins
+          .map((plugin) => ({
+            name: String(plugin?.id || plugin?.pluginId || ""),
+            message: toPluginChoiceLabel(plugin),
+            value: String(plugin?.id || plugin?.pluginId || ""),
+          }))
+          .filter((choice) => Boolean(choice.value));
+
+        if (choices.length === 0) {
+          error("No valid plugin IDs found in marketplace response.");
+          process.exitCode = 1;
+          return;
+        }
+
+        selectedPluginId = await select(
+          "Select a plugin to delete permanently:",
+          choices,
+          0,
+        );
+      } else {
+        info(`Using pluginId from command argument: ${selectedPluginId}`);
+      }
+
+      if (!selectedPluginId) {
+        warn("No plugin selected.");
+        process.exitCode = 1;
+        return;
+      }
+
+      const confirmed = await confirm(
+        `Are you sure you want to delete plugin "${selectedPluginId}"? This action cannot be undone.`,
+      );
+      if (!confirmed) {
+        warn("Deletion cancelled.");
+        return;
+      }
+
+      const endpoint = getMarketplaceApiPluginUrl(selectedPluginId);
+      info(`Submitting delete request to ${endpoint} ...`);
+      const deleteResponse = await authenticatedFetch(endpoint, {
+        method: "DELETE",
+        headers: {
+          Accept: "application/json",
+          Authorization: `Bearer ${token}`,
+        },
+      });
+
+      if (deleteResponse.status === 204) {
+        success("\nPlugin deleted successfully.");
+        info(`Plugin ID: ${selectedPluginId}`);
+        return;
+      }
+
+      const deleteData = await deleteResponse.json().catch(() => null);
+      const { code, message } = getApiErrorInfo(
+        deleteData,
+        deleteResponse.status,
+      );
+      error(`Failed to delete plugin: ${message}`);
+      if (code) {
+        info(`Error code: ${code}`);
+      }
+      info("Please verify plugin ownership and API availability.");
+      process.exitCode = 1;
+    } catch (e) {
+      // Include endpoint context to help diagnose request/runtime failures.
+      const cause = e?.message || String(e);
+      error(`Request failed while calling marketplace APIs: ${cause}`);
+      info("Please verify network connectivity and API availability.");
+      process.exitCode = 1;
+    }
+  },
+};

package/src/commands/disable.js

@@ -0,0 +1,219 @@
+const {
+  heading,
+  info,
+  warn,
+  error,
+  success,
+  select,
+  getApiErrorInfo,
+} = require("../shared");
+const {
+  isLoggedIn,
+  getToken,
+  authenticatedFetch,
+} = require("../internal/auth");
+const {
+  MARKETPLACE_API_MY_PLUGINS_URL,
+  getMarketplaceApiPluginSelfStatusUrl,
+} = require("../internal/constants");
+
+/**
+ * Normalize unknown list payloads into an array.
+ * Keeps this command resilient to small response shape changes.
+ * @param {unknown} data
+ * @returns {Array<Record<string, unknown>>}
+ */
+function normalizePlugins(data) {
+  if (Array.isArray(data)) {
+    return data;
+  }
+
+  if (Array.isArray(data?.data)) {
+    return data.data;
+  }
+
+  if (Array.isArray(data?.plugins)) {
+    return data.plugins;
+  }
+
+  if (Array.isArray(data?.items)) {
+    return data.items;
+  }
+
+  if (Array.isArray(data?.results)) {
+    return data.results;
+  }
+
+  if (Array.isArray(data?.data?.items)) {
+    return data.data.items;
+  }
+
+  if (Array.isArray(data?.data?.plugins)) {
+    return data.data.plugins;
+  }
+
+  if (Array.isArray(data?.data?.results)) {
+    return data.data.results;
+  }
+
+  return [];
+}
+
+/**
+ * Format a compact prompt label so users can identify the target plugin quickly.
+ * @param {Record<string, unknown>} plugin
+ * @returns {string}
+ */
+function toPluginChoiceLabel(plugin) {
+  const name = plugin?.name || plugin?.npmName || "Unknown";
+  const id = plugin?.id || plugin?.pluginId || "unknown-id";
+  const status = plugin?.status || "unknown";
+  return `${name} (${id}) [${status}]`;
+}
+
+module.exports = {
+  command: "disable",
+  describe: "Delist one of your submitted plugins from Marketplace",
+  builder: (yargs) => {
+    return yargs
+      .option("pluginId", {
+        type: "string",
+        describe:
+          "string; plugin ID to delist directly. If omitted, an interactive selector is shown",
+        demandOption: false,
+      })
+      .example("orderly disable", "Select one of your plugins and delist it")
+      .example(
+        "orderly disable --pluginId my-plugin-id",
+        "Delist a specific plugin directly without selection",
+      )
+      .example(
+        "orderly disable --help",
+        "Show command help and usage for plugin delisting",
+      );
+  },
+  handler: async (argv) => {
+    heading("Disable My Plugin");
+    info("This command will delist one of your submitted plugins.\n");
+
+    // Require login first because both listing and status update are owner-scoped operations.
+    if (!isLoggedIn()) {
+      warn("You are not logged in.");
+      info("Please run 'orderly login' first to authenticate.");
+      process.exitCode = 1;
+      return;
+    }
+
+    const token = getToken();
+    if (!token) {
+      error("Authentication token not found.");
+      info("Please run 'orderly login' again.");
+      process.exitCode = 1;
+      return;
+    }
+
+    try {
+      // Skip interactive selection when pluginId is provided explicitly.
+      let selectedPluginId =
+        typeof argv.pluginId === "string" ? argv.pluginId.trim() : "";
+      if (!selectedPluginId) {
+        info("Fetching your submitted plugins...");
+        const listResponse = await authenticatedFetch(
+          MARKETPLACE_API_MY_PLUGINS_URL,
+          {
+            method: "GET",
+            headers: {
+              Accept: "application/json",
+              Authorization: `Bearer ${token}`,
+            },
+          },
+        );
+
+        const listData = await listResponse.json().catch(() => null);
+        if (!listResponse.ok) {
+          const { message } = getApiErrorInfo(listData, listResponse.status);
+          error(`Failed to fetch plugins: ${message}`);
+          process.exitCode = 1;
+          return;
+        }
+
+        const plugins = normalizePlugins(listData);
+        if (plugins.length === 0) {
+          info("You have not submitted any plugins yet.");
+          info(
+            "If Marketplace Web shows records, run `orderly whoami` to confirm account consistency and `orderly list --json` to inspect the raw API response.",
+          );
+          return;
+        }
+
+        const choices = plugins
+          .map((plugin) => ({
+            name: String(plugin?.id || plugin?.pluginId || ""),
+            message: toPluginChoiceLabel(plugin),
+            value: String(plugin?.id || plugin?.pluginId || ""),
+          }))
+          .filter((choice) => Boolean(choice.value));
+
+        if (choices.length === 0) {
+          error("No valid plugin IDs found in marketplace response.");
+          process.exitCode = 1;
+          return;
+        }
+
+        selectedPluginId = await select(
+          "Select a plugin to delist (set status to disabled):",
+          choices,
+          0,
+        );
+      } else {
+        info(`Using pluginId from command argument: ${selectedPluginId}`);
+      }
+
+      if (!selectedPluginId) {
+        warn("No plugin selected.");
+        process.exitCode = 1;
+        return;
+      }
+
+      const endpoint = getMarketplaceApiPluginSelfStatusUrl(selectedPluginId);
+      info(`Submitting delist request to ${endpoint} ...`);
+      const disableResponse = await authenticatedFetch(endpoint, {
+        method: "PATCH",
+        headers: {
+          "Content-Type": "application/json",
+          Accept: "application/json",
+          Authorization: `Bearer ${token}`,
+        },
+        body: JSON.stringify({ status: "disabled" }),
+      });
+
+      const disableData = await disableResponse.json().catch(() => null);
+      if (!disableResponse.ok) {
+        const { code, message } = getApiErrorInfo(
+          disableData,
+          disableResponse.status,
+        );
+        error(`Failed to delist plugin: ${message}`);
+        if (code) {
+          info(`Error code: ${code}`);
+        }
+        info("Please verify plugin ownership and API availability.");
+        process.exitCode = 1;
+        return;
+      }
+
+      const updatedName = disableData?.name || disableData?.npmName || "N/A";
+      const updatedStatus = disableData?.status || "disabled";
+      success("\nPlugin delisted successfully.");
+      info(`Plugin ID: ${selectedPluginId}`);
+      info(`Plugin Name: ${updatedName}`);
+      info(`Status: ${updatedStatus}`);
+    } catch (e) {
+      // Include endpoint context so users can triage connectivity issues quickly.
+      const cause = e?.message || String(e);
+      error(`Request failed while calling marketplace APIs: ${cause}`);
+      info("Please verify network connectivity and API availability.");
+      process.exitCode = 1;
+    }
+  },
+};

package/src/commands/list.js

@@ -0,0 +1,196 @@
+const {
+  heading,
+  info,
+  warn,
+  error,
+  success,
+  getErrorMessage,
+} = require("../shared");
+const {
+  isLoggedIn,
+  getToken,
+  authenticatedFetch,
+} = require("../internal/auth");
+const { MARKETPLACE_API_MY_PLUGINS_URL } = require("../internal/constants");
+
+/**
+ * Convert unknown plugin payload into a list shape safely.
+ * This keeps CLI output stable across minor API response changes.
+ */
+function normalizePlugins(data) {
+  if (Array.isArray(data)) {
+    return data;
+  }
+
+  if (Array.isArray(data?.data)) {
+    return data.data;
+  }
+
+  if (Array.isArray(data?.plugins)) {
+    return data.plugins;
+  }
+
+  if (Array.isArray(data?.items)) {
+    return data.items;
+  }
+
+  if (Array.isArray(data?.results)) {
+    return data.results;
+  }
+
+  if (Array.isArray(data?.data?.items)) {
+    return data.data.items;
+  }
+
+  if (Array.isArray(data?.data?.plugins)) {
+    return data.data.plugins;
+  }
+
+  if (Array.isArray(data?.data?.results)) {
+    return data.data.results;
+  }
+
+  return [];
+}
+
+/**
+ * Keep table columns compact so terminal output stays readable.
+ */
+function truncate(value, maxLength = 64) {
+  const text = String(value ?? "-");
+  if (text.length <= maxLength) {
+    return text;
+  }
+  return `${text.slice(0, maxLength - 3)}...`;
+}
+
+/**
+ * Select common plugin fields with graceful fallbacks.
+ */
+function mapRow(plugin) {
+  return {
+    id: plugin?.id || plugin?.pluginId || "-",
+    name: plugin?.name || plugin?.npmName || "-",
+    version: plugin?.version || plugin?.latestVersion || "-",
+    status: plugin?.status || "-",
+    description: truncate(plugin?.description || "-", 72),
+  };
+}
+
+/**
+ * Render simple aligned table without extra dependencies.
+ */
+function renderTable(rows) {
+  const headers = ["ID", "Name", "Version", "Status", "Description"];
+  const keys = ["id", "name", "version", "status", "description"];
+
+  const widths = keys.map((key, index) => {
+    const headerWidth = headers[index].length;
+    const maxValueWidth = rows.reduce((max, row) => {
+      const width = String(row[key] ?? "-").length;
+      return width > max ? width : max;
+    }, 0);
+    return Math.max(headerWidth, maxValueWidth);
+  });
+
+  const buildLine = (values) =>
+    values
+      .map((value, index) => String(value).padEnd(widths[index]))
+      .join("  ");
+
+  const headerLine = buildLine(headers);
+  const dividerLine = widths.map((width) => "-".repeat(width)).join("  ");
+  const rowLines = rows.map((row) =>
+    buildLine(keys.map((key) => row[key] ?? "-")),
+  );
+
+  return [headerLine, dividerLine, ...rowLines].join("\n");
+}
+
+module.exports = {
+  command: "list",
+  describe: "List my submitted plugins from Marketplace",
+  builder: (yargs) => {
+    return yargs
+      .option("json", {
+        type: "boolean",
+        describe:
+          "boolean; when true, output the raw marketplace response as JSON (otherwise prints a compact table)",
+        default: false,
+      })
+      .example("orderly list", "List your submitted plugins as a compact table")
+      .example(
+        "orderly list --json",
+        "Output the raw JSON payload (useful for debugging/agents)",
+      );
+  },
+  handler: async (argv) => {
+    heading("My Plugins");
+
+    if (!isLoggedIn()) {
+      warn("You are not logged in.");
+      info("Please run 'orderly login' first to authenticate.");
+      process.exitCode = 1;
+      return;
+    }
+
+    const token = getToken();
+    if (!token) {
+      error("Authentication token not found.");
+      info("Please run 'orderly login' again.");
+      process.exitCode = 1;
+      return;
+    }
+
+    try {
+      // Use Headers to merge defaults safely and inject auth token consistently.
+      const headers = new Headers({ Accept: "application/json" });
+      headers.set("Authorization", `Bearer ${token}`);
+
+      const response = await authenticatedFetch(
+        MARKETPLACE_API_MY_PLUGINS_URL,
+        {
+          method: "GET",
+          headers,
+        },
+      );
+
+      const responseData = await response.json().catch(() => null);
+
+      if (!response.ok) {
+        const serverMessage = getErrorMessage(responseData, response.status);
+        error(`Failed to fetch plugins: ${serverMessage}`);
+        process.exitCode = 1;
+        return;
+      }
+
+      const plugins = normalizePlugins(responseData);
+
+      if (argv.json) {
+        // Print real server payload for troubleshooting response shape mismatches.
+        console.log(JSON.stringify(responseData, null, 2));
+        return;
+      }
+
+      if (plugins.length === 0) {
+        info("You have not submitted any plugins yet.");
+        info(
+          "If Marketplace Web shows records, run `orderly whoami` to confirm account consistency and `orderly list --json` to inspect the raw API response.",
+        );
+        return;
+      }
+
+      const rows = plugins.map(mapRow);
+      console.log(renderTable(rows));
+      success(`\nTotal: ${plugins.length} plugin(s)`);
+    } catch (e) {
+      // Surface target endpoint to make network/runtime failures actionable.
+      const cause = e?.message || String(e);
+      error(
+        `Request failed while calling ${MARKETPLACE_API_MY_PLUGINS_URL}: ${cause}`,
+      );
+      info("Please verify network connectivity and API availability.");
+      process.exitCode = 1;
+    }
+  },
+};