@harborclient/core 0.1.1

package/dist/plugin/types.d.ts

@@ -0,0 +1,415 @@
+import type { PluginCatalogCategory } from './catalogCategories';
+import type { ThemeSource } from '../types/settings';
+import type { ActiveTheme, AppMenu, ContextMenuTarget, ThemeColorToken, ThemeMetricToken } from '@harborclient/sdk';
+export type * from '@harborclient/sdk';
+/**
+ * Plugin capability flags declared in manifest.json and enforced at runtime.
+ */
+export type PluginPermission = 'ui' | 'storage' | 'database' | 'filesystem:pick' | 'filesystem:read' | 'filesystem:write' | 'http' | 'network' | 'ipc' | 'server' | 'mcp';
+/**
+ * Declarative UI slot entry in manifest.contributes.
+ */
+export interface ManifestContributionEntry {
+    id: string;
+    title: string;
+    /**
+     * Optional tab-bar icon name for main views (for example `server`).
+     * Ignored by contribution kinds that do not render page tabs.
+     */
+    icon?: string;
+}
+/**
+ * Screenshot entry in the plugin manifest.
+ */
+export type PluginScreenshot = string | {
+    path: string;
+    caption?: string;
+};
+/**
+ * Parsed plugin manifest.json.
+ */
+export interface PluginManifest {
+    id: string;
+    name: string;
+    version: string;
+    author?: string;
+    description?: string;
+    /** Short one-line marketplace summary shown in listings and the detail view. */
+    summary?: string;
+    /** Marketplace category slugs for discovery metadata. */
+    categories?: PluginCatalogCategory[];
+    icon?: string;
+    screenshots?: PluginScreenshot[];
+    homepage?: string;
+    bugs?: {
+        url: string;
+    };
+    engines: {
+        harborclient: string;
+    };
+    renderer?: string;
+    main?: string;
+    permissions: PluginPermission[];
+    contributes?: {
+        settingsSections?: ManifestContributionEntry[];
+        sidebarPanels?: ManifestContributionEntry[];
+        sidebarSections?: ManifestContributionEntry[];
+        mainViews?: ManifestContributionEntry[];
+        modals?: ManifestContributionEntry[];
+        requestTabs?: ManifestContributionEntry[];
+        responseTabs?: ManifestContributionEntry[];
+        collectionSettingsTabs?: ManifestContributionEntry[];
+        footerPanels?: ManifestContributionEntry[];
+        requestToolbarActions?: ManifestContributionEntry[];
+        scriptEditorActions?: ManifestContributionEntry[];
+        contextMenus?: ManifestContributionEntry[];
+        statusBarItems?: ManifestContributionEntry[];
+        themes?: Array<ManifestContributionEntry & {
+            type: 'light' | 'dark' | 'high-contrast';
+            /**
+             * Optional path to a `harborclientExport: "theme"` JSON file relative
+             * to the plugin root. When set, HarborClient loads colors and
+             * stylesheet from that file and auto-registers the theme.
+             */
+            import?: string;
+        }>;
+        commands?: ManifestContributionEntry[];
+        menus?: Array<{
+            menu: 'file' | 'edit' | 'view' | 'help';
+            command: string;
+            group?: string;
+        }>;
+    };
+}
+/**
+ * How a plugin package is loaded on disk.
+ */
+export type PluginSource = 'installed' | 'unpacked' | 'git';
+/**
+ * Git origin metadata for plugins installed from a public repository.
+ */
+export interface GitPluginOrigin {
+    url: string;
+    ref?: string;
+}
+/**
+ * Result of checking a plugin package against the trusted publisher registry.
+ */
+export type PluginSignatureStatus = 'verified' | 'unsigned' | 'untrusted' | 'invalid';
+/**
+ * Signature verification metadata attached to a discovered or installed plugin.
+ */
+export interface PluginSignatureInfo {
+    status: PluginSignatureStatus;
+    /** manifest.author the signature was checked against. */
+    author?: string;
+    /** keyId recorded in signature.json when verified. */
+    keyId?: string;
+    /** Human-readable reason for untrusted or invalid signatures. */
+    error?: string;
+}
+/**
+ * Summary of a discovered or installed plugin for Settings and IPC.
+ */
+export interface PluginInfo {
+    id: string;
+    name: string;
+    version: string;
+    source: PluginSource;
+    path: string;
+    enabled: boolean;
+    permissions: PluginPermission[];
+    manifest: PluginManifest;
+    /** Public git URL when source is `git`. */
+    repoUrl?: string;
+    /** Branch or tag ref used for the last clone when source is `git`. */
+    repoRef?: string;
+    /** Manifest or discovery failure preventing the plugin package from loading. */
+    error?: string;
+    /** Activation or runtime hook failure on an otherwise valid plugin package. */
+    runtimeError?: string;
+    /** Publisher signature verification result when available. */
+    signature?: PluginSignatureInfo;
+}
+/**
+ * Which bundled entry file to load from a plugin package.
+ */
+export type PluginEntryKind = 'renderer' | 'main';
+/**
+ * Result of reading a plugin asset or entry bundle from disk.
+ */
+export interface PluginAssetResult {
+    content: string;
+    mimeType: string;
+}
+/**
+ * Resolved theme payload from a manifest `contributes.themes[].import` JSON file.
+ *
+ * After the first read, HarborClient inlines any referenced stylesheet file into
+ * the JSON on disk so subsequent reads return CSS text rather than a filename.
+ */
+export interface ResolvedThemeImport {
+    title: string;
+    type: 'light' | 'dark' | 'high-contrast';
+    colors: Partial<Record<ThemeColorToken, string>>;
+    /**
+     * Typography and geometry token overrides without the `--mac-` prefix.
+     */
+    metrics?: Partial<Record<ThemeMetricToken, string>>;
+    /**
+     * Inlined CSS text, or undefined when the export has no stylesheet.
+     */
+    stylesheet?: string;
+}
+/**
+ * Remote plugin metadata fetched from a git repository for marketplace preview.
+ */
+export interface PluginGitPreview {
+    manifest: PluginManifest;
+    descriptionMarkdown?: string;
+    /** Resolved screenshot URLs or data URLs for marketplace preview. */
+    screenshotSrcs?: string[];
+}
+/**
+ * Registered settings section exposed to the Settings UI.
+ */
+export interface RegisteredSettingsSection {
+    pluginId: string;
+    id: string;
+    title: string;
+    /** Manifest contributes.settingsSections id used by plugin surface URLs. */
+    contributionId: string;
+}
+/**
+ * Registered plugin theme exposed to the appearance picker.
+ */
+export interface RegisteredPluginTheme {
+    pluginId: string;
+    id: string;
+    title: string;
+    type: 'light' | 'dark' | 'high-contrast';
+    colors?: Partial<Record<ThemeColorToken, string>>;
+    metrics?: Partial<Record<ThemeMetricToken, string>>;
+    stylesheet?: string;
+}
+/**
+ * Registered sidebar section contribution.
+ */
+export interface RegisteredSidebarSection {
+    pluginId: string;
+    id: string;
+    title: string;
+    order?: number;
+    contributionId: string;
+    /** Whether the section declares headerActions in the manifest. */
+    hasHeaderActions?: boolean;
+}
+/**
+ * Registered switchable sidebar panel contribution.
+ */
+export interface RegisteredSidebarPanel {
+    pluginId: string;
+    id: string;
+    title: string;
+    icon?: string;
+    order?: number;
+    contributionId: string;
+}
+/**
+ * Registered main-area overlay contribution.
+ */
+export interface RegisteredMainView {
+    pluginId: string;
+    id: string;
+    title: string;
+    contributionId: string;
+    /**
+     * Optional tab-bar icon name resolved by the host (for example `server`).
+     */
+    icon?: string;
+}
+/**
+ * Registered modal overlay contribution.
+ */
+export interface RegisteredModal {
+    pluginId: string;
+    id: string;
+    title: string;
+    contributionId: string;
+}
+/**
+ * Registered request editor tab contribution.
+ */
+export interface RegisteredRequestTab {
+    pluginId: string;
+    id: string;
+    title: string;
+    order?: number;
+    contributionId: string;
+}
+/**
+ * Registered response viewer tab contribution.
+ */
+export interface RegisteredResponseTab {
+    pluginId: string;
+    id: string;
+    title: string;
+    order?: number;
+    when?: 'always' | 'hasResponse' | 'noResponse';
+    contributionId: string;
+}
+/**
+ * Registered collection settings tab contribution.
+ */
+export interface RegisteredCollectionSettingsTab {
+    pluginId: string;
+    id: string;
+    title: string;
+    order?: number;
+    contributionId: string;
+}
+/**
+ * Registered footer slide-up panel contribution.
+ */
+export interface RegisteredFooterPanel {
+    pluginId: string;
+    id: string;
+    title: string;
+    contributionId: string;
+}
+/**
+ * Registered application menu item contribution.
+ */
+export interface RegisteredMenuItem {
+    pluginId: string;
+    menu: AppMenu;
+    command: string;
+    label?: string;
+    group?: string;
+    order?: number;
+}
+/**
+ * Registered request toolbar action contribution.
+ */
+export interface RegisteredRequestToolbarAction {
+    pluginId: string;
+    id: string;
+    title: string;
+    command: string;
+    icon?: string;
+    order?: number;
+}
+/**
+ * Registered script editor row action contribution.
+ */
+export interface RegisteredScriptEditorAction {
+    pluginId: string;
+    id: string;
+    title: string;
+    command: string;
+    icon?: string;
+    order?: number;
+    /** When set, limits the action to specific script phases. */
+    phases?: Array<'pre' | 'post'>;
+}
+/**
+ * Registered sidebar context menu item contribution.
+ */
+export interface RegisteredContextMenuItem {
+    pluginId: string;
+    id: string;
+    title: string;
+    command: string;
+    when: ContextMenuTarget | ContextMenuTarget[];
+    group?: string;
+    order?: number;
+}
+/**
+ * Registered Action menu quick-open contribution.
+ */
+export interface RegisteredAction {
+    pluginId: string;
+    namespace: string;
+    label: string;
+    commandId: string;
+}
+/**
+ * Registered footer status bar item contribution.
+ */
+export interface RegisteredStatusBarItem {
+    pluginId: string;
+    id: string;
+    alignment?: 'left' | 'right';
+    order?: number;
+    contributionId: string;
+}
+/**
+ * Serializable menu contribution pushed to the main process for menu merge.
+ */
+export interface SerializableMenuContribution {
+    pluginId: string;
+    menu: AppMenu;
+    command: string;
+    label?: string;
+    group?: string;
+    order?: number;
+}
+/**
+ * Namespaced settings section id for a plugin contribution.
+ *
+ * @param pluginId - Plugin manifest id.
+ * @param sectionId - Contribution id from manifest.contributes.settingsSections.
+ * @returns Stable section key for Settings navigation.
+ */
+export declare function pluginSettingsSectionId(pluginId: string, sectionId: string): string;
+/**
+ * Namespaced contribution id for plugin UI slots.
+ *
+ * @param pluginId - Plugin manifest id.
+ * @param contributionId - Contribution id from the manifest.
+ * @returns Stable namespaced id used as tab/section keys in the host UI.
+ */
+export declare function pluginContributionId(pluginId: string, contributionId: string): string;
+/**
+ * Parses a namespaced plugin settings section id.
+ *
+ * @param value - Settings section identifier.
+ * @returns Plugin and section ids when the value is plugin-scoped.
+ */
+export declare function parsePluginSettingsSectionId(value: string): {
+    pluginId: string;
+    sectionId: string;
+} | null;
+/**
+ * Persisted plugin theme value stored via theme:get/set.
+ *
+ * @param pluginId - Plugin manifest id.
+ * @param themeId - Theme id within the plugin.
+ * @returns Serialized theme preference string.
+ */
+export declare function formatPluginThemeValue(pluginId: string, themeId: string): string;
+/**
+ * Parses a persisted plugin theme preference.
+ *
+ * @param value - Raw theme setting from storage.
+ * @returns Plugin and theme ids when the value is plugin-scoped.
+ */
+export declare function parsePluginThemeValue(value: string): {
+    pluginId: string;
+    themeId: string;
+} | null;
+/**
+ * Converts a persisted theme preference to the plugin {@link ActiveTheme} shape.
+ *
+ * @param theme - Raw theme setting from storage or IPC.
+ * @returns Built-in or plugin-scoped active theme reference.
+ */
+export declare function toActiveTheme(theme: ThemeSource): ActiveTheme;
+/**
+ * Returns a stable string key for comparing {@link ActiveTheme} values.
+ *
+ * @param theme - Active theme reference.
+ * @returns Serialized key suitable for deduplication.
+ */
+export declare function activeThemeKey(theme: ActiveTheme): string;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/plugin/types.ts"],"names":[],"mappings":"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"}

package/dist/plugin/types.js

@@ -0,0 +1,81 @@
+/**
+ * Namespaced settings section id for a plugin contribution.
+ *
+ * @param pluginId - Plugin manifest id.
+ * @param sectionId - Contribution id from manifest.contributes.settingsSections.
+ * @returns Stable section key for Settings navigation.
+ */
+export function pluginSettingsSectionId(pluginId, sectionId) {
+    return pluginContributionId(pluginId, sectionId);
+}
+/**
+ * Namespaced contribution id for plugin UI slots.
+ *
+ * @param pluginId - Plugin manifest id.
+ * @param contributionId - Contribution id from the manifest.
+ * @returns Stable namespaced id used as tab/section keys in the host UI.
+ */
+export function pluginContributionId(pluginId, contributionId) {
+    return `plugin:${pluginId}:${contributionId}`;
+}
+/**
+ * Parses a namespaced plugin settings section id.
+ *
+ * @param value - Settings section identifier.
+ * @returns Plugin and section ids when the value is plugin-scoped.
+ */
+export function parsePluginSettingsSectionId(value) {
+    const match = /^plugin:([^:]+):([^:]+)$/.exec(value);
+    if (!match) {
+        return null;
+    }
+    return { pluginId: match[1], sectionId: match[2] };
+}
+/**
+ * Persisted plugin theme value stored via theme:get/set.
+ *
+ * @param pluginId - Plugin manifest id.
+ * @param themeId - Theme id within the plugin.
+ * @returns Serialized theme preference string.
+ */
+export function formatPluginThemeValue(pluginId, themeId) {
+    return `plugin:${pluginId}:${themeId}`;
+}
+/**
+ * Parses a persisted plugin theme preference.
+ *
+ * @param value - Raw theme setting from storage.
+ * @returns Plugin and theme ids when the value is plugin-scoped.
+ */
+export function parsePluginThemeValue(value) {
+    const match = /^plugin:([^:]+):([^:]+)$/.exec(value);
+    if (!match) {
+        return null;
+    }
+    return { pluginId: match[1], themeId: match[2] };
+}
+/**
+ * Converts a persisted theme preference to the plugin {@link ActiveTheme} shape.
+ *
+ * @param theme - Raw theme setting from storage or IPC.
+ * @returns Built-in or plugin-scoped active theme reference.
+ */
+export function toActiveTheme(theme) {
+    const parsed = parsePluginThemeValue(theme);
+    if (parsed) {
+        return { source: 'plugin', pluginId: parsed.pluginId, themeId: parsed.themeId };
+    }
+    return { source: 'builtin', id: theme };
+}
+/**
+ * Returns a stable string key for comparing {@link ActiveTheme} values.
+ *
+ * @param theme - Active theme reference.
+ * @returns Serialized key suitable for deduplication.
+ */
+export function activeThemeKey(theme) {
+    return theme.source === 'plugin'
+        ? `plugin:${theme.pluginId}:${theme.themeId}`
+        : `builtin:${theme.id}`;
+}
+//# sourceMappingURL=types.js.map

package/dist/plugin/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/plugin/types.ts"],"names":[],"mappings":"AAsZA;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAgB,EAAE,SAAiB;IACzE,OAAO,oBAAoB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AACnD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE,cAAsB;IAC3E,OAAO,UAAU,QAAQ,IAAI,cAAc,EAAE,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAC1C,KAAa;IAEb,MAAM,KAAK,GAAG,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACrD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB,EAAE,OAAe;IACtE,OAAO,UAAU,QAAQ,IAAI,OAAO,EAAE,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,MAAM,KAAK,GAAG,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAkB;IAC9C,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IAClF,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,KAAuB,EAAE,CAAC;AAC5D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAkB;IAC/C,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAC9B,CAAC,CAAC,UAAU,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,OAAO,EAAE;QAC7C,CAAC,CAAC,WAAW,KAAK,CAAC,EAAE,EAAE,CAAC;AAC5B,CAAC"}

package/dist/queryParams.d.ts

@@ -0,0 +1,63 @@
+import type { KeyValue } from './types/common';
+/**
+ * Base URL, query string (without leading ?), and hash fragment (without leading #).
+ */
+export interface SplitUrl {
+    /**
+     * URL portion before the query string and hash.
+     */
+    base: string;
+    /**
+     * Query string without a leading ?; empty when absent.
+     */
+    query: string;
+    /**
+     * Hash fragment without a leading #; empty when absent.
+     */
+    hash: string;
+}
+/**
+ * Splits a URL into base path, query string, and hash fragment without re-encoding.
+ *
+ * @param url - Full request URL as typed in the editor.
+ * @returns Lenient split preserving raw text including {{variables}}.
+ */
+export declare function splitUrl(url: string): SplitUrl;
+/**
+ * Parses the query string from a URL into key-value rows without decoding values.
+ *
+ * @param url - Full request URL as typed in the editor.
+ * @returns Parsed rows with enabled set to true; empty keys are skipped.
+ */
+export declare function parseQueryString(url: string): KeyValue[];
+/**
+ * Appends enabled query parameters to a base URL for outbound sends.
+ *
+ * Matches `@harborclient/http` QueryString.buildUrl so renderer-side URL previews
+ * (for example sidebar Copy) align with the URL the main process sends.
+ *
+ * @param baseUrl - Request URL before query string merging.
+ * @param params - Key-value pairs to append as search params.
+ * @returns URL with merged query parameters.
+ */
+export declare function buildSendUrl(baseUrl: string, params: KeyValue[]): string;
+/**
+ * Rebuilds a URL query string from enabled params without re-encoding raw text.
+ *
+ * @param url - Current request URL including any existing query and hash.
+ * @param params - Params table rows from the request editor.
+ * @returns URL with query string replaced from enabled params; hash preserved.
+ */
+export declare function applyParamsToUrl(url: string, params: KeyValue[]): string;
+/**
+ * Merges query params parsed from a URL with disabled rows from the current table.
+ *
+ * Enabled rows come from the URL (source of truth). Disabled non-empty rows from
+ * the current table are kept at the end so they remain editable but stay out of the URL.
+ *
+ * @param url - Updated request URL from the URL bar.
+ * @param currentParams - Existing params table rows.
+ * @returns Params rows for the editor, ending with one blank trailing row.
+ */
+export declare function mergeParamsFromUrl(url: string, currentParams: KeyValue[]): KeyValue[];
+//# sourceMappingURL=queryParams.d.ts.map

package/dist/queryParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryParams.d.ts","sourceRoot":"","sources":["../src/queryParams.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAWD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAS9C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,EAAE,CAuBxD;AAqCD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CA0BxE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAoBxE;AAYD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAUrF"}