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

package/akanConfig/akanConfig.test.ts

@@ -272,18 +272,26 @@ describe("AkanAppConfig", () => {
       "@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]}`),
     );
+    expect(config.getMobileAppCapacitorPlugins()).toEqual([
+      "@capacitor-community/fcm",
+      "@capacitor/app",
+      "@capacitor/browser",
+      "@capacitor/camera",
+      "@capacitor/core",
+      "@capacitor/device",
+      "@capacitor/geolocation",
+      "@capacitor/haptics",
+      "@capacitor/inappbrowser",
+      "@capacitor/keyboard",
+      "@capacitor/preferences",
+      "@capacitor/push-notifications",
+      "capacitor-plugin-safe-area",
+    ]);
   });
 
   test("normalizes multiple mobile targets and validates base paths", () => {

package/akanConfig/akanConfig.ts

@@ -52,17 +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 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.
+// 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`),
+// `@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.
 const MOBILE_RUNTIME_PACKAGES = [
   "firebase",
   "@capacitor/cli",
@@ -70,12 +64,26 @@ const MOBILE_RUNTIME_PACKAGES = [
   "@capacitor/ios",
   "@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.
+const MOBILE_APP_CAPACITOR_PLUGINS = [
+  "@capacitor-community/fcm",
   "@capacitor/app",
+  "@capacitor/browser",
+  "@capacitor/camera",
+  "@capacitor/core",
   "@capacitor/device",
-  "@capacitor/keyboard",
+  "@capacitor/geolocation",
   "@capacitor/haptics",
+  "@capacitor/inappbrowser",
+  "@capacitor/keyboard",
   "@capacitor/preferences",
-  "@capacitor/browser",
+  "@capacitor/push-notifications",
   "capacitor-plugin-safe-area",
 ] as const;
 const DATABASE_MODE_RUNTIME_PACKAGES = {
@@ -420,6 +428,9 @@ CMD [${command.map((c) => `"${c}"`).join(",")}]`;
   getMissingMobileDependencySpecs() {
     return this.#getMissingDependencySpecs(this.getMobileRuntimePackages());
   }
+  getMobileAppCapacitorPlugins() {
+    return [...MOBILE_APP_CAPACITOR_PLUGINS];
+  }
   #getMissingDependencySpecs(libs: readonly string[]) {
     const rootDependencies = {
       ...this.rootPackageJson.dependencies,

package/package.json

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