@termix-ssh/plugin-sdk 1.0.2 → 1.0.5

package/dist/ddl.js

@@ -67,10 +67,13 @@ function columnType(dialect, column, keyed) {
             // text/json column, so in practice this only catches a primary key.
             if (keyed && dialect !== "sqlite")
                 return `varchar(${KEY_LENGTH})`;
+            // MySQL TEXT stops at 64KB, so free text, json and secrets go long.
+            if (dialect === "mysql" && column.type !== "timestamp")
+                return "longtext";
             return "text";
     }
 }
-/** Column types that are TEXT on MySQL when nothing keys them. */
+/** Column types that are TEXT or LONGTEXT on MySQL when nothing keys them. */
 const TEXT_ON_MYSQL = new Set([
     "text",
     "json",

package/dist/docs.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Docs links and env var entries from a manifest. Kept apart from manifest.ts
+ * so the browser can use them without pulling in semver.
+ */
+/**
+ * A docs link, or null for anything that is not an https URL. Core only ever
+ * opens it in a new tab, but a javascript: or file: link should never get there.
+ */
+export declare function pluginDocsUrl(value: unknown): string | null;
+/** Joins a page and anchor onto a plugin's docs URL. */
+export declare function pluginDocsPage(base: string, page?: string, anchor?: string): string;
+export declare const ENV_NAME_PATTERN: RegExp;
+export declare const MAX_ENV_DESCRIPTION_LENGTH = 300;
+/**
+ * An environment variable a plugin reads. Only shown in docs and on the
+ * plugin's page, so people know what they can set.
+ */
+export interface PluginEnvVar {
+    name: string;
+    description: string;
+    /** The value used when it is not set, as written in a compose file. */
+    default?: string;
+    required?: boolean;
+    /** Holds a password or key. */
+    secret?: boolean;
+}
+/** The usable env entries of a manifest. Bad ones are dropped. */
+export declare function pluginEnvVars(value: unknown): PluginEnvVar[];

package/dist/docs.js

@@ -0,0 +1,39 @@
+/**
+ * Docs links and env var entries from a manifest. Kept apart from manifest.ts
+ * so the browser can use them without pulling in semver.
+ */
+/**
+ * A docs link, or null for anything that is not an https URL. Core only ever
+ * opens it in a new tab, but a javascript: or file: link should never get there.
+ */
+export function pluginDocsUrl(value) {
+    if (typeof value !== "string")
+        return null;
+    try {
+        const url = new URL(value.trim());
+        if (url.protocol !== "https:")
+            return null;
+        return url.toString().replace(/\/$/, "");
+    }
+    catch {
+        return null;
+    }
+}
+/** Joins a page and anchor onto a plugin's docs URL. */
+export function pluginDocsPage(base, page, anchor) {
+    const clean = (page ?? "").replace(/^\/+|\/+$/g, "");
+    const url = clean ? `${base}/${clean}` : base;
+    return anchor ? `${url}#${anchor.replace(/^#/, "")}` : url;
+}
+export const ENV_NAME_PATTERN = /^[A-Z][A-Z0-9_]{0,63}$/;
+export const MAX_ENV_DESCRIPTION_LENGTH = 300;
+/** The usable env entries of a manifest. Bad ones are dropped. */
+export function pluginEnvVars(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((v) => typeof v === "object" &&
+        v !== null &&
+        typeof v.name === "string" &&
+        ENV_NAME_PATTERN.test(v.name) &&
+        typeof v.description === "string");
+}

package/dist/frontend.d.ts

@@ -816,6 +816,15 @@ export interface DesktopApi {
     /** Called when the desktop app connects to or leaves a remote server. */
     onRemoteServerChange: (listener: () => void) => Disposer;
 }
+/** Links into this plugin's docs, from the manifest's docs field. */
+export interface DocsApi {
+    /** The docs link, or null when the manifest has none. */
+    readonly url: string | null;
+    /** A page of the docs ("setup"), with an optional anchor. */
+    page: (page?: string, anchor?: string) => string | null;
+    /** Opens a page in a new tab. Does nothing without a docs link. */
+    open: (page?: string, anchor?: string) => void;
+}
 export interface TermixAppInfo {
     readonly pluginId: string;
     readonly manifest: PluginManifest;
@@ -913,6 +922,8 @@ export interface TermixApp extends TermixAppInfo {
     confirm: (options: ConfirmRequest) => Promise<boolean>;
     /** The desktop app, when the frontend runs in it. */
     desktop: DesktopApi;
+    /** This plugin's docs. Needs plugin API 1.2. */
+    docs: DocsApi;
     /**
      * Fires after this plugin's settings are saved from the settings screen or
      * the host editor. Disposed automatically.
@@ -966,6 +977,7 @@ export interface SshAuthTypeInfo {
  */
 export interface PluginHostBridge {
     usePluginId: () => string;
+    useDocsUrl: (pluginId: string, page?: string, anchor?: string) => string | null;
     useTranslation: (pluginId: string) => {
         t: TranslateFn;
         language: string;
@@ -1107,6 +1119,11 @@ export interface HostStatusInfo {
 export declare function __setPluginHost(bridge: PluginHostBridge | null): void;
 /** The id of the plugin that registered the component being rendered. */
 export declare function usePluginId(): string;
+/**
+ * A page of this plugin's docs, or null when the manifest has no docs link.
+ * Pass it to PanelShell's docs prop or use DocsLink. Needs plugin API 1.2.
+ */
+export declare function useDocsUrl(page?: string, anchor?: string): string | null;
 /**
  * Translation bound to this plugin's namespace. Keys the plugin does not
  * define fall back to core's shared strings (common.*, hosts.*).

package/dist/frontend.js

@@ -49,6 +49,14 @@ function requireHost() {
 export function usePluginId() {
     return requireHost().usePluginId();
 }
+/**
+ * A page of this plugin's docs, or null when the manifest has no docs link.
+ * Pass it to PanelShell's docs prop or use DocsLink. Needs plugin API 1.2.
+ */
+export function useDocsUrl(page, anchor) {
+    const bridge = requireHost();
+    return bridge.useDocsUrl(bridge.usePluginId(), page, anchor);
+}
 /**
  * Translation bound to this plugin's namespace. Keys the plugin does not
  * define fall back to core's shared strings (common.*, hosts.*).

package/dist/host/{chunk-XKMRKQFN.js → chunk-KOOUKYW3.js}

@@ -21,7 +21,7 @@ var inFlight = null;
 function load() {
   if (cache) return Promise.resolve(cache);
   if (inFlight) return inFlight;
-  inFlight = import("./rbac-api-JKISXZEP.js").then(({ getMyPermissions }) => getMyPermissions()).then((result) => {
+  inFlight = import("./rbac-api-UJGGTQVA.js").then(({ getMyPermissions }) => getMyPermissions()).then((result) => {
     cache = {
       permissions: result.permissions ?? [],
       isAdmin: !!result.isAdmin

package/dist/host/{chunk-LKYAVM4T.js → chunk-OEOKIKXC.js}

@@ -3801,7 +3801,7 @@ var {
 
 // src/ui/main-axios.ts
 import { toast } from "sonner";
-import i18n from "i18next";
+import i18n2 from "i18next";
 
 // src/ui/lib/base-path.ts
 function getBasePath() {
@@ -4998,12 +4998,13 @@ async function logActivity(type, hostId, hostName) {
 }
 
 // src/ui/api/rbac-api.ts
+import i18n from "i18next";
 async function getSharingTarget(hostId, syncId) {
   const api = await getConnectedRemoteApi();
   if (!api || !syncId) return { api: rbacApi, hostId };
   const remoteHostId = await resolveRemoteHostId(syncId);
   if (remoteHostId === null) {
-    throw new Error("The synced host does not exist on the remote server");
+    throw new Error(i18n.t("errors.syncedHostMissing"));
   }
   return { api, hostId: remoteHostId };
 }
@@ -5012,7 +5013,7 @@ async function getSharedCopyTarget(hostId, syncId) {
   const api = await getConnectedRemoteApi();
   const remoteHostId = api ? await resolveRemoteHostId(syncId) : null;
   if (!api || remoteHostId === null) {
-    throw new Error("The linked server is not reachable");
+    throw new Error(i18n.t("errors.linkedServerUnreachable"));
   }
   return { api, hostId: remoteHostId };
 }
@@ -5037,7 +5038,7 @@ async function updateRole(roleId, roleData) {
   try {
     const response = await rbacApi.put(`/rbac/roles/${roleId}`, roleData);
     if (roleData.permissions) {
-      const { notifyPermissionsChanged } = await import("./use-permissions-5CZEA3P4.js");
+      const { notifyPermissionsChanged } = await import("./use-permissions-P3DC7ZDR.js");
       notifyPermissionsChanged();
     }
     return response.data;
@@ -5266,6 +5267,7 @@ async function getUserPreferences() {
 }
 
 // src/ui/main-axios.ts
+var TRUST_TOKEN_KEY = "termixTrustToken";
 function getLoggerForService(serviceName) {
   if (serviceName.includes("SSH") || serviceName.includes("ssh")) {
     return sshLogger;
@@ -5292,7 +5294,6 @@ if (isElectron()) {
             if (!localStorage.getItem(key)) {
               electronSettingsCache.set(key, value);
               localStorage.setItem(key, value);
-              console.log(`[Electron] Loaded setting ${key} from main process`);
             } else {
               electronSettingsCache.set(key, localStorage.getItem(key));
             }
@@ -5318,7 +5319,6 @@ function setCookie(name, value, days = 7) {
           console.error(`[Electron] Failed to persist setting ${name}:`, err);
         });
       }
-      console.log(`[Electron] Set setting: ${name}`);
     } catch (error) {
       console.error(`[Electron] Failed to set setting: ${name}`, error);
     }
@@ -5340,7 +5340,6 @@ function getCookie(name) {
       if (token) {
         electronSettingsCache.set(name, token);
       }
-      console.log(`[Electron] Get setting: ${name} = ${token}`);
       return token;
     } catch (error) {
       console.error(`[Electron] Failed to get setting: ${name}`, error);
@@ -5427,6 +5426,15 @@ function createApiInstance(baseURL, serviceName = "API") {
           config.headers["Authorization"] = `Bearer ${jwt}`;
         }
       }
+      const trustToken = localStorage.getItem(TRUST_TOKEN_KEY);
+      const isLogin = config.url?.includes("/users/login") || /\/users\/auth\/[^/]+\/verify$/.test(config.url ?? "");
+      if (trustToken && isLogin) {
+        if (config.headers.set) {
+          config.headers.set("X-Termix-Trust-Token", trustToken);
+        } else {
+          config.headers["X-Termix-Trust-Token"] = trustToken;
+        }
+      }
     }
     if (typeof window !== "undefined" && window.ReactNativeWebView) {
       let platform = "Unknown";
@@ -5538,7 +5546,7 @@ function createApiInstance(baseURL, serviceName = "API") {
             clearClientAuthState();
             if (typeof window !== "undefined") {
               console.warn("Session expired - please log in again");
-              toast.warning(i18n.t("errors.sessionExpiredLogin"));
+              toast.warning(i18n2.t("errors.sessionExpiredLogin"));
               window.dispatchEvent(new Event("termix:logout"));
             }
             dbHealthMonitor.reportSessionExpired();
@@ -5587,7 +5595,7 @@ function createRemoteOriginApiInstance(path) {
   });
   instance.interceptors.request.use(
     async (config) => {
-      const { getLinkedSession: getLinkedSession2 } = await import("./linked-server-DW5P3NLZ.js");
+      const { getLinkedSession: getLinkedSession2 } = await import("./linked-server-RWBK427T.js");
       const linked = await getLinkedSession2();
       config.baseURL = linked ? `${linked.serverUrl}${path}` : "http://no-server-configured";
       if (config.headers.set) {
@@ -6009,6 +6017,7 @@ export {
   patchOpenTab,
   parseCustomKeybindings,
   getUserPreferences,
+  TRUST_TOKEN_KEY,
   setCookie,
   getCookie,
   markUserAuthenticated,