@akanjs/devkit 2.4.0-rc.5 → 2.4.0-rc.7

package/akanConfig/akanConfig.test.ts

@@ -265,6 +265,8 @@ describe("AkanAppConfig", () => {
       `postgres@${runtimeDependencies.postgres}`,
       `protobufjs@${runtimeDependencies.protobufjs}`,
     ]);
+    // The workspace-root install covers the toolchain/runtime plus every app Capacitor plugin
+    // (deduped — "@capacitor/core" appears in both source lists).
     const expectedMobilePackages: string[] = [
       "firebase",
       "@capacitor/cli",
@@ -272,6 +274,18 @@ describe("AkanAppConfig", () => {
       "@capacitor/ios",
       "@capacitor/android",
       "@capacitor/assets",
+      "@capacitor-community/fcm",
+      "@capacitor/app",
+      "@capacitor/browser",
+      "@capacitor/camera",
+      "@capacitor/device",
+      "@capacitor/geolocation",
+      "@capacitor/haptics",
+      "@capacitor/inappbrowser",
+      "@capacitor/keyboard",
+      "@capacitor/preferences",
+      "@capacitor/push-notifications",
+      "capacitor-plugin-safe-area",
     ];
     expect(config.getMobileRuntimePackages() as string[]).toEqual(expectedMobilePackages);
     expect(config.getMissingMobileDependencySpecs()).toEqual(

package/akanConfig/akanConfig.ts

@@ -52,11 +52,11 @@ const WORKSPACE_BARREL_FACETS = ["ui", "webkit", "common", "client", "server"] a
 const SSR_RUNTIME_PACKAGES = ["react", "react-dom", "react-server-dom-webpack"] as const;
 const NATIVE_RUNTIME_PACKAGES = ["sharp"] as const;
 const DEFAULT_BACKEND_RUNTIME_PACKAGES = ["croner"] as const;
-// Packages installed at the workspace root before a mobile target is built or started. All are
-// declared only as optional peers, so a fresh workspace never auto-installs them. Covers the
-// firebase client (push tokens) and the Capacitor toolchain — `@capacitor/cli` (`npx cap`),
+// The firebase client (push tokens) and the Capacitor toolchain — `@capacitor/cli` (`npx cap`),
 // `@capacitor/assets` (`npx @capacitor/assets`) plus the `@capacitor/core`/`ios`/`android` runtime
 // and native-platform packages that `npx cap add`/`sync` resolve from the workspace node_modules.
+// All are declared only as optional peers, so a fresh workspace never auto-installs them; the mobile
+// preflight installs them (together with MOBILE_APP_CAPACITOR_PLUGINS) at the workspace root.
 const MOBILE_RUNTIME_PACKAGES = [
   "firebase",
   "@capacitor/cli",
@@ -65,12 +65,13 @@ const MOBILE_RUNTIME_PACKAGES = [
   "@capacitor/android",
   "@capacitor/assets",
 ] as const;
-// Capacitor plugins that must be declared in the *app's* package.json (apps/<app>/package.json).
-// `npx cap sync` discovers plugins by scanning the app directory's dependencies and registers their
-// native code into the iOS/Android projects; packages present only in the workspace root are never
-// registered, so the JS bridge throws `Capacitor plugin "Device" is not available.` at runtime.
-// These are added on start-ios / start-android with a "*" range, letting bun resolve them to the
-// version already hoisted at the workspace root instead of pinning a second source of truth.
+// Capacitor plugins that must additionally be declared in the *app's* package.json
+// (apps/<app>/package.json): `npx cap sync` discovers plugins by scanning the app directory's
+// dependencies and registers their native code into the iOS/Android projects; packages present only
+// at the workspace root are never registered, so the JS bridge throws
+// `Capacitor plugin "Device" is not available.` at runtime. They are installed at the workspace root
+// alongside MOBILE_RUNTIME_PACKAGES (pinned via optional peers) and declared in the app with a "*"
+// range so bun dedupes them to that hoisted version instead of pinning a second source of truth.
 const MOBILE_APP_CAPACITOR_PLUGINS = [
   "@capacitor-community/fcm",
   "@capacitor/app",
@@ -423,7 +424,9 @@ CMD [${command.map((c) => `"${c}"`).join(",")}]`;
     return this.#getMissingDependencySpecs(this.getDatabaseModeRuntimePackages(databaseMode));
   }
   getMobileRuntimePackages() {
-    return [...MOBILE_RUNTIME_PACKAGES];
+    // The app Capacitor plugins are installed at the workspace root too, so bun can resolve the
+    // app's "*" declarations to a hoisted, peer-pinned version instead of fetching latest.
+    return [...new Set([...MOBILE_RUNTIME_PACKAGES, ...MOBILE_APP_CAPACITOR_PLUGINS])];
   }
   getMissingMobileDependencySpecs() {
     return this.#getMissingDependencySpecs(this.getMobileRuntimePackages());

package/capacitorApp.test.ts

@@ -4,6 +4,7 @@ import os from "node:os";
 import path from "node:path";
 import type { AkanMobileTargetConfig } from "./akanConfig";
 import {
+  ANDROID_MIN_SDK_VERSION,
   assertJsonSerializable,
   buildIosNativeRunCommand,
   classifyIosRunFailure,
@@ -14,6 +15,7 @@ import {
   materializeCapacitorConfig,
   parseDevicectlDevices,
   parseSimctlDevices,
+  raiseGradleMinSdkVersion,
   rootCapacitorConfigFilenames,
   sanitizeIosNativeRunEnv,
   writeRootCapacitorConfig,
@@ -255,3 +257,24 @@ describe("Android signing diagnostics", () => {
     ]);
   });
 });
+
+describe("raiseGradleMinSdkVersion", () => {
+  test("raises the scaffold minSdkVersion to the bundled-plugin floor, preserving formatting", () => {
+    const scaffold = "ext {\n    minSdkVersion = 24\n    compileSdkVersion = 35\n}\n";
+    expect(raiseGradleMinSdkVersion(scaffold)).toBe(
+      `ext {\n    minSdkVersion = ${ANDROID_MIN_SDK_VERSION}\n    compileSdkVersion = 35\n}\n`,
+    );
+  });
+
+  test("returns null when nothing needs changing", () => {
+    // Already at the floor, already above it, and no assignment present.
+    expect(raiseGradleMinSdkVersion(`ext {\n    minSdkVersion = ${ANDROID_MIN_SDK_VERSION}\n}\n`)).toBeNull();
+    expect(raiseGradleMinSdkVersion("ext {\n    minSdkVersion = 34\n}\n")).toBeNull();
+    expect(raiseGradleMinSdkVersion("ext {\n    compileSdkVersion = 35\n}\n")).toBeNull();
+  });
+
+  test("honors an explicit floor and leaves higher user values untouched", () => {
+    expect(raiseGradleMinSdkVersion("minSdkVersion = 21", 23)).toBe("minSdkVersion = 23");
+    expect(raiseGradleMinSdkVersion("minSdkVersion = 28", 26)).toBeNull();
+  });
+});

package/capacitorApp.ts

@@ -203,7 +203,7 @@ export function parseSimctlDevices(output: string): IosRunTarget[] {
     const json = JSON.parse(output) as { devices?: Record<string, unknown[]> };
     const devices = json.devices ?? {};
     return Object.values(devices)
-      .flatMap((runtimeDevices) => runtimeDevices)
+      .flat()
       .filter(isRecord)
       .flatMap((device) => {
         const id = firstString(device.udid, device.UDID, device.identifier);
@@ -424,6 +424,15 @@ export function getAdbDeviceStateIssues(output: string) {
     });
 }
 
+export const ANDROID_MIN_SDK_VERSION = 26;
+export function raiseGradleMinSdkVersion(content: string, floor: number = ANDROID_MIN_SDK_VERSION): string | null {
+  const match = content.match(/minSdkVersion\s*=\s*(\d+)/);
+  if (!match?.[1]) return null;
+  const current = Number.parseInt(match[1], 10);
+  if (Number.isNaN(current) || current >= floor) return null;
+  return content.replace(/(minSdkVersion\s*=\s*)\d+/, `$1${floor}`);
+}
+
 const mergeAllowNavigation = (configured: unknown, localIp: string | undefined) => {
   const values = Array.isArray(configured)
     ? configured.filter((value): value is string => typeof value === "string")
@@ -766,6 +775,7 @@ export class CapacitorApp {
     await this.#prepareTargetAssets();
     await this.#prepareExternalFiles("android");
     await this.#applyAndroidMetadata();
+    await this.#applyAndroidMinSdkVersion();
     await this.#applyPermissions({ operation, env });
     await this.#applyDeepLinks("android", { operation, env });
     await this.project.commit();
@@ -992,6 +1002,14 @@ export class CapacitorApp {
     await this.project.android.setVersionCode(this.target.buildNum);
     await this.project.android.setAppName(this.target.appName);
   }
+  async #applyAndroidMinSdkVersion() {
+    const variablesGradlePath = path.join(this.app.cwdPath, this.androidRootPath, "variables.gradle");
+    if (!(await Bun.file(variablesGradlePath).exists())) return;
+    const updated = raiseGradleMinSdkVersion(await Bun.file(variablesGradlePath).text());
+    if (!updated) return;
+    await writeFile(variablesGradlePath, updated);
+    this.app.verbose(`Raised Android minSdkVersion to ${ANDROID_MIN_SDK_VERSION} in variables.gradle`);
+  }
   async #applyPermissions({ operation, env }: Pick<RunConfig, "operation" | "env">) {
     const plugins = await this.app.collectPlugins();
     const nativePlugins = new Map<MobilePermission, AkanPlugin[]>();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/devkit",
-  "version": "2.4.0-rc.5",
+  "version": "2.4.0-rc.7",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {
@@ -32,7 +32,7 @@
     "@langchain/openai": "^1.4.6",
     "@tailwindcss/node": "^4.3.0",
     "@trapezedev/project": "^7.1.4",
-    "akanjs": "2.4.0-rc.5",
+    "akanjs": "2.4.0-rc.7",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "daisyui": "5.5.23",