@harborclient/core 0.1.1

package/dist/types/settings.d.ts

@@ -0,0 +1,340 @@
+import type { CodeEditorSetup, CodeEditorTheme } from '@harborclient/sdk';
+import type { Variable } from './common';
+import type { ProxySettings } from '@harborclient/http';
+export type { ProxyProtocol, ProxySettings } from '@harborclient/http';
+/**
+ * Persisted sidebar expansion state for sections, collections, and folders.
+ */
+export interface SidebarExpansionState {
+    /**
+     * Expanded/collapsed state for top-level sidebar sections.
+     */
+    sections: {
+        /**
+         * Whether the Collections section body is visible.
+         */
+        collections: boolean;
+        /**
+         * Whether the Environments section body is visible.
+         */
+        environments: boolean;
+        /**
+         * Whether the Run Results section body is visible.
+         */
+        runResults: boolean;
+        /**
+         * Whether the History section body is visible.
+         */
+        history: boolean;
+        /**
+         * Whether the Tab Groups section body is visible.
+         */
+        tabGroups: boolean;
+        /**
+         * Whether the Trash section body is visible.
+         */
+        trash: boolean;
+    };
+    /**
+     * Collection ids whose request trees are expanded in the sidebar.
+     */
+    collectionIds: number[];
+    /**
+     * Folder ids whose request lists are expanded in the sidebar.
+     */
+    folderIds: number[];
+    /**
+     * Whether entire top-level sidebar sections are rendered.
+     */
+    sectionVisibility: {
+        /**
+         * Whether the Collections section is shown in the sidebar.
+         */
+        collections: boolean;
+        /**
+         * Whether the Environments section is shown in the sidebar.
+         */
+        environments: boolean;
+        /**
+         * Whether the Run Results section is shown in the sidebar.
+         */
+        runResults: boolean;
+        /**
+         * Whether the History section is shown in the sidebar.
+         */
+        history: boolean;
+        /**
+         * Whether the Tab Groups section is shown in the sidebar.
+         */
+        tabGroups: boolean;
+        /**
+         * Whether the Trash section is shown in the sidebar.
+         */
+        trash: boolean;
+    };
+    /**
+     * Whether storage location name badges appear next to collection names.
+     */
+    showStorageLocationBadges: boolean;
+    /**
+     * Whether user-assigned color dots appear beside sidebar row names.
+     */
+    showColorDots: boolean;
+}
+/** Default request editor split height in pixels when both editors are visible. */
+export declare const DEFAULT_REQUEST_EDITOR_SPLIT_HEIGHT = 340;
+/**
+ * Persisted visibility for sidebars, request/response editors, and footer panels.
+ */
+export interface PanelLayoutState {
+    /**
+     * Whether the collections sidebar is shown when not hidden by an overlay.
+     */
+    showSidebar: boolean;
+    /**
+     * Whether the AI sidebar is shown when not hidden by an overlay.
+     */
+    showAiSidebar: boolean;
+    /**
+     * Whether the Git source-control sidebar is shown when not hidden by an overlay.
+     */
+    showGitSidebar: boolean;
+    /**
+     * Whether the request editor panel is shown in the main content area.
+     */
+    showRequestEditor: boolean;
+    /**
+     * Whether the response editor panel is shown in the main content area.
+     */
+    showResponseEditor: boolean;
+    /**
+     * Request editor panel height in pixels when both request and response editors are visible.
+     */
+    requestEditorSplitHeight: number;
+    /**
+     * Whether the footer console panel is open.
+     */
+    showConsole: boolean;
+    /**
+     * Whether the footer variables panel is open.
+     */
+    showVariables: boolean;
+    /**
+     * Whether the footer MCP server panel is open.
+     */
+    showMcp: boolean;
+    /**
+     * Whether the footer terminal panel is open.
+     */
+    showTerminal: boolean;
+    /**
+     * Active plugin footer panel id, when a plugin panel is open.
+     */
+    activePluginFooterPanelId: string | null;
+}
+/**
+ * Persisted AI chat tab session for restoring open tabs on launch.
+ */
+export interface AiChatSessionState {
+    /**
+     * Chat ids open in the tab bar, in display order.
+     */
+    openTabIds: number[];
+    /**
+     * Currently selected chat tab id, if any.
+     */
+    activeChatId: number | null;
+    /**
+     * When true, plain Enter submits the chat composer; when false, Ctrl/Cmd+Enter submits.
+     */
+    enterToSend: boolean;
+}
+/**
+ * Theme preference for light, dark, system, or high-contrast appearance.
+ */
+export type ThemeSource = 'light' | 'dark' | 'system' | 'high-contrast' | `plugin:${string}:${string}` | `custom:${string}`;
+/**
+ * Request editor tab identifiers.
+ */
+export type EditorTab = 'params' | 'headers' | 'auth' | 'cookies' | 'body' | 'pre' | 'post' | 'comment';
+/**
+ * General application settings for HTTP request execution.
+ */
+export interface GeneralSettings {
+    /**
+     * Request timeout in milliseconds; 0 disables the timeout.
+     */
+    requestTimeoutMs: number;
+    /**
+     * Maximum time in milliseconds for each pre- or post-request script run; 0 disables the limit.
+     */
+    scriptTimeoutMs: number;
+    /**
+     * When true, pre/post scripts may call hc.sendRequest for outbound HTTP.
+     */
+    allowScriptNetworkRequests: boolean;
+    /**
+     * Plugin manifest ids allowed to call hc.host.sendHttpRequest when
+     * {@link allowScriptNetworkRequests} is false.
+     */
+    allowedNetworkPlugins: string[];
+    /**
+     * When true, pre/post scripts may call hc.fs read/exists/stat APIs.
+     */
+    allowScriptFileRead: boolean;
+    /**
+     * When true, pre/post scripts may call hc.fs write/append APIs.
+     */
+    allowScriptFileWrite: boolean;
+    /**
+     * Absolute directory that confines script file access when the request is not
+     * in a git-backed collection. Empty resolves to the user home directory.
+     */
+    scriptFileRoot: string;
+    /**
+     * Maximum response body size in megabytes; 0 disables the limit.
+     */
+    maxResponseSizeMb: number;
+    /**
+     * When true, TLS certificates are verified for HTTPS requests.
+     */
+    verifySsl: boolean;
+    /**
+     * When true, 3xx responses are followed automatically.
+     */
+    followRedirects: boolean;
+    /**
+     * Default User-Agent header for outbound HTTP when no scoped override or
+     * key/value User-Agent header is set.
+     */
+    userAgent: string;
+    /**
+     * User-added User-Agent presets shown alongside the built-in list in every
+     * User-Agent control.
+     */
+    customUserAgents: string[];
+    /**
+     * When true, custom OverlayScrollbars handles fade out when idle.
+     */
+    scrollbarAutoHide: boolean;
+    /**
+     * When true, request tabs and AI chat tabs wrap onto multiple rows instead of scrolling horizontally.
+     */
+    wrapTabs: boolean;
+    /**
+     * When true, closing the main window hides the app to the system tray instead of quitting.
+     * Use File → Quit or the tray Quit action to exit completely.
+     */
+    closeToTray: boolean;
+    /**
+     * When true, editable text fields show spellcheck underlines and spelling context-menu actions.
+     */
+    spellCheckEnabled: boolean;
+    /**
+     * When true, switching appearance themes from the View menu shows a confirmation dialog.
+     */
+    warnWhenSwitchingThemes: boolean;
+    /**
+     * When true, quitting or closing the app with unsaved request tabs shows a confirmation dialog.
+     */
+    warnWhenExitingWithUnsavedChanges: boolean;
+    /**
+     * When true, closing a request tab with unsaved edits shows a confirmation dialog.
+     */
+    warnWhenClosingUnsavedRequests: boolean;
+    /**
+     * When true, editing a linked snippet in the request script list shows a confirmation dialog.
+     */
+    warnWhenEditingSnippet: boolean;
+    /**
+     * When true, cloning a linked snippet in the request script list shows a confirmation dialog.
+     */
+    warnWhenCloningSnippet: boolean;
+    /**
+     * When true, clicking a read-only linked snippet in the script list shows an informational dialog.
+     */
+    warnWhenClickingReadonlySnippet: boolean;
+    /**
+     * When true, creating a tab group from open request tabs shows a confirmation dialog.
+     */
+    warnWhenCreatingTabGroup: boolean;
+    /**
+     * When true, clicking a tab group in the sidebar shows a confirmation dialog before opening tabs.
+     */
+    warnWhenOpeningTabGroup: boolean;
+    /**
+     * When true, the AI agent must confirm before sending commands to the footer terminal.
+     */
+    warnWhenAgentUsesTerminal: boolean;
+    /**
+     * When true, HarborClient automatically tracks all requests and files added to git-backed
+     * collections before committing. When false, only files tracked via request Add actions are
+     * included in commits.
+     */
+    gitAutoAdd: boolean;
+    /**
+     * Absolute path to an external executable used to resolve merge conflicts.
+     * When empty, HarborClient opens its built-in merge editor tab.
+     */
+    externalMergeEditorPath: string;
+    /**
+     * Display name stamped on commits created through HarborClient.
+     * When empty, HarborClient falls back to repo-local git config or a default identity.
+     */
+    gitCommitAuthorName: string;
+    /**
+     * Email address stamped on commits created through HarborClient.
+     * When empty, HarborClient falls back to repo-local git config or a default identity.
+     */
+    gitCommitAuthorEmail: string;
+    /**
+     * Whether the first-commit author prompt has been shown and dismissed or saved.
+     */
+    gitCommitAuthorPrompted: boolean;
+    /**
+     * CodeMirror syntax theme applied to all editor instances.
+     */
+    codeEditorTheme: CodeEditorTheme;
+    /**
+     * CodeMirror basicSetup options for editable editor instances.
+     */
+    codeEditorSetup: CodeEditorSetup;
+    /**
+     * CodeMirror editor font size applied to all editor instances.
+     */
+    codeEditorFontSize: string;
+    /**
+     * Global HTTP proxy applied to every outbound request.
+     */
+    proxy: ProxySettings;
+    /**
+     * App-wide variables for {{key}} substitution; lowest precedence in the variable chain.
+     */
+    globalVariables: Variable[];
+    /**
+     * Absolute path to a rotating log file; empty disables file logging.
+     */
+    logFilePath: string;
+}
+/**
+ * Settings sidebar section identifiers.
+ */
+export type SettingsSection = 'general' | 'syntax' | 'storage' | 'shortcuts' | 'proxy' | 'globals' | 'ai' | 'backup-restore' | 'git' | `plugin:${string}:${string}`;
+/**
+ * AI provider API keys stored locally for future assistant features.
+ */
+export interface AiSettings {
+    /**
+     * OpenAI API key.
+     */
+    openaiApiKey: string;
+    /**
+     * Anthropic Claude API key.
+     */
+    claudeApiKey: string;
+    /**
+     * Google Gemini API key.
+     */
+    geminiApiKey: string;
+}
+//# sourceMappingURL=settings.d.ts.map

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

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

package/dist/types/settings.js

@@ -0,0 +1,3 @@
+/** Default request editor split height in pixels when both editors are visible. */
+export const DEFAULT_REQUEST_EDITOR_SPLIT_HEIGHT = 340;
+//# sourceMappingURL=settings.js.map

package/dist/types/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/types/settings.ts"],"names":[],"mappings":"AAqGA,mFAAmF;AACnF,MAAM,CAAC,MAAM,mCAAmC,GAAG,GAAG,CAAC"}

package/dist/types/sharing.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Local RSA identity used to sign and decrypt share tokens.
+ */
+export interface SharingIdentity {
+    /**
+     * PEM-encoded RSA public key.
+     */
+    publicKeyPem: string;
+    /**
+     * SHA-256 fingerprint of the public key (hex).
+     */
+    fingerprint: string;
+}
+/**
+ * A trusted collaborator public key used to verify share token signatures.
+ */
+export interface TrustedSharingKey {
+    /**
+     * SHA-256 fingerprint of the SPKI public key (hex).
+     */
+    id: string;
+    /**
+     * User-defined label for the key owner.
+     */
+    label: string;
+    /**
+     * PEM-encoded RSA public key.
+     */
+    publicKeyPem: string;
+    /**
+     * Unix timestamp when the key was added.
+     */
+    addedAt: number;
+}
+/**
+ * Result of exporting a PEM key to disk via a native save dialog.
+ */
+export interface PemExportResult {
+    /**
+     * True when the user canceled the save dialog.
+     */
+    canceled: boolean;
+    /**
+     * Absolute path written when not canceled.
+     */
+    path?: string;
+}
+/**
+ * Result of saving arbitrary text to disk via a native save dialog.
+ */
+export interface SaveTextFileResult {
+    /**
+     * True when the user canceled the save dialog.
+     */
+    canceled: boolean;
+    /**
+     * Absolute path written when not canceled.
+     */
+    path?: string;
+}
+/**
+ * Result of a HarborClient backup export save-dialog action.
+ */
+export interface BackupExportResult {
+    /**
+     * True when the user canceled the save dialog.
+     */
+    canceled: boolean;
+    /**
+     * Absolute path where the `.hcb` file was written; omitted when canceled.
+     */
+    path?: string;
+}
+/**
+ * Result of a HarborClient backup restore open-dialog action.
+ */
+export interface BackupImportResult {
+    /**
+     * True when the user canceled the open dialog.
+     */
+    canceled: boolean;
+    /**
+     * Renderer localStorage entries restored from the backup; omitted when canceled.
+     */
+    localStorage?: Record<string, string>;
+}
+//# sourceMappingURL=sharing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sharing.d.ts","sourceRoot":"","sources":["../../src/types/sharing.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC"}

package/dist/types/sharing.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sharing.js.map

package/dist/types/sharing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharing.js","sourceRoot":"","sources":["../../src/types/sharing.ts"],"names":[],"mappings":""}

package/dist/types/snippet.d.ts

@@ -0,0 +1,150 @@
+import type { SnippetScope } from '../snippetScope';
+import type { ScriptStage } from '@harborclient/sdk';
+/**
+ * Origin of a snippet row in the local registry.
+ */
+export type SnippetSource = 'local' | 'marketplace';
+/**
+ * A reusable JavaScript snippet stored in a provider backend or the local
+ * marketplace registry.
+ */
+export interface Snippet {
+    /**
+     * Unique database ID.
+     */
+    id: number;
+    /**
+     * Stable portable identifier for deduplication and live references.
+     */
+    uuid: string;
+    /**
+     * Display name shown in settings and script pickers.
+     */
+    name: string;
+    /**
+     * JavaScript source executed when the snippet is referenced.
+     */
+    code: string;
+    /**
+     * Request stages where this snippet may be referenced.
+     */
+    scope: SnippetScope;
+    /**
+     * Default script stage when the snippet is added to a request stage script list.
+     */
+    stage: ScriptStage;
+    /**
+     * Whether the snippet was created locally or imported from the marketplace.
+     */
+    source: SnippetSource;
+    /**
+     * Id of the storage connection that stores this snippet.
+     *
+     * Omitted for marketplace snippets, which remain in the local registry only.
+     */
+    connectionId?: string;
+    /**
+     * Marketplace bundle id when `source` is `marketplace`.
+     */
+    catalogId?: string;
+    /**
+     * Installed marketplace bundle version when `source` is `marketplace`.
+     */
+    catalogVersion?: string;
+    /**
+     * Marketplace bundle publisher when `source` is `marketplace`.
+     */
+    catalogAuthor?: string;
+    /**
+     * ISO 8601 timestamp when the snippet was created.
+     */
+    created_at: string;
+    /**
+     * ISO 8601 timestamp when the snippet was last updated.
+     */
+    updated_at: string;
+}
+/**
+ * Portable snippet export file format for git-backed storage.
+ */
+export interface SnippetExport {
+    /**
+     * HarborClient export schema version for forward compatibility.
+     */
+    harborclientVersion: 1;
+    /**
+     * Discriminator identifying this file as a snippet export.
+     */
+    harborclientExport: 'snippet';
+    /**
+     * Stable portable identifier for deduplication and script references.
+     */
+    uuid: string;
+    /**
+     * Display name shown in settings and script pickers.
+     */
+    name: string;
+    /**
+     * JavaScript source executed when the snippet is referenced.
+     */
+    code: string;
+    /**
+     * Request stages where this snippet may be referenced.
+     */
+    scope: SnippetScope;
+    /**
+     * Default script stage when the snippet is added to a request stage script list.
+     */
+    stage: ScriptStage;
+    /**
+     * ISO 8601 timestamp when the snippet was created.
+     */
+    created_at?: string;
+    /**
+     * ISO 8601 timestamp when the snippet was last updated.
+     */
+    updated_at?: string;
+}
+/**
+ * One script row serialized inside a snippets bundle export.
+ */
+export interface SnippetBundleEntry {
+    /**
+     * Display name for the script row.
+     */
+    name: string;
+    /**
+     * Resolved JavaScript source for the script row.
+     */
+    code: string;
+    /**
+     * Request stages where this script may run.
+     */
+    scope: SnippetScope;
+    /**
+     * Stage within the phase script list (before, run, or after).
+     */
+    stage: ScriptStage;
+    /**
+     * Stable snippet uuid when the row referenced a library snippet.
+     */
+    uuid?: string;
+}
+/**
+ * Portable export format for a pre- or post-request script list bundle.
+ */
+export interface SnippetBundleExport {
+    /**
+     * HarborClient export schema version for forward compatibility.
+     */
+    harborclientVersion: 1;
+    /**
+     * Discriminator identifying this file as a snippets bundle export.
+     */
+    harborclientExport: 'snippets-bundle';
+    /**
+     * Ordered script entries from the exported phase.
+     */
+    snippets: SnippetBundleEntry[];
+}
+//# sourceMappingURL=snippet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snippet.d.ts","sourceRoot":"","sources":["../../src/types/snippet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,aAAa,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,YAAY,CAAC;IAEpB;;OAEG;IACH,KAAK,EAAE,WAAW,CAAC;IAEnB;;OAEG;IACH,MAAM,EAAE,aAAa,CAAC;IAEtB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,mBAAmB,EAAE,CAAC,CAAC;IAEvB;;OAEG;IACH,kBAAkB,EAAE,SAAS,CAAC;IAE9B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,YAAY,CAAC;IAEpB;;OAEG;IACH,KAAK,EAAE,WAAW,CAAC;IAEnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,YAAY,CAAC;IAEpB;;OAEG;IACH,KAAK,EAAE,WAAW,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,mBAAmB,EAAE,CAAC,CAAC;IAEvB;;OAEG;IACH,kBAAkB,EAAE,iBAAiB,CAAC;IAEtC;;OAEG;IACH,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC"}

package/dist/types/snippet.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=snippet.js.map

package/dist/types/snippet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippet.js","sourceRoot":"","sources":["../../src/types/snippet.ts"],"names":[],"mappings":""}