npm - @capgo/capacitor-android-usagestatsmanager - Versions diffs - 8.0.32 → 8.1.1 - Mend

@capgo/capacitor-android-usagestatsmanager 8.0.32 → 8.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/README.md +26 -11
package/android/src/main/java/ee/forgr/capacitor_android_usagestatsmanager/CapacitorUsageStatsManagerPlugin.java +52 -2
package/dist/docs.json +65 -4
package/dist/esm/definitions.d.ts +43 -3
package/dist/esm/definitions.js.map +1 -1
package/dist/esm/web.d.ts +3 -1
package/dist/esm/web.js +1 -1
package/dist/esm/web.js.map +1 -1
package/dist/plugin.cjs.js +1 -1
package/dist/plugin.cjs.js.map +1 -1
package/dist/plugin.js +1 -1
package/dist/plugin.js.map +1 -1
package/ios/Sources/CapacitorUsageStatsManagerPlugin/CapacitorUsageStatsManagerPlugin.swift +1 -1
package/package.json +3 -2

package/README.md CHANGED Viewed

@@ -76,7 +76,7 @@ npx cap sync
 * [`queryAndAggregateUsageStats(...)`](#queryandaggregateusagestats)
 * [`isUsageStatsPermissionGranted()`](#isusagestatspermissiongranted)
 * [`openUsageStatsSettings()`](#openusagestatssettings)
-* [`queryAllPackages()`](#queryallpackages)
+* [`queryAllPackages(...)`](#queryallpackages)
 * [`getPluginVersion()`](#getpluginversion)
 * [Interfaces](#interfaces)
 * [Type Aliases](#type-aliases)
@@ -137,15 +137,19 @@ This will always open the settings screen, even if the permission is already gra
 --------------------
-### queryAllPackages()
+### queryAllPackages(...)
 ```typescript
-queryAllPackages() => Promise<{ packages: PackageInfo[]; }>
+queryAllPackages(options?: QueryAllPackagesOptions | undefined) => Promise<{ packages: PackageInfo[]; }>
 ```
 Queries all installed packages on the device.
 Requires the QUERY_ALL_PACKAGES permission.
+| Param         | Type                                                                        | Description               |
+| ------------- | --------------------------------------------------------------------------- | ------------------------- |
+| **`options`** | <code><a href="#queryallpackagesoptions">QueryAllPackagesOptions</a></code> | - Optional query settings |
 **Returns:** <code>Promise&lt;{ packages: PackageInfo[]; }&gt;</code>
 **Since:** 1.2.0
@@ -211,14 +215,25 @@ Result of a usage stats permission check.
 Represents basic information about an installed package.
-| Prop                   | Type                | Description                                    |
-| ---------------------- | ------------------- | ---------------------------------------------- |
-| **`packageName`**      | <code>string</code> | Package name                                   |
-| **`appName`**          | <code>string</code> | App display name                               |
-| **`versionName`**      | <code>string</code> | Version name string                            |
-| **`versionCode`**      | <code>number</code> | Version code number                            |
-| **`firstInstallTime`** | <code>number</code> | First install time in milliseconds since epoch |
-| **`lastUpdateTime`**   | <code>number</code> | Last update time in milliseconds since epoch   |
+| Prop                   | Type                | Description                                                                                                                                                                                                                                                         | Since  |
+| ---------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
+| **`packageName`**      | <code>string</code> | Package name                                                                                                                                                                                                                                                        |        |
+| **`appName`**          | <code>string</code> | App display name                                                                                                                                                                                                                                                    |        |
+| **`versionName`**      | <code>string</code> | Version name string                                                                                                                                                                                                                                                 |        |
+| **`versionCode`**      | <code>number</code> | Version code number                                                                                                                                                                                                                                                 |        |
+| **`firstInstallTime`** | <code>number</code> | First install time in milliseconds since epoch                                                                                                                                                                                                                      |        |
+| **`lastUpdateTime`**   | <code>number</code> | Last update time in milliseconds since epoch                                                                                                                                                                                                                        |        |
+| **`category`**         | <code>number</code> | Application category from `ApplicationInfo.category`. Only available on Android 8.0 (API level 26) and above. Common values: - `0` — undefined - `1` — game - `2` — audio - `3` — video - `4` — image - `5` — social - `6` — news - `7` — maps - `8` — productivity | 8.0.33 |
+| **`icon`**             | <code>string</code> | App icon as a base64 data URL (`data:image/png;base64,...`). Only present when `queryAllPackages({ includeIcon: true })` is used.                                                                                                                                   | 8.0.33 |
+#### QueryAllPackagesOptions
+Options for querying installed packages.
+| Prop              | Type                 | Description                                                                                                                                  | Default            |
+| ----------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
+| **`includeIcon`** | <code>boolean</code> | When true, includes each app's launcher icon as a base64 data URL. Defaults to false because icons significantly increase the response size. | <code>false</code> |
 ### Type Aliases

package/android/src/main/java/ee/forgr/capacitor_android_usagestatsmanager/CapacitorUsageStatsManagerPlugin.java CHANGED Viewed

@@ -8,8 +8,13 @@ import android.content.Intent;
 import android.content.pm.ApplicationInfo;
 import android.content.pm.PackageInfo;
 import android.content.pm.PackageManager;
+import android.graphics.Bitmap;
+import android.graphics.Canvas;
+import android.graphics.drawable.BitmapDrawable;
+import android.graphics.drawable.Drawable;
 import android.os.Build;
 import android.provider.Settings;
+import android.util.Base64;
 import android.util.Log;
 import androidx.annotation.NonNull;
 import com.getcapacitor.JSObject;
@@ -17,6 +22,7 @@ import com.getcapacitor.Plugin;
 import com.getcapacitor.PluginCall;
 import com.getcapacitor.PluginMethod;
 import com.getcapacitor.annotation.CapacitorPlugin;
+import java.io.ByteArrayOutputStream;
 import java.io.PrintWriter;
 import java.io.StringWriter;
 import java.util.List;
@@ -25,7 +31,7 @@ import java.util.Map;
 @CapacitorPlugin(name = "CapacitorUsageStatsManager")
 public class CapacitorUsageStatsManagerPlugin extends Plugin {
-    private final String pluginVersion = "8.0.32";
+    private final String pluginVersion = "8.1.1";
     @PluginMethod
     public void queryAndAggregateUsageStats(final PluginCall call) {
@@ -100,6 +106,7 @@ public class CapacitorUsageStatsManagerPlugin extends Plugin {
     @PluginMethod
     public void queryAllPackages(final PluginCall call) {
+        final boolean includeIcon = Boolean.TRUE.equals(call.getBoolean("includeIcon", false));
         PackageManager pm = getContext().getPackageManager();
         List<PackageInfo> packages = pm.getInstalledPackages(0);
         JSObject result = new JSObject();
@@ -108,12 +115,27 @@ public class CapacitorUsageStatsManagerPlugin extends Plugin {
         for (PackageInfo packageInfo : packages) {
             JSObject packageJS = new JSObject();
             packageJS.put("packageName", packageInfo.packageName);
+            ApplicationInfo appInfo = null;
             try {
-                ApplicationInfo appInfo = pm.getApplicationInfo(packageInfo.packageName, 0);
+                appInfo = pm.getApplicationInfo(packageInfo.packageName, 0);
                 packageJS.put("appName", pm.getApplicationLabel(appInfo).toString());
             } catch (PackageManager.NameNotFoundException e) {
                 packageJS.put("appName", packageInfo.packageName);
             }
+            if (appInfo != null && Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+                packageJS.put("category", appInfo.category);
+            }
+            if (includeIcon && appInfo != null) {
+                try {
+                    Drawable icon = pm.getApplicationIcon(appInfo);
+                    String iconDataUrl = drawableToBase64DataUrl(icon);
+                    if (iconDataUrl != null) {
+                        packageJS.put("icon", iconDataUrl);
+                    }
+                } catch (Exception e) {
+                    Log.w("CapacitorUsageStatsManager", "Failed to load icon for " + packageInfo.packageName, e);
+                }
+            }
             packageJS.put("versionName", packageInfo.versionName);
             if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
                 packageJS.put("versionCode", packageInfo.getLongVersionCode());
@@ -130,6 +152,34 @@ public class CapacitorUsageStatsManagerPlugin extends Plugin {
         call.resolve(result);
     }
+    private static String drawableToBase64DataUrl(Drawable drawable) {
+        if (drawable == null) {
+            return null;
+        }
+        Bitmap bitmap;
+        if (drawable instanceof BitmapDrawable) {
+            bitmap = ((BitmapDrawable) drawable).getBitmap();
+            if (bitmap == null) {
+                return null;
+            }
+        } else {
+            int width = drawable.getIntrinsicWidth() > 0 ? drawable.getIntrinsicWidth() : 1;
+            int height = drawable.getIntrinsicHeight() > 0 ? drawable.getIntrinsicHeight() : 1;
+            bitmap = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888);
+            Canvas canvas = new Canvas(bitmap);
+            drawable.setBounds(0, 0, canvas.getWidth(), canvas.getHeight());
+            drawable.draw(canvas);
+        }
+        ByteArrayOutputStream stream = new ByteArrayOutputStream();
+        if (!bitmap.compress(Bitmap.CompressFormat.PNG, 100, stream)) {
+            return null;
+        }
+        return "data:image/png;base64," + Base64.encodeToString(stream.toByteArray(), Base64.NO_WRAP);
+    }
     @NonNull
     private static JSObject getJsObject(Map.Entry<String, UsageStats> stat) {
         final UsageStats value = stat.getValue();

package/dist/docs.json CHANGED Viewed

@@ -109,10 +109,20 @@
       },
       {
         "name": "queryAllPackages",
-        "signature": "() => Promise<{ packages: PackageInfo[]; }>",
-        "parameters": [],
+        "signature": "(options?: QueryAllPackagesOptions | undefined) => Promise<{ packages: PackageInfo[]; }>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "- Optional query settings",
+            "type": "QueryAllPackagesOptions | undefined"
+          }
+        ],
         "returns": "Promise<{ packages: PackageInfo[]; }>",
         "tags": [
+          {
+            "name": "param",
+            "text": "options - Optional query settings"
+          },
           {
             "name": "returns",
             "text": "Promise that resolves with an array of package information"
@@ -127,12 +137,13 @@
           },
           {
             "name": "example",
-            "text": "```typescript\nconst { packages } = await UsageStatsManager.queryAllPackages();\npackages.forEach(pkg => {\n  console.log(`${pkg.appName} (${pkg.packageName}): v${pkg.versionName}`);\n});\n```"
+            "text": "```typescript\nconst { packages } = await UsageStatsManager.queryAllPackages({ includeIcon: true });\npackages.forEach(pkg => {\n  console.log(`${pkg.appName} (${pkg.packageName}): category=${pkg.category}`);\n});\n```"
           }
         ],
         "docs": "Queries all installed packages on the device.\nRequires the QUERY_ALL_PACKAGES permission.",
         "complexTypes": [
-          "PackageInfo"
+          "PackageInfo",
+          "QueryAllPackagesOptions"
         ],
         "slug": "queryallpackages"
       },
@@ -346,6 +357,56 @@
           "docs": "Last update time in milliseconds since epoch",
           "complexTypes": [],
           "type": "number"
+        },
+        {
+          "name": "category",
+          "tags": [
+            {
+              "text": "8.0.33",
+              "name": "since"
+            }
+          ],
+          "docs": "Application category from `ApplicationInfo.category`.\nOnly available on Android 8.0 (API level 26) and above.\n\nCommon values:\n- `0` — undefined\n- `1` — game\n- `2` — audio\n- `3` — video\n- `4` — image\n- `5` — social\n- `6` — news\n- `7` — maps\n- `8` — productivity",
+          "complexTypes": [],
+          "type": "number | undefined"
+        },
+        {
+          "name": "icon",
+          "tags": [
+            {
+              "text": "8.0.33",
+              "name": "since"
+            }
+          ],
+          "docs": "App icon as a base64 data URL (`data:image/png;base64,...`).\nOnly present when `queryAllPackages({ includeIcon: true })` is used.",
+          "complexTypes": [],
+          "type": "string | undefined"
+        }
+      ]
+    },
+    {
+      "name": "QueryAllPackagesOptions",
+      "slug": "queryallpackagesoptions",
+      "docs": "Options for querying installed packages.",
+      "tags": [
+        {
+          "text": "8.0.33",
+          "name": "since"
+        }
+      ],
+      "methods": [],
+      "properties": [
+        {
+          "name": "includeIcon",
+          "tags": [
+            {
+              "text": "false",
+              "name": "default"
+            }
+          ],
+          "docs": "When true, includes each app's launcher icon as a base64 data URL.\nDefaults to false because icons significantly increase the response size.",
+          "complexTypes": [],
+          "type": "boolean | undefined"
         }
       ]
     }

package/dist/esm/definitions.d.ts CHANGED Viewed

@@ -134,18 +134,19 @@ export interface CapacitorUsageStatsManagerPlugin {
      * Queries all installed packages on the device.
      * Requires the QUERY_ALL_PACKAGES permission.
      *
+     * @param options - Optional query settings
      * @returns Promise that resolves with an array of package information
      * @throws Error if the permission is not granted or query fails
      * @since 1.2.0
      * @example
      * ```typescript
-     * const { packages } = await UsageStatsManager.queryAllPackages();
+     * const { packages } = await UsageStatsManager.queryAllPackages({ includeIcon: true });
      * packages.forEach(pkg => {
-     *   console.log(`${pkg.appName} (${pkg.packageName}): v${pkg.versionName}`);
+     *   console.log(`${pkg.appName} (${pkg.packageName}): category=${pkg.category}`);
      * });
      * ```
      */
-    queryAllPackages(): Promise<{
+    queryAllPackages(options?: QueryAllPackagesOptions): Promise<{
         packages: PackageInfo[];
     }>;
     /**
@@ -193,6 +194,20 @@ export interface UsageEvent {
     /** Task root class name (requires API 31+) */
     taskRootClassName?: string;
 }
+/**
+ * Options for querying installed packages.
+ *
+ * @since 8.0.33
+ */
+export interface QueryAllPackagesOptions {
+    /**
+     * When true, includes each app's launcher icon as a base64 data URL.
+     * Defaults to false because icons significantly increase the response size.
+     *
+     * @default false
+     */
+    includeIcon?: boolean;
+}
 /**
  * Represents basic information about an installed package.
  *
@@ -211,4 +226,29 @@ export interface PackageInfo {
     firstInstallTime: number;
     /** Last update time in milliseconds since epoch */
     lastUpdateTime: number;
+    /**
+     * Application category from `ApplicationInfo.category`.
+     * Only available on Android 8.0 (API level 26) and above.
+     *
+     * Common values:
+     * - `0` — undefined
+     * - `1` — game
+     * - `2` — audio
+     * - `3` — video
+     * - `4` — image
+     * - `5` — social
+     * - `6` — news
+     * - `7` — maps
+     * - `8` — productivity
+     *
+     * @since 8.0.33
+     */
+    category?: number;
+    /**
+     * App icon as a base64 data URL (`data:image/png;base64,...`).
+     * Only present when `queryAllPackages({ includeIcon: true })` is used.
+     *
+     * @since 8.0.33
+     */
+    icon?: string;
 }

package/dist/esm/definitions.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["/*\n Usage statistics for an Android app.\n \n @since 1.0.0\n /\nexport interface UsageStats {\n /\n The first timestamp of the usage stats.\n /\n firstTimeStamp: number;\n /\n The last timestamp of the usage stats.\n /\n lastTimeStamp: number;\n /\n Only available on Android Q (API level 29) and above.\n * Will be undefined on lower Android versions.\n /\n lastTimeForegroundServiceUsed?: number;\n /\n The last time the app was used.\n /\n lastTimeUsed: number;\n /\n Only available on Android Q (API level 29) and above.\n * Will be undefined on lower Android versions.\n /\n lastTimeVisible?: number;\n /\n The name of the package.\n /\n packageName: string;\n /\n Only available on Android Q (API level 29) and above.\n * Will be undefined on lower Android versions.\n /\n totalForegroundServiceUsed?: number;\n /\n The total time the app was in the foreground.\n /\n totalTimeInForeground: number;\n /\n Only available on Android Q (API level 29) and above.\n * Will be undefined on lower Android versions.\n /\n totalTimeVisible?: number;\n}\n\n/\n Options for querying usage statistics.\n \n @since 1.0.0\n /\nexport interface UsageStatsOptions {\n /\n The inclusive beginning of the range of stats to include in the results.\n * Defined in terms of \"Unix time\"\n /\n beginTime: number;\n\n /\n The exclusive end of the range of stats to include in the results.\n * Defined in terms of \"Unix time\"\n /\n endTime: number;\n}\n\n/\n Result of a usage stats permission check.\n \n @since 1.0.0\n /\nexport interface UsageStatsPermissionResult {\n /\n Whether the usage stats permission is granted.\n /\n granted: boolean;\n}\n\n/\n Capacitor plugin for accessing Android UsageStatsManager API.\n \n @since 1.0.0\n /\nexport interface CapacitorUsageStatsManagerPlugin {\n /\n Queries and aggregates usage stats for the given time range.\n \n @param options - The time range options for the query\n * @returns Promise that resolves to a record of package names and their corresponding usage stats\n * @throws Error if the permission is not granted or query fails\n * @since 1.0.0\n * @example\n * ```typescript\n * const oneDayAgo = Date.now() - 24 * 60 * 60 * 1000;\n * const now = Date.now();\n * const stats = await UsageStatsManager.queryAndAggregateUsageStats({\n * beginTime: oneDayAgo,\n * endTime: now\n * });\n \n for (const [packageName, usageData] of Object.entries(stats)) {\n * console.log(`${packageName}: ${usageData.totalTimeInForeground}ms`);\n * }\n * ```\n /\n queryAndAggregateUsageStats(options: UsageStatsOptions): Promise<Record<string, UsageStats>>;\n\n /\n Checks if the usage stats permission is granted.\n \n @returns Promise that resolves to a permission result object\n * @throws Error if checking permission fails\n * @since 1.0.0\n * @example\n * ```typescript\n * const { granted } = await UsageStatsManager.isUsageStatsPermissionGranted();\n * if (!granted) {\n * await UsageStatsManager.openUsageStatsSettings();\n * }\n * ```\n /\n isUsageStatsPermissionGranted(): Promise<UsageStatsPermissionResult>;\n\n /\n Open the usage stats settings screen.\n * This will open the usage stats settings screen, which allows the user to grant the usage stats permission.\n * This will always open the settings screen, even if the permission is already granted.\n \n @returns Promise that resolves when the settings screen is opened\n * @throws Error if opening settings fails\n * @since 1.0.0\n * @example\n * ```typescript\n * await UsageStatsManager.openUsageStatsSettings();\n * ```\n /\n openUsageStatsSettings(): Promise<void>;\n\n /\n Queries all installed packages on the device.\n * Requires the QUERY_ALL_PACKAGES permission.\n \n @returns Promise that resolves with an array of package information\n * @throws Error if the permission is not granted or query fails\n * @since 1.2.0\n * @example\n * ```typescript\n * const { packages } = await UsageStatsManager.queryAllPackages();\n * packages.forEach(pkg => {\n * console.log(`${pkg.appName} (${pkg.packageName}): v${pkg.~~versionName~~}`);\n * });\n * ```\n /\n queryAllPackages(): Promise<{ packages: PackageInfo[] }>;\n\n /\n Get the native Capacitor plugin version.\n \n @returns Promise that resolves with the plugin version\n * @throws Error if getting the version fails\n * @since 1.0.0\n * @example\n * ```typescript\n * const { version } = await UsageStatsManager.getPluginVersion();\n * console.log('Plugin version:', version);\n * ```\n /\n getPluginVersion(): Promise<{ version: string }>;\n}\n\n/\n Represents a single usage event.\n \n @since 1.0.0\n /\nexport interface UsageEvent {\n /* Package name of the app /\n packageName: string;\n /* Class name (might be null) /\n className?: string;\n /* Timestamp in milliseconds since epoch /\n timeStamp: number;\n /* Event type constant (e.g., MOVE_TO_FOREGROUND, MOVE_TO_BACKGROUND) /\n eventType: number;\n /* Configuration object (requires API 28+) /\n configuration?: any;\n /* Shortcut ID (requires API 28+) /\n shortcutId?: string;\n /* App standby bucket (requires API 28+) /\n standbyBucket?: number;\n /* Notification channel ID (requires API 29+) /\n notificationChannelId?: string;\n /* Instance ID (requires API 30+) /\n instanceId?: number;\n /* Task root package name (requires API 31+) /\n taskRootPackageName?: string;\n /* Task root class name (requires API 31+) /\n taskRootClassName?: string;\n}\n\n/\n Represents basic information about an installed package.\n \n @since 1.0.0\n /\nexport interface PackageInfo {\n /* Package name /\n packageName: string;\n /* App display name /\n appName: string;\n /* Version name string /\n versionName: string;\n /* Version code number /\n versionCode: number;\n /* First install time in milliseconds since epoch /\n firstInstallTime: number;\n /* Last update time in milliseconds since epoch */\n lastUpdateTime: number;\n}\n"]}
1	+ {"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["/*\n Usage statistics for an Android app.\n \n @since 1.0.0\n /\nexport interface UsageStats {\n /\n The first timestamp of the usage stats.\n /\n firstTimeStamp: number;\n /\n The last timestamp of the usage stats.\n /\n lastTimeStamp: number;\n /\n Only available on Android Q (API level 29) and above.\n * Will be undefined on lower Android versions.\n /\n lastTimeForegroundServiceUsed?: number;\n /\n The last time the app was used.\n /\n lastTimeUsed: number;\n /\n Only available on Android Q (API level 29) and above.\n * Will be undefined on lower Android versions.\n /\n lastTimeVisible?: number;\n /\n The name of the package.\n /\n packageName: string;\n /\n Only available on Android Q (API level 29) and above.\n * Will be undefined on lower Android versions.\n /\n totalForegroundServiceUsed?: number;\n /\n The total time the app was in the foreground.\n /\n totalTimeInForeground: number;\n /\n Only available on Android Q (API level 29) and above.\n * Will be undefined on lower Android versions.\n /\n totalTimeVisible?: number;\n}\n\n/\n Options for querying usage statistics.\n \n @since 1.0.0\n /\nexport interface UsageStatsOptions {\n /\n The inclusive beginning of the range of stats to include in the results.\n * Defined in terms of \"Unix time\"\n /\n beginTime: number;\n\n /\n The exclusive end of the range of stats to include in the results.\n * Defined in terms of \"Unix time\"\n /\n endTime: number;\n}\n\n/\n Result of a usage stats permission check.\n \n @since 1.0.0\n /\nexport interface UsageStatsPermissionResult {\n /\n Whether the usage stats permission is granted.\n /\n granted: boolean;\n}\n\n/\n Capacitor plugin for accessing Android UsageStatsManager API.\n \n @since 1.0.0\n /\nexport interface CapacitorUsageStatsManagerPlugin {\n /\n Queries and aggregates usage stats for the given time range.\n \n @param options - The time range options for the query\n * @returns Promise that resolves to a record of package names and their corresponding usage stats\n * @throws Error if the permission is not granted or query fails\n * @since 1.0.0\n * @example\n * ```typescript\n * const oneDayAgo = Date.now() - 24 * 60 * 60 * 1000;\n * const now = Date.now();\n * const stats = await UsageStatsManager.queryAndAggregateUsageStats({\n * beginTime: oneDayAgo,\n * endTime: now\n * });\n \n for (const [packageName, usageData] of Object.entries(stats)) {\n * console.log(`${packageName}: ${usageData.totalTimeInForeground}ms`);\n * }\n * ```\n /\n queryAndAggregateUsageStats(options: UsageStatsOptions): Promise<Record<string, UsageStats>>;\n\n /\n Checks if the usage stats permission is granted.\n \n @returns Promise that resolves to a permission result object\n * @throws Error if checking permission fails\n * @since 1.0.0\n * @example\n * ```typescript\n * const { granted } = await UsageStatsManager.isUsageStatsPermissionGranted();\n * if (!granted) {\n * await UsageStatsManager.openUsageStatsSettings();\n * }\n * ```\n /\n isUsageStatsPermissionGranted(): Promise<UsageStatsPermissionResult>;\n\n /\n Open the usage stats settings screen.\n * This will open the usage stats settings screen, which allows the user to grant the usage stats permission.\n * This will always open the settings screen, even if the permission is already granted.\n \n @returns Promise that resolves when the settings screen is opened\n * @throws Error if opening settings fails\n * @since 1.0.0\n * @example\n * ```typescript\n * await UsageStatsManager.openUsageStatsSettings();\n * ```\n /\n openUsageStatsSettings(): Promise<void>;\n\n /\n Queries all installed packages on the device.\n * Requires the QUERY_ALL_PACKAGES permission.\n \n @param options - Optional query settings\n * @returns Promise that resolves with an array of package information\n * @throws Error if the permission is not granted or query fails\n * @since 1.2.0\n * @example\n * ```typescript\n * const { packages } = await UsageStatsManager.queryAllPackages({ includeIcon: true });\n * packages.forEach(pkg => {\n * console.log(`${pkg.appName} (${pkg.packageName}): category=${pkg.category}`);\n * });\n * ```\n /\n queryAllPackages(options?: QueryAllPackagesOptions): Promise<{ packages: PackageInfo[] }>;\n\n /\n Get the native Capacitor plugin version.\n \n @returns Promise that resolves with the plugin version\n * @throws Error if getting the version fails\n * @since 1.0.0\n * @example\n * ```typescript\n * const { version } = await UsageStatsManager.getPluginVersion();\n * console.log('Plugin version:', version);\n * ```\n /\n getPluginVersion(): Promise<{ version: string }>;\n}\n\n/\n Represents a single usage event.\n \n @since 1.0.0\n /\nexport interface UsageEvent {\n /* Package name of the app /\n packageName: string;\n /* Class name (might be null) /\n className?: string;\n /* Timestamp in milliseconds since epoch /\n timeStamp: number;\n /* Event type constant (e.g., MOVE_TO_FOREGROUND, MOVE_TO_BACKGROUND) /\n eventType: number;\n /* Configuration object (requires API 28+) /\n configuration?: any;\n /* Shortcut ID (requires API 28+) /\n shortcutId?: string;\n /* App standby bucket (requires API 28+) /\n standbyBucket?: number;\n /* Notification channel ID (requires API 29+) /\n notificationChannelId?: string;\n /* Instance ID (requires API 30+) /\n instanceId?: number;\n /* Task root package name (requires API 31+) /\n taskRootPackageName?: string;\n /* Task root class name (requires API 31+) /\n taskRootClassName?: string;\n}\n\n/\n Options for querying installed packages.\n \n @since 8.0.33\n /\nexport interface QueryAllPackagesOptions {\n /\n When true, includes each app's launcher icon as a base64 data URL.\n * Defaults to false because icons significantly increase the response size.\n \n @default false\n /\n includeIcon?: boolean;\n}\n\n/\n Represents basic information about an installed package.\n \n @since 1.0.0\n /\nexport interface PackageInfo {\n /* Package name /\n packageName: string;\n /* App display name /\n appName: string;\n /* Version name string /\n versionName: string;\n /* Version code number /\n versionCode: number;\n /* First install time in milliseconds since epoch /\n firstInstallTime: number;\n /* Last update time in milliseconds since epoch /\n lastUpdateTime: number;\n /\n Application category from `ApplicationInfo.category`.\n * Only available on Android 8.0 (API level 26) and above.\n \n Common values:\n * - `0` — undefined\n * - `1` — game\n * - `2` — audio\n * - `3` — video\n * - `4` — image\n * - `5` — social\n * - `6` — news\n * - `7` — maps\n * - `8` — productivity\n \n @since 8.0.33\n /\n category?: number;\n /\n App icon as a base64 data URL (`data:image/png;base64,...`).\n * Only present when `queryAllPackages({ includeIcon: true })` is used.\n \n @since 8.0.33\n */\n icon?: string;\n}\n"]}

package/dist/esm/web.d.ts CHANGED Viewed

@@ -4,7 +4,9 @@ export declare class CapacitorUsageStatsManagerWeb extends WebPlugin implements
     isUsageStatsPermissionGranted(): Promise<any>;
     openUsageStatsSettings(): Promise<void>;
     queryAndAggregateUsageStats(_options: any): Promise<Record<string, any>>;
-    queryAllPackages(): Promise<{
+    queryAllPackages(_options?: {
+        includeIcon?: boolean;
+    }): Promise<{
         packages: PackageInfo[];
     }>;
     getPluginVersion(): Promise<{

package/dist/esm/web.js CHANGED Viewed

@@ -9,7 +9,7 @@ export class CapacitorUsageStatsManagerWeb extends WebPlugin {
     queryAndAggregateUsageStats(_options) {
         throw new Error('Method not implemented.');
     }
-    queryAllPackages() {
+    queryAllPackages(_options) {
         throw new Error('Method not implemented.');
     }
     async getPluginVersion() {

package/dist/esm/web.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,MAAM,OAAO,6BAA8B,SAAQ,SAAS;IAC1D,6BAA6B;QAC3B,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IACD,sBAAsB;QACpB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IACD,2BAA2B,CAAC,QAAa;QACvC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IACD,gBAAgB;~~QACd~~,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type { CapacitorUsageStatsManagerPlugin, PackageInfo } from './definitions';\n\nexport class CapacitorUsageStatsManagerWeb extends WebPlugin implements CapacitorUsageStatsManagerPlugin {\n isUsageStatsPermissionGranted(): Promise<any> {\n throw new Error('Method not implemented.');\n }\n openUsageStatsSettings(): Promise<void> {\n throw new Error('Method not implemented.');\n }\n queryAndAggregateUsageStats(_options: any): Promise<Record<string, any>> {\n throw new Error('Method not implemented.');\n }\n queryAllPackages(): Promise<{ packages: PackageInfo[] }> {\n throw new Error('Method not implemented.');\n }\n\n async getPluginVersion(): Promise<{ version: string }> {\n return { version: 'web' };\n }\n}\n"]}
1	+ {"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,MAAM,OAAO,6BAA8B,SAAQ,SAAS;IAC1D,6BAA6B;QAC3B,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IACD,sBAAsB;QACpB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IACD,2BAA2B,CAAC,QAAa;QACvC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IACD,gBAAgB,CAAC,QAAoC;QACnD,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type { CapacitorUsageStatsManagerPlugin, PackageInfo } from './definitions';\n\nexport class CapacitorUsageStatsManagerWeb extends WebPlugin implements CapacitorUsageStatsManagerPlugin {\n isUsageStatsPermissionGranted(): Promise<any> {\n throw new Error('Method not implemented.');\n }\n openUsageStatsSettings(): Promise<void> {\n throw new Error('Method not implemented.');\n }\n queryAndAggregateUsageStats(_options: any): Promise<Record<string, any>> {\n throw new Error('Method not implemented.');\n }\n queryAllPackages(_options?: { includeIcon?: boolean }): Promise<{ packages: PackageInfo[] }> {\n throw new Error('Method not implemented.');\n }\n\n async getPluginVersion(): Promise<{ version: string }> {\n return { version: 'web' };\n }\n}\n"]}

package/dist/plugin.cjs.js CHANGED Viewed

@@ -16,7 +16,7 @@ class CapacitorUsageStatsManagerWeb extends core.WebPlugin {
     queryAndAggregateUsageStats(_options) {
         throw new Error('Method not implemented.');
     }
-    queryAllPackages() {
+    queryAllPackages(_options) {
         throw new Error('Method not implemented.');
     }
     async getPluginVersion() {

package/dist/plugin.cjs.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst CapacitorUsageStatsManager = registerPlugin('CapacitorUsageStatsManager', {\n web: () => import('./web').then((m) => new m.CapacitorUsageStatsManagerWeb()),\n});\nexport * from './definitions';\nexport { CapacitorUsageStatsManager };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class CapacitorUsageStatsManagerWeb extends WebPlugin {\n isUsageStatsPermissionGranted() {\n throw new Error('Method not implemented.');\n }\n openUsageStatsSettings() {\n throw new Error('Method not implemented.');\n }\n queryAndAggregateUsageStats(_options) {\n throw new Error('Method not implemented.');\n }\n queryAllPackages() {\n throw new Error('Method not implemented.');\n }\n async getPluginVersion() {\n return { version: 'web' };\n }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACK,MAAC,0BAA0B,GAAGA,mBAAc,CAAC,4BAA4B,EAAE;AAChF,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,6BAA6B,EAAE,CAAC;AACjF,CAAC;;ACFM,MAAM,6BAA6B,SAASC,cAAS,CAAC;AAC7D,IAAI,6BAA6B,GAAG;AACpC,QAAQ,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC;AAClD,IAAI;AACJ,IAAI,sBAAsB,GAAG;AAC7B,QAAQ,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC;AAClD,IAAI;AACJ,IAAI,2BAA2B,CAAC,QAAQ,EAAE;AAC1C,QAAQ,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC;AAClD,IAAI;AACJ,IAAI,gBAAgB,~~GAAG~~;~~AACvB~~,QAAQ,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC;AAClD,IAAI;AACJ,IAAI,MAAM,gBAAgB,GAAG;AAC7B,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;AACjC,IAAI;AACJ;;;;;;;;;"}
1	+ {"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst CapacitorUsageStatsManager = registerPlugin('CapacitorUsageStatsManager', {\n web: () => import('./web').then((m) => new m.CapacitorUsageStatsManagerWeb()),\n});\nexport * from './definitions';\nexport { CapacitorUsageStatsManager };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class CapacitorUsageStatsManagerWeb extends WebPlugin {\n isUsageStatsPermissionGranted() {\n throw new Error('Method not implemented.');\n }\n openUsageStatsSettings() {\n throw new Error('Method not implemented.');\n }\n queryAndAggregateUsageStats(_options) {\n throw new Error('Method not implemented.');\n }\n queryAllPackages(_options) {\n throw new Error('Method not implemented.');\n }\n async getPluginVersion() {\n return { version: 'web' };\n }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACK,MAAC,0BAA0B,GAAGA,mBAAc,CAAC,4BAA4B,EAAE;AAChF,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,6BAA6B,EAAE,CAAC;AACjF,CAAC;;ACFM,MAAM,6BAA6B,SAASC,cAAS,CAAC;AAC7D,IAAI,6BAA6B,GAAG;AACpC,QAAQ,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC;AAClD,IAAI;AACJ,IAAI,sBAAsB,GAAG;AAC7B,QAAQ,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC;AAClD,IAAI;AACJ,IAAI,2BAA2B,CAAC,QAAQ,EAAE;AAC1C,QAAQ,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC;AAClD,IAAI;AACJ,IAAI,gBAAgB,CAAC,QAAQ,EAAE;AAC/B,QAAQ,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC;AAClD,IAAI;AACJ,IAAI,MAAM,gBAAgB,GAAG;AAC7B,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;AACjC,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js CHANGED Viewed

@@ -15,7 +15,7 @@ var capacitorCapacitorUsageStatsManager = (function (exports, core) {
         queryAndAggregateUsageStats(_options) {
             throw new Error('Method not implemented.');
         }
-        queryAllPackages() {
+        queryAllPackages(_options) {
             throw new Error('Method not implemented.');
         }
         async getPluginVersion() {

package/dist/plugin.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst CapacitorUsageStatsManager = registerPlugin('CapacitorUsageStatsManager', {\n web: () => import('./web').then((m) => new m.CapacitorUsageStatsManagerWeb()),\n});\nexport * from './definitions';\nexport { CapacitorUsageStatsManager };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class CapacitorUsageStatsManagerWeb extends WebPlugin {\n isUsageStatsPermissionGranted() {\n throw new Error('Method not implemented.');\n }\n openUsageStatsSettings() {\n throw new Error('Method not implemented.');\n }\n queryAndAggregateUsageStats(_options) {\n throw new Error('Method not implemented.');\n }\n queryAllPackages() {\n throw new Error('Method not implemented.');\n }\n async getPluginVersion() {\n return { version: 'web' };\n }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;AACK,UAAC,0BAA0B,GAAGA,mBAAc,CAAC,4BAA4B,EAAE;IAChF,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,6BAA6B,EAAE,CAAC;IACjF,CAAC;;ICFM,MAAM,6BAA6B,SAASC,cAAS,CAAC;IAC7D,IAAI,6BAA6B,GAAG;IACpC,QAAQ,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC;IAClD,IAAI;IACJ,IAAI,sBAAsB,GAAG;IAC7B,QAAQ,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC;IAClD,IAAI;IACJ,IAAI,2BAA2B,CAAC,QAAQ,EAAE;IAC1C,QAAQ,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC;IAClD,IAAI;IACJ,IAAI,gBAAgB,~~GAAG~~;~~IACvB~~,QAAQ,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC;IAClD,IAAI;IACJ,IAAI,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;IACjC,IAAI;IACJ;;;;;;;;;;;;;;;"}
1	+ {"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst CapacitorUsageStatsManager = registerPlugin('CapacitorUsageStatsManager', {\n web: () => import('./web').then((m) => new m.CapacitorUsageStatsManagerWeb()),\n});\nexport * from './definitions';\nexport { CapacitorUsageStatsManager };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class CapacitorUsageStatsManagerWeb extends WebPlugin {\n isUsageStatsPermissionGranted() {\n throw new Error('Method not implemented.');\n }\n openUsageStatsSettings() {\n throw new Error('Method not implemented.');\n }\n queryAndAggregateUsageStats(_options) {\n throw new Error('Method not implemented.');\n }\n queryAllPackages(_options) {\n throw new Error('Method not implemented.');\n }\n async getPluginVersion() {\n return { version: 'web' };\n }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;AACK,UAAC,0BAA0B,GAAGA,mBAAc,CAAC,4BAA4B,EAAE;IAChF,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,6BAA6B,EAAE,CAAC;IACjF,CAAC;;ICFM,MAAM,6BAA6B,SAASC,cAAS,CAAC;IAC7D,IAAI,6BAA6B,GAAG;IACpC,QAAQ,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC;IAClD,IAAI;IACJ,IAAI,sBAAsB,GAAG;IAC7B,QAAQ,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC;IAClD,IAAI;IACJ,IAAI,2BAA2B,CAAC,QAAQ,EAAE;IAC1C,QAAQ,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC;IAClD,IAAI;IACJ,IAAI,gBAAgB,CAAC,QAAQ,EAAE;IAC/B,QAAQ,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC;IAClD,IAAI;IACJ,IAAI,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;IACjC,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/ios/Sources/CapacitorUsageStatsManagerPlugin/CapacitorUsageStatsManagerPlugin.swift CHANGED Viewed

@@ -7,7 +7,7 @@ import Capacitor
  */
 @objc(CapacitorUsageStatsManagerPlugin)
 public class CapacitorUsageStatsManagerPlugin: CAPPlugin, CAPBridgedPlugin {
-    private let pluginVersion: String = "8.0.32"
+    private let pluginVersion: String = "8.1.1"
     public let identifier = "CapacitorUsageStatsManagerPlugin"
     public let jsName = "CapacitorUsageStatsManager"
     public let pluginMethods: [CAPPluginMethod] = [

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@capgo/capacitor-android-usagestatsmanager",
-  "version": "8.0.32",
+  "version": "8.1.1",
   "description": "Exposes the Android's UsageStatsManager SDK to Capacitor",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",
@@ -47,7 +47,8 @@
     "prepublishOnly": "bun run build",
     "check:wiring": "node scripts/check-capacitor-plugin-wiring.mjs",
     "example:install": "cd example-app && bun install --frozen-lockfile",
-    "example:build": "bun run build && cd example-app && bun install --frozen-lockfile && bun run build"
+    "example:build": "bun run build && cd example-app && bun install --frozen-lockfile && bun run build",
+    "changelog:ai": "node scripts/generate-ai-changelog.mjs"
   },
   "devDependencies": {
     "@capacitor/android": "^8.0.0",