@harborclient/core 0.1.1

package/dist/network/executeHttpSend.js

@@ -0,0 +1,60 @@
+import { applyUserAgentHeader, DEFAULT_USER_AGENT } from '../userAgent';
+import { QueryString, Requester } from '@harborclient/http';
+/**
+ * Returns the current general settings regardless of provider form.
+ *
+ * @param settings - Settings provider or already-resolved general settings.
+ * @returns Normalized general settings for the requester.
+ */
+function resolveGeneralSettings(settings) {
+    return 'getGeneralSettings' in settings ? settings.getGeneralSettings() : settings;
+}
+/**
+ * Executes an HTTP request through the portable HarborClient HTTP stack.
+ *
+ * The caller injects persistence and plugin behavior so the engine has no
+ * dependency on Electron or application-level singletons.
+ *
+ * @param req - Outbound request payload.
+ * @param dependencies - Host-provided settings, cookie jar, and plugin hooks.
+ * @param signal - Optional abort signal for cancellation.
+ * @returns HTTP response metadata and body.
+ */
+export async function executeHttpSend(req, dependencies, signal) {
+    const general = resolveGeneralSettings(dependencies.settings);
+    const withUserAgent = {
+        ...req,
+        headers: applyUserAgentHeader(req.headers, {
+            general: general.userAgent || DEFAULT_USER_AGENT
+        })
+    };
+    const hookedRequest = dependencies.pluginHooks?.beforeSend
+        ? await dependencies.pluginHooks.beforeSend(withUserAgent)
+        : withUserAgent;
+    const url = new QueryString().buildUrl(hookedRequest.url, hookedRequest.params);
+    const cookieHeader = dependencies.cookieJar.buildCookieHeader(url) ?? undefined;
+    const result = await new Requester().executeRequest(hookedRequest, general, signal, cookieHeader);
+    if (result.request?.url) {
+        dependencies.cookieJar.captureSetCookies(result.request.url, result.setCookieHeaders);
+    }
+    if (!result.error && dependencies.pluginHooks?.afterSend) {
+        const pluginResponse = {
+            status: result.status,
+            statusText: result.statusText,
+            headers: result.headers,
+            body: result.body
+        };
+        await dependencies.pluginHooks.afterSend(hookedRequest, pluginResponse);
+    }
+    return result;
+}
+/**
+ * Returns whether scripts may initiate outbound HTTP under supplied settings.
+ *
+ * @param settings - Settings provider or already-resolved general settings.
+ * @returns True when hc.sendRequest is allowed.
+ */
+export function isScriptNetworkAllowed(settings) {
+    return resolveGeneralSettings(settings).allowScriptNetworkRequests === true;
+}
+//# sourceMappingURL=executeHttpSend.js.map

package/dist/network/executeHttpSend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeHttpSend.js","sourceRoot":"","sources":["../../src/network/executeHttpSend.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAsB5D;;;;;GAKG;AACH,SAAS,sBAAsB,CAAC,QAA4C;IAC1E,OAAO,oBAAoB,IAAI,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;AACrF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAqB,EACrB,YAAyC,EACzC,MAAoB;IAEpB,MAAM,OAAO,GAAG,sBAAsB,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC9D,MAAM,aAAa,GAAqB;QACtC,GAAG,GAAG;QACN,OAAO,EAAE,oBAAoB,CAAC,GAAG,CAAC,OAAO,EAAE;YACzC,OAAO,EAAE,OAAO,CAAC,SAAS,IAAI,kBAAkB;SACjD,CAAC;KACH,CAAC;IACF,MAAM,aAAa,GAAG,YAAY,CAAC,WAAW,EAAE,UAAU;QACxD,CAAC,CAAC,MAAM,YAAY,CAAC,WAAW,CAAC,UAAU,CAAC,aAAa,CAAC;QAC1D,CAAC,CAAC,aAAa,CAAC;IAClB,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChF,MAAM,YAAY,GAAG,YAAY,CAAC,SAAS,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC;IAChF,MAAM,MAAM,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC,cAAc,CAAC,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;IAClG,IAAI,MAAM,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC;QACxB,YAAY,CAAC,SAAS,CAAC,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACxF,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,YAAY,CAAC,WAAW,EAAE,SAAS,EAAE,CAAC;QACzD,MAAM,cAAc,GAAuB;YACzC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC;QACF,MAAM,YAAY,CAAC,WAAW,CAAC,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAA4C;IACjF,OAAO,sBAAsB,CAAC,QAAQ,CAAC,CAAC,0BAA0B,KAAK,IAAI,CAAC;AAC9E,CAAC"}

package/dist/pageSidebarSection.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Stable keys for page tabs that use a sidebar section picker.
+ */
+export type PageSidebarKey = 'settings' | 'plugins' | 'themes' | 'sharing-keys' | 'snippets';
+/**
+ * Returns whether a value is a supported page sidebar storage key.
+ *
+ * @param value - Candidate key from persisted storage or IPC.
+ * @returns True when the key identifies a sidebar-backed page tab.
+ */
+export declare function isPageSidebarKey(value: unknown): value is PageSidebarKey;
+/**
+ * Normalizes a page sidebar storage key.
+ *
+ * @param value - Candidate key from persisted storage or IPC.
+ * @returns Valid page key or null when unrecognized.
+ */
+export declare function normalizePageSidebarKey(value: unknown): PageSidebarKey | null;
+/**
+ * Returns whether a section id is valid for the given page sidebar key.
+ *
+ * @param key - Page sidebar storage key.
+ * @param section - Candidate section id.
+ * @returns True when the section is allowed for the page.
+ */
+export declare function isAllowedPageSidebarSection(key: PageSidebarKey, section: string): boolean;
+/**
+ * Normalizes a persisted sidebar section for a page key.
+ *
+ * @param key - Page sidebar storage key.
+ * @param value - Candidate section from persisted storage.
+ * @returns Valid section id or null when invalid for the page.
+ */
+export declare function normalizePageSidebarSection(key: PageSidebarKey, value: unknown): string | null;
+//# sourceMappingURL=pageSidebarSection.d.ts.map

package/dist/pageSidebarSection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageSidebarSection.d.ts","sourceRoot":"","sources":["../src/pageSidebarSection.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,cAAc,GAAG,UAAU,CAAC;AA8B7F;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAE7E;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAazF;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAM9F"}

package/dist/pageSidebarSection.js

@@ -0,0 +1,76 @@
+const PAGE_SIDEBAR_KEYS = new Set([
+    'settings',
+    'plugins',
+    'themes',
+    'sharing-keys',
+    'snippets'
+]);
+const SETTINGS_BUILTIN_SECTIONS = new Set([
+    'general',
+    'syntax',
+    'storage',
+    'shortcuts',
+    'proxy',
+    'globals',
+    'ai',
+    'backup-restore',
+    'git'
+]);
+const PLUGINS_SECTIONS = new Set(['installed', 'marketplace', 'install', 'settings']);
+const THEMES_SECTIONS = new Set(['installed', 'marketplace', 'install']);
+const SHARING_KEYS_SECTIONS = new Set(['identity', 'trusted']);
+const SNIPPETS_SECTIONS = new Set(['installed', 'marketplace', 'install']);
+/**
+ * Returns whether a value is a supported page sidebar storage key.
+ *
+ * @param value - Candidate key from persisted storage or IPC.
+ * @returns True when the key identifies a sidebar-backed page tab.
+ */
+export function isPageSidebarKey(value) {
+    return typeof value === 'string' && PAGE_SIDEBAR_KEYS.has(value);
+}
+/**
+ * Normalizes a page sidebar storage key.
+ *
+ * @param value - Candidate key from persisted storage or IPC.
+ * @returns Valid page key or null when unrecognized.
+ */
+export function normalizePageSidebarKey(value) {
+    return isPageSidebarKey(value) ? value : null;
+}
+/**
+ * Returns whether a section id is valid for the given page sidebar key.
+ *
+ * @param key - Page sidebar storage key.
+ * @param section - Candidate section id.
+ * @returns True when the section is allowed for the page.
+ */
+export function isAllowedPageSidebarSection(key, section) {
+    switch (key) {
+        case 'settings':
+            return SETTINGS_BUILTIN_SECTIONS.has(section) || section.startsWith('plugin:');
+        case 'plugins':
+            return PLUGINS_SECTIONS.has(section);
+        case 'themes':
+            return THEMES_SECTIONS.has(section);
+        case 'sharing-keys':
+            return SHARING_KEYS_SECTIONS.has(section);
+        case 'snippets':
+            return SNIPPETS_SECTIONS.has(section);
+    }
+}
+/**
+ * Normalizes a persisted sidebar section for a page key.
+ *
+ * @param key - Page sidebar storage key.
+ * @param value - Candidate section from persisted storage.
+ * @returns Valid section id or null when invalid for the page.
+ */
+export function normalizePageSidebarSection(key, value) {
+    if (typeof value !== 'string' || value.trim() === '') {
+        return null;
+    }
+    const section = value.trim();
+    return isAllowedPageSidebarSection(key, section) ? section : null;
+}
+//# sourceMappingURL=pageSidebarSection.js.map

package/dist/pageSidebarSection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageSidebarSection.js","sourceRoot":"","sources":["../src/pageSidebarSection.ts"],"names":[],"mappings":"AAKA,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAiB;IAChD,UAAU;IACV,SAAS;IACT,QAAQ;IACR,cAAc;IACd,UAAU;CACX,CAAC,CAAC;AAEH,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAS;IAChD,SAAS;IACT,QAAQ;IACR,SAAS;IACT,WAAW;IACX,OAAO;IACP,SAAS;IACT,IAAI;IACJ,gBAAgB;IAChB,KAAK;CACN,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAS,CAAC,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;AAE9F,MAAM,eAAe,GAAG,IAAI,GAAG,CAAS,CAAC,WAAW,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC;AAEjF,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAS,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;AAEvE,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAS,CAAC,WAAW,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,iBAAiB,CAAC,GAAG,CAAC,KAAuB,CAAC,CAAC;AACrF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CAAC,GAAmB,EAAE,OAAe;IAC9E,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,UAAU;YACb,OAAO,yBAAyB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACjF,KAAK,SAAS;YACZ,OAAO,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,KAAK,QAAQ;YACX,OAAO,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtC,KAAK,cAAc;YACjB,OAAO,qBAAqB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5C,KAAK,UAAU;YACb,OAAO,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CAAC,GAAmB,EAAE,KAAc;IAC7E,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,2BAA2B,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AACpE,CAAC"}

package/dist/parseJson.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Parses a JSON string, returning a fallback value on failure or when empty.
+ *
+ * @param value - JSON string to parse.
+ * @param fallback - Value returned when parsing fails or value is empty.
+ */
+export declare function parseJson<T>(value: string | undefined | null, fallback: T): T;
+//# sourceMappingURL=parseJson.d.ts.map

package/dist/parseJson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseJson.d.ts","sourceRoot":"","sources":["../src/parseJson.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAO7E"}

package/dist/parseJson.js

@@ -0,0 +1,17 @@
+/**
+ * Parses a JSON string, returning a fallback value on failure or when empty.
+ *
+ * @param value - JSON string to parse.
+ * @param fallback - Value returned when parsing fails or value is empty.
+ */
+export function parseJson(value, fallback) {
+    if (!value)
+        return fallback;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return fallback;
+    }
+}
+//# sourceMappingURL=parseJson.js.map

package/dist/parseJson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseJson.js","sourceRoot":"","sources":["../src/parseJson.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAI,KAAgC,EAAE,QAAW;IACxE,IAAI,CAAC,KAAK;QAAE,OAAO,QAAQ,CAAC;IAC5B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAM,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/plugin/catalog.d.ts

@@ -0,0 +1,229 @@
+import { z } from 'zod';
+/**
+ * Public URL of the generated plugin catalog served from harborclient.com.
+ */
+export declare const PLUGIN_CATALOG_URL = "https://harborclient.com/plugin_catalog.json";
+/**
+ * Public URL of the generated theme catalog served from harborclient.com.
+ */
+export declare const THEME_CATALOG_URL = "https://harborclient.com/theme_catalog.json";
+/**
+ * Public URL of the official HarborClient plugin signing key served from harborclient.com.
+ */
+export declare const PLUGIN_SIGNING_PUBLIC_KEY_URL = "https://harborclient.com/plugins/harborclient.key";
+/**
+ * Public URL of the trusted plugin signing key registry served from harborclient.com.
+ */
+export declare const PLUGIN_TRUSTED_KEYS_URL = "https://harborclient.com/plugins/trusted.json";
+declare const catalogThemeContributionSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    type: z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+        "high-contrast": "high-contrast";
+    }>;
+}, z.core.$strip>;
+/**
+ * One theme contribution copied from manifest.contributes.themes into the marketplace catalog.
+ */
+export type CatalogThemeContribution = z.infer<typeof catalogThemeContributionSchema>;
+/**
+ * Zod schema for one curated plugin or theme marketplace listing.
+ */
+export declare const pluginCatalogEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    version: z.ZodString;
+    summary: z.ZodString;
+    author: z.ZodString;
+    categories: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<("light" | "dark" | "high-contrast" | "sidebar" | "auth" | "requests" | "import" | "themes" | "environments" | "scripting" | "logging" | "jwt" | "response" | "collections" | "editor" | "testing" | "export" | "graphql" | "websocket" | "mock" | "debugging" | "security" | "utilities")[], string[]>>;
+    repoUrl: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    ref: z.ZodOptional<z.ZodString>;
+    homepage: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    screenshot: z.ZodOptional<z.ZodString>;
+    screenshots: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    description: z.ZodOptional<z.ZodString>;
+    minAppVersion: z.ZodOptional<z.ZodString>;
+    contributes: z.ZodOptional<z.ZodObject<{
+        themes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            type: z.ZodEnum<{
+                light: "light";
+                dark: "dark";
+                "high-contrast": "high-contrast";
+            }>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Zod schema for the plugin marketplace catalog document.
+ */
+export declare const pluginCatalogSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    plugins: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        version: z.ZodString;
+        summary: z.ZodString;
+        author: z.ZodString;
+        categories: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<("light" | "dark" | "high-contrast" | "sidebar" | "auth" | "requests" | "import" | "themes" | "environments" | "scripting" | "logging" | "jwt" | "response" | "collections" | "editor" | "testing" | "export" | "graphql" | "websocket" | "mock" | "debugging" | "security" | "utilities")[], string[]>>;
+        repoUrl: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        ref: z.ZodOptional<z.ZodString>;
+        homepage: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodString>;
+        screenshot: z.ZodOptional<z.ZodString>;
+        screenshots: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        description: z.ZodOptional<z.ZodString>;
+        minAppVersion: z.ZodOptional<z.ZodString>;
+        contributes: z.ZodOptional<z.ZodObject<{
+            themes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                type: z.ZodEnum<{
+                    light: "light";
+                    dark: "dark";
+                    "high-contrast": "high-contrast";
+                }>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Zod schema for the theme marketplace catalog document.
+ */
+export declare const themeCatalogSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    themes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        version: z.ZodString;
+        summary: z.ZodString;
+        author: z.ZodString;
+        categories: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<("light" | "dark" | "high-contrast" | "sidebar" | "auth" | "requests" | "import" | "themes" | "environments" | "scripting" | "logging" | "jwt" | "response" | "collections" | "editor" | "testing" | "export" | "graphql" | "websocket" | "mock" | "debugging" | "security" | "utilities")[], string[]>>;
+        repoUrl: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        ref: z.ZodOptional<z.ZodString>;
+        homepage: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodString>;
+        screenshot: z.ZodOptional<z.ZodString>;
+        screenshots: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        description: z.ZodOptional<z.ZodString>;
+        minAppVersion: z.ZodOptional<z.ZodString>;
+        contributes: z.ZodOptional<z.ZodObject<{
+            themes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                type: z.ZodEnum<{
+                    light: "light";
+                    dark: "dark";
+                    "high-contrast": "high-contrast";
+                }>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * One curated plugin listing in the marketplace catalog.
+ */
+export type PluginCatalogEntry = z.infer<typeof pluginCatalogEntrySchema>;
+/**
+ * Parsed plugin marketplace catalog returned by the build script and app fetch.
+ */
+export type PluginCatalog = {
+    schemaVersion: 1;
+    plugins: PluginCatalogEntry[];
+    updatedAt?: string;
+};
+/**
+ * Parsed theme marketplace catalog returned by the build script and app fetch.
+ */
+export type ThemeCatalog = {
+    schemaVersion: 1;
+    themes: PluginCatalogEntry[];
+    updatedAt?: string;
+};
+/**
+ * Parses and validates a plugin catalog payload.
+ *
+ * @param raw - Unknown JSON value from disk or an HTTP response.
+ * @returns Validated catalog with unique plugin ids.
+ * @throws When the payload is invalid or contains duplicate ids.
+ */
+export declare function parsePluginCatalog(raw: unknown): PluginCatalog;
+/**
+ * Parses and validates a theme catalog payload.
+ *
+ * @param raw - Unknown JSON value from disk or an HTTP response.
+ * @returns Validated catalog with unique theme plugin ids.
+ * @throws When the payload is invalid or contains duplicate ids.
+ */
+export declare function parseThemeCatalog(raw: unknown): ThemeCatalog;
+declare const pluginTrustedKeyEntrySchema: z.ZodObject<{
+    author: z.ZodString;
+    key: z.ZodString;
+}, z.core.$strip>;
+/**
+ * One trusted plugin signing key URL entry from trusted.json.
+ */
+export type PluginTrustedKeyEntry = z.infer<typeof pluginTrustedKeyEntrySchema>;
+/**
+ * Parsed trusted plugin signing key registry.
+ */
+export type PluginTrustedKeys = PluginTrustedKeyEntry[];
+/**
+ * Parses and validates a trusted plugin signing key registry payload.
+ *
+ * @param raw - Unknown JSON value from disk or an HTTP response.
+ * @returns Validated trusted key entries with unique key URLs.
+ * @throws When the payload is invalid or contains duplicate key URLs.
+ */
+export declare function parsePluginTrustedKeys(raw: unknown): PluginTrustedKeys;
+declare const pluginSourceSchema: z.ZodObject<{
+    url: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    enabled: z.ZodBoolean;
+}, z.core.$strip>;
+/**
+ * Zod schema for persisted plugin catalog and trusted-key source settings.
+ */
+export declare const pluginSourcesSchema: z.ZodObject<{
+    catalogs: z.ZodArray<z.ZodObject<{
+        url: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        enabled: z.ZodBoolean;
+    }, z.core.$strip>>;
+    trusted: z.ZodArray<z.ZodObject<{
+        url: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        enabled: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * One configurable remote endpoint for plugin catalogs or trusted publisher keys.
+ */
+export type PluginSource = z.infer<typeof pluginSourceSchema>;
+/**
+ * User-configured plugin catalog and trusted-key registry endpoints.
+ */
+export type PluginSourcesSettings = z.infer<typeof pluginSourcesSchema>;
+/**
+ * Returns the built-in HarborClient catalog and trusted-key endpoints, enabled by default.
+ *
+ * @returns Default plugin source settings with HarborClient URLs first in each list.
+ */
+export declare function getDefaultPluginSources(): PluginSourcesSettings;
+/**
+ * Normalizes persisted plugin source settings with trimmed URLs and deduplication.
+ *
+ * @param raw - Unknown settings from storage or user input.
+ * @returns Validated settings, or defaults when both lists are empty after normalization.
+ */
+export declare function normalizePluginSources(raw: unknown): PluginSourcesSettings;
+/**
+ * Returns whether a plugin source URL is hosted on harborclient.com or a subdomain.
+ *
+ * @param url - Catalog or trusted registry URL to inspect.
+ * @returns True when the hostname is harborclient.com or ends with .harborclient.com.
+ */
+export declare function isHarborClientEndpoint(url: string): boolean;
+export {};
+//# sourceMappingURL=catalog.d.ts.map

package/dist/plugin/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/plugin/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,kBAAkB,iDAAiD,CAAC;AAEjF;;GAEG;AACH,eAAO,MAAM,iBAAiB,gDAAgD,CAAC;AAE/E;;GAEG;AACH,eAAO,MAAM,6BAA6B,sDAAsD,CAAC;AAEjG;;GAEG;AACH,eAAO,MAAM,uBAAuB,kDAAkD,CAAC;AAsCvF,QAAA,MAAM,8BAA8B;;;;;;;;iBAIlC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwBnC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG7B,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,aAAa,EAAE,CAAC,CAAC;IACjB,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,aAAa,EAAE,CAAC,CAAC;IACjB,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAY9D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CAY5D;AAED,QAAA,MAAM,2BAA2B;;;iBAG/B,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,EAAE,CAAC;AAExD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,iBAAiB,CAYtE;AAwBD,QAAA,MAAM,kBAAkB;;;iBAGtB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;iBAG9B,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAExE;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,qBAAqB,CAK/D;AAuBD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,qBAAqB,CAc1E;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO3D"}