@harborclient/core 0.1.1

package/dist/types/api/plugins.d.ts

@@ -0,0 +1,338 @@
+import type { PluginCatalog, PluginSourcesSettings, ThemeCatalog } from '../../plugin/catalog';
+import type { PluginHttpRequest, PluginHttpResponse } from '@harborclient/sdk';
+import type { PluginAssetResult, PluginEntryKind, PluginFsPickFileOptions, PluginFsSaveFileOptions, PluginGitPreview, PluginInfo, ResolvedThemeImport, SerializableMenuContribution } from '../../plugin/types';
+import type { TeamHubPluginSourcesView } from '../teamHub';
+/** Payload pushed when a plugin surface webview reports its content height. */
+export interface PluginSurfaceResizeMessage {
+    pluginId: string;
+    contributionId: string;
+    kind: string;
+    slot?: 'content' | 'headerActions';
+    height?: number;
+    width?: number;
+}
+/**
+ * IPC methods for plugins.
+ */
+export interface ApiPlugins {
+    /**
+     * Lists installed and unpacked plugins.
+     */
+    listPlugins: () => Promise<PluginInfo[]>;
+    /**
+     * Fetches the curated plugin marketplace catalog from configured sources.
+     */
+    getPluginCatalog: () => Promise<PluginCatalog>;
+    /**
+     * Fetches the curated theme marketplace catalog from harborclient.com.
+     */
+    getThemeCatalog: () => Promise<ThemeCatalog>;
+    /**
+     * Returns persisted plugin catalog and trusted-key source settings.
+     */
+    getPluginSources: () => Promise<PluginSourcesSettings>;
+    /**
+     * Persists plugin catalog and trusted-key source settings.
+     *
+     * @param settings - Catalog and trusted registry endpoints to store.
+     */
+    setPluginSources: (settings: PluginSourcesSettings) => Promise<PluginSourcesSettings>;
+    /**
+     * Refreshes and returns read-only plugin source URLs from connected Team Hubs.
+     */
+    getTeamHubPluginSources: () => Promise<TeamHubPluginSourcesView>;
+    /**
+     * Installs a plugin from a native file picker (.hcp / .zip).
+     */
+    installPlugin: () => Promise<PluginInfo | null>;
+    /**
+     * Installs a plugin from an absolute archive path.
+     *
+     * @param path - Absolute path to a `.hcp` or `.zip` plugin package.
+     */
+    installPluginFromPath: (path: string) => Promise<PluginInfo>;
+    /**
+     * Installs a plugin by cloning a public git repository.
+     *
+     * @param url - Public https (or http) repository URL.
+     * @param ref - Optional branch or tag to clone.
+     */
+    installPluginFromGit: (url: string, ref?: string) => Promise<PluginInfo>;
+    /**
+     * Fetches manifest and preview assets from a public git repository without installing.
+     *
+     * @param url - Public https (or http) repository URL.
+     * @param ref - Optional branch or tag to read.
+     */
+    previewPluginFromGit: (url: string, ref?: string) => Promise<PluginGitPreview>;
+    /**
+     * Re-clones a git-installed plugin from its stored origin.
+     *
+     * @param pluginId - Plugin manifest id.
+     */
+    updatePluginFromGit: (pluginId: string) => Promise<PluginInfo>;
+    /**
+     * Uninstalls an installed plugin by id.
+     *
+     * @param pluginId - Plugin manifest id.
+     */
+    uninstallPlugin: (pluginId: string) => Promise<void>;
+    /**
+     * Enables or disables a plugin.
+     *
+     * @param pluginId - Plugin manifest id.
+     * @param enabled - Whether the plugin should activate.
+     */
+    setPluginEnabled: (pluginId: string, enabled: boolean) => Promise<PluginInfo>;
+    /**
+     * Loads an unpacked plugin from a native directory picker.
+     */
+    loadUnpackedPlugin: () => Promise<PluginInfo | null>;
+    /**
+     * Loads an unpacked plugin from an absolute directory path.
+     *
+     * @param path - Absolute path to the plugin project folder.
+     */
+    loadUnpackedPluginFromPath: (path: string) => Promise<PluginInfo>;
+    /**
+     * Reloads one plugin from disk.
+     *
+     * @param pluginId - Plugin manifest id.
+     */
+    reloadPlugin: (pluginId: string) => Promise<PluginInfo>;
+    /**
+     * Removes an unpacked dev plugin registration.
+     *
+     * @param pluginId - Plugin manifest id.
+     */
+    removeUnpackedPlugin: (pluginId: string) => Promise<void>;
+    /**
+     * Reads a plugin entry bundle as UTF-8 source text.
+     *
+     * @param pluginId - Plugin manifest id.
+     * @param kind - Renderer or main entry.
+     */
+    readPluginEntry: (pluginId: string, kind: PluginEntryKind) => Promise<string>;
+    /**
+     * Reads a plugin asset relative to the plugin root.
+     *
+     * @param pluginId - Plugin manifest id.
+     * @param assetPath - Plugin-relative asset path.
+     */
+    readPluginAsset: (pluginId: string, assetPath: string) => Promise<PluginAssetResult>;
+    /**
+     * Loads a theme JSON export referenced by `contributes.themes[].import`.
+     *
+     * On first read, inlines a referenced stylesheet file into the JSON on disk.
+     *
+     * @param pluginId - Plugin manifest id.
+     * @param importPath - Plugin-relative path to the theme export JSON.
+     */
+    resolveThemeImport: (pluginId: string, importPath: string) => Promise<ResolvedThemeImport>;
+    /**
+     * Returns a plugin-scoped persisted value.
+     *
+     * @param pluginId - Plugin manifest id.
+     * @param key - Storage key within the plugin namespace.
+     */
+    getPluginStorage: (pluginId: string, key: string) => Promise<unknown>;
+    /**
+     * Persists a plugin-scoped JSON-serializable value.
+     *
+     * @param pluginId - Plugin manifest id.
+     * @param key - Storage key within the plugin namespace.
+     * @param value - Value to store.
+     */
+    setPluginStorage: (pluginId: string, key: string, value: unknown) => Promise<void>;
+    /**
+     * Runs one plugin database query outside or inside a transaction.
+     *
+     * @param pluginId - Plugin manifest id.
+     * @param mode - Query shape to execute.
+     * @param sql - Parameterized SQL statement.
+     * @param params - Bound parameter values.
+     * @param txnId - Active transaction id when applicable.
+     */
+    pluginDatabaseQuery: (pluginId: string, mode: 'get' | 'all' | 'run', sql: string, params?: unknown[], txnId?: string) => Promise<unknown>;
+    /**
+     * Executes a plugin database migration script.
+     *
+     * @param pluginId - Plugin manifest id.
+     * @param sql - Multi-statement SQL script.
+     */
+    pluginDatabaseExec: (pluginId: string, sql: string) => Promise<void>;
+    /**
+     * Starts a plugin database transaction and returns an opaque transaction id.
+     *
+     * @param pluginId - Plugin manifest id.
+     */
+    pluginDatabaseTxBegin: (pluginId: string) => Promise<string>;
+    /**
+     * Commits or rolls back a plugin database transaction.
+     *
+     * @param pluginId - Plugin manifest id.
+     * @param txnId - Transaction id from {@link HostApi.pluginDatabaseTxBegin}.
+     * @param action - Whether to commit or roll back.
+     */
+    pluginDatabaseTxEnd: (pluginId: string, txnId: string, action: 'commit' | 'rollback') => Promise<void>;
+    /**
+     * Activates a plugin main entry in the SES utilityProcess runner.
+     *
+     * Main entry source and permissions are resolved in the main process from disk.
+     *
+     * @param pluginId - Plugin manifest id.
+     */
+    activatePluginMain: (pluginId: string) => Promise<void>;
+    /**
+     * Deactivates a plugin main entry in the SES utilityProcess runner.
+     *
+     * @param pluginId - Plugin manifest id.
+     */
+    deactivatePluginMain: (pluginId: string) => Promise<void>;
+    /**
+     * Records or clears a plugin activation/runtime error shown in Settings.
+     *
+     * @param pluginId - Plugin manifest id.
+     * @param message - Error message, or null to clear.
+     * @param logDetails - Optional activation failure details for the main process terminal.
+     */
+    reportPluginRuntimeError: (pluginId: string, message: string | null, logDetails?: string) => Promise<PluginInfo>;
+    /**
+     * Invokes a plugin IPC handler registered in the main runtime.
+     *
+     * @param pluginId - Plugin manifest id.
+     * @param channel - Registered channel name.
+     * @param args - Arguments from the renderer half.
+     */
+    invokePluginMain: (pluginId: string, channel: string, args: unknown[]) => Promise<unknown>;
+    /**
+     * Subscribes to plugin change notifications from the main process.
+     *
+     * @param callback - Called with the changed plugin id.
+     */
+    onPluginsChanged: (callback: (pluginId: string) => void) => () => void;
+    /**
+     * Pushes plugin menu contributions to the main process for menu merge.
+     */
+    setPluginMenuContributions: (contributions: SerializableMenuContribution[]) => Promise<void>;
+    /**
+     * Subscribes to plugin menu command clicks from the application menu.
+     */
+    onPluginMenuCommand: (callback: (payload: {
+        pluginId: string;
+        command: string;
+    }) => void) => () => void;
+    /**
+     * Opens a native file picker for a plugin with filesystem:pick permission.
+     */
+    pluginFsPickFile: (pluginId: string, options?: PluginFsPickFileOptions) => Promise<string[]>;
+    /**
+     * Opens a native directory picker for a plugin with filesystem:pick permission.
+     */
+    pluginFsPickDirectory: (pluginId: string, defaultPath?: string) => Promise<string | null>;
+    /**
+     * Saves text to a user-selected path for a plugin with filesystem:pick permission.
+     */
+    pluginFsSaveFile: (pluginId: string, content: string, options?: PluginFsSaveFileOptions) => Promise<string | null>;
+    /**
+     * Reads a UTF-8 file from an allowlisted path for a plugin.
+     */
+    pluginFsReadFile: (pluginId: string, path: string) => Promise<string>;
+    /**
+     * Writes a UTF-8 file to an allowlisted path for a plugin.
+     */
+    pluginFsWriteFile: (pluginId: string, path: string, content: string) => Promise<void>;
+    /**
+     * Watches an allowlisted file for changes and invokes the callback when it changes.
+     */
+    pluginFsWatchFile: (pluginId: string, path: string, callback: () => void) => () => void;
+    /**
+     * Pushes serialized view context to an isolated plugin surface webview.
+     */
+    pushPluginViewContext: (payload: {
+        pluginId: string;
+        contributionId: string;
+        kind: string;
+        context: unknown;
+    }) => Promise<void>;
+    /**
+     * Pushes a completed HTTP exchange to plugin webviews with the `http` permission.
+     */
+    pushPluginHttpAfterSend: (payload: {
+        request: PluginHttpRequest;
+        response: PluginHttpResponse;
+    }) => Promise<void>;
+    /**
+     * Executes a plugin command in the plugin agent webview.
+     */
+    executePluginAgentCommand: (pluginId: string, commandId: string, args?: unknown[]) => Promise<void>;
+    /**
+     * Invokes one import handler phase in a plugin agent webview.
+     */
+    invokePluginImportHandler: (pluginId: string, registrationId: string, phase: 'canImport' | 'import', file: {
+        name: string;
+        path: string;
+        extension: string;
+        contents: string;
+    }) => Promise<unknown>;
+    /**
+     * Subscribes to contribution registry updates from plugin agent webviews.
+     */
+    onPluginsContributions: (callback: (message: {
+        pluginId: string;
+        op: string;
+        kind?: string;
+        contribution?: Record<string, unknown>;
+        contributionId?: string;
+    }) => void) => () => void;
+    /**
+     * Subscribes to import handler metadata synced from plugin agent webviews.
+     */
+    onPluginsImportHandlers: (callback: (message: {
+        pluginId: string;
+        op: 'register' | 'unregister';
+        registrationId: string;
+        extensions?: string[];
+    }) => void) => () => void;
+    /**
+     * Subscribes to host bridge requests from isolated plugin webviews.
+     */
+    onPluginsHostBridge: (callback: (message: {
+        pluginId: string;
+        op: string;
+        payload?: unknown;
+    }) => void) => () => void;
+    /**
+     * Subscribes to correlated host bridge invokes that must return a result.
+     */
+    onPluginsHostBridgeInvoke: (callback: (message: {
+        requestId: number;
+        pluginId: string;
+        op: string;
+        payload?: unknown;
+    }) => void) => () => void;
+    /**
+     * Completes a correlated host bridge invoke started by the main-process broker.
+     */
+    completePluginHostBridge: (message: {
+        requestId: number;
+        ok: boolean;
+        result?: unknown;
+        error?: string;
+    }) => void;
+    /**
+     * Subscribes to content height updates from isolated plugin surface webviews.
+     */
+    onPluginSurfaceResize: (callback: (message: PluginSurfaceResizeMessage) => void) => () => void;
+    /**
+     * Subscribes to plugin agent webview readiness notifications.
+     */
+    onPluginsAgentReady: (callback: (payload: {
+        pluginId: string;
+    }) => void) => () => void;
+    onPluginsAgentFailed: (callback: (payload: {
+        pluginId: string;
+        message: string;
+    }) => void) => () => void;
+}
+//# sourceMappingURL=plugins.d.ts.map

package/dist/types/api/plugins.d.ts.map

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

package/dist/types/api/plugins.js

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

package/dist/types/api/plugins.js.map

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

package/dist/types/api/requestHistory.d.ts

@@ -0,0 +1,27 @@
+import type { RequestHistoryEntry } from '../requestHistory';
+/**
+ * IPC methods for native request history persistence.
+ */
+export interface ApiRequestHistory {
+    /**
+     * Lists persisted request history entries, newest first.
+     */
+    listRequestHistory: () => Promise<RequestHistoryEntry[]>;
+    /**
+     * Persists a completed request and prunes entries beyond the configured cap.
+     *
+     * @param entry - Captured request/response metadata to store.
+     */
+    addRequestHistory: (entry: RequestHistoryEntry) => Promise<RequestHistoryEntry[]>;
+    /**
+     * Removes all persisted request history entries.
+     */
+    clearRequestHistory: () => Promise<void>;
+    /**
+     * Removes one persisted request history entry by id.
+     *
+     * @param id - History entry id to delete.
+     */
+    deleteRequestHistory: (id: number) => Promise<RequestHistoryEntry[]>;
+}
+//# sourceMappingURL=requestHistory.d.ts.map

package/dist/types/api/requestHistory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestHistory.d.ts","sourceRoot":"","sources":["../../../src/types/api/requestHistory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,kBAAkB,EAAE,MAAM,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAEzD;;;;OAIG;IACH,iBAAiB,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAElF;;OAEG;IACH,mBAAmB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC;;;;OAIG;IACH,oBAAoB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;CACtE"}

package/dist/types/api/requestHistory.js

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

package/dist/types/api/requestHistory.js.map

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

package/dist/types/api/requests.d.ts

@@ -0,0 +1,35 @@
+import type { SaveRequestInput, SavedRequest } from '../request';
+/**
+ * IPC methods for requests.
+ */
+export interface ApiRequests {
+    /**
+     * Lists saved requests in a collection.
+     *
+     * @param collectionId - Collection to query.
+     * @returns Requests in the collection.
+     */
+    listRequests: (collectionId: number) => Promise<SavedRequest[]>;
+    /**
+     * Inserts a new saved request or updates an existing one.
+     *
+     * @param req - Request fields to persist.
+     * @returns The saved request.
+     */
+    saveRequest: (req: SaveRequestInput) => Promise<SavedRequest>;
+    /**
+     * Updates a saved request sidebar color.
+     *
+     * @param id - Request ID to update.
+     * @param color - CSS color string, or null to clear.
+     * @returns The updated request.
+     */
+    setRequestColor: (id: number, color: string | null) => Promise<SavedRequest>;
+    /**
+     * Deletes a saved request by ID.
+     *
+     * @param id - Request ID to delete.
+     */
+    deleteRequest: (id: number) => Promise<void>;
+}
+//# sourceMappingURL=requests.d.ts.map

package/dist/types/api/requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requests.d.ts","sourceRoot":"","sources":["../../../src/types/api/requests.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAChE;;;;;OAKG;IACH,WAAW,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9D;;;;;;OAMG;IACH,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7E;;;;OAIG;IACH,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C"}

package/dist/types/api/requests.js

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

package/dist/types/api/requests.js.map

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

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

@@ -0,0 +1,163 @@
+import type { AuthConfig, OAuthFetchTokenResult } from '../../auth';
+import type { CollectionRunnerConfig } from '../../collectionRunner';
+import type { ShortcutBinding, ShortcutOverrides } from '../../shortcuts';
+import type { AiChatSessionState, AiSettings, EditorTab, GeneralSettings, PanelLayoutState, SidebarExpansionState } from '../settings';
+/**
+ * IPC methods for settings.
+ */
+export interface ApiSettings {
+    /**
+     * Returns persisted general request settings.
+     */
+    getGeneralSettings: () => Promise<GeneralSettings>;
+    /**
+     * Persists general request settings.
+     *
+     * @param settings - General configuration to store.
+     */
+    setGeneralSettings: (settings: GeneralSettings) => Promise<void>;
+    /**
+     * Returns persisted AI provider API keys.
+     */
+    getAiSettings: () => Promise<AiSettings>;
+    /**
+     * Persists AI provider API keys.
+     *
+     * @param settings - AI configuration to store.
+     */
+    setAiSettings: (settings: AiSettings) => Promise<void>;
+    /**
+     * Returns the id of the active database connection.
+     */
+    getActiveStorageId: () => Promise<string>;
+    /**
+     * Sets the active database connection (applied on restart).
+     *
+     * @param id - Connection id to activate.
+     */
+    setActiveStorageId: (id: string) => Promise<void>;
+    /**
+     * Returns the persisted request editor tab for a storage key.
+     *
+     * @param key - Saved request id or `tab:${tabId}` for unsaved drafts.
+     */
+    getRequestEditorTab: (key: string) => Promise<EditorTab | null>;
+    /**
+     * Persists the request editor tab for a storage key.
+     *
+     * @param key - Saved request id or `tab:${tabId}` for unsaved drafts.
+     * @param tab - Editor tab to remember.
+     */
+    setRequestEditorTab: (key: string, tab: EditorTab) => Promise<void>;
+    /**
+     * Removes persisted request editor tab state for a storage key.
+     *
+     * @param key - Saved request id string to clear.
+     */
+    deleteRequestEditorTab: (key: string) => Promise<void>;
+    /**
+     * Returns the persisted sidebar section for a page tab key.
+     *
+     * @param key - Page sidebar storage key such as `settings` or `plugins`.
+     */
+    getPageSidebarSection: (key: string) => Promise<string | null>;
+    /**
+     * Persists the sidebar section for a page tab key.
+     *
+     * @param key - Page sidebar storage key such as `settings` or `plugins`.
+     * @param section - Section id to remember.
+     */
+    setPageSidebarSection: (key: string, section: string) => Promise<void>;
+    /**
+     * Returns persisted sidebar expansion for sections, collections, and folders.
+     */
+    getSidebarExpansion: () => Promise<SidebarExpansionState>;
+    /**
+     * Persists sidebar expansion for sections, collections, and folders.
+     *
+     * @param state - Expansion snapshot to store.
+     */
+    setSidebarExpansion: (state: SidebarExpansionState) => Promise<void>;
+    /**
+     * Returns persisted sidebar and AI sidebar visibility preferences.
+     */
+    getPanelLayout: () => Promise<PanelLayoutState>;
+    /**
+     * Persists sidebar and AI sidebar visibility preferences.
+     *
+     * @param state - Panel layout snapshot to store.
+     */
+    setPanelLayout: (state: PanelLayoutState) => Promise<void>;
+    /**
+     * Returns persisted AI chat open tabs and active tab.
+     */
+    getAiChatSession: () => Promise<AiChatSessionState>;
+    /**
+     * Persists AI chat open tabs and active tab.
+     *
+     * @param state - Chat session snapshot to store.
+     */
+    setAiChatSession: (state: AiChatSessionState) => Promise<void>;
+    /**
+     * Returns persisted open request tabs as a JSON payload.
+     */
+    getOpenTabsPayload: () => Promise<string | null>;
+    /**
+     * Persists open request tabs as a JSON payload.
+     *
+     * @param payload - Serialized open-tabs JSON from the renderer.
+     */
+    setOpenTabsPayload: (payload: string) => Promise<void>;
+    /**
+     * Returns persisted collection runner configuration.
+     */
+    getCollectionRunnerConfig: () => Promise<CollectionRunnerConfig>;
+    /**
+     * Persists collection runner configuration.
+     *
+     * @param config - Runner settings snapshot to store.
+     */
+    setCollectionRunnerConfig: (config: CollectionRunnerConfig) => Promise<void>;
+    /**
+     * Returns resolved keyboard shortcut bindings with user overrides applied.
+     */
+    getShortcuts: () => Promise<ShortcutBinding[]>;
+    /**
+     * Persists keyboard shortcut overrides and rebuilds the application menu.
+     *
+     * @param overrides - Shortcut overrides keyed by shortcut id.
+     */
+    setShortcuts: (overrides: ShortcutOverrides) => Promise<ShortcutBinding[]>;
+    /**
+     * Clears keyboard shortcut overrides and restores default bindings.
+     */
+    resetShortcuts: () => Promise<ShortcutBinding[]>;
+    /**
+     * Fetches or returns a cached OAuth 2.0 access token using Client Credentials.
+     *
+     * @param cacheKey - Stable cache key; empty string skips persistence.
+     * @param config - Resolved OAuth 2.0 configuration.
+     * @param force - When true, bypass cache and fetch a fresh token.
+     */
+    oauthFetchToken: (cacheKey: string, config: AuthConfig['oauth2'], force: boolean) => Promise<OAuthFetchTokenResult>;
+    /**
+     * Clears a cached OAuth 2.0 access token for the given cache key.
+     *
+     * @param cacheKey - Stable cache key such as request:1 or collection:2.
+     */
+    oauthClearToken: (cacheKey: string) => Promise<void>;
+    /**
+     * Returns persisted autocomplete values for a category.
+     *
+     * @param category - Autocomplete pool id (e.g. `header.key`, `url`).
+     */
+    getAutocompleteValues: (category: string) => Promise<string[]>;
+    /**
+     * Persists a new autocomplete value for a category.
+     *
+     * @param category - Autocomplete pool id.
+     * @param value - User-committed value to remember.
+     */
+    addAutocompleteValue: (category: string, value: string) => Promise<void>;
+}
+//# sourceMappingURL=settings.d.ts.map

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

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

package/dist/types/api/settings.js

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

package/dist/types/api/settings.js.map

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