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

package/akanConfig/akanConfig.test.ts

@@ -265,8 +265,25 @@ describe("AkanAppConfig", () => {
       `postgres@${runtimeDependencies.postgres}`,
       `protobufjs@${runtimeDependencies.protobufjs}`,
     ]);
-    expect(config.getMobileRuntimePackages()).toEqual(["firebase"]);
-    expect(config.getMissingMobileDependencySpecs()).toEqual([`firebase@${runtimeDependencies.firebase}`]);
+    const expectedMobilePackages: string[] = [
+      "firebase",
+      "@capacitor/cli",
+      "@capacitor/core",
+      "@capacitor/ios",
+      "@capacitor/android",
+      "@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

@@ -52,9 +52,32 @@ 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;
-// Native-only client packages that are not bundled into the base bootstrap; installed
-// on demand when a mobile target is built or started (e.g. firebase for push tokens).
-const MOBILE_RUNTIME_PACKAGES = ["firebase"] 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. 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",
+  "@capacitor/core",
+  "@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: [],
   multiple: ["@libsql/client", "bullmq", "ioredis", "protobufjs"],

package/package.json

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