@akanjs/devkit 2.4.0-rc.3 → 2.4.0-rc.4

package/akanConfig/akanConfig.test.ts

@@ -265,22 +265,25 @@ describe("AkanAppConfig", () => {
       `postgres@${runtimeDependencies.postgres}`,
       `protobufjs@${runtimeDependencies.protobufjs}`,
     ]);
-    expect(config.getMobileRuntimePackages()).toEqual([
+    const expectedMobilePackages: string[] = [
       "firebase",
       "@capacitor/cli",
       "@capacitor/core",
       "@capacitor/ios",
       "@capacitor/android",
       "@capacitor/assets",
-    ]);
-    expect(config.getMissingMobileDependencySpecs()).toEqual([
-      `firebase@${runtimeDependencies.firebase}`,
-      `@capacitor/cli@${runtimeDependencies["@capacitor/cli"]}`,
-      `@capacitor/core@${runtimeDependencies["@capacitor/core"]}`,
-      `@capacitor/ios@${runtimeDependencies["@capacitor/ios"]}`,
-      `@capacitor/android@${runtimeDependencies["@capacitor/android"]}`,
-      `@capacitor/assets@${runtimeDependencies["@capacitor/assets"]}`,
-    ]);
+      "@capacitor/app",
+      "@capacitor/device",
+      "@capacitor/keyboard",
+      "@capacitor/haptics",
+      "@capacitor/preferences",
+      "@capacitor/browser",
+      "capacitor-plugin-safe-area",
+    ];
+    expect(config.getMobileRuntimePackages() as string[]).toEqual(expectedMobilePackages);
+    expect(config.getMissingMobileDependencySpecs()).toEqual(
+      expectedMobilePackages.map((lib) => `${lib}@${runtimeDependencies[lib as keyof typeof runtimeDependencies]}`),
+    );
   });
 
   test("normalizes multiple mobile targets and validates base paths", () => {

package/akanConfig/akanConfig.ts

@@ -53,9 +53,16 @@ const SSR_RUNTIME_PACKAGES = ["react", "react-dom", "react-server-dom-webpack"]
 const NATIVE_RUNTIME_PACKAGES = ["sharp"] as const;
 const DEFAULT_BACKEND_RUNTIME_PACKAGES = ["croner"] as const;
 // Packages required to build/run a mobile target that are not part of the base bootstrap;
-// installed on demand when a mobile target is built or started. Covers the firebase client
-// (push tokens) plus the Capacitor toolchain (`npx cap` / `npx @capacitor/assets`), which is
-// otherwise declared only as optional peers and never auto-installed on a fresh workspace.
+// installed on demand when a mobile target is built or started. All are declared only as
+// optional peers, so a fresh workspace never auto-installs them. Split into three groups:
+//   1. the firebase client (push tokens),
+//   2. the Capacitor toolchain (`npx cap` / `npx @capacitor/assets` + the native platforms), and
+//   3. the Capacitor plugins the framework loads unconditionally on every native boot — Device,
+//      Keyboard, Haptics and SafeArea (`Device.load`), App (CSR lifecycle), Preferences (storage),
+//      Browser (`CsrLink` navigation). Without them `npx cap sync` never registers the native
+//      plugin, so the JS bridge throws `Capacitor plugin "Device" is not available.` at runtime.
+// Feature-gated plugins (camera, contacts, geolocation, push, fcm, updater, purchase) stay opt-in
+// optional peers because they need app-specific native permissions/config before they can be used.
 const MOBILE_RUNTIME_PACKAGES = [
   "firebase",
   "@capacitor/cli",
@@ -63,6 +70,13 @@ const MOBILE_RUNTIME_PACKAGES = [
   "@capacitor/ios",
   "@capacitor/android",
   "@capacitor/assets",
+  "@capacitor/app",
+  "@capacitor/device",
+  "@capacitor/keyboard",
+  "@capacitor/haptics",
+  "@capacitor/preferences",
+  "@capacitor/browser",
+  "capacitor-plugin-safe-area",
 ] as const;
 const DATABASE_MODE_RUNTIME_PACKAGES = {
   single: [],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/devkit",
-  "version": "2.4.0-rc.3",
+  "version": "2.4.0-rc.4",
   "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.3",
+    "akanjs": "2.4.0-rc.4",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "daisyui": "5.5.23",