@harborclient/core 0.1.1

package/dist/filestore/variables.js

@@ -0,0 +1,15 @@
+/**
+ * Coerces a partial or legacy variable record to the full Variable shape.
+ *
+ * @param v - Raw variable fields from storage or import.
+ * @returns Normalized variable with defaults for missing fields.
+ */
+export function normalizeVariable(v) {
+    return {
+        key: typeof v.key === 'string' ? v.key : '',
+        value: typeof v.value === 'string' ? v.value : '',
+        defaultValue: typeof v.defaultValue === 'string' ? v.defaultValue : '',
+        share: v.share === true
+    };
+}
+//# sourceMappingURL=variables.js.map

package/dist/filestore/variables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables.js","sourceRoot":"","sources":["../../src/filestore/variables.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,CAAoB;IACpD,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QAC3C,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QACjD,YAAY,EAAE,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE;QACtE,KAAK,EAAE,CAAC,CAAC,KAAK,KAAK,IAAI;KACxB,CAAC;AACJ,CAAC"}

package/dist/formData.d.ts

@@ -0,0 +1,2 @@
+export { emptyFormPart, normalizeFormPart, parseFormParts, serializeFormParts } from '@harborclient/http/formData';
+//# sourceMappingURL=formData.d.ts.map

package/dist/formData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formData.d.ts","sourceRoot":"","sources":["../src/formData.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EACnB,MAAM,6BAA6B,CAAC"}

package/dist/formData.js

@@ -0,0 +1,2 @@
+export { emptyFormPart, normalizeFormPart, parseFormParts, serializeFormParts } from '@harborclient/http/formData';
+//# sourceMappingURL=formData.js.map

package/dist/formData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formData.js","sourceRoot":"","sources":["../src/formData.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EACnB,MAAM,6BAA6B,CAAC"}

package/dist/generalSettings.d.ts

@@ -0,0 +1,22 @@
+import { DEFAULT_PROXY_SETTINGS, HARD_MAX_RESPONSE_SIZE_MB } from '@harborclient/http';
+import type { GeneralSettings, Variable } from './types';
+export { HARD_MAX_RESPONSE_SIZE_MB, DEFAULT_PROXY_SETTINGS };
+/**
+ * Default general settings applied when storage is empty or fields are invalid.
+ */
+export declare const DEFAULT_GENERAL_SETTINGS: GeneralSettings;
+/**
+ * Normalizes a collection/environment variable row.
+ *
+ * @param v - Partial variable from storage or user input.
+ * @returns Normalized variable.
+ */
+export declare function normalizeVariable(v: Partial<Variable>): Variable;
+/**
+ * Normalizes a general settings object with defaults for invalid fields.
+ *
+ * @param input - Raw settings from storage or user input.
+ * @returns Normalized settings.
+ */
+export declare function normalizeGeneralSettings(input: Partial<GeneralSettings>): GeneralSettings;
+//# sourceMappingURL=generalSettings.d.ts.map

package/dist/generalSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generalSettings.d.ts","sourceRoot":"","sources":["../src/generalSettings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAQvF,OAAO,KAAK,EAAE,eAAe,EAAgC,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGvF,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,eAqCtC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAOhE;AA2FD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAsDzF"}

package/dist/generalSettings.js

@@ -0,0 +1,188 @@
+import { DEFAULT_PROXY_SETTINGS, HARD_MAX_RESPONSE_SIZE_MB } from '@harborclient/http';
+import { DEFAULT_CODE_EDITOR_FONT_SIZE, DEFAULT_CODE_EDITOR_SETUP, normalizeCodeEditorFontSize, normalizeCodeEditorSetup, normalizeCodeEditorTheme } from './codeEditorSettings';
+import { DEFAULT_USER_AGENT, normalizeCustomUserAgents, normalizeUserAgent } from './userAgent';
+export { HARD_MAX_RESPONSE_SIZE_MB, DEFAULT_PROXY_SETTINGS };
+/**
+ * Default general settings applied when storage is empty or fields are invalid.
+ */
+export const DEFAULT_GENERAL_SETTINGS = {
+    requestTimeoutMs: 30000,
+    scriptTimeoutMs: 5000,
+    allowScriptNetworkRequests: false,
+    allowedNetworkPlugins: [],
+    allowScriptFileRead: false,
+    allowScriptFileWrite: false,
+    scriptFileRoot: '',
+    maxResponseSizeMb: 50,
+    verifySsl: true,
+    followRedirects: true,
+    userAgent: DEFAULT_USER_AGENT,
+    customUserAgents: [],
+    scrollbarAutoHide: false,
+    wrapTabs: true,
+    closeToTray: false,
+    spellCheckEnabled: true,
+    warnWhenSwitchingThemes: true,
+    warnWhenExitingWithUnsavedChanges: true,
+    warnWhenClosingUnsavedRequests: true,
+    warnWhenEditingSnippet: true,
+    warnWhenCloningSnippet: true,
+    warnWhenClickingReadonlySnippet: true,
+    warnWhenCreatingTabGroup: true,
+    warnWhenOpeningTabGroup: true,
+    warnWhenAgentUsesTerminal: true,
+    gitAutoAdd: true,
+    externalMergeEditorPath: '',
+    gitCommitAuthorName: '',
+    gitCommitAuthorEmail: '',
+    gitCommitAuthorPrompted: false,
+    codeEditorTheme: 'default',
+    codeEditorSetup: { ...DEFAULT_CODE_EDITOR_SETUP },
+    codeEditorFontSize: DEFAULT_CODE_EDITOR_FONT_SIZE,
+    proxy: { ...DEFAULT_PROXY_SETTINGS },
+    globalVariables: [],
+    logFilePath: ''
+};
+/**
+ * Normalizes a collection/environment variable row.
+ *
+ * @param v - Partial variable from storage or user input.
+ * @returns Normalized variable.
+ */
+export function normalizeVariable(v) {
+    return {
+        key: typeof v.key === 'string' ? v.key : '',
+        value: typeof v.value === 'string' ? v.value : '',
+        defaultValue: typeof v.defaultValue === 'string' ? v.defaultValue : '',
+        share: v.share === true
+    };
+}
+/**
+ * Normalizes a non-negative number, falling back to the default when invalid.
+ *
+ * @param value - Raw numeric value from storage or input.
+ * @param fallback - Default when value is not a finite number >= 0.
+ * @returns Normalized number.
+ */
+function normalizeNonNegativeNumber(value, fallback) {
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed < 0) {
+        return fallback;
+    }
+    return parsed;
+}
+/**
+ * Normalizes a positive integer port, falling back to the default when invalid.
+ *
+ * @param value - Raw port from storage or input.
+ * @param fallback - Default when value is not a finite integer in 1–65535.
+ * @returns Normalized port.
+ */
+function normalizePort(value, fallback) {
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 1 || parsed > 65535) {
+        return fallback;
+    }
+    return parsed;
+}
+/**
+ * Normalizes proxy protocol to http or https.
+ *
+ * @param value - Raw protocol from storage or input.
+ * @returns Normalized protocol.
+ */
+function normalizeProxyProtocol(value) {
+    return value === 'https' ? 'https' : 'http';
+}
+/**
+ * Normalizes proxy settings with defaults for invalid fields.
+ *
+ * @param input - Raw proxy settings from storage or user input.
+ * @returns Normalized proxy settings.
+ */
+function normalizeProxySettings(input) {
+    return {
+        enabled: input?.enabled === true,
+        protocol: normalizeProxyProtocol(input?.protocol),
+        host: typeof input?.host === 'string' ? input.host.trim() : DEFAULT_PROXY_SETTINGS.host,
+        port: normalizePort(input?.port, DEFAULT_PROXY_SETTINGS.port),
+        authEnabled: input?.authEnabled === true,
+        username: typeof input?.username === 'string' ? input.username : DEFAULT_PROXY_SETTINGS.username,
+        password: typeof input?.password === 'string' ? input.password : DEFAULT_PROXY_SETTINGS.password
+    };
+}
+/**
+ * Normalizes stored global variable rows with defaults for invalid entries.
+ *
+ * @param input - Raw global variable list from storage or user input.
+ * @returns Normalized variable rows.
+ */
+function normalizeGlobalVariables(input) {
+    if (!Array.isArray(input)) {
+        return [];
+    }
+    return input.map((entry) => normalizeVariable(entry));
+}
+/**
+ * Normalizes the plugin allowlist used when script network requests are disabled globally.
+ *
+ * @param input - Raw plugin id list from storage or user input.
+ * @returns Unique trimmed plugin manifest ids.
+ */
+function normalizeAllowedNetworkPlugins(input) {
+    if (!Array.isArray(input)) {
+        return [];
+    }
+    const ids = input
+        .filter((entry) => typeof entry === 'string')
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+    return [...new Set(ids)];
+}
+/**
+ * Normalizes a general settings object with defaults for invalid fields.
+ *
+ * @param input - Raw settings from storage or user input.
+ * @returns Normalized settings.
+ */
+export function normalizeGeneralSettings(input) {
+    return {
+        requestTimeoutMs: normalizeNonNegativeNumber(input.requestTimeoutMs, DEFAULT_GENERAL_SETTINGS.requestTimeoutMs),
+        scriptTimeoutMs: normalizeNonNegativeNumber(input.scriptTimeoutMs, DEFAULT_GENERAL_SETTINGS.scriptTimeoutMs),
+        allowScriptNetworkRequests: input.allowScriptNetworkRequests === true,
+        allowedNetworkPlugins: normalizeAllowedNetworkPlugins(input.allowedNetworkPlugins),
+        allowScriptFileRead: input.allowScriptFileRead === true,
+        allowScriptFileWrite: input.allowScriptFileWrite === true,
+        scriptFileRoot: typeof input.scriptFileRoot === 'string' ? input.scriptFileRoot.trim() : '',
+        maxResponseSizeMb: Math.min(normalizeNonNegativeNumber(input.maxResponseSizeMb, DEFAULT_GENERAL_SETTINGS.maxResponseSizeMb), HARD_MAX_RESPONSE_SIZE_MB),
+        verifySsl: input.verifySsl !== false,
+        followRedirects: input.followRedirects !== false,
+        userAgent: normalizeUserAgent(input.userAgent) || DEFAULT_USER_AGENT,
+        customUserAgents: normalizeCustomUserAgents(input.customUserAgents),
+        scrollbarAutoHide: input.scrollbarAutoHide === true,
+        wrapTabs: input.wrapTabs !== false,
+        closeToTray: input.closeToTray === true,
+        spellCheckEnabled: input.spellCheckEnabled !== false,
+        warnWhenSwitchingThemes: input.warnWhenSwitchingThemes !== false,
+        warnWhenExitingWithUnsavedChanges: input.warnWhenExitingWithUnsavedChanges !== false,
+        warnWhenClosingUnsavedRequests: input.warnWhenClosingUnsavedRequests !== false,
+        warnWhenEditingSnippet: input.warnWhenEditingSnippet !== false,
+        warnWhenCloningSnippet: input.warnWhenCloningSnippet !== false,
+        warnWhenClickingReadonlySnippet: input.warnWhenClickingReadonlySnippet !== false,
+        warnWhenCreatingTabGroup: input.warnWhenCreatingTabGroup !== false,
+        warnWhenOpeningTabGroup: input.warnWhenOpeningTabGroup !== false,
+        warnWhenAgentUsesTerminal: input.warnWhenAgentUsesTerminal !== false,
+        gitAutoAdd: input.gitAutoAdd !== false,
+        externalMergeEditorPath: typeof input.externalMergeEditorPath === 'string' ? input.externalMergeEditorPath.trim() : '',
+        gitCommitAuthorName: typeof input.gitCommitAuthorName === 'string' ? input.gitCommitAuthorName.trim() : '',
+        gitCommitAuthorEmail: typeof input.gitCommitAuthorEmail === 'string' ? input.gitCommitAuthorEmail.trim() : '',
+        gitCommitAuthorPrompted: input.gitCommitAuthorPrompted === true,
+        codeEditorTheme: normalizeCodeEditorTheme(input.codeEditorTheme),
+        codeEditorSetup: normalizeCodeEditorSetup(input.codeEditorSetup),
+        codeEditorFontSize: normalizeCodeEditorFontSize(input.codeEditorFontSize),
+        proxy: normalizeProxySettings(input.proxy),
+        globalVariables: normalizeGlobalVariables(input.globalVariables),
+        logFilePath: typeof input.logFilePath === 'string' ? input.logFilePath.trim() : ''
+    };
+}
+//# sourceMappingURL=generalSettings.js.map

package/dist/generalSettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generalSettings.js","sourceRoot":"","sources":["../src/generalSettings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AACvF,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEhG,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,CAAC;AAE7D;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAoB;IACvD,gBAAgB,EAAE,KAAK;IACvB,eAAe,EAAE,IAAI;IACrB,0BAA0B,EAAE,KAAK;IACjC,qBAAqB,EAAE,EAAE;IACzB,mBAAmB,EAAE,KAAK;IAC1B,oBAAoB,EAAE,KAAK;IAC3B,cAAc,EAAE,EAAE;IAClB,iBAAiB,EAAE,EAAE;IACrB,SAAS,EAAE,IAAI;IACf,eAAe,EAAE,IAAI;IACrB,SAAS,EAAE,kBAAkB;IAC7B,gBAAgB,EAAE,EAAE;IACpB,iBAAiB,EAAE,KAAK;IACxB,QAAQ,EAAE,IAAI;IACd,WAAW,EAAE,KAAK;IAClB,iBAAiB,EAAE,IAAI;IACvB,uBAAuB,EAAE,IAAI;IAC7B,iCAAiC,EAAE,IAAI;IACvC,8BAA8B,EAAE,IAAI;IACpC,sBAAsB,EAAE,IAAI;IAC5B,sBAAsB,EAAE,IAAI;IAC5B,+BAA+B,EAAE,IAAI;IACrC,wBAAwB,EAAE,IAAI;IAC9B,uBAAuB,EAAE,IAAI;IAC7B,yBAAyB,EAAE,IAAI;IAC/B,UAAU,EAAE,IAAI;IAChB,uBAAuB,EAAE,EAAE;IAC3B,mBAAmB,EAAE,EAAE;IACvB,oBAAoB,EAAE,EAAE;IACxB,uBAAuB,EAAE,KAAK;IAC9B,eAAe,EAAE,SAAS;IAC1B,eAAe,EAAE,EAAE,GAAG,yBAAyB,EAAE;IACjD,kBAAkB,EAAE,6BAA6B;IACjD,KAAK,EAAE,EAAE,GAAG,sBAAsB,EAAE;IACpC,eAAe,EAAE,EAAE;IACnB,WAAW,EAAE,EAAE;CAChB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,CAAoB;IACpD,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QAC3C,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QACjD,YAAY,EAAE,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE;QACtE,KAAK,EAAE,CAAC,CAAC,KAAK,KAAK,IAAI;KACxB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,0BAA0B,CAAC,KAAc,EAAE,QAAgB;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,aAAa,CAAC,KAAc,EAAE,QAAgB;IACrD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,KAAK,EAAE,CAAC;QAC9D,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,SAAS,sBAAsB,CAAC,KAAc;IAC5C,OAAO,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,SAAS,sBAAsB,CAAC,KAAyC;IACvE,OAAO;QACL,OAAO,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI;QAChC,QAAQ,EAAE,sBAAsB,CAAC,KAAK,EAAE,QAAQ,CAAC;QACjD,IAAI,EAAE,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,sBAAsB,CAAC,IAAI;QACvF,IAAI,EAAE,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,sBAAsB,CAAC,IAAI,CAAC;QAC7D,WAAW,EAAE,KAAK,EAAE,WAAW,KAAK,IAAI;QACxC,QAAQ,EACN,OAAO,KAAK,EAAE,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,sBAAsB,CAAC,QAAQ;QACxF,QAAQ,EAAE,OAAO,KAAK,EAAE,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,sBAAsB,CAAC,QAAQ;KACjG,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,wBAAwB,CAAC,KAAc;IAC9C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,KAA0B,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED;;;;;GAKG;AACH,SAAS,8BAA8B,CAAC,KAAc;IACpD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,GAAG,GAAG,KAAK;SACd,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;SAC7D,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAA+B;IACtE,OAAO;QACL,gBAAgB,EAAE,0BAA0B,CAC1C,KAAK,CAAC,gBAAgB,EACtB,wBAAwB,CAAC,gBAAgB,CAC1C;QACD,eAAe,EAAE,0BAA0B,CACzC,KAAK,CAAC,eAAe,EACrB,wBAAwB,CAAC,eAAe,CACzC;QACD,0BAA0B,EAAE,KAAK,CAAC,0BAA0B,KAAK,IAAI;QACrE,qBAAqB,EAAE,8BAA8B,CAAC,KAAK,CAAC,qBAAqB,CAAC;QAClF,mBAAmB,EAAE,KAAK,CAAC,mBAAmB,KAAK,IAAI;QACvD,oBAAoB,EAAE,KAAK,CAAC,oBAAoB,KAAK,IAAI;QACzD,cAAc,EAAE,OAAO,KAAK,CAAC,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;QAC3F,iBAAiB,EAAE,IAAI,CAAC,GAAG,CACzB,0BAA0B,CACxB,KAAK,CAAC,iBAAiB,EACvB,wBAAwB,CAAC,iBAAiB,CAC3C,EACD,yBAAyB,CAC1B;QACD,SAAS,EAAE,KAAK,CAAC,SAAS,KAAK,KAAK;QACpC,eAAe,EAAE,KAAK,CAAC,eAAe,KAAK,KAAK;QAChD,SAAS,EAAE,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,kBAAkB;QACpE,gBAAgB,EAAE,yBAAyB,CAAC,KAAK,CAAC,gBAAgB,CAAC;QACnE,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,KAAK,IAAI;QACnD,QAAQ,EAAE,KAAK,CAAC,QAAQ,KAAK,KAAK;QAClC,WAAW,EAAE,KAAK,CAAC,WAAW,KAAK,IAAI;QACvC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,KAAK,KAAK;QACpD,uBAAuB,EAAE,KAAK,CAAC,uBAAuB,KAAK,KAAK;QAChE,iCAAiC,EAAE,KAAK,CAAC,iCAAiC,KAAK,KAAK;QACpF,8BAA8B,EAAE,KAAK,CAAC,8BAA8B,KAAK,KAAK;QAC9E,sBAAsB,EAAE,KAAK,CAAC,sBAAsB,KAAK,KAAK;QAC9D,sBAAsB,EAAE,KAAK,CAAC,sBAAsB,KAAK,KAAK;QAC9D,+BAA+B,EAAE,KAAK,CAAC,+BAA+B,KAAK,KAAK;QAChF,wBAAwB,EAAE,KAAK,CAAC,wBAAwB,KAAK,KAAK;QAClE,uBAAuB,EAAE,KAAK,CAAC,uBAAuB,KAAK,KAAK;QAChE,yBAAyB,EAAE,KAAK,CAAC,yBAAyB,KAAK,KAAK;QACpE,UAAU,EAAE,KAAK,CAAC,UAAU,KAAK,KAAK;QACtC,uBAAuB,EACrB,OAAO,KAAK,CAAC,uBAAuB,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;QAC/F,mBAAmB,EACjB,OAAO,KAAK,CAAC,mBAAmB,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;QACvF,oBAAoB,EAClB,OAAO,KAAK,CAAC,oBAAoB,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;QACzF,uBAAuB,EAAE,KAAK,CAAC,uBAAuB,KAAK,IAAI;QAC/D,eAAe,EAAE,wBAAwB,CAAC,KAAK,CAAC,eAAe,CAAC;QAChE,eAAe,EAAE,wBAAwB,CAAC,KAAK,CAAC,eAAe,CAAC;QAChE,kBAAkB,EAAE,2BAA2B,CAAC,KAAK,CAAC,kBAAkB,CAAC;QACzE,KAAK,EAAE,sBAAsB,CAAC,KAAK,CAAC,KAAK,CAAC;QAC1C,eAAe,EAAE,wBAAwB,CAAC,KAAK,CAAC,eAAe,CAAC;QAChE,WAAW,EAAE,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;KACnF,CAAC;AACJ,CAAC"}

package/dist/gitHttpErrors.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Git remote HTTP operations that can surface isomorphic-git HttpError failures.
+ */
+export type GitHttpOperation = 'fetch' | 'push' | 'pull' | 'validate';
+/**
+ * Optional context for richer GitHub access-denied messages.
+ */
+export interface GitHttpErrorContext {
+    /**
+     * GitHub username HarborClient is authenticated as, when known.
+     */
+    githubLogin?: string | null;
+    /**
+     * Repository owner from the remote URL (user or org login), for SSO hints.
+     */
+    owner?: string | null;
+}
+/**
+ * Strips Electron IPC invoke wrapper text from an error message.
+ *
+ * @param message - Raw error message from a renderer IPC call.
+ * @returns User-facing message without the internal invoke prefix.
+ */
+export declare function stripIpcInvokeErrorPrefix(message: string): string;
+/**
+ * Returns whether an error indicates GitHub (or another host) reported the
+ * repository as missing.
+ *
+ * GitHub often returns 404 for private repos when credentials cannot access
+ * them, even when the repository exists for a different account.
+ *
+ * @param err - Thrown value from isomorphic-git or a string message.
+ */
+export declare function isGitRepoNotFoundError(err: unknown): boolean;
+/**
+ * Formats a git remote HTTP error into an actionable user-facing message.
+ *
+ * For 404 / "not found" responses, explains that GitHub may be hiding access
+ * denied behind a missing-repo status and includes the signed-in account and
+ * org SSO link when context is available. Other errors keep their original message.
+ *
+ * @param err - Thrown value from isomorphic-git or related validation.
+ * @param operation - Remote operation that failed (shown in the message).
+ * @param context - Optional signed-in login and repository owner for diagnostics.
+ * @returns User-facing error string suitable for toasts and form alerts.
+ */
+export declare function formatGitHttpError(err: unknown, operation: GitHttpOperation, context?: GitHttpErrorContext): string;
+/**
+ * Builds a diagnostic "repository not found" message with account and SSO hints.
+ *
+ * @param operation - Remote operation label, or null to omit the operation clause.
+ * @param context - Signed-in login and repository owner when known.
+ */
+export declare function githubRepoNotFoundMessage(operation: GitHttpOperation | null, context?: GitHttpErrorContext): string;
+/**
+ * Builds a diagnostic message when GitHub requires SAML SSO authorization (403).
+ *
+ * @param operation - Remote operation label, or null to omit the operation clause.
+ * @param context - Signed-in login and repository owner when known.
+ * @param ssoUrl - SSO authorization URL from the `x-github-sso` header, when present.
+ */
+export declare function githubSsoRequiredMessage(operation: GitHttpOperation | null, context?: GitHttpErrorContext, ssoUrl?: string | null): string;
+/**
+ * Builds a diagnostic message when GitHub rate-limits the request (403/429).
+ *
+ * @param operation - Remote operation label, or null to omit the operation clause.
+ * @param retryAfterSeconds - Seconds to wait from a `retry-after` header, when present.
+ */
+export declare function githubRateLimitMessage(operation: GitHttpOperation | null, retryAfterSeconds?: number | null): string;
+/**
+ * Returns whether a GitHub API error message indicates org OAuth App access restrictions.
+ *
+ * @param message - Raw `message` field from a GitHub REST error body.
+ */
+export declare function isGitHubOAuthAppRestrictionMessage(message: string): boolean;
+/**
+ * Extracts an organization login from GitHub's OAuth-restriction error text when present.
+ *
+ * GitHub's message typically includes backtick-quoted org names, e.g.
+ * `the \`harborclient\` organization has enabled OAuth App access restrictions`.
+ *
+ * @param message - Raw GitHub REST error `message` field.
+ * @returns Organization login when found, otherwise null.
+ */
+export declare function ownerFromOAuthAppRestrictionMessage(message: string): string | null;
+/**
+ * Builds a diagnostic message when an org blocks the OAuth App (403).
+ *
+ * @param operation - Remote operation label, or null to omit the operation clause.
+ * @param context - Signed-in login and repository owner when known.
+ */
+export declare function githubOAuthAppRestrictionMessage(operation: GitHttpOperation | null, context?: GitHttpErrorContext): string;
+/**
+ * Builds a diagnostic message for a generic GitHub 403 (insufficient permissions/scope).
+ *
+ * @param operation - Remote operation label, or null to omit the operation clause.
+ * @param context - Signed-in login and repository owner when known.
+ */
+export declare function githubForbiddenMessage(operation: GitHttpOperation | null, context?: GitHttpErrorContext): string;
+/**
+ * Builds a user-facing message when credentials were saved but repo validation failed.
+ *
+ * Prefer the main-process diagnostic message when it already includes account or SSO
+ * guidance; otherwise fall back to a generic 404 explanation.
+ *
+ * @param validationError - Raw or already-formatted validation error from the main process.
+ */
+export declare function credentialsSavedValidationMessage(validationError: string): string;
+/**
+ * Builds a warning when credentials can read a repository but cannot push.
+ */
+export declare function readOnlyRepoAccessMessage(): string;
+/**
+ * Builds a non-error status message when credentials reach an empty remote repository.
+ */
+export declare function emptyRemoteCredentialsMessage(): string;
+/**
+ * Builds a success message for the Test connection button when the remote is empty.
+ */
+export declare function emptyRemoteConnectionTestMessage(): string;
+/**
+ * Builds a success message for the Test connection button when the remote has the branch.
+ */
+export declare function successfulConnectionTestMessage(): string;
+//# sourceMappingURL=gitHttpErrors.d.ts.map

package/dist/gitHttpErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitHttpErrors.d.ts","sourceRoot":"","sources":["../src/gitHttpErrors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAID;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAoB5D;AA0BD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,gBAAgB,EAC3B,OAAO,GAAE,mBAAwB,GAChC,MAAM,CAiBR;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,gBAAgB,GAAG,IAAI,EAClC,OAAO,GAAE,mBAAwB,GAChC,MAAM,CAkCR;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,gBAAgB,GAAG,IAAI,EAClC,OAAO,GAAE,mBAAwB,EACjC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GACrB,MAAM,CAwBR;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,gBAAgB,GAAG,IAAI,EAClC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,GAChC,MAAM,CAOR;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGlF;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,gBAAgB,GAAG,IAAI,EAClC,OAAO,GAAE,mBAAwB,GAChC,MAAM,CAsBR;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,gBAAgB,GAAG,IAAI,EAClC,OAAO,GAAE,mBAAwB,GAChC,MAAM,CAiBR;AAED;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAwBjF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAMlD;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,MAAM,CAKtD;AAED;;GAEG;AACH,wBAAgB,gCAAgC,IAAI,MAAM,CAKzD;AAED;;GAEG;AACH,wBAAgB,+BAA+B,IAAI,MAAM,CAExD"}

package/dist/gitHttpErrors.js

@@ -0,0 +1,271 @@
+const IPC_ERROR_PREFIX = /^Error invoking remote method '[^']+':\s*(?:Error:\s*)?/i;
+/**
+ * Strips Electron IPC invoke wrapper text from an error message.
+ *
+ * @param message - Raw error message from a renderer IPC call.
+ * @returns User-facing message without the internal invoke prefix.
+ */
+export function stripIpcInvokeErrorPrefix(message) {
+    return message.replace(IPC_ERROR_PREFIX, '').trim();
+}
+/**
+ * Returns whether an error indicates GitHub (or another host) reported the
+ * repository as missing.
+ *
+ * GitHub often returns 404 for private repos when credentials cannot access
+ * them, even when the repository exists for a different account.
+ *
+ * @param err - Thrown value from isomorphic-git or a string message.
+ */
+export function isGitRepoNotFoundError(err) {
+    if (err == null) {
+        return false;
+    }
+    if (typeof err === 'object') {
+        const record = err;
+        if (record.data?.statusCode === 404) {
+            return true;
+        }
+        if (typeof record.message === 'string' && matchesRepoNotFoundMessage(record.message)) {
+            return true;
+        }
+    }
+    if (typeof err === 'string') {
+        return matchesRepoNotFoundMessage(err);
+    }
+    return false;
+}
+/**
+ * Returns whether a message string looks like a 404 / repository-not-found response.
+ *
+ * @param message - Error message text.
+ */
+function matchesRepoNotFoundMessage(message) {
+    return (/\b404\b/i.test(message) || /repository not found/i.test(message) || /not found/i.test(message));
+}
+/**
+ * Extracts an optional owner login stuck on a thrown error object.
+ *
+ * @param err - Error that may carry an `owner` field from the REST probe.
+ */
+function ownerFromError(err) {
+    if (err != null && typeof err === 'object' && 'owner' in err) {
+        const owner = err.owner;
+        return typeof owner === 'string' && owner.trim() ? owner.trim() : undefined;
+    }
+    return undefined;
+}
+/**
+ * Formats a git remote HTTP error into an actionable user-facing message.
+ *
+ * For 404 / "not found" responses, explains that GitHub may be hiding access
+ * denied behind a missing-repo status and includes the signed-in account and
+ * org SSO link when context is available. Other errors keep their original message.
+ *
+ * @param err - Thrown value from isomorphic-git or related validation.
+ * @param operation - Remote operation that failed (shown in the message).
+ * @param context - Optional signed-in login and repository owner for diagnostics.
+ * @returns User-facing error string suitable for toasts and form alerts.
+ */
+export function formatGitHttpError(err, operation, context = {}) {
+    if (isGitRepoNotFoundError(err)) {
+        return githubRepoNotFoundMessage(operation, {
+            githubLogin: context.githubLogin,
+            owner: context.owner ?? ownerFromError(err)
+        });
+    }
+    if (err instanceof Error) {
+        return stripIpcInvokeErrorPrefix(err.message);
+    }
+    if (typeof err === 'string') {
+        return stripIpcInvokeErrorPrefix(err);
+    }
+    return String(err);
+}
+/**
+ * Builds a diagnostic "repository not found" message with account and SSO hints.
+ *
+ * @param operation - Remote operation label, or null to omit the operation clause.
+ * @param context - Signed-in login and repository owner when known.
+ */
+export function githubRepoNotFoundMessage(operation, context = {}) {
+    const operationClause = operation != null ? ` during ${operation}` : '';
+    const login = context.githubLogin?.trim();
+    const owner = context.owner?.trim();
+    const parts = [`GitHub returned "repository not found"${operationClause}.`];
+    if (login) {
+        parts.push(`HarborClient is signed in as ${login}.`);
+    }
+    else {
+        parts.push('The URL may be wrong, or your saved HarborClient credentials (Settings → Git) ' +
+            'may not have access to this repo.');
+    }
+    parts.push('The repo may not exist, or this account may lack access — wrong GitHub account, ' +
+        'missing org SSO approval, or insufficient token scope.');
+    if (owner) {
+        parts.push(`If ${owner} is an organization that requires SSO, approve access at ` +
+            `https://github.com/orgs/${owner}/sso then re-authorize in HarborClient.`);
+    }
+    else {
+        parts.push('Re-authorize for github.com and confirm you can open the repo in the browser ' +
+            'while logged in as the account HarborClient is using.');
+    }
+    return parts.join(' ');
+}
+/**
+ * Builds a diagnostic message when GitHub requires SAML SSO authorization (403).
+ *
+ * @param operation - Remote operation label, or null to omit the operation clause.
+ * @param context - Signed-in login and repository owner when known.
+ * @param ssoUrl - SSO authorization URL from the `x-github-sso` header, when present.
+ */
+export function githubSsoRequiredMessage(operation, context = {}, ssoUrl) {
+    const operationClause = operation != null ? ` during ${operation}` : '';
+    const login = context.githubLogin?.trim();
+    const owner = context.owner?.trim();
+    const url = ssoUrl?.trim() || (owner ? `https://github.com/orgs/${owner}/sso` : null);
+    const parts = [
+        `GitHub denied access${operationClause} because SAML SSO authorization is required.`
+    ];
+    if (login) {
+        parts.push(`HarborClient is signed in as ${login}.`);
+    }
+    if (url) {
+        parts.push(`Authorize this credential for the organization at ${url}, then try again.`);
+    }
+    else {
+        parts.push('Authorize this credential for the organization in GitHub (Settings → Applications ' +
+            'or the org SSO page), then try again.');
+    }
+    return parts.join(' ');
+}
+/**
+ * Builds a diagnostic message when GitHub rate-limits the request (403/429).
+ *
+ * @param operation - Remote operation label, or null to omit the operation clause.
+ * @param retryAfterSeconds - Seconds to wait from a `retry-after` header, when present.
+ */
+export function githubRateLimitMessage(operation, retryAfterSeconds) {
+    const operationClause = operation != null ? ` during ${operation}` : '';
+    const wait = retryAfterSeconds != null && retryAfterSeconds > 0
+        ? ` Wait about ${retryAfterSeconds} seconds and try again.`
+        : ' Wait a few minutes and try again.';
+    return `GitHub rate limit reached${operationClause}.${wait}`;
+}
+/**
+ * Returns whether a GitHub API error message indicates org OAuth App access restrictions.
+ *
+ * @param message - Raw `message` field from a GitHub REST error body.
+ */
+export function isGitHubOAuthAppRestrictionMessage(message) {
+    return /OAuth App access restrictions/i.test(message);
+}
+/**
+ * Extracts an organization login from GitHub's OAuth-restriction error text when present.
+ *
+ * GitHub's message typically includes backtick-quoted org names, e.g.
+ * `the \`harborclient\` organization has enabled OAuth App access restrictions`.
+ *
+ * @param message - Raw GitHub REST error `message` field.
+ * @returns Organization login when found, otherwise null.
+ */
+export function ownerFromOAuthAppRestrictionMessage(message) {
+    const match = message.match(/`([A-Za-z0-9-]+)`\s+organization/i);
+    return match?.[1]?.trim() || null;
+}
+/**
+ * Builds a diagnostic message when an org blocks the OAuth App (403).
+ *
+ * @param operation - Remote operation label, or null to omit the operation clause.
+ * @param context - Signed-in login and repository owner when known.
+ */
+export function githubOAuthAppRestrictionMessage(operation, context = {}) {
+    const operationClause = operation != null ? ` during ${operation}` : '';
+    const login = context.githubLogin?.trim();
+    const owner = context.owner?.trim();
+    const parts = [
+        `GitHub denied access${operationClause} because the ${owner ? `${owner} organization` : 'organization'} restricts third-party OAuth apps.`
+    ];
+    if (login) {
+        parts.push(`HarborClient is signed in as ${login}.`);
+    }
+    parts.push('Re-authorize in HarborClient, click Finish authentication, and grant access to that ' +
+        "organization on GitHub's approval screen. If you already granted it, ask an org admin " +
+        'to approve HarborClient under Organization → Settings → Third-party access.');
+    return parts.join(' ');
+}
+/**
+ * Builds a diagnostic message for a generic GitHub 403 (insufficient permissions/scope).
+ *
+ * @param operation - Remote operation label, or null to omit the operation clause.
+ * @param context - Signed-in login and repository owner when known.
+ */
+export function githubForbiddenMessage(operation, context = {}) {
+    const operationClause = operation != null ? ` during ${operation}` : '';
+    const login = context.githubLogin?.trim();
+    const parts = [`GitHub denied access${operationClause} (403 Forbidden).`];
+    if (login) {
+        parts.push(`HarborClient is signed in as ${login}.`);
+    }
+    parts.push('The account may lack access to this repository, or the token scope is insufficient — ' +
+        'wrong GitHub account, missing org approval during OAuth, missing org SSO approval, ' +
+        'or a token without repo access. Re-authorize for github.com with sufficient scope and try again.');
+    return parts.join(' ');
+}
+/**
+ * Builds a user-facing message when credentials were saved but repo validation failed.
+ *
+ * Prefer the main-process diagnostic message when it already includes account or SSO
+ * guidance; otherwise fall back to a generic 404 explanation.
+ *
+ * @param validationError - Raw or already-formatted validation error from the main process.
+ */
+export function credentialsSavedValidationMessage(validationError) {
+    if (validationError.includes('HarborClient is signed in') ||
+        validationError.includes('github.com/orgs/') ||
+        validationError.includes('did not grant push access') ||
+        validationError.includes('SAML SSO authorization is required') ||
+        validationError.includes('rate limit reached') ||
+        validationError.includes('restricts third-party OAuth apps')) {
+        return validationError.startsWith('Credentials saved')
+            ? validationError
+            : `Credentials saved, but ${validationError.charAt(0).toLowerCase()}${validationError.slice(1)}`;
+    }
+    if (isGitRepoNotFoundError(validationError)) {
+        return ('Credentials saved, but GitHub returned "repository not found". ' +
+            'The URL may be wrong, or these credentials may not have access to this repo — ' +
+            'wrong GitHub account, missing org SSO approval, or insufficient token scope. ' +
+            'Confirm the URL and that you can open the repo in the browser while logged in as ' +
+            'the account HarborClient is using.');
+    }
+    return `Credentials saved, but the repository could not be verified. ${validationError}`;
+}
+/**
+ * Builds a warning when credentials can read a repository but cannot push.
+ */
+export function readOnlyRepoAccessMessage() {
+    return ('Credentials can read this repository, but GitHub did not grant push access. ' +
+        'Push and initial commits will fail until you re-authorize with sufficient scope ' +
+        'or get write access to the repo.');
+}
+/**
+ * Builds a non-error status message when credentials reach an empty remote repository.
+ */
+export function emptyRemoteCredentialsMessage() {
+    return ('Credentials verified. The remote repository is empty — initialize locally and push ' +
+        'your first commit to create the branch.');
+}
+/**
+ * Builds a success message for the Test connection button when the remote is empty.
+ */
+export function emptyRemoteConnectionTestMessage() {
+    return ('Connection successful. Remote repository is empty; initialize locally and push your ' +
+        'first commit.');
+}
+/**
+ * Builds a success message for the Test connection button when the remote has the branch.
+ */
+export function successfulConnectionTestMessage() {
+    return 'Connection successful. Credentials can reach this repository.';
+}
+//# sourceMappingURL=gitHttpErrors.js.map