@termix-ssh/plugin-sdk 1.0.24 → 1.0.25

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 1.0.25
+
+Plugin API 1.14.0.
+
+### Added
+
+- Host click behavior `hostPage` opens a host page when a plugin offers one
+- `createApiKey` takes scopes, to limit a key to actions
+
 ## 1.0.24
 
 Plugin API 1.14.0.

package/PLUGIN-GUIDE.md

@@ -1,6 +1,6 @@
 # Termix plugin guide
 
-SDK 1.0.24 | Plugin API 1.14.0
+SDK 1.0.25 | Plugin API 1.14.0
 
 This guide is for anyone, person or AI coding tool, building a Termix plugin. It ships inside
 `@termix-ssh/plugin-sdk`, so the copy in your `node_modules` always matches the SDK you have installed.

package/dist/host/{PluginsTab-MNQU5OJ3.js → PluginsTab-NT64NFPK.js}

@@ -29,7 +29,7 @@ import {
   sortPlugins,
   uploadEntry,
   youtubeEmbedUrl
-} from "./chunk-C52NRTA6.js";
+} from "./chunk-ENDXPKBA.js";
 import {
   Button,
   FakeSwitch,
@@ -37,7 +37,7 @@ import {
   PluginIcon,
   SectionCard,
   hasSettingsPage
-} from "./chunk-IMPLAAUM.js";
+} from "./chunk-WAPKSDXJ.js";
 import {
   ArrowDownWideNarrow,
   BookOpen,
@@ -109,8 +109,8 @@ import {
   updatePlugin,
   uploadPlugin,
   useConfirm
-} from "./chunk-DN6YKMFJ.js";
-import "./chunk-6WLECSNB.js";
+} from "./chunk-GVJBUCYJ.js";
+import "./chunk-DUOTWQ4Y.js";
 import {
   __toESM,
   define_import_meta_env_default,

package/dist/host/{chunk-GRH7GSKG.js → chunk-D45W5IDI.js}

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

package/dist/host/{chunk-6WLECSNB.js → chunk-DUOTWQ4Y.js}

@@ -5196,7 +5196,8 @@ var TRAY_TRIGGERS = [
 var HOST_CLICK_BEHAVIORS = [
   "newTab",
   "focusExisting",
-  "focusExistingDoubleClickNew"
+  "focusExistingDoubleClickNew",
+  "hostPage"
 ];
 var STATUS_COLOR_SCHEMES = ["accent", "status"];
 var FILTER_STATUS = [
@@ -5715,12 +5716,13 @@ async function revokeAllUserSessions(userId) {
     handleApiError(error, "revoke all user sessions");
   }
 }
-async function createApiKey(name, userId, expiresAt) {
+async function createApiKey(name, userId, expiresAt, scopes) {
   try {
     const response = await authApi.post("/users/api-keys", {
       name,
       userId,
-      expiresAt: expiresAt ?? null
+      expiresAt: expiresAt ?? null,
+      scopes: scopes?.length ? scopes : null
     });
     return response.data;
   } catch (error) {
@@ -6340,7 +6342,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-FLQAN6I7.js");
+      const { notifyPermissionsChanged } = await import("./use-permissions-MHDIU67P.js");
       notifyPermissionsChanged();
     }
     return response.data;
@@ -6947,7 +6949,7 @@ function createRemoteOriginApiInstance(path) {
   });
   instance.interceptors.request.use(
     async (config) => {
-      const { getLinkedSession: getLinkedSession2 } = await import("./linked-server-YCAJ2NX3.js");
+      const { getLinkedSession: getLinkedSession2 } = await import("./linked-server-2HT4BRH4.js");
       const linked = await getLinkedSession2();
       config.baseURL = linked ? `${linked.serverUrl}${path}` : "http://no-server-configured";
       if (config.headers.set) {

package/dist/host/{chunk-C52NRTA6.js → chunk-ENDXPKBA.js}

@@ -1,7 +1,7 @@
 const __termixNoGlob = () => ({});
 import {
   Button
-} from "./chunk-IMPLAAUM.js";
+} from "./chunk-WAPKSDXJ.js";
 import {
   ChevronRight,
   PANEL,
@@ -10,10 +10,10 @@ import {
   cn,
   gridSizeStyle,
   useAreaPreferences
-} from "./chunk-DN6YKMFJ.js";
+} from "./chunk-GVJBUCYJ.js";
 import {
   isElectron
-} from "./chunk-6WLECSNB.js";
+} from "./chunk-DUOTWQ4Y.js";
 import {
   __commonJS,
   __toESM,

package/dist/host/{chunk-5W6F6GJJ.js → chunk-GTTGPAMQ.js}

@@ -3,7 +3,7 @@ import {
   hasPermission,
   resetPermissionsCache,
   usePermissions
-} from "./chunk-GRH7GSKG.js";
+} from "./chunk-D45W5IDI.js";
 import {
   Columns2,
   KeyRound,
@@ -51,7 +51,7 @@ import {
   withIconBoundary,
   withPluginContext,
   withPluginScope
-} from "./chunk-DN6YKMFJ.js";
+} from "./chunk-GVJBUCYJ.js";
 import {
   SYNC_CHANGED_EVENT,
   TRUST_TOKEN_KEY,
@@ -99,7 +99,7 @@ import {
   usePluginStore,
   useTabTypes,
   websocketAuthProtocols
-} from "./chunk-6WLECSNB.js";
+} from "./chunk-DUOTWQ4Y.js";
 import {
   init_define_import_meta_env
 } from "./chunk-YGYBM7SQ.js";
@@ -1405,6 +1405,7 @@ var en_default = {
     hostClickBehavior: "Clicking a host",
     hostClickBehaviorDesc: 'What happens when you click a host that already has an open tab. Ctrl/Cmd click, middle click, or "Open in new tab" always start a new one.',
     hostClickNewTab: "Always open a new tab",
+    hostClickHostPage: "Open the host page, when a plugin offers one",
     hostClickFocusExisting: "Switch to the open tab",
     hostClickFocusExistingDoubleNew: "Click to switch, double click for a new tab",
     openInNewTab: "Open in new tab",

package/dist/host/{chunk-DN6YKMFJ.js → chunk-GVJBUCYJ.js}

@@ -4,7 +4,7 @@ import {
   getPluginRecord,
   rbacApi,
   usePluginStore
-} from "./chunk-6WLECSNB.js";
+} from "./chunk-DUOTWQ4Y.js";
 import {
   __export,
   init_define_import_meta_env

package/dist/host/{chunk-RWFXGG4Q.js → chunk-KAOL7264.js}

@@ -15,10 +15,10 @@ import {
   useCompanionState,
   useIsMobile,
   useSettingsComponents
-} from "./chunk-5W6F6GJJ.js";
+} from "./chunk-GTTGPAMQ.js";
 import {
   usePermissions
-} from "./chunk-GRH7GSKG.js";
+} from "./chunk-D45W5IDI.js";
 import {
   Button,
   DefaultsOnly,
@@ -30,7 +30,7 @@ import {
   SettingRow,
   hasVisibleFields,
   isFieldShown
-} from "./chunk-IMPLAAUM.js";
+} from "./chunk-WAPKSDXJ.js";
 import {
   ArrowDownToLine,
   ArrowLeftToLine,
@@ -61,12 +61,12 @@ import {
   pluginKey,
   pluginName,
   usePluginScope
-} from "./chunk-DN6YKMFJ.js";
+} from "./chunk-GVJBUCYJ.js";
 import {
   getTabType,
   unregisteredViewStatus,
   usePluginStore
-} from "./chunk-6WLECSNB.js";
+} from "./chunk-DUOTWQ4Y.js";
 import {
   init_define_import_meta_env
 } from "./chunk-YGYBM7SQ.js";
@@ -1321,7 +1321,7 @@ function CompanionLayout({
 // src/ui/shell/tabUtils.tsx
 import { jsx as jsx9, jsxs as jsxs7 } from "react/jsx-runtime";
 var PluginsTab = lazy(
-  () => import("./PluginsTab-MNQU5OJ3.js").then((m) => ({ default: m.PluginsTab }))
+  () => import("./PluginsTab-NT64NFPK.js").then((m) => ({ default: m.PluginsTab }))
 );
 function preloadTabSurface(type) {
   const loader = getTabType(type)?.preload;

package/dist/host/{chunk-EKXGDM5P.js → chunk-QGWRLGQB.js}

@@ -1,7 +1,7 @@
 const __termixNoGlob = () => ({});
 import {
   useTheme
-} from "./chunk-5W6F6GJJ.js";
+} from "./chunk-GTTGPAMQ.js";
 import {
   init_define_import_meta_env
 } from "./chunk-YGYBM7SQ.js";

package/dist/host/{chunk-IMPLAAUM.js → chunk-WAPKSDXJ.js}

@@ -9,7 +9,7 @@ import {
   icons_exports,
   isFieldActive,
   usePluginScope
-} from "./chunk-DN6YKMFJ.js";
+} from "./chunk-GVJBUCYJ.js";
 import {
   init_define_import_meta_env
 } from "./chunk-YGYBM7SQ.js";

package/dist/host/frame-host.js

@@ -1,7 +1,7 @@
 const __termixNoGlob = () => ({});
 import {
   Toaster
-} from "./chunk-EKXGDM5P.js";
+} from "./chunk-QGWRLGQB.js";
 import {
   ThemeProvider,
   createPluginApp,
@@ -12,8 +12,8 @@ import {
   setPluginThemes,
   sshHostToHost,
   useTheme
-} from "./chunk-5W6F6GJJ.js";
-import "./chunk-GRH7GSKG.js";
+} from "./chunk-GTTGPAMQ.js";
+import "./chunk-D45W5IDI.js";
 import {
   SurfaceScope,
   notifyShellReady,
@@ -21,13 +21,13 @@ import {
   setShellCallbacks,
   setShellHosts,
   shellHost
-} from "./chunk-DN6YKMFJ.js";
+} from "./chunk-GVJBUCYJ.js";
 import {
   getSSHHosts,
   getTabType,
   setFrontendState,
   setPluginSummaries
-} from "./chunk-6WLECSNB.js";
+} from "./chunk-DUOTWQ4Y.js";
 import {
   init_define_import_meta_env
 } from "./chunk-YGYBM7SQ.js";

package/dist/host/{linked-server-YCAJ2NX3.js → linked-server-2HT4BRH4.js}

@@ -4,7 +4,7 @@ import {
   getLinkedSession,
   notifySyncChanged,
   useDesktopLinked
-} from "./chunk-6WLECSNB.js";
+} from "./chunk-DUOTWQ4Y.js";
 import "./chunk-YGYBM7SQ.js";
 export {
   SYNC_CHANGED_EVENT,

package/dist/host/{rbac-api-A64TXDL5.js → rbac-api-NXDICNA4.js}

@@ -25,7 +25,7 @@ import {
   shareHost,
   updateHostAccess,
   updateRole
-} from "./chunk-6WLECSNB.js";
+} from "./chunk-DUOTWQ4Y.js";
 import "./chunk-YGYBM7SQ.js";
 export {
   assignRoleToUser,

package/dist/host/testing-host.js

@@ -7,7 +7,7 @@ import {
   PluginViewPlaceholder,
   renderTabContent,
   trackTabHandle
-} from "./chunk-RWFXGG4Q.js";
+} from "./chunk-KAOL7264.js";
 import {
   RAIL_ITEMS,
   ServerStatusProvider,
@@ -63,11 +63,11 @@ import {
   setRemoteServerUrlForTesting,
   useShellController,
   useTabStageStore
-} from "./chunk-5W6F6GJJ.js";
+} from "./chunk-GTTGPAMQ.js";
 import {
   setPermissionsForTesting
-} from "./chunk-GRH7GSKG.js";
-import "./chunk-IMPLAAUM.js";
+} from "./chunk-D45W5IDI.js";
+import "./chunk-WAPKSDXJ.js";
 import {
   SurfaceScope,
   notifyShellReady,
@@ -75,14 +75,14 @@ import {
   setShellCallbacks,
   setShellHosts,
   setShellLayoutProvider
-} from "./chunk-DN6YKMFJ.js";
+} from "./chunk-GVJBUCYJ.js";
 import {
   getTabType,
   listTabTypes,
   resetPluginStore,
   setFrontendState,
   setPluginSummaries
-} from "./chunk-6WLECSNB.js";
+} from "./chunk-DUOTWQ4Y.js";
 import {
   init_define_import_meta_env
 } from "./chunk-YGYBM7SQ.js";

package/dist/host/types/src/types/host-sidebar-preferences.d.ts

@@ -18,7 +18,7 @@ export type HostGroupKey = "folder" | "tag" | "status" | "protocol" | "auth";
 export type HostDensity = "comfortable" | "compact";
 export type HostTrayTrigger = "always" | "hover" | "click" | "actionsOnly";
 /** What clicking a host does when it already has an open tab. */
-export type HostClickBehavior = "newTab" | "focusExisting" | "focusExistingDoubleClickNew";
+export type HostClickBehavior = "newTab" | "focusExisting" | "focusExistingDoubleClickNew" | "hostPage";
 export interface HostSidebarFilterState {
     status: ("online" | "offline" | "pinned")[];
     /** SSH auth type ids; plugins add their own. */

package/dist/host/types/src/ui/api/user-management-api.d.ts

@@ -42,11 +42,13 @@ export interface ApiKey {
     expiresAt: string | null;
     lastUsedAt: string | null;
     isActive: boolean;
+    /** Null for full access. */
+    scopes?: string[] | null;
 }
 export interface CreatedApiKey extends ApiKey {
     token: string;
 }
-export declare function createApiKey(name: string, userId: string, expiresAt?: string): Promise<CreatedApiKey>;
+export declare function createApiKey(name: string, userId: string, expiresAt?: string, scopes?: string[] | null): Promise<CreatedApiKey>;
 export declare function getApiKeys(): Promise<{
     apiKeys: ApiKey[];
 }>;

package/dist/host/ui.js

@@ -22,10 +22,10 @@ import {
   useInstalledPlugins,
   usePluginHostSections,
   useTabHandlesVersion
-} from "./chunk-RWFXGG4Q.js";
+} from "./chunk-KAOL7264.js";
 import {
   Toaster
-} from "./chunk-EKXGDM5P.js";
+} from "./chunk-QGWRLGQB.js";
 import {
   ACCENT_PRESET_COLORS,
   BUILTIN_THEMES,
@@ -170,10 +170,10 @@ import {
   useThemes,
   verifySecondFactor,
   withProtocolSettings
-} from "./chunk-5W6F6GJJ.js";
+} from "./chunk-GTTGPAMQ.js";
 import {
   usePermissions
-} from "./chunk-GRH7GSKG.js";
+} from "./chunk-D45W5IDI.js";
 import {
   AddButton,
   Card,
@@ -194,7 +194,7 @@ import {
   isPrerelease,
   reportBetaFeedbackUrl,
   reportCoreIssueUrl
-} from "./chunk-C52NRTA6.js";
+} from "./chunk-ENDXPKBA.js";
 import {
   Button,
   DefaultsOnly,
@@ -211,7 +211,7 @@ import {
   hasVisibleFields,
   isFieldShown,
   useIsDefaultsEditor
-} from "./chunk-IMPLAAUM.js";
+} from "./chunk-WAPKSDXJ.js";
 import {
   Action,
   Activity,
@@ -386,7 +386,7 @@ import {
   useSurfaceKind,
   useUiPreference,
   useUiPreferencesContext
-} from "./chunk-DN6YKMFJ.js";
+} from "./chunk-GVJBUCYJ.js";
 import {
   CREDENTIAL_ROW_FIELD_KEYS,
   PRESETS,
@@ -549,7 +549,7 @@ import {
   useTabs,
   useTabsSafe,
   verifyPasswordResetCode
-} from "./chunk-6WLECSNB.js";
+} from "./chunk-DUOTWQ4Y.js";
 import {
   define_import_meta_env_default,
   init_define_import_meta_env

package/dist/host/{use-permissions-FLQAN6I7.js → use-permissions-MHDIU67P.js}

@@ -7,7 +7,7 @@ import {
   resetPermissionsCache,
   setPermissionsForTesting,
   usePermissions
-} from "./chunk-GRH7GSKG.js";
+} from "./chunk-D45W5IDI.js";
 import "./chunk-YGYBM7SQ.js";
 export {
   hasPermission,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@termix-ssh/plugin-sdk",
-  "version": "1.0.24",
+  "version": "1.0.25",
   "description": "The contract between Termix core and a plugin: types, the capability catalog and the manifest schema.",
   "license": "Apache-2.0",
   "repository": {