@openfin/fdc3-api 45.100.23 → 45.100.29

package/out/fdc3-api-alpha.d.ts

@@ -3113,6 +3113,48 @@ declare type ClearCacheOption = {
     localStorage?: boolean;
 };
 
+/**
+ * @interface
+ * Options for clearing various types of browsing data. Based on Electron's session.clearData() API.
+ */
+declare type ClearDataOptions = {
+    /**
+     * The types of data to clear. By default, this will clear all types of data.
+     * This can potentially include data types not explicitly listed here.
+     *
+     * - `backgroundFetch` - Background Fetch
+     * - `cache` - Cache (includes cachestorage and shadercache)
+     * - `cookies` - Cookies
+     * - `downloads` - Downloads
+     * - `fileSystems` - File Systems
+     * - `indexedDB` - IndexedDB
+     * - `localStorage` - Local Storage
+     * - `serviceWorkers` - Service Workers
+     * - `webSQL` - WebSQL
+     */
+    dataTypes?: Array<'backgroundFetch' | 'cache' | 'cookies' | 'downloads' | 'fileSystems' | 'indexedDB' | 'localStorage' | 'serviceWorkers' | 'webSQL'>;
+    /**
+     * Clear data for only these origins. Cannot be used with excludeOrigins.
+     * Example: ['http://localhost:8081', 'https://example.com']
+     */
+    origins?: string[];
+    /**
+     * Clear data for all origins except these ones. Cannot be used with origins.
+     * Example: ['http://workspace.here.io']
+     */
+    excludeOrigins?: string[];
+    /**
+     * Skips deleting session/authentication cookies currently maintaining active connections. (Default: false)
+     */
+    avoidClosingConnections?: boolean;
+    /**
+     * The behavior for matching data to origins.
+     * - `third-parties-included` (default) - Storage is matched on origin in first-party contexts and top-level-site in third-party contexts.
+     * - `origin-in-all-contexts` - Storage is matched on origin only in all contexts.
+     */
+    originMatchingMode?: 'third-parties-included' | 'origin-in-all-contexts';
+};
+
 /**
  * @typeParam Data User-defined shape for data returned upon menu item click.  Should be a
  * [union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types)
@@ -10588,6 +10630,7 @@ declare namespace OpenFin {
         NonAppProcessDetails,
         SystemProcessInfo,
         ClearCacheOption,
+        ClearDataOptions,
         CookieInfo,
         CookieOption,
         CrashReporterOptions,
@@ -13516,6 +13559,8 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
     'get-theme-preferences': GetterCall<OpenFin.NativeTheme>;
     'get-version': GetterCall<string>;
     'clear-cache': ApiCall<OpenFin.ClearCacheOption, void>;
+    'clear-http-cache': VoidCall;
+    'clear-cache-data': ApiCall<OpenFin.ClearDataOptions, void>;
     'delete-cache-request': VoidCall;
     'exit-desktop': VoidCall;
     'fetch-manifest': ApiCall<{
@@ -15138,6 +15183,44 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
      *
      */
     clearCache(options: OpenFin.ClearCacheOption): Promise<void>;
+    /**
+     * Clears only the HTTP cache (browser cache for HTML, CSS, JS, images).
+     * Service workers and other storage data are preserved.
+     *
+     * This is useful when you need to clear stale content without breaking offline functionality.
+     *
+     * @example
+     * ```js
+     * // Clear HTTP cache without affecting service workers
+     * await fin.System.clearHTTPCache();
+     * ```
+     */
+    clearHTTPCache(): Promise<void>;
+    /**
+     * Clears browsing data with granular control over what to clear and which origins to target.
+     *
+     * @param options - Optional configuration for what data to clear
+     *
+     * @example
+     * ```js
+     * // Clear only cookies and localStorage for a specific origin
+     * await fin.System.clearCacheData({
+     *     dataTypes: ['cookies', 'localStorage'],
+     *     origins: ['http://localhost:8081']
+     * });
+     *
+     * // Clear everything except for a specific origin
+     * await fin.System.clearCacheData({
+     *     excludeOrigins: ['http://example.com']
+     * });
+     *
+     * // Clear all service workers across all origins
+     * await fin.System.clearCacheData({
+     *     dataTypes: ['serviceWorkers']
+     * });
+     * ```
+     */
+    clearCacheData(options?: OpenFin.ClearDataOptions): Promise<void>;
     /**
      * Clears all cached data when OpenFin Runtime exits.
      *

package/out/fdc3-api-beta.d.ts

@@ -3113,6 +3113,48 @@ declare type ClearCacheOption = {
     localStorage?: boolean;
 };
 
+/**
+ * @interface
+ * Options for clearing various types of browsing data. Based on Electron's session.clearData() API.
+ */
+declare type ClearDataOptions = {
+    /**
+     * The types of data to clear. By default, this will clear all types of data.
+     * This can potentially include data types not explicitly listed here.
+     *
+     * - `backgroundFetch` - Background Fetch
+     * - `cache` - Cache (includes cachestorage and shadercache)
+     * - `cookies` - Cookies
+     * - `downloads` - Downloads
+     * - `fileSystems` - File Systems
+     * - `indexedDB` - IndexedDB
+     * - `localStorage` - Local Storage
+     * - `serviceWorkers` - Service Workers
+     * - `webSQL` - WebSQL
+     */
+    dataTypes?: Array<'backgroundFetch' | 'cache' | 'cookies' | 'downloads' | 'fileSystems' | 'indexedDB' | 'localStorage' | 'serviceWorkers' | 'webSQL'>;
+    /**
+     * Clear data for only these origins. Cannot be used with excludeOrigins.
+     * Example: ['http://localhost:8081', 'https://example.com']
+     */
+    origins?: string[];
+    /**
+     * Clear data for all origins except these ones. Cannot be used with origins.
+     * Example: ['http://workspace.here.io']
+     */
+    excludeOrigins?: string[];
+    /**
+     * Skips deleting session/authentication cookies currently maintaining active connections. (Default: false)
+     */
+    avoidClosingConnections?: boolean;
+    /**
+     * The behavior for matching data to origins.
+     * - `third-parties-included` (default) - Storage is matched on origin in first-party contexts and top-level-site in third-party contexts.
+     * - `origin-in-all-contexts` - Storage is matched on origin only in all contexts.
+     */
+    originMatchingMode?: 'third-parties-included' | 'origin-in-all-contexts';
+};
+
 /**
  * @typeParam Data User-defined shape for data returned upon menu item click.  Should be a
  * [union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types)
@@ -10588,6 +10630,7 @@ declare namespace OpenFin {
         NonAppProcessDetails,
         SystemProcessInfo,
         ClearCacheOption,
+        ClearDataOptions,
         CookieInfo,
         CookieOption,
         CrashReporterOptions,
@@ -13516,6 +13559,8 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
     'get-theme-preferences': GetterCall<OpenFin.NativeTheme>;
     'get-version': GetterCall<string>;
     'clear-cache': ApiCall<OpenFin.ClearCacheOption, void>;
+    'clear-http-cache': VoidCall;
+    'clear-cache-data': ApiCall<OpenFin.ClearDataOptions, void>;
     'delete-cache-request': VoidCall;
     'exit-desktop': VoidCall;
     'fetch-manifest': ApiCall<{
@@ -15138,6 +15183,44 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
      *
      */
     clearCache(options: OpenFin.ClearCacheOption): Promise<void>;
+    /**
+     * Clears only the HTTP cache (browser cache for HTML, CSS, JS, images).
+     * Service workers and other storage data are preserved.
+     *
+     * This is useful when you need to clear stale content without breaking offline functionality.
+     *
+     * @example
+     * ```js
+     * // Clear HTTP cache without affecting service workers
+     * await fin.System.clearHTTPCache();
+     * ```
+     */
+    clearHTTPCache(): Promise<void>;
+    /**
+     * Clears browsing data with granular control over what to clear and which origins to target.
+     *
+     * @param options - Optional configuration for what data to clear
+     *
+     * @example
+     * ```js
+     * // Clear only cookies and localStorage for a specific origin
+     * await fin.System.clearCacheData({
+     *     dataTypes: ['cookies', 'localStorage'],
+     *     origins: ['http://localhost:8081']
+     * });
+     *
+     * // Clear everything except for a specific origin
+     * await fin.System.clearCacheData({
+     *     excludeOrigins: ['http://example.com']
+     * });
+     *
+     * // Clear all service workers across all origins
+     * await fin.System.clearCacheData({
+     *     dataTypes: ['serviceWorkers']
+     * });
+     * ```
+     */
+    clearCacheData(options?: OpenFin.ClearDataOptions): Promise<void>;
     /**
      * Clears all cached data when OpenFin Runtime exits.
      *

package/out/fdc3-api-public.d.ts

@@ -3113,6 +3113,48 @@ declare type ClearCacheOption = {
     localStorage?: boolean;
 };
 
+/**
+ * @interface
+ * Options for clearing various types of browsing data. Based on Electron's session.clearData() API.
+ */
+declare type ClearDataOptions = {
+    /**
+     * The types of data to clear. By default, this will clear all types of data.
+     * This can potentially include data types not explicitly listed here.
+     *
+     * - `backgroundFetch` - Background Fetch
+     * - `cache` - Cache (includes cachestorage and shadercache)
+     * - `cookies` - Cookies
+     * - `downloads` - Downloads
+     * - `fileSystems` - File Systems
+     * - `indexedDB` - IndexedDB
+     * - `localStorage` - Local Storage
+     * - `serviceWorkers` - Service Workers
+     * - `webSQL` - WebSQL
+     */
+    dataTypes?: Array<'backgroundFetch' | 'cache' | 'cookies' | 'downloads' | 'fileSystems' | 'indexedDB' | 'localStorage' | 'serviceWorkers' | 'webSQL'>;
+    /**
+     * Clear data for only these origins. Cannot be used with excludeOrigins.
+     * Example: ['http://localhost:8081', 'https://example.com']
+     */
+    origins?: string[];
+    /**
+     * Clear data for all origins except these ones. Cannot be used with origins.
+     * Example: ['http://workspace.here.io']
+     */
+    excludeOrigins?: string[];
+    /**
+     * Skips deleting session/authentication cookies currently maintaining active connections. (Default: false)
+     */
+    avoidClosingConnections?: boolean;
+    /**
+     * The behavior for matching data to origins.
+     * - `third-parties-included` (default) - Storage is matched on origin in first-party contexts and top-level-site in third-party contexts.
+     * - `origin-in-all-contexts` - Storage is matched on origin only in all contexts.
+     */
+    originMatchingMode?: 'third-parties-included' | 'origin-in-all-contexts';
+};
+
 /**
  * @typeParam Data User-defined shape for data returned upon menu item click.  Should be a
  * [union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types)
@@ -10588,6 +10630,7 @@ declare namespace OpenFin {
         NonAppProcessDetails,
         SystemProcessInfo,
         ClearCacheOption,
+        ClearDataOptions,
         CookieInfo,
         CookieOption,
         CrashReporterOptions,
@@ -13516,6 +13559,8 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
     'get-theme-preferences': GetterCall<OpenFin.NativeTheme>;
     'get-version': GetterCall<string>;
     'clear-cache': ApiCall<OpenFin.ClearCacheOption, void>;
+    'clear-http-cache': VoidCall;
+    'clear-cache-data': ApiCall<OpenFin.ClearDataOptions, void>;
     'delete-cache-request': VoidCall;
     'exit-desktop': VoidCall;
     'fetch-manifest': ApiCall<{
@@ -15138,6 +15183,44 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
      *
      */
     clearCache(options: OpenFin.ClearCacheOption): Promise<void>;
+    /**
+     * Clears only the HTTP cache (browser cache for HTML, CSS, JS, images).
+     * Service workers and other storage data are preserved.
+     *
+     * This is useful when you need to clear stale content without breaking offline functionality.
+     *
+     * @example
+     * ```js
+     * // Clear HTTP cache without affecting service workers
+     * await fin.System.clearHTTPCache();
+     * ```
+     */
+    clearHTTPCache(): Promise<void>;
+    /**
+     * Clears browsing data with granular control over what to clear and which origins to target.
+     *
+     * @param options - Optional configuration for what data to clear
+     *
+     * @example
+     * ```js
+     * // Clear only cookies and localStorage for a specific origin
+     * await fin.System.clearCacheData({
+     *     dataTypes: ['cookies', 'localStorage'],
+     *     origins: ['http://localhost:8081']
+     * });
+     *
+     * // Clear everything except for a specific origin
+     * await fin.System.clearCacheData({
+     *     excludeOrigins: ['http://example.com']
+     * });
+     *
+     * // Clear all service workers across all origins
+     * await fin.System.clearCacheData({
+     *     dataTypes: ['serviceWorkers']
+     * });
+     * ```
+     */
+    clearCacheData(options?: OpenFin.ClearDataOptions): Promise<void>;
     /**
      * Clears all cached data when OpenFin Runtime exits.
      *

package/out/fdc3-api.d.ts

@@ -3169,6 +3169,48 @@ declare type ClearCacheOption = {
     localStorage?: boolean;
 };
 
+/**
+ * @interface
+ * Options for clearing various types of browsing data. Based on Electron's session.clearData() API.
+ */
+declare type ClearDataOptions = {
+    /**
+     * The types of data to clear. By default, this will clear all types of data.
+     * This can potentially include data types not explicitly listed here.
+     *
+     * - `backgroundFetch` - Background Fetch
+     * - `cache` - Cache (includes cachestorage and shadercache)
+     * - `cookies` - Cookies
+     * - `downloads` - Downloads
+     * - `fileSystems` - File Systems
+     * - `indexedDB` - IndexedDB
+     * - `localStorage` - Local Storage
+     * - `serviceWorkers` - Service Workers
+     * - `webSQL` - WebSQL
+     */
+    dataTypes?: Array<'backgroundFetch' | 'cache' | 'cookies' | 'downloads' | 'fileSystems' | 'indexedDB' | 'localStorage' | 'serviceWorkers' | 'webSQL'>;
+    /**
+     * Clear data for only these origins. Cannot be used with excludeOrigins.
+     * Example: ['http://localhost:8081', 'https://example.com']
+     */
+    origins?: string[];
+    /**
+     * Clear data for all origins except these ones. Cannot be used with origins.
+     * Example: ['http://workspace.here.io']
+     */
+    excludeOrigins?: string[];
+    /**
+     * Skips deleting session/authentication cookies currently maintaining active connections. (Default: false)
+     */
+    avoidClosingConnections?: boolean;
+    /**
+     * The behavior for matching data to origins.
+     * - `third-parties-included` (default) - Storage is matched on origin in first-party contexts and top-level-site in third-party contexts.
+     * - `origin-in-all-contexts` - Storage is matched on origin only in all contexts.
+     */
+    originMatchingMode?: 'third-parties-included' | 'origin-in-all-contexts';
+};
+
 /**
  * @typeParam Data User-defined shape for data returned upon menu item click.  Should be a
  * [union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types)
@@ -10922,6 +10964,7 @@ declare namespace OpenFin {
         NonAppProcessDetails,
         SystemProcessInfo,
         ClearCacheOption,
+        ClearDataOptions,
         CookieInfo,
         CookieOption,
         CrashReporterOptions,
@@ -13933,6 +13976,8 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
     'get-theme-preferences': GetterCall<OpenFin.NativeTheme>;
     'get-version': GetterCall<string>;
     'clear-cache': ApiCall<OpenFin.ClearCacheOption, void>;
+    'clear-http-cache': VoidCall;
+    'clear-cache-data': ApiCall<OpenFin.ClearDataOptions, void>;
     'delete-cache-request': VoidCall;
     'exit-desktop': VoidCall;
     'fetch-manifest': ApiCall<{
@@ -15561,6 +15606,44 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
      *
      */
     clearCache(options: OpenFin.ClearCacheOption): Promise<void>;
+    /**
+     * Clears only the HTTP cache (browser cache for HTML, CSS, JS, images).
+     * Service workers and other storage data are preserved.
+     *
+     * This is useful when you need to clear stale content without breaking offline functionality.
+     *
+     * @example
+     * ```js
+     * // Clear HTTP cache without affecting service workers
+     * await fin.System.clearHTTPCache();
+     * ```
+     */
+    clearHTTPCache(): Promise<void>;
+    /**
+     * Clears browsing data with granular control over what to clear and which origins to target.
+     *
+     * @param options - Optional configuration for what data to clear
+     *
+     * @example
+     * ```js
+     * // Clear only cookies and localStorage for a specific origin
+     * await fin.System.clearCacheData({
+     *     dataTypes: ['cookies', 'localStorage'],
+     *     origins: ['http://localhost:8081']
+     * });
+     *
+     * // Clear everything except for a specific origin
+     * await fin.System.clearCacheData({
+     *     excludeOrigins: ['http://example.com']
+     * });
+     *
+     * // Clear all service workers across all origins
+     * await fin.System.clearCacheData({
+     *     dataTypes: ['serviceWorkers']
+     * });
+     * ```
+     */
+    clearCacheData(options?: OpenFin.ClearDataOptions): Promise<void>;
     /**
      * Clears all cached data when OpenFin Runtime exits.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@openfin/fdc3-api",
-    "version": "45.100.23",
+    "version": "45.100.29",
     "description": "OpenFin fdc3 module utilities and types.",
     "license": "SEE LICENSE IN LICENSE.md",
     "private": false,