@harborclient/core 0.1.1

package/dist/types/trash.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Sidebar entity kinds that can be moved to trash.
+ */
+export type TrashEntityType = 'collection' | 'folder' | 'request' | 'document' | 'runResult' | 'history' | 'environment' | 'tabGroup';
+/**
+ * A snapshot row stored in the registry trash table.
+ */
+export interface TrashItem {
+    /**
+     * Trash table primary key.
+     */
+    id: number;
+    /**
+     * Original sidebar entity kind.
+     */
+    entityType: TrashEntityType;
+    /**
+     * Display label shown in the Trash section row.
+     */
+    label: string;
+    /**
+     * Storage connection id for provider-backed entities; null for registry-only rows.
+     */
+    connectionId: string | null;
+    /**
+     * Original ids and parent references needed to restore the entity.
+     */
+    originalIds: Record<string, unknown>;
+    /**
+     * Serialized entity snapshot used to recreate the item on restore.
+     */
+    payload: unknown;
+    /**
+     * ISO timestamp when the item was moved to trash.
+     */
+    deletedAt: string;
+}
+/**
+ * Input for inserting a trash snapshot row.
+ */
+export interface InsertTrashItemInput {
+    /**
+     * Original sidebar entity kind.
+     */
+    entityType: TrashEntityType;
+    /**
+     * Display label shown in the Trash section row.
+     */
+    label: string;
+    /**
+     * Storage connection id for provider-backed entities; null for registry-only rows.
+     */
+    connectionId?: string | null;
+    /**
+     * Original ids and parent references needed to restore the entity.
+     */
+    originalIds: Record<string, unknown>;
+    /**
+     * Serialized entity snapshot used to recreate the item on restore.
+     */
+    payload: unknown;
+}
+//# sourceMappingURL=trash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trash.d.ts","sourceRoot":"","sources":["../../src/types/trash.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,QAAQ,GACR,SAAS,GACT,UAAU,GACV,WAAW,GACX,SAAS,GACT,aAAa,GACb,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,UAAU,EAAE,eAAe,CAAC;IAE5B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAErC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,UAAU,EAAE,eAAe,CAAC;IAE5B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAErC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/types/trash.js

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

package/dist/types/trash.js.map

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

package/dist/types/window.d.ts

@@ -0,0 +1,14 @@
+import type { Api } from './api';
+declare global {
+    /**
+     * Extends Window with the preload-exposed API.
+     */
+    interface Window {
+        /**
+         * IPC bridge for collections, saved requests, and HTTP execution.
+         */
+        api: Api;
+    }
+}
+export {};
+//# sourceMappingURL=window.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../../src/types/window.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAEjC,OAAO,CAAC,MAAM,CAAC;IACb;;OAEG;IACH,UAAU,MAAM;QACd;;WAEG;QACH,GAAG,EAAE,GAAG,CAAC;KACV;CACF;AAED,OAAO,EAAE,CAAC"}

package/dist/types/window.js

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

package/dist/types/window.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,7 @@
+export * from './types/index';
+export type { AuthConfig, AuthType, OAuthFetchTokenResult } from './auth';
+export type { ShortcutBinding, ShortcutId, ShortcutOverrides } from './shortcuts';
+export type { PluginAssetResult, PluginEntryKind, PluginFsPickFileOptions, PluginFsSaveFileOptions, PluginGitPreview, PluginInfo, PluginPermission, ResolvedThemeImport, SerializableMenuContribution } from './plugin/types';
+export type { PluginCatalog, PluginCatalogEntry, PluginSourcesSettings, ThemeCatalog } from './plugin/catalog';
+export type { CollectionRunnerConfig } from './collectionRunner';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAE9B,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,QAAQ,CAAC;AAC1E,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAClF,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,4BAA4B,EAC7B,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export * from './types/index';
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/urlencoded.d.ts

@@ -0,0 +1,2 @@
+export { emptyUrlEncodedPart, normalizeUrlEncodedPart, parseUrlEncodedParts, serializeUrlEncodedParts } from '@harborclient/http/urlencoded';
+//# sourceMappingURL=urlencoded.d.ts.map

package/dist/urlencoded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlencoded.d.ts","sourceRoot":"","sources":["../src/urlencoded.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,+BAA+B,CAAC"}

package/dist/urlencoded.js

@@ -0,0 +1,2 @@
+export { emptyUrlEncodedPart, normalizeUrlEncodedPart, parseUrlEncodedParts, serializeUrlEncodedParts } from '@harborclient/http/urlencoded';
+//# sourceMappingURL=urlencoded.js.map

package/dist/urlencoded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlencoded.js","sourceRoot":"","sources":["../src/urlencoded.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,+BAA+B,CAAC"}

package/dist/urlencodedRaw.d.ts

@@ -0,0 +1,23 @@
+import type { KeyValue } from './types/common';
+/**
+ * Builds an application/x-www-form-urlencoded wire string from enabled key-value rows.
+ *
+ * Mirrors {@link Body.buildUrlEncoded} so the Raw body drawer shows the same encoding
+ * the structured editor would send when no raw override is active.
+ *
+ * @param rows - Key-value rows from the form-urlencoded editor.
+ * @returns Encoded `k=v&k2=v2` string for enabled rows with a non-empty key.
+ */
+export declare function rowsToRawUrlEncoded(rows: KeyValue[]): string;
+/**
+ * Tolerantly parses a raw urlencoded body into key-value rows for the table preview.
+ *
+ * Never throws. Splits on `&` and takes the first `=` in each segment so unusual or
+ * intentionally invalid fragments (missing values, bare keys, trailing `&`) remain
+ * visible in the structured editor. All returned rows are enabled.
+ *
+ * @param text - Verbatim urlencoded body text from the Raw editor.
+ * @returns Best-effort key-value rows; empty when `text` is blank.
+ */
+export declare function rawUrlEncodedToRows(text: string): KeyValue[];
+//# sourceMappingURL=urlencodedRaw.d.ts.map

package/dist/urlencodedRaw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlencodedRaw.d.ts","sourceRoot":"","sources":["../src/urlencodedRaw.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,CAS5D;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CAgC5D"}

package/dist/urlencodedRaw.js

@@ -0,0 +1,60 @@
+/**
+ * Builds an application/x-www-form-urlencoded wire string from enabled key-value rows.
+ *
+ * Mirrors {@link Body.buildUrlEncoded} so the Raw body drawer shows the same encoding
+ * the structured editor would send when no raw override is active.
+ *
+ * @param rows - Key-value rows from the form-urlencoded editor.
+ * @returns Encoded `k=v&k2=v2` string for enabled rows with a non-empty key.
+ */
+export function rowsToRawUrlEncoded(rows) {
+    const params = new URLSearchParams();
+    for (const row of rows) {
+        if (!row.enabled || !row.key.trim()) {
+            continue;
+        }
+        params.append(row.key.trim(), row.value);
+    }
+    return params.toString();
+}
+/**
+ * Tolerantly parses a raw urlencoded body into key-value rows for the table preview.
+ *
+ * Never throws. Splits on `&` and takes the first `=` in each segment so unusual or
+ * intentionally invalid fragments (missing values, bare keys, trailing `&`) remain
+ * visible in the structured editor. All returned rows are enabled.
+ *
+ * @param text - Verbatim urlencoded body text from the Raw editor.
+ * @returns Best-effort key-value rows; empty when `text` is blank.
+ */
+export function rawUrlEncodedToRows(text) {
+    if (!text) {
+        return [];
+    }
+    const rows = [];
+    for (const segment of text.split('&')) {
+        if (segment === '') {
+            continue;
+        }
+        const equalsIndex = segment.indexOf('=');
+        const rawKey = equalsIndex === -1 ? segment : segment.slice(0, equalsIndex);
+        const rawValue = equalsIndex === -1 ? '' : segment.slice(equalsIndex + 1);
+        let key = rawKey;
+        let value = rawValue;
+        try {
+            key = decodeURIComponent(rawKey.replace(/\+/g, ' '));
+        }
+        catch {
+            key = rawKey;
+        }
+        try {
+            value = decodeURIComponent(rawValue.replace(/\+/g, ' '));
+        }
+        catch {
+            value = rawValue;
+        }
+        rows.push({ key, value, enabled: true });
+    }
+    return rows;
+}
+//# sourceMappingURL=urlencodedRaw.js.map

package/dist/urlencodedRaw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlencodedRaw.js","sourceRoot":"","sources":["../src/urlencodedRaw.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAgB;IAClD,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;YACpC,SAAS;QACX,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,IAAI,GAAe,EAAE,CAAC;IAC5B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;YACnB,SAAS;QACX,CAAC;QAED,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QAC5E,MAAM,QAAQ,GAAG,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;QAE1E,IAAI,GAAG,GAAG,MAAM,CAAC;QACjB,IAAI,KAAK,GAAG,QAAQ,CAAC;QACrB,IAAI,CAAC;YACH,GAAG,GAAG,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,GAAG,MAAM,CAAC;QACf,CAAC;QACD,IAAI,CAAC;YACH,KAAK,GAAG,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,GAAG,QAAQ,CAAC;QACnB,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/userAgent.d.ts

@@ -0,0 +1,132 @@
+import type { KeyValue } from './types';
+/**
+ * Legacy hardcoded HarborClient User-Agent used before first-run dynamic capture.
+ *
+ * Detected once at app startup so existing installs migrate to a machine-specific string.
+ */
+export declare const LEGACY_STATIC_HARBOR_CLIENT_USER_AGENT = "HarborClient/1.0.0 (Windows NT 10.0; Win64; x64) Electron/39.0.0 Chrome/140.0.0.0";
+/**
+ * Generic fallback User-Agent when no persisted machine-specific value exists
+ * (for example CLI-only usage before the desktop app has run).
+ */
+export declare const DEFAULT_USER_AGENT = "HarborClient/0.0.0 (Unknown) Electron/0.0.0 Chrome/0.0.0";
+/**
+ * Built-in browser User-Agent presets shown in every User-Agent control.
+ *
+ * The HarborClient string is not a builtin; it is captured from the host on first
+ * run and stored in general settings `customUserAgents`.
+ */
+export declare const BUILTIN_USER_AGENT_PRESETS: readonly string[];
+/**
+ * Runtime inputs used to build a machine-specific HarborClient User-Agent.
+ */
+export interface HarborClientUserAgentRuntime {
+    /**
+     * Desktop app version from Electron `app.getVersion()`.
+     */
+    appVersion: string;
+    /**
+     * Node process platform (`win32`, `darwin`, `linux`, …).
+     */
+    platform: NodeJS.Platform;
+    /**
+     * CPU architecture (`x64`, `arm64`, …).
+     */
+    arch: string;
+    /**
+     * Kernel release from `os.release()` (used for Windows NT version).
+     */
+    osRelease: string;
+    /**
+     * Electron version string.
+     */
+    electronVersion: string;
+    /**
+     * Chromium version string bundled with Electron.
+     */
+    chromeVersion: string;
+    /**
+     * Optional macOS product version from `process.getSystemVersion()`.
+     */
+    systemVersion?: string;
+}
+/**
+ * Builds a HarborClient User-Agent from explicit runtime version and OS fields.
+ *
+ * @param runtime - App, Electron, Chrome, and OS identity for this machine.
+ * @returns Fully formed HarborClient User-Agent string.
+ */
+export declare function buildHarborClientUserAgent(runtime: HarborClientUserAgentRuntime): string;
+/**
+ * Normalizes a scoped or global User-Agent string.
+ *
+ * @param value - Raw User-Agent from storage or UI.
+ * @returns Trimmed value, or empty string when missing/invalid.
+ */
+export declare function normalizeUserAgent(value: unknown): string;
+/**
+ * Normalizes user-added User-Agent presets, dropping builtins and duplicates.
+ *
+ * @param input - Raw custom User-Agent list from storage or UI.
+ * @returns Unique trimmed custom values not already in the built-in list.
+ */
+export declare function normalizeCustomUserAgents(input: unknown): string[];
+/**
+ * Merges built-in presets with user-added customs for autocomplete/select lists.
+ *
+ * @param customUserAgents - User-added values from general settings.
+ * @returns Built-ins first, then customs (already normalized).
+ */
+export declare function listUserAgentPresets(customUserAgents?: readonly string[]): string[];
+/**
+ * Appends a custom User-Agent when it is not already a built-in or custom entry.
+ *
+ * @param customUserAgents - Current custom list.
+ * @param value - Candidate value from the User-Agent control.
+ * @returns Updated custom list, or the original array when nothing new was added.
+ */
+export declare function appendCustomUserAgent(customUserAgents: readonly string[], value: string): string[];
+/**
+ * Returns whether an enabled key/value header already supplies User-Agent.
+ *
+ * @param headers - Inherited and request-specific header rows.
+ * @returns True when a non-empty User-Agent header is enabled.
+ */
+export declare function hasManualUserAgentHeader(headers: KeyValue[]): boolean;
+/**
+ * Scopes that contribute to the effective User-Agent, highest precedence first.
+ */
+export interface UserAgentScopes {
+    /**
+     * Request-level override; empty inherits.
+     */
+    request?: string | null;
+    /**
+     * Folder-level override; empty inherits.
+     */
+    folder?: string | null;
+    /**
+     * Collection-level override; empty inherits.
+     */
+    collection?: string | null;
+    /**
+     * Global default from general settings; omit when unavailable at this layer.
+     */
+    general?: string | null;
+}
+/**
+ * Resolves the User-Agent string from request → folder → collection → general.
+ *
+ * @param scopes - Scoped and global User-Agent values.
+ * @returns Effective User-Agent, or null when every scope is empty.
+ */
+export declare function resolveEffectiveUserAgent(scopes: UserAgentScopes): string | null;
+/**
+ * Injects a User-Agent header when none is already present in the key/value list.
+ *
+ * @param headers - Outbound header rows (mutated only via returned copy).
+ * @param scopes - Scoped and global User-Agent values.
+ * @returns Headers with User-Agent prepended when a non-empty value resolves.
+ */
+export declare function applyUserAgentHeader(headers: KeyValue[], scopes: UserAgentScopes): KeyValue[];
+//# sourceMappingURL=userAgent.d.ts.map

package/dist/userAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"userAgent.d.ts","sourceRoot":"","sources":["../src/userAgent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,sCAAsC,sFACkC,CAAC;AAEtF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,6DAA6D,CAAC;AAE7F;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAMvD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAE1B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAmCD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,4BAA4B,GAAG,MAAM,CAMxF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAuBlE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,gBAAgB,GAAE,SAAS,MAAM,EAAO,GAAG,MAAM,EAAE,CAGvF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,gBAAgB,EAAE,SAAS,MAAM,EAAE,EACnC,KAAK,EAAE,MAAM,GACZ,MAAM,EAAE,CAaV;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,CAOrE;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAQhF;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,eAAe,GAAG,QAAQ,EAAE,CAS7F"}

package/dist/userAgent.js

@@ -0,0 +1,178 @@
+/**
+ * Legacy hardcoded HarborClient User-Agent used before first-run dynamic capture.
+ *
+ * Detected once at app startup so existing installs migrate to a machine-specific string.
+ */
+export const LEGACY_STATIC_HARBOR_CLIENT_USER_AGENT = 'HarborClient/1.0.0 (Windows NT 10.0; Win64; x64) Electron/39.0.0 Chrome/140.0.0.0';
+/**
+ * Generic fallback User-Agent when no persisted machine-specific value exists
+ * (for example CLI-only usage before the desktop app has run).
+ */
+export const DEFAULT_USER_AGENT = 'HarborClient/0.0.0 (Unknown) Electron/0.0.0 Chrome/0.0.0';
+/**
+ * Built-in browser User-Agent presets shown in every User-Agent control.
+ *
+ * The HarborClient string is not a builtin; it is captured from the host on first
+ * run and stored in general settings `customUserAgents`.
+ */
+export const BUILTIN_USER_AGENT_PRESETS = [
+    'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/147.0.0.0 Safari/537.36',
+    'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/147.0.0.0 Safari/537.36',
+    'Mozilla/5.0 (X11; Linux x86_64; rv:147.0) Gecko/20100101 Firefox/147.0',
+    'Mozilla/5.0 (Linux; Android 16; SM-S921U) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/147.0.0.0 Mobile Safari/537.36',
+    'Mozilla/5.0 (iPhone; CPU iPhone OS 18_6 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.6 Mobile/15E148 Safari/604.1'
+];
+/**
+ * Builds the Chromium-style OS token for the HarborClient User-Agent parenthetical.
+ *
+ * @param runtime - Host platform, arch, and OS version fields.
+ * @returns Parenthetical OS segment without surrounding parentheses.
+ */
+function buildHarborClientOsToken(runtime) {
+    const arch = runtime.arch.trim() || 'unknown';
+    if (runtime.platform === 'win32') {
+        const nt = runtime.osRelease.trim() || '10.0';
+        if (arch === 'arm64') {
+            return `Windows NT ${nt}; ARM64`;
+        }
+        if (arch === 'ia32') {
+            return `Windows NT ${nt}; Win32`;
+        }
+        return `Windows NT ${nt}; Win64; x64`;
+    }
+    if (runtime.platform === 'darwin') {
+        const raw = (runtime.systemVersion?.trim() || runtime.osRelease.trim() || '10_15_7').replace(/\./g, '_');
+        const cpu = arch === 'arm64' ? 'ARM' : 'Intel';
+        return `Macintosh; ${cpu} Mac OS X ${raw}`;
+    }
+    if (runtime.platform === 'linux') {
+        const linuxArch = arch === 'arm64' ? 'aarch64' : arch === 'x64' ? 'x86_64' : arch;
+        return `X11; Linux ${linuxArch}`;
+    }
+    return `${runtime.platform}; ${arch}`;
+}
+/**
+ * Builds a HarborClient User-Agent from explicit runtime version and OS fields.
+ *
+ * @param runtime - App, Electron, Chrome, and OS identity for this machine.
+ * @returns Fully formed HarborClient User-Agent string.
+ */
+export function buildHarborClientUserAgent(runtime) {
+    const appVersion = runtime.appVersion.trim() || '0.0.0';
+    const electronVersion = runtime.electronVersion.trim() || '0.0.0';
+    const chromeVersion = runtime.chromeVersion.trim() || '0.0.0';
+    const osToken = buildHarborClientOsToken(runtime);
+    return `HarborClient/${appVersion} (${osToken}) Electron/${electronVersion} Chrome/${chromeVersion}`;
+}
+/**
+ * Normalizes a scoped or global User-Agent string.
+ *
+ * @param value - Raw User-Agent from storage or UI.
+ * @returns Trimmed value, or empty string when missing/invalid.
+ */
+export function normalizeUserAgent(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+/**
+ * Normalizes user-added User-Agent presets, dropping builtins and duplicates.
+ *
+ * @param input - Raw custom User-Agent list from storage or UI.
+ * @returns Unique trimmed custom values not already in the built-in list.
+ */
+export function normalizeCustomUserAgents(input) {
+    if (!Array.isArray(input)) {
+        return [];
+    }
+    const builtin = new Set(BUILTIN_USER_AGENT_PRESETS.map((entry) => entry.toLowerCase()));
+    const seen = new Set();
+    const customs = [];
+    for (const entry of input) {
+        if (typeof entry !== 'string') {
+            continue;
+        }
+        const trimmed = entry.trim();
+        if (!trimmed) {
+            continue;
+        }
+        const key = trimmed.toLowerCase();
+        if (builtin.has(key) || seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        customs.push(trimmed);
+    }
+    return customs;
+}
+/**
+ * Merges built-in presets with user-added customs for autocomplete/select lists.
+ *
+ * @param customUserAgents - User-added values from general settings.
+ * @returns Built-ins first, then customs (already normalized).
+ */
+export function listUserAgentPresets(customUserAgents = []) {
+    const customs = normalizeCustomUserAgents(customUserAgents);
+    return [...BUILTIN_USER_AGENT_PRESETS, ...customs];
+}
+/**
+ * Appends a custom User-Agent when it is not already a built-in or custom entry.
+ *
+ * @param customUserAgents - Current custom list.
+ * @param value - Candidate value from the User-Agent control.
+ * @returns Updated custom list, or the original array when nothing new was added.
+ */
+export function appendCustomUserAgent(customUserAgents, value) {
+    const trimmed = normalizeUserAgent(value);
+    if (!trimmed) {
+        return [...customUserAgents];
+    }
+    const current = normalizeCustomUserAgents(customUserAgents);
+    const known = new Set([...BUILTIN_USER_AGENT_PRESETS, ...current].map((entry) => entry.toLowerCase()));
+    if (known.has(trimmed.toLowerCase())) {
+        return current;
+    }
+    return [...current, trimmed];
+}
+/**
+ * Returns whether an enabled key/value header already supplies User-Agent.
+ *
+ * @param headers - Inherited and request-specific header rows.
+ * @returns True when a non-empty User-Agent header is enabled.
+ */
+export function hasManualUserAgentHeader(headers) {
+    return headers.some((header) => header.enabled &&
+        header.key.trim().toLowerCase() === 'user-agent' &&
+        header.value.trim() !== '');
+}
+/**
+ * Resolves the User-Agent string from request → folder → collection → general.
+ *
+ * @param scopes - Scoped and global User-Agent values.
+ * @returns Effective User-Agent, or null when every scope is empty.
+ */
+export function resolveEffectiveUserAgent(scopes) {
+    for (const candidate of [scopes.request, scopes.folder, scopes.collection, scopes.general]) {
+        const trimmed = normalizeUserAgent(candidate);
+        if (trimmed) {
+            return trimmed;
+        }
+    }
+    return null;
+}
+/**
+ * Injects a User-Agent header when none is already present in the key/value list.
+ *
+ * @param headers - Outbound header rows (mutated only via returned copy).
+ * @param scopes - Scoped and global User-Agent values.
+ * @returns Headers with User-Agent prepended when a non-empty value resolves.
+ */
+export function applyUserAgentHeader(headers, scopes) {
+    if (hasManualUserAgentHeader(headers)) {
+        return headers;
+    }
+    const value = resolveEffectiveUserAgent(scopes);
+    if (!value) {
+        return headers;
+    }
+    return [{ key: 'User-Agent', value, enabled: true }, ...headers];
+}
+//# sourceMappingURL=userAgent.js.map

package/dist/userAgent.js.map

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

package/dist/zoomPresets.d.ts

@@ -0,0 +1,38 @@
+/** Default zoom factor for the main renderer (100%). */
+export declare const DEFAULT_ZOOM_FACTOR = 1;
+/** Zoom step applied by View menu and keyboard shortcuts. */
+export declare const ZOOM_STEP = 0.1;
+/** Minimum zoom factor allowed for the main renderer. */
+export declare const MIN_ZOOM_FACTOR = 0.3;
+/** Maximum zoom factor allowed for the main renderer. */
+export declare const MAX_ZOOM_FACTOR = 5;
+/**
+ * First-run display size preset expressed as a step offset from the default zoom.
+ */
+export type ZoomPreset = '-1' | '1' | '+1';
+/**
+ * Selectable display size options shown in the first-run theme picker.
+ */
+export declare const ZOOM_PRESET_OPTIONS: ReadonlyArray<{
+    value: ZoomPreset;
+    label: string;
+}>;
+/**
+ * Rounds a zoom factor to one decimal place for stable menu stepping.
+ *
+ * @param factor - Raw zoom factor value.
+ */
+export declare function roundZoomFactor(factor: number): number;
+/**
+ * Maps a first-run display size preset to its zoom factor.
+ *
+ * @param preset - Step offset from the default zoom factor.
+ */
+export declare function zoomPresetToFactor(preset: ZoomPreset): number;
+/**
+ * Maps a zoom factor back to the closest first-run display size preset.
+ *
+ * @param factor - Current zoom factor.
+ */
+export declare function zoomFactorToPreset(factor: number): ZoomPreset;
+//# sourceMappingURL=zoomPresets.d.ts.map

package/dist/zoomPresets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zoomPresets.d.ts","sourceRoot":"","sources":["../src/zoomPresets.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,6DAA6D;AAC7D,eAAO,MAAM,SAAS,MAAM,CAAC;AAE7B,yDAAyD;AACzD,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,yDAAyD;AACzD,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAInF,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAYD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAU7D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAY7D"}