@harborclient/core 0.1.1

package/dist/search/settingsCatalog.js

@@ -0,0 +1,426 @@
+/**
+ * Page descriptions for form sections rendered by the layout engine.
+ */
+export const FORM_SECTION_DESCRIPTIONS = {
+    general: 'Set request and script timeouts, response size limits, SSL verification, redirect following defaults, scrollbar visibility, and optional diagnostic log file output.',
+    proxy: "Route HarborClient's outbound HTTP requests through a proxy server.",
+    syntax: 'Choose a CodeMirror theme and editor behavior for request and response editors.',
+    ai: 'Store API keys for OpenAI, Claude, and Google Gemini, and configure MCP server and client connections.',
+    plugins: 'Configure marketplace catalog and trusted publisher key endpoints for plugin sources.'
+};
+/**
+ * Canonical manifest of searchable settings metadata and layout placement.
+ */
+export const SETTINGS_CATALOG = [
+    {
+        id: 'general.requestTimeoutMs',
+        section: 'general',
+        kind: 'field',
+        label: 'Request timeout (ms)',
+        description: 'Set to 0 to disable the limit.',
+        keywords: ['timeout', 'milliseconds', 'request']
+    },
+    {
+        id: 'general.scriptTimeoutMs',
+        section: 'general',
+        kind: 'field',
+        label: 'Script timeout (ms)',
+        description: 'Maximum time for each pre- or post-request script. Set to 0 to disable. Applies per script in the run order.',
+        keywords: ['script', 'timeout', 'pre-request', 'post-request', 'milliseconds']
+    },
+    {
+        id: 'general.allowScriptNetworkRequests',
+        section: 'general',
+        kind: 'field',
+        label: 'Allow script network requests',
+        description: 'When enabled, pre- and post-request scripts may call hc.sendRequest for outbound HTTP.',
+        keywords: ['script', 'network', 'sendRequest', 'http', 'permission']
+    },
+    {
+        id: 'general.allowScriptFileRead',
+        section: 'general',
+        kind: 'field',
+        label: 'Allow script file read',
+        description: 'When enabled, pre- and post-request scripts may call hc.fs read, exists, and stat APIs under the script file root.',
+        keywords: ['script', 'file', 'read', 'fs', 'permission', 'hc.fs']
+    },
+    {
+        id: 'general.allowScriptFileWrite',
+        section: 'general',
+        kind: 'field',
+        label: 'Allow script file write',
+        description: 'When enabled, pre- and post-request scripts may call hc.fs write and append APIs under the script file root.',
+        keywords: ['script', 'file', 'write', 'fs', 'permission', 'hc.fs']
+    },
+    {
+        id: 'general.scriptFileRoot',
+        section: 'general',
+        kind: 'field',
+        label: 'Script file access root',
+        description: 'Directory that confines hc.fs paths for non-git collections. Leave empty to use your home directory. Git-backed collections are confined to their git repository directory instead.',
+        keywords: ['script', 'file', 'root', 'directory', 'path', 'hc.fs', 'sandbox']
+    },
+    {
+        id: 'general.maxResponseSizeMb',
+        section: 'general',
+        kind: 'field',
+        label: 'Max response size (MB)',
+        description: 'Set to 0 for no configurable limit (512 MB hard cap still applies).',
+        keywords: ['response', 'size', 'limit', 'megabytes']
+    },
+    {
+        id: 'general.verifySsl',
+        section: 'general',
+        kind: 'field',
+        label: 'SSL certificate verification',
+        description: 'When enabled, HTTPS requests reject invalid or untrusted TLS certificates.',
+        keywords: ['ssl', 'tls', 'certificate', 'https', 'security']
+    },
+    {
+        id: 'general.followRedirects',
+        section: 'general',
+        kind: 'field',
+        label: 'Follow redirects',
+        description: 'When disabled, 3xx responses are returned without following Location.',
+        keywords: ['redirect', '3xx', 'location']
+    },
+    {
+        id: 'general.userAgent',
+        section: 'general',
+        kind: 'field',
+        label: 'User-Agent',
+        description: 'Default User-Agent header for outbound HTTP. Collection, folder, and request overrides take precedence; a key/value User-Agent header wins over all of them.',
+        keywords: ['user-agent', 'user agent', 'ua', 'browser', 'client', 'header']
+    },
+    {
+        id: 'general.scrollbarAutoHide',
+        section: 'general',
+        kind: 'field',
+        label: 'Auto-hide scrollbars',
+        description: 'When enabled, custom scrollbars fade out when you are not scrolling. When disabled, they stay visible while content overflows.',
+        keywords: ['scrollbar', 'scroll', 'overlay', 'auto-hide', 'visibility']
+    },
+    {
+        id: 'general.wrapTabs',
+        section: 'general',
+        kind: 'field',
+        label: 'Wrap tabs',
+        description: 'When enabled, request tabs and AI chat tabs wrap onto multiple rows instead of scrolling horizontally.',
+        keywords: ['wrap', 'tabs', 'overflow', 'scroll']
+    },
+    {
+        id: 'general.closeToTray',
+        section: 'general',
+        kind: 'field',
+        label: 'Close to tray',
+        description: 'When enabled, closing the main window hides HarborClient to the system tray instead of quitting. Use File → Quit or the tray Quit action to exit completely.',
+        keywords: ['tray', 'close', 'minimize', 'background', 'system tray', 'quit', 'hide']
+    },
+    {
+        id: 'general.spellCheckEnabled',
+        section: 'general',
+        kind: 'field',
+        label: 'Spell check',
+        description: 'When enabled, editable text fields show spelling underlines and offer suggestions in the right-click menu.',
+        keywords: ['spell', 'spelling', 'dictionary', 'typo', 'autocorrect', 'context menu']
+    },
+    {
+        id: 'general.logFilePath',
+        section: 'general',
+        kind: 'field',
+        label: 'Log file path',
+        description: 'When set, verbose and request diagnostics are written to this rotating log file regardless of -v or -vv flags. Leave empty to disable.',
+        keywords: ['log', 'logging', 'file', 'verbose', 'diagnostics', 'debug']
+    },
+    {
+        id: 'proxy.enabled',
+        section: 'proxy',
+        kind: 'field',
+        label: 'Use a proxy',
+        description: 'Route outbound HTTP requests through a configured proxy server.',
+        keywords: ['proxy', 'network']
+    },
+    {
+        id: 'proxy.protocol',
+        section: 'proxy',
+        kind: 'field',
+        label: 'Protocol',
+        description: 'HTTP or HTTPS scheme used to connect to the proxy server.',
+        keywords: ['http', 'https']
+    },
+    {
+        id: 'proxy.host',
+        section: 'proxy',
+        kind: 'field',
+        label: 'Host',
+        description: 'Hostname or IP address of the proxy server.',
+        keywords: ['hostname', 'address', 'server']
+    },
+    {
+        id: 'proxy.port',
+        section: 'proxy',
+        kind: 'field',
+        label: 'Port',
+        description: 'Port number the proxy server listens on.',
+        keywords: ['port', 'network']
+    },
+    {
+        id: 'proxy.authEnabled',
+        section: 'proxy',
+        kind: 'field',
+        label: 'Use basic authentication',
+        description: 'Send a username and password when connecting to the proxy.',
+        keywords: ['authentication', 'credentials', 'basic auth']
+    },
+    {
+        id: 'proxy.username',
+        section: 'proxy',
+        kind: 'field',
+        label: 'Username',
+        description: 'Username sent for proxy basic authentication.',
+        keywords: ['user', 'login', 'credentials']
+    },
+    {
+        id: 'proxy.password',
+        section: 'proxy',
+        kind: 'field',
+        label: 'Password',
+        description: 'Password sent for proxy basic authentication.',
+        keywords: ['secret', 'credentials']
+    },
+    {
+        id: 'syntax.codeEditorTheme',
+        section: 'syntax',
+        kind: 'field',
+        label: 'Theme',
+        description: 'CodeMirror color theme applied to request and response editors.',
+        keywords: ['syntax', 'highlighting', 'codemirror', 'colors']
+    },
+    {
+        id: 'syntax.codeEditorFontSize',
+        section: 'syntax',
+        kind: 'field',
+        label: 'Font size',
+        description: 'Font size applied to request and response editors.',
+        keywords: ['syntax', 'highlighting', 'codemirror', 'font', 'text size']
+    },
+    {
+        id: 'syntax.lineNumbers',
+        section: 'syntax',
+        kind: 'field',
+        label: 'Line numbers',
+        description: 'Show line numbers in the editor gutter.',
+        keywords: ['gutter', 'numbers']
+    },
+    {
+        id: 'syntax.foldGutter',
+        section: 'syntax',
+        kind: 'field',
+        label: 'Code folding gutter',
+        description: 'Show fold controls in the gutter for collapsible code blocks.',
+        keywords: ['fold', 'collapse', 'gutter']
+    },
+    {
+        id: 'syntax.highlightActiveLine',
+        section: 'syntax',
+        kind: 'field',
+        label: 'Highlight active line',
+        description: 'Highlight the line containing the text cursor.',
+        keywords: ['cursor', 'current line']
+    },
+    {
+        id: 'syntax.highlightActiveLineGutter',
+        section: 'syntax',
+        kind: 'field',
+        label: 'Highlight active line gutter',
+        description: 'Highlight the gutter marker for the active line.',
+        keywords: ['gutter', 'current line']
+    },
+    {
+        id: 'ai.openaiApiKey',
+        section: 'ai',
+        kind: 'field',
+        label: 'OpenAI API key',
+        description: 'API key used for OpenAI models in the AI sidebar.',
+        keywords: ['openai', 'gpt', 'chatgpt', 'api']
+    },
+    {
+        id: 'ai.claudeApiKey',
+        section: 'ai',
+        kind: 'field',
+        label: 'Claude API key',
+        description: 'API key used for Anthropic Claude models in the AI sidebar.',
+        keywords: ['anthropic', 'claude', 'api']
+    },
+    {
+        id: 'ai.geminiApiKey',
+        section: 'ai',
+        kind: 'field',
+        label: 'Google Gemini API key',
+        description: 'API key used for Google Gemini models in the AI sidebar.',
+        keywords: ['google', 'gemini', 'api']
+    },
+    {
+        id: 'ai.githubModels',
+        section: 'ai',
+        kind: 'field',
+        label: 'GitHub Models',
+        description: 'Sign in with GitHub to use rate-limited GitHub Models on your account quota.',
+        keywords: ['github', 'models', 'oauth', 'sign in', 'free']
+    },
+    {
+        id: 'plugins.addCatalogEndpointUrl',
+        section: 'plugins',
+        kind: 'field',
+        label: 'Add endpoint URL',
+        description: 'Add a new endpoint URL to the list.',
+        keywords: ['endpoint', 'catalog', 'url', 'plugin sources', 'marketplace']
+    },
+    {
+        id: 'plugins.addTrustedEndpointUrl',
+        section: 'plugins',
+        kind: 'field',
+        label: 'Add endpoint URL',
+        description: 'Add a new endpoint URL to the list.',
+        keywords: ['endpoint', 'trusted', 'url', 'plugin sources', 'publisher', 'signing']
+    },
+    {
+        id: 'globals',
+        section: 'globals',
+        kind: 'section',
+        label: 'Globals',
+        description: 'App-wide variables substituted into request URLs and bodies.',
+        keywords: ['variables']
+    },
+    {
+        id: 'storage',
+        section: 'storage',
+        kind: 'section',
+        label: 'Storage Locations',
+        description: 'Configure local, Git, and remote database connections for collections.',
+        keywords: ['connections', 'database']
+    },
+    {
+        id: 'git',
+        section: 'git',
+        kind: 'section',
+        label: 'Git',
+        description: 'Manage shared credentials for git hosts. One identity per host is reused by all git-backed collections.',
+        keywords: [
+            'github',
+            'oauth',
+            'token',
+            'authentication',
+            'credentials',
+            'host',
+            'auto track',
+            'tracking'
+        ]
+    },
+    {
+        id: 'git.autoTrack',
+        section: 'git',
+        kind: 'group',
+        label: 'Auto track',
+        description: 'When enabled, HarborClient automatically tracks all requests and files added to git-backed collections. When disabled, use Add on individual requests to track changes before committing.',
+        keywords: ['git', 'track', 'tracking', 'auto track', 'commit', 'unstaged', 'manual']
+    },
+    {
+        id: 'git.commitAuthor',
+        section: 'git',
+        kind: 'group',
+        label: 'Commit author',
+        description: 'Name and email stamped on commits created through HarborClient. When empty, HarborClient falls back to repo-local git config or a default identity.',
+        keywords: ['git', 'commit', 'author', 'name', 'email', 'identity', 'user.name', 'user.email']
+    },
+    {
+        id: 'shortcuts',
+        section: 'shortcuts',
+        kind: 'section',
+        label: 'Shortcuts',
+        description: 'Customize keyboard shortcuts for menus and common actions.',
+        keywords: ['keyboard', 'keybindings']
+    },
+    {
+        id: 'backup-restore',
+        section: 'backup-restore',
+        kind: 'section',
+        label: 'Backup & Restore',
+        description: 'Export everything HarborClient stores locally into a backup file, or restore from a backup.',
+        keywords: ['export', 'import']
+    },
+    {
+        id: 'backup-restore.confirmations',
+        section: 'backup-restore',
+        kind: 'group',
+        label: 'Show confirmations',
+        description: 'Choose which confirmation prompts HarborClient shows. Uncheck a row to suppress that prompt permanently, including after choosing "Don\'t ask again" in a dialog.',
+        keywords: [
+            'confirmation',
+            'confirm',
+            'warn',
+            'warning',
+            'prompt',
+            "don't ask again",
+            'theme',
+            'unsaved',
+            'snippet',
+            'tab group'
+        ]
+    }
+];
+const CATALOG_BY_ID = new Map(SETTINGS_CATALOG.map((entry) => [entry.id, entry]));
+/**
+ * Returns the catalog entry for a setting id.
+ *
+ * @param id - Stable setting identifier.
+ * @returns Matching catalog entry.
+ * @throws When the id is unknown.
+ */
+export function entryById(id) {
+    const entry = CATALOG_BY_ID.get(id);
+    if (!entry) {
+        throw new Error(`Unknown setting id: ${id}`);
+    }
+    return entry;
+}
+/**
+ * Returns field catalog entries belonging to a form section in manifest order.
+ *
+ * @param section - Form settings section id.
+ * @returns Field entries for the section.
+ */
+export function fieldEntriesForSection(section) {
+    return SETTINGS_CATALOG.filter((entry) => entry.kind === 'field' && entry.section === section);
+}
+/**
+ * Returns all field catalog entries in manifest order.
+ *
+ * @returns Every field entry in the catalog.
+ */
+export function allFieldEntries() {
+    return SETTINGS_CATALOG.filter((entry) => entry.kind === 'field');
+}
+/**
+ * Returns the section-level catalog entry for a management section.
+ *
+ * @param section - Built-in settings section id.
+ * @returns Matching section entry.
+ * @throws When the section is not a catalogued management section.
+ */
+export function sectionEntryBySection(section) {
+    const entry = SETTINGS_CATALOG.find((candidate) => candidate.kind === 'section' && candidate.section === section);
+    if (!entry) {
+        throw new Error(`No section catalog entry for: ${section}`);
+    }
+    return entry;
+}
+/**
+ * Returns true when the section is rendered from individual field components.
+ *
+ * @param section - Settings section id.
+ */
+export function isFormSettingsSection(section) {
+    return section === 'general' || section === 'proxy' || section === 'syntax' || section === 'ai';
+}
+//# sourceMappingURL=settingsCatalog.js.map

package/dist/search/settingsCatalog.js.map

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

package/dist/search/sidebar.d.ts

@@ -0,0 +1,139 @@
+import type { Collection, Environment, Folder, SavedRequest } from '../types';
+import { type HarborSearchIndex } from './oramaIndex';
+/**
+ * Sidebar entities passed from the renderer for indexing and filtering.
+ */
+export interface SidebarSearchInput {
+    /**
+     * Collections in sidebar display order.
+     */
+    collections: Collection[];
+    /**
+     * Folders grouped by collection id; omitted keys mean contents not loaded yet.
+     */
+    foldersByCollection: Record<number, Folder[]>;
+    /**
+     * Saved requests grouped by collection id; omitted keys mean contents not loaded yet.
+     */
+    requestsByCollection: Record<number, SavedRequest[]>;
+    /**
+     * Environments in sidebar display order.
+     */
+    environments: Environment[];
+}
+/**
+ * Visibility sets used to filter the collections tree and environments list.
+ */
+export interface SidebarSearchFilter {
+    /**
+     * Collection rows to show in the sidebar tree.
+     */
+    collectionIds: ReadonlySet<number>;
+    /**
+     * Folder rows to show within visible collections.
+     */
+    folderIds: ReadonlySet<number>;
+    /**
+     * Request rows to show within visible collections and folders.
+     */
+    requestIds: ReadonlySet<number>;
+    /**
+     * Environment rows to show in the environments section.
+     */
+    environmentIds: ReadonlySet<number>;
+}
+/**
+ * Sidebar entity kinds indexed for search.
+ */
+export type SidebarEntityKind = 'collection' | 'folder' | 'request' | 'environment';
+/**
+ * Indexed fields for sidebar entity search.
+ */
+export type SidebarSearchDocument = {
+    id: string;
+    kind: SidebarEntityKind;
+    name: string;
+    url: string;
+    method: string;
+    comment: string;
+    tags: string;
+    collectionId: number;
+    folderId: number;
+};
+/**
+ * Builds a composite document id for one sidebar entity kind.
+ *
+ * @param kind - Entity category.
+ * @param entityId - Numeric database id.
+ */
+export declare function sidebarDocumentId(kind: SidebarEntityKind, entityId: number): string;
+/**
+ * Parses a composite sidebar document id into kind and numeric id.
+ *
+ * @param documentId - Composite id stored in the search index.
+ */
+export declare function parseSidebarDocumentId(documentId: string): {
+    kind: SidebarEntityKind;
+    entityId: number;
+} | null;
+/**
+ * Builds an Orama index over collections, folders, requests, and environments.
+ *
+ * @param input - Sidebar data currently available in the renderer store.
+ * @returns Search index keyed by composite entity ids.
+ */
+export declare function buildSidebarSearchIndex(input: SidebarSearchInput): HarborSearchIndex;
+/**
+ * Filters sidebar entities by a user query using the prebuilt search index.
+ *
+ * @param input - Sidebar data currently available in the renderer store.
+ * @param index - Orama index built from the same sidebar rows.
+ * @param query - Raw search text from the sidebar search field.
+ * @returns Visibility sets for tree filtering, or null when the query is empty.
+ */
+export declare function searchSidebar(input: SidebarSearchInput, index: HarborSearchIndex, query: string): SidebarSearchFilter | null;
+/**
+ * Returns direct sidebar entity hits with scores for unified global search.
+ *
+ * @param input - Sidebar data used to resolve subtitles.
+ * @param index - Orama index built from the same sidebar rows.
+ * @param query - Raw search text.
+ */
+export declare function searchSidebarEntities(input: SidebarSearchInput, index: HarborSearchIndex, query: string): Array<{
+    kind: SidebarEntityKind;
+    entityId: number;
+    score: number;
+    name: string;
+    method?: string;
+    collectionId?: number;
+    folderId?: number | null;
+}>;
+/**
+ * Collection and folder names for a saved request breadcrumb.
+ */
+export interface SidebarRequestBreadcrumb {
+    /** Parent collection display name. */
+    collectionName?: string;
+    /** Parent folder display name when the request is nested. */
+    folderName?: string;
+}
+/**
+ * Resolves collection and folder names for a saved request breadcrumb.
+ *
+ * @param input - Sidebar data for name lookups.
+ * @param collectionId - Numeric collection id for the request.
+ * @param folderId - Numeric folder id when nested, otherwise null or undefined.
+ */
+export declare function sidebarRequestBreadcrumb(input: SidebarSearchInput, collectionId: number | undefined, folderId: number | null | undefined): SidebarRequestBreadcrumb;
+/**
+ * Resolves a subtitle for a sidebar entity hit using loaded sidebar data.
+ *
+ * @param input - Sidebar data for name lookups.
+ * @param hit - Parsed sidebar entity hit.
+ */
+export declare function sidebarEntitySubtitle(input: SidebarSearchInput, hit: {
+    kind: SidebarEntityKind;
+    collectionId?: number;
+    folderId?: number | null;
+}): string | undefined;
+//# sourceMappingURL=sidebar.d.ts.map

package/dist/search/sidebar.d.ts.map

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