@akanjs/cli 2.3.11-rc.7 → 2.3.11-rc.9

package/incrementalBuilder.proc.js

@@ -666,6 +666,7 @@ import {
 import { readFileSync as readFileSync3 } from "fs";
 import { copyFile, mkdir as mkdir2, readdir as readDirEntries, stat as stat2 } from "fs/promises";
 import path7 from "path";
+import { pathToFileURL } from "url";
 import {
   capitalize,
   isRouteSourceFile,
@@ -1107,6 +1108,63 @@ var decreaseBuildNum = async (app) => {
   const akanConfigContent = akanConfig.replace(`buildNum: ${appConfig.mobile.buildNum}`, `buildNum: ${appConfig.mobile.buildNum - 1}`);
   fs.writeFileSync(akanConfigPath, akanConfigContent);
 };
+// pkgs/@akanjs/devkit/firebaseMessagingSw.ts
+var FIREBASE_WEB_SDK_VERSION = "12.13.0";
+function normalizeFirebaseClientConfig(config) {
+  if (!config || typeof config !== "object")
+    return null;
+  const value = config;
+  if (typeof value.apiKey !== "string" || typeof value.projectId !== "string" || typeof value.messagingSenderId !== "string" || typeof value.appId !== "string") {
+    return null;
+  }
+  return {
+    apiKey: value.apiKey,
+    ...typeof value.authDomain === "string" ? { authDomain: value.authDomain } : {},
+    projectId: value.projectId,
+    ...typeof value.storageBucket === "string" ? { storageBucket: value.storageBucket } : {},
+    messagingSenderId: value.messagingSenderId,
+    appId: value.appId
+  };
+}
+function createFirebaseMessagingServiceWorker(config) {
+  const configJson = JSON.stringify(config);
+  return `/* Generated by Akan.js. Do not edit. */
+const firebaseConfig = ${configJson};
+
+if (firebaseConfig) {
+  importScripts("https://www.gstatic.com/firebasejs/${FIREBASE_WEB_SDK_VERSION}/firebase-app-compat.js");
+  importScripts("https://www.gstatic.com/firebasejs/${FIREBASE_WEB_SDK_VERSION}/firebase-messaging-compat.js");
+
+  firebase.initializeApp(firebaseConfig);
+  const messaging = firebase.messaging();
+
+  const notificationUrl = (payload) =>
+    payload?.data?.url || payload?.fcmOptions?.link || payload?.notification?.click_action;
+
+  messaging.onBackgroundMessage((payload) => {
+    const title = payload?.notification?.title || "";
+    const options = {
+      body: payload?.notification?.body,
+      icon: payload?.notification?.icon,
+      image: payload?.notification?.image,
+      data: {
+        url: notificationUrl(payload),
+        FCM_MSG: payload,
+      },
+    };
+    self.registration.showNotification(title, options);
+  });
+}
+
+self.addEventListener("notificationclick", (event) => {
+  const url = event.notification?.data?.url || event.notification?.data?.FCM_MSG?.data?.url;
+  event.notification?.close();
+  if (!url) return;
+  event.waitUntil(clients.openWindow(url));
+});
+`;
+}
+
 // pkgs/@akanjs/devkit/getDirname.ts
 import path2 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
@@ -1392,6 +1450,7 @@ ${errorText}, ${warningText} found`];
 
 // pkgs/@akanjs/devkit/scanInfo.ts
 import path5 from "path";
+import { rm } from "fs/promises";
 
 // pkgs/@akanjs/devkit/dependencyScanner.ts
 import { builtinModules } from "module";
@@ -1713,6 +1772,7 @@ var appRootAllowedFiles = new Set([
   "tsconfig.json",
   "tsconfig.tsbuildinfo"
 ]);
+var generatedRootCapacitorConfigFiles = ["capacitor.config.js", "capacitor.config.json"];
 var appRootAllowedDirs = new Set([
   ".akan",
   "android",
@@ -1756,11 +1816,17 @@ var rootSignalTestFilePattern = /^[A-Za-z][A-Za-z0-9_-]*\.signal\.(test|spec)\.(
 var isAllowedTestFile = (filename) => testFilePattern.test(filename);
 var isAllowedLibRootFile = (filename) => libRootAllowedFiles.has(filename) || rootSignalTestFilePattern.test(filename);
 var getScanPath = (exec, relativePath) => path5.posix.join(`${exec.type}s`, exec.name, relativePath.split(path5.sep).join("/"));
+async function clearGeneratedRootCapacitorConfigs(exec) {
+  if (exec.type !== "app")
+    return;
+  await Promise.all(generatedRootCapacitorConfigFiles.map((filename) => rm(exec.getPath(filename), { force: true })));
+}
 var getModuleNameFromPath = (kind, modulePath) => {
   const dirname = path5.basename(modulePath);
   return kind === "service" ? dirname.replace(/^_+/, "") : dirname;
 };
 async function assertScanConvention(exec, libRoot) {
+  await clearGeneratedRootCapacitorConfigs(exec);
   const violations = [];
   const addViolation = (relativePath, reason) => {
     violations.push(`${getScanPath(exec, relativePath)}: ${reason}`);
@@ -3689,8 +3755,30 @@ class AppExecutor extends SysExecutor {
     });
     if (write)
       await this.syncAssets(scanInfo.getScanResult().libDeps);
+    if (write)
+      await this.#syncFirebaseMessagingSw();
     return scanInfo;
   }
+  async#syncFirebaseMessagingSw() {
+    const swRelPath = "public/firebase-messaging-sw.js";
+    if (await FileSys.fileExists(this.getPath(swRelPath)))
+      return;
+    const envClientPath = path7.join(this.cwdPath, "env", "env.client.ts");
+    if (!await FileSys.fileExists(envClientPath))
+      return;
+    let firebaseConfig = null;
+    try {
+      const envUrl = pathToFileURL(envClientPath);
+      envUrl.searchParams.set("t", String(Date.now()));
+      const envModule = await import(envUrl.href);
+      firebaseConfig = normalizeFirebaseClientConfig(envModule.env?.firebase);
+    } catch {
+      return;
+    }
+    if (!firebaseConfig)
+      return;
+    await this.writeFile(swRelPath, createFirebaseMessagingServiceWorker(firebaseConfig), { overwrite: false });
+  }
   async increaseBuildNum() {
     await increaseBuildNum(this);
   }
@@ -8719,7 +8807,7 @@ Caused by: ${ApplicationBuildReporter.formatError(error.cause)}` : "";
   }
 }
 // pkgs/@akanjs/devkit/applicationBuildRunner.ts
-import { mkdir as mkdir8, rm as rm3 } from "fs/promises";
+import { mkdir as mkdir8, rm as rm4 } from "fs/promises";
 import path37 from "path";
 
 // pkgs/@akanjs/devkit/frontendBuild/allRoutesBuilder.ts
@@ -10477,7 +10565,7 @@ class AllRoutesBuilder {
   }
 }
 // pkgs/@akanjs/devkit/frontendBuild/csrArtifactBuilder.ts
-import { mkdir as mkdir5, rm, unlink } from "fs/promises";
+import { mkdir as mkdir5, rm as rm2, unlink } from "fs/promises";
 import path24 from "path";
 
 // pkgs/@akanjs/devkit/frontendBuild/pagesEntrySourceGenerator.ts
@@ -10607,7 +10695,7 @@ class CsrArtifactBuilder {
     const artifact = await this.#loadCsrArtifact();
     const csrBasePaths = [...akanConfig2.basePaths];
     const htmlEntries = csrBasePaths.length > 0 ? csrBasePaths : ["index"];
-    await rm(this.#outputDir, { recursive: true, force: true });
+    await rm2(this.#outputDir, { recursive: true, force: true });
     await mkdir5(path24.join(this.#app.cwdPath, ".akan/generated/csr"), { recursive: true });
     const generatedHtmlFiles = Object.fromEntries(htmlEntries.map((basePath2) => this.#createHtmlFile(basePath2)));
     const result = await Bun.build({
@@ -11341,7 +11429,7 @@ class DevChangePlanner {
 }
 var uniqueResolved = (files) => [...new Set(files.map((file) => path27.resolve(file)))].sort();
 // pkgs/@akanjs/devkit/frontendBuild/devGeneratedIndexSync.ts
-import { mkdir as mkdir6, readdir as readdir2, readFile, rm as rm2, stat as stat3, writeFile } from "fs/promises";
+import { mkdir as mkdir6, readdir as readdir2, readFile, rm as rm3, stat as stat3, writeFile } from "fs/promises";
 import path28 from "path";
 var BARREL_FACETS2 = new Set(["common", "srvkit", "ui", "webkit"]);
 var FACET_SOURCE_FILE_RE = /\.(ts|tsx)$/;
@@ -11424,7 +11512,7 @@ class DevGeneratedIndexSync {
     if (content === null) {
       if (!await exists(indexPath))
         return false;
-      await rm2(indexPath, { force: true });
+      await rm3(indexPath, { force: true });
       return true;
     }
     const current = await readFile(indexPath, "utf8").catch(() => null);
@@ -12571,7 +12659,7 @@ class ApplicationBuildRunner {
     await this.#app.getPageKeys({ refresh: true });
     const { typecheckDir, tsconfigPath } = await this.#writeTypecheckTsconfig({ incremental });
     if (clean)
-      await rm3(path37.join(typecheckDir, "tsconfig.tsbuildinfo"), { force: true });
+      await rm4(path37.join(typecheckDir, "tsconfig.tsbuildinfo"), { force: true });
     await this.#checkProjectInChildProcess(tsconfigPath);
   }
   async#runPhase(id, label, task, summarize, options = {}) {
@@ -12771,7 +12859,7 @@ void run().catch((error) => {
   }
 }
 // pkgs/@akanjs/devkit/applicationReleasePackager.ts
-import { cp, mkdir as mkdir9, rm as rm4 } from "fs/promises";
+import { cp, mkdir as mkdir9, rm as rm5 } from "fs/promises";
 import path38 from "path";
 
 // pkgs/@akanjs/devkit/uploadRelease.ts
@@ -12878,7 +12966,7 @@ class ApplicationReleasePackager {
     const platformVersion = akanConfig2.mobile.version;
     const buildRoot = `${this.#app.workspace.workspaceRoot}/releases/builds/${this.#app.name}`;
     if (await FileSys.dirExists(buildRoot))
-      await rm4(buildRoot, { recursive: true, force: true });
+      await rm5(buildRoot, { recursive: true, force: true });
     await mkdir9(buildRoot, { recursive: true });
     if (rebuild || !await FileSys.dirExists(`${this.#app.dist.cwdPath}/backend`))
       await this.#build();
@@ -12887,7 +12975,7 @@ class ApplicationReleasePackager {
     await mkdir9(buildPath, { recursive: true });
     await cp(`${this.#app.dist.cwdPath}/backend`, `${buildPath}/backend`, { recursive: true });
     await cp(this.#app.dist.cwdPath, buildRoot, { recursive: true });
-    await rm4(`${buildRoot}/frontend/.next`, { recursive: true, force: true });
+    await rm5(`${buildRoot}/frontend/.next`, { recursive: true, force: true });
     const releaseRoot = this.#app.workspace.workspaceRoot;
     const releaseArchivePath = path38.relative(releaseRoot, `${releaseRoot}/releases/builds/${this.#app.name}-release.tar.gz`).split(path38.sep).join("/");
     await this.#app.workspace.spawn("tar", ["-zcf", releaseArchivePath, "-C", buildRoot, "./"], { cwd: releaseRoot });
@@ -12903,7 +12991,7 @@ class ApplicationReleasePackager {
       `${this.#app.workspace.workspaceRoot}/releases/builds/${this.#app.name}-appBuild.zip`,
       "./csr"
     ]);
-    await rm4("./csr", { recursive: true, force: true });
+    await rm5("./csr", { recursive: true, force: true });
   }
   async#writeSourceArchive({ readme }) {
     const sourceRoot = `${this.#app.workspace.workspaceRoot}/releases/sources/${this.#app.name}`;
@@ -12914,7 +13002,7 @@ class ApplicationReleasePackager {
     await Promise.all([".next", "ios", "android", "public/libs"].map(async (path39) => {
       const targetPath = `${sourceRoot}/apps/${this.#app.name}/${path39}`;
       if (await FileSys.dirExists(targetPath))
-        await rm4(targetPath, { recursive: true, force: true });
+        await rm5(targetPath, { recursive: true, force: true });
     }));
     const syncPaths = [".husky", ".gitignore", "package.json"];
     await Promise.all(syncPaths.map((path39) => cp(`${this.#app.workspace.cwdPath}/${path39}`, `${sourceRoot}/${path39}`, { recursive: true })));
@@ -12929,7 +13017,7 @@ class ApplicationReleasePackager {
       const maxRetry = 3;
       for (let i = 0;i < maxRetry; i++) {
         try {
-          await rm4(sourceRoot, { recursive: true, force: true });
+          await rm5(sourceRoot, { recursive: true, force: true });
         } catch {}
       }
     }
@@ -13162,7 +13250,7 @@ class Builder {
   }
 }
 // pkgs/@akanjs/devkit/capacitorApp.ts
-import { cp as cp2, mkdir as mkdir11, readFile as readFile2, rm as rm5, writeFile as writeFile2 } from "fs/promises";
+import { cp as cp2, mkdir as mkdir11, readFile as readFile2, rm as rm6, writeFile as writeFile2 } from "fs/promises";
 import os from "os";
 import path41 from "path";
 import { select as select2 } from "@inquirer/prompts";
@@ -13373,7 +13461,7 @@ var rootCapacitorConfigFilenames = [
 ];
 var rootCapacitorConfigPaths = (appRoot) => rootCapacitorConfigFilenames.map((file) => path41.join(appRoot, file));
 async function clearRootCapacitorConfigs(appRoot) {
-  await Promise.all(rootCapacitorConfigPaths(appRoot).map((file) => rm5(file, { force: true })));
+  await Promise.all(rootCapacitorConfigPaths(appRoot).map((file) => rm6(file, { force: true })));
 }
 async function writeRootCapacitorConfig(appRoot, content) {
   await clearRootCapacitorConfigs(appRoot);
@@ -13394,6 +13482,7 @@ var getLocalIP = () => {
 var isRecord2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var asString = (value) => typeof value === "string" ? value : undefined;
 var firstString = (...values) => values.find((value) => typeof value === "string");
+var resolveIosApnsEnvironment = ({ operation }) => operation === "release" ? "production" : "development";
 var scoreIosDeviceTarget = (target) => {
   const state = target.state?.toLowerCase() ?? "";
   return (state.includes("available") ? 4 : 0) + (state.includes("wired") ? 2 : 0) + (state.includes("paired") ? 1 : 0);
@@ -13699,6 +13788,8 @@ function materializeCapacitorConfig(target, { operation, localServerUrl, localIp
   const experimentalConfig = isRecord2(experimental) ? experimental : undefined;
   const pluginsConfig = isRecord2(plugins) ? plugins : {};
   const keyboardPluginConfig = isRecord2(pluginsConfig.Keyboard) ? pluginsConfig.Keyboard : {};
+  const pushNotificationsPluginConfig = isRecord2(pluginsConfig.PushNotifications) ? pluginsConfig.PushNotifications : {};
+  const usesPushNotifications = target.permissions?.includes("push") ?? false;
   const config = {
     ...capacitorConfig,
     appId,
@@ -13707,6 +13798,12 @@ function materializeCapacitorConfig(target, { operation, localServerUrl, localIp
     plugins: {
       CapacitorCookies: { enabled: true },
       ...pluginsConfig,
+      ...usesPushNotifications || isRecord2(pluginsConfig.PushNotifications) ? {
+        PushNotifications: {
+          ...usesPushNotifications ? { presentationOptions: ["badge", "sound", "alert"] } : {},
+          ...pushNotificationsPluginConfig
+        }
+      } : {},
       Keyboard: {
         resize: "none",
         ...keyboardPluginConfig
@@ -13778,9 +13875,9 @@ class CapacitorApp {
     await mkdir11(this.targetRoot, { recursive: true });
     if (regenerate) {
       if (!platform || platform === "ios")
-        await rm5(path41.join(this.app.cwdPath, this.iosRootPath), { recursive: true, force: true });
+        await rm6(path41.join(this.app.cwdPath, this.iosRootPath), { recursive: true, force: true });
       if (!platform || platform === "android")
-        await rm5(path41.join(this.app.cwdPath, this.androidRootPath), { recursive: true, force: true });
+        await rm6(path41.join(this.app.cwdPath, this.androidRootPath), { recursive: true, force: true });
     }
     const project = this.project;
     await this.project.load();
@@ -13802,7 +13899,7 @@ class CapacitorApp {
     await this.#prepareTargetAssets();
     await this.#prepareExternalFiles("ios");
     await this.#applyIosMetadata();
-    await this.#applyPermissions();
+    await this.#applyPermissions({ operation, env });
     await this.#applyDeepLinks("ios", { operation, env });
     await this.project.commit();
     await this.#generateAssets({ operation, env });
@@ -13945,7 +14042,7 @@ ${error.message}`;
     await this.#prepareTargetAssets();
     await this.#prepareExternalFiles("android");
     await this.#applyAndroidMetadata();
-    await this.#applyPermissions();
+    await this.#applyPermissions({ operation, env });
     await this.#applyDeepLinks("android", { operation, env });
     await this.project.commit();
     await this.#generateAssets({ operation, env });
@@ -14079,7 +14176,7 @@ ${error.message}`;
     const htmlSource = path41.join(this.app.dist.cwdPath, "csr", targetHtmlFilename(this.target));
     if (!await Bun.file(htmlSource).exists())
       throw new Error(`CSR html for mobile target '${this.target.name}' not found: ${htmlSource}`);
-    await rm5(this.targetWebRoot, { recursive: true, force: true });
+    await rm6(this.targetWebRoot, { recursive: true, force: true });
     await mkdir11(this.targetWebRoot, { recursive: true });
     await Bun.write(path41.join(this.targetWebRoot, "index.html"), this.#injectMobileTargetMeta(await Bun.file(htmlSource).text()));
   }
@@ -14160,7 +14257,7 @@ ${error.message}`;
     await this.project.android.setVersionCode(this.target.buildNum);
     await this.project.android.setAppName(this.target.appName);
   }
-  async#applyPermissions() {
+  async#applyPermissions({ operation, env }) {
     for (const permission of this.target.permissions ?? []) {
       if (permission === "camera")
         await this.addCamera();
@@ -14169,7 +14266,7 @@ ${error.message}`;
       else if (permission === "location")
         await this.addLocation();
       else if (permission === "push")
-        await this.addPush();
+        await this.addPush({ operation, env });
     }
   }
   async#applyDeepLinks(platform, { operation, env }) {
@@ -14188,7 +14285,7 @@ ${error.message}`;
         await this.#setUrlSchemesInIos(schemes);
       }
       if (domains.length > 0)
-        await this.#setAssociatedDomainsInIos(domains);
+        await this.#setAssociatedDomainsInIos(domains, { operation, env });
       return;
     }
     if (platform === "android") {
@@ -14282,12 +14379,64 @@ ${error.message}`;
     this.#setPermissionsInAndroid(["ACCESS_COARSE_LOCATION", "ACCESS_FINE_LOCATION"]);
     this.#setFeaturesInAndroid(["android.hardware.location.gps"]);
   }
-  async addPush() {
+  async addPush({ operation, env }) {
     await this.#setPermissionInIos({
       userNotificationsUsageDescription: "$(PRODUCT_NAME) uses notifications to keep you updated."
     });
+    await Promise.all([
+      this.project.ios.updateInfoPlist(this.iosTargetName, "Debug", { UIBackgroundModes: ["remote-notification"] }),
+      this.project.ios.updateInfoPlist(this.iosTargetName, "Release", { UIBackgroundModes: ["remote-notification"] }),
+      this.#writeEntitlementsInIos(this.target.deepLinks?.domains ?? [], { operation, env }),
+      this.#ensurePushAppDelegateInIos()
+    ]);
     this.#setPermissionsInAndroid(["POST_NOTIFICATIONS"]);
   }
+  async#ensurePushAppDelegateInIos() {
+    const appDelegatePath = path41.join(this.app.cwdPath, this.iosProjectPath, "App/AppDelegate.swift");
+    if (!await Bun.file(appDelegatePath).exists())
+      return;
+    const editor = await FileEditor.create(appDelegatePath);
+    let content = editor.getContent();
+    if (!content.includes("import FirebaseCore")) {
+      content = content.replace("import Capacitor", `import Capacitor
+import FirebaseCore`);
+    }
+    if (!content.includes("import FirebaseMessaging")) {
+      content = content.replace("import FirebaseCore", `import FirebaseCore
+import FirebaseMessaging`);
+    }
+    if (!content.includes("FirebaseApp.configure()")) {
+      content = content.replace(/\n(\s*)return true/, `
+$1FirebaseApp.configure()
+
+$1return true`);
+    }
+    if (!content.includes("didRegisterForRemoteNotificationsWithDeviceToken")) {
+      const delegateMethods = `
+    func application(_ application: UIApplication,
+                     didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
+        Messaging.messaging().apnsToken = deviceToken
+        NotificationCenter.default.post(
+            name: .capacitorDidRegisterForRemoteNotifications,
+            object: deviceToken
+        )
+    }
+
+    func application(_ application: UIApplication,
+                     didFailToRegisterForRemoteNotificationsWithError error: Error) {
+        NotificationCenter.default.post(
+            name: .capacitorDidFailToRegisterForRemoteNotifications,
+            object: error
+        )
+    }
+`;
+      content = content.replace(`
+    func applicationWillResignActive`, `${delegateMethods}
+    func applicationWillResignActive`);
+    }
+    if (content !== editor.getContent())
+      await editor.setContent(content).save();
+  }
   async#setPermissionInIos(permissions) {
     const updateNs = Object.fromEntries(Object.entries(permissions).map(([key, value]) => [`NS${capitalize5(key)}`, value]));
     await Promise.all([
@@ -14305,25 +14454,35 @@ ${error.message}`;
       this.project.ios.updateInfoPlist(this.iosTargetName, "Release", { CFBundleURLTypes: urlTypes })
     ]);
   }
-  async#setAssociatedDomainsInIos(domains) {
+  async#setAssociatedDomainsInIos(domains, { operation, env }) {
+    await this.#writeEntitlementsInIos(domains, { operation, env });
+  }
+  async#writeEntitlementsInIos(domains, runConfig) {
     const entitlementsRelPath = "App/App.entitlements";
     const entitlementsPath = path41.join(this.app.cwdPath, this.iosProjectPath, entitlementsRelPath);
     const values = domains.map((domain) => `applinks:${domain}`);
+    const usesPush = this.target.permissions?.includes("push") ?? false;
+    const apsEnvironment = resolveIosApnsEnvironment(runConfig);
     const body = [
       '<?xml version="1.0" encoding="UTF-8"?>',
       '<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">',
       '<plist version="1.0">',
       "<dict>",
-      "  <key>com.apple.developer.associated-domains</key>",
-      "  <array>",
-      ...values.map((value) => `    <string>${value}</string>`),
-      "  </array>",
+      ...usesPush ? ["  <key>aps-environment</key>", `  <string>${apsEnvironment}</string>`] : [],
+      ...values.length > 0 ? [
+        "  <key>com.apple.developer.associated-domains</key>",
+        "  <array>",
+        ...values.map((value) => `    <string>${value}</string>`),
+        "  </array>"
+      ] : [],
       "</dict>",
       "</plist>",
       ""
     ].join(`
 `);
-    await writeFile2(entitlementsPath, body);
+    const currentBody = await Bun.file(entitlementsPath).exists() ? await Bun.file(entitlementsPath).text() : undefined;
+    if (currentBody !== body)
+      await writeFile2(entitlementsPath, body);
     await this.#setCodeSignEntitlementsInIos(entitlementsRelPath);
   }
   async#setCodeSignEntitlementsInIos(entitlementsRelPath) {
@@ -14427,7 +14586,7 @@ ${filter}$1`);
     for (const permission of permissions) {
       if (this.#hasPermissionInAndroid(permission)) {
         this.app.logger.info(`${permission} already exists in android`);
-        return this;
+        continue;
       }
       this.app.logger.info(`Adding ${permission} to android`);
       this.project.android.getAndroidManifest().injectFragment("manifest", `<uses-permission android:name="android.permission.${permission}" />`);
@@ -14443,7 +14602,7 @@ ${filter}$1`);
     return Array.from(usesPermission).map((permission) => permission.getAttribute("android:name"));
   }
   #hasPermissionInAndroid(permission) {
-    return this.#getPermissionsInAndroid().includes(permission);
+    return this.#getPermissionsInAndroid().includes(`android.permission.${permission}`);
   }
 }
 // pkgs/@akanjs/devkit/commandDecorators/targetMeta.ts
@@ -15547,6 +15706,7 @@ class AkanQualityScanner {
     const warnings = [
       ...this.#scanGlobalQuality(sourceFiles),
       ...sourceFiles.flatMap((sourceFile2) => this.#scanSingleFileQuality(sourceFile2)),
+      ...sourceFiles.flatMap((sourceFile2) => this.#scanComponentQuality(sourceFile2)),
       ...sourceFiles.flatMap((sourceFile2) => this.#scanConventionQuality(sourceFile2)),
       ...sourceFiles.flatMap((sourceFile2) => this.#scanLayoutQuality(sourceFile2))
     ];
@@ -15675,6 +15835,28 @@ class AkanQualityScanner {
     }
     return warnings;
   }
+  #scanComponentQuality(sourceFile2) {
+    if (!isComponentDeclarationFile(sourceFile2.file))
+      return [];
+    const exportedNames = getExportedDeclarationNames(sourceFile2.sourceFile);
+    const allowedInternalInterfaces = new Set([...exportedNames].map((name) => `${name}Props`));
+    const warnings = [];
+    for (const declaration of getInternalTypeOrFunctionDeclarations(sourceFile2.sourceFile)) {
+      if (exportedNames.has(declaration.name))
+        continue;
+      if (declaration.kind === "interface" && allowedInternalInterfaces.has(declaration.name))
+        continue;
+      warnings.push({
+        rule: "akan.file.component-internal-declaration",
+        scope: "file",
+        severity: "warning",
+        file: sourceFile2.file,
+        line: declaration.line,
+        message: `Component file should not declare non-exported ${declaration.kind} "${declaration.name}". Only a "<Component>Props" interface may stay internal; move other types or helpers to a separate file in ui/, webkit/, or common/ by purpose.`
+      });
+    }
+    return warnings;
+  }
   #scanConventionQuality(sourceFile2) {
     const suffix = CONVENTION_SUFFIXES.find((candidate) => sourceFile2.file.endsWith(candidate));
     if (!suffix)
@@ -15758,7 +15940,7 @@ function formatQualityLocation(file, line) {
 }
 function getExportedFunctionLikes(sourceFile2) {
   const declarations = [];
-  const pageExempt = isPageRouteFile(sourceFile2.file);
+  const nameExempt = isPageRouteFile(sourceFile2.file) || isUiComponentFile(sourceFile2.file);
   for (const statement of sourceFile2.sourceFile.statements) {
     if (ts11.isFunctionDeclaration(statement) && statement.name && isExported(statement)) {
       declarations.push({
@@ -15767,7 +15949,7 @@ function getExportedFunctionLikes(sourceFile2) {
         file: sourceFile2.file,
         line: getLine(sourceFile2.sourceFile, statement),
         bodyFingerprint: getBodyFingerprint(sourceFile2.sourceFile, statement.body),
-        duplicateNameExempt: pageExempt || isConventionDuplicateNameExempt(sourceFile2.file, false)
+        duplicateNameExempt: nameExempt || isConventionDuplicateNameExempt(sourceFile2.file, false)
       });
     }
     if (ts11.isClassDeclaration(statement) && statement.name && isExported(statement)) {
@@ -15777,7 +15959,7 @@ function getExportedFunctionLikes(sourceFile2) {
         file: sourceFile2.file,
         line: getLine(sourceFile2.sourceFile, statement),
         bodyFingerprint: getBodyFingerprint(sourceFile2.sourceFile, statement),
-        duplicateNameExempt: pageExempt || isConventionDuplicateNameExempt(sourceFile2.file, isEnumClassStatement(sourceFile2.sourceFile, statement))
+        duplicateNameExempt: nameExempt || isConventionDuplicateNameExempt(sourceFile2.file, isEnumClassStatement(sourceFile2.sourceFile, statement))
       });
     }
     if (ts11.isVariableStatement(statement) && isExported(statement)) {
@@ -15790,7 +15972,7 @@ function getExportedFunctionLikes(sourceFile2) {
           file: sourceFile2.file,
           line: getLine(sourceFile2.sourceFile, declaration),
           bodyFingerprint: getBodyFingerprint(sourceFile2.sourceFile, declaration.initializer),
-          duplicateNameExempt: pageExempt || isConventionDuplicateNameExempt(sourceFile2.file, false)
+          duplicateNameExempt: nameExempt || isConventionDuplicateNameExempt(sourceFile2.file, false)
         });
       }
     }
@@ -15801,6 +15983,10 @@ function isPageRouteFile(file) {
   const segments = file.split("/");
   return (segments[0] === "apps" || segments[0] === "libs") && segments[2] === "page";
 }
+function isUiComponentFile(file) {
+  const segments = file.split("/");
+  return (segments[0] === "apps" || segments[0] === "libs") && segments[2] === "ui";
+}
 function isConventionDuplicateNameExempt(file, isEnumClass) {
   if (!isInLibModule(file))
     return false;
@@ -15826,6 +16012,72 @@ function isEnumClassStatement(sourceFile2, statement) {
 function getExportedClassNames(sourceFile2) {
   return sourceFile2.statements.filter((statement) => ts11.isClassDeclaration(statement) && !!statement.name).filter((statement) => isExported(statement)).map((statement) => statement.name.text);
 }
+function isComponentDeclarationFile(file) {
+  if (!file.endsWith(".tsx"))
+    return false;
+  const segments = file.split("/");
+  const [root, , area] = segments;
+  if (root !== "apps" && root !== "libs")
+    return false;
+  if (area === "lib" || area === "ui")
+    return true;
+  return root === "apps" && area === "page";
+}
+function getExportedDeclarationNames(sourceFile2) {
+  const names = new Set;
+  for (const statement of sourceFile2.statements) {
+    if (ts11.isExportDeclaration(statement) && statement.exportClause && ts11.isNamedExports(statement.exportClause)) {
+      for (const element of statement.exportClause.elements) {
+        names.add(element.name.text);
+        if (element.propertyName)
+          names.add(element.propertyName.text);
+      }
+      continue;
+    }
+    if (!isExported(statement))
+      continue;
+    for (const name of getStatementDeclarationNames(statement))
+      names.add(name);
+  }
+  return names;
+}
+function getStatementDeclarationNames(statement) {
+  if (ts11.isFunctionDeclaration(statement) && statement.name)
+    return [statement.name.text];
+  if (ts11.isClassDeclaration(statement) && statement.name)
+    return [statement.name.text];
+  if (ts11.isInterfaceDeclaration(statement))
+    return [statement.name.text];
+  if (ts11.isTypeAliasDeclaration(statement))
+    return [statement.name.text];
+  if (ts11.isEnumDeclaration(statement))
+    return [statement.name.text];
+  if (ts11.isVariableStatement(statement)) {
+    return statement.declarationList.declarations.filter((declaration) => ts11.isIdentifier(declaration.name)).map((declaration) => declaration.name.text);
+  }
+  return [];
+}
+function getInternalTypeOrFunctionDeclarations(sourceFile2) {
+  const declarations = [];
+  for (const statement of sourceFile2.statements) {
+    if (isExported(statement))
+      continue;
+    if (ts11.isInterfaceDeclaration(statement)) {
+      declarations.push({ name: statement.name.text, kind: "interface", line: getLine(sourceFile2, statement) });
+    } else if (ts11.isTypeAliasDeclaration(statement)) {
+      declarations.push({ name: statement.name.text, kind: "type", line: getLine(sourceFile2, statement) });
+    } else if (ts11.isFunctionDeclaration(statement) && statement.name) {
+      declarations.push({ name: statement.name.text, kind: "function", line: getLine(sourceFile2, statement) });
+    } else if (ts11.isVariableStatement(statement)) {
+      for (const declaration of statement.declarationList.declarations) {
+        if (!ts11.isIdentifier(declaration.name) || !isFunctionLikeInitializer(declaration.initializer))
+          continue;
+        declarations.push({ name: declaration.name.text, kind: "function", line: getLine(sourceFile2, declaration) });
+      }
+    }
+  }
+  return declarations;
+}
 function getPlaceholderExportWarnings(sourceFile2) {
   if (!sourceFile2.file.endsWith("/index.ts") && !sourceFile2.file.endsWith("/index.tsx"))
     return [];

package/index.js

@@ -664,6 +664,7 @@ import {
 import { readFileSync as readFileSync3 } from "fs";
 import { copyFile, mkdir as mkdir2, readdir as readDirEntries, stat as stat2 } from "fs/promises";
 import path7 from "path";
+import { pathToFileURL } from "url";
 import {
   capitalize,
   isRouteSourceFile,
@@ -1105,6 +1106,63 @@ var decreaseBuildNum = async (app) => {
   const akanConfigContent = akanConfig.replace(`buildNum: ${appConfig.mobile.buildNum}`, `buildNum: ${appConfig.mobile.buildNum - 1}`);
   fs.writeFileSync(akanConfigPath, akanConfigContent);
 };
+// pkgs/@akanjs/devkit/firebaseMessagingSw.ts
+var FIREBASE_WEB_SDK_VERSION = "12.13.0";
+function normalizeFirebaseClientConfig(config) {
+  if (!config || typeof config !== "object")
+    return null;
+  const value = config;
+  if (typeof value.apiKey !== "string" || typeof value.projectId !== "string" || typeof value.messagingSenderId !== "string" || typeof value.appId !== "string") {
+    return null;
+  }
+  return {
+    apiKey: value.apiKey,
+    ...typeof value.authDomain === "string" ? { authDomain: value.authDomain } : {},
+    projectId: value.projectId,
+    ...typeof value.storageBucket === "string" ? { storageBucket: value.storageBucket } : {},
+    messagingSenderId: value.messagingSenderId,
+    appId: value.appId
+  };
+}
+function createFirebaseMessagingServiceWorker(config) {
+  const configJson = JSON.stringify(config);
+  return `/* Generated by Akan.js. Do not edit. */
+const firebaseConfig = ${configJson};
+
+if (firebaseConfig) {
+  importScripts("https://www.gstatic.com/firebasejs/${FIREBASE_WEB_SDK_VERSION}/firebase-app-compat.js");
+  importScripts("https://www.gstatic.com/firebasejs/${FIREBASE_WEB_SDK_VERSION}/firebase-messaging-compat.js");
+
+  firebase.initializeApp(firebaseConfig);
+  const messaging = firebase.messaging();
+
+  const notificationUrl = (payload) =>
+    payload?.data?.url || payload?.fcmOptions?.link || payload?.notification?.click_action;
+
+  messaging.onBackgroundMessage((payload) => {
+    const title = payload?.notification?.title || "";
+    const options = {
+      body: payload?.notification?.body,
+      icon: payload?.notification?.icon,
+      image: payload?.notification?.image,
+      data: {
+        url: notificationUrl(payload),
+        FCM_MSG: payload,
+      },
+    };
+    self.registration.showNotification(title, options);
+  });
+}
+
+self.addEventListener("notificationclick", (event) => {
+  const url = event.notification?.data?.url || event.notification?.data?.FCM_MSG?.data?.url;
+  event.notification?.close();
+  if (!url) return;
+  event.waitUntil(clients.openWindow(url));
+});
+`;
+}
+
 // pkgs/@akanjs/devkit/getDirname.ts
 import path2 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
@@ -1390,6 +1448,7 @@ ${errorText}, ${warningText} found`];
 
 // pkgs/@akanjs/devkit/scanInfo.ts
 import path5 from "path";
+import { rm } from "fs/promises";
 
 // pkgs/@akanjs/devkit/dependencyScanner.ts
 import { builtinModules } from "module";
@@ -1711,6 +1770,7 @@ var appRootAllowedFiles = new Set([
   "tsconfig.json",
   "tsconfig.tsbuildinfo"
 ]);
+var generatedRootCapacitorConfigFiles = ["capacitor.config.js", "capacitor.config.json"];
 var appRootAllowedDirs = new Set([
   ".akan",
   "android",
@@ -1754,11 +1814,17 @@ var rootSignalTestFilePattern = /^[A-Za-z][A-Za-z0-9_-]*\.signal\.(test|spec)\.(
 var isAllowedTestFile = (filename) => testFilePattern.test(filename);
 var isAllowedLibRootFile = (filename) => libRootAllowedFiles.has(filename) || rootSignalTestFilePattern.test(filename);
 var getScanPath = (exec, relativePath) => path5.posix.join(`${exec.type}s`, exec.name, relativePath.split(path5.sep).join("/"));
+async function clearGeneratedRootCapacitorConfigs(exec) {
+  if (exec.type !== "app")
+    return;
+  await Promise.all(generatedRootCapacitorConfigFiles.map((filename) => rm(exec.getPath(filename), { force: true })));
+}
 var getModuleNameFromPath = (kind, modulePath) => {
   const dirname = path5.basename(modulePath);
   return kind === "service" ? dirname.replace(/^_+/, "") : dirname;
 };
 async function assertScanConvention(exec, libRoot) {
+  await clearGeneratedRootCapacitorConfigs(exec);
   const violations = [];
   const addViolation = (relativePath, reason) => {
     violations.push(`${getScanPath(exec, relativePath)}: ${reason}`);
@@ -3687,8 +3753,30 @@ class AppExecutor extends SysExecutor {
     });
     if (write)
       await this.syncAssets(scanInfo.getScanResult().libDeps);
+    if (write)
+      await this.#syncFirebaseMessagingSw();
     return scanInfo;
   }
+  async#syncFirebaseMessagingSw() {
+    const swRelPath = "public/firebase-messaging-sw.js";
+    if (await FileSys.fileExists(this.getPath(swRelPath)))
+      return;
+    const envClientPath = path7.join(this.cwdPath, "env", "env.client.ts");
+    if (!await FileSys.fileExists(envClientPath))
+      return;
+    let firebaseConfig = null;
+    try {
+      const envUrl = pathToFileURL(envClientPath);
+      envUrl.searchParams.set("t", String(Date.now()));
+      const envModule = await import(envUrl.href);
+      firebaseConfig = normalizeFirebaseClientConfig(envModule.env?.firebase);
+    } catch {
+      return;
+    }
+    if (!firebaseConfig)
+      return;
+    await this.writeFile(swRelPath, createFirebaseMessagingServiceWorker(firebaseConfig), { overwrite: false });
+  }
   async increaseBuildNum() {
     await increaseBuildNum(this);
   }
@@ -8717,7 +8805,7 @@ Caused by: ${ApplicationBuildReporter.formatError(error.cause)}` : "";
   }
 }
 // pkgs/@akanjs/devkit/applicationBuildRunner.ts
-import { mkdir as mkdir8, rm as rm3 } from "fs/promises";
+import { mkdir as mkdir8, rm as rm4 } from "fs/promises";
 import path37 from "path";
 
 // pkgs/@akanjs/devkit/frontendBuild/allRoutesBuilder.ts
@@ -10475,7 +10563,7 @@ class AllRoutesBuilder {
   }
 }
 // pkgs/@akanjs/devkit/frontendBuild/csrArtifactBuilder.ts
-import { mkdir as mkdir5, rm, unlink } from "fs/promises";
+import { mkdir as mkdir5, rm as rm2, unlink } from "fs/promises";
 import path24 from "path";
 
 // pkgs/@akanjs/devkit/frontendBuild/pagesEntrySourceGenerator.ts
@@ -10605,7 +10693,7 @@ class CsrArtifactBuilder {
     const artifact = await this.#loadCsrArtifact();
     const csrBasePaths = [...akanConfig2.basePaths];
     const htmlEntries = csrBasePaths.length > 0 ? csrBasePaths : ["index"];
-    await rm(this.#outputDir, { recursive: true, force: true });
+    await rm2(this.#outputDir, { recursive: true, force: true });
     await mkdir5(path24.join(this.#app.cwdPath, ".akan/generated/csr"), { recursive: true });
     const generatedHtmlFiles = Object.fromEntries(htmlEntries.map((basePath2) => this.#createHtmlFile(basePath2)));
     const result = await Bun.build({
@@ -11339,7 +11427,7 @@ class DevChangePlanner {
 }
 var uniqueResolved = (files) => [...new Set(files.map((file) => path27.resolve(file)))].sort();
 // pkgs/@akanjs/devkit/frontendBuild/devGeneratedIndexSync.ts
-import { mkdir as mkdir6, readdir as readdir2, readFile, rm as rm2, stat as stat3, writeFile } from "fs/promises";
+import { mkdir as mkdir6, readdir as readdir2, readFile, rm as rm3, stat as stat3, writeFile } from "fs/promises";
 import path28 from "path";
 var BARREL_FACETS2 = new Set(["common", "srvkit", "ui", "webkit"]);
 var FACET_SOURCE_FILE_RE = /\.(ts|tsx)$/;
@@ -11422,7 +11510,7 @@ class DevGeneratedIndexSync {
     if (content === null) {
       if (!await exists(indexPath))
         return false;
-      await rm2(indexPath, { force: true });
+      await rm3(indexPath, { force: true });
       return true;
     }
     const current = await readFile(indexPath, "utf8").catch(() => null);
@@ -12569,7 +12657,7 @@ class ApplicationBuildRunner {
     await this.#app.getPageKeys({ refresh: true });
     const { typecheckDir, tsconfigPath } = await this.#writeTypecheckTsconfig({ incremental });
     if (clean)
-      await rm3(path37.join(typecheckDir, "tsconfig.tsbuildinfo"), { force: true });
+      await rm4(path37.join(typecheckDir, "tsconfig.tsbuildinfo"), { force: true });
     await this.#checkProjectInChildProcess(tsconfigPath);
   }
   async#runPhase(id, label, task, summarize, options = {}) {
@@ -12769,7 +12857,7 @@ void run().catch((error) => {
   }
 }
 // pkgs/@akanjs/devkit/applicationReleasePackager.ts
-import { cp, mkdir as mkdir9, rm as rm4 } from "fs/promises";
+import { cp, mkdir as mkdir9, rm as rm5 } from "fs/promises";
 import path38 from "path";
 
 // pkgs/@akanjs/devkit/uploadRelease.ts
@@ -12876,7 +12964,7 @@ class ApplicationReleasePackager {
     const platformVersion = akanConfig2.mobile.version;
     const buildRoot = `${this.#app.workspace.workspaceRoot}/releases/builds/${this.#app.name}`;
     if (await FileSys.dirExists(buildRoot))
-      await rm4(buildRoot, { recursive: true, force: true });
+      await rm5(buildRoot, { recursive: true, force: true });
     await mkdir9(buildRoot, { recursive: true });
     if (rebuild || !await FileSys.dirExists(`${this.#app.dist.cwdPath}/backend`))
       await this.#build();
@@ -12885,7 +12973,7 @@ class ApplicationReleasePackager {
     await mkdir9(buildPath, { recursive: true });
     await cp(`${this.#app.dist.cwdPath}/backend`, `${buildPath}/backend`, { recursive: true });
     await cp(this.#app.dist.cwdPath, buildRoot, { recursive: true });
-    await rm4(`${buildRoot}/frontend/.next`, { recursive: true, force: true });
+    await rm5(`${buildRoot}/frontend/.next`, { recursive: true, force: true });
     const releaseRoot = this.#app.workspace.workspaceRoot;
     const releaseArchivePath = path38.relative(releaseRoot, `${releaseRoot}/releases/builds/${this.#app.name}-release.tar.gz`).split(path38.sep).join("/");
     await this.#app.workspace.spawn("tar", ["-zcf", releaseArchivePath, "-C", buildRoot, "./"], { cwd: releaseRoot });
@@ -12901,7 +12989,7 @@ class ApplicationReleasePackager {
       `${this.#app.workspace.workspaceRoot}/releases/builds/${this.#app.name}-appBuild.zip`,
       "./csr"
     ]);
-    await rm4("./csr", { recursive: true, force: true });
+    await rm5("./csr", { recursive: true, force: true });
   }
   async#writeSourceArchive({ readme }) {
     const sourceRoot = `${this.#app.workspace.workspaceRoot}/releases/sources/${this.#app.name}`;
@@ -12912,7 +13000,7 @@ class ApplicationReleasePackager {
     await Promise.all([".next", "ios", "android", "public/libs"].map(async (path39) => {
       const targetPath = `${sourceRoot}/apps/${this.#app.name}/${path39}`;
       if (await FileSys.dirExists(targetPath))
-        await rm4(targetPath, { recursive: true, force: true });
+        await rm5(targetPath, { recursive: true, force: true });
     }));
     const syncPaths = [".husky", ".gitignore", "package.json"];
     await Promise.all(syncPaths.map((path39) => cp(`${this.#app.workspace.cwdPath}/${path39}`, `${sourceRoot}/${path39}`, { recursive: true })));
@@ -12927,7 +13015,7 @@ class ApplicationReleasePackager {
       const maxRetry = 3;
       for (let i = 0;i < maxRetry; i++) {
         try {
-          await rm4(sourceRoot, { recursive: true, force: true });
+          await rm5(sourceRoot, { recursive: true, force: true });
         } catch {}
       }
     }
@@ -13160,7 +13248,7 @@ class Builder {
   }
 }
 // pkgs/@akanjs/devkit/capacitorApp.ts
-import { cp as cp2, mkdir as mkdir11, readFile as readFile2, rm as rm5, writeFile as writeFile2 } from "fs/promises";
+import { cp as cp2, mkdir as mkdir11, readFile as readFile2, rm as rm6, writeFile as writeFile2 } from "fs/promises";
 import os from "os";
 import path41 from "path";
 import { select as select2 } from "@inquirer/prompts";
@@ -13371,7 +13459,7 @@ var rootCapacitorConfigFilenames = [
 ];
 var rootCapacitorConfigPaths = (appRoot) => rootCapacitorConfigFilenames.map((file) => path41.join(appRoot, file));
 async function clearRootCapacitorConfigs(appRoot) {
-  await Promise.all(rootCapacitorConfigPaths(appRoot).map((file) => rm5(file, { force: true })));
+  await Promise.all(rootCapacitorConfigPaths(appRoot).map((file) => rm6(file, { force: true })));
 }
 async function writeRootCapacitorConfig(appRoot, content) {
   await clearRootCapacitorConfigs(appRoot);
@@ -13392,6 +13480,7 @@ var getLocalIP = () => {
 var isRecord2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var asString = (value) => typeof value === "string" ? value : undefined;
 var firstString = (...values) => values.find((value) => typeof value === "string");
+var resolveIosApnsEnvironment = ({ operation }) => operation === "release" ? "production" : "development";
 var scoreIosDeviceTarget = (target) => {
   const state = target.state?.toLowerCase() ?? "";
   return (state.includes("available") ? 4 : 0) + (state.includes("wired") ? 2 : 0) + (state.includes("paired") ? 1 : 0);
@@ -13697,6 +13786,8 @@ function materializeCapacitorConfig(target, { operation, localServerUrl, localIp
   const experimentalConfig = isRecord2(experimental) ? experimental : undefined;
   const pluginsConfig = isRecord2(plugins) ? plugins : {};
   const keyboardPluginConfig = isRecord2(pluginsConfig.Keyboard) ? pluginsConfig.Keyboard : {};
+  const pushNotificationsPluginConfig = isRecord2(pluginsConfig.PushNotifications) ? pluginsConfig.PushNotifications : {};
+  const usesPushNotifications = target.permissions?.includes("push") ?? false;
   const config = {
     ...capacitorConfig,
     appId,
@@ -13705,6 +13796,12 @@ function materializeCapacitorConfig(target, { operation, localServerUrl, localIp
     plugins: {
       CapacitorCookies: { enabled: true },
       ...pluginsConfig,
+      ...usesPushNotifications || isRecord2(pluginsConfig.PushNotifications) ? {
+        PushNotifications: {
+          ...usesPushNotifications ? { presentationOptions: ["badge", "sound", "alert"] } : {},
+          ...pushNotificationsPluginConfig
+        }
+      } : {},
       Keyboard: {
         resize: "none",
         ...keyboardPluginConfig
@@ -13776,9 +13873,9 @@ class CapacitorApp {
     await mkdir11(this.targetRoot, { recursive: true });
     if (regenerate) {
       if (!platform || platform === "ios")
-        await rm5(path41.join(this.app.cwdPath, this.iosRootPath), { recursive: true, force: true });
+        await rm6(path41.join(this.app.cwdPath, this.iosRootPath), { recursive: true, force: true });
       if (!platform || platform === "android")
-        await rm5(path41.join(this.app.cwdPath, this.androidRootPath), { recursive: true, force: true });
+        await rm6(path41.join(this.app.cwdPath, this.androidRootPath), { recursive: true, force: true });
     }
     const project = this.project;
     await this.project.load();
@@ -13800,7 +13897,7 @@ class CapacitorApp {
     await this.#prepareTargetAssets();
     await this.#prepareExternalFiles("ios");
     await this.#applyIosMetadata();
-    await this.#applyPermissions();
+    await this.#applyPermissions({ operation, env });
     await this.#applyDeepLinks("ios", { operation, env });
     await this.project.commit();
     await this.#generateAssets({ operation, env });
@@ -13943,7 +14040,7 @@ ${error.message}`;
     await this.#prepareTargetAssets();
     await this.#prepareExternalFiles("android");
     await this.#applyAndroidMetadata();
-    await this.#applyPermissions();
+    await this.#applyPermissions({ operation, env });
     await this.#applyDeepLinks("android", { operation, env });
     await this.project.commit();
     await this.#generateAssets({ operation, env });
@@ -14077,7 +14174,7 @@ ${error.message}`;
     const htmlSource = path41.join(this.app.dist.cwdPath, "csr", targetHtmlFilename(this.target));
     if (!await Bun.file(htmlSource).exists())
       throw new Error(`CSR html for mobile target '${this.target.name}' not found: ${htmlSource}`);
-    await rm5(this.targetWebRoot, { recursive: true, force: true });
+    await rm6(this.targetWebRoot, { recursive: true, force: true });
     await mkdir11(this.targetWebRoot, { recursive: true });
     await Bun.write(path41.join(this.targetWebRoot, "index.html"), this.#injectMobileTargetMeta(await Bun.file(htmlSource).text()));
   }
@@ -14158,7 +14255,7 @@ ${error.message}`;
     await this.project.android.setVersionCode(this.target.buildNum);
     await this.project.android.setAppName(this.target.appName);
   }
-  async#applyPermissions() {
+  async#applyPermissions({ operation, env }) {
     for (const permission of this.target.permissions ?? []) {
       if (permission === "camera")
         await this.addCamera();
@@ -14167,7 +14264,7 @@ ${error.message}`;
       else if (permission === "location")
         await this.addLocation();
       else if (permission === "push")
-        await this.addPush();
+        await this.addPush({ operation, env });
     }
   }
   async#applyDeepLinks(platform, { operation, env }) {
@@ -14186,7 +14283,7 @@ ${error.message}`;
         await this.#setUrlSchemesInIos(schemes);
       }
       if (domains.length > 0)
-        await this.#setAssociatedDomainsInIos(domains);
+        await this.#setAssociatedDomainsInIos(domains, { operation, env });
       return;
     }
     if (platform === "android") {
@@ -14280,12 +14377,64 @@ ${error.message}`;
     this.#setPermissionsInAndroid(["ACCESS_COARSE_LOCATION", "ACCESS_FINE_LOCATION"]);
     this.#setFeaturesInAndroid(["android.hardware.location.gps"]);
   }
-  async addPush() {
+  async addPush({ operation, env }) {
     await this.#setPermissionInIos({
       userNotificationsUsageDescription: "$(PRODUCT_NAME) uses notifications to keep you updated."
     });
+    await Promise.all([
+      this.project.ios.updateInfoPlist(this.iosTargetName, "Debug", { UIBackgroundModes: ["remote-notification"] }),
+      this.project.ios.updateInfoPlist(this.iosTargetName, "Release", { UIBackgroundModes: ["remote-notification"] }),
+      this.#writeEntitlementsInIos(this.target.deepLinks?.domains ?? [], { operation, env }),
+      this.#ensurePushAppDelegateInIos()
+    ]);
     this.#setPermissionsInAndroid(["POST_NOTIFICATIONS"]);
   }
+  async#ensurePushAppDelegateInIos() {
+    const appDelegatePath = path41.join(this.app.cwdPath, this.iosProjectPath, "App/AppDelegate.swift");
+    if (!await Bun.file(appDelegatePath).exists())
+      return;
+    const editor = await FileEditor.create(appDelegatePath);
+    let content = editor.getContent();
+    if (!content.includes("import FirebaseCore")) {
+      content = content.replace("import Capacitor", `import Capacitor
+import FirebaseCore`);
+    }
+    if (!content.includes("import FirebaseMessaging")) {
+      content = content.replace("import FirebaseCore", `import FirebaseCore
+import FirebaseMessaging`);
+    }
+    if (!content.includes("FirebaseApp.configure()")) {
+      content = content.replace(/\n(\s*)return true/, `
+$1FirebaseApp.configure()
+
+$1return true`);
+    }
+    if (!content.includes("didRegisterForRemoteNotificationsWithDeviceToken")) {
+      const delegateMethods = `
+    func application(_ application: UIApplication,
+                     didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
+        Messaging.messaging().apnsToken = deviceToken
+        NotificationCenter.default.post(
+            name: .capacitorDidRegisterForRemoteNotifications,
+            object: deviceToken
+        )
+    }
+
+    func application(_ application: UIApplication,
+                     didFailToRegisterForRemoteNotificationsWithError error: Error) {
+        NotificationCenter.default.post(
+            name: .capacitorDidFailToRegisterForRemoteNotifications,
+            object: error
+        )
+    }
+`;
+      content = content.replace(`
+    func applicationWillResignActive`, `${delegateMethods}
+    func applicationWillResignActive`);
+    }
+    if (content !== editor.getContent())
+      await editor.setContent(content).save();
+  }
   async#setPermissionInIos(permissions) {
     const updateNs = Object.fromEntries(Object.entries(permissions).map(([key, value]) => [`NS${capitalize5(key)}`, value]));
     await Promise.all([
@@ -14303,25 +14452,35 @@ ${error.message}`;
       this.project.ios.updateInfoPlist(this.iosTargetName, "Release", { CFBundleURLTypes: urlTypes })
     ]);
   }
-  async#setAssociatedDomainsInIos(domains) {
+  async#setAssociatedDomainsInIos(domains, { operation, env }) {
+    await this.#writeEntitlementsInIos(domains, { operation, env });
+  }
+  async#writeEntitlementsInIos(domains, runConfig) {
     const entitlementsRelPath = "App/App.entitlements";
     const entitlementsPath = path41.join(this.app.cwdPath, this.iosProjectPath, entitlementsRelPath);
     const values = domains.map((domain) => `applinks:${domain}`);
+    const usesPush = this.target.permissions?.includes("push") ?? false;
+    const apsEnvironment = resolveIosApnsEnvironment(runConfig);
     const body = [
       '<?xml version="1.0" encoding="UTF-8"?>',
       '<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">',
       '<plist version="1.0">',
       "<dict>",
-      "  <key>com.apple.developer.associated-domains</key>",
-      "  <array>",
-      ...values.map((value) => `    <string>${value}</string>`),
-      "  </array>",
+      ...usesPush ? ["  <key>aps-environment</key>", `  <string>${apsEnvironment}</string>`] : [],
+      ...values.length > 0 ? [
+        "  <key>com.apple.developer.associated-domains</key>",
+        "  <array>",
+        ...values.map((value) => `    <string>${value}</string>`),
+        "  </array>"
+      ] : [],
       "</dict>",
       "</plist>",
       ""
     ].join(`
 `);
-    await writeFile2(entitlementsPath, body);
+    const currentBody = await Bun.file(entitlementsPath).exists() ? await Bun.file(entitlementsPath).text() : undefined;
+    if (currentBody !== body)
+      await writeFile2(entitlementsPath, body);
     await this.#setCodeSignEntitlementsInIos(entitlementsRelPath);
   }
   async#setCodeSignEntitlementsInIos(entitlementsRelPath) {
@@ -14425,7 +14584,7 @@ ${filter}$1`);
     for (const permission of permissions) {
       if (this.#hasPermissionInAndroid(permission)) {
         this.app.logger.info(`${permission} already exists in android`);
-        return this;
+        continue;
       }
       this.app.logger.info(`Adding ${permission} to android`);
       this.project.android.getAndroidManifest().injectFragment("manifest", `<uses-permission android:name="android.permission.${permission}" />`);
@@ -14441,7 +14600,7 @@ ${filter}$1`);
     return Array.from(usesPermission).map((permission) => permission.getAttribute("android:name"));
   }
   #hasPermissionInAndroid(permission) {
-    return this.#getPermissionsInAndroid().includes(permission);
+    return this.#getPermissionsInAndroid().includes(`android.permission.${permission}`);
   }
 }
 // pkgs/@akanjs/devkit/commandDecorators/targetMeta.ts
@@ -15545,6 +15704,7 @@ class AkanQualityScanner {
     const warnings = [
       ...this.#scanGlobalQuality(sourceFiles),
       ...sourceFiles.flatMap((sourceFile2) => this.#scanSingleFileQuality(sourceFile2)),
+      ...sourceFiles.flatMap((sourceFile2) => this.#scanComponentQuality(sourceFile2)),
       ...sourceFiles.flatMap((sourceFile2) => this.#scanConventionQuality(sourceFile2)),
       ...sourceFiles.flatMap((sourceFile2) => this.#scanLayoutQuality(sourceFile2))
     ];
@@ -15673,6 +15833,28 @@ class AkanQualityScanner {
     }
     return warnings;
   }
+  #scanComponentQuality(sourceFile2) {
+    if (!isComponentDeclarationFile(sourceFile2.file))
+      return [];
+    const exportedNames = getExportedDeclarationNames(sourceFile2.sourceFile);
+    const allowedInternalInterfaces = new Set([...exportedNames].map((name) => `${name}Props`));
+    const warnings = [];
+    for (const declaration of getInternalTypeOrFunctionDeclarations(sourceFile2.sourceFile)) {
+      if (exportedNames.has(declaration.name))
+        continue;
+      if (declaration.kind === "interface" && allowedInternalInterfaces.has(declaration.name))
+        continue;
+      warnings.push({
+        rule: "akan.file.component-internal-declaration",
+        scope: "file",
+        severity: "warning",
+        file: sourceFile2.file,
+        line: declaration.line,
+        message: `Component file should not declare non-exported ${declaration.kind} "${declaration.name}". Only a "<Component>Props" interface may stay internal; move other types or helpers to a separate file in ui/, webkit/, or common/ by purpose.`
+      });
+    }
+    return warnings;
+  }
   #scanConventionQuality(sourceFile2) {
     const suffix = CONVENTION_SUFFIXES.find((candidate) => sourceFile2.file.endsWith(candidate));
     if (!suffix)
@@ -15756,7 +15938,7 @@ function formatQualityLocation(file, line) {
 }
 function getExportedFunctionLikes(sourceFile2) {
   const declarations = [];
-  const pageExempt = isPageRouteFile(sourceFile2.file);
+  const nameExempt = isPageRouteFile(sourceFile2.file) || isUiComponentFile(sourceFile2.file);
   for (const statement of sourceFile2.sourceFile.statements) {
     if (ts11.isFunctionDeclaration(statement) && statement.name && isExported(statement)) {
       declarations.push({
@@ -15765,7 +15947,7 @@ function getExportedFunctionLikes(sourceFile2) {
         file: sourceFile2.file,
         line: getLine(sourceFile2.sourceFile, statement),
         bodyFingerprint: getBodyFingerprint(sourceFile2.sourceFile, statement.body),
-        duplicateNameExempt: pageExempt || isConventionDuplicateNameExempt(sourceFile2.file, false)
+        duplicateNameExempt: nameExempt || isConventionDuplicateNameExempt(sourceFile2.file, false)
       });
     }
     if (ts11.isClassDeclaration(statement) && statement.name && isExported(statement)) {
@@ -15775,7 +15957,7 @@ function getExportedFunctionLikes(sourceFile2) {
         file: sourceFile2.file,
         line: getLine(sourceFile2.sourceFile, statement),
         bodyFingerprint: getBodyFingerprint(sourceFile2.sourceFile, statement),
-        duplicateNameExempt: pageExempt || isConventionDuplicateNameExempt(sourceFile2.file, isEnumClassStatement(sourceFile2.sourceFile, statement))
+        duplicateNameExempt: nameExempt || isConventionDuplicateNameExempt(sourceFile2.file, isEnumClassStatement(sourceFile2.sourceFile, statement))
       });
     }
     if (ts11.isVariableStatement(statement) && isExported(statement)) {
@@ -15788,7 +15970,7 @@ function getExportedFunctionLikes(sourceFile2) {
           file: sourceFile2.file,
           line: getLine(sourceFile2.sourceFile, declaration),
           bodyFingerprint: getBodyFingerprint(sourceFile2.sourceFile, declaration.initializer),
-          duplicateNameExempt: pageExempt || isConventionDuplicateNameExempt(sourceFile2.file, false)
+          duplicateNameExempt: nameExempt || isConventionDuplicateNameExempt(sourceFile2.file, false)
         });
       }
     }
@@ -15799,6 +15981,10 @@ function isPageRouteFile(file) {
   const segments = file.split("/");
   return (segments[0] === "apps" || segments[0] === "libs") && segments[2] === "page";
 }
+function isUiComponentFile(file) {
+  const segments = file.split("/");
+  return (segments[0] === "apps" || segments[0] === "libs") && segments[2] === "ui";
+}
 function isConventionDuplicateNameExempt(file, isEnumClass) {
   if (!isInLibModule(file))
     return false;
@@ -15824,6 +16010,72 @@ function isEnumClassStatement(sourceFile2, statement) {
 function getExportedClassNames(sourceFile2) {
   return sourceFile2.statements.filter((statement) => ts11.isClassDeclaration(statement) && !!statement.name).filter((statement) => isExported(statement)).map((statement) => statement.name.text);
 }
+function isComponentDeclarationFile(file) {
+  if (!file.endsWith(".tsx"))
+    return false;
+  const segments = file.split("/");
+  const [root, , area] = segments;
+  if (root !== "apps" && root !== "libs")
+    return false;
+  if (area === "lib" || area === "ui")
+    return true;
+  return root === "apps" && area === "page";
+}
+function getExportedDeclarationNames(sourceFile2) {
+  const names = new Set;
+  for (const statement of sourceFile2.statements) {
+    if (ts11.isExportDeclaration(statement) && statement.exportClause && ts11.isNamedExports(statement.exportClause)) {
+      for (const element of statement.exportClause.elements) {
+        names.add(element.name.text);
+        if (element.propertyName)
+          names.add(element.propertyName.text);
+      }
+      continue;
+    }
+    if (!isExported(statement))
+      continue;
+    for (const name of getStatementDeclarationNames(statement))
+      names.add(name);
+  }
+  return names;
+}
+function getStatementDeclarationNames(statement) {
+  if (ts11.isFunctionDeclaration(statement) && statement.name)
+    return [statement.name.text];
+  if (ts11.isClassDeclaration(statement) && statement.name)
+    return [statement.name.text];
+  if (ts11.isInterfaceDeclaration(statement))
+    return [statement.name.text];
+  if (ts11.isTypeAliasDeclaration(statement))
+    return [statement.name.text];
+  if (ts11.isEnumDeclaration(statement))
+    return [statement.name.text];
+  if (ts11.isVariableStatement(statement)) {
+    return statement.declarationList.declarations.filter((declaration) => ts11.isIdentifier(declaration.name)).map((declaration) => declaration.name.text);
+  }
+  return [];
+}
+function getInternalTypeOrFunctionDeclarations(sourceFile2) {
+  const declarations = [];
+  for (const statement of sourceFile2.statements) {
+    if (isExported(statement))
+      continue;
+    if (ts11.isInterfaceDeclaration(statement)) {
+      declarations.push({ name: statement.name.text, kind: "interface", line: getLine(sourceFile2, statement) });
+    } else if (ts11.isTypeAliasDeclaration(statement)) {
+      declarations.push({ name: statement.name.text, kind: "type", line: getLine(sourceFile2, statement) });
+    } else if (ts11.isFunctionDeclaration(statement) && statement.name) {
+      declarations.push({ name: statement.name.text, kind: "function", line: getLine(sourceFile2, statement) });
+    } else if (ts11.isVariableStatement(statement)) {
+      for (const declaration of statement.declarationList.declarations) {
+        if (!ts11.isIdentifier(declaration.name) || !isFunctionLikeInitializer(declaration.initializer))
+          continue;
+        declarations.push({ name: declaration.name.text, kind: "function", line: getLine(sourceFile2, declaration) });
+      }
+    }
+  }
+  return declarations;
+}
 function getPlaceholderExportWarnings(sourceFile2) {
   if (!sourceFile2.file.endsWith("/index.ts") && !sourceFile2.file.endsWith("/index.tsx"))
     return [];
@@ -21194,7 +21446,7 @@ class LibraryCommand extends command("library", [LibraryScript], ({ public: targ
 }
 
 // pkgs/@akanjs/cli/localRegistry/localRegistry.runner.ts
-import { mkdir as mkdir13, rm as rm6 } from "fs/promises";
+import { mkdir as mkdir13, rm as rm7 } from "fs/promises";
 import path47 from "path";
 import { Logger as Logger19 } from "akanjs/common";
 var defaultLocalRegistryUrl = "http://127.0.0.1:4873";
@@ -21237,13 +21489,13 @@ class LocalRegistryRunner extends runner("localRegistry") {
     try {
       await workspace.spawn("docker", ["rm", "-f", containerName], { stdio: "inherit" });
     } catch {}
-    await rm6(path47.join(workspace.workspaceRoot, ".akan/verdaccio"), { recursive: true, force: true });
+    await rm7(path47.join(workspace.workspaceRoot, ".akan/verdaccio"), { recursive: true, force: true });
     Logger19.info("Local registry storage has been reset");
   }
   async smoke(workspace, { registryUrl } = {}) {
     const registry = this.getRegistryUrl(registryUrl);
     const smokeRoot = path47.join(workspace.workspaceRoot, ".akan/e2e");
-    await rm6(path47.join(smokeRoot, smokeRepoName), { recursive: true, force: true });
+    await rm7(path47.join(smokeRoot, smokeRepoName), { recursive: true, force: true });
     await workspace.spawn(process.execPath, [
       "dist/pkgs/create-akan-workspace/index.js",
       smokeRepoName,

package/package.json

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

package/templates/workspaceRoot/.gitignore.template

@@ -67,7 +67,9 @@ local.properties
 **/public/fallback-*.js
 **/public/libs
 **/private/libs
+**/public/firebase-messaging-sw.js
 
+**/android/keystore.properties
 **/vendor/bundle/
 **/ios/App/App/public
 **/ios/App/App/Podfile.lock

package/templates/workspaceRoot/biome.json.template

@@ -132,6 +132,20 @@
     }
   },
   "overrides": [
+    {
+      "includes": [
+        "apps/**/*.ts",
+        "apps/**/*.tsx",
+        "libs/**/*.ts",
+        "libs/**/*.tsx",
+        "!**/*.test.ts",
+        "!**/*.test.tsx",
+        "!**/*.spec.ts",
+        "!**/*.spec.tsx",
+        "!**/common/**"
+      ],
+      "plugins": ["./node_modules/@akanjs/devkit/lint/no-throw-raw-error.grit"]
+    },
     {
       "includes": ["**/page/**/*.ts", "**/page/**/*.tsx", "**/*.Unit.tsx", "**/*.View.tsx"],
       "plugins": [