plugin.ts: Add homepageURL to plugin and application

Author: nhooyr

src/node/plugin.ts

@@ -72,6 +72,7 @@ export class PluginAPI {
               displayName: p.displayName,
               description: p.description,
               routerPath: p.routerPath,
+              homepageURL: p.homepageURL,
             },
           }
         }),
@@ -197,6 +198,9 @@ export class PluginAPI {
     if (!p.routerPath) {
       throw new Error("plugin missing router path")
     }
+    if (!p.homepageURL) {
+      throw new Error("plugin missing homepage")
+    }
 
     p.init({
       logger: logger,

test/plugin.test.ts

@@ -22,6 +22,7 @@ describe("plugin", () => {
 
           description: "This app does XYZ.",
           iconPath: "/test-plugin/test-app/icon.svg",
+          homepageURL: "https://example.com",
           path: "/test-plugin/test-app",
 
           plugin: {
@@ -32,6 +33,7 @@ describe("plugin", () => {
             displayName: "Test Plugin",
             description: "Plugin used in code-server tests.",
             routerPath: "/test-plugin",
+            homepageURL: "https://example.com",
           },
         },
       ],

test/test-plugin/src/index.ts

@@ -4,6 +4,7 @@ import * as pluginapi from "../../../typings/pluginapi"
 
 export const displayName = "Test Plugin"
 export const routerPath = "/test-plugin"
+export const homepageURL = "https://example.com"
 export const description = "Plugin used in code-server tests."
 
 export function init(config: pluginapi.PluginConfig) {
@@ -27,6 +28,7 @@ export function applications(): pluginapi.Application[] {
       path: "/test-app",
 
       description: "This app does XYZ.",
+      homepageURL: "https://example.com",
     },
   ]
 }

typings/pluginapi.d.ts

@@ -87,6 +87,11 @@ export interface Plugin {
    */
   readonly routerPath: string
 
+  /**
+   * Link to plugin homepage.
+   */
+  readonly homepageURL: string
+
   /**
    * init is called so that the plugin may initialize itself with the config.
    */
@@ -144,4 +149,9 @@ export interface Application {
    * <code-server-root>/<plugin-path>/<app-path>/<icon-path>
    */
   readonly iconPath: string
+
+  /**
+   * Link to application homepage.
+   */
+  readonly homepageURL: string
 }