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

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,18 +274,38 @@ describe("AkanAppConfig", () => {
       "@capacitor/ios",
       "@capacitor/android",
       "@capacitor/assets",
+      "@capacitor-community/fcm",
       "@capacitor/app",
+      "@capacitor/browser",
+      "@capacitor/camera",
       "@capacitor/device",
-      "@capacitor/keyboard",
+      "@capacitor/geolocation",
       "@capacitor/haptics",
+      "@capacitor/inappbrowser",
+      "@capacitor/keyboard",
       "@capacitor/preferences",
-      "@capacitor/browser",
+      "@capacitor/push-notifications",
       "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.
+// 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",
@@ -70,12 +64,27 @@ const MOBILE_RUNTIME_PACKAGES = [
   "@capacitor/ios",
   "@capacitor/android",
   "@capacitor/assets",
+] as const;
+// 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",
+  "@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 = {
@@ -415,11 +424,16 @@ 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());
   }
+  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.6",
   "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.6",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "daisyui": "5.5.23",